@portel/photon 1.5.1 → 1.6.1

package/dist/auto-ui/bridge/openai-shim.js

@@ -0,0 +1,231 @@
+/**
+ * Generate the OpenAI shim code as inline JavaScript
+ *
+ * This gets injected into the iframe along with the PhotonApp.
+ * It creates a window.openai object that delegates to window.photon.
+ */
+export function generateOpenAIShimCode() {
+    return `
+// OpenAI Apps SDK Shim - delegates to window.photon
+(function() {
+  'use strict';
+
+  var widgetState = {};
+  var pendingCalls = {};
+  var callIdCounter = 0;
+
+  function generateCallId() {
+    return 'openai_' + (++callIdCounter) + '_' + Math.random().toString(36).slice(2);
+  }
+
+  function postToHost(msg) {
+    window.parent.postMessage(msg, '*');
+  }
+
+  window.openai = {
+    // Context properties - delegate to photon
+    get theme() { return window.photon ? window.photon.theme : 'dark'; },
+    get displayMode() { return 'inline'; },
+    get locale() { return window.photon ? window.photon.locale : 'en-US'; },
+    get maxHeight() { return 800; },
+    get toolInput() { return window.photon ? window.photon.toolInput : {}; },
+    get toolOutput() { return window.photon ? window.photon.toolOutput : null; },
+    get widgetState() { return widgetState; },
+    get toolResponseMetadata() { return {}; },
+
+    // Methods
+    setWidgetState: function(state) {
+      widgetState = state;
+      if (window.photon) window.photon.setWidgetState(state);
+    },
+
+    callTool: function(name, args) {
+      if (window.photon) return window.photon.invoke(name, args);
+      return Promise.reject(new Error('Photon not initialized'));
+    },
+
+    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 };
+
+        var reader = new FileReader();
+        reader.onload = function() {
+          postToHost({
+            type: 'photon:upload-file',
+            callId: callId,
+            fileName: file.name,
+            fileType: file.type,
+            fileSize: file.size,
+            data: reader.result
+          });
+        };
+        reader.onerror = function() {
+          delete pendingCalls[callId];
+          reject(new Error('Failed to read file'));
+        };
+        reader.readAsDataURL(file);
+
+        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
+        });
+        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
+        });
+        setTimeout(function() {
+          if (pendingCalls[callId]) {
+            delete pendingCalls[callId];
+            reject(new Error('Modal request timeout'));
+          }
+        }, 300000);
+      });
+    },
+
+    notifyIntrinsicHeight: function(height) {
+      // Use MCP Apps size notification
+      window.parent.postMessage({
+        jsonrpc: '2.0',
+        method: 'ui/notifications/size-changed',
+        params: { 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 });
+    }
+  };
+
+  // Handle responses from host
+  window.addEventListener('message', function(e) {
+    var m = e.data;
+    if (!m || typeof m !== 'object') return;
+
+    if (m.type === 'photon:upload-file-response' && pendingCalls[m.callId]) {
+      var p = pendingCalls[m.callId];
+      delete pendingCalls[m.callId];
+      if (m.error) p.reject(new Error(m.error));
+      else p.resolve({ fileId: m.fileId });
+    }
+    if (m.type === 'photon:get-file-url-response' && pendingCalls[m.callId]) {
+      var p = pendingCalls[m.callId];
+      delete pendingCalls[m.callId];
+      if (m.error) p.reject(new Error(m.error));
+      else p.resolve(m.url);
+    }
+    if (m.type === 'photon:request-modal-response' && pendingCalls[m.callId]) {
+      var p = pendingCalls[m.callId];
+      delete pendingCalls[m.callId];
+      if (m.error) p.reject(new Error(m.error));
+      else p.resolve(m.result);
+    }
+  });
+})();
+`;
+}
+/**
+ * Create OpenAI shim wrapper (for use with PhotonApp in browser)
+ */
+export function createOpenAIShim(photonApp) {
+    let widgetState = {};
+    return {
+        get theme() {
+            return photonApp.theme;
+        },
+        get displayMode() {
+            return 'inline';
+        },
+        get locale() {
+            return photonApp.locale;
+        },
+        get maxHeight() {
+            return 800;
+        },
+        get toolInput() {
+            return photonApp.toolInput;
+        },
+        get toolOutput() {
+            return photonApp.toolOutput;
+        },
+        get widgetState() {
+            return widgetState;
+        },
+        setWidgetState(state) {
+            widgetState = state;
+            photonApp.setWidgetState(state);
+        },
+        callTool(name, args) {
+            return photonApp.invoke(name, args);
+        },
+        sendFollowUpMessage(_options) {
+            // Not supported in Photon
+            return Promise.resolve();
+        },
+        uploadFile(_file) {
+            return Promise.reject(new Error('File upload not supported'));
+        },
+        getFileDownloadUrl(_options) {
+            return Promise.reject(new Error('File download not supported'));
+        },
+        requestDisplayMode(_mode) {
+            return Promise.resolve();
+        },
+        requestModal(_options) {
+            return Promise.reject(new Error('Modal not supported'));
+        },
+        notifyIntrinsicHeight(height) {
+            photonApp.sendSizeChanged({ height });
+        },
+        openExternal(options) {
+            window.open(options.href, '_blank', 'noopener,noreferrer');
+        },
+        setOpenInAppUrl(_options) {
+            // Not supported
+        },
+    };
+}
+//# sourceMappingURL=openai-shim.js.map

