Repository navigation
Description
Status: backlog (p3). Deferred since 2026-09-24; the browser tiers work took priority (see #118). Reopen planning from docs/adr/sandbox-adapter.md.
Continuation of #1. The ADR is merged (docs/adr/sandbox-adapter.md, from #2, status still "Proposed") and is the source of truth. The adapter itself has not been started.
Status 2026-11-05: deferred (p3). No adapter work since 2026-09-24. Before any PR starts, re-check it against current main and the surrounding system: the profile model changed after #1 was written (sandbox became desktop, plus observe, in #46/#48, with a further collapse to observe/owner done in #59 (observe and owner)), and per-caller tokens with per-client tool allowlists now exist in openab-sb, outside this repo.
Suggested PR breakdown, each independently reviewable:
- PR A — Auth foundation: per-caller tokens with tool allowlist in
AuthPolicy(anchored glob, default deny, fail closed), SHA-256 token storage at rest, rotation/revocation; negative tests (default-deny, allowlist denial ofexec/mouse/key/osascript). Re-check against openab-sb's per-client allowlist before starting: part or all of this may already be covered at the switchboard, and duplicating it here may not be needed. - PR B — Adapter interface + OrbStack adapter: the 7-operation adapter contract with typed errors; OrbStack implementation (
docker runwith constraint flags, dedicatedoab-sandboxbridge network, labels as state of record, restart rebuild + reconciliation pass, TTL reaper fromcreated_at + ttl_secs) - PR C —
sandbox_*MCP tools: tool layer wiring gateway auth + ownership scoping to the adapter; job family (exec_start/poll/cancel) with in-sandbox output files - PR D — Acceptance test suite: loopback-gateway CI-runnable suite covering all ADR acceptance criteria (constraint negative tests, cross-caller isolation, restart recovery,
ttl_exceeds_cap, exit-137 timeout) - PR E — CI workflow: done,
.github/workflows/ci.ymlis live - Toolchain image:
images/toolchain/Dockerfile(python · node · git · gh), from feat: add oab-toolchain sandbox image (#1) #3. codex is not in the image yet, although this list originally included it.
Later phases (separate ADR updates if scope changes): k3s adapter, Lambda MicroVMs adapter.
Related: #45 (restricted tiers, VM tier), #118 (browser tiers tracker).
Activity
chaodu-agent commentedon Nov 7, 2026
Moved p2 → p3 (deferred): nothing has moved since 2026-09-24. Body updated: the toolchain image is ticked (it exists in
images/toolchain/Dockerfile, but codex is not in it yet), and PR A now notes it must be re-checked against openab-sb's per-client tool allowlist before it starts, since that may already cover it.