@aura3d/engine 1.0.9 → 1.1.0

package/dist/engine/agent-api/CameraPathEditor.js

@@ -0,0 +1,47 @@
+import { sampleCameraPath } from "./CameraChoreographer.js";
+import { normalizePromptAnimationTime } from "./PromptAnimationContract.js";
+export function createCameraPathEditorState(path) {
+    return {
+        path,
+        selectedKeyframeIds: [],
+        pathMarkers: path.keyframes.map(keyframeToMarker)
+    };
+}
+export function addCameraKeyframe(path, keyframe) {
+    return {
+        ...path,
+        keyframes: [...path.keyframes.filter((candidate) => candidate.id !== keyframe.id), keyframe].sort((a, b) => a.time - b.time)
+    };
+}
+export function moveCameraKeyframe(path, keyframeId, patch) {
+    return {
+        ...path,
+        keyframes: path.keyframes
+            .map((keyframe) => keyframe.id === keyframeId
+            ? {
+                ...keyframe,
+                ...patch,
+                time: patch.time === undefined ? keyframe.time : normalizePromptAnimationTime(patch.time)
+            }
+            : keyframe)
+            .sort((a, b) => a.time - b.time)
+    };
+}
+export function removeCameraKeyframe(path, keyframeId) {
+    return {
+        ...path,
+        keyframes: path.keyframes.filter((keyframe) => keyframe.id !== keyframeId)
+    };
+}
+export function sampleCameraPathEditorPreview(state, times) {
+    return times.map((time) => sampleCameraPath(state.path, time));
+}
+function keyframeToMarker(keyframe) {
+    return {
+        keyframeId: keyframe.id,
+        position: keyframe.position,
+        target: keyframe.target,
+        label: keyframe.id
+    };
+}
+//# sourceMappingURL=CameraPathEditor.js.map

package/dist/engine/agent-api/CameraPathEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraPathEditor.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/CameraPathEditor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAA2D,MAAM,0BAA0B,CAAC;AACrH,OAAO,EAAE,4BAA4B,EAAuD,MAAM,8BAA8B,CAAC;AAejI,MAAM,UAAU,2BAA2B,CAAC,IAAgB;IAC1D,OAAO;QACL,IAAI;QACJ,mBAAmB,EAAE,EAAE;QACvB,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAgB,EAAE,QAAwB;IAC1E,OAAO;QACL,GAAG,IAAI;QACP,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;KAC7H,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAgB,EAChB,UAA6B,EAC7B,KAAwG;IAExG,OAAO;QACL,GAAG,IAAI;QACP,SAAS,EAAE,IAAI,CAAC,SAAS;aACtB,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,UAAU;YAC3C,CAAC,CAAC;gBACE,GAAG,QAAQ;gBACX,GAAG,KAAK;gBACR,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,4BAA4B,CAAC,KAAK,CAAC,IAAI,CAAC;aAC1F;YACH,CAAC,CAAC,QAAQ,CAAC;aACZ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAgB,EAAE,UAA6B;IAClF,OAAO;QACL,GAAG,IAAI;QACP,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,UAAU,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAA4B,EAC5B,KAAwC;IAExC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAwB;IAChD,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,EAAE;QACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,KAAK,EAAE,QAAQ,CAAC,EAAE;KACnB,CAAC;AACJ,CAAC"}

package/dist/engine/agent-api/CameraPresetLibrary.d.ts

@@ -0,0 +1,22 @@
+import type { AuraVec3 } from "./index.js";
+import type { ShotCameraInstruction } from "./ShotTimeline.js";
+import type { PromptAnimationId } from "./PromptAnimationContract.js";
+export type CameraPresetId = "establishing" | "medium" | "close-up" | "over-shoulder" | "tracking" | "crane" | "dolly-zoom" | "pan" | "two-shot" | string;
+export interface CameraPreset {
+    readonly id: CameraPresetId;
+    readonly label: string;
+    readonly description: string;
+    readonly camera: ShotCameraInstruction;
+    readonly subjectDistance: number;
+    readonly fov: number;
+    readonly composition: readonly string[];
+}
+export declare const cameraPresetLibrary: readonly CameraPreset[];
+export declare function getCameraPreset(id: CameraPresetId): CameraPreset | undefined;
+export declare function cameraPreset(id: CameraPresetId): CameraPreset;
+export declare function applyCameraPreset(presetId: CameraPresetId, options?: {
+    readonly subjectPosition?: AuraVec3 | undefined;
+    readonly focusTargetId?: PromptAnimationId | undefined;
+    readonly overrides?: Partial<ShotCameraInstruction> | undefined;
+}): ShotCameraInstruction;
+//# sourceMappingURL=CameraPresetLibrary.d.ts.map

