@frontmcp/ui 0.5.0

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

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

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

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

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