How yunpengdon/dsh-hitl works
dsh-hitl is a DeepSeek Harness plugin that pauses matched tool calls for human approval, edits, or rejection. Plugins or configuration mount tools; when a matched call reaches the host gate, it builds a proposal, waits in the pending registry, and sends it to the browser UI. A human decision returns through the transport and determines whether execution proceeds or receives feedback/revision context. The README also documents countdowns, editable fields, subagent visibility, and notices outside a conversation. Source excerpts establish the host’s internal modules; browser-to-host links rely on documented behavior where code excerpts are incomplete.
Main entry points: index.js Pre-execution gate · client.js Browser client · pending.js Pending registry · fields.js Proposal fields
Components 15
Mounting and policy
- Mount service
index.js - Mount normalization
lib/resolve.js
Approval gate
- Pre-execution gate
index.js - Proposal fields
lib/fields.js - Pending registry
lib/pending.js - Revision context
lib/fields.js
Decision transport
- Wire protocol
lib/protocol.js - HTTP and SSE transport
index.js
Browser experience
- Browser client
client.js - Decision card
client.js - Session and subagent views
client.js - Floating notice
client.js
Other components
- Plugin or config author
- Tool call
- Human reviewer
Connections 21
- Plugin or config author → Mount service: mounts tools
README.md - Mount service → Mount normalization: normalizes mounts
index.js - Tool call → Pre-execution gate: intercepted before execution
README.md - Pre-execution gate → Mount normalization: matches mount
index.js - Pre-execution gate → Proposal fields: resolves fields
index.js - Proposal fields → Wire protocol: uses limits
lib/fields.js - Proposal fields → Mount normalization: uses render defaults
lib/fields.js - Pre-execution gate → Pending registry: opens request
index.js - Pending registry → Pre-execution gate: settles blocked call
index.js - Pre-execution gate → Revision context: builds revision context
index.js - HTTP and SSE transport → Wire protocol: frames and validates
index.js - HTTP and SSE transport → Pending registry: reads pending state
index.js - HTTP and SSE transport → Browser client: streams requests
README.md - Browser client → Decision card: renders proposal
client.js - Browser client → Session and subagent views: files requests to sessions
README.md - Browser client → Floating notice: shows off-session requests
README.md - Human reviewer → Decision card: reviews and decides
README.md - Decision card → Browser client: submits decision
README.md - Browser client → HTTP and SSE transport: posts decision
README.md - HTTP and SSE transport → Pending registry: settles decision
index.js - Mount service → Pending registry: lists pending requests
README.md