agent-comms 9.0.2 → 9.0.4

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-stdout-channel.integration.test.js","sourceRoot":"","sources":["../../src/test/mcp-stdout-channel.integration.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-stdout-channel.integration.test.js","sourceRoot":"","sources":["../../src/test/mcp-stdout-channel.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/test/version-report-actions.unit.test.d.ts

@@ -1,5 +1,5 @@
 /**
- * Unit tests for version-report-actions.ts's pure formatting/action helpers (agent-comms#198) -- exercised directly against fake stores rather than a real MeshStore, mirroring gateway-trust-actions.ts's own test style for the same reason: every one of these is a pure translation from whatever the store answers into either a CommsResult or a formatted line, with no mesh machinery of its own to set up.
+ * Unit tests for version-report-actions.ts's formatting helpers that read this process's own versions (agent-comms#198). The helpers that depend only on what a store answers are in the conformance corpus (conformance/function/version-report-actions.json); these stay because their expected text names the running package's and dependency's own version, which a language-neutral case cannot pin.
  */
 export {};
 //# sourceMappingURL=version-report-actions.unit.test.d.ts.map

package/dist/test/version-report-actions.unit.test.js

@@ -1,46 +1,10 @@
 /**
- * Unit tests for version-report-actions.ts's pure formatting/action helpers (agent-comms#198) -- exercised directly against fake stores rather than a real MeshStore, mirroring gateway-trust-actions.ts's own test style for the same reason: every one of these is a pure translation from whatever the store answers into either a CommsResult or a formatted line, with no mesh machinery of its own to set up.
+ * Unit tests for version-report-actions.ts's formatting helpers that read this process's own versions (agent-comms#198). The helpers that depend only on what a store answers are in the conformance corpus (conformance/function/version-report-actions.json); these stay because their expected text names the running package's and dependency's own version, which a language-neutral case cannot pin.
  */
 import { describe, it, expect } from "vitest";
-import { formatListedAgentVersions, formatSelfVersionLines, formatSelfVersionSuffix, handleQueryVersion, } from "../core/version-report-actions.js";
+import { formatListedAgentVersions, formatSelfVersionLines, formatSelfVersionSuffix, } from "../core/version-report-actions.js";
 import { getOwnPackageVersion } from "../core/package-version.js";
 import { getWireMeshCoreVersion } from "../core/wire-mesh-core-version.js";
