@portel/photon 1.4.0 → 1.5.1

package/dist/auto-ui/photon-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-host.js","sourceRoot":"","sources":["../../src/auto-ui/photon-host.ts"],"names":[],"mappings":"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"}

package/dist/auto-ui/platform-compat.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Platform Compatibility Layer
+ *
+ * Provides universal compatibility for custom UIs across:
+ * - MCP Apps Extension (SEP-1865) - Standard ui/initialize protocol
+ * - ChatGPT Apps SDK - window.openai API
+ * - Claude Artifacts - postMessage with theme class
+ *
+ * BEAM injects all these APIs so apps built for any platform work without modification.
+ *
+ * @see https://github.com/modelcontextprotocol/modelcontextprotocol/pull/1865
+ * @see https://developers.openai.com/apps-sdk/reference/
+ * @see https://www.reidbarber.com/blog/reverse-engineering-claude-artifacts
+ */
+import type { PlatformContext } from '@portel/photon-core';
+export { type McpAppsInitialize, type McpAppsToolInput, type McpAppsToolResult, type McpAppsHostContextChanged, type McpAppsResourceTeardown, type McpAppsModelContextUpdate, type PlatformContext, createMcpAppsInitialize, createThemeChangeMessages, } from '@portel/photon-core';
+export interface OpenAiContext {
+    theme: 'light' | 'dark';
+    displayMode: 'inline' | 'fullscreen' | 'pip';
+    locale: string;
+    maxHeight: number;
+    safeArea: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+    view: 'widget' | 'modal';
+    userAgent: string;
+    toolInput: Record<string, unknown>;
+    toolOutput: unknown;
+    widgetState: unknown;
+}
+export interface OpenAiApi {
+    theme: 'light' | 'dark';
+    displayMode: 'inline' | 'fullscreen' | 'pip';
+    locale: string;
+    maxHeight: number;
+    toolInput: Record<string, unknown>;
+    toolOutput: unknown;
+    widgetState: unknown;
+    setWidgetState(state: unknown): void;
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    sendFollowUpMessage(options: {
+        prompt: string;
+    }): Promise<void>;
+    uploadFile(file: File): Promise<{
+        fileId: string;
+    }>;
+    getFileDownloadUrl(options: {
+        fileId: string;
+    }): Promise<string>;
+    requestDisplayMode(mode: 'inline' | 'fullscreen' | 'pip'): Promise<void>;
+    requestModal(options: {
+        params: unknown;
+        template: string;
+    }): Promise<void>;
+    notifyIntrinsicHeight(height: number): void;
+    openExternal(options: {
+        href: string;
+    }): void;
+    setOpenInAppUrl(options: {
+        href: string;
+    }): void;
+}
+/**
+ * Generate the script that injects all platform APIs into an iframe.
+ * This enables apps built for ChatGPT, Claude, or MCP Apps to work in BEAM.
+ */
+export declare function generatePlatformBridgeScript(context: PlatformContext): string;
+//# sourceMappingURL=platform-compat.d.ts.map

package/dist/auto-ui/platform-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-compat.d.ts","sourceRoot":"","sources":["../../src/auto-ui/platform-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,WAAW,EAAE,QAAQ,GAAG,YAAY,GAAG,KAAK,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IAExB,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,WAAW,EAAE,QAAQ,GAAG,YAAY,GAAG,KAAK,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IAGrB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,mBAAmB,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,kBAAkB,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,YAAY,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,YAAY,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,eAAe,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAClD;AAMD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAkiB7E"}

package/dist/auto-ui/platform-compat.js

