Files
deepseek-harness/packages/terminal
Tianyi Cui 4f3a47d792 fix(terminal-bash): handle terminal protocol replies
Unix PowerShell emits cursor-position requests while PSReadLine starts and
redraws prompts. The subprocess PTY is only a transport, so those requests
went unanswered. Startup could then accept the dsh> literal echoed from its
setup source as a rendered prompt, and later sends were lost or clipped.

Feed raw PTY output into a zero-scrollback @xterm/headless state machine and
write generated replies through the provider-owned terminal handle. Drain
replies before caller input, repeat foreground inspection when terminal
activity races the sample, and retain send ownership until parser and reply
work quiesce. Coalesce raw chunks behind one active parser write so large
Windows output cannot create thousands of queued parse callbacks.

Publish pwsh only from backend stdin_read evidence and start one timeoutMs
deadline before the complete startup retry loop, so inferred-idle follow-ups
cannot reset the bound. Dispose the emulator when the
terminal or cleanup fails. Document the fail-loud ConstrainedLanguage path
and add focused coverage for split queries, reply ordering, foreground
resampling, failure containment, batching, timeout, and disposal.
2026-08-23 19:24:50 +08:00
..
2026-08-21 19:48:58 +08:00
2026-08-21 19:48:58 +08:00

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.