@clipwright/core 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -16,6 +16,47 @@ a customer reading it should not miss what appeared in the product. Like *Server
 they are live from the day the web app was deployed, not from the package release they are
 listed under.
 
+## [0.21.0] - 2026-09-27
+
+Faceless videos: an agent can now make a video of up to 90 seconds without an on-camera presenter, from a script or
+from a short brief, and see the price before anything is made.
+
+### Added
+
+- `quote_faceless` and `make_faceless` MCP tools, `quoteFaceless` and `startFaceless` in the SDK, and the
+  `quote-faceless` and `make-faceless` CLI commands. The video is narration over an opening animated clip and image
+  scenes, with captions on by default. `duration_seconds` (30 to 90) is a target: the video ends with its narration
+  and runs from 25 seconds to 5 seconds past `duration_seconds`, never past 90. `quote_faceless` is free;
+  `make_faceless` returns a `run_id`, and `get_run` reports progress. The MCP server now lists fourteen tools.
+
+### Server-side
+
+- A faceless run is charged for the video it delivers, by its actual length, and never more than its quote: seconds
+  past `duration_seconds` are free. A failed
+  run is charged nothing, including one we stop ourselves because a step did not meet our checks. A run held for
+  review keeps its credit hold until it is resolved.
+- Captions drop surrounding punctuation, keep accents and other diacritics, and show numbers as written (`$3.50`,
+  `10:30`, `1,000`, `50%`, `-20`).
+- With captions on, the script is checked against the caption font before speech is generated; a character the font
+  cannot draw fails the run without a customer charge.
+- Narration uses automatic language detection.
+- Pictures change about every three seconds, between spoken words.
+
+### Changed
+
+- *Server-side* Voice catalog: `cs_female_jana` is now listed with use case `advertisement` (was `narrative_story`);
+  the notice period is 4015 days for `en_female_cassidy` (was 730) and 730 days for `fi_male_jaakko` (was 365).
+  `es_male_benjamin` is unchanged and remains available.
+
+### Known limits
+
+- The voice reads some abbreviations literally: write "1.5 million" rather than "1.5M".
+- A generated picture can come out as a collage of two or three panels, and small character details (glasses,
+  for instance) can change between pictures.
+- Narration is not loudness-normalized yet, so a video can play quieter than other clips in the same feed.
+- *Server-side* A faceless run can fail when the opening clip shows a pattern our text check mistakes for lettering
+  (a chain, for instance). The run is charged nothing; running it again produces a new video.
+
 ## [0.20.0] - 2026-09-25
 
 The MCP server is ready for directories: it has a name in the official MCP

package/dist/endpoints.js

