@clipwright/core 0.39.0 → 0.41.0

package/dist/mcp-ugc-descriptions.js

@@ -0,0 +1,112 @@
+import { CAPTION_STYLE_ALIASES } from "./skills.js";
+import { TEMPLATE_KINDS, TEMPLATE_SIZES, templateDataText } from "./templates/index.js";
+import { MAX_OVERLAYS_AT_ONCE } from "./ugc-layers.js";
+import { SCRIPT_LENGTH_DESCRIPTION } from "./voices.js";
+// MCP tools/list stays under the client's 102 KB (#1003), so quote_ugc carries these shorter texts; REST and OpenAPI keep the full ones (#1045).
+/** What each kind is, in a few words, with the rules its data alone does not say; null where its name and data say it all. */
+const TEMPLATE_GISTS = {
+    tag: "a short pill; without position it sits in the caption spot",
+    lower_third: null,
+    end_card: "a site pill and call to action in the caption spot",
+    title_card: "a hook card",
+    quote: "a quote card",
+    stat: "a number counting from 0 to value (2 decimals); over sits at chest level",
+    callout: "an arrow or ring on target {x,y}, % of the frame from top left; may point at the face",
+    checklist: "rows a cursor clicks in turn (item: row index from 0), each click flipping it",
+    phone_call: "an incoming call at the side (right unless side left), answered on answer_at",
+    compare: "before, then after sweeping or wiping in on reveal_at, on a 3:5 card",
+    notification: "at the top; stack cards drop in on their at",
+    progress: "steps checked in turn on advance_at (one per step) or evenly",
+    rating: "stars filling up to stars (1–5 in halves)",
+    chat_window: "the prompt types in; answer, table rows, cards each on its at or evenly; zoom cuts on them",
+    video_grid: "9:16 video tiles popping in turn: 2x2 takes cell_1–4, 3x1 cell_1–3",
+    word_title: "the first entry from the start, each later one on its at quote or evenly, replacing the last or (build) adding to it",
+    phone_screen: "a phone whose screen states change on states.at or evenly; lock, play, liked replace one another, tags add up, counter and timer stay",
+    terminal: "the command types in, the diff changes on diff.at, a checked status on at",
+    pointer_chips: "chips in a column below the face, each with a line to target {x,y} (% of the frame), in turn on items.at or evenly",
+    chart: null,
+    race: null,
+    hand_title: "handwritten; mark.word: index from 0",
+    word_fill: "one word whose letters show your clip",
+};
+const SIZE_FIELD = `, size? ${TEMPLATE_SIZES.join("|")}`;
+/** The templates catalog in fewer words: every kind's data fields as the full catalog names them. */
+export function compactTemplateCatalogText(kinds = TEMPLATE_KINDS) {
+    const sized = kinds.every(kind => templateDataText(kind).includes(SIZE_FIELD));
+    const data = (kind) => (sized ? templateDataText(kind).replace(SIZE_FIELD, "") : templateDataText(kind));
+    return "Graphic templates { id, kind, anchor, cover_words?, placement?, transition?, data }, on any script run; price unchanged, a covered " +
+        "presenter still billed. Ids unique across inserts, overlays, layout_windows and templates. Text: one line of Latin or the " +
+        "script's letters, digits and punctuation, no emoji; a wide CJK glyph counts 2. " +
+        (sized ? `Every kind's data also takes size? ${TEMPLATE_SIZES.join("|")} (absent: medium). ` : "") +
+        "A media field is { asset_id } of a ready asset of that type. An inner quote is a string of words inside the template's own, after the previous " +
+        "one, its beat on their first word, not under an insert or full-frame template; without one, clicks and steps spread evenly. A template " +
+        "on the caption band hides captions. A full-frame one hides the presenter, overlays and over templates and never meets a wipe or zoom " +
+        `insert. At most ${MAX_OVERLAYS_AT_ONCE} overlays and over templates at once, not overlapping. template_theme sets their look. Kinds: ` +
+        kinds.map(kind => {
+            const gist = kind.kind in TEMPLATE_GISTS ? TEMPLATE_GISTS[kind.kind] : kind.description;
+            return `${kind.kind} (${kind.placements.join("|")})${gist === null ? "" : `: ${gist}`}; data ${data(kind)}`;
+        }).join(". ") + ".";
+}
+const CAPTION_STYLE_TEXT = "Caption look when captions=true; hormozi is the default. " +
+    Object.entries(CAPTION_STYLE_ALIASES).map(([alias, preset]) => `${alias} draws ${preset}`).join("; ") +
+    ". Every style's look and preview: https://clipwright.io/captions";
+const SCRIPT_TEXT = "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} ` +
+    "Russian stress: a capital vowel inside a lowercase word (\"потОм\") reaches eleven_v4 and gemini-3.8-flash-tts as the mark U+0301; a " +
+    "typed mark is kept; a word-initial capital, all caps or a second capital is left as it is, so write \"Яндекс Еда\", not \"ЯндексЕда\". " +
+    "Tell users writing in Russian. eleven_flash_v2_5 and eleven_turbo_v2_5 cost less but misread stress marks.";
+/** quote_ugc's shorter text per field; a field not named keeps the full text REST and OpenAPI carry. */
+export const MCP_UGC_DESCRIPTIONS = {
+    script: SCRIPT_TEXT,
+    tts_model: "Speech model; omitted, the chosen voice's (list_voices), eleven_v4 for presets, catalog voices and voice_id. eleven_v3 " +
+        "speaks eleven_v4 with a warning. eleven_v4 and gemini-3.8-flash-tts read stress marks (see script); eleven_flash_v2_5 and " +
+        "eleven_turbo_v2_5 are cheaper outside Russian. gemini-3.8-flash-tts speaks only its own voices (default kore for a female actor, " +
+        "else charon), has no word timings or audio tags, and refuses preset and catalog voices, voice_id, captions=true, segments and " +
+        "inserts before any charge.",
+    caption_style: CAPTION_STYLE_TEXT,
+    templates: compactTemplateCatalogText(),
+    caption_emphasis: "Script words or phrases to emphasise, every occurrence, matched as an insert quote. An item is the quote or " +
+        "{ quote, look }: punch (a lead-in line over a large glowing keyword), pill (alone in a pill), color (accent colour) or box (soft " +
+        "accent box). Without look: punch draws punch, hormozi and accent color, others larger in their highlight colour. Needs " +
+        "captions=true; a quote not in script is refused before any charge.",
+    voice: "Voice name from list_voices (presets sarah | george | eric | daria_ru_female); another name is refused before any charge. " +
+        "Omitted: the default voice of the actor's gender (actor_id's or actor_gender's; george for the default actor and for image " +
+        "alone). A gemini-3.8-flash-tts voice selects that model; a tts_model not speaking the voice is refused. Not with voice_id.",
+    inserts: "Text-anchored image or video inserts over the narration, each over cover_words words from its anchor; need long-form " +
+        "qualification on the server, 1080p and broll_policy=anyone. Captions draw over them.",
+    segments: "Ordered actor and image segments; need long-form qualification on the server, captions=false and 1080p; image media " +
+        "needs broll_policy=anyone.",
+    captions: "Burn word-timed captions in, over the presenter and inserts; not with segments.",
+    caption_position: "top, middle, lower or bottom (80% of the height); omitted, the caption_style's own place. Requires captions=true.",
+    person: "NOT HONORED YET: the default actor is used; pick actor_id from list_actors or pass image.",
+    name: "NOT HONORED YET: it does not reach the renderer.",
+    look: "NOT HONORED YET: it does not reach the renderer.",
+    actor_id: "Saved actor ID from list_actors; not with image, person or actor_gender. Without voice or voice_id the voice follows its gender.",
+    voice_id: "Raw vendor voice id (16–32 letters and digits) outside the catalog; an unknown id fails the run, not the request. Not with " +
+        "voice or tts_model=gemini-3.8-flash-tts.",
+    broll_policy: "anyone allows people and the actor, no_actor excludes the actor, no_people all people and hands. Templates with " +
+        "your own picture or video need \"anyone\"; otherwise stored only. Run value wins over the account default; else no_people.",
+    overlays: `Text-anchored images or videos over the visible presenter, each at a position or place; at most ${MAX_OVERLAYS_AT_ONCE} at once, ` +
+        "not overlapping. Captions move off them to the middle or bottom third, never over the face, and hide while neither is free. Hidden " +
+        "under full-frame inserts. Needs what inserts need. Price unchanged.",
+    image: "Public https URL of the actor's photo (PNG, JPEG or WebP, up to 10 MB); a local file goes through upload_image first. A private, " +
+        "http, unreachable, redirecting, larger or other source is refused (unusable_source) before any charge. Gender is not detected: " +
+        "pass actor_gender or voice, else the male default speaks, with a warning.",
+    framing: "Text-anchored presenter sizes: each cuts to close or medium on its words and back after them; no overlap with each other, an " +
+        "insert or a layout window. One wholly under full-frame templates is named in warnings[]; it wins over a punch_in emphasis. Needs " +
+        "script and long-form qualification; price unchanged.",
+    actor_gender: "Gender of the face in image, only with image: picks that gender's default voice (sarah or george; kore or charon on " +
+        "gemini-3.8-flash-tts). Refused with actor_id. An explicit voice or voice_id wins, with a warning.",
+    aspect_ratio: "Output format. Omitted: 9:16, or with an image the supported format nearest its shape, even landscape, so pass it with " +
+        "image. A source more than 15% off the request is refused (aspect_conflict) before any charge.",
+    caption_mode: "full (default): every spoken word. highlights: only around caption_emphasis quotes (lead-in, quote, short tail); requires " +
+        "caption_emphasis. Captions hide under a full-frame insert.",
+    visible_ai_label: "Visible AI label, default true. False hides only the visible label; invisible marking and signed provenance stay.",
+    layout_windows: "Text-anchored presenter reframings: split (9:16 only) or card; no overlap with each other or an insert; needs what " +
+        "inserts need. A covered or blurred presenter is billed as face time.",
+    end_hold_s: "Seconds the last frame holds after the last word, the presenter frozen and every layer kept; production seconds. Needs " +
+        "script and long-form qualification.",
+    edit_sounds: "A short sound on every cut (insert, full-frame template, layout window, framing). Needs one of them; template_sounds.edit " +
+        "picks it (list_template_sounds). Price unchanged.",
+};
+//# sourceMappingURL=mcp-ugc-descriptions.js.map

