@nodaro/shared 2.26.0 → 3.0.0

package/dist/index.d.cts

@@ -3065,7 +3065,7 @@ declare function groupLlmModelsByVendor(models?: readonly LlmModelDef[]): LlmMod
  *  group headers (e.g. the compact node quick strips) but should still read
  *  vendor-clustered and tier-ordered. */
 declare function orderedLlmModels(models?: readonly LlmModelDef[]): LlmModelDef[];
-type LlmFeature = "ai-writer" | "llm-chat" | "prompt-helper" | "scene-graph-ai" | "after-effects" | "motion-graphics" | "motion-graphics-lottie" | "lottie-overlay" | "3d-title" | "image-to-text" | "describe-to-picker" | "qa-check" | "generate-script" | "translate" | "image-critic" | "pick-best-llm" | "workflow-copilot";
+type LlmFeature = "ai-writer" | "llm-chat" | "prompt-helper" | "scene-graph-ai" | "after-effects" | "motion-graphics" | "motion-graphics-lottie" | "lottie-overlay" | "3d-title" | "3d-scene" | "image-to-text" | "describe-to-picker" | "qa-check" | "generate-script" | "translate" | "image-critic" | "pick-best-llm" | "workflow-copilot";
 /** Engine-dependent LlmFeature for the motion-graphics node (design §8: every credit-id site must branch on engine). */
 declare function motionGraphicsFeature(engine?: string): LlmFeature;
 /** Feature → default model when user hasn't selected one */
@@ -11830,6 +11830,2482 @@ declare function entityHydrationColumns(kind: EntityNodeKind): string[];
 /** Every scalar `kind` actually has, shared plus its own. */
 declare function entityScalarFields(kind: EntityNodeKind): ReadonlyArray<readonly [string, string]>;
 
