Yichen Jiang
1b7b50bbe1
# Conflicts: # apps/web/package.json # docs/config-catalog.i18n.yaml # docs/config-catalog.md # docs/event-producer-consumer.i18n.yaml # docs/event-producer-consumer.md # docs/event-producer-consumer.zh.md # packages/api/remotes/src/client/index.ts # packages/e2b/subprocess-e2b/README.md # packages/e2b/subprocess-e2b/README.zh.md # packages/e2b/subprocess-e2b/src/index.ts # packages/e2b/subprocess-e2b/src/terminal.ts # packages/e2b/subprocess-e2b/tests/subprocess.spec.ts # packages/e2b/subprocess-e2b/tests/terminal.spec.ts # packages/mcp/mcp-resources/README.i18n.yaml # pnpm-lock.yaml # scripts/verify-package-readme-model-experience.ts # snapshots/session/cordis-inspect-jsdoc/session.v3.jsonl # tsconfig.base.json # tsconfig.client.json # tsconfig.host.json
description, kind
| description | kind |
|---|---|
| The subprocess group map: the shared child-process service and its local host provider, for users and maintainers navigating the group. | package-group |
subprocess/ — subprocess capability family
English | 中文
Summary
Every child process and terminal session the harness runs — bash commands, language servers, persistent shells, and out-of-process subagent backends — is started, observed, and terminated through one shared service (ctx.subprocess), with a local provider running them on the host machine. It is not a standalone product feature: the consuming capability seams decide what each process means, and command semantics, deadlines, and model-facing presentation stay with them. The group provides executable lookup, bounded output capture with spill recovery, provider-managed process ranges with disclosed weaker fallbacks, and a scrubbed starting environment for every child.
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
subprocess |
Defines the child-process service: executable lookup, managed process spawns, and real terminal sessions | ctx.subprocess |
subprocess-local |
Runs host processes and terminals with native managed ranges where supported and explicit weaker fallbacks elsewhere | registers on ctx.subprocess |
win32-process |
Owns shared Win32 bindings for sandbox and ordinary process creation, stdio, Job assignment, polling, waits, and handle cleanup | library — no ctx key |
The service keeps process lifetime across consumer reloads; consumers own what a process means (a bash command, a language server) and every default that shapes one.
Related documentation
- Subprocess subsystem — spawn specs, output readers, outcomes, and the managed
DSH_*environment. - Subprocess seam Agent Note — why the process half of the bash executors became its own seam.
Dev Note
Working context for maintainers — click to expand
None.