agent-comm-hub 0.1.7 → 0.1.9

package/README.md

@@ -63,6 +63,13 @@ npm install -D agent-comm-hub
 npx agent-comm-hub
 ```
 
+Update later without a manual reinstall (files are replaced in place, so an
+installed auto-start launcher keeps working; restart the hub afterwards):
+
+```bash
+agent-comm-hub update
+```
+
 ### 2. Start the hub
 
 ```bash
@@ -93,11 +100,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 +124,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 +135,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

@@ -63,6 +63,12 @@ npm install -D agent-comm-hub
 npx agent-comm-hub
 ```
 
+之后想更新（免手动重装，文件原地替换，已装的自启动器不受影响；更新后重启 hub）：
+
+```bash
+agent-comm-hub update
+```
+
 ### 2. 启动 hub
 
 ```bash
@@ -90,7 +96,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 +121,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.9";
 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
   ];
@@ -942,9 +952,9 @@ async function runSetup(options = {}) {
 // src/ops.ts
 import { execFileSync } from "node:child_process";
 import { request } from "node:http";
-import { mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import { join as join2 } from "node:path";
+import { dirname as dirname2, join as join2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 async function runStatus(options = {}) {
   const host = options.host ?? "127.0.0.1";
@@ -994,6 +1004,32 @@ async function runStatus(options = {}) {
     return { ...notRunning, error: error.message };
   }
 }
+function runUpdate() {
+  const messages = [];
+  const pkgFile = join2(dirname2(fileURLToPath2(import.meta.url)), "..", "package.json");
+  const readVersion = () => {
+    try {
+      return JSON.parse(readFileSync(pkgFile, "utf8")).version ?? "?";
+    } catch {
+      return "?";
+    }
+  };
+  try {
+    const before = readVersion();
+    messages.push(`current version: ${before}`);
+    const npmBin = process.platform === "win32" ? "npm.cmd" : "npm";
+    const out = execFileSync(npmBin, ["install", "-g", "agent-comm-hub@latest"], { encoding: "utf8", windowsHide: true, shell: process.platform === "win32" });
+    const tail = out.trim().split(/\r?\n/).slice(-3).filter(Boolean).join(" | ");
+    if (tail) messages.push(tail);
+    const after = readVersion();
+    if (after === before) messages.push(`already up to date (v${after})`);
+    else messages.push(`updated: v${before} -> v${after}`);
+    messages.push("restart the hub (agent-comm-hub) to pick up the new version");
+    return { ok: true, messages };
+  } catch (error) {
+    return { ok: false, messages: [`update failed: ${error.message}`] };
+  }
+}
 function cliPath() {
   return fileURLToPath2(import.meta.url);
 }
@@ -1133,6 +1169,9 @@ Usage:
                                            one-shot auto-start (Windows Run
                                            key + hidden VBS launcher, no admin;
                                            Linux systemd; --dry-run prints)
+  agent-comm-hub update                  self-update from the npm registry
+                                           (files updated in place; restart
+                                           the hub afterwards)
 
 Hub options:
   --host <addr>            Bind address (default 127.0.0.1)
@@ -1221,6 +1260,20 @@ try {
     }
     process.exit(0);
   }
+  if (command === "update") {
+    const args2 = parseArgs(rest);
+    if (args2["--help"] || args2["-h"]) {
+      printHelp();
+      process.exit(0);
+    }
+    const result = runUpdate();
+    for (const message of result.messages) log.info(message);
+    if (!result.ok) {
+      console.error("update: failed \u2014 see messages above");
+      process.exit(1);
+    }
+    process.exit(0);
+  }
   const args = parseArgs(argv);
   if (args["--help"] || args["-h"]) {
     printHelp();

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.9";
 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.9",
   "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",