@clipwright/core 0.33.0 → 0.35.0

package/dist/openapi.d.ts

@@ -0,0 +1,154 @@
+import { z } from "zod";
+import { type ApiEndpoint } from "./endpoints.js";
+/** `/openapi.json` (owner decision 2026-10-26): every registry route is marked public or excluded, and a */
+/** public route names its request and response schemas; API tests parse their real responses with them. */
+type SuccessStatus = 200 | 201 | 202 | 204;
+export interface NamedSchema {
+    readonly name: string;
+    readonly schema: z.ZodType;
+}
+export interface PublicRoute {
+    readonly exposure: "public";
+    readonly operationId: string;
+    readonly tag: OpenApiTag;
+    /** Answers without a key, before the auth and rate-limit middleware. */
+    readonly anonymous?: true;
+    readonly body?: NamedSchema | {
+        readonly mediaTypes: readonly string[];
+    };
+    readonly query?: z.ZodObject;
+    /** One schema per path parameter, the core id schema the handlers check; API tests prove no accepted id falls outside it. */
+    readonly params?: Readonly<Record<string, z.ZodType>>;
+    /** The route takes `Idempotency-Key` without requiring it; a billed route requires it unless it names `billedWithoutKey`. */
+    readonly optionalIdempotencyKey?: true;
+    /** Why a billed route needs no key: what makes a resend answer the first call instead of charging again. */
+    readonly billedWithoutKey?: string;
+    /** `null`: no body. A public route without a success response does not compile. */
+    readonly responses: Readonly<Partial<Record<SuccessStatus, NamedSchema | null>>> & ({
+        200: unknown;
+    } | {
+        201: unknown;
+    } | {
+        202: unknown;
+    } | {
+        204: unknown;
+    });
+}
+export interface ExcludedRoute {
+    readonly exposure: "excluded";
+    readonly reason: string;
+}
+export type OpenApiRoute = PublicRoute | ExcludedRoute;
+declare const TAGS: {
+    readonly Service: "The API host itself.";
+    readonly Skills: "Quote and start runs. A quote charges nothing; a run holds credits and answers at once.";
+    readonly Runs: "One namespace for every run: state, shots, drafts, revisions and shot candidates.";
+    readonly Workflows: "Workflow methods and account plans compiled into native runs.";
+    readonly Uploads: "Pictures you send for a run, kept for a limited time.";
+    readonly Assets: "Pictures and clips kept on the account until you delete them.";
+    readonly Actors: "Actors saved on the account and their defaults.";
+    readonly Catalogs: "Voices, template sounds, generation models, skills and prices.";
+    readonly "Reference analysis": "A reference video read into a profile a remake plan takes.";
+    readonly Account: "Balance, debt and holds.";
+};
+export type OpenApiTag = keyof typeof TAGS;
+/** The shared refusal (`docs/03-api.md` §6): `code` is a registered one, typed refusals add their own fields. */
+export declare const errorEnvelope: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            [x: string]: string;
+        }>;
+        message: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+/** Keyed by `endpointLabel`; the test proves the keys are exactly the registry's. */
+export declare const OPENAPI_ROUTES: Readonly<Record<string, OpenApiRoute>>;
+/** Registry order, public rows only. */
+export declare function publicOpenApiRoutes(): {
+    endpoint: ApiEndpoint;
+    route: PublicRoute;
+}[];
+/** `:id` in Hono notation is `{id}` in OpenAPI. */
+export declare const openApiOperationPath: (path: string) => string;
+/** The declared body of a success status: a schema, `null` for no body, `undefined` when undeclared. */
+export declare function openApiResponse(endpoint: ApiEndpoint, status: number): NamedSchema | null | undefined;
+type Json = Record<string, unknown>;
+/** Pure: the same document from the same code, so the API builds it once and serves it from memory. */
+export declare function buildOpenApiDocument(): {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        summary: string;
+        description: string;
+        contact: {
+            name: string;
+            url: string;
+        };
+    };
+    servers: {
+        url: string;
+    }[];
+    security: {
+        apiKey: never[];
+    }[];
+    tags: {
+        name: string;
+        description: "A reference video read into a profile a remake plan takes." | "Actors saved on the account and their defaults." | "Balance, debt and holds." | "One namespace for every run: state, shots, drafts, revisions and shot candidates." | "Pictures and clips kept on the account until you delete them." | "Pictures you send for a run, kept for a limited time." | "Quote and start runs. A quote charges nothing; a run holds credits and answers at once." | "The API host itself." | "Voices, template sounds, generation models, skills and prices." | "Workflow methods and account plans compiled into native runs.";
+    }[];
+    paths: Record<string, Record<string, Json>>;
+    components: {
+        securitySchemes: {
+            apiKey: {
+                type: string;
+                scheme: string;
+                bearerFormat: string;
+                description: string;
+            };
+        };
+        responses: {
+            Error: {
+                description: string;
+                content: {
+                    "application/json": {
+                        schema: {
+                            $ref: string;
+                        };
+                    };
+                };
+            };
+            Unauthorized: {
+                description: string;
+                content: {
+                    "application/json": {
+                        schema: {
+                            $ref: string;
+                        };
+                    };
+                };
+            };
+            RateLimited: {
+                description: string;
+                content: {
+                    "application/json": {
+                        schema: {
+                            $ref: string;
+                        };
+                    };
+                };
+                headers: {
+                    "Retry-After": {
+                        schema: {
+                            type: string;
+                            minimum: number;
+                        };
+                        description: string;
+                    };
+                };
+            };
+        };
+        schemas: Json;
+    };
+};
+export type OpenApiDocument = ReturnType<typeof buildOpenApiDocument>;
+export {};

