@clipwright/core 0.17.0 → 0.19.0

package/dist/semantic-inserts.js

@@ -0,0 +1,160 @@
+/** Первое НЕЗАКРЫТОЕ вставкой слово. Умолчание читается здесь и только здесь, */
+/** иначе «покрытие равно якорю» разъедется между читателями (#265). */
+export function coverWordOf(anchor) {
+    return anchor.coverWord ?? anchor.endWord;
+}
+function tokenize(text) {
+    const normalized = text.normalize("NFD").toLowerCase()
+        .replace(/([аеиоуыэюя]\u0308?)\u0301/gu, "$1").normalize("NFC")
+        .replace(/[’ʼ]/gu, "'");
+    return normalized.match(/[\p{L}\p{N}][\p{L}\p{N}\p{M}]*(?:['-][\p{L}\p{N}][\p{L}\p{N}\p{M}]*|[.,](?<=\p{N}[.,])\p{N}+)*/gu) ?? [];
+}
+function orderedAnchors(plan) {
+    if (plan.sourceTokens.length === 0 || plan.sourceTokens.some(token => typeof token !== "string" || tokenize(token).length !== 1 || tokenize(token)[0] !== token)) {
+        throw new Error("Semantic plan requires normalized source tokens");
+    }
+    const ids = new Set();
+    for (const anchor of plan.inserts) {
+        if (typeof anchor.insertId !== "string" || !anchor.insertId.trim() ||
+            typeof anchor.mediaId !== "string" || !anchor.mediaId.trim() || ids.has(anchor.insertId)) {
+            throw new Error("Semantic inserts require unique nonempty insert IDs and media IDs");
+        }
+        ids.add(anchor.insertId);
+        if (!Number.isSafeInteger(anchor.startWord) || !Number.isSafeInteger(anchor.endWord) ||
+            anchor.startWord < 0 || anchor.endWord <= anchor.startWord || anchor.endWord > plan.sourceTokens.length) {
+            throw new Error("Semantic insert word range is invalid");
+        }
+        if (anchor.coverWord !== undefined && (!Number.isSafeInteger(anchor.coverWord) ||
+            anchor.coverWord < anchor.endWord || anchor.coverWord > plan.sourceTokens.length)) {
+            throw new Error("Semantic insert coverage word is invalid");
+        }
+    }
+    const ordered = plan.inserts.map(anchor => ({ ...anchor })).sort((a, b) => a.startWord - b.startWord);
+    for (let i = 1; i < ordered.length; i++) {
+        if (ordered[i].startWord < coverWordOf(ordered[i - 1]))
+            throw new Error("Semantic insert word ranges overlap");
+    }
+    return ordered;
+}
+export function planSemanticInserts(script, instructions) {
+    for (const chunk of script.match(/\S+/gu) ?? []) {
+        const tokens = tokenize(chunk);
+        if (tokens.length > 1 || (tokens.length === 0 && !/^\p{P}+$/u.test(chunk))) {
+            throw new Error("Unsupported script tokenization: each whitespace chunk must contain at most one lexical word");
+        }
+    }
+    const sourceTokens = tokenize(script);
+    function quoteRange(anchor) {
+        const quoteTokens = tokenize(anchor.quote);
+        if (quoteTokens.length === 0)
+            throw new Error("Semantic insert quote is empty");
+        const matches = [];
+        for (let i = 0; i <= sourceTokens.length - quoteTokens.length; i++) {
+            if (quoteTokens.every((token, offset) => token === sourceTokens[i + offset]))
+                matches.push(i);
+        }
+        if (anchor.occurrence === undefined && matches.length > 1)
+            throw new Error("Semantic insert quote is ambiguous");
+        const occurrence = anchor.occurrence ?? 0;
+        if (!Number.isSafeInteger(occurrence) || occurrence < 0 || occurrence >= matches.length) {
+            throw new Error("Semantic insert quote occurrence does not match source text");
+        }
+        const startWord = matches[occurrence];
+        return { startWord, endWord: startWord + quoteTokens.length };
+    }
+    const inserts = instructions.map(({ insertId, mediaId, anchor, coverWords }) => {
+        const range = "startWord" in anchor
+            ? { startWord: anchor.startWord, endWord: anchor.endWord }
+            : quoteRange(anchor);
+        if (coverWords === undefined)
+            return { insertId, mediaId, ...range };
+        const anchored = range.endWord - range.startWord;
+        if (!Number.isSafeInteger(coverWords) || coverWords < anchored) {
+            throw new Error(`Semantic insert covers ${coverWords} words, fewer than the ${anchored} words it anchors`);
+        }
+        const coverWord = range.startWord + coverWords;
+        return { insertId, mediaId, ...range, ...(coverWord === range.endWord ? {} : { coverWord }) };
+    });
+    const plan = { sourceTokens, inserts };
+    return { sourceTokens, inserts: orderedAnchors(plan) };
+}
+/** Число ПЛАТНЫХ актёрских шотов — чистая функция индексов слов, поэтому вход */
+/** отвергается до синтеза речи, а не в воркере после оплаты (#265). */
+export function countActorShots(plan) {
+    const anchors = orderedAnchors(plan);
+    if (anchors.length === 0)
+        return 1;
+    let shots = anchors[0].startWord > 0 ? 1 : 0;
+    for (let i = 1; i < anchors.length; i++) {
+        if (coverWordOf(anchors[i - 1]) < anchors[i].startWord)
+            shots++;
+    }
+    return shots + (coverWordOf(anchors[anchors.length - 1]) < plan.sourceTokens.length ? 1 : 0);
+}
+export function resolveSemanticInserts(input) {
+    const { plan, words, durationSec, fps } = input;
+    const anchors = orderedAnchors(plan);
+    if (!Number.isFinite(durationSec) || durationSec <= 0 || !Number.isSafeInteger(fps) || fps <= 0) {
+        throw new Error("Semantic resolution requires a measured duration and positive integer fps");
+    }
+    const totalFrames = Math.round(durationSec * fps);
+    if (!Number.isSafeInteger(totalFrames) || totalFrames <= 0)
+        throw new Error("Measured duration has no representable frames");
+    const lexicalWords = [];
+    let previousEnd = 0;
+    for (let i = 0; i < words.length; i++) {
+        const word = words[i];
+        const tokens = tokenize(word.word);
+        const punctuationOnly = /^\p{P}+$/u.test(word.word);
+        if (!Number.isFinite(word.startSec) || !Number.isFinite(word.endSec) || word.startSec < previousEnd ||
+            word.endSec < word.startSec || (!punctuationOnly && word.endSec === word.startSec) || word.endSec > durationSec) {
+            throw new Error("Alignment timings are invalid, overlap, or exceed measured duration");
+        }
+        previousEnd = word.endSec;
+        if (punctuationOnly)
+            continue;
+        if (tokens.length !== 1 || tokens[0] !== plan.sourceTokens[lexicalWords.length]) {
+            throw new Error("Alignment text does not match source tokens");
+        }
+        lexicalWords.push(word);
+    }
+    if (lexicalWords.length !== plan.sourceTokens.length)
+        throw new Error("Alignment does not cover the source tokens exactly");
+    const shots = [];
+    let cursor = 0;
+    let rounded = Math.abs(totalFrames - durationSec * fps) > 1e-8;
+    for (const anchor of anchors) {
+        // Пауза принадлежит владельцу предыдущего слова: окно кончается на НАЧАЛЕ
+        // первого незакрытого слова, иначе щель станет платным огрызком (#265).
+        const cover = coverWordOf(anchor);
+        const head = anchor.startWord === 0;
+        const tail = cover >= lexicalWords.length;
+        const start = lexicalWords[anchor.startWord].startSec * fps;
+        const end = tail ? totalFrames : lexicalWords[cover].startSec * fps;
+        const fromFrame = head ? 0 : Math.round(start);
+        const endFrame = tail ? totalFrames : Math.round(end);
+        if (fromFrame < cursor || endFrame <= fromFrame || endFrame > totalFrames) {
+            throw new Error("Semantic insert frame range collides or has no positive duration");
+        }
+        if (!head)
+            rounded ||= Math.abs(fromFrame - start) > 1e-8;
+        if (!tail)
+            rounded ||= Math.abs(endFrame - end) > 1e-8;
+        if (fromFrame > cursor)
+            shots.push({ kind: "actor", fromFrame: cursor, durationInFrames: fromFrame - cursor });
+        shots.push({ kind: "media", fromFrame, durationInFrames: endFrame - fromFrame, insertId: anchor.insertId, mediaId: anchor.mediaId });
+        cursor = endFrame;
+    }
+    if (cursor < totalFrames)
+        shots.push({ kind: "actor", fromFrame: cursor, durationInFrames: totalFrames - cursor });
+    const warnings = [];
+    if (rounded)
+        warnings.push("Semantic insert boundaries or measured duration were rounded to the nearest frame.");
+    if (lexicalWords.length !== words.length)
+        warnings.push("Punctuation-only alignment entries were excluded from semantic word anchors.");
+    return { totalFrames, shots, warnings };
+}
+export function selectTimelineInput(segments, planner) {
+    return segments !== undefined ? { kind: "explicit", segments } : { kind: "semantic", plan: planner() };
+}
+//# sourceMappingURL=semantic-inserts.js.map

package/dist/semantic-inserts.js.map

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

package/dist/skills.d.ts

@@ -82,11 +82,51 @@ export declare const ugcSegment: z.ZodObject<{
     }>;
     script: z.ZodOptional<z.ZodString>;
     media_url: z.ZodOptional<z.ZodString>;
+    media_type: z.ZodOptional<z.ZodEnum<{
+        image: "image";
+        video: "video";
+    }>>;
+    duration_seconds: z.ZodOptional<z.ZodNumber>;
+    image_motion: z.ZodOptional<z.ZodObject<{
+        direction: z.ZodEnum<{
+            in: "in";
+            out: "out";
+        }>;
+        amount: z.ZodNumber;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type UgcSegment = z.infer<typeof ugcSegment>;
+export declare const ugcInsert: z.ZodObject<{
+    id: z.ZodString;
+    media_url: z.ZodString;
+    media_type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+    }>;
+    anchor: z.ZodUnion<readonly [z.ZodObject<{
+        startWord: z.ZodNumber;
+        endWord: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        quote: z.ZodString;
+        occurrence: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>;
+    cover_words: z.ZodOptional<z.ZodNumber>;
+    image_motion: z.ZodOptional<z.ZodObject<{
+        direction: z.ZodEnum<{
+            in: "in";
+            out: "out";
+        }>;
+        amount: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type UgcInsert = z.infer<typeof ugcInsert>;
 /** Потолок актёрских сегментов — ограничение ОДНОГО рана, не суточных трат. */
 export declare const MAX_ACTOR_SEGMENTS = 3;
 export declare const MAX_SEGMENTS = 5;
+/** Потолки НАРРАТИВНОГО пути — другие, потому что медиа-шот денег не стоит, */
+/** а актёрский стоит: вставок столько, сколько вмещает таймлайн (ADR #265). */
+export declare const MAX_INSERTS: number;
+export declare const MAX_NARRATED_ACTOR_SHOTS = 6;
 export declare const actorId: z.ZodString;
 export declare const makeUgcInputShape: {
     readonly script: z.ZodOptional<z.ZodString>;
@@ -97,7 +137,42 @@ export declare const makeUgcInputShape: {
         }>;
         script: z.ZodOptional<z.ZodString>;
         media_url: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodOptional<z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>>;
+        duration_seconds: z.ZodOptional<z.ZodNumber>;
+        image_motion: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    readonly inserts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        media_url: z.ZodString;
+        media_type: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        image_motion: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     readonly person: z.ZodOptional<z.ZodString>;
     readonly actor_id: z.ZodOptional<z.ZodString>;
     readonly image: z.ZodOptional<z.ZodString>;
@@ -108,6 +183,11 @@ export declare const makeUgcInputShape: {
     readonly character: z.ZodOptional<z.ZodString>;
     readonly name: z.ZodOptional<z.ZodString>;
     readonly broll_url: z.ZodOptional<z.ZodString>;
+    readonly broll_policy: z.ZodOptional<z.ZodEnum<{
+        anyone: "anyone";
+        no_actor: "no_actor";
+        no_people: "no_people";
+    }>>;
     readonly captions: z.ZodDefault<z.ZodBoolean>;
     readonly caption_style: z.ZodDefault<z.ZodEnum<{
         hormozi: "hormozi";
@@ -182,7 +262,42 @@ export declare const makeUgcInput: z.ZodObject<{
         }>;
         script: z.ZodOptional<z.ZodString>;
         media_url: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodOptional<z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>>;
+        duration_seconds: z.ZodOptional<z.ZodNumber>;
+        image_motion: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    inserts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        media_url: z.ZodString;
+        media_type: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        image_motion: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     person: z.ZodOptional<z.ZodString>;
     actor_id: z.ZodOptional<z.ZodString>;
     image: z.ZodOptional<z.ZodString>;
@@ -193,6 +308,11 @@ export declare const makeUgcInput: z.ZodObject<{
     character: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
     broll_url: z.ZodOptional<z.ZodString>;
+    broll_policy: z.ZodOptional<z.ZodEnum<{
+        anyone: "anyone";
+        no_actor: "no_actor";
+        no_people: "no_people";
+    }>>;
     captions: z.ZodDefault<z.ZodBoolean>;
     caption_style: z.ZodDefault<z.ZodEnum<{
         hormozi: "hormozi";
@@ -240,7 +360,42 @@ export declare function serverUgcInputWith(voiceRefusal: (voice: string) => stri
         }>;
         script: z.ZodOptional<z.ZodString>;
         media_url: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodOptional<z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>>;
+        duration_seconds: z.ZodOptional<z.ZodNumber>;
+        image_motion: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    inserts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        media_url: z.ZodString;
+        media_type: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        image_motion: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     person: z.ZodOptional<z.ZodString>;
     actor_id: z.ZodOptional<z.ZodString>;
     image: z.ZodOptional<z.ZodString>;
@@ -251,6 +406,11 @@ export declare function serverUgcInputWith(voiceRefusal: (voice: string) => stri
     character: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
     broll_url: z.ZodOptional<z.ZodString>;
+    broll_policy: z.ZodOptional<z.ZodEnum<{
+        anyone: "anyone";
+        no_actor: "no_actor";
+        no_people: "no_people";
+    }>>;
     captions: z.ZodDefault<z.ZodBoolean>;
     caption_style: z.ZodDefault<z.ZodEnum<{
         hormozi: "hormozi";
@@ -298,7 +458,42 @@ export declare const storedUgcInput: z.ZodObject<{
         }>;
         script: z.ZodOptional<z.ZodString>;
         media_url: z.ZodOptional<z.ZodString>;
+        media_type: z.ZodOptional<z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>>;
+        duration_seconds: z.ZodOptional<z.ZodNumber>;
+        image_motion: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    inserts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        media_url: z.ZodString;
+        media_type: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        anchor: z.ZodUnion<readonly [z.ZodObject<{
+            startWord: z.ZodNumber;
+            endWord: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            quote: z.ZodString;
+            occurrence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+        cover_words: z.ZodOptional<z.ZodNumber>;
+        image_motion: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                in: "in";
+                out: "out";
+            }>;
+            amount: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     person: z.ZodOptional<z.ZodString>;
     actor_id: z.ZodOptional<z.ZodString>;
     image: z.ZodOptional<z.ZodString>;
@@ -309,6 +504,11 @@ export declare const storedUgcInput: z.ZodObject<{
     character: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
     broll_url: z.ZodOptional<z.ZodString>;
+    broll_policy: z.ZodOptional<z.ZodEnum<{
+        anyone: "anyone";
+        no_actor: "no_actor";
+        no_people: "no_people";
+    }>>;
     captions: z.ZodDefault<z.ZodBoolean>;
     caption_style: z.ZodDefault<z.ZodEnum<{
         hormozi: "hormozi";
@@ -367,6 +567,16 @@ export interface SpokenTextInput {
 export declare function resolvedScript(input: SpokenTextInput): string;
 export type MakeUgcInput = z.infer<typeof makeUgcInput>;
 export declare const quoteResponse: z.ZodObject<{
+    long_form_pricing: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        pricingVersion: z.ZodString;
+        rateCreditsPerFaceSecond: z.ZodNumber;
+        minimumCredits: z.ZodNumber;
+        estimatedTotalDurationSec: z.ZodNumber;
+        estimatedFaceSeconds: z.ZodNumber;
+        estimatedCredits: z.ZodNumber;
+        estimatedFaceWordShare: z.ZodOptional<z.ZodNumber>;
+        minimumApplied: z.ZodBoolean;
+    }, z.core.$strict>>>;
     skill: z.ZodString;
     credits_estimate: z.ZodNumber;
     duration_estimate_sec: z.ZodNumber;

package/dist/skills.js

@@ -1,4 +1,7 @@
 import { z } from "zod";
+import { longFormQuoteSchema } from "./long-form-pricing.js";
+import { RESOLVED_TIMELINE_MAX_SLOTS } from "./long-form-profile.js";
+import { brollPolicy } from "./broll-policy.js";
 import { countWords } from "./pacing.js";
 import { resolveTtsModel, MAX_SCRIPT_CHARS, SCRIPT_LENGTH_DESCRIPTION, STRESS_MARKING_DESCRIPTION, ttsScriptLimitError, TTS_MODELS, isVoicePresetName, VOICE_ID_PATTERN, VOICE_NAME_PATTERN, VOICE_PRESET_NAMES, } from "./voices.js";
 export const CAPTION_STYLES = ["hormozi", "tiktok", "minimal"];
@@ -67,7 +70,9 @@ export const MAKE_UGC_DESCRIPTION = "Start generation of a lip-synced UGC video.
 /** поллинг — свойства протокола, и REST-каталогу они не адресованы. */
 export const MAKE_UGC_AGENT_PROTOCOL = "Call quote_ugc before generating and show the cost. This does NOT wait for the video: it " +
     "starts the run and returns a run_id IMMEDIATELY. You MUST then poll get_run with that " +
-    "run_id until the state is 'succeeded' (video_url) or 'failed'. Pass attempt=2,3,… to " +
+    "run_id until the state is 'succeeded' (video_url) or 'failed'. A 'failed' run whose paid " +
+    "vendor job we still hold can go back to 'queued' and reach 'succeeded' later; whenever that " +
+    "happens it is named in warnings[]. Pass attempt=2,3,… to " +
     "deliberately start a NEW run for the same input (retry after a failure).";
 /**
  * Сырой zod-shape входа make_ugc — БЕЗ `.refine()`.
@@ -93,10 +98,57 @@ export const ugcSegment = z.object({
     script: z.string().min(1).max(MAX_SCRIPT_CHARS).optional(),
     /** Полнокадровый врез. Обязателен у `media`, запрещён у `actor`. */
     media_url: z.string().url().max(MAX_URL_LENGTH).optional(),
+    media_type: z.enum(["image", "video"]).optional()
+        .describe("Explicit media source type; omission means video, regardless of URL suffix. Availability follows the segments field."),
+    duration_seconds: z.number().positive().optional()
+        .describe("Required for an image segment; its display duration in seconds. Not accepted for actor or video segments."),
+    image_motion: z.object({
+        direction: z.enum(["in", "out"]),
+        amount: z.number().min(0).lt(1),
+    }).optional().describe("Optional image zoom: amount is the fractional reduction from fully contained size. No motion by default; no foreground crop."),
+}).superRefine((segment, context) => {
+    if (segment.kind === "actor") {
+        for (const field of ["media_type", "duration_seconds", "image_motion"]) {
+            if (segment[field] !== undefined)
+                context.addIssue({ code: z.ZodIssueCode.custom, path: [field], message: `${field} is only accepted on media segments` });
+        }
+    }
+    else if (segment.media_type === "image") {
+        if (segment.duration_seconds === undefined)
+            context.addIssue({ code: z.ZodIssueCode.custom, path: ["duration_seconds"], message: "image segment requires duration_seconds" });
+    }
+    else {
+        for (const field of ["duration_seconds", "image_motion"]) {
+            if (segment[field] !== undefined)
+                context.addIssue({ code: z.ZodIssueCode.custom, path: [field], message: `${field} requires media_type=image` });
+        }
+    }
+});
+export const ugcInsert = z.object({
+    id: z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/),
+    media_url: z.string().url().max(MAX_URL_LENGTH).startsWith("https://"),
+    media_type: z.enum(["image", "video"]),
+    anchor: z.union([
+        z.object({ startWord: z.number().int().nonnegative(), endWord: z.number().int().positive() })
+            .strict().refine(range => range.endWord > range.startWord, { message: "endWord must be greater than startWord" }),
+        z.object({ quote: z.string().min(1).max(MAX_SCRIPT_CHARS).refine(text => text.trim().length > 0),
+            occurrence: z.number().int().nonnegative().optional() }).strict(),
+    ]),
+    cover_words: z.number().int().positive().max(10000).optional()
+        .describe("How many spoken words this insert covers, counted from the first word of its anchor. " +
+        "Omitted means the anchored words only. The insert ends where the first uncovered word begins, " +
+        "so inserts whose coverage meets are adjacent frame for frame and leave no actor shot between them."),
+    image_motion: z.object({ direction: z.enum(["in", "out"]), amount: z.number().min(0).lt(1) }).strict().optional(),
+}).strict().refine(insert => insert.image_motion === undefined || insert.media_type === "image", {
+    path: ["image_motion"], message: "image_motion requires media_type=image",
 });
 /** Потолок актёрских сегментов — ограничение ОДНОГО рана, не суточных трат. */
 export const MAX_ACTOR_SEGMENTS = 3;
 export const MAX_SEGMENTS = 5;
+/** Потолки НАРРАТИВНОГО пути — другие, потому что медиа-шот денег не стоит, */
+/** а актёрский стоит: вставок столько, сколько вмещает таймлайн (ADR #265). */
+export const MAX_INSERTS = Math.floor((RESOLVED_TIMELINE_MAX_SLOTS - 1) / 2);
+export const MAX_NARRATED_ACTOR_SHOTS = 6;
 export const actorId = z.string().regex(/^actor_[a-z0-9][a-z0-9_-]{0,63}$/);
 export const makeUgcInputShape = {
     // НЕОБЯЗАТЕЛЬНЫЙ, но не «необязательный к заполнению»: ровно одно из
@@ -108,10 +160,16 @@ export const makeUgcInputShape = {
         .min(1, "script is empty: pass the words the actor says")
         .max(MAX_SCRIPT_CHARS, `script is longer than ${MAX_SCRIPT_CHARS} characters`)
         .optional()
-        .describe("required: the words the actor says. The schema leaves it optional for a second way of " +
-        "passing them that is not accepted yet, so a request without it is refused before any charge. " +
+        .describe("The words the actor says; required unless segments supplies the spoken text. " +
+        "Segments and text-anchored inserts require long-form qualification on the server. " +
         `${SCRIPT_LENGTH_DESCRIPTION} ${STRESS_MARKING_DESCRIPTION}`),
-    segments: z.array(ugcSegment).min(1).max(MAX_SEGMENTS).optional(),
+    segments: z.array(ugcSegment).min(1).max(MAX_SEGMENTS).optional()
+        .describe("Ordered actor and image segments; requires long-form qualification on the server, captions=false and 1080p. Image media requires explicit broll_policy=anyone."),
+    inserts: z.array(ugcInsert).min(1).max(MAX_INSERTS)
+        .refine(inserts => new Set(inserts.map(insert => insert.id)).size === inserts.length, {
+        message: "insert IDs must be unique",
+    }).optional().describe("Text-anchored image inserts over full narration, each covering cover_words spoken words from its anchor; " +
+        "requires long-form qualification on the server, captions=false, 1080p and explicit broll_policy=anyone."),
     person: z.string().min(1).max(500).optional(),
     actor_id: actorId
         .optional()
@@ -142,6 +200,7 @@ export const makeUgcInputShape = {
     character: z.string().regex(/^char_[a-zA-Z0-9]+$/).optional(),
     name: z.string().max(100).optional(),
     broll_url: z.string().url().max(MAX_URL_LENGTH).optional(),
+    broll_policy: brollPolicy.optional(),
     captions: z.boolean().default(false),
     caption_style: z.enum(CAPTION_STYLES).default("hormozi"),
     look: z.enum(LOOKS).default("natural"),
@@ -231,6 +290,9 @@ export const makeUgcInput = z
     // молчаливую подмену.
     .refine((v) => (v.script === undefined) !== (v.segments === undefined), {
     message: "pass exactly one of script | segments",
+})
+    .refine(v => v.inserts === undefined || (v.script !== undefined && v.segments === undefined), {
+    path: ["inserts"], message: "inserts requires script and cannot be combined with segments",
 })
     // Потолок символов — по модели: v3 короче v2 вдвое; отказ здесь, до резерва и вендора (#101).
     // Модель незнакомого клиенту голоса знает только сервер, и потолок он проверит сам (#164).
@@ -253,14 +315,8 @@ export const makeUgcInput = z
     path: ["actor_gender"],
     message: "actor_gender requires image: it describes the face in your photo; omit it, or pass image",
 })
-    // ПРАВИЛА СЕГМЕНТОВ (US-526). Каждое — ОТДЕЛЬНЫЙ .refine, а не одна проверка
-    // с общим текстом: сообщение обязано называть нарушенное правило, иначе агент
-    // получает «invalid input» и чинит вход перебором. Порядок правил — от того,
-    // что делает ролик невозможным, к тому, что делает его противоречивым.
-    //
-    // Правила живут ЗДЕСЬ, а не в `ugcSegment`: они про массив целиком (сколько
-    // актёров) либо про связь двух полей внутри элемента, а `z.object` элемента
-    // видит только сам элемент.
+    // Общие ограничения списка и обязательные поля ролей проверяются здесь.
+    // Тип картинки, длительность и движение проверяет ugcSegment.
     .refine((v) => v.segments === undefined || v.segments.some((s) => s.kind === "actor"), {
     message: "segments must contain at least one actor segment: nobody speaks otherwise",
 })
@@ -345,6 +401,7 @@ export function resolvedScript(input) {
 // из ПРЕДЛАГАЕМОГО shape, а не из полного, иначе автокомплит SDK показывал бы
 // отклонённые поля, которые сервер отбивает четырёхсотым (блокер B4).
 export const quoteResponse = z.object({
+    long_form_pricing: longFormQuoteSchema.optional(),
     skill: z.string(),
     credits_estimate: z.number().int().nonnegative(),
     duration_estimate_sec: z.number().positive(),