@cueframe/kernel 0.1.1 → 0.1.2

package/dist/{chunk-ZWMV6DD2.js → chunk-ICSZF37W.js}

@@ -3,15 +3,13 @@ import {
 } from "./chunk-KYRDKK2D.js";
 import {
   Composition
-} from "./chunk-PODIYN2K.js";
+} from "./chunk-WZH57M53.js";
 
-// ../composition/src/ops/compositionOps.ts
+// ../composition/src/ops/compositionOps.shared.ts
 function findOrCreateTrackByKind(composition, kind) {
   const existing = composition.tracks.find((t) => t.kind === kind);
   if (existing) return existing;
   const track = {
-    // UUID suffix avoids id collisions when a track of `kind` is created,
-    // deleted, then re-created at the same `tracks.length` index.
     id: `track-${kind}-${crypto.randomUUID().slice(0, 8)}`,
     kind,
     contents: []
@@ -71,8 +69,11 @@ function cutTimedRange(start, end, cutStart, cutEnd) {
 }
 function shiftTimedRange(start, end, from, amount) {
   if (start < from) return null;
-  const s = Math.max(0, start + amount);
-  return { start: s, end: end !== void 0 ? Math.max(s, end + amount) : void 0 };
+  const shiftedStart = Math.max(0, start + amount);
+  return {
+    start: shiftedStart,
+    end: end !== void 0 ? Math.max(shiftedStart, end + amount) : void 0
+  };
 }
 function selectionPatch(composition, entities) {
   const clipIds = entities.filter((e) => e.kind === "clip").map((e) => e.clipId);
@@ -91,16 +92,17 @@ function selectionPatch(composition, entities) {
 }
 function pruneSelectionInDraft(draft, removedClipIds) {
   const kept = draft.selection.filter(
-    (e) => !("clipId" in e) || !removedClipIds.has(e.clipId)
+    (entity) => !("clipId" in entity) || !removedClipIds.has(entity.clipId)
   );
   const patch = selectionPatch(draft.composition, kept);
   draft.selection = patch.selection;
   draft.selectedClipId = patch.selectedClipId;
   draft.selectedOverlayId = patch.selectedOverlayId;
 }
+
+// ../composition/src/ops/compositionOps.ts
 function createCompositionOps(get, set) {
   return {
-    // ── Clip operations ──
     addClip: (clip, options) => {
       set((draft) => {
         if (options?.newTrack) {
@@ -116,18 +118,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    /**
-     * Family-routed clip add — the single primitive behind the consolidated
-     * `clip.add` op (@cueframe/composition-ops). Routes a clip onto a track of
-     * the resolved FAMILY: either an existing track pinned by `trackId`, or a
-     * track of `kind` (created if absent, optionally with a pinned `newTrackId`
-     * for byte-faithful op-replay). Replaces the three family-specific adders
-     * (addClip/addOverlay/addAudioClip) at the OP layer — those stay for the
-     * editor's direct calls.
-     *
-     * Fails LOUD if `trackId` names a missing track, or a track of a DIFFERENT
-     * family (a clip must land on its own family — never silently mis-route).
-     */
     addClipToTrack: (clip, target) => {
       set((draft) => {
         if ("trackId" in target) {
@@ -181,7 +171,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    /** Remove every clip whose `source.mediaId === mediaId`. */
     removeClipsByMediaId: (mediaId) => {
       set((draft) => {
         const removed = /* @__PURE__ */ new Set();
@@ -217,7 +206,6 @@ function createCompositionOps(get, set) {
         );
       }
     },
-    /** Replace the whole selection. The multi-select entry point. */
     setSelection: (entities) => {
       const composition = get().composition;
       const live = entities.filter(
@@ -225,7 +213,6 @@ function createCompositionOps(get, set) {
       );
       set(selectionPatch(composition, expandToLinkGroup(composition, live)));
     },
-    /** Every clip on the timeline, in track then start order. */
     selectAllClips: () => {
       const composition = get().composition;
       const entities = [];
@@ -290,18 +277,6 @@ function createCompositionOps(get, set) {
       });
       return { rippled: rateChange ? rateChange.delta !== 0 : false };
     },
-    // ── Overlay operations (TimelineClips on kind:'overlay' tracks) ──
-    // GUARD AT THE WRITE. An overlay source without a `primitiveId` is not a clip — it is a
-    // hole that renders as `unknown overlay primitive 'undefined'`, and the RENDERER was the
-    // first thing to notice it (2026-07-13: every capture_frames of a live compose died on
-    // this, the author went blind, and it landed zero graphics on a 90s customer pitch).
-    //
-    // `primitiveId: z.string().min(1)` is ALREADY required by the composition validator — but
-    // the in-loop capture path renders the in-memory store and never validates it, so the
-    // schema never ran. Refuse at the write instead, where the caller is still on the stack and
-    // the message can name it. (Same reasoning as compositionRender's `custom`-with-no-
-    // sourceCode guard, which patched one instance of this at the render boundary; this closes
-    // the class.)
     addOverlay: (clip) => {
       if (clip.source.kind === "overlay" && !clip.source.primitiveId) {
         throw new Error(
@@ -358,10 +333,6 @@ function createCompositionOps(get, set) {
       });
       set(selectionPatch(composition, kept));
     },
-    /**
-     * (see addOverlay's guard) Replace all overlays — clears existing overlay tracks, creates
-     * one with provided clips.
-     */
     loadOverlays: (clips) => {
       set((draft) => {
         draft.composition.tracks = draft.composition.tracks.filter((t) => t.kind !== "overlay");
@@ -375,7 +346,6 @@ function createCompositionOps(get, set) {
         draft.selectedOverlayId = null;
       });
     },
-    // ── Audio operations (TimelineClips on kind:'audio' tracks) ──
     addAudioClip: (clip) => {
       set((draft) => {
         const track = findOrCreateTrackByKind(draft.composition, "audio");
@@ -408,7 +378,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    // ── Marker operations ──
     addMarker: (marker) => {
       set((draft) => {
         if (!draft.composition.markers) draft.composition.markers = [];
@@ -428,7 +397,6 @@ function createCompositionOps(get, set) {
         if (m) Object.assign(m, updates);
       });
     },
-    // ── cutAndRipple (replaces v1 deletedRanges) ──
     cutAndRipple: (start, end) => {
       if (!Number.isFinite(start) || !Number.isFinite(end) || start >= end) return;
       const span = end - start;
@@ -491,18 +459,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    // ── addExcludedRange ──
-    //
-    // Marks a range of source media on a media-source clip as excluded.
-    // Atomically: clamps to the clip's `trim` window, merges/coalesces with
-    // existing `excludedRanges` (touching ranges merge), shrinks
-    // `clip.duration` by the net delta added to Σ excluded, and ripples
-    // downstream same-track items left by that delta.
-    //
-    // Wire-shape invariant: (trim.end − trim.start) − Σexcludedrange = duration.
-    // The `trimEnd` fallback below restores trim.end from
-    // `duration + Σexcluded` when `trim` is absent — the same invariant
-    // rearranged.
     addExcludedRange: (clipId, sourceStart, sourceEnd, reason) => {
       if (!Number.isFinite(sourceStart) || !Number.isFinite(sourceEnd)) return;
       if (!(sourceEnd > sourceStart)) return;
@@ -584,12 +540,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    // ── removeExcludedRange ──
-    //
-    // Inverse of addExcludedRange. Removes the excluded range at the given
-    // index, restores the clip's duration by the same amount, and ripples
-    // downstream same-track items right. When the resulting list is empty,
-    // drops the field entirely so the wire stays canonical.
     removeExcludedRange: (clipId, rangeIdx) => {
       set((draft) => {
         const found = findClipById(draft.composition, clipId);
@@ -615,18 +565,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    // ── setCropIntents ──
-    //
-    // Author the camera channel (`reframe`) on a media clip. Each segment
-    // carries the canonical reframe params (focus, zoom, bias, ease) the
-    // derive math honors directly — no closed-enum framing names, no
-    // hardcoded scale constants.
-    //
-    // `null`/empty clears `reframe`; the clip then renders from the raw source.
-    //
-    // Used by the agent's `set_crop_intents` tool (name kept; the arg shape is
-    // reframe) and the desktop editor's framing timeline. Replaces the deleted
-    // subject-centric cropIntents (2026-06-14 cutover).
     setCropIntents: (clipId, segments) => {
       set((draft) => {
         const found = findClipById(draft.composition, clipId);
@@ -640,23 +578,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    // ── setEffects ──
-    //
-    // Author a clip's EFFECT channel (`TimelineClip.effects`) — the registered
-    // effect primitives (+ params) the renderer stacks onto that clip. WHOLESALE:
-    // the array REPLACES whatever was there, and `[]` CLEARS the channel (the
-    // same set/clear shape setCropIntents has). `effects` has been in the
-    // validator — and accepted by `clip.add` — all along, but until the
-    // `setEffects` op there was no way to change it on an EXISTING clip except a
-    // whole-clip `clip.update` patch, which the op vocabulary explicitly steers
-    // callers away from (a partial `source` in that patch clobbers the source).
-    //
-    // Named EXACTLY like the wire op it records (`setEffects`) — the factory and
-    // the op vocabulary are one vocabulary, so there is no method→op rename table
-    // for the conformance guard to carry.
-    //
-    // Cross-track by id, like `updateClip` — the clip's family is irrelevant to
-    // its effect stack. Same merge shape as `updateClip(id, { effects })`.
     setEffects: (clipId, effects) => {
       set((draft) => {
         const found = findClipById(draft.composition, clipId);
@@ -668,17 +589,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    // ── setCaptionStyle ──
-    //
-    // Apply the agent's caption STYLE overrides (font, size, color, position,
-    // emphasis treatment, …) onto the top-level `composition.captions.style` —
-    // the exact field the renderer consumes (compositionRender.ts) and the
-    // Captions primitive reads. Merge (not replace) so each `set_captions` call
-    // overrides only the fields it names and leaves the rest (and the
-    // transcript-sliced `words`) intact. Undefined fields are dropped so an
-    // omitted field never clobbers an existing one. If captions don't exist yet
-    // (style set before the transcript slice lands), create the container with
-    // empty words — the compose/insert path fills the words.
     setCaptionStyle: (style) => {
       set((draft) => {
         const clean = Object.fromEntries(
@@ -693,18 +603,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    // ── setCaptionDepth ──
-    //
-    // Put the caption layer UNDER the speaker's silhouette, or back in front.
-    // One choice for the whole layer, not per segment, because it decides
-    // whether the SOURCE needs a matte — the $0.12/source-minute rung, and a
-    // caption layer usually spans the whole video. See `CaptionDepth` in the
-    // schema for why the 2026-06-11 front-only rule was reversed.
-    //
-    // Unlike `setCaptionStyle`, this does NOT create a caption container out of
-    // nothing. Depth on a layer with no words is a request to matte footage
-    // nobody is reading over — expensive and invisible — so a caller who has
-    // not authored captions yet gets a no-op rather than a bill.
     setCaptionDepth: (zPlane) => {
       set((draft) => {
         const existing = draft.composition.captions;
@@ -716,15 +614,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    // ── setCaptions ──
-    //
-    // Replace the caption SEGMENTS wholesale — the words layer. Until this op,
-    // caption words were populated ONLY by the compose/from-suggestion
-    // transcript-slice lanes, so a client agent holding its own word timings
-    // (e.g. a generated VO take) had no way to author the engine caption layer
-    // (memoir v4, 2026-07-21). Segments REPLACE (not merge — word timing is one
-    // coherent document); `style`, when given, merges with setCaptionStyle
-    // semantics, and an omitted style keeps the existing one.
     setCaptions: (segments, style, derivedFrom) => {
       set((draft) => {
         const existing = draft.composition.captions;
@@ -736,7 +625,6 @@ function createCompositionOps(get, set) {
         draft.composition.captions = derivedFrom ? { source: "derived", from: derivedFrom, segments, ...styleField } : { source: "authored", segments, ...styleField };
       });
     },
-    // ── ripple ──
     ripple: (time, amount) => {
       set((draft) => {
         for (const track of draft.composition.tracks) {
@@ -770,15 +658,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    // ── Canvas / format ──
-    //
-    // Patches `composition.format` — `aspectRatio` is required (the field
-    // has no default), `fps`, `resolution`, and `platform` fall back to the
-    // existing values on the wire. Clip start/duration values are not retimed:
-    // a 30→60 fps switch keeps the same wall-clock seconds. Layout-sensitive
-    // overlays may need re-rendering by the caller after a switch. `platform`
-    // is output-determining (safe-zone placement) — carry it forward so an
-    // aspect-only change never silently erases it.
     setFormat: (next) => {
       set((draft) => {
         const prev = draft.composition.format;
@@ -790,18 +669,6 @@ function createCompositionOps(get, set) {
         };
       });
     },
-    // ── Track operations ──
-    //
-    // Capability parity: the cloud agent must be able to do everything the
-    // editor can (these were previously editor-only, in
-    // apps/studio/src/store/compositionStore/compositionOps.ts). They are pure
-    // `set` mutations over `composition.tracks` + the selection fields already
-    // on `CompositionOpsState`, so they live in core unchanged. The agent's
-    // tool layer can now surface them; the editor keeps calling the same names.
-    /**
-     * Append a new track of `kind` to `composition.tracks`. If `id` is omitted
-     * a UUID-suffixed id is generated (matches `findOrCreateTrackByKind`).
-     */
     addTrack: (kind, name, id) => {
       set((draft) => {
         const track = {
@@ -813,7 +680,6 @@ function createCompositionOps(get, set) {
         draft.composition.tracks.push(track);
       });
     },
-    /** Remove a track and any clip selection that references its contents. */
     removeTrack: (trackId) => {
       set((draft) => {
         const idx = draft.composition.tracks.findIndex((t) => t.id === trackId);
@@ -829,7 +695,6 @@ function createCompositionOps(get, set) {
         draft.composition.tracks.splice(idx, 1);
       });
     },
-    /** Patch a track's `name` / `enabled`. */
     updateTrack: (trackId, updates) => {
       set((draft) => {
         const track = draft.composition.tracks.find((t) => t.id === trackId);
@@ -841,7 +706,6 @@ function createCompositionOps(get, set) {
         }
       });
     },
-    /** Move a track from `fromIndex` to `toIndex` within `composition.tracks`. */
     reorderTracks: (fromIndex, toIndex) => {
       set((draft) => {
         const len = draft.composition.tracks.length;
@@ -852,14 +716,6 @@ function createCompositionOps(get, set) {
         draft.composition.tracks.splice(clamped, 0, moved);
       });
     },
-    /**
-     * Move a clip to a different track, optionally updating its startTime.
-     *
-     * The op trusts callers to validate kind-compatibility and overlap; the
-     * Fabric drag handler is responsible for snapping back when invalid. No-op
-     * if the clip isn't found, the target track doesn't exist, or target ===
-     * source. Selection stays put (the clip id is unchanged).
-     */
     moveClipToTrack: (clipId, targetTrackId, newStartTime) => {
       set((draft) => {
         let sourceTrack;
@@ -883,11 +739,6 @@ function createCompositionOps(get, set) {
         target.contents.sort((a, b) => a.startTime - b.startTime);
       });
     },
-    /**
-     * Duplicate a clip. The copy receives a new id and is appended to the same
-     * track immediately after the original's `[startTime + duration]` (nudged
-     * forward to avoid overlap with whatever follows).
-     */
     duplicateClip: (id) => {
       let newId;
       set((draft) => {
@@ -1063,9 +914,6 @@ function mergeTimelineTranscripts(clips, transcripts) {
         timelineStart: clip.startTime + (segment.startTime - trimStart) / rate,
         timelineEnd: clip.startTime + (clampedEnd - trimStart) / rate,
         clipId: clip.id,
-        // The v1 TimelineWord field is named `poolItemId`; v2 calls it
-        // `mediaId`. Same semantic — retain v1 name on the wire so the
-        // agent context (which reads `word.poolItemId`) keeps working.
         poolItemId: mediaId,
         sourceStart: segment.startTime,
         sourceEnd: clampedEnd,

package/dist/chunk-IEXAKOEX.js

@@ -0,0 +1,113 @@
+import {
+  EntityId,
+  ISODateTime,
+  NonEmptyString
+} from "./chunk-XELS2BGA.js";
+
+// ../data-models/account-model/src/validators/userSettings.ts
+import { z } from "zod";
+var UserSettings = z.object({
+  id: EntityId("userSettings"),
+  userId: NonEmptyString,
+  enableUnderstanding: z.boolean().optional(),
+  activeBrandKitId: EntityId("brandKits").optional()
+});
+
+// ../data-models/account-model/src/validators/conversation.ts
+import { z as z2 } from "zod";
+var ConversationProject = z2.object({
+  id: NonEmptyString,
+  home: z2.enum(["local", "cloud"])
+});
+var Conversation = z2.object({
+  id: EntityId("conversations"),
+  clientId: NonEmptyString,
+  userId: NonEmptyString,
+  title: NonEmptyString,
+  project: ConversationProject.optional(),
+  createdAt: ISODateTime,
+  updatedAt: ISODateTime,
+  messages: z2.string()
+});
+
+// ../data-models/account-model/src/validators/uploadToken.ts
+import { z as z3 } from "zod";
+var UploadTokenScope = z3.enum(["tus", "companion"]);
+var UploadToken = z3.object({
+  id: EntityId("uploadTokens"),
+  token: NonEmptyString,
+  userId: NonEmptyString,
+  projectId: EntityId("projects").optional(),
+  orgId: NonEmptyString.optional(),
+  scope: UploadTokenScope.optional(),
+  expiresAt: ISODateTime
+});
+
+// ../data-models/account-model/src/validators/contextFile.ts
+import { z as z4 } from "zod";
+var ContextFile = z4.object({
+  id: EntityId("contextFiles"),
+  orgId: NonEmptyString,
+  userId: NonEmptyString,
+  filename: NonEmptyString,
+  content: z4.string(),
+  generatedFrom: z4.array(NonEmptyString),
+  version: z4.number().int().nonnegative(),
+  updatedAt: ISODateTime
+});
+
+// ../data-models/account-model/src/validators/dashboardInsight.ts
+import { z as z5 } from "zod";
+var DashboardInsight = z5.object({
+  id: EntityId("dashboardInsights"),
+  orgId: NonEmptyString,
+  sourceHash: NonEmptyString,
+  heroInsight: NonEmptyString,
+  contentSuggestions: z5.array(NonEmptyString),
+  generatedAt: ISODateTime
+});
+
+// ../data-models/account-model/src/validators/sessionToken.ts
+import { z as z6 } from "zod";
+var SessionTokenScope = z6.enum(["session-read"]);
+var SessionToken = z6.object({
+  id: EntityId("sessionTokens"),
+  token: NonEmptyString,
+  sessionId: NonEmptyString,
+  projectId: EntityId("projects"),
+  orgId: NonEmptyString,
+  scope: SessionTokenScope,
+  expiresAt: ISODateTime,
+  sandboxId: NonEmptyString.optional(),
+  readyAt: z6.number().optional(),
+  scheduledCloseId: NonEmptyString.optional(),
+  scratchCompositionId: EntityId("compositions").optional(),
+  managed: z6.boolean().optional(),
+  leaseJobId: NonEmptyString.optional(),
+  leaseExpiresAt: z6.number().optional()
+});
+
+// ../data-models/account-model/src/validators/workingComposition.ts
+import { z as z7 } from "zod";
+var WorkingComposition = z7.object({
+  id: EntityId("workingCompositions"),
+  sessionId: NonEmptyString,
+  projectId: EntityId("projects"),
+  orgId: NonEmptyString,
+  composition: z7.unknown(),
+  version: z7.number(),
+  updatedAt: z7.number()
+});
+
+export {
+  UserSettings,
+  ConversationProject,
+  Conversation,
+  UploadTokenScope,
+  UploadToken,
+  ContextFile,
+  DashboardInsight,
+  SessionTokenScope,
+  SessionToken,
+  WorkingComposition
+};

package/dist/{chunk-UY4SWJVE.js → chunk-K2IUBCND.js}

@@ -189,22 +189,18 @@ export default function CinematicTitle({ durationInFrames, params }) {
   const subtext = params.subtext ?? '';
   const accentColor = params.accentColor ?? '#D4AF37';
   const barHeight = height * 0.13;
-  // Bars slide in first (frames 0-20)
   const barSlide = interpolate(frame, [0, 20], [barHeight, 0], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
-  // Title fades in after bars (frames 18-40), letter-spacing tightens
   const textFade = interpolate(frame, [18, 40], [0, 1], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
   const textSpacing = interpolate(frame, [18, 45], [20, 6], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
-  // Subtext arrives last (frames 35-55)
   const subtextFade = interpolate(frame, [35, 55], [0, 1], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
-  // Exit: fade out in final 20 frames
   const exitOpacity = interpolate(frame, [durationInFrames - 20, durationInFrames], [1, 0], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
@@ -238,14 +234,10 @@ export default function LowerThird({ durationInFrames, params }) {
   const frame = useCurrentFrame();
   const accent = params.accentColor ?? '#DB6452';
   const pos = params.position ?? 'left';
-  // Floor-assigned safe band (clear of captions + platform UI). NEVER hard-code
-  // bottom/top offsets \u2014 anchor to the region instead.
   const R = params.region ?? { x: 0, y: 0, w: 1, h: 1 };
-  // Responsive fade durations \u2014 Math.min prevents overrun on short overlays
   const fadeIn = Math.min(15, Math.floor(durationInFrames / 3));
   const fadeOut = Math.min(10, Math.floor(durationInFrames / 3));
   const slideIn = interpolate(frame, [0, fadeIn], [-100, 0], { extrapolateRight: 'clamp' });
-  // 4-point opacity: [enter, hold, hold, exit]
   const opacity = interpolate(frame,
     [0, fadeIn, Math.max(fadeIn, durationInFrames - fadeOut), durationInFrames],
     [0, 1, 1, 0],
@@ -281,20 +273,17 @@ export default function WaveText({ durationInFrames, params }) {
   const text = params.text ?? 'WAVE';
   const subtext = params.subtext ?? '';
   const accent = params.accentColor ?? '#F59E0B';
-  // Spring entrance \u2014 whole component fades/scales in
   const enterProgress = spring({ frame, fps, config: { damping: 14, stiffness: 120 } });
   const enterOpacity = interpolate(enterProgress, [0, 1], [0, 1]);
   const exitOpacity = interpolate(frame, [durationInFrames - 15, durationInFrames], [1, 0], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
   const chars = text.split('');
-  // Staggered subtext spring (delayed 12 frames)
   const subtextProgress = spring({ frame: Math.max(0, frame - 12), fps, config: { damping: 16, stiffness: 100 } });
   return (
     <AbsoluteFill style={{ justifyContent: 'center', alignItems: 'center', opacity: exitOpacity }}>
       <div style={{ display: 'flex', flexDirection: 'row', opacity: enterOpacity }}>
         {chars.map((char, i) => {
-          // Per-character wave: phase offset by index, continuous sine motion
           const wave = Math.sin(frame * 0.12 - i * 0.6) * 18;
           const rotation = Math.sin(frame * 0.1 - i * 0.5) * 8;
           return (
@@ -336,7 +325,6 @@ within this band. Wrap your root in a positioned container sized to the region:
     <div style={{ position: 'absolute', left: \`\${R.x*100}%\`, top: \`\${R.y*100}%\`,
       width: \`\${R.w*100}%\`, height: \`\${R.h*100}%\`,
       display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
-      {/* your graphic */}
     </div>
   );
   \`\`\`