Files
deepseek-harness/packages/shell
_Kerman 9365ef496d Merge remote-tracking branch 'origin/master' into xtr/message-tool-call-id
# Conflicts:
#	packages/acp/acp/tests/approval.spec.ts
#	packages/acp/acp/tests/edges.spec.ts
#	packages/api/session-controller/tests/event-script.client.ts
#	packages/client/connection/src/client/fixture.ts
#	packages/client/ui-conversation/src/client/contract/slots.ts
#	packages/client/ui-conversation/src/client/contract/views.ts
#	packages/client/ui-conversation/src/client/index.ts
#	packages/client/ui-conversation/src/client/stores.ts
#	packages/core/agent-loop/tests/loop.spec.ts
#	packages/extensions/cordis-client-runner/src/client/slot-catalog.ts
#	packages/extensions/tool-cordis/src/api-catalog.ts
#	packages/host/apiproxy/src/api-proxy.ts
#	packages/host/apiproxy/src/api/events.ts
#	packages/host/apiproxy/tests/api-proxy-view.spec.ts
#	packages/interaction/user-approval/src/index.ts
#	packages/llm/llm-deepseek/tests/adapter.e2e.ts
#	packages/llm/llm-pi-ai/src/context.ts
#	packages/llm/llm-pi-ai/tests/context.spec.ts
#	packages/llm/llm/tests/content.spec.ts
#	packages/subagent/subagent/tests/continuation.spec.ts
#	packages/subagent/tool-subagent/tests/tool-subagent.spec.ts
#	packages/test-support/llm-replay/tests/llm-replay.spec.ts
#	packages/todo/tool-todo/tests/tool-todo.spec.ts
#	scripts/gen-persistence-catalog.ts
2026-08-25 14:37:44 +08:00
..
2026-08-21 19:48:58 +08:00
2026-08-21 19:48:58 +08:00
2026-08-21 19:48:58 +08:00
2026-08-21 19:48:58 +08:00

shell/ — bash capability family

English | 中文

The capability family spans the canonical executor seam, its implementations, the shared shell environment, and the model-facing tools. All are product packages.

Package Role ctx key
shell/ Defines the executor contract shared by Service Providers and Consumers. ctx.shell
bash-local/ Executes commands through the local subprocess service. (registers ctx.shell)
bash-sandbox/ Applies the configured sandbox backend before local execution. (registers ctx.shell)
pwsh-local/ Executes PowerShell commands with Windows-specific process behavior. (registers ctx.shell)
shell-env/ Provides the managed DSH_* environment shared by shell tools. ctx.shellEnv
tool-bash/ Exposes Bash execution and background-job integration to the model. (registers on ctx.tools)
tool-pwsh/ Exposes PowerShell execution to the model. (registers on ctx.tools)

A profile layer selects one executor implementation and the model-facing tools it needs. A sandboxed composition also selects a ctx.sandbox provider; the base bundle owns the shipped wiring.

The subsystem reference — request/spec vocabulary, results, background processes, the service, and events — is docs/subsystems/shell.md.