package/dist/mcp-ugc-descriptions.js.map

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

package/dist/motion-styles.d.ts

@@ -0,0 +1,54 @@
+import { type AnchoredItem, type WordRange } from "./ugc-layers.js";
+export declare const MOTION_STYLE_IDS: readonly ["line_boil", "sketchbook", "paper_cutout", "fabric", "pixel", "comic", "zine", "film", "glass", "clay", "engraving"];
+export type MotionStyleId = (typeof MOTION_STYLE_IDS)[number];
+/** A style, or `plain`: a span drawn plain inside a styled video. */
+export declare const MOTION_STYLE_CHOICES: readonly ["line_boil", "sketchbook", "paper_cutout", "fabric", "pixel", "comic", "zine", "film", "glass", "clay", "engraving", "plain"];
+export type MotionStyleChoice = (typeof MOTION_STYLE_CHOICES)[number];
+export declare const MAX_MOTION_STYLE_SPANS = 20;
+/** When each style fits, for an agent choosing one by topic; keyed by id so a new style cannot ship without its line. */
+export declare const MOTION_STYLE_GUIDANCE: Readonly<Record<MotionStyleId, string>>;
+export declare const MOTION_STYLE_DESCRIPTION: string;
+export interface MotionStyleRequest {
+    style?: MotionStyleChoice | undefined;
+    spans?: readonly {
+        style: MotionStyleChoice;
+        anchor: AnchoredItem["anchor"];
+        cover_words?: number | undefined;
+    }[] | undefined;
+}
+/** The style a video is drawn in: the run's own, else its design's, else plain. */
+export declare function baseMotionStyle(input: {
+    motion_style?: MotionStyleRequest | undefined;
+    design?: {
+        style?: MotionStyleId | undefined;
+    } | undefined;
+}): MotionStyleChoice;
+/** The words each span covers, in order of the request; a string names why a span does not resolve. */
+export declare function motionStyleSpanRanges(script: string, spans: NonNullable<MotionStyleRequest["spans"]>): (WordRange | string)[];
+/** Why a request's spans cannot be drawn: no script to sit on, an anchor that names no words, two spans on one word, or a span in the video's own
+ *  style. */
+export declare function motionStyleRefusals(input: {
+    script?: string | undefined;
+    segments?: unknown;
+    motion_style?: MotionStyleRequest | undefined;
+    design?: {
+        style?: MotionStyleId | undefined;
+    } | undefined;
+}): {
+    path: (string | number)[];
+    message: string;
+}[];
+/** Whether the video draws anything a style dresses: captions, templates or scenes. */
+export declare const motionStyleHasCanvas: (input: {
+    captions?: boolean | undefined;
+    templates?: readonly unknown[] | undefined;
+    scenes?: readonly unknown[] | undefined;
+}) => boolean;
+/** Whether the request names a style other than plain anywhere. */
+export declare const motionStyleAsked: (input: {
+    motion_style?: MotionStyleRequest | undefined;
+    design?: {
+        style?: MotionStyleId | undefined;
+    } | undefined;
+}) => boolean;
+export declare const MOTION_STYLE_UNUSED_WARNING = "motion_style was not drawn: a style dresses captions, templates and scenes, and this video has none";

