CueFrame

Create Brief

create_brief

Persist the video's INTENT as a Brief — the Director's rich input contract (spec: the storyboard skill's output lands here). Fields: goal (required), audience, platform, format, durationSec, tone, cta, locale (output language — all on-screen copy + captions), hook, caption, beats[] (each with an editorial intent and optional MOMENT PINNING {mediaId, startSec, endSec} — honored to-the-frame or refused), mustIncludes, captions {styleId, emphasisPhrases} (the big-serif emphasis treatment), motionStyle, seededGraphics (your authored overlay/component/card clips, carried VERBATIM as locked clips — never re-authored), exclusions (hard negatives: graphic kinds the Director must NEVER author + 'no-transitions'), gates {holdAt, autoApprove}. Then compose it: compose with {briefId}. The response carries the QUOTE (compose + estimated render) — relay it to your human BEFORE composing.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "body": "<body>"
    },
    "name": "create_brief"
  }
}

Input Schema

Name	Required	Description	Default
`body`	Yes
`commandId`	No	Retry identity. A call repeated with the same commandId returns the first result instead of acting twice.

Output Schema

Name	Required	Description
`id`	No
`cta`	No
`goal`	No	What the video must accomplish.
`hook`	No
`kind`	No	authored = create_brief; clip = minted by suggest_briefs from an AI clip suggestion.
`name`	No
`tone`	No
`audio`	No
`beats`	No
`gates`	No
`quote`	No
`format`	No
`locale`	No	Output language (BCP-47 tag, e.g. 'es-419'): ALL on-screen copy + captions.
`caption`	No
`audience`	No
`captions`	No
`platform`	No
`createdAt`	No
`projectId`	No
`updatedAt`	No
`exclusions`	No
`references`	No
`durationSec`	No	Target output duration. HONOR-OR-REFUSE: compose validates it against the beat-source window (±1.5s) and refuses a brief it cannot honor.
`motionStyle`	No
`mustIncludes`	No
`seededGraphics`	No	Client-authored graphic clips the Director must carry VERBATIM: seeded into the design loop's base composition as LOCKED clips (never re-authored, never discarded).
`sourceSuggestionId`	No	kind:'clip' provenance — the suggestion this Brief was minted from.

Schema Changelog

Changes observed during successful MCP inspections.

Changed53 schema fields changedOct 31, 2026

