Dudu-0223 4f2f34c6fd docs: BashRunResult timedOut/aborted are first-cause, not independent (codex round 3) 3 months ago
..
bash 4f2f34c6fd docs: BashRunResult timedOut/aborted are first-cause, not independent (codex round 3) 3 months ago
bash-local 760bc9aa6a fix: scope timeoutOf by deadline code so nesting composes (codex round 2) 3 months ago
tool-bash 3f83a4ee96 review: the persona becomes the system-prompt plugin's deployment config 3 months ago
README.md 5024cd5757 Document the package hierarchy and finalize the RFC 4 months ago

README.md

bash/ — bash capability family

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

Package Role ctx key
bash/ Abstract bash executor seam (interface + vocabulary) ctx.bash
bash-local/ Local-subprocess BashExecutor implementation (registers ctx.bash)
tool-bash/ Model-facing bash/bash_output/bash_kill tool schemas (registers on ctx.tools)

The interface lives at bash/bash/. A sandboxed executor would replace bash-local without touching the interface or the tool — the split is what makes that possible.