illustrator-mcp-server 1.3.1 → 1.4.0

package/dist/bundle.cjs

@@ -30283,22 +30283,47 @@ async function writeJsx(scriptPath, jsxCode60) {
   await fs.writeFile(scriptPath, BOM + jsxCode60, "utf-8");
 }
 async function writeAppleScript(scptPath, scriptPath, options) {
-  const lines = ['tell application "Adobe Illustrator"'];
-  if (options?.activate) {
-    lines.push("  activate");
-  }
   const escaped = scriptPath.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
-  lines.push(`  do javascript of file "${escaped}"`);
-  lines.push("end tell");
-  await fs.writeFile(scptPath, lines.join("\n"), "utf-8");
+  const activateLine = options?.activate ? "\n  activate" : "";
+  const jsxLine = `  do javascript of file "${escaped}"`;
+  let script;
+  if (options?.appPath) {
+    const appPathEscaped = options.appPath.replace(/"/g, '\\"');
+    script = [
+      `tell application "${appPathEscaped}"${activateLine}`,
+      jsxLine,
+      "end tell"
+    ].join("\n");
+  } else {
+    script = [
+      `tell application "Adobe Illustrator"${activateLine}`,
+      jsxLine,
+      "end tell"
+    ].join("\n");
+  }
+  await fs.writeFile(scptPath, script, "utf-8");
 }
 async function writePowerShellScript(ps1Path, scriptPath, options) {
   const jsxPathForward = scriptPath.replace(/\\/g, "/");
   const jsxPathEscaped = jsxPathForward.replace(/'/g, "\\'");
+  const launchLines = options?.appPath ? [
+    "  # \u8D77\u52D5\u6E08\u307F\u306E Illustrator \u304C\u3042\u308C\u3070\u305D\u3061\u3089\u3092\u512A\u5148",
+    '  if (-not (Get-Process -Name "Illustrator" -ErrorAction SilentlyContinue)) {',
+    `    Start-Process "${options.appPath.replace(/"/g, '`"')}"`,
+    "    Start-Sleep -Seconds 5",
+    "  }"
+  ] : [];
+  const activateLines = options?.activate ? [
+    "  try {",
+    '    $wsh = New-Object -ComObject "WScript.Shell"',
+    '    $wsh.AppActivate("Adobe Illustrator") | Out-Null',
+    "  } catch {}"
+  ] : [];
   const lines = [
     "try {",
+    ...launchLines,
     '  $ai = New-Object -ComObject "Illustrator.Application" -ErrorAction Stop',
-    ...options?.activate ? ["  $ai.Visible = $true"] : [],
+    ...activateLines,
     `  $ai.DoJavaScript("$.evalFile(new File('${jsxPathEscaped}'))")`,
     "} catch {",
     '  Write-Error "Illustrator COM automation failed: $_"',
@@ -30353,6 +30378,27 @@ function getTransport() {
   if (!_transport) _transport = resolveTransport();
   return _transport;
 }
+function resolveVersionToPath(version2, platform = process.platform) {
+  if (platform === "darwin") {
+    return `/Applications/Adobe Illustrator ${version2}/Adobe Illustrator.app`;
+  }
+  if (platform === "win32") {
+    return `C:\\Program Files\\Adobe\\Adobe Illustrator ${version2}\\Support Files\\Contents\\Windows\\Illustrator.exe`;
+  }
+  throw new Error(`Unsupported platform: ${platform}`);
+}
+var _sessionAppPath;
+function setAppVersion(version2, platform) {
+  _sessionAppPath = version2 ? resolveVersionToPath(version2, platform) : void 0;
+}
+function getAppPath() {
+  return _sessionAppPath;
+}
+function getAppVersion() {
+  if (!_sessionAppPath) return void 0;
+  const match = _sessionAppPath.match(/Illustrator (\d{4})/);
+  return match ? match[1] : void 0;
+}
 function waitForPendingExecutions() {
   if (pendingCount === 0) return Promise.resolve();
   return new Promise((resolve2) => {
@@ -30412,7 +30458,7 @@ async function executeViaOsascript(jsxCode60, params, timeout, activate) {
     await writeParams(files.paramsPath, params);
     const fullJsx = await buildJsx(jsxCode60, files.paramsPath, files.resultPath);
     await writeJsx(files.scriptPath, fullJsx);
-    await writeAppleScript(files.runnerPath, files.scriptPath, { activate });
+    await writeAppleScript(files.runnerPath, files.scriptPath, { activate, appPath: getAppPath() });
     await new Promise((resolve2, reject) => {
       (0, import_child_process.execFile)("osascript", [files.runnerPath], { timeout }, (error48, _stdout, stderr) => {
         if (error48) {
@@ -30433,7 +30479,7 @@ async function executeViaPowerShell(jsxCode60, params, timeout, activate) {
     await writeParams(files.paramsPath, params);
     const fullJsx = await buildJsx(jsxCode60, files.paramsPath, files.resultPath);
     await writeJsx(files.scriptPath, fullJsx);
-    await writePowerShellScript(files.runnerPath, files.scriptPath, { activate });
+    await writePowerShellScript(files.runnerPath, files.scriptPath, { activate, appPath: getAppPath() });
     await new Promise((resolve2, reject) => {
       (0, import_child_process.execFile)(
         "powershell.exe",
@@ -30628,7 +30674,7 @@ async function resolveCoordinateSystem(explicit) {
   }
 }
 var coordinateSystemSchema = external_exports.enum(["artboard-web", "document"]).optional().describe(
-  "Coordinate system. Omit to auto-detect from document (CMYK\u2192document, RGB\u2192artboard-web). Override via set_workflow."
+  "Coordinate system. Auto-detected from document by default (CMYK/print \u2192 document, RGB/web \u2192 artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coords, origin at bottom-left, Y-up. Call get_document_info to check which system is active."
 );
 function detectWorkflow(signals) {
   const { colorMode, rulerUnits, rasterEffectResolution, colorProfile } = signals;
@@ -30696,6 +30742,23 @@ function detectWorkflow(signals) {
   };
 }
 
+// src/tools/tool-executor.ts
+function ensureToolParams(params) {
+  if (params && typeof params === "object" && !Array.isArray(params)) {
+    return params;
+  }
+  return {};
+}
+function formatToolResult(result) {
+  return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+}
+async function executeToolJsx(jsxCode60, params, options) {
+  const baseParams = ensureToolParams(params);
+  const resolvedParams = options?.resolveCoordinate ? { ...baseParams, coordinate_system: await resolveCoordinateSystem(baseParams.coordinate_system) } : baseParams;
+  const result = options?.heavy ? await executeJsxHeavy(jsxCode60, resolvedParams) : await executeJsx(jsxCode60, resolvedParams, { activate: options?.activate ?? false });
+  return formatToolResult(result);
+}
+
 // src/tools/modify/shared.ts
 var coerceBoolean = external_exports.preprocess(
   (val) => {
@@ -30977,30 +31040,11 @@ function register(server) {
         });
         result.workflowHint = hint;
       }
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return formatToolResult(result);
     }
   );
 }
 
-// src/tools/tool-executor.ts
-function ensureToolParams(params) {
-  if (params && typeof params === "object" && !Array.isArray(params)) {
-    return params;
-  }
-  return {};
-}
-function formatToolResult(result) {
-  return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-}
-async function executeToolJsx(jsxCode60, params, options) {
-  const baseParams = ensureToolParams(params);
-  const resolvedParams = options?.resolveCoordinate ? { ...baseParams, coordinate_system: await resolveCoordinateSystem(baseParams.coordinate_system) } : baseParams;
-  const result = options?.heavy ? await executeJsxHeavy(jsxCode60, resolvedParams) : await executeJsx(jsxCode60, resolvedParams, { activate: options?.activate ?? false });
-  return formatToolResult(result);
-}
-
 // src/tools/read/get-artboards.ts
 var jsxCode2 = `
 var preflight = preflightChecks();
@@ -31057,7 +31101,7 @@ if (preflight) {
       artboards.push(info);
     }
 
-    writeResultFile(RESULT_PATH, { artboards: artboards });
+    writeResultFile(RESULT_PATH, { coordinateSystem: coordSystem, artboards: artboards });
     } // end if (!hasError)
   } catch (e) {
     writeResultFile(RESULT_PATH, { error: true, message: "Failed to get artboard info: " + e.message, line: e.line });
@@ -31152,7 +31196,7 @@ if (preflight) {
       layers.push(traverseLayer(doc.layers[i]));
     }
 
-    writeResultFile(RESULT_PATH, { layers: layers });
+    writeResultFile(RESULT_PATH, { coordinateSystem: coordSystem, layers: layers });
   } catch (e) {
     writeResultFile(RESULT_PATH, { error: true, message: "get_layers: " + e.message, line: e.line });
   }
@@ -31563,9 +31607,7 @@ function register5(server) {
       annotations: READ_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode5, resolvedParams);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return executeToolJsx(jsxCode5, params, { resolveCoordinate: true });
     }
   );
 }
