@aura3d/engine 1.0.10 → 1.3.0

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

@@ -0,0 +1,79 @@
+import { defaultFrameEncoderMimeType } from "./FrameEncoder.js";
+import { normalizePromptAnimationTime } from "./PromptAnimationContract.js";
+export function probeMediaRecorderFrameEncoder(codec = "vp9", mimeType = defaultFrameEncoderMimeType(codec)) {
+    const mediaRecorder = globalThis.MediaRecorder;
+    if (!mediaRecorder) {
+        return { kind: "media-recorder-frame-encoder-capability", supported: false, mimeType, codec, reason: "MediaRecorder is unavailable in this runtime." };
+    }
+    const supported = mediaRecorder.isTypeSupported?.(mimeType) ?? true;
+    return {
+        kind: "media-recorder-frame-encoder-capability",
+        supported,
+        mimeType,
+        codec,
+        ...(supported ? {} : { reason: `MediaRecorder does not support ${mimeType}.` })
+    };
+}
+export function createMediaRecorderFrameEncoderAdapter(options = {}) {
+    const frames = [];
+    const codec = options.codec ?? "vp9";
+    const capability = {
+        ...probeMediaRecorderFrameEncoder(codec, options.mimeType),
+        ...(options.recorderSupported !== undefined ? { supported: options.recorderSupported } : {})
+    };
+    // Honest labeling: this adapter only yields a real playable video when the caller
+    // injects a real `outputFactory`. Without one, finalize() returns a metadata
+    // summary blob (NOT a playable video), so it must be reported as proof-only /
+    // memory-summary rather than claiming encoded-video.
+    const hasRealOutput = typeof options.outputFactory === "function";
+    return {
+        kind: "media-recorder-frame-encoder",
+        proofOnly: !hasRealOutput,
+        outputMode: !capability.supported ? "unsupported" : hasRealOutput ? "encoded-video" : "memory-summary",
+        capability,
+        encode(frame) {
+            if (!capability.supported)
+                throw new Error(capability.reason ?? "MediaRecorder frame encoder is unsupported.");
+            frames.push(frame);
+            return createMediaRecorderChunk(frame);
+        },
+        finalize(summary) {
+            if (!capability.supported)
+                throw new Error(capability.reason ?? "MediaRecorder frame encoder is unsupported.");
+            return options.outputFactory?.(summary, frames) ?? mediaRecorderSummaryBlob(summary);
+        },
+        reset() {
+            frames.length = 0;
+        }
+    };
+}
+function createMediaRecorderChunk(frame) {
+    return {
+        frame: frame.frame,
+        time: normalizePromptAnimationTime(frame.time),
+        byteLength: mediaFrameByteLength(frame),
+        keyFrame: frame.frame === 0 || frame.frame % 60 === 0,
+        durationMs: frame.durationMs ?? 1000 / 30
+    };
+}
+function mediaRecorderSummaryBlob(summary) {
+    const payload = JSON.stringify({
+        encoder: "media-recorder",
+        codec: summary.codec,
+        mimeType: summary.mimeType,
+        frameCount: summary.frameCount,
+        duration: summary.duration,
+        byteLength: summary.byteLength
+    });
+    return typeof Blob === "undefined" ? payload : new Blob([payload], { type: summary.mimeType });
+}
+function mediaFrameByteLength(frame) {
+    if (frame.image instanceof Uint8Array)
+        return frame.image.byteLength;
+    if (typeof Blob !== "undefined" && frame.image instanceof Blob)
+        return frame.image.size;
+    if (typeof frame.image === "string")
+        return frame.image.length;
+    return Math.max(1, Math.round(frame.viewport.width * frame.viewport.height * 0.08));
+}
+//# sourceMappingURL=MediaRecorderFrameEncoder.js.map

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

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

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

@@ -1,11 +1,30 @@
-import type { CartoonEmotionPose, CartoonPerformanceBodyState, CartoonPerformanceFacialState } from "./CartoonPerformance.js";
+import type { AnimationEmotionPose, AnimationPerformanceBodyState, AnimationPerformanceFacialState } from "./AnimationPerformance.js";
 export interface PerformanceBlendResult {
     readonly kind: "performance-blend";
     readonly fromPoseId: string;
     readonly toPoseId: string;
     readonly t: number;
-    readonly body: CartoonPerformanceBodyState;
-    readonly facial: CartoonPerformanceFacialState;
+    readonly body: AnimationPerformanceBodyState;
+    readonly facial: AnimationPerformanceFacialState;
 }
