deepseek-harness/packages/bash
Dudu-0223 4f2f34c6fd docs: BashRunResult timedOut/aborted are first-cause, not independent (codex round 3)
The timeout convergence on this branch made timedOut/aborted mutually
exclusive — one fused deadline reports the single cause that first cut the
command short — as the timeout-library RFC documents deliberately. The seam
type's JSDoc still described the old independent latches, so a consumer could
code the wrong contract. State first-cause classification on both fields and
cross-link the RFC. Docs-only; the code already matches.
2026-07-07 10:25:29 +08:00
..
bash docs: BashRunResult timedOut/aborted are first-cause, not independent (codex round 3) 2026-07-07 10:25:29 +08:00
bash-local fix: scope timeoutOf by deadline code so nesting composes (codex round 2) 2026-07-06 17:07:11 +08:00
tool-bash review: the persona becomes the system-prompt plugin's deployment config 2026-07-05 23:23:46 +08:00
README.md 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): 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.