sunpeak 0.9.12 → 0.10.3

package/dist/lib/discovery.d.ts

@@ -35,25 +35,16 @@ type GlobModules = Record<string, unknown>;
  * Extracts components and exports them with PascalCase names.
  *
  * @example
- * const modules = import.meta.glob('./*-resource.tsx', { eager: true });
+ * const modules = import.meta.glob('./**\/*-resource.tsx', { eager: true });
  * export default createResourceExports(modules);
  */
 export declare function createResourceExports(modules: GlobModules): Record<string, React.ComponentType>;
-/**
- * Process simulation modules from import.meta.glob() result.
- * Builds a map of simulation key -> simulation data.
- *
- * @example
- * const modules = import.meta.glob('./*-simulation.json', { eager: true });
- * export const SIMULATIONS = createSimulationIndex(modules);
- */
-export declare function createSimulationIndex(modules: GlobModules): Record<string, unknown>;
 /**
  * Build a resource metadata map from import.meta.glob() result.
  * Used for connecting simulations to their resource definitions.
  *
  * @example
- * const modules = import.meta.glob('../src/resources/*-resource.json', { eager: true });
+ * const modules = import.meta.glob('../src/resources/**\/*-resource.json', { eager: true });
  * const resourcesMap = buildResourceMap(modules);
  */
 export declare function buildResourceMap<T>(modules: GlobModules): Map<string, T>;
