@aura3d/engine 1.0.9 → 1.1.0

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

@@ -0,0 +1,113 @@
+import { createAudioWaveformData } from "./WaveformVisualizer.js";
+import { createAuraVoiceVisemeTrack, createGlbBlendshapeVisemeCue } from "./VisemeController.js";
+import { normalizePromptAnimationTime } from "./PromptAnimationContract.js";
+export function analyzeAudioVisemes(options) {
+    const channelCount = Math.max(1, Math.floor(options.channelCount ?? 1));
+    const sampleCount = Math.floor(options.samples.length / channelCount);
+    const duration = sampleCount / options.sampleRate;
+    const windowSeconds = options.analysisWindowSeconds ?? Math.min(0.05, 1 / options.frameRate);
+    const samplesPerWindow = Math.max(1, Math.round(windowSeconds * options.sampleRate));
+    const silenceThreshold = options.silenceThreshold ?? 0.025;
+    const frames = [];
+    for (let startSample = 0, index = 0; startSample < sampleCount; startSample += samplesPerWindow, index += 1) {
+        const endSample = Math.min(sampleCount, startSample + samplesPerWindow);
+        let sumSquares = 0;
+        let peak = 0;
+        let count = 0;
+        for (let sample = startSample; sample < endSample; sample += 1) {
+            for (let channel = 0; channel < channelCount; channel += 1) {
+                const value = Math.abs(options.samples[sample * channelCount + channel] ?? 0);
+                peak = Math.max(peak, value);
+                sumSquares += value * value;
+                count += 1;
+            }
+        }
+        const rms = count === 0 ? 0 : Math.sqrt(sumSquares / count);
+        const mouthOpenness = rms <= silenceThreshold ? 0 : Math.max(0, Math.min(1, (rms - silenceThreshold) / Math.max(0.001, 0.45 - silenceThreshold)));
+        const startTime = normalizePromptAnimationTime((options.startTime ?? 0) + startSample / options.sampleRate);
+        const endTime = normalizePromptAnimationTime((options.startTime ?? 0) + endSample / options.sampleRate);
+        frames.push({
+            index,
+            startTime,
+            endTime,
+            rms,
+            peak,
+            mouthOpenness,
+            visemeId: classifyAmplitudeViseme(mouthOpenness, peak)
+        });
+    }
+    return {
+        kind: "audio-viseme-analysis",
+        analysisKind: options.phonemeAlignmentPresent ? "phoneme-aligned" : "amplitude-only",
+        phonemeAlignmentPresent: options.phonemeAlignmentPresent === true,
+        manualCorrectionRecommended: options.phonemeAlignmentPresent !== true,
+        characterId: options.characterId,
+        language: options.language,
+        sampleRate: options.sampleRate,
+        frameRate: options.frameRate,
+        duration: normalizePromptAnimationTime(duration),
+        analysisWindowSeconds: normalizePromptAnimationTime(windowSeconds),
+        frames,
+        waveform: createAudioWaveformData({
+            samples: options.samples,
+            sampleRate: options.sampleRate,
+            channelCount,
+            bins: Math.min(2048, Math.max(64, frames.length))
+        })
+    };
+}
+export function createAudioDrivenVisemeTrack(options) {
+    const analysis = analyzeAudioVisemes(options);
+    const cues = mergeAudioVisemeFrames(analysis.frames).map((frame, index) => createGlbBlendshapeVisemeCue({
+        id: `${options.lineId ?? options.characterId}:audio-viseme:${index}`,
+        characterId: options.characterId,
+        ...(options.speakerId ? { speakerId: options.speakerId } : {}),
+        ...(options.lineId ? { lineId: options.lineId } : {}),
+        startTime: frame.startTime,
+        endTime: frame.endTime,
+        visemeId: frame.visemeId,
+        mouthOpenness: frame.mouthOpenness,
+        weight: frame.visemeId === "sil" ? 0.2 : Math.max(0.35, frame.mouthOpenness),
+        ...(options.blendshapeMap ? { blendshapeMap: options.blendshapeMap } : {})
+    }));
+    return createAuraVoiceVisemeTrack({
+        episodeId: options.episodeId,
+        language: options.language,
+        frameRate: options.frameRate,
+        cues,
+        generatedAt: options.generatedAt
+    });
+}
+export function mergeAudioVisemeFrames(frames) {
+    const merged = [];
+    for (const frame of frames) {
+        const previous = merged[merged.length - 1];
+        if (previous && previous.visemeId === frame.visemeId) {
+            merged[merged.length - 1] = {
+                ...previous,
+                endTime: frame.endTime,
+                rms: Math.max(previous.rms, frame.rms),
+                peak: Math.max(previous.peak, frame.peak),
+                mouthOpenness: Math.max(previous.mouthOpenness, frame.mouthOpenness)
+            };
+        }
+        else {
+            merged.push(frame);
+        }
+    }
+    return merged;
+}
+function classifyAmplitudeViseme(mouthOpenness, peak) {
+    if (mouthOpenness <= 0.04)
+        return "sil";
+    if (mouthOpenness >= 0.72)
+        return "aa";
+    if (peak >= 0.62)
+        return "ah";
+    if (mouthOpenness >= 0.42)
+        return "eh";
+    if (mouthOpenness >= 0.22)
+        return "ih";
+    return "m";
+}
+//# sourceMappingURL=AudioVisemeAnalyzer.js.map

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

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

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

