Skip to content

feat(isolation): define the RFC 0012 boundary contract - #2941

Open
drew wants to merge 13 commits into
mainfrom
codex/1737-rfc12-contract
Open

feat(isolation): define the RFC 0012 boundary contract#2941
drew wants to merge 13 commits into
mainfrom
codex/1737-rfc12-contract

Conversation

@drew

@drew drew commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

Define the RFC 0012 Isolation Backend contract that lets the supervisor operate a sandbox without depending on Docker, Podman, Kubernetes, or VM details.

Each sandbox launch now has a distinct session identity. Authentication is required, but the public interface does not expose TLS, JWT, gRPC, or transport types. General application UDP remains out of scope; TCP and DNS are mediated by the supervisor.

Related Issue

Part of #1737.

Changes

  • Define backend-neutral lifecycle, process, identity, TCP, and DNS contracts.
  • Add a validated SandboxSessionId and bind it to SandboxContext.
  • Require authenticated attach and fail-closed confirmation before the agent starts.
  • Require process ownership, binary identity, network mediation, and driver-owned containment.
  • Keep transport and authentication mechanisms behind the interface.

Testing

  • mise run pre-commit
  • Full unit and E2E validation delegated to remote CI

Checklist

  • Follows Conventional Commits
  • Authored commits are signed off (DCO)

Stack

  1. feat(isolation): define the RFC 0012 boundary contract #2941 — Isolation Backend contract (this PR)
  2. feat(isolation): add boundary protocol and Linux primitives #2942 — OpenShell Sandbox Protocol and Linux primitives
  3. feat(isolation): split supervisor and sandbox runtimes #3151 — supervisor and sandbox runtimes
  4. feat(vm): run the supervisor outside the guest workload #2945 — VM driver
  5. feat(docker): isolate workloads behind the host supervisor #2965 — Docker driver
  6. feat(kubernetes): add proxy-pod isolation topology #3144 — Kubernetes proxy-pod driver
  7. feat(podman): isolate workloads behind the host supervisor #3230 — Podman driver
  8. perf(isolation): add TCP and DNS benchmark harnesses #3229 — performance harnesses

@copy-pr-bot

copy-pr-bot Bot commented Aug 26, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@copy-pr-bot

copy-pr-bot Bot commented Aug 31, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown

Label test:e2e applied for a5dc6db. Open the existing run and click Re-run all jobs to execute with the label set. The run will execute the standard E2E suite after building the required gateway and supervisor images once. The matching required CI gate status on this PR will flip green automatically once the run finishes.

@drew
drew force-pushed the codex/1737-rfc12-contract branch from a5dc6db to 05a961b Compare September 5, 2026 16:08
@drew

drew commented Sep 5, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test

2 similar comments
@drew

drew commented Sep 5, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test

@drew

drew commented Sep 5, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test

@drew
drew force-pushed the codex/1737-rfc12-contract branch from 7eb8e06 to 05a961b Compare September 8, 2026 22:32
@drew drew changed the title feat(isolation): add RFC 0012 backend contract feat(isolation): define the RFC 0012 boundary contract Sep 8, 2026
@drew
drew removed this pull request from stack #3152 September 9, 2026 04:42
@drew
drew added this pull request to stack #3231 September 9, 2026 04:42
drew and others added 3 commits September 8, 2026 21:46
Signed-off-by: Drew Newberry <385+drew@users.noreply.github.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
drew added 8 commits September 8, 2026 21:46
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
…tions

Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
@drew
drew force-pushed the codex/1737-rfc12-contract branch from daf3da9 to 24514b0 Compare September 9, 2026 04:53
drew added 2 commits September 9, 2026 14:53
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

test:e2e Requires end-to-end coverage

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant