@aura3d/engine 1.0.8 → 1.0.10

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

@@ -0,0 +1 @@
+{"version":3,"file":"CameraPathEditor.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/CameraPathEditor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACrH,OAAO,EAAgC,KAAK,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEjI,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC3D,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,UAAU,GAAG,qBAAqB,CAMnF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,GAAG,UAAU,CAKxF;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,eAAe,GAAG,OAAO,CAAC,CAAC,GACvG,UAAU,CAaZ;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,GAAG,UAAU,CAKhG;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,SAAS,sBAAsB,EAAE,GACvC,SAAS,YAAY,EAAE,CAEzB"}

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" | 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,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,EAgEtD,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,91 @@
+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"]
+    }
+];
+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":"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"}

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

@@ -0,0 +1,19 @@
+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;
+}
+export declare function exportCaptionTrack(captions: CaptionTrackArtifact, format: CaptionExportFormat): 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;CAC3B;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,MAAM,EAAE,mBAAmB,GAAG,qBAAqB,CASrH;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,54 @@
+import { normalizePromptAnimationTime } from "./PromptAnimationContract.js";
+export function exportCaptionTrack(captions, format) {
+    return {
+        kind: "caption-export",
+        format,
+        language: captions.language,
+        cueCount: captions.cues.length,
+        text: format === "vtt" ? captionsToVtt(captions.cues) : captionsToSrt(captions.cues),
+        mimeType: format === "vtt" ? "text/vtt" : "application/x-subrip"
+    };
+}
+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");
+}
+//# 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;AAazG,MAAM,UAAU,kBAAkB,CAAC,QAA8B,EAAE,MAA2B;IAC5F,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,MAAM;QACN,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;QAC9B,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpF,QAAQ,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,sBAAsB;KACjE,CAAC;AACJ,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"}

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

@@ -0,0 +1,32 @@
+import type { PromptAnimationId } from "./PromptAnimationContract.js";
+export type CartoonAssetManifestKind = "character" | "prop" | "set" | "environment" | "audio";
+export interface CartoonAssetManifestEntry {
+    readonly id: PromptAnimationId;
+    readonly kind: CartoonAssetManifestKind;
+    readonly assetId: string;
+    readonly style: string;
+    readonly license: string;
+    readonly sourcePage?: string | undefined;
+    readonly attribution?: string | undefined;
+    readonly lipSyncReady?: boolean;
+    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[];
+}
+export declare function defineCartoonAssetManifest(entries: readonly CartoonAssetManifestEntry[]): CartoonAssetManifest;
+//# 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":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,GAAG,OAAO,CAAC;AAE9F,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE;QACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KAChD,GAAG,SAAS,CAAC;IACd,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC3C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;KAChE,GAAG,SAAS,CAAC;IACd,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;CACzG;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACxD;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,GAAG,oBAAoB,CAE9G"}

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

@@ -0,0 +1,4 @@
+export function defineCartoonAssetManifest(entries) {
+    return { kind: "cartoon-asset-manifest", entries };
+}
+//# 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":"AAkCA,MAAM,UAAU,0BAA0B,CAAC,OAA6C;IACtF,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { DialogueTrackArtifact } from "./DialoguePerformance.js";
+export interface DialogueAlignmentCue {
+    readonly lineId: string;
+    readonly audioFile?: string | undefined;
+    readonly startTime: number;
+    readonly endTime: number;
+    readonly duration: number;
+    readonly driftSeconds: number;
+}
+export interface DialogueAlignmentReport {
+    readonly kind: "dialogue-alignment";
+    readonly lineCount: number;
+    readonly alignedLineCount: number;
+    readonly maxDriftSeconds: number;
+    readonly cues: readonly DialogueAlignmentCue[];
+}
+export declare function alignDialogueToAudio(dialogue: DialogueTrackArtifact, durationsByAudioFile: Readonly<Record<string, number>>): DialogueAlignmentReport;
+//# sourceMappingURL=DialogueAlignment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DialogueAlignment.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/DialogueAlignment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAChD;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,qBAAqB,EAC/B,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACrD,uBAAuB,CASzB"}

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