@@ -0,0 +1,31 @@
+import type { CartoonRenderQueueArtifact } from "./CartoonRenderQueue.js";
+import type { PromptAnimationId } from "./PromptAnimationContract.js";
+export interface BatchEpisodeDefinition {
+    readonly episodeId: PromptAnimationId;
+    readonly title: string;
+    readonly renderQueue: CartoonRenderQueueArtifact;
+    readonly outputDirectory: string;
+}
+export interface CartoonShowBibleBatch {
+    readonly kind: "cartoon-show-bible-batch";
+    readonly showId: PromptAnimationId;
+    readonly title: string;
+    readonly episodes: readonly BatchEpisodeDefinition[];
+}
+export interface BatchEpisodeRenderPlan {
+    readonly kind: "batch-episode-render-plan";
+    readonly showId: PromptAnimationId;
+    readonly episodeCount: number;
+    readonly totalFrameCount: number;
+    readonly jobs: readonly BatchEpisodeRenderJob[];
+}
+export interface BatchEpisodeRenderJob {
+    readonly episodeId: PromptAnimationId;
+    readonly title: string;
+    readonly route: string;
+    readonly frameCount: number;
+    readonly outputDirectory: string;
+    readonly requiredOutputIds: readonly PromptAnimationId[];
+}
+export declare function createBatchEpisodeRenderPlan(batch: CartoonShowBibleBatch): BatchEpisodeRenderPlan;
+//# sourceMappingURL=BatchEpisodeRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BatchEpisodeRenderer.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/BatchEpisodeRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC1D;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAkBjG"}

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

@@ -0,0 +1,20 @@
+export function createBatchEpisodeRenderPlan(batch) {
+    const jobs = batch.episodes.map((episode) => ({
+        episodeId: episode.episodeId,
+        title: episode.title,
+        route: episode.renderQueue.route,
+        frameCount: episode.renderQueue.items.length,
+        outputDirectory: episode.outputDirectory,
+        requiredOutputIds: episode.renderQueue.outputs
+            .filter((output) => output.required !== false)
+            .map((output) => output.id)
+    }));
+    return {
+        kind: "batch-episode-render-plan",
+        showId: batch.showId,
+        episodeCount: jobs.length,
+        totalFrameCount: jobs.reduce((sum, job) => sum + job.frameCount, 0),
+        jobs
+    };
+}
+//# sourceMappingURL=BatchEpisodeRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BatchEpisodeRenderer.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/BatchEpisodeRenderer.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,4BAA4B,CAAC,KAA4B;IACvE,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAyB,EAAE,CAAC,CAAC;QACnE,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK;QAChC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM;QAC5C,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,iBAAiB,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO;aAC3C,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC;aAC7C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;KAC9B,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,IAAI,CAAC,MAAM;QACzB,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACnE,IAAI;KACL,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { CartoonGesture } from "./CartoonPerformance.js";
+export declare const bodyLanguageLibrary: readonly CartoonGesture[];
+export declare function resolveBodyLanguageGesture(id: string): CartoonGesture | undefined;
+//# sourceMappingURL=BodyLanguageLibrary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BodyLanguageLibrary.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/BodyLanguageLibrary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,eAAO,MAAM,mBAAmB,EAAE,SAAS,cAAc,EAKxD,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEjF"}

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

