agent-comms 2.31.1 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-comms",
-  "version": "2.31.1",
+  "version": "3.0.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",

package/dist/core/federation-bridge.d.ts

@@ -1,32 +0,0 @@
-/**
- * FederationBridge — implements FederationManager's own FedCallbacks contract as a real class rather than a closure bag, so the inbound-from-remote-mesh handling (a federated agent becoming visible/gone, a federated room's message/join/leave) and the two outbound sync queries (getVisibleAgents/getFederatedRoomMemberships) live together instead of scattered across mesh-store.ts. Split out to reduce mesh-store.ts under the repo's max-lines cap.
- */
-import type { FedCallbacks } from "./federation.js";
-import type { DeliveryEngine } from "./delivery-engine.js";
-import type { AgentIdentity, Room, RoomMessage } from "./types.js";
-/** The state and DeliveryEngine operations FederationBridge needs from MeshStore -- the core agents/rooms/messages Maps are direct references into MeshStore's own fields, and deliveryEngine is the already-constructed instance (construction order: ... -\> deliveryEngine -\> federationBridge -\> federation), narrowed to only the membership/broadcast/delivery operations a federation callback ever needs. */
-export interface FederationBridgeDeps {
-    agents: Map<string, AgentIdentity>;
-    rooms: Map<string, Room>;
-    messages: Map<string, RoomMessage[]>;
-    deliveryEngine: Pick<DeliveryEngine, "bump" | "recordMemberOp" | "refreshMembership" | "broadcastPatch" | "deliverToRoom" | "deliverRoomMessageToMember">;
-}
-export declare class FederationBridge implements FedCallbacks {
-    private readonly deps;
-    constructor(deps: FederationBridgeDeps);
-    /** Called when a remote agent becomes visible over a federation link -- stores it locally under a `fed:`-prefixed id to avoid collisions with local agents. */
-    onAgentVisible(agent: AgentIdentity): Promise<void>;
-    /** Called when a remote agent goes offline/disappears -- the agentId comes from the remote mesh, so this finds the locally prefixed version. */
-    onAgentGone(agentId: string): Promise<void>;
-    /** Called when a message arrives for a federated room -- stores it locally and delivers to every local room member. A `fed:`-prefixed member is a shadow record for a remote participant with no addressable mesh device of its own; federation.ts's own link forwarding, not this local fan-out, is what reaches them. */
-    onRoomMessage(roomId: string, message: RoomMessage): Promise<void>;
-    /** Called when a remote agent joins a federated room -- creates a shadow `fed:`-prefixed member and notifies local members. */
-    onRoomJoin(roomId: string, agentId: string, _agentName: string): Promise<void>;
-    /** Called when a remote agent leaves a federated room. */
-    onRoomLeave(roomId: string, agentId: string): Promise<void>;
-    /** Get all visible agents in the local mesh (for syncing to new links) -- excludes agents already federated in from elsewhere, to avoid re-broadcasting them back out. */
-    getVisibleAgents(): AgentIdentity[];
-    /** Get all federated rooms and their local member lists (for syncing to new links). */
-    getFederatedRoomMemberships(): Map<string, string[]>;
-}
-//# sourceMappingURL=federation-bridge.d.ts.map

package/dist/core/federation-bridge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"federation-bridge.d.ts","sourceRoot":"","sources":["../../src/core/federation-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnE,uZAAuZ;AACvZ,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACrC,cAAc,EAAE,IAAI,CAClB,cAAc,EACZ,MAAM,GACN,gBAAgB,GAChB,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,GACf,4BAA4B,CAC/B,CAAC;CACH;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,oBAAoB;IAEvD,+JAA+J;IACzJ,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD,gJAAgJ;IAC1I,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD,2TAA2T;IACrT,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxE,+HAA+H;IACzH,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAwBhB,0DAA0D;IACpD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjE,0KAA0K;IAC1K,gBAAgB,IAAI,aAAa,EAAE;IAUnC,uFAAuF;IACvF,2BAA2B,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAUrD"}

