@cueframe/kernel 0.1.0 → 0.1.2

package/dist/{chunk-GEA7E2FL.js → chunk-PIURX6IZ.js}

@@ -2,11 +2,11 @@ import {
   activeFaceKeepOutSeries,
   boundingBox,
   resolveBrandRefsDeep
-} from "./chunk-FYZVH3MC.js";
+} from "./chunk-YQ7FFW3G.js";
 import {
   CueframeError,
   encodeError
-} from "./chunk-37NJ27UU.js";
+} from "./chunk-LLUW26BS.js";
 
 // ../composition/src/projection/cardTokens.ts
 var CARD_MOTION_VAR_NAMES = [
@@ -134,6 +134,212 @@ function deriveBehindAnchor(g) {
   };
 }
 
+// ../composition/src/projection/behind-readiness.ts
+async function matteIntentKey(intent) {
+  const canonical = {
+    startSec: Math.round(intent.startSec * 1e3) / 1e3,
+    endSec: Math.round(intent.endSec * 1e3) / 1e3,
+    subjectClass: intent.subjectClass
+  };
+  const bytes = new TextEncoder().encode(JSON.stringify(canonical));
+  const digest = await crypto.subtle.digest("SHA-256", bytes);
+  return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, 12);
+}
+function overlapsMs(aStartSec, aDurationSec, bStartSec, bDurationSec) {
+  const aStart = aStartSec * 1e3;
+  const aEnd = (aStartSec + aDurationSec) * 1e3;
+  const bStart = bStartSec * 1e3;
+  const bEnd = (bStartSec + bDurationSec) * 1e3;
+  return aStart < bEnd && aEnd > bStart;
+}
+function tracksOf(composition) {
+  const tracks = composition?.tracks;
+  return Array.isArray(tracks) ? tracks : [];
+}
+function clipsOf(track) {
+  const contents = track.contents;
+  if (!Array.isArray(contents)) return [];
+  const out = [];
+  for (const c of contents) {
+    const id = c.id;
+    const startTime = c.startTime;
+    const duration = c.duration;
+    if (typeof id !== "string" || typeof startTime !== "number" || typeof duration !== "number") {
+      continue;
+    }
+    out.push(c);
+  }
+  return out;
+}
+function findClipById(composition, clipId) {
+  for (const track of tracksOf(composition)) {
+    for (const clip of clipsOf(track)) {
+      if (clip.id === clipId) return clip;
+    }
+  }
+  return null;
+}
+function primaryClipForOverlay(composition, overlayId) {
+  const overlay = findClipById(composition, overlayId);
+  if (!overlay || overlay.duration <= 0) return null;
+  for (const track of tracksOf(composition)) {
+    if (track.kind !== "video") continue;
+    for (const clip of clipsOf(track)) {
+      if (clip.source?.kind !== "media") continue;
+      const mediaId = clip.source.mediaId;
+      if (typeof mediaId !== "string" || !mediaId) continue;
+      if (!overlapsMs(clip.startTime, clip.duration, overlay.startTime, overlay.duration)) {
+        continue;
+      }
+      const trim = clip.source.trim;
+      const startSec = typeof trim?.start === "number" ? trim.start : 0;
+      const endSec = typeof trim?.end === "number" ? trim.end : startSec + clip.duration;
+      return { mediaId, window: { startSec, endSec } };
+    }
+  }
+  return null;
+}
+async function behindReadinessForOverlay(input) {
+  const target = primaryClipForOverlay(input.composition, input.overlayId);
+  return behindReadinessForTarget(
+    target,
+    target ? input.mattesByMediaId[target.mediaId] : void 0
+  );
+}
+async function behindReadinessForTarget(target, mattes) {
+  if (!target) return { state: "no-clip" };
+  const key = await matteIntentKey({ ...target.window, subjectClass: "person" });
+  const entry = mattes?.[key];
+  if (!entry?.geometryR2Key) return { state: "no-matte", target };
+  const presenceFraction = entry.presenceFraction ?? 0;
+  if (presenceFraction < MIN_PRESENCE_FOR_BEHIND) {
+    return { state: "no-subject", target, presenceFraction };
+  }
+  return { state: "subject-present", target };
+}
+function clipOverlapsBehind(clipStartSec, clipDurationSec, windows) {
+  const start = clipStartSec * 1e3;
+  const end = (clipStartSec + clipDurationSec) * 1e3;
+  return windows.some((w) => start < w.endMs && end > w.startMs);
+}
+function matteWindowsByMediaId(composition, behindWindows) {
+  const out = /* @__PURE__ */ new Map();
+  if (behindWindows.length === 0) return out;
+  for (const track of tracksOf(composition)) {
+    const kind = track.kind;
+    if (kind !== "video" && kind !== "audio" && kind !== "image") continue;
+    for (const clip of clipsOf(track)) {
+      if (clip.source?.kind !== "media") continue;
+      const mediaId = clip.source.mediaId;
+      if (typeof mediaId !== "string" || !mediaId) continue;
+      if (!clipOverlapsBehind(clip.startTime, clip.duration, behindWindows)) continue;
+      const trim = clip.source.trim;
+      const startSec = typeof trim?.start === "number" ? trim.start : 0;
+      const endSec = typeof trim?.end === "number" ? trim.end : startSec + clip.duration;
+      if (endSec <= startSec) continue;
+      if (!out.has(mediaId)) out.set(mediaId, { startSec, endSec });
+    }
+  }
+  return out;
+}
+function behindWindowsOf(composition) {
+  const out = [];
+  for (const track of tracksOf(composition)) {
+    for (const clip of clipsOf(track)) {
+      const src = clip.source;
+      const kind = src?.kind;
+      if (kind !== "overlay" && kind !== "alpha-layer") continue;
+      if (src?.zPlane !== "behind-subject") continue;
+      if (clip.duration <= 0) continue;
+      out.push({
+        startMs: clip.startTime * 1e3,
+        endMs: (clip.startTime + clip.duration) * 1e3
+      });
+    }
+  }
+  out.push(...captionBehindWindowsOf(composition));
+  return out;
+}
+function captionBehindWindowsOf(composition) {
+  const out = [];
+  const captions = composition?.captions;
+  if (captions?.zPlane === "behind-subject" && Array.isArray(captions.segments)) {
+    for (const seg of captions.segments) {
+      const words = seg?.words;
+      if (!Array.isArray(words) || words.length === 0) continue;
+      let startMs = Infinity;
+      let endMs = -Infinity;
+      for (const w of words) {
+        const s = w.startMs;
+        const e = w.endMs;
+        if (typeof s !== "number" || typeof e !== "number") continue;
+        if (s < startMs) startMs = s;
+        if (e > endMs) endMs = e;
+      }
+      if (Number.isFinite(startMs) && endMs > startMs) out.push({ startMs, endMs });
+    }
+  }
+  return out;
+}
+
+// ../composition/src/projection/reframe-readiness.ts
+async function sourceWindowKey(window) {
+  const canonical = {
+    startSec: Math.round(window.startSec * 1e3) / 1e3,
+    endSec: Math.round(window.endSec * 1e3) / 1e3
+  };
+  if (window.detector && window.detector !== "face") {
+    canonical.detector = window.detector;
+  }
+  const bytes = new TextEncoder().encode(JSON.stringify(canonical));
+  const digest = await crypto.subtle.digest("SHA-256", bytes);
+  return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, 12);
+}
+var SUBJECT_MODES = /* @__PURE__ */ new Set(["face", "all-faces", "active-speaker"]);
+function reframeNeedsDetection(segments) {
+  return segments.some((s) => {
+    const mode = s?.focus?.mode;
+    return typeof mode === "string" && SUBJECT_MODES.has(mode);
+  });
+}
+function reframeTargets(composition) {
+  const tracks = composition?.tracks;
+  if (!Array.isArray(tracks)) return [];
+  const out = [];
+  for (const track of tracks) {
+    const kind = track.kind;
+    if (kind !== "video" && kind !== "image") continue;
+    const contents = track.contents;
+    if (!Array.isArray(contents)) continue;
+    for (const content of contents) {
+      const src = content?.source;
+      if (!src || src.kind !== "media") continue;
+      const segments = src.reframe?.segments;
+      if (!Array.isArray(segments) || segments.length === 0) continue;
+      const clipId = content.id;
+      const mediaId = src.mediaId;
+      if (typeof clipId !== "string" || !clipId) continue;
+      if (typeof mediaId !== "string" || !mediaId) continue;
+      const duration = content.duration;
+      const startSec = typeof src.trim?.start === "number" ? src.trim.start : 0;
+      const endSec = typeof src.trim?.end === "number" ? src.trim.end : startSec + (typeof duration === "number" ? duration : 0);
+      if (!(endSec > startSec)) continue;
+      out.push({ clipId, mediaId, window: { startSec, endSec }, segments });
+    }
+  }
+  return out;
+}
+async function reframeReadinessForTarget(target, subjectTracks) {
+  if (!reframeNeedsDetection(target.segments)) return { state: "geometric" };
+  const key = await sourceWindowKey(target.window);
+  const entry = subjectTracks?.[key];
+  if (!entry) return { state: "no-track" };
+  if (typeof entry.trackUrl !== "string" || !entry.trackUrl) {
+    return { state: "track-unfetchable", entry };
+  }
+  return { state: "track-ready", entry, trackUrl: entry.trackUrl };
+}
+
 // ../composition/src/projection/occlusion-budget.ts
 var BUDGET = { minBite: 0.15, maxCoverage: 0.65, maxTopHalf: 0.35 };
 var BEHIND_TEXT_EXTENT = { heightFrac: 0.18 };
