agent-comms 3.8.0 → 3.10.0

package/dist/test/cc-peer-front-controller.test.js

@@ -0,0 +1,206 @@
+/**
+ * Unit tests for CcPeerFront -- the coordinator-only periodic controller (front-controller.ts) that attaches/detaches fronted sessions on each tick, driven by injected roster/probe/attach/detach/inbound-routing dependencies so it's testable with fake timers and no real cc-peer/MeshStore involved.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { CcPeerFront, } from "../bridges/cc-peer/front-controller.js";
+const POLL_INTERVAL_MS = 5000;
+/** How many poll intervals stop() must survive with zero further polling -- arbitrary beyond "more than one", chosen to make a lingering timer's own recurrence visible rather than a one-off fluke (matches stale-agent-checker.test.ts's own HALT_CHECK_INTERVAL_COUNT convention). */
+const HALT_CHECK_INTERVAL_COUNT = 3;
+/** A pid standing in for a real live agent-comms bridge holding a slot's lock -- arbitrary beyond "a plausible process id", used only to prove the yield path treats "probe returned a pid" as "session now fronts itself". */
+const LIVE_LOCK_HOLDER_PID = 4242;
+function rosterEntry(overrides = {}) {
+    return {
+        pid: 111,
+        cwd: "/tmp/project",
+        version: "2.1.269",
+        messagingSocketPath: "/tmp/sock-111",
+        ...overrides,
+    };
+}
+/** Unwraps the resolved value of a mocked attach() call's Nth invocation, asserting it actually happened -- vi's own mock.results indexing returns undefined for a call that never occurred, which every call site here has already asserted against via toHaveBeenCalledTimes. */
+async function attachResult(attach, callIndex = 0) {
+    const value = await attach.mock.results[callIndex]?.value;
+    if (value === undefined) {
+        throw new Error(`attach() was never called at index ${String(callIndex)}`);
+    }
+    return value;
+}
+function stubRecord(entry) {
+    return {
+        pid: entry.pid,
+        cwd: entry.cwd,
+        messagingSocketPath: entry.messagingSocketPath,
+        handleInbound: vi.fn(),
+        detached: false,
+    };
+}
+function harness(initialRoster) {
+    const roster = [...initialRoster];
+    const attach = vi.fn(async (entry) => Promise.resolve(stubRecord(entry)));
+    const detach = vi.fn(async (record) => {
+        record.detached = true;
+        return Promise.resolve();
+    });
+    const probeSlotOwner = vi.fn(() => undefined);
+    const onError = vi.fn();
+    const deps = {
+        listRoster: async () => Promise.resolve([...roster]),
+        probeSlotOwner,
+        attach,
+        detach,
+        pollIntervalMs: POLL_INTERVAL_MS,
+        onError,
+    };
+    return {
+        front: new CcPeerFront(deps),
+        deps,
+        roster,
+        attach,
+        detach,
+        probeSlotOwner,
+        onError,
+    };
+}
+describe("CcPeerFront — start/stop", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it("does nothing until start() is called", async () => {
+        const h = harness([rosterEntry()]);
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS * 2);
+        expect(h.attach).not.toHaveBeenCalled();
+        h.front.stop();
+    });
+    it("attaches a session on the first poll tick", async () => {
+        const h = harness([rosterEntry({ pid: 1 })]);
+        h.front.start();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.attach).toHaveBeenCalledTimes(1);
+        await h.front.stop();
+    });
+    it("calling start() twice does not create a second timer", async () => {
+        const setIntervalSpy = vi.spyOn(globalThis, "setInterval");
+        const h = harness([]);
+        h.front.start();
+        h.front.start();
+        expect(setIntervalSpy).toHaveBeenCalledTimes(1);
+        await h.front.stop();
+    });
+    it("stop() halts further polling", async () => {
+        const h = harness([rosterEntry({ pid: 1 })]);
+        h.front.start();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.attach).toHaveBeenCalledTimes(1);
+        await h.front.stop();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS * HALT_CHECK_INTERVAL_COUNT);
+        expect(h.attach).toHaveBeenCalledTimes(1);
+    });
+    it("stop() detaches every currently-fronted session", async () => {
+        const h = harness([rosterEntry({ pid: 1 })]);
+        h.front.start();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.attach).toHaveBeenCalledTimes(1);
+        const record = await attachResult(h.attach);
+        await h.front.stop();
+        expect(h.detach).toHaveBeenCalledTimes(1);
+        expect(record.detached).toBe(true);
+    });
+});
+describe("CcPeerFront — attach/detach diffing across ticks", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it("does not re-attach a session already fronted from a previous tick", async () => {
+        const h = harness([rosterEntry({ pid: 1 })]);
+        h.front.start();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.attach).toHaveBeenCalledTimes(1);
+        await h.front.stop();
+    });
+    it("attaches a session that appears in the roster on a later tick", async () => {
+        const h = harness([]);
+        h.front.start();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.attach).not.toHaveBeenCalled();
+        h.roster.push(rosterEntry({ pid: 2 }));
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.attach).toHaveBeenCalledTimes(1);
+        await h.front.stop();
+    });
+    it("detaches a session that has exited (no longer in the roster)", async () => {
+        const h = harness([rosterEntry({ pid: 1 })]);
+        h.front.start();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.attach).toHaveBeenCalledTimes(1);
+        h.roster.length = 0;
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.detach).toHaveBeenCalledTimes(1);
+        await h.front.stop();
+    });
+    it("yields a session the moment its own slot is claimed by a live bridge, without re-attaching it", async () => {
+        const h = harness([rosterEntry({ pid: 1, cwd: "/tmp/yields" })]);
+        h.front.start();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.attach).toHaveBeenCalledTimes(1);
+        const record = await attachResult(h.attach);
+        // A real agent-comms bridge has since taken the slot over -- the probe now reports its pid.
+        h.probeSlotOwner.mockReturnValue(LIVE_LOCK_HOLDER_PID);
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.detach).toHaveBeenCalledTimes(1);
+        expect(record.detached).toBe(true);
+        expect(h.attach).toHaveBeenCalledTimes(1);
+        // Even if the slot frees up again later, this front never re-attaches on its own within the same run -- the session is expected to keep its own bridge running from here.
+        h.probeSlotOwner.mockReturnValue(undefined);
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.attach).toHaveBeenCalledTimes(2);
+        await h.front.stop();
+    });
+    it("routes an inbound message to the fronted session it came from", async () => {
+        const h = harness([
+            rosterEntry({ pid: 1, messagingSocketPath: "/tmp/sock-1" }),
+        ]);
+        h.front.start();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        const record = await attachResult(h.attach);
+        h.front.handleInboundMessage({ from: "uds:/tmp/sock-1", body: "hi" });
+        expect(record.handleInbound).toHaveBeenCalledWith({
+            from: "uds:/tmp/sock-1",
+            body: "hi",
+        });
+        await h.front.stop();
+    });
+    it("silently ignores an inbound message matching no fronted session", async () => {
+        const h = harness([]);
+        expect(() => h.front.handleInboundMessage({ from: "uds:/tmp/unknown", body: "hi" })).not.toThrow();
+    });
+    it("reports a roster failure via onError rather than throwing out of the poll timer", async () => {
+        const h = harness([]);
+        const failure = new Error("roster unavailable");
+        h.deps.listRoster = async () => Promise.reject(failure);
+        h.front.start();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.onError).toHaveBeenCalledWith(failure);
+        await h.front.stop();
+    });
+    it("reports an attach failure via onError without losing track of other sessions", async () => {
+        const h = harness([
+            rosterEntry({ pid: 1, cwd: "/tmp/a" }),
+            rosterEntry({ pid: 2, cwd: "/tmp/b" }),
+        ]);
+        const failure = new Error("cc-peer send failed");
+        h.attach.mockImplementationOnce(async () => Promise.reject(failure));
+        h.front.start();
+        await vi.advanceTimersByTimeAsync(POLL_INTERVAL_MS);
+        expect(h.onError).toHaveBeenCalledWith(failure);
+        expect(h.attach).toHaveBeenCalledTimes(2);
+        await h.front.stop();
+    });
+});
+//# sourceMappingURL=cc-peer-front-controller.test.js.map

