baixianger/dsh-bridge

DSH Bridge

English · 简体中文

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