@cueframe/kernel 0.1.0 → 0.1.2

package/dist/{chunk-ZB3C3HM7.js → chunk-DCVJWGIA.js}

@@ -15166,13 +15166,7 @@ var PRIMITIVE_META = [
 ];
 
 // ../composition/src/primitive-catalog/disabled.ts
-var DISABLED_PRIMITIVE_IDS = /* @__PURE__ */ new Set([
-  // (empty) — heroText was denylisted 2026-07-08 because behind-subject
-  // matte compositing desynced lip movement. Root cause was the matte bake
-  // re-timing the co-view at average fps (VFR sources drifted seconds);
-  // fixed by the CFR timing invariant at ingest (plan: brain
-  // 2026-07-28-cfr-timing-invariant) — re-enabled 2026-07-28.
-]);
+var DISABLED_PRIMITIVE_IDS = /* @__PURE__ */ new Set([]);
 function isPrimitiveDisabled(id) {
   return DISABLED_PRIMITIVE_IDS.has(id);
 }
@@ -15266,8 +15260,6 @@ function projectToComponentCatalog(metas) {
     examples: m.examples,
     fixedCopy: m.fixedCopy,
     brandBindings: deriveBrandBindings(m.tokens),
-    // Built-in primitives are always source:'default'; placement derives from
-    // category (overlay for text/ui/scene, effect for effects/transitions).
     placement: derivePlacement({ source: "default", category: m.category })
   }));
 }
@@ -15484,6 +15476,9 @@ var CatalogFilterError = class extends Error {
     this.allowed = allowed;
     this.name = "CatalogFilterError";
   }
