{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://artifacts.apis.io/cueframe-ai/json-schema/cueframe-ai-component-list-response-schema.json", "title": "ComponentListResponse", "x-generated": "2026-11-10", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/cueframe-ai-components-api-openapi.yml#/components/schemas/ComponentListResponse", "anyOf": [ { "$ref": "#/$defs/LegacyComponentListResponse" }, { "type": "object", "properties": { "protocolVersion": { "type": "number", "const": 1 }, "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "builtin" }, "collection": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "collection" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-local" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "workspaceId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-hosted" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "deploymentId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "deploymentId" ], "additionalProperties": false } ], "type": "object" }, "data": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "identity": { "type": "object", "properties": { "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "builtin" }, "collection": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "collection" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-local" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "workspaceId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-hosted" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "deploymentId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "deploymentId" ], "additionalProperties": false } ], "type": "object" }, "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "revision": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "scope", "id", "revision" ], "additionalProperties": false }, "name": { "type": "string", "minLength": 1, "maxLength": 256 }, "description": { "type": "string" }, "category": { "type": "string", "minLength": 1, "maxLength": 256 }, "presentation": { "type": "object", "properties": { "version": { "type": "number", "const": 1 }, "representativeTimeSeconds": { "type": "number", "minimum": 0 } }, "required": [ "version", "representativeTimeSeconds" ], "additionalProperties": false }, "showcase": { "type": "object", "properties": { "version": { "type": "number", "const": 1 }, "presentationKey": { "type": "string", "minLength": 1 }, "fixtureIdentity": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "rendererIdentity": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "video": { "type": "object", "properties": { "file": { "type": "string", "minLength": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "byteLength": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "width": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "height": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "fps": { "type": "number", "exclusiveMinimum": 0 }, "durationInFrames": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "file", "sha256", "byteLength", "width", "height", "fps", "durationInFrames" ], "additionalProperties": false }, "poster": { "type": "object", "properties": { "file": { "type": "string", "minLength": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "byteLength": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "frame": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "file", "sha256", "byteLength", "frame" ], "additionalProperties": false } }, "required": [ "version", "presentationKey", "fixtureIdentity", "rendererIdentity", "video", "poster" ], "additionalProperties": false }, "preview": { "type": "object", "properties": { "identity": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "status": { "type": "string", "enum": [ "unproven", "verified" ] } }, "required": [ "identity", "status" ], "additionalProperties": false }, "kind": { "type": "string", "const": "definition" }, "source": { "type": "object", "properties": { "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "builtin" }, "collection": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "collection" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-local" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "workspaceId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-hosted" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "deploymentId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "deploymentId" ], "additionalProperties": false } ], "type": "object" }, "componentId": { "type": "string", "minLength": 1, "maxLength": 256 }, "sourceVersionId": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "sourceVersion": { "anyOf": [ { "type": "number", "const": 3 }, { "type": "number", "const": 4 } ] } }, "required": [ "scope", "componentId", "sourceVersionId", "sourceVersion" ], "additionalProperties": false }, "declaration": { "type": "object", "properties": { "state": { "type": "string", "const": "v3" }, "capabilities": { "minItems": 1, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "clip" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "cut-transition" }, "protocol": { "type": "string", "const": "per-child" } }, "required": [ "kind", "protocol" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "content-slots" }, "slots": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 128 }, "min": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "max": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "ownership": { "type": "string", "enum": [ "reference", "exclusive" ] }, "sizing": { "type": "string", "enum": [ "canvas", "container" ] } }, "required": [ "name", "min", "max", "ownership", "sizing" ], "additionalProperties": false } } }, "required": [ "kind", "slots" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "clip-wrapper" }, "ordering": { "type": "string", "enum": [ "any", "innermost" ] }, "acceptsWrappedTargets": { "type": "boolean" } }, "required": [ "kind", "ordering", "acceptsWrappedTargets" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "global-wrapper" }, "scope": { "type": "string", "const": "media-lanes" }, "ordering": { "type": "string", "enum": [ "any", "innermost" ] }, "acceptsWrappedTargets": { "type": "boolean" } }, "required": [ "kind", "scope", "ordering", "acceptsWrappedTargets" ], "additionalProperties": false } ], "type": "object" } }, "timing": { "type": "object", "properties": { "defaultDuration": { "type": "object", "properties": { "frames": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "fps": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "frames", "fps" ], "additionalProperties": false }, "minDurationSec": { "type": "number", "exclusiveMinimum": 0 }, "maxDurationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "defaultDuration" ], "additionalProperties": false } }, "required": [ "state", "capabilities", "timing" ], "additionalProperties": false }, "origin": { "type": "string", "enum": [ "server-native", "customer-owned" ] } }, "required": [ "identity", "name", "description", "category", "kind", "source", "declaration", "origin" ], "additionalProperties": false }, { "type": "object", "properties": { "identity": { "type": "object", "properties": { "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "builtin" }, "collection": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "collection" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-local" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "workspaceId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-hosted" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "deploymentId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "deploymentId" ], "additionalProperties": false } ], "type": "object" }, "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "revision": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "scope", "id", "revision" ], "additionalProperties": false }, "name": { "type": "string", "minLength": 1, "maxLength": 256 }, "description": { "type": "string" }, "category": { "type": "string", "minLength": 1, "maxLength": 256 }, "presentation": { "type": "object", "properties": { "version": { "type": "number", "const": 1 }, "representativeTimeSeconds": { "type": "number", "minimum": 0 } }, "required": [ "version", "representativeTimeSeconds" ], "additionalProperties": false }, "showcase": { "type": "object", "properties": { "version": { "type": "number", "const": 1 }, "presentationKey": { "type": "string", "minLength": 1 }, "fixtureIdentity": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "rendererIdentity": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "video": { "type": "object", "properties": { "file": { "type": "string", "minLength": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "byteLength": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "width": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "height": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "fps": { "type": "number", "exclusiveMinimum": 0 }, "durationInFrames": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "file", "sha256", "byteLength", "width", "height", "fps", "durationInFrames" ], "additionalProperties": false }, "poster": { "type": "object", "properties": { "file": { "type": "string", "minLength": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "byteLength": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "frame": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "file", "sha256", "byteLength", "frame" ], "additionalProperties": false } }, "required": [ "version", "presentationKey", "fixtureIdentity", "rendererIdentity", "video", "poster" ], "additionalProperties": false }, "preview": { "type": "object", "properties": { "identity": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "status": { "type": "string", "enum": [ "unproven", "verified" ] } }, "required": [ "identity", "status" ], "additionalProperties": false }, "kind": { "type": "string", "const": "preset" }, "definition": { "type": "object", "properties": { "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "builtin" }, "collection": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "collection" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-local" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "workspaceId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-hosted" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "deploymentId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "deploymentId" ], "additionalProperties": false } ], "type": "object" }, "componentId": { "type": "string", "minLength": 1, "maxLength": 256 }, "sourceVersionId": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "sourceVersion": { "anyOf": [ { "type": "number", "const": 3 }, { "type": "number", "const": 4 } ] } }, "required": [ "scope", "componentId", "sourceVersionId", "sourceVersion" ], "additionalProperties": false }, "presetVersionId": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "historicalDocument": { "type": "object", "properties": { "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "builtin" }, "collection": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "collection" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-local" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "workspaceId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-hosted" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "deploymentId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "deploymentId" ], "additionalProperties": false } ], "type": "object" }, "documentId": { "type": "string", "minLength": 1, "maxLength": 256 }, "documentSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "scope", "documentId", "documentSha256" ], "additionalProperties": false }, "equivalence": { "type": "string", "enum": [ "unproven", "verified" ] } }, "required": [ "identity", "name", "description", "category", "kind", "definition", "presetVersionId", "historicalDocument", "equivalence" ], "additionalProperties": false }, { "type": "object", "properties": { "identity": { "type": "object", "properties": { "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "builtin" }, "collection": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "collection" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-local" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "workspaceId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-hosted" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "deploymentId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "deploymentId" ], "additionalProperties": false } ], "type": "object" }, "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "revision": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "scope", "id", "revision" ], "additionalProperties": false }, "name": { "type": "string", "minLength": 1, "maxLength": 256 }, "description": { "type": "string" }, "category": { "type": "string", "minLength": 1, "maxLength": 256 }, "presentation": { "type": "object", "properties": { "version": { "type": "number", "const": 1 }, "representativeTimeSeconds": { "type": "number", "minimum": 0 } }, "required": [ "version", "representativeTimeSeconds" ], "additionalProperties": false }, "showcase": { "type": "object", "properties": { "version": { "type": "number", "const": 1 }, "presentationKey": { "type": "string", "minLength": 1 }, "fixtureIdentity": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "rendererIdentity": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "video": { "type": "object", "properties": { "file": { "type": "string", "minLength": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "byteLength": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "width": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "height": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "fps": { "type": "number", "exclusiveMinimum": 0 }, "durationInFrames": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "file", "sha256", "byteLength", "width", "height", "fps", "durationInFrames" ], "additionalProperties": false }, "poster": { "type": "object", "properties": { "file": { "type": "string", "minLength": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "byteLength": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "frame": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "file", "sha256", "byteLength", "frame" ], "additionalProperties": false } }, "required": [ "version", "presentationKey", "fixtureIdentity", "rendererIdentity", "video", "poster" ], "additionalProperties": false }, "preview": { "type": "object", "properties": { "identity": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "status": { "type": "string", "enum": [ "unproven", "verified" ] } }, "required": [ "identity", "status" ], "additionalProperties": false }, "kind": { "type": "string", "const": "recipe" }, "document": { "type": "object", "properties": { "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "builtin" }, "collection": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "collection" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-local" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "workspaceId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-hosted" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "deploymentId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "deploymentId" ], "additionalProperties": false } ], "type": "object" }, "documentId": { "type": "string", "minLength": 1, "maxLength": 256 }, "documentSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "scope", "documentId", "documentSha256" ], "additionalProperties": false }, "placementCount": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "memberSources": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "scope": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "builtin" }, "collection": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "collection" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-local" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "workspaceId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "org-hosted" }, "orgId": { "type": "string", "minLength": 1, "maxLength": 256 }, "deploymentId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "kind", "orgId", "deploymentId" ], "additionalProperties": false } ], "type": "object" }, "componentId": { "type": "string", "minLength": 1, "maxLength": 256 }, "sourceVersionId": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "sourceVersion": { "anyOf": [ { "type": "number", "const": 3 }, { "type": "number", "const": 4 } ] } }, "required": [ "scope", "componentId", "sourceVersionId", "sourceVersion" ], "additionalProperties": false } }, "equivalence": { "type": "string", "enum": [ "unproven", "verified" ] } }, "required": [ "identity", "name", "description", "category", "kind", "document", "placementCount", "memberSources", "equivalence" ], "additionalProperties": false } ], "type": "object" } }, "pagination": { "$ref": "#/$defs/PaginationMeta" } }, "required": [ "protocolVersion", "data", "pagination" ], "additionalProperties": false } ], "$defs": { "AudioPaletteEntry": { "type": "object", "properties": { "ref": { "type": "string", "description": "Placement handle: a pack soundId/bedId, or an org media id." }, "role": { "type": "string", "enum": [ "vo", "music", "sfx", "ambience" ], "description": "Declared role for mix policy." }, "envelopeClass": { "type": "string", "enum": [ "transient", "sweep", "ambient" ], "description": "Coarse envelope shape — the browse grouping." }, "description": { "type": "string" }, "durationSec": { "type": "number" }, "evidence": { "type": "object", "properties": { "envelopeClass": { "type": "string", "enum": [ "transient", "sweep", "ambient" ] }, "attackMs": { "type": "number" }, "spectralCentroidHz": { "type": "number" }, "meanVolumeDb": { "type": "number" }, "maxVolumeDb": { "type": "number" } }, "required": [ "envelopeClass" ], "additionalProperties": false, "description": "Envelope probe evidence (always carries envelopeClass)." }, "source": { "type": "string", "enum": [ "pack", "org", "generated" ], "description": "Provenance discriminant." }, "license": { "type": "string", "description": "\"CC0\" (pack), \"org-owned\"/a CC token (org), or \"generated\"." }, "provenance": { "type": "string", "description": "Human-legible provenance (pack attribution / org-owned / generator + prompt)." }, "bpm": { "description": "Tempo — present for music-role entries.", "type": "number" }, "mood": { "description": "Editorial mood tags — present for pack music beds.", "type": "array", "items": { "type": "string" } } }, "required": [ "ref", "role", "envelopeClass", "description", "durationSec", "evidence", "source", "license", "provenance" ], "additionalProperties": false }, "ComponentManifest": { "anyOf": [ { "$ref": "#/$defs/ComponentManifestV4" }, { "$ref": "#/$defs/ComponentManifestV2" } ] }, "ComponentManifestV2": { "type": "object", "properties": { "version": { "type": "number", "const": 2 }, "assets": { "type": "object", "propertyNames": { "type": "string", "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "image", "video", "audio", "data", "visual" ] }, "required": { "type": "boolean" }, "mimeTypes": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mediaDemand": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "original" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "tier" }, "tier": { "anyOf": [ { "type": "number", "const": 256 }, { "type": "number", "const": 512 }, { "type": "number", "const": 1024 }, { "type": "number", "const": 2048 } ] } }, "required": [ "mode", "tier" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "auto" }, "maxProjectedWidthRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "maxProjectedHeightRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "minVisibleSourceWidthRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 }, "minVisibleSourceHeightRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 } }, "required": [ "mode", "maxProjectedWidthRatio", "maxProjectedHeightRatio", "minVisibleSourceWidthRatio", "minVisibleSourceHeightRatio" ], "additionalProperties": false } ], "type": "object" } }, "required": [ "kind", "required" ], "additionalProperties": false } }, "graphics": { "type": "object", "properties": { "api": { "type": "string", "enum": [ "canvas2d", "webgl", "webgl2", "webgpu" ] }, "required": { "type": "boolean", "const": true }, "accelerationPreference": { "type": "string", "enum": [ "hardware-preferred", "software-allowed" ] } }, "required": [ "api", "required", "accelerationPreference" ], "additionalProperties": false }, "alphaPolicy": { "type": "string", "enum": [ "requires-transparency", "allows-opaque" ] }, "sceneShot": { "type": "object", "properties": { "version": { "type": "number", "const": 2 } }, "required": [ "version" ], "additionalProperties": false }, "visualMedia": { "type": "object", "properties": { "version": { "type": "number", "const": 1 } }, "required": [ "version" ], "additionalProperties": false } }, "required": [ "version", "assets", "graphics", "alphaPolicy" ], "additionalProperties": false }, "ComponentManifestV4": { "type": "object", "properties": { "version": { "type": "number", "const": 4 }, "runtime": { "type": "string", "const": "hyperframes" }, "hfContract": { "type": "number", "const": 1 }, "kind": { "type": "string", "const": "scene" }, "sceneShot": { "type": "object", "properties": { "version": { "type": "number", "const": 2 } }, "required": [ "version" ], "additionalProperties": false }, "assets": { "type": "object", "propertyNames": { "type": "string", "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "image", "video", "audio", "data", "visual" ] }, "required": { "type": "boolean" }, "mimeTypes": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mediaDemand": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "original" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "tier" }, "tier": { "anyOf": [ { "type": "number", "const": 256 }, { "type": "number", "const": 512 }, { "type": "number", "const": 1024 }, { "type": "number", "const": 2048 } ] } }, "required": [ "mode", "tier" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "auto" }, "maxProjectedWidthRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "maxProjectedHeightRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "minVisibleSourceWidthRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 }, "minVisibleSourceHeightRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 } }, "required": [ "mode", "maxProjectedWidthRatio", "maxProjectedHeightRatio", "minVisibleSourceWidthRatio", "minVisibleSourceHeightRatio" ], "additionalProperties": false } ], "type": "object" } }, "required": [ "kind", "required" ], "additionalProperties": false } }, "graphics": { "type": "object", "properties": { "api": { "type": "string", "enum": [ "canvas2d", "webgl", "webgl2", "webgpu" ] }, "required": { "type": "boolean", "const": true }, "accelerationPreference": { "type": "string", "enum": [ "hardware-preferred", "software-allowed" ] } }, "required": [ "api", "required", "accelerationPreference" ], "additionalProperties": false }, "alphaPolicy": { "type": "string", "enum": [ "requires-transparency", "allows-opaque" ] } }, "required": [ "version", "runtime", "hfContract", "kind", "assets", "graphics", "alphaPolicy" ], "additionalProperties": false }, "ComponentPlacement": { "type": "object", "properties": { "clipSourceKind": { "type": "string", "enum": [ "overlay", "effect", "component" ], "description": "The ClipSource `kind` to author this entry as: 'overlay' (built-in text/ui/scene/background/layout), 'effect' (built-in effect/transition), or 'component' (an org-INSTALLED custom component)." }, "refField": { "type": "string", "enum": [ "primitiveId", "componentId" ], "description": "Which id field keys the ClipSource: 'primitiveId' for built-ins (source:'default'), 'componentId' for installed components (source:'installed'). Using the wrong field will NOT resolve at render." } }, "required": [ "clipSourceKind", "refField" ], "additionalProperties": false }, "ComponentResponse": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": { "type": "string", "maxLength": 2000 }, "category": { "type": "string", "enum": [ "text", "effects", "transitions", "layouts", "backgrounds", "ui-blocks", "scenes" ] }, "propSchema": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "origin": { "type": "string", "enum": [ "customer-owned", "server-native" ] }, "ejectedFrom": { "type": "string", "maxLength": 200 }, "tokens": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "durationInFrames": { "type": "number", "exclusiveMinimum": 0 }, "manifest": { "description": "The stored runtime manifest (assets, graphics API, alpha policy) of an org-INSTALLED component: the same object its source snapshot carries, so a manifest read back here can be written back unchanged. Built-in defaults have no stored manifest and omit it. Its `version` is the runtime contract version (4 native, 2 retired TSX), unlike the entry's semver `version`.", "$ref": "#/$defs/ComponentManifest" }, "id": { "type": "string", "description": "The entry's id: a `primitiveId` for a built-in, a `componentId` for an installed component." }, "source": { "type": "string", "enum": [ "default", "installed" ], "description": "'default' = built-in primitive (place by primitiveId); 'installed' = org-authored component (place by componentId)." }, "kind": { "type": "string", "enum": [ "component", "transition", "scene" ], "description": "RENDER kind (component | transition | scene). NOT the ClipSource variant — see `placement` for how to author it on the timeline." }, "version": { "type": "string", "description": "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)." }, "propDefaults": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "textParam": { "description": "The param field that carries this primitive's primary text; null = no single text slot.", "type": [ "string", "null" ] }, "subtextParam": { "description": "The param field for secondary text (subtitle/byline); null = none.", "type": [ "string", "null" ] }, "format": { "$ref": "#/$defs/Format" }, "intent": { "description": "Selection signal: a verb naming what this primitive accomplishes (e.g. 'product-trailer'). Match it to the beat you are authoring.", "type": "string" }, "useWhen": { "description": "When to use this — AND when not to. The negative guidance is load-bearing; read it before picking.", "type": "string" }, "pairsWith": { "description": "Authoring guidance: ids of primitives that COMPOSE well with this one in the same edit.", "type": "array", "items": { "type": "string" } }, "avoidWith": { "description": "Authoring guidance: ids of primitives that CONFLICT with this one — do not place together.", "type": "array", "items": { "type": "string" } }, "tags": { "description": "Free-text search keywords.", "type": "array", "items": { "type": "string" } }, "mood": { "description": "Vibe/tone tags (e.g. 'cinematic', 'minimal'). Filter to match the edit's mood.", "type": "array", "items": { "type": "string" } }, "tier": { "description": "Quality/applicability RANKING (a preference, not a flag). Prefer 'recommended'; reach for 'niche' only when its specific use-case is exactly the beat.", "type": "string", "enum": [ "recommended", "standard", "niche" ] }, "useCase": { "description": "The edit ROLE(s) this primitive fills — the dimension to filter by for a beat (e.g. 'intro', 'title-over-footage', 'grade').", "type": "array", "items": { "type": "string", "enum": [ "intro", "outro", "full-scene", "title-over-footage", "transition", "background", "grade", "emphasis", "explainer", "social-cut" ] } }, "fixedCopy": { "description": "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.", "type": "array", "items": { "type": "string" } }, "brandBindings": { "description": "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.", "type": "array", "items": { "type": "object", "properties": { "param": { "type": "string" }, "brandToken": { "type": "string" } }, "required": [ "param", "brandToken" ], "additionalProperties": false } }, "placement": { "description": "How to author this entry as a ClipSource via apply_composition: the exact ClipSource `kind` + the id field to key it by. Built-ins place as {kind:'overlay'|'effect', primitiveId}; installed components place as {kind:'component', componentId}. A kind:'scene' primitive has no 'scene' ClipSource — it is placed as {kind:'overlay', primitiveId}.", "$ref": "#/$defs/ComponentPlacement" }, "warnings": { "description": "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.", "type": "array", "items": { "type": "string" } } }, "required": [ "name", "description", "category", "propSchema", "id", "source", "kind", "version", "placement" ], "additionalProperties": false, "description": "Component catalog entry per §Components." }, "Format": { "type": "object", "properties": { "aspectRatio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:5" ] }, "fps": { "anyOf": [ { "type": "number", "const": 24 }, { "type": "number", "const": 25 }, { "type": "number", "const": 30 }, { "type": "number", "const": 60 } ] }, "resolution": { "type": "string", "enum": [ "hd", "fhd", "4k" ] }, "platform": { "type": "string" } }, "required": [ "aspectRatio" ] }, "LegacyComponentListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/$defs/ComponentResponse" } }, "pagination": { "$ref": "#/$defs/PaginationMeta" }, "brandTokens": { "description": "Catalog-level reference: the valid `$brand:` token refs a param value may carry (e.g. accentColor: \"$brand:colors.accent\"). Colors + fonts are the common bindings; the full design-token vocabulary is listed. Derived from the brand kit resolver so it can't drift. See each entry's `brandBindings` for which params are brand-bound by default.", "type": "array", "items": { "type": "string" } }, "sfx": { "description": "Catalog-level reference: the curated CC0 SFX pack (closed, versioned). The compose sfx pass places these deterministically; this is the pack-only structural inventory to pick a `soundId` by family. Present on the first page only.", "type": "array", "items": { "$ref": "#/$defs/SfxCatalogEntry" } }, "audio": { "description": "The UNIFIED org sound palette (audio-substrate Phase 2): the curated packs (SFX + music beds) unioned with THIS org's own uploads/imports (source:\"org\") and generated audio (source:\"generated\"), one uniform entry shape carrying role + envelopeClass + provenance + license; music entries carry bpm. Prefer an org sound when it fits — an org that uploads its product's real UI sounds hears ITS product. Present on the first page only.", "type": "array", "items": { "$ref": "#/$defs/AudioPaletteEntry" } } }, "required": [ "data", "pagination" ], "additionalProperties": false }, "PaginationMeta": { "type": "object", "properties": { "hasMore": { "type": "boolean" }, "nextCursor": { "type": [ "string", "null" ] }, "prevCursor": { "type": [ "string", "null" ] } }, "required": [ "hasMore", "nextCursor", "prevCursor" ], "additionalProperties": false, "description": "Cursor pagination metadata." }, "SfxCatalogEntry": { "type": "object", "properties": { "soundId": { "type": "string", "description": "Stable sound-pack item id." }, "family": { "type": "string", "enum": [ "tick", "pop", "impact", "confirm", "error", "whoosh", "riser" ], "description": "Editorial family the compose sfx pass binds by." }, "envelopeClass": { "type": "string", "enum": [ "transient", "sweep", "ambient" ], "description": "Coarse envelope shape — the browse grouping." }, "intensity": { "type": "string", "enum": [ "subtle", "standard", "strong" ] }, "durationSec": { "type": "number", "description": "Duration of the mastered asset (seconds)." }, "description": { "type": "string", "description": "One-line human-legible caption." }, "attribution": { "type": "string", "description": "CC0 provenance string." } }, "required": [ "soundId", "family", "envelopeClass", "intensity", "durationSec", "description", "attribution" ], "additionalProperties": false } } }