@clipwright/core 0.34.0 → 0.36.0

package/dist/reference-analysis.d.ts

@@ -0,0 +1,915 @@
+import { z } from "zod";
+import { type ReferenceProfile } from "./reference-profile.js";
+/** Reference analysis (reference-to-video S1c): an MP4 asset read into a `reference_profile`. Its status lives at its own */
+/** path, as an asset's processing does; its money (#927) rides a run of skill `analyze_reference` that holds and settles it. */
+export declare const REFERENCE_ANALYSES_PATH = "/v1/reference-analyses";
+export declare const REFERENCE_ANALYSIS_PATH = "/v1/reference-analyses/:id";
+export declare const REFERENCE_ANALYSIS_QUOTE_PATH = "/v1/reference-analyses/quote";
+export declare const ANALYZE_REFERENCE_TASK = "analyze-reference";
+/** The run skill that carries an analysis's hold and charge; not a `SKILLS` entry, since no `/v1/skills` route starts it. */
+export declare const ANALYZE_REFERENCE_SKILL = "analyze_reference";
+export declare const referenceAnalysisId: z.ZodString;
+/** The price of a delivered analysis. */
+export declare const REFERENCE_ANALYSIS_CREDITS = 70;
+/** The data mode: metrics, transcript and a frame sheet without the vision pass. */
+export declare const REFERENCE_DATA_CREDITS = 10;
+/** `full` reads the reference into a profile; `data` hands back its numbers, words and a frame sheet, with no vision call. */
+export declare const REFERENCE_ANALYSIS_MODES: readonly ["full", "data"];
+export type ReferenceAnalysisMode = (typeof REFERENCE_ANALYSIS_MODES)[number];
+export declare const REFERENCE_ANALYSIS_MODE_CREDITS: Readonly<Record<ReferenceAnalysisMode, number>>;
+/** New analyses per account per hour: each costs us vendor money even when it fails, so the cap stays beside the price. */
+export declare const REFERENCE_ANALYSIS_PER_HOUR = 10;
+/** The data mode's own cap, scope `reference_data`: cheap enough to run on every candidate reel of a search (#921). */
+export declare const REFERENCE_DATA_PER_HOUR = 60;
+export declare const REFERENCE_DATA_SHEET_COLUMNS = 3;
+export declare const REFERENCE_DATA_SHEET_ROWS = 3;
+export declare const REFERENCE_DATA_SHEET_MAX_WIDTH = 1080;
+export declare const REFERENCE_ANALYSIS_WINDOW_SECONDS = 3600;
+/** The analysis stops here and fails; under the task's ceiling. */
+export declare const REFERENCE_ANALYSIS_WORK_SECONDS = 420;
+export declare const REFERENCE_ANALYSIS_TASK_MAX_DURATION_SECONDS = 600;
+/** Past this a read calls an unfinished analysis failed: a task killed at its ceiling writes nothing. */
+export declare const REFERENCE_ANALYSIS_DEADLINE_SECONDS = 900;
+export declare const REFERENCE_ANALYSIS_STATES: readonly ["queued", "analyzing", "succeeded", "failed"];
+export declare const REFERENCE_ANALYSIS_ERRORS: readonly ["timed_out", "analysis_failed", "asset_gone", "enqueue_failed"];
+export type ReferenceAnalysisError = (typeof REFERENCE_ANALYSIS_ERRORS)[number];
+export declare const REFERENCE_ANALYSIS_ERROR_MESSAGES: Readonly<Record<ReferenceAnalysisError, string>>;
+/** What starts an analysis: ids only, so no file name or reference text reaches a log. */
+export declare const analyzeReferencePayload: z.ZodObject<{
+    analysisId: z.ZodString;
+    accountId: z.ZodString;
+}, z.core.$strict>;
+export type AnalyzeReferencePayload = z.infer<typeof analyzeReferencePayload>;
+export declare const REFERENCE_SOURCE_PLATFORMS: readonly ["instagram", "tiktok"];
+export type ReferenceSourcePlatform = (typeof REFERENCE_SOURCE_PLATFORMS)[number];
+/** The live analysis a link replays is found by this key; a short TikTok link has none before it is resolved. */
+export declare const referenceSourceKey: z.ZodString;
+export declare const REFERENCE_URL_YOUTUBE_REFUSAL = "YouTube gives no video file through our source; upload the MP4 with create_asset";
+export declare const REFERENCE_URL_ACCEPTED: string;
+export type ReferenceUrl = {
+    ok: true;
+    url: string;
+    platform: ReferenceSourcePlatform;
+    key: string | null;
+} | {
+    ok: false;
+    message: string;
+};
+/** Which post a link names, read from its text alone: no network, so a refusal costs nothing (#930 S3). */
+export declare function classifyReferenceUrl(raw: string): ReferenceUrl;
+export declare const analyzeReferenceRequest: z.ZodObject<{
+    asset_id: z.ZodOptional<z.ZodString>;
+    source_url: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        data: "data";
+        full: "full";
+    }>>;
+}, z.core.$strict>;
+export type AnalyzeReferenceRequest = z.infer<typeof analyzeReferenceRequest>;
+/** The post behind a link analysis (#930 S3): `null` is unknown, never 0, and each unknown is also a line in `warnings[]`. */
+export declare const referenceSource: z.ZodObject<{
+    url: z.ZodString;
+    platform: z.ZodEnum<{
+        instagram: "instagram";
+        tiktok: "tiktok";
+    }>;
+    key: z.ZodString;
+    measured_at: z.ZodString;
+    published_at: z.ZodNullable<z.ZodString>;
+    duration_s: z.ZodNullable<z.ZodNumber>;
+    metrics: z.ZodObject<{
+        views: z.ZodNullable<z.ZodNumber>;
+        likes: z.ZodNullable<z.ZodNumber>;
+        comments: z.ZodNullable<z.ZodNumber>;
+        views_per_hour: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+    author_median: z.ZodNullable<z.ZodObject<{
+        views: z.ZodNullable<z.ZodNumber>;
+        ratio: z.ZodNullable<z.ZodNumber>;
+        reels: z.ZodNumber;
+        window: z.ZodString;
+    }, z.core.$strict>>;
+    author_recent: z.ZodNullable<z.ZodObject<{
+        views: z.ZodNullable<z.ZodNumber>;
+        ratio: z.ZodNullable<z.ZodNumber>;
+        reels: z.ZodNumber;
+        window: z.ZodString;
+    }, z.core.$strict>>;
+    top_comments: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        likes: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    code_words: z.ZodArray<z.ZodObject<{
+        word: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ReferenceSource = z.infer<typeof referenceSource>;
+/** What a succeeded data analysis hands back (#930 S4): the probe, the transcribed words as the profile writes them, and a frame sheet. */
+export declare const referenceData: z.ZodObject<{
+    transcript: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        start_s: z.ZodNumber;
+        end_s: z.ZodNumber;
+        speaker: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    hook: z.ZodNullable<z.ZodObject<{
+        text: z.ZodString;
+        end_s: z.ZodNumber;
+        caption: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    duration_s: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    frame_sheet: z.ZodObject<{
+        columns: z.ZodNumber;
+        rows: z.ZodNumber;
+        times_s: z.ZodArray<z.ZodNumber>;
+        url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ReferenceData = z.infer<typeof referenceData>;
+/** What the data pass answers: the words, the sheet it uploaded and its warnings. */
+export declare const referenceDataPass: z.ZodObject<{
+    transcript: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        start_s: z.ZodNumber;
+        end_s: z.ZodNumber;
+        speaker: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    hook: z.ZodNullable<z.ZodObject<{
+        text: z.ZodString;
+        end_s: z.ZodNumber;
+        caption: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    frame_sheet: z.ZodObject<{
+        columns: z.ZodNumber;
+        rows: z.ZodNumber;
+        times_s: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strict>;
+    cost_usd: z.ZodNumber;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type ReferenceDataPass = z.infer<typeof referenceDataPass>;
+/** The row's `data`: the answer with the sheet's R2 key in place of its link, and our vendor cost, which no client reads. */
+export declare const referenceDataStored: z.ZodObject<{
+    transcript: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        start_s: z.ZodNumber;
+        end_s: z.ZodNumber;
+        speaker: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    hook: z.ZodNullable<z.ZodObject<{
+        text: z.ZodString;
+        end_s: z.ZodNumber;
+        caption: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    duration_s: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    frame_sheet: z.ZodObject<{
+        columns: z.ZodNumber;
+        rows: z.ZodNumber;
+        times_s: z.ZodArray<z.ZodNumber>;
+        key: z.ZodString;
+    }, z.core.$strict>;
+    cost_usd: z.ZodNumber;
+}, z.core.$strict>;
+export type ReferenceDataStored = z.infer<typeof referenceDataStored>;
+export declare const referenceAnalysis: z.ZodObject<{
+    analysis_id: z.ZodString;
+    asset_id: z.ZodString;
+    mode: z.ZodEnum<{
+        data: "data";
+        full: "full";
+    }>;
+    state: z.ZodEnum<{
+        analyzing: "analyzing";
+        failed: "failed";
+        queued: "queued";
+        succeeded: "succeeded";
+    }>;
+    reference_profile: z.ZodNullable<z.ZodObject<{
+        version: z.ZodLiteral<"reference-profile-v1">;
+        source: z.ZodObject<{
+            digest: z.ZodString;
+            duration_s: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        format: z.ZodEnum<{
+            broll: "broll";
+            faceless: "faceless";
+            other: "other";
+            talking_head_graphics: "talking_head_graphics";
+        }>;
+        beats: z.ZodArray<z.ZodObject<{
+            start_frac: z.ZodNumber;
+            end_frac: z.ZodNumber;
+            start_s: z.ZodNumber;
+            end_s: z.ZodNumber;
+            role: z.ZodEnum<{
+                agitation: "agitation";
+                before_after: "before_after";
+                cta: "cta";
+                demo: "demo";
+                hook: "hook";
+                offer: "offer";
+                other: "other";
+                problem: "problem";
+                proof: "proof";
+                social_proof: "social_proof";
+                solution: "solution";
+            }>;
+            spoken_summary: z.ZodString;
+            graphics: z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    callout: "callout";
+                    checklist: "checklist";
+                    compare: "compare";
+                    end_card: "end_card";
+                    insert_media: "insert_media";
+                    layout_split: "layout_split";
+                    lower_third: "lower_third";
+                    notification: "notification";
+                    overlay_media: "overlay_media";
+                    particles: "particles";
+                    phone_call: "phone_call";
+                    progress: "progress";
+                    quote: "quote";
+                    rating: "rating";
+                    stat: "stat";
+                    tag: "tag";
+                    title_card: "title_card";
+                    unmapped: "unmapped";
+                }>;
+                source_kind: z.ZodEnum<{
+                    banner: "banner";
+                    before_after_split: "before_after_split";
+                    callout: "callout";
+                    checklist: "checklist";
+                    comment_box: "comment_box";
+                    compare: "compare";
+                    concept_card: "concept_card";
+                    end_card: "end_card";
+                    insert_media: "insert_media";
+                    layout_split: "layout_split";
+                    logo_card: "logo_card";
+                    lower_third: "lower_third";
+                    notification: "notification";
+                    other: "other";
+                    overlay_media: "overlay_media";
+                    particles: "particles";
+                    phone_call: "phone_call";
+                    price_card: "price_card";
+                    product_ui: "product_ui";
+                    progress: "progress";
+                    quote: "quote";
+                    rating: "rating";
+                    screenshot: "screenshot";
+                    split_screen: "split_screen";
+                    stat: "stat";
+                    tag: "tag";
+                    title_card: "title_card";
+                    toggle_checklist: "toggle_checklist";
+                    unmapped: "unmapped";
+                }>;
+                position: z.ZodEnum<{
+                    bottom: "bottom";
+                    bottom_left: "bottom_left";
+                    bottom_right: "bottom_right";
+                    center: "center";
+                    full_screen: "full_screen";
+                    other: "other";
+                    split_bottom: "split_bottom";
+                    split_top: "split_top";
+                    top: "top";
+                    top_left: "top_left";
+                    top_right: "top_right";
+                }>;
+                state_changes: z.ZodArray<z.ZodObject<{
+                    at_frac: z.ZodNumber;
+                    change: z.ZodEnum<{
+                        appears: "appears";
+                        checked: "checked";
+                        disappears: "disappears";
+                        highlighted: "highlighted";
+                        other: "other";
+                        toggles_off: "toggles_off";
+                        toggles_on: "toggles_on";
+                        value_changes: "value_changes";
+                    }>;
+                }, z.core.$strict>>;
+                label_hint: z.ZodString;
+            }, z.core.$strict>>;
+            camera: z.ZodEnum<{
+                other: "other";
+                punch_in: "punch_in";
+                shake: "shake";
+                static: "static";
+                zoom_out: "zoom_out";
+            }>;
+            transition_in: z.ZodEnum<{
+                cut: "cut";
+                flash: "flash";
+                none: "none";
+                other: "other";
+                wipe: "wipe";
+                zoom: "zoom";
+            }>;
+            sounds: z.ZodArray<z.ZodObject<{
+                at_frac: z.ZodNumber;
+                kind: z.ZodEnum<{
+                    answer: "answer";
+                    click: "click";
+                    edit: "edit";
+                    flash: "flash";
+                    hangup: "hangup";
+                    money: "money";
+                    music: "music";
+                    notify: "notify";
+                    other: "other";
+                    pop: "pop";
+                    recorded_audio: "recorded_audio";
+                    ring: "ring";
+                    step: "step";
+                    toggle: "toggle";
+                    whoosh: "whoosh";
+                }>;
+            }, z.core.$strict>>;
+            presenter_behaviour: z.ZodEnum<{
+                absent: "absent";
+                listening: "listening";
+                reacting: "reacting";
+                speaking: "speaking";
+            }>;
+        }, z.core.$strict>>;
+        captions: z.ZodObject<{
+            present: z.ZodBoolean;
+            words_per_caption_max: z.ZodNumber;
+            position: z.ZodEnum<{
+                bottom: "bottom";
+                lower: "lower";
+                middle: "middle";
+                top: "top";
+            }>;
+            emphasis_style: z.ZodEnum<{
+                color: "color";
+                none: "none";
+                pill: "pill";
+                punch: "punch";
+            }>;
+            hidden_under_graphics: z.ZodBoolean;
+        }, z.core.$strict>;
+        pacing: z.ZodObject<{
+            layer_change_every_s: z.ZodNumber;
+            face_share: z.ZodNumber;
+        }, z.core.$strict>;
+        palette: z.ZodArray<z.ZodString>;
+        music: z.ZodString;
+        unmapped: z.ZodArray<z.ZodObject<{
+            what: z.ZodString;
+            beat_index: z.ZodNumber;
+            suggested_substitute: z.ZodString;
+        }, z.core.$strict>>;
+        analysis: z.ZodObject<{
+            models: z.ZodArray<z.ZodString>;
+            cost_usd: z.ZodOptional<z.ZodNumber>;
+            latency_ms: z.ZodNumber;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        voice: z.ZodOptional<z.ZodObject<{
+            version: z.ZodLiteral<"voice-profile-v1">;
+            method: z.ZodObject<{
+                pause_drop_db: z.ZodNumber;
+                pause_min_run_s: z.ZodNumber;
+                cut_safe_db: z.ZodNumber;
+                pitch: z.ZodLiteral<"yin">;
+                sample_rate: z.ZodNumber;
+            }, z.core.$strict>;
+            presenter_speaker: z.ZodNullable<z.ZodString>;
+            speakers: z.ZodArray<z.ZodObject<{
+                speaker: z.ZodString;
+                word_count: z.ZodNumber;
+                sentence_count: z.ZodNumber;
+                pace: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        measured: "measured";
+                        unmeasured: "unmeasured";
+                    }>;
+                    words_per_second: z.ZodNullable<z.ZodNumber>;
+                    basis: z.ZodEnum<{
+                        sentence_spans: "sentence_spans";
+                        turn_spans: "turn_spans";
+                    }>;
+                }, z.core.$strict>;
+                pauses: z.ZodObject<{
+                    sentence_end: z.ZodObject<{
+                        timestamp: z.ZodObject<{
+                            count: z.ZodNumber;
+                            median_s: z.ZodNullable<z.ZodNumber>;
+                            p90_s: z.ZodNullable<z.ZodNumber>;
+                            count_ge150ms: z.ZodNumber;
+                        }, z.core.$strict>;
+                        acoustic_pause: z.ZodObject<{
+                            count: z.ZodNumber;
+                            median_s: z.ZodNullable<z.ZodNumber>;
+                            p90_s: z.ZodNullable<z.ZodNumber>;
+                            count_ge150ms: z.ZodNumber;
+                        }, z.core.$strict>;
+                        cut_safe: z.ZodObject<{
+                            count: z.ZodNumber;
+                            median_s: z.ZodNullable<z.ZodNumber>;
+                            p90_s: z.ZodNullable<z.ZodNumber>;
+                            count_ge150ms: z.ZodNumber;
+                        }, z.core.$strict>;
+                        acoustic_no_dip_count: z.ZodNumber;
+                        acoustic_unconfirmed_count: z.ZodNumber;
+                    }, z.core.$strict>;
+                    comma: z.ZodObject<{
+                        timestamp: z.ZodObject<{
+                            count: z.ZodNumber;
+                            median_s: z.ZodNullable<z.ZodNumber>;
+                            p90_s: z.ZodNullable<z.ZodNumber>;
+                            count_ge150ms: z.ZodNumber;
+                        }, z.core.$strict>;
+                        acoustic_pause: z.ZodObject<{
+                            count: z.ZodNumber;
+                            median_s: z.ZodNullable<z.ZodNumber>;
+                            p90_s: z.ZodNullable<z.ZodNumber>;
+                            count_ge150ms: z.ZodNumber;
+                        }, z.core.$strict>;
+                        cut_safe: z.ZodObject<{
+                            count: z.ZodNumber;
+                            median_s: z.ZodNullable<z.ZodNumber>;
+                            p90_s: z.ZodNullable<z.ZodNumber>;
+                            count_ge150ms: z.ZodNumber;
+                        }, z.core.$strict>;
+                        acoustic_no_dip_count: z.ZodNumber;
+                        acoustic_unconfirmed_count: z.ZodNumber;
+                    }, z.core.$strict>;
+                    mid_phrase: z.ZodObject<{
+                        timestamp: z.ZodObject<{
+                            count: z.ZodNumber;
+                            median_s: z.ZodNullable<z.ZodNumber>;
+                            p90_s: z.ZodNullable<z.ZodNumber>;
+                            count_ge150ms: z.ZodNumber;
+                        }, z.core.$strict>;
+                        acoustic_pause: z.ZodObject<{
+                            count: z.ZodNumber;
+                            median_s: z.ZodNullable<z.ZodNumber>;
+                            p90_s: z.ZodNullable<z.ZodNumber>;
+                            count_ge150ms: z.ZodNumber;
+                        }, z.core.$strict>;
+                        cut_safe: z.ZodObject<{
+                            count: z.ZodNumber;
+                            median_s: z.ZodNullable<z.ZodNumber>;
+                            p90_s: z.ZodNullable<z.ZodNumber>;
+                            count_ge150ms: z.ZodNumber;
+                        }, z.core.$strict>;
+                        acoustic_no_dip_count: z.ZodNumber;
+                        acoustic_unconfirmed_count: z.ZodNumber;
+                    }, z.core.$strict>;
+                }, z.core.$strict>;
+                long_pause_count: z.ZodNumber;
+                hinge: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        measured: "measured";
+                        not_evaluated: "not_evaluated";
+                    }>;
+                    sentence_share: z.ZodNullable<z.ZodNumber>;
+                    evaluated_sentences: z.ZodNumber;
+                    coverage: z.ZodNullable<z.ZodNumber>;
+                    timestamp_sentence_share: z.ZodNullable<z.ZodNumber>;
+                    median_position: z.ZodNullable<z.ZodNumber>;
+                    median_seconds: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strict>;
+                pitch: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        measured: "measured";
+                        no_voiced_frames: "no_voiced_frames";
+                    }>;
+                    ceiling_hz: z.ZodNumber;
+                    ceiling_basis: z.ZodEnum<{
+                        configured: "configured";
+                        default: "default";
+                        low_f0: "low_f0";
+                    }>;
+                    median_hz: z.ZodNullable<z.ZodNumber>;
+                    p10_hz: z.ZodNullable<z.ZodNumber>;
+                    p90_hz: z.ZodNullable<z.ZodNumber>;
+                    range_st: z.ZodNullable<z.ZodNumber>;
+                    voiced_frames: z.ZodNumber;
+                }, z.core.$strict>;
+                loudness: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        measured: "measured";
+                        unmeasured: "unmeasured";
+                    }>;
+                    range_db_p10_p90: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strict>;
+                warnings: z.ZodArray<z.ZodEnum<{
+                    background_music_present_f0_and_intensity_may_be_contaminated: "background_music_present_f0_and_intensity_may_be_contaminated";
+                    no_sentence_terminal_punctuation_pace_uses_turn_spans: "no_sentence_terminal_punctuation_pace_uses_turn_spans";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        presenter_framing: z.ZodOptional<z.ZodEnum<{
+            close: "close";
+            wide: "wide";
+        }>>;
+        presenter_mic: z.ZodOptional<z.ZodBoolean>;
+        staging: z.ZodOptional<z.ZodObject<{
+            version: z.ZodLiteral<"reference-staging-v1">;
+            analysis_width: z.ZodNumber;
+            anchors: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                t_s: z.ZodNumber;
+            }, z.core.$strict>>;
+            elements: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                beat_index: z.ZodNumber;
+                graphic_index: z.ZodNullable<z.ZodNumber>;
+                kind: z.ZodEnum<{
+                    banner: "banner";
+                    before_after_split: "before_after_split";
+                    callout: "callout";
+                    checklist: "checklist";
+                    comment_box: "comment_box";
+                    compare: "compare";
+                    concept_card: "concept_card";
+                    end_card: "end_card";
+                    insert_media: "insert_media";
+                    layout_split: "layout_split";
+                    logo_card: "logo_card";
+                    lower_third: "lower_third";
+                    notification: "notification";
+                    other: "other";
+                    overlay_media: "overlay_media";
+                    particles: "particles";
+                    phone_call: "phone_call";
+                    price_card: "price_card";
+                    product_ui: "product_ui";
+                    progress: "progress";
+                    quote: "quote";
+                    rating: "rating";
+                    screenshot: "screenshot";
+                    split_screen: "split_screen";
+                    stat: "stat";
+                    tag: "tag";
+                    title_card: "title_card";
+                    toggle_checklist: "toggle_checklist";
+                    unmapped: "unmapped";
+                }>;
+                rect_hold: z.ZodOptional<z.ZodObject<{
+                    left: z.ZodNumber;
+                    top: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>>;
+                rect_hold_face: z.ZodOptional<z.ZodObject<{
+                    left: z.ZodNumber;
+                    top: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>>;
+                rect_method: z.ZodOptional<z.ZodEnum<{
+                    "cv-before-after/v1": "cv-before-after/v1";
+                    "cv-cells/v1": "cv-cells/v1";
+                    "cv-parallax/v1": "cv-parallax/v1";
+                    "cv-template/v1": "cv-template/v1";
+                    "vision-still": "vision-still";
+                    "vision-video": "vision-video";
+                    "yunet-native/v1": "yunet-native/v1";
+                }>>;
+                rects: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    t_s: z.ZodNumber;
+                    rect: z.ZodObject<{
+                        left: z.ZodNumber;
+                        top: z.ZodNumber;
+                        width: z.ZodNumber;
+                        height: z.ZodNumber;
+                    }, z.core.$strict>;
+                    visible: z.ZodNumber;
+                }, z.core.$strict>>>;
+                entry: z.ZodOptional<z.ZodObject<{
+                    first_visible_s: z.ZodOptional<z.ZodNumber>;
+                    settled_s: z.ZodOptional<z.ZodNumber>;
+                    anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        offset_s: z.ZodNumber;
+                    }, z.core.$strict>>>;
+                    style: z.ZodOptional<z.ZodEnum<{
+                        blur_in: "blur_in";
+                        fade: "fade";
+                        pop: "pop";
+                        scale_up: "scale_up";
+                        slide: "slide";
+                        tilt_in: "tilt_in";
+                        typewriter: "typewriter";
+                        unknown: "unknown";
+                        wipe: "wipe";
+                    }>>;
+                    from: z.ZodOptional<z.ZodEnum<{
+                        bottom: "bottom";
+                        left: "left";
+                        lower_left: "lower_left";
+                        lower_right: "lower_right";
+                        none: "none";
+                        right: "right";
+                        top: "top";
+                        upper_left: "upper_left";
+                        upper_right: "upper_right";
+                    }>>;
+                    duration_s: z.ZodOptional<z.ZodNumber>;
+                    displacement: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+                    scale_from: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                    method: z.ZodOptional<z.ZodEnum<{
+                        "cv-before-after/v1": "cv-before-after/v1";
+                        "cv-cells/v1": "cv-cells/v1";
+                        "cv-parallax/v1": "cv-parallax/v1";
+                        "cv-template/v1": "cv-template/v1";
+                        "vision-still": "vision-still";
+                        "vision-video": "vision-video";
+                        "yunet-native/v1": "yunet-native/v1";
+                    }>>;
+                }, z.core.$strict>>;
+                exit: z.ZodOptional<z.ZodObject<{
+                    last_visible_s: z.ZodOptional<z.ZodNumber>;
+                    anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        offset_s: z.ZodNumber;
+                    }, z.core.$strict>>>;
+                    style: z.ZodOptional<z.ZodEnum<{
+                        blur_in: "blur_in";
+                        cut: "cut";
+                        fade: "fade";
+                        flash: "flash";
+                        pop: "pop";
+                        scale_up: "scale_up";
+                        slide: "slide";
+                        tilt_in: "tilt_in";
+                        typewriter: "typewriter";
+                        unknown: "unknown";
+                        wipe: "wipe";
+                    }>>;
+                    to: z.ZodOptional<z.ZodEnum<{
+                        bottom: "bottom";
+                        left: "left";
+                        lower_left: "lower_left";
+                        lower_right: "lower_right";
+                        none: "none";
+                        right: "right";
+                        top: "top";
+                        upper_left: "upper_left";
+                        upper_right: "upper_right";
+                    }>>;
+                    duration_s: z.ZodOptional<z.ZodNumber>;
+                    displacement: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+                    method: z.ZodOptional<z.ZodEnum<{
+                        "cv-before-after/v1": "cv-before-after/v1";
+                        "cv-cells/v1": "cv-cells/v1";
+                        "cv-parallax/v1": "cv-parallax/v1";
+                        "cv-template/v1": "cv-template/v1";
+                        "vision-still": "vision-still";
+                        "vision-video": "vision-video";
+                        "yunet-native/v1": "yunet-native/v1";
+                    }>>;
+                }, z.core.$strict>>;
+                layer: z.ZodOptional<z.ZodObject<{
+                    value: z.ZodEnum<{
+                        behind_presenter: "behind_presenter";
+                        in_front_of_presenter: "in_front_of_presenter";
+                        no_overlap: "no_overlap";
+                        presenter_absent: "presenter_absent";
+                        unknown: "unknown";
+                    }>;
+                    method: z.ZodEnum<{
+                        "cv-before-after/v1": "cv-before-after/v1";
+                        "cv-cells/v1": "cv-cells/v1";
+                        "cv-parallax/v1": "cv-parallax/v1";
+                        "cv-template/v1": "cv-template/v1";
+                        "vision-still": "vision-still";
+                        "vision-video": "vision-video";
+                        "yunet-native/v1": "yunet-native/v1";
+                    }>;
+                    covered_by: z.ZodArray<z.ZodEnum<{
+                        body: "body";
+                        chair: "chair";
+                        desk: "desk";
+                        face: "face";
+                        hair: "hair";
+                        hand: "hand";
+                        microphone: "microphone";
+                        other: "other";
+                        shoulder: "shoulder";
+                    }>>;
+                    face_clear: z.ZodOptional<z.ZodBoolean>;
+                    face_core_cover_max: z.ZodOptional<z.ZodNumber>;
+                    face_covered_share: z.ZodOptional<z.ZodNumber>;
+                    blurs_presenter: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>>;
+                motion: z.ZodOptional<z.ZodObject<{
+                    kind: z.ZodOptional<z.ZodEnum<{
+                        drift: "drift";
+                        float: "float";
+                        moves_with_frame: "moves_with_frame";
+                        pushed: "pushed";
+                        scale: "scale";
+                        static: "static";
+                    }>>;
+                    drift_per_s: z.ZodOptional<z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                    scale_per_s: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+                    wobble: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+                        amplitude: z.ZodNumber;
+                        period_s: z.ZodNumber;
+                    }, z.core.$strict>>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            freezes: z.ZodArray<z.ZodObject<{
+                start_s: z.ZodNumber;
+                end_s: z.ZodNumber;
+                anchors: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    offset_s: z.ZodNumber;
+                }, z.core.$strict>>;
+                face_box_start: z.ZodObject<{
+                    left: z.ZodNumber;
+                    top: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>;
+                face_box_end: z.ZodObject<{
+                    left: z.ZodNumber;
+                    top: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>;
+                roll_deg: z.ZodNumber;
+                yaw: z.ZodNumber;
+                pitch: z.ZodNumber;
+                gaze: z.ZodOptional<z.ZodEnum<{
+                    camera: "camera";
+                    closed: "closed";
+                    down: "down";
+                    element: "element";
+                    left: "left";
+                    right: "right";
+                    up_left: "up_left";
+                    up_right: "up_right";
+                }>>;
+                head_roll: z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    upright: "upright";
+                }>;
+                expression: z.ZodOptional<z.ZodEnum<{
+                    neutral: "neutral";
+                    other: "other";
+                    smile: "smile";
+                    surprised: "surprised";
+                    thinking: "thinking";
+                }>>;
+                hands: z.ZodOptional<z.ZodEnum<{
+                    at_chest: "at_chest";
+                    gesturing: "gesturing";
+                    other: "other";
+                    out_of_frame: "out_of_frame";
+                }>>;
+                frame_motion: z.ZodOptional<z.ZodObject<{
+                    scale_end: z.ZodNumber;
+                    centre_shift: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+                }, z.core.$strict>>;
+                ends_with: z.ZodEnum<{
+                    cut: "cut";
+                    end: "end";
+                    flash: "flash";
+                    unfreeze: "unfreeze";
+                }>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        transcript: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            start_s: z.ZodNumber;
+            end_s: z.ZodNumber;
+            speaker: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        hook: z.ZodOptional<z.ZodObject<{
+            text: z.ZodString;
+            end_s: z.ZodNumber;
+            caption: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    data: z.ZodNullable<z.ZodObject<{
+        transcript: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            start_s: z.ZodNumber;
+            end_s: z.ZodNumber;
+            speaker: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        hook: z.ZodNullable<z.ZodObject<{
+            text: z.ZodString;
+            end_s: z.ZodNumber;
+            caption: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        duration_s: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fps: z.ZodNumber;
+        frame_sheet: z.ZodObject<{
+            columns: z.ZodNumber;
+            rows: z.ZodNumber;
+            times_s: z.ZodArray<z.ZodNumber>;
+            url: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    source: z.ZodNullable<z.ZodObject<{
+        url: z.ZodString;
+        platform: z.ZodEnum<{
+            instagram: "instagram";
+            tiktok: "tiktok";
+        }>;
+        key: z.ZodString;
+        measured_at: z.ZodString;
+        published_at: z.ZodNullable<z.ZodString>;
+        duration_s: z.ZodNullable<z.ZodNumber>;
+        metrics: z.ZodObject<{
+            views: z.ZodNullable<z.ZodNumber>;
+            likes: z.ZodNullable<z.ZodNumber>;
+            comments: z.ZodNullable<z.ZodNumber>;
+            views_per_hour: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        author_median: z.ZodNullable<z.ZodObject<{
+            views: z.ZodNullable<z.ZodNumber>;
+            ratio: z.ZodNullable<z.ZodNumber>;
+            reels: z.ZodNumber;
+            window: z.ZodString;
+        }, z.core.$strict>>;
+        author_recent: z.ZodNullable<z.ZodObject<{
+            views: z.ZodNullable<z.ZodNumber>;
+            ratio: z.ZodNullable<z.ZodNumber>;
+            reels: z.ZodNumber;
+            window: z.ZodString;
+        }, z.core.$strict>>;
+        top_comments: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            likes: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>>;
+        code_words: z.ZodArray<z.ZodObject<{
+            word: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    warnings: z.ZodArray<z.ZodString>;
+    error: z.ZodNullable<z.ZodObject<{
+        code: z.ZodEnum<{
+            analysis_failed: "analysis_failed";
+            asset_gone: "asset_gone";
+            enqueue_failed: "enqueue_failed";
+            timed_out: "timed_out";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+    credits_reserved: z.ZodNumber;
+    credits_charged: z.ZodNullable<z.ZodNumber>;
+    balance_after_credits: z.ZodNullable<z.ZodNumber>;
+    created_at: z.ZodString;
+    finished_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type ReferenceAnalysis = z.infer<typeof referenceAnalysis>;
+export declare const analysisQuoteResponse: z.ZodObject<{
+    asset_id: z.ZodNullable<z.ZodString>;
+    credits_estimate: z.ZodNumber;
+    replays_analysis_id: z.ZodNullable<z.ZodString>;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type AnalysisQuoteResponse = z.infer<typeof analysisQuoteResponse>;
+/** What a client reads: a new state, error code or profile field must not break an installed client. */
+export declare const referenceAnalysisRead: z.ZodObject<{
+    analysis_id: z.ZodString;
+    asset_id: z.ZodString;
+    warnings: z.ZodArray<z.ZodString>;
+    created_at: z.ZodString;
+    finished_at: z.ZodNullable<z.ZodString>;
+    state: z.ZodString;
+    reference_profile: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    error: z.ZodNullable<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    source: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    mode: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    credits_reserved: z.ZodOptional<z.ZodNumber>;
+    credits_charged: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    balance_after_credits: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type ReferenceAnalysisRead = z.infer<typeof referenceAnalysisRead>;
+/** Rule 3: every element we cannot draw is said in `warnings[]` too, not only inside the profile. */
+export declare function referenceAnalysisWarnings(profile: ReferenceProfile): string[];
+export declare const ANALYZE_REFERENCE_DESCRIPTION: string;
+export declare const GET_REFERENCE_ANALYSIS_DESCRIPTION: string;
+export declare const QUOTE_ANALYSIS_DESCRIPTION: string;