@@ -0,0 +1,10 @@
+export const bodyLanguageLibrary = [
+    { id: "shrug", label: "Shrug", action: "gesture", defaultDuration: 1, body: { shoulderRaise: 0.45, handPose: "open" }, gesture: { gestureId: "shrug", hand: "both", amplitude: 0.6 }, facial: { brow: "raised", mouth: "neutral" }, reducedMotionSafe: true },
+    { id: "thumbs-up", label: "Thumbs Up", action: "gesture", defaultDuration: 0.8, body: { armPose: "open", handPose: "point", energy: 0.7 }, gesture: { gestureId: "thumbs-up", hand: "right", amplitude: 0.5 }, facial: { mouth: "smile" }, reducedMotionSafe: true },
+    { id: "thinking", label: "Thinking", action: "gesture", defaultDuration: 1.4, body: { headTilt: -0.12, handPose: "pinch", energy: 0.35 }, gesture: { gestureId: "thinking", hand: "right", amplitude: 0.25 }, facial: { brow: "arched", eyes: "soft" }, reducedMotionSafe: true },
+    { id: "applause", label: "Applause", action: "gesture", defaultDuration: 1.2, body: { armPose: "open", handPose: "open", energy: 0.85 }, gesture: { gestureId: "applause", hand: "both", amplitude: 0.8, frequency: 2 }, facial: { mouth: "smile" }, reducedMotionSafe: false }
+];
+export function resolveBodyLanguageGesture(id) {
+    return bodyLanguageLibrary.find((gesture) => gesture.id === id);
+}
+//# sourceMappingURL=BodyLanguageLibrary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BodyLanguageLibrary.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/BodyLanguageLibrary.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAA8B;IAC5D,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE;IAC7P,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE;IACpQ,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE;IACjR,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE;CAChR,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,EAAU;IACnD,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAClE,CAAC"}

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

