Huanqi Cao
5e080849aa
# Conflicts: # apps/cli/reference/README.i18n.yaml # docs/cordis-catalog/services.md # docs/module-graph.md # docs/subsystems/sandbox.i18n.yaml # packages/sandbox/sandbox/README.i18n.yaml # pnpm-lock.yaml # scripts/verify-package-readme-model-experience.ts
pty/ — persistent PTY capability family
English | 中文
PTY stands for Pseudo-Terminal（伪终端）. This capability provides persistent, owner-scoped terminal sessions for workflows that require state across tool calls or interactive stdin. PTY complements the one-shot bash and filesystem tools; it does not replace their stronger per-operation contracts.
| Package | Role | ctx key |
|---|---|---|
pty (@deepseek-ai/dsh-pty) |
Backend registry, branded ids, exact-Agent ownership, session operations, and awaited cleanup | ctx.pty |
pty-local (@deepseek-ai/dsh-pty-local) |
Shell backend over ctx.subprocess.spawnTerminal: readiness detection, bounded terminal state, sandbox policy, and session operations |
registers on ctx.pty |
tool-pty (@deepseek-ai/dsh-tool-pty) |
Six model-facing tools and generic task integration for background sends | registers on ctx.tools |
The design and deferred boundaries live in the persistent PTY Agent Note.
The subsystem reference — ids, backend/session contracts, send readiness, bounded reads — is docs/subsystems/pty.md; design and deferred boundaries in the persistent PTY Agent Note.