goatedit-mcp 1.1.21 → 1.1.22

package/bundle/goatedit-mcp.js

@@ -20219,7 +20219,8 @@ var BASE_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        clipIds: { type: "array", items: { type: "string" }, description: "Clip ids from get_timeline, up to 50." }
+        clipIds: { type: "array", items: { type: "string" }, description: "Clip ids from get_timeline, up to 50." },
+        includeHtml: bool("For HTML clips, also return the markup (html), its slot fills and vars \u2014 what update_html_clip starts from. Long markup is cut at 200 KB.")
       },
       required: ["clipIds"]
     },
@@ -20505,7 +20506,11 @@ var BASE_TOOLS = [
         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.')
+        trackId: str('Video track, or "__new_video__" (default) for a free one.'),
+        threeD: { type: "boolean", description: "A 3D null (AE 3D null object): it gains Z depth and X/Y turns (its layer3d effect: posZ, rotateX, rotateY; rotation is Z). 3D layers parented to it move with it in 3D: turn it about Y with set_clip_effect keyframes and the cards around it swing round as a ring, near ones bigger. Nulls nest (a spin inside a tilt). Give children layer3d faceCamera: 1 to keep them square to the camera." },
+        z: num("3D null only: depth, 1080p px away from the camera. Defaults to 0."),
+        rotateX: num("3D null only: tilt, degrees."),
+        rotateY: num("3D null only: swivel, degrees.")
       },
       required: ["duration"]
     },