package/dist/test/cc-peer-front-controller.test.js.map

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

package/dist/test/cc-peer-front-relay.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cc-peer-front-relay.test.d.ts.map

package/dist/test/cc-peer-front-relay.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cc-peer-front-relay.test.d.ts","sourceRoot":"","sources":["../../src/test/cc-peer-front-relay.test.ts"],"names":[],"mappings":""}

package/dist/test/cc-peer-front-relay.test.js

@@ -0,0 +1,177 @@
+/**
+ * Direct, DI-based unit tests for buildFrontedSessionRecord/detachFrontedSession -- the pure relay wiring front-relay.ts exposes, tested against fake store/tool/peer objects rather than a real MeshStore or local Claude Code session, mirroring cc-peer-bridge.test.ts's own approach for the one-shot bridge command.
+ */
+import { describe, expect, it, vi } from "vitest";
+import { buildFrontedSessionRecord, detachFrontedSession, } from "../bridges/cc-peer/front-relay.js";
+function rosterEntry(overrides = {}) {
+    return {
+        pid: 222,
+        cwd: "/tmp/project",
+        version: "2.1.269",
+        messagingSocketPath: "/tmp/sock-222",
+        ...overrides,
+    };
+}
+function fakeStore() {
+    const setAgentOfflineCalls = [];
+    let shutdownCalls = 0;
+    return {
+        onDelivery: undefined,
+        setAgentOfflineCalls,
+        get shutdownCalls() {
+            return shutdownCalls;
+        },
+        setAgentOffline: vi.fn(async (id) => {
+            setAgentOfflineCalls.push(id);
+            return Promise.resolve();
+        }),
+        shutdown: vi.fn(async () => {
+            shutdownCalls += 1;
+            return Promise.resolve();
+        }),
+    };
+}
+function fakePeer() {
+    const sendCalls = [];
+    return {
+        sendCalls,
+        send: vi.fn(async (target, body) => {
+            sendCalls.push({ target, body });
+            return Promise.resolve({ msgId: "msg-1" });
+        }),
+    };
+}
+function fakeTool() {
+    const handleCalls = [];
+    return {
+        handleCalls,
+        handle: vi.fn(async (ctx, action) => {
+            handleCalls.push({ ctx, action });
+            return Promise.resolve({ content: "ok", isError: false });
+        }),
+    };
+}
+function roomMessage(overrides = {}) {
+    return {
+        id: "msg-1",
+        from: "peer-a",
+        room: "owner/project",
+        content: "hi from the mesh",
+        timestamp: "2026-01-01T00:00:00.000Z",
+        readBy: [],
+        ...overrides,
+    };
+}
+describe("buildFrontedSessionRecord — outbound (mesh -> cc-peer)", () => {
+    it("wires store.onDelivery to send the formatted event to the session's own pid", () => {
+        const store = fakeStore();
+        const peer = fakePeer();
+        const entry = rosterEntry({ pid: 333 });
+        buildFrontedSessionRecord({
+            entry,
+            agentId: "agent-1",
+            roomId: "owner/project",
+            store,
+            tool: fakeTool(),
+            peer,
+        });
+        expect(store.onDelivery).toBeDefined();
+        const event = {
+            type: "room_message",
+            message: roomMessage(),
+        };
+        void store.onDelivery?.("agent-1", event);
+        expect(peer.sendCalls).toHaveLength(1);
+        expect(peer.sendCalls[0]?.target).toEqual({ pid: 333 });
+    });
+});
+describe("buildFrontedSessionRecord — inbound (cc-peer -> mesh)", () => {
+    it("returns a record whose handleInbound posts into the session's own project room", () => {
+        const tool = fakeTool();
+        const entry = rosterEntry({ cwd: "/tmp/my-project" });
+        const record = buildFrontedSessionRecord({
+            entry,
+            agentId: "agent-1",
+            roomId: "owner/my-project",
+            store: fakeStore(),
+            tool,
+            peer: fakePeer(),
+        });
+        record.handleInbound({
+            from: "local-session",
+            fromName: "my-local-session",
+            body: "hello from cc-peer",
+        });
+        expect(tool.handleCalls).toHaveLength(1);
+        expect(tool.handleCalls[0]).toEqual({
+            ctx: {
+                agentId: "agent-1",
+                harness: "claude-code",
+                cwd: "/tmp/my-project",
+                pid: process.pid,
+            },
+            action: {
+                action: "send",
+                target: "owner/my-project",
+                content: "my-local-session: hello from cc-peer",
+            },
+        });
+    });
+    it("falls back to the raw from id when the session has no registered display name", () => {
+        const tool = fakeTool();
+        const record = buildFrontedSessionRecord({
+            entry: rosterEntry(),
+            agentId: "agent-1",
+            roomId: "owner/project",
+            store: fakeStore(),
+            tool,
+            peer: fakePeer(),
+        });
+        record.handleInbound({ from: "local-session", body: "hi" });
+        const call = tool.handleCalls[0];
+        expect(call.action.content).toBe("local-session: hi");
+    });
+});
+describe("buildFrontedSessionRecord — record shape", () => {
+    it("carries the roster entry's own pid/cwd/messagingSocketPath, matching what CcPeerFront diffs and routes on", () => {
+        const entry = rosterEntry({
+            pid: 444,
+            cwd: "/tmp/other",
+            messagingSocketPath: "/tmp/sock-444",
+        });
+        const record = buildFrontedSessionRecord({
+            entry,
+            agentId: "agent-1",
+            roomId: "owner/other",
+            store: fakeStore(),
+            tool: fakeTool(),
+            peer: fakePeer(),
+        });
+        expect(record.pid).toBe(entry.pid);
+        expect(record.cwd).toBe(entry.cwd);
+        expect(record.messagingSocketPath).toBe(entry.messagingSocketPath);
+    });
+});
+describe("detachFrontedSession", () => {
+    it("marks the agent offline, then shuts its store down", async () => {
+        const store = fakeStore();
+        await detachFrontedSession({ agentId: "agent-1", store });
+        expect(store.setAgentOfflineCalls).toEqual(["agent-1"]);
+        expect(store.shutdownCalls).toBe(1);
+    });
+    it("shuts the store down only after setAgentOffline resolves, not concurrently with it", async () => {
+        const store = fakeStore();
+        const order = [];
+        vi.mocked(store.setAgentOffline).mockImplementation(async () => {
+            order.push("offline");
+            return Promise.resolve();
+        });
+        vi.mocked(store.shutdown).mockImplementation(async () => {
+            order.push("shutdown");
+            return Promise.resolve();
+        });
+        await detachFrontedSession({ agentId: "agent-1", store });
+        expect(order).toEqual(["offline", "shutdown"]);
+    });
+});
+//# sourceMappingURL=cc-peer-front-relay.test.js.map

