dsh-peer-relay

Readme

# 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`：列出当前 live 的普通顶层会话。
- `peer_call`：向指定 Session 提交异步任务。
- `peer_status`：查询当前 Agent 发起的任务。
- `peer_cancel`：取消当前 Agent 发起的任务。

## 安装

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

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

## 开发

```sh
pnpm install
pnpm check
```

本地开发安装可以使用：

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