@aura3d/engine 1.0.8 → 1.0.10

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

@@ -0,0 +1,45 @@
+import { type PromptAnimationId, type PromptAnimationValidationIssue } from "./PromptAnimationContract.js";
+export type ShotCompositionRule = "rule-of-thirds" | "center-safe" | "headroom" | "leading-room";
+export interface ShotCompositionGuide {
+    readonly rule: ShotCompositionRule;
+    readonly lines: readonly {
+        readonly axis: "x" | "y";
+        readonly value: number;
+    }[];
+    readonly safeArea: {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly notes: readonly string[];
+}
+export interface ShotSubjectFrameBox {
+    readonly subjectId: PromptAnimationId;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly facing?: "left" | "right" | "camera" | "three-quarter" | undefined;
+}
+export interface ShotCompositionRuleOptions {
+    readonly ruleOfThirdsTolerance?: number | undefined;
+    readonly minHeadroom?: number | undefined;
+    readonly maxHeadroom?: number | undefined;
+    readonly minLeadingRoom?: number | undefined;
+    readonly safeAreaMargin?: number | undefined;
+}
+export interface ShotCompositionReport {
+    readonly subjectCount: number;
+    readonly score: number;
+    readonly issues: readonly PromptAnimationValidationIssue[];
+    readonly overlays: readonly ShotCompositionOverlay[];
+}
+export interface ShotCompositionOverlay {
+    readonly kind: "rule-of-thirds" | "safe-area" | "headroom" | "leading-room";
+    readonly lines?: readonly number[] | undefined;
+    readonly margin?: number | undefined;
+}
+export declare function createShotCompositionGuide(rule: ShotCompositionRule, aspectRatio?: number): ShotCompositionGuide;
+export declare function evaluateShotComposition(subjects: readonly ShotSubjectFrameBox[], options?: ShotCompositionRuleOptions): ShotCompositionReport;
+//# sourceMappingURL=ShotCompositionRules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ShotCompositionRules.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/ShotCompositionRules.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,iBAAiB,EAAE,KAAK,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAEvI,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,aAAa,GAAG,UAAU,GAAG,cAAc,CAAC;AAEjG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChF,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/G,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,CAAC;CAC7E;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,EAAE,WAAW,SAAS,GAAG,oBAAoB,CAWhH;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,EACxC,OAAO,GAAE,0BAA+B,GACvC,qBAAqB,CAyCvB"}

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

@@ -0,0 +1,54 @@
+import { createPromptAnimationIssue } from "./PromptAnimationContract.js";
+export function createShotCompositionGuide(rule, aspectRatio = 16 / 9) {
+    const safeX = rule === "center-safe" ? 0.12 : 0.08;
+    const safeY = rule === "headroom" ? 0.06 : 0.08;
+    return {
+        rule,
+        lines: rule === "rule-of-thirds"
+            ? [{ axis: "x", value: 1 / 3 }, { axis: "x", value: 2 / 3 }, { axis: "y", value: 1 / 3 }, { axis: "y", value: 2 / 3 }]
+            : [{ axis: "x", value: 0.5 }, { axis: "y", value: rule === "headroom" ? 0.42 : 0.5 }],
+        safeArea: { x: safeX, y: safeY, width: 1 - safeX * 2, height: Math.min(1 - safeY * 2, (1 - safeX * 2) / aspectRatio) },
+        notes: rule === "leading-room" ? ["Leave extra room in the subject's facing direction."] : []
+    };
+}
+export function evaluateShotComposition(subjects, options = {}) {
+    const issues = [];
+    const thirds = [1 / 3, 2 / 3];
+    const tolerance = options.ruleOfThirdsTolerance ?? 0.08;
+    const safeAreaMargin = options.safeAreaMargin ?? 0.05;
+    const minHeadroom = options.minHeadroom ?? 0.03;
+    const maxHeadroom = options.maxHeadroom ?? 0.18;
+    const minLeadingRoom = options.minLeadingRoom ?? 0.08;
+    for (const subject of subjects) {
+        const centerX = subject.x + subject.width / 2;
+        const nearThird = thirds.some((third) => Math.abs(centerX - third) <= tolerance);
+        if (!nearThird && subjects.length <= 2) {
+            issues.push(createPromptAnimationIssue("warning", "shot-composition-thirds", `Subject "${subject.subjectId}" is not near a rule-of-thirds vertical.`, { path: `subjects.${subject.subjectId}` }));
+        }
+        const headroom = subject.y;
+        if (headroom < minHeadroom || headroom > maxHeadroom) {
+            issues.push(createPromptAnimationIssue("warning", "shot-composition-headroom", `Subject "${subject.subjectId}" headroom is outside the preferred range.`, { path: `subjects.${subject.subjectId}.y` }));
+        }
+        if (subject.x < safeAreaMargin || subject.y < safeAreaMargin || subject.x + subject.width > 1 - safeAreaMargin || subject.y + subject.height > 1 - safeAreaMargin) {
+            issues.push(createPromptAnimationIssue("error", "shot-composition-safe-area", `Subject "${subject.subjectId}" leaves the safe title area.`, { path: `subjects.${subject.subjectId}` }));
+        }
+        if (subject.facing === "left" && subject.x < minLeadingRoom) {
+            issues.push(createPromptAnimationIssue("warning", "shot-composition-leading-room", `Subject "${subject.subjectId}" needs more leading room to the left.`, { path: `subjects.${subject.subjectId}.x` }));
+        }
+        if (subject.facing === "right" && 1 - (subject.x + subject.width) < minLeadingRoom) {
+            issues.push(createPromptAnimationIssue("warning", "shot-composition-leading-room", `Subject "${subject.subjectId}" needs more leading room to the right.`, { path: `subjects.${subject.subjectId}.x` }));
+        }
+    }
+    return {
+        subjectCount: subjects.length,
+        score: Math.max(0, 1 - issues.length / Math.max(1, subjects.length * 4)),
+        issues,
+        overlays: [
+            { kind: "rule-of-thirds", lines: thirds },
+            { kind: "safe-area", margin: safeAreaMargin },
+            { kind: "headroom", lines: [minHeadroom, maxHeadroom] },
+            { kind: "leading-room", margin: minLeadingRoom }
+        ]
+    };
+}
+//# sourceMappingURL=ShotCompositionRules.js.map

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

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

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

@@ -0,0 +1,46 @@
+import { type PromptAnimationId, type PromptAnimationSeconds } from "./PromptAnimationContract.js";
+import type { ShotTimelineArtifact, ShotTimelineShot, ShotTransition } from "./ShotTimeline.js";
+export type ShotTransitionKind = ShotTransition | "crossfade" | "dip-to-black";
+export type WipeDirection = "left" | "right" | "up" | "down";
+export interface ShotTransitionDescriptor {
+    readonly id: PromptAnimationId;
+    readonly kind: ShotTransitionKind;
+    readonly fromShotId?: PromptAnimationId | undefined;
+    readonly toShotId?: PromptAnimationId | undefined;
+    readonly startTime: PromptAnimationSeconds;
+    readonly endTime: PromptAnimationSeconds;
+    readonly duration: PromptAnimationSeconds;
+    readonly direction?: WipeDirection | undefined;
+    readonly color?: string | undefined;
+    readonly matchTargetId?: PromptAnimationId | undefined;
+}
+export interface ShotTransitionSample {
+    readonly time: PromptAnimationSeconds;
+    readonly transition?: ShotTransitionDescriptor | undefined;
+    readonly progress: number;
+    readonly fromOpacity: number;
+    readonly toOpacity: number;
+    readonly overlayOpacity: number;
+    readonly wipeProgress?: number | undefined;
+}
+export interface ShotTransitionPlan {
+    readonly kind: "shot-transition-plan";
+    readonly episodeId: PromptAnimationId;
+    readonly transitions: readonly ShotTransitionDescriptor[];
+}
+export interface LegacyShotTransitionSample {
+    readonly kind: "shot-transition-sample";
+    readonly transition: ShotTransition;
+    readonly progress: number;
+    readonly outgoingOpacity: number;
+    readonly incomingOpacity: number;
+    readonly wipeOffset: number;
+}
+export declare function createShotTransitionPlan(input: {
+    readonly timeline: ShotTimelineArtifact;
+    readonly defaultDuration?: PromptAnimationSeconds | undefined;
+}): ShotTransitionPlan;
+export declare function sampleShotTransition(plan: ShotTransitionPlan, time: PromptAnimationSeconds): ShotTransitionSample;
+export declare function sampleShotTransition(transition: ShotTransition, progress: number): LegacyShotTransitionSample;
+export declare function createShotTransitionDescriptor(fromShot: ShotTimelineShot, toShot: ShotTimelineShot, kind: ShotTransitionKind, duration: PromptAnimationSeconds): ShotTransitionDescriptor;
+//# sourceMappingURL=ShotTransitionEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ShotTransitionEngine.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/ShotTransitionEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACjI,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEhG,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,WAAW,GAAG,cAAc,CAAC;AAC/E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC3D;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAC/D,GAAG,kBAAkB,CAgBrB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,sBAAsB,GAAG,oBAAoB,CAAC;AACnH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,0BAA0B,CAAC;AAsD/G,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,sBAAsB,GAC/B,wBAAwB,CAgB1B"}

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

@@ -0,0 +1,98 @@
+import { normalizePromptAnimationTime } from "./PromptAnimationContract.js";
+export function createShotTransitionPlan(input) {
+    const defaultDuration = input.defaultDuration ?? 0.35;
+    const transitions = [];
+    for (let index = 0; index < input.timeline.shots.length - 1; index += 1) {
+        const fromShot = input.timeline.shots[index];
+        const toShot = input.timeline.shots[index + 1];
+        if (!fromShot || !toShot)
+            continue;
+        const kind = normalizeTransitionKind(fromShot.transitionOut ?? toShot.transitionIn ?? "cut");
+        const duration = transitionDuration(kind, defaultDuration);
+        transitions.push(createShotTransitionDescriptor(fromShot, toShot, kind, duration));
+    }
+    return {
+        kind: "shot-transition-plan",
+        episodeId: input.timeline.episodeId,
+        transitions
+    };
+}
+export function sampleShotTransition(planOrTransition, timeOrProgress) {
+    if (typeof planOrTransition === "string") {
+        const t = Math.min(1, Math.max(0, timeOrProgress));
+        return {
+            kind: "shot-transition-sample",
+            transition: planOrTransition,
+            progress: t,
+            outgoingOpacity: planOrTransition === "cut" ? 0 : planOrTransition === "hold" ? 1 : 1 - t,
+            incomingOpacity: planOrTransition === "cut" ? 1 : planOrTransition === "hold" ? 0 : t,
+            wipeOffset: planOrTransition === "wipe" ? t : 0
+        };
+    }
+    const plan = planOrTransition;
+    const time = timeOrProgress;
+    const normalized = normalizePromptAnimationTime(time);
+    const transition = plan.transitions.find((candidate) => normalized > candidate.startTime && normalized < candidate.endTime);
+    if (!transition) {
+        return {
+            time: normalized,
+            progress: 1,
+            fromOpacity: 0,
+            toOpacity: 1,
+            overlayOpacity: 0
+        };
+    }
+    const progress = transition.duration <= 0 ? 1 : Math.max(0, Math.min(1, (normalized - transition.startTime) / transition.duration));
+    if (transition.kind === "cut" || transition.kind === "hold") {
+        return { time: normalized, transition, progress: 1, fromOpacity: 0, toOpacity: 1, overlayOpacity: 0 };
+    }
+    if (transition.kind === "dip-to-black" || transition.kind === "fade") {
+        return {
+            time: normalized,
+            transition,
+            progress,
+            fromOpacity: progress < 0.5 ? 1 - progress * 2 : 0,
+            toOpacity: progress < 0.5 ? 0 : (progress - 0.5) * 2,
+            overlayOpacity: 1 - Math.abs(progress - 0.5) * 2
+        };
+    }
+    return {
+        time: normalized,
+        transition,
+        progress,
+        fromOpacity: 1 - progress,
+        toOpacity: progress,
+        overlayOpacity: 0,
+        ...(transition.kind === "wipe" ? { wipeProgress: progress } : {})
+    };
+}
+export function createShotTransitionDescriptor(fromShot, toShot, kind, duration) {
+    const startTime = normalizePromptAnimationTime(toShot.startTime);
+    const endTime = normalizePromptAnimationTime(Math.min(toShot.endTime, toShot.startTime + duration));
+    const actualDuration = Math.max(0, endTime - startTime);
+    return {
+        id: `${fromShot.shotId}:to:${toShot.shotId}`,
+        kind,
+        fromShotId: fromShot.shotId,
+        toShotId: toShot.shotId,
+        startTime,
+        endTime,
+        duration: normalizePromptAnimationTime(actualDuration),
+        ...(kind === "wipe" ? { direction: "left" } : {}),
+        ...(kind === "dip-to-black" || kind === "fade" ? { color: "#000000" } : {}),
+        ...(kind === "match-cut" ? { matchTargetId: toShot.characters[0]?.characterId } : {})
+    };
+}
+function normalizeTransitionKind(kind) {
+    if (kind === "fade")
+        return "crossfade";
+    return kind;
+}
+function transitionDuration(kind, defaultDuration) {
+    if (kind === "cut")
+        return 0;
+    if (kind === "hold")
+        return Math.max(defaultDuration, 0.5);
+    return defaultDuration;
+}
+//# sourceMappingURL=ShotTransitionEngine.js.map

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

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

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

@@ -0,0 +1,44 @@
+import type { CartoonRenderOutputPackageMetadata, CartoonThumbnailSceneStateCapture, CartoonViewport } from "./CartoonRenderQueue.js";
+import { type PromptAnimationId, type PromptAnimationSeconds } from "./PromptAnimationContract.js";
+export interface ThumbnailGenerationPlan {
+    readonly kind: "thumbnail-generation-plan";
+    readonly episodeId: PromptAnimationId;
+    readonly capture: CartoonThumbnailSceneStateCapture;
+    readonly outputPath: string;
+    readonly width: number;
+    readonly height: number;
+    readonly mimeType: "image/webp" | "image/png" | "image/jpeg";
+    readonly time: PromptAnimationSeconds;
+    readonly resizeMode: "cover" | "contain";
+}
+export interface ThumbnailArtifact {
+    readonly kind: "thumbnail";
+    readonly plan: ThumbnailGenerationPlan;
+    readonly path: string;
+    readonly width: number;
+    readonly height: number;
+    readonly time: PromptAnimationSeconds;
+    readonly mimeType: "image/webp" | "image/png" | "image/jpeg";
+    readonly byteLength: number;
+    readonly checksum: string;
+    readonly image?: Blob | Uint8Array | string | undefined;
+}
+export interface ThumbnailCaptureRuntime {
+    captureThumbnail(plan: ThumbnailGenerationPlan): Promise<Blob | Uint8Array | string | undefined> | Blob | Uint8Array | string | undefined;
+}
+export declare function createThumbnailGenerationPlan(input: {
+    readonly packageMetadata: CartoonRenderOutputPackageMetadata;
+    readonly width?: number | undefined;
+    readonly height?: number | undefined;
+    readonly mimeType?: "image/webp" | "image/png" | "image/jpeg" | undefined;
+    readonly resizeMode?: "cover" | "contain" | undefined;
+}): ThumbnailGenerationPlan;
+export declare function generateThumbnailArtifact(plan: ThumbnailGenerationPlan, runtime: ThumbnailCaptureRuntime): Promise<ThumbnailArtifact>;
+export declare function createThumbnailArtifact(input: {
+    readonly path: string;
+    readonly viewport: CartoonViewport;
+    readonly time: number;
+    readonly data?: Blob | Uint8Array | string | undefined;
+    readonly mimeType?: "image/webp" | "image/png" | "image/jpeg" | undefined;
+}): ThumbnailArtifact;
+//# sourceMappingURL=ThumbnailGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThumbnailGenerator.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/ThumbnailGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACtI,OAAO,EAAgC,KAAK,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEjI,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,iCAAiC,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;IAC7D,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;CAC3I;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,eAAe,EAAE,kCAAkC,CAAC;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;CACvD,GAAG,uBAAuB,CAa1B;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,EAC7B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAG5B;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;CAC3E,GAAG,iBAAiB,CAwBpB"}

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

@@ -0,0 +1,82 @@
+import { normalizePromptAnimationTime } from "./PromptAnimationContract.js";
+export function createThumbnailGenerationPlan(input) {
+    const viewport = youtubeThumbnailViewport(input.packageMetadata.viewport, input.width, input.height);
+    return {
+        kind: "thumbnail-generation-plan",
+        episodeId: input.packageMetadata.episodeId,
+        capture: input.packageMetadata.thumbnailCapture,
+        outputPath: input.packageMetadata.outputs.thumbnail?.path ?? "dist/render/thumbnail.webp",
+        width: viewport.width,
+        height: viewport.height,
+        mimeType: input.mimeType ?? "image/webp",
+        time: normalizePromptAnimationTime(input.packageMetadata.thumbnailCapture.time),
+        resizeMode: input.resizeMode ?? "cover"
+    };
+}
+export async function generateThumbnailArtifact(plan, runtime) {
+    const image = await runtime.captureThumbnail(plan);
+    return createThumbnailArtifactFromPlan(plan, image);
+}
+export function createThumbnailArtifact(input) {
+    const plan = {
+        kind: "thumbnail-generation-plan",
+        episodeId: "thumbnail",
+        capture: {
+            id: "thumbnail:capture",
+            source: "same-aura3d-scene-state",
+            outputId: "thumbnail",
+            outputPath: input.path,
+            route: "",
+            time: input.time,
+            auraVoiceTimestamp: input.time,
+            frame: 0,
+            sourceSceneStateId: "thumbnail:scene-state",
+            deterministicSeed: "thumbnail"
+        },
+        outputPath: input.path,
+        width: input.viewport.width,
+        height: input.viewport.height,
+        mimeType: input.mimeType ?? "image/png",
+        time: input.time,
+        resizeMode: "cover"
+    };
+    return createThumbnailArtifactFromPlan(plan, input.data);
+}
+function createThumbnailArtifactFromPlan(plan, image) {
+    const byteLength = estimateImageByteLength(image, plan);
+    return {
+        kind: "thumbnail",
+        plan,
+        path: plan.outputPath,
+        width: plan.width,
+        height: plan.height,
+        time: plan.time,
+        mimeType: plan.mimeType,
+        byteLength,
+        checksum: thumbnailChecksum(`${plan.outputPath}:${byteLength}:${plan.time}`),
+        ...(image !== undefined ? { image } : {})
+    };
+}
+function youtubeThumbnailViewport(source, width = 1280, height = 720) {
+    if (width > 0 && height > 0)
+        return { width, height };
+    if (source.width / source.height >= 16 / 9)
+        return { width: 1280, height: 720 };
+    return { width: 720, height: 1280 };
+}
+function estimateImageByteLength(image, plan) {
+    if (image instanceof Uint8Array)
+        return image.byteLength;
+    if (typeof Blob !== "undefined" && image instanceof Blob)
+        return image.size;
+    if (typeof image === "string")
+        return image.length;
+    return Math.round(plan.width * plan.height * 0.18);
+}
+function thumbnailChecksum(value) {
+    let hash = 0;
+    for (let index = 0; index < value.length; index += 1)
+        hash = (Math.imul(hash, 31) + value.charCodeAt(index)) | 0;
+    return `thumb-${(hash >>> 0).toString(16).padStart(8, "0")}`;
+}
+//# sourceMappingURL=ThumbnailGenerator.js.map

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

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

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

@@ -0,0 +1,66 @@
+import type { CartoonRenderOutputPackageMetadata, CartoonRenderQueueArtifact, CartoonRenderQueueItem } from "./CartoonRenderQueue.js";
+import { type EncodedVideoArtifact, type FrameEncoder, type FrameEncoderAdapter, type FrameEncoderCodec } from "./FrameEncoder.js";
+import { type AudioMuxer, type AudioMuxerInputStem, type MuxedVideoArtifact } from "./AudioMuxer.js";
+import { type RenderProgressSnapshot, type RenderProgressTracker } from "./RenderProgressTracker.js";
+import type { AudioStemManifestArtifact } from "./DialoguePerformance.js";
+import { type PromptAnimationSeconds } from "./PromptAnimationContract.js";
+export interface VideoExportFrameCapture {
+    readonly item: CartoonRenderQueueItem;
+    readonly image?: ImageBitmap | HTMLCanvasElement | OffscreenCanvas | Blob | Uint8Array | string | undefined;
+}
+export interface VideoExportRuntime {
+    seek?(time: PromptAnimationSeconds, item: CartoonRenderQueueItem): Promise<void> | void;
+    step?(dt: PromptAnimationSeconds, item: CartoonRenderQueueItem): Promise<void> | void;
+    captureFrame(item: CartoonRenderQueueItem): Promise<VideoExportFrameCapture> | VideoExportFrameCapture;
+}
+export interface VideoExportPlan {
+    readonly kind: "video-export-plan";
+    readonly episodeId: string;
+    readonly route: string;
+    readonly frameRate: number;
+    readonly duration: PromptAnimationSeconds;
+    readonly frameCount: number;
+    readonly outputPath: string;
+    readonly outputMimeType: string;
+    readonly codec: FrameEncoderCodec;
+    readonly audioStemCount: number;
+    readonly captionOutputCount: number;
+    readonly thumbnailOutputPath?: string | undefined;
+    readonly evidenceOutputPath?: string | undefined;
+}
+export interface VideoExportResult {
+    readonly kind: "video-export-result";
+    readonly plan: VideoExportPlan;
+    readonly encodedVideo: EncodedVideoArtifact;
+    readonly muxedVideo: MuxedVideoArtifact;
+    readonly progress: RenderProgressSnapshot;
+    readonly checksum: string;
+    readonly renderTimeMs: number;
+}
+export interface CreateVideoExportPipelineOptions {
+    readonly renderQueue: CartoonRenderQueueArtifact;
+    readonly outputPackage: CartoonRenderOutputPackageMetadata;
+    readonly runtime: VideoExportRuntime;
+    readonly audioStems?: readonly AudioMuxerInputStem[] | AudioStemManifestArtifact | undefined;
+    readonly codec?: FrameEncoderCodec | undefined;
+    readonly encoder?: FrameEncoder | undefined;
+    readonly encoderAdapter?: FrameEncoderAdapter | undefined;
+    readonly muxer?: AudioMuxer | undefined;
+    readonly progress?: RenderProgressTracker | undefined;
+    readonly now?: (() => number) | undefined;
+}
+export interface VideoExportPipeline {
+    readonly plan: VideoExportPlan;
+    readonly progress: RenderProgressTracker;
+    render(): Promise<VideoExportResult>;
+    cancel(message?: string): RenderProgressSnapshot;
+}
+export declare function createVideoExportPlan(input: {
+    readonly renderQueue: CartoonRenderQueueArtifact;
+    readonly outputPackage: CartoonRenderOutputPackageMetadata;
+    readonly audioStems?: readonly AudioMuxerInputStem[] | AudioStemManifestArtifact | undefined;
+    readonly codec?: FrameEncoderCodec | undefined;
+}): VideoExportPlan;
+export declare function createVideoExportPipeline(options: CreateVideoExportPipelineOptions): VideoExportPipeline;
+export declare function normalizeAudioStemInput(input?: readonly AudioMuxerInputStem[] | AudioStemManifestArtifact | undefined): readonly AudioMuxerInputStem[];
+//# sourceMappingURL=VideoExportPipeline.d.ts.map

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

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

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

@@ -0,0 +1,108 @@
+import { createFrameEncoder } from "./FrameEncoder.js";
+import { audioStemsFromManifest, createAudioMuxer } from "./AudioMuxer.js";
+import { createRenderProgressTracker } from "./RenderProgressTracker.js";
+import { normalizePromptAnimationTime } from "./PromptAnimationContract.js";
+export function createVideoExportPlan(input) {
+    const videoOutput = input.outputPackage.outputs.webm ?? input.outputPackage.outputs.mp4;
+    const codec = input.codec ?? videoOutput?.codec ?? (videoOutput?.kind === "mp4" ? "h264" : "vp9");
+    const audioStems = normalizeAudioStemInput(input.audioStems);
+    return {
+        kind: "video-export-plan",
+        episodeId: input.renderQueue.episodeId,
+        route: input.renderQueue.route,
+        frameRate: input.renderQueue.frameRate,
+        duration: input.outputPackage.duration,
+        frameCount: input.renderQueue.items.length,
+        outputPath: videoOutput?.path ?? "dist/render/episode.webm",
+        outputMimeType: videoOutput?.mimeType ?? (codec === "h264" ? "video/mp4" : "video/webm"),
+        codec,
+        audioStemCount: audioStems.length,
+        captionOutputCount: input.outputPackage.outputs.captions.length,
+        ...(input.outputPackage.outputs.thumbnail?.path ? { thumbnailOutputPath: input.outputPackage.outputs.thumbnail.path } : {}),
+        ...(input.outputPackage.outputs.evidenceJson?.path ? { evidenceOutputPath: input.outputPackage.outputs.evidenceJson.path } : {})
+    };
+}
+export function createVideoExportPipeline(options) {
+    const now = options.now ?? defaultNow;
+    const plan = createVideoExportPlan(options);
+    const encoder = options.encoder ?? createFrameEncoder({
+        codec: plan.codec,
+        frameRate: options.renderQueue.frameRate,
+        viewport: options.renderQueue.viewport,
+        adapter: options.encoderAdapter
+    });
+    const muxer = options.muxer ?? createAudioMuxer({ container: plan.codec === "h264" ? "mp4" : "webm" });
+    const progress = options.progress ?? createRenderProgressTracker({ totalFrames: options.renderQueue.items.length, now });
+    const audioStems = normalizeAudioStemInput(options.audioStems);
+    let cancelled = false;
+    return {
+        plan,
+        progress,
+        async render() {
+            const startedAt = now();
+            progress.start(`Rendering ${plan.frameCount} frames.`);
+            for (const item of options.renderQueue.items) {
+                if (cancelled || progress.snapshot().cancelled)
+                    break;
+                await options.runtime.seek?.(item.time, item);
+                await options.runtime.step?.(1 / options.renderQueue.frameRate, item);
+                const capture = await options.runtime.captureFrame(item);
+                await encoder.encodeFrame({
+                    frame: item.frame,
+                    time: item.time,
+                    viewport: item.viewport,
+                    image: capture.image,
+                    durationMs: 1000 / options.renderQueue.frameRate
+                });
+                progress.advance({ frame: item.frame, time: item.time });
+            }
+            if (cancelled || progress.snapshot().cancelled) {
+                const encodedVideo = encoder.snapshot();
+                const muxedVideo = await muxer.mux(encodedVideo, audioStems, options.renderQueue.frameRate);
+                return createVideoExportResult(plan, encodedVideo, muxedVideo, progress.snapshot(), startedAt, now());
+            }
+            const encodedVideo = await encoder.finalize();
+            const muxedVideo = await muxer.mux(encodedVideo, audioStems, options.renderQueue.frameRate);
+            progress.complete("Render export complete.");
+            return createVideoExportResult(plan, encodedVideo, muxedVideo, progress.snapshot(), startedAt, now());
+        },
+        cancel(message) {
+            cancelled = true;
+            return progress.cancel(message);
+        }
+    };
+}
+export function normalizeAudioStemInput(input) {
+    if (!input)
+        return [];
+    if (isAudioStemManifestArtifact(input))
+        return audioStemsFromManifest(input);
+    return input;
+}
+function isAudioStemManifestArtifact(input) {
+    return !Array.isArray(input) && Array.isArray(input.stems);
+}
+function createVideoExportResult(plan, encodedVideo, muxedVideo, progress, startedAt, endedAt) {
+    const checksumSource = `${plan.episodeId}:${encodedVideo.frameCount}:${muxedVideo.byteLength}:${normalizePromptAnimationTime(muxedVideo.duration)}`;
+    return {
+        kind: "video-export-result",
+        plan,
+        encodedVideo,
+        muxedVideo,
+        progress,
+        checksum: deterministicChecksum(checksumSource),
+        renderTimeMs: Math.max(0, endedAt - startedAt)
+    };
+}
+function deterministicChecksum(value) {
+    let hash = 2166136261;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return `fnv1a-${(hash >>> 0).toString(16).padStart(8, "0")}`;
+}
+function defaultNow() {
+    return typeof globalThis.performance === "undefined" ? Date.now() : globalThis.performance.now();
+}
+//# sourceMappingURL=VideoExportPipeline.js.map

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

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