@clipwright/core 0.29.0 → 0.31.0

package/dist/long-form-revision.d.ts

@@ -0,0 +1,244 @@
+import { z } from "zod";
+import { type ResolvedTimeline } from "./resolved-timeline.js";
+/** How a long-form run fills what a picture leaves of the canvas (`makeUgcInput.background`). */
+export declare const LONG_FORM_BACKGROUNDS: readonly ["white", "blur", "contain"];
+export type LongFormBackground = (typeof LONG_FORM_BACKGROUNDS)[number];
+/** A picture's zoom, as `makeUgcInput` takes it. */
+export declare const longFormImageMotion: z.ZodObject<{
+    direction: z.ZodEnum<{
+        in: "in";
+        out: "out";
+    }>;
+    amount: z.ZodNumber;
+}, z.core.$strict>;
+export type LongFormImageMotion = z.infer<typeof longFormImageMotion>;
+/** What a render needs beyond the timeline, copied from the root's input at admission; a position absent from the motions does not move. */
+export declare const longFormRevisionRender: z.ZodObject<{
+    aspect_ratio: z.ZodEnum<{
+        "16:9": "16:9";
+        "1:1": "1:1";
+        "9:16": "9:16";
+    }>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    background: z.ZodNullable<z.ZodEnum<{
+        blur: "blur";
+        contain: "contain";
+        white: "white";
+    }>>;
+    motion_by_position: z.ZodRecord<z.ZodString, z.ZodObject<{
+        direction: z.ZodEnum<{
+            in: "in";
+            out: "out";
+        }>;
+        amount: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type LongFormRevisionRender = z.infer<typeof longFormRevisionRender>;
+/** The stored input of a `revise_long_form` run: the request as resolved, and what admission froze about it. */
+export declare const longFormRevisionInput: z.ZodObject<{
+    input_mode: z.ZodLiteral<"revision">;
+    revision: z.ZodObject<{
+        source_run_id: z.ZodString;
+        document: z.ZodObject<{
+            v: z.ZodLiteral<1>;
+            source_run_id: z.ZodString;
+            timebase: z.ZodObject<{
+                fps: z.ZodNumber;
+            }, z.core.$strict>;
+            duration_frames: z.ZodNumber;
+            shots: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                track: z.ZodEnum<{
+                    presenter: "presenter";
+                    visual: "visual";
+                }>;
+                kind: z.ZodEnum<{
+                    clip: "clip";
+                    picture: "picture";
+                    presenter: "presenter";
+                }>;
+                start_frame: z.ZodNumber;
+                end_frame: z.ZodNumber;
+                media_offset_frames: z.ZodOptional<z.ZodNumber>;
+                asset: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    from: z.ZodLiteral<"source">;
+                    shot_id: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    from: z.ZodLiteral<"candidate">;
+                    run_id: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    from: z.ZodLiteral<"upload">;
+                    upload_id: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    from: z.ZodLiteral<"generate">;
+                    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        mode: z.ZodLiteral<"retake">;
+                    }, z.core.$strict>, z.ZodObject<{
+                        mode: z.ZodLiteral<"new_picture">;
+                        description: z.ZodString;
+                    }, z.core.$strict>, z.ZodObject<{
+                        mode: z.ZodLiteral<"edit_picture">;
+                        instruction: z.ZodString;
+                    }, z.core.$strict>, z.ZodObject<{
+                        mode: z.ZodLiteral<"animate">;
+                        motion: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>], "mode">;
+                }, z.core.$strict>], "from">;
+            }, z.core.$strict>>;
+            discarded: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    resolved_revision: z.ZodObject<{
+        root_run_id: z.ZodString;
+        summary: z.ZodObject<{
+            retimed: z.ZodArray<z.ZodString>;
+            deleted: z.ZodArray<z.ZodString>;
+            added: z.ZodArray<z.ZodString>;
+            replaced: z.ZodArray<z.ZodObject<{
+                shot_id: z.ZodString;
+                from: z.ZodEnum<{
+                    candidate: "candidate";
+                    source: "source";
+                    upload: "upload";
+                }>;
+            }, z.core.$strict>>;
+            generated: z.ZodArray<z.ZodObject<{
+                shot_id: z.ZodString;
+                kind: z.ZodEnum<{
+                    clip: "clip";
+                    picture: "picture";
+                    presenter: "presenter";
+                }>;
+                mode: z.ZodEnum<{
+                    animate: "animate";
+                    edit_picture: "edit_picture";
+                    new_picture: "new_picture";
+                    retake: "retake";
+                }>;
+            }, z.core.$strict>>;
+            changed: z.ZodBoolean;
+        }, z.core.$strict>;
+        billing: z.ZodObject<{
+            tariff_id: z.ZodString;
+            lines: z.ZodArray<z.ZodObject<{
+                shot_id: z.ZodString;
+                unit: z.ZodEnum<{
+                    clip: "clip";
+                    clip_with_new_picture: "clip_with_new_picture";
+                    kept_clip: "kept_clip";
+                    kept_picture: "kept_picture";
+                    picture: "picture";
+                }>;
+                credits: z.ZodNumber;
+            }, z.core.$strict>>;
+            render_credits: z.ZodNumber;
+            zero_unit: z.ZodNullable<z.ZodEnum<{
+                free: "free";
+                priced: "priced";
+            }>>;
+            total_credits: z.ZodNumber;
+        }, z.core.$strict>;
+        render: z.ZodObject<{
+            aspect_ratio: z.ZodEnum<{
+                "16:9": "16:9";
+                "1:1": "1:1";
+                "9:16": "9:16";
+            }>;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            background: z.ZodNullable<z.ZodEnum<{
+                blur: "blur";
+                contain: "contain";
+                white: "white";
+            }>>;
+            motion_by_position: z.ZodRecord<z.ZodString, z.ZodObject<{
+                direction: z.ZodEnum<{
+                    in: "in";
+                    out: "out";
+                }>;
+                amount: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type LongFormRevisionInput = z.infer<typeof longFormRevisionInput>;
+/** One changed visual shot, drawn above the source tiling over its whole span. A cover has no motion; an insert keeps its slot's. */
+export declare const longFormOverlay: z.ZodObject<{
+    shot_id: z.ZodString;
+    start_frame: z.ZodNumber;
+    end_frame: z.ZodNumber;
+    object: z.ZodObject<{
+        key: z.ZodString;
+        sha256: z.ZodString;
+        bytes: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        content_type: z.ZodEnum<{
+            "image/jpeg": "image/jpeg";
+            "image/png": "image/png";
+        }>;
+    }, z.core.$strict>;
+    origin: z.ZodEnum<{
+        source: "source";
+        upload: "upload";
+    }>;
+    motion: z.ZodNullable<z.ZodObject<{
+        direction: z.ZodEnum<{
+            in: "in";
+            out: "out";
+        }>;
+        amount: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type LongFormOverlay = z.infer<typeof longFormOverlay>;
+declare const recordShape: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    run_id: z.ZodString;
+    account_id: z.ZodString;
+    source_run_id: z.ZodString;
+    root_run_id: z.ZodString;
+    base: z.ZodUnknown;
+    visual: z.ZodArray<z.ZodObject<{
+        shot_id: z.ZodString;
+        start_frame: z.ZodNumber;
+        end_frame: z.ZodNumber;
+        object: z.ZodObject<{
+            key: z.ZodString;
+            sha256: z.ZodString;
+            bytes: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            content_type: z.ZodEnum<{
+                "image/jpeg": "image/jpeg";
+                "image/png": "image/png";
+            }>;
+        }, z.core.$strict>;
+        origin: z.ZodEnum<{
+            source: "source";
+            upload: "upload";
+        }>;
+        motion: z.ZodNullable<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** What a delivered long-form revision rendered: the source tiling rebound to its own run and keys, and its overlays. */
+export type LongFormRevisionRecord = Omit<z.infer<typeof recordShape>, "base"> & {
+    base: ResolvedTimeline;
+};
+/** Where a long-form revision's record is stored, and the most bytes it may take there. */
+export declare const longFormRevisionRecordKey: (id: string) => string;
+export declare const LONG_FORM_REVISION_RECORD_MAX_BYTES = 512000;
+/** Whether a key names an object of this run: a plain path under `runs/<runId>/`, with no segment to climb out by. */
+export declare function longFormOwnKey(key: string, id: string): boolean;
+/** The stored record of the run being read, checked against that run and against itself: every key and overlay belong to it. */
+export declare function readLongFormRevisionRecord(stored: string | Uint8Array, expected: {
+    runId: string;
+    accountId: string;
+}): LongFormRevisionRecord;
+export {};

package/dist/long-form-revision.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { editSummaryWire, revisionBilling } from "./edit-billing.js";
+import { editDocument } from "./edit-document.js";
+import { longFormSlotShotId } from "./edit-long-form.js";
+import { frame, frameCount, shotId } from "./edit-primitives.js";
+import { EDIT_MAX_SHOTS } from "./edit-rules.js";
+import { readResolvedTimeline } from "./resolved-timeline.js";
+import { runId } from "./runs.js";
+import { ASPECT_RATIOS } from "./skills.js";
+// A revision of a long-form run (#604 S7b): the input its admission stores, and the record its render writes.
+/** How a long-form run fills what a picture leaves of the canvas (`makeUgcInput.background`). */
+export const LONG_FORM_BACKGROUNDS = ["white", "blur", "contain"];
+/** A picture's zoom, as `makeUgcInput` takes it. */
+export const longFormImageMotion = z.strictObject({ direction: z.enum(["in", "out"]), amount: z.number().min(0).lt(1) });
+const RATIO_PARTS = { "16:9": [16, 9], "9:16": [9, 16], "1:1": [1, 1] };
+/** What a render needs beyond the timeline, copied from the root's input at admission; a position absent from the motions does not move. */
+export const longFormRevisionRender = z.strictObject({
+    aspect_ratio: z.enum(ASPECT_RATIOS), width: frameCount, height: frameCount,
+    background: z.enum(LONG_FORM_BACKGROUNDS).nullable(),
+    motion_by_position: z.record(z.string().regex(/^[1-9][0-9]{0,3}$/), longFormImageMotion),
+}).refine((render) => render.width * RATIO_PARTS[render.aspect_ratio][1] === render.height * RATIO_PARTS[render.aspect_ratio][0], { message: "the canvas does not have the shape of its aspect ratio" });
+/** The stored input of a `revise_long_form` run: the request as resolved, and what admission froze about it. */
+export const longFormRevisionInput = z.strictObject({
+    input_mode: z.literal("revision"),
+    revision: z.strictObject({ source_run_id: runId, document: editDocument }),
+    resolved_revision: z.strictObject({ root_run_id: runId, summary: editSummaryWire, billing: revisionBilling, render: longFormRevisionRender }),
+});
+const digest = z.string().regex(/^[a-f0-9]{64}$/);
+/** One changed visual shot, drawn above the source tiling over its whole span. A cover has no motion; an insert keeps its slot's. */
+export const longFormOverlay = z.strictObject({
+    shot_id: shotId, start_frame: frame, end_frame: frameCount,
+    object: z.strictObject({ key: z.string().min(1).max(1024), sha256: digest, bytes: frameCount, width: frameCount, height: frameCount,
+        content_type: z.enum(["image/png", "image/jpeg"]) }),
+    origin: z.enum(["upload", "source"]),
+    motion: longFormImageMotion.nullable(),
+});
+const recordShape = z.strictObject({
+    version: z.literal(1),
+    run_id: runId, account_id: z.string().min(1).max(200), source_run_id: runId, root_run_id: runId,
+    base: z.unknown(),
+    visual: z.array(longFormOverlay).max(EDIT_MAX_SHOTS),
+});
+/** Where a long-form revision's record is stored, and the most bytes it may take there. */
+export const longFormRevisionRecordKey = (id) => `runs/${id}/long-form-revision.v1.json`;
+export const LONG_FORM_REVISION_RECORD_MAX_BYTES = 512_000;
+/** Whether a key names an object of this run: a plain path under `runs/<runId>/`, with no segment to climb out by. */
+export function longFormOwnKey(key, id) {
+    const prefix = `runs/${id}/`;
+    return key.startsWith(prefix) && /^[\w-]+(?:\/[\w-]+)*(?:\.[a-z0-9]+)+$/.test(key.slice(prefix.length));
+}
+/** The stored record of the run being read, checked against that run and against itself: every key and overlay belong to it. */
+export function readLongFormRevisionRecord(stored, expected) {
+    const bytes = typeof stored === "string" ? new TextEncoder().encode(stored) : stored;
+    if (bytes.length > LONG_FORM_REVISION_RECORD_MAX_BYTES) {
+        throw new Error(`invalid long-form revision record: ${bytes.length} bytes, at most ${LONG_FORM_REVISION_RECORD_MAX_BYTES}`);
+    }
+    const parsed = recordShape.parse(JSON.parse(new TextDecoder().decode(bytes)));
+    const base = readResolvedTimeline(parsed.base);
+    const record = { ...parsed, base };
+    const failures = [];
+    if (record.run_id !== expected.runId || record.account_id !== expected.accountId)
+        failures.push("the record belongs to another run or account");
+    if (record.run_id === record.source_run_id)
+        failures.push("the revision names itself as its source");
+    if (base.runId !== record.run_id || base.accountId !== record.account_id)
+        failures.push("the timeline names another run or account");
+    const keys = [...base.slots.flatMap((slot) => (slot.kind === "media" ? [slot.key] : slot.audio ? [slot.audio.key] : [])),
+        ...(base.narration ? [base.narration.key] : []), ...record.visual.map((overlay) => overlay.object.key)];
+    if (!keys.every((key) => longFormOwnKey(key, record.run_id)))
+        failures.push("a key leaves the run's prefix");
+    const slots = new Map(base.slots.map((slot) => [longFormSlotShotId(slot), slot]));
+    const ids = new Set();
+    for (const overlay of record.visual) {
+        const slot = slots.get(overlay.shot_id);
+        if (ids.has(overlay.shot_id))
+            failures.push(`two overlays are ${overlay.shot_id}`);
+        ids.add(overlay.shot_id);
+        if (overlay.end_frame <= overlay.start_frame || overlay.end_frame > base.outputFrames)
+            failures.push(`${overlay.shot_id} lies outside the video`);
+        if (slot?.kind === "actor")
+            failures.push(`${overlay.shot_id} is a presenter take`);
+        if (slot?.kind === "media" && slot.mediaType === "video")
+            failures.push(`${overlay.shot_id} is a clip`);
+        if (!slot && overlay.motion !== null)
+            failures.push(`${overlay.shot_id} is a cover and does not move`);
+        // No presenter time was recorded under an insert, so its overlay keeps every frame of its slot.
+        if (slot?.kind === "media" && (overlay.start_frame > slot.startFrame || overlay.end_frame < slot.endFrame)) {
+            failures.push(`${overlay.shot_id} leaves part of its slot uncovered`);
+        }
+    }
+    const visual = [...base.slots.flatMap((slot) => (slot.kind === "media" && !ids.has(longFormSlotShotId(slot))
+            ? [{ start: slot.startFrame, end: slot.endFrame }] : [])),
+        ...record.visual.map((overlay) => ({ start: overlay.start_frame, end: overlay.end_frame }))].sort((a, b) => a.start - b.start);
+    let reach = 0;
+    for (const span of visual) {
+        if (span.start < reach)
+            failures.push("two visual shots overlap");
+        reach = Math.max(reach, span.end);
+    }
+    if (failures.length)
+        throw new Error(`invalid long-form revision record: ${failures.join("; ")}`);
+    return record;
+}
+//# sourceMappingURL=long-form-revision.js.map

package/dist/long-form-revision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-form-revision.js","sourceRoot":"","sources":["../src/long-form-revision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAyB,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,8GAA8G;AAE9G,iGAAiG;AACjG,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAG3E,oDAAoD;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAGzH,MAAM,WAAW,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAW,CAAC;AAEjF,4IAA4I;AAC5I,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,YAAY,CAAC;IACnD,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;IAC1E,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IACpD,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CACzF,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC9H,EAAE,OAAO,EAAE,wDAAwD,EAAE,CAAC,CAAC;AAGzE,gHAAgH;AAChH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,YAAY,CAAC;IAClD,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IAC1E,iBAAiB,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAC9I,CAAC,CAAC;AAGH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AAElD,qIAAqI;AACrI,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC;IAC5C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU;IAC1D,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;QACjI,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAGH,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK;IAC/F,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC;CACrD,CAAC,CAAC;AAIH,2FAA2F;AAC3F,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,QAAQ,EAAE,6BAA6B,CAAC;AACzG,MAAM,CAAC,MAAM,mCAAmC,GAAG,OAAO,CAAC;AAE3D,sHAAsH;AACtH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,EAAU;IACpD,MAAM,MAAM,GAAG,QAAQ,EAAE,GAAG,CAAC;IAC7B,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,uCAAuC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1G,CAAC;AAED,gIAAgI;AAChI,MAAM,UAAU,0BAA0B,CAAC,MAA2B,EAAE,QAA8C;IACpH,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACrF,IAAI,KAAK,CAAC,MAAM,GAAG,mCAAmC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,CAAC,MAAM,mBAAmB,mCAAmC,EAAE,CAAC,CAAC;IAC9H,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,KAAK,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAChJ,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,aAAa;QAAE,QAAQ,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACrG,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,UAAU;QAAE,QAAQ,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACrI,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtH,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1G,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAE7G,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACnF,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,yBAAyB,CAAC,CAAC;QAClJ,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,sBAAsB,CAAC,CAAC;QACpF,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;QACxG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,+BAA+B,CAAC,CAAC;QACvG,gGAAgG;QAChG,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3G,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,oCAAoC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC1G,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzD,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACjI,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK;YAAE,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAClE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClG,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/media-timebase.d.ts

@@ -1,2 +1,6 @@
 export declare const CANVAS_FPS = 25;
 export declare const NARRATION_SAMPLE_RATE = 48000;
+/** A duration in canvas frames, rounded up: one frame too few cuts the end of a line, one too many shows a still frame. */
+export declare function secondsToFrames(seconds: number, fps: number): number;
+/** Count only complete source frames; allocating a speech/image slot uses secondsToFrames instead. */
+export declare function completeFrames(seconds: number, fps: number): number;

package/dist/media-timebase.js

@@ -1,3 +1,27 @@
 export const CANVAS_FPS = 25;
 export const NARRATION_SAMPLE_RATE = 48_000;
+// The composition keeps its own copy of these two (`apps/web/remotion/timeline.ts`): its bundler resolves no other package.
+// `apps/web/remotion/timeline-parity.test.ts` holds the two copies equal.
+/** A duration in canvas frames, rounded up: one frame too few cuts the end of a line, one too many shows a still frame. */
+export function secondsToFrames(seconds, fps) {
+    if (!Number.isFinite(seconds) || seconds <= 0) {
+        throw new Error(`secondsToFrames: seconds must be positive, got ${seconds}`);
+    }
+    const frames = seconds * fps;
+    const whole = Math.round(frames);
+    // Floating-point multiplication can turn exactly seven frames into 7.000000000000001.
+    return whole > 0 && Math.abs(frames - whole) <= Number.EPSILON * Math.max(1, Math.abs(frames))
+        ? whole : Math.ceil(frames);
+}
+/** Count only complete source frames; allocating a speech/image slot uses secondsToFrames instead. */
+export function completeFrames(seconds, fps) {
+    if (!Number.isFinite(seconds) || seconds <= 0 || !Number.isSafeInteger(fps) || fps <= 0) {
+        throw new Error("invalid measured duration or frame rate");
+    }
+    const raw = seconds * fps;
+    const frames = Math.floor(raw + Number.EPSILON * Math.max(1, Math.abs(raw)));
+    if (!Number.isSafeInteger(frames) || frames < 1)
+        throw new Error("source shorter than one frame");
+    return frames;
+}
 //# sourceMappingURL=media-timebase.js.map

package/dist/media-timebase.js.map

@@ -1 +1 @@
-{"version":3,"file":"media-timebase.js","sourceRoot":"","sources":["../src/media-timebase.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC"}
+{"version":3,"file":"media-timebase.js","sourceRoot":"","sources":["../src/media-timebase.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C,4HAA4H;AAC5H,0EAA0E;AAE1E,2HAA2H;AAC3H,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,GAAW;IAC1D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,kDAAkD,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,GAAG,GAAG,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjC,sFAAsF;IACtF,OAAO,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5F,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,GAAW;IACzD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,GAAG,GAAG,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAClG,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/output-provenance.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export declare const OUTPUT_PROVENANCE_VERSION = "clipwright-output-marking-v2";
+export declare const OUTPUT_PROVENANCE_WATERMARK_PROFILE = "trustmark-python-0.9.2-q-bch5-strength1";
+export declare const OUTPUT_PROVENANCE_VIDEO_WATERMARK_PROFILE = "trustmark-python-0.9.2-p-bch5-strength1";
+export declare const OUTPUT_PROVENANCE_VIDEO_DETECTOR = "p2-temporal-presence-v1";
+export declare const OUTPUT_PROVENANCE_VIDEO_QUALITY_CONTRACT = "p2-psnr35-human-reviewed-v1";
+export declare const OUTPUT_PROVENANCE_C2PA_VERSION = "0.28.2";
+export declare const OUTPUT_PROVENANCE_PUBLIC_PAYLOAD = "1011011110011000111111000000011111011111011100000110110110111";
+/** INTERNAL server snapshot, never a client authorization or public request schema. */
+export declare const outputProvenancePolicySchema: z.ZodReadonly<z.ZodObject<{
+    policy_version: z.ZodLiteral<"clipwright-output-marking-v2">;
+    watermark_profile: z.ZodLiteral<"trustmark-python-0.9.2-q-bch5-strength1">;
+    video_watermark_profile: z.ZodLiteral<"trustmark-python-0.9.2-p-bch5-strength1">;
+    video_detector: z.ZodLiteral<"p2-temporal-presence-v1">;
+    video_quality_contract: z.ZodLiteral<"p2-psnr35-human-reviewed-v1">;
+    c2pa_version: z.ZodLiteral<"0.28.2">;
+    public_payload: z.ZodLiteral<"1011011110011000111111000000011111011111011100000110110110111">;
+    visible_ai_label: z.ZodBoolean;
+}, z.core.$strict>>;
+export type OutputProvenancePolicy = z.infer<typeof outputProvenancePolicySchema>;
+/** make_ugc includes long-form presenter video; only these runs default to a label. */
+export declare function createOutputProvenancePolicy(skill: unknown, visibleAiLabel?: unknown): OutputProvenancePolicy;
+/** Both own columns must be explicitly projected; omitted columns are not legacy SQL NULL. */
+export declare function readStoredOutputProvenance(row: unknown): OutputProvenancePolicy | null;
+/** This checks the public namespace, not AI origin/authorship. Malformed output throws. */
+export declare function matchesPublicOutputMarker(nativeTuple: unknown): boolean;

package/dist/output-provenance.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+export const OUTPUT_PROVENANCE_VERSION = "clipwright-output-marking-v2";
+export const OUTPUT_PROVENANCE_WATERMARK_PROFILE = "trustmark-python-0.9.2-q-bch5-strength1";
+export const OUTPUT_PROVENANCE_VIDEO_WATERMARK_PROFILE = "trustmark-python-0.9.2-p-bch5-strength1";
+export const OUTPUT_PROVENANCE_VIDEO_DETECTOR = "p2-temporal-presence-v1";
+export const OUTPUT_PROVENANCE_VIDEO_QUALITY_CONTRACT = "p2-psnr35-human-reviewed-v1";
+export const OUTPUT_PROVENANCE_C2PA_VERSION = "0.28.2";
+export const OUTPUT_PROVENANCE_PUBLIC_PAYLOAD = "1011011110011000111111000000011111011111011100000110110110111";
+/** INTERNAL server snapshot, never a client authorization or public request schema. */
+export const outputProvenancePolicySchema = z.object({
+    policy_version: z.literal(OUTPUT_PROVENANCE_VERSION),
+    watermark_profile: z.literal(OUTPUT_PROVENANCE_WATERMARK_PROFILE),
+    video_watermark_profile: z.literal(OUTPUT_PROVENANCE_VIDEO_WATERMARK_PROFILE),
+    video_detector: z.literal(OUTPUT_PROVENANCE_VIDEO_DETECTOR),
+    video_quality_contract: z.literal(OUTPUT_PROVENANCE_VIDEO_QUALITY_CONTRACT),
+    c2pa_version: z.literal(OUTPUT_PROVENANCE_C2PA_VERSION),
+    public_payload: z.literal(OUTPUT_PROVENANCE_PUBLIC_PAYLOAD),
+    visible_ai_label: z.boolean(),
+}).strict().readonly();
+const supportedSkill = z.enum(["make_ugc", "make_faceless", "edit_shot", "create_actor"]);
+/** make_ugc includes long-form presenter video; only these runs default to a label. */
+export function createOutputProvenancePolicy(skill, visibleAiLabel) {
+    const lane = supportedSkill.parse(skill);
+    const visible = visibleAiLabel === undefined ? lane === "make_ugc" : z.boolean().parse(visibleAiLabel);
+    if (visible && lane !== "make_ugc") {
+        throw new Error("Visible AI labeling is only supported for make_ugc presenter video");
+    }
+    return outputProvenancePolicySchema.parse({
+        policy_version: OUTPUT_PROVENANCE_VERSION,
+        watermark_profile: OUTPUT_PROVENANCE_WATERMARK_PROFILE,
+        video_watermark_profile: OUTPUT_PROVENANCE_VIDEO_WATERMARK_PROFILE,
+        video_detector: OUTPUT_PROVENANCE_VIDEO_DETECTOR,
+        video_quality_contract: OUTPUT_PROVENANCE_VIDEO_QUALITY_CONTRACT,
+        c2pa_version: OUTPUT_PROVENANCE_C2PA_VERSION,
+        public_payload: OUTPUT_PROVENANCE_PUBLIC_PAYLOAD,
+        visible_ai_label: visible,
+    });
+}
+/** Both own columns must be explicitly projected; omitted columns are not legacy SQL NULL. */
+export function readStoredOutputProvenance(row) {
+    if (row === null || typeof row !== "object" || Array.isArray(row)) {
+        throw new TypeError("Output provenance requires a stored run row");
+    }
+    const raw = row;
+    if (!Object.hasOwn(raw, "output_provenance_version") || !Object.hasOwn(raw, "output_provenance")
+        || raw.output_provenance_version === undefined || raw.output_provenance === undefined) {
+        throw new Error("Stored output provenance columns were not loaded");
+    }
+    if (raw.output_provenance_version === null || raw.output_provenance_version === "legacy") {
+        if (raw.output_provenance !== null)
+            throw new Error("Legacy output provenance must have SQL NULL policy");
+        return null;
+    }
+    if (raw.output_provenance_version !== OUTPUT_PROVENANCE_VERSION) {
+        throw new Error("Unsupported stored output provenance version");
+    }
+    return outputProvenancePolicySchema.parse(raw.output_provenance);
+}
+const nativeMarkerTupleSchema = z.tuple([
+    z.string().regex(/^[01]*$/), z.boolean(), z.number().int(),
+]);
+/** This checks the public namespace, not AI origin/authorship. Malformed output throws. */
+export function matchesPublicOutputMarker(nativeTuple) {
+    const [decoded, present, schema] = nativeMarkerTupleSchema.parse(nativeTuple);
+    return present === true && schema === 1 && decoded === OUTPUT_PROVENANCE_PUBLIC_PAYLOAD;
+}
+//# sourceMappingURL=output-provenance.js.map

package/dist/output-provenance.js.map

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

package/dist/resolved-timeline.d.ts

@@ -0,0 +1,86 @@
+import { z } from "zod";
+declare const contentSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    mode: z.ZodEnum<{
+        script_inserts: "script_inserts";
+        segments: "segments";
+    }>;
+    runId: z.ZodString;
+    accountId: z.ZodString;
+    inputHash: z.ZodString;
+    fps: z.ZodLiteral<25>;
+    outputFrames: z.ZodNumber;
+    fullSpeechDurationSec: z.ZodNumber;
+    slots: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        position: z.ZodNumber;
+        startFrame: z.ZodNumber;
+        endFrame: z.ZodNumber;
+        kind: z.ZodLiteral<"actor">;
+        requestHash: z.ZodString;
+        speechDurationSec: z.ZodNumber;
+        audio: z.ZodOptional<z.ZodObject<{
+            key: z.ZodString;
+            sha256: z.ZodString;
+            bytes: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        position: z.ZodNumber;
+        startFrame: z.ZodNumber;
+        endFrame: z.ZodNumber;
+        kind: z.ZodLiteral<"media">;
+        key: z.ZodString;
+        sha256: z.ZodString;
+        bytes: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        durationSec: z.ZodNumber;
+        mediaType: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        contentType: z.ZodEnum<{
+            "image/jpeg": "image/jpeg";
+            "image/png": "image/png";
+            "video/mp4": "video/mp4";
+        }>;
+        insertId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">>;
+    warnings: z.ZodArray<z.ZodString>;
+    narration: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        sha256: z.ZodString;
+        bytes: z.ZodNumber;
+        alignmentHash: z.ZodString;
+        semanticPlan: z.ZodObject<{
+            sourceTokens: z.ZodArray<z.ZodString>;
+            inserts: z.ZodArray<z.ZodObject<{
+                insertId: z.ZodString;
+                mediaId: z.ZodString;
+                startWord: z.ZodNumber;
+                endWord: z.ZodNumber;
+                coverWord: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ResolvedTimelineContent = z.infer<typeof contentSchema>;
+export type ResolvedTimeline = ResolvedTimelineContent & {
+    hash: string;
+};
+export declare function timelineDigest(value: unknown): string;
+export declare function freezeResolvedTimeline(value: unknown): ResolvedTimeline;
+export declare function readResolvedTimeline(value: unknown): ResolvedTimeline;
+/** The face-billing units of a timeline: each actor slot is one unit whose face shows over its whole interval. */
+export declare function faceBillingUnitsOf(timeline: ResolvedTimelineContent): {
+    unitId: string;
+    requestHash: string;
+    audioDurationSec: number;
+    faceIntervals: {
+        startFrame: number;
+        endFrame: number;
+    }[];
+}[];
+/** Where a run's resolved timeline is stored, and the most bytes it may take there. */
+export declare const resolvedTimelineKey: (runId: string) => string;
+export declare const RESOLVED_TIMELINE_MAX_BYTES = 512000;
+export {};