@cueframe/kernel 0.2.21 → 0.2.23

package/dist/_members/composition/scene/schema.d.ts

@@ -347,7 +347,82 @@ export declare function sceneShotImageSlots(spec: Pick<SceneShotSpecV2, 'layers'
 /** Distinct video media ids in first-use order, recursively through groups. */
 export declare function sceneShotVideoSlots(spec: Pick<SceneShotSpecV2, 'layers'>): string[];
 export declare function sceneShotSurfaceCount(spec: Pick<SceneShotSpecV2, 'layers'>): number;
+/**
+ * What a scene shot IS, for a caller reading the published contract.
+ *
+ * It lives HERE, on the schema, because it is generated from here into
+ * `scene/schema.json` and on into `api/openapi.json`. It used to exist only
+ * inside the published `api/openapi.json`, kept alive by the public repo's
+ * `vendor-scene-schema.mjs` reading its own previous output and writing it
+ * back — a hand-authored value surviving inside a generated artifact, which
+ * meant regenerating the contract from source would silently delete the only
+ * description of the feature.
+ */
+export declare const SCENE_SHOT_SPEC_V2_DESCRIPTION = "A version-2 scene shot: a self-contained 3D world-object shot that scene.add / scene.update materializes into an ordinary component clip. The shot owns its layers, camera, lighting, backdrop and normalized local animation; the composition owns start, duration, ordering, cuts and transitions. Coordinates are REFERENCE PIXELS: origin at frame centre, +X right, +Y down, +Z toward the viewer. referenceSize must have the SAME aspect ratio as the composition format; mismatch fails instead of cropping. At equal aspect ratio the shot scales uniformly by outputWidth/referenceWidth. A segment's easing belongs to the keyframe it ARRIVES at; the first keyframe has no easing. Authoring limits: 32 layers, 4 devices, 16 distinct image slots, 256 keyframes per channel, 2048 keyframes per shot. Version 2 supports nested groups, procedural slab/page/phone/laptop objects, screen- and world-space text, admitted image/component/video surfaces, fixed photographic and generated studio environments, transparent/solid/linear/radial backdrops, constraints, focus, grain and vignette. Raw HTML, custom shader props, imported GLB models, arbitrary external HDR environments, skeletal animation and physics are refused with an exact field path.";
 /** Agent-facing schema generated from the same Zod contract used by runtime parsing. */
-export declare const sceneShotJsonSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodType<SceneShotSpecV2, unknown, z.core.$ZodTypeInternals<SceneShotSpecV2, unknown>>>;
+export declare const sceneShotJsonSchema: {
+    description: string;
+    "~standard": z.core.ZodStandardSchemaWithJSON<z.ZodType<SceneShotSpecV2, unknown, z.core.$ZodTypeInternals<SceneShotSpecV2, unknown>>>;
+    $schema?: "https://json-schema.org/draft/2020-12/schema" | "http://json-schema.org/draft-07/schema#" | "http://json-schema.org/draft-04/schema#";
+    $id?: string;
+    $anchor?: string;
+    $ref?: string;
+    $dynamicRef?: string;
+    $dynamicAnchor?: string;
+    $vocabulary?: Record<string, boolean>;
+    $comment?: string;
+    $defs?: Record<string, z.core.JSONSchema.JSONSchema>;
+    type?: z.core.JSONSchema.SchemaType | z.core.JSONSchema.SchemaType[];
+    additionalItems?: z.core.JSONSchema._JSONSchema;
+    unevaluatedItems?: z.core.JSONSchema._JSONSchema;
+    prefixItems?: z.core.JSONSchema._JSONSchema[];
+    items?: z.core.JSONSchema._JSONSchema | z.core.JSONSchema._JSONSchema[];
+    contains?: z.core.JSONSchema._JSONSchema;
+    additionalProperties?: z.core.JSONSchema._JSONSchema;
+    unevaluatedProperties?: z.core.JSONSchema._JSONSchema;
+    properties?: Record<string, z.core.JSONSchema._JSONSchema>;
+    patternProperties?: Record<string, z.core.JSONSchema._JSONSchema>;
+    dependentSchemas?: Record<string, z.core.JSONSchema._JSONSchema>;
+    propertyNames?: z.core.JSONSchema._JSONSchema;
+    if?: z.core.JSONSchema._JSONSchema;
+    then?: z.core.JSONSchema._JSONSchema;
+    else?: z.core.JSONSchema._JSONSchema;
+    allOf?: z.core.JSONSchema.JSONSchema[];
+    anyOf?: z.core.JSONSchema.JSONSchema[];
+    oneOf?: z.core.JSONSchema.JSONSchema[];
+    not?: z.core.JSONSchema._JSONSchema;
+    multipleOf?: number;
+    maximum?: number;
+    exclusiveMaximum?: number | boolean;
+    minimum?: number;
+    exclusiveMinimum?: number | boolean;
+    maxLength?: number;
+    minLength?: number;
+    pattern?: string;
+    maxItems?: number;
+    minItems?: number;
+    uniqueItems?: boolean;
+    maxContains?: number;
+    minContains?: number;
+    maxProperties?: number;
+    minProperties?: number;
+    required?: string[];
+    dependentRequired?: Record<string, string[]>;
+    enum?: Array<string | number | boolean | null>;
+    const?: string | number | boolean | null;
+    id?: string;
+    title?: string;
+    default?: unknown;
+    deprecated?: boolean;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    nullable?: boolean;
+    examples?: unknown[];
+    format?: string;
+    contentMediaType?: string;
+    contentEncoding?: string;
+    contentSchema?: z.core.JSONSchema.JSONSchema;
+    _prefault?: unknown;
+};
 export declare function sceneShotJsonSchemaText(): string;
 export {};

package/dist/_members/mcp/core.d.ts

@@ -38,6 +38,19 @@ export type ToolResult = {
     structuredContent?: Record<string, unknown>;
 };
 export declare function text(s: string): ToolResult;
+/**
+ * A JSON response, carried BOTH ways: the rendered prose a human reads, and the
+ * parsed object a program can consume.
+ *
+ * Curated tools used to return prose only, so `create_render` promised
+ * `{id,status,warnings?}` and delivered "Render queued.\n\nrenderId: …". A
+ * generic MCP consumer had to scrape it (CUE-15 P0). `structuredContent` is the
+ * protocol's channel for exactly this; the text block stays as display.
+ *
+ * Attached only for a non-null, non-array OBJECT, which is what the protocol
+ * allows — a bare array or scalar would be rejected by a validating client.
+ */
+export declare function textWithData(s: string, data: unknown): ToolResult;
 export declare function errText(s: string): ToolResult;
 export declare function firstText(r: ToolResult): string;
 export declare function sniffImageMediaType(base64: string): string | undefined;
@@ -45,7 +58,9 @@ export declare function sniffAudioMediaType(base64: string): string | undefined;
 export declare function withMedia(payload: string, media: {
     data: string;
     kind: 'image' | 'audio';
-}[]): ToolResult;
+}[], 
+/** The parsed response, carried alongside the media for programmatic callers. */
+data?: unknown): ToolResult;
 export declare function fetchAsBase64(url: string, opts?: {
     timeoutMs?: number;
     maxBytes?: number;

package/dist/animate/preparation-facts.js

@@ -4,11 +4,11 @@ import {
   sceneGrainPreparationCpuAllocationV1,
   scenePresetBuilderDescriptorV1,
   sceneSlabPreparationFactsV1
-} from "../chunk-OAVJUZIC.js";
+} from "../chunk-TZ7DKL2G.js";
 import {
   photographicStudioPreparationFactsV1,
   sceneFocusPreparationAllocationsV1
-} from "../chunk-IRVRWQWD.js";
+} from "../chunk-7YL7NJJF.js";
 import "../chunk-2L7PYYJK.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/animate.js

