Manager

High-level client that talks to the processd-sandbox-manager HTTP API. Manages sandbox lifecycle — create, find-or-create, start, stop, delete.

DaimonManagerClient

DaimonManagerClient(base_url, *, access_token=None, timeout_s=30.0)

Construct a manager client targeting the sandbox manager HTTP endpoint.

Parameter	Type	Default	Description
`base_url`	`str`		Scheduler (or manager) HTTP endpoint (e.g. `http://127.0.0.1:18081`).
`access_token`	`str \| None`	`None`	Access token for `X-Access-Token` header.
`timeout_s`	`float`	`30.0`	HTTP request timeout.

Check if the manager is reachable and healthy.

Get current capacity info — memory, PID, CPU limits and usage.

capacity = await manager.capacity()
print(capacity.mode, capacity.memory_bytes.available)

Create a fresh sandbox workspace.

Find a sandbox by labels or create one if none matches. Useful for thread-scoped sandbox reuse.

Parameter	Type	Default	Description
`labels`	`dict[str, str]`		Labels to match against existing sandboxes.
`ttl_seconds`	`int \| None`	`None`	Time-to-live in seconds for the sandbox.

sandbox = await manager.find_or_create_sandbox(
    labels={"thread_id": "chat-123"},
    ttl_seconds=3600,
)

Get sandbox info by ID.

Start (resume) a stopped sandbox.

Stop (pause) a running sandbox.

Delete a sandbox and its workspace permanently.

Return an async context manager that creates, connects, and optionally deletes a sandbox.

async with manager.sandbox() as sandbox:
    result = await sandbox.exec.bash("pwd")
    print(result.display_text)

Wraps a sandbox info and its connected MCP client. Exposes the same namespaces as DaimonClient.

Async context manager returned by manager.sandbox(). Creates a sandbox on enter, connects the client, and optionally deletes on exit.