@clipwright/core 0.26.1 → 0.28.0

package/dist/contracts/v1/workflow-plan.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { workflowBrief, workflowBriefRead } from './workflow-brief.js';
+import { workflowBeat, workflowBeatRead } from './workflow-catalog.js';
+import { assetBinding, assetBindingRead, claimEvidence, claimEvidenceRead } from './workflow-evidence.js';
+import { workflowDigest, workflowId, workflowIssueRead, workflowMethodPin, workflowMethodPinRead, workflowRevision, workflowText } from './workflow-primitives.js';
+export const workflowPlanDocument = z.strictObject({
+    v: z.literal(1), method: workflowMethodPin, brief: workflowBrief, beats: z.array(workflowBeat).max(100),
+    claims: z.array(claimEvidence).max(100), assets: z.array(assetBinding).max(30),
+}).refine(document => new Set(document.beats.map(beat => beat.id)).size === document.beats.length, 'Beat IDs must be unique')
+    .refine(document => new Set(document.claims.map(claim => claim.id)).size === document.claims.length, 'Claim IDs must be unique')
+    .refine(document => new TextEncoder().encode(JSON.stringify(document)).length <= WORKFLOW_DOCUMENT_MAX_BYTES, 'Workflow document exceeds the byte limit');
+export const workflowPlanDocumentRead = z.object({ v: z.number(), method: workflowMethodPinRead, brief: workflowBriefRead,
+    beats: z.array(workflowBeatRead), claims: z.array(claimEvidenceRead), assets: z.array(assetBindingRead) });
+export const createWorkflowPlan = z.strictObject({ document: workflowPlanDocument });
+export const saveWorkflowPlan = z.strictObject({ base_version: z.number().int().nonnegative().safe(), document: workflowPlanDocument });
+export const approveWorkflowPlan = z.strictObject({ revision: workflowRevision, content_digest: workflowDigest });
+export const workflowPlanRead = z.object({
+    v: z.number(), plan_id: workflowId, account_id: workflowText(200), revision: workflowRevision, content_digest: workflowDigest, document: workflowPlanDocumentRead,
+    status: z.string(), issues: z.array(workflowIssueRead), warnings: z.array(z.string()), approved_at: z.string().datetime().nullable(), created_at: z.string().datetime(),
+});
+export const WORKFLOW_DOCUMENT_MAX_BYTES = 256_000;
+export function serializeWorkflowDocument(document) {
+    const json = JSON.stringify(document);
+    return { json, bytes: new TextEncoder().encode(json).length };
+}
+//# sourceMappingURL=workflow-plan.js.map

package/dist/contracts/v1/workflow-plan.js.map

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