package/dist/core/federation-bridge.js

@@ -1,112 +0,0 @@
-/**
- * FederationBridge — implements FederationManager's own FedCallbacks contract as a real class rather than a closure bag, so the inbound-from-remote-mesh handling (a federated agent becoming visible/gone, a federated room's message/join/leave) and the two outbound sync queries (getVisibleAgents/getFederatedRoomMemberships) live together instead of scattered across mesh-store.ts. Split out to reduce mesh-store.ts under the repo's max-lines cap.
- */
-export class FederationBridge {
-    deps;
-    constructor(deps) {
-        this.deps = deps;
-    }
-    /** Called when a remote agent becomes visible over a federation link -- stores it locally under a `fed:`-prefixed id to avoid collisions with local agents. */
-    async onAgentVisible(agent) {
-        const remoteId = `fed:${agent.id}@${agent.harness}`;
-        const remoteAgent = {
-            ...agent,
-            id: remoteId,
-            tags: [...agent.tags, "federated"],
-        };
-        this.deps.agents.set(remoteId, remoteAgent);
-        await this.deps.deliveryEngine.broadcastPatch({
-            type: "agent_upsert",
-            agent: remoteAgent,
-        });
-    }
-    /** Called when a remote agent goes offline/disappears -- the agentId comes from the remote mesh, so this finds the locally prefixed version. */
-    async onAgentGone(agentId) {
-        const prefix = `fed:${agentId}@`;
-        for (const [localId, agent] of this.deps.agents) {
-            if (localId.startsWith(prefix)) {
-                agent.status = "offline";
-                this.deps.agents.set(localId, agent);
-                await this.deps.deliveryEngine.broadcastPatch({
-                    type: "agent_offline",
-                    agentId: localId,
-                });
-                break;
-            }
-        }
-    }
-    /** Called when a message arrives for a federated room -- stores it locally and delivers to every local room member. A `fed:`-prefixed member is a shadow record for a remote participant with no addressable mesh device of its own; federation.ts's own link forwarding, not this local fan-out, is what reaches them. */
-    async onRoomMessage(roomId, message) {
-        const room = this.deps.rooms.get(roomId);
-        if (room?.federated !== true)
-            return;
-        const arr = this.deps.messages.get(roomId) ?? [];
-        arr.push(message);
-        this.deps.messages.set(roomId, arr);
-        for (const memberId of room.members) {
-            if (memberId.startsWith("fed:"))
-                continue;
-            await this.deps.deliveryEngine.deliverRoomMessageToMember(roomId, memberId, message);
-        }
-    }
-    /** Called when a remote agent joins a federated room -- creates a shadow `fed:`-prefixed member and notifies local members. */
-    async onRoomJoin(roomId, agentId, _agentName) {
-        const room = this.deps.rooms.get(roomId);
-        if (room?.federated !== true)
-            return;
-        const remoteId = `fed:${agentId}`;
-        if (!room.members.includes(remoteId)) {
-            this.deps.deliveryEngine.bump(room);
-            this.deps.deliveryEngine.recordMemberOp(room, "member", "join", remoteId);
-            this.deps.deliveryEngine.refreshMembership(room);
-            this.deps.rooms.set(roomId, room);
-            await this.deps.deliveryEngine.broadcastPatch({
-                type: "room_upsert",
-                room,
-            });
-        }
-        await this.deps.deliveryEngine.deliverToRoom(roomId, { type: "member_joined", room: roomId, agent: remoteId }, remoteId);
-    }
-    /** Called when a remote agent leaves a federated room. */
-    async onRoomLeave(roomId, agentId) {
-        const room = this.deps.rooms.get(roomId);
-        if (room?.federated !== true)
-            return;
-        const remoteId = `fed:${agentId}`;
-        this.deps.deliveryEngine.bump(room);
-        this.deps.deliveryEngine.recordMemberOp(room, "member", "leave", remoteId);
-        this.deps.deliveryEngine.refreshMembership(room);
-        this.deps.rooms.set(roomId, room);
-        await this.deps.deliveryEngine.broadcastPatch({
-            type: "room_upsert",
-            room,
-        });
-        await this.deps.deliveryEngine.deliverToRoom(roomId, {
-            type: "member_left",
-            room: roomId,
-            agent: remoteId,
-        });
-    }
-    /** Get all visible agents in the local mesh (for syncing to new links) -- excludes agents already federated in from elsewhere, to avoid re-broadcasting them back out. */
-    getVisibleAgents() {
-        const result = [];
-        for (const agent of this.deps.agents.values()) {
-            if (agent.visibility === "visible" && !agent.id.startsWith("fed:")) {
-                result.push(agent);
-            }
-        }
-        return result;
-    }
-    /** Get all federated rooms and their local member lists (for syncing to new links). */
-    getFederatedRoomMemberships() {
-        const result = new Map();
-        for (const [roomId, room] of this.deps.rooms) {
-            if (room.federated === true) {
-                const localMembers = room.members.filter((m) => !m.startsWith("fed:"));
-                result.set(roomId, localMembers);
-            }
-        }
-        return result;
-    }
-}
-//# sourceMappingURL=federation-bridge.js.map

