@clipwright/core 0.34.0 → 0.36.0

package/dist/parts-pricing.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import { type FaceBillingInterval, type PartsFaceTariff, type PresenterEngine } from "./face-billing.js";
+export declare const PARTS_PRICING_VERSION = "parts-v2";
+/** Credits per second a presenter is in the video, covered or not, by the engine that rendered the take. */
+export declare const PRESENTER_CREDITS_PER_SECOND: Readonly<Record<PresenterEngine, number>>;
+/** Voice and render, per second of the finished video. */
+export declare 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 declare const LIVE_AVATAR_STILL_CREDITS = 400;
+/** The least a delivered video costs. */
+export declare const DELIVERED_VIDEO_MINIMUM_CREDITS = 50;
+export declare const PRESENTER_ENGINE_LABELS: Readonly<Record<PresenterEngine, string>>;
+/** The long-form run's tariff, frozen at admission like long-form-v1 before it. */
+export declare const PARTS_FACE_TARIFF: PartsFaceTariff;
+/** The face tariffs new runs are admitted on, as a LIST: public text walks it, so another tariff cannot ship silently. */
+export declare const FACE_BILLING_TARIFFS: readonly PartsFaceTariff[];
+/** 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 declare const durationPartsTariffSchema: z.ZodReadonly<z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    pricingVersion: z.ZodString;
+    presenterCreditsPerSecond: z.ZodReadonly<z.ZodObject<{
+        heygen: z.ZodNumber;
+        omnihuman: z.ZodNumber;
+    }, z.core.$strict>>;
+    productionCreditsPerSecond: z.ZodNumber;
+    minimumCredits: z.ZodNumber;
+}, z.core.$strict>>;
+export type DurationPartsTariff = z.infer<typeof durationPartsTariffSchema>;
+export declare const PARTS_DURATION_TARIFF: DurationPartsTariff;
+/** One line of an itemized price: what was counted, how many, at what rate, and the product. */
+export declare const partsLineSchema: z.ZodObject<{
+    label: z.ZodString;
+    unit: z.ZodEnum<{
+        face_second: "face_second";
+        second: "second";
+        still: "still";
+    }>;
+    quantity: z.ZodNumber;
+    unit_credits: z.ZodNumber;
+    credits: z.ZodNumber;
+}, z.core.$strict>;
+export type PartsLine = z.infer<typeof partsLineSchema>;
+export interface PartsCharge {
+    lines: PartsLine[];
+    /** The lines added up, before the minimum. */
+    usageCredits: number;
+    credits: number;
+    minimumApplied: boolean;
+    /** Presenter frames over all engines, an overlap counted once. */
+    faceFrames: number;
+    billableFaceSeconds: number;
+}
+export interface PartsMeasure {
+    /** Each engine's presenter intervals: a take's whole slot, covered or not. */
+    presenter: Partial<Record<PresenterEngine, readonly FaceBillingInterval[]>>;
+    outputFrames: number;
+    fps: number;
+    liveAvatarStills: number;
+}
+/** 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 declare function calculatePartsCharge(measure: PartsMeasure, tariffInput: PartsFaceTariff, delivered: boolean): PartsCharge;
+/** 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 declare function calculateDurationPartsCharge(durationSec: number, engine: PresenterEngine, tariffInput: DurationPartsTariff, delivered: boolean): PartsCharge;
+/** What a delivered parts-tariff video records about its price. */
+export declare const partsBillingSummarySchema: z.ZodReadonly<z.ZodObject<{
+    pricingVersion: z.ZodString;
+    lines: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        unit: z.ZodEnum<{
+            face_second: "face_second";
+            second: "second";
+            still: "still";
+        }>;
+        quantity: z.ZodNumber;
+        unit_credits: z.ZodNumber;
+        credits: z.ZodNumber;
+    }, z.core.$strict>>;
+    minimumCredits: z.ZodNumber;
+    minimumApplied: z.ZodBoolean;
+    actualDurationSec: z.ZodNumber;
+    finalCreditsCharged: z.ZodNumber;
+}, z.core.$strict>>;
+export type PartsBillingSummary = z.infer<typeof partsBillingSummarySchema>;

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: one tariff for short and long make_ugc.
+// parts-v2: the HeyGen second 12 → 9; parts-v1, long-form-v1 and 30 a second stay with their snapshots.
+export const PARTS_PRICING_VERSION = "parts-v2";
+/** Credits per second a presenter is in the video, covered or not, by the engine that rendered the take. */
+export const PRESENTER_CREDITS_PER_SECOND = Object.freeze({ heygen: 9, 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 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 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 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: 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;