@webmcp-auto-ui/core 2.5.35 → 2.5.37

package/dist/index.d.ts

@@ -9,8 +9,6 @@ export type { SchemaPatch } from './utils.js';
 export { textResult, jsonResult, } from './webmcp-helpers.js';
 export { McpMultiClient } from './multi-client.js';
 export type { ConnectedServer } from './multi-client.js';
-export { MultiMcpBridge, installMultiMcpBridge, parseRecipesFromToolResponse } from './multi-mcp-bridge.js';
-export type { MultiMcpBridgeOptions } from './multi-mcp-bridge.js';
 export { createWebMcpServer, parseFrontmatter, mountWidget } from './webmcp-server.js';
 export type { WebMcpServer, WebMcpServerOptions, WebMcpToolDef, WidgetEntry, WidgetRenderer, McpRecipeSummary } from './webmcp-server.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC5G,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACvF,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACvF,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -14,8 +14,6 @@ export { dispatchAndWait, signalCompletion, sanitizeSchema, sanitizeSchemaWithRe
 export { textResult, jsonResult, } from './webmcp-helpers.js';
 // Multi-MCP client
 export { McpMultiClient } from './multi-client.js';
-// Multi-MCP bridge (canvas store <-> McpMultiClient reconciler)
-export { MultiMcpBridge, installMultiMcpBridge, parseRecipesFromToolResponse } from './multi-mcp-bridge.js';
 // WebMCP Server
 export { createWebMcpServer, parseFrontmatter, mountWidget } from './webmcp-server.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,+DAA+D;AAiD/D,aAAa;AACb,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,WAAW;AACX,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,qBAAqB;AACrB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY;AACZ,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,mCAAmC;AACnC,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAC;AAE7B,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,gEAAgE;AAChE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAG5G,gBAAgB;AAChB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,+DAA+D;AAiD/D,aAAa;AACb,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,WAAW;AACX,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,qBAAqB;AACrB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY;AACZ,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,mCAAmC;AACnC,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAC;AAE7B,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,gBAAgB;AAChB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/multi-client.d.ts

@@ -4,10 +4,6 @@ export interface ConnectedServer {
     name: string;
     tools: McpTool[];
 }