@@ -0,0 +1,65 @@
+import type { CartoonRenderQueueItem, CartoonViewport } from "./CartoonRenderQueue.js";
+import type { PromptAnimationSeconds } from "./PromptAnimationContract.js";
+export interface BrowserFrameCapturePageLike {
+    goto?(url: string, options?: {
+        waitUntil?: "load" | "domcontentloaded" | "networkidle";
+        timeout?: number;
+    }): Promise<unknown>;
+    setViewportSize?(size: {
+        width: number;
+        height: number;
+    }): Promise<unknown>;
+    waitForSelector?(selector: string, options?: {
+        timeout?: number;
+    }): Promise<unknown>;
+    evaluate?<T>(fn: (...args: unknown[]) => T | Promise<T>, ...args: unknown[]): Promise<T>;
+    screenshot?(options?: {
+        path?: string;
+        type?: "png" | "jpeg";
+        fullPage?: boolean;
+    }): Promise<Uint8Array>;
+    locator?(selector: string): {
+        first(): {
+            screenshot(options?: {
+                path?: string;
+                type?: "png" | "jpeg";
+            }): Promise<Uint8Array>;
+        };
+    };
+}
+export interface BrowserFrameCaptureRequest {
+    readonly route: string;
+    readonly item: CartoonRenderQueueItem;
+    readonly viewport: CartoonViewport;
+    readonly selector?: string | undefined;
+    readonly outputPath?: string | undefined;
+    readonly waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    readonly timeoutMs?: number | undefined;
+    readonly deviceScaleFactor?: number | undefined;
+}
+export interface BrowserFrameCaptureResult {
+    readonly kind: "browser-frame-capture";
+    readonly route: string;
+    readonly frame: number;
+    readonly time: PromptAnimationSeconds;
+    readonly viewport: CartoonViewport;
+    readonly selector: string;
+    readonly deviceScaleFactor: number;
+    readonly deterministic: boolean;
+    readonly outputPath?: string | undefined;
+    readonly byteLength: number;
+    readonly image?: Uint8Array | undefined;
+}
+export interface BrowserFrameCaptureAdapter {
+    capture(request: BrowserFrameCaptureRequest): Promise<BrowserFrameCaptureResult>;
+}
+export interface CreateBrowserFrameCaptureAdapterOptions {
+    readonly page: BrowserFrameCapturePageLike;
+    readonly defaultSelector?: string | undefined;
+    readonly defaultWaitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    readonly defaultTimeoutMs?: number | undefined;
+    readonly deviceScaleFactor?: number | undefined;
+}
+export declare function createBrowserFrameCaptureAdapter(options: CreateBrowserFrameCaptureAdapterOptions): BrowserFrameCaptureAdapter;
+export declare function routeWithFrameTime(route: string, time: PromptAnimationSeconds): string;
+//# sourceMappingURL=BrowserFrameCaptureAdapter.d.ts.map

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

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

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

@@ -0,0 +1,42 @@
+export function createBrowserFrameCaptureAdapter(options) {
+    return {
+        async capture(request) {
+            const selector = request.selector ?? options.defaultSelector ?? "canvas";
+            const waitUntil = request.waitUntil ?? options.defaultWaitUntil ?? "networkidle";
+            const timeoutMs = request.timeoutMs ?? options.defaultTimeoutMs ?? 10_000;
+            const deviceScaleFactor = request.deviceScaleFactor ?? options.deviceScaleFactor ?? 1;
+            await options.page.setViewportSize?.({
+                width: request.viewport.width,
+                height: request.viewport.height
+            });
+            await options.page.goto?.(routeWithFrameTime(request.route, request.item.time), { waitUntil, timeout: timeoutMs });
+            await options.page.waitForSelector?.(selector, { timeout: timeoutMs });
+            await options.page.evaluate?.((time) => {
+                const global = globalThis;
+                global.__AURA3D_CARTOON_EPISODE_SEEK__?.(time);
+                global.__AURA3D_CARTOON_TEMPLATE__?.sampleAt?.(time);
+            }, request.item.time);
+            const image = options.page.locator
+                ? await options.page.locator(selector).first().screenshot({ path: request.outputPath, type: "png" })
+                : await options.page.screenshot?.({ path: request.outputPath, type: "png", fullPage: false });
+            return {
+                kind: "browser-frame-capture",
+                route: request.route,
+                frame: request.item.frame,
+                time: request.item.time,
+                viewport: request.viewport,
+                selector,
+                deviceScaleFactor,
+                deterministic: true,
+                ...(request.outputPath ? { outputPath: request.outputPath } : {}),
+                byteLength: image?.byteLength ?? 0,
+                ...(image ? { image } : {})
+            };
+        }
+    };
+}
+export function routeWithFrameTime(route, time) {
+    const separator = route.includes("?") ? "&" : "?";
+    return `${route}${separator}auraFrameTime=${encodeURIComponent(String(time))}`;
+}
+//# sourceMappingURL=BrowserFrameCaptureAdapter.js.map

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

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

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

