@genart-dev/mcp-server 0.4.2 → 0.4.4

package/dist/lib.d.cts

@@ -116,7 +116,11 @@ declare class EditorState extends EventEmitter {
  * Creates a McpServer instance with all tools, resources, and prompts.
  */
 
+interface CreateServerOptions {
+    /** Only register capture tools (for local-only capture companion server). */
+    captureOnly?: boolean;
+}
 /** Create and configure the MCP server with all tools. */
-declare function createServer(state: EditorState): McpServer;
+declare function createServer(state: EditorState, options?: CreateServerOptions): McpServer;
 
-export { type EditorMutationEvent, type EditorMutationType, EditorState, type EditorStateSnapshot, type LoadedSketch, createServer };
+export { type CreateServerOptions, type EditorMutationEvent, type EditorMutationType, EditorState, type EditorStateSnapshot, type LoadedSketch, createServer };

package/dist/lib.d.ts

@@ -116,7 +116,11 @@ declare class EditorState extends EventEmitter {
  * Creates a McpServer instance with all tools, resources, and prompts.
  */
 
+interface CreateServerOptions {
+    /** Only register capture tools (for local-only capture companion server). */
+    captureOnly?: boolean;
+}
 /** Create and configure the MCP server with all tools. */
-declare function createServer(state: EditorState): McpServer;
+declare function createServer(state: EditorState, options?: CreateServerOptions): McpServer;
 
-export { type EditorMutationEvent, type EditorMutationType, EditorState, type EditorStateSnapshot, type LoadedSketch, createServer };
+export { type CreateServerOptions, type EditorMutationEvent, type EditorMutationType, EditorState, type EditorStateSnapshot, type LoadedSketch, createServer };

package/dist/lib.js

@@ -2424,7 +2424,8 @@ function isDirectComponent(name, components) {
 }
 
 // src/tools/capture.ts
-import { writeFile as writeFile5 } from "fs/promises";
+import { mkdir, writeFile as writeFile5 } from "fs/promises";
+import { dirname as dirname5, join as join3 } from "path";
 import {
   createDefaultRegistry as createDefaultRegistry2
 } from "@genart-dev/core";
@@ -2529,8 +2530,9 @@ function generateSketchHtml(sketch, opts) {
   }
   return adapter.generateStandaloneHTML(effective);
 }
-function derivePreviewPath(sketchPath) {
-  return sketchPath.replace(/\.genart$/, ".png");
+function deriveSnapshotPath(sketchPath, sketchId, seed) {
+  const wsDir = dirname5(sketchPath);
+  return join3(wsDir, "snapshots", `${sketchId}-${seed}-preview.png`);
 }
 async function captureScreenshot(state, input) {
   state.requireWorkspace();
@@ -2563,11 +2565,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");
@@ -2588,8 +2591,10 @@ async function buildScreenshotMetadata(state, multi, info) {
     previewPath: info.previewPath
   };
   if (!state.remoteMode) {
+    await mkdir(dirname5(info.previewPath), { recursive: true });
     await writeFile5(info.previewPath, multi.previewPng);
     metadata.savedPreviewTo = info.previewPath;
+    metadata.previewWritten = true;
   }
   return metadata;
 }
@@ -2618,11 +2623,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({
@@ -2982,7 +2988,7 @@ function gatherRelevantSkills(aspects) {
 
 // src/tools/series.ts
 import { writeFile as writeFile6 } from "fs/promises";
-import { basename as basename8, dirname as dirname5, resolve as resolve2 } from "path";
+import { basename as basename8, dirname as dirname6, resolve as resolve2 } from "path";
 import {
   serializeGenart as serializeGenart4,
   serializeWorkspace as serializeWorkspace3
@@ -3262,7 +3268,7 @@ async function promoteSketch(state, input) {
     ...input.agent ? { agent: input.agent } : {},
     ...input.model ? { model: input.model } : {}
   };
-  const sourceDir = dirname5(source.path);
+  const sourceDir = dirname6(source.path);
   const newPath = resolve2(sourceDir, `${newId}.genart`);
   const json = serializeGenart4(promotedDef);
   if (!state.remoteMode) {
@@ -3332,8 +3338,8 @@ function countBy(items) {
 }
 
 // src/tools/reference.ts
-import { copyFile, mkdir, readFile as readFile4 } from "fs/promises";
-import { basename as basename9, dirname as dirname6, extname, resolve as resolve3 } from "path";
+import { copyFile, mkdir as mkdir2, readFile as readFile4 } from "fs/promises";
+import { basename as basename9, dirname as dirname7, extname, resolve as resolve3 } from "path";
 import {
   serializeGenart as serializeGenart5,
   serializeWorkspace as serializeWorkspace4
@@ -3388,9 +3394,9 @@ async function addReference(state, input) {
       `Invalid reference type: '${refType}'. Valid types: ${VALID_REFERENCE_TYPES.join(", ")}`
     );
   }
-  const workspaceDir = dirname6(state.workspacePath);
+  const workspaceDir = dirname7(state.workspacePath);
   const refsDir = resolve3(workspaceDir, "references");
-  await mkdir(refsDir, { recursive: true });
+  await mkdir2(refsDir, { recursive: true });
   const ext = extname(input.image);
   const destFilename = `${id}${ext}`;
   const destPath = resolve3(refsDir, destFilename);
@@ -3478,7 +3484,7 @@ 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 = dirname6(state.workspacePath);
+  const workspaceDir = dirname7(state.workspacePath);
   const imagePath = resolve3(workspaceDir, ref.path);
   let previewJpegBase64;
   try {
@@ -3638,7 +3644,7 @@ async function extractPalette(state, input) {
     input.sketchId
   );
   const count = input.count ?? 6;
-  const workspaceDir = dirname6(state.workspacePath);
+  const workspaceDir = dirname7(state.workspacePath);
   const imagePath = resolve3(workspaceDir, ref.path);
   let previewJpegBase64;
   try {
@@ -3715,7 +3721,7 @@ function findReference(state, referenceId, seriesId, sketchId) {
 // src/tools/export.ts
 import { createWriteStream } from "fs";
 import { stat as stat4, writeFile as writeFile8 } from "fs/promises";
-import { dirname as dirname7 } from "path";
+import { dirname as dirname8 } from "path";
 import archiver from "archiver";
 import {
   createDefaultRegistry as createDefaultRegistry3,
@@ -3723,7 +3729,7 @@ import {
 } from "@genart-dev/core";
 var registry4 = createDefaultRegistry3();
 async function validateOutputPath(outputPath) {
-  const parentDir = dirname7(outputPath);
+  const parentDir = dirname8(outputPath);
   try {
     const s = await stat4(parentDir);
     if (!s.isDirectory()) {
@@ -4993,20 +4999,24 @@ async function initializePluginRegistry() {
   await registry5.register(tracePlugin);
   return registry5;
 }
-function createServer(state) {
+function createServer(state, options) {
+  const captureOnly = options?.captureOnly ?? false;
   const server = new 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);
@@ -5023,7 +5033,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);
@@ -5172,11 +5184,31 @@ function registerSketchTools(server, state) {
       ).optional().describe('Component dependencies. Use list_components to see available. Keys are component names, values are semver ranges (e.g. "^1.0.0") or objects with version/code/exports.'),
       addToWorkspace: z2.string().optional().describe("Path to workspace to add sketch to after creation"),
       agent: z2.string().optional().describe("Your CLI agent name (e.g. 'claude-code', 'codex-cli', 'gemini-cli', 'opencode', 'kiro')"),
-      model: z2.string().optional().describe("Your AI model identifier (e.g. 'claude-opus-4-6', 'gpt-4o', 'gemini-2.5-pro')")
+      model: z2.string().optional().describe("Your AI model identifier (e.g. 'claude-opus-4-6', 'gpt-4o', 'gemini-2.5-pro')"),
+      capture: z2.boolean().optional().describe("When true, automatically capture a screenshot after creation and return it inline (avoids a separate capture_screenshot call)")
     },
     async (args) => {
       try {
         const result = await createSketch(state, args);
+        if (args.capture && !state.remoteMode) {
+          try {
+            const captureResult = await captureScreenshot(state, {
+              target: "sketch",
+              sketchId: args.id
+            });
+            return {
+              content: [
+                { type: "text", text: JSON.stringify({ ...result, capture: captureResult.metadata }, null, 2) },
+                { type: "image", data: captureResult.previewJpegBase64, mimeType: "image/jpeg" }
+              ]
+            };
+          } catch (captureErr) {
+            return jsonResult({
+              ...result,
+              captureError: captureErr instanceof Error ? captureErr.message : String(captureErr)
+            });
+          }
+        }
         return jsonResult(result);
       } catch (e) {
         return toolError(e instanceof Error ? e.message : String(e));
@@ -5733,7 +5765,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: z2.enum(["selected", "sketch"]).optional().describe("What to capture (default: selected)"),
       sketchId: z2.string().optional().describe("Required when target is 'sketch'"),
@@ -6396,7 +6428,7 @@ function registerKnowledgeTools(server, state) {
 // src/state.ts
 import { EventEmitter } from "events";
 import { readFile as readFile5 } from "fs/promises";
-import { dirname as dirname8, isAbsolute, resolve as resolve4 } from "path";
+import { dirname as dirname9, isAbsolute, resolve as resolve4 } from "path";
 
 // src/sidecar.ts
 function isSidecarMode() {
@@ -6490,7 +6522,7 @@ var EditorState = class extends EventEmitter {
       }
       throw new Error("No workspace is currently open");
     }
-    const resolved = resolve4(dirname8(this.workspacePath), file);
+    const resolved = resolve4(dirname9(this.workspacePath), file);
     if (this.basePath && !resolved.startsWith(this.basePath)) {
       throw new Error(`Path escapes sandbox: ${resolved}`);
     }