@cueframe/kernel 0.2.52 → 0.2.54

package/dist/{chunk-2M65KQNG.js → chunk-V6GL37RZ.js}

@@ -1436,7 +1436,7 @@ var BriefCreateRequest = zod19.strictObject({
       "h": zod19.number().gt(briefCreateRequestSeededGraphicsItemRegionHExclusiveMin).max(briefCreateRequestSeededGraphicsItemRegionHMax)
     }).optional(),
     "fit": zod19.enum(["cover", "contain"]).optional(),
-    "captionVisibility": zod19.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
+    "captionVisibility": zod19.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is topmost and covers the lower picture, or when an opaque, effect-free clip has an explicitly full-frame region, even with fit:contain. Caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod19.array(zod19.strictObject({
       "primitiveId": zod19.string().min(1),
       "params": zod19.record(zod19.string(), zod19.unknown()).optional()
@@ -1698,7 +1698,7 @@ var BriefResponse = zod21.strictObject({
       "h": zod21.number().gt(briefResponseSeededGraphicsItemRegionHExclusiveMin).max(briefResponseSeededGraphicsItemRegionHMax)
     }).optional(),
     "fit": zod21.enum(["cover", "contain"]).optional(),
-    "captionVisibility": zod21.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
+    "captionVisibility": zod21.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is topmost and covers the lower picture, or when an opaque, effect-free clip has an explicitly full-frame region, even with fit:contain. Caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod21.array(zod21.strictObject({
       "primitiveId": zod21.string().min(1),
       "params": zod21.record(zod21.string(), zod21.unknown()).optional()
@@ -1949,7 +1949,7 @@ var BriefPatchRequest = zod23.strictObject({
       "h": zod23.number().gt(briefPatchRequestSeededGraphicsItemRegionHExclusiveMin).max(briefPatchRequestSeededGraphicsItemRegionHMax)
     }).optional(),
     "fit": zod23.enum(["cover", "contain"]).optional(),
-    "captionVisibility": zod23.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
+    "captionVisibility": zod23.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is topmost and covers the lower picture, or when an opaque, effect-free clip has an explicitly full-frame region, even with fit:contain. Caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod23.array(zod23.strictObject({
       "primitiveId": zod23.string().min(1),
       "params": zod23.record(zod23.string(), zod23.unknown()).optional()
@@ -2595,6 +2595,12 @@ var compositionCaptionsOneStyleRegionWExclusiveMin = 0;
 var compositionCaptionsOneStyleRegionWMax = 1;
 var compositionCaptionsOneStyleRegionHExclusiveMin = 0;
 var compositionCaptionsOneStyleRegionHMax = 1;
+var compositionCaptionsOneStyleLetterSpacingMin = -5;
+var compositionCaptionsOneStyleLetterSpacingMax = 20;
+var compositionCaptionsOneStyleWordGapEmMin = 0;
+var compositionCaptionsOneStyleWordGapEmMax = 2;
+var compositionCaptionsOneStyleLineGapEmMin = 0;
+var compositionCaptionsOneStyleLineGapEmMax = 2;
 var compositionCaptionsOneStyleEmphasisScaleExclusiveMin = 0;
 var compositionCaptionsOneStyleEmphasisFontWeightMin = 100;
 var compositionCaptionsOneStyleEmphasisFontWeightMax = 900;
@@ -2602,8 +2608,51 @@ var compositionCaptionsOneStyleEntranceMsMin = 0;
 var compositionCaptionsOneStyleEntranceStaggerMsMin = 0;
 var compositionCaptionsOneStyleExitMsMin = 0;
 var compositionCaptionsOneStyleEmphasisPlateRadiusMin = 0;
+var compositionCaptionsOneStyleAnnotationStrokeWidthMin = 0.5;
+var compositionCaptionsOneStyleAnnotationStrokeWidthMax = 12;
 var compositionCaptionsOneStyleMaxWidthPercentExclusiveMin = 0;
 var compositionCaptionsOneStyleMaxWidthPercentMax = 100;
+var compositionCaptionsOneLayoutsItemSegmentIndexMin = 0;
+var compositionCaptionsOneLayoutsItemSegmentIndexMax = 9007199254740991;
+var compositionCaptionsOneLayoutsItemWordStartIndexMin = 0;
+var compositionCaptionsOneLayoutsItemWordStartIndexMax = 9007199254740991;
+var compositionCaptionsOneLayoutsItemWordEndIndexExclusiveMin = 0;
+var compositionCaptionsOneLayoutsItemWordEndIndexMax = 9007199254740991;
+var compositionCaptionsOneLayoutsItemRegionXMin = 0;
+var compositionCaptionsOneLayoutsItemRegionXMax = 1;
+var compositionCaptionsOneLayoutsItemRegionYMin = 0;
+var compositionCaptionsOneLayoutsItemRegionYMax = 1;
+var compositionCaptionsOneLayoutsItemRegionWExclusiveMin = 0;
+var compositionCaptionsOneLayoutsItemRegionWMax = 1;
+var compositionCaptionsOneLayoutsItemRegionHExclusiveMin = 0;
+var compositionCaptionsOneLayoutsItemRegionHMax = 1;
+var compositionCaptionsOneLayoutsItemScaleMin = 0.25;
+var compositionCaptionsOneLayoutsItemScaleMax = 4;
+var compositionCaptionsOneLayoutsItemRotationMin = -45;
+var compositionCaptionsOneLayoutsItemRotationMax = 45;
+var compositionCaptionsOneLayoutsItemStyleFontSizeMax = 15;
+var compositionCaptionsOneLayoutsItemStyleFontWeightMin = 100;
+var compositionCaptionsOneLayoutsItemStyleFontWeightMax = 900;
+var compositionCaptionsOneLayoutsItemStyleLetterSpacingMin = -5;
+var compositionCaptionsOneLayoutsItemStyleLetterSpacingMax = 20;
+var compositionCaptionsOneLayoutsItemStyleWordGapEmMin = 0;
+var compositionCaptionsOneLayoutsItemStyleWordGapEmMax = 2;
+var compositionCaptionsOneLayoutsItemStyleLineGapEmMin = 0;
+var compositionCaptionsOneLayoutsItemStyleLineGapEmMax = 2;
+var compositionCaptionsOneLayoutsItemStyleEmphasisScaleExclusiveMin = 0;
+var compositionCaptionsOneLayoutsItemStyleEmphasisFontWeightMin = 100;
+var compositionCaptionsOneLayoutsItemStyleEmphasisFontWeightMax = 900;
+var compositionCaptionsOneLayoutsItemStyleEmphasisPlateRadiusMin = 0;
+var compositionCaptionsOneLayoutsItemStyleAnnotationStrokeWidthMin = 0.5;
+var compositionCaptionsOneLayoutsItemStyleAnnotationStrokeWidthMax = 12;
+var compositionCaptionsOneLayoutsItemStyleEntranceMsMin = 0;
+var compositionCaptionsOneLayoutsItemStyleEntranceStaggerMsMin = 0;
+var compositionCaptionsOneLayoutsItemStyleExitMsMin = 0;
+var compositionCaptionsOneLayoutsItemHoldThroughWordIndexMin = 0;
+var compositionCaptionsOneLayoutsItemHoldThroughWordIndexMax = 9007199254740991;
+var compositionCaptionsOneLayoutsItemWordMarksItemWordIndexMin = 0;
+var compositionCaptionsOneLayoutsItemWordMarksItemWordIndexMax = 9007199254740991;
+var compositionCaptionsOneLayoutsItemWordSignatureRegExp = new RegExp("^[a-f0-9]{64}$");
 var compositionCaptionsTwoSegmentsItemWordsItemStartMsMin = 0;
 var compositionCaptionsTwoSegmentsItemWordsItemEndMsMin = 0;
 var compositionCaptionsTwoStyleFontSizeMax = 15;
@@ -2617,6 +2666,12 @@ var compositionCaptionsTwoStyleRegionWExclusiveMin = 0;
 var compositionCaptionsTwoStyleRegionWMax = 1;
 var compositionCaptionsTwoStyleRegionHExclusiveMin = 0;
 var compositionCaptionsTwoStyleRegionHMax = 1;
+var compositionCaptionsTwoStyleLetterSpacingMin = -5;
+var compositionCaptionsTwoStyleLetterSpacingMax = 20;
+var compositionCaptionsTwoStyleWordGapEmMin = 0;
+var compositionCaptionsTwoStyleWordGapEmMax = 2;
+var compositionCaptionsTwoStyleLineGapEmMin = 0;
+var compositionCaptionsTwoStyleLineGapEmMax = 2;
 var compositionCaptionsTwoStyleEmphasisScaleExclusiveMin = 0;
 var compositionCaptionsTwoStyleEmphasisFontWeightMin = 100;
 var compositionCaptionsTwoStyleEmphasisFontWeightMax = 900;
@@ -2624,8 +2679,51 @@ var compositionCaptionsTwoStyleEntranceMsMin = 0;
 var compositionCaptionsTwoStyleEntranceStaggerMsMin = 0;
 var compositionCaptionsTwoStyleExitMsMin = 0;
 var compositionCaptionsTwoStyleEmphasisPlateRadiusMin = 0;
+var compositionCaptionsTwoStyleAnnotationStrokeWidthMin = 0.5;
+var compositionCaptionsTwoStyleAnnotationStrokeWidthMax = 12;
 var compositionCaptionsTwoStyleMaxWidthPercentExclusiveMin = 0;
 var compositionCaptionsTwoStyleMaxWidthPercentMax = 100;
+var compositionCaptionsTwoLayoutsItemSegmentIndexMin = 0;
+var compositionCaptionsTwoLayoutsItemSegmentIndexMax = 9007199254740991;
+var compositionCaptionsTwoLayoutsItemWordStartIndexMin = 0;
+var compositionCaptionsTwoLayoutsItemWordStartIndexMax = 9007199254740991;
+var compositionCaptionsTwoLayoutsItemWordEndIndexExclusiveMin = 0;
+var compositionCaptionsTwoLayoutsItemWordEndIndexMax = 9007199254740991;
+var compositionCaptionsTwoLayoutsItemRegionXMin = 0;
+var compositionCaptionsTwoLayoutsItemRegionXMax = 1;
+var compositionCaptionsTwoLayoutsItemRegionYMin = 0;
+var compositionCaptionsTwoLayoutsItemRegionYMax = 1;
+var compositionCaptionsTwoLayoutsItemRegionWExclusiveMin = 0;
+var compositionCaptionsTwoLayoutsItemRegionWMax = 1;
+var compositionCaptionsTwoLayoutsItemRegionHExclusiveMin = 0;
+var compositionCaptionsTwoLayoutsItemRegionHMax = 1;
+var compositionCaptionsTwoLayoutsItemScaleMin = 0.25;
+var compositionCaptionsTwoLayoutsItemScaleMax = 4;
+var compositionCaptionsTwoLayoutsItemRotationMin = -45;
+var compositionCaptionsTwoLayoutsItemRotationMax = 45;
+var compositionCaptionsTwoLayoutsItemStyleFontSizeMax = 15;
+var compositionCaptionsTwoLayoutsItemStyleFontWeightMin = 100;
+var compositionCaptionsTwoLayoutsItemStyleFontWeightMax = 900;
+var compositionCaptionsTwoLayoutsItemStyleLetterSpacingMin = -5;
+var compositionCaptionsTwoLayoutsItemStyleLetterSpacingMax = 20;
+var compositionCaptionsTwoLayoutsItemStyleWordGapEmMin = 0;
+var compositionCaptionsTwoLayoutsItemStyleWordGapEmMax = 2;
+var compositionCaptionsTwoLayoutsItemStyleLineGapEmMin = 0;
+var compositionCaptionsTwoLayoutsItemStyleLineGapEmMax = 2;
+var compositionCaptionsTwoLayoutsItemStyleEmphasisScaleExclusiveMin = 0;
+var compositionCaptionsTwoLayoutsItemStyleEmphasisFontWeightMin = 100;
+var compositionCaptionsTwoLayoutsItemStyleEmphasisFontWeightMax = 900;
+var compositionCaptionsTwoLayoutsItemStyleEmphasisPlateRadiusMin = 0;
+var compositionCaptionsTwoLayoutsItemStyleAnnotationStrokeWidthMin = 0.5;
+var compositionCaptionsTwoLayoutsItemStyleAnnotationStrokeWidthMax = 12;
+var compositionCaptionsTwoLayoutsItemStyleEntranceMsMin = 0;
+var compositionCaptionsTwoLayoutsItemStyleEntranceStaggerMsMin = 0;
+var compositionCaptionsTwoLayoutsItemStyleExitMsMin = 0;
+var compositionCaptionsTwoLayoutsItemHoldThroughWordIndexMin = 0;
+var compositionCaptionsTwoLayoutsItemHoldThroughWordIndexMax = 9007199254740991;
+var compositionCaptionsTwoLayoutsItemWordMarksItemWordIndexMin = 0;
+var compositionCaptionsTwoLayoutsItemWordMarksItemWordIndexMax = 9007199254740991;
+var compositionCaptionsTwoLayoutsItemWordSignatureRegExp = new RegExp("^[a-f0-9]{64}$");
 var Composition = zod58.strictObject({
   "v": zod58.literal(1),
   "format": zod58.strictObject({
@@ -2758,7 +2856,7 @@ var Composition = zod58.strictObject({
         "h": zod58.number().gt(compositionTracksItemContentsItemOneRegionHExclusiveMin).max(compositionTracksItemContentsItemOneRegionHMax)
       }).optional(),
       "fit": zod58.enum(["cover", "contain"]).optional(),
-      "captionVisibility": zod58.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
+      "captionVisibility": zod58.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is topmost and covers the lower picture, or when an opaque, effect-free clip has an explicitly full-frame region, even with fit:contain. Caption words and timings remain stored and resume when another visible clip takes over."),
       "effects": zod58.array(zod58.strictObject({
         "primitiveId": zod58.string().min(1),
         "params": zod58.record(zod58.string(), zod58.unknown()).optional()
@@ -2824,6 +2922,9 @@ var Composition = zod58.strictObject({
         "h": zod58.number().gt(compositionCaptionsOneStyleRegionHExclusiveMin).max(compositionCaptionsOneStyleRegionHMax)
       }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
       "textTransform": zod58.enum(["none", "uppercase", "capitalize"]).optional(),
+      "letterSpacing": zod58.number().min(compositionCaptionsOneStyleLetterSpacingMin).max(compositionCaptionsOneStyleLetterSpacingMax).optional().describe("Base caption glyph spacing in pixels."),
+      "wordGapEm": zod58.number().min(compositionCaptionsOneStyleWordGapEmMin).max(compositionCaptionsOneStyleWordGapEmMax).optional().describe("Gap between caption runs as a multiple of base font size; default 0.35."),
+      "lineGapEm": zod58.number().min(compositionCaptionsOneStyleLineGapEmMin).max(compositionCaptionsOneStyleLineGapEmMax).optional().describe("Gap between caption lines as a multiple of base font size; default 0.25."),
       "emphasisColor": zod58.string().optional(),
       "emphasisGradient": zod58.string().optional(),
       "emphasisScale": zod58.number().gt(compositionCaptionsOneStyleEmphasisScaleExclusiveMin).optional(),
@@ -2844,9 +2945,66 @@ var Composition = zod58.strictObject({
       "emphasisPlateRadius": zod58.number().min(compositionCaptionsOneStyleEmphasisPlateRadiusMin).optional(),
       "emphasisPlatePadX": zod58.number().optional(),
       "emphasisPlatePadY": zod58.number().optional(),
+      "emphasisPlateReveal": zod58.boolean().optional().describe("Grow a shared emphasis plate as saved words appear while reserving its final layout width."),
       "annotationColor": zod58.string().optional(),
+      "annotationStrokeWidth": zod58.number().min(compositionCaptionsOneStyleAnnotationStrokeWidthMin).max(compositionCaptionsOneStyleAnnotationStrokeWidthMax).optional().describe("Annotation stroke width in its 100\xD7100 SVG coordinate system; default 4."),
       "maxWidthPercent": zod58.number().gt(compositionCaptionsOneStyleMaxWidthPercentExclusiveMin).max(compositionCaptionsOneStyleMaxWidthPercentMax).optional()
     }).optional(),
+    "layouts": zod58.array(zod58.strictObject({
+      "segmentIndex": zod58.int().min(compositionCaptionsOneLayoutsItemSegmentIndexMin).max(compositionCaptionsOneLayoutsItemSegmentIndexMax),
+      "wordStartIndex": zod58.int().min(compositionCaptionsOneLayoutsItemWordStartIndexMin).max(compositionCaptionsOneLayoutsItemWordStartIndexMax),
+      "wordEndIndex": zod58.int().gt(compositionCaptionsOneLayoutsItemWordEndIndexExclusiveMin).max(compositionCaptionsOneLayoutsItemWordEndIndexMax).describe("Exclusive word index in the saved caption segment."),
+      "region": zod58.strictObject({
+        "x": zod58.number().min(compositionCaptionsOneLayoutsItemRegionXMin).max(compositionCaptionsOneLayoutsItemRegionXMax),
+        "y": zod58.number().min(compositionCaptionsOneLayoutsItemRegionYMin).max(compositionCaptionsOneLayoutsItemRegionYMax),
+        "w": zod58.number().gt(compositionCaptionsOneLayoutsItemRegionWExclusiveMin).max(compositionCaptionsOneLayoutsItemRegionWMax),
+        "h": zod58.number().gt(compositionCaptionsOneLayoutsItemRegionHExclusiveMin).max(compositionCaptionsOneLayoutsItemRegionHMax)
+      }),
+      "scale": zod58.number().min(compositionCaptionsOneLayoutsItemScaleMin).max(compositionCaptionsOneLayoutsItemScaleMax).optional(),
+      "rotation": zod58.number().min(compositionCaptionsOneLayoutsItemRotationMin).max(compositionCaptionsOneLayoutsItemRotationMax).optional(),
+      "style": zod58.strictObject({
+        "fontFamily": zod58.string().min(1).optional(),
+        "fontSize": zod58.number().min(1).max(compositionCaptionsOneLayoutsItemStyleFontSizeMax).optional().describe("Font size as % of composition height (1-15, default 5). NOT px."),
+        "fontWeight": zod58.int().min(compositionCaptionsOneLayoutsItemStyleFontWeightMin).max(compositionCaptionsOneLayoutsItemStyleFontWeightMax).optional(),
+        "color": zod58.string().min(1).optional(),
+        "highlightColor": zod58.string().min(1).optional(),
+        "backgroundColor": zod58.string().optional(),
+        "plate": zod58.enum(["glass", "solid", "none"]).optional(),
+        "textTransform": zod58.enum(["none", "uppercase", "capitalize"]).optional(),
+        "letterSpacing": zod58.number().min(compositionCaptionsOneLayoutsItemStyleLetterSpacingMin).max(compositionCaptionsOneLayoutsItemStyleLetterSpacingMax).optional().describe("Base caption glyph spacing in pixels."),
+        "wordGapEm": zod58.number().min(compositionCaptionsOneLayoutsItemStyleWordGapEmMin).max(compositionCaptionsOneLayoutsItemStyleWordGapEmMax).optional().describe("Gap between caption runs as a multiple of base font size; default 0.35."),
+        "lineGapEm": zod58.number().min(compositionCaptionsOneLayoutsItemStyleLineGapEmMin).max(compositionCaptionsOneLayoutsItemStyleLineGapEmMax).optional().describe("Gap between caption lines as a multiple of base font size; default 0.25."),
+        "emphasisColor": zod58.string().optional(),
+        "emphasisScale": zod58.number().gt(compositionCaptionsOneLayoutsItemStyleEmphasisScaleExclusiveMin).optional(),
+        "emphasisFontFamily": zod58.string().optional(),
+        "emphasisFontWeight": zod58.int().min(compositionCaptionsOneLayoutsItemStyleEmphasisFontWeightMin).max(compositionCaptionsOneLayoutsItemStyleEmphasisFontWeightMax).optional(),
+        "emphasisTextTransform": zod58.enum(["none", "uppercase", "capitalize"]).optional(),
+        "emphasisLetterSpacing": zod58.number().optional(),
+        "emphasisFontStyle": zod58.enum(["normal", "italic"]).optional(),
+        "emphasisPlate": zod58.boolean().optional(),
+        "emphasisPlateColor": zod58.string().optional(),
+        "emphasisPlateTextColor": zod58.string().optional(),
+        "emphasisPlateAltColor": zod58.string().optional(),
+        "emphasisPlateAltTextColor": zod58.string().optional(),
+        "emphasisPlateRadius": zod58.number().min(compositionCaptionsOneLayoutsItemStyleEmphasisPlateRadiusMin).optional(),
+        "emphasisPlatePadX": zod58.number().optional(),
+        "emphasisPlatePadY": zod58.number().optional(),
+        "emphasisPlateReveal": zod58.boolean().optional().describe("Grow a shared emphasis plate as saved words appear while reserving its final layout width."),
+        "annotationColor": zod58.string().optional(),
+        "annotationStrokeWidth": zod58.number().min(compositionCaptionsOneLayoutsItemStyleAnnotationStrokeWidthMin).max(compositionCaptionsOneLayoutsItemStyleAnnotationStrokeWidthMax).optional().describe("Annotation stroke width in its 100\xD7100 SVG coordinate system; default 4."),
+        "entrance": zod58.enum(["none", "fade", "word-pop", "stagger-up"]).optional(),
+        "entranceMs": zod58.number().min(compositionCaptionsOneLayoutsItemStyleEntranceMsMin).optional(),
+        "entranceStaggerMs": zod58.number().min(compositionCaptionsOneLayoutsItemStyleEntranceStaggerMsMin).optional(),
+        "exitMs": zod58.number().min(compositionCaptionsOneLayoutsItemStyleExitMsMin).optional()
+      }).optional(),
+      "holdThroughWordIndex": zod58.int().min(compositionCaptionsOneLayoutsItemHoldThroughWordIndexMin).max(compositionCaptionsOneLayoutsItemHoldThroughWordIndexMax).optional().describe("Inclusive saved-word index in this segment. The layout stays visible until that word ends."),
+      "wordMarks": zod58.array(zod58.strictObject({
+        "wordIndex": zod58.int().min(compositionCaptionsOneLayoutsItemWordMarksItemWordIndexMin).max(compositionCaptionsOneLayoutsItemWordMarksItemWordIndexMax),
+        "emphasis": zod58.boolean().optional(),
+        "annotate": zod58.union([zod58.enum(["circle", "underline"]), zod58.null()]).optional()
+      })).optional(),
+      "wordSignature": zod58.string().regex(compositionCaptionsOneLayoutsItemWordSignatureRegExp)
+    })).optional(),
     "zPlane": zod58.enum(["front", "behind-subject"]).optional()
   }), zod58.strictObject({
     "source": zod58.literal("authored"),
@@ -2875,6 +3033,9 @@ var Composition = zod58.strictObject({
         "h": zod58.number().gt(compositionCaptionsTwoStyleRegionHExclusiveMin).max(compositionCaptionsTwoStyleRegionHMax)
       }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
       "textTransform": zod58.enum(["none", "uppercase", "capitalize"]).optional(),
+      "letterSpacing": zod58.number().min(compositionCaptionsTwoStyleLetterSpacingMin).max(compositionCaptionsTwoStyleLetterSpacingMax).optional().describe("Base caption glyph spacing in pixels."),
+      "wordGapEm": zod58.number().min(compositionCaptionsTwoStyleWordGapEmMin).max(compositionCaptionsTwoStyleWordGapEmMax).optional().describe("Gap between caption runs as a multiple of base font size; default 0.35."),
+      "lineGapEm": zod58.number().min(compositionCaptionsTwoStyleLineGapEmMin).max(compositionCaptionsTwoStyleLineGapEmMax).optional().describe("Gap between caption lines as a multiple of base font size; default 0.25."),
       "emphasisColor": zod58.string().optional(),
       "emphasisGradient": zod58.string().optional(),
       "emphasisScale": zod58.number().gt(compositionCaptionsTwoStyleEmphasisScaleExclusiveMin).optional(),
@@ -2895,9 +3056,66 @@ var Composition = zod58.strictObject({
       "emphasisPlateRadius": zod58.number().min(compositionCaptionsTwoStyleEmphasisPlateRadiusMin).optional(),
       "emphasisPlatePadX": zod58.number().optional(),
       "emphasisPlatePadY": zod58.number().optional(),
+      "emphasisPlateReveal": zod58.boolean().optional().describe("Grow a shared emphasis plate as saved words appear while reserving its final layout width."),
       "annotationColor": zod58.string().optional(),
+      "annotationStrokeWidth": zod58.number().min(compositionCaptionsTwoStyleAnnotationStrokeWidthMin).max(compositionCaptionsTwoStyleAnnotationStrokeWidthMax).optional().describe("Annotation stroke width in its 100\xD7100 SVG coordinate system; default 4."),
       "maxWidthPercent": zod58.number().gt(compositionCaptionsTwoStyleMaxWidthPercentExclusiveMin).max(compositionCaptionsTwoStyleMaxWidthPercentMax).optional()
     }).optional(),
+    "layouts": zod58.array(zod58.strictObject({
+      "segmentIndex": zod58.int().min(compositionCaptionsTwoLayoutsItemSegmentIndexMin).max(compositionCaptionsTwoLayoutsItemSegmentIndexMax),
+      "wordStartIndex": zod58.int().min(compositionCaptionsTwoLayoutsItemWordStartIndexMin).max(compositionCaptionsTwoLayoutsItemWordStartIndexMax),
+      "wordEndIndex": zod58.int().gt(compositionCaptionsTwoLayoutsItemWordEndIndexExclusiveMin).max(compositionCaptionsTwoLayoutsItemWordEndIndexMax).describe("Exclusive word index in the saved caption segment."),
+      "region": zod58.strictObject({
+        "x": zod58.number().min(compositionCaptionsTwoLayoutsItemRegionXMin).max(compositionCaptionsTwoLayoutsItemRegionXMax),
+        "y": zod58.number().min(compositionCaptionsTwoLayoutsItemRegionYMin).max(compositionCaptionsTwoLayoutsItemRegionYMax),
+        "w": zod58.number().gt(compositionCaptionsTwoLayoutsItemRegionWExclusiveMin).max(compositionCaptionsTwoLayoutsItemRegionWMax),
+        "h": zod58.number().gt(compositionCaptionsTwoLayoutsItemRegionHExclusiveMin).max(compositionCaptionsTwoLayoutsItemRegionHMax)
+      }),
+      "scale": zod58.number().min(compositionCaptionsTwoLayoutsItemScaleMin).max(compositionCaptionsTwoLayoutsItemScaleMax).optional(),
+      "rotation": zod58.number().min(compositionCaptionsTwoLayoutsItemRotationMin).max(compositionCaptionsTwoLayoutsItemRotationMax).optional(),
+      "style": zod58.strictObject({
+        "fontFamily": zod58.string().min(1).optional(),
+        "fontSize": zod58.number().min(1).max(compositionCaptionsTwoLayoutsItemStyleFontSizeMax).optional().describe("Font size as % of composition height (1-15, default 5). NOT px."),
+        "fontWeight": zod58.int().min(compositionCaptionsTwoLayoutsItemStyleFontWeightMin).max(compositionCaptionsTwoLayoutsItemStyleFontWeightMax).optional(),
+        "color": zod58.string().min(1).optional(),
+        "highlightColor": zod58.string().min(1).optional(),
+        "backgroundColor": zod58.string().optional(),
+        "plate": zod58.enum(["glass", "solid", "none"]).optional(),
+        "textTransform": zod58.enum(["none", "uppercase", "capitalize"]).optional(),
+        "letterSpacing": zod58.number().min(compositionCaptionsTwoLayoutsItemStyleLetterSpacingMin).max(compositionCaptionsTwoLayoutsItemStyleLetterSpacingMax).optional().describe("Base caption glyph spacing in pixels."),
+        "wordGapEm": zod58.number().min(compositionCaptionsTwoLayoutsItemStyleWordGapEmMin).max(compositionCaptionsTwoLayoutsItemStyleWordGapEmMax).optional().describe("Gap between caption runs as a multiple of base font size; default 0.35."),
+        "lineGapEm": zod58.number().min(compositionCaptionsTwoLayoutsItemStyleLineGapEmMin).max(compositionCaptionsTwoLayoutsItemStyleLineGapEmMax).optional().describe("Gap between caption lines as a multiple of base font size; default 0.25."),
+        "emphasisColor": zod58.string().optional(),
+        "emphasisScale": zod58.number().gt(compositionCaptionsTwoLayoutsItemStyleEmphasisScaleExclusiveMin).optional(),
+        "emphasisFontFamily": zod58.string().optional(),
+        "emphasisFontWeight": zod58.int().min(compositionCaptionsTwoLayoutsItemStyleEmphasisFontWeightMin).max(compositionCaptionsTwoLayoutsItemStyleEmphasisFontWeightMax).optional(),
+        "emphasisTextTransform": zod58.enum(["none", "uppercase", "capitalize"]).optional(),
+        "emphasisLetterSpacing": zod58.number().optional(),
+        "emphasisFontStyle": zod58.enum(["normal", "italic"]).optional(),
+        "emphasisPlate": zod58.boolean().optional(),
+        "emphasisPlateColor": zod58.string().optional(),
+        "emphasisPlateTextColor": zod58.string().optional(),
+        "emphasisPlateAltColor": zod58.string().optional(),
+        "emphasisPlateAltTextColor": zod58.string().optional(),
+        "emphasisPlateRadius": zod58.number().min(compositionCaptionsTwoLayoutsItemStyleEmphasisPlateRadiusMin).optional(),
+        "emphasisPlatePadX": zod58.number().optional(),
+        "emphasisPlatePadY": zod58.number().optional(),
+        "emphasisPlateReveal": zod58.boolean().optional().describe("Grow a shared emphasis plate as saved words appear while reserving its final layout width."),
+        "annotationColor": zod58.string().optional(),
+        "annotationStrokeWidth": zod58.number().min(compositionCaptionsTwoLayoutsItemStyleAnnotationStrokeWidthMin).max(compositionCaptionsTwoLayoutsItemStyleAnnotationStrokeWidthMax).optional().describe("Annotation stroke width in its 100\xD7100 SVG coordinate system; default 4."),
+        "entrance": zod58.enum(["none", "fade", "word-pop", "stagger-up"]).optional(),
+        "entranceMs": zod58.number().min(compositionCaptionsTwoLayoutsItemStyleEntranceMsMin).optional(),
+        "entranceStaggerMs": zod58.number().min(compositionCaptionsTwoLayoutsItemStyleEntranceStaggerMsMin).optional(),
+        "exitMs": zod58.number().min(compositionCaptionsTwoLayoutsItemStyleExitMsMin).optional()
+      }).optional(),
+      "holdThroughWordIndex": zod58.int().min(compositionCaptionsTwoLayoutsItemHoldThroughWordIndexMin).max(compositionCaptionsTwoLayoutsItemHoldThroughWordIndexMax).optional().describe("Inclusive saved-word index in this segment. The layout stays visible until that word ends."),
+      "wordMarks": zod58.array(zod58.strictObject({
+        "wordIndex": zod58.int().min(compositionCaptionsTwoLayoutsItemWordMarksItemWordIndexMin).max(compositionCaptionsTwoLayoutsItemWordMarksItemWordIndexMax),
+        "emphasis": zod58.boolean().optional(),
+        "annotate": zod58.union([zod58.enum(["circle", "underline"]), zod58.null()]).optional()
+      })).optional(),
+      "wordSignature": zod58.string().regex(compositionCaptionsTwoLayoutsItemWordSignatureRegExp)
+    })).optional(),
     "zPlane": zod58.enum(["front", "behind-subject"]).optional()
   })]).optional(),
   "license": zod58.strictObject({
@@ -6112,6 +6330,12 @@ var compositionOpOnethreeStyleRegionWExclusiveMin = 0;
 var compositionOpOnethreeStyleRegionWMax = 1;
 var compositionOpOnethreeStyleRegionHExclusiveMin = 0;
 var compositionOpOnethreeStyleRegionHMax = 1;
+var compositionOpOnethreeStyleLetterSpacingMin = -5;
+var compositionOpOnethreeStyleLetterSpacingMax = 20;
+var compositionOpOnethreeStyleWordGapEmMin = 0;
+var compositionOpOnethreeStyleWordGapEmMax = 2;
+var compositionOpOnethreeStyleLineGapEmMin = 0;
+var compositionOpOnethreeStyleLineGapEmMax = 2;
 var compositionOpOnethreeStyleEmphasisScaleExclusiveMin = 0;
 var compositionOpOnethreeStyleEmphasisFontWeightMin = 100;
 var compositionOpOnethreeStyleEmphasisFontWeightMax = 900;
@@ -6119,34 +6343,84 @@ var compositionOpOnethreeStyleEntranceMsMin = 0;
 var compositionOpOnethreeStyleEntranceStaggerMsMin = 0;
 var compositionOpOnethreeStyleExitMsMin = 0;
 var compositionOpOnethreeStyleEmphasisPlateRadiusMin = 0;
+var compositionOpOnethreeStyleAnnotationStrokeWidthMin = 0.5;
+var compositionOpOnethreeStyleAnnotationStrokeWidthMax = 12;
 var compositionOpOnethreeStyleMaxWidthPercentExclusiveMin = 0;
 var compositionOpOnethreeStyleMaxWidthPercentMax = 100;
-var compositionOpOnefiveSegmentsItemWordsItemStartMsMin = 0;
-var compositionOpOnefiveSegmentsItemWordsItemEndMsMin = 0;
-var compositionOpOnefiveStyleFontSizeMax = 15;
-var compositionOpOnefiveStyleFontWeightMin = 100;
-var compositionOpOnefiveStyleFontWeightMax = 900;
-var compositionOpOnefiveStyleRegionXMin = 0;
-var compositionOpOnefiveStyleRegionXMax = 1;
-var compositionOpOnefiveStyleRegionYMin = 0;
-var compositionOpOnefiveStyleRegionYMax = 1;
-var compositionOpOnefiveStyleRegionWExclusiveMin = 0;
-var compositionOpOnefiveStyleRegionWMax = 1;
-var compositionOpOnefiveStyleRegionHExclusiveMin = 0;
-var compositionOpOnefiveStyleRegionHMax = 1;
-var compositionOpOnefiveStyleEmphasisScaleExclusiveMin = 0;
-var compositionOpOnefiveStyleEmphasisFontWeightMin = 100;
-var compositionOpOnefiveStyleEmphasisFontWeightMax = 900;
-var compositionOpOnefiveStyleEntranceMsMin = 0;
-var compositionOpOnefiveStyleEntranceStaggerMsMin = 0;
-var compositionOpOnefiveStyleExitMsMin = 0;
-var compositionOpOnefiveStyleEmphasisPlateRadiusMin = 0;
-var compositionOpOnefiveStyleMaxWidthPercentExclusiveMin = 0;
-var compositionOpOnefiveStyleMaxWidthPercentMax = 100;
-var compositionOpOnesixWindowStartSecMin = 0;
-var compositionOpOnesixWindowEndSecExclusiveMin = 0;
-var compositionOpOnenineMaxMarkersExclusiveMin = 0;
-var compositionOpOnenineMaxMarkersMax = 2e3;
+var compositionOpOnefourLayoutsItemSegmentIndexMin = 0;
+var compositionOpOnefourLayoutsItemSegmentIndexMax = 9007199254740991;
+var compositionOpOnefourLayoutsItemWordStartIndexMin = 0;
+var compositionOpOnefourLayoutsItemWordStartIndexMax = 9007199254740991;
+var compositionOpOnefourLayoutsItemWordEndIndexExclusiveMin = 0;
+var compositionOpOnefourLayoutsItemWordEndIndexMax = 9007199254740991;
+var compositionOpOnefourLayoutsItemRegionXMin = 0;
+var compositionOpOnefourLayoutsItemRegionXMax = 1;
+var compositionOpOnefourLayoutsItemRegionYMin = 0;
+var compositionOpOnefourLayoutsItemRegionYMax = 1;
+var compositionOpOnefourLayoutsItemRegionWExclusiveMin = 0;
+var compositionOpOnefourLayoutsItemRegionWMax = 1;
+var compositionOpOnefourLayoutsItemRegionHExclusiveMin = 0;
+var compositionOpOnefourLayoutsItemRegionHMax = 1;
+var compositionOpOnefourLayoutsItemScaleMin = 0.25;
+var compositionOpOnefourLayoutsItemScaleMax = 4;
+var compositionOpOnefourLayoutsItemRotationMin = -45;
+var compositionOpOnefourLayoutsItemRotationMax = 45;
+var compositionOpOnefourLayoutsItemStyleFontSizeMax = 15;
+var compositionOpOnefourLayoutsItemStyleFontWeightMin = 100;
+var compositionOpOnefourLayoutsItemStyleFontWeightMax = 900;
+var compositionOpOnefourLayoutsItemStyleLetterSpacingMin = -5;
+var compositionOpOnefourLayoutsItemStyleLetterSpacingMax = 20;
+var compositionOpOnefourLayoutsItemStyleWordGapEmMin = 0;
+var compositionOpOnefourLayoutsItemStyleWordGapEmMax = 2;
+var compositionOpOnefourLayoutsItemStyleLineGapEmMin = 0;
+var compositionOpOnefourLayoutsItemStyleLineGapEmMax = 2;
+var compositionOpOnefourLayoutsItemStyleEmphasisScaleExclusiveMin = 0;
+var compositionOpOnefourLayoutsItemStyleEmphasisFontWeightMin = 100;
+var compositionOpOnefourLayoutsItemStyleEmphasisFontWeightMax = 900;
+var compositionOpOnefourLayoutsItemStyleEmphasisPlateRadiusMin = 0;
+var compositionOpOnefourLayoutsItemStyleAnnotationStrokeWidthMin = 0.5;
+var compositionOpOnefourLayoutsItemStyleAnnotationStrokeWidthMax = 12;
+var compositionOpOnefourLayoutsItemStyleEntranceMsMin = 0;
+var compositionOpOnefourLayoutsItemStyleEntranceStaggerMsMin = 0;
+var compositionOpOnefourLayoutsItemStyleExitMsMin = 0;
+var compositionOpOnefourLayoutsItemHoldThroughWordIndexMin = 0;
+var compositionOpOnefourLayoutsItemHoldThroughWordIndexMax = 9007199254740991;
+var compositionOpOnefourLayoutsItemWordMarksItemWordIndexMin = 0;
+var compositionOpOnefourLayoutsItemWordMarksItemWordIndexMax = 9007199254740991;
+var compositionOpOnesixSegmentsItemWordsItemStartMsMin = 0;
+var compositionOpOnesixSegmentsItemWordsItemEndMsMin = 0;
+var compositionOpOnesixStyleFontSizeMax = 15;
+var compositionOpOnesixStyleFontWeightMin = 100;
+var compositionOpOnesixStyleFontWeightMax = 900;
+var compositionOpOnesixStyleRegionXMin = 0;
+var compositionOpOnesixStyleRegionXMax = 1;
+var compositionOpOnesixStyleRegionYMin = 0;
+var compositionOpOnesixStyleRegionYMax = 1;
+var compositionOpOnesixStyleRegionWExclusiveMin = 0;
+var compositionOpOnesixStyleRegionWMax = 1;
+var compositionOpOnesixStyleRegionHExclusiveMin = 0;
+var compositionOpOnesixStyleRegionHMax = 1;
+var compositionOpOnesixStyleLetterSpacingMin = -5;
+var compositionOpOnesixStyleLetterSpacingMax = 20;
+var compositionOpOnesixStyleWordGapEmMin = 0;
+var compositionOpOnesixStyleWordGapEmMax = 2;
+var compositionOpOnesixStyleLineGapEmMin = 0;
+var compositionOpOnesixStyleLineGapEmMax = 2;
+var compositionOpOnesixStyleEmphasisScaleExclusiveMin = 0;
+var compositionOpOnesixStyleEmphasisFontWeightMin = 100;
+var compositionOpOnesixStyleEmphasisFontWeightMax = 900;
+var compositionOpOnesixStyleEntranceMsMin = 0;
+var compositionOpOnesixStyleEntranceStaggerMsMin = 0;
+var compositionOpOnesixStyleExitMsMin = 0;
+var compositionOpOnesixStyleEmphasisPlateRadiusMin = 0;
+var compositionOpOnesixStyleAnnotationStrokeWidthMin = 0.5;
+var compositionOpOnesixStyleAnnotationStrokeWidthMax = 12;
+var compositionOpOnesixStyleMaxWidthPercentExclusiveMin = 0;
+var compositionOpOnesixStyleMaxWidthPercentMax = 100;
+var compositionOpOnesevenWindowStartSecMin = 0;
+var compositionOpOnesevenWindowEndSecExclusiveMin = 0;
+var compositionOpTwozeroMaxMarkersExclusiveMin = 0;
+var compositionOpTwozeroMaxMarkersMax = 2e3;
 var CompositionOp = zod67.union([zod67.strictObject({
   "type": zod67.literal("scene.add"),
   "clipId": zod67.string(),
@@ -6286,7 +6560,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "h": zod67.number().gt(compositionOpThreeClipRegionHExclusiveMin).max(compositionOpThreeClipRegionHMax)
     }).optional(),
     "fit": zod67.enum(["cover", "contain"]).optional(),
-    "captionVisibility": zod67.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
+    "captionVisibility": zod67.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is topmost and covers the lower picture, or when an opaque, effect-free clip has an explicitly full-frame region, even with fit:contain. Caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod67.array(zod67.strictObject({
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
@@ -6436,7 +6710,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "h": zod67.number().gt(compositionOpFivePatchRegionHExclusiveMin).max(compositionOpFivePatchRegionHMax)
     }).optional(),
     "fit": zod67.enum(["cover", "contain"]).optional(),
-    "captionVisibility": zod67.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
+    "captionVisibility": zod67.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is topmost and covers the lower picture, or when an opaque, effect-free clip has an explicitly full-frame region, even with fit:contain. Caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod67.array(zod67.strictObject({
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
@@ -6582,7 +6856,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "h": zod67.number().gt(compositionOpSevenClipsItemRegionHExclusiveMin).max(compositionOpSevenClipsItemRegionHMax)
     }).optional(),
     "fit": zod67.enum(["cover", "contain"]).optional(),
-    "captionVisibility": zod67.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is the visible full-frame picture; caption words and timings remain stored and resume when another visible clip takes over."),
+    "captionVisibility": zod67.enum(["visible", "hidden"]).optional().describe("Video media clip only. Hide native captions while this clip is topmost and covers the lower picture, or when an opaque, effect-free clip has an explicitly full-frame region, even with fit:contain. Caption words and timings remain stored and resume when another visible clip takes over."),
     "effects": zod67.array(zod67.strictObject({
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
@@ -6686,6 +6960,9 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "h": zod67.number().gt(compositionOpOnethreeStyleRegionHExclusiveMin).max(compositionOpOnethreeStyleRegionHMax)
     }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
     "textTransform": zod67.enum(["none", "uppercase", "capitalize"]).optional(),
+    "letterSpacing": zod67.number().min(compositionOpOnethreeStyleLetterSpacingMin).max(compositionOpOnethreeStyleLetterSpacingMax).optional().describe("Base caption glyph spacing in pixels."),
+    "wordGapEm": zod67.number().min(compositionOpOnethreeStyleWordGapEmMin).max(compositionOpOnethreeStyleWordGapEmMax).optional().describe("Gap between caption runs as a multiple of base font size; default 0.35."),
+    "lineGapEm": zod67.number().min(compositionOpOnethreeStyleLineGapEmMin).max(compositionOpOnethreeStyleLineGapEmMax).optional().describe("Gap between caption lines as a multiple of base font size; default 0.25."),
     "emphasisColor": zod67.string().optional(),
     "emphasisGradient": zod67.string().optional(),
     "emphasisScale": zod67.number().gt(compositionOpOnethreeStyleEmphasisScaleExclusiveMin).optional(),
@@ -6706,10 +6983,68 @@ var CompositionOp = zod67.union([zod67.strictObject({
     "emphasisPlateRadius": zod67.number().min(compositionOpOnethreeStyleEmphasisPlateRadiusMin).optional(),
     "emphasisPlatePadX": zod67.number().optional(),
     "emphasisPlatePadY": zod67.number().optional(),
+    "emphasisPlateReveal": zod67.boolean().optional().describe("Grow a shared emphasis plate as saved words appear while reserving its final layout width."),
     "annotationColor": zod67.string().optional(),
+    "annotationStrokeWidth": zod67.number().min(compositionOpOnethreeStyleAnnotationStrokeWidthMin).max(compositionOpOnethreeStyleAnnotationStrokeWidthMax).optional().describe("Annotation stroke width in its 100\xD7100 SVG coordinate system; default 4."),
     "maxWidthPercent": zod67.number().gt(compositionOpOnethreeStyleMaxWidthPercentExclusiveMin).max(compositionOpOnethreeStyleMaxWidthPercentMax).optional()
   })
 }).describe("Merge style overrides (font/color/position/emphasis) onto the composition's caption layer. Partial \u2014 omitted fields keep their current value; creates the caption container if absent."), zod67.strictObject({
+  "type": zod67.literal("setCaptionLayouts"),
+  "layouts": zod67.array(zod67.strictObject({
+    "segmentIndex": zod67.int().min(compositionOpOnefourLayoutsItemSegmentIndexMin).max(compositionOpOnefourLayoutsItemSegmentIndexMax),
+    "wordStartIndex": zod67.int().min(compositionOpOnefourLayoutsItemWordStartIndexMin).max(compositionOpOnefourLayoutsItemWordStartIndexMax),
+    "wordEndIndex": zod67.int().gt(compositionOpOnefourLayoutsItemWordEndIndexExclusiveMin).max(compositionOpOnefourLayoutsItemWordEndIndexMax).describe("Exclusive word index in the saved caption segment."),
+    "region": zod67.strictObject({
+      "x": zod67.number().min(compositionOpOnefourLayoutsItemRegionXMin).max(compositionOpOnefourLayoutsItemRegionXMax),
+      "y": zod67.number().min(compositionOpOnefourLayoutsItemRegionYMin).max(compositionOpOnefourLayoutsItemRegionYMax),
+      "w": zod67.number().gt(compositionOpOnefourLayoutsItemRegionWExclusiveMin).max(compositionOpOnefourLayoutsItemRegionWMax),
+      "h": zod67.number().gt(compositionOpOnefourLayoutsItemRegionHExclusiveMin).max(compositionOpOnefourLayoutsItemRegionHMax)
+    }),
+    "scale": zod67.number().min(compositionOpOnefourLayoutsItemScaleMin).max(compositionOpOnefourLayoutsItemScaleMax).optional(),
+    "rotation": zod67.number().min(compositionOpOnefourLayoutsItemRotationMin).max(compositionOpOnefourLayoutsItemRotationMax).optional(),
+    "style": zod67.strictObject({
+      "fontFamily": zod67.string().min(1).optional(),
+      "fontSize": zod67.number().min(1).max(compositionOpOnefourLayoutsItemStyleFontSizeMax).optional().describe("Font size as % of composition height (1-15, default 5). NOT px."),
+      "fontWeight": zod67.int().min(compositionOpOnefourLayoutsItemStyleFontWeightMin).max(compositionOpOnefourLayoutsItemStyleFontWeightMax).optional(),
+      "color": zod67.string().min(1).optional(),
+      "highlightColor": zod67.string().min(1).optional(),
+      "backgroundColor": zod67.string().optional(),
+      "plate": zod67.enum(["glass", "solid", "none"]).optional(),
+      "textTransform": zod67.enum(["none", "uppercase", "capitalize"]).optional(),
+      "letterSpacing": zod67.number().min(compositionOpOnefourLayoutsItemStyleLetterSpacingMin).max(compositionOpOnefourLayoutsItemStyleLetterSpacingMax).optional().describe("Base caption glyph spacing in pixels."),
+      "wordGapEm": zod67.number().min(compositionOpOnefourLayoutsItemStyleWordGapEmMin).max(compositionOpOnefourLayoutsItemStyleWordGapEmMax).optional().describe("Gap between caption runs as a multiple of base font size; default 0.35."),
+      "lineGapEm": zod67.number().min(compositionOpOnefourLayoutsItemStyleLineGapEmMin).max(compositionOpOnefourLayoutsItemStyleLineGapEmMax).optional().describe("Gap between caption lines as a multiple of base font size; default 0.25."),
+      "emphasisColor": zod67.string().optional(),
+      "emphasisScale": zod67.number().gt(compositionOpOnefourLayoutsItemStyleEmphasisScaleExclusiveMin).optional(),
+      "emphasisFontFamily": zod67.string().optional(),
+      "emphasisFontWeight": zod67.int().min(compositionOpOnefourLayoutsItemStyleEmphasisFontWeightMin).max(compositionOpOnefourLayoutsItemStyleEmphasisFontWeightMax).optional(),
+      "emphasisTextTransform": zod67.enum(["none", "uppercase", "capitalize"]).optional(),
+      "emphasisLetterSpacing": zod67.number().optional(),
+      "emphasisFontStyle": zod67.enum(["normal", "italic"]).optional(),
+      "emphasisPlate": zod67.boolean().optional(),
+      "emphasisPlateColor": zod67.string().optional(),
+      "emphasisPlateTextColor": zod67.string().optional(),
+      "emphasisPlateAltColor": zod67.string().optional(),
+      "emphasisPlateAltTextColor": zod67.string().optional(),
+      "emphasisPlateRadius": zod67.number().min(compositionOpOnefourLayoutsItemStyleEmphasisPlateRadiusMin).optional(),
+      "emphasisPlatePadX": zod67.number().optional(),
+      "emphasisPlatePadY": zod67.number().optional(),
+      "emphasisPlateReveal": zod67.boolean().optional().describe("Grow a shared emphasis plate as saved words appear while reserving its final layout width."),
+      "annotationColor": zod67.string().optional(),
+      "annotationStrokeWidth": zod67.number().min(compositionOpOnefourLayoutsItemStyleAnnotationStrokeWidthMin).max(compositionOpOnefourLayoutsItemStyleAnnotationStrokeWidthMax).optional().describe("Annotation stroke width in its 100\xD7100 SVG coordinate system; default 4."),
+      "entrance": zod67.enum(["none", "fade", "word-pop", "stagger-up"]).optional(),
+      "entranceMs": zod67.number().min(compositionOpOnefourLayoutsItemStyleEntranceMsMin).optional(),
+      "entranceStaggerMs": zod67.number().min(compositionOpOnefourLayoutsItemStyleEntranceStaggerMsMin).optional(),
+      "exitMs": zod67.number().min(compositionOpOnefourLayoutsItemStyleExitMsMin).optional()
+    }).optional(),
+    "holdThroughWordIndex": zod67.int().min(compositionOpOnefourLayoutsItemHoldThroughWordIndexMin).max(compositionOpOnefourLayoutsItemHoldThroughWordIndexMax).optional().describe("Inclusive saved-word index in this segment. The layout stays visible until that word ends."),
+    "wordMarks": zod67.array(zod67.strictObject({
+      "wordIndex": zod67.int().min(compositionOpOnefourLayoutsItemWordMarksItemWordIndexMin).max(compositionOpOnefourLayoutsItemWordMarksItemWordIndexMax),
+      "emphasis": zod67.boolean().optional(),
+      "annotate": zod67.union([zod67.enum(["circle", "underline"]), zod67.null()]).optional()
+    })).optional()
+  }))
+}).describe("Replace native caption placements without changing transcript words or timings. Each layout references a half-open word-index range in one saved segment; a one-word range is valid. region places that group independently, optional bounded scale/rotation/style changes its look, and holdThroughWordIndex keeps it visible through a later saved word in the same segment. All words in a placed range occupy one page; rendering refuses a range that cannot fit its box, so enlarge region or split the range. The box reserves horizontal space of 1.6 font sizes and vertical space of 0.8 font sizes for padding, with at most three lines. Unreferenced words keep the default caption layout. Word ranges must not overlap. Reapply after caption regeneration or timeline cuts."), zod67.strictObject({
   "type": zod67.literal("setCaptionDepth"),
   "zPlane": zod67.enum(["front", "behind-subject"])
 }).describe("Set the caption compositing plane. Use `behind-subject` to place captions behind the segmented foreground subject; use `front` for conventional captions above all video layers."), zod67.strictObject({
@@ -6717,57 +7052,62 @@ var CompositionOp = zod67.union([zod67.strictObject({
   "segments": zod67.array(zod67.strictObject({
     "words": zod67.array(zod67.strictObject({
       "text": zod67.string().min(1),
-      "startMs": zod67.number().min(compositionOpOnefiveSegmentsItemWordsItemStartMsMin).describe("Word start on the composition timeline, in milliseconds."),
-      "endMs": zod67.number().min(compositionOpOnefiveSegmentsItemWordsItemEndMsMin).describe("Word end on the composition timeline, in milliseconds."),
+      "startMs": zod67.number().min(compositionOpOnesixSegmentsItemWordsItemStartMsMin).describe("Word start on the composition timeline, in milliseconds."),
+      "endMs": zod67.number().min(compositionOpOnesixSegmentsItemWordsItemEndMsMin).describe("Word end on the composition timeline, in milliseconds."),
       "emphasis": zod67.boolean().optional(),
       "annotate": zod67.enum(["circle", "underline"]).optional()
     }))
   })),
   "style": zod67.strictObject({
     "fontFamily": zod67.string().min(1).optional(),
-    "fontSize": zod67.number().min(1).max(compositionOpOnefiveStyleFontSizeMax).optional().describe("Font size as % of composition height (1-15, default 5). NOT px."),
-    "fontWeight": zod67.int().min(compositionOpOnefiveStyleFontWeightMin).max(compositionOpOnefiveStyleFontWeightMax).optional(),
+    "fontSize": zod67.number().min(1).max(compositionOpOnesixStyleFontSizeMax).optional().describe("Font size as % of composition height (1-15, default 5). NOT px."),
+    "fontWeight": zod67.int().min(compositionOpOnesixStyleFontWeightMin).max(compositionOpOnesixStyleFontWeightMax).optional(),
     "color": zod67.string().min(1).optional(),
     "highlightColor": zod67.string().min(1).optional(),
     "backgroundColor": zod67.string().optional(),
     "plate": zod67.enum(["glass", "solid", "none"]).optional(),
     "position": zod67.enum(["top", "center", "bottom"]).optional(),
     "region": zod67.strictObject({
-      "x": zod67.number().min(compositionOpOnefiveStyleRegionXMin).max(compositionOpOnefiveStyleRegionXMax),
-      "y": zod67.number().min(compositionOpOnefiveStyleRegionYMin).max(compositionOpOnefiveStyleRegionYMax),
-      "w": zod67.number().gt(compositionOpOnefiveStyleRegionWExclusiveMin).max(compositionOpOnefiveStyleRegionWMax),
-      "h": zod67.number().gt(compositionOpOnefiveStyleRegionHExclusiveMin).max(compositionOpOnefiveStyleRegionHMax)
+      "x": zod67.number().min(compositionOpOnesixStyleRegionXMin).max(compositionOpOnesixStyleRegionXMax),
+      "y": zod67.number().min(compositionOpOnesixStyleRegionYMin).max(compositionOpOnesixStyleRegionYMax),
+      "w": zod67.number().gt(compositionOpOnesixStyleRegionWExclusiveMin).max(compositionOpOnesixStyleRegionWMax),
+      "h": zod67.number().gt(compositionOpOnesixStyleRegionHExclusiveMin).max(compositionOpOnesixStyleRegionHMax)
     }).optional().describe("Optional caption layout box {x,y,w,h} in normalized output-frame coordinates. Overrides position; text starts at its top edge and wraps/pages within its width and height."),
     "textTransform": zod67.enum(["none", "uppercase", "capitalize"]).optional(),
+    "letterSpacing": zod67.number().min(compositionOpOnesixStyleLetterSpacingMin).max(compositionOpOnesixStyleLetterSpacingMax).optional().describe("Base caption glyph spacing in pixels."),
+    "wordGapEm": zod67.number().min(compositionOpOnesixStyleWordGapEmMin).max(compositionOpOnesixStyleWordGapEmMax).optional().describe("Gap between caption runs as a multiple of base font size; default 0.35."),
+    "lineGapEm": zod67.number().min(compositionOpOnesixStyleLineGapEmMin).max(compositionOpOnesixStyleLineGapEmMax).optional().describe("Gap between caption lines as a multiple of base font size; default 0.25."),
     "emphasisColor": zod67.string().optional(),
     "emphasisGradient": zod67.string().optional(),
-    "emphasisScale": zod67.number().gt(compositionOpOnefiveStyleEmphasisScaleExclusiveMin).optional(),
+    "emphasisScale": zod67.number().gt(compositionOpOnesixStyleEmphasisScaleExclusiveMin).optional(),
     "emphasisFontFamily": zod67.string().optional(),
-    "emphasisFontWeight": zod67.int().min(compositionOpOnefiveStyleEmphasisFontWeightMin).max(compositionOpOnefiveStyleEmphasisFontWeightMax).optional(),
+    "emphasisFontWeight": zod67.int().min(compositionOpOnesixStyleEmphasisFontWeightMin).max(compositionOpOnesixStyleEmphasisFontWeightMax).optional(),
     "emphasisTextTransform": zod67.enum(["none", "uppercase", "capitalize"]).optional(),
     "emphasisLetterSpacing": zod67.number().optional(),
     "emphasisFontStyle": zod67.enum(["normal", "italic"]).optional(),
     "entrance": zod67.enum(["none", "fade", "word-pop", "stagger-up"]).optional(),
-    "entranceMs": zod67.number().min(compositionOpOnefiveStyleEntranceMsMin).optional(),
-    "entranceStaggerMs": zod67.number().min(compositionOpOnefiveStyleEntranceStaggerMsMin).optional(),
-    "exitMs": zod67.number().min(compositionOpOnefiveStyleExitMsMin).optional(),
+    "entranceMs": zod67.number().min(compositionOpOnesixStyleEntranceMsMin).optional(),
+    "entranceStaggerMs": zod67.number().min(compositionOpOnesixStyleEntranceStaggerMsMin).optional(),
+    "exitMs": zod67.number().min(compositionOpOnesixStyleExitMsMin).optional(),
     "emphasisPlate": zod67.boolean().optional(),
     "emphasisPlateColor": zod67.string().optional(),
     "emphasisPlateTextColor": zod67.string().optional(),
     "emphasisPlateAltColor": zod67.string().optional(),
     "emphasisPlateAltTextColor": zod67.string().optional(),
-    "emphasisPlateRadius": zod67.number().min(compositionOpOnefiveStyleEmphasisPlateRadiusMin).optional(),
+    "emphasisPlateRadius": zod67.number().min(compositionOpOnesixStyleEmphasisPlateRadiusMin).optional(),
     "emphasisPlatePadX": zod67.number().optional(),
     "emphasisPlatePadY": zod67.number().optional(),
+    "emphasisPlateReveal": zod67.boolean().optional().describe("Grow a shared emphasis plate as saved words appear while reserving its final layout width."),
     "annotationColor": zod67.string().optional(),
-    "maxWidthPercent": zod67.number().gt(compositionOpOnefiveStyleMaxWidthPercentExclusiveMin).max(compositionOpOnefiveStyleMaxWidthPercentMax).optional()
+    "annotationStrokeWidth": zod67.number().min(compositionOpOnesixStyleAnnotationStrokeWidthMin).max(compositionOpOnesixStyleAnnotationStrokeWidthMax).optional().describe("Annotation stroke width in its 100\xD7100 SVG coordinate system; default 4."),
+    "maxWidthPercent": zod67.number().gt(compositionOpOnesixStyleMaxWidthPercentExclusiveMin).max(compositionOpOnesixStyleMaxWidthPercentMax).optional()
   }).optional()
 }).describe("Replace the caption SEGMENTS wholesale \u2014 author the word-timed caption layer directly (each segment = one sentence/page of `words` with timeline-ms `startMs`/`endMs`, optional `emphasis`). This is how a client with its OWN word timings (e.g. a generated VO take) gets word-synced captions without a source transcript; the compose lane's transcript slice writes the same layer. `style`, when given, merges with setCaptionStyle semantics; an omitted style keeps the existing one. Renderer paginates within a segment and never pools words across two \u2014 keep segments sentence-bounded."), zod67.strictObject({
   "type": zod67.literal("captions.fromTranscript"),
   "mediaId": zod67.string().min(1),
   "window": zod67.strictObject({
-    "startSec": zod67.number().min(compositionOpOnesixWindowStartSecMin),
-    "endSec": zod67.number().gt(compositionOpOnesixWindowEndSecExclusiveMin)
+    "startSec": zod67.number().min(compositionOpOnesevenWindowStartSecMin),
+    "endSec": zod67.number().gt(compositionOpOnesevenWindowEndSecExclusiveMin)
   }).optional()
 }).describe("Attach caption CONTENT from the media's cached transcript \u2014 no pasting words. ROUTE-MATERIALIZED like applyMotionPreset/materializeGrid: the server slices the word-timed transcript to `window` (source seconds; absent = the whole media), rebases times, sentence-splits into segments, and applies it as `setCaptions`. 422 media_no_transcript when the media has no transcript or no words in the window. For your OWN word timings use setCaptions directly. For edited multi-clip timelines, use captions.fromComposition after saving the edits; that operation projects all selected track clips, trims, exclusions, and placements."), zod67.strictObject({
   "type": zod67.literal("captions.fromComposition"),
@@ -6785,7 +7125,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
   "type": zod67.literal("materializeGrid"),
   "clipId": zod67.string(),
   "grid": zod67.enum(["beat", "word", "shot"]),
-  "maxMarkers": zod67.int().gt(compositionOpOnenineMaxMarkersExclusiveMin).max(compositionOpOnenineMaxMarkersMax).optional()
+  "maxMarkers": zod67.int().gt(compositionOpTwozeroMaxMarkersExclusiveMin).max(compositionOpTwozeroMaxMarkersMax).optional()
 }).describe('Materialize a clip\'s SOURCE-media temporal GRID as timeline markers \u2014 the rhythm authority you cut to. `grid:"beat"` reads a MUSIC bed\'s beat map (get_media_context.beatGrid), `grid:"word"` the VO word onsets (wordGrid); each grid point is projected from media time to TIMELINE time through the clip\'s placement (startTime, trim, playbackRate, excludedRanges) and written as a `kind:"beat"|"word"` marker (`metadata.sourceClipId` set). Points outside the clip\'s visible window are skipped. Re-running REPLACES the prior markers from the same clip+grid (idempotent). Land cuts and transition MIDPOINTS on the markers (a 0.5s transition starts 0.25s before its marker). `maxMarkers` (default 500, ceiling 2000) \u2014 exceeding it fails loud with the count. `grid:"shot"` is not yet exposed (shot_grid_unavailable). The target must be a media clip; absent evidence fails loud (grid_unavailable) naming how to get it (declare audioRole:"music" at ingest / transcribe).'), zod67.strictObject({
   "type": zod67.literal("setFormat"),
   "format": zod67.strictObject({
@@ -7918,7 +8258,7 @@ var RenderFontsResponse = zod157.strictObject({
       "min": zod157.number(),
       "max": zod157.number()
     })).describe("The weights a shipped file declares. A static face has min === max; a variable face gives its declared wght axis range. Any weight inside a range renders; anything outside every range is REFUSED, never synthesised."),
-    "styles": zod157.array(zod157.enum(["normal"])).describe("The styles bytes exist for. Always ['normal']: no bundled or aliased family ships an italic file, so fontStyle:'italic' over one is refused rather than slanted. Real italics come only from a brand-kit font asset."),
+    "styles": zod157.array(zod157.enum(["normal", "italic"])).describe("The styles bytes exist for in this family. Request italic only when this list includes 'italic'; the renderer refuses synthetic slant."),
     "captionDefaults": zod157.strictObject({
       "base": zod157.number(),
       "emphasis": zod157.number()
@@ -9382,7 +9722,7 @@ var GENERATED_OPERATIONS = [
   { operationId: "listMediaSuggestions", toolName: "cueframe_api_listMediaSuggestions", title: "List Media Suggestions", method: "GET", pathTemplate: "/v1/media/{id}/suggestions", pathParams: ["id"], queryParams: [{ "name": "limit", "required": false, "description": "Page size (1..100), default 20. Out-of-range or unparseable clamps into the range.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "after", "required": false, "description": "Opaque cursor from the previous page's `pagination.nextCursor`. Forward-only.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "string" } }, { "name": "platform", "required": false, "description": "Only suggestions cut for this delivery platform.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "string" } }, { "name": "format", "required": false, "description": "Only suggestions in this output format.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "string" } }, { "name": "topic", "required": false, "description": "Only suggestions matching this topic label.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "string" } }], bodyKey: null, description: "List clip suggestions for a media item \u2014 Required permission: media:read \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": true, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "status": { "type": "string", "enum": ["idle", "generating", "completed", "failed"] }, "createdAt": { "type": ["string", "null"] }, "analyzedAt": { "type": ["string", "null"] }, "jobId": { "type": ["string", "null"] }, "topics": { "type": "array" }, "suggestions": { "type": "array" }, "pagination": { "type": "object", "description": "Cursor pagination metadata." } }, "additionalProperties": true } },
   { operationId: "listProjectRenders", toolName: "cueframe_api_listProjectRenders", title: "List Project Renders", method: "GET", pathTemplate: "/v1/projects/{id}/renders", pathParams: ["id"], queryParams: [{ "name": "limit", "required": false, "description": "Page size (1..100), default 20. Out-of-range or unparseable clamps into the range.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "after", "required": false, "description": "Opaque cursor from the previous page's `pagination.nextCursor`. Forward-only.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "string" } }, { "name": "status", "required": false, "description": "Comma-separated render statuses to include (e.g. `error,cancelled`). Omit for every status.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "string" } }], bodyKey: null, description: "List renders for a project \u2014 Required permission: renders:read \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": true, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "data": { "type": "array" }, "pagination": { "type": "object", "description": "Cursor pagination metadata." } }, "additionalProperties": true } },
   { operationId: "listProjects", toolName: "cueframe_api_listProjects", title: "List Projects", method: "GET", pathTemplate: "/v1/projects", pathParams: [], queryParams: [{ "name": "limit", "required": false, "description": "Page size (1..100), default 20. Out-of-range or unparseable clamps into the range.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "after", "required": false, "description": "Opaque cursor from the previous page's `pagination.nextCursor`. Forward-only.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "string" } }], bodyKey: null, description: "List projects \u2014 Required permission: projects:read \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": true, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "data": { "type": "array" }, "pagination": { "type": "object", "description": "Cursor pagination metadata." } }, "additionalProperties": true } },
-  { operationId: "listRenderFonts", toolName: "cueframe_api_listRenderFonts", title: "List Render Fonts", method: "GET", pathTemplate: "/v1/fonts", pathParams: [], queryParams: [], bodyKey: null, description: "List the font faces the renderer can actually draw \u2014 The renderer's admitted font set: per family the exact name authoring accepts, the weight ranges a shipped file declares, the styles bytes exist for, the caption default weights, and whether the bytes are bundled or an aliased metric-compatible stand-in. Choose from here and validate_composition will not refuse the face. Unlike POST /fonts/search (which searches the GOOGLE catalog) this is what the render page can rasterize. `manifestVersion` identifies the exact table and moves only when the admitted set does. Covers the BUNDLED set only \u2014 a brand kit's sealed faces are per-org and per-render, and a real italic can come only from one. \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": true, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "manifestVersion": { "type": "string", "description": "Identifies this exact face table. Derived from the table's own content, so it moves when and only when the admitted set moves. Record it beside a composition to state which face table a font choice was validated against." }, "families": { "type": "array" } }, "additionalProperties": true } },
+  { operationId: "listRenderFonts", toolName: "cueframe_api_listRenderFonts", title: "List Render Fonts", method: "GET", pathTemplate: "/v1/fonts", pathParams: [], queryParams: [], bodyKey: null, description: "List the font faces the renderer can actually draw \u2014 The renderer's admitted font set: per family the exact name authoring accepts, the weight ranges a shipped file declares, the styles bytes exist for, the caption default weights, and whether the bytes are bundled or an aliased metric-compatible stand-in. Choose from here and validate_composition will not refuse the face. Unlike POST /fonts/search (which searches the GOOGLE catalog) this is what the render page can rasterize. `manifestVersion` identifies the exact table and moves only when the admitted set does. Covers the BUNDLED set only \u2014 a brand kit's sealed faces are per-org and per-render. \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": true, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "manifestVersion": { "type": "string", "description": "Identifies this exact face table. Derived from the table's own content, so it moves when and only when the admitted set moves. Record it beside a composition to state which face table a font choice was validated against." }, "families": { "type": "array" } }, "additionalProperties": true } },
   { operationId: "listSelectorCandidates", toolName: "cueframe_api_listSelectorCandidates", title: "List Selector Candidates", method: "GET", pathTemplate: "/v1/projects/{id}/selector/candidates", pathParams: ["id"], queryParams: [{ "name": "groupId", "required": true, "description": "The synced-angle group to score.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "string", "minLength": 1 } }], bodyKey: null, description: "List switch (multicam) candidates + recommendation for a synced-angle group \u2014 Required permission: media:read \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": true, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "projectId": { "type": "string" }, "groupId": { "type": "string" }, "selectorVersion": { "type": "string" }, "signalVersions": { "type": "object" }, "moments": { "type": "array" }, "recommendation": { "type": "object" }, "divergesFromComposition": { "type": "boolean" } }, "additionalProperties": true } },
   { operationId: "listSessions", toolName: "cueframe_api_listSessions", title: "List Sessions", method: "GET", pathTemplate: "/v1/sessions", pathParams: [], queryParams: [{ "name": "limit", "required": false, "description": "Page size (1..100), default 20. Out-of-range or unparseable clamps into the range.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "after", "required": false, "description": "Opaque cursor from the previous page's `pagination.nextCursor`. Forward-only.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "string" } }], bodyKey: null, description: "List sessions \u2014 Required permission: sessions:read \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": true, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "data": { "type": "array" }, "pagination": { "type": "object", "description": "Cursor pagination metadata." } }, "additionalProperties": true } },
   { operationId: "listSkills", toolName: "cueframe_api_listSkills", title: "List Skills", method: "GET", pathTemplate: "/v1/skills", pathParams: [], queryParams: [], bodyKey: null, description: "List available CueFrame agent skills \u2014 Returns the agent skills CueFrame publishes (e.g. `cueframe-cli`). Metadata only \u2014 fetch the markdown body from GET /skills/{name}. Unauthenticated, like /openapi.json. \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": true, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "skills": { "type": "array" } }, "additionalProperties": true } },
@@ -9405,7 +9745,7 @@ var GENERATED_OPERATIONS = [
   { operationId: "retryRender", toolName: "cueframe_api_retryRender", title: "Retry Render", method: "POST", pathTemplate: "/v1/projects/{id}/renders/{renderId}/retry", pathParams: ["id", "renderId"], queryParams: [], bodyKey: null, description: "Re-render against an existing renderJob's snapshot \u2014 Required permission: renders:write \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "id": { "type": "string" }, "status": { "type": "string", "enum": ["queued", "pending", "rendering", "complete", "error", "cancelled"] }, "progress": { "type": "object", "description": "Non-terminal render progress; phase is one of the worker's emitted stages." }, "outputUrl": { "type": ["string", "null"] }, "outputExpiresAt": { "type": ["string", "null"] }, "error": { "type": ["string", "null"], "description": "Human-readable failure message. Pair with `errorCode` for a stable, machine-readable code an agent runner can branch on." }, "errorCode": { "type": ["string", "null"], "description": "Stable, machine-readable error code (e.g. `render_pipeline_unavailable`, `render_route_missing`, `render_pipeline_failed`). Null when status is not `error` or unavailable for an older render." }, "errorDetails": { "description": "Structured failure context \u2014 `{ targetUrl?, upstreamStatus?, upstreamCode?, attemptedAt? }`. Surfaced so agent runners can distinguish operator-config issues from upstream-down vs route-missing without parsing `error`." }, "category": { "description": "Failure taxonomy when status is `error`; null otherwise. `authoring` = deterministic defect in YOUR composition/request \u2014 fix it, retrying is futile; `transient` = temporary pipeline/infra failure \u2014 safe to retry_render; `internal` = unexpected server fault \u2014 retry once then escalate. Mirrors the render.failed webhook's `category`." }, "retryable": { "type": ["boolean", "null"], "description": "Whether re-attempting the SAME render can succeed (status `error`); null otherwise. true \u2192 call retry_render. false \u2192 deterministic (category authoring/internal); fix the composition first \u2014 retry_render alone reproduces it. Mirrors the render.failed webhook's `retryable`." }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string", "description": "ISO-8601 timestamp of the render's most recent progress update. Compute staleness = now \u2212 updatedAt to distinguish a wedged render from a slow one and decide whether to wait, cancel, or retry." }, "listUsd": { "type": "number", "description": "A2 money stamp: the metered event's LIST price (USD), stamped at the success terminal (exports for deliverable renders, compose_capture for A8 previews). A plan allowance may zero the actual invoice line \u2014 this is the list price, never a Stripe charge. Absent while running, on failure, and for x402 orgs (on-chain receipts). Mirrors the get_usage ledger." }, "warnings": { "type": "array", "description": "Non-fatal advisories surfaced at render-CREATE (omitted when none, and on GET \u2014 create-time only)." } }, "additionalProperties": true } },
   { operationId: "scoreComposition", toolName: "cueframe_api_scoreComposition", title: "Score Composition", method: "POST", pathTemplate: "/v1/projects/{id}/score-composition", pathParams: ["id"], queryParams: [], bodyKey: "scoreCompositionBody", description: "Score a composition (the standalone sighted judge) \u2014 Queue the server-side judge: it samples eval beats, renders them, and grades editorial/spatial/brand/caption (0\u201310 + weighted composite + worst-first critique). Your REGISTERED CRITICS run too (register_critic) \u2014 rules + rubric verdicts ride the result as clientScores, exactly like the Director's gates evaluate them (evaluator-webhook critics run in the Director lane only). Returns a jobId \u2014 wait_job(kind='verify') for the result, which ALSO carries a checkpointId: the verdicts mint a durable kind:'score' Checkpoint (the same evidence noun the Director's gates produce). Stateless \u2014 nothing to open, warm or close; the compose_verify meter fires on the job's success terminal. \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "jobId": { "type": "string", "description": "Poll GET /v1/jobs/{jobId} / wait_job until terminal." }, "jobKey": { "type": "string", "description": "Deterministic identity of the work (content hash of every input the result depends on). Re-enqueueing the same key returns the same job while it runs; a failed key revives as a fresh attempt." }, "kind": { "type": "string", "description": "Job family, e.g. `verify` | `preview` | `brand_kit_extract`." }, "status": { "type": "string", "description": "running on a fresh/deduped enqueue; succeeded when an identical request already completed. Cancelled is part of the shared status vocabulary; identical cancelled work revives to running.", "enum": ["running", "succeeded", "cancelled"] } }, "additionalProperties": true } },
   { operationId: "scoreTrace", toolName: "cueframe_api_scoreTrace", title: "Score Trace", method: "POST", pathTemplate: "/v1/traces/{traceId}/scores", pathParams: ["traceId"], queryParams: [], bodyKey: "scoreTraceBody", description: "Attach production scores to one of your director traces \u2014 Record 1\u201310 named scores (0..1) on a trace the CueFrame gateway produced for YOUR director run \u2014 the trace id is the `trace_id` the client stamped on that run's requests. Only the trace's own user may score it; any other trace id answers 404. Scores are accepted asynchronously and acknowledged with 202. Free. \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "accepted": { "type": "integer" } }, "additionalProperties": true } },
-  { operationId: "searchFonts", toolName: "cueframe_api_searchFonts", title: "Search Fonts", method: "POST", pathTemplate: "/v1/fonts/search", pathParams: [], queryParams: [], bodyKey: "searchFontsBody", description: "Search web font families by name/style \u2014 Search the Google Fonts web-font catalog by keyword. Returns matching font families (family name + category + available variants + a css2 stylesheet URL). DISCOVERY ONLY, and this is NOT the set the renderer can draw: a cloud render draws only the faces GET /v1/fonts lists, or a face sealed in a brand kit font asset. Naming any other family in captions/params fails validate_composition with font_not_reproducible. Read GET /v1/fonts to choose a family AND an admitted weight before authoring \u2014 it also states that no bundled family ships an italic. Read-only and free; results are cached server-side. An empty `results` array means no match (or the upstream catalog was unavailable). \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": true }, outputSchema: { "type": "object", "properties": { "results": { "type": "array" } }, "additionalProperties": true } },
+  { operationId: "searchFonts", toolName: "cueframe_api_searchFonts", title: "Search Fonts", method: "POST", pathTemplate: "/v1/fonts/search", pathParams: [], queryParams: [], bodyKey: "searchFontsBody", description: "Search web font families by name/style \u2014 Search the Google Fonts web-font catalog by keyword. Returns matching font families (family name + category + available variants + a css2 stylesheet URL). DISCOVERY ONLY, and this is NOT the set the renderer can draw: a cloud render draws only the faces GET /v1/fonts lists, or a face sealed in a brand kit font asset. Naming any other family in captions/params fails validate_composition with font_not_reproducible. Read GET /v1/fonts to choose a family AND an admitted weight and style before authoring. Read-only and free; results are cached server-side. An empty `results` array means no match (or the upstream catalog was unavailable). \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": true }, outputSchema: { "type": "object", "properties": { "results": { "type": "array" } }, "additionalProperties": true } },
   { operationId: "searchLibrary", toolName: "cueframe_api_searchLibrary", title: "Search Library", method: "GET", pathTemplate: "/v1/media/search", pathParams: [], queryParams: [{ "name": "q", "required": true, "description": "What the moment should look like, in plain language. Describe the IMAGE, not the words spoken.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "limit", "required": false, "description": "Maximum moments to return. Default 10, maximum 25.", "style": "form", "explode": true, "allowReserved": false, "schema": { "type": "integer", "minimum": 1, "maximum": 25, "default": 10 } }], bodyKey: null, description: 'Semantic search over the org\'s own footage \u2014 Find MOMENTS in your library by describing what they look like. The query uses the same visual-semantic index as the footage, so it matches on visual content \u2014 "wide shot of a speaker at a whiteboard", "hands on a keyboard", "city skyline at dusk" \u2014 including shots nobody talks about (which is where transcript search fails). Results are time-ranged: feed `mediaId` + `startSec`/`endSec` straight into apply_composition as a clip. `q` is required; `limit` defaults to 10 and caps at 25. `indexing` is COVERAGE, not emptiness: it is true whenever some of the org\'s footage is not in the visual index yet (media that predates it, or still processing), and it can be true ALONGSIDE results \u2014 then read them as "the best moments among what we have looked at so far". Empty `results` with `indexing: true` is a state, not a failure; re-run the item through processing to index it. The first search after an idle period can take up to ~90s; subsequent searches are typically faster. \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.', annotations: { "readOnlyHint": true, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "results": { "type": "array", "description": "Matching moments, best first. Empty means nothing matched (when `indexing` is false) \u2014 the library was searched and came back empty-handed." }, "indexing": { "type": "boolean", "description": 'TRUE when some of the org\'s footage is NOT in the visual index yet \u2014 media that predates it, or is still processing. This is COVERAGE, not emptiness: it can be true ALONGSIDE results, and then it means "these are the best moments among what we have looked at so far", not "these are the best moments". An empty `results` with `indexing: true` means "not looked at yet", NOT "no match" \u2014 re-run the media through processing (reprocess) to index it, then search again. FALSE with empty `results` is a real miss: the library was searched and nothing matched.' } }, "additionalProperties": true } },
   { operationId: "searchResources", toolName: "cueframe_api_searchResources", title: "Search Resources", method: "POST", pathTemplate: "/v1/resources/search", pathParams: [], queryParams: [], bodyKey: "searchResourcesBody", description: "Search stock media (Pexels / Pixabay / Freesound / Klipy) \u2014 Search licensed stock media by keyword. Pass `query` for one search, or `queries[]` (\u226410) to run a batch in ONE call \u2014 the batch returns `results[]`, one entry per query in order, each with its own `candidates` (and an `error` string if that single query failed; one bad query never discards the rest). `kind` selects the corpus (video/photo default to Pexels; Pixabay is explicitly selectable; sfx \u2192 Freesound CC0-only; gif \u2192 Klipy); defaults to video. Returns ranked candidates each carrying an opaque `candidateId` \u2014 pass it to import_resource to bring the asset into a project. Free + rate-limited; results are cached for 7 days, after which a candidateId must be refreshed by searching again. For sfx, bound the result by clip length with `durationSec` \u2014 impacts/ticks \u2248 0\u20132s, risers/whooshes \u2248 2\u20138s, ambients unbounded. For video, use minWidth/minHeight to exclude smaller renditions. \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": true }, outputSchema: { "type": "object", "properties": { "provider": { "type": "string", "enum": ["pexels", "pixabay", "freesound", "klipy"] }, "kind": { "type": "string", "enum": ["video", "photo", "sfx", "gif"] }, "candidates": { "type": "array" }, "results": { "type": "array" } }, "additionalProperties": true } },
   { operationId: "selectComposeCandidate", toolName: "cueframe_api_selectComposeCandidate", title: "Select Compose Candidate", method: "POST", pathTemplate: "/v1/projects/{id}/compose/jobs/{composeJobId}/select", pathParams: ["id", "composeJobId"], queryParams: [], bodyKey: "selectComposeCandidateBody", description: "Promote a compose candidate to the active composition \u2014 Selects one candidate from a finished compose ensemble and writes it to the project's composition. `selectStrategy` decides how the editor draft interacts with the write (per compose-api-contract.md). \u2014 Advanced (expert layer) \u2014 prefer the curated high-level tools (compose, apply_composition, create_render, wait_job, get_media_context) when they fit your task.", annotations: { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false }, outputSchema: { "type": "object", "properties": { "newCompositionEtag": { "type": "string" }, "mergeResult": { "type": "object" } }, "additionalProperties": true } },