@cyanmycelium/mcp-broker 0.4.0 → 1.2.0

package/web/js/lib/broker-tunnel.js

@@ -0,0 +1,173 @@
+/**
+ * broker-tunnel.js, connect an MCP server to @cyanmycelium/mcp-broker.
+ *
+ * This is the ONLY broker-specific code you need to tunnel an MCP server
+ * (browser-side or anywhere a WebSocket is available) to the broker. Copy
+ * this file as-is; it has zero dependencies.
+ *
+ * The broker's provider model is "the server dials out": an MCP server opens
+ * an outbound WebSocket to `/provider/<name>` and the broker relays every MCP
+ * client that targets that slot. No shipped MCP SDK transport covers that
+ * direction, so `BrokerTunnelTransport` below is a thin shim implementing the
+ * SDK's structural `Transport` interface (start / send / close / onmessage /
+ * onclose / onerror) over a browser `WebSocket`. The MCP protocol itself is
+ * untouched: any standard MCP server works through it.
+ *
+ * @example
+ *   import { Server } from "https://esm.sh/@modelcontextprotocol/sdk@1.12.3/server/index.js";
+ *   import { BrokerTunnelTransport } from "./lib/broker-tunnel.js";
+ *
+ *   const server = new Server({ name: "my-provider", version: "1.0.0" },
+ *                             { capabilities: { tools: {} } });
+ *   // server.setRequestHandler(...), your tools and resources
+ *
+ *   const transport = new BrokerTunnelTransport("ws://localhost:3000/provider/my-provider");
+ *   transport.onTunnelClose = (code, reason) =>
+ *       console.log(describeTunnelClose(code, reason));
+ *   await server.connect(transport);
+ */
+
+/**
+ * MCP SDK transport backed by an outbound WebSocket to the broker.
+ *
+ * The MCP SDK owns `onmessage` / `onclose` / `onerror` (it assigns them inside
+ * `Server.connect`). The page observes the raw socket through the separate
+ * `onTunnelOpen` / `onTunnelClose` / `onTunnelError` hooks, so application code
+ * and the SDK never overwrite each other's callbacks.
+ */
+export class BrokerTunnelTransport {
+    /**
+     * @param {string} url Full provider URL, e.g. `ws://host:3000/provider/<name>`.
+     * @param {{ aggregate?: boolean }} [options] When `aggregate` is true, the
+     *   transport sends a broker registration frame on open so this server
+     *   joins the broker's `_all` aggregate slot.
+     */
+    constructor(url, options = {}) {
+        this.url = url;
+        this._ws = null;
+        this._aggregate = options.aggregate === true;
+
+        // Set by the MCP SDK inside Server.connect(), do not assign these yourself.
+        this.onmessage = null;
+        this.onclose = null;
+        this.onerror = null;
+
+        // Page-owned observation hooks, assign these before Server.connect().
+        /** @type {null | (() => void)} */
+        this.onTunnelOpen = null;
+        /** @type {null | ((code: number, reason: string) => void)} */
+        this.onTunnelClose = null;
+        /** @type {null | ((error: Error) => void)} */
+        this.onTunnelError = null;
+
+        // Last close code/reason, useful for diagnostics after the fact.
+        this.closeCode = null;
+        this.closeReason = "";
+    }
+
+    /**
+     * Opens the WebSocket. Called by `Server.connect()`. The returned promise
+     * resolves once the broker accepts the WebSocket upgrade.
+     *
+     * Note: a successful upgrade is not yet a usable slot: the broker may
+     * still reject the slot at the application layer with a 1008 close (name
+     * already taken, or reserved) a few milliseconds later. Watch
+     * `onTunnelClose` for that case.
+     *
+     * @returns {Promise<void>}
+     */
+    start() {
+        return new Promise((resolve, reject) => {
+            let opened = false;
+            const ws = new WebSocket(this.url);
+            this._ws = ws;
+
+            ws.onopen = () => {
+                opened = true;
+                // Optional broker registration frame: it MUST precede any MCP
+                // traffic, so it is sent here before start() resolves.
+                if (this._aggregate) {
+                    ws.send(JSON.stringify({ type: "register", aggregate: true }));
+                }
+                this.onTunnelOpen?.();
+                resolve();
+            };
+
+            ws.onerror = () => {
+                const err = new Error(`WebSocket error on ${this.url}`);
+                this.onTunnelError?.(err);
+                this.onerror?.(err);
+                // Reject start() only if the socket never opened: a post-open
+                // error is a runtime failure, not a connect failure.
+                if (!opened) reject(err);
+            };
+
+            ws.onclose = (ev) => {
+                this.closeCode = ev.code;
+                this.closeReason = ev.reason;
+                this.onTunnelClose?.(ev.code, ev.reason);
+                this.onclose?.();
+            };
+
+            ws.onmessage = (ev) => {
+                let parsed;
+                try {
+                    parsed = JSON.parse(typeof ev.data === "string" ? ev.data : "");
+                } catch {
+                    return; // not JSON, drop
+                }
+                this.onmessage?.(parsed);
+            };
+        });
+    }
+
+    /**
+     * Sends one JSON-RPC message. Called by the MCP SDK.
+     * @param {object} message
+     * @returns {Promise<void>}
+     */
+    send(message) {
+        if (this._ws && this._ws.readyState === WebSocket.OPEN) {
+            this._ws.send(JSON.stringify(message));
+        }
+        return Promise.resolve();
+    }
+
+    /**
+     * Closes the WebSocket. Called by `Server.close()`.
+     * @returns {Promise<void>}
+     */
+    close() {
+        this._ws?.close();
+        return Promise.resolve();
+    }
+}
+
+/** WebSocket close code the broker uses to reject a provider slot. */
+export const BROKER_REJECT_CODE = 1008;
+
+/**
+ * Turns a tunnel WebSocket close into a human-readable diagnosis: the
+ * "handshake check". Three cases matter when tunnelling to the broker:
+ *
+ * - 1008  → the broker rejected the slot (name already connected, or reserved).
+ * - closed before the tunnel was ever up → the broker is unreachable.
+ * - any other close while up → the tunnel dropped unexpectedly.
+ *
+ * @param {number} code        WebSocket close code.
+ * @param {string} reason      WebSocket close reason (may be empty).
+ * @param {boolean} wasOpen    Whether the tunnel had reached a usable state.
+ * @returns {{ level: "error" | "warn", message: string }}
+ */
+export function describeTunnelClose(code, reason, wasOpen) {
+    if (code === BROKER_REJECT_CODE) {
+        return { level: "error", message: `Broker rejected the provider slot: ${reason || "policy violation (1008)"}` };
+    }
+    if (!wasOpen) {
+        return { level: "error", message: "Broker unreachable: the WebSocket closed before the tunnel opened." };
+    }
+    if (code && code !== 1000 && code !== 1005) {
+        return { level: "warn", message: `Tunnel closed unexpectedly (code ${code}${reason ? ", " + reason : ""}).` };
+    }
+    return { level: "warn", message: "Tunnel closed." };
+}

