@frontmcp/ui 0.5.0 → 0.6.0

package/src/bridge/core/bridge-factory.d.ts

@@ -1,198 +0,0 @@
-/**
- * FrontMcpBridge Factory
- *
- * Main entry point for the unified multi-platform adapter system.
- * Provides automatic platform detection and a consistent API across
- * OpenAI, Claude, ext-apps, Gemini, and custom adapters.
- *
- * @packageDocumentation
- */
-import type { PlatformAdapter, AdapterCapabilities, BridgeConfig, DisplayMode, HostContext, FrontMcpBridgeInterface } from '../types';
-import { AdapterRegistry } from './adapter-registry';
-/**
- * FrontMcpBridge - Unified multi-platform bridge for MCP tool widgets.
- *
- * @example Basic usage with auto-detection
- * ```typescript
- * const bridge = new FrontMcpBridge();
- * await bridge.initialize();
- *
- * const theme = bridge.getTheme();
- * const toolInput = bridge.getToolInput();
- * ```
- *
- * @example Force specific adapter
- * ```typescript
- * const bridge = new FrontMcpBridge({
- *   forceAdapter: 'openai',
- *   debug: true,
- * });
- * await bridge.initialize();
- * ```
- *
- * @example With custom registry
- * ```typescript
- * const registry = new AdapterRegistry();
- * registry.register('custom', createCustomAdapter);
- *
- * const bridge = new FrontMcpBridge({ forceAdapter: 'custom' }, registry);
- * await bridge.initialize();
- * ```
- */
-export declare class FrontMcpBridge implements FrontMcpBridgeInterface {
-    private _config;
-    private _registry;
-    private _adapter;
-    private _initialized;
-    private _initPromise;
-    /**
-     * Create a new FrontMcpBridge instance.
-     * @param config - Bridge configuration
-     * @param registry - Optional custom adapter registry (uses default if not provided)
-     */
-    constructor(config?: BridgeConfig, registry?: AdapterRegistry);
-    /**
-     * Whether the bridge has been initialized.
-     */
-    get initialized(): boolean;
-    /**
-     * Current adapter ID, or undefined if not initialized.
-     */
-    get adapterId(): string | undefined;
-    /**
-     * Current adapter capabilities, or undefined if not initialized.
-     */
-    get capabilities(): AdapterCapabilities | undefined;
-    /**
-     * Initialize the bridge.
-     * Auto-detects the best adapter for the current platform unless
-     * `forceAdapter` is specified in the config.
-     *
-     * @throws Error if no suitable adapter is found
-     */
-    initialize(): Promise<void>;
-    /**
-     * Internal initialization logic.
-     */
-    private _doInitialize;
-    /**
-     * Dispose the bridge and release resources.
-     */
-    dispose(): void;
-    /**
-     * Get the active adapter instance.
-     */
-    getAdapter(): PlatformAdapter | undefined;
-    /**
-     * Check if a specific capability is available.
-     * @param cap - Capability key to check
-     */
-    hasCapability(cap: keyof AdapterCapabilities): boolean;
-    /**
-     * Get current theme.
-     */
-    getTheme(): 'light' | 'dark';
-    /**
-     * Get current display mode.
-     */
-    getDisplayMode(): DisplayMode;
-    /**
-     * Get tool input arguments.
-     */
-    getToolInput(): Record<string, unknown>;
-    /**
-     * Get tool output/result.
-     */
-    getToolOutput(): unknown;
-    /**
-     * Get structured content (parsed output).
-     */
-    getStructuredContent(): unknown;
-    /**
-     * Get persisted widget state.
-     */
-    getWidgetState(): Record<string, unknown>;
-    /**
-     * Get full host context.
-     */
-    getHostContext(): HostContext;
-    /**
-     * Call a tool on the MCP server.
-     * @param name - Tool name
-     * @param args - Tool arguments
-     */
-    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Send a follow-up message to the conversation.
-     * @param content - Message content
-     */
-    sendMessage(content: string): Promise<void>;
-    /**
-     * Open an external link.
-     * @param url - URL to open
-     */
-    openLink(url: string): Promise<void>;
-    /**
-     * Request a display mode change.
-     * @param mode - Desired display mode
-     */
-    requestDisplayMode(mode: DisplayMode): Promise<void>;
-    /**
-     * Request widget close.
-     */
-    requestClose(): Promise<void>;
-    /**
-     * Set widget state (persisted across sessions).
-     * @param state - State object to persist
-     */
-    setWidgetState(state: Record<string, unknown>): void;
-    /**
-     * Subscribe to host context changes.
-     * @param callback - Called when context changes
-     * @returns Unsubscribe function
-     */
-    onContextChange(callback: (changes: Partial<HostContext>) => void): () => void;
-    /**
-     * Subscribe to tool result updates.
-     * @param callback - Called when tool result is received
-     * @returns Unsubscribe function
-     */
-    onToolResult(callback: (result: unknown) => void): () => void;
-    /**
-     * Ensure the bridge is initialized before operations.
-     */
-    private _ensureInitialized;
-    /**
-     * Wrap a promise with a timeout.
-     */
-    private _withTimeout;
-    /**
-     * Emit a bridge event via CustomEvent.
-     */
-    private _emitEvent;
-    /**
-     * Log debug message if debugging is enabled.
-     */
-    private _log;
-}
-/**
- * Create and initialize a bridge instance.
- * Convenience function for one-liner initialization.
- *
- * @example
- * ```typescript
- * const bridge = await createBridge({ debug: true });
- * const theme = bridge.getTheme();
- * ```
- */
-export declare function createBridge(config?: BridgeConfig, registry?: AdapterRegistry): Promise<FrontMcpBridge>;
-/**
- * Get or create the global bridge instance.
- * Initializes automatically on first call.
- */
-export declare function getGlobalBridge(config?: BridgeConfig): Promise<FrontMcpBridge>;
-/**
- * Reset the global bridge instance.
- * Useful for testing or when switching configurations.
- */
-export declare function resetGlobalBridge(): void;

