@frontmcp/ui 0.5.1 → 0.6.0

package/src/bridge/adapters/ext-apps.adapter.d.ts

@@ -1,142 +0,0 @@
-/**
- * ext-apps (SEP-1865) Platform Adapter
- *
- * Implements the MCP Apps Extension protocol (SEP-1865) for embedded
- * widget communication with AI hosts via JSON-RPC 2.0 over postMessage.
- *
- * @see https://github.com/modelcontextprotocol/ext-apps
- * @packageDocumentation
- */
-import type { DisplayMode, AdapterConfig } from '../types';
-import { BaseAdapter } from './base-adapter';
-/**
- * Configuration options for ext-apps adapter.
- */
-export interface ExtAppsAdapterConfig extends AdapterConfig {
-    options?: {
-        /** Trusted origins for postMessage security (trust-on-first-use if not specified) */
-        trustedOrigins?: string[];
-        /** Application name for handshake */
-        appName?: string;
-        /** Application version for handshake */
-        appVersion?: string;
-        /** Protocol version (defaults to '2024-11-05') */
-        protocolVersion?: string;
-        /** Timeout for initialization handshake (ms) */
-        initTimeout?: number;
-    };
-}
-/**
- * ext-apps (SEP-1865) adapter.
- *
- * Provides communication between embedded widgets and AI hosts using
- * the standardized JSON-RPC 2.0 over postMessage protocol.
- *
- * @example
- * ```typescript
- * import { ExtAppsAdapter } from '@frontmcp/ui/bridge';
- *
- * const adapter = new ExtAppsAdapter({
- *   options: {
- *     trustedOrigins: ['https://claude.ai'],
- *   }
- * });
- * if (adapter.canHandle()) {
- *   await adapter.initialize();
- * }
- * ```
- */
-export declare class ExtAppsAdapter extends BaseAdapter {
-    readonly id = "ext-apps";
-    readonly name = "ext-apps (SEP-1865)";
-    readonly priority = 80;
-    private _config;
-    private _messageListener;
-    private _pendingRequests;
-    private _requestId;
-    private _trustedOrigin;
-    private _hostCapabilities;
-    constructor(config?: ExtAppsAdapterConfig);
-    /**
-     * Check if we're in an iframe (potential ext-apps context).
-     */
-    canHandle(): boolean;
-    /**
-     * Initialize the ext-apps adapter with protocol handshake.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Dispose adapter resources.
-     */
-    dispose(): void;
-    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
-    sendMessage(content: string): Promise<void>;
-    openLink(url: string): Promise<void>;
-    requestDisplayMode(mode: DisplayMode): Promise<void>;
-    requestClose(): Promise<void>;
-    /**
-     * Setup postMessage listener for incoming messages.
-     */
-    private _setupMessageListener;
-    /**
-     * Handle incoming postMessage events.
-     */
-    private _handleMessage;
-    /**
-     * Handle JSON-RPC response.
-     */
-    private _handleResponse;
-    /**
-     * Handle JSON-RPC notification from host.
-     */
-    private _handleNotification;
-    /**
-     * Handle tool input notification.
-     */
-    private _handleToolInput;
-    /**
-     * Handle partial tool input (streaming).
-     */
-    private _handleToolInputPartial;
-    /**
-     * Handle tool result notification.
-     */
-    private _handleToolResult;
-    /**
-     * Handle host context change notification.
-     */
-    private _handleHostContextChange;
-    /**
-     * Handle cancellation notification.
-     */
-    private _handleCancelled;
-    /**
-     * Send a JSON-RPC request to the host.
-     */
-    private _sendRequest;
-    /**
-     * Send a JSON-RPC notification (no response expected).
-     */
-    private _sendNotification;
-    /**
-     * Post a message to the parent window.
-     */
-    private _postMessage;
-    /**
-     * Perform the ui/initialize handshake with the host.
-     */
-    private _performHandshake;
-    /**
-     * Check if an origin is trusted.
-     * Uses trust-on-first-use if no explicit origins configured.
-     */
-    private _isOriginTrusted;
-    /**
-     * Emit a bridge event via CustomEvent.
-     */
-    private _emitBridgeEvent;
-}
-/**
- * Factory function for creating ext-apps adapter instances.
- */
-export declare function createExtAppsAdapter(config?: ExtAppsAdapterConfig): ExtAppsAdapter;

