illustrator-mcp-server 1.2.3 → 1.2.5

package/dist/tools/modify/manage-artboards.js

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+import { DESTRUCTIVE_ANNOTATIONS } from './shared.js';
+/**
+ * manage_artboards — アートボードの追加・削除・リサイズ・リネーム・整列
+ *
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/Artboards/ — Artboards collection
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/Document/ — Document.rearrangeArtboards(), fitArtboardToSelectedArt()
+ *
+ * JSX API:
+ *   Artboards.add(artboardRect: Rect) → Artboard
+ *   Artboards.remove(index: Number) → void  ※最後の1つは削除不可
+ *   Artboard.artboardRect → Rect [left, top, right, bottom] (writable)
+ *   Artboard.name → String (writable)
+ *   Document.fitArtboardToSelectedArt([index]) → Boolean  ※要選択
+ *   Document.rearrangeArtboards(layout, rowsOrCols, spacing, moveArtwork) → Boolean
+ *
+ * rect パラメータはドキュメント座標系 (Y-up)。artboardRect への変換:
+ *   [r.x, r.y + r.height, r.x + r.width, r.y]
+ */
+const jsxCode = `
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+    var action = params.action;
+
+    if (action === "add") {
+      if (!params.rect) {
+        writeResultFile(RESULT_PATH, { error: true, message: "rect is required for add action" });
+      } else {
+        var r = params.rect;
+        // artboardRect = [left, top, right, bottom] (document coordinates, Y-up)
+        var abRect = [r.x, r.y + r.height, r.x + r.width, r.y];
+        var ab = doc.artboards.add(abRect);
+        if (params.name) ab.name = params.name;
+        writeResultFile(RESULT_PATH, {
+          success: true,
+          index: doc.artboards.length - 1,
+          name: ab.name
+        });
+      }
+    } else if (action === "remove") {
+      if (typeof params.index !== "number") {
+        writeResultFile(RESULT_PATH, { error: true, message: "index is required for remove action" });
+      } else if (doc.artboards.length <= 1) {
+        writeResultFile(RESULT_PATH, { error: true, message: "Cannot remove the last artboard" });
+      } else {
+        // Artboards.remove(index: Number) → void
+        doc.artboards.remove(params.index);
+        writeResultFile(RESULT_PATH, { success: true, removedIndex: params.index });
+      }
+    } else if (action === "resize") {
+      if (typeof params.index !== "number" || !params.rect) {
+        writeResultFile(RESULT_PATH, { error: true, message: "index and rect required for resize" });
+      } else {
+        var r2 = params.rect;
+        // Artboard.artboardRect = [left, top, right, bottom] (document coordinates, Y-up)
+        doc.artboards[params.index].artboardRect = [r2.x, r2.y + r2.height, r2.x + r2.width, r2.y];
+        writeResultFile(RESULT_PATH, { success: true, index: params.index });
+      }
+    } else if (action === "rename") {
+      if (typeof params.index !== "number" || !params.name) {
+        writeResultFile(RESULT_PATH, { error: true, message: "index and name required for rename" });
+      } else {
+        doc.artboards[params.index].name = params.name;
+        writeResultFile(RESULT_PATH, { success: true, index: params.index, name: params.name });
+      }
+    } else if (action === "fit_to_art") {
+      if (!doc.selection || doc.selection.length === 0) {
+        writeResultFile(RESULT_PATH, { error: true, message: "fit_to_art requires objects to be selected first" });
+      } else {
+        var fitIdx = (typeof params.index === "number") ? params.index : 0;
+        doc.fitArtboardToSelectedArt(fitIdx);
+        writeResultFile(RESULT_PATH, { success: true, index: fitIdx });
+      }
+    } else if (action === "rearrange") {
+      var layoutMap = {
+        "grid_by_row": DocumentArtboardLayout.GridByRow,
+        "grid_by_col": DocumentArtboardLayout.GridByCol,
+        "row": DocumentArtboardLayout.Row,
+        "column": DocumentArtboardLayout.Column
+      };
+      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);
+      writeResultFile(RESULT_PATH, { success: true });
+    } else {
+      writeResultFile(RESULT_PATH, { error: true, message: "Unknown action: " + action });
+    }
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "manage_artboards failed: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('manage_artboards', {
+        title: 'Manage Artboards',
+        description: 'Add, remove, resize, rename, fit, or rearrange artboards. Note: Illustrator will be activated (brought to foreground) during execution.',
+        inputSchema: {
+            action: z
+                .enum(['add', 'remove', 'resize', 'rename', 'fit_to_art', 'rearrange'])
+                .describe('Action to perform'),
+            index: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('Target artboard index (0-based). Required for remove/resize/rename/fit_to_art. Note: the last remaining artboard cannot be removed.'),
+            rect: z
+                .object({
+                x: z.number(),
+                y: z.number(),
+                width: z.number(),
+                height: z.number(),
+            })
+                .optional()
+                .describe('Position and size for add/resize (document coordinates)'),
+            name: z.string().optional().describe('New name for rename action'),
+            layout: z
+                .enum(['grid_by_row', 'grid_by_col', 'row', 'column'])
+                .optional()
+                .describe('Artboard layout for rearrange'),
+            rows_or_cols: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe('Number of rows or columns for rearrange'),
+            spacing: z.number().optional().default(20).describe('Spacing in points for rearrange'),
+        },
+        annotations: DESTRUCTIVE_ANNOTATIONS,
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params, { activate: true });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=manage-artboards.js.map

package/dist/tools/modify/manage-artboards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-artboards.js","sourceRoot":"","sources":["../../../src/tools/modify/manage-artboards.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Ef,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,yIAAyI;QAC3I,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;iBACtE,QAAQ,CAAC,mBAAmB,CAAC;YAChC,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,qIAAqI,CAAC;YAClJ,IAAI,EAAE,CAAC;iBACJ,MAAM,CAAC;gBACN,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;gBACb,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;gBACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;aACnB,CAAC;iBACD,QAAQ,EAAE;iBACV,QAAQ,CAAC,yDAAyD,CAAC;YACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAClE,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;iBACrD,QAAQ,EAAE;iBACV,QAAQ,CAAC,+BAA+B,CAAC;YAC5C,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,yCAAyC,CAAC;YACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SACvF;QACD,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/modify/manage-datasets.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=manage-datasets.d.ts.map

package/dist/tools/modify/manage-datasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-datasets.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/manage-datasets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkGpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkChD"}

package/dist/tools/modify/manage-datasets.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+import { WRITE_ANNOTATIONS } from './shared.js';
+/**
+ * manage_datasets — 変数・データセットの一覧・適用・作成・インポート/エクスポート
+ *
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/Dataset/ — Dataset, Variable, Document.importVariables()
+ *
+ * JSX API:
+ *   Document.variables → Variables コレクション
+ *   Variable.kind → VariableKind (TEXTUAL | VISIBILITY | IMAGE | GRAPH)
+ *   Document.dataSets → Datasets コレクション
+ *   Dataset.display() → void  (データセットを表示)
+ *   Datasets.add() → Dataset
+ *   Document.importVariables(fileSpec: File) → void
+ *   Document.exportVariables(fileSpec: File) → void
+ */
+const jsxCode = `
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+    var action = params.action;
+
+    if (action === "list_variables") {
+      var vars = [];
+      for (var i = 0; i < doc.variables.length; i++) {
+        var v = doc.variables[i];
+        var kindStr = "unknown";
+        if (v.kind === VariableKind.TEXTUAL) kindStr = "textual";
+        else if (v.kind === VariableKind.VISIBILITY) kindStr = "visibility";
+        else if (v.kind === VariableKind.IMAGE) kindStr = "image";
+        else if (v.kind === VariableKind.GRAPH) kindStr = "graph";
+        vars.push({ name: v.name, kind: kindStr });
+      }
+      writeResultFile(RESULT_PATH, { count: vars.length, variables: vars });
+    } else if (action === "list_datasets") {
+      var ds = [];
+      for (var j = 0; j < doc.dataSets.length; j++) {
+        ds.push({ index: j, name: doc.dataSets[j].name });
+      }
+      writeResultFile(RESULT_PATH, { count: ds.length, datasets: ds });
+    } else if (action === "apply_dataset") {
+      if (!params.dataset_name) {
+        writeResultFile(RESULT_PATH, { error: true, message: "dataset_name is required" });
+      } else {
+        var found = false;
+        for (var k = 0; k < doc.dataSets.length; k++) {
+          if (doc.dataSets[k].name === params.dataset_name) {
+            doc.dataSets[k].display();
+            found = true;
+            break;
+          }
+        }
+        if (found) {
+          writeResultFile(RESULT_PATH, { success: true, dataset: params.dataset_name });
+        } else {
+          writeResultFile(RESULT_PATH, { error: true, message: "Dataset not found: " + params.dataset_name });
+        }
+      }
+    } else if (action === "create_dataset") {
+      var newDs = doc.dataSets.add();
+      if (params.dataset_name) newDs.name = params.dataset_name;
+      writeResultFile(RESULT_PATH, { success: true, name: newDs.name, index: doc.dataSets.length - 1 });
+    } else if (action === "import") {
+      if (!params.file_path) {
+        writeResultFile(RESULT_PATH, { error: true, message: "file_path is required for import" });
+      } else {
+        var impFile = new File(params.file_path);
+        if (!impFile.exists) {
+          writeResultFile(RESULT_PATH, { error: true, message: "File not found: " + params.file_path });
+        } else {
+          doc.importVariables(impFile);
+          writeResultFile(RESULT_PATH, { success: true, action: "import", path: params.file_path });
+        }
+      }
+    } else if (action === "export") {
+      if (!params.file_path) {
+        writeResultFile(RESULT_PATH, { error: true, message: "file_path is required for export" });
+      } else {
+        var expFile = new File(params.file_path);
+        doc.exportVariables(expFile);
+        writeResultFile(RESULT_PATH, { success: true, action: "export", path: params.file_path });
+      }
+    } else {
+      writeResultFile(RESULT_PATH, { error: true, message: "Unknown action: " + action });
+    }
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "manage_datasets failed: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('manage_datasets', {
+        title: 'Manage Variables & Datasets',
+        description: 'List variables/datasets, apply or create datasets, import/export variables XML. Note: Illustrator will be activated (brought to foreground) during execution.',
+        inputSchema: {
+            action: z
+                .enum([
+                'list_variables',
+                'list_datasets',
+                'apply_dataset',
+                'create_dataset',
+                'import',
+                'export',
+            ])
+                .describe('Action to perform'),
+            dataset_name: z
+                .string()
+                .optional()
+                .describe('Dataset name (for apply_dataset, create_dataset)'),
+            file_path: z
+                .string()
+                .optional()
+                .describe('XML file path (for import/export)'),
+        },
+        annotations: WRITE_ANNOTATIONS,
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params, { activate: true });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=manage-datasets.js.map

package/dist/tools/modify/manage-datasets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-datasets.js","sourceRoot":"","sources":["../../../src/tools/modify/manage-datasets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Ef,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,+JAA+J;QACjK,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC;gBACJ,gBAAgB;gBAChB,eAAe;gBACf,eAAe;gBACf,gBAAgB;gBAChB,QAAQ;gBACR,QAAQ;aACT,CAAC;iBACD,QAAQ,CAAC,mBAAmB,CAAC;YAChC,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,kDAAkD,CAAC;YAC/D,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mCAAmC,CAAC;SACjD;QACD,WAAW,EAAE,iBAAiB;KAC/B,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/modify/manage-layers.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=manage-layers.d.ts.map

package/dist/tools/modify/manage-layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-layers.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/manage-layers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8GpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoChD"}

package/dist/tools/modify/manage-layers.js

@@ -0,0 +1,141 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+import { DESTRUCTIVE_ANNOTATIONS } from './shared.js';
+/**
+ * manage_layers — レイヤーの追加・削除・リネーム・表示/ロック操作
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/Layers/ — Layers.add(), getByName()
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/Layer/ — name, visible, locked, remove(), move()
+ */
+const jsxCode = `
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+    var action = params.action;
+    var layerName = params.layer_name || null;
+    var newName = params.new_name || null;
+    var position = (typeof params.position === "number") ? params.position : null;
+    var above = params.above || null;
+
+    function getLayerInfo(layer) {
+      return {
+        name: layer.name,
+        visible: layer.visible,
+        locked: layer.locked,
+        itemCount: layer.pageItems.length
+      };
+    }
+
+    if (action === "add") {
+      var newLayer;
+      if (above) {
+        try {
+          var refLayer = doc.layers.getByName(above);
+          newLayer = doc.layers.add();
+          newLayer.move(refLayer, ElementPlacement.PLACEBEFORE);
+        } catch(e) {
+          newLayer = doc.layers.add();
+        }
+      } else {
+        newLayer = doc.layers.add();
+      }
+      if (layerName) newLayer.name = layerName;
+      writeResultFile(RESULT_PATH, { success: true, action: "add", layer: getLayerInfo(newLayer) });
+
+    } else if (action === "rename") {
+      if (!layerName || !newName) {
+        writeResultFile(RESULT_PATH, { error: true, message: "layer_name and new_name are required for rename" });
+      } else {
+        var layer = doc.layers.getByName(layerName);
+        layer.name = newName;
+        writeResultFile(RESULT_PATH, { success: true, action: "rename", from: layerName, to: newName });
+      }
+
+    } else if (action === "show" || action === "hide") {
+      if (!layerName) {
+        writeResultFile(RESULT_PATH, { error: true, message: "layer_name is required" });
+      } else {
+        var layer2 = doc.layers.getByName(layerName);
+        layer2.visible = (action === "show");
+        writeResultFile(RESULT_PATH, { success: true, action: action, layer: getLayerInfo(layer2) });
+      }
+
+    } else if (action === "lock" || action === "unlock") {
+      if (!layerName) {
+        writeResultFile(RESULT_PATH, { error: true, message: "layer_name is required" });
+      } else {
+        var layer3 = doc.layers.getByName(layerName);
+        layer3.locked = (action === "lock");
+        writeResultFile(RESULT_PATH, { success: true, action: action, layer: getLayerInfo(layer3) });
+      }
+
+    } else if (action === "reorder") {
+      if (!layerName || position === null) {
+        writeResultFile(RESULT_PATH, { error: true, message: "layer_name and position are required for reorder" });
+      } else {
+        var layer4 = doc.layers.getByName(layerName);
+        if (position <= 0) {
+          layer4.move(doc.layers[0], ElementPlacement.PLACEBEFORE);
+        } else if (position >= doc.layers.length - 1) {
+          layer4.move(doc.layers[doc.layers.length - 1], ElementPlacement.PLACEAFTER);
+        } else {
+          layer4.move(doc.layers[position], ElementPlacement.PLACEBEFORE);
+        }
+        writeResultFile(RESULT_PATH, { success: true, action: "reorder", layer: layerName, position: position });
+      }
+
+    } else if (action === "delete") {
+      if (!layerName) {
+        writeResultFile(RESULT_PATH, { error: true, message: "layer_name is required for delete" });
+      } else {
+        var layer5 = doc.layers.getByName(layerName);
+        var info = getLayerInfo(layer5);
+        layer5.remove();
+        writeResultFile(RESULT_PATH, { success: true, action: "delete", deletedLayer: info });
+      }
+
+    } else {
+      writeResultFile(RESULT_PATH, { error: true, message: "Unknown action: " + action });
+    }
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "Layer operation failed: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('manage_layers', {
+        title: 'Manage Layers',
+        description: 'Add, rename, show/hide, lock/unlock, reorder, or delete layers',
+        inputSchema: {
+            action: z
+                .enum(['add', 'rename', 'show', 'hide', 'lock', 'unlock', 'reorder', 'delete'])
+                .describe('Layer operation to perform'),
+            layer_name: z
+                .string()
+                .optional()
+                .describe('Target layer name (for add: new layer name)'),
+            new_name: z
+                .string()
+                .optional()
+                .describe('New name (required for rename action)'),
+            position: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('Target position for reorder (0 = topmost)'),
+            above: z
+                .string()
+                .optional()
+                .describe('For add: create above this layer name'),
+        },
+        annotations: DESTRUCTIVE_ANNOTATIONS,
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=manage-layers.js.map

package/dist/tools/modify/manage-layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-layers.js","sourceRoot":"","sources":["../../../src/tools/modify/manage-layers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;GAIG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkGf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,gEAAgE;QAC7E,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;iBAC9E,QAAQ,CAAC,4BAA4B,CAAC;YACzC,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6CAA6C,CAAC;YAC1D,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,uCAAuC,CAAC;YACpD,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,2CAA2C,CAAC;YACxD,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,uCAAuC,CAAC;SACrD;QACD,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/modify/manage-linked-images.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=manage-linked-images.d.ts.map

package/dist/tools/modify/manage-linked-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-linked-images.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/manage-linked-images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmFpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBhD"}

package/dist/tools/modify/manage-linked-images.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+import { DESTRUCTIVE_ANNOTATIONS } from './shared.js';
+/**
+ * manage_linked_images — リンク画像の差し替え・埋め込み
+ *
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/PlacedItem/ — PlacedItem.relink(), PlacedItem.embed()
+ *
+ * JSX API:
+ *   PlacedItem.relink(linkFile: File) → void
+ *   PlacedItem.embed() → void  (PlacedItem → RasterItem に変換)
+ *
+ * embed() 後は PlacedItem が無効化されるため、name タグで RasterItem を追跡する。
+ */
+const jsxCode = `
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+
+    var item = findItemByUUID(params.uuid);
+    if (!item) {
+      writeResultFile(RESULT_PATH, { error: true, message: "Object not found: " + params.uuid });
+    } else if (item.typename !== "PlacedItem") {
+      writeResultFile(RESULT_PATH, { error: true, message: "Object is not a linked image (type: " + item.typename + ")" });
+    } else {
+      if (params.action === "relink") {
+        if (!params.new_path) {
+          writeResultFile(RESULT_PATH, { error: true, message: "new_path is required for relink" });
+        } else {
+          var newFile = new File(params.new_path);
+          if (!newFile.exists) {
+            writeResultFile(RESULT_PATH, { error: true, message: "File not found: " + params.new_path });
+          } else {
+            item.relink(newFile);
+            writeResultFile(RESULT_PATH, {
+              success: true,
+              action: "relink",
+              uuid: params.uuid,
+              newPath: params.new_path
+            });
+          }
+        }
+      } else if (params.action === "embed") {
+        var tag = "__embed_" + (new Date()).getTime();
+        item.name = tag;
+        item.embed();
+        var resultUuid = null;
+        for (var ri = 0; ri < doc.rasterItems.length; ri++) {
+          if (doc.rasterItems[ri].name === tag) {
+            doc.rasterItems[ri].name = "";
+            resultUuid = ensureUUID(doc.rasterItems[ri]);
+            break;
+          }
+        }
+        if (resultUuid) {
+          writeResultFile(RESULT_PATH, {
+            success: true,
+            action: "embed",
+            previousUuid: params.uuid,
+            newUuid: resultUuid
+          });
+        } else {
+          writeResultFile(RESULT_PATH, {
+            error: true,
+            message: "embed() succeeded but resulting RasterItem could not be found"
+          });
+        }
+      } else {
+        writeResultFile(RESULT_PATH, { error: true, message: "Unknown action: " + params.action });
+      }
+    }
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "manage_linked_images failed: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('manage_linked_images', {
+        title: 'Manage Linked Images',
+        description: 'Relink or embed a placed (linked) image. embed converts PlacedItem to RasterItem — the original UUID becomes invalid and a new UUID for the RasterItem is returned. Note: Illustrator will be activated (brought to foreground) during execution.',
+        inputSchema: {
+            uuid: z.string().describe('UUID of the placed (linked) image'),
+            action: z.enum(['relink', 'embed']).describe('Action to perform'),
+            new_path: z.string().optional().describe('New file path (required for relink)'),
+        },
+        annotations: DESTRUCTIVE_ANNOTATIONS,
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params, { activate: true });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=manage-linked-images.js.map

package/dist/tools/modify/manage-linked-images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-linked-images.js","sourceRoot":"","sources":["../../../src/tools/modify/manage-linked-images.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiEf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,mPAAmP;QACrP,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YAC9D,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACjE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;SAChF;QACD,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/modify/manage-swatches.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=manage-swatches.d.ts.map

package/dist/tools/modify/manage-swatches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-swatches.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/manage-swatches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiEpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBhD"}

package/dist/tools/modify/manage-swatches.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+import { DESTRUCTIVE_ANNOTATIONS, COLOR_HELPERS_JSX, colorSchema } from './shared.js';
+/**
+ * manage_swatches — スウォッチの追加・更新・削除
+ *
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/Swatches/ — Swatches, Swatch
+ *
+ * JSX API:
+ *   Swatches.add() → Swatch
+ *   Swatch.name → String (writable)
+ *   Swatch.color → Color (writable)
+ *   Swatch.remove() → void
+ *   Swatches.getByName(name: String) → Swatch
+ */
+const jsxCode = `
+${COLOR_HELPERS_JSX}
+
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+    var action = params.action;
+
+    if (action === "add") {
+      if (!params.color) {
+        writeResultFile(RESULT_PATH, { error: true, message: "color is required for add action" });
+      } else {
+        var swatch = doc.swatches.add();
+        swatch.name = params.name;
+        swatch.color = createColor(params.color);
+        writeResultFile(RESULT_PATH, { success: true, action: "add", name: params.name });
+      }
+    } else if (action === "update") {
+      try {
+        var existing = doc.swatches.getByName(params.name);
+        if (params.color) {
+          existing.color = createColor(params.color);
+        }
+        writeResultFile(RESULT_PATH, { success: true, action: "update", name: params.name });
+      } catch(e) {
+        writeResultFile(RESULT_PATH, { error: true, message: "Swatch not found: " + params.name });
+      }
+    } else if (action === "delete") {
+      try {
+        var toDelete = doc.swatches.getByName(params.name);
+        toDelete.remove();
+        writeResultFile(RESULT_PATH, { success: true, action: "delete", name: params.name });
+      } catch(e) {
+        writeResultFile(RESULT_PATH, { error: true, message: "Swatch not found: " + params.name });
+      }
+    } else {
+      writeResultFile(RESULT_PATH, { error: true, message: "Unknown action: " + action });
+    }
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "manage_swatches failed: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('manage_swatches', {
+        title: 'Manage Swatches',
+        description: 'Add, update, or delete swatches in the active document. Note: Illustrator will be activated (brought to foreground) during execution.',
+        inputSchema: {
+            action: z.enum(['add', 'update', 'delete']).describe('Action to perform'),
+            name: z.string().describe('Swatch name'),
+            color: colorSchema.describe('Color for add/update (required for add)'),
+        },
+        annotations: DESTRUCTIVE_ANNOTATIONS,
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params, { activate: true });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=manage-swatches.js.map

package/dist/tools/modify/manage-swatches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-swatches.js","sourceRoot":"","sources":["../../../src/tools/modify/manage-swatches.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,GAAG;EACd,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6ClB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,uIAAuI;QACzI,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACzE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YACxC,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,yCAAyC,CAAC;SACvE;QACD,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/modify/modify-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modify-object.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/modify-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0IpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoDhD"}
+{"version":3,"file":"modify-object.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/modify-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoIpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6ChD"}