@clipwright/core 0.33.0 → 0.34.0

package/dist/contract-dispositions.d.ts

@@ -57,14 +57,20 @@ export declare const FIELD_DISPOSITIONS: {
         readonly triggersWhen: "differs-from-default";
     };
     readonly captions: {
-        readonly kind: "warned";
-        readonly warning: "captions requested but not rendered in this prototype (stage-B)";
-        readonly triggersWhen: "differs-from-default";
+        readonly kind: "implemented";
+        readonly provenBy: "composition";
     };
     readonly caption_style: {
-        readonly kind: "warned";
-        readonly warning: "caption_style is not honored: captions are not rendered in this prototype (stage-B)";
-        readonly triggersWhen: "differs-from-default";
+        readonly kind: "implemented";
+        readonly provenBy: "composition";
+    };
+    readonly caption_emphasis: {
+        readonly kind: "implemented";
+        readonly provenBy: "composition";
+    };
+    readonly caption_mode: {
+        readonly kind: "implemented";
+        readonly provenBy: "composition";
     };
     readonly resolution: {
         readonly kind: "implemented";
@@ -98,6 +104,26 @@ export declare const FIELD_DISPOSITIONS: {
         readonly kind: "implemented";
         readonly provenBy: "composition";
     };
+    readonly overlays: {
+        readonly kind: "implemented";
+        readonly provenBy: "composition";
+    };
+    readonly layout_windows: {
+        readonly kind: "implemented";
+        readonly provenBy: "composition";
+    };
+    readonly templates: {
+        readonly kind: "implemented";
+        readonly provenBy: "composition";
+    };
+    readonly template_theme: {
+        readonly kind: "implemented";
+        readonly provenBy: "composition";
+    };
+    readonly template_sounds: {
+        readonly kind: "implemented";
+        readonly provenBy: "composition";
+    };
     readonly character: {
         readonly kind: "rejected";
         readonly message: "character is not supported: saved characters do not exist yet. Describe the actor with `person` instead, or omit it to use the default actor";
@@ -149,12 +175,33 @@ export declare function isActorGenerationEnabled(env?: Record<string, string | u
 export declare function contractFlagsFromEnv(env?: Record<string, string | undefined>): ContractFlags;
 export declare function isLongFormQualificationEnabled(env?: Record<string, string | undefined>): boolean;
 export declare const LONG_FORM_DISABLED_MESSAGE = "long-form qualification is disabled on this deployment; pass script without segments or inserts";
+/** A run stored before captions were drawn (no `composition_version`) keeps the lines it was admitted with. */
+export declare function legacyCaptionWarnings(input: {
+    captions?: boolean | undefined;
+    caption_style?: string | undefined;
+}): string[];
+/** Captions a version-2 run asked for and a worker with composition off could not draw; written by the run. */
+export declare const CAPTIONS_COMPOSE_DISABLED_WARNING = "captions were not drawn: composition is disabled on this deployment";
+/** The composition-only parts a run asked for (#778 S2b): a render without composition names them instead of dropping them. */
+export declare function compositionLayerFields(input: {
+    overlays?: unknown;
+    layout_windows?: unknown;
+    templates?: unknown;
+    inserts?: readonly {
+        transition?: string | undefined;
+    }[] | undefined;
+    caption_emphasis?: readonly (string | {
+        punch_in?: boolean | undefined;
+    })[] | undefined;
+}): string[];
+/** The warning that names undrawn composition-only parts, or none. */
+export declare function compositionLayersNotDrawnWarnings(input: Parameters<typeof compositionLayerFields>[0], reason: string): string[];
 /** Dispositions with flags applied: the base table says what the code can do, this */
 /** says what it offers right now. */
 export declare function resolveDispositions(flags: ContractFlags): Record<ContractField, Disposition>;
 /** The process's effective table, from which every surface is built: `FIELD_DISPOSITIONS` */
 /** with the flags applied. */
-export declare const EFFECTIVE_DISPOSITIONS: Record<"actor_gender" | "actor_id" | "aspect_ratio" | "background" | "broll_policy" | "broll_url" | "caption_style" | "captions" | "character" | "disclosure_overlay" | "image" | "inserts" | "look" | "name" | "person" | "resolution" | "script" | "segments" | "tts_model" | "visible_ai_label" | "voice" | "voice_id" | "webhook_url", Disposition>;
+export declare const EFFECTIVE_DISPOSITIONS: Record<"actor_gender" | "actor_id" | "aspect_ratio" | "background" | "broll_policy" | "broll_url" | "caption_emphasis" | "caption_mode" | "caption_style" | "captions" | "character" | "disclosure_overlay" | "image" | "inserts" | "layout_windows" | "look" | "name" | "overlays" | "person" | "resolution" | "script" | "segments" | "template_sounds" | "template_theme" | "templates" | "tts_model" | "visible_ai_label" | "voice" | "voice_id" | "webhook_url", Disposition>;
 type RejectedField = {
     [K in ContractField]: (typeof FIELD_DISPOSITIONS)[K]["kind"] extends "rejected" ? K : never;
 }[ContractField];
@@ -196,7 +243,8 @@ export declare const offeredUgcInput: z.ZodObject<{
     }, z.core.$strip>>>;
     inserts: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        media_url: z.ZodString;
+        media_url: z.ZodOptional<z.ZodString>;
+        asset_id: z.ZodOptional<z.ZodString>;
         media_type: z.ZodEnum<{
             image: "image";
             video: "video";
@@ -216,7 +264,806 @@ export declare const offeredUgcInput: z.ZodObject<{
             }>;
             amount: z.ZodNumber;
         }, z.core.$strict>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+    }, z.core.$strict>>>;
+    overlays: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        media_url: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        id: z.ZodString;
+        asset_id: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        enter: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            fade: "fade";
+            slide: "slide";
+            tilt_in: "tilt_in";
+        }>>;
+        position: z.ZodEnum<{
+            bottom: "bottom";
+            bottom_left: "bottom_left";
+            bottom_right: "bottom_right";
+            top: "top";
+            top_left: "top_left";
+            top_right: "top_right";
+        }>;
     }, z.core.$strict>>>;
