HTTP bridge between the OpenAI Agents SDK and the Cloudflare Sandbox. Translates Sandbox operations into calls against the @cloudflare/sandbox Durable Object API.
| Directory | Description |
|---|---|
| worker/ | Deployable Cloudflare Worker — the bridge itself |
| examples/ | Demo applications (basic CLI agent, workspace chat) |
| harness/ | Stress testing and integration harness |
| script/ | Development scripts |
Deploy the bridge worker with one click:
Or deploy manually — see worker/README.md for setup, configuration, and the full API reference.
The bridge launches argv processes and returns after launch, not completion. Process status and SSE logs are recoverable by runtime-local ID while the current container remains alive; log cursors support replay after a client reconnects. Process discovery does not wake a sleeping sandbox, and IDs from a stopped or replaced runtime cannot be recovered. Shell syntax requires an explicit shell in argv, and process control uses numeric signals.
Terminals are separate PTY resources with input, resize, interrupt, terminate, and reconnect behavior. Closing an SSE connection cancels only that log observation and does not kill its process.
- basic/ — One-shot coding agent that executes a task and copies output files to the host. Supports
--imagefor visual references. - workspace-chat/ — Full-stack chat UI with a persistent sandboxed filesystem, file browser sidebar, drag-and-drop uploads, and inline HTML previews.