sunpeak 0.16.1 → 0.16.2

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

@@ -178,7 +178,7 @@ export async function dev(projectRoot = process.cwd(), args = []) {
     sunpeakMcp = await import(pathToFileURL(join(sunpeakBase, 'dist/mcp/index.js')).href);
     sunpeakDiscovery = await import(pathToFileURL(join(sunpeakBase, 'dist/lib/discovery-cli.js')).href);
   }
-  const { FAVICON_BUFFER: faviconBuffer, runMCPServer } = sunpeakMcp;
+  const { FAVICON_BUFFER: faviconBuffer, runMCPServer, startProductionHttpServer } = sunpeakMcp;
   const { findResourceDirs, findSimulationFilesFlat, findToolFiles, extractResourceExport, extractToolExport } = sunpeakDiscovery;
 
   // Vite plugin to serve the sunpeak favicon
@@ -389,13 +389,109 @@ if (import.meta.hot) {
     }
 
     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 }),
-    });
+
+    let mcpHandle = null;
+
+    if (prodMcp) {
+      // --prod-mcp: Use real tool handlers via Vite SSR
+      // Load full tool modules (handler + schema + config) from TypeScript source
+      const ssrLoader = await createServer({
+        root: projectRoot,
+        server: { middlewareMode: true },
+        appType: 'custom',
+        logLevel: 'silent',
+        resolve: {
+          alias: {
+            ...(isTemplate && { sunpeak: parentSrc }),
+          },
+        },
+      });
+
+      const prodTools = [];
+      for (const { name: toolName, path: toolPath } of toolFiles) {
+        try {
+          const relativePath = './' + toolPath.replace(projectRoot + '/', '').replace(projectRoot + '\\', '');
+          const mod = await ssrLoader.ssrLoadModule(relativePath);
+          if (mod.tool && mod.default) {
+            prodTools.push({
+              name: toolName,
+              tool: mod.tool,
+              schema: mod.schema,
+              handler: mod.default,
+            });
+          }
+        } catch (err) {
+          console.warn(`Warning: Could not load tool handler ${toolName}: ${err.message}`);
+        }
+      }
+
+      // Load server entry if present
+      const serverEntryPath = join(projectRoot, 'src/server.ts');
+      let auth = undefined;
+      let serverConfig = {};
+      if (existsSync(serverEntryPath)) {
+        try {
+          const serverMod = await ssrLoader.ssrLoadModule('./src/server.ts');
+          if (typeof serverMod.auth === 'function') {
+            auth = serverMod.auth;
+            console.log('Loaded auth from src/server.ts');
+          }
+          if (serverMod.server) serverConfig = serverMod.server;
+        } catch (err) {
+          console.warn(`Warning: Could not load server entry: ${err.message}`);
+        }
+      }
+
+      await ssrLoader.close();
+
+      // Build production resources from dist/
+      const prodResources = [];
+      for (const { key } of resourceDirs) {
+        const meta = resourceMap.get(key);
+        if (!meta) continue;
+        const htmlPath = join(projectRoot, `dist/${key}/${key}.html`);
+        const jsonPath = join(projectRoot, `dist/${key}/${key}.json`);
+        if (!existsSync(htmlPath)) continue;
+
+        const html = readFileSync(htmlPath, 'utf-8');
+        let uri = `ui://${meta.name ?? key}`;
+        let _meta = meta._meta;
+
+        // Use URI from build JSON if available (has cache-bust timestamp)
+        if (existsSync(jsonPath)) {
+          try {
+            const buildMeta = JSON.parse(readFileSync(jsonPath, 'utf-8'));
+            if (buildMeta.uri) uri = buildMeta.uri;
+          } catch {}
+        }
+
+        prodResources.push({
+          name: meta.name ?? key,
+          uri,
+          html,
+          description: meta.description,
+          _meta,
+        });
+      }
+
+      const name = serverConfig.name ?? pkg.name ?? 'Sunpeak';
+      const version = serverConfig.version ?? pkg.version ?? '0.1.0';
+
+      console.log(`Starting production MCP server with ${prodTools.length} tool(s)...`);
+      startProductionHttpServer(
+        { name, version, tools: prodTools, resources: prodResources, auth },
+        8000
+      );
+    } else {
+      // Default: simulation-based MCP server with fixture data
+      mcpHandle = runMCPServer({
+        name: pkg.name || 'Sunpeak',
+        version: pkg.version || '0.1.0',
+        simulations,
+        port: 8000,
+        ...(mcpViteServer && { viteServer: mcpViteServer }),
+      });
+    }
 
     // Build production bundles and watch for changes.
     // Tunnel clients (e.g. Claude via ngrok) get the pre-built HTML since they can't

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,10 @@ 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
+    --prod-mcp             Use real tool handlers (not fixtures)
+  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