sunpeak 0.16.24 → 0.16.28

package/dist/simulator/hosts.d.ts

@@ -22,10 +22,14 @@ export interface HostConversationProps {
     appIcon?: string;
     /** User message to show in the conversation (decorative) */
     userMessage?: string;
-    /** Whether content is transitioning between display modes */
-    isTransitioning?: boolean;
     /** Optional action element rendered in the conversation header (e.g., Run button in Prod Tools mode) */
     headerAction?: React.ReactNode;
+    /**
+     * Called when the content container width changes (via ResizeObserver).
+     * The simulator uses this to set containerDimensions.maxWidth in hostContext,
+     * matching what real hosts report to apps.
+     */
+    onContentWidthChange?: (width: number) => void;
 }
 /** Unique identifier for a host */
 export type HostId = 'chatgpt' | 'claude' | (string & {});
@@ -49,6 +53,11 @@ export interface HostShell {
     };
     /** Host capabilities reported to the app via MCP protocol */
     hostCapabilities: McpUiHostCapabilities;
+    /**
+     * User agent string sent to the app via hostContext.userAgent.
+     * Real hosts send identifiers like "chatgpt" or "claude".
+     */
+    userAgent?: string;
     /**
      * MCP App style variables sent to the app via hostContext.styles.variables.
      * Uses CSS light-dark() values so a single set adapts to theme automatically.

package/dist/simulator/iframe-resource.d.ts

@@ -102,6 +102,13 @@ interface IframeResourceProps {
      * and isChatGPT() will work inside the iframe.
      */
     injectOpenAIRuntime?: boolean;
+    /**
+     * Base URL of the separate-origin sandbox server (e.g., "http://localhost:24680").
+     * When provided, the outer iframe loads from this server instead of using srcdoc,
+     * giving real cross-origin isolation that matches production hosts like ChatGPT.
+     * Falls back to srcdoc when not provided (unit tests, embedded usage).
+     */
+    sandboxUrl?: string;
 }
 /**
  * IframeResource renders MCP Apps in an iframe, communicating via the
@@ -115,7 +122,7 @@ interface IframeResourceProps {
  * connects via PostMessageTransport to window.parent. The parent side uses
  * McpAppHost (wrapping AppBridge) to communicate.
  */
