@cueframe/kernel 0.2.44 → 0.2.46

package/dist/{chunk-KKHI5NLK.js → chunk-N54EGUVM.js}

@@ -9,7 +9,7 @@ import {
 import {
   decodeError,
   scrubSensitive
-} from "./chunk-XWOV6KI6.js";
+} from "./chunk-E63UEO5C.js";
 
 // ../director/src/domain/chat.ts
 import { z } from "zod";

package/dist/{chunk-WYRKF2OX.js → chunk-Q5P5UFOP.js}

@@ -52,7 +52,7 @@ var PREVIEW_FRAME_CASES = [
   },
   {
     name: "an unrecognised body key is refused",
-    why: "The published `previewFrameBody` ends `.strict()` and SDK + MCP clients enforce it; a server looser than its own spec is the divergence. Both lanes now run the strict schema, so a typo like `timestamp` or `dryRun` is a 400 everywhere.",
+    why: "The published `PreviewFrameJobBody` ends `.strict()` and SDK + MCP clients enforce it; a server looser than its own spec is the divergence. Both lanes now run the strict schema, so a typo like `timestamp` or `dryRun` is a 400 everywhere.",
     body: { timestamps: [1], nonsenseKey: true },
     expect: { status: 400, code: "validation_error" }
   }

package/dist/{chunk-ZUJCWFS7.js → chunk-SLUTOUWI.js}

@@ -2,7 +2,7 @@ import {
   selectAllClips,
   selectAllOverlays,
   selectSceneMarkers
-} from "./chunk-POTCIQTA.js";
+} from "./chunk-VEQTURKN.js";
 
 // ../authoring/src/context/transcript.ts
 var MAX_TRANSCRIPT_CHARS = 6e4;

package/dist/{chunk-DENF4TPI.js → chunk-T56BK7NS.js}

@@ -101,7 +101,8 @@ function checkExcludedRanges(track) {
     if (!ranges || ranges.length === 0) continue;
     const trim = content.source.trim;
     const trimStart = trim?.start ?? 0;
-    const trimEnd = trim?.end ?? trimStart + content.duration;
+    const rate = content.source.playbackRate ?? 1;
+    const trimEnd = trim?.end ?? trimStart + content.duration * rate;
     let prevEnd = -Infinity;
     let total = 0;
     let earlyExit = false;
@@ -159,18 +160,19 @@ function checkExcludedRanges(track) {
     }
     if (earlyExit) continue;
     const trimSpan = trimEnd - trimStart;
-    const expectedDuration = trimSpan - total;
+    const expectedDuration = (trimSpan - total) / rate;
     if (Math.abs(expectedDuration - content.duration) > 1e-3) {
       violations.push({
         code: "excluded_range_duration_mismatch",
-        message: `Track ${track.id}: TimelineClip ${content.id} duration (${content.duration}) \u2260 trimSpan (${trimSpan}) \u2212 \u03A3excluded (${total}) = ${expectedDuration}`,
+        message: `Track ${track.id}: TimelineClip ${content.id} duration (${content.duration}) \u2260 (trimSpan (${trimSpan}) \u2212 \u03A3excluded (${total})) \xF7 playbackRate (${rate}) = ${expectedDuration}`,
         details: {
           trackId: track.id,
           clipId: content.id,
           expected: expectedDuration,
           actual: content.duration,
           trimSpan,
-          totalExcluded: total
+          totalExcluded: total,
+          playbackRate: rate
         }
       });
     }

package/dist/{chunk-B4VMU2IJ.js → chunk-TBHSOEYK.js}

@@ -1,6 +1,6 @@
 import {
   checkTracks
-} from "./chunk-DENF4TPI.js";
+} from "./chunk-T56BK7NS.js";
 
 // ../composition/src/invariants/etag.ts
 import { sha256 } from "@noble/hashes/sha256";

package/dist/{chunk-POTCIQTA.js → chunk-VEQTURKN.js}

@@ -48,12 +48,44 @@ function findMarkerById(composition, id) {
   }
   return void 0;
 }
