@frontmcp/ui 0.5.0

package/src/bridge/adapters/gemini.adapter.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Gemini Platform Adapter
+ *
+ * Adapter for Google's Gemini AI platform.
+ * Provides integration with Gemini-specific features and APIs.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiAdapter = void 0;
+exports.createGeminiAdapter = createGeminiAdapter;
+const base_adapter_1 = require("./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();
+ * }
+ * ```
+ */
+class GeminiAdapter extends base_adapter_1.BaseAdapter {
+    id = 'gemini';
+    name = 'Google Gemini';
+    priority = 40;
+    _gemini;
+    constructor() {
+        super();
+        this._capabilities = {
+            ...base_adapter_1.DEFAULT_CAPABILITIES,
+            canCallTools: false, // May be enabled if SDK supports it
+            canSendMessages: false, // May be enabled if SDK supports it
+            canOpenLinks: true,
+            canPersistState: true,
+            hasNetworkAccess: true,
+            supportsDisplayModes: false,
+            supportsTheme: true,
+        };
+    }
+    /**
+     * Check if we're running in a Gemini context.
+     */
+    canHandle() {
+        if (typeof window === 'undefined')
+            return false;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const win = window;
+        // Check explicit platform marker
+        if (win.__mcpPlatform === 'gemini')
+            return true;
+        // Check for Gemini-specific global
+        if (win.gemini)
+            return true;
+        // Check URL patterns for Gemini
+        if (typeof location !== 'undefined') {
+            const href = location.href;
+            if (href.includes('gemini.google.com') || href.includes('bard.google.com')) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Initialize the Gemini adapter.
+     */
+    async initialize() {
+        if (this._initialized)
+            return;
+        // Get Gemini SDK reference if available
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const win = window;
+        this._gemini = win.gemini;
+        // Update capabilities based on available SDK features
+        if (this._gemini?.ui) {
+            if (this._gemini.ui.sendMessage) {
+                this._capabilities = { ...this._capabilities, canSendMessages: true };
+            }
+        }
+        // Call base initialization
+        await super.initialize();
+        // Setup theme listener
+        this._setupThemeListener();
+    }
+    /**
+     * Get current theme.
+     */
+    getTheme() {
+        if (this._gemini?.ui?.getTheme) {
+            const theme = this._gemini.ui.getTheme();
+            return theme === 'dark' ? 'dark' : 'light';
+        }
+        return super.getTheme();
+    }
+    /**
+     * Send a message (if supported by SDK).
+     */
+    async sendMessage(content) {
+        if (this._gemini?.ui?.sendMessage) {
+            await this._gemini.ui.sendMessage(content);
+            return;
+        }
+        throw new Error('Sending messages is not supported by Gemini adapter');
+    }
+    /**
+     * Open a link.
+     */
+    async openLink(url) {
+        if (this._gemini?.ui?.openLink) {
+            await this._gemini.ui.openLink(url);
+            return;
+        }
+        // Fallback to window.open
+        return super.openLink(url);
+    }
+    // ============================================
+    // Private Helpers
+    // ============================================
+    /**
+     * Setup listener for system theme changes.
+     */
+    _setupThemeListener() {
+        if (typeof window === 'undefined' || !window.matchMedia)
+            return;
+        const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
+        const handleChange = (e) => {
+            // Only update if not using SDK theme
+            if (!this._gemini?.ui?.getTheme) {
+                const newTheme = e.matches ? 'dark' : 'light';
+                if (newTheme !== this._hostContext.theme) {
+                    this._notifyContextChange({ theme: newTheme });
+                }
+            }
+        };
+        if (mediaQuery.addEventListener) {
+            mediaQuery.addEventListener('change', handleChange);
+        }
+        else if (mediaQuery.addListener) {
+            mediaQuery.addListener(handleChange);
+        }
+    }
+}
+exports.GeminiAdapter = GeminiAdapter;
+/**
+ * Factory function for creating Gemini adapter instances.
+ */
+function createGeminiAdapter() {
+    return new GeminiAdapter();
+}
+//# sourceMappingURL=gemini.adapter.js.map

package/src/bridge/adapters/gemini.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.adapter.js","sourceRoot":"","sources":["../../../../src/bridge/adapters/gemini.adapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Gemini Platform Adapter\n *\n * Adapter for Google's Gemini AI platform.\n * Provides integration with Gemini-specific features and APIs.\n *\n * @packageDocumentation\n */\n\nimport { BaseAdapter, DEFAULT_CAPABILITIES } from './base-adapter';\n\n/**\n * Gemini SDK global interface (simplified type).\n */\ninterface GeminiSDK {\n  ui?: {\n    getTheme?(): string;\n    sendMessage?(content: string): Promise<void>;\n    openLink?(url: string): Promise<void>;\n  };\n}\n\n/**\n * Gemini adapter for Google's AI platform.\n *\n * Features:\n * - Theme detection from Gemini SDK or system\n * - Network access for external resources\n * - LocalStorage persistence\n * - Link opening capability\n *\n * @example\n * ```typescript\n * import { GeminiAdapter } from '@frontmcp/ui/bridge';\n *\n * const adapter = new GeminiAdapter();\n * if (adapter.canHandle()) {\n *   await adapter.initialize();\n * }\n * ```\n */\nexport class GeminiAdapter extends BaseAdapter {\n  readonly id = 'gemini';\n  readonly name = 'Google Gemini';\n  readonly priority = 40;\n\n  private _gemini: GeminiSDK | undefined;\n\n  constructor() {\n    super();\n    this._capabilities = {\n      ...DEFAULT_CAPABILITIES,\n      canCallTools: false, // May be enabled if SDK supports it\n      canSendMessages: false, // May be enabled if SDK supports it\n      canOpenLinks: true,\n      canPersistState: true,\n      hasNetworkAccess: true,\n      supportsDisplayModes: false,\n      supportsTheme: true,\n    };\n  }\n\n  /**\n   * Check if we're running in a Gemini context.\n   */\n  canHandle(): boolean {\n    if (typeof window === 'undefined') return false;\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const win = window as any;\n\n    // Check explicit platform marker\n    if (win.__mcpPlatform === 'gemini') return true;\n\n    // Check for Gemini-specific global\n    if (win.gemini) return true;\n\n    // Check URL patterns for Gemini\n    if (typeof location !== 'undefined') {\n      const href = location.href;\n      if (href.includes('gemini.google.com') || href.includes('bard.google.com')) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * Initialize the Gemini adapter.\n   */\n  override async initialize(): Promise<void> {\n    if (this._initialized) return;\n\n    // Get Gemini SDK reference if available\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const win = window as any;\n    this._gemini = win.gemini as GeminiSDK | undefined;\n\n    // Update capabilities based on available SDK features\n    if (this._gemini?.ui) {\n      if (this._gemini.ui.sendMessage) {\n        this._capabilities = { ...this._capabilities, canSendMessages: true };\n      }\n    }\n\n    // Call base initialization\n    await super.initialize();\n\n    // Setup theme listener\n    this._setupThemeListener();\n  }\n\n  /**\n   * Get current theme.\n   */\n  override getTheme(): 'light' | 'dark' {\n    if (this._gemini?.ui?.getTheme) {\n      const theme = this._gemini.ui.getTheme();\n      return theme === 'dark' ? 'dark' : 'light';\n    }\n    return super.getTheme();\n  }\n\n  /**\n   * Send a message (if supported by SDK).\n   */\n  override async sendMessage(content: string): Promise<void> {\n    if (this._gemini?.ui?.sendMessage) {\n      await this._gemini.ui.sendMessage(content);\n      return;\n    }\n    throw new Error('Sending messages is not supported by Gemini adapter');\n  }\n\n  /**\n   * Open a link.\n   */\n  override async openLink(url: string): Promise<void> {\n    if (this._gemini?.ui?.openLink) {\n      await this._gemini.ui.openLink(url);\n      return;\n    }\n    // Fallback to window.open\n    return super.openLink(url);\n  }\n\n  // ============================================\n  // Private Helpers\n  // ============================================\n\n  /**\n   * Setup listener for system theme changes.\n   */\n  private _setupThemeListener(): void {\n    if (typeof window === 'undefined' || !window.matchMedia) return;\n\n    const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\n\n    const handleChange = (e: MediaQueryListEvent | MediaQueryList) => {\n      // Only update if not using SDK theme\n      if (!this._gemini?.ui?.getTheme) {\n        const newTheme = e.matches ? 'dark' : 'light';\n        if (newTheme !== this._hostContext.theme) {\n          this._notifyContextChange({ theme: newTheme });\n        }\n      }\n    };\n\n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener('change', handleChange);\n    } else if (mediaQuery.addListener) {\n      mediaQuery.addListener(handleChange);\n    }\n  }\n}\n\n/**\n * Factory function for creating Gemini adapter instances.\n */\nexport function createGeminiAdapter(): GeminiAdapter {\n  return new GeminiAdapter();\n}\n"]}

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

@@ -0,0 +1,55 @@
+/**
+ * Generic Platform Adapter
+ *
+ * Fallback adapter for unknown or unsupported platforms.
+ * Provides basic functionality using standard web APIs.
+ *
+ * @packageDocumentation
+ */
+import { BaseAdapter } from './base-adapter';
+/**
+ * Generic fallback adapter.
+ *
+ * Used when no platform-specific adapter matches the current environment.
+ * Provides basic functionality:
+ * - Theme detection from system preferences
+ * - LocalStorage persistence
+ * - Link opening via window.open
+ * - Injected tool data from window globals
+ *
+ * @example
+ * ```typescript
+ * import { GenericAdapter } from '@frontmcp/ui/bridge';
+ *
+ * const adapter = new GenericAdapter();
+ * await adapter.initialize();
+ * const theme = adapter.getTheme();
+ * ```
+ */
+export declare class GenericAdapter extends BaseAdapter {
+    readonly id = "generic";
+    readonly name = "Generic Web";
+    readonly priority = 0;
+    constructor();
+    /**
+     * Generic adapter can always handle the environment.
+     * It serves as the fallback when no other adapter matches.
+     */
+    canHandle(): boolean;
+    /**
+     * Initialize the generic adapter.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Open a link using window.open.
+     */
+    openLink(url: string): Promise<void>;
+    /**
+     * Setup listener for system theme changes.
+     */
+    private _setupThemeListener;
+}
+/**
+ * Factory function for creating generic adapter instances.
+ */
+export declare function createGenericAdapter(): GenericAdapter;

package/src/bridge/adapters/generic.adapter.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Generic Platform Adapter
+ *
+ * Fallback adapter for unknown or unsupported platforms.
+ * Provides basic functionality using standard web APIs.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenericAdapter = void 0;
+exports.createGenericAdapter = createGenericAdapter;
+const base_adapter_1 = require("./base-adapter");
+/**
+ * Generic fallback adapter.
+ *
+ * Used when no platform-specific adapter matches the current environment.
+ * Provides basic functionality:
+ * - Theme detection from system preferences
+ * - LocalStorage persistence
+ * - Link opening via window.open
+ * - Injected tool data from window globals
+ *
+ * @example
+ * ```typescript
+ * import { GenericAdapter } from '@frontmcp/ui/bridge';
+ *
+ * const adapter = new GenericAdapter();
+ * await adapter.initialize();
+ * const theme = adapter.getTheme();
+ * ```
+ */
+class GenericAdapter extends base_adapter_1.BaseAdapter {
+    id = 'generic';
+    name = 'Generic Web';
+    priority = 0; // Lowest priority - fallback only
+    constructor() {
+        super();
+        this._capabilities = {
+            ...base_adapter_1.DEFAULT_CAPABILITIES,
+            canCallTools: false,
+            canSendMessages: false,
+            canOpenLinks: true, // window.open works
+            canPersistState: true, // localStorage works
+            hasNetworkAccess: true, // Assume network available
+            supportsDisplayModes: false,
+            supportsTheme: true, // System theme detection
+        };
+    }
+    /**
+     * Generic adapter can always handle the environment.
+     * It serves as the fallback when no other adapter matches.
+     */
+    canHandle() {
+        // Always return true - this is the fallback adapter
+        return typeof window !== 'undefined';
+    }
+    /**
+     * Initialize the generic adapter.
+     */
+    async initialize() {
+        if (this._initialized)
+            return;
+        // Call base initialization
+        await super.initialize();
+        // Setup theme listener
+        this._setupThemeListener();
+    }
+    /**
+     * Open a link using window.open.
+     */
+    async openLink(url) {
+        if (typeof window !== 'undefined') {
+            window.open(url, '_blank', 'noopener,noreferrer');
+        }
+    }
+    // ============================================
+    // Private Helpers
+    // ============================================
+    /**
+     * Setup listener for system theme changes.
+     */
+    _setupThemeListener() {
+        if (typeof window === 'undefined' || !window.matchMedia)
+            return;
+        const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
+        const handleChange = (e) => {
+            const newTheme = e.matches ? 'dark' : 'light';
+            if (newTheme !== this._hostContext.theme) {
+                this._notifyContextChange({ theme: newTheme });
+            }
+        };
+        if (mediaQuery.addEventListener) {
+            mediaQuery.addEventListener('change', handleChange);
+        }
+        else if (mediaQuery.addListener) {
+            mediaQuery.addListener(handleChange);
+        }
+    }
+}
+exports.GenericAdapter = GenericAdapter;
+/**
+ * Factory function for creating generic adapter instances.
+ */
+function createGenericAdapter() {
+    return new GenericAdapter();
+}
+//# sourceMappingURL=generic.adapter.js.map

package/src/bridge/adapters/generic.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.adapter.js","sourceRoot":"","sources":["../../../../src/bridge/adapters/generic.adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAuGH,oDAEC;AAvGD,iDAAmE;AAEnE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,cAAe,SAAQ,0BAAW;IACpC,EAAE,GAAG,SAAS,CAAC;IACf,IAAI,GAAG,aAAa,CAAC;IACrB,QAAQ,GAAG,CAAC,CAAC,CAAC,kCAAkC;IAEzD;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG;YACnB,GAAG,mCAAoB;YACvB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,YAAY,EAAE,IAAI,EAAE,oBAAoB;YACxC,eAAe,EAAE,IAAI,EAAE,qBAAqB;YAC5C,gBAAgB,EAAE,IAAI,EAAE,2BAA2B;YACnD,oBAAoB,EAAE,KAAK;YAC3B,aAAa,EAAE,IAAI,EAAE,yBAAyB;SAC/C,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,oDAAoD;QACpD,OAAO,OAAO,MAAM,KAAK,WAAW,CAAC;IACvC,CAAC;IAED;;OAEG;IACM,KAAK,CAAC,UAAU;QACvB,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAE9B,2BAA2B;QAC3B,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QAEzB,uBAAuB;QACvB,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACM,KAAK,CAAC,QAAQ,CAAC,GAAW;QACjC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,kBAAkB;IAClB,+CAA+C;IAE/C;;OAEG;IACK,mBAAmB;QACzB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO;QAEhE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;QAErE,MAAM,YAAY,GAAG,CAAC,CAAuC,EAAE,EAAE;YAC/D,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9C,IAAI,QAAQ,KAAK,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;gBACzC,IAAI,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC;YAChC,UAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAClC,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;CACF;AA3ED,wCA2EC;AAED;;GAEG;AACH,SAAgB,oBAAoB;IAClC,OAAO,IAAI,cAAc,EAAE,CAAC;AAC9B,CAAC","sourcesContent":["/**\n * Generic Platform Adapter\n *\n * Fallback adapter for unknown or unsupported platforms.\n * Provides basic functionality using standard web APIs.\n *\n * @packageDocumentation\n */\n\nimport { BaseAdapter, DEFAULT_CAPABILITIES } from './base-adapter';\n\n/**\n * Generic fallback adapter.\n *\n * Used when no platform-specific adapter matches the current environment.\n * Provides basic functionality:\n * - Theme detection from system preferences\n * - LocalStorage persistence\n * - Link opening via window.open\n * - Injected tool data from window globals\n *\n * @example\n * ```typescript\n * import { GenericAdapter } from '@frontmcp/ui/bridge';\n *\n * const adapter = new GenericAdapter();\n * await adapter.initialize();\n * const theme = adapter.getTheme();\n * ```\n */\nexport class GenericAdapter extends BaseAdapter {\n  readonly id = 'generic';\n  readonly name = 'Generic Web';\n  readonly priority = 0; // Lowest priority - fallback only\n\n  constructor() {\n    super();\n    this._capabilities = {\n      ...DEFAULT_CAPABILITIES,\n      canCallTools: false,\n      canSendMessages: false,\n      canOpenLinks: true, // window.open works\n      canPersistState: true, // localStorage works\n      hasNetworkAccess: true, // Assume network available\n      supportsDisplayModes: false,\n      supportsTheme: true, // System theme detection\n    };\n  }\n\n  /**\n   * Generic adapter can always handle the environment.\n   * It serves as the fallback when no other adapter matches.\n   */\n  canHandle(): boolean {\n    // Always return true - this is the fallback adapter\n    return typeof window !== 'undefined';\n  }\n\n  /**\n   * Initialize the generic adapter.\n   */\n  override async initialize(): Promise<void> {\n    if (this._initialized) return;\n\n    // Call base initialization\n    await super.initialize();\n\n    // Setup theme listener\n    this._setupThemeListener();\n  }\n\n  /**\n   * Open a link using window.open.\n   */\n  override async openLink(url: string): Promise<void> {\n    if (typeof window !== 'undefined') {\n      window.open(url, '_blank', 'noopener,noreferrer');\n    }\n  }\n\n  // ============================================\n  // Private Helpers\n  // ============================================\n\n  /**\n   * Setup listener for system theme changes.\n   */\n  private _setupThemeListener(): void {\n    if (typeof window === 'undefined' || !window.matchMedia) return;\n\n    const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\n\n    const handleChange = (e: MediaQueryListEvent | MediaQueryList) => {\n      const newTheme = e.matches ? 'dark' : 'light';\n      if (newTheme !== this._hostContext.theme) {\n        this._notifyContextChange({ theme: newTheme });\n      }\n    };\n\n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener('change', handleChange);\n    } else if (mediaQuery.addListener) {\n      mediaQuery.addListener(handleChange);\n    }\n  }\n}\n\n/**\n * Factory function for creating generic adapter instances.\n */\nexport function createGenericAdapter(): GenericAdapter {\n  return new GenericAdapter();\n}\n"]}

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

@@ -0,0 +1,25 @@
+/**
+ * Platform Adapters Module
+ *
+ * Exports all platform adapters and the default registration function.
+ *
+ * @packageDocumentation
+ */
+export { BaseAdapter, DEFAULT_CAPABILITIES, DEFAULT_SAFE_AREA } from './base-adapter';
+export { OpenAIAdapter, createOpenAIAdapter } from './openai.adapter';
+export { ExtAppsAdapter, createExtAppsAdapter, type ExtAppsAdapterConfig } from './ext-apps.adapter';
+export { ClaudeAdapter, createClaudeAdapter } from './claude.adapter';
+export { GeminiAdapter, createGeminiAdapter } from './gemini.adapter';
+export { GenericAdapter, createGenericAdapter } from './generic.adapter';
+/**
+ * Register all built-in adapters with the default registry.
+ * Called automatically when importing from '@frontmcp/ui/bridge'.
+ *
+ * Adapter priority order:
+ * 1. OpenAI (100) - ChatGPT Apps SDK
+ * 2. ext-apps (80) - SEP-1865 protocol
+ * 3. Claude (60) - Anthropic Claude
+ * 4. Gemini (40) - Google Gemini
+ * 5. Generic (0) - Fallback
+ */
+export declare function registerBuiltInAdapters(): void;

package/src/bridge/adapters/index.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Platform Adapters Module
+ *
+ * Exports all platform adapters and the default registration function.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGenericAdapter = exports.GenericAdapter = exports.createGeminiAdapter = exports.GeminiAdapter = exports.createClaudeAdapter = exports.ClaudeAdapter = exports.createExtAppsAdapter = exports.ExtAppsAdapter = exports.createOpenAIAdapter = exports.OpenAIAdapter = exports.DEFAULT_SAFE_AREA = exports.DEFAULT_CAPABILITIES = exports.BaseAdapter = void 0;
+exports.registerBuiltInAdapters = registerBuiltInAdapters;
+// Base adapter
+var base_adapter_1 = require("./base-adapter");
+Object.defineProperty(exports, "BaseAdapter", { enumerable: true, get: function () { return base_adapter_1.BaseAdapter; } });
+Object.defineProperty(exports, "DEFAULT_CAPABILITIES", { enumerable: true, get: function () { return base_adapter_1.DEFAULT_CAPABILITIES; } });
+Object.defineProperty(exports, "DEFAULT_SAFE_AREA", { enumerable: true, get: function () { return base_adapter_1.DEFAULT_SAFE_AREA; } });
+// Platform adapters
+var openai_adapter_1 = require("./openai.adapter");
+Object.defineProperty(exports, "OpenAIAdapter", { enumerable: true, get: function () { return openai_adapter_1.OpenAIAdapter; } });
+Object.defineProperty(exports, "createOpenAIAdapter", { enumerable: true, get: function () { return openai_adapter_1.createOpenAIAdapter; } });
+var ext_apps_adapter_1 = require("./ext-apps.adapter");
+Object.defineProperty(exports, "ExtAppsAdapter", { enumerable: true, get: function () { return ext_apps_adapter_1.ExtAppsAdapter; } });
+Object.defineProperty(exports, "createExtAppsAdapter", { enumerable: true, get: function () { return ext_apps_adapter_1.createExtAppsAdapter; } });
+var claude_adapter_1 = require("./claude.adapter");
+Object.defineProperty(exports, "ClaudeAdapter", { enumerable: true, get: function () { return claude_adapter_1.ClaudeAdapter; } });
+Object.defineProperty(exports, "createClaudeAdapter", { enumerable: true, get: function () { return claude_adapter_1.createClaudeAdapter; } });
+var gemini_adapter_1 = require("./gemini.adapter");
+Object.defineProperty(exports, "GeminiAdapter", { enumerable: true, get: function () { return gemini_adapter_1.GeminiAdapter; } });
+Object.defineProperty(exports, "createGeminiAdapter", { enumerable: true, get: function () { return gemini_adapter_1.createGeminiAdapter; } });
+var generic_adapter_1 = require("./generic.adapter");
+Object.defineProperty(exports, "GenericAdapter", { enumerable: true, get: function () { return generic_adapter_1.GenericAdapter; } });
+Object.defineProperty(exports, "createGenericAdapter", { enumerable: true, get: function () { return generic_adapter_1.createGenericAdapter; } });
+// Default registration
+const core_1 = require("../core");
+const openai_adapter_2 = require("./openai.adapter");
+const ext_apps_adapter_2 = require("./ext-apps.adapter");
+const claude_adapter_2 = require("./claude.adapter");
+const gemini_adapter_2 = require("./gemini.adapter");
+const generic_adapter_2 = require("./generic.adapter");
+/**
+ * Register all built-in adapters with the default registry.
+ * Called automatically when importing from '@frontmcp/ui/bridge'.
+ *
+ * Adapter priority order:
+ * 1. OpenAI (100) - ChatGPT Apps SDK
+ * 2. ext-apps (80) - SEP-1865 protocol
+ * 3. Claude (60) - Anthropic Claude
+ * 4. Gemini (40) - Google Gemini
+ * 5. Generic (0) - Fallback
+ */
+function registerBuiltInAdapters() {
+    // OpenAI - highest priority
+    core_1.defaultRegistry.register('openai', openai_adapter_2.createOpenAIAdapter);
+    // ext-apps (SEP-1865) - high priority
+    core_1.defaultRegistry.register('ext-apps', ext_apps_adapter_2.createExtAppsAdapter);
+    // Claude
+    core_1.defaultRegistry.register('claude', claude_adapter_2.createClaudeAdapter);
+    // Gemini
+    core_1.defaultRegistry.register('gemini', gemini_adapter_2.createGeminiAdapter);
+    // Generic - fallback (always matches)
+    core_1.defaultRegistry.register('generic', generic_adapter_2.createGenericAdapter);
+}
+// Auto-register built-in adapters on module load
+registerBuiltInAdapters();
+//# sourceMappingURL=index.js.map

package/src/bridge/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/bridge/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA+BH,0DAeC;AA5CD,eAAe;AACf,+CAAsF;AAA7E,2GAAA,WAAW,OAAA;AAAE,oHAAA,oBAAoB,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAE7D,oBAAoB;AACpB,mDAAsE;AAA7D,+GAAA,aAAa,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAC3C,uDAAqG;AAA5F,kHAAA,cAAc,OAAA;AAAE,wHAAA,oBAAoB,OAAA;AAC7C,mDAAsE;AAA7D,+GAAA,aAAa,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAC3C,mDAAsE;AAA7D,+GAAA,aAAa,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAC3C,qDAAyE;AAAhE,iHAAA,cAAc,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AAE7C,uBAAuB;AACvB,kCAA0C;AAC1C,qDAAuD;AACvD,yDAA0D;AAC1D,qDAAuD;AACvD,qDAAuD;AACvD,uDAAyD;AAEzD;;;;;;;;;;GAUG;AACH,SAAgB,uBAAuB;IACrC,4BAA4B;IAC5B,sBAAe,CAAC,QAAQ,CAAC,QAAQ,EAAE,oCAAmB,CAAC,CAAC;IAExD,sCAAsC;IACtC,sBAAe,CAAC,QAAQ,CAAC,UAAU,EAAE,uCAAoB,CAAC,CAAC;IAE3D,SAAS;IACT,sBAAe,CAAC,QAAQ,CAAC,QAAQ,EAAE,oCAAmB,CAAC,CAAC;IAExD,SAAS;IACT,sBAAe,CAAC,QAAQ,CAAC,QAAQ,EAAE,oCAAmB,CAAC,CAAC;IAExD,sCAAsC;IACtC,sBAAe,CAAC,QAAQ,CAAC,SAAS,EAAE,sCAAoB,CAAC,CAAC;AAC5D,CAAC;AAED,iDAAiD;AACjD,uBAAuB,EAAE,CAAC","sourcesContent":["/**\n * Platform Adapters Module\n *\n * Exports all platform adapters and the default registration function.\n *\n * @packageDocumentation\n */\n\n// Base adapter\nexport { BaseAdapter, DEFAULT_CAPABILITIES, DEFAULT_SAFE_AREA } from './base-adapter';\n\n// Platform adapters\nexport { OpenAIAdapter, createOpenAIAdapter } from './openai.adapter';\nexport { ExtAppsAdapter, createExtAppsAdapter, type ExtAppsAdapterConfig } from './ext-apps.adapter';\nexport { ClaudeAdapter, createClaudeAdapter } from './claude.adapter';\nexport { GeminiAdapter, createGeminiAdapter } from './gemini.adapter';\nexport { GenericAdapter, createGenericAdapter } from './generic.adapter';\n\n// Default registration\nimport { defaultRegistry } from '../core';\nimport { createOpenAIAdapter } from './openai.adapter';\nimport { createExtAppsAdapter } from './ext-apps.adapter';\nimport { createClaudeAdapter } from './claude.adapter';\nimport { createGeminiAdapter } from './gemini.adapter';\nimport { createGenericAdapter } from './generic.adapter';\n\n/**\n * Register all built-in adapters with the default registry.\n * Called automatically when importing from '@frontmcp/ui/bridge'.\n *\n * Adapter priority order:\n * 1. OpenAI (100) - ChatGPT Apps SDK\n * 2. ext-apps (80) - SEP-1865 protocol\n * 3. Claude (60) - Anthropic Claude\n * 4. Gemini (40) - Google Gemini\n * 5. Generic (0) - Fallback\n */\nexport function registerBuiltInAdapters(): void {\n  // OpenAI - highest priority\n  defaultRegistry.register('openai', createOpenAIAdapter);\n\n  // ext-apps (SEP-1865) - high priority\n  defaultRegistry.register('ext-apps', createExtAppsAdapter);\n\n  // Claude\n  defaultRegistry.register('claude', createClaudeAdapter);\n\n  // Gemini\n  defaultRegistry.register('gemini', createGeminiAdapter);\n\n  // Generic - fallback (always matches)\n  defaultRegistry.register('generic', createGenericAdapter);\n}\n\n// Auto-register built-in adapters on module load\nregisterBuiltInAdapters();\n"]}

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

@@ -0,0 +1,64 @@
+/**
+ * OpenAI Platform Adapter
+ *
+ * Adapter for OpenAI's ChatGPT Apps SDK.
+ * Provides full widget functionality including tool calls, messaging,
+ * and display mode changes via the window.openai API.
+ *
+ * @packageDocumentation
+ */
+import type { DisplayMode } from '../types';
+import { BaseAdapter } from './base-adapter';
+/**
+ * OpenAI Apps SDK adapter.
+ *
+ * Detects the presence of `window.openai` and proxies all operations
+ * through the ChatGPT Apps SDK.
+ *
+ * @example
+ * ```typescript
+ * import { OpenAIAdapter } from '@frontmcp/ui/bridge';
+ *
+ * const adapter = new OpenAIAdapter();
+ * if (adapter.canHandle()) {
+ *   await adapter.initialize();
+ *   const theme = adapter.getTheme();
+ * }
+ * ```
+ */
+export declare class OpenAIAdapter extends BaseAdapter {
+    readonly id = "openai";
+    readonly name = "OpenAI ChatGPT";
+    readonly priority = 100;
+    private _openai;
+    private _unsubscribeContext;
+    private _unsubscribeToolResult;
+    constructor();
+    /**
+     * Check if OpenAI Apps SDK is available.
+     */
+    canHandle(): boolean;
+    /**
+     * Initialize the OpenAI adapter.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Dispose adapter resources.
+     */
+    dispose(): void;
+    getTheme(): 'light' | 'dark';
+    getDisplayMode(): DisplayMode;
+    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>;
+    /**
+     * Sync context from OpenAI SDK.
+     */
+    private _syncContextFromSDK;
+}
+/**
+ * Factory function for creating OpenAI adapter instances.
+ */
+export declare function createOpenAIAdapter(): OpenAIAdapter;