goatedit-mcp 1.1.1 → 1.1.2

package/bundle/goatedit-mcp.js

@@ -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 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. 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.",
@@ -19798,11 +20061,15 @@ var TOOLS = [
   },
   {
     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.",
+    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",
@@ -19811,14 +20078,13 @@ var TOOLS = [
         },
         tags: { type: "array", items: { type: "string" }, description: "Optional search tags." },
         description: str("Optional one-line description.")
-      },
-      required: ["clipIds", "name"]
+      }
     },
     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).",
+    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: {
@@ -20043,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"]
     },
@@ -20167,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)];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goatedit-mcp",
-  "version": "1.1.1",
+  "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",