CueFrame

Update Component

update_component

DestructiveIdempotent

Update an authored component's complete version-4 source/metadata IN PLACE (same id) — the correct verb for the author→preview→fix loop (preview_component returns the admission or runtime error; fix the template here and re-preview, instead of creating a new component each iteration). Pass componentId + the changed fields as body. Same source contract as create_component: {version:4, componentId, template, manifest, definition}, admitted before the write; the template finds its root with document.getElementById('root'), and declared slots arrive in the scene's assets, never params. PLACED CLIPS: every placed clip renders the exact version it pins, so an update moves placed clips ONLY when you name a project — put projectId (and optionally compositionId; default the project's active composition) in body, and that composition's placements move to the new version in the same write. The answer carries repinned (what moved) and placementsPinnedToPrevious (placements across the org still rendering the previous version). Without projectId nothing placed moves: previews and renders of an existing clip keep the old version. For one placement, register the source WITHOUT projectId, read its immutable sourceVersionId, then use apply_composition clip.update to change only the selected clip source and exact pin under observed concurrency expectations. Explicit-project update_component admits and repins all matching placements in that composition; use it only when that broader edit is requested.

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": {
      "componentId": "<componentId>",
      "body": "<body>"
    },
    "name": "update_component"
  }
}

Input Schema

Name	Required	Description
`body`	Yes	PUT /components/:id body: every writable field, all optional; an omitted field is carried forward. Org/user are server-resolved; never accepted from the body.
`commandId`	No	Retry identity. A call repeated with the same commandId returns the first result instead of acting twice.
`componentId`	Yes	componentId (path).

Output Schema