package/dist/motion-styles.js

@@ -0,0 +1,67 @@
+import { lexicalTokens } from "./semantic-inserts.js";
+import { layerWordRange } from "./ugc-layers.js";
+// Motion styles (#1123): how the graphics of a video are drawn and move: their lines, their material and their timing. A style is part of the
+// design DNA; its colours stay the palette's. It dresses captions, templates and scenes, never the presenter or the pictures.
+export const MOTION_STYLE_IDS = ["line_boil", "sketchbook", "paper_cutout", "fabric", "pixel", "comic", "zine", "film", "glass", "clay", "engraving"];
+/** A style, or `plain`: a span drawn plain inside a styled video. */
+export const MOTION_STYLE_CHOICES = [...MOTION_STYLE_IDS, "plain"];
+export const MAX_MOTION_STYLE_SPANS = 20;
+/** When each style fits, for an agent choosing one by topic; keyed by id so a new style cannot ship without its line. */
+export const MOTION_STYLE_GUIDANCE = {
+    line_boil: "a hand-drawn line that redraws itself; sits on any look and topic",
+    sketchbook: "pencil on paper; tutorials, ideas, plans and personal stories",
+    paper_cutout: "card cutouts moved as stop motion; playful explainers, kids, crafts",
+    fabric: "felt and stitching; cosy, handmade, home and baby brands",
+    pixel: "a retro game grid with square corners; games, tech, nostalgia",
+    comic: "halftone, heavy ink and outlined letters; bold claims, reveals, humour",
+    zine: "a photocopied collage of leaning scraps; music, fashion, street culture",
+    film: "moving grain and a flickering lamp; stories, history, a cinematic mood",
+    glass: "frosted panes and soft light; tech, finance, premium products",
+    clay: "modelled clay as stop motion; friendly, light-hearted topics",
+    engraving: "fine hatching and a double rule; heritage, craft, food and drink, serious topics",
+};
+export const MOTION_STYLE_DESCRIPTION = "How captions, templates and scenes are drawn: style for the whole video, spans for words drawn in another " +
+    "style, entered and left through that style's own cut. Colours stay the design's; small text stays crisp. Spans need script. Free. Styles: " +
+    `${MOTION_STYLE_IDS.map(id => `${id}, ${MOTION_STYLE_GUIDANCE[id]}`).join("; ")}; plain, no style. One style carries the video; a span in a ` +
+    "second style marks one moment, such as a twist, a number or the call to action.";
+/** The style a video is drawn in: the run's own, else its design's, else plain. */
+export function baseMotionStyle(input) {
+    return input.motion_style?.style ?? input.design?.style ?? "plain";
+}
+/** The words each span covers, in order of the request; a string names why a span does not resolve. */
+export function motionStyleSpanRanges(script, spans) {
+    const tokens = lexicalTokens(script);
+    return spans.map((span, index) => layerWordRange(tokens, { id: `span${index}`, anchor: span.anchor, cover_words: span.cover_words }));
+}
+/** Why a request's spans cannot be drawn: no script to sit on, an anchor that names no words, two spans on one word, or a span in the video's own
+ *  style. */
+export function motionStyleRefusals(input) {
+    const spans = input.motion_style?.spans;
+    if (!spans?.length)
+        return [];
+    if (input.script === undefined || input.segments !== undefined) {
+        return [{ path: ["motion_style", "spans"], message: "motion_style spans sit on the script's words: pass script, without segments" }];
+    }
+    const base = baseMotionStyle(input), refusals = [], taken = [];
+    for (const [index, range] of motionStyleSpanRanges(input.script, spans).entries()) {
+        const span = spans[index];
+        if (typeof range === "string") {
+            refusals.push({ path: ["motion_style", "spans", index, "anchor"], message: range });
+            continue;
+        }
+        if (span.style === base) {
+            refusals.push({ path: ["motion_style", "spans", index, "style"], message: `the span is in the video's own style ${base}: name another style or drop the span` });
+        }
+        if (taken.some(other => range.startWord < other.coverWord && other.startWord < range.coverWord)) {
+            refusals.push({ path: ["motion_style", "spans", index, "anchor"], message: "spans may not share words" });
+        }
+        taken.push(range);
+    }
+    return refusals;
+}
+/** Whether the video draws anything a style dresses: captions, templates or scenes. */
+export const motionStyleHasCanvas = (input) => input.captions === true || Boolean(input.templates?.length) || Boolean(input.scenes?.length);
+/** Whether the request names a style other than plain anywhere. */
+export const motionStyleAsked = (input) => baseMotionStyle(input) !== "plain" || Boolean(input.motion_style?.spans?.some(span => span.style !== "plain"));
+export const MOTION_STYLE_UNUSED_WARNING = "motion_style was not drawn: a style dresses captions, templates and scenes, and this video has none";
+//# sourceMappingURL=motion-styles.js.map

package/dist/motion-styles.js.map

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

package/dist/moves.d.ts

@@ -0,0 +1,222 @@
+import { z } from "zod";
+export declare const MOVES_PATH = "/v1/moves";
+/** The script line a move serves, finer than hook, proof and call to action. */
+export declare const MOVE_BEATS: readonly ["hook", "problem", "demo", "proof", "social_proof", "offer", "cta", "transition"];
+export type MoveBeat = (typeof MOVE_BEATS)[number];
+/** What the move shows, so the agent knows what to pass in data. */
+export declare const MOVE_CONTENTS: readonly ["none", "words", "number", "list", "quote", "rating", "photo", "screenshot", "footage", "link"];
+export type MoveContent = (typeof MOVE_CONTENTS)[number];
+/** Where it draws: over the presenter, on the full frame, on the presenter's shot, on the captions, on a picture, on a graphic, or between shots. */
+export declare const MOVE_SURFACES: readonly ["over", "full", "presenter", "captions", "picture", "layer", "transition"];
+export type MoveSurface = (typeof MOVE_SURFACES)[number];
+export declare const MOVE_SKILLS: readonly ["make_ugc", "make_faceless", "plan_reference_remake"];
+export type MoveSkill = (typeof MOVE_SKILLS)[number];
+/** soon: listed so the agent knows it is coming, refused when named. */
+export declare const MOVE_STATUSES: readonly ["ready", "soon"];
+export declare const MAX_MOVES = 40;
+export declare const MOVES_PAGE_DEFAULT = 40;
+export declare const MOVES_PAGE_MAX = 100;
+export declare const moveName: z.ZodString;
+/** One catalogue line: the short read carries the first fields, detail=full all of them. */
+export declare const motionMove: z.ZodObject<{
+    name: z.ZodString;
+    status: z.ZodEnum<{
+        ready: "ready";
+        soon: "soon";
+    }>;
+    purpose: z.ZodString;
+    beats: z.ZodArray<z.ZodEnum<{
+        cta: "cta";
+        demo: "demo";
+        hook: "hook";
+        offer: "offer";
+        problem: "problem";
+        proof: "proof";
+        social_proof: "social_proof";
+        transition: "transition";
+    }>>;
+    content: z.ZodEnum<{
+        footage: "footage";
+        link: "link";
+        list: "list";
+        none: "none";
+        number: "number";
+        photo: "photo";
+        quote: "quote";
+        rating: "rating";
+        screenshot: "screenshot";
+        words: "words";
+    }>;
+    surface: z.ZodEnum<{
+        captions: "captions";
+        full: "full";
+        layer: "layer";
+        over: "over";
+        picture: "picture";
+        presenter: "presenter";
+        transition: "transition";
+    }>;
+    credits: z.ZodNumber;
+    look: z.ZodOptional<z.ZodString>;
+    moods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        calm: "calm";
+        playful: "playful";
+        premium: "premium";
+        punchy: "punchy";
+    }>>>;
+    seconds: z.ZodOptional<z.ZodNumber>;
+    per_video: z.ZodOptional<z.ZodNumber>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        make_faceless: "make_faceless";
+        make_ugc: "make_ugc";
+        plan_reference_remake: "plan_reference_remake";
+    }>>>;
+    needs: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    data: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    pairs_with: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    preview_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type MotionMove = z.infer<typeof motionMove>;
+export declare const motionMovesQuery: z.ZodObject<{
+    beat: z.ZodOptional<z.ZodEnum<{
+        cta: "cta";
+        demo: "demo";
+        hook: "hook";
+        offer: "offer";
+        problem: "problem";
+        proof: "proof";
+        social_proof: "social_proof";
+        transition: "transition";
+    }>>;
+    content: z.ZodOptional<z.ZodEnum<{
+        footage: "footage";
+        link: "link";
+        list: "list";
+        none: "none";
+        number: "number";
+        photo: "photo";
+        quote: "quote";
+        rating: "rating";
+        screenshot: "screenshot";
+        words: "words";
+    }>>;
+    surface: z.ZodOptional<z.ZodEnum<{
+        captions: "captions";
+        full: "full";
+        layer: "layer";
+        over: "over";
+        picture: "picture";
+        presenter: "presenter";
+        transition: "transition";
+    }>>;
+    mood: z.ZodOptional<z.ZodEnum<{
+        calm: "calm";
+        playful: "playful";
+        premium: "premium";
+        punchy: "punchy";
+    }>>;
+    skill: z.ZodOptional<z.ZodEnum<{
+        make_faceless: "make_faceless";
+        make_ugc: "make_ugc";
+        plan_reference_remake: "plan_reference_remake";
+    }>>;
+    q: z.ZodOptional<z.ZodString>;
+    names: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        short: "short";
+    }>>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type MotionMovesQuery = z.infer<typeof motionMovesQuery>;
+export type MotionMovesQueryArgs = z.input<typeof motionMovesQuery>;
+export declare const motionMovesList: z.ZodObject<{
+    moves: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            ready: "ready";
+            soon: "soon";
+        }>;
+        purpose: z.ZodString;
+        beats: z.ZodArray<z.ZodEnum<{
+            cta: "cta";
+            demo: "demo";
+            hook: "hook";
+            offer: "offer";
+            problem: "problem";
+            proof: "proof";
+            social_proof: "social_proof";
+            transition: "transition";
+        }>>;
+        content: z.ZodEnum<{
+            footage: "footage";
+            link: "link";
+            list: "list";
+            none: "none";
+            number: "number";
+            photo: "photo";
+            quote: "quote";
+            rating: "rating";
+            screenshot: "screenshot";
+            words: "words";
+        }>;
+        surface: z.ZodEnum<{
+            captions: "captions";
+            full: "full";
+            layer: "layer";
+            over: "over";
+            picture: "picture";
+            presenter: "presenter";
+            transition: "transition";
+        }>;
+        credits: z.ZodNumber;
+        look: z.ZodOptional<z.ZodString>;
+        moods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            calm: "calm";
+            playful: "playful";
+            premium: "premium";
+            punchy: "punchy";
+        }>>>;
+        seconds: z.ZodOptional<z.ZodNumber>;
+        per_video: z.ZodOptional<z.ZodNumber>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            make_faceless: "make_faceless";
+            make_ugc: "make_ugc";
+            plan_reference_remake: "plan_reference_remake";
+        }>>>;
+        needs: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        data: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pairs_with: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        preview_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    total: z.ZodNumber;
+    next_cursor: z.ZodNullable<z.ZodString>;
+    contract_version: z.ZodString;
+}, z.core.$strict>;
+export type MotionMovesList = z.infer<typeof motionMovesList>;
+/** A move put on the script's words. */
+export declare const ugcMove: z.ZodObject<{
+    name: z.ZodString;
+    anchor: z.ZodObject<{
+        quote: z.ZodString;
+        occurrence: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    cover_words: z.ZodOptional<z.ZodNumber>;
+    placement: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        over: "over";
+    }>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type UgcMove = z.infer<typeof ugcMove>;
+export declare const MOVES_DESCRIPTION: string;
+/** Moves sit on the script's words: an anchor that names none is refused before any charge. */
+export declare function moveRefusals(input: {
+    script?: string | undefined;
+    segments?: unknown;
+    moves?: readonly UgcMove[] | undefined;
+}): {
+    path: (string | number)[];
+    message: string;
+}[];

package/dist/moves.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+import { DESIGN_MOTIONS } from "./design.js";
+import { lexicalTokens } from "./semantic-inserts.js";
+import { layerWordRange } from "./ugc-layers.js";
+// Moves (#1175): our catalogue of motion and graphics devices as a client agent reads it and puts it on lines of a script.
+export const MOVES_PATH = "/v1/moves";
+/** The script line a move serves, finer than hook, proof and call to action. */
+export const MOVE_BEATS = ["hook", "problem", "demo", "proof", "social_proof", "offer", "cta", "transition"];
+/** What the move shows, so the agent knows what to pass in data. */
+export const MOVE_CONTENTS = ["none", "words", "number", "list", "quote", "rating", "photo", "screenshot", "footage", "link"];
+/** Where it draws: over the presenter, on the full frame, on the presenter's shot, on the captions, on a picture, on a graphic, or between shots. */
+export const MOVE_SURFACES = ["over", "full", "presenter", "captions", "picture", "layer", "transition"];
+export const MOVE_SKILLS = ["make_ugc", "make_faceless", "plan_reference_remake"];
+/** soon: listed so the agent knows it is coming, refused when named. */
+export const MOVE_STATUSES = ["ready", "soon"];
+export const MAX_MOVES = 40;
+export const MOVES_PAGE_DEFAULT = 40;
+export const MOVES_PAGE_MAX = 100;
+export const moveName = z.string().min(1).max(48).regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "a move name is as list_moves names it, such as stat-count-up");
+/** One catalogue line: the short read carries the first fields, detail=full all of them. */
+export const motionMove = z.strictObject({
+    name: moveName,
+    status: z.enum(MOVE_STATUSES),
+    purpose: z.string().describe("What it does for the viewer."),
+    beats: z.array(z.enum(MOVE_BEATS)).min(1),
+    content: z.enum(MOVE_CONTENTS),
+    surface: z.enum(MOVE_SURFACES),
+    credits: z.number().int().min(0).describe("Credits per use, on the quote; 0 is free."),
+    look: z.string().optional().describe("What the viewer sees."),
+    moods: z.array(z.enum(DESIGN_MOTIONS)).optional(),
+    seconds: z.number().min(0).optional().describe("How long its motion takes."),
+    per_video: z.number().int().min(1).optional().describe("The most uses one video takes before it tires."),
+    skills: z.array(z.enum(MOVE_SKILLS)).optional().describe("Where it can be drawn."),
+    needs: z.string().nullable().optional().describe("What must already be on its line, or null."),
+    data: z.string().nullable().optional().describe("The fields moves[].data takes, or null."),
+    pairs_with: z.array(moveName).optional(),
+    preview_url: z.string().url().nullable().optional(),
+});
+export const motionMovesQuery = z.strictObject({
+    beat: z.enum(MOVE_BEATS).optional(),
+    content: z.enum(MOVE_CONTENTS).optional(),
+    surface: z.enum(MOVE_SURFACES).optional(),
+    mood: z.enum(DESIGN_MOTIONS).optional(),
+    skill: z.enum(MOVE_SKILLS).optional(),
+    q: z.string().trim().min(1).max(60).optional().describe("Words to find in a move's name, purpose and look."),
+    names: z.string().min(1).max(600).optional().describe("Comma-separated names: those moves only, as their full lines."),
+    detail: z.enum(["short", "full"]).optional().describe("short (default): name, purpose, beats, content, surface, credits, status."),
+    limit: z.coerce.number().int().min(1).max(MOVES_PAGE_MAX).optional(),
+    cursor: z.string().regex(/^\d{1,4}$/).optional().describe("next_cursor of the page before."),
+});
+export const motionMovesList = z.strictObject({
+    moves: z.array(motionMove),
+    total: z.number().int().min(0),
+    next_cursor: z.string().nullable(),
+    contract_version: z.string(),
+});
+/** A move put on the script's words. */
+export const ugcMove = z.strictObject({
+    name: moveName,
+    anchor: z.strictObject({ quote: z.string().trim().min(1).max(2000), occurrence: z.number().int().nonnegative().optional() })
+        .describe("The words it lands on, quoted from the script."),
+    cover_words: z.number().int().positive().max(10000).optional().describe("How many spoken words it stays, from the anchor's first; omitted, the anchor's."),
+    placement: z.enum(["over", "full"]).optional().describe("For a move drawn over or on the full frame, where list_moves allows both."),
+    data: z.record(z.string(), z.unknown()).optional().describe("What it shows, as list_moves detail=full names in data."),
+});
+export const MOVES_DESCRIPTION = "Moves from list_moves on your words: each { name, anchor: { quote }, cover_words?, placement?, data? }. " +
+    "Each is drawn as its line in list_moves says; data takes the fields it names. A move that cannot be drawn on its words or in this video " +
+    "is named in warnings[] and left out, never dropped silently. Its credits are on the quote.";
+/** Moves sit on the script's words: an anchor that names none is refused before any charge. */
+export function moveRefusals(input) {
+    if (!input.moves?.length)
+        return [];
+    if (input.script === undefined || input.segments !== undefined)
+        return [{ path: ["moves"], message: "moves require script and cannot be combined with segments" }];
+    const tokens = lexicalTokens(input.script);
+    return input.moves.flatMap((move, index) => {
+        const range = layerWordRange(tokens, { id: move.name, anchor: move.anchor, cover_words: move.cover_words });
+        return typeof range === "string" ? [{ path: ["moves", index, "anchor"], message: range }] : [];
+    });
+}
+//# sourceMappingURL=moves.js.map

