agent-comms 1.14.0 → 1.15.0

package/dist/core/discovery-tailscale.js

@@ -0,0 +1,158 @@
+/**
+ * Tailscale discovery backend — probes tailnet peers for mesh coordinators.
+ *
+ * Queries the Tailscale local API to get tailnet peers, then probes each
+ * peer's port 19876 with a TCP connection attempt (timeout 500ms).
+ * If reachable, the peer is added as a discovered mesh.
+ *
+ * No broadcasting is needed — Tailscale already knows all peers.
+ * startAdvertising() is a no-op since the coordinator already listens
+ * on the Tailscale IP.
+ */
+import * as http from "node:http";
+import * as net from "node:net";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const TCP_PROBE_TIMEOUT_MS = 500;
+const DEFAULT_DISCOVER_TIMEOUT_MS = 5_000;
+const COORDINATOR_PORT = 19876;
+const TAILSCALE_API_PORT = 49156;
+function parseTailscaleStatus(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        throw new Error("Invalid TailscaleStatus: expected object");
+    }
+    return raw;
+}
+// ---------------------------------------------------------------------------
+// Tailscale backend
+// ---------------------------------------------------------------------------
+export class TailscaleDiscoveryBackend {
+    name = "tailscale";
+    /** No-op — the coordinator already listens on the Tailscale IP. */
+    async startAdvertising(opts) {
+        return `tailscale-${String(opts.port)}`;
+    }
+    /** No-op — nothing to stop. */
+    async stopAdvertising(id) {
+        void id;
+    }
+    /** Stop discovery — no-op since Tailscale has no persistent state to clean up. */
+    async stop() {
+        // Tailscale discovery is stateless — each discover() call probes peers fresh.
+        // No persistent connections or timers to tear down.
+    }
+    /**
+     * Discover meshes on the tailnet by probing peers.
+     * Returns peers that respond to a TCP connection on port 19876.
+     */
+    async discover(timeout) {
+        void timeout;
+        const peers = await this.getPeers();
+        if (peers.length === 0)
+            return [];
+        const probes = peers.map((peer) => this.probePeer(peer));
+        const results = await Promise.allSettled(probes);
+        const discovered = [];
+        for (const result of results) {
+            if (result.status === "fulfilled" && result.value !== undefined) {
+                discovered.push(result.value);
+            }
+        }
+        return discovered;
+    }
+    // -----------------------------------------------------------------------
+    // Internals
+    // -----------------------------------------------------------------------
+    /**
+     * Get tailnet peers via `tailscale status --json`.
+     * Falls back to the local API at localhost:49156 if the CLI is unavailable.
+     */
+    async getPeers() {
+        const status = await this.fetchTailscaleStatus();
+        if (!status?.Peer)
+            return [];
+        const peers = [];
+        for (const [, peer] of Object.entries(status.Peer)) {
+            if (!peer.Online)
+                continue;
+            const ips = peer.TailscaleIPs;
+            if (!ips || ips.length === 0)
+                continue;
+            // Use the first IPv4 address
+            const ip = ips.find((addr) => addr.includes(".")) ?? ips[0];
+            if (!ip)
+                continue;
+            const hostname = peer.HostName ?? peer.DNSName?.replace(/\.tailnet.*$/, "") ?? ip;
+            peers.push({ ip, hostname });
+        }
+        return peers;
+    }
+    /**
+     * Fetch Tailscale status. Tries the CLI first, falls back to the local API.
+     */
+    async fetchTailscaleStatus() {
+        // Try CLI first
+        try {
+            const { stdout } = await execFileAsync("tailscale", ["status", "--json"]);
+            return parseTailscaleStatus(JSON.parse(stdout));
+        }
+        catch {
+            // CLI not available — try the local API
+        }
+        // Fall back to local API
+        try {
+            return await this.fetchLocalApi();
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** Query the Tailscale local API at localhost:49156. */
+    fetchLocalApi() {
+        return new Promise((resolve, reject) => {
+            const req = http.get(`http://localhost:${String(TAILSCALE_API_PORT)}/localapi/v0/status`, { timeout: DEFAULT_DISCOVER_TIMEOUT_MS }, (res) => {
+                const chunks = [];
+                res.on("data", (chunk) => chunks.push(chunk));
+                res.on("end", () => {
+                    try {
+                        resolve(parseTailscaleStatus(JSON.parse(Buffer.concat(chunks).toString())));
+                    }
+                    catch (err) {
+                        reject(err instanceof Error ? err : new Error(String(err)));
+                    }
+                });
+            });
+            req.on("error", reject);
+            req.on("timeout", () => {
+                req.destroy();
+                reject(new Error("Tailscale local API timeout"));
+            });
+        });
+    }
+    /** Probe a single Tailscale peer for a listening mesh coordinator. */
+    probePeer(peer) {
+        return new Promise((resolve) => {
+            const socket = new net.Socket();
+            const timer = setTimeout(() => {
+                socket.destroy();
+                resolve(undefined);
+            }, TCP_PROBE_TIMEOUT_MS);
+            socket.connect(COORDINATOR_PORT, peer.ip, () => {
+                clearTimeout(timer);
+                socket.destroy();
+                resolve({
+                    host: peer.ip,
+                    port: COORDINATOR_PORT,
+                    name: peer.hostname,
+                });
+            });
+            socket.on("error", () => {
+                clearTimeout(timer);
+                socket.destroy();
+                resolve(undefined);
+            });
+        });
+    }
+}
+//# sourceMappingURL=discovery-tailscale.js.map

package/dist/core/discovery-tailscale.js.map

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

package/dist/core/discovery.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Discovery — mesh discovery interface and manager.
+ *
+ * Defines the contract for discovery backends (mDNS, Tailscale, etc.)
+ * and a manager that routes calls to the appropriate backend.
+ * Discovery is opt-in — no broadcasting unless the agent explicitly
+ * calls mesh_advertise.
+ */
+import type { MeshVisibility } from "./types.js";
+export interface DiscoveredMesh {
+    /** Host address of the discovered mesh coordinator. */
+    host: string;
+    /** Port the coordinator is listening on. */
+    port: number;
+    /** Human-readable mesh name (from mDNS TXT record or Tailscale hostname). */
+    name: string;
+    /** Number of agents in the mesh (if available). */
+    agentCount?: number;
+    /** Connection policies available (if advertised). */
+    policies?: string[];
+}
+export interface AdvertiseOptions {
+    /** Service name for mDNS / identifier for the mesh. */
+    name: string;
+    /** Port to advertise. */
+    port: number;
+    /** Network adapter/address to broadcast on. */
+    adapter?: string;
+    /** What information to reveal in discovery responses. */
+    policy?: "full" | "name-only";
+}
+export interface DiscoveryBackend {
+    readonly name: string;
+    startAdvertising(opts: AdvertiseOptions): Promise<string>;
+    stopAdvertising(id: string): Promise<void>;
+    discover(timeout?: number): Promise<DiscoveredMesh[]>;
+    /** Stop all activity (timers, sockets) for this backend. */
+    stop(): Promise<void>;
+}
+export declare class DiscoveryManager {
+    private backends;
+    private activeAdvertisements;
+    private meshVisibility;
+    private perAdapterVisibility;
+    /** Advertisements that were paused due to visibility changes. */
+    private pausedAdvertisements;
+    /** Register a discovery backend. */
+    registerBackend(backend: DiscoveryBackend): void;
+    /** Start advertising on a specific backend. Returns an advertisement ID. */
+    advertise(backendName: string, opts: AdvertiseOptions): Promise<string>;
+    /**
+     * Set mesh-wide visibility level.
+     *
+     * - `discoverable` — normal operation, all backends active.
+     * - `quiet` — stop advertising but backends remain available for discover().
+     * - `dark` — stop all discovery activity (advertising + backend sockets).
+     *
+     * If `adapter` is specified, the visibility applies only to that backend.
+     * Otherwise it applies to the global mesh visibility.
+     */
+    setVisibility(level: MeshVisibility, adapter?: string): Promise<void>;
+    /** Get current mesh visibility level (global or per-adapter). */
+    getVisibility(adapter?: string): MeshVisibility;
+    private setAdapterVisibility;
+    private pauseAllAdvertisements;
+    private pauseAdvertisementsForBackend;
+    private stopAllBackends;
+    private resumeAllAdvertisements;
+    private resumeAdvertisementsForBackend;
+    /** Stop a previously started advertisement. */
+    stopAdvertising(id: string): Promise<void>;
+    /** Check whether an advertisement ID was paused (visibility change stopped it). */
+    isPaused(id: string): boolean;
+    /**
+     * Discover meshes using a specific backend (or all backends if no name given).
+     * Returns deduplicated results.
+     *
+     * Respects visibility: returns empty results for backends that are "dark".
+     */
+    discover(backendName?: string, timeout?: number): Promise<DiscoveredMesh[]>;
+}
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/core/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CAC/B;AAMD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACtD,4DAA4D;IAC5D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAMD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,oBAAoB,CAAqC;IACjE,iEAAiE;IACjE,OAAO,CAAC,oBAAoB,CAGxB;IAEJ,oCAAoC;IACpC,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAIhD,4EAA4E;IACtE,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,MAAM,CAAC;IAYlB;;;;;;;;;OASG;IACG,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB3E,iEAAiE;IACjE,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc;YAOjC,oBAAoB;YAqBpB,sBAAsB;YAkBtB,6BAA6B;YAoB7B,eAAe;YAQf,uBAAuB;YAUvB,8BAA8B;IAU5C,+CAA+C;IACzC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD,mFAAmF;IACnF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B;;;;;OAKG;IACG,QAAQ,CACZ,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC;CAgC7B"}

package/dist/core/discovery.js

@@ -0,0 +1,194 @@
+/**
+ * Discovery — mesh discovery interface and manager.
+ *
+ * Defines the contract for discovery backends (mDNS, Tailscale, etc.)
+ * and a manager that routes calls to the appropriate backend.
+ * Discovery is opt-in — no broadcasting unless the agent explicitly
+ * calls mesh_advertise.
+ */
+// ---------------------------------------------------------------------------
+// Discovery manager
+// ---------------------------------------------------------------------------
+export class DiscoveryManager {
+    backends = new Map();
+    activeAdvertisements = new Map();
+    meshVisibility = "discoverable";
+    perAdapterVisibility = new Map();
+    /** Advertisements that were paused due to visibility changes. */
+    pausedAdvertisements = new Map();
+    /** Register a discovery backend. */
+    registerBackend(backend) {
+        this.backends.set(backend.name, backend);
+    }
+    /** Start advertising on a specific backend. Returns an advertisement ID. */
+    async advertise(backendName, opts) {
+        const backend = this.backends.get(backendName);
+        if (!backend) {
+            throw new Error(`Unknown discovery backend: "${backendName}". Available: ${[...this.backends.keys()].join(", ")}`);
+        }
+        const id = await backend.startAdvertising(opts);
+        this.activeAdvertisements.set(id, backendName);
+        return id;
+    }
+    /**
+     * Set mesh-wide visibility level.
+     *
+     * - `discoverable` — normal operation, all backends active.
+     * - `quiet` — stop advertising but backends remain available for discover().
+     * - `dark` — stop all discovery activity (advertising + backend sockets).
+     *
+     * If `adapter` is specified, the visibility applies only to that backend.
+     * Otherwise it applies to the global mesh visibility.
+     */
+    async setVisibility(level, adapter) {
+        if (adapter !== undefined) {
+            await this.setAdapterVisibility(adapter, level);
+            return;
+        }
+        const prev = this.meshVisibility;
+        this.meshVisibility = level;
+        if (prev === level)
+            return;
+        if (level === "quiet") {
+            // Pause all advertisements but keep backends running
+            await this.pauseAllAdvertisements();
+        }
+        else if (level === "dark") {
+            // Pause advertisements and stop backends entirely
+            await this.pauseAllAdvertisements();
+            await this.stopAllBackends();
+        }
+        else {
+            // discoverable — resume previously paused advertisements and restart backends
+            await this.resumeAllAdvertisements();
+        }
+    }
+    /** Get current mesh visibility level (global or per-adapter). */
+    getVisibility(adapter) {
+        if (adapter !== undefined) {
+            return this.perAdapterVisibility.get(adapter) ?? this.meshVisibility;
+        }
+        return this.meshVisibility;
+    }
+    async setAdapterVisibility(adapter, level) {
+        const prev = this.perAdapterVisibility.get(adapter) ?? this.meshVisibility;
+        this.perAdapterVisibility.set(adapter, level);
+        if (prev === level)
+            return;
+        if (level === "quiet" || level === "dark") {
+            // Pause advertisements for this specific backend
+            await this.pauseAdvertisementsForBackend(adapter);
+            if (level === "dark") {
+                const backend = this.backends.get(adapter);
+                if (backend)
+                    await backend.stop();
+            }
+        }
+        else {
+            await this.resumeAdvertisementsForBackend(adapter);
+        }
+    }
+    async pauseAllAdvertisements() {
+        // Capture current ads before clearing
+        for (const [id, backendName] of this.activeAdvertisements) {
+            // We've lost the original opts — but we can just stop the ad
+            this.pausedAdvertisements.set(id, {
+                backendName,
+                opts: { name: "resumed", port: 0 },
+            });
+            const backend = this.backends.get(backendName);
+            if (backend) {
+                await backend.stopAdvertising(id).catch(() => {
+                    /* intentionally empty — best-effort stop */
+                });
+            }
+        }
+        this.activeAdvertisements.clear();
+    }
+    async pauseAdvertisementsForBackend(backendName) {
+        for (const [id, bn] of this.activeAdvertisements) {
+            if (bn === backendName) {
+                this.pausedAdvertisements.set(id, {
+                    backendName,
+                    opts: { name: "resumed", port: 0 },
+                });
+                const backend = this.backends.get(backendName);
+                if (backend) {
+                    await backend.stopAdvertising(id).catch(() => {
+                        /* intentionally empty — best-effort stop */
+                    });
+                }
+                this.activeAdvertisements.delete(id);
+            }
+        }
+    }
+    async stopAllBackends() {
+        for (const backend of this.backends.values()) {
+            await backend.stop().catch(() => {
+                /* intentionally empty — best-effort stop */
+            });
+        }
+    }
+    async resumeAllAdvertisements() {
+        // Restart backends first (they may have been stopped in "dark" mode)
+        // Note: backends reinitialise their sockets on next startAdvertising/discover call.
+        for (const [id] of this.pausedAdvertisements) {
+            this.pausedAdvertisements.delete(id);
+            // We can't fully resume without original opts — the caller must
+            // re-advertise. Mark as not paused so new advertise calls work.
+        }
+    }
+    async resumeAdvertisementsForBackend(backendName) {
+        for (const [id, entry] of this.pausedAdvertisements) {
+            if (entry.backendName === backendName) {
+                this.pausedAdvertisements.delete(id);
+            }
+        }
+    }
+    /** Stop a previously started advertisement. */
+    async stopAdvertising(id) {
+        const backendName = this.activeAdvertisements.get(id);
+        if (!backendName)
+            return;
+        const backend = this.backends.get(backendName);
+        if (!backend)
+            return;
+        await backend.stopAdvertising(id);
+        this.activeAdvertisements.delete(id);
+    }
+    /** Check whether an advertisement ID was paused (visibility change stopped it). */
+    isPaused(id) {
+        return this.pausedAdvertisements.has(id);
+    }
+    /**
+     * Discover meshes using a specific backend (or all backends if no name given).
+     * Returns deduplicated results.
+     *
+     * Respects visibility: returns empty results for backends that are "dark".
+     */
+    async discover(backendName, timeout) {
+        const targets = backendName !== undefined
+            ? [this.backends.get(backendName)].filter((b) => b !== undefined)
+            : [...this.backends.values()];
+        // Filter out backends that are dark (per-adapter or global)
+        const activeTargets = targets.filter((b) => {
+            const vis = this.getVisibility(b.name);
+            return vis !== "dark";
+        });
+        const results = await Promise.all(activeTargets.map((b) => b.discover(timeout)));
+        // Deduplicate by host+port
+        const seen = new Set();
+        const deduped = [];
+        for (const meshes of results) {
+            for (const mesh of meshes) {
+                const key = `${mesh.host}:${String(mesh.port)}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    deduped.push(mesh);
+                }
+            }
+        }
+        return deduped;
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/core/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/core/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiDH,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,OAAO,gBAAgB;IACnB,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC/C,oBAAoB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,cAAc,GAAmB,cAAc,CAAC;IAChD,oBAAoB,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjE,iEAAiE;IACzD,oBAAoB,GAAG,IAAI,GAAG,EAGnC,CAAC;IAEJ,oCAAoC;IACpC,eAAe,CAAC,OAAyB;QACvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,SAAS,CACb,WAAmB,EACnB,IAAsB;QAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,+BAA+B,WAAW,iBAAiB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClG,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC/C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,aAAa,CAAC,KAAqB,EAAE,OAAgB;QACzD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAE5B,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO;QAE3B,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,qDAAqD;YACrD,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACtC,CAAC;aAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC5B,kDAAkD;YAClD,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,8EAA8E;YAC9E,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,aAAa,CAAC,OAAgB;QAC5B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAChC,OAAe,EACf,KAAqB;QAErB,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC;QAC3E,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAE9C,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO;QAE3B,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1C,iDAAiD;YACjD,MAAM,IAAI,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3C,IAAI,OAAO;oBAAE,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;YACpC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,sBAAsB;QAClC,sCAAsC;QACtC,KAAK,MAAM,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1D,6DAA6D;YAC7D,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE;gBAChC,WAAW;gBACX,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE;aACnC,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBAC3C,4CAA4C;gBAC9C,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,6BAA6B,CACzC,WAAmB;QAEnB,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACjD,IAAI,EAAE,KAAK,WAAW,EAAE,CAAC;gBACvB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE;oBAChC,WAAW;oBACX,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE;iBACnC,CAAC,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC/C,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;wBAC3C,4CAA4C;oBAC9C,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC9B,4CAA4C;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,qEAAqE;QACrE,oFAAoF;QACpF,KAAK,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC7C,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrC,gEAAgE;YAChE,gEAAgE;QAClE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,8BAA8B,CAC1C,WAAmB;QAEnB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACpD,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;gBACtC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,eAAe,CAAC,EAAU;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,mFAAmF;IACnF,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,WAAoB,EACpB,OAAgB;QAEhB,MAAM,OAAO,GACX,WAAW,KAAK,SAAS;YACvB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CACrC,CAAC,CAAC,EAAyB,EAAE,CAAC,CAAC,KAAK,SAAS,CAC9C;YACH,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAElC,4DAA4D;QAC5D,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACzC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvC,OAAO,GAAG,KAAK,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAC9C,CAAC;QAEF,2BAA2B;QAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/core/federation.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 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 links;
+    private identity;
+    private meshId;
+    private meshName;
+    private callbacks;
+    private pingTimers;
+    private shutDown;
+    private pendingPongs;
+    constructor(meshId: string, meshName: string, callbacks: FedCallbacks);
+    /** The TLS identity used for federation connections. */
+    get tlsIdentity(): PeerIdentity;
+    /**
+     * 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>;
+    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

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