package/dist/engine/agent-api/CameraPresetLibrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraPresetLibrary.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/CameraPresetLibrary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,QAAQ,GACR,UAAU,GACV,eAAe,GACf,UAAU,GACV,OAAO,GACP,YAAY,GACZ,KAAK,GACL,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EAkFtD,CAAC;AAEF,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,YAAY,GAAG,SAAS,CAE5E;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,cAAc,GAAG,YAAY,CAI7D;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE;IACP,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,CAAC;CAC5D,GACL,qBAAqB,CAYvB"}

package/dist/engine/agent-api/CameraPresetLibrary.js

@@ -0,0 +1,109 @@
+export const cameraPresetLibrary = [
+    {
+        id: "establishing",
+        label: "Establishing",
+        description: "Wide shot that introduces the location and character staging.",
+        camera: { move: "static", position: [0, 3.2, 7.5], target: [0, 1.2, 0], fov: 45 },
+        subjectDistance: 7.5,
+        fov: 45,
+        composition: ["safe-area", "rule-of-thirds"]
+    },
+    {
+        id: "medium",
+        label: "Medium",
+        description: "Waist-up dialogue framing for one or two characters.",
+        camera: { move: "static", position: [0, 1.7, 4.2], target: [0, 1.25, 0], fov: 38 },
+        subjectDistance: 4.2,
+        fov: 38,
+        composition: ["headroom", "leading-room"]
+    },
+    {
+        id: "close-up",
+        label: "Close Up",
+        description: "Face-focused emotional beat with shallow framing.",
+        camera: { move: "push-in", from: [0, 1.55, 2.8], to: [0, 1.55, 2.1], target: [0, 1.45, 0], fov: 32 },
+        subjectDistance: 2.4,
+        fov: 32,
+        composition: ["headroom", "safe-area"]
+    },
+    {
+        id: "over-shoulder",
+        label: "Over Shoulder",
+        description: "Dialogue shot from behind a listening character toward the speaker.",
+        camera: { move: "static", position: [-1.1, 1.55, 3.2], target: [0.55, 1.35, 0], fov: 35 },
+        subjectDistance: 3.4,
+        fov: 35,
+        composition: ["leading-room", "shot-reverse-shot"]
+    },
+    {
+        id: "tracking",
+        label: "Tracking",
+        description: "Side-follow camera for walking or running blocking.",
+        camera: { move: "truck", from: [-2.5, 1.6, 4], to: [2.5, 1.6, 4], target: [0, 1.2, 0], fov: 40 },
+        subjectDistance: 4,
+        fov: 40,
+        composition: ["leading-room"]
+    },
+    {
+        id: "crane",
+        label: "Crane",
+        description: "Vertical move that reveals the set scale.",
+        camera: { move: "dolly", from: [0, 1.8, 5.5], to: [0, 5.5, 7.2], target: [0, 1, 0], fov: 48 },
+        subjectDistance: 6.2,
+        fov: 48,
+        composition: ["safe-area"]
+    },
+    {
+        id: "dolly-zoom",
+        label: "Dolly Zoom",
+        description: "Push/pull perspective move for surprise or realization beats.",
+        camera: { move: "dolly", from: [0, 1.6, 5], to: [0, 1.6, 2.4], target: [0, 1.35, 0], fov: 55 },
+        subjectDistance: 3.8,
+        fov: 55,
+        composition: ["headroom", "center-punch"]
+    },
+    {
+        id: "pan",
+        label: "Pan",
+        description: "Horizontal reveal across a set or two-character staging.",
+        camera: { move: "pan", from: [-1.4, 1.7, 4.4], to: [1.4, 1.7, 4.4], target: [0, 1.2, 0], fov: 42 },
+        subjectDistance: 4.4,
+        fov: 42,
+        composition: ["safe-area", "leading-room"]
+    },
+    {
+        id: "two-shot",
+        label: "Two Shot",
+        description: "Readable two-character dialogue framing with both performers visible.",
+        camera: { move: "static", position: [0, 1.75, 4.8], target: [0, 1.25, 0], fov: 44 },
+        subjectDistance: 4.8,
+        fov: 44,
+        composition: ["two-character-framing", "headroom", "safe-area"]
+    }
+];
+export function getCameraPreset(id) {
+    return cameraPresetLibrary.find((preset) => preset.id === id);
+}
+export function cameraPreset(id) {
+    const preset = getCameraPreset(id);
+    if (!preset)
+        throw new Error(`Unknown camera preset: ${id}`);
+    return preset;
+}
+export function applyCameraPreset(presetId, options = {}) {
+    const preset = cameraPreset(presetId);
+    const offset = options.subjectPosition ?? [0, 0, 0];
+    return {
+        ...preset.camera,
+        ...(preset.camera.position ? { position: addVec3(preset.camera.position, offset) } : {}),
+        ...(preset.camera.target ? { target: addVec3(preset.camera.target, offset) } : {}),
+        ...(preset.camera.from ? { from: addVec3(preset.camera.from, offset) } : {}),
+        ...(preset.camera.to ? { to: addVec3(preset.camera.to, offset) } : {}),
+        ...(options.focusTargetId ? { focusTargetId: options.focusTargetId } : {}),
+        ...options.overrides
+    };
+}
+function addVec3(a, b) {
+    return [a[0] + b[0], a[1] + b[1], a[2] + b[2]];
+}
+//# sourceMappingURL=CameraPresetLibrary.js.map

