goatedit-mcp 1.1.1 → 1.1.3

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.",
@@ -19232,12 +19254,20 @@ var TOOLS = [
       properties: {
         time: num("Timeline position to render, in seconds."),
         clipId: str("Render this clip\u2019s midpoint instead of a time."),
+        times: {
+          type: "array",
+          items: { type: "number" },
+          description: "Render up to 24 moments as ONE contact-sheet image instead of a single frame: tiles left to right, top to bottom, each stamped with its time and frame number. Use it to review a whole cut, compare scene joins side by side, or check an animation across its length in one call. width is then the sheet width (default 1280, up to 1600)."
+        },
+        columns: num("With times: tiles per row. Defaults to a near-square grid."),
         saveToDisk: {
           type: "boolean",
           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 +19293,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"]
     },
@@ -19271,7 +19303,7 @@ var TOOLS = [
   },
   {
     name: "lint_timeline",
-    description: "Check the timeline for problems that leave state looking correct while the result is broken \u2014 most importantly clips that carry sound but sit on a video track, where the mixer never reads them and they are silent in both preview and export. Also reports dangling and out-of-sync clip links, clips reading past the end of their source, clips whose media has left the bin, and overlaps. Call this after any batch of edits; it is the cheapest verification available and needs no rendering.",
+    description: "Check the timeline for problems that leave state looking correct while the result is broken \u2014 most importantly clips that carry sound but sit on a video track, where the mixer never reads them and they are silent in both preview and export. Also reports dangling and out-of-sync clip links, clips reading past the end of their source, clips whose media has left the bin, and overlaps. It also asks every source whether it still loads \u2014 media files, and the pictures inside HTML clips \u2014 and reports the ones that render as nothing or as a broken-image icon (a blob: link from before a reload, a local server that stopped). Call this after any batch of edits; it is the cheapest verification available and needs no rendering.",
     inputSchema: { type: "object", properties: {} },
     method: "lintTimeline"
   },
@@ -19356,7 +19388,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 +19400,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 +19484,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 +19591,247 @@ 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: "join_scenes",
+    description: "Join two scenes at a cut so the edit flows instead of cutting: push (one camera move across a shared canvas \u2014 the outgoing scene speeds out and the incoming arrives at the same speed, so the cut falls mid-motion), zoomThrough (push into one element of the outgoing scene until it fills the frame; the incoming scene opens out of it), or matchCut (a layer of the incoming scene starts exactly where a layer of the outgoing one was \u2014 position, size, turn, through parents, 3D models included \u2014 then settles into its own place). push and zoomThrough add a camera null per side and parent that side's top-level clips to it, so every layer stays editable and the camera's keyframes can be tuned afterwards. at is the cut: outgoing clips end there and incoming clips start there.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        at: num("The cut time in seconds."),
+        type: { type: "string", enum: ["push", "zoomThrough", "matchCut"], description: "Which join." },
+        duration: num("Seconds the move takes on each side of the cut. Default 0.4."),
+        direction: { type: "string", enum: ["left", "right", "up", "down"], description: "push: which way the picture travels. Default left." },
+        clipId: str("zoomThrough: the element of the outgoing scene to fly into."),
+        zoom: num("zoomThrough: how far in the outgoing camera goes. Default: until the element overfills the frame."),
+        inZoom: num("zoomThrough: scale the incoming scene opens from. Default 1.8."),
+        fromClipId: str("matchCut: the outgoing layer to match."),
+        toClipId: str("matchCut: the incoming layer that takes its place.")
+      },
+      required: ["at", "type"]
+    },
+    method: "joinScenes"
+  },
+  {
+    name: "create_3d_object",
+    description: "Make a word, a logo or an SVG solid: extruded to a depth with rounded edges and lit like a 3D model, as its own clip with nothing around it (no backdrop), so it floats over whatever is beneath. Give text (drawn in font/weight/color) or mediaFileId of a transparent PNG or an SVG in the bin (a photo needs remove_background first). spins turns it whole times over the clip; rotateX/Y/Z pose it. It is a showcase clip: describe_effect showcase lists its looks (chrome, glass\u2026), lighting and side colour, set with set_clip_effect.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        text: str("A word or short line to extrude."),
+        font: str("With text: font family loaded in the editor. Default Inter."),
+        weight: num("With text: font weight. Default 800."),
+        color: str("With text: fill colour, hex. Default #f2661c."),
+        mediaFileId: str("A transparent PNG or SVG in the bin, instead of text."),
+        startTime: num("Start in seconds. Default 0."),
+        duration: num("Length in seconds."),
+        trackId: str("Track to place it on. Default a new video track on top."),
+        depth: num("Extrude depth, percent of its height (0\u201360). Default 12."),
+        bevel: num("Soft edges, 0\u2013100. Default 40."),
+        spins: num("Whole turns over the clip. Default 0."),
+        rotateX: num("Pose, degrees."),
+        rotateY: num("Pose, degrees. Default 28 when not spinning, so the depth shows."),
+        rotateZ: num("Pose, degrees."),
+        size: num("Size in the frame, percent (20\u2013250). Default 92."),
+        name: str("Clip name.")
+      },
+      required: ["duration"]
+    },
+    method: "create3dObject"
+  },
+  {
+    name: "remove_background",
+    description: "Cut the subject out of a still image \u2014 a product, an object, a person \u2014 into a transparent PNG, the way stock photos become floating cut-outs. Runs in the editor tab (the model downloads once, ~45 MB for quality). The cut-out is added to the bin as a new file and, by default, every clip showing the photo switches to it (or only clipId when given); the original stays. For video use roto instead.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: str("An image clip to cut out; it switches to the cut-out."),
+        mediaFileId: str("A bin image to cut out, instead of a clip."),
+        engine: { type: "string", enum: ["quality", "fast"], description: "quality (default): any subject, sharper edges. fast: people only, tiny download." },
+        applyToClips: bool("Switch clips to the cut-out. Default true.")
+      }
+    },
+    method: "removeBackground"
+  },
+  {
+    name: "set_scene",
+    description: "Mark a stretch of timeline as a named scene (a ruler marker with a length), so retime_range can move or stretch it as one piece later. With start and end it makes a scene; with sceneId it changes one (start, end, label, color) or deletes it (remove: true); with no arguments it lists every scene.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        start: num("Scene start in seconds."),
+        end: num("Scene end in seconds."),
+        label: str('Name, e.g. "P03 Grid".'),
+        color: str("Marker colour, hex."),
+        sceneId: str("An existing scene to change or remove."),
+        remove: bool("With sceneId: delete the scene marker (clips are untouched).")
+      }
+    },
+    method: "setScene"
+  },
+  {
+    name: "retime_range",
+    description: "Move or stretch a whole stretch of timeline in one step \u2014 every clip that lies wholly inside it, on every track. Clips scale in place, every keyframe inside them (transform, text, effects, masks, paths, tracker) scales with them, text animation timings and fades scale, and footage changes speed to cover the same source in the new length \u2014 so squeezing a scene from 1.6s to 1.2s plays all of its animation faster instead of cutting the end off. With ripple (default) everything after the range shifts by the change in its end, closing or opening the gap; scene markers move too. Name the range by scene (a set_scene id or label) or by from/to. Clips crossing an edge are left alone and reported. One undo step.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        scene: str("A scene id or label from set_scene, instead of from/to."),
+        from: num("Range start in seconds."),
+        to: num("Range end in seconds."),
+        duration: num("New length of the range in seconds. Omit to keep it (a plain move)."),
+        start: num("New start of the range in seconds. Omit to keep it in place."),
+        ripple: bool("Shift everything after the range by the change in its end. Default true."),
+        allowOverlap: bool("Proceed even when the moved range lands on clips outside it (they would be overlapped)."),
+        dryRun: bool("Report what would move without changing anything.")
+      }
+    },
+    method: "retimeRange"
+  },
+  {
+    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.",
@@ -19684,10 +19991,17 @@ var TOOLS = [
   },
   {
     name: "set_clip_transform",
-    description: "Position, scale, rotate or fade a clip in the frame. Positions are fractions of the frame, 0..1, with 0.5 the centre \u2014 so a top-left watermark is roughly x 0.12, y 0.1.",
+    description: `Position, scale, rotate or fade a clip in the frame. Positions are fractions of the frame, 0..1, with 0.5 the centre \u2014 so a top-left watermark is roughly x 0.12, y 0.1. A parented clip's own values are measured from its parent's pose, not the screen: to put it somewhere exact, pass space: "screen", or matchClipId to sit it on another clip; animated properties keep their animation and move as a whole.`,
     inputSchema: {
       type: "object",
       properties: {
+        matchClipId: str("Put this clip where another clip appears on screen \u2014 through any parents on either side. With match choose what to copy; the default is position and size (fitted inside, keeping proportions)."),
+        match: { type: "array", items: { type: "string", enum: ["position", "size", "rotation"] }, description: 'With matchClipId: what to copy. Defaults to ["position", "size"].' },
+        space: { type: "string", enum: ["own", "screen"], description: "screen: x and y are where the picture's centre should appear (fractions of the frame), width/height its on-screen size in pixels, rotation as seen \u2014 solved through parents, so a parented clip lands exactly there. Default own: the clip's own values." },
+        width: num("With space screen: on-screen width in pixels."),
+        height: num("With space screen: on-screen height in pixels."),
+        stretch: bool("With a size target: scale X and Y separately to fill it, instead of fitting inside."),
+        time: num("With matchClipId or space screen: the moment to measure at, in timeline seconds. Defaults to the playhead, clamped into the clip."),
         clipId: CLIP_ID,
         x: num("Horizontal centre as a fraction of frame width, 0..1."),
         y: num("Vertical centre as a fraction of frame height, 0..1."),
@@ -19695,12 +20009,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 +20169,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 +20186,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 +20417,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 +20541,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)];
@@ -20356,7 +20814,8 @@ var MEDIA_TYPES = {
   ".gif": { mime: "image/gif", kind: "image" },
   ".webp": { mime: "image/webp", kind: "image" },
   ".svg": { mime: "image/svg+xml", kind: "image" },
-  ".json": { mime: "application/json", kind: "lottie" }
+  ".json": { mime: "application/json", kind: "lottie" },
+  ".glb": { mime: "model/gltf-binary", kind: "model" }
 };
 function mediaUrl(rel) {
   return `http://localhost:${WEBSOCKET_PORT}/media/${rel.split(path2.sep).map(encodeURIComponent).join("/")}`;

package/package.json

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