Chinesezjc/dsh-interconnect
Cross-instance message and event handoff between DSH instances via an interconnect server.
Install
via npm
Resolves a published tarball rather than cloning the repository, and installs without any extra setup. Swap `web` for your profile name if you run another one.
via GitHub · npm package
Installing from GitHub runs the project's build script, which pnpm blocks until you allowlist it — run the command once and pnpm prints the exact key to add under `allowBuilds` in ~/.dsh/profiles/web/pnpm-workspace.yaml.
What happened when we ran it
Installed cleanly when we ran it
Every command here is run in a throwaway container against a clean profile, and the result is whatever the harness recorded — not a guess from the source. Last run 14d ago.
Show it in your README
For maintainers: the badge serves this listing's latest sandbox verdict, so a re-run updates it on its own — and it links readers to the full result here.
Due diligence
What it is — DSH instances exchange messages and events via an interconnect server.
Who it is for — When cross-instance message and event pushing is needed. If only a single DSH instance is used, this plugin can be skipped.
Watch out — Sandbox test passes with installation in a new profile and registration into the profile. Static check shows it will execute shell commands.
The verdict — I would install it since it allows bidirectional event pushing between DSH instances, although wakeup is disabled by default.
Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.
dsh-interconnect is a DeepSeek Harness plugin that forwards messages and events between DeepSeek Harness instances through an interconnect server. It adds a host-level interconnect service and model-visible tool-interconnect tools. The service exposes HTTP send, list and ping endpoints under /interconnect/*, plus a /interconnect/link WebSocket for bidirectional event streaming, heartbeats and reconnects. Incoming events are emitted as interconnect/event.
DeepSeek Harness instances authenticate requests with the shared DSH_INTERCONNECT_TOKEN bearer credential; authentication fails closed when the credential is absent. interconnect_send targets a session, while interconnect_list discovers live sessions and interconnect_ping checks a peer's liveness and identity. Messages can use followup, steer or inject delivery. With explicit resume: true, a peer may wake a persisted offline session, which can start a billable agent turn with that session's configured tools.
This is intended for deployments that need cross-machine session addressing, event fan-out or agent-to-agent handoff. It is not a substitute for local session messaging, and it is a poor fit when remote delivery or waking sessions is unnecessary. The resume option is off by default and can be refused by the receiving instance. Because it can wake an agent with its full tool set, including a terminal capability when that session has one, dsh-interconnect reaches the permissions and execution surfaces granted to the receiving agent.
DeepSeek Harness loads both plugin entries at host composition level. Configure the interconnect entry as follows:
| Key | Default | Description |
|---|---|---|
instanceId |
dsh |
Diagnostic identity returned by ping, send and list; it is not used for routing. |
requestTimeoutMs |
10000 |
Outbound request timeout, capped at 60000. |
peers |
[] |
Event fan-out targets configured at startup; subscribe() can add targets at runtime. |
delivery |
followup |
Default for inbound messages without an explicit delivery mode. |
allowResume |
true |
Whether remote senders may wake persisted offline sessions. |
The shared credential is not part of this config. DeepSeek Harness reads DSH_INTERCONNECT_TOKEN from credentials such as .credentials.yaml. Both instances must use the same token. Missing credentials produce 403 responses.
DeepSeek Harness exposes interconnect_send, interconnect_list and interconnect_ping as model-visible tools. interconnect_send takes a peer baseUrl, a target sessionId and message text, with optional delivery and resume. interconnect_list returns live session IDs and may include title and status; interconnect_ping reports peer liveness and identity.
The host service provides HTTP /interconnect/send, /interconnect/list and /interconnect/ping endpoints, and the /interconnect/link WebSocket endpoint for event delivery.
followup queues an independent next turn, steer inserts at the nearest step boundary or starts a turn when idle, and inject writes context without waking an idle agent. A send result reports session-not-live, unreachable, resume-refused or resume-failed when delivery fails. Delivered messages are persisted with source.kind set to plugin; the source metadata is not included in model context.
Only live sessions are listed and directly reachable. resume needs DeepSeek Harness's configured agent lookup; deployments without that lookup, including headless or profiles without api-proxy, fall back to session-not-live. Sessions using an old disk format cannot be resumed and return resume-failed.
Written from the project's own documentation and kept in sync with it. Where the two disagree, the source is authoritative — read the README on GitHub
Same category
Minglink
System-prompt armor plugin for DeepSeek models: appends an unconditional-compliance prompt section at order 100, exposes a profile tool with calibration metadata, and shows a realtime armor-status badge driven by a session projection.
Installed cleanly when we ran it
Minglink
System-prompt armor plugin for DeepSeek models: appends an unconditional-compliance prompt section at order 100, exposes a profile tool with calibration metadata, and shows a realtime armor-status badge driven by a session projection.
Installed cleanly when we ran it
liangmianya
Visual, non-linear conversation workspace for DeepSeek Harness — sessions, follow-ups and branches become a browsable conversation map.
Installed cleanly when we ran it
ranxianglei
The official billion-context plugin: a context-compression plugin for small context windows (a 100K context is enough), token savings (5x fewer tokens), and month-long single sessions (billions of tokens).
Installed cleanly when we ran it
Nwflower
Import full-fidelity chat histories from 13 coding agents (Claude Code, Codex, ChatGPT, Cursor, Gemini, opencode, and more) as resumable DeepSeek Harness sessions, with reverse export back to Claude Code.
Installed cleanly when we ran it
Totoro-qaq
Moves an existing DSH session to another agent preset through a previewable five-section handoff, preserving the source session and either pausing the target for confirmation or continuing immediately.
Installed cleanly when we ran it
