dsh-peer-relay

dsh-peer-relay

一个仅运行在 DSH Host 内的对等会话 relay 插件。它让普通顶层 Agent 通过四个工具向另一个普通顶层会话提交任务，并异步接收结果。

投递采用双工语义：目标会话空闲时按 next-turn 排队唤醒新一轮；目标会话运行中时通过 next-step 注入当前轮，双方无需等待 turn 边界即可实时收到对方消息（与 Host subagent 结算通知同机制）。

范围

• Host-only，不包含 Client 或 Web UI。
• 固定使用 ~/.dsh/peer-relay.sqlite。
• 固定使用 Host 已配置的 Typert agent lookup 解析会话，包括官方冷恢复路径。
• 只向普通顶层会话安装工具，不向 subagent 安装。
• 不包含 ACL、存储适配器、降级路径或交互协议状态。

工具

• peer_list：列出与当前会话**同工作区（cwd）**的 live 普通顶层会话。
• peer_call：向同工作区的指定 Session 提交异步任务。
• peer_create：在当前工作区创建新 peer 会话（可指定 agent_preset，默认继承当前会话的 preset），创建后立即可被 peer_list 发现并接收任务。
• peer_status：查询当前 Agent 发起的任务。
• peer_cancel：取消当前 Agent 发起的任务。

工作区约束

peer 协作面向同项目工作：peer_list 只返回与主会话 cwd 相同的会话，peer_call 拒绝跨工作区目标，peer_create 创建的新会话固定落在主会话的 cwd。需要 peer 时一般先 peer_create 新建一个同项目会话。

安装

dsh plugin --profile web add dsh-peer-relay

Host 插件在 DSH Host 下次启动时加载。

开发

pnpm install
pnpm check

本地开发安装可以使用：

dsh plugin --profile web add link:/absolute/path/to/dsh-peer-relay