Skip to main content
Glama

Edit Pipeline

pipeline
Destructive

Run several edits (trim, crop, scale, speed, cut_idle, redact, callout, keystroke_overlay, cursor, reframe, zoom, backdrop, audio, burn_subtitles, then optionally export_preset or export_gif) in one ffmpeg pass: one re-encode, no…

Instructions

Run several edits (trim, crop, scale, speed, cut_idle, redact, callout, keystroke_overlay, cursor, reframe, zoom, backdrop, audio, burn_subtitles, then optionally export_preset or export_gif) in one ffmpeg pass: one re-encode, no intermediate files. Prefer it over chaining edit tools; a recipe does the usual polish in one call.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "pipeline"
  }
}

Input Schema

NameRequiredDescriptionDefault
inputNoPath to the source video.
stepsNoEdits in order, each { op, ...its tool's options }; export_preset/export_gif only last. Times and pixels are relative to the video as it is at that step (after earlier trims, speed, crops). zoom follow:"clicks" plans from the event log; burn_subtitles takes subtitles or transcribe:true.
dryRunNoReturn the plan (ffmpeg command, output size) without running it.
outputNoOptional output path. Defaults under SCREENCAST_HOME/edits.
recipeNoPolish preset expanded to steps (see dryRun): pr_demo = cut_idle, click zoom, GIF <=10 MB; tutorial = + audio, captions, 1080p mp4; social_reel = 9:16, big captions. Given steps replace its same-op step; trim, redact, crop and cursor go first (source pixels and time).
qualityNoEncoder preset for an mp4 result (default standard).
chaptersNoKeep the input's markers as chapters, re-timed through trims and speed.
fromEditNoRe-render an .edit.json; steps replace same-op steps.
overwriteNoAllow replacing an existing file at the output path (default false).

Output Schema

NameRequiredDescriptionDefault
stepsYes
processesYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changedv0.51.1
    • addedInput schema / properties / fromEdit
      Added value: +{
      +  "description": "Re-render an .edit.json; steps replace same-op steps.",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • changedInput schema / properties / steps / items / oneOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "duration": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "end": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "trim",
      -        "type": "string"
      -      },
      -      "start": {
      -        "minimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "start"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "height": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "op": {
      -        "const": "crop",
      -        "type": "string"
      -      },
      -      "width": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "x": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "y": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "x",
      -      "y",
      -      "width",
      -      "height"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "height": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "op": {
      -        "const": "scale",
      -        "type": "string"
      -      },
      -      "width": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "factor": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "speed",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "factor"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "color": {
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "redact",
      -        "type": "string"
      -      },
      -      "pad": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "regions": {
      -        "items": {
      -          "properties": {
      -            "end": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "height": {
      -              "exclusiveMinimum": 0,
      -              "maximum": 9007199254740991,
      -              "type": "integer"
      -            },
      -            "start": {
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            "width": {
      -              "exclusiveMinimum": 0,
      -              "maximum": 9007199254740991,
      -              "type": "integer"
      -            },
      -            "x": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "y": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "x",
      -            "y",
      -            "width",
      -            "height"
      -          ],
      -          "type": "object"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "style": {
      -        "enum": [
      -          "box",
      -          "blur",
      -          "pixelate"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "regions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "fontFile": {
      -        "description": "Font: a .ttf/.otf/.ttc path or a C:\\Windows\\Fonts file name. Default: bundled Inter, with a covering system font for scripts it lacks (CJK, emoji, Arabic, ...).",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "items": {
      -        "items": {
      -          "oneOf": [
      -            {
      -              "properties": {
      -                "color": {
      -                  "type": "string"
      -                },
      -                "fill": {
      -                  "description": "Fill instead of outline.",
      -                  "type": "boolean"
      -                },
      -                "from": {
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                "height": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "thickness": {
      -                  "description": "Outline px (default 4).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "to": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "box",
      -                  "type": "string"
      -                },
      -                "width": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "x": {
      -                  "type": "number"
      -                },
      -                "y": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "x",
      -                "y",
      -                "width",
      -                "height"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "background": {
      -                  "description": "Dark panel behind the text (default true).",
      -                  "type": "boolean"
      -                },
      -                "color": {
      -                  "type": "string"
      -                },
      -                "from": {
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                "size": {
      -                  "description": "Font size px (default 32).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "text": {
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "to": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "text",
      -                  "type": "string"
      -                },
      -                "x": {
      -                  "type": "number"
      -                },
      -                "y": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "x",
      -                "y",
      -                "text"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "color": {
      -                  "type": "string"
      -                },
      -                "from": {
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                "thickness": {
      -                  "description": "Shaft px (default 8).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "to": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "arrow",
      -                  "type": "string"
      -                },
      -                "x1": {
      -                  "type": "number"
      -                },
      -                "x2": {
      -                  "description": "Head (x2,y2) is the point the arrow points at.",
      -                  "type": "number"
      -                },
      -                "y1": {
      -                  "type": "number"
      -                },
      -                "y2": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "x1",
      -                "y1",
      -                "x2",
      -                "y2"
      -              ],
      -              "type": "object"
      -            }
      -          ]
      -        },
      -        "maxItems": 50,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "op": {
      -        "const": "callout",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "items"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "aspect": {
      -        "enum": [
      -          "16:9",
      -          "9:16",
      -          "1:1",
      -          "4:5"
      -        ],
      -        "type": "string"
      -      },
      -      "fit": {
      -        "enum": [
      -          "pad",
      -          "crop"
      -        ],
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "reframe",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "aspect"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "follow": {
      -        "const": "clicks",
      -        "type": "string"
      -      },
      -      "holdSec": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 30,
      -        "type": "number"
      -      },
      -      "keyframes": {
      -        "items": {
      -          "properties": {
      -            "full": {
      -              "type": "boolean"
      -            },
      -            "height": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "t": {
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            "width": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "x": {
      -              "type": "number"
      -            },
      -            "y": {
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "t"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 100,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "maxZoom": {
      -        "maximum": 6,
      -        "minimum": 1,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "zoom",
      -        "type": "string"
      -      },
      -      "transitionSec": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 5,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "keepSec": {
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "minIdleSec": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "cut_idle",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "denoise": {
      -        "enum": [
      -          "light",
      -          "medium",
      -          "strong"
      -        ],
      -        "type": "string"
      -      },
      -      "normalize": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "youtube",
      -              "podcast",
      -              "broadcast"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "maximum": -5,
      -            "minimum": -70,
      -            "type": "number"
      -          }
      -        ]
      -      },
      -      "op": {
      -        "const": "audio",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "op": {
      -        "const": "burn_subtitles",
      -        "type": "string"
      -      },
      -      "style": {
      -        "enum": [
      -          "clean",
      -          "social"
      -        ],
      -        "type": "string"
      -      },
      -      "subtitles": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "transcribe": {
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "aspect": {
      -        "enum": [
      -          "16:9",
      -          "9:16",
      -          "1:1",
      -          "4:5"
      -        ],
      -        "type": "string"
      -      },
      -      "colors": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "maxItems": 4,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "image": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "backdrop",
      -        "type": "string"
      -      },
      -      "padding": {
      -        "maximum": 2000,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "preset": {
      -        "enum": [
      -          "desktop",
      -          "rec",
      -          "amber",
      -          "light"
      -        ],
      -        "type": "string"
      -      },
      -      "radius": {
      -        "maximum": 1000,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "shadow": {
      -        "maximum": 200,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "shadowOpacity": {
      -        "maximum": 1,
      -        "minimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "clicks": {
      -        "type": "boolean"
      -      },
      -      "color": {
      -        "type": "string"
      -      },
      -      "events": {
      -        "type": "string"
      -      },
      -      "fontFile": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "keys": {
      -        "enum": [
      -          "shortcuts",
      -          "masked"
      -        ],
      -        "type": "string"
      -      },
      -      "lingerSec": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 10,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "keystroke_overlay",
      -        "type": "string"
      -      },
      -      "position": {
      -        "enum": [
      -          "bottom",
      -          "bottom-left",
      -          "bottom-right",
      -          "top",
      -          "top-left",
      -          "top-right"
      -        ],
      -        "type": "string"
      -      },
      -      "size": {
      -        "maximum": 400,
      -        "minimum": 8,
      -        "type": "number"
      -      },
      -      "typing": {
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "clicks": {
      -        "type": "boolean"
      -      },
      -      "events": {
      -        "type": "string"
      -      },
      -      "hideAfterSec": {
      -        "maximum": 600,
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "cursor",
      -        "type": "string"
      -      },
      -      "size": {
      -        "maximum": 8,
      -        "minimum": 0.25,
      -        "type": "number"
      -      },
      -      "smoothing": {
      -        "maximum": 1,
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "spotlight": {
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "fit": {
      -        "enum": [
      -          "pad",
      -          "crop"
      -        ],
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "export_preset",
      -        "type": "string"
      -      },
      -      "platform": {
      -        "enum": [
      -          "youtube",
      -          "instagram_reel",
      -          "tiktok",
      -          "x",
      -          "square",
      -          "steam_trailer",
      -          "vertical_reel"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "platform"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "format": {
      -        "enum": [
      -          "gif",
      -          "webp"
      -        ],
      -        "type": "string"
      -      },
      -      "fps": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 30,
      -        "type": "number"
      -      },
      -      "maxBytes": {
      -        "maximum": 9007199254740991,
      -        "minimum": 10000,
      -        "type": "integer"
      -      },
      -      "op": {
      -        "const": "export_gif",
      -        "type": "string"
      -      },
      -      "width": {
      -        "maximum": 1920,
      -        "minimum": 64,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "duration": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "end": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "trim",
      +        "type": "string"
      +      },
      +      "start": {
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "start"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "height": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "op": {
      +        "const": "crop",
      +        "type": "string"
      +      },
      +      "width": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "x": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "y": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "x",
      +      "y",
      +      "width",
      +      "height"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "height": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "op": {
      +        "const": "scale",
      +        "type": "string"
      +      },
      +      "width": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "factor": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "speed",
      +        "type": "string"
      +      },
      +      "segments": {
      +        "items": {
      +          "properties": {
      +            "end": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "factor": {
      +              "exclusiveMinimum": 1,
      +              "maximum": 100,
      +              "type": "number"
      +            },
      +            "start": {
      +              "minimum": 0,
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "start",
      +            "end",
      +            "factor"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "color": {
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "redact",
      +        "type": "string"
      +      },
      +      "pad": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "regions": {
      +        "items": {
      +          "properties": {
      +            "end": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "height": {
      +              "exclusiveMinimum": 0,
      +              "maximum": 9007199254740991,
      +              "type": "integer"
      +            },
      +            "start": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "width": {
      +              "exclusiveMinimum": 0,
      +              "maximum": 9007199254740991,
      +              "type": "integer"
      +            },
      +            "x": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "y": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "x",
      +            "y",
      +            "width",
      +            "height"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "style": {
      +        "enum": [
      +          "box",
      +          "blur",
      +          "pixelate"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "regions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "fontFile": {
      +        "description": "Font: a .ttf/.otf/.ttc path or a C:\\Windows\\Fonts file name. Default: bundled Inter, with a covering system font for scripts it lacks (CJK, emoji, Arabic, ...).",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "items": {
      +        "items": {
      +          "oneOf": [
      +            {
      +              "properties": {
      +                "color": {
      +                  "type": "string"
      +                },
      +                "fill": {
      +                  "description": "Fill instead of outline.",
      +                  "type": "boolean"
      +                },
      +                "from": {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                "height": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "thickness": {
      +                  "description": "Outline px (default 4).",
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "to": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "box",
      +                  "type": "string"
      +                },
      +                "width": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "x": {
      +                  "type": "number"
      +                },
      +                "y": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "x",
      +                "y",
      +                "width",
      +                "height"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "background": {
      +                  "description": "Dark panel behind the text (default true).",
      +                  "type": "boolean"
      +                },
      +                "color": {
      +                  "type": "string"
      +                },
      +                "from": {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                "size": {
      +                  "description": "Font size px (default 32).",
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "text": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "to": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "text",
      +                  "type": "string"
      +                },
      +                "x": {
      +                  "type": "number"
      +                },
      +                "y": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "x",
      +                "y",
      +                "text"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "color": {
      +                  "type": "string"
      +                },
      +                "from": {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                "thickness": {
      +                  "description": "Shaft px (default 8).",
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "to": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "arrow",
      +                  "type": "string"
      +                },
      +                "x1": {
      +                  "type": "number"
      +                },
      +                "x2": {
      +                  "description": "Head (x2,y2) is the point the arrow points at.",
      +                  "type": "number"
      +                },
      +                "y1": {
      +                  "type": "number"
      +                },
      +                "y2": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "x1",
      +                "y1",
      +                "x2",
      +                "y2"
      +              ],
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "maxItems": 50,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "op": {
      +        "const": "callout",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "items"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "aspect": {
      +        "enum": [
      +          "16:9",
      +          "9:16",
      +          "1:1",
      +          "4:5"
      +        ],
      +        "type": "string"
      +      },
      +      "fit": {
      +        "enum": [
      +          "pad",
      +          "crop"
      +        ],
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "reframe",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "aspect"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "follow": {
      +        "const": "clicks",
      +        "type": "string"
      +      },
      +      "holdSec": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 30,
      +        "type": "number"
      +      },
      +      "keyframes": {
      +        "items": {
      +          "properties": {
      +            "full": {
      +              "type": "boolean"
      +            },
      +            "height": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "t": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "width": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "x": {
      +              "type": "number"
      +            },
      +            "y": {
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "t"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 100,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "maxZoom": {
      +        "maximum": 6,
      +        "minimum": 1,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "zoom",
      +        "type": "string"
      +      },
      +      "transitionSec": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 5,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "action": {
      +        "enum": [
      +          "cut",
      +          "speed"
      +        ],
      +        "type": "string"
      +      },
      +      "factor": {
      +        "exclusiveMinimum": 1,
      +        "maximum": 100,
      +        "type": "number"
      +      },
      +      "keepSec": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "minIdleSec": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "cut_idle",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "denoise": {
      +        "enum": [
      +          "light",
      +          "medium",
      +          "strong"
      +        ],
      +        "type": "string"
      +      },
      +      "normalize": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "youtube",
      +              "podcast",
      +              "broadcast"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "maximum": -5,
      +            "minimum": -70,
      +            "type": "number"
      +          }
      +        ]
      +      },
      +      "op": {
      +        "const": "audio",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "op": {
      +        "const": "burn_subtitles",
      +        "type": "string"
      +      },
      +      "style": {
      +        "enum": [
      +          "clean",
      +          "social"
      +        ],
      +        "type": "string"
      +      },
      +      "subtitles": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "transcribe": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "aspect": {
      +        "enum": [
      +          "16:9",
      +          "9:16",
      +          "1:1",
      +          "4:5"
      +        ],
      +        "type": "string"
      +      },
      +      "colors": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "maxItems": 4,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "image": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "backdrop",
      +        "type": "string"
      +      },
      +      "padding": {
      +        "maximum": 2000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "preset": {
      +        "enum": [
      +          "desktop",
      +          "rec",
      +          "amber",
      +          "light"
      +        ],
      +        "type": "string"
      +      },
      +      "radius": {
      +        "maximum": 1000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "shadow": {
      +        "maximum": 200,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "shadowOpacity": {
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "clicks": {
      +        "type": "boolean"
      +      },
      +      "color": {
      +        "type": "string"
      +      },
      +      "events": {
      +        "type": "string"
      +      },
      +      "fontFile": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "keys": {
      +        "enum": [
      +          "shortcuts",
      +          "masked"
      +        ],
      +        "type": "string"
      +      },
      +      "lingerSec": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 10,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "keystroke_overlay",
      +        "type": "string"
      +      },
      +      "position": {
      +        "enum": [
      +          "bottom",
      +          "bottom-left",
      +          "bottom-right",
      +          "top",
      +          "top-left",
      +          "top-right"
      +        ],
      +        "type": "string"
      +      },
      +      "size": {
      +        "maximum": 400,
      +        "minimum": 8,
      +        "type": "number"
      +      },
      +      "typing": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "clicks": {
      +        "type": "boolean"
      +      },
      +      "events": {
      +        "type": "string"
      +      },
      +      "hideAfterSec": {
      +        "maximum": 600,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "cursor",
      +        "type": "string"
      +      },
      +      "size": {
      +        "maximum": 8,
      +        "minimum": 0.25,
      +        "type": "number"
      +      },
      +      "smoothing": {
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "spotlight": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "fit": {
      +        "enum": [
      +          "pad",
      +          "crop"
      +        ],
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "export_preset",
      +        "type": "string"
      +      },
      +      "platform": {
      +        "enum": [
      +          "youtube",
      +          "instagram_reel",
      +          "tiktok",
      +          "x",
      +          "square",
      +          "steam_trailer",
      +          "vertical_reel"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "platform"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "format": {
      +        "enum": [
      +          "gif",
      +          "webp"
      +        ],
      +        "type": "string"
      +      },
      +      "fps": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 30,
      +        "type": "number"
      +      },
      +      "maxBytes": {
      +        "maximum": 9007199254740991,
      +        "minimum": 10000,
      +        "type": "integer"
      +      },
      +      "op": {
      +        "const": "export_gif",
      +        "type": "string"
      +      },
      +      "width": {
      +        "maximum": 1920,
      +        "minimum": 64,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedInput schema / required
      Removed value: -[
      -  "input"
      -]
  2. Changed1 schema field changedv0.49.1
    • changedInput schema / properties / steps / items / oneOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "duration": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "end": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "trim",
      -        "type": "string"
      -      },
      -      "start": {
      -        "minimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "start"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "height": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "op": {
      -        "const": "crop",
      -        "type": "string"
      -      },
      -      "width": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "x": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "y": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "x",
      -      "y",
      -      "width",
      -      "height"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "height": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "op": {
      -        "const": "scale",
      -        "type": "string"
      -      },
      -      "width": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "factor": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "speed",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "factor"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "color": {
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "redact",
      -        "type": "string"
      -      },
      -      "pad": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "regions": {
      -        "items": {
      -          "properties": {
      -            "end": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "height": {
      -              "exclusiveMinimum": 0,
      -              "maximum": 9007199254740991,
      -              "type": "integer"
      -            },
      -            "start": {
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            "width": {
      -              "exclusiveMinimum": 0,
      -              "maximum": 9007199254740991,
      -              "type": "integer"
      -            },
      -            "x": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "y": {
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "x",
      -            "y",
      -            "width",
      -            "height"
      -          ],
      -          "type": "object"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "style": {
      -        "enum": [
      -          "box",
      -          "blur",
      -          "pixelate"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "regions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "fontFile": {
      -        "description": "Font: a .ttf/.otf/.ttc path or a C:\\Windows\\Fonts file name. Default: bundled Inter, with a covering system font for scripts it lacks (CJK, emoji, Arabic, ...).",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "items": {
      -        "items": {
      -          "oneOf": [
      -            {
      -              "properties": {
      -                "color": {
      -                  "type": "string"
      -                },
      -                "fill": {
      -                  "description": "Fill instead of outline.",
      -                  "type": "boolean"
      -                },
      -                "from": {
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                "height": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "thickness": {
      -                  "description": "Outline px (default 4).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "to": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "box",
      -                  "type": "string"
      -                },
      -                "width": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "x": {
      -                  "type": "number"
      -                },
      -                "y": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "x",
      -                "y",
      -                "width",
      -                "height"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "background": {
      -                  "description": "Dark panel behind the text (default true).",
      -                  "type": "boolean"
      -                },
      -                "color": {
      -                  "type": "string"
      -                },
      -                "from": {
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                "size": {
      -                  "description": "Font size px (default 32).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "text": {
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "to": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "text",
      -                  "type": "string"
      -                },
      -                "x": {
      -                  "type": "number"
      -                },
      -                "y": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "x",
      -                "y",
      -                "text"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "color": {
      -                  "type": "string"
      -                },
      -                "from": {
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                "thickness": {
      -                  "description": "Shaft px (default 8).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "to": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "arrow",
      -                  "type": "string"
      -                },
      -                "x1": {
      -                  "type": "number"
      -                },
      -                "x2": {
      -                  "description": "Head (x2,y2) is the point the arrow points at.",
      -                  "type": "number"
      -                },
      -                "y1": {
      -                  "type": "number"
      -                },
      -                "y2": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "x1",
      -                "y1",
      -                "x2",
      -                "y2"
      -              ],
      -              "type": "object"
      -            }
      -          ]
      -        },
      -        "maxItems": 50,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "op": {
      -        "const": "callout",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "items"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "aspect": {
      -        "enum": [
      -          "16:9",
      -          "9:16",
      -          "1:1",
      -          "4:5"
      -        ],
      -        "type": "string"
      -      },
      -      "fit": {
      -        "enum": [
      -          "pad",
      -          "crop"
      -        ],
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "reframe",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "aspect"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "follow": {
      -        "const": "clicks",
      -        "type": "string"
      -      },
      -      "holdSec": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 30,
      -        "type": "number"
      -      },
      -      "keyframes": {
      -        "items": {
      -          "properties": {
      -            "full": {
      -              "type": "boolean"
      -            },
      -            "height": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "t": {
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            "width": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "x": {
      -              "type": "number"
      -            },
      -            "y": {
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "t"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 100,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "maxZoom": {
      -        "maximum": 6,
      -        "minimum": 1,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "zoom",
      -        "type": "string"
      -      },
      -      "transitionSec": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 5,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "keepSec": {
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "minIdleSec": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "cut_idle",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "denoise": {
      -        "enum": [
      -          "light",
      -          "medium",
      -          "strong"
      -        ],
      -        "type": "string"
      -      },
      -      "normalize": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "youtube",
      -              "podcast",
      -              "broadcast"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "maximum": -5,
      -            "minimum": -70,
      -            "type": "number"
      -          }
      -        ]
      -      },
      -      "op": {
      -        "const": "audio",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "op": {
      -        "const": "burn_subtitles",
      -        "type": "string"
      -      },
      -      "style": {
      -        "enum": [
      -          "clean",
      -          "social"
      -        ],
      -        "type": "string"
      -      },
      -      "subtitles": {
      -        "type": "string"
      -      },
      -      "transcribe": {
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "aspect": {
      -        "enum": [
      -          "16:9",
      -          "9:16",
      -          "1:1",
      -          "4:5"
      -        ],
      -        "type": "string"
      -      },
      -      "colors": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "maxItems": 4,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "image": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "backdrop",
      -        "type": "string"
      -      },
      -      "padding": {
      -        "maximum": 2000,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "preset": {
      -        "enum": [
      -          "desktop",
      -          "rec",
      -          "amber",
      -          "light"
      -        ],
      -        "type": "string"
      -      },
      -      "radius": {
      -        "maximum": 1000,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "shadow": {
      -        "maximum": 200,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "shadowOpacity": {
      -        "maximum": 1,
      -        "minimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "clicks": {
      -        "type": "boolean"
      -      },
      -      "color": {
      -        "type": "string"
      -      },
      -      "events": {
      -        "type": "string"
      -      },
      -      "fontFile": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "keys": {
      -        "enum": [
      -          "shortcuts",
      -          "masked"
      -        ],
      -        "type": "string"
      -      },
      -      "lingerSec": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 10,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "keystroke_overlay",
      -        "type": "string"
      -      },
      -      "position": {
      -        "enum": [
      -          "bottom",
      -          "bottom-left",
      -          "bottom-right",
      -          "top",
      -          "top-left",
      -          "top-right"
      -        ],
      -        "type": "string"
      -      },
      -      "size": {
      -        "maximum": 400,
      -        "minimum": 8,
      -        "type": "number"
      -      },
      -      "typing": {
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "clicks": {
      -        "type": "boolean"
      -      },
      -      "events": {
      -        "type": "string"
      -      },
      -      "hideAfterSec": {
      -        "maximum": 600,
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "cursor",
      -        "type": "string"
      -      },
      -      "size": {
      -        "maximum": 8,
      -        "minimum": 0.25,
      -        "type": "number"
      -      },
      -      "smoothing": {
      -        "maximum": 1,
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "spotlight": {
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "fit": {
      -        "enum": [
      -          "pad",
      -          "crop"
      -        ],
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "export_preset",
      -        "type": "string"
      -      },
      -      "platform": {
      -        "enum": [
      -          "youtube",
      -          "instagram_reel",
      -          "tiktok",
      -          "x",
      -          "square",
      -          "steam_trailer",
      -          "vertical_reel"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "platform"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "format": {
      -        "enum": [
      -          "gif",
      -          "webp"
      -        ],
      -        "type": "string"
      -      },
      -      "fps": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 30,
      -        "type": "number"
      -      },
      -      "maxBytes": {
      -        "maximum": 9007199254740991,
      -        "minimum": 10000,
      -        "type": "integer"
      -      },
      -      "op": {
      -        "const": "export_gif",
      -        "type": "string"
      -      },
      -      "width": {
      -        "maximum": 1920,
      -        "minimum": 64,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "duration": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "end": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "trim",
      +        "type": "string"
      +      },
      +      "start": {
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "start"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "height": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "op": {
      +        "const": "crop",
      +        "type": "string"
      +      },
      +      "width": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "x": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "y": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "x",
      +      "y",
      +      "width",
      +      "height"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "height": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "op": {
      +        "const": "scale",
      +        "type": "string"
      +      },
      +      "width": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "factor": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "speed",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "factor"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "color": {
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "redact",
      +        "type": "string"
      +      },
      +      "pad": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "regions": {
      +        "items": {
      +          "properties": {
      +            "end": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "height": {
      +              "exclusiveMinimum": 0,
      +              "maximum": 9007199254740991,
      +              "type": "integer"
      +            },
      +            "start": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "width": {
      +              "exclusiveMinimum": 0,
      +              "maximum": 9007199254740991,
      +              "type": "integer"
      +            },
      +            "x": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "y": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "x",
      +            "y",
      +            "width",
      +            "height"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "style": {
      +        "enum": [
      +          "box",
      +          "blur",
      +          "pixelate"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "regions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "fontFile": {
      +        "description": "Font: a .ttf/.otf/.ttc path or a C:\\Windows\\Fonts file name. Default: bundled Inter, with a covering system font for scripts it lacks (CJK, emoji, Arabic, ...).",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "items": {
      +        "items": {
      +          "oneOf": [
      +            {
      +              "properties": {
      +                "color": {
      +                  "type": "string"
      +                },
      +                "fill": {
      +                  "description": "Fill instead of outline.",
      +                  "type": "boolean"
      +                },
      +                "from": {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                "height": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "thickness": {
      +                  "description": "Outline px (default 4).",
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "to": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "box",
      +                  "type": "string"
      +                },
      +                "width": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "x": {
      +                  "type": "number"
      +                },
      +                "y": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "x",
      +                "y",
      +                "width",
      +                "height"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "background": {
      +                  "description": "Dark panel behind the text (default true).",
      +                  "type": "boolean"
      +                },
      +                "color": {
      +                  "type": "string"
      +                },
      +                "from": {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                "size": {
      +                  "description": "Font size px (default 32).",
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "text": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "to": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "text",
      +                  "type": "string"
      +                },
      +                "x": {
      +                  "type": "number"
      +                },
      +                "y": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "x",
      +                "y",
      +                "text"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "color": {
      +                  "type": "string"
      +                },
      +                "from": {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                "thickness": {
      +                  "description": "Shaft px (default 8).",
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "to": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "arrow",
      +                  "type": "string"
      +                },
      +                "x1": {
      +                  "type": "number"
      +                },
      +                "x2": {
      +                  "description": "Head (x2,y2) is the point the arrow points at.",
      +                  "type": "number"
      +                },
      +                "y1": {
      +                  "type": "number"
      +                },
      +                "y2": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "x1",
      +                "y1",
      +                "x2",
      +                "y2"
      +              ],
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "maxItems": 50,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "op": {
      +        "const": "callout",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "items"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "aspect": {
      +        "enum": [
      +          "16:9",
      +          "9:16",
      +          "1:1",
      +          "4:5"
      +        ],
      +        "type": "string"
      +      },
      +      "fit": {
      +        "enum": [
      +          "pad",
      +          "crop"
      +        ],
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "reframe",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "aspect"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "follow": {
      +        "const": "clicks",
      +        "type": "string"
      +      },
      +      "holdSec": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 30,
      +        "type": "number"
      +      },
      +      "keyframes": {
      +        "items": {
      +          "properties": {
      +            "full": {
      +              "type": "boolean"
      +            },
      +            "height": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "t": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "width": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "x": {
      +              "type": "number"
      +            },
      +            "y": {
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "t"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 100,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "maxZoom": {
      +        "maximum": 6,
      +        "minimum": 1,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "zoom",
      +        "type": "string"
      +      },
      +      "transitionSec": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 5,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "keepSec": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "minIdleSec": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "cut_idle",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "denoise": {
      +        "enum": [
      +          "light",
      +          "medium",
      +          "strong"
      +        ],
      +        "type": "string"
      +      },
      +      "normalize": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "youtube",
      +              "podcast",
      +              "broadcast"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "maximum": -5,
      +            "minimum": -70,
      +            "type": "number"
      +          }
      +        ]
      +      },
      +      "op": {
      +        "const": "audio",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "op": {
      +        "const": "burn_subtitles",
      +        "type": "string"
      +      },
      +      "style": {
      +        "enum": [
      +          "clean",
      +          "social"
      +        ],
      +        "type": "string"
      +      },
      +      "subtitles": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "transcribe": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "aspect": {
      +        "enum": [
      +          "16:9",
      +          "9:16",
      +          "1:1",
      +          "4:5"
      +        ],
      +        "type": "string"
      +      },
      +      "colors": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "maxItems": 4,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "image": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "backdrop",
      +        "type": "string"
      +      },
      +      "padding": {
      +        "maximum": 2000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "preset": {
      +        "enum": [
      +          "desktop",
      +          "rec",
      +          "amber",
      +          "light"
      +        ],
      +        "type": "string"
      +      },
      +      "radius": {
      +        "maximum": 1000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "shadow": {
      +        "maximum": 200,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "shadowOpacity": {
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "clicks": {
      +        "type": "boolean"
      +      },
      +      "color": {
      +        "type": "string"
      +      },
      +      "events": {
      +        "type": "string"
      +      },
      +      "fontFile": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "keys": {
      +        "enum": [
      +          "shortcuts",
      +          "masked"
      +        ],
      +        "type": "string"
      +      },
      +      "lingerSec": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 10,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "keystroke_overlay",
      +        "type": "string"
      +      },
      +      "position": {
      +        "enum": [
      +          "bottom",
      +          "bottom-left",
      +          "bottom-right",
      +          "top",
      +          "top-left",
      +          "top-right"
      +        ],
      +        "type": "string"
      +      },
      +      "size": {
      +        "maximum": 400,
      +        "minimum": 8,
      +        "type": "number"
      +      },
      +      "typing": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "clicks": {
      +        "type": "boolean"
      +      },
      +      "events": {
      +        "type": "string"
      +      },
      +      "hideAfterSec": {
      +        "maximum": 600,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "cursor",
      +        "type": "string"
      +      },
      +      "size": {
      +        "maximum": 8,
      +        "minimum": 0.25,
      +        "type": "number"
      +      },
      +      "smoothing": {
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "spotlight": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "fit": {
      +        "enum": [
      +          "pad",
      +          "crop"
      +        ],
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "export_preset",
      +        "type": "string"
      +      },
      +      "platform": {
      +        "enum": [
      +          "youtube",
      +          "instagram_reel",
      +          "tiktok",
      +          "x",
      +          "square",
      +          "steam_trailer",
      +          "vertical_reel"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "platform"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "format": {
      +        "enum": [
      +          "gif",
      +          "webp"
      +        ],
      +        "type": "string"
      +      },
      +      "fps": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 30,
      +        "type": "number"
      +      },
      +      "maxBytes": {
      +        "maximum": 9007199254740991,
      +        "minimum": 10000,
      +        "type": "integer"
      +      },
      +      "op": {
      +        "const": "export_gif",
      +        "type": "string"
      +      },
      +      "width": {
      +        "maximum": 1920,
      +        "minimum": 64,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changedv0.48.0
    • changedInput schema / properties / recipe / description
      Previous value: -"Polish preset expanded to steps (see dryRun): pr_demo = cut_idle, click zoom, GIF <=10 MB; tutorial = + audio, captions, 1080p mp4; social_reel = 9:16, big captions. Given steps replace its same-op step."New value: +"Polish preset expanded to steps (see dryRun): pr_demo = cut_idle, click zoom, GIF <=10 MB; tutorial = + audio, captions, 1080p mp4; social_reel = 9:16, big captions. Given steps replace its same-op step; trim, redact, crop and cursor go first (source pixels and time)."
  4. Changed8 schema fields changedv0.47.0
    • addedInput schema / properties / chapters
      Added value: +{
      +  "description": "Keep the input's markers as chapters, re-timed through trims and speed.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / dryRun / description
      Previous value: -"Return the planned ffmpeg command and output size without running it."New value: +"Return the plan (ffmpeg command, output size) without running it."
    • addedInput schema / properties / recipe
      Added value: +{
      +  "description": "Polish preset expanded to steps (see dryRun): pr_demo = cut_idle, click zoom, GIF <=10 MB; tutorial = + audio, captions, 1080p mp4; social_reel = 9:16, big captions. Given steps replace its same-op step.",
      +  "enum": [
      +    "pr_demo",
      +    "tutorial",
      +    "social_reel"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / steps / description
      Previous value: -"Edits in order, each { op, ...the same options as its tool }: trim, crop, scale, speed, redact (redact_region), callout, reframe, zoom (keyframes), and as the last step only export_preset or export_gif. Times in a step are on the timeline as it is at that step, after any earlier trim or speed change; pixel positions are in the frame as it is at that step."New value: +"Edits in order, each { op, ...its tool's options }; export_preset/export_gif only last. Times and pixels are relative to the video as it is at that step (after earlier trims, speed, crops). zoom follow:\"clicks\" plans from the event log; burn_subtitles takes subtitles or transcribe:true."
    • changedInput schema / properties / steps / items / oneOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "duration": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "end": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "trim",
      -        "type": "string"
      -      },
      -      "start": {
      -        "minimum": 0,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "start"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "height": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "op": {
      -        "const": "crop",
      -        "type": "string"
      -      },
      -      "width": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "x": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "y": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "x",
      -      "y",
      -      "width",
      -      "height"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "height": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "op": {
      -        "const": "scale",
      -        "type": "string"
      -      },
      -      "width": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "factor": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "op": {
      -        "const": "speed",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "factor"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "color": {
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "redact",
      -        "type": "string"
      -      },
      -      "pad": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "regions": {
      -        "items": {
      -          "properties": {
      -            "end": {
      -              "description": "Optional second to stop redacting after.",
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "height": {
      -              "description": "Region height in pixels.",
      -              "exclusiveMinimum": 0,
      -              "maximum": 9007199254740991,
      -              "type": "integer"
      -            },
      -            "start": {
      -              "description": "Optional second to start redacting from.",
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            "width": {
      -              "description": "Region width in pixels.",
      -              "exclusiveMinimum": 0,
      -              "maximum": 9007199254740991,
      -              "type": "integer"
      -            },
      -            "x": {
      -              "description": "Left edge in pixels.",
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "y": {
      -              "description": "Top edge in pixels.",
      -              "maximum": 9007199254740991,
      -              "minimum": 0,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "x",
      -            "y",
      -            "width",
      -            "height"
      -          ],
      -          "type": "object"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "style": {
      -        "enum": [
      -          "box",
      -          "blur",
      -          "pixelate"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "regions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "items": {
      -        "items": {
      -          "oneOf": [
      -            {
      -              "properties": {
      -                "color": {
      -                  "description": "Color name, #RRGGBB, or name@alpha.",
      -                  "type": "string"
      -                },
      -                "fill": {
      -                  "description": "Fill instead of outline.",
      -                  "type": "boolean"
      -                },
      -                "from": {
      -                  "description": "Show from this second (default: start).",
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                "height": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "thickness": {
      -                  "description": "Outline px (default 4).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "to": {
      -                  "description": "Hide after this second (default: end).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "box",
      -                  "type": "string"
      -                },
      -                "width": {
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "x": {
      -                  "type": "number"
      -                },
      -                "y": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "x",
      -                "y",
      -                "width",
      -                "height"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "background": {
      -                  "description": "Dark panel behind the text (default true).",
      -                  "type": "boolean"
      -                },
      -                "color": {
      -                  "description": "Color name, #RRGGBB, or name@alpha.",
      -                  "type": "string"
      -                },
      -                "from": {
      -                  "description": "Show from this second (default: start).",
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                "size": {
      -                  "description": "Font size px (default 32).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "text": {
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "to": {
      -                  "description": "Hide after this second (default: end).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "text",
      -                  "type": "string"
      -                },
      -                "x": {
      -                  "type": "number"
      -                },
      -                "y": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "x",
      -                "y",
      -                "text"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "properties": {
      -                "color": {
      -                  "description": "Color name, #RRGGBB, or name@alpha.",
      -                  "type": "string"
      -                },
      -                "from": {
      -                  "description": "Show from this second (default: start).",
      -                  "minimum": 0,
      -                  "type": "number"
      -                },
      -                "thickness": {
      -                  "description": "Shaft px (default 8).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "to": {
      -                  "description": "Hide after this second (default: end).",
      -                  "exclusiveMinimum": 0,
      -                  "type": "number"
      -                },
      -                "type": {
      -                  "const": "arrow",
      -                  "type": "string"
      -                },
      -                "x1": {
      -                  "description": "Tail x.",
      -                  "type": "number"
      -                },
      -                "x2": {
      -                  "description": "Head x: the point the arrow points at.",
      -                  "type": "number"
      -                },
      -                "y1": {
      -                  "description": "Tail y.",
      -                  "type": "number"
      -                },
      -                "y2": {
      -                  "description": "Head y.",
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "x1",
      -                "y1",
      -                "x2",
      -                "y2"
      -              ],
      -              "type": "object"
      -            }
      -          ]
      -        },
      -        "maxItems": 50,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "op": {
      -        "const": "callout",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "items"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "aspect": {
      -        "enum": [
      -          "16:9",
      -          "9:16",
      -          "1:1",
      -          "4:5"
      -        ],
      -        "type": "string"
      -      },
      -      "fit": {
      -        "enum": [
      -          "pad",
      -          "crop"
      -        ],
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "reframe",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "aspect"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "keyframes": {
      -        "items": {
      -          "properties": {
      -            "full": {
      -              "description": "Zoom back out to the whole frame.",
      -              "type": "boolean"
      -            },
      -            "height": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "t": {
      -              "description": "Seconds: the view is fully reached at this time.",
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            "width": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "x": {
      -              "type": "number"
      -            },
      -            "y": {
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "t"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 100,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "op": {
      -        "const": "zoom",
      -        "type": "string"
      -      },
      -      "transitionSec": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 5,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "keyframes"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "fit": {
      -        "enum": [
      -          "pad",
      -          "crop"
      -        ],
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "export_preset",
      -        "type": "string"
      -      },
      -      "platform": {
      -        "enum": [
      -          "youtube",
      -          "instagram_reel",
      -          "tiktok",
      -          "x",
      -          "square",
      -          "steam_trailer",
      -          "vertical_reel"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "platform"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "format": {
      -        "enum": [
      -          "gif",
      -          "webp"
      -        ],
      -        "type": "string"
      -      },
      -      "fps": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 30,
      -        "type": "number"
      -      },
      -      "maxBytes": {
      -        "maximum": 9007199254740991,
      -        "minimum": 10000,
      -        "type": "integer"
      -      },
      -      "op": {
      -        "const": "export_gif",
      -        "type": "string"
      -      },
      -      "width": {
      -        "maximum": 1920,
      -        "minimum": 64,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "duration": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "end": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "trim",
      +        "type": "string"
      +      },
      +      "start": {
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "start"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "height": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "op": {
      +        "const": "crop",
      +        "type": "string"
      +      },
      +      "width": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "x": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "y": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "x",
      +      "y",
      +      "width",
      +      "height"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "height": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "op": {
      +        "const": "scale",
      +        "type": "string"
      +      },
      +      "width": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "factor": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "speed",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "factor"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "color": {
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "redact",
      +        "type": "string"
      +      },
      +      "pad": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "regions": {
      +        "items": {
      +          "properties": {
      +            "end": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "height": {
      +              "exclusiveMinimum": 0,
      +              "maximum": 9007199254740991,
      +              "type": "integer"
      +            },
      +            "start": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "width": {
      +              "exclusiveMinimum": 0,
      +              "maximum": 9007199254740991,
      +              "type": "integer"
      +            },
      +            "x": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "y": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "x",
      +            "y",
      +            "width",
      +            "height"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "style": {
      +        "enum": [
      +          "box",
      +          "blur",
      +          "pixelate"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "regions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "fontFile": {
      +        "description": "Font: a .ttf/.otf/.ttc path or a C:\\Windows\\Fonts file name. Default: bundled Inter, with a covering system font for scripts it lacks (CJK, emoji, Arabic, ...).",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "items": {
      +        "items": {
      +          "oneOf": [
      +            {
      +              "properties": {
      +                "color": {
      +                  "type": "string"
      +                },
      +                "fill": {
      +                  "description": "Fill instead of outline.",
      +                  "type": "boolean"
      +                },
      +                "from": {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                "height": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "thickness": {
      +                  "description": "Outline px (default 4).",
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "to": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "box",
      +                  "type": "string"
      +                },
      +                "width": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "x": {
      +                  "type": "number"
      +                },
      +                "y": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "x",
      +                "y",
      +                "width",
      +                "height"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "background": {
      +                  "description": "Dark panel behind the text (default true).",
      +                  "type": "boolean"
      +                },
      +                "color": {
      +                  "type": "string"
      +                },
      +                "from": {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                "size": {
      +                  "description": "Font size px (default 32).",
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "text": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "to": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "text",
      +                  "type": "string"
      +                },
      +                "x": {
      +                  "type": "number"
      +                },
      +                "y": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "x",
      +                "y",
      +                "text"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "properties": {
      +                "color": {
      +                  "type": "string"
      +                },
      +                "from": {
      +                  "minimum": 0,
      +                  "type": "number"
      +                },
      +                "thickness": {
      +                  "description": "Shaft px (default 8).",
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "to": {
      +                  "exclusiveMinimum": 0,
      +                  "type": "number"
      +                },
      +                "type": {
      +                  "const": "arrow",
      +                  "type": "string"
      +                },
      +                "x1": {
      +                  "type": "number"
      +                },
      +                "x2": {
      +                  "description": "Head (x2,y2) is the point the arrow points at.",
      +                  "type": "number"
      +                },
      +                "y1": {
      +                  "type": "number"
      +                },
      +                "y2": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "x1",
      +                "y1",
      +                "x2",
      +                "y2"
      +              ],
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "maxItems": 50,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "op": {
      +        "const": "callout",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "items"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "aspect": {
      +        "enum": [
      +          "16:9",
      +          "9:16",
      +          "1:1",
      +          "4:5"
      +        ],
      +        "type": "string"
      +      },
      +      "fit": {
      +        "enum": [
      +          "pad",
      +          "crop"
      +        ],
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "reframe",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "aspect"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "follow": {
      +        "const": "clicks",
      +        "type": "string"
      +      },
      +      "holdSec": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 30,
      +        "type": "number"
      +      },
      +      "keyframes": {
      +        "items": {
      +          "properties": {
      +            "full": {
      +              "type": "boolean"
      +            },
      +            "height": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "t": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "width": {
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "x": {
      +              "type": "number"
      +            },
      +            "y": {
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "t"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 100,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "maxZoom": {
      +        "maximum": 6,
      +        "minimum": 1,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "zoom",
      +        "type": "string"
      +      },
      +      "transitionSec": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 5,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "keepSec": {
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "minIdleSec": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "cut_idle",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "denoise": {
      +        "enum": [
      +          "light",
      +          "medium",
      +          "strong"
      +        ],
      +        "type": "string"
      +      },
      +      "normalize": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "youtube",
      +              "podcast",
      +              "broadcast"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "maximum": -5,
      +            "minimum": -70,
      +            "type": "number"
      +          }
      +        ]
      +      },
      +      "op": {
      +        "const": "audio",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "op": {
      +        "const": "burn_subtitles",
      +        "type": "string"
      +      },
      +      "style": {
      +        "enum": [
      +          "clean",
      +          "social"
      +        ],
      +        "type": "string"
      +      },
      +      "subtitles": {
      +        "type": "string"
      +      },
      +      "transcribe": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "aspect": {
      +        "enum": [
      +          "16:9",
      +          "9:16",
      +          "1:1",
      +          "4:5"
      +        ],
      +        "type": "string"
      +      },
      +      "colors": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "maxItems": 4,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "image": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "backdrop",
      +        "type": "string"
      +      },
      +      "padding": {
      +        "maximum": 2000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "preset": {
      +        "enum": [
      +          "desktop",
      +          "rec",
      +          "amber",
      +          "light"
      +        ],
      +        "type": "string"
      +      },
      +      "radius": {
      +        "maximum": 1000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "shadow": {
      +        "maximum": 200,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "shadowOpacity": {
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "clicks": {
      +        "type": "boolean"
      +      },
      +      "color": {
      +        "type": "string"
      +      },
      +      "events": {
      +        "type": "string"
      +      },
      +      "fontFile": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "keys": {
      +        "enum": [
      +          "shortcuts",
      +          "masked"
      +        ],
      +        "type": "string"
      +      },
      +      "lingerSec": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 10,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "keystroke_overlay",
      +        "type": "string"
      +      },
      +      "position": {
      +        "enum": [
      +          "bottom",
      +          "bottom-left",
      +          "bottom-right",
      +          "top",
      +          "top-left",
      +          "top-right"
      +        ],
      +        "type": "string"
      +      },
      +      "size": {
      +        "maximum": 400,
      +        "minimum": 8,
      +        "type": "number"
      +      },
      +      "typing": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "clicks": {
      +        "type": "boolean"
      +      },
      +      "events": {
      +        "type": "string"
      +      },
      +      "hideAfterSec": {
      +        "maximum": 600,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "op": {
      +        "const": "cursor",
      +        "type": "string"
      +      },
      +      "size": {
      +        "maximum": 8,
      +        "minimum": 0.25,
      +        "type": "number"
      +      },
      +      "smoothing": {
      +        "maximum": 1,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "spotlight": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "fit": {
      +        "enum": [
      +          "pad",
      +          "crop"
      +        ],
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "export_preset",
      +        "type": "string"
      +      },
      +      "platform": {
      +        "enum": [
      +          "youtube",
      +          "instagram_reel",
      +          "tiktok",
      +          "x",
      +          "square",
      +          "steam_trailer",
      +          "vertical_reel"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "platform"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "format": {
      +        "enum": [
      +          "gif",
      +          "webp"
      +        ],
      +        "type": "string"
      +      },
      +      "fps": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 30,
      +        "type": "number"
      +      },
      +      "maxBytes": {
      +        "maximum": 9007199254740991,
      +        "minimum": 10000,
      +        "type": "integer"
      +      },
      +      "op": {
      +        "const": "export_gif",
      +        "type": "string"
      +      },
      +      "width": {
      +        "maximum": 1920,
      +        "minimum": 64,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / steps / minItems
      Removed value: -1
    • changedInput schema / required
      Previous value: -[
      -  "input",
      -  "steps"
      -]New value: +[
      +  "input"
      +]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": {},
      +  "properties": {
      +    "processes": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "steps": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "processes",
      +    "steps"
      +  ],
      +  "type": "object"
      +}
  5. First observedv0.32.0

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true and non-read-only, so the write profile is covered. The description adds genuinely new behavior: a single re-encode with no intermediate files, and the constraint that export_preset/export_gif must come last. It stops short of disclosing cost/latency for long inputs or that the output path defaults under SCREENCAST_HOME/edits, which would be useful for a heavy render operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the core value proposition before the alternative-tool guidance. The 15-op parenthetical is long but earns its place by telling the agent what can be composed in one pass; nothing else is wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 9-parameter tool with a deeply nested step union and an output schema, the description covers what the tool does, why to prefer it, and the one-pass execution model. Missing only secondary context an agent might want (render cost, default output location), which the schema partially supplies.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents steps, recipe, dryRun, output, quality, chapters, fromEdit and overwrite — including step ordering and relative-time semantics. The description adds no parameter meaning beyond naming the supported op values, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific action (run several edits in one ffmpeg pass) and enumerates the exact ops it accepts, then explicitly positions itself against the sibling edit tools with 'Prefer it over chaining edit tools.' An agent can distinguish pipeline from trim/crop/zoom etc. without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear positive guidance: use this instead of chaining single-edit tools, and recipes cover 'the usual polish in one call.' It does not say when NOT to use it (e.g. a single trivial edit, or when you need per-step intermediate output), but the preference rule is unambiguous for the common case.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.