Name	Required	Description
`id`	No	The entry's id: a `primitiveId` for a built-in, a `componentId` for an installed component.
`kind`	No	RENDER kind (component \| transition \| scene). NOT the ClipSource variant — see `placement` for how to author it on the timeline.
`mood`	No	Vibe/tone tags (e.g. 'cinematic', 'minimal'). Filter to match the edit's mood.
`name`	No
`tags`	No	Free-text search keywords.
`tier`	No	Quality/applicability RANKING (a preference, not a flag). Prefer 'recommended'; reach for 'niche' only when its specific use-case is exactly the beat.
`format`	No
`intent`	No	Selection signal: a verb naming what this primitive accomplishes (e.g. 'product-trailer'). Match it to the beat you are authoring.
`origin`	No
`source`	No	'default' = built-in primitive (place by primitiveId); 'installed' = org-authored component (place by componentId).
`tokens`	No
`useCase`	No	The edit ROLE(s) this primitive fills — the dimension to filter by for a beat (e.g. 'intro', 'title-over-footage', 'grade').
`useWhen`	No	When to use this — AND when not to. The negative guidance is load-bearing; read it before picking.
`version`	No	The ENTRY's version: a semver string ('0.0.0' until an authored component is versioned). Distinct from `manifest.version`, which is the runtime contract version (4 native, 2 retired TSX).
`category`	No
`examples`	No	Usage examples, as authored. A built-in primitive projects {name, mood?, params?, description?}; an authored component's examples are whatever it wrote, which is why the item is open. One shape for both directions: what you write here is what you read back.
`manifest`	No
`repinned`	No	Present when the update named `projectId`: the composition whose placements moved to the new version.
`warnings`	No	Non-blocking save-time advisories — the create/update SUCCEEDED. Currently: a `fontFamily` string literal referencing a NON-vendored font (a bare CSS generic like 'serif', or an unknown named family like 'Arial') whose LIVE-lane pixels vary by render host — re-author with a vendored family or 'Georgia'. Omitted when there is nothing to flag; only present on the create/update responses.
`avoidWith`	No	Authoring guidance: ids of primitives that CONFLICT with this one — do not place together.
`fixedCopy`	No	On-screen strings this primitive BAKES — the read-side counterpart to propSchema. These literals render REGARDLESS of params (no param can change them); fork the source via get_component_source to edit them. Use this to see at author time what fixed copy (someone-else's marketing text, faux-code, faux-data) will appear before you render.
`pairsWith`	No	Authoring guidance: ids of primitives that COMPOSE well with this one in the same edit.
`placement`	No
`textParam`	No	The param field that carries this primitive's primary text; null = no single text slot.
`propSchema`	No
`description`	No
`ejectedFrom`	No
`propDefaults`	No
`subtextParam`	No	The param field for secondary text (subtitle/byline); null = none.
`brandBindings`	No	Params that can follow the project brand kit. Each {param, brandToken} says: set `param` to `brandToken` (a `$brand:` ref, e.g. '$brand:colors.accent') to track the brand instead of a literal. See the list response's `brandTokens` for the full ref vocabulary. Omitted when nothing is brand-bound.
`durationInFrames`	No
`placementsPinnedToPrevious`	No	Placements across the org that still pin the previous version and will keep rendering it. Name `projectId` (and `compositionId`) on the update to move a composition's placements with it.

Schema Changelog

Changes observed during successful MCP inspections.

Changed55 schema fields changedOct 31, 2026

removedInput schema / $defs / __schema11

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "componentId": {
-      "maxLength": 128,
-      "minLength": 1,
-      "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$",
-      "type": "string"
-    },
-    "definition": {
-      "additionalProperties": false,
-      "properties": {
-        "brandBindings": {
-          "items": {
-            "additionalProperties": false,
-            "properties": {
-              "brandKitPath": {
-                "maxLength": 128,
-                "minLength": 1,
-                "type": "string"
-              },
-              "cssVar": {
-                "maxLength": 128,
-                "minLength": 1,
-                "type": "string"
-              },
-              "fallback": {
-                "type": "string"
-              },
-              "propPath": {
-                "maxLength": 128,
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "required": [
-              "propPath",
-              "cssVar"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "capabilities": {
-          "items": {
-            "$ref": "#/$defs/__schema13"
-          },
-          "minItems": 1,
-          "type": "array"
-        },
-        "defaults": {
-          "additionalProperties": {},
-          "properties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "inputSchema": {
-          "additionalProperties": {},
-          "properties": {},
-          "propertyNames": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "mediaBindings": {
-          "items": {
-            "$ref": "#/$defs/__schema15"
-          },
-          "minItems": 1,
-          "type": "array"
-        },
-        "preview": {
-          "additionalProperties": false,
-          "properties": {
-            "assets": {
-              "additionalProperties": {
-                "anyOf": [
-                  {
-                    "additionalProperties": false,
-                    "properties": {
-                      "durationSec": {
-                        "exclusiveMinimum": 0,
-                        "type": "number"
-                      },
-                      "frameRate": {
-                        "exclusiveMinimum": 0,
-                        "type": "number"
-                      },
-                      "mimeType": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "sha256": {
-                        "pattern": "^[a-f0-9]{64}$",
-                        "type": "string"
-                      },
-                      "url": {
-                        "pattern": "^https:\\/\\/.*",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "url",
-                      "sha256",
-                      "mimeType"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "additionalProperties": false,
-                    "properties": {
-                      "durationSec": {
-                        "exclusiveMinimum": 0,
-                        "type": "number"
-                      },
-                      "frameRate": {
-                        "exclusiveMinimum": 0,
-                        "type": "number"
-                      },
-                      "mediaId": {
-                        "maxLength": 128,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "mimeType": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "sha256": {
-                        "pattern": "^[a-f0-9]{64}$",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "mediaId",
-                      "sha256",
-                      "mimeType"
-                    ],
-                    "type": "object"
-                  }
-                ]
-              },
-              "properties": {},
-              "propertyNames": {
-                "maxLength": 128,
-                "minLength": 1,
-                "type": "string"
-              },
-              "type": "object"
-            },
-            "format": {
-              "additionalProperties": {},
-              "properties": {
-                "aspectRatio": {
-                  "enum": [
-                    "16:9",
-                    "9:16",
-                    "1:1",
-                    "4:5"
-                  ],
-                  "type": "string"
-                },
-                "fps": {
-                  "anyOf": [
-                    {
-                      "const": 24,
-                      "type": "number"
-                    },
-                    {
-                      "const": 25,
-                      "type": "number"
-                    },
-                    {
-                      "const": 30,
-                      "type": "number"
-                    },
-                    {
-                      "const": 60,
-                      "type": "number"
-                    }
-                  ]
-                },
-                "platform": {
-                  "type": "string"
-                },
-                "resolution": {
-                  "enum": [
-                    "hd",
-                    "fhd",
-                    "4k"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "aspectRatio"
-              ],
-              "type": "object"
-            },
-            "mediaBindings": {
-              "additionalProperties": {
-                "items": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "durationSec": {
-                          "exclusiveMinimum": 0,
-                          "type": "number"
-                        },
-                        "frameRate": {
-                          "exclusiveMinimum": 0,
-                          "type": "number"
-                        },
-                        "mimeType": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "sha256": {
-                          "pattern": "^[a-f0-9]{64}$",
-                          "type": "string"
-                        },
-                        "url": {
-                          "pattern": "^https:\\/\\/.*",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "url",
-                        "sha256",
-                        "mimeType"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "durationSec": {
-                          "exclusiveMinimum": 0,
-                          "type": "number"
-                        },
-                        "frameRate": {
-                          "exclusiveMinimum": 0,
-                          "type": "number"
-                        },
-                        "mediaId": {
-                          "maxLength": 128,
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "mimeType": {
-                          "minLength": 1,
-                          "type": "string"
-                        },
-                        "sha256": {
-                          "pattern": "^[a-f0-9]{64}$",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "mediaId",
-                        "sha256",
-                        "mimeType"
-                      ],
-                      "type": "object"
-                    }
-                  ]
-                },
-                "type": "array"
-              },
-              "properties": {},
-              "propertyNames": {
-                "maxLength": 128,
-                "minLength": 1,
-                "type": "string"
-              },
-              "type": "object"
-            },
-            "params": {
-              "additionalProperties": {},
-              "properties": {},
-              "propertyNames": {
-                "type": "string"
-              },
-              "type": "object"
-            }
-          },
-          "type": "object"
-        },
-        "timing": {
-          "additionalProperties": false,
-          "properties": {
-            "defaultDuration": {
-              "additionalProperties": false,
-              "properties": {
-                "fps": {
-                  "exclusiveMinimum": 0,
-                  "type": "number"
-                },
-                "frames": {
-                  "exclusiveMinimum": 0,
-                  "maximum": 9007199254740991,
-                  "type": "integer"
-                }
-              },
-              "required": [
-                "frames",
-                "fps"
-              ],
-              "type": "object"
-            },
-            "maxDurationSec": {
-              "exclusiveMinimum": 0,
-              "type": "number"
-            },
-            "minDurationSec": {
-              "exclusiveMinimum": 0,
-              "type": "number"
-            }
-          },
-          "required": [
-            "defaultDuration"
-          ],
-          "type": "object"
-        }
-      },
-      "required": [
-        "inputSchema",
-        "defaults",
-        "brandBindings",
-        "timing",
-        "capabilities"
-      ],
-      "type": "object"
-    },
-    "manifest": {
-      "additionalProperties": false,
-      "properties": {
-        "alphaPolicy": {
-          "enum": [
-            "requires-transparency",
-            "allows-opaque"
-          ],
-          "type": "string"
-        },
-        "assets": {
-          "additionalProperties": {
-            "additionalProperties": false,
-            "properties": {
-              "kind": {
-                "enum": [
-                  "image",
-                  "video",
-                  "audio",
-                  "data",
-                  "visual"
-                ],
-                "type": "string"
-              },
-              "mediaDemand": {
-                "oneOf": [
-                  {
-                    "properties": {
-                      "mode": {
-                        "const": "original",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "mode"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "properties": {
-                      "mode": {
-                        "const": "tier",
-                        "type": "string"
-                      },
-                      "tier": {
-                        "anyOf": [
-                          {
-                            "const": 256,
-                            "type": "number"
-                          },
-                          {
-                            "const": 512,
-                            "type": "number"
-                          },
-                          {
-                            "const": 1024,
-                            "type": "number"
-                          },
-                          {
-                            "const": 2048,
-                            "type": "number"
-                          }
-                        ]
-                      }
-                    },
-                    "required": [
-                      "mode",
-                      "tier"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "properties": {
-                      "maxProjectedHeightRatio": {
-                        "exclusiveMinimum": 0,
-                        "maximum": 64,
-                        "type": "number"
-                      },
-                      "maxProjectedWidthRatio": {
-                        "exclusiveMinimum": 0,
-                        "maximum": 64,
-                        "type": "number"
-                      },
-                      "minVisibleSourceHeightRatio": {
-                        "default": 1,
-                        "exclusiveMinimum": 0,
-                        "maximum": 1,
-                        "type": "number"
-                      },
-                      "minVisibleSourceWidthRatio": {
-                        "default": 1,
-                        "exclusiveMinimum": 0,
-                        "maximum": 1,
-                        "type": "number"
-                      },
-                      "mode": {
-                        "const": "auto",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "mode",
-                      "maxProjectedWidthRatio",
-                      "maxProjectedHeightRatio"
-                    ],
-                    "type": "object"
-                  }
-                ]
-              },
-              "mimeTypes": {
-                "items": {
-                  "$ref": "#/$defs/__schema12"
-                },
-                "minItems": 1,
-                "type": "array"
-              },
-              "required": {
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "kind",
-              "required"
-            ],
-            "type": "object"
-          },
-          "properties": {},
-          "propertyNames": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "graphics": {
-          "additionalProperties": false,
-          "properties": {
-            "accelerationPreference": {
-              "enum": [
-                "hardware-preferred",
-                "software-allowed"
-              ],
-              "type": "string"
-            },
-            "api": {
-              "enum": [
-                "canvas2d",
-                "webgl",
-                "webgl2",
-                "webgpu"
-              ],
-              "type": "string"
-            },
-            "required": {
-              "const": true,
-              "type": "boolean"
-            }
-          },
-          "required": [
-            "api",
-            "required",
-            "accelerationPreference"
-          ],
-          "type": "object"
-        },
-        "hfContract": {
-          "const": 1,
-          "type": "number"
-        },
-        "kind": {
-          "const": "scene",
-          "type": "string"
-        },
-        "runtime": {
-          "const": "hyperframes",
-          "type": "string"
-        },
-        "sceneShot": {
-          "additionalProperties": false,
-          "properties": {
-            "version": {
-              "const": 2,
-              "type": "number"
-            }
-          },
-          "required": [
-            "version"
-          ],
-          "type": "object"
-        },
-        "version": {
-          "const": 4,
-          "type": "number"
-        }
-      },
-      "required": [
-        "version",
-        "runtime",
-        "hfContract",
-        "kind",
-        "assets",
-        "graphics",
-        "alphaPolicy"
-      ],
-      "type": "object"
-    },
-    "template": {
-      "maxLength": 2000000,
-      "minLength": 1,
-      "type": "string"
-    },
-    "version": {
-      "const": 4,
-      "type": "number"
-    }
-  },
-  "required": [
-    "version",
-    "componentId",
-    "template",
-    "manifest",
-    "definition"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema12

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

removedInput schema / $defs / __schema13

Removed value: -{
-  "oneOf": [
-    {
-      "properties": {
-        "kind": {
-          "const": "clip",
-          "type": "string"
-        }
-      },
-      "required": [
-        "kind"
-      ],
-      "type": "object"
-    },
-    {
-      "properties": {
-        "kind": {
-          "const": "cut-transition",
-          "type": "string"
-        },
-        "protocol": {
-          "const": "per-child",
-          "type": "string"
-        }
-      },
-      "required": [
-        "kind",
-        "protocol"
-      ],
-      "type": "object"
-    },
-    {
-      "properties": {
-        "kind": {
-          "const": "content-slots",
-          "type": "string"
-        },
-        "slots": {
-          "items": {
-            "$ref": "#/$defs/__schema14"
-          },
-          "minItems": 1,
-          "type": "array"
-        }
-      },
-      "required": [
-        "kind",
-        "slots"
-      ],
-      "type": "object"
-    },
-    {
-      "properties": {
-        "acceptsWrappedTargets": {
-          "type": "boolean"
-        },
-        "kind": {
-          "const": "clip-wrapper",
-          "type": "string"
-        },
-        "ordering": {
-          "enum": [
-            "any",
-            "innermost"
-          ],
-          "type": "string"
-        }
-      },
-      "required": [
-        "kind",
-        "ordering",
-        "acceptsWrappedTargets"
-      ],
-      "type": "object"
-    },
-    {
-      "properties": {
-        "acceptsWrappedTargets": {
-          "type": "boolean"
-        },
-        "kind": {
-          "const": "global-wrapper",
-          "type": "string"
-        },
-        "ordering": {
-          "enum": [
-            "any",
-            "innermost"
-          ],
-          "type": "string"
-        },
-        "scope": {
-          "const": "media-lanes",
-          "type": "string"
-        }
-      },
-      "required": [
-        "kind",
-        "scope",
-        "ordering",
-        "acceptsWrappedTargets"
-      ],
-      "type": "object"
-    }
-  ]
-}

removedInput schema / $defs / __schema14

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "max": {
-      "exclusiveMinimum": 0,
-      "maximum": 9007199254740991,
-      "type": "integer"
-    },
-    "min": {
-      "maximum": 9007199254740991,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "name": {
-      "maxLength": 128,
-      "minLength": 1,
-      "type": "string"
-    },
-    "ownership": {
-      "enum": [
-        "reference",
-        "exclusive"
-      ],
-      "type": "string"
-    },
-    "sizing": {
-      "enum": [
-        "canvas",
-        "container"
-      ],
-      "type": "string"
-    }
-  },
-  "required": [
-    "name",
-    "min",
-    "max",
-    "ownership",
-    "sizing"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema15

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "cardinality": {
-      "additionalProperties": false,
-      "properties": {
-        "max": {
-          "exclusiveMinimum": 0,
-          "maximum": 9007199254740991,
-          "type": "integer"
-        },
-        "min": {
-          "maximum": 9007199254740991,
-          "minimum": 0,
-          "type": "integer"
-        }
-      },
-      "required": [
-        "min"
-      ],
-      "type": "object"
-    },
-    "collection": {
-      "enum": [
-        "scalar",
-        "array"
-      ],
-      "type": "string"
-    },
-    "kind": {
-      "enum": [
-        "image",
-        "video",
-        "visual"
-      ],
-      "type": "string"
-    },
-    "mediaDemand": {
-      "oneOf": [
-        {
-          "properties": {
-            "mode": {
-              "const": "original",
-              "type": "string"
-            }
-          },
-          "required": [
-            "mode"
-          ],
-          "type": "object"
-        },
-        {
-          "properties": {
-            "mode": {
-              "const": "tier",
-              "type": "string"
-            },
-            "tier": {
-              "anyOf": [
-                {
-                  "const": 256,
-                  "type": "number"
-                },
-                {
-                  "const": 512,
-                  "type": "number"
-                },
-                {
-                  "const": 1024,
-                  "type": "number"
-                },
-                {
-                  "const": 2048,
-                  "type": "number"
-                }
-              ]
-            }
-          },
-          "required": [
-            "mode",
-            "tier"
-          ],
-          "type": "object"
-        },
-        {
-          "properties": {
-            "maxProjectedHeightRatio": {
-              "exclusiveMinimum": 0,
-              "maximum": 64,
-              "type": "number"
-            },
-            "maxProjectedWidthRatio": {
-              "exclusiveMinimum": 0,
-              "maximum": 64,
-              "type": "number"
-            },
-            "minVisibleSourceHeightRatio": {
-              "default": 1,
-              "exclusiveMinimum": 0,
-              "maximum": 1,
-              "type": "number"
-            },
-            "minVisibleSourceWidthRatio": {
-              "default": 1,
-              "exclusiveMinimum": 0,
-              "maximum": 1,
-              "type": "number"
-            },
-            "mode": {
-              "const": "auto",
-              "type": "string"
-            }
-          },
-          "required": [
-            "mode",
-            "maxProjectedWidthRatio",
-            "maxProjectedHeightRatio"
-          ],
-          "type": "object"
-        }
-      ]
-    },
-    "mimeTypes": {
-      "items": {
-        "$ref": "#/$defs/__schema17"
-      },
-      "minItems": 1,
-      "type": "array"
-    },
-    "name": {
-      "maxLength": 128,
-      "minLength": 1,
-      "type": "string"
-    },
-    "propPath": {
-      "items": {
-        "$ref": "#/$defs/__schema16"
-      },
-      "maxItems": 16,
-      "minItems": 1,
-      "type": "array"
-    }
-  },
-  "required": [
-    "name",
-    "propPath",
-    "kind",
-    "collection",
-    "cardinality"
-  ],
-  "type": "object"
-}

removedInput schema / $defs / __schema16

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

removedInput schema / $defs / __schema17

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

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

removedInput schema / $defs / __schema18 / description

Removed value: -"A project whose explicitly named composition moves its placements atomically with the source write. Requires compositionId and concurrency."

removedInput schema / $defs / __schema18 / minLength
```
Removed value: -1
```

addedInput schema / $defs / __schema18 / properties

Added value: +{
+  "adaptationReceiptRef": {
+    "additionalProperties": false,
+    "properties": {
+      "byteLength": {
+        "exclusiveMinimum": 0,
+        "maximum": 134217728,
+        "type": "integer"
+      },
+      "format": {
+        "const": "cueframe-registry-adaptation-v1",
+        "type": "string"
+      },
+      "sha256": {
+        "pattern": "^[a-f0-9]{64}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "format",
+      "sha256",
+      "byteLength"
+    ],
+    "type": "object"
+  },
+  "receiptRef": {
+    "additionalProperties": false,
+    "properties": {
+      "bundleBytes": {
+        "exclusiveMinimum": 0,
+        "maximum": 134217728,
+        "type": "integer"
+      },
+      "bundleSha256": {
+        "pattern": "^[a-f0-9]{64}$",
+        "type": "string"
+      },
+      "format": {
+        "const": "cueframe-registry-provenance-v1",
+        "type": "string"
+      },
+      "receiptId": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "bundleSha256",
+      "bundleBytes",
+      "format",
+      "receiptId"
+    ],
+    "type": "object"
+  }
+}

addedInput schema / $defs / __schema18 / required
```
Added value: +[
+  "receiptRef"
+]
```

changedInput schema / $defs / __schema18 / type

Previous value: -"string"New value: +"object"

changedInput schema / $defs / __schema19 / description

Previous value: -"The exact composition observed by the caller. Required with projectId and concurrency."New value: +"Exact source head observed before adoption, editing or rollback. A changed head refuses the write; project placements remain pinned unless explicitly guarded below."

removedInput schema / $defs / __schema19 / minLength
```
Removed value: -1
```
addedInput schema / $defs / __schema19 / pattern
```
Added value: +"^[a-f0-9]{64}$"
```

changedInput schema / $defs / __schema20 / description

Previous value: -"Caller-observed placement guard, required with projectId and compositionId: a placement update without it is refused with 428 precondition_required. Atomic library edits with placement changes require explicit supported invocation admission."New value: +"A project whose explicitly named composition moves its placements atomically with the source write. Requires compositionId and concurrency."

addedInput schema / $defs / __schema20 / minLength
```
Added value: +1
```

removedInput schema / $defs / __schema20 / oneOf

Removed value: -[
-  {
-    "$ref": "#/$defs/__schema21"
-  },
-  {
-    "$ref": "#/$defs/__schema22"
-  }
-]

addedInput schema / $defs / __schema20 / type
```
Added value: +"string"
```
removedInput schema / $defs / __schema21 / additionalProperties
```
Removed value: -false
```

addedInput schema / $defs / __schema21 / description

Added value: +"The exact composition observed by the caller. Required with projectId and concurrency."

addedInput schema / $defs / __schema21 / minLength
```
Added value: +1
```

removedInput schema / $defs / __schema21 / properties

Removed value: -{
-  "expectedRevision": {
-    "maximum": 9007199254740991,
-    "minimum": 0,
-    "type": "integer"
-  },
-  "mode": {
-    "const": "exact",
-    "type": "string"
-  }
-}

removedInput schema / $defs / __schema21 / required

Removed value: -[
-  "mode",
-  "expectedRevision"
-]

changedInput schema / $defs / __schema21 / type

Previous value: -"object"New value: +"string"

removedInput schema / $defs / __schema22 / additionalProperties
```
Removed value: -false
```

addedInput schema / $defs / __schema22 / description

Added value: +"Caller-observed placement guard, required with projectId and compositionId: a placement update without it is refused with 428 precondition_required. Atomic library edits with placement changes require explicit supported invocation admission."

addedInput schema / $defs / __schema22 / oneOf

Added value: +[
+  {
+    "$ref": "#/$defs/__schema23"
+  },
+  {
+    "$ref": "#/$defs/__schema24"
+  }
+]

removedInput schema / $defs / __schema22 / properties

Removed value: -{
-  "basis": {
-    "items": {
-      "$ref": "#/$defs/__schema23"
-    },
-    "maxItems": 2048,
-    "type": "array"
-  },
-  "compositionId": {
-    "maxLength": 128,
-    "minLength": 1,
-    "type": "string"
-  },
-  "mode": {
-    "const": "guarded",
-    "type": "string"
-  },
-  "observedRevision": {
-    "maximum": 9007199254740991,
-    "minimum": 0,
-    "type": "integer"
-  }
-}

removedInput schema / $defs / __schema22 / required

Removed value: -[
-  "mode",
-  "observedRevision",
-  "basis"
-]

removedInput schema / $defs / __schema22 / type
```
Removed value: -"object"
```

addedInput schema / $defs / __schema23 / properties / expectedRevision

Added value: +{
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

removedInput schema / $defs / __schema23 / properties / key

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

addedInput schema / $defs / __schema23 / properties / mode

Added value: +{
+  "const": "exact",
+  "type": "string"
+}

removedInput schema / $defs / __schema23 / properties / token

Removed value: -{
-  "maxLength": 65536,
-  "type": "string"
-}

changedInput schema / $defs / __schema23 / required

Previous value: -[
-  "key",
-  "token"
-]New value: +[
+  "mode",
+  "expectedRevision"
+]

addedInput schema / $defs / __schema24 / additionalProperties
```
Added value: +false
```
removedInput schema / $defs / __schema24 / maxLength
```
Removed value: -128
```
removedInput schema / $defs / __schema24 / minLength
```
Removed value: -1
```

addedInput schema / $defs / __schema24 / properties

Added value: +{
+  "basis": {
+    "items": {
+      "$ref": "#/$defs/__schema25"
+    },
+    "maxItems": 2048,
+    "type": "array"
+  },
+  "compositionId": {
+    "maxLength": 128,
+    "minLength": 1,
+    "type": "string"
+  },
+  "mode": {
+    "const": "guarded",
+    "type": "string"
+  },
+  "observedRevision": {
+    "maximum": 9007199254740991,
+    "minimum": 0,
+    "type": "integer"
+  }
+}

addedInput schema / $defs / __schema24 / required

Added value: +[
+  "mode",
+  "observedRevision",
+  "basis"
+]

changedInput schema / $defs / __schema24 / type

Previous value: -"string"New value: +"object"

addedInput schema / $defs / __schema25

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "key": {
+      "maxLength": 256,
+      "minLength": 1,
+      "type": "string"
+    },
+    "token": {
+      "maxLength": 65536,
+      "type": "string"
+    }
+  },
+  "required": [
+    "key",
+    "token"
+  ],
+  "type": "object"
+}

addedInput schema / $defs / __schema26

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

changedInput schema / properties / body / properties / compositionId / $ref
```
Previous value: -"#/$defs/__schema19"New value: +"#/$defs/__schema21"
```

changedInput schema / properties / body / properties / concurrency / $ref

Previous value: -"#/$defs/__schema20"New value: +"#/$defs/__schema22"

addedInput schema / properties / body / properties / expectedHeadVersionId
```
Added value: +{
+  "$ref": "#/$defs/__schema19"
+}
```

changedInput schema / properties / body / properties / projectId / $ref

Previous value: -"#/$defs/__schema18"New value: +"#/$defs/__schema20"

addedInput schema / properties / body / properties / registryProvenance
```
Added value: +{
+  "$ref": "#/$defs/__schema18"
+}
```
removedInput schema / properties / body / properties / source / $ref
```
Removed value: -"#/$defs/__schema11"
```

addedInput schema / properties / body / properties / source / description

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

addedInput schema / properties / body / properties / source / required

Added value: +[
+  "version",
+  "componentId",
+  "template",
+  "manifest",
+  "definition"
+]

addedInput schema / properties / body / properties / source / type
```
Added value: +"object"
```

changedInput schema / properties / commandId / $ref

Previous value: -"#/$defs/__schema24"New value: +"#/$defs/__schema26"

Changed59 schema fields changedOct 28, 2026

addedInput schema / $defs

Added value: +{
+  "__schema0": {
+    "description": "Caller-chosen stable component id. On create it names the new component. On PUT/PATCH it is optional and, when present, must equal the id in the path; a mismatch is a 400 naming both.",
+    "maxLength": 200,
+    "minLength": 1,
+    "type": "string"
+  },
+  "__schema1": {
+    "maxLength": 200,
+    "minLength": 1,
+    "type": "string"
+  },
+  "__schema10": {
+    "exclusiveMinimum": 0,
+    "type": "number"
+  },
+  "__schema11": {
+    "additionalProperties": false,
+    "properties": {
+      "componentId": {
+        "maxLength": 128,
+        "minLength": 1,
+        "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$",
+        "type": "string"
+      },
+      "definition": {
+        "additionalProperties": false,
+        "properties": {
+          "brandBindings": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "brandKitPath": {
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "cssVar": {
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "fallback": {
+                  "type": "string"
+                },
+                "propPath": {
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "propPath",
+                "cssVar"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "capabilities": {
+            "items": {
+              "$ref": "#/$defs/__schema13"
+            },
+            "minItems": 1,
+            "type": "array"
+          },
+          "defaults": {
+            "additionalProperties": {},
+            "properties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "inputSchema": {
+            "additionalProperties": {},
+            "properties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "mediaBindings": {
+            "items": {
+              "$ref": "#/$defs/__schema15"
+            },
+            "minItems": 1,
+            "type": "array"
+          },
+          "preview": {
+            "additionalProperties": false,
+            "properties": {
+              "assets": {
+                "additionalProperties": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "durationSec": {
+                          "exclusiveMinimum": 0,
+                          "type": "number"
+                        },
+                        "frameRate": {
+                          "exclusiveMinimum": 0,
+                          "type": "number"
+                        },
+                        "mimeType": {
+                          "minLength": 1,
+                          "type": "string"
+                        },
+                        "sha256": {
+                          "pattern": "^[a-f0-9]{64}$",
+                          "type": "string"
+                        },
+                        "url": {
+                          "pattern": "^https:\\/\\/.*",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "url",
+                        "sha256",
+                        "mimeType"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "durationSec": {
+                          "exclusiveMinimum": 0,
+                          "type": "number"
+                        },
+                        "frameRate": {
+                          "exclusiveMinimum": 0,
+                          "type": "number"
+                        },
+                        "mediaId": {
+                          "maxLength": 128,
+                          "minLength": 1,
+                          "type": "string"
+                        },
+                        "mimeType": {
+                          "minLength": 1,
+                          "type": "string"
+                        },
+                        "sha256": {
+                          "pattern": "^[a-f0-9]{64}$",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mediaId",
+                        "sha256",
+                        "mimeType"
+                      ],
+                      "type": "object"
+                    }
+                  ]
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "format": {
+                "additionalProperties": {},
+                "properties": {
+                  "aspectRatio": {
+                    "enum": [
+                      "16:9",
+                      "9:16",
+                      "1:1",
+                      "4:5"
+                    ],
+                    "type": "string"
+                  },
+                  "fps": {
+                    "anyOf": [
+                      {
+                        "const": 24,
+                        "type": "number"
+                      },
+                      {
+                        "const": 25,
+                        "type": "number"
+                      },
+                      {
+                        "const": 30,
+                        "type": "number"
+                      },
+                      {
+                        "const": 60,
+                        "type": "number"
+                      }
+                    ]
+                  },
+                  "platform": {
+                    "type": "string"
+                  },
+                  "resolution": {
+                    "enum": [
+                      "hd",
+                      "fhd",
+                      "4k"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "aspectRatio"
+                ],
+                "type": "object"
+              },
+              "mediaBindings": {
+                "additionalProperties": {
+                  "items": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": false,
+                        "properties": {
+                          "durationSec": {
+                            "exclusiveMinimum": 0,
+                            "type": "number"
+                          },
+                          "frameRate": {
+                            "exclusiveMinimum": 0,
+                            "type": "number"
+                          },
+                          "mimeType": {
+                            "minLength": 1,
+                            "type": "string"
+                          },
+                          "sha256": {
+                            "pattern": "^[a-f0-9]{64}$",
+                            "type": "string"
+                          },
+                          "url": {
+                            "pattern": "^https:\\/\\/.*",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "url",
+                          "sha256",
+                          "mimeType"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "additionalProperties": false,
+                        "properties": {
+                          "durationSec": {
+                            "exclusiveMinimum": 0,
+                            "type": "number"
+                          },
+                          "frameRate": {
+                            "exclusiveMinimum": 0,
+                            "type": "number"
+                          },
+                          "mediaId": {
+                            "maxLength": 128,
+                            "minLength": 1,
+                            "type": "string"
+                          },
+                          "mimeType": {
+                            "minLength": 1,
+                            "type": "string"
+                          },
+                          "sha256": {
+                            "pattern": "^[a-f0-9]{64}$",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "mediaId",
+                          "sha256",
+                          "mimeType"
+                        ],
+                        "type": "object"
+                      }
+                    ]
+                  },
+                  "type": "array"
+                },
+                "properties": {},
+                "propertyNames": {
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "type": "object"
+              },
+              "params": {
+                "additionalProperties": {},
+                "properties": {},
+                "propertyNames": {
+                  "type": "string"
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "timing": {
+            "additionalProperties": false,
+            "properties": {
+              "defaultDuration": {
+                "additionalProperties": false,
+                "properties": {
+                  "fps": {
+                    "exclusiveMinimum": 0,
+                    "type": "number"
+                  },
+                  "frames": {
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "type": "integer"
+                  }
+                },
+                "required": [
+                  "frames",
+                  "fps"
+                ],
+                "type": "object"
+              },
+              "maxDurationSec": {
+                "exclusiveMinimum": 0,
+                "type": "number"
+              },
+              "minDurationSec": {
+                "exclusiveMinimum": 0,
+                "type": "number"
+              }
+            },
+            "required": [
+              "defaultDuration"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "inputSchema",
+          "defaults",
+          "brandBindings",
+          "timing",
+          "capabilities"
+        ],
+        "type": "object"
+      },
+      "manifest": {
+        "additionalProperties": false,
+        "properties": {
+          "alphaPolicy": {
+            "enum": [
+              "requires-transparency",
+              "allows-opaque"
+            ],
+            "type": "string"
+          },
+          "assets": {
+            "additionalProperties": {
+              "additionalProperties": false,
+              "properties": {
+                "kind": {
+                  "enum": [
+                    "image",
+                    "video",
+                    "audio",
+                    "data",
+                    "visual"
+                  ],
+                  "type": "string"
+                },
+                "mediaDemand": {
+                  "oneOf": [
+                    {
+                      "properties": {
+                        "mode": {
+                          "const": "original",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mode"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "properties": {
+                        "mode": {
+                          "const": "tier",
+                          "type": "string"
+                        },
+                        "tier": {
+                          "anyOf": [
+                            {
+                              "const": 256,
+                              "type": "number"
+                            },
+                            {
+                              "const": 512,
+                              "type": "number"
+                            },
+                            {
+                              "const": 1024,
+                              "type": "number"
+                            },
+                            {
+                              "const": 2048,
+                              "type": "number"
+                            }
+                          ]
+                        }
+                      },
+                      "required": [
+                        "mode",
+                        "tier"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "properties": {
+                        "maxProjectedHeightRatio": {
+                          "exclusiveMinimum": 0,
+                          "maximum": 64,
+                          "type": "number"
+                        },
+                        "maxProjectedWidthRatio": {
+                          "exclusiveMinimum": 0,
+                          "maximum": 64,
+                          "type": "number"
+                        },
+                        "minVisibleSourceHeightRatio": {
+                          "default": 1,
+                          "exclusiveMinimum": 0,
+                          "maximum": 1,
+                          "type": "number"
+                        },
+                        "minVisibleSourceWidthRatio": {
+                          "default": 1,
+                          "exclusiveMinimum": 0,
+                          "maximum": 1,
+                          "type": "number"
+                        },
+                        "mode": {
+                          "const": "auto",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "mode",
+                        "maxProjectedWidthRatio",
+                        "maxProjectedHeightRatio"
+                      ],
+                      "type": "object"
+                    }
+                  ]
+                },
+                "mimeTypes": {
+                  "items": {
+                    "$ref": "#/$defs/__schema12"
+                  },
+                  "minItems": 1,
+                  "type": "array"
+                },
+                "required": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "kind",
+                "required"
+              ],
+              "type": "object"
+            },
+            "properties": {},
+            "propertyNames": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "graphics": {
+            "additionalProperties": false,
+            "properties": {
+              "accelerationPreference": {
+                "enum": [
+                  "hardware-preferred",
+                  "software-allowed"
+                ],
+                "type": "string"
+              },
+              "api": {
+                "enum": [
+                  "canvas2d",
+                  "webgl",
+                  "webgl2",
+                  "webgpu"
+                ],
+                "type": "string"
+              },
+              "required": {
+                "const": true,
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "api",
+              "required",
+              "accelerationPreference"
+            ],
+            "type": "object"
+          },
+          "hfContract": {
+            "const": 1,
+            "type": "number"
+          },
+          "kind": {
+            "const": "scene",
+            "type": "string"
+          },
+          "runtime": {
+            "const": "hyperframes",
+            "type": "string"
+          },
+          "sceneShot": {
+            "additionalProperties": false,
+            "properties": {
+              "version": {
+                "const": 2,
+                "type": "number"
+              }
+            },
+            "required": [
+              "version"
+            ],
+            "type": "object"
+          },
+          "version": {
+            "const": 4,
+            "type": "number"
+          }
+        },
+        "required": [
+          "version",
+          "runtime",
+          "hfContract",
+          "kind",
+          "assets",
+          "graphics",
+          "alphaPolicy"
+        ],
+        "type": "object"
+      },
+      "template": {
+        "maxLength": 2000000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "version": {
+        "const": 4,
+        "type": "number"
+      }
+    },
+    "required": [
+      "version",
+      "componentId",
+      "template",
+      "manifest",
+      "definition"
+    ],
+    "type": "object"
+  },
+  "__schema12": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "__schema13": {
+    "oneOf": [
+      {
+        "properties": {
+          "kind": {
+            "const": "clip",
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind"
+        ],
+        "type": "object"
+      },
+      {
+        "properties": {
+          "kind": {
+            "const": "cut-transition",
+            "type": "string"
+          },
+          "protocol": {
+            "const": "per-child",
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind",
+          "protocol"
+        ],
+        "type": "object"
+      },
+      {
+        "properties": {
+          "kind": {
+            "const": "content-slots",
+            "type": "string"
+          },
+          "slots": {
+            "items": {
+              "$ref": "#/$defs/__schema14"
+            },
+            "minItems": 1,
+            "type": "array"
+          }
+        },
+        "required": [
+          "kind",
+          "slots"
+        ],
+        "type": "object"
+      },
+      {
+        "properties": {
+          "acceptsWrappedTargets": {
+            "type": "boolean"
+          },
+          "kind": {
+            "const": "clip-wrapper",
+            "type": "string"
+          },
+          "ordering": {
+            "enum": [
+              "any",
+              "innermost"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind",
+          "ordering",
+          "acceptsWrappedTargets"
+        ],
+        "type": "object"
+      },
+      {
+        "properties": {
+          "acceptsWrappedTargets": {
+            "type": "boolean"
+          },
+          "kind": {
+            "const": "global-wrapper",
+            "type": "string"
+          },
+          "ordering": {
+            "enum": [
+              "any",
+              "innermost"
+            ],
+            "type": "string"
+          },
+          "scope": {
+            "const": "media-lanes",
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind",
+          "scope",
+          "ordering",
+          "acceptsWrappedTargets"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  "__schema14": {
+    "additionalProperties": false,
+    "properties": {
+      "max": {
+        "exclusiveMinimum": 0,
+        "maximum": 9007199254740991,
+        "type": "integer"
+      },
+      "min": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "name": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      },
+      "ownership": {
+        "enum": [
+          "reference",
+          "exclusive"
+        ],
+        "type": "string"
+      },
+      "sizing": {
+        "enum": [
+          "canvas",
+          "container"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "name",
+      "min",
+      "max",
+      "ownership",
+      "sizing"
+    ],
+    "type": "object"
+  },
+  "__schema15": {
+    "additionalProperties": false,
+    "properties": {
+      "cardinality": {
+        "additionalProperties": false,
+        "properties": {
+          "max": {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "min": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "min"
+        ],
+        "type": "object"
+      },
+      "collection": {
+        "enum": [
+          "scalar",
+          "array"
+        ],
+        "type": "string"
+      },
+      "kind": {
+        "enum": [
+          "image",
+          "video",
+          "visual"
+        ],
+        "type": "string"
+      },
+      "mediaDemand": {
+        "oneOf": [
+          {
+            "properties": {
+              "mode": {
+                "const": "original",
+                "type": "string"
+              }
+            },
+            "required": [
+              "mode"
+            ],
+            "type": "object"
+          },
+          {
+            "properties": {
+              "mode": {
+                "const": "tier",
+                "type": "string"
+              },
+              "tier": {
+                "anyOf": [
+                  {
+                    "const": 256,
+                    "type": "number"
+                  },
+                  {
+                    "const": 512,
+                    "type": "number"
+                  },
+                  {
+                    "const": 1024,
+                    "type": "number"
+                  },
+                  {
+                    "const": 2048,
+                    "type": "number"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "mode",
+              "tier"
+            ],
+            "type": "object"
+          },
+          {
+            "properties": {
+              "maxProjectedHeightRatio": {
+                "exclusiveMinimum": 0,
+                "maximum": 64,
+                "type": "number"
+              },
+              "maxProjectedWidthRatio": {
+                "exclusiveMinimum": 0,
+                "maximum": 64,
+                "type": "number"
+              },
+              "minVisibleSourceHeightRatio": {
+                "default": 1,
+                "exclusiveMinimum": 0,
+                "maximum": 1,
+                "type": "number"
+              },
+              "minVisibleSourceWidthRatio": {
+                "default": 1,
+                "exclusiveMinimum": 0,
+                "maximum": 1,
+                "type": "number"
+              },
+              "mode": {
+                "const": "auto",
+                "type": "string"
+              }
+            },
+            "required": [
+              "mode",
+              "maxProjectedWidthRatio",
+              "maxProjectedHeightRatio"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "mimeTypes": {
+        "items": {
+          "$ref": "#/$defs/__schema17"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "name": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      },
+      "propPath": {
+        "items": {
+          "$ref": "#/$defs/__schema16"
+        },
+        "maxItems": 16,
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "name",
+      "propPath",
+      "kind",
+      "collection",
+      "cardinality"
+    ],
+    "type": "object"
+  },
+  "__schema16": {
+    "maxLength": 128,
+    "minLength": 1,
+    "type": "string"
+  },
+  "__schema17": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "__schema18": {
+    "description": "A project whose explicitly named composition moves its placements atomically with the source write. Requires compositionId and concurrency.",
+    "minLength": 1,
+    "type": "string"
+  },
+  "__schema19": {
+    "description": "The exact composition observed by the caller. Required with projectId and concurrency.",
+    "minLength": 1,
+    "type": "string"
+  },
+  "__schema2": {
+    "maxLength": 2000,
+    "type": "string"
+  },
+  "__schema20": {
+    "description": "Caller-observed placement guard, required with projectId and compositionId: a placement update without it is refused with 428 precondition_required. Atomic library edits with placement changes require explicit supported invocation admission.",
+    "oneOf": [
+      {
+        "$ref": "#/$defs/__schema21"
+      },
+      {
+        "$ref": "#/$defs/__schema22"
+      }
+    ]
+  },
+  "__schema21": {
+    "additionalProperties": false,
+    "properties": {
+      "expectedRevision": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "mode": {
+        "const": "exact",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "expectedRevision"
+    ],
+    "type": "object"
+  },
+  "__schema22": {
+    "additionalProperties": false,
+    "properties": {
+      "basis": {
+        "items": {
+          "$ref": "#/$defs/__schema23"
+        },
+        "maxItems": 2048,
+        "type": "array"
+      },
+      "compositionId": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mode": {
+        "const": "guarded",
+        "type": "string"
+      },
+      "observedRevision": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "mode",
+      "observedRevision",
+      "basis"
+    ],
+    "type": "object"
+  },
+  "__schema23": {
+    "additionalProperties": false,
+    "properties": {
+      "key": {
+        "maxLength": 256,
+        "minLength": 1,
+        "type": "string"
+      },
+      "token": {
+        "maxLength": 65536,
+        "type": "string"
+      }
+    },
+    "required": [
+      "key",
+      "token"
+    ],
+    "type": "object"
+  },
+  "__schema24": {
+    "maxLength": 128,
+    "minLength": 1,
+    "type": "string"
+  },
+  "__schema3": {
+    "enum": [
+      "text",
+      "effects",
+      "transitions",
+      "layouts",
+      "backgrounds",
+      "ui-blocks",
+      "scenes"
+    ],
+    "type": "string"
+  },
+  "__schema4": {
+    "additionalProperties": {},
+    "properties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  },
+  "__schema5": {
+    "enum": [
+      "customer-owned",
+      "server-native"
+    ],
+    "type": "string"
+  },
+  "__schema6": {
+    "maxLength": 200,
+    "type": "string"
+  },
+  "__schema7": {
+    "additionalProperties": {},
+    "properties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  },
+  "__schema8": {
+    "description": "Usage examples, as authored. A built-in primitive projects {name, mood?, params?, description?}; an authored component's examples are whatever it wrote, which is why the item is open. One shape for both directions: what you write here is what you read back.",
+    "items": {
+      "$ref": "#/$defs/__schema9"
+    },
+    "type": "array"
+  },
+  "__schema9": {
+    "additionalProperties": {},
+    "properties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  }
+}

addedInput schema / properties / body / properties / category / $ref
```
Added value: +"#/$defs/__schema3"
```

removedInput schema / properties / body / properties / category / enum

Removed value: -[
-  "text",
-  "effects",
-  "transitions",
-  "layouts",
-  "backgrounds",
-  "ui-blocks",
-  "scenes"
-]

removedInput schema / properties / body / properties / category / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / componentId / $ref
```
Added value: +"#/$defs/__schema0"
```

removedInput schema / properties / body / properties / componentId / description

Removed value: -"Caller-chosen stable component id. On create it names the new component. On PUT/PATCH it is optional and, when present, must equal the id in the path; a mismatch is a 400 naming both."

removedInput schema / properties / body / properties / componentId / maxLength
```
Removed value: -200
```
removedInput schema / properties / body / properties / componentId / minLength
```
Removed value: -1
```
removedInput schema / properties / body / properties / componentId / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / compositionId / $ref
```
Added value: +"#/$defs/__schema19"
```

removedInput schema / properties / body / properties / compositionId / description

Removed value: -"The exact composition observed by the caller. Required with projectId and concurrency."

removedInput schema / properties / body / properties / compositionId / minLength
```
Removed value: -1
```
removedInput schema / properties / body / properties / compositionId / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / concurrency / $ref
```
Added value: +"#/$defs/__schema20"
```

removedInput schema / properties / body / properties / concurrency / description

Removed value: -"Caller-observed placement guard, required with projectId and compositionId: a placement update without it is refused with 428 precondition_required. Atomic library edits with placement changes require explicit supported invocation admission."

removedInput schema / properties / body / properties / concurrency / oneOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "expectedRevision": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "mode": {
-        "const": "exact",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode",
-      "expectedRevision"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "basis": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "key": {
-              "maxLength": 256,
-              "minLength": 1,
-              "type": "string"
-            },
-            "token": {
-              "maxLength": 65536,
-              "type": "string"
-            }
-          },
-          "required": [
-            "key",
-            "token"
-          ],
-          "type": "object"
-        },
-        "maxItems": 2048,
-        "type": "array"
-      },
-      "compositionId": {
-        "maxLength": 128,
-        "minLength": 1,
-        "type": "string"
-      },
-      "mode": {
-        "const": "guarded",
-        "type": "string"
-      },
-      "observedRevision": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "mode",
-      "observedRevision",
-      "basis"
-    ],
-    "type": "object"
-  }
-]

addedInput schema / properties / body / properties / description / $ref
```
Added value: +"#/$defs/__schema2"
```
removedInput schema / properties / body / properties / description / maxLength
```
Removed value: -2000
```
removedInput schema / properties / body / properties / description / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / durationInFrames / $ref
```
Added value: +"#/$defs/__schema10"
```
removedInput schema / properties / body / properties / durationInFrames / exclusiveMinimum
```
Removed value: -0
```
removedInput schema / properties / body / properties / durationInFrames / type
```
Removed value: -"number"
```
addedInput schema / properties / body / properties / ejectedFrom / $ref
```
Added value: +"#/$defs/__schema6"
```
removedInput schema / properties / body / properties / ejectedFrom / maxLength
```
Removed value: -200
```
removedInput schema / properties / body / properties / ejectedFrom / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / examples / $ref
```
Added value: +"#/$defs/__schema8"
```

removedInput schema / properties / body / properties / examples / description

Removed value: -"Usage examples, as authored. A built-in primitive projects {name, mood?, params?, description?}; an authored component's examples are whatever it wrote, which is why the item is open. One shape for both directions: what you write here is what you read back."

removedInput schema / properties / body / properties / examples / items

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

removedInput schema / properties / body / properties / examples / type
```
Removed value: -"array"
```
addedInput schema / properties / body / properties / name / $ref
```
Added value: +"#/$defs/__schema1"
```
removedInput schema / properties / body / properties / name / maxLength
```
Removed value: -200
```
removedInput schema / properties / body / properties / name / minLength
```
Removed value: -1
```
removedInput schema / properties / body / properties / name / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / origin / $ref
```
Added value: +"#/$defs/__schema5"
```
removedInput schema / properties / body / properties / origin / enum
```
Removed value: -[
-  "customer-owned",
-  "server-native"
-]
```
removedInput schema / properties / body / properties / origin / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / projectId / $ref
```
Added value: +"#/$defs/__schema18"
```

removedInput schema / properties / body / properties / projectId / description

Removed value: -"A project whose explicitly named composition moves its placements atomically with the source write. Requires compositionId and concurrency."

removedInput schema / properties / body / properties / projectId / minLength
```
Removed value: -1
```
removedInput schema / properties / body / properties / projectId / type
```
Removed value: -"string"
```
addedInput schema / properties / body / properties / propSchema / $ref
```
Added value: +"#/$defs/__schema4"
```
removedInput schema / properties / body / properties / propSchema / additionalProperties
```
Removed value: -{}
```
removedInput schema / properties / body / properties / propSchema / properties
```
Removed value: -{}
```
removedInput schema / properties / body / properties / propSchema / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / body / properties / propSchema / type
```
Removed value: -"object"
```
addedInput schema / properties / body / properties / source / $ref
```
Added value: +"#/$defs/__schema11"
```
removedInput schema / properties / body / properties / source / additionalProperties
```
Removed value: -false
```

removedInput schema / properties / body / properties / source / properties

Removed value: -{
-  "componentId": {
-    "maxLength": 128,
-    "minLength": 1,
-    "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$",
-    "type": "string"
-  },
-  "definition": {
-    "additionalProperties": false,
-    "properties": {
-      "brandBindings": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "brandKitPath": {
-              "maxLength": 128,
-              "minLength": 1,
-              "type": "string"
-            },
-            "cssVar": {
-              "maxLength": 128,
-              "minLength": 1,
-              "type": "string"
-            },
-            "fallback": {
-              "type": "string"
-            },
-            "propPath": {
-              "maxLength": 128,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "propPath",
-            "cssVar"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "capabilities": {
-        "items": {
-          "oneOf": [
-            {
-              "properties": {
-                "kind": {
-                  "const": "clip",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind"
-              ],
-              "type": "object"
-            },
-            {
-              "properties": {
-                "kind": {
-                  "const": "cut-transition",
-                  "type": "string"
-                },
-                "protocol": {
-                  "const": "per-child",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "protocol"
-              ],
-              "type": "object"
-            },
-            {
-              "properties": {
-                "kind": {
-                  "const": "content-slots",
-                  "type": "string"
-                },
-                "slots": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "max": {
-                        "exclusiveMinimum": 0,
-                        "maximum": 9007199254740991,
-                        "type": "integer"
-                      },
-                      "min": {
-                        "maximum": 9007199254740991,
-                        "minimum": 0,
-                        "type": "integer"
-                      },
-                      "name": {
-                        "maxLength": 128,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "ownership": {
-                        "enum": [
-                          "reference",
-                          "exclusive"
-                        ],
-                        "type": "string"
-                      },
-                      "sizing": {
-                        "enum": [
-                          "canvas",
-                          "container"
-                        ],
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "name",
-                      "min",
-                      "max",
-                      "ownership",
-                      "sizing"
-                    ],
-                    "type": "object"
-                  },
-                  "minItems": 1,
-                  "type": "array"
-                }
-              },
-              "required": [
-                "kind",
-                "slots"
-              ],
-              "type": "object"
-            },
-            {
-              "properties": {
-                "acceptsWrappedTargets": {
-                  "type": "boolean"
-                },
-                "kind": {
-                  "const": "clip-wrapper",
-                  "type": "string"
-                },
-                "ordering": {
-                  "enum": [
-                    "any",
-                    "innermost"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "ordering",
-                "acceptsWrappedTargets"
-              ],
-              "type": "object"
-            },
-            {
-              "properties": {
-                "acceptsWrappedTargets": {
-                  "type": "boolean"
-                },
-                "kind": {
-                  "const": "global-wrapper",
-                  "type": "string"
-                },
-                "ordering": {
-                  "enum": [
-                    "any",
-                    "innermost"
-                  ],
-                  "type": "string"
-                },
-                "scope": {
-                  "const": "media-lanes",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "scope",
-                "ordering",
-                "acceptsWrappedTargets"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "minItems": 1,
-        "type": "array"
-      },
-      "defaults": {
-        "additionalProperties": {},
-        "properties": {},
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "inputSchema": {
-        "additionalProperties": {},
-        "properties": {},
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "mediaBindings": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "cardinality": {
-              "additionalProperties": false,
-              "properties": {
-                "max": {
-                  "exclusiveMinimum": 0,
-                  "maximum": 9007199254740991,
-                  "type": "integer"
-                },
-                "min": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                }
-              },
-              "required": [
-                "min"
-              ],
-              "type": "object"
-            },
-            "collection": {
-              "enum": [
-                "scalar",
-                "array"
-              ],
-              "type": "string"
-            },
-            "kind": {
-              "enum": [
-                "image",
-                "video",
-                "visual"
-              ],
-              "type": "string"
-            },
-            "mediaDemand": {
-              "oneOf": [
-                {
-                  "properties": {
-                    "mode": {
-                      "const": "original",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "mode"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "mode": {
-                      "const": "tier",
-                      "type": "string"
-                    },
-                    "tier": {
-                      "anyOf": [
-                        {
-                          "const": 256,
-                          "type": "number"
-                        },
-                        {
-                          "const": 512,
-                          "type": "number"
-                        },
-                        {
-                          "const": 1024,
-                          "type": "number"
-                        },
-                        {
-                          "const": 2048,
-                          "type": "number"
-                        }
-                      ]
-                    }
-                  },
-                  "required": [
-                    "mode",
-                    "tier"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "maxProjectedHeightRatio": {
-                      "exclusiveMinimum": 0,
-                      "maximum": 64,
-                      "type": "number"
-                    },
-                    "maxProjectedWidthRatio": {
-                      "exclusiveMinimum": 0,
-                      "maximum": 64,
-                      "type": "number"
-                    },
-                    "minVisibleSourceHeightRatio": {
-                      "default": 1,
-                      "exclusiveMinimum": 0,
-                      "maximum": 1,
-                      "type": "number"
-                    },
-                    "minVisibleSourceWidthRatio": {
-                      "default": 1,
-                      "exclusiveMinimum": 0,
-                      "maximum": 1,
-                      "type": "number"
-                    },
-                    "mode": {
-                      "const": "auto",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "mode",
-                    "maxProjectedWidthRatio",
-                    "maxProjectedHeightRatio"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "mimeTypes": {
-              "items": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "minItems": 1,
-              "type": "array"
-            },
-            "name": {
-              "maxLength": 128,
-              "minLength": 1,
-              "type": "string"
-            },
-            "propPath": {
-              "items": {
-                "maxLength": 128,
-                "minLength": 1,
-                "type": "string"
-              },
-              "maxItems": 16,
-              "minItems": 1,
-              "type": "array"
-            }
-          },
-          "required": [
-            "name",
-            "propPath",
-            "kind",
-            "collection",
-            "cardinality"
-          ],
-          "type": "object"
-        },
-        "minItems": 1,
-        "type": "array"
-      },
-      "preview": {
-        "additionalProperties": false,
-        "properties": {
-          "assets": {
-            "additionalProperties": {
-              "anyOf": [
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "durationSec": {
-                      "exclusiveMinimum": 0,
-                      "type": "number"
-                    },
-                    "frameRate": {
-                      "exclusiveMinimum": 0,
-                      "type": "number"
-                    },
-                    "mimeType": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "sha256": {
-                      "pattern": "^[a-f0-9]{64}$",
-                      "type": "string"
-                    },
-                    "url": {
-                      "pattern": "^https:\\/\\/.*",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "url",
-                    "sha256",
-                    "mimeType"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "durationSec": {
-                      "exclusiveMinimum": 0,
-                      "type": "number"
-                    },
-                    "frameRate": {
-                      "exclusiveMinimum": 0,
-                      "type": "number"
-                    },
-                    "mediaId": {
-                      "maxLength": 128,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "mimeType": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "sha256": {
-                      "pattern": "^[a-f0-9]{64}$",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "mediaId",
-                    "sha256",
-                    "mimeType"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "properties": {},
-            "propertyNames": {
-              "maxLength": 128,
-              "minLength": 1,
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "format": {
-            "additionalProperties": {},
-            "properties": {
-              "aspectRatio": {
-                "enum": [
-                  "16:9",
-                  "9:16",
-                  "1:1",
-                  "4:5"
-                ],
-                "type": "string"
-              },
-              "fps": {
-                "anyOf": [
-                  {
-                    "const": 24,
-                    "type": "number"
-                  },
-                  {
-                    "const": 25,
-                    "type": "number"
-                  },
-                  {
-                    "const": 30,
-                    "type": "number"
-                  },
-                  {
-                    "const": 60,
-                    "type": "number"
-                  }
-                ]
-              },
-              "platform": {
-                "type": "string"
-              },
-              "resolution": {
-                "enum": [
-                  "hd",
-                  "fhd",
-                  "4k"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "aspectRatio"
-            ],
-            "type": "object"
-          },
-          "mediaBindings": {
-            "additionalProperties": {
-              "items": {
-                "anyOf": [
-                  {
-                    "additionalProperties": false,
-                    "properties": {
-                      "durationSec": {
-                        "exclusiveMinimum": 0,
-                        "type": "number"
-                      },
-                      "frameRate": {
-                        "exclusiveMinimum": 0,
-                        "type": "number"
-                      },
-                      "mimeType": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "sha256": {
-                        "pattern": "^[a-f0-9]{64}$",
-                        "type": "string"
-                      },
-                      "url": {
-                        "pattern": "^https:\\/\\/.*",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "url",
-                      "sha256",
-                      "mimeType"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "additionalProperties": false,
-                    "properties": {
-                      "durationSec": {
-                        "exclusiveMinimum": 0,
-                        "type": "number"
-                      },
-                      "frameRate": {
-                        "exclusiveMinimum": 0,
-                        "type": "number"
-                      },
-                      "mediaId": {
-                        "maxLength": 128,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "mimeType": {
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "sha256": {
-                        "pattern": "^[a-f0-9]{64}$",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "mediaId",
-                      "sha256",
-                      "mimeType"
-                    ],
-                    "type": "object"
-                  }
-                ]
-              },
-              "type": "array"
-            },
-            "properties": {},
-            "propertyNames": {
-              "maxLength": 128,
-              "minLength": 1,
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "params": {
-            "additionalProperties": {},
-            "properties": {},
-            "propertyNames": {
-              "type": "string"
-            },
-            "type": "object"
-          }
-        },
-        "type": "object"
-      },
-      "timing": {
-        "additionalProperties": false,
-        "properties": {
-          "defaultDuration": {
-            "additionalProperties": false,
-            "properties": {
-              "fps": {
-                "exclusiveMinimum": 0,
-                "type": "number"
-              },
-              "frames": {
-                "exclusiveMinimum": 0,
-                "maximum": 9007199254740991,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "frames",
-              "fps"
-            ],
-            "type": "object"
-          },
-          "maxDurationSec": {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          "minDurationSec": {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "defaultDuration"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "inputSchema",
-      "defaults",
-      "brandBindings",
-      "timing",
-      "capabilities"
-    ],
-    "type": "object"
-  },
-  "manifest": {
-    "additionalProperties": false,
-    "properties": {
-      "alphaPolicy": {
-        "enum": [
-          "requires-transparency",
-          "allows-opaque"
-        ],
-        "type": "string"
-      },
-      "assets": {
-        "additionalProperties": {
-          "additionalProperties": false,
-          "properties": {
-            "kind": {
-              "enum": [
-                "image",
-                "video",
-                "audio",
-                "data",
-                "visual"
-              ],
-              "type": "string"
-            },
-            "mediaDemand": {
-              "oneOf": [
-                {
-                  "properties": {
-                    "mode": {
-                      "const": "original",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "mode"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "mode": {
-                      "const": "tier",
-                      "type": "string"
-                    },
-                    "tier": {
-                      "anyOf": [
-                        {
-                          "const": 256,
-                          "type": "number"
-                        },
-                        {
-                          "const": 512,
-                          "type": "number"
-                        },
-                        {
-                          "const": 1024,
-                          "type": "number"
-                        },
-                        {
-                          "const": 2048,
-                          "type": "number"
-                        }
-                      ]
-                    }
-                  },
-                  "required": [
-                    "mode",
-                    "tier"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "properties": {
-                    "maxProjectedHeightRatio": {
-                      "exclusiveMinimum": 0,
-                      "maximum": 64,
-                      "type": "number"
-                    },
-                    "maxProjectedWidthRatio": {
-                      "exclusiveMinimum": 0,
-                      "maximum": 64,
-                      "type": "number"
-                    },
-                    "minVisibleSourceHeightRatio": {
-                      "default": 1,
-                      "exclusiveMinimum": 0,
-                      "maximum": 1,
-                      "type": "number"
-                    },
-                    "minVisibleSourceWidthRatio": {
-                      "default": 1,
-                      "exclusiveMinimum": 0,
-                      "maximum": 1,
-                      "type": "number"
-                    },
-                    "mode": {
-                      "const": "auto",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "mode",
-                    "maxProjectedWidthRatio",
-                    "maxProjectedHeightRatio"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "mimeTypes": {
-              "items": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "minItems": 1,
-              "type": "array"
-            },
-            "required": {
-              "type": "boolean"
-            }
-          },
-          "required": [
-            "kind",
-            "required"
-          ],
-          "type": "object"
-        },
-        "properties": {},
-        "propertyNames": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "graphics": {
-        "additionalProperties": false,
-        "properties": {
-          "accelerationPreference": {
-            "enum": [
-              "hardware-preferred",
-              "software-allowed"
-            ],
-            "type": "string"
-          },
-          "api": {
-            "enum": [
-              "canvas2d",
-              "webgl",
-              "webgl2",
-              "webgpu"
-            ],
-            "type": "string"
-          },
-          "required": {
-            "const": true,
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "api",
-          "required",
-          "accelerationPreference"
-        ],
-        "type": "object"
-      },
-      "hfContract": {
-        "const": 1,
-        "type": "number"
-      },
-      "kind": {
-        "const": "scene",
-        "type": "string"
-      },
-      "runtime": {
-        "const": "hyperframes",
-        "type": "string"
-      },
-      "sceneShot": {
-        "additionalProperties": false,
-        "properties": {
-          "version": {
-            "const": 2,
-            "type": "number"
-          }
-        },
-        "required": [
-          "version"
-        ],
-        "type": "object"
-      },
-      "version": {
-        "const": 4,
-        "type": "number"
-      }
-    },
-    "required": [
-      "version",
-      "runtime",
-      "hfContract",
-      "kind",
-      "assets",
-      "graphics",
-      "alphaPolicy"
-    ],
-    "type": "object"
-  },
-  "template": {
-    "maxLength": 2000000,
-    "minLength": 1,
-    "type": "string"
-  },
-  "version": {
-    "const": 4,
-    "type": "number"
-  }
-}

removedInput schema / properties / body / properties / source / required

Removed value: -[
-  "version",
-  "componentId",
-  "template",
-  "manifest",
-  "definition"
-]

removedInput schema / properties / body / properties / source / type
```
Removed value: -"object"
```
addedInput schema / properties / body / properties / tokens / $ref
```
Added value: +"#/$defs/__schema7"
```
removedInput schema / properties / body / properties / tokens / additionalProperties
```
Removed value: -{}
```
removedInput schema / properties / body / properties / tokens / properties
```
Removed value: -{}
```
removedInput schema / properties / body / properties / tokens / propertyNames
```
Removed value: -{
-  "type": "string"
-}
```
removedInput schema / properties / body / properties / tokens / type
```
Removed value: -"object"
```
addedInput schema / properties / commandId / $ref
```
Added value: +"#/$defs/__schema24"
```
removedInput schema / properties / commandId / maxLength
```
Removed value: -128
```
removedInput schema / properties / commandId / minLength
```
Removed value: -1
```
removedInput schema / properties / commandId / type
```
Removed value: -"string"
```

Changed2 schema fields changedOct 22, 2026

changedInput schema / properties / body / properties / concurrency / description

Previous value: -"Caller-observed placement guard. Atomic library edits with placement changes require explicit supported invocation admission."New value: +"Caller-observed placement guard, required with projectId and compositionId: a placement update without it is refused with 428 precondition_required. Atomic library edits with placement changes require explicit supported invocation admission."

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"
+}

Changed23 schema fields changedOct 18, 2026

removedInput schema / properties / body / properties / concurrency / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "expectedRevision": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "mode": {
-        "const": "exact",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode",
-      "expectedRevision"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "basis": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "key": {
-              "maxLength": 256,
-              "minLength": 1,
-              "type": "string"
-            },
-            "token": {
-              "maxLength": 65536,
-              "type": "string"
-            }
-          },
-          "required": [
-            "key",
-            "token"
-          ],
-          "type": "object"
-        },
-        "maxItems": 2048,
-        "type": "array"
-      },
-      "compositionId": {
-        "maxLength": 128,
-        "minLength": 1,
-        "type": "string"
-      },
-      "mode": {
-        "const": "guarded",
-        "type": "string"
-      },
-      "observedRevision": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "mode",
-      "observedRevision",
-      "basis"
-    ],
-    "type": "object"
-  }
-]

addedInput schema / properties / body / properties / concurrency / oneOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "expectedRevision": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "mode": {
+        "const": "exact",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "expectedRevision"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "basis": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "key": {
+              "maxLength": 256,
+              "minLength": 1,
+              "type": "string"
+            },
+            "token": {
+              "maxLength": 65536,
+              "type": "string"
+            }
+          },
+          "required": [
+            "key",
+            "token"
+          ],
+          "type": "object"
+        },
+        "maxItems": 2048,
+        "type": "array"
+      },
+      "compositionId": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mode": {
+        "const": "guarded",
+        "type": "string"
+      },
+      "observedRevision": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "mode",
+      "observedRevision",
+      "basis"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / body / properties / examples / items / properties
```
Added value: +{}
```
addedInput schema / properties / body / properties / propSchema / properties
```
Added value: +{}
```

removed

Input schema / properties / body / properties / source / properties / definition / properties / capabilities / items / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "kind": {
-        "const": "clip",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "kind": {
-        "const": "cut-transition",
-        "type": "string"
-      },
-      "protocol": {
-        "const": "per-child",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "protocol"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "kind": {
-        "const": "content-slots",
-        "type": "string"
-      },
-      "slots": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "max": {
-              "exclusiveMinimum": 0,
-              "maximum": 9007199254740991,
-              "type": "integer"
-            },
-            "min": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "name": {
-              "maxLength": 128,
-              "minLength": 1,
-              "type": "string"
-            },
-            "ownership": {
-              "enum": [
-                "reference",
-                "exclusive"
-              ],
-              "type": "string"
-            },
-            "sizing": {
-              "enum": [
-                "canvas",
-                "container"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "min",
-            "max",
-            "ownership",
-            "sizing"
-          ],
-          "type": "object"
-        },
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "kind",
-      "slots"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "acceptsWrappedTargets": {
-        "type": "boolean"
-      },
-      "kind": {
-        "const": "clip-wrapper",
-        "type": "string"
-      },
-      "ordering": {
-        "enum": [
-          "any",
-          "innermost"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "ordering",
-      "acceptsWrappedTargets"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "acceptsWrappedTargets": {
-        "type": "boolean"
-      },
-      "kind": {
-        "const": "global-wrapper",
-        "type": "string"
-      },
-      "ordering": {
-        "enum": [
-          "any",
-          "innermost"
-        ],
-        "type": "string"
-      },
-      "scope": {
-        "const": "media-lanes",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "scope",
-      "ordering",
-      "acceptsWrappedTargets"
-    ],
-    "type": "object"
-  }
-]

added

Input schema / properties / body / properties / source / properties / definition / properties / capabilities / items / oneOf

Added value: +[
+  {
+    "properties": {
+      "kind": {
+        "const": "clip",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "cut-transition",
+        "type": "string"
+      },
+      "protocol": {
+        "const": "per-child",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "protocol"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "content-slots",
+        "type": "string"
+      },
+      "slots": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "max": {
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991,
+              "type": "integer"
+            },
+            "min": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "name": {
+              "maxLength": 128,
+              "minLength": 1,
+              "type": "string"
+            },
+            "ownership": {
+              "enum": [
+                "reference",
+                "exclusive"
+              ],
+              "type": "string"
+            },
+            "sizing": {
+              "enum": [
+                "canvas",
+                "container"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "min",
+            "max",
+            "ownership",
+            "sizing"
+          ],
+          "type": "object"
+        },
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "kind",
+      "slots"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "acceptsWrappedTargets": {
+        "type": "boolean"
+      },
+      "kind": {
+        "const": "clip-wrapper",
+        "type": "string"
+      },
+      "ordering": {
+        "enum": [
+          "any",
+          "innermost"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "ordering",
+      "acceptsWrappedTargets"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "acceptsWrappedTargets": {
+        "type": "boolean"
+      },
+      "kind": {
+        "const": "global-wrapper",
+        "type": "string"
+      },
+      "ordering": {
+        "enum": [
+          "any",
+          "innermost"
+        ],
+        "type": "string"
+      },
+      "scope": {
+        "const": "media-lanes",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "scope",
+      "ordering",
+      "acceptsWrappedTargets"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / body / properties / source / properties / definition / properties / defaults / properties
```
Added value: +{}
```
addedInput schema / properties / body / properties / source / properties / definition / properties / inputSchema / properties
```
Added value: +{}
```

removed

Input schema / properties / body / properties / source / properties / definition / properties / mediaBindings / items / properties / mediaDemand / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "mode": {
-        "const": "original",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "mode": {
-        "const": "tier",
-        "type": "string"
-      },
-      "tier": {
-        "anyOf": [
-          {
-            "const": 256,
-            "type": "number"
-          },
-          {
-            "const": 512,
-            "type": "number"
-          },
-          {
-            "const": 1024,
-            "type": "number"
-          },
-          {
-            "const": 2048,
-            "type": "number"
-          }
-        ]
-      }
-    },
-    "required": [
-      "mode",
-      "tier"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "maxProjectedHeightRatio": {
-        "exclusiveMinimum": 0,
-        "maximum": 64,
-        "type": "number"
-      },
-      "maxProjectedWidthRatio": {
-        "exclusiveMinimum": 0,
-        "maximum": 64,
-        "type": "number"
-      },
-      "minVisibleSourceHeightRatio": {
-        "default": 1,
-        "exclusiveMinimum": 0,
-        "maximum": 1,
-        "type": "number"
-      },
-      "minVisibleSourceWidthRatio": {
-        "default": 1,
-        "exclusiveMinimum": 0,
-        "maximum": 1,
-        "type": "number"
-      },
-      "mode": {
-        "const": "auto",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode",
-      "maxProjectedWidthRatio",
-      "maxProjectedHeightRatio"
-    ],
-    "type": "object"
-  }
-]

added

Input schema / properties / body / properties / source / properties / definition / properties / mediaBindings / items / properties / mediaDemand / oneOf

Added value: +[
+  {
+    "properties": {
+      "mode": {
+        "const": "original",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "mode": {
+        "const": "tier",
+        "type": "string"
+      },
+      "tier": {
+        "anyOf": [
+          {
+            "const": 256,
+            "type": "number"
+          },
+          {
+            "const": 512,
+            "type": "number"
+          },
+          {
+            "const": 1024,
+            "type": "number"
+          },
+          {
+            "const": 2048,
+            "type": "number"
+          }
+        ]
+      }
+    },
+    "required": [
+      "mode",
+      "tier"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "maxProjectedHeightRatio": {
+        "exclusiveMinimum": 0,
+        "maximum": 64,
+        "type": "number"
+      },
+      "maxProjectedWidthRatio": {
+        "exclusiveMinimum": 0,
+        "maximum": 64,
+        "type": "number"
+      },
+      "minVisibleSourceHeightRatio": {
+        "default": 1,
+        "exclusiveMinimum": 0,
+        "maximum": 1,
+        "type": "number"
+      },
+      "minVisibleSourceWidthRatio": {
+        "default": 1,
+        "exclusiveMinimum": 0,
+        "maximum": 1,
+        "type": "number"
+      },
+      "mode": {
+        "const": "auto",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "maxProjectedWidthRatio",
+      "maxProjectedHeightRatio"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / body / properties / source / properties / definition / properties / preview / properties / assets / properties
```
Added value: +{}
```
addedInput schema / properties / body / properties / source / properties / definition / properties / preview / properties / assets / propertyNames / maxLength
```
Added value: +128
```
addedInput schema / properties / body / properties / source / properties / definition / properties / preview / properties / assets / propertyNames / minLength
```
Added value: +1
```
changedInput schema / properties / body / properties / source / properties / definition / properties / preview / properties / format / additionalProperties
```
Previous value: -falseNew value: +{}
```
addedInput schema / properties / body / properties / source / properties / definition / properties / preview / properties / mediaBindings / properties
```
Added value: +{}
```
addedInput schema / properties / body / properties / source / properties / definition / properties / preview / properties / mediaBindings / propertyNames / maxLength
```
Added value: +128
```
addedInput schema / properties / body / properties / source / properties / definition / properties / preview / properties / mediaBindings / propertyNames / minLength
```
Added value: +1
```
addedInput schema / properties / body / properties / source / properties / definition / properties / preview / properties / params / properties
```
Added value: +{}
```

removed

Input schema / properties / body / properties / source / properties / manifest / properties / assets / additionalProperties / properties / mediaDemand / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "mode": {
-        "const": "original",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "mode": {
-        "const": "tier",
-        "type": "string"
-      },
-      "tier": {
-        "anyOf": [
-          {
-            "const": 256,
-            "type": "number"
-          },
-          {
-            "const": 512,
-            "type": "number"
-          },
-          {
-            "const": 1024,
-            "type": "number"
-          },
-          {
-            "const": 2048,
-            "type": "number"
-          }
-        ]
-      }
-    },
-    "required": [
-      "mode",
-      "tier"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "maxProjectedHeightRatio": {
-        "exclusiveMinimum": 0,
-        "maximum": 64,
-        "type": "number"
-      },
-      "maxProjectedWidthRatio": {
-        "exclusiveMinimum": 0,
-        "maximum": 64,
-        "type": "number"
-      },
-      "minVisibleSourceHeightRatio": {
-        "default": 1,
-        "exclusiveMinimum": 0,
-        "maximum": 1,
-        "type": "number"
-      },
-      "minVisibleSourceWidthRatio": {
-        "default": 1,
-        "exclusiveMinimum": 0,
-        "maximum": 1,
-        "type": "number"
-      },
-      "mode": {
-        "const": "auto",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode",
-      "maxProjectedWidthRatio",
-      "maxProjectedHeightRatio"
-    ],
-    "type": "object"
-  }
-]

added

Input schema / properties / body / properties / source / properties / manifest / properties / assets / additionalProperties / properties / mediaDemand / oneOf

Added value: +[
+  {
+    "properties": {
+      "mode": {
+        "const": "original",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "mode": {
+        "const": "tier",
+        "type": "string"
+      },
+      "tier": {
+        "anyOf": [
+          {
+            "const": 256,
+            "type": "number"
+          },
+          {
+            "const": 512,
+            "type": "number"
+          },
+          {
+            "const": 1024,
+            "type": "number"
+          },
+          {
+            "const": 2048,
+            "type": "number"
+          }
+        ]
+      }
+    },
+    "required": [
+      "mode",
+      "tier"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "maxProjectedHeightRatio": {
+        "exclusiveMinimum": 0,
+        "maximum": 64,
+        "type": "number"
+      },
+      "maxProjectedWidthRatio": {
+        "exclusiveMinimum": 0,
+        "maximum": 64,
+        "type": "number"
+      },
+      "minVisibleSourceHeightRatio": {
+        "default": 1,
+        "exclusiveMinimum": 0,
+        "maximum": 1,
+        "type": "number"
+      },
+      "minVisibleSourceWidthRatio": {
+        "default": 1,
+        "exclusiveMinimum": 0,
+        "maximum": 1,
+        "type": "number"
+      },
+      "mode": {
+        "const": "auto",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "maxProjectedWidthRatio",
+      "maxProjectedHeightRatio"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / body / properties / source / properties / manifest / properties / assets / properties
```
Added value: +{}
```
addedInput schema / properties / body / properties / source / properties / manifest / properties / assets / propertyNames / minLength
```
Added value: +1
```
addedInput schema / properties / body / properties / tokens / properties
```
Added value: +{}
```

Changed14 schema fields changedOct 15, 2026

addedInput schema / properties / body / properties / source / properties / manifest / properties / hfContract
```
Added value: +{
+  "const": 1,
+  "type": "number"
+}
```
addedInput schema / properties / body / properties / source / properties / manifest / properties / kind
```
Added value: +{
+  "const": "scene",
+  "type": "string"
+}
```
addedInput schema / properties / body / properties / source / properties / manifest / properties / runtime
```
Added value: +{
+  "const": "hyperframes",
+  "type": "string"
+}
```
changedInput schema / properties / body / properties / source / properties / manifest / properties / version / const
```
Previous value: -2New value: +4
```

removedInput schema / properties / body / properties / source / properties / manifest / properties / visualMedia

Removed value: -{
-  "additionalProperties": false,
-  "properties": {
-    "version": {
-      "const": 1,
-      "type": "number"
-    }
-  },
-  "required": [
-    "version"
-  ],
-  "type": "object"
-}

changedInput schema / properties / body / properties / source / properties / manifest / required

Previous value: -[
-  "version",
-  "assets",
-  "graphics",
-  "alphaPolicy"
-]New value: +[
+  "version",
+  "runtime",
+  "hfContract",
+  "kind",
+  "assets",
+  "graphics",
+  "alphaPolicy"
+]

addedInput schema / properties / body / properties / source / properties / template

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

removedInput schema / properties / body / properties / source / properties / tsxSource

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

changedInput schema / properties / body / properties / source / properties / version / const
```
Previous value: -3New value: +4
```

changedInput schema / properties / body / properties / source / required

Previous value: -[
-  "version",
-  "componentId",
-  "tsxSource",
-  "manifest",
-  "definition"
-]New value: +[
+  "version",
+  "componentId",
+  "template",
+  "manifest",
+  "definition"
+]

removedOutput schema / properties / manifest / additionalProperties
```
Removed value: -{}
```
removedOutput schema / properties / manifest / properties
```
Removed value: -{}
```
removedOutput schema / properties / manifest / type
```
Removed value: -"object"
```

changedOutput schema / properties / version / description

Previous value: -"The ENTRY's version: a semver string ('0.0.0' until an authored component is versioned). Distinct from `manifest.version`, which is the runtime contract version and is always the literal 2."New value: +"The ENTRY's version: a semver string ('0.0.0' until an authored component is versioned). Distinct from `manifest.version`, which is the runtime contract version (4 native, 2 retired TSX)."

First observedOct 10, 2026

TDQS

A4.8/5.0

Behavior5/5

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

Beyond annotations, it discloses important side effects: the tool updates in place, source is admitted before the write, placed clips move only when projectId is named, previews/renders keep the old version otherwise, and the response carries repinned and placementsPinnedToPrevious. This is exactly the behavioral context an agent needs for a destructive mutating tool with repinning consequences.

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

Conciseness4/5

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

The core purpose and the author→preview→fix loop are front-loaded, and most of the dense text earns its place by explaining repin behavior and alternatives. It is still long and tightly packed, with several clauses in single sentences, and could be made slightly more scannable.

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

Completeness5/5

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

For a complex, destructive, idempotent update tool with nested body objects, the description covers invocation, admission, placement repinning, output fields, and the apply_composition alternative. Since an output schema already exists, it does not need to restate return values, and nothing material is missing for correct invocation.

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?

Schema coverage is already 100%, but the description adds real semantic meaning for body: it gives the source contract shape {version, componentId, template, manifest, definition}, explains root lookup via document.getElementById('root'), notes slots arrive in assets, and describes projectId/compositionId defaults. It does not cover commandId or expectedHeadVersionId/concurrency guards in comparable detail, which keeps this from a top score.

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

Purpose5/5

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

The description gives a precise verb and resource — update an authored component's version-4 source/metadata IN PLACE (same id) — and explicitly routes it against siblings: it is 'the correct verb for the author→preview→fix loop' and says to use it 'instead of creating a new component each iteration.' An agent can distinguish it from create_component and preview_component without opening the schema.

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

Usage Guidelines5/5

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

It states exactly when to use this tool and names the alternatives: use preview_component to see the error, fix the template here, re-preview; for one placement, use apply_composition clip.update instead. The projectId branch explicitly says when the broader repin behavior applies and warns to use it only when 'that broader edit is requested.'

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.

Update Component

Tool call template

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources