@cueframe/kernel 0.2.1 → 0.2.3

package/dist/authoring/build-tools.js

@@ -4,18 +4,19 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "../chunk-GEGRJKKO.js";
-import "../chunk-XVBOSPZI.js";
+} from "../chunk-F2DJL7P7.js";
+import "../chunk-X74EEFXV.js";
 import "../chunk-JOURGVOR.js";
-import "../chunk-C5SEPOWD.js";
-import "../chunk-IBMJ33EL.js";
-import "../chunk-IHFREGFA.js";
-import "../chunk-7KEUL3FI.js";
+import "../chunk-AS5EXBNS.js";
+import "../chunk-I5RX2QZT.js";
+import "../chunk-TCHPRGC5.js";
+import "../chunk-XF2QMKRG.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-2B5VJZHL.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-7PA7FGLD.js";
+import "../chunk-TARKDVP6.js";
 import "../chunk-2ESYSVXG.js";
 export {
   ZERO_USAGE,

package/dist/authoring/context.js

@@ -1,13 +1,14 @@
 import {
   buildDirectorContext
-} from "../chunk-ZCAQHNPI.js";
-import "../chunk-IBMJ33EL.js";
-import "../chunk-IHFREGFA.js";
-import "../chunk-7KEUL3FI.js";
+} from "../chunk-UKGNHZS4.js";
+import "../chunk-I5RX2QZT.js";
+import "../chunk-TCHPRGC5.js";
+import "../chunk-XF2QMKRG.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-2B5VJZHL.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
+import "../chunk-TARKDVP6.js";
 import "../chunk-2ESYSVXG.js";
 export {
   buildDirectorContext

package/dist/authoring/prompts.js

@@ -9,7 +9,7 @@ import {
   buildPlannerUserMessage,
   formatPlanSteps,
   initCodeGenPrompts
-} from "../chunk-HFC3MKXA.js";
+} from "../chunk-Y4HPN4BC.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CODE_GEN_FEW_SHOT_EXAMPLES,

package/dist/authoring/scene.d.ts

@@ -0,0 +1 @@
+export * from "../_members/authoring/scene/index.js";

package/dist/authoring/scene.js

@@ -0,0 +1,50 @@
+import {
+  SCENE_IMAGE_MIME_TYPES,
+  SCENE_SHOT_WRAPPER_SOURCE,
+  SCENE_SHOT_WRAPPER_VERSION,
+  SCENE_TRACK_NAME,
+  SceneAuthoringError,
+  generateSceneShotWrapper,
+  hasSceneOp,
+  isSceneOp,
+  materializeSceneOpsCore,
+  sceneShotAlphaPolicy,
+  sceneShotManifest,
+  sceneTrackIdFor,
+  validateSceneAdd,
+  validateSceneUpdate
+} from "../chunk-QS36DMFG.js";
+import {
+  SCENE_TRANSITION_KINDS,
+  collectSceneClipIssues,
+  isSceneShotClip,
+  isSceneShotSource,
+  offFrameLattice,
+  readSceneSourceRef,
+  sceneClipShapeIssues
+} from "../chunk-MH3UPKWR.js";
+import "../chunk-2L7PYYJK.js";
+import "../chunk-2ESYSVXG.js";
+export {
+  SCENE_IMAGE_MIME_TYPES,
+  SCENE_SHOT_WRAPPER_SOURCE,
+  SCENE_SHOT_WRAPPER_VERSION,
+  SCENE_TRACK_NAME,
+  SCENE_TRANSITION_KINDS,
+  SceneAuthoringError,
+  collectSceneClipIssues,
+  generateSceneShotWrapper,
+  hasSceneOp,
+  isSceneOp,
+  isSceneShotClip,
+  isSceneShotSource,
+  materializeSceneOpsCore,
+  offFrameLattice,
+  readSceneSourceRef,
+  sceneClipShapeIssues,
+  sceneShotAlphaPolicy,
+  sceneShotManifest,
+  sceneTrackIdFor,
+  validateSceneAdd,
+  validateSceneUpdate
+};

package/dist/authoring/tools.js

@@ -6,17 +6,18 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "../chunk-XVBOSPZI.js";
+} from "../chunk-X74EEFXV.js";
 import "../chunk-JOURGVOR.js";
