agent-comms 1.14.0 → 1.15.1

package/dist/bridges/user/web/frontend/relay-worker.js

@@ -0,0 +1,366 @@
+/**
+ * RelayWorker — SharedWorker that connects two mesh WebSocket endpoints
+ * and forwards wire messages between them with filtering and peer ID
+ * translation.
+ *
+ * Two isolated meshes can communicate through the browser without direct
+ * network connectivity between them. Peer IDs are prefixed with a mesh
+ * label ("a:" or "b:") to avoid collisions between the two meshes.
+ *
+ * Built as a separate IIFE bundle (relay-worker.js) so the SharedWorker
+ * runs in its own global scope independent of the main app and mesh-worker
+ * bundles.
+ */
+// ---------------------------------------------------------------------------
+// Relay state
+// ---------------------------------------------------------------------------
+/** Methods that should be forwarded between meshes. */
+const FORWARDABLE_METHODS = new Set([
+    "state_update",
+    "peer_joined",
+    "peer_left",
+]);
+/** Methods that must never be forwarded (cause loops or are side-specific). */
+const BLOCKED_METHODS = new Set([
+    "state_sync",
+    "introduce",
+    "connect_request",
+    "connect_accepted",
+    "connect_rejected",
+    "peer_list",
+    "become_coordinator",
+    "pong",
+    "fed_handshake",
+    "fed_ack",
+    "fed_agent_visible",
+    "fed_agent_gone",
+    "fed_room_message",
+    "fed_room_join",
+    "fed_room_leave",
+    "fed_ping",
+    "fed_pong",
+]);
+const meshA = {
+    label: "a",
+    url: "",
+    ws: undefined,
+    connected: false,
+    reconnectTimer: undefined,
+};
+const meshB = {
+    label: "b",
+    url: "",
+    ws: undefined,
+    connected: false,
+    reconnectTimer: undefined,
+};
+let forwardedCount = 0;
+const errors = [];
+const MAX_ERRORS = 50;
+const ports = new Set();
+// ---------------------------------------------------------------------------
+// Peer ID translation
+// ---------------------------------------------------------------------------
+function prefixId(label, id) {
+    return `${label}:${id}`;
+}
+function translateAgent(label, agent) {
+    return {
+        ...agent,
+        id: prefixId(label, agent.id),
+        name: `${agent.name} (via ${label.toUpperCase()})`,
+        subscribedRooms: agent.subscribedRooms.map((r) => prefixId(label, r)),
+    };
+}
+function translateRoom(label, room) {
+    return {
+        ...room,
+        id: prefixId(label, room.id),
+        owner: prefixId(label, room.owner),
+        members: room.members.map((m) => prefixId(label, m)),
+        invited: room.invited.map((m) => prefixId(label, m)),
+    };
+}
+function translateMessage(label, msg) {
+    const result = {
+        ...msg,
+        from: prefixId(label, msg.from),
+        room: prefixId(label, msg.room),
+        readBy: msg.readBy.map((r) => prefixId(label, r)),
+    };
+    if (msg.replyTo !== undefined)
+        result.replyTo = prefixId(label, msg.replyTo);
+    return result;
+}
+function translateDm(label, msg) {
+    return {
+        ...msg,
+        from: prefixId(label, msg.from),
+        to: prefixId(label, msg.to),
+        readBy: msg.readBy.map((r) => prefixId(label, r)),
+    };
+}
+function translateDmKey(label, key) {
+    // DM keys are "idA--idB" (sorted). Prefix both IDs.
+    const parts = key.split("--");
+    return parts.map((p) => prefixId(label, p)).join("--");
+}
+/**
+ * Translate a state_update patch, prefixing all peer/room IDs with the
+ * mesh label so they don't collide with IDs from the other mesh.
+ */
+function translatePatch(label, patch) {
+    switch (patch.type) {
+        case "agent_upsert":
+            return { ...patch, agent: translateAgent(label, patch.agent) };
+        case "agent_offline":
+            return { ...patch, agentId: prefixId(label, patch.agentId) };
+        case "room_upsert":
+            return { ...patch, room: translateRoom(label, patch.room) };
+        case "room_delete":
+            return { ...patch, roomId: prefixId(label, patch.roomId) };
+        case "message_add":
+            return {
+                ...patch,
+                roomId: prefixId(label, patch.roomId),
+                message: translateMessage(label, patch.message),
+            };
+        case "dm_add":
+            return {
+                ...patch,
+                key: translateDmKey(label, patch.key),
+                message: translateDm(label, patch.message),
+            };
+        case "delivery":
+            return { ...patch, agentId: prefixId(label, patch.agentId) };
+        case "message_read":
+            return {
+                ...patch,
+                readBy: prefixId(label, patch.readBy),
+                ...(patch.room ? { room: prefixId(label, patch.room) } : {}),
+            };
+    }
+}
+// ---------------------------------------------------------------------------
+// Wire message parsing
+// ---------------------------------------------------------------------------
+function parseWireMessage(raw) {
+    if (typeof raw !== "object" || raw === null)
+        return undefined;
+    if (!("method" in raw))
+        return undefined;
+    if (typeof raw.method !== "string")
+        return undefined;
+    // Spread into a new object to satisfy WireMessage — raw is narrowed to
+    // object & { method: string } but not to the WireMessage union
+    const msg = { ...raw, method: raw.method };
+    return msg;
+}
+// ---------------------------------------------------------------------------
+// Message forwarding
+// ---------------------------------------------------------------------------
+function shouldForward(msg) {
+    if (BLOCKED_METHODS.has(msg.method))
+        return false;
+    if (FORWARDABLE_METHODS.has(msg.method))
+        return true;
+    // Unknown methods are blocked by default
+    return false;
+}
+function translateWireMessage(label, msg) {
+    if (msg.method === "state_update" &&
+        "patch" in msg &&
+        typeof msg.patch === "object" &&
+        msg.patch !== null &&
+        "type" in msg.patch &&
+        typeof msg.patch.type === "string") {
+        // Patch validated as object with string `type` — cast to MeshStatePatch discriminated union
+        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+        const patch = msg.patch;
+        return { ...msg, patch: translatePatch(label, patch) };
+    }
+    if (msg.method === "peer_joined" &&
+        "peer" in msg &&
+        typeof msg.peer === "object" &&
+        msg.peer !== null &&
+        "id" in msg.peer &&
+        typeof msg.peer.id === "string" &&
+        "port" in msg.peer &&
+        typeof msg.peer.port === "number" &&
+        "startedAt" in msg.peer &&
+        typeof msg.peer.startedAt === "string") {
+        return {
+            ...msg,
+            peer: { ...msg.peer, id: prefixId(label, msg.peer.id) },
+        };
+    }
+    if (msg.method === "peer_left" &&
+        "peerId" in msg &&
+        typeof msg.peerId === "string") {
+        return { ...msg, peerId: prefixId(label, msg.peerId) };
+    }
+    return msg;
+}
+function forwardToTarget(source, target, raw) {
+    const msg = parseWireMessage(raw);
+    if (msg === undefined)
+        return;
+    if (!shouldForward(msg))
+        return;
+    const translated = translateWireMessage(source.label, msg);
+    const targetWs = target.ws;
+    if (targetWs?.readyState === WebSocket.OPEN) {
+        targetWs.send(JSON.stringify(translated));
+        forwardedCount++;
+        broadcastStatus();
+    }
+}
+// ---------------------------------------------------------------------------
+// WebSocket connection management
+// ---------------------------------------------------------------------------
+function connectMesh(conn, other) {
+    if (conn.reconnectTimer !== undefined) {
+        clearTimeout(conn.reconnectTimer);
+        conn.reconnectTimer = undefined;
+    }
+    const socket = new WebSocket(conn.url);
+    conn.ws = socket;
+    socket.onopen = () => {
+        conn.connected = true;
+        broadcastStatus();
+    };
+    socket.onclose = () => {
+        conn.ws = undefined;
+        conn.connected = false;
+        broadcastStatus();
+        scheduleReconnect(conn, other);
+    };
+    socket.onerror = () => {
+        // onclose fires after this
+    };
+    socket.onmessage = (event) => {
+        const raw = JSON.parse(typeof event.data === "string" ? event.data : String(event.data));
+        forwardToTarget(conn, other, raw);
+    };
+}
+function scheduleReconnect(conn, other) {
+    if (!conn.url)
+        return;
+    conn.reconnectTimer = setTimeout(() => {
+        if (conn.url)
+            connectMesh(conn, other);
+    }, 3000);
+}
+function disconnectMesh(conn) {
+    if (conn.reconnectTimer !== undefined) {
+        clearTimeout(conn.reconnectTimer);
+        conn.reconnectTimer = undefined;
+    }
+    conn.ws?.close();
+    conn.ws = undefined;
+    conn.connected = false;
+    conn.url = "";
+}
+// ---------------------------------------------------------------------------
+// Port management — fan-out to all connected main-thread tabs
+// ---------------------------------------------------------------------------
+function broadcastToPorts(msg) {
+    const data = JSON.stringify(msg);
+    for (const port of ports) {
+        try {
+            port.postMessage(data);
+        }
+        catch {
+            // Port closed
+        }
+    }
+}
+function broadcastStatus() {
+    broadcastToPorts({
+        type: "status",
+        status: getStatus(),
+    });
+}
+function getStatus() {
+    return {
+        connectedA: meshA.connected,
+        connectedB: meshB.connected,
+        urlA: meshA.url || undefined,
+        urlB: meshB.url || undefined,
+        forwardedCount,
+        errors: [...errors],
+    };
+}
+function addError(message) {
+    errors.push(message);
+    if (errors.length > MAX_ERRORS) {
+        errors.shift();
+    }
+}
+function handlePortMessage(msg) {
+    switch (msg.type) {
+        case "connect": {
+            // Disconnect existing connections
+            disconnectMesh(meshA);
+            disconnectMesh(meshB);
+            forwardedCount = 0;
+            errors.length = 0;
+            meshA.url = msg.urlA;
+            meshB.url = msg.urlB;
+            try {
+                connectMesh(meshA, meshB);
+                connectMesh(meshB, meshA);
+            }
+            catch (err) {
+                addError(err instanceof Error ? err.message : String(err));
+            }
+            broadcastStatus();
+            break;
+        }
+        case "disconnect": {
+            disconnectMesh(meshA);
+            disconnectMesh(meshB);
+            broadcastStatus();
+            break;
+        }
+        case "status":
+            broadcastStatus();
+            break;
+    }
+}
+function isRelayInbound(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    if (!("type" in value))
+        return false;
+    const t = value.type;
+    return (typeof t === "string" &&
+        (t === "connect" || t === "disconnect" || t === "status"));
+}
+// ---------------------------------------------------------------------------
+// Entry point — listen for SharedWorker connections
+// ---------------------------------------------------------------------------
+self.addEventListener("connect", (event) => {
+    const rawPort = event.ports[0];
+    if (rawPort === undefined)
+        return;
+    ports.add(rawPort);
+    // Send current status to the new port
+    try {
+        rawPort.postMessage(JSON.stringify({
+            type: "status",
+            status: getStatus(),
+        }));
+    }
+    catch {
+        // Port not ready yet
+    }
+    rawPort.onmessage = (e) => {
+        const parsed = JSON.parse(typeof e.data === "string" ? e.data : String(e.data));
+        if (isRelayInbound(parsed)) {
+            handlePortMessage(parsed);
+        }
+    };
+});
+export {};
+//# sourceMappingURL=relay-worker.js.map

