@clipwright/sdk 0.18.0 → 0.20.0

package/CHANGELOG.md

@@ -16,6 +16,50 @@ a customer reading it should not miss what appeared in the product. Like *Server
 they are live from the day the web app was deployed, not from the package release they are
 listed under.
 
+## [0.20.0] - 2026-09-25
+
+The MCP server is ready for directories: it has a name in the official MCP
+Registry, and every tool tells the host whether it only reads or writes.
+
+### Added
+
+- Every MCP tool now carries a `title` and the `readOnlyHint`/`destructiveHint`
+  annotations: quotes, lists and reads are read-only, `delete_actor` is
+  destructive, and `make_ugc`, `create_actor`, `upload_image` and
+  `set_actor_defaults` write.
+- `@clipwright/mcp-server` declares `mcpName: io.clipwright/mcp` for the official
+  MCP Registry.
+
+## [0.19.0] - 2026-09-22
+
+A paid video that arrived after we stopped waiting can now be collected: the run
+goes back to `queued` and drives the pipeline again. The server side was live
+from the day it was deployed; this release carries the contract change to the
+MCP tool description, which is where an agent reads the promise.
+
+### Changed
+
+- **Breaking:** `failed` is no longer always final. A run whose paid vendor job
+  we still hold can be reopened: it goes back to `queued` and may reach
+  `succeeded`. Every reopening is named in `warnings[]`, and one run is reopened
+  at most three times. An agent that stops polling the moment it reads `failed`
+  will miss a video that was paid for and delivered.
+- *Server-side* A run that lost the video while the vendor was still working on
+  it no longer says its paid job "was retained for recovery" when this run's
+  terms cannot support recovery. Reading the terms fails soft: when they cannot
+  be read at all, the run promises nothing either way.
+- *Server-side* A recovered delivery is written to the ledger under its own
+  reason, `run_recovered_delivery`, because the vendor spend was already counted
+  on the day the run first failed.
+
+### Operations
+
+- Migration 0036 adds `recovery_attempt` and `recovery_reopened_at` to `runs`,
+  and both are read on the main render path. **Apply the migration before
+  deploying any service**: an early deploy fails every `make_ugc` run, not one
+  feature. Order forward is migration, api, worker, web; backwards it is worker
+  and api first, then drop the columns.
+
 ## [0.18.0] - 2026-09-21
 
 Long-form clips can now show a face for a fifth of their length instead of nearly

package/dist/client-id.js