-import "../chunk-C5SEPOWD.js";
-import "../chunk-IBMJ33EL.js";
-import "../chunk-IHFREGFA.js";
-import "../chunk-7KEUL3FI.js";
+import "../chunk-AS5EXBNS.js";
+import "../chunk-I5RX2QZT.js";
+import "../chunk-TCHPRGC5.js";
+import "../chunk-XF2QMKRG.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-2B5VJZHL.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-7PA7FGLD.js";
+import "../chunk-TARKDVP6.js";
 import "../chunk-2ESYSVXG.js";
 export {
   COMPOSE_MOTION_TOOLS,

package/dist/authoring.js

@@ -1,6 +1,33 @@
+import {
+  SceneAuthoringError,
+  generateSceneShotWrapper,
+  hasSceneOp,
+  isSceneOp,
+  materializeSceneOpsCore
+} from "./chunk-QS36DMFG.js";
+import {
+  ZERO_USAGE,
+  buildDirectorTools,
+  buildPlannerTools,
+  buildToolsFromSchemas,
+  extractProviderError
+} from "./chunk-F2DJL7P7.js";
+import {
+  COMPOSE_MOTION_TOOLS,
+  COMPOSE_MOTION_VERIFY_TOOLS,
+  COMPOSE_PLANNER_REPAIR_TOOLS,
+  COMPOSE_PLANNER_TOOLS,
+  COMPOSE_ROLE_TOOLS,
+  COMPOSE_ROLE_TOOL_NAMES,
+  dispatchComposeRoleTool
+} from "./chunk-X74EEFXV.js";
+import {
+  AgentFixableCaptureError,
+  getExcludedTools
+} from "./chunk-JOURGVOR.js";
 import {
   buildDirectorContext
-} from "./chunk-ZCAQHNPI.js";
+} from "./chunk-UKGNHZS4.js";
 import {
   buildFastModel,
   buildModel,
@@ -20,43 +47,29 @@ import {
   buildPlannerUserMessage,
   formatPlanSteps,
   initCodeGenPrompts
-} from "./chunk-HFC3MKXA.js";
-import {
-  ZERO_USAGE,
-  buildDirectorTools,
-  buildPlannerTools,
-  buildToolsFromSchemas,
-  extractProviderError
-} from "./chunk-GEGRJKKO.js";
-import {
-  COMPOSE_MOTION_TOOLS,
-  COMPOSE_MOTION_VERIFY_TOOLS,
-  COMPOSE_PLANNER_REPAIR_TOOLS,
-  COMPOSE_PLANNER_TOOLS,
-  COMPOSE_ROLE_TOOLS,
-  COMPOSE_ROLE_TOOL_NAMES,
-  dispatchComposeRoleTool
-} from "./chunk-XVBOSPZI.js";
-import {
-  AgentFixableCaptureError,
-  getExcludedTools
-} from "./chunk-JOURGVOR.js";
-import "./chunk-AD5HWBCE.js";
+} from "./chunk-Y4HPN4BC.js";
+import "./chunk-JX53CVJV.js";
 import {
   cssLayoutVars
-} from "./chunk-YQ7FFW3G.js";
+} from "./chunk-6VWICHOZ.js";
 import "./chunk-DSMLHYJ4.js";
-import "./chunk-C5SEPOWD.js";
+import "./chunk-AS5EXBNS.js";
 import "./chunk-JF4JJAFP.js";
-import "./chunk-IBMJ33EL.js";
-import "./chunk-IHFREGFA.js";
-import "./chunk-7KEUL3FI.js";
+import "./chunk-I5RX2QZT.js";
+import "./chunk-TCHPRGC5.js";
+import "./chunk-XF2QMKRG.js";
 import "./chunk-WPZKOVYF.js";
 import "./chunk-2B5VJZHL.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
 import "./chunk-7PA7FGLD.js";
