@cueframe/kernel 0.2.34 → 0.2.36

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-RAPDICTC.js → chunk-6PBYCESM.js}

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

package/dist/{chunk-GMVUJYPM.js → chunk-AYOVAVNO.js}

@@ -6,7 +6,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-A3MXR6JI.js";
+} from "./chunk-QSWONRX2.js";
 
 // ../composition/src/projection/cardTokens.ts
 var CARD_MOTION_VAR_NAMES = [

package/dist/{chunk-4RREA7VA.js → chunk-BUAAQDDJ.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-OSMXQV5V.js";
 import {
   CueframeError
-} from "./chunk-A3MXR6JI.js";
+} from "./chunk-QSWONRX2.js";
 
 // ../execution/render-harness/src/cardAssetAdmission.ts
 import parseCss from "css-tree/parser";

package/dist/{chunk-ANNB4VC6.js → chunk-F2HXB6RG.js}

@@ -555,6 +555,7 @@ __export(zod_exports, {
   previewFrameJobBodyJpegQualityMax: () => previewFrameJobBodyJpegQualityMax2,
   previewFrameJobBodyScaleMax: () => previewFrameJobBodyScaleMax2,
   previewFrameJobBodyScaleMin: () => previewFrameJobBodyScaleMin2,
+  previewFrameJobBodyTimestampsMax: () => previewFrameJobBodyTimestampsMax2,
   previewFrameJobParams: () => PreviewFrameJobParams,
   previewFrameJobResponse: () => PreviewFrameJobResponse,
   previewSelectorBody: () => PreviewSelectorBody,
@@ -7603,6 +7604,7 @@ var PreviewComponentBody = zod146.strictObject({
 
 // ../sdk/src/generated/zod/models/previewFrameJobBody.zod.ts
 import * as zod147 from "zod";
+var previewFrameJobBodyTimestampsMax = 18;
 var previewFrameJobBodyScaleMin = 0.1;
 var previewFrameJobBodyScaleMax = 1;
 var previewFrameJobBodyJpegQualityMax = 100;
@@ -7610,7 +7612,7 @@ var PreviewFrameJobBody = zod147.strictObject({
   "composition": zod147.unknown().optional().describe("The composition to render. Absent \u21D2 the project's ACTIVE composition \u2014 what create_render will encode. The response's `previewed.source` names what was rendered."),
   "compositionId": zod147.string().optional().describe("Preview a SPECIFIC persisted composition of this project (create_render parity). Absent \u21D2 the active one. A stale/foreign id is a 404 \u2014 never a silent fall-through."),
   "session_id": zod147.string().optional().describe("Compose-session id: render that session's SCRATCH composition (what the session has been editing) instead of the active row. Ignored when `composition` is passed."),
-  "timestamps": zod147.array(zod147.number()).min(1),
+  "timestamps": zod147.array(zod147.number()).min(1).max(previewFrameJobBodyTimestampsMax).describe("Composition seconds to capture, 18 per request. The batch renders as ONE unit of work \u2014 one warm container, one source decode, N seeks \u2014 and that unit has a fixed time budget, so a larger batch is refused here rather than accepted and timed out minutes later. For a denser sweep, split it across calls; identical beats are served from the still cache, so overlapping batches are cheap."),
   "imageFormat": zod147.enum(["png", "jpeg"]).optional().describe("Still format. Default jpeg \u2014 these pixels go to a vision model, where jpeg is equivalent and png costs multiples in bytes to store and move. Pass png only when you need full fidelity."),
   "scale": zod147.number().min(previewFrameJobBodyScaleMin).max(previewFrameJobBodyScaleMax).optional().describe("Render scale 0.1\u20131. Default 0.5, which is what this schema has always recommended for vision-bound looks. Pass 1 when judging fine detail \u2014 it costs ~4x the vision tokens."),
   "jpegQuality": zod147.int().min(1).max(previewFrameJobBodyJpegQualityMax).optional().describe("JPEG quality (jpeg only). Default 70 \u2014 the quality the eval panel grades at.")
@@ -8864,6 +8866,7 @@ var ScoreCompositionResponse = JobEnqueueResponse;
 var PreviewFrameJobParams = zod224.object({
   "id": zod224.string()
 });
+var previewFrameJobBodyTimestampsMax2 = 18;
 var previewFrameJobBodyScaleMin2 = 0.1;
 var previewFrameJobBodyScaleMax2 = 1;
 var previewFrameJobBodyJpegQualityMax2 = 100;
@@ -8871,7 +8874,7 @@ var PreviewFrameJobBody2 = zod224.strictObject({
   "composition": zod224.unknown().optional().describe("The composition to render. Absent \u21D2 the project's ACTIVE composition \u2014 what create_render will encode. The response's `previewed.source` names what was rendered."),
   "compositionId": zod224.string().optional().describe("Preview a SPECIFIC persisted composition of this project (create_render parity). Absent \u21D2 the active one. A stale/foreign id is a 404 \u2014 never a silent fall-through."),
   "session_id": zod224.string().optional().describe("Compose-session id: render that session's SCRATCH composition (what the session has been editing) instead of the active row. Ignored when `composition` is passed."),
-  "timestamps": zod224.array(zod224.number()).min(1),
+  "timestamps": zod224.array(zod224.number()).min(1).max(previewFrameJobBodyTimestampsMax2).describe("Composition seconds to capture, 18 per request. The batch renders as ONE unit of work \u2014 one warm container, one source decode, N seeks \u2014 and that unit has a fixed time budget, so a larger batch is refused here rather than accepted and timed out minutes later. For a denser sweep, split it across calls; identical beats are served from the still cache, so overlapping batches are cheap."),
   "imageFormat": zod224.enum(["png", "jpeg"]).optional().describe("Still format. Default jpeg \u2014 these pixels go to a vision model, where jpeg is equivalent and png costs multiples in bytes to store and move. Pass png only when you need full fidelity."),
   "scale": zod224.number().min(previewFrameJobBodyScaleMin2).max(previewFrameJobBodyScaleMax2).optional().describe("Render scale 0.1\u20131. Default 0.5, which is what this schema has always recommended for vision-bound looks. Pass 1 when judging fine detail \u2014 it costs ~4x the vision tokens."),
   "jpegQuality": zod224.int().min(1).max(previewFrameJobBodyJpegQualityMax2).optional().describe("JPEG quality (jpeg only). Default 70 \u2014 the quality the eval panel grades at.")

package/dist/{chunk-TCYULWNP.js → chunk-IHKMFEBT.js}

@@ -1,7 +1,7 @@
 import {
   ChatErrorView,
   DirectorTurnContext
-} from "./chunk-DLKCGEKP.js";
+} from "./chunk-WEXGESUQ.js";
 import {
   GenerationArtifact
 } from "./chunk-73DQTUWY.js";

package/dist/{chunk-3GNTA646.js → chunk-IYZEK6WY.js}

@@ -1,7 +1,7 @@
 import {
   CueframeError,
   encodeError
-} from "./chunk-A3MXR6JI.js";
+} from "./chunk-QSWONRX2.js";
 
 // ../execution/core/src/render/vcam/constants.ts
 var P_MIN = 0.5;

package/dist/{chunk-NJOWIGUL.js → chunk-LL5GI3IS.js}

@@ -2,7 +2,7 @@ import {
   querySchemaShape,
   serializeQuery,
   waitForJob
-} from "./chunk-YOE5Y2SJ.js";
+} from "./chunk-ZBQQFAE7.js";
 import {
   CURATED_TOOLS
 } from "./chunk-5YO4LAB7.js";
@@ -23,7 +23,7 @@ import {
   text,
   textWithData,
   withMedia
-} from "./chunk-ANNB4VC6.js";
+} from "./chunk-F2HXB6RG.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;

package/dist/{chunk-A3MXR6JI.js → chunk-QSWONRX2.js}

@@ -291,6 +291,7 @@ var ERROR_CODES = {
   invalid_render_terminal: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },
   sighted_dispatch_failed: { stage: "system", category: "transient", retryable: true, httpStatus: 503 },
   sighted_stage_timeout: { stage: "render", category: "transient", retryable: true, httpStatus: 504 },
+  still_batch_too_large: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   sighted_provider_unreachable: { stage: "render", category: "transient", retryable: true, httpStatus: 503 },
   sighted_artifact_missing: { stage: "render", category: "internal", retryable: true, httpStatus: 500 },
   sighted_execution_failed: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },

package/dist/{chunk-W44ASS4N.js → chunk-UOYKFFFK.js}

@@ -24,7 +24,7 @@ import {
   scoreAndRank,
   segmentShots,
   stabilizeSelectionHysteresis
-} from "./chunk-3GNTA646.js";
+} from "./chunk-IYZEK6WY.js";
 import {
   compositionHasVo,
   roleDefaultGainDb
@@ -36,7 +36,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-A3MXR6JI.js";
+} from "./chunk-QSWONRX2.js";
 import {
   SCENE_CAPTURE_IDENTITY_FIELDS_V1,
   SCENE_PRESET_TRIANGLES,

package/dist/{chunk-DLKCGEKP.js → chunk-WEXGESUQ.js}

@@ -9,7 +9,7 @@ import {
 import {
   decodeError,
   scrubSensitive
-} from "./chunk-A3MXR6JI.js";
+} from "./chunk-QSWONRX2.js";
 
 // ../director/src/domain/chat.ts
 import { z } from "zod";

package/dist/{chunk-YOE5Y2SJ.js → chunk-ZBQQFAE7.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-ANNB4VC6.js";
+} from "./chunk-F2HXB6RG.js";
 
 // ../mcp/src/wait.ts
 var defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));

package/dist/compose.js

@@ -5,39 +5,39 @@ import {
 } from "./chunk-QDBVYZSF.js";
 import "./chunk-JQMPHKLU.js";
 import "./chunk-ZZRBKGDA.js";
-import {
-  catalog as catalog4
-} from "./chunk-JRJQECCF.js";
-import {
-  catalog as catalog7
-} from "./chunk-TE3PNQG6.js";
-import {
-  catalog
-} from "./chunk-RBWS5XHE.js";
-import "./chunk-DLF4WVSE.js";
-import "./chunk-U4V4FZGE.js";
 import {
   catalog as catalog3
 } from "./chunk-FVDFPJHT.js";
-import "./chunk-QGAWDLYX.js";
 import {
   catalog as catalog6
 } from "./chunk-VLJOIUHL.js";
-import "./chunk-S5H6GH6M.js";
-import "./chunk-QAGGJHAF.js";
-import {
-  catalog as catalog5
-} from "./chunk-RAXHCRVV.js";
 import {
   catalog as catalog2
 } from "./chunk-WAUVKF2F.js";
-import "./chunk-MFHXCHRI.js";
 import {
   catalog as catalog8
 } from "./chunk-RL5SO653.js";
+import {
+  catalog as catalog4
+} from "./chunk-JRJQECCF.js";
+import {
+  catalog as catalog7
+} from "./chunk-TE3PNQG6.js";
+import "./chunk-QGAWDLYX.js";
+import "./chunk-S5H6GH6M.js";
+import "./chunk-QAGGJHAF.js";
+import "./chunk-MFHXCHRI.js";
+import {
+  catalog
+} from "./chunk-RBWS5XHE.js";
+import "./chunk-DLF4WVSE.js";
+import "./chunk-U4V4FZGE.js";
 import "./chunk-LT4PWSR2.js";
 import "./chunk-FWSJLHSV.js";
 import "./chunk-ZFEXATWN.js";
+import {
+  catalog as catalog5
+} from "./chunk-RAXHCRVV.js";
 import "./chunk-XHGZ2E77.js";
 import "./chunk-W2245F6G.js";
 import "./chunk-JBWSK2YD.js";
@@ -54,7 +54,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-A3MXR6JI.js";
+} from "./chunk-QSWONRX2.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-XACXNDFL.js";
 import "./chunk-2L7PYYJK.js";

package/dist/composition/projection.js

@@ -32,7 +32,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "../chunk-GMVUJYPM.js";
+} from "../chunk-AYOVAVNO.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -74,7 +74,7 @@ import {
   contrastRatio
 } from "../chunk-ILO4NEZ3.js";
 import "../chunk-VG2ND6PX.js";