@@ -0,0 +1,574 @@
+/**
+ * Platform Compatibility Layer
+ *
+ * Provides universal compatibility for custom UIs across:
+ * - MCP Apps Extension (SEP-1865) - Standard ui/initialize protocol
+ * - ChatGPT Apps SDK - window.openai API
+ * - Claude Artifacts - postMessage with theme class
+ *
+ * BEAM injects all these APIs so apps built for any platform work without modification.
+ *
+ * @see https://github.com/modelcontextprotocol/modelcontextprotocol/pull/1865
+ * @see https://developers.openai.com/apps-sdk/reference/
+ * @see https://www.reidbarber.com/blog/reverse-engineering-claude-artifacts
+ */
+import { getThemeTokens } from './design-system/tokens.js';
+// Re-export MCP Apps standard types and helpers from core
+export { createMcpAppsInitialize, createThemeChangeMessages, } from '@portel/photon-core';
+// ════════════════════════════════════════════════════════════════════════════════
+// PLATFORM BRIDGE SCRIPT GENERATOR
+// ════════════════════════════════════════════════════════════════════════════════
+/**
+ * Generate the script that injects all platform APIs into an iframe.
+ * This enables apps built for ChatGPT, Claude, or MCP Apps to work in BEAM.
+ */
+export function generatePlatformBridgeScript(context) {
+    const themeTokens = getThemeTokens(context.theme);
+    const themeTokensJson = JSON.stringify(themeTokens);
+    const contextJson = JSON.stringify(context);
+    return `
+<script>
+(function() {
+  'use strict';
+
+  // ══════════════════════════════════════════════════════════════════════════
+  // SHARED STATE
+  // ══════════════════════════════════════════════════════════════════════════
+
+  var ctx = ${contextJson};
+  var themeTokens = ${themeTokensJson};
+  var toolInput = {};
+  var toolOutput = null;
+  var widgetState = {};
+  var pendingCalls = {};
+  var callIdCounter = 0;
+
+  // Event listeners
+  var listeners = {
+    progress: [],
+    status: [],
+    stream: [],
+    emit: [],
+    toolInputPartial: [],
+    toolInput: [],
+    result: [],
+    error: [],
+    themeChange: []
+  };
+  var elicitationHandler = null;
+  var teardownHandler = null;
+
+  function subscribe(arr, cb) {
+    arr.push(cb);
+    return function() { var i = arr.indexOf(cb); if (i >= 0) arr.splice(i, 1); };
+  }
+
+  function postToHost(msg) {
+    window.parent.postMessage(msg, '*');
+  }
+
+  function generateCallId() {
+    return 'call_' + (++callIdCounter) + '_' + Math.random().toString(36).slice(2);
+  }
+
+  // ══════════════════════════════════════════════════════════════════════════
+  // MESSAGE HANDLER (receives from host)
+  // ══════════════════════════════════════════════════════════════════════════
+
+  window.addEventListener('message', function(e) {
+    var m = e.data;
+    if (!m || typeof m !== 'object') return;
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // MCP Apps Extension (JSON-RPC 2.0)
+    // ─────────────────────────────────────────────────────────────────────────
+    if (m.jsonrpc === '2.0') {
+      // JSON-RPC response (from tools/call) - has id but no method
+      if (m.id && !m.method) {
+        var pending = pendingCalls[m.id];
+        if (pending) {
+          delete pendingCalls[m.id];
+          if (m.error) pending.reject(new Error(m.error.message || 'Tool call failed'));
+          else pending.resolve(m.result);
+        }
+        return;
+      }
+      if (m.method === 'ui/initialize') {
+        // Standard: hostContext.styles.variables; Legacy: params.theme
+        var initTokens = (m.params.hostContext && m.params.hostContext.styles && m.params.hostContext.styles.variables) || m.params.theme;
+        if (initTokens) themeTokens = initTokens;
+        // Extract theme name from hostContext or fall back
+        if (m.params.hostContext && m.params.hostContext.theme) ctx.theme = m.params.hostContext.theme;
+        applyThemeTokens();
+      }
+      else if (m.method === 'ui/notifications/tool-input-partial') {
+        listeners.toolInputPartial.forEach(function(cb) { cb(m.params); });
+      }
+      else if (m.method === 'ui/notifications/tool-input') {
+        toolInput = m.params.input || {};
+        listeners.toolInput.forEach(function(cb) { cb(m.params); });
+      }
+      else if (m.method === 'ui/notifications/tool-result') {
+        toolOutput = m.params.result;
+        listeners.result.forEach(function(cb) { cb(m.params.result); });
+      }
+      else if (m.method === 'ui/resource-teardown' && m.id != null) {
+        var teardownResult = teardownHandler ? teardownHandler() : undefined;
+        var sendTeardownResponse = function() {
+          postToHost({ jsonrpc: '2.0', id: m.id, result: {} });
+        };
+        if (teardownResult && typeof teardownResult.then === 'function') {
+          teardownResult.then(sendTeardownResponse).catch(sendTeardownResponse);
+        } else {
+          sendTeardownResponse();
+        }
+      }
+      else if (m.method === 'ui/notifications/context' || m.method === 'ui/notifications/host-context-changed') {
+        // Standard spec: host-context-changed with styles.variables
+        var ctxParams = m.params || {};
+        if (ctxParams.styles && ctxParams.styles.variables) {
+          themeTokens = ctxParams.styles.variables;
+          applyThemeTokens();
+        }
+        if (ctxParams.theme) {
+          ctx.theme = ctxParams.theme;
+          applyThemeClass();
+          listeners.themeChange.forEach(function(cb) { cb(ctx.theme); });
+        }
+        // Legacy: flat merge
+        Object.assign(ctx, ctxParams);
+      }
+      return;
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // Photon Bridge Protocol (internal)
+    // ─────────────────────────────────────────────────────────────────────────
+    if (typeof m.type === 'string' && m.type.indexOf('photon:') === 0) {
+      if (m.type === 'photon:init') {
+        toolInput = m.toolInput || {};
+        Object.assign(ctx, m.context);
+        themeTokens = m.themeTokens || themeTokens;
+        applyThemeTokens();
+      }
+      else if (m.type === 'photon:emit') {
+        var ev = m.event;
+        listeners.emit.forEach(function(cb) { cb(ev); });
+        if (ev.emit === 'progress') listeners.progress.forEach(function(cb) { cb(ev); });
+        else if (ev.emit === 'status') listeners.status.forEach(function(cb) { cb(ev); });
+        else if (ev.emit === 'stream') listeners.stream.forEach(function(cb) { cb(ev); });
+      }
+      else if (m.type === 'photon:ask' && elicitationHandler) {
+        elicitationHandler(m.event).then(function(v) {
+          postToHost({ type: 'photon:ask-response', id: m.id, value: v });
+        });
+      }
+      else if (m.type === 'photon:result') {
+        toolOutput = m.data;
+        listeners.result.forEach(function(cb) { cb(m.data); });
+      }
+      else if (m.type === 'photon:error') {
+        listeners.error.forEach(function(cb) { cb(m.error); });
+      }
+      else if (m.type === 'photon:context') {
+        Object.assign(ctx, m.context);
+        if (m.themeTokens) {
+          themeTokens = m.themeTokens;
+          applyThemeTokens();
+        }
+        if (m.context.theme) {
+          listeners.themeChange.forEach(function(cb) { cb(ctx.theme); });
+        }
+      }
+      else if (m.type === 'photon:theme-change') {
+        // Theme change from BEAM
+        ctx.theme = m.theme || 'dark';
+        // Update theme tokens if provided
+        if (m.themeTokens) {
+          themeTokens = m.themeTokens;
+          applyThemeTokens();
+        }
+        applyThemeClass();
+        listeners.themeChange.forEach(function(cb) { cb(ctx.theme); });
+      }
+      else if (m.type === 'photon:upload-file-response') {
+        var pending = pendingCalls[m.callId];
+        if (pending) {
+          delete pendingCalls[m.callId];
+          if (m.error) pending.reject(new Error(m.error));
+          else pending.resolve({ fileId: m.fileId });
+        }
+      }
+      else if (m.type === 'photon:get-file-url-response') {
+        var pending = pendingCalls[m.callId];
+        if (pending) {
+          delete pendingCalls[m.callId];
+          if (m.error) pending.reject(new Error(m.error));
+          else pending.resolve(m.url);
+        }
+      }
+      else if (m.type === 'photon:request-modal-response') {
+        var pending = pendingCalls[m.callId];
+        if (pending) {
+          delete pendingCalls[m.callId];
+          if (m.error) pending.reject(new Error(m.error));
+          else pending.resolve(m.result);
+        }
+      }
+      else if (m.type === 'photon:init-state') {
+        // Restore persisted widget state from host
+        if (m.state !== null && m.state !== undefined) {
+          widgetState = m.state;
+          // Dispatch event for apps listening to state changes
+          window.dispatchEvent(new CustomEvent('photon:state-restored', { detail: m.state }));
+        }
+      }
+      return;
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // Claude Artifacts Protocol (simple postMessage)
+    // ─────────────────────────────────────────────────────────────────────────
+    if (m.type === 'theme') {
+      ctx.theme = m.theme || 'dark';
+      applyThemeClass();
+      listeners.themeChange.forEach(function(cb) { cb(ctx.theme); });
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // OpenAI set_globals event
+    // ─────────────────────────────────────────────────────────────────────────
+    if (m.type === 'openai:set_globals') {
+      if (m.theme) ctx.theme = m.theme;
+      if (m.toolInput) toolInput = m.toolInput;
+      if (m.toolOutput) toolOutput = m.toolOutput;
+      if (m.widgetState) widgetState = m.widgetState;
+      applyThemeClass();
+      listeners.themeChange.forEach(function(cb) { cb(ctx.theme); });
+    }
+  });
+
+  // ══════════════════════════════════════════════════════════════════════════
+  // THEME APPLICATION
+  // ══════════════════════════════════════════════════════════════════════════
+
+  function applyThemeTokens() {
+    var root = document.documentElement;
+    for (var key in themeTokens) {
+      root.style.setProperty(key, themeTokens[key]);
+    }
+    // Set safe area inset CSS variables
+    var insets = ctx.safeAreaInsets || { top: 0, bottom: 0, left: 0, right: 0 };
+    root.style.setProperty('--safe-area-inset-top', insets.top + 'px');
+    root.style.setProperty('--safe-area-inset-bottom', insets.bottom + 'px');
+    root.style.setProperty('--safe-area-inset-left', insets.left + 'px');
+    root.style.setProperty('--safe-area-inset-right', insets.right + 'px');
+    applyThemeClass();
+  }
+
+  function applyThemeClass() {
+    document.documentElement.classList.remove('light', 'dark', 'light-theme');
+    document.documentElement.classList.add(ctx.theme);
+
+    // Define colors for each theme (must match design-system/tokens.ts)
+    var lightBg = '#ffffff';
+    var lightText = '#1a1a1a';
+    var darkBg = '#0d0d0d';
+    var darkText = '#e6e6e6';
+
+    if (ctx.theme === 'light') {
+      document.documentElement.classList.add('light-theme');
+      document.documentElement.style.colorScheme = 'light';
+      document.documentElement.style.backgroundColor = lightBg;
+      if (document.body) {
+        document.body.style.backgroundColor = lightBg;
+        document.body.style.color = lightText;
+      }
+    } else {
+      document.documentElement.style.colorScheme = 'dark';
+      document.documentElement.style.backgroundColor = darkBg;
+      if (document.body) {
+        document.body.style.backgroundColor = darkBg;
+        document.body.style.color = darkText;
+      }
+    }
+    document.documentElement.setAttribute('data-theme', ctx.theme);
+  }
+
+  // ══════════════════════════════════════════════════════════════════════════
+  // CALL TOOL HELPER
+  // ══════════════════════════════════════════════════════════════════════════
+
+  function callTool(name, args) {
+    var callId = generateCallId();
+    return new Promise(function(resolve, reject) {
+      pendingCalls[callId] = { resolve: resolve, reject: reject };
+
+      // MCP Apps standard: JSON-RPC tools/call
+      postToHost({
+        jsonrpc: '2.0',
+        id: callId,
+        method: 'tools/call',
+        params: { name: name, arguments: args || {} }
+      });
+
+      // Timeout after 30s
+      setTimeout(function() {
+        if (pendingCalls[callId]) {
+          delete pendingCalls[callId];
+          reject(new Error('Tool call timeout'));
+        }
+      }, 30000);
+    });
+  }
+
+  // ══════════════════════════════════════════════════════════════════════════
+  // 1. WINDOW.PHOTON - Photon Bridge API
+  // ══════════════════════════════════════════════════════════════════════════
+
+  window.photon = {
+    get toolInput() { return toolInput; },
+    get toolOutput() { return toolOutput; },
+    get widgetState() { return widgetState; },
+    setWidgetState: function(s) {
+      widgetState = s;
+      postToHost({ type: 'photon:set-state', state: s });
+    },
+
+    onProgress: function(cb) { return subscribe(listeners.progress, cb); },
+    onStatus: function(cb) { return subscribe(listeners.status, cb); },
+    onStream: function(cb) { return subscribe(listeners.stream, cb); },
+    onEmit: function(cb) { return subscribe(listeners.emit, cb); },
+    onResult: function(cb) { return subscribe(listeners.result, cb); },
+    onError: function(cb) { return subscribe(listeners.error, cb); },
+    onThemeChange: function(cb) { return subscribe(listeners.themeChange, cb); },
+    onToolInputPartial: function(cb) { return subscribe(listeners.toolInputPartial, cb); },
+    onToolInput: function(cb) { return subscribe(listeners.toolInput, cb); },
+    onElicitation: function(h) { elicitationHandler = h; return function() { elicitationHandler = null; }; },
+    onTeardown: function(h) { teardownHandler = h; return function() { teardownHandler = null; }; },
+
+    updateModelContext: function(opts) {
+      var callId = generateCallId();
+      return new Promise(function(resolve, reject) {
+        pendingCalls[callId] = { resolve: resolve, reject: reject };
+        postToHost({
+          jsonrpc: '2.0',
+          id: callId,
+          method: 'ui/update-model-context',
+          params: { content: opts.content, structuredContent: opts.structuredContent }
+        });
+        setTimeout(function() {
+          if (pendingCalls[callId]) {
+            delete pendingCalls[callId];
+            reject(new Error('Model context update timeout'));
+          }
+        }, 10000);
+      });
+    },
+
+    get safeAreaInsets() {
+      return ctx.safeAreaInsets || { top: 0, bottom: 0, left: 0, right: 0 };
+    },
+
+    callTool: callTool,
+    invoke: callTool, // Alias for callTool - used by custom UI templates
+    sendFollowUpMessage: function(msg) {
+      postToHost({ type: 'photon:follow-up', message: msg });
+    },
+
+    get theme() { return ctx.theme; },
+    get locale() { return ctx.locale; },
+    get photon() { return ctx.photon; },
+    get method() { return ctx.method; },
+    get isChatGPT() { return typeof window.openai !== 'undefined'; }
+  };
+
+  // ══════════════════════════════════════════════════════════════════════════
+  // 2. WINDOW.OPENAI - ChatGPT Apps SDK Compatibility
+  // ══════════════════════════════════════════════════════════════════════════
+
+  window.openai = {
+    // Context properties (reactive via openai:set_globals)
+    get theme() { return ctx.theme; },
+    get displayMode() { return ctx.displayMode === 'fullscreen' ? 'fullscreen' : 'inline'; },
+    get locale() { return ctx.locale; },
+    get maxHeight() { return 600; },
+    get toolInput() { return toolInput; },
+    get toolOutput() { return toolOutput; },
+    get widgetState() { return widgetState; },
+    get toolResponseMetadata() { return {}; },
+
+    // Methods
+    setWidgetState: function(state) {
+      widgetState = state;
+      postToHost({ type: 'photon:set-state', state: state });
+    },
+
+    callTool: callTool,
+
+    sendFollowUpMessage: function(opts) {
+      postToHost({ type: 'photon:follow-up', message: opts.prompt });
+      return Promise.resolve();
+    },
+
+    uploadFile: function(file) {
+      var callId = generateCallId();
+      return new Promise(function(resolve, reject) {
+        pendingCalls[callId] = { resolve: resolve, reject: reject };
+
+        // Read file as base64
+        var reader = new FileReader();
+        reader.onload = function() {
+          var base64 = reader.result;
+          postToHost({
+            type: 'photon:upload-file',
+            callId: callId,
+            fileName: file.name,
+            fileType: file.type,
+            fileSize: file.size,
+            data: base64
+          });
+        };
+        reader.onerror = function() {
+          delete pendingCalls[callId];
+          reject(new Error('Failed to read file'));
+        };
+        reader.readAsDataURL(file);
+
+        // Timeout after 60s
+        setTimeout(function() {
+          if (pendingCalls[callId]) {
+            delete pendingCalls[callId];
+            reject(new Error('File upload timeout'));
+          }
+        }, 60000);
+      });
+    },
+
+    getFileDownloadUrl: function(opts) {
+      var callId = generateCallId();
+      return new Promise(function(resolve, reject) {
+        pendingCalls[callId] = { resolve: resolve, reject: reject };
+
+        postToHost({
+          type: 'photon:get-file-url',
+          callId: callId,
+          fileId: opts.fileId
+        });
+
+        // Timeout after 30s
+        setTimeout(function() {
+          if (pendingCalls[callId]) {
+            delete pendingCalls[callId];
+            reject(new Error('Get file URL timeout'));
+          }
+        }, 30000);
+      });
+    },
+
+    requestDisplayMode: function(mode) {
+      postToHost({ type: 'photon:request-display-mode', mode: mode });
+      return Promise.resolve();
+    },
+
+    requestModal: function(opts) {
+      var callId = generateCallId();
+      return new Promise(function(resolve, reject) {
+        pendingCalls[callId] = { resolve: resolve, reject: reject };
+
+        postToHost({
+          type: 'photon:request-modal',
+          callId: callId,
+          template: opts.template,
+          params: opts.params
+        });
+
+        // Timeout after 5 minutes (modals may take user input)
+        setTimeout(function() {
+          if (pendingCalls[callId]) {
+            delete pendingCalls[callId];
+            reject(new Error('Modal request timeout'));
+          }
+        }, 300000);
+      });
+    },
+
+    notifyIntrinsicHeight: function(height) {
+      postToHost({ type: 'photon:notify-height', height: height });
+    },
+
+    openExternal: function(opts) {
+      window.open(opts.href, '_blank', 'noopener,noreferrer');
+    },
+
+    setOpenInAppUrl: function(opts) {
+      postToHost({ type: 'photon:set-open-in-app-url', href: opts.href });
+    }
+  };
+
+  // ══════════════════════════════════════════════════════════════════════════
+  // 3. WINDOW.MCP - Generic MCP Bridge (superset)
+  // ══════════════════════════════════════════════════════════════════════════
+
+  window.mcp = {
+    // Inherits from photon
+    ...window.photon,
+
+    // Additional MCP-specific context
+    get hostName() { return ctx.hostName; },
+    get hostVersion() { return ctx.hostVersion; },
+
+    // MCP Apps Extension methods
+    requestToolCall: callTool,
+
+    // Read a resource
+    readResource: function(uri) {
+      return callTool('resources/read', { uri: uri });
+    }
+  };
+
+  // ══════════════════════════════════════════════════════════════════════════
+  // 4. OPENAI GLOBAL HOOK - useOpenAiGlobal compatibility
+  // ══════════════════════════════════════════════════════════════════════════
+
+  // Dispatch custom event for useOpenAiGlobal hook subscribers
+  function dispatchGlobalsEvent() {
+    window.dispatchEvent(new CustomEvent('openai:set_globals', {
+      detail: {
+        theme: ctx.theme,
+        displayMode: ctx.displayMode,
+        locale: ctx.locale,
+        toolInput: toolInput,
+        toolOutput: toolOutput,
+        widgetState: widgetState
+      }
+    }));
+  }
+
+  // ══════════════════════════════════════════════════════════════════════════
+  // INITIALIZATION
+  // ══════════════════════════════════════════════════════════════════════════
+
+  // Apply initial theme
+  applyThemeTokens();
+
+  // Notify host that bridge is ready
+  postToHost({ type: 'photon:ready' });
+
+  // Request persisted state from host
+  postToHost({ type: 'photon:get-state' });
+
+  // Also send MCP Apps ready (JSON-RPC style)
+  postToHost({
+    jsonrpc: '2.0',
+    method: 'ui/ready',
+    params: {}
+  });
+
+})();
+</script>`;
+}
+// ════════════════════════════════════════════════════════════════════════════════
+// HOST-SIDE HELPERS
+// ════════════════════════════════════════════════════════════════════════════════
+//# sourceMappingURL=platform-compat.js.map

package/dist/auto-ui/platform-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-compat.js","sourceRoot":"","sources":["../../src/auto-ui/platform-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAkB,MAAM,2BAA2B,CAAC;AAG3E,0DAA0D;AAC1D,OAAO,EAQL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AA0C7B,mFAAmF;AACnF,mCAAmC;AACnC,mFAAmF;AAEnF;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAwB;IACnE,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE5C,OAAO;;;;;;;;;cASK,WAAW;sBACH,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAkhB3B,CAAC;AACX,CAAC;AAED,mFAAmF;AACnF,oBAAoB;AACpB,mFAAmF"}