agent-comm-hub 0.7.1 → 0.8.1

package/README.md

@@ -226,19 +226,28 @@ Merge into `~/.gemini/settings.json`:
 
 Auto-configured by `agent-comm-hub setup`: it discovers
 `~/.dsh/profiles/*/cordis.patch.yml` and appends the `@deepseek-ai/dsh-mcp-client`
-row, so DSH sessions expose the tools as `mcp__agent-hub__bridge_*` after a dsh
-restart. Manual equivalent (or template for other profiles):
+row with **`serverName: agent-comm-hub`** (not the generic `agent-hub` key other
+agents use). That name is deliberate: a DSH MCP-manager plugin that dynamically
+mounts `serverName: "agent-hub"` would otherwise collide
+(`serverName "agent-hub" is already in use by another mcp-client instance`) and
+fail the whole profile load. DSH sessions expose the tools as
+`mcp__agent-comm-hub__bridge_*` after a dsh restart. Re-running `setup` rewrites
+any older `serverName: agent-hub` insert to the new key. Manual equivalent:
 
 ```yaml
 - insert:
     - id: agent-comm-hub
       name: '@deepseek-ai/dsh-mcp-client'
       config:
-        serverName: agent-hub
+        serverName: agent-comm-hub
         transport: streamable-http
         url: http://127.0.0.1:18764/mcp
 ```
 
+If your MCP manager already owns the hub mount entirely, undo the static insert
+with `agent-comm-hub setup --remove` (or only refresh skills via
+`setup --agent` for other agents) and keep the dynamic mount.
+
 ## Tools
 
 | Tool | Purpose |
@@ -420,7 +429,7 @@ const hub = startHub({ port: 18764 }, console) // returns { hub, registry, serve
 ```bash
 pnpm install
 pnpm typecheck        # tsc --noEmit (strict)
-pnpm test             # test suite (240 checks: 135 smoke + 36 setup + 11 ops + 35 herdr + 23 discover)
+pnpm test             # test suite (263 checks: 138 smoke + 36 setup + 11 ops + 35 herdr + 23 discover + 20 e2e)
 pnpm run build        # esbuild → lib/{cli,index,setup}.js (zero deps)
 pnpm pack             # build + npm pack (publishing artifact)
 ```

package/agents/README.md

@@ -30,7 +30,7 @@ Codex（TOML 追加）/ zcode（`mcp.servers`）。Claude Code 和 DSH 需手动
 | Codex | `~/.codex/config.toml` | `codex/config.toml` | `~/.codex/skills/agent-comm-hub/SKILL.md` |
 | zcode | `~/.zcode/cli/config.json` | `zcode/config.json` | `~/.zcode/skills/agent-comm-hub/SKILL.md` |
 | Claude Code | 项目根 `.mcp.json`（手动复制；**不碰 `~/.claude.json`**——含凭据且无法安全往返） | `claude-code/.mcp.json` | `~/.claude/skills/agent-comm-hub/SKILL.md` |
-| DeepSeek Harness (DSH) | profile `cordis.patch.yml`（手动合并） | `dsh/cordis.patch.yml`（用 `@deepseek-ai/dsh-mcp-client`，工具名为 `mcp__agent-hub__bridge_*`） | `$DSH_HOME/skills/agent-comm-hub/SKILL.md` |
+| DeepSeek Harness (DSH) | profile `cordis.patch.yml`（手动合并） | `dsh/cordis.patch.yml`（`@deepseek-ai/dsh-mcp-client`，**serverName: `agent-comm-hub`**，工具名为 `mcp__agent-comm-hub__bridge_*`；刻意不用 `agent-hub`，避免与 MCP 管理器动态挂载同名冲突） | `$DSH_HOME/skills/agent-comm-hub/SKILL.md` |
 
 > 各 agent 对 streamable-http MCP 的支持随版本演进，模板里的字段以官方文档为准；
 > 不支持的版本可退化为 stdio 包装（见下）。

package/agents/SKILL.md

@@ -30,8 +30,11 @@ Optional: call `bridge_register(peerId)` to claim a readable id
 - `bridge_ack(ref, status, note?)` — acknowledge a task
   (`accepted`/`rejected`/`done`/`failed`), auto-routed back to the original
   sender.
-- `bridge_wait(from?, timeoutMs?)` — long-poll for the next message (default
-  30 s; loop it to hold a real-time conversation).
+- `bridge_task_status(ref)` — one task's ledger state + full ack timeline.
+- `bridge_tasks(role?, status?, limit?)` — list tasks you sent or received.
+- `bridge_wait(from?, ref?, timeoutMs?)` — long-poll for the next message
+  (default 30 s; `ref` waits specifically for that task's ack; loop it to
+  hold a real-time conversation).
 - `bridge_poll(from?)` — non-blocking drain of every queued message.
 - `bridge_status()` / `bridge_peers()` — hub health and who is online.
 - `bridge_history(peer?, limit?)` — recent messages (newest first). `peer`

package/agents/dsh/cordis.patch.yml

@@ -2,6 +2,10 @@
     - id: agent-comm-hub
       name: '@deepseek-ai/dsh-mcp-client'
       config:
-        serverName: agent-hub
+        # Distinct from the generic `agent-hub` key other agents use: a DSH
+        # MCP-manager plugin that dynamically mounts serverName "agent-hub"
+        # would otherwise collide ("serverName already in use") and fail the
+        # whole profile load.
+        serverName: agent-comm-hub
         transport: streamable-http
         url: http://127.0.0.1:18764/mcp

package/agents/registry.json

@@ -110,12 +110,14 @@
     {
       "id": "dsh",
       "probe": [],
+      "serverName": "agent-comm-hub",
       "configs": [
         {
           "file": "~/.dsh/profiles/*/cordis.patch.yml",
           "section": null,
           "strategy": "dsh",
-          "entry": null
+          "entry": null,
+          "serverName": "agent-comm-hub"
         }
       ],
       "skill": "~/.dsh/skills",