History

Tianyi Cui 16958cdbe7 fix(pty): observe readiness before exact probe threshold		2026-07-28 15:22:05 +08:00
..
pty	refactor(agent): return request retry action	2026-07-27 21:17:49 +08:00
pty-local	fix(pty): observe readiness before exact probe threshold	2026-07-28 15:22:05 +08:00
tool-pty	Merge remote-tracking branch 'origin/master' into fix/pty-handoff-grace	2026-07-27 23:17:23 +08:00
README.i18n.yaml	docs: translate remaining READMEs	2026-07-26 05:06:39 +08:00
README.md	docs: translate remaining READMEs	2026-07-26 05:06:39 +08:00
README.zh.md	docs: translate remaining READMEs	2026-07-26 05:06:39 +08:00

README.md

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`)	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.