package/dist/core/federation-bridge.js.map

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

package/dist/core/federation.d.ts

@@ -1,125 +0,0 @@
-/**
- * FederationManager — manages TLS links between mesh coordinators.
- *
- * Federation links are persistent TLS connections between coordinators on
- * different machines. They forward agent presence, room memberships, and
- * messages for rooms marked as federated. Non-federated rooms never leave
- * the local mesh.
- *
- * Each link uses certificate pinning (the same trust model as TlsTransport).
- * The wire protocol runs over the same newline-delimited JSON framing as the
- * local mesh, but with `fed_*` method types.
- */
-import * as tls from "node:tls";
-import type { AgentIdentity, RoomMessage } from "./types.js";
-import type { PeerIdentity } from "./identity.js";
-/** Represents an active federation link (outbound or inbound). */
-export interface FedLink {
-    /** Unique ID for this link (assigned locally). */
-    id: string;
-    /** Remote mesh ID (received during handshake). */
-    remoteMeshId: string;
-    /** Human-readable name for the remote mesh. */
-    remoteName: string;
-    /** The TLS socket. */
-    socket: tls.TLSSocket;
-    /** Whether the handshake has completed successfully. */
-    ready: boolean;
-    /** Direction of the connection. */
-    direction: "outbound" | "inbound";
-}
-/** Callbacks the FederationManager uses to interact with local mesh state. */
-export interface FedCallbacks {
-    /** Called when a remote agent becomes visible over a federation link. */
-    onAgentVisible: (agent: AgentIdentity) => Promise<void>;
-    /** Called when a remote agent goes offline/disappears. */
-    onAgentGone: (agentId: string) => Promise<void>;
-    /** Called when a message arrives for a federated room. */
-    onRoomMessage: (roomId: string, message: RoomMessage) => Promise<void>;
-    /** Called when a remote agent joins a federated room. */
-    onRoomJoin: (roomId: string, agentId: string, agentName: string) => Promise<void>;
-    /** Called when a remote agent leaves a federated room. */
-    onRoomLeave: (roomId: string, agentId: string) => Promise<void>;
-    /** Get all visible agents in the local mesh (for syncing to new links). */
-    getVisibleAgents: () => AgentIdentity[];
-    /** Get all federated rooms and their member lists (for syncing to new links). */
-    getFederatedRoomMemberships: () => Map<string, string[]>;
-}
-export declare class FederationManager {
-    private readonly links;
-    private readonly identity;
-    private readonly meshId;
-    private readonly meshName;
-    private readonly callbacks;
-    private readonly pingTimers;
-    private shutDown;
-    private readonly pendingPongs;
-    /**
-     * Certificate fingerprints this instance will federate with, inbound or outbound. Empty by default — federation trusts nobody until an operator explicitly pins a remote mesh's fingerprint, the same no-CA, pin-the-key trust model ordinary peer connections already use.
-     */
-    private readonly trustedFingerprints;
-    private listener;
-    constructor(meshId: string, meshName: string, callbacks: Readonly<FedCallbacks>);
-    /** The TLS identity used for federation connections. */
-    get tlsIdentity(): PeerIdentity;
-    /** Pin a remote mesh's certificate fingerprint as trusted for federation. */
-    addTrustedFingerprint(fingerprint: string): void;
-    /** Remove a previously pinned fingerprint. Existing links using it are not torn down. */
-    removeTrustedFingerprint(fingerprint: string): void;
-    /** List currently trusted fingerprints. */
-    listTrustedFingerprints(): string[];
-    /**
-     * Verify the certificate a connected TLS socket presented against the trusted-fingerprint allowlist. Returns the presented fingerprint when trusted, `undefined` (and destroys the socket) otherwise.
-     *
-     * This is the check that was missing entirely before: the socket was accepted with `rejectUnauthorized: false` (required, since these are self-signed certs with no CA) but nothing then verified *which* self-signed cert was presented, so any certificate was accepted as a valid federation peer.
-     */
-    private verifyPeerOrDestroy;
-    /**
-     * Establish an outbound federation link to a remote coordinator.
-     * Returns the local link ID once the handshake completes.
-     */
-    connect(host: string, port: number, name?: string): Promise<string>;
-    /**
-     * Handle an incoming TLS connection that sent a fed_handshake.
-     * Called by the transport layer when a federation connection arrives.
-     */
-    handleInbound(socket: tls.TLSSocket): Promise<string>;
-    /** Disconnect a specific federation link. */
-    disconnect(linkId: string): Promise<void>;
-    /** List all active federation links. */
-    listLinks(): FedLink[];
-    /** Broadcast an agent visibility event to all ready links. */
-    broadcastAgentVisible(agent: AgentIdentity): Promise<void>;
-    /** Broadcast an agent gone event to all ready links. */
-    broadcastAgentGone(agentId: string): Promise<void>;
-    /** Forward a room message to all ready links (federated rooms only). */
-    forwardRoomMessage(roomId: string, message: RoomMessage): Promise<void>;
-    /** Broadcast a room join to all ready links. */
-    broadcastRoomJoin(roomId: string, agentId: string, agentName: string): Promise<void>;
-    /** Broadcast a room leave to all ready links. */
-    broadcastRoomLeave(roomId: string, agentId: string): Promise<void>;
-    /**
-     * Start listening for inbound federation connections. Every accepted connection is routed through `handleInbound()`, which enforces the trusted-fingerprint check before a link is ever created — nothing here bypasses that check.
-     *
-     * Previously nothing in the shipped product called `handleInbound()` at all: it existed only as a function the integration test invoked directly against a hand-rolled `tls.createServer`. This is that server, promoted to real code.
-     */
-    listen(host: string, port: number): Promise<void>;
-    /** Stop accepting new inbound federation connections. Existing links are unaffected. */
-    stopListening(): Promise<void>;
-    shutdown(): Promise<void>;
-    private tlsConnect;
-    private wireSocket;
-    private handleMessage;
-    /**
-     * After handshake, push our visible agents and federated room memberships
-     * to the newly connected link.
-     */
-    private syncStateToLink;
-    private waitForHandshake;
-    private startPing;
-    private sendPing;
-    private writeToSocket;
-    private broadcastToReady;
-    private clearLinkTimers;
-}
-//# sourceMappingURL=federation.d.ts.map

package/dist/core/federation.d.ts.map

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