@cueframe/kernel 0.2.34 → 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-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-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-W44ASS4N.js → chunk-L5XECASW.js}

@@ -7,6 +7,10 @@ import {
   flattenCompoundClips,
   hasCompoundClips
 } from "./chunk-QISFYLBB.js";
+import {
+  compositionHasVo,
+  roleDefaultGainDb
+} from "./chunk-VZ7TYX6Z.js";
 import {
   DOMINANCE_WEIGHTS,
   ENTER_SEC,
@@ -24,11 +28,7 @@ import {
   scoreAndRank,
   segmentShots,
   stabilizeSelectionHysteresis
-} from "./chunk-3GNTA646.js";
-import {
-  compositionHasVo,
-  roleDefaultGainDb
-} from "./chunk-VZ7TYX6Z.js";
+} from "./chunk-IYZEK6WY.js";
 import {
   SHOT_SCALE_TARGET,
   shotScaleZoom
@@ -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-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-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/compose.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,10 +1,10 @@
 import {
   playableSpans
-} from "./chunk-W44ASS4N.js";
+} from "./chunk-L5XECASW.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-3GNTA646.js";
 import "./chunk-VZ7TYX6Z.js";
+import "./chunk-IYZEK6WY.js";
 import "./chunk-DENF4TPI.js";
 import {
   createHeadlessStore,
@@ -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-L5XECASW.js";
 import {
   buildEasedZooms,
   buildPannedCenters,
   easeOutCubic
 } from "../chunk-QH3YI3ND.js";
 import "../chunk-QISFYLBB.js";
-import "../chunk-3GNTA646.js";
 import "../chunk-VZ7TYX6Z.js";
+import "../chunk-IYZEK6WY.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-L5XECASW.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-3GNTA646.js";
 import "./chunk-VZ7TYX6Z.js";
+import "./chunk-IYZEK6WY.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/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/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-L5XECASW.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-3GNTA646.js";
 import "./chunk-VZ7TYX6Z.js";
+import "./chunk-IYZEK6WY.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.35",
   "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": [
@@ -20,22 +20,22 @@
     "@cueframe/animate": "0.1.0",
     "@cueframe/authoring": "0.1.0",
     "@cueframe/brand-derivation": "0.1.0",
-    "@cueframe/composition": "0.1.0",
-    "@cueframe/composition-ops": "0.1.0",
-    "@cueframe/component-runtime": "0.1.0",
-    "@cueframe/core": "0.1.0",
+    "@cueframe/cloud-import": "0.1.0",
     "@cueframe/compose": "0.1.0",
+    "@cueframe/composition-ops": "0.1.0",
     "@cueframe/director": "0.1.0",
-    "@cueframe/cloud-import": "0.1.0",
+    "@cueframe/component-runtime": "0.1.0",
     "@cueframe/errors": "0.1.0",
-    "@cueframe/mcp": "0.1.0",
-    "@cueframe/media-model": "0.1.0",
+    "@cueframe/composition": "0.1.0",
+    "@cueframe/foundation": "0.1.0",
+    "@cueframe/core": "0.1.0",
     "@cueframe/perception": "0.1.0",
-    "@cueframe/plane": "0.1.0",
+    "@cueframe/media-model": "0.1.0",
+    "@cueframe/mcp": "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/render-harness": "0.1.0",
+    "@cueframe/plane": "0.1.0"
   },
   "peerDependencies": {
     "gsap": "3.13.0",