Add bash execution: dsh-bash seam, dsh-bash-local impl, dsh-tool-bash tools

Three packages following the new capability-seam pattern (interface /
implementation / consumer, now documented in docs/architecture.md):

- dsh-bash: abstract BashExecutor service (ctx.bash) + vocabulary types.
- dsh-bash-local: local subprocesses — bash -c per call in a detached
  process group, SIGTERM→SIGKILL group kills, tail-keep truncation with
  full-stream spill files, model-friendly env, background task registry.
- dsh-tool-bash: the bash / bash_output / bash_kill tool schemas with
  runtime arg validation and background completion notices via
  agent.inject(). Non-zero exits are reported, not errored.

Design surveyed against the bash tools of Claude Code, OpenCode, Codex,
and pi (notes in the package READMEs). Permissions/sandbox stay TODO on
the tools/execute waterfall seam; stateful-shell alternatives recorded
in run.ts.

This commit is contained in:

Tianyi Cui

2026-06-12 23:28:44 +08:00

parent 353b0170c7

commit 8b5a3ef730

27 changed files with 2714 additions and 7 deletions

									
										scripts/publint-all.ts
									
		+3
		
												View File
												
				@@ -10,6 +10,9 @@ const packages = [

				  'packages/tools',

				  'packages/agent',

				  'packages/agent-loop',

				  'packages/bash',

				  'packages/bash-local',

				  'packages/tool-bash',

				]

				const root = resolve(import.meta.dirname, '..')