@clipwright/core 0.36.0 → 0.37.1

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,15 +9,18 @@ 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;
+/** 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;
-/** The data mode: metrics, transcript and a frame sheet without the vision pass. */
+/** 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: each costs us vendor money even when it fails, so the cap stays beside the price. */
+/** 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;
@@ -66,6 +69,8 @@ export declare const analyzeReferenceRequest: z.ZodObject<{
     }>>;
 }, 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;
@@ -81,8 +86,21 @@ export declare const referenceSource: 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>;
@@ -95,6 +113,7 @@ export declare const referenceSource: z.ZodObject<{
         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>;
@@ -103,6 +122,11 @@ export declare const referenceSource: 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. */
@@ -113,11 +137,32 @@ export declare const referenceData: z.ZodObject<{
         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;
@@ -130,54 +175,149 @@ export declare const referenceData: z.ZodObject<{
     }, 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<{
+/** 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>;
-    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;
+    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;
-        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>;
+        key_frame_s: z.ZodNumber;
     }, z.core.$strict>>;
-    duration_s: z.ZodNumber;
+    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;
-    fps: z.ZodNumber;
-    frame_sheet: z.ZodObject<{
-        columns: z.ZodNumber;
-        rows: z.ZodNumber;
-        times_s: z.ZodArray<z.ZodNumber>;
-        key: z.ZodString;
+    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>;
-    cost_usd: z.ZodNumber;
+    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 ReferenceDataStored = z.infer<typeof referenceDataStored>;
+export type ReferenceAnalysisQuery = z.infer<typeof referenceAnalysisQuery>;
 export declare const referenceAnalysis: z.ZodObject<{
     analysis_id: z.ZodString;
     asset_id: z.ZodString;
@@ -346,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;
@@ -363,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;
@@ -375,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<{
@@ -577,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;
@@ -628,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<{
@@ -670,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<{
@@ -688,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";
@@ -797,11 +974,70 @@ export declare const referenceAnalysis: z.ZodObject<{
             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<{
@@ -810,11 +1046,32 @@ export declare const referenceAnalysis: z.ZodObject<{
             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;
@@ -840,8 +1097,21 @@ export declare const referenceAnalysis: 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>;
@@ -854,6 +1124,7 @@ export declare const referenceAnalysis: z.ZodObject<{
             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>;
@@ -862,7 +1133,61 @@ export declare const referenceAnalysis: 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<{
@@ -878,6 +1203,31 @@ 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<{
@@ -894,6 +1244,8 @@ 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<{
@@ -903,13 +1255,22 @@ export declare const referenceAnalysisRead: z.ZodObject<{
     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;