-export declare function blendPerformancePoses(from: CartoonEmotionPose, to: CartoonEmotionPose, t: number): PerformanceBlendResult;
+export interface PerformanceTransitionSample extends PerformanceBlendResult {
+    readonly time: number;
+    readonly frame: number;
+}
+export interface PerformanceTransitionPlan {
+    readonly kind: "performance-transition-plan";
+    readonly fromPoseId: string;
+    readonly toPoseId: string;
+    readonly duration: number;
+    readonly frameRate: number;
+    readonly sampleCount: number;
+    readonly smooth: boolean;
+    readonly deterministic: true;
+    readonly samples: readonly PerformanceTransitionSample[];
+}
+export declare function blendPerformancePoses(from: AnimationEmotionPose, to: AnimationEmotionPose, t: number): PerformanceBlendResult;
+export declare function createPerformanceTransitionPlan(from: AnimationEmotionPose, to: AnimationEmotionPose, options?: {
+    readonly duration?: number;
+    readonly frameRate?: number;
+}): PerformanceTransitionPlan;
 //# sourceMappingURL=PerformanceBlender.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PerformanceBlender.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/PerformanceBlender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAE9H,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;CAChD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAsBzH"}
+{"version":3,"file":"PerformanceBlender.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/PerformanceBlender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAEtI,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;CAClD;AAED,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC1D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE,oBAAoB,EAAE,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAsB7H;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,oBAAoB,EAC1B,EAAE,EAAE,oBAAoB,EACxB,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACxE,yBAAyB,CAuB3B"}

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

@@ -21,9 +21,42 @@ export function blendPerformancePoses(from, to, t) {
         }
     };
 }
+export function createPerformanceTransitionPlan(from, to, options = {}) {
+    const duration = positive(options.duration ?? 0.35, "Performance transition duration");
+    const frameRate = positive(options.frameRate ?? 30, "Performance transition frameRate");
+    const frameCount = Math.max(2, Math.round(duration * frameRate) + 1);
+    const samples = Array.from({ length: frameCount }, (_, frame) => {
+        const t = frameCount <= 1 ? 1 : frame / (frameCount - 1);
+        return {
+            ...blendPerformancePoses(from, to, smoothstep(t)),
+            time: Number((frame / frameRate).toFixed(4)),
+            frame
+        };
+    });
+    return {
+        kind: "performance-transition-plan",
+        fromPoseId: from.id,
+        toPoseId: to.id,
+        duration,
+        frameRate,
+        sampleCount: samples.length,
+        smooth: samples.every((sample, index) => index === 0 || sample.t >= samples[index - 1].t),
+        deterministic: true,
+        samples
+    };
+}
 function lerp(left, right, t) {
     if (left === undefined && right === undefined)
         return undefined;
     return Number(((left ?? right ?? 0) + ((right ?? left ?? 0) - (left ?? right ?? 0)) * t).toFixed(4));
 }
+function smoothstep(value) {
+    const t = Math.min(1, Math.max(0, value));
+    return Number((t * t * (3 - 2 * t)).toFixed(4));
+}
+function positive(value, label) {
+    if (!Number.isFinite(value) || value <= 0)
+        throw new Error(`${label} must be positive.`);
+    return value;
+}
 //# sourceMappingURL=PerformanceBlender.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"PerformanceBlender.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/PerformanceBlender.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,qBAAqB,CAAC,IAAwB,EAAE,EAAsB,EAAE,CAAS;IAC/F,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,UAAU,EAAE,IAAI,CAAC,EAAE;QACnB,QAAQ,EAAE,EAAE,CAAC,EAAE;QACf,CAAC,EAAE,MAAM;QACT,IAAI,EAAE;YACJ,GAAG,IAAI,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,IAAI;YACV,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC;YAC5D,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC;YAC/D,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC;YAC3E,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;SACvD;QACD,MAAM,EAAE;YACN,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,EAAE,CAAC,MAAM;YACZ,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;YAC7D,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC;SACpE;KACF,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,IAAwB,EAAE,KAAyB,EAAE,CAAS;IAC1E,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChE,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACvG,CAAC"}
