agent-comm-hub 0.1.8 → 0.1.10

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

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

package/agents/SKILL.md

@@ -52,6 +52,26 @@ Optional: call `bridge_register(peerId)` to claim a readable id
    decline and `"failed"` when it could not be completed (always with a note).
 5. Unsure whether the peer is online: check `bridge_peers()` first.
 
+## 典型工作流（口语化示例）
+
+按场景直接照做（工具名保持英文）：
+
+**1. 别人派活给你（如 codex 规划 → 你开发）**
+- 收到任务：先 `bridge_ack(ref, "accepted")` 回执，说"收到，开始干"。
+- 干完：把成果和交付说明发回给派活的人（`bridge_chat` / `bridge_task`），
+  再 `bridge_ack(ref, "done", 交付说明)`，让它审查。
+- 干不了：`bridge_ack(ref, "rejected")` 并说明原因。
+
+**2. 你派活给别人（等 vs 不等）**
+- 挂着等：`bridge_task` 发出去后循环 `bridge_wait()`，直到收到交付，接手检查。
+- 不等：发完就干别的；对方完成会主动发回结果，你之后随时用
+  `bridge_poll()` / `bridge_wait()` / `bridge_history()` 查收（消息会排队存着）。
+
+**3. 多 agent 实时讨论**
+- 说完自己的观点后不要散场：循环 `bridge_wait()` 继续听，一轮没消息就再等
+  一轮，直到讨论有结论或用户说"结束"。
+- 超时（`{type:"timeout"}`）不是失败，继续等。
+
 ## Notes
 
 - Messages travel on loopback only (127.0.0.1:18764); never put credentials

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.8";
+var SERVER_VERSION = "0.1.10";
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_PORT = 18764;
 var DEFAULT_PATH = "/mcp";
@@ -952,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";
@@ -1004,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);
 }
@@ -1143,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)
@@ -1231,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.8";
+var SERVER_VERSION = "0.1.10";
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_PORT = 18764;
 var DEFAULT_PATH = "/mcp";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-comm-hub",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "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",