@nodaro/shared 2.27.0 → 3.1.0

package/dist/index.d.cts

@@ -2804,7 +2804,26 @@ type OutputType = "image" | "video" | "audio" | "text" | "data";
 declare function getInputNodes<T extends GenericNode>(nodes: T[], curatedOnly?: boolean): T[];
 /** Get leaf/media-producing nodes that represent workflow outputs. */
 declare function getOutputNodes<T extends GenericNode>(nodes: T[], edges: GenericEdge[], curatedOnly?: boolean): T[];
-/** Map node type to its output media type. */
+/**
+ * Map node type to its output media type.
+ *
+ * The four literal sets above are read FIRST and win: they are the presentation
+ * classifier's own opinion, including for dual-mode nodes whose default medium
+ * is not their handle set (voice-changer and dubbing are audio here even though
+ * they can emit video).
+ *
+ * Anything they do not name falls through to the producer vocabularies the
+ * canvas validators and the orchestrator already maintain
+ * (`packages/shared/src/producer-types.ts`). Those sets are what a new media
+ * node MUST join for its outputs to connect at all, so deriving the tail from
+ * them is what stops this map from silently drifting behind the node catalogue
+ * — which it had (3D Render Pro, Generate Video, Generate Video Pro and a dozen
+ * ffmpeg nodes all read as `"data"`, so a published app rendered them as a JSON
+ * blob and `/v1` app schemas declared the wrong output type).
+ *
+ * `DYNAMIC_PRODUCER_TYPES` is deliberately NOT consulted: a node whose medium
+ * is decided at run time has no static answer, and `"data"` is the honest one.
+ */
 declare function getOutputType(nodeType: string | undefined): OutputType;
 /** Extract the result URL or text from a node's data. */
 declare function getNodeResult(nodeData: Record<string, unknown>): {
@@ -11997,7 +12016,13 @@ interface Scene3DReference {
     startSeconds?: number;
     endSeconds?: number;
 }
-interface Scene3DPlan {
+/**
+ * The v1 plan. `Scene3DPlan` is the DISCRIMINATED UNION of this and
+ * `Scene3DPlanV2` (see `scene3d-v2.ts`) — a consumer holding one must narrow
+ * with `isScene3DPlanV1` / `isScene3DPlanV2` before reading version-specific
+ * fields. Nothing about v1's shape, bounds or messages changed when v2 landed.
+ */
+interface Scene3DPlanV1 {
     planType: typeof SCENE3D_PLAN_TYPE;
     schemaVersion: typeof SCENE3D_SCHEMA_VERSION;
     /** UUID. Changes on EVERY accepted edit. */
@@ -12125,10 +12150,14 @@ declare const scene3DReferenceSchema: z.ZodObject<{
     startSeconds: z.ZodOptional<z.ZodNumber>;
     endSeconds: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
-interface SemanticIssue {
+/** One cross-field failure, in the shape `ctx.addIssue` wants. Shared by the
+ *  v1 and v2 validators so both report the same way. */
+interface Scene3DSemanticIssue {
     path: (string | number)[];
     message: string;
 }
+/** @internal Historic in-file name. */
+type SemanticIssue = Scene3DSemanticIssue;
 /**
  * Every rule that needs more than one field: duration, identity, hierarchy,
  * reference resolution and keyframe tracks.
@@ -12137,12 +12166,174 @@ interface SemanticIssue {
  * report the SAME sentences without re-parsing, and so a caller holding an
  * already-parsed plan can re-check it cheaply.
  */
-declare function scene3DPlanIssues(plan: Scene3DPlan): SemanticIssue[];
+declare function scene3DPlanV1Issues(plan: Scene3DPlanV1): SemanticIssue[];
 /**
  * THE plan validator. Structure first (zod), then the cross-field rules — a
  * consumer that parses with this cannot be handed a cycle, a dangling parent,
  * an out-of-range keyframe or a 90-second "one-minute-max" scene.
  */
+/**
+ * The v1 object shape WITHOUT the cross-field pass. Exported only so
+ * `scene3DAnyPlanSchema` can discriminate on `schemaVersion` (zod cannot
+ * discriminate through a `superRefine`); parse with `scene3DPlanV1Schema`.
+ */
+declare const scene3DPlanV1ObjectSchema: z.ZodObject<{
+    planType: z.ZodLiteral<"3d-scene">;
+    schemaVersion: z.ZodLiteral<1>;
+    revisionId: z.ZodUUID;
+    parentRevisionId: z.ZodOptional<z.ZodUUID>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    durationInFrames: z.ZodNumber;
+    backgroundColor: z.ZodString;
+    camera: z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        focalLengthMm: z.ZodNumber;
+        sensorWidthMm: z.ZodDefault<z.ZodNumber>;
+        keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            frame: z.ZodNumber;
+            position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            target: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            focalLengthMm: z.ZodOptional<z.ZodNumber>;
+            easing: z.ZodOptional<z.ZodEnum<{
+                linear: "linear";
+                easeInOut: "easeInOut";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    objects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        primitive: z.ZodEnum<{
+            group: "group";
+            box: "box";
+            sphere: "sphere";
+            cylinder: "cylinder";
+            cone: "cone";
+            plane: "plane";
+            capsule: "capsule";
+        }>;
+        parentId: z.ZodOptional<z.ZodString>;
+        dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        rotation: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        scale: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        color: z.ZodString;
+        keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            frame: z.ZodNumber;
+            position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            easing: z.ZodOptional<z.ZodEnum<{
+                linear: "linear";
+                easeInOut: "easeInOut";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    lighting: z.ZodObject<{
+        ambientIntensity: z.ZodNumber;
+        keyIntensity: z.ZodNumber;
+        keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        kind: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        role: z.ZodEnum<{
+            motion: "motion";
+            layout: "layout";
+            appearance: "appearance";
+        }>;
+        objectId: z.ZodOptional<z.ZodString>;
+        startSeconds: z.ZodOptional<z.ZodNumber>;
+        endSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+declare const scene3DPlanV1Schema: z.ZodObject<{
+    planType: z.ZodLiteral<"3d-scene">;
+    schemaVersion: z.ZodLiteral<1>;
+    revisionId: z.ZodUUID;
+    parentRevisionId: z.ZodOptional<z.ZodUUID>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    durationInFrames: z.ZodNumber;
+    backgroundColor: z.ZodString;
+    camera: z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        focalLengthMm: z.ZodNumber;
+        sensorWidthMm: z.ZodDefault<z.ZodNumber>;
+        keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            frame: z.ZodNumber;
+            position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            target: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            focalLengthMm: z.ZodOptional<z.ZodNumber>;
+            easing: z.ZodOptional<z.ZodEnum<{
+                linear: "linear";
+                easeInOut: "easeInOut";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    objects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        primitive: z.ZodEnum<{
+            group: "group";
+            box: "box";
+            sphere: "sphere";
+            cylinder: "cylinder";
+            cone: "cone";
+            plane: "plane";
+            capsule: "capsule";
+        }>;
+        parentId: z.ZodOptional<z.ZodString>;
+        dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        rotation: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        scale: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        color: z.ZodString;
+        keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            frame: z.ZodNumber;
+            position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            easing: z.ZodOptional<z.ZodEnum<{
+                linear: "linear";
+                easeInOut: "easeInOut";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    lighting: z.ZodObject<{
+        ambientIntensity: z.ZodNumber;
+        keyIntensity: z.ZodNumber;
+        keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        kind: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        role: z.ZodEnum<{
+            motion: "motion";
+            layout: "layout";
+            appearance: "appearance";
+        }>;
+        objectId: z.ZodOptional<z.ZodString>;
+        startSeconds: z.ZodOptional<z.ZodNumber>;
+        endSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/** @deprecated v1-only, and it always was. Kept so every existing v1 call site
+ *  keeps EXACTLY its current accept/reject set. Use `scene3DPlanV1Schema` for
+ *  v1, or `scene3DAnyPlanSchema` when either version is acceptable. */
 declare const scene3DPlanSchema: z.ZodObject<{
     planType: z.ZodLiteral<"3d-scene">;
     schemaVersion: z.ZodLiteral<1>;
@@ -12220,18 +12411,21 @@ declare const scene3DPlanSchema: z.ZodObject<{
         endSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
+/** @deprecated Renamed to `scene3DPlanV1Issues`. */
+declare const scene3DPlanIssues: typeof scene3DPlanV1Issues;
 /** Order-insensitive deep equality over the JSON subset a plan is made of. */
 declare function scene3DDeepEqual(a: unknown, b: unknown): boolean;
 /** RFC-4122 v4 id, from the platform CSPRNG where there is one. Browser,
  *  Node 18+ and the Remotion renderer all expose `globalThis.crypto`. */
 declare function newScene3DRevisionId(): string;
-/** Narrowing helper for callers holding `unknown` (job output, workflow JSON). */
-declare function isScene3DPlan(value: unknown): value is Scene3DPlan;
+/** Narrowing helper for callers holding `unknown` (job output, workflow JSON).
+ *  V1 ONLY — `isScene3DPlan` (in `scene3d-v2.ts`) accepts either version. */
+declare function isScene3DPlanV1(value: unknown): value is Scene3DPlanV1;
 /** What a finished `generate-3d-scene` / `edit-3d-scene` job carries in
  *  `output_data`. The canvas, the SDK and the DAG output extractor all read
  *  THIS shape — `scenePlan` is also the node's stored plan field. */
 interface Scene3DJobOutput {
-    scenePlan: Scene3DPlan;
+    scenePlan: Scene3DPlanV1;
     /** One paragraph naming what changed. Absent on a first generation. */
     changeSummary?: string;
 }
@@ -12523,7 +12717,7 @@ interface Scene3DEditOptions {
 }
 type Scene3DEditResult = {
     ok: true;
-    plan: Scene3DPlan;
+    plan: Scene3DPlanV1;
     changedObjectIds: string[];
     changeSummary: string;
 } | {
@@ -12557,69 +12751,2723 @@ declare function summarizeScene3DOperations(operations: readonly Scene3DEditOper
  *    plan validator rejects it, as does removing an object a reference points
  *    at.
  */
-declare function applyScene3DEditOperations(plan: Scene3DPlan, operations: readonly Scene3DEditOperation[] | unknown, options?: Scene3DEditOptions): Scene3DEditResult;
-
-/**
- * The parts of `settings.studio` that must not leave the owner's account.
- *
- * A shared production is read by anyone with the link. Three things inside the
- * document are the OWNER'S working state and nobody else's business:
- *
- * - `trash` — the recycle bin, which holds every shot, still and clip they
- *   deleted, with prompts and urls intact. A share viewer receiving the bin is
- *   the sharpest of the three: it hands out work the owner explicitly threw away.
- * - the in-flight job markers — `pendingClips` / `pendingStills` per shot, and
- *   `pendingMusic` / `pendingDraft` on the document. A viewer cannot land any
- *   of them and does not own them; all they carry across is job ids.
- * - `freecutDraftUrl` — an unsaved editor draft.
- *
- * They do NOT all live at the same level, and that is the whole reason this
- * file exists rather than one array: the writer puts `trash` and
- * `freecutDraftUrl` on `settings.studio` itself, and puts the per-shot markers
- * on the `settings.studio.shots[]` entry. A strip that walked only the top
- * level would pass its own test and still hand a share viewer every marker in
- * the production.
- *
- * It lives in `@nodaro/shared` because two independent readers need the SAME
- * list: the public share read (which is the reason the list exists) and the
- * production writer's own bundle projection. A second copy of a list like this
- * does not stay equal — it goes one key stale and the stale side is the one
- * that publishes.
- *
- * This is a plain JSON walker on purpose. `settings` is a free-form column that
- * a client owns end to end; the projection reads the keys it must drop and
- * nothing else, so it never needs — and must never grow — a dependency on
- * whatever writes the rest of the document.
- */
-/**
- * `settings.studio`'s OWN transient keys.
- *
- * The per-shot pending lists are on this list as well as the shot one on
- * purpose: nothing writes them here today, and a stray one from an older
- * client — or from a client that is not the studio editor at all — still must
- * not ride out to a viewer.
- */
-declare const STUDIO_TRANSIENT_KEYS: readonly ["trash", "pendingStills", "pendingClips", "pendingMusic", "pendingDraft", "freecutDraftUrl"];
-/**
- * ...and a SHOT entry's, which is where the per-shot markers actually are.
- *
- * `pendingClip` (singular) is the pre-concurrent-markers shape; the editor's
- * reader still migrates it on parse, so a row can still be carrying one and it
- * is still in-flight state.
- */
-declare const STUDIO_SHOT_TRANSIENT_KEYS: readonly ["pendingClips", "pendingClip", "pendingStills"];
-/**
- * A production's `settings` with the owner's working state removed.
- *
- * Copy-on-write, and structurally: it rebuilds the objects without those keys
- * rather than deleting from the caller's, so the stored row is untouched. A
- * `settings` with no `studio` comes back unchanged — this is a studio concern,
- * and a workflow that is not a production has nothing here to strip.
- *
- * Takes and returns `unknown` because the column is free-form and every caller
- * already holds it as whatever its own layer calls JSON; narrowing here would
- * only move the cast one line up.
- */
-declare function stripStudioTransientSettings(settings: unknown): unknown;
+declare function applyScene3DEditOperations(plan: Scene3DPlanV1, operations: readonly Scene3DEditOperation[] | unknown, options?: Scene3DEditOptions): Scene3DEditResult;
+
+/**
+ * Scene3D v2 — the PUBLIC wire contract for exported (GLB-backed) scenes.
+ *
+ * One Scene3D family, two schema versions. `Scene3DPlan` is the discriminated
+ * union `Scene3DPlanV1 | Scene3DPlanV2`, keyed on `schemaVersion`; v1 (see
+ * `scene3d.ts`) is untouched — same fields, same bounds, same messages — and a
+ * default v1 authoring request must never come back as v2.
+ *
+ * What v2 adds over v1's inline primitives:
+ *
+ * - **Assets.** Geometry lives in GLB files referenced by opaque id + SHA-256
+ *   digest, never by an expiring URL. The camera lives in a sidecar
+ *   (`scene3d-camera-track.ts`), one sample per frame, so a 720-frame baked
+ *   move is not squeezed through v1's 240-keyframe budget.
+ * - **Semantic entities.** A user-selectable object or assembly — a person, a
+ *   car, a prop, an environment — not every mesh in the export. Entities carry
+ *   stable ids, anchors, identity colour and material-role bindings, so
+ *   recolouring a person cannot recolour its chair.
+ * - **Shots.** Explicit contiguous integer ranges covering the whole timeline,
+ *   with hard cuts. Interpolation never spans a cut.
+ * - **Overlays.** Deterministic entity/camera overrides applied over immutable
+ *   baked bytes, in a fixed order, so a rebuild cannot silently drop a manual
+ *   edit.
+ * - **Provenance.** Which engine/compiler/exporter/renderer produced this, and
+ *   the canonical content hash of the revision.
+ *
+ * This file is STRUCTURE ONLY: shapes, bounds, cross-references. How a scene is
+ * authored, how a camera move is solved and what any of it costs are not part
+ * of the published contract and are not here.
+ *
+ * It owns the VOCABULARY — constants, types and per-component schemas. The
+ * whole-plan schema and every cross-field rule live in `scene3d-v2-plan.ts`,
+ * which builds on this; the dense camera sidecar lives in
+ * `scene3d-camera-track.ts`. Consumers import all three from the package root.
+ *
+ * ## World conventions (identical to v1, and now stated on the wire)
+ *
+ * Meters, Y up, right-handed, zero-based frames. `units`/`upAxis`/`handedness`
+ * are required literals so a reader can refuse a manifest that assumes anything
+ * else instead of quietly rendering a Z-up scene on its side. Conversion from
+ * the authoring package's basis happens exactly once, at export: a GLB that is
+ * already Y-up must not be rotated again, and the renderer must not replace an
+ * exported camera quaternion with a `lookAt()`.
+ */
+
+/** The v2 discriminator value. v1's `SCENE3D_SCHEMA_VERSION` is unchanged. */
+declare const SCENE3D_SCHEMA_VERSION_V2 = 2;
+/** Every version this package can parse AND validate. An SDK consumer checks a
+ *  plan against this BEFORE trying to render one it cannot understand. */
+declare const SCENE3D_SUPPORTED_SCHEMA_VERSIONS: readonly [1, 2];
+type Scene3DSupportedSchemaVersion = (typeof SCENE3D_SUPPORTED_SCHEMA_VERSIONS)[number];
+/** Authoring engines a v2 manifest may name. Open-ended on the wire (the field
+ *  is a bounded slug) so a new engine does not need a package release; this
+ *  list is what the current platform ships. */
+declare const SCENE3D_V2_ENGINES: readonly ["blender-cloud", "blender-local"];
+type Scene3DKnownEngine = (typeof SCENE3D_V2_ENGINES)[number];
+/**
+ * Admission bounds for v2. Server-configured ceilings are returned in
+ * capabilities; these are the contract's hard maxima, quoted by the route Zod,
+ * the builder, the renderer and the docs so they cannot drift apart.
+ *
+ * v1's `SCENE3D_LIMITS` is NOT changed by any of this — "raise maxObjects" was
+ * never the v2 design.
+ */
+declare const SCENE3D_V2_LIMITS: {
+    /** Both the seconds and the frame ceiling apply; neither waives the other. */
+    readonly maxDurationSeconds: 60;
+    readonly minDurationInFrames: 1;
+    readonly maxDurationInFrames: 3600;
+    readonly minFps: 15;
+    readonly maxFps: 60;
+    readonly defaultFps: 24;
+    /** Even integers only — an odd axis breaks H.264 chroma subsampling. */
+    readonly minDimensionPx: 100;
+    readonly maxDimensionPx: 1920;
+    readonly minEntities: 1;
+    /** SEMANTIC entities, not exported mesh nodes. */
+    readonly maxEntities: 100;
+    /** Enforced during asset normalization, after decode — see
+     *  `scene3DV2NormalizationIssues` in `scene3d-v2-resources.ts`. */
+    readonly maxMeshNodes: 2000;
+    readonly maxTriangles: 200000;
+    readonly maxHierarchyDepth: 16;
+    /** Decoded manifest JSON. Measured on the bytes, before `JSON.parse`. */
+    readonly maxManifestBytes: number;
+    /** Decoded camera-track JSON. */
+    readonly maxCameraTrackBytes: number;
+    /** Total DECLARED bytes of the assets the renderer downloads. Compression
+     *  does not waive the decoded geometry limits above. */
+    readonly maxRendererAssetBytes: number;
+    /** A `blend-source` is a separately authorized download, never handed to the
+     *  browser renderer, and therefore not part of the renderer budget. */
+    readonly maxBlendSourceBytes: number;
+    readonly maxAssets: 64;
+    readonly maxShots: 32;
+    readonly maxShotEntityIds: 16;
+    /** v1's reference limit, unchanged until deliberately expanded. */
+    readonly maxReferences: 8;
+    readonly maxAnchorsPerEntity: 32;
+    readonly maxMaterialBindingsPerEntity: 16;
+    readonly maxOverrides: 200;
+    readonly minPosterDimensionPx: 16;
+    readonly maxPosterDimensionPx: 4096;
+    readonly maxIdLength: 64;
+    readonly maxAssetIdLength: 128;
+    readonly maxNodeIdLength: 128;
+    readonly maxNameLength: 120;
+    readonly maxLabelLength: 120;
+    readonly maxMaterialNameLength: 120;
+    readonly maxVersionLength: 64;
+    readonly maxCoordinate: 1000;
+    readonly minSize: 0.001;
+    readonly maxSize: 1000;
+    readonly maxIntensity: 100;
+};
+/** The overlay operation vocabulary this package understands. An override
+ *  written by a NEWER writer is rejected with an explicit message rather than
+ *  silently skipped — a dropped edit is worse than a refused manifest. */
+declare const SCENE3D_V2_OVERRIDE_OPERATION_VERSION = 1;
+/**
+ * The GLB `extras` keys the exporter writes and the importer reads. Blender
+ * display names and array indices are NOT durable identifiers: a re-export
+ * renames `Cube.003` and reorders children, and a hit-test would then select a
+ * different entity. Both ends import these constants — never the literals.
+ */
+declare const SCENE3D_GLB_EXTRAS_ENTITY_ID = "nodaroEntityId";
+declare const SCENE3D_GLB_EXTRAS_SUBPART_ID = "nodaroSubpartId";
+declare const SCENE3D_GLB_EXTRAS_MATERIAL_ROLE = "nodaroMaterialRole";
+/** Nothing outside this set is read from `extras`; an importer ignores the rest
+ *  rather than trusting arbitrary exporter metadata. */
+declare const SCENE3D_GLB_EXTRAS_ALLOWLIST: readonly ["nodaroEntityId", "nodaroSubpartId", "nodaroMaterialRole"];
+/** What an entity IS, for selection, grouping and validation reporting. It is
+ *  advisory: no rule anywhere requires a head on a car or a wheel on a person. */
+type Scene3DEntityRole = "person" | "vehicle" | "prop" | "environment" | "other";
+declare const SCENE3D_ENTITY_ROLES: readonly Scene3DEntityRole[];
+/** The v1 primitive vocabulary MINUS `group` — grouping is `visual.kind:"group"`
+ *  in v2, so there is exactly one way to say "no geometry". */
+type Scene3DV2Primitive = Exclude<Scene3DPrimitive, "group">;
+declare const SCENE3D_V2_PRIMITIVES: readonly Scene3DV2Primitive[];
+/** Deterministic overlays an entity accepts. Geometry and pose are deliberately
+ *  absent: those rebuild through the authoring engine, they are not overlays. */
+type Scene3DEntityCapability = "transform" | "color" | "visibility";
+declare const SCENE3D_ENTITY_CAPABILITIES: readonly Scene3DEntityCapability[];
+/** What an entity accepts when it does not say. */
+declare const SCENE3D_DEFAULT_ENTITY_CAPABILITIES: readonly Scene3DEntityCapability[];
+type Scene3DAssetKind = "glb" | "camera-track-json" | "poster" | "validation-report" | "blend-source";
+declare const SCENE3D_ASSET_KINDS: readonly Scene3DAssetKind[];
+type Scene3DAssetRole = "scene-geometry" | "entity-geometry" | "camera-track" | "poster" | "validation-report" | "source";
+declare const SCENE3D_ASSET_ROLES: readonly Scene3DAssetRole[];
+/** Which kinds may carry which role. A role is not decoration — it is what lets
+ *  a resolver decide whether bytes go to the renderer, the UI or an authorized
+ *  download, without sniffing the file. */
+declare const SCENE3D_ASSET_ROLE_KINDS: Readonly<Record<Scene3DAssetRole, Scene3DAssetKind>>;
+/** The kinds the BROWSER downloads. `blend-source` is never in this set: it is
+ *  a separately authorized download and it does not spend the renderer budget. */
+declare const SCENE3D_RENDERER_ASSET_KINDS: readonly Scene3DAssetKind[];
+/** The one material role a `primitive` entity has: its own `color`. */
+declare const SCENE3D_PRIMITIVE_MATERIAL_ROLE = "identity";
+/** The standardized clay look, pinned by id. Browser preview, critic stills and
+ *  the final export must implement a given preset identically. */
+declare const SCENE3D_CLAY_LIGHTING_PRESETS: readonly ["clay-studio-v1"];
+type Scene3DClayLightingPreset = (typeof SCENE3D_CLAY_LIGHTING_PRESETS)[number];
+/** A stable contact/selection location in entity-local space. Names are free
+ *  structural labels (`face`, `seat`, `wheel.frontLeft`, `roof`, `lookAt`) —
+ *  human anatomy is never required. */
+interface Scene3DAnchor {
+    name: string;
+    position: Vec3;
+    /** Euler XYZ radians. Absent = identity orientation. */
+    rotation?: Vec3;
+}
+/** Binds an editable colour ROLE to a real material inside the entity's own
+ *  asset root. Recolouring `bodyPaint` on a car must not touch its tires, and
+ *  cannot reach a material that belongs to a different entity. */
+interface Scene3DMaterialBinding {
+    role: string;
+    materialName: string;
+    /** Baked colour for the role, sRGB opaque hex. */
+    color?: string;
+    roughness?: number;
+}
+/** Maps a clip inside the referenced GLB onto public frames. Sampling is
+ *  `time = (frame - startFrame) / fps` — never a wall-clock mixer delta, or
+ *  scrubbing backwards would not reproduce the rendered frame. */
+interface Scene3DAssetAnimation {
+    clipName: string;
+    startFrame: number;
+    endFrameExclusive: number;
+    /** Absent/false = hold the last sample after the window. */
+    loop?: boolean;
+}
+type Scene3DEntityVisual = 
+/** Organizational identity: a transform and a name, no geometry of its own. */
+{
+    kind: "group";
+}
+/** The v1 primitive vocabulary and validated dimensions. */
+ | {
+    kind: "primitive";
+    primitive: Scene3DV2Primitive;
+    dimensions: Vec3;
+    color: string;
+}
+/** An authorized GLB plus the exported node that roots this entity. */
+ | {
+    kind: "asset";
+    assetId: string;
+    rootNodeId: string;
+    animation?: Scene3DAssetAnimation;
+};
+interface Scene3DEntityV2 {
+    id: string;
+    name: string;
+    /** Transform parent, another entity. Cycles are rejected. */
+    parentId?: string;
+    role?: Scene3DEntityRole;
+    /**
+     * Local base transform. REQUIRED for `group` and `primitive`.
+     *
+     * OPTIONAL for `asset`, where the GLB node's own transform is authoritative:
+     * a value here is an informational frame-0 snapshot and the renderer must NOT
+     * apply it on top of the node transform. Applying both is the
+     * double-transform bug that puts a car at twice its offset.
+     */
+    position?: Vec3;
+    rotation?: Vec3;
+    scale?: Vec3;
+    /** The selection/identity chip colour. Opaque hex, sRGB. */
+    identityColor?: string;
+    anchors?: Scene3DAnchor[];
+    /** Deterministic overlays this entity accepts. Absent = all of them. */
+    capabilities?: Scene3DEntityCapability[];
+    /** Currently frozen subset. An overlay is accepted iff its capability is
+     *  advertised AND not locked. */
+    locks?: Scene3DEntityCapability[];
+    /** `asset` entities only. */
+    materialBindings?: Scene3DMaterialBinding[];
+    visual: Scene3DEntityVisual;
+}
+/** A reference to immutable bytes. IDs and digests are persisted; short-lived
+ *  transport URLs are issued by the authenticated resolver and never stored. */
+interface Scene3DAssetRef {
+    assetId: string;
+    kind: Scene3DAssetKind;
+    role: Scene3DAssetRole;
+    byteLength: number;
+    /** Lowercase hex SHA-256 of the bytes. */
+    sha256: string;
+    /** Set when this revision reuses an earlier revision's immutable bytes. */
+    originRevisionId?: string;
+}
+/** A contiguous half-open frame range `[startFrame, endFrameExclusive)`. */
+interface Scene3DShot {
+    id: string;
+    startFrame: number;
+    endFrameExclusive: number;
+    label?: string;
+    /** Who the shot is ABOUT — used by validation reporting and the UI. */
+    subjectEntityIds?: string[];
+    /** Who is deliberately in front of the lens (an over-the-shoulder anchor). */
+    foregroundEntityIds?: string[];
+}
+interface Scene3DClayLighting {
+    preset: Scene3DClayLightingPreset;
+    ambientIntensity: number;
+    keyIntensity: number;
+    keyPosition: Vec3;
+}
+/** Which space a constant transform override is expressed in. Declared, so the
+ *  renderer never multiplies the same parent transform in twice. */
+type Scene3DOverrideSpace = "local" | "world";
+interface Scene3DOverrideProvenance {
+    id: string;
+    /** The revision this override was authored against. */
+    sourceRevisionId: string;
+    /** That revision's canonical content hash when the override was authored. */
+    sourceContentHash: string;
+    operationVersion: number;
+}
+type Scene3DOverride = Scene3DOverrideProvenance & ({
+    kind: "entity-transform";
+    entityId: string;
+    space: Scene3DOverrideSpace;
+    position?: Vec3;
+    rotation?: Vec3;
+    scale?: Vec3;
+} | {
+    kind: "entity-color";
+    entityId: string;
+    materialRole: string;
+    color: string;
+} | {
+    kind: "entity-visibility";
+    entityId: string;
+    visible: boolean;
+} | {
+    kind: "camera-shot-offset";
+    shotId: string;
+    positionOffset?: Vec3;
+    targetOffset?: Vec3;
+});
+/**
+ * Who built this revision and from what. Source versioning and renderer
+ * versioning are independent — a renderer upgrade does not invalidate a scene.
+ *
+ * Every string here is a bounded slug, which is a structural guarantee that no
+ * native path or block of prose fits in one. Scrubbing credentials
+ * out of the values it does accept remains the producer's duty.
+ */
+interface Scene3DProvenance {
+    engine: string;
+    engineVersion: string;
+    recipeVersion: string;
+    compilerVersion: string;
+    exporterVersion: string;
+    rendererVersion: string;
+    sourceRevisionId?: string;
+    /** The retained `blend-source` asset, when one was kept. */
+    sourceArtifactId?: string;
+    /** Canonical content hash of this revision — see `scene3d-v2-resources.ts`. */
+    contentHash: string;
+}
+interface Scene3DPlanV2 {
+    planType: typeof SCENE3D_PLAN_TYPE;
+    schemaVersion: typeof SCENE3D_SCHEMA_VERSION_V2;
+    revisionId: string;
+    parentRevisionId?: string;
+    width: number;
+    height: number;
+    fps: number;
+    durationInFrames: number;
+    units: "meters";
+    upAxis: "Y";
+    handedness: "right";
+    objects: Scene3DEntityV2[];
+    assets: Scene3DAssetRef[];
+    cameraTrackAssetId: string;
+    shots: Scene3DShot[];
+    lighting: Scene3DClayLighting;
+    backgroundColor: string;
+    references?: Scene3DReference[];
+    overrides?: Scene3DOverride[];
+    provenance: Scene3DProvenance;
+}
+/** Opaque storage id. Deliberately slash-free: an asset id is an ID, resolved
+ *  server-side against ownership — never a path and never a URL. */
+declare const scene3DAssetIdSchema: z.ZodString;
+/** A node name inside an exported GLB. */
+declare const scene3DNodeIdSchema: z.ZodString;
+declare const scene3DSha256Schema: z.ZodString;
+/**
+ * A version/engine token. The charset excludes `/`, `\`, `:` and whitespace, so
+ * a native filesystem path cannot be spelled as one; the 64-character cap
+ * excludes prose.
+ */
+declare const scene3DVersionTokenSchema: z.ZodString;
+declare const scene3DEngineIdSchema: z.ZodString;
+/** Anchor names and material roles share the id charset (dots allowed, so
+ *  `wheel.frontLeft` is one name and not a path). */
+declare const scene3DAnchorNameSchema: z.ZodString;
+declare const scene3DMaterialRoleSchema: z.ZodString;
+declare const scene3DMaterialNameSchema: z.ZodString;
+declare const scene3DEntityCapabilitySchema: z.ZodEnum<{
+    transform: "transform";
+    color: "color";
+    visibility: "visibility";
+}>;
+declare const scene3DAnchorSchema: z.ZodObject<{
+    name: z.ZodString;
+    position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+}, z.core.$strict>;
+declare const scene3DMaterialBindingSchema: z.ZodObject<{
+    role: z.ZodString;
+    materialName: z.ZodString;
+    color: z.ZodOptional<z.ZodString>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+declare const scene3DAssetAnimationSchema: z.ZodObject<{
+    clipName: z.ZodString;
+    startFrame: z.ZodNumber;
+    endFrameExclusive: z.ZodNumber;
+    loop: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const scene3DEntityVisualSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"group">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"primitive">;
+    primitive: z.ZodEnum<{
+        box: "box";
+        sphere: "sphere";
+        cylinder: "cylinder";
+        cone: "cone";
+        plane: "plane";
+        capsule: "capsule";
+    }>;
+    dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    color: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"asset">;
+    assetId: z.ZodString;
+    rootNodeId: z.ZodString;
+    animation: z.ZodOptional<z.ZodObject<{
+        clipName: z.ZodString;
+        startFrame: z.ZodNumber;
+        endFrameExclusive: z.ZodNumber;
+        loop: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "kind">;
+declare const scene3DEntityV2Schema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    parentId: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodEnum<{
+        other: "other";
+        person: "person";
+        vehicle: "vehicle";
+        prop: "prop";
+        environment: "environment";
+    }>>;
+    position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    identityColor: z.ZodOptional<z.ZodString>;
+    anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strict>>>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        transform: "transform";
+        color: "color";
+        visibility: "visibility";
+    }>>>;
+    locks: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        transform: "transform";
+        color: "color";
+        visibility: "visibility";
+    }>>>;
+    materialBindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        materialName: z.ZodString;
+        color: z.ZodOptional<z.ZodString>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    visual: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"group">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"primitive">;
+        primitive: z.ZodEnum<{
+            box: "box";
+            sphere: "sphere";
+            cylinder: "cylinder";
+            cone: "cone";
+            plane: "plane";
+            capsule: "capsule";
+        }>;
+        dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        color: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"asset">;
+        assetId: z.ZodString;
+        rootNodeId: z.ZodString;
+        animation: z.ZodOptional<z.ZodObject<{
+            clipName: z.ZodString;
+            startFrame: z.ZodNumber;
+            endFrameExclusive: z.ZodNumber;
+            loop: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+declare const scene3DAssetRefSchema: z.ZodObject<{
+    assetId: z.ZodString;
+    kind: z.ZodEnum<{
+        glb: "glb";
+        "camera-track-json": "camera-track-json";
+        poster: "poster";
+        "validation-report": "validation-report";
+        "blend-source": "blend-source";
+    }>;
+    role: z.ZodEnum<{
+        source: "source";
+        poster: "poster";
+        "validation-report": "validation-report";
+        "scene-geometry": "scene-geometry";
+        "entity-geometry": "entity-geometry";
+        "camera-track": "camera-track";
+    }>;
+    byteLength: z.ZodNumber;
+    sha256: z.ZodString;
+    originRevisionId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strict>;
+declare const scene3DShotSchema: z.ZodObject<{
+    id: z.ZodString;
+    startFrame: z.ZodNumber;
+    endFrameExclusive: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+    subjectEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    foregroundEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+declare const scene3DClayLightingSchema: z.ZodObject<{
+    preset: z.ZodEnum<{
+        "clay-studio-v1": "clay-studio-v1";
+    }>;
+    ambientIntensity: z.ZodNumber;
+    keyIntensity: z.ZodNumber;
+    keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+}, z.core.$strict>;
+declare const scene3DOverrideSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"entity-transform">;
+    entityId: z.ZodString;
+    space: z.ZodEnum<{
+        local: "local";
+        world: "world";
+    }>;
+    position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    id: z.ZodString;
+    sourceRevisionId: z.ZodUUID;
+    sourceContentHash: z.ZodString;
+    operationVersion: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"entity-color">;
+    entityId: z.ZodString;
+    materialRole: z.ZodString;
+    color: z.ZodString;
+    id: z.ZodString;
+    sourceRevisionId: z.ZodUUID;
+    sourceContentHash: z.ZodString;
+    operationVersion: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"entity-visibility">;
+    entityId: z.ZodString;
+    visible: z.ZodBoolean;
+    id: z.ZodString;
+    sourceRevisionId: z.ZodUUID;
+    sourceContentHash: z.ZodString;
+    operationVersion: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"camera-shot-offset">;
+    shotId: z.ZodString;
+    positionOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    targetOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    id: z.ZodString;
+    sourceRevisionId: z.ZodUUID;
+    sourceContentHash: z.ZodString;
+    operationVersion: z.ZodNumber;
+}, z.core.$strict>], "kind">;
+declare const scene3DProvenanceSchema: z.ZodObject<{
+    engine: z.ZodString;
+    engineVersion: z.ZodString;
+    recipeVersion: z.ZodString;
+    compilerVersion: z.ZodString;
+    exporterVersion: z.ZodString;
+    rendererVersion: z.ZodString;
+    sourceRevisionId: z.ZodOptional<z.ZodUUID>;
+    sourceArtifactId: z.ZodOptional<z.ZodString>;
+    contentHash: z.ZodString;
+}, z.core.$strict>;
+type Issue$3 = Scene3DSemanticIssue;
+/** Decoded byte length of a JSON payload, browser and Node alike. Size is
+ *  checked on the BYTES, before `JSON.parse` allocates anything. */
+declare function scene3DJsonByteLength(text: string): number;
+/** What every `parse…Json` admission helper returns: the value, or the issues
+ *  that stopped it — never a throw, so a route can map issues to a 400. */
+type Scene3DParseResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    issues: Issue$3[];
+};
+/** Flattens a zod failure into the same issue shape the semantic validators use. */
+declare function scene3DZodIssues(error: z.ZodError): Issue$3[];
+
+/**
+ * The Scene3D v2 PLAN: whole-manifest schema, every cross-field rule, and the
+ * V1|V2 union the rest of the platform reads.
+ *
+ * `scene3d-v2.ts` says what a v2 entity, asset, shot or override looks like on
+ * its own. Nothing there can catch the failures that actually reach a renderer,
+ * because every one of them is a relationship:
+ *
+ * - an entity whose GLB is not in `assets`, or two entities claiming the same
+ *   exported root node;
+ * - a parent chain that loops, or nests deeper than the transform walk allows;
+ * - shots with a one-frame gap, so some frame belongs to no shot at all;
+ * - a colour override naming a material role its entity never declared — the
+ *   bug where recolouring a person also repaints its chair;
+ * - two overrides driving one channel, or one driving a locked entity;
+ * - declared asset bytes over the download budget.
+ *
+ * All of it runs in `scene3DPlanV2Issues`, which the schema calls from a
+ * `superRefine` and a caller holding an already-parsed plan can call directly —
+ * the same split v1 uses, so both versions report failures identically.
+ */
+
+/** THE plan type. Narrow with `isScene3DPlanV1` / `isScene3DPlanV2` before
+ *  reading version-specific fields. */
+type Scene3DPlan = Scene3DPlanV1 | Scene3DPlanV2;
+interface Scene3DJobOutputV2 {
+    scenePlan: Scene3DPlanV2;
+    changeSummary?: string;
+}
+/** Job output when either version may come back. */
+interface Scene3DJobOutputAny {
+    scenePlan: Scene3DPlan;
+    changeSummary?: string;
+}
+type Issue$2 = Scene3DSemanticIssue;
+/** An overlay is accepted iff the entity advertises the capability AND has not
+ *  frozen it. One rule, checked in exactly one place. */
+declare function scene3DEntityAcceptsOverlay(entity: Scene3DEntityV2, capability: Scene3DEntityCapability): boolean;
+/**
+ * Every v2 rule that needs more than one field: timing, identity, hierarchy,
+ * asset resolution and budgets, shot coverage, overlay ownership and locks.
+ *
+ * Split out of the schema's `superRefine` (exactly as v1 does) so a caller
+ * holding an already-parsed plan can re-check it without re-parsing.
+ */
+declare function scene3DPlanV2Issues(plan: Scene3DPlanV2): Issue$2[];
+/**
+ * The v2 object shape WITHOUT the cross-field pass. Exported so
+ * `scene3DAnyPlanSchema` can discriminate on `schemaVersion`; parse with
+ * `scene3DPlanV2Schema`.
+ *
+ * Deliberately free of `.default()`: `parse(x)` must deep-equal `x`, or a
+ * producer hashing raw JSON and a consumer hashing parsed output would compute
+ * different content hashes for the same revision.
+ */
+declare const scene3DPlanV2ObjectSchema: z.ZodObject<{
+    planType: z.ZodLiteral<"3d-scene">;
+    schemaVersion: z.ZodLiteral<2>;
+    revisionId: z.ZodUUID;
+    parentRevisionId: z.ZodOptional<z.ZodUUID>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    durationInFrames: z.ZodNumber;
+    units: z.ZodLiteral<"meters">;
+    upAxis: z.ZodLiteral<"Y">;
+    handedness: z.ZodLiteral<"right">;
+    objects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        parentId: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodEnum<{
+            other: "other";
+            person: "person";
+            vehicle: "vehicle";
+            prop: "prop";
+            environment: "environment";
+        }>>;
+        position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        identityColor: z.ZodOptional<z.ZodString>;
+        anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        }, z.core.$strict>>>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            transform: "transform";
+            color: "color";
+            visibility: "visibility";
+        }>>>;
+        locks: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            transform: "transform";
+            color: "color";
+            visibility: "visibility";
+        }>>>;
+        materialBindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            role: z.ZodString;
+            materialName: z.ZodString;
+            color: z.ZodOptional<z.ZodString>;
+            roughness: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+        visual: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"group">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"primitive">;
+            primitive: z.ZodEnum<{
+                box: "box";
+                sphere: "sphere";
+                cylinder: "cylinder";
+                cone: "cone";
+                plane: "plane";
+                capsule: "capsule";
+            }>;
+            dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            color: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"asset">;
+            assetId: z.ZodString;
+            rootNodeId: z.ZodString;
+            animation: z.ZodOptional<z.ZodObject<{
+                clipName: z.ZodString;
+                startFrame: z.ZodNumber;
+                endFrameExclusive: z.ZodNumber;
+                loop: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>>;
+    assets: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        kind: z.ZodEnum<{
+            glb: "glb";
+            "camera-track-json": "camera-track-json";
+            poster: "poster";
+            "validation-report": "validation-report";
+            "blend-source": "blend-source";
+        }>;
+        role: z.ZodEnum<{
+            source: "source";
+            poster: "poster";
+            "validation-report": "validation-report";
+            "scene-geometry": "scene-geometry";
+            "entity-geometry": "entity-geometry";
+            "camera-track": "camera-track";
+        }>;
+        byteLength: z.ZodNumber;
+        sha256: z.ZodString;
+        originRevisionId: z.ZodOptional<z.ZodUUID>;
+    }, z.core.$strict>>;
+    cameraTrackAssetId: z.ZodString;
+    shots: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        startFrame: z.ZodNumber;
+        endFrameExclusive: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+        subjectEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        foregroundEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    lighting: z.ZodObject<{
+        preset: z.ZodEnum<{
+            "clay-studio-v1": "clay-studio-v1";
+        }>;
+        ambientIntensity: z.ZodNumber;
+        keyIntensity: z.ZodNumber;
+        keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>;
+    backgroundColor: z.ZodString;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        kind: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        role: z.ZodEnum<{
+            motion: "motion";
+            layout: "layout";
+            appearance: "appearance";
+        }>;
+        objectId: z.ZodOptional<z.ZodString>;
+        startSeconds: z.ZodOptional<z.ZodNumber>;
+        endSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    overrides: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"entity-transform">;
+        entityId: z.ZodString;
+        space: z.ZodEnum<{
+            local: "local";
+            world: "world";
+        }>;
+        position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"entity-color">;
+        entityId: z.ZodString;
+        materialRole: z.ZodString;
+        color: z.ZodString;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"entity-visibility">;
+        entityId: z.ZodString;
+        visible: z.ZodBoolean;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"camera-shot-offset">;
+        shotId: z.ZodString;
+        positionOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        targetOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>], "kind">>>;
+    provenance: z.ZodObject<{
+        engine: z.ZodString;
+        engineVersion: z.ZodString;
+        recipeVersion: z.ZodString;
+        compilerVersion: z.ZodString;
+        exporterVersion: z.ZodString;
+        rendererVersion: z.ZodString;
+        sourceRevisionId: z.ZodOptional<z.ZodUUID>;
+        sourceArtifactId: z.ZodOptional<z.ZodString>;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** THE v2 plan validator: structure first, then the cross-field rules. */
+declare const scene3DPlanV2Schema: z.ZodObject<{
+    planType: z.ZodLiteral<"3d-scene">;
+    schemaVersion: z.ZodLiteral<2>;
+    revisionId: z.ZodUUID;
+    parentRevisionId: z.ZodOptional<z.ZodUUID>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    durationInFrames: z.ZodNumber;
+    units: z.ZodLiteral<"meters">;
+    upAxis: z.ZodLiteral<"Y">;
+    handedness: z.ZodLiteral<"right">;
+    objects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        parentId: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodEnum<{
+            other: "other";
+            person: "person";
+            vehicle: "vehicle";
+            prop: "prop";
+            environment: "environment";
+        }>>;
+        position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        identityColor: z.ZodOptional<z.ZodString>;
+        anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        }, z.core.$strict>>>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            transform: "transform";
+            color: "color";
+            visibility: "visibility";
+        }>>>;
+        locks: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            transform: "transform";
+            color: "color";
+            visibility: "visibility";
+        }>>>;
+        materialBindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            role: z.ZodString;
+            materialName: z.ZodString;
+            color: z.ZodOptional<z.ZodString>;
+            roughness: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+        visual: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"group">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"primitive">;
+            primitive: z.ZodEnum<{
+                box: "box";
+                sphere: "sphere";
+                cylinder: "cylinder";
+                cone: "cone";
+                plane: "plane";
+                capsule: "capsule";
+            }>;
+            dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            color: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"asset">;
+            assetId: z.ZodString;
+            rootNodeId: z.ZodString;
+            animation: z.ZodOptional<z.ZodObject<{
+                clipName: z.ZodString;
+                startFrame: z.ZodNumber;
+                endFrameExclusive: z.ZodNumber;
+                loop: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>>;
+    assets: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        kind: z.ZodEnum<{
+            glb: "glb";
+            "camera-track-json": "camera-track-json";
+            poster: "poster";
+            "validation-report": "validation-report";
+            "blend-source": "blend-source";
+        }>;
+        role: z.ZodEnum<{
+            source: "source";
+            poster: "poster";
+            "validation-report": "validation-report";
+            "scene-geometry": "scene-geometry";
+            "entity-geometry": "entity-geometry";
+            "camera-track": "camera-track";
+        }>;
+        byteLength: z.ZodNumber;
+        sha256: z.ZodString;
+        originRevisionId: z.ZodOptional<z.ZodUUID>;
+    }, z.core.$strict>>;
+    cameraTrackAssetId: z.ZodString;
+    shots: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        startFrame: z.ZodNumber;
+        endFrameExclusive: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+        subjectEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        foregroundEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    lighting: z.ZodObject<{
+        preset: z.ZodEnum<{
+            "clay-studio-v1": "clay-studio-v1";
+        }>;
+        ambientIntensity: z.ZodNumber;
+        keyIntensity: z.ZodNumber;
+        keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>;
+    backgroundColor: z.ZodString;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        kind: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        role: z.ZodEnum<{
+            motion: "motion";
+            layout: "layout";
+            appearance: "appearance";
+        }>;
+        objectId: z.ZodOptional<z.ZodString>;
+        startSeconds: z.ZodOptional<z.ZodNumber>;
+        endSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    overrides: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"entity-transform">;
+        entityId: z.ZodString;
+        space: z.ZodEnum<{
+            local: "local";
+            world: "world";
+        }>;
+        position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"entity-color">;
+        entityId: z.ZodString;
+        materialRole: z.ZodString;
+        color: z.ZodString;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"entity-visibility">;
+        entityId: z.ZodString;
+        visible: z.ZodBoolean;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"camera-shot-offset">;
+        shotId: z.ZodString;
+        positionOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        targetOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>], "kind">>>;
+    provenance: z.ZodObject<{
+        engine: z.ZodString;
+        engineVersion: z.ZodString;
+        recipeVersion: z.ZodString;
+        compilerVersion: z.ZodString;
+        exporterVersion: z.ZodString;
+        rendererVersion: z.ZodString;
+        sourceRevisionId: z.ZodOptional<z.ZodUUID>;
+        sourceArtifactId: z.ZodOptional<z.ZodString>;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/**
+ * Either version, discriminated on `schemaVersion` — so an unknown version
+ * reports "Invalid discriminator value. Expected '1' | '2'" instead of a pile
+ * of unknown-key errors from whichever branch failed last.
+ */
+declare const scene3DAnyPlanSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    planType: z.ZodLiteral<"3d-scene">;
+    schemaVersion: z.ZodLiteral<1>;
+    revisionId: z.ZodUUID;
+    parentRevisionId: z.ZodOptional<z.ZodUUID>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    durationInFrames: z.ZodNumber;
+    backgroundColor: z.ZodString;
+    camera: z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        focalLengthMm: z.ZodNumber;
+        sensorWidthMm: z.ZodDefault<z.ZodNumber>;
+        keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            frame: z.ZodNumber;
+            position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            target: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            focalLengthMm: z.ZodOptional<z.ZodNumber>;
+            easing: z.ZodOptional<z.ZodEnum<{
+                linear: "linear";
+                easeInOut: "easeInOut";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    objects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        primitive: z.ZodEnum<{
+            group: "group";
+            box: "box";
+            sphere: "sphere";
+            cylinder: "cylinder";
+            cone: "cone";
+            plane: "plane";
+            capsule: "capsule";
+        }>;
+        parentId: z.ZodOptional<z.ZodString>;
+        dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        rotation: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        scale: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        color: z.ZodString;
+        keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            frame: z.ZodNumber;
+            position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            easing: z.ZodOptional<z.ZodEnum<{
+                linear: "linear";
+                easeInOut: "easeInOut";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    lighting: z.ZodObject<{
+        ambientIntensity: z.ZodNumber;
+        keyIntensity: z.ZodNumber;
+        keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        kind: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        role: z.ZodEnum<{
+            motion: "motion";
+            layout: "layout";
+            appearance: "appearance";
+        }>;
+        objectId: z.ZodOptional<z.ZodString>;
+        startSeconds: z.ZodOptional<z.ZodNumber>;
+        endSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>, z.ZodObject<{
+    planType: z.ZodLiteral<"3d-scene">;
+    schemaVersion: z.ZodLiteral<2>;
+    revisionId: z.ZodUUID;
+    parentRevisionId: z.ZodOptional<z.ZodUUID>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    durationInFrames: z.ZodNumber;
+    units: z.ZodLiteral<"meters">;
+    upAxis: z.ZodLiteral<"Y">;
+    handedness: z.ZodLiteral<"right">;
+    objects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        parentId: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodEnum<{
+            other: "other";
+            person: "person";
+            vehicle: "vehicle";
+            prop: "prop";
+            environment: "environment";
+        }>>;
+        position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        identityColor: z.ZodOptional<z.ZodString>;
+        anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        }, z.core.$strict>>>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            transform: "transform";
+            color: "color";
+            visibility: "visibility";
+        }>>>;
+        locks: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            transform: "transform";
+            color: "color";
+            visibility: "visibility";
+        }>>>;
+        materialBindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            role: z.ZodString;
+            materialName: z.ZodString;
+            color: z.ZodOptional<z.ZodString>;
+            roughness: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+        visual: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"group">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"primitive">;
+            primitive: z.ZodEnum<{
+                box: "box";
+                sphere: "sphere";
+                cylinder: "cylinder";
+                cone: "cone";
+                plane: "plane";
+                capsule: "capsule";
+            }>;
+            dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            color: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"asset">;
+            assetId: z.ZodString;
+            rootNodeId: z.ZodString;
+            animation: z.ZodOptional<z.ZodObject<{
+                clipName: z.ZodString;
+                startFrame: z.ZodNumber;
+                endFrameExclusive: z.ZodNumber;
+                loop: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>>;
+    assets: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        kind: z.ZodEnum<{
+            glb: "glb";
+            "camera-track-json": "camera-track-json";
+            poster: "poster";
+            "validation-report": "validation-report";
+            "blend-source": "blend-source";
+        }>;
+        role: z.ZodEnum<{
+            source: "source";
+            poster: "poster";
+            "validation-report": "validation-report";
+            "scene-geometry": "scene-geometry";
+            "entity-geometry": "entity-geometry";
+            "camera-track": "camera-track";
+        }>;
+        byteLength: z.ZodNumber;
+        sha256: z.ZodString;
+        originRevisionId: z.ZodOptional<z.ZodUUID>;
+    }, z.core.$strict>>;
+    cameraTrackAssetId: z.ZodString;
+    shots: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        startFrame: z.ZodNumber;
+        endFrameExclusive: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+        subjectEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        foregroundEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    lighting: z.ZodObject<{
+        preset: z.ZodEnum<{
+            "clay-studio-v1": "clay-studio-v1";
+        }>;
+        ambientIntensity: z.ZodNumber;
+        keyIntensity: z.ZodNumber;
+        keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>;
+    backgroundColor: z.ZodString;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        kind: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        role: z.ZodEnum<{
+            motion: "motion";
+            layout: "layout";
+            appearance: "appearance";
+        }>;
+        objectId: z.ZodOptional<z.ZodString>;
+        startSeconds: z.ZodOptional<z.ZodNumber>;
+        endSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    overrides: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"entity-transform">;
+        entityId: z.ZodString;
+        space: z.ZodEnum<{
+            local: "local";
+            world: "world";
+        }>;
+        position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"entity-color">;
+        entityId: z.ZodString;
+        materialRole: z.ZodString;
+        color: z.ZodString;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"entity-visibility">;
+        entityId: z.ZodString;
+        visible: z.ZodBoolean;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"camera-shot-offset">;
+        shotId: z.ZodString;
+        positionOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        targetOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        id: z.ZodString;
+        sourceRevisionId: z.ZodUUID;
+        sourceContentHash: z.ZodString;
+        operationVersion: z.ZodNumber;
+    }, z.core.$strict>], "kind">>>;
+    provenance: z.ZodObject<{
+        engine: z.ZodString;
+        engineVersion: z.ZodString;
+        recipeVersion: z.ZodString;
+        compilerVersion: z.ZodString;
+        exporterVersion: z.ZodString;
+        rendererVersion: z.ZodString;
+        sourceRevisionId: z.ZodOptional<z.ZodUUID>;
+        sourceArtifactId: z.ZodOptional<z.ZodString>;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>], "schemaVersion">;
+/** Zod for a client's `acceptedSceneSchemaVersions`. */
+declare const scene3DAcceptedSchemaVersionsSchema: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+declare function isScene3DPlanV2(value: unknown): value is Scene3DPlanV2;
+/** Accepts EITHER version. `isScene3DPlanV1` (in `scene3d.ts`) is the v1-only
+ *  form; narrow with one of them before reading version-specific fields. */
+declare function isScene3DPlan(value: unknown): value is Scene3DPlan;
+/**
+ * The schema version a value CLAIMS, without validating the rest of it.
+ *
+ * Returns the number even when this package cannot handle it, so an SDK
+ * consumer can say "this scene is v3, upgrade to render it" instead of "invalid
+ * plan". `null` means it is not a Scene3D plan at all.
+ */
+declare function scene3DPlanSchemaVersion(value: unknown): number | null;
+declare function isScene3DSchemaVersionSupported(version: number): version is Scene3DSupportedSchemaVersion;
+declare function isKnownScene3DEngine(engine: string): engine is Scene3DKnownEngine;
+/**
+ * The shot owning `frame`, or `-1`. Ranges are half-open and contiguous, so
+ * this is total over `[0, durationInFrames)` on a validated plan — and it is
+ * the ONLY place a renderer decides which side of a cut a frame is on.
+ */
+declare function scene3DShotIndexForFrame(shots: readonly Scene3DShot[], frame: number): number;
+declare function scene3DShotForFrame(shots: readonly Scene3DShot[], frame: number): Scene3DShot | undefined;
+
+/**
+ * Scene3D v2 resource admission and revision identity.
+ *
+ * Two gates and one hash, all of which have to agree across the builder, the
+ * platform route and the renderer — so they live in one published place instead
+ * of being re-derived three times.
+ *
+ * **Pre-allocation gate** (`scene3DV2AdmissionIssues`). Everything checkable
+ * from the manifest alone, BEFORE a byte is fetched or a decoder is handed
+ * anything: declared asset sizes, counts, timeline length, hierarchy depth, and
+ * the decoded size of the manifest itself. A limit enforced after the download
+ * is not a limit.
+ *
+ * **Post-decode gate** (`scene3DV2NormalizationIssues`). What only the actual
+ * bytes can answer: real length versus declared, digest versus declared,
+ * triangles, mesh nodes, node depth, image dimensions. A 2 MiB GLB can decode
+ * to a hundred million triangles, so compression never waives a geometry
+ * budget.
+ *
+ * **Content hash.** The canonical form of a revision, which is what makes
+ * "these two revisions are the same scene" a decidable question — for
+ * content-addressed caching, and for asserting after a rebuild that the entities
+ * the user locked really did come back unchanged.
+ */
+
+type Issue$1 = Scene3DSemanticIssue;
+interface Scene3DV2ResourceUsage {
+    entities: number;
+    assets: number;
+    shots: number;
+    overrides: number;
+    references: number;
+    frames: number;
+    durationSeconds: number;
+    /** Deepest entity parent chain, 1 for a flat scene. */
+    hierarchyDepth: number;
+    /** Declared bytes of everything the browser downloads. */
+    rendererAssetBytes: number;
+    /** Declared bytes of the camera sidecar. */
+    cameraTrackBytes: number;
+    /** Declared bytes of the retained native source, which the browser never sees. */
+    blendSourceBytes: number;
+}
+/** Deepest parent chain, counting the entity itself. Bounded by the entity
+ *  count even on a cyclic plan, so it is safe to call before validation. */
+declare function scene3DV2HierarchyDepth(entities: readonly Scene3DEntityV2[]): number;
+/** What this manifest CLAIMS it will cost. Also the shape a capabilities or
+ *  quote surface displays — it is derived, never authored. */
+declare function scene3DV2ResourceUsage(plan: Scene3DPlanV2): Scene3DV2ResourceUsage;
+/**
+ * The pre-allocation gate. `manifestBytes` is the DECODED size of the manifest
+ * as it arrived — pass it when admitting a downloaded manifest, omit it when
+ * the plan is already in memory.
+ *
+ * Most of these are also enforced by `scene3DPlanV2Schema`; this function is
+ * what a caller runs when it wants the budget answer without re-parsing, and
+ * what makes the ceilings quotable in one place by capabilities and docs.
+ */
+declare function scene3DV2AdmissionIssues(plan: Scene3DPlanV2, manifestBytes?: number): Issue$1[];
+/**
+ * What the normalizer measured on the ACTUAL bytes of one asset. Optional
+ * fields are "not applicable to this kind" — a poster has image dimensions and
+ * no triangles; a GLB is the other way round.
+ */
+interface Scene3DNormalizedAssetStats {
+    assetId: string;
+    kind: Scene3DAssetKind;
+    /** Decoded length, after any transport compression. */
+    byteLength: number;
+    /** Digest of the decoded bytes, lowercase hex, when computed. */
+    sha256?: string;
+    meshNodes?: number;
+    triangles?: number;
+    /** Deepest node chain inside the asset's own scene graph. */
+    maxNodeDepth?: number;
+    imageWidth?: number;
+    imageHeight?: number;
+}
+/**
+ * The post-decode gate: does what arrived match what the manifest promised, and
+ * does the resolved geometry fit the budget?
+ *
+ * Mesh nodes and triangles are summed ACROSS assets — the ceiling is on the
+ * scene the renderer assembles, not on any single file.
+ */
+declare function scene3DV2NormalizationIssues(plan: Scene3DPlanV2, stats: readonly Scene3DNormalizedAssetStats[]): Issue$1[];
+/** Size-gate on the bytes, then parse, then the full v2 schema. Refuses an
+ *  oversized manifest before `JSON.parse` allocates it. */
+declare function parseScene3DPlanV2Json(text: string): Scene3DParseResult<Scene3DPlanV2>;
+/**
+ * Fields excluded from the canonical form.
+ *
+ * `revisionId`/`parentRevisionId` are IDENTITY, not content: two revisions with
+ * the same scene must hash the same, or a content-addressed cache never hits
+ * and "did the rebuild preserve the locked entities?" cannot be answered by
+ * comparing hashes. `provenance.contentHash` is excluded because a value cannot
+ * contain its own hash.
+ *
+ * Everything else is in — entities, anchors, material bindings, overrides, asset
+ * digests, shots, lighting, provenance versions.
+ */
+declare const SCENE3D_V2_CONTENT_HASH_EXCLUDED: readonly ["revisionId", "parentRevisionId"];
+/**
+ * The exact bytes a revision's content hash is computed over: recursively
+ * key-sorted JSON with the identity fields removed. Key order in the input
+ * cannot change the result, so a manifest that survives a round-trip through a
+ * database or a re-serialization still hashes the same.
+ */
+declare function canonicalScene3DPlanV2Json(plan: Scene3DPlanV2): string;
+/**
+ * SHA-256 of the canonical form, lowercase hex — the value that belongs in
+ * `provenance.contentHash`. Uses WebCrypto, which the browser, Node 18+ and the
+ * Remotion renderer all expose, so producer and consumer compute it the same
+ * way.
+ */
+declare function computeScene3DPlanV2ContentHash(plan: Scene3DPlanV2): Promise<string>;
+/** Does the manifest's declared `provenance.contentHash` match its content? */
+declare function verifyScene3DPlanV2ContentHash(plan: Scene3DPlanV2): Promise<boolean>;
+
+/**
+ * The Scene3D v2 camera sidecar — one baked sample per frame.
+ *
+ * A 30-second scene is 720 camera samples. V1's 240-keyframe interpolated track
+ * cannot carry that, and interpolating a sparse track across a hard cut blends
+ * two shots into a frame that belongs to neither. So v2 moves the camera out of
+ * the manifest into this dense JSON asset, and the rule becomes trivial:
+ *
+ *   **at integer frame `f`, use `samples[f]`.**
+ *
+ * No interpolation, no easing, no "nearest key". Pausing, scrubbing backwards
+ * and rendering frames out of order therefore produce identical state, which is
+ * the whole reason preview and export can be trusted to agree.
+ *
+ * Two things this format refuses to guess at:
+ *
+ * - **Orientation is a quaternion, not a look-at.** A renderer that replaces the
+ *   exported quaternion with `lookAt(target)` throws away the authored roll and
+ *   the handheld component. `target` is carried for inspection and intent only.
+ * - **Projection is a matrix, not a lens number.** A focal length cannot express
+ *   sensor fit or lens shift, and re-deriving a projection at a different aspect
+ *   silently reframes every shot. `focalLengthMm` is metadata; the 16-element
+ *   column-major matrix is authoritative.
+ *
+ * Changing fps or aspect ratio is an explicit resample/reprojection producing a
+ * NEW revision — never a render-time override. `scene3DCameraTrackPlanIssues`
+ * is what makes that non-negotiable.
+ */
+
+declare const SCENE3D_CAMERA_TRACK_FORMAT = "scene3d-camera-track";
+declare const SCENE3D_CAMERA_TRACK_VERSION = 1;
+declare const SCENE3D_CAMERA_TRACK_LIMITS: {
+    readonly maxJsonBytes: number;
+    readonly maxFrameCount: 3600;
+    readonly minFps: 15;
+    readonly maxFps: 60;
+    /** A unit quaternion off by more than this is a bug, not float noise. */
+    readonly quaternionTolerance: 0.0001;
+    /** Absolute tolerance on the projection entries that must be exactly zero
+     *  (or exactly ∓1) in a perspective matrix. */
+    readonly projectionEpsilon: 0.000001;
+    /** Relative tolerance when comparing declared near/far against the values the
+     *  projection matrix implies. */
+    readonly nearFarRelativeTolerance: 0.001;
+    /** Relative tolerance on `m[0]/m[5]` vs the manifest's `height/width`. */
+    readonly aspectRelativeTolerance: 0.001;
+    readonly minNear: 0.0001;
+    readonly maxFar: 10000000;
+};
+interface Scene3DCameraSample {
+    position: Vec3;
+    /** `[x, y, z, w]` — that order, normalized. */
+    quaternion: [number, number, number, number];
+    /** Exactly 16 entries, COLUMN-MAJOR (Three.js `Matrix4.elements` order). */
+    projectionMatrix: number[];
+    near: number;
+    far: number;
+    /** Authoring intent, for inspection and validation reporting. A renderer must
+     *  never feed this back through `lookAt()`. */
+    target?: Vec3;
+    /** Metadata only; the projection matrix wins. */
+    focalLengthMm?: number;
+}
+interface Scene3DCameraTrackV1 {
+    format: typeof SCENE3D_CAMERA_TRACK_FORMAT;
+    version: typeof SCENE3D_CAMERA_TRACK_VERSION;
+    /** Always 0: public frames are zero-based, and the exporter has already
+     *  subtracted the authoring package's start frame. */
+    frameStart: 0;
+    frameCount: number;
+    fps: number;
+    samples: Scene3DCameraSample[];
+}
+declare const scene3DCameraSampleSchema: z.ZodObject<{
+    position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    quaternion: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    projectionMatrix: z.ZodArray<z.ZodNumber>;
+    near: z.ZodNumber;
+    far: z.ZodNumber;
+    target: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    focalLengthMm: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/** Structure only; `scene3DCameraTrackIssues` carries the numeric rules. */
+declare const scene3DCameraTrackObjectSchema: z.ZodObject<{
+    format: z.ZodLiteral<"scene3d-camera-track">;
+    version: z.ZodLiteral<1>;
+    frameStart: z.ZodLiteral<0>;
+    frameCount: z.ZodNumber;
+    fps: z.ZodNumber;
+    samples: z.ZodArray<z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        quaternion: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        projectionMatrix: z.ZodArray<z.ZodNumber>;
+        near: z.ZodNumber;
+        far: z.ZodNumber;
+        target: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        focalLengthMm: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type Issue = Scene3DSemanticIssue;
+/**
+ * Is this a real PERSPECTIVE projection, and does it agree with the declared
+ * near/far?
+ *
+ * Column-major layout produced by every Three.js/glTF perspective camera:
+ *
+ * ```text
+ *   m0   0   m8   0
+ *    0  m5   m9   0
+ *    0   0  m10  m14
+ *    0   0   -1   0
+ * ```
+ *
+ * `m8`/`m9` carry lens shift and are free. Everything else is pinned. Inverting
+ * the two depth terms recovers `near = m14 / (m10 - 1)` and
+ * `far = m14 / (m10 + 1)`, which is how a matrix that quietly disagrees with its
+ * own declared clip planes gets caught.
+ *
+ * Exported because the builder validates its export with the same function the
+ * renderer admits it with.
+ */
+declare function scene3DProjectionIssues(matrix: readonly number[], near: number, far: number, path: (string | number)[]): Issue[];
+/**
+ * The numeric rules the schema cannot express: exact sample count, normalized
+ * quaternions, and a real perspective projection on every frame.
+ *
+ * Split out of the schema (as v1 does) so a caller holding a parsed track can
+ * re-check it, and so the per-sample walk stays one readable loop over up to
+ * 3,600 samples.
+ */
+declare function scene3DCameraTrackIssues(track: Scene3DCameraTrackV1): Issue[];
+/** THE camera-track validator: structure, then the numeric rules. */
+declare const scene3DCameraTrackSchema: z.ZodObject<{
+    format: z.ZodLiteral<"scene3d-camera-track">;
+    version: z.ZodLiteral<1>;
+    frameStart: z.ZodLiteral<0>;
+    frameCount: z.ZodNumber;
+    fps: z.ZodNumber;
+    samples: z.ZodArray<z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        quaternion: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        projectionMatrix: z.ZodArray<z.ZodNumber>;
+        near: z.ZodNumber;
+        far: z.ZodNumber;
+        target: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        focalLengthMm: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare function isScene3DCameraTrack(value: unknown): value is Scene3DCameraTrackV1;
+/**
+ * Track ↔ manifest agreement. A track that is valid on its own can still be the
+ * WRONG track for this scene: a different fps, a different length, or a
+ * projection baked for another aspect ratio. Each of those silently reframes or
+ * retimes every shot, so each is an error here rather than a render-time
+ * surprise.
+ */
+declare function scene3DCameraTrackPlanIssues(track: Scene3DCameraTrackV1, plan: Pick<Scene3DPlanV2, "fps" | "durationInFrames" | "width" | "height">): Issue[];
+/**
+ * The sample for an integer frame. `undefined` outside `[0, frameCount)` — a
+ * caller must fail rather than clamp, because a clamped frame is a wrong frame
+ * that looks plausible.
+ */
+declare function scene3DSampleForFrame(track: Scene3DCameraTrackV1, frame: number): Scene3DCameraSample | undefined;
+/**
+ * Size-gate, then parse, then validate. This is the admission path for a
+ * downloaded camera track: an 80 MiB "8 MiB" track is refused before
+ * `JSON.parse` gets a chance to allocate it.
+ */
+declare function parseScene3DCameraTrackJson(text: string): Scene3DParseResult<Scene3DCameraTrackV1>;
+
+/**
+ * The `pro-3d-render` ("3D Render Pro") WIRE CONTRACT.
+ *
+ * ONE durable operation, three ways in. A `source` says WHERE the scene comes
+ * from — a new brief, an existing revision, or a completed desktop export —
+ * and the settled job carries BOTH halves of the result: the exact composition
+ * (`scenePlan`) and the standard video field every downstream consumer already
+ * reads (`videoUrl`).
+ *
+ * The `source` is a strict discriminated union rather than a bag of optional
+ * fields, and that is the load-bearing decision here. "Prompt present" and
+ * "revisionId present" are not two settings on one request: they select
+ * different pipelines with different costs. A flat shape lets a caller send
+ * both, or neither, and pushes the "what did they actually mean" decision into
+ * whichever surface reads it last — which is how an existing scene silently
+ * becomes a paid re-authoring run.
+ *
+ * The same union is what makes RENDER-ONLY expressible: `{kind:'scene'}` with
+ * NO `editPrompt` means "export this revision", and its absence must survive
+ * every hop unchanged. Nothing may helpfully substitute an empty string or
+ * copy the node's brief into it — that converts a free export into an
+ * authoring run the user never asked for.
+ *
+ * What lives here is only what a client needs to CALL the operation, QUOTE it
+ * and READ its result. How the scene is planned, compiled, built, priced or
+ * authorized is not part of this contract and is not described here.
+ *
+ * Deliberately NOT here:
+ *  - a model chooser. The planner is fixed and server-owned.
+ *  - a credit number. The cost is resolved server-side and returned by the
+ *    quote endpoint; a constant in a published package would be a wrong answer
+ *    shipped to every consumer (see `PRO3D_RENDER_CREDIT_ID`).
+ */
+
+/** Canvas/API/MCP node type. */
+declare const PRO3D_RENDER_NODE_TYPE = "pro-3d-render";
+/** Display name. One string, so every surface spells it the same way. */
+declare const PRO3D_RENDER_LABEL = "3D Render Pro";
+/**
+ * The credit identifier the operation settles under.
+ *
+ * An IDENTIFIER, not a price: the number is operator/deployment configuration
+ * (a `model_pricing` row), and the per-run ceiling comes from a quote. There is
+ * deliberately no fallback constant — a flat default would underprice an
+ * operation that plans, builds and renders, and "cheap by accident" is not a
+ * failure mode you notice from the outside.
+ */
+declare const PRO3D_RENDER_CREDIT_ID = "pro-3d-render";
+/**
+ * Where the scene is built. `blender-local` is a paired desktop and is refused
+ * unless the deployment both enables it and has an engine advertising it — an
+ * unknown or unavailable engine is an error, never a downgrade to the cheaper
+ * cloud path.
+ */
+declare const PRO3D_RENDER_ENGINES: readonly ["blender-cloud", "blender-local"];
+type Pro3DRenderEngine = (typeof PRO3D_RENDER_ENGINES)[number];
+declare const PRO3D_RENDER_DEFAULT_ENGINE: Pro3DRenderEngine;
+/**
+ * Render quality profiles.
+ *
+ * One today. A surface must advertise only what the installed engine reports
+ * (`capabilities().pro.qualityProfiles`) rather than this list — offering a
+ * profile the engine cannot serve is a run that fails after the user chose it.
+ */
+declare const PRO3D_RENDER_QUALITY_PROFILES: readonly ["standard"];
+type Pro3DRenderQuality = (typeof PRO3D_RENDER_QUALITY_PROFILES)[number];
+declare const PRO3D_RENDER_DEFAULT_QUALITY: Pro3DRenderQuality;
+/** Material/lighting treatment. Clay is the movement-reference default. */
+declare const PRO3D_RENDER_STYLES: readonly ["clay"];
+type Pro3DRenderStyle = (typeof PRO3D_RENDER_STYLES)[number];
+declare const PRO3D_RENDER_DEFAULT_STYLE: Pro3DRenderStyle;
+/**
+ * The correction budget: how many repair passes the engine may spend after its
+ * first attempt. Displayed to the user because each pass is paid work.
+ */
+declare const PRO3D_RENDER_MIN_REPAIR_PASSES = 0;
+declare const PRO3D_RENDER_MAX_REPAIR_PASSES = 2;
+declare const PRO3D_RENDER_DEFAULT_REPAIR_PASSES = 2;
+/**
+ * Aspect ratios the node authors at.
+ *
+ * `21:9` is not decoration: the acceptance fixture is a 30-second 21:9 scene,
+ * so a set that omitted it could not express the case the feature is measured
+ * against. Its canonical pixel pair is the contract's explicitly supported
+ * 1680×720 (see `ASPECT_RATIO_DIMENSIONS`).
+ */
+declare const PRO3D_RENDER_ASPECT_RATIOS: readonly ["16:9", "9:16", "1:1", "4:5", "21:9"];
+type Pro3DRenderAspectRatio = (typeof PRO3D_RENDER_ASPECT_RATIOS)[number];
+/** Same prompt ceiling the Basic authoring routes enforce. */
+declare const PRO3D_RENDER_PROMPT_MAX = 8000;
+/**
+ * Request bounds shared by every ingress (HTTP route, orchestrator, MCP, SDK).
+ *
+ * Timing/reference limits reuse the Basic authoring limits verbatim rather
+ * than declaring a second set: the two nodes describe the same kind of scene,
+ * and two drifting ceilings is how one surface starts accepting what another
+ * refuses.
+ */
+declare const PRO3D_RENDER_LIMITS: {
+    readonly promptMax: 8000;
+    readonly editPromptMax: 8000;
+    readonly minDurationSeconds: 1;
+    readonly maxDurationSeconds: 60;
+    readonly minFps: 15;
+    readonly maxFps: 60;
+    readonly maxReferences: 8;
+    /** Opaque ids the caller echoes back (quote, export, connection). */
+    readonly maxIdLength: 200;
+    /** `Idempotency-Key` bounds — the platform's floor, with a ceiling so an
+     *  unbounded header can never reach a lookup or a database column. */
+    readonly minIdempotencyKeyLength: 8;
+    readonly maxIdempotencyKeyLength: 255;
+};
+declare const PRO3D_RENDER_SOURCE_KINDS: readonly ["prompt", "scene", "local-export"];
+type Pro3DRenderSourceKind = (typeof PRO3D_RENDER_SOURCE_KINDS)[number];
+/** A new scene, authored from a brief plus optional image/video references. */
+interface Pro3DRenderPromptSource {
+    kind: "prompt";
+    prompt: string;
+    references?: readonly Scene3DReference[];
+}
+/**
+ * An existing immutable revision.
+ *
+ * `editPrompt` ABSENT is the render-only path — export this revision, spend no
+ * authoring or build credits. Its absence is meaningful and must be preserved
+ * verbatim; an empty string is not the same request.
+ *
+ * Retained revisions are authorized through their current scene permissions.
+ * `sourceJobId` locates Basic scenes stored only in job history; it is required
+ * for that source, but optional for retained scenes (including manual edits).
+ */
+interface Pro3DRenderSceneSource {
+    kind: "scene";
+    revisionId: string;
+    sourceJobId?: string;
+    editPrompt?: string;
+}
+/** A completed export from a paired desktop Blender. */
+interface Pro3DRenderLocalExportSource {
+    kind: "local-export";
+    exportId: string;
+    connectionId: string;
+}
+type Pro3DRenderSource = Pro3DRenderPromptSource | Pro3DRenderSceneSource | Pro3DRenderLocalExportSource;
+/** True when this source exports an existing revision without re-authoring it. */
+declare function isPro3DRenderRenderOnly(source: Pro3DRenderSource): boolean;
+/**
+ * Which scene-schema version a source PRODUCES, or `null` when only the server
+ * can know.
+ *
+ * A `prompt` or `local-export` source always mints a fresh v2 manifest, so a
+ * client that cannot read v2 is refusable for free, before any work. A `scene`
+ * source inherits whatever version the named revision already is — the host
+ * does not resolve revisions, so demanding v2 there would refuse a perfectly
+ * renderable retained v1 scene.
+ */
+declare function pro3DRenderProducedSchemaVersion(source: Pro3DRenderSource): number | null;
+/** One priced component of a quote. Display copy, not economics. */
+interface Pro3DRenderQuoteLine {
+    code: string;
+    label: string;
+    credits: number;
+}
+/**
+ * The paired quote's answer.
+ *
+ * `maxCredits` is a CEILING, not a charge: quoting reserves nothing and spends
+ * nothing. `normalizedInputHash` is what run admission re-checks, so a body
+ * edited between quote and run is refused rather than executed at a price it
+ * was never quoted for.
+ */
+interface Pro3DRenderQuote {
+    quoteId: string;
+    /** ISO-8601. After this the quote is stale and run answers "quote again". */
+    expiresAt: string;
+    maxCredits: number;
+    breakdown: Pro3DRenderQuoteLine[];
+    pricingVersion: string;
+    capabilitiesVersion: string;
+    normalizedInputHash: string;
+}
+declare const pro3DRenderQuoteSchema: z.ZodObject<{
+    quoteId: z.ZodString;
+    expiresAt: z.ZodString;
+    maxCredits: z.ZodNumber;
+    breakdown: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        credits: z.ZodNumber;
+    }, z.core.$loose>>;
+    pricingVersion: z.ZodString;
+    capabilitiesVersion: z.ZodString;
+    normalizedInputHash: z.ZodString;
+}, z.core.$loose>;
+declare function isPro3DRenderQuote(value: unknown): value is Pro3DRenderQuote;
+/**
+ * What this deployment can actually serve.
+ *
+ * Every surface that offers a control reads it from here rather than from the
+ * vocabularies above: the constants say what the CONTRACT can express, this
+ * says what the INSTALLED engine will accept.
+ */
+interface Pro3DRenderCapabilities {
+    available: boolean;
+    engines: Pro3DRenderEngine[];
+    qualityProfiles: Pro3DRenderQuality[];
+    styles: Pro3DRenderStyle[];
+    aspectRatios: Pro3DRenderAspectRatio[];
+    maxRepairPasses: number;
+}
+interface Pro3DRenderValidationWarning {
+    code: string;
+    message: string;
+    shotId?: string;
+}
+interface Pro3DRenderResultMetadata {
+    width: number;
+    height: number;
+    fps: number;
+    frames: number;
+    duration: number;
+}
+/**
+ * The completed job's `output_data`.
+ *
+ * `videoUrl` is the platform's existing resolved-video field (the contract's
+ * `resultUrl` mapped onto the envelope this platform already has), so the node
+ * connects to every existing video consumer without a second video result type
+ * producer validators cannot parse. `scenePlan` + `sceneRevisionId` are the
+ * exact revision that video was rendered from, so a later render-only re-run
+ * costs no authoring.
+ *
+ * Everything else is what the spec requires a caller to be able to act on: the
+ * poster to show before playback, the validation report to read warnings from,
+ * the renderer/metadata to check the export against a downstream model's
+ * limits, and the optional source artifact to offer as a download.
+ */
+interface Pro3DRenderJobOutput {
+    videoUrl: string;
+    scenePlan: Scene3DPlan;
+    sceneRevisionId: string;
+    posterAssetId: string;
+    /** Present when an editable native source was retained for this revision. */
+    sourceArtifactId?: string;
+    validation: {
+        status: "passed";
+        reportAssetId: string;
+        warnings: Pro3DRenderValidationWarning[];
+    };
+    renderer: string;
+    metadata: Pro3DRenderResultMetadata;
+    /** Short, user-safe note about what this revision contains. Never diagnostics. */
+    changeSummary?: string;
+}
+/**
+ * Reader-side schema.
+ *
+ * Passthrough on purpose: a job row may carry additive metadata a client of
+ * this version has never heard of, and refusing the whole result over an
+ * unknown key would turn an additive server change into a client outage.
+ *
+ * The required fields are required because the contract makes them so — this
+ * is what a COMPLETE result looks like. Nothing in the platform fabricates
+ * them to satisfy the schema; a runtime that has not produced them yet simply
+ * does not parse as complete, which is the honest answer.
+ */
+declare const pro3DRenderJobOutputSchema: z.ZodObject<{
+    videoUrl: z.ZodString;
+    scenePlan: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        planType: z.ZodLiteral<"3d-scene">;
+        schemaVersion: z.ZodLiteral<1>;
+        revisionId: z.ZodUUID;
+        parentRevisionId: z.ZodOptional<z.ZodUUID>;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fps: z.ZodNumber;
+        durationInFrames: z.ZodNumber;
+        backgroundColor: z.ZodString;
+        camera: z.ZodObject<{
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            focalLengthMm: z.ZodNumber;
+            sensorWidthMm: z.ZodDefault<z.ZodNumber>;
+            keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                frame: z.ZodNumber;
+                position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                target: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                focalLengthMm: z.ZodOptional<z.ZodNumber>;
+                easing: z.ZodOptional<z.ZodEnum<{
+                    linear: "linear";
+                    easeInOut: "easeInOut";
+                }>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+        objects: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            primitive: z.ZodEnum<{
+                group: "group";
+                box: "box";
+                sphere: "sphere";
+                cylinder: "cylinder";
+                cone: "cone";
+                plane: "plane";
+                capsule: "capsule";
+            }>;
+            parentId: z.ZodOptional<z.ZodString>;
+            dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            rotation: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            scale: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            color: z.ZodString;
+            keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                frame: z.ZodNumber;
+                position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                easing: z.ZodOptional<z.ZodEnum<{
+                    linear: "linear";
+                    easeInOut: "easeInOut";
+                }>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        lighting: z.ZodObject<{
+            ambientIntensity: z.ZodNumber;
+            keyIntensity: z.ZodNumber;
+            keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            url: z.ZodString;
+            kind: z.ZodEnum<{
+                image: "image";
+                video: "video";
+            }>;
+            role: z.ZodEnum<{
+                motion: "motion";
+                layout: "layout";
+                appearance: "appearance";
+            }>;
+            objectId: z.ZodOptional<z.ZodString>;
+            startSeconds: z.ZodOptional<z.ZodNumber>;
+            endSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        planType: z.ZodLiteral<"3d-scene">;
+        schemaVersion: z.ZodLiteral<2>;
+        revisionId: z.ZodUUID;
+        parentRevisionId: z.ZodOptional<z.ZodUUID>;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fps: z.ZodNumber;
+        durationInFrames: z.ZodNumber;
+        units: z.ZodLiteral<"meters">;
+        upAxis: z.ZodLiteral<"Y">;
+        handedness: z.ZodLiteral<"right">;
+        objects: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            parentId: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                other: "other";
+                person: "person";
+                vehicle: "vehicle";
+                prop: "prop";
+                environment: "environment";
+            }>>;
+            position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            identityColor: z.ZodOptional<z.ZodString>;
+            anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            }, z.core.$strict>>>;
+            capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                transform: "transform";
+                color: "color";
+                visibility: "visibility";
+            }>>>;
+            locks: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                transform: "transform";
+                color: "color";
+                visibility: "visibility";
+            }>>>;
+            materialBindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                role: z.ZodString;
+                materialName: z.ZodString;
+                color: z.ZodOptional<z.ZodString>;
+                roughness: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>>;
+            visual: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"group">;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"primitive">;
+                primitive: z.ZodEnum<{
+                    box: "box";
+                    sphere: "sphere";
+                    cylinder: "cylinder";
+                    cone: "cone";
+                    plane: "plane";
+                    capsule: "capsule";
+                }>;
+                dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                color: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"asset">;
+                assetId: z.ZodString;
+                rootNodeId: z.ZodString;
+                animation: z.ZodOptional<z.ZodObject<{
+                    clipName: z.ZodString;
+                    startFrame: z.ZodNumber;
+                    endFrameExclusive: z.ZodNumber;
+                    loop: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>], "kind">;
+        }, z.core.$strict>>;
+        assets: z.ZodArray<z.ZodObject<{
+            assetId: z.ZodString;
+            kind: z.ZodEnum<{
+                glb: "glb";
+                "camera-track-json": "camera-track-json";
+                poster: "poster";
+                "validation-report": "validation-report";
+                "blend-source": "blend-source";
+            }>;
+            role: z.ZodEnum<{
+                source: "source";
+                poster: "poster";
+                "validation-report": "validation-report";
+                "scene-geometry": "scene-geometry";
+                "entity-geometry": "entity-geometry";
+                "camera-track": "camera-track";
+            }>;
+            byteLength: z.ZodNumber;
+            sha256: z.ZodString;
+            originRevisionId: z.ZodOptional<z.ZodUUID>;
+        }, z.core.$strict>>;
+        cameraTrackAssetId: z.ZodString;
+        shots: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            startFrame: z.ZodNumber;
+            endFrameExclusive: z.ZodNumber;
+            label: z.ZodOptional<z.ZodString>;
+            subjectEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            foregroundEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        lighting: z.ZodObject<{
+            preset: z.ZodEnum<{
+                "clay-studio-v1": "clay-studio-v1";
+            }>;
+            ambientIntensity: z.ZodNumber;
+            keyIntensity: z.ZodNumber;
+            keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>;
+        backgroundColor: z.ZodString;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            url: z.ZodString;
+            kind: z.ZodEnum<{
+                image: "image";
+                video: "video";
+            }>;
+            role: z.ZodEnum<{
+                motion: "motion";
+                layout: "layout";
+                appearance: "appearance";
+            }>;
+            objectId: z.ZodOptional<z.ZodString>;
+            startSeconds: z.ZodOptional<z.ZodNumber>;
+            endSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+        overrides: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"entity-transform">;
+            entityId: z.ZodString;
+            space: z.ZodEnum<{
+                local: "local";
+                world: "world";
+            }>;
+            position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            id: z.ZodString;
+            sourceRevisionId: z.ZodUUID;
+            sourceContentHash: z.ZodString;
+            operationVersion: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"entity-color">;
+            entityId: z.ZodString;
+            materialRole: z.ZodString;
+            color: z.ZodString;
+            id: z.ZodString;
+            sourceRevisionId: z.ZodUUID;
+            sourceContentHash: z.ZodString;
+            operationVersion: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"entity-visibility">;
+            entityId: z.ZodString;
+            visible: z.ZodBoolean;
+            id: z.ZodString;
+            sourceRevisionId: z.ZodUUID;
+            sourceContentHash: z.ZodString;
+            operationVersion: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"camera-shot-offset">;
+            shotId: z.ZodString;
+            positionOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            targetOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            id: z.ZodString;
+            sourceRevisionId: z.ZodUUID;
+            sourceContentHash: z.ZodString;
+            operationVersion: z.ZodNumber;
+        }, z.core.$strict>], "kind">>>;
+        provenance: z.ZodObject<{
+            engine: z.ZodString;
+            engineVersion: z.ZodString;
+            recipeVersion: z.ZodString;
+            compilerVersion: z.ZodString;
+            exporterVersion: z.ZodString;
+            rendererVersion: z.ZodString;
+            sourceRevisionId: z.ZodOptional<z.ZodUUID>;
+            sourceArtifactId: z.ZodOptional<z.ZodString>;
+            contentHash: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "schemaVersion">;
+    sceneRevisionId: z.ZodString;
+    posterAssetId: z.ZodString;
+    sourceArtifactId: z.ZodOptional<z.ZodString>;
+    validation: z.ZodObject<{
+        status: z.ZodLiteral<"passed">;
+        reportAssetId: z.ZodString;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            shotId: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+    renderer: z.ZodString;
+    metadata: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fps: z.ZodNumber;
+        frames: z.ZodNumber;
+        duration: z.ZodNumber;
+    }, z.core.$loose>;
+    changeSummary: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+declare function isPro3DRenderJobOutput(value: unknown): value is Pro3DRenderJobOutput;
+/**
+ * The two fields every EXECUTION SURFACE must be able to resolve, whatever
+ * else a runtime does or does not attach yet.
+ *
+ * Separate from the full reader above on purpose: canvas wiring, the DAG
+ * extractors and the render-only re-run need "is there a video and a scene
+ * here", and gating those on complete metadata would blank a node over a
+ * missing poster id.
+ */
+declare const pro3DRenderCoreOutputSchema: z.ZodObject<{
+    videoUrl: z.ZodString;
+    scenePlan: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        planType: z.ZodLiteral<"3d-scene">;
+        schemaVersion: z.ZodLiteral<1>;
+        revisionId: z.ZodUUID;
+        parentRevisionId: z.ZodOptional<z.ZodUUID>;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fps: z.ZodNumber;
+        durationInFrames: z.ZodNumber;
+        backgroundColor: z.ZodString;
+        camera: z.ZodObject<{
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            focalLengthMm: z.ZodNumber;
+            sensorWidthMm: z.ZodDefault<z.ZodNumber>;
+            keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                frame: z.ZodNumber;
+                position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                target: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                focalLengthMm: z.ZodOptional<z.ZodNumber>;
+                easing: z.ZodOptional<z.ZodEnum<{
+                    linear: "linear";
+                    easeInOut: "easeInOut";
+                }>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+        objects: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            primitive: z.ZodEnum<{
+                group: "group";
+                box: "box";
+                sphere: "sphere";
+                cylinder: "cylinder";
+                cone: "cone";
+                plane: "plane";
+                capsule: "capsule";
+            }>;
+            parentId: z.ZodOptional<z.ZodString>;
+            dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            rotation: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            scale: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            color: z.ZodString;
+            keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                frame: z.ZodNumber;
+                position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                easing: z.ZodOptional<z.ZodEnum<{
+                    linear: "linear";
+                    easeInOut: "easeInOut";
+                }>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        lighting: z.ZodObject<{
+            ambientIntensity: z.ZodNumber;
+            keyIntensity: z.ZodNumber;
+            keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            url: z.ZodString;
+            kind: z.ZodEnum<{
+                image: "image";
+                video: "video";
+            }>;
+            role: z.ZodEnum<{
+                motion: "motion";
+                layout: "layout";
+                appearance: "appearance";
+            }>;
+            objectId: z.ZodOptional<z.ZodString>;
+            startSeconds: z.ZodOptional<z.ZodNumber>;
+            endSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        planType: z.ZodLiteral<"3d-scene">;
+        schemaVersion: z.ZodLiteral<2>;
+        revisionId: z.ZodUUID;
+        parentRevisionId: z.ZodOptional<z.ZodUUID>;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fps: z.ZodNumber;
+        durationInFrames: z.ZodNumber;
+        units: z.ZodLiteral<"meters">;
+        upAxis: z.ZodLiteral<"Y">;
+        handedness: z.ZodLiteral<"right">;
+        objects: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            parentId: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                other: "other";
+                person: "person";
+                vehicle: "vehicle";
+                prop: "prop";
+                environment: "environment";
+            }>>;
+            position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            identityColor: z.ZodOptional<z.ZodString>;
+            anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            }, z.core.$strict>>>;
+            capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                transform: "transform";
+                color: "color";
+                visibility: "visibility";
+            }>>>;
+            locks: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                transform: "transform";
+                color: "color";
+                visibility: "visibility";
+            }>>>;
+            materialBindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                role: z.ZodString;
+                materialName: z.ZodString;
+                color: z.ZodOptional<z.ZodString>;
+                roughness: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>>;
+            visual: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"group">;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"primitive">;
+                primitive: z.ZodEnum<{
+                    box: "box";
+                    sphere: "sphere";
+                    cylinder: "cylinder";
+                    cone: "cone";
+                    plane: "plane";
+                    capsule: "capsule";
+                }>;
+                dimensions: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                color: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"asset">;
+                assetId: z.ZodString;
+                rootNodeId: z.ZodString;
+                animation: z.ZodOptional<z.ZodObject<{
+                    clipName: z.ZodString;
+                    startFrame: z.ZodNumber;
+                    endFrameExclusive: z.ZodNumber;
+                    loop: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>], "kind">;
+        }, z.core.$strict>>;
+        assets: z.ZodArray<z.ZodObject<{
+            assetId: z.ZodString;
+            kind: z.ZodEnum<{
+                glb: "glb";
+                "camera-track-json": "camera-track-json";
+                poster: "poster";
+                "validation-report": "validation-report";
+                "blend-source": "blend-source";
+            }>;
+            role: z.ZodEnum<{
+                source: "source";
+                poster: "poster";
+                "validation-report": "validation-report";
+                "scene-geometry": "scene-geometry";
+                "entity-geometry": "entity-geometry";
+                "camera-track": "camera-track";
+            }>;
+            byteLength: z.ZodNumber;
+            sha256: z.ZodString;
+            originRevisionId: z.ZodOptional<z.ZodUUID>;
+        }, z.core.$strict>>;
+        cameraTrackAssetId: z.ZodString;
+        shots: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            startFrame: z.ZodNumber;
+            endFrameExclusive: z.ZodNumber;
+            label: z.ZodOptional<z.ZodString>;
+            subjectEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            foregroundEntityIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        lighting: z.ZodObject<{
+            preset: z.ZodEnum<{
+                "clay-studio-v1": "clay-studio-v1";
+            }>;
+            ambientIntensity: z.ZodNumber;
+            keyIntensity: z.ZodNumber;
+            keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>;
+        backgroundColor: z.ZodString;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            url: z.ZodString;
+            kind: z.ZodEnum<{
+                image: "image";
+                video: "video";
+            }>;
+            role: z.ZodEnum<{
+                motion: "motion";
+                layout: "layout";
+                appearance: "appearance";
+            }>;
+            objectId: z.ZodOptional<z.ZodString>;
+            startSeconds: z.ZodOptional<z.ZodNumber>;
+            endSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+        overrides: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"entity-transform">;
+            entityId: z.ZodString;
+            space: z.ZodEnum<{
+                local: "local";
+                world: "world";
+            }>;
+            position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            id: z.ZodString;
+            sourceRevisionId: z.ZodUUID;
+            sourceContentHash: z.ZodString;
+            operationVersion: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"entity-color">;
+            entityId: z.ZodString;
+            materialRole: z.ZodString;
+            color: z.ZodString;
+            id: z.ZodString;
+            sourceRevisionId: z.ZodUUID;
+            sourceContentHash: z.ZodString;
+            operationVersion: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"entity-visibility">;
+            entityId: z.ZodString;
+            visible: z.ZodBoolean;
+            id: z.ZodString;
+            sourceRevisionId: z.ZodUUID;
+            sourceContentHash: z.ZodString;
+            operationVersion: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"camera-shot-offset">;
+            shotId: z.ZodString;
+            positionOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            targetOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            id: z.ZodString;
+            sourceRevisionId: z.ZodUUID;
+            sourceContentHash: z.ZodString;
+            operationVersion: z.ZodNumber;
+        }, z.core.$strict>], "kind">>>;
+        provenance: z.ZodObject<{
+            engine: z.ZodString;
+            engineVersion: z.ZodString;
+            recipeVersion: z.ZodString;
+            compilerVersion: z.ZodString;
+            exporterVersion: z.ZodString;
+            rendererVersion: z.ZodString;
+            sourceRevisionId: z.ZodOptional<z.ZodUUID>;
+            sourceArtifactId: z.ZodOptional<z.ZodString>;
+            contentHash: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "schemaVersion">;
+}, z.core.$loose>;
+/** What a canvas node / DAG builder holds before it can name a source. */
+interface Pro3DRenderSourceInput {
+    /** `"scene"` selects the existing-revision path; anything else is a brief. */
+    sourceMode?: string;
+    /** The brief, already resolved and affix-applied by the caller. */
+    prompt?: string;
+    references?: readonly Scene3DReference[];
+    /** The revision to export or edit, and the run that produced it. */
+    revisionId?: string;
+    sourceJobId?: string;
+    /** Absent/blank keeps the render-only path. */
+    editPrompt?: string;
+}
+type Pro3DRenderSourceResult = {
+    ok: true;
+    source: Pro3DRenderSource;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Turn node/DAG state into the wire `source`.
+ *
+ * Shared by BOTH execution engines because the alternative — one copy in the
+ * browser executor and one in the orchestrator — is the drift that lets a
+ * canvas run and a headless run of the same node mean different things. The
+ * refusals are part of that: a scene source missing its correlation must fail
+ * the same way on both.
+ *
+ * A blank `editPrompt` is treated as ABSENT, never as an empty instruction: a
+ * user who cleared the box asked for a plain export, and forwarding `""` would
+ * buy them an authoring pass.
+ */
+declare function buildPro3DRenderSource(input: Pro3DRenderSourceInput): Pro3DRenderSourceResult;
+/**
+ * Which timing fields a request may carry.
+ *
+ * A `scene` source already HAS timing, and the contract forbids silently
+ * overriding it — so the node's own duration/fps/aspect are withheld unless
+ * the user explicitly asked to re-time, in which case they are sent and the
+ * engine decides whether the change is compatible. For a new scene the node's
+ * settings simply are the request.
+ *
+ * Returning an object with the keys omitted (rather than set to `undefined`)
+ * matters: these bodies are JSON-serialized, and an explicit `undefined` and a
+ * missing key are the same on the wire only by luck of the serializer.
+ */
+declare function pro3DRenderTimingOverrides(input: {
+    source: Pro3DRenderSource;
+    overrideSourceTiming?: boolean;
+    durationSeconds?: number;
+    fps?: number;
+    aspectRatio?: string;
+}): {
+    durationSeconds?: number;
+    fps?: number;
+    aspectRatio?: string;
+};
+
+/**
+ * The parts of `settings.studio` that must not leave the owner's account.
+ *
+ * A shared production is read by anyone with the link. Three things inside the
+ * document are the OWNER'S working state and nobody else's business:
+ *
+ * - `trash` — the recycle bin, which holds every shot, still and clip they
+ *   deleted, with prompts and urls intact. A share viewer receiving the bin is
+ *   the sharpest of the three: it hands out work the owner explicitly threw away.
+ * - the in-flight job markers — `pendingClips` / `pendingStills` per shot, and
+ *   `pendingMusic` / `pendingDraft` on the document. A viewer cannot land any
+ *   of them and does not own them; all they carry across is job ids.
+ * - `freecutDraftUrl` — an unsaved editor draft.
+ *
+ * They do NOT all live at the same level, and that is the whole reason this
+ * file exists rather than one array: the writer puts `trash` and
+ * `freecutDraftUrl` on `settings.studio` itself, and puts the per-shot markers
+ * on the `settings.studio.shots[]` entry. A strip that walked only the top
+ * level would pass its own test and still hand a share viewer every marker in
+ * the production.
+ *
+ * It lives in `@nodaro/shared` because two independent readers need the SAME
+ * list: the public share read (which is the reason the list exists) and the
+ * production writer's own bundle projection. A second copy of a list like this
+ * does not stay equal — it goes one key stale and the stale side is the one
+ * that publishes.
+ *
+ * This is a plain JSON walker on purpose. `settings` is a free-form column that
+ * a client owns end to end; the projection reads the keys it must drop and
+ * nothing else, so it never needs — and must never grow — a dependency on
+ * whatever writes the rest of the document.
+ */
+/**
+ * `settings.studio`'s OWN transient keys.
+ *
+ * The per-shot pending lists are on this list as well as the shot one on
+ * purpose: nothing writes them here today, and a stray one from an older
+ * client — or from a client that is not the studio editor at all — still must
+ * not ride out to a viewer.
+ */
+declare const STUDIO_TRANSIENT_KEYS: readonly ["trash", "pendingStills", "pendingClips", "pendingMusic", "pendingDraft", "freecutDraftUrl"];
+/**
+ * ...and a SHOT entry's, which is where the per-shot markers actually are.
+ *
+ * `pendingClip` (singular) is the pre-concurrent-markers shape; the editor's
+ * reader still migrates it on parse, so a row can still be carrying one and it
+ * is still in-flight state.
+ */
+declare const STUDIO_SHOT_TRANSIENT_KEYS: readonly ["pendingClips", "pendingClip", "pendingStills"];
+/**
+ * A production's `settings` with the owner's working state removed.
+ *
+ * Copy-on-write, and structurally: it rebuilds the objects without those keys
+ * rather than deleting from the caller's, so the stored row is untouched. A
+ * `settings` with no `studio` comes back unchanged — this is a studio concern,
+ * and a workflow that is not a production has nothing here to strip.
+ *
+ * Takes and returns `unknown` because the column is free-form and every caller
+ * already holds it as whatever its own layer calls JSON; narrowing here would
+ * only move the cast one line up.
+ */
+declare function stripStudioTransientSettings(settings: unknown): unknown;
+
+/** Immutable, deterministic edits over a baked scene. No asset bytes are mutated. */
+
+/** Callers describe values. Revision identity and provenance are assigned here. */
+declare const scene3DV2OverrideInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"entity-transform">;
+    entityId: z.ZodString;
+    space: z.ZodEnum<{
+        local: "local";
+        world: "world";
+    }>;
+    position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"entity-color">;
+    entityId: z.ZodString;
+    materialRole: z.ZodString;
+    color: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"entity-visibility">;
+    entityId: z.ZodString;
+    visible: z.ZodBoolean;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"camera-shot-offset">;
+    shotId: z.ZodString;
+    positionOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    targetOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+}, z.core.$strict>], "kind">;
+declare const scene3DV2EditOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"set-override">;
+    override: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"entity-transform">;
+        entityId: z.ZodString;
+        space: z.ZodEnum<{
+            local: "local";
+            world: "world";
+        }>;
+        position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"entity-color">;
+        entityId: z.ZodString;
+        materialRole: z.ZodString;
+        color: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"entity-visibility">;
+        entityId: z.ZodString;
+        visible: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"camera-shot-offset">;
+        shotId: z.ZodString;
+        positionOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        targetOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"remove-override">;
+    overrideId: z.ZodString;
+}, z.core.$strict>], "op">;
+declare const scene3DV2EditOperationsSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"set-override">;
+    override: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"entity-transform">;
+        entityId: z.ZodString;
+        space: z.ZodEnum<{
+            local: "local";
+            world: "world";
+        }>;
+        position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        rotation: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        scale: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"entity-color">;
+        entityId: z.ZodString;
+        materialRole: z.ZodString;
+        color: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"entity-visibility">;
+        entityId: z.ZodString;
+        visible: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"camera-shot-offset">;
+        shotId: z.ZodString;
+        positionOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        targetOffset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"remove-override">;
+    overrideId: z.ZodString;
+}, z.core.$strict>], "op">>;
+type Scene3DV2OverrideInput = z.infer<typeof scene3DV2OverrideInputSchema>;
+type Scene3DV2EditOperation = z.infer<typeof scene3DV2EditOperationSchema>;
+interface Scene3DV2EditOptions {
+    expectedRevisionId: string;
+    expectedContentHash?: string;
+    lockedObjectIds?: readonly string[];
+    /** Hosts may allocate identity at admission for idempotent job replay. */
+    newRevisionId?: string;
+}
+type Scene3DV2EditResult = {
+    ok: true;
+    plan: Scene3DPlanV2;
+    changeSummary: string;
+} | {
+    ok: false;
+    code: "invalid_plan" | "invalid_operations" | "stale_revision" | "locked";
+    message: string;
+};
+/**
+ * Edits are all-or-nothing. The expected revision and content hash are checked
+ * before writing, and the result is validated and hashed before acceptance.
+ * A source file belongs to its exact base revision: until the host materializes
+ * these edits, the new revision must not advertise the old native download.
+ */
+declare function applyScene3DV2EditOperations(input: Scene3DPlanV2, operations: readonly Scene3DV2EditOperation[], options: Scene3DV2EditOptions): Promise<Scene3DV2EditResult>;
+
+/** The value that names the Basic lane explicitly. Absent means the same. */
+declare const SCENE3D_BASIC_ENGINE = "basic";
+/** Everything a caller may put in `engine` on a Generate/Edit request. */
+declare const SCENE3D_AUTHORING_ENGINES: readonly ["basic", "blender-cloud", "blender-local"];
+type Scene3DAuthoringEngine = (typeof SCENE3D_AUTHORING_ENGINES)[number];
+/**
+ * The engine an Advanced run picks when nothing else names one.
+ *
+ * Hosted cloud, because that is the contract's default lane; `blender-local`
+ * is never inferred — it needs a paired desktop and its own deployment flag,
+ * so it is only ever used when it was explicitly asked for or when the scene
+ * under edit was authored by it and this install still offers it.
+ */
+declare const SCENE3D_DEFAULT_ADVANCED_ENGINE: Scene3DKnownEngine;
+declare function isScene3DAuthoringEngine(value: unknown): value is Scene3DAuthoringEngine;
+interface Scene3DEngineChoiceInput {
+    /** The node's/caller's explicit selection. `undefined` = "not chosen". */
+    requested?: string | null;
+    /**
+     * The plan the run edits, for an edit. Omit for generate.
+     *
+     * The raw plan rather than a version number on purpose: the caller already
+     * holds it, and reading the version here is the ONE place the "v2 never goes
+     * to Basic" rule can be enforced for every surface at once.
+     */
+    plan?: unknown;
+    /**
+     * Advanced engines this install can actually serve, from
+     * `GET /v1/3d-scene/capabilities`.
+     *
+     * `undefined` means NOT KNOWN (the headless orchestrator never asks, and the
+     * browser has not had the answer back yet) — which is different from "none".
+     * Unknown proceeds and lets the route refuse honestly with
+     * `SCENE_CAPABILITY_UNAVAILABLE`; a known-empty list refuses here, before a
+     * request that cannot succeed is sent.
+     */
+    availableEngines?: readonly string[] | undefined;
+}
+/** The extra body fields an Advanced request carries. Empty on Basic, so the
+ *  Basic request stays byte-identical to what it has always been. */
+interface Scene3DEngineRequestFields {
+    engine?: Scene3DKnownEngine;
+    /**
+     * Which scene schema versions the CALLER can read back.
+     *
+     * Contract §5: an advanced authoring request declares this so the engine
+     * never answers with a revision the caller cannot render. Both of our
+     * surfaces read v1 and v2, so both send the same list.
+     */
+    acceptedSceneSchemaVersions?: number[];
+}
+type Scene3DEngineChoiceRefusalCode = 
+/** The name is not an engine this contract knows. */
+"unknown_engine"
+/** Explicitly asked for an engine this install does not serve. */
+ | "engine_unavailable"
+/** A v2 scene was pointed at the Basic lane. */
+ | "schema_requires_advanced"
+/** The scene claims a version nothing here can author against. */
+ | "unsupported_schema_version"
+/** v2 scene, and no Advanced engine installed at all. */
+ | "advanced_unavailable";
+type Scene3DEngineChoice = {
+    ok: true;
+    lane: "basic";
+    engine: undefined;
+    fields: Scene3DEngineRequestFields;
+} | {
+    ok: true;
+    lane: "advanced";
+    engine: Scene3DKnownEngine;
+    fields: Scene3DEngineRequestFields;
+} | {
+    ok: false;
+    code: Scene3DEngineChoiceRefusalCode;
+    message: string;
+};
+/**
+ * Resolve the lane, or refuse with a sentence the user can act on.
+ *
+ * Pure and synchronous: every caller already holds the three inputs, and the
+ * answer must be identical on the canvas and in the orchestrator.
+ */
+declare function resolveScene3DAuthoringEngine(input: Scene3DEngineChoiceInput): Scene3DEngineChoice;
+/** v1's version constant, re-exported for callers narrowing a plan by hand. */
+declare const SCENE3D_BASIC_SCHEMA_VERSION = 1;
 
-export { ACCESS_LEVELS, ACTIVE_SCENE_HELPERS, ADVANCED_MODE_UNAVAILABLE_REASON, AGGREGATEABLE_TYPES, AGGREGATE_LANE_SOURCE_TYPES, AI_AVATAR_DURATION_BUCKETS, AI_AVATAR_MAX_AUDIO_SEC, AI_AVATAR_MAX_DURATION_SEC, AI_AVATAR_RESERVE_IDS, AI_WRITER_PROVIDERS, ALA_CARTE_BOARDS, ALL_CAPTION_STYLES, ANIMALS, ANIMAL_SUBCATEGORY_LABELS, ANIMAL_SUBCATEGORY_ORDER, ASPECT_RATIO_DIMENSIONS, AUDIO_ADDON_PROVIDERS, AUDIO_CROSSFADE_CURVES, AUDIO_CROSSFADE_CURVE_IDS, AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, AUDIO_PRODUCER_TYPES, type AccessLevel, type AddBRollResult, AddBRollResultSchema, type AggregateableType, type AggregationBuckets, type AiAvatarDurationBucket, type AiAvatarEngine, type AiAvatarResolution, type AiWriterProvider, type AlaCarteBoard, type AnalyzedScene, type AnchorSceneStyleResult, AnchorSceneStyleResultSchema, type Animal, type AnimalSubcategory, type AssetRef, AssetRefSchema, type AudioCrossfadeCurve, type AudioFxPreset, type AudioLayer, type AuditImagesResult, AuditImagesResultSchema, type AuditImagesShotEntry, AuditImagesShotEntrySchema, AuditPromptIssueSchema, type AuditPromptResult, AuditPromptResultSchema, AvatarPayloadError, BOARD_TO_ASSET_TYPE, BOARD_TO_COLUMN, BOARD_VARIANTS, type BoardEntityKind, type BoardPromptContext, type BoardTemplate, BridgeToNextSceneInputSchema, type BridgeToNextSceneResult, BridgeToNextSceneResultSchema, type BrowseCommunityParams, type BrowseCommunityResult, CATEGORY_DURATION_DEFAULTS, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_ASSET_TYPES, CHARACTER_ASSET_VARIANTS, CHARACTER_ATTACH_COLUMNS, CHARACTER_FACETS, CHARACTER_FACET_IDS, CHARACTER_LORA_TRAINING_JOB_TYPE, CHARACTER_MOTION_PROVIDERS, CHARACTER_PICKER_DISPLAY_ORDER, CHARACTER_REFERENCE_PHOTO_KINDS, CHARACTER_STYLES, CHARACTER_VARIANT_ASSET_BUCKETS, CHAT_ENABLED_STAGES, CHAT_STAGES, CHAT_TURN_CAPS, CHAT_WIRED_STAGES, CINEMATIC_DEFAULT_DURATION_SEC, CINEMATIC_DEFAULT_RESOLUTION, CINEMATIC_MAX_DURATION_SEC, CINEMATIC_MAX_LOOKS, CINEMATIC_MAX_REFERENCE_IMAGES, CINEMATIC_MAX_REFERENCE_VIDEOS, CINEMATIC_MIN_DURATION_SEC, CINEMATIC_MIN_LOOKS, CINEMATIC_PROMPT_MAX, CINEMATIC_RESERVE_IDS, COLLABORATOR_ROLES, COLLECT_IN_HANDLE, COMBINE_TRANSITIONS, COMBINE_TRANSITION_GROUP_LABELS, COMBINE_TRANSITION_GROUP_ORDER, COMBINE_TRANSITION_IDS, COMPOSER_PLAN_FIELDS, COMPOSER_PLAN_MAP, CONTENT_TYPES_BY_PLATFORM, CREATURE_ATTACH_COLUMNS, CREDIT_BASE_USD, CREDIT_ROUNDING_RESOLUTION, type CaptionStyle, type CastCoverageCriticVerdict, CastCoverageCriticVerdictSchema, type CharacterAspectRatio, type CharacterAssetType, type CharacterAssetTypeForAspect, type CharacterAttachColumn, type CharacterDef, type CharacterFacet, type CharacterImageCriticVerdict, CharacterImageCriticVerdictSchema, type CharacterLoraFields, type CharacterMentionTokenInfo, CharacterMetadataSchema, type CharacterMotionProvider, type CharacterReferencePhoto, type CharacterReferencePhotoKind, type CharacterVariantAssetBucket, type CharacterVariantAssetItem, type CharacterVoiceSpec, type ChatEnabledStage, type ChatTurnResponse, ChatTurnResponseSchema, type CinematicResolution, type ClipLook, type CloneListingResult, type CollaboratorRole, type CombineTransition, type CombineTransitionGroup, type CombineVideosEstimatorInput, type CommunityCard, type CommunityEntityType, type CommunityFullDetail, type CommunityReportReason, type CommunitySort, type ComponentHandle, type ComponentMetadata, type ConnectedReference, type CreatureAttachColumn, CriticIssueSchema, type CustomEntry, DEFAULT_AUDIO_CROSSFADE_CURVE_ID, DEFAULT_CARRIED_FRACTION, DEFAULT_CHARACTER_ANGLE_COUNT, DEFAULT_CHARACTER_EXPRESSION_COUNT, DEFAULT_CHARACTER_FACET, DEFAULT_LABEL_BY_SOURCE, DEFAULT_LOCATION_USAGE_MODE, DEFAULT_PANEL_COUNT, DEFAULT_REF_IMAGE_MAX, DEFAULT_SECTIONS, DEFAULT_USAGE_MODE, DEFAULT_VIDEO_ANALYSIS_MODEL, DEFAULT_VIDEO_ANALYSIS_TIER, DEFAULT_VIDEO_CLIP_COST, DEFAULT_VIDEO_DURATION_SEC, DEFAULT_VIDEO_PROVIDER, DEFAULT_VOICE_CHANGER_MODEL, DEFAULT_VOICE_DESIGN_MODEL, DETAIL_VARIANTS, DURATION_PRICED_PROVIDERS, DYNAMIC_PRODUCER_TYPES, type DescribedReference, type DetectionResult, DetectionResultSchema, type DialogueLine, EFFORT_TIER_BUMP, EMOTIONAL_BEAT, ENTITY_ASPECT_DEFAULTS, ENTITY_BUCKET_FIELDS, ENTITY_DB_ID_FIELD, ENTITY_IMAGE_HANDLE_TYPES, ENTITY_KIND_SCALAR_FIELDS, ENTITY_NAME_FIELD, ENTITY_NODE_KINDS, ENTITY_SCALAR_FIELDS, ENTITY_SECTIONS, ENTITY_STATUSES, ENTITY_TABLE, ENTITY_TOOL_RETRY_CAP, ENTITY_TYPES, EXECUTION_DATA_KEYS, EXTEND_VIDEO_PROVIDERS, type EntityKind, type EntityMentionTokenInfo, type EntityMetadata, EntityMetadataSchema, type EntityNodeKind, type EntityReferenceInput, type EntityRejectInput, EntityRejectInputSchema, type EntitySlot, type EntityStaleEvent, EntityStaleEventSchema, type EntityStateChangeEvent, EntityStateChangeEventSchema, type EntityStatus, type EntityStudioKind, type EntityStyle, type EntityType, type EvaluateConditionOptions, type ExportedPreset, type ExposableField, type ExposableOutput, type ExposedSetting, type ExtendVideoProvider, type ExtraRefCharacterContext, type ExtraRefInput, FACE_SWAP_PROVIDERS, FAL_LIP_SYNC_PROVIDERS, FAN_OUT_EACH_TYPES, FEATURED_ENTITIES, FILM_BASE_CREDITS, FLEXIBLE_INPUT_LIP_SYNC_PROVIDERS, FLUX2_RES_MP, FLUX_LORA_CHARACTER_MODEL_ID, FRAME_MODE_ADAPTIVE_ONLY_ASPECT, FRAME_TARGET_HANDLES, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, FURNITURE, FURNITURE_SUBCATEGORY_LABELS, FURNITURE_SUBCATEGORY_ORDER, type FaceSwapProvider, type FavoriteListingResult, type FeaturedEntity, type FilmCreditEstimate, type FilterListCondition, type FilterListOperator, type FilterOperator, type FixContinuityInput, FixContinuityInputSchema, type FixContinuityResult, FixContinuityResultSchema, type Flux2Model, type FreecutExportCompletePayload, type FreecutExportProgressPayload, type FreecutImportFile, type FreecutRequestImportPayload, type FullSelectorMode, type Furniture, type FurnitureSubcategory, GEMINI_OMNI_PROVIDERS, GENERATE_TEXT_DELIMITER, GLOBAL_MAX_DURATION_SECONDS, GRANTED_ACCESS, GROUP_HANDLE_PREFIX, GUIDANCE_SCALE_SUPPORT, GVP_ANCHOR_CHOICES, GVP_DEFAULT_PROVIDER, GVP_END_FRAME_PROVIDERS, GVP_EXTEND_PROVIDERS, GVP_SUPPORTED_PROVIDERS, GenerateMotionInputSchema, type GenerateMotionResult, GenerateMotionResultSchema, type GenericEdge, type GenericNode, type GrantedAccess, type GvpAnchorChoice, type GvpAnchorWireMode, HANDLE_PORT_SEPARATOR, HELPERS_SHIPPED_IN_1B3, HIGH_QUALITY_PROVIDERS, HINT_EXEMPT_PARAMETER_TYPES, type HintEdgeLike, type HintGraphContext, type HintNodeLike, type I18nCatalogId, I2I_MASK_SUPPORT, I2I_STRENGTH_SUPPORT, IDEOGRAM_PROVIDERS, IMAGE_ASPECT_RATIO_VALUES, IMAGE_CRITIC_LEAF_MODES, IMAGE_CRITIC_MAX_RETRIES, IMAGE_CRITIC_METADATA_KEYS, IMAGE_CRITIC_MIN_ADHERENCE_SCORE, IMAGE_CRITIC_MODES, IMAGE_CRITIC_UNRESOLVABLE, IMAGE_EDIT_PROVIDERS, IMAGE_GEN_PROVIDERS, IMAGE_I2I_PROVIDERS, IMAGE_MASK_MODE, IMAGE_PROMPT_MAX, IMAGE_REF_TYPES, IMAGE_TO_VIDEO_PROVIDERS, INPUT_FIELD_MAP, INPUT_NODE_TYPES, INSTAGRAM_CAROUSEL_MAX_ITEMS, INSTAGRAM_CAROUSEL_MIN_ITEMS, ITER_CLONE_PATTERN, type IdentityFidelity, type IdentityMeta, type ImageAspectRatio, type ImageCriticIssue, ImageCriticIssueSchema, type ImageCriticLeafMode, type ImageCriticMetadataKey, type ImageCriticMode, type ImageCriticNodeIssue, type ImageCriticResult, ImageCriticResultSchema, type ImageCriticVerdict, ImageCriticVerdictSchema, type ImageEditProvider, type ImageGenProvider, type ImageI2IProvider, type ImageMaskMode, type ImageMentionTokenInfo, type ImageToVideoProvider, type ImprovePromptInput, ImprovePromptInputSchema, type ImprovePromptResult, ImprovePromptResultSchema, type InputFieldSchema, type InvitationDelivery, type InvitationPreview, type InvitationState, type InvitationView, type JoinCodeView, type JsonEvalResult, type JsonFilter, type JsonPatch, KEYFRAME_CREDITS_PER_SHOT, KINETIC_CAPTION_STYLES, type KieApiFormat, type KineticCaptionStyle, LANGUAGES, LEGACY_LOTTIE_HOST_REMAP, LIP_SYNC_DURATION_BUCKETS, LIP_SYNC_MAX_AUDIO_SECONDS, LIP_SYNC_PROVIDERS, LLM_FEATURE_DEFAULTS, LLM_MODALITY_CAPS, LLM_MODELS, LLM_MODEL_IDS, LLM_REASONING_EFFORTS, LLM_ROUTE_DEFAULTS, LLM_TEXT_INPUT_MAX, LLM_VENDOR_LABELS, LLM_VENDOR_ORDER, LOCATION_ASSET_TYPES, LOCATION_ASSET_VARIANTS, LOCATION_ATMOSPHERE_PROVIDERS, LOCATION_ATTACH_COLUMNS, LOCATION_BUCKET_TO_CATALOG_ID, LOCATION_PRESET_TO_CATALOG, LOCATION_REFERENCE_PHOTO_KINDS, LOCATION_REFERENCE_PHOTO_KIND_LABELS, LOCATION_USAGE_MODES, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, type LabeledOption, type LipSyncDurationBucket, type LipSyncProvider, type LlmFeature, type LlmModelDef, type LlmModelGroup, type LlmReasoningEffort, type LlmRouteDefaults, type LlmTier, type LlmVendor, type LocaleCatalogMap, type LocaleDirection, type LocaleId, type LocationAssetType, type LocationAtmosphereProvider, type LocationAttachColumn, type LocationCatalogRef, type LocationImageCriticVerdict, LocationImageCriticVerdictSchema, type LocationMentionTokenInfo, LocationMetadataSchema, type LocationReferencePhotoKind, type LocationUsageMode, LocationsCoverageCriticIssueSchema, type LocationsCoverageCriticVerdict, LocationsCoverageCriticVerdictSchema, type LoopTrimEstimatorInput, type LoopVideoEstimatorInput, type LoraEligibleRef, type LoraRouting, type LottieOverlayCatalogEntry, type LottieSlotField, MAX_CUSTOM_ENTRIES_PER_BOARD, MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER, MAX_LOCATION_VARIANTS, MAX_NEGATIVE_PROMPT_CHARS_BY_PROVIDER, MAX_PANELS_PER_SHEET, MAX_TTS_CHARS_BY_PROVIDER, MAX_VIDEO_PROMPT_CHARS_BY_PROVIDER, MEMBER_STATUSES, MINIMAX_H3_DEFAULT_RESOLUTION, MINIMAX_H3_PROVIDERS, MODELS_WITH_REFERENCE_IMAGE_SUPPORT, MODEL_CATALOG, MODEL_PARAM_NODE_TYPES, MODEL_RECOMMENDATIONS, MODIFY_IMAGE_PROVIDERS, MOTION_COLUMN, MOTION_TRANSFER_PROVIDERS, MUSIC_PROVIDERS, type MaskRegionDescriptor, type MatchCutVerdict, MatchCutVerdictSchema, type MeOrganizations, type Member, type MemberStatus, type MinimalEdge, type MinimalNode, type ModelCatalogEntry, type ModelInputAdjustment, type ModelKind, type ModelMenuOption, type ModelMode, type ModelNodeTarget, type ModelPromptingStyle, type ModelRecommendation, type ModelTreeLine, type ModelTreeVariant, type ModelValidationIssue, type ModifyImageProvider, type MotionTransferProviderType, type MusicProvider, NATIVE_ADAPTIVE_ASPECT, NATIVE_NEGATIVE_PROMPT_MODELS, NATIVE_NEGATIVE_VIDEO_PROVIDERS, NEGATIVE_PROMPT_MAX, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, NODE_DEFAULT_TYPES, NODE_MAPPABLE_FIELDS, NODE_PRESET_EXPORT_KIND, NODE_REF_PATTERN, NON_EN_LOCALE_IDS, NO_SPLIT_DELIMITER, type NodaroLoadTimelinePayload, type NodaroLoadVideoPayload, type NodeDefaultType, type NodeParamAdjustment, type NodePresetExport, type NormalizedImageGen, type NormalizedModelInput, type NormalizedNodes, type NormalizedVideoRequest, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ASSET_VARIANTS, OBJECT_ATTACH_COLUMNS, OBJECT_MOTION_PROVIDERS, OBJECT_PICKER_NODE_TYPES, ORG_ERROR_CODES, ORG_KINDS, ORG_ROLES, ORG_STATUSES, OUTPUT_FIELD_MAP, OUTPUT_FORMATS, type ObjectAspectRatio, type ObjectAssetType, type ObjectAssetTypeForAspect, type ObjectAttachColumn, ObjectMetadataSchema, type ObjectMotionProvider, type ObjectsValidationIssue, type ObjectsValidationResult, OptimizeForModelInputSchema, type OptimizeForModelResult, OptimizeForModelResultSchema, type OrgAuditEntry, type OrgErrorCode, type OrgKind, type OrgMemberView, type OrgPage, type OrgRole, type OrgSettings, OrgSettingsSchema, type OrgStatus, type OrganizationSummary, type OrganizationView, type OutputFormat, type OutputMode, type OutputType, PARAMETER_NODE_TYPES, PASSTHROUGH_TYPES, PAYG_RETENTION_DAYS, PER_FORMAT_DURATION_BOUNDS, PICKER_TO_COMBINE_TRANSITION, PIPELINE_ACTIVATION_MODES, PIPELINE_FORMATS, PIPELINE_HARD_TIMEOUT_MS, PIPELINE_MODEL_STAGES, PIPELINE_MODES, PIPELINE_OUTPUT_RESOLUTIONS, PIPELINE_PINNABLE_IMAGE_MODELS, PIPELINE_PINNABLE_SCRIPT_LLMS, PIPELINE_PINNABLE_VIDEO_MODELS, PIPELINE_STAGE_NAMES, PIPELINE_STAGE_TIMEOUT_MS, PIPELINE_TYPES, PLACEHOLDER_CHARACTER_NAME, PLATFORM_LABELS, PLATFORM_SPECS, PRESET_APPLY_CLEAR_KEYS, PRESET_EXCLUDED_KEYS, PRESET_LABELS, PRESET_SETTING_KEYS, PRICING_DEFAULT_DURATION_SEC, PRICING_DEFAULT_RESOLUTION, PROMPT_HARD_CEILING, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PROVIDER_DIRECTIVE_DEFAULTS, PROVIDER_PLACEHOLDER_PREFIX, type PanelGenRequest, type PanelRequest, type PanelSource, type PipelineActivationMode, type PipelineCompletedEvent, PipelineCompletedEventSchema, type PipelineConfig, PipelineConfigSchema, type PipelineDriftSummary, PipelineDriftSummarySchema, type PipelineEditorDecisionsReadyEvent, PipelineEditorDecisionsReadyEventSchema, type PipelineEvent, type PipelineForkedEvent, PipelineForkedEventSchema, type PipelineFormat, type PipelineInput, PipelineInputSchema, type PipelineLifecycleEvent, type PipelineMode, type PipelineModelStage, type PipelineMusicReadyEvent, PipelineMusicReadyEventSchema, type PipelineOutputResolution, type PipelinePinnableImageModel, type PipelinePinnableScriptLlm, type PipelinePinnableVideoModel, type PipelineStageName, PipelineStageNameSchema, type PipelineStageStatus, PipelineStageStatusSchema, type PipelineState, PipelineStateSchema, type PipelineStatus, PipelineStatusSchema, type PipelineType, type PixelBox, type PresentationItem, type PresetEntry, type PresetSettingKey, type PresetSettings, PresetSettingsSchema, type PriceVariant, type PricedVideoSelection, type ProgressSegment, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, type PromptAffixFields, type PromptAffixes, type ProposedChange, type PublishListingParams, type PublishListingResult, QA_CHECK_PROVIDERS, type QaCheckProvider, type QualityLevel, REDUCE_STRATEGIES, REDUCE_STRATEGY_IDS, REFERENCE_BOARD_PROVIDERS, REFERENCE_BOARD_TEMPLATES, REFERENCE_HANDLE_MAP, REFERENCE_ROLE_PRESETS, REF_HANDLE_CATEGORY, REF_IMAGE_MAX_LIMITS, REF_TOKEN_NAMESPACE_PREFIXES, RENDERING_SPEED_SUPPORT, REPEATABLE_NODE_TYPES, REPEAT_PLACEHOLDER, REPLICATE_LIP_SYNC_PROVIDERS, RESERVED_TEMPLATE_VARS, type ReduceMeta, type ReduceStrategy, type ReduceStrategyId, type RefCandidate, type RefModalityEdge, type RefTokenKind, type RefVideoDurationLimit, type ReferenceBoardProvider, type ReferenceModality, type ReferenceSheet, type ReferenceSource, type ReportListingResult, type ResolveCharacterAspectOptions, type ResolveObjectAspectOptions, type ResolveSeparatorOptions, type ResolvedDialogueVoiceLine, type RouterConditionGroup, SCENE3D_DEFAULT_DURATION_SECONDS, SCENE3D_DEFAULT_FPS, SCENE3D_EDIT_NODE_TYPE, SCENE3D_GENERATE_NODE_TYPE, SCENE3D_LIMITS, SCENE3D_PLAN_FIELD, SCENE3D_PLAN_TYPE, SCENE3D_PRIMITIVES, SCENE3D_SCHEMA_VERSION, SCENE_HELPER_NAMES, SCRAPER_ACTOR_LABELS, SCRAPER_CREDIT_COSTS, SCRAPER_OUTPUT_FIELDS, SCRIPT_PROVIDERS, SEASONS, SECTION_BOARD, SECTION_KINDS, SEEDANCE_2_5_REF_LIMITS, SEEDANCE_2_CONTINUATION_REF_SEC, SEEDANCE_2_EXTEND_STITCH, SEEDANCE_2_PROVIDERS, SEEDANCE_2_R2V_MAX_AUDIO_SEC_BY_PROVIDER, SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC, SEEDANCE_2_REF_LIMITS, SEEDANCE_LIP_SYNC_PROVIDERS, SEED_SUPPORT, SEPARATOR_DISPLAY, SEPARATOR_PRESETS, SHEET_ASPECTS, SHEET_BACKGROUNDS, SHEET_PRESETS, SHEET_SKINS, SHEET_TYPES, SHORT_FILM_ANGLE_COUNT, SHORT_FILM_EXPRESSION_COUNT, SHORT_FILM_VARIANT_THRESHOLD_SEC, SLOT_TOKEN_RE, SMART_CUT_WINDOW_DEFAULT, SMART_CUT_WINDOW_MAX, SMART_CUT_WINDOW_MIN, SOCIAL_POST_NODE_TYPES, STAGE_PATCH_SCHEMA, STATIC_CAPTION_STYLES, STRUCTURAL_SECTIONS, STRUCTURED_VISION_MODELS, STUDIO_SHOT_TRANSIENT_KEYS, STUDIO_TRANSIENT_KEYS, SUBMISSION_STATUSES, SUNO_ADD_TRACK_MODELS, SUNO_FIELD_HANDLE_FIELDS, SUNO_HARD_CEILING, SUNO_MODELS, SUNO_SELECT_OPERATIONS, SUNO_TEXT_MAX, SUNO_TITLE_MAX, SUNO_TRACK_SOURCE_TYPES, SUNO_VERSION_PRICED_OPERATIONS, SUPPORTED_FONT_NAMES, SURROUND_DIRECTIONS, SWITCHX_BLOCK_FRAMES, SWITCHX_FRAME_TIERS, type SafetyRetryPolicy, type Scene3DCamera, type Scene3DCameraChanges, type Scene3DCameraKeyframe, type Scene3DEasing, type Scene3DEditErrorCode, type Scene3DEditOperation, type Scene3DEditOptions, type Scene3DEditResult, type Scene3DJobOutput, type Scene3DLighting, type Scene3DLightingChanges, type Scene3DObject, type Scene3DObjectChanges, type Scene3DObjectKeyframe, type Scene3DPlan, type Scene3DPrimitive, type Scene3DReference, type Scene3DReferenceKind, type Scene3DReferenceRole, type SceneData, type SceneHelperName, SceneHelperNameSchema, type SceneInputMode, SceneInputModeSchema, type SceneMetadata, SceneMetadataSchema, type SceneNodeData, SceneNodeDataSchema, SceneSpecSchema, type ScraperActorId, type ScriptCriticVerdict, ScriptCriticVerdictSchema, type ScriptProvider, type Season, type SectionKind, type SelectorConfig, type SelectorFields, type SelectorMode, type SelectorPredicateOp, type SelectorResult, type SemanticAspectRatio, type SeparatorPreset, type SharedListing, type SharedVoice, type SheetAspect, type SheetBackground, type SheetCostEstimate, type SheetEntry, type SheetFlavour, type SheetGenerationPlan, type SheetPreset, type SheetPresetId, type SheetSection, type SheetSkin, type SheetTextData, type SheetType, type ShotElement, type ShotImageElement, type ShotShapeElement, type ShotSpec, ShotSpecSchema, type ShotTextElement, type ShowrunnerPlan, ShowrunnerPlanSchema, type SidecarLoader, type SlotControlDescriptor, type SlotControlKind, type SlotVariation, type SocialMediaContentType, type SocialMediaPlatform, type SocialMediaSpec, type SortDirection, type SortListOptions, type SortType, type StageAwaitingSubGateEvent, StageAwaitingSubGateEventSchema, type StaticCaptionStyle, type StoryboardCohesionCriticVerdict, StoryboardCohesionCriticVerdictSchema, type StyleDirectives, StyleDirectivesSchema, type SubGateName, SubGateNameSchema, type SubmissionStatus, type SunoAddTrackModel, type SunoModel, type SupportedFontName, type SurroundDirection, type Swatch, T2I_TO_I2I_VARIANT, TASK_CHAINED_EDIT_PROVIDERS, TEXT_TO_AUDIO_PROVIDERS, TEXT_TO_VIDEO_PROVIDERS, TIER_MAX_PIPELINE_COST_CREDITS, TIER_PIPELINE_PARALLELISM, TILT_CARRIED_FRACTION, TOPAZ_DEFAULT_UPSCALE_FACTOR, TOPAZ_UPSCALE_FACTORS, TRANSCRIBE_PROVIDERS, TRANSIENT_RUNTIME_KEYS, TTS_PROVIDERS, TTS_TEXT_MAX, TWO_K_RESOLUTION_PROVIDERS, type TextToAudioProvider, type TextToVideoProvider, type TopazUpscaleAdjustment, type TopazUpscaleFactor, type TopazUpscaleResolution, type TranscribeProvider, type TransitionType, TransitionTypeSchema, type TrimVideoEstimatorInput, type TtsProvider, UPSCALE_IMAGE_PROVIDERS, USAGE_GROUP_BYS, USAGE_MODES, type UpscaleImageProvider, type UsageGroupBy, type UsageLogEntry, type UsageMode, type UsageQuery, type UsageReport, type UsageReportRow, type UsageReportTotals, type UsageVarianceRow, VARIABLES_HANDLE_ID, VARIABLE_PRICING_MODELS, VEHICLES, VEHICLE_SUBCATEGORY_LABELS, VEHICLE_SUBCATEGORY_ORDER, VEO_PROVIDERS, VIDEO_ANALYSIS_AUDIO_MODES, VIDEO_ANALYSIS_BUCKET_CREDITS, VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN, VIDEO_ANALYSIS_DEFAULT_VARIATION, VIDEO_ANALYSIS_DURATION_BUCKETS, VIDEO_ANALYSIS_DURATION_TOLERANCE_SEC, VIDEO_ANALYSIS_ENTITY_SOURCES, VIDEO_ANALYSIS_FACELESS_ANGLES, VIDEO_ANALYSIS_LEGACY_MODELS, VIDEO_ANALYSIS_LLM_MODELS, VIDEO_ANALYSIS_MAX_DURATION_SEC, VIDEO_ANALYSIS_MAX_SCENE_SEC, VIDEO_ANALYSIS_MAX_VARIATIONS, VIDEO_ANALYSIS_MIXED_TIERS, VIDEO_ANALYSIS_SHOT_ANGLES, VIDEO_ANALYSIS_SPEED_EFFECTS, VIDEO_ANALYSIS_STORY_JUMPS, VIDEO_ANALYSIS_TEXT_KINDS, VIDEO_ANALYSIS_TIERS, VIDEO_ANALYSIS_TIER_LABELS, VIDEO_ANALYSIS_TIER_ORDER, VIDEO_ANALYSIS_TIMES_OF_DAY, VIDEO_ANALYSIS_TRANSITIONS, VIDEO_ANALYSIS_VARIATION_SLUGS, VIDEO_ANALYSIS_VISUAL_EFFECTS, VIDEO_ANALYSIS_WINDOW, VIDEO_AUDIO_CAPABILITY, VIDEO_AUDIT_BUCKET_CREDITS, VIDEO_CLIP_CREDITS, VIDEO_CRITIC_CREDITS_PER_SHOT, VIDEO_CRITIC_FRAME_MODES, VIDEO_CRITIC_MAX_RETRIES, VIDEO_CRITIC_METADATA_KEYS, VIDEO_CRITIC_MIN_ADHERENCE_SCORE, VIDEO_DURATION_TIERS, VIDEO_GEN_COLLAPSED_T2V_IDS, VIDEO_GEN_PROVIDERS, VIDEO_INPUT_LIP_SYNC_PROVIDERS, VIDEO_MODEL_CAPS, VIDEO_MODE_ALIASES, VIDEO_PRODUCER_TYPES, VIDEO_PROMPT_MAX, VIDEO_PROVIDERS_REQUIRING_IMAGE, VIDEO_PROVIDERS_WITHOUT_DISPATCH, VIDEO_REF_LIMITS_BY_PROVIDER, VIDEO_REF_VIDEO_DURATION_LIMITS, VIDEO_TO_VIDEO_PROVIDERS, VIDEO_UPSCALE_PROVIDERS, VIDEO_UTIL_PRICING, VIDEO_VARIABLE_PRICING, VOICE_CHANGER_MODELS, VOICE_CHANGER_MODEL_IDS, VOICE_DESIGN_MODELS, type ValidateMatchCutInput, ValidateMatchCutInputSchema, type ValidateMatchCutResult, ValidateMatchCutResultSchema, type ValidationField, type Vec3, type Vehicle, type VehicleSubcategory, type VideoAnalysisAudioMode, type VideoAnalysisClipTransitionIn, type VideoAnalysisEntitySource, type VideoAnalysisMixedTier, type VideoAnalysisModelTier, type VideoAnalysisResult, type VideoAnalysisShotAngle, type VideoAnalysisSpeedEffect, type VideoAnalysisTextKind, type VideoAnalysisTier, type VideoAnalysisTransition, type VideoAnalysisVisualEffect, type VideoAudioCapability, type VideoAudioMode, type VideoClipCost, type VideoCriticFrameMode, type VideoCriticMetadataKey, type VideoCriticShotFields, type VideoCriticVerdict, VideoCriticVerdictSchema, type VideoGenProvider, type VideoModeAlias, type VideoModelCapabilities, type VideoToVideoProvider, type VideoUpscaleProvider, type Voice, type VoiceChangerModel, type VoiceClone, type VoiceDesignModel, type VoiceLibraryParams, type VoiceLibraryResponse, type VoiceMatch, VoiceMatchSchema, type VoiceType, WAN_3_DEFAULT_RESOLUTION, WAN_3_PROVIDERS, WARDROBE_VARIANTS, WEAPONS, WEAPON_SUBCATEGORY_LABELS, WEAPON_SUBCATEGORY_ORDER, WORKFLOW_VISIBILITIES, WORKSPACE_HEADER, WORKSPACE_HEADER_LOWER, WORKSPACE_ROLES, type Weapon, type WeaponSubcategory, type WindowAnalysis, type WindowScene, type WorkflowAssetKind, type WorkflowExport, type WorkflowExportCharacter, type WorkflowExportCreature, type WorkflowExportLocation, type WorkflowExportObject, type WorkflowImportReport, type WorkflowImportSkippedAsset, type WorkflowMediaRef, type WorkflowPortability, type WorkflowVisibility, type WorkspaceMemberView, type WorkspaceRole, type WorkspaceSettings, WorkspaceSettingsSchema, type WorkspaceSummary, type WorkspaceView, aggregateByType, aiAvatarReserveCreditId, analyzedSceneSchema, applyDefaultVideoSelection, applyHandleInputOverride, applyRange, applyRangeIndices, applyScene3DEditOperations, applySlots, applyVideoAudioToggle, applyVideoNegativePrompt, aspectRatioFromDims, aspectRatioOptionsByKind, aspectRatioToNumber, assembleNarratedVideoCredits, availableReasoningEfforts, bucketSecondsFromAuditCreditId, bucketSecondsFromCreditId, buildBoardPrompt, buildChildrenByParent, buildConditionVariables, buildCreditModelIdentifier, buildExpressionFromVisual, buildLipSyncCreditId, buildLlmCreditIdentifier, buildModelMenu, buildModelTree, buildMotionCreditModelIdentifier, buildNodePresetExport, buildPanelPrompt, buildProgressSegments, buildRangeLabel, buildScraperCreditId, buildVideoAnalysisCreditId, buildVideoAuditCreditId, buildVideoCreditModelIdentifier, calculateCombinedProgress, calculateMonetizationMarkup, calculateMonetizedCost, calculateProgress, canonicalVarName, characterBoardItems, characterBucketDisplayRank, characterMentionSlug, characterMentionableAssetArrays, characterSheetRefItems, characterVariantAssetArrays, checkRefVideoDurations, cinematicCreditId, clampCinematicDuration, clampSmartCutWindow, classifyRefToken, cleanOrphanedItems, clearImageCriticMetadata, clearVideoCriticMetadata, clipLookSchema, collectAncestorRefs, combineSameLabelRefs, computeAggregateLanes, countRefModalityEdges, creditRangesAll, creditsToUsd, decodeProviderItem, defaultCarriedFraction, defaultResolutionFor, defaultRoleForSource, defaultVideoAspectRatio, deriveLinkedFields, deriveLottieSlotFields, deriveSlotRefs, describeEdgeBehavior, describeMaskRegion, describeNodeAdjustments, describeSlotControl, dropUnknownBindings, dropUnknownSpeakers, durationsByMode, effectiveReasoningEffort, encodeProviderItem, ensureLocaleCatalogLoaded, entityHydrationColumns, entityMentionSlug, entityMentionSlugForRef, entityScalarFields, entitySlotSchema, entryMatchesQuery, estimateCombineVideosCredits, estimateFilmCredits, estimateLoopTrimAddonCredits, estimateLoopVideoCredits, estimateScriptDurationSec, estimateSheetCost, estimateTrimVideoCredits, evaluateCondition, evaluateConditionGroup, evaluateJsonExpression, evaluateJsonPath, expandExtraRefsToConnectedReferences, expandItemsWithRepeat, extractAllGeneratedResults, extractCharacterLoraFields, extractGeneratedJsonAsList, extractPresetData, extractReferencedLabels, extractVideoDurationFromNode, fieldKeyFromHandle, filterCloneNodes, findCharacterMentionTokens, findEntityMentionTokens, findImageMentionTokens, findLocationMentionTokens, findSeedance2AudioOverLimit, firstSightExtraRole, flattenItems, getAnimal, getAnimalLabel, getAnimalPromptHint, getAnimalTerm, getAspectRatioOptions, getAudioCrossfadeCurve, getCharacterFacet, getCombineTransition, getCreditRange, getDurationsForModel, getEffectiveRepeatCount, getFeaturedEntities, getFurniture, getFurnitureLabel, getInputFieldSchema, getInputNodes, getItemSortId, getLipSyncMaxAudioSeconds, getLlmModalityCaps, getLlmModel, getLlmTier, getLocaleDirection, getMaxImagePromptChars, getMaxNegativePromptChars, getMaxSunoPromptChars, getMaxSunoStyleChars, getMaxTtsChars, getMaxVideoPromptChars, getModel, getNodeLabel, getNodeResult, getOutputNodes, getOutputType, getParameterValue, getQualityOptions, getResolutionOptions, getRouteReachableNodeIds, getStrategy, getTargetField, getValidValues, getVehicle, getVehicleLabel, getVideoAudioCapability, getWeapon, getWeaponLabel, groupByFamily, groupHandleId, groupLlmModelsByVendor, hasContiguousSegmentDurations, hasFeature, hexToRgbaArray, humanizeSlotSid, imageMentionSlug, imageMentionSlugForRef, imageReferenceLimit, inferMusicVideo, isAggregateableType, isCharacterAspectRatio, isCollectInEdge, isDefaultSelectorConfig, isExpandedClone, isFlux2Model, isGeminiOmniProvider, isGvpSupportedProvider, isHandleInputWired, isKineticCaptionStyle, isLocationUsageMode, isMinimaxH3Provider, isObjectAspectRatio, isOversizedScene, isPaygRetentionActive, isPerSecondLipSyncProvider, isScene3DHttpUrl, isScene3DPlan, isScraperActor, isSeedance2Provider, isTiltDirection, isUsageMode, isVeoProvider, isVideoAnalysisMixedTier, isVideoAnalysisTier, isWan3Provider, jsonResultToList, knownEntitySlugsFromRefs, knownImageSlugsFromRefs, listBoardTemplates, listModels, listSlotSids, llmRouteDefaults, locationMentionSlug, locationReferencePhotoKindLabel, locationUsageModeLabel, mapAspectRatio, mapQuality, mapShotIntentToProviderDirectives, matchVariant, maxSegmentSecFor, maxSegmentsFor, mergeClipLook, mergeExposedSettings, migrateEdgeOutputMode, migrateToItems, minSegmentSecFor, modelIdsByKindMode, modelToNodeTarget, modelsForInputMode, modelsWithFeature, motionGraphicsFeature, newScene3DRevisionId, normalizeLottieLayers, normalizeMinimaxH3Resolution, normalizeModelInput, normalizeNodeModelParams, normalizePinterestUrl, normalizeRoleSlug, normalizeVideoRequestParams, normalizeWan3Resolution, orderedLlmModels, parseAttributedDialogue, parseCharacterMentionToken, parseEntityMentionToken, parseGroupHandle, parseHandleId, parseImageMentionToken, parseListExpression, parseLocationMentionToken, parseNodePresetExport, parseNodeRef, pickAiAvatarBucket, pickIds, pickLipSyncBucket, pickSwitchXFrameTier, pickVideoAnalysisBucket, planSheetGeneration, planSheetPanels, preferredInputModeForModel, presentTypes, presetApplyClearKeys, presetDataMatches, presetEntries, pricedVideoSelection, qualityOptionsByKind, readPromptAffixes, refHandleCategory, referenceModalityForHandle, referenceSheetCreditId, registerCatalogSidecars, registerSidecarLoaders, renderAnalyzedScene, resetCatalogSidecars, resolutionOptionsByKind, resolveAiAvatarCreditId, resolveAudioCrossfadeCurve, resolveCharacterAspectRatio, resolveCinematicCreditId, resolveConditionValue, resolveDefaultRole, resolveDescription, resolveDialogueVoices, resolveEffectiveSourceType, resolveEffectiveTier, resolveEntityAspect, resolveFieldMappings, resolveGvpAnchorWire, resolveImageGenCreditIdentifier, resolveIndex, resolveLabel, resolveListExpression, resolveLlmCreditId, resolveLocationFields, resolveLocationPresetCatalog, resolveLottieOverlaySrc, resolveNodeRefs, resolveNormalizedImageGen, resolveObjectAspectRatio, resolvePipelineModel, resolveRelativeWindowToken, resolveScraperCreditId, resolveSelectorRefs, resolveSeparator, resolveSheetSections, resolveSlideshowTransition, resolveSourceThroughConnectedList, resolveStoredTier, resolveSwitchXCreditId, resolveTopazUpscale, resolveVideoAnalysisModel, resolveVideoModeForInputs, resolveVideoProviderForMode, resolveXfadeName, rewriteSceneBindings, rewriteSlotTokens, rewriteSpeakerSlots, rgbaArrayToHex, roleToPhrase, rotationVec3Schema, runSelector, safetyRetryPolicy, sanitizeRole, scaleVec3Schema, scene3DCameraChangesSchema, scene3DCameraKeyframeSchema, scene3DCameraSchema, scene3DColorSchema, scene3DDeepEqual, scene3DEasingSchema, scene3DEditOperationSchema, scene3DEditOperationsSchema, scene3DIdSchema, scene3DLightingChangesSchema, scene3DLightingSchema, scene3DObjectChangesSchema, scene3DObjectKeyframeSchema, scene3DObjectSchema, scene3DPlanIssues, scene3DPlanSchema, scene3DPrimitiveSchema, scene3DReferenceSchema, scene3DUrlSchema, searchModelVariants, seedance2AudioLimitSec, segmentDurationsFor, selectByModulo, selectByNamedKey, selectByPredicate, selectListItems, selectLoraRoutingForMentions, selectRandom, setRegisteredPersonPackFields, settledWithLimit, sizeVec3Schema, slotVariationSchema, sortCharacterEntriesForDisplay, sortListItems, sourceRefKey, spliceDelimitedRows, splitByLoopDelimiter, splitGeneratedItems, spreadJsonArrayIfSingleton, stringifyPathResults, stripDerivedAnalysisFields, stripExportContent, stripStudioTransientSettings, stripTransientRuntimeData, summarizeScene3DOperations, sunoCreditType, supportedDefaultDimensions, supportsAdvancedMode, supportsEndAnchor, supportsExtendRender, toConnectedReference, toConnectedReferences, togglePick, tryParseJson, uiAspectRatioFill, uiDurationFill, uiResolutionFill, unresolvedRefTokens, unwrapUnresolvedTokens, usageModeDirective, usageModeIncludesName, usageModeLabel, usdToCredits, validateAiAvatarPayload, validateCinematicAvatarPayload, validateDurationForFormat, validateModeActivation, validateModelInput, validateNoNestedGroups, validateObjects, validateProviderForNodeType, validateSubWorkflowRoutes, variantJobId, vec3Schema, videoAnalysisCreditSegment, videoAnalysisNumWindows, videoAnalysisResultSchema, videoAuditCreditsForBucket, videoModelCanSpeakDialogue, videoModelSupportsAudio, videoNegativeSuffix, videoProviderFoldsLoneEndFrame, videoProviderRequiresImage, windowAnalysisSchema, zipMergeLists };
+export { ACCESS_LEVELS, ACTIVE_SCENE_HELPERS, ADVANCED_MODE_UNAVAILABLE_REASON, AGGREGATEABLE_TYPES, AGGREGATE_LANE_SOURCE_TYPES, AI_AVATAR_DURATION_BUCKETS, AI_AVATAR_MAX_AUDIO_SEC, AI_AVATAR_MAX_DURATION_SEC, AI_AVATAR_RESERVE_IDS, AI_WRITER_PROVIDERS, ALA_CARTE_BOARDS, ALL_CAPTION_STYLES, ANIMALS, ANIMAL_SUBCATEGORY_LABELS, ANIMAL_SUBCATEGORY_ORDER, ASPECT_RATIO_DIMENSIONS, AUDIO_ADDON_PROVIDERS, AUDIO_CROSSFADE_CURVES, AUDIO_CROSSFADE_CURVE_IDS, AUDIO_FX_PRESETS, AUDIO_FX_PRESET_LABELS, AUDIO_FX_PRESET_SET, AUDIO_FX_REVERB_PRESETS, AUDIO_PRODUCER_TYPES, type AccessLevel, type AddBRollResult, AddBRollResultSchema, type AggregateableType, type AggregationBuckets, type AiAvatarDurationBucket, type AiAvatarEngine, type AiAvatarResolution, type AiWriterProvider, type AlaCarteBoard, type AnalyzedScene, type AnchorSceneStyleResult, AnchorSceneStyleResultSchema, type Animal, type AnimalSubcategory, type AssetRef, AssetRefSchema, type AudioCrossfadeCurve, type AudioFxPreset, type AudioLayer, type AuditImagesResult, AuditImagesResultSchema, type AuditImagesShotEntry, AuditImagesShotEntrySchema, AuditPromptIssueSchema, type AuditPromptResult, AuditPromptResultSchema, AvatarPayloadError, BOARD_TO_ASSET_TYPE, BOARD_TO_COLUMN, BOARD_VARIANTS, type BoardEntityKind, type BoardPromptContext, type BoardTemplate, BridgeToNextSceneInputSchema, type BridgeToNextSceneResult, BridgeToNextSceneResultSchema, type BrowseCommunityParams, type BrowseCommunityResult, CATEGORY_DURATION_DEFAULTS, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_ASSET_TYPES, CHARACTER_ASSET_VARIANTS, CHARACTER_ATTACH_COLUMNS, CHARACTER_FACETS, CHARACTER_FACET_IDS, CHARACTER_LORA_TRAINING_JOB_TYPE, CHARACTER_MOTION_PROVIDERS, CHARACTER_PICKER_DISPLAY_ORDER, CHARACTER_REFERENCE_PHOTO_KINDS, CHARACTER_STYLES, CHARACTER_VARIANT_ASSET_BUCKETS, CHAT_ENABLED_STAGES, CHAT_STAGES, CHAT_TURN_CAPS, CHAT_WIRED_STAGES, CINEMATIC_DEFAULT_DURATION_SEC, CINEMATIC_DEFAULT_RESOLUTION, CINEMATIC_MAX_DURATION_SEC, CINEMATIC_MAX_LOOKS, CINEMATIC_MAX_REFERENCE_IMAGES, CINEMATIC_MAX_REFERENCE_VIDEOS, CINEMATIC_MIN_DURATION_SEC, CINEMATIC_MIN_LOOKS, CINEMATIC_PROMPT_MAX, CINEMATIC_RESERVE_IDS, COLLABORATOR_ROLES, COLLECT_IN_HANDLE, COMBINE_TRANSITIONS, COMBINE_TRANSITION_GROUP_LABELS, COMBINE_TRANSITION_GROUP_ORDER, COMBINE_TRANSITION_IDS, COMPOSER_PLAN_FIELDS, COMPOSER_PLAN_MAP, CONTENT_TYPES_BY_PLATFORM, CREATURE_ATTACH_COLUMNS, CREDIT_BASE_USD, CREDIT_ROUNDING_RESOLUTION, type CaptionStyle, type CastCoverageCriticVerdict, CastCoverageCriticVerdictSchema, type CharacterAspectRatio, type CharacterAssetType, type CharacterAssetTypeForAspect, type CharacterAttachColumn, type CharacterDef, type CharacterFacet, type CharacterImageCriticVerdict, CharacterImageCriticVerdictSchema, type CharacterLoraFields, type CharacterMentionTokenInfo, CharacterMetadataSchema, type CharacterMotionProvider, type CharacterReferencePhoto, type CharacterReferencePhotoKind, type CharacterVariantAssetBucket, type CharacterVariantAssetItem, type CharacterVoiceSpec, type ChatEnabledStage, type ChatTurnResponse, ChatTurnResponseSchema, type CinematicResolution, type ClipLook, type CloneListingResult, type CollaboratorRole, type CombineTransition, type CombineTransitionGroup, type CombineVideosEstimatorInput, type CommunityCard, type CommunityEntityType, type CommunityFullDetail, type CommunityReportReason, type CommunitySort, type ComponentHandle, type ComponentMetadata, type ConnectedReference, type CreatureAttachColumn, CriticIssueSchema, type CustomEntry, DEFAULT_AUDIO_CROSSFADE_CURVE_ID, DEFAULT_CARRIED_FRACTION, DEFAULT_CHARACTER_ANGLE_COUNT, DEFAULT_CHARACTER_EXPRESSION_COUNT, DEFAULT_CHARACTER_FACET, DEFAULT_LABEL_BY_SOURCE, DEFAULT_LOCATION_USAGE_MODE, DEFAULT_PANEL_COUNT, DEFAULT_REF_IMAGE_MAX, DEFAULT_SECTIONS, DEFAULT_USAGE_MODE, DEFAULT_VIDEO_ANALYSIS_MODEL, DEFAULT_VIDEO_ANALYSIS_TIER, DEFAULT_VIDEO_CLIP_COST, DEFAULT_VIDEO_DURATION_SEC, DEFAULT_VIDEO_PROVIDER, DEFAULT_VOICE_CHANGER_MODEL, DEFAULT_VOICE_DESIGN_MODEL, DETAIL_VARIANTS, DURATION_PRICED_PROVIDERS, DYNAMIC_PRODUCER_TYPES, type DescribedReference, type DetectionResult, DetectionResultSchema, type DialogueLine, EFFORT_TIER_BUMP, EMOTIONAL_BEAT, ENTITY_ASPECT_DEFAULTS, ENTITY_BUCKET_FIELDS, ENTITY_DB_ID_FIELD, ENTITY_IMAGE_HANDLE_TYPES, ENTITY_KIND_SCALAR_FIELDS, ENTITY_NAME_FIELD, ENTITY_NODE_KINDS, ENTITY_SCALAR_FIELDS, ENTITY_SECTIONS, ENTITY_STATUSES, ENTITY_TABLE, ENTITY_TOOL_RETRY_CAP, ENTITY_TYPES, EXECUTION_DATA_KEYS, EXTEND_VIDEO_PROVIDERS, type EntityKind, type EntityMentionTokenInfo, type EntityMetadata, EntityMetadataSchema, type EntityNodeKind, type EntityReferenceInput, type EntityRejectInput, EntityRejectInputSchema, type EntitySlot, type EntityStaleEvent, EntityStaleEventSchema, type EntityStateChangeEvent, EntityStateChangeEventSchema, type EntityStatus, type EntityStudioKind, type EntityStyle, type EntityType, type EvaluateConditionOptions, type ExportedPreset, type ExposableField, type ExposableOutput, type ExposedSetting, type ExtendVideoProvider, type ExtraRefCharacterContext, type ExtraRefInput, FACE_SWAP_PROVIDERS, FAL_LIP_SYNC_PROVIDERS, FAN_OUT_EACH_TYPES, FEATURED_ENTITIES, FILM_BASE_CREDITS, FLEXIBLE_INPUT_LIP_SYNC_PROVIDERS, FLUX2_RES_MP, FLUX_LORA_CHARACTER_MODEL_ID, FRAME_MODE_ADAPTIVE_ONLY_ASPECT, FRAME_TARGET_HANDLES, FREECUT_EXPORT_COMPLETE, FREECUT_EXPORT_PROGRESS, FREECUT_READY, FREECUT_REQUEST_IMPORT, FURNITURE, FURNITURE_SUBCATEGORY_LABELS, FURNITURE_SUBCATEGORY_ORDER, type FaceSwapProvider, type FavoriteListingResult, type FeaturedEntity, type FilmCreditEstimate, type FilterListCondition, type FilterListOperator, type FilterOperator, type FixContinuityInput, FixContinuityInputSchema, type FixContinuityResult, FixContinuityResultSchema, type Flux2Model, type FreecutExportCompletePayload, type FreecutExportProgressPayload, type FreecutImportFile, type FreecutRequestImportPayload, type FullSelectorMode, type Furniture, type FurnitureSubcategory, GEMINI_OMNI_PROVIDERS, GENERATE_TEXT_DELIMITER, GLOBAL_MAX_DURATION_SECONDS, GRANTED_ACCESS, GROUP_HANDLE_PREFIX, GUIDANCE_SCALE_SUPPORT, GVP_ANCHOR_CHOICES, GVP_DEFAULT_PROVIDER, GVP_END_FRAME_PROVIDERS, GVP_EXTEND_PROVIDERS, GVP_SUPPORTED_PROVIDERS, GenerateMotionInputSchema, type GenerateMotionResult, GenerateMotionResultSchema, type GenericEdge, type GenericNode, type GrantedAccess, type GvpAnchorChoice, type GvpAnchorWireMode, HANDLE_PORT_SEPARATOR, HELPERS_SHIPPED_IN_1B3, HIGH_QUALITY_PROVIDERS, HINT_EXEMPT_PARAMETER_TYPES, type HintEdgeLike, type HintGraphContext, type HintNodeLike, type I18nCatalogId, I2I_MASK_SUPPORT, I2I_STRENGTH_SUPPORT, IDEOGRAM_PROVIDERS, IMAGE_ASPECT_RATIO_VALUES, IMAGE_CRITIC_LEAF_MODES, IMAGE_CRITIC_MAX_RETRIES, IMAGE_CRITIC_METADATA_KEYS, IMAGE_CRITIC_MIN_ADHERENCE_SCORE, IMAGE_CRITIC_MODES, IMAGE_CRITIC_UNRESOLVABLE, IMAGE_EDIT_PROVIDERS, IMAGE_GEN_PROVIDERS, IMAGE_I2I_PROVIDERS, IMAGE_MASK_MODE, IMAGE_PROMPT_MAX, IMAGE_REF_TYPES, IMAGE_TO_VIDEO_PROVIDERS, INPUT_FIELD_MAP, INPUT_NODE_TYPES, INSTAGRAM_CAROUSEL_MAX_ITEMS, INSTAGRAM_CAROUSEL_MIN_ITEMS, ITER_CLONE_PATTERN, type IdentityFidelity, type IdentityMeta, type ImageAspectRatio, type ImageCriticIssue, ImageCriticIssueSchema, type ImageCriticLeafMode, type ImageCriticMetadataKey, type ImageCriticMode, type ImageCriticNodeIssue, type ImageCriticResult, ImageCriticResultSchema, type ImageCriticVerdict, ImageCriticVerdictSchema, type ImageEditProvider, type ImageGenProvider, type ImageI2IProvider, type ImageMaskMode, type ImageMentionTokenInfo, type ImageToVideoProvider, type ImprovePromptInput, ImprovePromptInputSchema, type ImprovePromptResult, ImprovePromptResultSchema, type InputFieldSchema, type InvitationDelivery, type InvitationPreview, type InvitationState, type InvitationView, type JoinCodeView, type JsonEvalResult, type JsonFilter, type JsonPatch, KEYFRAME_CREDITS_PER_SHOT, KINETIC_CAPTION_STYLES, type KieApiFormat, type KineticCaptionStyle, LANGUAGES, LEGACY_LOTTIE_HOST_REMAP, LIP_SYNC_DURATION_BUCKETS, LIP_SYNC_MAX_AUDIO_SECONDS, LIP_SYNC_PROVIDERS, LLM_FEATURE_DEFAULTS, LLM_MODALITY_CAPS, LLM_MODELS, LLM_MODEL_IDS, LLM_REASONING_EFFORTS, LLM_ROUTE_DEFAULTS, LLM_TEXT_INPUT_MAX, LLM_VENDOR_LABELS, LLM_VENDOR_ORDER, LOCATION_ASSET_TYPES, LOCATION_ASSET_VARIANTS, LOCATION_ATMOSPHERE_PROVIDERS, LOCATION_ATTACH_COLUMNS, LOCATION_BUCKET_TO_CATALOG_ID, LOCATION_PRESET_TO_CATALOG, LOCATION_REFERENCE_PHOTO_KINDS, LOCATION_REFERENCE_PHOTO_KIND_LABELS, LOCATION_USAGE_MODES, LOTTIE_OVERLAY_CATALOG, LOTTIE_SLOT_FIELD_PREFIX, type LabeledOption, type LipSyncDurationBucket, type LipSyncProvider, type LlmFeature, type LlmModelDef, type LlmModelGroup, type LlmReasoningEffort, type LlmRouteDefaults, type LlmTier, type LlmVendor, type LocaleCatalogMap, type LocaleDirection, type LocaleId, type LocationAssetType, type LocationAtmosphereProvider, type LocationAttachColumn, type LocationCatalogRef, type LocationImageCriticVerdict, LocationImageCriticVerdictSchema, type LocationMentionTokenInfo, LocationMetadataSchema, type LocationReferencePhotoKind, type LocationUsageMode, LocationsCoverageCriticIssueSchema, type LocationsCoverageCriticVerdict, LocationsCoverageCriticVerdictSchema, type LoopTrimEstimatorInput, type LoopVideoEstimatorInput, type LoraEligibleRef, type LoraRouting, type LottieOverlayCatalogEntry, type LottieSlotField, MAX_CUSTOM_ENTRIES_PER_BOARD, MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER, MAX_LOCATION_VARIANTS, MAX_NEGATIVE_PROMPT_CHARS_BY_PROVIDER, MAX_PANELS_PER_SHEET, MAX_TTS_CHARS_BY_PROVIDER, MAX_VIDEO_PROMPT_CHARS_BY_PROVIDER, MEMBER_STATUSES, MINIMAX_H3_DEFAULT_RESOLUTION, MINIMAX_H3_PROVIDERS, MODELS_WITH_REFERENCE_IMAGE_SUPPORT, MODEL_CATALOG, MODEL_PARAM_NODE_TYPES, MODEL_RECOMMENDATIONS, MODIFY_IMAGE_PROVIDERS, MOTION_COLUMN, MOTION_TRANSFER_PROVIDERS, MUSIC_PROVIDERS, type MaskRegionDescriptor, type MatchCutVerdict, MatchCutVerdictSchema, type MeOrganizations, type Member, type MemberStatus, type MinimalEdge, type MinimalNode, type ModelCatalogEntry, type ModelInputAdjustment, type ModelKind, type ModelMenuOption, type ModelMode, type ModelNodeTarget, type ModelPromptingStyle, type ModelRecommendation, type ModelTreeLine, type ModelTreeVariant, type ModelValidationIssue, type ModifyImageProvider, type MotionTransferProviderType, type MusicProvider, NATIVE_ADAPTIVE_ASPECT, NATIVE_NEGATIVE_PROMPT_MODELS, NATIVE_NEGATIVE_VIDEO_PROVIDERS, NEGATIVE_PROMPT_MAX, NODARO_IMPORT_FILES, NODARO_LOAD_TIMELINE, NODARO_LOAD_VIDEO, NODARO_RESET_PROJECT, NODE_DEFAULT_TYPES, NODE_MAPPABLE_FIELDS, NODE_PRESET_EXPORT_KIND, NODE_REF_PATTERN, NON_EN_LOCALE_IDS, NO_SPLIT_DELIMITER, type NodaroLoadTimelinePayload, type NodaroLoadVideoPayload, type NodeDefaultType, type NodeParamAdjustment, type NodePresetExport, type NormalizedImageGen, type NormalizedModelInput, type NormalizedNodes, type NormalizedVideoRequest, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ASSET_VARIANTS, OBJECT_ATTACH_COLUMNS, OBJECT_MOTION_PROVIDERS, OBJECT_PICKER_NODE_TYPES, ORG_ERROR_CODES, ORG_KINDS, ORG_ROLES, ORG_STATUSES, OUTPUT_FIELD_MAP, OUTPUT_FORMATS, type ObjectAspectRatio, type ObjectAssetType, type ObjectAssetTypeForAspect, type ObjectAttachColumn, ObjectMetadataSchema, type ObjectMotionProvider, type ObjectsValidationIssue, type ObjectsValidationResult, OptimizeForModelInputSchema, type OptimizeForModelResult, OptimizeForModelResultSchema, type OrgAuditEntry, type OrgErrorCode, type OrgKind, type OrgMemberView, type OrgPage, type OrgRole, type OrgSettings, OrgSettingsSchema, type OrgStatus, type OrganizationSummary, type OrganizationView, type OutputFormat, type OutputMode, type OutputType, PARAMETER_NODE_TYPES, PASSTHROUGH_TYPES, PAYG_RETENTION_DAYS, PER_FORMAT_DURATION_BOUNDS, PICKER_TO_COMBINE_TRANSITION, PIPELINE_ACTIVATION_MODES, PIPELINE_FORMATS, PIPELINE_HARD_TIMEOUT_MS, PIPELINE_MODEL_STAGES, PIPELINE_MODES, PIPELINE_OUTPUT_RESOLUTIONS, PIPELINE_PINNABLE_IMAGE_MODELS, PIPELINE_PINNABLE_SCRIPT_LLMS, PIPELINE_PINNABLE_VIDEO_MODELS, PIPELINE_STAGE_NAMES, PIPELINE_STAGE_TIMEOUT_MS, PIPELINE_TYPES, PLACEHOLDER_CHARACTER_NAME, PLATFORM_LABELS, PLATFORM_SPECS, PRESET_APPLY_CLEAR_KEYS, PRESET_EXCLUDED_KEYS, PRESET_LABELS, PRESET_SETTING_KEYS, PRICING_DEFAULT_DURATION_SEC, PRICING_DEFAULT_RESOLUTION, PRO3D_RENDER_ASPECT_RATIOS, PRO3D_RENDER_CREDIT_ID, PRO3D_RENDER_DEFAULT_ENGINE, PRO3D_RENDER_DEFAULT_QUALITY, PRO3D_RENDER_DEFAULT_REPAIR_PASSES, PRO3D_RENDER_DEFAULT_STYLE, PRO3D_RENDER_ENGINES, PRO3D_RENDER_LABEL, PRO3D_RENDER_LIMITS, PRO3D_RENDER_MAX_REPAIR_PASSES, PRO3D_RENDER_MIN_REPAIR_PASSES, PRO3D_RENDER_NODE_TYPE, PRO3D_RENDER_PROMPT_MAX, PRO3D_RENDER_QUALITY_PROFILES, PRO3D_RENDER_SOURCE_KINDS, PRO3D_RENDER_STYLES, PROMPT_HARD_CEILING, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PROVIDER_DIRECTIVE_DEFAULTS, PROVIDER_PLACEHOLDER_PREFIX, type PanelGenRequest, type PanelRequest, type PanelSource, type PipelineActivationMode, type PipelineCompletedEvent, PipelineCompletedEventSchema, type PipelineConfig, PipelineConfigSchema, type PipelineDriftSummary, PipelineDriftSummarySchema, type PipelineEditorDecisionsReadyEvent, PipelineEditorDecisionsReadyEventSchema, type PipelineEvent, type PipelineForkedEvent, PipelineForkedEventSchema, type PipelineFormat, type PipelineInput, PipelineInputSchema, type PipelineLifecycleEvent, type PipelineMode, type PipelineModelStage, type PipelineMusicReadyEvent, PipelineMusicReadyEventSchema, type PipelineOutputResolution, type PipelinePinnableImageModel, type PipelinePinnableScriptLlm, type PipelinePinnableVideoModel, type PipelineStageName, PipelineStageNameSchema, type PipelineStageStatus, PipelineStageStatusSchema, type PipelineState, PipelineStateSchema, type PipelineStatus, PipelineStatusSchema, type PipelineType, type PixelBox, type PresentationItem, type PresetEntry, type PresetSettingKey, type PresetSettings, PresetSettingsSchema, type PriceVariant, type PricedVideoSelection, type Pro3DRenderAspectRatio, type Pro3DRenderCapabilities, type Pro3DRenderEngine, type Pro3DRenderJobOutput, type Pro3DRenderLocalExportSource, type Pro3DRenderPromptSource, type Pro3DRenderQuality, type Pro3DRenderQuote, type Pro3DRenderQuoteLine, type Pro3DRenderResultMetadata, type Pro3DRenderSceneSource, type Pro3DRenderSource, type Pro3DRenderSourceInput, type Pro3DRenderSourceKind, type Pro3DRenderSourceResult, type Pro3DRenderStyle, type Pro3DRenderValidationWarning, type ProgressSegment, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, type PromptAffixFields, type PromptAffixes, type ProposedChange, type PublishListingParams, type PublishListingResult, QA_CHECK_PROVIDERS, type QaCheckProvider, type QualityLevel, REDUCE_STRATEGIES, REDUCE_STRATEGY_IDS, REFERENCE_BOARD_PROVIDERS, REFERENCE_BOARD_TEMPLATES, REFERENCE_HANDLE_MAP, REFERENCE_ROLE_PRESETS, REF_HANDLE_CATEGORY, REF_IMAGE_MAX_LIMITS, REF_TOKEN_NAMESPACE_PREFIXES, RENDERING_SPEED_SUPPORT, REPEATABLE_NODE_TYPES, REPEAT_PLACEHOLDER, REPLICATE_LIP_SYNC_PROVIDERS, RESERVED_TEMPLATE_VARS, type ReduceMeta, type ReduceStrategy, type ReduceStrategyId, type RefCandidate, type RefModalityEdge, type RefTokenKind, type RefVideoDurationLimit, type ReferenceBoardProvider, type ReferenceModality, type ReferenceSheet, type ReferenceSource, type ReportListingResult, type ResolveCharacterAspectOptions, type ResolveObjectAspectOptions, type ResolveSeparatorOptions, type ResolvedDialogueVoiceLine, type RouterConditionGroup, SCENE3D_ASSET_KINDS, SCENE3D_ASSET_ROLES, SCENE3D_ASSET_ROLE_KINDS, SCENE3D_AUTHORING_ENGINES, SCENE3D_BASIC_ENGINE, SCENE3D_BASIC_SCHEMA_VERSION, SCENE3D_CAMERA_TRACK_FORMAT, SCENE3D_CAMERA_TRACK_LIMITS, SCENE3D_CAMERA_TRACK_VERSION, SCENE3D_CLAY_LIGHTING_PRESETS, SCENE3D_DEFAULT_ADVANCED_ENGINE, SCENE3D_DEFAULT_DURATION_SECONDS, SCENE3D_DEFAULT_ENTITY_CAPABILITIES, SCENE3D_DEFAULT_FPS, SCENE3D_EDIT_NODE_TYPE, SCENE3D_ENTITY_CAPABILITIES, SCENE3D_ENTITY_ROLES, SCENE3D_GENERATE_NODE_TYPE, SCENE3D_GLB_EXTRAS_ALLOWLIST, SCENE3D_GLB_EXTRAS_ENTITY_ID, SCENE3D_GLB_EXTRAS_MATERIAL_ROLE, SCENE3D_GLB_EXTRAS_SUBPART_ID, SCENE3D_LIMITS, SCENE3D_PLAN_FIELD, SCENE3D_PLAN_TYPE, SCENE3D_PRIMITIVES, SCENE3D_PRIMITIVE_MATERIAL_ROLE, SCENE3D_RENDERER_ASSET_KINDS, SCENE3D_SCHEMA_VERSION, SCENE3D_SCHEMA_VERSION_V2, SCENE3D_SUPPORTED_SCHEMA_VERSIONS, SCENE3D_V2_CONTENT_HASH_EXCLUDED, SCENE3D_V2_ENGINES, SCENE3D_V2_LIMITS, SCENE3D_V2_OVERRIDE_OPERATION_VERSION, SCENE3D_V2_PRIMITIVES, SCENE_HELPER_NAMES, SCRAPER_ACTOR_LABELS, SCRAPER_CREDIT_COSTS, SCRAPER_OUTPUT_FIELDS, SCRIPT_PROVIDERS, SEASONS, SECTION_BOARD, SECTION_KINDS, SEEDANCE_2_5_REF_LIMITS, SEEDANCE_2_CONTINUATION_REF_SEC, SEEDANCE_2_EXTEND_STITCH, SEEDANCE_2_PROVIDERS, SEEDANCE_2_R2V_MAX_AUDIO_SEC_BY_PROVIDER, SEEDANCE_2_R2V_MIN_REF_VIDEO_SEC, SEEDANCE_2_REF_LIMITS, SEEDANCE_LIP_SYNC_PROVIDERS, SEED_SUPPORT, SEPARATOR_DISPLAY, SEPARATOR_PRESETS, SHEET_ASPECTS, SHEET_BACKGROUNDS, SHEET_PRESETS, SHEET_SKINS, SHEET_TYPES, SHORT_FILM_ANGLE_COUNT, SHORT_FILM_EXPRESSION_COUNT, SHORT_FILM_VARIANT_THRESHOLD_SEC, SLOT_TOKEN_RE, SMART_CUT_WINDOW_DEFAULT, SMART_CUT_WINDOW_MAX, SMART_CUT_WINDOW_MIN, SOCIAL_POST_NODE_TYPES, STAGE_PATCH_SCHEMA, STATIC_CAPTION_STYLES, STRUCTURAL_SECTIONS, STRUCTURED_VISION_MODELS, STUDIO_SHOT_TRANSIENT_KEYS, STUDIO_TRANSIENT_KEYS, SUBMISSION_STATUSES, SUNO_ADD_TRACK_MODELS, SUNO_FIELD_HANDLE_FIELDS, SUNO_HARD_CEILING, SUNO_MODELS, SUNO_SELECT_OPERATIONS, SUNO_TEXT_MAX, SUNO_TITLE_MAX, SUNO_TRACK_SOURCE_TYPES, SUNO_VERSION_PRICED_OPERATIONS, SUPPORTED_FONT_NAMES, SURROUND_DIRECTIONS, SWITCHX_BLOCK_FRAMES, SWITCHX_FRAME_TIERS, type SafetyRetryPolicy, type Scene3DAnchor, type Scene3DAssetAnimation, type Scene3DAssetKind, type Scene3DAssetRef, type Scene3DAssetRole, type Scene3DAuthoringEngine, type Scene3DCamera, type Scene3DCameraChanges, type Scene3DCameraKeyframe, type Scene3DCameraSample, type Scene3DCameraTrackV1, type Scene3DClayLighting, type Scene3DClayLightingPreset, type Scene3DEasing, type Scene3DEditErrorCode, type Scene3DEditOperation, type Scene3DEditOptions, type Scene3DEditResult, type Scene3DEngineChoice, type Scene3DEngineChoiceInput, type Scene3DEngineChoiceRefusalCode, type Scene3DEngineRequestFields, type Scene3DEntityCapability, type Scene3DEntityRole, type Scene3DEntityV2, type Scene3DEntityVisual, type Scene3DJobOutput, type Scene3DJobOutputAny, type Scene3DJobOutputV2, type Scene3DKnownEngine, type Scene3DLighting, type Scene3DLightingChanges, type Scene3DMaterialBinding, type Scene3DNormalizedAssetStats, type Scene3DObject, type Scene3DObjectChanges, type Scene3DObjectKeyframe, type Scene3DOverride, type Scene3DOverrideSpace, type Scene3DParseResult, type Scene3DPlan, type Scene3DPlanV1, type Scene3DPlanV2, type Scene3DPrimitive, type Scene3DProvenance, type Scene3DReference, type Scene3DReferenceKind, type Scene3DReferenceRole, type Scene3DSemanticIssue, type Scene3DShot, type Scene3DSupportedSchemaVersion, type Scene3DV2EditOperation, type Scene3DV2EditOptions, type Scene3DV2EditResult, type Scene3DV2OverrideInput, type Scene3DV2Primitive, type Scene3DV2ResourceUsage, type SceneData, type SceneHelperName, SceneHelperNameSchema, type SceneInputMode, SceneInputModeSchema, type SceneMetadata, SceneMetadataSchema, type SceneNodeData, SceneNodeDataSchema, SceneSpecSchema, type ScraperActorId, type ScriptCriticVerdict, ScriptCriticVerdictSchema, type ScriptProvider, type Season, type SectionKind, type SelectorConfig, type SelectorFields, type SelectorMode, type SelectorPredicateOp, type SelectorResult, type SemanticAspectRatio, type SeparatorPreset, type SharedListing, type SharedVoice, type SheetAspect, type SheetBackground, type SheetCostEstimate, type SheetEntry, type SheetFlavour, type SheetGenerationPlan, type SheetPreset, type SheetPresetId, type SheetSection, type SheetSkin, type SheetTextData, type SheetType, type ShotElement, type ShotImageElement, type ShotShapeElement, type ShotSpec, ShotSpecSchema, type ShotTextElement, type ShowrunnerPlan, ShowrunnerPlanSchema, type SidecarLoader, type SlotControlDescriptor, type SlotControlKind, type SlotVariation, type SocialMediaContentType, type SocialMediaPlatform, type SocialMediaSpec, type SortDirection, type SortListOptions, type SortType, type StageAwaitingSubGateEvent, StageAwaitingSubGateEventSchema, type StaticCaptionStyle, type StoryboardCohesionCriticVerdict, StoryboardCohesionCriticVerdictSchema, type StyleDirectives, StyleDirectivesSchema, type SubGateName, SubGateNameSchema, type SubmissionStatus, type SunoAddTrackModel, type SunoModel, type SupportedFontName, type SurroundDirection, type Swatch, T2I_TO_I2I_VARIANT, TASK_CHAINED_EDIT_PROVIDERS, TEXT_TO_AUDIO_PROVIDERS, TEXT_TO_VIDEO_PROVIDERS, TIER_MAX_PIPELINE_COST_CREDITS, TIER_PIPELINE_PARALLELISM, TILT_CARRIED_FRACTION, TOPAZ_DEFAULT_UPSCALE_FACTOR, TOPAZ_UPSCALE_FACTORS, TRANSCRIBE_PROVIDERS, TRANSIENT_RUNTIME_KEYS, TTS_PROVIDERS, TTS_TEXT_MAX, TWO_K_RESOLUTION_PROVIDERS, type TextToAudioProvider, type TextToVideoProvider, type TopazUpscaleAdjustment, type TopazUpscaleFactor, type TopazUpscaleResolution, type TranscribeProvider, type TransitionType, TransitionTypeSchema, type TrimVideoEstimatorInput, type TtsProvider, UPSCALE_IMAGE_PROVIDERS, USAGE_GROUP_BYS, USAGE_MODES, type UpscaleImageProvider, type UsageGroupBy, type UsageLogEntry, type UsageMode, type UsageQuery, type UsageReport, type UsageReportRow, type UsageReportTotals, type UsageVarianceRow, VARIABLES_HANDLE_ID, VARIABLE_PRICING_MODELS, VEHICLES, VEHICLE_SUBCATEGORY_LABELS, VEHICLE_SUBCATEGORY_ORDER, VEO_PROVIDERS, VIDEO_ANALYSIS_AUDIO_MODES, VIDEO_ANALYSIS_BUCKET_CREDITS, VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN, VIDEO_ANALYSIS_DEFAULT_VARIATION, VIDEO_ANALYSIS_DURATION_BUCKETS, VIDEO_ANALYSIS_DURATION_TOLERANCE_SEC, VIDEO_ANALYSIS_ENTITY_SOURCES, VIDEO_ANALYSIS_FACELESS_ANGLES, VIDEO_ANALYSIS_LEGACY_MODELS, VIDEO_ANALYSIS_LLM_MODELS, VIDEO_ANALYSIS_MAX_DURATION_SEC, VIDEO_ANALYSIS_MAX_SCENE_SEC, VIDEO_ANALYSIS_MAX_VARIATIONS, VIDEO_ANALYSIS_MIXED_TIERS, VIDEO_ANALYSIS_SHOT_ANGLES, VIDEO_ANALYSIS_SPEED_EFFECTS, VIDEO_ANALYSIS_STORY_JUMPS, VIDEO_ANALYSIS_TEXT_KINDS, VIDEO_ANALYSIS_TIERS, VIDEO_ANALYSIS_TIER_LABELS, VIDEO_ANALYSIS_TIER_ORDER, VIDEO_ANALYSIS_TIMES_OF_DAY, VIDEO_ANALYSIS_TRANSITIONS, VIDEO_ANALYSIS_VARIATION_SLUGS, VIDEO_ANALYSIS_VISUAL_EFFECTS, VIDEO_ANALYSIS_WINDOW, VIDEO_AUDIO_CAPABILITY, VIDEO_AUDIT_BUCKET_CREDITS, VIDEO_CLIP_CREDITS, VIDEO_CRITIC_CREDITS_PER_SHOT, VIDEO_CRITIC_FRAME_MODES, VIDEO_CRITIC_MAX_RETRIES, VIDEO_CRITIC_METADATA_KEYS, VIDEO_CRITIC_MIN_ADHERENCE_SCORE, VIDEO_DURATION_TIERS, VIDEO_GEN_COLLAPSED_T2V_IDS, VIDEO_GEN_PROVIDERS, VIDEO_INPUT_LIP_SYNC_PROVIDERS, VIDEO_MODEL_CAPS, VIDEO_MODE_ALIASES, VIDEO_PRODUCER_TYPES, VIDEO_PROMPT_MAX, VIDEO_PROVIDERS_REQUIRING_IMAGE, VIDEO_PROVIDERS_WITHOUT_DISPATCH, VIDEO_REF_LIMITS_BY_PROVIDER, VIDEO_REF_VIDEO_DURATION_LIMITS, VIDEO_TO_VIDEO_PROVIDERS, VIDEO_UPSCALE_PROVIDERS, VIDEO_UTIL_PRICING, VIDEO_VARIABLE_PRICING, VOICE_CHANGER_MODELS, VOICE_CHANGER_MODEL_IDS, VOICE_DESIGN_MODELS, type ValidateMatchCutInput, ValidateMatchCutInputSchema, type ValidateMatchCutResult, ValidateMatchCutResultSchema, type ValidationField, type Vec3, type Vehicle, type VehicleSubcategory, type VideoAnalysisAudioMode, type VideoAnalysisClipTransitionIn, type VideoAnalysisEntitySource, type VideoAnalysisMixedTier, type VideoAnalysisModelTier, type VideoAnalysisResult, type VideoAnalysisShotAngle, type VideoAnalysisSpeedEffect, type VideoAnalysisTextKind, type VideoAnalysisTier, type VideoAnalysisTransition, type VideoAnalysisVisualEffect, type VideoAudioCapability, type VideoAudioMode, type VideoClipCost, type VideoCriticFrameMode, type VideoCriticMetadataKey, type VideoCriticShotFields, type VideoCriticVerdict, VideoCriticVerdictSchema, type VideoGenProvider, type VideoModeAlias, type VideoModelCapabilities, type VideoToVideoProvider, type VideoUpscaleProvider, type Voice, type VoiceChangerModel, type VoiceClone, type VoiceDesignModel, type VoiceLibraryParams, type VoiceLibraryResponse, type VoiceMatch, VoiceMatchSchema, type VoiceType, WAN_3_DEFAULT_RESOLUTION, WAN_3_PROVIDERS, WARDROBE_VARIANTS, WEAPONS, WEAPON_SUBCATEGORY_LABELS, WEAPON_SUBCATEGORY_ORDER, WORKFLOW_VISIBILITIES, WORKSPACE_HEADER, WORKSPACE_HEADER_LOWER, WORKSPACE_ROLES, type Weapon, type WeaponSubcategory, type WindowAnalysis, type WindowScene, type WorkflowAssetKind, type WorkflowExport, type WorkflowExportCharacter, type WorkflowExportCreature, type WorkflowExportLocation, type WorkflowExportObject, type WorkflowImportReport, type WorkflowImportSkippedAsset, type WorkflowMediaRef, type WorkflowPortability, type WorkflowVisibility, type WorkspaceMemberView, type WorkspaceRole, type WorkspaceSettings, WorkspaceSettingsSchema, type WorkspaceSummary, type WorkspaceView, aggregateByType, aiAvatarReserveCreditId, analyzedSceneSchema, applyDefaultVideoSelection, applyHandleInputOverride, applyRange, applyRangeIndices, applyScene3DEditOperations, applyScene3DV2EditOperations, applySlots, applyVideoAudioToggle, applyVideoNegativePrompt, aspectRatioFromDims, aspectRatioOptionsByKind, aspectRatioToNumber, assembleNarratedVideoCredits, availableReasoningEfforts, bucketSecondsFromAuditCreditId, bucketSecondsFromCreditId, buildBoardPrompt, buildChildrenByParent, buildConditionVariables, buildCreditModelIdentifier, buildExpressionFromVisual, buildLipSyncCreditId, buildLlmCreditIdentifier, buildModelMenu, buildModelTree, buildMotionCreditModelIdentifier, buildNodePresetExport, buildPanelPrompt, buildPro3DRenderSource, buildProgressSegments, buildRangeLabel, buildScraperCreditId, buildVideoAnalysisCreditId, buildVideoAuditCreditId, buildVideoCreditModelIdentifier, calculateCombinedProgress, calculateMonetizationMarkup, calculateMonetizedCost, calculateProgress, canonicalScene3DPlanV2Json, canonicalVarName, characterBoardItems, characterBucketDisplayRank, characterMentionSlug, characterMentionableAssetArrays, characterSheetRefItems, characterVariantAssetArrays, checkRefVideoDurations, cinematicCreditId, clampCinematicDuration, clampSmartCutWindow, classifyRefToken, cleanOrphanedItems, clearImageCriticMetadata, clearVideoCriticMetadata, clipLookSchema, collectAncestorRefs, combineSameLabelRefs, computeAggregateLanes, computeScene3DPlanV2ContentHash, countRefModalityEdges, creditRangesAll, creditsToUsd, decodeProviderItem, defaultCarriedFraction, defaultResolutionFor, defaultRoleForSource, defaultVideoAspectRatio, deriveLinkedFields, deriveLottieSlotFields, deriveSlotRefs, describeEdgeBehavior, describeMaskRegion, describeNodeAdjustments, describeSlotControl, dropUnknownBindings, dropUnknownSpeakers, durationsByMode, effectiveReasoningEffort, encodeProviderItem, ensureLocaleCatalogLoaded, entityHydrationColumns, entityMentionSlug, entityMentionSlugForRef, entityScalarFields, entitySlotSchema, entryMatchesQuery, estimateCombineVideosCredits, estimateFilmCredits, estimateLoopTrimAddonCredits, estimateLoopVideoCredits, estimateScriptDurationSec, estimateSheetCost, estimateTrimVideoCredits, evaluateCondition, evaluateConditionGroup, evaluateJsonExpression, evaluateJsonPath, expandExtraRefsToConnectedReferences, expandItemsWithRepeat, extractAllGeneratedResults, extractCharacterLoraFields, extractGeneratedJsonAsList, extractPresetData, extractReferencedLabels, extractVideoDurationFromNode, fieldKeyFromHandle, filterCloneNodes, findCharacterMentionTokens, findEntityMentionTokens, findImageMentionTokens, findLocationMentionTokens, findSeedance2AudioOverLimit, firstSightExtraRole, flattenItems, getAnimal, getAnimalLabel, getAnimalPromptHint, getAnimalTerm, getAspectRatioOptions, getAudioCrossfadeCurve, getCharacterFacet, getCombineTransition, getCreditRange, getDurationsForModel, getEffectiveRepeatCount, getFeaturedEntities, getFurniture, getFurnitureLabel, getInputFieldSchema, getInputNodes, getItemSortId, getLipSyncMaxAudioSeconds, getLlmModalityCaps, getLlmModel, getLlmTier, getLocaleDirection, getMaxImagePromptChars, getMaxNegativePromptChars, getMaxSunoPromptChars, getMaxSunoStyleChars, getMaxTtsChars, getMaxVideoPromptChars, getModel, getNodeLabel, getNodeResult, getOutputNodes, getOutputType, getParameterValue, getQualityOptions, getResolutionOptions, getRouteReachableNodeIds, getStrategy, getTargetField, getValidValues, getVehicle, getVehicleLabel, getVideoAudioCapability, getWeapon, getWeaponLabel, groupByFamily, groupHandleId, groupLlmModelsByVendor, hasContiguousSegmentDurations, hasFeature, hexToRgbaArray, humanizeSlotSid, imageMentionSlug, imageMentionSlugForRef, imageReferenceLimit, inferMusicVideo, isAggregateableType, isCharacterAspectRatio, isCollectInEdge, isDefaultSelectorConfig, isExpandedClone, isFlux2Model, isGeminiOmniProvider, isGvpSupportedProvider, isHandleInputWired, isKineticCaptionStyle, isKnownScene3DEngine, isLocationUsageMode, isMinimaxH3Provider, isObjectAspectRatio, isOversizedScene, isPaygRetentionActive, isPerSecondLipSyncProvider, isPro3DRenderJobOutput, isPro3DRenderQuote, isPro3DRenderRenderOnly, isScene3DAuthoringEngine, isScene3DCameraTrack, isScene3DHttpUrl, isScene3DPlan, isScene3DPlanV1, isScene3DPlanV2, isScene3DSchemaVersionSupported, isScraperActor, isSeedance2Provider, isTiltDirection, isUsageMode, isVeoProvider, isVideoAnalysisMixedTier, isVideoAnalysisTier, isWan3Provider, jsonResultToList, knownEntitySlugsFromRefs, knownImageSlugsFromRefs, listBoardTemplates, listModels, listSlotSids, llmRouteDefaults, locationMentionSlug, locationReferencePhotoKindLabel, locationUsageModeLabel, mapAspectRatio, mapQuality, mapShotIntentToProviderDirectives, matchVariant, maxSegmentSecFor, maxSegmentsFor, mergeClipLook, mergeExposedSettings, migrateEdgeOutputMode, migrateToItems, minSegmentSecFor, modelIdsByKindMode, modelToNodeTarget, modelsForInputMode, modelsWithFeature, motionGraphicsFeature, newScene3DRevisionId, normalizeLottieLayers, normalizeMinimaxH3Resolution, normalizeModelInput, normalizeNodeModelParams, normalizePinterestUrl, normalizeRoleSlug, normalizeVideoRequestParams, normalizeWan3Resolution, orderedLlmModels, parseAttributedDialogue, parseCharacterMentionToken, parseEntityMentionToken, parseGroupHandle, parseHandleId, parseImageMentionToken, parseListExpression, parseLocationMentionToken, parseNodePresetExport, parseNodeRef, parseScene3DCameraTrackJson, parseScene3DPlanV2Json, pickAiAvatarBucket, pickIds, pickLipSyncBucket, pickSwitchXFrameTier, pickVideoAnalysisBucket, planSheetGeneration, planSheetPanels, preferredInputModeForModel, presentTypes, presetApplyClearKeys, presetDataMatches, presetEntries, pricedVideoSelection, pro3DRenderCoreOutputSchema, pro3DRenderJobOutputSchema, pro3DRenderProducedSchemaVersion, pro3DRenderQuoteSchema, pro3DRenderTimingOverrides, qualityOptionsByKind, readPromptAffixes, refHandleCategory, referenceModalityForHandle, referenceSheetCreditId, registerCatalogSidecars, registerSidecarLoaders, renderAnalyzedScene, resetCatalogSidecars, resolutionOptionsByKind, resolveAiAvatarCreditId, resolveAudioCrossfadeCurve, resolveCharacterAspectRatio, resolveCinematicCreditId, resolveConditionValue, resolveDefaultRole, resolveDescription, resolveDialogueVoices, resolveEffectiveSourceType, resolveEffectiveTier, resolveEntityAspect, resolveFieldMappings, resolveGvpAnchorWire, resolveImageGenCreditIdentifier, resolveIndex, resolveLabel, resolveListExpression, resolveLlmCreditId, resolveLocationFields, resolveLocationPresetCatalog, resolveLottieOverlaySrc, resolveNodeRefs, resolveNormalizedImageGen, resolveObjectAspectRatio, resolvePipelineModel, resolveRelativeWindowToken, resolveScene3DAuthoringEngine, resolveScraperCreditId, resolveSelectorRefs, resolveSeparator, resolveSheetSections, resolveSlideshowTransition, resolveSourceThroughConnectedList, resolveStoredTier, resolveSwitchXCreditId, resolveTopazUpscale, resolveVideoAnalysisModel, resolveVideoModeForInputs, resolveVideoProviderForMode, resolveXfadeName, rewriteSceneBindings, rewriteSlotTokens, rewriteSpeakerSlots, rgbaArrayToHex, roleToPhrase, rotationVec3Schema, runSelector, safetyRetryPolicy, sanitizeRole, scaleVec3Schema, scene3DAcceptedSchemaVersionsSchema, scene3DAnchorNameSchema, scene3DAnchorSchema, scene3DAnyPlanSchema, scene3DAssetAnimationSchema, scene3DAssetIdSchema, scene3DAssetRefSchema, scene3DCameraChangesSchema, scene3DCameraKeyframeSchema, scene3DCameraSampleSchema, scene3DCameraSchema, scene3DCameraTrackIssues, scene3DCameraTrackObjectSchema, scene3DCameraTrackPlanIssues, scene3DCameraTrackSchema, scene3DClayLightingSchema, scene3DColorSchema, scene3DDeepEqual, scene3DEasingSchema, scene3DEditOperationSchema, scene3DEditOperationsSchema, scene3DEngineIdSchema, scene3DEntityAcceptsOverlay, scene3DEntityCapabilitySchema, scene3DEntityV2Schema, scene3DEntityVisualSchema, scene3DIdSchema, scene3DJsonByteLength, scene3DLightingChangesSchema, scene3DLightingSchema, scene3DMaterialBindingSchema, scene3DMaterialNameSchema, scene3DMaterialRoleSchema, scene3DNodeIdSchema, scene3DObjectChangesSchema, scene3DObjectKeyframeSchema, scene3DObjectSchema, scene3DOverrideSchema, scene3DPlanIssues, scene3DPlanSchema, scene3DPlanSchemaVersion, scene3DPlanV1Issues, scene3DPlanV1ObjectSchema, scene3DPlanV1Schema, scene3DPlanV2Issues, scene3DPlanV2ObjectSchema, scene3DPlanV2Schema, scene3DPrimitiveSchema, scene3DProjectionIssues, scene3DProvenanceSchema, scene3DReferenceSchema, scene3DSampleForFrame, scene3DSha256Schema, scene3DShotForFrame, scene3DShotIndexForFrame, scene3DShotSchema, scene3DUrlSchema, scene3DV2AdmissionIssues, scene3DV2EditOperationSchema, scene3DV2EditOperationsSchema, scene3DV2HierarchyDepth, scene3DV2NormalizationIssues, scene3DV2OverrideInputSchema, scene3DV2ResourceUsage, scene3DVersionTokenSchema, scene3DZodIssues, searchModelVariants, seedance2AudioLimitSec, segmentDurationsFor, selectByModulo, selectByNamedKey, selectByPredicate, selectListItems, selectLoraRoutingForMentions, selectRandom, setRegisteredPersonPackFields, settledWithLimit, sizeVec3Schema, slotVariationSchema, sortCharacterEntriesForDisplay, sortListItems, sourceRefKey, spliceDelimitedRows, splitByLoopDelimiter, splitGeneratedItems, spreadJsonArrayIfSingleton, stringifyPathResults, stripDerivedAnalysisFields, stripExportContent, stripStudioTransientSettings, stripTransientRuntimeData, summarizeScene3DOperations, sunoCreditType, supportedDefaultDimensions, supportsAdvancedMode, supportsEndAnchor, supportsExtendRender, toConnectedReference, toConnectedReferences, togglePick, tryParseJson, uiAspectRatioFill, uiDurationFill, uiResolutionFill, unresolvedRefTokens, unwrapUnresolvedTokens, usageModeDirective, usageModeIncludesName, usageModeLabel, usdToCredits, validateAiAvatarPayload, validateCinematicAvatarPayload, validateDurationForFormat, validateModeActivation, validateModelInput, validateNoNestedGroups, validateObjects, validateProviderForNodeType, validateSubWorkflowRoutes, variantJobId, vec3Schema, verifyScene3DPlanV2ContentHash, videoAnalysisCreditSegment, videoAnalysisNumWindows, videoAnalysisResultSchema, videoAuditCreditsForBucket, videoModelCanSpeakDialogue, videoModelSupportsAudio, videoNegativeSuffix, videoProviderFoldsLoneEndFrame, videoProviderRequiresImage, windowAnalysisSchema, zipMergeLists };