Agent

Accessed via sandbox.agent.

`sandbox.agent.start(opts?)`

Start an agent session. HTTP API →

string

Initial prompt

string

Claude model

string

System prompt

string[]

Restrict tools

string

Permission mode

number

default:"50"

Max turns

string

Working directory

Record<string, McpServerConfig>

MCP servers

string

Resume session ID

(event: AgentEvent) => void

Event callback

(data: string) => void

Stderr callback

(exitCode: number) => void

Exit callback

() => void

Scrollback done callback

Returns: Promise<AgentSession>

const session = await sandbox.agent.start({
  prompt: "Build a todo app",
  onEvent: (e) => console.log(e.type),
});

`sandbox.agent.attach(sessionId, opts?)`

Reconnect to a running agent session. Accepts onEvent, onError, onExit, onScrollbackEnd. Returns: Promise<AgentSession>

`sandbox.agent.list()`

List all agent sessions. HTTP API → Returns: Promise<AgentSessionInfo[]>

AgentSession

Member	Type	Description
`sessionId`	`string`	Session ID
`done`	`Promise<number>`	Resolves with exit code
`sendPrompt(text)`	method	Send follow-up prompt
`interrupt()`	method	Interrupt current turn
`configure(config)`	method	Update agent configuration
`kill(signal?)`	`Promise<void>`	Kill agent process
`close()`	method	Close WebSocket

Types

AgentEvent

interface AgentEvent {
  type: string;
  [key: string]: unknown;
}

McpServerConfig

interface McpServerConfig {
  command: string;
  args?: string[];
  env?: Record<string, string>;
}

Getting Started

Sandboxes

Reserved Capacity

Agent SDK

Hosted Agents

CLI

Guides

TypeScript SDK

Python SDK

CLI Reference

API Reference

Resources

`sandbox.agent.start(opts?)`

`sandbox.agent.attach(sessionId, opts?)`

`sandbox.agent.list()`

AgentSession

Types

​sandbox.agent.start(opts?)

​sandbox.agent.attach(sessionId, opts?)

​sandbox.agent.list()

​AgentSession

​Types

`sandbox.agent.start(opts?)`

`sandbox.agent.attach(sessionId, opts?)`

`sandbox.agent.list()`

AgentSession

Types