@@ -0,0 +1,69 @@
+import type { AuraVec3 } from "./index.js";
+import { type PromptAnimationId, type PromptAnimationSeconds } from "./PromptAnimationContract.js";
+import { type CameraPresetId } from "./CameraPresetLibrary.js";
+import type { ShotCameraInstruction } from "./ShotTimeline.js";
+export type CameraPathInterpolation = "linear" | "smoothstep" | "catmull-rom";
+export interface CameraKeyframe {
+    readonly id: PromptAnimationId;
+    readonly time: PromptAnimationSeconds;
+    readonly position: AuraVec3;
+    readonly target: AuraVec3;
+    readonly fov: number;
+    readonly focusDistance?: number | undefined;
+    readonly shake?: number | undefined;
+}
+export interface CameraPath {
+    readonly id: PromptAnimationId;
+    readonly interpolation: CameraPathInterpolation;
+    readonly keyframes: readonly CameraKeyframe[];
+}
+export interface CameraChoreographyArtifact {
+    readonly artifact: "camera-choreography";
+    readonly contractId: string;
+    readonly episodeId: PromptAnimationId;
+    readonly paths: readonly CameraPath[];
+    readonly generatedAt?: string | undefined;
+}
+export interface LegacyCameraChoreography {
+    readonly kind: "camera-choreography";
+    readonly duration: number;
+    readonly keyframes: readonly CameraKeyframe[];
+}
+export interface CameraSample {
+    readonly time: PromptAnimationSeconds;
+    readonly pathId: PromptAnimationId;
+    readonly position: AuraVec3;
+    readonly target: AuraVec3;
+    readonly fov: number;
+    readonly focusDistance?: number | undefined;
+    readonly shake: number;
+}
+export declare function createCameraChoreography(input: {
+    readonly episodeId: PromptAnimationId;
+    readonly paths: readonly CameraPath[];
+    readonly generatedAt?: string | undefined;
+}): CameraChoreographyArtifact;
+export declare function createCameraChoreography(keyframes: readonly CameraKeyframe[], duration?: number): LegacyCameraChoreography;
+export declare function cameraKeyframeFromPreset(id: CameraPresetId, time: PromptAnimationSeconds): CameraKeyframe;
+export declare function sampleCameraChoreography(choreography: LegacyCameraChoreography, time: PromptAnimationSeconds): CameraKeyframe;
+export declare function createCameraPathFromPreset(input: {
+    readonly id: PromptAnimationId;
+    readonly presetId: CameraPresetId;
+    readonly startTime: PromptAnimationSeconds;
+    readonly endTime: PromptAnimationSeconds;
+    readonly subjectPosition?: AuraVec3 | undefined;
+    readonly interpolation?: CameraPathInterpolation | undefined;
+}): CameraPath;
+export declare function sampleCameraPath(path: CameraPath, time: PromptAnimationSeconds): CameraSample;
+export declare function shotReverseShotCameraPaths(input: {
+    readonly episodeId: PromptAnimationId;
+    readonly speakerAId: PromptAnimationId;
+    readonly speakerBId: PromptAnimationId;
+    readonly speakerAPosition: AuraVec3;
+    readonly speakerBPosition: AuraVec3;
+    readonly startTime: PromptAnimationSeconds;
+    readonly turnDuration: PromptAnimationSeconds;
+    readonly turns: number;
+}): CameraChoreographyArtifact;
+export declare function cameraInstructionFromSample(sample: CameraSample): ShotCameraInstruction;
+//# sourceMappingURL=CameraChoreographer.d.ts.map

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

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

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

