dsh-call-session

In-process cross-session communication and workspace shared blackboard for DeepSeek Harness (DSH)

English | 简体中文

Overview

DeepSeek Harness sessions are isolated by default, and child tasks exit upon completion.

dsh-call-session adds in-process cross-session communication, peer session creation, and shared blackboard capabilities:

• Inter-session unicast: send directives or hand off tasks between independent long-running sessions.
• Shared blackboard: publish bulky artifacts to a shared board for on-demand retrieval, avoiding context bloat.
• Visual canvas: observe session states, blackboard items, and call trajectories in the DSH Web UI.

Install

# Add to target profile web
dsh plugin --profile web add dsh-call-session

# List installed plugins
dsh plugin --profile web list

# Remove plugin
dsh plugin --profile web remove dsh-call-session

Note: The --profile option must follow the plugin subcommand, e.g. dsh plugin --profile web ....

Scenarios

Instruct the agent using plain natural language in the chat; the agent invokes the tools automatically:

Task Handoff

User prompt:

Hand off this task summary to the "audit-session" session.

The agent calls session_call to dispatch a unicast message. If the target session is running, it steers execution; if idle, it wakes a new turn.

Post Results

User prompt:

Publish the review conclusions to the board and notify relevant sessions to pick up tasks.

The agent calls board_post to store the detailed report on the blackboard and obtain a postId. Other sessions retrieve the content on demand via board_list, preventing context window explosion.

Create Session

User prompt:

Create a new session and hand off tasks.

The agent calls session_create to spawn a long-running peer session in the current workspace, automatically inheriting model specifications and presets.

Canvas

The DSH Web session view exposes a Canvas tab to observe multi-agent collaboration across workspaces:

• Topology: workspace columns, running/idle session nodes, blackboard items with TTL countdowns, and directional call traces.
• Interaction: hovering highlights the 1-hop connected subgraph; double-clicking opens a read-only inspector drawer.
• Read-only boundary: the canvas offers no control inputs; all state changes originate from the agents themselves.

Tools

Comparison

Selection guidelines:

• Prefer built-in: for isolated, scoped tasks, use DSH built-in subagent directly.
• Use on demand: when multiple independent top-level sessions need to coordinate or share large context via a blackboard, use dsh-call-session.

Config

The plugin runs with built-in defaults out of the box.

To customize, add property overrides to ~/.dsh/profiles/web/cordis.patch.yml:

- id: dsh-call-session
  config:
    debounceMs: 500
    maxCapacity: 500

Options:

• enabled: boolean, default true. Enable or disable plugin tools.
• debounceMs: number, default 300. Atomic disk write debounce delay in milliseconds.
• maxCapacity: number, default 200. Maximum board entries.
• telemetryCapacity: number, default 200. Maximum call traces retained in canvas data buffer.
• locale: string, default 'auto'. Interaction language preference ('auto', 'zh', 'en').

Architecture

Technical decisions are recorded as Architecture Decision Records (ADRs):

• Decision catalog: see docs/adrs/README.md.
• Architecture topology: see docs/architecture/.

Compatibility

License

This project is licensed under the MIT License.