removedInput schema / $defs / __schema0

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "durationSec": {
-      "exclusiveMinimum": 0,
-      "type": "number"
-    },
-    "graphic": {
-      "additionalProperties": false,
-      "description": "GRAPHICS MANDATE: the plan MUST carry a graphics request of this role overlapping this beat's window — enforced at the plan gate (honor-or-refuse, like moment pinning). Prose mustIncludes reaches only the judge; this is the checkable form.",
-      "properties": {
-        "items": {
-          "$ref": "#/$defs/__schema5"
-        },
-        "role": {
-          "$ref": "#/$defs/__schema4"
-        }
-      },
-      "required": [
-        "role"
-      ],
-      "type": "object"
-    },
-    "id": {
-      "minLength": 1,
-      "type": "string"
-    },
-    "intent": {
-      "description": "What this beat DOES editorially (hook the claim, prove it, CTA…).",
-      "minLength": 1,
-      "type": "string"
-    },
-    "source": {
-      "additionalProperties": false,
-      "description": "MOMENT PINNING: this beat uses EXACTLY this window of this media item — honored to-the-frame or refused. v1: every sourced beat must reference the SAME mediaId (multi-source briefs are refused loudly, not silently merged).",
-      "properties": {
-        "endSec": {
-          "$ref": "#/$defs/__schema3"
-        },
-        "mediaId": {
-          "$ref": "#/$defs/__schema1"
-        },
-        "startSec": {
-          "$ref": "#/$defs/__schema2"
-        }
-      },
-      "required": [
-        "mediaId",
-        "startSec",
-        "endSec"
-      ],
-      "type": "object"
-    }
-  },
-  "required": [
-    "id",
-    "intent"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema1

Removed value: -{
-  "minLength": 1,
-  "type": "string"
-}

removedInput schema / $defs / __schema10

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "automation": {
-      "additionalProperties": false,
-      "properties": {
-        "lanes": {
-          "items": {
-            "additionalProperties": false,
-            "properties": {
-              "points": {
-                "items": {
-                  "$ref": "#/$defs/__schema36"
-                },
-                "minItems": 2,
-                "type": "array"
-              },
-              "target": {
-                "const": "volume",
-                "type": "string"
-              }
-            },
-            "required": [
-              "target",
-              "points"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "version": {
-          "const": 1,
-          "type": "number"
-        }
-      },
-      "required": [
-        "version",
-        "lanes"
-      ],
-      "type": "object"
-    },
-    "captionVisibility": {
-      "description": "Video media clip only. Hide native captions while this clip is topmost and covers the lower picture, or when an opaque, effect-free clip has an explicitly full-frame region, even with fit:contain. Caption words and timings remain stored and resume when another visible clip takes over.",
-      "enum": [
-        "visible",
-        "hidden"
-      ],
-      "type": "string"
-    },
-    "color": {
-      "additionalProperties": false,
-      "properties": {
-        "creative": {
-          "additionalProperties": false,
-          "properties": {
-            "enabled": {
-              "type": "boolean"
-            },
-            "mediaId": {
-              "type": "string"
-            },
-            "sha256": {
-              "type": "string"
-            },
-            "strength": {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            }
-          },
-          "required": [
-            "mediaId",
-            "sha256",
-            "enabled",
-            "strength"
-          ],
-          "type": "object"
-        },
-        "display": {
-          "anyOf": [
-            {
-              "additionalProperties": false,
-              "properties": {
-                "enabled": {
-                  "type": "boolean"
-                },
-                "mediaId": {
-                  "type": "string"
-                },
-                "sha256": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "mediaId",
-                "sha256",
-                "enabled"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "bundled": {
-                  "enum": [
-                    "daylight-negative",
-                    "tungsten-negative",
-                    "soft-negative",
-                    "slide",
-                    "black-and-white"
-                  ],
-                  "type": "string"
-                },
-                "enabled": {
-                  "type": "boolean"
-                }
-              },
-              "required": [
-                "bundled",
-                "enabled"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "enabled": {
-          "type": "boolean"
-        },
-        "grade": {
-          "additionalProperties": false,
-          "properties": {
-            "blacks": {
-              "maximum": 1,
-              "minimum": -1,
-              "type": "number"
-            },
-            "contrast": {
-              "maximum": 1,
-              "minimum": -1,
-              "type": "number"
-            },
-            "exposure": {
-              "maximum": 4,
-              "minimum": -4,
-              "type": "number"
-            },
-            "highlights": {
-              "maximum": 1,
-              "minimum": -1,
-              "type": "number"
-            },
-            "saturation": {
-              "maximum": 1,
-              "minimum": -1,
-              "type": "number"
-            },
-            "shadows": {
-              "maximum": 1,
-              "minimum": -1,
-              "type": "number"
-            },
-            "temperature": {
-              "maximum": 1,
-              "minimum": -1,
-              "type": "number"
-            },
-            "tint": {
-              "maximum": 1,
-              "minimum": -1,
-              "type": "number"
-            },
-            "vibrance": {
-              "maximum": 1,
-              "minimum": -1,
-              "type": "number"
-            },
-            "whites": {
-              "maximum": 1,
-              "minimum": -1,
-              "type": "number"
-            }
-          },
-          "required": [
-            "exposure",
-            "contrast",
-            "highlights",
-            "shadows",
-            "whites",
-            "blacks",
-            "temperature",
-            "tint",
-            "vibrance",
-            "saturation"
-          ],
-          "type": "object"
-        },
-        "grain": {
-          "additionalProperties": false,
-          "properties": {
-            "amount": {
-              "maximum": 2,
-              "minimum": 0,
-              "type": "number"
-            },
-            "enabled": {
-              "type": "boolean"
-            },
-            "gauge": {
-              "enum": [
-                "super8",
-                "super16",
-                "super35",
-                "65mm"
-              ],
-              "type": "string"
-            },
-            "profile": {
-              "enum": [
-                "daylight-negative",
-                "tungsten-negative",
-                "soft-negative",
-                "slide",
-                "black-and-white"
-              ],
-              "type": "string"
-            },
-            "seed": {
-              "maximum": 4294967295,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "size": {
-              "maximum": 4,
-              "minimum": 0.5,
-              "type": "number"
-            }
-          },
-          "required": [
-            "enabled",
-            "profile",
-            "gauge",
-            "amount",
-            "size",
-            "seed"
-          ],
-          "type": "object"
-        },
-        "halation": {
-          "additionalProperties": false,
-          "properties": {
-            "amount": {
-              "maximum": 0.5,
-              "minimum": 0,
-              "type": "number"
-            },
-            "enabled": {
-              "type": "boolean"
-            },
-            "radius": {
-              "maximum": 0.02,
-              "minimum": 0.0005,
-              "type": "number"
-            },
-            "threshold": {
-              "maximum": 16,
-              "minimum": 0,
-              "type": "number"
-            },
-            "tint": {
-              "items": false,
-              "maxItems": 3,
-              "minItems": 3,
-              "prefixItems": [
-                {
-                  "$ref": "#/$defs/__schema38"
-                },
-                {
-                  "$ref": "#/$defs/__schema39"
-                },
-                {
-                  "$ref": "#/$defs/__schema40"
-                }
-              ],
-              "type": "array"
-            }
-          },
-          "required": [
-            "enabled",
-            "amount",
-            "radius",
-            "threshold",
-            "tint"
-          ],
-          "type": "object"
-        },
-        "looks": {
-          "items": {
-            "$ref": "#/$defs/__schema37"
-          },
-          "maxItems": 2,
-          "type": "array"
-        },
-        "version": {
-          "const": 1,
-          "type": "number"
-        }
-      },
-      "required": [
-        "version",
-        "enabled",
-        "grade",
-        "looks"
-      ],
-      "type": "object"
-    },
-    "duration": {
-      "exclusiveMinimum": 0,
-      "type": "number"
-    },
-    "effects": {
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "component": {
-            "$ref": "#/$defs/__schema23"
-          },
-          "id": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "params": {
-            "additionalProperties": {},
-            "properties": {},
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "primitiveId": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "window": {
-            "additionalProperties": false,
-            "properties": {
-              "duration": {
-                "exclusiveMinimum": 0,
-                "type": "number"
-              },
-              "startTime": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "startTime",
-              "duration"
-            ],
-            "type": "object"
-          }
-        },
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "fit": {
-      "enum": [
-        "cover",
-        "contain"
-      ],
-      "type": "string"
-    },
-    "id": {
-      "minLength": 1,
-      "type": "string"
-    },
-    "kind": {
-      "enum": [
-        "video",
-        "audio",
-        "image",
-        "overlay",
-        "effect"
-      ],
-      "type": "string"
-    },
-    "legacyKeyframes": {
-      "additionalProperties": false,
-      "properties": {
-        "channels": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "needsUpgrade": {
-          "const": true,
-          "type": "boolean"
-        },
-        "record": {}
-      },
-      "required": [
-        "needsUpgrade",
-        "channels",
-        "record"
-      ],
-      "type": "object"
-    },
-    "linkGroupId": {
-      "minLength": 1,
-      "type": "string"
-    },
-    "opacity": {
-      "maximum": 1,
-      "minimum": 0,
-      "type": "number"
-    },
-    "position": {
-      "additionalProperties": {
-        "$ref": "#/$defs/__schema29"
-      },
-      "description": "Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing.",
-      "properties": {
-        "x": {
-          "$ref": "#/$defs/__schema27"
-        },
-        "y": {
-          "$ref": "#/$defs/__schema28"
-        }
-      },
-      "required": [
-        "x",
-        "y"
-      ],
-      "type": "object"
-    },
-    "region": {
-      "additionalProperties": {
-        "$ref": "#/$defs/__schema34"
-      },
-      "description": "A window in the frame that the clip draws into and is clipped to (top-left corner and size, each a frame fraction). Inside a region, `position` and `scale` act relative to that window, so content moved past its edge is cut off. Omit it to place the clip against the whole frame.",
-      "properties": {
-        "h": {
-          "$ref": "#/$defs/__schema33"
-        },
-        "w": {
-          "$ref": "#/$defs/__schema32"
-        },
-        "x": {
-          "$ref": "#/$defs/__schema30"
-        },
-        "y": {
-          "$ref": "#/$defs/__schema31"
-        }
-      },
-      "required": [
-        "x",
-        "y",
-        "w",
-        "h"
-      ],
-      "type": "object"
-    },
-    "rotation": {
-      "type": "number"
-    },
-    "scale": {
-      "exclusiveMinimum": 0,
-      "type": "number"
-    },
-    "source": {
-      "oneOf": [
-        {
-          "additionalProperties": {},
-          "properties": {
-            "anchor": {
-              "additionalProperties": {},
-              "properties": {
-                "clipId": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "offsetMs": {
-                  "type": "number"
-                }
-              },
-              "required": [
-                "clipId",
-                "offsetMs"
-              ],
-              "type": "object"
-            },
-            "audioRole": {
-              "description": "Mix role. A role sets the clip's default gain when it has no `volume` or `volumeDb`: vo 0 dB, sfx -6 dB, music -8 dB (-16 dB when any vo clip exists), ambience -22 dB. Set `volumeDb: 0` to keep a role and play the source at its own level.",
-              "enum": [
-                "sfx",
-                "music",
-                "vo",
-                "ambience"
-              ],
-              "type": "string"
-            },
-            "duck": {
-              "additionalProperties": {},
-              "properties": {
-                "attackMs": {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "duckDb": {
-                  "maximum": 0,
-                  "type": "number"
-                },
-                "releaseMs": {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "windows": {
-                  "items": {
-                    "additionalProperties": {},
-                    "properties": {
-                      "endMs": {
-                        "type": "number"
-                      },
-                      "startMs": {
-                        "type": "number"
-                      }
-                    },
-                    "required": [
-                      "startMs",
-                      "endMs"
-                    ],
-                    "type": "object"
-                  },
-                  "type": "array"
-                }
-              },
-              "required": [
-                "duckDb",
-                "attackMs",
-                "releaseMs"
-              ],
-              "type": "object"
-            },
-            "excludedRanges": {
-              "items": {
-                "additionalProperties": {},
-                "properties": {
-                  "end": {
-                    "minimum": 0,
-                    "type": "number"
-                  },
-                  "reason": {
-                    "type": "string"
-                  },
-                  "start": {
-                    "minimum": 0,
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "start",
-                  "end"
-                ],
-                "type": "object"
-              },
-              "type": "array"
-            },
-            "fadeInMs": {
-              "minimum": 0,
-              "type": "number"
-            },
-            "fadeOutMs": {
-              "minimum": 0,
-              "type": "number"
-            },
-            "kenBurns": {
-              "description": "Still-image motion. When unset, an image clip slowly pushes in (`in`) unless its fit is `contain` or it keyframes scale, position or rotation, so a keyframed clip renders exactly its keyframed values; set `none` for a still that holds.",
-              "enum": [
-                "in",
-                "out",
-                "pan-l",
-                "pan-r",
-                "none"
-              ],
-              "type": "string"
-            },
-            "kind": {
-              "const": "media",
-              "type": "string"
-            },
-            "loop": {
-              "type": "boolean"
-            },
-            "mediaId": {
-              "type": "string"
-            },
-            "muted": {
-              "type": "boolean"
-            },
-            "playbackRate": {
-              "exclusiveMinimum": 0,
-              "type": "number"
-            },
-            "reframe": {
-              "additionalProperties": {},
-              "properties": {
-                "segments": {
-                  "items": {
-                    "$ref": "#/$defs/__schema11"
-                  },
-                  "minItems": 1,
-                  "type": "array"
-                }
-              },
-              "required": [
-                "segments"
-              ],
-              "type": "object"
-            },
-            "sync": {
-              "enum": [
-                "video",
-                "independent"
-              ],
-              "type": "string"
-            },
-            "trim": {
-              "additionalProperties": {},
-              "properties": {
-                "end": {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "start": {
-                  "minimum": 0,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "start",
-                "end"
-              ],
-              "type": "object"
-            },
-            "volume": {
-              "maximum": 4,
-              "minimum": 0,
-              "type": "number"
-            },
-            "volumeDb": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "kind",
-            "mediaId"
-          ],
-          "type": "object"
-        },
-        {
-          "additionalProperties": false,
-          "properties": {
-            "componentId": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "execution": {
-              "$ref": "#/$defs/__schema23"
-            },
-            "kind": {
-              "const": "component",
-              "type": "string"
-            },
-            "placement": {
-              "oneOf": [
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "kind": {
-                      "const": "clip",
-                      "type": "string"
-                    },
-                    "version": {
-                      "const": 3,
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "version",
-                    "kind"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "kind": {
-                      "const": "content-slots",
-                      "type": "string"
-                    },
-                    "slots": {
-                      "additionalProperties": {
-                        "additionalProperties": false,
-                        "properties": {
-                          "ownership": {
-                            "enum": [
-                              "reference",
-                              "exclusive"
-                            ],
-                            "type": "string"
-                          },
-                          "targetClipIds": {
-                            "items": {
-                              "maxLength": 256,
-                              "minLength": 1,
-                              "type": "string"
-                            },
-                            "type": "array"
-                          }
-                        },
-                        "required": [
-                          "targetClipIds",
-                          "ownership"
-                        ],
-                        "type": "object"
-                      },
-                      "properties": {},
-                      "propertyNames": {
-                        "maxLength": 256,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "type": "object"
-                    },
-                    "version": {
-                      "const": 3,
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "version",
-                    "kind",
-                    "slots"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "props": {
-              "additionalProperties": {},
-              "properties": {},
-              "propertyNames": {
-                "type": "string"
-              },
-              "type": "object"
-            },
-            "retired": {
-              "additionalProperties": {},
-              "properties": {},
-              "propertyNames": {
-                "type": "string"
-              },
-              "type": "object"
-            },
-            "zPlane": {
-              "enum": [
-                "front",
-                "behind-subject"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "kind",
-            "componentId",
-            "props"
-          ],
-          "type": "object"
-        },
-        {
-          "additionalProperties": {},
-          "properties": {
-            "anchor": {
-              "additionalProperties": {},
-              "properties": {
-                "space": {
-                  "const": "scene",
-                  "type": "string"
-                },
-                "x": {
-                  "maximum": 1,
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "y": {
-                  "maximum": 1,
-                  "minimum": 0,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "space",
-                "x",
-                "y"
-              ],
-              "type": "object"
-            },
-            "kind": {
-              "const": "overlay",
-              "type": "string"
-            },
-            "parallax": {
-              "maximum": 0.3,
-              "minimum": -0.3,
-              "type": "number"
-            },
-            "params": {
-              "additionalProperties": {},
-              "properties": {},
-              "propertyNames": {
-                "type": "string"
-              },
-              "type": "object"
-            },
-            "primitiveId": {
-              "minLength": 1,
-              "pattern": "^(?!custom$)",
-              "type": "string"
-            },
-            "zPlane": {
-              "enum": [
-                "front",
-                "behind-subject"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "kind",
-            "primitiveId",
-            "params"
-          ],
-          "type": "object"
-        },
-        {
-          "additionalProperties": false,
-          "properties": {
-            "component": {
-              "$ref": "#/$defs/__schema23"
-            },
-            "kind": {
-              "const": "effect",
-              "type": "string"
-            },
-            "params": {
-              "additionalProperties": {},
-              "properties": {},
-              "propertyNames": {
-                "type": "string"
-              },
-              "type": "object"
-            },
-            "primitiveId": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "targetTrackIds": {
-              "items": {
-                "$ref": "#/$defs/__schema25"
-              },
-              "minItems": 1,
-              "type": "array"
-            },
-            "wrapperOrder": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            }
-          },
-          "required": [
-            "kind"
-          ],
-          "type": "object"
-        },
-        {
-          "additionalProperties": {},
-          "properties": {
-            "html": {
-              "description": "Self-contained card markup sized to the format's pixel frame. Motion comes from frame-driven vars, never @keyframes or transition: --cf-frame, --cf-t (seconds), --cf-fps, --cf-duration, --cf-progress, --cf-ease, --cf-enter, --cf-exit. Visible copy goes in the html as plain text. Wrap a run in <span data-cf-split=\"words\"> or \"chars\" and each unit becomes its own span carrying --cf-i (its index, the group carries --cf-n), so one rule staggers it (in chars, spaces count as units), e.g. opacity:clamp(0,calc(var(--cf-t)*4 - var(--cf-i)*.3),1). save_as_template binds that copy with textParams match.",
-              "minLength": 1,
-              "type": "string"
-            },
-            "kind": {
-              "const": "card",
-              "type": "string"
-            },
-            "tokens": {
-              "$ref": "#/$defs/__schema26",
-              "description": "Style values the html reads as CSS custom properties: key x becomes --cf-x, so never put dashes in a key. Use tokens for colours and sizes, not visible copy.",
-              "propertyNames": {
-                "type": "string"
-              }
-            },
-            "zPlane": {
-              "const": "front",
-              "type": "string"
-            }
-          },
-          "required": [
-            "kind",
-            "html"
-          ],
-          "type": "object"
-        },
-        {
-          "additionalProperties": false,
-          "properties": {
-            "compositionId": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "kind": {
-              "const": "composition",
-              "type": "string"
-            },
-            "trim": {
-              "additionalProperties": {},
-              "properties": {
-                "end": {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "start": {
-                  "minimum": 0,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "start",
-                "end"
-              ],
-              "type": "object"
-            }
-          },
-          "required": [
-            "kind",
-            "compositionId"
-          ],
-          "type": "object"
-        }
-      ]
-    },
-    "startTime": {
-      "minimum": 0,
-      "type": "number"
-    },
-    "transitionIn": {
-      "additionalProperties": {},
-      "properties": {
-        "component": {
-          "$ref": "#/$defs/__schema23"
-        },
-        "duration": {
-          "exclusiveMinimum": 0,
-          "type": "number"
-        },
-        "fromClipId": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "handlePolicy": {
-          "const": "outgoing-overrun-at-cut-v1",
-          "type": "string"
-        },
-        "id": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "toClipId": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "type": {
-          "minLength": 1,
-          "type": "string"
-        }
-      },
-      "required": [
-        "type",
-        "duration"
-      ],
-      "type": "object"
-    },
-    "tweens": {
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "duration": {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          "id": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "keyframes": {
-            "additionalProperties": false,
-            "properties": {
-              "easeEach": {
-                "const": "none",
-                "type": "string"
-              },
-              "format": {
-                "const": "percentage",
-                "type": "string"
-              },
-              "keyframes": {
-                "items": {
-                  "$ref": "#/$defs/__schema35"
-                },
-                "minItems": 2,
-                "type": "array"
-              }
-            },
-            "required": [
-              "format",
-              "easeEach",
-              "keyframes"
-            ],
-            "type": "object"
-          },
-          "position": {
-            "type": "number"
-          },
-          "propertyGroup": {
-            "enum": [
-              "visual",
-              "scale",
-              "rotation",
-              "position"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "id",
-          "propertyGroup",
-          "position",
-          "duration",
-          "keyframes"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    }
-  },
-  "required": [
-    "id",
-    "startTime",
-    "duration",
-    "source"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema11

Removed value: -{
-  "additionalProperties": {},
-  "properties": {
-    "bias": {
-      "additionalProperties": {
-        "$ref": "#/$defs/__schema22"
-      },
-      "description": "Optional FINE framing nudge off the focus center, source-normalized in [−0.3, 0.3]. A small correction (headroom, rule-of-thirds), NOT a reframe — use `focus`/`zoom` for the actual shot. Omit (treated as 0) to sit dead-center on the focus.",
-      "properties": {
-        "x": {
-          "$ref": "#/$defs/__schema20"
-        },
-        "y": {
-          "$ref": "#/$defs/__schema21"
-        }
-      },
-      "required": [
-        "x",
-        "y"
-      ],
-      "type": "object"
-    },
-    "ease": {
-      "additionalProperties": {
-        "$ref": "#/$defs/__schema19"
-      },
-      "description": "Zoom/center ramp DURATIONS in SECONDS at this segment's edges — NOT a unitless 0–1 curve. ~0.3–0.6s reads as a snappy push; >1s reads sluggish. Keep `in` + `out` ≤ the segment's duration (endSec − startSec): the two edges share the span, so to ramp across the WHOLE segment set one edge to the full duration and the other to 0. Omit for an instant cut to this framing.",
-      "properties": {
-        "in": {
-          "$ref": "#/$defs/__schema17"
-        },
-        "out": {
-          "$ref": "#/$defs/__schema18"
-        }
-      },
-      "required": [
-        "in",
-        "out"
-      ],
-      "type": "object"
-    },
-    "endSec": {
-      "description": "Segment END in seconds, clip-relative. The span (endSec − startSec) is this segment's duration — the window `ease` ramps over.",
-      "exclusiveMinimum": 0,
-      "type": "number"
-    },
-    "focus": {
-      "description": "WHO/WHAT the camera tracks this segment (the reframe center), selected by `mode`: `frame-center` = no tracking, hold the geometric center (static/graphic footage, or a pure zoom); `point` = lock to a fixed source-normalized {x,y} (a non-moving on-screen element); `face` = track a detected face by `faceId` (from get_media_context), with optional `shotScale` close|standard|wide for tightness; `all-faces` = frame the bounding box of every detected face (group/ensemble shots); `active-speaker` = follow whoever is speaking (diarized talking-head / podcast). Pick by what the beat is about; pair with `zoom` for how tight.",
-      "oneOf": [
-        {
-          "$ref": "#/$defs/__schema12"
-        },
-        {
-          "$ref": "#/$defs/__schema13"
-        },
-        {
-          "$ref": "#/$defs/__schema14"
-        },
-        {
-          "$ref": "#/$defs/__schema15"
-        },
-        {
-          "$ref": "#/$defs/__schema16"
-        }
-      ]
-    },
-    "intent": {
-      "description": "Optional editorial LABEL for diff/log readability (e.g. 'speaker-tight', 'wide-context'). Cosmetic — NOT honored by the derive math and excluded from the variant cache key.",
-      "type": "string"
-    },
-    "startSec": {
-      "description": "Segment START in seconds, clip-relative. Segments tile the clip's duration in order.",
-      "minimum": 0,
-      "type": "number"
-    },
-    "zoom": {
-      "description": "How TIGHT the framing is — the fraction of the source the output viewport shows. <1 punches IN (a smaller source fraction, magnified to fill the frame); 1 = the full frame (no crop). ~0.6–0.8 is a moderate push-in, ~0.5 a tight close-up, 0.1 the maximum zoom. There is NO zoom-OUT past the full frame (max 1). Omit for the full frame. MUTUALLY EXCLUSIVE with `focus.shotScale`: a face-tracked shot is sized EITHER by the editorial scale (shotScale, calibrated to the detected face) OR by an explicit zoom — never both.",
-      "maximum": 1,
-      "minimum": 0.1,
-      "type": "number"
-    }
-  },
-  "required": [
-    "startSec",
-    "endSec",
-    "focus"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema12

Removed value: -{
-  "additionalProperties": {},
-  "properties": {
-    "mode": {
-      "const": "frame-center",
-      "type": "string"
-    }
-  },
-  "required": [
-    "mode"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema13

Removed value: -{
-  "additionalProperties": {},
-  "properties": {
-    "mode": {
-      "const": "point",
-      "type": "string"
-    },
-    "x": {
-      "maximum": 1,
-      "minimum": 0,
-      "type": "number"
-    },
-    "y": {
-      "maximum": 1,
-      "minimum": 0,
-      "type": "number"
-    }
-  },
-  "required": [
-    "mode",
-    "x",
-    "y"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema14

Removed value: -{
-  "additionalProperties": {},
-  "properties": {
-    "faceId": {
-      "minLength": 1,
-      "type": "string"
-    },
-    "mode": {
-      "const": "face",
-      "type": "string"
-    },
-    "shotScale": {
-      "enum": [
-        "close",
-        "standard",
-        "wide"
-      ],
-      "type": "string"
-    }
-  },
-  "required": [
-    "mode",
-    "faceId"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema15

Removed value: -{
-  "additionalProperties": {},
-  "properties": {
-    "mode": {
-      "const": "all-faces",
-      "type": "string"
-    }
-  },
-  "required": [
-    "mode"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema16

Removed value: -{
-  "additionalProperties": {},
-  "properties": {
-    "mode": {
-      "const": "active-speaker",
-      "type": "string"
-    }
-  },
-  "required": [
-    "mode"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema17

Removed value: -{
-  "description": "Ease-IN ramp DURATION in seconds at the segment START.",
-  "minimum": 0,
-  "type": "number"
-}

removedInput schema / $defs / __schema18

Removed value: -{
-  "description": "Ease-OUT ramp DURATION in seconds at the segment END.",
-  "minimum": 0,
-  "type": "number"
-}

removedInput schema / $defs / __schema19
```
Removed value: -{}
```

removedInput schema / $defs / __schema2

Removed value: -{
-  "minimum": 0,
-  "type": "number"
-}

removedInput schema / $defs / __schema20

Removed value: -{
-  "description": "Horizontal nudge, source-normalized (+ = right).",
-  "maximum": 0.3,
-  "minimum": -0.3,
-  "type": "number"
-}

removedInput schema / $defs / __schema21

Removed value: -{
-  "description": "Vertical nudge, source-normalized (+ = down).",
-  "maximum": 0.3,
-  "minimum": -0.3,
-  "type": "number"
-}

removedInput schema / $defs / __schema22
```
Removed value: -{}
```

removedInput schema / $defs / __schema23

Removed value: -{
-  "oneOf": [
-    {
-      "additionalProperties": false,
-      "properties": {
-        "assets": {
-          "additionalProperties": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "properties": {},
-          "propertyNames": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "componentId": {
-          "maxLength": 256,
-          "minLength": 1,
-          "type": "string"
-        },
-        "mediaBindings": {
-          "additionalProperties": {
-            "items": {
-              "maxLength": 128,
-              "minLength": 1,
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "properties": {},
-          "propertyNames": {
-            "maxLength": 128,
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "params": {
-          "additionalProperties": {
-            "$ref": "#/$defs/__schema24"
-          },
-          "properties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "seed": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "sourceVersionId": {
-          "pattern": "^[a-f0-9]{64}$",
-          "type": "string"
-        },
-        "version": {
-          "const": 3,
-          "type": "number"
-        }
-      },
-      "required": [
-        "version",
-        "componentId",
-        "sourceVersionId",
-        "params",
-        "seed"
-      ],
-      "type": "object"
-    },
-    {
-      "additionalProperties": false,
-      "properties": {
-        "assets": {
-          "additionalProperties": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "properties": {},
-          "propertyNames": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "componentId": {
-          "maxLength": 256,
-          "minLength": 1,
-          "type": "string"
-        },
-        "mediaBindings": {
-          "additionalProperties": {
-            "items": {
-              "maxLength": 128,
-              "minLength": 1,
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "properties": {},
-          "propertyNames": {
-            "maxLength": 128,
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "params": {
-          "additionalProperties": {
-            "$ref": "#/$defs/__schema24"
-          },
-          "properties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "seed": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "sourceVersionId": {
-          "pattern": "^[a-f0-9]{64}$",
-          "type": "string"
-        },
-        "version": {
-          "const": 4,
-          "type": "number"
-        }
-      },
-      "required": [
-        "version",
-        "componentId",
-        "sourceVersionId",
-        "params",
-        "seed"
-      ],
-      "type": "object"
-    }
-  ]
-}

removedInput schema / $defs / __schema24

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "number"
-    },
-    {
-      "type": "boolean"
-    },
-    {
-      "type": "null"
-    },
-    {
-      "items": {
-        "$ref": "#/$defs/__schema24"
-      },
-      "type": "array"
-    },
-    {
-      "additionalProperties": {
-        "$ref": "#/$defs/__schema24"
-      },
-      "properties": {},
-      "propertyNames": {
-        "type": "string"
-      },
-      "type": "object"
-    }
-  ]
-}

removedInput schema / $defs / __schema25

Removed value: -{
-  "minLength": 1,
-  "type": "string"
-}

removedInput schema / $defs / __schema26

Removed value: -{
-  "additionalProperties": {
-    "type": "string"
-  },
-  "properties": {},
-  "type": "object"
-}

removedInput schema / $defs / __schema27

Removed value: -{
-  "maximum": 2,
-  "minimum": -1,
-  "type": "number"
-}

removedInput schema / $defs / __schema28

Removed value: -{
-  "maximum": 2,
-  "minimum": -1,
-  "type": "number"
-}

removedInput schema / $defs / __schema29
```
Removed value: -{}
```

removedInput schema / $defs / __schema3

Removed value: -{
-  "exclusiveMinimum": 0,
-  "type": "number"
-}

removedInput schema / $defs / __schema30

Removed value: -{
-  "maximum": 1,
-  "minimum": 0,
-  "type": "number"
-}

removedInput schema / $defs / __schema31

Removed value: -{
-  "maximum": 1,
-  "minimum": 0,
-  "type": "number"
-}

removedInput schema / $defs / __schema32

Removed value: -{
-  "exclusiveMinimum": 0,
-  "maximum": 1,
-  "type": "number"
-}

removedInput schema / $defs / __schema33

Removed value: -{
-  "exclusiveMinimum": 0,
-  "maximum": 1,
-  "type": "number"
-}

removedInput schema / $defs / __schema34
```
Removed value: -{}
```

removedInput schema / $defs / __schema35

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "ease": {
-      "type": "string"
-    },
-    "percentage": {
-      "type": "number"
-    },
-    "properties": {
-      "additionalProperties": {
-        "type": "number"
-      },
-      "properties": {},
-      "propertyNames": {
-        "type": "string"
-      },
-      "type": "object"
-    }
-  },
-  "required": [
-    "percentage",
-    "properties"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema36

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "t": {
-      "type": "number"
-    },
-    "v": {
-      "type": "number"
-    }
-  },
-  "required": [
-    "t",
-    "v"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema37

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "enabled": {
-      "type": "boolean"
-    },
-    "mediaId": {
-      "type": "string"
-    },
-    "sha256": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "mediaId",
-    "sha256",
-    "enabled"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema38

Removed value: -{
-  "maximum": 1,
-  "minimum": 0,
-  "type": "number"
-}

removedInput schema / $defs / __schema39

Removed value: -{
-  "maximum": 1,
-  "minimum": 0,
-  "type": "number"
-}

removedInput schema / $defs / __schema4

Removed value: -{
-  "description": "The mandated graphic's editorial role (the graphics-plan GraphicRole vocabulary).",
-  "enum": [
-    "title-card",
-    "stat",
-    "lower-third",
-    "pull-quote",
-    "hero",
-    "logo-tag",
-    "enumeration",
-    "sequence",
-    "comparison"
-  ],
-  "type": "string"
-}

removedInput schema / $defs / __schema40

Removed value: -{
-  "maximum": 1,
-  "minimum": 0,
-  "type": "number"
-}

removedInput schema / $defs / __schema42

Removed value: -{
-  "enum": [
-    "content",
-    "layout",
-    "motion"
-  ],
-  "type": "string"
-}

removedInput schema / $defs / __schema5

Removed value: -{
-  "description": "Mandated list items (enumeration/sequence) — carried VERBATIM into the plan's copy.items.",
-  "items": {
-    "$ref": "#/$defs/__schema6"
-  },
-  "maxItems": 8,
-  "type": "array"
-}

removedInput schema / $defs / __schema6

Removed value: -{
-  "maxLength": 80,
-  "minLength": 1,
-  "type": "string"
-}

removedInput schema / properties / body / properties / audio / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / body / properties / audio / description

Added value: +"Call describe_tool_input with tool \"create_brief\" and field \"audio\" for the exact JSON Schema."

removedInput schema / properties / body / properties / audio / properties

Removed value: -{
-  "music": {
-    "additionalProperties": false,
-    "properties": {
-      "enabled": {
-        "description": "Whether the compose carries a music bed.",
-        "type": "boolean"
-      },
-      "mediaId": {
-        "description": "Pin a client-imported track as the bed. HONOR-OR-REFUSE: must be an org-owned kind:'audio' media item, else 422 — never accept-and-ignore. Absent ⇒ generate from mood.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "mood": {
-        "description": "Freeform mood/genre prompt for the GENERATED bed (e.g. 'understated editorial, warm'). Ignored when mediaId pins a track.",
-        "maxLength": 300,
-        "type": "string"
-      }
-    },
-    "required": [
-      "enabled"
-    ],
-    "type": "object"
-  },
-  "sfx": {
-    "additionalProperties": false,
-    "properties": {
-      "intensity": {
-        "description": "SFX placement density. Real-footage content keeps restraint caps regardless ('dense' is the explicit opt-out); generated/graphic-led content unlocks the standard tier.",
-        "enum": [
-          "off",
-          "light",
-          "standard",
-          "dense"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "intensity"
-    ],
-    "type": "object"
-  }
-}

addedInput schema / properties / body / properties / beats / description

Added value: +"Call describe_tool_input with tool \"create_brief\" and field \"beats\" for the exact JSON Schema."

removedInput schema / properties / body / properties / beats / items / $ref
```
Removed value: -"#/$defs/__schema0"
```
addedInput schema / properties / body / properties / beats / items / required
```
Added value: +[
+  "id",
+  "intent"
+]
```
addedInput schema / properties / body / properties / beats / items / type
```
Added value: +"object"
```
removedInput schema / properties / body / properties / gates / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / body / properties / gates / description

Added value: +"Call describe_tool_input with tool \"create_brief\" and field \"gates\" for the exact JSON Schema."

removedInput schema / properties / body / properties / gates / properties

Removed value: -{
-  "autoApprove": {
-    "description": "true = fully autonomous (compose runs with NO gates — the headless opt-in; without it a brief holds at every stage by default). Mutually exclusive with a non-empty holdAt.",
-    "type": "boolean"
-  },
-  "holdAt": {
-    "description": "Checkpoint gates — the compose pauses at each named stage for review via resume. DEFAULT (gates absent): the compose holds at EVERY stage — your agent reviews and resumes each one; an unreviewed checkpoint times out loudly after 60min. Auto-progression is the opt-in (gates.autoApprove: true).",
-    "items": {
-      "$ref": "#/$defs/__schema42"
-    },
-    "maxItems": 3,
-    "type": "array"
-  },
-  "reviewMode": {
-    "description": "Who captures the review decision. Default 'agent': you relay the packet and call resume. 'hosted': every checkpoint mints a review-page URL (checkpoint.ready payload + get_checkpoint's reviewUrl) where a human approves/revises from the browser — no account, no agent session; the recorded decision rides the SAME resume rail and you learn of it via checkpoint webhooks / wait_job.",
-    "enum": [
-      "agent",
-      "hosted"
-    ],
-    "type": "string"
-  }
-}

changedInput schema / properties / body / properties / seededGraphics / description

Previous value: -"Client-authored graphic clips the Director must carry VERBATIM: seeded into the design loop's base composition as LOCKED clips (never re-authored, never discarded)."New value: +"Client-authored graphic clips the Director must carry VERBATIM: seeded into the design loop's base composition as LOCKED clips (never re-authored, never discarded). Call describe_tool_input with tool \"create_brief\" and field \"seededGraphics\" for the exact JSON Schema."

removedInput schema / properties / body / properties / seededGraphics / items / $ref
```
Removed value: -"#/$defs/__schema10"
```
addedInput schema / properties / body / properties / seededGraphics / items / required
```
Added value: +[
+  "id",
+  "startTime",
+  "duration",
+  "source"
+]
```
addedInput schema / properties / body / properties / seededGraphics / items / type
```
Added value: +"object"
```

Changed76 schema fields changedOct 28, 2026

addedInput schema / $defs / __schema0 / additionalProperties
```
Added value: +false
```

removedInput schema / $defs / __schema0 / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "number"
-  },
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  },
-  {
-    "items": {
-      "$ref": "#/$defs/__schema0"
-    },
-    "type": "array"
-  },
-  {
-    "additionalProperties": {
-      "$ref": "#/$defs/__schema0"
-    },
-    "properties": {},
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  }
-]

addedInput schema / $defs / __schema0 / properties

Added value: +{
+  "durationSec": {
+    "exclusiveMinimum": 0,
+    "type": "number"
+  },
+  "graphic": {
+    "additionalProperties": false,
+    "description": "GRAPHICS MANDATE: the plan MUST carry a graphics request of this role overlapping this beat's window — enforced at the plan gate (honor-or-refuse, like moment pinning). Prose mustIncludes reaches only the judge; this is the checkable form.",
+    "properties": {
+      "items": {
+        "$ref": "#/$defs/__schema5"
+      },
+      "role": {
+        "$ref": "#/$defs/__schema4"
+      }
+    },
+    "required": [
+      "role"
+    ],
+    "type": "object"
+  },
+  "id": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "intent": {
+    "description": "What this beat DOES editorially (hook the claim, prove it, CTA…).",
+    "minLength": 1,
+    "type": "string"
+  },
+  "source": {
+    "additionalProperties": false,
+    "description": "MOMENT PINNING: this beat uses EXACTLY this window of this media item — honored to-the-frame or refused. v1: every sourced beat must reference the SAME mediaId (multi-source briefs are refused loudly, not silently merged).",
+    "properties": {
+      "endSec": {
+        "$ref": "#/$defs/__schema3"
+      },
+      "mediaId": {
+        "$ref": "#/$defs/__schema1"
+      },
+      "startSec": {
+        "$ref": "#/$defs/__schema2"
+      }
+    },
+    "required": [
+      "mediaId",
+      "startSec",
+      "endSec"
+    ],
+    "type": "object"
+  }
+}

addedInput schema / $defs / __schema0 / required
```
Added value: +[
+  "id",
+  "intent"
+]
```
addedInput schema / $defs / __schema0 / type
```
Added value: +"object"
```

addedInput schema / $defs / __schema1

Added value: +{
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / $defs / __schema10

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "automation": {
+      "additionalProperties": false,
+      "properties": {
+        "lanes": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "points": {
+                "items": {
+                  "$ref": "#/$defs/__schema36"
+                },
+                "minItems": 2,
+                "type": "array"
+              },
+              "target": {
+                "const": "volume",
+                "type": "string"
+              }
+            },
+            "required": [
+              "target",
+              "points"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "version": {
+          "const": 1,
+          "type": "number"
+        }
+      },
+      "required": [
+        "version",
+        "lanes"
+      ],
+      "type": "object"
+    },
+    "captionVisibility": {
+      "description": "Video media clip only. Hide native captions while this clip is topmost and covers the lower picture, or when an opaque, effect-free clip has an explicitly full-frame region, even with fit:contain. Caption words and timings remain stored and resume when another visible clip takes over.",
+      "enum": [
+        "visible",
+        "hidden"
+      ],
+      "type": "string"
+    },
+    "color": {
+      "additionalProperties": false,
+      "properties": {
+        "creative": {
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "mediaId": {
+              "type": "string"
+            },
+            "sha256": {
+              "type": "string"
+            },
+            "strength": {
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            }
+          },
+          "required": [
+            "mediaId",
+            "sha256",
+            "enabled",
+            "strength"
+          ],
+          "type": "object"
+        },
+        "display": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "enabled": {
+                  "type": "boolean"
+                },
+                "mediaId": {
+                  "type": "string"
+                },
+                "sha256": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "mediaId",
+                "sha256",
+                "enabled"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "bundled": {
+                  "enum": [
+                    "daylight-negative",
+                    "tungsten-negative",
+                    "soft-negative",
+                    "slide",
+                    "black-and-white"
+                  ],
+                  "type": "string"
+                },
+                "enabled": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "bundled",
+                "enabled"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "enabled": {
+          "type": "boolean"
+        },
+        "grade": {
+          "additionalProperties": false,
+          "properties": {
+            "blacks": {
+              "maximum": 1,
+              "minimum": -1,
+              "type": "number"
+            },
+            "contrast": {
+              "maximum": 1,
+              "minimum": -1,
+              "type": "number"
+            },
+            "exposure": {
+              "maximum": 4,
+              "minimum": -4,
+              "type": "number"
+            },
+            "highlights": {
+              "maximum": 1,
+              "minimum": -1,
+              "type": "number"
+            },
+            "saturation": {
+              "maximum": 1,
+              "minimum": -1,
+              "type": "number"
+            },
+            "shadows": {
+              "maximum": 1,
+              "minimum": -1,
+              "type": "number"
+            },
+            "temperature": {
+              "maximum": 1,
+              "minimum": -1,
+              "type": "number"
+            },
+            "tint": {
+              "maximum": 1,
+              "minimum": -1,
+              "type": "number"
+            },
+            "vibrance": {
+              "maximum": 1,
+              "minimum": -1,
+              "type": "number"
+            },
+            "whites": {
+              "maximum": 1,
+              "minimum": -1,
+              "type": "number"
+            }
+          },
+          "required": [
+            "exposure",
+            "contrast",
+            "highlights",
+            "shadows",
+            "whites",
+            "blacks",
+            "temperature",
+            "tint",
+            "vibrance",
+            "saturation"
+          ],
+          "type": "object"
+        },
+        "grain": {
+          "additionalProperties": false,
+          "properties": {
+            "amount": {
+              "maximum": 2,
+              "minimum": 0,
+              "type": "number"
+            },
+            "enabled": {
+              "type": "boolean"
+            },
+            "gauge": {
+              "enum": [
+                "super8",
+                "super16",
+                "super35",
+                "65mm"
+              ],
+              "type": "string"
+            },
+            "profile": {
+              "enum": [
+                "daylight-negative",
+                "tungsten-negative",
+                "soft-negative",
+                "slide",
+                "black-and-white"
+              ],
+              "type": "string"
+            },
+            "seed": {
+              "maximum": 4294967295,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "size": {
+              "maximum": 4,
+              "minimum": 0.5,
+              "type": "number"
+            }
+          },
+          "required": [
+            "enabled",
+            "profile",
+            "gauge",
+            "amount",
+            "size",
+            "seed"
+          ],
+          "type": "object"
+        },
+        "halation": {
+          "additionalProperties": false,
+          "properties": {
+            "amount": {
+              "maximum": 0.5,
+              "minimum": 0,
+              "type": "number"
+            },
+            "enabled": {
+              "type": "boolean"
+            },
+            "radius": {
+              "maximum": 0.02,
+              "minimum": 0.0005,
+              "type": "number"
+            },
+            "threshold": {
+              "maximum": 16,
+              "minimum": 0,
+              "type": "number"
+            },
+            "tint": {
+              "items": false,
+              "maxItems": 3,
+              "minItems": 3,
+              "prefixItems": [
+                {
+                  "$ref": "#/$defs/__schema38"
+                },
+                {
+                  "$ref": "#/$defs/__schema39"
+                },
+                {
+                  "$ref": "#/$defs/__schema40"
+                }
+              ],
+              "type": "array"
+            }
+          },
+          "required": [
+            "enabled",
+            "amount",
+            "radius",
+            "threshold",
+            "tint"
+          ],
+          "type": "object"
+        },
+        "looks": {
+          "items": {
+            "$ref": "#/$defs/__schema37"
+          },
+          "maxItems": 2,
+          "type": "array"
+        },
+        "version": {
+          "const": 1,
+          "type": "number"
+        }
+      },
+      "required": [
+        "version",
+        "enabled",
+        "grade",
+        "looks"
+      ],
+      "type": "object"
+    },
+    "duration": {
+      "exclusiveMinimum": 0,
+      "type": "number"
+    },
+    "effects": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "component": {
+            "$ref": "#/$defs/__schema23"
+          },
+          "id": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "params": {
+            "additionalProperties": {},
+            "properties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "primitiveId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "window": {
+            "additionalProperties": false,
+            "properties": {
+              "duration": {
+                "exclusiveMinimum": 0,
+                "type": "number"
+              },
+              "startTime": {
+                "minimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "startTime",
+              "duration"
+            ],
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "fit": {
+      "enum": [
+        "cover",
+        "contain"
+      ],
+      "type": "string"
+    },
+    "id": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "kind": {
+      "enum": [
+        "video",
+        "audio",
+        "image",
+        "overlay",
+        "effect"
+      ],
+      "type": "string"
+    },
+    "legacyKeyframes": {
+      "additionalProperties": false,
+      "properties": {
+        "channels": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "needsUpgrade": {
+          "const": true,
+          "type": "boolean"
+        },
+        "record": {}
+      },
+      "required": [
+        "needsUpgrade",
+        "channels",
+        "record"
+      ],
+      "type": "object"
+    },
+    "linkGroupId": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "opacity": {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    "position": {
+      "additionalProperties": {
+        "$ref": "#/$defs/__schema29"
+      },
+      "description": "Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing.",
+      "properties": {
+        "x": {
+          "$ref": "#/$defs/__schema27"
+        },
+        "y": {
+          "$ref": "#/$defs/__schema28"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ],
+      "type": "object"
+    },
+    "region": {
+      "additionalProperties": {
+        "$ref": "#/$defs/__schema34"
+      },
+      "description": "A window in the frame that the clip draws into and is clipped to (top-left corner and size, each a frame fraction). Inside a region, `position` and `scale` act relative to that window, so content moved past its edge is cut off. Omit it to place the clip against the whole frame.",
+      "properties": {
+        "h": {
+          "$ref": "#/$defs/__schema33"
+        },
+        "w": {
+          "$ref": "#/$defs/__schema32"
+        },
+        "x": {
+          "$ref": "#/$defs/__schema30"
+        },
+        "y": {
+          "$ref": "#/$defs/__schema31"
+        }
+      },
+      "required": [
+        "x",
+        "y",
+        "w",
+        "h"
+      ],
+      "type": "object"
+    },
+    "rotation": {
+      "type": "number"
+    },
+    "scale": {
+      "exclusiveMinimum": 0,
+      "type": "number"
+    },
+    "source": {
+      "oneOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "anchor": {
+              "additionalProperties": {},
+              "properties": {
+                "clipId": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "offsetMs": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "clipId",
+                "offsetMs"
+              ],
+              "type": "object"
+            },
+            "audioRole": {
+              "description": "Mix role. A role sets the clip's default gain when it has no `volume` or `volumeDb`: vo 0 dB, sfx -6 dB, music -8 dB (-16 dB when any vo clip exists), ambience -22 dB. Set `volumeDb: 0` to keep a role and play the source at its own level.",
+              "enum": [
+                "sfx",
+                "music",
+                "vo",
+                "ambience"
+              ],
+              "type": "string"
+            },
+            "duck": {
+              "additionalProperties": {},
+              "properties": {
+                "attackMs": {
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "duckDb": {
+                  "maximum": 0,
+                  "type": "number"
+                },
+                "releaseMs": {
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "windows": {
+                  "items": {
+                    "additionalProperties": {},
+                    "properties": {
+                      "endMs": {
+                        "type": "number"
+                      },
+                      "startMs": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "startMs",
+                      "endMs"
+                    ],
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "required": [
+                "duckDb",
+                "attackMs",
+                "releaseMs"
+              ],
+              "type": "object"
+            },
+            "excludedRanges": {
+              "items": {
+                "additionalProperties": {},
+                "properties": {
+                  "end": {
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "reason": {
+                    "type": "string"
+                  },
+                  "start": {
+                    "minimum": 0,
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "start",
+                  "end"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "fadeInMs": {
+              "minimum": 0,
+              "type": "number"
+            },
+            "fadeOutMs": {
+              "minimum": 0,
+              "type": "number"
+            },
+            "kenBurns": {
+              "description": "Still-image motion. When unset, an image clip slowly pushes in (`in`) unless its fit is `contain` or it keyframes scale, position or rotation, so a keyframed clip renders exactly its keyframed values; set `none` for a still that holds.",
+              "enum": [
+                "in",
+                "out",
+                "pan-l",
+                "pan-r",
+                "none"
+              ],
+              "type": "string"
+            },
+            "kind": {
+              "const": "media",
+              "type": "string"
+            },
+            "loop": {
+              "type": "boolean"
+            },
+            "mediaId": {
+              "type": "string"
+            },
+            "muted": {
+              "type": "boolean"
+            },
+            "playbackRate": {
+              "exclusiveMinimum": 0,
+              "type": "number"
+            },
+            "reframe": {
+              "additionalProperties": {},
+              "properties": {
+                "segments": {
+                  "items": {
+                    "$ref": "#/$defs/__schema11"
+                  },
+                  "minItems": 1,
+                  "type": "array"
+                }
+              },
+              "required": [
+                "segments"
+              ],
+              "type": "object"
+            },
+            "sync": {
+              "enum": [
+                "video",
+                "independent"
+              ],
+              "type": "string"
+            },
+            "trim": {
+              "additionalProperties": {},
+              "properties": {
+                "end": {
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "start": {
+                  "minimum": 0,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "start",
+                "end"
+              ],
+              "type": "object"
+            },
+            "volume": {
+              "maximum": 4,
+              "minimum": 0,
+              "type": "number"
+            },
+            "volumeDb": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "kind",
+            "mediaId"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "componentId": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "execution": {
+              "$ref": "#/$defs/__schema23"
+            },
+            "kind": {
+              "const": "component",
+              "type": "string"
+            },
+            "placement": {
+              "oneOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "kind": {
+                      "const": "clip",
+                      "type": "string"
+                    },
+                    "version": {
+                      "const": 3,
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "version",
+                    "kind"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "kind": {
+                      "const": "content-slots",
+                      "type": "string"
+                    },
+                    "slots": {
+                      "additionalProperties": {
+                        "additionalProperties": false,
+                        "properties": {
+                          "ownership": {
+                            "enum": [
+                              "reference",
+                              "exclusive"
+                            ],
+                            "type": "string"
+                          },
+                          "targetClipIds": {
+                            "items": {
+                              "maxLength": 256,
+                              "minLength": 1,
+                              "type": "string"
+                            },
+                            "type": "array"
+                          }
+                        },
+                        "required": [
+                          "targetClipIds",
+                          "ownership"
+                        ],
+                        "type": "object"
+                      },
+                      "properties": {},
+                      "propertyNames": {
+                        "maxLength": 256,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "type": "object"
+                    },
+                    "version": {
+                      "const": 3,
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "version",
+                    "kind",
+                    "slots"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "props": {
+              "additionalProperties": {},
+              "properties": {},
+              "propertyNames": {
+                "type": "string"
+              },
+              "type": "object"
+            },
+            "retired": {
+              "additionalProperties": {},
+              "properties": {},
+              "propertyNames": {
+                "type": "string"
+              },
+              "type": "object"
+            },
+            "zPlane": {
+              "enum": [
+                "front",
+                "behind-subject"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "kind",
+            "componentId",
+            "props"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "anchor": {
+              "additionalProperties": {},
+              "properties": {
+                "space": {
+                  "const": "scene",
+                  "type": "string"
+                },
+                "x": {
+                  "maximum": 1,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "y": {
+                  "maximum": 1,
+                  "minimum": 0,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "space",
+                "x",
+                "y"
+              ],
+              "type": "object"
+            },
+            "kind": {
+              "const": "overlay",
+              "type": "string"
+            },
+            "parallax": {
+              "maximum": 0.3,
+              "minimum": -0.3,
+              "type": "number"
+            },
+            "params": {
+              "additionalProperties": {},
+              "properties": {},
+              "propertyNames": {
+                "type": "string"
+              },
+              "type": "object"
+            },
+            "primitiveId": {
+              "minLength": 1,
+              "pattern": "^(?!custom$)",
+              "type": "string"
+            },
+            "zPlane": {
+              "enum": [
+                "front",
+                "behind-subject"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "kind",
+            "primitiveId",
+            "params"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "component": {
+              "$ref": "#/$defs/__schema23"
+            },
+            "kind": {
+              "const": "effect",
+              "type": "string"
+            },
+            "params": {
+              "additionalProperties": {},
+              "properties": {},
+              "propertyNames": {
+                "type": "string"
+              },
+              "type": "object"
+            },
+            "primitiveId": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "targetTrackIds": {
+              "items": {
+                "$ref": "#/$defs/__schema25"
+              },
+              "minItems": 1,
+              "type": "array"
+            },
+            "wrapperOrder": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "kind"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "html": {
+              "description": "Self-contained card markup sized to the format's pixel frame. Motion comes from frame-driven vars, never @keyframes or transition: --cf-frame, --cf-t (seconds), --cf-fps, --cf-duration, --cf-progress, --cf-ease, --cf-enter, --cf-exit. Visible copy goes in the html as plain text. Wrap a run in <span data-cf-split=\"words\"> or \"chars\" and each unit becomes its own span carrying --cf-i (its index, the group carries --cf-n), so one rule staggers it (in chars, spaces count as units), e.g. opacity:clamp(0,calc(var(--cf-t)*4 - var(--cf-i)*.3),1). save_as_template binds that copy with textParams match.",
+              "minLength": 1,
+              "type": "string"
+            },
+            "kind": {
+              "const": "card",
+              "type": "string"
+            },
+            "tokens": {
+              "$ref": "#/$defs/__schema26",
+              "description": "Style values the html reads as CSS custom properties: key x becomes --cf-x, so never put dashes in a key. Use tokens for colours and sizes, not visible copy.",
+              "propertyNames": {
+                "type": "string"
+              }
+            },
+            "zPlane": {
+              "const": "front",
+              "type": "string"
+            }
+          },
+          "required": [
+            "kind",
+            "html"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "compositionId": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "kind": {
+              "const": "composition",
+              "type": "string"
+            },
+            "trim": {
+              "additionalProperties": {},
+              "properties": {
+                "end": {
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "start": {
+                  "minimum": 0,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "start",
+                "end"
+              ],
+              "type": "object"
+            }
+          },
+          "required": [
+            "kind",
+            "compositionId"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "startTime": {
+      "minimum": 0,
+      "type": "number"
+    },
+    "transitionIn": {
+      "additionalProperties": {},
+      "properties": {
+        "component": {
+          "$ref": "#/$defs/__schema23"
+        },
+        "duration": {
+          "exclusiveMinimum": 0,
+          "type": "number"
+        },
+        "fromClipId": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "handlePolicy": {
+          "const": "outgoing-overrun-at-cut-v1",
+          "type": "string"
+        },
+        "id": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "toClipId": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "duration"
+      ],
+      "type": "object"
+    },
+    "tweens": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "duration": {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          "id": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "keyframes": {
+            "additionalProperties": false,
+            "properties": {
+              "easeEach": {
+                "const": "none",
+                "type": "string"
+              },
+              "format": {
+                "const": "percentage",
+                "type": "string"
+              },
+              "keyframes": {
+                "items": {
+                  "$ref": "#/$defs/__schema35"
+                },
+                "minItems": 2,
+                "type": "array"
+              }
+            },
+            "required": [
+              "format",
+              "easeEach",
+              "keyframes"
+            ],
+            "type": "object"
+          },
+          "position": {
+            "type": "number"
+          },
+          "propertyGroup": {
+            "enum": [
+              "visual",
+              "scale",
+              "rotation",
+              "position"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "propertyGroup",
+          "position",
+          "duration",
+          "keyframes"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "id",
+    "startTime",
+    "duration",
+    "source"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema11

Added value: +{
+  "additionalProperties": {},
+  "properties": {
+    "bias": {
+      "additionalProperties": {
+        "$ref": "#/$defs/__schema22"
+      },
+      "description": "Optional FINE framing nudge off the focus center, source-normalized in [−0.3, 0.3]. A small correction (headroom, rule-of-thirds), NOT a reframe — use `focus`/`zoom` for the actual shot. Omit (treated as 0) to sit dead-center on the focus.",
+      "properties": {
+        "x": {
+          "$ref": "#/$defs/__schema20"
+        },
+        "y": {
+          "$ref": "#/$defs/__schema21"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ],
+      "type": "object"
+    },
+    "ease": {
+      "additionalProperties": {
+        "$ref": "#/$defs/__schema19"
+      },
+      "description": "Zoom/center ramp DURATIONS in SECONDS at this segment's edges — NOT a unitless 0–1 curve. ~0.3–0.6s reads as a snappy push; >1s reads sluggish. Keep `in` + `out` ≤ the segment's duration (endSec − startSec): the two edges share the span, so to ramp across the WHOLE segment set one edge to the full duration and the other to 0. Omit for an instant cut to this framing.",
+      "properties": {
+        "in": {
+          "$ref": "#/$defs/__schema17"
+        },
+        "out": {
+          "$ref": "#/$defs/__schema18"
+        }
+      },
+      "required": [
+        "in",
+        "out"
+      ],
+      "type": "object"
+    },
+    "endSec": {
+      "description": "Segment END in seconds, clip-relative. The span (endSec − startSec) is this segment's duration — the window `ease` ramps over.",
+      "exclusiveMinimum": 0,
+      "type": "number"
+    },
+    "focus": {
+      "description": "WHO/WHAT the camera tracks this segment (the reframe center), selected by `mode`: `frame-center` = no tracking, hold the geometric center (static/graphic footage, or a pure zoom); `point` = lock to a fixed source-normalized {x,y} (a non-moving on-screen element); `face` = track a detected face by `faceId` (from get_media_context), with optional `shotScale` close|standard|wide for tightness; `all-faces` = frame the bounding box of every detected face (group/ensemble shots); `active-speaker` = follow whoever is speaking (diarized talking-head / podcast). Pick by what the beat is about; pair with `zoom` for how tight.",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/__schema12"
+        },
+        {
+          "$ref": "#/$defs/__schema13"
+        },
+        {
+          "$ref": "#/$defs/__schema14"
+        },
+        {
+          "$ref": "#/$defs/__schema15"
+        },
+        {
+          "$ref": "#/$defs/__schema16"
+        }
+      ]
+    },
+    "intent": {
+      "description": "Optional editorial LABEL for diff/log readability (e.g. 'speaker-tight', 'wide-context'). Cosmetic — NOT honored by the derive math and excluded from the variant cache key.",
+      "type": "string"
+    },
+    "startSec": {
+      "description": "Segment START in seconds, clip-relative. Segments tile the clip's duration in order.",
+      "minimum": 0,
+      "type": "number"
+    },
+    "zoom": {
+      "description": "How TIGHT the framing is — the fraction of the source the output viewport shows. <1 punches IN (a smaller source fraction, magnified to fill the frame); 1 = the full frame (no crop). ~0.6–0.8 is a moderate push-in, ~0.5 a tight close-up, 0.1 the maximum zoom. There is NO zoom-OUT past the full frame (max 1). Omit for the full frame. MUTUALLY EXCLUSIVE with `focus.shotScale`: a face-tracked shot is sized EITHER by the editorial scale (shotScale, calibrated to the detected face) OR by an explicit zoom — never both.",
+      "maximum": 1,
+      "minimum": 0.1,
+      "type": "number"
+    }
+  },
+  "required": [
+    "startSec",
+    "endSec",
+    "focus"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema12

Added value: +{
+  "additionalProperties": {},
+  "properties": {
+    "mode": {
+      "const": "frame-center",
+      "type": "string"
+    }
+  },
+  "required": [
+    "mode"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema13

Added value: +{
+  "additionalProperties": {},
+  "properties": {
+    "mode": {
+      "const": "point",
+      "type": "string"
+    },
+    "x": {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    "y": {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    }
+  },
+  "required": [
+    "mode",
+    "x",
+    "y"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema14

Added value: +{
+  "additionalProperties": {},
+  "properties": {
+    "faceId": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "mode": {
+      "const": "face",
+      "type": "string"
+    },
+    "shotScale": {
+      "enum": [
+        "close",
+        "standard",
+        "wide"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "mode",
+    "faceId"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema15

Added value: +{
+  "additionalProperties": {},
+  "properties": {
+    "mode": {
+      "const": "all-faces",
+      "type": "string"
+    }
+  },
+  "required": [
+    "mode"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema16

Added value: +{
+  "additionalProperties": {},
+  "properties": {
+    "mode": {
+      "const": "active-speaker",
+      "type": "string"
+    }
+  },
+  "required": [
+    "mode"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema17

Added value: +{
+  "description": "Ease-IN ramp DURATION in seconds at the segment START.",
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / $defs / __schema18

Added value: +{
+  "description": "Ease-OUT ramp DURATION in seconds at the segment END.",
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / $defs / __schema19
```
Added value: +{}
```

addedInput schema / $defs / __schema2

Added value: +{
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / $defs / __schema20

Added value: +{
+  "description": "Horizontal nudge, source-normalized (+ = right).",
+  "maximum": 0.3,
+  "minimum": -0.3,
+  "type": "number"
+}

addedInput schema / $defs / __schema21

Added value: +{
+  "description": "Vertical nudge, source-normalized (+ = down).",
+  "maximum": 0.3,
+  "minimum": -0.3,
+  "type": "number"
+}

addedInput schema / $defs / __schema22
```
Added value: +{}
```

addedInput schema / $defs / __schema23

Added value: +{
+  "oneOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "assets": {
+          "additionalProperties": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "properties": {},
+          "propertyNames": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "componentId": {
+          "maxLength": 256,
+          "minLength": 1,
+          "type": "string"
+        },
+        "mediaBindings": {
+          "additionalProperties": {
+            "items": {
+              "maxLength": 128,
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "properties": {},
+          "propertyNames": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "params": {
+          "additionalProperties": {
+            "$ref": "#/$defs/__schema24"
+          },
+          "properties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "seed": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "sourceVersionId": {
+          "pattern": "^[a-f0-9]{64}$",
+          "type": "string"
+        },
+        "version": {
+          "const": 3,
+          "type": "number"
+        }
+      },
+      "required": [
+        "version",
+        "componentId",
+        "sourceVersionId",
+        "params",
+        "seed"
+      ],
+      "type": "object"
+    },
+    {
+      "additionalProperties": false,
+      "properties": {
+        "assets": {
+          "additionalProperties": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "properties": {},
+          "propertyNames": {
+            "maxLength": 256,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "componentId": {
+          "maxLength": 256,
+          "minLength": 1,
+          "type": "string"
+        },
+        "mediaBindings": {
+          "additionalProperties": {
+            "items": {
+              "maxLength": 128,
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "properties": {},
+          "propertyNames": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "params": {
+          "additionalProperties": {
+            "$ref": "#/$defs/__schema24"
+          },
+          "properties": {},
+          "propertyNames": {
+            "type": "string"
+          },
+          "type": "object"
+        },
+        "seed": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "sourceVersionId": {
+          "pattern": "^[a-f0-9]{64}$",
+          "type": "string"
+        },
+        "version": {
+          "const": 4,
+          "type": "number"
+        }
+      },
+      "required": [
+        "version",
+        "componentId",
+        "sourceVersionId",
+        "params",
+        "seed"
+      ],
+      "type": "object"
+    }
+  ]
+}

addedInput schema / $defs / __schema24

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "number"
+    },
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    },
+    {
+      "items": {
+        "$ref": "#/$defs/__schema24"
+      },
+      "type": "array"
+    },
+    {
+      "additionalProperties": {
+        "$ref": "#/$defs/__schema24"
+      },
+      "properties": {},
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    }
+  ]
+}

addedInput schema / $defs / __schema25

Added value: +{
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / $defs / __schema26

Added value: +{
+  "additionalProperties": {
+    "type": "string"
+  },
+  "properties": {},
+  "type": "object"
+}

addedInput schema / $defs / __schema27

Added value: +{
+  "maximum": 2,
+  "minimum": -1,
+  "type": "number"
+}

addedInput schema / $defs / __schema28

Added value: +{
+  "maximum": 2,
+  "minimum": -1,
+  "type": "number"
+}

addedInput schema / $defs / __schema29
```
Added value: +{}
```

addedInput schema / $defs / __schema3

Added value: +{
+  "exclusiveMinimum": 0,
+  "type": "number"
+}

addedInput schema / $defs / __schema30

Added value: +{
+  "maximum": 1,
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / $defs / __schema31

Added value: +{
+  "maximum": 1,
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / $defs / __schema32

Added value: +{
+  "exclusiveMinimum": 0,
+  "maximum": 1,
+  "type": "number"
+}

addedInput schema / $defs / __schema33

Added value: +{
+  "exclusiveMinimum": 0,
+  "maximum": 1,
+  "type": "number"
+}

addedInput schema / $defs / __schema34
```
Added value: +{}
```

addedInput schema / $defs / __schema35

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "ease": {
+      "type": "string"
+    },
+    "percentage": {
+      "type": "number"
+    },
+    "properties": {
+      "additionalProperties": {
+        "type": "number"
+      },
+      "properties": {},
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    }
+  },
+  "required": [
+    "percentage",
+    "properties"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema36

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "t": {
+      "type": "number"
+    },
+    "v": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "t",
+    "v"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema37

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "enabled": {
+      "type": "boolean"
+    },
+    "mediaId": {
+      "type": "string"
+    },
+    "sha256": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "mediaId",
+    "sha256",
+    "enabled"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema38

Added value: +{
+  "maximum": 1,
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / $defs / __schema39

Added value: +{
+  "maximum": 1,
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / $defs / __schema4

Added value: +{
+  "description": "The mandated graphic's editorial role (the graphics-plan GraphicRole vocabulary).",
+  "enum": [
+    "title-card",
+    "stat",
+    "lower-third",
+    "pull-quote",
+    "hero",
+    "logo-tag",
+    "enumeration",
+    "sequence",
+    "comparison"
+  ],
+  "type": "string"
+}

addedInput schema / $defs / __schema40

Added value: +{
+  "maximum": 1,
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / $defs / __schema41

Added value: +{
+  "enum": [
+    "overlay",
+    "component",
+    "card",
+    "no-transitions"
+  ],
+  "type": "string"
+}

addedInput schema / $defs / __schema42

Added value: +{
+  "enum": [
+    "content",
+    "layout",
+    "motion"
+  ],
+  "type": "string"
+}

addedInput schema / $defs / __schema43

Added value: +{
+  "maxLength": 128,
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / $defs / __schema5

Added value: +{
+  "description": "Mandated list items (enumeration/sequence) — carried VERBATIM into the plan's copy.items.",
+  "items": {
+    "$ref": "#/$defs/__schema6"
+  },
+  "maxItems": 8,
+  "type": "array"
+}

addedInput schema / $defs / __schema6

Added value: +{
+  "maxLength": 80,
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / $defs / __schema7

Added value: +{
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / $defs / __schema8
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / $defs / __schema9

Added value: +{
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / body / properties / beats / items / $ref
```
Added value: +"#/$defs/__schema0"
```
removedInput schema / properties / body / properties / beats / items / additionalProperties
```
Removed value: -false
```

removedInput schema / properties / body / properties / beats / items / properties

Removed value: -{
-  "durationSec": {
-    "exclusiveMinimum": 0,
-    "type": "number"
-  },
-  "graphic": {
-    "additionalProperties": false,
-    "description": "GRAPHICS MANDATE: the plan MUST carry a graphics request of this role overlapping this beat's window — enforced at the plan gate (honor-or-refuse, like moment pinning). Prose mustIncludes reaches only the judge; this is the checkable form.",
-    "properties": {
-      "items": {
-        "description": "Mandated list items (enumeration/sequence) — carried VERBATIM into the plan's copy.items.",
-        "items": {
-          "maxLength": 80,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 8,
-        "type": "array"
-      },
-      "role": {
-        "description": "The mandated graphic's editorial role (the graphics-plan GraphicRole vocabulary).",
-        "enum": [
-          "title-card",
-          "stat",
-          "lower-third",
-          "pull-quote",
-          "hero",
-          "logo-tag",
-          "enumeration",
-          "sequence",
-          "comparison"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "role"
-    ],
-    "type": "object"
-  },
-  "id": {
-    "minLength": 1,
-    "type": "string"
-  },
-  "intent": {
-    "description": "What this beat DOES editorially (hook the claim, prove it, CTA…).",
-    "minLength": 1,
-    "type": "string"
-  },
-  "source": {
-    "additionalProperties": false,
-    "description": "MOMENT PINNING: this beat uses EXACTLY this window of this media item — honored to-the-frame or refused. v1: every sourced beat must reference the SAME mediaId (multi-source briefs are refused loudly, not silently merged).",
-    "properties": {
-      "endSec": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "mediaId": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "startSec": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "mediaId",
-      "startSec",
-      "endSec"
-    ],
-    "type": "object"
-  }
-}

removedInput schema / properties / body / properties / beats / items / required
```
Removed value: -[
-  "id",
-  "intent"
-]
```
removedInput schema / properties / body / properties / beats / items / type
```
Removed value: -"object"
```
addedInput schema / properties / body / properties / captions / properties / emphasisPhrases / items / $ref
```
Added value: +"#/$defs/__schema9"
```
removedInput schema / properties / body / properties / captions / properties / emphasisPhrases / items / minLength
```
Removed value: -1
```
removedInput schema / properties / body / properties / captions / properties / emphasisPhrases / items / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / exclusions / items / $ref
```
Added value: +"#/$defs/__schema41"
```

removedInput schema / properties / body / properties / exclusions / items / enum

Removed value: -[
-  "overlay",
-  "component",
-  "card",
-  "no-transitions"
-]

removedInput schema / properties / body / properties / exclusions / items / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / gates / properties / holdAt / items / $ref
```
Added value: +"#/$defs/__schema42"
```
removedInput schema / properties / body / properties / gates / properties / holdAt / items / enum
```
Removed value: -[
-  "content",
-  "layout",
-  "motion"
-]
```
removedInput schema / properties / body / properties / gates / properties / holdAt / items / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / mustIncludes / items / $ref
```
Added value: +"#/$defs/__schema7"
```
removedInput schema / properties / body / properties / mustIncludes / items / minLength
```
Removed value: -1
```
removedInput schema / properties / body / properties / mustIncludes / items / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / references / items / $ref
```
Added value: +"#/$defs/__schema8"
```
removedInput schema / properties / body / properties / references / items / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / seededGraphics / items / $ref
```
Added value: +"#/$defs/__schema10"
```
removedInput schema / properties / body / properties / seededGraphics / items / additionalProperties
```
Removed value: -false
```

removedInput schema / properties / body / properties / seededGraphics / items / properties

Removed value: -{
-  "automation": {
-    "additionalProperties": false,
-    "properties": {
-      "lanes": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "points": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "t": {
-                    "type": "number"
-                  },
-                  "v": {
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "t",
-                  "v"
-                ],
-                "type": "object"
-              },
-              "minItems": 2,
-              "type": "array"
-            },
-            "target": {
-              "const": "volume",
-              "type": "string"
-            }
-          },
-          "required": [
-            "target",
-            "points"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "version": {
-        "const": 1,
-        "type": "number"
-      }
-    },
-    "required": [
-      "version",
-      "lanes"
-    ],
-    "type": "object"
-  },
-  "captionVisibility": {
-    "description": "Video media clip only. Hide native captions while this clip is topmost and covers the lower picture, or when an opaque, effect-free clip has an explicitly full-frame region, even with fit:contain. Caption words and timings remain stored and resume when another visible clip takes over.",
-    "enum": [
-      "visible",
-      "hidden"
-    ],
-    "type": "string"
-  },
-  "duration": {
-    "exclusiveMinimum": 0,
-    "type": "number"
-  },
-  "effects": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "component": {
-          "oneOf": [
-            {
-              "additionalProperties": false,
-              "properties": {
-                "assets": {
-                  "additionalProperties": {
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "properties": {},
-                  "propertyNames": {
-                    "maxLength": 256,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "type": "object"
-                },
-                "componentId": {
-                  "maxLength": 256,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "mediaBindings": {
-                  "additionalProperties": {
-                    "items": {
-                      "maxLength": 128,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "properties": {},
-                  "propertyNames": {
-                    "maxLength": 128,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "type": "object"
-                },
-                "params": {
-                  "additionalProperties": {
-                    "$ref": "#/$defs/__schema0"
-                  },
-                  "properties": {},
-                  "propertyNames": {
-                    "type": "string"
-                  },
-                  "type": "object"
-                },
-                "seed": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "sourceVersionId": {
-                  "pattern": "^[a-f0-9]{64}$",
-                  "type": "string"
-                },
-                "version": {
-                  "const": 3,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "version",
-                "componentId",
-                "sourceVersionId",
-                "params",
-                "seed"
-              ],
-              "type": "object"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "assets": {
-                  "additionalProperties": {
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "properties": {},
-                  "propertyNames": {
-                    "maxLength": 256,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "type": "object"
-                },
-                "componentId": {
-                  "maxLength": 256,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "mediaBindings": {
-                  "additionalProperties": {
-                    "items": {
-                      "maxLength": 128,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "properties": {},
-                  "propertyNames": {
-                    "maxLength": 128,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "type": "object"
-                },
-                "params": {
-                  "additionalProperties": {
-                    "$ref": "#/$defs/__schema0"
-                  },
-                  "properties": {},
-                  "propertyNames": {
-                    "type": "string"
-                  },
-                  "type": "object"
-                },
-                "seed": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "sourceVersionId": {
-                  "pattern": "^[a-f0-9]{64}$",
-                  "type": "string"
-                },
-                "version": {
-                  "const": 4,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "version",
-                "componentId",
-                "sourceVersionId",
-                "params",
-                "seed"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "id": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "params": {
-          "additionalProperties": {},
-          "properties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "primitiveId": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "window": {
-          "additionalProperties": false,
-          "properties": {
-            "duration": {
-              "exclusiveMinimum": 0,
-              "type": "number"
-            },
-            "startTime": {
-              "minimum": 0,
-              "type": "number"
-            }
-          },
-          "required": [
-            "startTime",
-            "duration"
-          ],
-          "type": "object"
-        }
-      },
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "fit": {
-    "enum": [
-      "cover",
-      "contain"
-    ],
-    "type": "string"
-  },
-  "id": {
-    "minLength": 1,
-    "type": "string"
-  },
-  "kind": {
-    "enum": [
-      "video",
-      "audio",
-      "image",
-      "overlay",
-      "effect"
-    ],
-    "type": "string"
-  },
-  "legacyKeyframes": {
-    "additionalProperties": false,
-    "properties": {
-      "channels": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "needsUpgrade": {
-        "const": true,
-        "type": "boolean"
-      },
-      "record": {}
-    },
-    "required": [
-      "needsUpgrade",
-      "channels",
-      "record"
-    ],
-    "type": "object"
-  },
-  "linkGroupId": {
-    "minLength": 1,
-    "type": "string"
-  },
-  "opacity": {
-    "maximum": 1,
-    "minimum": 0,
-    "type": "number"
-  },
-  "position": {
-    "additionalProperties": {},
-    "description": "Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing.",
-    "properties": {
-      "x": {
-        "maximum": 2,
-        "minimum": -1,
-        "type": "number"
-      },
-      "y": {
-        "maximum": 2,
-        "minimum": -1,
-        "type": "number"
-      }
-    },
-    "required": [
-      "x",
-      "y"
-    ],
-    "type": "object"
-  },
-  "region": {
-    "additionalProperties": {},
-    "properties": {
-      "h": {
-        "exclusiveMinimum": 0,
-        "maximum": 1,
-        "type": "number"
-      },
-      "w": {
-        "exclusiveMinimum": 0,
-        "maximum": 1,
-        "type": "number"
-      },
-      "x": {
-        "maximum": 1,
-        "minimum": 0,
-        "type": "number"
-      },
-      "y": {
-        "maximum": 1,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "x",
-      "y",
-      "w",
-      "h"
-    ],
-    "type": "object"
-  },
-  "rotation": {
-    "type": "number"
-  },
-  "scale": {
-    "exclusiveMinimum": 0,
-    "type": "number"
-  },
-  "source": {
-    "oneOf": [
-      {
-        "additionalProperties": {},
-        "properties": {
-          "anchor": {
-            "additionalProperties": {},
-            "properties": {
-              "clipId": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "offsetMs": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "clipId",
-              "offsetMs"
-            ],
-            "type": "object"
-          },
-          "audioRole": {
-            "enum": [
-              "sfx",
-              "music",
-              "vo",
-              "ambience"
-            ],
-            "type": "string"
-          },
-          "duck": {
-            "additionalProperties": {},
-            "properties": {
-              "attackMs": {
-                "minimum": 0,
-                "type": "number"
-              },
-              "duckDb": {
-                "maximum": 0,
-                "type": "number"
-              },
-              "releaseMs": {
-                "minimum": 0,
-                "type": "number"
-              },
-              "windows": {
-                "items": {
-                  "additionalProperties": {},
-                  "properties": {
-                    "endMs": {
-                      "type": "number"
-                    },
-                    "startMs": {
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "startMs",
-                    "endMs"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "duckDb",
-              "attackMs",
-              "releaseMs"
-            ],
-            "type": "object"
-          },
-          "excludedRanges": {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "end": {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "reason": {
-                  "type": "string"
-                },
-                "start": {
-                  "minimum": 0,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "start",
-                "end"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "fadeInMs": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "fadeOutMs": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "kenBurns": {
-            "enum": [
-              "in",
-              "out",
-              "pan-l",
-              "pan-r",
-              "none"
-            ],
-            "type": "string"
-          },
-          "kind": {
-            "const": "media",
-            "type": "string"
-          },
-          "loop": {
-            "type": "boolean"
-          },
-          "mediaId": {
-            "type": "string"
-          },
-          "muted": {
-            "type": "boolean"
-          },
-          "playbackRate": {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          "reframe": {
-            "additionalProperties": {},
-            "properties": {
-              "segments": {
-                "items": {
-                  "additionalProperties": {},
-                  "properties": {
-                    "bias": {
-                      "additionalProperties": {},
-                      "description": "Optional FINE framing nudge off the focus center, source-normalized in [−0.3, 0.3]. A small correction (headroom, rule-of-thirds), NOT a reframe — use `focus`/`zoom` for the actual shot. Omit (treated as 0) to sit dead-center on the focus.",
-                      "properties": {
-                        "x": {
-                          "description": "Horizontal nudge, source-normalized (+ = right).",
-                          "maximum": 0.3,
-                          "minimum": -0.3,
-                          "type": "number"
-                        },
-                        "y": {
-                          "description": "Vertical nudge, source-normalized (+ = down).",
-                          "maximum": 0.3,
-                          "minimum": -0.3,
-                          "type": "number"
-                        }
-                      },
-                      "required": [
-                        "x",
-                        "y"
-                      ],
-                      "type": "object"
-                    },
-                    "ease": {
-                      "additionalProperties": {},
-                      "description": "Zoom/center ramp DURATIONS in SECONDS at this segment's edges — NOT a unitless 0–1 curve. ~0.3–0.6s reads as a snappy push; >1s reads sluggish. Keep `in` + `out` ≤ the segment's duration (endSec − startSec): the two edges share the span, so to ramp across the WHOLE segment set one edge to the full duration and the other to 0. Omit for an instant cut to this framing.",
-                      "properties": {
-                        "in": {
-                          "description": "Ease-IN ramp DURATION in seconds at the segment START.",
-                          "minimum": 0,
-                          "type": "number"
-                        },
-                        "out": {
-                          "description": "Ease-OUT ramp DURATION in seconds at the segment END.",
-                          "minimum": 0,
-                          "type": "number"
-                        }
-                      },
-                      "required": [
-                        "in",
-                        "out"
-                      ],
-                      "type": "object"
-                    },
-                    "endSec": {
-                      "description": "Segment END in seconds, clip-relative. The span (endSec − startSec) is this segment's duration — the window `ease` ramps over.",
-                      "exclusiveMinimum": 0,
-                      "type": "number"
-                    },
-                    "focus": {
-                      "description": "WHO/WHAT the camera tracks this segment (the reframe center), selected by `mode`: `frame-center` = no tracking, hold the geometric center (static/graphic footage, or a pure zoom); `point` = lock to a fixed source-normalized {x,y} (a non-moving on-screen element); `face` = track a detected face by `faceId` (from get_media_context), with optional `shotScale` close|standard|wide for tightness; `all-faces` = frame the bounding box of every detected face (group/ensemble shots); `active-speaker` = follow whoever is speaking (diarized talking-head / podcast). Pick by what the beat is about; pair with `zoom` for how tight.",
-                      "oneOf": [
-                        {
-                          "additionalProperties": {},
-                          "properties": {
-                            "mode": {
-                              "const": "frame-center",
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "mode"
-                          ],
-                          "type": "object"
-                        },
-                        {
-                          "additionalProperties": {},
-                          "properties": {
-                            "mode": {
-                              "const": "point",
-                              "type": "string"
-                            },
-                            "x": {
-                              "maximum": 1,
-                              "minimum": 0,
-                              "type": "number"
-                            },
-                            "y": {
-                              "maximum": 1,
-                              "minimum": 0,
-                              "type": "number"
-                            }
-                          },
-                          "required": [
-                            "mode",
-                            "x",
-                            "y"
-                          ],
-                          "type": "object"
-                        },
-                        {
-                          "additionalProperties": {},
-                          "properties": {
-                            "faceId": {
-                              "minLength": 1,
-                              "type": "string"
-                            },
-                            "mode": {
-                              "const": "face",
-                              "type": "string"
-                            },
-                            "shotScale": {
-                              "enum": [
-                                "close",
-                                "standard",
-                                "wide"
-                              ],
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "mode",
-                            "faceId"
-                          ],
-                          "type": "object"
-                        },
-                        {
-                          "additionalProperties": {},
-                          "properties": {
-                            "mode": {
-                              "const": "all-faces",
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "mode"
-                          ],
-                          "type": "object"
-                        },
-                        {
-                          "additionalProperties": {},
-                          "properties": {
-                            "mode": {
-                              "const": "active-speaker",
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "mode"
-                          ],
-                          "type": "object"
-                        }
-                      ]
-                    },
-                    "intent": {
-                      "description": "Optional editorial LABEL for diff/log readability (e.g. 'speaker-tight', 'wide-context'). Cosmetic — NOT honored by the derive math and excluded from the variant cache key.",
-                      "type": "string"
-                    },
-                    "startSec": {
-                      "description": "Segment START in seconds, clip-relative. Segments tile the clip's duration in order.",
-                      "minimum": 0,
-                      "type": "number"
-                    },
-                    "zoom": {
-                      "description": "How TIGHT the framing is — the fraction of the source the output viewport shows. <1 punches IN (a smaller source fraction, magnified to fill the frame); 1 = the full frame (no crop). ~0.6–0.8 is a moderate push-in, ~0.5 a tight close-up, 0.1 the maximum zoom. There is NO zoom-OUT past the full frame (max 1). Omit for the full frame. MUTUALLY EXCLUSIVE with `focus.shotScale`: a face-tracked shot is sized EITHER by the editorial scale (shotScale, calibrated to the detected face) OR by an explicit zoom — never both.",
-                      "maximum": 1,
-                      "minimum": 0.1,
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "startSec",
-                    "endSec",
-                    "focus"
-                  ],
-                  "type": "object"
-                },
-                "minItems": 1,
-                "type": "array"
-              }
-            },
-            "required": [
-              "segments"
-            ],
-            "type": "object"
-          },
-          "sync": {
-            "enum": [
-              "video",
-              "independent"
-            ],
-            "type": "string"
-          },
-          "trim": {
-            "additionalProperties": {},
-            "properties": {
-              "end": {
-                "minimum": 0,
-                "type": "number"
-              },
-              "start": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "start",
-              "end"
-            ],
-            "type": "object"
-          },
-          "volume": {
-            "maximum": 4,
-            "minimum": 0,
-            "type": "number"
-          },
-          "volumeDb": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "kind",
-          "mediaId"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "componentId": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "execution": {
-            "oneOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "assets": {
-                    "additionalProperties": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "maxLength": 256,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "componentId": {
-                    "maxLength": 256,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "mediaBindings": {
-                    "additionalProperties": {
-                      "items": {
-                        "maxLength": 128,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "maxLength": 128,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "params": {
-                    "additionalProperties": {
-                      "$ref": "#/$defs/__schema0"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "seed": {
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "sourceVersionId": {
-                    "pattern": "^[a-f0-9]{64}$",
-                    "type": "string"
-                  },
-                  "version": {
-                    "const": 3,
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "version",
-                  "componentId",
-                  "sourceVersionId",
-                  "params",
-                  "seed"
-                ],
-                "type": "object"
-              },
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "assets": {
-                    "additionalProperties": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "maxLength": 256,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "componentId": {
-                    "maxLength": 256,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "mediaBindings": {
-                    "additionalProperties": {
-                      "items": {
-                        "maxLength": 128,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "maxLength": 128,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "params": {
-                    "additionalProperties": {
-                      "$ref": "#/$defs/__schema0"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "seed": {
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "sourceVersionId": {
-                    "pattern": "^[a-f0-9]{64}$",
-                    "type": "string"
-                  },
-                  "version": {
-                    "const": 4,
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "version",
-                  "componentId",
-                  "sourceVersionId",
-                  "params",
-                  "seed"
-                ],
-                "type": "object"
-              }
-            ]
-          },
-          "kind": {
-            "const": "component",
-            "type": "string"
-          },
-          "placement": {
-            "oneOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "kind": {
-                    "const": "clip",
-                    "type": "string"
-                  },
-                  "version": {
-                    "const": 3,
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "version",
-                  "kind"
-                ],
-                "type": "object"
-              },
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "kind": {
-                    "const": "content-slots",
-                    "type": "string"
-                  },
-                  "slots": {
-                    "additionalProperties": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "ownership": {
-                          "enum": [
-                            "reference",
-                            "exclusive"
-                          ],
-                          "type": "string"
-                        },
-                        "targetClipIds": {
-                          "items": {
-                            "maxLength": 256,
-                            "minLength": 1,
-                            "type": "string"
-                          },
-                          "type": "array"
-                        }
-                      },
-                      "required": [
-                        "targetClipIds",
-                        "ownership"
-                      ],
-                      "type": "object"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "maxLength": 256,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "version": {
-                    "const": 3,
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "version",
-                  "kind",
-                  "slots"
-                ],
-                "type": "object"
-              }
-            ]
-          },
-          "props": {
-            "additionalProperties": {},
-            "properties": {},
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "retired": {
-            "additionalProperties": {},
-            "properties": {},
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "zPlane": {
-            "enum": [
-              "front",
-              "behind-subject"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "kind",
-          "componentId",
-          "props"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": {},
-        "properties": {
-          "anchor": {
-            "additionalProperties": {},
-            "properties": {
-              "space": {
-                "const": "scene",
-                "type": "string"
-              },
-              "x": {
-                "maximum": 1,
-                "minimum": 0,
-                "type": "number"
-              },
-              "y": {
-                "maximum": 1,
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "space",
-              "x",
-              "y"
-            ],
-            "type": "object"
-          },
-          "kind": {
-            "const": "overlay",
-            "type": "string"
-          },
-          "parallax": {
-            "maximum": 0.3,
-            "minimum": -0.3,
-            "type": "number"
-          },
-          "params": {
-            "additionalProperties": {},
-            "properties": {},
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "primitiveId": {
-            "minLength": 1,
-            "pattern": "^(?!custom$)",
-            "type": "string"
-          },
-          "zPlane": {
-            "enum": [
-              "front",
-              "behind-subject"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "kind",
-          "primitiveId",
-          "params"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "component": {
-            "oneOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "assets": {
-                    "additionalProperties": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "maxLength": 256,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "componentId": {
-                    "maxLength": 256,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "mediaBindings": {
-                    "additionalProperties": {
-                      "items": {
-                        "maxLength": 128,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "maxLength": 128,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "params": {
-                    "additionalProperties": {
-                      "$ref": "#/$defs/__schema0"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "seed": {
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "sourceVersionId": {
-                    "pattern": "^[a-f0-9]{64}$",
-                    "type": "string"
-                  },
-                  "version": {
-                    "const": 3,
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "version",
-                  "componentId",
-                  "sourceVersionId",
-                  "params",
-                  "seed"
-                ],
-                "type": "object"
-              },
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "assets": {
-                    "additionalProperties": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "maxLength": 256,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "componentId": {
-                    "maxLength": 256,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "mediaBindings": {
-                    "additionalProperties": {
-                      "items": {
-                        "maxLength": 128,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "maxLength": 128,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "params": {
-                    "additionalProperties": {
-                      "$ref": "#/$defs/__schema0"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  },
-                  "seed": {
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "sourceVersionId": {
-                    "pattern": "^[a-f0-9]{64}$",
-                    "type": "string"
-                  },
-                  "version": {
-                    "const": 4,
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "version",
-                  "componentId",
-                  "sourceVersionId",
-                  "params",
-                  "seed"
-                ],
-                "type": "object"
-              }
-            ]
-          },
-          "kind": {
-            "const": "effect",
-            "type": "string"
-          },
-          "params": {
-            "additionalProperties": {},
-            "properties": {},
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "primitiveId": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "targetTrackIds": {
-            "items": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "minItems": 1,
-            "type": "array"
-          },
-          "wrapperOrder": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "kind"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": {},
-        "properties": {
-          "html": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "kind": {
-            "const": "card",
-            "type": "string"
-          },
-          "tokens": {
-            "additionalProperties": {
-              "type": "string"
-            },
-            "properties": {},
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "zPlane": {
-            "const": "front",
-            "type": "string"
-          }
-        },
-        "required": [
-          "kind",
-          "html"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "compositionId": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "kind": {
-            "const": "composition",
-            "type": "string"
-          },
-          "trim": {
-            "additionalProperties": {},
-            "properties": {
-              "end": {
-                "minimum": 0,
-                "type": "number"
-              },
-              "start": {
-                "minimum": 0,
-                "type": "number"
-              }
-            },
-            "required": [
-              "start",
-              "end"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "kind",
-          "compositionId"
-        ],
-        "type": "object"
-      }
-    ]
-  },
-  "startTime": {
-    "minimum": 0,
-    "type": "number"
-  },
-  "transitionIn": {
-    "additionalProperties": {},
-    "properties": {
-      "component": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "assets": {
-                "additionalProperties": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "properties": {},
-                "propertyNames": {
-                  "maxLength": 256,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "componentId": {
-                "maxLength": 256,
-                "minLength": 1,
-                "type": "string"
-              },
-              "mediaBindings": {
-                "additionalProperties": {
-                  "items": {
-                    "maxLength": 128,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "properties": {},
-                "propertyNames": {
-                  "maxLength": 128,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "params": {
-                "additionalProperties": {
-                  "$ref": "#/$defs/__schema0"
-                },
-                "properties": {},
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "seed": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "sourceVersionId": {
-                "pattern": "^[a-f0-9]{64}$",
-                "type": "string"
-              },
-              "version": {
-                "const": 3,
-                "type": "number"
-              }
-            },
-            "required": [
-              "version",
-              "componentId",
-              "sourceVersionId",
-              "params",
-              "seed"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "assets": {
-                "additionalProperties": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "properties": {},
-                "propertyNames": {
-                  "maxLength": 256,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "componentId": {
-                "maxLength": 256,
-                "minLength": 1,
-                "type": "string"
-              },
-              "mediaBindings": {
-                "additionalProperties": {
-                  "items": {
-                    "maxLength": 128,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "properties": {},
-                "propertyNames": {
-                  "maxLength": 128,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "params": {
-                "additionalProperties": {
-                  "$ref": "#/$defs/__schema0"
-                },
-                "properties": {},
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "seed": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "sourceVersionId": {
-                "pattern": "^[a-f0-9]{64}$",
-                "type": "string"
-              },
-              "version": {
-                "const": 4,
-                "type": "number"
-              }
-            },
-            "required": [
-              "version",
-              "componentId",
-              "sourceVersionId",
-              "params",
-              "seed"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "duration": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "fromClipId": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "handlePolicy": {
-        "const": "outgoing-overrun-at-cut-v1",
-        "type": "string"
-      },
-      "id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "toClipId": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": {
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "duration"
-    ],
-    "type": "object"
-  },
-  "tweens": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "duration": {
-          "exclusiveMinimum": 0,
-          "type": "number"
-        },
-        "id": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "keyframes": {
-          "additionalProperties": false,
-          "properties": {
-            "easeEach": {
-              "const": "none",
-              "type": "string"
-            },
-            "format": {
-              "const": "percentage",
-              "type": "string"
-            },
-            "keyframes": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "ease": {
-                    "type": "string"
-                  },
-                  "percentage": {
-                    "type": "number"
-                  },
-                  "properties": {
-                    "additionalProperties": {
-                      "type": "number"
-                    },
-                    "properties": {},
-                    "propertyNames": {
-                      "type": "string"
-                    },
-                    "type": "object"
-                  }
-                },
-                "required": [
-                  "percentage",
-                  "properties"
-                ],
-                "type": "object"
-              },
-              "minItems": 2,
-              "type": "array"
-            }
-          },
-          "required": [
-            "format",
-            "easeEach",
-            "keyframes"
-          ],
-          "type": "object"
-        },
-        "position": {
-          "type": "number"
-        },
-        "propertyGroup": {
-          "enum": [
-            "visual",
-            "scale",
-            "rotation",
-            "position"
-          ],
-          "type": "string"
-        }
-      },
-      "required": [
-        "id",
-        "propertyGroup",
-        "position",
-        "duration",
-        "keyframes"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  }
-}

removedInput schema / properties / body / properties / seededGraphics / items / required
```
Removed value: -[
-  "id",
-  "startTime",
-  "duration",
-  "source"
-]
```
removedInput schema / properties / body / properties / seededGraphics / items / type
```
Removed value: -"object"
```
addedInput schema / properties / commandId / $ref
```
Added value: +"#/$defs/__schema43"
```
removedInput schema / properties / commandId / maxLength
```
Removed value: -128
```
removedInput schema / properties / commandId / minLength
```
Removed value: -1
```
removedInput schema / properties / commandId / type
```
Removed value: -"string"
```

Changed1 schema field changedOct 22, 2026

addedInput schema / properties / commandId

Added value: +{
+  "description": "Retry identity. A call repeated with the same commandId returns the first result instead of acting twice.",
+  "maxLength": 128,
+  "minLength": 1,
+  "type": "string"
+}

Changed13 schema fields changedOct 18, 2026

changedInput schema / $defs / __schema0 / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "number"
-  },
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  },
-  {
-    "items": {
-      "$ref": "#/$defs/__schema0"
-    },
-    "type": "array"
-  },
-  {
-    "additionalProperties": {
-      "$ref": "#/$defs/__schema0"
-    },
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "number"
+  },
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  },
+  {
+    "items": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "type": "array"
+  },
+  {
+    "additionalProperties": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "properties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  }
+]

changedInput schema / properties / body / properties / format / additionalProperties
```
Previous value: -falseNew value: +{}
```

removed

Input schema / properties / body / properties / seededGraphics / items / properties / effects / items / properties / component / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "assets": {
-        "additionalProperties": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "componentId": {
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "mediaBindings": {
-        "additionalProperties": {
-          "items": {
-            "maxLength": 128,
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "params": {
-        "additionalProperties": {
-          "$ref": "#/$defs/__schema0"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "seed": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "sourceVersionId": {
-        "pattern": "^[a-f0-9]{64}$",
-        "type": "string"
-      },
-      "version": {
-        "const": 3,
-        "type": "number"
-      }
-    },
-    "required": [
-      "version",
-      "componentId",
-      "sourceVersionId",
-      "params",
-      "seed"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "assets": {
-        "additionalProperties": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "componentId": {
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "mediaBindings": {
-        "additionalProperties": {
-          "items": {
-            "maxLength": 128,
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "params": {
-        "additionalProperties": {
-          "$ref": "#/$defs/__schema0"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "seed": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "sourceVersionId": {
-        "pattern": "^[a-f0-9]{64}$",
-        "type": "string"
-      },
-      "version": {
-        "const": 4,
-        "type": "number"
-      }
-    },
-    "required": [
-      "version",
-      "componentId",
-      "sourceVersionId",
-      "params",
-      "seed"
-    ],
-    "type": "object"
-  }
-]

added

Input schema / properties / body / properties / seededGraphics / items / properties / effects / items / properties / component / oneOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assets": {
+        "additionalProperties": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "properties": {},
+        "propertyNames": {
+          "maxLength": 256,
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "componentId": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mediaBindings": {
+        "additionalProperties": {
+          "items": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "properties": {},
+        "propertyNames": {
+          "maxLength": 128,
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "params": {
+        "additionalProperties": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "properties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "seed": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "sourceVersionId": {
+        "pattern": "^[a-f0-9]{64}$",
+        "type": "string"
+      },
+      "version": {
+        "const": 3,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "componentId",
+      "sourceVersionId",
+      "params",
+      "seed"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assets": {
+        "additionalProperties": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "properties": {},
+        "propertyNames": {
+          "maxLength": 256,
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "componentId": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mediaBindings": {
+        "additionalProperties": {
+          "items": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "properties": {},
+        "propertyNames": {
+          "maxLength": 128,
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "params": {
+        "additionalProperties": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "properties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "seed": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "sourceVersionId": {
+        "pattern": "^[a-f0-9]{64}$",
+        "type": "string"
+      },
+      "version": {
+        "const": 4,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "componentId",
+      "sourceVersionId",
+      "params",
+      "seed"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / body / properties / seededGraphics / items / properties / effects / items / properties / params / properties
```
Added value: +{}
```
changedInput schema / properties / body / properties / seededGraphics / items / properties / position / additionalProperties
```
Previous value: -falseNew value: +{}
```
changedInput schema / properties / body / properties / seededGraphics / items / properties / region / additionalProperties
```
Previous value: -falseNew value: +{}
```

removedInput schema / properties / body / properties / seededGraphics / items / properties / source / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "anchor": {
-        "additionalProperties": false,
-        "properties": {
-          "clipId": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "offsetMs": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "clipId",
-          "offsetMs"
-        ],
-        "type": "object"
-      },
-      "audioRole": {
-        "enum": [
-          "sfx",
-          "music",
-          "vo",
-          "ambience"
-        ],
-        "type": "string"
-      },
-      "duck": {
-        "additionalProperties": false,
-        "properties": {
-          "attackMs": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "duckDb": {
-            "maximum": 0,
-            "type": "number"
-          },
-          "releaseMs": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "windows": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "endMs": {
-                  "type": "number"
-                },
-                "startMs": {
-                  "type": "number"
-                }
-              },
-              "required": [
-                "startMs",
-                "endMs"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "duckDb",
-          "attackMs",
-          "releaseMs"
-        ],
-        "type": "object"
-      },
-      "excludedRanges": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "end": {
-              "minimum": 0,
-              "type": "number"
-            },
-            "reason": {
-              "type": "string"
-            },
-            "start": {
-              "minimum": 0,
-              "type": "number"
-            }
-          },
-          "required": [
-            "start",
-            "end"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "fadeInMs": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "fadeOutMs": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "kenBurns": {
-        "enum": [
-          "in",
-          "out",
-          "pan-l",
-          "pan-r",
-          "none"
-        ],
-        "type": "string"
-      },
-      "kind": {
-        "const": "media",
-        "type": "string"
-      },
-      "loop": {
-        "type": "boolean"
-      },
-      "mediaId": {
-        "type": "string"
-      },
-      "muted": {
-        "type": "boolean"
-      },
-      "playbackRate": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "reframe": {
-        "additionalProperties": false,
-        "properties": {
-          "segments": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "bias": {
-                  "additionalProperties": false,
-                  "description": "Optional FINE framing nudge off the focus center, source-normalized in [−0.3, 0.3]. A small correction (headroom, rule-of-thirds), NOT a reframe — use `focus`/`zoom` for the actual shot. Omit (treated as 0) to sit dead-center on the focus.",
-                  "properties": {
-                    "x": {
-                      "description": "Horizontal nudge, source-normalized (+ = right).",
-                      "maximum": 0.3,
-                      "minimum": -0.3,
-                      "type": "number"
-                    },
-                    "y": {
-                      "description": "Vertical nudge, source-normalized (+ = down).",
-                      "maximum": 0.3,
-                      "minimum": -0.3,
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "x",
-                    "y"
-                  ],
-                  "type": "object"
-                },
-                "ease": {
-                  "additionalProperties": false,
-                  "description": "Zoom/center ramp DURATIONS in SECONDS at this segment's edges — NOT a unitless 0–1 curve. ~0.3–0.6s reads as a snappy push; >1s reads sluggish. Keep `in` + `out` ≤ the segment's duration (endSec − startSec): the two edges share the span, so to ramp across the WHOLE segment set one edge to the full duration and the other to 0. Omit for an instant cut to this framing.",
-                  "properties": {
-                    "in": {
-                      "description": "Ease-IN ramp DURATION in seconds at the segment START.",
-                      "minimum": 0,
-                      "type": "number"
-                    },
-                    "out": {
-                      "description": "Ease-OUT ramp DURATION in seconds at the segment END.",
-                      "minimum": 0,
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "in",
-                    "out"
-                  ],
-                  "type": "object"
-                },
-                "endSec": {
-                  "description": "Segment END in seconds, clip-relative. The span (endSec − startSec) is this segment's duration — the window `ease` ramps over.",
-                  "exclusiveMinimum": 0,
-                  "type": "number"
-                },
-                "focus": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "mode": {
-                          "const": "frame-center",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "mode"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "mode": {
-                          "const": "point",
-                          "type": "string"
-                        },
-                        "x": {
-                          "maximum": 1,
-                          "minimum": 0,
-                          "type": "number"
-                        },
-                        "y": {
-                          "maximum": 1,
-                          "minimum": 0,
-                          "type": "number"
-                        }
-                      },
-                      "required": [
-                        "mode",
-                        "x",
-                        "y"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "faceId": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "mode": {
-                          "const": "face",
-                          "type": "string"
-                        },
-                        "shotScale": {
-                          "enum": [
-                            "close",
-                            "standard",
-                            "wide"
-                          ],
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "mode",
-                        "faceId"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "mode": {
-                          "const": "all-faces",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "mode"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "mode": {
-                          "const": "active-speaker",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "mode"
-                      ],
-                      "type": "object"
-                    }
-                  ],
-                  "description": "WHO/WHAT the camera tracks this segment (the reframe center), selected by `mode`: `frame-center` = no tracking, hold the geometric center (static/graphic footage, or a pure zoom); `point` = lock to a fixed source-normalized {x,y} (a non-moving on-screen element); `face` = track a detected face by `faceId` (from get_media_context), with optional `shotScale` close|standard|wide for tightness; `all-faces` = frame the bounding box of every detected face (group/ensemble shots); `active-speaker` = follow whoever is speaking (diarized talking-head / podcast). Pick by what the beat is about; pair with `zoom` for how tight."
-                },
-                "intent": {
-                  "description": "Optional editorial LABEL for diff/log readability (e.g. 'speaker-tight', 'wide-context'). Cosmetic — NOT honored by the derive math and excluded from the variant cache key.",
-                  "type": "string"
-                },
-                "startSec": {
-                  "description": "Segment START in seconds, clip-relative. Segments tile the clip's duration in order.",
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "zoom": {
-                  "description": "How TIGHT the framing is — the fraction of the source the output viewport shows. <1 punches IN (a smaller source fraction, magnified to fill the frame); 1 = the full frame (no crop). ~0.6–0.8 is a moderate push-in, ~0.5 a tight close-up, 0.1 the maximum zoom. There is NO zoom-OUT past the full frame (max 1). Omit for the full frame. MUTUALLY EXCLUSIVE with `focus.shotScale`: a face-tracked shot is sized EITHER by the editorial scale (shotScale, calibrated to the detected face) OR by an explicit zoom — never both.",
-                  "maximum": 1,
-                  "minimum": 0.1,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "startSec",
-                "endSec",
-                "focus"
-              ],
-              "type": "object"
-            },
-            "minItems": 1,
-            "type": "array"
-          }
-        },
-        "required": [
-          "segments"
-        ],
-        "type": "object"
-      },
-      "sync": {
-        "enum": [
-          "video",
-          "independent"
-        ],
-        "type": "string"
-      },
-      "trim": {
-        "additionalProperties": false,
-        "properties": {
-          "end": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "start": {
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "start",
-          "end"
-        ],
-        "type": "object"
-      },
-      "volume": {
-        "maximum": 4,
-        "minimum": 0,
-        "type": "number"
-      },
-      "volumeDb": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "kind",
-      "mediaId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "componentId": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "execution": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "assets": {
-                "additionalProperties": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "componentId": {
-                "maxLength": 256,
-                "minLength": 1,
-                "type": "string"
-              },
-              "mediaBindings": {
-                "additionalProperties": {
-                  "items": {
-                    "maxLength": 128,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "params": {
-                "additionalProperties": {
-                  "$ref": "#/$defs/__schema0"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "seed": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "sourceVersionId": {
-                "pattern": "^[a-f0-9]{64}$",
-                "type": "string"
-              },
-              "version": {
-                "const": 3,
-                "type": "number"
-              }
-            },
-            "required": [
-              "version",
-              "componentId",
-              "sourceVersionId",
-              "params",
-              "seed"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "assets": {
-                "additionalProperties": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "componentId": {
-                "maxLength": 256,
-                "minLength": 1,
-                "type": "string"
-              },
-              "mediaBindings": {
-                "additionalProperties": {
-                  "items": {
-                    "maxLength": 128,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "params": {
-                "additionalProperties": {
-                  "$ref": "#/$defs/__schema0"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "seed": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "sourceVersionId": {
-                "pattern": "^[a-f0-9]{64}$",
-                "type": "string"
-              },
-              "version": {
-                "const": 4,
-                "type": "number"
-              }
-            },
-            "required": [
-              "version",
-              "componentId",
-              "sourceVersionId",
-              "params",
-              "seed"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "kind": {
-        "const": "component",
-        "type": "string"
-      },
-      "placement": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "kind": {
-                "const": "clip",
-                "type": "string"
-              },
-              "version": {
-                "const": 3,
-                "type": "number"
-              }
-            },
-            "required": [
-              "version",
-              "kind"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "kind": {
-                "const": "content-slots",
-                "type": "string"
-              },
-              "slots": {
-                "additionalProperties": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "ownership": {
-                      "enum": [
-                        "reference",
-                        "exclusive"
-                      ],
-                      "type": "string"
-                    },
-                    "targetClipIds": {
-                      "items": {
-                        "maxLength": 256,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "type": "array"
-                    }
-                  },
-                  "required": [
-                    "targetClipIds",
-                    "ownership"
-                  ],
-                  "type": "object"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "version": {
-                "const": 3,
-                "type": "number"
-              }
-            },
-            "required": [
-              "version",
-              "kind",
-              "slots"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "props": {
-        "additionalProperties": {},
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "retired": {
-        "additionalProperties": {},
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "zPlane": {
-        "enum": [
-          "front",
-          "behind-subject"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "componentId",
-      "props"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "anchor": {
-        "additionalProperties": false,
-        "properties": {
-          "space": {
-            "const": "scene",
-            "type": "string"
-          },
-          "x": {
-            "maximum": 1,
-            "minimum": 0,
-            "type": "number"
-          },
-          "y": {
-            "maximum": 1,
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "space",
-          "x",
-          "y"
-        ],
-        "type": "object"
-      },
-      "kind": {
-        "const": "overlay",
-        "type": "string"
-      },
-      "parallax": {
-        "maximum": 0.3,
-        "minimum": -0.3,
-        "type": "number"
-      },
-      "params": {
-        "additionalProperties": {},
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "primitiveId": {
-        "minLength": 1,
-        "pattern": "^(?!custom$)",
-        "type": "string"
-      },
-      "zPlane": {
-        "enum": [
-          "front",
-          "behind-subject"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "primitiveId",
-      "params"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "component": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "assets": {
-                "additionalProperties": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "componentId": {
-                "maxLength": 256,
-                "minLength": 1,
-                "type": "string"
-              },
-              "mediaBindings": {
-                "additionalProperties": {
-                  "items": {
-                    "maxLength": 128,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "params": {
-                "additionalProperties": {
-                  "$ref": "#/$defs/__schema0"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "seed": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "sourceVersionId": {
-                "pattern": "^[a-f0-9]{64}$",
-                "type": "string"
-              },
-              "version": {
-                "const": 3,
-                "type": "number"
-              }
-            },
-            "required": [
-              "version",
-              "componentId",
-              "sourceVersionId",
-              "params",
-              "seed"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "assets": {
-                "additionalProperties": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "componentId": {
-                "maxLength": 256,
-                "minLength": 1,
-                "type": "string"
-              },
-              "mediaBindings": {
-                "additionalProperties": {
-                  "items": {
-                    "maxLength": 128,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "params": {
-                "additionalProperties": {
-                  "$ref": "#/$defs/__schema0"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "seed": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "sourceVersionId": {
-                "pattern": "^[a-f0-9]{64}$",
-                "type": "string"
-              },
-              "version": {
-                "const": 4,
-                "type": "number"
-              }
-            },
-            "required": [
-              "version",
-              "componentId",
-              "sourceVersionId",
-              "params",
-              "seed"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "kind": {
-        "const": "effect",
-        "type": "string"
-      },
-      "params": {
-        "additionalProperties": {},
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "primitiveId": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "targetTrackIds": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "minItems": 1,
-        "type": "array"
-      },
-      "wrapperOrder": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "html": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "kind": {
-        "const": "card",
-        "type": "string"
-      },
-      "tokens": {
-        "additionalProperties": {
-          "type": "string"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "zPlane": {
-        "const": "front",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "html"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "compositionId": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "kind": {
-        "const": "composition",
-        "type": "string"
-      },
-      "trim": {
-        "additionalProperties": false,
-        "properties": {
-          "end": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "start": {
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "start",
-          "end"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "kind",
-      "compositionId"
-    ],
-    "type": "object"
-  }
-]

addedInput schema / properties / body / properties / seededGraphics / items / properties / source / oneOf

Added value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "anchor": {
+        "additionalProperties": {},
+        "properties": {
+          "clipId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "offsetMs": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "clipId",
+          "offsetMs"
+        ],
+        "type": "object"
+      },
+      "audioRole": {
+        "enum": [
+          "sfx",
+          "music",
+          "vo",
+          "ambience"
+        ],
+        "type": "string"
+      },
+      "duck": {
+        "additionalProperties": {},
+        "properties": {
+          "attackMs": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "duckDb": {
+            "maximum": 0,
+            "type": "number"
+          },
+          "releaseMs": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "windows": {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "endMs": {
+                  "type": "number"
+                },
+                "startMs": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "startMs",
+                "endMs"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "duckDb",
+          "attackMs",
+          "releaseMs"
+        ],
+        "type": "object"
+      },
+      "excludedRanges": {
+        "items": {
+          "additionalProperties": {},
+          "properties": {
+            "end": {
+              "minimum": 0,
+              "type": "number"
+            },
+            "reason": {
+              "type": "string"
+            },
+            "start": {
+              "minimum": 0,
+              "type": "number"
+            }
+          },
+          "required": [
+            "start",
+            "end"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "fadeInMs": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "fadeOutMs": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "kenBurns": {
+        "enum": [
+          "in",
+          "out",
+          "pan-l",
+          "pan-r",
+          "none"
+        ],
+        "type": "string"
+      },
+      "kind": {
+        "const": "media",
+        "type": "string"
+      },
+      "loop": {
+        "type": "boolean"
+      },
+      "mediaId": {
+        "type": "string"
+      },
+      "muted": {
+        "type": "boolean"
+      },
+      "playbackRate": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "reframe": {
+        "additionalProperties": {},
+        "properties": {
+          "segments": {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "bias": {
+                  "additionalProperties": {},
+                  "description": "Optional FINE framing nudge off the focus center, source-normalized in [−0.3, 0.3]. A small correction (headroom, rule-of-thirds), NOT a reframe — use `focus`/`zoom` for the actual shot. Omit (treated as 0) to sit dead-center on the focus.",
+                  "properties": {
+                    "x": {
+                      "description": "Horizontal nudge, source-normalized (+ = right).",
+                      "maximum": 0.3,
+                      "minimum": -0.3,
+                      "type": "number"
+                    },
+                    "y": {
+                      "description": "Vertical nudge, source-normalized (+ = down).",
+                      "maximum": 0.3,
+                      "minimum": -0.3,
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "x",
+                    "y"
+                  ],
+                  "type": "object"
+                },
+                "ease": {
+                  "additionalProperties": {},
+                  "description": "Zoom/center ramp DURATIONS in SECONDS at this segment's edges — NOT a unitless 0–1 curve. ~0.3–0.6s reads as a snappy push; >1s reads sluggish. Keep `in` + `out` ≤ the segment's duration (endSec − startSec): the two edges share the span, so to ramp across the WHOLE segment set one edge to the full duration and the other to 0. Omit for an instant cut to this framing.",
+                  "properties": {
+                    "in": {
+                      "description": "Ease-IN ramp DURATION in seconds at the segment START.",
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "out": {
+                      "description": "Ease-OUT ramp DURATION in seconds at the segment END.",
+                      "minimum": 0,
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "in",
+                    "out"
+                  ],
+                  "type": "object"
+                },
+                "endSec": {
+                  "description": "Segment END in seconds, clip-relative. The span (endSec − startSec) is this segment's duration — the window `ease` ramps over.",
+                  "exclusiveMinimum": 0,
+                  "type": "number"
+                },
+                "focus": {
+                  "description": "WHO/WHAT the camera tracks this segment (the reframe center), selected by `mode`: `frame-center` = no tracking, hold the geometric center (static/graphic footage, or a pure zoom); `point` = lock to a fixed source-normalized {x,y} (a non-moving on-screen element); `face` = track a detected face by `faceId` (from get_media_context), with optional `shotScale` close|standard|wide for tightness; `all-faces` = frame the bounding box of every detected face (group/ensemble shots); `active-speaker` = follow whoever is speaking (diarized talking-head / podcast). Pick by what the beat is about; pair with `zoom` for how tight.",
+                  "oneOf": [
+                    {
+                      "additionalProperties": {},
+                      "properties": {
+                        "mode": {
+                          "const": "frame-center",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mode"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": {},
+                      "properties": {
+                        "mode": {
+                          "const": "point",
+                          "type": "string"
+                        },
+                        "x": {
+                          "maximum": 1,
+                          "minimum": 0,
+                          "type": "number"
+                        },
+                        "y": {
+                          "maximum": 1,
+                          "minimum": 0,
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "mode",
+                        "x",
+                        "y"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": {},
+                      "properties": {
+                        "faceId": {
+                          "minLength": 1,
+                          "type": "string"
+                        },
+                        "mode": {
+                          "const": "face",
+                          "type": "string"
+                        },
+                        "shotScale": {
+                          "enum": [
+                            "close",
+                            "standard",
+                            "wide"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mode",
+                        "faceId"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": {},
+                      "properties": {
+                        "mode": {
+                          "const": "all-faces",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mode"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": {},
+                      "properties": {
+                        "mode": {
+                          "const": "active-speaker",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mode"
+                      ],
+                      "type": "object"
+                    }
+                  ]
+                },
+                "intent": {
+                  "description": "Optional editorial LABEL for diff/log readability (e.g. 'speaker-tight', 'wide-context'). Cosmetic — NOT honored by the derive math and excluded from the variant cache key.",
+                  "type": "string"
+                },
+                "startSec": {
+                  "description": "Segment START in seconds, clip-relative. Segments tile the clip's duration in order.",
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "zoom": {
+                  "description": "How TIGHT the framing is — the fraction of the source the output viewport shows. <1 punches IN (a smaller source fraction, magnified to fill the frame); 1 = the full frame (no crop). ~0.6–0.8 is a moderate push-in, ~0.5 a tight close-up, 0.1 the maximum zoom. There is NO zoom-OUT past the full frame (max 1). Omit for the full frame. MUTUALLY EXCLUSIVE with `focus.shotScale`: a face-tracked shot is sized EITHER by the editorial scale (shotScale, calibrated to the detected face) OR by an explicit zoom — never both.",
+                  "maximum": 1,
+                  "minimum": 0.1,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "startSec",
+                "endSec",
+                "focus"
+              ],
+              "type": "object"
+            },
+            "minItems": 1,
+            "type": "array"
+          }
+        },
+        "required": [
+          "segments"
+        ],
+        "type": "object"
+      },
+      "sync": {
+        "enum": [
+          "video",
+          "independent"
+        ],
+        "type": "string"
+      },
+      "trim": {
+        "additionalProperties": {},
+        "properties": {
+          "end": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "start": {
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "start",
+          "end"
+        ],
+        "type": "object"
+      },
+      "volume": {
+        "maximum": 4,
+        "minimum": 0,
+        "type": "number"
+      },
+      "volumeDb": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "kind",
+      "mediaId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "componentId": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "execution": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "assets": {
+                "additionalProperties": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 256,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "componentId": {
+                "maxLength": 256,
+                "minLength": 1,
+                "type": "string"
+              },
+              "mediaBindings": {
+                "additionalProperties": {
+                  "items": {
+                    "maxLength": 128,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "params": {
+                "additionalProperties": {
+                  "$ref": "#/$defs/__schema0"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "seed": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "sourceVersionId": {
+                "pattern": "^[a-f0-9]{64}$",
+                "type": "string"
+              },
+              "version": {
+                "const": 3,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "componentId",
+              "sourceVersionId",
+              "params",
+              "seed"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "assets": {
+                "additionalProperties": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 256,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "componentId": {
+                "maxLength": 256,
+                "minLength": 1,
+                "type": "string"
+              },
+              "mediaBindings": {
+                "additionalProperties": {
+                  "items": {
+                    "maxLength": 128,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "params": {
+                "additionalProperties": {
+                  "$ref": "#/$defs/__schema0"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "seed": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "sourceVersionId": {
+                "pattern": "^[a-f0-9]{64}$",
+                "type": "string"
+              },
+              "version": {
+                "const": 4,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "componentId",
+              "sourceVersionId",
+              "params",
+              "seed"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "kind": {
+        "const": "component",
+        "type": "string"
+      },
+      "placement": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "kind": {
+                "const": "clip",
+                "type": "string"
+              },
+              "version": {
+                "const": 3,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "kind"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "kind": {
+                "const": "content-slots",
+                "type": "string"
+              },
+              "slots": {
+                "additionalProperties": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "ownership": {
+                      "enum": [
+                        "reference",
+                        "exclusive"
+                      ],
+                      "type": "string"
+                    },
+                    "targetClipIds": {
+                      "items": {
+                        "maxLength": 256,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "type": "array"
+                    }
+                  },
+                  "required": [
+                    "targetClipIds",
+                    "ownership"
+                  ],
+                  "type": "object"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 256,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "version": {
+                "const": 3,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "kind",
+              "slots"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "props": {
+        "additionalProperties": {},
+        "properties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "retired": {
+        "additionalProperties": {},
+        "properties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "zPlane": {
+        "enum": [
+          "front",
+          "behind-subject"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "componentId",
+      "props"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": {},
+    "properties": {
+      "anchor": {
+        "additionalProperties": {},
+        "properties": {
+          "space": {
+            "const": "scene",
+            "type": "string"
+          },
+          "x": {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          },
+          "y": {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "space",
+          "x",
+          "y"
+        ],
+        "type": "object"
+      },
+      "kind": {
+        "const": "overlay",
+        "type": "string"
+      },
+      "parallax": {
+        "maximum": 0.3,
+        "minimum": -0.3,
+        "type": "number"
+      },
+      "params": {
+        "additionalProperties": {},
+        "properties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "primitiveId": {
+        "minLength": 1,
+        "pattern": "^(?!custom$)",
+        "type": "string"
+      },
+      "zPlane": {
+        "enum": [
+          "front",
+          "behind-subject"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "primitiveId",
+      "params"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "component": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "assets": {
+                "additionalProperties": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 256,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "componentId": {
+                "maxLength": 256,
+                "minLength": 1,
+                "type": "string"
+              },
+              "mediaBindings": {
+                "additionalProperties": {
+                  "items": {
+                    "maxLength": 128,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "params": {
+                "additionalProperties": {
+                  "$ref": "#/$defs/__schema0"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "seed": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "sourceVersionId": {
+                "pattern": "^[a-f0-9]{64}$",
+                "type": "string"
+              },
+              "version": {
+                "const": 3,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "componentId",
+              "sourceVersionId",
+              "params",
+              "seed"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "assets": {
+                "additionalProperties": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 256,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "componentId": {
+                "maxLength": 256,
+                "minLength": 1,
+                "type": "string"
+              },
+              "mediaBindings": {
+                "additionalProperties": {
+                  "items": {
+                    "maxLength": 128,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "params": {
+                "additionalProperties": {
+                  "$ref": "#/$defs/__schema0"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "seed": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "sourceVersionId": {
+                "pattern": "^[a-f0-9]{64}$",
+                "type": "string"
+              },
+              "version": {
+                "const": 4,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "componentId",
+              "sourceVersionId",
+              "params",
+              "seed"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "kind": {
+        "const": "effect",
+        "type": "string"
+      },
+      "params": {
+        "additionalProperties": {},
+        "properties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "primitiveId": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "targetTrackIds": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "wrapperOrder": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": {},
+    "properties": {
+      "html": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "kind": {
+        "const": "card",
+        "type": "string"
+      },
+      "tokens": {
+        "additionalProperties": {
+          "type": "string"
+        },
+        "properties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "zPlane": {
+        "const": "front",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "html"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "compositionId": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "kind": {
+        "const": "composition",
+        "type": "string"
+      },
+      "trim": {
+        "additionalProperties": {},
+        "properties": {
+          "end": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "start": {
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "start",
+          "end"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "kind",
+      "compositionId"
+    ],
+    "type": "object"
+  }
+]

changedInput schema / properties / body / properties / seededGraphics / items / properties / transitionIn / additionalProperties
```
Previous value: -falseNew value: +{}
```

removed

Input schema / properties / body / properties / seededGraphics / items / properties / transitionIn / properties / component / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "assets": {
-        "additionalProperties": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "componentId": {
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "mediaBindings": {
-        "additionalProperties": {
-          "items": {
-            "maxLength": 128,
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "params": {
-        "additionalProperties": {
-          "$ref": "#/$defs/__schema0"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "seed": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "sourceVersionId": {
-        "pattern": "^[a-f0-9]{64}$",
-        "type": "string"
-      },
-      "version": {
-        "const": 3,
-        "type": "number"
-      }
-    },
-    "required": [
-      "version",
-      "componentId",
-      "sourceVersionId",
-      "params",
-      "seed"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "assets": {
-        "additionalProperties": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "componentId": {
-        "maxLength": 256,
-        "minLength": 1,
-        "type": "string"
-      },
-      "mediaBindings": {
-        "additionalProperties": {
-          "items": {
-            "maxLength": 128,
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "params": {
-        "additionalProperties": {
-          "$ref": "#/$defs/__schema0"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "seed": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "sourceVersionId": {
-        "pattern": "^[a-f0-9]{64}$",
-        "type": "string"
-      },
-      "version": {
-        "const": 4,
-        "type": "number"
-      }
-    },
-    "required": [
-      "version",
-      "componentId",
-      "sourceVersionId",
-      "params",
-      "seed"
-    ],
-    "type": "object"
-  }
-]

added

Input schema / properties / body / properties / seededGraphics / items / properties / transitionIn / properties / component / oneOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assets": {
+        "additionalProperties": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "properties": {},
+        "propertyNames": {
+          "maxLength": 256,
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "componentId": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mediaBindings": {
+        "additionalProperties": {
+          "items": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "properties": {},
+        "propertyNames": {
+          "maxLength": 128,
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "params": {
+        "additionalProperties": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "properties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "seed": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "sourceVersionId": {
+        "pattern": "^[a-f0-9]{64}$",
+        "type": "string"
+      },
+      "version": {
+        "const": 3,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "componentId",
+      "sourceVersionId",
+      "params",
+      "seed"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assets": {
+        "additionalProperties": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "properties": {},
+        "propertyNames": {
+          "maxLength": 256,
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "componentId": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mediaBindings": {
+        "additionalProperties": {
+          "items": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "properties": {},
+        "propertyNames": {
+          "maxLength": 128,
+          "minLength": 1,
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "params": {
+        "additionalProperties": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "properties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "seed": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "sourceVersionId": {
+        "pattern": "^[a-f0-9]{64}$",
+        "type": "string"
+      },
+      "version": {
+        "const": 4,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "componentId",
+      "sourceVersionId",
+      "params",
+      "seed"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / body / properties / seededGraphics / items / properties / tweens / items / properties / keyframes / properties / keyframes / items / properties / properties / properties
```
Added value: +{}
```

Changed20 schema fields changedOct 15, 2026

removedInput schema / properties / body / properties / format / description
```
Removed value: -"Output-format spec per §Format."
```
addedInput schema / properties / body / properties / format / properties / platform
```
Added value: +{
+  "type": "string"
+}
```

removedInput schema / properties / body / properties / seededGraphics / items / properties / animate

Removed value: -{
-  "additionalProperties": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "easing": {
-          "anyOf": [
-            {
-              "enum": [
-                "linear",
-                "ease",
-                "easeIn",
-                "easeOut",
-                "easeInOut"
-              ],
-              "type": "string"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "cubicBezier": {
-                  "items": false,
-                  "maxItems": 4,
-                  "minItems": 4,
-                  "prefixItems": [
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "number"
-                    }
-                  ],
-                  "type": "array"
-                }
-              },
-              "required": [
-                "cubicBezier"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "time": {
-          "minimum": 0,
-          "type": "number"
-        },
-        "value": {
-          "type": "number"
-        }
-      },
-      "required": [
-        "time",
-        "value"
-      ],
-      "type": "object"
-    },
-    "minItems": 2,
-    "type": "array"
-  },
-  "description": "Keyframe channels, clip-relative seconds. Each channel's values use the SAME unit as the scalar it animates: `opacity` 0 to 1, `scale` a multiplier (>0), `rotation` degrees, `position.x`/`position.y` a FRACTION of the frame like `position` (0.5 = centre; NOT pixels), `volume` 0 to 4.",
-  "propertyNames": {
-    "type": "string"
-  },
-  "type": "object"
-}

addedInput schema / properties / body / properties / seededGraphics / items / properties / automation

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "lanes": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "points": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "t": {
+                  "type": "number"
+                },
+                "v": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "t",
+                "v"
+              ],
+              "type": "object"
+            },
+            "minItems": 2,
+            "type": "array"
+          },
+          "target": {
+            "const": "volume",
+            "type": "string"
+          }
+        },
+        "required": [
+          "target",
+          "points"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "version": {
+      "const": 1,
+      "type": "number"
+    }
+  },
+  "required": [
+    "version",
+    "lanes"
+  ],
+  "type": "object"
+}

removedInput schema / properties / body / properties / seededGraphics / items / properties / duration / description
```
Removed value: -"Clip duration (seconds)."
```
removedInput schema / properties / body / properties / seededGraphics / items / properties / effects / items / properties / component / additionalProperties
```
Removed value: -false
```

added

Input schema / properties / body / properties / seededGraphics / items / properties / effects / items / properties / component / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assets": {
+        "additionalProperties": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "componentId": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mediaBindings": {
+        "additionalProperties": {
+          "items": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "params": {
+        "additionalProperties": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "seed": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "sourceVersionId": {
+        "pattern": "^[a-f0-9]{64}$",
+        "type": "string"
+      },
+      "version": {
+        "const": 3,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "componentId",
+      "sourceVersionId",
+      "params",
+      "seed"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assets": {
+        "additionalProperties": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "componentId": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mediaBindings": {
+        "additionalProperties": {
+          "items": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "params": {
+        "additionalProperties": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "seed": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "sourceVersionId": {
+        "pattern": "^[a-f0-9]{64}$",
+        "type": "string"
+      },
+      "version": {
+        "const": 4,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "componentId",
+      "sourceVersionId",
+      "params",
+      "seed"
+    ],
+    "type": "object"
+  }
+]

removed

Input schema / properties / body / properties / seededGraphics / items / properties / effects / items / properties / component / properties

Removed value: -{
-  "assets": {
-    "additionalProperties": {
-      "minLength": 1,
-      "type": "string"
-    },
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  },
-  "componentId": {
-    "maxLength": 256,
-    "minLength": 1,
-    "type": "string"
-  },
-  "mediaBindings": {
-    "additionalProperties": {
-      "items": {
-        "maxLength": 128,
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  },
-  "params": {
-    "additionalProperties": {
-      "$ref": "#/$defs/__schema0"
-    },
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  },
-  "seed": {
-    "minLength": 1,
-    "type": "string"
-  },
-  "sourceVersionId": {
-    "pattern": "^[a-f0-9]{64}$",
-    "type": "string"
-  },
-  "version": {
-    "const": 3,
-    "type": "number"
-  }
-}

removedInput schema / properties / body / properties / seededGraphics / items / properties / effects / items / properties / component / required
```
Removed value: -[
-  "version",
-  "componentId",
-  "sourceVersionId",
-  "params",
-  "seed"
-]
```
removedInput schema / properties / body / properties / seededGraphics / items / properties / effects / items / properties / component / type
```
Removed value: -"object"
```

addedInput schema / properties / body / properties / seededGraphics / items / properties / legacyKeyframes

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "channels": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "needsUpgrade": {
+      "const": true,
+      "type": "boolean"
+    },
+    "record": {}
+  },
+  "required": [
+    "needsUpgrade",
+    "channels",
+    "record"
+  ],
+  "type": "object"
+}

changedInput schema / properties / body / properties / seededGraphics / items / properties / source / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "anchor": {
-        "additionalProperties": false,
-        "properties": {
-          "clipId": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "offsetMs": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "clipId",
-          "offsetMs"
-        ],
-        "type": "object"
-      },
-      "audioRole": {
-        "enum": [
-          "sfx",
-          "music",
-          "vo",
-          "ambience"
-        ],
-        "type": "string"
-      },
-      "duck": {
-        "additionalProperties": false,
-        "properties": {
-          "attackMs": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "duckDb": {
-            "maximum": 0,
-            "type": "number"
-          },
-          "releaseMs": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "windows": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "endMs": {
-                  "type": "number"
-                },
-                "startMs": {
-                  "type": "number"
-                }
-              },
-              "required": [
-                "startMs",
-                "endMs"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "duckDb",
-          "attackMs",
-          "releaseMs"
-        ],
-        "type": "object"
-      },
-      "excludedRanges": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "end": {
-              "minimum": 0,
-              "type": "number"
-            },
-            "reason": {
-              "type": "string"
-            },
-            "start": {
-              "minimum": 0,
-              "type": "number"
-            }
-          },
-          "required": [
-            "start",
-            "end"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "fadeInMs": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "fadeOutMs": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "kenBurns": {
-        "enum": [
-          "in",
-          "out",
-          "pan-l",
-          "pan-r",
-          "none"
-        ],
-        "type": "string"
-      },
-      "kind": {
-        "const": "media",
-        "type": "string"
-      },
-      "loop": {
-        "type": "boolean"
-      },
-      "mediaId": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "muted": {
-        "type": "boolean"
-      },
-      "playbackRate": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "reframe": {
-        "additionalProperties": false,
-        "properties": {
-          "segments": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "bias": {
-                  "additionalProperties": false,
-                  "description": "Optional FINE framing nudge off the focus center, source-normalized in [−0.3, 0.3]. A small correction (headroom, rule-of-thirds), NOT a reframe — use `focus`/`zoom` for the actual shot. Omit (treated as 0) to sit dead-center on the focus.",
-                  "properties": {
-                    "x": {
-                      "description": "Horizontal nudge, source-normalized (+ = right).",
-                      "maximum": 0.3,
-                      "minimum": -0.3,
-                      "type": "number"
-                    },
-                    "y": {
-                      "description": "Vertical nudge, source-normalized (+ = down).",
-                      "maximum": 0.3,
-                      "minimum": -0.3,
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "x",
-                    "y"
-                  ],
-                  "type": "object"
-                },
-                "ease": {
-                  "additionalProperties": false,
-                  "description": "Zoom/center ramp DURATIONS in SECONDS at this segment's edges — NOT a unitless 0–1 curve. ~0.3–0.6s reads as a snappy push; >1s reads sluggish. Keep `in` + `out` ≤ the segment's duration (endSec − startSec): the two edges share the span, so to ramp across the WHOLE segment set one edge to the full duration and the other to 0. Omit for an instant cut to this framing.",
-                  "properties": {
-                    "in": {
-                      "description": "Ease-IN ramp DURATION in seconds at the segment START.",
-                      "minimum": 0,
-                      "type": "number"
-                    },
-                    "out": {
-                      "description": "Ease-OUT ramp DURATION in seconds at the segment END.",
-                      "minimum": 0,
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "in",
-                    "out"
-                  ],
-                  "type": "object"
-                },
-                "endSec": {
-                  "description": "Segment END in seconds, clip-relative. The span (endSec − startSec) is this segment's duration — the window `ease` ramps over.",
-                  "exclusiveMinimum": 0,
-                  "type": "number"
-                },
-                "focus": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "mode": {
-                          "const": "frame-center",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "mode"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "mode": {
-                          "const": "point",
-                          "type": "string"
-                        },
-                        "x": {
-                          "maximum": 1,
-                          "minimum": 0,
-                          "type": "number"
-                        },
-                        "y": {
-                          "maximum": 1,
-                          "minimum": 0,
-                          "type": "number"
-                        }
-                      },
-                      "required": [
-                        "mode",
-                        "x",
-                        "y"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "faceId": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "mode": {
-                          "const": "face",
-                          "type": "string"
-                        },
-                        "shotScale": {
-                          "enum": [
-                            "close",
-                            "standard",
-                            "wide"
-                          ],
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "mode",
-                        "faceId"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "mode": {
-                          "const": "all-faces",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "mode"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "mode": {
-                          "const": "active-speaker",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "mode"
-                      ],
-                      "type": "object"
-                    }
-                  ],
-                  "description": "WHO/WHAT the camera tracks this segment (the reframe center), selected by `mode`: `frame-center` = no tracking, hold the geometric center (static/graphic footage, or a pure zoom); `point` = lock to a fixed source-normalized {x,y} (a non-moving on-screen element); `face` = track a detected face by `faceId` (from get_media_context), with optional `shotScale` close|standard|wide for tightness; `all-faces` = frame the bounding box of every detected face (group/ensemble shots); `active-speaker` = follow whoever is speaking (diarized talking-head / podcast). Pick by what the beat is about; pair with `zoom` for how tight."
-                },
-                "intent": {
-                  "description": "Optional editorial LABEL for diff/log readability (e.g. 'speaker-tight', 'wide-context'). Cosmetic — NOT honored by the derive math and excluded from the variant cache key.",
-                  "type": "string"
-                },
-                "startSec": {
-                  "description": "Segment START in seconds, clip-relative. Segments tile the clip's duration in order.",
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "zoom": {
-                  "description": "How TIGHT the framing is — the fraction of the source the output viewport shows. <1 punches IN (a smaller source fraction, magnified to fill the frame); 1 = the full frame (no crop). ~0.6–0.8 is a moderate push-in, ~0.5 a tight close-up, 0.1 the maximum zoom. There is NO zoom-OUT past the full frame (max 1). Omit for the full frame. MUTUALLY EXCLUSIVE with `focus.shotScale` — a face-tracked shot is sized EITHER by the editorial scale (shotScale, which the bake calibrates to the detected face) OR by an explicit zoom, never both. A segment carrying both is REJECTED: shotScale wins at bake time and the zoom would be silently discarded.",
-                  "maximum": 1,
-                  "minimum": 0.1,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "startSec",
-                "endSec",
-                "focus"
-              ],
-              "type": "object"
-            },
-            "minItems": 1,
-            "type": "array"
-          }
-        },
-        "required": [
-          "segments"
-        ],
-        "type": "object"
-      },
-      "sync": {
-        "enum": [
-          "video",
-          "independent"
-        ],
-        "type": "string"
-      },
-      "trim": {
-        "additionalProperties": false,
-        "properties": {
-          "end": {
-            "description": "Source trim end (seconds).",
-            "minimum": 0,
-            "type": "number"
-          },
-          "start": {
-            "description": "Source trim start (seconds).",
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "start",
-          "end"
-        ],
-        "type": "object"
-      },
-      "volume": {
-        "maximum": 4,
-        "minimum": 0,
-        "type": "number"
-      },
-      "volumeDb": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "kind",
-      "mediaId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "componentId": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "execution": {
-        "additionalProperties": false,
-        "properties": {
-          "assets": {
-            "additionalProperties": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "componentId": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "mediaBindings": {
-            "additionalProperties": {
-              "items": {
-                "maxLength": 128,
-                "minLength": 1,
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "params": {
-            "additionalProperties": {
-              "$ref": "#/$defs/__schema0"
-            },
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "seed": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "sourceVersionId": {
-            "pattern": "^[a-f0-9]{64}$",
-            "type": "string"
-          },
-          "version": {
-            "const": 3,
-            "type": "number"
-          }
-        },
-        "required": [
-          "version",
-          "componentId",
-          "sourceVersionId",
-          "params",
-          "seed"
-        ],
-        "type": "object"
-      },
-      "kind": {
-        "const": "component",
-        "type": "string"
-      },
-      "placement": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "kind": {
-                "const": "clip",
-                "type": "string"
-              },
-              "version": {
-                "const": 3,
-                "type": "number"
-              }
-            },
-            "required": [
-              "version",
-              "kind"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "kind": {
-                "const": "content-slots",
-                "type": "string"
-              },
-              "slots": {
-                "additionalProperties": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "ownership": {
-                      "enum": [
-                        "reference",
-                        "exclusive"
-                      ],
-                      "type": "string"
-                    },
-                    "targetClipIds": {
-                      "items": {
-                        "maxLength": 256,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "type": "array"
-                    }
-                  },
-                  "required": [
-                    "targetClipIds",
-                    "ownership"
-                  ],
-                  "type": "object"
-                },
-                "propertyNames": {
-                  "type": "string"
-                },
-                "type": "object"
-              },
-              "version": {
-                "const": 3,
-                "type": "number"
-              }
-            },
-            "required": [
-              "version",
-              "kind",
-              "slots"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "props": {
-        "additionalProperties": {},
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "zPlane": {
-        "enum": [
-          "front",
-          "behind-subject"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "componentId",
-      "props",
-      "execution",
-      "placement"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "anchor": {
-        "additionalProperties": false,
-        "properties": {
-          "space": {
-            "const": "scene",
-            "type": "string"
-          },
-          "x": {
-            "maximum": 1,
-            "minimum": 0,
-            "type": "number"
-          },
-          "y": {
-            "maximum": 1,
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "space",
-          "x",
-          "y"
-        ],
-        "type": "object"
-      },
-      "kind": {
-        "const": "overlay",
-        "type": "string"
-      },
-      "parallax": {
-        "maximum": 0.3,
-        "minimum": -0.3,
-        "type": "number"
-      },
-      "params": {
-        "additionalProperties": {},
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "primitiveId": {
-        "minLength": 1,
-        "pattern": "^(?!custom$)",
-        "type": "string"
-      },
-      "zPlane": {
-        "enum": [
-          "front",
-          "behind-subject"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "primitiveId",
-      "params"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "component": {
-        "additionalProperties": false,
-        "properties": {
-          "assets": {
-            "additionalProperties": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "componentId": {
-            "maxLength": 256,
-            "minLength": 1,
-            "type": "string"
-          },
-          "mediaBindings": {
-            "additionalProperties": {
-              "items": {
-                "maxLength": 128,
-                "minLength": 1,
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "params": {
-            "additionalProperties": {
-              "$ref": "#/$defs/__schema0"
-            },
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "seed": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "sourceVersionId": {
-            "pattern": "^[a-f0-9]{64}$",
-            "type": "string"
-          },
-          "version": {
-            "const": 3,
-            "type": "number"
-          }
-        },
-        "required": [
-          "version",
-          "componentId",
-          "sourceVersionId",
-          "params",
-          "seed"
-        ],
-        "type": "object"
-      },
-      "kind": {
-        "const": "effect",
-        "type": "string"
-      },
-      "params": {
-        "additionalProperties": {},
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "primitiveId": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "targetTrackIds": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "minItems": 1,
-        "type": "array"
-      },
-      "wrapperOrder": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "html": {
-        "description": "Your card's HTML — rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080×1920 at 9:16 fhd); the root is NOT auto-pinned — declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset — keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) — the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "kind": {
-        "const": "card",
-        "type": "string"
-      },
-      "tokens": {
-        "additionalProperties": {
-          "type": "string"
-        },
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "zPlane": {
-        "const": "front",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "html"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "anchor": {
+        "additionalProperties": false,
+        "properties": {
+          "clipId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "offsetMs": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "clipId",
+          "offsetMs"
+        ],
+        "type": "object"
+      },
+      "audioRole": {
+        "enum": [
+          "sfx",
+          "music",
+          "vo",
+          "ambience"
+        ],
+        "type": "string"
+      },
+      "duck": {
+        "additionalProperties": false,
+        "properties": {
+          "attackMs": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "duckDb": {
+            "maximum": 0,
+            "type": "number"
+          },
+          "releaseMs": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "windows": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "endMs": {
+                  "type": "number"
+                },
+                "startMs": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "startMs",
+                "endMs"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "duckDb",
+          "attackMs",
+          "releaseMs"
+        ],
+        "type": "object"
+      },
+      "excludedRanges": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "end": {
+              "minimum": 0,
+              "type": "number"
+            },
+            "reason": {
+              "type": "string"
+            },
+            "start": {
+              "minimum": 0,
+              "type": "number"
+            }
+          },
+          "required": [
+            "start",
+            "end"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "fadeInMs": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "fadeOutMs": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "kenBurns": {
+        "enum": [
+          "in",
+          "out",
+          "pan-l",
+          "pan-r",
+          "none"
+        ],
+        "type": "string"
+      },
+      "kind": {
+        "const": "media",
+        "type": "string"
+      },
+      "loop": {
+        "type": "boolean"
+      },
+      "mediaId": {
+        "type": "string"
+      },
+      "muted": {
+        "type": "boolean"
+      },
+      "playbackRate": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "reframe": {
+        "additionalProperties": false,
+        "properties": {
+          "segments": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "bias": {
+                  "additionalProperties": false,
+                  "description": "Optional FINE framing nudge off the focus center, source-normalized in [−0.3, 0.3]. A small correction (headroom, rule-of-thirds), NOT a reframe — use `focus`/`zoom` for the actual shot. Omit (treated as 0) to sit dead-center on the focus.",
+                  "properties": {
+                    "x": {
+                      "description": "Horizontal nudge, source-normalized (+ = right).",
+                      "maximum": 0.3,
+                      "minimum": -0.3,
+                      "type": "number"
+                    },
+                    "y": {
+                      "description": "Vertical nudge, source-normalized (+ = down).",
+                      "maximum": 0.3,
+                      "minimum": -0.3,
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "x",
+                    "y"
+                  ],
+                  "type": "object"
+                },
+                "ease": {
+                  "additionalProperties": false,
+                  "description": "Zoom/center ramp DURATIONS in SECONDS at this segment's edges — NOT a unitless 0–1 curve. ~0.3–0.6s reads as a snappy push; >1s reads sluggish. Keep `in` + `out` ≤ the segment's duration (endSec − startSec): the two edges share the span, so to ramp across the WHOLE segment set one edge to the full duration and the other to 0. Omit for an instant cut to this framing.",
+                  "properties": {
+                    "in": {
+                      "description": "Ease-IN ramp DURATION in seconds at the segment START.",
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "out": {
+                      "description": "Ease-OUT ramp DURATION in seconds at the segment END.",
+                      "minimum": 0,
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "in",
+                    "out"
+                  ],
+                  "type": "object"
+                },
+                "endSec": {
+                  "description": "Segment END in seconds, clip-relative. The span (endSec − startSec) is this segment's duration — the window `ease` ramps over.",
+                  "exclusiveMinimum": 0,
+                  "type": "number"
+                },
+                "focus": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "mode": {
+                          "const": "frame-center",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mode"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "mode": {
+                          "const": "point",
+                          "type": "string"
+                        },
+                        "x": {
+                          "maximum": 1,
+                          "minimum": 0,
+                          "type": "number"
+                        },
+                        "y": {
+                          "maximum": 1,
+                          "minimum": 0,
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "mode",
+                        "x",
+                        "y"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "faceId": {
+                          "minLength": 1,
+                          "type": "string"
+                        },
+                        "mode": {
+                          "const": "face",
+                          "type": "string"
+                        },
+                        "shotScale": {
+                          "enum": [
+                            "close",
+                            "standard",
+                            "wide"
+                          ],
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mode",
+                        "faceId"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "mode": {
+                          "const": "all-faces",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mode"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "mode": {
+                          "const": "active-speaker",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mode"
+                      ],
+                      "type": "object"
+                    }
+                  ],
+                  "description": "WHO/WHAT the camera tracks this segment (the reframe center), selected by `mode`: `frame-center` = no tracking, hold the geometric center (static/graphic footage, or a pure zoom); `point` = lock to a fixed source-normalized {x,y} (a non-moving on-screen element); `face` = track a detected face by `faceId` (from get_media_context), with optional `shotScale` close|standard|wide for tightness; `all-faces` = frame the bounding box of every detected face (group/ensemble shots); `active-speaker` = follow whoever is speaking (diarized talking-head / podcast). Pick by what the beat is about; pair with `zoom` for how tight."
+                },
+                "intent": {
+                  "description": "Optional editorial LABEL for diff/log readability (e.g. 'speaker-tight', 'wide-context'). Cosmetic — NOT honored by the derive math and excluded from the variant cache key.",
+                  "type": "string"
+                },
+                "startSec": {
+                  "description": "Segment START in seconds, clip-relative. Segments tile the clip's duration in order.",
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "zoom": {
+                  "description": "How TIGHT the framing is — the fraction of the source the output viewport shows. <1 punches IN (a smaller source fraction, magnified to fill the frame); 1 = the full frame (no crop). ~0.6–0.8 is a moderate push-in, ~0.5 a tight close-up, 0.1 the maximum zoom. There is NO zoom-OUT past the full frame (max 1). Omit for the full frame. MUTUALLY EXCLUSIVE with `focus.shotScale`: a face-tracked shot is sized EITHER by the editorial scale (shotScale, calibrated to the detected face) OR by an explicit zoom — never both.",
+                  "maximum": 1,
+                  "minimum": 0.1,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "startSec",
+                "endSec",
+                "focus"
+              ],
+              "type": "object"
+            },
+            "minItems": 1,
+            "type": "array"
+          }
+        },
+        "required": [
+          "segments"
+        ],
+        "type": "object"
+      },
+      "sync": {
+        "enum": [
+          "video",
+          "independent"
+        ],
+        "type": "string"
+      },
+      "trim": {
+        "additionalProperties": false,
+        "properties": {
+          "end": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "start": {
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "start",
+          "end"
+        ],
+        "type": "object"
+      },
+      "volume": {
+        "maximum": 4,
+        "minimum": 0,
+        "type": "number"
+      },
+      "volumeDb": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "kind",
+      "mediaId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "componentId": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "execution": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "assets": {
+                "additionalProperties": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "componentId": {
+                "maxLength": 256,
+                "minLength": 1,
+                "type": "string"
+              },
+              "mediaBindings": {
+                "additionalProperties": {
+                  "items": {
+                    "maxLength": 128,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "params": {
+                "additionalProperties": {
+                  "$ref": "#/$defs/__schema0"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "seed": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "sourceVersionId": {
+                "pattern": "^[a-f0-9]{64}$",
+                "type": "string"
+              },
+              "version": {
+                "const": 3,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "componentId",
+              "sourceVersionId",
+              "params",
+              "seed"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "assets": {
+                "additionalProperties": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "componentId": {
+                "maxLength": 256,
+                "minLength": 1,
+                "type": "string"
+              },
+              "mediaBindings": {
+                "additionalProperties": {
+                  "items": {
+                    "maxLength": 128,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "params": {
+                "additionalProperties": {
+                  "$ref": "#/$defs/__schema0"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "seed": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "sourceVersionId": {
+                "pattern": "^[a-f0-9]{64}$",
+                "type": "string"
+              },
+              "version": {
+                "const": 4,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "componentId",
+              "sourceVersionId",
+              "params",
+              "seed"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "kind": {
+        "const": "component",
+        "type": "string"
+      },
+      "placement": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "kind": {
+                "const": "clip",
+                "type": "string"
+              },
+              "version": {
+                "const": 3,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "kind"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "kind": {
+                "const": "content-slots",
+                "type": "string"
+              },
+              "slots": {
+                "additionalProperties": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "ownership": {
+                      "enum": [
+                        "reference",
+                        "exclusive"
+                      ],
+                      "type": "string"
+                    },
+                    "targetClipIds": {
+                      "items": {
+                        "maxLength": 256,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "type": "array"
+                    }
+                  },
+                  "required": [
+                    "targetClipIds",
+                    "ownership"
+                  ],
+                  "type": "object"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "version": {
+                "const": 3,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "kind",
+              "slots"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "props": {
+        "additionalProperties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "retired": {
+        "additionalProperties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "zPlane": {
+        "enum": [
+          "front",
+          "behind-subject"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "componentId",
+      "props"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "anchor": {
+        "additionalProperties": false,
+        "properties": {
+          "space": {
+            "const": "scene",
+            "type": "string"
+          },
+          "x": {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          },
+          "y": {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "space",
+          "x",
+          "y"
+        ],
+        "type": "object"
+      },
+      "kind": {
+        "const": "overlay",
+        "type": "string"
+      },
+      "parallax": {
+        "maximum": 0.3,
+        "minimum": -0.3,
+        "type": "number"
+      },
+      "params": {
+        "additionalProperties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "primitiveId": {
+        "minLength": 1,
+        "pattern": "^(?!custom$)",
+        "type": "string"
+      },
+      "zPlane": {
+        "enum": [
+          "front",
+          "behind-subject"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "primitiveId",
+      "params"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "component": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "assets": {
+                "additionalProperties": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "componentId": {
+                "maxLength": 256,
+                "minLength": 1,
+                "type": "string"
+              },
+              "mediaBindings": {
+                "additionalProperties": {
+                  "items": {
+                    "maxLength": 128,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "params": {
+                "additionalProperties": {
+                  "$ref": "#/$defs/__schema0"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "seed": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "sourceVersionId": {
+                "pattern": "^[a-f0-9]{64}$",
+                "type": "string"
+              },
+              "version": {
+                "const": 3,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "componentId",
+              "sourceVersionId",
+              "params",
+              "seed"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "assets": {
+                "additionalProperties": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "componentId": {
+                "maxLength": 256,
+                "minLength": 1,
+                "type": "string"
+              },
+              "mediaBindings": {
+                "additionalProperties": {
+                  "items": {
+                    "maxLength": 128,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "params": {
+                "additionalProperties": {
+                  "$ref": "#/$defs/__schema0"
+                },
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "seed": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "sourceVersionId": {
+                "pattern": "^[a-f0-9]{64}$",
+                "type": "string"
+              },
+              "version": {
+                "const": 4,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version",
+              "componentId",
+              "sourceVersionId",
+              "params",
+              "seed"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "kind": {
+        "const": "effect",
+        "type": "string"
+      },
+      "params": {
+        "additionalProperties": {},
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "primitiveId": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "targetTrackIds": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "wrapperOrder": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "html": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "kind": {
+        "const": "card",
+        "type": "string"
+      },
+      "tokens": {
+        "additionalProperties": {
+          "type": "string"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "zPlane": {
+        "const": "front",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "html"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "compositionId": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "kind": {
+        "const": "composition",
+        "type": "string"
+      },
+      "trim": {
+        "additionalProperties": false,
+        "properties": {
+          "end": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "start": {
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "start",
+          "end"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "kind",
+      "compositionId"
+    ],
+    "type": "object"
+  }
+]

removedInput schema / properties / body / properties / seededGraphics / items / properties / startTime / description
```
Removed value: -"Timeline start (seconds)."
```
removedInput schema / properties / body / properties / seededGraphics / items / properties / transitionIn / properties / component / additionalProperties
```
Removed value: -false
```

added

Input schema / properties / body / properties / seededGraphics / items / properties / transitionIn / properties / component / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assets": {
+        "additionalProperties": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "componentId": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mediaBindings": {
+        "additionalProperties": {
+          "items": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "params": {
+        "additionalProperties": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "seed": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "sourceVersionId": {
+        "pattern": "^[a-f0-9]{64}$",
+        "type": "string"
+      },
+      "version": {
+        "const": 3,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "componentId",
+      "sourceVersionId",
+      "params",
+      "seed"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "assets": {
+        "additionalProperties": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "componentId": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mediaBindings": {
+        "additionalProperties": {
+          "items": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "params": {
+        "additionalProperties": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "seed": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "sourceVersionId": {
+        "pattern": "^[a-f0-9]{64}$",
+        "type": "string"
+      },
+      "version": {
+        "const": 4,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "componentId",
+      "sourceVersionId",
+      "params",
+      "seed"
+    ],
+    "type": "object"
+  }
+]

removed

Input schema / properties / body / properties / seededGraphics / items / properties / transitionIn / properties / component / properties

Removed value: -{
-  "assets": {
-    "additionalProperties": {
-      "minLength": 1,
-      "type": "string"
-    },
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  },
-  "componentId": {
-    "maxLength": 256,
-    "minLength": 1,
-    "type": "string"
-  },
-  "mediaBindings": {
-    "additionalProperties": {
-      "items": {
-        "maxLength": 128,
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  },
-  "params": {
-    "additionalProperties": {
-      "$ref": "#/$defs/__schema0"
-    },
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  },
-  "seed": {
-    "minLength": 1,
-    "type": "string"
-  },
-  "sourceVersionId": {
-    "pattern": "^[a-f0-9]{64}$",
-    "type": "string"
-  },
-  "version": {
-    "const": 3,
-    "type": "number"
-  }
-}

removedInput schema / properties / body / properties / seededGraphics / items / properties / transitionIn / properties / component / required
```
Removed value: -[
-  "version",
-  "componentId",
-  "sourceVersionId",
-  "params",
-  "seed"
-]
```
removedInput schema / properties / body / properties / seededGraphics / items / properties / transitionIn / properties / component / type
```
Removed value: -"object"
```

addedInput schema / properties / body / properties / seededGraphics / items / properties / tweens

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "duration": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "keyframes": {
+        "additionalProperties": false,
+        "properties": {
+          "easeEach": {
+            "const": "none",
+            "type": "string"
+          },
+          "format": {
+            "const": "percentage",
+            "type": "string"
+          },
+          "keyframes": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "ease": {
+                  "type": "string"
+                },
+                "percentage": {
+                  "type": "number"
+                },
+                "properties": {
+                  "additionalProperties": {
+                    "type": "number"
+                  },
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "type": "object"
+                }
+              },
+              "required": [
+                "percentage",
+                "properties"
+              ],
+              "type": "object"
+            },
+            "minItems": 2,
+            "type": "array"
+          }
+        },
+        "required": [
+          "format",
+          "easeEach",
+          "keyframes"
+        ],
+        "type": "object"
+      },
+      "position": {
+        "type": "number"
+      },
+      "propertyGroup": {
+        "enum": [
+          "visual",
+          "scale",
+          "rotation",
+          "position"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "propertyGroup",
+      "position",
+      "duration",
+      "keyframes"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

removedOutput schema / properties / format / description
```
Removed value: -"Output-format spec per §Format."
```

First observedOct 10, 2026

TDQS

A4.1/5.0

Behavior5/5

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

Annotations only declare the safety profile (not read-only, not idempotent, not destructive); the description goes well beyond that. It discloses that seededGraphics are carried VERBATIM as locked clips and never re-authored, that exclusions are hard negatives the Director must never author, that moment pinning is 'honored to-the-frame or refused', and that the response carries a quote which must be relayed before composing. These are non-obvious contract behaviors an agent could not infer from annotations.

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

Conciseness3/5

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

Purpose and the compose handoff are front-loaded, which is good, but the middle is a single sprawling field dump with heavy CAPS emphasis and parentheticals that is hard to parse in one pass. Every clause is informative, yet the delivery is less structured than it could be (no grouping, one giant sentence for all fields).

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 complex nested mutation tool this covers the contract well: intent, exclusions, seeded graphics locking, gates, and the mandatory quote relay. An output schema exists so return values needn't be explained, and the description still notes what the response carries. The remaining gap is the unmentioned root-level params (projectId, commandId retry identity) that the description never touches.

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

Parameters4/5

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

With schema coverage at only 50% and several nested objects deferred to describe_tool_input, this description does real compensatory work: it names goal as required, clarifies locale drives ALL on-screen copy + captions, explains beats carry editorial intent plus moment pinning, and defines captions.emphasisPhrases as the big-serif treatment. It omits projectId, commandId, name, references, and audio, so it does not fully close the coverage gap.

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

Purpose4/5

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

Opens with a specific verb+resource: 'Persist the video's INTENT as a Brief — the Director's rich input contract'. That is far more than a restatement of the name and explains where the artifact comes from (the storyboard skill's output). It does not explicitly differentiate itself from siblings like update_brief, editorial_create_brief, or suggest_briefs, which keeps it at 4.

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 a concrete next-step workflow: 'Then compose it: compose with {briefId}' and an explicit human-in-the-loop precondition ('relay it to your human BEFORE composing'). That is real usage guidance. What is missing is when NOT to use it — no mention of update_brief for revisions or the editorial_* brief variants.

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

All CueFrame tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Create Brief

Tool call template

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources