agent-comms 1.13.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.13.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",
@@ -50,7 +50,10 @@
     "generate:server-json": "tsx scripts/sync-release-metadata.ts",
     "publish:mcp-registry": "tsx scripts/publish-mcp-registry.ts",
     "lint": "eslint .",
-    "test": "node --test dist/test/**/*.test.js",
+    "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"
@@ -89,6 +92,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.28.0",
+    "preact": "10.27.0",
     "typebox": "1.1.28",
     "ws": "8.20.0",
     "zod": "4.3.6"
@@ -100,7 +104,7 @@
   },
   "pi": {
     "extensions": [
-      "./dist/bridges/pi"
+      "./src/bridges/pi/index.ts"
     ]
   }
 }

package/dist/bridges/user/web/frontend/render.d.ts

@@ -1,30 +0,0 @@
-/**
- * Render functions — pure DOM construction from state and data.
- *
- * Every function takes a document (or element) and data, returns DOM nodes.
- * No side effects, no global state. Testable with jsdom.
- */
-import type { Agent, DeliveryEvent, Room, RoomMessage } from "./types.js";
-export interface MessageTarget {
-    messagesEl: HTMLElement;
-}
-export declare function renderChatMessage(doc: Document, target: MessageTarget, sender: string, content: string, timestamp: string): void;
-export declare function renderDmMessage(doc: Document, target: MessageTarget, sender: string, content: string, timestamp: string): void;
-export declare function renderSystemMessage(doc: Document, target: MessageTarget, text: string): void;
-export declare function renderStatusMessage(doc: Document, target: MessageTarget, text: string): void;
-export declare function clearMessages(target: MessageTarget): void;
-export declare function renderDeliveryEvent(doc: Document, target: MessageTarget, event: DeliveryEvent, currentRoom: string | undefined): void;
-export interface SidebarTarget {
-    roomListEl: HTMLElement;
-    agentListEl: HTMLElement;
-}
-export type RoomAction = (roomId: string) => void | Promise<void>;
-export declare function renderRoomList(doc: Document, target: SidebarTarget, rooms: Room[], currentRoom: string | undefined, onJoin: RoomAction): void;
-export type AgentSelectAction = (agentId: string) => void;
-export declare function renderAgentList(doc: Document, target: SidebarTarget, agents: Agent[], onSelect?: AgentSelectAction): void;
-export interface HeaderTarget {
-    headerEl: HTMLElement;
-}
-export declare function renderHeader(target: HeaderTarget, text: string): void;
-export declare function renderMessageHistory(doc: Document, target: MessageTarget, messages: RoomMessage[]): void;
-//# sourceMappingURL=render.d.ts.map

package/dist/bridges/user/web/frontend/render.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../../src/bridges/user/web/frontend/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO1E,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,WAAW,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,IAAI,CAON;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,IAAI,CAON;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,GACX,IAAI,CAMN;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,GACX,IAAI,CAMN;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAEzD;AAMD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,IAAI,CA2EN;AAMD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,WAAW,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElE,wBAAgB,cAAc,CAC5B,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,IAAI,EAAE,EACb,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE,UAAU,GACjB,IAAI,CAgBN;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAE1D,wBAAgB,eAAe,CAC7B,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,IAAI,CAqBN;AAMD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAErE;AAMD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,WAAW,EAAE,GACtB,IAAI,CAIN"}

package/dist/bridges/user/web/frontend/render.js

