History

Tianyi Cui 2beaa18f42 Merge remote-tracking branch 'origin/master' into worktree/acp-automation-protocol # Conflicts: # packages/support/acp-snapshot/README.md		2026-07-25 02:07:28 +08:00
..
pty	refactor(agent): align delivery method names	2026-07-24 15:08:36 +08:00
pty-local	Fix remaining PTY and bundle watch races	2026-07-25 00:33:33 +08:00
tool-pty	Merge remote-tracking branch 'origin/master' into worktree/acp-automation-protocol	2026-07-24 23:43:10 +08:00
README.md	refactor(pty): rename model-facing tools to terminal_* and harden teardown	2026-07-21 19:29:56 +08:00

README.md

pty/ — persistent PTY capability family

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`)	Local `node-pty` backend, readiness detection, bounded terminal state, sandboxing, and process-session supervision	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.