+{"version":3,"file":"PerformanceBlender.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/PerformanceBlender.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,65 @@
+import { type AnimationPerformanceArtifact, type AnimationPerformanceBodyState, type AnimationPerformanceFacialState, type AnimationPerformanceGazeState } from "./AnimationPerformance.js";
+import { type PromptAnimationId, type PromptAnimationValidationIssue } from "./PromptAnimationContract.js";
+export type PerformanceCaptureSourceKind = "manual" | "webcam" | "motion-capture";
+export type PerformanceCapturePermissionState = "unknown" | "granted" | "denied" | "not-required";
+export type PerformanceCaptureRecordingSessionStatus = "idle" | "recording" | "stopped";
+export type PerformanceCaptureSignal = "body" | "face" | "hands" | "gaze" | "audio";
+export interface PerformanceCaptureCapability {
+    readonly kind: PerformanceCaptureSourceKind;
+    readonly available: boolean;
+    readonly permission: PerformanceCapturePermissionState;
+    readonly supportedSignals: readonly PerformanceCaptureSignal[];
+    readonly provider?: string | undefined;
+    readonly notes?: readonly string[] | undefined;
+}
+export interface PerformanceCaptureRecordingSample {
+    readonly id: string;
+    readonly time: number;
+    readonly characterId: PromptAnimationId;
+    readonly body?: AnimationPerformanceBodyState | undefined;
+    readonly facial?: AnimationPerformanceFacialState | undefined;
+    readonly gaze?: AnimationPerformanceGazeState | undefined;
+    readonly confidence?: number | undefined;
+    readonly sourceFrameId?: string | undefined;
+}
+export interface PerformanceCaptureRecordingSessionOptions {
+    readonly id: PromptAnimationId;
+    readonly episodeId: PromptAnimationId;
+    readonly characterId: PromptAnimationId;
+    readonly frameRate: number;
+    readonly source: PerformanceCaptureCapability;
+}
+export interface PerformanceCaptureRecordingSessionSnapshot {
+    readonly kind: "performance-capture-session";
+    readonly id: PromptAnimationId;
+    readonly episodeId: PromptAnimationId;
+    readonly characterId: PromptAnimationId;
+    readonly status: PerformanceCaptureRecordingSessionStatus;
+    readonly source: PerformanceCaptureCapability;
+    readonly sampleCount: number;
+    readonly duration: number;
+    readonly averageConfidence: number;
+    readonly requiresRuntimeDevicePermission: boolean;
+    readonly externalServiceIntegrated: false;
+    readonly issues: readonly PromptAnimationValidationIssue[];
+    readonly evidence: {
+        readonly webcamCaptureContract: boolean;
+        readonly motionCaptureContract: boolean;
+        readonly manualCaptureFallback: boolean;
+        readonly performanceDriven: boolean;
+    };
+}
+export declare class PerformanceCaptureRecordingSession {
+    private readonly options;
+    private status;
+    private readonly samples;
+    constructor(options: PerformanceCaptureRecordingSessionOptions);
+    start(): PerformanceCaptureRecordingSessionSnapshot;
+    stop(): PerformanceCaptureRecordingSessionSnapshot;
+    recordSample(sample: PerformanceCaptureRecordingSample): PerformanceCaptureRecordingSessionSnapshot;
+    toPerformanceArtifact(): AnimationPerformanceArtifact;
+    snapshot(): PerformanceCaptureRecordingSessionSnapshot;
+}
+export declare function createPerformanceCaptureSession(options: PerformanceCaptureRecordingSessionOptions): PerformanceCaptureRecordingSession;
+export declare function validatePerformanceCaptureCapability(capability: PerformanceCaptureCapability): readonly PromptAnimationValidationIssue[];
+//# sourceMappingURL=PerformanceCaptureSession.d.ts.map

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

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

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

@@ -0,0 +1,131 @@
+import { createAnimationPerformance } from "./AnimationPerformance.js";
+import { createPromptAnimationIssue } from "./PromptAnimationContract.js";
+export class PerformanceCaptureRecordingSession {
+    options;
+    status = "idle";
+    samples = [];
+    constructor(options) {
+        this.options = options;
+        validateOptions(options);
+    }
+    start() {
+        if (this.options.source.kind !== "manual" && (!this.options.source.available || this.options.source.permission !== "granted")) {
+            throw new Error(`Performance capture source "${this.options.source.kind}" is not available with granted permission.`);
+        }
+        this.status = "recording";
+        return this.snapshot();
+    }
+    stop() {
+        this.status = "stopped";
+        return this.snapshot();
+    }
+    recordSample(sample) {
+        if (this.status !== "recording")
+            throw new Error("Performance capture samples can only be recorded while the session is recording.");
+        const clean = sanitizeSample(sample, this.options.characterId);
+        this.samples.push(clean);
+        this.samples.sort((left, right) => left.time - right.time);
+        return this.snapshot();
+    }
+    toPerformanceArtifact() {
+        const cues = this.samples.map((sample, index) => {
+            const next = this.samples[index + 1];
+            const frameDuration = 1 / this.options.frameRate;
+            return {
+                id: sample.id,
+                characterId: sample.characterId,
+                startTime: sample.time,
+                endTime: Math.max(sample.time + frameDuration, next?.time ?? sample.time + frameDuration),
+                action: "react",
+                ...(sample.body ? { body: sample.body } : {}),
+                ...(sample.facial ? { facial: sample.facial } : {}),
+                ...(sample.gaze ? { gaze: sample.gaze } : {}),
+                intensity: sample.confidence ?? 1,
+                notes: [
+                    `${this.options.source.kind} performance capture sample`,
+                    ...(sample.sourceFrameId ? [`source frame ${sample.sourceFrameId}`] : [])
+                ]
+            };
+        });
+        return createAnimationPerformance({
+            episodeId: this.options.episodeId,
+            frameRate: this.options.frameRate,
+            cues
+        });
+    }
+    snapshot() {
+        const issues = validatePerformanceCaptureCapability(this.options.source);
+        const confidenceValues = this.samples.map((sample) => sample.confidence ?? 1);
+        const duration = this.samples.length > 0 ? this.samples[this.samples.length - 1].time - this.samples[0].time : 0;
+        return {
+            kind: "performance-capture-session",
+            id: this.options.id,
+            episodeId: this.options.episodeId,
+            characterId: this.options.characterId,
+            status: this.status,
+            source: this.options.source,
+            sampleCount: this.samples.length,
+            duration: Number(Math.max(0, duration).toFixed(4)),
+            averageConfidence: Number((confidenceValues.reduce((total, value) => total + value, 0) / Math.max(1, confidenceValues.length)).toFixed(4)),
+            requiresRuntimeDevicePermission: this.options.source.kind !== "manual",
+            externalServiceIntegrated: false,
+            issues,
+            evidence: {
+                webcamCaptureContract: this.options.source.kind === "webcam",
+                motionCaptureContract: this.options.source.kind === "motion-capture",
+                manualCaptureFallback: this.options.source.kind === "manual",
+                performanceDriven: this.samples.length > 0
+            }
+        };
+    }
+}
+export function createPerformanceCaptureSession(options) {
+    return new PerformanceCaptureRecordingSession(options);
+}
+export function validatePerformanceCaptureCapability(capability) {
+    const issues = [];
+    if (!capability.available && capability.kind !== "manual") {
+        issues.push(createPromptAnimationIssue("warning", "performance-capture-source-unavailable", `${capability.kind} capture source is not available in this runtime.`));
+    }
+    if (capability.kind !== "manual" && capability.permission !== "granted") {
+        issues.push(createPromptAnimationIssue("warning", "performance-capture-permission-required", `${capability.kind} capture requires explicit runtime permission.`));
+    }
+    if (capability.supportedSignals.length === 0) {
+        issues.push(createPromptAnimationIssue("error", "performance-capture-signals-missing", "Performance capture needs at least one supported signal."));
+    }
+    return issues;
+}
+function validateOptions(options) {
+    nonEmpty(options.id, "Performance capture id");
+    nonEmpty(options.episodeId, "Performance capture episode id");
+    nonEmpty(options.characterId, "Performance capture character id");
+    if (!Number.isFinite(options.frameRate) || options.frameRate <= 0)
+        throw new Error("Performance capture frameRate must be positive.");
+    validatePerformanceCaptureCapability(options.source);
+}
+function sanitizeSample(sample, expectedCharacterId) {
+    if (sample.characterId !== expectedCharacterId)
+        throw new Error(`Performance capture sample characterId must be "${expectedCharacterId}".`);
+    if (!Number.isFinite(sample.time) || sample.time < 0)
+        throw new Error("Performance capture sample time must be a non-negative finite number.");
+    if (sample.confidence !== undefined && (!Number.isFinite(sample.confidence) || sample.confidence < 0 || sample.confidence > 1)) {
+        throw new Error("Performance capture sample confidence must be between 0 and 1.");
+    }
+    return {
+        id: nonEmpty(sample.id, "Performance capture sample id"),
+        time: sample.time,
+        characterId: sample.characterId,
+        body: sample.body,
+        facial: sample.facial,
+        gaze: sample.gaze,
+        confidence: sample.confidence,
+        sourceFrameId: sample.sourceFrameId
+    };
+}
+function nonEmpty(value, label) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throw new Error(`${label} must be a non-empty string.`);
+    return trimmed;
+}
+//# sourceMappingURL=PerformanceCaptureSession.js.map

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

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

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

