@frontmcp/ui 0.5.1 → 0.6.0

package/esm/base-template/polyfills.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Platform Polyfills for Base Template
+ *
+ * Provides additional polyfills for MCP session detection and
+ * direct HTTP fallback when not in an OpenAI or ext-apps environment.
+ *
+ * These polyfills complement the existing MCP_BRIDGE_RUNTIME.
+ */
+/**
+ * MCP Session information for HTTP fallback
+ */
+export interface McpSession {
+    /** MCP server URL */
+    mcpUrl: string;
+    /** Session ID for authentication */
+    sessionId: string;
+}
+/**
+ * Render the MCP session detection polyfill script.
+ *
+ * This provides auto-detection of MCP session info from:
+ * 1. Explicit window.__frontmcp.mcpSession
+ * 2. Meta tags (mcp-url, mcp-session-id)
+ * 3. URL query parameters (mcpUrl, sessionId)
+ * 4. Fallback values provided at render time
+ *
+ * @param mcpSession - Optional explicit session to bake into the template
+ * @returns Script tag with polyfill code
+ */
+export declare function renderMcpSessionPolyfill(mcpSession?: McpSession): string;
+//# sourceMappingURL=polyfills.d.ts.map

package/esm/base-template/polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.d.ts","sourceRoot":"","sources":["../../../src/base-template/polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAuJxE"}

package/esm/base-template/theme-styles.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Theme Styles for Base Template
+ *
+ * Composes theme configuration into complete HTML head content
+ * including fonts, scripts, and CSS custom properties.
+ *
+ * Uses existing theme utilities from @frontmcp/ui/theme module.
+ */
+import { type ThemeConfig } from '../theme';
+/**
+ * Options for rendering theme styles.
+ */
+export interface ThemeStylesOptions {
+    /** Theme configuration (default: DEFAULT_THEME) */
+    theme?: ThemeConfig;
+    /** Include Tailwind CSS (default: true) */
+    tailwind?: boolean;
+    /** Include HTMX (default: false) */
+    htmx?: boolean;
+    /** Include Alpine.js (default: false) */
+    alpine?: boolean;
+    /** Include fonts (default: true) */
+    fonts?: boolean;
+    /** Use inline scripts from cache (for blocked network platforms) */
+    inline?: boolean;
+}
+/**
+ * Render complete theme styles for HTML head section.
+ *
+ * This function composes all theme-related HTML including:
+ * 1. Font preconnect links (optional)
+ * 2. Font stylesheets (optional)
+ * 3. Tailwind CSS script (with @theme variables)
+ * 4. Additional framework scripts (HTMX, Alpine.js)
+ *
+ * @param options - Theme styles configuration
+ * @returns HTML string with all style/script tags
+ *
+ * @example
+ * ```typescript
+ * // Default theme with Tailwind only
+ * const styles = renderThemeStyles();
+ *
+ * // Custom theme with HTMX
+ * const styles = renderThemeStyles({
+ *   theme: customTheme,
+ *   htmx: true,
+ * });
+ *
+ * // For blocked-network platforms (Claude Artifacts)
+ * await fetchAndCacheScriptsFromTheme(theme);
+ * const styles = renderThemeStyles({ inline: true });
+ * ```
+ */
+export declare function renderThemeStyles(options?: ThemeStylesOptions): string;
+/**
+ * Render minimal theme styles (Tailwind + @theme only).
+ *
+ * Use this for lightweight widgets that don't need fonts or additional scripts.
+ *
+ * @param theme - Theme configuration (default: DEFAULT_THEME)
+ * @returns HTML string with Tailwind script and @theme style block
+ */
+export declare function renderMinimalThemeStyles(theme?: ThemeConfig): string;
+/**
+ * Render theme CSS variables only (no scripts).
+ *
+ * Use this when Tailwind is already loaded elsewhere.
+ *
+ * @param theme - Theme configuration (default: DEFAULT_THEME)
+ * @returns HTML style block with @theme CSS
+ */
+export declare function renderThemeCssOnly(theme?: ThemeConfig): string;
+//# sourceMappingURL=theme-styles.d.ts.map

package/esm/base-template/theme-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-styles.d.ts","sourceRoot":"","sources":["../../../src/base-template/theme-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAmC1E;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,GAAE,WAA2B,GAAG,MAAM,CASnF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,WAA2B,GAAG,MAAM,CAE7E"}

