agent-comms 2.21.7 → 2.21.9

package/.claude-plugin/marketplace.json

@@ -15,7 +15,7 @@
         "url": "https://github.com/ExaDev/agent-comms.git"
       },
       "description": "Cross-harness LLM agent communication mesh — rooms, DMs, and presence",
-      "version": "2.21.7"
+      "version": "2.21.9"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-comms",
   "description": "Cross-harness LLM agent communication mesh — rooms, DMs, and presence",
-  "version": "2.21.7",
+  "version": "2.21.9",
   "author": {
     "name": "ExaDev"
   },

package/README.md

@@ -2,7 +2,7 @@
 
 [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://github.com/ExaDev/agent-comms)
 [![npm](https://img.shields.io/badge/npm-CB3837?logo=npm&logoColor=white)](https://www.npmjs.com/package/agent-comms)
-[![version](https://img.shields.io/badge/version-2.21.7-blue)](https://github.com/ExaDev/agent-comms/releases/tag/v2.21.7)
+[![version](https://img.shields.io/badge/version-2.21.9-blue)](https://github.com/ExaDev/agent-comms/releases/tag/v2.21.9)
 [![CI](https://img.shields.io/github/actions/workflow/status/ExaDev/agent-comms/ci.yml?branch=main)](https://github.com/ExaDev/agent-comms/actions)
 
 Cross-harness communication mesh for LLM agents: rooms, DMs, presence, and visibility over TCP with zero filesystem dependencies.

package/dist/test/mesh-store-shared.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mesh-store-shared.test.d.ts.map

package/dist/test/mesh-store-shared.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-store-shared.test.d.ts","sourceRoot":"","sources":["../../src/test/mesh-store-shared.test.ts"],"names":[],"mappings":""}

package/dist/test/mesh-store-shared.test.js

@@ -0,0 +1,89 @@
+import { describe, expect, it } from "vitest";
+import { mergeMessageHistories, ROOM_TOKEN_LIFETIME_MS, } from "../core/mesh-store-shared.js";
+const DAYS = 30;
+const HOURS_PER_DAY = 24;
+const MINUTES_PER_HOUR = 60;
+const SECONDS_PER_MINUTE = 60;
+const MS_PER_SECOND = 1000;
+describe("ROOM_TOKEN_LIFETIME_MS", () => {
+    it("is exactly 30 days, in milliseconds", () => {
+        expect(ROOM_TOKEN_LIFETIME_MS).toBe(DAYS *
+            HOURS_PER_DAY *
+            MINUTES_PER_HOUR *
+            SECONDS_PER_MINUTE *
+            MS_PER_SECOND);
+    });
+});
+function msg(id, readBy = []) {
+    return { id, readBy: [...readBy] };
+}
+describe("mergeMessageHistories", () => {
+    it("appends an incoming entry the local list does not have", () => {
+        const merged = mergeMessageHistories([msg("a")], [msg("b")]);
+        expect(merged.map((m) => m.id)).toEqual(["a", "b"]);
+    });
+    it("appends multiple new entries in incoming order", () => {
+        const merged = mergeMessageHistories([msg("a")], [msg("b"), msg("c")]);
+        expect(merged.map((m) => m.id)).toEqual(["a", "b", "c"]);
+    });
+    it("preserves local ordering -- new entries are appended, not inserted", () => {
+        const merged = mergeMessageHistories([msg("a"), msg("z")], [msg("m")]);
+        expect(merged.map((m) => m.id)).toEqual(["a", "z", "m"]);
+    });
+    it("unions a new reader onto an existing entry's readBy", () => {
+        const merged = mergeMessageHistories([msg("a", ["u1"])], [msg("a", ["u2"])]);
+        expect(merged[0]?.readBy.sort()).toEqual(["u1", "u2"]);
+    });
+    it("does not duplicate a reader already present locally", () => {
+        const merged = mergeMessageHistories([msg("a", ["u1"])], [msg("a", ["u1"])]);
+        expect(merged[0]?.readBy).toEqual(["u1"]);
+    });
+    it("unions several readers from one incoming entry", () => {
+        const merged = mergeMessageHistories([msg("a", ["u1"])], [msg("a", ["u1", "u2", "u3"])]);
+        expect(merged[0]?.readBy.sort()).toEqual(["u1", "u2", "u3"]);
+    });
+    it("leaves an existing entry's readBy untouched when incoming has none", () => {
+        const merged = mergeMessageHistories([msg("a", ["u1"])], [msg("a", [])]);
+        expect(merged[0]?.readBy).toEqual(["u1"]);
+    });
+    it("does not grow the merged length for an already-known entry", () => {
+        const merged = mergeMessageHistories([msg("a")], [msg("a")]);
+        expect(merged).toHaveLength(1);
+    });
+    it("handles an empty incoming list as a no-op, returning an equivalent copy", () => {
+        const merged = mergeMessageHistories([msg("a", ["u1"])], []);
+        expect(merged).toEqual([msg("a", ["u1"])]);
+    });
+    it("handles an empty local list, returning everything incoming", () => {
+        const merged = mergeMessageHistories([], [msg("a"), msg("b")]);
+        expect(merged.map((m) => m.id)).toEqual(["a", "b"]);
+    });
+    it("merges a mix of new and existing entries in one call", () => {
+        const merged = mergeMessageHistories([msg("a", ["u1"]), msg("b", [])], [msg("a", ["u2"]), msg("c", ["u3"])]);
+        expect(merged.map((m) => m.id)).toEqual(["a", "b", "c"]);
+        expect(merged[0]?.readBy.sort()).toEqual(["u1", "u2"]);
+        expect(merged[1]?.readBy).toEqual([]);
+        expect(merged[2]?.readBy).toEqual(["u3"]);
+    });
+    it("does not mutate either input array", () => {
+        const local = [msg("a", ["u1"])];
+        const incoming = [msg("a", ["u2"]), msg("b")];
+        mergeMessageHistories(local, incoming);
+        expect(local).toEqual([msg("a", ["u1"])]);
+        expect(incoming).toEqual([msg("a", ["u2"]), msg("b")]);
+    });
+    it("does not mutate an existing local entry's own readBy array in place", () => {
+        const originalEntry = msg("a", ["u1"]);
+        const local = [originalEntry];
+        mergeMessageHistories(local, [msg("a", ["u2"])]);
+        // The merged result's entry for "a" must be a distinct object/array from the one still referenced by the caller's own original local list -- otherwise a caller holding onto its own pre-merge array would see readers silently appear in it too.
+        expect(originalEntry.readBy).toEqual(["u1"]);
+    });
+    it("unions two same-id entries within one incoming batch into a single merged entry, not a duplicate", () => {
+        // A brand-new id appearing twice in the same incoming batch is the one case where the freshly-added entry must be looked up again within the same call, not just against local's own pre-existing entries -- proves the id-to-entry index is kept in sync as new entries are added mid-merge, not only seeded from local up front.
+        const merged = mergeMessageHistories([], [msg("a", ["u1"]), msg("a", ["u2"])]);
+        expect(merged.map((m) => m.id)).toEqual(["a"]);
+        expect(merged[0]?.readBy.sort()).toEqual(["u1", "u2"]);
+    });
+});
+//# sourceMappingURL=mesh-store-shared.test.js.map

package/dist/test/mesh-store-shared.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-store-shared.test.js","sourceRoot":"","sources":["../../src/test/mesh-store-shared.test.ts"],"names":[],"mappings":"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"}

package/dist/test/stale-agent-checker.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stale-agent-checker.test.d.ts.map

package/dist/test/stale-agent-checker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-agent-checker.test.d.ts","sourceRoot":"","sources":["../../src/test/stale-agent-checker.test.ts"],"names":[],"mappings":""}

package/dist/test/stale-agent-checker.test.js

@@ -0,0 +1,262 @@
+/**
+ * Two mutants Stryker raises against stale-agent-checker.ts are true equivalents, not gaps -- documented here rather than chased with a contrived test, per this repo's own "provably equivalent gets reasoning, not a forced test" convention:
+ *
+ * - `agents.set(id, agent)` right after `agent.status = "offline"` in the dead-process branch: `agent` is the exact same object reference `agents.get(id)` already returned, so mutating `.status` on it already mutates what the Map holds. Re-`.set()`-ing the same key to the same reference is a genuine no-op; no test can observe removing that call.
+ * - The purge loop's `purgeIds: string[] = []` seeded with an extra bogus id: `Map.delete()`/nothing on a key that was never present is itself a silent no-op by JS Map semantics, so a spurious extra entry in the purge list has zero observable effect on any of the four maps it's applied to, regardless of what else the test asserts.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { StaleAgentChecker, } from "../core/stale-agent-checker.js";
+const PROBE_INTERVAL_MS = 5000;
+const OFFLINE_PURGE_THRESHOLD_MINUTES = 30;
+const SECONDS_PER_MINUTE = 60;
+const MS_PER_SECOND = 1000;
+const OFFLINE_PURGE_THRESHOLD_MS = OFFLINE_PURGE_THRESHOLD_MINUTES * SECONDS_PER_MINUTE * MS_PER_SECOND;
+/** How many probe intervals stop() must survive with zero further probing -- arbitrary beyond "more than one", chosen to make a lingering timer's own recurrence visible rather than a one-off fluke. */
+const HALT_CHECK_INTERVAL_COUNT = 3;
+/** How many purge thresholds old an agent's startedAt is in the "no matter how old" test -- arbitrary beyond "well past the threshold", chosen to make the point emphatically rather than sit right at the boundary (which the dedicated boundary test already covers precisely). */
+const FAR_PAST_THRESHOLD_MULTIPLIER = 10;
+const ALIVE_PID = 111;
+const DEAD_PID = 222;
+const FIXED_NOW_MS = 1_700_000_000_000;
+// vi.advanceTimersByTimeAsync advances the mocked Date along with fake timers, so by the time a probe actually runs, Date.now() is FIXED_NOW_MS + however far the clock was advanced to fire it -- ages are computed relative to that real evaluation instant, not the clock's initial value, so a boundary test lands exactly where it claims to.
+const PROBE_TIME_MS = FIXED_NOW_MS + PROBE_INTERVAL_MS;
+function agent(id, status, pid, startedAt) {
+    return {
+        id,
+        version: 1,
+        name: id,
+        harness: "pi",
+        cwd: "/tmp",
+        pid,
+        startedAt,
+        visibility: "visible",
+        status,
+        tags: [],
+        subscribedRooms: [],
+    };
+}
+function isoAgeMs(ageMs) {
+    return new Date(PROBE_TIME_MS - ageMs).toISOString();
+}
+function harness(agents) {
+    const agentsMap = new Map(agents.map((a) => [a.id, a]));
+    const deliveryQueues = new Map();
+    const identityCache = new Map();
+    const peerInfo = new Map();
+    for (const a of agents) {
+        deliveryQueues.set(a.id, []);
+        identityCache.set(a.id, { id: a.id });
+        peerInfo.set(a.id, { id: a.id, port: 1, startedAt: a.startedAt });
+    }
+    const notifyRoomsOfStatus = vi.fn(async () => Promise.resolve());
+    const broadcastPatch = vi.fn(async () => Promise.resolve());
+    const deps = {
+        agents: agentsMap,
+        deliveryQueues: deliveryQueues,
+        identityCache,
+        peerInfo,
+        notifyRoomsOfStatus,
+        broadcastPatch: broadcastPatch,
+    };
+    return {
+        deps,
+        checker: new StaleAgentChecker(deps),
+        notifyRoomsOfStatus,
+        broadcastPatch,
+    };
+}
+describe("StaleAgentChecker", () => {
+    let killSpy;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(FIXED_NOW_MS);
+        killSpy = vi
+            .spyOn(process, "kill")
+            .mockImplementation((pid) => {
+            if (pid === ALIVE_PID)
+                return true;
+            throw new Error("ESRCH");
+        });
+    });
+    afterEach(() => {
+        killSpy.mockRestore();
+        vi.useRealTimers();
+    });
+    describe("start/stop", () => {
+        it("does nothing until start() is called", async () => {
+            const { checker, broadcastPatch } = harness([
+                agent("a1", "active", DEAD_PID, isoAgeMs(0)),
+            ]);
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS * 2);
+            expect(broadcastPatch).not.toHaveBeenCalled();
+            checker.stop();
+        });
+        it("probes on the configured interval once started", async () => {
+            const { checker, broadcastPatch } = harness([
+                agent("a1", "active", DEAD_PID, isoAgeMs(0)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            expect(broadcastPatch).toHaveBeenCalledTimes(1);
+            checker.stop();
+        });
+        it("calling start() twice does not create a second timer", () => {
+            // broadcastPatch call counts can't distinguish this: probeStaleAgents mutates an agent's status to "offline" synchronously, before its own first await, so a second un-guarded timer firing in the same tick finds nothing left to mark dead even when a real (leaked) second interval exists underneath -- asserting directly on setInterval's own call count is what the guard in start() actually exists to control.
+            const setIntervalSpy = vi.spyOn(globalThis, "setInterval");
+            const { checker } = harness([]);
+            checker.start();
+            checker.start();
+            expect(setIntervalSpy).toHaveBeenCalledTimes(1);
+            checker.stop();
+        });
+        it("stop() clears the timer start() created", () => {
+            const clearIntervalSpy = vi.spyOn(globalThis, "clearInterval");
+            const { checker } = harness([]);
+            checker.start();
+            checker.stop();
+            expect(clearIntervalSpy).toHaveBeenCalledTimes(1);
+        });
+        it("stop() halts further probing", async () => {
+            const { checker, broadcastPatch } = harness([
+                agent("a1", "active", DEAD_PID, isoAgeMs(0)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            broadcastPatch.mockClear();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS * HALT_CHECK_INTERVAL_COUNT);
+            expect(broadcastPatch).not.toHaveBeenCalled();
+        });
+        it("stop() before start() is a safe no-op that never calls clearInterval", () => {
+            const clearIntervalSpy = vi.spyOn(globalThis, "clearInterval");
+            const { checker } = harness([]);
+            expect(() => {
+                checker.stop();
+            }).not.toThrow();
+            expect(clearIntervalSpy).not.toHaveBeenCalled();
+        });
+    });
+    describe("dead-process detection", () => {
+        it("marks an active agent with a dead pid offline, notifies, broadcasts, and drops its peer info", async () => {
+            const { deps, checker, notifyRoomsOfStatus, broadcastPatch } = harness([
+                agent("a1", "active", DEAD_PID, isoAgeMs(0)),
+            ]);
+            deps.peerInfo.set("a1", { id: "a1", port: 42, startedAt: isoAgeMs(0) });
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            expect(deps.agents.get("a1")?.status).toBe("offline");
+            expect(notifyRoomsOfStatus).toHaveBeenCalledWith("a1", "offline");
+            expect(broadcastPatch).toHaveBeenCalledWith({
+                type: "agent_offline",
+                agentId: "a1",
+            });
+            expect(deps.peerInfo.has("a1")).toBe(false);
+        });
+        it("leaves an active agent with a live pid untouched", async () => {
+            const { deps, checker, notifyRoomsOfStatus, broadcastPatch } = harness([
+                agent("a1", "active", ALIVE_PID, isoAgeMs(0)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            expect(deps.agents.get("a1")?.status).toBe("active");
+            expect(notifyRoomsOfStatus).not.toHaveBeenCalled();
+            expect(broadcastPatch).not.toHaveBeenCalled();
+            expect(deps.peerInfo.has("a1")).toBe(true);
+        });
+        it("does not re-probe an agent that is already offline, even with a dead pid", async () => {
+            const { deps, checker, notifyRoomsOfStatus } = harness([
+                agent("a1", "offline", DEAD_PID, isoAgeMs(0)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            // Only the "status !== active" guard is exercised here -- the purge threshold (30 min) is far beyond isoAgeMs(0), so this agent is untouched by both code paths.
+            expect(deps.agents.get("a1")?.status).toBe("offline");
+            expect(notifyRoomsOfStatus).not.toHaveBeenCalled();
+        });
+        it("marks every dead active agent offline in a single probe pass", async () => {
+            const { deps, checker, broadcastPatch } = harness([
+                agent("a1", "active", DEAD_PID, isoAgeMs(0)),
+                agent("a2", "active", DEAD_PID, isoAgeMs(0)),
+                agent("a3", "active", ALIVE_PID, isoAgeMs(0)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            expect(deps.agents.get("a1")?.status).toBe("offline");
+            expect(deps.agents.get("a2")?.status).toBe("offline");
+            expect(deps.agents.get("a3")?.status).toBe("active");
+            expect(broadcastPatch).toHaveBeenCalledTimes(2);
+        });
+    });
+    describe("offline-agent purging", () => {
+        it("purges an agent offline for longer than the threshold, from every map, and nothing else", async () => {
+            const { deps, checker } = harness([
+                agent("a1", "offline", DEAD_PID, isoAgeMs(OFFLINE_PURGE_THRESHOLD_MS + 1)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            expect(deps.agents.has("a1")).toBe(false);
+            expect(deps.peerInfo.has("a1")).toBe(false);
+            expect(deps.identityCache.has("a1")).toBe(false);
+            expect(deps.deliveryQueues.has("a1")).toBe(false);
+            expect(deps.agents.size).toBe(0);
+            expect(deps.peerInfo.size).toBe(0);
+            expect(deps.identityCache.size).toBe(0);
+            expect(deps.deliveryQueues.size).toBe(0);
+        });
+        it("does not purge an offline agent still within the threshold", async () => {
+            const { deps, checker } = harness([
+                agent("a1", "offline", DEAD_PID, isoAgeMs(OFFLINE_PURGE_THRESHOLD_MS - 1)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            expect(deps.agents.has("a1")).toBe(true);
+        });
+        it("does not purge an offline agent exactly at the threshold (the comparison is strict-less-than, not less-or-equal)", async () => {
+            const { deps, checker } = harness([
+                agent("a1", "offline", DEAD_PID, isoAgeMs(OFFLINE_PURGE_THRESHOLD_MS)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            expect(deps.agents.has("a1")).toBe(true);
+        });
+        it("does not purge a non-offline agent no matter how old its startedAt is", async () => {
+            const { deps, checker } = harness([
+                agent("a1", "active", ALIVE_PID, isoAgeMs(OFFLINE_PURGE_THRESHOLD_MS * FAR_PAST_THRESHOLD_MULTIPLIER)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            expect(deps.agents.has("a1")).toBe(true);
+        });
+        it("purges every long-offline agent while leaving a recent one alone, in the same pass", async () => {
+            const { deps, checker } = harness([
+                agent("old", "offline", DEAD_PID, isoAgeMs(OFFLINE_PURGE_THRESHOLD_MS + 1)),
+                agent("recent", "offline", DEAD_PID, isoAgeMs(OFFLINE_PURGE_THRESHOLD_MS - 1)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            expect(deps.agents.has("old")).toBe(false);
+            expect(deps.agents.has("recent")).toBe(true);
+        });
+        it("both marks a newly-dead agent offline and purges an already-long-offline one in the same probe", async () => {
+            const { deps, checker } = harness([
+                agent("newlyDead", "active", DEAD_PID, isoAgeMs(0)),
+                agent("longOffline", "offline", DEAD_PID, isoAgeMs(OFFLINE_PURGE_THRESHOLD_MS + 1)),
+            ]);
+            checker.start();
+            await vi.advanceTimersByTimeAsync(PROBE_INTERVAL_MS);
+            checker.stop();
+            expect(deps.agents.get("newlyDead")?.status).toBe("offline");
+            expect(deps.agents.has("longOffline")).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=stale-agent-checker.test.js.map

package/dist/test/stale-agent-checker.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-agent-checker.test.js","sourceRoot":"","sources":["../../src/test/stale-agent-checker.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-comms",
-  "version": "2.21.7",
+  "version": "2.21.9",
   "description": "Cross-harness communication mesh for LLM agents — rooms, DMs, presence, and real-time push delivery over TCP",
   "type": "module",
   "packageManager": "pnpm@12.4.1+sha512.2e81e399d73fe8390dab25e06aa788ab7a5908248d2f5a370f82b481147a6a7a367bf8048f9a6fdb6460f21a66f0542dedb8b94ca2c8723596741920b1656d4c",