@clipwright/core 0.34.0 → 0.35.0

package/dist/parts-pricing.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import { identifier, partsFaceTariffSchema, presenterRatesSchema, PRESENTER_ENGINES, } from "./face-billing.js";
+import { unionFaceFrames } from "./long-form-pricing.js";
+// Parts prices (owner, 29.10, #800): ×2.5 over our cost at the largest pack's credit ($50 for 6000), payment fees inside.
+// One tariff for short and long make_ugc; it replaces 30 credits a second and long-form-v1's 10 a face-second with 400 at least.
+export const PARTS_PRICING_VERSION = "parts-v1";
+/** Credits per second a presenter is in the video, covered or not (owner 22.10), by the engine that rendered the take. */
+export const PRESENTER_CREDITS_PER_SECOND = Object.freeze({ heygen: 12, omnihuman: 22 });
+/** Voice and render, per second of the finished video. */
+export const PRODUCTION_CREDITS_PER_SECOND = 1;
+/** A call scene's live avatar: one HeyGen photo avatar of the still, per still in the delivered video. */
+export const LIVE_AVATAR_STILL_CREDITS = 400;
+/** The least a delivered video costs. */
+export const DELIVERED_VIDEO_MINIMUM_CREDITS = 50;
+export const PRESENTER_ENGINE_LABELS = Object.freeze({
+    heygen: "presenter, HeyGen Avatar IV", omnihuman: "presenter, OmniHuman 2.0",
+});
+/** The long-form run's tariff, frozen at admission in `run_billing_terms` like long-form-v1 before it. */
+export const PARTS_FACE_TARIFF = Object.freeze({
+    version: 3, pricingVersion: PARTS_PRICING_VERSION, presenterCreditsPerSecond: PRESENTER_CREDITS_PER_SECOND,
+    productionCreditsPerSecond: PRODUCTION_CREDITS_PER_SECOND, liveAvatarStillCredits: LIVE_AVATAR_STILL_CREDITS,
+    minimumCredits: DELIVERED_VIDEO_MINIMUM_CREDITS, rounding: "ceil_aggregate_seconds", failurePolicy: "verified_delivery_only",
+});
+/** The face tariffs new runs are admitted on, as a LIST: public text walks it, so another tariff cannot ship silently. */
+export const FACE_BILLING_TARIFFS = Object.freeze([PARTS_FACE_TARIFF]);
+/** A short run's tariff: one take, so the presenter is in every second of the video. Its failures keep the short run's outcomes. */
+export const durationPartsTariffSchema = z.object({
+    version: z.literal(1),
+    pricingVersion: identifier,
+    presenterCreditsPerSecond: presenterRatesSchema,
+    productionCreditsPerSecond: z.number().int().nonnegative().max(2_147_483_647),
+    minimumCredits: z.number().int().nonnegative().max(2_147_483_647),
+}).strict().readonly();
+export const PARTS_DURATION_TARIFF = Object.freeze({
+    version: 1, pricingVersion: PARTS_PRICING_VERSION, presenterCreditsPerSecond: PRESENTER_CREDITS_PER_SECOND,
+    productionCreditsPerSecond: PRODUCTION_CREDITS_PER_SECOND, minimumCredits: DELIVERED_VIDEO_MINIMUM_CREDITS,
+});
+/** One line of an itemized price: what was counted, how many, at what rate, and the product. */
+export const partsLineSchema = z.object({
+    label: z.string().min(1),
+    unit: z.enum(["face_second", "second", "still"]),
+    quantity: z.number().int().nonnegative(),
+    unit_credits: z.number().int().nonnegative(),
+    credits: z.number().int().nonnegative(),
+}).strict();
+const MAX_CREDITS = 2147483647n;
+function settle(lines, minimum, delivered, faceFrames, billableFaceSeconds) {
+    const usage = lines.reduce((sum, line) => sum + BigInt(line.credits), 0n);
+    // The minimum is per DELIVERED video: a failed run that still bills is charged its parts only.
+    const minimumApplied = delivered && usage < BigInt(minimum);
+    const credits = minimumApplied ? BigInt(minimum) : usage;
+    if (credits > MAX_CREDITS)
+        throw new RangeError("parts billing credit overflow");
+    return { lines, usageCredits: Number(usage), credits: Number(credits), minimumApplied, faceFrames, billableFaceSeconds };
+}
+function line(label, unit, quantity, unitCredits) {
+    const credits = quantity * BigInt(unitCredits);
+    if (credits > MAX_CREDITS)
+        throw new RangeError("parts billing credit overflow");
+    return { label, unit, quantity: Number(quantity), unit_credits: unitCredits, credits: Number(credits) };
+}
+const ceilSeconds = (frames, fps) => (frames + fps - 1n) / fps;
+/** A long-form video's price under a parts tariff: each engine's presenter seconds rounded up once over the video, every */
+/** second of the video, each witnessed still; the minimum when delivered. Failure policy is settlement's, not this function's. */
+export function calculatePartsCharge(measure, tariffInput, delivered) {
+    const tariff = partsFaceTariffSchema.parse(tariffInput);
+    const fps = BigInt(z.number().int().positive().max(Number.MAX_SAFE_INTEGER).parse(measure.fps));
+    const outputFrames = BigInt(z.number().int().positive().max(Number.MAX_SAFE_INTEGER).parse(measure.outputFrames));
+    const stills = BigInt(z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER).parse(measure.liveAvatarStills));
+    const lines = [];
+    let billableFaceSeconds = 0n;
+    for (const engine of PRESENTER_ENGINES) {
+        const intervals = measure.presenter[engine];
+        if (intervals === undefined || intervals.length === 0)
+            continue;
+        const seconds = ceilSeconds(unionFaceFrames(intervals), fps);
+        billableFaceSeconds += seconds;
+        lines.push(line(PRESENTER_ENGINE_LABELS[engine], "face_second", seconds, tariff.presenterCreditsPerSecond[engine]));
+    }
+    lines.push(line("production (voice and render)", "second", ceilSeconds(outputFrames, fps), tariff.productionCreditsPerSecond));
+    if (stills > 0n)
+        lines.push(line("live avatar on a call", "still", stills, tariff.liveAvatarStillCredits));
+    const faceFrames = unionFaceFrames(PRESENTER_ENGINES.flatMap((engine) => [...(measure.presenter[engine] ?? [])]));
+    return settle(lines, tariff.minimumCredits, delivered, Number(faceFrames), Number(billableFaceSeconds));
+}
+/** A short video's price: the presenter is in every second of its one take. Rounding is the legacy rule: whole seconds, at least one. */
+export function calculateDurationPartsCharge(durationSec, engine, tariffInput, delivered) {
+    const tariff = durationPartsTariffSchema.parse(tariffInput);
+    if (!Number.isFinite(durationSec) || durationSec < 0)
+        throw new RangeError("duration must be a finite, non-negative number of seconds");
+    const seconds = BigInt(Math.max(1, Math.ceil(durationSec)));
+    const lines = [line(PRESENTER_ENGINE_LABELS[engine], "face_second", seconds, tariff.presenterCreditsPerSecond[engine]),
+        line("production (voice and render)", "second", seconds, tariff.productionCreditsPerSecond)];
+    return settle(lines, tariff.minimumCredits, delivered, 0, Number(seconds));
+}
+/** What a delivered parts-tariff video records about its price. */
+export const partsBillingSummarySchema = z.object({
+    pricingVersion: identifier,
+    lines: z.array(partsLineSchema),
+    minimumCredits: z.number().int().nonnegative(),
+    minimumApplied: z.boolean(),
+    actualDurationSec: z.number().positive().max(Number.MAX_SAFE_INTEGER),
+    finalCreditsCharged: z.number().int().nonnegative(),
+}).strict().readonly();
+//# sourceMappingURL=parts-pricing.js.map