package/dist/auto-ui/bridge/openai-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-shim.js","sourceRoot":"","sources":["../../../src/auto-ui/bridge/openai-shim.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgKR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAoB;IACnD,IAAI,WAAW,GAAY,EAAE,CAAC;IAE9B,OAAO;QACL,IAAI,KAAK;YACP,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QACD,IAAI,WAAW;YACb,OAAO,QAAiB,CAAC;QAC3B,CAAC;QACD,IAAI,MAAM;YACR,OAAO,SAAS,CAAC,MAAM,CAAC;QAC1B,CAAC;QACD,IAAI,SAAS;YACX,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,SAAS;YACX,OAAO,SAAS,CAAC,SAAS,CAAC;QAC7B,CAAC;QACD,IAAI,UAAU;YACZ,OAAO,SAAS,CAAC,UAAU,CAAC;QAC9B,CAAC;QACD,IAAI,WAAW;YACb,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,cAAc,CAAC,KAAc;YAC3B,WAAW,GAAG,KAAK,CAAC;YACpB,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,QAAQ,CAAC,IAAY,EAAE,IAA6B;YAClD,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,mBAAmB,CAAC,QAA4B;YAC9C,0BAA0B;YAC1B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,UAAU,CAAC,KAAW;YACpB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,kBAAkB,CAAC,QAA4B;YAC7C,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,kBAAkB,CAAC,KAAsC;YACvD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,YAAY,CAAC,QAA+C;YAC1D,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,qBAAqB,CAAC,MAAc;YAClC,SAAS,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,YAAY,CAAC,OAAyB;YACpC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QAC7D,CAAC;QAED,eAAe,CAAC,QAA0B;YACxC,gBAAgB;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/auto-ui/bridge/photon-app.d.ts