package/esm/bridge/adapters/base-adapter.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Base Platform Adapter
+ *
+ * Abstract base class for platform adapters with default implementations.
+ * Extend this class to create custom adapters for new platforms.
+ *
+ * @packageDocumentation
+ */
+import type { PlatformAdapter, AdapterCapabilities, DisplayMode, UserAgentInfo, SafeAreaInsets, ViewportInfo, HostContext } from '../types';
+/**
+ * Default adapter capabilities (most features disabled).
+ */
+export declare const DEFAULT_CAPABILITIES: AdapterCapabilities;
+/**
+ * Default safe area insets (no insets).
+ */
+export declare const DEFAULT_SAFE_AREA: SafeAreaInsets;
+/**
+ * Abstract base class for platform adapters.
+ * Provides default implementations that can be overridden.
+ */
+export declare abstract class BaseAdapter implements PlatformAdapter {
+    abstract readonly id: string;
+    abstract readonly name: string;
+    abstract readonly priority: number;
+    protected _capabilities: AdapterCapabilities;
+    protected _hostContext: HostContext;
+    protected _widgetState: Record<string, unknown>;
+    protected _toolInput: Record<string, unknown>;
+    protected _toolOutput: unknown;
+    protected _structuredContent: unknown;
+    protected _initialized: boolean;
+    protected _contextListeners: Set<(changes: Partial<HostContext>) => void>;
+    protected _toolResultListeners: Set<(result: unknown) => void>;
+    constructor();
+    get capabilities(): AdapterCapabilities;
+    abstract canHandle(): boolean;
+    initialize(): Promise<void>;
+    dispose(): void;
+    getTheme(): 'light' | 'dark';
+    getDisplayMode(): DisplayMode;
+    getUserAgent(): UserAgentInfo;
+    getLocale(): string;
+    getToolInput(): Record<string, unknown>;
+    getToolOutput(): unknown;
+    getStructuredContent(): unknown;
+    getWidgetState(): Record<string, unknown>;
+    getSafeArea(): SafeAreaInsets;
+    getViewport(): ViewportInfo | undefined;
+    getHostContext(): HostContext;
+    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>;
+    setWidgetState(state: Record<string, unknown>): void;
+    onContextChange(callback: (changes: Partial<HostContext>) => void): () => void;
+    onToolResult(callback: (result: unknown) => void): () => void;
+    /**
+     * Create default host context from environment detection.
+     */
+    protected _createDefaultHostContext(): HostContext;
+    /**
+     * Detect theme from CSS media query.
+     */
+    protected _detectTheme(): 'light' | 'dark';
+    /**
+     * Detect locale from navigator.
+     */
+    protected _detectLocale(): string;
+    /**
+     * Detect user agent capabilities.
+     */
+    protected _detectUserAgent(): UserAgentInfo;
+    /**
+     * Detect viewport dimensions.
+     */
+    protected _detectViewport(): ViewportInfo | undefined;
+    /**
+     * Read injected tool data from window globals.
+     */
+    protected _readInjectedData(): void;
+    /**
+     * Load widget state from localStorage.
+     */
+    protected _loadWidgetState(): void;
+    /**
+     * Persist widget state to localStorage.
+     */
+    protected _persistWidgetState(): void;
+    /**
+     * Get localStorage key for widget state.
+     */
+    protected _getStateKey(): string;
+    /**
+     * Notify context change listeners.
+     */
+    protected _notifyContextChange(changes: Partial<HostContext>): void;
+    /**
+     * Notify tool result listeners.
+     */
+    protected _notifyToolResult(result: unknown): void;
+}
+//# sourceMappingURL=base-adapter.d.ts.map

package/esm/bridge/adapters/base-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../../../src/bridge/adapters/base-adapter.ts"],"names":[],"mappings":"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"}

package/esm/bridge/adapters/claude.adapter.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Claude Platform Adapter
+ *
+ * Adapter for Claude (Anthropic) artifacts and widgets.
+ * Claude artifacts have network restrictions - external fetches are blocked.
+ * This adapter relies on injected data and localStorage for state.
+ *
+ * @packageDocumentation
+ */
+import type { DisplayMode } from '../types';
+import { BaseAdapter } from './base-adapter';
+/**
+ * Claude adapter for Anthropic's Claude AI.
+ *
+ * Features:
+ * - Theme detection from system preferences
+ * - Injected tool data via window globals
+ * - LocalStorage persistence for widget state
+ * - No external network access (blocked by Claude)
+ *
+ * @example
+ * ```typescript
+ * import { ClaudeAdapter } from '@frontmcp/ui/bridge';
+ *
+ * const adapter = new ClaudeAdapter();
+ * if (adapter.canHandle()) {
+ *   await adapter.initialize();
+ *   const input = adapter.getToolInput();
+ * }
+ * ```
+ */
+export declare class ClaudeAdapter extends BaseAdapter {
+    readonly id = "claude";
+    readonly name = "Claude (Anthropic)";
+    readonly priority = 60;
+    constructor();
+    /**
+     * Check if we're running in a Claude artifact/widget context.
+     */
+    canHandle(): boolean;
+    /**
+     * Initialize the Claude adapter.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Open a link in a new tab.
+     * This is one of the few actions available in Claude artifacts.
+     */
+    openLink(url: string): Promise<void>;
+    /**
+     * Request display mode change (no-op for Claude).
+     */
+    requestDisplayMode(_mode: DisplayMode): Promise<void>;
+    /**
+     * Request close (no-op for Claude).
+     */
+    requestClose(): Promise<void>;
+    /**
+     * Setup listener for system theme changes.
+     */
+    private _setupThemeListener;
+}
+/**
+ * Factory function for creating Claude adapter instances.
+ */
+export declare function createClaudeAdapter(): ClaudeAdapter;
+//# sourceMappingURL=claude.adapter.d.ts.map