+    layout_windows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        media_url: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        id: z.ZodString;
+        asset_id: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        enter: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            fade: "fade";
+            slide: "slide";
+            tilt_in: "tilt_in";
+        }>>;
+        layout: z.ZodEnum<{
+            card: "card";
+            split: "split";
+        }>;
+        blur_presenter: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    templates: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"tag">;
+        data: z.ZodObject<{
+            text: z.ZodString;
+            position: z.ZodOptional<z.ZodEnum<{
+                bottom: "bottom";
+                center: "center";
+                top: "top";
+            }>>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"lower_third">;
+        data: z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            side: z.ZodEnum<{
+                left: "left";
+                right: "right";
+            }>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"end_card">;
+        data: z.ZodObject<{
+            site: z.ZodString;
+            cta: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"title_card">;
+        data: z.ZodObject<{
+            title: z.ZodString;
+            chip: z.ZodOptional<z.ZodString>;
+            logo: z.ZodOptional<z.ZodObject<{
+                asset_id: z.ZodString;
+            }, z.core.$strict>>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"quote">;
+        data: z.ZodObject<{
+            text: z.ZodString;
+            author: z.ZodOptional<z.ZodString>;
+            photo: z.ZodOptional<z.ZodObject<{
+                asset_id: z.ZodString;
+            }, z.core.$strict>>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"stat">;
+        data: z.ZodObject<{
+            value: z.ZodNumber;
+            prefix: z.ZodOptional<z.ZodString>;
+            suffix: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"callout">;
+        data: z.ZodObject<{
+            target: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>;
+            style: z.ZodEnum<{
+                arrow: "arrow";
+                ring: "ring";
+            }>;
+            text: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"checklist">;
+        data: z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                on: z.ZodBoolean;
+                icon: z.ZodOptional<z.ZodEnum<{
+                    briefcase: "briefcase";
+                    chat: "chat";
+                    clock: "clock";
+                    phone: "phone";
+                    star: "star";
+                    user: "user";
+                }>>;
+            }, z.core.$strict>>;
+            clicks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                item: z.ZodNumber;
+                quote: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            style: z.ZodOptional<z.ZodEnum<{
+                check: "check";
+                switch: "switch";
+            }>>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"phone_call">;
+        data: z.ZodObject<{
+            caller: z.ZodString;
+            subtitle: z.ZodOptional<z.ZodString>;
+            avatar: z.ZodOptional<z.ZodObject<{
+                asset_id: z.ZodString;
+            }, z.core.$strict>>;
+            answer_at: z.ZodString;
+            side: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                right: "right";
+            }>>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"compare">;
+        data: z.ZodObject<{
+            before: z.ZodObject<{
+                asset_id: z.ZodString;
+            }, z.core.$strict>;
+            after: z.ZodObject<{
+                asset_id: z.ZodString;
+            }, z.core.$strict>;
+            labels: z.ZodOptional<z.ZodObject<{
+                before: z.ZodOptional<z.ZodString>;
+                after: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            reveal_at: z.ZodString;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"notification">;
+        data: z.ZodObject<{
+            app: z.ZodString;
+            title: z.ZodString;
+            body: z.ZodString;
+            icon: z.ZodOptional<z.ZodEnum<{
+                briefcase: "briefcase";
+                chat: "chat";
+                clock: "clock";
+                phone: "phone";
+                star: "star";
+                user: "user";
+            }>>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"progress">;
+        data: z.ZodObject<{
+            steps: z.ZodArray<z.ZodString>;
+            advance_at: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodLiteral<"rating">;
+        data: z.ZodObject<{
+            stars: z.ZodNumber;
+            label: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodEnum<{
+                large: "large";
+                medium: "medium";
+                small: "small";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">>>;
+    template_theme: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodOptional<z.ZodEnum<{
+            bold_dark: "bold_dark";
+            clean_light: "clean_light";
+            mono: "mono";
+            neon: "neon";
+            paper: "paper";
+        }>>;
+        accent: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    template_sounds: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+        click: z.ZodOptional<z.ZodEnum<{
+            answer_confirm: "answer_confirm";
+            answer_open: "answer_open";
+            answer_pop: "answer_pop";
+            answer_select: "answer_select";
+            bong: "bong";
+            chime: "chime";
+            click_crisp: "click_crisp";
+            click_light: "click_light";
+            click_mouse: "click_mouse";
+            click_soft: "click_soft";
+            drop: "drop";
+            drop_high: "drop_high";
+            glass_ping: "glass_ping";
+            glass_soft: "glass_soft";
+            glitch: "glitch";
+            paper_swipe: "paper_swipe";
+            pluck: "pluck";
+            pluck_bright: "pluck_bright";
+            question_ping: "question_ping";
+            ring_classic: "ring_classic";
+            ring_digital: "ring_digital";
+            ring_marimba: "ring_marimba";
+            shutter: "shutter";
+            sweep: "sweep";
+            switch_flip: "switch_flip";
+            switch_heavy: "switch_heavy";
+            switch_light: "switch_light";
+            tick: "tick";
+            toggle_snap: "toggle_snap";
+            whip: "whip";
+            whoosh: "whoosh";
+        }>>;
+        toggle: z.ZodOptional<z.ZodEnum<{
+            answer_confirm: "answer_confirm";
+            answer_open: "answer_open";
+            answer_pop: "answer_pop";
+            answer_select: "answer_select";
+            bong: "bong";
+            chime: "chime";
+            click_crisp: "click_crisp";
+            click_light: "click_light";
+            click_mouse: "click_mouse";
+            click_soft: "click_soft";
+            drop: "drop";
+            drop_high: "drop_high";
+            glass_ping: "glass_ping";
+            glass_soft: "glass_soft";
+            glitch: "glitch";
+            paper_swipe: "paper_swipe";
+            pluck: "pluck";
+            pluck_bright: "pluck_bright";
+            question_ping: "question_ping";
+            ring_classic: "ring_classic";
+            ring_digital: "ring_digital";
+            ring_marimba: "ring_marimba";
+            shutter: "shutter";
+            sweep: "sweep";
+            switch_flip: "switch_flip";
+            switch_heavy: "switch_heavy";
+            switch_light: "switch_light";
+            tick: "tick";
+            toggle_snap: "toggle_snap";
+            whip: "whip";
+            whoosh: "whoosh";
+        }>>;
+        ring: z.ZodOptional<z.ZodEnum<{
+            answer_confirm: "answer_confirm";
+            answer_open: "answer_open";
+            answer_pop: "answer_pop";
+            answer_select: "answer_select";
+            bong: "bong";
+            chime: "chime";
+            click_crisp: "click_crisp";
+            click_light: "click_light";
+            click_mouse: "click_mouse";
+            click_soft: "click_soft";
+            drop: "drop";
+            drop_high: "drop_high";
+            glass_ping: "glass_ping";
+            glass_soft: "glass_soft";
+            glitch: "glitch";
+            paper_swipe: "paper_swipe";
+            pluck: "pluck";
+            pluck_bright: "pluck_bright";
+            question_ping: "question_ping";
+            ring_classic: "ring_classic";
+            ring_digital: "ring_digital";
+            ring_marimba: "ring_marimba";
+            shutter: "shutter";
+            sweep: "sweep";
+            switch_flip: "switch_flip";
+            switch_heavy: "switch_heavy";
+            switch_light: "switch_light";
+            tick: "tick";
+            toggle_snap: "toggle_snap";
+            whip: "whip";
+            whoosh: "whoosh";
+        }>>;
+        answer: z.ZodOptional<z.ZodEnum<{
+            answer_confirm: "answer_confirm";
+            answer_open: "answer_open";
+            answer_pop: "answer_pop";
+            answer_select: "answer_select";
+            bong: "bong";
+            chime: "chime";
+            click_crisp: "click_crisp";
+            click_light: "click_light";
+            click_mouse: "click_mouse";
+            click_soft: "click_soft";
+            drop: "drop";
+            drop_high: "drop_high";
+            glass_ping: "glass_ping";
+            glass_soft: "glass_soft";
+            glitch: "glitch";
+            paper_swipe: "paper_swipe";
+            pluck: "pluck";
+            pluck_bright: "pluck_bright";
+            question_ping: "question_ping";
+            ring_classic: "ring_classic";
+            ring_digital: "ring_digital";
+            ring_marimba: "ring_marimba";
+            shutter: "shutter";
+            sweep: "sweep";
+            switch_flip: "switch_flip";
+            switch_heavy: "switch_heavy";
+            switch_light: "switch_light";
+            tick: "tick";
+            toggle_snap: "toggle_snap";
+            whip: "whip";
+            whoosh: "whoosh";
+        }>>;
+        notify: z.ZodOptional<z.ZodEnum<{
+            answer_confirm: "answer_confirm";
+            answer_open: "answer_open";
+            answer_pop: "answer_pop";
+            answer_select: "answer_select";
+            bong: "bong";
+            chime: "chime";
+            click_crisp: "click_crisp";
+            click_light: "click_light";
+            click_mouse: "click_mouse";
+            click_soft: "click_soft";
+            drop: "drop";
+            drop_high: "drop_high";
+            glass_ping: "glass_ping";
+            glass_soft: "glass_soft";
+            glitch: "glitch";
+            paper_swipe: "paper_swipe";
+            pluck: "pluck";
+            pluck_bright: "pluck_bright";
+            question_ping: "question_ping";
+            ring_classic: "ring_classic";
+            ring_digital: "ring_digital";
+            ring_marimba: "ring_marimba";
+            shutter: "shutter";
+            sweep: "sweep";
+            switch_flip: "switch_flip";
+            switch_heavy: "switch_heavy";
+            switch_light: "switch_light";
+            tick: "tick";
+            toggle_snap: "toggle_snap";
+            whip: "whip";
+            whoosh: "whoosh";
+        }>>;
+        step: z.ZodOptional<z.ZodEnum<{
+            answer_confirm: "answer_confirm";
+            answer_open: "answer_open";
+            answer_pop: "answer_pop";
+            answer_select: "answer_select";
+            bong: "bong";
+            chime: "chime";
+            click_crisp: "click_crisp";
+            click_light: "click_light";
+            click_mouse: "click_mouse";
+            click_soft: "click_soft";
+            drop: "drop";
+            drop_high: "drop_high";
+            glass_ping: "glass_ping";
+            glass_soft: "glass_soft";
+            glitch: "glitch";
+            paper_swipe: "paper_swipe";
+            pluck: "pluck";
+            pluck_bright: "pluck_bright";
+            question_ping: "question_ping";
+            ring_classic: "ring_classic";
+            ring_digital: "ring_digital";
+            ring_marimba: "ring_marimba";
+            shutter: "shutter";
+            sweep: "sweep";
+            switch_flip: "switch_flip";
+            switch_heavy: "switch_heavy";
+            switch_light: "switch_light";
+            tick: "tick";
+            toggle_snap: "toggle_snap";
+            whip: "whip";
+            whoosh: "whoosh";
+        }>>;
+        whoosh: z.ZodOptional<z.ZodEnum<{
+            answer_confirm: "answer_confirm";
+            answer_open: "answer_open";
+            answer_pop: "answer_pop";
+            answer_select: "answer_select";
+            bong: "bong";
+            chime: "chime";
+            click_crisp: "click_crisp";
+            click_light: "click_light";
+            click_mouse: "click_mouse";
+            click_soft: "click_soft";
+            drop: "drop";
+            drop_high: "drop_high";
+            glass_ping: "glass_ping";
+            glass_soft: "glass_soft";
+            glitch: "glitch";
+            paper_swipe: "paper_swipe";
+            pluck: "pluck";
+            pluck_bright: "pluck_bright";
+            question_ping: "question_ping";
+            ring_classic: "ring_classic";
+            ring_digital: "ring_digital";
+            ring_marimba: "ring_marimba";
+            shutter: "shutter";
+            sweep: "sweep";
+            switch_flip: "switch_flip";
+            switch_heavy: "switch_heavy";
+            switch_light: "switch_light";
+            tick: "tick";
+            toggle_snap: "toggle_snap";
+            whip: "whip";
+            whoosh: "whoosh";
+        }>>;
+        flash: z.ZodOptional<z.ZodEnum<{
+            answer_confirm: "answer_confirm";
+            answer_open: "answer_open";
+            answer_pop: "answer_pop";
+            answer_select: "answer_select";
+            bong: "bong";
+            chime: "chime";
+            click_crisp: "click_crisp";
+            click_light: "click_light";
+            click_mouse: "click_mouse";
+            click_soft: "click_soft";
+            drop: "drop";
+            drop_high: "drop_high";
+            glass_ping: "glass_ping";
+            glass_soft: "glass_soft";
+            glitch: "glitch";
+            paper_swipe: "paper_swipe";
+            pluck: "pluck";
+            pluck_bright: "pluck_bright";
+            question_ping: "question_ping";
+            ring_classic: "ring_classic";
+            ring_digital: "ring_digital";
+            ring_marimba: "ring_marimba";
+            shutter: "shutter";
+            sweep: "sweep";
+            switch_flip: "switch_flip";
+            switch_heavy: "switch_heavy";
+            switch_light: "switch_light";
+            tick: "tick";
+            toggle_snap: "toggle_snap";
+            whip: "whip";
+            whoosh: "whoosh";
+        }>>;
+    }, z.core.$strict>]>>;
     person: z.ZodOptional<z.ZodString>;
     actor_id: z.ZodOptional<z.ZodString>;
     image: z.ZodOptional<z.ZodString>;
@@ -232,9 +1079,43 @@ export declare const offeredUgcInput: z.ZodObject<{
     }>>;
     captions: z.ZodDefault<z.ZodBoolean>;
     caption_style: z.ZodDefault<z.ZodEnum<{
+        arcade: "arcade";
+        bassdrop: "bassdrop";
+        broadcast: "broadcast";
+        bubblegum: "bubblegum";
+        campfire: "campfire";
+        clutch: "clutch";
+        crayon: "crayon";
+        genz: "genz";
+        headline: "headline";
+        highlighter: "highlighter";
         hormozi: "hormozi";
+        instagram: "instagram";
+        lecture: "lecture";
+        lyrics: "lyrics";
+        midnight: "midnight";
         minimal: "minimal";
+        minimalist: "minimalist";
+        neon: "neon";
+        plottwist: "plottwist";
+        promo: "promo";
+        punch: "punch";
+        studio: "studio";
         tiktok: "tiktok";
+        youtube: "youtube";
+    }>>;
+    caption_emphasis: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        quote: z.ZodString;
+        look: z.ZodOptional<z.ZodEnum<{
+            color: "color";
+            pill: "pill";
+            punch: "punch";
+        }>>;
+        punch_in: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>]>>>;
+    caption_mode: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        highlights: "highlights";
     }>>;
     look: z.ZodDefault<z.ZodEnum<{
         commercial: "commercial";
@@ -268,6 +1149,250 @@ export declare const offeredUgcInput: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type MakeUgcInputArgs = z.input<typeof offeredUgcInput>;
+/** The MCP offer: the same fields with the slim template item, which keeps tools/list small (#778 S3, D3). */
+export declare const mcpUgcInputShape: {
+    script: z.ZodOptional<z.ZodString>;
+    segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            actor: "actor";
+            media: "media";
+        }>;
+        script: z.ZodOptional<z.ZodString>;
+        media_url: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodOptional<z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>>;
+        duration_seconds: z.ZodOptional<z.ZodNumber>;
+        image_motion: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    inserts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        media_url: z.ZodOptional<z.ZodString>;
+        asset_id: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        image_motion: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strict>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+    }, z.core.$strict>>>;
+    overlays: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        media_url: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        id: z.ZodString;
+        asset_id: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        enter: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            fade: "fade";
+            slide: "slide";
+            tilt_in: "tilt_in";
+        }>>;
+        position: z.ZodEnum<{
+            bottom: "bottom";
+            bottom_left: "bottom_left";
+            bottom_right: "bottom_right";
+            top: "top";
+            top_left: "top_left";
+            top_right: "top_right";
+        }>;
+    }, z.core.$strict>>>;
+    layout_windows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        media_url: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        id: z.ZodString;
+        asset_id: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        enter: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            fade: "fade";
+            slide: "slide";
+            tilt_in: "tilt_in";
+        }>>;
+        layout: z.ZodEnum<{
+            card: "card";
+            split: "split";
+        }>;
+        blur_presenter: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    template_theme: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodOptional<z.ZodEnum<{
+            bold_dark: "bold_dark";
+            clean_light: "clean_light";
+            mono: "mono";
+            neon: "neon";
+            paper: "paper";
+        }>>;
+        accent: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    person: z.ZodOptional<z.ZodString>;
+    actor_id: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+    actor_gender: z.ZodOptional<z.ZodEnum<{
+        female: "female";
+        male: "male";
+    }>>;
+    name: z.ZodOptional<z.ZodString>;
+    broll_policy: z.ZodOptional<z.ZodEnum<{
+        anyone: "anyone";
+        no_actor: "no_actor";
+        no_people: "no_people";
+    }>>;
+    captions: z.ZodDefault<z.ZodBoolean>;
+    caption_style: z.ZodDefault<z.ZodEnum<{
+        arcade: "arcade";
+        bassdrop: "bassdrop";
+        broadcast: "broadcast";
+        bubblegum: "bubblegum";
+        campfire: "campfire";
+        clutch: "clutch";
+        crayon: "crayon";
+        genz: "genz";
+        headline: "headline";
+        highlighter: "highlighter";
+        hormozi: "hormozi";
+        instagram: "instagram";
+        lecture: "lecture";
+        lyrics: "lyrics";
+        midnight: "midnight";
+        minimal: "minimal";
+        minimalist: "minimalist";
+        neon: "neon";
+        plottwist: "plottwist";
+        promo: "promo";
+        punch: "punch";
+        studio: "studio";
+        tiktok: "tiktok";
+        youtube: "youtube";
+    }>>;
+    caption_emphasis: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        quote: z.ZodString;
+        look: z.ZodOptional<z.ZodEnum<{
+            color: "color";
+            pill: "pill";
+            punch: "punch";
+        }>>;
+        punch_in: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>]>>>;
+    caption_mode: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        highlights: "highlights";
+    }>>;
+    look: z.ZodDefault<z.ZodEnum<{
+        commercial: "commercial";
+        natural: "natural";
+        raw_iphone: "raw_iphone";
+    }>>;
+    aspect_ratio: z.ZodOptional<z.ZodEnum<{
+        "16:9": "16:9";
+        "1:1": "1:1";
+        "9:16": "9:16";
+    }>>;
+    resolution: z.ZodOptional<z.ZodEnum<{
+        "1080p": "1080p";
+        "4k": "4k";
+        "720p": "720p";
+    }>>;
+    voice: z.ZodOptional<z.ZodString>;
+    voice_id: z.ZodOptional<z.ZodString>;
+    tts_model: z.ZodOptional<z.ZodEnum<{
+        eleven_flash_v2_5: "eleven_flash_v2_5";
+        eleven_turbo_v2_5: "eleven_turbo_v2_5";
+        eleven_v3: "eleven_v3";
+        eleven_v4: "eleven_v4";
+        "gemini-3.8-flash-tts": "gemini-3.8-flash-tts";
+    }>>;
+    visible_ai_label: z.ZodOptional<z.ZodBoolean>;
+    background: z.ZodOptional<z.ZodEnum<{
+        blur: "blur";
+        contain: "contain";
+        white: "white";
+    }>>;
+    templates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        placement: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            over: "over";
+        }>>;
+        transition: z.ZodOptional<z.ZodEnum<{
+            cut: "cut";
+            flash: "flash";
+            wipe: "wipe";
+            zoom: "zoom";
+        }>>;
+        kind: z.ZodEnum<{
+            callout: "callout";
+            checklist: "checklist";
+            compare: "compare";
+            end_card: "end_card";
+            lower_third: "lower_third";
+            notification: "notification";
+            phone_call: "phone_call";
+            progress: "progress";
+            quote: "quote";
+            rating: "rating";
+            stat: "stat";
+            tag: "tag";
+            title_card: "title_card";
+        }>;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>>>;
+    template_sounds: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+};
 /** One rejected field found in the input: its name and the refusal reason. */
 export interface RejectedFieldHit {
     field: ContractField;