package/src/bridge/adapters/ext-apps.adapter.js

@@ -1,416 +0,0 @@
-"use strict";
-/**
- * ext-apps (SEP-1865) Platform Adapter
- *
- * Implements the MCP Apps Extension protocol (SEP-1865) for embedded
- * widget communication with AI hosts via JSON-RPC 2.0 over postMessage.
- *
- * @see https://github.com/modelcontextprotocol/ext-apps
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExtAppsAdapter = void 0;
-exports.createExtAppsAdapter = createExtAppsAdapter;
-const base_adapter_1 = require("./base-adapter");
-/**
- * ext-apps (SEP-1865) adapter.
- *
- * Provides communication between embedded widgets and AI hosts using
- * the standardized JSON-RPC 2.0 over postMessage protocol.
- *
- * @example
- * ```typescript
- * import { ExtAppsAdapter } from '@frontmcp/ui/bridge';
- *
- * const adapter = new ExtAppsAdapter({
- *   options: {
- *     trustedOrigins: ['https://claude.ai'],
- *   }
- * });
- * if (adapter.canHandle()) {
- *   await adapter.initialize();
- * }
- * ```
- */
-class ExtAppsAdapter extends base_adapter_1.BaseAdapter {
-    id = 'ext-apps';
-    name = 'ext-apps (SEP-1865)';
-    priority = 80; // High priority, but below OpenAI native
-    _config;
-    _messageListener;
-    _pendingRequests = new Map();
-    _requestId = 0;
-    _trustedOrigin;
-    _hostCapabilities = {};
-    constructor(config) {
-        super();
-        this._config = config || {};
-        // Start with minimal capabilities, updated after handshake
-        this._capabilities = {
-            ...base_adapter_1.DEFAULT_CAPABILITIES,
-            canPersistState: true,
-            hasNetworkAccess: true, // ext-apps usually allows network
-            supportsTheme: true,
-        };
-    }
-    /**
-     * Check if we're in an iframe (potential ext-apps context).
-     */
-    canHandle() {
-        if (typeof window === 'undefined')
-            return false;
-        // Check if we're in an iframe
-        const inIframe = window.parent !== window;
-        if (!inIframe)
-            return false;
-        // Check we're not already detected as OpenAI
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const win = window;
-        if (win.openai?.canvas)
-            return false;
-        // Check for explicit ext-apps marker
-        if (win.__mcpPlatform === 'ext-apps')
-            return true;
-        // In an iframe without OpenAI SDK = likely ext-apps context
-        return true;
-    }
-    /**
-     * Initialize the ext-apps adapter with protocol handshake.
-     */
-    async initialize() {
-        if (this._initialized)
-            return;
-        // Setup message listener
-        this._setupMessageListener();
-        // Call base initialization
-        await super.initialize();
-        // Perform ui/initialize handshake
-        await this._performHandshake();
-        this._initialized = true;
-    }
-    /**
-     * Dispose adapter resources.
-     */
-    dispose() {
-        // Remove message listener
-        if (this._messageListener && typeof window !== 'undefined') {
-            window.removeEventListener('message', this._messageListener);
-            this._messageListener = undefined;
-        }
-        // Reject all pending requests
-        for (const [id, pending] of this._pendingRequests) {
-            clearTimeout(pending.timeout);
-            pending.reject(new Error('Adapter disposed'));
-        }
-        this._pendingRequests.clear();
-        super.dispose();
-    }
-    // ============================================
-    // Actions (via JSON-RPC)
-    // ============================================
-    async callTool(name, args) {
-        if (!this._hostCapabilities.serverToolProxy) {
-            throw new Error('Server tool proxy not supported by host');
-        }
-        return this._sendRequest('ui/callServerTool', {
-            name,
-            arguments: args,
-        });
-    }
-    async sendMessage(content) {
-        await this._sendRequest('ui/message', { content });
-    }
-    async openLink(url) {
-        if (!this._hostCapabilities.openLink) {
-            // Fallback to window.open
-            return super.openLink(url);
-        }
-        await this._sendRequest('ui/openLink', { url });
-    }
-    async requestDisplayMode(mode) {
-        await this._sendRequest('ui/setDisplayMode', { mode });
-        this._hostContext = { ...this._hostContext, displayMode: mode };
-    }
-    async requestClose() {
-        await this._sendRequest('ui/close', {});
-    }
-    // ============================================
-    // Private: Message Handling
-    // ============================================
-    /**
-     * Setup postMessage listener for incoming messages.
-     */
-    _setupMessageListener() {
-        if (typeof window === 'undefined')
-            return;
-        this._messageListener = (event) => {
-            this._handleMessage(event);
-        };
-        window.addEventListener('message', this._messageListener);
-    }
-    /**
-     * Handle incoming postMessage events.
-     */
-    _handleMessage(event) {
-        // Validate origin
-        if (!this._isOriginTrusted(event.origin)) {
-            return;
-        }
-        const data = event.data;
-        if (!data || typeof data !== 'object')
-            return;
-        if (data.jsonrpc !== '2.0')
-            return;
-        // Handle response to our request
-        if ('id' in data && (data.result !== undefined || data.error !== undefined)) {
-            this._handleResponse(data);
-            return;
-        }
-        // Handle notification from host
-        if ('method' in data && !('id' in data)) {
-            this._handleNotification(data);
-            return;
-        }
-    }
-    /**
-     * Handle JSON-RPC response.
-     */
-    _handleResponse(response) {
-        const pending = this._pendingRequests.get(response.id);
-        if (!pending)
-            return;
-        clearTimeout(pending.timeout);
-        this._pendingRequests.delete(response.id);
-        if (response.error) {
-            pending.reject(new Error(`${response.error.message} (code: ${response.error.code})`));
-        }
-        else {
-            pending.resolve(response.result);
-        }
-    }
-    /**
-     * Handle JSON-RPC notification from host.
-     */
-    _handleNotification(notification) {
-        switch (notification.method) {
-            case 'ui/notifications/tool-input':
-                this._handleToolInput(notification.params);
-                break;
-            case 'ui/notifications/tool-input-partial':
-                this._handleToolInputPartial(notification.params);
-                break;
-            case 'ui/notifications/tool-result':
-                this._handleToolResult(notification.params);
-                break;
-            case 'ui/notifications/host-context-changed':
-                this._handleHostContextChange(notification.params);
-                break;
-            case 'ui/notifications/initialized':
-                // Host confirms initialization complete
-                break;
-            case 'ui/notifications/cancelled':
-                this._handleCancelled(notification.params);
-                break;
-        }
-    }
-    /**
-     * Handle tool input notification.
-     */
-    _handleToolInput(params) {
-        this._toolInput = params.arguments || {};
-        // Emit tool:input event
-        this._emitBridgeEvent('tool:input', { arguments: this._toolInput });
-    }
-    /**
-     * Handle partial tool input (streaming).
-     */
-    _handleToolInputPartial(params) {
-        this._toolInput = { ...this._toolInput, ...params.arguments };
-        // Emit tool:input-partial event
-        this._emitBridgeEvent('tool:input-partial', { arguments: this._toolInput });
-    }
-    /**
-     * Handle tool result notification.
-     */
-    _handleToolResult(params) {
-        this._toolOutput = params.content;
-        this._structuredContent = params.structuredContent;
-        // Notify listeners
-        this._notifyToolResult(params.content);
-        // Emit tool:result event
-        this._emitBridgeEvent('tool:result', {
-            content: params.content,
-            structuredContent: params.structuredContent,
-        });
-    }
-    /**
-     * Handle host context change notification.
-     */
-    _handleHostContextChange(params) {
-        const changes = {};
-        if (params.theme !== undefined) {
-            changes.theme = params.theme;
-        }
-        if (params.displayMode !== undefined) {
-            changes.displayMode = params.displayMode;
-        }
-        if (params.viewport !== undefined) {
-            changes.viewport = params.viewport;
-        }
-        if (params.locale !== undefined) {
-            changes.locale = params.locale;
-        }
-        if (params.timezone !== undefined) {
-            changes.timezone = params.timezone;
-        }
-        this._notifyContextChange(changes);
-    }
-    /**
-     * Handle cancellation notification.
-     */
-    _handleCancelled(params) {
-        const reason = params?.reason;
-        this._emitBridgeEvent('tool:cancelled', { reason });
-    }
-    // ============================================
-    // Private: JSON-RPC Transport
-    // ============================================
-    /**
-     * Send a JSON-RPC request to the host.
-     */
-    _sendRequest(method, params) {
-        return new Promise((resolve, reject) => {
-            const id = ++this._requestId;
-            const timeout = this._config.options?.initTimeout || 10000;
-            const request = {
-                jsonrpc: '2.0',
-                id,
-                method,
-                params,
-            };
-            const timeoutHandle = setTimeout(() => {
-                this._pendingRequests.delete(id);
-                reject(new Error(`Request ${method} timed out after ${timeout}ms`));
-            }, timeout);
-            this._pendingRequests.set(id, {
-                resolve,
-                reject,
-                timeout: timeoutHandle,
-            });
-            this._postMessage(request);
-        });
-    }
-    /**
-     * Send a JSON-RPC notification (no response expected).
-     */
-    _sendNotification(method, params) {
-        const notification = {
-            jsonrpc: '2.0',
-            method,
-            params,
-        };
-        this._postMessage(notification);
-    }
-    /**
-     * Post a message to the parent window.
-     */
-    _postMessage(message) {
-        if (typeof window === 'undefined')
-            return;
-        const targetOrigin = this._trustedOrigin || '*';
-        window.parent.postMessage(message, targetOrigin);
-    }
-    // ============================================
-    // Private: Handshake
-    // ============================================
-    /**
-     * Perform the ui/initialize handshake with the host.
-     */
-    async _performHandshake() {
-        const params = {
-            appInfo: {
-                name: this._config.options?.appName || 'FrontMCP Widget',
-                version: this._config.options?.appVersion || '1.0.0',
-            },
-            appCapabilities: {
-                tools: {
-                    listChanged: false,
-                },
-            },
-            protocolVersion: this._config.options?.protocolVersion || '2024-11-05',
-        };
-        try {
-            const result = (await this._sendRequest('ui/initialize', params));
-            // Store host capabilities
-            this._hostCapabilities = result.hostCapabilities || {};
-            // Update adapter capabilities based on host
-            this._capabilities = {
-                ...this._capabilities,
-                canCallTools: Boolean(this._hostCapabilities.serverToolProxy),
-                canSendMessages: true,
-                canOpenLinks: Boolean(this._hostCapabilities.openLink),
-                supportsDisplayModes: true,
-            };
-            // Update host context
-            if (result.hostContext) {
-                this._hostContext = {
-                    ...this._hostContext,
-                    ...result.hostContext,
-                };
-            }
-            // Trust the origin that successfully completed handshake
-            // (trust-on-first-use if no explicit trusted origins)
-            if (!this._config.options?.trustedOrigins?.length) {
-                // Origin is already set from first successful message
-            }
-        }
-        catch (error) {
-            throw new Error(`ext-apps handshake failed: ${error}`);
-        }
-    }
-    // ============================================
-    // Private: Origin Security
-    // ============================================
-    /**
-     * Check if an origin is trusted.
-     * Uses trust-on-first-use if no explicit origins configured.
-     */
-    _isOriginTrusted(origin) {
-        // Explicit trusted origins from config
-        const trustedOrigins = this._config.options?.trustedOrigins;
-        if (trustedOrigins && trustedOrigins.length > 0) {
-            return trustedOrigins.includes(origin);
-        }
-        // Trust-on-first-use: trust the first origin we receive from
-        if (!this._trustedOrigin) {
-            this._trustedOrigin = origin;
-            return true;
-        }
-        return this._trustedOrigin === origin;
-    }
-    // ============================================
-    // Private: Events
-    // ============================================
-    /**
-     * Emit a bridge event via CustomEvent.
-     */
-    _emitBridgeEvent(type, detail) {
-        if (typeof window !== 'undefined' && typeof CustomEvent !== 'undefined') {
-            try {
-                const event = new CustomEvent(type, { detail });
-                window.dispatchEvent(event);
-            }
-            catch {
-                // Ignore event dispatch errors
-            }
-        }
-    }
-}
-exports.ExtAppsAdapter = ExtAppsAdapter;
-/**
- * Factory function for creating ext-apps adapter instances.
- */
-function createExtAppsAdapter(config) {
-    return new ExtAppsAdapter(config);
-}
-//# sourceMappingURL=ext-apps.adapter.js.map