package/dist/parts-pricing.js.map

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

package/dist/presenter-beats.d.ts

@@ -0,0 +1,45 @@
+import type { GenerateVideoRequest, GenerationReference } from "./generations.js";
+import type { ReferenceProfile } from "./reference-profile.js";
+import type { UgcInsert, UgcTemplate } from "./skills.js";
+/** Silent presenter beats of a reference (#857 S3): the presenter listens or reacts while the narration goes on. */
+/** A beat is a seedance-2.0 clip whose first frame is the actor portrait, placed as a video insert on its words. */
+export declare const PRESENTER_BEAT_BEHAVIOURS: readonly ["listening", "reacting"];
+export type PresenterBeatBehaviour = (typeof PRESENTER_BEAT_BEHAVIOURS)[number];
+/** The seedance-2.0 row both routes measured live: 720p 9:16, 4–15 s (`GENERATION_CAPABILITIES`). */
+export declare const PRESENTER_BEAT_MODEL = "seedance-2.0";
+export declare const PRESENTER_BEAT_MIN_SEC = 4;
+export declare function presenterBeatPrompt(behaviour: PresenterBeatBehaviour): string;
+/** Long enough for the words at the slowest speech the admission assumes; the insert cuts the rest where its words end. */
+export declare function presenterBeatSeconds(words: number): number;
+export interface PresenterBeat {
+    id: string;
+    beatIndex: number;
+    behaviour: PresenterBeatBehaviour;
+    /** Script words as make_ugc counts them; `endWord` is exclusive. */
+    startWord: number;
+    endWord: number;
+    durationS: number;
+    prompt: string;
+}
+/** The profile's listening and reacting beats on their script spans, one span per profile beat (null: no words). */
+export declare function planPresenterBeats(input: {
+    script: string;
+    profile: Pick<ReferenceProfile, "beats">;
+    spans: readonly ({
+        start: number;
+        end: number;
+    } | null)[];
+}): {
+    beats: PresenterBeat[];
+    warnings: string[];
+};
+/** Over-presenter templates that meet a beat move to the free words right before it, else right after, else are dropped and named. */
+/** A full-frame template stays: it is drawn over inserts. */
+export declare function fitTemplatesAroundBeats(script: string, templates: readonly UgcTemplate[], beats: readonly PresenterBeat[]): {
+    templates: UgcTemplate[];
+    warnings: string[];
+};
+/** The generate_video request of one beat: frame 0 is the actor portrait, so the identity is the portrait's. */
+export declare function presenterBeatGeneration(beat: PresenterBeat, portrait: GenerationReference): GenerateVideoRequest;
+/** The beat as a video insert over the narration: it starts on its first word and ends where its last word ends. */
+export declare function presenterBeatInsert(beat: PresenterBeat, assetId: string): UgcInsert;

