sunpeak 0.17.7 → 0.18.1

package/dist/claude/claude-conversation.d.ts

@@ -1,4 +1,4 @@
-import { ScreenWidth } from '../simulator/simulator-types';
+import { ScreenWidth } from '../inspector/inspector-types';
 import { McpUiDisplayMode, McpUiHostContext } from '@modelcontextprotocol/ext-apps';
 import * as React from 'react';
 type Platform = NonNullable<McpUiHostContext['platform']>;

package/dist/claude/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../chunk-9hOWP6kD.cjs");
 require("../protocol-jbxhzcnS.cjs");
-const require_simulator = require("../simulator-eU6sQTje.cjs");
-exports.Simulator = require_simulator.Simulator;
+const require_inspector = require("../inspector-CByJjmPD.cjs");
+exports.Inspector = require_inspector.Inspector;

package/dist/claude/index.d.ts

@@ -1 +1 @@
-export { Simulator } from '../simulator/simulator';
+export { Inspector } from '../inspector/inspector';

package/dist/claude/index.js

@@ -1,3 +1,3 @@
 import "../protocol-DJmRaBzO.js";
-import { t as Simulator } from "../simulator-0dAb16Qt.js";
-export { Simulator };
+import { t as Inspector } from "../inspector-ClhpqKLi.js";
+export { Inspector };

package/dist/host/chatgpt/index.cjs

@@ -49,45 +49,6 @@ function useUploadFile() {
 	}, [app]);
 }
 //#endregion