package/src/bridge/adapters/ext-apps.adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ext-apps.adapter.js","sourceRoot":"","sources":["../../../../src/bridge/adapters/ext-apps.adapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ext-apps (SEP-1865) Platform Adapter\n *\n * Implements the MCP Apps Extension protocol (SEP-1865) for embedded\n * widget communication with AI hosts via JSON-RPC 2.0 over postMessage.\n *\n * @see https://github.com/modelcontextprotocol/ext-apps\n * @packageDocumentation\n */\n\nimport type {\n  DisplayMode,\n  HostContext,\n  JsonRpcRequest,\n  JsonRpcResponse,\n  JsonRpcNotification,\n  ExtAppsInitializeParams,\n  ExtAppsInitializeResult,\n  ExtAppsToolInputParams,\n  ExtAppsToolResultParams,\n  ExtAppsHostContextChangeParams,\n  AdapterConfig,\n} from '../types';\nimport { BaseAdapter, DEFAULT_CAPABILITIES } from './base-adapter';\n\n/**\n * Configuration options for ext-apps adapter.\n */\nexport interface ExtAppsAdapterConfig extends AdapterConfig {\n  options?: {\n    /** Trusted origins for postMessage security (trust-on-first-use if not specified) */\n    trustedOrigins?: string[];\n    /** Application name for handshake */\n    appName?: string;\n    /** Application version for handshake */\n    appVersion?: string;\n    /** Protocol version (defaults to '2024-11-05') */\n    protocolVersion?: string;\n    /** Timeout for initialization handshake (ms) */\n    initTimeout?: number;\n  };\n}\n\n/**\n * ext-apps (SEP-1865) adapter.\n *\n * Provides communication between embedded widgets and AI hosts using\n * the standardized JSON-RPC 2.0 over postMessage protocol.\n *\n * @example\n * ```typescript\n * import { ExtAppsAdapter } from '@frontmcp/ui/bridge';\n *\n * const adapter = new ExtAppsAdapter({\n *   options: {\n *     trustedOrigins: ['https://claude.ai'],\n *   }\n * });\n * if (adapter.canHandle()) {\n *   await adapter.initialize();\n * }\n * ```\n */\nexport class ExtAppsAdapter extends BaseAdapter {\n  readonly id = 'ext-apps';\n  readonly name = 'ext-apps (SEP-1865)';\n  readonly priority = 80; // High priority, but below OpenAI native\n\n  private _config: ExtAppsAdapterConfig;\n  private _messageListener: ((event: MessageEvent) => void) | undefined;\n  private _pendingRequests: Map<\n    string | number,\n    {\n      resolve: (value: unknown) => void;\n      reject: (error: Error) => void;\n      timeout: ReturnType<typeof setTimeout>;\n    }\n  > = new Map();\n  private _requestId = 0;\n  private _trustedOrigin: string | undefined;\n  private _hostCapabilities: ExtAppsInitializeResult['hostCapabilities'] = {};\n\n  constructor(config?: ExtAppsAdapterConfig) {\n    super();\n    this._config = config || {};\n\n    // Start with minimal capabilities, updated after handshake\n    this._capabilities = {\n      ...DEFAULT_CAPABILITIES,\n      canPersistState: true,\n      hasNetworkAccess: true, // ext-apps usually allows network\n      supportsTheme: true,\n    };\n  }\n\n  /**\n   * Check if we're in an iframe (potential ext-apps context).\n   */\n  canHandle(): boolean {\n    if (typeof window === 'undefined') return false;\n\n    // Check if we're in an iframe\n    const inIframe = window.parent !== window;\n    if (!inIframe) return false;\n\n    // Check we're not already detected as OpenAI\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const win = window as any;\n    if (win.openai?.canvas) return false;\n\n    // Check for explicit ext-apps marker\n    if (win.__mcpPlatform === 'ext-apps') return true;\n\n    // In an iframe without OpenAI SDK = likely ext-apps context\n    return true;\n  }\n\n  /**\n   * Initialize the ext-apps adapter with protocol handshake.\n   */\n  override async initialize(): Promise<void> {\n    if (this._initialized) return;\n\n    // Setup message listener\n    this._setupMessageListener();\n\n    // Call base initialization\n    await super.initialize();\n\n    // Perform ui/initialize handshake\n    await this._performHandshake();\n\n    this._initialized = true;\n  }\n\n  /**\n   * Dispose adapter resources.\n   */\n  override dispose(): void {\n    // Remove message listener\n    if (this._messageListener && typeof window !== 'undefined') {\n      window.removeEventListener('message', this._messageListener);\n      this._messageListener = undefined;\n    }\n\n    // Reject all pending requests\n    for (const [id, pending] of this._pendingRequests) {\n      clearTimeout(pending.timeout);\n      pending.reject(new Error('Adapter disposed'));\n    }\n    this._pendingRequests.clear();\n\n    super.dispose();\n  }\n\n  // ============================================\n  // Actions (via JSON-RPC)\n  // ============================================\n\n  override async callTool(name: string, args: Record<string, unknown>): Promise<unknown> {\n    if (!this._hostCapabilities.serverToolProxy) {\n      throw new Error('Server tool proxy not supported by host');\n    }\n\n    return this._sendRequest('ui/callServerTool', {\n      name,\n      arguments: args,\n    });\n  }\n\n  override async sendMessage(content: string): Promise<void> {\n    await this._sendRequest('ui/message', { content });\n  }\n\n  override async openLink(url: string): Promise<void> {\n    if (!this._hostCapabilities.openLink) {\n      // Fallback to window.open\n      return super.openLink(url);\n    }\n\n    await this._sendRequest('ui/openLink', { url });\n  }\n\n  override async requestDisplayMode(mode: DisplayMode): Promise<void> {\n    await this._sendRequest('ui/setDisplayMode', { mode });\n    this._hostContext = { ...this._hostContext, displayMode: mode };\n  }\n\n  override async requestClose(): Promise<void> {\n    await this._sendRequest('ui/close', {});\n  }\n\n  // ============================================\n  // Private: Message Handling\n  // ============================================\n\n  /**\n   * Setup postMessage listener for incoming messages.\n   */\n  private _setupMessageListener(): void {\n    if (typeof window === 'undefined') return;\n\n    this._messageListener = (event: MessageEvent) => {\n      this._handleMessage(event);\n    };\n\n    window.addEventListener('message', this._messageListener);\n  }\n\n  /**\n   * Handle incoming postMessage events.\n   */\n  private _handleMessage(event: MessageEvent): void {\n    // Validate origin\n    if (!this._isOriginTrusted(event.origin)) {\n      return;\n    }\n\n    const data = event.data;\n    if (!data || typeof data !== 'object') return;\n    if (data.jsonrpc !== '2.0') return;\n\n    // Handle response to our request\n    if ('id' in data && (data.result !== undefined || data.error !== undefined)) {\n      this._handleResponse(data as JsonRpcResponse);\n      return;\n    }\n\n    // Handle notification from host\n    if ('method' in data && !('id' in data)) {\n      this._handleNotification(data as JsonRpcNotification);\n      return;\n    }\n  }\n\n  /**\n   * Handle JSON-RPC response.\n   */\n  private _handleResponse(response: JsonRpcResponse): void {\n    const pending = this._pendingRequests.get(response.id);\n    if (!pending) return;\n\n    clearTimeout(pending.timeout);\n    this._pendingRequests.delete(response.id);\n\n    if (response.error) {\n      pending.reject(new Error(`${response.error.message} (code: ${response.error.code})`));\n    } else {\n      pending.resolve(response.result);\n    }\n  }\n\n  /**\n   * Handle JSON-RPC notification from host.\n   */\n  private _handleNotification(notification: JsonRpcNotification): void {\n    switch (notification.method) {\n      case 'ui/notifications/tool-input':\n        this._handleToolInput(notification.params as ExtAppsToolInputParams);\n        break;\n\n      case 'ui/notifications/tool-input-partial':\n        this._handleToolInputPartial(notification.params as ExtAppsToolInputParams);\n        break;\n\n      case 'ui/notifications/tool-result':\n        this._handleToolResult(notification.params as ExtAppsToolResultParams);\n        break;\n\n      case 'ui/notifications/host-context-changed':\n        this._handleHostContextChange(notification.params as ExtAppsHostContextChangeParams);\n        break;\n\n      case 'ui/notifications/initialized':\n        // Host confirms initialization complete\n        break;\n\n      case 'ui/notifications/cancelled':\n        this._handleCancelled(notification.params);\n        break;\n    }\n  }\n\n  /**\n   * Handle tool input notification.\n   */\n  private _handleToolInput(params: ExtAppsToolInputParams): void {\n    this._toolInput = params.arguments || {};\n\n    // Emit tool:input event\n    this._emitBridgeEvent('tool:input', { arguments: this._toolInput });\n  }\n\n  /**\n   * Handle partial tool input (streaming).\n   */\n  private _handleToolInputPartial(params: ExtAppsToolInputParams): void {\n    this._toolInput = { ...this._toolInput, ...params.arguments };\n\n    // Emit tool:input-partial event\n    this._emitBridgeEvent('tool:input-partial', { arguments: this._toolInput });\n  }\n\n  /**\n   * Handle tool result notification.\n   */\n  private _handleToolResult(params: ExtAppsToolResultParams): void {\n    this._toolOutput = params.content;\n    this._structuredContent = params.structuredContent;\n\n    // Notify listeners\n    this._notifyToolResult(params.content);\n\n    // Emit tool:result event\n    this._emitBridgeEvent('tool:result', {\n      content: params.content,\n      structuredContent: params.structuredContent,\n    });\n  }\n\n  /**\n   * Handle host context change notification.\n   */\n  private _handleHostContextChange(params: ExtAppsHostContextChangeParams): void {\n    const changes: Partial<HostContext> = {};\n\n    if (params.theme !== undefined) {\n      changes.theme = params.theme;\n    }\n    if (params.displayMode !== undefined) {\n      changes.displayMode = params.displayMode;\n    }\n    if (params.viewport !== undefined) {\n      changes.viewport = params.viewport;\n    }\n    if (params.locale !== undefined) {\n      changes.locale = params.locale;\n    }\n    if (params.timezone !== undefined) {\n      changes.timezone = params.timezone;\n    }\n\n    this._notifyContextChange(changes);\n  }\n\n  /**\n   * Handle cancellation notification.\n   */\n  private _handleCancelled(params: unknown): void {\n    const reason = (params as { reason?: string })?.reason;\n    this._emitBridgeEvent('tool:cancelled', { reason });\n  }\n\n  // ============================================\n  // Private: JSON-RPC Transport\n  // ============================================\n\n  /**\n   * Send a JSON-RPC request to the host.\n   */\n  private _sendRequest(method: string, params?: unknown): Promise<unknown> {\n    return new Promise((resolve, reject) => {\n      const id = ++this._requestId;\n      const timeout = this._config.options?.initTimeout || 10000;\n\n      const request: JsonRpcRequest = {\n        jsonrpc: '2.0',\n        id,\n        method,\n        params,\n      };\n\n      const timeoutHandle = setTimeout(() => {\n        this._pendingRequests.delete(id);\n        reject(new Error(`Request ${method} timed out after ${timeout}ms`));\n      }, timeout);\n\n      this._pendingRequests.set(id, {\n        resolve,\n        reject,\n        timeout: timeoutHandle,\n      });\n\n      this._postMessage(request);\n    });\n  }\n\n  /**\n   * Send a JSON-RPC notification (no response expected).\n   */\n  private _sendNotification(method: string, params?: unknown): void {\n    const notification: JsonRpcNotification = {\n      jsonrpc: '2.0',\n      method,\n      params,\n    };\n    this._postMessage(notification);\n  }\n\n  /**\n   * Post a message to the parent window.\n   */\n  private _postMessage(message: JsonRpcRequest | JsonRpcResponse | JsonRpcNotification): void {\n    if (typeof window === 'undefined') return;\n\n    const targetOrigin = this._trustedOrigin || '*';\n    window.parent.postMessage(message, targetOrigin);\n  }\n\n  // ============================================\n  // Private: Handshake\n  // ============================================\n\n  /**\n   * Perform the ui/initialize handshake with the host.\n   */\n  private async _performHandshake(): Promise<void> {\n    const params: ExtAppsInitializeParams = {\n      appInfo: {\n        name: this._config.options?.appName || 'FrontMCP Widget',\n        version: this._config.options?.appVersion || '1.0.0',\n      },\n      appCapabilities: {\n        tools: {\n          listChanged: false,\n        },\n      },\n      protocolVersion: this._config.options?.protocolVersion || '2024-11-05',\n    };\n\n    try {\n      const result = (await this._sendRequest('ui/initialize', params)) as ExtAppsInitializeResult;\n\n      // Store host capabilities\n      this._hostCapabilities = result.hostCapabilities || {};\n\n      // Update adapter capabilities based on host\n      this._capabilities = {\n        ...this._capabilities,\n        canCallTools: Boolean(this._hostCapabilities.serverToolProxy),\n        canSendMessages: true,\n        canOpenLinks: Boolean(this._hostCapabilities.openLink),\n        supportsDisplayModes: true,\n      };\n\n      // Update host context\n      if (result.hostContext) {\n        this._hostContext = {\n          ...this._hostContext,\n          ...result.hostContext,\n        };\n      }\n\n      // Trust the origin that successfully completed handshake\n      // (trust-on-first-use if no explicit trusted origins)\n      if (!this._config.options?.trustedOrigins?.length) {\n        // Origin is already set from first successful message\n      }\n    } catch (error) {\n      throw new Error(`ext-apps handshake failed: ${error}`);\n    }\n  }\n\n  // ============================================\n  // Private: Origin Security\n  // ============================================\n\n  /**\n   * Check if an origin is trusted.\n   * Uses trust-on-first-use if no explicit origins configured.\n   */\n  private _isOriginTrusted(origin: string): boolean {\n    // Explicit trusted origins from config\n    const trustedOrigins = this._config.options?.trustedOrigins;\n    if (trustedOrigins && trustedOrigins.length > 0) {\n      return trustedOrigins.includes(origin);\n    }\n\n    // Trust-on-first-use: trust the first origin we receive from\n    if (!this._trustedOrigin) {\n      this._trustedOrigin = origin;\n      return true;\n    }\n\n    return this._trustedOrigin === origin;\n  }\n\n  // ============================================\n  // Private: Events\n  // ============================================\n\n  /**\n   * Emit a bridge event via CustomEvent.\n   */\n  private _emitBridgeEvent(type: string, detail: unknown): void {\n    if (typeof window !== 'undefined' && typeof CustomEvent !== 'undefined') {\n      try {\n        const event = new CustomEvent(type, { detail });\n        window.dispatchEvent(event);\n      } catch {\n        // Ignore event dispatch errors\n      }\n    }\n  }\n}\n\n/**\n * Factory function for creating ext-apps adapter instances.\n */\nexport function createExtAppsAdapter(config?: ExtAppsAdapterConfig): ExtAppsAdapter {\n  return new ExtAppsAdapter(config);\n}\n"]}