package/dist/broker/adapters/broker.adapter.info.d.ts

@@ -1,16 +0,0 @@
-import { McpAdapterBase } from "@cyanmycelium/mcp-core";
-import type { McpResourceContent, McpToolResult } from "@cyanmycelium/mcp-core";
-import type { BrokerContext } from "../broker.context.js";
-/** URI of the static resource backing the `broker_info` snapshot. */
-export declare const BROKER_INFO_URI = "broker://info";
-/**
- * Read-only adapter that produces a snapshot of the broker's identity and
- * configuration. Backed by the live {@link BrokerContext}.
- */
-export declare class BrokerInfoAdapter extends McpAdapterBase {
-    private readonly _context;
-    constructor(_context: BrokerContext);
-    readResourceAsync(uri: string): Promise<McpResourceContent | undefined>;
-    executeToolAsync(_uri: string, toolName: string, _args: Record<string, unknown>): Promise<McpToolResult>;
-    private _snapshot;
-}

package/dist/broker/adapters/broker.adapter.info.js

@@ -1,43 +0,0 @@
-import { McpAdapterBase, McpToolResults } from "@cyanmycelium/mcp-core";
-/** URI of the static resource backing the `broker_info` snapshot. */
-export const BROKER_INFO_URI = "broker://info";
-/**
- * Read-only adapter that produces a snapshot of the broker's identity and
- * configuration. Backed by the live {@link BrokerContext}.
- */
-export class BrokerInfoAdapter extends McpAdapterBase {
-    _context;
-    constructor(_context) {
-        super("broker");
-        this._context = _context;
-    }
-    async readResourceAsync(uri) {
-        if (uri !== BROKER_INFO_URI)
-            return undefined;
-        return {
-            uri,
-            mimeType: "application/json",
-            text: JSON.stringify(this._snapshot()),
-        };
-    }
-    async executeToolAsync(_uri, toolName, _args) {
-        if (toolName !== "broker_info") {
-            return McpToolResults.error(`Unknown tool: ${toolName}`);
-        }
-        return McpToolResults.json(this._snapshot());
-    }
-    _snapshot() {
-        const c = this._context;
-        return {
-            name: c.name,
-            version: c.version,
-            startedAt: c.startedAt?.toISOString() ?? null,
-            uptimeSeconds: c.uptimeSeconds,
-            host: c.host ?? "0.0.0.0",
-            port: c.port,
-            tls: c.tls,
-            paths: c.paths,
-        };
-    }
-}
-//# sourceMappingURL=broker.adapter.info.js.map

