sunpeak 0.16.29 → 0.17.2

package/dist/mcp/types.d.ts

@@ -75,6 +75,11 @@ export interface SimulationWithDist {
  * Handle returned by `runMCPServer` for controlling the running server.
  */
 export interface MCPServerHandle {
+    /**
+     * Promise that resolves when the HTTP server is listening.
+     * Useful for callers that need to connect to the server immediately after starting it.
+     */
+    ready: Promise<void>;
     /**
      * Notify non-local sessions that resources have changed.
      * Sends `notifications/resources/list_changed` so hosts re-fetch fresh content.

package/dist/simulator/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../chunk-9hOWP6kD.cjs");
 require("../protocol-jbxhzcnS.cjs");
-const require_simulator = require("../simulator-DIVvI69i.cjs");
-const require_discovery = require("../discovery-BxKCIgG5.cjs");
-const require_simulator_url = require("../simulator-url-BDGD4vZD.cjs");
+const require_simulator = require("../simulator-CH9hs0N6.cjs");
+const require_simulator_url = require("../simulator-url-CozKF1jf.cjs");
+const require_discovery = require("../discovery-Clu4uHp1.cjs");
 //#region src/simulator/index.ts
 var simulator_exports = /* @__PURE__ */ require_chunk.__exportAll({
 	IframeResource: () => require_simulator.IframeResource,
@@ -19,10 +19,6 @@ var simulator_exports = /* @__PURE__ */ require_chunk.__exportAll({
 	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,
@@ -35,6 +31,7 @@ var simulator_exports = /* @__PURE__ */ require_chunk.__exportAll({
 	registerHostShell: () => require_simulator.registerHostShell,
 	resolveServerToolResult: () => require_simulator.resolveServerToolResult,
 	toPascalCase: () => require_discovery.toPascalCase,
+	useMcpConnection: () => require_simulator.useMcpConnection,
 	useSimulatorState: () => require_simulator.useSimulatorState,
 	useThemeContext: () => require_simulator.useThemeContext
 });
@@ -52,10 +49,6 @@ 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;
@@ -74,6 +67,7 @@ Object.defineProperty(exports, "simulator_exports", {
 	}
 });
 exports.toPascalCase = require_discovery.toPascalCase;
+exports.useMcpConnection = require_simulator.useMcpConnection;
 exports.useSimulatorState = require_simulator.useSimulatorState;
 exports.useThemeContext = require_simulator.useThemeContext;
 

package/dist/simulator/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, 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":""}
+{"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 (inspect mode)\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":""}

package/dist/simulator/index.d.ts

@@ -9,6 +9,8 @@ export type { McpAppHostOptions } from './mcp-app-host';
 export { IframeResource, extractResourceCSP } from './iframe-resource';
 export type { ResourceCSP } from './iframe-resource';
 export { ThemeProvider, useThemeContext } from './theme-provider';
+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';
@@ -16,5 +18,5 @@ export { SCREEN_WIDTHS } from './simulator-types';
 export { createSimulatorUrl } from './simulator-url';
 export type { SimulatorUrlParams } from './simulator-url';
 export { SimpleSidebar, SidebarControl, SidebarCollapsibleControl, SidebarSelect, SidebarInput, SidebarCheckbox, SidebarTextarea, SidebarToggle, } from './simple-sidebar';
-export { buildDevSimulations, buildSimulations, buildResourceMap, createResourceExports, toPascalCase, extractResourceKey, extractSimulationKey, findResourceKey, getComponentName, findResourceDirs, } from '../lib/discovery';
-export type { BuildSimulationsOptions, BuildDevSimulationsOptions, ResourceMetadata, ResourceDirInfo, FsOps, } from '../lib/discovery';
+export { toPascalCase, extractResourceKey, extractSimulationKey, findResourceKey, getComponentName, findResourceDirs, } from '../lib/discovery';
+export type { ResourceDirInfo, FsOps } from '../lib/discovery';

package/dist/simulator/index.js

@@ -1,8 +1,8 @@
 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-C7mkK7Sz.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";
+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-Dl8B-Ljb.js";
+import { t as createSimulatorUrl } from "../simulator-url-KoS_ToP6.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({
 	IframeResource: () => IframeResource,
@@ -18,10 +18,6 @@ var simulator_exports = /* @__PURE__ */ __exportAll({
 	SimpleSidebar: () => SimpleSidebar,
 	Simulator: () => Simulator,
 	ThemeProvider: () => ThemeProvider,
-	buildDevSimulations: () => buildDevSimulations,
-	buildResourceMap: () => buildResourceMap,
-	buildSimulations: () => buildSimulations,
-	createResourceExports: () => createResourceExports,
 	createSimulatorUrl: () => createSimulatorUrl,
 	extractResourceCSP: () => extractResourceCSP,
 	extractResourceKey: () => extractResourceKey,
@@ -34,10 +30,11 @@ var simulator_exports = /* @__PURE__ */ __exportAll({
 	registerHostShell: () => registerHostShell,
 	resolveServerToolResult: () => resolveServerToolResult,
 	toPascalCase: () => toPascalCase,
+	useMcpConnection: () => useMcpConnection,
 	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 };
+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 };
 
 //# sourceMappingURL=index.js.map

package/dist/simulator/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, 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":""}
+{"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 (inspect mode)\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":""}

package/dist/simulator/simple-sidebar.d.ts

@@ -7,14 +7,15 @@ interface SimpleSidebarProps {
 }
 export declare function SimpleSidebar({ children, controls, headerRight }: SimpleSidebarProps): import("react/jsx-runtime").JSX.Element;
 interface SidebarControlProps {
-    label: string;
+    label: React.ReactNode;
     children: React.ReactNode;
     /** Short tooltip shown on hover of the help icon */
     tooltip?: string;
     /** Docs path appended to https://sunpeak.ai/docs/ */
     docsPath?: string;
+    'data-testid'?: string;
 }
-export declare function SidebarControl({ label, children, tooltip, docsPath }: SidebarControlProps): import("react/jsx-runtime").JSX.Element;
+export declare function SidebarControl({ label, children, tooltip, docsPath, 'data-testid': testId, }: SidebarControlProps): import("react/jsx-runtime").JSX.Element;
 interface SidebarCollapsibleControlProps {
     label: string;
     children: React.ReactNode;
@@ -23,8 +24,9 @@ interface SidebarCollapsibleControlProps {
     tooltip?: string;
     /** Docs path appended to https://sunpeak.ai/docs/ */
     docsPath?: string;
+    'data-testid'?: string;
 }
-export declare function SidebarCollapsibleControl({ label, children, defaultCollapsed, tooltip, docsPath, }: SidebarCollapsibleControlProps): import("react/jsx-runtime").JSX.Element;
+export declare function SidebarCollapsibleControl({ label, children, defaultCollapsed, tooltip, docsPath, 'data-testid': testId, }: SidebarCollapsibleControlProps): import("react/jsx-runtime").JSX.Element;
 interface SidebarSelectProps {
     value: string;
     onChange: (value: string) => void;
@@ -63,8 +65,9 @@ interface SidebarTextareaProps {
     placeholder?: string;
     maxRows?: number;
     error?: string;
+    'data-testid'?: string;
 }
-export declare function SidebarTextarea({ value, onChange, onFocus, onBlur, placeholder, maxRows, error, }: SidebarTextareaProps): import("react/jsx-runtime").JSX.Element;
+export declare function SidebarTextarea({ value, onChange, onFocus, onBlur, placeholder, maxRows, error, 'data-testid': testId, }: SidebarTextareaProps): import("react/jsx-runtime").JSX.Element;
 interface SidebarToggleProps {
     value: string;
     onChange: (value: string) => void;

package/dist/simulator/simulator-url.d.ts

@@ -93,6 +93,14 @@ export interface SimulatorUrlParams {
      * Enable Prod Resources mode (production dist/ bundles instead of HMR).
      */
     prodResources?: boolean;
+    /**
+     * MCP server URL for inspect mode. Encoded into the URL for informational purposes.
+     */
+    serverUrl?: string;
+    /**
+     * Pre-select a tool by name (alternative to the `simulation` param).
+     */
+    tool?: string;
 }
 /**
  * Creates a URL path with query parameters for the ChatGPT Simulator.

package/dist/simulator/simulator.d.ts

@@ -9,11 +9,16 @@ export interface SimulatorProps {
     appIcon?: string;
     /** Which host shell to use initially. Defaults to 'chatgpt'. */
     defaultHost?: HostId;
-    /** Override callServerTool resolution. When provided, bypasses simulation serverTools mocks (e.g., for --prod-tools mode). */
+    /** Override callServerTool resolution. When provided, bypasses simulation serverTools mocks. Routes through MCP which returns simulation fixture data for UI tools. */
     onCallTool?: (params: {
         name: string;
         arguments?: Record<string, unknown>;
     }) => Promise<CallToolResult> | CallToolResult;
+    /** Direct tool handler call, bypassing MCP server mock data. Used by the Prod Tools Run button to call real handlers. Falls back to onCallTool if not provided. */
+    onCallToolDirect?: (params: {
+        name: string;
+        arguments?: Record<string, unknown>;
+    }) => Promise<CallToolResult> | CallToolResult;
     /** Initial prod-tools mode state. Defaults to false. */
     defaultProdTools?: boolean;
     /** Initial prod-resources mode state. When true, resources load from dist/ instead of HMR. Defaults to false. */
@@ -26,5 +31,13 @@ export interface SimulatorProps {
      * giving real cross-origin isolation that matches production hosts.
      */
     sandboxUrl?: string;
+    /**
+     * MCP server URL. When provided, the simulator enters "inspect" mode:
+     * shows a server URL input in the sidebar (replacing prod-tools/prod-resources
+     * checkboxes), routes tool calls to the real server, and always shows the
+     * Run button. Simulations still work — those with toolResult use mock data,
+     * those without call the real server.
+     */
+    mcpServerUrl?: string;
 }
-export declare function Simulator({ children, simulations, appName, appIcon, defaultHost, onCallTool, defaultProdTools, defaultProdResources, hideSimulatorModes, sandboxUrl, }: SimulatorProps): import("react/jsx-runtime").JSX.Element;
+export declare function Simulator({ children, simulations, appName, appIcon, defaultHost, onCallTool, onCallToolDirect, defaultProdTools, defaultProdResources, hideSimulatorModes, sandboxUrl, mcpServerUrl, }: SimulatorProps): import("react/jsx-runtime").JSX.Element;

package/dist/simulator/use-mcp-connection.d.ts

@@ -0,0 +1,19 @@
+export interface McpConnectionState {
+    /** Current connection status */
+    status: 'disconnected' | 'connecting' | 'connected' | 'error';
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Verify the server connection is alive. */
+    reconnect: (url: string) => Promise<void>;
+}
+/**
+ * Hook for managing MCP server connection status via the dev server proxy.
+ *
+ * On mount (when `serverUrl` is provided), verifies the connection is alive
+ * by fetching `/__sunpeak/list-tools`. Tracks connection status for display
+ * in the sidebar (colored dot indicator).
+ *
+ * Tool calling is handled separately via the `onCallTool` prop — this
+ * hook only manages the connection lifecycle and status display.
+ */
+export declare function useMcpConnection(serverUrl: string | undefined): McpConnectionState;

package/dist/{simulator-DIVvI69i.cjs → simulator-CH9hs0N6.cjs}

@@ -2492,6 +2492,69 @@ function useSimulatorState({ simulations, defaultHost = "chatgpt" }) {
 	};
 }
 //#endregion
+//#region src/simulator/use-mcp-connection.ts
+/**
+* Hook for managing MCP server connection status via the dev server proxy.
+*
+* On mount (when `serverUrl` is provided), verifies the connection is alive
+* by fetching `/__sunpeak/list-tools`. Tracks connection status for display
+* in the sidebar (colored dot indicator).
+*
+* Tool calling is handled separately via the `onCallTool` prop — this
+* hook only manages the connection lifecycle and status display.
+*/
+function useMcpConnection(serverUrl) {
+	const [status, setStatus] = (0, react.useState)(serverUrl ? "connecting" : "disconnected");
+	const [error, setError] = (0, react.useState)();
+	const reconnect = (0, react.useCallback)(async (url) => {
+		setStatus("connecting");
+		setError(void 0);
+		try {
+			const res = await fetch("/__sunpeak/connect", {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ url })
+			});
+			if (!res.ok) {
+				const text = await res.text();
+				throw new Error(text || `Connection failed (${res.status})`);
+			}
+			setStatus("connected");
+		} catch (err) {
+			setError(err instanceof Error ? err.message : String(err));
+			setStatus("error");
+		}
+	}, []);
+	(0, react.useEffect)(() => {
+		if (!serverUrl) {
+			setStatus("disconnected");
+			return;
+		}
+		let cancelled = false;
+		(async () => {
+			setStatus("connecting");
+			try {
+				const res = await fetch("/__sunpeak/list-tools");
+				if (cancelled) return;
+				if (!res.ok) throw new Error(`Health check failed (${res.status})`);
+				setStatus("connected");
+			} catch (err) {
+				if (cancelled) return;
+				setError(err instanceof Error ? err.message : String(err));
+				setStatus("error");
+			}
+		})();
+		return () => {
+			cancelled = true;
+		};
+	}, [serverUrl]);
+	return {
+		status,
+		error,
+		reconnect
+	};
+}
+//#endregion
 //#region src/simulator/theme-provider.tsx
 var ThemeProviderContext = react.createContext(void 0);
 /** Default theme applier: sets data-theme attribute on document.documentElement */
@@ -2697,9 +2760,10 @@ function HelpIcon({ tooltip, docsPath }) {
 		})]
 	});
 }
-function SidebarControl({ label, children, tooltip, docsPath }) {
+function SidebarControl({ label, children, tooltip, docsPath, "data-testid": testId }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "space-y-1",
+		"data-testid": testId,
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 			className: "text-[10px] font-medium leading-tight inline-flex items-center gap-1",
 			style: { color: "var(--color-text-secondary)" },
@@ -2710,10 +2774,11 @@ function SidebarControl({ label, children, tooltip, docsPath }) {
 		}), children]
 	});
 }
