@frontmcp/ui 0.5.0

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

@@ -0,0 +1,198 @@
+/**
+ * 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

@@ -0,0 +1,428 @@
+"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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,9 @@
+/**
+ * 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';