@@ -381,6 +587,18 @@ export {
   MIN_PRESENCE_FOR_BEHIND,
   BEHIND_BAND,
   deriveBehindAnchor,
+  matteIntentKey,
+  primaryClipForOverlay,
+  behindReadinessForOverlay,
+  behindReadinessForTarget,
+  clipOverlapsBehind,
+  matteWindowsByMediaId,
+  behindWindowsOf,
+  captionBehindWindowsOf,
+  sourceWindowKey,
+  reframeNeedsDetection,
+  reframeTargets,
+  reframeReadinessForTarget,
   BUDGET,
   BEHIND_TEXT_EXTENT,
   evaluateOcclusionBudget,

package/dist/{chunk-MMEJ3Y7E.js → chunk-QETYXKQQ.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-SIGGQRY2.js";
+} from "./chunk-W3SIWT7J.js";
 
 // ../mcp/src/wait.ts
 var defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
@@ -93,11 +93,6 @@ Download URL: ${url}`);
     }
   },
   consult: {
-    // A consult job IS a composeJob (routes/consult.ts returns consultJobId =
-    // composeJobId) — same detail op, different terminal: the advisory envelope
-    // (assessment / proposals / principles / plan), never the compose kind's
-    // "winner — render it" text. Before this kind existed, consult was a
-    // DEAD-END: its advisoryResult was unreachable over the curated surface.
     operationId: "getComposeJob",
     mapArg: (p, id, projectId) => p === "composeJobId" ? id : projectId,
     terminal: (j) => {
@@ -187,8 +182,6 @@ ${lines.join("\n\n")}${tail}`
     }
   },
   verify: {
-    // The generic jobs resource (GET /v1/jobs/{id}) — verify is its first
-    // tenant; future job kinds reuse this parser instead of adding adapters.
     operationId: "getJob",
     mapArg: (_p, id) => id,
     terminal: (j) => {
@@ -231,7 +224,6 @@ Worst-first critique: ${r.critique}`);
     }
   },
   preview: {
-    // Generic jobs resource — preview job (single-component still).
     operationId: "getJob",
     mapArg: (_p, id) => id,
     terminal: (j) => {
@@ -254,7 +246,6 @@ Inspect it, fix the component via create_component if needed, and re-preview.` :
     }
   },
   brand_kit_extract: {
-    // Generic jobs resource — brand-token extraction job.
     operationId: "getJob",
     mapArg: (_p, id) => id,
     terminal: (j) => {

package/dist/{chunk-YX2GSJK7.js → chunk-RP4SXXLJ.js}

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

package/dist/{chunk-P727GZVO.js → chunk-SAMQUUO5.js}

@@ -4,15 +4,15 @@ import {
 import {
   resolveContrast
 } from "./chunk-EMGFZ3PR.js";
+import {
+  resolveFitFontSize
+} from "./chunk-XHGZ2E77.js";
 import {
   fadeProgress,
   resolveEasing,
   staggerUp,
   wordPop
 } from "./chunk-ZFEXATWN.js";
-import {
-  resolveFitFontSize
-} from "./chunk-AYVJXDLB.js";
 
 // ../execution/primitives/src/hero-text/HeroText.tsx
 import { useCurrentFrame, useVideoConfig } from "remotion";
@@ -92,8 +92,6 @@ function HeroText({
         fontSize,
         fontWeight: fontWeight ?? 800,
         letterSpacing: "-0.02em",
-        // behind-subject host: a real off-white color, NO contrast shadow — the
-        // subject silhouette biting the letters supplies the depth.
         color: textColor ?? resolveContrast({ behindSubject: true }).textColor,
         fontFamily: fontFamily ?? resolveTypeface("display")
       }

package/dist/{chunk-RF7U3SCL.js → chunk-TD347SSX.js}

@@ -1,6 +1,6 @@
 import {
   waitForJob
-} from "./chunk-MMEJ3Y7E.js";
+} from "./chunk-QETYXKQQ.js";
 import {
   GENERATED_OPERATIONS,
   apiErrorFrom,
@@ -17,10 +17,10 @@ import {
   sniffImageMediaType,
   text,
   withMedia
-} from "./chunk-SIGGQRY2.js";
+} from "./chunk-W3SIWT7J.js";
 import {
   CURATED_TOOLS
-} from "./chunk-HI4UTTPS.js";
+} from "./chunk-AO744WIK.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;
@@ -476,9 +476,6 @@ function registerPreviewCard(server, ex, onEvent) {
         tokens: z.record(z.string()).optional().describe("Token substitutions the html references (e.g. brand colours, fonts). Same shape as the clip source `tokens`."),
         aspectRatio: z.enum(["16:9", "9:16", "1:1", "4:5"]).optional().describe("Frame to size the card into. Default 9:16 \u2014 a card that fits 16:9 often overflows vertical.")
       },
-      // Renders inline and persists nothing — the read-only stance curation.ts
-      // already takes for preview_frame. Stated in full: an omitted hint is not
-      // neutral (destructiveHint/openWorldHint default TRUE in the schema).
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
     async (args, extra) => timed(onEvent, "preview_card", async (report) => {
@@ -531,8 +528,6 @@ function registerWaitJob(server, ex, waitCapMs, onEvent) {
     "wait_job",
     {
       title: "Wait for Job",
-      // Polls status; changes nothing. Idempotent by construction — the whole
-      // continuation contract is "call again with the same arguments".
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
       description: "Wait for a long-running job and return the resolved result \u2014 a BOUNDED long-poll. Polls the job status (render / compose / consult / clip-suggestions / verify) and blocks up to the transport window (30s on the hosted transport); if the job is still running at the window it returns a `Still running` continuation \u2014 call wait_job again with the same arguments to keep waiting (the job keeps executing server-side; nothing is lost between calls). Call this right after compose / create_render / consult / suggest_briefs / score_composition / preview_component. For event-driven fan-out, create_webhook delivers the terminal instead.",
       inputSchema: {
@@ -583,9 +578,6 @@ function registerBurnedTombstones(server, onEvent) {
       {
         title: `${titleCase(b.name)} (retired)`,
         description: `RETIRED (2026-07 verb cutover) \u2014 use ${b.replacement}. ${b.reason}`,
-        // A tombstone only ever throws. Announcing it as read-only and
-        // closed-world keeps a stale agent from being made to confirm a
-        // "destructive" call that does nothing (schema defaults both to true).
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
       },
       async () => timed(onEvent, b.name, async () => errText(burnedNameError(b)))

package/dist/{chunk-NFEGPWGS.js → chunk-TFGKUWHY.js}

@@ -3,7 +3,7 @@ import {
   Copy,
   Format,
   GraphicRole
-} from "./chunk-MXFAADCQ.js";
+} from "./chunk-WZH57M53.js";
 
 // ../composition/src/validators/composePlan.ts
 import { z } from "zod";
@@ -28,7 +28,6 @@ var PlanFramingSegment = z.object({
   shotScale: z.enum(["close", "standard", "wide"]).optional(),
   zoomScale: z.number().min(0.4).max(1).optional(),
   verticalBias: z.number().min(-0.3).max(0.3).optional(),
-  /** Optional in the plan; the assembler defaults it to 0 on set_crop_intents. */
   lateralBias: z.number().min(-0.3).max(0.3).optional(),
   intent: z.string().optional()
 }).refine((s) => s.action !== "frame" || s.subject !== void 0, {
@@ -51,9 +50,6 @@ var PlanAssetRequest = z.object({
   kind: z.enum(["broll", "audio", "sfx", "music", "ambience", "gif", "image"]),
   source: z.enum(["find", "generate"]),
   intent: z.string().min(1),
-  /** Phase 1: the planner resolves `find` requests against the pool at plan
-   *  time (it has search_library) and records the pick here. Unresolved find
-   *  requests are stripped by the validator (degrade, not error). */
   resolvedMediaId: z.string().optional()
 });
 var PlanGraphicRequest = z.object({
@@ -117,7 +113,6 @@ var Colors = z2.object({
   text: z2.string().min(1),
   textMuted: z2.string().optional(),
   border: z2.string().optional(),
-  // Tier-2 core — author overrides for the derived fills + paired foregrounds.
   surface: z2.string().optional(),
   card: z2.string().optional(),
   gridLine: z2.string().optional(),
@@ -144,8 +139,6 @@ var Sizing = z2.object({
 var Motion = z2.object({
   duration: z2.number().positive().optional(),
   easing: EasingValue.optional(),
-  // Editorial motion identity — surfaces read these via `$brand:motion.*`
-  // (resolved at projection time). Mirrors the primitive `TextMotion` vocabulary.
   entrance: z2.enum(["none", "fade", "word-pop", "stagger-up"]).optional(),
   staggerMs: z2.number().nonnegative().optional(),
   exitMs: z2.number().nonnegative().optional()
@@ -155,8 +148,6 @@ var Logo = z2.object({
   src: z2.string().min(1),
   alt: z2.string().optional(),
   placement: Placement.optional(),
-  // Percentage of the composition width. Must be positive — a non-positive
-  // logo is a footgun, not an intent, so reject at the boundary.
   sizePct: z2.number().positive().optional()
 });
 var IntroOutro = z2.object({
@@ -168,7 +159,6 @@ var IntroOutro = z2.object({
 });
 var Watermark = z2.object({
   src: z2.string().min(1),
-  // Alpha in [0,1]; anything outside is a malformed kit, not a clamp target.
   opacity: z2.number().min(0).max(1).optional(),
   placement: Placement.optional()
 });
@@ -207,11 +197,6 @@ var Motif = z2.object({
     staggerMs: z2.number().int().min(0).max(2e3).optional(),
     confidence: z2.enum(["high", "low"]).optional()
   }).optional(),
-  // Pinned to the closed graphics-plan GraphicRole vocabulary — the steering
-  // matcher (designBrief.ts) is exact-equality against a plan role, so an
-  // off-vocabulary role would synthesize a judge and then silently never steer
-  // (the half-applied-conditioning failure D1-R exists to kill). Storage stays
-  // an open string (matches the motion.preset pattern).
   role: GraphicRole,
   zone: z2.object({ x: z2.number(), y: z2.number(), w: z2.number(), h: z2.number() }).optional(),
   evidence: z2.array(z2.number().int().min(0)).max(24).optional(),
@@ -237,49 +222,26 @@ var BrandKit = z2.object({
   spacing: Spacing.optional(),
   sizing: Sizing.optional(),
   motion: Motion.optional(),
-  // Per-creator caption IDENTITY collected by the dashboard / derived from a
-  // creator's references. Consumed by resolveBrandKit's caption derivation:
-  // emphasisColor → caption.fg, base/highlight color (clamped to the APCA body
-  // floor over the scrim), the backdrop `plate` treatment, per-word `entrance`
-  // motion + timing, and the emphasis treatment (base face + serif/scale/weight/
-  // italic/transform/letter-spacing + emphasis-run plate) → caption identity
-  // that the render binding applies onto the Captions primitive. The kit now
-  // owns the caption LOOK (including plate + entrance). Base GEOMETRY (caption
-  // size, screen position, safe-area, maxWidth) is NOT here — that is calibrated
-  // craft owned by the primitive's default. The kit selects the LOOK; the
-  // primitive owns the legible realization.
   captionProfile: z2.object({
-    // Base caption text color + spoken-word highlight — clamped to the APCA
-    // body floor over the scrim at projection (same guard as emphasisColor→fg).
     color: z2.string().optional(),
     highlightColor: z2.string().optional(),
     emphasisColor: z2.string().optional(),
-    // Caption backdrop plate — the whole-block legibility treatment.
     plate: z2.enum(["glass", "solid", "none"]).optional(),
-    // Per-word entrance motion + timing (the shared TextMotion vocabulary).
     entrance: z2.enum(["none", "fade", "word-pop", "stagger-up"]).optional(),
     entranceMs: z2.number().optional(),
     entranceStaggerMs: z2.number().optional(),
     exitMs: z2.number().optional(),
-    // Base caption face (the carrier-word font). Defaults to fonts.caption.
     fontFamily: z2.string().optional(),
-    // Emphasis-word treatment — the qualitative identity signal.
     emphasisFontFamily: z2.string().optional(),
     emphasisScale: z2.number().positive().optional(),
     emphasisFontWeight: z2.number().optional(),
     emphasisFontStyle: z2.enum(["normal", "italic"]).optional(),
     emphasisTextTransform: z2.enum(["none", "uppercase"]).optional(),
     emphasisLetterSpacing: z2.number().optional(),
-    // Emphasis-run highlighter plate (editorial caption look).
     emphasisPlate: z2.boolean().optional(),
     emphasisPlateColor: z2.string().optional(),
     emphasisPlateTextColor: z2.string().optional()
   }).optional(),
-  // ── Language payload (built FROM INSPIRATION) ─────────────────────────────
-  // Carried untransformed onto the wire kit so the projection (resolveBrandKit)
-  // can surface it as `ResolvedBrandKit.language`. Not a `$brand:` token root —
-  // these are exemplar/motif references the maker + judge condition on, not
-  // bindable design tokens.
   exemplarKeys: z2.array(z2.string().min(1)).max(24).optional(),
   contactSheetKey: z2.string().min(1).optional(),
   motifs: z2.array(Motif).max(24).optional(),
@@ -297,32 +259,15 @@ var BrandKit = z2.object({
   intro: IntroOutro.optional(),
   outro: IntroOutro.optional(),
   watermark: Watermark.optional(),
-  /** Brand audio identity (audio design spec 2026-07-20): default SFX intensity
-   *  + music-bed defaults. Brief `audio` wins when present (caption-identity
-   *  precedence: brand default beats brief absence; brief beats brand).
-   *
-   *  Brand SOUND kit (audio-substrate Phase 5) — identity over TIME. All four
-   *  fields are OPTIONAL; a kit that sets none behaves byte-identically to a kit
-   *  with no audio block. Refs are palette references (P2 AudioPaletteEntry.ref:
-   *  a pack soundId | music-pack bedId | org mediaId — an opaque string handle). */
   audio: z2.object({
     sfxIntensity: z2.enum(["off", "light", "standard", "dense"]).optional(),
     musicEnabled: z2.boolean().optional(),
     musicMood: z2.string().max(300).optional(),
-    /** SONIC LOGO — a brand audio signature bound to the intro/outro bookend at
-     *  compose time (an sfx-role clip at the body edge adjacent to the render
-     *  bookend). `ref` = a palette reference; `placement` = which bookend(s);
-     *  `offsetMs` shifts within. Bound only when the corresponding bumper
-     *  (kit.intro / kit.outro) exists — else a non-blocking advisory. */
     sonicLogo: z2.object({
       ref: AudioPaletteRef,
       placement: z2.enum(["intro", "outro", "both"]),
       offsetMs: z2.number().int().min(0).max(1e4).optional()
     }).optional(),
-    /** UI SOUND SET — per-family palette overrides consumed by the sfxCompile
-     *  org-first draw as the HIGHEST-priority tier (brand > org palette > pack
-     *  default), mirroring how a brand FONT sits above org defaults. Keys are the
-     *  closed SfxFamily vocabulary; values are palette refs. */
     uiSoundSet: z2.object({
       tick: AudioPaletteRef.optional(),
       pop: AudioPaletteRef.optional(),
@@ -332,19 +277,11 @@ var BrandKit = z2.object({
       whoosh: AudioPaletteRef.optional(),
       riser: AudioPaletteRef.optional()
     }).optional(),
-    /** BED STYLE — a preferred pack bed (`bedId`) or a style hint (`genre` /
-     *  `bpmRange`). SURFACED-ONLY today (compose does not auto-select a pack bed
-     *  — it uses a client-pinned bed or generates from mood); the field resolves
-     *  through the kit + surfaces via get_profile / brand-kit reads so driving
-     *  agents honor it when pinning / generating a bed. */
     bedStyle: z2.object({
       bedId: AudioPaletteRef.optional(),
       genre: z2.string().max(120).optional(),
       bpmRange: z2.object({ min: z2.number(), max: z2.number() }).optional()
     }).optional(),
-    /** AMBIENCE PREFERENCE — a preferred ambience bed (`{ref}`) or explicit
-     *  `null` (opt-out). SURFACED-ONLY (compose has no ambience auto-placement);
-     *  resolves + surfaces for driving agents. */
     ambiencePreference: z2.object({ ref: AudioPaletteRef }).nullable().optional()
   }).optional(),
   license: LicenseDeclaration.optional(),
@@ -506,9 +443,6 @@ var RenderJob = z4.object({
   destinations: z4.array(Destination).optional(),
   destinationResults: z4.array(DestinationResult).optional(),
   cancelReason: RenderCancelReason.optional(),
-  // `error` is structured (richer than the doc's plain-string spec) so the worker
-  // can surface a stable code, a human message, and operator-visible details.
-  // See CONVEX_ADAPTATIONS.md for the rationale on richer-than-doc shapes.
   error: z4.object({
     code: z4.string(),
     message: z4.string(),
@@ -574,20 +508,9 @@ import { zid as zid3 } from "convex-helpers/server/zod3";
 var Project = z6.object({
   id: zid3("projects"),
   name: z6.string().min(1),
-  // Default format applied to new Compositions created under this Project.
-  // Each Composition still carries its own Format — this is just the seed.
   defaultFormat: Format.optional(),
-  // PAL-region fps conform default. See data-model.md § MediaItem for the table.
-  // 'palConformDefault: 24' makes 25fps PAL footage conform to 24 instead of 30.
   palConformDefault: z6.union([z6.literal(24), z6.literal(30)]).optional(),
-  // Pointer to the currently-active Composition for this Project. Edits land
-  // on a new CompositionVersion each PUT; this pointer advances to the new
-  // version's id. Nullable when the Project has no active Composition (e.g.,
-  // immediately after creation, or after the active composition was hard-deleted).
   activeCompositionId: zid3("compositions").nullable().optional(),
-  // Stable external `kitId` STRING (the v1 brand-kits API id), not a strict
-  // `zid("brandKits")`. Resolved org-scoped at render by either kitId or the
-  // legacy convex `_id`. Keeps the brand reference consistent end-to-end (#33).
   brandKitId: z6.string().optional(),
   ownerOrgId: z6.string().optional(),
   createdAt: z6.number(),
@@ -628,13 +551,9 @@ var Session = z7.object({
 import { z as z8 } from "zod";
 import { zid as zid5 } from "convex-helpers/server/zod3";
 var SubstrateWebhookEvent = z8.enum([
-  // Render lifecycle — A3 terminal family (plan 2026-07-10-flow-checkpoint):
-  // ONE terminal event per kind, `status` INSIDE the payload.
   "render.completed",
-  // MediaItem lifecycle
   "media.transcribed",
   "media.completed",
-  // Composition lifecycle
   "composition.updated"
 ]);
 var WebhookDeliveryStatus = z8.enum([
@@ -648,13 +567,8 @@ var WebhookDeliveryStatus = z8.enum([
 var Webhook = z8.object({
   id: zid5("webhooks"),
   url: z8.string().url(),
-  // Open string array — substrate event names live in SubstrateWebhookEvent;
-  // domain packages export their own event enums and consumers compose them.
   events: z8.array(z8.string().min(1)).nonempty(),
-  // Standard Webhooks signing key reference; the signing secret itself is
-  // stored server-side and never round-tripped through the API surface.
   signingKeyId: z8.string().optional(),
-  // Optional headers the subscriber wants on every delivery.
   headers: z8.record(z8.string(), z8.string()).optional(),
   enabled: z8.boolean().optional(),
   ownerOrgId: z8.string().optional(),
@@ -664,7 +578,6 @@ var Webhook = z8.object({
 var WebhookDelivery = z8.object({
   id: z8.string().min(1),
   webhookId: zid5("webhooks"),
-  // Open string — could be any substrate or domain event name.
   event: z8.string().min(1),
   payload: z8.record(z8.string(), z8.unknown()),
   status: WebhookDeliveryStatus,

package/dist/{chunk-LM4WDUQJ.js → chunk-TPA6PYN2.js}

@@ -2,7 +2,7 @@ import {
   COMPOSE_PLANNER_TOOLS,
   COMPOSE_ROLE_TOOLS,
   dispatchComposeRoleTool
-} from "./chunk-VOO5FQSS.js";
+} from "./chunk-BZZTVOGG.js";
 
 // ../authoring/src/agent/buildTools.ts
 import { tool } from "ai";
@@ -119,16 +119,6 @@ function buildToolsFromSchemas(params) {
           return JSON.stringify({ error: errMsg });
         }
       },
-      // toModelOutput is the ONLY place a tool result becomes a real vision
-      // block. Returning the {type:'content',[media]} shape from execute makes
-      // the AI SDK JSON-stringify it (base64 -> ~50k TEXT tokens/image ->
-      // instant 200k overflow on capture, and the model can't actually SEE the
-      // image). Here capture_frames becomes proper image blocks (~1.6k vision
-      // tokens, viewable); everything else stays text/json.
-      // v7 hands `input` as `unknown` (it no longer narrows from the schema at
-      // this dynamic registry). Annotating the full parameter keeps this
-      // assignable — a function taking a NARROWER input than the SDK passes is
-      // not, which is what the v6 shape silently was.
       toModelOutput: ({ output }) => {
         const formatted = formatToolResult(name, output);
         return typeof formatted === "string" ? { type: "text", value: formatted } : formatted;