@portel/photon 1.18.0 → 1.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portel/photon",
-  "version": "1.18.0",
+  "version": "1.20.0",
   "description": "You focus on the business logic. We'll enable the rest. Build MCP servers and CLI tools in a single TypeScript file.",
   "type": "module",
   "main": "dist/index.js",
@@ -68,7 +68,7 @@
     "test:client-adaptive": "npx tsx tests/client-adaptive.test.ts",
     "test:load": "npm run build && node --expose-gc --max-old-space-size=4096 node_modules/.bin/tsx tests/load-test.ts",
     "test:sqlite": "npm run build && npx tsx tests/sqlite.test.ts",
-    "test:github": "npm run build && npx tsx tests/github-issues.test.ts",
+    "test:github": "npm run build && npx tsx tests/github-issues.integration.ts",
     "test:beam": "npm run build && npx tsx tests/beam/rendering.test.ts",
     "test:beam:regressions": "npm run build && npx tsx tests/beam/beam-integration-regressions.test.ts",
     "test:e2e": "npm run build && npx playwright test",
@@ -112,7 +112,7 @@
     "@modelcontextprotocol/ext-apps": "^1.0.1",
     "@modelcontextprotocol/sdk": "^1.25.2",
     "@portel/cli": "^1.1.0",
-    "@portel/photon-core": "^2.17.6",
+    "@portel/photon-core": "^2.18.0",
     "boxen": "^8.0.1",
     "chalk": "^5.4.1",
     "chart.js": "^4.5.1",

package/dist/auto-ui/bridge/openai-shim.d.ts

@@ -1,20 +0,0 @@
-/**
- * OpenAI Apps SDK Compatibility Shim
- *
- * Provides window.openai API that translates to MCP Apps protocol.
- * This allows apps built for ChatGPT to work in Photon hosts.
- */
-import type { PhotonApp } from './photon-app.js';
-import type { OpenAIAPI } from './types.js';
-/**
- * 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 declare function generateOpenAIShimCode(): string;
-/**
- * Create OpenAI shim wrapper (for use with PhotonApp in browser)
- */
-export declare function createOpenAIShim(photonApp: PhotonApp): OpenAIAPI;
-//# sourceMappingURL=openai-shim.d.ts.map

package/dist/auto-ui/bridge/openai-shim.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai-shim.d.ts","sourceRoot":"","sources":["../../../src/auto-ui/bridge/openai-shim.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAkK/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAoEhE"}

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

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

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

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

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