-import "../chunk-A3MXR6JI.js";
+import "../chunk-QSWONRX2.js";
 import "../chunk-AVTEPAWI.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/composition-ops.js

@@ -1,9 +1,9 @@
 import {
   playableSpans
-} from "./chunk-W44ASS4N.js";
+} from "./chunk-UOYKFFFK.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-3GNTA646.js";
+import "./chunk-IYZEK6WY.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-DENF4TPI.js";
 import {
@@ -30,7 +30,7 @@ import {
 } from "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-A3MXR6JI.js";
+import "./chunk-QSWONRX2.js";
 import "./chunk-7PA7FGLD.js";
 import {
   SCENE_SLOT_MEDIA_FORMATS,

package/dist/composition.js

@@ -46,7 +46,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "./chunk-GMVUJYPM.js";
+} from "./chunk-AYOVAVNO.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -194,7 +194,7 @@ import {
   ReframeSegmentFields
 } from "./chunk-B7J5UUUV.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-A3MXR6JI.js";
+import "./chunk-QSWONRX2.js";
 import "./chunk-AVTEPAWI.js";
 import "./chunk-2ESYSVXG.js";
 

package/dist/core/render.js

@@ -66,19 +66,19 @@ import {
   sliceTranscriptWords,
   splitIntoSentences,
   validateComposition
-} from "../chunk-W44ASS4N.js";
+} from "../chunk-UOYKFFFK.js";
 import {
   buildEasedZooms,
   buildPannedCenters,
   easeOutCubic
 } from "../chunk-QH3YI3ND.js";
 import "../chunk-QISFYLBB.js";