-//#region src/host/chatgpt/use-file-download.ts
-/**
-* Get a temporary download URL for a file by its ID.
-*
-* @deprecated Use {@link useDownloadFile} from `sunpeak` instead — it works
-* across all hosts via the MCP Apps SDK `app.downloadFile()` method.
-*
-* Wraps `window.openai.getFileDownloadUrl` which is only available inside
-* ChatGPT. Use this to retrieve URLs for files uploaded via {@link useUploadFile}
-* or file IDs received in tool parameters.
-*
-* Import from `sunpeak/host/chatgpt`:
-*
-* @example
-* ```tsx
-* import { useGetFileDownloadUrl } from 'sunpeak/host/chatgpt';
-*
-* function FilePreview({ fileId }: { fileId: string }) {
-*   const getFileDownloadUrl = useGetFileDownloadUrl();
-*   const [src, setSrc] = useState<string>();
-*
-*   useEffect(() => {
-*     getFileDownloadUrl({ fileId }).then(({ downloadUrl }) => setSrc(downloadUrl));
-*   }, [fileId, getFileDownloadUrl]);
-*
-*   return src ? <img src={src} /> : <p>Loading...</p>;
-* }
-* ```
-*/
-function useGetFileDownloadUrl() {
-	const app = require_use_app.useApp();
-	return (0, react.useCallback)(async (params) => {
-		if (!app) throw new Error("[useGetFileDownloadUrl] App not connected");
-		const runtime = getOpenAIRuntime();
-		if (!runtime?.getFileDownloadUrl) throw new Error("[useGetFileDownloadUrl] window.openai.getFileDownloadUrl not available");
-		return runtime.getFileDownloadUrl(params);
-	}, [app]);
-}
-//#endregion
 //#region src/host/chatgpt/use-open-modal.ts
 /**
 * Open a host-controlled modal in ChatGPT.
@@ -179,7 +140,6 @@ function useRequestCheckout() {
 }
 //#endregion
 exports.getOpenAIRuntime = getOpenAIRuntime;
-exports.useGetFileDownloadUrl = useGetFileDownloadUrl;
 exports.useRequestCheckout = useRequestCheckout;
 exports.useRequestModal = useRequestModal;
 exports.useUploadFile = useUploadFile;

package/dist/host/chatgpt/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/host/chatgpt/openai-types.ts","../../../src/host/chatgpt/use-create-file.ts","../../../src/host/chatgpt/use-file-download.ts","../../../src/host/chatgpt/use-open-modal.ts","../../../src/host/chatgpt/use-request-checkout.ts"],"sourcesContent":["/**\n * TypeScript declarations for the `window.openai` ChatGPT runtime.\n *\n * These APIs are available inside ChatGPT-hosted iframes and provide\n * platform-specific capabilities beyond the MCP Apps standard.\n *\n * @see https://developers.openai.com/apps-sdk/mcp-apps-in-chatgpt\n */\n\nexport interface OpenAIUploadFileResult {\n  fileId: string;\n}\n\nexport interface OpenAIFileDownloadUrlResult {\n  downloadUrl: string;\n}\n\nexport interface OpenAIRequestModalParams {\n  /** URL of an alternate UI template to load in the modal. Omit to reuse the current UI. */\n  template?: string;\n  /** Arbitrary params forwarded to the modal content. */\n  params?: Record<string, unknown>;\n}\n\nexport interface OpenAICheckoutPaymentProvider {\n  provider: string;\n  merchant_id: string;\n  supported_payment_methods: string[];\n}\n\nexport interface OpenAICheckoutTotal {\n  type: string;\n  display_text: string;\n  amount: number;\n}\n\nexport interface OpenAICheckoutLink {\n  type: 'terms_of_use' | 'privacy_policy' | string;\n  url: string;\n}\n\nexport interface OpenAICheckoutSession {\n  id: string;\n  payment_provider: OpenAICheckoutPaymentProvider;\n  status: 'ready_for_payment';\n  currency: string;\n  totals: OpenAICheckoutTotal[];\n  links: OpenAICheckoutLink[];\n  payment_mode: 'live' | 'test';\n}\n\nexport interface OpenAICheckoutOrder {\n  id: string;\n  checkout_session_id: string;\n  status: 'completed' | string;\n  permalink_url?: string;\n}\n\n/**\n * The `window.openai` runtime object injected by ChatGPT into hosted iframes.\n */\nexport interface OpenAIRuntime {\n  // --- File APIs ---\n  uploadFile?(file: File): Promise<OpenAIUploadFileResult>;\n  getFileDownloadUrl?(params: { fileId: string }): Promise<OpenAIFileDownloadUrlResult>;\n\n  // --- Modal API ---\n  requestModal?(params: OpenAIRequestModalParams): Promise<void>;\n\n  // --- Checkout API ---\n  requestCheckout?(session: OpenAICheckoutSession): Promise<OpenAICheckoutOrder>;\n\n  // --- Display ---\n  requestClose?(): void;\n  requestDisplayMode?(params: { mode: 'inline' | 'PiP' | 'fullscreen' }): Promise<void>;\n\n  // --- Messaging ---\n  sendFollowUpMessage?(params: { prompt: string }): void;\n\n  // --- Other ---\n  openExternal?(params: { href: string }): void;\n}\n\n/**\n * Get the `window.openai` runtime if available.\n * Returns `undefined` outside of ChatGPT or in SSR.\n */\nexport function getOpenAIRuntime(): OpenAIRuntime | undefined {\n  if (typeof window !== 'undefined' && 'openai' in window) {\n    return (window as unknown as { openai: OpenAIRuntime }).openai;\n  }\n  return undefined;\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIUploadFileResult } from './openai-types';\n\nexport type { OpenAIUploadFileResult as CreateFileResult };\n\n/**\n * Upload a file from the app UI into the ChatGPT conversation.\n *\n * Wraps `window.openai.uploadFile` which is only available inside ChatGPT.\n * Supported formats: `image/png`, `image/jpeg`, `image/webp`.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useUploadFile } from 'sunpeak/host/chatgpt';\n *\n * function ImageUploader() {\n *   const uploadFile = useUploadFile();\n *\n *   const handleChange = async (e: React.ChangeEvent<HTMLInputElement>) => {\n *     const file = e.currentTarget.files?.[0];\n *     if (!file) return;\n *     const { fileId } = await uploadFile(file);\n *     console.log('Uploaded:', fileId);\n *   };\n *\n *   return <input type=\"file\" accept=\"image/*\" onChange={handleChange} />;\n * }\n * ```\n */\nexport function useUploadFile(): (file: File) => Promise<OpenAIUploadFileResult> {\n  const app = useApp();\n  return useCallback(\n    async (file: File) => {\n      if (!app) {\n        throw new Error('[useUploadFile] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.uploadFile) {\n        throw new Error('[useUploadFile] window.openai.uploadFile not available');\n      }\n      return runtime.uploadFile(file);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIFileDownloadUrlResult } from './openai-types';\n\nexport type { OpenAIFileDownloadUrlResult as FileDownloadUrlResult };\n\n/**\n * Get a temporary download URL for a file by its ID.\n *\n * @deprecated Use {@link useDownloadFile} from `sunpeak` instead — it works\n * across all hosts via the MCP Apps SDK `app.downloadFile()` method.\n *\n * Wraps `window.openai.getFileDownloadUrl` which is only available inside\n * ChatGPT. Use this to retrieve URLs for files uploaded via {@link useUploadFile}\n * or file IDs received in tool parameters.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useGetFileDownloadUrl } from 'sunpeak/host/chatgpt';\n *\n * function FilePreview({ fileId }: { fileId: string }) {\n *   const getFileDownloadUrl = useGetFileDownloadUrl();\n *   const [src, setSrc] = useState<string>();\n *\n *   useEffect(() => {\n *     getFileDownloadUrl({ fileId }).then(({ downloadUrl }) => setSrc(downloadUrl));\n *   }, [fileId, getFileDownloadUrl]);\n *\n *   return src ? <img src={src} /> : <p>Loading...</p>;\n * }\n * ```\n */\nexport function useGetFileDownloadUrl(): (params: {\n  fileId: string;\n}) => Promise<OpenAIFileDownloadUrlResult> {\n  const app = useApp();\n  return useCallback(\n    async (params: { fileId: string }) => {\n      if (!app) {\n        throw new Error('[useGetFileDownloadUrl] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.getFileDownloadUrl) {\n        throw new Error('[useGetFileDownloadUrl] window.openai.getFileDownloadUrl not available');\n      }\n      return runtime.getFileDownloadUrl(params);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIRequestModalParams } from './openai-types';\n\nexport type { OpenAIRequestModalParams as OpenModalParams };\n\n/**\n * Open a host-controlled modal in ChatGPT.\n *\n * Wraps `window.openai.requestModal` which is only available inside ChatGPT.\n * Pass a `template` URL to load alternate UI content in the modal, or omit\n * it to reuse the current UI.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestModal } from 'sunpeak/host/chatgpt';\n *\n * function CheckoutButton() {\n *   const requestModal = useRequestModal();\n *\n *   return (\n *     <button onClick={() => requestModal({ template: 'ui://widget/checkout.html' })}>\n *       Checkout\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useRequestModal(): (params: OpenAIRequestModalParams) => Promise<void> {\n  const app = useApp();\n  return useCallback(\n    async (params: OpenAIRequestModalParams) => {\n      if (!app) {\n        console.warn('[useRequestModal] App not connected');\n        return;\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestModal) {\n        throw new Error('[useRequestModal] window.openai.requestModal not available');\n      }\n      return runtime.requestModal(params);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport {\n  getOpenAIRuntime,\n  type OpenAICheckoutSession,\n  type OpenAICheckoutOrder,\n} from './openai-types';\n\nexport type { OpenAICheckoutSession as CheckoutSession };\nexport type { OpenAICheckoutOrder as CheckoutOrder };\n\n/**\n * Trigger the ChatGPT instant checkout flow.\n *\n * Wraps `window.openai.requestCheckout` which is only available inside\n * ChatGPT. Opens the host checkout UI, handles payment display, and\n * resolves with the finalized order. Rejects on error or user cancel.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestCheckout } from 'sunpeak/host/chatgpt';\n *\n * function BuyButton() {\n *   const requestCheckout = useRequestCheckout();\n *\n *   const handleBuy = async () => {\n *     try {\n *       const order = await requestCheckout({\n *         id: 'session-1',\n *         payment_provider: {\n *           provider: 'stripe',\n *           merchant_id: 'acct_xxx',\n *           supported_payment_methods: ['card', 'apple_pay'],\n *         },\n *         status: 'ready_for_payment',\n *         currency: 'USD',\n *         totals: [{ type: 'total', display_text: 'Total', amount: 999 }],\n *         links: [],\n *         payment_mode: 'live',\n *       });\n *       console.log('Order completed:', order.id);\n *     } catch {\n *       console.log('Checkout cancelled or failed');\n *     }\n *   };\n *\n *   return <button onClick={handleBuy}>Buy Now</button>;\n * }\n * ```\n */\nexport function useRequestCheckout(): (\n  session: OpenAICheckoutSession\n) => Promise<OpenAICheckoutOrder> {\n  const app = useApp();\n  return useCallback(\n    async (session: OpenAICheckoutSession) => {\n      if (!app) {\n        throw new Error('[useRequestCheckout] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestCheckout) {\n        throw new Error('[useRequestCheckout] window.openai.requestCheckout not available');\n      }\n      return runtime.requestCheckout(session);\n    },\n    [app]\n  );\n}\n"],"mappings":";;;;;;;;;;AAuFA,SAAgB,mBAA8C;AAC5D,KAAI,OAAO,WAAW,eAAe,YAAY,OAC/C,QAAQ,OAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACzD5D,SAAgB,gBAAiE;CAC/E,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,SAAe;AACpB,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,oCAAoC;EAEtD,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,WACZ,OAAM,IAAI,MAAM,yDAAyD;AAE3E,SAAO,QAAQ,WAAW,KAAK;IAEjC,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACZH,SAAgB,wBAE2B;CACzC,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,WAA+B;AACpC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,4CAA4C;EAE9D,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,mBACZ,OAAM,IAAI,MAAM,yEAAyE;AAE3F,SAAO,QAAQ,mBAAmB,OAAO;IAE3C,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACpBH,SAAgB,kBAAuE;CACrF,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,WAAqC;AAC1C,MAAI,CAAC,KAAK;AACR,WAAQ,KAAK,sCAAsC;AACnD;;EAEF,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,aACZ,OAAM,IAAI,MAAM,6DAA6D;AAE/E,SAAO,QAAQ,aAAa,OAAO;IAErC,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACOH,SAAgB,qBAEkB;CAChC,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,YAAmC;AACxC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,yCAAyC;EAE3D,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,gBACZ,OAAM,IAAI,MAAM,mEAAmE;AAErF,SAAO,QAAQ,gBAAgB,QAAQ;IAEzC,CAAC,IAAI,CACN"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/host/chatgpt/openai-types.ts","../../../src/host/chatgpt/use-create-file.ts","../../../src/host/chatgpt/use-open-modal.ts","../../../src/host/chatgpt/use-request-checkout.ts"],"sourcesContent":["/**\n * TypeScript declarations for the `window.openai` ChatGPT runtime.\n *\n * These APIs are available inside ChatGPT-hosted iframes and provide\n * platform-specific capabilities beyond the MCP Apps standard.\n *\n * @see https://developers.openai.com/apps-sdk/mcp-apps-in-chatgpt\n */\n\nexport interface OpenAIUploadFileResult {\n  fileId: string;\n}\n\nexport interface OpenAIFileDownloadUrlResult {\n  downloadUrl: string;\n}\n\nexport interface OpenAIRequestModalParams {\n  /** URL of an alternate UI template to load in the modal. Omit to reuse the current UI. */\n  template?: string;\n  /** Arbitrary params forwarded to the modal content. */\n  params?: Record<string, unknown>;\n}\n\nexport interface OpenAICheckoutPaymentProvider {\n  provider: string;\n  merchant_id: string;\n  supported_payment_methods: string[];\n}\n\nexport interface OpenAICheckoutTotal {\n  type: string;\n  display_text: string;\n  amount: number;\n}\n\nexport interface OpenAICheckoutLink {\n  type: 'terms_of_use' | 'privacy_policy' | string;\n  url: string;\n}\n\nexport interface OpenAICheckoutSession {\n  id: string;\n  payment_provider: OpenAICheckoutPaymentProvider;\n  status: 'ready_for_payment';\n  currency: string;\n  totals: OpenAICheckoutTotal[];\n  links: OpenAICheckoutLink[];\n  payment_mode: 'live' | 'test';\n}\n\nexport interface OpenAICheckoutOrder {\n  id: string;\n  checkout_session_id: string;\n  status: 'completed' | string;\n  permalink_url?: string;\n}\n\n/**\n * The `window.openai` runtime object injected by ChatGPT into hosted iframes.\n */\nexport interface OpenAIRuntime {\n  // --- File APIs ---\n  uploadFile?(file: File): Promise<OpenAIUploadFileResult>;\n  getFileDownloadUrl?(params: { fileId: string }): Promise<OpenAIFileDownloadUrlResult>;\n\n  // --- Modal API ---\n  requestModal?(params: OpenAIRequestModalParams): Promise<void>;\n\n  // --- Checkout API ---\n  requestCheckout?(session: OpenAICheckoutSession): Promise<OpenAICheckoutOrder>;\n\n  // --- Display ---\n  requestClose?(): void;\n  requestDisplayMode?(params: { mode: 'inline' | 'PiP' | 'fullscreen' }): Promise<void>;\n\n  // --- Messaging ---\n  sendFollowUpMessage?(params: { prompt: string }): void;\n\n  // --- Other ---\n  openExternal?(params: { href: string }): void;\n}\n\n/**\n * Get the `window.openai` runtime if available.\n * Returns `undefined` outside of ChatGPT or in SSR.\n */\nexport function getOpenAIRuntime(): OpenAIRuntime | undefined {\n  if (typeof window !== 'undefined' && 'openai' in window) {\n    return (window as unknown as { openai: OpenAIRuntime }).openai;\n  }\n  return undefined;\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIUploadFileResult } from './openai-types';\n\nexport type { OpenAIUploadFileResult as CreateFileResult };\n\n/**\n * Upload a file from the app UI into the ChatGPT conversation.\n *\n * Wraps `window.openai.uploadFile` which is only available inside ChatGPT.\n * Supported formats: `image/png`, `image/jpeg`, `image/webp`.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useUploadFile } from 'sunpeak/host/chatgpt';\n *\n * function ImageUploader() {\n *   const uploadFile = useUploadFile();\n *\n *   const handleChange = async (e: React.ChangeEvent<HTMLInputElement>) => {\n *     const file = e.currentTarget.files?.[0];\n *     if (!file) return;\n *     const { fileId } = await uploadFile(file);\n *     console.log('Uploaded:', fileId);\n *   };\n *\n *   return <input type=\"file\" accept=\"image/*\" onChange={handleChange} />;\n * }\n * ```\n */\nexport function useUploadFile(): (file: File) => Promise<OpenAIUploadFileResult> {\n  const app = useApp();\n  return useCallback(\n    async (file: File) => {\n      if (!app) {\n        throw new Error('[useUploadFile] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.uploadFile) {\n        throw new Error('[useUploadFile] window.openai.uploadFile not available');\n      }\n      return runtime.uploadFile(file);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIRequestModalParams } from './openai-types';\n\nexport type { OpenAIRequestModalParams as OpenModalParams };\n\n/**\n * Open a host-controlled modal in ChatGPT.\n *\n * Wraps `window.openai.requestModal` which is only available inside ChatGPT.\n * Pass a `template` URL to load alternate UI content in the modal, or omit\n * it to reuse the current UI.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestModal } from 'sunpeak/host/chatgpt';\n *\n * function CheckoutButton() {\n *   const requestModal = useRequestModal();\n *\n *   return (\n *     <button onClick={() => requestModal({ template: 'ui://widget/checkout.html' })}>\n *       Checkout\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useRequestModal(): (params: OpenAIRequestModalParams) => Promise<void> {\n  const app = useApp();\n  return useCallback(\n    async (params: OpenAIRequestModalParams) => {\n      if (!app) {\n        console.warn('[useRequestModal] App not connected');\n        return;\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestModal) {\n        throw new Error('[useRequestModal] window.openai.requestModal not available');\n      }\n      return runtime.requestModal(params);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport {\n  getOpenAIRuntime,\n  type OpenAICheckoutSession,\n  type OpenAICheckoutOrder,\n} from './openai-types';\n\nexport type { OpenAICheckoutSession as CheckoutSession };\nexport type { OpenAICheckoutOrder as CheckoutOrder };\n\n/**\n * Trigger the ChatGPT instant checkout flow.\n *\n * Wraps `window.openai.requestCheckout` which is only available inside\n * ChatGPT. Opens the host checkout UI, handles payment display, and\n * resolves with the finalized order. Rejects on error or user cancel.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestCheckout } from 'sunpeak/host/chatgpt';\n *\n * function BuyButton() {\n *   const requestCheckout = useRequestCheckout();\n *\n *   const handleBuy = async () => {\n *     try {\n *       const order = await requestCheckout({\n *         id: 'session-1',\n *         payment_provider: {\n *           provider: 'stripe',\n *           merchant_id: 'acct_xxx',\n *           supported_payment_methods: ['card', 'apple_pay'],\n *         },\n *         status: 'ready_for_payment',\n *         currency: 'USD',\n *         totals: [{ type: 'total', display_text: 'Total', amount: 999 }],\n *         links: [],\n *         payment_mode: 'live',\n *       });\n *       console.log('Order completed:', order.id);\n *     } catch {\n *       console.log('Checkout cancelled or failed');\n *     }\n *   };\n *\n *   return <button onClick={handleBuy}>Buy Now</button>;\n * }\n * ```\n */\nexport function useRequestCheckout(): (\n  session: OpenAICheckoutSession\n) => Promise<OpenAICheckoutOrder> {\n  const app = useApp();\n  return useCallback(\n    async (session: OpenAICheckoutSession) => {\n      if (!app) {\n        throw new Error('[useRequestCheckout] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestCheckout) {\n        throw new Error('[useRequestCheckout] window.openai.requestCheckout not available');\n      }\n      return runtime.requestCheckout(session);\n    },\n    [app]\n  );\n}\n"],"mappings":";;;;;;;;;;AAuFA,SAAgB,mBAA8C;AAC5D,KAAI,OAAO,WAAW,eAAe,YAAY,OAC/C,QAAQ,OAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACzD5D,SAAgB,gBAAiE;CAC/E,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,SAAe;AACpB,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,oCAAoC;EAEtD,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,WACZ,OAAM,IAAI,MAAM,yDAAyD;AAE3E,SAAO,QAAQ,WAAW,KAAK;IAEjC,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;AChBH,SAAgB,kBAAuE;CACrF,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,WAAqC;AAC1C,MAAI,CAAC,KAAK;AACR,WAAQ,KAAK,sCAAsC;AACnD;;EAEF,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,aACZ,OAAM,IAAI,MAAM,6DAA6D;AAE/E,SAAO,QAAQ,aAAa,OAAO;IAErC,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACOH,SAAgB,qBAEkB;CAChC,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,YAAmC;AACxC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,yCAAyC;EAE3D,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,gBACZ,OAAM,IAAI,MAAM,mEAAmE;AAErF,SAAO,QAAQ,gBAAgB,QAAQ;IAEzC,CAAC,IAAI,CACN"}

package/dist/host/chatgpt/index.d.ts

@@ -20,9 +20,6 @@ export { getOpenAIRuntime } from './openai-types';
 export type { OpenAIRuntime } from './openai-types';
 export { useUploadFile } from './use-create-file';
 export type { CreateFileResult } from './use-create-file';
-/** @deprecated Use `useDownloadFile` from `sunpeak` instead. */
-export { useGetFileDownloadUrl } from './use-file-download';
-export type { FileDownloadUrlResult } from './use-file-download';
 export { useRequestModal } from './use-open-modal';
 export type { OpenModalParams } from './use-open-modal';
 export { useRequestCheckout } from './use-request-checkout';

package/dist/host/chatgpt/index.js

@@ -47,45 +47,6 @@ function useUploadFile() {
 	}, [app]);
 }
 //#endregion