package/dist/broker/adapters/broker.adapter.info.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"broker.adapter.info.js","sourceRoot":"","sources":["../../../src/broker/adapters/broker.adapter.info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIxE,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;AAE/C;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACpB;IAA7B,YAA6B,QAAuB;QAChD,KAAK,CAAC,QAAQ,CAAC,CAAC;QADS,aAAQ,GAAR,QAAQ,CAAe;IAEpD,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,GAAW;QACtC,IAAI,GAAG,KAAK,eAAe;YAAE,OAAO,SAAS,CAAC;QAC9C,OAAO;YACH,GAAG;YACH,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;SACzC,CAAC;IACN,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,QAAgB,EAAE,KAA8B;QACxF,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC7B,OAAO,cAAc,CAAC,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACjD,CAAC;IAEO,SAAS;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxB,OAAO;YACH,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI;YAC7C,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;YACzB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;SACjB,CAAC;IACN,CAAC;CACJ"}

package/dist/broker/adapters/broker.adapter.providers.d.ts

@@ -1,18 +0,0 @@
-import { McpAdapterBase } from "@cyanmycelium/mcp-core";
-import type { McpResourceContent, McpToolResult } from "@cyanmycelium/mcp-core";
-import type { BrokerContext } from "../broker.context.js";
-/** URI of the static resource that lists every provider slot. */
-export declare const PROVIDERS_URI = "broker://providers";
-/** RFC 6570 URI template for one specific provider slot. */
-export declare const PROVIDER_URI_TEMPLATE = "broker://providers/{name}";
-/**
- * Adapter that exposes the broker's current provider slots, both as a list
- * (read of `broker://providers`) and individually (`broker://providers/<name>`).
- */
-export declare class BrokerProvidersAdapter extends McpAdapterBase {
-    private readonly _context;
-    constructor(_context: BrokerContext);
-    readResourceAsync(uri: string): Promise<McpResourceContent | undefined>;
-    executeToolAsync(_uri: string, toolName: string, args: Record<string, unknown>): Promise<McpToolResult>;
-    private _listSnapshot;
-}

package/dist/broker/adapters/broker.adapter.providers.js