@@ -1,21 +1,21 @@
-import type { CartoonEmotionPose, CartoonPerformanceBodyState, CartoonPerformanceFacialState, CartoonPerformanceGazeState } from "./CartoonPerformance.js";
+import type { AnimationEmotionPose, AnimationPerformanceBodyState, AnimationPerformanceFacialState, AnimationPerformanceGazeState } from "./AnimationPerformance.js";
 export interface PerformancePoseEditorSnapshot {
     readonly kind: "performance-pose-editor";
     readonly poseCount: number;
-    readonly poses: readonly CartoonEmotionPose[];
+    readonly poses: readonly AnimationEmotionPose[];
 }
 export declare class PerformancePoseEditor {
     private readonly poses;
-    constructor(poses?: readonly CartoonEmotionPose[]);
+    constructor(poses?: readonly AnimationEmotionPose[]);
     definePose(input: {
         readonly id: string;
         readonly emotion: string;
-        readonly body: CartoonPerformanceBodyState;
-        readonly facial: CartoonPerformanceFacialState;
-        readonly gaze?: CartoonPerformanceGazeState | undefined;
+        readonly body: AnimationPerformanceBodyState;
+        readonly facial: AnimationPerformanceFacialState;
+        readonly gaze?: AnimationPerformanceGazeState | undefined;
         readonly notes?: readonly string[] | undefined;
-    }): CartoonEmotionPose;
-    getPose(id: string): CartoonEmotionPose | undefined;
+    }): AnimationEmotionPose;
+    getPose(id: string): AnimationEmotionPose | undefined;
     snapshot(): PerformancePoseEditorSnapshot;
 }
 //# sourceMappingURL=PerformancePoseEditor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PerformancePoseEditor.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/PerformancePoseEditor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,6BAA6B,EAC7B,2BAA2B,EAC5B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC/C;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyC;gBAEnD,KAAK,GAAE,SAAS,kBAAkB,EAAO;IAIrD,UAAU,CAAC,KAAK,EAAE;QAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;QAC3C,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;QACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;KAChD,GAAG,kBAAkB;IAMtB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAInD,QAAQ,IAAI,6BAA6B;CAO1C"}
