sunpeak 0.20.1 → 0.20.5

package/bin/commands/test-init.mjs

@@ -40,6 +40,7 @@ export const defaultDeps = {
   mkdirSync,
   execSync,
   cwd: () => process.cwd(),
+  isTTY: () => !!process.stdin.isTTY,
   intro: p.intro,
   outro: p.outro,
   confirm: p.confirm,
@@ -80,6 +81,7 @@ export async function testInit(args = [], deps = defaultDeps) {
       : undefined;
 
   const projectType = detectProjectType(d);
+  const interactive = d.isTTY();
 
   if (projectType === 'sunpeak') {
     await initSunpeakProject(d);
@@ -89,74 +91,78 @@ export async function testInit(args = [], deps = defaultDeps) {
     await initExternalProject(cliServer, d);
   }
 
-  // Offer to configure eval providers
-  const providers = await d.selectProviders();
-  if (!d.isCancel(providers) && providers.length > 0) {
-    const pm = d.detectPackageManager();
-    const pkgsToInstall = ['ai', ...providers.map((p) => p.pkg)];
-    const installCmd = `${pm} add -D ${pkgsToInstall.join(' ')}`;
-    try {
-      d.execSync(installCmd, { cwd: d.cwd(), stdio: 'inherit' });
-    } catch {
-      d.log.info(`Provider install failed. Install manually: ${installCmd}`);
-    }
+  // Offer to configure eval providers (skip without a TTY — prompts can't work)
+  if (interactive) {
+    const providers = await d.selectProviders();
+    if (!d.isCancel(providers) && providers.length > 0) {
+      const pm = d.detectPackageManager();
+      const pkgsToInstall = ['ai', ...providers.map((p) => p.pkg)];
+      const installCmd = `${pm} add -D ${pkgsToInstall.join(' ')}`;
+      try {
+        d.execSync(installCmd, { cwd: d.cwd(), stdio: 'inherit' });
+      } catch {
+        d.log.info(`Provider install failed. Install manually: ${installCmd}`);
+      }
 
-    // Uncomment selected models in eval.config.ts
-    const evalDir = d.existsSync(join(d.cwd(), 'tests', 'evals'))
-      ? join(d.cwd(), 'tests', 'evals')
-      : d.existsSync(join(d.cwd(), 'tests', 'sunpeak', 'evals'))
-        ? join(d.cwd(), 'tests', 'sunpeak', 'evals')
-        : null;
-    if (evalDir) {
-      const configPath = join(evalDir, 'eval.config.ts');
-      if (d.existsSync(configPath)) {
-        let config = d.readFileSync(configPath, 'utf-8');
-        for (const prov of providers) {
-          for (const model of prov.models) {
-            config = config.replace(
-              new RegExp(`^(\\s*)// ('${model.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}',?.*)$`, 'm'),
-              '$1$2'
-            );
+      // Uncomment selected models in eval.config.ts
+      const evalDir = d.existsSync(join(d.cwd(), 'tests', 'evals'))
+        ? join(d.cwd(), 'tests', 'evals')
+        : d.existsSync(join(d.cwd(), 'tests', 'sunpeak', 'evals'))
+          ? join(d.cwd(), 'tests', 'sunpeak', 'evals')
+          : null;
+      if (evalDir) {
+        const configPath = join(evalDir, 'eval.config.ts');
+        if (d.existsSync(configPath)) {
+          let config = d.readFileSync(configPath, 'utf-8');
+          for (const prov of providers) {
+            for (const model of prov.models) {
+              config = config.replace(
+                new RegExp(`^(\\s*)// ('${model.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}',?.*)$`, 'm'),
+                '$1$2'
+              );
+            }
           }
+          d.writeFileSync(configPath, config);
         }
-        d.writeFileSync(configPath, config);
-      }
 
-      // Prompt for API keys and write .env
-      const envLines = [];
-      const seen = new Set();
-      for (const prov of providers) {
-        if (seen.has(prov.envVar)) continue;
-        seen.add(prov.envVar);
-        const key = await d.password({
-          message: `${prov.envVar} (enter to skip)`,
-          mask: '*',
-        });
-        if (!d.isCancel(key) && key) {
-          envLines.push(`${prov.envVar}=${key}`);
+        // Prompt for API keys and write .env
+        const envLines = [];
+        const seen = new Set();
+        for (const prov of providers) {
+          if (seen.has(prov.envVar)) continue;
+          seen.add(prov.envVar);
+          const key = await d.password({
+            message: `${prov.envVar} (enter to skip)`,
+            mask: '*',
+          });
+          if (!d.isCancel(key) && key) {
+            envLines.push(`${prov.envVar}=${key}`);
+          }
+        }
+        if (envLines.length > 0 && evalDir) {
+          const relEnvPath = evalDir.startsWith(d.cwd()) ? evalDir.slice(d.cwd().length + 1) : evalDir;
+          d.writeFileSync(join(evalDir, '.env'), envLines.join('\n') + '\n');
+          d.log.info(`API keys saved to ${relEnvPath}/.env (gitignored)`);
         }
-      }
-      if (envLines.length > 0 && evalDir) {
-        const relEnvPath = evalDir.startsWith(d.cwd()) ? evalDir.slice(d.cwd().length + 1) : evalDir;
-        d.writeFileSync(join(evalDir, '.env'), envLines.join('\n') + '\n');
-        d.log.info(`API keys saved to ${relEnvPath}/.env (gitignored)`);
       }
     }
-  }
 
-  // Offer to install the testing skill
-  const installSkill = await d.confirm({
-    message: 'Install the test-mcp-server skill? (helps your coding agent write tests)',
-    initialValue: true,
-  });
-  if (!d.isCancel(installSkill) && installSkill) {
-    try {
-      d.execSync('pnpm dlx skills add Sunpeak-AI/sunpeak@test-mcp-server', {
-        cwd: d.cwd(),
-        stdio: 'inherit',
-      });
-    } catch {
-      d.log.info('Skill install skipped. Install later: pnpm dlx skills add Sunpeak-AI/sunpeak@test-mcp-server');
+    // Offer to install the testing skill
+    const installSkill = await d.confirm({
+      message: 'Install the test-mcp-server skill? (helps your coding agent write tests)',
+      initialValue: true,
+    });
+    if (!d.isCancel(installSkill) && installSkill) {
+      const pm = d.detectPackageManager();
+      const dlx = pm === 'yarn' ? 'yarn dlx' : pm === 'npm' ? 'npx' : 'pnpm dlx';
+      try {
+        d.execSync(`${dlx} skills add Sunpeak-AI/sunpeak@test-mcp-server`, {
+          cwd: d.cwd(),
+          stdio: 'inherit',
+        });
+      } catch {
+        d.log.info(`Skill install skipped. Install later: ${dlx} skills add Sunpeak-AI/sunpeak@test-mcp-server`);
+      }
     }
   }
 
@@ -191,6 +197,11 @@ async function getServerConfig(cliServer, d) {
     return { type: 'command', value: cliServer };
   }
 
+  // Without a TTY, interactive prompts can't work — default to "configure later".
+  if (!d.isTTY()) {
+    return { type: 'later' };
+  }
+
   const serverType = await d.select({
     message: 'How does your MCP server start?',
     options: [
@@ -348,7 +359,7 @@ function scaffoldEvals(evalsDir, { server, isSunpeak, d: deps } = {}) {
  * 2. Install the AI SDK and provider packages (e.g. pnpm add ai @ai-sdk/openai)
  * 3. Copy .env.example to .env and add your API keys
  * 4. Replace this file with evals for your own tools
- * 5. Run: sunpeak test --eval
+ * 5. Run: npx sunpeak test --eval
  *
  * Each case sends a prompt to every configured model and checks
  * that the model calls the expected tool with the expected arguments.
@@ -394,10 +405,10 @@ function scaffoldVisualTest(filePath, d) {
 /**
  * Visual regression tests — compare screenshots against saved baselines.
  *
- * Screenshots only run with: sunpeak test --visual
- * Update baselines with:     sunpeak test --visual --update
+ * Screenshots only run with: npx sunpeak test --visual
+ * Update baselines with:     npx sunpeak test --visual --update
  *
- * During normal \`sunpeak test\` runs, screenshot() calls are silently
+ * During normal \`npx sunpeak test\` runs, screenshot() calls are silently
  * skipped so these tests still pass without baselines.
  *
  * Uncomment the tests below and replace 'your-tool' with your tool name.
@@ -437,9 +448,9 @@ function scaffoldVisualTest(filePath, d) {
 /**
  * Scaffold live test boilerplate (test against real ChatGPT/Claude).
  * @param {string} liveDir - Directory to create live test files in
- * @param {{ isSunpeak?: boolean, d: object }} options
+ * @param {{ isSunpeak?: boolean, server?: object, d: object }} options
  */
-function scaffoldLiveTests(liveDir, { isSunpeak, d } = {}) {
+function scaffoldLiveTests(liveDir, { isSunpeak, server, d } = {}) {
   if (d.existsSync(join(liveDir, 'playwright.config.ts'))) {
     d.log.info('Live test config already exists. Skipping live test scaffold.');
     return;
@@ -456,12 +467,27 @@ function scaffoldLiveTests(liveDir, { isSunpeak, d } = {}) {
  * Prerequisites:
  * 1. Your MCP server must be accessible via a public URL (e.g., ngrok tunnel)
  * 2. The server must be registered as an MCP action in the host
- * 3. Run: sunpeak test --live
+ * 3. Run: npx sunpeak test --live
  *
  * On first run, a browser window opens for you to log in to the host.
- * The session is saved for subsequent runs (typically lasts a few hours).`;
+ * The session is saved for subsequent runs (typically lasts a few hours).
+ */`;
+
+  // Build the server option for non-sunpeak projects
+  let serverOption = '';
+  if (!isSunpeak && server?.type === 'url') {
+    serverOption = `\n  server: { url: '${server.value}' },`;
+  } else if (!isSunpeak && server?.type === 'command') {
+    const parts = server.value.split(/\s+/);
+    const cmd = parts[0];
+    const args = parts.slice(1);
+    serverOption = args.length > 0
+      ? `\n  server: { command: '${cmd}', args: [${args.map(a => `'${a}'`).join(', ')}] },`
+      : `\n  server: { command: '${cmd}' },`;
+  }
 
-  const liveConfigExport = `export default defineLiveConfig({
+  const configContent = `${liveConfigPreamble}
+export default defineLiveConfig({${serverOption}
   // hosts: ['chatgpt'],           // Which hosts to test against
   // colorScheme: 'light',         // Default color scheme
   // viewport: { width: 1280, height: 720 },
@@ -469,19 +495,6 @@ function scaffoldLiveTests(liveDir, { isSunpeak, d } = {}) {
 });
 `;
 
-  const configContent = isSunpeak
-    ? `${liveConfigPreamble}
- */
-${liveConfigExport}`
-    : `${liveConfigPreamble}
- *
- * NOTE: defineLiveConfig() starts a local sunpeak dev server as its backend.
- * If your MCP server is not a sunpeak project, you may need to customize the
- * webServer option in the Playwright config below to start your own server,
- * or remove webServer entirely if your server is already running.
- */
-${liveConfigExport}`;
-
   d.writeFileSync(join(liveDir, 'playwright.config.ts'), configContent);
 
   // Live test example
@@ -497,9 +510,9 @@ ${liveConfigExport}`;
  * - live.setColorScheme('dark', app) — switch theme while app is visible
  * - live.page — the underlying Playwright page
  *
- * Run with: sunpeak test --live
+ * Run with: npx sunpeak test --live
  *
- * These tests are excluded from normal \`sunpeak test\` runs because
+ * These tests are excluded from normal \`npx sunpeak test\` runs because
  * they require host accounts and cost API credits.
  */
 
@@ -542,7 +555,7 @@ function scaffoldUnitTest(filePath, d) {
  * Import your tool handler directly and test its input/output
  * without starting the MCP server or inspector.
  *
- * Run with: sunpeak test --unit
+ * Run with: npx sunpeak test --unit
  *
  * To set up vitest, add it to your devDependencies:
  *   npm install -D vitest
@@ -663,7 +676,7 @@ test('server exposes tools', async ({ mcp }) => {
   scaffoldVisualTest(join(testDir, 'visual.test.ts'), d);
 
   // 3. Live tests
-  scaffoldLiveTests(join(testDir, 'live'), { isSunpeak: false, d });
+  scaffoldLiveTests(join(testDir, 'live'), { isSunpeak: false, server, d });
 
   // 4. Eval boilerplate
   scaffoldEvals(join(testDir, 'evals'), { server, d });
@@ -690,10 +703,10 @@ test('server exposes tools', async ({ mcp }) => {
   }
 
   d.log.step('Ready! Run tests with:');
-  d.log.message('  sunpeak test              # E2E tests');
-  d.log.message('  sunpeak test --visual      # Visual regression (generates baselines on first run)');
-  d.log.message('  sunpeak test --live         # Live tests against real hosts (requires login)');
-  d.log.message('  sunpeak test --eval         # Multi-model evals (configure models in evals/eval.config.ts)');
+  d.log.message('  npx sunpeak test              # E2E tests');
+  d.log.message('  npx sunpeak test --visual      # Visual regression (generates baselines on first run)');
+  d.log.message('  npx sunpeak test --live         # Live tests against real hosts (requires login)');
+  d.log.message('  npx sunpeak test --eval         # Multi-model evals (configure models in evals/eval.config.ts)');
 }
 
 async function initJsProject(cliServer, d) {
@@ -757,7 +770,7 @@ test('server exposes tools', async ({ mcp }) => {
   scaffoldVisualTest(join(e2eDir, 'visual.test.ts'), d);
 
   // 3. Live tests
-  scaffoldLiveTests(join(cwd, 'tests', 'live'), { isSunpeak: false, d });
+  scaffoldLiveTests(join(cwd, 'tests', 'live'), { isSunpeak: false, server, d });
 
   // 4. Eval boilerplate
   scaffoldEvals(join(cwd, 'tests', 'evals'), { server, d });
@@ -773,11 +786,11 @@ test('server exposes tools', async ({ mcp }) => {
   d.log.message(`  ${pkgMgr} add -D sunpeak @playwright/test vitest`);
   d.log.message(`  ${pkgMgr} exec playwright install chromium`);
   d.log.message('');
-  d.log.message('  sunpeak test              # E2E tests');
-  d.log.message('  sunpeak test --unit        # Unit tests (vitest)');
-  d.log.message('  sunpeak test --visual      # Visual regression');
-  d.log.message('  sunpeak test --live         # Live tests against real hosts');
-  d.log.message('  sunpeak test --eval         # Multi-model evals');
+  d.log.message('  npx sunpeak test              # E2E tests');
+  d.log.message('  npx sunpeak test --unit        # Unit tests (vitest)');
+  d.log.message('  npx sunpeak test --visual      # Visual regression');
+  d.log.message('  npx sunpeak test --live         # Live tests against real hosts');
+  d.log.message('  npx sunpeak test --eval         # Multi-model evals');
 }
 
 async function initSunpeakProject(d) {
@@ -824,10 +837,10 @@ export default defineConfig();
   scaffoldUnitTest(join(cwd, 'tests', 'unit', 'example.test.ts'), d);
 
   d.log.step('Scaffolded test types:');
-  d.log.message('  tests/e2e/visual.test.ts    — Visual regression (sunpeak test --visual)');
-  d.log.message('  tests/live/                 — Live host tests (sunpeak test --live)');
-  d.log.message('  tests/evals/                — Multi-model evals (sunpeak test --eval)');
-  d.log.message('  tests/unit/example.test.ts  — Unit tests (sunpeak test --unit)');
+  d.log.message('  tests/e2e/visual.test.ts    — Visual regression (npx sunpeak test --visual)');
+  d.log.message('  tests/live/                 — Live host tests (npx sunpeak test --live)');
+  d.log.message('  tests/evals/                — Multi-model evals (npx sunpeak test --eval)');
+  d.log.message('  tests/unit/example.test.ts  — Unit tests (npx sunpeak test --unit)');
   d.log.message('');
   d.log.message('  Migrate existing e2e tests:');
   d.log.message('  Replace: import { test, expect } from "@playwright/test"');

package/bin/commands/test.mjs

@@ -85,12 +85,15 @@ export async function runTest(args) {
       configCandidates: [
         'tests/live/playwright.config.ts',
         'tests/live/playwright.config.js',
-        // Fallback for non-JS projects: tests/sunpeak/ self-contained directory
+        // Non-JS projects: tests/sunpeak/ self-contained directory (run from project root)
         'tests/sunpeak/live/playwright.config.ts',
         'tests/sunpeak/live/playwright.config.js',
+        // Non-JS projects: run from within tests/sunpeak/ directly
+        'live/playwright.config.ts',
+        'live/playwright.config.js',
       ],
       configRequired: true,
-      configErrorMessage: 'No live test config found at tests/live/playwright.config.ts',
+      configErrorMessage: 'No live test config found. Expected at tests/live/playwright.config.ts or live/playwright.config.ts',
     });
     results.push({ suite: 'live', code });
   }
@@ -537,6 +540,8 @@ function findEvalDir() {
   const candidates = [
     'tests/evals',
     'tests/sunpeak/evals',
+    // When running from within tests/sunpeak/ directly (non-JS projects)
+    'evals',
   ];
 
   for (const candidate of candidates) {

package/bin/lib/eval/eval-runner.mjs

@@ -77,7 +77,13 @@ export async function createMcpConnection(serverArg) {
     const { StreamableHTTPClientTransport } = await import(
       '@modelcontextprotocol/sdk/client/streamableHttp.js'
     );
-    const transport = new StreamableHTTPClientTransport(new URL(serverArg));
+    // Follow redirects (e.g. /mcp → /mcp/) before creating the transport.
+    let finalUrl = serverArg;
+    try {
+      const resp = await fetch(serverArg, { method: 'HEAD', redirect: 'follow' });
+      if (resp.url && resp.url !== serverArg) finalUrl = resp.url;
+    } catch { /* use original URL */ }
+    const transport = new StreamableHTTPClientTransport(new URL(finalUrl));
     await client.connect(transport);
     return { client, transport };
   } else {

package/bin/lib/inspect/inspect-config.mjs

@@ -79,7 +79,7 @@ export function defineInspectConfig(options) {
     timeout,
     webServer: {
       command,
-      healthUrl: `http://localhost:${port}/health`,
+      healthUrl: `http://127.0.0.1:${port}/health`,
     },
   });
 }

package/bin/lib/live/live-config.d.mts

@@ -28,6 +28,16 @@ export interface LiveConfigOptions {
 
   /** Additional Playwright `use` options, merged with defaults. */
   use?: Record<string, unknown>;
+
+  /** External MCP server config. Omit for sunpeak framework projects. */
+  server?: {
+    /** Server URL (e.g., 'http://localhost:8000/mcp') */
+    url?: string;
+    /** Server start command */
+    command?: string;
+    /** Command arguments */
+    args?: string[];
+  };
 }
 
 export interface HostConfigOptions {

package/bin/lib/live/live-config.mjs

@@ -11,6 +11,7 @@ import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { ANTI_BOT_ARGS, CHROME_USER_AGENT } from './utils.mjs';
 import { getPortSync } from '../get-port.mjs';
+import { resolveSunpeakBin } from '../resolve-bin.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const GLOBAL_SETUP_PATH = join(__dirname, 'global-setup.mjs');
@@ -34,6 +35,10 @@ const GLOBAL_SETUP_PATH = join(__dirname, 'global-setup.mjs');
  * @param {string[]} [options.permissions] - Browser permissions to grant (e.g., ['geolocation'])
  * @param {boolean} [options.devOverlay=true] - Show the dev overlay (resource timestamp + tool timing) in resources
  * @param {Object} [options.use] - Additional Playwright `use` options (merged with defaults)
+ * @param {Object} [options.server] - External MCP server config (omit for sunpeak projects)
+ * @param {string} [options.server.url] - Server URL (e.g., 'http://localhost:8000/mcp')
+ * @param {string} [options.server.command] - Server start command
+ * @param {string[]} [options.server.args] - Command arguments
  */
 export function createLiveConfig(hostOptions, options = {}) {
   const { hostId, authFileName } = hostOptions;
@@ -49,6 +54,7 @@ export function createLiveConfig(hostOptions, options = {}) {
     geolocation,
     permissions,
     use: userUse,
+    server,
   } = options;
 
   const resolvedAuthDir = authDir || join(testDir, '.auth');
@@ -91,10 +97,36 @@ export function createLiveConfig(hostOptions, options = {}) {
       },
     ],
     webServer: {
-      command: `SUNPEAK_LIVE_TEST=1 SUNPEAK_SANDBOX_PORT=${getPortSync(24680)}${devOverlay ? '' : ' SUNPEAK_DEV_OVERLAY=false'} pnpm dev -- --prod-resources --port ${vitePort}`,
-      url: `http://localhost:${vitePort}/health`,
+      command: buildLiveWebServerCommand({ server, vitePort, devOverlay }),
+      url: `http://127.0.0.1:${vitePort}/health`,
       reuseExistingServer: !process.env.CI,
       timeout: 60_000,
     },
   };
 }
+
+/**
+ * Build the webServer command for live tests.
+ * Uses `sunpeak inspect` for external servers, `pnpm dev` for sunpeak projects.
+ */
+function buildLiveWebServerCommand({ server, vitePort, devOverlay }) {
+  const sandboxPort = getPortSync(24680);
+  const envPrefix = `SUNPEAK_LIVE_TEST=1 SUNPEAK_SANDBOX_PORT=${sandboxPort}${devOverlay ? '' : ' SUNPEAK_DEV_OVERLAY=false'}`;
+
+  if (server) {
+    // External MCP server — launch sunpeak inspect
+    const bin = resolveSunpeakBin();
+    if (server.url) {
+      return `${envPrefix} ${bin} inspect --server ${server.url} --port ${vitePort}`;
+    }
+    if (server.command) {
+      const cmd = server.args
+        ? `${server.command} ${server.args.join(' ')}`
+        : server.command;
+      return `${envPrefix} ${bin} inspect --server "${cmd}" --port ${vitePort}`;
+    }
+  }
+
+  // sunpeak framework project — use pnpm dev
+  return `${envPrefix} pnpm dev -- --prod-resources --port ${vitePort}`;
+}

package/bin/lib/test/base-config.mjs

@@ -44,7 +44,9 @@ export function createBaseConfig({ hosts, testDir, webServer, port, use, globalS
       ? { expect: { toHaveScreenshot: toHaveScreenshotDefaults } }
       : {}),
     use: {
-      baseURL: `http://localhost:${port}`,
+      // Use 127.0.0.1 instead of localhost to avoid IPv4/IPv6 resolution
+      // ambiguity that causes ECONNREFUSED flakes on macOS.
+      baseURL: `http://127.0.0.1:${port}`,
       trace: 'on-first-retry',
       ...use,
     },

package/bin/lib/test/test-config.mjs

@@ -76,7 +76,7 @@ export function defineConfig(options = {}) {
     timeout,
     webServer: {
       command,
-      healthUrl: `http://localhost:${port}/health`,
+      healthUrl: `http://127.0.0.1:${port}/health`,
     },
   });
 }

package/bin/sunpeak.js

@@ -102,22 +102,11 @@ function getVersion() {
       {
         const resources = discoverResources();
         console.log(`
-☀️ 🏔️ sunpeak - Inspector, testing framework, and app framework for MCP Apps
+☀️ 🏔️ sunpeak - App framework, testing framework, and inspector for MCP Apps
 
-Install:
-  pnpm add -g sunpeak
+Usage: npx sunpeak <command>
 
-Testing (works with any MCP server):
-  sunpeak inspect          Inspect any MCP server in the inspector
-    --server, -s <url|cmd> MCP server URL or stdio command (required)
-    --simulations <dir>    Simulation JSON directory
-  sunpeak test             Run e2e tests against the inspector
-    init                   Scaffold test infrastructure into a project
-    --unit                 Run unit tests (vitest)
-    --live                 Run live tests against real hosts
-    --eval                 Run evals against LLM models
-
-App framework (for sunpeak projects):
+App framework:
   sunpeak new [name] [resources]  Create a new project
   sunpeak dev              Start dev server + inspector + MCP endpoint
     --no-begging           Suppress GitHub star message
@@ -125,8 +114,20 @@ App framework (for sunpeak projects):
   sunpeak start            Start production MCP server
     --port, -p             Server port (default: 8000, or PORT env)
   sunpeak upgrade          Upgrade sunpeak to latest version
-  sunpeak --version        Show version number
 
+Testing (works with any MCP server):
+  sunpeak test             Run e2e tests against the inspector
+    init                   Scaffold test infrastructure into a project
+    --unit                 Run unit tests (vitest)
+    --live                 Run live tests against real hosts
+    --eval                 Run evals against LLM models
+
+Inspector (works with any MCP server):
+  sunpeak inspect          Inspect any MCP server in the inspector
+    --server, -s <url|cmd> MCP server URL or stdio command (required)
+    --simulations <dir>    Simulation JSON directory
+
+  sunpeak --version        Show version number
   Resources: ${resources.join(', ')} (comma/space separated)
   Example: sunpeak new sunpeak-app "${resources.slice(0, 2).join(',')}"
 `);

package/dist/chatgpt/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../chunk-9hOWP6kD.cjs");
-const require_inspector = require("../inspector-DAA1Wiyh.cjs");
+const require_inspector = require("../inspector-D0qOqYX2.cjs");
 const require_inspector_url = require("../inspector-url-C3LTKgXt.cjs");
 const require_discovery = require("../discovery-Clu4uHp1.cjs");
 //#region src/chatgpt/index.ts

package/dist/chatgpt/index.js

@@ -1,5 +1,5 @@
 import { r as __exportAll } from "../chunk-D6g4UhsZ.js";
-import { _ as McpAppHost, d as ThemeProvider, f as useThemeContext, g as extractResourceCSP, h as IframeResource, n as resolveServerToolResult, t as Inspector, v as SCREEN_WIDTHS } from "../inspector-BBDa5yCm.js";
+import { _ as McpAppHost, d as ThemeProvider, f as useThemeContext, g as extractResourceCSP, h as IframeResource, n as resolveServerToolResult, t as Inspector, v as SCREEN_WIDTHS } from "../inspector-60Na_Zc4.js";
 import { t as createInspectorUrl } from "../inspector-url-CyQcuBI9.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/chatgpt/index.ts

package/dist/claude/index.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../chunk-9hOWP6kD.cjs");
-const require_inspector = require("../inspector-DAA1Wiyh.cjs");
+const require_inspector = require("../inspector-D0qOqYX2.cjs");
 exports.Inspector = require_inspector.Inspector;

package/dist/claude/index.js

@@ -1,2 +1,2 @@
-import { t as Inspector } from "../inspector-BBDa5yCm.js";
+import { t as Inspector } from "../inspector-60Na_Zc4.js";
 export { Inspector };

package/dist/host/chatgpt/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-9hOWP6kD.cjs");
-const require_use_app = require("../../use-app-DPkj5Jp_.cjs");
+const require_use_app = require("../../use-app-B33mckz4.cjs");
 let react = require("react");
 //#region src/host/chatgpt/openai-types.ts
 /**

package/dist/host/chatgpt/index.js

@@ -1,4 +1,4 @@
-import { t as useApp } from "../../use-app-Cr0auUa1.js";
+import { t as useApp } from "../../use-app-kv5GQr0G.js";
 import { useCallback } from "react";
 //#region src/host/chatgpt/openai-types.ts
 /**

package/dist/index.cjs

@@ -1,15 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-9hOWP6kD.cjs");
 const require_protocol = require("./protocol-C8pFDmcy.cjs");
-const require_use_app = require("./use-app-DPkj5Jp_.cjs");
-const require_inspector = require("./inspector-DAA1Wiyh.cjs");
+const require_use_app = require("./use-app-B33mckz4.cjs");
+const require_inspector = require("./inspector-D0qOqYX2.cjs");
 const require_host_index = require("./host/index.cjs");
 const require_inspector_index = require("./inspector/index.cjs");
 const require_chatgpt_index = require("./chatgpt/index.cjs");
 let react = require("react");
 react = require_chunk.__toESM(react, 1);
 let react_jsx_runtime = require("react/jsx-runtime");
-//#region ../../node_modules/.pnpm/@modelcontextprotocol+ext-apps@1.5.0_@modelcontextprotocol+sdk@1.29.0_zod@4.3.6__react-_a8a8e071c354e7dd6f62871eadf46f99/node_modules/@modelcontextprotocol/ext-apps/dist/src/react/index.js
+//#region ../../node_modules/.pnpm/@modelcontextprotocol+ext-apps@1.6.0_@modelcontextprotocol+sdk@1.29.0_zod@4.3.6__react-_1fd7d0151a0915598274278e5ddb69e9/node_modules/@modelcontextprotocol/ext-apps/dist/src/react/index.js
 var m = require_protocol.union([require_protocol.literal("light"), require_protocol.literal("dark")]).describe("Color theme preference for the host environment."), N$1 = require_protocol.union([
 	require_protocol.literal("inline"),
 	require_protocol.literal("fullscreen"),