package/dist/engine/agent-api/CameraPresetLibrary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraPresetLibrary.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/CameraPresetLibrary.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,mBAAmB,GAA4B;IAC1D;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,+DAA+D;QAC5E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACjF,eAAe,EAAE,GAAG;QACpB,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC;KAC7C;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,sDAAsD;QACnE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QAClF,eAAe,EAAE,GAAG;QACpB,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC;KAC1C;IACD;QACE,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,mDAAmD;QAChE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACpG,eAAe,EAAE,GAAG;QACpB,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;KACvC;IACD;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,qEAAqE;QAClF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACzF,eAAe,EAAE,GAAG;QACpB,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,CAAC,cAAc,EAAE,mBAAmB,CAAC;KACnD;IACD;QACE,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,qDAAqD;QAClE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QAChG,eAAe,EAAE,CAAC;QAClB,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,CAAC,cAAc,CAAC;KAC9B;IACD;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,2CAA2C;QACxD,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QAC7F,eAAe,EAAE,GAAG;QACpB,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,CAAC,WAAW,CAAC;KAC3B;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,+DAA+D;QAC5E,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QAC9F,eAAe,EAAE,GAAG;QACpB,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC;KAC1C;IACD;QACE,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,0DAA0D;QACvE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QAClG,eAAe,EAAE,GAAG;QACpB,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC;KAC3C;IACD;QACE,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,uEAAuE;QACpF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACnF,eAAe,EAAE,GAAG;QACpB,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,CAAC,uBAAuB,EAAE,UAAU,EAAE,WAAW,CAAC;KAChE;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,EAAkB;IAChD,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAkB;IAC7C,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAwB,EACxB,UAII,EAAE;IAEN,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO;QACL,GAAG,MAAM,CAAC,MAAM;QAChB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,OAAO,CAAC,SAAS;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,CAAW,EAAE,CAAW;IACvC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/engine/agent-api/CaptionExporter.d.ts