@@ -1,129 +0,0 @@
-/**
- * Render functions — pure DOM construction from state and data.
- *
- * Every function takes a document (or element) and data, returns DOM nodes.
- * No side effects, no global state. Testable with jsdom.
- */
-import { clearChildren, createElement, escapeHtml, formatTime } from "./dom.js";
-export function renderChatMessage(doc, target, sender, content, timestamp) {
-    const time = formatTime(timestamp);
-    const div = doc.createElement("div");
-    div.className = "msg";
-    div.innerHTML = `<span class="sender">${escapeHtml(doc, sender)}</span><span class="time">${time}</span>: ${escapeHtml(doc, content)}`;
-    target.messagesEl.appendChild(div);
-    target.messagesEl.scrollTop = target.messagesEl.scrollHeight;
-}
-export function renderDmMessage(doc, target, sender, content, timestamp) {
-    const time = formatTime(timestamp);
-    const div = doc.createElement("div");
-    div.className = "msg dm";
-    div.innerHTML = `<span class="dm-badge">DM</span> <span class="sender">${escapeHtml(doc, sender)}</span><span class="time">${time}</span>: ${escapeHtml(doc, content)}`;
-    target.messagesEl.appendChild(div);
-    target.messagesEl.scrollTop = target.messagesEl.scrollHeight;
-}
-export function renderSystemMessage(doc, target, text) {
-    const div = doc.createElement("div");
-    div.className = "msg system";
-    div.textContent = text;
-    target.messagesEl.appendChild(div);
-    target.messagesEl.scrollTop = target.messagesEl.scrollHeight;
-}
-export function renderStatusMessage(doc, target, text) {
-    const div = doc.createElement("div");
-    div.className = "msg status";
-    div.textContent = text;
-    target.messagesEl.appendChild(div);
-    target.messagesEl.scrollTop = target.messagesEl.scrollHeight;
-}
-export function clearMessages(target) {
-    clearChildren(target.messagesEl);
-}
-// ---------------------------------------------------------------------------
-// Delivery event rendering
-// ---------------------------------------------------------------------------
-export function renderDeliveryEvent(doc, target, event, currentRoom) {
-    switch (event.type) {
-        case "room_message":
-            if (currentRoom === event.message.room) {
-                renderChatMessage(doc, target, event.message.from, event.message.content, event.message.timestamp);
-            }
-            break;
-        case "dm":
-            renderDmMessage(doc, target, event.message.from, event.message.content, event.message.timestamp);
-            break;
-        case "member_joined":
-            renderSystemMessage(doc, target, `${event.agent} joined ${event.room}`);
-            break;
-        case "member_left":
-            renderSystemMessage(doc, target, `${event.agent} left ${event.room}`);
-            break;
-        case "member_status":
-            renderStatusMessage(doc, target, `${event.agent} is now ${event.status} in ${event.room}`);
-            break;
-        case "delivery_status":
-            renderStatusMessage(doc, target, `Message ${event.messageId} ${event.status} by ${event.agent}`);
-            break;
-        case "room_members":
-            if (currentRoom === event.room) {
-                const memberList = event.members
-                    .map((m) => `${m.name} (${m.status})`)
-                    .join(", ");
-                renderSystemMessage(doc, target, `Members: ${memberList}`);
-            }
-            break;
-        case "room_invite": {
-            const desc = event.roomDescription ? ` — ${event.roomDescription}` : "";
-            renderSystemMessage(doc, target, `${event.fromName} invited you to "${event.room}"${desc}`);
-            break;
-        }
-        case "invite_declined":
-            renderSystemMessage(doc, target, `${event.agentName} declined invite to ${event.room}: "${event.reason}"`);
-            break;
-    }
-}
-export function renderRoomList(doc, target, rooms, currentRoom, onJoin) {
-    clearChildren(target.roomListEl);
-    for (const room of rooms) {
-        const isActive = currentRoom === room.id;
-        const typeIndicator = room.type.charAt(0).toUpperCase();
-        const memberCount = room.members.length;
-        const div = doc.createElement("div");
-        div.className = `room-item${isActive ? " active" : ""}`;
-        div.innerHTML = `${typeIndicator} ${escapeHtml(doc, room.name)} <span style="color:var(--dim)">(${String(memberCount)})</span>`;
-        div.onclick = () => {
-            void onJoin(room.id);
-        };
-        target.roomListEl.appendChild(div);
-    }
-}
-export function renderAgentList(doc, target, agents, onSelect) {
-    clearChildren(target.agentListEl);
-    for (const agent of agents) {
-        const div = doc.createElement("div");
-        div.className = "agent-item";
-        const dot = createElement(doc, "span", {
-            class: `status-dot ${agent.status}`,
-        });
-        const name = doc.createTextNode(` ${agent.name}`);
-        div.appendChild(dot);
-        div.appendChild(name);
-        if (onSelect) {
-            div.onclick = () => {
-                onSelect(agent.id);
-            };
-        }
-        target.agentListEl.appendChild(div);
-    }
-}
-export function renderHeader(target, text) {
-    target.headerEl.textContent = text;
-}
-// ---------------------------------------------------------------------------
-// Room history (batch load)
-// ---------------------------------------------------------------------------
-export function renderMessageHistory(doc, target, messages) {
-    for (const m of messages) {
-        renderChatMessage(doc, target, m.from, m.content, m.timestamp);
-    }
-}
-//# sourceMappingURL=render.js.map

package/dist/bridges/user/web/frontend/render.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../../src/bridges/user/web/frontend/render.ts"],"names":[],"mappings":"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"}

package/dist/bridges/user/web/frontend/test/dom.unit.test.d.ts

@@ -1,5 +0,0 @@
-/**
- * Unit tests for dom.ts — DOM helper functions.
- */
-export {};
-//# sourceMappingURL=dom.unit.test.d.ts.map

package/dist/bridges/user/web/frontend/test/dom.unit.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom.unit.test.d.ts","sourceRoot":"","sources":["../../../../../../src/bridges/user/web/frontend/test/dom.unit.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}