package/dist/openapi.js

@@ -0,0 +1,334 @@
+import { createRequire } from "node:module";
+import { z } from "zod";
+import { createActorInput, createActorQuote, personalActorId } from "./account-actors.js";
+import { account } from "./account.js";
+import { actorsResponse } from "./actors.js";
+import { asset, assetId, ASSET_PUT_MEDIA_TYPES, assetBytesQuery, assetList, assetListQuery, createAssetRequest, pendingAsset, updateAssetRequest, } from "./assets.js";
+import { actorDefaults, actorDefaultsInput } from "./broll-policy.js";
+import { offeredUgcInput } from "./contract-dispositions.js";
+import { workflowCatalogResponse, workflowMethodResponse } from "./contracts/v1/workflow-catalog.js";
+import { launchWorkflow, workflowLaunchResponse, workflowQuoteBinding } from "./contracts/v1/workflow-execution.js";
+import { approveWorkflowPlan, createWorkflowPlan, saveWorkflowPlan, workflowPlanRead } from "./contracts/v1/workflow-plan.js";
+import { workflowId, workflowMethodId } from "./contracts/v1/workflow-primitives.js";
+import { workflowRun } from "./contracts/v1/workflow-run-read.js";
+import { candidateQuote, candidateRequest, runCandidates } from "./edit-candidate.js";
+import { runEdit, saveRunEdit } from "./edit-document.js";
+import { revisionQuote, revisionRequest } from "./edit-revision.js";
+import { runShots } from "./edit-shots.js";
+import { ENDPOINT_NOTES } from "./endpoint-notes.js";
+import { API_ERROR_CODES } from "./errors.js";
+import { API_ENDPOINTS, endpointLabel } from "./endpoints.js";
+import { facelessQuoteResponse } from "./faceless-public.js";
+import { generateImageRequest, generateVideoRequest, generationModels, generationQuote } from "./generations.js";
+import { pricesResponse } from "./prices.js";
+import { PUBLIC_API_BASE_URL, PUBLIC_APP_BASE_URL } from "./public-endpoints.js";
+import { healthResponse, publicSkillsResponse } from "./public-responses.js";
+import { analysisQuoteResponse, analyzeReferenceRequest, referenceAnalysis, referenceAnalysisId } from "./reference-analysis.js";
+import { runId } from "./runs.js";
+import { quoteResponse } from "./skills.js";
+import { templateSoundsList } from "./templates/sounds.js";
+import { UPLOAD_MEDIA_TYPES, uploadId, uploadImportRequest, uploadIntentRequest, uploadIntentResponse, uploadItemResponse, uploadList, uploadResponse, } from "./uploads.js";
+import { serverFacelessInput } from "./voice-admission.js";
+import { serverVoicesQuery } from "./voice-listing.js";
+import { voicesResponse } from "./voices.js";
+import { planReferenceRemake } from "./workflows/reference-remake.js";
+const named = (name, schema) => ({ name, schema });
+const TAGS = {
+    Service: "The API host itself.",
+    Skills: "Quote and start runs. A quote charges nothing; a run holds credits and answers at once.",
+    Runs: "One namespace for every run: state, shots, drafts, revisions and shot candidates.",
+    Workflows: "Workflow methods and account plans compiled into native runs.",
+    Uploads: "Pictures you send for a run, kept for a limited time.",
+    Assets: "Pictures and clips kept on the account until you delete them.",
+    Actors: "Actors saved on the account and their defaults.",
+    Catalogs: "Voices, template sounds, generation models, skills and prices.",
+    "Reference analysis": "A reference video read into a profile a remake plan takes.",
+    Account: "Balance, debt and holds.",
+};
+/** The shared refusal (`docs/03-api.md` §6): `code` is a registered one, typed refusals add their own fields. */
+export const errorEnvelope = z.object({
+    error: z.looseObject({ code: z.enum(API_ERROR_CODES), message: z.string().min(1) }),
+});
+const Run = named("Run", workflowRun);
+// Strict: the API refuses a key outside the offered fields (`unknown_field`) before the schema runs.
+const MakeUgcInput = named("MakeUgcInput", offeredUgcInput.strict());
+const RAW_UPLOAD = { mediaTypes: UPLOAD_MEDIA_TYPES };
+const AssetItem = named("AssetItem", z.union([asset, pendingAsset]));
+const RUN = { id: runId };
+const ACTOR = { id: personalActorId };
+const ASSET = { id: assetId };
+const PLAN = { id: workflowId };
+const openApiDocumentShape = z.looseObject({ openapi: z.string(), info: z.looseObject({}), paths: z.record(z.string(), z.unknown()) });
+/** Keyed by `endpointLabel`; the test proves the keys are exactly the registry's. */
+export const OPENAPI_ROUTES = {
+    "POST /v1/skills/make_faceless/quote": { exposure: "public", operationId: "quoteMakeFaceless", tag: "Skills",
+        body: named("MakeFacelessInput", serverFacelessInput), responses: { 200: named("FacelessQuote", facelessQuoteResponse) } },
+    "POST /v1/skills/make_faceless/run": { exposure: "public", operationId: "runMakeFaceless", tag: "Skills",
+        body: named("MakeFacelessInput", serverFacelessInput), responses: { 202: Run, 200: Run } },
+    "GET /health": { exposure: "public", operationId: "getHealth", tag: "Service", anonymous: true,
+        responses: { 200: named("Health", healthResponse) } },
+    "GET /": { exposure: "excluded", reason: "The host root names the human docs for crawlers; it is not an operation a client calls." },
+    "GET /robots.txt": { exposure: "excluded", reason: "A plain-text crawler directive for the API host, not part of the client contract." },
+    "GET /openapi.json": { exposure: "public", operationId: "getOpenApiDocument", tag: "Service", anonymous: true,
+        responses: { 200: named("OpenApiDocument", openApiDocumentShape) } },
+    "GET /v1/voices": { exposure: "public", operationId: "listVoices", tag: "Catalogs", query: serverVoicesQuery,
+        responses: { 200: named("Voices", voicesResponse) } },
+    "GET /v1/template-sounds": { exposure: "public", operationId: "listTemplateSounds", tag: "Catalogs",
+        responses: { 200: named("TemplateSounds", templateSoundsList) } },
+    "GET /v1/account": { exposure: "public", operationId: "getAccount", tag: "Account", responses: { 200: named("Account", account) } },
+    "POST /v1/skills/make_ugc/quote": { exposure: "public", operationId: "quoteMakeUgc", tag: "Skills",
+        body: MakeUgcInput, responses: { 200: named("UgcQuote", quoteResponse) } },
+    "GET /v1/runs/{id}": { exposure: "public", operationId: "getRun", tag: "Runs", params: RUN, responses: { 200: Run } },
+    "GET /v1/runs/{id}/shots": { exposure: "public", operationId: "getRunShots", tag: "Runs", params: RUN,
+        responses: { 200: named("RunShots", runShots) } },
+    "GET /v1/runs/{id}/edit": { exposure: "public", operationId: "getRunEdit", tag: "Runs", params: RUN, responses: { 200: named("RunEdit", runEdit) } },
+    "POST /v1/runs/{id}/edit": { exposure: "public", operationId: "saveRunEdit", tag: "Runs", params: RUN,
+        body: named("SaveRunEdit", saveRunEdit), responses: { 200: named("RunEdit", runEdit) } },
+    "POST /v1/runs/{id}/revisions/quote": { exposure: "public", operationId: "quoteRevision", tag: "Runs", params: RUN,
+        body: named("RevisionRequest", revisionRequest), responses: { 200: named("RevisionQuote", revisionQuote) } },
+    "POST /v1/runs/{id}/revisions": { exposure: "public", operationId: "startRevision", tag: "Runs", params: RUN,
+        body: named("RevisionRequest", revisionRequest), responses: { 202: Run, 200: Run } },
+    "POST /v1/runs/{id}/candidates/quote": { exposure: "public", operationId: "quoteCandidate", tag: "Runs", params: RUN,
+        body: named("CandidateRequest", candidateRequest), responses: { 200: named("CandidateQuote", candidateQuote) } },
+    "POST /v1/runs/{id}/candidates": { exposure: "public", operationId: "createCandidate", tag: "Runs", params: RUN,
+        body: named("CandidateRequest", candidateRequest), responses: { 202: Run, 200: Run } },
+    "GET /v1/runs/{id}/candidates": { exposure: "public", operationId: "listCandidates", tag: "Runs", params: RUN,
+        responses: { 200: named("RunCandidates", runCandidates) } },
+    "POST /v1/skills/make_ugc/run": { exposure: "public", operationId: "runMakeUgc", tag: "Skills",
+        body: MakeUgcInput, responses: { 202: Run, 200: Run } },
+    "GET /v1/public/skills": { exposure: "public", operationId: "listPublicSkills", tag: "Catalogs", anonymous: true,
+        responses: { 200: named("PublicSkills", publicSkillsResponse) } },
+    "GET /v1/public/prices": { exposure: "public", operationId: "listPrices", tag: "Catalogs", anonymous: true,
+        responses: { 200: named("Prices", pricesResponse) } },
+    "GET /v1/actors": { exposure: "public", operationId: "listActors", tag: "Actors", responses: { 200: named("Actors", actorsResponse) } },
+    "DELETE /v1/actors/{id}": { exposure: "public", operationId: "deleteActor", tag: "Actors", params: ACTOR, responses: { 204: null } },
+    "GET /v1/actors/{id}/defaults": { exposure: "public", operationId: "getActorDefaults", tag: "Actors", params: ACTOR,
+        responses: { 200: named("ActorDefaults", actorDefaults) } },
+    "POST /v1/actors/{id}/defaults": { exposure: "public", operationId: "setActorDefaults", tag: "Actors", params: ACTOR,
+        body: named("ActorDefaultsInput", actorDefaultsInput), responses: { 200: named("ActorDefaults", actorDefaults) } },
+    "POST /v1/skills/create_actor/quote": { exposure: "public", operationId: "quoteCreateActor", tag: "Skills",
+        body: named("CreateActorInput", createActorInput), responses: { 200: named("CreateActorQuote", createActorQuote) } },
+    "POST /v1/skills/create_actor/run": { exposure: "public", operationId: "runCreateActor", tag: "Skills",
+        body: named("CreateActorInput", createActorInput), responses: { 202: Run, 200: Run } },
+    "POST /v1/uploads": { exposure: "public", operationId: "uploadImage", tag: "Uploads", body: RAW_UPLOAD,
+        responses: { 201: named("Upload", uploadResponse) } },
+    "GET /v1/uploads": { exposure: "public", operationId: "listUploads", tag: "Uploads", responses: { 200: named("Uploads", uploadList) } },
+    "POST /v1/uploads/import": { exposure: "public", operationId: "importUpload", tag: "Uploads", optionalIdempotencyKey: true,
+        body: named("UploadImportRequest", uploadImportRequest), responses: { 201: named("Upload", uploadResponse), 200: named("Upload", uploadResponse) } },
+    "POST /v1/uploads/intents": { exposure: "public", operationId: "createUploadIntent", tag: "Uploads", optionalIdempotencyKey: true,
+        body: named("UploadIntentRequest", uploadIntentRequest),
+        responses: { 201: named("UploadIntent", uploadIntentResponse), 200: named("UploadIntent", uploadIntentResponse) } },
+    "GET /v1/uploads/{id}": { exposure: "public", operationId: "getUpload", tag: "Uploads", params: { id: uploadId },
+        responses: { 200: named("UploadItem", uploadItemResponse) } },
+    "POST /v1/assets": { exposure: "public", operationId: "createAsset", tag: "Assets", optionalIdempotencyKey: true,
+        body: named("CreateAssetRequest", createAssetRequest), responses: { 201: AssetItem, 202: AssetItem, 200: AssetItem } },
+    "POST /v1/assets/bytes": { exposure: "public", operationId: "createAssetFromBytes", tag: "Assets", optionalIdempotencyKey: true,
+        body: { mediaTypes: ASSET_PUT_MEDIA_TYPES }, query: assetBytesQuery, responses: { 201: AssetItem, 202: AssetItem, 200: AssetItem } },
+    "GET /v1/assets": { exposure: "public", operationId: "listAssets", tag: "Assets", query: assetListQuery,
+        responses: { 200: named("Assets", assetList) } },
+    "GET /v1/assets/{id}": { exposure: "public", operationId: "getAsset", tag: "Assets", params: ASSET, responses: { 200: AssetItem } },
+    "POST /v1/assets/{id}": { exposure: "public", operationId: "updateAsset", tag: "Assets", params: ASSET,
+        body: named("UpdateAssetRequest", updateAssetRequest), responses: { 200: named("Asset", asset) } },
+    "DELETE /v1/assets/{id}": { exposure: "public", operationId: "deleteAsset", tag: "Assets", params: ASSET, responses: { 204: null } },
+    "GET /internal/portfolio-metrics": { exposure: "excluded",
+        reason: "Internal funnel aggregates behind their own secret, outside the client contract (docs/03-api.md section 12)." },
+    "GET /v1/public/workflows": { exposure: "public", operationId: "listWorkflows", tag: "Workflows", anonymous: true,
+        responses: { 200: named("WorkflowCatalog", workflowCatalogResponse) } },
+    "GET /v1/public/workflows/{id}": { exposure: "public", operationId: "getWorkflow", tag: "Workflows", anonymous: true, params: { id: workflowMethodId },
+        responses: { 200: named("WorkflowMethod", workflowMethodResponse) } },
+    "POST /v1/workflow-plans": { exposure: "public", operationId: "createWorkflowPlan", tag: "Workflows",
+        body: named("CreateWorkflowPlan", createWorkflowPlan), responses: { 201: named("WorkflowPlan", workflowPlanRead) } },
+    "GET /v1/workflow-plans/{id}": { exposure: "public", operationId: "getWorkflowPlan", tag: "Workflows", params: PLAN,
+        responses: { 200: named("WorkflowPlan", workflowPlanRead) } },
+    "POST /v1/workflow-plans/reference-remake": { exposure: "public", operationId: "planReferenceRemake", tag: "Workflows",
+        body: named("PlanReferenceRemake", planReferenceRemake), responses: { 201: named("WorkflowPlan", workflowPlanRead) } },
+    "POST /v1/workflow-plans/{id}/revisions": { exposure: "public", operationId: "saveWorkflowPlan", tag: "Workflows", params: PLAN,
+        body: named("SaveWorkflowPlan", saveWorkflowPlan), responses: { 200: named("WorkflowPlan", workflowPlanRead) } },
+    "POST /v1/workflow-plans/{id}/approve": { exposure: "public", operationId: "approveWorkflowPlan", tag: "Workflows", params: PLAN,
+        body: named("ApproveWorkflowPlan", approveWorkflowPlan), responses: { 200: named("WorkflowPlan", workflowPlanRead) } },
+    "POST /v1/workflow-plans/{id}/quote": { exposure: "public", operationId: "quoteWorkflowPlan", tag: "Workflows", params: PLAN,
+        responses: { 200: named("WorkflowQuote", workflowQuoteBinding) } },
+    "POST /v1/workflow-plans/{id}/run": { exposure: "public", operationId: "runWorkflowPlan", tag: "Workflows", params: PLAN,
+        body: named("LaunchWorkflow", launchWorkflow),
+        responses: { 202: named("WorkflowLaunch", workflowLaunchResponse), 200: named("WorkflowLaunch", workflowLaunchResponse) } },
+    "GET /v1/generations/models": { exposure: "public", operationId: "listGenerationModels", tag: "Catalogs",
+        responses: { 200: named("GenerationModels", generationModels) } },
+    "POST /v1/skills/generate_image/quote": { exposure: "public", operationId: "quoteImage", tag: "Skills",
+        body: named("GenerateImageRequest", generateImageRequest), responses: { 200: named("GenerationQuote", generationQuote) } },
+    "POST /v1/skills/generate_image/run": { exposure: "public", operationId: "generateImage", tag: "Skills",
+        body: named("GenerateImageRequest", generateImageRequest), responses: { 202: Run, 200: Run } },
+    "POST /v1/skills/generate_video/quote": { exposure: "public", operationId: "quoteVideo", tag: "Skills",
+        body: named("GenerateVideoRequest", generateVideoRequest), responses: { 200: named("GenerationQuote", generationQuote) } },
+    "POST /v1/skills/generate_video/run": { exposure: "public", operationId: "generateVideo", tag: "Skills",
+        body: named("GenerateVideoRequest", generateVideoRequest), responses: { 202: Run, 200: Run } },
+    "POST /v1/reference-analyses/quote": { exposure: "public", operationId: "quoteAnalysis", tag: "Reference analysis",
+        body: named("AnalyzeReferenceRequest", analyzeReferenceRequest), responses: { 200: named("AnalysisQuote", analysisQuoteResponse) } },
+    "POST /v1/reference-analyses": { exposure: "public", operationId: "analyzeReference", tag: "Reference analysis",
+        billedWithoutKey: "one live analysis per asset: a resend answers the same analysis, and only a succeeded one is charged",
+        body: named("AnalyzeReferenceRequest", analyzeReferenceRequest),
+        responses: { 202: named("ReferenceAnalysis", referenceAnalysis), 200: named("ReferenceAnalysis", referenceAnalysis) } },
+    "GET /v1/reference-analyses/{id}": { exposure: "public", operationId: "getReferenceAnalysis", tag: "Reference analysis", params: { id: referenceAnalysisId },
+        responses: { 200: named("ReferenceAnalysis", referenceAnalysis) } },
+};
+function routeOf(endpoint) {
+    const route = OPENAPI_ROUTES[endpointLabel(endpoint)];
+    if (route === undefined)
+        throw new Error(`no OpenAPI marking for ${endpointLabel(endpoint)}`);
+    return route;
+}
+/** Registry order, public rows only. */
+export function publicOpenApiRoutes() {
+    return API_ENDPOINTS.flatMap((endpoint) => {
+        const route = routeOf(endpoint);
+        return route.exposure === "public" ? [{ endpoint, route }] : [];
+    });
+}
+/** `:id` in Hono notation is `{id}` in OpenAPI. */
+export const openApiOperationPath = (path) => path.replace(/:(\w+)/g, "{$1}");
+/** The declared body of a success status: a schema, `null` for no body, `undefined` when undeclared. */
+export function openApiResponse(endpoint, status) {
+    const route = routeOf(endpoint);
+    if (route.exposure !== "public")
+        return undefined;
+    return route.responses[status];
+}
+const SCHEMA_REF = "#/components/schemas/";
+const WARNINGS = { type: "array", items: { type: "string" } };
+/** zod's local `$defs` would resolve against the document root, so they become components of their own. */
+function toComponent(entry, io, schemas) {
+    const json = z.toJSONSchema(entry.schema, { io, unrepresentable: "any" });
+    const defs = (json.$defs ?? {});
+    delete json.$schema;
+    delete json.$defs;
+    const rewrite = (node, key) => {
+        if (Array.isArray(node))
+            return node.map((item) => rewrite(item));
+        if (node === null || typeof node !== "object")
+            return node;
+        const object = node;
+        if (typeof object.$ref === "string" && object.$ref.startsWith("#/$defs/")) {
+            return { ...object, $ref: `${SCHEMA_REF}${entry.name}.${object.$ref.slice("#/$defs/".length)}` };
+        }
+        // Rule 3: an unmet parameter is a warning, never silence; the shared component says so once.
+        if (key === "warnings" && object.type === "array" && JSON.stringify(object.items) === JSON.stringify(WARNINGS.items)) {
+            const { type: _type, items: _items, ...rest } = object;
+            return { $ref: `${SCHEMA_REF}Warnings`, ...rest };
+        }
+        if (object.properties !== null && typeof object.properties === "object") {
+            const properties = Object.fromEntries(Object.entries(object.properties).map(([name, value]) => [name, rewrite(value, name)]));
+            return Object.fromEntries(Object.entries(object).map(([name, value]) => [name, name === "properties" ? properties : rewrite(value)]));
+        }
+        return Object.fromEntries(Object.entries(object).map(([name, value]) => [name, rewrite(value)]));
+    };
+    schemas[entry.name] = rewrite(json);
+    for (const [name, def] of Object.entries(defs))
+        schemas[`${entry.name}.${name}`] = rewrite(def);
+}
+const { version: PACKAGE_VERSION } = createRequire(import.meta.url)("../package.json");
+/** Routes whose 200 replays an earlier answer and whose fresh answer has another status. */
+const SUCCESS_REPLAY = new Set(Object.entries(OPENAPI_ROUTES).flatMap(([label, route]) => route.exposure === "public" && 200 in route.responses && (201 in route.responses || 202 in route.responses) ? [label] : []));
+/** Pure: the same document from the same code, so the API builds it once and serves it from memory. */
+export function buildOpenApiDocument() {
+    const schemas = {
+        Warnings: { ...WARNINGS, description: "What the request named and the API did not honour; it is never dropped silently." },
+    };
+    const seen = new Map();
+    const ref = (entry, io) => {
+        const known = seen.get(entry.name);
+        if (known !== undefined && known !== entry.schema)
+            throw new Error(`two schemas share the component name ${entry.name}`);
+        if (known === undefined) {
+            seen.set(entry.name, entry.schema);
+            toComponent(entry, io, schemas);
+        }
+        return { $ref: `${SCHEMA_REF}${entry.name}` };
+    };
+    ref(named("ErrorEnvelope", errorEnvelope), "output");
+    const paths = {};
+    for (const { endpoint, route } of publicOpenApiRoutes()) {
+        const label = endpointLabel(endpoint);
+        const note = ENDPOINT_NOTES[label];
+        if (note === undefined)
+            throw new Error(`no note for ${label}`);
+        const pathNames = [...endpoint.path.matchAll(/:(\w+)/g)].map(([, name]) => name);
+        if (JSON.stringify(pathNames) !== JSON.stringify(Object.keys(route.params ?? {}))) {
+            throw new Error(`${label} names path parameters [${pathNames.join(", ")}], its marking [${Object.keys(route.params ?? {}).join(", ")}]`);
+        }
+        const parameters = pathNames.map((name) => {
+            const { $schema: _schema, ...schema } = z.toJSONSchema(route.params[name], { io: "input", unrepresentable: "any" });
+            return { name, in: "path", required: true, schema };
+        });
+        if (route.query !== undefined) {
+            const query = z.toJSONSchema(route.query, { io: "input", unrepresentable: "any" });
+            for (const [name, schema] of Object.entries(query.properties ?? {})) {
+                const { description, ...rest } = schema;
+                parameters.push({ name, in: "query", required: query.required?.includes(name) ?? false, schema: rest,
+                    ...(typeof description === "string" && { description }) });
+            }
+        }
+        if ((endpoint.billed && route.billedWithoutKey === undefined) || route.optionalIdempotencyKey) {
+            parameters.push({ name: "Idempotency-Key", in: "header", required: endpoint.billed, schema: { type: "string", minLength: 1 },
+                description: endpoint.billed
+                    ? "Required: a resend with the same key and body returns the first run instead of charging again."
+                    : "Optional: a resend with the same key and body returns the first answer." });
+        }
+        const responses = {};
+        for (const [status, entry] of Object.entries(route.responses)) {
+            responses[status] = entry === null
+                ? { description: "No content." }
+                : { description: status === "200" && SUCCESS_REPLAY.has(label) ? "The earlier answer to the same request." : "Success.",
+                    content: { "application/json": { schema: ref(entry, "output") } } };
+        }
+        if (!route.anonymous) {
+            responses["401"] = { $ref: "#/components/responses/Unauthorized" };
+            responses["429"] = { $ref: "#/components/responses/RateLimited" };
+        }
+        responses.default = { $ref: "#/components/responses/Error" };
+        const body = route.body === undefined ? undefined : "mediaTypes" in route.body
+            ? { required: true, content: Object.fromEntries(route.body.mediaTypes.map((type) => [type, {}])) }
+            : { required: true, content: { "application/json": { schema: ref(route.body, "input") } } };
+        const item = paths[openApiOperationPath(endpoint.path)] ?? {};
+        paths[openApiOperationPath(endpoint.path)] = item;
+        item[endpoint.method.toLowerCase()] = {
+            operationId: route.operationId,
+            tags: [route.tag],
+            summary: note.split(/(?<=\.)\s/)[0],
+            description: note,
+            security: route.anonymous ? [] : [{ apiKey: [] }],
+            ...(parameters.length > 0 && { parameters }),
+            ...(body !== undefined && { requestBody: body }),
+            responses,
+        };
+    }
+    const envelope = { "application/json": { schema: { $ref: `${SCHEMA_REF}ErrorEnvelope` } } };
+    return {
+        openapi: "3.1.1",
+        info: {
+            title: "Clipwright API",
+            version: PACKAGE_VERSION,
+            summary: "Agent-native video generation: UGC, faceless and long-form presenter videos.",
+            description: "Quotes are free; a run holds credits and answers at once, and GET /v1/runs/{id} reports every run. "
+                + "Parameters the API does not honour come back in warnings[], never silently. "
+                + "Every refusal is one envelope, { error: { code, message } }, with typed fields for the codes that carry numbers.",
+            contact: { name: "Clipwright", url: "https://clipwright.io/docs" },
+        },
+        servers: [{ url: PUBLIC_API_BASE_URL }],
+        security: [{ apiKey: [] }],
+        tags: Object.entries(TAGS).map(([name, description]) => ({ name, description })),
+        paths,
+        components: {
+            securitySchemes: {
+                apiKey: { type: "http", scheme: "bearer", bearerFormat: "cw_*",
+                    description: `A key starting with cw_, issued at ${PUBLIC_APP_BASE_URL}/api-keys and shown once.` },
+            },
+            responses: {
+                Error: { description: "A refusal in the shared error envelope.", content: envelope },
+                Unauthorized: { description: "The key is missing, malformed or revoked; nothing was charged.", content: envelope },
+                RateLimited: { description: "Too many requests for the account's bucket; retry after Retry-After seconds.", content: envelope,
+                    headers: { "Retry-After": { schema: { type: "integer", minimum: 0 }, description: "Seconds until a retry can succeed." } } },
+            },
+            schemas,
+        },
+    };
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

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

package/dist/pacing.d.ts

@@ -1,4 +1,19 @@
+import { type TtsModelId } from "./voices.js";
 /** Speech pacing: 2–4 words per second. */
 export declare const WORDS_PER_SECOND_MIN = 2;
 export declare const WORDS_PER_SECOND_MAX = 4;
 export declare function countWords(script: string): number;
+/** Average pace for duration ESTIMATES: two live ElevenLabs renders (Sarah), 74 words → 27.1 s and 32 words → 13.07 s. */
+/** The earlier 3 words/s missed by −18.9% against the ±15% gate. */
+export declare const ESTIMATE_WORDS_PER_SECOND = 2.6;
+/** Russian on eleven_v3 reads slower: 153 words in 66.13 s, 2.31 words/s (#164). */
+/** The speech-duration floor uses ESTIMATE_WORDS_PER_SECOND; only a measurement may raise it. */
+export declare const ESTIMATE_WORDS_PER_SECOND_CYRILLIC = 2.3;
+/** Cyrillic on eleven_v4: 153 words in 70.32 s, one take at Stability 0.5 (#452). */
+export declare const ESTIMATE_WORDS_PER_SECOND_CYRILLIC_V4 = 2.18;
+/** Cyrillic on gemini-3.8-flash-tts: 153 words in 71.04 s and 65.68 s, mean 2.24, rounded down (#453). */
+export declare const ESTIMATE_WORDS_PER_SECOND_CYRILLIC_GOOGLE = 2.2;
+/** Only make_ugc admission names the model; without it the script family alone sets the pace. */
+export declare function estimateWordsPerSecond(script: string, model?: TtsModelId): number;
+/** An ESTIMATE from the script's pace, not a fact: the charge follows the measured duration. */
+export declare function estimateDurationSec(script: string, model?: TtsModelId): number;

package/dist/pacing.js

@@ -1,7 +1,37 @@
+import { detectScriptFamily, GOOGLE_TTS_MODEL } from "./voices.js";
 /** Speech pacing: 2–4 words per second. */
 export const WORDS_PER_SECOND_MIN = 2;
 export const WORDS_PER_SECOND_MAX = 4;
 export function countWords(script) {
     return script.trim().split(/\s+/).filter(Boolean).length;
 }
+/** Average pace for duration ESTIMATES: two live ElevenLabs renders (Sarah), 74 words → 27.1 s and 32 words → 13.07 s. */
+/** The earlier 3 words/s missed by −18.9% against the ±15% gate. */
+export const ESTIMATE_WORDS_PER_SECOND = 2.6;
+/** Russian on eleven_v3 reads slower: 153 words in 66.13 s, 2.31 words/s (#164). */
+/** The speech-duration floor uses ESTIMATE_WORDS_PER_SECOND; only a measurement may raise it. */
+export const ESTIMATE_WORDS_PER_SECOND_CYRILLIC = 2.3;
+/** Cyrillic on eleven_v4: 153 words in 70.32 s, one take at Stability 0.5 (#452). */
+export const ESTIMATE_WORDS_PER_SECOND_CYRILLIC_V4 = 2.18;
+/** Cyrillic on gemini-3.8-flash-tts: 153 words in 71.04 s and 65.68 s, mean 2.24, rounded down (#453). */
+export const ESTIMATE_WORDS_PER_SECOND_CYRILLIC_GOOGLE = 2.2;
+/** Cyrillic pace for models with their own measurement; any other model reads at the script family's pace. */
+const CYRILLIC_WORDS_PER_SECOND_BY_MODEL = {
+    eleven_v4: ESTIMATE_WORDS_PER_SECOND_CYRILLIC_V4,
+    [GOOGLE_TTS_MODEL]: ESTIMATE_WORDS_PER_SECOND_CYRILLIC_GOOGLE,
+};
+/** Only make_ugc admission names the model; without it the script family alone sets the pace. */
+export function estimateWordsPerSecond(script, model) {
+    if (detectScriptFamily(script) !== "cyrillic")
+        return ESTIMATE_WORDS_PER_SECOND;
+    const measured = model !== undefined && Object.hasOwn(CYRILLIC_WORDS_PER_SECOND_BY_MODEL, model)
+        ? CYRILLIC_WORDS_PER_SECOND_BY_MODEL[model]
+        : undefined;
+    return measured ?? ESTIMATE_WORDS_PER_SECOND_CYRILLIC;
+}
+/** An ESTIMATE from the script's pace, not a fact: the charge follows the measured duration. */
+export function estimateDurationSec(script, model) {
+    const words = countWords(script);
+    return Math.max(1, Math.round(words / estimateWordsPerSecond(script, model)));
+}
 //# sourceMappingURL=pacing.js.map

package/dist/pacing.js.map

@@ -1 +1 @@
-{"version":3,"file":"pacing.js","sourceRoot":"","sources":["../src/pacing.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"pacing.js","sourceRoot":"","sources":["../src/pacing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAEpF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AAC3D,CAAC;AAED,0HAA0H;AAC1H,oEAAoE;AACpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C,oFAAoF;AACpF,iGAAiG;AACjG,MAAM,CAAC,MAAM,kCAAkC,GAAG,GAAG,CAAC;AAEtD,qFAAqF;AACrF,MAAM,CAAC,MAAM,qCAAqC,GAAG,IAAI,CAAC;AAE1D,0GAA0G;AAC1G,MAAM,CAAC,MAAM,yCAAyC,GAAG,GAAG,CAAC;AAE7D,8GAA8G;AAC9G,MAAM,kCAAkC,GAAwC;IAC9E,SAAS,EAAE,qCAAqC;IAChD,CAAC,gBAAgB,CAAC,EAAE,yCAAyC;CAC9D,CAAC;AAEF,iGAAiG;AACjG,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,KAAkB;IACvE,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,UAAU;QAAE,OAAO,yBAAyB,CAAC;IAChF,MAAM,QAAQ,GACZ,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,kCAAkC,EAAE,KAAK,CAAC;QAC7E,CAAC,CAAC,kCAAkC,CAAC,KAAK,CAAC;QAC3C,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,QAAQ,IAAI,kCAAkC,CAAC;AACxD,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,KAAkB;IACpE,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC"}