agent-comms 3.2.0 → 3.4.0

package/dist/test/wss-remote-connect.integration.test.js

@@ -0,0 +1,106 @@
+// Integration: connectToRemote against a ws:// URL, through a minimal in-test fake hub speaking the real protocol (handshake reply, connect_request answered with manage-ok) -- proving the URL branch drives the identical session + connect_request flow the TLS branch uses, without standing up a TLS stack or a deployed hub.
+import { createServer } from "node:http";
+import { WebSocketServer } from "ws";
+import { afterEach, describe, expect, it } from "vitest";
+import { cdeDecodeOptions, cdeEncodeOptions, decode, encode } from "cbor2";
+import { generateIdentity } from "../core/identity.js";
+import { WireMeshTransport } from "../core/wire-mesh-transport.js";
+const SHUTDOWN_GRACE_MS = 250;
+const GARBAGE_PORT = 0; // meaningless in URL form -- exactly what the branch should tolerate
+function inertEvents() {
+    return {
+        onMessage: () => undefined,
+        onPeerConnected: () => undefined,
+        onPeerDisconnected: () => undefined,
+        onIntroduction: () => undefined,
+        onConnectionRequest: () => undefined,
+        onPeerList: () => undefined,
+        onPeerJoined: () => undefined,
+        onBecomeCoordinator: () => undefined,
+        onRevocationAnnounce: () => undefined,
+        onPresenceAdvert: () => undefined,
+    };
+}
+/** The minimal fake hub: replies to a handshake with a compatible one, answers every manage-request with manage-ok. Records every frame for assertions. */
+async function fakeHub() {
+    const received = [];
+    const http = createServer();
+    const wss = new WebSocketServer({ server: http });
+    wss.on("connection", (socket) => {
+        socket.on("message", (data) => {
+            const decodedFrame = decode(new Uint8Array(data), cdeDecodeOptions);
+            const frame = decodedFrame;
+            received.push(frame);
+            if (frame.type === "handshake") {
+                const answer = {
+                    type: "handshake",
+                    version: frame.version,
+                    domains: frame.domains,
+                };
+                socket.send(new Uint8Array(encode(answer, cdeEncodeOptions)));
+                return;
+            }
+            if (frame.type === "manage-request") {
+                const response = {
+                    type: "manage-response",
+                    "request-id": frame["request-id"],
+                    outcome: { result: "ok" },
+                };
+                socket.send(new Uint8Array(encode(response, cdeEncodeOptions)));
+            }
+            // Gossip and everything else: tolerated, unanswered -- the hub's own forwarding is not this test's subject.
+        });
+    });
+    await new Promise((resolve) => {
+        http.listen(0, "127.0.0.1", () => {
+            resolve();
+        });
+    });
+    const address = http.address();
+    if (address === null || typeof address === "string") {
+        throw new Error("expected a TCP listen address");
+    }
+    return {
+        url: `ws://127.0.0.1:${String(address.port)}/`,
+        received,
+        close: async () => new Promise((resolve) => {
+            // wss.close() alone waits for connected clients; terminate them first so shutdown cannot deadlock on the very connection under test.
+            for (const client of wss.clients) {
+                client.terminate();
+            }
+            wss.close();
+            http.close(() => {
+                resolve();
+            });
+            setTimeout(resolve, SHUTDOWN_GRACE_MS);
+        }),
+    };
+}
+const cleanups = [];
+afterEach(async () => {
+    for (const close of cleanups.splice(0)) {
+        await close();
+    }
+});
+describe("connectToRemote with a ws:// URL", () => {
+    it("dials the hub, handshakes, and sends connect_request through the same flow as TLS", async () => {
+        const hub = await fakeHub();
+        cleanups.push(hub.close);
+        const identity = generateIdentity();
+        const transport = new WireMeshTransport(inertEvents(), identity);
+        await transport.connectToRemote(hub.url, GARBAGE_PORT, "peer-id", 0, "test-agent", "");
+        // The fake hub saw the full flow the TLS branch also drives: this side's handshake, then the connect_request manage-request.
+        const sawHandshake = hub.received.some((f) => f.type === "handshake");
+        const connectRequest = hub.received.find((f) => f.type === "manage-request");
+        expect(sawHandshake).toBe(true);
+        expect(connectRequest).toBeDefined();
+        await transport.shutdown();
+    });
+    it("rejects a non-ws/wss URL host outright rather than dialling garbage", async () => {
+        const identity = generateIdentity();
+        const transport = new WireMeshTransport(inertEvents(), identity);
+        await expect(transport.connectToRemote("ftp://example.com/", GARBAGE_PORT, "peer-id", 0, "test-agent", "")).rejects.toThrow(/hostname or a ws:\/\/ \/ wss:\/\//);
+        await transport.shutdown();
+    });
+});
+//# sourceMappingURL=wss-remote-connect.integration.test.js.map

package/dist/test/wss-remote-connect.integration.test.js.map

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

package/package.json

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