agent-comms 1.14.0 → 1.15.0

package/dist/test/tls-transport.integration.test.js

@@ -0,0 +1,158 @@
+/**
+ * TlsTransport integration test — verifies that two MeshStore instances
+ * can communicate over TLS with certificate pinning.
+ *
+ * Run: node dist/test/tls-transport.integration.test.js
+ */
+import * as net from "node:net";
+import * as assert from "node:assert/strict";
+import { MeshStore } from "../core/mesh-store.js";
+import { TlsTransport } from "../core/tls-transport.js";
+import { generateIdentity } from "../core/identity.js";
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function allocFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            const port = addr && typeof addr === "object" ? addr.port : 0;
+            server.close(() => resolve(port));
+        });
+        server.on("error", reject);
+    });
+}
+async function cleanup(...stores) {
+    for (const s of stores) {
+        await s.shutdown();
+    }
+}
+async function testTlsPeerCommunication() {
+    const port = await allocFreePort();
+    const identityA = generateIdentity();
+    const identityB = generateIdentity();
+    // Verify identities are different
+    assert.notStrictEqual(identityA.fingerprint, identityB.fingerprint);
+    console.log("  Identity A:", identityA.fingerprint.substring(0, 23) + "...");
+    console.log("  Identity B:", identityB.fingerprint.substring(0, 23) + "...");
+    // Create stores with TLS transport
+    const storeA = new MeshStore(port);
+    storeA.peerId = identityA.fingerprint;
+    storeA.setTransport(new TlsTransport(storeA.events, identityA));
+    const deliveriesA = [];
+    storeA.onDelivery = () => {
+        deliveriesA.push(1);
+    };
+    await storeA.init();
+    await storeA.registerAgent({
+        name: "a",
+        harness: "test",
+        cwd: "/test/a",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    await sleep(100);
+    const storeB = new MeshStore(port);
+    storeB.peerId = identityB.fingerprint;
+    storeB.setTransport(new TlsTransport(storeB.events, identityB));
+    const deliveriesB = [];
+    storeB.onDelivery = (_id, ev) => {
+        deliveriesB.push(ev);
+    };
+    await storeB.init();
+    await storeB.registerAgent({
+        name: "b",
+        harness: "test",
+        cwd: "/test/b",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    await sleep(300);
+    // Create room and exchange messages
+    const room = await storeA.createRoom({
+        name: `tls-test-${port}`,
+        type: "public",
+        owner: storeA.peerId,
+        description: "TLS transport test",
+    });
+    await sleep(200);
+    await storeB.joinRoom(room.id, storeB.peerId);
+    await sleep(200);
+    deliveriesB.length = 0;
+    await storeA.sendRoomMessage(room.id, storeA.peerId, "Hello over TLS!");
+    await sleep(300);
+    assert.ok(deliveriesB.length >= 1, `B should receive at least 1 delivery, got ${String(deliveriesB.length)}`);
+    const roomMsg = deliveriesB.find((ev) => ev.type === "room_message");
+    assert.ok(roomMsg !== undefined, "Should find room_message event");
+    const message = roomMsg.message;
+    assert.strictEqual(message.content, "Hello over TLS!");
+    assert.strictEqual(message.from, identityA.fingerprint);
+    console.log("  ✓ Room message received over TLS");
+    // Test DM
+    deliveriesB.length = 0;
+    await storeA.sendDm(storeA.peerId, storeB.peerId, "Direct over TLS!");
+    await sleep(300);
+    const dm = deliveriesB.find((ev) => ev.type === "dm");
+    assert.ok(dm !== undefined, "Should find dm event");
+    const dmMessage = dm.message;
+    assert.strictEqual(dmMessage.content, "Direct over TLS!");
+    assert.strictEqual(dmMessage.from, identityA.fingerprint);
+    console.log("  ✓ DM received over TLS");
+    await cleanup(storeA, storeB);
+}
+async function testFingerprintIsPeerId() {
+    const identity = generateIdentity();
+    const port = await allocFreePort();
+    const store = new MeshStore(port);
+    store.peerId = identity.fingerprint;
+    store.setTransport(new TlsTransport(store.events, identity));
+    await store.init();
+    const agent = await store.registerAgent({
+        name: "fp-test",
+        harness: "test",
+        cwd: "/test/fp",
+        pid: process.pid,
+        visibility: "visible",
+        tags: [],
+    });
+    // The agent ID should be the certificate fingerprint
+    assert.strictEqual(agent.id, identity.fingerprint);
+    console.log("  ✓ Peer ID equals certificate fingerprint");
+    await store.shutdown();
+}
+// ---------------------------------------------------------------------------
+// Runner
+// ---------------------------------------------------------------------------
+const testName = process.argv[2];
+if (testName === undefined) {
+    console.error("Usage: node tls-transport.integration.test.ts <test-name>");
+    process.exit(1);
+}
+const tests = {
+    "tls-communication": testTlsPeerCommunication,
+    "tls-fingerprint": testFingerprintIsPeerId,
+};
+const fn = tests[testName];
+if (!fn) {
+    console.error(`Unknown test: ${testName}`);
+    console.error(`Available: ${Object.keys(tests).join(", ")}`);
+    process.exit(1);
+}
+fn()
+    .then(async () => {
+    const maxWait = 2000;
+    const start = Date.now();
+    while ((process._getActiveHandles?.()?.length ?? 0) > 0 &&
+        Date.now() - start < maxWait) {
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    process.exit(0);
+})
+    .catch((err) => {
+    console.error(`FAIL [${testName}]:`, err);
+    process.exit(1);
+});
+//# sourceMappingURL=tls-transport.integration.test.js.map

package/dist/test/tls-transport.integration.test.js.map

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

package/dist/test/visibility.integration.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Integration tests for mesh visibility controls.
+ *
+ * Verifies that the DiscoveryManager visibility state machine works:
+ *   - Default visibility is discoverable
+ *   - Setting to quiet pauses advertising
+ *   - Setting to dark stops all discovery
+ *   - Per-adapter visibility overrides global
+ *   - Actions route through CommsTool correctly
+ */
+export {};
+//# sourceMappingURL=visibility.integration.test.d.ts.map

package/dist/test/visibility.integration.test.d.ts.map

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

package/dist/test/visibility.integration.test.js

@@ -0,0 +1,181 @@
+/**
+ * Integration tests for mesh visibility controls.
+ *
+ * Verifies that the DiscoveryManager visibility state machine works:
+ *   - Default visibility is discoverable
+ *   - Setting to quiet pauses advertising
+ *   - Setting to dark stops all discovery
+ *   - Per-adapter visibility overrides global
+ *   - Actions route through CommsTool correctly
+ */
+import * as assert from "node:assert/strict";
+import { test, describe } from "node:test";
+import { MeshStore } from "../core/mesh-store.js";
+import { CommsTool } from "../core/tool.js";
+import { buildAction } from "../core/bridge.js";
+import { DiscoveryManager } from "../core/discovery.js";
+const TEST_PORT = 19881;
+// ---------------------------------------------------------------------------
+// DiscoveryManager unit tests (no mesh init)
+// ---------------------------------------------------------------------------
+describe("DiscoveryManager visibility", () => {
+    void test("default visibility is discoverable", () => {
+        const dm = new DiscoveryManager();
+        assert.equal(dm.getVisibility(), "discoverable");
+    });
+    void test("setVisibility changes global visibility", async () => {
+        const dm = new DiscoveryManager();
+        await dm.setVisibility("quiet");
+        assert.equal(dm.getVisibility(), "quiet");
+        await dm.setVisibility("dark");
+        assert.equal(dm.getVisibility(), "dark");
+        await dm.setVisibility("discoverable");
+        assert.equal(dm.getVisibility(), "discoverable");
+    });
+    void test("per-adapter visibility overrides global", async () => {
+        const dm = new DiscoveryManager();
+        await dm.setVisibility("quiet", "mdns");
+        assert.equal(dm.getVisibility("mdns"), "quiet");
+        // Global unchanged
+        assert.equal(dm.getVisibility(), "discoverable");
+        // Unset adapter falls back to global
+        assert.equal(dm.getVisibility("tailscale"), "discoverable");
+    });
+    void test("per-adapter visibility is independent", async () => {
+        const dm = new DiscoveryManager();
+        await dm.setVisibility("quiet", "mdns");
+        await dm.setVisibility("dark", "tailscale");
+        assert.equal(dm.getVisibility("mdns"), "quiet");
+        assert.equal(dm.getVisibility("tailscale"), "dark");
+        assert.equal(dm.getVisibility(), "discoverable");
+    });
+    void test("discover returns empty for dark backends", async () => {
+        const dm = new DiscoveryManager();
+        await dm.setVisibility("dark");
+        const results = await dm.discover();
+        assert.equal(results.length, 0);
+    });
+});
+// ---------------------------------------------------------------------------
+// MeshStore delegation
+// ---------------------------------------------------------------------------
+describe("MeshStore visibility delegation", () => {
+    void test("setVisibility delegates to discovery manager", async () => {
+        const store = new MeshStore(TEST_PORT);
+        await store.init();
+        assert.equal(store.getVisibility(), "discoverable");
+        await store.setVisibility("quiet");
+        assert.equal(store.getVisibility(), "quiet");
+        await store.setVisibility("dark");
+        assert.equal(store.getVisibility(), "dark");
+        await store.setVisibility("discoverable");
+        assert.equal(store.getVisibility(), "discoverable");
+        await store.shutdown();
+    });
+    void test("setVisibility with adapter delegates per-adapter", async () => {
+        const store = new MeshStore(TEST_PORT);
+        await store.init();
+        await store.setVisibility("quiet", "mdns");
+        assert.equal(store.getVisibility("mdns"), "quiet");
+        assert.equal(store.getVisibility(), "discoverable");
+        await store.shutdown();
+    });
+});
+// ---------------------------------------------------------------------------
+// CommsTool actions
+// ---------------------------------------------------------------------------
+describe("CommsTool visibility actions", () => {
+    void test("mesh_set_visibility action sets visibility", async () => {
+        const store = new MeshStore(TEST_PORT);
+        await store.init();
+        const agent = await store.registerAgent({
+            name: "visibility-test",
+            harness: "test",
+            cwd: "/test",
+            pid: process.pid,
+            visibility: "visible",
+            tags: [],
+        });
+        const tool = new CommsTool(store);
+        const result = await tool.handle({ agentId: agent.id, harness: "test", cwd: "/test", pid: process.pid }, { action: "mesh_set_visibility", visibility: "quiet" });
+        assert.ok(!result.isError, `Expected success, got: ${result.content}`);
+        assert.ok(result.content.includes("quiet"));
+        assert.equal(store.getVisibility(), "quiet");
+        await store.shutdown();
+    });
+    void test("mesh_set_visibility with adapter sets per-adapter", async () => {
+        const store = new MeshStore(TEST_PORT);
+        await store.init();
+        const agent = await store.registerAgent({
+            name: "visibility-test",
+            harness: "test",
+            cwd: "/test",
+            pid: process.pid,
+            visibility: "visible",
+            tags: [],
+        });
+        const tool = new CommsTool(store);
+        const result = await tool.handle({ agentId: agent.id, harness: "test", cwd: "/test", pid: process.pid }, { action: "mesh_set_visibility", visibility: "dark", adapter: "mdns" });
+        assert.ok(!result.isError, `Expected success, got: ${result.content}`);
+        assert.equal(store.getVisibility("mdns"), "dark");
+        assert.equal(store.getVisibility(), "discoverable");
+        await store.shutdown();
+    });
+    void test("mesh_get_visibility returns current visibility", async () => {
+        const store = new MeshStore(TEST_PORT);
+        await store.init();
+        const agent = await store.registerAgent({
+            name: "visibility-test",
+            harness: "test",
+            cwd: "/test",
+            pid: process.pid,
+            visibility: "visible",
+            tags: [],
+        });
+        const tool = new CommsTool(store);
+        const result = await tool.handle({ agentId: agent.id, harness: "test", cwd: "/test", pid: process.pid }, { action: "mesh_get_visibility" });
+        assert.ok(!result.isError);
+        assert.ok(result.content.includes("discoverable"));
+        await store.setVisibility("dark");
+        const result2 = await tool.handle({ agentId: agent.id, harness: "test", cwd: "/test", pid: process.pid }, { action: "mesh_get_visibility" });
+        assert.ok(result2.content.includes("dark"));
+        await store.shutdown();
+    });
+});
+// ---------------------------------------------------------------------------
+// buildAction parsing
+// ---------------------------------------------------------------------------
+describe("buildAction visibility parsing", () => {
+    void test("buildAction parses mesh_set_visibility", () => {
+        const action = buildAction({
+            action: "mesh_set_visibility",
+            meshVisibility: "quiet",
+        });
+        assert.equal(action.action, "mesh_set_visibility");
+        if (action.action === "mesh_set_visibility") {
+            assert.equal(action.visibility, "quiet");
+        }
+    });
+    void test("buildAction parses mesh_set_visibility with adapter", () => {
+        const action = buildAction({
+            action: "mesh_set_visibility",
+            meshVisibility: "dark",
+            adapter: "mdns",
+        });
+        assert.equal(action.action, "mesh_set_visibility");
+        if (action.action === "mesh_set_visibility") {
+            assert.equal(action.visibility, "dark");
+            assert.equal(action.adapter, "mdns");
+        }
+    });
+    void test("buildAction parses mesh_get_visibility", () => {
+        const action = buildAction({
+            action: "mesh_get_visibility",
+        });
+        assert.equal(action.action, "mesh_get_visibility");
+    });
+    void test("buildAction throws for mesh_set_visibility without meshVisibility", () => {
+        assert.throws(() => buildAction({ action: "mesh_set_visibility" }), /meshVisibility/);
+    });
+});
+//# sourceMappingURL=visibility.integration.test.js.map

package/dist/test/visibility.integration.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-comms",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "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",
@@ -51,6 +51,9 @@
     "publish:mcp-registry": "tsx scripts/publish-mcp-registry.ts",
     "lint": "eslint .",
     "test": "node --test dist/test/coordinator-socket-error.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",
     "test:frontend": "tsx --test src/bridges/user/web/frontend/test/**/*.unit.test.ts",
     "test:e2e": "playwright test",
     "typecheck": "tsc --noEmit"