package/src/bridge/adapters/gemini.adapter.d.ts

@@ -1,63 +0,0 @@
-/**
- * Gemini Platform Adapter
- *
- * Adapter for Google's Gemini AI platform.
- * Provides integration with Gemini-specific features and APIs.
- *
- * @packageDocumentation
- */
-import { BaseAdapter } from './base-adapter';
-/**
- * Gemini adapter for Google's AI platform.
- *
- * Features:
- * - Theme detection from Gemini SDK or system
- * - Network access for external resources
- * - LocalStorage persistence
- * - Link opening capability
- *
- * @example
- * ```typescript
- * import { GeminiAdapter } from '@frontmcp/ui/bridge';
- *
- * const adapter = new GeminiAdapter();
- * if (adapter.canHandle()) {
- *   await adapter.initialize();
- * }
- * ```
- */
-export declare class GeminiAdapter extends BaseAdapter {
-    readonly id = "gemini";
-    readonly name = "Google Gemini";
-    readonly priority = 40;
-    private _gemini;
-    constructor();
-    /**
-     * Check if we're running in a Gemini context.
-     */
-    canHandle(): boolean;
-    /**
-     * Initialize the Gemini adapter.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Get current theme.
-     */
-    getTheme(): 'light' | 'dark';
-    /**
-     * Send a message (if supported by SDK).
-     */
-    sendMessage(content: string): Promise<void>;
-    /**
-     * Open a link.
-     */
-    openLink(url: string): Promise<void>;
-    /**
-     * Setup listener for system theme changes.
-     */
-    private _setupThemeListener;
-}
-/**
- * Factory function for creating Gemini adapter instances.
- */
-export declare function createGeminiAdapter(): GeminiAdapter;