package/src/bridge/core/bridge-factory.js

@@ -1,428 +0,0 @@
-"use strict";
-/**
- * FrontMcpBridge Factory
- *
- * Main entry point for the unified multi-platform adapter system.
- * Provides automatic platform detection and a consistent API across
- * OpenAI, Claude, ext-apps, Gemini, and custom adapters.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FrontMcpBridge = void 0;
-exports.createBridge = createBridge;
-exports.getGlobalBridge = getGlobalBridge;
-exports.resetGlobalBridge = resetGlobalBridge;
-const adapter_registry_1 = require("./adapter-registry");
-/**
- * Default bridge configuration.
- */
-const DEFAULT_CONFIG = {
-    debug: false,
-    initTimeout: 5000,
-};
-/**
- * Empty capabilities returned when no adapter is active.
- */
-const EMPTY_CAPABILITIES = {
-    canCallTools: false,
-    canSendMessages: false,
-    canOpenLinks: false,
-    canPersistState: false,
-    hasNetworkAccess: false,
-    supportsDisplayModes: false,
-    supportsTheme: false,
-};
-/**
- * FrontMcpBridge - Unified multi-platform bridge for MCP tool widgets.
- *
- * @example Basic usage with auto-detection
- * ```typescript
- * const bridge = new FrontMcpBridge();
- * await bridge.initialize();
- *
- * const theme = bridge.getTheme();
- * const toolInput = bridge.getToolInput();
- * ```
- *
- * @example Force specific adapter
- * ```typescript
- * const bridge = new FrontMcpBridge({
- *   forceAdapter: 'openai',
- *   debug: true,
- * });
- * await bridge.initialize();
- * ```
- *
- * @example With custom registry
- * ```typescript
- * const registry = new AdapterRegistry();
- * registry.register('custom', createCustomAdapter);
- *
- * const bridge = new FrontMcpBridge({ forceAdapter: 'custom' }, registry);
- * await bridge.initialize();
- * ```
- */
-class FrontMcpBridge {
-    _config;
-    _registry;
-    _adapter;
-    _initialized = false;
-    _initPromise;
-    /**
-     * Create a new FrontMcpBridge instance.
-     * @param config - Bridge configuration
-     * @param registry - Optional custom adapter registry (uses default if not provided)
-     */
-    constructor(config = {}, registry) {
-        this._config = { ...DEFAULT_CONFIG, ...config };
-        this._registry = registry || adapter_registry_1.defaultRegistry;
-        if (this._config.debug) {
-            this._registry.setDebug(true);
-        }
-        // Apply disabled adapters
-        if (this._config.disabledAdapters) {
-            this._registry.disable(...this._config.disabledAdapters);
-        }
-        // Apply adapter configs
-        if (this._config.adapterConfigs) {
-            for (const [id, adapterConfig] of Object.entries(this._config.adapterConfigs)) {
-                this._registry.configure(id, adapterConfig);
-            }
-        }
-    }
-    // ============================================
-    // Public Properties
-    // ============================================
-    /**
-     * Whether the bridge has been initialized.
-     */
-    get initialized() {
-        return this._initialized;
-    }
-    /**
-     * Current adapter ID, or undefined if not initialized.
-     */
-    get adapterId() {
-        return this._adapter?.id;
-    }
-    /**
-     * Current adapter capabilities, or undefined if not initialized.
-     */
-    get capabilities() {
-        return this._adapter?.capabilities;
-    }
-    // ============================================
-    // Lifecycle
-    // ============================================
-    /**
-     * Initialize the bridge.
-     * Auto-detects the best adapter for the current platform unless
-     * `forceAdapter` is specified in the config.
-     *
-     * @throws Error if no suitable adapter is found
-     */
-    async initialize() {
-        // Ensure only one initialization runs at a time
-        if (this._initPromise) {
-            return this._initPromise;
-        }
-        if (this._initialized) {
-            return;
-        }
-        this._initPromise = this._doInitialize();
-        try {
-            await this._initPromise;
-        }
-        finally {
-            this._initPromise = undefined;
-        }
-    }
-    /**
-     * Internal initialization logic.
-     */
-    async _doInitialize() {
-        this._log('Initializing FrontMcpBridge...');
-        // Select adapter
-        if (this._config.forceAdapter) {
-            this._adapter = this._registry.get(this._config.forceAdapter);
-            if (!this._adapter) {
-                throw new Error(`Forced adapter "${this._config.forceAdapter}" not found or disabled`);
-            }
-            this._log(`Using forced adapter: ${this._config.forceAdapter}`);
-        }
-        else {
-            this._adapter = this._registry.detect();
-            if (!this._adapter) {
-                throw new Error('No suitable adapter detected for current environment');
-            }
-            this._log(`Auto-detected adapter: ${this._adapter.id}`);
-        }
-        // Initialize adapter with timeout
-        try {
-            await this._withTimeout(this._adapter.initialize(), this._config.initTimeout || 5000);
-            this._initialized = true;
-            this._log(`Bridge initialized with adapter: ${this._adapter.id}`);
-            this._emitEvent('bridge:ready', { adapter: this._adapter.id });
-        }
-        catch (error) {
-            this._emitEvent('bridge:error', {
-                error: error instanceof Error ? error : new Error(String(error)),
-                adapter: this._adapter?.id,
-            });
-            throw error;
-        }
-    }
-    /**
-     * Dispose the bridge and release resources.
-     */
-    dispose() {
-        if (this._adapter) {
-            this._adapter.dispose();
-            this._log(`Disposed adapter: ${this._adapter.id}`);
-        }
-        this._adapter = undefined;
-        this._initialized = false;
-    }
-    // ============================================
-    // Adapter Access
-    // ============================================
-    /**
-     * Get the active adapter instance.
-     */
-    getAdapter() {
-        return this._adapter;
-    }
-    /**
-     * Check if a specific capability is available.
-     * @param cap - Capability key to check
-     */
-    hasCapability(cap) {
-        return this._adapter?.capabilities[cap] === true;
-    }
-    // ============================================
-    // Data Access (delegate to adapter)
-    // ============================================
-    /**
-     * Get current theme.
-     */
-    getTheme() {
-        this._ensureInitialized();
-        return this._adapter.getTheme();
-    }
-    /**
-     * Get current display mode.
-     */
-    getDisplayMode() {
-        this._ensureInitialized();
-        return this._adapter.getDisplayMode();
-    }
-    /**
-     * Get tool input arguments.
-     */
-    getToolInput() {
-        this._ensureInitialized();
-        return this._adapter.getToolInput();
-    }
-    /**
-     * Get tool output/result.
-     */
-    getToolOutput() {
-        this._ensureInitialized();
-        return this._adapter.getToolOutput();
-    }
-    /**
-     * Get structured content (parsed output).
-     */
-    getStructuredContent() {
-        this._ensureInitialized();
-        return this._adapter.getStructuredContent();
-    }
-    /**
-     * Get persisted widget state.
-     */
-    getWidgetState() {
-        this._ensureInitialized();
-        return this._adapter.getWidgetState();
-    }
-    /**
-     * Get full host context.
-     */
-    getHostContext() {
-        this._ensureInitialized();
-        return this._adapter.getHostContext();
-    }
-    // ============================================
-    // Actions (delegate to adapter)
-    // ============================================
-    /**
-     * Call a tool on the MCP server.
-     * @param name - Tool name
-     * @param args - Tool arguments
-     */
-    async callTool(name, args) {
-        this._ensureInitialized();
-        if (!this.hasCapability('canCallTools')) {
-            throw new Error('Tool calls are not supported by the current adapter');
-        }
-        return this._adapter.callTool(name, args);
-    }
-    /**
-     * Send a follow-up message to the conversation.
-     * @param content - Message content
-     */
-    async sendMessage(content) {
-        this._ensureInitialized();
-        if (!this.hasCapability('canSendMessages')) {
-            throw new Error('Sending messages is not supported by the current adapter');
-        }
-        return this._adapter.sendMessage(content);
-    }
-    /**
-     * Open an external link.
-     * @param url - URL to open
-     */
-    async openLink(url) {
-        this._ensureInitialized();
-        return this._adapter.openLink(url);
-    }
-    /**
-     * Request a display mode change.
-     * @param mode - Desired display mode
-     */
-    async requestDisplayMode(mode) {
-        this._ensureInitialized();
-        return this._adapter.requestDisplayMode(mode);
-    }
-    /**
-     * Request widget close.
-     */
-    async requestClose() {
-        this._ensureInitialized();
-        return this._adapter.requestClose();
-    }
-    /**
-     * Set widget state (persisted across sessions).
-     * @param state - State object to persist
-     */
-    setWidgetState(state) {
-        this._ensureInitialized();
-        this._adapter.setWidgetState(state);
-    }
-    // ============================================
-    // Events (delegate to adapter)
-    // ============================================
-    /**
-     * Subscribe to host context changes.
-     * @param callback - Called when context changes
-     * @returns Unsubscribe function
-     */
-    onContextChange(callback) {
-        this._ensureInitialized();
-        return this._adapter.onContextChange(callback);
-    }
-    /**
-     * Subscribe to tool result updates.
-     * @param callback - Called when tool result is received
-     * @returns Unsubscribe function
-     */
-    onToolResult(callback) {
-        this._ensureInitialized();
-        return this._adapter.onToolResult(callback);
-    }
-    // ============================================
-    // Private Helpers
-    // ============================================
-    /**
-     * Ensure the bridge is initialized before operations.
-     */
-    _ensureInitialized() {
-        if (!this._initialized || !this._adapter) {
-            throw new Error('FrontMcpBridge is not initialized. Call initialize() first.');
-        }
-    }
-    /**
-     * Wrap a promise with a timeout.
-     */
-    _withTimeout(promise, ms) {
-        return new Promise((resolve, reject) => {
-            const timer = setTimeout(() => {
-                reject(new Error(`Operation timed out after ${ms}ms`));
-            }, ms);
-            promise
-                .then((result) => {
-                clearTimeout(timer);
-                resolve(result);
-            })
-                .catch((error) => {
-                clearTimeout(timer);
-                reject(error);
-            });
-        });
-    }
-    /**
-     * Emit a bridge event via CustomEvent.
-     */
-    _emitEvent(type, payload) {
-        if (typeof window !== 'undefined' && typeof CustomEvent !== 'undefined') {
-            try {
-                const event = new CustomEvent(type, { detail: payload });
-                window.dispatchEvent(event);
-            }
-            catch {
-                // Ignore event dispatch errors
-            }
-        }
-    }
-    /**
-     * Log debug message if debugging is enabled.
-     */
-    _log(message) {
-        if (this._config.debug) {
-            console.log(`[FrontMcpBridge] ${message}`);
-        }
-    }
-}
-exports.FrontMcpBridge = FrontMcpBridge;
-/**
- * Create and initialize a bridge instance.
- * Convenience function for one-liner initialization.
- *
- * @example
- * ```typescript
- * const bridge = await createBridge({ debug: true });
- * const theme = bridge.getTheme();
- * ```
- */
-async function createBridge(config, registry) {
-    const bridge = new FrontMcpBridge(config, registry);
-    await bridge.initialize();
-    return bridge;
-}
-/**
- * Global bridge instance for singleton pattern.
- * Use with caution - prefer creating instances when possible.
- */
-let _globalBridge;
-/**
- * Get or create the global bridge instance.
- * Initializes automatically on first call.
- */
-async function getGlobalBridge(config) {
-    if (!_globalBridge) {
-        _globalBridge = new FrontMcpBridge(config);
-        await _globalBridge.initialize();
-    }
-    return _globalBridge;
-}
-/**
- * Reset the global bridge instance.
- * Useful for testing or when switching configurations.
- */
-function resetGlobalBridge() {
-    if (_globalBridge) {
-        _globalBridge.dispose();
-        _globalBridge = undefined;
-    }
-}
-//# sourceMappingURL=bridge-factory.js.map

