agent-comms 2.21.9 → 2.21.11

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.9"
+      "version": "2.21.11"
     }
   ]
 }

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.9",
+  "version": "2.21.11",
   "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.9-blue)](https://github.com/ExaDev/agent-comms/releases/tag/v2.21.9)
+[![version](https://img.shields.io/badge/version-2.21.11-blue)](https://github.com/ExaDev/agent-comms/releases/tag/v2.21.11)
 [![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/agent-registry.test.d.ts

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

package/dist/test/agent-registry.test.d.ts.map

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

package/dist/test/agent-registry.test.js

@@ -0,0 +1,275 @@
+/**
+ * Direct, DI-based unit tests for AgentRegistry -- it was previously exercised only indirectly through MeshStore/room-kick-revocation integration tests, which left many individual branches, string literals, and array literals unobserved. AgentRegistryDeps is a narrow, injectable surface built exactly for this: a fake deps object with vi.fn() collaborators lets every branch be asserted on directly.
+ *
+ * One mutant Stryker raises against setAgentOffline is a true equivalent, not a gap -- documented here rather than chased with a contrived test, matching stale-agent-checker.test.ts's own precedent for the identical pattern: `this.deps.agents.set(id, agent)` right after `agent.status = "offline"` re-sets the same key to the exact same object reference `this.deps.agents.get(id)` already returned, so mutating `.status` on it has already mutated what the Map holds. No test can observe removing that call.
+ */
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { AgentRegistry, } from "../core/agent-registry.js";
+import { CommsError } from "../core/store.js";
+const OWNER_ID = "owner-device";
+const OTHER_ID = "other-device";
+const STARTED_AT = "2026-01-01T00:00:00.000Z";
+/** An arbitrary, distinctive pid used only to prove updateAgent's patch actually lands -- no significance beyond "not the seeded pid". */
+const UPDATED_PID = 999;
+function agent(overrides = {}) {
+    return {
+        id: OWNER_ID,
+        version: 1,
+        name: "agent-name",
+        harness: "pi",
+        cwd: "/tmp",
+        pid: 111,
+        startedAt: STARTED_AT,
+        visibility: "visible",
+        status: "active",
+        tags: [],
+        subscribedRooms: [],
+        ...overrides,
+    };
+}
+function makeHarness(peerId = OWNER_ID) {
+    const bump = vi.fn();
+    const broadcastPatch = vi.fn().mockResolvedValue(undefined);
+    const notifyRoomsOfStatus = vi.fn().mockResolvedValue(undefined);
+    const notifyRoomsOfNameChange = vi.fn().mockResolvedValue(undefined);
+    const broadcastAgentVisible = vi.fn().mockResolvedValue(undefined);
+    const broadcastAgentGone = vi.fn().mockResolvedValue(undefined);
+    const deps = {
+        agents: new Map(),
+        identityCache: new Map(),
+        startedAt: STARTED_AT,
+        getPeerId: () => peerId,
+        deliveryEngine: {
+            bump,
+            broadcastPatch,
+            notifyRoomsOfStatus,
+            notifyRoomsOfNameChange,
+        },
+        federation: { broadcastAgentVisible, broadcastAgentGone },
+    };
+    return {
+        deps,
+        registry: new AgentRegistry(deps),
+        bump,
+        broadcastPatch,
+        notifyRoomsOfStatus,
+        notifyRoomsOfNameChange,
+        broadcastAgentVisible,
+        broadcastAgentGone,
+    };
+}
+describe("AgentRegistry — identity cache", () => {
+    it("readIdentity keys by the exact harness+cwd pair, not a blank or partial key", async () => {
+        const { registry, deps } = makeHarness();
+        deps.identityCache.set("pi--/tmp/a", { id: "agent-a" });
+        deps.identityCache.set("codex--/tmp/a", { id: "agent-b" });
+        await expect(registry.readIdentity("pi", "/tmp/a")).resolves.toEqual({
+            id: "agent-a",
+        });
+        await expect(registry.readIdentity("codex", "/tmp/a")).resolves.toEqual({
+            id: "agent-b",
+        });
+        await expect(registry.readIdentity("pi", "/tmp/other")).resolves.toBeUndefined();
+    });
+    it("writeIdentity stores under the harness+cwd composite key, readable back by readIdentity", async () => {
+        const { registry } = makeHarness();
+        await registry.writeIdentity("pi", "/tmp/a", "written-id");
+        await expect(registry.readIdentity("pi", "/tmp/a")).resolves.toEqual({
+            id: "written-id",
+        });
+    });
+});
+describe("AgentRegistry — registerAgent", () => {
+    it("a brand-new (harness, cwd) pair creates a fresh agent with an empty subscribedRooms array", async () => {
+        const { registry, deps } = makeHarness();
+        const created = await registry.registerAgent({
+            name: "fresh",
+            harness: "pi",
+            cwd: "/tmp/fresh",
+            pid: 1,
+            visibility: "visible",
+            tags: ["x"],
+        });
+        expect(created.subscribedRooms).toEqual([]);
+        expect(deps.agents.get(OWNER_ID)).toEqual(created);
+        await expect(registry.readIdentity("pi", "/tmp/fresh")).resolves.toEqual({
+            id: OWNER_ID,
+        });
+    });
+    it("re-registering an already-known (harness, cwd) pair updates the existing agent by its original id rather than minting a fresh one", async () => {
+        let nextId = 0;
+        const peerIds = ["first-id", "second-id"];
+        const { registry, deps } = makeHarness();
+        deps.getPeerId = () => {
+            const id = peerIds[nextId];
+            nextId += 1;
+            if (id === undefined)
+                throw new Error("getPeerId called more times than expected");
+            return id;
+        };
+        const first = await registry.registerAgent({
+            name: "one",
+            harness: "pi",
+            cwd: "/tmp/same",
+            pid: 1,
+            visibility: "visible",
+            tags: [],
+        });
+        const second = await registry.registerAgent({
+            name: "two",
+            harness: "pi",
+            cwd: "/tmp/same",
+            pid: 2,
+            visibility: "hidden",
+            tags: ["updated"],
+        });
+        expect(second.id).toBe(first.id);
+        expect(nextId).toBe(1);
+        expect(second.name).toBe("two");
+        expect(second.visibility).toBe("hidden");
+        expect(second.pid).toBe(2);
+        expect(second.tags).toEqual(["updated"]);
+    });
+    it("broadcasts presence to federated links only for a visible agent, not hidden or ghost", async () => {
+        const visible = makeHarness();
+        await visible.registry.registerAgent({
+            name: "v",
+            harness: "pi",
+            cwd: "/tmp/v",
+            pid: 1,
+            visibility: "visible",
+            tags: [],
+        });
+        expect(visible.broadcastAgentVisible).toHaveBeenCalledTimes(1);
+        const hidden = makeHarness();
+        await hidden.registry.registerAgent({
+            name: "h",
+            harness: "pi",
+            cwd: "/tmp/h",
+            pid: 1,
+            visibility: "hidden",
+            tags: [],
+        });
+        expect(hidden.broadcastAgentVisible).not.toHaveBeenCalled();
+        const ghost = makeHarness();
+        await ghost.registry.registerAgent({
+            name: "g",
+            harness: "pi",
+            cwd: "/tmp/g",
+            pid: 1,
+            visibility: "ghost",
+            tags: [],
+        });
+        expect(ghost.broadcastAgentVisible).not.toHaveBeenCalled();
+    });
+});
+describe("AgentRegistry — getAgent", () => {
+    it("returns the stored agent for a known id, undefined for an unknown one", async () => {
+        const { registry, deps } = makeHarness();
+        const a = agent();
+        deps.agents.set(a.id, a);
+        await expect(registry.getAgent(a.id)).resolves.toEqual(a);
+        await expect(registry.getAgent("nobody")).resolves.toBeUndefined();
+    });
+});
+describe("AgentRegistry — updateAgent", () => {
+    let h;
+    beforeEach(() => {
+        h = makeHarness();
+        h.deps.agents.set(OWNER_ID, agent({ name: "old-name", status: "active" }));
+    });
+    it("throws a CommsError naming the exact missing agent id when the target doesn't exist", async () => {
+        await expect(h.registry.updateAgent("missing-id", {})).rejects.toMatchObject(new CommsError("Agent missing-id not found", "AGENT_NOT_FOUND"));
+    });
+    it("bumps and persists the merged patch into the agents map", async () => {
+        const updated = await h.registry.updateAgent(OWNER_ID, {
+            pid: UPDATED_PID,
+        });
+        expect(h.bump).toHaveBeenCalledWith(updated);
+        expect(h.deps.agents.get(OWNER_ID)).toEqual(updated);
+        expect(updated.pid).toBe(UPDATED_PID);
+    });
+    it("notifies rooms of a name change only when the patch actually changes the name", async () => {
+        await h.registry.updateAgent(OWNER_ID, { name: "new-name" });
+        expect(h.notifyRoomsOfNameChange).toHaveBeenCalledWith(OWNER_ID, "old-name", "new-name");
+    });
+    it("does not notify of a name change when the patch omits name", async () => {
+        await h.registry.updateAgent(OWNER_ID, { pid: 1 });
+        expect(h.notifyRoomsOfNameChange).not.toHaveBeenCalled();
+    });
+    it("does not notify of a name change when the patch repeats the current name", async () => {
+        await h.registry.updateAgent(OWNER_ID, { name: "old-name" });
+        expect(h.notifyRoomsOfNameChange).not.toHaveBeenCalled();
+    });
+    it("notifies rooms of a status change only when the patch actually changes the status", async () => {
+        await h.registry.updateAgent(OWNER_ID, { status: "offline" });
+        expect(h.notifyRoomsOfStatus).toHaveBeenCalledWith(OWNER_ID, "offline");
+    });
+    it("does not notify of a status change when the patch omits status", async () => {
+        await h.registry.updateAgent(OWNER_ID, { pid: 1 });
+        expect(h.notifyRoomsOfStatus).not.toHaveBeenCalled();
+    });
+    it("does not notify of a status change when the patch repeats the current status", async () => {
+        await h.registry.updateAgent(OWNER_ID, { status: "active" });
+        expect(h.notifyRoomsOfStatus).not.toHaveBeenCalled();
+    });
+});
+describe("AgentRegistry — listAgents", () => {
+    it("excludes a ghost agent from a different requester's view", async () => {
+        const { registry, deps } = makeHarness();
+        deps.agents.set("ghost-agent", agent({ id: "ghost-agent", visibility: "ghost" }));
+        deps.agents.set("visible-agent", agent({ id: "visible-agent", visibility: "visible" }));
+        const result = await registry.listAgents("some-requester");
+        expect(result.map((a) => a.id)).toEqual(["visible-agent"]);
+    });
+    it("includes a ghost agent in its own view of itself", async () => {
+        const { registry, deps } = makeHarness();
+        deps.agents.set("ghost-agent", agent({ id: "ghost-agent", visibility: "ghost" }));
+        const result = await registry.listAgents("ghost-agent");
+        expect(result.map((a) => a.id)).toEqual(["ghost-agent"]);
+    });
+    it("always includes a non-ghost agent regardless of who's asking", async () => {
+        const { registry, deps } = makeHarness();
+        deps.agents.set("visible-agent", agent({ id: "visible-agent", visibility: "visible" }));
+        const result = await registry.listAgents("anyone-else");
+        expect(result.map((a) => a.id)).toEqual(["visible-agent"]);
+    });
+});
+describe("AgentRegistry — setAgentOffline", () => {
+    it("is a no-op for an unknown agent id", async () => {
+        const h = makeHarness();
+        await h.registry.setAgentOffline("unknown");
+        expect(h.bump).not.toHaveBeenCalled();
+    });
+    it("is a no-op for an agent already offline", async () => {
+        const h = makeHarness();
+        h.deps.agents.set(OWNER_ID, agent({ status: "offline" }));
+        await h.registry.setAgentOffline(OWNER_ID);
+        expect(h.bump).not.toHaveBeenCalled();
+        expect(h.notifyRoomsOfStatus).not.toHaveBeenCalled();
+    });
+    it("for the owning peer's own agent, sets status offline, bumps, persists, and broadcasts to rooms/mesh/federation", async () => {
+        const h = makeHarness(OWNER_ID);
+        h.deps.agents.set(OWNER_ID, agent({ status: "active" }));
+        await h.registry.setAgentOffline(OWNER_ID);
+        expect(h.deps.agents.get(OWNER_ID)?.status).toBe("offline");
+        expect(h.bump).toHaveBeenCalledTimes(1);
+        expect(h.notifyRoomsOfStatus).toHaveBeenCalledWith(OWNER_ID, "offline");
+        expect(h.broadcastPatch).toHaveBeenCalledWith({
+            type: "agent_offline",
+            agentId: OWNER_ID,
+        });
+        expect(h.broadcastAgentGone).toHaveBeenCalledWith(OWNER_ID);
+    });
+    it("for a non-owning peer's agent, updates local state but does not broadcast anything", async () => {
+        const h = makeHarness(OWNER_ID);
+        h.deps.agents.set(OTHER_ID, agent({ id: OTHER_ID, status: "active" }));
+        await h.registry.setAgentOffline(OTHER_ID);
+        expect(h.deps.agents.get(OTHER_ID)?.status).toBe("offline");
+        expect(h.bump).toHaveBeenCalledTimes(1);
+        expect(h.notifyRoomsOfStatus).not.toHaveBeenCalled();
+        expect(h.broadcastPatch).not.toHaveBeenCalled();
+        expect(h.broadcastAgentGone).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=agent-registry.test.js.map

package/dist/test/agent-registry.test.js.map

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

package/dist/test/wire-mesh-transport-shutdown-unref.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * WireMeshTransport shutdown()/unref() -- direct mechanism assertions, split out of wire-mesh-transport.test.ts to stay under this repo's max-lines cap. Existing shutdown coverage in the sibling file proves observable, cross-peer behaviour (B sees A's session close, a second decision finds nothing pending). These tests instead assert directly on the specific cleanup mechanisms shutdown() itself performs -- the underlying Map/Set.clear() calls, timer cancellations, and listener unref() calls -- so a mutation removing one of those calls fails here even when nothing was ever added to the collection it clears, which no behavioural assertion downstream of an empty collection could otherwise observe.
+ */
+export {};
+//# sourceMappingURL=wire-mesh-transport-shutdown-unref.test.d.ts.map

package/dist/test/wire-mesh-transport-shutdown-unref.test.d.ts.map

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

package/dist/test/wire-mesh-transport-shutdown-unref.test.js

@@ -0,0 +1,194 @@
+/**
+ * WireMeshTransport shutdown()/unref() -- direct mechanism assertions, split out of wire-mesh-transport.test.ts to stay under this repo's max-lines cap. Existing shutdown coverage in the sibling file proves observable, cross-peer behaviour (B sees A's session close, a second decision finds nothing pending). These tests instead assert directly on the specific cleanup mechanisms shutdown() itself performs -- the underlying Map/Set.clear() calls, timer cancellations, and listener unref() calls -- so a mutation removing one of those calls fails here even when nothing was ever added to the collection it clears, which no behavioural assertion downstream of an empty collection could otherwise observe.
+ */
+import * as net from "node:net";
+import { test, describe, expect, vi } from "vitest";
+import { createTlsTransport } from "wire-mesh-core/adapters/tls-transport";
+import { acceptMeshSession } from "wire-mesh-core/domain/mesh-session";
+import { generateIdentity } from "../core/identity.js";
+import { toIdentityPort } from "../core/wire-mesh-identity.js";
+import { WireMeshTransport, DOMAIN, FRAME_SCOPE, buildCommand, } from "../core/wire-mesh-transport.js";
+import { deviceIdToHex } from "wire-mesh-core/domain/device-id";
+import { waitFor } from "./test-transport.js";
+function noopEvents(overrides = {}) {
+    return {
+        onMessage: () => undefined,
+        onPeerConnected: () => undefined,
+        onPeerDisconnected: () => undefined,
+        onIntroduction: () => undefined,
+        onConnectionRequest: () => undefined,
+        onPeerList: () => undefined,
+        onPeerJoined: () => undefined,
+        onBecomeCoordinator: () => undefined,
+        onRevocationAnnounce: () => undefined,
+        onPresenceAdvert: () => undefined,
+        ...overrides,
+    };
+}
+async function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            const port = typeof addr === "object" && addr !== null ? addr.port : 0;
+            server.close(() => resolve(port));
+        });
+        server.on("error", reject);
+    });
+}
+async function peerId(identity) {
+    return deviceIdToHex(Uint8Array.from(identity.deviceId));
+}
+// pendingConnections, peerSessions, coordinatorListeners -- the three Maps shutdown() clears.
+const SHUTDOWN_MAP_CLEAR_COUNT = 3;
+describe("WireMeshTransport shutdown -- direct mechanism assertions", () => {
+    test("shutdown clears every internal bookkeeping collection, even when all of them are already empty", async () => {
+        const identity = generateIdentity();
+        const transport = new WireMeshTransport(noopEvents(), identity);
+        const mapClearSpy = vi.spyOn(Map.prototype, "clear");
+        const setClearSpy = vi.spyOn(Set.prototype, "clear");
+        try {
+            await transport.shutdown();
+            // dataDials, allSessions (Sets) + pendingConnections, peerSessions, coordinatorListeners (Maps) -- five distinct collections shutdown() is documented to clear, regardless of whether any of them held anything.
+            expect(setClearSpy.mock.calls.length).toBeGreaterThanOrEqual(2);
+            expect(mapClearSpy.mock.calls.length).toBeGreaterThanOrEqual(SHUTDOWN_MAP_CLEAR_COUNT);
+        }
+        finally {
+            mapClearSpy.mockRestore();
+            setClearSpy.mockRestore();
+        }
+    });
+    test("shutdown cancels the pending-connection timeout for every still-pending connect_request, not just its own reject response", async () => {
+        const identityA = generateIdentity();
+        const identityB = generateIdentity();
+        const idB = await peerId(await toIdentityPort(identityB));
+        const requestsSeenByA = [];
+        const transportA = new WireMeshTransport(noopEvents({
+            onConnectionRequest: (h) => void requestsSeenByA.push(h),
+        }), identityA);
+        const clearTimeoutSpy = vi.spyOn(global, "clearTimeout");
+        try {
+            await transportA.becomeCoordinator("127.0.0.1", 0);
+            const [listener] = transportA.listListeners();
+            if (listener === undefined)
+                throw new Error("expected a bound listener");
+            const clientTransport = createTlsTransport({
+                certificatePem: identityB.certificate,
+                privateKeyPem: identityB.privateKey,
+            });
+            const connection = await clientTransport.connect(`127.0.0.1:${String(listener.port)}`);
+            const clientIdentityPort = await toIdentityPort(identityB);
+            const session = await acceptMeshSession(connection, clientIdentityPort, [
+                DOMAIN,
+            ]);
+            void session
+                .sendManageRequest(buildCommand({
+                method: "connect_request",
+                peerId: idB,
+                dataPort: 0,
+                name: "connector",
+                fingerprint: "",
+            }), FRAME_SCOPE)
+                .catch(() => undefined);
+            await waitFor(() => requestsSeenByA.some((h) => h.id === idB), "A observes the pending connect_request");
+            clearTimeoutSpy.mockClear();
+            await transportA.shutdown();
+            expect(clearTimeoutSpy).toHaveBeenCalled();
+            await session.close();
+        }
+        finally {
+            clearTimeoutSpy.mockRestore();
+            await transportA.shutdown();
+        }
+    });
+    test("shutdown clears the presence-readvertise interval when one was started", async () => {
+        const identity = generateIdentity();
+        const clearIntervalSpy = vi.spyOn(global, "clearInterval");
+        try {
+            const transport = new WireMeshTransport(noopEvents(), identity, undefined, undefined, () => "active");
+            clearIntervalSpy.mockClear();
+            await transport.shutdown();
+            expect(clearIntervalSpy).toHaveBeenCalledTimes(1);
+        }
+        finally {
+            clearIntervalSpy.mockRestore();
+        }
+    });
+    test("shutdown does not call clearInterval at all when no presence source was ever configured", async () => {
+        const identity = generateIdentity();
+        const clearIntervalSpy = vi.spyOn(global, "clearInterval");
+        try {
+            const transport = new WireMeshTransport(noopEvents(), identity);
+            clearIntervalSpy.mockClear();
+            await transport.shutdown();
+            expect(clearIntervalSpy).not.toHaveBeenCalled();
+        }
+        finally {
+            clearIntervalSpy.mockRestore();
+        }
+    });
+    test("a connect_request left unanswered past the configured timeout is auto-rejected with the documented error code", async () => {
+        const identityA = generateIdentity();
+        const identityB = generateIdentity();
+        const idB = await peerId(await toIdentityPort(identityB));
+        const SHORT_TIMEOUT_MS = 150;
+        const transportA = new WireMeshTransport(noopEvents(), identityA, undefined, SHORT_TIMEOUT_MS);
+        const transportB = new WireMeshTransport(noopEvents(), identityB);
+        try {
+            await transportA.becomeCoordinator("127.0.0.1", 0);
+            const [listener] = transportA.listListeners();
+            if (listener === undefined)
+                throw new Error("expected a bound listener");
+            const clientTransport = createTlsTransport({
+                certificatePem: identityB.certificate,
+                privateKeyPem: identityB.privateKey,
+            });
+            const connection = await clientTransport.connect(`127.0.0.1:${String(listener.port)}`);
+            const clientIdentityPort = await toIdentityPort(identityB);
+            const session = await acceptMeshSession(connection, clientIdentityPort, [
+                DOMAIN,
+            ]);
+            const outcome = await session.sendManageRequest(buildCommand({
+                method: "connect_request",
+                peerId: idB,
+                dataPort: 0,
+                name: "connector",
+                fingerprint: "",
+            }), FRAME_SCOPE);
+            expect(outcome).toMatchObject({ result: "error", code: "timeout" });
+            await session.close();
+        }
+        finally {
+            await transportB.shutdown();
+            await transportA.shutdown();
+        }
+    });
+});
+describe("WireMeshTransport unref", () => {
+    test("unrefs the data listener and every coordinator listener, not just one of them", async () => {
+        const identity = generateIdentity();
+        const transport = new WireMeshTransport(noopEvents(), identity);
+        const unrefSpy = vi.spyOn(net.Server.prototype, "unref");
+        try {
+            await transport.startDataServer();
+            const port = await findFreePort();
+            await transport.addListener("127.0.0.1", port, "full");
+            unrefSpy.mockClear();
+            transport.unref();
+            // The data listener plus exactly one added coordinator listener -- two distinct real net.Server instances, each individually unref'd.
+            expect(unrefSpy).toHaveBeenCalledTimes(2);
+        }
+        finally {
+            unrefSpy.mockRestore();
+            await transport.shutdown();
+        }
+    });
+    test("unref with no listeners started at all is a safe no-op, not a throw", async () => {
+        const identity = generateIdentity();
+        const transport = new WireMeshTransport(noopEvents(), identity);
+        expect(() => {
+            transport.unref();
+        }).not.toThrow();
+    });
+});
+//# sourceMappingURL=wire-mesh-transport-shutdown-unref.test.js.map

package/dist/test/wire-mesh-transport-shutdown-unref.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-comms",
-  "version": "2.21.9",
+  "version": "2.21.11",
   "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",