goatedit-mcp 1.1.2 → 1.1.3

package/bundle/goatedit-mcp.js

@@ -19254,6 +19254,12 @@ var BASE_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."
@@ -19297,7 +19303,7 @@ var BASE_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"
   },
@@ -19693,6 +19699,101 @@ var BASE_TOOLS = [
     },
     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.",
@@ -19890,10 +19991,17 @@ var BASE_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."),
@@ -20706,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.2",
+  "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",