-export declare function IframeResource({ src, scriptSrc, hostContext, toolInput, toolInputPartial, toolResult, hostOptions, csp, permissions, prefersBorder, className, style, onDisplayModeReady, debugInjectState, injectOpenAIRuntime, }: IframeResourceProps): import("react/jsx-runtime").JSX.Element;
+export declare function IframeResource({ src, scriptSrc, hostContext, toolInput, toolInputPartial, toolResult, hostOptions, csp, permissions, prefersBorder, className, style, onDisplayModeReady, debugInjectState, injectOpenAIRuntime, sandboxUrl, }: IframeResourceProps): import("react/jsx-runtime").JSX.Element;
 export declare const _testExports: {
     escapeHtml: typeof escapeHtml;
     isAllowedUrl: typeof isAllowedUrl;

package/dist/simulator/index.cjs

@@ -1,37 +1,80 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const simulator = require("../simulator-DRUsm6IZ.cjs");
-const simulatorUrl = require("../simulator-url-DcSYRl-P.cjs");
-const discovery = require("../discovery-D1gpaVz4.cjs");
-exports.IframeResource = simulator.IframeResource;
-exports.McpAppHost = simulator.McpAppHost;
-exports.SCREEN_WIDTHS = simulator.SCREEN_WIDTHS;
-exports.SidebarCheckbox = simulator.SidebarCheckbox;
-exports.SidebarCollapsibleControl = simulator.SidebarCollapsibleControl;
-exports.SidebarControl = simulator.SidebarControl;
-exports.SidebarInput = simulator.SidebarInput;
-exports.SidebarSelect = simulator.SidebarSelect;
-exports.SidebarTextarea = simulator.SidebarTextarea;
-exports.SidebarToggle = simulator.SidebarToggle;
-exports.SimpleSidebar = simulator.SimpleSidebar;
-exports.Simulator = simulator.Simulator;
-exports.ThemeProvider = simulator.ThemeProvider;
-exports.extractResourceCSP = simulator.extractResourceCSP;
-exports.getHostShell = simulator.getHostShell;
-exports.getRegisteredHosts = simulator.getRegisteredHosts;
-exports.registerHostShell = simulator.registerHostShell;
-exports.resolveServerToolResult = simulator.resolveServerToolResult;
-exports.useSimulatorState = simulator.useSimulatorState;
-exports.useThemeContext = simulator.useThemeContext;
-exports.createSimulatorUrl = simulatorUrl.createSimulatorUrl;
-exports.buildDevSimulations = discovery.buildDevSimulations;
-exports.buildResourceMap = discovery.buildResourceMap;
-exports.buildSimulations = discovery.buildSimulations;
-exports.createResourceExports = discovery.createResourceExports;
-exports.extractResourceKey = discovery.extractResourceKey;
-exports.extractSimulationKey = discovery.extractSimulationKey;
-exports.findResourceDirs = discovery.findResourceDirs;
-exports.findResourceKey = discovery.findResourceKey;
-exports.getComponentName = discovery.getComponentName;
-exports.toPascalCase = discovery.toPascalCase;
-//# sourceMappingURL=index.cjs.map
+const require_chunk = require("../chunk-9hOWP6kD.cjs");
+require("../protocol-jbxhzcnS.cjs");
+const require_simulator = require("../simulator-BYIH-xqQ.cjs");
+const require_discovery = require("../discovery-BxKCIgG5.cjs");
+const require_simulator_url = require("../simulator-url-BDGD4vZD.cjs");
+//#region src/simulator/index.ts
+var simulator_exports = /* @__PURE__ */ require_chunk.__exportAll({
+	IframeResource: () => require_simulator.IframeResource,
+	McpAppHost: () => require_simulator.McpAppHost,
+	SCREEN_WIDTHS: () => require_simulator.SCREEN_WIDTHS,
+	SidebarCheckbox: () => require_simulator.SidebarCheckbox,
+	SidebarCollapsibleControl: () => require_simulator.SidebarCollapsibleControl,
+	SidebarControl: () => require_simulator.SidebarControl,
+	SidebarInput: () => require_simulator.SidebarInput,
+	SidebarSelect: () => require_simulator.SidebarSelect,
+	SidebarTextarea: () => require_simulator.SidebarTextarea,
+	SidebarToggle: () => require_simulator.SidebarToggle,
+	SimpleSidebar: () => require_simulator.SimpleSidebar,
+	Simulator: () => require_simulator.Simulator,
+	ThemeProvider: () => require_simulator.ThemeProvider,
+	buildDevSimulations: () => require_discovery.buildDevSimulations,
+	buildResourceMap: () => require_discovery.buildResourceMap,
+	buildSimulations: () => require_discovery.buildSimulations,
+	createResourceExports: () => require_discovery.createResourceExports,
+	createSimulatorUrl: () => require_simulator_url.createSimulatorUrl,
+	extractResourceCSP: () => require_simulator.extractResourceCSP,
+	extractResourceKey: () => require_discovery.extractResourceKey,
+	extractSimulationKey: () => require_discovery.extractSimulationKey,
+	findResourceDirs: () => require_discovery.findResourceDirs,
+	findResourceKey: () => require_discovery.findResourceKey,
+	getComponentName: () => require_discovery.getComponentName,
+	getHostShell: () => require_simulator.getHostShell,
+	getRegisteredHosts: () => require_simulator.getRegisteredHosts,
+	registerHostShell: () => require_simulator.registerHostShell,
+	resolveServerToolResult: () => require_simulator.resolveServerToolResult,
+	toPascalCase: () => require_discovery.toPascalCase,
+	useSimulatorState: () => require_simulator.useSimulatorState,
+	useThemeContext: () => require_simulator.useThemeContext
+});
+//#endregion
+exports.IframeResource = require_simulator.IframeResource;
+exports.McpAppHost = require_simulator.McpAppHost;
+exports.SCREEN_WIDTHS = require_simulator.SCREEN_WIDTHS;
+exports.SidebarCheckbox = require_simulator.SidebarCheckbox;
+exports.SidebarCollapsibleControl = require_simulator.SidebarCollapsibleControl;
+exports.SidebarControl = require_simulator.SidebarControl;
+exports.SidebarInput = require_simulator.SidebarInput;
+exports.SidebarSelect = require_simulator.SidebarSelect;
+exports.SidebarTextarea = require_simulator.SidebarTextarea;
+exports.SidebarToggle = require_simulator.SidebarToggle;
+exports.SimpleSidebar = require_simulator.SimpleSidebar;
+exports.Simulator = require_simulator.Simulator;
+exports.ThemeProvider = require_simulator.ThemeProvider;
+exports.buildDevSimulations = require_discovery.buildDevSimulations;
+exports.buildResourceMap = require_discovery.buildResourceMap;
+exports.buildSimulations = require_discovery.buildSimulations;
+exports.createResourceExports = require_discovery.createResourceExports;
+exports.createSimulatorUrl = require_simulator_url.createSimulatorUrl;
+exports.extractResourceCSP = require_simulator.extractResourceCSP;
+exports.extractResourceKey = require_discovery.extractResourceKey;
+exports.extractSimulationKey = require_discovery.extractSimulationKey;
+exports.findResourceDirs = require_discovery.findResourceDirs;
+exports.findResourceKey = require_discovery.findResourceKey;
+exports.getComponentName = require_discovery.getComponentName;
+exports.getHostShell = require_simulator.getHostShell;
+exports.getRegisteredHosts = require_simulator.getRegisteredHosts;
+exports.registerHostShell = require_simulator.registerHostShell;
+exports.resolveServerToolResult = require_simulator.resolveServerToolResult;
+Object.defineProperty(exports, "simulator_exports", {
+	enumerable: true,
+	get: function() {
+		return simulator_exports;
+	}
+});
+exports.toPascalCase = require_discovery.toPascalCase;
+exports.useSimulatorState = require_simulator.useSimulatorState;
+exports.useThemeContext = require_simulator.useThemeContext;
+
+//# sourceMappingURL=index.cjs.map

package/dist/simulator/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/simulator/index.ts"],"sourcesContent":["/**\n * Generic multi-host simulator for Sunpeak MCP Apps.\n *\n * The Simulator component provides a dev environment for testing MCP Apps\n * against multiple host platforms (ChatGPT, Claude, etc.).\n *\n * @example\n * ```tsx\n * import { simulator } from 'sunpeak';\n * const { Simulator, buildDevSimulations } = simulator;\n *\n * <Simulator simulations={simulations} appName=\"My App\" />\n * ```\n *\n * @module sunpeak/simulator\n */\n\n// Register built-in host shells\nimport '../chatgpt/chatgpt-host';\nimport '../claude/claude-host';\n\n// Core simulator component\nexport { Simulator } from './simulator';\nexport type { SimulatorProps } from './simulator';\n\n// State hook (for custom simulator builds)\nexport { useSimulatorState } from './use-simulator-state';\nexport type { UseSimulatorStateOptions, SimulatorState } from './use-simulator-state';\n\n// Host shell system\nexport { registerHostShell, getHostShell, getRegisteredHosts } from './hosts';\nexport type { HostConversationProps, HostShell, HostId } from './hosts';\n\n// Infrastructure\nexport { McpAppHost } from './mcp-app-host';\nexport type { McpAppHostOptions } from './mcp-app-host';\nexport { IframeResource, extractResourceCSP } from './iframe-resource';\nexport type { ResourceCSP } from './iframe-resource';\nexport { ThemeProvider, useThemeContext } from './theme-provider';\n\n// Simulation types & resolution\nexport type { Simulation, ServerToolMock } from '../types/simulation';\nexport { resolveServerToolResult } from '../types/simulation';\n\n// Types & URL helpers\nexport type { ScreenWidth, SimulatorConfig } from './simulator-types';\nexport { SCREEN_WIDTHS } from './simulator-types';\nexport { createSimulatorUrl } from './simulator-url';\nexport type { SimulatorUrlParams } from './simulator-url';\n\n// Sidebar components (for building custom simulators)\nexport {\n  SimpleSidebar,\n  SidebarControl,\n  SidebarCollapsibleControl,\n  SidebarSelect,\n  SidebarInput,\n  SidebarCheckbox,\n  SidebarTextarea,\n  SidebarToggle,\n} from './simple-sidebar';\n\n// Discovery utilities for building simulations\nexport {\n  buildDevSimulations,\n  buildSimulations,\n  buildResourceMap,\n  createResourceExports,\n  toPascalCase,\n  extractResourceKey,\n  extractSimulationKey,\n  findResourceKey,\n  getComponentName,\n  findResourceDirs,\n} from '../lib/discovery';\nexport type {\n  BuildSimulationsOptions,\n  BuildDevSimulationsOptions,\n  ResourceMetadata,\n  ResourceDirInfo,\n  FsOps,\n} from '../lib/discovery';\n"],"mappings":""}

package/dist/simulator/index.js

@@ -1,37 +1,43 @@
-import { I, M, a, b, c, d, e, f, g, h, i, S, T, j, k, l, r, m, u, n } from "../simulator-BCq2iOT-.js";
-import { c as c2 } from "../simulator-url-j_XV3EoP.js";
-import { b as b2, a as a2, c as c3, d as d2, e as e2, f as f2, g as g2, h as h2, i as i2, t } from "../discovery-BVqD-JsT.js";
-export {
-  I as IframeResource,
-  M as McpAppHost,
-  a as SCREEN_WIDTHS,
-  b as SidebarCheckbox,
-  c as SidebarCollapsibleControl,
-  d as SidebarControl,
-  e as SidebarInput,
-  f as SidebarSelect,
-  g as SidebarTextarea,
-  h as SidebarToggle,
-  i as SimpleSidebar,
-  S as Simulator,
-  T as ThemeProvider,
-  b2 as buildDevSimulations,
-  a2 as buildResourceMap,
-  c3 as buildSimulations,
-  d2 as createResourceExports,
-  c2 as createSimulatorUrl,
-  j as extractResourceCSP,
-  e2 as extractResourceKey,
-  f2 as extractSimulationKey,
-  g2 as findResourceDirs,
-  h2 as findResourceKey,
-  i2 as getComponentName,
-  k as getHostShell,
-  l as getRegisteredHosts,
-  r as registerHostShell,
-  m as resolveServerToolResult,
-  t as toPascalCase,
-  u as useSimulatorState,
-  n as useThemeContext
-};
-//# sourceMappingURL=index.js.map
+import { r as __exportAll } from "../chunk-D6g4UhsZ.js";
+import "../protocol-DJmRaBzO.js";
+import { _ as SCREEN_WIDTHS, a as SidebarControl, b as registerHostShell, c as SidebarTextarea, d as ThemeProvider, f as useThemeContext, g as McpAppHost, h as extractResourceCSP, i as SidebarCollapsibleControl, l as SidebarToggle, m as IframeResource, n as resolveServerToolResult, o as SidebarInput, p as useSimulatorState, r as SidebarCheckbox, s as SidebarSelect, t as Simulator, u as SimpleSidebar, v as getHostShell, y as getRegisteredHosts } from "../simulator-CmgNnWBO.js";
+import { a as extractResourceKey, c as findResourceKey, d as getComponentName, f as toPascalCase, i as createResourceExports, n as buildResourceMap, o as extractSimulationKey, r as buildSimulations, s as findResourceDirs, t as buildDevSimulations } from "../discovery-Du4LHrih.js";
+import { t as createSimulatorUrl } from "../simulator-url-Bkxj43yT.js";
+//#region src/simulator/index.ts
+var simulator_exports = /* @__PURE__ */ __exportAll({
+	IframeResource: () => IframeResource,
+	McpAppHost: () => McpAppHost,
+	SCREEN_WIDTHS: () => SCREEN_WIDTHS,
+	SidebarCheckbox: () => SidebarCheckbox,
+	SidebarCollapsibleControl: () => SidebarCollapsibleControl,
+	SidebarControl: () => SidebarControl,
+	SidebarInput: () => SidebarInput,
+	SidebarSelect: () => SidebarSelect,
+	SidebarTextarea: () => SidebarTextarea,
+	SidebarToggle: () => SidebarToggle,
+	SimpleSidebar: () => SimpleSidebar,
+	Simulator: () => Simulator,
+	ThemeProvider: () => ThemeProvider,
+	buildDevSimulations: () => buildDevSimulations,
+	buildResourceMap: () => buildResourceMap,
+	buildSimulations: () => buildSimulations,
+	createResourceExports: () => createResourceExports,
+	createSimulatorUrl: () => createSimulatorUrl,
+	extractResourceCSP: () => extractResourceCSP,
+	extractResourceKey: () => extractResourceKey,
+	extractSimulationKey: () => extractSimulationKey,
+	findResourceDirs: () => findResourceDirs,
+	findResourceKey: () => findResourceKey,
+	getComponentName: () => getComponentName,
+	getHostShell: () => getHostShell,
+	getRegisteredHosts: () => getRegisteredHosts,
+	registerHostShell: () => registerHostShell,
+	resolveServerToolResult: () => resolveServerToolResult,
+	toPascalCase: () => toPascalCase,
+	useSimulatorState: () => useSimulatorState,
+	useThemeContext: () => useThemeContext
+});
+//#endregion
+export { IframeResource, McpAppHost, SCREEN_WIDTHS, SidebarCheckbox, SidebarCollapsibleControl, SidebarControl, SidebarInput, SidebarSelect, SidebarTextarea, SidebarToggle, SimpleSidebar, Simulator, ThemeProvider, buildDevSimulations, buildResourceMap, buildSimulations, createResourceExports, createSimulatorUrl, extractResourceCSP, extractResourceKey, extractSimulationKey, findResourceDirs, findResourceKey, getComponentName, getHostShell, getRegisteredHosts, registerHostShell, resolveServerToolResult, simulator_exports as t, toPascalCase, useSimulatorState, useThemeContext };
+
+//# sourceMappingURL=index.js.map

package/dist/simulator/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/simulator/index.ts"],"sourcesContent":["/**\n * Generic multi-host simulator for Sunpeak MCP Apps.\n *\n * The Simulator component provides a dev environment for testing MCP Apps\n * against multiple host platforms (ChatGPT, Claude, etc.).\n *\n * @example\n * ```tsx\n * import { simulator } from 'sunpeak';\n * const { Simulator, buildDevSimulations } = simulator;\n *\n * <Simulator simulations={simulations} appName=\"My App\" />\n * ```\n *\n * @module sunpeak/simulator\n */\n\n// Register built-in host shells\nimport '../chatgpt/chatgpt-host';\nimport '../claude/claude-host';\n\n// Core simulator component\nexport { Simulator } from './simulator';\nexport type { SimulatorProps } from './simulator';\n\n// State hook (for custom simulator builds)\nexport { useSimulatorState } from './use-simulator-state';\nexport type { UseSimulatorStateOptions, SimulatorState } from './use-simulator-state';\n\n// Host shell system\nexport { registerHostShell, getHostShell, getRegisteredHosts } from './hosts';\nexport type { HostConversationProps, HostShell, HostId } from './hosts';\n\n// Infrastructure\nexport { McpAppHost } from './mcp-app-host';\nexport type { McpAppHostOptions } from './mcp-app-host';\nexport { IframeResource, extractResourceCSP } from './iframe-resource';\nexport type { ResourceCSP } from './iframe-resource';\nexport { ThemeProvider, useThemeContext } from './theme-provider';\n\n// Simulation types & resolution\nexport type { Simulation, ServerToolMock } from '../types/simulation';\nexport { resolveServerToolResult } from '../types/simulation';\n\n// Types & URL helpers\nexport type { ScreenWidth, SimulatorConfig } from './simulator-types';\nexport { SCREEN_WIDTHS } from './simulator-types';\nexport { createSimulatorUrl } from './simulator-url';\nexport type { SimulatorUrlParams } from './simulator-url';\n\n// Sidebar components (for building custom simulators)\nexport {\n  SimpleSidebar,\n  SidebarControl,\n  SidebarCollapsibleControl,\n  SidebarSelect,\n  SidebarInput,\n  SidebarCheckbox,\n  SidebarTextarea,\n  SidebarToggle,\n} from './simple-sidebar';\n\n// Discovery utilities for building simulations\nexport {\n  buildDevSimulations,\n  buildSimulations,\n  buildResourceMap,\n  createResourceExports,\n  toPascalCase,\n  extractResourceKey,\n  extractSimulationKey,\n  findResourceKey,\n  getComponentName,\n  findResourceDirs,\n} from '../lib/discovery';\nexport type {\n  BuildSimulationsOptions,\n  BuildDevSimulationsOptions,\n  ResourceMetadata,\n  ResourceDirInfo,\n  FsOps,\n} from '../lib/discovery';\n"],"mappings":""}

package/dist/simulator/mcp-app-host.d.ts

@@ -22,6 +22,11 @@ export interface McpAppHostOptions {
     onDownloadFile?: (contents: unknown[]) => void;
     /** Called after the iframe confirms rendering in a new display mode (paint fence resolved). */
     onDisplayModeReady?: (mode: string) => void;
+    /**
+     * Called when the sandbox proxy signals readiness (double-iframe mode).
+     * The host should respond by sending HTML content via sendSandboxResourceReady().
+     */
+    onSandboxReady?: () => void;
 }
 /**
  * MCP Apps host for the Sunpeak simulator.
@@ -81,6 +86,18 @@ export declare class McpAppHost {
      * Simulates user or host cancelling a tool execution.
      */
     sendToolCancelled(reason?: string): void;
+    /**
+     * Send HTML resource to the sandbox proxy for secure loading.
+     * Used in the double-iframe architecture after the proxy signals readiness.
+     */
+    sendSandboxResourceReady(params: {
+        html: string;
+        sandbox?: string;
+    }): void;
+    /**
+     * Send a custom message to the connected iframe (for sandbox proxy commands).
+     */
+    sendRawMessage(data: unknown): void;
     /**
      * Close the connection.
      */

package/dist/simulator/sandbox-proxy.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Sandbox proxy for the double-iframe architecture.
+ *
+ * Real hosts (ChatGPT, Claude) use a two-level iframe structure:
+ *   1. Outer iframe (sandbox proxy) — acts as a message relay on a separate origin
+ *   2. Inner iframe — loads the untrusted app HTML
+ *
+ * The proxy relays PostMessage between the host (parent) and the app (inner iframe),
+ * providing origin isolation and security boundaries.
+ *
+ * The simulator replicates this architecture so apps are tested under the same
+ * iframe nesting they'll encounter in production.
+ *
+ * Protocol:
+ *   1. Host creates outer iframe with proxy HTML (srcdoc)
+ *   2. Proxy sends `ui/notifications/sandbox-proxy-ready` to parent
+ *   3. Host sends `ui/notifications/sandbox-resource-ready` with { html, sandbox, csp, permissions }
+ *      OR `sunpeak/sandbox-load-src` with { src } for dev mode
+ *   4. Proxy creates inner iframe and loads the content
+ *   5. All subsequent messages relay transparently between parent and inner iframe
+ */
+/**
+ * Generate the sandbox proxy HTML.
+ *
+ * This HTML is loaded into the outer iframe via srcdoc. It:
+ *   - Signals readiness via `ui/notifications/sandbox-proxy-ready`
+ *   - Listens for resource content or URL to load into the inner iframe
+ *   - Relays all PostMessage between parent and inner iframe
+ *   - Optionally injects platform runtime scripts (e.g., mock window.openai)
+ *
+ * @param platformScript - Optional JS to inject into the inner iframe before the app loads
+ */
+export declare function generateSandboxProxyHtml(platformScript?: string): string;
+/**
+ * The mock OpenAI runtime script body for injection into the inner iframe.
+ * Re-exported from mock-openai-runtime so the proxy can inject it.
+ */
+export { MOCK_OPENAI_RUNTIME_SCRIPT } from './mock-openai-runtime';

package/dist/simulator/simulator.d.ts

@@ -20,5 +20,11 @@ export interface SimulatorProps {
     defaultProdResources?: boolean;
     /** Hide Prod Tools and Prod Resources toggles in the sidebar (e.g., for marketing/embedded use). */
     hideSimulatorModes?: boolean;
+    /**
+     * Base URL of the separate-origin sandbox server (e.g., "http://localhost:24680").
+     * When provided, the outer iframe loads from this URL instead of using srcdoc,
+     * giving real cross-origin isolation that matches production hosts.
+     */
+    sandboxUrl?: string;
 }
-export declare function Simulator({ children, simulations, appName, appIcon, defaultHost, onCallTool, defaultProdTools, defaultProdResources, hideSimulatorModes, }: SimulatorProps): import("react/jsx-runtime").JSX.Element;
+export declare function Simulator({ children, simulations, appName, appIcon, defaultHost, onCallTool, defaultProdTools, defaultProdResources, hideSimulatorModes, sandboxUrl, }: SimulatorProps): import("react/jsx-runtime").JSX.Element;

package/dist/simulator/use-simulator-state.d.ts

@@ -53,9 +53,7 @@ export interface SimulatorState {
     timeZone: string;
     setTimeZone: (tz: string) => void;
     hostContext: McpUiHostContext;
-    readyDisplayMode: McpUiDisplayMode;
     handleDisplayModeReady: (mode: string) => void;
-    isTransitioning: boolean;
     toolInput: Record<string, unknown>;
     setToolInput: (input: Record<string, unknown>) => void;
     toolResult: CallToolResult | undefined;
@@ -79,6 +77,8 @@ export interface SimulatorState {
     setEditingField: (field: string | null) => void;
     validateJSON: (json: string, setJson: (value: string) => void, setError: (error: string) => void) => void;
     commitJSON: (json: string, setError: (error: string) => void, updateFn: (value: Record<string, unknown> | null) => void) => void;
+    measuredContentWidth: number | undefined;
+    handleContentWidthChange: (width: number) => void;
     handleDisplayModeChange: (mode: McpUiDisplayMode) => void;
     handleUpdateModelContext: (content: unknown[], structuredContent?: unknown) => void;
     resourceUrl: string | undefined;
@@ -86,8 +86,6 @@ export interface SimulatorState {
     csp: ResourceCSP | undefined;
     permissions: McpUiResourcePermissions | undefined;
     prefersBorder: boolean;
-    domain: string | undefined;
-    hasIframeContent: boolean;
     urlProdTools: boolean | undefined;
     urlProdResources: boolean | undefined;
 }