@clipwright/core 0.35.0 → 0.37.0

package/dist/reference-analysis.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { type ReferenceProfile } from "./reference-profile.js";
+import { type ReferenceProfileAnswer } 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";
@@ -9,13 +9,26 @@ 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 (owner, 29.10, #800/#927): Argon video plus Flash stills cost us ≈ $0.23 today. */
-/** Argon's price doubles on 2026-12-01 (≈ $0.45, ≈ 135 credits at ×2.5): the owner reprices then; nothing changes it by itself. */
+/** What a succeeded analysis holds: 2 since frames, speakers, gaze and gestures (#979). A start on a reel whose analysis is older */
+/** redoes it at no charge, once. */
+export declare const REFERENCE_ANALYSIS_VERSION = 2;
+/** The price of a delivered analysis. */
 export declare const REFERENCE_ANALYSIS_CREDITS = 70;
-/** New analyses per account per hour: each costs us vendor money even when it fails, so the cap stays beside the price. */
+/** The data mode: metrics, transcript and a frame sheet without beats or graphics. */
+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. */
 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 worker stops its own work here, removes its temp copy and fails the analysis; under the task's ceiling. */
+/** 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. */
@@ -24,19 +37,294 @@ export declare const REFERENCE_ANALYSIS_STATES: readonly ["queued", "analyzing",
 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 the API hands the worker: ids only, so no file name or reference text reaches Trigger.dev's log. */
+/** 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.ZodString;
+    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>;
+/** Instagram's caption limit; a longer one (TikTok allows 4000) is cut and says so. */
+export declare const REFERENCE_CAPTION_MAX_CHARS = 2200;
+/** 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>;
+        shares: z.ZodNullable<z.ZodNumber>;
+        views_per_hour: z.ZodNullable<z.ZodNumber>;
+        age_hours: z.ZodNullable<z.ZodNumber>;
+        comment_rate: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+    author_followers: z.ZodNullable<z.ZodNumber>;
+    author: z.ZodNullable<z.ZodObject<{
+        handle: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+    }, z.core.$strict>>;
+    caption: z.ZodNullable<z.ZodObject<{
+        text: z.ZodString;
+        truncated: z.ZodBoolean;
+    }, 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>>;
+    comments_read: z.ZodNullable<z.ZodNumber>;
+    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>>;
+    code_word_guess: z.ZodNullable<z.ZodString>;
+    funnel: z.ZodNullable<z.ZodObject<{
+        comment_keyword: z.ZodBoolean;
+        word: z.ZodNullable<z.ZodString>;
+    }, 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>>;
+    transcript_language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    hook: z.ZodNullable<z.ZodObject<{
+        text: z.ZodString;
+        end_s: z.ZodNumber;
+        caption: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        start_s: z.ZodNumber;
+        end_s: z.ZodNumber;
+        text: z.ZodString;
+        speaker: z.ZodString;
+        mouth: z.ZodOptional<z.ZodObject<{
+            vision: z.ZodNullable<z.ZodEnum<{
+                closed: "closed";
+                moving: "moving";
+                not_visible: "not_visible";
+            }>>;
+            measured: z.ZodEnum<{
+                moving: "moving";
+                not_measured: "not_measured";
+                still: "still";
+            }>;
+            score: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>>;
+        frames_s: z.ZodArray<z.ZodNumber>;
+    }, 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>;
+/** The data answer's parts, for the record the analysis keeps. */
+export declare const referenceDataParts: {
+    frameSheet: z.ZodObject<{
+        columns: z.ZodNumber;
+        rows: z.ZodNumber;
+        times_s: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strict>;
+    words: {
+        transcript: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            start_s: z.ZodNumber;
+            end_s: z.ZodNumber;
+            speaker: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        /** Since #990; absent on data from before it. */
+        transcript_language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** `null` when no word starts in the first seconds; no caption, since the screen is not read in this mode. */
+        hook: z.ZodNullable<z.ZodObject<{
+            text: z.ZodString;
+            end_s: z.ZodNumber;
+            caption: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        /** The transcript as timed segments with the transcription's speaker label (#979); absent on data from before them. */
+        segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            start_s: z.ZodNumber;
+            end_s: z.ZodNumber;
+            text: z.ZodString;
+            speaker: z.ZodString;
+            mouth: z.ZodOptional<z.ZodObject<{
+                vision: z.ZodNullable<z.ZodEnum<{
+                    closed: "closed";
+                    moving: "moving";
+                    not_visible: "not_visible";
+                }>>;
+                measured: z.ZodEnum<{
+                    moving: "moving";
+                    not_measured: "not_measured";
+                    still: "still";
+                }>;
+                score: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strict>>;
+            frames_s: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strict>>>;
+    };
+    probe: {
+        duration_s: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fps: z.ZodNumber;
+    };
+};
+/** The reel's frames (#979): one a second, 4×3 sheets of 12 seconds, scenes from measured cuts; links signed for a day on each read. */
+export declare const REFERENCE_FRAMES_FPS = 1;
+export declare const REFERENCE_FRAME_MAX_WIDTH = 540;
+export declare const REFERENCE_SHEET_COLUMNS = 4;
+export declare const REFERENCE_SHEET_ROWS = 3;
+export declare const REFERENCE_SHEET_WIDTH = 1080;
+export declare const REFERENCE_FRAMES_PAGE_MAX = 60;
+export declare const REFERENCE_FRAME_LINK_TTL_SECONDS = 86400;
+export declare const MAX_REFERENCE_SCENES = 60;
+export declare const REFERENCE_FRAMES_VERSION = "reference-frames-v1";
+/** A frame's and a sheet's file name; the end frame's carries its tenth of a second. */
+export declare const referenceFrameName: (t: number) => string;
+export declare const referenceSheetName: (index: number) => string;
+/** The frames as kept with an analysis: counts, size and scenes, no links. */
+export declare const referenceFramesStored: z.ZodObject<{
+    version: z.ZodLiteral<"reference-frames-v1">;
+    count: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    sheets: z.ZodNumber;
+    scenes: z.ZodArray<z.ZodObject<{
+        start_s: z.ZodNumber;
+        end_s: z.ZodNumber;
+        key_frame_s: z.ZodNumber;
+    }, z.core.$strict>>;
+    end_s: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type ReferenceFramesStored = z.infer<typeof referenceFramesStored>;
+export declare const REFERENCE_KEY_FRAME_KINDS: readonly ["hook", "beat"];
+export declare const referenceFrames: z.ZodObject<{
+    fps: z.ZodLiteral<1>;
+    count: z.ZodNumber;
+    end_s: z.ZodNullable<z.ZodNumber>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    expires_at: z.ZodString;
+    page: z.ZodObject<{
+        from: z.ZodNumber;
+        to: z.ZodNumber;
+        next: z.ZodNullable<z.ZodObject<{
+            frames_from: z.ZodNumber;
+            frames_to: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    seconds: z.ZodArray<z.ZodObject<{
+        t_s: z.ZodNumber;
+        url: z.ZodString;
+    }, z.core.$strict>>;
+    sheets: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        columns: z.ZodLiteral<4>;
+        rows: z.ZodLiteral<3>;
+        times_s: z.ZodArray<z.ZodNumber>;
+        url: z.ZodString;
+    }, z.core.$strict>>;
+    key_frames: z.ZodArray<z.ZodObject<{
+        t_s: z.ZodNumber;
+        url: z.ZodString;
+        kind: z.ZodEnum<{
+            beat: "beat";
+            hook: "hook";
+        }>;
+        beat_index: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    scenes: z.ZodArray<z.ZodObject<{
+        start_s: z.ZodNumber;
+        end_s: z.ZodNumber;
+        key_frame_s: z.ZodNumber;
+        url: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ReferenceFrames = z.infer<typeof referenceFrames>;
+/** Which frames a read signs; the whole reel when it fits one page. */
+export declare const referenceFramesPage: z.ZodObject<{
+    frames_from: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    frames_to: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export type ReferenceFramesPage = z.infer<typeof referenceFramesPage>;
+/** How long a read may wait for an analysis to finish (#970): under an agent's usual 60 s tool timeout. */
+export declare const REFERENCE_WAIT_MAX_SECONDS = 50;
+/** Measured wall time from start to finish (#970: a full analysis took about 2.5 minutes), for `retry_after_seconds`. */
+export declare const REFERENCE_EXPECTED_SECONDS: Readonly<Record<ReferenceAnalysisMode, number>>;
+/** The query of `GET /v1/reference-analyses/{id}`. */
+export declare const referenceAnalysisQuery: z.ZodObject<{
+    frames_from: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    frames_to: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    wait_seconds: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    display: z.ZodOptional<z.ZodEnum<{
+        markdown: "markdown";
+    }>>;
+}, z.core.$strict>;
+export type ReferenceAnalysisQuery = z.infer<typeof referenceAnalysisQuery>;
 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";
@@ -99,19 +387,24 @@ export declare const referenceAnalysis: z.ZodObject<{
                     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";
@@ -193,6 +486,43 @@ export declare const referenceAnalysis: z.ZodObject<{
                 reacting: "reacting";
                 speaking: "speaking";
             }>;
+            key_frame_s: z.ZodOptional<z.ZodNumber>;
+            frames_s: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            speaker: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            speakers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                seconds: z.ZodNumber;
+            }, z.core.$strict>>>;
+            gaze: z.ZodOptional<z.ZodObject<{
+                direction: z.ZodEnum<{
+                    camera: "camera";
+                    closed: "closed";
+                    down: "down";
+                    mixed: "mixed";
+                    not_visible: "not_visible";
+                    off_left: "off_left";
+                    off_right: "off_right";
+                    up: "up";
+                }>;
+                frames_s: z.ZodArray<z.ZodNumber>;
+            }, z.core.$strict>>;
+            gestures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    both_hands_to_viewer: "both_hands_to_viewer";
+                    count_on_fingers: "count_on_fingers";
+                    hold_object: "hold_object";
+                    open_palms: "open_palms";
+                    other: "other";
+                    point_at_element: "point_at_element";
+                    point_at_viewer: "point_at_viewer";
+                    shrug: "shrug";
+                    thumbs_up: "thumbs_up";
+                    wave: "wave";
+                }>;
+                at_s: z.ZodNumber;
+                label: z.ZodString;
+                frames_s: z.ZodArray<z.ZodNumber>;
+            }, z.core.$strict>>>;
         }, z.core.$strict>>;
         captions: z.ZodObject<{
             present: z.ZodBoolean;
@@ -210,6 +540,12 @@ export declare const referenceAnalysis: z.ZodObject<{
                 punch: "punch";
             }>;
             hidden_under_graphics: z.ZodBoolean;
+            box: z.ZodOptional<z.ZodObject<{
+                left: z.ZodNumber;
+                top: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
         }, z.core.$strict>;
         pacing: z.ZodObject<{
             layer_change_every_s: z.ZodNumber;
@@ -222,12 +558,6 @@ export declare const referenceAnalysis: z.ZodObject<{
             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<{
@@ -381,19 +711,24 @@ export declare const referenceAnalysis: z.ZodObject<{
                 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";
@@ -419,13 +754,13 @@ export declare const referenceAnalysis: z.ZodObject<{
                     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";
+                    "estimated-still": "estimated-still";
+                    "estimated-video": "estimated-video";
+                    "frames-box/v1": "frames-box/v1";
+                    "frames-face/v1": "frames-face/v1";
+                    "frames-layer/v1": "frames-layer/v1";
+                    "frames-motion/v1": "frames-motion/v1";
+                    "frames-split/v1": "frames-split/v1";
                 }>>;
                 rects: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     t_s: z.ZodNumber;
@@ -470,13 +805,13 @@ export declare const referenceAnalysis: z.ZodObject<{
                     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";
+                        "estimated-still": "estimated-still";
+                        "estimated-video": "estimated-video";
+                        "frames-box/v1": "frames-box/v1";
+                        "frames-face/v1": "frames-face/v1";
+                        "frames-layer/v1": "frames-layer/v1";
+                        "frames-motion/v1": "frames-motion/v1";
+                        "frames-split/v1": "frames-split/v1";
                     }>>;
                 }, z.core.$strict>>;
                 exit: z.ZodOptional<z.ZodObject<{
@@ -512,13 +847,13 @@ export declare const referenceAnalysis: z.ZodObject<{
                     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";
+                        "estimated-still": "estimated-still";
+                        "estimated-video": "estimated-video";
+                        "frames-box/v1": "frames-box/v1";
+                        "frames-face/v1": "frames-face/v1";
+                        "frames-layer/v1": "frames-layer/v1";
+                        "frames-motion/v1": "frames-motion/v1";
+                        "frames-split/v1": "frames-split/v1";
                     }>>;
                 }, z.core.$strict>>;
                 layer: z.ZodOptional<z.ZodObject<{
@@ -530,13 +865,13 @@ export declare const referenceAnalysis: z.ZodObject<{
                         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";
+                        "estimated-still": "estimated-still";
+                        "estimated-video": "estimated-video";
+                        "frames-box/v1": "frames-box/v1";
+                        "frames-face/v1": "frames-face/v1";
+                        "frames-layer/v1": "frames-layer/v1";
+                        "frames-motion/v1": "frames-motion/v1";
+                        "frames-split/v1": "frames-split/v1";
                     }>;
                     covered_by: z.ZodArray<z.ZodEnum<{
                         body: "body";
@@ -633,7 +968,226 @@ export declare const referenceAnalysis: z.ZodObject<{
                 }>;
             }, 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>>>;
+        transcript_language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        hook: z.ZodOptional<z.ZodObject<{
+            text: z.ZodString;
+            end_s: z.ZodNumber;
+            caption: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        speakers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            on_screen: z.ZodBoolean;
+            role: z.ZodEnum<{
+                guest: "guest";
+                interviewer: "interviewer";
+                narrator: "narrator";
+                other: "other";
+                presenter: "presenter";
+            }>;
+            word_count: z.ZodNumber;
+            caption: z.ZodNullable<z.ZodObject<{
+                colour: z.ZodNullable<z.ZodString>;
+                style: z.ZodString;
+                position: z.ZodNullable<z.ZodEnum<{
+                    bottom: "bottom";
+                    lower: "lower";
+                    middle: "middle";
+                    top: "top";
+                }>>;
+                box: z.ZodOptional<z.ZodObject<{
+                    left: z.ZodNumber;
+                    top: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            frames_s: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strict>>>;
+        segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            start_s: z.ZodNumber;
+            end_s: z.ZodNumber;
+            text: z.ZodString;
+            speaker: z.ZodString;
+            mouth: z.ZodOptional<z.ZodObject<{
+                vision: z.ZodNullable<z.ZodEnum<{
+                    closed: "closed";
+                    moving: "moving";
+                    not_visible: "not_visible";
+                }>>;
+                measured: z.ZodEnum<{
+                    moving: "moving";
+                    not_measured: "not_measured";
+                    still: "still";
+                }>;
+                score: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strict>>;
+            frames_s: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strict>>>;
+        spellings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            heard: z.ZodString;
+            shown: z.ZodString;
+            start_s: z.ZodNumber;
+            end_s: z.ZodNumber;
+        }, z.core.$strict>>>;
+        analysis: z.ZodObject<{
+            warnings: z.ZodOptional<z.ZodArray<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>>;
+        transcript_language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        hook: z.ZodNullable<z.ZodObject<{
+            text: z.ZodString;
+            end_s: z.ZodNumber;
+            caption: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            start_s: z.ZodNumber;
+            end_s: z.ZodNumber;
+            text: z.ZodString;
+            speaker: z.ZodString;
+            mouth: z.ZodOptional<z.ZodObject<{
+                vision: z.ZodNullable<z.ZodEnum<{
+                    closed: "closed";
+                    moving: "moving";
+                    not_visible: "not_visible";
+                }>>;
+                measured: z.ZodEnum<{
+                    moving: "moving";
+                    not_measured: "not_measured";
+                    still: "still";
+                }>;
+                score: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strict>>;
+            frames_s: z.ZodArray<z.ZodNumber>;
+        }, 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>;
+            shares: z.ZodNullable<z.ZodNumber>;
+            views_per_hour: z.ZodNullable<z.ZodNumber>;
+            age_hours: z.ZodNullable<z.ZodNumber>;
+            comment_rate: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        author_followers: z.ZodNullable<z.ZodNumber>;
+        author: z.ZodNullable<z.ZodObject<{
+            handle: z.ZodString;
+            name: z.ZodNullable<z.ZodString>;
+            url: z.ZodString;
+        }, z.core.$strict>>;
+        caption: z.ZodNullable<z.ZodObject<{
+            text: z.ZodString;
+            truncated: z.ZodBoolean;
+        }, 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>>;
+        comments_read: z.ZodNullable<z.ZodNumber>;
+        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>>;
+        code_word_guess: z.ZodNullable<z.ZodString>;
+        funnel: z.ZodNullable<z.ZodObject<{
+            comment_keyword: z.ZodBoolean;
+            word: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
+    frames: z.ZodNullable<z.ZodObject<{
+        fps: z.ZodLiteral<1>;
+        count: z.ZodNumber;
+        end_s: z.ZodNullable<z.ZodNumber>;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        expires_at: z.ZodString;
+        page: z.ZodObject<{
+            from: z.ZodNumber;
+            to: z.ZodNumber;
+            next: z.ZodNullable<z.ZodObject<{
+                frames_from: z.ZodNumber;
+                frames_to: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        seconds: z.ZodArray<z.ZodObject<{
+            t_s: z.ZodNumber;
+            url: z.ZodString;
+        }, z.core.$strict>>;
+        sheets: z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            columns: z.ZodLiteral<4>;
+            rows: z.ZodLiteral<3>;
+            times_s: z.ZodArray<z.ZodNumber>;
+            url: z.ZodString;
+        }, z.core.$strict>>;
+        key_frames: z.ZodArray<z.ZodObject<{
+            t_s: z.ZodNumber;
+            url: z.ZodString;
+            kind: z.ZodEnum<{
+                beat: "beat";
+                hook: "hook";
+            }>;
+            beat_index: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>>;
+        scenes: z.ZodArray<z.ZodObject<{
+            start_s: z.ZodNumber;
+            end_s: z.ZodNumber;
+            key_frame_s: z.ZodNumber;
+            url: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    video: z.ZodNullable<z.ZodObject<{
+        url: z.ZodString;
+        expires_at: z.ZodString;
+    }, z.core.$strict>>;
+    retry_after_seconds: z.ZodNullable<z.ZodNumber>;
+    replaces_analysis_id: z.ZodNullable<z.ZodString>;
+    superseded_by_analysis_id: z.ZodNullable<z.ZodString>;
     warnings: z.ZodArray<z.ZodString>;
     error: z.ZodNullable<z.ZodObject<{
         code: z.ZodEnum<{
@@ -649,10 +1203,35 @@ export declare const referenceAnalysis: z.ZodObject<{
     balance_after_credits: z.ZodNullable<z.ZodNumber>;
     created_at: z.ZodString;
     finished_at: z.ZodNullable<z.ZodString>;
+    untrusted_content: z.ZodObject<{
+        note: z.ZodLiteral<string>;
+        fields: z.ZodArray<z.ZodEnum<{
+            "data.hook.text": "data.hook.text";
+            "data.segments[].text": "data.segments[].text";
+            "data.transcript[].text": "data.transcript[].text";
+            display_markdown: "display_markdown";
+            "reference_profile.beats[].graphics[].label_hint": "reference_profile.beats[].graphics[].label_hint";
+            "reference_profile.beats[].spoken_summary": "reference_profile.beats[].spoken_summary";
+            "reference_profile.hook.caption": "reference_profile.hook.caption";
+            "reference_profile.hook.text": "reference_profile.hook.text";
+            "reference_profile.segments[].text": "reference_profile.segments[].text";
+            "reference_profile.spellings[].heard": "reference_profile.spellings[].heard";
+            "reference_profile.spellings[].shown": "reference_profile.spellings[].shown";
+            "reference_profile.transcript[].text": "reference_profile.transcript[].text";
+            "source.author.name": "source.author.name";
+            "source.caption.text": "source.caption.text";
+            "source.code_word_guess": "source.code_word_guess";
+            "source.code_words[].word": "source.code_words[].word";
+            "source.funnel.word": "source.funnel.word";
+            "source.top_comments[].text": "source.top_comments[].text";
+        }>>;
+    }, z.core.$strict>;
+    display_markdown: z.ZodOptional<z.ZodString>;
+    display_hint: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type ReferenceAnalysis = z.infer<typeof referenceAnalysis>;
 export declare const analysisQuoteResponse: z.ZodObject<{
-    asset_id: z.ZodString;
+    asset_id: z.ZodNullable<z.ZodString>;
     credits_estimate: z.ZodNumber;
     replays_analysis_id: z.ZodNullable<z.ZodString>;
     warnings: z.ZodArray<z.ZodString>;
@@ -665,19 +1244,33 @@ export declare const referenceAnalysisRead: z.ZodObject<{
     warnings: z.ZodArray<z.ZodString>;
     created_at: z.ZodString;
     finished_at: z.ZodNullable<z.ZodString>;
+    display_markdown: z.ZodOptional<z.ZodString>;
+    display_hint: z.ZodOptional<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>>>;
+    frames: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    video: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    retry_after_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    replaces_analysis_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    superseded_by_analysis_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    untrusted_content: z.ZodOptional<z.ZodObject<{
+        note: z.ZodString;
+        fields: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
     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 function referenceAnalysisWarnings(profile: Pick<ReferenceProfileAnswer, "unmapped" | "analysis">): string[];
 export declare const ANALYZE_REFERENCE_DESCRIPTION: string;
 export declare const GET_REFERENCE_ANALYSIS_DESCRIPTION: string;
 export declare const QUOTE_ANALYSIS_DESCRIPTION: string;