@@ -0,0 +1,23 @@
+import type { CaptionCue, CaptionTrackArtifact } from "./DialoguePerformance.js";
+import { type PromptAnimationSeconds } from "./PromptAnimationContract.js";
+export type CaptionExportFormat = "vtt" | "srt";
+export interface CaptionExportArtifact {
+    readonly kind: "caption-export";
+    readonly format: CaptionExportFormat;
+    readonly language: string;
+    readonly cueCount: number;
+    readonly text: string;
+    readonly mimeType: string;
+    readonly byteLength: number;
+    readonly checksum: string;
+    readonly path?: string | undefined;
+}
+export declare function exportCaptionTrack(captions: CaptionTrackArtifact, format: CaptionExportFormat, path?: string): CaptionExportArtifact;
+export declare function exportCaptionTrackFile(captions: CaptionTrackArtifact, format: CaptionExportFormat, path: string): CaptionExportArtifact;
+export declare function exportCaptionTrackVtt(track: CaptionTrackArtifact): string;
+export declare function exportCaptionTrackSrt(track: CaptionTrackArtifact): string;
+export declare function captionsToVtt(cues: readonly CaptionCue[]): string;
+export declare function captionsToSrt(cues: readonly CaptionCue[]): string;
+export declare function formatCaptionTimestamp(time: PromptAnimationSeconds, format: CaptionExportFormat): string;
+export declare function captionCueFileSafeText(cue: CaptionCue): string;
+//# sourceMappingURL=CaptionExporter.d.ts.map

package/dist/engine/agent-api/CaptionExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaptionExporter.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/CaptionExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAgC,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEzG,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,KAAK,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAapI;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAEvI;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEzE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEzE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CASjE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CASjE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CASxG;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAE9D"}

package/dist/engine/agent-api/CaptionExporter.js

@@ -0,0 +1,69 @@
+import { normalizePromptAnimationTime } from "./PromptAnimationContract.js";
+export function exportCaptionTrack(captions, format, path) {
+    const text = format === "vtt" ? captionsToVtt(captions.cues) : captionsToSrt(captions.cues);
+    return {
+        kind: "caption-export",
+        format,
+        language: captions.language,
+        cueCount: captions.cues.length,
+        text,
+        mimeType: format === "vtt" ? "text/vtt" : "application/x-subrip",
+        byteLength: new TextEncoder().encode(text).byteLength,
+        checksum: captionTextChecksum(text),
+        ...(path ? { path } : {})
+    };
+}
+export function exportCaptionTrackFile(captions, format, path) {
+    return exportCaptionTrack(captions, format, path);
+}
+export function exportCaptionTrackVtt(track) {
+    return exportCaptionTrack(track, "vtt").text;
+}
+export function exportCaptionTrackSrt(track) {
+    return exportCaptionTrack(track, "srt").text;
+}
+export function captionsToVtt(cues) {
+    const lines = ["WEBVTT", ""];
+    cues.forEach((cue, index) => {
+        lines.push(cue.captionId || String(index + 1));
+        lines.push(`${formatCaptionTimestamp(cue.startTime, "vtt")} --> ${formatCaptionTimestamp(cue.endTime, "vtt")}`);
+        lines.push(captionCueFileSafeText(cue));
+        lines.push("");
+    });
+    return lines.join("\n");
+}
+export function captionsToSrt(cues) {
+    const lines = [];
+    cues.forEach((cue, index) => {
+        lines.push(String(index + 1));
+        lines.push(`${formatCaptionTimestamp(cue.startTime, "srt")} --> ${formatCaptionTimestamp(cue.endTime, "srt")}`);
+        lines.push(captionCueFileSafeText(cue));
+        lines.push("");
+    });
+    return lines.join("\n");
+}
+export function formatCaptionTimestamp(time, format) {
+    const normalized = normalizePromptAnimationTime(Math.max(0, time));
+    const totalMs = Math.round(normalized * 1000);
+    const hours = Math.floor(totalMs / 3_600_000);
+    const minutes = Math.floor(totalMs % 3_600_000 / 60_000);
+    const seconds = Math.floor(totalMs % 60_000 / 1000);
+    const ms = totalMs % 1000;
+    const separator = format === "srt" ? "," : ".";
+    return `${pad2(hours)}:${pad2(minutes)}:${pad2(seconds)}${separator}${String(ms).padStart(3, "0")}`;
+}
+export function captionCueFileSafeText(cue) {
+    return cue.text.replace(/\s+/g, " ").trim();
+}
+function pad2(value) {
+    return String(value).padStart(2, "0");
+}
+function captionTextChecksum(value) {
+    let hash = 2166136261;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return `caption-${(hash >>> 0).toString(16).padStart(8, "0")}`;
+}
+//# sourceMappingURL=CaptionExporter.js.map