@@ -31794,7 +31836,7 @@ function register6(server) {
       const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
       const result = await executeJsx(jsxCode6, resolvedParams);
       if (result.error) {
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        return formatToolResult(result);
       }
       const runs = result.characterRuns ?? [];
       const kerningPairs = result.kerningPairs ?? [];
@@ -32176,7 +32218,7 @@ function register7(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode7, params);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -32288,14 +32330,20 @@ if (preflight) {
       try { info.closed = item.closed; } catch (e) {}
       try { info.opacity = item.opacity; } catch (e) {}
 
-      // Extract rotation from transformation matrix
+      // Extract rotation from transformation matrix, fallback to note metadata
       try {
         var m = item.matrix;
-        if (m) {
+        if (m && typeof m.mValueA === "number") {
           var rad = Math.atan2(m.mValueB, m.mValueA);
           info.transform.rotation = Math.round(rad * 180 / Math.PI * 100) / 100;
         }
       } catch (e) {}
+      if (info.transform.rotation === null) {
+        try {
+          var notRot = getNoteMeta(item.note, "rot");
+          if (notRot) info.transform.rotation = parseFloat(notRot);
+        } catch (e) {}
+      }
 
       // fill
       // Note: ExtendScript does not expose per-fill opacity on pathItems.
@@ -32415,11 +32463,7 @@ function register8(server) {
       annotations: READ_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode8, resolvedParams);
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return executeToolJsx(jsxCode8, params, { resolveCoordinate: true });
     }
   );
 }
@@ -32510,11 +32554,7 @@ function register9(server) {
       annotations: READ_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode9, resolvedParams);
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return executeToolJsx(jsxCode9, params, { resolveCoordinate: true });
     }
   );
 }
@@ -32676,11 +32716,7 @@ function register10(server) {
       annotations: READ_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode10, resolvedParams);
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return executeToolJsx(jsxCode10, params, { resolveCoordinate: true });
     }
   );
 }
@@ -32847,11 +32883,7 @@ function register11(server) {
       annotations: READ_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode11, resolvedParams);
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return executeToolJsx(jsxCode11, params, { resolveCoordinate: true });
     }
   );
 }
@@ -33114,7 +33146,19 @@ if (preflight) {
 
       try { info.name = item.name || ""; } catch(e) {}
 
-      // Store placed dimensions in points for Node.js-side DPI calculation
+      // Store matrix scale factors for Node.js-side DPI calculation
+      // Using matrix vector magnitude instead of geometricBounds to handle rotation correctly
+      // (geometricBounds returns AABB which is larger when rotated, giving incorrect PPI)
+      try {
+        var pm = item.matrix;
+        if (pm) {
+          var psX = Math.sqrt(pm.mValueA * pm.mValueA + pm.mValueB * pm.mValueB);
+          var psY = Math.sqrt(pm.mValueC * pm.mValueC + pm.mValueD * pm.mValueD);
+          info.matrixScaleX = psX;
+          info.matrixScaleY = psY;
+        }
+      } catch(e) {}
+      // Fallback: also store geometricBounds dimensions
       try {
         var pBounds = item.geometricBounds;
         var pWidthPt = pBounds[2] - pBounds[0];
@@ -33246,16 +33290,27 @@ function register12(server) {
           if (img.type === "linked" && img.filePath && !img.linkBroken) {
             try {
               const dims = readImageDimensions(img.filePath);
-              if (dims && img.widthPt && img.heightPt) {
+              if (dims) {
                 img.pixelWidth = dims.width;
                 img.pixelHeight = dims.height;
-                const widthInches = img.widthPt / 72;
-                const heightInches = img.heightPt / 72;
-                const ppiH = Math.round(dims.width / widthInches);
-                const ppiV = Math.round(dims.height / heightInches);
-                img.resolution = Math.min(ppiH, ppiV);
-                if (resolvedParams.include_print_info) {
-                  img.scaleFactor = Math.round(img.widthPt / dims.width * 100);
+                const matrixScaleX = img.matrixScaleX;
+                const matrixScaleY = img.matrixScaleY;
+                if (matrixScaleX && matrixScaleY && matrixScaleX > 0 && matrixScaleY > 0) {
+                  const ppiH = Math.round(72 / matrixScaleX);
+                  const ppiV = Math.round(72 / matrixScaleY);
+                  img.resolution = Math.min(ppiH, ppiV);
+                  if (resolvedParams.include_print_info) {
+                    img.scaleFactor = Math.round(matrixScaleX * 100);
+                  }
+                } else if (img.widthPt && img.heightPt) {
+                  const widthInches = img.widthPt / 72;
+                  const heightInches = img.heightPt / 72;
+                  const ppiH = Math.round(dims.width / widthInches);
+                  const ppiV = Math.round(dims.height / heightInches);
+                  img.resolution = Math.min(ppiH, ppiV);
+                  if (resolvedParams.include_print_info) {
+                    img.scaleFactor = Math.round(img.widthPt / dims.width * 100);
+                  }
                 }
               }
             } catch {
@@ -33263,11 +33318,11 @@ function register12(server) {
           }
           delete img.widthPt;
           delete img.heightPt;
+          delete img.matrixScaleX;
+          delete img.matrixScaleY;
         }
       }
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return formatToolResult(result);
     }
   );
 }
@@ -33357,11 +33412,7 @@ function register13(server) {
       annotations: READ_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode13, resolvedParams);
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return executeToolJsx(jsxCode13, params, { resolveCoordinate: true });
     }
   );
 }