@@ -2,22 +2,9 @@ import { randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-/**
- * Устойчивая идентичность УСТАНОВКИ клиента — префикс ключа идемпотентности.
- *
- * ЗАЧЕМ ЭТО ВООБЩЕ СУЩЕСТВУЕТ (C1): ключ идемпотентности склеивается из хеша
- * входа И идентичности клиента. Хеш входа один и тот же на любой машине, поэтому
- * без стабильного per-установка `clientId` дедупликация повторного `POST /run`
- * либо не работает между перезапусками процесса, либо, наоборот, схлопывает
- * раны разных пользователей. Одна установка = одна идентичность = один денежный
- * контур дедупа.
- *
- * ПОЧЕМУ ПАДЕНИЕ, А НЕ ЭФЕМЕРНЫЙ id ПРИ ОШИБКЕ ФС: тихий фолбэк на случайный
- * id при каждом запуске ВЫКЛЮЧАЕТ C1 целиком (каждый старт — новый клиент →
- * дедуп мёртв → повторный рендер за деньги). Лучше громко потребовать выставить
- * `CLIPWRIGHT_CLIENT_ID`, чем молча жечь кредиты.
- */
-/** Приоритетный источник — явный env: не читает и не пишет файл вовсе. */
+/** Stable per-install identity that prefixes the idempotency key, so retries */
+/** deduplicate across restarts without merging different users' runs. */
+/** An explicit env value wins and skips the file entirely. */
 const ENV_VAR = "CLIPWRIGHT_CLIENT_ID";
 export function resolveClientId() {
     const fromEnv = process.env[ENV_VAR];
@@ -33,16 +20,16 @@ export function resolveClientId() {
                 return existing;
             }
         }
-        // Первый запуск на этой установке: рождаем стабильный id и закрепляем его
-        // на диске. UUID без дефисов — компактнее в заголовке Idempotency-Key.
+        // First run on this install: persist a stable id. Dashless UUID keeps the
+        // Idempotency-Key header short.
         const id = randomUUID().replace(/-/g, "");
         mkdirSync(dir, { recursive: true });
         writeFileSync(file, id, "utf8");
         return id;
     }
     catch (cause) {
-        // ЛЮБАЯ невозможность прочитать/создать файл (read-only HOME в чужом хосте,
-        // нет прав) — это НЕ повод на тихий эфемерный id (см. заголовок модуля).
+        // No silent ephemeral id: a fresh id per start disables dedup and turns
+        // every retry into a second paid render.
         throw new Error(`Cannot read or create ~/.clipwright/client-id. Set the ${ENV_VAR} ` +
             `environment variable to a stable per-install identifier so idempotent ` +
             `retries deduplicate instead of billing twice.`, { cause });

package/dist/client-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-id.js","sourceRoot":"","sources":["../src/client-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AAEH,0EAA0E;AAC1E,MAAM,OAAO,GAAG,sBAAsB,CAAC;AAEvC,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACnD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1C,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4EAA4E;QAC5E,yEAAyE;QACzE,MAAM,IAAI,KAAK,CACb,0DAA0D,OAAO,GAAG;YAClE,wEAAwE;YACxE,+CAA+C,EACjD,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"client-id.js","sourceRoot":"","sources":["../src/client-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,gFAAgF;AAChF,yEAAyE;AAEzE,8DAA8D;AAC9D,MAAM,OAAO,GAAG,sBAAsB,CAAC;AAEvC,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACnD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,gCAAgC;QAChC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1C,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,wEAAwE;QACxE,yCAAyC;QACzC,MAAM,IAAI,KAAK,CACb,0DAA0D,OAAO,GAAG;YAClE,wEAAwE;YACxE,+CAA+C,EACjD,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -2,131 +2,86 @@ import { type Account, type ActorDefaults, type ActorDefaultsInput, type ActorCa
 export interface ClipwrightClientOptions {
     apiKey: string;
     baseUrl?: string | undefined;
-    /** Интервал поллинга статуса рана, мс. */
+    /** Run status polling interval, ms. */
     pollIntervalMs?: number | undefined;
-    /** Срок ОДНОГО запроса, мс (дефолт 30_000). Не путать с `maxWaitMs`: тот */
-    /** ограничивает весь `makeUgc`, этот — каждое обращение по отдельности. */
+    /** Timeout of ONE request, ms (default 30_000). `maxWaitMs` bounds the */
+    /** whole `makeUgc`; this bounds each call separately. */
     requestTimeoutMs?: number | undefined;
 }
-/** Опции старта рана. `attempt` даёт суффикс `:N`; явный ключ его перекрывает. */
+/** Run start options. `attempt` sets the `:N` suffix; an explicit key overrides it. */
 export interface StartUgcOptions {
-    /** Номер попытки (дефолт 1) → суффикс `:N` у ключа идемпотентности. */
+    /** Attempt number (default 1) → `:N` suffix of the idempotency key. */
     attempt?: number | undefined;
-    /** Явный ключ «намеренно новый ран» — перекрывает вычисленный. */
+    /** Explicit key for an intentionally new run; overrides the computed one. */
     idempotencyKey?: string | undefined;
 }
-/** Опции синхронного `makeUgc`: проброс `attempt` + дедлайн поллинга. */
+/** Options of the blocking `makeUgc`: `attempt` plus a polling deadline. */
 export interface MakeUgcOptions {
     attempt?: number | undefined;
-    /** Дедлайн ожидания терминального состояния, мс (дефолт 10 мин). */
+    /** Deadline for reaching a terminal state, ms (default 10 min). */
     maxWaitMs?: number | undefined;
 }
-/**
- * ОТВЕТ СЕРВЕРА НЕ РАЗОБРАЛСЯ — ЭТО НЕ ТО ЖЕ, ЧТО ОТКАЗ ВВОДА (US-622).
- *
- * Обе беды приходят из zod и до этого класса были неотличимы снаружи: и
- * `makeUgcInput.parse` на входе, и `run.parse` на ответе бросали `ZodError`.
- * Внешнее ревью (круг 9) показало цену этой неразличимости. CLI печатал любую
- * такую ошибку как «запрос отвергнут ДО отправки» — а на битом ответе `POST
- * /run` это ложь в самую дорогую сторону: запрос ушёл, ран создан и, возможно,
- * уже оплачен, но человеку сказано, что ничего не произошло, и `run_id` он не
- * получил.
- *
- * Поэтому провал разбора ОТВЕТА получает собственный класс и собственный текст,
- * который прямо называет, мог ли вызов иметь последствия.
- */
+/** An unparseable server response, distinct from rejected input: after */
+/** `POST /run` the run may already exist and be charged. */
 export declare class ClipwrightResponseError extends Error {
     #private;
-    /** Путь, ответ которого не разобрался. */
+    /** Path whose response failed to parse. */
     readonly path: string;
-    /** Мог ли запрос уже что-то изменить (создать ран, потратить деньги). */
+    /** Whether the request may already have changed state (created a run, spent credits). */
     readonly mayHaveTakenEffect: boolean;
-    /**
-     * ПОДТВЕРЖДЕНА ли доставка запроса. Имя выбрано точно (внешнее ревью, круг 12):
-     * прежнее `delivered` читалось как «не доставлено», хотя `false` означает лишь
-     * ОТСУТСТВИЕ ПОДТВЕРЖДЕНИЯ. Отличить «не дошло» от «дошло, а ответ потерян»
-     * у HTTP способа нет, и потребитель, прочитавший поле как отрицание, запустил
-     * бы `attempt: 2` и оплатил второй рендер.
-     */
+    /** `false` means delivery is unconfirmed, not that it failed: HTTP cannot */
+    /** tell a lost request from a lost response. */
     readonly deliveryConfirmed: boolean;
     constructor(path: string, mayHaveTakenEffect: boolean, cause: unknown, deliveryConfirmed?: boolean);
 }
-/** Один пресет каталога `/v1/voices` — ВЫВЕДЕН из схемы ответа, а не написан */
-/** рядом с ней: две формы одного тела расходились бы молча (правило №2). */
+/** One `/v1/voices` preset, derived from the response schema so the two */
+/** shapes cannot drift apart. */
 export type VoiceCatalogEntry = CoreVoiceCatalogEntry;
-/**
- * ОТКАЗ API, ДОЕХАВШИЙ ДО ВЫЗЫВАТЕЛЯ ЦЕЛИКОМ (US-622).
- *
- * ЧТО БЫЛО ДО. `#request` сводил любой не-2xx к `new Error(message)`: статус,
- * код и назначенная сервером пауза терялись на границе SDK. Вызыватель мог
- * только напечатать текст — отличить «подожди две секунды» от «пополни счёт»
- * было нечем, и поллинг умирал на первом же 429.
- *
- * ЧЕГО ЗДЕСЬ НАМЕРЕННО НЕТ — СВОЕЙ ФОРМЫ ОТКАЗА. Класс не объявляет ни кодов,
- * ни полей с числами: всё это лежит в `ApiFailure` из `@clipwright/core`, и
- * `code`/`report()` выводятся оттуда же (правило проекта №2). Объяви SDK свою
- * копию — и MCP с CLI получили бы вторую, а «повторять или нет» стало бы
- * вопросом, на который три поверхности отвечают порознь.
- */
+/** An API refusal with status, code and server-set pause intact. The shape */
+/** comes from core, so SDK, CLI and MCP answer "retry or not" identically. */
 export declare class ClipwrightApiError extends Error {
-    /** Разобранный отказ: вид, числа, пауза. Форма — из core. */
+    /** Parsed refusal: kind, numbers, pause. Shape comes from core. */
     readonly failure: ApiFailure;
     readonly status: number;
-    /** Код отказа. Для чужих тел без кода — `http_<status>`. */
+    /** Refusal code; `http_<status>` for foreign bodies without one. */
     readonly code: string;
-    /** Пауза в секундах, назначенная сервером. `undefined` — он её не назвал. */
+    /** Server-set pause in seconds; `undefined` if the server named none. */
     readonly retryAfterSeconds: number | undefined;
     constructor(failure: ApiFailure);
-    /** Имеет ли смысл повторить тот же вызов. Решает core, а не эта поверхность. */
+    /** Whether repeating the same call makes sense. Core decides, not this surface. */
     get retryable(): boolean;
-    /** Отказ, развёрнутый для агента: числа, императив, признак повтора. */
+    /** The refusal expanded for an agent: numbers, instruction, retry flag. */
     report(): AgentFailureReport;
 }
 export declare class ClipwrightClient {
     #private;
     constructor(opts: ClipwrightClientOptions);
-    /** Оценка стоимости без списания кредитов. */
+    /** Cost estimate; spends no credits. */
     quoteUgc(input: MakeUgcInputArgs): Promise<QuoteResponse>;
-    /**
-     * Запуск генерации; возвращает ран сразу (state=queued).
-     *
-     * Ключ идемпотентности формируется ЗДЕСЬ, а не на вызывающей поверхности:
-     * суффикс `:N` (по `attempt`, дефолт 1) пишется ВСЕГДА, иначе MCP дал бы
-     * `<hash>`, а CLI `<hash>:1` — межповерхностный шов, в котором дедуп ломается.
-     */
+    /** Starts a render and returns the run at once (state=queued). The key is built */
+    /** here with an always-present `:N` suffix, so MCP and CLI dedupe alike. */
     startUgc(input: MakeUgcInputArgs, opts?: StartUgcOptions): Promise<Run>;
-    /**
-     * Курируемый каталог голосов для `voice`/`voice_id` (US-516). Отдаёт то же,
-     * что и `/v1/voices` — статический список из @clipwright/core, БЕЗ вендорских
-     * id (они не покидают адаптер воркера). Каталог курируемый по дизайну: это
-     * не полный список голосов вендора — остальные достижимы сырым `voice_id`.
-     */
+    /** Uploads an image; returns its reference for later runs. */
     uploadImage(bytes: Uint8Array<ArrayBuffer>, mediaType: UploadMediaType): Promise<UploadResponse>;
+    /** Curated voice catalog for `voice`/`voice_id`; other voices stay reachable by raw `voice_id`. */
     listVoices(filters?: VoicesQuery): Promise<VoiceCatalogEntry[]>;
-    /** Состояние счёта — `GET /v1/account` (clipwright#135). Бесплатно. */
+    /** Account state via `GET /v1/account`. Free. */
     getAccount(): Promise<Account>;
     listActors(): Promise<ActorCatalogEntry[]>;
     getActorDefaults(id: string): Promise<ActorDefaults>;
     setActorDefaults(id: string, input: ActorDefaultsInput): Promise<ActorDefaults>;
-    /** Оценка `create_actor` без списания кредитов (clipwright#120). */
+    /** `create_actor` estimate; spends no credits. */
     quoteActor(input: CreateActorInputArgs): Promise<CreateActorQuote>;
-    /** Запуск `create_actor`: ран возвращается сразу (state=queued), как у `startUgc`. */
-    /** Ключ строится СВОЕЙ схемой — разбор `make_ugc` срезал бы поля актёра. */
+    /** Starts `create_actor`; returns the run at once (state=queued), like `startUgc`. */
+    /** The key uses its own schema: the `make_ugc` one would strip actor fields. */
     createActor(input: CreateActorInputArgs, opts?: StartUgcOptions): Promise<Run>;
-    /** Удаление личного актёра. Ответ 204 без тела, поэтому разбирать нечего. */
+    /** Deletes a personal actor. The answer is 204 with no body. */
     deleteActor(id: string): Promise<void>;
-    /**
-     * Чтение рана в ТОЛЕРАНТНОЙ проекции (`runRead`, `state: string`): сервер мог
-     * добавить стадию, которой не знает установленный SDK (docs/12:198). Поэтому
-     * `safeParse` с деградацией к сырому телу вместо строгого `run.parse` — иначе
-     * неизвестная стадия уронила бы `getRun` у каждого уже установленного MCP.
-     * Тип возврата — `RunRead` (`state: string`), а НЕ узкий `Run` (условие
-     * Architect №3): иначе `isTerminal(state)` не типчекнулся бы и потребители
-     * приняли бы `state` за закрытый enum.
-     */
+    /** Reads a run tolerantly (`state: string`): a newer server stage must not */
+    /** break installed clients, so parsing falls back to the raw body. */
     getRun(runId: string): Promise<RunRead>;
-    /** Запуск + поллинг до терминального состояния. `attempt` пробрасывается внутрь, */
-    /** `maxWaitMs` — дедлайн, обрывающий и паузу, и сам запрос. */
+    /** Start plus polling to a terminal state. `maxWaitMs` is one deadline that */
+    /** aborts both the pause and the request itself. */
     makeUgc(input: MakeUgcInputArgs, opts?: MakeUgcOptions, onProgress?: (run: RunRead) => void): Promise<RunRead>;
 }
 export { resolveClientId } from "./client-id.js";

package/dist/index.js

@@ -1,43 +1,18 @@
 import { account as accountSchema, ACTORS_PATH, actorDefaults, actorDefaultsPath, actorItemPath, actorsResponse, CREATE_ACTOR_QUOTE_PATH, CREATE_ACTOR_RUN_PATH, createActorQuote, agentFailureReport, isRetryableFailure, parseApiFailure, PUBLIC_API_BASE_URL, retryDelayMs, run as runSchema, runRead as runReadSchema, isTerminal, FAILED_STATE, quoteResponse, RETRY_AFTER_HEADER, UPLOADS_PATH, uploadResponse, voicesResponse, } from "@clipwright/core";
 import { actorIdempotencyKeyFor, idempotencyKeyFor } from "@clipwright/core/idempotency";
 import { resolveClientId } from "./client-id.js";
-/**
- * Прод-API по умолчанию: SDK «просто работает» без явного baseUrl.
- *
- * Значение приезжает из `@clipwright/core` (US-614): тот же адрес печатает
- * лендинг в копируемой команде `curl`, и два литерала разошлись бы так, что
- * заметил бы это посетитель. Разбор — у самой константы.
- */
+/** Production API by default; shared with core so every surface names one address. */
 const DEFAULT_BASE_URL = PUBLIC_API_BASE_URL;
-/** Дефолтный дедлайн поллинга: ≥5× над проекцией рендера (~113 с, docs/13). */
+/** Default polling deadline: several times the expected render time. */
 const DEFAULT_MAX_WAIT_MS = 600_000;
-/** Срок одного запроса по умолчанию. У `fetch` в Node таймаута НЕТ: принятое, но */
-/** молчащее соединение висит вечно, и дедлайн вызова его не снимает. */
+/** Default per-request timeout. Node's `fetch` has none, so a silent */
+/** accepted connection would hang forever. */
 const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
-/**
- * Потолок ОДНОГО `setTimeout` — 2^31−1 мс (примерно 24.8 суток).
- *
- * ЧТО БЫВАЕТ БЕЗ УЧЁТА ЭТОГО ПРЕДЕЛА, проверено запуском:
- * `setTimeout(fn, 2_592_000_000)` (тридцать суток) печатает
- * `TimeoutOverflowWarning` и стреляет ЧЕРЕЗ 0 мс. То есть самая длинная пауза
- * превращается в её полное отсутствие, и клиент, которому сервер велел
- * подождать тридцать суток, начинает долбить его без пауз.
- *
- * Живёт этот предел в SDK, а не в `@clipwright/core`, потому что он — свойство
- * платформы, а не контракта: `retryDelayMs` обязан честно возвращать то, что
- * назначил сервер.
- */
+/** Max delay of ONE `setTimeout` (2^31−1 ms); a larger value fires after 0 ms. */
+/** A platform limit, so it lives here and not in core. */
 const MAX_TIMER_DELAY_MS = 2_147_483_647;
-/**
- * Длительность в миллисекундах — или внятный отказ на входе.
- *
- * ОТКАЗ ГРОМКИЙ, А НЕ ТИХАЯ ПОДСТАНОВКА ДЕФОЛТА. `Number(process.env.POLL_MS)`
- * на незаданной переменной даёт `NaN`, и молчаливая замена его пятью секундами
- * скрыла бы от вызывателя, что его настройка не применилась. Здесь он узнаёт об
- * этом на первой же строке, а не по странному поведению поллинга.
- *
- * `undefined` — законный вход: это «не задавал», и тогда берётся дефолт.
- */
+/** Milliseconds, or a loud rejection: silently defaulting a `NaN` would hide */
+/** a misconfiguration. `undefined` means "not set" and takes the fallback. */
 function positiveMs(value, fallback, name) {
     if (value === undefined)
         return fallback;
@@ -46,32 +21,15 @@ function positiveMs(value, fallback, name) {
     }
     return value;
 }
-/**
- * ОТВЕТ СЕРВЕРА НЕ РАЗОБРАЛСЯ — ЭТО НЕ ТО ЖЕ, ЧТО ОТКАЗ ВВОДА (US-622).
- *
- * Обе беды приходят из zod и до этого класса были неотличимы снаружи: и
- * `makeUgcInput.parse` на входе, и `run.parse` на ответе бросали `ZodError`.
- * Внешнее ревью (круг 9) показало цену этой неразличимости. CLI печатал любую
- * такую ошибку как «запрос отвергнут ДО отправки» — а на битом ответе `POST
- * /run` это ложь в самую дорогую сторону: запрос ушёл, ран создан и, возможно,
- * уже оплачен, но человеку сказано, что ничего не произошло, и `run_id` он не
- * получил.
- *
- * Поэтому провал разбора ОТВЕТА получает собственный класс и собственный текст,
- * который прямо называет, мог ли вызов иметь последствия.
- */
+/** An unparseable server response, distinct from rejected input: after */
+/** `POST /run` the run may already exist and be charged. */
 export class ClipwrightResponseError extends Error {
-    /** Путь, ответ которого не разобрался. */
+    /** Path whose response failed to parse. */
     path;
-    /** Мог ли запрос уже что-то изменить (создать ран, потратить деньги). */
+    /** Whether the request may already have changed state (created a run, spent credits). */
     mayHaveTakenEffect;
-    /**
-     * ПОДТВЕРЖДЕНА ли доставка запроса. Имя выбрано точно (внешнее ревью, круг 12):
-     * прежнее `delivered` читалось как «не доставлено», хотя `false` означает лишь
-     * ОТСУТСТВИЕ ПОДТВЕРЖДЕНИЯ. Отличить «не дошло» от «дошло, а ответ потерян»
-     * у HTTP способа нет, и потребитель, прочитавший поле как отрицание, запустил
-     * бы `attempt: 2` и оплатил второй рендер.
-     */
+    /** `false` means delivery is unconfirmed, not that it failed: HTTP cannot */
+    /** tell a lost request from a lost response. */
     deliveryConfirmed;
     constructor(path, mayHaveTakenEffect, cause, deliveryConfirmed = true) {
         super(ClipwrightResponseError.#describe(path, mayHaveTakenEffect, deliveryConfirmed), { cause });
@@ -80,19 +38,8 @@ export class ClipwrightResponseError extends Error {
         this.mayHaveTakenEffect = mayHaveTakenEffect;
         this.deliveryConfirmed = deliveryConfirmed;
     }
-    /**
-     * Три разных новости, а не одна (внешнее ревью, круги 9-11).
-     *
-     * Разница между ними — деньги. Сказать «ничего не произошло» там, где ран уже
-     * создан, значит подтолкнуть человека к `--retry 2`, то есть ко второму
-     * платному рендеру. Сказать «возможно, вы заплатили» на неудачном `quote`
-     * значит пугать без причины и обесценить предупреждение там, где оно нужно.
-     *
-     * НИ ОДИН ИЗ ТРЁХ ТЕКСТОВ НЕ НАЗЫВАЕТ ВИНОВНИКА. Ответ не по контракту с тем
-     * же успехом мог прислать шлюз или CDN, а не наш сервер; ровно за эту
-     * бездоказательную атрибуцию внешнее ревью сняло две прежние формулировки
-     * (круги 13 и 14), и здесь она повторена не будет.
-     */
+    /** Three messages because the money differs; none blames the server, since a */
+    /** gateway or CDN may have sent the off-contract response. */
     static #describe(path, mayHaveTakenEffect, deliveryConfirmed) {
         if (!mayHaveTakenEffect) {
             return deliveryConfirmed
@@ -116,58 +63,25 @@ function parseResponse(schema, body, path, mayHaveTakenEffect) {
         throw new ClipwrightResponseError(path, mayHaveTakenEffect, cause);
     }
 }
-/**
- * Номер попытки → суффикс ключа идемпотентности. С отказом на мусоре.
- *
- * ЗДЕСЬ ПРОХОДИТ ДЕНЕЖНАЯ ГРАНИЦА, и молчаливого прохода на ней быть не должно.
- * Суффикс участвует в ключе, а РАЗНЫЙ ключ — это РАЗНЫЙ платный рендер. Пока
- * проверки не было, `?? 1` ловил только `null`/`undefined`, и `NaN` доезжал
- * до ключа как строка `:NaN`: ключ отличался от `:1`, сервер видел новый
- * запрос и запускал вторую платную генерацию. Внешнее ревью (круг 5) нашло
- * живой путь до этого входа — `clipwright make --retry banana`, где
- * `parseInt("banana")` даёт `NaN`.
- *
- * Отказ громкий, потому что тихий здесь стоит денег: пользователь, опечатавшийся
- * в номере попытки, получит сообщение, а не счёт.
- */
+/** Attempt number → idempotency key suffix. A different key is a different paid */
+/** render, so garbage such as `NaN` is rejected instead of passed through. */
 function attemptSuffix(attempt) {
     if (attempt === undefined)
         return 1;
-    // `isSafeInteger`, а НЕ `isInteger` (внешнее ревью, круг 7). За пределом
-    // безопасного диапазона разные числа сливаются в одно: `9007199254740993`
-    // становится `…992` (проверено запуском). Два РАЗНЫХ номера попытки дали бы
-    // один суффикс, то есть один ключ, — и запрошенный новый платный рендер молча
-    // вернул бы прежний ран.
+    // `isSafeInteger`: beyond the safe range distinct numbers collapse into one,
+    // and a requested new render would silently return the old run.
     if (!Number.isSafeInteger(attempt) || attempt < 1) {
         throw new TypeError(`attempt must be a positive integer (1, 2, 3, …), got ${String(attempt)}. ` +
             "It selects which paid run to deduplicate against, so a wrong value can start a second render.");
     }
     return attempt;
 }
-/**
- * Сон произвольной длины — ЦЕПОЧКОЙ таймеров, а не одним обрезанным.
- *
- * ПОЧЕМУ НЕ ПРОСТО ОБРЕЗАТЬ. Первая редакция ограничивала сон потолком выше и
- * объясняла это тем, что цикл всё равно перепроверит условия. Внешнее ревью
- * (круг 2) показало, что объяснение неверно: сразу после сна цикл делает
- * `getRun()`, поэтому обрезка — это не «более ранняя перепроверка», а более
- * ранний ЗАПРОС. На паузе в тридцать суток второй запрос уходил бы через 24.86
- * суток — на пять суток раньше разрешённого сервером времени, то есть ровно то
- * нарушение, ради недопущения которого пауза и соблюдается.
- *
- * Цепочка сохраняет и предел платформы, и назначенную длительность.
- */
+/** Sleep of any length as a CHAIN of timers: clamping would send the next */
+/** request earlier than the server allowed. */
 function sleep(ms) {
     return new Promise((resolve) => {
-        // НЕ-ЧИСЛО ОБЯЗАНО ЗАВЕРШИТЬ СОН, А НЕ ПРОДЛИТЬ ЕГО НАВСЕГДА (внешнее ревью,
-        // круг 3). С `NaN` условие `left <= 0` ложно ВСЕГДА, `setTimeout(tick, NaN)`
-        // Node трактует как одну миллисекунду, и цикл планирует таймеры до
-        // скончания века: промис не завершается, дедлайн больше не проверяется, а
-        // таймер держит процесс Node живым — `clipwright make` не вернул бы
-        // управление вовсе. Сюда `NaN` попадает из `pollIntervalMs`, вычисленного
-        // вызывателем (`Number(process.env.…)`); конструктор такой ввод теперь
-        // отвергает, но защита стоит и здесь: у цикла с таймерами цена ошибки —
-        // зависший процесс, а не неверное число.
+        // A non-number must end the sleep: with `NaN` the loop would schedule
+        // timers forever and keep the process alive.
         let left = Number.isFinite(ms) ? Math.max(ms, 0) : 0;
         const tick = () => {
             if (left <= 0) {
@@ -181,48 +95,32 @@ function sleep(ms) {
         tick();
     });
 }
-/**
- * ОТКАЗ API, ДОЕХАВШИЙ ДО ВЫЗЫВАТЕЛЯ ЦЕЛИКОМ (US-622).
- *
- * ЧТО БЫЛО ДО. `#request` сводил любой не-2xx к `new Error(message)`: статус,
- * код и назначенная сервером пауза терялись на границе SDK. Вызыватель мог
- * только напечатать текст — отличить «подожди две секунды» от «пополни счёт»
- * было нечем, и поллинг умирал на первом же 429.
- *
- * ЧЕГО ЗДЕСЬ НАМЕРЕННО НЕТ — СВОЕЙ ФОРМЫ ОТКАЗА. Класс не объявляет ни кодов,
- * ни полей с числами: всё это лежит в `ApiFailure` из `@clipwright/core`, и
- * `code`/`report()` выводятся оттуда же (правило проекта №2). Объяви SDK свою
- * копию — и MCP с CLI получили бы вторую, а «повторять или нет» стало бы
- * вопросом, на который три поверхности отвечают порознь.
- */
+/** An API refusal with status, code and server-set pause intact. The shape */
+/** comes from core, so SDK, CLI and MCP answer "retry or not" identically. */
 export class ClipwrightApiError extends Error {
-    /** Разобранный отказ: вид, числа, пауза. Форма — из core. */
+    /** Parsed refusal: kind, numbers, pause. Shape comes from core. */
     failure;
     status;
-    /** Код отказа. Для чужих тел без кода — `http_<status>`. */
+    /** Refusal code; `http_<status>` for foreign bodies without one. */
     code;
-    /** Пауза в секундах, назначенная сервером. `undefined` — он её не назвал. */
+    /** Server-set pause in seconds; `undefined` if the server named none. */
     retryAfterSeconds;
     constructor(failure) {
         super(failure.message);
         this.name = "ClipwrightApiError";
         this.failure = failure;
         this.status = failure.status;
-        // И КОД, И ПАУЗА БЕРУТСЯ ИЗ ОБЩЕГО РАЗВЁРТЫВАНИЯ, а не выводятся здесь по
-        // второму разу. Разъехавшись, `error.code` в CLI и `code` в ответе MCP
-        // говорили бы об одном отказе разными словами. Плюс следствие, которое
-        // поймал сканер источников: перечисляя виды отказа тут (`failure.kind ===
-        // …`), эта поверхность заводила бы у себя копию их названий — то есть
-        // ровно тот второй источник, который правило проекта №2 запрещает.
+        // Code and pause come from the shared report, so CLI and MCP name one
+        // refusal with the same words.
         const report = agentFailureReport(failure);
         this.code = report.code;
         this.retryAfterSeconds = report.retry_after_seconds;
     }
-    /** Имеет ли смысл повторить тот же вызов. Решает core, а не эта поверхность. */
+    /** Whether repeating the same call makes sense. Core decides, not this surface. */
     get retryable() {
         return isRetryableFailure(this.failure);
     }
-    /** Отказ, развёрнутый для агента: числа, императив, признак повтора. */
+    /** The refusal expanded for an agent: numbers, instruction, retry flag. */
     report() {
         return agentFailureReport(this.failure);
     }
@@ -232,13 +130,8 @@ export class ClipwrightClient {
     #baseUrl;
     #pollIntervalMs;
     #requestTimeoutMs;
-    /**
-     * [A5] Идентичность установки резолвится ЛЕНИВО (при первом старте рана) и
-     * кэшируется здесь. Конструктор её НЕ трогает: MCP-сервер строит клиент НА
-     * ИМПОРТЕ модуля, ДО `server.connect`; если бы резолвер (пишущий в ~/.clipwright)
-     * падал в конструкторе на read-only HOME, он убил бы ВЕСЬ MCP, включая
-     * `quote_ugc`, которому clientId вообще не нужен.
-     */
+    /** Resolved lazily on first run start: the MCP server builds the client at */
+    /** import, and a read-only HOME must not break tools that never need it. */
     #clientId;
     constructor(opts) {
         this.#apiKey = opts.apiKey;
@@ -246,40 +139,23 @@ export class ClipwrightClient {
         this.#pollIntervalMs = positiveMs(opts.pollIntervalMs, 5_000, "pollIntervalMs");
         this.#requestTimeoutMs = positiveMs(opts.requestTimeoutMs, DEFAULT_REQUEST_TIMEOUT_MS, "requestTimeoutMs");
     }
-    /** Ленивый резолв + кэш идентичности установки (см. `#clientId`). */
+    /** Lazy resolve and cache of the install identity (see `#clientId`). */
     #getClientId() {
         if (this.#clientId === undefined) {
             this.#clientId = resolveClientId();
         }
         return this.#clientId;
     }
-    /**
-     * Один запрос к API.
-     *
-     * ТЕЛО ЧИТАЕТСЯ ТЕКСТОМ, А НЕ `res.json()`, и это не стилистика (US-622).
-     * `res.json()` на не-JSON бросает `SyntaxError` ДО того, как мы посмотрели на
-     * статус, — и вызыватель видит «Unexpected token <» вместо «слишком часто».
-     * Отдать HTML-страницу вместо нашего тела может любой прокси между клиентом и
-     * API: edge тарифа, корпоративный шлюз, страница обслуживания. Разбор текста
-     * в `parseApiFailure` эту ветку закрывает, потому что решение принимается по
-     * статусу, а тело лишь уточняет причину.
-     */
+    /** One API request. The body is read as text, not `res.json()`: a proxy may */
+    /** return HTML, and the status must decide before the body is parsed. */
     async #request(path, 
-    /**
-     * Мог ли ЭТОТ вызов что-то изменить на сервере. Знает это только вызыватель,
-     * и знание обязано дойти сюда: провал разбора успешного ответа на `POST
-     * /run` и на `GET /voices` — разные новости, и молчать о разнице дороже
-     * всего именно там, где ран уже мог быть создан и оплачен.
-     */
+    /** Whether THIS call could change server state; only the caller knows. */
     mayHaveTakenEffect, init) {
-        // ВСЁ, ЧТО МОЖЕТ УПАСТЬ ПОСЛЕ ОТПРАВКИ, ЛОВИТСЯ ОДИНАКОВО (внешнее ревью,
-        // круг 11). Обрыв на чтении тела бросал голый `TypeError` мимо
-        // предупреждения про деньги — то есть ровно там, где ран уже создан, клиент
-        // молчал о последствиях. Сюда же отнесён и провал самого `fetch`: доставку
-        // он не опровергает, и на платном пути честнее сказать «неизвестно».
+        // Anything failing after send is reported alike: a failed `fetch` does not
+        // disprove delivery, so a paid path says "unknown".
         let res;
-        // ОТМЕНА ДОХОДИТ ДО СЕТИ: свой срок у каждого запроса плюс сигнал вызывателя.
-        // Сигнал ВЫНУТ из `init` — иначе срок запроса обходился бы мимо этой строки.
+        // Cancellation reaches the network: a per-request timeout plus the caller's
+        // signal, pulled out of `init` so it cannot bypass the timeout.
         const { signal: callerSignal, ...rest } = init ?? {};
         const timeout = AbortSignal.timeout(this.#requestTimeoutMs);
         const signal = callerSignal ? AbortSignal.any([callerSignal, timeout]) : timeout;
@@ -295,27 +171,24 @@ export class ClipwrightClient {
             });
         }
         catch (cause) {
-            // На бесплатных путях сетевой сбой остаётся собой: своё сообщение (DNS,
-            // отказ соединения) полезнее нашей обёртки, а денег там нет.
+            // On free paths the network error stays itself: its own message (DNS,
+            // refused connection) is more useful than our wrapper.
             if (!mayHaveTakenEffect)
                 throw cause;
             throw new ClipwrightResponseError(path, true, cause, false);
         }
-        // ЗАГОЛОВКИ ЧИТАЮТСЯ ДО ТЕЛА, потому что тело может и не дочитаться.
+        // Headers are read before the body, which may never finish arriving.
         const retryAfterHeader = res.headers.get(RETRY_AFTER_HEADER);
         let bodyText;
         try {
             bodyText = await res.text();
         }
         catch (cause) {
-            // ОБРЫВ ЧТЕНИЯ НЕ СМЕЕТ СТИРАТЬ УЖЕ ИЗВЕСТНЫЙ СТАТУС (внешнее ревью,
-            // круг 12). Первая редакция объявляла любой такой обрыв нарушением
-            // контракта — и 429 на поллинге переставал быть ретрайным: `makeUgc`
-            // бросал уже оплаченный ран вместо того, чтобы выждать паузу. Статус и
-            // заголовки к этому моменту получены целиком, их и достаточно.
+            // A broken body read must not erase a known status: a 429 while polling
+            // stays retryable instead of abandoning a paid run.
             if (!res.ok) {
                 throw new ClipwrightApiError(
-                // `undefined`, а не пустая строка: тело не пустое, оно НЕДОСТУПНО.
+                // `undefined`, not an empty string: the body is unavailable, not empty.
                 parseApiFailure({ status: res.status, bodyText: undefined, retryAfterHeader }));
             }
             throw new ClipwrightResponseError(path, mayHaveTakenEffect, cause);
@@ -327,25 +200,20 @@ export class ClipwrightClient {
                 retryAfterHeader,
             }));
         }
-        // 204 — «тела нет» по HTTP, и так отвечает удаление актёра. Разбор пустой
-        // строки объявил бы это нарушением контракта, которого не было.
+        // 204 means "no body" (actor deletion answers so); parsing the empty string
+        // would report a contract violation that never happened.
         if (res.status === 204)
             return undefined;
         try {
             return JSON.parse(bodyText);
         }
         catch (cause) {
-            // ТОТ ЖЕ КЛАСС, ЧТО И У ПРОВАЛА СХЕМЫ (внешнее ревью, круг 10). Первая
-            // редакция бросала здесь обычный `Error`, и он проскакивал МИМО
-            // предупреждения «ран мог быть создан и оплачен»: сервер, ответивший на
-            // `POST /run` пустым телом или HTML, оставлял человека в уверенности, что
-            // ничего не произошло, — и следующий шаг `--retry 2` оплачивал второй
-            // рендер. Тело не-JSON и тело не по схеме — одна и та же беда, «ответ не
-            // соответствует контракту», и говорить о ней надо одинаково.
+            // Same class as a schema failure: a non-JSON body is also an off-contract
+            // response and must carry the "may have been charged" warning.
             throw new ClipwrightResponseError(path, mayHaveTakenEffect, cause);
         }
     }
-    /** Оценка стоимости без списания кредитов. */
+    /** Cost estimate; spends no credits. */
     async quoteUgc(input) {
         const body = await this.#request("/v1/skills/make_ugc/quote", false, {
             method: "POST",
@@ -353,35 +221,24 @@ export class ClipwrightClient {
         });
         return parseResponse(quoteResponse, body, "/v1/skills/make_ugc/quote", false);
     }
-    /**
-     * Запуск генерации; возвращает ран сразу (state=queued).
-     *
-     * Ключ идемпотентности формируется ЗДЕСЬ, а не на вызывающей поверхности:
-     * суффикс `:N` (по `attempt`, дефолт 1) пишется ВСЕГДА, иначе MCP дал бы
-     * `<hash>`, а CLI `<hash>:1` — межповерхностный шов, в котором дедуп ломается.
-     */
+    /** Starts a render and returns the run at once (state=queued). The key is built */
+    /** here with an always-present `:N` suffix, so MCP and CLI dedupe alike. */
     async startUgc(input, opts) {
         return this.#startUgc(input, opts);
     }
-    /** `signal` приходит только изнутри: дедлайн `makeUgc` обрывает и сам старт. */
+    /** `signal` is internal only: the `makeUgc` deadline also aborts the start. */
     async #startUgc(input, opts, signal) {
         const key = opts?.idempotencyKey ?? `${idempotencyKeyFor(input, this.#getClientId())}:${attemptSuffix(opts?.attempt)}`;
-        // `true`: запрос уже ушёл, ран мог быть создан и оплачен.
+        // `true`: once sent, the run may have been created and charged.
         const body = await this.#request("/v1/skills/make_ugc/run", true, {
             method: "POST",
             body: JSON.stringify(input),
             headers: { "Idempotency-Key": key },
             signal: signal ?? null,
         });
-        // `hasSideEffect: true` — запрос уже ушёл и ран мог быть создан и оплачен.
         return parseResponse(runSchema, body, "/v1/skills/make_ugc/run", true);
     }
-    /**
-     * Курируемый каталог голосов для `voice`/`voice_id` (US-516). Отдаёт то же,
-     * что и `/v1/voices` — статический список из @clipwright/core, БЕЗ вендорских
-     * id (они не покидают адаптер воркера). Каталог курируемый по дизайну: это
-     * не полный список голосов вендора — остальные достижимы сырым `voice_id`.
-     */
+    /** Uploads an image; returns its reference for later runs. */
     async uploadImage(bytes, mediaType) {
         const body = await this.#request(UPLOADS_PATH, true, {
             method: "POST",
@@ -390,15 +247,16 @@ export class ClipwrightClient {
         });
         return parseResponse(uploadResponse, body, UPLOADS_PATH, true);
     }
+    /** Curated voice catalog for `voice`/`voice_id`; other voices stay reachable by raw `voice_id`. */
     async listVoices(filters = {}) {
-        // Ключи уходят как есть: незнакомый параметр отвергает сервер (`unknown_field`), а не срезает клиент.
+        // Keys pass as is: the server rejects an unknown one (`unknown_field`); the client does not strip it.
         const query = new URLSearchParams(Object.entries(filters).flatMap(([key, value]) => (value === undefined ? [] : [[key, String(value)]]))).toString();
         const body = await this.#request(query === "" ? "/v1/voices" : `/v1/voices?${query}`, false);
-        // ТОЙ ЖЕ СХЕМОЙ, ЧТО ОТДАЁТ СЕРВЕР. `Array.isArray` пропускал массив чего
-        // угодно: вызыватель падал на `.map` над строками, вдали от причины.
+        // Parsed with the server's own schema, so a malformed body fails here and
+        // not later in the caller.
         return parseResponse(voicesResponse, body, "/v1/voices", false).voices;
     }
-    /** Состояние счёта — `GET /v1/account` (clipwright#135). Бесплатно. */
+    /** Account state via `GET /v1/account`. Free. */
     async getAccount() {
         const body = await this.#request("/v1/account", false);
         return parseResponse(accountSchema, body, "/v1/account", false);
@@ -416,7 +274,7 @@ export class ClipwrightClient {
         const body = await this.#request(path, false, { method: "POST", body: JSON.stringify(input) });
         return parseResponse(actorDefaults, body, path, false);
     }
-    /** Оценка `create_actor` без списания кредитов (clipwright#120). */
+    /** `create_actor` estimate; spends no credits. */
     async quoteActor(input) {
         const body = await this.#request(CREATE_ACTOR_QUOTE_PATH, false, {
             method: "POST",
@@ -424,12 +282,12 @@ export class ClipwrightClient {
         });
         return parseResponse(createActorQuote, body, CREATE_ACTOR_QUOTE_PATH, false);
     }
-    /** Запуск `create_actor`: ран возвращается сразу (state=queued), как у `startUgc`. */
-    /** Ключ строится СВОЕЙ схемой — разбор `make_ugc` срезал бы поля актёра. */
+    /** Starts `create_actor`; returns the run at once (state=queued), like `startUgc`. */
+    /** The key uses its own schema: the `make_ugc` one would strip actor fields. */
     async createActor(input, opts) {
         const key = opts?.idempotencyKey ??
             `${actorIdempotencyKeyFor(input, this.#getClientId())}:${attemptSuffix(opts?.attempt)}`;
-        // `true`: запрос уже ушёл, ран мог быть создан и оплачен.
+        // `true`: once sent, the run may have been created and charged.
         const body = await this.#request(CREATE_ACTOR_RUN_PATH, true, {
             method: "POST",
             body: JSON.stringify(input),
@@ -437,60 +295,47 @@ export class ClipwrightClient {
         });
         return parseResponse(runSchema, body, CREATE_ACTOR_RUN_PATH, true);
     }