package/dist/engine/agent-api/CaptionExporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaptionExporter.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/CaptionExporter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAA+B,MAAM,8BAA8B,CAAC;AAgBzG,MAAM,UAAU,kBAAkB,CAAC,QAA8B,EAAE,MAA2B,EAAE,IAAa;IAC3G,MAAM,IAAI,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5F,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,MAAM;QACN,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;QAC9B,IAAI;QACJ,QAAQ,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,sBAAsB;QAChE,UAAU,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU;QACrD,QAAQ,EAAE,mBAAmB,CAAC,IAAI,CAAC;QACnC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA8B,EAAE,MAA2B,EAAE,IAAY;IAC9G,OAAO,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAA2B;IAC/D,OAAO,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAA2B;IAC/D,OAAO,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAA2B;IACvD,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,sBAAsB,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAChH,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAA2B;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC1B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,sBAAsB,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAChH,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAA4B,EAAE,MAA2B;IAC9F,MAAM,UAAU,GAAG,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;IACpD,MAAM,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC;IAC1B,MAAM,SAAS,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAe;IACpD,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,IAAI,CAAC,KAAa;IACzB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/engine/agent-api/CartoonAssetManifest.d.ts

@@ -0,0 +1,50 @@
+import { type PromptAnimationId, type PromptAnimationValidationIssue } from "./PromptAnimationContract.js";
+export type CartoonAssetManifestKind = "character" | "prop" | "set" | "environment" | "audio";
+export type CartoonAssetProfile = "cartoon-character" | "cartoon-set" | "cartoon-prop" | "audio-dialogue" | "audio-sfx" | "environment";
+export interface CartoonAssetManifestEntry {
+    readonly id: PromptAnimationId;
+    readonly kind: CartoonAssetManifestKind;
+    readonly assetId: string;
+    readonly profile?: CartoonAssetProfile | undefined;
+    readonly style: string;
+    readonly license: string;
+    readonly sourcePage?: string | undefined;
+    readonly attribution?: string | undefined;
+    readonly lipSyncReady?: boolean;
+    readonly typedAssetReference?: boolean | undefined;
+    readonly mouthCueReady?: boolean | undefined;
+    readonly setReady?: boolean | undefined;
+    readonly audioReady?: boolean | undefined;
+    readonly emotionSupport?: readonly string[];
+    readonly animationClips?: readonly string[];
+    readonly materialPreview?: {
+        readonly materialCount: number;
+        readonly swatches: readonly string[];
+        readonly celShadingReady?: boolean | undefined;
+    } | undefined;
+    readonly preview?: {
+        readonly thumbnailPath?: string | undefined;
+        readonly orbitPreview?: boolean | undefined;
+        readonly zoomPreview?: boolean | undefined;
+        readonly animationPreviewClips?: readonly string[] | undefined;
+    } | undefined;
+    readonly metadata?: Readonly<Record<string, string | number | boolean | readonly string[]>> | undefined;
+}
+export interface CartoonAssetManifest {
+    readonly kind: "cartoon-asset-manifest";
+    readonly entries: readonly CartoonAssetManifestEntry[];
+    readonly readiness: CartoonAssetManifestReadiness;
+}
+export interface CartoonAssetManifestReadiness {
+    readonly characterCount: number;
+    readonly setCount: number;
+    readonly propCount: number;
+    readonly audioCount: number;
+    readonly lipSyncReadyCount: number;
+    readonly typedAssetReferenceCount: number;
+    readonly issues: readonly PromptAnimationValidationIssue[];
+}
+export declare function defineCartoonAssetManifest(entries: readonly CartoonAssetManifestEntry[]): CartoonAssetManifest;
+export declare function validateCartoonAssetManifest(manifest: CartoonAssetManifest): readonly PromptAnimationValidationIssue[];
+export declare function createCartoonAssetManifestReadiness(entries: readonly CartoonAssetManifestEntry[]): CartoonAssetManifestReadiness;
+//# sourceMappingURL=CartoonAssetManifest.d.ts.map

