sunpeak 0.17.6 → 0.18.1

package/dist/{simulator → inspector}/hosts.d.ts

@@ -1,5 +1,5 @@
 import { McpUiDisplayMode, McpUiHostContext, McpUiHostCapabilities, McpUiStyles } from '@modelcontextprotocol/ext-apps';
-import { ScreenWidth } from './simulator-types';
+import { ScreenWidth } from './inspector-types';
 type Platform = NonNullable<McpUiHostContext['platform']>;
 /**
  * Props passed to a host shell (conversation chrome) component.
@@ -26,7 +26,7 @@ export interface HostConversationProps {
     headerAction?: React.ReactNode;
     /**
      * Called when the content container width changes (via ResizeObserver).
-     * The simulator uses this to set containerDimensions.maxWidth in hostContext,
+     * The inspector uses this to set containerDimensions.maxWidth in hostContext,
      * matching what real hosts report to apps.
      */
     onContentWidthChange?: (width: number) => void;
@@ -66,7 +66,7 @@ export interface HostShell {
      */
     styleVariables?: McpUiStyles;
     /**
-     * CSS custom properties for the simulator page chrome (sidebar, conversation area).
+     * CSS custom properties for the inspector page chrome (sidebar, conversation area).
      * These are applied to the document root and can override the defaults:
      *   --sim-bg-sidebar       (fallback: var(--color-background-secondary))
      *   --sim-bg-conversation  (fallback: var(--color-background-primary))

package/dist/{simulator → inspector}/iframe-resource.d.ts

@@ -48,7 +48,7 @@ declare function generateScriptHtml(scriptSrc: string, theme: string, cspPolicy:
 /**
  * Build the iframe `allow` attribute from resource-declared permissions.
  * Maps McpUiResourcePermissions to Permission Policy directives and
- * combines them with simulator baseline permissions.
+ * combines them with inspector baseline permissions.
  */
 declare function buildIframeAllow(permissions: McpUiResourcePermissions | undefined): string;
 interface IframeResourceProps {
@@ -87,13 +87,13 @@ interface IframeResourceProps {
     /**
      * Called after the iframe has rendered following a display mode change.
      * The callback receives the display mode that was confirmed.
-     * Used by the simulator to hide content during transitions and only
+     * Used by the inspector to hide content during transitions and only
      * reveal it once the app has committed its DOM for the new mode.
      */
     onDisplayModeReady?: (mode: string) => void;
     /**
      * Debug: State to inject directly into the app's useAppState hook.
-     * This bypasses the normal MCP Apps protocol and is for simulator testing.
+     * This bypasses the normal MCP Apps protocol and is for inspector testing.
      */
     debugInjectState?: Record<string, unknown> | null;
     /**

package/dist/inspector/index.cjs

@@ -0,0 +1,74 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_chunk = require("../chunk-9hOWP6kD.cjs");
+require("../protocol-jbxhzcnS.cjs");
+const require_inspector = require("../inspector-CByJjmPD.cjs");
+const require_inspector_url = require("../inspector-url-7qhtJwY6.cjs");
+const require_discovery = require("../discovery-Clu4uHp1.cjs");
+//#region src/inspector/index.ts
+var inspector_exports = /* @__PURE__ */ require_chunk.__exportAll({
+	IframeResource: () => require_inspector.IframeResource,
+	Inspector: () => require_inspector.Inspector,
+	McpAppHost: () => require_inspector.McpAppHost,
+	SCREEN_WIDTHS: () => require_inspector.SCREEN_WIDTHS,
+	SidebarCheckbox: () => require_inspector.SidebarCheckbox,
+	SidebarCollapsibleControl: () => require_inspector.SidebarCollapsibleControl,
+	SidebarControl: () => require_inspector.SidebarControl,
+	SidebarInput: () => require_inspector.SidebarInput,
+	SidebarSelect: () => require_inspector.SidebarSelect,
+	SidebarTextarea: () => require_inspector.SidebarTextarea,
+	SidebarToggle: () => require_inspector.SidebarToggle,
+	SimpleSidebar: () => require_inspector.SimpleSidebar,
+	ThemeProvider: () => require_inspector.ThemeProvider,
+	createInspectorUrl: () => require_inspector_url.createInspectorUrl,
+	extractResourceCSP: () => require_inspector.extractResourceCSP,
+	extractResourceKey: () => require_discovery.extractResourceKey,
+	extractSimulationKey: () => require_discovery.extractSimulationKey,
+	findResourceDirs: () => require_discovery.findResourceDirs,
+	findResourceKey: () => require_discovery.findResourceKey,
+	getComponentName: () => require_discovery.getComponentName,
+	getHostShell: () => require_inspector.getHostShell,
+	getRegisteredHosts: () => require_inspector.getRegisteredHosts,
+	registerHostShell: () => require_inspector.registerHostShell,
+	resolveServerToolResult: () => require_inspector.resolveServerToolResult,
+	toPascalCase: () => require_discovery.toPascalCase,
+	useInspectorState: () => require_inspector.useInspectorState,
+	useMcpConnection: () => require_inspector.useMcpConnection,
+	useThemeContext: () => require_inspector.useThemeContext
+});
+//#endregion
+exports.IframeResource = require_inspector.IframeResource;
+exports.Inspector = require_inspector.Inspector;
+exports.McpAppHost = require_inspector.McpAppHost;
+exports.SCREEN_WIDTHS = require_inspector.SCREEN_WIDTHS;
+exports.SidebarCheckbox = require_inspector.SidebarCheckbox;
+exports.SidebarCollapsibleControl = require_inspector.SidebarCollapsibleControl;
+exports.SidebarControl = require_inspector.SidebarControl;
+exports.SidebarInput = require_inspector.SidebarInput;
+exports.SidebarSelect = require_inspector.SidebarSelect;
+exports.SidebarTextarea = require_inspector.SidebarTextarea;
+exports.SidebarToggle = require_inspector.SidebarToggle;
+exports.SimpleSidebar = require_inspector.SimpleSidebar;
+exports.ThemeProvider = require_inspector.ThemeProvider;
+exports.createInspectorUrl = require_inspector_url.createInspectorUrl;
+exports.extractResourceCSP = require_inspector.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_inspector.getHostShell;
+exports.getRegisteredHosts = require_inspector.getRegisteredHosts;
+Object.defineProperty(exports, "inspector_exports", {
+	enumerable: true,
+	get: function() {
+		return inspector_exports;
+	}
+});
+exports.registerHostShell = require_inspector.registerHostShell;
+exports.resolveServerToolResult = require_inspector.resolveServerToolResult;
+exports.toPascalCase = require_discovery.toPascalCase;
+exports.useInspectorState = require_inspector.useInspectorState;
+exports.useMcpConnection = require_inspector.useMcpConnection;
+exports.useThemeContext = require_inspector.useThemeContext;
+
+//# sourceMappingURL=index.cjs.map

package/dist/{simulator → inspector}/index.cjs.map

@@ -1 +1 @@
-{"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 } = 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// MCP connection\nexport { useMcpConnection } from './use-mcp-connection';\nexport type { McpConnectionState } from './use-mcp-connection';\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\nexport {\n  toPascalCase,\n  extractResourceKey,\n  extractSimulationKey,\n  findResourceKey,\n  getComponentName,\n  findResourceDirs,\n} from '../lib/discovery';\nexport type { ResourceDirInfo, FsOps } from '../lib/discovery';\n"],"mappings":""}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/inspector/index.ts"],"sourcesContent":["/**\n * Generic multi-host inspector for Sunpeak MCP Apps.\n *\n * The Inspector component provides a dev environment for testing MCP Apps\n * against multiple host platforms (ChatGPT, Claude, etc.).\n *\n * @example\n * ```tsx\n * import { inspector } from 'sunpeak';\n * const { Inspector } = inspector;\n *\n * <Inspector simulations={simulations} appName=\"My App\" />\n * ```\n *\n * @module sunpeak/inspector\n */\n\n// Register built-in host shells\nimport '../chatgpt/chatgpt-host';\nimport '../claude/claude-host';\n\n// Core inspector component\nexport { Inspector } from './inspector';\nexport type { InspectorProps } from './inspector';\n\n// State hook (for custom inspector builds)\nexport { useInspectorState } from './use-inspector-state';\nexport type { UseInspectorStateOptions, InspectorState } from './use-inspector-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// MCP connection\nexport { useMcpConnection } from './use-mcp-connection';\nexport type { McpConnectionState } from './use-mcp-connection';\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, InspectorConfig } from './inspector-types';\nexport { SCREEN_WIDTHS } from './inspector-types';\nexport { createInspectorUrl } from './inspector-url';\nexport type { InspectorUrlParams } from './inspector-url';\n\n// Sidebar components (for building custom inspectors)\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\nexport {\n  toPascalCase,\n  extractResourceKey,\n  extractSimulationKey,\n  findResourceKey,\n  getComponentName,\n  findResourceDirs,\n} from '../lib/discovery';\nexport type { ResourceDirInfo, FsOps } from '../lib/discovery';\n"],"mappings":""}

package/dist/{simulator → inspector}/index.d.ts

@@ -1,7 +1,7 @@
-export { Simulator } from './simulator';
-export type { SimulatorProps } from './simulator';
-export { useSimulatorState } from './use-simulator-state';
-export type { UseSimulatorStateOptions, SimulatorState } from './use-simulator-state';
+export { Inspector } from './inspector';
+export type { InspectorProps } from './inspector';
+export { useInspectorState } from './use-inspector-state';
+export type { UseInspectorStateOptions, InspectorState } from './use-inspector-state';
 export { registerHostShell, getHostShell, getRegisteredHosts } from './hosts';
 export type { HostConversationProps, HostShell, HostId } from './hosts';
 export { McpAppHost } from './mcp-app-host';
@@ -13,10 +13,10 @@ export { useMcpConnection } from './use-mcp-connection';
 export type { McpConnectionState } from './use-mcp-connection';
 export type { Simulation, ServerToolMock } from '../types/simulation';
 export { resolveServerToolResult } from '../types/simulation';
-export type { ScreenWidth, SimulatorConfig } from './simulator-types';
-export { SCREEN_WIDTHS } from './simulator-types';
-export { createSimulatorUrl } from './simulator-url';
-export type { SimulatorUrlParams } from './simulator-url';
+export type { ScreenWidth, InspectorConfig } from './inspector-types';
+export { SCREEN_WIDTHS } from './inspector-types';
+export { createInspectorUrl } from './inspector-url';
+export type { InspectorUrlParams } from './inspector-url';
 export { SimpleSidebar, SidebarControl, SidebarCollapsibleControl, SidebarSelect, SidebarInput, SidebarCheckbox, SidebarTextarea, SidebarToggle, } from './simple-sidebar';
 export { toPascalCase, extractResourceKey, extractSimulationKey, findResourceKey, getComponentName, findResourceDirs, } from '../lib/discovery';
 export type { ResourceDirInfo, FsOps } from '../lib/discovery';

package/dist/{simulator → inspector}/index.js

@@ -1,11 +1,12 @@
 import { r as __exportAll } from "../chunk-D6g4UhsZ.js";
 import "../protocol-DJmRaBzO.js";
-import { _ as McpAppHost, a as SidebarControl, b as getRegisteredHosts, c as SidebarTextarea, d as ThemeProvider, f as useThemeContext, g as extractResourceCSP, h as IframeResource, i as SidebarCollapsibleControl, l as SidebarToggle, m as useSimulatorState, n as resolveServerToolResult, o as SidebarInput, p as useMcpConnection, r as SidebarCheckbox, s as SidebarSelect, t as Simulator, u as SimpleSidebar, v as SCREEN_WIDTHS, x as registerHostShell, y as getHostShell } from "../simulator-BijjlOXb.js";
-import { t as createSimulatorUrl } from "../simulator-url-BbuuWa7S.js";
+import { _ as McpAppHost, a as SidebarControl, b as getRegisteredHosts, c as SidebarTextarea, d as ThemeProvider, f as useThemeContext, g as extractResourceCSP, h as IframeResource, i as SidebarCollapsibleControl, l as SidebarToggle, m as useInspectorState, n as resolveServerToolResult, o as SidebarInput, p as useMcpConnection, r as SidebarCheckbox, s as SidebarSelect, t as Inspector, u as SimpleSidebar, v as SCREEN_WIDTHS, x as registerHostShell, y as getHostShell } from "../inspector-ClhpqKLi.js";
+import { t as createInspectorUrl } from "../inspector-url-DuEFmxLP.js";
 import { c as toPascalCase, i as findResourceKey, n as extractSimulationKey, r as findResourceDirs, s as getComponentName, t as extractResourceKey } from "../discovery-Cgoegt62.js";
-//#region src/simulator/index.ts
-var simulator_exports = /* @__PURE__ */ __exportAll({
+//#region src/inspector/index.ts
+var inspector_exports = /* @__PURE__ */ __exportAll({
 	IframeResource: () => IframeResource,
+	Inspector: () => Inspector,
 	McpAppHost: () => McpAppHost,
 	SCREEN_WIDTHS: () => SCREEN_WIDTHS,
 	SidebarCheckbox: () => SidebarCheckbox,
@@ -16,9 +17,8 @@ var simulator_exports = /* @__PURE__ */ __exportAll({
 	SidebarTextarea: () => SidebarTextarea,
 	SidebarToggle: () => SidebarToggle,
 	SimpleSidebar: () => SimpleSidebar,
-	Simulator: () => Simulator,
 	ThemeProvider: () => ThemeProvider,
-	createSimulatorUrl: () => createSimulatorUrl,
+	createInspectorUrl: () => createInspectorUrl,
 	extractResourceCSP: () => extractResourceCSP,
 	extractResourceKey: () => extractResourceKey,
 	extractSimulationKey: () => extractSimulationKey,
@@ -30,11 +30,11 @@ var simulator_exports = /* @__PURE__ */ __exportAll({
 	registerHostShell: () => registerHostShell,
 	resolveServerToolResult: () => resolveServerToolResult,
 	toPascalCase: () => toPascalCase,
+	useInspectorState: () => useInspectorState,
 	useMcpConnection: () => useMcpConnection,
-	useSimulatorState: () => useSimulatorState,
 	useThemeContext: () => useThemeContext
 });
 //#endregion
-export { IframeResource, McpAppHost, SCREEN_WIDTHS, SidebarCheckbox, SidebarCollapsibleControl, SidebarControl, SidebarInput, SidebarSelect, SidebarTextarea, SidebarToggle, SimpleSidebar, Simulator, ThemeProvider, createSimulatorUrl, extractResourceCSP, extractResourceKey, extractSimulationKey, findResourceDirs, findResourceKey, getComponentName, getHostShell, getRegisteredHosts, registerHostShell, resolveServerToolResult, simulator_exports as t, toPascalCase, useMcpConnection, useSimulatorState, useThemeContext };
+export { IframeResource, Inspector, McpAppHost, SCREEN_WIDTHS, SidebarCheckbox, SidebarCollapsibleControl, SidebarControl, SidebarInput, SidebarSelect, SidebarTextarea, SidebarToggle, SimpleSidebar, ThemeProvider, createInspectorUrl, extractResourceCSP, extractResourceKey, extractSimulationKey, findResourceDirs, findResourceKey, getComponentName, getHostShell, getRegisteredHosts, registerHostShell, resolveServerToolResult, inspector_exports as t, toPascalCase, useInspectorState, useMcpConnection, useThemeContext };
 
 //# sourceMappingURL=index.js.map

package/dist/{simulator → inspector}/index.js.map

@@ -1 +1 @@
-{"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 } = 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// MCP connection\nexport { useMcpConnection } from './use-mcp-connection';\nexport type { McpConnectionState } from './use-mcp-connection';\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\nexport {\n  toPascalCase,\n  extractResourceKey,\n  extractSimulationKey,\n  findResourceKey,\n  getComponentName,\n  findResourceDirs,\n} from '../lib/discovery';\nexport type { ResourceDirInfo, FsOps } from '../lib/discovery';\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/inspector/index.ts"],"sourcesContent":["/**\n * Generic multi-host inspector for Sunpeak MCP Apps.\n *\n * The Inspector component provides a dev environment for testing MCP Apps\n * against multiple host platforms (ChatGPT, Claude, etc.).\n *\n * @example\n * ```tsx\n * import { inspector } from 'sunpeak';\n * const { Inspector } = inspector;\n *\n * <Inspector simulations={simulations} appName=\"My App\" />\n * ```\n *\n * @module sunpeak/inspector\n */\n\n// Register built-in host shells\nimport '../chatgpt/chatgpt-host';\nimport '../claude/claude-host';\n\n// Core inspector component\nexport { Inspector } from './inspector';\nexport type { InspectorProps } from './inspector';\n\n// State hook (for custom inspector builds)\nexport { useInspectorState } from './use-inspector-state';\nexport type { UseInspectorStateOptions, InspectorState } from './use-inspector-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// MCP connection\nexport { useMcpConnection } from './use-mcp-connection';\nexport type { McpConnectionState } from './use-mcp-connection';\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, InspectorConfig } from './inspector-types';\nexport { SCREEN_WIDTHS } from './inspector-types';\nexport { createInspectorUrl } from './inspector-url';\nexport type { InspectorUrlParams } from './inspector-url';\n\n// Sidebar components (for building custom inspectors)\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\nexport {\n  toPascalCase,\n  extractResourceKey,\n  extractSimulationKey,\n  findResourceKey,\n  getComponentName,\n  findResourceDirs,\n} from '../lib/discovery';\nexport type { ResourceDirInfo, FsOps } from '../lib/discovery';\n"],"mappings":""}

package/dist/{simulator/simulator-types.d.ts → inspector/inspector-types.d.ts}

@@ -1,6 +1,6 @@
 import { DisplayMode, Theme } from '../types/runtime';
 export type ScreenWidth = 'mobile-s' | 'mobile-l' | 'tablet' | 'full';
-export type SimulatorConfig = {
+export type InspectorConfig = {
     theme: Theme;
     displayMode: DisplayMode;
     screenWidth: ScreenWidth;

package/dist/{simulator/simulator-url.d.ts → inspector/inspector-url.d.ts}

@@ -1,8 +1,8 @@
 import { Theme, DisplayMode, DeviceType } from '../types/runtime';
 /**
- * Strongly-typed URL parameters for the Simulator.
+ * Strongly-typed URL parameters for the Inspector.
  *
- * Use with `createSimulatorUrl()` to generate type-safe URL paths for e2e tests.
+ * Use with `createInspectorUrl()` to generate type-safe URL paths for e2e tests.
  *
  * The two primary selectors mirror the sidebar dropdowns:
  * - `tool` — which tool to inspect (Tool dropdown)
@@ -14,23 +14,23 @@ import { Theme, DisplayMode, DeviceType } from '../types/runtime';
  *
  * @example
  * ```ts
- * import { createSimulatorUrl } from 'sunpeak/simulator';
+ * import { createInspectorUrl } from 'sunpeak/inspector';
  *
  * // Select a tool with no mock data (user must click Run):
- * await page.goto(createSimulatorUrl({ tool: 'show-albums' }));
+ * await page.goto(createInspectorUrl({ tool: 'show-albums' }));
  *
  * // Select a simulation (mock data renders immediately):
- * await page.goto(createSimulatorUrl({ simulation: 'show-albums' }));
+ * await page.goto(createInspectorUrl({ simulation: 'show-albums' }));
  *
  * // Full options:
- * await page.goto(createSimulatorUrl({
+ * await page.goto(createInspectorUrl({
  *   simulation: 'show-albums',
  *   theme: 'dark',
  *   host: 'claude',
  * }));
  * ```
  */
-export interface SimulatorUrlParams {
+export interface InspectorUrlParams {
     /**
      * The simulation name to load (e.g., 'show-albums', 'review-diff').
      * Corresponds to the simulation JSON filename without the `.json` extension.
@@ -50,7 +50,7 @@ export interface SimulatorUrlParams {
      */
     host?: string;
     /**
-     * The color theme for the simulator.
+     * The color theme for the inspector.
      * @default 'dark'
      */
     theme?: Theme;
@@ -63,7 +63,7 @@ export interface SimulatorUrlParams {
      */
     displayMode?: DisplayMode;
     /**
-     * The locale for the simulator (e.g., 'en-US', 'ja-JP').
+     * The locale for the inspector (e.g., 'en-US', 'ja-JP').
      * @default 'en-US'
      */
     locale?: string;
@@ -111,25 +111,25 @@ export interface SimulatorUrlParams {
     prodResources?: boolean;
 }
 /**
- * Creates a URL path with query parameters for the Simulator.
+ * Creates a URL path with query parameters for the Inspector.
  *
- * @param params - The simulator parameters to encode
+ * @param params - The inspector parameters to encode
  * @param basePath - The base path for the URL (default: '/')
  * @returns A URL path string with encoded query parameters
  *
  * @example
  * ```ts
  * // Tool only (no mock data, "Press Run" state):
- * createSimulatorUrl({ tool: 'show-albums' })
+ * createInspectorUrl({ tool: 'show-albums' })
  * // Returns: '/?tool=show-albums'
  *
  * // Simulation (mock data renders immediately):
- * createSimulatorUrl({ simulation: 'show-albums', theme: 'light' })
+ * createInspectorUrl({ simulation: 'show-albums', theme: 'light' })
  * // Returns: '/?simulation=show-albums&theme=light'
  *
  * // Both tool and simulation:
- * createSimulatorUrl({ tool: 'show-albums', simulation: 'show-albums' })
+ * createInspectorUrl({ tool: 'show-albums', simulation: 'show-albums' })
  * // Returns: '/?tool=show-albums&simulation=show-albums'
  * ```
  */
-export declare function createSimulatorUrl(params: SimulatorUrlParams, basePath?: string): string;
+export declare function createInspectorUrl(params: InspectorUrlParams, basePath?: string): string;

package/dist/{simulator/simulator.d.ts → inspector/inspector.d.ts}

@@ -2,7 +2,7 @@ import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { HostId } from './hosts';
 import { Simulation } from '../types/simulation';
 import * as React from 'react';
-export interface SimulatorProps {
+export interface InspectorProps {
     children?: React.ReactNode;
     simulations?: Record<string, Simulation>;
     appName?: string;
@@ -22,7 +22,7 @@ export interface SimulatorProps {
     /** Initial prod-resources mode state. When true, resources load from dist/ instead of HMR. Defaults to false. */
     defaultProdResources?: boolean;
     /** Hide framework-only controls (Prod Resources) in the sidebar. */
-    hideSimulatorModes?: boolean;
+    hideInspectorModes?: boolean;
     /**
      * Demo mode for embedding on marketing sites. When true:
      * - Hides Prod Resources checkbox
@@ -44,4 +44,4 @@ export interface SimulatorProps {
      */
     mcpServerUrl?: string;
 }
-export declare function Simulator({ children, simulations: initialSimulations, appName, appIcon, defaultHost, onCallTool, onCallToolDirect, defaultProdResources, hideSimulatorModes, demoMode, sandboxUrl, mcpServerUrl, }: SimulatorProps): import("react/jsx-runtime").JSX.Element;
+export declare function Inspector({ children, simulations: initialSimulations, appName, appIcon, defaultHost, onCallTool, onCallToolDirect, defaultProdResources, hideInspectorModes, demoMode, sandboxUrl, mcpServerUrl, }: InspectorProps): import("react/jsx-runtime").JSX.Element;

package/dist/{simulator → inspector}/mcp-app-host.d.ts

@@ -2,7 +2,7 @@ import { McpUiHostContext, McpUiDisplayMode, McpUiHostCapabilities } from '@mode
 import { CallToolRequest, CallToolResult, LoggingMessageNotification } from '@modelcontextprotocol/sdk/types.js';
 export interface McpAppHostOptions {
     hostContext?: McpUiHostContext;
-    /** Host info reported to the app via MCP protocol. Defaults to SunpeakSimulator. */
+    /** Host info reported to the app via MCP protocol. Defaults to SunpeakInspector. */
     hostInfo?: {
         name: string;
         version: string;
@@ -29,8 +29,8 @@ export interface McpAppHostOptions {
     onSandboxReady?: () => void;
 }
 /**
- * MCP Apps host for the Sunpeak simulator.
- * Wraps AppBridge to provide a simpler API for the simulator.
+ * MCP Apps host for the Sunpeak inspector.
+ * Wraps AppBridge to provide a simpler API for the inspector.
  * Connects to an iframe via PostMessageTransport.
  */
 export declare class McpAppHost {
@@ -105,12 +105,12 @@ export declare class McpAppHost {
     /**
      * Debug: Inject state directly into the app's useAppState hook.
      * This bypasses the normal MCP Apps protocol and is intended for
-     * simulator testing/debugging only.
+     * inspector testing/debugging only.
      */
     injectState(state: Record<string, unknown>): void;
     /**
      * Update mutable options (callbacks) after construction.
-     * Allows the simulator to swap handlers (e.g. onCallTool) without
+     * Allows the inspector to swap handlers (e.g. onCallTool) without
      * recreating the host and tearing down the iframe connection.
      */
     updateOptions(partial: Partial<McpAppHostOptions>): void;

package/dist/{simulator → inspector}/mock-openai-runtime.d.ts

@@ -1,9 +1,9 @@
 /**
- * Mock OpenAI runtime for the simulator.
+ * Mock OpenAI runtime for the inspector.
  *
  * ChatGPT-specific hooks (useUploadFile, useRequestModal, etc.) call
  * `window.openai` directly — they don't use the MCP protocol. When the
- * ChatGPT host is selected in the simulator, we inject this mock into
+ * ChatGPT host is selected in the inspector, we inject this mock into
  * the iframe's window so those hooks work during local development.
  */
 /**

package/dist/{simulator → inspector}/sandbox-proxy.d.ts

@@ -8,7 +8,7 @@
  * 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
+ * The inspector replicates this architecture so apps are tested under the same
  * iframe nesting they'll encounter in production.
  *
  * Protocol:

package/dist/{simulator/use-simulator-state.d.ts → inspector/use-inspector-state.d.ts}

@@ -1,15 +1,15 @@
 import { McpUiHostContext, McpUiDisplayMode, McpUiTheme, McpUiResourcePermissions } from '@modelcontextprotocol/ext-apps';
 import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { Simulation } from '../types/simulation';
-import { ScreenWidth } from './simulator-types';
+import { ScreenWidth } from './inspector-types';
 import { HostId } from './hosts';
 import { ResourceCSP } from './iframe-resource';
 type Platform = NonNullable<McpUiHostContext['platform']>;
-export interface UseSimulatorStateOptions {
+export interface UseInspectorStateOptions {
     simulations: Record<string, Simulation>;
     defaultHost?: HostId;
 }
-export interface SimulatorState {
+export interface InspectorState {
     simulationNames: string[];
     selectedSimulationName: string;
     setSelectedSimulationName: (name: string) => void;
@@ -89,5 +89,5 @@ export interface SimulatorState {
     urlTool: string | undefined;
     urlProdResources: boolean | undefined;
 }
-export declare function useSimulatorState({ simulations, defaultHost, }: UseSimulatorStateOptions): SimulatorState;
+export declare function useInspectorState({ simulations, defaultHost, }: UseInspectorStateOptions): InspectorState;
 export {};

package/dist/{simulator → inspector}/use-mcp-connection.d.ts

@@ -19,6 +19,6 @@ export interface McpConnectionState {
  *
  * This split avoids React StrictMode issues: the mount-only health check runs
  * once (or safely twice with cancellation), while explicit `reconnect()` calls
- * are triggered by the Simulator's URL-change effect.
+ * are triggered by the Inspector's URL-change effect.
  */
 export declare function useMcpConnection(initialServerUrl: string | undefined): McpConnectionState;