-    /** Удаление личного актёра. Ответ 204 без тела, поэтому разбирать нечего. */
+    /** Deletes a personal actor. The answer is 204 with no body. */
     async deleteActor(id) {
         await this.#request(actorItemPath(id), true, { method: "DELETE" });
     }
-    /**
-     * Чтение рана в ТОЛЕРАНТНОЙ проекции (`runRead`, `state: string`): сервер мог
-     * добавить стадию, которой не знает установленный SDK (docs/12:198). Поэтому
-     * `safeParse` с деградацией к сырому телу вместо строгого `run.parse` — иначе
-     * неизвестная стадия уронила бы `getRun` у каждого уже установленного MCP.
-     * Тип возврата — `RunRead` (`state: string`), а НЕ узкий `Run` (условие
-     * Architect №3): иначе `isTerminal(state)` не типчекнулся бы и потребители
-     * приняли бы `state` за закрытый enum.
-     */
+    /** Reads a run tolerantly (`state: string`): a newer server stage must not */
+    /** break installed clients, so parsing falls back to the raw body. */
     async getRun(runId) {
         return this.#getRun(runId);
     }
-    /** `signal` приходит только изнутри: дедлайн `makeUgc` обрывает и сам опрос. */
+    /** `signal` is internal only: the `makeUgc` deadline also aborts the poll. */
     async #getRun(runId, signal) {
         const body = await this.#request(`/v1/runs/${runId}`, false, { signal: signal ?? null });
         const parsed = runReadSchema.safeParse(body);
         return parsed.success ? parsed.data : body;
     }
