goatedit-mcp 1.1.21 → 1.1.23

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"]
     },
@@ -20412,7 +20413,7 @@ var BASE_TOOLS = [
   },
   {
     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.",
+    description: "Change a shape after it was made \u2014 fill, size, position, length, corners, outline, and a dashed or rounded outline \u2014 without deleting it and losing its id, keyframes and effects.",
     inputSchema: {
       type: "object",
       properties: {
@@ -20432,7 +20433,10 @@ var BASE_TOOLS = [
         closed: bool("Path shapes: join the last anchor back to the first."),
         trimStart: num("Path shapes: where along the path drawing starts, 0..1. Keyframe it as pathTrimStart."),
         trimEnd: num("Path shapes: where drawing stops, 0..1. 0 hides the path; keyframing pathTrimEnd 0 to 1 with set_keyframes draws it on."),
-        trimOffset: num("Path shapes: slides the drawn stretch along the path, degrees.")
+        trimOffset: num("Path shapes: slides the drawn stretch along the path, degrees."),
+        x: num("Centre across the frame, 0..1 (sets posX; keyframes on posX still win)."),
+        y: num("Centre down the frame, 0..1 (sets posY)."),
+        duration: num("New length in seconds, from the same start. Refused if it would run into the next clip on the track.")
       },
       required: ["clipId"]
     },
@@ -20505,7 +20509,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 +20531,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 +21060,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 +21133,8 @@ var BASE_TOOLS = [
         prop: {
           type: "string",
           enum: [
+            "scale",
+            "position",
             "opacity",
             "volume",
             "posX",
@@ -21158,7 +21169,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 +21177,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 +21196,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 +21296,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 +21314,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 +21330,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." }
           }
         }
       },
@@ -21417,7 +21437,8 @@ var BASE_TOOLS = [
         height: num("Render height in pixels. Defaults to the preset's, or the project height."),
         posX: num("Horizontal centre as a fraction of the frame, 0..1. 0.5 is centre."),
         posY: num("Vertical centre as a fraction of the frame, 0..1. 0.5 is centre."),
-        scale: num("Uniform scale, 1 being unchanged."),
+        scale: num('Uniform scale, 1 being unchanged. With size "native", a multiplier on the native size.'),
+        size: str(`"fit" (default): like any picture, the width x height box is fitted inside the frame, so a 600x200 card fills the frame width. "native": one authored px is one frame px, so a 600x200 card is 600x200 on screen. Use native for UI pieces authored at their real size. The result's onScreen gives the box in frame px either way.`),
         opacity: num("Opacity, 0..1. Defaults to 1."),
         name: str("Display name for the clip and its bin entry.")
       },
@@ -21607,10 +21628,11 @@ var BASE_TOOLS = [
       type: "object",
       properties: {
         clipId: CLIP_ID,
-        newStartTime: num("New timeline start time in seconds."),
+        startTime: num("New timeline start time in seconds."),
+        newStartTime: num("Same as startTime (older name)."),
         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"]
+      required: ["clipId"]
     },
     method: "moveClip"
   },
@@ -22431,6 +22453,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 };
 }
@@ -25699,6 +25724,42 @@ async function importLocalFile(args, target) {
     );
   }
 }
+var RUN_STEP_COMMON_ARGS = /* @__PURE__ */ new Set(["projectId", "expectedSequenceId", "opId"]);
+function preflightSteps(calls) {
+  const errors = [], warnings = [];
+  calls.forEach((raw, i) => {
+    const step = raw;
+    const n = i + 1;
+    const tool = typeof step?.tool === "string" ? step.tool : "";
+    if (!tool) {
+      errors.push(`step ${n}: no tool name.`);
+      return;
+    }
+    if (tool === "run_tools") {
+      errors.push(`step ${n}: run_tools cannot be nested.`);
+      return;
+    }
+    const def = BROWSER_TOOLS_BY_NAME.get(tool);
+    if (!def) return;
+    const args = step.args && typeof step.args === "object" ? step.args : {};
+    const props = def.inputSchema?.properties ?? {};
+    for (const key of def.inputSchema?.required ?? []) {
+      if (args[key] === void 0) errors.push(`step ${n} (${tool}): missing required "${key}".`);
+    }
+    for (const [key, value] of Object.entries(args)) {
+      const spec = props[key];
+      if (!spec) {
+        if (!RUN_STEP_COMMON_ARGS.has(key)) warnings.push(`step ${n} (${tool}): "${key}" is not an argument of ${tool} and is ignored. It takes: ${Object.keys(props).join(", ")}.`);
+        continue;
+      }
+      if (typeof value === "string" && value.startsWith("$")) continue;
+      const want = spec.type;
+      const ok = !want || value === null || (want === "number" || want === "integer" ? typeof value === "number" : want === "string" ? typeof value === "string" : want === "boolean" ? typeof value === "boolean" : want === "array" ? Array.isArray(value) : want === "object" ? typeof value === "object" && !Array.isArray(value) : true);
+      if (!ok) errors.push(`step ${n} (${tool}): "${key}" should be ${want}, got ${Array.isArray(value) ? "array" : typeof value}.`);
+    }
+  });
+  return { errors, warnings };
+}
 async function runTools(args) {
   const calls = args.calls;
   if (!Array.isArray(calls) || !calls.length) {
@@ -25707,6 +25768,16 @@ async function runTools(args) {
   if (args.rollback && args.continueOnError) {
     throw new McpError(ErrorCode.InvalidParams, "rollback and continueOnError cannot be combined: a run that keeps going after a failure has nothing to roll back to.");
   }
+  const check = preflightSteps(calls);
+  if (check.errors.length) {
+    return {
+      ok: false,
+      ran: 0,
+      errors: check.errors,
+      note: "Nothing ran: fix these and send the run again.",
+      ...check.warnings.length ? { warnings: check.warnings } : {}
+    };
+  }
   const results = [];
   const images = [];
   const refs = /* @__PURE__ */ new Map();
@@ -25761,6 +25832,8 @@ async function runTools(args) {
   return {
     ok: failed === 0,
     results,
+    ...check.warnings.length ? { warnings: check.warnings } : {},
+    ...failed && !args.continueOnError && !args.rollback ? { hint: "One failing step skips the rest. Pass continueOnError: true to run the other steps anyway." } : {},
     ...failed && runOpId ? { opId: runOpId, retry: `Repeat this run_tools call with opId "${runOpId}": finished steps answer from the tab without running again.` } : {},
     ...rolledBack !== void 0 ? { rolledBack } : {},
     ...images.length ? { _images: images } : {}

package/package.json

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