+/**
+ * Scene3D previsualization — the frozen wire contract (v1).
+ *
+ * ONE validated `Scene3DPlan` revision is shared by four consumers that must
+ * never disagree about what a scene IS: the authoring LLM jobs
+ * (`backend/src/routes/3d-scene.ts` + its worker), the browser preview and the
+ * frame-deterministic Remotion export (`packages/remotion`), the canvas
+ * (`frontend/`), and the SDK/MCP surface. Everything here is STRUCTURE —
+ * geometry, timing, identity, validation. No creative prompts, no provider
+ * names, no pricing: those live in the backend (see the IP-placement rule in
+ * the repo CLAUDE.md — this package is published Apache-2.0 and every
+ * published version is an irrevocable grant).
+ *
+ * ## World conventions (fixed for v1, relied on by the renderer)
+ *
+ * - Units are METERS, Y is up, right-handed (Three.js default).
+ * - Rotations are Euler angles in RADIANS applied XYZ.
+ * - Frames are ZERO-BASED; `fps` defaults to 24 at the authoring layer.
+ * - Interpolation between keyframes is deterministic and closed-form:
+ *   `linear` or `easeInOut` (smoothstep). There is no spring, no physics and
+ *   no randomness — the browser preview and the export MUST agree frame for
+ *   frame, so nothing here may depend on wall-clock time or a RNG.
+ * - A channel's BASE value (the object's/camera's own `position`/`rotation`/
+ *   `scale`/`target`/`focalLengthMm`) behaves as an implicit keyframe at frame
+ *   0. So a track whose first key is at frame 30 INTERPOLATES from the base
+ *   value at frame 0 to that key — it does not hold the base and then jump.
+ *   Author a real key at frame 0 when you want a hold. Before frame 0 and
+ *   after the last key the nearest key's value is held.
+ * - `easing` belongs to the DESTINATION keyframe: the easing named on a key
+ *   governs the segment ENDING at it. The easing on the first key therefore
+ *   governs base → first key; a key's own easing never affects the segment
+ *   leaving it.
+ *   Sampling itself lives with the renderer (`packages/remotion`) — this file
+ *   only guarantees the data it samples is well-formed.
+ *
+ * ## Revisions
+ *
+ * A plan is IMMUTABLE. Every accepted edit produces a NEW `revisionId` and
+ * records the one it came from in `parentRevisionId`; the input object is
+ * never mutated (deep-copied before any write). That is what lets an
+ * asynchronous job completion be REJECTED when the canvas has moved on — the
+ * completion carries the parent it was computed from.
+ */
+
+/** Discriminates a Scene3D plan from every other composer plan on the wire. */
+declare const SCENE3D_PLAN_TYPE = "3d-scene";
+/** Bumped only for a BREAKING change to the shape below. */
+declare const SCENE3D_SCHEMA_VERSION = 1;
+/** Frames per second an authoring request gets when it does not say. */
+declare const SCENE3D_DEFAULT_FPS = 24;
+/** Seconds a generate request gets when it does not say. */
+declare const SCENE3D_DEFAULT_DURATION_SECONDS = 4;
+/**
+ * Every bound in one object so the route Zod, the canvas inputs, the LLM
+ * draft schema and the docs quote the SAME numbers. Widening one of these is
+ * a contract change, not a tweak.
+ */
+declare const SCENE3D_LIMITS: {
+    readonly minDimensionPx: 100;
+    readonly maxDimensionPx: 1920;
+    readonly minFps: 15;
+    readonly maxFps: 60;
+    readonly minDurationInFrames: 1;
+    readonly maxDurationInFrames: 3600;
+    /** Shortest scene an authoring request may ask for, in seconds. One second
+     *  is the frozen v1 floor the SDK/MCP surface and the public docs state; the
+     *  route Zod and the canvas path both quote it from here so they cannot
+     *  drift below it. */
+    readonly minDurationSeconds: 1;
+    /** Hard ceiling on wall-clock length, checked against fps × frames. */
+    readonly maxDurationSeconds: 60;
+    readonly minObjects: 1;
+    readonly maxObjects: 100;
+    /** Per-object and per-camera track length. */
+    readonly maxKeyframes: 240;
+    readonly maxReferences: 8;
+    readonly maxOperations: 100;
+    /** |x|, |y|, |z| ceiling for positions and camera/target coordinates. */
+    readonly maxCoordinate: 1000;
+    readonly minSize: 0.001;
+    readonly maxSize: 1000;
+    readonly minScale: 0.001;
+    readonly maxScale: 1000;
+    readonly minFocalLengthMm: 10;
+    readonly maxFocalLengthMm: 200;
+    readonly defaultSensorWidthMm: 36;
+    readonly minSensorWidthMm: 1;
+    readonly maxSensorWidthMm: 200;
+    readonly maxIntensity: 100;
+    /** How deep a parent chain may nest. Bounds the renderer's transform walk. */
+    readonly maxHierarchyDepth: 8;
+    readonly maxIdLength: 64;
+    readonly maxNameLength: 120;
+    readonly maxUrlLength: 2048;
+    readonly maxChangeSummaryLength: 2000;
+};
+type Vec3 = [number, number, number];
+type Scene3DPrimitive = "box" | "sphere" | "cylinder" | "cone" | "plane" | "capsule"
+/** A transform-only node: no geometry of its own, children inherit it. */
+ | "group";
+declare const SCENE3D_PRIMITIVES: readonly Scene3DPrimitive[];
+type Scene3DEasing = "linear" | "easeInOut";
+type Scene3DReferenceKind = "image" | "video";
+/**
+ * What the reference is FOR. The role is not decoration: it decides how the
+ * authoring backend conditions on the asset (appearance → colour/material
+ * cues, layout → placement, motion → timing), and it is stored with the job
+ * so a re-run reproduces the same conditioning.
+ */
+type Scene3DReferenceRole = "appearance" | "layout" | "motion";
+interface Scene3DObjectKeyframe {
+    /** Zero-based, integral, inside the scene's duration. */
+    frame: number;
+    position?: Vec3;
+    rotation?: Vec3;
+    scale?: Vec3;
+    easing?: Scene3DEasing;
+}
+interface Scene3DCameraKeyframe {
+    frame: number;
+    position?: Vec3;
+    target?: Vec3;
+    focalLengthMm?: number;
+    easing?: Scene3DEasing;
+}
+interface Scene3DObject {
+    id: string;
+    name: string;
+    primitive: Scene3DPrimitive;
+    /** Transform parent. Absent = a root object. Cycles are rejected. */
+    parentId?: string;
+    /** Intrinsic size in meters BEFORE `scale` (width/height/depth). */
+    dimensions: Vec3;
+    position: Vec3;
+    /** Euler XYZ, radians. */
+    rotation: Vec3;
+    scale: Vec3;
+    /** `#rgb`, `#rgba`, `#rrggbb` or `#rrggbbaa`. */
+    color: string;
+    keyframes?: Scene3DObjectKeyframe[];
+}
+interface Scene3DCamera {
+    position: Vec3;
+    target: Vec3;
+    focalLengthMm: number;
+    /** Full-frame 36mm by default; together with focal length it fixes the FOV. */
+    sensorWidthMm: number;
+    keyframes?: Scene3DCameraKeyframe[];
+}
+interface Scene3DLighting {
+    ambientIntensity: number;
+    keyIntensity: number;
+    keyPosition: Vec3;
+}
+interface Scene3DReference {
+    id: string;
+    /** HTTP(S) only — the BACKEND additionally applies `safeUrlSchema` and the
+     *  platform's per-model reference limits before anything is fetched. */
+    url: string;
+    kind: Scene3DReferenceKind;
+    role: Scene3DReferenceRole;
+    /** Scopes the reference to one object instead of the whole scene. */
+    objectId?: string;
+    /** Window inside a video reference, in seconds. */
+    startSeconds?: number;
+    endSeconds?: number;
+}
+/**
+ * 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. */
+    revisionId: string;
+    /** The revision this one was derived from; absent on a first generation. */
+    parentRevisionId?: string;
+    width: number;
+    height: number;
+    fps: number;
+    durationInFrames: number;
+    backgroundColor: string;
+    camera: Scene3DCamera;
+    objects: Scene3DObject[];
+    lighting: Scene3DLighting;
+    references?: Scene3DReference[];
+}
+declare const vec3Schema: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+declare const sizeVec3Schema: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+declare const scaleVec3Schema: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+/** Euler radians. Bounded well past ±2π so multi-turn spins stay expressible
+ *  while a runaway value still cannot reach the renderer. */
+declare const rotationVec3Schema: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+declare const scene3DColorSchema: z.ZodString;
+declare const scene3DIdSchema: z.ZodString;
+/** HTTP(S) only. This is the STRUCTURAL half of URL safety; the backend adds
+ *  `safeUrlSchema` (SSRF host rules) on top before anything is fetched. */
+declare function isScene3DHttpUrl(value: string): boolean;
+declare const scene3DUrlSchema: z.ZodString;
+declare const scene3DEasingSchema: z.ZodEnum<{
+    linear: "linear";
+    easeInOut: "easeInOut";
+}>;
+declare const scene3DPrimitiveSchema: z.ZodEnum<{
+    group: "group";
+    box: "box";
+    sphere: "sphere";
+    cylinder: "cylinder";
+    cone: "cone";
+    plane: "plane";
+    capsule: "capsule";
+}>;
+declare const scene3DObjectKeyframeSchema: 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>;
+declare const scene3DCameraKeyframeSchema: 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>;
+declare const scene3DObjectSchema: 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>;
+declare const scene3DCameraSchema: 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>;
+declare const scene3DLightingSchema: z.ZodObject<{
+    ambientIntensity: z.ZodNumber;
+    keyIntensity: z.ZodNumber;
+    keyPosition: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+}, z.core.$strict>;
+declare const scene3DReferenceSchema: 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>;
+/** 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.
+ *
+ * Split out of the schema's `superRefine` so `applyScene3DEditOperations` can
+ * report the SAME sentences without re-parsing, and so a caller holding an
+ * already-parsed plan can re-check it cheaply.
+ */
+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>;
+    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 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).
+ *  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: Scene3DPlanV1;
+    /** One paragraph naming what changed. Absent on a first generation. */
+    changeSummary?: string;
+}
+/** The node data field a Scene3D plan is stored under, on both nodes.
+ *  `COMPOSER_PLAN_MAP` (model-constants.ts) must agree with this. */
+declare const SCENE3D_PLAN_FIELD = "scenePlan";
+/** The two canvas node types that produce a Scene3D plan. */
+declare const SCENE3D_GENERATE_NODE_TYPE = "generate-3d-scene";
+declare const SCENE3D_EDIT_NODE_TYPE = "edit-3d-scene";
+
+/**
+ * Scene3D edit operations — the ONLY way a Scene3D plan changes.
+ *
+ * Split out of `scene3d.ts` (which owns the shape) because this file owns the
+ * TRANSITION: given a plan, a list of operations and the caller's locks, it
+ * produces the next immutable revision or an explained refusal. Both edit
+ * lanes go through it — the deterministic one (the caller sent operations) and
+ * the instruction one (an LLM authored the operations from a sentence) — so
+ * locks, staleness and whole-scene validation cannot be enforced twice and
+ * differently. The model never writes a plan and never writes code; it writes
+ * operations that this function is free to refuse.
+ */
+
+/** Everything about an object EXCEPT its identity. `id` is deliberately absent
+ *  (and the schema is strict) so no operation can rename an object out from
+ *  under a lock, a parent link or a reference. */
+declare const scene3DObjectChangesSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    primitive: z.ZodOptional<z.ZodEnum<{
+        group: "group";
+        box: "box";
+        sphere: "sphere";
+        cylinder: "cylinder";
+        cone: "cone";
+        plane: "plane";
+        capsule: "capsule";
+    }>>;
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dimensions: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    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>>;
+    color: z.ZodOptional<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>;
+declare const scene3DCameraChangesSchema: z.ZodObject<{
+    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>;
+    sensorWidthMm: z.ZodOptional<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>;
+declare const scene3DLightingChangesSchema: z.ZodObject<{
+    ambientIntensity: z.ZodOptional<z.ZodNumber>;
+    keyIntensity: z.ZodOptional<z.ZodNumber>;
+    keyPosition: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+}, z.core.$strict>;
+declare const scene3DEditOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"set-object">;
+    objectId: z.ZodString;
+    changes: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        primitive: z.ZodOptional<z.ZodEnum<{
+            group: "group";
+            box: "box";
+            sphere: "sphere";
+            cylinder: "cylinder";
+            cone: "cone";
+            plane: "plane";
+            capsule: "capsule";
+        }>>;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        dimensions: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        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>>;
+        color: z.ZodOptional<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>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"add-object">;
+    object: 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>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"remove-object">;
+    objectId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"set-camera">;
+    changes: z.ZodObject<{
+        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>;
+        sensorWidthMm: z.ZodOptional<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>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"set-lighting">;
+    changes: z.ZodObject<{
+        ambientIntensity: z.ZodOptional<z.ZodNumber>;
+        keyIntensity: z.ZodOptional<z.ZodNumber>;
+        keyPosition: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"set-background">;
+    color: z.ZodString;
+}, z.core.$strict>], "op">;
+declare const scene3DEditOperationsSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"set-object">;
+    objectId: z.ZodString;
+    changes: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        primitive: z.ZodOptional<z.ZodEnum<{
+            group: "group";
+            box: "box";
+            sphere: "sphere";
+            cylinder: "cylinder";
+            cone: "cone";
+            plane: "plane";
+            capsule: "capsule";
+        }>>;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        dimensions: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        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>>;
+        color: z.ZodOptional<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>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"add-object">;
+    object: 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>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"remove-object">;
+    objectId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"set-camera">;
+    changes: z.ZodObject<{
+        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>;
+        sensorWidthMm: z.ZodOptional<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>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"set-lighting">;
+    changes: z.ZodObject<{
+        ambientIntensity: z.ZodOptional<z.ZodNumber>;
+        keyIntensity: z.ZodOptional<z.ZodNumber>;
+        keyPosition: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"set-background">;
+    color: z.ZodString;
+}, z.core.$strict>], "op">>;
+type Scene3DObjectChanges = z.infer<typeof scene3DObjectChangesSchema>;
+type Scene3DCameraChanges = z.infer<typeof scene3DCameraChangesSchema>;
+type Scene3DLightingChanges = z.infer<typeof scene3DLightingChangesSchema>;
+type Scene3DEditOperation = z.infer<typeof scene3DEditOperationSchema>;
+type Scene3DEditErrorCode = 
+/** `expectedRevisionId` did not match the plan handed in. */
+"stale_revision"
+/** The operation list itself is malformed or over the cap. */
+ | "invalid_operations"
+/** An operation targets an object that is not in the scene. */
+ | "unknown_object"
+/** `add-object` collided with an existing id. */
+ | "duplicate_object"
+/** An operation touched an id the caller declared locked. */
+ | "locked_object"
+/** The plan handed in, or the plan the operations produced, is invalid. */
+ | "invalid_plan";
+interface Scene3DEditOptions {
+    /** Optimistic concurrency: reject unless the plan is still this revision. */
+    expectedRevisionId?: string;
+    /** Object ids the caller declared untouchable. Enforced as a POST-condition
+     *  (see `applyScene3DEditOperations`), which is what makes it total. */
+    lockedObjectIds?: readonly string[];
+    /** Pin the produced revision id — tests and deterministic replay only. */
+    revisionId?: string;
+}
+type Scene3DEditResult = {
+    ok: true;
+    plan: Scene3DPlanV1;
+    changedObjectIds: string[];
+    changeSummary: string;
+} | {
+    ok: false;
+    code: Scene3DEditErrorCode;
+    message: string;
+    operationIndex?: number;
+};
+/** One human sentence per operation — the deterministic lane's answer to the
+ *  LLM lane's `changeSummary`, so both edit paths return the same shape. */
+declare function summarizeScene3DOperations(operations: readonly Scene3DEditOperation[]): string;
+/**
+ * Apply an operation list to a plan, producing a NEW revision.
+ *
+ * Guarantees, in this order — each one is a distinct failure mode that was
+ * cheap to get wrong:
+ *
+ * 1. The input plan is never mutated (deep clone before the first write).
+ * 2. A stale `expectedRevisionId` is refused before anything is applied, so a
+ *    late async completion can never overwrite a newer manual edit.
+ * 3. Operations are schema-validated as a list; the failing INDEX is reported.
+ * 4. Locks are enforced as a POST-CONDITION — every locked object must still
+ *    exist and be deep-equal to the original. Reasoning per-operation would
+ *    have to anticipate remove + re-add, a reparent from a sibling's `set-
+ *    object`, and whatever the next operation kind turns out to be; the
+ *    post-condition covers all of them by construction. (`selectedObjectIds`
+ *    is CONTEXT for the model, never permission — the caller passes locks
+ *    explicitly and they are checked here, after the model has spoken.)
+ * 5. The WHOLE resulting plan is re-validated, which is what makes "no silent
+ *    orphaning" free: removing a parent leaves a dangling `parentId` and the
+ *    plan validator rejects it, as does removing an object a reference points
+ *    at.
+ */
+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 parts of `settings.studio` that must not leave the owner's account.
  *
@@ -11893,4 +14369,120 @@ declare const STUDIO_SHOT_TRANSIENT_KEYS: readonly ["pendingClips", "pendingClip
  */
 declare function stripStudioTransientSettings(settings: unknown): unknown;
 
-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, 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 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 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, 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, 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, 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, runSelector, safetyRetryPolicy, sanitizeRole, searchModelVariants, seedance2AudioLimitSec, segmentDurationsFor, selectByModulo, selectByNamedKey, selectByPredicate, selectListItems, selectLoraRoutingForMentions, selectRandom, setRegisteredPersonPackFields, settledWithLimit, slotVariationSchema, sortCharacterEntriesForDisplay, sortListItems, sourceRefKey, spliceDelimitedRows, splitByLoopDelimiter, splitGeneratedItems, spreadJsonArrayIfSingleton, stringifyPathResults, stripDerivedAnalysisFields, stripExportContent, stripStudioTransientSettings, stripTransientRuntimeData, 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, videoAnalysisCreditSegment, videoAnalysisNumWindows, videoAnalysisResultSchema, videoAuditCreditsForBucket, videoModelCanSpeakDialogue, videoModelSupportsAudio, videoNegativeSuffix, videoProviderFoldsLoneEndFrame, videoProviderRequiresImage, windowAnalysisSchema, zipMergeLists };
+/** 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>;
+
+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_ASSET_KINDS, SCENE3D_ASSET_ROLES, SCENE3D_ASSET_ROLE_KINDS, SCENE3D_CAMERA_TRACK_FORMAT, SCENE3D_CAMERA_TRACK_LIMITS, SCENE3D_CAMERA_TRACK_VERSION, SCENE3D_CLAY_LIGHTING_PRESETS, 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 Scene3DCamera, type Scene3DCameraChanges, type Scene3DCameraKeyframe, type Scene3DCameraSample, type Scene3DCameraTrackV1, type Scene3DClayLighting, type Scene3DClayLightingPreset, type Scene3DEasing, type Scene3DEditErrorCode, type Scene3DEditOperation, type Scene3DEditOptions, type Scene3DEditResult, 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, 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, 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, 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, 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 };