agent-comm-hub 0.1.7 → 0.1.8

package/README.md

@@ -93,11 +93,11 @@ agent-comm-hub setup
 ```
 
 `setup` incrementally merges the `agent-hub` MCP entry into every installed
-agent's own config (mcode, opencode, Kimi Code, Gemini CLI, Codex) and installs
-the English skill into `~/.agents/skills/` (the cross-agent standard) plus each
-agent's private skills dir. Only the `agent-hub` key is touched, every file is
-backed up first, and re-running is a no-op. Claude Code and DSH stay manual
-(see below).
+agent's own config (mcode, opencode, Kimi Code, Gemini CLI, Codex, zcode) and
+installs the English skill into `~/.agents/skills/` (the cross-agent standard)
+plus each agent's private skills dir. Only the `agent-hub` key is touched,
+every file is backed up first, and re-running is a no-op. Claude Code and DSH
+stay manual (see below).
 
 **Registration is automatic**: once an agent session starts, the MCP handshake
 registers it with the hub (client name becomes the peer id) — no manual step.
@@ -117,9 +117,9 @@ Each agent gets **one MCP server entry** pointing at `http://127.0.0.1:18764/mcp
 
 **One-shot incremental sync** (recommended): `agents/install-all.ps1` merges the
 `agent-hub` entry into every installed agent's MCP config (mcode, opencode,
-Kimi Code, Gemini CLI, Codex) and installs the skill — it only touches the
-`agent-hub` key, backs up each file, and is idempotent. Claude Code and DSH are
-manual (below).
+Kimi Code, Gemini CLI, Codex, zcode) and installs the skill — it only touches
+the `agent-hub` key, backs up each file, and is idempotent. Claude Code and DSH
+are manual (below).
 
 | Agent | Config file | Template | Skill location |
 |---|---|---|---|
@@ -128,6 +128,7 @@ manual (below).
 | Kimi Code | `~/.kimi-code/mcp.json` | [`agents/kimi-code/mcp-entry.json`](agents/kimi-code/mcp-entry.json) | `~/.kimi-code/skills/agent-comm-hub/SKILL.md` |
 | Gemini CLI | `~/.gemini/settings.json` | [`agents/gemini-cli/settings.json`](agents/gemini-cli/settings.json) | `~/.gemini/skills/agent-comm-hub/SKILL.md` |
 | Codex | `~/.codex/config.toml` | [`agents/codex/config.toml`](agents/codex/config.toml) | `~/.codex/skills/agent-comm-hub/SKILL.md` |
+| zcode | `~/.zcode/cli/config.json` (`mcp.servers`) | [`agents/zcode/config.json`](agents/zcode/config.json) | `~/.zcode/skills/agent-comm-hub/SKILL.md` |
 | Claude Code | project `.mcp.json` (manual; `~/.claude.json` is never touched) | [`agents/claude-code/.mcp.json`](agents/claude-code/.mcp.json) | `~/.claude/skills/agent-comm-hub/SKILL.md` |
 | DeepSeek Harness (DSH) | profile `cordis.patch.yml` (manual) | [`agents/dsh/cordis.patch.yml`](agents/dsh/cordis.patch.yml) | `$DSH_HOME/skills/agent-comm-hub/SKILL.md` |
 

package/README.zh.md

