@cueframe/kernel 0.2.4 → 0.2.5

package/dist/{chunk-UN6NY2E6.js → chunk-SC55VDLC.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. 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.',
+    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, the canonical V2 world-objects recipe with nested groups, slabs, pages, phones, laptops, world/screen text, admitted surfaces, camera motion, lighting, and the current resource limits.',
     okFormat: (j, a) => {
       const warns = formatWarnings(j);
       if (j && typeof j.valid === "boolean") {

package/dist/{chunk-UY77TMKD.js → chunk-VCSSJLOU.js}

@@ -271,16 +271,32 @@ function assertAssetBindingsMatch(request) {
 async function bakeComponentAlphaV2(options) {
   assertSceneShotCapabilitySupported(options.job?.source?.manifest, { componentId: options.job?.source?.componentId });
   const job = ComponentBakeJobV2.parse(options.job);
-  assertSceneShotParamsAdmitted(job.source.manifest, job.params, { componentId: job.source.componentId });
+  const scene = assertSceneShotParamsAdmitted(job.source.manifest, job.params, { componentId: job.source.componentId });
+  if (scene && !options.prepareScene) throw new ComponentRuntimeError(
+    "component_scene_invalid",
+    "scene_prepared_plan_required: The scene bake host must supply canonical scene preparation before capture."
+  );
   const assetServer = await startComponentAssetServer({ assets: job.assets, files: job.assetFiles });
+  let sceneLease;
   try {
     const { assetFiles: _assetFiles, ...unsealedRequest } = job;
-    const request = ComponentBakeRequestV2.parse({
+    let request = ComponentBakeRequestV2.parse({
       ...unsealedRequest,
       assets: assetServer.bindings
     });
     assertAssetBindingsMatch(request);
     const materialized = materializeComponentSource(options.workspaceRoot, request.source);
+    const allowedAssetOrigins = /* @__PURE__ */ new Set([assetServer.origin]);
+    if (scene) {
+      sceneLease = await options.prepareScene({
+        request,
+        materialized,
+        runtimeAssets: assetServer.runtimeAssets,
+        allowedAssetOrigins
+      });
+      request = ComponentBakeRequestV2.parse({ ...request, params: sceneLease.params });
+      assertSceneShotParamsAdmitted(request.source.manifest, request.params, { componentId: request.source.componentId });
+    }
     const bundleId = componentBundleId({
       sourceVersionId: materialized.sourceVersionId,
       runtimeDigest: request.runtimeDigest,
@@ -307,7 +323,7 @@ async function bakeComponentAlphaV2(options) {
       id: request.source.componentId,
       params: request.params,
       assets: assetServer.runtimeAssets,
-      allowedAssetOrigins: /* @__PURE__ */ new Set([assetServer.origin]),
+      allowedAssetOrigins,
       seed: request.seed,
       graphics: request.source.manifest.graphics,
       codec: request.codec,
@@ -360,7 +376,11 @@ async function bakeComponentAlphaV2(options) {
     assertRendererReceiptMatches(renderRequest, receipt);
     return receipt;
   } finally {
-    await assetServer.close();
+    try {
+      await sceneLease?.cleanup();
+    } finally {
+      await assetServer.close();
+    }
   }
 }
 function sourceIdentityForBake(request) {

package/dist/component-runtime.js

@@ -7,7 +7,7 @@ import {
   sourceIdentityForBake,
   startComponentAssetServer,
   verifyComponentOutput
-} from "./chunk-UY77TMKD.js";
+} from "./chunk-VCSSJLOU.js";
 import {
   COMPONENT_MEDIA_HEADROOM,
   COMPONENT_MEDIA_TIERS,

package/dist/mcp/adapter.js

@@ -16,7 +16,7 @@ import {
 } from "../chunk-6BVVCRRD.js";
 import {
   CURATED_TOOLS
-} from "../chunk-UN6NY2E6.js";
+} from "../chunk-SC55VDLC.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../mcp/src/adapter.ts

package/dist/mcp/curation.js

@@ -10,7 +10,7 @@ import {
   formatResourceCandidates,
   formatTranscriptPage,
   formatWarnings
-} from "../chunk-UN6NY2E6.js";
+} from "../chunk-SC55VDLC.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CRUD_COVERAGE,

package/dist/mcp/server.js

@@ -7,10 +7,10 @@ import {
   registerRawTools,
   registerSkillPrompts,
   titleCase
-} from "../chunk-EBIBLL7E.js";
+} from "../chunk-KQDZAHLP.js";
 import "../chunk-E7GIZEPS.js";
 import "../chunk-6BVVCRRD.js";
-import "../chunk-UN6NY2E6.js";
+import "../chunk-SC55VDLC.js";
 import "../chunk-2ESYSVXG.js";
 export {
   RAW_EXCLUDED_OPERATION_IDS,

package/dist/mcp.js

@@ -7,10 +7,10 @@ import {
   buildServer,
   registerCuratedTools,
   registerRawTools
-} from "./chunk-EBIBLL7E.js";
+} from "./chunk-KQDZAHLP.js";
 import "./chunk-E7GIZEPS.js";
 import "./chunk-6BVVCRRD.js";
-import "./chunk-UN6NY2E6.js";
+import "./chunk-SC55VDLC.js";
 import "./chunk-2ESYSVXG.js";
 export {
   API_URLS,

package/dist/render-harness.js

@@ -8,7 +8,7 @@ import {
 import {
   assertCardHtmlAssetFree
 } from "./chunk-ODUWCQI3.js";
-import "./chunk-UY77TMKD.js";
+import "./chunk-VCSSJLOU.js";
 import "./chunk-BVA3537Z.js";
 import {
   COMPONENT_STILL_RUNTIME_IDENTITY,

package/package.json

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