@@ -33463,11 +33514,7 @@ function register14(server) {
       annotations: READ_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode14, resolvedParams);
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return executeToolJsx(jsxCode14, params, { resolveCoordinate: true });
     }
   );
 }
@@ -33653,11 +33700,7 @@ function register15(server) {
       annotations: READ_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode15, resolvedParams);
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return executeToolJsx(jsxCode15, params, { resolveCoordinate: true });
     }
   );
 }
@@ -33801,34 +33844,23 @@ function register16(server) {
         const rgb1 = colorToRGB(params.color1);
         const rgb2 = colorToRGB(params.color2);
         if (!rgb1 || !rgb2) {
-          return { content: [{ type: "text", text: JSON.stringify({ error: true, message: "Could not convert colors to RGB" }) }] };
+          return formatToolResult({ error: true, message: "Could not convert colors to RGB" });
         }
         const l1 = relativeLuminance(rgb1.r, rgb1.g, rgb1.b);
         const l2 = relativeLuminance(rgb2.r, rgb2.g, rgb2.b);
         const ratio = Math.round(contrastRatio(l1, l2) * 100) / 100;
-        return {
-          content: [
-            {
-              type: "text",
-              text: JSON.stringify(
-                {
-                  contrastRatio: ratio,
-                  wcagAA_normal: ratio >= 4.5,
-                  wcagAA_large: ratio >= 3,
-                  wcagAAA: ratio >= 7,
-                  color1_rgb: rgb1,
-                  color2_rgb: rgb2
-                },
-                null,
-                2
-              )
-            }
-          ]
-        };
+        return formatToolResult({
+          contrastRatio: ratio,
+          wcagAA_normal: ratio >= 4.5,
+          wcagAA_large: ratio >= 3,
+          wcagAAA: ratio >= 7,
+          color1_rgb: rgb1,
+          color2_rgb: rgb2
+        });
       }
       const result = await executeJsx(jsxCode16, params);
       if (result.error) {
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        return formatToolResult(result);
       }
       const items = result.colorItems;
       const pairs = [];
@@ -33867,14 +33899,7 @@ function register16(server) {
         return true;
       });
       unique.sort((a, b) => a.contrastRatio - b.contrastRatio);
-      return {
-        content: [
-          {
-            type: "text",
-            text: JSON.stringify({ pairCount: unique.length, pairs: unique }, null, 2)
-          }
-        ]
-      };
+      return formatToolResult({ pairCount: unique.length, pairs: unique });
     }
   );
 }
@@ -34052,7 +34077,7 @@ function register17(server) {
     async (params) => {
       const result = await executeJsx(jsxCode17, params);
       if (result.error) {
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        return formatToolResult(result);
       }
       const colorCounts = /* @__PURE__ */ new Map();
       for (const c of [...result.fillColors, ...result.strokeColors]) {
@@ -34123,6 +34148,8 @@ Saved to: ${params.output_path}` }]
 }
 
 // src/tools/export/export.ts
+var import_node_fs = require("node:fs");
+var import_node_path = require("node:path");
 var jsxCode18 = `
 var preflight = preflightChecks();
 if (preflight) {
@@ -34401,7 +34428,7 @@ function register18(server) {
     "export",
     {
       title: "Export",
-      description: "Export objects, groups, artboards, or selection. Note: Illustrator will be activated (brought to foreground) during execution.",
+      description: "Export objects, groups, artboards, or selection. For PNG/JPG, the exported image is returned as base64 in the response \u2014 you can view it directly without reading the file from disk. Note: Illustrator will be activated (brought to foreground) during execution.",
       inputSchema: {
         target: external_exports.string().describe('UUID, "artboard:<index>", or "selection". When exporting a UUID target as PNG/JPG, a temporary document is created internally (selection state may change).'),
         // WebP is not supported by ExtendScript API
@@ -34425,8 +34452,43 @@ function register18(server) {
       annotations: WRITE_IDEMPOTENT_ANNOTATIONS
     },
     async (params) => {
-      const result = await executeJsxHeavy(jsxCode18, params);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      const resolvedParams = { ...params };
+      if (resolvedParams.output_path) {
+        const dir = (0, import_node_path.dirname)(resolvedParams.output_path);
+        if ((0, import_node_fs.existsSync)(dir)) {
+          try {
+            const realDir = (0, import_node_fs.realpathSync)(dir);
+            resolvedParams.output_path = (0, import_node_path.join)(realDir, (0, import_node_path.basename)(resolvedParams.output_path));
+          } catch (_) {
+          }
+        }
+      }
+      const result = await executeJsxHeavy(jsxCode18, resolvedParams);
+      const textResult = formatToolResult(result);
+      if (result && typeof result === "object" && result.success && result.output_path && (params.format === "png" || params.format === "jpg")) {
+        const outputPath = result.output_path;
+        try {
+          if ((0, import_node_fs.existsSync)(outputPath)) {
+            const imageData = (0, import_node_fs.readFileSync)(outputPath).toString("base64");
+            const mimeType = params.format === "png" ? "image/png" : "image/jpeg";
+            const visualCheckNote = {
+              type: "text",
+              text: JSON.stringify({
+                visual_check_hint: "Now review the exported image visually \u2014 not just numerically. Text alignment can look off even when coordinates are mathematically correct, because bounding boxes include invisible padding. If text appears misaligned, adjust by visual impression rather than exact numbers."
+              })
+            };
+            return {
+              content: [
+                ...textResult.content,
+                visualCheckNote,
+                { type: "image", data: imageData, mimeType }
+              ]
+            };
+          }
+        } catch {
+        }
+      }
+      return textResult;
     }
   );
 }
@@ -34728,7 +34790,7 @@ function register19(server) {
         ...result,
         _note: "PDF exported. This file should be verified by a human before final print submission \u2014 automated checks cannot catch all print-critical issues."
       };
-      return { content: [{ type: "text", text: JSON.stringify(output, null, 2) }] };
+      return formatToolResult(output);
     }
   );
 }
@@ -34843,9 +34905,7 @@ function register20(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode20, params);
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return formatToolResult(result);
     }
   );
 }
@@ -34935,9 +34995,7 @@ function register21(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode21, params);
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return formatToolResult(result);
     }
   );
 }
@@ -34974,8 +35032,8 @@ if (preflight) {
         } else if (color.typename === "RGBColor") {
           if (color.red === 255 && color.green === 255 && color.blue === 255) return true;
         } else if (color.typename === "GrayColor") {
-          // GrayColor.gray \u306F\u30A4\u30F3\u30AF\u91CF: 0=\u767D(\u30A4\u30F3\u30AF\u306A\u3057), 100=\u9ED2(\u30D5\u30EB\u30A4\u30F3\u30AF)
-          // E2E\u30C6\u30B9\u30C8\u3067\u78BA\u8A8D\u6E08\u307F\u3002\u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u306E "0=black, 100=white" \u8A18\u8F09\u306F\u8AA4\u308A\u3002
+          // GrayColor.gray: 0=\u767D(\u30A4\u30F3\u30AF\u306A\u3057), 100=\u9ED2(\u30D5\u30EB\u30A4\u30F3\u30AF)
+          // Adobe\u516C\u5F0F\u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u306E\u300C0=black, 100=white\u300D\u8A18\u8F09\u306F\u8AA4\u308A (Illustrator 2026 \u5B9F\u6A5F\u691C\u8A3C\u6E08\u307F)
           if (color.gray === 0) return true;
         }
       } catch(e) {}
@@ -35094,18 +35152,32 @@ if (preflight) {
           var pFile = pItem.file;
           if (pFile && pFile.exists) {
             var pUuid = ensureUUID(pItem);
+            var pData = {
+              uuid: pUuid,
+              name: pItem.name || "",
+              filePath: pFile.fsName,
+              widthPt: 0,
+              heightPt: 0,
+              matrixScaleX: 0,
+              matrixScaleY: 0
+            };
+            // Get matrix scale factors for rotation-safe PPI calculation
+            try {
+              var plm = pItem.matrix;
+              if (plm) {
+                pData.matrixScaleX = Math.sqrt(plm.mValueA * plm.mValueA + plm.mValueB * plm.mValueB);
+                pData.matrixScaleY = Math.sqrt(plm.mValueC * plm.mValueC + plm.mValueD * plm.mValueD);
+              }
+            } catch(e2) {}
+            // Fallback: geometricBounds
             var pBounds = pItem.geometricBounds;
             var pWPt = pBounds[2] - pBounds[0];
             var pHPt = -(pBounds[3] - pBounds[1]);
             if (pWPt < 0) pWPt = -pWPt;
             if (pHPt < 0) pHPt = -pHPt;
-            placedImageData.push({
-              uuid: pUuid,
-              name: pItem.name || "",
-              filePath: pFile.fsName,
-              widthPt: pWPt,
-              heightPt: pHPt
-            });
+            pData.widthPt = pWPt;
+            pData.heightPt = pHPt;
+            placedImageData.push(pData);
           }
         } catch(e) {}
       }
@@ -35326,15 +35398,24 @@ function register22(server) {
       const minDpi = result?.minDPI ?? params.min_dpi ?? 300;
       if (result?.placedImageData) {
         for (const placed of result.placedImageData) {
-          if (!placed.filePath || placed.widthPt <= 0 || placed.heightPt <= 0) continue;
+          if (!placed.filePath) continue;
           try {
             const dims = readImageDimensions(placed.filePath);
             if (dims) {
-              const widthInches = placed.widthPt / 72;
-              const heightInches = placed.heightPt / 72;
-              const ppiH = Math.round(dims.width / widthInches);
-              const ppiV = Math.round(dims.height / heightInches);
-              const effectivePPI = Math.min(ppiH, ppiV);
+              let effectivePPI;
+              if (placed.matrixScaleX > 0 && placed.matrixScaleY > 0) {
+                const ppiH = Math.round(72 / placed.matrixScaleX);
+                const ppiV = Math.round(72 / placed.matrixScaleY);
+                effectivePPI = Math.min(ppiH, ppiV);
+              } else if (placed.widthPt > 0 && placed.heightPt > 0) {
+                const widthInches = placed.widthPt / 72;
+                const heightInches = placed.heightPt / 72;
+                const ppiH = Math.round(dims.width / widthInches);
+                const ppiV = Math.round(dims.height / heightInches);
+                effectivePPI = Math.min(ppiH, ppiV);
+              } else {
+                continue;
+              }
               if (effectivePPI < minDpi) {
                 result.results.push({
                   level: "error",
@@ -35418,9 +35499,7 @@ function register22(server) {
       if (!hasIssues) {
         result._note = "No issues detected by these automated checks. This does not mean the document is free of problems \u2014 items outside the scope of automated checks (design intent, contextual spelling, regulatory requirements, print-shop-specific rules) still require human review.";
       }
-      return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
-      };
+      return formatToolResult(result);
     }
   );
 }
@@ -35673,32 +35752,21 @@ function register23(server) {
       const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
       const result = await executeJsx(jsxCode23, resolvedParams);
       if (result.error) {
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        return formatToolResult(result);
       }
       const analysis = analyzeTextConsistency(result.frames);
-      return {
-        content: [
-          {
-            type: "text",
-            text: JSON.stringify(
-              {
-                totalFrames: result.totalFrames,
-                mechanicalChecks: {
-                  _reliability: "deterministic",
-                  dummyTexts: analysis.dummyTexts,
-                  knownVariations: analysis.knownVariations
-                },
-                llmAnalysis: {
-                  _reliability: "ai-assisted \u2014 may miss errors or produce false positives. Clearly distinguish AI-based findings from mechanical checks when reporting to the user.",
-                  allTexts: analysis.allTexts
-                }
-              },
-              null,
-              2
-            )
-          }
-        ]
-      };
+      return formatToolResult({
+        totalFrames: result.totalFrames,
+        mechanicalChecks: {
+          _reliability: "deterministic",
+          dummyTexts: analysis.dummyTexts,
+          knownVariations: analysis.knownVariations
+        },
+        llmAnalysis: {
+          _reliability: "ai-assisted \u2014 may miss errors or produce false positives. Clearly distinguish AI-based findings from mechanical checks when reporting to the user.",
+          allTexts: analysis.allTexts
+        }
+      });
     }
   );
 }
@@ -35714,7 +35782,7 @@ function register24(server) {
     "set_workflow",
     {
       title: "Set Workflow",
-      description: "Set the session-level workflow and default coordinate system. Call this after confirming the user's intent (web, print, or video). Once set, all tools that omit coordinate_system will use the session default. Use clear: true to reset to the default behavior (artboard-web).",
+      description: "Set the session-level workflow and default coordinate system. Call this after confirming the user's intent (web, print, or video). Once set, all tools that omit coordinate_system will use the session default. Use clear: true to reset to auto-detection from document (CMYK/print \u2192 document coords, RGB/web \u2192 artboard-web).",
       inputSchema: {
         workflow: external_exports.enum(["web", "print", "video"]).optional().describe("The workflow type. Determines the default coordinate system."),
         coordinate_system: external_exports.enum(["artboard-web", "document"]).optional().describe(
@@ -35781,6 +35849,59 @@ function register24(server) {
   );
 }
 
+// src/tools/utility/set-illustrator-version.ts
+function register25(server) {
+  server.registerTool(
+    "set_illustrator_version",
+    {
+      title: "Set Illustrator Version",
+      description: 'Set which Illustrator version to target when multiple versions are installed. Specify a version year (e.g. "2024", "2025"). If Illustrator is already running, connects to the running instance regardless of version. If not running, launches the specified version. Use clear: true to reset to default behavior (connect to any running Illustrator).',
+      inputSchema: {
+        version: external_exports.string().regex(/^\d{4}$/, 'Version must be a 4-digit year (e.g. "2025")').optional().describe('Illustrator version year (e.g. "2024", "2025").'),
+        clear: external_exports.boolean().optional().describe("Reset to default behavior (connect to any running Illustrator).")
+      },
+      annotations: WRITE_IDEMPOTENT_ANNOTATIONS
+    },
+    async (params) => {
+      if (params.clear) {
+        setAppVersion(void 0);
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              status: "cleared",
+              message: "Illustrator version reset. Will connect to any running Illustrator."
+            })
+          }]
+        };
+      }
+      if (!params.version) {
+        const current = getAppVersion();
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              currentVersion: current ?? null,
+              message: current ? `Illustrator ${current} is targeted.` : "No version set. Will connect to any running Illustrator."
+            })
+          }]
+        };
+      }
+      setAppVersion(params.version);
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            status: "set",
+            version: params.version,
+            message: `Illustrator ${params.version} targeted. If already running, connects to that instance; otherwise launches ${params.version}.`
+          })
+        }]
+      };
+    }
+  );
+}
+
 // src/tools/modify/create-rectangle.ts
 var jsxCode24 = `
 var preflight = preflightChecks();
@@ -35821,13 +35942,13 @@ if (preflight) {
     }
 
     var uuid = ensureUUID(rect);
-    writeResultFile(RESULT_PATH, { uuid: uuid, verified: verifyItem(rect, coordSystem, abRect) });
+    writeResultFile(RESULT_PATH, { uuid: uuid, coordinateSystem: coordSystem, verified: verifyItem(rect, coordSystem, abRect) });
   } catch (e) {
     writeResultFile(RESULT_PATH, { error: true, message: "Failed to create rectangle: " + e.message, line: e.line });
   }
 }
 `;