package/dist/moves.js.map

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

package/dist/music.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { PartsLine } from "./parts-pricing.js";
+/** Credits for the music of one video. */
+export declare const MUSIC_BED_CREDITS = 60;
+export declare const MUSIC_MOOD_MAX_CHARS = 400;
+export declare const MUSIC_DESCRIPTION: string;
+export declare const musicRequest: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodObject<{
+    mood: z.ZodString;
+}, z.core.$strict>]>;
+export type MusicRequest = z.infer<typeof musicRequest>;
+/** The quote's and the bill's music line. */
+export declare function musicLine(credits?: number): PartsLine;
+/** Off, the field is refused before any reserve. */
+export declare function isMusicEnabled(env?: Record<string, string | undefined>): boolean;
+export declare const MUSIC_DISABLED_MESSAGE = "music is not available right now; omit it";
+export declare const FACELESS_MUSIC_REFUSAL = "music is not available for make_faceless right now; omit it, or ask make_ugc for it";
+/** A delivered video that asked for music and carries none says why, and the music is not charged. */
+export declare function musicNotAddedWarning(reason: string): string;

package/dist/music.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+// Opt-in music: one track made for the video and mixed under the voice; its own quote line, charged only on delivery.
+/** Credits for the music of one video. */
+export const MUSIC_BED_CREDITS = 60;
+export const MUSIC_MOOD_MAX_CHARS = 400;
+export const MUSIC_DESCRIPTION = 'Background music under the voice, made for this video; off unless you ask. "auto" takes the mood from the ' +
+    `script; { mood } says it in your words, such as "calm lo-fi". ${MUSIC_BED_CREDITS} credits per video, its own line on the quote, ` +
+    "charged only when the video is delivered with it.";
+export const musicRequest = z.union([
+    z.literal("auto"),
+    z.strictObject({
+        mood: z.string().trim().min(1).max(MUSIC_MOOD_MAX_CHARS).regex(/^[^\p{Cc}]+$/u, "mood must be plain text on one line"),
+    }),
+], { error: 'music must be "auto" or { mood: "your words" }' });
+/** The quote's and the bill's music line. */
+export function musicLine(credits = MUSIC_BED_CREDITS) {
+    return { label: "music", unit: "track", quantity: 1, unit_credits: credits, credits };
+}
+/** Off, the field is refused before any reserve. */
+export function isMusicEnabled(env = typeof process === "undefined" ? {} : process.env) {
+    return env.CLIPWRIGHT_MUSIC === "1";
+}
+export const MUSIC_DISABLED_MESSAGE = "music is not available right now; omit it";
+export const FACELESS_MUSIC_REFUSAL = "music is not available for make_faceless right now; omit it, or ask make_ugc for it";
+/** A delivered video that asked for music and carries none says why, and the music is not charged. */
+export function musicNotAddedWarning(reason) {
+    return `music was not added: ${reason}; it was not charged`;
+}
+//# sourceMappingURL=music.js.map

package/dist/music.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"music.js","sourceRoot":"","sources":["../src/music.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,sHAAsH;AAEtH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,MAAM,CAAC,MAAM,iBAAiB,GAAG,4GAA4G;IAC3I,iEAAiE,iBAAiB,iDAAiD;IACnI,mDAAmD,CAAC;AAEtD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC;IAClC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACjB,CAAC,CAAC,YAAY,CAAC;QACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,KAAK,CAAC,eAAe,EAAE,qCAAqC,CAAC;KACvH,CAAC;CACH,EAAE,EAAE,KAAK,EAAE,gDAAgD,EAAE,CAAC,CAAC;AAGhE,6CAA6C;AAC7C,MAAM,UAAU,SAAS,CAAC,OAAO,GAAW,iBAAiB;IAC3D,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACxF,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,cAAc,CAAC,GAAG,GAAuC,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG;IACxH,OAAO,GAAG,CAAC,gBAAgB,KAAK,GAAG,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,2CAA2C,CAAC;AAClF,MAAM,CAAC,MAAM,sBAAsB,GAAG,qFAAqF,CAAC;AAE5H,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,wBAAwB,MAAM,sBAAsB,CAAC;AAC9D,CAAC"}