package/dist/bridges/user/web/frontend/relay-worker.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * Service worker for the Agent Comms PWA.
+ *
+ * Handles push events from the browser push service and displays
+ * notifications. On notification click, focuses or opens the PWA window.
+ *
+ * Also provides offline caching:
+ * - Install: pre-caches the app shell (HTML, JS, manifest, icons).
+ * - Fetch:  network-first for API calls, cache-first for static assets.
+ * - Activate: removes old caches when the SW version changes.
+ *
+ * This file is built as a separate bundle (not part of the main app bundle)
+ * because service workers run in a separate context with no DOM access.
+ */
+export {};
+//# sourceMappingURL=sw.d.ts.map

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

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

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

@@ -0,0 +1,145 @@
+/**
+ * Service worker for the Agent Comms PWA.
+ *
+ * Handles push events from the browser push service and displays
+ * notifications. On notification click, focuses or opens the PWA window.
+ *
+ * Also provides offline caching:
+ * - Install: pre-caches the app shell (HTML, JS, manifest, icons).
+ * - Fetch:  network-first for API calls, cache-first for static assets.
+ * - Activate: removes old caches when the SW version changes.
+ *
+ * This file is built as a separate bundle (not part of the main app bundle)
+ * because service workers run in a separate context with no DOM access.
+ */
+// ---------------------------------------------------------------------------
+// Cache versioning — bump to invalidate old caches on deploy
+// ---------------------------------------------------------------------------
+const CACHE_NAME = "agent-comms-v1";
+const APP_SHELL = [
+    "./",
+    "./bundle.js",
+    "./sw.js",
+    "./manifest.json",
+    "./icons/icon-96x96.svg",
+    "./icons/icon-192x192.svg",
+    "./icons/icon-512x512.svg",
+];
+// ---------------------------------------------------------------------------
+// Install — pre-cache the app shell
+// ---------------------------------------------------------------------------
+self.addEventListener("install", (event) => {
+    event.waitUntil(self.caches
+        .open(CACHE_NAME)
+        .then((cache) => cache.addAll(APP_SHELL))
+        .then(() => self.skipWaiting()));
+});
+// ---------------------------------------------------------------------------
+// Activate — remove old caches
+// ---------------------------------------------------------------------------
+self.addEventListener("activate", (event) => {
+    event.waitUntil(self.caches
+        .keys()
+        .then((names) => Promise.all(names
+        .filter((name) => name !== CACHE_NAME)
+        .map((name) => self.caches.delete(name)))));
+});
+// ---------------------------------------------------------------------------
+// Fetch — network-first for API, cache-first for everything else
+// ---------------------------------------------------------------------------
+self.addEventListener("fetch", (event) => {
+    const url = new URL(event.request.url);
+    // API calls: network-first so stale data doesn't linger
+    if (url.pathname.startsWith("/api/")) {
+        event.respondWith(fetch(event.request)
+            .then((response) => {
+            // Only cache successful GET responses
+            if (event.request.method === "GET" &&
+                response.status >= 200 &&
+                response.status < 300) {
+                const cloned = response.clone();
+                void self.caches
+                    .open(CACHE_NAME)
+                    .then((cache) => cache.put(event.request, cloned));
+            }
+            return response;
+        })
+            .catch(() => self.caches
+            .open(CACHE_NAME)
+            .then((cache) => cache.match(event.request))
+            .then((cached) => cached ?? new Response("Offline", { status: 503 }))));
+        return;
+    }
+    // Static assets: cache-first
+    event.respondWith(self.caches
+        .open(CACHE_NAME)
+        .then((cache) => cache.match(event.request))
+        .then((cached) => {
+        if (cached)
+            return cached;
+        return fetch(event.request).then((response) => {
+            // Cache successful GET responses for future offline use
+            if (event.request.method === "GET" &&
+                response.status >= 200 &&
+                response.status < 300) {
+                const cloned = response.clone();
+                void self.caches
+                    .open(CACHE_NAME)
+                    .then((cache) => cache.put(event.request, cloned));
+            }
+            return response;
+        });
+    }));
+});
+// ---------------------------------------------------------------------------
+// Push event handler
+// ---------------------------------------------------------------------------
+self.addEventListener("push", (event) => {
+    let title = "Agent Comms";
+    let body = "New message";
+    if (event.data) {
+        try {
+            const data = event.data.json();
+            if (typeof data.title === "string")
+                title = data.title;
+            if (typeof data.body === "string")
+                body = data.body;
+        }
+        catch {
+            const text = event.data.text();
+            if (text)
+                body = text;
+        }
+    }
+    event.waitUntil(self.registration.showNotification(title, {
+        body,
+        data: {
+            url: self.location.origin,
+        },
+    }));
+});
+// ---------------------------------------------------------------------------
+// Notification click handler
+// ---------------------------------------------------------------------------
+self.addEventListener("notificationclick", (event) => {
+    event.notification.close();
+    const notificationData = event.notification.data;
+    const targetUrl = typeof notificationData === "object" &&
+        notificationData !== null &&
+        "url" in notificationData &&
+        typeof notificationData.url === "string"
+        ? notificationData.url
+        : self.location.origin;
+    event.waitUntil(self.clients
+        .matchAll({ type: "window", includeUncontrolled: true })
+        .then((clientList) => {
+        for (const client of clientList) {
+            if (client.url === targetUrl && "focus" in client) {
+                return client.focus();
+            }
+        }
+        return self.clients.openWindow(targetUrl);
+    }));
+});
+export {};
+//# sourceMappingURL=sw.js.map

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

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