-import "./chunk-4FOOBSEE.js";
+import "./chunk-J3DIUG24.js";
+import "./chunk-TARKDVP6.js";
+import {
+  collectSceneClipIssues,
+  isSceneShotClip
+} from "./chunk-MH3UPKWR.js";
+import "./chunk-2L7PYYJK.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../authoring/src/agent.ts
@@ -1190,6 +1203,7 @@ export {
   MotionPresetError,
   PLANNING_INSTRUCTIONS,
   PipelineTrace as RequestTrace,
+  SceneAuthoringError,
   TIMELINE_RUBRIC,
   TOOLKIT_REFERENCE,
   ZERO_USAGE,
@@ -1204,6 +1218,7 @@ export {
   buildPrepareStep,
   buildToolsFromSchemas,
   cachePrepareStep,
+  collectSceneClipIssues,
   createAgentMemory,
   decompose,
   dispatchComposeRoleTool,
@@ -1213,12 +1228,17 @@ export {
   extractProviderError,
   formatPlanSteps,
   generateMotionShell,
+  generateSceneShotWrapper,
   getExcludedTools,
   hasMotionPresetOp,
+  hasSceneOp,
   initCodeGenPrompts,
   isMotionPresetOp,
+  isSceneOp,
+  isSceneShotClip,
   makeLangfuseFetch,
   materializeMotionPresetOpsCore,
+  materializeSceneOpsCore,
   renderSkillContent,
   resolveMotionPresetCard,
   shouldDecompose,

package/dist/chunk-2L7PYYJK.js

@@ -0,0 +1,23 @@
+// ../composition/src/scene/budgetPolicy.mjs
+var MIB = 1048576;
+var SCENE_SURFACE_TEXTURE_BUDGET_BYTES = 256 * MIB;
+var SCENE_CONTEXT_GL_BUDGET_BYTES = 512 * MIB;
+var SCENE_RENDER_JOB_BUDGET_BYTES = 2 * 1024 * MIB;
+var SCENE_MAX_TRIANGLES = 25e4;
+var I0_ORIGINAL_BUDGET_FIXTURE = Object.freeze({
+  face2xBytes: 21758960,
+  face3xBytes: 48955600,
+  generatedRigAndFocusBaselineBytes: 90779744,
+  transitionOverlapBytes: 366506528,
+  corrective2x: Object.freeze({ bakeScale: null, layoutWidth: 828, layoutHeight: 1168 }),
+  corrective3x: Object.freeze({ bakeScale: 2, layoutWidth: 812, layoutHeight: 1147 })
+});
+
+export {
+  MIB,
+  SCENE_SURFACE_TEXTURE_BUDGET_BYTES,
+  SCENE_CONTEXT_GL_BUDGET_BYTES,
+  SCENE_RENDER_JOB_BUDGET_BYTES,
+  SCENE_MAX_TRIANGLES,
+  I0_ORIGINAL_BUDGET_FIXTURE
+};

package/dist/{chunk-ZN6P3KOJ.js → chunk-32TH76H3.js}

@@ -310,7 +310,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 / PATCH /projects/:id with brandKitId). 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.',
+    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 / PATCH /projects/:id with brandKitId). 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, a copyable two-shot example with its asset-binding map, the admitted image formats (PNG/JPEG/WebP), the reference-aspect rule, screen-vs-world text, the v1 limits and the global-effect scope gap.',
     okFormat: (j, a) => {
       const warns = formatWarnings(j);
       if (j && typeof j.valid === "boolean") {
@@ -483,7 +483,7 @@ Call wait_job(kind="verify", id="${j.jobId}") to block until the scores + checkp
     name: "list_catalog",
     operationId: "listCatalog",
     defaults: { limit: 20 },
-    description: "DISCOVER WHAT TO BUILD WITH \u2014 list the component catalog: the built-in primitive catalog plus your org-installed components. The agent-safe default page is 20 entries; use pagination.nextCursor as `after`, or narrow with category, kind, tier, useCase, mood, q, or intent. Results are recommended-tier-first when filtered. Each entry carries the exact placement hint for apply_composition and fixedCopy warnings; use get_component_source to fork a primitive when baked copy must change. Read cueframe://component/{id} for the full prop schema.",
+    description: "DISCOVER WHAT TO BUILD WITH \u2014 list the component catalog: the built-in primitive catalog plus your org-installed components. The agent-safe default page is 20 entries; use pagination.nextCursor as `after`, or narrow with category, kind, tier, useCase, mood, q, or intent. Results are recommended-tier-first when filtered. Each entry carries the exact placement hint for apply_composition and fixedCopy warnings; use get_component_source to fork a primitive when baked copy must change. Read cueframe://component/{id} for the full prop schema. SCENE SHOTS ARE NOT LISTED HERE: there is no built-in scene primitive, so do not look for one \u2014 author a shot with the scene.add op (see cueframe://scene-shot). The wrapper it registers then appears here as an ordinary INSTALLED component under these same rules.",
     okFormat: (j) => formatComponentList(j),
     annotations: { readOnlyHint: true },
     preview: {