@@ -0,0 +1,23 @@
+export function alignDialogueToAudio(dialogue, durationsByAudioFile) {
+    const cues = dialogue.lines.map((line) => alignDialogueLine(line, durationsByAudioFile[line.audioFile ?? ""]));
+    return {
+        kind: "dialogue-alignment",
+        lineCount: dialogue.lines.length,
+        alignedLineCount: cues.filter((cue) => cue.audioFile && cue.driftSeconds <= 0.05).length,
+        maxDriftSeconds: Math.max(0, ...cues.map((cue) => cue.driftSeconds)),
+        cues
+    };
+}
+function alignDialogueLine(line, audioDuration) {
+    const lineDuration = Math.max(0, line.endTime - line.startTime);
+    const duration = audioDuration ?? lineDuration;
+    return {
+        lineId: line.lineId,
+        audioFile: line.audioFile,
+        startTime: line.startTime,
+        endTime: line.startTime + duration,
+        duration,
+        driftSeconds: Math.abs(duration - lineDuration)
+    };
+}
+//# sourceMappingURL=DialogueAlignment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DialogueAlignment.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/DialogueAlignment.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,oBAAoB,CAClC,QAA+B,EAC/B,oBAAsD;IAEtD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAwB,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrI,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;QAChC,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,MAAM;QACxF,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACpE,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAkB,EAAE,aAAsB;IACnE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,aAAa,IAAI,YAAY,CAAC;IAC/C,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,SAAS,GAAG,QAAQ;QAClC,QAAQ;QACR,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,YAAY,CAAC;KAChD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,77 @@
+import { type PromptAnimationId, type PromptAnimationSeconds, type PromptAnimationValidationIssue } from "./PromptAnimationContract.js";
+export interface EpisodeShotRef {
+    readonly shotId: PromptAnimationId;
+    readonly timelineShotId?: PromptAnimationId | undefined;
+    readonly startTime: PromptAnimationSeconds;
+    readonly endTime: PromptAnimationSeconds;
+    readonly beat?: string | undefined;
+    readonly pacing?: "hold" | "normal" | "quick" | "montage" | undefined;
+}
+export interface EpisodeSceneStructure {
+    readonly sceneId: PromptAnimationId;
+    readonly title: string;
+    readonly locationId?: PromptAnimationId | undefined;
+    readonly startTime: PromptAnimationSeconds;
+    readonly endTime: PromptAnimationSeconds;
+    readonly characterIds: readonly PromptAnimationId[];
+    readonly shotRefs: readonly EpisodeShotRef[];
+}
+export interface EpisodeActStructure {
+    readonly actId: PromptAnimationId;
+    readonly title: string;
+    readonly startTime: PromptAnimationSeconds;
+    readonly endTime: PromptAnimationSeconds;
+    readonly scenes: readonly EpisodeSceneStructure[];
+    readonly pacingNotes?: readonly string[] | undefined;
+}
+export interface EpisodeStructureMetadata {
+    readonly title: string;
+    readonly description?: string | undefined;
+    readonly runtime: PromptAnimationSeconds;
+    readonly characterIds: readonly PromptAnimationId[];
+    readonly language?: string | undefined;
+}
+export interface EpisodeStructureArtifact {
+    readonly artifact: "episode-structure";
+    readonly contractId: string;
+    readonly episodeId: PromptAnimationId;
+    readonly metadata: EpisodeStructureMetadata;
+    readonly acts: readonly EpisodeActStructure[];
+    readonly generatedAt?: string | undefined;
+}
+export type EpisodeStructure = EpisodeStructureArtifact;
+export interface LegacyEpisodeShotReference {
+    readonly shotId: PromptAnimationId;
+    readonly startTime: PromptAnimationSeconds;
+    readonly endTime: PromptAnimationSeconds;
+}
+export interface LegacyEpisodeScene {
+    readonly sceneId: PromptAnimationId;
+    readonly title: string;
+    readonly locationId?: PromptAnimationId | undefined;
+    readonly shots: readonly LegacyEpisodeShotReference[];
+}
+export interface LegacyEpisodeAct {
+    readonly actId: PromptAnimationId;
+    readonly title: string;
+    readonly scenes: readonly LegacyEpisodeScene[];
+}
+export interface LegacyEpisodeStructureInput {
+    readonly episodeId: PromptAnimationId;
+    readonly title: string;
+    readonly acts: readonly LegacyEpisodeAct[];
+    readonly metadata: Readonly<Record<string, string | number | boolean>>;
+    readonly duration?: PromptAnimationSeconds | undefined;
+    readonly generatedAt?: string | undefined;
+}
+export type CreateEpisodeStructureInput = {
+    readonly episodeId: PromptAnimationId;
+    readonly metadata: EpisodeStructureMetadata;
+    readonly acts: readonly EpisodeActStructure[];
+    readonly generatedAt?: string | undefined;
+};
+export declare function createEpisodeStructure(input: CreateEpisodeStructureInput | LegacyEpisodeStructureInput): EpisodeStructureArtifact;
+export declare function flattenEpisodeShotRefs(episode: EpisodeStructureArtifact): readonly EpisodeShotRef[];
+export declare function sceneStructureAtTime(episode: EpisodeStructureArtifact, time: PromptAnimationSeconds): EpisodeSceneStructure | undefined;
+export declare function validateEpisodeStructure(episode: EpisodeStructureArtifact): readonly PromptAnimationValidationIssue[];
+//# sourceMappingURL=EpisodeStructure.d.ts.map

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

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

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

