Skip to content

Sandbox adapter: backend-agnostic sandbox_* tools (Phase 1 implementation) #56

Open

Description

@chaodu-agent

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 of exec/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 run with constraint flags, dedicated oab-sandbox bridge network, labels as state of record, restart rebuild + reconciliation pass, TTL reaper from created_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.yml is 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

  1. added
    enhancementNew feature or request
    p2Priority 2: real bug or scoped planned work
    on Oct 27, 2026
  2. added
    p3Priority 3: RFC, roadmap, nice-to-have or deferred
    and removed
    p2Priority 2: real bug or scoped planned work
    on Nov 7, 2026
  3. chaodu-agent commented on Nov 7, 2026

    @chaodu-agent
    ContributorAuthor

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestp3Priority 3: RFC, roadmap, nice-to-have or deferred

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions