goatedit-mcp 1.1.0 → 1.1.2

package/README.md

@@ -112,6 +112,10 @@ up to 500 files); `/media/<path>` serves from it with byte ranges, so video
 seeks, and paths that resolve outside it are a 404. Generated voiceovers are
 written there too.
 
+`import_local_file` looks in that folder first: a file found there (by name,
+or by the path `list_local_assets` gives) is imported from this server, with no
+GoatEdit bridge needed. Only a miss falls through to the bridge.
+
 ---
 
 ## Tools

package/bundle/goatedit-mcp.js

@@ -3232,8 +3232,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path2) {
-      let input = path2;
+    function removeDotSegments(path3) {
+      let input = path3;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3485,8 +3485,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path2, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path2 && path2 !== "/" ? path2 : void 0;
+        const [path3, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path3 && path3 !== "/" ? path3 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -6879,12 +6879,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs2, exportName) {
+    function addFormats(ajv, list, fs3, exportName) {
       var _a3;
       var _b;
       (_a3 = (_b = ajv.opts.code).formats) !== null && _a3 !== void 0 ? _a3 : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv.addFormat(f, fs2[f]);
+        ajv.addFormat(f, fs3[f]);
     }
     module.exports = exports = formatsPlugin;
     Object.defineProperty(exports, "__esModule", { value: true });
@@ -10811,10 +10811,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path2) {
-  if (!path2)
+function getElementAtPath(obj, path3) {
+  if (!path3)
     return obj;
-  return path2.reduce((acc, key) => acc?.[key], obj);
+  return path3.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -11223,11 +11223,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path2, issues) {
+function prefixIssues(path3, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path2);
+    iss.path.unshift(path3);
     return iss;
   });
 }
@@ -11374,16 +11374,16 @@ function flattenError(error2, mapper = (issue2) => issue2.message) {
 }
 function formatError(error2, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error3, path2 = []) => {
+  const processError = (error3, path3 = []) => {
     for (const issue2 of error3.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path2, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path3, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path2, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path3, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path2, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path3, ...issue2.path]);
       } else {
-        const fullpath = [...path2, ...issue2.path];
+        const fullpath = [...path3, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -19144,8 +19144,8 @@ var import_websocket_server = __toESM(require_websocket_server(), 1);
 // src/index.ts
 import crypto from "crypto";
 import http from "http";
-import fs from "fs";
-import path from "path";
+import fs2 from "fs";
+import path2 from "path";
 import { execFileSync } from "child_process";
 import os from "os";
 import { fileURLToPath } from "url";
@@ -19155,6 +19155,14 @@ var num = (description) => ({ type: "number", description });
 var str = (description) => ({ type: "string", description });
 var bool = (description) => ({ type: "boolean", description });
 var CLIP_ID = str("ID of the clip, as returned by get_timeline.");
+var SKIP_ADJUSTMENTS = bool(
+  "Render without any adjustment layer (a global camera move, a grade). For frames you will bake into a clip that sits under that layer, which would otherwise apply it twice. The timeline is not changed."
+);
+var HIDE_CLIP_IDS = {
+  type: "array",
+  items: { type: "string" },
+  description: "Render as if these clips were not there. The timeline is not changed."
+};
 var TEXT_STYLE_PROPS = {
   fontSize: num("Font size in pixels, authored against a 1080p-tall frame."),
   fontFamily: str("Font family name."),
@@ -19171,10 +19179,24 @@ var TEXT_STYLE_PROPS = {
   textShadowColor: str("Drop shadow colour."),
   lineHeight: num("Line advance as a multiple of the line height. Defaults to 1.2."),
   letterSpacing: num("Extra tracking in pixels @1080p."),
+  textUnderline: bool("Underline the text."),
+  textShadowBlur: num("Drop shadow softness in pixels @1080p. 0 is a hard shadow."),
+  textShadowOffsetX: num("Drop shadow offset to the right, pixels @1080p."),
+  textShadowOffsetY: num("Drop shadow offset downward, pixels @1080p."),
+  textGradientStart: str("Fill the words with a gradient from this colour (top) \u2026"),
+  textGradientEnd: str("\u2026 to this one (bottom). Set both."),
+  textAccentColor: str("Colour for accent words. Mark an accent word in the text as *word*."),
+  textAccentFontFamily: str(`Font for accent words, e.g. "'Great Vibes', cursive" for a script word inside heavy caps.`),
+  textAccentScale: num("Size of accent words relative to the rest, e.g. 1.8."),
+  textAccentGradientStart: str("Gradient start colour for accent words."),
+  textAccentGradientEnd: str("Gradient end colour for accent words."),
+  textSwooshUnderline: bool("Hand-drawn swoosh under the last line."),
+  textSticker: { type: "string", enum: ["ghost", "arrow", "pen", "star", "flame"], description: "Small sticker drawn beside the accent word." },
+  textLayoutMode: { type: "string", enum: ["side-grid", "luxury-stack", "editorial-hero", "slanted-red", "double-hero"], description: "Editorial layout engine for multi-word titles." },
   posX: num("Horizontal position as a fraction of the frame, 0..1. 0.5 is centre."),
   posY: num("Vertical position as a fraction of the frame, 0..1. 0.5 is centre.")
 };
-var TOOLS = [
+var BASE_TOOLS = [
   {
     name: "get_session_status",
     description: "Check whether a GoatEdit editor tab is currently attached to this session, and which project it has open. Call this first if any other tool reports the editor is not connected.",
@@ -19237,7 +19259,9 @@ var TOOLS = [
           description: "Write the frame to disk through the local bridge and return its path instead of the image itself. A frame is around 200KB, and inline it is paid for twice \u2014 as tokens and as a cached object \u2014 so a review pass over twenty cuts is expensive. With this set, read the returned path with your own file tools. Falls back to an inline image, with a warning, when the bridge is not running."
         },
         width: num("Width of the returned image in pixels, up to 1280. Defaults to 1024."),
-        outlines: bool(`Draw every layer's box, handles and anchor point over the picture, with a timecode \u2014 the look of the editor's selection, on every layer at once. The same option the Export dialog offers as "Show layer outlines".`)
+        outlines: bool(`Draw every layer's box, handles and anchor point over the picture, with a timecode \u2014 the look of the editor's selection, on every layer at once. The same option the Export dialog offers as "Show layer outlines".`),
+        skipAdjustments: SKIP_ADJUSTMENTS,
+        hideClipIds: HIDE_CLIP_IDS
       }
     },
     method: "renderFrame"
@@ -19263,7 +19287,9 @@ var TOOLS = [
         startTime: num("Start of the range in seconds."),
         endTime: num("End of the range in seconds. Ranges over 10 minutes are refused."),
         frames: num("How many frames to sample, up to 6. Defaults to 4."),
-        width: num("Width of each frame in pixels. Defaults to 640.")
+        width: num("Width of each frame in pixels. Defaults to 640."),
+        skipAdjustments: SKIP_ADJUSTMENTS,
+        hideClipIds: HIDE_CLIP_IDS
       },
       required: ["startTime", "endTime"]
     },
@@ -19356,7 +19382,7 @@ var TOOLS = [
   },
   {
     name: "get_timeline",
-    description: 'Get just the timeline \u2014 all tracks with their clips, ids, start times and durations. Cheaper than get_project_state; use it before any edit so you have current clip ids. Animation data (keyframes, motion tracking, masks, per-word caption timings) is reported as counts under *Summary keys rather than in full, so a clip showing keyframeSummary is animated even though the keyframes themselves are not listed. By default the view is lean: a field at its usual value is left out (no volume means 1, no isMuted means false, no opacity means 1), and effects are listed by id and type only. Pass detail: "full" when you need effect parameters.',
+    description: 'Get just the timeline \u2014 all tracks with their clips, ids, start times and durations. Cheaper than get_project_state; use it before your first edit so you have current clip ids. After that, each edit\u2019s reply lists the clips it added, changed and removed under timelineChanges, so a re-read is only needed when that says it was truncated. Animation data (keyframes, motion tracking, masks, per-word caption timings) is reported as counts under *Summary keys rather than in full, so a clip showing keyframeSummary is animated even though the keyframes themselves are not listed; get_clip returns them. By default the view is lean: a field at its usual value is left out (no volume means 1, no isMuted means false, no opacity means 1), and effects are listed by id and type only. Pass detail: "full" when you need effect parameters.',
     inputSchema: {
       type: "object",
       properties: {
@@ -19368,6 +19394,40 @@ var TOOLS = [
     },
     method: "getTimeline"
   },
+  {
+    name: "get_clip",
+    description: "Get clips in full, animation included: every keyframe on every property (time in seconds from the clip\u2019s start, value, ease \u2014 the shape set_keyframes takes), effect parameters and their keyframes, mask shapes, crop, key and transform. Use it to copy or adjust a clip\u2019s animation; get_timeline only counts keyframes. Per-frame data (motion tracking, roto point sets per frame, caption word timings) stays a count, as does any property with more than 300 keyframes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipIds: { type: "array", items: { type: "string" }, description: "Clip ids from get_timeline, up to 50." }
+      },
+      required: ["clipIds"]
+    },
+    method: "getClips"
+  },
+  {
+    name: "create_checkpoint",
+    description: "Save a copy of the whole project (every sequence and the media bin) to return to with restore_checkpoint. Take one before a long scripted change: undo goes back one step at a time and a big rebuild can outrun it. Kept in the editor tab until it reloads, the newest 20 per project.",
+    inputSchema: { type: "object", properties: { name: str("Optional label.") } },
+    method: "createCheckpoint"
+  },
+  {
+    name: "list_checkpoints",
+    description: "List the checkpoints saved in this tab for the open project.",
+    inputSchema: { type: "object", properties: {} },
+    method: "listCheckpoints"
+  },
+  {
+    name: "restore_checkpoint",
+    description: "Put the whole project back as it was at a checkpoint, as one undoable step. Everything done since is undone at once, in every sequence.",
+    inputSchema: {
+      type: "object",
+      properties: { checkpointId: str("Id from create_checkpoint or list_checkpoints.") },
+      required: ["checkpointId"]
+    },
+    method: "restoreCheckpoint"
+  },
   {
     name: "get_media_bin",
     description: "List every media file imported into the project, with id, name, type and duration.",
@@ -19418,7 +19478,7 @@ var TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        trackId: str('Target track id from get_timeline, or "__new_video__" to let the editor pick a free video track.'),
+        trackId: str('Target track id from get_timeline, "__new_video__" to let the editor pick a free video track, or "__new_track__" for a new video track on top.'),
         mediaFileId: str("Media bin file id from get_media_bin."),
         startTime: num("Where the clip starts on the timeline, in seconds."),
         duration: num("Length of the clip on the timeline, in seconds."),
@@ -19525,6 +19585,152 @@ var TOOLS = [
     },
     method: "addShapeClip"
   },
+  {
+    name: "update_shape_clip",
+    description: "Change a shape after it was made \u2014 fill, size, corners, outline, and a dashed or rounded outline \u2014 without deleting it and losing its id, keyframes and effects.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: CLIP_ID,
+        color: str("Fill colour."),
+        width: num("Width in design units against a 1080p-tall frame."),
+        height: num("Height in design units against a 1080p-tall frame."),
+        cornerRadius: num("Corner radius in design units."),
+        strokeColor: str("Outline colour."),
+        strokeWidth: num("Outline width in design units."),
+        strokeCap: { type: "string", enum: ["butt", "round", "square"], description: "Ends of an open or dashed outline." },
+        strokeJoin: { type: "string", enum: ["miter", "round", "bevel"], description: "Outline corners." },
+        dash: num("Dash length for a dashed outline, design units. 0 for solid."),
+        gap: num("Gap between dashes, design units.")
+      },
+      required: ["clipId"]
+    },
+    method: "updateShapeClip"
+  },
+  {
+    name: "add_null",
+    description: "Add a Null Object: an invisible handle that other clips are parented to (set_parent). Move, scale or rotate the null and everything under it follows, orbiting its position \u2014 the After Effects way to group a polaroid with its caption, or make a whole layout drift as one.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        startTime: num("Seconds. Defaults to 0."),
+        duration: num("Seconds."),
+        x: num("Position as a fraction of the frame width. Defaults to 0.5."),
+        y: num("Position as a fraction of the frame height. Defaults to 0.5."),
+        name: str("Display name."),
+        trackId: str('Video track, or "__new_video__" (default) for a free one.')
+      },
+      required: ["duration"]
+    },
+    method: "addNull"
+  },
+  {
+    name: "set_parent",
+    description: "Parent a clip to another clip or null, After Effects style. The clip stays exactly where it is when parented; from then on it follows the parent's move, scale and rotation, orbiting the parent's position and spreading as it scales. parentId null unparents. position / scale / rotation pick-whip a single channel to a different clip (null cuts that channel loose): a channel parent passes on only its own change. Parent first, then animate the parent.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: CLIP_ID,
+        parentId: { type: ["string", "null"], description: "Parent clip id, or null to unparent." },
+        position: { type: ["string", "null"], description: "Take position only from this clip." },
+        scale: { type: ["string", "null"], description: "Take scale only from this clip." },
+        rotation: { type: ["string", "null"], description: "Take rotation only from this clip." }
+      },
+      required: ["clipId"]
+    },
+    method: "setParent"
+  },
+  {
+    name: "group_clips",
+    description: "Group clips under a new null spanning all of them, so they move, scale and rotate as one; each keeps its place. Returns the group's clipId \u2014 animate that. With layout set, the null becomes an Auto Layout frame and the clips flow inside it (tune it with set_auto_layout).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipIds: { type: "array", items: { type: "string" }, description: "Clips to group." },
+        name: str("Group name."),
+        layout: { type: "string", enum: ["none", "horizontal", "vertical", "wrap", "orbit"], description: "Defaults to none: a plain group." },
+        gap: num("Gap between laid-out clips, design units. Defaults to 16."),
+        x: num("Group pivot, fraction of the frame width. Defaults to the members' average."),
+        y: num("Group pivot, fraction of the frame height."),
+        trackId: str('Video track for the null, or "__new_video__" (default).')
+      },
+      required: ["clipIds"]
+    },
+    method: "groupClips"
+  },
+  {
+    name: "set_proximity",
+    description: "Drive one property of a clip by how close it is to another clip on screen \u2014 a card that brightens as a cursor nears it, a label that grows when a photo slides over it. Distance is measured between where both are drawn (parents and layout included), as a fraction of the frame width. At `near` or closer the property is nearValue, at `far` or beyond it is farValue, linear between.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: CLIP_ID,
+        targetClipId: str("The clip whose distance drives it."),
+        property: { type: "string", enum: ["opacity", "scaleX", "scaleY", "posX", "posY", "rotation"], description: "Defaults to opacity." },
+        near: num("Distance for nearValue. Defaults to 0.05."),
+        far: num("Distance for farValue. Defaults to 0.3."),
+        nearValue: num("Defaults to 1."),
+        farValue: num("Defaults to 0."),
+        remove: bool("Remove the driver.")
+      },
+      required: ["clipId"]
+    },
+    method: "setProximity"
+  },
+  {
+    name: "set_clip_speed",
+    description: "Retime a video or audio clip like the Speed panel: speed (0.1\u201310) keeps the source range and changes the clip length (stopping at the next clip); ramp applies a speed curve \u2014 a preset name (montage, hero, bullet, jumpCut, flashIn, flashOut) or [{x 0..1, y rate}] points; null flattens it. reversed plays it backwards; holdFrame freezes from that many seconds into the clip (null releases). Linked audio is retimed with it.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: CLIP_ID,
+        speed: num("Playback rate, 1 = normal."),
+        ramp: { type: ["string", "array", "null"], description: "Preset id, or points [{x, y}], or null." },
+        reversed: bool("Play backwards."),
+        holdFrame: { type: ["number", "null"], description: "Freeze from this clip-relative time; null removes the hold." }
+      },
+      required: ["clipId"]
+    },
+    method: "setClipSpeed"
+  },
+  {
+    name: "set_auto_layout",
+    description: "Figma-style Auto Layout. On a frame (group_clips with a layout, or any clip with children): mode, gap, padding, alignment, resizing, clip content, reverse, stack order, orbit settings. Children are spaced by the room they take at their own scale, and the frame's own scale and rotation act on the whole arrangement. On a child: absolute (leave the flow and sit at its own position inside the frame), grow (share of free space when resizing is fill), min/max size.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: CLIP_ID,
+        enabled: bool("Switch the layout on or off without losing it."),
+        mode: { type: "string", enum: ["none", "horizontal", "vertical", "wrap", "orbit"] },
+        gap: num("Gap between children, design units."),
+        gapV: num("Gap between rows in wrap mode."),
+        padding: num("All four paddings at once."),
+        paddingLeft: num("Design units."),
+        paddingRight: num("Design units."),
+        paddingTop: num("Design units."),
+        paddingBottom: num("Design units."),
+        primaryAlign: { type: "string", enum: ["start", "center", "end", "space-between", "space-around", "space-evenly"] },
+        counterAlign: { type: "string", enum: ["start", "center", "end", "stretch"] },
+        horizontalResizing: { type: "string", enum: ["fixed", "hug", "fill"] },
+        verticalResizing: { type: "string", enum: ["fixed", "hug", "fill"] },
+        clipContent: bool("Clip children to the frame."),
+        reverse: bool("Reverse the flow order."),
+        stackOrder: { type: "string", enum: ["firstOnTop", "lastOnTop"] },
+        orbitRadius: num("Orbit mode radius, design units."),
+        orbitSpeed: num("Orbit mode degrees per second."),
+        orbitStartAngle: num("Orbit mode start angle, degrees."),
+        orbitRotateChildren: bool("Turn children to face along the orbit."),
+        absolute: bool("Child only: leave the flow."),
+        grow: num("Child only: share of free space with fill resizing."),
+        minWidth: num("Design units."),
+        maxWidth: num("Design units."),
+        minHeight: num("Design units."),
+        maxHeight: num("Design units.")
+      },
+      required: ["clipId"]
+    },
+    method: "setAutoLayout"
+  },
   {
     name: "set_shape_gradient",
     description: "Give a shape or a pen path a gradient fill or a gradient stroke, replacing its flat colour. Works on anything with a shapeType, including paths drawn with the pen tool. The ramp is laid out against the shape's own bounding box, so it stays put on the object when the shape is moved, scaled or rotated rather than sliding across it. Pass null to clear one and go back to the flat colour. gradientKeyframes animates it \u2014 a sweep that turns, a glow that shifts colour.",
@@ -19695,12 +19901,69 @@ var TOOLS = [
         scaleX: num("Horizontal scale, overriding scale."),
         scaleY: num("Vertical scale, overriding scale."),
         rotation: num("Rotation in degrees."),
-        opacity: num("Opacity from 0 to 1.")
+        opacity: num("Opacity from 0 to 1."),
+        blendMode: {
+          type: "string",
+          enum: [
+            "normal",
+            "multiply",
+            "screen",
+            "overlay",
+            "darken",
+            "lighten",
+            "color-dodge",
+            "color-burn",
+            "hard-light",
+            "soft-light",
+            "difference",
+            "exclusion",
+            "hue",
+            "saturation",
+            "color",
+            "luminosity"
+          ],
+          description: "How the clip mixes with the layers beneath it. screen for light leaks, flares and dust shot on black; multiply for paper textures, ink and shadows shot on white; overlay or soft-light for texture over a picture. normal sets it back."
+        }
       },
       required: ["clipId"]
     },
     method: "setClipTransform"
   },
+  {
+    name: "set_ultra_key",
+    description: "Green screen: knock a colour out of a video or image clip so the tracks beneath show through \u2014 a paper unfold, a smoke burst or a presenter shot on green or blue. Unset values keep what the clip already has (or the defaults: green, tolerance 0.18, softness 0.1, spill 0.4). Raise tolerance when green is left behind, softness for a gentler edge, spill when edges carry a green tint. Check the result with render_preview_frame; pass remove to take the key off.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: CLIP_ID,
+        keyColor: str('Colour to remove, as "#rrggbb". Defaults to "#00ff00"; pick "#0000ff" for blue screen, or the sampled backdrop colour when the green is off-pure.'),
+        tolerance: num("How close to the key colour a pixel must be to vanish, 0..1. Defaults to 0.18."),
+        softness: num("Width of the soft edge around the key, 0..1. Defaults to 0.1."),
+        spill: num("How strongly green fringing is desaturated on edges, 0..1. Defaults to 0.4."),
+        enabled: bool("Switch the key off without losing its settings. Defaults to true."),
+        remove: bool("Remove the key entirely.")
+      },
+      required: ["clipId"]
+    },
+    method: "setUltraKey"
+  },
+  {
+    name: "set_track_matte",
+    description: "After Effects track matte: another clip\u2019s transparency (alpha) or brightness (luma) becomes this clip\u2019s transparency, optionally inverted. Use it to reveal an image through a moving shape \u2014 a torn-paper or ink-bleed clip, a wipe, text \u2014 without baking. The matte clip stops drawing once it is used as a matte unless keepSourceVisible is set. Name the matte with sourceClipId (any clip, on any track; give it the same transform as the clip it cuts); without one, the matte is whatever is live on the nearest video track above. Unset values keep what the clip already has. Pass remove to take the matte off.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: CLIP_ID,
+        type: { type: "string", enum: ["alpha", "alphaInverted", "luma", "lumaInverted"], description: "Defaults to alpha." },
+        sourceClipId: str("Clip that supplies the matte."),
+        keepSourceVisible: bool("Keep drawing the matte clip as well. Defaults to false."),
+        enabled: bool("Switch the matte off without losing it. Defaults to true."),
+        remove: bool("Remove the matte.")
+      },
+      required: ["clipId"]
+    },
+    method: "setTrackMatte"
+  },
   {
     name: "set_keyframes",
     description: "Animate one property of a clip over time. set_clip_transform sets a value; this is what makes it move \u2014 a card sliding on, a background drifting, a photo pushing in. Times are in seconds RELATIVE TO THE CLIP's start, and each keyframe may carry its own outgoing easing as a CSS cubic-bezier ([0.22, 1, 0.36, 1] is a good decelerate). Two or more keyframes make motion; one holds a value. Writing keyframes for a property overrides whatever flat value the clip carries for it, and replaces any track already on that property \u2014 pass clear to remove one.",
@@ -19780,6 +20043,70 @@ var TOOLS = [
     },
     method: "describeEffect"
   },
+  {
+    name: "list_presets",
+    description: "List animation presets. The user\u2019s own saved presets always come back in full; the built-in library (a couple of hundred title moves, lower thirds, logo reveals, backgrounds and more) is summarised by category unless you pass category or query. Apply one with apply_preset.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        category: {
+          type: "string",
+          enum: ["text", "motion", "paper", "liquid", "glitch", "logo", "lower-third", "transition", "bg"],
+          description: "List the built-in presets of one category."
+        },
+        query: str("Search built-in presets by name, description or tag.")
+      }
+    },
+    method: "listPresets"
+  },
+  {
+    name: "save_preset",
+    description: 'Save clips as a reusable preset: their transform keyframes (stored as fractions of the clip, so the move stretches to whatever it is applied to), effects, transition, and text or shape styling. It is kept in this browser and shows under My Presets in the Presets panel, across reloads. One clip makes a preset that can be laid onto another clip; several make a group that is added as new clips. Or pass `preset` instead of clipIds to save a definition directly \u2014 the only way to make a preset with media layers: each layer is a video or image (by URL) sized to the clip the preset is applied to, drawn over it (role "over") or cutting it as its track matte (role "matte"), e.g. a torn-paper overlay plus a luma matte that reveals a photo.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipIds: { type: "array", items: { type: "string" }, description: "The clips to capture." },
+        preset: {
+          type: "object",
+          description: 'A preset definition instead of clipIds: { name, category?, description?, tags?, id? (custom_\u2026 to replace one), clips?: [], layers: [{ label, role: "over"|"matte", matteType?: "alpha"|"alphaInverted"|"luma"|"lumaInverted", start (s from the clip start), dur?, followLongSide? (quarter-turn to match a portrait clip), copyEffects? (effect types copied from the clip, e.g. ["dropShadow"]), blendMode?, media: { url, name, type: "video"|"image", duration, width, height } }] }.'
+        },
+        name: str("Preset name."),
+        category: {
+          type: "string",
+          enum: ["text", "motion", "paper", "liquid", "glitch", "logo", "lower-third", "transition", "bg"],
+          description: "Shelf it is filed under. Defaults to motion."
+        },
+        tags: { type: "array", items: { type: "string" }, description: "Optional search tags." },
+        description: str("Optional one-line description.")
+      }
+    },
+    method: "savePreset"
+  },
+  {
+    name: "apply_preset",
+    description: "Apply a preset (saved or built-in; ids from list_presets). With clipId, a one-clip preset is laid onto that clip, keeping its media and place and replacing animation only on the properties the preset sets. Without clipId, the preset\u2019s clips are added as new clips at time (default: the playhead). A preset with media layers (list_presets says needsClipId) needs clipId: its layers go on new tracks directly above that clip, sized to its box, starting with it.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        presetId: str("Preset id from list_presets."),
+        clipId: str("Optional clip to apply it to."),
+        time: num("Where new clips start, in seconds, when clipId is not given. Defaults to the playhead."),
+        trackId: str("Optional track for new clips.")
+      },
+      required: ["presetId"]
+    },
+    method: "applyPreset"
+  },
+  {
+    name: "delete_preset",
+    description: "Delete one of the user\u2019s saved presets. Built-in presets cannot be deleted.",
+    inputSchema: {
+      type: "object",
+      properties: { presetId: str("Saved preset id from list_presets.") },
+      required: ["presetId"]
+    },
+    method: "deletePreset"
+  },
   {
     name: "set_text_animation",
     description: "Give a text clip a staggered entrance \u2014 the words rising one after another, letters typing on, a karaoke highlight sweeping through, a mask wipe travelling over the glyphs. The compositor animates per letter, word or line, so a title arrives instead of cutting on. Naming a preset alone uses the timing it was designed with; unit, stagger and durationIn override it. The response reports how long the entrance takes and warns when it outlasts the clip.",
@@ -19824,7 +20151,7 @@ var TOOLS = [
   },
   {
     name: "import_local_file",
-    description: 'Import a media file from the user\'s own computer by FILENAME, through the local bridge. Use this when someone refers to a file they have rather than a URL \u2014 add_media_file cannot reach a path, because a browser tab cannot read one. The bridge searches only the folders its operator shared with --allow-dir, and only video, audio and image files inside them; anything else is not refused so much as invisible. Pass a bare filename ("interview-take-3.mp4"), not a path: the bridge does the finding, and a caller that cannot name a directory cannot be steered out of one. Requires the bridge to be running \u2014 `uvx goatedit-bridge --allow-dir <folder>` \u2014 with its token pasted into the editor.',
+    description: 'Import a media file from the user\'s own computer by FILENAME, through the local bridge. Use this when someone refers to a file they have rather than a URL \u2014 add_media_file cannot reach a path, because a browser tab cannot read one. The bridge searches only the folders its operator shared with --allow-dir, and only video, audio and image files inside them; anything else is not refused so much as invisible. Pass a bare filename ("interview-take-3.mp4"), not a path: the bridge does the finding, and a caller that cannot name a directory cannot be steered out of one. Requires the bridge to be running \u2014 `uvx goatedit-bridge --allow-dir <folder>` \u2014 with its token pasted into the editor. The local goatedit-mcp server needs no bridge for files in its own assets folder: it finds them itself, and also takes a path relative to that folder as list_local_assets gives it.',
     inputSchema: {
       type: "object",
       properties: {
@@ -19982,7 +20309,7 @@ var TOOLS = [
       properties: {
         clipId: CLIP_ID,
         newStartTime: num("New timeline start time in seconds."),
-        newTrackId: str('Track to move onto. Defaults to the clip\u2019s current track. Accepts "__new_video__" to pick a video track free across the clip\u2019s span.')
+        newTrackId: str('Track to move onto. Defaults to the clip\u2019s current track. Accepts "__new_video__" to pick a video track free across the clip\u2019s span, or "__new_track__" for a new video track on top.')
       },
       required: ["clipId", "newStartTime"]
     },
@@ -20106,6 +20433,90 @@ var TOOLS = [
     method: "redo"
   }
 ];
+var SEQUENCE_EDITS = /* @__PURE__ */ new Set([
+  "addClip",
+  "addClips",
+  "addTextClip",
+  "updateTextClip",
+  "addShapeClip",
+  "addAdjustmentLayer",
+  "addTitleCard",
+  "insertRipple",
+  "setClipAudio",
+  "setClipTransform",
+  "setUltraKey",
+  "setTrackMatte",
+  "setShapeGradient",
+  "setMask",
+  "setKeyframes",
+  "setClipEffect",
+  "setTextAnimation",
+  "addHtmlClip",
+  "setColorGrade",
+  "setClipDenoise",
+  "addTransition",
+  "applyAiEdit",
+  "batchEdit",
+  "clearTrack",
+  "nestClips",
+  "addSequenceClip",
+  "removeClip",
+  "moveClip",
+  "trimClip",
+  "splitClip",
+  "rippleDeleteClip",
+  "generateCaptions",
+  "applyPreset",
+  "updateShapeClip",
+  "addNull",
+  "setParent",
+  "groupClips",
+  "setProximity",
+  "setClipSpeed",
+  "setAutoLayout"
+]);
+var EXPECTED_SEQUENCE = str(
+  "Optional guard: the sequence id this edit is meant for (from list_sequences). If the tab has a different sequence open, the call is refused instead of editing the wrong one."
+);
+var PLACING_EDITS = /* @__PURE__ */ new Set([
+  "addClip",
+  "addClips",
+  "addTextClip",
+  "addShapeClip",
+  "addAdjustmentLayer",
+  "addHtmlClip",
+  "addSequenceClip",
+  "moveClip",
+  "trimClip",
+  "batchEdit",
+  "generateCaptions",
+  "addNull",
+  "groupClips",
+  "setClipSpeed"
+]);
+var OVERWRITE = {
+  type: "boolean",
+  description: 'Placing, moving or lengthening a clip onto a span of a named track that other clips already hold is refused, naming them, because it would cut or delete them. Pass true to replace them anyway. Use trackId "__new_video__" for a free video track or "__new_track__" for a new one on top instead.'
+};
+var NEW_TRACK_ABOVE = str(
+  'With trackId "__new_track__": put the new track directly above this video track instead of on top of everything \u2014 for a layer that belongs with a clip, below a full-length adjustment layer.'
+);
+var NEW_TRACK_BELOW = str('With trackId "__new_track__": put the new track directly below this video track.');
+var TOOLS = BASE_TOOLS.map((tool) => {
+  if (!tool.method || !SEQUENCE_EDITS.has(tool.method)) return tool;
+  return {
+    ...tool,
+    inputSchema: {
+      ...tool.inputSchema,
+      properties: {
+        ...tool.inputSchema.properties,
+        expectedSequenceId: EXPECTED_SEQUENCE,
+        ...PLACING_EDITS.has(tool.method) ? { overwrite: OVERWRITE } : {},
+        ...PLACING_EDITS.has(tool.method) && tool.method !== "trimClip" ? { aboveTrackId: NEW_TRACK_ABOVE, belowTrackId: NEW_TRACK_BELOW } : {}
+      }
+    }
+  };
+});
 var TOOLS_BY_NAME = new Map(TOOLS.map((t) => [t.name, t]));
 function editDistance(a, b) {
   const rows = [Array.from({ length: b.length + 1 }, (_, j) => j)];
@@ -20174,6 +20585,51 @@ function toContent(result) {
   return blocks;
 }
 
+// src/find-local-file.ts
+import fs from "fs";
+import path from "path";
+function findLocalFile(root, wanted, maxDepth) {
+  const name = wanted.trim();
+  if (!name || !fs.existsSync(root)) return null;
+  if (name.includes("/") || name.includes(path.sep)) {
+    const full = path.resolve(root, name);
+    if (!full.startsWith(root + path.sep)) return null;
+    try {
+      return fs.statSync(full).isFile() ? full : null;
+    } catch {
+      return null;
+    }
+  }
+  const target = name.toLowerCase();
+  let level = [root];
+  for (let depth = 0; depth <= maxDepth && level.length; depth++) {
+    const hits = [];
+    const next = [];
+    for (const dir of level) {
+      let entries;
+      try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+      } catch {
+        continue;
+      }
+      for (const entry of entries) {
+        if (entry.name.startsWith(".")) continue;
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) next.push(full);
+        else if (entry.isFile() && entry.name.toLowerCase() === target) hits.push(full);
+      }
+    }
+    if (hits.length > 1) {
+      throw new Error(
+        `Several files are named "${name}": ${hits.map((h) => path.relative(root, h)).sort().join(", ")}. Pass one of these paths as filename.`
+      );
+    }
+    if (hits.length === 1) return hits[0];
+    level = next;
+  }
+  return null;
+}
+
 // src/index.ts
 var WEBSOCKET_PORT = 9e3;
 var BIND_HOST = "127.0.0.1";
@@ -20201,11 +20657,11 @@ function isLoopbackHost(host) {
   }
 }
 var CONTROLLER_TOKEN = process.env.GOATEDIT_CONTROLLER_TOKEN || crypto.randomBytes(32).toString("hex");
-var CONTROLLER_TOKEN_FILE = path.join(os.homedir(), ".goatedit", "mcp-controller-token");
+var CONTROLLER_TOKEN_FILE = path2.join(os.homedir(), ".goatedit", "mcp-controller-token");
 function writeControllerToken() {
-  fs.mkdirSync(path.dirname(CONTROLLER_TOKEN_FILE), { recursive: true, mode: 448 });
-  fs.writeFileSync(CONTROLLER_TOKEN_FILE, CONTROLLER_TOKEN, { mode: 384 });
-  fs.chmodSync(CONTROLLER_TOKEN_FILE, 384);
+  fs2.mkdirSync(path2.dirname(CONTROLLER_TOKEN_FILE), { recursive: true, mode: 448 });
+  fs2.writeFileSync(CONTROLLER_TOKEN_FILE, CONTROLLER_TOKEN, { mode: 384 });
+  fs2.chmodSync(CONTROLLER_TOKEN_FILE, 384);
 }
 function hasControllerToken(req) {
   const header = req.headers.authorization || "";
@@ -20215,24 +20671,24 @@ function hasControllerToken(req) {
   return a.length === b.length && crypto.timingSafeEqual(a, b);
 }
 var REQUEST_TIMEOUT_MS = 3e4;
-var LOCAL_ASSETS_DIR = path.resolve(
-  process.env.GOATEDIT_ASSETS_DIR || path.join(os.homedir(), "Movies")
+var LOCAL_ASSETS_DIR = path2.resolve(
+  process.env.GOATEDIT_ASSETS_DIR || path2.join(os.homedir(), "Movies")
 );
-var FRAMES_DIR = path.resolve(
-  process.env.GOATEDIT_FRAMES_DIR || path.join(os.homedir(), ".goatedit", "frames")
+var FRAMES_DIR = path2.resolve(
+  process.env.GOATEDIT_FRAMES_DIR || path2.join(os.homedir(), ".goatedit", "frames")
 );
 var VERSION = (() => {
-  const here = path.dirname(fileURLToPath(import.meta.url));
+  const here = path2.dirname(fileURLToPath(import.meta.url));
   for (const rel of ["../package.json", "../../../package.json"]) {
     try {
-      const pkg = JSON.parse(fs.readFileSync(path.join(here, rel), "utf8"));
+      const pkg = JSON.parse(fs2.readFileSync(path2.join(here, rel), "utf8"));
       if (pkg.name === "goatedit-mcp") return String(pkg.version);
     } catch {
     }
   }
   return "0.0.0";
 })();
-var INSTRUCTIONS = `Edits a GoatEdit video project live in the user's browser tab at ai.goatedit.com. Call get_timeline before any edit \u2014 clip ids change after every split, trim or delete, and a stale id is rejected. get_timeline is lean by default; pass detail: "full" only when you need effect parameters, and trackId or from/to to read part of it. Several edits in a row go faster as one run_tools call. With more than one tab open, call list_connected_projects, then use_project to pick one. render_preview_frame and preview_media accept saveToDisk: true, which writes the frame to a file and returns its path instead of the image. If a tool reports the editor is not connected, ask the user to open ai.goatedit.com and switch on Local in the AI status menu.`;
+var INSTRUCTIONS = `Edits a GoatEdit video project live in the user's browser tab at ai.goatedit.com. Call get_timeline before your first edit \u2014 clip ids change after every split, trim or delete, and a stale id is rejected. Each edit's reply carries timelineChanges (clips added, with their ids and placement; clips changed; ids removed), so take the next ids from there instead of reading the timeline again. get_timeline is lean by default; pass detail: "full" only when you need effect parameters, and trackId or from/to to read part of it. Several edits in a row go faster as one run_tools call. With more than one tab open, call list_connected_projects, then use_project to pick one. render_preview_frame and preview_media accept saveToDisk: true, which writes the frame to a file and returns its path instead of the image. If a tool reports the editor is not connected, ask the user to open ai.goatedit.com and switch on Local in the AI status menu.`;
 var MEDIA_TYPES = {
   ".mp4": { mime: "video/mp4", kind: "video" },
   ".m4v": { mime: "video/mp4", kind: "video" },
@@ -20253,18 +20709,18 @@ var MEDIA_TYPES = {
   ".json": { mime: "application/json", kind: "lottie" }
 };
 function mediaUrl(rel) {
-  return `http://localhost:${WEBSOCKET_PORT}/media/${rel.split(path.sep).map(encodeURIComponent).join("/")}`;
+  return `http://localhost:${WEBSOCKET_PORT}/media/${rel.split(path2.sep).map(encodeURIComponent).join("/")}`;
 }
 var MAX_LISTED_ASSETS = 500;
 var MAX_ASSET_DEPTH = 4;
 async function handleListLocalAssets(args = {}) {
-  if (!fs.existsSync(LOCAL_ASSETS_DIR)) {
+  if (!fs2.existsSync(LOCAL_ASSETS_DIR)) {
     throw new Error(
       `Assets directory does not exist: ${LOCAL_ASSETS_DIR}. Set GOATEDIT_ASSETS_DIR to a folder of media.`
     );
   }
-  const start = path.resolve(LOCAL_ASSETS_DIR, args.folder || "");
-  if (start !== LOCAL_ASSETS_DIR && !start.startsWith(LOCAL_ASSETS_DIR + path.sep)) {
+  const start = path2.resolve(LOCAL_ASSETS_DIR, args.folder || "");
+  if (start !== LOCAL_ASSETS_DIR && !start.startsWith(LOCAL_ASSETS_DIR + path2.sep)) {
     throw new Error("folder must be inside the assets directory.");
   }
   const files = [];
@@ -20272,7 +20728,7 @@ async function handleListLocalAssets(args = {}) {
   const walk = (dir, depth) => {
     let entries;
     try {
-      entries = fs.readdirSync(dir, { withFileTypes: true });
+      entries = fs2.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -20283,17 +20739,17 @@ async function handleListLocalAssets(args = {}) {
         return;
       }
       if (entry.name.startsWith(".")) continue;
-      const full = path.join(dir, entry.name);
+      const full = path2.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (depth < MAX_ASSET_DEPTH) walk(full, depth + 1);
         continue;
       }
-      const type = MEDIA_TYPES[path.extname(entry.name).toLowerCase()];
+      const type = MEDIA_TYPES[path2.extname(entry.name).toLowerCase()];
       if (!type || !entry.isFile()) continue;
-      const rel = path.relative(LOCAL_ASSETS_DIR, full);
+      const rel = path2.relative(LOCAL_ASSETS_DIR, full);
       let bytes = 0;
       try {
-        bytes = fs.statSync(full).size;
+        bytes = fs2.statSync(full).size;
       } catch {
       }
       files.push({ name: entry.name, path: rel, type: type.kind, bytes, url: mediaUrl(rel) });
@@ -20306,6 +20762,14 @@ async function handleListLocalAssets(args = {}) {
     ...truncated ? { truncated: true, note: `Stopped at ${MAX_LISTED_ASSETS} files. Pass folder to list one subfolder.` } : {}
   };
 }
+async function handleFindLocalFile(args = {}) {
+  const hit = findLocalFile(LOCAL_ASSETS_DIR, String(args.filename ?? ""), MAX_ASSET_DEPTH);
+  if (!hit) return null;
+  const type = MEDIA_TYPES[path2.extname(hit).toLowerCase()];
+  if (!type || type.kind === "lottie") return null;
+  const rel = path2.relative(LOCAL_ASSETS_DIR, hit);
+  return { name: path2.basename(hit), path: rel, url: mediaUrl(rel), contentType: type.mime };
+}
 function audioDuration(file) {
   try {
     const out = execFileSync("afinfo", [file], { encoding: "utf8" });
@@ -20323,10 +20787,10 @@ async function handleGenerateVoiceover(text, projectId) {
     throw new Error("generate_voiceover needs macOS `say`. Not available on this platform.");
   }
   const filename = `voiceover_${Date.now()}.wav`;
-  const filePath = path.join(LOCAL_ASSETS_DIR, filename);
-  fs.mkdirSync(LOCAL_ASSETS_DIR, { recursive: true });
-  const scriptPath = path.join(LOCAL_ASSETS_DIR, `.voiceover_${Date.now()}.txt`);
-  fs.writeFileSync(scriptPath, text, "utf8");
+  const filePath = path2.join(LOCAL_ASSETS_DIR, filename);
+  fs2.mkdirSync(LOCAL_ASSETS_DIR, { recursive: true });
+  const scriptPath = path2.join(LOCAL_ASSETS_DIR, `.voiceover_${Date.now()}.txt`);
+  fs2.writeFileSync(scriptPath, text, "utf8");
   try {
     execFileSync("say", ["-o", filePath, "-f", scriptPath], { stdio: "ignore" });
     const duration3 = audioDuration(filePath) ?? text.split(/\s+/).length * 0.45 + 1;
@@ -20344,7 +20808,7 @@ async function handleGenerateVoiceover(text, projectId) {
     throw new Error(`Failed to generate voiceover: ${err.message}`);
   } finally {
     try {
-      fs.unlinkSync(scriptPath);
+      fs2.unlinkSync(scriptPath);
     } catch {
     }
   }
@@ -20353,14 +20817,14 @@ function saveFramesToDisk(result, label) {
   if (!result || typeof result !== "object") return result;
   const frames = [result._image, ...Array.isArray(result._images) ? result._images : []].filter((f) => f && typeof f.data === "string" && typeof f.mimeType === "string");
   if (!frames.length) return result;
-  fs.mkdirSync(FRAMES_DIR, { recursive: true });
+  fs2.mkdirSync(FRAMES_DIR, { recursive: true });
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
   const safe = label.replace(/[^\w.-]+/g, "_").slice(0, 60);
   const saved = frames.map((f, i) => {
     const ext = f.mimeType === "image/png" ? "png" : f.mimeType === "image/webp" ? "webp" : "jpg";
-    const file = path.join(FRAMES_DIR, `${stamp}-${safe}${frames.length > 1 ? `-${i}` : ""}.${ext}`);
+    const file = path2.join(FRAMES_DIR, `${stamp}-${safe}${frames.length > 1 ? `-${i}` : ""}.${ext}`);
     const bytes = Buffer.from(f.data, "base64");
-    fs.writeFileSync(file, bytes);
+    fs2.writeFileSync(file, bytes);
     return { path: file, bytes: bytes.length, ...f.caption ? { caption: f.caption } : {} };
   });
   const { _image, _images, ...rest } = result;
@@ -20371,8 +20835,8 @@ function saveFramesToDisk(result, label) {
   };
 }
 function serveFile(req, res, filePath) {
-  const size = fs.statSync(filePath).size;
-  const type = MEDIA_TYPES[path.extname(filePath).toLowerCase()]?.mime ?? "application/octet-stream";
+  const size = fs2.statSync(filePath).size;
+  const type = MEDIA_TYPES[path2.extname(filePath).toLowerCase()]?.mime ?? "application/octet-stream";
   const headers = { "Content-Type": type, "Accept-Ranges": "bytes" };
   const range = /^bytes=(\d*)-(\d*)$/.exec(req.headers.range || "");
   if (range && (range[1] || range[2])) {
@@ -20395,7 +20859,7 @@ function serveFile(req, res, filePath) {
       res.end();
       return;
     }
-    fs.createReadStream(filePath, { start, end }).pipe(res);
+    fs2.createReadStream(filePath, { start, end }).pipe(res);
     return;
   }
   res.writeHead(200, { ...headers, "Content-Length": size });
@@ -20403,7 +20867,7 @@ function serveFile(req, res, filePath) {
     res.end();
     return;
   }
-  fs.createReadStream(filePath).pipe(res);
+  fs2.createReadStream(filePath).pipe(res);
 }
 var httpServer = http.createServer((req, res) => {
   const url = new URL(req.url || "/", `http://${req.headers.host}`);
@@ -20441,9 +20905,9 @@ var httpServer = http.createServer((req, res) => {
       res.end("Bad path");
       return;
     }
-    const filePath = path.resolve(LOCAL_ASSETS_DIR, filename);
-    const inRoot = filePath === LOCAL_ASSETS_DIR || filePath.startsWith(LOCAL_ASSETS_DIR + path.sep);
-    if (inRoot && fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+    const filePath = path2.resolve(LOCAL_ASSETS_DIR, filename);
+    const inRoot = filePath === LOCAL_ASSETS_DIR || filePath.startsWith(LOCAL_ASSETS_DIR + path2.sep);
+    if (inRoot && fs2.existsSync(filePath) && fs2.statSync(filePath).isFile()) {
       serveFile(req, res, filePath);
     } else {
       res.writeHead(404, { "Content-Type": "text/plain" });
@@ -20640,7 +21104,7 @@ function connectUpstream() {
   upstreamReady = new Promise((resolve, reject) => {
     let token;
     try {
-      token = process.env.GOATEDIT_CONTROLLER_TOKEN || fs.readFileSync(CONTROLLER_TOKEN_FILE, "utf8").trim();
+      token = process.env.GOATEDIT_CONTROLLER_TOKEN || fs2.readFileSync(CONTROLLER_TOKEN_FILE, "utf8").trim();
     } catch {
       reject(new Error(notConnectedMessage()));
       return;
@@ -20712,7 +21176,8 @@ async function sendToBrowser(method, params = {}, projectId) {
 var LOCAL_HANDLERS = {
   list_connected_projects: async () => connectedProjects(),
   list_local_assets: async (args) => handleListLocalAssets(args),
-  generate_voiceover: async (args, projectId) => handleGenerateVoiceover(args.text, projectId)
+  generate_voiceover: async (args, projectId) => handleGenerateVoiceover(args.text, projectId),
+  find_local_file: async (args) => handleFindLocalFile(args)
 };
 async function callLocal(method, args, projectId) {
   await ensureTransport();
@@ -20821,9 +21286,26 @@ async function callTool(name, args) {
   const invalid = validateArgs(tool, forwarded);
   if (invalid) throw new McpError(ErrorCode.InvalidParams, invalid);
   const target = projectId ?? chosenProjectId;
+  if (name === "import_local_file") return importLocalFile(forwarded, target);
   const result = await sendToBrowser(tool.method, forwarded, target);
   return saveToDisk ? saveFramesToDisk(result, name) : result;
 }
+async function importLocalFile(args, target) {
+  const local = await callLocal("find_local_file", { filename: args.filename }, target).catch((err) => {
+    if (/^Several files/.test(err?.message ?? "")) throw err;
+    return null;
+  });
+  if (local) {
+    return sendToBrowser("importLocalFile", { ...args, localUrl: local.url, contentType: local.contentType, name: local.name }, target);
+  }
+  try {
+    return await sendToBrowser("importLocalFile", args, target);
+  } catch (err) {
+    throw new Error(
+      `${err?.message ?? err} It is not in this server's assets directory (${LOCAL_ASSETS_DIR}) either: put it there, or start this server with GOATEDIT_ASSETS_DIR set to its folder. list_local_assets shows what is there.`
+    );
+  }
+}
 async function runTools(args) {
   const calls = args.calls;
   if (!Array.isArray(calls) || !calls.length) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goatedit-mcp",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Local MCP server for the GoatEdit video editor: drive your open editor tab from Claude Code or any MCP client",
   "license": "UNLICENSED",
   "type": "module",