@@ -0,0 +1,123 @@
+import { normalizePromptAnimationTime, promptAnimationContractVersion, createPromptAnimationIssue } from "./PromptAnimationContract.js";
+export function createEpisodeStructure(input) {
+    if ("title" in input) {
+        const sceneShots = (scene) => "shots" in scene ? scene.shots : scene.shotRefs;
+        const legacyActs = input.acts;
+        const runtime = input.duration ?? Math.max(0, ...legacyActs.flatMap((act) => act.scenes.flatMap((scene) => sceneShots(scene).map((shot) => shot.endTime))));
+        return {
+            artifact: "episode-structure",
+            contractId: promptAnimationContractVersion,
+            episodeId: input.episodeId,
+            metadata: {
+                title: input.title,
+                runtime: normalizePromptAnimationTime(runtime),
+                characterIds: typeof input.metadata.characterId === "string" ? [input.metadata.characterId] : []
+            },
+            acts: legacyActs.map((act) => ({
+                actId: act.actId,
+                title: act.title,
+                startTime: normalizePromptAnimationTime(readNumber(act, "startTime") ?? Math.min(...act.scenes.flatMap((scene) => sceneShots(scene).map((shot) => shot.startTime)), 0)),
+                endTime: normalizePromptAnimationTime(readNumber(act, "endTime") ?? Math.max(...act.scenes.flatMap((scene) => sceneShots(scene).map((shot) => shot.endTime)), runtime)),
+                scenes: act.scenes.map((scene) => ({
+                    sceneId: scene.sceneId,
+                    title: scene.title,
+                    locationId: scene.locationId,
+                    startTime: normalizePromptAnimationTime(readNumber(scene, "startTime") ?? Math.min(...sceneShots(scene).map((shot) => shot.startTime), 0)),
+                    endTime: normalizePromptAnimationTime(readNumber(scene, "endTime") ?? Math.max(...sceneShots(scene).map((shot) => shot.endTime), runtime)),
+                    characterIds: readStringArray(scene, "characterIds"),
+                    shotRefs: sceneShots(scene).map((shot) => ({ ...shot }))
+                }))
+            })),
+            ...(input.generatedAt ? { generatedAt: input.generatedAt } : {})
+        };
+    }
+    return {
+        artifact: "episode-structure",
+        contractId: promptAnimationContractVersion,
+        episodeId: input.episodeId,
+        metadata: {
+            ...input.metadata,
+            runtime: normalizePromptAnimationTime(input.metadata.runtime)
+        },
+        acts: input.acts.map(normalizeActStructure),
+        ...(input.generatedAt ? { generatedAt: input.generatedAt } : {})
+    };
+}
+export function flattenEpisodeShotRefs(episode) {
+    return episode.acts.flatMap((act) => act.scenes.flatMap((scene) => scene.shotRefs));
+}
+export function sceneStructureAtTime(episode, time) {
+    const normalized = normalizePromptAnimationTime(time);
+    for (const act of episode.acts) {
+        for (const scene of act.scenes) {
+            if (normalized >= scene.startTime && normalized < scene.endTime)
+                return scene;
+        }
+    }
+    const lastAct = episode.acts[episode.acts.length - 1];
+    const lastScene = lastAct?.scenes[lastAct.scenes.length - 1];
+    if (lastScene && normalized === lastScene.endTime)
+        return lastScene;
+    return undefined;
+}
+export function validateEpisodeStructure(episode) {
+    const issues = [];
+    if (!episode.metadata.title.trim()) {
+        issues.push(createPromptAnimationIssue("error", "episode-structure-title-missing", "Episode structure requires a title."));
+    }
+    if (episode.acts.length === 0) {
+        issues.push(createPromptAnimationIssue("error", "episode-structure-acts-missing", "Episode structure requires at least one act."));
+    }
+    const sceneIds = new Set();
+    const shotIds = new Set();
+    for (const [actIndex, act] of episode.acts.entries()) {
+        if (act.endTime <= act.startTime) {
+            issues.push(createPromptAnimationIssue("error", "episode-act-duration", `Act "${act.actId}" must end after it starts.`, { path: `acts.${actIndex}` }));
+        }
+        for (const [sceneIndex, scene] of act.scenes.entries()) {
+            if (sceneIds.has(scene.sceneId)) {
+                issues.push(createPromptAnimationIssue("error", "episode-scene-id-duplicate", `Duplicate scene id "${scene.sceneId}".`, { path: `acts.${actIndex}.scenes.${sceneIndex}` }));
+            }
+            sceneIds.add(scene.sceneId);
+            if (scene.endTime <= scene.startTime) {
+                issues.push(createPromptAnimationIssue("error", "episode-scene-duration", `Scene "${scene.sceneId}" must end after it starts.`, { path: `acts.${actIndex}.scenes.${sceneIndex}` }));
+            }
+            for (const [shotIndex, shot] of scene.shotRefs.entries()) {
+                if (shotIds.has(shot.shotId)) {
+                    issues.push(createPromptAnimationIssue("warning", "episode-shot-id-reused", `Shot id "${shot.shotId}" is reused in the episode structure.`, { path: `acts.${actIndex}.scenes.${sceneIndex}.shotRefs.${shotIndex}` }));
+                }
+                shotIds.add(shot.shotId);
+                if (shot.endTime <= shot.startTime) {
+                    issues.push(createPromptAnimationIssue("error", "episode-shot-duration", `Shot "${shot.shotId}" must end after it starts.`, { path: `acts.${actIndex}.scenes.${sceneIndex}.shotRefs.${shotIndex}` }));
+                }
+            }
+        }
+    }
+    return issues;
+}
+function readNumber(value, key) {
+    const record = value;
+    return typeof record[key] === "number" ? record[key] : undefined;
+}
+function readStringArray(value, key) {
+    const record = value;
+    return Array.isArray(record[key]) && record[key].every((entry) => typeof entry === "string") ? record[key] : [];
+}
+function normalizeActStructure(act) {
+    return {
+        ...act,
+        startTime: normalizePromptAnimationTime(act.startTime),
+        endTime: normalizePromptAnimationTime(act.endTime),
+        scenes: act.scenes.map((scene) => ({
+            ...scene,
+            startTime: normalizePromptAnimationTime(scene.startTime),
+            endTime: normalizePromptAnimationTime(scene.endTime),
+            shotRefs: scene.shotRefs.map((shot) => ({
+                ...shot,
+                startTime: normalizePromptAnimationTime(shot.startTime),
+                endTime: normalizePromptAnimationTime(shot.endTime)
+            }))
+        }))
+    };
+}
+//# sourceMappingURL=EpisodeStructure.js.map

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

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

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

@@ -0,0 +1,13 @@
+export type EpisodeTemplateId = "short-form" | "standard" | "series-pilot" | "educational" | "music-video";
+export interface EpisodeTemplate {
+    readonly id: EpisodeTemplateId;
+    readonly label: string;
+    readonly durationMinutes: readonly [number, number];
+    readonly characterRange: readonly [number, number];
+    readonly beatRange: readonly [number, number];
+    readonly cameraStyle: string;
+    readonly musicCue: string;
+}
+export declare const episodeTemplates: readonly EpisodeTemplate[];
+export declare function episodeTemplate(id: EpisodeTemplateId): EpisodeTemplate;
+//# sourceMappingURL=EpisodeTemplates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EpisodeTemplates.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/EpisodeTemplates.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,UAAU,GAAG,cAAc,GAAG,aAAa,GAAG,aAAa,CAAC;AAE3G,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,EAAE,SAAS,eAAe,EAMtD,CAAC;AAEF,wBAAgB,eAAe,CAAC,EAAE,EAAE,iBAAiB,GAAG,eAAe,CAItE"}