-function SidebarCollapsibleControl({ label, children, defaultCollapsed = true, tooltip, docsPath }) {
+function SidebarCollapsibleControl({ label, children, defaultCollapsed = true, tooltip, docsPath, "data-testid": testId }) {
 	const [isCollapsed, setIsCollapsed] = react.useState(defaultCollapsed);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "space-y-1",
+		"data-testid": testId,
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 			onClick: () => setIsCollapsed(!isCollapsed),
 			className: "w-full flex items-center justify-between text-[10px] font-medium leading-tight transition-colors py-1 cursor-pointer",
@@ -2816,7 +2881,7 @@ function SidebarCheckbox({ checked, onChange, label, tooltip, docsPath }) {
 		})]
 	});
 }
-function SidebarTextarea({ value, onChange, onFocus, onBlur, placeholder, maxRows = 8, error }) {
+function SidebarTextarea({ value, onChange, onFocus, onBlur, placeholder, maxRows = 8, error, "data-testid": testId }) {
 	const contentRows = value?.split("\n").length ?? 1;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "space-y-0.5",
@@ -2827,6 +2892,7 @@ function SidebarTextarea({ value, onChange, onFocus, onBlur, placeholder, maxRow
 			onBlur,
 			placeholder,
 			rows: Math.min(contentRows, maxRows),
+			"data-testid": testId,
 			className: "w-full text-[10px] font-mono rounded-md px-2 py-1.5 outline-none resize-y",
 			style: {
 				...formElementStyle,
@@ -2883,20 +2949,26 @@ function resolveServerToolResult(mock, args) {
 }
 //#endregion
 //#region src/simulator/simulator.tsx
-function Simulator({ children, simulations = {}, appName = "Sunpeak", appIcon, defaultHost = "chatgpt", onCallTool, defaultProdTools = false, defaultProdResources = false, hideSimulatorModes = false, sandboxUrl }) {
+function Simulator({ children, simulations = {}, appName = "Sunpeak", appIcon, defaultHost = "chatgpt", onCallTool, onCallToolDirect, defaultProdTools = false, defaultProdResources = false, hideSimulatorModes = false, sandboxUrl, mcpServerUrl }) {
+	const isInspectMode = mcpServerUrl != null;
 	const state = useSimulatorState({
 		simulations,
 		defaultHost
 	});
-	const [prodTools, setProdTools] = react.useState(state.urlProdTools ?? defaultProdTools);
+	const connection = useMcpConnection(mcpServerUrl);
+	const [prodTools, setProdTools] = react.useState(isInspectMode ? true : state.urlProdTools ?? defaultProdTools);
 	const [prodResources, setProdResources] = react.useState(state.urlProdResources ?? defaultProdResources);
 	const [isRunning, setIsRunning] = react.useState(false);
 	const [hasRun, setHasRun] = react.useState(false);
 	const [showCheck, setShowCheck] = react.useState(false);
 	const checkTimerRef = react.useRef(void 0);
 	react.useEffect(() => {
-		if (prodTools) setHasRun(false);
-		else {
+		if (prodTools) {
+			setHasRun(false);
+			state.setToolResult(void 0);
+			state.setToolResultJson("");
+			state.setToolResultError("");
+		} else {
 			const simResult = state.selectedSim?.toolResult ?? void 0;
 			state.setToolResult(simResult);
 		}
@@ -2919,11 +2991,12 @@ function Simulator({ children, simulations = {}, appName = "Sunpeak", appIcon, d
 		simulations
 	]);
 	const handleRun = react.useCallback(async () => {
-		if (!onCallTool || !state.selectedSim) return;
+		const caller = onCallToolDirect ?? onCallTool;
+		if (!caller || !state.selectedSim) return;
 		const toolName = state.selectedSim.tool.name;
 		setIsRunning(true);
 		try {
-			const result = await onCallTool({
+			const result = (isInspectMode ? state.selectedSim.toolResult : void 0) ?? await caller({
 				name: toolName,
 				arguments: state.toolInput
 			});
@@ -2953,7 +3026,12 @@ function Simulator({ children, simulations = {}, appName = "Sunpeak", appIcon, d
 		} finally {
 			setIsRunning(false);
 		}
-	}, [onCallTool, state]);
+	}, [
+		onCallTool,
+		onCallToolDirect,
+		state,
+		isInspectMode
+	]);
 	const activeShell = getHostShell(state.activeHost);
 	const registeredHosts = getRegisteredHosts();
 	const ShellConversation = activeShell?.Conversation;
@@ -2986,18 +3064,21 @@ function Simulator({ children, simulations = {}, appName = "Sunpeak", appIcon, d
 		} else prevPageStyleKeysRef.current = [];
 	}, [activeShell]);
 	const handleCallTool = react.useCallback((params) => {
-		if (onCallTool) return onCallTool(params);
-		const mock = state.selectedSim?.serverTools?.[params.name];
-		if (mock) {
-			const result = resolveServerToolResult(mock, params.arguments);
-			if (result) return result;
+		if (!prodTools) {
+			const mock = state.selectedSim?.serverTools?.[params.name];
+			if (mock) {
+				const result = resolveServerToolResult(mock, params.arguments);
+				if (result) return result;
+			}
 		}
+		if (onCallTool) return onCallTool(params);
 		return { content: [{
 			type: "text",
 			text: `[Simulator] Tool "${params.name}" called — no serverTools mock found in simulation "${state.selectedSimulationName}".`
 		}] };
 	}, [
 		onCallTool,
+		prodTools,
 		state.selectedSim,
 		state.selectedSimulationName
 	]);
@@ -3125,14 +3206,33 @@ function Simulator({ children, simulations = {}, appName = "Sunpeak", appIcon, d
 			controls: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "space-y-1",
 				children: [
-					!hideSimulatorModes && onCallTool && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarCheckbox, {
+					isInspectMode && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarControl, {
+						label: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+							className: "flex items-center gap-1.5",
+							children: ["MCP Server", /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "inline-block w-2 h-2 rounded-full",
+								"data-testid": "inspect-connection-status",
+								style: { backgroundColor: connection.status === "connected" ? "#22c55e" : connection.status === "connecting" ? "#eab308" : connection.status === "error" ? "#ef4444" : "#6b7280" },
+								title: connection.error ?? connection.status
+							})]
+						}),
+						tooltip: "MCP server URL (set via --server flag)",
+						"data-testid": "inspect-server-url",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarInput, {
+							value: mcpServerUrl ?? "",
+							onChange: () => {},
+							disabled: true,
+							placeholder: "http://localhost:8000/mcp"
+						})
+					}),
+					!isInspectMode && !hideSimulatorModes && onCallTool && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarCheckbox, {
 						checked: prodTools,
 						onChange: setProdTools,
 						label: "Prod Tools",
 						tooltip: "Use real tool handlers instead of simulations",
 						docsPath: "api-reference/cli/dev#prod-tools-and-prod-resources-flags"
 					}),
-					!hideSimulatorModes && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarCheckbox, {
+					!isInspectMode && !hideSimulatorModes && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarCheckbox, {
 						checked: prodResources,
 						onChange: setProdResources,
 						label: "Prod Resources",
@@ -3502,13 +3602,15 @@ function Simulator({ children, simulations = {}, appName = "Sunpeak", appIcon, d
 							maxRows: 8
 						})
 					}, `tool-input-${prodTools}`),
-					!prodTools && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarCollapsibleControl, {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarCollapsibleControl, {
 						label: "Tool Result (JSON)",
-						defaultCollapsed: false,
+						defaultCollapsed: prodTools,
 						tooltip: "Structured content returned by the tool",
 						docsPath: "api-reference/hooks/use-tool-data",
+						"data-testid": "tool-result-section",
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarTextarea, {
 							value: state.toolResultJson,
+							"data-testid": "tool-result-textarea",
 							onChange: (json) => state.validateJSON(json, state.setToolResultJson, state.setToolResultError),
 							onFocus: () => state.setEditingField("toolResult"),
 							onBlur: () => state.commitJSON(state.toolResultJson, state.setToolResultError, (parsed) => {
@@ -3525,7 +3627,7 @@ function Simulator({ children, simulations = {}, appName = "Sunpeak", appIcon, d
 							error: state.toolResultError,
 							maxRows: 8
 						})
-					})
+					}, `tool-result-${prodTools}`)
 				]
 			}),
 			children: ShellConversation ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ShellConversation, {
@@ -3684,6 +3786,12 @@ Object.defineProperty(exports, "resolveServerToolResult", {
 		return resolveServerToolResult;
 	}
 });
+Object.defineProperty(exports, "useMcpConnection", {
+	enumerable: true,
+	get: function() {
+		return useMcpConnection;
+	}
+});
 Object.defineProperty(exports, "useSimulatorState", {
 	enumerable: true,
 	get: function() {
@@ -3697,4 +3805,4 @@ Object.defineProperty(exports, "useThemeContext", {
 	}
 });
 
-//# sourceMappingURL=simulator-DIVvI69i.cjs.map
+//# sourceMappingURL=simulator-CH9hs0N6.cjs.map