@@ -1,61 +0,0 @@
-import { McpAdapterBase, McpToolResults } from "@cyanmycelium/mcp-core";
-/** URI of the static resource that lists every provider slot. */
-export const PROVIDERS_URI = "broker://providers";
-/** RFC 6570 URI template for one specific provider slot. */
-export const PROVIDER_URI_TEMPLATE = "broker://providers/{name}";
-/**
- * Adapter that exposes the broker's current provider slots, both as a list
- * (read of `broker://providers`) and individually (`broker://providers/<name>`).
- */
-export class BrokerProvidersAdapter extends McpAdapterBase {
-    _context;
-    constructor(_context) {
-        super("broker");
-        this._context = _context;
-    }
-    async readResourceAsync(uri) {
-        if (uri === PROVIDERS_URI) {
-            return {
-                uri,
-                mimeType: "application/json",
-                text: JSON.stringify(this._listSnapshot()),
-            };
-        }
-        // broker://providers/<name>
-        const match = /^broker:\/\/providers\/([^/]+)$/.exec(uri);
-        if (match) {
-            const name = decodeURIComponent(match[1]);
-            const info = this._context.getProviderInfo(name);
-            if (!info)
-                return undefined;
-            return {
-                uri,
-                mimeType: "application/json",
-                text: JSON.stringify(info),
-            };
-        }
-        return undefined;
-    }
-    async executeToolAsync(_uri, toolName, args) {
-        switch (toolName) {
-            case "providers_list":
-                return McpToolResults.json(this._listSnapshot());
-            case "provider_status": {
-                const name = typeof args.name === "string" ? args.name : "";
-                if (!name)
-                    return McpToolResults.error('Missing required argument: "name" (string).');
-                const info = this._context.getProviderInfo(name);
-                if (!info)
-                    return McpToolResults.error(`Unknown provider: "${name}".`);
-                return McpToolResults.json(info);
-            }
-            default:
-                return McpToolResults.error(`Unknown tool: ${toolName}`);
-        }
-    }
-    _listSnapshot() {
-        const providers = this._context.getProvidersInfo();
-        return { count: providers.length, providers };
-    }
-}
-//# sourceMappingURL=broker.adapter.providers.js.map

package/dist/broker/adapters/broker.adapter.providers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"broker.adapter.providers.js","sourceRoot":"","sources":["../../../src/broker/adapters/broker.adapter.providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIxE,iEAAiE;AACjE,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAElD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAEjE;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IACzB;IAA7B,YAA6B,QAAuB;QAChD,KAAK,CAAC,QAAQ,CAAC,CAAC;QADS,aAAQ,GAAR,QAAQ,CAAe;IAEpD,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,GAAW;QACtC,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;YACxB,OAAO;gBACH,GAAG;gBACH,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;aAC7C,CAAC;QACN,CAAC;QAED,4BAA4B;QAC5B,MAAM,KAAK,GAAG,iCAAiC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAC;YAC5B,OAAO;gBACH,GAAG;gBACH,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC7B,CAAC;QACN,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,QAAgB,EAAE,IAA6B;QACvF,QAAQ,QAAQ,EAAE,CAAC;YACf,KAAK,gBAAgB;gBACjB,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;YAErD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACrB,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,IAAI,CAAC,IAAI;oBAAE,OAAO,cAAc,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;gBACtF,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBACjD,IAAI,CAAC,IAAI;oBAAE,OAAO,cAAc,CAAC,KAAK,CAAC,sBAAsB,IAAI,IAAI,CAAC,CAAC;gBACvE,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;YAED;gBACI,OAAO,cAAc,CAAC,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;IAEO,aAAa;QACjB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAClD,CAAC;CACJ"}

package/dist/broker/aggregate/aggregate.catalog.d.ts

