Yichen Jiang f570d2201e Merge remote-tracking branch 'origin/master' into codex/agent-session-jsonl-location 2 ヶ月 前
..
bash d4b5227071 fix(bash): validate managed env namespace 2 ヶ月 前
bash-local d4b5227071 fix(bash): validate managed env namespace 2 ヶ月 前
bash-sandbox b29a8eca71 fix(review): reconcile sandbox and approval contracts 2 ヶ月 前
tool-bash f570d2201e Merge remote-tracking branch 'origin/master' into codex/agent-session-jsonl-location 2 ヶ月 前
README.md 2eed448acf feat(bash): the sandboxed executor — per-call policy carrier, denial facts, runner-failure classification 2 ヶ月 前

README.md

bash/ — bash capability family

The canonical three-package capability seam (see capability seams): an abstract executor interface, concrete implementations, and the model-facing tool that consumes it. All product packages.

Package Role ctx key
bash/ Abstract bash executor seam (interface + vocabulary; sandbox result facts carry the sandbox/ seam's mode/enforcement vocabulary) ctx.bash
bash-local/ Local-subprocess BashExecutor implementation (registers ctx.bash)
bash-sandbox/ Sandbox-consuming BashExecutor (wraps every command argv via ctx.sandbox, stamps denial/enforcement facts; extends bash-local's mechanics) (registers ctx.bash)
tool-bash/ Model-facing bash/bash_output/bash_kill tool schemas (registers on ctx.tools)

The interface lives at bash/bash/. bash-sandbox replacing bash-local without touching the interface or the tool is the split doing exactly what it exists for — a leaf cordis.yml picks one executor entry, plus a ctx.sandbox provider entry for the confined one (see examples/sandbox-acp-agent).