Memory

dsh-bridge

baixianger/dsh-bridge · ★ 6

baixianger

Local session messaging and event bridge for DeepSeek Harness

License
MIT
Added
2026-10-30
Maintenance
active
Install kind
npm
npm
dsh-bridge
Manifest details
Manifest status
Declared
Manifest path
package.json#dsh
Manifest checked
2026-10-30T09:38:52.533Z
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add 'dsh-bridge@0.1.0-rc.17'

从 npm 安装预构建包

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: en · Read Chinese README

Table of contents
  1. DSH Bridge
  2. Three tools, one local host
  3. Quick start
  4. Delivery that respects session state
  5. Configuration
  6. Plugin integration
  7. Retention & boundaries
  8. Development & feedback

DSH Bridge

English · 简体中文

npm License: MIT DSH plugin

Let sessions in one DeepSeek Harness host discover each other and exchange messages. Bridge is the local foundation beneath Chat rooms and trusted Weave delivery.

Three tools, one local host

Tool Purpose
session_list Discover sessions and their current state.
session_send Send by exact session ID or human-readable title.
session_messages Read a bounded recent delivery log.

Quick start

dsh plugin --profile web add dsh-bridge@latest
dsh web

Ask an agent to list sessions, then send a message to the intended session. Bridge adds tools directly; it has no separate settings page.

For session_send, mode: auto tries the ID before the title; id and name select one lookup method. Titles match case-insensitively. Ambiguous names return candidate IDs instead of choosing a recipient for you.

Delivery that respects session state

flowchart LR
  Send[Send message] --> Resolve[Resolve target]
  Resolve --> Live[Live session]
  Resolve --> Cold[Resume persisted session]
  Live --> Queue[Queue follow-up]
  Cold --> Queue
  • Idle agents wake; running agents receive queued work.
  • Persisted sessions resume with their recorded preset and model.
  • Concurrent requests to a cold session share one resume operation.
  • Archived sessions reject delivery and are not woken.
  • Cancelling during a cold resume prevents a late follow-up, even if the shared load finishes.

A delivery acknowledgement means the session accepted the follow-up. It does not mean the model has processed it or completed the task.

Configuration

Field Default Purpose
recentMessages 1000 Retained messages per host.
dedupeCapacity 10000 Remembered external message IDs.
maxMessagesPerRead 100 Maximum messages returned per read.

Plugin integration

ctx.dshBridge is the public service. Trusted transports call deliverExternal() so local and external delivery share the same follow-up and audit path. Its optional signal carries cancellation through session resolution.

DSH Weave supplies cross-host transport; DSH Chat supplies rooms and a Web conversation view. Neither is required for local messaging.

Retention & boundaries

Bridge operates within one host process. Its recent-message log and duplicate-ID table live in memory and reset on plugin unload or reload; they are not a durable mailbox. The old ctx.sessionMessaging accessor remains a temporary compatibility alias.

Development & feedback

npm ci
npm run check

Report an issue · Release notes · MIT license