mcp-ui-ext-apps-openai 1.0.0

package/dist/index.js

@@ -0,0 +1,292 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  createMCPAdapter: () => createMCPAdapter,
+  createOpenAIAdapter: () => createOpenAIAdapter,
+  createUnifiedApp: () => createUnifiedApp,
+  detectPlatform: () => detectPlatform,
+  isMCP: () => isMCP,
+  isOpenAI: () => isOpenAI
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/unified-app.ts
+function detectPlatform() {
+  if (typeof window !== "undefined" && window.openai) {
+    return "openai";
+  }
+  return "unknown";
+}
+function isOpenAI() {
+  return detectPlatform() === "openai";
+}
+function isMCP() {
+  return detectPlatform() === "mcp" || detectPlatform() === "unknown";
+}
+function createOpenAIAdapter(options) {
+  const openai = window.openai;
+  const handleGlobalsChange = (_event) => {
+    if (options.onHostContextChanged) {
+      options.onHostContextChanged({
+        theme: openai.theme,
+        displayMode: openai.displayMode,
+        locale: openai.locale,
+        safeAreaInsets: openai.safeArea?.insets,
+        maxWidth: openai.maxWidth,
+        maxHeight: openai.maxHeight
+      });
+    }
+  };
+  window.addEventListener("openai:set_globals", handleGlobalsChange);
+  if (options.onHostContextChanged) {
+    options.onHostContextChanged({
+      theme: openai.theme,
+      displayMode: openai.displayMode,
+      locale: openai.locale,
+      safeAreaInsets: openai.safeArea?.insets,
+      maxWidth: openai.maxWidth,
+      maxHeight: openai.maxHeight
+    });
+  }
+  if (options.onToolResult && openai.toolOutput) {
+    const result = convertOpenAIToolOutput(openai.toolOutput);
+    options.onToolResult(result);
+  }
+  if (options.onToolInput && openai.toolInput) {
+    options.onToolInput(openai.toolInput);
+  }
+  return {
+    platform: "openai",
+    callServerTool: async ({ name, arguments: args }) => {
+      try {
+        const result = await openai.callTool(name, args);
+        return convertOpenAIToolOutput(result);
+      } catch (error) {
+        if (options.onError) {
+          options.onError(error);
+        }
+        throw error;
+      }
+    },
+    sendMessage: async (message, _opts) => {
+      try {
+        const textContent = message.content.find((c) => c.type === "text");
+        if (textContent?.text) {
+          await openai.sendFollowUpMessage({ prompt: textContent.text });
+        }
+        return { isError: false };
+      } catch (error) {
+        if (options.onError) {
+          options.onError(error);
+        }
+        return { isError: true };
+      }
+    },
+    sendLog: async ({ level, data }) => {
+      const consoleLevel = level === "warning" ? "warn" : level;
+      console[consoleLevel](`[${options.appInfo.name}]`, data);
+    },
+    openLink: async ({ url }) => {
+      try {
+        await openai.openExternal({ href: url });
+        return { isError: false };
+      } catch (error) {
+        if (options.onError) {
+          options.onError(error);
+        }
+        return { isError: true };
+      }
+    },
+    getHostContext: () => ({
+      theme: openai.theme,
+      displayMode: openai.displayMode,
+      locale: openai.locale,
+      safeAreaInsets: openai.safeArea?.insets,
+      maxWidth: openai.maxWidth,
+      maxHeight: openai.maxHeight
+    }),
+    getToolInput: () => openai.toolInput || {},
+    getToolOutput: () => openai.toolOutput,
+    getToolResponseMetadata: () => openai.toolResponseMetadata || {},
+    getWidgetState: () => openai.widgetState,
+    getWidgetProps: () => openai.widget?.props || {},
+    setWidgetState: (state) => {
+      openai.setWidgetState(state);
+    },
+    updateWidgetState: (state) => {
+      openai.updateWidgetState(state);
+    },
+    requestDisplayMode: async (mode) => {
+      await openai.requestDisplayMode(mode);
+    },
+    requestClose: () => {
+      openai.requestClose();
+    },
+    notifyIntrinsicHeight: (height) => {
+      openai.notifyIntrinsicHeight(height);
+    },
+    uploadFile: async (file) => {
+      return await openai.uploadFile(file);
+    },
+    getFileDownloadUrl: async ({ fileId }) => {
+      return await openai.getFileDownloadUrl({ fileId });
+    },
+    setOpenInAppUrl: ({ href }) => {
+      openai.setOpenInAppUrl({ href });
+    },
+    share: async (params) => {
+      await openai.share(params);
+    },
+    callCompletion: async (params) => {
+      return await openai.callCompletion(params);
+    },
+    streamCompletion: (params) => {
+      return openai.streamCompletion(params);
+    },
+    _raw: openai
+  };
+}
+function convertOpenAIToolOutput(output) {
+  if (typeof output === "string") {
+    return {
+      content: [{ type: "text", text: output }]
+    };
+  }
+  if (output && typeof output === "object") {
+    if ("content" in output && Array.isArray(output.content)) {
+      return output;
+    }
+    if ("text" in output) {
+      return {
+        content: [{ type: "text", text: String(output.text) }]
+      };
+    }
+    return {
+      content: [{ type: "text", text: JSON.stringify(output) }]
+    };
+  }
+  return {
+    content: [{ type: "text", text: String(output) }]
+  };
+}
+function createMCPAdapter(app, _options) {
+  return {
+    platform: "mcp",
+    callServerTool: async ({ name, arguments: args }) => {
+      const result = await app.callServerTool({ name, arguments: args });
+      return result;
+    },
+    sendMessage: async (message, opts) => {
+      const result = await app.sendMessage(message, opts);
+      return { isError: result.isError ?? false };
+    },
+    sendLog: async ({ level, data }) => {
+      await app.sendLog({ level, data });
+    },
+    openLink: async ({ url }) => {
+      const result = await app.openLink({ url });
+      return { isError: result.isError ?? false };
+    },
+    getHostContext: () => {
+      const ctx = app.getHostContext();
+      return {
+        theme: ctx?.theme,
+        displayMode: ctx?.displayMode,
+        locale: ctx?.locale,
+        safeAreaInsets: ctx?.safeAreaInsets
+      };
+    },
+    getToolInput: () => ({}),
+    // MCP handles this via ontoolinput callback
+    getToolOutput: () => null,
+    // MCP handles this via ontoolresult callback
+    // OpenAI-specific methods - no-op or stub implementations for MCP
+    getToolResponseMetadata: () => ({}),
+    getWidgetState: () => null,
+    getWidgetProps: () => ({}),
+    setWidgetState: (_state) => {
+    },
+    updateWidgetState: (_state) => {
+    },
+    requestDisplayMode: async (_mode) => {
+    },
+    requestClose: () => {
+    },
+    notifyIntrinsicHeight: (_height) => {
+    },
+    uploadFile: async (_file) => {
+      throw new Error("uploadFile is not supported on MCP platform");
+    },
+    getFileDownloadUrl: async (_params) => {
+      throw new Error("getFileDownloadUrl is not supported on MCP platform");
+    },
+    setOpenInAppUrl: (_params) => {
+    },
+    share: async (_params) => {
+      throw new Error("share is not supported on MCP platform");
+    },
+    callCompletion: async (_params) => {
+      throw new Error("callCompletion is not supported on MCP platform");
+    },
+    streamCompletion: (_params) => {
+      throw new Error("streamCompletion is not supported on MCP platform");
+    },
+    _raw: app
+  };
+}
+function createUnifiedApp(options) {
+  const platform = detectPlatform();
+  if (platform === "openai") {
+    try {
+      const app = createOpenAIAdapter(options);
+      return {
+        app,
+        isConnected: true,
+        error: null,
+        platform: "openai"
+      };
+    } catch (error) {
+      return {
+        app: null,
+        isConnected: false,
+        error,
+        platform: "openai"
+      };
+    }
+  }
+  return {
+    app: null,
+    isConnected: false,
+    error: null,
+    platform: "unknown"
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createMCPAdapter,
+  createOpenAIAdapter,
+  createUnifiedApp,
+  detectPlatform,
+  isMCP,
+  isOpenAI
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/unified-app.ts"],"sourcesContent":["/**\n * @file mcp-ui-ext-apps-openai - Unified utility for OpenAI ChatGPT and MCP Apps\n *\n * This package provides a unified interface for building apps that work on both\n * OpenAI's ChatGPT platform and MCP Apps hosts.\n *\n * @example\n * ```ts\n * // Core utilities (no React dependency)\n * import { detectPlatform, isOpenAI, isMCP, createUnifiedApp } from \"mcp-ui-ext-apps-openai\";\n *\n * // Check platform\n * if (isOpenAI()) {\n *   console.log(\"Running on OpenAI ChatGPT\");\n * }\n *\n * // Create unified app (for non-React usage)\n * const { app, isConnected, platform } = createUnifiedApp({\n *   appInfo: { name: \"My App\", version: \"1.0.0\" },\n * });\n * ```\n */\n\n// Core types and utilities\nexport {\n  type Platform,\n  type UnifiedApp,\n  type UnifiedAppOptions,\n  type UnifiedHostContext,\n  type UnifiedMessage,\n  type UnifiedToolResult,\n  type OpenAIGlobal,\n  type OpenAIWidgetProps,\n  type CreateUnifiedAppResult,\n  detectPlatform,\n  isOpenAI,\n  isMCP,\n  createOpenAIAdapter,\n  createMCPAdapter,\n  createUnifiedApp,\n} from \"./unified-app\";\n","/**\n * @file Unified App Utility - Works with both OpenAI ChatGPT Apps and MCP Apps\n *\n * This utility provides a unified interface that abstracts away the differences\n * between OpenAI's window.openai API and MCP Apps SDK.\n */\n\nimport type { App, McpUiAppCapabilities } from \"@modelcontextprotocol/ext-apps\";\n\n// ============================================================================\n// Types & Interfaces\n// ============================================================================\n\nexport type Platform = \"openai\" | \"mcp\" | \"unknown\";\n\nexport interface UnifiedToolResult {\n  content: Array<{ type: string; text?: string; [key: string]: unknown }>;\n  structuredContent?: Record<string, unknown>;\n  isError?: boolean;\n}\n\nexport interface UnifiedMessage {\n  role: \"user\" | \"assistant\";\n  content: Array<{ type: string; text?: string; [key: string]: unknown }>;\n}\n\nexport interface UnifiedHostContext {\n  theme?: \"light\" | \"dark\";\n  displayMode?: \"inline\" | \"pip\" | \"fullscreen\";\n  locale?: string;\n  safeAreaInsets?: {\n    top?: number;\n    right?: number;\n    bottom?: number;\n    left?: number;\n  };\n  maxWidth?: number;\n  maxHeight?: number;\n}\n\nexport interface UnifiedAppOptions {\n  appInfo: { name: string; version: string };\n  capabilities?: McpUiAppCapabilities;\n  onToolInput?: (input: unknown) => void | Promise<void>;\n  onToolResult?: (result: UnifiedToolResult) => void | Promise<void>;\n  onHostContextChanged?: (context: UnifiedHostContext) => void;\n  onTeardown?: () => void | Promise<void>;\n  onError?: (error: Error) => void;\n}\n\nexport interface UnifiedApp {\n  /** The underlying platform */\n  platform: Platform;\n\n  /** Call a server tool by name with arguments */\n  callServerTool: (params: { name: string; arguments: Record<string, unknown> }) => Promise<UnifiedToolResult>;\n\n  /** Send a message to the host/conversation */\n  sendMessage: (message: UnifiedMessage, options?: { signal?: AbortSignal }) => Promise<{ isError: boolean }>;\n\n  /** Send a log message to the host */\n  sendLog: (params: { level: \"info\" | \"warning\" | \"error\" | \"debug\"; data: string }) => Promise<void>;\n\n  /** Open an external link */\n  openLink: (params: { url: string }) => Promise<{ isError: boolean }>;\n\n  /** Get the current host context */\n  getHostContext: () => UnifiedHostContext;\n\n  /** Get tool input (initial arguments passed to the tool) */\n  getToolInput: () => Record<string, unknown>;\n\n  /** Get tool output (result from server) */\n  getToolOutput: () => unknown;\n\n  /** Get tool response metadata (OpenAI only, returns {} on MCP) */\n  getToolResponseMetadata: () => Record<string, unknown>;\n\n  /** Get widget state (OpenAI only, returns null on MCP) */\n  getWidgetState: <T = unknown>() => T | null;\n\n  /** Get widget props (OpenAI only, returns {} on MCP) */\n  getWidgetProps: <T = Record<string, unknown>>() => T;\n\n  /** Set widget state - persists across renders (OpenAI only, no-op on MCP) */\n  setWidgetState: <T = unknown>(state: T) => void;\n\n  /** Update widget state - partial update (OpenAI only, no-op on MCP) */\n  updateWidgetState: <T = unknown>(state: Partial<T>) => void;\n\n  /** Request a specific display mode (OpenAI only, no-op on MCP) */\n  requestDisplayMode: (mode: \"inline\" | \"pip\" | \"fullscreen\") => Promise<void>;\n\n  /** Request to close the widget (OpenAI only, no-op on MCP) */\n  requestClose: () => void;\n\n  /** Notify intrinsic height for dynamic sizing (OpenAI only, no-op on MCP) */\n  notifyIntrinsicHeight: (height: number) => void;\n\n  /** Upload a file (OpenAI only, throws on MCP) */\n  uploadFile: (file: File) => Promise<{ fileId: string }>;\n\n  /** Get file download URL (OpenAI only, throws on MCP) */\n  getFileDownloadUrl: (params: { fileId: string }) => Promise<string>;\n\n  /** Set URL for \"Open in App\" button (OpenAI only, no-op on MCP) */\n  setOpenInAppUrl: (params: { href: string }) => void;\n\n  /** Share content (OpenAI only, throws on MCP) */\n  share: (params: unknown) => Promise<void>;\n\n  /** Call AI completion (OpenAI only, throws on MCP) */\n  callCompletion: (params: unknown) => Promise<unknown>;\n\n  /** Stream AI completion (OpenAI only, throws on MCP) */\n  streamCompletion: (params: unknown) => AsyncIterable<unknown>;\n\n  /** The raw underlying app instance */\n  _raw: App | OpenAIGlobal | null;\n}\n\n// OpenAI window.openai type definition based on documentation\nexport interface OpenAIGlobal {\n  callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;\n  sendFollowUpMessage: (params: { prompt: string }) => Promise<void>;\n  openExternal: (params: { href: string }) => Promise<void>;\n  setOpenInAppUrl: (params: { href: string }) => void;\n  requestDisplayMode: (mode: string) => Promise<void>;\n  requestModal: (params: unknown) => Promise<void>;\n  requestClose: () => void;\n  notifyIntrinsicHeight: (height: number) => void;\n  uploadFile: (file: File) => Promise<{ fileId: string }>;\n  getFileDownloadUrl: (params: { fileId: string }) => Promise<string>;\n  getFileMetadata: (params: { fileId: string }) => Promise<unknown>;\n  setWidgetState: (state: unknown) => void;\n  updateWidgetState: (state: unknown) => void;\n  share: (params: unknown) => Promise<void>;\n  streamCompletion: (params: unknown) => AsyncIterable<unknown>;\n  callCompletion: (params: unknown) => Promise<unknown>;\n\n  // Properties\n  toolInput: Record<string, unknown>;\n  toolOutput: unknown;\n  toolResponseMetadata: Record<string, unknown>;\n  widgetState: unknown;\n  theme: \"light\" | \"dark\";\n  displayMode: \"inline\" | \"pip\" | \"fullscreen\";\n  locale: string;\n  maxWidth?: number;\n  maxHeight?: number;\n  safeArea: { insets: { top: number; right: number; bottom: number; left: number } };\n  userAgent: { device: unknown; capabilities: unknown };\n  view: { params: unknown; mode: string };\n  widget: { state: unknown; props: unknown; setState: (state: unknown) => void };\n  subjectId: string;\n}\n\n/** Widget props from OpenAI (passed to widget via widget.props) */\nexport interface OpenAIWidgetProps {\n  [key: string]: unknown;\n}\n\ndeclare global {\n  interface Window {\n    openai?: OpenAIGlobal;\n  }\n}\n\n// ============================================================================\n// Platform Detection\n// ============================================================================\n\n/**\n * Detect which platform the app is running on\n */\nexport function detectPlatform(): Platform {\n  if (typeof window !== \"undefined\" && window.openai) {\n    return \"openai\";\n  }\n  // MCP apps are detected by the useApp hook connecting successfully\n  // For now, return \"unknown\" and let the hook determine\n  return \"unknown\";\n}\n\n/**\n * Check if running in OpenAI ChatGPT environment\n */\nexport function isOpenAI(): boolean {\n  return detectPlatform() === \"openai\";\n}\n\n/**\n * Check if running in MCP Apps environment\n */\nexport function isMCP(): boolean {\n  return detectPlatform() === \"mcp\" || detectPlatform() === \"unknown\";\n}\n\n// ============================================================================\n// OpenAI Adapter\n// ============================================================================\n\n/**\n * Create a UnifiedApp from OpenAI's window.openai\n */\nexport function createOpenAIAdapter(options: UnifiedAppOptions): UnifiedApp {\n  const openai = window.openai!;\n\n  // Set up event listeners for OpenAI\n  const handleGlobalsChange = (_event: Event) => {\n    if (options.onHostContextChanged) {\n      options.onHostContextChanged({\n        theme: openai.theme,\n        displayMode: openai.displayMode as UnifiedHostContext[\"displayMode\"],\n        locale: openai.locale,\n        safeAreaInsets: openai.safeArea?.insets,\n        maxWidth: openai.maxWidth,\n        maxHeight: openai.maxHeight,\n      });\n    }\n  };\n\n  window.addEventListener(\"openai:set_globals\", handleGlobalsChange);\n\n  // Initial context callback\n  if (options.onHostContextChanged) {\n    options.onHostContextChanged({\n      theme: openai.theme,\n      displayMode: openai.displayMode as UnifiedHostContext[\"displayMode\"],\n      locale: openai.locale,\n      safeAreaInsets: openai.safeArea?.insets,\n      maxWidth: openai.maxWidth,\n      maxHeight: openai.maxHeight,\n    });\n  }\n\n  // If there's initial tool output, notify\n  if (options.onToolResult && openai.toolOutput) {\n    const result = convertOpenAIToolOutput(openai.toolOutput);\n    options.onToolResult(result);\n  }\n\n  if (options.onToolInput && openai.toolInput) {\n    options.onToolInput(openai.toolInput);\n  }\n\n  return {\n    platform: \"openai\",\n\n    callServerTool: async ({ name, arguments: args }) => {\n      try {\n        const result = await openai.callTool(name, args);\n        return convertOpenAIToolOutput(result);\n      } catch (error) {\n        if (options.onError) {\n          options.onError(error as Error);\n        }\n        throw error;\n      }\n    },\n\n    sendMessage: async (message, _opts) => {\n      try {\n        // OpenAI uses sendFollowUpMessage for user messages\n        const textContent = message.content.find(c => c.type === \"text\");\n        if (textContent?.text) {\n          await openai.sendFollowUpMessage({ prompt: textContent.text });\n        }\n        return { isError: false };\n      } catch (error) {\n        if (options.onError) {\n          options.onError(error as Error);\n        }\n        return { isError: true };\n      }\n    },\n\n    sendLog: async ({ level, data }) => {\n      // OpenAI doesn't have a direct log API, use console as fallback\n      // Map 'warning' to 'warn' for console compatibility\n      const consoleLevel = level === \"warning\" ? \"warn\" : level;\n      console[consoleLevel](`[${options.appInfo.name}]`, data);\n    },\n\n    openLink: async ({ url }) => {\n      try {\n        await openai.openExternal({ href: url });\n        return { isError: false };\n      } catch (error) {\n        if (options.onError) {\n          options.onError(error as Error);\n        }\n        return { isError: true };\n      }\n    },\n\n    getHostContext: () => ({\n      theme: openai.theme,\n      displayMode: openai.displayMode as UnifiedHostContext[\"displayMode\"],\n      locale: openai.locale,\n      safeAreaInsets: openai.safeArea?.insets,\n      maxWidth: openai.maxWidth,\n      maxHeight: openai.maxHeight,\n    }),\n\n    getToolInput: () => openai.toolInput || {},\n\n    getToolOutput: () => openai.toolOutput,\n\n    getToolResponseMetadata: () => openai.toolResponseMetadata || {},\n\n    getWidgetState: <T = unknown>() => openai.widgetState as T | null,\n\n    getWidgetProps: <T = Record<string, unknown>>() => (openai.widget?.props || {}) as T,\n\n    setWidgetState: <T = unknown>(state: T) => {\n      openai.setWidgetState(state);\n    },\n\n    updateWidgetState: <T = unknown>(state: Partial<T>) => {\n      openai.updateWidgetState(state);\n    },\n\n    requestDisplayMode: async (mode) => {\n      await openai.requestDisplayMode(mode);\n    },\n\n    requestClose: () => {\n      openai.requestClose();\n    },\n\n    notifyIntrinsicHeight: (height) => {\n      openai.notifyIntrinsicHeight(height);\n    },\n\n    uploadFile: async (file) => {\n      return await openai.uploadFile(file);\n    },\n\n    getFileDownloadUrl: async ({ fileId }) => {\n      return await openai.getFileDownloadUrl({ fileId });\n    },\n\n    setOpenInAppUrl: ({ href }) => {\n      openai.setOpenInAppUrl({ href });\n    },\n\n    share: async (params) => {\n      await openai.share(params);\n    },\n\n    callCompletion: async (params) => {\n      return await openai.callCompletion(params);\n    },\n\n    streamCompletion: (params) => {\n      return openai.streamCompletion(params);\n    },\n\n    _raw: openai,\n  };\n}\n\n/**\n * Convert OpenAI tool output to unified format\n */\nfunction convertOpenAIToolOutput(output: unknown): UnifiedToolResult {\n  // OpenAI tool output can be various formats\n  if (typeof output === \"string\") {\n    return {\n      content: [{ type: \"text\", text: output }],\n    };\n  }\n\n  if (output && typeof output === \"object\") {\n    // Check if it's already in MCP-like format\n    if (\"content\" in output && Array.isArray((output as { content: unknown }).content)) {\n      return output as UnifiedToolResult;\n    }\n\n    // Check for text property\n    if (\"text\" in output) {\n      return {\n        content: [{ type: \"text\", text: String((output as { text: unknown }).text) }],\n      };\n    }\n\n    // Serialize object as JSON text\n    return {\n      content: [{ type: \"text\", text: JSON.stringify(output) }],\n    };\n  }\n\n  return {\n    content: [{ type: \"text\", text: String(output) }],\n  };\n}\n\n// ============================================================================\n// MCP Adapter\n// ============================================================================\n\n/**\n * Create a UnifiedApp from MCP App instance\n */\nexport function createMCPAdapter(app: App, _options: UnifiedAppOptions): UnifiedApp {\n  return {\n    platform: \"mcp\",\n\n    callServerTool: async ({ name, arguments: args }) => {\n      const result = await app.callServerTool({ name, arguments: args });\n      return result as UnifiedToolResult;\n    },\n\n    sendMessage: async (message, opts) => {\n      const result = await app.sendMessage(message as Parameters<typeof app.sendMessage>[0], opts);\n      return { isError: result.isError ?? false };\n    },\n\n    sendLog: async ({ level, data }) => {\n      await app.sendLog({ level, data });\n    },\n\n    openLink: async ({ url }) => {\n      const result = await app.openLink({ url });\n      return { isError: result.isError ?? false };\n    },\n\n    getHostContext: () => {\n      const ctx = app.getHostContext();\n      return {\n        theme: ctx?.theme as UnifiedHostContext[\"theme\"],\n        displayMode: ctx?.displayMode as UnifiedHostContext[\"displayMode\"],\n        locale: ctx?.locale,\n        safeAreaInsets: ctx?.safeAreaInsets,\n      };\n    },\n\n    getToolInput: () => ({}), // MCP handles this via ontoolinput callback\n\n    getToolOutput: () => null, // MCP handles this via ontoolresult callback\n\n    // OpenAI-specific methods - no-op or stub implementations for MCP\n    getToolResponseMetadata: () => ({}),\n\n    getWidgetState: <T = unknown>() => null as T | null,\n\n    getWidgetProps: <T = Record<string, unknown>>() => ({} as T),\n\n    setWidgetState: <T = unknown>(_state: T) => {\n      // No-op on MCP\n    },\n\n    updateWidgetState: <T = unknown>(_state: Partial<T>) => {\n      // No-op on MCP\n    },\n\n    requestDisplayMode: async (_mode) => {\n      // No-op on MCP\n    },\n\n    requestClose: () => {\n      // No-op on MCP\n    },\n\n    notifyIntrinsicHeight: (_height) => {\n      // No-op on MCP\n    },\n\n    uploadFile: async (_file) => {\n      throw new Error(\"uploadFile is not supported on MCP platform\");\n    },\n\n    getFileDownloadUrl: async (_params) => {\n      throw new Error(\"getFileDownloadUrl is not supported on MCP platform\");\n    },\n\n    setOpenInAppUrl: (_params) => {\n      // No-op on MCP\n    },\n\n    share: async (_params) => {\n      throw new Error(\"share is not supported on MCP platform\");\n    },\n\n    callCompletion: async (_params) => {\n      throw new Error(\"callCompletion is not supported on MCP platform\");\n    },\n\n    streamCompletion: (_params) => {\n      throw new Error(\"streamCompletion is not supported on MCP platform\");\n    },\n\n    _raw: app,\n  };\n}\n\n// ============================================================================\n// Unified Factory\n// ============================================================================\n\nexport interface CreateUnifiedAppResult {\n  app: UnifiedApp | null;\n  isConnected: boolean;\n  error: Error | null;\n  platform: Platform;\n}\n\n/**\n * Create a unified app - automatically detects platform and creates appropriate adapter\n *\n * For OpenAI: Returns immediately with the adapter\n * For MCP: Returns null app (use the React hook instead for MCP)\n */\nexport function createUnifiedApp(options: UnifiedAppOptions): CreateUnifiedAppResult {\n  const platform = detectPlatform();\n\n  if (platform === \"openai\") {\n    try {\n      const app = createOpenAIAdapter(options);\n      return {\n        app,\n        isConnected: true,\n        error: null,\n        platform: \"openai\",\n      };\n    } catch (error) {\n      return {\n        app: null,\n        isConnected: false,\n        error: error as Error,\n        platform: \"openai\",\n      };\n    }\n  }\n\n  // For MCP, return null - the React hook will handle connection\n  return {\n    app: null,\n    isConnected: false,\n    error: null,\n    platform: \"unknown\",\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,17 @@
+import {
+  createMCPAdapter,
+  createOpenAIAdapter,
+  createUnifiedApp,
+  detectPlatform,
+  isMCP,
+  isOpenAI
+} from "./chunk-MX7VCLPI.mjs";
+export {
+  createMCPAdapter,
+  createOpenAIAdapter,
+  createUnifiedApp,
+  detectPlatform,
+  isMCP,
+  isOpenAI
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/react.d.mts

@@ -0,0 +1,81 @@
+import { UnifiedToolResult, UnifiedHostContext, UnifiedApp, Platform } from './index.mjs';
+export { CreateUnifiedAppResult, OpenAIGlobal, OpenAIWidgetProps, UnifiedAppOptions, UnifiedMessage, createMCPAdapter, createOpenAIAdapter, createUnifiedApp, detectPlatform, isMCP, isOpenAI } from './index.mjs';
+import { McpUiAppCapabilities } from '@modelcontextprotocol/ext-apps';
+
+/**
+ * @file React hook for unified OpenAI/MCP app usage
+ *
+ * This hook provides a unified interface for apps that need to run on both
+ * OpenAI ChatGPT and MCP Apps platforms.
+ */
+
+interface UseUnifiedAppOptions {
+    appInfo: {
+        name: string;
+        version: string;
+    };
+    capabilities?: McpUiAppCapabilities;
+    onToolInput?: (input: unknown) => void | Promise<void>;
+    onToolResult?: (result: UnifiedToolResult) => void | Promise<void>;
+    onHostContextChanged?: (context: UnifiedHostContext) => void;
+    onTeardown?: () => void | Promise<void>;
+    onError?: (error: Error) => void;
+}
+interface UseUnifiedAppResult {
+    /** The unified app instance */
+    app: UnifiedApp | null;
+    /** Whether the app is connected to the host */
+    isConnected: boolean;
+    /** Any connection error */
+    error: Error | null;
+    /** The detected platform */
+    platform: Platform;
+    /** Current host context (theme, displayMode, locale, etc.) */
+    hostContext: UnifiedHostContext | undefined;
+    /** Initial props from toolOutput (OpenAI only, undefined on MCP) - use as initial data for component */
+    initialProps: unknown;
+    /** Widget props (OpenAI only, reactive) */
+    widgetProps: Record<string, unknown>;
+    /** Widget state - works on both platforms via React state */
+    widgetState: unknown;
+    /** Set widget state - works on both platforms (also syncs to OpenAI if on that platform) */
+    setWidgetState: <T = unknown>(state: T) => void;
+    /** Update widget state partially - works on both platforms */
+    updateWidgetState: <T = unknown>(state: Partial<T>) => void;
+}
+/**
+ * React hook that provides a unified app interface for both OpenAI and MCP platforms
+ *
+ * @example
+ * ```tsx
+ * function MyApp() {
+ *   const {
+ *     app,
+ *     isConnected,
+ *     platform,
+ *     hostContext,
+ *     widgetState,
+ *     setWidgetState,
+ *   } = useUnifiedApp({
+ *     appInfo: { name: "My App", version: "1.0.0" },
+ *     capabilities: {},
+ *     onError: console.error,
+ *   });
+ *
+ *   const counter = (widgetState as { value?: number } | null)?.value ?? 0;
+ *
+ *   return (
+ *     <div>
+ *       <p>Running on: {platform}</p>
+ *       <p>Counter: {counter}</p>
+ *       <button onClick={() => setWidgetState({ value: counter + 1 })}>
+ *         Increment
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useUnifiedApp(options: UseUnifiedAppOptions): UseUnifiedAppResult;
+
+export { Platform, UnifiedApp, UnifiedHostContext, UnifiedToolResult, type UseUnifiedAppOptions, type UseUnifiedAppResult, useUnifiedApp };

package/dist/react.d.ts

@@ -0,0 +1,81 @@
+import { UnifiedToolResult, UnifiedHostContext, UnifiedApp, Platform } from './index.js';
+export { CreateUnifiedAppResult, OpenAIGlobal, OpenAIWidgetProps, UnifiedAppOptions, UnifiedMessage, createMCPAdapter, createOpenAIAdapter, createUnifiedApp, detectPlatform, isMCP, isOpenAI } from './index.js';
+import { McpUiAppCapabilities } from '@modelcontextprotocol/ext-apps';
+
+/**
+ * @file React hook for unified OpenAI/MCP app usage
+ *
+ * This hook provides a unified interface for apps that need to run on both
+ * OpenAI ChatGPT and MCP Apps platforms.
+ */
+
+interface UseUnifiedAppOptions {
+    appInfo: {
+        name: string;
+        version: string;
+    };
+    capabilities?: McpUiAppCapabilities;
+    onToolInput?: (input: unknown) => void | Promise<void>;
+    onToolResult?: (result: UnifiedToolResult) => void | Promise<void>;
+    onHostContextChanged?: (context: UnifiedHostContext) => void;
+    onTeardown?: () => void | Promise<void>;
+    onError?: (error: Error) => void;
+}
+interface UseUnifiedAppResult {
+    /** The unified app instance */
+    app: UnifiedApp | null;
+    /** Whether the app is connected to the host */
+    isConnected: boolean;
+    /** Any connection error */
+    error: Error | null;
+    /** The detected platform */
+    platform: Platform;
+    /** Current host context (theme, displayMode, locale, etc.) */
+    hostContext: UnifiedHostContext | undefined;
+    /** Initial props from toolOutput (OpenAI only, undefined on MCP) - use as initial data for component */
+    initialProps: unknown;
+    /** Widget props (OpenAI only, reactive) */
+    widgetProps: Record<string, unknown>;
+    /** Widget state - works on both platforms via React state */
+    widgetState: unknown;
+    /** Set widget state - works on both platforms (also syncs to OpenAI if on that platform) */
+    setWidgetState: <T = unknown>(state: T) => void;
+    /** Update widget state partially - works on both platforms */
+    updateWidgetState: <T = unknown>(state: Partial<T>) => void;
+}
+/**
+ * React hook that provides a unified app interface for both OpenAI and MCP platforms
+ *
+ * @example
+ * ```tsx
+ * function MyApp() {
+ *   const {
+ *     app,
+ *     isConnected,
+ *     platform,
+ *     hostContext,
+ *     widgetState,
+ *     setWidgetState,
+ *   } = useUnifiedApp({
+ *     appInfo: { name: "My App", version: "1.0.0" },
+ *     capabilities: {},
+ *     onError: console.error,
+ *   });
+ *
+ *   const counter = (widgetState as { value?: number } | null)?.value ?? 0;
+ *
+ *   return (
+ *     <div>
+ *       <p>Running on: {platform}</p>
+ *       <p>Counter: {counter}</p>
+ *       <button onClick={() => setWidgetState({ value: counter + 1 })}>
+ *         Increment
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useUnifiedApp(options: UseUnifiedAppOptions): UseUnifiedAppResult;
+
+export { Platform, UnifiedApp, UnifiedHostContext, UnifiedToolResult, type UseUnifiedAppOptions, type UseUnifiedAppResult, useUnifiedApp };