@@ -2,6 +2,8 @@
 /** prints the "what costs money" list from here. */
 import { ACTOR_DEFAULTS_PATH } from "./broll-policy.js";
 export const API_ENDPOINTS = [
+    { method: "POST", path: "/v1/skills/make_faceless/quote", billed: false, onQuickstart: false, jsonBody: true },
+    { method: "POST", path: "/v1/skills/make_faceless/run", billed: true, onQuickstart: false, jsonBody: true },
     { method: "GET", path: "/health", billed: false, onQuickstart: true, jsonBody: false },
     { method: "GET", path: "/v1/voices", billed: false, onQuickstart: true, jsonBody: false },
     { method: "GET", path: "/v1/account", billed: false, onQuickstart: true, jsonBody: false },

package/dist/endpoints.js.map

@@ -1 +1 @@
-{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,oDAAoD;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAcxD,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;IACtF,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;IACzF,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1F,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACxG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC3F,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACrG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IACjG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1F,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IACjG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IACjG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;IACjG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC7G,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC1G,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC5F,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,6BAA6B,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;CAC5G,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAC,QAAqB;IACjD,OAAO,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAA2B,aAAa,CAAC,MAAM,CAC9E,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CACpC,CAAC"}
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"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"}

package/dist/faceless-price.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export declare const FACELESS_TARIFF_ID: "faceless-image-i2v-v1";
+/** A faceless video ends with its speech and runs at least 25 s (owner, 2026-09-27). */
+export declare const FACELESS_MIN_OUTPUT_FRAMES = 625;
+/** The pre-speech estimate floor keeps the 4 s offset the 26 s floor had from the former 30 s minimum. */
+export declare const FACELESS_MIN_ESTIMATE_SEC = 21;
+/** A video may run up to 5 s past its selection, never past 90 s; the charge stays within the selection's quote (owner, 2026-09-27). */
+export declare const facelessMaxOutputFrames: (selectedFrames: number) => number;
+export declare const facelessQuote: z.ZodObject<{
+    outputFrames: z.ZodNumber;
+    baseCredits: z.ZodNumber;
+    openerCredits: z.ZodNumber;
+    totalCredits: z.ZodNumber;
+    tariffId: z.ZodLiteral<"faceless-image-i2v-v1">;
+    captions: z.ZodBoolean;
+}, z.core.$strict>;
+export type FacelessQuote = z.infer<typeof facelessQuote>;
+export declare function quoteFaceless(input: {
+    outputFrames: number;
+    captions: boolean;
+}): FacelessQuote;

package/dist/faceless-price.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export const FACELESS_TARIFF_ID = "faceless-image-i2v-v1";
+/** A faceless video ends with its speech and runs at least 25 s (owner, 2026-09-27). */
+export const FACELESS_MIN_OUTPUT_FRAMES = 625;
+/** The pre-speech estimate floor keeps the 4 s offset the 26 s floor had from the former 30 s minimum. */
+export const FACELESS_MIN_ESTIMATE_SEC = 21;
+/** A video may run up to 5 s past its selection, never past 90 s; the charge stays within the selection's quote (owner, 2026-09-27). */
+export const facelessMaxOutputFrames = (selectedFrames) => Math.min(selectedFrames + 125, 2250);
+export const facelessQuote = z.object({
+    outputFrames: z.number().int().min(FACELESS_MIN_OUTPUT_FRAMES).max(2250),
+    baseCredits: z.number().int().nonnegative(),
+    openerCredits: z.number().int().nonnegative(),
+    totalCredits: z.number().int().nonnegative(),
+    tariffId: z.literal(FACELESS_TARIFF_ID),
+    captions: z.boolean(),
+}).strict();
+export function quoteFaceless(input) {
+    const outputFrames = z.number().int().min(FACELESS_MIN_OUTPUT_FRAMES).max(2250).parse(input.outputFrames);
+    const captions = z.boolean().parse(input.captions);
+    const baseCredits = Math.max(200, Math.ceil(180 * outputFrames / 1500));
+    const openerCredits = 150;
+    return { outputFrames, baseCredits, openerCredits,
+        totalCredits: baseCredits + openerCredits, tariffId: FACELESS_TARIFF_ID, captions };
+}
+//# sourceMappingURL=faceless-price.js.map

package/dist/faceless-price.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faceless-price.js","sourceRoot":"","sources":["../src/faceless-price.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAgC,CAAC;AACnE,wFAAwF;AACxF,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAC9C,0GAA0G;AAC1G,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C,wIAAwI;AACxI,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,cAAsB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC;AAExG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACxE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC7C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;CACtB,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,UAAU,aAAa,CAAC,KAAkD;IAC9E,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC1G,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,aAAa,GAAG,GAAG,CAAC;IAC1B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa;QAC/C,YAAY,EAAE,WAAW,GAAG,aAAa,EAAE,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC;AACxF,CAAC"}

package/dist/faceless-public-plan.d.ts

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { type CutStyleProfile } from "./faceless-cut-style.js";
+import { facelessCutScore } from "./faceless-storyboard-v2-timing.js";
+import type { WordTiming } from "./tts-backend.js";
+declare const phrase: z.ZodObject<{
+    wordStart: z.ZodNumber;
+    wordEnd: z.ZodNumber;
+    accentWord: z.ZodNumber;
+}, z.core.$strict>;
+declare const storySchema: z.ZodObject<{
+    script: z.ZodString;
+    narrationStartFrame: z.ZodNumber;
+    beats: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        wordStart: z.ZodNumber;
+        wordEnd: z.ZodNumber;
+        mediaType: z.ZodEnum<{
+            image: "image";
+            video: "video";
+        }>;
+        reason: z.ZodEnum<{
+            action: "action";
+            emphasis: "emphasis";
+            place: "place";
+            reveal: "reveal";
+        }>;
+        phase: z.ZodEnum<{
+            climax: "climax";
+            development: "development";
+            resolution: "resolution";
+            setup: "setup";
+        }>;
+        visualPrompt: z.ZodString;
+    }, z.core.$strict>>;
+    captionPhrases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        wordStart: z.ZodNumber;
+        wordEnd: z.ZodNumber;
+        accentWord: z.ZodNumber;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type FacelessPublicStory = z.infer<typeof storySchema>;
+export declare function facelessSpeechWordSpans(script: string): Array<{
+    word: string;
+    start: number;
+    end: number;
+}>;
+export declare function facelessSpeechLexicalWords(script: string): string[];
+export declare function parseFacelessPublicStory(input: unknown, expectedScript?: string): FacelessPublicStory;
+type Score = ReturnType<typeof facelessCutScore>;
+export type FacelessPublicPlan = {
+    version: "faceless_public_v1";
+    outputFrames: number;
+    script: string;
+    words: WordTiming[];
+    narrationStartFrame: number;
+    captionPhrases: z.infer<typeof phrase>[];
+    shots: Array<{
+        id: string;
+        mediaType: "video" | "image";
+        startFrame: number;
+        endFrame: number;
+        beatIds: string[];
+        visualPrompts: string[];
+        phase: FacelessPublicStory["beats"][number]["phase"];
+        motion?: "PAN_UP" | "PAN_DOWN";
+        cutAfterWord?: number;
+        score: Score;
+    }>;
+};
+export declare function planPublicFacelessStory(input: FacelessPublicStory, words: readonly WordTiming[], inputStyle: CutStyleProfile, outputFrames: number): FacelessPublicPlan;
+export {};

package/dist/faceless-public-plan.js

@@ -0,0 +1,166 @@
+import { z } from "zod";
+import { FACELESS_MIN_OUTPUT_FRAMES } from "./faceless-price.js";
+import { parseCutStyle } from "./faceless-cut-style.js";
+import { assertStoryboardWords } from "./faceless-storyboard.js";
+import { facelessCutScore } from "./faceless-storyboard-v2-timing.js";
+const index = z.number().int().nonnegative().safe();
+const phrase = z.strictObject({ wordStart: index, wordEnd: index, accentWord: index });
+const storySchema = z.strictObject({
+    script: z.string().trim().min(1),
+    narrationStartFrame: index.max(125),
+    beats: z.array(z.strictObject({
+        id: z.string().trim().min(1), wordStart: index, wordEnd: index,
+        mediaType: z.enum(["video", "image"]),
+        reason: z.enum(["place", "reveal", "action", "emphasis"]),
+        phase: z.enum(["setup", "development", "climax", "resolution"]),
+        visualPrompt: z.string().trim().min(1),
+    })).min(2),
+    captionPhrases: z.array(phrase).min(1).optional(),
+});
+const lexicalWordPattern = /[\p{L}\p{N}\p{M}]+(?:['’][\p{L}\p{N}\p{M}]+)*/gu;
+export function facelessSpeechWordSpans(script) {
+    const matches = [...script.matchAll(lexicalWordPattern)];
+    const normalizedCount = script.normalize("NFKC").match(lexicalWordPattern)?.length ?? 0;
+    if (!matches.length || matches.length !== normalizedCount)
+        throw new Error("unsupported faceless script word boundaries");
+    const compactOffset = Array(script.length + 1).fill(0);
+    for (let i = 0; i < script.length; i++)
+        compactOffset[i + 1] = compactOffset[i] + (/\s/u.test(script[i]) ? 0 : 1);
+    return matches.map((match, index) => {
+        const first = index === 0 ? 0 : match.index;
+        const last = matches[index + 1]?.index ?? script.length;
+        return { word: script.slice(first, last).replace(/\s/gu, ""), start: compactOffset[first], end: compactOffset[last] };
+    });
+}
+export function facelessSpeechLexicalWords(script) {
+    return facelessSpeechWordSpans(script).map(({ word }) => {
+        const normalized = word.normalize("NFKC").match(lexicalWordPattern);
+        if (normalized?.length !== 1)
+            throw new Error("unsupported faceless lexical word");
+        return normalized[0].replace(/[’]/gu, "'").normalize("NFD")
+            .replace(/\p{M}/gu, "").toLocaleLowerCase("und");
+    });
+}
+export function parseFacelessPublicStory(input, expectedScript) {
+    if (expectedScript !== undefined && (typeof input !== "object" || input === null ||
+        input.script !== expectedScript))
+        throw new Error("faceless story changed supplied script");
+    const story = storySchema.parse(input);
+    const wordCount = facelessSpeechWordSpans(story.script).length;
+    const phases = ["setup", "development", "climax", "resolution"];
+    let nextWord = 0, lastPhase = 0;
+    const ids = new Set();
+    for (const [index, beat] of story.beats.entries()) {
+        const phase = phases.indexOf(beat.phase);
+        if (ids.has(beat.id) || beat.wordStart !== nextWord || beat.wordEnd <= beat.wordStart || beat.wordEnd > wordCount ||
+            beat.mediaType !== (index === 0 ? "video" : "image") || phase < lastPhase) {
+            throw new Error("faceless story beats must cover all words in phase order with one opening video");
+        }
+        ids.add(beat.id);
+        nextWord = beat.wordEnd;
+        lastPhase = phase;
+    }
+    if (nextWord !== wordCount)
+        throw new Error("faceless story beats do not cover all words");
+    if (story.captionPhrases) {
+        let end = 0;
+        for (const phrase of story.captionPhrases) {
+            if (phrase.wordStart !== end || phrase.wordEnd <= end || phrase.wordEnd > wordCount ||
+                phrase.accentWord < end || phrase.accentWord >= phrase.wordEnd)
+                throw new Error("invalid faceless caption phrase");
+            end = phrase.wordEnd;
+        }
+        if (end !== wordCount)
+            throw new Error("faceless caption phrases do not cover all words");
+    }
+    return story;
+}
+export function planPublicFacelessStory(input, words, inputStyle, outputFrames) {
+    if (!Number.isSafeInteger(outputFrames) || outputFrames < FACELESS_MIN_OUTPUT_FRAMES || outputFrames > 2250) {
+        throw new Error("public faceless output must be 625–2250 frames");
+    }
+    const story = parseFacelessPublicStory(input);
+    const style = parseCutStyle(inputStyle);
+    assertStoryboardWords(story.script, words);
+    const speechEnd = story.narrationStartFrame + words.at(-1).endSec * 25;
+    if (speechEnd > outputFrames + 1e-9 || outputFrames - speechEnd > 12.5 + 1e-9 ||
+        story.narrationStartFrame + words[0].startSec * 25 > 125)
+        throw new Error("speech duration outside public output bounds");
+    const phases = { setup: 0, development: 1, climax: 2, resolution: 3 };
+    const ids = new Set();
+    let nextWord = 0;
+    for (const [i, beat] of story.beats.entries()) {
+        if (ids.has(beat.id) || beat.wordStart !== nextWord || beat.wordEnd <= beat.wordStart || beat.wordEnd > words.length ||
+            beat.mediaType !== (i === 0 ? "video" : "image") ||
+            (i > 0 && phases[beat.phase] < phases[story.beats[i - 1].phase])) {
+            throw new Error("story beats require unique IDs, ordered phases, complete word coverage and one opening VIDEO");
+        }
+        nextWord = beat.wordEnd;
+        ids.add(beat.id);
+    }
+    if (nextWord !== words.length)
+        throw new Error("story beats must cover every word");
+    const captionPhrases = story.captionPhrases ?? story.beats.map(b => ({ wordStart: b.wordStart, wordEnd: b.wordEnd, accentWord: b.wordStart }));
+    nextWord = 0;
+    for (const p of captionPhrases) {
+        if (p.wordStart !== nextWord || p.wordEnd <= p.wordStart || p.wordEnd > words.length ||
+            p.accentWord < p.wordStart || p.accentWord >= p.wordEnd)
+            throw new Error("caption phrases must partition all words");
+        nextWord = p.wordEnd;
+    }
+    if (nextWord !== words.length)
+        throw new Error("caption phrases must cover all words");
+    const nodes = story.beats.slice(1).map((beat, i) => {
+        const afterWord = beat.wordStart - 1;
+        const frame = story.narrationStartFrame + Math.round((words[afterWord].endSec + words[afterWord + 1].startSec) / 2 * 25);
+        return { beatIndex: i + 1, afterWord, frame };
+    });
+    if (nodes[0].frame < 50 || nodes[0].frame > 125)
+        throw new Error("mandatory opening VIDEO requires 50–125 frames");
+    nodes.push({ beatIndex: story.beats.length, afterWord: words.length - 1, frame: outputFrames });
+    const final = nodes.length - 1;
+    const states = Array(nodes.length);
+    const openerScore = facelessCutScore(story.beats[1].reason, 0, { p25: 0, p75: 0 });
+    states[0] = { total: openerScore.net, path: [0], scores: [openerScore] };
+    for (let end = 1; end <= final; end++) {
+        for (let start = 0; start < end; start++) {
+            const prior = states[start];
+            const duration = nodes[end].frame - nodes[start].frame;
+            if (!prior || duration < 25 || duration > 150)
+                continue;
+            const phase = story.beats[nodes[start].beatIndex].phase;
+            const phaseRange = style.pacing.by_phase[phase];
+            const range = phaseRange && phaseRange.n > 0 ? phaseRange : style.pacing.global_image_frames;
+            const score = facelessCutScore(end === final ? null : story.beats[nodes[end].beatIndex].reason, duration, range);
+            const candidate = { total: prior.total + score.net, path: [...prior.path, end], scores: [...prior.scores, score] };
+            const best = states[end];
+            const firstDifference = best ? candidate.path.findIndex((v, i) => v !== best.path[i]) : -1;
+            if (!best || candidate.total > best.total + 1e-9 || (Math.abs(candidate.total - best.total) <= 1e-9 &&
+                (candidate.path.length < best.path.length || (candidate.path.length === best.path.length && firstDifference >= 0 &&
+                    candidate.path[firstDifference] < best.path[firstDifference]))))
+                states[end] = candidate;
+        }
+    }
+    const selected = states[final];
+    if (!selected)
+        throw new Error("no feasible public storyboard within IMAGE duration bounds");
+    let startFrame = 0;
+    let beatStart = 0;
+    const shots = selected.path.map((nodeIndex, i) => {
+        const node = nodes[nodeIndex];
+        const included = story.beats.slice(beatStart, node.beatIndex);
+        const hold = style.motion.pan_transition_n > 0 && style.motion.pan_flip_probability !== null && style.motion.pan_flip_probability < .5;
+        const shot = {
+            id: included[0].id, mediaType: i ? "image" : "video", startFrame, endFrame: node.frame,
+            beatIds: included.map(b => b.id), visualPrompts: included.map(b => b.visualPrompt), phase: included[0].phase,
+            ...(i ? { motion: hold || i % 2 === 1 ? "PAN_UP" : "PAN_DOWN" } : {}),
+            ...(nodeIndex < final ? { cutAfterWord: node.afterWord } : {}), score: selected.scores[i],
+        };
+        startFrame = node.frame;
+        beatStart = node.beatIndex;
+        return shot;
+    });
+    return { version: "faceless_public_v1", outputFrames, script: story.script, words: words.map(w => ({ ...w })),
+        narrationStartFrame: story.narrationStartFrame, captionPhrases, shots };
+}
+//# sourceMappingURL=faceless-public-plan.js.map

package/dist/faceless-public-plan.js.map

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

package/dist/faceless-public.d.ts

@@ -0,0 +1,107 @@
+import { z } from "zod";
+export declare const facelessSceneAnchor: 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>]>;
+export type FacelessSceneAnchor = z.infer<typeof facelessSceneAnchor>;
+export declare const facelessCustomerSceneImage: z.ZodObject<{
+    image_url: z.ZodString;
+    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>]>;
+}, z.core.$strict>;
+export type FacelessCustomerSceneImage = z.infer<typeof facelessCustomerSceneImage>;
+export declare const makeFacelessInput: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    duration_seconds: z.ZodNumber;
+    style_reference: z.ZodOptional<z.ZodString>;
+    character_reference: z.ZodOptional<z.ZodString>;
+    scene_images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        image_url: z.ZodString;
+        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>]>;
+    }, z.core.$strict>>>;
+    captions: z.ZodDefault<z.ZodBoolean>;
+    input_mode: z.ZodLiteral<"script">;
+    script: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    duration_seconds: z.ZodNumber;
+    style_reference: z.ZodOptional<z.ZodString>;
+    character_reference: z.ZodOptional<z.ZodString>;
+    scene_images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        image_url: z.ZodString;
+        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>]>;
+    }, z.core.$strict>>>;
+    captions: z.ZodDefault<z.ZodBoolean>;
+    input_mode: z.ZodLiteral<"brief">;
+    brief: z.ZodString;
+}, z.core.$strict>], "input_mode">;
+export type MakeFacelessInput = z.infer<typeof makeFacelessInput>;
+export type MakeFacelessInputArgs = z.input<typeof makeFacelessInput>;
+/** The API routes repeat these paths as literals, and a test keeps them equal. */
+export declare const FACELESS_QUOTE_PATH = "/v1/skills/make_faceless/quote";
+export declare const FACELESS_RUN_PATH = "/v1/skills/make_faceless/run";
+/** Flat form of `makeFacelessInput` for MCP, which needs an object shape, not a union. */
+/** Clients still parse with `makeFacelessInput` before sending, so the union stays the contract. */
+export declare const offeredFacelessInputShape: {
+    input_mode: z.ZodEnum<{
+        brief: "brief";
+        script: "script";
+    }>;
+    script: z.ZodOptional<z.ZodString>;
+    brief: z.ZodOptional<z.ZodString>;
+    duration_seconds: z.ZodNumber;
+    style_reference: z.ZodOptional<z.ZodString>;
+    character_reference: z.ZodOptional<z.ZodString>;
+    scene_images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        image_url: z.ZodString;
+        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>]>;
+    }, z.core.$strict>>>;
+    captions: z.ZodDefault<z.ZodBoolean>;
+};
+export declare const facelessPlannerInput: z.ZodObject<{
+    script: z.ZodString;
+    outputFrames: z.ZodNumber;
+    captions: z.ZodBoolean;
+    words: z.ZodArray<z.ZodObject<{
+        word: z.ZodString;
+        startSec: z.ZodNumber;
+        endSec: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type FacelessPlannerInput = z.infer<typeof facelessPlannerInput>;
+export declare const facelessQuoteResponse: z.ZodObject<{
+    outputFrames: z.ZodNumber;
+    baseCredits: z.ZodNumber;
+    openerCredits: z.ZodNumber;
+    totalCredits: z.ZodNumber;
+    tariffId: z.ZodLiteral<"faceless-image-i2v-v1">;
+    captions: z.ZodBoolean;
+    skill: z.ZodLiteral<"make_faceless">;
+    warnings: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    contract_version: z.ZodString;
+}, z.core.$strict>;
+export type FacelessQuoteResponse = z.infer<typeof facelessQuoteResponse>;

package/dist/faceless-public.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { uploadResponse } from "./uploads.js";
+import { MAX_URL_LENGTH } from "./skills.js";
+import { FACELESS_MIN_OUTPUT_FRAMES, facelessQuote } from "./faceless-price.js";
+const qualifiedImageUrl = uploadResponse.shape.url.max(MAX_URL_LENGTH).refine((value) => {
+    const host = new URL(value).hostname.toLowerCase();
+    return host !== "localhost" && !host.endsWith(".localhost") &&
+        host !== "127.0.0.1" && host !== "[::1]" &&
+        !/^10\.|^192\.168\.|^169\.254\.|^172\.(1[6-9]|2\d|3[01])\./.test(host);
+}, "image must use a qualified public https source");
+export const facelessSceneAnchor = z.union([
+    z.object({ startWord: z.number().int().nonnegative(), endWord: z.number().int().positive() })
+        .strict().refine((range) => range.endWord > range.startWord),
+    z.object({ quote: z.string().trim().min(1).max(500), occurrence: z.number().int().nonnegative().optional() }).strict(),
+]);
+export const facelessCustomerSceneImage = z.object({
+    image_url: qualifiedImageUrl,
+    anchor: facelessSceneAnchor,
+}).strict();
+const common = {
+    duration_seconds: z.number().min(30).max(90).refine((seconds) => Number.isInteger(seconds * 25), "duration_seconds must align to a 25 fps frame boundary"),
+    style_reference: qualifiedImageUrl.optional(),
+    character_reference: qualifiedImageUrl.optional(),
+    scene_images: z.array(facelessCustomerSceneImage).max(30).optional(),
+    captions: z.boolean().default(true),
+};
+const scriptInput = z.object({ ...common,
+    input_mode: z.literal("script"),
+    script: z.string().trim().min(1).max(10_000),
+}).strict();
+const briefInput = z.object({ ...common,
+    input_mode: z.literal("brief"),
+    brief: z.string().trim().min(1).max(5_000),
+}).strict();
+export const makeFacelessInput = z.discriminatedUnion("input_mode", [scriptInput, briefInput]);
+/** The API routes repeat these paths as literals, and a test keeps them equal. */
+export const FACELESS_QUOTE_PATH = "/v1/skills/make_faceless/quote";
+export const FACELESS_RUN_PATH = "/v1/skills/make_faceless/run";
+/** Flat form of `makeFacelessInput` for MCP, which needs an object shape, not a union. */
+/** Clients still parse with `makeFacelessInput` before sending, so the union stays the contract. */
+export const offeredFacelessInputShape = {
+    input_mode: z.enum(["script", "brief"])
+        .describe("'script' narrates your exact text; 'brief' writes the narration from a short description. Send exactly one of script or brief, matching this mode."),
+    script: scriptInput.shape.script.optional()
+        .describe("The narration, read as written. Required when input_mode is 'script'; must be absent when it is 'brief'."),
+    brief: briefInput.shape.brief.optional()
+        .describe("What the video is about; the narration is written from it. Required when input_mode is 'brief'; must be absent when it is 'script'."),
+    duration_seconds: common.duration_seconds
+        .describe("Selected length, 30 to 90 seconds, on a 1/25 s frame boundary. The video ends with its narration, runs at least 25 seconds and may exceed the selection by up to 5 seconds, never beyond 90 seconds. The charge never exceeds the quote. A script must fit this output range."),
+    style_reference: common.style_reference
+        .describe("Optional public https image whose visual style the scenes follow."),
+    character_reference: common.character_reference
+        .describe("Optional public https image of a person or figure to keep consistent across scenes."),
+    scene_images: common.scene_images
+        .describe("Optional images of your own, each placed at a word range or quote of the narration."),
+    captions: common.captions.describe("Burned-in captions; on by default."),
+};
+const wordTiming = z.object({
+    word: z.string().trim().min(1),
+    startSec: z.number().nonnegative(),
+    endSec: z.number().positive(),
+}).strict().refine((word) => word.endSec > word.startSec);
+export const facelessPlannerInput = z.object({
+    script: z.string().trim().min(1),
+    outputFrames: z.number().int().min(FACELESS_MIN_OUTPUT_FRAMES).max(2250),
+    captions: z.boolean(),
+    words: z.array(wordTiming).min(1),
+}).strict();
+export const facelessQuoteResponse = facelessQuote.extend({
+    skill: z.literal("make_faceless"),
+    warnings: z.array(z.string()).default([]),
+    contract_version: z.string().min(1),
+}).strict();
+//# sourceMappingURL=faceless-public.js.map

package/dist/faceless-public.js.map

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

package/dist/faceless-storyboard-v2-timing.d.ts

@@ -48,5 +48,16 @@ export type StoryboardV2FramePlan = {
         cuts: number;
     };
 };
+declare const semantic: {
+    readonly place: 4;
+    readonly reveal: 4;
+    readonly action: 3;
+    readonly emphasis: 1;
+};
+/** Shared semantic objective; duration feasibility belongs to each profile. */
+export declare function facelessCutScore(reason: keyof typeof semantic | null, duration: number, range: {
+    p25: number | null;
+    p75: number | null;
+}): Score;
 export declare function planStoryboardV2(input: StoryboardV2Proposal, words: readonly WordTiming[], narrationStartFrame: number, style: CutStyleProfile): StoryboardV2FramePlan;
 export {};

package/dist/faceless-storyboard-v2-timing.js

@@ -4,6 +4,14 @@ const semantic = { place: 4, reveal: 4, action: 3, emphasis: 1 };
 const CUT_COST = 2;
 const OUTPUT_FRAMES = 1522;
 const FPS = 25;
+/** Shared semantic objective; duration feasibility belongs to each profile. */
+export function facelessCutScore(reason, duration, range) {
+    const value = reason === null ? 0 : semantic[reason];
+    const cost = reason === null ? 0 : CUT_COST;
+    const distance = duration < range.p25 ? range.p25 - duration : duration > range.p75 ? duration - range.p75 : 0;
+    const penalty = 0.25 * distance / FPS;
+    return { semanticValue: value, cutCost: cost, pacePenalty: penalty, net: value - cost - penalty };
+}
 function better(a, b) {
     if (!b)
         return true;
@@ -55,8 +63,7 @@ export function planStoryboardV2(input, words, narrationStartFrame, style) {
         const phaseRange = style.pacing.by_phase[phase];
         const range = phaseRange && phaseRange.n > 0 ? phaseRange : style.pacing.global_image_frames;
         const duration = nodes[end].frame - nodes[start].frame;
-        const distance = duration < range.p25 ? range.p25 - duration : duration > range.p75 ? duration - range.p75 : 0;
-        return 0.25 * distance / 25;
+        return facelessCutScore(null, duration, range).pacePenalty;
     }
     for (let end = 1; end <= final; end++) {
         const destination = nodes[end];