-describe("handleQueryVersion", () => {
-    it("reports not-mesh-backed when the store has no queryVersion method", async () => {
-        const result = await handleQueryVersion({}, { action: "query_version", device: "abc123" });
-        expect(result.isError).toBe(true);
-        expect(result.content).toContain("requires a mesh-backed store");
-    });
-    it("reports the peer's live version on success", async () => {
-        const store = {
-            queryVersion: async (deviceId) => {
-                await Promise.resolve();
-                expect(deviceId).toBe("abc123");
-                return { version: "1.2.3" };
-            },
-        };
-        const result = await handleQueryVersion(store, {
-            action: "query_version",
-            device: "abc123",
-        });
-        expect(result.isError).toBe(false);
-        expect(result.content).toBe("abc123 is running wire-mesh-core 1.2.3.");
-    });
-    it("reports the store's own error on failure", async () => {
-        const store = {
-            queryVersion: async () => {
-                await Promise.resolve();
-                return { error: "unauthorized" };
-            },
-        };
-        const result = await handleQueryVersion(store, {
-            action: "query_version",
-            device: "abc123",
-        });
-        expect(result.isError).toBe(true);
-        expect(result.content).toBe("Failed to query abc123's version: unauthorized");
-    });
-});
 describe("formatSelfVersionLines / formatSelfVersionSuffix", () => {
     it("includes only the wire-mesh-core line when no cc-peer getter is wired", () => {
         expect(formatSelfVersionLines(undefined)).toEqual([
@@ -67,22 +31,5 @@ describe("formatListedAgentVersions", () => {
         const formatted = formatListedAgentVersions(store, "self-device", true, () => "9.9.9");
         expect(formatted).toBe(`agent-comms ${getOwnPackageVersion()}, wire-mesh-core ${getWireMeshCoreVersion()}, cc-peer 9.9.9`);
     });
-    it("reads gossiped versions for another peer, defaulting to unknown when never gossiped", () => {
-        const knownPeer = formatListedAgentVersions({
-            getPeerAgentCommsVersion: () => "3.0.0",
-            getPeerWireMeshCoreVersion: () => "1.50.0",
-        }, "peer-device", false, undefined);
-        expect(knownPeer).toBe("agent-comms 3.0.0, wire-mesh-core 1.50.0");
-        const unknownPeer = formatListedAgentVersions({}, "peer-device", false, undefined);
-        expect(unknownPeer).toBe("agent-comms unknown, wire-mesh-core unknown");
-    });
-    it("includes a peer's cc-peer version only when the store actually reports one", () => {
-        const formatted = formatListedAgentVersions({
-            getPeerAgentCommsVersion: () => "3.0.0",
-            getPeerWireMeshCoreVersion: () => "1.50.0",
-            getPeerCcPeerVersion: () => "1.5.0",
-        }, "peer-device", false, undefined);
-        expect(formatted).toBe("agent-comms 3.0.0, wire-mesh-core 1.50.0, cc-peer 1.5.0");
-    });
 });
 //# sourceMappingURL=version-report-actions.unit.test.js.map

package/dist/test/version-report-actions.unit.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"version-report-actions.unit.test.js","sourceRoot":"","sources":["../../src/test/version-report-actions.unit.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"version-report-actions.unit.test.js","sourceRoot":"","sources":["../../src/test/version-report-actions.unit.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,GAExB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,QAAQ,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAChE,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;YAChD,mBAAmB,sBAAsB,EAAE,EAAE;SAC9C,CAAC,CAAC;QACH,MAAM,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAC7C,kBAAkB,sBAAsB,EAAE,EAAE,CAC7C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,gBAAgB,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;QACvC,MAAM,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC;YACvD,mBAAmB,sBAAsB,EAAE,EAAE;YAC7C,gBAAgB;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CACpD,kBAAkB,sBAAsB,EAAE,gBAAgB,CAC3D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,uFAAuF,EAAE,GAAG,EAAE;QAC/F,MAAM,KAAK,GAAuB;YAChC,wBAAwB,EAAE,GAAG,EAAE,CAAC,oBAAoB;YACpD,0BAA0B,EAAE,GAAG,EAAE,CAAC,oBAAoB;YACtD,oBAAoB,EAAE,GAAG,EAAE,CAAC,oBAAoB;SACjD,CAAC;QACF,MAAM,SAAS,GAAG,yBAAyB,CACzC,KAAK,EACL,aAAa,EACb,IAAI,EACJ,GAAG,EAAE,CAAC,OAAO,CACd,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CACpB,eAAe,oBAAoB,EAAE,oBAAoB,sBAAsB,EAAE,iBAAiB,CACnG,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,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": "9.0.2",
+  "version": "9.0.4",
   "bin": {
     "agent-comms": "dist/cli.js"
   },
@@ -56,6 +56,7 @@
     "@types/react-dom": "19.3.0",
     "@types/ws": "8.18.1",
     "@vitejs/plugin-react": "6.1.1",
+    "ajv": "8.20.0",
     "conventional-changelog-conventionalcommits": "10.4.0",
     "eslint": "10.11.0",
     "eslint-config-prettier": "10.1.8",
@@ -74,7 +75,8 @@
     "typescript-eslint": "8.70.0",
     "vite": "8.3.2",
     "vite-plugin-pwa": "1.3.0",
-    "vitest": "5.0.0"
+    "vitest": "5.0.0",
+    "yaml": "2.9.1"
   },
   "exports": {
     ".": {

package/src/bridges/claude-code/channel.ts

@@ -278,7 +278,9 @@ export async function run(options?: Readonly<BridgeRunOptions>): Promise<void> {
   // -----------------------------------------------------------------------
 
   await store.init();
-  const webHandle = await tryStartBridgeWebServer(store, "claude-code");
+  const webHandle = await tryStartBridgeWebServer(store, "claude-code", {
+    bridgePortBase: options?.webPortBase,
+  });
   tool.getWebUrlStatus = () => getWebUrlStatus(webHandle);
   await mcp.connect(new StdioServerTransport());
 

package/src/bridges/codex/tool.ts

@@ -13,6 +13,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 
 import {
   createBridgeMesh,
+  type BridgeRunOptions,
   createMeshErrorReporter,
   buildAction,
   ensureRegistered,
@@ -36,7 +37,7 @@ function isRecord(value: unknown): value is Record<string, unknown> {
 /** Length of the random suffix appended to an auto-generated `codex-<suffix>` agent name. */
 const CODEX_AGENT_NAME_SUFFIX_LENGTH = 4;
 
-export async function run(): Promise<void> {
+export async function run(options?: Readonly<BridgeRunOptions>): Promise<void> {
   // Persistent identity for this slot: a stable device-id means the agent ID survives restarts, so peers can keep targeting us.
   const identitySlot: IdentitySlot = { harness: "codex", cwd: process.cwd() };
   const { store, tool } = await createBridgeMesh(identitySlot);
@@ -109,7 +110,9 @@ export async function run(): Promise<void> {
   // -----------------------------------------------------------------------
 
   await store.init();
-  const webHandle = await tryStartBridgeWebServer(store, "codex");
+  const webHandle = await tryStartBridgeWebServer(store, "codex", {
+    bridgePortBase: options?.webPortBase,
+  });
   tool.getWebUrlStatus = () => getWebUrlStatus(webHandle);
   await mcp.connect(new StdioServerTransport());
 

package/src/bridges/mcp/server.ts

@@ -114,7 +114,9 @@ export async function run(options?: Readonly<BridgeRunOptions>): Promise<void> {
   // -----------------------------------------------------------------------
 
   await store.init();
-  const webHandle = await tryStartBridgeWebServer(store, "mcp");
+  const webHandle = await tryStartBridgeWebServer(store, "mcp", {
+    bridgePortBase: options?.webPortBase,
+  });
   tool.getWebUrlStatus = () => getWebUrlStatus(webHandle);
   await mcp.connect(new StdioServerTransport());
 

package/src/bridges/user/web/bridge-port-range.ts

@@ -0,0 +1,130 @@
+/**
+ * The loopback TCP ports a bridge's web server looks for, and the dashboard looks in.
+ *
+ * A bridge binds the first free port of this range, so a hosted dashboard that cannot know a bridge's port finds it by trying each port in order. The range starts at the number the first-contact beacon uses over UDP, which is a separate port space: the two never contend.
+ *
+ * Shared by the Node server and the browser frontend, so it imports nothing from either.
+ */
+
+/** First port of the range a bridge's web server binds and the dashboard probes. */
+export const BRIDGE_PORT_BASE = 19877;
+
+/** How many consecutive ports, from the base, belong to the range. */
+export const BRIDGE_PORT_COUNT = 10;
+
+/** How long the probe waits for one port to accept the mesh socket before it counts as not a bridge: a listener that accepts and never answers must not stall the walk over the rest of the range. A bridge answers on loopback well inside this. */
+export const BRIDGE_PROBE_TIMEOUT_MS = 1000;
+
+/** The lowest port of the range an unprivileged process may bind. */
+export const LOWEST_UNPRIVILEGED_PORT = 1024;
+
+/** The highest TCP port. */
+export const HIGHEST_PORT = 65_535;
+
+/** Thrown for a base that is not a whole number or would put a port of the range outside 1024 to 65535. */
+export class InvalidBridgePortBaseError extends Error {
+  readonly base: number;
+
+  constructor(base: number) {
+    super(
+      `Bridge port base ${String(base)} is not an integer whose ${String(BRIDGE_PORT_COUNT)} ports all lie in ${String(LOWEST_UNPRIVILEGED_PORT)} to ${String(HIGHEST_PORT)}`,
+    );
+    this.name = "InvalidBridgePortBaseError";
+    this.base = base;
+  }
+}
+
+/**
+ * The ports of the range in the order both sides try them.
+ * @param base - The first port; defaults to {@link BRIDGE_PORT_BASE}. Tests pass a range of their own.
+ * @throws InvalidBridgePortBaseError when `base` is not an integer or a port of the range would fall outside 1024 to 65535.
+ */
+export function bridgePortRange(base: number = BRIDGE_PORT_BASE): number[] {
+  if (
+    !Number.isInteger(base) ||
+    base < LOWEST_UNPRIVILEGED_PORT ||
+    base + BRIDGE_PORT_COUNT - 1 > HIGHEST_PORT
+  ) {
+    throw new InvalidBridgePortBaseError(base);
+  }
+  return Array.from({ length: BRIDGE_PORT_COUNT }, (_, index) => base + index);
+}
+
+/** The address of a bridge's mesh socket on `port`. */
+export function bridgeMeshUrl(port: number): string {
+  return `ws://127.0.0.1:${String(port)}/ws/mesh`;
+}
+
+/**
+ * Whether a bridge's mesh socket (the dashboard's own endpoint, `/ws/mesh`) accepts a connection on the port within the timeout. Another kind of server, a refused port and a listener that never answers all give false: a WebSocket handshake needs a bridge to complete, and unlike a plain fetch it is readable from a hosted page without CORS headers.
+ * @param port - The loopback port to try.
+ * @param timeoutMs - How long to wait for the handshake; defaults to {@link BRIDGE_PROBE_TIMEOUT_MS}.
+ */
+export async function isBridgeAt(
+  port: number,
+  timeoutMs: number = BRIDGE_PROBE_TIMEOUT_MS,
+): Promise<boolean> {
+  return new Promise((resolve) => {
+    const socket = new WebSocket(bridgeMeshUrl(port));
+    const settle = (isBridge: boolean): void => {
+      socket.close();
+      resolve(isBridge);
+    };
+    AbortSignal.timeout(timeoutMs).addEventListener(
+      "abort",
+      () => {
+        settle(false);
+      },
+      { once: true },
+    );
+    socket.addEventListener(
+      "open",
+      () => {
+        settle(true);
+      },
+      { once: true },
+    );
+    socket.addEventListener(
+      "error",
+      () => {
+        settle(false);
+      },
+      { once: true },
+    );
+  });
+}
+
+/**
+ * The first port of the range that `isBridge` accepts, tried in range order, or undefined when none does.
+ * @param isBridge - Decides whether a bridge answers on a port.
+ * @param base - The first port of the range; defaults to {@link BRIDGE_PORT_BASE}.
+ */
+export async function findBridgePort(
+  isBridge: (port: number) => Promise<boolean>,
+  base: number = BRIDGE_PORT_BASE,
+): Promise<number | undefined> {
+  for (const port of bridgePortRange(base)) {
+    if (await isBridge(port)) return port;
+  }
+  return undefined;
+}
+
+/**
+ * Looks for a bridge in the range and, when one answers, passes its mesh socket address to `onFound`; calls nothing when none does. Resolves once the walk is over.
+ * @param onFound - Receives the mesh socket address of the first bridge found.
+ * @param options - `base` is the first port of the range (default {@link BRIDGE_PORT_BASE}); `timeoutMs` is the wait for each port (default {@link BRIDGE_PROBE_TIMEOUT_MS}).
+ */
+export async function probeForBridge(
+  onFound: (meshUrl: string) => void,
+  options?: Readonly<{
+    base?: number | undefined;
+    timeoutMs?: number | undefined;
+  }>,
+): Promise<void> {
+  const timeoutMs = options?.timeoutMs ?? BRIDGE_PROBE_TIMEOUT_MS;
+  const port = await findBridgePort(
+    async (candidate) => isBridgeAt(candidate, timeoutMs),
+    options?.base,
+  );
+  if (port !== undefined) onFound(bridgeMeshUrl(port));
+}