@cueframe/kernel 0.2.44 → 0.2.46

package/dist/{chunk-MJWRC7G7.js → chunk-BBNF4QLD.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-7AZLFN26.js";
 import {
   selectAllOverlays
-} from "./chunk-POTCIQTA.js";
+} from "./chunk-VEQTURKN.js";
 import {
   ComposePlan
 } from "./chunk-AG7HKF2U.js";
@@ -63,7 +63,7 @@ var COMPOSE_ROLE_TOOLS = Object.freeze({
     schema: z.object({}),
     metadata: { label: "Get Context" },
     handler: async (_args, capabilities) => {
-      const { buildDirectorContext } = await import("./context-KNFL62QR.js");
+      const { buildDirectorContext } = await import("./context-YNR73FNI.js");
       return buildDirectorContext(capabilities);
     }
   },

package/dist/{chunk-5YO4LAB7.js → chunk-CFIQY4OE.js}

@@ -312,7 +312,7 @@ Call wait_job(kind="compose", id="${j.composeJobId}", projectId="${a.projectId}"
     name: "apply_composition",
     operationId: "applyComposition",
     pathArgs: { projectId: "id" },
-    description: 'Atomically apply an array of CompositionOps to a project composition. All ops succeed or none do (transactional). Pass `if_match` for optimistic-concurrency control (409 stale_etag on mismatch) and `dry_run: true` to validate the batch without persisting. Ops land on the project\'s ACTIVE composition unless you pass `composition_id` (mutually exclusive with `session_id`), which targets a specific one \u2014 that is how you author a second composition minted with new_composition and run an A/B. Use this to seed a composition (add media clips) or make targeted edits (set a crop intent, reorder clips, set the format). CAPTIONS: attach content with {type:"captions.fromTranscript", mediaId, window?} \u2014 the server slices the cached word-timed transcript, rebases times, and sentence-splits into segments (no pasting words; 422 media_no_transcript if the media has no speech); style it with {type:"setCaptionStyle", style}; or set explicit words with {type:"setCaptions", segments, style?} (e.g. translations or your own VO timings). Brand is NOT set here \u2014 it lives on the project (create_project / update_project with brandKitId \u2014 or PATCH /projects/:id over REST). CARDS: a {kind:"card", html, tokens} clip projects each `tokens` KEY `x` to the CSS custom property `--cf-x`, so the html must read it as `var(--cf-x)` \u2014 write `tokens:{"plate":"#0af"}` + `background:var(--cf-plate)`. Do NOT put dashes in the key: `"--plate"` becomes `--cf---plate` and your `var(--plate)` then resolves to NOTHING, which CSS silently degrades to a transparent background and black text. Responses carry `warnings[]` when a card reads a var nothing defines. SCENE SHOTS: for a 3D product shot \u2014 a tilted page screenshot, a lit laptop/phone showing a real screenshot, two-colour type, a colour-field backdrop, focus/grain/vignette and a camera move \u2014 use {type:"scene.add", clipId, newTrack|trackId, startTime, duration, scene, assets} and revise it with {type:"scene.update", clipId, scene?, assets?, startTime?, duration?}. You author a scene SPEC, never wrapper TSX; the server registers the component for you. There is NO built-in scene primitive in list_catalog \u2014 READ cueframe://scene-shot first for the JSON schema, the canonical V2 world-objects recipe with nested groups, slabs, pages, phones, laptops, world/screen text, admitted surfaces, camera motion, lighting, and the current resource limits.',
+    description: 'Atomically apply an array of CompositionOps to a project composition. All ops succeed or none do (transactional). Call describe_composition_ops without type for the compact operation list, then with a type for its exact JSON Schema. Pass `if_match` for optimistic-concurrency control (409 stale_etag on mismatch) and `dry_run: true` to validate the batch without persisting. Ops land on the project\'s ACTIVE composition unless you pass `composition_id` (mutually exclusive with `session_id`), which targets a specific one \u2014 that is how you author a second composition minted with new_composition and run an A/B. Use this to seed a composition (add media clips) or make targeted edits (set a crop intent, reorder clips, set the format). CAPTIONS FOR EDITED TIMELINES: after saving all clip edits, call again with {type:"captions.fromComposition", trackId} to build captions from every audible clip on that track, honoring trims, exclusions and placement. Clips must have duration matching playable source duration divided by playbackRate; unsupported timing fails explicitly. Re-run it after later timeline edits; captions do not update automatically. {type:"captions.fromTranscript", mediaId, window?} instead replaces all captions from one media transcript, rebased to zero; it does not follow a montage. Style with {type:"setCaptionStyle", style}; or set explicit words with {type:"setCaptions", segments, style?} (e.g. translations or your own VO timings). Brand is NOT set here \u2014 it lives on the project (create_project / update_project with brandKitId \u2014 or PATCH /projects/:id over REST). CARDS: a {kind:"card", html, tokens} clip projects each `tokens` KEY `x` to the CSS custom property `--cf-x`, so the html must read it as `var(--cf-x)` \u2014 write `tokens:{"plate":"#0af"}` + `background:var(--cf-plate)`. Do NOT put dashes in the key: `"--plate"` becomes `--cf---plate` and your `var(--plate)` then resolves to NOTHING, which CSS silently degrades to a transparent background and black text. Responses carry `warnings[]` when a card reads a var nothing defines. SCENE SHOTS: for a 3D product shot \u2014 a tilted page screenshot, a lit laptop/phone showing a real screenshot, two-colour type, a colour-field backdrop, focus/grain/vignette and a camera move \u2014 use {type:"scene.add", clipId, newTrack|trackId, startTime, duration, scene, assets} and revise it with {type:"scene.update", clipId, scene?, assets?, startTime?, duration?}. You author a scene SPEC, never wrapper TSX; the server registers the component for you. There is NO built-in scene primitive in list_catalog \u2014 READ cueframe://scene-shot first for the JSON schema, the canonical V2 world-objects recipe with nested groups, slabs, pages, phones, laptops, world/screen text, admitted surfaces, camera motion, lighting, and the current resource limits.',
     okFormat: (j, a) => {
       const warns = formatWarnings(j);
       if (j && typeof j.valid === "boolean") {

package/dist/{chunk-GOJKL5FM.js → chunk-DV7ZFVL4.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-OSMXQV5V.js";
 import {
   CueframeError
-} from "./chunk-XWOV6KI6.js";
+} from "./chunk-E63UEO5C.js";
 
 // ../execution/render-harness/src/cardAssetAdmission.ts
 import parseCss from "css-tree/parser";

package/dist/{chunk-XWOV6KI6.js → chunk-E63UEO5C.js}

@@ -229,8 +229,10 @@ var ERROR_CODES = {
   // for. None of that is the author's doing and none of it is visible to them,
   // so it stays a platform fault we see in Sentry.
   component_output_unverifiable: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },
-  // Two ways a bake dies without a diagnostic of its own. The sandbox ran out of
-  // memory: the same bake on a larger box can succeed, so it is worth one retry.
+  // Two ways a bake dies without a diagnostic of its own. Both are raised as
+  // workflow failures by the host, never as a ComponentRuntimeError, so they are
+  // deliberately absent from COMPONENT_RUNTIME_ERROR_CODES. The sandbox ran out
+  // of memory: the same bake on a larger box can succeed, so it is worth one retry.
   sandbox_oom: { stage: "render", category: "internal", retryable: true, httpStatus: 503 },
   // The bake process died leaving nothing to read. Retrying reproduces it, so it
   // is ours to diagnose from the run, not the caller's to wait out.
@@ -239,6 +241,9 @@ var ERROR_CODES = {
   component_scene_invalid: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   motion_preset_unknown: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   motion_preset_target_invalid: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  caption_track_invalid: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  caption_clip_unsupported: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  caption_clips_overlap: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   grid_target_invalid: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   grid_unavailable: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   shot_grid_unavailable: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
@@ -512,6 +517,7 @@ export {
   encodeError,
   decodeError,
   scrubSensitive,
+  DEFAULT_RETRY_AFTER_SECONDS,
   retryAfterSecondsFor,
   toWireEnvelope
 };

package/dist/{chunk-ZXWSZUSU.js → chunk-FEG264CF.js}

@@ -20,11 +20,11 @@ import {
   scoreAndRank,
   segmentShots,
   stabilizeSelectionHysteresis
-} from "./chunk-V7LQ7ZHV.js";
+} from "./chunk-JPMVNMF3.js";
 import {
   flattenCompoundClips,
   hasCompoundClips
-} from "./chunk-QISFYLBB.js";
+} from "./chunk-IMIUHG2E.js";
 import {
   compositionHasVo,
   roleDefaultGainDb
@@ -36,7 +36,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-XWOV6KI6.js";
+} from "./chunk-E63UEO5C.js";
 import {
   SCENE_CAPTURE_IDENTITY_FIELDS_V1,
   SCENE_PRESET_TRIANGLES,
@@ -1342,6 +1342,38 @@ function playableSpans(trimStart, trimEnd, excluded) {
   if (cursor < trimEnd) out.push({ start: cursor, end: trimEnd });
   return out;
 }
+function projectMediaPlaybackSpans({
+  startTime,
+  duration,
+  trim,
+  excludedRanges,
+  playbackRate = 1,
+  fps
+}) {
+  const trimStart = trim?.start ?? 0;
+  const trimEnd = trim?.end ?? trimStart + duration * playbackRate;
+  let playedSourceSeconds = 0;
+  return playableSpans(trimStart, trimEnd, excludedRanges).map((span) => {
+    const timelineStart = startTime + playedSourceSeconds / playbackRate;
+    playedSourceSeconds += span.end - span.start;
+    const timelineEnd = startTime + playedSourceSeconds / playbackRate;
+    const { startFrame: timelineStartFrames, durationInFrames } = timelineSpanFrames(
+      timelineStart,
+      timelineEnd,
+      fps
+    );
+    return {
+      sourceStart: span.start,
+      sourceEnd: span.end,
+      timelineStart,
+      timelineEnd,
+      sourceInFrames: frames(span.start, fps),
+      sourceOutFrames: frames(span.end, fps),
+      timelineStartFrames,
+      durationInFrames
+    };
+  });
+}
 function projectMediaTrack(track, trackIndex, trackCount, fps, srcUrls, trajectoryUrls, coViewUrls, trajectories) {
   const clips = [];
   const audio = [];
@@ -1365,7 +1397,6 @@ function projectMediaTrack(track, trackIndex, trackCount, fps, srcUrls, trajecto
     const packedUrl = coViewUrls?.[c.id];
     const packedEnvelopeFields = packedUrl === void 0 ? [] : [
       c.region !== void 0 && !(c.region.x === 0 && c.region.y === 0 && c.region.w === 1 && c.region.h === 1) ? "region" : null,
-      c.fit !== void 0 && c.fit !== "cover" ? "fit" : null,
       c.opacity !== void 0 && c.opacity !== 1 ? "opacity" : null,
       c.scale !== void 0 && c.scale !== 1 ? "scale" : null,
       c.rotation !== void 0 && c.rotation !== 0 ? "rotation" : null,
@@ -1384,33 +1415,31 @@ function projectMediaTrack(track, trackIndex, trackCount, fps, srcUrls, trajecto
         }
       );
     }
+    const spans = projectMediaPlaybackSpans({
+      startTime: c.startTime,
+      duration: c.duration,
+      trim: c.source.trim,
+      excludedRanges: c.source.excludedRanges,
+      playbackRate: c.source.playbackRate,
+      fps
+    });
     if (track.kind === "audio") {
-      const trimStart2 = c.source.trim?.start ?? 0;
-      const trimEnd2 = c.source.trim?.end ?? trimStart2 + c.duration;
-      const spans2 = playableSpans(trimStart2, trimEnd2, c.source.excludedRanges);
       const resolvedVolume = (c.source.volumeDb !== void 0 ? Math.pow(10, c.source.volumeDb / 20) : c.source.volume ?? 1) * (track.volume ?? 1);
       const fadeInFrames = c.source.fadeInMs !== void 0 ? Math.max(0, Math.round(c.source.fadeInMs / 1e3 * fps)) : void 0;
       const fadeOutFrames = c.source.fadeOutMs !== void 0 ? Math.max(0, Math.round(c.source.fadeOutMs / 1e3 * fps)) : void 0;
-      let playedSec2 = 0;
-      for (let s = 0; s < spans2.length; s++) {
-        const span = spans2[s];
-        const spanStartSec = c.startTime + playedSec2;
-        playedSec2 += span.end - span.start;
-        const { startFrame, durationInFrames: subDurationFrames } = timelineSpanFrames(
-          spanStartSec,
-          c.startTime + playedSec2,
-          fps
-        );
+      for (let s = 0; s < spans.length; s++) {
+        const span = spans[s];
+        const { timelineStartFrames: startFrame, durationInFrames: subDurationFrames } = span;
         if (subDurationFrames === 0) continue;
-        const sourceInFrames = frames(span.start, fps);
         audio.push({
-          id: spans2.length === 1 ? c.id : `${c.id}#${s}`,
+          id: spans.length === 1 ? c.id : `${c.id}#${s}`,
           src,
-          sourceInFrames,
-          sourceOutFrames: sourceInFrames + subDurationFrames,
+          sourceInFrames: span.sourceInFrames,
+          sourceOutFrames: span.sourceOutFrames,
           startFrame,
           durationInFrames: subDurationFrames,
           volume: resolvedVolume,
+          ...c.source.playbackRate !== void 0 ? { playbackRate: c.source.playbackRate } : {},
           ...fadeInFrames !== void 0 ? { fadeInFrames } : {},
           ...fadeOutFrames !== void 0 ? { fadeOutFrames } : {},
           ...c.source.loop !== void 0 ? { loop: c.source.loop } : {}
@@ -1418,18 +1447,11 @@ function projectMediaTrack(track, trackIndex, trackCount, fps, srcUrls, trajecto
       }
       continue;
     }
-    const trimStart = c.source.trim?.start ?? 0;
-    const trimEnd = c.source.trim?.end ?? trimStart + c.duration;
-    const spans = playableSpans(trimStart, trimEnd, c.source.excludedRanges);
     let firstEmittedSubId;
-    let playedSec = 0;
     for (let s = 0; s < spans.length; s++) {
       const span = spans[s];
-      const spanStartSec = c.startTime + playedSec;
-      playedSec += span.end - span.start;
-      const { startFrame: timelineCursorFrames, durationInFrames: subDurationFrames } = timelineSpanFrames(spanStartSec, c.startTime + playedSec, fps);
+      const { timelineStartFrames: timelineCursorFrames, durationInFrames: subDurationFrames } = span;
       if (subDurationFrames === 0) continue;
-      const sourceInFrames = frames(span.start, fps);
       const subId = spans.length === 1 ? c.id : `${c.id}#${s}`;
       if (firstEmittedSubId === void 0) firstEmittedSubId = subId;
       clips.push({
@@ -1437,11 +1459,11 @@ function projectMediaTrack(track, trackIndex, trackCount, fps, srcUrls, trajecto
         id: subId,
         ...spans.length > 1 ? { parentId: c.id } : {},
         src,
-        sourceInFrames,
-        sourceOutFrames: sourceInFrames + subDurationFrames,
+        sourceInFrames: span.sourceInFrames,
+        sourceOutFrames: span.sourceOutFrames,
         timelineStartFrames: timelineCursorFrames,
         durationInFrames: subDurationFrames,
-        trimStartFrames: frames(trimStart, fps),
+        trimStartFrames: frames(c.source.trim?.start ?? 0, fps),
         ...c.source.playbackRate !== void 0 ? { playbackRate: c.source.playbackRate } : {},
         ...c.source.volume !== void 0 ? { volume: c.source.volume } : {},
         ...c.source.muted !== void 0 ? { muted: c.source.muted } : {},
@@ -2952,6 +2974,7 @@ export {
   validateComposition,
   assertBehindSubjectCaptionCoverage,
   playableSpans,
+  projectMediaPlaybackSpans,
   compositionFormatDimensions,
   referencedMediaIds,
   compositionToRenderInput,

package/dist/{chunk-OASSDEWY.js → chunk-FGJ7GKWZ.js}

@@ -6,7 +6,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-XWOV6KI6.js";
+} from "./chunk-E63UEO5C.js";
 
 // ../composition/src/projection/cardTokens.ts
 var CARD_MOTION_VAR_NAMES = [
@@ -454,17 +454,17 @@ function resolveSegmentAt(traj, srcFrame) {
   }
   return { seg: best, inSegIdx: Math.max(0, Math.min(bestInIdx, best.centers.length - 1)) };
 }
-function outputToTrajectoryFrame(sections, trimStartFrames, outFrame, srcFps, fps) {
+function outputToTrajectoryFrame(sections, trimStartFrames, outFrame, srcFps, fps, playbackRate = 1) {
   let cum = 0;
   for (const s of sections) {
     if (outFrame < cum + s.durationInFrames) {
-      const clipFramesAtFps2 = s.sourceInFrames - trimStartFrames + (outFrame - cum);
+      const clipFramesAtFps2 = s.sourceInFrames - trimStartFrames + (outFrame - cum) * playbackRate;
       return Math.round(clipFramesAtFps2 * srcFps / fps);
     }
     cum += s.durationInFrames;
   }
   const last = sections[sections.length - 1];
-  const clipFramesAtFps = last.sourceInFrames - trimStartFrames + (last.durationInFrames - 1);
+  const clipFramesAtFps = last.sourceInFrames - trimStartFrames + (last.durationInFrames - 1) * playbackRate;
   return Math.round(clipFramesAtFps * srcFps / fps);
 }
 function computeCropTransform(input) {
@@ -519,13 +519,13 @@ function sourceRectToOutput(src, t, outW, outH) {
   };
 }
 function buildSubjectsOutput(args) {
-  const { traj, sections, trimStartFrames, durationInFrames, outW, outH, fps } = args;
+  const { traj, sections, trimStartFrames, durationInFrames, outW, outH, fps, playbackRate = 1 } = args;
   const series = /* @__PURE__ */ new Map();
   const activeBySubject = /* @__PURE__ */ new Map();
   const order = [];
   const emptySeries = () => Array(durationInFrames).fill(null);
   for (let f = 0; f < durationInFrames; f++) {
-    const srcFrame = outputToTrajectoryFrame(sections, trimStartFrames, f, traj.src_fps, fps);
+    const srcFrame = outputToTrajectoryFrame(sections, trimStartFrames, f, traj.src_fps, fps, playbackRate);
     const { seg, inSegIdx } = resolveSegmentAt(traj, srcFrame);
     const [cx, cy] = seg.centers[inSegIdx];
     const transform = computeCropTransform({

package/dist/{chunk-SPF3AXTB.js → chunk-FYS2XUKJ.js}

@@ -1,7 +1,7 @@
 import {
   bodySchemaFor,
   opById
-} from "./chunk-46PFSJZE.js";
+} from "./chunk-AOIY7NGF.js";
 
 // ../mcp/src/generated/sceneContract.ts
 function deepFreeze(value) {

package/dist/{chunk-QISFYLBB.js → chunk-IMIUHG2E.js}

@@ -1,7 +1,7 @@
 import {
   InvariantError,
   isSourceKindCompatible
-} from "./chunk-DENF4TPI.js";
+} from "./chunk-T56BK7NS.js";
 import {
   expandClipIdsToLinkGroups,
   linkPartners

package/dist/{chunk-V7LQ7ZHV.js → chunk-JPMVNMF3.js}

@@ -1,7 +1,7 @@
 import {
   CueframeError,
   encodeError
-} from "./chunk-XWOV6KI6.js";
+} from "./chunk-E63UEO5C.js";
 
 // ../execution/core/src/render/vcam/constants.ts
 var P_MIN = 0.5;