DSH Orca Terminal Status
An unofficial, independent DeepSeek Harness plugin that reports real DSH TUI
readiness and completion to Orca's existing terminal status channel. MIT licensed.
No modified Orca application is required.
Why
With Orca 1.4.220, DSH can finish a request while Orca still waits for tui-idle:
DSH's Claude-compatible hooks report HTTP events, whereas that readiness check
expects terminal status. See Orca issue #25257
and the upstream PR.
This plugin listens directly to DSH lifecycle events; it does not translate an
HTTP Stop into completion. Stop can still enqueue continuation work.
- Reports startup readiness only after the TUI's actual child runtime finishes
activation and the single root agent is idle with an empty inbox.
- Reports
working for a running root and done for finalized idle, using
ordered OSC 9999 writes to the existing PTY.
- Ignores subagents, ambiguous multiple roots, non-TTY SDK output, and terminals
without Orca's pane environment. Requires matching frontend/service ownership.
- Leaves Orca's existing HTTP hooks in place for their existing purposes.
Tested versions
| Component | Version |
|---|
| Official Orca | 1.4.220 |
| Official DSH / dsh-agent | 0.2.0-rc.2 |
Community @deepseek-harness-tui/dsh-tui | 0.13.0 |
@deepseek-ai/cordis | 4.0.4 |
@deepseek-ai/cordis-plugin-loader | 1.0.5 |
| Real integration platform | macOS, Apple Silicon |
This implementation depends on TUI/Cordis internals (internal/status, fiber
state/parent/store and dsh-tui-runtime), in addition to DSH's plugin loader.
Plugin-loader compatibility alone does not guarantee those internals remain
compatible. The manifest declares the tested peer versions; optional peers avoid
automatically installing another DSH or TUI copy. Missing TUI does not provide
readiness. Revalidate upgrades; compatibility with other versions, Windows,
Linux, SSH and multi-root frontend routing has not been established.
Install
Use Node.js ^22.19.0 || >=24 and an existing DSH TUI profile. Install exactly
once: do not combine this bundle with a manually inserted copy of the plugin or
an Orca release that already emits the same DSH PTY status. Installing a bundle
changes every session using that profile; schedule installation between sessions.
Through DSH's official package-management CLI (replace dsh-tui with your profile):
dsh plugin --profile dsh-tui add https://github.com/Alex-wangyang/dsh-orca-terminal-status/releases/download/v0.1.0/dsh-orca-terminal-status-0.1.0.tgz
Alternatively, download and extract that release, then ask DSH's native
plugin_manager to use action: install_bundle with target set to the absolute
extracted package directory. This package contains dsh.bundle.patch, no runtime
dependencies, no build step and no install/prepare scripts. npm registry publication
is not required. Do not run npm install inside DSH's profile yourself.
Restart DSH after package replacement and launch it inside Orca. Verify the
composed plugin row and native tui-idle readiness, then run a harmless task and
verify completion. A saved bundle selection alone does not prove runtime health.
Remove the bundle using the same profile:
dsh plugin --profile dsh-tui remove dsh-orca-terminal-status
This removes the bundle-managed plugin, not an older manually installed home
patch. Preserve Orca-managed hook rows when removing a manual installation.
Verification
npm test
npm pack --dry-run
Eight behavioral tests cover delayed/failed frontend activation, root and inbox
guards, child events, Stop continuations, ordered immediate wake, SDK isolation,
disposal and frontend ownership. They need no model credentials or DSH installation.
The same runtime source was exercised against the tested real stack: cold worker
launch and same-process worker reuse both admitted successfully, wrote independently
verified task marker files, and reported native worker completion. Orca's native
tui-idle check also passed after completion and on a fresh final-source launch.
The official Orca application bytes were unchanged. These are bounded integration
results, not a guarantee for later releases. Release packaging is separately tested
with DSH's native installer in an isolated profile.
中文
这是独立维护的非官方插件。它监听 DSH 的真实状态，把就绪、工作中和完成状态
写入 Orca 已有的终端通路，使官方 Orca 也能正确识别 DSH worker。
它不会把 HTTP Stop 直接当作任务完成，也不需要修改 Orca 本体。
安装命令见上方；dsh-tui 应替换为实际使用的 profile。请勿重复安装手工副本
和 bundle。已实测的版本组合见表格；插件加载机制保持兼容，并不代表 TUI
内部生命周期永远保持兼容，因此 DSH/TUI 升级后仍需验证。
License
MIT. Independently maintained; not affiliated with or endorsed by
DeepSeek AI, the DSH TUI maintainers, or Stably/Orca.
