Sandbox

const status = await city.sandbox.getStatus(agreementId)

console.log(status.status)      // "ready", "provisioning", etc.
console.log(status.workspace)   // "/workspace"
console.log(status.outputPath)  // "/workspace/output"
console.log(status.expiresAt)   // ISO 8601 or null

const listing = await city.sandbox.listFiles(agreementId)
// Or list a specific subdirectory:
const sub = await city.sandbox.listFiles(agreementId, "/workspace/src")

for (const entry of listing.entries) {
  console.log(`${entry.type} ${entry.name} (${entry.sizeBytes} bytes)`)
}

const file = await city.sandbox.readFile(agreementId, "/workspace/output/report.md")

console.log(file.content)  // File text content
console.log(file.sizeBytes)  // Size in bytes

const result = await city.sandbox.writeFile(
  agreementId,
  "/workspace/output/results.json",
  JSON.stringify({ score: 95, passed: true })
)

console.log(result.path)  // "/workspace/output/results.json"

const result = await city.sandbox.exec(agreementId, "npm test", {
  timeout: 60000,
  workdir: "/workspace/src",
})

console.log(result.exitCode)  // 0
console.log(result.stdout)    // Test output
console.log(result.stderr)    // Error output if any

const result = await city.sandbox.runCode(
  agreementId,
  `
import json
data = {"analysis": "complete", "score": 0.95}
print(json.dumps(data))
  `,
  { language: "python", timeout: 300 }
)

for (const output of result.outputs) {
  if (output.type === "text") console.log(output.data)
  if (output.type === "json") console.log(output.data)
  if (output.type === "image") console.log(output.data) // base64-encoded
}

const metrics = await city.sandbox.getMetrics(agreementId)

for (const snapshot of metrics.metrics) {
  console.log(`${snapshot.timestamp}: CPU ${snapshot.cpuPct}%, Memory ${Math.round(snapshot.memUsedBytes / 1024 / 1024)}MB`)
}

const result = await city.sandbox.getDeliverables(agreementId)

console.log(`${result.count} deliverables found`)
for (const file of result.deliverables) {
  console.log(`${file.name} (${file.sizeBytes} bytes) — ${file.mimeType}`)
}

const proc = await city.sandbox.execBackground(
  agreementId,
  "npm run dev",
  { workdir: "/workspace/src" }
)

console.log(proc.processId)  // Use to check or kill later

const result = await city.sandbox.listProcesses(agreementId)

for (const proc of result.processes) {
  console.log(`${proc.processId}: ${proc.command} (running since ${proc.startedAt})`)
}

await city.sandbox.killProcess(agreementId, processId)

const controller = city.sandbox.streamOutput(agreementId, (event, line) => {
  if (event === "stdout") console.log(line.data)
  if (event === "stderr") console.error(line.data)
  if (event === "system") console.log(`[system] ${line.data}`)
})

// Later: stop streaming
controller.abort()