agent-comms 1.25.4 → 1.25.6

package/dist/test/downtime-replay.integration.test.js

@@ -0,0 +1,113 @@
+/**
+ * Integration test for issue #28: a bridge restarted with a persisted identity must be push-delivered the events that accumulated while its process was down, not just find them in synced history.
+ *
+ * Peer B goes away; A sends a room message while B is down; B restarts in the same identity slot and must fire onDelivery for the missed message.
+ */
+import * as assert from "node:assert/strict";
+import * as fs from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { MeshStore } from "../core/mesh-store.js";
+import { TlsTransport } from "../core/tls-transport.js";
+import { generateIdentity } from "../core/identity.js";
+import { loadOrCreateIdentity, releaseIdentityLock, } from "../core/identity-store.js";
+const TEST_PORT = 19896;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/** A peer wired like a real bridge: TLS transport, fingerprint peer ID. */
+function makePeer(identity) {
+    const store = new MeshStore(TEST_PORT);
+    store.peerId = identity.fingerprint;
+    store.setTransport(new TlsTransport(store.events, identity));
+    const deliveries = [];
+    return { store, deliveries };
+}
+/** Poll until the predicate holds, or fail with the message. */
+async function waitFor(what, check) {
+    for (let i = 0; i < 20; i++) {
+        if (await check())
+            return;
+        await sleep(100);
+    }
+    assert.ok(false, `timed out waiting for ${what}`);
+}
+async function main() {
+    const dir = fs.mkdtempSync(path.join(tmpdir(), "agent-comms-downtime-"));
+    const slot = { harness: "pi", cwd: "/tmp/project", dir };
+    // A is a normal ephemeral bridge that stays up throughout.
+    const a = makePeer(generateIdentity());
+    await a.store.init();
+    await a.store.registerAgent({
+        name: "peer-a",
+        harness: "claude-code",
+        cwd: "/tmp/a",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    await a.store.createRoom({
+        name: "downtime",
+        type: "public",
+        owner: a.store.peerId,
+        description: "issue 28 acceptance",
+    });
+    await sleep(200);
+    // B joins with a persisted identity and becomes a room member.
+    const identityB = loadOrCreateIdentity(slot);
+    const b1 = makePeer(identityB);
+    await b1.store.init();
+    // Registration must wait for the TLS data connections to establish (#23).
+    await sleep(300);
+    await b1.store.registerAgent({
+        name: "peer-b",
+        harness: "pi",
+        cwd: "/tmp/project",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    await waitFor("the room to reach the joiner", async () => {
+        const rooms = await b1.store.listRooms(b1.store.peerId);
+        return rooms.some((room) => room.id === "downtime");
+    });
+    await b1.store.joinRoom("downtime", b1.store.peerId);
+    await waitFor("membership to reach the sender", async () => {
+        const room = await a.store.getRoom("downtime");
+        return room?.members.includes(b1.store.peerId) === true;
+    });
+    // B goes down.
+    await b1.store.shutdown();
+    await sleep(200);
+    // A sends a room message while B is down.
+    await a.store.sendRoomMessage("downtime", a.store.peerId, "while you were down");
+    await sleep(200);
+    // B restarts in the same slot: same identity, same agent ID.
+    const identityB2 = loadOrCreateIdentity(slot);
+    assert.equal(identityB2.fingerprint, identityB.fingerprint);
+    const b2 = makePeer(identityB2);
+    b2.store.onDelivery = (_id, ev) => {
+        b2.deliveries.push(ev);
+    };
+    await b2.store.init();
+    await b2.store.registerAgent({
+        name: "peer-b",
+        harness: "pi",
+        cwd: "/tmp/project",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    // The message sent during downtime must push to the restarted bridge.
+    await waitFor("the downtime message to push to the restarted bridge", async () => b2.deliveries.some((ev) => ev.type === "room_message" &&
+        ev.message.content === "while you were down"));
+    await b2.store.shutdown();
+    await a.store.shutdown();
+    releaseIdentityLock(slot);
+    console.log("✓ downtime messages push-deliver on restart");
+}
+main().catch((err) => {
+    console.error("Test failed:", err);
+    process.exitCode = 1;
+    // The sequence above keeps mesh handles open when it fails partway; exit explicitly so a failure cannot hang the runner.
+    process.exit(1);
+});
+//# sourceMappingURL=downtime-replay.integration.test.js.map

package/dist/test/downtime-replay.integration.test.js.map

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

package/dist/test/downtime-replay.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for downtime delivery replay (#28): events that accumulated in peers' delivery queues while a target's process was down fire onDelivery when the target applies its first snapshot, without transport involvement.
+ */
+export {};
+//# sourceMappingURL=downtime-replay.test.d.ts.map

package/dist/test/downtime-replay.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downtime-replay.test.d.ts","sourceRoot":"","sources":["../../src/test/downtime-replay.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/test/downtime-replay.test.js

@@ -0,0 +1,100 @@
+/**
+ * Unit tests for downtime delivery replay (#28): events that accumulated in peers' delivery queues while a target's process was down fire onDelivery when the target applies its first snapshot, without transport involvement.
+ */
+import * as assert from "node:assert/strict";
+import { test } from "node:test";
+import { MeshStore } from "../core/mesh-store.js";
+/** A wire-accurate snapshot: production always applies parsed (cloned) state. */
+function snapshotOf(store) {
+    return structuredClone(store.serialise());
+}
+/** A local-only store: no transport start, so no ports and no flake. */
+function makeStore() {
+    return new MeshStore();
+}
+void test("events queued while the target was down replay on its first snapshot", async () => {
+    const sender = makeStore();
+    const author = await sender.registerAgent({
+        name: "author",
+        harness: "pi",
+        cwd: "/tmp/p",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    // The target exists on the mesh (known to the sender) but its process is "down": modelled by only ever syncing snapshots into a future store.
+    const target = makeStore();
+    const targetAgent = await target.registerAgent({
+        name: "target",
+        harness: "claude-code",
+        cwd: "/tmp/t",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    // Make the sender aware of the target, then take the target's store away.
+    sender.applyStateSync(target.serialise());
+    await sender.createRoom({
+        name: "room",
+        type: "public",
+        owner: author.id,
+        description: "x",
+    });
+    await sender.joinRoom("room", targetAgent.id);
+    // While the target is down, a room message is sent to it.
+    await sender.sendRoomMessage("room", author.id, "while you were away");
+    const pending = snapshotOf(sender).deliveryQueues[targetAgent.id];
+    assert.ok(pending !== undefined && pending.length > 0);
+    // The target returns (fresh process, same agent id) and receives the sender's snapshot: the pending event must fire onDelivery.
+    const returned = makeStore();
+    const deliveries = [];
+    returned.onDelivery = (_id, ev) => {
+        deliveries.push(ev);
+    };
+    returned.peerId = targetAgent.id;
+    returned.applyStateSync(snapshotOf(sender));
+    assert.equal(deliveries.some((ev) => ev.type === "room_message" &&
+        ev.message.content === "while you were away"), true);
+    // A second snapshot of the same state does not duplicate any push (the
+    // join notification replays too, exactly once).
+    returned.applyStateSync(snapshotOf(sender));
+    assert.equal(deliveries.filter((ev) => ev.type === "room_message" &&
+        ev.message.content === "while you were away").length, 1);
+    assert.equal(deliveries.filter((ev) => ev.type === "room_members").length, 1);
+});
+void test("a queue is bounded oldest-first so downtime cannot grow it without limit", async () => {
+    const sender = makeStore();
+    const author = await sender.registerAgent({
+        name: "author",
+        harness: "pi",
+        cwd: "/tmp/p",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    const target = makeStore();
+    const targetAgent = await target.registerAgent({
+        name: "target",
+        harness: "claude-code",
+        cwd: "/tmp/t",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    sender.applyStateSync(target.serialise());
+    await sender.createRoom({
+        name: "room",
+        type: "public",
+        owner: author.id,
+        description: "x",
+    });
+    await sender.joinRoom("room", targetAgent.id);
+    for (let i = 0; i < 120; i++) {
+        await sender.sendRoomMessage("room", author.id, `msg-${String(i)}`);
+    }
+    const queued = snapshotOf(sender).deliveryQueues[targetAgent.id] ?? [];
+    assert.equal(queued.length, 100);
+    assert.equal(queued[0]?.type === "room_message" &&
+        queued[0].message.content === "msg-20", true);
+});
+//# sourceMappingURL=downtime-replay.test.js.map

package/dist/test/downtime-replay.test.js.map

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

package/dist/test/state-sync-convergence.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for state_sync convergence (#27): entities that changed while a peer held a stale copy must converge on the fresher revision, in both directions — a stale holder heals when it receives a fresher snapshot, and a current holder rejects a stale snapshot instead of regressing.
+ *
+ * Also covers the append-only history merge: unseen messages are added and read receipts are unioned. These tests exercise the merge seam directly (no transport): the stores never connect, snapshots are exchanged through serialise() / applyStateSync().
+ */
+export {};
+//# sourceMappingURL=state-sync-convergence.test.d.ts.map

package/dist/test/state-sync-convergence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-sync-convergence.test.d.ts","sourceRoot":"","sources":["../../src/test/state-sync-convergence.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/test/state-sync-convergence.test.js

@@ -0,0 +1,140 @@
+/**
+ * Unit tests for state_sync convergence (#27): entities that changed while a peer held a stale copy must converge on the fresher revision, in both directions — a stale holder heals when it receives a fresher snapshot, and a current holder rejects a stale snapshot instead of regressing.
+ *
+ * Also covers the append-only history merge: unseen messages are added and read receipts are unioned. These tests exercise the merge seam directly (no transport): the stores never connect, snapshots are exchanged through serialise() / applyStateSync().
+ */
+import * as assert from "node:assert/strict";
+import { test } from "node:test";
+import { MeshStore } from "../core/mesh-store.js";
+/** A local-only store: no transport start, so no ports and no flake. */
+function makeStore() {
+    return new MeshStore();
+}
+function snapshotOf(store) {
+    return structuredClone(store.serialise());
+}
+void test("a stale holder converges when a fresher snapshot arrives", async () => {
+    const a = makeStore();
+    const b = makeStore();
+    const agent = await a.registerAgent({
+        name: "old-name",
+        harness: "pi",
+        cwd: "/tmp/p",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    // B holds the pre-rename copy.
+    b.applyStateSync(snapshotOf(a));
+    assert.equal((await b.getAgent(agent.id))?.name, "old-name");
+    // A renames while B is away; B heals on A's next snapshot.
+    await a.updateAgent(agent.id, { name: "new-name" });
+    b.applyStateSync(snapshotOf(a));
+    assert.equal((await b.getAgent(agent.id))?.name, "new-name");
+});
+void test("a current holder rejects a stale snapshot instead of regressing", async () => {
+    const a = makeStore();
+    const b = makeStore();
+    const agent = await a.registerAgent({
+        name: "old-name",
+        harness: "pi",
+        cwd: "/tmp/p",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    // B is current at the post-rename revision.
+    await a.updateAgent(agent.id, { name: "new-name" });
+    b.applyStateSync(snapshotOf(a));
+    assert.equal((await b.getAgent(agent.id))?.name, "new-name");
+    // A returning peer that still holds the pre-rename snapshot cannot regress B, where the old add-only merge kept whatever arrived first.
+    const stale = snapshotOf(a);
+    const staleAgent = stale.agents[agent.id];
+    if (staleAgent === undefined)
+        throw new Error("agent missing from snapshot");
+    staleAgent.name = "old-name";
+    staleAgent.version -= 1;
+    b.applyStateSync(stale);
+    assert.equal((await b.getAgent(agent.id))?.name, "new-name");
+});
+void test("room membership changes converge and stale member lists are rejected", async () => {
+    const a = makeStore();
+    const b = makeStore();
+    const owner = await a.registerAgent({
+        name: "owner",
+        harness: "pi",
+        cwd: "/tmp/p",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    const joiner = await b.registerAgent({
+        name: "joiner",
+        harness: "claude-code",
+        cwd: "/tmp/j",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    await a.createRoom({
+        name: "room",
+        type: "public",
+        owner: owner.id,
+        description: "x",
+    });
+    // A holds the room before the join; the joiner lives on B, so the join
+    // mutates B's copy and syncs back (one MeshStore is one peer identity, so
+    // a second agent cannot be registered on A).
+    a.applyStateSync(snapshotOf(b));
+    b.applyStateSync(snapshotOf(a));
+    assert.equal((await a.getRoom("room"))?.members.includes(joiner.id), false);
+    await b.joinRoom("room", joiner.id);
+    a.applyStateSync(snapshotOf(b));
+    assert.equal((await a.getRoom("room"))?.members.includes(joiner.id), true);
+    // The joiner leaves; A (now current) must drop them — the union-only merge
+    // could never remove a leaver.
+    await b.leaveRoom("room", joiner.id);
+    a.applyStateSync(snapshotOf(b));
+    assert.equal((await a.getRoom("room"))?.members.includes(joiner.id), false);
+    // A stale member list that still contains them is rejected.
+    const stale = snapshotOf(b);
+    const staleRoom = stale.rooms.room;
+    if (staleRoom === undefined)
+        throw new Error("room missing from snapshot");
+    staleRoom.members.push(joiner.id);
+    staleRoom.version -= 1;
+    a.applyStateSync(stale);
+    assert.equal((await a.getRoom("room"))?.members.includes(joiner.id), false);
+});
+void test("history sync adds unseen messages and unions read receipts", async () => {
+    const a = makeStore();
+    const b = makeStore();
+    const agent = await a.registerAgent({
+        name: "sender",
+        harness: "pi",
+        cwd: "/tmp/p",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    await a.createRoom({
+        name: "room",
+        type: "public",
+        owner: agent.id,
+        description: "x",
+    });
+    await a.sendRoomMessage("room", agent.id, "one");
+    b.applyStateSync(snapshotOf(a));
+    // While B is away, a second message arrives and the first gains a reader elsewhere on the mesh; B's next sync takes both.
+    await a.sendRoomMessage("room", agent.id, "two");
+    const fresh = snapshotOf(a);
+    const history = fresh.messages.room;
+    if (history?.[0] === undefined)
+        throw new Error("messages missing from snapshot");
+    history[0].readBy.push("reader-elsewhere");
+    b.applyStateSync(fresh);
+    const merged = await b.readRoomMessages("room");
+    assert.deepEqual(merged.map((m) => m.content), ["one", "two"]);
+    assert.equal(merged[0]?.readBy.includes("reader-elsewhere"), true);
+});
+//# sourceMappingURL=state-sync-convergence.test.js.map

package/dist/test/state-sync-convergence.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-comms",
-  "version": "1.25.4",
+  "version": "1.25.6",
   "description": "Cross-harness communication mesh for LLM agents — rooms, DMs, presence, and real-time push delivery over TCP",
   "type": "module",
   "packageManager": "pnpm@10.33.0",
@@ -52,7 +52,7 @@
     "generate:server-json": "tsx scripts/sync-release-metadata.ts",
     "publish:mcp-registry": "tsx scripts/publish-mcp-registry.ts",
     "lint": "eslint .",
-    "test": "node --test --test-concurrency=1 dist/test/coordinator-socket-error.integration.test.js dist/test/identity-store.test.js dist/test/identity-cert.test.js dist/test/broadcast-window.integration.test.js dist/test/identity-restart.integration.test.js dist/test/mesh-e2e.integration.test.js dist/test/ws-broadcast-window.integration.test.js dist/test/tls-transport.integration.test.js",
+    "test": "node --test --test-concurrency=1 dist/test/coordinator-socket-error.integration.test.js dist/test/identity-store.test.js dist/test/identity-cert.test.js dist/test/broadcast-window.integration.test.js dist/test/identity-restart.integration.test.js dist/test/mesh-e2e.integration.test.js dist/test/ws-broadcast-window.integration.test.js dist/test/tls-transport.integration.test.js dist/test/state-sync-convergence.test.js dist/test/downtime-replay.test.js dist/test/downtime-replay.integration.test.js",
     "test:visibility": "node --test dist/test/visibility.integration.test.js",
     "test:delivery": "node dist/test/delivery-receipt.runner.js",
     "test:all": "pnpm test && pnpm test:delivery",