@genart-dev/mcp-server 0.4.1 → 0.4.3

package/dist/lib.cjs

@@ -2445,30 +2445,17 @@ function isDirectComponent(name, components) {
 
 // src/tools/capture.ts
 var import_promises6 = require("fs/promises");
+var import_path8 = require("path");
 var import_core8 = require("@genart-dev/core");
 
 // src/capture/headless.ts
-var cachedModule = null;
-async function loadPuppeteer() {
-  if (!cachedModule) {
-    try {
-      const mod = await import("puppeteer");
-      cachedModule = mod.default ?? mod;
-    } catch {
-      throw new Error(
-        "Puppeteer is required for screenshot capture. Install it with: npm install puppeteer"
-      );
-    }
-  }
-  return cachedModule;
-}
+var import_puppeteer = __toESM(require("puppeteer"), 1);
 var browserInstance = null;
 async function getBrowser() {
   if (browserInstance && browserInstance.connected) {
     return browserInstance;
   }
-  const puppeteer = await loadPuppeteer();
-  browserInstance = await puppeteer.launch({
+  browserInstance = await import_puppeteer.default.launch({
     headless: true,
     executablePath: process.env.PUPPETEER_EXECUTABLE_PATH || void 0,
     args: [
@@ -2561,8 +2548,9 @@ function generateSketchHtml(sketch, opts) {
   }
   return adapter.generateStandaloneHTML(effective);
 }
-function derivePreviewPath(sketchPath) {
-  return sketchPath.replace(/\.genart$/, ".png");
+function deriveSnapshotPath(sketchPath, sketchId, seed) {
+  const wsDir = (0, import_path8.dirname)(sketchPath);
+  return (0, import_path8.join)(wsDir, "snapshots", `${sketchId}-${seed}-preview.png`);
 }
 async function captureScreenshot(state, input) {
   state.requireWorkspace();
@@ -2595,11 +2583,12 @@ async function captureScreenshot(state, input) {
       height,
       inlineSize
     });
-    const previewPath = derivePreviewPath(loaded.path);
+    const effectiveSeed = input.seed ?? sketch.state.seed;
+    const previewPath = deriveSnapshotPath(loaded.path, sketchId, effectiveSeed);
     const metadata = await buildScreenshotMetadata(state, multi, {
       target,
       sketchId,
-      seed: input.seed ?? sketch.state.seed,
+      seed: effectiveSeed,
       previewPath
     });
     const previewJpegBase64 = Buffer.from(multi.inlineJpeg).toString("base64");
@@ -2620,8 +2609,10 @@ async function buildScreenshotMetadata(state, multi, info) {
     previewPath: info.previewPath
   };
   if (!state.remoteMode) {
+    await (0, import_promises6.mkdir)((0, import_path8.dirname)(info.previewPath), { recursive: true });
     await (0, import_promises6.writeFile)(info.previewPath, multi.previewPng);
     metadata.savedPreviewTo = info.previewPath;
+    metadata.previewWritten = true;
   }
   return metadata;
 }
@@ -2650,11 +2641,12 @@ async function captureBatch(state, input) {
         height,
         inlineSize
       });
-      const previewPath = derivePreviewPath(loaded.path);
+      const effectiveSeed = input.seed ?? sketch.state.seed;
+      const previewPath = deriveSnapshotPath(loaded.path, id, effectiveSeed);
       const itemMetadata = await buildScreenshotMetadata(state, multi, {
         target: "sketch",
         sketchId: id,
-        seed: input.seed ?? sketch.state.seed,
+        seed: effectiveSeed,
         previewPath
       });
       items.push({
@@ -3014,7 +3006,7 @@ function gatherRelevantSkills(aspects) {
 
 // src/tools/series.ts
 var import_promises7 = require("fs/promises");
-var import_path8 = require("path");
+var import_path9 = require("path");
 var import_core10 = require("@genart-dev/core");
 function now6() {
   return (/* @__PURE__ */ new Date()).toISOString();
@@ -3177,7 +3169,7 @@ async function seriesSummary(state, input) {
   for (const file of series.sketchFiles) {
     let found = false;
     for (const [id, loaded] of state.sketches) {
-      if ((0, import_path8.basename)(loaded.path) === file) {
+      if ((0, import_path9.basename)(loaded.path) === file) {
         const def = loaded.definition;
         sketchInfos.push({
           id,
@@ -3291,18 +3283,18 @@ async function promoteSketch(state, input) {
     ...input.agent ? { agent: input.agent } : {},
     ...input.model ? { model: input.model } : {}
   };
-  const sourceDir = (0, import_path8.dirname)(source.path);
-  const newPath = (0, import_path8.resolve)(sourceDir, `${newId}.genart`);
+  const sourceDir = (0, import_path9.dirname)(source.path);
+  const newPath = (0, import_path9.resolve)(sourceDir, `${newId}.genart`);
   const json = (0, import_core10.serializeGenart)(promotedDef);
   if (!state.remoteMode) {
     await (0, import_promises7.writeFile)(newPath, json, "utf-8");
   }
   state.sketches.set(newId, { definition: promotedDef, path: newPath });
   const sourceRef = ws.sketches.find(
-    (s) => s.file === (0, import_path8.basename)(source.path)
+    (s) => s.file === (0, import_path9.basename)(source.path)
   );
   const position = sourceRef ? { x: sourceRef.position.x, y: sourceRef.position.y + sourceDef.canvas.height + 200 } : { x: 0, y: 0 };
-  const file = (0, import_path8.basename)(newPath);
+  const file = (0, import_path9.basename)(newPath);
   state.workspace = {
     ...ws,
     modified: ts,
@@ -3362,7 +3354,7 @@ function countBy(items) {
 
 // src/tools/reference.ts
 var import_promises8 = require("fs/promises");
-var import_path9 = require("path");
+var import_path10 = require("path");
 var import_core11 = require("@genart-dev/core");
 var import_promises9 = require("fs/promises");
 function now7() {
@@ -3387,7 +3379,7 @@ var IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
   ".svg"
 ]);
 function isImageFile(path) {
-  return IMAGE_EXTENSIONS.has((0, import_path9.extname)(path).toLowerCase());
+  return IMAGE_EXTENSIONS.has((0, import_path10.extname)(path).toLowerCase());
 }
 var VALID_REFERENCE_TYPES = [
   "image",
@@ -3403,7 +3395,7 @@ async function addReference(state, input) {
       `Not a recognized image file: ${input.image}. Supported: ${[...IMAGE_EXTENSIONS].join(", ")}`
     );
   }
-  const id = input.id ?? (0, import_path9.basename)(input.image, (0, import_path9.extname)(input.image)).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+  const id = input.id ?? (0, import_path10.basename)(input.image, (0, import_path10.extname)(input.image)).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
   if (!id) {
     throw new Error("Could not derive a valid ID from the image filename");
   }
@@ -3414,15 +3406,15 @@ async function addReference(state, input) {
       `Invalid reference type: '${refType}'. Valid types: ${VALID_REFERENCE_TYPES.join(", ")}`
     );
   }
-  const workspaceDir = (0, import_path9.dirname)(state.workspacePath);
-  const refsDir = (0, import_path9.resolve)(workspaceDir, "references");
+  const workspaceDir = (0, import_path10.dirname)(state.workspacePath);
+  const refsDir = (0, import_path10.resolve)(workspaceDir, "references");
   await (0, import_promises8.mkdir)(refsDir, { recursive: true });
-  const ext = (0, import_path9.extname)(input.image);
+  const ext = (0, import_path10.extname)(input.image);
   const destFilename = `${id}${ext}`;
-  const destPath = (0, import_path9.resolve)(refsDir, destFilename);
+  const destPath = (0, import_path10.resolve)(refsDir, destFilename);
   const relativePath = `references/${destFilename}`;
   if (!state.remoteMode) {
-    await (0, import_promises8.copyFile)((0, import_path9.resolve)(input.image), destPath);
+    await (0, import_promises8.copyFile)((0, import_path10.resolve)(input.image), destPath);
   }
   const ref = {
     id,
@@ -3504,12 +3496,12 @@ async function addReference(state, input) {
 async function analyzeReference(state, input) {
   state.requireWorkspace();
   const { ref, location } = findReference(state, input.referenceId, input.seriesId, input.sketchId);
-  const workspaceDir = (0, import_path9.dirname)(state.workspacePath);
-  const imagePath = (0, import_path9.resolve)(workspaceDir, ref.path);
+  const workspaceDir = (0, import_path10.dirname)(state.workspacePath);
+  const imagePath = (0, import_path10.resolve)(workspaceDir, ref.path);
   let previewJpegBase64;
   try {
     const imageBuffer = await (0, import_promises8.readFile)(imagePath);
-    const ext = (0, import_path9.extname)(ref.path).toLowerCase();
+    const ext = (0, import_path10.extname)(ref.path).toLowerCase();
     const mimeMap = {
       ".png": "image/png",
       ".jpg": "image/jpeg",
@@ -3664,8 +3656,8 @@ async function extractPalette(state, input) {
     input.sketchId
   );
   const count = input.count ?? 6;
-  const workspaceDir = (0, import_path9.dirname)(state.workspacePath);
-  const imagePath = (0, import_path9.resolve)(workspaceDir, ref.path);
+  const workspaceDir = (0, import_path10.dirname)(state.workspacePath);
+  const imagePath = (0, import_path10.resolve)(workspaceDir, ref.path);
   let previewJpegBase64;
   try {
     const imageBuffer = await (0, import_promises8.readFile)(imagePath);
@@ -3741,12 +3733,12 @@ function findReference(state, referenceId, seriesId, sketchId) {
 // src/tools/export.ts
 var import_fs = require("fs");
 var import_promises10 = require("fs/promises");
-var import_path10 = require("path");
+var import_path11 = require("path");
 var import_archiver = __toESM(require("archiver"), 1);
 var import_core12 = require("@genart-dev/core");
 var registry4 = (0, import_core12.createDefaultRegistry)();
 async function validateOutputPath(outputPath) {
-  const parentDir = (0, import_path10.dirname)(outputPath);
+  const parentDir = (0, import_path11.dirname)(outputPath);
   try {
     const s = await (0, import_promises10.stat)(parentDir);
     if (!s.isDirectory()) {
@@ -5012,20 +5004,24 @@ async function initializePluginRegistry() {
   await registry5.register(import_plugin_trace.default);
   return registry5;
 }
-function createServer(state) {
+function createServer(state, options) {
+  const captureOnly = options?.captureOnly ?? false;
   const server = new import_mcp.McpServer(
     {
-      name: "@genart/mcp-server",
+      name: captureOnly ? "@genart/mcp-capture" : "@genart/mcp-server",
       version: "0.4.0"
     },
     {
       capabilities: {
         tools: {},
-        resources: {},
-        prompts: {}
+        ...!captureOnly && { resources: {}, prompts: {} }
       }
     }
   );
+  if (captureOnly) {
+    registerCaptureTools(server, state);
+    return server;
+  }
   const registryReady = initializePluginRegistry().then((registry5) => {
     state.pluginRegistry = registry5;
     registerPluginMcpTools(server, registry5, state);
@@ -5042,7 +5038,9 @@ function createServer(state) {
   registerSnapshotTools(server, state);
   registerKnowledgeTools(server, state);
   registerDesignTools(server, state);
-  registerCaptureTools(server, state);
+  if (!state.remoteMode) {
+    registerCaptureTools(server, state);
+  }
   registerCritiqueTools(server, state);
   registerSeriesTools(server, state);
   registerReferenceTools(server, state);
@@ -5752,7 +5750,7 @@ function registerSnapshotTools(server, state) {
 function registerCaptureTools(server, state) {
   server.tool(
     "capture_screenshot",
-    "Capture a screenshot of a sketch. Returns metadata as text + a small inline JPEG image for visual review. In remote mode, metadata includes previewFileContent (base64 PNG) to Write locally.",
+    "Capture a screenshot of a sketch. Returns metadata as text + a small inline JPEG image for visual review. In local mode, writes a full-res PNG to snapshots/<sketchId>-<seed>-preview.png next to the workspace. The savedPreviewTo path in metadata points to the file on disk.",
     {
       target: import_zod2.z.enum(["selected", "sketch"]).optional().describe("What to capture (default: selected)"),
       sketchId: import_zod2.z.string().optional().describe("Required when target is 'sketch'"),
@@ -5765,6 +5763,7 @@ function registerCaptureTools(server, state) {
     async (args) => {
       try {
         const result = await captureScreenshot(state, args);
+        console.error(`[capture_screenshot] jpeg base64 length: ${result.previewJpegBase64.length}, metadata: ${JSON.stringify(result.metadata)}`);
         return {
           content: [
             { type: "text", text: JSON.stringify(result.metadata, null, 2) },
@@ -5772,6 +5771,7 @@ function registerCaptureTools(server, state) {
           ]
         };
       } catch (e) {
+        console.error(`[capture_screenshot] error: ${e instanceof Error ? e.message : String(e)}`);
         return toolError(e instanceof Error ? e.message : String(e));
       }
     }
@@ -6413,7 +6413,7 @@ function registerKnowledgeTools(server, state) {
 // src/state.ts
 var import_events = require("events");
 var import_promises11 = require("fs/promises");
-var import_path11 = require("path");
+var import_path12 = require("path");
 
 // src/sidecar.ts
 function isSidecarMode() {
@@ -6470,7 +6470,7 @@ var EditorState = class extends import_events.EventEmitter {
   }
   /** Resolve a file path, respecting the sandbox basePath when set. */
   resolvePath(file) {
-    if ((0, import_path11.isAbsolute)(file)) {
+    if ((0, import_path12.isAbsolute)(file)) {
       if (this.basePath && !file.startsWith(this.basePath)) {
         throw new Error(`Path escapes sandbox: ${file}`);
       }
@@ -6478,10 +6478,10 @@ var EditorState = class extends import_events.EventEmitter {
     }
     if ((file.startsWith("~/") || file === "~") && !this.basePath) {
       const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-      return (0, import_path11.resolve)(home, file.slice(2));
+      return (0, import_path12.resolve)(home, file.slice(2));
     }
     const base = this.basePath ?? process.cwd();
-    const resolved = (0, import_path11.resolve)(base, file);
+    const resolved = (0, import_path12.resolve)(base, file);
     if (this.basePath && !resolved.startsWith(this.basePath)) {
       throw new Error(`Path escapes sandbox: ${resolved}`);
     }
@@ -6489,7 +6489,7 @@ var EditorState = class extends import_events.EventEmitter {
   }
   /** Resolve a sketch file reference (relative to workspace dir) to an absolute path. */
   resolveSketchPath(file) {
-    if ((0, import_path11.isAbsolute)(file)) {
+    if ((0, import_path12.isAbsolute)(file)) {
       if (this.basePath && !file.startsWith(this.basePath)) {
         throw new Error(`Path escapes sandbox: ${file}`);
       }
@@ -6497,11 +6497,11 @@ var EditorState = class extends import_events.EventEmitter {
     }
     if (!this.workspacePath) {
       if (this.basePath) {
-        return (0, import_path11.resolve)(this.basePath, file);
+        return (0, import_path12.resolve)(this.basePath, file);
       }
       throw new Error("No workspace is currently open");
     }
-    const resolved = (0, import_path11.resolve)((0, import_path11.dirname)(this.workspacePath), file);
+    const resolved = (0, import_path12.resolve)((0, import_path12.dirname)(this.workspacePath), file);
     if (this.basePath && !resolved.startsWith(this.basePath)) {
       throw new Error(`Path escapes sandbox: ${resolved}`);
     }