@aura3d/engine 1.4.4 → 1.5.0

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":"AAAA,OAAO,EAAE,0BAA0B,EAA+D,MAAM,8BAA8B,CAAC;AAmDvI,MAAM,UAAU,0BAA0B,CAAC,OAA6C;IACtF,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,SAAS,EAAE,mCAAmC,CAAC,OAAO,CAAC,EAAE,CAAC;AAC9G,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,QAA8B;IACzE,OAAO,mCAAmC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,OAA6C;IAE7C,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,wBAAwB,GAAG,CAAC,CAAC;IAEjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,cAAc,IAAI,CAAC,CAAC;QACpD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;YAAE,QAAQ,IAAI,CAAC,CAAC;QACxE,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS,IAAI,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,UAAU,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,aAAa;YAAE,iBAAiB,IAAI,CAAC,CAAC;QACtE,IAAI,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,wBAAwB,IAAI,CAAC,CAAC;QAEpG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CACT,0BAA0B,CAAC,OAAO,EAAE,uCAAuC,EAAE,kBAAkB,KAAK,CAAC,EAAE,+DAA+D,KAAK,CAAC,EAAE,GAAG,EAAE;gBACjL,IAAI,EAAE,WAAW,KAAK,CAAC,EAAE,UAAU;aACpC,CAAC,CACH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,OAAO,EAAE,+BAA+B,EAAE,kBAAkB,KAAK,CAAC,EAAE,oBAAoB,EAAE;gBAC/H,IAAI,EAAE,WAAW,KAAK,CAAC,EAAE,UAAU;aACpC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/E,MAAM,CAAC,IAAI,CACT,0BAA0B,CAAC,OAAO,EAAE,2CAA2C,EAAE,oBAAoB,KAAK,CAAC,EAAE,gEAAgE,EAAE;gBAC7K,IAAI,EAAE,WAAW,KAAK,CAAC,EAAE,eAAe;aACzC,CAAC,CACH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YACvF,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,OAAO,EAAE,8BAA8B,EAAE,cAAc,KAAK,CAAC,EAAE,wBAAwB,EAAE;gBAC9H,IAAI,EAAE,WAAW,KAAK,CAAC,EAAE,WAAW;aACrC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,OAAO,EAAE,gCAAgC,EAAE,gBAAgB,KAAK,CAAC,EAAE,wBAAwB,EAAE;gBAClI,IAAI,EAAE,WAAW,KAAK,CAAC,EAAE,aAAa;aACvC,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IAED,OAAO;QACL,cAAc;QACd,QAAQ;QACR,SAAS;QACT,UAAU;QACV,iBAAiB;QACjB,wBAAwB;QACxB,MAAM;KACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,120 @@
+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 CartoonRenderOutputPackageMetadata, type CartoonRenderQueueArtifact, type CartoonViewport } from "./CartoonRenderQueue.js";
+import { type ShotTimelineArtifact } from "./ShotTimeline.js";
+export interface CartoonDirectorCharacterInput {
+    readonly id: PromptAnimationId;
+    readonly name: string;
+    readonly role?: PromptAnimationCharacter["role"] | undefined;
+    readonly voiceId?: string | undefined;
+    readonly asset?: AuraAssetRef<"model"> | undefined;
+    readonly style?: string | undefined;
+}
+export interface CartoonDirectorLocationInput {
+    readonly id: PromptAnimationId;
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly mood?: string | undefined;
+}
+export interface CartoonDirectorPropInput {
+    readonly id: PromptAnimationId;
+    readonly name: string;
+    readonly role?: PromptAnimationProp["role"] | undefined;
+    readonly description?: string | undefined;
+    readonly ownerCharacterId?: PromptAnimationId | undefined;
+    readonly locationId?: PromptAnimationId | undefined;
+    readonly asset?: AuraAssetRef<"model"> | undefined;
+    readonly primitiveFallback?: string | undefined;
+    readonly styleNotes?: readonly string[] | undefined;
+    readonly safetyNotes?: readonly string[] | undefined;
+}
+export interface CartoonDirectorDialogueInput {
+    readonly speakerId: PromptAnimationId;
+    readonly text: string;
+    readonly emotion?: string | undefined;
+    readonly delivery?: string | undefined;
+    readonly audioFile?: string | undefined;
+}
+export interface CartoonDirectorBeatInput {
+    readonly id: PromptAnimationId;
+    readonly sceneId?: PromptAnimationId | undefined;
+    readonly shotId?: PromptAnimationId | undefined;
+    readonly locationId: PromptAnimationId;
+    readonly summary: string;
+    readonly visualIntent: string;
+    readonly duration?: PromptAnimationSeconds | undefined;
+    readonly characters: readonly PromptAnimationId[];
+    readonly props?: readonly PromptAnimationId[] | undefined;
+    readonly dialogue?: readonly CartoonDirectorDialogueInput[] | undefined;
+    readonly mood?: string | undefined;
+    readonly gestureByCharacterId?: Record<string, PromptAnimationId> | undefined;
+    readonly blockingByCharacterId?: Record<string, {
+        readonly position?: readonly [number, number, number] | undefined;
+        readonly layer?: string | undefined;
+    }> | undefined;
+}
+export interface CartoonDirectorInput {
+    readonly episodeId: PromptAnimationId;
+    readonly title: string;
+    readonly prompt: string;
+    readonly language: PromptAnimationLanguageCode;
+    readonly runtime: PromptAnimationRuntimeSpec;
+    readonly characters: readonly CartoonDirectorCharacterInput[];
+    readonly locations: readonly CartoonDirectorLocationInput[];
+    readonly props?: readonly CartoonDirectorPropInput[] | undefined;
+    readonly styleGuide?: Partial<PromptAnimationStyleGuide> | undefined;
+    readonly continuityRules?: readonly string[] | undefined;
+    readonly beats: readonly CartoonDirectorBeatInput[];
+    readonly safety?: Partial<PromptAnimationSafetyMetadata> | undefined;
+    readonly accessibilityProof?: PromptAnimationAccessibilityProofMetadata | undefined;
+    readonly route?: string | undefined;
+    readonly viewport?: CartoonViewport | undefined;
+    readonly generatedAt?: string | undefined;
+}
+export interface CartoonDirectorPlan {
+    readonly kind: "cartoon-director-plan";
+    readonly episodePlan: PromptAnimationEpisodePlan;
+    readonly storyBible: PromptAnimationStoryBible;
+    readonly storyboard: PromptAnimationStoryboard;
+    readonly shotTimeline: ShotTimelineArtifact;
+    readonly dialogueTrack: DialogueTrackArtifact;
+    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;
+export declare function compilePromptEpisodePlan(input: CartoonDirectorInput): CartoonDirectorPlan;
+export declare const cartoonDirector: {
+    readonly compile: typeof compilePromptEpisodePlan;
+    readonly createPlan: typeof createCartoonDirectorPlan;
+    readonly definePlan: typeof defineCartoonDirectorPlan;
+};
+//# sourceMappingURL=CartoonDirector.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,432 @@
+import { createPromptAnimationEpisodePlan, createPromptAnimationStoryBible, promptAnimationContractVersion } from "./PromptAnimationContract.js";
+import { createCartoonPerformance, resolveCartoonEmotionPose, resolveCartoonGesture } from "./CartoonPerformance.js";
+import { createDialogueTrack, deriveCaptionTrackFromDialogue } from "./DialoguePerformance.js";
+import { createCartoonRenderOutputPackageMetadata, createCartoonRenderQueue } from "./CartoonRenderQueue.js";
+import { createShotTimeline } from "./ShotTimeline.js";
+export function defineCartoonDirectorPlan(plan) {
+    return plan;
+}
+export function createCartoonDirectorPlan(input) {
+    const characters = input.characters.map((character) => ({
+        id: character.id,
+        name: character.name,
+        role: character.role ?? "hero",
+        ...(character.voiceId ? { voiceId: character.voiceId } : {}),
+        language: input.language,
+        ...(character.style ? { style: character.style } : {}),
+        rig: {
+            ...(character.asset ? { asset: character.asset } : {}),
+            facing: "camera",
+            scale: 1,
+            mouthFallback: character.asset ? "blendshape" : "primitive-mouth-card"
+        }
+    }));
+    const locations = input.locations.map((location) => ({
+        id: location.id,
+        name: location.name,
+        ...(location.description ? { description: location.description } : {}),
+        ...(location.mood ? { mood: location.mood } : {})
+    }));
+    const props = (input.props ?? []).map((prop) => ({
+        id: prop.id,
+        name: prop.name,
+        role: prop.role ?? "set-dressing",
+        ...(prop.description ? { description: prop.description } : {}),
+        ...(prop.ownerCharacterId ? { ownerCharacterId: prop.ownerCharacterId } : {}),
+        ...(prop.locationId ? { locationId: prop.locationId } : {}),
+        ...(prop.asset ? { asset: prop.asset } : {}),
+        ...(prop.primitiveFallback ? { primitiveFallback: prop.primitiveFallback } : {}),
+        ...(prop.styleNotes ? { styleNotes: prop.styleNotes } : {}),
+        ...(prop.safetyNotes ? { safetyNotes: prop.safetyNotes } : {})
+    }));
+    const episodePlan = createPromptAnimationEpisodePlan({
+        episodeId: input.episodeId,
+        title: input.title,
+        language: input.language,
+        runtime: input.runtime,
+        characters,
+        locations,
+        production: {
+            sourcePrompt: input.prompt,
+            target: "youtube",
+            reviewStatus: "draft"
+        },
+        safety: input.safety,
+        accessibilityProof: input.accessibilityProof,
+        generatedAt: input.generatedAt
+    });
+    const beatDuration = input.beats.length > 0 ? input.runtime.duration / input.beats.length : input.runtime.duration;
+    let cursor = 0;
+    const shots = [];
+    const dialogueLines = [];
+    const performanceCues = [];
+    for (const [index, beat] of input.beats.entries()) {
+        const duration = beat.duration ?? beatDuration;
+        const startTime = cursor;
+        const endTime = cursor + duration;
+        const sceneId = beat.sceneId ?? `scene-${index + 1}`;
+        const shotId = beat.shotId ?? `shot-${index + 1}`;
+        const midpoint = startTime + duration / 2;
+        shots.push({
+            id: shotId,
+            shotId,
+            sceneId,
+            startTime,
+            endTime,
+            transitionIn: index === 0 ? "cut" : "match-cut",
+            transitionOut: "cut",
+            camera: {
+                move: index % 3 === 0 ? "push-in" : "static",
+                notes: [beat.visualIntent]
+            },
+            characters: beat.characters.map((characterId) => ({
+                characterId,
+                ...(beat.blockingByCharacterId?.[characterId]?.position
+                    ? { position: beat.blockingByCharacterId[characterId].position }
+                    : { position: defaultCharacterBlockingPosition(beat.characters.indexOf(characterId), beat.characters.length) }),
+                action: beat.dialogue?.some((line) => line.speakerId === characterId) ? "speak" : "listen",
+                facing: "camera",
+                emotion: beat.dialogue?.find((line) => line.speakerId === characterId)?.emotion ?? "neutral",
+                pose: resolveCartoonEmotionPose(beat.dialogue?.find((line) => line.speakerId === characterId)?.emotion).id,
+                gestureId: beat.gestureByCharacterId?.[characterId]
+            })),
+            ...(beat.props
+                ? {
+                    props: beat.props.map((propId) => ({
+                        propId,
+                        visible: true,
+                        action: "storyboard-required"
+                    }))
+                }
+                : {}),
+            captureTimes: [startTime, midpoint],
+            ...(beat.dialogue && beat.dialogue.length > 0
+                ? { captions: beat.dialogue.map((_, lineIndex) => `${shotId}:line-${lineIndex + 1}:caption`) }
+                : {}),
+            intent: beat.visualIntent
+        });
+        const dialogue = beat.dialogue ?? [];
+        const lineDuration = dialogue.length > 0 ? duration / dialogue.length : 0;
+        dialogue.forEach((line, lineIndex) => {
+            const lineStart = startTime + lineDuration * lineIndex;
+            const lineEnd = lineIndex === dialogue.length - 1 ? endTime : lineStart + lineDuration;
+            const lineId = `${shotId}:line-${lineIndex + 1}`;
+            dialogueLines.push({
+                lineId,
+                speakerId: line.speakerId,
+                text: line.text,
+                language: input.language,
+                ...(line.audioFile ? { audioFile: line.audioFile } : {}),
+                startTime: lineStart,
+                endTime: lineEnd,
+                emotion: line.emotion ?? "neutral",
+                delivery: line.delivery ?? "natural",
+                direction: beat.summary
+            });
+            performanceCues.push({
+                id: `${lineId}:speak`,
+                shotId,
+                characterId: line.speakerId,
+                lineId,
+                startTime: lineStart,
+                endTime: lineEnd,
+                action: "speak",
+                emotion: line.emotion ?? "neutral",
+                emotionPoseId: resolveCartoonEmotionPose(line.emotion ?? "neutral").id,
+                intensity: line.emotion === "excited" ? 1 : 0.66,
+                body: resolveCartoonEmotionPose(line.emotion ?? "neutral").body,
+                facial: resolveCartoonEmotionPose(line.emotion ?? "neutral").facial,
+                gestureId: beat.gestureByCharacterId?.[line.speakerId] ?? defaultGestureForEmotion(line.emotion),
+                ...(createCueGestureState(beat.gestureByCharacterId?.[line.speakerId] ?? defaultGestureForEmotion(line.emotion))
+                    ? { gesture: createCueGestureState(beat.gestureByCharacterId?.[line.speakerId] ?? defaultGestureForEmotion(line.emotion)) }
+                    : {}),
+                blocking: {
+                    position: beat.blockingByCharacterId?.[line.speakerId]?.position ??
+                        defaultCharacterBlockingPosition(beat.characters.indexOf(line.speakerId), beat.characters.length),
+                    visible: true,
+                    layer: beat.blockingByCharacterId?.[line.speakerId]?.layer ?? "midground"
+                },
+                gaze: {
+                    mode: "listener",
+                    targetId: beat.characters.find((characterId) => characterId !== line.speakerId),
+                    intensity: 0.72
+                },
+                notes: [line.delivery ?? "natural"]
+            });
+        });
+        for (const characterId of beat.characters) {
+            if (dialogue.some((line) => line.speakerId === characterId))
+                continue;
+            const listenPose = resolveCartoonEmotionPose(beat.mood === "soft neon bedtime" ? "happy" : "neutral");
+            performanceCues.push({
+                id: `${shotId}:${characterId}:listen`,
+                shotId,
+                characterId,
+                startTime,
+                endTime,
+                action: "listen",
+                emotion: listenPose.emotion,
+                emotionPoseId: listenPose.id,
+                intensity: 0.45,
+                body: listenPose.body,
+                facial: listenPose.facial,
+                gestureId: beat.gestureByCharacterId?.[characterId] ?? "soft-nod",
+                gesture: resolveCartoonGesture(beat.gestureByCharacterId?.[characterId] ?? "soft-nod")?.gesture,
+                blocking: {
+                    position: beat.blockingByCharacterId?.[characterId]?.position ??
+                        defaultCharacterBlockingPosition(beat.characters.indexOf(characterId), beat.characters.length),
+                    visible: true,
+                    layer: beat.blockingByCharacterId?.[characterId]?.layer ?? "midground"
+                },
+                gaze: {
+                    mode: "speaker",
+                    targetId: dialogue[0]?.speakerId,
+                    intensity: 0.58
+                },
+                notes: [`Listening during ${beat.summary}`]
+            });
+        }
+        cursor = endTime;
+    }
+    const storyboard = {
+        artifact: "storyboard",
+        contractId: promptAnimationContractVersion,
+        episodeId: input.episodeId,
+        title: input.title,
+        scenes: input.beats.map((beat, index) => {
+            const sceneId = beat.sceneId ?? `scene-${index + 1}`;
+            const shotId = beat.shotId ?? `shot-${index + 1}`;
+            return {
+                id: sceneId,
+                sceneId,
+                locationId: beat.locationId,
+                storyBeat: beat.summary,
+                ...(beat.mood ? { mood: beat.mood } : {}),
+                shots: [
+                    {
+                        id: shotId,
+                        shotId,
+                        storyBeat: beat.summary,
+                        characters: beat.characters,
+                        ...(beat.props ? { props: beat.props } : {}),
+                        ...(beat.mood ? { mood: beat.mood } : {}),
+                        visualIntent: beat.visualIntent,
+                        ...(beat.duration ? { suggestedDuration: beat.duration } : {})
+                    }
+                ]
+            };
+        }),
+        ...(input.generatedAt ? { generatedAt: input.generatedAt } : {})
+    };
+    const shotTimeline = createShotTimeline({
+        episodeId: input.episodeId,
+        frameRate: input.runtime.frameRate,
+        duration: input.runtime.duration,
+        shots,
+        generatedAt: input.generatedAt
+    });
+    const dialogueTrack = createDialogueTrack({
+        episodeId: input.episodeId,
+        language: input.language,
+        lines: dialogueLines,
+        duration: input.runtime.duration,
+        generatedAt: input.generatedAt
+    });
+    const captionTrack = deriveCaptionTrackFromDialogue(dialogueTrack, { generatedAt: input.generatedAt });
+    const performance = createCartoonPerformance({
+        episodeId: input.episodeId,
+        frameRate: input.runtime.frameRate,
+        cues: performanceCues,
+        generatedAt: input.generatedAt
+    });
+    const styleGuide = createCartoonStoryBibleStyleGuide(input.styleGuide);
+    const storyBible = createPromptAnimationStoryBible({
+        episodeId: input.episodeId,
+        title: input.title,
+        logline: input.prompt,
+        characters,
+        locations,
+        props,
+        styleGuide,
+        shotList: shots.map((shot) => {
+            const matchingBeat = input.beats.find((beat) => (beat.shotId ?? `shot-${input.beats.indexOf(beat) + 1}`) === shot.shotId);
+            return {
+                shotId: shot.shotId,
+                sceneId: shot.sceneId,
+                locationId: matchingBeat?.locationId ?? input.locations[0]?.id ?? "location",
+                purpose: shot.intent ?? matchingBeat?.summary ?? shot.shotId,
+                characters: shot.characters.map((character) => character.characterId),
+                ...(matchingBeat?.props ? { props: matchingBeat.props } : {}),
+                startTime: shot.startTime,
+                endTime: shot.endTime,
+                duration: shot.endTime - shot.startTime,
+                camera: shot.camera.move,
+                ...(shot.captions ? { captionIds: shot.captions } : {}),
+                continuityNotes: [
+                    `Scene ${shot.sceneId} and shot ${shot.shotId} ids must stay stable across AuraVoice dubbing and rerender passes.`
+                ]
+            };
+        }),
+        continuityRules: input.continuityRules ??
+            [
+                "Do not change character ids, storyboard scene ids, shot ids, caption ids, or dialogue line ids during dubbing.",
+                "AuraVoice timing artifacts remain the master clock for captions, visemes, audio stems, and render captures.",
+                "Primitive fallback props may be replaced by typed GLB assets only through generated ./aura-assets imports."
+            ],
+        generatedAt: input.generatedAt
+    });
+    const renderQueue = createCartoonRenderQueue({
+        episodePlan,
+        shotTimeline,
+        route: input.route ?? "/prompt-animation",
+        viewport: input.viewport,
+        generatedAt: input.generatedAt
+    });
+    const renderOutputPackage = createCartoonRenderOutputPackageMetadata({
+        episodePlan,
+        shotTimeline,
+        renderQueue,
+        generatedAt: input.generatedAt
+    });
+    return {
+        kind: "cartoon-director-plan",
+        episodePlan,
+        storyBible,
+        storyboard,
+        shotTimeline,
+        dialogueTrack,
+        captionTrack,
+        performance,
+        renderQueue,
+        renderOutputPackage,
+        assetSlots: createCartoonDirectorAssetSlots(characters, locations, props),
+        motionRequirements: createCartoonDirectorMotionRequirements(shots, dialogueLines, performanceCues),
+        reviewGates: createCartoonDirectorReviewGates(renderOutputPackage)
+    };
+}
+export function compilePromptEpisodePlan(input) {
+    return createCartoonDirectorPlan(input);
+}
+export const cartoonDirector = {
+    compile: compilePromptEpisodePlan,
+    createPlan: createCartoonDirectorPlan,
+    definePlan: defineCartoonDirectorPlan
+};
+function createCartoonStoryBibleStyleGuide(input) {
+    return {
+        visualStyle: input?.visualStyle ?? "rounded bedtime sci-fi cartoon with readable silhouettes",
+        palette: input?.palette ?? ["#081b2a", "#7de2ff", "#ffe18e", "#40ffbf", "#f8fff2"],
+        shapeLanguage: input?.shapeLanguage ?? "soft circles, chunky robot forms, oversized safe props, and simple moon-garden silhouettes",
+        lighting: input?.lighting ?? "soft high-contrast blue key light with warm prop glows and reduced flash",
+        cameraLanguage: input?.cameraLanguage ?? "stable wide and medium shots, gentle push-ins, hard cuts only at shot boundaries",
+        motionRules: input?.motionRules ??
+            [
+                "Keep character gestures small enough for reduced-motion playback.",
+                "Use app.onFrame shot playback rather than recreating the Aura app per frame.",
+                "Captions, visemes, and mouth cards sample from the AuraVoice master clock."
+            ],
+        captionStyle: input?.captionStyle ?? "bottom-center high-contrast rounded plate with line-safe caption text",
+        ...(input?.continuityRules ? { continuityRules: input.continuityRules } : {})
+    };
+}
+function defaultCharacterBlockingPosition(index, total) {
+    if (total <= 1)
+        return [0, 0.7, 0];
+    const spacing = 1.55 / Math.max(1, total - 1);
+    return [-0.775 + spacing * index, 0.72, 0];
+}
+function defaultGestureForEmotion(emotion) {
+    if (emotion === "excited")
+        return "two-hand-wave";
+    if (emotion === "happy")
+        return "small-wave";
+    if (emotion === "curious")
+        return "curious-lean";
+    if (emotion === "concerned")
+        return "gentle-point";
+    return undefined;
+}
+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