Agent Sandbox — /api/agent/:zid/sandbox*
A server-side Python sandbox (Pyodide) the agent can call. Used for data work an agent needs to run while building — parse, transform, compute — without leaving the machine. Runs are recorded and quota-limited.
Concept: Agents · Pulse Workbench.
Source: shared/api-core/src/routes/agentSandbox.ts.
Endpoints
| Method | Path | Auth | Notes |
|---|---|---|---|
POST | /api/agent/:zid/sandbox/run | ZID-bound | Execute Python, return the result. |
GET | /api/agent/:zid/sandbox/runs | ZID-bound | Recent runs (paginated). |
GET | /api/agent/:zid/sandbox/quota | ZID-bound | Cheap quota snapshot for the UI. |
ZID-bound = authenticated via authenticateZeqAuth; the caller must be the agent calling its own sandbox, or the owner of the machine whose agent it is.