-//#region src/host/chatgpt/use-file-download.ts
-/**
-* Get a temporary download URL for a file by its ID.
-*
-* @deprecated Use {@link useDownloadFile} from `sunpeak` instead — it works
-* across all hosts via the MCP Apps SDK `app.downloadFile()` method.
-*
-* Wraps `window.openai.getFileDownloadUrl` which is only available inside
-* ChatGPT. Use this to retrieve URLs for files uploaded via {@link useUploadFile}
-* or file IDs received in tool parameters.
-*
-* Import from `sunpeak/host/chatgpt`:
-*
-* @example
-* ```tsx
-* import { useGetFileDownloadUrl } from 'sunpeak/host/chatgpt';
-*
-* function FilePreview({ fileId }: { fileId: string }) {
-*   const getFileDownloadUrl = useGetFileDownloadUrl();
-*   const [src, setSrc] = useState<string>();
-*
-*   useEffect(() => {
-*     getFileDownloadUrl({ fileId }).then(({ downloadUrl }) => setSrc(downloadUrl));
-*   }, [fileId, getFileDownloadUrl]);
-*
-*   return src ? <img src={src} /> : <p>Loading...</p>;
-* }
-* ```
-*/
-function useGetFileDownloadUrl() {
-	const app = useApp();
-	return useCallback(async (params) => {
-		if (!app) throw new Error("[useGetFileDownloadUrl] App not connected");
-		const runtime = getOpenAIRuntime();
-		if (!runtime?.getFileDownloadUrl) throw new Error("[useGetFileDownloadUrl] window.openai.getFileDownloadUrl not available");
-		return runtime.getFileDownloadUrl(params);
-	}, [app]);
-}
-//#endregion
 //#region src/host/chatgpt/use-open-modal.ts
 /**
 * Open a host-controlled modal in ChatGPT.
@@ -176,6 +137,6 @@ function useRequestCheckout() {
 	}, [app]);
 }
 //#endregion
-export { getOpenAIRuntime, useGetFileDownloadUrl, useRequestCheckout, useRequestModal, useUploadFile };
+export { getOpenAIRuntime, useRequestCheckout, useRequestModal, useUploadFile };
 
 //# sourceMappingURL=index.js.map

package/dist/host/chatgpt/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/host/chatgpt/openai-types.ts","../../../src/host/chatgpt/use-create-file.ts","../../../src/host/chatgpt/use-file-download.ts","../../../src/host/chatgpt/use-open-modal.ts","../../../src/host/chatgpt/use-request-checkout.ts"],"sourcesContent":["/**\n * TypeScript declarations for the `window.openai` ChatGPT runtime.\n *\n * These APIs are available inside ChatGPT-hosted iframes and provide\n * platform-specific capabilities beyond the MCP Apps standard.\n *\n * @see https://developers.openai.com/apps-sdk/mcp-apps-in-chatgpt\n */\n\nexport interface OpenAIUploadFileResult {\n  fileId: string;\n}\n\nexport interface OpenAIFileDownloadUrlResult {\n  downloadUrl: string;\n}\n\nexport interface OpenAIRequestModalParams {\n  /** URL of an alternate UI template to load in the modal. Omit to reuse the current UI. */\n  template?: string;\n  /** Arbitrary params forwarded to the modal content. */\n  params?: Record<string, unknown>;\n}\n\nexport interface OpenAICheckoutPaymentProvider {\n  provider: string;\n  merchant_id: string;\n  supported_payment_methods: string[];\n}\n\nexport interface OpenAICheckoutTotal {\n  type: string;\n  display_text: string;\n  amount: number;\n}\n\nexport interface OpenAICheckoutLink {\n  type: 'terms_of_use' | 'privacy_policy' | string;\n  url: string;\n}\n\nexport interface OpenAICheckoutSession {\n  id: string;\n  payment_provider: OpenAICheckoutPaymentProvider;\n  status: 'ready_for_payment';\n  currency: string;\n  totals: OpenAICheckoutTotal[];\n  links: OpenAICheckoutLink[];\n  payment_mode: 'live' | 'test';\n}\n\nexport interface OpenAICheckoutOrder {\n  id: string;\n  checkout_session_id: string;\n  status: 'completed' | string;\n  permalink_url?: string;\n}\n\n/**\n * The `window.openai` runtime object injected by ChatGPT into hosted iframes.\n */\nexport interface OpenAIRuntime {\n  // --- File APIs ---\n  uploadFile?(file: File): Promise<OpenAIUploadFileResult>;\n  getFileDownloadUrl?(params: { fileId: string }): Promise<OpenAIFileDownloadUrlResult>;\n\n  // --- Modal API ---\n  requestModal?(params: OpenAIRequestModalParams): Promise<void>;\n\n  // --- Checkout API ---\n  requestCheckout?(session: OpenAICheckoutSession): Promise<OpenAICheckoutOrder>;\n\n  // --- Display ---\n  requestClose?(): void;\n  requestDisplayMode?(params: { mode: 'inline' | 'PiP' | 'fullscreen' }): Promise<void>;\n\n  // --- Messaging ---\n  sendFollowUpMessage?(params: { prompt: string }): void;\n\n  // --- Other ---\n  openExternal?(params: { href: string }): void;\n}\n\n/**\n * Get the `window.openai` runtime if available.\n * Returns `undefined` outside of ChatGPT or in SSR.\n */\nexport function getOpenAIRuntime(): OpenAIRuntime | undefined {\n  if (typeof window !== 'undefined' && 'openai' in window) {\n    return (window as unknown as { openai: OpenAIRuntime }).openai;\n  }\n  return undefined;\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIUploadFileResult } from './openai-types';\n\nexport type { OpenAIUploadFileResult as CreateFileResult };\n\n/**\n * Upload a file from the app UI into the ChatGPT conversation.\n *\n * Wraps `window.openai.uploadFile` which is only available inside ChatGPT.\n * Supported formats: `image/png`, `image/jpeg`, `image/webp`.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useUploadFile } from 'sunpeak/host/chatgpt';\n *\n * function ImageUploader() {\n *   const uploadFile = useUploadFile();\n *\n *   const handleChange = async (e: React.ChangeEvent<HTMLInputElement>) => {\n *     const file = e.currentTarget.files?.[0];\n *     if (!file) return;\n *     const { fileId } = await uploadFile(file);\n *     console.log('Uploaded:', fileId);\n *   };\n *\n *   return <input type=\"file\" accept=\"image/*\" onChange={handleChange} />;\n * }\n * ```\n */\nexport function useUploadFile(): (file: File) => Promise<OpenAIUploadFileResult> {\n  const app = useApp();\n  return useCallback(\n    async (file: File) => {\n      if (!app) {\n        throw new Error('[useUploadFile] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.uploadFile) {\n        throw new Error('[useUploadFile] window.openai.uploadFile not available');\n      }\n      return runtime.uploadFile(file);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIFileDownloadUrlResult } from './openai-types';\n\nexport type { OpenAIFileDownloadUrlResult as FileDownloadUrlResult };\n\n/**\n * Get a temporary download URL for a file by its ID.\n *\n * @deprecated Use {@link useDownloadFile} from `sunpeak` instead — it works\n * across all hosts via the MCP Apps SDK `app.downloadFile()` method.\n *\n * Wraps `window.openai.getFileDownloadUrl` which is only available inside\n * ChatGPT. Use this to retrieve URLs for files uploaded via {@link useUploadFile}\n * or file IDs received in tool parameters.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useGetFileDownloadUrl } from 'sunpeak/host/chatgpt';\n *\n * function FilePreview({ fileId }: { fileId: string }) {\n *   const getFileDownloadUrl = useGetFileDownloadUrl();\n *   const [src, setSrc] = useState<string>();\n *\n *   useEffect(() => {\n *     getFileDownloadUrl({ fileId }).then(({ downloadUrl }) => setSrc(downloadUrl));\n *   }, [fileId, getFileDownloadUrl]);\n *\n *   return src ? <img src={src} /> : <p>Loading...</p>;\n * }\n * ```\n */\nexport function useGetFileDownloadUrl(): (params: {\n  fileId: string;\n}) => Promise<OpenAIFileDownloadUrlResult> {\n  const app = useApp();\n  return useCallback(\n    async (params: { fileId: string }) => {\n      if (!app) {\n        throw new Error('[useGetFileDownloadUrl] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.getFileDownloadUrl) {\n        throw new Error('[useGetFileDownloadUrl] window.openai.getFileDownloadUrl not available');\n      }\n      return runtime.getFileDownloadUrl(params);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIRequestModalParams } from './openai-types';\n\nexport type { OpenAIRequestModalParams as OpenModalParams };\n\n/**\n * Open a host-controlled modal in ChatGPT.\n *\n * Wraps `window.openai.requestModal` which is only available inside ChatGPT.\n * Pass a `template` URL to load alternate UI content in the modal, or omit\n * it to reuse the current UI.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestModal } from 'sunpeak/host/chatgpt';\n *\n * function CheckoutButton() {\n *   const requestModal = useRequestModal();\n *\n *   return (\n *     <button onClick={() => requestModal({ template: 'ui://widget/checkout.html' })}>\n *       Checkout\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useRequestModal(): (params: OpenAIRequestModalParams) => Promise<void> {\n  const app = useApp();\n  return useCallback(\n    async (params: OpenAIRequestModalParams) => {\n      if (!app) {\n        console.warn('[useRequestModal] App not connected');\n        return;\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestModal) {\n        throw new Error('[useRequestModal] window.openai.requestModal not available');\n      }\n      return runtime.requestModal(params);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport {\n  getOpenAIRuntime,\n  type OpenAICheckoutSession,\n  type OpenAICheckoutOrder,\n} from './openai-types';\n\nexport type { OpenAICheckoutSession as CheckoutSession };\nexport type { OpenAICheckoutOrder as CheckoutOrder };\n\n/**\n * Trigger the ChatGPT instant checkout flow.\n *\n * Wraps `window.openai.requestCheckout` which is only available inside\n * ChatGPT. Opens the host checkout UI, handles payment display, and\n * resolves with the finalized order. Rejects on error or user cancel.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestCheckout } from 'sunpeak/host/chatgpt';\n *\n * function BuyButton() {\n *   const requestCheckout = useRequestCheckout();\n *\n *   const handleBuy = async () => {\n *     try {\n *       const order = await requestCheckout({\n *         id: 'session-1',\n *         payment_provider: {\n *           provider: 'stripe',\n *           merchant_id: 'acct_xxx',\n *           supported_payment_methods: ['card', 'apple_pay'],\n *         },\n *         status: 'ready_for_payment',\n *         currency: 'USD',\n *         totals: [{ type: 'total', display_text: 'Total', amount: 999 }],\n *         links: [],\n *         payment_mode: 'live',\n *       });\n *       console.log('Order completed:', order.id);\n *     } catch {\n *       console.log('Checkout cancelled or failed');\n *     }\n *   };\n *\n *   return <button onClick={handleBuy}>Buy Now</button>;\n * }\n * ```\n */\nexport function useRequestCheckout(): (\n  session: OpenAICheckoutSession\n) => Promise<OpenAICheckoutOrder> {\n  const app = useApp();\n  return useCallback(\n    async (session: OpenAICheckoutSession) => {\n      if (!app) {\n        throw new Error('[useRequestCheckout] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestCheckout) {\n        throw new Error('[useRequestCheckout] window.openai.requestCheckout not available');\n      }\n      return runtime.requestCheckout(session);\n    },\n    [app]\n  );\n}\n"],"mappings":";;;;;;;;AAuFA,SAAgB,mBAA8C;AAC5D,KAAI,OAAO,WAAW,eAAe,YAAY,OAC/C,QAAQ,OAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACzD5D,SAAgB,gBAAiE;CAC/E,MAAM,MAAM,QAAQ;AACpB,QAAO,YACL,OAAO,SAAe;AACpB,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,oCAAoC;EAEtD,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,WACZ,OAAM,IAAI,MAAM,yDAAyD;AAE3E,SAAO,QAAQ,WAAW,KAAK;IAEjC,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACZH,SAAgB,wBAE2B;CACzC,MAAM,MAAM,QAAQ;AACpB,QAAO,YACL,OAAO,WAA+B;AACpC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,4CAA4C;EAE9D,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,mBACZ,OAAM,IAAI,MAAM,yEAAyE;AAE3F,SAAO,QAAQ,mBAAmB,OAAO;IAE3C,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACpBH,SAAgB,kBAAuE;CACrF,MAAM,MAAM,QAAQ;AACpB,QAAO,YACL,OAAO,WAAqC;AAC1C,MAAI,CAAC,KAAK;AACR,WAAQ,KAAK,sCAAsC;AACnD;;EAEF,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,aACZ,OAAM,IAAI,MAAM,6DAA6D;AAE/E,SAAO,QAAQ,aAAa,OAAO;IAErC,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACOH,SAAgB,qBAEkB;CAChC,MAAM,MAAM,QAAQ;AACpB,QAAO,YACL,OAAO,YAAmC;AACxC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,yCAAyC;EAE3D,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,gBACZ,OAAM,IAAI,MAAM,mEAAmE;AAErF,SAAO,QAAQ,gBAAgB,QAAQ;IAEzC,CAAC,IAAI,CACN"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/host/chatgpt/openai-types.ts","../../../src/host/chatgpt/use-create-file.ts","../../../src/host/chatgpt/use-open-modal.ts","../../../src/host/chatgpt/use-request-checkout.ts"],"sourcesContent":["/**\n * TypeScript declarations for the `window.openai` ChatGPT runtime.\n *\n * These APIs are available inside ChatGPT-hosted iframes and provide\n * platform-specific capabilities beyond the MCP Apps standard.\n *\n * @see https://developers.openai.com/apps-sdk/mcp-apps-in-chatgpt\n */\n\nexport interface OpenAIUploadFileResult {\n  fileId: string;\n}\n\nexport interface OpenAIFileDownloadUrlResult {\n  downloadUrl: string;\n}\n\nexport interface OpenAIRequestModalParams {\n  /** URL of an alternate UI template to load in the modal. Omit to reuse the current UI. */\n  template?: string;\n  /** Arbitrary params forwarded to the modal content. */\n  params?: Record<string, unknown>;\n}\n\nexport interface OpenAICheckoutPaymentProvider {\n  provider: string;\n  merchant_id: string;\n  supported_payment_methods: string[];\n}\n\nexport interface OpenAICheckoutTotal {\n  type: string;\n  display_text: string;\n  amount: number;\n}\n\nexport interface OpenAICheckoutLink {\n  type: 'terms_of_use' | 'privacy_policy' | string;\n  url: string;\n}\n\nexport interface OpenAICheckoutSession {\n  id: string;\n  payment_provider: OpenAICheckoutPaymentProvider;\n  status: 'ready_for_payment';\n  currency: string;\n  totals: OpenAICheckoutTotal[];\n  links: OpenAICheckoutLink[];\n  payment_mode: 'live' | 'test';\n}\n\nexport interface OpenAICheckoutOrder {\n  id: string;\n  checkout_session_id: string;\n  status: 'completed' | string;\n  permalink_url?: string;\n}\n\n/**\n * The `window.openai` runtime object injected by ChatGPT into hosted iframes.\n */\nexport interface OpenAIRuntime {\n  // --- File APIs ---\n  uploadFile?(file: File): Promise<OpenAIUploadFileResult>;\n  getFileDownloadUrl?(params: { fileId: string }): Promise<OpenAIFileDownloadUrlResult>;\n\n  // --- Modal API ---\n  requestModal?(params: OpenAIRequestModalParams): Promise<void>;\n\n  // --- Checkout API ---\n  requestCheckout?(session: OpenAICheckoutSession): Promise<OpenAICheckoutOrder>;\n\n  // --- Display ---\n  requestClose?(): void;\n  requestDisplayMode?(params: { mode: 'inline' | 'PiP' | 'fullscreen' }): Promise<void>;\n\n  // --- Messaging ---\n  sendFollowUpMessage?(params: { prompt: string }): void;\n\n  // --- Other ---\n  openExternal?(params: { href: string }): void;\n}\n\n/**\n * Get the `window.openai` runtime if available.\n * Returns `undefined` outside of ChatGPT or in SSR.\n */\nexport function getOpenAIRuntime(): OpenAIRuntime | undefined {\n  if (typeof window !== 'undefined' && 'openai' in window) {\n    return (window as unknown as { openai: OpenAIRuntime }).openai;\n  }\n  return undefined;\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIUploadFileResult } from './openai-types';\n\nexport type { OpenAIUploadFileResult as CreateFileResult };\n\n/**\n * Upload a file from the app UI into the ChatGPT conversation.\n *\n * Wraps `window.openai.uploadFile` which is only available inside ChatGPT.\n * Supported formats: `image/png`, `image/jpeg`, `image/webp`.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useUploadFile } from 'sunpeak/host/chatgpt';\n *\n * function ImageUploader() {\n *   const uploadFile = useUploadFile();\n *\n *   const handleChange = async (e: React.ChangeEvent<HTMLInputElement>) => {\n *     const file = e.currentTarget.files?.[0];\n *     if (!file) return;\n *     const { fileId } = await uploadFile(file);\n *     console.log('Uploaded:', fileId);\n *   };\n *\n *   return <input type=\"file\" accept=\"image/*\" onChange={handleChange} />;\n * }\n * ```\n */\nexport function useUploadFile(): (file: File) => Promise<OpenAIUploadFileResult> {\n  const app = useApp();\n  return useCallback(\n    async (file: File) => {\n      if (!app) {\n        throw new Error('[useUploadFile] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.uploadFile) {\n        throw new Error('[useUploadFile] window.openai.uploadFile not available');\n      }\n      return runtime.uploadFile(file);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIRequestModalParams } from './openai-types';\n\nexport type { OpenAIRequestModalParams as OpenModalParams };\n\n/**\n * Open a host-controlled modal in ChatGPT.\n *\n * Wraps `window.openai.requestModal` which is only available inside ChatGPT.\n * Pass a `template` URL to load alternate UI content in the modal, or omit\n * it to reuse the current UI.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestModal } from 'sunpeak/host/chatgpt';\n *\n * function CheckoutButton() {\n *   const requestModal = useRequestModal();\n *\n *   return (\n *     <button onClick={() => requestModal({ template: 'ui://widget/checkout.html' })}>\n *       Checkout\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useRequestModal(): (params: OpenAIRequestModalParams) => Promise<void> {\n  const app = useApp();\n  return useCallback(\n    async (params: OpenAIRequestModalParams) => {\n      if (!app) {\n        console.warn('[useRequestModal] App not connected');\n        return;\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestModal) {\n        throw new Error('[useRequestModal] window.openai.requestModal not available');\n      }\n      return runtime.requestModal(params);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport {\n  getOpenAIRuntime,\n  type OpenAICheckoutSession,\n  type OpenAICheckoutOrder,\n} from './openai-types';\n\nexport type { OpenAICheckoutSession as CheckoutSession };\nexport type { OpenAICheckoutOrder as CheckoutOrder };\n\n/**\n * Trigger the ChatGPT instant checkout flow.\n *\n * Wraps `window.openai.requestCheckout` which is only available inside\n * ChatGPT. Opens the host checkout UI, handles payment display, and\n * resolves with the finalized order. Rejects on error or user cancel.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestCheckout } from 'sunpeak/host/chatgpt';\n *\n * function BuyButton() {\n *   const requestCheckout = useRequestCheckout();\n *\n *   const handleBuy = async () => {\n *     try {\n *       const order = await requestCheckout({\n *         id: 'session-1',\n *         payment_provider: {\n *           provider: 'stripe',\n *           merchant_id: 'acct_xxx',\n *           supported_payment_methods: ['card', 'apple_pay'],\n *         },\n *         status: 'ready_for_payment',\n *         currency: 'USD',\n *         totals: [{ type: 'total', display_text: 'Total', amount: 999 }],\n *         links: [],\n *         payment_mode: 'live',\n *       });\n *       console.log('Order completed:', order.id);\n *     } catch {\n *       console.log('Checkout cancelled or failed');\n *     }\n *   };\n *\n *   return <button onClick={handleBuy}>Buy Now</button>;\n * }\n * ```\n */\nexport function useRequestCheckout(): (\n  session: OpenAICheckoutSession\n) => Promise<OpenAICheckoutOrder> {\n  const app = useApp();\n  return useCallback(\n    async (session: OpenAICheckoutSession) => {\n      if (!app) {\n        throw new Error('[useRequestCheckout] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestCheckout) {\n        throw new Error('[useRequestCheckout] window.openai.requestCheckout not available');\n      }\n      return runtime.requestCheckout(session);\n    },\n    [app]\n  );\n}\n"],"mappings":";;;;;;;;AAuFA,SAAgB,mBAA8C;AAC5D,KAAI,OAAO,WAAW,eAAe,YAAY,OAC/C,QAAQ,OAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACzD5D,SAAgB,gBAAiE;CAC/E,MAAM,MAAM,QAAQ;AACpB,QAAO,YACL,OAAO,SAAe;AACpB,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,oCAAoC;EAEtD,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,WACZ,OAAM,IAAI,MAAM,yDAAyD;AAE3E,SAAO,QAAQ,WAAW,KAAK;IAEjC,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;AChBH,SAAgB,kBAAuE;CACrF,MAAM,MAAM,QAAQ;AACpB,QAAO,YACL,OAAO,WAAqC;AAC1C,MAAI,CAAC,KAAK;AACR,WAAQ,KAAK,sCAAsC;AACnD;;EAEF,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,aACZ,OAAM,IAAI,MAAM,6DAA6D;AAE/E,SAAO,QAAQ,aAAa,OAAO;IAErC,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACOH,SAAgB,qBAEkB;CAChC,MAAM,MAAM,QAAQ;AACpB,QAAO,YACL,OAAO,YAAmC;AACxC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,yCAAyC;EAE3D,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,gBACZ,OAAM,IAAI,MAAM,mEAAmE;AAErF,SAAO,QAAQ,gBAAgB,QAAQ;IAEzC,CAAC,IAAI,CACN"}

package/dist/host/index.cjs

@@ -6,7 +6,7 @@ require("../chunk-9hOWP6kD.cjs");
 *
 * Detection is based on:
 * 1. Host runtime objects (window.openai for ChatGPT — works in both
-*    real hosts and the simulator when the ChatGPT host shell is active)
+*    real hosts and the inspector when the ChatGPT host shell is active)
 * 2. User agent patterns as fallback
 * 3. Hostname matching as final fallback
 *
