@cueframe/kernel 0.2.35 → 0.2.36

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-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-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";

package/dist/composition-ops.js

@@ -1,10 +1,10 @@
 import {
   playableSpans
-} from "./chunk-L5XECASW.js";
+} from "./chunk-UOYKFFFK.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-VZ7TYX6Z.js";
 import "./chunk-IYZEK6WY.js";
+import "./chunk-VZ7TYX6Z.js";
 import "./chunk-DENF4TPI.js";
 import {
   createHeadlessStore,

package/dist/core/render.js

@@ -66,15 +66,15 @@ import {
   sliceTranscriptWords,
   splitIntoSentences,
   validateComposition
-} from "../chunk-L5XECASW.js";
+} from "../chunk-UOYKFFFK.js";
 import {
   buildEasedZooms,
   buildPannedCenters,
   easeOutCubic
 } from "../chunk-QH3YI3ND.js";
 import "../chunk-QISFYLBB.js";
-import "../chunk-VZ7TYX6Z.js";
 import "../chunk-IYZEK6WY.js";
+import "../chunk-VZ7TYX6Z.js";
 import "../chunk-DENF4TPI.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";

package/dist/core.js

@@ -10,11 +10,11 @@ import {
   ensureEven,
   extractCaptionWordsFromDoc,
   isEmphasized
-} from "./chunk-L5XECASW.js";
+} from "./chunk-UOYKFFFK.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-VZ7TYX6Z.js";
 import "./chunk-IYZEK6WY.js";
+import "./chunk-VZ7TYX6Z.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";

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/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.js

@@ -46,11 +46,11 @@ import {
   parseSceneComponentCaptureIntentV1,
   prepareSceneShotRenderInput,
   readSceneShotManifest
-} from "./chunk-L5XECASW.js";
+} from "./chunk-UOYKFFFK.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
-import "./chunk-VZ7TYX6Z.js";
 import "./chunk-IYZEK6WY.js";
+import "./chunk-VZ7TYX6Z.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueframe/kernel",
-  "version": "0.2.35",
+  "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/cloud-import": "0.1.0",
     "@cueframe/compose": "0.1.0",
     "@cueframe/composition-ops": "0.1.0",
-    "@cueframe/director": "0.1.0",
-    "@cueframe/component-runtime": "0.1.0",
-    "@cueframe/errors": "0.1.0",
     "@cueframe/composition": "0.1.0",
-    "@cueframe/foundation": "0.1.0",
+    "@cueframe/brand-derivation": "0.1.0",
     "@cueframe/core": "0.1.0",
-    "@cueframe/perception": "0.1.0",
-    "@cueframe/media-model": "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/nle-export": "0.1.0",
     "@cueframe/primitives": "0.1.0",
+    "@cueframe/perception": "0.1.0",
+    "@cueframe/nle-export": "0.1.0",
+    "@cueframe/plane": "0.1.0",
     "@cueframe/render-harness": "0.1.0",
-    "@cueframe/plane": "0.1.0"
+    "@cueframe/media-model": "0.1.0"
   },
   "peerDependencies": {
     "gsap": "3.13.0",

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

@@ -7,10 +7,6 @@ import {
   flattenCompoundClips,
   hasCompoundClips
 } from "./chunk-QISFYLBB.js";
-import {
-  compositionHasVo,
-  roleDefaultGainDb
-} from "./chunk-VZ7TYX6Z.js";
 import {
   DOMINANCE_WEIGHTS,
   ENTER_SEC,
@@ -29,6 +25,10 @@ import {
   segmentShots,
   stabilizeSelectionHysteresis
 } from "./chunk-IYZEK6WY.js";
+import {
+  compositionHasVo,
+  roleDefaultGainDb
+} from "./chunk-VZ7TYX6Z.js";
 import {
   SHOT_SCALE_TARGET,
   shotScaleZoom