package/dist/contracts/v1/workflow-primitives.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+export declare const WORKFLOW_METHOD_IDS: readonly ['ugc-product-intro', 'ugc-faq-answer', 'faceless-explainer', 'product-image-story', 'website-proof-demo', 'kinetic-launch'];
+export declare const workflowMethodId: z.ZodEnum<{
+    "faceless-explainer": "faceless-explainer";
+    "kinetic-launch": "kinetic-launch";
+    "product-image-story": "product-image-story";
+    "ugc-faq-answer": "ugc-faq-answer";
+    "ugc-product-intro": "ugc-product-intro";
+    "website-proof-demo": "website-proof-demo";
+}>;
+export declare const workflowDigest: z.ZodString;
+export declare const workflowId: z.ZodString;
+export declare const workflowRevision: z.ZodNumber;
+export declare const workflowLocalId: z.ZodString;
+export declare const workflowText: (max: number) => z.ZodString;
+export declare const workflowFormat: z.ZodObject<{
+    aspect_ratio: z.ZodEnum<{
+        "16:9": "16:9";
+        "1:1": "1:1";
+        "9:16": "9:16";
+    }>;
+    resolution: z.ZodEnum<{
+        "1080p": "1080p";
+        "4k": "4k";
+        "720p": "720p";
+    }>;
+}, z.core.$strict>;
+export declare const workflowFormatRead: z.ZodObject<{
+    aspect_ratio: z.ZodString;
+    resolution: z.ZodString;
+}, z.core.$strip>;
+export declare const workflowMethodPin: z.ZodObject<{
+    method_id: z.ZodEnum<{
+        "faceless-explainer": "faceless-explainer";
+        "kinetic-launch": "kinetic-launch";
+        "product-image-story": "product-image-story";
+        "ugc-faq-answer": "ugc-faq-answer";
+        "ugc-product-intro": "ugc-product-intro";
+        "website-proof-demo": "website-proof-demo";
+    }>;
+    version: z.ZodNumber;
+    content_digest: z.ZodString;
+    capability_digest: z.ZodString;
+}, z.core.$strict>;
+export declare const workflowMethodPinRead: z.ZodObject<{
+    method_id: z.ZodString;
+    version: z.ZodNumber;
+    content_digest: z.ZodString;
+    capability_digest: z.ZodString;
+}, z.core.$strip>;
+export type WorkflowMethodPin = z.infer<typeof workflowMethodPin>;
+export declare const workflowIssue: z.ZodObject<{
+    kind: z.ZodString;
+    path: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export type WorkflowIssue = z.infer<typeof workflowIssue>;
+export declare const workflowIssueRead: z.ZodObject<{
+    kind: z.ZodString;
+    path: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;

package/dist/contracts/v1/workflow-primitives.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { ASPECT_RATIOS, RESOLUTIONS } from '../../skills.js';
+export const WORKFLOW_METHOD_IDS = ['ugc-product-intro', 'ugc-faq-answer', 'faceless-explainer', 'product-image-story', 'website-proof-demo', 'kinetic-launch'];
+export const workflowMethodId = z.enum(WORKFLOW_METHOD_IDS);
+export const workflowDigest = z.string().regex(/^[a-f0-9]{64}$/);
+export const workflowId = z.string().regex(/^wfp_[a-zA-Z0-9_-]{1,64}$/);
+export const workflowRevision = z.number().int().positive().safe();
+export const workflowLocalId = z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/);
+export const workflowText = (max) => z.string().min(1).max(max).refine(text => text.trim().length > 0, 'Text must not be blank');
+export const workflowFormat = z.strictObject({ aspect_ratio: z.enum(ASPECT_RATIOS), resolution: z.enum(RESOLUTIONS) });
+export const workflowFormatRead = z.object({ aspect_ratio: z.string(), resolution: z.string() });
+export const workflowMethodPin = z.strictObject({ method_id: workflowMethodId, version: workflowRevision, content_digest: workflowDigest, capability_digest: workflowDigest });
+export const workflowMethodPinRead = z.object({ method_id: z.string(), version: workflowRevision, content_digest: workflowDigest, capability_digest: workflowDigest });
+export const workflowIssue = z.strictObject({ kind: workflowText(80), path: z.string().max(500), message: workflowText(2000) });
+export const workflowIssueRead = z.object({ kind: z.string(), path: z.string(), message: z.string() });
+//# sourceMappingURL=workflow-primitives.js.map

package/dist/contracts/v1/workflow-primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-primitives.js","sourceRoot":"","sources":["../../../src/contracts/v1/workflow-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,CAAU,CAAC;AACzK,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,wBAAwB,CAAC,CAAC;AACzI,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AACvH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC;AAC/K,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC;AAGvK,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAEhI,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC"}

package/dist/edit-billing.d.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+/** One priced line of a revision: a generated unit, or a kept candidate entering the video. */
+export declare const revisionPriceLine: 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>;
+export type RevisionPriceLine = z.infer<typeof revisionPriceLine>;
+/** The price of a revision, frozen at admission. `zero_unit` names the rule a revision without generation took. */
+export declare const revisionBilling: 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>;
+export type RevisionBilling = z.infer<typeof revisionBilling>;
+/** What a revision changes, as the server states it. */
+export declare const editSummaryWire: 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";
+            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>;
+export type EditSummaryWire = z.infer<typeof editSummaryWire>;

package/dist/edit-billing.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { SHOT_OPERATION_MODES } from "./edit-operations.js";
+import { shotId } from "./edit-primitives.js";
+// A leaf: `runs.ts` imports it, so it reaches neither `edit-document.ts` nor `runs.ts`.
+const credits = z.number().int().nonnegative().safe();
+const shotKind = z.enum(["picture", "clip", "presenter"]);
+/** One priced line of a revision: a generated unit, or a kept candidate entering the video. */
+export const revisionPriceLine = z.strictObject({
+    shot_id: shotId,
+    unit: z.enum(["picture", "clip", "clip_with_new_picture", "kept_picture", "kept_clip"]),
+    credits,
+});
+/** The price of a revision, frozen at admission. `zero_unit` names the rule a revision without generation took. */
+export const revisionBilling = z.strictObject({
+    tariff_id: z.string().min(1),
+    lines: z.array(revisionPriceLine),
+    render_credits: credits,
+    zero_unit: z.enum(["priced", "free"]).nullable(),
+    total_credits: credits,
+});
+/** What a revision changes, as the server states it. */
+export const editSummaryWire = z.strictObject({
+    retimed: z.array(shotId),
+    deleted: z.array(shotId),
+    added: z.array(shotId),
+    replaced: z.array(z.strictObject({ shot_id: shotId, from: z.enum(["candidate", "upload"]) })),
+    generated: z.array(z.strictObject({ shot_id: shotId, kind: shotKind, mode: z.enum(SHOT_OPERATION_MODES) })),
+    changed: z.boolean(),
+});
+//# sourceMappingURL=edit-billing.js.map

package/dist/edit-billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-billing.js","sourceRoot":"","sources":["../src/edit-billing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG9C,wFAAwF;AACxF,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AACtD,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAwC,CAAC,CAAC;AAEjG,+FAA+F;AAC/F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9C,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,uBAAuB,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;IACvF,OAAO;CACR,CAAC,CAAC;AAGH,mHAAmH;AACnH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACjC,cAAc,EAAE,OAAO;IACvB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChD,aAAa,EAAE,OAAO;CACvB,CAAC,CAAC;AAGH,wDAAwD;AACxD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IACtB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7F,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAC3G,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC"}

package/dist/edit-document.d.ts

@@ -0,0 +1,335 @@
+import { z } from "zod";
+import { type ShotChange } from "./edit-operations.js";
+import type { PlannedRunShots } from "./edit-shots.js";
+/** Where a shot's media comes from: the source run, a kept candidate, an upload, or a generation to pay for. */
+export declare const editAsset: 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">;
+export type EditAsset = z.infer<typeof editAsset>;
+export declare const editShot: 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>;
+export type EditShot = z.infer<typeof editShot>;
+/** The whole timeline a revision asks for, written against one source run. */
+export declare const editDocument: 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>;
+export type EditDocument = z.infer<typeof editDocument>;
+/** The most a stored draft's document weighs, in bytes of its JSON; the table's check states the same number. */
+export declare const EDIT_DOCUMENT_MAX_BYTES = 256000;
+/** The JSON a document is stored as and its length in bytes: the one place either is computed. */
+export declare function serializeEditDocument(document: EditDocument): {
+    json: string;
+    bytes: number;
+};
+/** A save of the draft: the whole document and the version it was written against, 0 when no draft was read. */
+export declare const saveRunEdit: z.ZodObject<{
+    base_version: z.ZodNumber;
+    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>;
+export type SaveRunEdit = z.infer<typeof saveRunEdit>;
+/** The draft of a run's edit. Version 0 is a run with nothing stored: its document changes nothing. */
+export declare const runEdit: z.ZodObject<{
+    run_id: z.ZodString;
+    version: z.ZodNumber;
+    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>;
+    issues: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            action_not_allowed: "action_not_allowed";
+            candidate_for_other_shot: "candidate_for_other_shot";
+            duplicate_picture_asset: "duplicate_picture_asset";
+            duplicate_shot_id: "duplicate_shot_id";
+            duration_mismatch: "duration_mismatch";
+            first_shot_fixed: "first_shot_fixed";
+            footage_exceeded: "footage_exceeded";
+            foreign_source_asset: "foreign_source_asset";
+            kind_asset_mismatch: "kind_asset_mismatch";
+            kind_changed: "kind_changed";
+            not_movable: "not_movable";
+            not_resizable: "not_resizable";
+            overlap: "overlap";
+            presenter_out_of_sync: "presenter_out_of_sync";
+            presenter_outside_recording: "presenter_outside_recording";
+            shot_added_not_allowed: "shot_added_not_allowed";
+            source_mismatch: "source_mismatch";
+            span_out_of_range: "span_out_of_range";
+            timebase_mismatch: "timebase_mismatch";
+            too_long: "too_long";
+            too_many_generated: "too_many_generated";
+            too_short: "too_short";
+            tracks_overlap: "tracks_overlap";
+            uncovered: "uncovered";
+            unknown_asset: "unknown_asset";
+            upload_shape_refused: "upload_shape_refused";
+        }>;
+        shot_id: z.ZodOptional<z.ZodString>;
+        from_frame: z.ZodOptional<z.ZodNumber>;
+        to_frame: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type RunEdit = z.infer<typeof runEdit>;
+/** The document as a client reads it: kind, track, asset source and operation are open, and no limit of a save applies. */
+export declare const editDocumentRead: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    source_run_id: z.ZodString;
+    timebase: z.ZodObject<{
+        fps: z.ZodNumber;
+    }, z.core.$loose>;
+    duration_frames: z.ZodNumber;
+    shots: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        track: z.ZodString;
+        kind: z.ZodString;
+        start_frame: z.ZodNumber;
+        end_frame: z.ZodNumber;
+        media_offset_frames: z.ZodOptional<z.ZodNumber>;
+        asset: z.ZodObject<{
+            from: z.ZodString;
+        }, z.core.$loose>;
+    }, z.core.$loose>>;
+    discarded: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+export type EditDocumentRead = z.infer<typeof editDocumentRead>;
+/** The draft as a client reads it: the code of an issue is an open string. */
+export declare const runEditRead: z.ZodObject<{
+    run_id: z.ZodString;
+    version: z.ZodNumber;
+    updated_at: z.ZodNullable<z.ZodString>;
+    document: z.ZodObject<{
+        v: z.ZodLiteral<1>;
+        source_run_id: z.ZodString;
+        timebase: z.ZodObject<{
+            fps: z.ZodNumber;
+        }, z.core.$loose>;
+        duration_frames: z.ZodNumber;
+        shots: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            track: z.ZodString;
+            kind: z.ZodString;
+            start_frame: z.ZodNumber;
+            end_frame: z.ZodNumber;
+            media_offset_frames: z.ZodOptional<z.ZodNumber>;
+            asset: z.ZodObject<{
+                from: z.ZodString;
+            }, z.core.$loose>;
+        }, z.core.$loose>>;
+        discarded: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>;
+    issues: z.ZodArray<z.ZodObject<{
+        shot_id: z.ZodOptional<z.ZodString>;
+        from_frame: z.ZodOptional<z.ZodNumber>;
+        to_frame: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodString;
+        code: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RunEditRead = z.infer<typeof runEditRead>;
+/** What a client passes to a save: the version it read and the document, as read or as written. */
+export type SaveRunEditArgs = {
+    base_version: number;
+    document: z.input<typeof editDocumentRead>;
+};
+/** The path of a run's draft. The id is encoded, since it comes from the caller. */
+export declare const runEditPath: (id: string) => string;
+/** The document that changes nothing: every shot of the view on its own source asset. */
+export declare function identityEditDocument(shots: PlannedRunShots): EditDocument;
+/** Replaces only the asset of each named shot with a generation; spans and every other shot stay. */
+export declare function applyShotChanges(document: EditDocument, changes: ShotChange[]): EditDocument;