package/dist/bridges/user/web/frontend/url-sync.d.ts

@@ -0,0 +1,48 @@
+/**
+ * URL query parameter sync — deep-linking for rooms, DMs, and project rooms.
+ *
+ * Supported parameters (mutually exclusive, first match wins):
+ *   ?room=<roomId>   — join a room by ID
+ *   ?dm=<agentId>    — open a DM conversation with an agent
+ *   ?cwd=<path>      — find the project room for a working directory and join it
+ *
+ * The URL bar updates on every navigation (room join, agent select, leave)
+ * so the current view is always shareable. Uses replaceState to avoid
+ * polluting browser history.
+ */
+import type { Room } from "./types.js";
+export interface NavTarget {
+    kind: "room";
+    roomId: string;
+}
+export interface NavTargetDm {
+    kind: "dm";
+    agentId: string;
+}
+export interface NavTargetCwd {
+    kind: "cwd";
+    path: string;
+}
+export type DeepLink = NavTarget | NavTargetDm | NavTargetCwd;
+/**
+ * Parse query parameters into a deep link target.
+ * Returns undefined if no recognised parameter is present.
+ */
+export declare function parseDeepLink(search: string): DeepLink | undefined;
+export interface ResolvedNav {
+    kind: "room" | "dm";
+    targetId: string;
+}
+/**
+ * Resolve a deep link against the current rooms list.
+ *
+ * - room → direct match by ID
+ * - dm   → direct match by agent ID
+ * - cwd  → find a project room whose description is "Project room for <path>"
+ */
+export declare function resolveDeepLink(link: DeepLink, rooms: Room[]): ResolvedNav | undefined;
+export declare function syncUrl(params: {
+    currentRoom: string | undefined;
+    dmTarget: string | undefined;
+}): void;
+//# sourceMappingURL=url-sync.d.ts.map

package/dist/bridges/user/web/frontend/url-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-sync.d.ts","sourceRoot":"","sources":["../../../../../src/bridges/user/web/frontend/url-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;AAI9D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAalE;AAMD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,IAAI,EAAE,GACZ,WAAW,GAAG,SAAS,CAqBzB;AAMD,wBAAgB,OAAO,CAAC,MAAM,EAAE;IAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,GAAG,IAAI,CAgBP"}