agent-comms 3.21.0 → 3.23.0

package/dist/test/mesh-graph-trace.integration.test.js

@@ -0,0 +1,146 @@
+/**
+ * Real end-to-end coverage for agent-comms#199's mesh_graph/mesh_trace, against two genuine WireMeshTransport instances joined by a real connectToPeer session -- the same pattern wire-mesh-transport.test.ts's own "WireMeshTransport connectToPeer" describe block already uses, chosen for the identical reason: this needs the transport's own gossip/topology-self-advertisement and path.trace request/response to actually cross the wire, not a mocked session layer.
+ */
+import { test, describe, expect } from "vitest";
+import { generateIdentity } from "../core/identity.js";
+import { toIdentityPort } from "../core/wire-mesh-identity.js";
+import { deviceIdToHex } from "wire-mesh-core/domain/device-id";
+import { MeshStore } from "../core/mesh-store.js";
+import { WireMeshTransport } from "../core/wire-mesh-transport.js";
+import { waitFor, wireTestTransportWithHub } from "./test-transport.js";
+import { realHubOverWs, waitForCondition } from "./hub-helpers.js";
+function noopEvents() {
+    return {
+        onMessage: () => undefined,
+        onPeerConnected: () => undefined,
+        onPeerDisconnected: () => undefined,
+        onIntroduction: () => undefined,
+        onConnectionRequest: () => undefined,
+        onPeerList: () => undefined,
+        onPeerJoined: () => undefined,
+        onBecomeCoordinator: () => undefined,
+        onRevocationAnnounce: () => undefined,
+        onPresenceAdvert: () => undefined,
+    };
+}
+async function peerId(identity) {
+    return deviceIdToHex(Uint8Array.from(identity.deviceId));
+}
+/** A device-id is SHA-256(public key) -- 32 raw bytes, 64 hex characters. */
+const DEVICE_ID_BYTE_LENGTH = 32;
+describe("WireMeshTransport meshGraph/meshTrace (agent-comms#199)", () => {
+    test("meshGraph reports the other side's own self-advertised direct edge once gossip has propagated", async () => {
+        const identityA = generateIdentity();
+        const identityB = generateIdentity();
+        const idA = await peerId(await toIdentityPort(identityA));
+        const idB = await peerId(await toIdentityPort(identityB));
+        const transportA = new WireMeshTransport(noopEvents(), identityA);
+        const transportB = new WireMeshTransport(noopEvents(), identityB);
+        try {
+            await transportA.startDataServer();
+            await transportB.connectToPeer({
+                id: idA,
+                port: transportA.dataPort,
+                startedAt: new Date().toISOString(),
+            }, idB);
+            await waitFor(() => transportA.meshGraph().nodes.includes(idB), "A learns B's own device-id via gossip");
+            await waitFor(() => transportB.meshGraph().nodes.includes(idA), "B learns A's own device-id via gossip");
+            // A's own knownDevices holds B's self-advert (never A's own), and B's own topology/peers self-report says its direct peer is A -- the connection each side authenticated over TLS.
+            const graphFromA = transportA.meshGraph();
+            expect(graphFromA.nodes).toContain(idB);
+            expect(graphFromA.edges).toContainEqual({
+                kind: "direct",
+                from: idB,
+                to: idA,
+            });
+            const graphFromB = transportB.meshGraph();
+            expect(graphFromB.nodes).toContain(idA);
+            expect(graphFromB.edges).toContainEqual({
+                kind: "direct",
+                from: idA,
+                to: idB,
+            });
+        }
+        finally {
+            await transportB.shutdown();
+            await transportA.shutdown();
+        }
+    });
+    test("meshTrace sends a real path.trace over the direct peer session and reports a real RTT", async () => {
+        const identityA = generateIdentity();
+        const identityB = generateIdentity();
+        const idA = await peerId(await toIdentityPort(identityA));
+        const idB = await peerId(await toIdentityPort(identityB));
+        const transportA = new WireMeshTransport(noopEvents(), identityA);
+        const transportB = new WireMeshTransport(noopEvents(), identityB);
+        try {
+            await transportA.startDataServer();
+            await transportB.connectToPeer({
+                id: idA,
+                port: transportA.dataPort,
+                startedAt: new Date().toISOString(),
+            }, idB);
+            const result = await transportB.meshTrace(idA);
+            expect(result.outcome.result, JSON.stringify(result)).toBe("ok");
+            expect(result.rttMs).toBeGreaterThanOrEqual(0);
+            expect(result.local.relayed).toBe(false);
+            expect(result.remote?.relayed).toBe(false);
+        }
+        finally {
+            await transportB.shutdown();
+            await transportA.shutdown();
+        }
+    });
+    test("meshTrace resolves a not_connected outcome for a device with no known path", async () => {
+        const identityA = generateIdentity();
+        const transportA = new WireMeshTransport(noopEvents(), identityA);
+        const unknownDeviceHex = "ab".repeat(DEVICE_ID_BYTE_LENGTH);
+        try {
+            const result = await transportA.meshTrace(unknownDeviceHex);
+            expect(result.outcome).toEqual({
+                result: "error",
+                code: "not_connected",
+            });
+        }
+        finally {
+            await transportA.shutdown();
+        }
+    });
+    test("meshGraph reports no nodes before any gossip has been received", async () => {
+        const identityA = generateIdentity();
+        const transportA = new WireMeshTransport(noopEvents(), identityA);
+        try {
+            expect(transportA.meshGraph()).toEqual({ nodes: [], edges: [] });
+        }
+        finally {
+            await transportA.shutdown();
+        }
+    });
+    test("meshTrace routes via the hub's own relay pairing when no direct peer session exists, reporting relayed on both sides", async () => {
+        const hub = await realHubOverWs();
+        try {
+            const storeA = new MeshStore();
+            const { transport: transportA } = await wireTestTransportWithHub(storeA);
+            const storeB = new MeshStore();
+            const { transport: transportB } = await wireTestTransportWithHub(storeB);
+            try {
+                await transportA.connectHub?.(hub.url);
+                await transportB.connectHub?.(hub.url);
+                await waitForCondition(() => transportA.hub.isConnected && transportB.hub.isConnected);
+                const result = await transportA.meshTrace(storeB.peerId);
+                expect(result.outcome.result, JSON.stringify(result)).toBe("ok");
+                expect(result.local.relayed).toBe(true);
+                expect(result.local.hubAddress).toBe(hub.url);
+                expect(result.remote?.relayed).toBe(true);
+            }
+            finally {
+                await storeA.shutdown();
+                await storeB.shutdown();
+            }
+        }
+        finally {
+            await hub.close();
+        }
+    });
+});
+//# sourceMappingURL=mesh-graph-trace.integration.test.js.map

package/dist/test/mesh-graph-trace.integration.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-comms",
-  "version": "3.21.0",
+  "version": "3.23.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",
@@ -127,7 +127,7 @@
     "react": "19.3.0",
     "react-dom": "19.3.0",
     "typebox": "1.3.6",
-    "wire-mesh-core": "1.57.0",
+    "wire-mesh-core": "1.58.0",
     "ws": "8.21.1",
     "zod": "4.4.3"
   },