packages/bash/README.md

# bash/ — bash capability family

The canonical three-package capability seam (see [capability seams](../../docs/rfc/implemented/architecture/2026-06-13-capability-seams.md)): 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` tool schema | (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. Background runs are generic tasks, not bash-private state: `tool-bash` registers a started `BashProcess` handle with the [`ctx.tasks` registry](../tasks/README.md), whose `task_*` tools collect and stop it.
Document the package hierarchy and finalize the RFC 2026-06-20 23:25:33 +08:00			`# bash/ — bash capability family`

			`The canonical three-package capability seam (see [capability seams](../../docs/rfc/implemented/architecture/2026-06-13-capability-seams.md)): 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`) \|
feat(tasks): background task runtime, generic task_* control tools, bash/subagent producers 2026-07-09 21:22:54 +08:00			\| `tool-bash/` \| Model-facing `bash` tool schema \| (registers on `ctx.tools`) \|
Document the package hierarchy and finalize the RFC 2026-06-20 23:25:33 +08:00
feat(tasks): background task runtime, generic task_* control tools, bash/subagent producers 2026-07-09 21:22:54 +08:00			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. Background runs are generic tasks, not bash-private state: `tool-bash` registers a started `BashProcess` handle with the [`ctx.tasks` registry](../tasks/README.md), whose `task_*` tools collect and stop it.