+{"version":3,"file":"PerformancePoseEditor.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/PerformancePoseEditor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC9B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACjD;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;gBAErD,KAAK,GAAE,SAAS,oBAAoB,EAAO;IAIvD,UAAU,CAAC,KAAK,EAAE;QAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;QAC7C,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;QACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,6BAA6B,GAAG,SAAS,CAAC;QAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;KAChD,GAAG,oBAAoB;IAMxB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIrD,QAAQ,IAAI,6BAA6B;CAO1C"}

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

@@ -1 +1 @@
-{"version":3,"file":"PerformancePoseEditor.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/PerformancePoseEditor.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,qBAAqB;IACf,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAC;IAE/D,YAAY,QAAuC,EAAE;QACnD,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,UAAU,CAAC,KAOV;QACC,MAAM,IAAI,GAAuB,EAAE,GAAG,KAAK,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,yBAAyB;YAC/B,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YAC1B,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;SAChC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"PerformancePoseEditor.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/PerformancePoseEditor.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,qBAAqB;IACf,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEjE,YAAY,QAAyC,EAAE;QACrD,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,UAAU,CAAC,KAOV;QACC,MAAM,IAAI,GAAyB,EAAE,GAAG,KAAK,EAAE,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,yBAAyB;YAC/B,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YAC1B,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;SAChC,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,34 @@
+import type { AnimationViewport } from "./AnimationRenderQueue.js";
+import type { FrameEncoderAdapter, FrameEncoderFrame } from "./FrameEncoder.js";
+import { type PromptAnimationFrameRate } from "./PromptAnimationContract.js";
+export interface PngSequenceFrameArtifact {
+    readonly frame: number;
+    readonly time: number;
+    readonly path: string;
+    readonly byteLength: number;
+    readonly checksum: string;
+}
+export interface PngSequenceManifest {
+    readonly kind: "png-sequence-manifest";
+    readonly proofOnly: boolean;
+    readonly publishScopedFallback: boolean;
+    readonly frameRate: PromptAnimationFrameRate;
+    readonly viewport: AnimationViewport;
+    readonly frameCount: number;
+    readonly frames: readonly PngSequenceFrameArtifact[];
+}
+export interface CreatePngSequenceEncoderAdapterOptions {
+    readonly frameRate: PromptAnimationFrameRate;
+    readonly viewport: AnimationViewport;
+    readonly directory?: string | undefined;
+    readonly publishScopedFallback?: boolean | undefined;
+    readonly writeFrame?: ((path: string, frame: FrameEncoderFrame) => void | Promise<void>) | undefined;
+}
+export declare function createPngSequenceEncoderAdapter(options: CreatePngSequenceEncoderAdapterOptions): FrameEncoderAdapter;
+export declare function createPngSequenceManifest(input: {
+    readonly frameRate: PromptAnimationFrameRate;
+    readonly viewport: AnimationViewport;
+    readonly frames: readonly PngSequenceFrameArtifact[];
+    readonly publishScopedFallback?: boolean | undefined;
+}): PngSequenceManifest;
+//# sourceMappingURL=PngSequenceEncoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PngSequenceEncoder.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/PngSequenceEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAgC,KAAK,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAE3G,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACtG;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,sCAAsC,GAAG,mBAAmB,CA4CpH;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACrD,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtD,GAAG,mBAAmB,CAUtB"}

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

@@ -0,0 +1,75 @@
+import { normalizePromptAnimationTime } from "./PromptAnimationContract.js";
+export function createPngSequenceEncoderAdapter(options) {
+    const frames = [];
+    const directory = options.directory ?? "frames";
+    return {
+        kind: "png-sequence-encoder",
+        proofOnly: options.publishScopedFallback !== true,
+        outputMode: "png-sequence",
+        capability: {
+            supported: true,
+            reason: options.publishScopedFallback === true
+                ? "PNG sequence fallback is explicitly scoped as acceptable output for this package."
+                : "PNG sequence output is proof-only unless the release explicitly scopes it as publish fallback."
+        },
+        async encode(frame) {
+            const path = `${directory}/frame-${String(frame.frame).padStart(4, "0")}.png`;
+            await options.writeFrame?.(path, frame);
+            const byteLength = pngFrameByteLength(frame);
+            frames.push({
+                frame: frame.frame,
+                time: normalizePromptAnimationTime(frame.time),
+                path,
+                byteLength,
+                checksum: pngSequenceChecksum(`${path}:${byteLength}:${frame.time}`)
+            });
+            return {
+                frame: frame.frame,
+                time: normalizePromptAnimationTime(frame.time),
+                byteLength,
+                keyFrame: true,
+                durationMs: frame.durationMs ?? 1000 / options.frameRate
+            };
+        },
+        finalize() {
+            return JSON.stringify(createPngSequenceManifest({
+                frameRate: options.frameRate,
+                viewport: options.viewport,
+                frames,
+                publishScopedFallback: options.publishScopedFallback ?? false
+            }));
+        },
+        reset() {
+            frames.length = 0;
+        }
+    };
+}
+export function createPngSequenceManifest(input) {
+    return {
+        kind: "png-sequence-manifest",
+        proofOnly: input.publishScopedFallback !== true,
+        publishScopedFallback: input.publishScopedFallback === true,
+        frameRate: input.frameRate,
+        viewport: input.viewport,
+        frameCount: input.frames.length,
+        frames: input.frames
+    };
+}
+function pngFrameByteLength(frame) {
+    if (frame.image instanceof Uint8Array)
+        return frame.image.byteLength;
+    if (typeof Blob !== "undefined" && frame.image instanceof Blob)
+        return frame.image.size;
+    if (typeof frame.image === "string")
+        return frame.image.length;
+    return Math.max(1, Math.round(frame.viewport.width * frame.viewport.height * 0.16));
+}
+function pngSequenceChecksum(value) {
+    let hash = 2166136261;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return `pngseq-${(hash >>> 0).toString(16).padStart(8, "0")}`;
+}
+//# sourceMappingURL=PngSequenceEncoder.js.map

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

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