@@ -1,54 +0,0 @@
-/**
- * AggregateCatalog — merges the tool and prompt catalogs of several providers
- * into a single namespaced view, and routes aggregated names back to their
- * origin provider.
- *
- * Aggregated names use the `<provider>-<original>` shape. Routing never parses
- * that string back: a forward lookup table is the single source of truth, so
- * the `-` separator stays safe even when provider or tool names contain dashes.
- */
-/** Minimal shape of an MCP tool entry. Extra fields are preserved as-is. */
-export interface CatalogTool {
-    name: string;
-    description?: string;
-    [key: string]: unknown;
-}
-/** Minimal shape of an MCP prompt entry. Extra fields are preserved as-is. */
-export interface CatalogPrompt {
-    name: string;
-    title?: string;
-    description?: string;
-    [key: string]: unknown;
-}
-/** One provider's raw contribution to the aggregate. */
-export interface ProviderEntry {
-    tools: CatalogTool[];
-    prompts: CatalogPrompt[];
-}
-/** Where an aggregated name routes back to. */
-export interface Route {
-    provider: string;
-    original: string;
-}
-export declare class AggregateCatalog {
-    private readonly _providers;
-    private _tools;
-    private _prompts;
-    private _toolRoutes;
-    private _promptRoutes;
-    /** Number of providers currently contributing to the aggregate. */
-    get providerCount(): number;
-    /** The merged, namespaced tool list. */
-    get tools(): CatalogTool[];
-    /** The merged, namespaced prompt list. */
-    get prompts(): CatalogPrompt[];
-    /** Adds or replaces a provider's contribution, then rebuilds the merged view. */
-    setProvider(provider: string, entry: ProviderEntry): void;
-    /** Drops a provider from the aggregate, then rebuilds. */
-    removeProvider(provider: string): void;
-    /** Resolves an aggregated tool name to its origin, or `undefined` if unknown. */
-    resolveTool(name: string): Route | undefined;
-    /** Resolves an aggregated prompt name to its origin, or `undefined` if unknown. */
-    resolvePrompt(name: string): Route | undefined;
-    private _rebuild;
-}

package/dist/broker/aggregate/aggregate.catalog.js

@@ -1,105 +0,0 @@
-/**
- * AggregateCatalog — merges the tool and prompt catalogs of several providers
- * into a single namespaced view, and routes aggregated names back to their
- * origin provider.
- *
- * Aggregated names use the `<provider>-<original>` shape. Routing never parses
- * that string back: a forward lookup table is the single source of truth, so
- * the `-` separator stays safe even when provider or tool names contain dashes.
- */
-/** Separator between the provider prefix and the original name. */
-const SEPARATOR = "-";
-/** Anthropic API tool-name limit; aggregated tool names must fit inside it. */
-const MAX_TOOL_NAME_LENGTH = 64;
-export class AggregateCatalog {
-    _providers = new Map();
-    _tools = [];
-    _prompts = [];
-    _toolRoutes = new Map();
-    _promptRoutes = new Map();
-    /** Number of providers currently contributing to the aggregate. */
-    get providerCount() {
-        return this._providers.size;
-    }
-    /** The merged, namespaced tool list. */
-    get tools() {
-        return this._tools;
-    }
-    /** The merged, namespaced prompt list. */
-    get prompts() {
-        return this._prompts;
-    }
-    /** Adds or replaces a provider's contribution, then rebuilds the merged view. */
-    setProvider(provider, entry) {
-        this._providers.set(provider, entry);
-        this._rebuild();
-    }
-    /** Drops a provider from the aggregate, then rebuilds. */
-    removeProvider(provider) {
-        if (this._providers.delete(provider))
-            this._rebuild();
-    }
-    /** Resolves an aggregated tool name to its origin, or `undefined` if unknown. */
-    resolveTool(name) {
-        return this._toolRoutes.get(name);
-    }
-    /** Resolves an aggregated prompt name to its origin, or `undefined` if unknown. */
-    resolvePrompt(name) {
-        return this._promptRoutes.get(name);
-    }
-    _rebuild() {
-        const tools = [];
-        const prompts = [];
-        const toolRoutes = new Map();
-        const promptRoutes = new Map();
-        for (const [provider, entry] of this._providers) {
-            for (const tool of entry.tools) {
-                const name = unique(capToolName(prefixed(provider, tool.name)), toolRoutes);
-                toolRoutes.set(name, { provider, original: tool.name });
-                tools.push({ ...tool, name, description: tag(provider, tool.description) });
-            }
-            for (const prompt of entry.prompts) {
-                const name = unique(prefixed(provider, prompt.name), promptRoutes);
-                promptRoutes.set(name, { provider, original: prompt.name });
-                prompts.push({ ...prompt, name, description: tag(provider, prompt.description) });
-            }
-        }
-        this._tools = tools;
-        this._prompts = prompts;
-        this._toolRoutes = toolRoutes;
-        this._promptRoutes = promptRoutes;
-    }
-}
-function prefixed(provider, original) {
-    return `${provider}${SEPARATOR}${original}`;
-}
-/** Tags a description with the origin provider so the model and user see the source. */
-function tag(provider, description) {
-    const label = `[${provider}]`;
-    return description ? `${label} ${description}` : label;
-}
-/** Caps a tool name to the API limit, replacing the overflow with a stable hash. */
-function capToolName(name) {
-    if (name.length <= MAX_TOOL_NAME_LENGTH)
-        return name;
-    const hash = djb2(name);
-    return name.slice(0, MAX_TOOL_NAME_LENGTH - hash.length - 1) + SEPARATOR + hash;
-}
-/** Disambiguates a name already present in `taken` by appending `-2`, `-3`, ... */
-function unique(candidate, taken) {
-    if (!taken.has(candidate))
-        return candidate;
-    let n = 2;
-    while (taken.has(`${candidate}${SEPARATOR}${n}`))
-        n++;
-    return `${candidate}${SEPARATOR}${n}`;
-}
-/** Small deterministic string hash rendered as 8 base-36 characters. */
-function djb2(input) {
-    let h = 5381;
-    for (let i = 0; i < input.length; i++) {
-        h = ((h << 5) + h + input.charCodeAt(i)) >>> 0;
-    }
-    return h.toString(36).padStart(8, "0").slice(-8);
-}
-//# sourceMappingURL=aggregate.catalog.js.map