@@ -0,0 +1,162 @@
+/**
+ * PhotonApp - View-side bridge using MCP Apps Extension SDK
+ *
+ * Extends the standard App class from @modelcontextprotocol/ext-apps
+ * to provide the window.photon API for photon UIs.
+ *
+ * Usage in UI templates:
+ * ```javascript
+ * const app = new PhotonApp('kanban');
+ * await app.connect();
+ *
+ * app.onResult((data) => renderBoard(data));
+ * const boards = await app.invoke('boards');
+ * ```
+ */
+import type { ProgressNotification, StatusNotification, StreamNotification, EmitNotification, SizeConstraints } from './types.js';
+type Listener<T> = (data: T) => void;
+/**
+ * PhotonApp class for UI templates
+ *
+ * This runs in the browser iframe and communicates with the host
+ * using the MCP Apps Extension protocol.
+ */
+export declare class PhotonApp {
+    private _name;
+    private _toolOutput;
+    private _toolInput;
+    private _widgetState;
+    private _theme;
+    private _locale;
+    private _hostContext;
+    private _pendingCalls;
+    private _callIdCounter;
+    private _resultListeners;
+    private _themeListeners;
+    private _progressListeners;
+    private _statusListeners;
+    private _streamListeners;
+    private _emitListeners;
+    constructor(name: string);
+    /**
+     * Set up message handler for communication with host
+     */
+    private _setupMessageHandler;
+    /**
+     * Handle JSON-RPC 2.0 messages (MCP Apps protocol)
+     */
+    private _handleJsonRpcMessage;
+    /**
+     * Handle legacy photon: messages for backward compatibility
+     */
+    private _handleLegacyMessage;
+    /**
+     * Handle ui/initialize message
+     */
+    private _handleInitialize;
+    /**
+     * Handle host context changes (theme, etc.)
+     */
+    private _handleHostContextChanged;
+    /**
+     * Apply theme class to document
+     */
+    private _applyTheme;
+    /**
+     * Apply theme CSS variables
+     */
+    private _applyThemeTokens;
+    /**
+     * Post message to host
+     */
+    private _postToHost;
+    /**
+     * Generate unique call ID
+     */
+    private _generateCallId;
+    /**
+     * Extract data from MCP result format
+     */
+    private _extractData;
+    /**
+     * Connect to host and perform MCP Apps handshake
+     */
+    connect(): Promise<void>;
+    /**
+     * Current tool output data
+     */
+    get toolOutput(): any;
+    /**
+     * Current tool input
+     */
+    get toolInput(): Record<string, unknown>;
+    /**
+     * Widget state
+     */
+    get widgetState(): unknown;
+    /**
+     * Set widget state
+     */
+    setWidgetState(state: unknown): void;
+    /**
+     * Current theme
+     */
+    get theme(): 'light' | 'dark';
+    /**
+     * Current locale
+     */
+    get locale(): string;
+    /**
+     * Host context from initialization
+     */
+    get hostContext(): any;
+    /**
+     * Register result handler
+     */
+    onResult(cb: Listener<any>): () => void;
+    /**
+     * Register theme change handler
+     */
+    onThemeChange(cb: Listener<'light' | 'dark'>): () => void;
+    /**
+     * Register progress notification handler
+     */
+    onProgress(cb: Listener<ProgressNotification>): () => void;
+    /**
+     * Register status notification handler
+     */
+    onStatus(cb: Listener<StatusNotification>): () => void;
+    /**
+     * Register stream notification handler
+     */
+    onStream(cb: Listener<StreamNotification>): () => void;
+    /**
+     * Register emit notification handler
+     */
+    onEmit(cb: Listener<EmitNotification>): () => void;
+    /**
+     * Call a tool on the server
+     */
+    invoke(name: string, args?: Record<string, unknown>): Promise<any>;
+    /**
+     * Alias for invoke (compatibility)
+     */
+    callTool(name: string, args?: Record<string, unknown>): Promise<any>;
+    /**
+     * Send size change notification to host
+     */
+    sendSizeChanged(size: {
+        width?: number;
+        height?: number;
+    }): void;
+    /**
+     * Parse size constraints from meta tag
+     */
+    static parseSizeMeta(): SizeConstraints;
+    /**
+     * Set up automatic size reporting with ResizeObserver
+     */
+    setupAutoResize(target?: HTMLElement): () => void;
+}
+export {};
+//# sourceMappingURL=photon-app.d.ts.map

package/dist/auto-ui/bridge/photon-app.d.ts.map

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