goatedit-mcp 1.1.23 → 1.1.25

package/bundle/goatedit-mcp.js

@@ -20208,7 +20208,8 @@ var BASE_TOOLS = [
         detail: { type: "string", enum: ["lean", "full"], description: "lean (default) or full, which adds effect parameters and every field." },
         trackId: str("Only this track."),
         from: num("Only clips that end after this time, in seconds."),
-        to: num("Only clips that start before this time, in seconds.")
+        to: num("Only clips that start before this time, in seconds."),
+        clipIds: { type: "array", items: { type: "string" }, description: 'Only these clips. Every filter applies to detail "full" too, so full detail for a few clips stays small.' }
       }
     },
     method: "getTimeline"
@@ -20219,10 +20220,10 @@ var BASE_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
+        clipId: str("One clip id. Use clipIds for several."),
         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"]
+      }
     },
     method: "getClips"
   },
@@ -20250,8 +20251,16 @@ var BASE_TOOLS = [
   },
   {
     name: "get_media_bin",
-    description: "List every media file imported into the project, with id, name, type and duration.",
-    inputSchema: { type: "object", properties: {} },
+    description: 'List the media files imported into the project. A bin of 40 files or fewer, asked with no filter, comes back whole. A bigger one, or any filtered ask, comes back as one short row per file (id, name, type, duration, size, status) under { total, matched, files }; narrow it with name, type or ids, and pass detail: "full" for whole records. To see what a file looks like, use preview_media.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: str("Only files whose name contains this (any case)."),
+        type: { type: "string", description: "Only this type: video, audio, image, html, lottie, model3d, showcase, text." },
+        ids: { type: "array", items: { type: "string" }, description: "Only these file ids." },
+        detail: { type: "string", enum: ["lean", "full"], description: "full: whole records for the files matched." }
+      }
+    },
     method: "getMediaFiles"
   },
   {
@@ -21177,6 +21186,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."),
+        offset: { description: 'With prop "position" or "scale" and no keyframes: move the animation as it is. Every existing key of both halves is shifted ([dx, dy] added to position) or scaled (a number or [sx, sy] multiplying scale), times and eases kept; a track with no keys has its resting value moved instead. The way to nudge an animated layer or a whole pile without rewriting its keys.' },
         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",
@@ -21196,7 +21206,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, 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."
+          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, fractalNoise, 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",
@@ -21438,7 +21448,8 @@ var BASE_TOOLS = [
         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. 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.`),
+        rotation: num("Rotation in degrees."),
+        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. The clip's stored scale stays relative to the fitted box (onScreen.nativeScale is native size), so set_clip_transform and scale keys later take that number, not 1; set_clip_transform on an html clip replies with onScreen too.`),
         opacity: num("Opacity, 0..1. Defaults to 1."),
         name: str("Display name for the clip and its bin entry.")
       },
@@ -21448,12 +21459,17 @@ var BASE_TOOLS = [
   },
   {
     name: "update_html_clip",
-    description: "Change an HTML clip made with create_html_clip in place: new markup, some of its --custom-property `vars`, its `slots`, or its render size. The clip keeps its id, position, keyframes, parent and effects \u2014 revise a snippet with this, never by removing and re-creating it. `vars` and `slots` merge over the current values, so pass only what changes. New `html` clears slot overrides (slot ids are element order) unless `slots` is given in the same call. Every clip playing the same snippet changes with it; the reply says how many.",
+    description: "Change an HTML clip made with create_html_clip in place: new markup (or a find-and-replace patch on it), some of its --custom-property `vars`, its `slots`, or its render size. The clip keeps its id, position, keyframes, parent and effects \u2014 revise a snippet with this, never by removing and re-creating it. `vars` and `slots` merge over the current values, so pass only what changes. New `html` clears slot overrides (slot ids are element order) unless `slots` is given in the same call. Every clip playing the same snippet changes with it; the reply says how many.",
     inputSchema: {
       type: "object",
       properties: {
         clipId: str("The HTML clip."),
         html: str("Replacement markup, with its <style> inline."),
+        replace: {
+          type: "array",
+          description: "Patch the current markup instead of resending it: [{ find, with, all? }], exact text, applied in order. Each find must appear once unless all: true. Read the markup with get_clip includeHtml: true. Not with html.",
+          items: { type: "object", properties: { find: { type: "string" }, with: { type: "string" }, all: { type: "boolean" } }, required: ["find", "with"] }
+        },
         vars: { type: "object", description: 'CSS custom properties to change, e.g. { "--accent": "#ff5a1f" }. Merged over the current ones.' },
         slots: { type: "object", description: "Slot fills to change, keyed by slot id, as in create_html_clip. Merged over the current ones." },
         width: num("New render width in pixels."),
@@ -25694,6 +25710,13 @@ async function callTool(name, args) {
   }
   if (name === "import_local_file") return withOpIdHint(importLocalFile(forwarded, target), forwarded.opId);
   const result = await withOpIdHint(sendToBrowser(tool.method, forwarded, target), forwarded.opId);
+  if (!projectId && target && !READ_ONLY_TOOLS.has(tool.name) && result && typeof result === "object" && !Array.isArray(result)) {
+    const open = connectedProjects();
+    if (open.length > 1) {
+      const landed = open.find((p) => p.projectId === target);
+      result.routedTo = `${landed?.name ?? "untitled"} (${target}), the use_project default. ${open.length} projects are open; pass projectId if you meant another.`;
+    }
+  }
   const withFile = saveFileToDisk(result);
   return saveToDisk ? saveFramesToDisk(withFile, name) : withFile;
 }

package/package.json

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