@@ -47,11 +47,8 @@ function isChatGPT() {
 function isClaude() {
 	return detectHost() === "claude";
 }
-/** @deprecated Use `detectHost` instead. */
-var detectPlatform = detectHost;
 //#endregion
 exports.detectHost = detectHost;
-exports.detectPlatform = detectPlatform;
 exports.isChatGPT = isChatGPT;
 exports.isClaude = isClaude;
 

package/dist/host/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/host/index.ts"],"sourcesContent":["/**\n * Host detection utilities for MCP Apps.\n *\n * Use these functions to detect which host is running your app\n * and conditionally use host-specific features.\n *\n * @example\n * ```tsx\n * import { isChatGPT } from 'sunpeak/host';\n *\n * function MyResource() {\n *   // Only use ChatGPT-specific features when running on ChatGPT\n *   if (isChatGPT()) {\n *     // Use updateModelContext, etc.\n *   }\n * }\n * ```\n */\n\n/**\n * Supported hosts.\n */\nexport type Host = 'chatgpt' | 'claude' | 'unknown';\n\n/**\n * Detect the current host.\n *\n * Detection is based on:\n * 1. Host runtime objects (window.openai for ChatGPT — works in both\n *    real hosts and the simulator when the ChatGPT host shell is active)\n * 2. User agent patterns as fallback\n * 3. Hostname matching as final fallback\n *\n * @returns The detected host\n */\nexport function detectHost(): Host {\n  // Check if we're in a browser environment\n  if (typeof window === 'undefined') {\n    return 'unknown';\n  }\n\n  // ChatGPT injects window.openai; the simulator does the same when\n  // the ChatGPT host shell is selected. This is the most reliable signal.\n  if ('openai' in window) {\n    return 'chatgpt';\n  }\n\n  // Check user agent patterns for host detection\n  const ua = navigator.userAgent.toLowerCase();\n\n  // ChatGPT iOS/Android apps and web\n  if (ua.includes('chatgpt') || window.location.hostname.includes('chatgpt.com')) {\n    return 'chatgpt';\n  }\n\n  // Claude apps and web\n  if (ua.includes('claude') || window.location.hostname.includes('claude.ai')) {\n    return 'claude';\n  }\n\n  return 'unknown';\n}\n\n/**\n * Check if the app is running in a ChatGPT host.\n *\n * @returns true if running in ChatGPT\n *\n * @example\n * ```tsx\n * import { isChatGPT } from 'sunpeak/host';\n *\n * function MyResource() {\n *   if (isChatGPT()) {\n *     // Use ChatGPT-specific features\n *   }\n * }\n * ```\n */\nexport function isChatGPT(): boolean {\n  return detectHost() === 'chatgpt';\n}\n\n/**\n * Check if the app is running in a Claude host.\n *\n * @returns true if running in Claude\n */\nexport function isClaude(): boolean {\n  return detectHost() === 'claude';\n}\n\n/** @deprecated Use `Host` instead. */\nexport type Platform = Host;\n\n/** @deprecated Use `detectHost` instead. */\nexport const detectPlatform = detectHost;\n"],"mappings":";;;;;;;;;;;;;;AAmCA,SAAgB,aAAmB;AAEjC,KAAI,OAAO,WAAW,YACpB,QAAO;AAKT,KAAI,YAAY,OACd,QAAO;CAIT,MAAM,KAAK,UAAU,UAAU,aAAa;AAG5C,KAAI,GAAG,SAAS,UAAU,IAAI,OAAO,SAAS,SAAS,SAAS,cAAc,CAC5E,QAAO;AAIT,KAAI,GAAG,SAAS,SAAS,IAAI,OAAO,SAAS,SAAS,SAAS,YAAY,CACzE,QAAO;AAGT,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAgB,YAAqB;AACnC,QAAO,YAAY,KAAK;;;;;;;AAQ1B,SAAgB,WAAoB;AAClC,QAAO,YAAY,KAAK;;;AAO1B,IAAa,iBAAiB"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/host/index.ts"],"sourcesContent":["/**\n * Host detection utilities for MCP Apps.\n *\n * Use these functions to detect which host is running your app\n * and conditionally use host-specific features.\n *\n * @example\n * ```tsx\n * import { isChatGPT } from 'sunpeak/host';\n *\n * function MyResource() {\n *   // Only use ChatGPT-specific features when running on ChatGPT\n *   if (isChatGPT()) {\n *     // Use updateModelContext, etc.\n *   }\n * }\n * ```\n */\n\n/**\n * Supported hosts.\n */\nexport type Host = 'chatgpt' | 'claude' | 'unknown';\n\n/**\n * Detect the current host.\n *\n * Detection is based on:\n * 1. Host runtime objects (window.openai for ChatGPT — works in both\n *    real hosts and the inspector when the ChatGPT host shell is active)\n * 2. User agent patterns as fallback\n * 3. Hostname matching as final fallback\n *\n * @returns The detected host\n */\nexport function detectHost(): Host {\n  // Check if we're in a browser environment\n  if (typeof window === 'undefined') {\n    return 'unknown';\n  }\n\n  // ChatGPT injects window.openai; the inspector does the same when\n  // the ChatGPT host shell is selected. This is the most reliable signal.\n  if ('openai' in window) {\n    return 'chatgpt';\n  }\n\n  // Check user agent patterns for host detection\n  const ua = navigator.userAgent.toLowerCase();\n\n  // ChatGPT iOS/Android apps and web\n  if (ua.includes('chatgpt') || window.location.hostname.includes('chatgpt.com')) {\n    return 'chatgpt';\n  }\n\n  // Claude apps and web\n  if (ua.includes('claude') || window.location.hostname.includes('claude.ai')) {\n    return 'claude';\n  }\n\n  return 'unknown';\n}\n\n/**\n * Check if the app is running in a ChatGPT host.\n *\n * @returns true if running in ChatGPT\n *\n * @example\n * ```tsx\n * import { isChatGPT } from 'sunpeak/host';\n *\n * function MyResource() {\n *   if (isChatGPT()) {\n *     // Use ChatGPT-specific features\n *   }\n * }\n * ```\n */\nexport function isChatGPT(): boolean {\n  return detectHost() === 'chatgpt';\n}\n\n/**\n * Check if the app is running in a Claude host.\n *\n * @returns true if running in Claude\n */\nexport function isClaude(): boolean {\n  return detectHost() === 'claude';\n}\n"],"mappings":";;;;;;;;;;;;;;AAmCA,SAAgB,aAAmB;AAEjC,KAAI,OAAO,WAAW,YACpB,QAAO;AAKT,KAAI,YAAY,OACd,QAAO;CAIT,MAAM,KAAK,UAAU,UAAU,aAAa;AAG5C,KAAI,GAAG,SAAS,UAAU,IAAI,OAAO,SAAS,SAAS,SAAS,cAAc,CAC5E,QAAO;AAIT,KAAI,GAAG,SAAS,SAAS,IAAI,OAAO,SAAS,SAAS,SAAS,YAAY,CACzE,QAAO;AAGT,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAgB,YAAqB;AACnC,QAAO,YAAY,KAAK;;;;;;;AAQ1B,SAAgB,WAAoB;AAClC,QAAO,YAAY,KAAK"}

package/dist/host/index.d.ts

@@ -25,7 +25,7 @@ export type Host = 'chatgpt' | 'claude' | 'unknown';
  *
  * Detection is based on:
  * 1. Host runtime objects (window.openai for ChatGPT — works in both
- *    real hosts and the simulator when the ChatGPT host shell is active)
+ *    real hosts and the inspector when the ChatGPT host shell is active)
  * 2. User agent patterns as fallback
  * 3. Hostname matching as final fallback
  *
@@ -55,7 +55,3 @@ export declare function isChatGPT(): boolean;
  * @returns true if running in Claude
  */
 export declare function isClaude(): boolean;
-/** @deprecated Use `Host` instead. */
-export type Platform = Host;
-/** @deprecated Use `detectHost` instead. */
-export declare const detectPlatform: typeof detectHost;

package/dist/host/index.js

@@ -4,7 +4,7 @@
 *
 * Detection is based on:
 * 1. Host runtime objects (window.openai for ChatGPT — works in both
-*    real hosts and the simulator when the ChatGPT host shell is active)
+*    real hosts and the inspector when the ChatGPT host shell is active)
 * 2. User agent patterns as fallback
 * 3. Hostname matching as final fallback
 *
