@clipwright/core 0.35.0 → 0.36.0

package/dist/reference-analysis.d.ts

@@ -9,13 +9,23 @@ 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. */
+/** 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 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 +34,157 @@ 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>;
+/** 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";
@@ -99,19 +247,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";
@@ -381,19 +534,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";
@@ -633,6 +791,77 @@ 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>>>;
+        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<{
@@ -652,7 +881,7 @@ export declare const referenceAnalysis: z.ZodObject<{
 }, 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>;
@@ -671,6 +900,9 @@ export declare const referenceAnalysisRead: 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>>;

package/dist/reference-analysis.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { assetId } from "./asset-identity.js";
 import { ASSET_VIDEO_MAX_SECONDS } from "./assets.js";
-import { referenceProfile } from "./reference-profile.js";
+import { MAX_REFERENCE_TRANSCRIPT_WORDS, referenceHook, referenceProfile, referenceWord } 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 const REFERENCE_ANALYSES_PATH = "/v1/reference-analyses";
@@ -11,13 +11,24 @@ export 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 const ANALYZE_REFERENCE_SKILL = "analyze_reference";
 export const referenceAnalysisId = z.string().regex(/^ref_[a-f0-9]{32}$/);
-/** 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. */
+/** The price of a delivered analysis. */
 export const REFERENCE_ANALYSIS_CREDITS = 70;
+/** The data mode: metrics, transcript and a frame sheet without the vision pass. */
+export 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 const REFERENCE_ANALYSIS_MODES = ["full", "data"];
+export const REFERENCE_ANALYSIS_MODE_CREDITS = {
+    full: REFERENCE_ANALYSIS_CREDITS, data: REFERENCE_DATA_CREDITS,
+};
 /** New analyses per account per hour: each costs us vendor money even when it fails, so the cap stays beside the price. */
 export 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 const REFERENCE_DATA_PER_HOUR = 60;
+export const REFERENCE_DATA_SHEET_COLUMNS = 3;
+export const REFERENCE_DATA_SHEET_ROWS = 3;
+export const REFERENCE_DATA_SHEET_MAX_WIDTH = 1080;
 export 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 const REFERENCE_ANALYSIS_WORK_SECONDS = 420;
 export 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. */
@@ -28,19 +39,108 @@ export const REFERENCE_ANALYSIS_ERROR_MESSAGES = {
     timed_out: "the analysis did not finish in time and was stopped; start it again",
     analysis_failed: "the reference could not be analysed; start it again or use another clip",
     asset_gone: "the asset was deleted before the analysis began",
-    enqueue_failed: "the analysis could not be handed to the worker; start it again",
+    enqueue_failed: "the analysis could not be started; start it again",
 };
