@aura3d/engine 1.0.10 → 1.1.0

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

@@ -7,8 +7,14 @@ export function createFrameEncoder(options) {
     let status = "idle";
     let chunks = [];
     let output;
+    const outputMode = adapter.outputMode ?? (adapter.proofOnly ? "memory-summary" : "encoded-video");
     const snapshot = () => {
         const duration = chunks.length === 0 ? 0 : normalizePromptAnimationTime(chunks.reduce((sum, chunk) => sum + chunk.durationMs, 0) / 1000);
+        const playable = output !== undefined
+            && adapter.proofOnly !== true
+            && outputMode === "encoded-video"
+            && adapter.capability?.supported !== false
+            && adapter.capability?.canProducePlayableFile !== false;
         return {
             kind: "encoded-video",
             codec,
@@ -19,6 +25,10 @@ export function createFrameEncoder(options) {
             frameCount: chunks.length,
             duration,
             byteLength: chunks.reduce((sum, chunk) => sum + chunk.byteLength, 0),
+            outputMode,
+            proofOnly: adapter.proofOnly === true,
+            playable,
+            ...(adapter.capability?.supported === false && adapter.capability.reason ? { unsupportedReason: adapter.capability.reason } : {}),
             chunks,
             ...(output !== undefined ? { output } : {})
         };
@@ -68,6 +78,10 @@ export function createFrameEncoder(options) {
 }
 export function createInMemoryFrameEncoderAdapter() {
     return {
+        kind: "in-memory-frame-encoder",
+        proofOnly: true,
+        outputMode: "memory-summary",
+        capability: { supported: true, reason: "In-memory adapter records frame metadata only and does not write playable media." },
         encode(frame) {
             return {
                 frame: frame.frame,

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

@@ -1 +1 @@
-{"version":3,"file":"FrameEncoder.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/FrameEncoder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FrameEncoder.js","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/FrameEncoder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAA8D,MAAM,8BAA8B,CAAC;AAiFxI,MAAM,UAAU,kBAAkB,CAAC,OAAkC;IACnE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACrC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,2BAA2B,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,iCAAiC,EAAE,CAAC;IACvE,IAAI,MAAM,GAAuB,MAAM,CAAC;IACxC,IAAI,MAAM,GAAwB,EAAE,CAAC;IACrC,IAAI,MAA8C,CAAC;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAElG,MAAM,QAAQ,GAAG,GAAyB,EAAE;QAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACzI,MAAM,QAAQ,GAAG,MAAM,KAAK,SAAS;eAChC,OAAO,CAAC,SAAS,KAAK,IAAI;eAC1B,UAAU,KAAK,eAAe;eAC9B,OAAO,CAAC,UAAU,EAAE,SAAS,KAAK,KAAK;eACvC,OAAO,CAAC,UAAU,EAAE,sBAAsB,KAAK,KAAK,CAAC;QAC1D,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,KAAK;YACL,SAAS;YACT,QAAQ;YACR,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,MAAM,CAAC,MAAM;YACzB,QAAQ;YACR,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACpE,UAAU;YACV,SAAS,EAAE,OAAO,CAAC,SAAS,KAAK,IAAI;YACrC,QAAQ;YACR,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,KAAK,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjI,MAAM;YACN,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;QACL,SAAS;QACT,QAAQ;QACR,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,CAAC,WAAW,CAAC,KAAK;YACrB,IAAI,MAAM,KAAK,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;YAChH,MAAM,GAAG,UAAU,CAAC;YACpB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBACjC,GAAG,KAAK;gBACR,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,GAAG,OAAO,CAAC,SAAS;gBACxD,IAAI,EAAE,4BAA4B,CAAC,KAAK,CAAC,IAAI,CAAC;aAC/C,CAAC,CAAC;YACH,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,CAAC,QAAQ;YACZ,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC;YAC3B,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC;gBAC9B,KAAK;gBACL,SAAS;gBACT,QAAQ;gBACR,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;YACH,MAAM,GAAG,WAAW,CAAC;YACrB,OAAO,QAAQ,EAAE,CAAC;QACpB,CAAC;QACD,KAAK;YACH,MAAM,GAAG,MAAM,CAAC;YAChB,MAAM,GAAG,EAAE,CAAC;YACZ,MAAM,GAAG,SAAS,CAAC;YACnB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACpB,CAAC;QACD,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,gBAAgB;QAC5B,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,kFAAkF,EAAE;QAC3H,MAAM,CAAC,KAAK;YACV,OAAO;gBACL,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,4BAA4B,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC9C,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC;gBAC1C,QAAQ,EAAE,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,KAAK,CAAC;gBACrD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,GAAG,EAAE;aAC1C,CAAC;QACJ,CAAC;QACD,QAAQ;YACN,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAwB;IAC/D,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,KAAK,KAAK,cAAc;QAAE,OAAO,cAAc,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAwB,EAAE,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC;IAC/G,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,WAAW,CAAC;IACjG,IAAI,SAAS,KAAK,cAAc;QAAE,OAAO,WAAW,CAAC;IACrD,OAAO,sBAAsB,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAwB;IAChE,IAAI,KAAK,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,aAAa,GAAI,UAA6F,CAAC,aAAa,CAAC;IACnI,IAAI,aAAa,EAAE,eAAe,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACtF,MAAM,YAAY,GAAI,UAAoD,CAAC,YAAY,CAAC;IACxF,OAAO,OAAO,CAAC,YAAY,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAwB;IACvD,IAAI,KAAK,CAAC,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;IACrE,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IACxF,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IAC/D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;AACtF,CAAC"}

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

@@ -0,0 +1,19 @@
+import { type EncodedVideoArtifact, type FrameEncoderAdapter, type FrameEncoderCodec, type FrameEncoderFrame } from "./FrameEncoder.js";
+export interface MediaRecorderFrameEncoderCapability {
+    readonly kind: "media-recorder-frame-encoder-capability";
+    readonly supported: boolean;
+    readonly mimeType: string;
+    readonly codec: FrameEncoderCodec;
+    readonly reason?: string | undefined;
+}
+export interface CreateMediaRecorderFrameEncoderAdapterOptions {
+    readonly codec?: FrameEncoderCodec | undefined;
+    readonly mimeType?: string | undefined;
+    readonly recorderSupported?: boolean | undefined;
+    readonly outputFactory?: ((summary: FrameEncoderAdapterSummary, frames: readonly FrameEncoderFrame[]) => Blob | Uint8Array | string | undefined) | undefined;
+}
+export declare function probeMediaRecorderFrameEncoder(codec?: FrameEncoderCodec, mimeType?: string): MediaRecorderFrameEncoderCapability;
+export declare function createMediaRecorderFrameEncoderAdapter(options?: CreateMediaRecorderFrameEncoderAdapterOptions): FrameEncoderAdapter;
+type FrameEncoderAdapterSummary = Omit<EncodedVideoArtifact, "kind" | "output" | "outputMode" | "proofOnly" | "playable" | "unsupportedReason">;
+export {};
+//# sourceMappingURL=MediaRecorderFrameEncoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MediaRecorderFrameEncoder.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/agent-api/MediaRecorderFrameEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,IAAI,EAAE,yCAAyC,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,6CAA6C;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,SAAS,iBAAiB,EAAE,KAAK,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CAC9J;AAED,wBAAgB,8BAA8B,CAAC,KAAK,GAAE,iBAAyB,EAAE,QAAQ,SAAqC,GAAG,mCAAmC,CAanK;AAED,wBAAgB,sCAAsC,CAAC,OAAO,GAAE,6CAAkD,GAAG,mBAAmB,CAyBvI;AAYD,KAAK,0BAA0B,GAAG,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,mBAAmB,CAAC,CAAC"}

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

@@ -0,0 +1,74 @@
+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 } : {})
+    };
+    return {
+        kind: "media-recorder-frame-encoder",
+        proofOnly: false,
+        outputMode: capability.supported ? "encoded-video" : "unsupported",
+        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

@@ -7,5 +7,24 @@ export interface PerformanceBlendResult {
     readonly body: CartoonPerformanceBodyState;
     readonly facial: CartoonPerformanceFacialState;
 }
+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: CartoonEmotionPose, to: CartoonEmotionPose, t: number): PerformanceBlendResult;
+export declare function createPerformanceTransitionPlan(from: CartoonEmotionPose, to: CartoonEmotionPose, 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,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,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,kBAAkB,EAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAsBzH;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,kBAAkB,EACtB,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 CartoonPerformanceArtifact, type CartoonPerformanceBodyState, type CartoonPerformanceFacialState, type CartoonPerformanceGazeState } from "./CartoonPerformance.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?: CartoonPerformanceBodyState | undefined;
+    readonly facial?: CartoonPerformanceFacialState | undefined;
+    readonly gaze?: CartoonPerformanceGazeState | 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(): CartoonPerformanceArtifact;
+    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 { createCartoonPerformance } from "./CartoonPerformance.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 createCartoonPerformance({
+            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/PngSequenceEncoder.d.ts

@@ -0,0 +1,34 @@
+import type { CartoonViewport } from "./CartoonRenderQueue.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: CartoonViewport;
+    readonly frameCount: number;
+    readonly frames: readonly PngSequenceFrameArtifact[];
+}
+export interface CreatePngSequenceEncoderAdapterOptions {
+    readonly frameRate: PromptAnimationFrameRate;
+    readonly viewport: CartoonViewport;
+    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: CartoonViewport;
+    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,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,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,eAAe,CAAC;IACnC,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,eAAe,CAAC;IACnC,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,eAAe,CAAC;IACnC,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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"}