@@ -90,7 +90,7 @@ agent-comm-hub setup
 ```
 
 `setup` 会把 `agent-hub` 的 MCP 条目**增量合并**进每个已安装 agent 的配置
-（mcode / opencode / kimi-code / gemini / codex），并把英文 SKILL 装到
+（mcode / opencode / kimi-code / gemini / codex / zcode），并把英文 SKILL 装到
 `~/.agents/skills/`（跨 agent 标准位置）+ 各 agent 私有技能目录。只动
 `agent-hub` 这一个键、每个文件先备份、幂等可重跑。Claude Code 与 DSH 手动（见下）。
 
@@ -115,6 +115,7 @@ curl -X POST http://127.0.0.1:18764/mcp \
 | Kimi Code | `~/.kimi-code/mcp.json` | [`agents/kimi-code/mcp-entry.json`](agents/kimi-code/mcp-entry.json) | `~/.kimi-code/skills/agent-comm-hub/SKILL.md` |
 | Gemini CLI | `~/.gemini/settings.json` | [`agents/gemini-cli/settings.json`](agents/gemini-cli/settings.json) | `~/.gemini/skills/agent-comm-hub/SKILL.md` |
 | Codex | `~/.codex/config.toml` | [`agents/codex/config.toml`](agents/codex/config.toml) | `~/.codex/skills/agent-comm-hub/SKILL.md` |
+| zcode | `~/.zcode/cli/config.json`（`mcp.servers`） | [`agents/zcode/config.json`](agents/zcode/config.json) | `~/.zcode/skills/agent-comm-hub/SKILL.md` |
 | Claude Code | 项目根 `.mcp.json`（手动；**绝不碰 `~/.claude.json`**——含凭据） | [`agents/claude-code/.mcp.json`](agents/claude-code/.mcp.json) | `~/.claude/skills/agent-comm-hub/SKILL.md` |
 | DeepSeek Harness (DSH) | profile `cordis.patch.yml`（手动） | [`agents/dsh/cordis.patch.yml`](agents/dsh/cordis.patch.yml) | `$DSH_HOME/skills/agent-comm-hub/SKILL.md` |
 

package/agents/README.md

@@ -16,7 +16,7 @@ powershell -ExecutionPolicy Bypass -File install-all.ps1
 `install-all.ps1` 会把 `agent-hub` 条目**增量合并**进每个已安装 agent 的 MCP 配置
 （只动 `agent-hub` 这个键，其余内容原样保留；每个文件先备份、幂等可重跑），并同步
 英文 SKILL 到各 agent 的技能目录。覆盖：mcode / opencode / kimi-code / Gemini CLI /
-Codex（TOML 追加）。Claude Code 和 DSH 需手动（见下表）。
+Codex（TOML 追加）/ zcode（`mcp.servers`）。Claude Code 和 DSH 需手动（见下表）。
 
 接入即自动上线（MCP 握手时用客户端名注册，无需手动 register）；想要可读的 peerId
 可以让 agent 调一次 `bridge_register(peerId)`。
@@ -28,6 +28,7 @@ Codex（TOML 追加）。Claude Code 和 DSH 需手动（见下表）。
 | Kimi Code | `~/.kimi-code/mcp.json` | `kimi-code/mcp-entry.json`（`transport: "http"`，url 自动推断为 http） | `~/.kimi-code/skills/agent-comm-hub/SKILL.md` |
 | Gemini CLI | `~/.gemini/settings.json` | `gemini-cli/settings.json` | `~/.gemini/skills/agent-comm-hub/SKILL.md` |
 | 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` |
 

package/agents/install-all.ps1

@@ -11,6 +11,7 @@ Covered agents (auto-skipped when not installed):
   - Kimi Code              ~/.kimi-code/mcp.json
   - Gemini CLI             ~/.gemini/settings.json
   - Codex                  ~/.codex/config.toml (appends the section if missing)
+  - zcode                  ~/.zcode/cli/config.json (mcp.servers)
 
 Not covered (manual, documented in agents/README.md):
   - Claude Code  -> project-level .mcp.json (copy agents/claude-code/.mcp.json)