package/esm/bridge/adapters/claude.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.adapter.d.ts","sourceRoot":"","sources":["../../../../src/bridge/adapters/claude.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAwB,MAAM,gBAAgB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,QAAQ,MAAM;;IAgBvB;;OAEG;IACH,SAAS,IAAI,OAAO;IA0BpB;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAU1C;;;OAGG;IACY,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD;;OAEG;IACY,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE;;OAEG;IACY,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5C;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAoB5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

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

@@ -0,0 +1,143 @@
+/**
+ * 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;
+//# sourceMappingURL=ext-apps.adapter.d.ts.map

package/esm/bridge/adapters/ext-apps.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext-apps.adapter.d.ts","sourceRoot":"","sources":["../../../../src/bridge/adapters/ext-apps.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EAUX,aAAa,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAwB,MAAM,gBAAgB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,OAAO,CAAC,EAAE;QACR,qFAAqF;QACrF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,qCAAqC;QACrC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,wCAAwC;QACxC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,kDAAkD;QAClD,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gDAAgD;QAChD,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,QAAQ,MAAM;IAEvB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,gBAAgB,CAOV;IACd,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,iBAAiB,CAAmD;gBAEhE,MAAM,CAAC,EAAE,oBAAoB;IAazC;;OAEG;IACH,SAAS,IAAI,OAAO;IAmBpB;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe1C;;OAEG;IACM,OAAO,IAAI,IAAI;IAqBT,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASpC,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5C;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsBhC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,YAAY;IA2BpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;YACW,iBAAiB;IAmD/B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAUzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,cAAc,CAElF"}

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

@@ -0,0 +1,64 @@
+/**
+ * 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;
+//# sourceMappingURL=gemini.adapter.d.ts.map

package/esm/bridge/adapters/gemini.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.adapter.d.ts","sourceRoot":"","sources":["../../../../src/bridge/adapters/gemini.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAwB,MAAM,gBAAgB,CAAC;AAanE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,QAAQ,MAAM;IAEvB,OAAO,CAAC,OAAO,CAAwB;;IAgBvC;;OAEG;IACH,SAAS,IAAI,OAAO;IAuBpB;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB1C;;OAEG;IACM,QAAQ,IAAI,OAAO,GAAG,MAAM;IAQrC;;OAEG;IACY,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D;;OAEG;IACY,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAanD;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAqB5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

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

@@ -0,0 +1,56 @@
+/**
+ * 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;
+//# sourceMappingURL=generic.adapter.d.ts.map

package/esm/bridge/adapters/generic.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.adapter.d.ts","sourceRoot":"","sources":["../../../../src/bridge/adapters/generic.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAwB,MAAM,gBAAgB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,EAAE,aAAa;IACxB,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,QAAQ,KAAK;;IAgBtB;;;OAGG;IACH,SAAS,IAAI,OAAO;IAKpB;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAU1C;;OAEG;IACY,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAkB5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

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

@@ -0,0 +1,26 @@
+/**
+ * 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;
+//# sourceMappingURL=index.d.ts.map

package/esm/bridge/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bridge/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGtF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAUzE;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAe9C"}

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

@@ -0,0 +1,65 @@
+/**
+ * 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;
+//# sourceMappingURL=openai.adapter.d.ts.map

package/esm/bridge/adapters/openai.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.adapter.d.ts","sourceRoot":"","sources":["../../../../src/bridge/adapters/openai.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,WAAW,EAAwB,MAAM,gBAAgB,CAAC;AAoBnE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,QAAQ,OAAO;IAExB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,mBAAmB,CAA2B;IACtD,OAAO,CAAC,sBAAsB,CAA2B;;IAgBzD;;OAEG;IACH,SAAS,IAAI,OAAO;IAOpB;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B1C;;OAEG;IACM,OAAO,IAAI,IAAI;IAiBf,QAAQ,IAAI,OAAO,GAAG,MAAM;IAQ5B,cAAc,IAAI,WAAW;IAevB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAOvE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpC,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5C;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAyB5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}