Guide: an agent with a sandbox

const agent = await client.agents.create({
  name: "fixit",
  model: "anthropic/claude-sonnet-4-5",
  instructions: [
    "You fix bugs in a TypeScript service.",
    "Always run the test suite before delivering. Never deliver a fix you did not run.",
    "Deliver the diff and the test output together.",
  ].join("\n"),
  budget: {
    cap_micro_usd: 100_000_000,     // $100
    period: "month",
    max_task_micro_usd: 10_000_000, // $10
  },
  tools: { sandbox: "auto", storage: true },
  limits: {
    sliceWallMs: 840_000,   // 14 min — the maximum. Builds are slow.
    toolTimeoutMs: 300_000, // 5 min for one `bash`. Must be ≤ half of sliceWallMs.
    maxToolCallsPerTurn: 8,
  },
});

naive agents create \
  --name fixit \
  --model anthropic/claude-sonnet-4-5 \
  --budget-usd 100 --max-task-usd 10 \
  --sandbox auto --storage \
  --wake-ms 840000 --max-tool-calls 8

const stream = await client.agents.sendMessage(agent.id, {
  text: [
    "Repo: git@github.com:acme/billing.git, branch main.",
    "Bug: `POST /invoices` returns 500 when `line_items` is empty.",
    "Expected: 400 with a field error.",
    "Fix it, run `npm test`, and deliver the diff plus the test output.",
  ].join("\n"),
  payload: { repo: "acme/billing", issue: 4412 },
});

for await (const e of stream) {
  if (e.kind === "tool_call")   console.log("→", e.data.name);
  if (e.kind === "tool_result") console.log("←", e.data.status ?? "");
  if (e.kind === "text_delta")  process.stdout.write(String(e.data.text ?? ""));
}

const task = await stream.done();
console.log(task.status, task.turns, task.wakes);

naive agents logs <agent-id> --kind tool_call
naive agents logs <agent-id> --kind tool_call --show-args   # full args, interactive only

const page = await client.agents.events(agent.id, { kind: "tool_call", limit: 200 });
for (const e of page.items) console.log(e.seq, e.data.name);

const { items } = await client.agents.deliverables(agent.id, { task: task.id });
const diff = items.find((d) => d.kind === "code");

const { deliverable, content, download_url } = await client.agents.deliverable(agent.id, diff!.id);
console.log(deliverable.sha256, deliverable.bytes);
console.log(content ?? download_url);

// 1. Mint a presigned PUT
const up = await client.agents.createDeliverableUpload(agent.id, {
  filename: "fix.diff",
  content_type: "text/x-diff",
  bytes: buf.byteLength,
});

if (up.upload_url) {
  await fetch(up.upload_url, { method: "PUT", body: buf });
}

// 2. Record the manifest against the storage key
await client.agents.createDeliverable(agent.id, {
  agent_task_id: task.id,
  title: "Fix empty line_items 500",
  kind: "code",
  storage_key: up.storage_key,
  bytes: buf.byteLength,
  final: true,
  summary: "Validates line_items before pricing; adds a regression test.",
});

await client.agents.createDeliverable(agent.id, {
  agent_task_id: task.id,
  title: "Fix empty line_items 500",
  kind: "code",
  text: diffString,          // up to 256 KB inline
  bytes: Buffer.byteLength(diffString),
  final: true,
});

await client.agents.update(agent.id, { tools: { sandbox: "billing-checkout" } });

naive agents spend <agent-id> --by task     # which bug cost what
naive agents spend <agent-id> --task <id>   # the authoritative figure for one