CueFrame

Create Component

create_component

Create and store a custom component for the tenant: a native scene that arranges its declared images and videos as tiles in 3D space. Returns the ComponentResponse (id + metadata) you can then reference from a composition. No project arg — components are tenant-scoped. SOURCE CONTRACT (version 4; the server instructions' Component Contract has the full rules and an example): send the complete source object {version:4, componentId, template, manifest, definition}. template is one sub-composition: a root holding , and one inline script ending in __cfScene.mount({ root: document.getElementById('root'), component, variables: __hyperframes.getVariables() }). data-composition-variables is the definition's projection (scalar inputSchema properties, then manifest slots). The manifest is {version:4, runtime:'hyperframes', hfContract:1, kind:'scene', assets, graphics:{api:'webgl2',…}, alphaPolicy}; slots are image or video. The source is admitted before it is stored: template lint, determinism (no timers, Date, network or CSS animation) and the declaration are checked, and a refusal names the rule. A version-3 source is retired and refused as component_source_retired. Place it with execution {version:4, componentId, sourceVersionId, params, seed, assets:{ slot: mediaId }} and placement {version:3, kind:'clip'}; slots never travel in params.

Tool call template

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

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

Input Schema

Name	Required	Description	Default
`body`	Yes	POST /components body. 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.

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
`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

Schema Changelog

Changes observed during successful MCP inspections.

Changed26 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 / maxLength
```
Removed value: -128
```
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"

addedInput schema / $defs / __schema19

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

removedInput schema / $defs / __schema8

Removed value: -{
-  "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"
-}

removedInput schema / $defs / __schema9

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

removedInput schema / properties / body / properties / examples / $ref
```
Removed value: -"#/$defs/__schema8"
```

addedInput schema / properties / body / properties / examples / description

Added 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. Call describe_tool_input with tool \"create_component\" and field \"examples\" for the exact JSON Schema."

addedInput schema / properties / body / properties / examples / items
```
Added value: +{
+  "type": "object"
+}
```
addedInput schema / properties / body / properties / examples / type
```
Added value: +"array"
```
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 \"create_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/__schema18"New value: +"#/$defs/__schema19"

Changed48 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": {
+    "maxLength": 128,
+    "minLength": 1,
+    "type": "string"
+  },
+  "__schema2": {
+    "maxLength": 2000,
+    "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 / 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 / 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/__schema18"
```
removedInput schema / properties / commandId / maxLength
```
Removed value: -128
```
removedInput schema / properties / commandId / minLength
```
Removed value: -1
```
removedInput schema / properties / commandId / type
```
Removed value: -"string"
```

Changed1 schema field changedOct 22, 2026

addedInput schema / properties / commandId

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

Changed21 schema fields changedOct 18, 2026

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.3/5.0

Behavior5/5

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

Goes well past the annotations: it discloses that the source is admitted before storage (template lint, determinism rules banning timers/Date/network/CSS animation, declaration checks), that refusals name the violated rule, that version-3 sources are rejected as component_source_retired, and that the response is ComponentResponse (id + metadata). Annotations only say non-read-only/non-destructive/non-idempotent; the description supplies the mutation's actual risk profile and failure modes.

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

Conciseness3/5

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

Front-loaded correctly — the tool's purpose is the first clause — but the rest is a single dense block of jargon-heavy prose with no line breaks or bullet structure, forcing the reader to parse a schema contract inline. For this complexity some length is warranted, yet the informativity-per-sentence varies and the pointer to "the server instructions' Component Contract" partially duplicates what is restated here.

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

Completeness4/5

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

With an output schema present, the description needn't explain return shape, and it correctly limits itself to id+metadata context. It covers the admission pipeline, versioning, scoping, and placement contract. It omits what happens on a duplicate or colliding componentId (create vs. overwrite, conflict status), which is the main remaining gap for a create operation.

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

Parameters5/5

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

Schema coverage is 100%, so baseline is 3, but the description earns more: the `source` field is opaque in the schema (just a pointer to describe_tool_input with required keys), and the description spells out the four sub-objects, the required template DOM skeleton, the __cfScene.mount call, the data-composition-variables projection rule, the manifest fields, and the slot constraint ("slots never travel in params"). That is meaning the schema does not carry.

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

Purpose4/5

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

A concrete verb+resource ("Create and store a custom component for the tenant") plus a one-line explanation of what a component actually is (a native 3D scene tiling declared media). The tenant-scoping note ("No project arg") narrows scope, but no sibling is named, so a caller has to infer the boundary with update_component, preview_component, and resolve_builtin_component.

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

Usage Guidelines4/5

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

The description lays out the downstream workflow explicitly — the returned ComponentResponse id is referenced from a composition, and placement uses execution {version:4,...} plus placement {version:3, kind:'clip'}. It never states when NOT to use this tool or which sibling to pick instead (e.g. preview_component before creating, update_component for edits), so it stops short of full routing guidance.

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

All CueFrame tools Inspect

Try in Browser

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

Glama MCP Gateway

Add one secure layer between your agents and this server.

Create Component

Tool call template

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources