@webmcp-auto-ui/core 2.5.36 → 2.5.38

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;
-}