@@ -102,7 +102,7 @@ import {
   useStage,
   weightsAt,
   worldTransform
-} from "./chunk-XUU5PK6J.js";
+} from "./chunk-DEDZKZ6G.js";
 import {
   DEFAULT_LIGHTING_PROFILE,
   DEVICE_GLASS_OPACITY_ENCODED,
@@ -161,7 +161,7 @@ import {
   studioShadowFrustum,
   verifyPhotographicStudioHdr,
   withNormalisedFaceUv
-} from "./chunk-OAVJUZIC.js";
+} from "./chunk-TZ7DKL2G.js";
 import {
   ALLOWED_BAKE_SCALES,
   DEFAULT_BAKE_SCALE,
@@ -183,7 +183,7 @@ import {
   projectedSlotEdges,
   sceneFocusPreparationAllocationsV1,
   selectSceneBakeScale
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 import "./chunk-2L7PYYJK.js";
 import "./chunk-AVTEPAWI.js";
 import "./chunk-2ESYSVXG.js";

package/dist/authoring/scene.js

@@ -13,7 +13,7 @@ import {
   sceneTrackIdFor,
   validateSceneAdd,
   validateSceneUpdate
-} from "../chunk-EGR6QWLX.js";
+} from "../chunk-E54DK225.js";
 import {
   SCENE_TRANSITION_KINDS,
   collectSceneClipIssues,
@@ -22,7 +22,7 @@ import {
   offFrameLattice,
   readSceneSourceRef,
   sceneClipShapeIssues
-} from "../chunk-IRVRWQWD.js";
+} from "../chunk-7YL7NJJF.js";
 import "../chunk-2L7PYYJK.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/authoring.js

@@ -4,7 +4,7 @@ import {
   hasSceneOp,
   isSceneOp,
   materializeSceneOpsCore
-} from "./chunk-EGR6QWLX.js";
+} from "./chunk-E54DK225.js";
 import {
   ZERO_USAGE,
   buildDirectorTools,
@@ -67,7 +67,7 @@ import "./chunk-7PA7FGLD.js";
 import {
   collectSceneClipIssues,
   isSceneShotClip
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 import "./chunk-2L7PYYJK.js";
 import "./chunk-AVTEPAWI.js";
 import "./chunk-2ESYSVXG.js";

package/dist/{chunk-DFAESPHN.js → chunk-3OOMVQ6I.js}

@@ -312,7 +312,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, 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.',
+    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 / update_project with brandKitId \u2014 or PATCH /projects/:id over REST). 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") {
@@ -348,7 +348,7 @@ ${JSON.stringify(r.errors ?? [], null, 2)}${warns}`;
     name: "create_render",
     operationId: "createRender",
     pathArgs: { projectId: "id" },
-    description: "Queue an MP4 render of a project's composition. Returns { id (renderId), status, warnings? } \u2014 `warnings[]` carries non-fatal advisories (omitted when none). The render themes from the project's brand kit (bind one via create_project / PATCH /projects/:id with brandKitId; without one the output is unbranded). Then call wait_job(kind=\"render\", id=renderId, projectId=...) to block until the file is ready and get the download URL, or register a webhook (create_webhook on render.completed \u2014 status rides the payload).",
+    description: "Queue an MP4 render of a project's composition. Returns { id (renderId), status, warnings? } \u2014 `warnings[]` carries non-fatal advisories (omitted when none). The render themes from the project's brand kit (bind one via create_project / update_project with brandKitId \u2014 or PATCH /projects/:id over REST; without one the output is unbranded). Then call wait_job(kind=\"render\", id=renderId, projectId=...) to block until the file is ready and get the download URL, or register a webhook (create_webhook on render.completed \u2014 status rides the payload).",
     okFormat: (j, a) => `Render queued.
 
 renderId: ${j.id}
@@ -552,7 +552,7 @@ Poll get_media_facts(mediaItemId="${a.mediaItemId}", kind="${a.body?.kind}", sta
   {
     name: "create_project",
     operationId: "createProject",
-    description: "Create a new project \u2014 the unit you compose and render into. compose / apply_composition / create_render / the preview family all require a projectId; this mints one. Pass name (required) plus optionally a format (aspectRatio/fps/resolution) and brandKitId. brandKitId binds a brand kit to the PROJECT (pass the kitId from create_brand_kit): colors/fonts/motion theme every render of this project automatically (omit it and the output is unbranded). Bind or change it later via PATCH /projects/:id. Returns the ProjectResponse (id + metadata)."
+    description: "Create a new project \u2014 the unit you compose and render into. compose / apply_composition / create_render / the preview family all require a projectId; this mints one. Pass name (required) plus optionally a format (aspectRatio/fps/resolution) and brandKitId. brandKitId binds a brand kit to the PROJECT (pass the kitId from create_brand_kit): colors/fonts/motion theme every render of this project automatically (omit it and the output is unbranded). Bind or change it later via update_project (PATCH /projects/:id over REST). Returns the ProjectResponse (id + metadata)."
   },
   {
     name: "new_composition",
@@ -639,10 +639,16 @@ Render it with create_render(projectId="${a.projectId}", body={ compositionId: "
     },
     annotations: { readOnlyHint: true }
   },
+  {
+    name: "list_render_fonts",
+    operationId: "listRenderFonts",
+    description: "The fonts the RENDERER can actually draw \u2014 read this BEFORE authoring type, not after a refusal. Per family: the exact family name authoring accepts, the weight RANGES a shipped file declares (a static face has min===max; a variable face gives its axis range), the caption default weights, and whether the bytes are bundled or an aliased metric-compatible stand-in. Anything listed here passes validation by construction: it is derived from the same table the font gate refuses by. Two facts worth reading off it \u2014 every family's `styles` is [\"normal\"], because NO bundled family ships an italic FILE (a real italic comes only from a brand-kit font asset), and a weight outside every range is REFUSED, never synthesised. Contrast search_fonts, which searches the GOOGLE catalog and will happily return families the renderer cannot draw. `manifestVersion` identifies this exact face table; record it beside a composition to state what a font choice was validated against. Covers the bundled set only \u2014 a brand kit's sealed faces are per-org and per-render. No args, read-only, free.",
+    annotations: { readOnlyHint: true }
+  },
   {
     name: "search_fonts",
     operationId: "searchFonts",
-    description: "Search web font families by name/style \u2014 returns family names to use in composition/component params. Pass query (+ optional perPage \u226450). Read-only + free; surfaces the Google Fonts catalog (family + category + variants + css2 stylesheet URL). IMPORTANT: this searches the GOOGLE catalog, not what the render can actually draw. Only the faces vendored into the render page are guaranteed to rasterize; naming any other family gets you the generic fallback (Liberation Sans) with no error. create_render returns a `font_not_available` warning naming the guaranteed set \u2014 treat that set, not this catalog, as the list you may choose from. An empty result set here means no match, or the upstream catalog was unavailable.",
+    description: "Search web font families by name/style \u2014 returns family names to use in composition/component params. Pass query (+ optional perPage \u226450). Read-only + free; surfaces the Google Fonts catalog (family + category + variants + css2 stylesheet URL). IMPORTANT: this searches the GOOGLE catalog, not what the render can actually draw. Only the faces vendored into the render page are guaranteed to rasterize; naming any other family gets you the generic fallback (Liberation Sans) with no error. Call list_render_fonts for the set you may actually choose from, WITH the admitted weights per family \u2014 treat that, not this catalog, as the list. An empty result set here means no match, or the upstream catalog was unavailable.",
     okFormat: (j) => `${(j.results || []).length} fonts: ${(j.results || []).map((r) => r.family).slice(0, 10).join(", ")}`,
     annotations: { readOnlyHint: true }
   },
@@ -800,7 +806,7 @@ Render it with create_render(projectId="${a.projectId}", body={ compositionId: "
   {
     name: "create_brand_kit",
     operationId: "createBrandKit",
-    description: "Create or UPSERT a brand kit (re-POSTing the same kitId updates it in place \u2014 this is also the brand-kit UPDATE path). Sets fonts/colors/logo. This is brand step 0 of the workflow: author the kit, then bind it to a PROJECT so colors/fonts/motion theme the output AUTOMATICALLY \u2014 pass its kitId as brandKitId to create_project, or attach it to an existing project via PATCH /projects/:id. Without a bound kit, create_render produces UNBRANDED output. Tenant-scoped (no project arg)."
+    description: "Create or UPSERT a brand kit (re-POSTing the same kitId updates it in place \u2014 this is also the brand-kit UPDATE path). Sets fonts/colors/logo. This is brand step 0 of the workflow: author the kit, then bind it to a PROJECT so colors/fonts/motion theme the output AUTOMATICALLY \u2014 pass its kitId as brandKitId to create_project, or attach it to an existing project via update_project (PATCH /projects/:id over REST). Without a bound kit, create_render produces UNBRANDED output. Tenant-scoped (no project arg)."
   },
   {
     name: "extract_brand_kit",

package/dist/{chunk-IRVRWQWD.js → chunk-7YL7NJJF.js}

@@ -1172,10 +1172,14 @@ function sceneShotSurfaceCount(spec2) {
   });
   return count;
 }
-var sceneShotJsonSchema = z.toJSONSchema(SceneShotSpecV2Schema, {
-  target: "draft-2020-12",
-  io: "input"
-});
+var SCENE_SHOT_SPEC_V2_DESCRIPTION = "A version-2 scene shot: a self-contained 3D world-object shot that scene.add / scene.update materializes into an ordinary component clip. The shot owns its layers, camera, lighting, backdrop and normalized local animation; the composition owns start, duration, ordering, cuts and transitions. Coordinates are REFERENCE PIXELS: origin at frame centre, +X right, +Y down, +Z toward the viewer. referenceSize must have the SAME aspect ratio as the composition format; mismatch fails instead of cropping. At equal aspect ratio the shot scales uniformly by outputWidth/referenceWidth. A segment's easing belongs to the keyframe it ARRIVES at; the first keyframe has no easing. Authoring limits: 32 layers, 4 devices, 16 distinct image slots, 256 keyframes per channel, 2048 keyframes per shot. Version 2 supports nested groups, procedural slab/page/phone/laptop objects, screen- and world-space text, admitted image/component/video surfaces, fixed photographic and generated studio environments, transparent/solid/linear/radial backdrops, constraints, focus, grain and vignette. Raw HTML, custom shader props, imported GLB models, arbitrary external HDR environments, skeletal animation and physics are refused with an exact field path.";
+var sceneShotJsonSchema = {
+  ...z.toJSONSchema(SceneShotSpecV2Schema, {
+    target: "draft-2020-12",
+    io: "input"
+  }),
+  description: SCENE_SHOT_SPEC_V2_DESCRIPTION
+};
 function sceneShotJsonSchemaText() {
   return `${JSON.stringify(sceneShotJsonSchema, null, 2)}
 `;
@@ -3437,6 +3441,7 @@ export {
   sceneShotImageSlots,
   sceneShotVideoSlots,
   sceneShotSurfaceCount,
+  SCENE_SHOT_SPEC_V2_DESCRIPTION,
   sceneShotJsonSchema,
   sceneShotJsonSchemaText,
   contentFrame,

package/dist/{chunk-TWI22U3C.js → chunk-AMKPFIF4.js}

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

package/dist/{chunk-PSMIDGQA.js → chunk-CDZBSLVA.js}

@@ -15,7 +15,7 @@ import {
   componentBrowserBackend,
   componentBrowserOptions,
   readGpuAttestation
-} from "./chunk-BWLYZQ7I.js";
+} from "./chunk-VDSO2KZY.js";
 import {
   ComponentCapturePageRasterAttestationV1,
   ComponentGraphicsApiV2,
@@ -28,7 +28,7 @@ import {
 } from "./chunk-ZVG446DJ.js";
 import {
   parseSceneShotSpecV2
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 import {
   BUNDLED_FONT_FACES
 } from "./chunk-AVTEPAWI.js";

package/dist/{chunk-XUU5PK6J.js → chunk-DEDZKZ6G.js}

@@ -19,7 +19,7 @@ import {
   slabTriangleCount,
   takeSceneEnvironment,
   useSceneActualResourceRegistrarV1
-} from "./chunk-OAVJUZIC.js";
+} from "./chunk-TZ7DKL2G.js";
 import {
   PHOTOGRAPHIC_STUDIO_RIG_ID,
   SCENE_SLAB_CONTENT_OFFSET,
@@ -31,7 +31,7 @@ import {
   sceneTextureBytes,
   sceneVideoMidpointAddressV1,
   selectSceneBakeScale
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 import {
   resolveCaptionFaces
 } from "./chunk-AVTEPAWI.js";

package/dist/{chunk-EGR6QWLX.js → chunk-E54DK225.js}

@@ -8,7 +8,7 @@ import {
   sceneShotImageSlots,
   sceneShotVideoSlots,
   sceneSpecIssues
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 
 // ../authoring/src/scene/validate.ts
 var SceneAuthoringError = class extends Error {

package/dist/{chunk-OTZDVUAM.js → chunk-EDR75OU7.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-STTZC7NN.js";
+} from "./chunk-RGKDDR7H.js";
 
 // ../mcp/src/wait.ts
 var defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));

package/dist/{chunk-7UVN36UK.js → chunk-LPFVUT3S.js}

@@ -2,7 +2,10 @@ import {
   querySchemaShape,
   serializeQuery,
   waitForJob
-} from "./chunk-OTZDVUAM.js";
+} from "./chunk-EDR75OU7.js";
+import {
+  CURATED_TOOLS
+} from "./chunk-3OOMVQ6I.js";
 import {
   GENERATED_OPERATIONS,
   apiErrorFrom,
@@ -18,11 +21,9 @@ import {
   safeParse,
   sniffImageMediaType,
   text,
+  textWithData,
   withMedia
-} from "./chunk-STTZC7NN.js";
-import {
-  CURATED_TOOLS
-} from "./chunk-DFAESPHN.js";
+} from "./chunk-RGKDDR7H.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;
@@ -2948,7 +2949,8 @@ var SCENE_SHOT_SCHEMA = deepFreeze({
         }
       ]
     }
-  }
+  },
+  "description": "A version-2 scene shot: a self-contained 3D world-object shot that scene.add / scene.update materializes into an ordinary component clip. The shot owns its layers, camera, lighting, backdrop and normalized local animation; the composition owns start, duration, ordering, cuts and transitions. Coordinates are REFERENCE PIXELS: origin at frame centre, +X right, +Y down, +Z toward the viewer. referenceSize must have the SAME aspect ratio as the composition format; mismatch fails instead of cropping. At equal aspect ratio the shot scales uniformly by outputWidth/referenceWidth. A segment's easing belongs to the keyframe it ARRIVES at; the first keyframe has no easing. Authoring limits: 32 layers, 4 devices, 16 distinct image slots, 256 keyframes per channel, 2048 keyframes per shot. Version 2 supports nested groups, procedural slab/page/phone/laptop objects, screen- and world-space text, admitted image/component/video surfaces, fixed photographic and generated studio environments, transparent/solid/linear/radial backdrops, constraints, focus, grain and vignette. Raw HTML, custom shader props, imported GLB models, arbitrary external HDR environments, skeletal animation and physics are refused with an exact field path."
 });
 var SCENE_SHOT_SCHEMA_DESCRIPTION = "A version-2 scene shot: a self-contained 3D world-object shot that scene.add / scene.update materializes into an ordinary component clip. The shot owns its layers, camera, lighting, backdrop and normalized local animation; the composition owns start, duration, ordering, cuts and transitions. Coordinates are REFERENCE PIXELS: origin at frame centre, +X right, +Y down, +Z toward the viewer. referenceSize must have the SAME aspect ratio as the composition format; mismatch fails instead of cropping. At equal aspect ratio the shot scales uniformly by outputWidth/referenceWidth. A segment's easing belongs to the keyframe it ARRIVES at; the first keyframe has no easing. Authoring limits: 32 layers, 4 devices, 16 distinct image slots, 256 keyframes per channel, 2048 keyframes per shot. Version 2 supports nested groups, procedural slab/page/phone/laptop objects, screen- and world-space text, admitted image/component/video surfaces, fixed photographic and generated studio environments, transparent/solid/linear/radial backdrops, constraints, focus, grain and vignette. Raw HTML, custom shader props, imported GLB models, arbitrary external HDR environments, skeletal animation and physics are refused with an exact field path.";
 var SCENE_SHOT_EXAMPLE_SHOTS = deepFreeze([
@@ -3615,7 +3617,7 @@ function registerResources(server, ex) {
     }),
     {
       title: "Component catalog",
-      description: "The component catalog: the FULL built-in primitive catalog (96 primitives + 7 scenes \u2014 lower-third, cinematic-title, color-grade, the scenes \u2026) PLUS your org-installed custom components. This is 'discover what to build with'. resources/list enumerates EVERY entry with its discovery facets (source/category/kind/tier/useCase) and a placement hint; read one for its full prop schema. NOT only your authored components. URI: cueframe://component/{componentId}.",
+      description: "The component catalog: the FULL built-in primitive catalog (lower-third, cinematic-title, color-grade, the `scenes`-category templates \u2026) PLUS your org-installed custom components. This is 'discover what to build with'. resources/list enumerates EVERY entry with its discovery facets (source/category/kind/tier/useCase) and a placement hint; read one for its full prop schema. NOT only your authored components. NOTE the word 'scene' means two different things: the `scenes` CATEGORY here is composed built-in templates you place by primitiveId, whereas a SCENE SHOT (the scene.add op, cueframe://scene-shot) is a 3D spec you author and has no catalog entry at all. URI: cueframe://component/{componentId}.",
       mimeType: "application/json"
     },
     async (uri, { componentId }) => jsonResource(uri, await read(ex, "getComponent", () => String(componentId)))
@@ -3759,9 +3761,9 @@ function registerCuratedTools(server, ex, opts) {
             const urls = spec.preview.urls(json).filter(Boolean);
             const data = await fetchPreviews(urls, spec.preview.cap ?? 12);
             report({ preview: { urls: urls.length, fetched: data.length } });
-            if (data.length) return withMedia(payload, data.map((d) => ({ data: d, kind })));
+            if (data.length) return withMedia(payload, data.map((d) => ({ data: d, kind })), json);
           }
-          return text(payload);
+          return textWithData(payload, json);
         }, query);
       } catch (err) {
         return errText(`${spec.name} failed: ${fmtErr(err)}`);

package/dist/{chunk-WDJGMAZK.js → chunk-PQDALM2G.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-K4VE64CR.js";
+import {
+  compositionHasVo,
+  roleDefaultGainDb
+} from "./chunk-VZ7TYX6Z.js";
 import {
   SHOT_SCALE_TARGET,
   shotScaleZoom
@@ -51,7 +51,7 @@ import {
   sceneFullMipLevels,
   sceneTextureBytes,
   selectSceneBakeScale
-} from "./chunk-IRVRWQWD.js";
+} from "./chunk-7YL7NJJF.js";
 import {
   SCENE_CONTEXT_GL_BUDGET_BYTES,
   SCENE_MAX_TRIANGLES,

package/dist/{chunk-VHCP4OLA.js → chunk-PRSRV7AT.js}

@@ -1,3 +1,7 @@
+import {
+  frostedGlassWipe,
+  spatialPush
+} from "./chunk-QGAWDLYX.js";
 import {
   DashboardPopulate
 } from "./chunk-S5H6GH6M.js";
@@ -7,10 +11,6 @@ import {
 import {
   EASING_BY_INTENT
 } from "./chunk-MFHXCHRI.js";
-import {
-  frostedGlassWipe,
-  spatialPush
-} from "./chunk-QGAWDLYX.js";
 import {
   ACCENT,
   ACCENT_SOFT,
@@ -43,14 +43,14 @@ import {
   makeDefaultScreenTexture,
   resolveCamera,
   useImageTexture
-} from "./chunk-XUU5PK6J.js";
+} from "./chunk-DEDZKZ6G.js";
 import {
   DEVICE_GLASS_OPACITY_ENCODED,
   DeviceMesh,
   StudioRig,
   deviceDimensions,
   laptopLayout
-} from "./chunk-OAVJUZIC.js";
+} from "./chunk-TZ7DKL2G.js";
 
 // ../execution/primitives/src/scenes/changelog-bite/index.tsx
 import {