@@ -45,9 +45,7 @@ function isChatGPT() {
 function isClaude() {
 	return detectHost() === "claude";
 }
-/** @deprecated Use `detectHost` instead. */
-var detectPlatform = detectHost;
 //#endregion
-export { detectHost, detectPlatform, isChatGPT, isClaude };
+export { detectHost, isChatGPT, isClaude };
 
 //# sourceMappingURL=index.js.map

package/dist/host/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/host/index.ts"],"sourcesContent":["/**\n * Host detection utilities for MCP Apps.\n *\n * Use these functions to detect which host is running your app\n * and conditionally use host-specific features.\n *\n * @example\n * ```tsx\n * import { isChatGPT } from 'sunpeak/host';\n *\n * function MyResource() {\n *   // Only use ChatGPT-specific features when running on ChatGPT\n *   if (isChatGPT()) {\n *     // Use updateModelContext, etc.\n *   }\n * }\n * ```\n */\n\n/**\n * Supported hosts.\n */\nexport type Host = 'chatgpt' | 'claude' | 'unknown';\n\n/**\n * Detect the current host.\n *\n * Detection is based on:\n * 1. Host runtime objects (window.openai for ChatGPT — works in both\n *    real hosts and the simulator when the ChatGPT host shell is active)\n * 2. User agent patterns as fallback\n * 3. Hostname matching as final fallback\n *\n * @returns The detected host\n */\nexport function detectHost(): Host {\n  // Check if we're in a browser environment\n  if (typeof window === 'undefined') {\n    return 'unknown';\n  }\n\n  // ChatGPT injects window.openai; the simulator does the same when\n  // the ChatGPT host shell is selected. This is the most reliable signal.\n  if ('openai' in window) {\n    return 'chatgpt';\n  }\n\n  // Check user agent patterns for host detection\n  const ua = navigator.userAgent.toLowerCase();\n\n  // ChatGPT iOS/Android apps and web\n  if (ua.includes('chatgpt') || window.location.hostname.includes('chatgpt.com')) {\n    return 'chatgpt';\n  }\n\n  // Claude apps and web\n  if (ua.includes('claude') || window.location.hostname.includes('claude.ai')) {\n    return 'claude';\n  }\n\n  return 'unknown';\n}\n\n/**\n * Check if the app is running in a ChatGPT host.\n *\n * @returns true if running in ChatGPT\n *\n * @example\n * ```tsx\n * import { isChatGPT } from 'sunpeak/host';\n *\n * function MyResource() {\n *   if (isChatGPT()) {\n *     // Use ChatGPT-specific features\n *   }\n * }\n * ```\n */\nexport function isChatGPT(): boolean {\n  return detectHost() === 'chatgpt';\n}\n\n/**\n * Check if the app is running in a Claude host.\n *\n * @returns true if running in Claude\n */\nexport function isClaude(): boolean {\n  return detectHost() === 'claude';\n}\n\n/** @deprecated Use `Host` instead. */\nexport type Platform = Host;\n\n/** @deprecated Use `detectHost` instead. */\nexport const detectPlatform = detectHost;\n"],"mappings":";;;;;;;;;;;;AAmCA,SAAgB,aAAmB;AAEjC,KAAI,OAAO,WAAW,YACpB,QAAO;AAKT,KAAI,YAAY,OACd,QAAO;CAIT,MAAM,KAAK,UAAU,UAAU,aAAa;AAG5C,KAAI,GAAG,SAAS,UAAU,IAAI,OAAO,SAAS,SAAS,SAAS,cAAc,CAC5E,QAAO;AAIT,KAAI,GAAG,SAAS,SAAS,IAAI,OAAO,SAAS,SAAS,SAAS,YAAY,CACzE,QAAO;AAGT,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAgB,YAAqB;AACnC,QAAO,YAAY,KAAK;;;;;;;AAQ1B,SAAgB,WAAoB;AAClC,QAAO,YAAY,KAAK;;;AAO1B,IAAa,iBAAiB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/host/index.ts"],"sourcesContent":["/**\n * Host detection utilities for MCP Apps.\n *\n * Use these functions to detect which host is running your app\n * and conditionally use host-specific features.\n *\n * @example\n * ```tsx\n * import { isChatGPT } from 'sunpeak/host';\n *\n * function MyResource() {\n *   // Only use ChatGPT-specific features when running on ChatGPT\n *   if (isChatGPT()) {\n *     // Use updateModelContext, etc.\n *   }\n * }\n * ```\n */\n\n/**\n * Supported hosts.\n */\nexport type Host = 'chatgpt' | 'claude' | 'unknown';\n\n/**\n * Detect the current host.\n *\n * Detection is based on:\n * 1. Host runtime objects (window.openai for ChatGPT — works in both\n *    real hosts and the inspector when the ChatGPT host shell is active)\n * 2. User agent patterns as fallback\n * 3. Hostname matching as final fallback\n *\n * @returns The detected host\n */\nexport function detectHost(): Host {\n  // Check if we're in a browser environment\n  if (typeof window === 'undefined') {\n    return 'unknown';\n  }\n\n  // ChatGPT injects window.openai; the inspector does the same when\n  // the ChatGPT host shell is selected. This is the most reliable signal.\n  if ('openai' in window) {\n    return 'chatgpt';\n  }\n\n  // Check user agent patterns for host detection\n  const ua = navigator.userAgent.toLowerCase();\n\n  // ChatGPT iOS/Android apps and web\n  if (ua.includes('chatgpt') || window.location.hostname.includes('chatgpt.com')) {\n    return 'chatgpt';\n  }\n\n  // Claude apps and web\n  if (ua.includes('claude') || window.location.hostname.includes('claude.ai')) {\n    return 'claude';\n  }\n\n  return 'unknown';\n}\n\n/**\n * Check if the app is running in a ChatGPT host.\n *\n * @returns true if running in ChatGPT\n *\n * @example\n * ```tsx\n * import { isChatGPT } from 'sunpeak/host';\n *\n * function MyResource() {\n *   if (isChatGPT()) {\n *     // Use ChatGPT-specific features\n *   }\n * }\n * ```\n */\nexport function isChatGPT(): boolean {\n  return detectHost() === 'chatgpt';\n}\n\n/**\n * Check if the app is running in a Claude host.\n *\n * @returns true if running in Claude\n */\nexport function isClaude(): boolean {\n  return detectHost() === 'claude';\n}\n"],"mappings":";;;;;;;;;;;;AAmCA,SAAgB,aAAmB;AAEjC,KAAI,OAAO,WAAW,YACpB,QAAO;AAKT,KAAI,YAAY,OACd,QAAO;CAIT,MAAM,KAAK,UAAU,UAAU,aAAa;AAG5C,KAAI,GAAG,SAAS,UAAU,IAAI,OAAO,SAAS,SAAS,SAAS,cAAc,CAC5E,QAAO;AAIT,KAAI,GAAG,SAAS,SAAS,IAAI,OAAO,SAAS,SAAS,SAAS,YAAY,CACzE,QAAO;AAGT,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAgB,YAAqB;AACnC,QAAO,YAAY,KAAK;;;;;;;AAQ1B,SAAgB,WAAoB;AAClC,QAAO,YAAY,KAAK"}

package/dist/index.cjs

@@ -2,9 +2,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-9hOWP6kD.cjs");
 const require_protocol = require("./protocol-jbxhzcnS.cjs");
 const require_use_app = require("./use-app-D2h-aiyr.cjs");
-const require_simulator = require("./simulator-eU6sQTje.cjs");
+const require_inspector = require("./inspector-CByJjmPD.cjs");
 const require_host_index = require("./host/index.cjs");
-const require_simulator_index = require("./simulator/index.cjs");
+const require_inspector_index = require("./inspector/index.cjs");
 const require_chatgpt_index = require("./chatgpt/index.cjs");
 let react = require("react");
 react = require_chunk.__toESM(react);
@@ -389,7 +389,7 @@ var registries$1 = /* @__PURE__ */ new WeakMap();
 * Host-provided variables override defaults since they're applied after.
 */
 function applyStyles(variables) {
-	require_use_app.PQ(require_simulator.DEFAULT_STYLE_VARIABLES);
+	require_use_app.PQ(require_inspector.DEFAULT_STYLE_VARIABLES);
 	if (variables) require_use_app.PQ(variables);
 }
 function getRegistry$1(app) {
@@ -3234,19 +3234,18 @@ Object.defineProperty(exports, "chatgpt", {
 });
 exports.cn = cn;
 exports.detectHost = require_host_index.detectHost;
-exports.detectPlatform = require_host_index.detectPlatform;
 exports.getDocumentTheme = require_use_app.AQ;
+Object.defineProperty(exports, "inspector", {
+	enumerable: true,
+	get: function() {
+		return require_inspector_index.inspector_exports;
+	}
+});
 exports.isChatGPT = require_host_index.isChatGPT;
 exports.isClaude = require_host_index.isClaude;
 exports.isHoverAvailable = isHoverAvailable;
 exports.isPrimarilyTouchDevice = isPrimarilyTouchDevice;
 exports.prefersReducedMotion = prefersReducedMotion;
-Object.defineProperty(exports, "simulator", {
-	enumerable: true,
-	get: function() {
-		return require_simulator_index.simulator_exports;
-	}
-});
 exports.useApp = require_use_app.useApp;
 exports.useAppState = useAppState;
 exports.useAppTools = useAppTools;