@cueframe/kernel 0.2.33 → 0.2.35

package/dist/_members/errors/registry.d.ts

@@ -1557,6 +1557,12 @@ export declare const ERROR_CODES: {
         readonly retryable: true;
         readonly httpStatus: 504;
     };
+    readonly still_batch_too_large: {
+        readonly stage: "validate";
+        readonly category: "authoring";
+        readonly retryable: false;
+        readonly httpStatus: 422;
+    };
     readonly sighted_provider_unreachable: {
         readonly stage: "render";
         readonly category: "transient";

package/dist/_members/plane/contract.d.ts

@@ -1,4 +1,38 @@
 import { z } from "zod";
+/**
+ * Still-capture budget. ONE definition, because the batch a caller may ask for
+ * and the time the renderer is given to serve it are the same number seen from
+ * two ends — and when they drifted apart, the API accepted work the renderer
+ * provably could not finish.
+ *
+ * What went wrong (CUE-39): `timestamps` had no maximum, while the Modal still
+ * worker computed `min(280, 60 + 45 * beats)`. The per-beat term is dead above
+ * four beats — the cap TRUNCATES the budget instead of refusing the batch — so
+ * a 124-beat request got the same 280s as a 5-beat one. It burned the full 280s
+ * and failed with an untyped `render_still_failed`.
+ *
+ * MAX_STILL_BEATS_PER_BATCH is DERIVED, not chosen. The still worker is
+ * `@modal.batched`, so up to CO_BATCHED_CALLERS callers share ONE harness run
+ * and one ceiling. The largest per-caller batch that survives the worst case is
+ * therefore the largest N where
+ *
+ *   BASE + PER_BEAT * (N * CO_BATCHED_CALLERS) <= CEILING
+ *
+ * which is 18 (19 overflows at 288s). Two independent facts agree with
+ * PER_BEAT = 3s: the verify lane's worst case is 6 eval beats x 3 burst frames
+ * = 18 stills and production serves it co-batched today, and the 124-beat
+ * request in the report needed ~432s against the 280s ceiling. `stillBudget`
+ * tests pin the inequality, so moving any one of these numbers alone fails.
+ */
+export declare const STILL_BUDGET_BASE_S = 60;
+export declare const STILL_BUDGET_PER_BEAT_S = 3;
+/** Below the Modal still worker's hard 300s function timeout. */
+export declare const STILL_BUDGET_CEILING_S = 280;
+/** `STILL_BATCH_MAX` on the still worker: callers sharing one harness run. */
+export declare const CO_BATCHED_CALLERS = 4;
+export declare const MAX_STILL_BEATS_PER_BATCH = 18;
+/** Seconds the harness needs for `beats` stills in one run. */
+export declare function stillBudgetSeconds(beats: number): number;
 export declare const PreviewFrameRequest: z.ZodObject<{
     composition: z.ZodOptional<z.ZodUnknown>;
     compositionId: z.ZodOptional<z.ZodString>;

package/dist/authoring.js

@@ -48,7 +48,7 @@ import {
   formatPlanSteps,
   initCodeGenPrompts
 } from "./chunk-Y4HPN4BC.js";
-import "./chunk-GMVUJYPM.js";
+import "./chunk-AYOVAVNO.js";
 import {
   cssLayoutVars
 } from "./chunk-W5W3FDDI.js";
@@ -62,7 +62,7 @@ import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-A3MXR6JI.js";
+import "./chunk-QSWONRX2.js";
 import "./chunk-7PA7FGLD.js";
 import {
   collectSceneClipIssues,

package/dist/{chunk-3OOMVQ6I.js → chunk-5YO4LAB7.js}

@@ -312,7 +312,7 @@ Call wait_job(kind="compose", id="${j.composeJobId}", projectId="${a.projectId}"
     name: "apply_composition",
     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 / update_project with brandKitId \u2014 or PATCH /projects/:id over REST). 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. SCENE SHOTS: for a 3D product shot \u2014 a tilted page screenshot, a lit laptop/phone showing a real screenshot, two-colour type, a colour-field backdrop, focus/grain/vignette and a camera move \u2014 use {type:"scene.add", clipId, newTrack|trackId, startTime, duration, scene, assets} and revise it with {type:"scene.update", clipId, scene?, assets?, startTime?, duration?}. You author a scene SPEC, never wrapper TSX; the server registers the component for you. There is NO built-in scene primitive in list_catalog \u2014 READ cueframe://scene-shot first for the JSON schema, the canonical V2 world-objects recipe with nested groups, slabs, pages, phones, laptops, world/screen text, admitted surfaces, camera motion, lighting, and the current resource limits.',
+    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. Ops land on the project\'s ACTIVE composition unless you pass `composition_id` (mutually exclusive with `session_id`), which targets a specific one \u2014 that is how you author a second composition minted with new_composition and run an A/B. 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 / update_project with brandKitId \u2014 or PATCH /projects/:id over REST). 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. SCENE SHOTS: for a 3D product shot \u2014 a tilted page screenshot, a lit laptop/phone showing a real screenshot, two-colour type, a colour-field backdrop, focus/grain/vignette and a camera move \u2014 use {type:"scene.add", clipId, newTrack|trackId, startTime, duration, scene, assets} and revise it with {type:"scene.update", clipId, scene?, assets?, startTime?, duration?}. You author a scene SPEC, never wrapper TSX; the server registers the component for you. There is NO built-in scene primitive in list_catalog \u2014 READ cueframe://scene-shot first for the JSON schema, the canonical V2 world-objects recipe with nested groups, slabs, pages, phones, laptops, world/screen text, admitted surfaces, camera motion, lighting, and the current resource limits.',
     okFormat: (j, a) => {
       const warns = formatWarnings(j);
       if (j && typeof j.valid === "boolean") {
@@ -569,7 +569,7 @@ etag: ${j.etag}`
     name: "get_composition",
     operationId: "getComposition",
     pathArgs: { projectId: "id" },
-    description: "READ BACK the project's active composition as JSON \u2014 the edit itself: tracks, clips, card HTML, reframe segments, captions, markers, format. This is what create_render encodes, so it is also what you hand to validate_composition (which needs a full inline composition body), what you diff after an edit, and what you archive/share so someone else can re-render the SAME video. Read-only and free. Authoring stays op-based (apply_composition) \u2014 do not round-trip this object back as a write. A composition too large to fit one MCP result degrades to a STRUCTURAL SUMMARY (every track and clip still listed; card html and caption words elided as lengths) with a header saying so \u2014 read it over REST if you need the verbatim body.",
+    description: "READ BACK a composition as JSON \u2014 the edit itself: tracks, clips, card HTML, reframe segments, captions, markers, format. This is what create_render encodes, so it is also what you hand to validate_composition (which needs a full inline composition body), what you diff after an edit, and what you archive/share so someone else can re-render the SAME video. Read-only and free. Authoring stays op-based (apply_composition) \u2014 do not round-trip this object back as a write. A composition too large to fit one MCP result degrades to a STRUCTURAL SUMMARY (every track and clip still listed; card html and caption words elided as lengths) with a header saying so \u2014 read it over REST if you need the verbatim body. Defaults to the project's ACTIVE composition; pass `compositionId` to read a specific one (the same id apply_composition takes as `composition_id`, and preview_frame / create_render take as compositionId) so an A/B variant can be read back, not just written.",
     okFormat: (j) => formatComposition(j),
     annotations: { readOnlyHint: true }
   },

package/dist/{chunk-RAPDICTC.js → chunk-6PBYCESM.js}

@@ -1,6 +1,6 @@
 import {
   CueframeError
-} from "./chunk-A3MXR6JI.js";
+} from "./chunk-QSWONRX2.js";
 import {
   bundledFontFamilyFaces,
   isGenericOnlyStack,