agent-comm-hub 0.4.0 → 0.5.0

package/README.md

@@ -309,7 +309,7 @@ agent-comm-hub service install|uninstall [options]   one-shot auto-start
 --port <n>               Listen port (default 18764)
 --path <p>               MCP endpoint path (default /mcp)
 --max-queue <n>          Queued messages per peer before dropping oldest (default 200)
---history-limit <n>      Retained history messages (default 100)
+--history-limit <n>      Retained history messages (default 1000)
 --wait-timeout-ms <n>    Long-poll ceiling for bridge_wait (default 60000)
 --default-wait-ms <n>    bridge_wait default budget (default 30000)
 --connected-window-ms <n>  Peer counts as active within this window (default 30000)
@@ -397,6 +397,36 @@ pnpm run build        # esbuild → lib/{cli,index,setup}.js (zero deps)
 pnpm pack             # build + npm pack (publishing artifact)
 ```
 
+## Desktop GUI
+
+A companion desktop GUI is shipped as a separate npm package: **`agent-comm-hub-app`**. It is a standalone Tauri 2 + React app, lives in `app/`, and depends on the MCP HTTP API rather than on this package's source. It does NOT relax the `dependencies: {}` constraint of the main package — workspace isolation is enforced via `app/pnpm-workspace.yaml`.
+
+| English | 简体中文 |
+|---|---|
+| ![agent-comm-hub-app (EN)](assets/ach-en.png) | ![agent-comm-hub-app (CN)](assets/ach-cn.png) |
+
+```bash
+cd app
+pnpm install
+pnpm tauri:dev        # dev with hot reload
+pnpm tauri:build      # produces NSIS / MSI / dmg / AppImage / deb installers
+```
+
+Highlights:
+
+- **Hub lifecycle in one window**: auto-spawn on launch (4-tier PATH fallback), start / stop / restart, live log panel with stderr filter + expandable viewer, and an external-hub reuse mode with health probing
+- **Real-time messaging**: `bridge_wait` long-poll keeps the UI live; optimistic send shows your messages instantly; `/history` merges hub memory with the SQLite archive (survives hub restarts)
+- **Peer conversations** (PRD US-2): click any peer to view its full conversation, not just yours; unread badges per peer
+- **Message details**: raw JSON view, task prompt/context/deliverable, ack state-machine timeline
+- **Slash commands**: `/peers /broadcast /history /clear /help` — from the palette or typed directly
+- **Markdown rendering** with rehype-sanitize, multi-peer cc, drag-drop attachments (≤5 MB), virtual scrolling
+- **Theme system**: dark / light / system-follow, brand-blue palette, persisted
+- **Frameless window**: custom titlebar (drag region, double-click maximize), close dialog with minimize-to-tray / quit / cancel
+- **Hub tools in Settings**: install / version / check update / update the hub CLI, one-click `setup` to detect local agents and install the SKILL + MCP config, auto-start service install
+- **System tray** with brand logo and status tooltip; i18n (zh-CN default, en-US)
+
+See `app/README.md` for the full feature list and architecture.
+
 Tests cover registration, duplicate rejection, chat routing, sender-filtered waits, task+ack routing back to the sender, broadcast, status/peers/history, unregister/re-register, and error paths.
 
 ## Troubleshooting

package/README.zh.md

@@ -220,7 +220,7 @@ agent-comm-hub service install|uninstall [options]   一键自启
 --port <n>                端口（默认 18764）
 --path <p>                MCP 路径（默认 /mcp）
 --max-queue <n>           每 peer 队列上限，溢出丢最旧（默认 200）
---history-limit <n>       保留的历史条数（默认 100）
+--history-limit <n>       保留的历史条数（默认 1000）
 --wait-timeout-ms <n>     bridge_wait 长轮询上限（默认 60000）
 --default-wait-ms <n>     bridge_wait 默认预算（默认 30000）
 --connected-window-ms <n> 活跃窗口（默认 30000）
@@ -273,6 +273,36 @@ pnpm run build        # esbuild → lib/{cli,index,setup}.js（零依赖）
 pnpm pack             # 构建 + npm pack（发布产物）
 ```
 