-    /** Запуск + поллинг до терминального состояния. `attempt` пробрасывается внутрь, */
-    /** `maxWaitMs` — дедлайн, обрывающий и паузу, и сам запрос. */
+    /** Start plus polling to a terminal state. `maxWaitMs` is one deadline that */
+    /** aborts both the pause and the request itself. */
     async makeUgc(input, opts, onProgress) {
         const maxWaitMs = positiveMs(opts?.maxWaitMs, DEFAULT_MAX_WAIT_MS, "maxWaitMs");
         const deadline = Date.now() + maxWaitMs;
-        // Дедлайн как сигнал отмены; потолок таймера — тот же, что у `sleep`.
+        // The deadline as an abort signal, capped like `sleep`.
         const callDeadline = AbortSignal.timeout(Math.min(maxWaitMs, MAX_TIMER_DELAY_MS));
-        // Тип расширяем до `RunRead`: дальше сюда присваивается толерантный `getRun`.
-        // Оборванный дедлайном СТАРТ летит наружу как есть — ран мог быть оплачен.
+        // Widened to `RunRead` for the tolerant `getRun`. A start aborted by the
+        // deadline propagates as is: the run may have been charged.
         let current = await this.#startUgc(input, { attempt: opts?.attempt }, callDeadline);
-        // Пауза перед СЛЕДУЮЩИМ опросом. Обычно это интервал поллинга; отбитый
-        // опрос заменяет её паузой, назначенной сервером (US-622).
+        // Pause before the NEXT poll; a refused poll replaces it with the server's.
         let nextDelayMs = this.#pollIntervalMs;
-        // Последний отбитый опрос — только чтобы объяснить таймаут. Ран, который
-        // упёрся в дедлайн из-за 429, и ран, который просто долго рендерится, — это
-        // разные новости, и человеку они нужны разными.
+        // Kept only to explain a timeout: throttled and merely slow runs differ.
         let lastRetried;
-        /** Один текст таймаута на оба места, где дедлайн срабатывает. */
+        /** One timeout message for both places the deadline fires. */
         const timedOut = () => new Error(`makeUgc timed out after ${maxWaitMs}ms; run ${current.run_id} is still ` +
             `${current.state}. Poll it later with getRun("${current.run_id}").` +
             (lastRetried === undefined
                 ? ""
                 : ` The last status check was refused with HTTP ${lastRetried.status}: ` +
                     `${lastRetried.message}`));
-        // Терминальность — через разделяемый `isTerminal`, а не литералы: неизвестный
-        // ТЕРМИНАЛЬНЫЙ статус сервера (`isTerminal=false`) осознанно поллится до
-        // `maxWaitMs` и даёт чистый таймаут с `run_id`, а не вечный цикл (PM4).
+        // Shared `isTerminal`: an unknown server state is polled until `maxWaitMs`
+        // and ends in a clean timeout with `run_id`, not an endless loop.
         while (!isTerminal(current.state)) {
-            // ДЕДЛАЙН ОДИН НА ВЕСЬ ВЫЗОВ И НЕ СБРАСЫВАЕТСЯ РЕТРАЕМ. `deadline`
-            // посчитан ДО цикла и здесь только читается: пересчитай его при отказе —
-            // и цепочка 429 продлевала бы ожидание бесконечно, ровно вопреки тому,
-            // ради чего `maxWaitMs` существует (US-207).
+            // One deadline per call, never reset by a retry; otherwise a chain of 429s
+            // would extend the wait forever.
             const remaining = deadline - Date.now();
             if (remaining <= 0)
                 throw timedOut();
@@ -501,16 +346,11 @@ export class ClipwrightClient {
                 onProgress?.(current);
             }
             catch (error) {
-                // Дедлайн, сорвавший сам опрос, — тот же таймаут, что и дедлайн между
-                // опросами: новость одна, значит и текст один.
+                // A deadline that aborts the poll itself is the same timeout.
                 if (callDeadline.aborted && !(error instanceof ClipwrightApiError))
                     throw timedOut();
-                // ОТБИТЫЙ ОПРОС — НЕ ПРОВАЛ РАНА. Ран уже запущен и уже оплачен: 429 на
-                // `GET /v1/runs/:id` до US-622 убивал `makeUgc` целиком, то есть бросал
-                // работу, за которую заплатили. Повторяем — но только то, что повторять
-                // ИМЕЕТ СМЫСЛ, и решает это core: 402 и прочие 4xx летят наружу
-                // немедленно, потому что повтор даст тот же ответ, а агент тем временем
-                // выест лимит частоты вместо того, чтобы сказать человеку правду.
+                // A refused poll is not a failed run: retry only what core calls
+                // retryable; 402 and other 4xx propagate at once.
                 if (!(error instanceof ClipwrightApiError) || !isRetryableFailure(error.failure)) {
                     throw error;
                 }
@@ -518,9 +358,8 @@ export class ClipwrightClient {
                 nextDelayMs = retryDelayMs(error.failure, this.#pollIntervalMs);
             }
         }
-        // Терминально: различение исхода — именованной константой core (не
-        // позиционным индексом массива: переупорядочивание молча инвертировало бы
-        // успех/провал).
+        // Outcome by core's named constant, not an array index that reordering
+        // could silently invert.
         if (current.state === FAILED_STATE) {
             throw new Error(current.error ?? "run failed");
         }

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipwright/sdk",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "TypeScript client for the Clipwright UGC video API",
   "license": "MIT",
   "author": "Dimantika Sp. z o.o.",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@clipwright/core": "0.18.0"
+    "@clipwright/core": "0.20.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.1"