Files
deepseek-harness/packages/terminal

terminal/ — 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-terminal) Backend registry, branded ids, exact-Agent ownership, session operations, and awaited cleanup ctx.terminals
terminal-bash (@deepseek-ai/dsh-terminal-bash) Shell backend over ctx.subprocess.spawnTerminal: readiness detection, bounded terminal state, sandbox policy, and session operations registers on ctx.terminals
tool-terminal (@deepseek-ai/dsh-tool-terminal) Six model-facing tools and generic task integration for background sends registers on ctx.tools

The terminal subsystem reference owns ids, backend and session contracts, send readiness, and bounded reads. The persistent PTY Agent Note owns the rationale and deferred boundaries.