agent-comms 7.0.0 → 8.0.0

package/dist/test/mesh-store-delivery-listeners.integration.test.js

@@ -0,0 +1,160 @@
+/**
+ * MeshStore.addDeliveryListener and addPatchListener (agent-comms#293): several parties share one store's delivery events and state patches, a bridge's own onDelivery handler and the web UI it serves, so serving the UI does not need a second store and neither party can silence the other by assigning last.
+ */
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { MeshStore } from "../core/mesh-store.js";
+import { freeLocalPort, TeardownStack } from "./hub-helpers.js";
+import { wireTestTransport } from "./test-transport.js";
+const cleanups = new TeardownStack();
+afterEach(async () => {
+    await cleanups.run();
+});
+async function startStore() {
+    const store = new MeshStore({ coordinatorPort: await freeLocalPort() });
+    await wireTestTransport(store);
+    await store.init();
+    cleanups.push(async () => store.shutdown());
+    await store.registerAgent({
+        name: "listener-test",
+        harness: "test",
+        cwd: "/test/listeners",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    return store;
+}
+let nextMessage = 0;
+/** A room message that is new to the store every time, so the delivery engine's own de-duplication never swallows it. */
+function freshEvent() {
+    nextMessage += 1;
+    return {
+        type: "room_message",
+        message: {
+            id: `message-${String(nextMessage)}`,
+            from: "someone",
+            room: "room",
+            content: `hello ${String(nextMessage)}`,
+            timestamp: "2026-01-01T00:00:00.000Z",
+            readBy: [],
+        },
+    };
+}
+describe("MeshStore.addDeliveryListener", () => {
+    it("gives an event to onDelivery and to every listener", async () => {
+        const store = await startStore();
+        const handler = vi.fn();
+        const first = vi.fn();
+        const second = vi.fn();
+        store.onDelivery = handler;
+        store.addDeliveryListener(first);
+        store.addDeliveryListener(second);
+        const event = freshEvent();
+        await store.deliver(store.peerId, event);
+        expect(handler).toHaveBeenCalledWith(store.peerId, event);
+        expect(first).toHaveBeenCalledWith(store.peerId, event);
+        expect(second).toHaveBeenCalledWith(store.peerId, event);
+    });
+    it("does not let assigning onDelivery silence a listener, or adding a listener replace onDelivery", async () => {
+        const store = await startStore();
+        const listener = vi.fn();
+        const laterHandler = vi.fn();
+        store.addDeliveryListener(listener);
+        store.onDelivery = laterHandler;
+        await store.deliver(store.peerId, freshEvent());
+        expect(listener).toHaveBeenCalledTimes(1);
+        expect(laterHandler).toHaveBeenCalledTimes(1);
+    });
+    it("delivers to a listener on its own when onDelivery was never set", async () => {
+        const store = await startStore();
+        const listener = vi.fn();
+        store.addDeliveryListener(listener);
+        await store.deliver(store.peerId, freshEvent());
+        expect(listener).toHaveBeenCalledTimes(1);
+    });
+    it("stops giving events to a listener once it unsubscribes", async () => {
+        const store = await startStore();
+        const listener = vi.fn();
+        const unsubscribe = store.addDeliveryListener(listener);
+        await store.deliver(store.peerId, freshEvent());
+        unsubscribe();
+        await store.deliver(store.peerId, freshEvent());
+        expect(listener).toHaveBeenCalledTimes(1);
+    });
+    it("reports a listener that throws or rejects through onError and still calls the others", async () => {
+        const store = await startStore();
+        const errors = [];
+        store.onError = (error) => {
+            errors.push(error);
+        };
+        const failure = new Error("listener failed");
+        const healthy = vi.fn();
+        store.addDeliveryListener(() => {
+            throw failure;
+        });
+        store.addDeliveryListener(async () => Promise.reject(failure));
+        store.addDeliveryListener(healthy);
+        await store.deliver(store.peerId, freshEvent());
+        await vi.waitFor(() => {
+            expect(errors).toHaveLength(2);
+        });
+        expect(errors).toEqual([failure, failure]);
+        expect(healthy).toHaveBeenCalledTimes(1);
+    });
+});
+describe("MeshStore.addPatchListener", () => {
+    /** Registers an agent, which produces at least one state patch on this store. */
+    async function produceAPatch(store, name) {
+        await store.registerAgent({
+            name,
+            harness: "test",
+            cwd: `/test/${name}`,
+            pid: process.pid,
+            visibility: "visible",
+            tags: [],
+        });
+    }
+    it("gives a patch to onPatch and to every listener", async () => {
+        const store = await startStore();
+        const handler = vi.fn();
+        const listener = vi.fn();
+        store.onPatch = handler;
+        store.addPatchListener(listener);
+        await produceAPatch(store, "patch-source");
+        expect(handler).toHaveBeenCalled();
+        expect(listener).toHaveBeenCalled();
+    });
+    it("delivers to a listener on its own when onPatch was never set, and does not let assigning onPatch silence it", async () => {
+        const store = await startStore();
+        const listener = vi.fn();
+        store.addPatchListener(listener);
+        store.onPatch = vi.fn();
+        await produceAPatch(store, "patch-source");
+        expect(listener).toHaveBeenCalled();
+    });
+    it("stops giving patches to a listener once it unsubscribes", async () => {
+        const store = await startStore();
+        const listener = vi.fn();
+        const unsubscribe = store.addPatchListener(listener);
+        unsubscribe();
+        await produceAPatch(store, "patch-source");
+        expect(listener).not.toHaveBeenCalled();
+    });
+    it("reports a listener that throws through onError and still calls the others", async () => {
+        const store = await startStore();
+        const errors = [];
+        store.onError = (error) => {
+            errors.push(error);
+        };
+        const failure = new Error("patch listener failed");
+        const healthy = vi.fn();
+        store.addPatchListener(() => {
+            throw failure;
+        });
+        store.addPatchListener(healthy);
+        await produceAPatch(store, "patch-source");
+        expect(errors).toContain(failure);
+        expect(healthy).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=mesh-store-delivery-listeners.integration.test.js.map

package/dist/test/mesh-store-delivery-listeners.integration.test.js.map

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

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": "7.0.0",
+  "version": "8.0.0",
   "bin": {
     "agent-comms": "dist/cli.js"
   },