sunpeak 0.16.28 → 0.17.1

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-BYIH-xqQ.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-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";
+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;