package/dist/engine/agent-api/CartoonAssetManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CartoonAssetManifest.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/CartoonAssetManifest.ts"],"names":[],"mappings":"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"}

package/dist/engine/agent-api/CartoonAssetManifest.js

@@ -0,0 +1,65 @@
+import { createPromptAnimationIssue } from "./PromptAnimationContract.js";
+export function defineCartoonAssetManifest(entries) {
+    return { kind: "cartoon-asset-manifest", entries, readiness: createCartoonAssetManifestReadiness(entries) };
+}
+export function validateCartoonAssetManifest(manifest) {
+    return createCartoonAssetManifestReadiness(manifest.entries).issues;
+}
+export function createCartoonAssetManifestReadiness(entries) {
+    const issues = [];
+    let characterCount = 0;
+    let setCount = 0;
+    let propCount = 0;
+    let audioCount = 0;
+    let lipSyncReadyCount = 0;
+    let typedAssetReferenceCount = 0;
+    for (const entry of entries) {
+        if (entry.kind === "character")
+            characterCount += 1;
+        if (entry.kind === "set" || entry.kind === "environment")
+            setCount += 1;
+        if (entry.kind === "prop")
+            propCount += 1;
+        if (entry.kind === "audio")
+            audioCount += 1;
+        if (entry.lipSyncReady || entry.mouthCueReady)
+            lipSyncReadyCount += 1;
+        if (entry.typedAssetReference ?? entry.assetId.startsWith("assets."))
+            typedAssetReferenceCount += 1;
+        if (!entry.assetId.startsWith("assets.")) {
+            issues.push(createPromptAnimationIssue("error", "cartoon-asset-typed-reference-missing", `Cartoon asset "${entry.id}" must reference a generated typed asset key such as assets.${entry.id}.`, {
+                path: `entries.${entry.id}.assetId`
+            }));
+        }
+        if (!entry.license) {
+            issues.push(createPromptAnimationIssue("error", "cartoon-asset-license-missing", `Cartoon asset "${entry.id}" needs a license.`, {
+                path: `entries.${entry.id}.license`
+            }));
+        }
+        if (entry.kind === "character" && !(entry.lipSyncReady || entry.mouthCueReady)) {
+            issues.push(createPromptAnimationIssue("error", "cartoon-character-mouth-readiness-missing", `Character asset "${entry.id}" needs lip-sync, mouth cue, or blendshape readiness evidence.`, {
+                path: `entries.${entry.id}.lipSyncReady`
+            }));
+        }
+        if ((entry.kind === "set" || entry.kind === "environment") && entry.setReady === false) {
+            issues.push(createPromptAnimationIssue("error", "cartoon-set-readiness-failed", `Set asset "${entry.id}" is marked not ready.`, {
+                path: `entries.${entry.id}.setReady`
+            }));
+        }
+        if (entry.kind === "audio" && entry.audioReady === false) {
+            issues.push(createPromptAnimationIssue("error", "cartoon-audio-readiness-failed", `Audio asset "${entry.id}" is marked not ready.`, {
+                path: `entries.${entry.id}.audioReady`
+            }));
+        }
+    }
+    return {
+        characterCount,
+        setCount,
+        propCount,
+        audioCount,
+        lipSyncReadyCount,
+        typedAssetReferenceCount,
+        issues
+    };
+}
+//# sourceMappingURL=CartoonAssetManifest.js.map

package/dist/engine/agent-api/CartoonAssetManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CartoonAssetManifest.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/CartoonAssetManifest.ts"],"names":[],"mappings":"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"}

package/dist/engine/agent-api/CartoonDirector.d.ts

