agent-comms 8.2.0 → 8.3.0

package/dist/test/mcp-stdout-channel.integration.test.js

@@ -0,0 +1,116 @@
+/**
+ * stdout is the MCP channel (agent-comms#348): with stdin piped, the bridge must write nothing to it that is not a JSON-RPC message, or a strictly framed client rejects the stream. Diagnostics, including the web UI banner, belong on stderr.
+ */
+import { afterEach, expect, it } from "vitest";
+import * as child_process from "node:child_process";
+import * as fs from "node:fs";
+import { tmpdir } from "node:os";
+import * as path from "node:path";
+import * as readline from "node:readline";
+import { fileURLToPath } from "node:url";
+import { freeLocalPort, TeardownStack, unreachableHubUrl, } from "./hub-helpers.js";
+const cleanups = new TeardownStack();
+afterEach(async () => {
+    await cleanups.run();
+});
+const RUNNER = path.join(path.dirname(fileURLToPath(import.meta.url)), "mcp-bridge.runner.ts");
+const INITIALIZE_ID = 1;
+const TOOLS_LIST_ID = 2;
+const MCP_PROTOCOL_VERSION = "2025-06-18";
+/** Startup includes a real store init and web server start in a fresh process, so the wait is generous; the test's own timeout is the backstop. */
+const RESPONSE_TIMEOUT_MS = 25_000;
+function jsonRpcLine(message) {
+    return `${JSON.stringify({ jsonrpc: "2.0", ...message })}\n`;
+}
+function isJsonRpcMessage(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "jsonrpc" in value &&
+        value.jsonrpc === "2.0");
+}
+it("writes only JSON-RPC messages to stdout and puts the web UI banner on stderr", async () => {
+    const slotDir = fs.mkdtempSync(path.join(tmpdir(), "agent-comms-mcp-test-"));
+    cleanups.push(async () => {
+        fs.rmSync(slotDir, { recursive: true, force: true });
+    });
+    const child = child_process.spawn(process.execPath, [
+        "--import",
+        "tsx",
+        RUNNER,
+        JSON.stringify({
+            coordinatorPort: await freeLocalPort(),
+            firstContactPort: await freeLocalPort(),
+            hubUrl: await unreachableHubUrl(),
+            slotDir,
+        }),
+    ], { stdio: ["pipe", "pipe", "pipe"] });
+    const exited = new Promise((resolve) => {
+        child.once("exit", () => {
+            resolve();
+        });
+    });
+    cleanups.push(async () => {
+        child.kill("SIGTERM");
+        await exited;
+    });
+    const stdoutLines = [];
+    let stderr = "";
+    child.stderr.on("data", (chunk) => {
+        stderr += chunk.toString();
+    });
+    const answered = new Set();
+    const BANNER = "Agent Comms web UI: http://127.0.0.1:";
+    let notifyStderr = () => undefined;
+    child.stderr.on("data", () => {
+        notifyStderr();
+    });
+    const bothAnsweredWithBanner = new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`no JSON-RPC responses and stderr banner within the timeout; stdout=${JSON.stringify(stdoutLines)} stderr=${stderr}`));
+        }, RESPONSE_TIMEOUT_MS);
+        // stdout and stderr are separate pipes, so the parent can see the responses before the banner written earlier: completion needs both.
+        const settleIfComplete = () => {
+            if (answered.has(INITIALIZE_ID) &&
+                answered.has(TOOLS_LIST_ID) &&
+                stderr.includes(BANNER)) {
+                clearTimeout(timer);
+                resolve();
+            }
+        };
+        notifyStderr = settleIfComplete;
+        readline.createInterface({ input: child.stdout }).on("line", (line) => {
+            stdoutLines.push(line);
+            try {
+                const parsed = JSON.parse(line);
+                if (typeof parsed === "object" &&
+                    parsed !== null &&
+                    "id" in parsed &&
+                    typeof parsed.id === "number") {
+                    answered.add(parsed.id);
+                }
+            }
+            catch {
+                // A non-JSON line is recorded above and fails the assertion below; the wait then ends at the timeout or the next response.
+            }
+            settleIfComplete();
+        });
+    });
+    child.stdin.write(jsonRpcLine({
+        id: INITIALIZE_ID,
+        method: "initialize",
+        params: {
+            protocolVersion: MCP_PROTOCOL_VERSION,
+            capabilities: {},
+            clientInfo: { name: "stdout-channel-test", version: "0.0.0" },
+        },
+    }));
+    child.stdin.write(jsonRpcLine({ method: "notifications/initialized" }));
+    child.stdin.write(jsonRpcLine({ id: TOOLS_LIST_ID, method: "tools/list" }));
+    await bothAnsweredWithBanner;
+    expect(stdoutLines.length).toBeGreaterThanOrEqual(2);
+    for (const line of stdoutLines) {
+        expect(isJsonRpcMessage(JSON.parse(line))).toBe(true);
+    }
+    expect(stderr).toContain(BANNER);
+});
+//# sourceMappingURL=mcp-stdout-channel.integration.test.js.map

package/dist/test/mcp-stdout-channel.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-stdout-channel.integration.test.js","sourceRoot":"","sources":["../../src/test/mcp-stdout-channel.integration.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;AAErC,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAC5C,sBAAsB,CACvB,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAE1C,mJAAmJ;AACnJ,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,SAAS,WAAW,CAAC,OAAgC;IACnD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QAClB,KAAK,CAAC,OAAO,KAAK,KAAK,CACxB,CAAC;AACJ,CAAC;AAED,EAAE,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;IAC5F,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAC/B,OAAO,CAAC,QAAQ,EAChB;QACE,UAAU;QACV,KAAK;QACL,MAAM;QACN,IAAI,CAAC,SAAS,CAAC;YACb,eAAe,EAAE,MAAM,aAAa,EAAE;YACtC,gBAAgB,EAAE,MAAM,aAAa,EAAE;YACvC,MAAM,EAAE,MAAM,iBAAiB,EAAE;YACjC,OAAO;SACR,CAAC;KACH,EACD,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CACpC,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,MAAM,MAAM,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,MAAM,GAAG,uCAAuC,CAAC;IACvD,IAAI,YAAY,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;IAC/C,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QAC3B,YAAY,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IACH,MAAM,sBAAsB,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CACJ,IAAI,KAAK,CACP,sEAAsE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,MAAM,EAAE,CACrH,CACF,CAAC;QACJ,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACxB,sIAAsI;QACtI,MAAM,gBAAgB,GAAG,GAAS,EAAE;YAClC,IACE,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC;gBAC3B,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC;gBAC3B,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EACvB,CAAC;gBACD,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QACF,YAAY,GAAG,gBAAgB,CAAC;QAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACpE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzC,IACE,OAAO,MAAM,KAAK,QAAQ;oBAC1B,MAAM,KAAK,IAAI;oBACf,IAAI,IAAI,MAAM;oBACd,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,EAC7B,CAAC;oBACD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2HAA2H;YAC7H,CAAC;YACD,gBAAgB,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,KAAK,CAAC,KAAK,CACf,WAAW,CAAC;QACV,EAAE,EAAE,aAAa;QACjB,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE;YACN,eAAe,EAAE,oBAAoB;YACrC,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,EAAE;SAC9D;KACF,CAAC,CACH,CAAC;IACF,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAC,CAAC;IACxE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,sBAAsB,CAAC;IAE7B,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-comms",
   "description": "Cross-harness communication mesh for LLM agents — rooms, DMs, presence, and real-time push delivery over TCP",
-  "version": "8.2.0",
+  "version": "8.3.0",
   "bin": {
     "agent-comms": "dist/cli.js"
   },