mcp-ui-ext-apps-openai 1.0.0

package/README.md

@@ -0,0 +1,226 @@
+# mcp-ui-ext-apps-openai
+
+[![npm version](https://badge.fury.io/js/mcp-ui-ext-apps-openai.svg)](https://www.npmjs.com/package/mcp-ui-ext-apps-openai)
+[![GitHub](https://img.shields.io/github/license/lkm1developer/mcp-ui-ext-apps-openai)](https://github.com/lkm1developer/mcp-ui-ext-apps-openai/blob/main/LICENSE)
+
+Unified utility for building apps that work on both **OpenAI ChatGPT** and **MCP Apps** platforms.
+
+**Author:** [lkm1developer](https://github.com/lkm1developer)
+
+## Installation
+
+```bash
+npm install mcp-ui-ext-apps-openai
+```
+
+## Peer Dependencies
+
+This package requires the following peer dependencies:
+
+```bash
+npm install @modelcontextprotocol/ext-apps react
+```
+
+## Usage
+
+### React Hook (Recommended)
+
+```tsx
+import { useUnifiedApp } from "mcp-ui-ext-apps-openai/react";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+
+// Define your structured data type
+interface CounterData {
+  status: boolean;
+  value?: number;
+  error?: string;
+}
+
+function CounterApp() {
+  const {
+    app,
+    isConnected,
+    platform,
+    hostContext,
+    initialProps,
+    widgetState,
+    setWidgetState,
+  } = useUnifiedApp({
+    appInfo: { name: "Counter App", version: "1.0.0" },
+    capabilities: {},
+    onError: (e) => console.error("[CounterApp]", e),
+  });
+
+  // Get counter value from widget state
+  const counter = (widgetState as { value?: number } | null)?.value ?? 0;
+
+  // Fetch counter from server
+  const fetchCounter = async () => {
+    if (!app) return;
+
+    const result = await app.callServerTool({ name: "get-counter", arguments: {} });
+    const data = (result as CallToolResult).structuredContent as unknown as CounterData;
+
+    if (data.status && data.value !== undefined) {
+      setWidgetState({ value: data.value });
+    }
+  };
+
+  // Initialize from initialProps (OpenAI) or fetch from server (MCP)
+  useEffect(() => {
+    if (!app || !isConnected) return;
+
+    if (initialProps !== undefined) {
+      const data = (initialProps as CallToolResult).structuredContent as unknown as CounterData;
+      if (data?.status && data.value !== undefined) {
+        setWidgetState({ value: data.value });
+        return;
+      }
+    }
+
+    fetchCounter();
+  }, [app, isConnected, initialProps]);
+
+  // Increment counter
+  const handleIncrement = async () => {
+    if (!app) return;
+
+    const newValue = counter + 1;
+    setWidgetState({ value: newValue }); // Optimistic update
+
+    const result = await app.callServerTool({
+      name: "set-counter",
+      arguments: { value: newValue }
+    });
+    const data = (result as CallToolResult).structuredContent as unknown as CounterData;
+
+    if (!data.status) {
+      setWidgetState({ value: counter }); // Revert on error
+    }
+  };
+
+  return (
+    <div>
+      <p>Platform: {platform}</p>
+      <p>Theme: {hostContext?.theme}</p>
+      <p>Counter: {counter}</p>
+      <button onClick={handleIncrement}>+</button>
+      <button onClick={fetchCounter}>Refresh</button>
+    </div>
+  );
+}
+```
+
+### Core Utilities (No React)
+
+```ts
+import { detectPlatform, isOpenAI, isMCP, createUnifiedApp } from "mcp-ui-ext-apps-openai";
+
+// Check platform
+const platform = detectPlatform(); // "openai" | "mcp" | "unknown"
+
+if (isOpenAI()) {
+  console.log("Running on OpenAI ChatGPT");
+} else if (isMCP()) {
+  console.log("Running on MCP Apps");
+}
+
+// Create unified app (for OpenAI only - use React hook for MCP)
+const { app, isConnected, error } = createUnifiedApp({
+  appInfo: { name: "My App", version: "1.0.0" },
+  onError: console.error,
+});
+
+if (app && isConnected) {
+  const result = await app.callServerTool({ name: "my-tool", arguments: {} });
+}
+```
+
+## API Reference
+
+### `useUnifiedApp(options)`
+
+React hook that provides a unified app interface for both platforms.
+
+#### Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `appInfo` | `{ name: string; version: string }` | App information |
+| `capabilities` | `McpUiAppCapabilities` | Optional capabilities |
+| `onToolInput` | `(input: unknown) => void` | Called when tool input is received |
+| `onToolResult` | `(result: UnifiedToolResult) => void` | Called when tool result is received |
+| `onHostContextChanged` | `(context: UnifiedHostContext) => void` | Called when host context changes |
+| `onTeardown` | `() => void` | Called when app is being torn down |
+| `onError` | `(error: Error) => void` | Called on errors (also logs to console) |
+
+#### Returns
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `app` | `UnifiedApp \| null` | The unified app instance |
+| `isConnected` | `boolean` | Whether connected to host |
+| `error` | `Error \| null` | Any connection error |
+| `platform` | `"openai" \| "mcp" \| "unknown"` | Detected platform |
+| `hostContext` | `UnifiedHostContext` | Current host context (theme, locale, etc.) |
+| `initialProps` | `unknown` | Initial props from toolOutput (OpenAI only) |
+| `widgetProps` | `Record<string, unknown>` | Widget props (OpenAI only) |
+| `widgetState` | `unknown` | Widget state (works on both platforms) |
+| `setWidgetState` | `(state: T) => void` | Set widget state |
+| `updateWidgetState` | `(state: Partial<T>) => void` | Partially update widget state |
+
+### `UnifiedApp` Interface
+
+| Method | Description |
+|--------|-------------|
+| `callServerTool({ name, arguments })` | Call a server tool |
+| `sendMessage(message, options?)` | Send a message to the host |
+| `sendLog({ level, data })` | Send a log message |
+| `openLink({ url })` | Open an external link |
+| `getHostContext()` | Get current host context |
+| `setWidgetState(state)` | Set widget state (OpenAI only) |
+| `updateWidgetState(state)` | Update widget state partially (OpenAI only) |
+| `requestDisplayMode(mode)` | Request display mode (OpenAI only) |
+| `requestClose()` | Request to close widget (OpenAI only) |
+| `uploadFile(file)` | Upload a file (OpenAI only) |
+| `getFileDownloadUrl({ fileId })` | Get file download URL (OpenAI only) |
+
+### Platform-Specific Behavior
+
+| Feature | OpenAI | MCP |
+|---------|--------|-----|
+| `widgetState` | Syncs to OpenAI + React state | React state only |
+| `initialProps` | From `toolOutput` | `undefined` |
+| `widgetProps` | From `widget.props` | `{}` |
+| `uploadFile` | Works | Throws error |
+| `requestDisplayMode` | Works | No-op |
+| `callCompletion` | Works | Throws error |
+
+## Structured Tool Data
+
+Tools should return structured data in `structuredContent`:
+
+```ts
+// Server tool response format
+{
+  status: true,
+  value: 42,
+  // or on error:
+  // status: false,
+  // error: "Something went wrong"
+}
+
+// Access in client
+const result = await app.callServerTool({ name: "get-counter", arguments: {} });
+const data = (result as CallToolResult).structuredContent as unknown as CounterData;
+
+if (data.status) {
+  console.log("Value:", data.value);
+} else {
+  console.error("Error:", data.error);
+}
+```
+
+## License
+
+MIT

package/dist/chunk-MX7VCLPI.mjs

@@ -0,0 +1,261 @@
+// 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"
+  };
+}
+
+export {
+  detectPlatform,
+  isOpenAI,
+  isMCP,
+  createOpenAIAdapter,
+  createMCPAdapter,
+  createUnifiedApp
+};
+//# sourceMappingURL=chunk-MX7VCLPI.mjs.map

package/dist/chunk-MX7VCLPI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/unified-app.ts"],"sourcesContent":["/**\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":[]}