-import "../chunk-3GNTA646.js";
+import "../chunk-IYZEK6WY.js";
 import "../chunk-VZ7TYX6Z.js";
 import "../chunk-DENF4TPI.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
-import "../chunk-A3MXR6JI.js";
+import "../chunk-QSWONRX2.js";
 import "../chunk-7PA7FGLD.js";
 import "../chunk-XACXNDFL.js";
 import "../chunk-2L7PYYJK.js";

package/dist/core/select.js

@@ -7,8 +7,8 @@ import {
   stabilizeIncumbentChallenger,
   stabilizePresenceGate,
   stabilizeSelectionHysteresis
-} from "../chunk-3GNTA646.js";
-import "../chunk-A3MXR6JI.js";
+} from "../chunk-IYZEK6WY.js";
+import "../chunk-QSWONRX2.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../execution/core/src/select/errorCodes.ts

package/dist/core.js

@@ -10,15 +10,15 @@ import {
   ensureEven,
   extractCaptionWordsFromDoc,
   isEmphasized
-} from "./chunk-W44ASS4N.js";
+} from "./chunk-UOYKFFFK.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-3GNTA646.js";
+import "./chunk-IYZEK6WY.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-A3MXR6JI.js";
+import "./chunk-QSWONRX2.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-XACXNDFL.js";
 import "./chunk-2L7PYYJK.js";