-/** 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 const analyzeReferencePayload = z.strictObject({ analysisId: referenceAnalysisId, accountId: z.string().min(1) });
+export const REFERENCE_SOURCE_PLATFORMS = ["instagram", "tiktok"];
+/** The live analysis a link replays is found by this key; a short TikTok link has none before it is resolved. */
+export const referenceSourceKey = z.string().regex(/^(instagram|tiktok):[A-Za-z0-9_-]{1,64}$/);
+export const REFERENCE_URL_YOUTUBE_REFUSAL = "YouTube gives no video file through our source; upload the MP4 with create_asset";
+export const REFERENCE_URL_ACCEPTED = "an Instagram reel or post link (instagram.com/reel/<code>, /reels/<code>, /p/<code>) or a TikTok " +
+    "video link (tiktok.com/@<user>/video/<id>, vm.tiktok.com/<code>)";
+const INSTAGRAM_HOSTS = new Set(["instagram.com", "www.instagram.com", "m.instagram.com"]);
+const TIKTOK_HOSTS = new Set(["tiktok.com", "www.tiktok.com", "m.tiktok.com"]);
+const YOUTUBE_HOSTS = new Set(["youtube.com", "www.youtube.com", "m.youtube.com", "music.youtube.com", "youtu.be", "www.youtu.be"]);
+/** Which post a link names, read from its text alone: no network, so a refusal costs nothing (#930 S3). */
+export function classifyReferenceUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        return { ok: false, message: `source_url is not a link; pass ${REFERENCE_URL_ACCEPTED}` };
+    }
+    const host = url.hostname.toLowerCase();
+    if (YOUTUBE_HOSTS.has(host))
+        return { ok: false, message: REFERENCE_URL_YOUTUBE_REFUSAL };
+    if (url.protocol === "https:" && url.username === "" && url.password === "" && (url.port === "" || url.port === "443")) {
+        const path = url.pathname;
+        const instagram = INSTAGRAM_HOSTS.has(host) ? /^\/(?:reel|reels|p)\/([A-Za-z0-9_-]{5,64})\/?$/.exec(path) : null;
+        if (instagram)
+            return { ok: true, url: url.href, platform: "instagram", key: `instagram:${instagram[1]}` };
+        const tiktok = TIKTOK_HOSTS.has(host) ? /^\/@[A-Za-z0-9_.-]{1,64}\/video\/(\d{5,32})\/?$/.exec(path) : null;
+        if (tiktok)
+            return { ok: true, url: url.href, platform: "tiktok", key: `tiktok:${tiktok[1]}` };
+        if (host === "vm.tiktok.com" && /^\/[A-Za-z0-9]{4,32}\/?$/.test(path))
+            return { ok: true, url: url.href, platform: "tiktok", key: null };
+    }
+    return { ok: false, message: `${host} ${url.pathname} is not a link we read; pass ${REFERENCE_URL_ACCEPTED}` };
+}
 export const analyzeReferenceRequest = z.strictObject({
-    asset_id: assetId.describe(`asset_id of an MP4 asset of this account, at most ${ASSET_VIDEO_MAX_SECONDS} s and 100 MiB`),
+    asset_id: assetId.optional().describe(`asset_id of an MP4 asset of this account, at most ${ASSET_VIDEO_MAX_SECONDS} s and 100 MiB`),
+    source_url: z.string().url().startsWith("https://").max(2048).optional()
+        .describe(`instead of asset_id: ${REFERENCE_URL_ACCEPTED}; YouTube is refused`),
+    mode: z.enum(REFERENCE_ANALYSIS_MODES).optional().describe(`full (default, ${REFERENCE_ANALYSIS_CREDITS} credits): the reference_profile. ` +
+        `data (${REFERENCE_DATA_CREDITS} credits): duration, size, timed transcript, hook and a 3×3 frame sheet, without the vision pass`),
+}).refine((request) => (request.asset_id === undefined) !== (request.source_url === undefined), {
+    message: "pass exactly one of asset_id or source_url",
+});
+const count = z.number().int().nonnegative().nullable();
+const authorMedian = z.strictObject({ views: z.number().nonnegative().nullable(), ratio: z.number().nonnegative().nullable(),
+    reels: z.number().int().nonnegative(), window: z.string().min(1) }).nullable();
+/** The post behind a link analysis (#930 S3): `null` is unknown, never 0, and each unknown is also a line in `warnings[]`. */
+export const referenceSource = z.strictObject({
+    url: z.string().url(),
+    platform: z.enum(REFERENCE_SOURCE_PLATFORMS),
+    key: referenceSourceKey,
+    measured_at: z.string().datetime(),
+    published_at: z.string().datetime().nullable(),
+    duration_s: z.number().positive().nullable(),
+    metrics: z.strictObject({ views: count, likes: count, comments: count, views_per_hour: z.number().nonnegative().nullable() }),
+    /** The median of the author's reels within ±30 days of the post, the post excluded. */
+    author_median: authorMedian,
+    /** The median of the author's 12 latest reels, the post excluded. */
+    author_recent: authorMedian,
+    top_comments: z.array(z.strictObject({ text: z.string().min(1).max(300), likes: count })).max(10),
+    code_words: z.array(z.strictObject({ word: z.string().min(1).max(24), count: z.number().int().min(2) })),
 });