+  field;
+  value;
+  allowed;
 };
 var CatalogCursorError = class extends Error {
   constructor(message = "The supplied cursor is invalid or expired.") {

package/dist/{chunk-IBYQG46O.js → chunk-DWLNPNC4.js}

@@ -2,7 +2,7 @@ import {
   selectAllClips,
   selectAllOverlays,
   selectSceneMarkers
-} from "./chunk-XWKZB5U5.js";
+} from "./chunk-ICSZF37W.js";
 
 // ../authoring/src/context/transcript.ts
 var MAX_TRANSCRIPT_CHARS = 6e4;
@@ -165,9 +165,6 @@ function buildBrandKitData(activeBrandKit) {
     headingFont: { ...activeBrandKit.headingFont },
     bodyFont: { ...activeBrandKit.bodyFont },
     voiceGuidelines: activeBrandKit.voiceGuidelines,
-    // Render-relevant overlay assets carry the wire shape now — surface the
-    // asset reference (src) / authored card text so the agent knows a bumper or
-    // mark is present without re-deriving it.
     ...activeBrandKit.intro && { intro: activeBrandKit.intro.src ?? activeBrandKit.intro.title ?? activeBrandKit.intro.kind },
     ...activeBrandKit.outro && { outro: activeBrandKit.outro.src ?? activeBrandKit.outro.title ?? activeBrandKit.outro.kind },
     ...activeBrandKit.watermark && { watermark: activeBrandKit.watermark.src },

package/dist/{chunk-SW336CJP.js → chunk-DYZE7JZA.js}

@@ -1,10 +1,10 @@
+import {
+  DashboardPopulate
+} from "./chunk-ZSZABOE5.js";
 import {
   frostedGlassWipe,
   spatialPush
 } from "./chunk-QGAWDLYX.js";
-import {
-  DashboardPopulate
-} from "./chunk-ZSZABOE5.js";
 import {
   ACCENT_SOFT,
   BG,
@@ -828,7 +828,6 @@ function PulseLogo({
     AbsoluteFill2,
     {
       style: {
-        // Exposure lift — the scene graded ~1.5 stops under launch-video norm.
         filter: "brightness(1.28) contrast(1.03)",
         background,
         display: "flex",
@@ -932,7 +931,6 @@ function AppShellFlyover({
     AbsoluteFill2,
     {
       style: {
-        // Exposure lift — the scene graded ~1.5 stops under launch-video norm.
         filter: "brightness(1.28) contrast(1.03)",
         background,
         opacity: enter,
@@ -2308,7 +2306,6 @@ var SCENES = {
   maskedSlide: { start: 290, duration: 120 },
   push2: { start: 400, duration: 60 },
   terminal: { start: 460, duration: 180 },
-  // Quiet hold at the very end so the loop never restarts mid-action.
   endHold: 80
 };
 var LANDING_CODE_SHOWCASE_DURATION = SCENES.terminal.start + SCENES.terminal.duration + SCENES.endHold;
@@ -2920,10 +2917,6 @@ var paramsSchema = z.object({
   cardBackground: z.string().optional().describe("Card panel background."),
   accent: z.string().default("#ffb38e").describe('Accent color for label/highlights. Brand-bindable: pass "$brand:colors.accent" to track the project brand kit.'),
   speed: z.number().min(0.25).max(4).default(1).describe("Playback speed multiplier."),
-  // Structured-content slot for the before/after comparison panels. These are
-  // the JSON-serializable replacement for the inexpressible `oldContent`/
-  // `newContent` ReactNode props: supply the literal diff lines and they render
-  // in the panels. Omit them to show the baked sample diff.
   oldLines: z.array(z.string()).optional().describe("BEFORE-panel content: one string per line (e.g. the old code). Rendered as monospace text. Omit to show the baked sample diff."),
   newLines: z.array(z.string()).optional().describe("AFTER-panel content: one string per line (e.g. the new code). Rendered as monospace text. Omit to show the baked sample diff.")
 }).passthrough();
@@ -2952,11 +2945,6 @@ var config = {
   ],
   textParam: "title",
   subtextParam: "label",
-  // label/title/oldLines/newLines ARE params — the diff CONTENT is now
-  // expressible (string[] panels, see oldLines/newLines). What remains baked is
-  // only the panel chrome: the BEFORE/AFTER corner badges and the mid-wipe
-  // footer labels. Omitting oldLines/newLines falls back to a baked sample diff
-  // (its literals are the params' documented defaults, not fixed copy).
   fixedCopy: [
     "BEFORE",
     "AFTER",
@@ -3006,8 +2994,6 @@ var config2 = {
   ],
   textParam: null,
   subtextParam: null,
-  // The typed program + rendered output are BAKED — no param sets the code or
-  // the resulting button label.
   fixedCopy: [
     "Button",
     // editor filename tab
@@ -3062,8 +3048,6 @@ var config3 = {
   ],
   textParam: "productName",
   subtextParam: "versionLabel",
-  // logoLabel/productName/versionLabel ARE params; these are the BAKED strings
-  // (FauxBentoGrid cards + FauxCodeBlock body) no param can change.
   fixedCopy: [
     "Animations",
     "Spring-tuned",
@@ -3211,8 +3195,6 @@ var config5 = {
   ],
   textParam: null,
   subtextParam: null,
-  // focusedTier picks WHICH card to spotlight; all tier copy/prices are BAKED.
-  // The scene that exists to show pricing cannot carry the agent's pricing.
   fixedCopy: [
     "Free",
     "$0",
@@ -3292,9 +3274,6 @@ var config6 = {
   ],
   textParam: null,
   subtextParam: null,
-  // No prop changes the marketing copy or the typed program — fork via
-  // get_component_source to rewrite (index.tsx STEPS / BlurRevealScene /
-  // MaskedSlideScene / TerminalScene).
   fixedCopy: [
     "Build faster.",
     // BlurReveal headline (right preview pane)
@@ -3369,8 +3348,6 @@ var config7 = {
   ],
   textParam: "siteUrl",
   subtextParam: null,
-  // siteUrl is a param (it interpolates into the success line + address bar);
-  // the terminal log lines + browser chrome/hero are BAKED.
   fixedCopy: [
     "$ pnpm deploy",
     "\u2192 Building project...",

package/dist/{chunk-HCCBDJLW.js → chunk-EP2Y6M2J.js}

@@ -27,10 +27,6 @@ async function multipartUpload(opts) {
     headers,
     body: JSON.stringify({
       filename: file.name,
-      // NOT `file.type || "video/mp4"`. That fallback relabelled every untyped
-      // file as video, so an MP3 with no MIME uploaded as `video/mp4` and was
-      // routed down the video transcode path by `mediaKind()` — a wrong
-      // pipeline instead of an honest refusal. See `contentTypeForUpload`.
       type: contentTypeForUpload(file.name, file.type),
       metadata: { uploadToken: token, ...metadata }
     })

package/dist/{chunk-ZE76SSRT.js → chunk-FMODQD5P.js}

@@ -248,12 +248,6 @@ function mapFreesoundCandidate(r, query) {
     query,
     thumbnail: preview ? preview.replace(/\.mp3$/, ".png") : "",
     previewUrl: preview,
-    // Import the PUBLIC preview (preview-hq-mp3), not the API download endpoint
-    // (`/apiv2/sounds/{id}/download/`) — that requires an OAuth2 bearer token,
-    // which no consumer has (the gateway only carries a Freesound API Token, which
-    // the download endpoint rejects with 401). The R2 mirror fetches this URL bare,
-    // exactly like the public CDN URLs the other providers ship (klipy likewise
-    // sets downloadUrl === previewUrl). preview-hq-mp3 is acceptable for stock sfx.
     downloadUrl: preview,
     duration: Number(r.duration ?? 0),
     photographer: String(r.username ?? ""),

package/dist/{chunk-PMY24FUD.js → chunk-G5BFI32U.js}

@@ -1,6 +1,6 @@
 import {
   resolveFitFontSize
-} from "./chunk-AYVJXDLB.js";
+} from "./chunk-XHGZ2E77.js";
 import {
   ACCENT,
   ACCENT_SOFT,

package/dist/{chunk-LD5ZOUFT.js → chunk-GF52TW4I.js}

@@ -14,22 +14,18 @@ var PipelineTrace = class {
   constructor(logger) {
     this.log = logger ?? DEFAULT_LOGGER;
   }
-  /** Begin a named span. */
   start(name) {
     this.openSpans.set(name, performance.now());
   }
-  /** End a named span. No-op if the span was never started. */
   end(name) {
     const startMs = this.openSpans.get(name);
     if (startMs === void 0) return;
     this.openSpans.delete(name);
     this.spans.push({ name, startMs, endMs: performance.now() });
   }
-  /** Record a tool call (increments the counter for the summary). */
   recordToolCall() {
     this.toolCallCount++;
   }
-  /** Log a summary table of all recorded spans. */
   summary() {
     const totalMs = performance.now() - this.t0;
     const accounted = this.spans.reduce((sum, s) => sum + (s.endMs - s.startMs), 0);

package/dist/{chunk-ABL557OT.js → chunk-GMD33ZD7.js}

@@ -1,6 +1,6 @@
 import {
   FitText
-} from "./chunk-AYVJXDLB.js";
+} from "./chunk-XHGZ2E77.js";
 import {
   ACCENT,
   ACCENT_STRONG,
@@ -49,7 +49,6 @@ var Blur = ({
         width: "100%",
         height: "100%",
         filter: filterValue,
-        // Motion blur simulation: scale slightly in one direction
         ...type === "motion" && currentRadius > 0 ? { transform: `scaleX(${1 + currentRadius * 5e-3})` } : {},
         ...style
       }
@@ -829,9 +828,6 @@ var config = {
   category: "effects",
   kind: "component",
   version: "0.1.0",
-  // Same wrapper contract as color-grade — see that config's note. Caveat the
-  // wrap mount inherits: `animateFrom/To` interpolate over the BODY's frame
-  // span (there is no Sequence around a wrap mount), not the effect window.
   effectPlacement: "wrap",
   intent: "depth-blur",
   description: "Animatable blur wrapper. Wrap any child to apply CSS filter blur, optionally animating the radius across the duration (focus pull, reveal, transition out). Motion blur variant adds a slight scaleX stretch for a horizontal-pan feel.",
@@ -891,9 +887,6 @@ var config2 = {
   category: "effects",
   kind: "component",
   version: "0.1.0",
-  // A filter WRAPPER: CSS `filter` only touches the element's own subtree, so
-  // the render must mount this AROUND the footage (WrapEffects), never as a
-  // stacked layer — stacked, it filters an empty div and grades nothing.
   effectPlacement: "wrap",
   intent: "color-grade",
   description: "CSS-filter-based color grading wrapper. Seven presets cover the common looks (vintage, cinematic, bleach-bypass, sepia, cool, warm, none) and per-channel overrides are available for fine-tuning. Wrap any media \u2014 Img, Video, full Composition.",

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

@@ -3,15 +3,13 @@ import {
 } from "./chunk-KYRDKK2D.js";
 import {
   Composition
-} from "./chunk-MXFAADCQ.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,15 +603,17 @@ 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.
+    setCaptionDepth: (zPlane) => {
+      set((draft) => {
+        const existing = draft.composition.captions;
+        if (!existing) return;
+        if (zPlane === "front") {
+          delete existing.zPlane;
+        } else {
+          existing.zPlane = zPlane;
+        }
+      });
+    },
     setCaptions: (segments, style, derivedFrom) => {
       set((draft) => {
         const existing = draft.composition.captions;
@@ -713,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) {
@@ -747,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;
@@ -767,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 = {
@@ -790,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);
@@ -806,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);
@@ -818,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;
@@ -829,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;
@@ -860,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) => {
@@ -1040,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,