agent-comms 3.21.0 → 3.22.0

package/.claude-plugin/marketplace.json

@@ -15,7 +15,7 @@
         "url": "https://github.com/ExaDev/agent-comms.git"
       },
       "description": "Cross-harness LLM agent communication mesh — rooms, DMs, and presence",
-      "version": "3.21.0"
+      "version": "3.22.0"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-comms",
   "description": "Cross-harness LLM agent communication mesh — rooms, DMs, and presence",
-  "version": "3.21.0",
+  "version": "3.22.0",
   "author": {
     "name": "ExaDev"
   },

package/README.md

@@ -2,7 +2,7 @@
 
 [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://github.com/ExaDev/agent-comms)
 [![npm](https://img.shields.io/badge/npm-CB3837?logo=npm&logoColor=white)](https://www.npmjs.com/package/agent-comms)
-[![version](https://img.shields.io/badge/version-3.21.0-blue)](https://github.com/ExaDev/agent-comms/releases/tag/v3.21.0)
+[![version](https://img.shields.io/badge/version-3.22.0-blue)](https://github.com/ExaDev/agent-comms/releases/tag/v3.22.0)
 [![CI](https://img.shields.io/github/actions/workflow/status/ExaDev/agent-comms/ci.yml?branch=main)](https://github.com/ExaDev/agent-comms/actions)
 
 Cross-harness communication mesh for LLM agents: rooms, DMs, presence, and visibility over TCP with zero filesystem dependencies.

package/dist/bridges/user/web/actions.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Plain action functions -- one per browser-facing action, extracted from server.ts's executeAction switch so both the legacy /api/action REST dispatcher and the new oRPC router call the same implementation instead of two copies drifting apart.
+ *
+ * Each function preserves executeAction's exact prior validation behaviour (empty string treated the same as missing) even though the oRPC contract's own Zod schemas already enforce presence and type -- the contract validates shape, these functions still validate the same business rules the REST path has always enforced.
+ */
+import type { PushManager } from "../../../core/push-manager.js";
+import type { ChatController } from "../controller.js";
+import type { ActionResult } from "./contract.js";
+export declare function sendAction(controller: ChatController, input: Readonly<{
+    target: string;
+    content: string;
+}>): Promise<ActionResult>;
+export declare function dmAction(controller: ChatController, input: Readonly<{
+    target: string;
+    content: string;
+}>): Promise<ActionResult>;
+export declare function joinRoomAction(controller: ChatController, input: Readonly<{
+    room: string;
+}>): Promise<ActionResult>;
+export declare function leaveRoomAction(controller: ChatController, input: Readonly<{
+    room?: string | undefined;
+}>): Promise<ActionResult>;
+export declare function createRoomAction(controller: ChatController, input: Readonly<{
+    name: string;
+    type: "public" | "private" | "secret";
+    description?: string | undefined;
+}>): Promise<ActionResult>;
+export declare function listRoomsAction(controller: ChatController): Promise<ActionResult>;
+export declare function listAgentsAction(controller: ChatController): Promise<ActionResult>;
+export declare function readRoomAction(controller: ChatController, input: Readonly<{
+    room?: string | undefined;
+}>): Promise<ActionResult>;
+export declare function destroyRoomAction(controller: ChatController, input: Readonly<{
+    room: string;
+}>): Promise<ActionResult>;
+export declare function inviteAction(controller: ChatController, input: Readonly<{
+    room: string;
+    agent: string;
+}>): Promise<ActionResult>;
+export declare function declineInviteAction(controller: ChatController, input: Readonly<{
+    room: string;
+    reason: string;
+}>): Promise<ActionResult>;
+export declare function kickAction(controller: ChatController, input: Readonly<{
+    room: string;
+    agent: string;
+}>): Promise<ActionResult>;
+export declare function renameAgentAction(controller: ChatController, input: Readonly<{
+    agent: string;
+    name: string;
+}>): Promise<ActionResult>;
+export declare function pushSubscribeAction(controller: ChatController, pushManager: PushManager | undefined, input: Readonly<{
+    subscription: unknown;
+    agentId?: string | undefined;
+}>): ActionResult;
+export declare function pushUnsubscribeAction(controller: ChatController, pushManager: PushManager | undefined, input: Readonly<{
+    agentId?: string | undefined;
+}>): ActionResult;
+//# sourceMappingURL=actions.d.ts.map

package/dist/bridges/user/web/actions.d.ts.map

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

package/dist/bridges/user/web/actions.js

@@ -0,0 +1,109 @@
+/**
+ * Plain action functions -- one per browser-facing action, extracted from server.ts's executeAction switch so both the legacy /api/action REST dispatcher and the new oRPC router call the same implementation instead of two copies drifting apart.
+ *
+ * Each function preserves executeAction's exact prior validation behaviour (empty string treated the same as missing) even though the oRPC contract's own Zod schemas already enforce presence and type -- the contract validates shape, these functions still validate the same business rules the REST path has always enforced.
+ */
+export async function sendAction(controller, input) {
+    if (input.target === "" || input.content === "") {
+        return { content: "Missing target or content", isError: true };
+    }
+    return controller.send(input.target, input.content);
+}
+export async function dmAction(controller, input) {
+    if (input.target === "" || input.content === "") {
+        return { content: "Missing target or content", isError: true };
+    }
+    return controller.dm(input.target, input.content);
+}
+export async function joinRoomAction(controller, input) {
+    if (input.room === "")
+        return { content: "Missing room", isError: true };
+    const result = await controller.switchRoom(input.room);
+    if (!result.isError) {
+        const msgs = await controller.readRoom();
+        return { content: `${result.content}\n${msgs.content}`, isError: false };
+    }
+    return result;
+}
+export async function leaveRoomAction(controller, input) {
+    return controller.leaveRoom(input.room);
+}
+export async function createRoomAction(controller, input) {
+    if (input.name === "")
+        return { content: "Missing name", isError: true };
+    return controller.createRoom(input.name, input.type, input.description ?? "");
+}
+export async function listRoomsAction(controller) {
+    return controller.listRooms();
+}
+export async function listAgentsAction(controller) {
+    return controller.listAgents();
+}
+export async function readRoomAction(controller, input) {
+    return controller.readRoom(input.room);
+}
+export async function destroyRoomAction(controller, input) {
+    if (input.room === "")
+        return { content: "Missing room", isError: true };
+    return controller.destroyRoom(input.room);
+}
+export async function inviteAction(controller, input) {
+    if (input.room === "" || input.agent === "") {
+        return { content: "Missing room or agent", isError: true };
+    }
+    return controller.invite(input.room, input.agent);
+}
+export async function declineInviteAction(controller, input) {
+    if (input.room === "" || input.reason === "") {
+        return { content: "Missing room or reason", isError: true };
+    }
+    return controller.declineInvite(input.room, input.reason);
+}
+export async function kickAction(controller, input) {
+    if (input.room === "" || input.agent === "") {
+        return { content: "Missing room or agent", isError: true };
+    }
+    return controller.kick(input.room, input.agent);
+}
+export async function renameAgentAction(controller, input) {
+    if (input.agent === "" || input.name === "") {
+        return { content: "Missing agent or name", isError: true };
+    }
+    return controller.renameAgent(input.agent, input.name);
+}
+function isPushSubscription(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    if (!("endpoint" in value) || typeof value.endpoint !== "string")
+        return false;
+    if (!("keys" in value))
+        return false;
+    const keys = value.keys;
+    if (typeof keys !== "object" || keys === null)
+        return false;
+    if (!("p256dh" in keys) || typeof keys.p256dh !== "string")
+        return false;
+    if (!("auth" in keys) || typeof keys.auth !== "string")
+        return false;
+    return true;
+}
+export function pushSubscribeAction(controller, pushManager, input) {
+    if (!pushManager) {
+        return { content: "Push notifications unavailable", isError: true };
+    }
+    if (!isPushSubscription(input.subscription)) {
+        return { content: "Invalid push subscription", isError: true };
+    }
+    const agentId = input.agentId ?? controller.agentId;
+    pushManager.addSubscription(agentId, input.subscription);
+    return { content: "Push subscription registered", isError: false };
+}
+export function pushUnsubscribeAction(controller, pushManager, input) {
+    if (!pushManager) {
+        return { content: "Push notifications unavailable", isError: true };
+    }
+    const agentId = input.agentId ?? controller.agentId;
+    pushManager.removeSubscription(agentId);
+    return { content: "Push subscription removed", isError: false };
+}
+//# sourceMappingURL=actions.js.map

package/dist/bridges/user/web/actions.js.map

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

package/dist/bridges/user/web/event-publisher.d.ts

@@ -0,0 +1,30 @@
+/**
+ * In-memory, resumable event publisher for the web UI's subscribeEvents stream.
+ *
+ * oRPC v2 beta (`\@orpc/server`, `\@orpc/client`, `\@orpc/contract` at 2.0.0-beta.35 -- confirmed against the actual published tarballs, not just docs) ships no MemoryPublisher/EventPublisher class. This is a hand-written equivalent built on the primitives that do exist: a plain async generator (satisfies AsyncIteratorObject on its own) and withEventMeta (from `\@standard-server/core`, re-exported by `\@orpc/server`) to tag each published event with a monotonic id oRPC's own RetryLinkPlugin already knows how to read back as lastEventId on reconnect.
+ *
+ * One instance per WebServerHandle -- not a module-level singleton -- so multiple concurrent web server instances (multiple bridges each starting their own web UI) never share replay buffers.
+ */
+import type { MeshEvent } from "./contract.js";
+export interface MeshEventPublisherOptions {
+    /** How long a published event stays available for replay by a resuming subscriber. */
+    retentionMs?: number;
+}
+export interface MeshEventSubscribeOptions {
+    signal?: AbortSignal;
+    lastEventId?: string;
+}
+export declare class MeshEventPublisher {
+    private seq;
+    private readonly buffer;
+    private readonly listeners;
+    private readonly retentionMs;
+    constructor(options?: Readonly<MeshEventPublisherOptions>);
+    publish(event: MeshEvent): void;
+    private prune;
+    /**
+     * Replays buffered events after `lastEventId` (or every buffered event, if a resuming subscriber's `lastEventId` has already aged out of the retention window), then yields new events as they're published until `signal` aborts.
+     */
+    subscribe(options?: Readonly<MeshEventSubscribeOptions>): AsyncGenerator<MeshEvent, void, void>;
+}
+//# sourceMappingURL=event-publisher.d.ts.map

package/dist/bridges/user/web/event-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-publisher.d.ts","sourceRoot":"","sources":["../../../../src/bridges/user/web/event-publisher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAO/C,MAAM,WAAW,yBAAyB;IACxC,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IACnE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,GAAE,QAAQ,CAAC,yBAAyB,CAAM;IAI7D,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAQ/B,OAAO,CAAC,KAAK;IAUb;;OAEG;IACI,SAAS,CACd,OAAO,GAAE,QAAQ,CAAC,yBAAyB,CAAM,GAChD,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC;CA8CzC"}

package/dist/bridges/user/web/event-publisher.js

@@ -0,0 +1,84 @@
+/**
+ * In-memory, resumable event publisher for the web UI's subscribeEvents stream.
+ *
+ * oRPC v2 beta (`\@orpc/server`, `\@orpc/client`, `\@orpc/contract` at 2.0.0-beta.35 -- confirmed against the actual published tarballs, not just docs) ships no MemoryPublisher/EventPublisher class. This is a hand-written equivalent built on the primitives that do exist: a plain async generator (satisfies AsyncIteratorObject on its own) and withEventMeta (from `\@standard-server/core`, re-exported by `\@orpc/server`) to tag each published event with a monotonic id oRPC's own RetryLinkPlugin already knows how to read back as lastEventId on reconnect.
+ *
+ * One instance per WebServerHandle -- not a module-level singleton -- so multiple concurrent web server instances (multiple bridges each starting their own web UI) never share replay buffers.
+ */
+import { withEventMeta } from "@orpc/server";
+/** A plain function call is opaque to TS's control-flow narrowing, unlike a direct `signal?.aborted` comparison -- narrowing that across an `await` (the abort can genuinely flip mid-wait) produces a false "these types have no overlap" error at the re-check below the await. */
+function isAborted(signal) {
+    return signal?.aborted === true;
+}
+const DEFAULT_RETENTION_MS = 60_000;
+export class MeshEventPublisher {
+    seq = 0;
+    buffer = [];
+    listeners = new Set();
+    retentionMs;
+    constructor(options = {}) {
+        this.retentionMs = options.retentionMs ?? DEFAULT_RETENTION_MS;
+    }
+    publish(event) {
+        this.prune();
+        const id = String(++this.seq);
+        const tagged = withEventMeta(event, { id });
+        this.buffer.push({ id, event: tagged, publishedAt: Date.now() });
+        for (const listener of this.listeners)
+            listener(tagged);
+    }
+    prune() {
+        const cutoff = Date.now() - this.retentionMs;
+        while (this.buffer.length > 0 &&
+            (this.buffer[0]?.publishedAt ?? Infinity) < cutoff) {
+            this.buffer.shift();
+        }
+    }
+    /**
+     * Replays buffered events after `lastEventId` (or every buffered event, if a resuming subscriber's `lastEventId` has already aged out of the retention window), then yields new events as they're published until `signal` aborts.
+     */
+    async *subscribe(options = {}) {
+        const { signal, lastEventId } = options;
+        this.prune();
+        if (lastEventId !== undefined) {
+            const startIndex = this.buffer.findIndex((b) => b.id === lastEventId);
+            const replay = startIndex === -1 ? this.buffer : this.buffer.slice(startIndex + 1);
+            for (const buffered of replay) {
+                if (isAborted(signal))
+                    return;
+                yield buffered.event;
+            }
+        }
+        const queue = [];
+        let wake;
+        const listener = (event) => {
+            queue.push(event);
+            wake?.();
+        };
+        this.listeners.add(listener);
+        try {
+            for (;;) {
+                if (isAborted(signal))
+                    return;
+                if (queue.length === 0) {
+                    await new Promise((resolve) => {
+                        wake = resolve;
+                        signal?.addEventListener("abort", () => {
+                            resolve();
+                        }, { once: true });
+                    });
+                    wake = undefined;
+                    if (isAborted(signal))
+                        return;
+                }
+                const next = queue.shift();
+                if (next !== undefined)
+                    yield next;
+            }
+        }
+        finally {
+            this.listeners.delete(listener);
+        }
+    }
+}
+//# sourceMappingURL=event-publisher.js.map

package/dist/bridges/user/web/event-publisher.js.map

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