agent-comms 2.20.2 → 2.21.1

package/dist/core/delivery-engine.js

@@ -0,0 +1,464 @@
+/**
+ * DeliveryEngine — the busiest hub in MeshStore: owns queued/local delivery, room-membership CRDT merge (mergeRoom/refreshMembership/recordMemberOp), patch application and broadcast, read receipts, and the two gossip callbacks (presence-advert, revocation-announce) that mutate this state directly. Split out of mesh-store.ts to reduce it under the repo's max-lines cap. Every core Map it touches (agents/rooms/messages/dms/deliveryQueues/localDeliveryKeys/pendingMarkReadTimers) is a direct reference into MeshStore's own fields, shared by construction rather than copied, since AgentRegistry, RoomLifecycle, RoomProtocol, RoomMessaging, FederationBridge, and StaleAgentChecker all read or mutate the same underlying state.
+ */
+import { bytesFromHex } from "wire-mesh-core/domain/device-id";
+import { loadRoomTokens } from "./identity-store.js";
+import { MAX_QUEUED_DELIVERIES_PER_AGENT, mergeMessageHistories, } from "./mesh-store-shared.js";
+export class DeliveryEngine {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    // -----------------------------------------------------------------------
+    // Gossip callbacks
+    // -----------------------------------------------------------------------
+    /** Applies a peer's gossiped presence status to this store's own local record, without broadcasting it back onto the mesh -- gossip itself is already how this fact propagates (each side's WireMeshTransport re-advertises its own status periodically), so re-broadcasting a received one would just bounce it around indefinitely. Silently ignored for a device-id this store doesn't yet have an agent record for: presence gossip is a transport-layer fact about an already-known peer's current status, not itself a source of truth for who that peer is -- that still comes only from agent_upsert/registerAgent, which carries the name/harness/cwd/tags a fabricated partial record here never could. */
+    handlePresenceAdvert(agentId, status) {
+        const agent = this.deps.agents.get(agentId);
+        if (agent === undefined || agent.status === status)
+            return;
+        agent.status = status;
+        this.bump(agent);
+        void this.notifyRoomsOfStatus(agentId, status);
+    }
+    /** Verifies a gossiped revocation-entry and, if it verifies, records it in this store's own RevocationView -- future verifyRoomToken calls against this token's (token-id, issuer) pair fail with "revoked" from this point on. A failing entry is dropped silently: the same "hostile input produces a verdict, never a throw" contract verifyRevocationEntry itself already guarantees, so there is nothing further for a caller to react to. */
+    async handleRevocationAnnounce(entry) {
+        const { identity, revocation } = this.deps.requireIdentity();
+        await revocation.record(entry, { identity });
+    }
+    // -----------------------------------------------------------------------
+    // Queueing and membership merge
+    // -----------------------------------------------------------------------
+    /** Append to a target agent's delivery queue, bounded oldest-first (#28). */
+    queueDelivery(agentId, event) {
+        const arr = this.deps.deliveryQueues.get(agentId) ?? [];
+        arr.push(event);
+        if (arr.length > MAX_QUEUED_DELIVERIES_PER_AGENT) {
+            arr.splice(0, arr.length - MAX_QUEUED_DELIVERIES_PER_AGENT);
+        }
+        this.deps.deliveryQueues.set(agentId, arr);
+    }
+    /**
+     * Merge an incoming room record into the local one. Scalar fields follow the version gate the caller already applied (an equal or higher version reaches here), while membership is always element-merged per agent by highest operation revision, so concurrent joins of different agents survive and a kick racing a join converges with the kick honoured (#27). The members and invited views are re-derived from the merged operations.
+     */
+    mergeRoom(incoming) {
+        const existing = this.deps.rooms.get(incoming.id);
+        if (existing === undefined) {
+            this.refreshMembership(incoming);
+            this.deps.rooms.set(incoming.id, incoming);
+            return;
+        }
+        existing.version = Math.max(existing.version, incoming.version);
+        existing.name = incoming.name;
+        existing.type = incoming.type;
+        existing.owner = incoming.owner;
+        existing.createdAt = incoming.createdAt;
+        existing.description = incoming.description;
+        if (incoming.federated !== undefined)
+            existing.federated = incoming.federated;
+        existing.memberJoins = DeliveryEngine.mergeMemberOps(existing.memberJoins, incoming.memberJoins);
+        existing.memberLeaves = DeliveryEngine.mergeMemberOps(existing.memberLeaves, incoming.memberLeaves);
+        existing.invitedJoins = DeliveryEngine.mergeMemberOps(existing.invitedJoins, incoming.invitedJoins);
+        existing.invitedLeaves = DeliveryEngine.mergeMemberOps(existing.invitedLeaves, incoming.invitedLeaves);
+        this.refreshMembership(existing);
+    }
+    /**
+     * Derive the members and invited views from the per-agent operation maps. An agent is in the list when their latest join strictly outranks their latest leave; equal revisions mean the leave wins, so a kick racing a concurrent join converges with the kick honoured (#27).
+     */
+    refreshMembership(room) {
+        room.members = Object.keys(room.memberJoins).filter((id) => (room.memberJoins[id] ?? 0) > (room.memberLeaves[id] ?? 0));
+        room.invited = Object.keys(room.invitedJoins).filter((id) => (room.invitedJoins[id] ?? 0) > (room.invitedLeaves[id] ?? 0));
+    }
+    /** Record a membership operation at the room's current revision. */
+    recordMemberOp(room, list, op, agentId) {
+        const joins = list === "member" ? room.memberJoins : room.invitedJoins;
+        const leaves = list === "member" ? room.memberLeaves : room.invitedLeaves;
+        const stamp = room.version;
+        if (op === "join")
+            joins[agentId] = stamp;
+        else
+            leaves[agentId] = stamp;
+    }
+    /** Merge per-agent operation maps by highest revision per agent. */
+    static mergeMemberOps(local, incoming) {
+        const merged = { ...local };
+        for (const [id, stamp] of Object.entries(incoming)) {
+            if (stamp > (merged[id] ?? 0))
+                merged[id] = stamp;
+        }
+        return merged;
+    }
+    /** Bump an entity's sync revision; call before broadcasting a local mutation. */
+    bump(entity) {
+        entity.version += 1;
+        return entity;
+    }
+    // -----------------------------------------------------------------------
+    // State sync and patch application
+    // -----------------------------------------------------------------------
+    /**
+     * Merge a peer's state snapshot into the local state. Agents and rooms accept the incoming copy when it carries a revision at least as high as the local one, so a peer holding stale entities converges when it receives a fresher snapshot, while its own stale copies are rejected by peers that stayed current (#27). Message and DM histories are append-only: add unseen entries and union read receipts.
+     */
+    applyStateSync(state) {
+        const incoming = {
+            agents: new Map(Object.entries(state.agents)),
+            rooms: new Map(Object.entries(state.rooms)),
+            messages: new Map(Object.entries(state.messages)),
+            dms: new Map(Object.entries(state.dms)),
+        };
+        for (const [id, agent] of incoming.agents) {
+            const existingVersion = this.deps.agents.get(id)?.version;
+            if (existingVersion !== undefined && agent.version < existingVersion) {
+                continue;
+            }
+            if (existingVersion === agent.version) {
+                const existing = this.deps.agents.get(id);
+                if (existing) {
+                    for (const r of existing.subscribedRooms) {
+                        if (!agent.subscribedRooms.includes(r))
+                            agent.subscribedRooms.push(r);
+                    }
+                }
+            }
+            this.deps.agents.set(id, agent);
+        }
+        for (const [id, room] of incoming.rooms) {
+            const existingVersion = this.deps.rooms.get(id)?.version;
+            if (existingVersion !== undefined && room.version < existingVersion) {
+                continue;
+            }
+            this.mergeRoom(room);
+        }
+        for (const [id, msgs] of incoming.messages) {
+            const existing = this.deps.messages.get(id);
+            if (existing === undefined) {
+                this.deps.messages.set(id, msgs);
+                continue;
+            }
+            mergeMessageHistories(existing, msgs);
+        }
+        for (const [id, dmMsgs] of incoming.dms) {
+            const existing = this.deps.dms.get(id);
+            if (existing === undefined) {
+                this.deps.dms.set(id, dmMsgs);
+                continue;
+            }
+            mergeMessageHistories(existing, dmMsgs);
+        }
+        for (const [agentId, events] of Object.entries(state.deliveryQueues)) {
+            const seen = new Set((this.deps.deliveryQueues.get(agentId) ?? []).map((e) => JSON.stringify(e)));
+            for (const event of events) {
+                if (seen.has(JSON.stringify(event)))
+                    continue;
+                this.queueDelivery(agentId, event);
+                // Replay fires only for events with consumption evidence (#28): messages are consumed by reading (readBy), invites by acceptance or decline (no longer in the invited list). Transient notifications (member_joined, room_members, connection_request, delivery status) carry no consumption evidence, so replaying them could only ever duplicate-notify; the state they describe arrives via the synced room and agent records instead. They still merge into the queue, so drain bridges see them.
+                if (event.type === "room_message" || event.type === "dm") {
+                    this.fireLocalDelivery(agentId, event);
+                }
+                else if (event.type === "room_invite") {
+                    const stillInvited = this.deps.rooms
+                        .get(event.room)
+                        ?.invited.includes(agentId);
+                    if (stillInvited === true) {
+                        this.fireLocalDelivery(agentId, event);
+                    }
+                }
+            }
+        }
+    }
+    async applyPatch(patch) {
+        switch (patch.type) {
+            case "agent_upsert": {
+                const existingAgent = this.deps.agents.get(patch.agent.id);
+                if (existingAgent !== undefined &&
+                    patch.agent.version < existingAgent.version) {
+                    // Stale copy from a peer that missed updates (#27).
+                    break;
+                }
+                const merged = patch.agent;
+                if (existingAgent?.version === patch.agent.version) {
+                    // Concurrent mutations from the same base: keep subscriptions gained locally. A strictly higher version replaces the record.
+                    for (const r of existingAgent.subscribedRooms) {
+                        if (!merged.subscribedRooms.includes(r))
+                            merged.subscribedRooms.push(r);
+                    }
+                }
+                this.deps.agents.set(merged.id, merged);
+                break;
+            }
+            case "agent_offline": {
+                const agent = this.deps.agents.get(patch.agentId);
+                if (agent) {
+                    agent.status = "offline";
+                    this.deps.agents.set(patch.agentId, agent);
+                }
+                break;
+            }
+            case "room_upsert": {
+                const existing = this.deps.rooms.get(patch.room.id);
+                if (existing !== undefined && patch.room.version < existing.version) {
+                    // Stale copy from a peer that missed updates (#27).
+                    break;
+                }
+                this.mergeRoom(patch.room);
+                break;
+            }
+            case "room_delete":
+                this.deps.rooms.delete(patch.roomId);
+                break;
+            case "message_add": {
+                const arr = this.deps.messages.get(patch.roomId) ?? [];
+                arr.push(patch.message);
+                this.deps.messages.set(patch.roomId, arr);
+                break;
+            }
+            case "dm_add": {
+                const arr = this.deps.dms.get(patch.key) ?? [];
+                arr.push(patch.message);
+                this.deps.dms.set(patch.key, arr);
+                break;
+            }
+            case "delivery": {
+                this.queueDelivery(patch.agentId, patch.event);
+                const onDelivery = this.deps.getOnDelivery();
+                if (patch.agentId === this.deps.getPeerId() && onDelivery) {
+                    // Deduplicate against local deliveries
+                    const eventKey = JSON.stringify(patch.event);
+                    if (this.deps.localDeliveryKeys.has(eventKey))
+                        break;
+                    this.deps.localDeliveryKeys.add(eventKey);
+                    if (this.deps.localDeliveryKeys.size > 50) {
+                        const oldest = this.deps.localDeliveryKeys.values().next().value;
+                        if (oldest !== undefined)
+                            this.deps.localDeliveryKeys.delete(oldest);
+                    }
+                    void onDelivery(patch.agentId, patch.event);
+                    // Auto-mark read — scheduled as a macrotask to yield to the event loop. Without this yield, the delivery → markRead → broadcast → peer receives → handleDataMessage chain monopolises the microtask queue and starves macrotasks (timers, new connections, sendRoomMessage return values).
+                    const evt = patch.event;
+                    const timer = setTimeout(() => {
+                        if (this.deps.isShutDown())
+                            return;
+                        if (evt.type === "room_message") {
+                            void this.markRead(evt.message.id, this.deps.getPeerId(), evt.message.room);
+                        }
+                        else if (evt.type === "dm") {
+                            void this.markRead(evt.message.id, this.deps.getPeerId());
+                        }
+                    }, 0);
+                    if (!this.deps.isShutDown())
+                        this.deps.pendingMarkReadTimers.push(timer);
+                }
+                break;
+            }
+        }
+        const onPatch = this.deps.getOnPatch();
+        if (onPatch) {
+            await onPatch(patch);
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Broadcast and local delivery
+    // -----------------------------------------------------------------------
+    async broadcastPatch(patch) {
+        await this.deps
+            .requireTransport()
+            .broadcast({ method: "state_update", patch });
+        const onPatch = this.deps.getOnPatch();
+        if (onPatch) {
+            await onPatch(patch);
+        }
+    }
+    async deliverLocallyAndBroadcast(agentId, event) {
+        // Local delivery
+        this.queueDelivery(agentId, event);
+        // Auto-emit delivered status for messages
+        if (event.type === "room_message") {
+            await this.emitDeliveryStatus(event.message.id, agentId, "delivered", event.message.room);
+        }
+        else if (event.type === "dm") {
+            await this.emitDeliveryStatus(event.message.id, agentId, "delivered");
+        }
+        this.fireLocalDelivery(agentId, event);
+        // Remote delivery
+        const patch = { type: "delivery", agentId, event };
+        await this.broadcastPatch(patch);
+    }
+    /**
+     * Fire onDelivery for an event targeting this peer's own agent, deduped against events already delivered in this process. Used both for live deliveries and for replays of events that accumulated while this process was down (#28): the dedup set is per-process, so a replayed event this process never saw fires, and one it already handled does not.
+     */
+    fireLocalDelivery(agentId, event) {
+        const onDelivery = this.deps.getOnDelivery();
+        if (agentId !== this.deps.getPeerId() || !onDelivery)
+            return;
+        // A room message or DM this agent has already read was already pushed and consumed: read receipts mutate the event between snapshots, so a plain structural key would miss and re-fire on the next sync (#28).
+        if ((event.type === "room_message" || event.type === "dm") &&
+            event.message.readBy.includes(agentId)) {
+            return;
+        }
+        const eventKey = JSON.stringify(event);
+        if (this.deps.localDeliveryKeys.has(eventKey))
+            return;
+        this.deps.localDeliveryKeys.add(eventKey);
+        // Prevent unbounded growth — evict oldest when cap reached
+        if (this.deps.localDeliveryKeys.size > 50) {
+            const oldest = this.deps.localDeliveryKeys.values().next().value;
+            if (oldest !== undefined)
+                this.deps.localDeliveryKeys.delete(oldest);
+        }
+        void onDelivery(agentId, event);
+        // Delivered to this process, so no longer pending for it. Peers that never fired the event keep their copies, which is what a restart replays from (#28). Key-based match: replayed events are JSON clones.
+        const queued = this.deps.deliveryQueues.get(agentId);
+        if (queued !== undefined) {
+            const idx = queued.findIndex((e) => JSON.stringify(e) === eventKey);
+            if (idx !== -1)
+                queued.splice(idx, 1);
+        }
+        // Auto-mark read — scheduled as a macrotask to yield to the event loop.
+        const timer = setTimeout(() => {
+            if (this.deps.isShutDown())
+                return;
+            if (event.type === "room_message") {
+                void this.markRead(event.message.id, agentId, event.message.room);
+            }
+            else if (event.type === "dm") {
+                void this.markRead(event.message.id, agentId);
+            }
+        }, 0);
+        if (!this.deps.isShutDown())
+            this.deps.pendingMarkReadTimers.push(timer);
+    }
+    async deliverToRoom(roomId, event, excludeAgent) {
+        const room = this.deps.rooms.get(roomId);
+        if (!room)
+            return;
+        for (const memberId of room.members) {
+            if (memberId === excludeAgent)
+                continue;
+            await this.deliverLocallyAndBroadcast(memberId, event);
+        }
+    }
+    async notifyRoomsOfStatus(agentId, status) {
+        const agent = this.deps.agents.get(agentId);
+        if (!agent)
+            return;
+        for (const roomId of agent.subscribedRooms) {
+            await this.deliverToRoom(roomId, {
+                type: "member_status",
+                room: roomId,
+                agent: agentId,
+                status,
+            });
+        }
+    }
+    async notifyRoomsOfNameChange(agentId, oldName, newName) {
+        const agent = this.deps.agents.get(agentId);
+        if (!agent)
+            return;
+        const event = {
+            type: "name_changed",
+            agent: agentId,
+            oldName,
+            newName,
+        };
+        for (const roomId of agent.subscribedRooms) {
+            await this.deliverToRoom(roomId, event, agentId);
+        }
+        // Also deliver to the agent itself so it sees confirmation
+        await this.deliverLocallyAndBroadcast(agentId, event);
+    }
+    async emitDeliveryStatus(messageId, agentId, status, room) {
+        // Find the sender for this message
+        const senderId = this.findMessageSender(messageId, room);
+        if (!senderId)
+            return;
+        await this.deliverLocallyAndBroadcast(senderId, {
+            type: "delivery_status",
+            messageId,
+            agent: agentId,
+            status,
+            room,
+        });
+    }
+    findMessageSender(messageId, room) {
+        if (room) {
+            const msgs = this.deps.messages.get(room);
+            if (msgs) {
+                const msg = msgs.find((m) => m.id === messageId);
+                if (msg)
+                    return msg.from;
+            }
+        }
+        else {
+            // DM — search all DM queues
+            for (const [, msgs] of this.deps.dms) {
+                const msg = msgs.find((m) => m.id === messageId);
+                if (msg)
+                    return msg.from;
+            }
+        }
+        return undefined;
+    }
+    /** Like findMessageSender, but also returns the room-path a room.read needs to address: room itself for a room message, or the specific DM key (this.dms is keyed by dmRoomPath/"self:...", not the bare pair) the message was actually found under. */
+    findMessageLocation(messageId, room) {
+        if (room !== undefined) {
+            const msg = this.deps.messages.get(room)?.find((m) => m.id === messageId);
+            return msg === undefined ? undefined : { roomPath: room, from: msg.from };
+        }
+        for (const [key, msgs] of this.deps.dms) {
+            const msg = msgs.find((m) => m.id === messageId);
+            if (msg)
+                return { roomPath: key, from: msg.from };
+        }
+        return undefined;
+    }
+    /**
+     * Marks a message read by readBy (always this store's own identity -- see the auto-mark-read timers in fireLocalDelivery and drainDelivery, its only callers) and notifies the message's own author via a directed, wire-authenticated room.read (P3.5), replacing the legacy message_read patch's mesh-wide broadcast: only the author is a genuine audience for "did you read my message" per core/room's own always-voluntary read-receipt design, and a direct request to them is strictly more than the old broadcast actually needed. Silently does nothing beyond the local readBy update when the author is this store itself (a self-DM, or an already-own message) or when this store holds no room:member token for the message's own room-path -- read receipts stay best-effort by design, never a reason to throw.
+     */
+    async markRead(messageId, readBy, room) {
+        const location = this.findMessageLocation(messageId, room);
+        if (location === undefined)
+            return;
+        const { roomPath, from } = location;
+        const history = room !== undefined
+            ? this.deps.messages.get(room)
+            : this.deps.dms.get(roomPath);
+        const message = history?.find((m) => m.id === messageId);
+        if (message && !message.readBy.includes(readBy)) {
+            message.readBy.push(readBy);
+        }
+        if (from === readBy)
+            return;
+        const { slot, clock } = this.deps.requireIdentity();
+        const token = loadRoomTokens(slot)[roomPath];
+        if (token === undefined)
+            return;
+        const params = {
+            verb: "room.read",
+            messages: [bytesFromHex(messageId)],
+            at: clock.now(),
+        };
+        await this.deps.sendRoomRequestToMember(from, roomPath, token, params);
+    }
+    // -----------------------------------------------------------------------
+    // CommsStore — Delivery
+    // -----------------------------------------------------------------------
+    async deliver(agentId, event) {
+        await this.deliverLocallyAndBroadcast(agentId, event);
+    }
+    async drainDelivery(agentId) {
+        await Promise.resolve();
+        const events = this.deps.deliveryQueues.get(agentId) ?? [];
+        this.deps.deliveryQueues.set(agentId, []);
+        // Auto-mark messages as read — drain bridges consume on tool call
+        for (const event of events) {
+            if (event.type === "room_message") {
+                await this.markRead(event.message.id, agentId, event.message.room);
+            }
+            else if (event.type === "dm") {
+                await this.markRead(event.message.id, agentId);
+            }
+        }
+        return events;
+    }
+}
+//# sourceMappingURL=delivery-engine.js.map

package/dist/core/delivery-engine.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * 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" | "deliverLocallyAndBroadcast">;
+}
+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 all local room members. */
+    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

@@ -0,0 +1 @@
+{"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,oZAAoZ;AACpZ,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,sHAAsH;IAChH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxE,+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

@@ -0,0 +1,113 @@
+/**
+ * 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 all local room members. */
+    async onRoomMessage(roomId, message) {
+        const room = this.deps.rooms.get(roomId);
+        if (!room?.federated)
+            return;
+        const arr = this.deps.messages.get(roomId) ?? [];
+        arr.push(message);
+        this.deps.messages.set(roomId, arr);
+        for (const memberId of room.members) {
+            await this.deps.deliveryEngine.deliverLocallyAndBroadcast(memberId, {
+                type: "room_message",
+                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)
+            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)
+            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) {
+                const localMembers = room.members.filter((m) => !m.startsWith("fed:"));
+                result.set(roomId, localMembers);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=federation-bridge.js.map