+## 桌面端 GUI
+
+配套桌面端是另一个独立 npm 包 **`agent-comm-hub-app`**,在 `app/` 目录,Tauri 2 + React。它只走 hub 的 MCP / HTTP API,不引入主仓源码,也不会动 `dependencies: {}` 这个零依赖约束 —— 通过 `app/pnpm-workspace.yaml` 做工作区隔离。
+
+| 简体中文 | English |
+|---|---|
+| ![agent-comm-hub-app (CN)](assets/ach-cn.png) | ![agent-comm-hub-app (EN)](assets/ach-en.png) |
+
+```bash
+cd app
+pnpm install
+pnpm tauri:dev        # 开发模式 (HMR)
+pnpm tauri:build      # 三平台安装包 (NSIS / MSI / dmg / AppImage / deb)
+```
+
+主要能力:
+
+- **一站式 Hub 生命周期**:启动自动拉起 hub (4-tier PATH 兜底)、启停/重启、实时日志面板 (stderr 过滤 + 放大查看),外部 hub 复用模式带健康探测
+- **实时消息**:`bridge_wait` 长轮询保持界面实时;发送即乐观显示;`/history` 合并 hub 内存与 SQLite 存档 (重启不丢)
+- **会话视角** (PRD US-2):点击任意 peer 查看它的完整会话;per-peer 未读徽章
+- **消息详情**:原始 JSON、task prompt/context/deliverable、ack 状态机时间线
+- **斜杠命令**:`/peers /broadcast /history /clear /help` —— 面板选择或直接输入
+- **Markdown 渲染** + rehype-sanitize、多会话方 cc、拖拽附件 (≤5 MB)、虚拟滚动
+- **主题系统**:深色 / 浅色 / 跟随系统,品牌蓝主题,持久化
+- **无边框窗口**:自绘标题栏 (拖拽区、双击最大化),关闭弹窗三选一 (最小化到托盘 / 退出 / 取消)
+- **设置页 Hub 工具**:安装 / 版本 / 检查更新 / 更新 hub CLI,一键 `setup` 检测本地 agent 并安装 SKILL + MCP 配置,开机自启服务
+- **系统托盘** (品牌 logo + 状态 tooltip);i18n (简中默认 + 英文)
+
+详见 `app/README.zh.md`。
+
 ## 故障排查
 
 | 症状 | 原因 / 解决 |

package/agents/SKILL.md

@@ -34,7 +34,9 @@ Optional: call `bridge_register(peerId)` to claim a readable id
   30 s; 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).
+- `bridge_history(peer?, limit?)` — recent messages (newest first). `peer`
+  defaults to you; pass another peer's id to read their conversation, or
+  `"all"` for the unfiltered tail across every peer.
 
 ## When to use
 

package/lib/cli.js

@@ -512,6 +512,12 @@ var AgentHub = class {
     const filtered = this.historyRing.filter((message) => message.from === peerId || message.to === peerId || message.to === BROADCAST);
     return filtered.slice(-Math.max(0, limit)).reverse();
   }
