goatedit-mcp 1.1.5 → 1.1.7

package/bundle/goatedit-mcp.js

@@ -19179,6 +19179,8 @@ 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."),
+  captionStyle: str("A caption look from the editor's library, applied first so the other style fields here adjust it: purpleLuxuryScript, cyanBlueprint, greenCapital, goldScriptGala, violetChrome, iceCrystal, podcastFame, whiteFlowGrid, blackPlate, extrudedPop, yellowHit, slantedRedDesculpa, redHeroEditorial, orangeHooksHero, creamHero, blackHero, splitSerif, magazineStack, goldSerifAccent, ivoryElegance, roseGoldSerif, sageSerif, midnightSerif, champagneSerif. It brings its own fonts, layout and text animation."),
+  wordSpacing: num("Space between words as a fraction of the font size. Default 0.26; editorial captions with wide gaps use about 1.6."),
   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."),
@@ -19194,7 +19196,13 @@ var TEXT_STYLE_PROPS = {
   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.")
+  posY: num("Vertical position as a fraction of the frame, 0..1. 0.5 is centre."),
+  path: {
+    type: ["object", "null"],
+    description: "Set the text along a curve instead of in a block: { points: [[x, y], ...] (fractions of the frame, at least two; anchors without handles are smoothed into a curve through them, and points may lie outside 0..1 so a ribbon runs off the frame), ribbonColor? (paints a band along the path behind the letters), ribbonWidth? (px @1080p, default 380), waveLength? (px between wave crests, default 900), waveSpeed? (crests per second, default 0.5) }. The clip's position moves the whole path. null returns the text to a block. Text animations do not apply along a path; animate pathOffset and pathWave with set_keyframes (as textPathOffset / textPathWave) instead."
+  },
+  pathOffset: num("Where the middle of the text sits along its path, 0 at the start, 1 at the end (default 0.5). Below 0 or above 1 runs the words off the ends, so keyframing it from -0.3 to 0.5 slides a word in along its ribbon."),
+  pathWave: num("Height of the wave travelling down the path, px @1080p (default 0, flat). It bends the ribbon and the letters together.")
 };
 var BASE_TOOLS = [
   {
@@ -19546,6 +19554,7 @@ var BASE_TOOLS = [
       type: "object",
       properties: {
         text: str("The text to display."),
+        name: str("The layer's name in the timeline. Defaults to the text itself."),
         duration: num("How long the card stays on screen, in seconds."),
         startTime: num("Where it starts on the timeline, in seconds. Defaults to 0."),
         trackId: str("Target video track. Defaults to the topmost one that is free across the card\u2019s span, creating a new track above everything if none is free."),
@@ -19641,16 +19650,18 @@ var BASE_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        shape: { type: "string", enum: ["sphere", "torus", "capsule", "box", "cylinder", "cone", "blob"], description: "sphere (ball), torus (ring), capsule (pill), box (block), cylinder (can), cone, blob." },
-        color: str('Colour when there is no gradient, "#rrggbb". Defaults to near-white.'),
+        shape: { type: "string", enum: ["sphere", "torus", "capsule", "box", "cylinder", "cone", "blob", "pile"], description: `sphere (ball), torus (ring), capsule (pill), box (block), cylinder (can), cone, blob, or pile: many balls that burst from the middle and settle in a heap over 3 seconds (its "Burst" animation, which then holds still; delay it with the model3d effect's animOffset, slow it with animSpeed).` },
+        color: str('A solid colour, "#rrggbb". Given on its own it turns any gradient off. Defaults to near-white.'),
         gradient: { type: "string", enum: ["none", "around", "vertical", "diagonal"], description: 'Paint `colors` across the shape: "around" runs round its axis (the rainbow ring), "vertical" top to bottom, "diagonal" corner to corner. The gradient is in the mesh, so it turns with the shape and shows through glass.' },
-        colors: { type: "array", items: { type: "string" }, description: '2\u20136 "#rrggbb" colours, spread evenly, for the gradient. Repeat the first at the end for a seamless "around".' },
+        colors: { type: "array", items: { type: "string" }, description: '2\u20136 "#rrggbb" colours, spread evenly, for the gradient. "around" closes back on the first colour by itself. For a pile, 1\u20136 colours the balls take turns from.' },
         roughness: num("0 mirror-smooth \u2026 1 chalky. Defaults to 0.22 (glossy plastic)."),
         metalness: num("0 plastic \u2026 1 metal. Defaults to 0."),
         proportion: num("Ring: tube thickness as a share of its radius, 0.05\u20130.9. Pill, can, cone: length against width, 0\u20134. Blob: lumpiness, 0\u20131."),
         size: { type: "array", items: { type: "number" }, description: "Block only: [width, height, depth], relative, 0.1\u20134 each." },
         round: num("Block only: edge rounding, 0 sharp \u2026 1 fully round."),
-        seed: num("Blob only: which blob; the same seed is the same shape."),
+        seed: num("Blob: which blob. Pile: how the balls fall. The same seed gives the same result."),
+        count: num("Pile only: how many balls, 3\u2013150. Defaults to 40."),
+        arrange: { type: "string", enum: ["heap", "burst"], description: 'Pile only: "heap" (default) \u2014 the balls fall and settle in a heap; "burst" \u2014 they fly out every way and hang in the air in a wide cloud, for an explosion of balls around something.' },
         material: str("A look by name: Original (default, the colour above), Chrome, Gold, Glass, Clay, Toon, Plastic, Matte, Iridescent, Wireframe, X-Ray Glow, Hologram, Crystal, Holographic, Candy Paint, Pearl."),
         rotateX: num("Starting tilt, degrees."),
         rotateY: num("Starting turn, degrees."),
@@ -19672,16 +19683,18 @@ var BASE_TOOLS = [
       type: "object",
       properties: {
         clipId: CLIP_ID,
-        shape: { type: "string", enum: ["sphere", "torus", "capsule", "box", "cylinder", "cone", "blob"], description: "sphere (ball), torus (ring), capsule (pill), box (block), cylinder (can), cone, blob." },
-        color: str('Colour when there is no gradient, "#rrggbb". Defaults to near-white.'),
+        shape: { type: "string", enum: ["sphere", "torus", "capsule", "box", "cylinder", "cone", "blob", "pile"], description: `sphere (ball), torus (ring), capsule (pill), box (block), cylinder (can), cone, blob, or pile: many balls that burst from the middle and settle in a heap over 3 seconds (its "Burst" animation, which then holds still; delay it with the model3d effect's animOffset, slow it with animSpeed).` },
+        color: str('A solid colour, "#rrggbb". Given on its own it turns any gradient off. Defaults to near-white.'),
         gradient: { type: "string", enum: ["none", "around", "vertical", "diagonal"], description: 'Paint `colors` across the shape: "around" runs round its axis (the rainbow ring), "vertical" top to bottom, "diagonal" corner to corner. The gradient is in the mesh, so it turns with the shape and shows through glass.' },
-        colors: { type: "array", items: { type: "string" }, description: '2\u20136 "#rrggbb" colours, spread evenly, for the gradient. Repeat the first at the end for a seamless "around".' },
+        colors: { type: "array", items: { type: "string" }, description: '2\u20136 "#rrggbb" colours, spread evenly, for the gradient. "around" closes back on the first colour by itself. For a pile, 1\u20136 colours the balls take turns from.' },
         roughness: num("0 mirror-smooth \u2026 1 chalky. Defaults to 0.22 (glossy plastic)."),
         metalness: num("0 plastic \u2026 1 metal. Defaults to 0."),
         proportion: num("Ring: tube thickness as a share of its radius, 0.05\u20130.9. Pill, can, cone: length against width, 0\u20134. Blob: lumpiness, 0\u20131."),
         size: { type: "array", items: { type: "number" }, description: "Block only: [width, height, depth], relative, 0.1\u20134 each." },
         round: num("Block only: edge rounding, 0 sharp \u2026 1 fully round."),
-        seed: num("Blob only: which blob; the same seed is the same shape.")
+        seed: num("Blob: which blob. Pile: how the balls fall. The same seed gives the same result."),
+        count: num("Pile only: how many balls, 3\u2013150. Defaults to 40."),
+        arrange: { type: "string", enum: ["heap", "burst"], description: 'Pile only: "heap" (default) \u2014 the balls fall and settle in a heap; "burst" \u2014 they fly out every way and hang in the air in a wide cloud, for an explosion of balls around something.' }
       },
       required: ["clipId"]
     },
@@ -19775,24 +19788,101 @@ var BASE_TOOLS = [
   },
   {
     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.",
+    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 morph (every pair of layers at once, Smart Animate style: each incoming layer starts on the drawn pixels of its outgoing partner \u2014 a tag inside a full-frame snippet counts as the tag \u2014 and stretches and slides into place, pairs staggered left to right), 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." },
+        type: { type: "string", enum: ["auto", "push", "zoomThrough", "matchCut", "morph"], description: "Which join. auto picks one from what is on each side: morph when incoming layers are named after outgoing ones and not animated yet, a push in the outgoing scene's own direction when it is already moving into the cut, a zoom through one small element near the middle, else a push \u2014 and says why in `picked`." },
         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.")
+        toClipId: str("matchCut: the incoming layer that takes its place."),
+        pairs: {
+          type: "array",
+          items: { type: "object" },
+          description: 'morph: [{ from, to }] clip ids \u2014 each incoming layer starts on its outgoing partner. Omit to pair automatically: layers whose names end in the same word ("S2 tag New" \u2192 "S2 block New"), then the rest left to right. Full-frame grounds are left out.'
+        },
+        stagger: num("morph: seconds between one pair starting and the next, left to right. Default 0.04.")
       },
       required: ["at", "type"]
     },
     method: "joinScenes"
   },
+  {
+    name: "animate_clip",
+    description: "Give one layer a named move from the motion recipe library, already eased, timed and overshot by the motion principles, relative to where the layer rests (it lands on its own position and scale). Entrances: fadeIn, fadeUp, popIn, slideIn, maskReveal (wiped on behind a soft edge), riseFromLine (rises from behind its own baseline \u2014 the title reveal), blurIn (2D only), zoomIn, dropIn (falls, squashes, springs back), growIn (lines and bars), spinIn. Exits (end on the clip's last frame, or `delay` before it): fadeOut, slideOut (pulls back first, then away), popOut, maskHide, blurOut. Between them: hold (a slow drift after landing, so nothing freezes). Through the whole clip: drift (slow push-in for grounds), float (gentle bob). Overshoots are real damped springs. Don't use on text clips: text animates with set_text_animation. An entrance replaces the keys in its own window only, so an entrance and an exit stack. Prefer animate_scene for a whole scene.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        clipId: str("The layer to animate."),
+        recipe: {
+          type: "string",
+          enum: ["fadeIn", "fadeUp", "popIn", "slideIn", "maskReveal", "riseFromLine", "blurIn", "zoomIn", "dropIn", "growIn", "spinIn", "fadeOut", "slideOut", "popOut", "maskHide", "blurOut", "hold", "drift", "float"],
+          description: "The move."
+        },
+        style: { type: "string", enum: ["smooth", "snappy", "bouncy"], description: "The feel: smooth (no overshoot, 0.6s), snappy (hard ease-out, small overshoot, 0.4s), bouncy (10% overshoot, 0.55s). Default smooth. Use one feel for a whole video." },
+        delay: num("Entrances: seconds into the clip before the move starts. Exits: seconds before the clip ends that the layer is gone, so a group leaves in turn. Default 0."),
+        from: num("hold: clip-relative second the drift starts (where the entrance lands)."),
+        to: num("hold: clip-relative second it ends (where the exit starts). Default the clip end."),
+        depth: num("hold: how much it drifts \u2014 1 for the hero, 0.4\u20130.6 for what sits behind it."),
+        motionBlur: bool("Smear fast travel with a camera-shutter motion blur (2D layers). Draws once where nothing moves."),
+        arc: num("slideIn, slideOut, dropIn: travel on a curve \u2014 how far the path bows toward the middle of the frame, as a fraction of the travel. 0.3 is gentle. For pictures; keep type and bars straight."),
+        anticipate: bool("fadeOut: a small lift the other way before it fades, for big layers."),
+        length: num("Seconds the move takes. Default by style."),
+        direction: { type: "string", enum: ["left", "right", "up", "down"], description: "Which way the layer travels (slideIn, slideOut, maskReveal, maskHide), or the axis growIn grows on." },
+        distance: num("Travel as a fraction of the frame height. Default by style (0.04\u20130.08).")
+      },
+      required: ["clipId", "recipe"]
+    },
+    method: "animateClip"
+  },
+  {
+    name: "animate_scene",
+    description: "Animate a whole scene the way a motion designer would, in one call. Each layer gets a role from what it draws \u2014 ground (covers the frame: a slow drift), hero (the one thing the scene is about: enters first and biggest), support (staggered outward from the hero), text, detail (small marks, popping in last), follower (parented to a picture: arrives a beat after it) \u2014 and a move and start time from its role, its size, the scene's length and the feel, so the scene speaks one motion language. Text always gets a text animation (letters or words), never a block move; pictures get keyframed recipes. Moves travel the way the scene's joins push (flow). With music on the timeline the lead lands on a beat (onBeat). Pictures travel on arcs, type and bars straight. Between the entrance and the exit every picture keeps a slow drift, deeper for the hero (hold). Layers leave last in, first out, the way the next scene comes in; big layers gather before a fade-out. Moves that would cross another layer are swapped for ones that stay in place (note). Layers that already move are left alone unless replace is true. A scene runs between two cuts; at picks it (default the playhead), all does every scene. Returns what each layer got. Follow with lint_motion to join the cuts.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        at: num("A time inside the scene to animate. Default: the playhead."),
+        all: bool("Animate every scene in the sequence."),
+        style: { type: "string", enum: ["smooth", "snappy", "bouncy"], description: "The feel, for every layer. Default smooth." },
+        replace: bool("Re-animate layers that already move, replacing their entrance (and exit if they leave early)."),
+        flow: { type: "string", enum: ["left", "right", "up", "down"], description: "The way moves travel. Default: the way the scene's join camera moves, else up." },
+        pace: num("Spacing of the cascade: 0.6 tight, 1 normal (default), 1.6 loose."),
+        hold: bool("Keep a slow drift on every picture between its entrance and its exit. Default true."),
+        beats: bool("With music on the timeline (beat markers, or audio clips), move the cascade so the lead lands on the nearest beat. Default true."),
+        dryRun: bool("Return the plan without changing anything.")
+      }
+    },
+    method: "animateScene"
+  },
+  {
+    name: "describe_motion",
+    description: "The motion design rules to animate by \u2014 easing curves, durations, stagger, overshoot, hierarchy, holds and reading time, which join to use between scenes \u2014 the same numbers lint_motion checks. Read it before animating a sequence.",
+    inputSchema: { type: "object", properties: {} },
+    method: "describeMotion"
+  },
+  {
+    name: "lint_motion",
+    description: "Check the open sequence's animation the way a motion designer would: still cuts (the picture jumps instead of moving through the change), linear moves (no easing), several layers making the same entrance on one frame (no stagger), moves too fast to follow, and text cut away before it can be read. Each finding has a message and, when the fix is mechanical, `fix`: [method, params] calls to run in order, one call each (run_tools), then lint again. Applying every fix is the one-click polish.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        from: num("Only findings from this time, seconds."),
+        to: num("Only findings up to this time, seconds.")
+      }
+    },
+    method: "lintMotion"
+  },
+  {
+    name: "list_cuts",
+    description: "Every cut in the open sequence \u2014 a time where layers end and others start together \u2014 with what leaves, what arrives, and whether the picture moves through it (a camera move, or layers moving on both sides) or it jumps (a hard cut, a still frame before an entrance, an exit before a still cut). `stillCuts` lists the ones that jump. Read it before joining scenes, and again after.",
+    inputSchema: { type: "object", properties: {} },
+    method: "listCuts"
+  },
   {
     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.",
@@ -20174,9 +20264,11 @@ var BASE_TOOLS = [
             "orbitStartAngle",
             "pathTrimStart",
             "pathTrimEnd",
-            "pathTrimOffset"
+            "pathTrimOffset",
+            "textPathOffset",
+            "textPathWave"
           ],
-          description: "Property to animate. posX/posY and opacity are 0..1 fractions, rotation is degrees, scaleX/scaleY are multipliers (1 = unchanged), pathTrimEnd 0\u21921 draws a pen stroke on."
+          description: "Property to animate. posX/posY and opacity are 0..1 fractions, rotation is degrees, scaleX/scaleY are multipliers (1 = unchanged), pathTrimEnd 0\u21921 draws a pen stroke on, textPathOffset slides text along its path (0..1) and textPathWave is the height of the wave bending it (px @1080p)."
         },
         keyframes: {
           type: "array",
@@ -20301,12 +20393,21 @@ var BASE_TOOLS = [
           description: "Entrance preset: fadeIn, slideUp, blurIn, typewriter, typewriterCursor, scaleIn, springUp, slideInLeft, slideInRight, riseFade, unfoldDown, unfoldUp, foldFlip, depthPop, wordPop, karaokeHighlight, karaokeScale, springPop, neonGlowPulse, karaokePill, cyberSlant, wipeUp, trackIn, slamIn, elasticPop, squashDrop, glitchIn, tumbleIn, swingIn, flip3D, cinematicRise, stretchIn, bounceDrop, rollIn, maskRise (rises from behind an invisible line), blockReveal (a bar in highlightColor wipes across, then uncovers the text), focusPull (big and blurred, pulling to crisp), whipIn (sideways with a motion smear), scatterSettle (letters scattered up and down drop into line), depthAssemble (letters fly in from scattered depth), decode (letters flicker through random glyphs, then resolve), countUp (the first number in the text counts up to its value, keeping its format, e.g. $787,539.00)."
         },
         unit: { type: "string", enum: ["letter", "word", "line"], description: "What the animation steps through." },
-        durationIn: num("Seconds for one unit's entrance to complete."),
+        durationIn: num("Seconds for one unit's entrance to complete. 0 cuts each unit on."),
         stagger: num("Seconds between consecutive units starting. 0 moves them together."),
+        delay: num("Seconds into the clip before the first unit starts. Default 0."),
         distance: num("Slide or offset distance in pixels @1080p, for the slide/spring/unfold presets."),
         highlightColor: str('Highlight colour for the karaoke-style presets and the bar of blockReveal, e.g. "#ff2d55".'),
         order: { type: "string", enum: ["forward", "reverse", "center", "edges", "random"], description: "Which unit goes first. Defaults to reading order." },
         seed: num("Seed for `random` order, so the shuffle stays the same on every render."),
+        syncToWords: bool("Start each unit when its word is spoken (the clip's word timings \u2014 from generate_captions, or passed as wordTimings) instead of on the stagger. With durationIn 0 and fadeIn, words cut on exactly as they are said."),
+        wordTimings: {
+          type: "array",
+          description: "Per-word timings for this clip in clip seconds, [{ text, start, end }], in reading order. Drives syncToWords and the kinetic presets. Replaces any the clip had.",
+          items: { type: "object", properties: { text: { type: "string" }, start: { type: "number" }, end: { type: "number" } }, required: ["text", "start", "end"] }
+        },
+        placeholder: str('Colour of a solid bar drawn where each unit will appear until it enters, e.g. "#111111" \u2014 words waiting their turn as redaction bars. Empty string removes it.'),
+        activeScale: num("Kinetic presets: size of the active word, 1 for no pop (stops it colliding with its neighbours). Defaults per preset, 1.1\u20131.32."),
         remove: bool("Take the animation off, leaving the text to cut on.")
       },
       required: ["clipId"]

package/package.json

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