package/dist/presenter-beats.js

@@ -0,0 +1,144 @@
+import { WORDS_PER_SECOND_MIN } from "./pacing.js";
+import { lexicalTokens, quoteOccurrences } from "./semantic-inserts.js";
+import { TEMPLATE_KINDS, templateFieldValues } from "./templates/index.js";
+/** Silent presenter beats of a reference (#857 S3): the presenter listens or reacts while the narration goes on. */
+/** A beat is a seedance-2.0 clip whose first frame is the actor portrait, placed as a video insert on its words. */
+export const PRESENTER_BEAT_BEHAVIOURS = ["listening", "reacting"];
+/** The seedance-2.0 row both routes measured live: 720p 9:16, 4–15 s (`GENERATION_CAPABILITIES`). */
+export const PRESENTER_BEAT_MODEL = "seedance-2.0";
+export const PRESENTER_BEAT_MIN_SEC = 4;
+const PRESENTER_BEAT_MAX_SEC = 15;
+const KEEP = "Same person, same face, hair, clothes, props and room as the first frame. Locked-off camera, vertical UGC video, " +
+    "natural light, realistic skin.";
+/** An open-mouth surprise under a voiceover reads as broken lip-sync (24.10 probe): every action is asked closed-mouthed. */
+const SILENT = "The person never speaks: the mouth stays closed or in a closed-lip smile the whole time, even when surprised. " +
+    "No talking, no lip movement, no captions, no text overlays.";
+const ACTIONS = {
+    listening: "The person lifts a smartphone to the ear with one hand and listens silently to a caller, giving a few small nods, " +
+        "eyes alive and attentive, brows reacting slightly to what they hear.",
+    reacting: "The person glances to the side, the eyebrows rise in quiet closed-mouth surprise, then the face relaxes into a pleased " +
+        "closed-lip smile; they look straight at the camera and give a small thumbs-up.",
+};
+export function presenterBeatPrompt(behaviour) {
+    return `${KEEP} ${ACTIONS[behaviour]} ${SILENT}`;
+}
+/** Long enough for the words at the slowest speech the admission assumes; the insert cuts the rest where its words end. */
+export function presenterBeatSeconds(words) {
+    return Math.min(PRESENTER_BEAT_MAX_SEC, Math.max(PRESENTER_BEAT_MIN_SEC, Math.ceil(words / WORDS_PER_SECOND_MIN)));
+}
+/** The profile's listening and reacting beats on their script spans, one span per profile beat (null: no words). */
+export function planPresenterBeats(input) {
+    const words = lexicalTokens(input.script).length;
+    if (input.spans.length !== input.profile.beats.length)
+        throw new Error("presenter beats need one span per profile beat");
+    const beats = [];
+    const warnings = [];
+    input.profile.beats.forEach((beat, beatIndex) => {
+        const behaviour = beat.presenter_behaviour;
+        if (!PRESENTER_BEAT_BEHAVIOURS.includes(behaviour))
+            return;
+        const span = input.spans[beatIndex];
+        if (!span) {
+            warnings.push(`beat ${beatIndex} (${behaviour}) has no words in the script, so the presenter does not ${behaviour === "listening" ? "listen" : "react"} there`);
+            return;
+        }
+        if (!Number.isSafeInteger(span.start) || !Number.isSafeInteger(span.end) || span.start < 0 || span.end <= span.start || span.end > words) {
+            throw new Error(`beat ${beatIndex} span ${span.start}..${span.end} is outside the ${words} script words`);
+        }
+        const previous = beats.at(-1);
+        if (previous && span.start < previous.endWord)
+            throw new Error(`beat ${beatIndex} overlaps the beat before it`);
+        const count = span.end - span.start;
+        if (count / WORDS_PER_SECOND_MIN > PRESENTER_BEAT_MAX_SEC) {
+            warnings.push(`beat ${beatIndex} (${behaviour}) may outlast a ${PRESENTER_BEAT_MAX_SEC} s clip; its last frame holds to the end of its words`);
+        }
+        beats.push({ id: `beat-${beatIndex}`, beatIndex, behaviour: behaviour, startWord: span.start, endWord: span.end,
+            durationS: presenterBeatSeconds(count), prompt: presenterBeatPrompt(behaviour) });
+    });
+    if (beats.length && beats[0].startWord === 0 && beats.at(-1).endWord === words && beats.every((beat, i) => i === 0 || beat.startWord === beats[i - 1].endWord)) {
+        throw new Error("presenter beats cover every word and leave the speaking presenter no shot");
+    }
+    return { beats, warnings };
+}
+/** A beat's insert is a cutaway: an over-presenter template under it would be refused, so it moves next to the beat. */
+const MIN_TEMPLATE_WORDS = 2;
+function templateSpan(tokens, template) {
+    const anchor = template.anchor;
+    const range = "startWord" in anchor ? anchor : quoteOccurrences(tokens, anchor.quote)[anchor.occurrence ?? 0];
+    if (!range)
+        return null;
+    return { start: range.startWord, end: template.cover_words === undefined ? range.endWord : range.startWord + template.cover_words };
+}
+/** The template moved onto `span`: anchored on those words, its inner quotes spread over them in order. */
+function moved(template, tokens, span) {
+    const { cover_words: _cover, ...rest } = template;
+    let data = structuredClone(template.data);
+    const fields = TEMPLATE_KINDS.find(kind => kind.kind === template.kind)?.quotes ?? [];
+    const values = fields.flatMap(field => templateFieldValues(data, field));
+    let from = span.start;
+    values.forEach(({ path }, index) => {
+        const target = Math.max(from, span.start + Math.floor(((index + 0.5) * (span.end - span.start)) / values.length));
+        // The shortest phrase from `target` whose first match inside the span, after the previous one, is `target` itself.
+        let length = 1;
+        while (target + length < span.end && quoteOccurrences(tokens.slice(from, span.end), tokens.slice(target, target + length).join(" "))[0]
+            .startWord + from !== target)
+            length += 1;
+        data = setAt(data, path, tokens.slice(target, target + length).join(" "));
+        from = target + length;
+    });
+    return { ...rest, anchor: { startWord: span.start, endWord: span.end }, data };
+}
+function setAt(data, path, value) {
+    const [head, ...tail] = path;
+    if (head === undefined)
+        return data;
+    const copy = Array.isArray(data) ? [...data] : { ...data };
+    copy[head] = tail.length ? setAt(data[head], tail, value) : value;
+    return copy;
+}
+/** Over-presenter templates that meet a beat move to the free words right before it, else right after, else are dropped and named. */
+/** A full-frame template stays: it is drawn over inserts. */
+export function fitTemplatesAroundBeats(script, templates, beats) {
+    const tokens = lexicalTokens(script);
+    const spans = templates.map(template => templateSpan(tokens, template));
+    const busy = (word, self) => beats.some(beat => word >= beat.startWord && word < beat.endWord) ||
+        spans.some((span, index) => index !== self && span !== null && word >= span.start && word < span.end);
+    const warnings = [];
+    const out = [];
+    templates.forEach((template, index) => {
+        const span = spans[index];
+        const placement = template.placement ?? TEMPLATE_KINDS.find(kind => kind.kind === template.kind)?.placements[0];
+        const beat = span && placement !== "full" && beats.find(one => span.start < one.endWord && span.end > one.startWord);
+        if (!span || !beat) {
+            out.push(template);
+            return;
+        }
+        const want = Math.max(MIN_TEMPLATE_WORDS, span.end - span.start);
+        let before = beat.startWord;
+        while (before > 0 && beat.startWord - before < want && !busy(before - 1, index))
+            before -= 1;
+        let after = beat.endWord;
+        while (after < tokens.length && after - beat.endWord < want && !busy(after, index))
+            after += 1;
+        const room = beat.startWord - before >= MIN_TEMPLATE_WORDS ? { start: before, end: beat.startWord }
+            : after - beat.endWord >= MIN_TEMPLATE_WORDS ? { start: beat.endWord, end: after } : null;
+        if (!room) {
+            warnings.push(`template "${template.id}" lies under the ${beat.behaviour} beat and has no free words beside it; it is left out`);
+            return;
+        }
+        spans[index] = room;
+        out.push(moved(template, tokens, room));
+        warnings.push(`template "${template.id}" moved to the words ${room.end === beat.startWord ? "right before" : "right after"} the ${beat.behaviour} beat, which covers its own`);
+    });
+    return { templates: out, warnings };
+}
+/** The generate_video request of one beat: frame 0 is the actor portrait, so the identity is the portrait's. */
+export function presenterBeatGeneration(beat, portrait) {
+    return { prompt: beat.prompt, model: PRESENTER_BEAT_MODEL, mode: "first_frame", aspect_ratio: "9:16", resolution: "720p",
+        duration_s: beat.durationS, first_frame: portrait };
+}
+/** The beat as a video insert over the narration: it starts on its first word and ends where its last word ends. */
+export function presenterBeatInsert(beat, assetId) {
+    return { id: beat.id, asset_id: assetId, media_type: "video", anchor: { startWord: beat.startWord, endWord: beat.endWord } };
+}
+//# sourceMappingURL=presenter-beats.js.map