package/dist/director/ai-sdk.js

@@ -10,13 +10,13 @@ import {
   dataChunk,
   generationArtifactFromToolResult,
   projectDirectorHistory
-} from "../chunk-TCYULWNP.js";
-import "../chunk-DLKCGEKP.js";
+} from "../chunk-IHKMFEBT.js";
+import "../chunk-WEXGESUQ.js";
 import "../chunk-73DQTUWY.js";
 import "../chunk-BADZHXLR.js";
 import "../chunk-U3JPILZS.js";
 import "../chunk-XELS2BGA.js";
-import "../chunk-A3MXR6JI.js";
+import "../chunk-QSWONRX2.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CueFrameIteration,

package/dist/director/domain.js

@@ -9,7 +9,7 @@ import {
   ProjectRef,
   chatErrorViewFromEnvelope,
   chatErrorViewFromUnknown
-} from "../chunk-DLKCGEKP.js";
+} from "../chunk-WEXGESUQ.js";
 import {
   ClientRequestId,
   GenerateMediaCommand,
@@ -31,7 +31,7 @@ import {
 import "../chunk-BADZHXLR.js";
 import "../chunk-U3JPILZS.js";
 import "../chunk-XELS2BGA.js";
-import "../chunk-A3MXR6JI.js";
+import "../chunk-QSWONRX2.js";
 import "../chunk-2ESYSVXG.js";
 export {
   ChatErrorView,

package/dist/director.js

@@ -10,7 +10,7 @@ import {
   dataChunk,
   generationArtifactFromToolResult,
   projectDirectorHistory
-} from "./chunk-TCYULWNP.js";
+} from "./chunk-IHKMFEBT.js";
 import "./chunk-FTVZF4GO.js";
 import {
   ChatErrorView,
@@ -22,7 +22,7 @@ import {
   ProjectRef,
   chatErrorViewFromEnvelope,
   chatErrorViewFromUnknown
-} from "./chunk-DLKCGEKP.js";
+} from "./chunk-WEXGESUQ.js";
 import {
   ClientRequestId,
   GenerateMediaCommand,
@@ -44,7 +44,7 @@ import {
 import "./chunk-BADZHXLR.js";
 import "./chunk-U3JPILZS.js";
 import "./chunk-XELS2BGA.js";
-import "./chunk-A3MXR6JI.js";
+import "./chunk-QSWONRX2.js";
 import "./chunk-2ESYSVXG.js";
 export {
   ChatErrorView,

package/dist/errors.js

@@ -6,7 +6,7 @@ import {
   retryAfterSecondsFor,
   scrubSensitive,
   toWireEnvelope
-} from "./chunk-A3MXR6JI.js";
+} from "./chunk-QSWONRX2.js";
 import "./chunk-2ESYSVXG.js";
 export {
   CueframeError,

package/dist/mcp/adapter.js

@@ -2,7 +2,7 @@ import {
   querySchemaShape,
   serializeQuery,
   waitForJob
-} from "../chunk-YOE5Y2SJ.js";
+} from "../chunk-ZBQQFAE7.js";
 import {
   CURATED_TOOLS
 } from "../chunk-5YO4LAB7.js";
@@ -16,7 +16,7 @@ import {
   opById,
   safeParse,
   sniffImageMediaType
-} from "../chunk-ANNB4VC6.js";
+} from "../chunk-F2HXB6RG.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../mcp/src/adapter.ts
@@ -29,7 +29,7 @@ var INTERNAL_LOOP_TOOLS = [
     name: "render_frame",
     operationId: "previewFrameJob",
     pathArgs: { projectId: "id" },
-    description: "Queue durable stills of the WHOLE composition, then wait for the job and return the images. `body.timestamps` is an array of clip-relative SECONDS: pass EVERY beat you want to inspect in ONE call \u2014 a call is flat-cost and one budget unit however many timestamps it carries. Stills are content-addressed and retries reattach to the same execution. (One component instead of the whole composition? use preview_component.)",
+    description: "Queue durable stills of the WHOLE composition, then wait for the job and return the images. `body.timestamps` is an array of clip-relative SECONDS, up to 18 per call: the batch renders as ONE unit of work with a fixed time budget, so a bigger batch is refused rather than timed out. Within that bound pass every beat you want in one call \u2014 a call is flat-cost and one budget unit however many timestamps it carries \u2014 and split a denser sweep across calls, which is cheap because stills are content-addressed and identical beats hit the cache. Retries reattach to the same execution. (One component instead of the whole composition? use preview_component.)",
     annotations: { readOnlyHint: true }
   },
   {
@@ -219,6 +219,15 @@ function previewVisionModelOutput({ output }) {
     value: typeof output === "string" ? output : JSON.stringify(output)
   };
 }
+function renderFrameTimestamps() {
+  const body = bodySchemaFor(opById("previewFrameJob"));
+  const shape = body?.shape;
+  const timestamps = shape?.timestamps;
+  if (!timestamps) {
+    throw new Error("MCP: previewFrameJob body schema has no `timestamps` \u2014 run `pnpm generate:api-consumers`.");
+  }
+  return timestamps;
+}
 function buildRenderFrameTool(spec, ex, budget, opts) {
   const canonicalOp = opById(spec.operationId);
   const transport = opts?.transportOverrides?.[spec.name];
@@ -231,7 +240,10 @@ function buildRenderFrameTool(spec, ex, budget, opts) {
   const mapArg = (p) => sessionPathValue(reverse[p], opts) ?? void 0;
   return tool({
     description: spec.description,
-    inputSchema: z.object({ body: z.object({ timestamps: z.array(z.number()).min(1) }) }),
+    // The SAME bound the server enforces, not a hand-rolled copy of it. The
+    // duplicate here said `.min(1)` with no maximum long after the API grew one,
+    // so this tool advertised a batch size it would be refused for (CUE-39).
+    inputSchema: z.object({ body: z.object({ timestamps: renderFrameTimestamps() }) }),
     inputExamples: [{ input: { body: { timestamps: [14.2, 14.8, 15.6] } } }],
     execute: async (args) => {
       if (++budget.used.captures > budget.caps.captures) {

package/dist/mcp/core.js

@@ -18,7 +18,7 @@ import {
   text,
   textWithData,
   withMedia
-} from "../chunk-ANNB4VC6.js";
+} from "../chunk-F2HXB6RG.js";
 import "../chunk-2ESYSVXG.js";
 export {
   __resetPreviewCache,

package/dist/mcp/server.js

@@ -7,10 +7,10 @@ import {
   registerRawTools,
   registerSkillPrompts,
   titleCase
-} from "../chunk-NJOWIGUL.js";
-import "../chunk-YOE5Y2SJ.js";
+} from "../chunk-LL5GI3IS.js";
+import "../chunk-ZBQQFAE7.js";
 import "../chunk-5YO4LAB7.js";
-import "../chunk-ANNB4VC6.js";
+import "../chunk-F2HXB6RG.js";
 import "../chunk-2ESYSVXG.js";
 export {
   RAW_EXCLUDED_OPERATION_IDS,

package/dist/mcp.js

@@ -7,10 +7,10 @@ import {
   buildServer,
   registerCuratedTools,
   registerRawTools
-} from "./chunk-NJOWIGUL.js";
-import "./chunk-YOE5Y2SJ.js";
+} from "./chunk-LL5GI3IS.js";
+import "./chunk-ZBQQFAE7.js";
 import "./chunk-5YO4LAB7.js";
-import "./chunk-ANNB4VC6.js";
+import "./chunk-F2HXB6RG.js";
 import "./chunk-2ESYSVXG.js";
 export {
   API_URLS,

package/dist/plane/contract.js

@@ -2,6 +2,14 @@ import "../chunk-2ESYSVXG.js";
 
 // ../plane/src/contract.ts
 import { z } from "zod";
+var STILL_BUDGET_BASE_S = 60;
+var STILL_BUDGET_PER_BEAT_S = 3;
+var STILL_BUDGET_CEILING_S = 280;
+var CO_BATCHED_CALLERS = 4;
+var MAX_STILL_BEATS_PER_BATCH = 18;
+function stillBudgetSeconds(beats) {
+  return STILL_BUDGET_BASE_S + STILL_BUDGET_PER_BEAT_S * beats;
+}
 var PreviewFrameRequest = z.object({
   composition: z.unknown().optional().describe(
     "The composition to render. Absent \u21D2 the project's ACTIVE composition \u2014 what create_render will encode. The response's `previewed.source` names what was rendered."
@@ -12,7 +20,9 @@ var PreviewFrameRequest = z.object({
   session_id: z.string().optional().describe(
     "Compose-session id: render that session's SCRATCH composition (what the session has been editing) instead of the active row. Ignored when `composition` is passed."
   ),
-  timestamps: z.array(z.number()).min(1),
+  timestamps: z.array(z.number()).min(1).max(MAX_STILL_BEATS_PER_BATCH).describe(
+    `Composition seconds to capture, ${MAX_STILL_BEATS_PER_BATCH} per request. The batch renders as ONE unit of work \u2014 one warm container, one source decode, N seeks \u2014 and that unit has a fixed time budget, so a larger batch is refused here rather than accepted and timed out minutes later. For a denser sweep, split it across calls; identical beats are served from the still cache, so overlapping batches are cheap.`
+  ),
   imageFormat: z.enum(["png", "jpeg"]).optional().describe(
     "Still format. Default jpeg \u2014 these pixels go to a vision model, where jpeg is equivalent and png costs multiples in bytes to store and move. Pass png only when you need full fidelity."
   ),
@@ -30,6 +40,12 @@ var DesktopPreviewFrameRequest = PreviewFrameRequest.pick({
   jpegQuality: true
 }).strict();
 export {
+  CO_BATCHED_CALLERS,
   DesktopPreviewFrameRequest,
-  PreviewFrameRequest
+  MAX_STILL_BEATS_PER_BATCH,
+  PreviewFrameRequest,
+  STILL_BUDGET_BASE_S,
+  STILL_BUDGET_CEILING_S,
+  STILL_BUDGET_PER_BEAT_S,
+  stillBudgetSeconds
 };

package/dist/primitives.js

@@ -1,36 +1,36 @@
-import {
-  catalog as catalog4
-} from "./chunk-JRJQECCF.js";
-import {
-  catalog as catalog7
-} from "./chunk-TE3PNQG6.js";
-import {
-  catalog
-} from "./chunk-RBWS5XHE.js";
-import "./chunk-DLF4WVSE.js";
-import "./chunk-U4V4FZGE.js";
 import {
   catalog as catalog3
 } from "./chunk-FVDFPJHT.js";
-import "./chunk-QGAWDLYX.js";
 import {
   catalog as catalog6
 } from "./chunk-VLJOIUHL.js";
-import "./chunk-S5H6GH6M.js";
-import "./chunk-QAGGJHAF.js";
-import {
-  catalog as catalog5
-} from "./chunk-RAXHCRVV.js";
 import {
   catalog as catalog2
 } from "./chunk-WAUVKF2F.js";
-import "./chunk-MFHXCHRI.js";
 import {
   catalog as catalog8
 } from "./chunk-RL5SO653.js";
+import {
+  catalog as catalog4
+} from "./chunk-JRJQECCF.js";
+import {
+  catalog as catalog7
+} from "./chunk-TE3PNQG6.js";
+import "./chunk-QGAWDLYX.js";
+import "./chunk-S5H6GH6M.js";
+import "./chunk-QAGGJHAF.js";
+import "./chunk-MFHXCHRI.js";
+import {
+  catalog
+} from "./chunk-RBWS5XHE.js";
+import "./chunk-DLF4WVSE.js";
+import "./chunk-U4V4FZGE.js";
 import "./chunk-LT4PWSR2.js";
 import "./chunk-FWSJLHSV.js";
 import "./chunk-ZFEXATWN.js";
+import {
+  catalog as catalog5
+} from "./chunk-RAXHCRVV.js";
 import "./chunk-XHGZ2E77.js";
 import "./chunk-W2245F6G.js";
 import "./chunk-JBWSK2YD.js";

package/dist/render-harness/cardAssetAdmission.js

@@ -1,8 +1,8 @@
 import {
   assertCardHtmlAssetFree
-} from "../chunk-4RREA7VA.js";
+} from "../chunk-BUAAQDDJ.js";
 import "../chunk-OSMXQV5V.js";
-import "../chunk-A3MXR6JI.js";
+import "../chunk-QSWONRX2.js";
 import "../chunk-2ESYSVXG.js";
 export {
   assertCardHtmlAssetFree

package/dist/render-harness/cardFonts.js

@@ -2,8 +2,8 @@ import {
   assertCardFontsAdmitted,
   cardBundledFamilies,
   cardFontFamilyStacks
-} from "../chunk-RAPDICTC.js";
-import "../chunk-A3MXR6JI.js";
+} from "../chunk-6PBYCESM.js";
+import "../chunk-QSWONRX2.js";
 import "../chunk-AVTEPAWI.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/render-harness.js

@@ -1,9 +1,9 @@
 import {
   assertCardHtmlAssetFree
-} from "./chunk-4RREA7VA.js";
+} from "./chunk-BUAAQDDJ.js";
 import {
   assertCardFontsAdmitted
-} from "./chunk-RAPDICTC.js";
+} from "./chunk-6PBYCESM.js";
 import {
   assertNoRemoteRefs,
   assetSlots,
@@ -46,17 +46,17 @@ import {
   parseSceneComponentCaptureIntentV1,
   prepareSceneShotRenderInput,
   readSceneShotManifest
-} from "./chunk-W44ASS4N.js";
+} from "./chunk-UOYKFFFK.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-3GNTA646.js";
+import "./chunk-IYZEK6WY.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
 import {
   CueframeError
-} from "./chunk-A3MXR6JI.js";
+} from "./chunk-QSWONRX2.js";
 import "./chunk-7PA7FGLD.js";
 import {
   evaluateScene,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueframe/kernel",
-  "version": "0.2.34",
+  "version": "0.2.36",
   "type": "module",
   "description": "Publish-only aggregate of CueFrame's isomorphic kernel packages — composition, primitives, authoring, MCP, and friends shipped as one npm artifact. Members remain separate workspace packages; this only changes what ships.",
   "files": [
@@ -19,23 +19,23 @@
     "@cueframe/account-model": "0.1.0",
     "@cueframe/animate": "0.1.0",
     "@cueframe/authoring": "0.1.0",
-    "@cueframe/brand-derivation": "0.1.0",
-    "@cueframe/composition": "0.1.0",
+    "@cueframe/cloud-import": "0.1.0",
+    "@cueframe/compose": "0.1.0",
     "@cueframe/composition-ops": "0.1.0",
-    "@cueframe/component-runtime": "0.1.0",
+    "@cueframe/composition": "0.1.0",
+    "@cueframe/brand-derivation": "0.1.0",
     "@cueframe/core": "0.1.0",
-    "@cueframe/compose": "0.1.0",
-    "@cueframe/director": "0.1.0",
-    "@cueframe/cloud-import": "0.1.0",
     "@cueframe/errors": "0.1.0",
+    "@cueframe/director": "0.1.0",
+    "@cueframe/foundation": "0.1.0",
+    "@cueframe/component-runtime": "0.1.0",
     "@cueframe/mcp": "0.1.0",
-    "@cueframe/media-model": "0.1.0",
+    "@cueframe/primitives": "0.1.0",
     "@cueframe/perception": "0.1.0",
-    "@cueframe/plane": "0.1.0",
     "@cueframe/nle-export": "0.1.0",
-    "@cueframe/foundation": "0.1.0",
-    "@cueframe/primitives": "0.1.0",
-    "@cueframe/render-harness": "0.1.0"
+    "@cueframe/plane": "0.1.0",
+    "@cueframe/render-harness": "0.1.0",
+    "@cueframe/media-model": "0.1.0"
   },
   "peerDependencies": {
     "gsap": "3.13.0",