package/dist/broker/aggregate/aggregate.catalog.js.map

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

package/dist/broker/aggregate/aggregate.server.d.ts

@@ -1,47 +0,0 @@
-import type { IMessageTransport } from "@cyanmycelium/mcp-core";
-import type { InternalClient } from "../../ws.tunnel.js";
-/** Opens an in-process client to a named provider slot. Supplied by WsTunnel. */
-export type InternalClientFactory = (providerName: string) => InternalClient;
-/**
- * The `_all` aggregate MCP server. Presents the union of every opted-in
- * provider's tools and prompts as a single MCP server, reachable on the
- * reserved `_all` slot.
- *
- * It implements {@link IMessageTransport} so it can be registered on the
- * WsTunnel as a loopback provider: `send` receives client requests, `onMessage`
- * (assigned by the tunnel) carries responses and notifications back to clients.
- */
-export declare class AggregateServer implements IMessageTransport {
-    /** Reserved provider slot the aggregate is published on. */
-    static readonly SLOT = "_all";
-    private readonly _catalog;
-    private readonly _sessions;
-    private readonly _openClient;
-    private _running;
-    onMessage: ((data: string) => void) | null;
-    onOpen: (() => void) | null;
-    onClose: (() => void) | null;
-    onError: ((error: Error) => void) | null;
-    constructor(openClient: InternalClientFactory);
-    get isOpen(): boolean;
-    /** Number of providers currently in the aggregate. */
-    get providerCount(): number;
-    /** Marks the aggregate transport open. Call before registering it. */
-    start(): void;
-    /** WsTunnel hands a client request for the `_all` slot here. */
-    send(data: string): void;
-    /** Closes every provider session and the aggregate transport. */
-    close(): void;
-    /**
-     * Adds a provider to the aggregate: opens an internal client, runs the
-     * session handshake, and merges the provider's catalog. A no-op for an
-     * already-aggregated provider or the reserved `_all` slot itself.
-     */
-    addProvider(name: string): Promise<void>;
-    /** Removes a provider from the aggregate. */
-    removeProvider(name: string): void;
-    private _handleClientMessage;
-    private _route;
-    private _reply;
-    private _emitListChanged;
-}