dsh-peer-bus

dsh-peer-bus

English · 简体中文

Let two DSH sessions talk to each other.

session A ──bus_send──▶ session B    (B wakes up and runs a turn)

Install

dsh plugin --profile web add dsh-peer-bus

Restart DSH. If pnpm warns about missing peers, ignore it — DSH supplies those from its own runtime.

Use

You need two sessions. In each one, run /bus id and copy the id it prints.

Let them talk. A grant means "this session may message me", so make it in the session that will be received from:

# in session B — now A may message B
/bus allow <A's id>

Then just ask session A's model, in plain language:

Ask <B's id> what the release version is.

It calls bus_ask, and B wakes up, answers, and the answer comes back in the same turn. For a one-way message, say "send <B's id> a message saying …". You never type the tool names yourself — the model picks them.

To allow the other direction too, run /bus allow <B's id> in session A.

What the model gets

Each message wakes a full turn, so a turn's worth of context is paid every time. Send several things at once with texts, correct an instruction the target has not started with supersede, and note that steer batches where followup does not — see Spending fewer turns.

Permission

Nothing is allowed until you grant it. Two ways:

• /bus allow <id> — one session, one direction, no restart. Durable.
• A workspace rule — every session in one project, in the profile's cordis.patch.yml:

- id: peer-bus
  config:
    allow:
      - sameWorkspace: true

Messages arrive as user messages, and a model treats those as instructions — so an open bus would be a prompt-injection path. Hence default-deny.

Two processes

Off by default. To reach a session held by another DSH process, set this in both:

- id: peer-bus
  config:
    crossProcess: true

The receiving process still decides permission, so a grant in one process governs that process's sessions only.

More

• USAGE.md — every tool in detail, all config keys, error codes, troubleshooting
• verification/ — what was tested, and what the tests do not prove

MIT — see LICENSE.