package/dist/presenter-beats.js.map

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

package/dist/prices.d.ts

@@ -0,0 +1,98 @@
+import { z } from "zod";
+/** The public price list (#927): every number is read from the constant billing charges by, never typed here. */
+export declare const PRICES_PATH = "/v1/public/prices";
+export declare const PRICE_UNITS: readonly ["call", "second", "face_second", "image", "clip", "clip_second", "still"];
+export type PriceUnit = (typeof PRICE_UNITS)[number];
+/** One part of a price: credits per unit. A price of several parts adds them, then applies the entry's minimum. */
+export declare const priceEntryLine: z.ZodObject<{
+    label: z.ZodNullable<z.ZodString>;
+    unit: z.ZodEnum<{
+        call: "call";
+        clip: "clip";
+        clip_second: "clip_second";
+        face_second: "face_second";
+        image: "image";
+        second: "second";
+        still: "still";
+    }>;
+    credits: z.ZodNumber;
+}, z.core.$strict>;
+export type PriceEntryLine = z.infer<typeof priceEntryLine>;
+export declare const priceEntry: z.ZodObject<{
+    action: z.ZodString;
+    tool: z.ZodNullable<z.ZodString>;
+    route: z.ZodNullable<z.ZodString>;
+    variant: z.ZodNullable<z.ZodString>;
+    lines: z.ZodArray<z.ZodObject<{
+        label: z.ZodNullable<z.ZodString>;
+        unit: z.ZodEnum<{
+            call: "call";
+            clip: "clip";
+            clip_second: "clip_second";
+            face_second: "face_second";
+            image: "image";
+            second: "second";
+            still: "still";
+        }>;
+        credits: z.ZodNumber;
+    }, z.core.$strict>>;
+    formula: z.ZodNullable<z.ZodString>;
+    minimum_credits: z.ZodNullable<z.ZodNumber>;
+    quote_tool: z.ZodNullable<z.ZodString>;
+    notes: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type PriceEntry = z.infer<typeof priceEntry>;
+export declare const pricesResponse: z.ZodObject<{
+    prices: z.ZodArray<z.ZodObject<{
+        action: z.ZodString;
+        tool: z.ZodNullable<z.ZodString>;
+        route: z.ZodNullable<z.ZodString>;
+        variant: z.ZodNullable<z.ZodString>;
+        lines: z.ZodArray<z.ZodObject<{
+            label: z.ZodNullable<z.ZodString>;
+            unit: z.ZodEnum<{
+                call: "call";
+                clip: "clip";
+                clip_second: "clip_second";
+                face_second: "face_second";
+                image: "image";
+                second: "second";
+                still: "still";
+            }>;
+            credits: z.ZodNumber;
+        }, z.core.$strict>>;
+        formula: z.ZodNullable<z.ZodString>;
+        minimum_credits: z.ZodNullable<z.ZodNumber>;
+        quote_tool: z.ZodNullable<z.ZodString>;
+        notes: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type PricesResponse = z.infer<typeof pricesResponse>;
+/** What a client reads: a unit or a field it does not know yet must not break it. */
+export declare const pricesResponseRead: z.ZodObject<{
+    prices: z.ZodArray<z.ZodObject<{
+        action: z.ZodString;
+        tool: z.ZodNullable<z.ZodString>;
+        route: z.ZodNullable<z.ZodString>;
+        variant: z.ZodNullable<z.ZodString>;
+        lines: z.ZodArray<z.ZodObject<{
+            label: z.ZodNullable<z.ZodString>;
+            unit: z.ZodString;
+            credits: z.ZodNumber;
+        }, z.core.$loose>>;
+        formula: z.ZodNullable<z.ZodString>;
+        minimum_credits: z.ZodNullable<z.ZodNumber>;
+        quote_tool: z.ZodNullable<z.ZodString>;
+        notes: z.ZodNullable<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type PricesResponseRead = z.infer<typeof pricesResponseRead>;
+/** Whether calling the entry's action may cost credits. */
+export declare const isPaidEntry: (entry: PriceEntry) => boolean;
+export declare const PRICE_LIST: readonly PriceEntry[];
+/** One entry's price in words: its lines added up and its minimum, or its formula. */
+export declare const priceText: (entry: PriceEntry) => string;
+/** The price sentence a billed tool's description ends with; `null` for a free tool. */
+export declare function priceLine(tool: string, list?: readonly PriceEntry[]): string | null;
+/** A billed tool's description with its price line at the end. */
+export declare const withPriceLine: (tool: string, description: string, list?: readonly PriceEntry[]) => string;

package/dist/prices.js

@@ -0,0 +1,189 @@
+import { z } from "zod";
+import { ACTOR_PORTRAIT_ASPECT, ACTOR_UNIT_CREDITS } from "./account-actors.js";
+import { CANDIDATE_CHARGE_TEXT } from "./edit-candidate.js";
+import { EDIT_RENDER_PRICE, EDIT_UNIT_PRICES, EDIT_ZERO_UNIT_PRICE } from "./edit-billing.js";
+import { REVISION_CHARGE_TEXT } from "./edit-revision.js";
+import { FACELESS_CREDITS_PER_1500_FRAMES, FACELESS_IMAGE_CREDITS, FACELESS_MAX_SELECTED_SECONDS, FACELESS_MIN_BASE_CREDITS, FACELESS_MIN_SELECTED_SECONDS, FACELESS_OPENER_CREDITS, quoteFaceless, } from "./faceless-price.js";
+import { PRESENTER_ENGINES } from "./face-billing.js";
+import { listGenerationModels } from "./generations.js";
+import { PARTS_FACE_TARIFF, PRESENTER_ENGINE_LABELS } from "./parts-pricing.js";
+import { REFERENCE_ANALYSIS_CREDITS } from "./reference-analysis.js";
+/** The public price list (#927): every number is read from the constant billing charges by, never typed here. */
+export const PRICES_PATH = "/v1/public/prices";
+export const PRICE_UNITS = ["call", "second", "face_second", "image", "clip", "clip_second", "still"];
+/** One part of a price: credits per unit. A price of several parts adds them, then applies the entry's minimum. */
+export const priceEntryLine = z.strictObject({
+    label: z.string().min(1).nullable(),
+    unit: z.enum(PRICE_UNITS),
+    credits: z.number().int().nonnegative(),
+});
+export const priceEntry = z.strictObject({
+    action: z.string().min(1),
+    tool: z.string().min(1).nullable(),
+    /** The REST route as `endpointLabel` writes it. */
+    route: z.string().min(1).nullable(),
+    variant: z.string().min(1).nullable(),
+    /** Empty when the price is a formula the parts cannot state. */
+    lines: z.array(priceEntryLine),
+    formula: z.string().min(1).nullable(),
+    minimum_credits: z.number().int().positive().nullable(),
+    quote_tool: z.string().min(1).nullable(),
+    notes: z.string().min(1).nullable(),
+}).refine((entry) => entry.lines.length > 0 || entry.formula !== null, "an entry states lines or a formula");
+export const pricesResponse = z.strictObject({ prices: z.array(priceEntry).min(1) });
+/** What a client reads: a unit or a field it does not know yet must not break it. */
+export const pricesResponseRead = z.looseObject({ prices: z.array(z.looseObject({
+        action: z.string().min(1), tool: z.string().nullable(), route: z.string().nullable(), variant: z.string().nullable(),
+        lines: z.array(z.looseObject({ label: z.string().nullable(), unit: z.string().min(1), credits: z.number().int().nonnegative() })),
+        formula: z.string().nullable(), minimum_credits: z.number().int().positive().nullable(), quote_tool: z.string().nullable(),
+        notes: z.string().nullable(),
+    })) });
+/** Whether calling the entry's action may cost credits. */
+export const isPaidEntry = (entry) => entry.formula !== null || entry.lines.some((line) => line.credits > 0);
+const paid = (entry) => ({
+    action: entry.variant === undefined ? entry.tool : `${entry.tool} (${entry.variant})`,
+    tool: entry.tool, route: entry.route, variant: entry.variant ?? null,
+    lines: "credits" in entry ? [{ label: null, unit: entry.unit, credits: entry.credits }] : "lines" in entry ? entry.lines : [],
+    formula: "formula" in entry ? entry.formula : null,
+    minimum_credits: entry.minimum_credits ?? null, quote_tool: entry.quote_tool, notes: entry.notes ?? null,
+});
+/** Every free MCP tool and the route it calls. */
+const FREE_TOOLS = {
+    list_prices: `GET ${PRICES_PATH}`,
+    get_account: "GET /v1/account",
+    quote_ugc: "POST /v1/skills/make_ugc/quote",
+    quote_analysis: "POST /v1/reference-analyses/quote",
+    quote_faceless: "POST /v1/skills/make_faceless/quote",
+    quote_actor: "POST /v1/skills/create_actor/quote",
+    quote_image: "POST /v1/skills/generate_image/quote",
+    quote_video: "POST /v1/skills/generate_video/quote",
+    quote_revision: "POST /v1/runs/{id}/revisions/quote",
+    quote_candidate: "POST /v1/runs/{id}/candidates/quote",
+    quote_workflow_plan: "POST /v1/workflow-plans/{id}/quote",
+    get_run: "GET /v1/runs/{id}",
+    get_run_shots: "GET /v1/runs/{id}/shots",
+    list_voices: "GET /v1/voices",
+    list_template_sounds: "GET /v1/template-sounds",
+    list_generation_models: "GET /v1/generations/models",
+    list_actors: "GET /v1/actors",
+    delete_actor: "DELETE /v1/actors/{id}",
+    get_actor_defaults: "GET /v1/actors/{id}/defaults",
+    set_actor_defaults: "POST /v1/actors/{id}/defaults",
+    upload_image: "POST /v1/uploads/import",
+    create_upload: "POST /v1/uploads/intents",
+    get_upload: "GET /v1/uploads/{id}",
+    create_asset: "POST /v1/assets",
+    list_assets: "GET /v1/assets",
+    get_asset: "GET /v1/assets/{id}",
+    update_asset: "POST /v1/assets/{id}",
+    delete_asset: "DELETE /v1/assets/{id}",
+    get_reference_analysis: "GET /v1/reference-analyses/{id}",
+    list_workflows: "GET /v1/public/workflows",
+    get_workflow: "GET /v1/public/workflows/{id}",
+    prepare_workflow_plan: "POST /v1/workflow-plans",
+    plan_reference_remake: "POST /v1/workflow-plans/reference-remake",
+    get_workflow_plan: "GET /v1/workflow-plans/{id}",
+    approve_workflow_plan: "POST /v1/workflow-plans/{id}/approve",
+};
+const facelessAt = (seconds) => quoteFaceless({ outputFrames: seconds * 25, captions: true }).totalCredits;
+function generationEntries() {
+    return listGenerationModels().flatMap((model) => {
+        const video = model.kind === "video";
+        const groups = new Map();
+        for (const row of model.rows) {
+            const key = `${row.resolution}|${row.unit_credits}`;
+            const group = groups.get(key) ?? { size: row.resolution, credits: row.unit_credits, aspects: [] };
+            group.aspects.push(row.aspect_ratio);
+            groups.set(key, group);
+        }
+        const priced = [...groups.values()];
+        return priced.map((group) => {
+            const split = priced.filter((other) => other.size === group.size).length > 1;
+            const variant = [model.model, group.size, split ? group.aspects.join(", ") : null].filter((part) => part !== null).join(" ");
+            return paid(video
+                ? { tool: "generate_video", route: "POST /v1/skills/generate_video/run", variant, unit: "clip_second", credits: group.credits,
+                    quote_tool: "quote_video", notes: "Per second of the requested duration, charged once the clip is delivered." }
+                : { tool: "generate_image", route: "POST /v1/skills/generate_image/run", variant, unit: "image", credits: group.credits,
+                    quote_tool: "quote_image", notes: "Charged once the image is delivered." });
+        });
+    });
+}
+function buildPriceList() {
+    const unit = EDIT_UNIT_PRICES;
+    const parts = PARTS_FACE_TARIFF;
+    return [
+        ...PRESENTER_ENGINES.map((engine) => paid({ tool: "make_ugc", route: "POST /v1/skills/make_ugc/run",
+            variant: engine === "heygen" ? "HeyGen presenter" : "OmniHuman presenter", quote_tool: "quote_ugc", minimum_credits: parts.minimumCredits,
+            lines: [{ label: PRESENTER_ENGINE_LABELS[engine], unit: "face_second", credits: parts.presenterCreditsPerSecond[engine] },
+                { label: "production (voice and render)", unit: "second", credits: parts.productionCreditsPerSecond },
+                { label: "live avatar on a call", unit: "still", credits: parts.liveAvatarStillCredits }],
+            notes: "Short and long videos alike. Presenter seconds are the seconds a presenter take fills, covered by an insert, overlay, " +
+                "window or template or not, counted once over the video and rounded up; the engine that renders each take sets its rate " +
+                (engine === "heygen" ? "(today every take renders on HeyGen). " : "(no take renders on OmniHuman today). ") +
+                "Production seconds are every second of the finished video. A live avatar is charged per call still in the video." })),
+        paid({ tool: "analyze_reference", route: "POST /v1/reference-analyses", unit: "call", credits: REFERENCE_ANALYSIS_CREDITS,
+            quote_tool: "quote_analysis", notes: "Held at the start and charged once the analysis succeeds; a failed one costs nothing. " +
+                "Starting it again on the same asset answers the same analysis for free." }),
+        paid({ tool: "make_faceless", route: "POST /v1/skills/make_faceless/run", quote_tool: "quote_faceless",
+            lines: [{ label: "generated picture", unit: "image", credits: FACELESS_IMAGE_CREDITS },
+                { label: "opening clip", unit: "clip", credits: FACELESS_OPENER_CREDITS },
+                { label: "production (story, voice and render)", unit: "second", credits: FACELESS_CREDITS_PER_1500_FRAMES / 60 }],
+            minimum_credits: FACELESS_MIN_BASE_CREDITS,
+            notes: `Pictures we generated for the delivered video and its seconds, never above the selected length. The quote is the most a ` +
+                `selection is charged, every picture it may generate: ${facelessAt(FACELESS_MIN_SELECTED_SECONDS)} for ` +
+                `${FACELESS_MIN_SELECTED_SECONDS} s, ${facelessAt(FACELESS_MAX_SELECTED_SECONDS)} for ${FACELESS_MAX_SELECTED_SECONDS} s. ` +
+                "Captions do not change the price." }),
+        paid({ tool: "revise_run", route: "POST /v1/runs/{id}/revisions", quote_tool: "quote_revision",
+            formula: `each shot generated anew: picture ${unit.picture}, clip ${unit.clip}, clip with a new picture ${unit.clip_with_new_picture}; ` +
+                `plus ${EDIT_RENDER_PRICE} to render. A revision that generates nothing: ${EDIT_ZERO_UNIT_PRICE}. A kept candidate adds nothing`,
+            notes: REVISION_CHARGE_TEXT }),
+        ...[["picture", "image", unit.picture], ["clip", "clip", unit.clip], ["clip with a new picture", "clip", unit.clip_with_new_picture]]
+            .map(([variant, priceUnit, credits]) => paid({ tool: "create_candidate", route: "POST /v1/runs/{id}/candidates", variant,
+            unit: priceUnit, credits, quote_tool: "quote_candidate", notes: CANDIDATE_CHARGE_TEXT })),
+        ...Object.entries(ACTOR_UNIT_CREDITS).flatMap(([quality, credits]) => [
+            paid({ tool: "create_actor", route: "POST /v1/skills/create_actor/run", variant: `${quality} portrait`, unit: "image",
+                credits: credits.portrait, quote_tool: "quote_actor", notes: "Each published image; a refused description or an unusable portrait costs nothing." }),
+            paid({ tool: "create_actor", route: "POST /v1/skills/create_actor/run", variant: `${quality} other format`, unit: "image",
+                credits: credits.variant, quote_tool: "quote_actor", notes: `Each requested format besides the ${ACTOR_PORTRAIT_ASPECT} portrait, once published.` }),
+        ]),
+        ...generationEntries(),
+        paid({ tool: "run_workflow_plan", route: "POST /v1/workflow-plans/{id}/run", quote_tool: "quote_workflow_plan",
+            formula: "the price of the native run it starts, make_ugc or make_faceless, as its quote states it" }),
+        ...Object.entries(FREE_TOOLS).map(([tool, route]) => ({ action: tool, tool, route, variant: null,
+            lines: [{ label: null, unit: "call", credits: 0 }], formula: null, minimum_credits: null, quote_tool: null, notes: null })),
+    ];
+}
+export const PRICE_LIST = Object.freeze(pricesResponse.parse({ prices: buildPriceList() }).prices);
+const UNIT_TEXT = {
+    call: "call", second: "second of video", face_second: "second the presenter is in the video, covered or not", image: "image", clip: "clip",
+    clip_second: "second of clip", still: "call still in the video",
+};
+/** Past this many one-line prices of one unit, the sentence names their range and list_prices names each. */
+const LISTED_PRICES = 4;
+/** One entry's price in words: its lines added up and its minimum, or its formula. */
+export const priceText = (entry) => entry.lines.length === 0 ? entry.formula ?? "" :
+    entry.lines.map((line) => `${line.label === null ? "" : `${line.label} `}${line.credits} credits per ${UNIT_TEXT[line.unit]}`).join(" plus ") +
+        (entry.minimum_credits === null ? "" : `, at least ${entry.minimum_credits}`);
+/** The price sentence a billed tool's description ends with; `null` for a free tool. */
+export function priceLine(tool, list = PRICE_LIST) {
+    const entries = list.filter((entry) => entry.tool === tool && isPaidEntry(entry));
+    const [first] = entries;
+    if (first === undefined)
+        return null;
+    const unit = first.lines[0]?.unit;
+    const single = entries.flatMap((entry) => (entry.formula === null && entry.lines.length === 1 && entry.lines[0].unit === unit
+        ? [entry.lines[0].credits] : []));
+    const text = unit !== undefined && single.length === entries.length && single.length > LISTED_PRICES
+        ? `${Math.min(...single)} to ${Math.max(...single)} credits per ${UNIT_TEXT[unit]}, by model and size`
+        : entries.map((entry) => `${entry.variant === null ? "" : `${entry.variant}: `}${priceText(entry)}`)
+            .join("; ");
+    return `Price: ${text}. Quote first with ${first.quote_tool}; list_prices names every price.`;
+}
+/** A billed tool's description with its price line at the end. */
+export const withPriceLine = (tool, description, list = PRICE_LIST) => {
+    const line = priceLine(tool, list);
+    if (line === null)
+        throw new Error(`${tool} has no price in PRICE_LIST`);
+    return `${description} ${line}`;
+};
+//# sourceMappingURL=prices.js.map