-function register25(server) {
+function register26(server) {
   server.registerTool(
     "create_rectangle",
     {
@@ -35887,13 +36008,13 @@ if (preflight) {
     }
 
     var uuid = ensureUUID(ellipse);
-    writeResultFile(RESULT_PATH, { uuid: uuid, verified: verifyItem(ellipse, coordSystem, abRect) });
+    writeResultFile(RESULT_PATH, { uuid: uuid, coordinateSystem: coordSystem, verified: verifyItem(ellipse, coordSystem, abRect) });
   } catch (e) {
     writeResultFile(RESULT_PATH, { error: true, message: "Failed to create ellipse: " + e.message, line: e.line });
   }
 }
 `;
-function register26(server) {
+function register27(server) {
   server.registerTool(
     "create_ellipse",
     {
@@ -35966,13 +36087,13 @@ if (preflight) {
     }
 
     var uuid = ensureUUID(line);
-    writeResultFile(RESULT_PATH, { uuid: uuid, verified: verifyItem(line, coordSystem, abRect) });
+    writeResultFile(RESULT_PATH, { uuid: uuid, coordinateSystem: coordSystem, verified: verifyItem(line, coordSystem, abRect) });
   } catch (e) {
     writeResultFile(RESULT_PATH, { error: true, message: "Failed to create line: " + e.message, line: e.line });
   }
 }
 `;
-function register27(server) {
+function register28(server) {
   server.registerTool(
     "create_line",
     {
@@ -36074,7 +36195,7 @@ if (preflight) {
     }
 
     var uuid = ensureUUID(tf);
-    var resultData = { uuid: uuid, verified: verifyItem(tf, coordSystem, abRect) };
+    var resultData = { uuid: uuid, coordinateSystem: coordSystem, verified: verifyItem(tf, coordSystem, abRect) };
     if (fontCandidates !== null) {
       resultData.font_warning = "Font '" + params.font_name + "' not found. Text frame created with default font.";
       resultData.font_candidates = fontCandidates;
@@ -36085,7 +36206,7 @@ if (preflight) {
   }
 }
 `;
-function register28(server) {
+function register29(server) {
   server.registerTool(
     "create_text_frame",
     {
@@ -36108,9 +36229,7 @@ function register28(server) {
       annotations: WRITE_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode27, resolvedParams, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return executeToolJsx(jsxCode27, params, { activate: true, resolveCoordinate: true });
     }
   );
 }
@@ -36178,7 +36297,7 @@ if (preflight) {
     }
 
     var uuid = ensureUUID(path);
-    writeResultFile(RESULT_PATH, { uuid: uuid, verified: verifyItem(path, coordSystem, abRect) });
+    writeResultFile(RESULT_PATH, { uuid: uuid, coordinateSystem: coordSystem, verified: verifyItem(path, coordSystem, abRect) });
   } catch (e) {
     writeResultFile(RESULT_PATH, { error: true, message: "Failed to create path: " + e.message, line: e.line });
   }
@@ -36197,7 +36316,7 @@ var anchorSchema = external_exports.object({
   }).optional().describe("Right direction handle coordinates"),
   point_type: external_exports.enum(["corner", "smooth"]).optional().default("corner").describe("Point type")
 });
-function register29(server) {
+function register30(server) {
   server.registerTool(
     "create_path",
     {
@@ -36239,10 +36358,10 @@ if (preflight) {
     } else {
       var props = params.properties;
       var errors = [];
+      var abRect = (coordSystem === "artboard-web") ? getActiveArtboardRect() : null;
 
       if (props.position) {
         try {
-          var abRect = (coordSystem === "artboard-web") ? getActiveArtboardRect() : null;
           var pos = webToAiPoint(props.position.x, props.position.y, coordSystem, abRect);
           item.position = pos;
         } catch(e) { errors.push("position: " + e.message); }
@@ -36278,18 +36397,25 @@ if (preflight) {
 
       if (typeof props.rotation === "number") {
         try {
-          if (props.rotation_mode === "absolute") {
-            // \u73FE\u5728\u306E\u56DE\u8EE2\u89D2\u3092 Matrix \u304B\u3089\u7B97\u51FA\u3057\u3001\u5DEE\u5206\u3092 rotate() \u306B\u6E21\u3059
-            var m = item.matrix;
-            var currentRad = Math.atan2(m.mValueB, m.mValueA);
-            var currentDeg = currentRad * 180 / Math.PI;
+          var rotMode = props.rotation_mode || "delta";
+          if (rotMode === "absolute") {
+            // note \u30E1\u30BF\u30C7\u30FC\u30BF\u304B\u3089\u73FE\u5728\u306E\u7D2F\u7A4D\u56DE\u8EE2\u89D2\u5EA6\u3092\u8AAD\u307F\u53D6\u308A\u3001\u5DEE\u5206\u3092\u9069\u7528
+            var noteStr = item.note || "";
+            var currentDeg = parseFloat(getNoteMeta(noteStr, "rot")) || 0;
             var delta = props.rotation - currentDeg;
-            item.rotate(delta);
+            if (Math.abs(delta) > 0.001) {
+              item.rotate(delta);
+            }
+            setNoteMeta(item, "rot", String(Math.round(props.rotation * 1000) / 1000));
           } else {
             item.rotate(props.rotation);
+            // delta \u56DE\u8EE2\u6642\u3082\u7D2F\u7A4D\u89D2\u5EA6\u3092\u66F4\u65B0
+            var noteStr2 = item.note || "";
+            var prevDeg = parseFloat(getNoteMeta(noteStr2, "rot")) || 0;
+            setNoteMeta(item, "rot", String(Math.round((prevDeg + props.rotation) * 1000) / 1000));
           }
         }
-        catch(e) { errors.push("rotation: " + e.message); }
+        catch(e) { errors.push("rotation: " + e.message + " (line: " + (e.line || "?") + ")"); }
       }
 
       if (typeof props.name === "string") {
@@ -36325,11 +36451,11 @@ if (preflight) {
 
       var verifiedState = verifyItem(item, coordSystem, abRect);
       if (errors.length > 0) {
-        var result = { success: false, uuid: params.uuid, errors: errors, verified: verifiedState };
+        var result = { success: false, uuid: params.uuid, coordinateSystem: coordSystem, errors: errors, verified: verifiedState };
         if (fontCandidates !== null) { result.font_candidates = fontCandidates; }
         writeResultFile(RESULT_PATH, result);
       } else {
-        writeResultFile(RESULT_PATH, { success: true, uuid: params.uuid, verified: verifiedState });
+        writeResultFile(RESULT_PATH, { success: true, uuid: params.uuid, coordinateSystem: coordSystem, verified: verifiedState });
       }
     }
   } catch (e) {
@@ -36337,7 +36463,7 @@ if (preflight) {
   }
 }
 `;
-function register30(server) {
+function register31(server) {
   server.registerTool(
     "modify_object",
     {
@@ -36369,9 +36495,7 @@ function register30(server) {
       annotations: DESTRUCTIVE_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode29, resolvedParams, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return executeToolJsx(jsxCode29, params, { activate: true, resolveCoordinate: true });
     }
   );
 }
@@ -36434,7 +36558,7 @@ if (preflight) {
   }
 }
 `;
-function register31(server) {
+function register32(server) {
   server.registerTool(
     "convert_to_outlines",
     {
@@ -36447,7 +36571,7 @@ function register31(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode30, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -36500,7 +36624,7 @@ if (preflight) {
   }
 }
 `;
-function register32(server) {
+function register33(server) {
   server.registerTool(
     "assign_color_profile",
     {
@@ -36513,7 +36637,7 @@ function register32(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode31, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -36584,11 +36708,12 @@ if (preflight) {
 
       writeResultFile(RESULT_PATH, {
         uuid: uuid,
+        coordinateSystem: coordSystem,
         type: params.embed ? "embedded" : "linked",
         filePath: filePath,
         widthPt: widthPt,
         heightPt: heightPt,
-        verified: verifyItem(resultItem)
+        verified: verifyItem(resultItem, coordSystem, abRect)
       });
     }
   } catch (e) {
@@ -36596,7 +36721,7 @@ if (preflight) {
   }
 }
 `;
-function register33(server) {
+function register34(server) {
   server.registerTool(
     "place_image",
     {
@@ -36614,9 +36739,7 @@ function register33(server) {
       annotations: WRITE_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode32, resolvedParams, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return executeToolJsx(jsxCode32, params, { activate: true, resolveCoordinate: true });
     }
   );
 }
@@ -36743,6 +36866,7 @@ if (preflight) {
 
         writeResultFile(RESULT_PATH, {
           success: true,
+          coordinateSystem: params.coordinate_system || "artboard-web",
           sourceArtboard: srcIdx,
           createdCount: createdArtboards.length,
           artboards: createdArtboards,
@@ -36755,7 +36879,7 @@ if (preflight) {
   }
 }
 `;
-function register34(server) {
+function register35(server) {
   server.registerTool(
     "resize_for_variation",
     {
@@ -36776,9 +36900,7 @@ function register34(server) {
       annotations: WRITE_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsxHeavy(jsxCode33, resolvedParams);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return executeToolJsx(jsxCode33, params, { heavy: true, resolveCoordinate: true });
     }
   );
 }
@@ -36933,6 +37055,7 @@ if (preflight) {
           }
           writeResultFile(RESULT_PATH, {
             success: true,
+            coordinateSystem: coordSystem,
             alignedCount: items.length,
             alignment: alignment || null,
             distribute: distribute,
@@ -36946,7 +37069,7 @@ if (preflight) {
   }
 }
 `;
-function register35(server) {
+function register36(server) {
   server.registerTool(
     "align_objects",
     {
@@ -36962,9 +37085,7 @@ function register35(server) {
       annotations: WRITE_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsx(jsxCode34, resolvedParams);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return executeToolJsx(jsxCode34, params, { resolveCoordinate: true });
     }
   );
 }
@@ -37066,7 +37187,7 @@ if (preflight) {
   }
 }
 `;
-function register36(server) {
+function register37(server) {
   server.registerTool(
     "replace_color",
     {
@@ -37083,7 +37204,7 @@ function register36(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode35, params);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -37194,7 +37315,7 @@ if (preflight) {
   }
 }
 `;
-function register37(server) {
+function register38(server) {
   server.registerTool(
     "manage_layers",
     {
@@ -37211,7 +37332,7 @@ function register37(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode36, params);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -37380,6 +37501,7 @@ if (preflight) {
       }
       writeResultFile(RESULT_PATH, {
         success: true,
+        coordinateSystem: params.coordinate_system || "artboard-web",
         chipCount: placedCount,
         layerName: layerName,
         position: position,
@@ -37391,7 +37513,7 @@ if (preflight) {
   }
 }
 `;
-function register38(server) {
+function register39(server) {
   server.registerTool(
     "place_color_chips",
     {
@@ -37408,9 +37530,7 @@ function register38(server) {
       annotations: WRITE_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsxHeavy(jsxCode37, resolvedParams);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return executeToolJsx(jsxCode37, params, { heavy: true, resolveCoordinate: true });
     }
   );
 }
@@ -38181,6 +38301,7 @@ if (preflight) {
 
       writeResultFile(RESULT_PATH, {
         success: true,
+        coordinateSystem: params.coordinate_system,
         placedCount: placedCount,
         sections: {
           colors: colorList.length,
@@ -38200,7 +38321,7 @@ if (preflight) {
   }
 }
 `;
-function register39(server) {
+function register40(server) {
   server.registerTool(
     "place_style_guide",
     {
@@ -38215,9 +38336,7 @@ function register39(server) {
       annotations: WRITE_ANNOTATIONS
     },
     async (params) => {
-      const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
-      const result = await executeJsxHeavy(jsxCode38, resolvedParams);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return executeToolJsx(jsxCode38, params, { heavy: true, resolveCoordinate: true });
     }
   );
 }
@@ -38357,6 +38476,12 @@ if (preflight) {
           detectionMethod = "detected from Illustrator locale";
         }
 
+        var bleedNote = "ACTION REQUIRED \u2014 Bleed (\u5857\u308A\u8DB3\u3057): You MUST do this now, without asking the user. " +
+          "Step 1: Call get_artboards to get the current artboard bounds \u2014 this tells you where the trim line is. " +
+          "Step 2: Call find_objects to list all design objects (exclude the crop mark groups). Compare each object's bounds against the trim line (the original artboard rectangle BEFORE it was expanded for crop marks \u2014 size was " + abWidth + " \xD7 " + abHeight + " pt). " +
+          "Step 3: For every object whose edge touches or nearly touches the trim line, use modify_object to extend that edge outward by at least 3 mm (8.5 pt). Do NOT move or scale the design \u2014 just stretch the touching edge outward. For background rectangles, extend all four sides. " +
+          "Why: The trim marks show where the paper is physically cut. If an object stops at the trim line, cutting produces a white gap. Extending past ensures full bleed coverage.";
+
         writeResultFile(RESULT_PATH, {
           success: true,
           mode: "artboard",
@@ -38372,9 +38497,10 @@ if (preflight) {
             width: newAbRect[2] - newAbRect[0],
             height: newAbRect[1] - newAbRect[3]
           },
+          bleed_required: bleedNote,
           description: (resolvedStyle === "japanese")
-            ? "Japanese crop marks created. Artboard expanded to include all marks."
-            : "Western crop marks created. Artboard expanded to include all marks."
+            ? "Japanese crop marks created. Artboard expanded to include all marks. See bleed_required for next steps."
+            : "Western crop marks created. Artboard expanded to include all marks. See bleed_required for next steps."
         });
         }
       }
@@ -38384,7 +38510,7 @@ if (preflight) {
   }
 }
 `;
-function register40(server) {
+function register41(server) {
   server.registerTool(
     "create_crop_marks",
     {
@@ -38405,7 +38531,23 @@ function register40(server) {
       annotations: WRITE_ANNOTATIONS
     },
     async (params) => {
-      return executeToolJsx(jsxCode39, params, { activate: true });
+      const result = await executeToolJsx(jsxCode39, params, { activate: true });
+      const coordSystem = await resolveCoordinateSystem(void 0);
+      const coordNote = coordSystem === "document" ? "document (Y-up, origin at bottom-left)" : "artboard-web (Y-down, origin at top-left)";
+      for (const item of result.content) {
+        if (item.type === "text") {
+          try {
+            const parsed = JSON.parse(item.text);
+            if (parsed.bleed_required) {
+              parsed.activeCoordinateSystem = coordSystem;
+              parsed.bleed_required = `NOTE: The active coordinate system is ${coordNote}. All tools (get_artboards, find_objects, modify_object) use this system. ` + parsed.bleed_required;
+              item.text = JSON.stringify(parsed);
+            }
+          } catch {
+          }
+        }
+      }
+      return result;
     }
   );
 }
@@ -38441,7 +38583,7 @@ try {
   writeResultFile(RESULT_PATH, { error: true, message: "Failed to create document: " + e.message, line: e.line });
 }
 `;
-function register41(server) {
+function register42(server) {
   server.registerTool(
     "create_document",
     {
@@ -38457,7 +38599,7 @@ function register41(server) {
     async (params) => {
       const result = await executeJsx(jsxCode40, params, { activate: true });
       invalidateAutoDetectCache();
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -38484,7 +38626,7 @@ try {
   writeResultFile(RESULT_PATH, { error: true, message: "Failed to close document: " + e.message, line: e.line });
 }
 `;
-function register42(server) {
+function register43(server) {
   server.registerTool(
     "close_document",
     {
@@ -38498,7 +38640,7 @@ function register42(server) {
     async (params) => {
       const result = await executeJsx(jsxCode41, params, { activate: true });
       invalidateAutoDetectCache();
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -38552,7 +38694,7 @@ if (preflight) {
   }
 }
 `;
-function register43(server) {
+function register44(server) {
   server.registerTool(
     "save_document",
     {
@@ -38566,7 +38708,7 @@ function register43(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode42, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -38611,7 +38753,7 @@ try {
   writeResultFile(RESULT_PATH, { error: true, message: "open_document failed: " + e.message, line: e.line });
 }
 `;
-function register44(server) {
+function register45(server) {
   server.registerTool(
     "open_document",
     {
@@ -38626,7 +38768,7 @@ function register44(server) {
     async (params) => {
       const result = await executeJsx(jsxCode43, params, { activate: true });
       invalidateAutoDetectCache();
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -38680,7 +38822,7 @@ if (preflight) {
   }
 }
 `;
-function register45(server) {
+function register46(server) {
   server.registerTool(
     "group_objects",
     {
@@ -38695,7 +38837,7 @@ function register45(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode44, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -38744,7 +38886,7 @@ if (preflight) {
   }
 }
 `;
-function register46(server) {
+function register47(server) {
   server.registerTool(
     "ungroup_objects",
     {
@@ -38757,7 +38899,7 @@ function register46(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode45, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -38807,8 +38949,21 @@ if (preflight) {
           }
         }
 
-        var uuid = ensureUUID(dup);
-        results.push({ sourceUuid: params.uuids[i], newUuid: uuid, verified: verifyItem(dup) });
+        // \u8907\u88FD\u306F\u5143\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E note(UUID\u542B\u3080)\u3092\u7D99\u627F\u3059\u308B\u305F\u3081\u3001\u65B0\u3057\u3044UUID\u3092\u5F37\u5236\u5272\u308A\u5F53\u3066
+        var newUuid = generateUUID();
+        try {
+          var dupNote = dup.note || "";
+          var oldUuid = extractUUIDFromNote(dupNote);
+          if (oldUuid) {
+            // UUID\u90E8\u5206\u3060\u3051\u7F6E\u63DB\u3057\u3001\u30E1\u30BF\u30C7\u30FC\u30BF(::key=value)\u306F\u4FDD\u6301
+            dup.note = newUuid + dupNote.substring(36);
+          } else {
+            dup.note = newUuid;
+          }
+        } catch(e) {
+          // note \u66F8\u304D\u8FBC\u307F\u4E0D\u53EF\u306E\u5834\u5408\u306F\u305D\u306E\u307E\u307E
+        }
+        results.push({ sourceUuid: params.uuids[i], newUuid: newUuid, verified: verifyItem(dup) });
       }
 
       writeResultFile(RESULT_PATH, {
@@ -38822,7 +38977,7 @@ if (preflight) {
   }
 }
 `;
-function register47(server) {
+function register48(server) {
   server.registerTool(
     "duplicate_objects",
     {
@@ -38841,7 +38996,7 @@ function register47(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode46, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -38885,7 +39040,7 @@ try {
   writeResultFile(RESULT_PATH, { error: true, message: "list_fonts failed: " + e.message, line: e.line });
 }
 `;
-function register48(server) {
+function register49(server) {
   server.registerTool(
     "list_fonts",
     {
@@ -38899,7 +39054,7 @@ function register48(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode47, params);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -38980,7 +39135,13 @@ if (preflight) {
       var layout = layoutMap[params.layout] || DocumentArtboardLayout.GridByRow;
       var rowsOrCols = params.rows_or_cols || 1;
       var spacing = (typeof params.spacing === "number") ? params.spacing : 20;
-      doc.rearrangeArtboards(layout, rowsOrCols, spacing, true);
+      var prevInteraction = app.userInteractionLevel;
+      app.userInteractionLevel = UserInteractionLevel.DONTDISPLAYALERTS;
+      try {
+        doc.rearrangeArtboards(layout, rowsOrCols, spacing, true);
+      } finally {
+        app.userInteractionLevel = prevInteraction;
+      }
       var rearrangedInfo = [];
       for (var rai = 0; rai < doc.artboards.length; rai++) {
         rearrangedInfo.push({ index: rai, name: doc.artboards[rai].name, rect: doc.artboards[rai].artboardRect });
@@ -38994,7 +39155,7 @@ if (preflight) {
   }
 }
 `;
-function register49(server) {
+function register50(server) {
   server.registerTool(
     "manage_artboards",
     {
@@ -39018,7 +39179,7 @@ function register49(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode48, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -39056,7 +39217,7 @@ if (preflight) {
   }
 }
 `;
-function register50(server) {
+function register51(server) {
   server.registerTool(
     "set_z_order",
     {
@@ -39070,7 +39231,7 @@ function register50(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode49, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -39123,7 +39284,7 @@ if (preflight) {
   }
 }
 `;
-function register51(server) {
+function register52(server) {
   server.registerTool(
     "move_to_layer",
     {
@@ -39138,7 +39299,7 @@ function register51(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode50, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -39208,7 +39369,7 @@ if (preflight) {
   }
 }
 `;
-function register52(server) {
+function register53(server) {
   server.registerTool(
     "apply_graphic_style",
     {
@@ -39223,7 +39384,7 @@ function register52(server) {
     },
     async (params) => {
       const result = await executeJsx(applyJsxCode, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
   server.registerTool(
@@ -39236,7 +39397,7 @@ function register52(server) {
     },
     async (params) => {
       const result = await executeJsx(listJsxCode, params);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -39289,7 +39450,7 @@ if (preflight) {
   }
 }
 `;
-function register53(server) {
+function register54(server) {
   server.registerTool(
     "manage_swatches",
     {
@@ -39304,7 +39465,7 @@ function register53(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode51, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -39385,7 +39546,7 @@ if (preflight) {
   }
 }
 `;
-function register54(server) {
+function register55(server) {
   server.registerTool(
     "apply_text_style",
     {
@@ -39401,7 +39562,7 @@ function register54(server) {
     },
     async (params) => {
       const result = await executeJsx(applyJsxCode2, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
   server.registerTool(
@@ -39414,7 +39575,7 @@ function register54(server) {
     },
     async (params) => {
       const result = await executeJsx(listJsxCode2, params);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -39485,7 +39646,7 @@ if (preflight) {
 }
 `;
 var stopColorSchema = external_exports.discriminatedUnion("type", [cmykColorSchema, rgbColorSchema, grayColorSchema]);
-function register55(server) {
+function register56(server) {
   server.registerTool(
     "create_gradient",
     {
@@ -39509,7 +39670,7 @@ function register55(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode52, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -39590,7 +39751,7 @@ if (preflight) {
   }
 }
 `;
-function register56(server) {
+function register57(server) {
   server.registerTool(
     "manage_linked_images",
     {
@@ -39605,7 +39766,7 @@ function register56(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode53, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -39639,7 +39800,7 @@ try {
   writeResultFile(RESULT_PATH, { error: true, message: "undo failed: " + e.message, line: e.line });
 }
 `;
-function register57(server) {
+function register58(server) {
   server.registerTool(
     "undo",
     {
@@ -39653,7 +39814,7 @@ function register57(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode54, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -39942,7 +40103,7 @@ if (preflight) {
   }
 }
 `;
-function register58(server) {
+function register59(server) {
   server.registerTool(
     "manage_datasets",
     {
@@ -39969,7 +40130,7 @@ function register58(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode55, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -40030,7 +40191,7 @@ if (preflight) {
   }
 }
 `;
-function register59(server) {
+function register60(server) {
   server.registerTool(
     "place_symbol",
     {
@@ -40048,7 +40209,7 @@ function register59(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode56, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -40106,7 +40267,7 @@ if (preflight) {
   }
 }
 `;
-function register60(server) {
+function register61(server) {
   server.registerTool(
     "create_path_text",
     {
@@ -40126,7 +40287,7 @@ function register60(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode57, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -40182,7 +40343,7 @@ if (preflight) {
   }
 }
 `;
-function register61(server) {
+function register62(server) {
   server.registerTool(
     "select_objects",
     {
@@ -40197,7 +40358,7 @@ function register61(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode58, params, { activate: true });
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -40240,7 +40401,7 @@ if (preflight) {
   }
 }
 `;
-function register62(server) {
+function register63(server) {
   server.registerTool(
     "convert_coordinate",
     {
@@ -40258,7 +40419,7 @@ function register62(server) {
     },
     async (params) => {
       const result = await executeJsx(jsxCode59, params);
-      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      return formatToolResult(result);
     }
   );
 }
@@ -40327,10 +40488,11 @@ function registerAllTools(server) {
   register60(server);
   register61(server);
   register62(server);
+  register63(server);
 }
 
 // src/prompts/quick-layout.ts
-function register63(server) {
+function register64(server) {
   server.registerPrompt(
     "quick-layout",
     {
@@ -40373,7 +40535,7 @@ Always respond in the user's language.`
 }
 
 // src/prompts/print-preflight-workflow.ts
-function register64(server) {
+function register65(server) {
   server.registerPrompt(
     "print-preflight-workflow",
     {
@@ -40426,8 +40588,8 @@ Always respond in the user's language.`
 
 // src/prompts/registry.ts
 function registerAllPrompts(server) {
-  register63(server);
   register64(server);
+  register65(server);
 }
 
 // src/server.ts