package/src/bridge/core/bridge-factory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bridge-factory.js","sourceRoot":"","sources":["../../../../src/bridge/core/bridge-factory.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FrontMcpBridge Factory\n *\n * Main entry point for the unified multi-platform adapter system.\n * Provides automatic platform detection and a consistent API across\n * OpenAI, Claude, ext-apps, Gemini, and custom adapters.\n *\n * @packageDocumentation\n */\n\nimport type {\n  PlatformAdapter,\n  AdapterCapabilities,\n  BridgeConfig,\n  DisplayMode,\n  HostContext,\n  FrontMcpBridgeInterface,\n  BridgeEventType,\n  BridgeEventPayloads,\n} from '../types';\nimport { AdapterRegistry, defaultRegistry } from './adapter-registry';\n\n/**\n * Default bridge configuration.\n */\nconst DEFAULT_CONFIG: BridgeConfig = {\n  debug: false,\n  initTimeout: 5000,\n};\n\n/**\n * Empty capabilities returned when no adapter is active.\n */\nconst EMPTY_CAPABILITIES: AdapterCapabilities = {\n  canCallTools: false,\n  canSendMessages: false,\n  canOpenLinks: false,\n  canPersistState: false,\n  hasNetworkAccess: false,\n  supportsDisplayModes: false,\n  supportsTheme: false,\n};\n\n/**\n * FrontMcpBridge - Unified multi-platform bridge for MCP tool widgets.\n *\n * @example Basic usage with auto-detection\n * ```typescript\n * const bridge = new FrontMcpBridge();\n * await bridge.initialize();\n *\n * const theme = bridge.getTheme();\n * const toolInput = bridge.getToolInput();\n * ```\n *\n * @example Force specific adapter\n * ```typescript\n * const bridge = new FrontMcpBridge({\n *   forceAdapter: 'openai',\n *   debug: true,\n * });\n * await bridge.initialize();\n * ```\n *\n * @example With custom registry\n * ```typescript\n * const registry = new AdapterRegistry();\n * registry.register('custom', createCustomAdapter);\n *\n * const bridge = new FrontMcpBridge({ forceAdapter: 'custom' }, registry);\n * await bridge.initialize();\n * ```\n */\nexport class FrontMcpBridge implements FrontMcpBridgeInterface {\n  private _config: BridgeConfig;\n  private _registry: AdapterRegistry;\n  private _adapter: PlatformAdapter | undefined;\n  private _initialized = false;\n  private _initPromise: Promise<void> | undefined;\n\n  /**\n   * Create a new FrontMcpBridge instance.\n   * @param config - Bridge configuration\n   * @param registry - Optional custom adapter registry (uses default if not provided)\n   */\n  constructor(config: BridgeConfig = {}, registry?: AdapterRegistry) {\n    this._config = { ...DEFAULT_CONFIG, ...config };\n    this._registry = registry || defaultRegistry;\n\n    if (this._config.debug) {\n      this._registry.setDebug(true);\n    }\n\n    // Apply disabled adapters\n    if (this._config.disabledAdapters) {\n      this._registry.disable(...this._config.disabledAdapters);\n    }\n\n    // Apply adapter configs\n    if (this._config.adapterConfigs) {\n      for (const [id, adapterConfig] of Object.entries(this._config.adapterConfigs)) {\n        this._registry.configure(id, adapterConfig);\n      }\n    }\n  }\n\n  // ============================================\n  // Public Properties\n  // ============================================\n\n  /**\n   * Whether the bridge has been initialized.\n   */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /**\n   * Current adapter ID, or undefined if not initialized.\n   */\n  get adapterId(): string | undefined {\n    return this._adapter?.id;\n  }\n\n  /**\n   * Current adapter capabilities, or undefined if not initialized.\n   */\n  get capabilities(): AdapterCapabilities | undefined {\n    return this._adapter?.capabilities;\n  }\n\n  // ============================================\n  // Lifecycle\n  // ============================================\n\n  /**\n   * Initialize the bridge.\n   * Auto-detects the best adapter for the current platform unless\n   * `forceAdapter` is specified in the config.\n   *\n   * @throws Error if no suitable adapter is found\n   */\n  async initialize(): Promise<void> {\n    // Ensure only one initialization runs at a time\n    if (this._initPromise) {\n      return this._initPromise;\n    }\n\n    if (this._initialized) {\n      return;\n    }\n\n    this._initPromise = this._doInitialize();\n    try {\n      await this._initPromise;\n    } finally {\n      this._initPromise = undefined;\n    }\n  }\n\n  /**\n   * Internal initialization logic.\n   */\n  private async _doInitialize(): Promise<void> {\n    this._log('Initializing FrontMcpBridge...');\n\n    // Select adapter\n    if (this._config.forceAdapter) {\n      this._adapter = this._registry.get(this._config.forceAdapter);\n      if (!this._adapter) {\n        throw new Error(`Forced adapter \"${this._config.forceAdapter}\" not found or disabled`);\n      }\n      this._log(`Using forced adapter: ${this._config.forceAdapter}`);\n    } else {\n      this._adapter = this._registry.detect();\n      if (!this._adapter) {\n        throw new Error('No suitable adapter detected for current environment');\n      }\n      this._log(`Auto-detected adapter: ${this._adapter.id}`);\n    }\n\n    // Initialize adapter with timeout\n    try {\n      await this._withTimeout(this._adapter.initialize(), this._config.initTimeout || 5000);\n      this._initialized = true;\n      this._log(`Bridge initialized with adapter: ${this._adapter.id}`);\n      this._emitEvent('bridge:ready', { adapter: this._adapter.id });\n    } catch (error) {\n      this._emitEvent('bridge:error', {\n        error: error instanceof Error ? error : new Error(String(error)),\n        adapter: this._adapter?.id,\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Dispose the bridge and release resources.\n   */\n  dispose(): void {\n    if (this._adapter) {\n      this._adapter.dispose();\n      this._log(`Disposed adapter: ${this._adapter.id}`);\n    }\n    this._adapter = undefined;\n    this._initialized = false;\n  }\n\n  // ============================================\n  // Adapter Access\n  // ============================================\n\n  /**\n   * Get the active adapter instance.\n   */\n  getAdapter(): PlatformAdapter | undefined {\n    return this._adapter;\n  }\n\n  /**\n   * Check if a specific capability is available.\n   * @param cap - Capability key to check\n   */\n  hasCapability(cap: keyof AdapterCapabilities): boolean {\n    return this._adapter?.capabilities[cap] === true;\n  }\n\n  // ============================================\n  // Data Access (delegate to adapter)\n  // ============================================\n\n  /**\n   * Get current theme.\n   */\n  getTheme(): 'light' | 'dark' {\n    this._ensureInitialized();\n    return this._adapter!.getTheme();\n  }\n\n  /**\n   * Get current display mode.\n   */\n  getDisplayMode(): DisplayMode {\n    this._ensureInitialized();\n    return this._adapter!.getDisplayMode();\n  }\n\n  /**\n   * Get tool input arguments.\n   */\n  getToolInput(): Record<string, unknown> {\n    this._ensureInitialized();\n    return this._adapter!.getToolInput();\n  }\n\n  /**\n   * Get tool output/result.\n   */\n  getToolOutput(): unknown {\n    this._ensureInitialized();\n    return this._adapter!.getToolOutput();\n  }\n\n  /**\n   * Get structured content (parsed output).\n   */\n  getStructuredContent(): unknown {\n    this._ensureInitialized();\n    return this._adapter!.getStructuredContent();\n  }\n\n  /**\n   * Get persisted widget state.\n   */\n  getWidgetState(): Record<string, unknown> {\n    this._ensureInitialized();\n    return this._adapter!.getWidgetState();\n  }\n\n  /**\n   * Get full host context.\n   */\n  getHostContext(): HostContext {\n    this._ensureInitialized();\n    return this._adapter!.getHostContext();\n  }\n\n  // ============================================\n  // Actions (delegate to adapter)\n  // ============================================\n\n  /**\n   * Call a tool on the MCP server.\n   * @param name - Tool name\n   * @param args - Tool arguments\n   */\n  async callTool(name: string, args: Record<string, unknown>): Promise<unknown> {\n    this._ensureInitialized();\n    if (!this.hasCapability('canCallTools')) {\n      throw new Error('Tool calls are not supported by the current adapter');\n    }\n    return this._adapter!.callTool(name, args);\n  }\n\n  /**\n   * Send a follow-up message to the conversation.\n   * @param content - Message content\n   */\n  async sendMessage(content: string): Promise<void> {\n    this._ensureInitialized();\n    if (!this.hasCapability('canSendMessages')) {\n      throw new Error('Sending messages is not supported by the current adapter');\n    }\n    return this._adapter!.sendMessage(content);\n  }\n\n  /**\n   * Open an external link.\n   * @param url - URL to open\n   */\n  async openLink(url: string): Promise<void> {\n    this._ensureInitialized();\n    return this._adapter!.openLink(url);\n  }\n\n  /**\n   * Request a display mode change.\n   * @param mode - Desired display mode\n   */\n  async requestDisplayMode(mode: DisplayMode): Promise<void> {\n    this._ensureInitialized();\n    return this._adapter!.requestDisplayMode(mode);\n  }\n\n  /**\n   * Request widget close.\n   */\n  async requestClose(): Promise<void> {\n    this._ensureInitialized();\n    return this._adapter!.requestClose();\n  }\n\n  /**\n   * Set widget state (persisted across sessions).\n   * @param state - State object to persist\n   */\n  setWidgetState(state: Record<string, unknown>): void {\n    this._ensureInitialized();\n    this._adapter!.setWidgetState(state);\n  }\n\n  // ============================================\n  // Events (delegate to adapter)\n  // ============================================\n\n  /**\n   * Subscribe to host context changes.\n   * @param callback - Called when context changes\n   * @returns Unsubscribe function\n   */\n  onContextChange(callback: (changes: Partial<HostContext>) => void): () => void {\n    this._ensureInitialized();\n    return this._adapter!.onContextChange(callback);\n  }\n\n  /**\n   * Subscribe to tool result updates.\n   * @param callback - Called when tool result is received\n   * @returns Unsubscribe function\n   */\n  onToolResult(callback: (result: unknown) => void): () => void {\n    this._ensureInitialized();\n    return this._adapter!.onToolResult(callback);\n  }\n\n  // ============================================\n  // Private Helpers\n  // ============================================\n\n  /**\n   * Ensure the bridge is initialized before operations.\n   */\n  private _ensureInitialized(): void {\n    if (!this._initialized || !this._adapter) {\n      throw new Error('FrontMcpBridge is not initialized. Call initialize() first.');\n    }\n  }\n\n  /**\n   * Wrap a promise with a timeout.\n   */\n  private _withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {\n    return new Promise((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new Error(`Operation timed out after ${ms}ms`));\n      }, ms);\n\n      promise\n        .then((result) => {\n          clearTimeout(timer);\n          resolve(result);\n        })\n        .catch((error) => {\n          clearTimeout(timer);\n          reject(error);\n        });\n    });\n  }\n\n  /**\n   * Emit a bridge event via CustomEvent.\n   */\n  private _emitEvent<T extends BridgeEventType>(type: T, payload: BridgeEventPayloads[T]): void {\n    if (typeof window !== 'undefined' && typeof CustomEvent !== 'undefined') {\n      try {\n        const event = new CustomEvent(type, { detail: payload });\n        window.dispatchEvent(event);\n      } catch {\n        // Ignore event dispatch errors\n      }\n    }\n  }\n\n  /**\n   * Log debug message if debugging is enabled.\n   */\n  private _log(message: string): void {\n    if (this._config.debug) {\n      console.log(`[FrontMcpBridge] ${message}`);\n    }\n  }\n}\n\n/**\n * Create and initialize a bridge instance.\n * Convenience function for one-liner initialization.\n *\n * @example\n * ```typescript\n * const bridge = await createBridge({ debug: true });\n * const theme = bridge.getTheme();\n * ```\n */\nexport async function createBridge(config?: BridgeConfig, registry?: AdapterRegistry): Promise<FrontMcpBridge> {\n  const bridge = new FrontMcpBridge(config, registry);\n  await bridge.initialize();\n  return bridge;\n}\n\n/**\n * Global bridge instance for singleton pattern.\n * Use with caution - prefer creating instances when possible.\n */\nlet _globalBridge: FrontMcpBridge | undefined;\n\n/**\n * Get or create the global bridge instance.\n * Initializes automatically on first call.\n */\nexport async function getGlobalBridge(config?: BridgeConfig): Promise<FrontMcpBridge> {\n  if (!_globalBridge) {\n    _globalBridge = new FrontMcpBridge(config);\n    await _globalBridge.initialize();\n  }\n  return _globalBridge;\n}\n\n/**\n * Reset the global bridge instance.\n * Useful for testing or when switching configurations.\n */\nexport function resetGlobalBridge(): void {\n  if (_globalBridge) {\n    _globalBridge.dispose();\n    _globalBridge = undefined;\n  }\n}\n"]}

package/src/bridge/core/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * Bridge Core Module
- *
- * Core infrastructure for the FrontMcpBridge system.
- *
- * @packageDocumentation
- */
-export { AdapterRegistry, defaultRegistry, registerAdapter, getAdapter, detectAdapter } from './adapter-registry';
-export { FrontMcpBridge, createBridge, getGlobalBridge, resetGlobalBridge } from './bridge-factory';