@@ -0,0 +1,165 @@
+import { normalizePromptAnimationTime, promptAnimationContractVersion } from "./PromptAnimationContract.js";
+import { applyCameraPreset } from "./CameraPresetLibrary.js";
+export function createCameraChoreography(input, duration) {
+    if (Array.isArray(input)) {
+        const sorted = [...input].sort((left, right) => left.time - right.time);
+        return {
+            kind: "camera-choreography",
+            duration: duration ?? Math.max(0, ...sorted.map((keyframe) => keyframe.time)),
+            keyframes: sorted
+        };
+    }
+    const planInput = input;
+    return {
+        artifact: "camera-choreography",
+        contractId: promptAnimationContractVersion,
+        episodeId: planInput.episodeId,
+        paths: planInput.paths.map((path) => ({
+            ...path,
+            keyframes: [...path.keyframes].sort((a, b) => a.time - b.time)
+        })),
+        ...(planInput.generatedAt ? { generatedAt: planInput.generatedAt } : {})
+    };
+}
+export function cameraKeyframeFromPreset(id, time) {
+    const camera = applyCameraPreset(id);
+    return {
+        id: `${id}:${time}`,
+        time: normalizePromptAnimationTime(time),
+        position: camera.position ?? camera.from ?? [0, 1.6, 4],
+        target: camera.target ?? [0, 1.2, 0],
+        fov: camera.fov ?? 40,
+        focusDistance: camera.focusDistance,
+        shake: camera.shake
+    };
+}
+export function sampleCameraChoreography(choreography, time) {
+    if (choreography.keyframes.length === 0)
+        throw new Error("Camera choreography requires at least one keyframe.");
+    const first = choreography.keyframes[0];
+    const last = choreography.keyframes[choreography.keyframes.length - 1];
+    if (time <= first.time)
+        return first;
+    if (time >= last.time)
+        return last;
+    const end = choreography.keyframes.find((keyframe) => keyframe.time >= time) ?? last;
+    const start = choreography.keyframes[Math.max(0, choreography.keyframes.indexOf(end) - 1)] ?? first;
+    const t = (time - start.time) / Math.max(0.0001, end.time - start.time);
+    return {
+        id: `${start.id}:sample:${normalizePromptAnimationTime(time)}`,
+        time: normalizePromptAnimationTime(time),
+        position: lerpVec3(start.position, end.position, t),
+        target: lerpVec3(start.target, end.target, t),
+        fov: Number(lerp(start.fov, end.fov, t).toFixed(4)),
+        focusDistance: start.focusDistance !== undefined || end.focusDistance !== undefined
+            ? lerp(start.focusDistance ?? end.focusDistance ?? 0, end.focusDistance ?? start.focusDistance ?? 0, t)
+            : undefined,
+        shake: lerp(start.shake ?? 0, end.shake ?? 0, t)
+    };
+}
+export function createCameraPathFromPreset(input) {
+    const camera = applyCameraPreset(input.presetId, { subjectPosition: input.subjectPosition });
+    const start = camera.from ?? camera.position ?? [0, 1.6, 4];
+    const end = camera.to ?? camera.position ?? start;
+    const target = camera.target ?? [0, 1.2, 0];
+    return {
+        id: input.id,
+        interpolation: input.interpolation ?? "smoothstep",
+        keyframes: [
+            {
+                id: `${input.id}:start`,
+                time: normalizePromptAnimationTime(input.startTime),
+                position: start,
+                target,
+                fov: camera.fov ?? 40,
+                focusDistance: camera.focusDistance,
+                shake: camera.shake
+            },
+            {
+                id: `${input.id}:end`,
+                time: normalizePromptAnimationTime(input.endTime),
+                position: end,
+                target,
+                fov: camera.fov ?? 40,
+                focusDistance: camera.focusDistance,
+                shake: 0
+            }
+        ]
+    };
+}
+export function sampleCameraPath(path, time) {
+    const keyframes = [...path.keyframes].sort((a, b) => a.time - b.time);
+    const first = keyframes[0];
+    if (!first)
+        throw new Error(`Camera path "${path.id}" has no keyframes.`);
+    const normalized = normalizePromptAnimationTime(time);
+    const previous = [...keyframes].reverse().find((keyframe) => keyframe.time <= normalized) ?? first;
+    const next = keyframes.find((keyframe) => keyframe.time >= normalized) ?? keyframes[keyframes.length - 1] ?? first;
+    const span = Math.max(0.0001, next.time - previous.time);
+    const t = previous === next ? 0 : easing((normalized - previous.time) / span, path.interpolation);
+    return {
+        time: normalized,
+        pathId: path.id,
+        position: lerpVec3(previous.position, next.position, t),
+        target: lerpVec3(previous.target, next.target, t),
+        fov: lerp(previous.fov, next.fov, t),
+        ...(previous.focusDistance !== undefined || next.focusDistance !== undefined
+            ? { focusDistance: lerp(previous.focusDistance ?? next.focusDistance ?? 0, next.focusDistance ?? previous.focusDistance ?? 0, t) }
+            : {}),
+        shake: lerp(previous.shake ?? 0, next.shake ?? 0, t)
+    };
+}
+export function shotReverseShotCameraPaths(input) {
+    const paths = [];
+    for (let turn = 0; turn < input.turns; turn += 1) {
+        const focusA = turn % 2 === 0;
+        const subjectPosition = focusA ? input.speakerAPosition : input.speakerBPosition;
+        const focusId = focusA ? input.speakerAId : input.speakerBId;
+        const startTime = input.startTime + turn * input.turnDuration;
+        const camera = applyCameraPreset("over-shoulder", { subjectPosition, focusTargetId: focusId });
+        paths.push({
+            id: `shot-reverse:${turn}:${focusId}`,
+            interpolation: "smoothstep",
+            keyframes: [
+                {
+                    id: `shot-reverse:${turn}:start`,
+                    time: normalizePromptAnimationTime(startTime),
+                    position: camera.position ?? [0, 1.6, 3.2],
+                    target: camera.target ?? subjectPosition,
+                    fov: camera.fov ?? 35
+                },
+                {
+                    id: `shot-reverse:${turn}:end`,
+                    time: normalizePromptAnimationTime(startTime + input.turnDuration),
+                    position: camera.position ?? [0, 1.6, 3.2],
+                    target: camera.target ?? subjectPosition,
+                    fov: camera.fov ?? 35
+                }
+            ]
+        });
+    }
+    return createCameraChoreography({ episodeId: input.episodeId, paths });
+}
+export function cameraInstructionFromSample(sample) {
+    return {
+        move: sample.shake > 0 ? "handheld" : "static",
+        position: sample.position,
+        target: sample.target,
+        fov: sample.fov,
+        focusDistance: sample.focusDistance,
+        shake: sample.shake
+    };
+}
+function easing(t, interpolation) {
+    const clamped = Math.max(0, Math.min(1, t));
+    if (interpolation === "smoothstep" || interpolation === "catmull-rom")
+        return clamped * clamped * (3 - 2 * clamped);
+    return clamped;
+}
+function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+function lerpVec3(a, b, t) {
+    return [lerp(a[0], b[0], t), lerp(a[1], b[1], t), lerp(a[2], b[2], t)];
+}
+//# sourceMappingURL=CameraChoreographer.js.map

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

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

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