+const frameSheet = z.strictObject({
+    columns: z.number().int().positive(),
+    rows: z.number().int().positive(),
+    /** Each frame's second, row by row; every one inside the reel. */
+    times_s: z.array(z.number().nonnegative()).min(1),
+});
+const dataWords = { transcript: z.array(referenceWord).max(MAX_REFERENCE_TRANSCRIPT_WORDS),
+    /** `null` when no word starts in the first seconds; no caption, since no vision pass read the screen. */
+    hook: referenceHook.nullable() };
+const dataProbe = { duration_s: z.number().positive(), width: z.number().int().positive(), height: z.number().int().positive(),
+    fps: z.number().positive() };
+/** What a succeeded data analysis hands back (#930 S4): the probe, the transcribed words as the profile writes them, and a frame sheet. */
+export const referenceData = z.strictObject({
+    ...dataProbe,
+    ...dataWords,
+    /** `url` is signed for 7 days on each read; `null` once the sheet passed the renders' 30 days in storage, said in `warnings[]`. */
+    frame_sheet: frameSheet.extend({ url: z.string().url().nullable() }),
+});
+/** What the data pass answers: the words, the sheet it uploaded and its warnings. */
+export const referenceDataPass = z.strictObject({ ...dataWords, frame_sheet: frameSheet, cost_usd: z.number().nonnegative(),
+    warnings: z.array(z.string()) });
+/** 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 const referenceDataStored = z.strictObject({ ...dataProbe, ...dataWords, frame_sheet: frameSheet.extend({ key: z.string().min(1) }),
+    cost_usd: z.number().nonnegative() });
 export const referenceAnalysis = z.strictObject({
     analysis_id: referenceAnalysisId,
     asset_id: assetId,
+    /** `full` or `data` (#930 S4); an analysis started before the modes is `full`. */
+    mode: z.enum(REFERENCE_ANALYSIS_MODES),
     state: z.enum(REFERENCE_ANALYSIS_STATES),
-    /** Set once the analysis succeeded, `null` before and on failure. */
+    /** Set once a full analysis succeeded, `null` before, on failure and for a data analysis. */
     reference_profile: referenceProfile.nullable(),
+    /** Set once a data analysis succeeded, `null` before, on failure and for a full analysis. */
+    data: referenceData.nullable(),
+    /** The post's numbers, comments and code words for an analysis started by `source_url`; `null` for an asset start. */
+    source: referenceSource.nullable(),
     warnings: z.array(z.string()),
     error: z.strictObject({ code: z.enum(REFERENCE_ANALYSIS_ERRORS), message: z.string().min(1) }).nullable(),
     /** Held at the start; 0 for an analysis started before it was paid (#927). */