@@ -2,7 +2,7 @@ import type { AuraAssetRef } from "./index.js";
 import { type PromptAnimationAccessibilityProofMetadata, type PromptAnimationCharacter, type PromptAnimationEpisodePlan, type PromptAnimationId, type PromptAnimationLanguageCode, type PromptAnimationProp, type PromptAnimationRuntimeSpec, type PromptAnimationSafetyMetadata, type PromptAnimationSeconds, type PromptAnimationStoryboard, type PromptAnimationStoryBible, type PromptAnimationStyleGuide } from "./PromptAnimationContract.js";
 import { type CartoonPerformanceArtifact } from "./CartoonPerformance.js";
 import { type CaptionTrackArtifact, type DialogueTrackArtifact } from "./DialoguePerformance.js";
-import { type CartoonRenderQueueArtifact, type CartoonViewport } from "./CartoonRenderQueue.js";
+import { type CartoonRenderOutputPackageMetadata, type CartoonRenderQueueArtifact, type CartoonViewport } from "./CartoonRenderQueue.js";
 import { type ShotTimelineArtifact } from "./ShotTimeline.js";
 export interface CartoonDirectorCharacterInput {
     readonly id: PromptAnimationId;
@@ -83,6 +83,31 @@ export interface CartoonDirectorPlan {
     readonly captionTrack: CaptionTrackArtifact;
     readonly performance: CartoonPerformanceArtifact;
     readonly renderQueue: CartoonRenderQueueArtifact;
+    readonly renderOutputPackage: CartoonRenderOutputPackageMetadata;
+    readonly assetSlots: readonly CartoonDirectorAssetSlot[];
+    readonly motionRequirements: readonly CartoonDirectorMotionRequirement[];
+    readonly reviewGates: readonly CartoonDirectorReviewGate[];
+}
+export interface CartoonDirectorAssetSlot {
+    readonly id: PromptAnimationId;
+    readonly kind: "character" | "location" | "prop";
+    readonly required: boolean;
+    readonly assetId?: string | undefined;
+    readonly readiness: "typed-asset" | "needs-asset" | "primitive-fallback";
+    readonly requirements: readonly string[];
+}
+export interface CartoonDirectorMotionRequirement {
+    readonly id: PromptAnimationId;
+    readonly targetId: PromptAnimationId;
+    readonly kind: "body" | "mouth" | "gesture" | "camera" | "caption";
+    readonly required: boolean;
+    readonly evidence: string;
+}
+export interface CartoonDirectorReviewGate {
+    readonly id: PromptAnimationId;
+    readonly required: boolean;
+    readonly status: "pending" | "pass";
+    readonly detail: string;
 }
 export declare function defineCartoonDirectorPlan<const TPlan extends CartoonDirectorPlan>(plan: TPlan): TPlan;
 export declare function createCartoonDirectorPlan(input: CartoonDirectorInput): CartoonDirectorPlan;

package/dist/engine/agent-api/CartoonDirector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CartoonDirector.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/CartoonDirector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CartoonDirector.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/CartoonDirector.ts"],"names":[],"mappings":"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"}

package/dist/engine/agent-api/CartoonDirector.js

@@ -1,7 +1,7 @@
 import { createPromptAnimationEpisodePlan, createPromptAnimationStoryBible, promptAnimationContractVersion } from "./PromptAnimationContract.js";
 import { createCartoonPerformance, resolveCartoonEmotionPose, resolveCartoonGesture } from "./CartoonPerformance.js";
 import { createDialogueTrack, deriveCaptionTrackFromDialogue } from "./DialoguePerformance.js";
-import { createCartoonRenderQueue } from "./CartoonRenderQueue.js";
+import { createCartoonRenderOutputPackageMetadata, createCartoonRenderQueue } from "./CartoonRenderQueue.js";
 import { createShotTimeline } from "./ShotTimeline.js";
 export function defineCartoonDirectorPlan(plan) {
     return plan;
@@ -282,6 +282,12 @@ export function createCartoonDirectorPlan(input) {
         viewport: input.viewport,
         generatedAt: input.generatedAt
     });
+    const renderOutputPackage = createCartoonRenderOutputPackageMetadata({
+        episodePlan,
+        shotTimeline,
+        renderQueue,
+        generatedAt: input.generatedAt
+    });
     return {
         kind: "cartoon-director-plan",
         episodePlan,
@@ -291,7 +297,11 @@ export function createCartoonDirectorPlan(input) {
         dialogueTrack,
         captionTrack,
         performance,
-        renderQueue
+        renderQueue,
+        renderOutputPackage,
+        assetSlots: createCartoonDirectorAssetSlots(characters, locations, props),
+        motionRequirements: createCartoonDirectorMotionRequirements(shots, dialogueLines, performanceCues),
+        reviewGates: createCartoonDirectorReviewGates(renderOutputPackage)
     };
 }
 export function compilePromptEpisodePlan(input) {
@@ -339,4 +349,84 @@ function defaultGestureForEmotion(emotion) {
 function createCueGestureState(gestureId) {
     return resolveCartoonGesture(gestureId)?.gesture;
 }
+function createCartoonDirectorAssetSlots(characters, locations, props) {
+    return [
+        ...characters.map((character) => ({
+            id: character.id,
+            kind: "character",
+            required: true,
+            ...(character.rig.asset?.id ? { assetId: character.rig.asset.id } : {}),
+            readiness: character.rig.asset ? "typed-asset" : "primitive-fallback",
+            requirements: ["cartoon-character profile", "mouth or blendshape evidence", "body motion evidence"]
+        })),
+        ...locations.map((location) => ({
+            id: location.id,
+            kind: "location",
+            required: true,
+            readiness: location.sceneNodes && location.sceneNodes.length > 0 ? "typed-asset" : "needs-asset",
+            requirements: ["cartoon-set or authored scene nodes", "walkable/composition evidence"]
+        })),
+        ...props.map((prop) => ({
+            id: prop.id,
+            kind: "prop",
+            required: prop.role === "hero-prop" || prop.role === "interactive",
+            ...(prop.asset?.id ? { assetId: prop.asset.id } : {}),
+            readiness: prop.asset ? "typed-asset" : prop.primitiveFallback ? "primitive-fallback" : "needs-asset",
+            requirements: ["typed asset when hero/interactive", "license/provenance evidence"]
+        }))
+    ];
+}
+function createCartoonDirectorMotionRequirements(shots, dialogueLines, cues) {
+    return [
+        ...shots.map((shot) => ({
+            id: `${shot.shotId}:camera`,
+            targetId: shot.shotId,
+            kind: "camera",
+            required: true,
+            evidence: `camera move "${shot.camera.move}" is sampled by the render queue`
+        })),
+        ...dialogueLines.map((line) => ({
+            id: `${line.lineId}:mouth`,
+            targetId: line.speakerId,
+            kind: "mouth",
+            required: true,
+            evidence: `dialogue line "${line.lineId}" requires viseme or mouth-card motion`
+        })),
+        ...cues.map((cue) => ({
+            id: `${cue.id}:body`,
+            targetId: cue.characterId,
+            kind: cue.gesture || cue.gestureId ? "gesture" : "body",
+            required: true,
+            evidence: `performance cue "${cue.id}" drives ${cue.action} from ${cue.startTime}s to ${cue.endTime}s`
+        }))
+    ];
+}
+function createCartoonDirectorReviewGates(outputPackage) {
+    return [
+        {
+            id: "encoded-video",
+            required: true,
+            status: "pending",
+            detail: `Review package must include encoded video output at ${outputPackage.reviewPackagePaths.video.join(" or ")}.`
+        },
+        {
+            id: "captions",
+            required: true,
+            status: "pass",
+            detail: `Caption sidecars are planned at ${outputPackage.reviewPackagePaths.captions.join(", ")}.`
+        },
+        {
+            id: "thumbnail",
+            required: true,
+            status: "pass",
+            detail: `Thumbnail is captured from route state ${outputPackage.thumbnailCapture.sourceSceneStateId}.`
+        },
+        {
+            id: "human-review",
+            required: true,
+            status: "pending",
+            detail: "Named human visual approval is required before publish-ready claims."
+        }
+    ];
+}
 //# sourceMappingURL=CartoonDirector.js.map