@@ -0,0 +1,20 @@
+import type { AuraVec3 } from "./index.js";
+import { type CameraKeyframe, type CameraPath, type CameraSample } from "./CameraChoreographer.js";
+import { type PromptAnimationId, type PromptAnimationSeconds } from "./PromptAnimationContract.js";
+export interface CameraPathEditorState {
+    readonly path: CameraPath;
+    readonly selectedKeyframeIds: readonly PromptAnimationId[];
+    readonly pathMarkers: readonly CameraPathMarker[];
+}
+export interface CameraPathMarker {
+    readonly keyframeId: PromptAnimationId;
+    readonly position: AuraVec3;
+    readonly target: AuraVec3;
+    readonly label: string;
+}
+export declare function createCameraPathEditorState(path: CameraPath): CameraPathEditorState;
+export declare function addCameraKeyframe(path: CameraPath, keyframe: CameraKeyframe): CameraPath;
+export declare function moveCameraKeyframe(path: CameraPath, keyframeId: PromptAnimationId, patch: Partial<Pick<CameraKeyframe, "time" | "position" | "target" | "fov" | "focusDistance" | "shake">>): CameraPath;
+export declare function removeCameraKeyframe(path: CameraPath, keyframeId: PromptAnimationId): CameraPath;
+export declare function sampleCameraPathEditorPreview(state: CameraPathEditorState, times: readonly PromptAnimationSeconds[]): readonly CameraSample[];
+//# sourceMappingURL=CameraPathEditor.d.ts.map

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"}