@@ -101,10 +92,82 @@ export interface BuildDevSimulationsOptions {
  *
  * @example
  * const simulations = buildDevSimulations({
- *   simulationModules: import.meta.glob('../src/simulations/*-simulation.json', { eager: true }),
- *   resourceModules: import.meta.glob('../src/resources/*-resource.json', { eager: true }),
+ *   simulationModules: import.meta.glob('../src/resources/**\/*-simulation.json', { eager: true }),
+ *   resourceModules: import.meta.glob('../src/resources/**\/*-resource.json', { eager: true }),
  *   resourceComponents: resourceComponents,
  * });
  */
 export declare function buildDevSimulations(options: BuildDevSimulationsOptions): Record<string, Simulation>;
+/**
+ * Information about a discovered resource directory
+ */
+export interface ResourceDirInfo {
+    /** Resource key (directory name), e.g., 'albums', 'carousel' */
+    key: string;
+    /** Full path to the resource directory */
+    dir: string;
+    /** Full path to the main resource file (tsx or json depending on context) */
+    resourcePath: string;
+}
+/**
+ * File system operations interface for dependency injection in tests
+ */
+export interface FsOps {
+    readdirSync: (path: string, options: {
+        withFileTypes: true;
+    }) => Array<{
+        name: string;
+        isDirectory: () => boolean;
+    }>;
+    existsSync: (path: string) => boolean;
+}
+/**
+ * Find all resource directories in a base directory.
+ * Each valid resource directory contains a file matching the expected pattern.
+ *
+ * @param baseDir - Base directory to scan (e.g., 'src/resources' or 'dist')
+ * @param filePattern - Function to generate expected filename from resource key
+ * @param fs - File system operations (for testing)
+ *
+ * @example
+ * // Find source resources (tsx files)
+ * const resources = findResourceDirs('src/resources', key => `${key}-resource.tsx`);
+ *
+ * @example
+ * // Find built resources (js files)
+ * const resources = findResourceDirs('dist', key => `${key}.js`);
+ */
+export declare function findResourceDirs(baseDir: string, filePattern: (key: string) => string, fs: FsOps): ResourceDirInfo[];
+/**
+ * Check if a filename is a simulation file for a given resource.
+ * Matches pattern: {resourceKey}-*-simulation.json
+ *
+ * @example
+ * isSimulationFile('albums-show-simulation.json', 'albums') // true
+ * isSimulationFile('albums-show-simulation.json', 'carousel') // false
+ * isSimulationFile('albums-resource.json', 'albums') // false
+ */
+export declare function isSimulationFile(filename: string, resourceKey: string): boolean;
+/**
+ * Extract the simulation name from a simulation filename.
+ * Given "{resourceKey}-{name}-simulation.json", returns "{name}".
+ *
+ * @example
+ * extractSimulationName('albums-show-simulation.json', 'albums') // 'show'
+ * extractSimulationName('carousel-hero-simulation.json', 'carousel') // 'hero'
+ */
+export declare function extractSimulationName(filename: string, resourceKey: string): string;
+/**
+ * Find all simulation files in a resource directory.
+ *
+ * @param resourceDir - Path to the resource directory
+ * @param resourceKey - Resource key (e.g., 'albums')
+ * @param fs - File system operations (for testing)
+ * @returns Array of { filename, name } objects
+ */
+export declare function findSimulationFiles(resourceDir: string, resourceKey: string, fs: Pick<FsOps, 'readdirSync' | 'existsSync'>): Array<{
+    filename: string;
+    name: string;
+    path: string;
+}>;
 export {};

package/dist/mcp/entry.cjs

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 "use strict";
 const server = require("../server-CSybLAYo.cjs");
-const discovery = require("../discovery-a4WId9PC.cjs");
 const path = require("path");
 const fs = require("fs");
 const projectRoot = process.cwd();
@@ -9,36 +8,34 @@ async function startServer() {
   const pkgPath = path.join(projectRoot, "package.json");
   const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
   const resourcesDir = path.join(projectRoot, "src/resources");
-  const resourceFiles = fs.readdirSync(resourcesDir).filter((f) => f.endsWith("-resource.json"));
+  const resourceDirs = fs.readdirSync(resourcesDir, { withFileTypes: true }).filter(
+    (entry) => entry.isDirectory()
+  );
   const resourcesMap = /* @__PURE__ */ new Map();
-  for (const filename of resourceFiles) {
-    const key = filename.replace(/-resource\.json$/, "");
-    const resourcePath = path.join(resourcesDir, filename);
-    const resource = JSON.parse(fs.readFileSync(resourcePath, "utf-8"));
-    resourcesMap.set(key, resource);
-  }
-  const resourceKeys = Array.from(resourcesMap.keys());
-  const simulationsDir = path.join(projectRoot, "src/simulations");
-  const simulationFiles = fs.readdirSync(simulationsDir).filter((f) => f.endsWith("-simulation.json"));
   const simulations = [];
-  for (const filename of simulationFiles) {
-    const simulationKey = filename.replace(/-simulation\.json$/, "");
-    const simulationPath = path.join(simulationsDir, filename);
-    const simulation = JSON.parse(fs.readFileSync(simulationPath, "utf-8"));
-    const resourceKey = discovery.findResourceKey(simulationKey, resourceKeys);
-    if (!resourceKey) {
-      console.warn(
-        `No matching resource found for simulation "${simulationKey}". Expected a resource file like src/resources/${simulationKey.split("-")[0]}-resource.json`
-      );
+  for (const entry of resourceDirs) {
+    const resourceKey = entry.name;
+    const resourceDir = path.join(resourcesDir, resourceKey);
+    const resourcePath = path.join(resourceDir, `${resourceKey}-resource.json`);
+    if (!fs.existsSync(resourcePath)) {
       continue;
     }
-    const resource = resourcesMap.get(resourceKey);
-    simulations.push({
-      ...simulation,
-      name: simulationKey,
-      distPath: path.join(projectRoot, `dist/${resourceKey}.js`),
-      resource
-    });
+    const resource = JSON.parse(fs.readFileSync(resourcePath, "utf-8"));
+    resourcesMap.set(resourceKey, resource);
+    const dirFiles = fs.readdirSync(resourceDir);
+    for (const file of dirFiles) {
+      if (file.endsWith("-simulation.json")) {
+        const simulationKey = file.replace(/-simulation\.json$/, "");
+        const simulationPath = path.join(resourceDir, file);
+        const simulation = JSON.parse(fs.readFileSync(simulationPath, "utf-8"));
+        simulations.push({
+          ...simulation,
+          name: simulationKey,
+          distPath: path.join(projectRoot, `dist/${resourceKey}/${resourceKey}.js`),
+          resource
+        });
+      }
+    }
   }
   server.runMCPServer({
     name: pkg.name || "Sunpeak",

package/dist/mcp/entry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"entry.cjs","sources":["../../src/mcp/entry.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Internal MCP server entry point\n * This is run by nodemon or directly to start the MCP server\n *\n * Auto-discovers simulations and resources by file naming convention:\n * - simulations/{resource}-{tool}-simulation.json (e.g., albums-show-simulation.json)\n * - resources/{resource}-resource.json\n */\nimport { runMCPServer, type SimulationWithDist } from './index.js';\nimport { findResourceKey } from '../lib/discovery.js';\nimport path from 'path';\nimport { readFileSync, readdirSync } from 'fs';\nimport type { Resource } from '@modelcontextprotocol/sdk/types.js';\n\n// Determine project root (where this is being run from)\nconst projectRoot = process.cwd();\n\nasync function startServer() {\n  // Read package.json for app metadata\n  const pkgPath = path.join(projectRoot, 'package.json');\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n\n  // Auto-discover resource files first (to build lookup map)\n  const resourcesDir = path.join(projectRoot, 'src/resources');\n  const resourceFiles = readdirSync(resourcesDir).filter((f) => f.endsWith('-resource.json'));\n\n  const resourcesMap = new Map<string, Resource>();\n  for (const filename of resourceFiles) {\n    // Extract key from filename: 'review-resource.json' -> 'review'\n    const key = filename.replace(/-resource\\.json$/, '');\n    const resourcePath = path.join(resourcesDir, filename);\n    const resource = JSON.parse(readFileSync(resourcePath, 'utf-8')) as Resource;\n    resourcesMap.set(key, resource);\n  }\n\n  const resourceKeys = Array.from(resourcesMap.keys());\n\n  // Auto-discover simulation files\n  const simulationsDir = path.join(projectRoot, 'src/simulations');\n  const simulationFiles = readdirSync(simulationsDir).filter((f) => f.endsWith('-simulation.json'));\n\n  // Build simulations array from discovered files\n  const simulations: SimulationWithDist[] = [];\n\n  for (const filename of simulationFiles) {\n    // Extract simulation key from filename: 'albums-show-simulation.json' -> 'albums-show'\n    const simulationKey = filename.replace(/-simulation\\.json$/, '');\n\n    // Load simulation data\n    const simulationPath = path.join(simulationsDir, filename);\n    const simulation = JSON.parse(readFileSync(simulationPath, 'utf-8'));\n\n    // Find matching resource by best prefix match\n    const resourceKey = findResourceKey(simulationKey, resourceKeys);\n    if (!resourceKey) {\n      console.warn(\n        `No matching resource found for simulation \"${simulationKey}\". ` +\n          `Expected a resource file like src/resources/${simulationKey.split('-')[0]}-resource.json`\n      );\n      continue;\n    }\n\n    const resource = resourcesMap.get(resourceKey)!;\n\n    simulations.push({\n      ...simulation,\n      name: simulationKey,\n      distPath: path.join(projectRoot, `dist/${resourceKey}.js`),\n      resource,\n    });\n  }\n\n  runMCPServer({\n    name: pkg.name || 'Sunpeak',\n    version: pkg.version || '0.1.0',\n    simulations,\n    port: 6766,\n  });\n}\n\nstartServer().catch((error) => {\n  console.error('Failed to start MCP server:', error);\n  process.exit(1);\n});\n"],"names":["readFileSync","readdirSync","findResourceKey","runMCPServer"],"mappings":";;;;;;AAgBA,MAAM,cAAc,QAAQ,IAAA;AAE5B,eAAe,cAAc;AAE3B,QAAM,UAAU,KAAK,KAAK,aAAa,cAAc;AACrD,QAAM,MAAM,KAAK,MAAMA,GAAAA,aAAa,SAAS,OAAO,CAAC;AAGrD,QAAM,eAAe,KAAK,KAAK,aAAa,eAAe;AAC3D,QAAM,gBAAgBC,eAAY,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,gBAAgB,CAAC;AAE1F,QAAM,mCAAmB,IAAA;AACzB,aAAW,YAAY,eAAe;AAEpC,UAAM,MAAM,SAAS,QAAQ,oBAAoB,EAAE;AACnD,UAAM,eAAe,KAAK,KAAK,cAAc,QAAQ;AACrD,UAAM,WAAW,KAAK,MAAMD,GAAAA,aAAa,cAAc,OAAO,CAAC;AAC/D,iBAAa,IAAI,KAAK,QAAQ;AAAA,EAChC;AAEA,QAAM,eAAe,MAAM,KAAK,aAAa,MAAM;AAGnD,QAAM,iBAAiB,KAAK,KAAK,aAAa,iBAAiB;AAC/D,QAAM,kBAAkBC,eAAY,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,kBAAkB,CAAC;AAGhG,QAAM,cAAoC,CAAA;AAE1C,aAAW,YAAY,iBAAiB;AAEtC,UAAM,gBAAgB,SAAS,QAAQ,sBAAsB,EAAE;AAG/D,UAAM,iBAAiB,KAAK,KAAK,gBAAgB,QAAQ;AACzD,UAAM,aAAa,KAAK,MAAMD,GAAAA,aAAa,gBAAgB,OAAO,CAAC;AAGnE,UAAM,cAAcE,UAAAA,gBAAgB,eAAe,YAAY;AAC/D,QAAI,CAAC,aAAa;AAChB,cAAQ;AAAA,QACN,8CAA8C,aAAa,kDACV,cAAc,MAAM,GAAG,EAAE,CAAC,CAAC;AAAA,MAAA;AAE9E;AAAA,IACF;AAEA,UAAM,WAAW,aAAa,IAAI,WAAW;AAE7C,gBAAY,KAAK;AAAA,MACf,GAAG;AAAA,MACH,MAAM;AAAA,MACN,UAAU,KAAK,KAAK,aAAa,QAAQ,WAAW,KAAK;AAAA,MACzD;AAAA,IAAA,CACD;AAAA,EACH;AAEAC,sBAAa;AAAA,IACX,MAAM,IAAI,QAAQ;AAAA,IAClB,SAAS,IAAI,WAAW;AAAA,IACxB;AAAA,IACA,MAAM;AAAA,EAAA,CACP;AACH;AAEA,cAAc,MAAM,CAAC,UAAU;AAC7B,UAAQ,MAAM,+BAA+B,KAAK;AAClD,UAAQ,KAAK,CAAC;AAChB,CAAC;"}
+{"version":3,"file":"entry.cjs","sources":["../../src/mcp/entry.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Internal MCP server entry point\n * This is run by nodemon or directly to start the MCP server\n *\n * Auto-discovers simulations and resources by file naming convention:\n * - resources/{resource}/{resource}-{scenario}-simulation.json (e.g., resources/albums/albums-show-simulation.json)\n * - resources/{resource}/{resource}-resource.json\n */\nimport { runMCPServer, type SimulationWithDist } from './index.js';\nimport path from 'path';\nimport { existsSync, readFileSync, readdirSync } from 'fs';\nimport type { Resource } from '@modelcontextprotocol/sdk/types.js';\n\n// Determine project root (where this is being run from)\nconst projectRoot = process.cwd();\n\nasync function startServer() {\n  // Read package.json for app metadata\n  const pkgPath = path.join(projectRoot, 'package.json');\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n\n  // Auto-discover resources and simulations from subdirectories\n  const resourcesDir = path.join(projectRoot, 'src/resources');\n  const resourceDirs = readdirSync(resourcesDir, { withFileTypes: true }).filter((entry) =>\n    entry.isDirectory()\n  );\n\n  const resourcesMap = new Map<string, Resource>();\n  const simulations: SimulationWithDist[] = [];\n\n  for (const entry of resourceDirs) {\n    const resourceKey = entry.name;\n    const resourceDir = path.join(resourcesDir, resourceKey);\n    const resourcePath = path.join(resourceDir, `${resourceKey}-resource.json`);\n\n    // Skip directories without a resource file\n    if (!existsSync(resourcePath)) {\n      continue;\n    }\n\n    // Load resource\n    const resource = JSON.parse(readFileSync(resourcePath, 'utf-8')) as Resource;\n    resourcesMap.set(resourceKey, resource);\n\n    // Discover simulation files in the same directory\n    const dirFiles = readdirSync(resourceDir);\n    for (const file of dirFiles) {\n      if (file.endsWith('-simulation.json')) {\n        // Extract simulation key from filename: 'albums-show-simulation.json' -> 'albums-show'\n        const simulationKey = file.replace(/-simulation\\.json$/, '');\n        const simulationPath = path.join(resourceDir, file);\n        const simulation = JSON.parse(readFileSync(simulationPath, 'utf-8'));\n\n        simulations.push({\n          ...simulation,\n          name: simulationKey,\n          distPath: path.join(projectRoot, `dist/${resourceKey}/${resourceKey}.js`),\n          resource,\n        });\n      }\n    }\n  }\n\n  runMCPServer({\n    name: pkg.name || 'Sunpeak',\n    version: pkg.version || '0.1.0',\n    simulations,\n    port: 6766,\n  });\n}\n\nstartServer().catch((error) => {\n  console.error('Failed to start MCP server:', error);\n  process.exit(1);\n});\n"],"names":["readFileSync","readdirSync","existsSync","runMCPServer"],"mappings":";;;;;AAeA,MAAM,cAAc,QAAQ,IAAA;AAE5B,eAAe,cAAc;AAE3B,QAAM,UAAU,KAAK,KAAK,aAAa,cAAc;AACrD,QAAM,MAAM,KAAK,MAAMA,GAAAA,aAAa,SAAS,OAAO,CAAC;AAGrD,QAAM,eAAe,KAAK,KAAK,aAAa,eAAe;AAC3D,QAAM,eAAeC,GAAAA,YAAY,cAAc,EAAE,eAAe,KAAA,CAAM,EAAE;AAAA,IAAO,CAAC,UAC9E,MAAM,YAAA;AAAA,EAAY;AAGpB,QAAM,mCAAmB,IAAA;AACzB,QAAM,cAAoC,CAAA;AAE1C,aAAW,SAAS,cAAc;AAChC,UAAM,cAAc,MAAM;AAC1B,UAAM,cAAc,KAAK,KAAK,cAAc,WAAW;AACvD,UAAM,eAAe,KAAK,KAAK,aAAa,GAAG,WAAW,gBAAgB;AAG1E,QAAI,CAACC,GAAAA,WAAW,YAAY,GAAG;AAC7B;AAAA,IACF;AAGA,UAAM,WAAW,KAAK,MAAMF,GAAAA,aAAa,cAAc,OAAO,CAAC;AAC/D,iBAAa,IAAI,aAAa,QAAQ;AAGtC,UAAM,WAAWC,GAAAA,YAAY,WAAW;AACxC,eAAW,QAAQ,UAAU;AAC3B,UAAI,KAAK,SAAS,kBAAkB,GAAG;AAErC,cAAM,gBAAgB,KAAK,QAAQ,sBAAsB,EAAE;AAC3D,cAAM,iBAAiB,KAAK,KAAK,aAAa,IAAI;AAClD,cAAM,aAAa,KAAK,MAAMD,GAAAA,aAAa,gBAAgB,OAAO,CAAC;AAEnE,oBAAY,KAAK;AAAA,UACf,GAAG;AAAA,UACH,MAAM;AAAA,UACN,UAAU,KAAK,KAAK,aAAa,QAAQ,WAAW,IAAI,WAAW,KAAK;AAAA,UACxE;AAAA,QAAA,CACD;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEAG,sBAAa;AAAA,IACX,MAAM,IAAI,QAAQ;AAAA,IAClB,SAAS,IAAI,WAAW;AAAA,IACxB;AAAA,IACA,MAAM;AAAA,EAAA,CACP;AACH;AAEA,cAAc,MAAM,CAAC,UAAU;AAC7B,UAAQ,MAAM,+BAA+B,KAAK;AAClD,UAAQ,KAAK,CAAC;AAChB,CAAC;"}

package/dist/mcp/entry.js

@@ -1,43 +1,40 @@
 #!/usr/bin/env node
 import { r as runMCPServer } from "../server-310A1k9o.js";
-import { f as findResourceKey } from "../discovery-ft3cd2dW.js";
 import path from "path";
-import { readFileSync, readdirSync } from "fs";
+import { readFileSync, readdirSync, existsSync } from "fs";
 const projectRoot = process.cwd();
 async function startServer() {
   const pkgPath = path.join(projectRoot, "package.json");
   const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
   const resourcesDir = path.join(projectRoot, "src/resources");
-  const resourceFiles = readdirSync(resourcesDir).filter((f) => f.endsWith("-resource.json"));
+  const resourceDirs = readdirSync(resourcesDir, { withFileTypes: true }).filter(
+    (entry) => entry.isDirectory()
+  );
   const resourcesMap = /* @__PURE__ */ new Map();
-  for (const filename of resourceFiles) {
-    const key = filename.replace(/-resource\.json$/, "");
-    const resourcePath = path.join(resourcesDir, filename);
-    const resource = JSON.parse(readFileSync(resourcePath, "utf-8"));
-    resourcesMap.set(key, resource);
-  }
-  const resourceKeys = Array.from(resourcesMap.keys());
-  const simulationsDir = path.join(projectRoot, "src/simulations");
-  const simulationFiles = readdirSync(simulationsDir).filter((f) => f.endsWith("-simulation.json"));
   const simulations = [];
-  for (const filename of simulationFiles) {
-    const simulationKey = filename.replace(/-simulation\.json$/, "");
-    const simulationPath = path.join(simulationsDir, filename);
-    const simulation = JSON.parse(readFileSync(simulationPath, "utf-8"));
-    const resourceKey = findResourceKey(simulationKey, resourceKeys);
-    if (!resourceKey) {
-      console.warn(
-        `No matching resource found for simulation "${simulationKey}". Expected a resource file like src/resources/${simulationKey.split("-")[0]}-resource.json`
-      );
+  for (const entry of resourceDirs) {
+    const resourceKey = entry.name;
+    const resourceDir = path.join(resourcesDir, resourceKey);
+    const resourcePath = path.join(resourceDir, `${resourceKey}-resource.json`);
+    if (!existsSync(resourcePath)) {
       continue;
     }
-    const resource = resourcesMap.get(resourceKey);
-    simulations.push({
-      ...simulation,
-      name: simulationKey,
-      distPath: path.join(projectRoot, `dist/${resourceKey}.js`),
-      resource
-    });
+    const resource = JSON.parse(readFileSync(resourcePath, "utf-8"));
+    resourcesMap.set(resourceKey, resource);
+    const dirFiles = readdirSync(resourceDir);
+    for (const file of dirFiles) {
+      if (file.endsWith("-simulation.json")) {
+        const simulationKey = file.replace(/-simulation\.json$/, "");
+        const simulationPath = path.join(resourceDir, file);
+        const simulation = JSON.parse(readFileSync(simulationPath, "utf-8"));
+        simulations.push({
+          ...simulation,
+          name: simulationKey,
+          distPath: path.join(projectRoot, `dist/${resourceKey}/${resourceKey}.js`),
+          resource
+        });
+      }
+    }
   }
   runMCPServer({
     name: pkg.name || "Sunpeak",

package/dist/mcp/entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.js","sources":["../../src/mcp/entry.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Internal MCP server entry point\n * This is run by nodemon or directly to start the MCP server\n *\n * Auto-discovers simulations and resources by file naming convention:\n * - simulations/{resource}-{tool}-simulation.json (e.g., albums-show-simulation.json)\n * - resources/{resource}-resource.json\n */\nimport { runMCPServer, type SimulationWithDist } from './index.js';\nimport { findResourceKey } from '../lib/discovery.js';\nimport path from 'path';\nimport { readFileSync, readdirSync } from 'fs';\nimport type { Resource } from '@modelcontextprotocol/sdk/types.js';\n\n// Determine project root (where this is being run from)\nconst projectRoot = process.cwd();\n\nasync function startServer() {\n  // Read package.json for app metadata\n  const pkgPath = path.join(projectRoot, 'package.json');\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n\n  // Auto-discover resource files first (to build lookup map)\n  const resourcesDir = path.join(projectRoot, 'src/resources');\n  const resourceFiles = readdirSync(resourcesDir).filter((f) => f.endsWith('-resource.json'));\n\n  const resourcesMap = new Map<string, Resource>();\n  for (const filename of resourceFiles) {\n    // Extract key from filename: 'review-resource.json' -> 'review'\n    const key = filename.replace(/-resource\\.json$/, '');\n    const resourcePath = path.join(resourcesDir, filename);\n    const resource = JSON.parse(readFileSync(resourcePath, 'utf-8')) as Resource;\n    resourcesMap.set(key, resource);\n  }\n\n  const resourceKeys = Array.from(resourcesMap.keys());\n\n  // Auto-discover simulation files\n  const simulationsDir = path.join(projectRoot, 'src/simulations');\n  const simulationFiles = readdirSync(simulationsDir).filter((f) => f.endsWith('-simulation.json'));\n\n  // Build simulations array from discovered files\n  const simulations: SimulationWithDist[] = [];\n\n  for (const filename of simulationFiles) {\n    // Extract simulation key from filename: 'albums-show-simulation.json' -> 'albums-show'\n    const simulationKey = filename.replace(/-simulation\\.json$/, '');\n\n    // Load simulation data\n    const simulationPath = path.join(simulationsDir, filename);\n    const simulation = JSON.parse(readFileSync(simulationPath, 'utf-8'));\n\n    // Find matching resource by best prefix match\n    const resourceKey = findResourceKey(simulationKey, resourceKeys);\n    if (!resourceKey) {\n      console.warn(\n        `No matching resource found for simulation \"${simulationKey}\". ` +\n          `Expected a resource file like src/resources/${simulationKey.split('-')[0]}-resource.json`\n      );\n      continue;\n    }\n\n    const resource = resourcesMap.get(resourceKey)!;\n\n    simulations.push({\n      ...simulation,\n      name: simulationKey,\n      distPath: path.join(projectRoot, `dist/${resourceKey}.js`),\n      resource,\n    });\n  }\n\n  runMCPServer({\n    name: pkg.name || 'Sunpeak',\n    version: pkg.version || '0.1.0',\n    simulations,\n    port: 6766,\n  });\n}\n\nstartServer().catch((error) => {\n  console.error('Failed to start MCP server:', error);\n  process.exit(1);\n});\n"],"names":[],"mappings":";;;;;AAgBA,MAAM,cAAc,QAAQ,IAAA;AAE5B,eAAe,cAAc;AAE3B,QAAM,UAAU,KAAK,KAAK,aAAa,cAAc;AACrD,QAAM,MAAM,KAAK,MAAM,aAAa,SAAS,OAAO,CAAC;AAGrD,QAAM,eAAe,KAAK,KAAK,aAAa,eAAe;AAC3D,QAAM,gBAAgB,YAAY,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,gBAAgB,CAAC;AAE1F,QAAM,mCAAmB,IAAA;AACzB,aAAW,YAAY,eAAe;AAEpC,UAAM,MAAM,SAAS,QAAQ,oBAAoB,EAAE;AACnD,UAAM,eAAe,KAAK,KAAK,cAAc,QAAQ;AACrD,UAAM,WAAW,KAAK,MAAM,aAAa,cAAc,OAAO,CAAC;AAC/D,iBAAa,IAAI,KAAK,QAAQ;AAAA,EAChC;AAEA,QAAM,eAAe,MAAM,KAAK,aAAa,MAAM;AAGnD,QAAM,iBAAiB,KAAK,KAAK,aAAa,iBAAiB;AAC/D,QAAM,kBAAkB,YAAY,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,kBAAkB,CAAC;AAGhG,QAAM,cAAoC,CAAA;AAE1C,aAAW,YAAY,iBAAiB;AAEtC,UAAM,gBAAgB,SAAS,QAAQ,sBAAsB,EAAE;AAG/D,UAAM,iBAAiB,KAAK,KAAK,gBAAgB,QAAQ;AACzD,UAAM,aAAa,KAAK,MAAM,aAAa,gBAAgB,OAAO,CAAC;AAGnE,UAAM,cAAc,gBAAgB,eAAe,YAAY;AAC/D,QAAI,CAAC,aAAa;AAChB,cAAQ;AAAA,QACN,8CAA8C,aAAa,kDACV,cAAc,MAAM,GAAG,EAAE,CAAC,CAAC;AAAA,MAAA;AAE9E;AAAA,IACF;AAEA,UAAM,WAAW,aAAa,IAAI,WAAW;AAE7C,gBAAY,KAAK;AAAA,MACf,GAAG;AAAA,MACH,MAAM;AAAA,MACN,UAAU,KAAK,KAAK,aAAa,QAAQ,WAAW,KAAK;AAAA,MACzD;AAAA,IAAA,CACD;AAAA,EACH;AAEA,eAAa;AAAA,IACX,MAAM,IAAI,QAAQ;AAAA,IAClB,SAAS,IAAI,WAAW;AAAA,IACxB;AAAA,IACA,MAAM;AAAA,EAAA,CACP;AACH;AAEA,cAAc,MAAM,CAAC,UAAU;AAC7B,UAAQ,MAAM,+BAA+B,KAAK;AAClD,UAAQ,KAAK,CAAC;AAChB,CAAC;"}
+{"version":3,"file":"entry.js","sources":["../../src/mcp/entry.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Internal MCP server entry point\n * This is run by nodemon or directly to start the MCP server\n *\n * Auto-discovers simulations and resources by file naming convention:\n * - resources/{resource}/{resource}-{scenario}-simulation.json (e.g., resources/albums/albums-show-simulation.json)\n * - resources/{resource}/{resource}-resource.json\n */\nimport { runMCPServer, type SimulationWithDist } from './index.js';\nimport path from 'path';\nimport { existsSync, readFileSync, readdirSync } from 'fs';\nimport type { Resource } from '@modelcontextprotocol/sdk/types.js';\n\n// Determine project root (where this is being run from)\nconst projectRoot = process.cwd();\n\nasync function startServer() {\n  // Read package.json for app metadata\n  const pkgPath = path.join(projectRoot, 'package.json');\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n\n  // Auto-discover resources and simulations from subdirectories\n  const resourcesDir = path.join(projectRoot, 'src/resources');\n  const resourceDirs = readdirSync(resourcesDir, { withFileTypes: true }).filter((entry) =>\n    entry.isDirectory()\n  );\n\n  const resourcesMap = new Map<string, Resource>();\n  const simulations: SimulationWithDist[] = [];\n\n  for (const entry of resourceDirs) {\n    const resourceKey = entry.name;\n    const resourceDir = path.join(resourcesDir, resourceKey);\n    const resourcePath = path.join(resourceDir, `${resourceKey}-resource.json`);\n\n    // Skip directories without a resource file\n    if (!existsSync(resourcePath)) {\n      continue;\n    }\n\n    // Load resource\n    const resource = JSON.parse(readFileSync(resourcePath, 'utf-8')) as Resource;\n    resourcesMap.set(resourceKey, resource);\n\n    // Discover simulation files in the same directory\n    const dirFiles = readdirSync(resourceDir);\n    for (const file of dirFiles) {\n      if (file.endsWith('-simulation.json')) {\n        // Extract simulation key from filename: 'albums-show-simulation.json' -> 'albums-show'\n        const simulationKey = file.replace(/-simulation\\.json$/, '');\n        const simulationPath = path.join(resourceDir, file);\n        const simulation = JSON.parse(readFileSync(simulationPath, 'utf-8'));\n\n        simulations.push({\n          ...simulation,\n          name: simulationKey,\n          distPath: path.join(projectRoot, `dist/${resourceKey}/${resourceKey}.js`),\n          resource,\n        });\n      }\n    }\n  }\n\n  runMCPServer({\n    name: pkg.name || 'Sunpeak',\n    version: pkg.version || '0.1.0',\n    simulations,\n    port: 6766,\n  });\n}\n\nstartServer().catch((error) => {\n  console.error('Failed to start MCP server:', error);\n  process.exit(1);\n});\n"],"names":[],"mappings":";;;;AAeA,MAAM,cAAc,QAAQ,IAAA;AAE5B,eAAe,cAAc;AAE3B,QAAM,UAAU,KAAK,KAAK,aAAa,cAAc;AACrD,QAAM,MAAM,KAAK,MAAM,aAAa,SAAS,OAAO,CAAC;AAGrD,QAAM,eAAe,KAAK,KAAK,aAAa,eAAe;AAC3D,QAAM,eAAe,YAAY,cAAc,EAAE,eAAe,KAAA,CAAM,EAAE;AAAA,IAAO,CAAC,UAC9E,MAAM,YAAA;AAAA,EAAY;AAGpB,QAAM,mCAAmB,IAAA;AACzB,QAAM,cAAoC,CAAA;AAE1C,aAAW,SAAS,cAAc;AAChC,UAAM,cAAc,MAAM;AAC1B,UAAM,cAAc,KAAK,KAAK,cAAc,WAAW;AACvD,UAAM,eAAe,KAAK,KAAK,aAAa,GAAG,WAAW,gBAAgB;AAG1E,QAAI,CAAC,WAAW,YAAY,GAAG;AAC7B;AAAA,IACF;AAGA,UAAM,WAAW,KAAK,MAAM,aAAa,cAAc,OAAO,CAAC;AAC/D,iBAAa,IAAI,aAAa,QAAQ;AAGtC,UAAM,WAAW,YAAY,WAAW;AACxC,eAAW,QAAQ,UAAU;AAC3B,UAAI,KAAK,SAAS,kBAAkB,GAAG;AAErC,cAAM,gBAAgB,KAAK,QAAQ,sBAAsB,EAAE;AAC3D,cAAM,iBAAiB,KAAK,KAAK,aAAa,IAAI;AAClD,cAAM,aAAa,KAAK,MAAM,aAAa,gBAAgB,OAAO,CAAC;AAEnE,oBAAY,KAAK;AAAA,UACf,GAAG;AAAA,UACH,MAAM;AAAA,UACN,UAAU,KAAK,KAAK,aAAa,QAAQ,WAAW,IAAI,WAAW,KAAK;AAAA,UACxE;AAAA,QAAA,CACD;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,eAAa;AAAA,IACX,MAAM,IAAI,QAAQ;AAAA,IAClB,SAAS,IAAI,WAAW;AAAA,IACxB;AAAA,IACA,MAAM;AAAA,EAAA,CACP;AACH;AAEA,cAAc,MAAM,CAAC,UAAU;AAC7B,UAAQ,MAAM,+BAA+B,KAAK;AAClD,UAAQ,KAAK,CAAC;AAChB,CAAC;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sunpeak",
-  "version": "0.9.12",
+  "version": "0.10.3",
   "description": "The ChatGPT App framework. Quickstart, build, & test your ChatGPT App locally!",
   "type": "module",
   "main": "./dist/index.cjs",

package/template/.sunpeak/dev.tsx

@@ -4,9 +4,9 @@
  * This file bootstraps the ChatGPT simulator for development
  *
  * Auto-discovers simulations and resources by file naming convention:
- * - simulations/{resource}-{tool}-simulation.json (e.g., albums-show-simulation.json)
- * - resources/{resource}-resource.json
- * - resources/{Resource}Resource component (PascalCase)
+ * - resources/{resource}/{resource}-{scenario}-simulation.json (e.g., resources/albums/albums-show-simulation.json)
+ * - resources/{resource}/{resource}-resource.json
+ * - resources/{resource}/{Resource}Resource component (PascalCase)
  */
 import { StrictMode } from 'react';
 import { createRoot } from 'react-dom/client';
@@ -16,8 +16,8 @@ import '../src/styles/globals.css';
 
 // Build simulations from discovered files
 const simulations = buildDevSimulations({
-  simulationModules: import.meta.glob('../src/simulations/*-simulation.json', { eager: true }),
-  resourceModules: import.meta.glob('../src/resources/*-resource.json', { eager: true }),
+  simulationModules: import.meta.glob('../src/resources/*/*-simulation.json', { eager: true }),
+  resourceModules: import.meta.glob('../src/resources/*/*-resource.json', { eager: true }),
   resourceComponents: resourceComponents as Record<string, React.ComponentType>,
 });
 

package/template/README.md

@@ -16,48 +16,34 @@ That's it! Edit the resource files in [./src/resources/](./src/resources/) to bu
 ## Commands
 
 ```bash
-sunpeak dev            # Start development server
-sunpeak build          # Build all resources for production
-sunpeak mcp            # Start MCP server with auto-reload
-pnpm test              # Run tests with Vitest
+# Core commands:
+pnpm test              # Run tests with Vitest.
+pnpm test:e2e          # Run end-to-end tests with Playwright.
+sunpeak dev            # Start development server.
+sunpeak build          # Build all resources for production.
+sunpeak mcp            # Start MCP server for ChatGPT testing with mock data.
+
+# sunpeak repository (think ECR for ChatGPT Apps):
+sunpeak login          # Authenticate with the sunpeak repository.
+sunpeak push           # Push built resources to the sunpeak repository.
+sunpeak pull           # Pull built resources from the sunpeak repository (for your prod MCP server).
 ```
 
 The template includes a minimal test setup with Vitest. You can add additional tooling (linting, formatting, type-checking) as needed for your project.
 
-### Customization
+## Project Structure
 
-**Do not customize (required by `sunpeak` commands):**
+- `src/resources/` - Directory containing all your MCP Resources (ChatGPT App UIs).
+  - Each resource is a subdirectory containing all files for that resource.
+  - Example: `src/resources/albums/` contains:
+    - `albums-resource.tsx` - The React component.
+    - `albums-resource.json` - Resource metadata (name, title, description, etc.).
+    - `albums-resource.test.tsx` - Unit tests for the resource.
+    - `albums-show-simulation.json` - Simulation data for testing.
+    - `components/` - UI components used by the resource.
+- `tests/e2e/` - Directory containing end-to-end Playwright tests for each resource. Uses the ChatGPTSimulator to test your resources render properly with any state (tool calls, saved state, dark mode, pip display mode, etc.).
 
-- `src/resources/` - Resource files must be here
-- `src/simulations/` - Simulation files must be here
-- Resource file naming: `*-resource.tsx` (e.g., `review-resource.tsx`)
-- Simulation file naming: `*-simulation.json` (e.g., `review-purchase-simulation.json`)
-- `src/index-resource.tsx` - Build template (must have `// RESOURCE_IMPORT` and `// RESOURCE_MOUNT` comments)
-
-**You can customize:**
-
-- Package.json scripts - Add your own tooling (lint, format, typecheck, etc.)
-- Component structure within `src/components/`
-- Package manager (pnpm, npm, or yarn auto-detected)
-- Pretty much everything else!
-
-## Testing
-
-### Testing Locally
-
-Run the test suite:
-
-```bash
-pnpm test
-```
-
-For manual QA of the UI:
-
-```bash
-sunpeak dev
-```
-
-### Testing in ChatGPT
+## Testing in ChatGPT
 
 Test your app directly in ChatGPT using the built-in MCP server:
 
@@ -83,28 +69,46 @@ Build your app for production:
 sunpeak build
 ```
 
-This creates optimized builds in `dist/`:
+This creates optimized builds in `dist/`, organized by resource:
 
-- `dist/albums.js`
-- `dist/albums.json`
-- `dist/review.js`
-- `dist/review.json`
-- _(One .js file per resource in src/resources/)_
-- _(One .json file per resource in src/resources/)_
+```bash
+dist/
+├── albums/
+│   ├── albums.js                     # Built resource component.
+│   ├── albums.json                   # Resource metadata.
+│   └── albums-show-simulation.json   # Resource mock data for testing.
+├── review/
+│   ├── review.js
+│   ├── review.json
+│   ├── review-diff-simulation.json
+│   ├── review-post-simulation.json
+│   └── review-purchase-simulation.json
+└── ...
+```
+
+Each resource folder contains:
 
-Each `.js` file is a self-contained bundle with CSS inlined. Host these files and reference them as resources in your production MCP server.
+- **`.js` file**: Self-contained bundle with CSS inlined
+- **`.json` file**: Resource metadata with unique `uri` for cache-busting
+- **`*-simulation.json` files**: All affiliated simulation files for the resource. These are not needed for the production runtime, but are used in the sunpeak repository for testing.
 
-Each `.json` file is a copy of each of your resource MCP metadata files `src/resource/*-resource.json`. The copy is identical, but with a unique `uri` field added that will cache-bust earlier resource versions pre-loaded in ChatGPT.
+Host these files and reference them as resources in your production MCP server.
+Use the sunpeak resource repository for built-in resource hosting.
 
 ## Add a new UI (Resource)
 
-To add a new UI (MCP Resource), simply create the following files:
+To add a new UI (MCP Resource), create a new directory under `src/resources/` with the following files:
 
-- `src/resources/NAME-resource.tsx`
-- `src/resources/NAME-resource.json`
-- `src/simulations/NAME-TOOLNAME-simulation.json`
+```
+src/resources/NAME/
+├── NAME-resource.tsx              # React component (required)
+├── NAME-resource.json             # Resource metadata (required)
+├── NAME-resource.test.tsx         # Unit tests (optional)
+├── NAME-SCENARIO-simulation.json  # Simulation data (optional)
+└── components/                    # UI components (optional)
+```
 
-Only the resource files are required to generate a production build and ship a UI. Create the simulation file if you want to preview your resource in `sunpeak dev` or `sunpeak mcp`.
+Only the resource files (`.tsx` and `.json`) are required to generate a production build and ship a UI. Create the simulation file if you want to preview your resource in `sunpeak dev` or `sunpeak mcp`.
 
 ## Resources
 

package/template/dist/{albums.json → albums/albums.json}

@@ -12,5 +12,5 @@
       ]
     }
   },
-  "uri": "ui://albums-mkbms4dx"
+  "uri": "ui://albums-mkd2wyc7"
 }

package/template/dist/{carousel.json → carousel/carousel.json}

@@ -12,5 +12,5 @@
       ]
     }
   },
-  "uri": "ui://carousel-mkbms4dx"
+  "uri": "ui://carousel-mkd2wyc7"
 }

package/template/dist/{map.json → map/map.json}

@@ -18,5 +18,5 @@
       ]
     }
   },
-  "uri": "ui://map-mkbms4dx"
+  "uri": "ui://map-mkd2wyc7"
 }

package/template/dist/{review.json → review/review.json}

@@ -12,5 +12,5 @@
       ]
     }
   },
-  "uri": "ui://review-mkbms4dx"
+  "uri": "ui://review-mkd2wyc7"
 }

package/template/node_modules/.vite/deps/@openai_apps-sdk-ui_components_Button.js

@@ -2,13 +2,13 @@ import {
   Button,
   ButtonLink,
   CopyButton
-} from "./chunk-N6DVYEXK.js";
-import "./chunk-JAGHY6H6.js";
+} from "./chunk-LVZJNEGE.js";
+import "./chunk-UM3ZGDFR.js";
 import "./chunk-QPJAV452.js";
+import "./chunk-JAGHY6H6.js";
 import "./chunk-DYQDWJMS.js";
 import "./chunk-EGRHWZRV.js";
 import "./chunk-CNYJBM5F.js";
-import "./chunk-UM3ZGDFR.js";
 import "./chunk-JGVISENQ.js";
 import "./chunk-BUOVMFCD.js";
 import "./chunk-ILHRZGIS.js";

package/template/node_modules/.vite/deps/@openai_apps-sdk-ui_components_Select.js

@@ -5,13 +5,21 @@ import {
   Button,
   LoadingIndicator,
   TransitionGroup
-} from "./chunk-N6DVYEXK.js";
+} from "./chunk-LVZJNEGE.js";
 import {
-  useTimeout
-} from "./chunk-JAGHY6H6.js";
+  Check_default,
+  ChevronDownVector_default,
+  DropdownVector_default,
+  Info_default,
+  Search_default,
+  X_default
+} from "./chunk-UM3ZGDFR.js";
 import {
   o
 } from "./chunk-QPJAV452.js";
+import {
+  useTimeout
+} from "./chunk-JAGHY6H6.js";
 import {
   handlePressableMouseEnter,
   preventDefaultHandler,
@@ -28,14 +36,6 @@ import "./chunk-XZTIOEPG.js";
 import {
   clsx_default
 } from "./chunk-CNYJBM5F.js";
-import {
-  Check_default,
-  ChevronDownVector_default,
-  DropdownVector_default,
-  Info_default,
-  Search_default,
-  X_default
-} from "./chunk-UM3ZGDFR.js";
 import {
   require_jsx_runtime
 } from "./chunk-JGVISENQ.js";