@@ -53,7 +153,8 @@ export const referenceAnalysis = z.strictObject({
     finished_at: z.string().datetime().nullable(),
 });
 export const analysisQuoteResponse = z.strictObject({
-    asset_id: assetId,
+    /** The quoted asset; for a `source_url`, the asset of the analysis it replays, else `null` (its asset is made at the start). */
+    asset_id: assetId.nullable(),
     /** What starting it now holds and, once it succeeds, charges: 0 when the asset already has a live analysis to answer. */
     credits_estimate: z.number().int().nonnegative(),
     /** The analysis a start would answer for free, or `null` when a start would begin a new, paid one. */
@@ -65,6 +166,11 @@ export const referenceAnalysisRead = referenceAnalysis.extend({
     state: z.string(),
     reference_profile: z.record(z.string(), z.unknown()).nullable(),
     error: z.object({ code: z.string(), message: z.string() }).nullable(),
+    // A server from before #930 S3 sends no source; a later one may add metrics this client does not know.
+    source: z.record(z.string(), z.unknown()).nullable().optional(),
+    // A server from before #930 S4 sends neither mode nor data.
+    mode: z.string().optional(),
+    data: z.record(z.string(), z.unknown()).nullable().optional(),
     // A server from before #927 sends no money fields.
     credits_reserved: referenceAnalysis.shape.credits_reserved.optional(),
     credits_charged: referenceAnalysis.shape.credits_charged.optional(),
@@ -76,16 +182,29 @@ export function referenceAnalysisWarnings(profile) {
 }
 export const ANALYZE_REFERENCE_DESCRIPTION = "Read a reference ad into a reference_profile: its beats (role, timing as shares of the clip, whether the presenter " +
     "speaks, listens or is off screen), the graphics in our template vocabulary, captions, pacing, palette and music. " +
+    "It keeps the reference's words: transcript (timed words), hook (the words of its first 3 s, through the end of that sentence), each beat's spoken_summary " +
+    "and each graphic's label_hint. " +
     "What we cannot draw is in unmapped with a substitute and in warnings. Pass asset_id of an MP4 asset (create_asset " +
-    `with kind: "video"), at most ${ASSET_VIDEO_MAX_SECONDS} s and 100 MiB; there is no url input. ` +
-    `${REFERENCE_ANALYSIS_CREDITS} credits are held at the start and charged once it succeeds; a failed analysis costs ` +
-    `nothing. ${REFERENCE_ANALYSIS_PER_HOUR} new analyses per hour per account. Answers at once with state queued; call ` +
-    "get_reference_analysis every 10 seconds until succeeded (about a minute) or failed. The same asset returns the " +
-    "same analysis, free, unless it failed. The asset is not changed. The profile names techniques; it copies no face, voice, " +
-    "music or brand of the reference.";
-export const GET_REFERENCE_ANALYSIS_DESCRIPTION = "Read an analysis started by analyze_reference: state queued or analyzing, succeeded with reference_profile and " +
-    "warnings, or failed with error.code and error.message (timed_out, analysis_failed, asset_gone, enqueue_failed); " +
+    `with kind: "video"), at most ${ASSET_VIDEO_MAX_SECONDS} s and 100 MiB, or source_url: ${REFERENCE_URL_ACCEPTED}. ` +
+    "A link becomes an analysis-only asset of this account (asset_id in the answer) and the answer's source carries the " +
+    "post's views, likes, comments, views per hour, the author's median views around it and over their 12 latest reels, each with the ratio, the top comments " +
+    "and the code words commenters repeat; a number the platform did not give is null and named in warnings. A YouTube " +
+    "link is refused: upload its MP4 with create_asset. " +
+    `mode: "data" skips the vision pass and answers data instead of a profile: duration, size and fps, the timed ` +
+    "transcript, the hook and a 3×3 frame sheet (a signed JPEG link), with source for a link as above; a reel with no " +
+    `speech gives an empty transcript and a warning. ${REFERENCE_ANALYSIS_CREDITS} credits for full, ${REFERENCE_DATA_CREDITS} ` +
+    "for data, held at the start and charged once it succeeds; a failed analysis costs nothing. " +
+    `${REFERENCE_ANALYSIS_PER_HOUR} new full and ${REFERENCE_DATA_PER_HOUR} new data analyses per hour per account. ` +
+    "Answers at once with state queued; call get_reference_analysis every 10 seconds until succeeded (about a minute) or " +
+    "failed. The same asset, or the same reel by its full link, in the same mode returns the same analysis, free, unless it " +
+    "failed; a short vm.tiktok.com link always starts a new one. The asset is not changed. The profile names techniques; it " +
+    "copies no face, voice, music or brand of the reference.";
+export const GET_REFERENCE_ANALYSIS_DESCRIPTION = "Read an analysis started by analyze_reference: state queued or analyzing, succeeded with reference_profile (mode full) " +
+    "or data (mode data) and warnings, or failed with error.code and error.message (timed_out, analysis_failed, asset_gone, " +
+    "enqueue_failed); source holds the post's metrics for an analysis started by source_url. " +
     "credits_charged is the price once succeeded, 0 once failed. Free.";
-export const QUOTE_ANALYSIS_DESCRIPTION = "Price analyze_reference for an asset before starting it: credits_estimate is what a start holds and charges once it " +
-    "succeeds, 0 when the asset already has an analysis that a start would answer (replays_analysis_id). Free; starts nothing.";
+export const QUOTE_ANALYSIS_DESCRIPTION = "Price analyze_reference for an asset_id or a source_url and a mode before starting it: credits_estimate is what a start " +
+    `holds and charges once it succeeds (${REFERENCE_ANALYSIS_CREDITS} full, ${REFERENCE_DATA_CREDITS} data), 0 when the ` +
+    "asset or the reel already has an analysis in that mode that a start would answer (replays_analysis_id). A YouTube or " +
+    "unknown link is refused here too. Free; starts nothing.";
 //# sourceMappingURL=reference-analysis.js.map

package/dist/reference-analysis.js.map

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

package/dist/reference-kinds.d.ts

@@ -1,6 +1,8 @@
 /** Our template kinds, media laid over or instead of the presenter, a split layout, and what we cannot draw yet. */
 export declare const REFERENCE_GRAPHIC_KINDS: readonly ["tag", "lower_third", "end_card", "title_card", "quote", "stat", "callout", "checklist", "phone_call", "compare", "notification", "progress", "rating", "overlay_media", "insert_media", "layout_split", "particles", "unmapped"];
 export type ReferenceGraphicKind = (typeof REFERENCE_GRAPHIC_KINDS)[number];
+/** Kinds an analysis also reads from an element's description when the model said other: what the Ana reel's answer called other (#930). */
+export declare const REFERENCE_DESCRIBED_KINDS: readonly ["banner", "logo_card", "comment_box", "price_card", "concept_card"];
 /** The analyser's names for a graphic: its prompt's own list, plus ours. */
-export declare const REFERENCE_SOURCE_KINDS: readonly ["toggle_checklist", "phone_call", "notification", "before_after_split", "split_screen", "stat", "product_ui", "screenshot", "title_card", "end_card", "particles", "tag", "lower_third", "end_card", "title_card", "quote", "stat", "callout", "checklist", "phone_call", "compare", "notification", "progress", "rating", "overlay_media", "insert_media", "layout_split", "particles", "unmapped", "other"];
+export declare const REFERENCE_SOURCE_KINDS: readonly ["toggle_checklist", "phone_call", "notification", "before_after_split", "split_screen", "stat", "product_ui", "screenshot", "title_card", "end_card", "particles", "banner", "logo_card", "comment_box", "price_card", "concept_card", "tag", "lower_third", "end_card", "title_card", "quote", "stat", "callout", "checklist", "phone_call", "compare", "notification", "progress", "rating", "overlay_media", "insert_media", "layout_split", "particles", "unmapped", "other"];
 export type ReferenceSourceKind = (typeof REFERENCE_SOURCE_KINDS)[number];

package/dist/reference-kinds.js

@@ -2,7 +2,9 @@ import { TEMPLATE_KIND_IDS } from "./templates/index.js";
 // A reference graphic's kinds, shared by the profile's beats and its staging (#914): their own module, so neither imports the other.
 /** Our template kinds, media laid over or instead of the presenter, a split layout, and what we cannot draw yet. */
 export const REFERENCE_GRAPHIC_KINDS = [...TEMPLATE_KIND_IDS, "overlay_media", "insert_media", "layout_split", "particles", "unmapped"];
+/** Kinds an analysis also reads from an element's description when the model said other: what the Ana reel's answer called other (#930). */
+export const REFERENCE_DESCRIBED_KINDS = ["banner", "logo_card", "comment_box", "price_card", "concept_card"];
 /** The analyser's names for a graphic: its prompt's own list, plus ours. */
 export const REFERENCE_SOURCE_KINDS = ["toggle_checklist", "phone_call", "notification", "before_after_split", "split_screen", "stat", "product_ui",
-    "screenshot", "title_card", "end_card", "particles", ...REFERENCE_GRAPHIC_KINDS, "other"];
+    "screenshot", "title_card", "end_card", "particles", ...REFERENCE_DESCRIBED_KINDS, ...REFERENCE_GRAPHIC_KINDS, "other"];
 //# sourceMappingURL=reference-kinds.js.map

package/dist/reference-kinds.js.map

@@ -1 +1 @@
-{"version":3,"file":"reference-kinds.js","sourceRoot":"","sources":["../src/reference-kinds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,qIAAqI;AAErI,oHAAoH;AACpH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;AAEjJ,4EAA4E;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY;IACjJ,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,uBAAuB,EAAE,OAAO,CAAU,CAAC"}
+{"version":3,"file":"reference-kinds.js","sourceRoot":"","sources":["../src/reference-kinds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,qIAAqI;AAErI,oHAAoH;AACpH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;AAEjJ,4IAA4I;AAC5I,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,CAAU,CAAC;AACvH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY;IACjJ,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,yBAAyB,EAAE,GAAG,uBAAuB,EAAE,OAAO,CAAU,CAAC"}