@cueframe/kernel 0.1.0 → 0.1.2

package/dist/{chunk-EA6MYCYW.js → chunk-2B5VJZHL.js}

@@ -14,20 +14,21 @@ function collectMediaClips(value, nearestId, out) {
   }
   if (value === null || typeof value !== "object") return;
   const obj = value;
+  if (obj.enabled === false && Array.isArray(obj.contents)) return;
   const id = typeof obj.id === "string" ? obj.id : nearestId;
   if (obj.kind === "media" && typeof obj.mediaId === "string") {
     const reframe = obj.reframe;
     const hasReframe = Array.isArray(reframe?.segments) && reframe.segments.length > 0;
     out.push({
       mediaId: obj.mediaId,
-      hasCamera: hasReframe || obj.kenBurns != null,
+      hasCamera: hasReframe || obj.kenBurns != null && obj.kenBurns !== "none",
       ...id !== void 0 ? { clipId: id } : {}
     });
     return;
   }
   for (const v of Object.values(obj)) collectMediaClips(v, id, out);
 }
-function detectAspectCropLoss(composition, dimensionsByMediaId, target) {
+function findAspectCropLosses(composition, dimensionsByMediaId, target) {
   const placed = [];
   collectMediaClips(composition, void 0, placed);
   if (placed.length === 0) return [];
@@ -42,11 +43,19 @@ function detectAspectCropLoss(composition, dimensionsByMediaId, target) {
     const label = clip.clipId ?? clip.mediaId;
     if (seen.has(label)) continue;
     seen.add(label);
-    offenders.push({ label, lostPct: Math.round((1 - visible) * 100) });
+    offenders.push({
+      ...clip.clipId ? { clipId: clip.clipId } : {},
+      mediaId: clip.mediaId,
+      lostPct: Math.round((1 - visible) * 100)
+    });
   }
+  return offenders;
+}
+function detectAspectCropLoss(composition, dimensionsByMediaId, target) {
+  const offenders = findAspectCropLosses(composition, dimensionsByMediaId, target);
   if (offenders.length === 0) return [];
   const worst = offenders.reduce((a, b) => b.lostPct > a.lostPct ? b : a);
-  const shown = offenders.slice(0, MAX_NAMED).map((o) => `${o.label} (\u2212${o.lostPct}%)`).join(", ");
+  const shown = offenders.slice(0, MAX_NAMED).map((o) => `${o.clipId ?? o.mediaId} (\u2212${o.lostPct}%)`).join(", ");
   const elided = offenders.length > MAX_NAMED ? ` (+${offenders.length - MAX_NAMED} more)` : "";
   return [
     `aspect_crop_loss \u2014 ${offenders.length} clip${offenders.length === 1 ? "" : "s"} ${offenders.length === 1 ? "is" : "are"} shaped very differently from the ${target.width}\xD7${target.height} output and author no camera, so each is centre-cropped to fill \u2014 discarding up to ${worst.lostPct}% of the picture with faces and subjects as likely to fall outside the crop as inside it: ${shown}${elided}. Author a \`reframe\` (focus a face, a point, or all-faces) or a \`kenBurns\` move on these clips, or render a format closer to their shape. Note \`fit:"contain"\` does NOT avoid this for stills \u2014 images are cropped by the still trajectory, which centres when it has no focus.`
@@ -73,32 +82,21 @@ var ReframeSegmentFields = z.object({
   endSec: z.number().positive().describe(
     "Segment END in seconds, clip-relative. The span (endSec \u2212 startSec) is this segment's duration \u2014 the window `ease` ramps over."
   ),
-  /** WHO/WHAT the camera tracks — see the `.describe()` for per-mode guidance. */
   focus: Focus.describe(
     "WHO/WHAT the camera tracks this segment (the reframe center), selected by `mode`: `frame-center` = no tracking, hold the geometric center (static/graphic footage, or a pure zoom); `point` = lock to a fixed source-normalized {x,y} (a non-moving on-screen element); `face` = track a detected face by `faceId` (from get_media_context), with optional `shotScale` close|standard|wide for tightness; `all-faces` = frame the bounding box of every detected face (group/ensemble shots); `active-speaker` = follow whoever is speaking (diarized talking-head / podcast). Pick by what the beat is about; pair with `zoom` for how tight."
   ),
-  /** Editorial language for diff/log readability ("speaker-tight",
-   *  "wide-context", "interviewer-reaction"). Not honored by the derive math
-   *  — a relabel must not bust the variant cache, so it is EXCLUDED from
-   *  `hashReframe`. */
   intent: z.string().optional().describe(
     "Optional editorial LABEL for diff/log readability (e.g. 'speaker-tight', 'wide-context'). Cosmetic \u2014 NOT honored by the derive math and excluded from the variant cache key."
   ),
-  /** <1 punches in; 1 = full frame. Omitted when `focus.shotScale` governs — the
-   *  two are MUTUALLY EXCLUSIVE (see the refine below). Absent = 1 (full frame),
-   *  which is how `hashReframe` has always canonicalized it. */
   zoom: z.number().min(0.1).max(1).optional().describe(
     "How TIGHT the framing is \u2014 the fraction of the source the output viewport shows. <1 punches IN (a smaller source fraction, magnified to fill the frame); 1 = the full frame (no crop). ~0.6\u20130.8 is a moderate push-in, ~0.5 a tight close-up, 0.1 the maximum zoom. There is NO zoom-OUT past the full frame (max 1). Omit for the full frame. MUTUALLY EXCLUSIVE with `focus.shotScale`: a face-tracked shot is sized EITHER by the editorial scale (shotScale, calibrated to the detected face) OR by an explicit zoom \u2014 never both."
   ),
-  /** Ease-in / ease-out durations (seconds) for the zoom ramp at this segment's
-   *  edges. Honored at derive time (baked into the per-frame channel). */
   ease: z.object({
     in: z.number().nonnegative().describe("Ease-IN ramp DURATION in seconds at the segment START."),
     out: z.number().nonnegative().describe("Ease-OUT ramp DURATION in seconds at the segment END.")
   }).optional().describe(
     "Zoom/center ramp DURATIONS in SECONDS at this segment's edges \u2014 NOT a unitless 0\u20131 curve. ~0.3\u20130.6s reads as a snappy push; >1s reads sluggish. Keep `in` + `out` \u2264 the segment's duration (endSec \u2212 startSec): the two edges share the span, so to ramp across the WHOLE segment set one edge to the full duration and the other to 0. Omit for an instant cut to this framing."
   ),
-  /** Optional fine framing nudge, source-normalized [-0.3,0.3]. */
   bias: z.object({
     x: z.number().min(-0.3).max(0.3).describe("Horizontal nudge, source-normalized (+ = right)."),
     y: z.number().min(-0.3).max(0.3).describe("Vertical nudge, source-normalized (+ = down).")
@@ -107,16 +105,6 @@ var ReframeSegmentFields = z.object({
   )
 });
 var ReframeSegment = ReframeSegmentFields.refine(
-  // ONE knob sizes the crop. `shotScale` and `zoom` both do, and the bake gives
-  // shotScale precedence (calibrateShotScale takes zoom only as a FALLBACK) — so a
-  // segment carrying both SILENTLY discards the zoom. That is how a stored
-  // composition came to claim `zoom: 1` (full frame) on a segment the renderer
-  // punched in to 0.55: reading the artifact said "no zoom" while the render
-  // plainly zoomed (2026-07-13). The state is incoherent, so make it
-  // unrepresentable — here, at the wire shape, not just at the authoring tools.
-  //
-  // Rows written before compile stopped stamping `zoom: 1` are MIGRATED (convex
-  // migrations: dropZoomUnderShotScale), not tolerated.
   (s) => !(s.focus.mode === "face" && s.focus.shotScale !== void 0 && s.zoom !== void 0),
   {
     message: "a face segment takes EITHER focus.shotScale (editorial scale, calibrated to the detected face) OR an explicit zoom \u2014 never both; shotScale wins at bake time and the zoom would be silently discarded",
@@ -127,6 +115,7 @@ var Reframe = z.object({ segments: z.array(ReframeSegment).min(1) });
 
 export {
   coverVisibleFraction,
+  findAspectCropLosses,
   detectAspectCropLoss,
   Focus,
   ReframeSegmentFields,

package/dist/chunk-73DQTUWY.js

@@ -0,0 +1,131 @@
+import {
+  EntityId
+} from "./chunk-XELS2BGA.js";
+
+// ../data-models/media-model/src/generation.ts
+import { z } from "zod";
+var MediaId = EntityId("media");
+var GenerationId = EntityId("generation");
+var GenerationGroupId = EntityId("generationGroup");
+var ClientRequestId = EntityId("generationRequest");
+var ProjectHome = z.enum(["local", "cloud"]);
+var MediaKind = z.enum(["image", "video", "audio"]);
+var MediaGenerator = z.enum([
+  "text-to-video",
+  "text-to-image",
+  "image-to-video",
+  "text-to-music",
+  "text-to-speech",
+  "text-to-sfx",
+  "auto"
+]);
+var GenerationReference = z.object({
+  role: z.enum(["first-frame", "last-frame", "image", "source"]),
+  mediaId: MediaId
+});
+var GenerateMediaCommand = z.object({
+  clientRequestId: ClientRequestId,
+  generator: MediaGenerator,
+  prompt: z.string().trim().min(1).max(1e4),
+  style: z.record(z.string(), z.unknown()).optional(),
+  references: z.array(GenerationReference).max(8).default([]),
+  generationGroupId: GenerationGroupId.optional(),
+  parentMediaId: MediaId.optional(),
+  variationNonce: z.string().min(1).optional()
+});
+var GenerationReceipt = z.object({
+  clientRequestId: ClientRequestId,
+  generationId: GenerationId,
+  mediaId: MediaId,
+  generationGroupId: GenerationGroupId,
+  version: z.number().int().positive(),
+  providerJobId: z.string().min(1).optional(),
+  estimateUsd: z.number().nonnegative().optional()
+});
+var GenerationStatus = z.enum([
+  "draft",
+  "submitting",
+  "queued",
+  "generating",
+  "provider_complete",
+  "materialising",
+  "processing",
+  "ready",
+  "cancelling",
+  "cancelled",
+  "failed"
+]);
+var GenerationFailure = z.object({
+  code: z.string().min(1),
+  title: z.string().min(1),
+  recovery: z.string().optional(),
+  retryable: z.boolean(),
+  correlationId: z.string().optional()
+});
+var GenerationArtifact = z.object({
+  artifactVersion: z.literal(1),
+  clientRequestId: ClientRequestId,
+  generationId: GenerationId,
+  mediaId: MediaId,
+  generationGroupId: GenerationGroupId,
+  version: z.number().int().positive(),
+  kind: MediaKind,
+  requestSummary: z.string().min(1).max(500),
+  status: GenerationStatus,
+  progress: z.number().min(0).max(1).optional(),
+  placementReady: z.boolean().default(false),
+  parentMediaId: MediaId.optional(),
+  estimateUsd: z.number().nonnegative().optional(),
+  failure: GenerationFailure.optional(),
+  createdAt: z.number().int().nonnegative(),
+  updatedAt: z.number().int().nonnegative()
+});
+var GenerationCapability = z.object({
+  generator: MediaGenerator,
+  outputKind: MediaKind,
+  referenceRoles: z.array(GenerationReference.shape.role),
+  durationSec: z.object({ min: z.number().positive(), max: z.number().positive() }).optional(),
+  aspectRatios: z.array(z.string()).optional(),
+  supportsCancellation: z.boolean(),
+  supportsParallelAttempts: z.boolean(),
+  supportsQuote: z.boolean()
+});
+var GenerationCapabilities = z.array(GenerationCapability);
+function deriveGenerationStatus(sources) {
+  const { attempt, resource, materialisation } = sources;
+  if (attempt.status === "failed") {
+    return { status: "failed", placementReady: false, ...attempt.failure ? { failure: attempt.failure } : {} };
+  }
+  if (attempt.status === "cancelled") return { status: "cancelled", placementReady: false };
+  if (attempt.status === "cancelling") return { status: "cancelling", placementReady: false };
+  if (materialisation.status === "failed") {
+    return { status: "failed", placementReady: false, ...materialisation.failure ? { failure: materialisation.failure } : {} };
+  }
+  if (!resource.durable) return { status: attempt.status, placementReady: false };
+  if (materialisation.required && (!materialisation.verifiedBytes || materialisation.status !== "complete")) {
+    return { status: "materialising", placementReady: false };
+  }
+  if (!resource.decodable || !resource.metadataReady) {
+    return { status: "processing", placementReady: false };
+  }
+  return { status: "ready", placementReady: resource.placementReady };
+}
+
+export {
+  MediaId,
+  GenerationId,
+  GenerationGroupId,
+  ClientRequestId,
+  ProjectHome,
+  MediaKind,
+  MediaGenerator,
+  GenerationReference,
+  GenerateMediaCommand,
+  GenerationReceipt,
+  GenerationStatus,
+  GenerationFailure,
+  GenerationArtifact,
+  GenerationCapability,
+  GenerationCapabilities,
+  deriveGenerationStatus
+};

package/dist/{chunk-HI4UTTPS.js → chunk-AO744WIK.js}

@@ -248,8 +248,6 @@ Call wait_job(kind="compose", id="${j.composeJobId}", projectId="${a.projectId}"
     operationId: "applyComposition",
     pathArgs: { projectId: "id" },
     description: 'Atomically apply an array of CompositionOps to a project composition. All ops succeed or none do (transactional). Pass `if_match` for optimistic-concurrency control (409 stale_etag on mismatch) and `dry_run: true` to validate the batch without persisting. Use this to seed a composition (add media clips) or make targeted edits (set a crop intent, reorder clips, set the format). CAPTIONS: attach content with {type:"captions.fromTranscript", mediaId, window?} \u2014 the server slices the cached word-timed transcript, rebases times, and sentence-splits into segments (no pasting words; 422 media_no_transcript if the media has no speech); style it with {type:"setCaptionStyle", style}; or set explicit words with {type:"setCaptions", segments, style?} (e.g. translations or your own VO timings). Brand is NOT set here \u2014 it lives on the project (create_project / PATCH /projects/:id with brandKitId). CARDS: a {kind:"card", html, tokens} clip projects each `tokens` KEY `x` to the CSS custom property `--cf-x`, so the html must read it as `var(--cf-x)` \u2014 write `tokens:{"plate":"#0af"}` + `background:var(--cf-plate)`. Do NOT put dashes in the key: `"--plate"` becomes `--cf---plate` and your `var(--plate)` then resolves to NOTHING, which CSS silently degrades to a transparent background and black text. Responses carry `warnings[]` when a card reads a var nothing defines.',
-    // A dry_run returns HTTP 200 { valid, errors } — branch on it so a FAILED
-    // validation is never reported as "applied" (the route returns 200 either way).
     okFormat: (j, a) => {
       const warns = formatWarnings(j);
       if (j && typeof j.valid === "boolean") {
@@ -259,9 +257,6 @@ ${JSON.stringify(r.errors ?? [], null, 2)}${warns}`;
       }
       return `Ops applied${a.projectId ? ` to project ${a.projectId}` : ""}.${warns}`;
     },
-    // Teach the TARGETED patch: one clip, only the fields that change. The
-    // measured anti-pattern is re-emitting a whole card source per tweak
-    // (44-92s turns); a patch of position/opacity/params is seconds.
     inputExamples: [
       {
         input: {
@@ -302,27 +297,11 @@ Call wait_job(kind="render", id="${j.id}", projectId="${a.projectId}") to block
     operationId: "previewFrame",
     pathArgs: { projectId: "id" },
     description: "Render presigned PNG still(s) of the composition at the given timestamps \u2014 the live preview for layout/copy judgment. STATELESS: nothing to open, warm, or close; concurrent previews don't contend. Defaults to the PERSISTED state: absent `body.composition` \u21D2 the project's ACTIVE composition \u2014 exactly what create_render will encode; pass `body.compositionId` to target a specific persisted composition (stale/foreign id \u21D2 404, never a silent fallback). The response's `previewed` field names what was rendered ({source: 'persisted'|'inline'|'scratch', compositionId?, etag?}) \u2014 trust a preview as render-truth ONLY when source is 'persisted'. `body.timestamps` = seconds to sample. A still cannot show motion \u2014 judge motion with preview_clip (a window of the composition) or preview_component (one graphic).",
-    // The most-called visual tool, and it returned a JSON blob of presigned
-    // links: the agent was told to judge layout and copy it could not see.
     preview: {
       urls: (j) => (Array.isArray(j?.stills) ? j.stills : []).map((st) => st?.url),
       kind: "image",
       cap: 12
     },
-    // WITHOUT THIS, THE PIXELS SHIP TWICE — ONCE AS TEXT.
-    //
-    // The generic path falls back to `res.text` when a spec has no okFormat, so
-    // the model saw the WHOLE response JSON, `stills[].url` included, ALONGSIDE
-    // the image blocks. On the cloud lane that is a presigned link per still —
-    // wasteful. On the desktop lane (LocalExecutor serves this route out of the
-    // webview and has no R2, so it answers with `data:` URLs carrying the bytes
-    // inline) it is the ENTIRE IMAGE duplicated as base64 TEXT: 12 stills ≈
-    // hundreds of thousands of junk tokens, and the text copy is the one the
-    // model cannot see.
-    //
-    // So: a `data:` url is DROPPED (the bytes are already arriving as a media
-    // block — the text copy is pure waste). A real http(s) url is KEPT, because
-    // there it is 200 characters and an MCP host can open it.
     okFormat: (j, a) => {
       const stills = Array.isArray(j?.stills) ? j.stills : [];
       const p = j?.previewed ?? {};
@@ -420,8 +399,6 @@ Call wait_job(kind="verify", id="${j.jobId}") to block until the scores + checkp
     operationId: "getCheckpoint",
     pathArgs: { checkpointId: "id" },
     description: "Read a checkpoint packet \u2014 the durable approval unit a held compose pauses at (wait_job reports awaiting_input with {checkpointId, stage, version}). Carries the stage artifact, presigned storyboard stills (REVIEW THE EVIDENCE, not raw JSON), critic verdicts, the money triple {thisStepUsd, jobSpendSoFarUsd, estimatedJourneyTotalUsd} to relay to your human, and the recorded decision once resolved. When the Brief's gates set reviewMode:'hosted' the packet also carries reviewUrl \u2014 a browser review page where your human decides directly (relay THAT link instead of raw stills; you learn the decision via checkpoint webhooks / wait_job). Answer an awaiting packet with resume(checkpointId, ...).",
-    // The packet grades stills the agent was never shown: it got a score and a
-    // text critique and was told to 'fix the lowest criterion' sight-unseen.
     preview: {
       urls: (j) => Array.isArray(j?.stillUrls) ? j.stillUrls : [],
       kind: "image",
@@ -451,12 +428,6 @@ Call wait_job(kind="verify", id="${j.jobId}") to block until the scores + checkp
     description: "Delete a brief. Compose jobs already run from it are unaffected (they snapshot)."
   },
   {
-    // A12 cutover note: 'adopt_candidate' is BURNED (tombstoned); the
-    // capability survives as select_candidate because consult(amend) proposals
-    // carry only a candidateIndex — without a curated select the amend mode is
-    // a dead-end (the exact defect plan-1 fixed). The full fold into the
-    // checkpoint review model (consult minting a score packet you resume) is
-    // plan-5 scope.
     name: "select_candidate",
     operationId: "selectComposeCandidate",
     pathArgs: { projectId: "id", composeJobId: "composeJobId" },
@@ -474,10 +445,6 @@ Call wait_job(kind="verify", id="${j.jobId}") to block until the scores + checkp
     description: "DISCOVER WHAT TO BUILD WITH \u2014 list the component catalog: the FULL built-in primitive catalog (text, effects, transitions, layouts, backgrounds, and scenes: lower-third, cinematic-title, color-grade, product-launch-trailer, \u2026) PLUS your org-installed components. Use it for UTILITY furniture (captions, grades, transitions, backgrounds, scenes) and as REFERENCE CODE (get_component_source) \u2014 for BRAND or text graphics, default to authoring your OWN `kind:'card'` clip (your HTML + tokens, poster-grade typography) shelled with `applyMotionPreset`; a catalog text primitive is the quick generic fallback, not the identity path. Narrow with filters: `category` (text|effects|transitions|layouts|backgrounds|ui-blocks|scenes), `kind` (component|transition|scene), `tier` (recommended|standard|niche), `useCase` (intro|outro|full-scene|title-over-footage|transition|background|grade|emphasis|explainer|social-cut), `mood`, or free-text `q`/`intent` (e.g. intent='intro'). When any filter is set, results are recommended-tier-first. With NO `limit` the whole filtered catalog returns in one page. Each entry carries a `placement` hint = exactly how to author it via apply_composition ({kind:'overlay'|'effect', primitiveId} for built-ins; {kind:'component', componentId} for installed), `tier`/`useCase` to pick by, and `fixedCopy` (on-screen strings it BAKES that no param changes \u2014 fork via get_component_source to edit). Read cueframe://component/{id} for the full prop schema.",
     okFormat: (j) => formatComponentList(j),
     annotations: { readOnlyHint: true },
-    // 103 visual primitives described in PROSE — an agent picked silk-flow-bg
-    // over vector-field from a sentence. The renders and the CDN have existed
-    // for a while; this is the join. Best-effort by design: org-installed
-    // components have no published preview, and a miss yields no thumbnail.
     preview: {
       urls: (j) => (Array.isArray(j?.data) ? j.data : []).map((e) => CATALOG_PREVIEWS[e?.id]),
       kind: "image",
@@ -578,7 +545,7 @@ Render it with create_render(projectId="${a.projectId}", body={ compositionId: "
   {
     name: "generate_media",
     operationId: "generateMedia",
-    description: 'Generate a media item from a prompt (generator: text-to-video | text-to-image | image-to-video | auto). Returns { id, status:"generating", estimateUsd? }; returns 402 if the estimate exceeds the per-call ceiling. Async \u2014 poll list_media or use a webhook (media.completed \u2014 status rides the payload). Use the returned id like any other media item.'
+    description: 'Generate one first-class Library media item from a prompt. Choose generator: text-to-video | text-to-image | image-to-video | text-to-music | text-to-speech | text-to-sfx | auto. Put aspect/duration/voice/model controls in body.style and first/last/image references in body.refs. Returns { id, status:"generating", workflowId?, estimateUsd? }; returns 402 if the estimate exceeds the per-call ceiling. Async \u2014 poll list_media or use a webhook (media.completed \u2014 status rides the payload). Use the returned id like any other media item.'
   },
   {
     name: "create_upload",
@@ -596,15 +563,10 @@ Render it with create_render(projectId="${a.projectId}", body={ compositionId: "
     operationId: "searchResources",
     description: "Search licensed STOCK media to compose with \u2014 video/photo (Pexels + Pixabay fallback), sfx (Freesound, CC0-only), gif (Klipy). Pass query for ONE search, or queries[] (\u226410) to run them all in a SINGLE call \u2014 strongly prefer the batch when you know several things you need (a 64-search session spent 5m10s on serial round-trips). A batch returns results[], one per query in order, each with its own candidates; a query that fails carries an error and never discards the others. Optional kind [default video], provider pin, limit \u226450 apply to every query in the batch. Returns ranked candidates, each with an opaque candidateId + attribution (author, assetUrl) + license, and a preview URL in the text. FREE + rate-limited + 7-day cached \u2014 reach for this before generate_media when real footage beats synthesis. TO SEE the candidates rather than read about them, pass limit \u22652: thumbnails/audio are attached only when you asked for options to compare, because a preview of a single forced choice is pure cost. Import a chosen candidate into a project with import_resource. Candidates expire after 7 days (re-search to refresh a candidateId).",
     okFormat: (j) => formatResourceCandidates(j),
-    // Stock was picked from resolution, duration and author name — eight
-    // near-identical clips in one session. Thumbnails end that. But ONLY when
-    // there is something to pick BETWEEN: see `attach` on CuratedTool.preview.
     preview: {
       urls: (j) => (Array.isArray(j?.results) ? j.results.flatMap((r) => Array.isArray(r?.candidates) ? r.candidates : []) : Array.isArray(j?.candidates) ? j.candidates : []).map((c) => c?.previewUrl),
       kind: (j) => (j?.kind ?? j?.results?.[0]?.kind) === "sfx" ? "audio" : "image",
       cap: 12,
-      // A batch is by definition a comparison, so its previews are earned. A
-      // single-query search returning one candidate still gets none.
       attach: (j) => Array.isArray(j?.results) ? true : (Array.isArray(j?.candidates) ? j.candidates.length : 0) > 1
     },
     annotations: { readOnlyHint: true }
@@ -792,7 +754,6 @@ Call wait_job(kind="brand_kit_extract", id="${j.jobId}") for the tokens (re-call
   }
 ];
 var INTERNAL_EDITOR_TOOLS = [
-  // Read — orient, then look. get_context is the one-call opener.
   "get_context",
   "get_composition",
   "get_media_context",
@@ -805,17 +766,14 @@ var INTERNAL_EDITOR_TOOLS = [
   "score_composition",
   "validate_composition",
   "analyze_transcript",
-  // Mutate — the L1 op union is the ONLY way an edit happens.
   "apply_composition",
   "new_composition",
   "derive_composition",
-  // Assets
   "import_media",
   "import_resource",
   "create_component",
   "generate_media",
   "search_fonts",
-  // Jobs + account
   "create_render",
   "wait_job",
   "get_usage",

package/dist/{chunk-GA23TRNR.js → chunk-BKHGL4MB.js}

@@ -1,3 +1,6 @@
+import {
+  DashboardPopulate
+} from "./chunk-ZSZABOE5.js";
 import {
   resolveTypeface
 } from "./chunk-BDMTUEEZ.js";
@@ -7,10 +10,7 @@ import {
 import {
   FitText,
   resolveFitFontSize
-} from "./chunk-AYVJXDLB.js";
-import {
-  DashboardPopulate
-} from "./chunk-ZSZABOE5.js";
+} from "./chunk-XHGZ2E77.js";
 import {
   ACCENT,
   ACCENT_DEEP,
@@ -47,7 +47,6 @@ import { Sequence, interpolate, useCurrentFrame } from "remotion";
 var FONT_MONO = "monospace";
 var DEFAULT_CODE = `import { motion } from "remotion";
 
-// Generate a hero scene
 export function Hero() {
   const frame = useCurrentFrame();
   const opacity = frame / 30;
@@ -3622,7 +3621,6 @@ function ToolMenuSlideIn({
         overflow: "hidden",
         background,
         fontFamily: FONT_FAMILY6,
-        // subtle dot grid for editor-canvas feel
         backgroundImage: "radial-gradient(rgba(255,255,255,0.045) 1px, transparent 1px)",
         backgroundSize: "22px 22px"
       }
@@ -4571,7 +4569,6 @@ function AIGenerateOverlay({
           inset: 0,
           background: sourceImageBg,
           filter: `blur(${blur}px)`,
-          // Slight scale to hide the blur edge feathering at the viewport border.
           transform: "scale(1.06)"
         }
       }
@@ -5491,8 +5488,7 @@ function PipelineJourney({
       const t = Math.min(confettiFrame / lifespan, 1);
       const eased = 1 - (1 - t) * (1 - t);
       const px = doneCenter.x + Math.cos(angle) * dist * eased + drift * t;
-      const py = doneCenter.y + Math.sin(angle) * dist * eased + // gravity
-      t * t * 220;
+      const py = doneCenter.y + Math.sin(angle) * dist * eased + t * t * 220;
       const opacity = interpolate25(t, [0, 0.7, 1], [1, 1, 0]);
       const rot = pseudoRandom(i + 11) * 360 + confettiFrame * 12;
       return /* @__PURE__ */ React.createElement(
@@ -6025,9 +6021,7 @@ var WAYPOINTS = [
   { x: 460, y: 260, press: true },
   { x: 460, y: 360, press: true },
   { x: 280, y: 380, press: true },
-  // Lift between faces
   { x: 640, y: 220, press: false },
-  // Right face
   { x: 820, y: 280, press: true },
   { x: 1e3, y: 260, press: true },
   { x: 1e3, y: 360, press: true },
@@ -7857,8 +7851,6 @@ var config23 = {
   ],
   textParam: "prompt",
   subtextParam: null,
-  // `prompt` is a param (it types into the input); the generated dashboard card
-  // labels are BAKED faux-data — no param changes them.
   fixedCopy: [
     "Revenue",
     "Active Users",

package/dist/{chunk-VOO5FQSS.js → chunk-BZZTVOGG.js}

@@ -4,16 +4,16 @@ import {
 import {
   getPrimitiveSubtextParam,
   getPrimitiveTextParam
-} from "./chunk-ZB3C3HM7.js";
+} from "./chunk-DCVJWGIA.js";
 import {
   selectAllOverlays
-} from "./chunk-XWKZB5U5.js";
+} from "./chunk-ICSZF37W.js";
 import {
   ComposePlan
-} from "./chunk-NFEGPWGS.js";
+} from "./chunk-TFGKUWHY.js";
 import {
   OverlayClipSource
-} from "./chunk-MXFAADCQ.js";
+} from "./chunk-WZH57M53.js";
 
 // ../authoring/src/tools/toolSets.ts
 var COMPOSE_PLANNER_TOOLS = [
@@ -62,24 +62,14 @@ var COMPOSE_ROLE_TOOLS = Object.freeze({
     description: "Get current project state: transcript with word-level timings, clips on timeline, overlays, brand kit, imported assets, playhead time, timeline duration, and FPS. Always call this first.",
     schema: z.object({}),
     metadata: { label: "Get Context" },
-    // Always reads the LIVE composition. The session-cached context seeds the
-    // system prompt only; a tool call must see clips added since the run began.
     handler: async (_args, capabilities) => {
-      const { buildDirectorContext } = await import("./context-OKX3HHFS.js");
+      const { buildDirectorContext } = await import("./context-JLLU3MYD.js");
       return buildDirectorContext(capabilities);
     }
   },
   get_word_timings: {
     name: "get_word_timings",
-    description: (
-      // NAMES NO OTHER TOOL, DELIBERATELY. It used to say "call this BEFORE
-      // delete_ranges" — a verb deleted with the hand-written registry, and one
-      // neither role that holds this tool could ever have called anyway (the
-      // planner RECORDS cuts in its plan; the motion pass does not cut at all).
-      // Whoever consumes the range differs per lane, so the description stops at
-      // the timings and lets the lane's own prompt say what to do with them.
-      "Get precise word-level timestamps for a section of the transcript. Call this BEFORE you name a cut range, so the range lands on real word boundaries instead of a rounded guess. On the library page, pass poolItemId to read a specific media item."
-    ),
+    description: "Get precise word-level timestamps for a section of the transcript. Call this BEFORE you name a cut range, so the range lands on real word boundaries instead of a rounded guess. On the library page, pass poolItemId to read a specific media item.",
     schema: z.object({
       startTime: z.coerce.number().min(0).describe("Start of time range in seconds"),
       endTime: z.coerce.number().min(0).describe("End of time range in seconds"),
@@ -154,10 +144,6 @@ ${overlay.params.jsxSource}`);
       sourceCode: z.string().max(1e4).optional().describe("New JSX source code for the overlay"),
       transition: z.enum(["fade", "slide", "wipe", "none"]).optional().describe("New transition type"),
       sequenceGroup: z.string().optional().describe("New sequence group ID"),
-      // Depth + primitive fields — editing an overlay can change its primitive,
-      // params bag, and depth (zPlane/parallax/anchor) instead of silently
-      // stripping them. Omitting any of these PRESERVES the overlay's existing
-      // value (the handler merges; it does not replace the whole source).
       primitiveId: z.string().optional().describe(
         'Switch the overlay to a different primitive component ID (e.g. "lower-third", "heroText"). Omit to keep the current primitive.'
       ),
@@ -281,8 +267,6 @@ ${overlay.params.jsxSource}`);
     schema: z.object({}),
     metadata: { label: "Score Composition", dedupExempt: true },
     toModelOutput: (result) => ({ type: "text", value: result.slice(0, 1200) }),
-    // One call (the judge is expensive); a render/eval failure throws and the
-    // tool framework converts it to a tool error — no fallback string.
     handler: async (_args, capabilities) => {
       if (!capabilities.verify) return { error: "Composition scoring not available." };
       return await capabilities.verify.verify();
@@ -299,9 +283,6 @@ ${overlay.params.jsxSource}`);
       staggerMs: z.number().int().min(40).max(400).optional().describe("stagger-reveal only: per-child delay; default 120.")
     }),
     metadata: { label: "Apply Motion Preset", dedupExempt: true },
-    // The agent decides (preset + timing); the shell/mint/swap mechanics live in
-    // the consumer's capability. A throw surfaces as a tool error — no silent
-    // degrade.
     handler: async (args, capabilities) => {
       if (!capabilities.motionPreset) return { error: "Motion presets not available." };
       return await capabilities.motionPreset.apply(
@@ -312,37 +293,11 @@ ${overlay.params.jsxSource}`);
   search_library: {
     name: "search_library",
     description: 'Search across all media in the library. Combines transcript text search (fast, exact match) with semantic scene search (CLIP text-to-image similarity). Use for questions like "find clips about pricing" or "find scenes with mountains".',
-    // `mode` is GONE with the branch it steered. It only ever selected between
-    // the transcript and scene halves of the desktop library-search result;
-    // this lane returns a pre-curated candidate pool, where the arg had no
-    // effect. An accepted-and-ignored argument is a lie the schema tells.
     schema: z.object({
       query: z.string().min(1).describe("Search query \u2014 a word/phrase or a visual concept")
     }),
     metadata: { label: "Search Library" },
     inputExamples: [{ input: { query: "pricing discussion" } }],
-    /**
-     * ONE result shape, and it is the compose lane's.
-     *
-     * The only caller is the compose PLANNER, whose `resources.searchLibrary`
-     * (`buildComposeCapabilitiesForClip`) returns a RICH ARRAY: the pre-curated,
-     * relevance-scored enrichment pool for the clip being planned, carrying the
-     * editorial context (kind / provider / query / reason) it needs to pick well.
-     *
-     * The `{transcriptMatches, clipMatches}` branch that used to sit under this
-     * one is DELETED: it was the desktop library-search shape, and desktop
-     * `search_library` is a curated `/v1` tool now (`GET /v1/media/search`),
-     * served by `LocalExecutor`. Nothing reaches this handler with that shape,
-     * so keeping the formatter would have been 27 lines of code claiming a
-     * capability that cannot occur — the same phantom-branch class the registry
-     * deletion exists to end. An unexpected shape now says so, loudly.
-     *
-     * This whole formatter used to be a GLOBAL runtime override the Director
-     * installed at module load (`registerToolHandlers({search_library: …})`),
-     * so one consumer's formatting silently replaced every other consumer's —
-     * and it collided by NAME with the curated `/v1` `search_library`. Binding it
-     * to the handler removes the collision by construction.
-     */
     handler: async (args, capabilities) => {
       const searchFn = capabilities.resources?.searchLibrary;
       if (!searchFn) return { error: "Library search not available. Configure a resource provider." };
@@ -378,8 +333,6 @@ ${overlay.params.jsxSource}`);
     schema: ComposePlan,
     metadata: { label: "Submit Compose Plan" },
     strict: true,
-    // Deliver the raw plan args to the planning run's sink (the worker
-    // re-validates against the canonical ComposePlan).
     handler: async (args, capabilities) => {
       if (!capabilities.planSink) {
         return { error: "submit_compose_plan is only available in the planning phase." };
@@ -397,8 +350,6 @@ ${overlay.params.jsxSource}`);
       )
     }),
     metadata: { label: "Amend Compose Plan" },
-    // Same sink, tagged so the worker distinguishes ops from a full plan.
-    // Canonical op validation + apply + post-condition live worker-side.
     handler: async (args, capabilities) => {
       if (!capabilities.planSink) {
         return { error: "amend_compose_plan is only available in the planning phase." };

package/dist/{chunk-ODL7GQJG.js → chunk-CAJQ7H5A.js}

@@ -1,41 +1,41 @@
 import {
   isContrastCritical
-} from "./chunk-7DHP4ESU.js";
-import {
-  catalog
-} from "./chunk-OLFOPQCA.js";
-import {
-  catalog as catalog3
-} from "./chunk-AWT3P5ZN.js";
+} from "./chunk-YLDMAZZE.js";
 import {
   catalog as catalog6
-} from "./chunk-GA23TRNR.js";
-import {
-  catalog as catalog5
-} from "./chunk-PMY24FUD.js";
+} from "./chunk-BKHGL4MB.js";
 import {
   catalog as catalog2
-} from "./chunk-ABL557OT.js";
+} from "./chunk-GMD33ZD7.js";
 import {
   catalog as catalog8
-} from "./chunk-P727GZVO.js";
+} from "./chunk-SAMQUUO5.js";
 import {
   catalog as catalog4
-} from "./chunk-YX2GSJK7.js";
+} from "./chunk-RP4SXXLJ.js";
 import {
   catalog as catalog7
-} from "./chunk-SW336CJP.js";
+} from "./chunk-DYZE7JZA.js";
+import {
+  catalog
+} from "./chunk-UQSOS726.js";
+import {
+  catalog as catalog3
+} from "./chunk-AWT3P5ZN.js";
+import {
+  catalog as catalog5
+} from "./chunk-G5BFI32U.js";
 import {
   getPrimitiveSubtextParam,
   getPrimitiveTextParam
-} from "./chunk-ZB3C3HM7.js";
+} from "./chunk-DCVJWGIA.js";
 import {
   NEUTRAL_RAMP
 } from "./chunk-JF4JJAFP.js";
 import {
   CueframeError,
   encodeError
-} from "./chunk-37NJ27UU.js";
+} from "./chunk-LLUW26BS.js";
 
 // ../execution/compose/src/primitiveRegistry.ts
 var allCatalogs = [