-export type AggregatedTool = McpTool & {
-    serverUrl: string;
-    serverName: string;
-};
 export declare class McpMultiClient {
     /** Ordered map — insertion order determines first-match priority */
     private servers;
@@ -29,19 +25,6 @@ export declare class McpMultiClient {
      * List all connected servers with their metadata.
      */
     listServers(): ConnectedServer[];
-    /**
-     * List ALL tools from ALL connected servers.
-     * Each tool is augmented with its origin server URL and name.
-     * Duplicate tool names across servers are prefixed with the server name
-     * (e.g. "wikipedia__search") to satisfy the Claude API uniqueness constraint.
-     */
-    listAllTools(): AggregatedTool[];
-    /**
-     * Call a tool by name. Automatically routes to the correct server.
-     * Supports both plain names ("search") and prefixed names ("wikipedia__search")
-     * for disambiguated duplicates.
-     */
-    callTool(name: string, args?: Record<string, unknown>): Promise<McpToolResult>;
     /**
      * Call a tool on a SPECIFIC server (identified by URL).
      * Use this instead of callTool() when the same tool name may exist on multiple
@@ -52,8 +35,6 @@ export declare class McpMultiClient {
      * Disconnect from all servers.
      */
     disconnectAll(): Promise<void>;
-    /** Convert a server name to a snake_case prefix for tool name disambiguation. */
-    private normalizeServerName;
     /** Number of connected servers. */
     get serverCount(): number;
     /** True if at least one server is connected. */

package/dist/multi-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi-client.d.ts","sourceRoot":"","sources":["../src/multi-client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EAEd,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAMjF,qBAAa,cAAc;IACzB,oEAAoE;IACpE,OAAO,CAAC,OAAO,CAA4E;IAM3F;;;OAGG;IACG,SAAS,CACb,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAC7C,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAqB9C;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C;;OAEG;IACH,WAAW,IAAI,eAAe,EAAE;IAQhC;;;;;OAKG;IACH,YAAY,IAAI,cAAc,EAAE;IA+BhC;;;;OAIG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IA2BpF;;;;OAIG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAMzG;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAapC,iFAAiF;IACjF,OAAO,CAAC,mBAAmB;IAQ3B,mCAAmC;IACnC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,gDAAgD;IAChD,IAAI,cAAc,IAAI,OAAO,CAE5B;CACF"}
+{"version":3,"file":"multi-client.d.ts","sourceRoot":"","sources":["../src/multi-client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EAEd,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAMD,qBAAa,cAAc;IACzB,oEAAoE;IACpE,OAAO,CAAC,OAAO,CAA4E;IAM3F;;;OAGG;IACG,SAAS,CACb,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAC7C,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAgC9C;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C;;OAEG;IACH,WAAW,IAAI,eAAe,EAAE;IAQhC;;;;OAIG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAMzG;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAapC,mCAAmC;IACnC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,gDAAgD;IAChD,IAAI,cAAc,IAAI,OAAO,CAE5B;CACF"}

package/dist/multi-client.js

@@ -28,6 +28,17 @@ export class McpMultiClient {
         const client = new McpClient(url, clientOptions);
         const initResult = await client.connect();
         const tools = await client.listTools();
+        // -----------------------------------------------------------------------
+        // Cosmetic rebrand map: some MCP servers expose a `serverInfo.name` that
+        // doesn't match the public-facing brand we want to display in the UI. The
+        // Tricoteuses MCP server, for instance, declares itself as "moulineuse"
+        // (internal codename) but ships under the "Tricoteuses" brand. Rather
+        // than patch the upstream server, we rebadge the name on the client.
+        //
+        // TODO(2026-05-03): migrate this to an external config (e.g. a per-app
+        // `serverAliases` option passed to McpMultiClient) so that the core
+        // package has zero brand-specific knowledge baked in.
+        // -----------------------------------------------------------------------
         const SERVER_NAME_MAP = { 'moulineuse': 'Tricoteuses' };
         const name = SERVER_NAME_MAP[initResult.serverInfo.name] ?? initResult.serverInfo.name;
         this.servers.set(url, { client, name, tools });
@@ -53,71 +64,6 @@ export class McpMultiClient {
         }
         return result;
     }
-    /**
-     * List ALL tools from ALL connected servers.
-     * Each tool is augmented with its origin server URL and name.
-     * Duplicate tool names across servers are prefixed with the server name
-     * (e.g. "wikipedia__search") to satisfy the Claude API uniqueness constraint.
-     */
-    listAllTools() {
-        // First pass: count occurrences of each tool name across all servers
-        const nameCounts = new Map();
-        for (const [, entry] of this.servers) {
-            for (const tool of entry.tools) {
-                nameCounts.set(tool.name, (nameCounts.get(tool.name) ?? 0) + 1);
-            }
-        }
-        // Second pass: build result, prefixing duplicates with serverName
-        const result = [];
-        for (const [url, entry] of this.servers) {
-            for (const tool of entry.tools) {
-                const isDuplicate = (nameCounts.get(tool.name) ?? 0) > 1;
-                if (isDuplicate) {
-                    const prefix = this.normalizeServerName(entry.name);
-                    result.push({
-                        ...tool,
-                        name: `${prefix}__${tool.name}`,
-                        description: `[${entry.name}] ${tool.description ?? ''}`,
-                        serverUrl: url,
-                        serverName: entry.name,
-                    });
-                }
-                else {
-                    result.push({ ...tool, serverUrl: url, serverName: entry.name });
-                }
-            }
-        }
-        return result;
-    }
-    /**
-     * Call a tool by name. Automatically routes to the correct server.
-     * Supports both plain names ("search") and prefixed names ("wikipedia__search")
-     * for disambiguated duplicates.
-     */
-    async callTool(name, args) {
-        // 1. Exact match on original tool name (unprefixed)
-        for (const [, entry] of this.servers) {
-            const match = entry.tools.find((t) => t.name === name);
-            if (match) {
-                return entry.client.callTool(name, args);
-            }
-        }
-        // 2. Prefixed name: "serverprefix__realToolName"
-        const separatorIdx = name.indexOf('__');
-        if (separatorIdx !== -1) {
-            const prefix = name.slice(0, separatorIdx);
-            const realName = name.slice(separatorIdx + 2);
-            for (const [, entry] of this.servers) {
-                if (this.normalizeServerName(entry.name) === prefix) {
-                    const match = entry.tools.find((t) => t.name === realName);
-                    if (match) {
-                        return entry.client.callTool(realName, args);
-                    }
-                }
-            }
-        }
-        throw new Error(`McpMultiClient: no server exposes tool "${name}"`);
-    }
     /**
      * Call a tool on a SPECIFIC server (identified by URL).
      * Use this instead of callTool() when the same tool name may exist on multiple
@@ -141,13 +87,6 @@ export class McpMultiClient {
         this.servers.clear();
     }
     // -------------------------------------------------------------------------
-    // Private helpers
-    // -------------------------------------------------------------------------
-    /** Convert a server name to a snake_case prefix for tool name disambiguation. */
-    normalizeServerName(name) {
-        return name.toLowerCase().replace(/[^a-z0-9_-]+/g, '_').replace(/_{2,}/g, '_').replace(/^_|_$/g, '');
-    }
-    // -------------------------------------------------------------------------
     // Getters
     // -------------------------------------------------------------------------
     /** Number of connected servers. */

package/dist/multi-client.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webmcp-auto-ui/core",
-  "version": "2.5.35",
+  "version": "2.5.37",
   "description": "W3C WebMCP polyfill + MCP Streamable HTTP client — zero dependencies, framework-agnostic",
   "license": "AGPL-3.0-or-later",
   "author": "jb@media.mit.edu",

package/src/index.d.ts

@@ -9,7 +9,5 @@ export type { SchemaPatch } from './utils.js';
 export { textResult, jsonResult, } from './webmcp-helpers.js';
 export { McpMultiClient } from './multi-client.js';
 export type { ConnectedServer } from './multi-client.js';
-export { MultiMcpBridge, installMultiMcpBridge, parseRecipesFromToolResponse } from './multi-mcp-bridge.js';
-export type { MultiMcpBridgeOptions } from './multi-mcp-bridge.js';
 export { createWebMcpServer, parseFrontmatter, mountWidget } from './webmcp-server.js';
 export type { WebMcpServer, WebMcpServerOptions, WebMcpToolDef, WidgetEntry, WidgetRenderer, McpRecipeSummary } from './webmcp-server.js';

package/src/index.ts

@@ -93,10 +93,6 @@ export {
 export { McpMultiClient } from './multi-client.js';
 export type { ConnectedServer } from './multi-client.js';
 
-// Multi-MCP bridge (canvas store <-> McpMultiClient reconciler)
-export { MultiMcpBridge, installMultiMcpBridge, parseRecipesFromToolResponse } from './multi-mcp-bridge.js';
-export type { MultiMcpBridgeOptions } from './multi-mcp-bridge.js';
-
 // WebMCP Server
 export { createWebMcpServer, parseFrontmatter, mountWidget } from './webmcp-server.js';
 export type { WebMcpServer, WebMcpServerOptions, WebMcpToolDef, WidgetEntry, WidgetRenderer, McpRecipeSummary } from './webmcp-server.js';

package/src/multi-client.d.ts

@@ -4,10 +4,6 @@ export interface ConnectedServer {
     name: string;
     tools: McpTool[];
 }
-export type AggregatedTool = McpTool & {
-    serverUrl: string;
-    serverName: string;
-};
 export declare class McpMultiClient {
     /** Ordered map — insertion order determines first-match priority */
     private servers;
@@ -29,19 +25,6 @@ export declare class McpMultiClient {
      * List all connected servers with their metadata.
      */
     listServers(): ConnectedServer[];
-    /**
-     * List ALL tools from ALL connected servers.
-     * Each tool is augmented with its origin server URL and name.
-     * Duplicate tool names across servers are prefixed with the server name
-     * (e.g. "wikipedia__search") to satisfy the Claude API uniqueness constraint.
-     */
-    listAllTools(): AggregatedTool[];
-    /**
-     * Call a tool by name. Automatically routes to the correct server.
-     * Supports both plain names ("search") and prefixed names ("wikipedia__search")
-     * for disambiguated duplicates.
-     */
-    callTool(name: string, args?: Record<string, unknown>): Promise<McpToolResult>;
     /**
      * Call a tool on a SPECIFIC server (identified by URL).
      * Use this instead of callTool() when the same tool name may exist on multiple
@@ -52,8 +35,6 @@ export declare class McpMultiClient {
      * Disconnect from all servers.
      */
     disconnectAll(): Promise<void>;
-    /** Convert a server name to a snake_case prefix for tool name disambiguation. */
-    private normalizeServerName;
     /** Number of connected servers. */
     get serverCount(): number;
     /** True if at least one server is connected. */

package/src/multi-client.ts

@@ -21,8 +21,6 @@ export interface ConnectedServer {
   tools: McpTool[];
 }
 
-export type AggregatedTool = McpTool & { serverUrl: string; serverName: string };
-
 // ---------------------------------------------------------------------------
 // McpMultiClient
 // ---------------------------------------------------------------------------
@@ -56,6 +54,17 @@ export class McpMultiClient {
     const initResult = await client.connect();
     const tools = await client.listTools();
 
+    // -----------------------------------------------------------------------
+    // Cosmetic rebrand map: some MCP servers expose a `serverInfo.name` that
+    // doesn't match the public-facing brand we want to display in the UI. The
+    // Tricoteuses MCP server, for instance, declares itself as "moulineuse"
+    // (internal codename) but ships under the "Tricoteuses" brand. Rather
+    // than patch the upstream server, we rebadge the name on the client.
+    //
+    // TODO(2026-05-03): migrate this to an external config (e.g. a per-app
+    // `serverAliases` option passed to McpMultiClient) so that the core
+    // package has zero brand-specific knowledge baked in.
+    // -----------------------------------------------------------------------
     const SERVER_NAME_MAP: Record<string, string> = { 'moulineuse': 'Tricoteuses' };
     const name = SERVER_NAME_MAP[initResult.serverInfo.name] ?? initResult.serverInfo.name;
     this.servers.set(url, { client, name, tools });
@@ -84,75 +93,6 @@ export class McpMultiClient {
     return result;
   }
 
-  /**
-   * List ALL tools from ALL connected servers.
-   * Each tool is augmented with its origin server URL and name.
-   * Duplicate tool names across servers are prefixed with the server name
-   * (e.g. "wikipedia__search") to satisfy the Claude API uniqueness constraint.
-   */
-  listAllTools(): AggregatedTool[] {
-    // First pass: count occurrences of each tool name across all servers
-    const nameCounts = new Map<string, number>();
-    for (const [, entry] of this.servers) {
-      for (const tool of entry.tools) {
-        nameCounts.set(tool.name, (nameCounts.get(tool.name) ?? 0) + 1);
-      }
-    }
-
-    // Second pass: build result, prefixing duplicates with serverName
-    const result: AggregatedTool[] = [];
-    for (const [url, entry] of this.servers) {
-      for (const tool of entry.tools) {
-        const isDuplicate = (nameCounts.get(tool.name) ?? 0) > 1;
-        if (isDuplicate) {
-          const prefix = this.normalizeServerName(entry.name);
-          result.push({
-            ...tool,
-            name: `${prefix}__${tool.name}`,
-            description: `[${entry.name}] ${tool.description ?? ''}`,
-            serverUrl: url,
-            serverName: entry.name,
-          });
-        } else {
-          result.push({ ...tool, serverUrl: url, serverName: entry.name });
-        }
-      }
-    }
-    return result;
-  }
-
-  /**
-   * Call a tool by name. Automatically routes to the correct server.
-   * Supports both plain names ("search") and prefixed names ("wikipedia__search")
-   * for disambiguated duplicates.
-   */
-  async callTool(name: string, args?: Record<string, unknown>): Promise<McpToolResult> {
-    // 1. Exact match on original tool name (unprefixed)
-    for (const [, entry] of this.servers) {
-      const match = entry.tools.find((t) => t.name === name);
-      if (match) {
-        return entry.client.callTool(name, args);
-      }
-    }
-
-    // 2. Prefixed name: "serverprefix__realToolName"
-    const separatorIdx = name.indexOf('__');
-    if (separatorIdx !== -1) {
-      const prefix = name.slice(0, separatorIdx);
-      const realName = name.slice(separatorIdx + 2);
-      for (const [, entry] of this.servers) {
-        if (this.normalizeServerName(entry.name) === prefix) {
-          const match = entry.tools.find((t) => t.name === realName);
-          if (match) {
-            return entry.client.callTool(realName, args);
-          }
-        }
-      }
-    }
-
-    throw new Error(`McpMultiClient: no server exposes tool "${name}"`);
-  }
-
   /**
    * Call a tool on a SPECIFIC server (identified by URL).
    * Use this instead of callTool() when the same tool name may exist on multiple
@@ -176,15 +116,6 @@ export class McpMultiClient {
     this.servers.clear();
   }
 
-  // -------------------------------------------------------------------------
-  // Private helpers
-  // -------------------------------------------------------------------------
-
-  /** Convert a server name to a snake_case prefix for tool name disambiguation. */
-  private normalizeServerName(name: string): string {
-    return name.toLowerCase().replace(/[^a-z0-9_-]+/g, '_').replace(/_{2,}/g, '_').replace(/^_|_$/g, '');
-  }
-
   // -------------------------------------------------------------------------
   // Getters
   // -------------------------------------------------------------------------

package/dist/multi-mcp-bridge.d.ts

@@ -1,61 +0,0 @@
-import { McpMultiClient } from './multi-client.js';
-import type { McpToolResult } from './types.js';
-export interface MultiMcpBridgeOptions {
-    /** Accessor for the canvas store. Typically returns globalThis.__canvasVanilla. */
-    getCanvas: () => any;
-    /** Optional logger. */
-    log?: (msg: string, data?: any) => void;
-}
-interface RecipeItem {
-    name: string;
-    description?: string;
-    body?: string;
-}
-/**
- * Extract recipes from an MCP tool response. Expects `res.content` as the
- * standard MCP content array; looks for a text chunk whose payload parses as
- * JSON and contains an array of `{ name, description?, body? }` items (or an
- * object with an `items`/`recipes` array).
- */
-export declare function parseRecipesFromToolResponse(res: unknown): RecipeItem[] | null;
-export declare class MultiMcpBridge {
-    private client;
-    private unsub;
-    /** server name -> url (for reverse lookup, since McpMultiClient keys by url) */
-    private nameToUrl;
-    /** server names currently connected */
-    private connected;
-    /** server names whose handshake is in-flight */
-    private connecting;
-    private options;
-    private started;
-    constructor(options: MultiMcpBridgeOptions);
-    start(): void;
-    stop(): void;
-    /** Ensure a server is in the store with enabled=true; reconcile picks it up. */
-    connect(name: string, url: string): Promise<void>;
-    /** Call a tool on a named server. */
-    callTool(serverName: string, toolName: string, args: unknown): Promise<McpToolResult>;
-    /** Direct access to the underlying multi-client (read-only usage preferred). */
-    get multiClient(): McpMultiClient;
-    /** True if a server with this name has completed its handshake. */
-    hasServer(serverName: string): boolean;
-    /** Snapshot of currently connected server names. */
-    connectedServers(): string[];
-    /**
-     * Wait until every enabled data server in the canvas is connected, or the
-     * timeout elapses. Resolves either way (no throw) — caller inspects
-     * `connectedServers()` to decide what's reachable.
-     */
-    waitForEnabledServers(timeoutMs?: number): Promise<void>;
-    private reconcile;
-    private handshake;
-    private disconnect;
-}
-/**
- * Install a singleton bridge on globalThis.__multiMcp. If a previous bridge
- * exists, it is stopped first (idempotent).
- */
-export declare function installMultiMcpBridge(options: MultiMcpBridgeOptions): MultiMcpBridge;
-export {};
-//# sourceMappingURL=multi-mcp-bridge.d.ts.map

package/dist/multi-mcp-bridge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multi-mcp-bridge.d.ts","sourceRoot":"","sources":["../src/multi-mcp-bridge.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAW,aAAa,EAAE,MAAM,YAAY,CAAC;AAMzD,MAAM,WAAW,qBAAqB;IACpC,mFAAmF;IACnF,SAAS,EAAE,MAAM,GAAG,CAAC;IACrB,uBAAuB;IACvB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CACzC;AASD,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,EAAE,GAAG,IAAI,CAmB9E;AA4BD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,KAAK,CAA6B;IAC1C,gFAAgF;IAChF,OAAO,CAAC,SAAS,CAA6B;IAC9C,uCAAuC;IACvC,OAAO,CAAC,SAAS,CAAqB;IACtC,gDAAgD;IAChD,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,qBAAqB;IAS1C,KAAK,IAAI,IAAI;IAgBb,IAAI,IAAI,IAAI;IAiBZ,gFAAgF;IAC1E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD,qCAAqC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAM3F,gFAAgF;IAChF,IAAI,WAAW,IAAI,cAAc,CAEhC;IAED,mEAAmE;IACnE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAItC,oDAAoD;IACpD,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;;;OAIG;IACG,qBAAqB,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAmB9C,SAAS;YAkCT,SAAS;YA6CT,UAAU;CAWzB;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAUpF"}

package/dist/multi-mcp-bridge.js

@@ -1,294 +0,0 @@
-// ---------------------------------------------------------------------------
-// @webmcp-auto-ui/core — MultiMcpBridge
-// Observes a canvas store with a `dataServers` field and reconciles the real
-// MCP connection state with the user intent (`enabled`). Populates tools and
-// recipes metadata back into the store. Framework-agnostic.
-// ---------------------------------------------------------------------------
-import { McpMultiClient } from './multi-client.js';
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/**
- * Extract recipes from an MCP tool response. Expects `res.content` as the
- * standard MCP content array; looks for a text chunk whose payload parses as
- * JSON and contains an array of `{ name, description?, body? }` items (or an
- * object with an `items`/`recipes` array).
- */
-export function parseRecipesFromToolResponse(res) {
-    if (!res || typeof res !== 'object')
-        return null;
-    const content = res.content;
-    if (!Array.isArray(content))
-        return null;
-    for (const chunk of content) {
-        if (!chunk || typeof chunk !== 'object')
-            continue;
-        if (chunk.type !== 'text' || typeof chunk.text !== 'string')
-            continue;
-        const text = chunk.text;
-        let parsed;
-        try {
-            parsed = JSON.parse(text);
-        }
-        catch {
-            continue;
-        }
-        const items = extractItems(parsed);
-        if (items)
-            return items;
-    }
-    return null;
-}
-function extractItems(parsed) {
-    const candidate = Array.isArray(parsed)
-        ? parsed
-        : Array.isArray(parsed?.items)
-            ? parsed.items
-            : Array.isArray(parsed?.recipes)
-                ? parsed.recipes
-                : null;
-    if (!candidate)
-        return null;
-    const out = [];
-    for (const it of candidate) {
-        if (!it || typeof it !== 'object')
-            continue;
-        const name = typeof it.name === 'string' ? it.name : typeof it.id === 'string' ? it.id : null;
-        if (!name)
-            continue;
-        const entry = { name };
-        if (typeof it.description === 'string')
-            entry.description = it.description;
-        if (typeof it.body === 'string')
-            entry.body = it.body;
-        out.push(entry);
-    }
-    return out.length > 0 ? out : null;
-}
-// ---------------------------------------------------------------------------
-// MultiMcpBridge
-// ---------------------------------------------------------------------------
-export class MultiMcpBridge {
-    client;
-    unsub = null;
-    /** server name -> url (for reverse lookup, since McpMultiClient keys by url) */
-    nameToUrl = new Map();
-    /** server names currently connected */
-    connected = new Set();
-    /** server names whose handshake is in-flight */
-    connecting = new Set();
-    options;
-    started = false;
-    constructor(options) {
-        this.options = options;
-        this.client = new McpMultiClient();
-    }
-    // -------------------------------------------------------------------------
-    // Lifecycle
-    // -------------------------------------------------------------------------
-    start() {
-        if (this.started)
-            return;
-        const canvas = this.options.getCanvas();
-        if (canvas && typeof canvas.subscribe === 'function') {
-            this.started = true;
-            this.unsub = canvas.subscribe(() => {
-                void this.reconcile();
-            });
-            void this.reconcile();
-            return;
-        }
-        // Canvas not ready yet — retry shortly. Without this the bridge would
-        // stay dead forever because no subscription was ever established.
-        setTimeout(() => this.start(), 50);
-    }
-    stop() {
-        if (!this.started)
-            return;
-        this.started = false;
-        if (this.unsub) {
-            try {
-                this.unsub();
-            }
-            catch { /* ignore */ }
-            this.unsub = null;
-        }
-        void this.client.disconnectAll().catch(() => { });
-        this.connected.clear();
-        this.connecting.clear();
-        this.nameToUrl.clear();
-    }
-    // -------------------------------------------------------------------------
-    // Imperative helpers
-    // -------------------------------------------------------------------------
-    /** Ensure a server is in the store with enabled=true; reconcile picks it up. */
-    async connect(name, url) {
-        const canvas = this.options.getCanvas();
-        if (!canvas)
-            return;
-        canvas.addDataServer?.({ name, url });
-        canvas.setDataServerEnabled?.(name, true);
-        await this.reconcile();
-    }
-    /** Call a tool on a named server. */
-    async callTool(serverName, toolName, args) {
-        const url = this.nameToUrl.get(serverName);
-        if (!url)
-            throw new Error(`MultiMcpBridge: server "${serverName}" is not connected`);
-        return this.client.callToolOn(url, toolName, (args ?? {}));
-    }
-    /** Direct access to the underlying multi-client (read-only usage preferred). */
-    get multiClient() {
-        return this.client;
-    }
-    /** True if a server with this name has completed its handshake. */
-    hasServer(serverName) {
-        return this.connected.has(serverName);
-    }
-    /** Snapshot of currently connected server names. */
-    connectedServers() {
-        return Array.from(this.connected);
-    }
-    /**
-     * Wait until every enabled data server in the canvas is connected, or the
-     * timeout elapses. Resolves either way (no throw) — caller inspects
-     * `connectedServers()` to decide what's reachable.
-     */
-    async waitForEnabledServers(timeoutMs = 5000) {
-        const canvas = this.options.getCanvas();
-        if (!canvas)
-            return;
-        const deadline = Date.now() + Math.max(0, timeoutMs);
-        while (Date.now() < deadline) {
-            const enabled = (Array.isArray(canvas.dataServers) ? canvas.dataServers : [])
-                .filter((s) => s?.enabled !== false)
-                .map((s) => s.name);
-            if (enabled.length === 0)
-                return;
-            const allReady = enabled.every((n) => this.connected.has(n));
-            if (allReady)
-                return;
-            await new Promise((r) => setTimeout(r, 100));
-        }
-    }
-    // -------------------------------------------------------------------------
-    // Reconciliation
-    // -------------------------------------------------------------------------
-    async reconcile() {
-        const canvas = this.options.getCanvas();
-        if (!canvas)
-            return;
-        const servers = (canvas.dataServers ?? []);
-        if (!Array.isArray(servers))
-            return;
-        const seenNames = new Set();
-        for (const srv of servers) {
-            if (!srv || typeof srv.name !== 'string' || typeof srv.url !== 'string')
-                continue;
-            // Empty URL means a legacy placeholder entry (see canvas.ensurePrimary).
-            // Handshaking with '' resolves `fetch('')` against the current page origin,
-            // producing a POST storm on the app root (405 loop).
-            if (srv.url === '')
-                continue;
-            seenNames.add(srv.name);
-            const key = srv.name;
-            if (srv.enabled && !this.connected.has(key) && !this.connecting.has(key)) {
-                // Mark as connecting synchronously before the async handshake runs,
-                // so a concurrent reconcile() can't slip past the guard and spawn
-                // a second handshake for the same server.
-                this.connecting.add(key);
-                void this.handshake(srv);
-            }
-            else if (!srv.enabled && this.connected.has(key)) {
-                void this.disconnect(srv);
-            }
-        }
-        // Disconnect servers that were removed from the store entirely
-        for (const name of Array.from(this.connected)) {
-            if (!seenNames.has(name)) {
-                void this.disconnect({ name, url: this.nameToUrl.get(name) ?? '' });
-            }
-        }
-    }
-    async handshake(srv) {
-        const canvas = this.options.getCanvas();
-        // connecting.add is performed by reconcile() synchronously; don't re-add here.
-        this.options.log?.(`[bridge] handshake start: ${srv.name}`, { url: srv.url });
-        try {
-            const { name: actualName, tools } = await this.client.addServer(srv.url);
-            // The MCP server may return a different name than the one stored in the
-            // canvas. Key the bridge by the canvas name so callers stay consistent.
-            this.nameToUrl.set(srv.name, srv.url);
-            this.connected.add(srv.name);
-            // Try to fetch recipes via tool `list_recipes` if exposed.
-            let recipes = [];
-            const hasListRecipes = tools.some((t) => t.name === 'list_recipes');
-            if (hasListRecipes) {
-                try {
-                    const res = await this.client.callToolOn(srv.url, 'list_recipes', {});
-                    recipes = parseRecipesFromToolResponse(res) ?? [];
-                }
-                catch (err) {
-                    this.options.log?.(`[bridge] list_recipes failed for ${srv.name}`, err);
-                }
-            }
-            canvas.setDataServerMeta?.(srv.name, {
-                connected: true,
-                tools,
-                recipes,
-                error: undefined,
-                serverName: actualName,
-            });
-            this.options.log?.(`[bridge] connected: ${srv.name}`, { tools: tools.length, recipes: recipes.length });
-        }
-        catch (err) {
-            const message = err?.message ? String(err.message) : String(err);
-            canvas.setDataServerMeta?.(srv.name, {
-                connected: false,
-                tools: [],
-                recipes: [],
-                error: message,
-            });
-            this.options.log?.(`[bridge] handshake failed: ${srv.name}`, message);
-        }
-        finally {
-            this.connecting.delete(srv.name);
-        }
-    }
-    async disconnect(srv) {
-        const canvas = this.options.getCanvas();
-        const url = srv.url || this.nameToUrl.get(srv.name);
-        if (url) {
-            try {
-                await this.client.removeServer(url);
-            }
-            catch { /* ignore */ }
-        }
-        this.connected.delete(srv.name);
-        this.nameToUrl.delete(srv.name);
-        canvas?.setDataServerMeta?.(srv.name, { connected: false });
-        this.options.log?.(`[bridge] disconnected: ${srv.name}`);
-    }
-}
-// ---------------------------------------------------------------------------
-// Singleton installer
-// ---------------------------------------------------------------------------
-/**
- * Install a singleton bridge on globalThis.__multiMcp. If a previous bridge
- * exists, it is stopped first (idempotent).
- */
-export function installMultiMcpBridge(options) {
-    const g = globalThis;
-    const existing = g.__multiMcp;
-    if (existing && typeof existing.stop === 'function') {
-        try {
-            existing.stop();
-        }
-        catch { /* ignore */ }
-    }
-    const bridge = new MultiMcpBridge(options);
-    g.__multiMcp = bridge;
-    bridge.start();
-    return bridge;
-}
-//# sourceMappingURL=multi-mcp-bridge.js.map

package/dist/multi-mcp-bridge.js.map

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

package/src/multi-mcp-bridge.d.ts

@@ -1,60 +0,0 @@
-import { McpMultiClient } from './multi-client.js';
-import type { McpToolResult } from './types.js';
-export interface MultiMcpBridgeOptions {
-    /** Accessor for the canvas store. Typically returns globalThis.__canvasVanilla. */
-    getCanvas: () => any;
-    /** Optional logger. */
-    log?: (msg: string, data?: any) => void;
-}
-interface RecipeItem {
-    name: string;
-    description?: string;
-    body?: string;
-}
-/**
- * Extract recipes from an MCP tool response. Expects `res.content` as the
- * standard MCP content array; looks for a text chunk whose payload parses as
- * JSON and contains an array of `{ name, description?, body? }` items (or an
- * object with an `items`/`recipes` array).
- */
-export declare function parseRecipesFromToolResponse(res: unknown): RecipeItem[] | null;
-export declare class MultiMcpBridge {
-    private client;
-    private unsub;
-    /** server name -> url (for reverse lookup, since McpMultiClient keys by url) */
-    private nameToUrl;
-    /** server names currently connected */
-    private connected;
-    /** server names whose handshake is in-flight */
-    private connecting;
-    private options;
-    private started;
-    constructor(options: MultiMcpBridgeOptions);
-    start(): void;
-    stop(): void;
-    /** Ensure a server is in the store with enabled=true; reconcile picks it up. */
-    connect(name: string, url: string): Promise<void>;
-    /** Call a tool on a named server. */
-    callTool(serverName: string, toolName: string, args: unknown): Promise<McpToolResult>;
-    /** Direct access to the underlying multi-client (read-only usage preferred). */
-    get multiClient(): McpMultiClient;
-    /** True if a server with this name has completed its handshake. */
-    hasServer(serverName: string): boolean;
-    /** Snapshot of currently connected server names. */
-    connectedServers(): string[];
-    /**
-     * Wait until every enabled data server in the canvas is connected, or the
-     * timeout elapses. Resolves either way (no throw) — caller inspects
-     * `connectedServers()` to decide what's reachable.
-     */
-    waitForEnabledServers(timeoutMs?: number): Promise<void>;
-    private reconcile;
-    private handshake;
-    private disconnect;
-}
-/**
- * Install a singleton bridge on globalThis.__multiMcp. If a previous bridge
- * exists, it is stopped first (idempotent).
- */
-export declare function installMultiMcpBridge(options: MultiMcpBridgeOptions): MultiMcpBridge;
-export {};

package/src/multi-mcp-bridge.ts

@@ -1,311 +0,0 @@
-// ---------------------------------------------------------------------------
-// @webmcp-auto-ui/core — MultiMcpBridge
-// Observes a canvas store with a `dataServers` field and reconciles the real
-// MCP connection state with the user intent (`enabled`). Populates tools and
-// recipes metadata back into the store. Framework-agnostic.
-// ---------------------------------------------------------------------------
-
-import { McpMultiClient } from './multi-client.js';
-import type { McpTool, McpToolResult } from './types.js';
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-export interface MultiMcpBridgeOptions {
-  /** Accessor for the canvas store. Typically returns globalThis.__canvasVanilla. */
-  getCanvas: () => any;
-  /** Optional logger. */
-  log?: (msg: string, data?: any) => void;
-}
-
-interface DataServerLike {
-  name: string;
-  url: string;
-  enabled?: boolean;
-  connected?: boolean;
-}
-
-interface RecipeItem {
-  name: string;
-  description?: string;
-  body?: string;
-}
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-/**
- * Extract recipes from an MCP tool response. Expects `res.content` as the
- * standard MCP content array; looks for a text chunk whose payload parses as
- * JSON and contains an array of `{ name, description?, body? }` items (or an
- * object with an `items`/`recipes` array).
- */
-export function parseRecipesFromToolResponse(res: unknown): RecipeItem[] | null {
-  if (!res || typeof res !== 'object') return null;
-  const content = (res as any).content;
-  if (!Array.isArray(content)) return null;
-
-  for (const chunk of content) {
-    if (!chunk || typeof chunk !== 'object') continue;
-    if (chunk.type !== 'text' || typeof chunk.text !== 'string') continue;
-    const text: string = chunk.text;
-    let parsed: any;
-    try {
-      parsed = JSON.parse(text);
-    } catch {
-      continue;
-    }
-    const items = extractItems(parsed);
-    if (items) return items;
-  }
-  return null;
-}
-
-function extractItems(parsed: any): RecipeItem[] | null {
-  const candidate = Array.isArray(parsed)
-    ? parsed
-    : Array.isArray(parsed?.items)
-      ? parsed.items
-      : Array.isArray(parsed?.recipes)
-        ? parsed.recipes
-        : null;
-  if (!candidate) return null;
-  const out: RecipeItem[] = [];
-  for (const it of candidate) {
-    if (!it || typeof it !== 'object') continue;
-    const name = typeof it.name === 'string' ? it.name : typeof it.id === 'string' ? it.id : null;
-    if (!name) continue;
-    const entry: RecipeItem = { name };
-    if (typeof it.description === 'string') entry.description = it.description;
-    if (typeof it.body === 'string') entry.body = it.body;
-    out.push(entry);
-  }
-  return out.length > 0 ? out : null;
-}
-
-// ---------------------------------------------------------------------------
-// MultiMcpBridge
-// ---------------------------------------------------------------------------
-
-export class MultiMcpBridge {
-  private client: McpMultiClient;
-  private unsub: (() => void) | null = null;
-  /** server name -> url (for reverse lookup, since McpMultiClient keys by url) */
-  private nameToUrl = new Map<string, string>();
-  /** server names currently connected */
-  private connected = new Set<string>();
-  /** server names whose handshake is in-flight */
-  private connecting = new Set<string>();
-  private options: MultiMcpBridgeOptions;
-  private started = false;
-
-  constructor(options: MultiMcpBridgeOptions) {
-    this.options = options;
-    this.client = new McpMultiClient();
-  }
-
-  // -------------------------------------------------------------------------
-  // Lifecycle
-  // -------------------------------------------------------------------------
-
-  start(): void {
-    if (this.started) return;
-    const canvas = this.options.getCanvas();
-    if (canvas && typeof canvas.subscribe === 'function') {
-      this.started = true;
-      this.unsub = canvas.subscribe(() => {
-        void this.reconcile();
-      });
-      void this.reconcile();
-      return;
-    }
-    // Canvas not ready yet — retry shortly. Without this the bridge would
-    // stay dead forever because no subscription was ever established.
-    setTimeout(() => this.start(), 50);
-  }
-
-  stop(): void {
-    if (!this.started) return;
-    this.started = false;
-    if (this.unsub) {
-      try { this.unsub(); } catch { /* ignore */ }
-      this.unsub = null;
-    }
-    void this.client.disconnectAll().catch(() => { /* ignore */ });
-    this.connected.clear();
-    this.connecting.clear();
-    this.nameToUrl.clear();
-  }
-
-  // -------------------------------------------------------------------------
-  // Imperative helpers
-  // -------------------------------------------------------------------------
-
-  /** Ensure a server is in the store with enabled=true; reconcile picks it up. */
-  async connect(name: string, url: string): Promise<void> {
-    const canvas = this.options.getCanvas();
-    if (!canvas) return;
-    canvas.addDataServer?.({ name, url });
-    canvas.setDataServerEnabled?.(name, true);
-    await this.reconcile();
-  }
-
-  /** Call a tool on a named server. */
-  async callTool(serverName: string, toolName: string, args: unknown): Promise<McpToolResult> {
-    const url = this.nameToUrl.get(serverName);
-    if (!url) throw new Error(`MultiMcpBridge: server "${serverName}" is not connected`);
-    return this.client.callToolOn(url, toolName, (args ?? {}) as Record<string, unknown>);
-  }
-
-  /** Direct access to the underlying multi-client (read-only usage preferred). */
-  get multiClient(): McpMultiClient {
-    return this.client;
-  }
-
-  /** True if a server with this name has completed its handshake. */
-  hasServer(serverName: string): boolean {
-    return this.connected.has(serverName);
-  }
-
-  /** Snapshot of currently connected server names. */
-  connectedServers(): string[] {
-    return Array.from(this.connected);
-  }
-
-  /**
-   * Wait until every enabled data server in the canvas is connected, or the
-   * timeout elapses. Resolves either way (no throw) — caller inspects
-   * `connectedServers()` to decide what's reachable.
-   */
-  async waitForEnabledServers(timeoutMs = 5000): Promise<void> {
-    const canvas = this.options.getCanvas();
-    if (!canvas) return;
-    const deadline = Date.now() + Math.max(0, timeoutMs);
-    while (Date.now() < deadline) {
-      const enabled = (Array.isArray(canvas.dataServers) ? canvas.dataServers : [])
-        .filter((s: { enabled?: boolean }) => s?.enabled !== false)
-        .map((s: { name: string }) => s.name);
-      if (enabled.length === 0) return;
-      const allReady = enabled.every((n: string) => this.connected.has(n));
-      if (allReady) return;
-      await new Promise((r) => setTimeout(r, 100));
-    }
-  }
-
-  // -------------------------------------------------------------------------
-  // Reconciliation
-  // -------------------------------------------------------------------------
-
-  private async reconcile(): Promise<void> {
-    const canvas = this.options.getCanvas();
-    if (!canvas) return;
-    const servers = (canvas.dataServers ?? []) as DataServerLike[];
-    if (!Array.isArray(servers)) return;
-
-    const seenNames = new Set<string>();
-    for (const srv of servers) {
-      if (!srv || typeof srv.name !== 'string' || typeof srv.url !== 'string') continue;
-      // Empty URL means a legacy placeholder entry (see canvas.ensurePrimary).
-      // Handshaking with '' resolves `fetch('')` against the current page origin,
-      // producing a POST storm on the app root (405 loop).
-      if (srv.url === '') continue;
-      seenNames.add(srv.name);
-      const key = srv.name;
-      if (srv.enabled && !this.connected.has(key) && !this.connecting.has(key)) {
-        // Mark as connecting synchronously before the async handshake runs,
-        // so a concurrent reconcile() can't slip past the guard and spawn
-        // a second handshake for the same server.
-        this.connecting.add(key);
-        void this.handshake(srv);
-      } else if (!srv.enabled && this.connected.has(key)) {
-        void this.disconnect(srv);
-      }
-    }
-
-    // Disconnect servers that were removed from the store entirely
-    for (const name of Array.from(this.connected)) {
-      if (!seenNames.has(name)) {
-        void this.disconnect({ name, url: this.nameToUrl.get(name) ?? '' });
-      }
-    }
-  }
-
-  private async handshake(srv: DataServerLike): Promise<void> {
-    const canvas = this.options.getCanvas();
-    // connecting.add is performed by reconcile() synchronously; don't re-add here.
-    this.options.log?.(`[bridge] handshake start: ${srv.name}`, { url: srv.url });
-    try {
-      const { name: actualName, tools } = await this.client.addServer(srv.url);
-      // The MCP server may return a different name than the one stored in the
-      // canvas. Key the bridge by the canvas name so callers stay consistent.
-      this.nameToUrl.set(srv.name, srv.url);
-      this.connected.add(srv.name);
-
-      // Try to fetch recipes via tool `list_recipes` if exposed.
-      let recipes: RecipeItem[] = [];
-      const hasListRecipes = tools.some((t: McpTool) => t.name === 'list_recipes');
-      if (hasListRecipes) {
-        try {
-          const res = await this.client.callToolOn(srv.url, 'list_recipes', {});
-          recipes = parseRecipesFromToolResponse(res) ?? [];
-        } catch (err) {
-          this.options.log?.(`[bridge] list_recipes failed for ${srv.name}`, err);
-        }
-      }
-
-      canvas.setDataServerMeta?.(srv.name, {
-        connected: true,
-        tools,
-        recipes,
-        error: undefined,
-        serverName: actualName,
-      });
-      this.options.log?.(`[bridge] connected: ${srv.name}`, { tools: tools.length, recipes: recipes.length });
-    } catch (err: any) {
-      const message = err?.message ? String(err.message) : String(err);
-      canvas.setDataServerMeta?.(srv.name, {
-        connected: false,
-        tools: [],
-        recipes: [],
-        error: message,
-      });
-      this.options.log?.(`[bridge] handshake failed: ${srv.name}`, message);
-    } finally {
-      this.connecting.delete(srv.name);
-    }
-  }
-
-  private async disconnect(srv: { name: string; url: string }): Promise<void> {
-    const canvas = this.options.getCanvas();
-    const url = srv.url || this.nameToUrl.get(srv.name);
-    if (url) {
-      try { await this.client.removeServer(url); } catch { /* ignore */ }
-    }
-    this.connected.delete(srv.name);
-    this.nameToUrl.delete(srv.name);
-    canvas?.setDataServerMeta?.(srv.name, { connected: false });
-    this.options.log?.(`[bridge] disconnected: ${srv.name}`);
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Singleton installer
-// ---------------------------------------------------------------------------
-
-/**
- * Install a singleton bridge on globalThis.__multiMcp. If a previous bridge
- * exists, it is stopped first (idempotent).
- */
-export function installMultiMcpBridge(options: MultiMcpBridgeOptions): MultiMcpBridge {
-  const g = globalThis as any;
-  const existing = g.__multiMcp;
-  if (existing && typeof existing.stop === 'function') {
-    try { existing.stop(); } catch { /* ignore */ }
-  }
-  const bridge = new MultiMcpBridge(options);
-  g.__multiMcp = bridge;
-  bridge.start();
-  return bridge;
-}