@cueframe/kernel 0.2.36 → 0.2.37

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

@@ -2,32 +2,41 @@ 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.
+ * two ends.
  *
- * 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`.
+ * THE BUDGET IS A TIMEOUT, NOT A RESERVATION. Work that finishes early costs
+ * nothing extra; a generous budget only delays the error on work that is
+ * genuinely stuck. Setting it tight buys nothing and fails real renders, which
+ * is exactly what happened.
  *
- * 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
+ * History, because both mistakes are instructive (CUE-39):
  *
- *   BASE + PER_BEAT * (N * CO_BATCHED_CALLERS) <= CEILING
+ * 1. The Modal worker computed `min(280, 60 + 45 * beats)`. The per-beat term is
+ *    dead above four beats — the cap TRUNCATES a budget the caller can never
+ *    meet instead of refusing the batch — and `timestamps` had no maximum, so a
+ *    124-beat request was accepted and failed five minutes later.
+ * 2. The first fix derived MAX from the worker's 300s function timeout as though
+ *    that were physics. It is a decorator value we choose. Worse, it was derived
+ *    so the worst case EXACTLY fit (276 <= 280), leaving zero headroom: seven
+ *    in-bound batches on a 31-clip composition with alpha layers then failed,
+ *    because that composition costs ~4s per still and the constant said 3s.
  *
- * 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.
+ * So PER_BEAT is now the HEAVY end with real headroom, not the median. A light
+ * composition finishing in a third of its budget is free; a heavy one exceeding
+ * a tight budget is an outage. MEASURED on prod 2026-09-17: 52 stills of a
+ * 5-track / 31-clip / 60s composition with alpha layers completed inside 216s
+ * (<=4.15s each), while 72 stills exceeded 276s.
+ *
+ * MAX_STILL_BEATS_PER_BATCH is a product choice, not a derivation: it admits the
+ * verify lane's worst case (6 eval beats x 3 burst frames). The invariant a test
+ * pins is that the worst case COMFORTABLY fits, and that the ceiling stays under
+ * the worker's own function timeout.
  */
 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;
+/** Heavy-composition cost with headroom; measured ~4s/still, budgeted at 10. */
+export declare const STILL_BUDGET_PER_BEAT_S = 10;
+/** Under `render_still_worker`'s `timeout=` decorator, which is ours to set. */
+export declare const STILL_BUDGET_CEILING_S = 840;
 /** `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;

package/dist/plane/contract.js

@@ -3,8 +3,8 @@ 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 STILL_BUDGET_PER_BEAT_S = 10;
+var STILL_BUDGET_CEILING_S = 840;
 var CO_BATCHED_CALLERS = 4;
 var MAX_STILL_BEATS_PER_BATCH = 18;
 function stillBudgetSeconds(beats) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueframe/kernel",
-  "version": "0.2.36",
+  "version": "0.2.37",
   "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": [
@@ -17,25 +17,25 @@
     "tsup": "^8.3.5",
     "typescript": "^5.9.3",
     "@cueframe/account-model": "0.1.0",
-    "@cueframe/animate": "0.1.0",
     "@cueframe/authoring": "0.1.0",
-    "@cueframe/cloud-import": "0.1.0",
     "@cueframe/compose": "0.1.0",
     "@cueframe/composition-ops": "0.1.0",
-    "@cueframe/composition": "0.1.0",
+    "@cueframe/animate": "0.1.0",
     "@cueframe/brand-derivation": "0.1.0",
+    "@cueframe/composition": "0.1.0",
+    "@cueframe/cloud-import": "0.1.0",
     "@cueframe/core": "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/foundation": "0.1.0",
+    "@cueframe/director": "0.1.0",
     "@cueframe/mcp": "0.1.0",
-    "@cueframe/primitives": "0.1.0",
-    "@cueframe/perception": "0.1.0",
     "@cueframe/nle-export": "0.1.0",
+    "@cueframe/perception": "0.1.0",
     "@cueframe/plane": "0.1.0",
+    "@cueframe/primitives": "0.1.0",
+    "@cueframe/media-model": "0.1.0",
     "@cueframe/render-harness": "0.1.0",
-    "@cueframe/media-model": "0.1.0"
+    "@cueframe/errors": "0.1.0"
   },
   "peerDependencies": {
     "gsap": "3.13.0",