+  /** Most recent messages across every peer, unfiltered (newest first).
+   * Backs `bridge_history { peer: "all" }` — lets an archiver (the desktop
+   * app) capture peer-to-peer traffic it is not a party of. */
+  historyAll(limit) {
+    return this.historyRing.slice(-Math.max(0, limit)).reverse();
+  }
   /**
    * Live summary for the status tool. `livePeers` (sessions with a live SSE
    * stream) count as connected even without recent tool activity.
@@ -840,9 +846,13 @@ function hubTools(hub, registry, options) {
     },
     {
       name: "bridge_history",
-      description: "Recent messages involving you (newest first); pass `peer` to inspect another peer's conversation. Use to refresh context after a reconnect.",
-      inputSchema: schema({ peer: optStr("PeerId whose conversation to inspect; default: yourself."), limit: int("How many messages to return (default 20).") }),
-      handler: wrap(true, async (args, peer) => ({ messages: hub.history(args.peer === void 0 ? peer : String(args.peer), Math.min(args.limit === void 0 ? 20 : Number(args.limit), 100)).map(present) }))
+      description: 'Recent messages involving you (newest first); pass `peer` to inspect another peer\'s conversation, or `peer: "all"` for the unfiltered tail across every peer. Use to refresh context after a reconnect.',
+      inputSchema: schema({ peer: optStr('PeerId whose conversation to inspect; "all" = every peer; default: yourself.'), limit: int("How many messages to return (default 20).") }),
+      handler: wrap(true, async (args, peer) => {
+        const limit = Math.min(args.limit === void 0 ? 20 : Number(args.limit), 1e3);
+        const messages = args.peer === "all" ? hub.historyAll(limit) : hub.history(args.peer === void 0 ? peer : String(args.peer), limit);
+        return { messages: messages.map(present) };
+      })
     },
     // ---- herdr control tools ------------------------------------------
     // These type into real agent terminals via the herdr runtime. They are
@@ -1334,7 +1344,7 @@ function readBody(req) {
 
 // src/index.ts
 var SERVER_NAME = "agent-comm-hub";
-var SERVER_VERSION = "0.4.0";
+var SERVER_VERSION = "0.5.0";
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_PORT = 18764;
 var DEFAULT_PATH = "/mcp";
@@ -1343,7 +1353,10 @@ var DEFAULT_CONFIG = {
   port: DEFAULT_PORT,
   path: DEFAULT_PATH,
   maxQueue: 200,
-  historyLimit: 100,
+  // 100 was too small to survive a long multi-agent session: the ring is the
+  // only archive source until the desktop app persists it to SQLite, and a
+  // night of agent-to-agent chatter evicts everything within minutes.
+  historyLimit: 1e3,
   waitTimeoutMs: 6e4,
   defaultWaitMs: 3e4,
   connectedWindowMs: 3e4,
@@ -2130,7 +2143,7 @@ Hub options:
   --port <n>               Listen port (default 18764)
   --path <p>               MCP endpoint path (default /mcp)
   --max-queue <n>          Queued messages per peer before dropping oldest (default 200)
-  --history-limit <n>      Retained history messages (default 100)
+  --history-limit <n>      Retained history messages (default 1000)
   --wait-timeout-ms <n>    Long-poll ceiling for bridge_wait (default 60000)
   --default-wait-ms <n>    bridge_wait default budget (default 30000)
   --connected-window-ms <n>  Peer counts as active within this window (default 30000)

package/lib/index.js

@@ -515,6 +515,12 @@ var AgentHub = class {
     const filtered = this.historyRing.filter((message) => message.from === peerId || message.to === peerId || message.to === BROADCAST);
     return filtered.slice(-Math.max(0, limit)).reverse();
   }
+  /** Most recent messages across every peer, unfiltered (newest first).
+   * Backs `bridge_history { peer: "all" }` — lets an archiver (the desktop
+   * app) capture peer-to-peer traffic it is not a party of. */
+  historyAll(limit) {
+    return this.historyRing.slice(-Math.max(0, limit)).reverse();
+  }
   /**
    * Live summary for the status tool. `livePeers` (sessions with a live SSE
    * stream) count as connected even without recent tool activity.
@@ -843,9 +849,13 @@ function hubTools(hub, registry, options) {
     },
     {
       name: "bridge_history",
-      description: "Recent messages involving you (newest first); pass `peer` to inspect another peer's conversation. Use to refresh context after a reconnect.",
-      inputSchema: schema({ peer: optStr("PeerId whose conversation to inspect; default: yourself."), limit: int("How many messages to return (default 20).") }),
-      handler: wrap(true, async (args, peer) => ({ messages: hub.history(args.peer === void 0 ? peer : String(args.peer), Math.min(args.limit === void 0 ? 20 : Number(args.limit), 100)).map(present) }))
+      description: 'Recent messages involving you (newest first); pass `peer` to inspect another peer\'s conversation, or `peer: "all"` for the unfiltered tail across every peer. Use to refresh context after a reconnect.',
+      inputSchema: schema({ peer: optStr('PeerId whose conversation to inspect; "all" = every peer; default: yourself.'), limit: int("How many messages to return (default 20).") }),
+      handler: wrap(true, async (args, peer) => {
+        const limit = Math.min(args.limit === void 0 ? 20 : Number(args.limit), 1e3);
+        const messages = args.peer === "all" ? hub.historyAll(limit) : hub.history(args.peer === void 0 ? peer : String(args.peer), limit);
+        return { messages: messages.map(present) };
+      })
     },
     // ---- herdr control tools ------------------------------------------
     // These type into real agent terminals via the herdr runtime. They are
@@ -1337,7 +1347,7 @@ function readBody(req) {
 
 // src/index.ts
 var SERVER_NAME = "agent-comm-hub";
-var SERVER_VERSION = "0.4.0";
+var SERVER_VERSION = "0.5.0";
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_PORT = 18764;
 var DEFAULT_PATH = "/mcp";
@@ -1346,7 +1356,10 @@ var DEFAULT_CONFIG = {
   port: DEFAULT_PORT,
   path: DEFAULT_PATH,
   maxQueue: 200,
-  historyLimit: 100,
+  // 100 was too small to survive a long multi-agent session: the ring is the
+  // only archive source until the desktop app persists it to SQLite, and a
+  // night of agent-to-agent chatter evicts everything within minutes.
+  historyLimit: 1e3,
   waitTimeoutMs: 6e4,
   defaultWaitMs: 3e4,
   connectedWindowMs: 3e4,

package/package.json

@@ -1,46 +1,44 @@
-{
-  "name": "agent-comm-hub",
-  "version": "0.4.0",
-  "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",
-    "agent",
-    "hub",
-    "multi-agent",
-    "communication",
-    "streamable-http",
-    "cli",
-    "ai"
-  ],
-  "author": "agent-comm-hub contributors",
-  "type": "module",
-  "main": "lib/index.js",
-  "bin": {
-    "agent-comm-hub": "lib/cli.js"
-  },
-  "files": [
-    "lib",
-    "agents",
-    "assets",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=22"
-  },
-  "license": "MIT",
-  "dependencies": {},
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "esbuild": "^0.25.0",
-    "typescript": "^5.8.0"
-  },
-  "scripts": {
-    "build": "esbuild src/cli.ts --bundle --platform=node --format=esm --outfile=lib/cli.js && esbuild src/index.ts --bundle --platform=node --format=esm --outfile=lib/index.js && esbuild src/setup.ts --bundle --platform=node --format=esm --outfile=lib/setup.js",
-    "build:test": "esbuild test/entry.ts --bundle --platform=node --format=esm --outfile=test/entry.mjs && esbuild test/setup-entry.ts --bundle --platform=node --format=esm --outfile=test/setup-entry.mjs && esbuild test/ops-entry.ts --bundle --platform=node --format=esm --outfile=test/ops-entry.mjs && esbuild test/herdr-entry.ts --bundle --platform=node --format=esm --outfile=test/herdr-entry.mjs && esbuild test/discover-entry.ts --bundle --platform=node --format=esm --outfile=test/discover-entry.mjs",
-    "typecheck": "tsc --noEmit",
-    "test": "pnpm run build:test && node test/smoke.mjs && node test/setup.mjs && node test/ops.mjs && node test/herdr.mjs && node test/discover.mjs",
-    "pack": "pnpm run build && pnpm pack",
-    "prepublishOnly": "pnpm run test && pnpm run build",
-    "prepare": "pnpm run build"
-  }
-}
+{
+  "name": "agent-comm-hub",
+  "version": "0.5.0",
+  "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",
+    "agent",
+    "hub",
+    "multi-agent",
+    "communication",
+    "streamable-http",
+    "cli",
+    "ai"
+  ],
+  "author": "agent-comm-hub contributors",
+  "type": "module",
+  "main": "lib/index.js",
+  "bin": {
+    "agent-comm-hub": "lib/cli.js"
+  },
+  "files": [
+    "lib",
+    "agents",
+    "assets",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.25.0",
+    "typescript": "^5.8.0"
+  },
+  "scripts": {
+    "build": "esbuild src/cli.ts --bundle --platform=node --format=esm --outfile=lib/cli.js && esbuild src/index.ts --bundle --platform=node --format=esm --outfile=lib/index.js && esbuild src/setup.ts --bundle --platform=node --format=esm --outfile=lib/setup.js",
+    "build:test": "esbuild test/entry.ts --bundle --platform=node --format=esm --outfile=test/entry.mjs && esbuild test/setup-entry.ts --bundle --platform=node --format=esm --outfile=test/setup-entry.mjs && esbuild test/ops-entry.ts --bundle --platform=node --format=esm --outfile=test/ops-entry.mjs && esbuild test/herdr-entry.ts --bundle --platform=node --format=esm --outfile=test/herdr-entry.mjs && esbuild test/discover-entry.ts --bundle --platform=node --format=esm --outfile=test/discover-entry.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm run build:test && node test/smoke.mjs && node test/setup.mjs && node test/ops.mjs && node test/herdr.mjs && node test/discover.mjs",
+    "pack": "pnpm run build && pnpm pack"
+  }
+}