@@ -69,11 +70,13 @@ function Merge-JsonServer($label, $file, $sectionName, $entry) {
   try {
     $doc = Read-Json $file
     if ($null -eq $doc) { Write-Step "  ${label}: empty config (skipped)"; return }
-    $servers = $doc.$sectionName
-    if ($null -eq $servers) {
-      # Incremental: create only the missing section, keep the rest untouched.
-      $servers = [ordered]@{}
-      $doc | Add-Member -NotePropertyName $sectionName -NotePropertyValue $servers -Force
+    # Resolve (creating when missing) a dotted section path like 'mcp.servers'.
+    $servers = $doc
+    foreach ($part in $sectionName.Split('.')) {
+      if ($null -eq $servers.$part) {
+        $servers | Add-Member -NotePropertyName $part -NotePropertyValue ([ordered]@{}) -Force
+      }
+      $servers = $servers.$part
     }
     $changed = $false
     if ($servers.PSObject.Properties.Name -contains $ServerName) {
@@ -161,6 +164,12 @@ if (Test-Path $codexFile) {
   Write-Step "  codex: not installed ($codexFile missing, skipped)"
 }
 
+# ---------- zcode: mcp.servers in ~/.zcode/cli/config.json
+$zcodeEntry = [ordered]@{ enabled = $true; type = 'remote'; url = $Url }
+Write-Step '- zcode'
+Merge-JsonServer 'zcode' (Join-Path $userHome '.zcode\cli\config.json') 'mcp.servers' $zcodeEntry
+Sync-Skill 'zcode' (Join-Path $userHome ".zcode\skills\$ServerName")
+
 # ---------- skills: cross-agent standard location + each agent's private dir
 $skillDirs = @(
   (Join-Path $userHome ".agents\skills\$ServerName"),   # cross-agent standard
@@ -169,6 +178,7 @@ $skillDirs = @(
   (Join-Path $userHome ".kimi-code\skills\$ServerName"),
   (Join-Path $userHome ".gemini\skills\$ServerName"),
   (Join-Path $userHome ".codex\skills\$ServerName"),
+  (Join-Path $userHome ".zcode\skills\$ServerName"),
   (Join-Path $userHome ".claude\skills\$ServerName")    # config is manual; skill still useful
 )
 foreach ($dir in $skillDirs) { Sync-Skill 'skill' $dir }

package/agents/zcode/config.json

@@ -0,0 +1,11 @@
+{
+  "mcp": {
+    "servers": {
+      "agent-hub": {
+        "enabled": true,
+        "type": "remote",
+        "url": "http://127.0.0.1:18764/mcp"
+      }
+    }
+  }
+}

package/lib/cli.js

@@ -710,7 +710,7 @@ function readBody(req) {
 
 // src/index.ts
 var SERVER_NAME = "agent-comm-hub";
-var SERVER_VERSION = "0.1.7";
+var SERVER_VERSION = "0.1.8";
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_PORT = 18764;
 var DEFAULT_PATH = "/mcp";
@@ -806,15 +806,23 @@ async function backup(file) {
   await copyFile(file, bak);
   return bak;
 }
+function resolveSection(doc, section) {
+  let node = doc;
+  for (const part of section.split(".")) {
+    let next = node[part];
+    if (next === void 0 || typeof next !== "object" || Array.isArray(next)) {
+      next = {};
+      node[part] = next;
+    }
+    node = next;
+  }
+  return node;
+}
 async function mergeJsonServer(file, section, entry, opts) {
   if (!existsSync(file)) return "skipped";
   const doc = await readJson(file);
   if (doc === null) return "skipped";
-  let servers = doc[section];
-  if (servers === void 0 || typeof servers !== "object" || Array.isArray(servers)) {
-    servers = {};
-    doc[section] = servers;
-  }
+  const servers = resolveSection(doc, section);
   const has = Object.prototype.hasOwnProperty.call(servers, opts.serverName);
   if (opts.remove) {
     if (!has) return "absent";
@@ -896,7 +904,8 @@ async function runSetup(options = {}) {
     { label: "mcode", file: join(home, ".minimax", "mcp", "mcp.json"), section: "mcpServers", entry: { url, type: "streamable-http", enabled: true, configured: true, timeout: 12e4, description: "agent-comm-hub: talk to every other agent connected to the hub." } },
     { label: "opencode", file: join(home, ".config", "opencode", "opencode.json"), section: "mcp", entry: { type: "remote", url, enabled: true } },
     { label: "kimi-code", file: join(home, ".kimi-code", "mcp.json"), section: "mcpServers", entry: { transport: "http", url, startupTimeoutMs: 3e4, toolTimeoutMs: 12e4 } },
-    { label: "gemini-cli", file: join(home, ".gemini", "settings.json"), section: "mcpServers", entry: { type: "http", url } }
+    { label: "gemini-cli", file: join(home, ".gemini", "settings.json"), section: "mcpServers", entry: { type: "http", url } },
+    { label: "zcode", file: join(home, ".zcode", "cli", "config.json"), section: "mcp.servers", entry: { type: "remote", url, enabled: true } }
   ];
   for (const target of jsonTargets) {
     try {
@@ -923,6 +932,7 @@ async function runSetup(options = {}) {
     join(home, ".kimi-code", "skills", serverName),
     join(home, ".gemini", "skills", serverName),
     join(home, ".codex", "skills", serverName),
+    join(home, ".zcode", "skills", serverName),
     join(home, ".claude", "skills", serverName)
     // config is manual; skill still useful
   ];

package/lib/index.js

@@ -713,7 +713,7 @@ function readBody(req) {
 
 // src/index.ts
 var SERVER_NAME = "agent-comm-hub";
-var SERVER_VERSION = "0.1.7";
+var SERVER_VERSION = "0.1.8";
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_PORT = 18764;
 var DEFAULT_PATH = "/mcp";

package/lib/setup.js

@@ -31,15 +31,23 @@ async function backup(file) {
   await copyFile(file, bak);
   return bak;
 }
+function resolveSection(doc, section) {
+  let node = doc;
+  for (const part of section.split(".")) {
+    let next = node[part];
+    if (next === void 0 || typeof next !== "object" || Array.isArray(next)) {
+      next = {};
+      node[part] = next;
+    }
+    node = next;
+  }
+  return node;
+}
 async function mergeJsonServer(file, section, entry, opts) {
   if (!existsSync(file)) return "skipped";
   const doc = await readJson(file);
   if (doc === null) return "skipped";
-  let servers = doc[section];
-  if (servers === void 0 || typeof servers !== "object" || Array.isArray(servers)) {
-    servers = {};
-    doc[section] = servers;
-  }
+  const servers = resolveSection(doc, section);
   const has = Object.prototype.hasOwnProperty.call(servers, opts.serverName);
   if (opts.remove) {
     if (!has) return "absent";
@@ -121,7 +129,8 @@ async function runSetup(options = {}) {
     { label: "mcode", file: join(home, ".minimax", "mcp", "mcp.json"), section: "mcpServers", entry: { url, type: "streamable-http", enabled: true, configured: true, timeout: 12e4, description: "agent-comm-hub: talk to every other agent connected to the hub." } },
     { label: "opencode", file: join(home, ".config", "opencode", "opencode.json"), section: "mcp", entry: { type: "remote", url, enabled: true } },
     { label: "kimi-code", file: join(home, ".kimi-code", "mcp.json"), section: "mcpServers", entry: { transport: "http", url, startupTimeoutMs: 3e4, toolTimeoutMs: 12e4 } },
-    { label: "gemini-cli", file: join(home, ".gemini", "settings.json"), section: "mcpServers", entry: { type: "http", url } }
+    { label: "gemini-cli", file: join(home, ".gemini", "settings.json"), section: "mcpServers", entry: { type: "http", url } },
+    { label: "zcode", file: join(home, ".zcode", "cli", "config.json"), section: "mcp.servers", entry: { type: "remote", url, enabled: true } }
   ];
   for (const target of jsonTargets) {
     try {
@@ -148,6 +157,7 @@ async function runSetup(options = {}) {
     join(home, ".kimi-code", "skills", serverName),
     join(home, ".gemini", "skills", serverName),
     join(home, ".codex", "skills", serverName),
+    join(home, ".zcode", "skills", serverName),
     join(home, ".claude", "skills", serverName)
     // config is manual; skill still useful
   ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-comm-hub",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Generic multi-peer MCP hub: any MCP-capable agent (MiniMax Code, Claude Code, opencode, Codex, Gemini CLI, DSH, ...) connects to one local streamable-http endpoint and they chat, delegate tasks, and acknowledge in real time",
   "keywords": [
     "mcp",