-function trimSourceFor(source, clipRelStart, clipRelEnd) {
+function trimSourceFor(source, clipRelStart, clipRelEnd, clipDuration) {
   if (source.kind !== "media") return source;
   const baseStart = source.trim?.start ?? 0;
+  const rate = source.playbackRate ?? 1;
+  const excluded = source.excludedRanges ?? [];
+  const excludedDuration = excluded.reduce((sum, range) => sum + range.end - range.start, 0);
+  const baseEnd = source.trim?.end ?? baseStart + clipDuration * rate + excludedDuration;
+  const playable = [];
+  let cursor = baseStart;
+  for (const range of excluded) {
+    if (range.start > cursor) playable.push({ start: cursor, end: range.start });
+    cursor = Math.max(cursor, range.end);
+  }
+  if (cursor < baseEnd) playable.push({ start: cursor, end: baseEnd });
+  const sourceAt = (outputSeconds, edge) => {
+    let remaining = outputSeconds * rate;
+    for (let i = 0; i < playable.length; i++) {
+      const span = playable[i];
+      const length = span.end - span.start;
+      if (remaining < length - 1e-9) return span.start + remaining;
+      if (Math.abs(remaining - length) <= 1e-9) {
+        return edge === "start" && playable[i + 1] ? playable[i + 1].start : span.end;
+      }
+      remaining -= length;
+    }
+    return baseEnd;
+  };
+  const start = sourceAt(clipRelStart, "start");
+  const end = sourceAt(clipRelEnd, "end");
+  const retained = excluded.flatMap((range) => {
+    const clippedStart = Math.max(range.start, start);
+    const clippedEnd = Math.min(range.end, end);
+    return clippedEnd > clippedStart ? [{ ...range, start: clippedStart, end: clippedEnd }] : [];
+  });
   return {
     ...source,
-    trim: { start: baseStart + clipRelStart, end: baseStart + clipRelEnd }
+    trim: { start, end },
+    ...retained.length > 0 ? { excludedRanges: retained } : { excludedRanges: void 0 }
   };
 }
 function cutTimedRange(start, end, cutStart, cutEnd) {
@@ -234,7 +266,11 @@ function createCompositionOps(get, set) {
         const oldRate = clip.source.playbackRate ?? 1;
         if (props.playbackRate !== oldRate) {
           const trim = clip.source.trim;
-          const sourceDuration = trim ? trim.end - trim.start : clip.duration * oldRate;
+          const excludedDuration = clip.source.excludedRanges?.reduce(
+            (sum, range) => sum + range.end - range.start,
+            0
+          ) ?? 0;
+          const sourceDuration = trim ? trim.end - trim.start - excludedDuration : clip.duration * oldRate;
           const newDuration = sourceDuration / props.playbackRate;
           const oldEnd = clip.startTime + clip.duration;
           const delta = newDuration - clip.duration;
@@ -252,6 +288,16 @@ function createCompositionOps(get, set) {
         if (props.fit !== void 0) target.fit = props.fit;
         if (rateChange) {
           if (target.source.kind === "media") {
+            if (!target.source.trim && target.source.excludedRanges?.length) {
+              const excludedDuration = target.source.excludedRanges.reduce(
+                (sum, range) => sum + range.end - range.start,
+                0
+              );
+              target.source.trim = {
+                start: 0,
+                end: target.duration * (target.source.playbackRate ?? 1) + excludedDuration
+              };
+            }
             target.source.playbackRate = rateChange.newRate;
           }
           target.duration = rateChange.newDuration;
@@ -421,7 +467,7 @@ function createCompositionOps(get, set) {
             }
             if (cs < start) {
               const leftDuration = start - cs;
-              const leftSource = trimSourceFor(c.source, 0, leftDuration);
+              const leftSource = trimSourceFor(c.source, 0, leftDuration, c.duration);
               next.push({ ...c, id: c.id, duration: leftDuration, source: leftSource });
             }
             if (ce > end) {
@@ -430,7 +476,8 @@ function createCompositionOps(get, set) {
               const rightSource = trimSourceFor(
                 c.source,
                 sourceOffsetIntoOriginal,
-                sourceOffsetIntoOriginal + rightDuration
+                sourceOffsetIntoOriginal + rightDuration,
+                c.duration
               );
               next.push({
                 ...c,
@@ -472,7 +519,7 @@ function createCompositionOps(get, set) {
         const before = target.source.excludedRanges ?? [];
         const beforeTotal = before.reduce((acc, r) => acc + (r.end - r.start), 0);
         const trimStart = target.source.trim?.start ?? 0;
-        const trimEnd = target.source.trim?.end ?? trimStart + target.duration + beforeTotal;
+        const trimEnd = target.source.trim?.end ?? trimStart + target.duration * (target.source.playbackRate ?? 1) + beforeTotal;
         const lo = Math.max(sourceStart, trimStart);
         const hi = Math.min(sourceEnd, trimEnd);
         if (!(hi > lo)) return;
@@ -510,9 +557,12 @@ function createCompositionOps(get, set) {
           });
         }
         const afterTotal = merged.reduce((acc, r) => acc + (r.end - r.start), 0);
-        const delta = afterTotal - beforeTotal;
-        if (delta <= 0) return;
+        const addedSourceDuration = afterTotal - beforeTotal;
+        if (addedSourceDuration <= 0) return;
+        const rate = target.source.playbackRate ?? 1;
+        const delta = addedSourceDuration / rate;
         if (target.duration - delta <= 1e-3) return;
+        if (!target.source.trim) target.source.trim = { start: trimStart, end: trimEnd };
         target.source.excludedRanges = merged;
         target.duration = target.duration - delta;
         for (let i = found.clipIndex + 1; i < track.contents.length; i++) {
@@ -522,7 +572,7 @@ function createCompositionOps(get, set) {
           (acc, r) => acc + Math.max(0, Math.min(r.end, lo) - Math.max(r.start, trimStart)),
           0
         );
-        const tStart = target.startTime + (lo - trimStart) - excludedBeforeLo;
+        const tStart = target.startTime + (lo - trimStart - excludedBeforeLo) / rate;
         const tEnd = tStart + delta;
         if (draft.composition.markers) {
           draft.composition.markers = draft.composition.markers.flatMap((m) => {
@@ -551,9 +601,19 @@ function createCompositionOps(get, set) {
         const ranges = target.source.excludedRanges;
         if (!ranges || rangeIdx < 0 || rangeIdx >= ranges.length) return;
         const removed = ranges[rangeIdx];
-        const restored = removed.end - removed.start;
+        const restored = (removed.end - removed.start) / (target.source.playbackRate ?? 1);
         if (restored <= 0) return;
+        const trimStart = target.source.trim?.start ?? 0;
+        const excludedBefore = ranges.reduce((sum, range, index) => index === rangeIdx ? sum : sum + Math.max(0, Math.min(range.end, removed.start) - Math.max(range.start, trimStart)), 0);
+        const insertAt = target.startTime + (removed.start - trimStart - excludedBefore) / (target.source.playbackRate ?? 1);
         const next = ranges.filter((_, i) => i !== rangeIdx);
+        if (!target.source.trim) {
+          const totalExcluded = ranges.reduce((sum, range) => sum + range.end - range.start, 0);
+          target.source.trim = {
+            start: 0,
+            end: target.duration * (target.source.playbackRate ?? 1) + totalExcluded
+          };
+        }
         if (next.length === 0) {
           delete target.source.excludedRanges;
         } else {
@@ -563,6 +623,24 @@ function createCompositionOps(get, set) {
         for (let i = found.clipIndex + 1; i < track.contents.length; i++) {
           track.contents[i].startTime = track.contents[i].startTime + restored;
         }
+        for (const marker of draft.composition.markers ?? []) {
+          const shifted = shiftTimedRange(marker.startTime, marker.endTime, insertAt, restored);
+          if (shifted) {
+            marker.startTime = shifted.start;
+            if (shifted.end !== void 0) marker.endTime = shifted.end;
+          }
+        }
+        if (draft.composition.captions) {
+          for (const segment of draft.composition.captions.segments) {
+            for (const word of segment.words) {
+              const shifted = shiftTimedRange(word.startMs, word.endMs, insertAt * 1e3, restored * 1e3);
+              if (shifted) {
+                word.startMs = shifted.start;
+                word.endMs = shifted.end ?? word.endMs;
+              }
+            }
+          }
+        }
       });
     },
     setCropIntents: (clipId, segments) => {
@@ -622,7 +700,8 @@ function createCompositionOps(get, set) {
           ...Object.fromEntries(Object.entries(style).filter(([, v]) => v !== void 0))
         } : existing?.style;
         const styleField = mergedStyle && Object.keys(mergedStyle).length > 0 ? { style: mergedStyle } : {};
-        draft.composition.captions = derivedFrom ? { source: "derived", from: derivedFrom, segments, ...styleField } : { source: "authored", segments, ...styleField };
+        const depthField = existing?.zPlane ? { zPlane: existing.zPlane } : {};
+        draft.composition.captions = derivedFrom ? { source: "derived", from: derivedFrom, segments, ...styleField, ...depthField } : { source: "authored", segments, ...styleField, ...depthField };
       });
     },
     ripple: (time, amount) => {

package/dist/{chunk-YIJZBLQE.js → chunk-W5AFGFVZ.js}

@@ -36,7 +36,7 @@ var PreviewFrameRequest = z.object({
   jpegQuality: z.number().int().min(1).max(100).optional().describe(
     "JPEG quality (jpeg only). Default 70 \u2014 the quality the eval panel grades at."
   )
-  // The published `previewFrameBody` is a strictObject and every generated
+  // The published `PreviewFrameJobBody` is a strictObject and every generated
   // client enforces it. A server looser than its own spec accepted `timestamp`
   // or `dryRun` and rendered the default instead (plane conformance).
 }).strict();
@@ -47,15 +47,30 @@ var DesktopPreviewFrameRequest = PreviewFrameRequest.pick({
   jpegQuality: true
 }).strict();
 var CLIENT_HEADER = "X-CueFrame-Client";
-var CLIENT_SURFACES = ["studio", "web", "console", "cli", "mcp"];
+var CLIENT_SURFACES = [
+  "studio",
+  "web",
+  "console",
+  "clips",
+  "cli",
+  "mcp",
+  "director"
+];
 var CLIENT_OSES = ["macos", "windows", "linux", "browser", "unknown"];
 var CLIENT_VERSION = /^[A-Za-z0-9][A-Za-z0-9._+-]{0,31}$/;
+var BROWSER_SURFACES = ["web", "console", "clips"];
+function clientPairIsPossible(surface, os) {
+  return BROWSER_SURFACES.includes(surface) === (os === "browser");
+}
 function formatClientHeader(client) {
   if (!CLIENT_VERSION.test(client.version)) {
     throw new Error(
       `${CLIENT_HEADER} cannot carry the version ${JSON.stringify(client.version)}.`
     );
   }
+  if (!clientPairIsPossible(client.surface, client.os)) {
+    throw new Error(`${CLIENT_HEADER} cannot carry ${client.surface} on ${client.os}.`);
+  }
   return `${client.surface}/${client.version}/${client.os}`;
 }
 function parseClientHeader(value) {
@@ -65,6 +80,7 @@ function parseClientHeader(value) {
   if (!CLIENT_SURFACES.includes(surface)) return null;
   if (!CLIENT_OSES.includes(os)) return null;
   if (!CLIENT_VERSION.test(version)) return null;
+  if (!clientPairIsPossible(surface, os)) return null;
   return { surface, version, os };
 }
 function osFromNodePlatform(platform) {
@@ -79,6 +95,9 @@ function osFromUserAgent(agent) {
   if (/Linux|X11|CrOS/.test(agent)) return "linux";
   return "unknown";
 }
+function clientOs(surface, agent) {
+  return surface === "studio" ? osFromUserAgent(agent) : "browser";
+}
 
 export {
   STILL_BUDGET_BASE_S,
@@ -95,8 +114,10 @@ export {
   CLIENT_HEADER,
   CLIENT_SURFACES,
   CLIENT_OSES,
+  clientPairIsPossible,
   formatClientHeader,
   parseClientHeader,
   osFromNodePlatform,
-  osFromUserAgent
+  osFromUserAgent,
+  clientOs
 };

package/dist/{chunk-WKT7SEVP.js → chunk-WWXTJZ67.js}

@@ -1,7 +1,7 @@
 import {
   CLIENT_HEADER,
   formatClientHeader
-} from "./chunk-YIJZBLQE.js";
+} from "./chunk-W5AFGFVZ.js";
 
 // ../mcp/src/executor.ts
 var API_URLS = {
@@ -87,13 +87,15 @@ function requestIdempotencyKey(prefix, content, idempotent) {
   const identity = idempotent ? content : `${content}|${freshInvocationNonce()}`;
   return `${prefix}-${fnv1a(identity)}`;
 }
-function makePlatformExecutor(baseUrl, deployKey, orgId, opts) {
+function makePlatformExecutor(baseUrl, deployKey, orgId, client, opts) {
+  const clientHeader = formatClientHeader(client);
   return {
     async invoke({ method, path, body, query, idempotent }) {
       const url = `${baseUrl}${path}${query ? `?${query}` : ""}`;
       const headers = {
         "x-deploy-key": deployKey,
         "x-org-id": orgId,
+        [CLIENT_HEADER]: clientHeader,
         ...opts?.actingUserId ? { "x-acting-user-id": opts.actingUserId } : {}
       };
       if (method !== "GET" && method !== "HEAD") {

package/dist/{chunk-OZNULDQE.js → chunk-XSBVOXSB.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-46PFSJZE.js";
+} from "./chunk-AOIY7NGF.js";
 
 // ../mcp/src/wait.ts
 var defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));

package/dist/{chunk-FRNBTODO.js → chunk-Z4G3VM3H.js}

@@ -1,7 +1,7 @@
 import {
   ChatErrorView,
   DirectorTurnContext
-} from "./chunk-KKHI5NLK.js";
+} from "./chunk-N54EGUVM.js";
 import {
   GenerationArtifact
 } from "./chunk-73DQTUWY.js";

package/dist/compose.js

@@ -54,7 +54,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-XWOV6KI6.js";
+} from "./chunk-E63UEO5C.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-CL5Y6V6K.js";
 import "./chunk-2L7PYYJK.js";

package/dist/composition/invariants.js

@@ -11,7 +11,7 @@ import {
   otioFrames,
   otioRationalTime,
   sourceFrame
-} from "../chunk-B4VMU2IJ.js";
+} from "../chunk-TBHSOEYK.js";
 import {
   InvariantError,
   checkClipDurationMatchesTrim,
@@ -22,7 +22,7 @@ import {
   checkTracks,
   checkTransitions,
   isSourceKindCompatible
-} from "../chunk-DENF4TPI.js";
+} from "../chunk-T56BK7NS.js";
 import "../chunk-2ESYSVXG.js";
 export {
   InvariantError,

package/dist/composition/ops.js

@@ -20,7 +20,7 @@ import {
   selectMediaClipAt,
   selectSceneMarkers,
   selectTracksByKind
-} from "../chunk-POTCIQTA.js";
+} from "../chunk-VEQTURKN.js";
 import "../chunk-AG7HKF2U.js";
 import "../chunk-ID5QY7V6.js";
 import "../chunk-WPZKOVYF.js";

package/dist/composition/projection.js

@@ -32,7 +32,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "../chunk-OASSDEWY.js";
+} from "../chunk-FGJ7GKWZ.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -74,7 +74,7 @@ import {
   contrastRatio
 } from "../chunk-ILO4NEZ3.js";
 import "../chunk-VG2ND6PX.js";
-import "../chunk-XWOV6KI6.js";
+import "../chunk-E63UEO5C.js";
 import "../chunk-AVTEPAWI.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/composition/timeline.js

@@ -26,8 +26,8 @@ import {
   trackKindForSource,
   trimForSubRange,
   valueAt
-} from "../chunk-QISFYLBB.js";
-import "../chunk-DENF4TPI.js";
+} from "../chunk-IMIUHG2E.js";
+import "../chunk-T56BK7NS.js";
 import {
   expandClipIdsToLinkGroups,
   expandToLinkGroup,