sunpeak 0.16.1 → 0.16.3

package/README.md

@@ -88,7 +88,8 @@ Commands for managing MCP Apps:
 
 - `sunpeak new [name] [resources]` - Create a new project
 - `sunpeak dev` - Start dev server with MCP endpoint and live simulator
-- `sunpeak build` - Build resources for production
+- `sunpeak build` - Build resources and compile tools for production
+- `sunpeak start` - Start the production MCP server (real handlers, auth, Zod validation)
 - `sunpeak upgrade` - Upgrade sunpeak to latest version
 
 ## Example App

package/bin/commands/build.mjs

@@ -340,10 +340,114 @@ ${jsContents}
 
   console.log('\n✓ All resources built successfully!');
   console.log('\nBuilt resources:');
-  for (const { kebabName, distOutDir } of resourceFiles) {
-    const files = readdirSync(distOutDir);
+  for (const { kebabName } of resourceFiles) {
     console.log(`  ${kebabName}`);
   }
+
+  // ========================================================================
+  // Compile server-side code (tools + server entry) for `sunpeak start`
+  // ========================================================================
+
+  const toolsDir = path.join(projectRoot, 'src/tools');
+  const serverEntryPath = path.join(projectRoot, 'src/server.ts');
+
+  // Find tool files
+  const toolFiles = existsSync(toolsDir)
+    ? readdirSync(toolsDir).filter(f => f.endsWith('.ts'))
+    : [];
+
+  const hasServerEntry = existsSync(serverEntryPath);
+
+  if (toolFiles.length > 0 || hasServerEntry) {
+    console.log('\nCompiling server-side code...');
+
+    let esbuild;
+    try {
+      const esbuildPath = resolveEsmEntry(require, 'esbuild');
+      esbuild = await import(esbuildPath);
+    } catch {
+      console.warn('Warning: esbuild not found — skipping tool/server compilation.');
+      console.warn('Install esbuild to enable `sunpeak start`: npm install -D esbuild');
+      esbuild = null;
+    }
+
+    if (esbuild) {
+      const toolsOutDir = path.join(distDir, 'tools');
+      if (toolFiles.length > 0) {
+        mkdirSync(toolsOutDir, { recursive: true });
+      }
+
+      // Compile each tool file
+      for (const toolFile of toolFiles) {
+        const toolName = toolFile.replace(/\.ts$/, '');
+        const toolPath = path.join(toolsDir, toolFile);
+
+        try {
+          await esbuild.build({
+            entryPoints: [toolPath],
+            bundle: true,
+            format: 'esm',
+            platform: 'node',
+            target: 'node18',
+            outfile: path.join(toolsOutDir, `${toolName}.js`),
+            // Externalize bare specifiers (node_modules) — resolve at runtime
+            plugins: [{
+              name: 'externalize-bare-specifiers',
+              setup(build) {
+                build.onResolve({ filter: /.*/ }, (args) => {
+                  if (args.kind !== 'import-statement') return;
+                  if (!args.path.startsWith('.') && !args.path.startsWith('/')) {
+                    return { external: true };
+                  }
+                  return undefined;
+                });
+              },
+            }],
+            loader: { '.tsx': 'tsx', '.ts': 'ts' },
+            logLevel: 'warning',
+          });
+          console.log(`✓ Compiled tools/${toolName}.js`);
+        } catch (err) {
+          console.error(`Failed to compile tool ${toolName}:`, err.message);
+          process.exit(1);
+        }
+      }
+
+      // Compile server entry if present
+      if (hasServerEntry) {
+        try {
+          await esbuild.build({
+            entryPoints: [serverEntryPath],
+            bundle: true,
+            format: 'esm',
+            platform: 'node',
+            target: 'node18',
+            outfile: path.join(distDir, 'server.js'),
+            plugins: [{
+              name: 'externalize-bare-specifiers',
+              setup(build) {
+                build.onResolve({ filter: /.*/ }, (args) => {
+                  if (args.kind !== 'import-statement') return;
+                  if (!args.path.startsWith('.') && !args.path.startsWith('/')) {
+                    return { external: true };
+                  }
+                  return undefined;
+                });
+              },
+            }],
+            loader: { '.tsx': 'tsx', '.ts': 'ts' },
+            logLevel: 'warning',
+          });
+          console.log(`✓ Compiled server.js`);
+        } catch (err) {
+          console.error(`Failed to compile server entry:`, err.message);
+          process.exit(1);
+        }
+      }
+    }
+  }
+
+  console.log('\n✓ Build complete!');
 }
 
 // Allow running directly

package/bin/commands/dev.mjs

@@ -149,9 +149,6 @@ export async function dev(projectRoot = process.cwd(), args = []) {
   // Parse --no-begging flag
   const noBegging = args.includes('--no-begging');
 
-  // Parse --prod-mcp flag (serve production build files over MCP instead of Vite HMR)
-  const prodMcp = args.includes('--prod-mcp');
-
   console.log(`Starting Vite dev server on port ${port}...`);
 
   // Check if we're in the sunpeak workspace (directory is named "template")
@@ -296,33 +293,29 @@ export async function dev(projectRoot = process.cwd(), args = []) {
     });
   }
 
-  // Start MCP server with its own Vite instance (unless --prod-mcp is set)
+  // Start MCP server with its own Vite instance for HMR
   if (simulations.length > 0) {
-    const mcpMode = prodMcp ? 'production build' : 'Vite HMR';
-    console.log(`\nStarting MCP server with ${simulations.length} simulation(s) (${mcpMode})...`);
-
-    let mcpViteServer = null;
-
-    if (!prodMcp) {
-      // Virtual entry module plugin for MCP
-      const sunpeakEntryPlugin = () => ({
-        name: 'sunpeak-entry',
-        resolveId(id) {
-          if (id.startsWith('virtual:sunpeak-entry')) {
-            return id;
+    console.log(`\nStarting MCP server with ${simulations.length} simulation(s) (Vite HMR)...`);
+
+    // Virtual entry module plugin for MCP
+    const sunpeakEntryPlugin = () => ({
+      name: 'sunpeak-entry',
+      resolveId(id) {
+        if (id.startsWith('virtual:sunpeak-entry')) {
+          return id;
+        }
+      },
+      load(id) {
+        if (id.startsWith('virtual:sunpeak-entry')) {
+          const url = new URL(id.replace('virtual:sunpeak-entry', 'http://x'));
+          const srcPath = url.searchParams.get('src');
+          const componentName = url.searchParams.get('component');
+
+          if (!srcPath || !componentName) {
+            return 'console.error("Missing src or component param");';
           }
-        },
-        load(id) {
-          if (id.startsWith('virtual:sunpeak-entry')) {
-            const url = new URL(id.replace('virtual:sunpeak-entry', 'http://x'));
-            const srcPath = url.searchParams.get('src');
-            const componentName = url.searchParams.get('component');
-
-            if (!srcPath || !componentName) {
-              return 'console.error("Missing src or component param");';
-            }
 
-            return `
+          return `
 import { createElement } from 'react';
 import { createRoot } from 'react-dom/client';
 import { AppProvider } from 'sunpeak';
@@ -349,52 +342,52 @@ if (import.meta.hot) {
   import.meta.hot.accept();
 }
 `;
-          }
-        },
-      });
+        }
+      },
+    });
 
-      // Create Vite dev server in middleware mode for MCP
-      // Use separate cache directory to avoid conflicts with main dev server
-      mcpViteServer = await createServer({
-        root: projectRoot,
-        cacheDir: 'node_modules/.vite-mcp',
-        plugins: [react(), tailwindcss(), sunpeakEntryPlugin()],
-        resolve: {
-          alias: {
-            ...(isTemplate && {
-              sunpeak: parentSrc,
-            }),
-          },
+    // Create Vite dev server in middleware mode for MCP
+    // Use separate cache directory to avoid conflicts with main dev server
+    const mcpViteServer = await createServer({
+      root: projectRoot,
+      cacheDir: 'node_modules/.vite-mcp',
+      plugins: [react(), tailwindcss(), sunpeakEntryPlugin()],
+      resolve: {
+        alias: {
+          ...(isTemplate && {
+            sunpeak: parentSrc,
+          }),
         },
-        server: {
-          middlewareMode: true,
-          allowedHosts: true,
-          watch: {
-            // Only watch files that affect the UI bundle (not JSON, tests, etc.)
-            // MCP resources reload on next tool call, not on file change
-            ignored: (filePath) => {
-              if (!filePath.includes('.')) return false; // Watch directories
-              if (/\.(tsx?|css)$/.test(filePath)) {
-                return /\.(test|spec)\.tsx?$/.test(filePath); // Ignore tests
-              }
-              return true; // Ignore everything else
-            },
+      },
+      server: {
+        middlewareMode: true,
+        allowedHosts: true,
+        watch: {
+          // Only watch files that affect the UI bundle (not JSON, tests, etc.)
+          // MCP resources reload on next tool call, not on file change
+          ignored: (filePath) => {
+            if (!filePath.includes('.')) return false; // Watch directories
+            if (/\.(tsx?|css)$/.test(filePath)) {
+              return /\.(test|spec)\.tsx?$/.test(filePath); // Ignore tests
+            }
+            return true; // Ignore everything else
           },
         },
-        optimizeDeps: {
-          include: ['react', 'react-dom/client'],
-        },
-        appType: 'custom',
-      });
-    }
+      },
+      optimizeDeps: {
+        include: ['react', 'react-dom/client'],
+      },
+      appType: 'custom',
+    });
 
     const pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+
     const mcpHandle = runMCPServer({
       name: pkg.name || 'Sunpeak',
       version: pkg.version || '0.1.0',
       simulations,
       port: 8000,
-      ...(mcpViteServer && { viteServer: mcpViteServer }),
+      viteServer: mcpViteServer,
     });
 
     // Build production bundles and watch for changes.
@@ -406,13 +399,13 @@ if (import.meta.hot) {
 
     // Handle signals - close both servers
     process.on('SIGINT', async () => {
-      if (mcpViteServer) await mcpViteServer.close();
+      await mcpViteServer.close();
       await server.close();
       process.exit(0);
     });
 
     process.on('SIGTERM', async () => {
-      if (mcpViteServer) await mcpViteServer.close();
+      await mcpViteServer.close();
       await server.close();
       process.exit(0);
     });

package/bin/commands/start.mjs

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { createRequire } from 'module';
+import { pathToFileURL } from 'url';
+
+/**
+ * Start a production MCP server from built artifacts.
+ *
+ * Discovers compiled tools from dist/tools/, resources from dist/{name}/,
+ * and optional server entry from dist/server.js. Registers tools with
+ * real handlers and Zod schemas, serves pre-built resource HTML.
+ *
+ * Run `sunpeak build` before `sunpeak start`.
+ */
+export async function start(projectRoot = process.cwd(), args = []) {
+  const pkgJsonPath = join(projectRoot, 'package.json');
+  if (!existsSync(pkgJsonPath)) {
+    console.error('Error: No package.json found in current directory');
+    console.error('Make sure you are in a Sunpeak project directory');
+    process.exit(1);
+  }
+
+  const pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+  const distDir = join(projectRoot, 'dist');
+
+  if (!existsSync(distDir)) {
+    console.error('Error: No dist/ directory found. Run `sunpeak build` first.');
+    process.exit(1);
+  }
+
+  // Parse port from args or env
+  let port = parseInt(process.env.PORT || '8000');
+  const portArgIndex = args.findIndex(arg => arg === '--port' || arg === '-p');
+  if (portArgIndex !== -1 && args[portArgIndex + 1]) {
+    port = parseInt(args[portArgIndex + 1]);
+  }
+
+  // Import production server from sunpeak
+  const isTemplate = projectRoot.endsWith('/template') || projectRoot.endsWith('\\template');
+  let sunpeakMcp;
+  if (isTemplate) {
+    // In workspace dev mode — import from TypeScript source via dynamic import
+    // We compile on the fly using the parent's Vite (same pattern as dev.mjs)
+    const parentSrc = join(projectRoot, '../src');
+    const require = createRequire(pkgJsonPath);
+    const vite = await import(findEsmEntry(require, 'vite'));
+    const loaderServer = await vite.createServer({
+      root: join(projectRoot, '..'),
+      server: { middlewareMode: true },
+      appType: 'custom',
+      logLevel: 'silent',
+    });
+    sunpeakMcp = await loaderServer.ssrLoadModule('./src/mcp/index.ts');
+    await loaderServer.close();
+  } else {
+    const require = createRequire(pkgJsonPath);
+    const sunpeakBase = require.resolve('sunpeak').replace(/dist\/index\.(c)?js$/, '');
+    sunpeakMcp = await import(pathToFileURL(join(sunpeakBase, 'dist/mcp/index.js')).href);
+  }
+
+  const { startProductionHttpServer } = sunpeakMcp;
+
+  // ========================================================================
+  // Discover built resources
+  // ========================================================================
+
+  const resources = [];
+  const entries = readdirSync(distDir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (!entry.isDirectory() || entry.name === 'tools' || entry.name === 'build-output') continue;
+
+    const name = entry.name;
+    const jsonPath = join(distDir, name, `${name}.json`);
+    const htmlPath = join(distDir, name, `${name}.html`);
+
+    if (!existsSync(jsonPath) || !existsSync(htmlPath)) continue;
+
+    const meta = JSON.parse(readFileSync(jsonPath, 'utf-8'));
+    const html = readFileSync(htmlPath, 'utf-8');
+
+    resources.push({
+      name: meta.name ?? name,
+      uri: meta.uri ?? `ui://${name}`,
+      html,
+      description: meta.description,
+      _meta: meta._meta,
+    });
+  }
+
+  if (resources.length === 0) {
+    console.error('Error: No built resources found in dist/. Run `sunpeak build` first.');
+    process.exit(1);
+  }
+
+  console.log(`Found ${resources.length} resource(s): ${resources.map(r => r.name).join(', ')}`);
+
+  // ========================================================================
+  // Load compiled tool modules
+  // ========================================================================
+
+  const toolsDir = join(distDir, 'tools');
+  const tools = [];
+
+  if (existsSync(toolsDir)) {
+    const toolFiles = readdirSync(toolsDir).filter(f => f.endsWith('.js'));
+
+    for (const file of toolFiles) {
+      const toolName = file.replace(/\.js$/, '');
+      const toolPath = pathToFileURL(join(toolsDir, file)).href;
+
+      try {
+        const mod = await import(toolPath);
+        const tool = mod.tool;
+        const schema = mod.schema;
+        const handler = mod.default;
+
+        if (!tool) {
+          console.warn(`Warning: No "tool" export in ${file}. Skipping.`);
+          continue;
+        }
+        if (!handler || typeof handler !== 'function') {
+          console.warn(`Warning: No default handler export in ${file}. Skipping.`);
+          continue;
+        }
+
+        tools.push({ name: toolName, tool, schema, handler });
+      } catch (err) {
+        console.error(`Failed to load tool ${toolName}:`, err.message);
+        process.exit(1);
+      }
+    }
+  }
+
+  if (tools.length === 0) {
+    console.error('Error: No compiled tools found in dist/tools/. Run `sunpeak build` first.');
+    process.exit(1);
+  }
+
+  console.log(`Found ${tools.length} tool(s): ${tools.map(t => t.name).join(', ')}`);
+
+  // ========================================================================
+  // Load server entry (optional)
+  // ========================================================================
+
+  const serverEntryPath = join(distDir, 'server.js');
+  let auth = undefined;
+  let serverConfig = {};
+
+  if (existsSync(serverEntryPath)) {
+    try {
+      const serverEntry = await import(pathToFileURL(serverEntryPath).href);
+      if (typeof serverEntry.auth === 'function') {
+        auth = serverEntry.auth;
+        console.log('Loaded auth from server entry');
+      }
+      if (serverEntry.server) {
+        serverConfig = serverEntry.server;
+      }
+    } catch (err) {
+      console.error('Failed to load server entry:', err.message);
+      process.exit(1);
+    }
+  }
+
+  // ========================================================================
+  // Start production MCP server
+  // ========================================================================
+
+  const name = serverConfig.name ?? pkg.name ?? 'sunpeak-app';
+  const version = serverConfig.version ?? pkg.version ?? '0.1.0';
+
+  console.log(`\nStarting ${name} v${version} on port ${port}...`);
+
+  startProductionHttpServer(
+    { name, version, tools, resources, auth },
+    port
+  );
+}
+
+/**
+ * Resolve ESM entry point for a package (same utility as build.mjs)
+ */
+function findEsmEntry(require, packageName) {
+  const resolvedPath = require.resolve(packageName);
+  let dir = dirname(resolvedPath);
+  while (dir !== dirname(dir)) {
+    const pkgPath = join(dir, 'package.json');
+    if (existsSync(pkgPath)) {
+      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+      if (pkg.name === packageName) {
+        const exports = pkg.exports;
+        if (exports?.['.']?.import) {
+          const importEntry = exports['.'].import;
+          const esmPath = typeof importEntry === 'string' ? importEntry : importEntry.default;
+          if (esmPath) return pathToFileURL(join(dir, esmPath)).href;
+        }
+        if (pkg.module) return pathToFileURL(join(dir, pkg.module)).href;
+        break;
+      }
+    }
+    dir = dirname(dir);
+  }
+  return pathToFileURL(resolvedPath).href;
+}
+
+// Allow running directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const args = process.argv.slice(2);
+  start(process.cwd(), args).catch(error => {
+    console.error('Error:', error.message);
+    process.exit(1);
+  });
+}

package/bin/sunpeak.js

@@ -65,6 +65,13 @@ function getVersion() {
       }
       break;
 
+    case 'start':
+      {
+        const { start } = await import(join(COMMANDS_DIR, 'start.mjs'));
+        await start(process.cwd(), args);
+      }
+      break;
+
     case 'upgrade':
       {
         const { upgrade } = await import(join(COMMANDS_DIR, 'upgrade.mjs'));
@@ -90,7 +97,9 @@ Usage:
   sunpeak new [name] [resources]  Create a new project
   sunpeak dev              Start dev server + MCP endpoint
     --no-begging           Suppress GitHub star message
-  sunpeak build            Build resources
+  sunpeak build            Build resources + tools for production
+  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
 

package/dist/chatgpt/index.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const simulator = require("../simulator-B56j5P8W.cjs");
-const chatgpt_index = require("../index-BvQ_ZuOO.cjs");
+const simulator = require("../simulator-DjZNa1MI.cjs");
+const chatgpt_index = require("../index-Bll1bszc.cjs");
 const simulatorUrl = require("../simulator-url-rgg_KYOg.cjs");
 const discovery = require("../discovery-DmB8_4QL.cjs");
 exports.IframeResource = simulator.IframeResource;

package/dist/chatgpt/index.js

@@ -1,5 +1,5 @@
-import { I, M, a, S, T, j, m } from "../simulator-C0H_k092.js";
-import { C } from "../index-CTGEqlgk.js";
+import { I, M, a, S, T, j, m } from "../simulator-B7rw83zP.js";
+import { C } from "../index-CACtnwu2.js";
 import { c } from "../simulator-url-CuLqtnSS.js";
 import { b, a as a2, c as c2, d, e, f, g, h, i, t } from "../discovery-CH80W5l9.js";
 export {

package/dist/claude/index.cjs

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const simulator = require("../simulator-B56j5P8W.cjs");
+const simulator = require("../simulator-DjZNa1MI.cjs");
 exports.ClaudeSimulator = simulator.Simulator;
 //# sourceMappingURL=index.cjs.map

package/dist/claude/index.js

@@ -1,4 +1,4 @@
-import { S } from "../simulator-C0H_k092.js";
+import { S } from "../simulator-B7rw83zP.js";
 export {
   S as ClaudeSimulator
 };

package/dist/{index-BvQ_ZuOO.cjs → index-Bll1bszc.cjs}

@@ -1,5 +1,5 @@
 "use strict";
-const simulator = require("./simulator-B56j5P8W.cjs");
+const simulator = require("./simulator-DjZNa1MI.cjs");
 const jsxRuntime = require("react/jsx-runtime");
 const React = require("react");
 const simulatorUrl = require("./simulator-url-rgg_KYOg.cjs");
@@ -521,4 +521,4 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
 }, Symbol.toStringTag, { value: "Module" }));
 exports.ChatGPTSimulator = ChatGPTSimulator;
 exports.index = index;
-//# sourceMappingURL=index-BvQ_ZuOO.cjs.map
+//# sourceMappingURL=index-Bll1bszc.cjs.map