@cueframe/kernel 0.2.59-rc.2 → 0.2.59-rc.3

package/dist/{chunk-FZB7UX44.js → chunk-KEQTT67U.js}

@@ -1392,7 +1392,7 @@ var BriefCreateRequest = zod19.strictObject({
       "kind": zod19.literal("component"),
       "componentId": zod19.string().min(1),
       "props": zod19.record(zod19.string(), zod19.unknown()),
-      "assets": zod19.record(zod19.string(), zod19.string().min(1)).optional(),
+      "assets": zod19.record(zod19.string(), zod19.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod19.enum(["front", "behind-subject"]).optional()
     }), zod19.strictObject({
       "kind": zod19.literal("overlay"),
@@ -1409,12 +1409,6 @@ var BriefCreateRequest = zod19.strictObject({
       "kind": zod19.literal("effect"),
       "primitiveId": zod19.string().min(1),
       "params": zod19.record(zod19.string(), zod19.unknown()).optional()
-    }), zod19.strictObject({
-      "kind": zod19.literal("alpha-layer"),
-      "componentId": zod19.string().min(1),
-      "props": zod19.record(zod19.string(), zod19.unknown()),
-      "assets": zod19.record(zod19.string(), zod19.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod19.enum(["front", "behind-subject"]).optional()
     }), zod19.strictObject({
       "kind": zod19.literal("card"),
       "html": zod19.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -1654,7 +1648,7 @@ var BriefResponse = zod21.strictObject({
       "kind": zod21.literal("component"),
       "componentId": zod21.string().min(1),
       "props": zod21.record(zod21.string(), zod21.unknown()),
-      "assets": zod21.record(zod21.string(), zod21.string().min(1)).optional(),
+      "assets": zod21.record(zod21.string(), zod21.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod21.enum(["front", "behind-subject"]).optional()
     }), zod21.strictObject({
       "kind": zod21.literal("overlay"),
@@ -1671,12 +1665,6 @@ var BriefResponse = zod21.strictObject({
       "kind": zod21.literal("effect"),
       "primitiveId": zod21.string().min(1),
       "params": zod21.record(zod21.string(), zod21.unknown()).optional()
-    }), zod21.strictObject({
-      "kind": zod21.literal("alpha-layer"),
-      "componentId": zod21.string().min(1),
-      "props": zod21.record(zod21.string(), zod21.unknown()),
-      "assets": zod21.record(zod21.string(), zod21.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod21.enum(["front", "behind-subject"]).optional()
     }), zod21.strictObject({
       "kind": zod21.literal("card"),
       "html": zod21.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -1905,7 +1893,7 @@ var BriefPatchRequest = zod23.strictObject({
       "kind": zod23.literal("component"),
       "componentId": zod23.string().min(1),
       "props": zod23.record(zod23.string(), zod23.unknown()),
-      "assets": zod23.record(zod23.string(), zod23.string().min(1)).optional(),
+      "assets": zod23.record(zod23.string(), zod23.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod23.enum(["front", "behind-subject"]).optional()
     }), zod23.strictObject({
       "kind": zod23.literal("overlay"),
@@ -1922,12 +1910,6 @@ var BriefPatchRequest = zod23.strictObject({
       "kind": zod23.literal("effect"),
       "primitiveId": zod23.string().min(1),
       "params": zod23.record(zod23.string(), zod23.unknown()).optional()
-    }), zod23.strictObject({
-      "kind": zod23.literal("alpha-layer"),
-      "componentId": zod23.string().min(1),
-      "props": zod23.record(zod23.string(), zod23.unknown()),
-      "assets": zod23.record(zod23.string(), zod23.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod23.enum(["front", "behind-subject"]).optional()
     }), zod23.strictObject({
       "kind": zod23.literal("card"),
       "html": zod23.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -2812,7 +2794,7 @@ var Composition = zod58.strictObject({
         "kind": zod58.literal("component"),
         "componentId": zod58.string().min(1),
         "props": zod58.record(zod58.string(), zod58.unknown()),
-        "assets": zod58.record(zod58.string(), zod58.string().min(1)).optional(),
+        "assets": zod58.record(zod58.string(), zod58.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
         "zPlane": zod58.enum(["front", "behind-subject"]).optional()
       }), zod58.strictObject({
         "kind": zod58.literal("overlay"),
@@ -2829,12 +2811,6 @@ var Composition = zod58.strictObject({
         "kind": zod58.literal("effect"),
         "primitiveId": zod58.string().min(1),
         "params": zod58.record(zod58.string(), zod58.unknown()).optional()
-      }), zod58.strictObject({
-        "kind": zod58.literal("alpha-layer"),
-        "componentId": zod58.string().min(1),
-        "props": zod58.record(zod58.string(), zod58.unknown()),
-        "assets": zod58.record(zod58.string(), zod58.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-        "zPlane": zod58.enum(["front", "behind-subject"]).optional()
       }), zod58.strictObject({
         "kind": zod58.literal("card"),
         "html": zod58.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -6520,7 +6496,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("component"),
       "componentId": zod67.string().min(1),
       "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional(),
+      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("overlay"),
@@ -6537,12 +6513,6 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("effect"),
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
-    }), zod67.strictObject({
-      "kind": zod67.literal("alpha-layer"),
-      "componentId": zod67.string().min(1),
-      "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("card"),
       "html": zod67.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -6670,7 +6640,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("component"),
       "componentId": zod67.string().min(1),
       "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional(),
+      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("overlay"),
@@ -6687,12 +6657,6 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("effect"),
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
-    }), zod67.strictObject({
-      "kind": zod67.literal("alpha-layer"),
-      "componentId": zod67.string().min(1),
-      "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("card"),
       "html": zod67.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),
@@ -6816,7 +6780,7 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("component"),
       "componentId": zod67.string().min(1),
       "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional(),
+      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
       "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("overlay"),
@@ -6833,12 +6797,6 @@ var CompositionOp = zod67.union([zod67.strictObject({
       "kind": zod67.literal("effect"),
       "primitiveId": zod67.string().min(1),
       "params": zod67.record(zod67.string(), zod67.unknown()).optional()
-    }), zod67.strictObject({
-      "kind": zod67.literal("alpha-layer"),
-      "componentId": zod67.string().min(1),
-      "props": zod67.record(zod67.string(), zod67.unknown()),
-      "assets": zod67.record(zod67.string(), zod67.string().min(1)).optional().describe("Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."),
-      "zPlane": zod67.enum(["front", "behind-subject"]).optional()
     }), zod67.strictObject({
       "kind": zod67.literal("card"),
       "html": zod67.string().min(1).describe("Your card's HTML \u2014 rendered VERBATIM as the graphic (shell motion via applyMotionPreset in a FOLLOWING call). CANVAS CONTRACT: the card renders in a viewport equal to the composition format's pixel frame (1080\xD71920 at 9:16 fhd); the root is NOT auto-pinned \u2014 declare explicit width/height matching the frame (box-sizing:border-box) and anchor content with flex/grid; position:absolute;inset:0 on the root does NOT fill the frame; for edge-to-edge backgrounds add an inner absolutely-positioned layer with generous negative inset. Overlay compositing applies a ~92% safe-area inset \u2014 keep critical copy away from the extreme edges. FONTS: name a family from GET /v1/fonts (list_render_fonts) \u2014 the renderer loads those faces for the card and waits for them, so `font-family: Inter` draws Inter. `@import` and remote font files are REFUSED: the card renders with no network. A family that is not on that list has no bytes behind it and the browser falls back, so end any stack with a generic (`Inter, sans-serif`) rather than relying on a system face being present."),

package/dist/{chunk-ML3HG2AZ.js → chunk-KRIEZVXX.js}

@@ -5,7 +5,7 @@ var DescribeCompositionOpsInput = z.object({
   type: z.string().optional().describe("Exact CompositionOp type, such as captions.fromComposition. Omit for the operation list.")
 });
 async function describeCompositionOps(type) {
-  const { CompositionOp } = await import("./src-XQYRJ27W.js");
+  const { CompositionOp } = await import("./src-XYW7BEJ5.js");
   const variants = CompositionOp.options;
   const knownTypes = variants.map((variant2) => variant2.shape.type.value);
   if (type === void 0) {

package/dist/{chunk-PLWDYWK6.js → chunk-KWWWMU5S.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-XHMKPTHV.js";
 import {
   checkTracks
-} from "./chunk-T56BK7NS.js";
+} from "./chunk-JRGALHBZ.js";
 
 // ../composition/src/invariants/etag.ts
 import { sha256 } from "@noble/hashes/sha256";

package/dist/{chunk-GQFJKDCH.js → chunk-L53YKOK4.js}

@@ -1,15 +1,15 @@
+import {
+  isBehindSubjectDepthSource
+} from "./chunk-DPMS7I65.js";
 import {
   activeFaceKeepOutSeries,
   boundingBox,
   resolveBrandRefsDeep
 } from "./chunk-DKBFAQCW.js";
-import {
-  isBehindSubjectDepthSource
-} from "./chunk-J44R72DZ.js";
 import {
   CueframeError,
   encodeError
-} from "./chunk-XQGQ5EFS.js";
+} from "./chunk-O3RHY4ZI.js";
 
 // ../composition/src/projection/cardTokens.ts
 var CARD_MOTION_VAR_NAMES = [

package/dist/{chunk-QCETEKQX.js → chunk-LRS32NU7.js}

@@ -2,18 +2,18 @@ import {
   SCENE_SHOT_RESOURCE_DESCRIPTION,
   SCENE_SHOT_RESOURCE_URI,
   sceneShotContract
-} from "./chunk-I2HNC4PQ.js";
+} from "./chunk-FZCVNHML.js";
 import {
   WAIT_KINDS,
   querySchemaShape,
   serializeQuery,
   waitForJob
-} from "./chunk-7II5OM7R.js";
+} from "./chunk-TBZEIN45.js";
 import {
   DESCRIBE_COMPOSITION_OPS_DESCRIPTION,
   DescribeCompositionOpsInput,
   describeCompositionOps
-} from "./chunk-ML3HG2AZ.js";
+} from "./chunk-KRIEZVXX.js";
 import {
   GENERATED_OPERATIONS,
   apiErrorFrom,
@@ -31,10 +31,10 @@ import {
   text,
   textWithData,
   withMedia
-} from "./chunk-FZB7UX44.js";
+} from "./chunk-KEQTT67U.js";
 import {
   CURATED_TOOLS
-} from "./chunk-4OHLOBXS.js";
+} from "./chunk-EA3J5XUJ.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;
@@ -117,7 +117,7 @@ Every long job is either polled or pushed \u2014 never guessed:
 - Webhooks (\`create_webhook\`): ONE terminal event per kind with status INSIDE the payload \u2014 \`render.completed\`, \`compose.completed\`, \`media.completed\`, \`suggest.completed\` \u2014 plus \`checkpoint.ready\` (a held compose paused for review). Read \`cueframe://webhook-events\` for the full contract before building a receiver.
 - Presigned URLs (stills, clips, render outputs) expire \u2014 render outputs last ~7 days (refresh via the render's refresh-url op); preview stills/clips ~1 hour. Re-read for a fresh link instead of caching one.
 
-CUSTOM GRAPHICS \u2014 author or FORK: \`create_component\` (tsxSource + contract-v2 manifest) from scratch, or \`get_component_source\` on a built-in primitive (e.g. \`cinematic-title\`) to fork its editable module. Iterate author\u2192preview\u2192fix with \`preview_component\` (202 + jobId; \`wait_job(kind:"preview")\` returns the verified artifact from the same immutable bundle used by production; a compile/runtime/capability failure lands on the job's FAILED terminal carrying the sanitized author-fixable message) \u2192 fix via \`update_component\` \u2192 preview again. Place the verified component via \`apply_composition\` as a \`{kind:'component', componentId, props}\` clip. \`alpha-layer\` is a cloud render artifact agents never write.
+CUSTOM GRAPHICS \u2014 author or FORK: \`create_component\` (tsxSource + contract-v2 manifest) from scratch, or \`get_component_source\` on a built-in primitive (e.g. \`cinematic-title\`) to fork its editable module. Iterate author\u2192preview\u2192fix with \`preview_component\` (202 + jobId; \`wait_job(kind:"preview")\` returns the verified artifact from the same immutable bundle used by production; a compile/runtime/capability failure lands on the job's FAILED terminal carrying the sanitized author-fixable message) \u2192 fix via \`update_component\` \u2192 preview again. Place the verified component via \`apply_composition\` as a \`{kind:'component', componentId, props}\` clip.
 
 Cleanup: \`delete_project\` / \`delete_media\` / \`delete_webhook\` / \`delete_composition\`. \`list_projects\` re-orients you in an existing workspace; \`list_media\` (filter by \`source\`/\`tag\`) lists the library.
 

package/dist/{chunk-6KZCXAYL.js → chunk-MRLC4HLJ.js}

@@ -1,7 +1,7 @@
 import {
   GraphicRole,
   OpaqueId
-} from "./chunk-AFUITAH6.js";
+} from "./chunk-S6YSOEK5.js";
 import {
   CardHtml
 } from "./chunk-EQH37KNZ.js";

package/dist/{chunk-P6RVYHLT.js → chunk-NASGAME6.js}

@@ -3,13 +3,13 @@ import {
   assertSceneShotParamsAdmitted,
   materializeComponentSource,
   renderComponentAlpha
-} from "./chunk-AK6QPX7A.js";
+} from "./chunk-DBBKM74E.js";
 import {
   assertSourceReadsDeclaredAssets
-} from "./chunk-6HPEMDQW.js";
+} from "./chunk-ZUCLQVXD.js";
 import {
   resolvedComponentRenderer
-} from "./chunk-KC4LNZL5.js";
+} from "./chunk-VSHAP22Q.js";
 import {
   componentArtifactId,
   componentBundleId,
@@ -25,7 +25,7 @@ import {
   ComponentRuntimeError,
   assertGraphicsReceiptMatches,
   assertRendererReceiptMatches
-} from "./chunk-BZVOCVQV.js";
+} from "./chunk-BLVSFN6J.js";
 
 // ../execution/component-runtime/src/assetServer.ts
 import { createHash, randomBytes } from "crypto";

package/dist/{chunk-XQGQ5EFS.js → chunk-O3RHY4ZI.js}

@@ -66,6 +66,7 @@ var ERROR_CODES = {
   component_does_not_compile: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   component_runtime_error: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   component_source_unavailable: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
+  component_source_unpinned: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   scene_materialization_failed: { stage: "validate", category: "authoring", retryable: false, httpStatus: 422 },
   // ── CUE-28: codes that were thrown typed and arrived as internal_error 500 ──
   //
@@ -182,6 +183,7 @@ var ERROR_CODES = {
   wrong_status: { stage: "billing", category: "authoring", retryable: false, httpStatus: 409 },
   transcript_payload_empty: { stage: "import", category: "authoring", retryable: false, httpStatus: 422 },
   render_job_no_snapshot: { stage: "render", category: "internal", retryable: false, httpStatus: 500 },
+  composition_unreadable: { stage: "validate", category: "internal", retryable: false, httpStatus: 500 },
   project_revision_invariant: { stage: "system", category: "internal", retryable: false, httpStatus: 500 },
   // ── INTERNAL: the message would describe our infrastructure, not the request.
   // Registered anyway, so the CODE and `retryable` are still honest even though

package/dist/{chunk-WPZKOVYF.js → chunk-OL3ULF5Q.js}

@@ -1,5 +1,5 @@
 // ../composition/src/validators/graphicKinds.ts
-var AUTHORED_GRAPHIC_KINDS = ["overlay", "component", "card", "alpha-layer"];
+var AUTHORED_GRAPHIC_KINDS = ["overlay", "component", "card"];
 var GRAPHIC_ROLE_CANONICAL_KIND = {
   "title-card": "overlay",
   stat: "overlay",

package/dist/{chunk-AFUITAH6.js → chunk-S6YSOEK5.js}

@@ -62,7 +62,9 @@ var ComponentClipSource = z2.object({
   kind: z2.literal("component"),
   componentId: z2.string().min(1),
   props: z2.record(z2.string(), z2.unknown()),
-  assets: z2.record(z2.string().min(1), z2.string().min(1)).optional(),
+  assets: z2.record(z2.string().min(1), z2.string().min(1)).optional().describe(
+    "Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."
+  ),
   zPlane: z2.enum(["front", "behind-subject"]).optional()
 });
 var OverlayClipSource = z2.object({
@@ -78,15 +80,6 @@ var EffectClipSource = z2.object({
   primitiveId: z2.string().min(1),
   params: z2.record(z2.string(), z2.unknown()).optional()
 });
-var AlphaLayerClipSource = z2.object({
-  kind: z2.literal("alpha-layer"),
-  componentId: z2.string().min(1),
-  props: z2.record(z2.string(), z2.unknown()),
-  assets: z2.record(z2.string().min(1), z2.string().min(1)).optional().describe(
-    "Manifest asset slot \u2192 project media id. At mount each slot arrives as `assets[slot].handle`, a fetchable URL for <Img>/<Video>/<Audio>; `props` becomes `params` and never carries an asset URL."
-  ),
-  zPlane: z2.enum(["front", "behind-subject"]).optional()
-});
 var CardClipSource = z2.object({
   kind: z2.literal("card"),
   html: CardHtml,
@@ -103,7 +96,6 @@ var ClipSource = z2.discriminatedUnion("kind", [
   ComponentClipSource,
   OverlayClipSource,
   EffectClipSource,
-  AlphaLayerClipSource,
   CardClipSource,
   CompositionClipSource
 ]);
@@ -636,7 +628,6 @@ export {
   ComponentClipSource,
   OverlayClipSource,
   EffectClipSource,
-  AlphaLayerClipSource,
   CardClipSource,
   CompositionClipSource,
   ClipSource,

package/dist/{chunk-U7KSOA2L.js → chunk-SBKCVRJB.js}

@@ -5,7 +5,7 @@ import {
 import {
   decodeError,
   scrubSensitive
-} from "./chunk-XQGQ5EFS.js";
+} from "./chunk-O3RHY4ZI.js";
 
 // ../director/src/domain/chat.ts
 import { z } from "zod";

package/dist/{chunk-MMJYII7Y.js → chunk-SBWXIK5K.js}

@@ -1,9 +1,9 @@
-import {
-  FitText
-} from "./chunk-XHGZ2E77.js";
 import {
   EASING_BY_INTENT
 } from "./chunk-MFHXCHRI.js";
+import {
+  FitText
+} from "./chunk-XHGZ2E77.js";
 import {
   ACCENT,
   ACCENT_STRONG,
@@ -26,7 +26,7 @@ import {
   perspectiveFor,
   resolveCamera,
   useStage
-} from "./chunk-RWJHZCOR.js";
+} from "./chunk-TG756AMB.js";
 
 // ../execution/primitives/src/effects/blur/index.tsx
 import React2 from "react";

package/dist/{chunk-7II5OM7R.js → chunk-TBZEIN45.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-FZB7UX44.js";
+} from "./chunk-KEQTT67U.js";
 
 // ../mcp/src/wait.ts
 var WAIT_KINDS = [

package/dist/{chunk-RWJHZCOR.js → chunk-TG756AMB.js}

@@ -19,7 +19,7 @@ import {
   slabTriangleCount,
   takeSceneEnvironment,
   useSceneActualResourceRegistrarV1
-} from "./chunk-XV2K3AQT.js";
+} from "./chunk-WONOHP4G.js";
 import {
   PHOTOGRAPHIC_STUDIO_RIG_ID,
   SCENE_SLAB_CONTENT_OFFSET,
@@ -31,7 +31,7 @@ import {
   sceneTextureBytes,
   sceneVideoMidpointAddressV1,
   selectSceneBakeScale
-} from "./chunk-CL5Y6V6K.js";
+} from "./chunk-UB6Z7RY4.js";
 import {
   resolveCaptionFaces
 } from "./chunk-OOL7ZUG7.js";

package/dist/{chunk-X2RTLS6K.js → chunk-TPQA5TPU.js}

@@ -1,7 +1,7 @@
 import {
   ChatErrorView,
   DirectorTurnContext
-} from "./chunk-U7KSOA2L.js";
+} from "./chunk-SBKCVRJB.js";
 import {
   GenerationArtifact
 } from "./chunk-TIAJMEQ4.js";

package/dist/{chunk-CL5Y6V6K.js → chunk-UB6Z7RY4.js}

@@ -1340,7 +1340,7 @@ function isTimelineClip(content) {
   return "source" in content;
 }
 function isSceneShotClip(content, resolveSource) {
-  if (!isTimelineClip(content) || content.source.kind !== "component" && content.source.kind !== "alpha-layer") return false;
+  if (!isTimelineClip(content) || content.source.kind !== "component") return false;
   const ref = readSceneSourceRef(content.source.props);
   if (!ref) return false;
   const declaration = resolveSource(content.source.componentId, ref.sourceVersionId);
@@ -1445,8 +1445,8 @@ function bindingIssues(spec2, assets, path, mediaKindById) {
 function sceneClipShapeIssues(clip, ctx, options = {}) {
   const issues = [];
   const source = clip.source;
-  if (source.kind !== "component" && source.kind !== "alpha-layer") {
-    return [{ path: "source.kind", detail: `a scene shot is a 'component' or 'alpha-layer' clip; got '${source.kind}'.`, code: "invalid_composition" }];
+  if (source.kind !== "component") {
+    return [{ path: "source.kind", detail: `a scene shot is a 'component' clip; got '${source.kind}'.`, code: "invalid_composition" }];
   }
   if (source.zPlane !== void 0 && source.zPlane !== "front") {
     issues.push({

package/dist/{chunk-KC4LNZL5.js → chunk-VSHAP22Q.js}

@@ -1,13 +1,13 @@
 import {
   ComponentHostAttestationV2,
   ComponentRuntimeError
-} from "./chunk-BZVOCVQV.js";
+} from "./chunk-BLVSFN6J.js";
 import {
   canonicalJson
 } from "./chunk-XHMKPTHV.js";
 import {
   STUDIO_SHADOW_MAP_BUDGET
-} from "./chunk-CL5Y6V6K.js";
+} from "./chunk-UB6Z7RY4.js";
 
 // ../execution/component-runtime/src/webglProbe.ts
 function webglBackend(platform, hardware) {

package/dist/{chunk-LVMWPFV4.js → chunk-VW22APZC.js}

@@ -2,7 +2,7 @@ import {
   selectAllClips,
   selectAllOverlays,
   selectSceneMarkers
-} from "./chunk-2K2GBFLU.js";
+} from "./chunk-Y2NR3Y6J.js";
 
 // ../authoring/src/context/transcript.ts
 var MAX_TRANSCRIPT_CHARS = 6e4;

package/dist/chunk-WHYTCQYZ.js

@@ -0,0 +1,161 @@
+// ../composition/src/componentClip.ts
+import { z } from "zod";
+var ComponentSourceRefV1 = z.object({
+  version: z.literal(1),
+  sourceVersionId: z.string().regex(/^[a-f0-9]{64}$/)
+}).strict();
+var COMPONENT_SOURCE_REF_PROP = "componentRef";
+var COMPONENT_RENDER_SEED_PROP = "renderSeed";
+function readComponentSourceRef(props) {
+  const parsed = ComponentSourceRefV1.safeParse(props[COMPONENT_SOURCE_REF_PROP]);
+  return parsed.success ? parsed.data : null;
+}
+function authoredComponentProps(props) {
+  const { [COMPONENT_SOURCE_REF_PROP]: _ref, [COMPONENT_RENDER_SEED_PROP]: _seed, ...authored } = props;
+  return authored;
+}
+var COMPONENT_SOURCE_UNPINNED = "component_source_unpinned";
+function componentClipRenderInput(clip) {
+  const ref = readComponentSourceRef(clip.props);
+  if (!ref) {
+    return {
+      ok: false,
+      refusal: {
+        code: COMPONENT_SOURCE_UNPINNED,
+        message: `component clip ${clip.id} of '${clip.componentId}' pins no immutable source version (props.componentRef)`
+      }
+    };
+  }
+  const seed = clip.props[COMPONENT_RENDER_SEED_PROP];
+  if (seed !== void 0 && (typeof seed !== "string" || seed.length === 0)) {
+    return {
+      ok: false,
+      refusal: { code: "invalid_composition", message: `component clip ${clip.id}: props.renderSeed must be a non-empty string` }
+    };
+  }
+  return {
+    ok: true,
+    input: {
+      sourceVersionId: ref.sourceVersionId,
+      params: authoredComponentProps(clip.props),
+      seed: seed ?? `${clip.componentId}:${clip.id}`
+    }
+  };
+}
+function sceneSurfacePins(scene) {
+  const pins = [];
+  const visit = (objects, prefix) => {
+    if (!Array.isArray(objects)) return;
+    objects.forEach((candidate, index) => {
+      if (!candidate || typeof candidate !== "object") return;
+      const object = candidate;
+      const path = `${prefix}.${index}`;
+      if (object.kind === "group") visit(object.children, `${path}.children`);
+      const surfaces = object.surfaces;
+      if (!surfaces || typeof surfaces !== "object") return;
+      for (const [slot, raw] of Object.entries(surfaces)) {
+        if (!raw || typeof raw !== "object" || raw.source !== "component") continue;
+        const component = raw.component;
+        pins.push({
+          surfacePath: `${path}.surfaces.${slot}`,
+          componentId: typeof component?.componentId === "string" ? component.componentId : "",
+          sourceVersionId: typeof component?.sourceVersionId === "string" ? component.sourceVersionId : ""
+        });
+      }
+    });
+  };
+  visit(scene?.layers, "layers");
+  return pins;
+}
+function compositionComponentPins(composition) {
+  const pins = /* @__PURE__ */ new Map();
+  const add = ({ componentId, sourceVersionId }) => {
+    if (componentId && sourceVersionId) pins.set(`${componentId}:${sourceVersionId}`, { componentId, sourceVersionId });
+  };
+  for (const track of composition.tracks) {
+    for (const clip of track.contents) {
+      const source = clip.source;
+      if (source?.kind !== "component" || typeof source.componentId !== "string") continue;
+      const props = source.props ?? {};
+      const ref = readComponentSourceRef(props);
+      if (ref) add({ componentId: source.componentId, sourceVersionId: ref.sourceVersionId });
+      for (const pin of sceneSurfacePins(authoredComponentProps(props).scene)) add(pin);
+    }
+  }
+  return [...pins.values()];
+}
+function repinnedScene(scene, repin) {
+  let moved = 0;
+  const visit = (objects) => {
+    if (!Array.isArray(objects)) return objects;
+    return objects.map((candidate) => {
+      if (!candidate || typeof candidate !== "object") return candidate;
+      let object = candidate;
+      if (object.kind === "group") object = { ...object, children: visit(object.children) };
+      const surfaces = object.surfaces;
+      if (!surfaces || typeof surfaces !== "object") return object;
+      const next = {};
+      for (const [slot, raw] of Object.entries(surfaces)) {
+        const surface = raw;
+        const component = surface?.component;
+        if (surface?.source === "component" && component?.componentId === repin.componentId && component.sourceVersionId === repin.from) {
+          next[slot] = { ...surface, component: { ...component, sourceVersionId: repin.to } };
+          moved += 1;
+        } else {
+          next[slot] = raw;
+        }
+      }
+      return { ...object, surfaces: next };
+    });
+  };
+  if (!scene || typeof scene !== "object" || !("layers" in scene)) return { scene, moved: 0 };
+  const layers = visit(scene.layers);
+  return moved === 0 ? { scene, moved: 0 } : { scene: { ...scene, layers }, moved };
+}
+function repinnedComponentProps(clipComponentId, props, repin) {
+  let next = props;
+  let moved = 0;
+  if (clipComponentId === repin.componentId && readComponentSourceRef(props)?.sourceVersionId === repin.from) {
+    next = { ...next, [COMPONENT_SOURCE_REF_PROP]: { version: 1, sourceVersionId: repin.to } };
+    moved += 1;
+  }
+  const nested = repinnedScene(props.scene, repin);
+  if (nested.moved > 0) {
+    next = { ...next, scene: nested.scene };
+    moved += nested.moved;
+  }
+  return { props: next, moved };
+}
+function componentPinCount(composition, componentId, sourceVersionId) {
+  let count = 0;
+  for (const track of composition.tracks) {
+    for (const clip of track.contents) {
+      const source = clip.source;
+      if (source?.kind !== "component" || typeof source.componentId !== "string") continue;
+      count += placedPinCount(source.componentId, source.props ?? {}, componentId, sourceVersionId);
+    }
+  }
+  return count;
+}
+function placedPinCount(clipComponentId, props, componentId, sourceVersionId) {
+  const own = clipComponentId === componentId && readComponentSourceRef(props)?.sourceVersionId === sourceVersionId ? 1 : 0;
+  const nested = sceneSurfacePins(authoredComponentProps(props).scene).filter(
+    (pin) => pin.componentId === componentId && pin.sourceVersionId === sourceVersionId
+  ).length;
+  return own + nested;
+}
+
+export {
+  ComponentSourceRefV1,
+  COMPONENT_SOURCE_REF_PROP,
+  COMPONENT_RENDER_SEED_PROP,
+  readComponentSourceRef,
+  authoredComponentProps,
+  COMPONENT_SOURCE_UNPINNED,
+  componentClipRenderInput,
+  sceneSurfacePins,
+  compositionComponentPins,
+  repinnedComponentProps,
+  componentPinCount,
+  placedPinCount
+};

package/dist/{chunk-XV2K3AQT.js → chunk-WONOHP4G.js}

@@ -18,7 +18,7 @@ import {
   sceneW5GeneratedRigAllocationsV1,
   sceneW5PresetAllocationsV1,
   sceneW5WorldTextAllocationsV1
-} from "./chunk-CL5Y6V6K.js";
+} from "./chunk-UB6Z7RY4.js";
 
 // ../execution/animate/src/three/toneMapping.ts
 import {