package/dist/test/cc-peer-front-relay.test.js.map

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

package/dist/test/cc-peer-front.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cc-peer-front.test.d.ts.map

package/dist/test/cc-peer-front.test.d.ts.map

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

package/dist/test/cc-peer-front.test.js

@@ -0,0 +1,109 @@
+/**
+ * Unit tests for the cc-peer front's pure decision logic (bridges/cc-peer/front.ts) -- roster filtering, slot computation, and inbound message routing, all tested purely over data with no real cc-peer/MeshStore/filesystem involved.
+ */
+import { describe, expect, it } from "vitest";
+import { isCcPeerLibraryPeer, computeFrontSlot, selectSessionsToFront, matchInboundMessageSession, } from "../bridges/cc-peer/front.js";
+function rosterEntry(overrides = {}) {
+    return {
+        pid: 111,
+        cwd: "/tmp/project",
+        version: "2.1.269",
+        messagingSocketPath: "/tmp/sock-111",
+        ...overrides,
+    };
+}
+/** A pid standing in for a real live agent-comms bridge holding a slot's lock -- arbitrary beyond "a plausible process id", used only to prove selectSessionsToFront treats "probe returned a pid" as "already fronted", not to assert anything about the value itself. */
+const LIVE_LOCK_HOLDER_PID = 4242;
+describe("isCcPeerLibraryPeer", () => {
+    it("is true for an entry carrying cc-peer's own literal version marker", () => {
+        expect(isCcPeerLibraryPeer(rosterEntry({ version: "cc-peer" }))).toBe(true);
+    });
+    it("is false for an entry reporting a real Claude Code version", () => {
+        expect(isCcPeerLibraryPeer(rosterEntry({ version: "2.1.269" }))).toBe(false);
+    });
+});
+describe("computeFrontSlot", () => {
+    it("uses the claude-code harness, matching the real claude-code bridge's own slot", () => {
+        expect(computeFrontSlot("/tmp/project")).toEqual({
+            harness: "claude-code",
+            cwd: "/tmp/project",
+        });
+    });
+    it("is distinct per cwd", () => {
+        expect(computeFrontSlot("/tmp/a")).not.toEqual(computeFrontSlot("/tmp/b"));
+    });
+});
+describe("selectSessionsToFront", () => {
+    it("excludes cc-peer-library peers regardless of slot state", () => {
+        const libraryPeer = rosterEntry({ pid: 1, version: "cc-peer" });
+        const selected = selectSessionsToFront([libraryPeer], () => undefined);
+        expect(selected).toEqual([]);
+    });
+    it("excludes a real session whose own slot is already held by a live bridge", () => {
+        const alreadyFronted = rosterEntry({ pid: 2, cwd: "/tmp/self-fronted" });
+        const selected = selectSessionsToFront([alreadyFronted], (slot) => slot.cwd === "/tmp/self-fronted" ? LIVE_LOCK_HOLDER_PID : undefined);
+        expect(selected).toEqual([]);
+    });
+    it("selects a real session whose own slot is unheld", () => {
+        const unfronted = rosterEntry({ pid: 3, cwd: "/tmp/unfronted" });
+        const selected = selectSessionsToFront([unfronted], () => undefined);
+        expect(selected).toEqual([unfronted]);
+    });
+    it("probes the slot computed from the entry's own cwd, not an unrelated one", () => {
+        const entry = rosterEntry({ pid: 4, cwd: "/tmp/watched" });
+        let probedSlot;
+        selectSessionsToFront([entry], (slot) => {
+            probedSlot = slot;
+            return undefined;
+        });
+        expect(probedSlot).toEqual({ harness: "claude-code", cwd: "/tmp/watched" });
+    });
+    it("handles a mixed roster, keeping only the unfronted real sessions", () => {
+        const libraryPeer = rosterEntry({ pid: 1, version: "cc-peer" });
+        const selfFronted = rosterEntry({ pid: 2, cwd: "/tmp/self-fronted" });
+        const unfronted = rosterEntry({ pid: 3, cwd: "/tmp/unfronted" });
+        const selected = selectSessionsToFront([libraryPeer, selfFronted, unfronted], (slot) => slot.cwd === "/tmp/self-fronted" ? LIVE_LOCK_HOLDER_PID : undefined);
+        expect(selected).toEqual([unfronted]);
+    });
+});
+describe("matchInboundMessageSession", () => {
+    it("matches a fronted session by the uds:<socketPath> envelope convention", () => {
+        const a = {
+            messagingSocketPath: "/tmp/sock-a",
+            label: "a",
+        };
+        const b = {
+            messagingSocketPath: "/tmp/sock-b",
+            label: "b",
+        };
+        const match = matchInboundMessageSession([a, b], {
+            from: "uds:/tmp/sock-b",
+        });
+        expect(match).toBe(b);
+    });
+    it("returns undefined when no fronted session's socket matches", () => {
+        const a = {
+            messagingSocketPath: "/tmp/sock-a",
+            label: "a",
+        };
+        const match = matchInboundMessageSession([a], {
+            from: "uds:/tmp/sock-unknown",
+        });
+        expect(match).toBeUndefined();
+    });
+    it("returns undefined when the message carries no from field at all", () => {
+        const a = {
+            messagingSocketPath: "/tmp/sock-a",
+            label: "a",
+        };
+        expect(matchInboundMessageSession([a], {})).toBeUndefined();
+    });
+    it("never matches a from value missing the uds: prefix, even with an otherwise identical path", () => {
+        const a = {
+            messagingSocketPath: "/tmp/sock-a",
+            label: "a",
+        };
+        expect(matchInboundMessageSession([a], { from: "/tmp/sock-a" })).toBeUndefined();
+    });
+});
+//# sourceMappingURL=cc-peer-front.test.js.map

package/dist/test/cc-peer-front.test.js.map

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

package/dist/test/delivery-engine-delivery.test.js

@@ -126,6 +126,8 @@ function makeHarness() {
             identity: {},
             revocation: { record: revocationRecord },
             dataStorage: {},
+            userIdentity: {},
+            userIdentityOptions: {},
         }),
         requireTransport: () => transport,
         getOnDelivery: () => onDelivery,