@@ -20523,7 +20528,7 @@ var BASE_TOOLS = [
         name: str("Display name for a new camera."),
         params: {
           type: "object",
-          description: "Static settings. x / y: truck right and pedestal down, 1080p px. z: dolly toward the scene, 1080p px (a layer at posZ 1000 reaches the lens at about z 2480). pan (look right +), tilt (look up +), roll, degrees. orbit (swing right around the pivot +), orbitTilt (rise over it +), degrees; pivotZ: depth of the point it swings around (put it at the hero layer's posZ). fov: vertical field of view, 40 default; narrower zooms in from where the camera stands. focalLength: the same in full-frame mm (33 mm = 40\xB0). aperture: depth-of-field blur, 0 sharp; focus: depth of the plane in focus, 1080p px."
+          description: "Static settings. x / y: truck right and pedestal down, 1080p px. z: dolly toward the scene, 1080p px, counted from where the camera rests, about 1480 px in front of the frame plane: the lens stands at depth z \u2212 1480, so a layer at posZ 1000 reaches it at about z 2480, and to stand inside a tunnel whose walls span posZ 100..1000 put z near 1580..2400. pan (look right +), tilt (look up +), roll, degrees. orbit (swing right around the pivot +), orbitTilt (rise over it +), degrees; pivotZ: depth of the point it swings around (put it at the hero layer's posZ). fov: vertical field of view, 40 default; narrower zooms in from where the camera stands. focalLength: the same in full-frame mm (33 mm = 40\xB0). aperture: depth-of-field blur, 0 sharp; focus: depth of the plane in focus, 1080p px."
         },
         keyframes: {
           type: "object",
@@ -21052,6 +21057,7 @@ var BASE_TOOLS = [
         scaleY: num("Vertical scale, overriding scale."),
         rotation: num("Rotation in degrees."),
         opacity: num("Opacity from 0 to 1."),
+        enabled: bool("false switches the clip off (the timeline's Disable): it stays in place but draws and plays nothing. true switches a disabled clip back on \u2014 get_timeline lists those with disabled: true."),
         blendMode: {
           type: "string",
           enum: [
@@ -21124,6 +21130,8 @@ var BASE_TOOLS = [
         prop: {
           type: "string",
           enum: [
+            "scale",
+            "position",
             "opacity",
             "volume",
             "posX",
@@ -21158,7 +21166,7 @@ var BASE_TOOLS = [
             "shapeDash",
             "shapeGap"
           ],
-          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). cropLeft/Top/Right/Bottom are 0..1 of the layer cut from that side (set_mask crop sets them once), cropRadius rounds the crop's corners and cropFeather softens its edge, both px @1080p. shapeWidth/shapeHeight/shapeCornerRadius/shapeStrokeWidth/shapeDash/shapeGap animate a shape layer in its own px @1080p (a square or circle needs width and height keyed together)."
+          description: "Property to animate. scale and position key both halves at once, as After Effects does (same times, same eases): value is a number for uniform scale, or [x, y]. Prefer them over keying scaleX/scaleY or posX/posY separately. 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). cropLeft/Top/Right/Bottom are 0..1 of the layer cut from that side (set_mask crop sets them once), cropRadius rounds the crop's corners and cropFeather softens its edge, both px @1080p. shapeWidth/shapeHeight/shapeCornerRadius/shapeStrokeWidth/shapeDash/shapeGap animate a shape layer in its own px @1080p (a square or circle needs width and height keyed together)."
         },
         keyframes: {
           type: "array",
@@ -21166,6 +21174,7 @@ var BASE_TOOLS = [
           items: { type: "object" }
         },
         clear: bool("Remove this property's keyframes instead of setting them, leaving the clip's flat value in charge again."),
+        relative: bool("Values are relative to where the layer rests: multiples of its scale/opacity (1.1 = 10% bigger than it is), offsets for everything else (posX +0.05, rotation +15). A punch-in on a card scaled 0.3 stays a punch-in instead of jumping to full size."),
         expression: {
           type: "string",
           description: `An After-Effects-style expression that drives the property instead (keyframes still feed it as \`value\`); "" removes it. A math-only language: numbers, value, time (seconds from this clip's start), duration, index (this layer's number, top track first), Math.*, wiggle(freq, amp), random(a, b), noise(t), clamp, linear(t, tMin, tMax, v1, v2), ease(...same), valueAtTime(t), loopOut("cycle"|"pingpong"|"offset"|"continue", n?), loopIn(...), thisLayer.<prop>, and layer("Name").<prop> or layer(2).<prop> (optionally .valueAtTime(t)), read at the same moment of the timeline. Rigs: a null named "Controls" whose posX drives others via layer("Controls").posX * 100; scaleY = thisLayer.scaleX; a stagger with valueAtTime(time - (index - 1) * 0.08); a looping bob with keyframes plus loopOut("pingpong"). Props use this tool's units (posX 0..1, rotation degrees).`
@@ -21184,7 +21193,7 @@ var BASE_TOOLS = [
         clipId: CLIP_ID,
         type: {
           type: "string",
-          description: "Effect type: blur, invert, hue, saturation, brightness, contrast, exposure, grayscale, sepia, gradientMap, vignette, filmGrain, flicker, posterizeTime, lensDistortion, chromaticAberration, lensFlare, liquidGlass, opacityFx, colorCorrection, depthMap, depthParticles, gradientMap, vegas, glow, pixelDissolve, motionBlur, dropShadow, reflection, colorama, outline, echo, flutedGlass, lightRays, halftone, datamosh, roughenEdges, filmStock, halation, starGlow, filmDamage, lightLeak, thermal, colorBalance, duotone, levels, monochrome, channelMixer, dither, threshold, fourColorGradient, lensBlur, boxBlur, directionalBlur, spinBlur, zoomBlur, sharpen, cameraShake, bulge, twirl, ripple, waveWarp, polarCoords, turbulentDisplace, elasticGrid, gridSplit, cubify, glitch, vhs, ntsc, crtScreen, ledScreen, rgbSplit, jpegGlitch, ascii, macpaint, modulation, stripe, risograph, emboss, bevel, inkBleed, paperTexture, paperCutout, crossHatch, scatter, blobTracker, edgeGlow, pageTurn, lightSweep, deepGlow, twister, fill, compositeOriginal, grid, repeater, plus transform, layer3d, camera3d (on a camera clip; use set_camera), model3d and showcase. Call describe_effect with a type for its parameters, their ranges and what they do before setting anything but the obvious. An unknown name comes back with the full list."
+          description: "Effect type: blur, invert, hue, saturation, brightness, contrast, exposure, grayscale, sepia, gradientMap, vignette, filmGrain, flicker, posterizeTime, lensDistortion, chromaticAberration, lensFlare, liquidGlass, opacityFx, colorCorrection, depthMap, depthParticles, gradientMap, vegas, glow, pixelDissolve, motionBlur, dropShadow, reflection, colorama, outline, echo, flutedGlass, lightRays, halftone, datamosh, roughenEdges, filmStock, halation, starGlow, filmDamage, lightLeak, thermal, colorBalance, duotone, levels, monochrome, channelMixer, dither, threshold, fourColorGradient, lensBlur, boxBlur, directionalBlur, spinBlur, zoomBlur, sharpen, cameraShake, bulge, twirl, ripple, waveWarp, polarCoords, turbulentDisplace, elasticGrid, gridSplit, cubify, glitch, vhs, ntsc, crtScreen, ledScreen, rgbSplit, jpegGlitch, ascii, macpaint, modulation, stripe, risograph, emboss, bevel, inkBleed, paperTexture, paperCutout, crossHatch, scatter, blobTracker, edgeGlow, pageTurn, lightSweep, deepGlow, twister, fill, compositeOriginal, grid, repeater, plus transform, cornerPin (AE Corner Pin: perspective quad from four corners), layer3d, camera3d (on a camera clip; use set_camera), model3d and showcase. Call describe_effect with a type for its parameters, their ranges and what they do before setting anything but the obvious. An unknown name comes back with the full list."
         },
         params: {
           type: "object",
@@ -21284,7 +21293,7 @@ var BASE_TOOLS = [
         clipId: CLIP_ID,
         preset: {
           type: "string",
-          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)."
+          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), custom (After Effects' text animator: each unit eases from `from` to rest on `ease` \u2014 use it for colour sweeps, blur-in with tracking, any look the presets don't have)."
         },
         unit: { type: "string", enum: ["letter", "word", "line"], description: "What the animation steps through." },
         durationIn: num("Seconds for one unit's entrance to complete. 0 cuts each unit on."),
@@ -21302,6 +21311,12 @@ var BASE_TOOLS = [
         },
         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."),
+        from: {
+          type: "object",
+          description: `custom preset: what each unit starts from, easing to the text's own rest values. opacity (0..1), x, y (px @1080p, y positive is below), scale (1 = rest), rotation (degrees), blur (px @1080p), tracking (extra px between units, closing up \u2014 letters converge), color (start colour fading to the text's own fill, e.g. light blue to navy: color "#9fd0ff" on navy text). Default { opacity: 0, y: 30, blur: 8 }.`,
+          properties: { opacity: { type: "number" }, x: { type: "number" }, y: { type: "number" }, scale: { type: "number" }, rotation: { type: "number" }, blur: { type: "number" }, tracking: { type: "number" }, color: { type: "string" } }
+        },
+        ease: { type: "array", items: { type: "number" }, description: "custom preset: cubic-bezier [x1, y1, x2, y2] for each unit. Default [0.22, 1, 0.36, 1] (ease-out)." },
         remove: bool("Take the animation off, leaving the text to cut on."),
         exit: {
           type: ["object", "null"],
@@ -21312,7 +21327,9 @@ var BASE_TOOLS = [
             stagger: num("Seconds between units leaving. Defaults to the preset's."),
             order: { type: "string", enum: ["forward", "reverse", "center", "edges", "random"], description: "Which unit leaves first. forward: the first word goes first. Defaults to reverse for typewriter exits (backspace), reading order otherwise." },
             distance: num("Travel in px @1080p for the moving presets."),
-            seed: num("Seed for random order.")
+            seed: num("Seed for random order."),
+            from: { type: "object", description: "custom exit: what each unit ends on (same keys as from)." },
+            ease: { type: "array", items: { type: "number" }, description: "custom exit: cubic-bezier for each unit." }
           }
         }
       },
@@ -22431,6 +22448,9 @@ function withRunProject(stepArgs, projectId) {
 }
 function withRunSequence(stepArgs, sequenceId, tool) {
   if (typeof sequenceId !== "string" || !sequenceId || typeof stepArgs.expectedSequenceId === "string") return stepArgs;
+  if (tool?.name === "update_sequence") {
+    return typeof stepArgs.sequenceId === "string" ? stepArgs : { ...stepArgs, sequenceId };
+  }
   if (!tool || !("expectedSequenceId" in (tool.inputSchema.properties ?? {}))) return stepArgs;
   return { ...stepArgs, expectedSequenceId: sequenceId };
 }

package/package.json

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