@clipwright/sdk 0.1.0 → 0.2.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Dimantika LLC
+Copyright (c) 2026 Dimantika Sp. z o.o.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { type MakeUgcInput, type MakeUgcInputArgs, type QuoteResponse, type Run, type RunRead, type VoicePreset, type VoicePresetName } from "@clipwright/core";
+import { type AgentFailureReport, type ApiFailure, type MakeUgcInput, type MakeUgcInputArgs, type QuoteResponse, type Run, type RunRead, type VoicePreset, type VoicePresetName } from "@clipwright/core";
 export interface ClipwrightClientOptions {
     apiKey: string;
     baseUrl?: string | undefined;
@@ -18,10 +18,68 @@ export interface MakeUgcOptions {
     /** Дедлайн ожидания терминального состояния, мс (дефолт 10 мин). */
     maxWaitMs?: number | undefined;
 }
+/**
+ * ОТВЕТ СЕРВЕРА НЕ РАЗОБРАЛСЯ — ЭТО НЕ ТО ЖЕ, ЧТО ОТКАЗ ВВОДА (US-622).
+ *
+ * Обе беды приходят из zod и до этого класса были неотличимы снаружи: и
+ * `makeUgcInput.parse` на входе, и `run.parse` на ответе бросали `ZodError`.
+ * Внешнее ревью (круг 9) показало цену этой неразличимости. CLI печатал любую
+ * такую ошибку как «запрос отвергнут ДО отправки» — а на битом ответе `POST
+ * /run` это ложь в самую дорогую сторону: запрос ушёл, ран создан и, возможно,
+ * уже оплачен, но человеку сказано, что ничего не произошло, и `run_id` он не
+ * получил.
+ *
+ * Поэтому провал разбора ОТВЕТА получает собственный класс и собственный текст,
+ * который прямо называет, мог ли вызов иметь последствия.
+ */
+export declare class ClipwrightResponseError extends Error {
+    #private;
+    /** Путь, ответ которого не разобрался. */
+    readonly path: string;
+    /** Мог ли запрос уже что-то изменить (создать ран, потратить деньги). */
+    readonly mayHaveTakenEffect: boolean;
+    /**
+     * ПОДТВЕРЖДЕНА ли доставка запроса. Имя выбрано точно (внешнее ревью, круг 12):
+     * прежнее `delivered` читалось как «не доставлено», хотя `false` означает лишь
+     * ОТСУТСТВИЕ ПОДТВЕРЖДЕНИЯ. Отличить «не дошло» от «дошло, а ответ потерян»
+     * у HTTP способа нет, и потребитель, прочитавший поле как отрицание, запустил
+     * бы `attempt: 2` и оплатил второй рендер.
+     */
+    readonly deliveryConfirmed: boolean;
+    constructor(path: string, mayHaveTakenEffect: boolean, cause: unknown, deliveryConfirmed?: boolean);
+}
 /** Один пресет каталога `/v1/voices`, с именем — как отдаёт GET /v1/voices. */
 export interface VoiceCatalogEntry extends VoicePreset {
     name: VoicePresetName;
 }
+/**
+ * ОТКАЗ API, ДОЕХАВШИЙ ДО ВЫЗЫВАТЕЛЯ ЦЕЛИКОМ (US-622).
+ *
+ * ЧТО БЫЛО ДО. `#request` сводил любой не-2xx к `new Error(message)`: статус,
+ * код и назначенная сервером пауза терялись на границе SDK. Вызыватель мог
+ * только напечатать текст — отличить «подожди две секунды» от «пополни счёт»
+ * было нечем, и поллинг умирал на первом же 429.
+ *
+ * ЧЕГО ЗДЕСЬ НАМЕРЕННО НЕТ — СВОЕЙ ФОРМЫ ОТКАЗА. Класс не объявляет ни кодов,
+ * ни полей с числами: всё это лежит в `ApiFailure` из `@clipwright/core`, и
+ * `code`/`report()` выводятся оттуда же (правило проекта №2). Объяви SDK свою
+ * копию — и MCP с CLI получили бы вторую, а «повторять или нет» стало бы
+ * вопросом, на который три поверхности отвечают порознь.
+ */
+export declare class ClipwrightApiError extends Error {
+    /** Разобранный отказ: вид, числа, пауза. Форма — из core. */
+    readonly failure: ApiFailure;
+    readonly status: number;
+    /** Код отказа. Для чужих тел без кода — `http_<status>`. */
+    readonly code: string;
+    /** Пауза в секундах, назначенная сервером. `undefined` — он её не назвал. */
+    readonly retryAfterSeconds: number | undefined;
+    constructor(failure: ApiFailure);
+    /** Имеет ли смысл повторить тот же вызов. Решает core, а не эта поверхность. */
+    get retryable(): boolean;
+    /** Отказ, развёрнутый для агента: числа, императив, признак повтора. */
+    report(): AgentFailureReport;
+}
 export declare class ClipwrightClient {
     #private;
     constructor(opts: ClipwrightClientOptions);
@@ -64,4 +122,5 @@ export declare class ClipwrightClient {
     makeUgc(input: MakeUgcInputArgs, opts?: MakeUgcOptions, onProgress?: (run: RunRead) => void): Promise<RunRead>;
 }
 export { resolveClientId } from "./client-id.js";
+export type { AgentFailureReport, ApiFailure };
 export type { MakeUgcInput, MakeUgcInputArgs, QuoteResponse, Run, RunRead };

package/dist/index.js

@@ -1,10 +1,223 @@
-import { run as runSchema, runRead as runReadSchema, isTerminal, FAILED_STATE, quoteResponse, } from "@clipwright/core";
+import { agentFailureReport, isRetryableFailure, parseApiFailure, retryDelayMs, run as runSchema, runRead as runReadSchema, isTerminal, FAILED_STATE, quoteResponse, RETRY_AFTER_HEADER, } from "@clipwright/core";
 import { idempotencyKeyFor } from "@clipwright/core/idempotency";
 import { resolveClientId } from "./client-id.js";
 /** Прод-API по умолчанию: SDK «просто работает» без явного baseUrl. */
 const DEFAULT_BASE_URL = "https://api-production-7e69.up.railway.app";
 /** Дефолтный дедлайн поллинга: ≥5× над проекцией рендера (~113 с, docs/13). */
 const DEFAULT_MAX_WAIT_MS = 600_000;
+/**
+ * Потолок ОДНОГО `setTimeout` — 2^31−1 мс (примерно 24.8 суток).
+ *
+ * ЧТО БЫВАЕТ БЕЗ УЧЁТА ЭТОГО ПРЕДЕЛА, проверено запуском:
+ * `setTimeout(fn, 2_592_000_000)` (тридцать суток) печатает
+ * `TimeoutOverflowWarning` и стреляет ЧЕРЕЗ 0 мс. То есть самая длинная пауза
+ * превращается в её полное отсутствие, и клиент, которому сервер велел
+ * подождать тридцать суток, начинает долбить его без пауз.
+ *
+ * Живёт этот предел в SDK, а не в `@clipwright/core`, потому что он — свойство
+ * платформы, а не контракта: `retryDelayMs` обязан честно возвращать то, что
+ * назначил сервер.
+ */
+const MAX_TIMER_DELAY_MS = 2_147_483_647;
+/**
+ * Длительность в миллисекундах — или внятный отказ на входе.
+ *
+ * ОТКАЗ ГРОМКИЙ, А НЕ ТИХАЯ ПОДСТАНОВКА ДЕФОЛТА. `Number(process.env.POLL_MS)`
+ * на незаданной переменной даёт `NaN`, и молчаливая замена его пятью секундами
+ * скрыла бы от вызывателя, что его настройка не применилась. Здесь он узнаёт об
+ * этом на первой же строке, а не по странному поведению поллинга.
+ *
+ * `undefined` — законный вход: это «не задавал», и тогда берётся дефолт.
+ */
+function positiveMs(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new TypeError(`${name} must be a positive number of milliseconds, got ${String(value)}`);
+    }
+    return value;
+}
+/**
+ * ОТВЕТ СЕРВЕРА НЕ РАЗОБРАЛСЯ — ЭТО НЕ ТО ЖЕ, ЧТО ОТКАЗ ВВОДА (US-622).
+ *
+ * Обе беды приходят из zod и до этого класса были неотличимы снаружи: и
+ * `makeUgcInput.parse` на входе, и `run.parse` на ответе бросали `ZodError`.
+ * Внешнее ревью (круг 9) показало цену этой неразличимости. CLI печатал любую
+ * такую ошибку как «запрос отвергнут ДО отправки» — а на битом ответе `POST
+ * /run` это ложь в самую дорогую сторону: запрос ушёл, ран создан и, возможно,
+ * уже оплачен, но человеку сказано, что ничего не произошло, и `run_id` он не
+ * получил.
+ *
+ * Поэтому провал разбора ОТВЕТА получает собственный класс и собственный текст,
+ * который прямо называет, мог ли вызов иметь последствия.
+ */
+export class ClipwrightResponseError extends Error {
+    /** Путь, ответ которого не разобрался. */
+    path;
+    /** Мог ли запрос уже что-то изменить (создать ран, потратить деньги). */
+    mayHaveTakenEffect;
+    /**
+     * ПОДТВЕРЖДЕНА ли доставка запроса. Имя выбрано точно (внешнее ревью, круг 12):
+     * прежнее `delivered` читалось как «не доставлено», хотя `false` означает лишь
+     * ОТСУТСТВИЕ ПОДТВЕРЖДЕНИЯ. Отличить «не дошло» от «дошло, а ответ потерян»
+     * у HTTP способа нет, и потребитель, прочитавший поле как отрицание, запустил
+     * бы `attempt: 2` и оплатил второй рендер.
+     */
+    deliveryConfirmed;
+    constructor(path, mayHaveTakenEffect, cause, deliveryConfirmed = true) {
+        super(ClipwrightResponseError.#describe(path, mayHaveTakenEffect, deliveryConfirmed), { cause });
+        this.name = "ClipwrightResponseError";
+        this.path = path;
+        this.mayHaveTakenEffect = mayHaveTakenEffect;
+        this.deliveryConfirmed = deliveryConfirmed;
+    }
+    /**
+     * Три разных новости, а не одна (внешнее ревью, круги 9-11).
+     *
+     * Разница между ними — деньги. Сказать «ничего не произошло» там, где ран уже
+     * создан, значит подтолкнуть человека к `--retry 2`, то есть ко второму
+     * платному рендеру. Сказать «возможно, вы заплатили» на неудачном `quote`
+     * значит пугать без причины и обесценить предупреждение там, где оно нужно.
+     *
+     * НИ ОДИН ИЗ ТРЁХ ТЕКСТОВ НЕ НАЗЫВАЕТ ВИНОВНИКА. Ответ не по контракту с тем
+     * же успехом мог прислать шлюз или CDN, а не наш сервер; ровно за эту
+     * бездоказательную атрибуцию внешнее ревью сняло две прежние формулировки
+     * (круги 13 и 14), и здесь она повторена не будет.
+     */
+    static #describe(path, mayHaveTakenEffect, deliveryConfirmed) {
+        if (!mayHaveTakenEffect) {
+            return deliveryConfirmed
+                ? `The response to ${path} did not match the Clipwright contract. ` +
+                    "Nothing was created; retrying is safe."
+                : `The request to ${path} failed before an answer arrived. Nothing was created; retrying is safe.`;
+        }
+        const tail = "Check your recent runs before retrying: a retry with a new idempotency key would pay twice.";
+        return deliveryConfirmed
+            ? `The response to ${path} did not match the Clipwright contract. ` +
+                `The request was already sent, so a run may have been created and charged. ${tail}`
+            : `The request to ${path} failed before an answer arrived, so it is unknown whether it was ` +
+                `delivered — a run may have been created and charged. ${tail}`;
+    }
+}
+function parseResponse(schema, body, path, mayHaveTakenEffect) {
+    try {
+        return schema.parse(body);
+    }
+    catch (cause) {
+        throw new ClipwrightResponseError(path, mayHaveTakenEffect, cause);
+    }
+}
+/**
+ * Номер попытки → суффикс ключа идемпотентности. С отказом на мусоре.
+ *
+ * ЗДЕСЬ ПРОХОДИТ ДЕНЕЖНАЯ ГРАНИЦА, и молчаливого прохода на ней быть не должно.
+ * Суффикс участвует в ключе, а РАЗНЫЙ ключ — это РАЗНЫЙ платный рендер. Пока
+ * проверки не было, `?? 1` ловил только `null`/`undefined`, и `NaN` доезжал
+ * до ключа как строка `:NaN`: ключ отличался от `:1`, сервер видел новый
+ * запрос и запускал вторую платную генерацию. Внешнее ревью (круг 5) нашло
+ * живой путь до этого входа — `clipwright make --retry banana`, где
+ * `parseInt("banana")` даёт `NaN`.
+ *
+ * Отказ громкий, потому что тихий здесь стоит денег: пользователь, опечатавшийся
+ * в номере попытки, получит сообщение, а не счёт.
+ */
+function attemptSuffix(attempt) {
+    if (attempt === undefined)
+        return 1;
+    // `isSafeInteger`, а НЕ `isInteger` (внешнее ревью, круг 7). За пределом
+    // безопасного диапазона разные числа сливаются в одно: `9007199254740993`
+    // становится `…992` (проверено запуском). Два РАЗНЫХ номера попытки дали бы
+    // один суффикс, то есть один ключ, — и запрошенный новый платный рендер молча
+    // вернул бы прежний ран.
+    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
+ * суток — на пять суток раньше разрешённого сервером времени, то есть ровно то
+ * нарушение, ради недопущения которого пауза и соблюдается.
+ *
+ * Цепочка сохраняет и предел платформы, и назначенную длительность.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => {
+        // НЕ-ЧИСЛО ОБЯЗАНО ЗАВЕРШИТЬ СОН, А НЕ ПРОДЛИТЬ ЕГО НАВСЕГДА (внешнее ревью,
+        // круг 3). С `NaN` условие `left <= 0` ложно ВСЕГДА, `setTimeout(tick, NaN)`
+        // Node трактует как одну миллисекунду, и цикл планирует таймеры до
+        // скончания века: промис не завершается, дедлайн больше не проверяется, а
+        // таймер держит процесс Node живым — `clipwright make` не вернул бы
+        // управление вовсе. Сюда `NaN` попадает из `pollIntervalMs`, вычисленного
+        // вызывателем (`Number(process.env.…)`); конструктор такой ввод теперь
+        // отвергает, но защита стоит и здесь: у цикла с таймерами цена ошибки —
+        // зависший процесс, а не неверное число.
+        let left = Number.isFinite(ms) ? Math.max(ms, 0) : 0;
+        const tick = () => {
+            if (left <= 0) {
+                resolve();
+                return;
+            }
+            const step = Math.min(left, MAX_TIMER_DELAY_MS);
+            left -= step;
+            setTimeout(tick, step);
+        };
+        tick();
+    });
+}
+/**
+ * ОТКАЗ API, ДОЕХАВШИЙ ДО ВЫЗЫВАТЕЛЯ ЦЕЛИКОМ (US-622).
+ *
+ * ЧТО БЫЛО ДО. `#request` сводил любой не-2xx к `new Error(message)`: статус,
+ * код и назначенная сервером пауза терялись на границе SDK. Вызыватель мог
+ * только напечатать текст — отличить «подожди две секунды» от «пополни счёт»
+ * было нечем, и поллинг умирал на первом же 429.
+ *
+ * ЧЕГО ЗДЕСЬ НАМЕРЕННО НЕТ — СВОЕЙ ФОРМЫ ОТКАЗА. Класс не объявляет ни кодов,
+ * ни полей с числами: всё это лежит в `ApiFailure` из `@clipwright/core`, и
+ * `code`/`report()` выводятся оттуда же (правило проекта №2). Объяви SDK свою
+ * копию — и MCP с CLI получили бы вторую, а «повторять или нет» стало бы
+ * вопросом, на который три поверхности отвечают порознь.
+ */
+export class ClipwrightApiError extends Error {
+    /** Разобранный отказ: вид, числа, пауза. Форма — из core. */
+    failure;
+    status;
+    /** Код отказа. Для чужих тел без кода — `http_<status>`. */
+    code;
+    /** Пауза в секундах, назначенная сервером. `undefined` — он её не назвал. */
+    retryAfterSeconds;
+    constructor(failure) {
+        super(failure.message);
+        this.name = "ClipwrightApiError";
+        this.failure = failure;
+        this.status = failure.status;
+        // И КОД, И ПАУЗА БЕРУТСЯ ИЗ ОБЩЕГО РАЗВЁРТЫВАНИЯ, а не выводятся здесь по
+        // второму разу. Разъехавшись, `error.code` в CLI и `code` в ответе MCP
+        // говорили бы об одном отказе разными словами. Плюс следствие, которое
+        // поймал сканер источников: перечисляя виды отказа тут (`failure.kind ===
+        // …`), эта поверхность заводила бы у себя копию их названий — то есть
+        // ровно тот второй источник, который правило проекта №2 запрещает.
+        const report = agentFailureReport(failure);
+        this.code = report.code;
+        this.retryAfterSeconds = report.retry_after_seconds;
+    }
+    /** Имеет ли смысл повторить тот же вызов. Решает core, а не эта поверхность. */
+    get retryable() {
+        return isRetryableFailure(this.failure);
+    }
+    /** Отказ, развёрнутый для агента: числа, императив, признак повтора. */
+    report() {
+        return agentFailureReport(this.failure);
+    }
+}
 export class ClipwrightClient {
     #apiKey;
     #baseUrl;
@@ -20,7 +233,7 @@ export class ClipwrightClient {
     constructor(opts) {
         this.#apiKey = opts.apiKey;
         this.#baseUrl = opts.baseUrl ?? DEFAULT_BASE_URL;
-        this.#pollIntervalMs = opts.pollIntervalMs ?? 5_000;
+        this.#pollIntervalMs = positiveMs(opts.pollIntervalMs, 5_000, "pollIntervalMs");
     }
     /** Ленивый резолв + кэш идентичности установки (см. `#clientId`). */
     #getClientId() {
@@ -29,28 +242,95 @@ export class ClipwrightClient {
         }
         return this.#clientId;
     }
-    async #request(path, init) {
-        const res = await fetch(`${this.#baseUrl}${path}`, {
-            ...init,
-            headers: {
-                Authorization: `Bearer ${this.#apiKey}`,
-                "Content-Type": "application/json",
-                ...init?.headers,
-            },
-        });
-        const body = (await res.json());
+    /**
+     * Один запрос к API.
+     *
+     * ТЕЛО ЧИТАЕТСЯ ТЕКСТОМ, А НЕ `res.json()`, и это не стилистика (US-622).
+     * `res.json()` на не-JSON бросает `SyntaxError` ДО того, как мы посмотрели на
+     * статус, — и вызыватель видит «Unexpected token <» вместо «слишком часто».
+     * Отдать HTML-страницу вместо нашего тела может любой прокси между клиентом и
+     * API: edge тарифа, корпоративный шлюз, страница обслуживания. Разбор текста
+     * в `parseApiFailure` эту ветку закрывает, потому что решение принимается по
+     * статусу, а тело лишь уточняет причину.
+     */
+    async #request(path, 
+    /**
+     * Мог ли ЭТОТ вызов что-то изменить на сервере. Знает это только вызыватель,
+     * и знание обязано дойти сюда: провал разбора успешного ответа на `POST
+     * /run` и на `GET /voices` — разные новости, и молчать о разнице дороже
+     * всего именно там, где ран уже мог быть создан и оплачен.
+     */
+    mayHaveTakenEffect, init) {
+        // ВСЁ, ЧТО МОЖЕТ УПАСТЬ ПОСЛЕ ОТПРАВКИ, ЛОВИТСЯ ОДИНАКОВО (внешнее ревью,
+        // круг 11). Обрыв на чтении тела бросал голый `TypeError` мимо
+        // предупреждения про деньги — то есть ровно там, где ран уже создан, клиент
+        // молчал о последствиях. Сюда же отнесён и провал самого `fetch`: доставку
+        // он не опровергает, и на платном пути честнее сказать «неизвестно».
+        let res;
+        try {
+            res = await fetch(`${this.#baseUrl}${path}`, {
+                ...init,
+                headers: {
+                    Authorization: `Bearer ${this.#apiKey}`,
+                    "Content-Type": "application/json",
+                    ...init?.headers,
+                },
+            });
+        }
+        catch (cause) {
+            // На бесплатных путях сетевой сбой остаётся собой: своё сообщение (DNS,
+            // отказ соединения) полезнее нашей обёртки, а денег там нет.
+            if (!mayHaveTakenEffect)
+                throw cause;
+            throw new ClipwrightResponseError(path, true, cause, false);
+        }
+        // ЗАГОЛОВКИ ЧИТАЮТСЯ ДО ТЕЛА, потому что тело может и не дочитаться.
+        const retryAfterHeader = res.headers.get(RETRY_AFTER_HEADER);
+        let bodyText;
+        try {
+            bodyText = await res.text();
+        }
+        catch (cause) {
+            // ОБРЫВ ЧТЕНИЯ НЕ СМЕЕТ СТИРАТЬ УЖЕ ИЗВЕСТНЫЙ СТАТУС (внешнее ревью,
+            // круг 12). Первая редакция объявляла любой такой обрыв нарушением
+            // контракта — и 429 на поллинге переставал быть ретрайным: `makeUgc`
+            // бросал уже оплаченный ран вместо того, чтобы выждать паузу. Статус и
+            // заголовки к этому моменту получены целиком, их и достаточно.
+            if (!res.ok) {
+                throw new ClipwrightApiError(
+                // `undefined`, а не пустая строка: тело не пустое, оно НЕДОСТУПНО.
+                parseApiFailure({ status: res.status, bodyText: undefined, retryAfterHeader }));
+            }
+            throw new ClipwrightResponseError(path, mayHaveTakenEffect, cause);
+        }
         if (!res.ok) {
-            throw new Error(body.error?.message ?? `HTTP ${res.status} on ${path}`);
+            throw new ClipwrightApiError(parseApiFailure({
+                status: res.status,
+                bodyText,
+                retryAfterHeader,
+            }));
+        }
+        try {
+            return JSON.parse(bodyText);
+        }
+        catch (cause) {
+            // ТОТ ЖЕ КЛАСС, ЧТО И У ПРОВАЛА СХЕМЫ (внешнее ревью, круг 10). Первая
+            // редакция бросала здесь обычный `Error`, и он проскакивал МИМО
+            // предупреждения «ран мог быть создан и оплачен»: сервер, ответивший на
+            // `POST /run` пустым телом или HTML, оставлял человека в уверенности, что
+            // ничего не произошло, — и следующий шаг `--retry 2` оплачивал второй
+            // рендер. Тело не-JSON и тело не по схеме — одна и та же беда, «ответ не
+            // соответствует контракту», и говорить о ней надо одинаково.
+            throw new ClipwrightResponseError(path, mayHaveTakenEffect, cause);
         }
-        return body;
     }
     /** Оценка стоимости без списания кредитов. */
     async quoteUgc(input) {
-        const body = await this.#request("/v1/skills/make_ugc/quote", {
+        const body = await this.#request("/v1/skills/make_ugc/quote", false, {
             method: "POST",
             body: JSON.stringify(input),
         });
-        return quoteResponse.parse(body);
+        return parseResponse(quoteResponse, body, "/v1/skills/make_ugc/quote", false);
     }
     /**
      * Запуск генерации; возвращает ран сразу (state=queued).
@@ -60,14 +340,15 @@ export class ClipwrightClient {
      * `<hash>`, а CLI `<hash>:1` — межповерхностный шов, в котором дедуп ломается.
      */
     async startUgc(input, opts) {
-        const key = opts?.idempotencyKey ??
-            `${idempotencyKeyFor(input, this.#getClientId())}:${opts?.attempt ?? 1}`;
-        const body = await this.#request("/v1/skills/make_ugc/run", {
+        const key = opts?.idempotencyKey ?? `${idempotencyKeyFor(input, this.#getClientId())}:${attemptSuffix(opts?.attempt)}`;
+        // `true`: запрос уже ушёл, ран мог быть создан и оплачен.
+        const body = await this.#request("/v1/skills/make_ugc/run", true, {
             method: "POST",
             body: JSON.stringify(input),
             headers: { "Idempotency-Key": key },
         });
-        return runSchema.parse(body);
+        // `hasSideEffect: true` — запрос уже ушёл и ран мог быть создан и оплачен.
+        return parseResponse(runSchema, body, "/v1/skills/make_ugc/run", true);
     }
     /**
      * Курируемый каталог голосов для `voice`/`voice_id` (US-516). Отдаёт то же,
@@ -76,8 +357,16 @@ export class ClipwrightClient {
      * не полный список голосов вендора — остальные достижимы сырым `voice_id`.
      */
     async listVoices() {
-        const body = (await this.#request("/v1/voices"));
-        return body.voices;
+        const body = await this.#request("/v1/voices", false);
+        // Форма проверяется, а не предполагается: голое приведение типа отдавало бы
+        // `undefined` как массив, и падал бы уже вызыватель — на `.map`, вдали от
+        // причины. Каталог статический, отдельной схемы у него нет, поэтому
+        // проверяется то единственное, на что опирается потребитель.
+        const voices = body.voices;
+        if (!Array.isArray(voices)) {
+            throw new ClipwrightResponseError("/v1/voices", false, body);
+        }
+        return voices;
     }
     /**
      * Чтение рана в ТОЛЕРАНТНОЙ проекции (`runRead`, `state: string`): сервер мог
@@ -89,7 +378,7 @@ export class ClipwrightClient {
      * приняли бы `state` за закрытый enum.
      */
     async getRun(runId) {
-        const body = await this.#request(`/v1/runs/${runId}`);
+        const body = await this.#request(`/v1/runs/${runId}`, false);
         const parsed = runReadSchema.safeParse(body);
         return parsed.success ? parsed.data : body;
     }
@@ -103,23 +392,54 @@ export class ClipwrightClient {
      * бросок случался вовремя, а не через целый интервал поллинга.
      */
     async makeUgc(input, opts, onProgress) {
-        const maxWaitMs = opts?.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;
+        const maxWaitMs = positiveMs(opts?.maxWaitMs, DEFAULT_MAX_WAIT_MS, "maxWaitMs");
         const deadline = Date.now() + maxWaitMs;
         // Начальный ран приходит строгим `Run` из `startUgc`; расширяем тип до
         // `RunRead`, т.к. дальше присваиваем сюда толерантный результат `getRun`.
         let current = await this.startUgc(input, { attempt: opts?.attempt });
+        // Пауза перед СЛЕДУЮЩИМ опросом. Обычно это интервал поллинга; отбитый
+        // опрос заменяет её паузой, назначенной сервером (US-622).
+        let nextDelayMs = this.#pollIntervalMs;
+        // Последний отбитый опрос — только чтобы объяснить таймаут. Ран, который
+        // упёрся в дедлайн из-за 429, и ран, который просто долго рендерится, — это
+        // разные новости, и человеку они нужны разными.
+        let lastRetried;
         // Терминальность — через разделяемый `isTerminal`, а не литералы: неизвестный
         // ТЕРМИНАЛЬНЫЙ статус сервера (`isTerminal=false`) осознанно поллится до
         // `maxWaitMs` и даёт чистый таймаут с `run_id`, а не вечный цикл (PM4).
         while (!isTerminal(current.state)) {
+            // ДЕДЛАЙН ОДИН НА ВЕСЬ ВЫЗОВ И НЕ СБРАСЫВАЕТСЯ РЕТРАЕМ. `deadline`
+            // посчитан ДО цикла и здесь только читается: пересчитай его при отказе —
+            // и цепочка 429 продлевала бы ожидание бесконечно, ровно вопреки тому,
+            // ради чего `maxWaitMs` существует (US-207).
             const remaining = deadline - Date.now();
             if (remaining <= 0) {
                 throw new Error(`makeUgc timed out after ${maxWaitMs}ms; run ${current.run_id} is still ` +
-                    `${current.state}. Poll it later with getRun("${current.run_id}").`);
+                    `${current.state}. Poll it later with getRun("${current.run_id}").` +
+                    (lastRetried === undefined
+                        ? ""
+                        : ` The last status check was refused with HTTP ${lastRetried.status}: ` +
+                            `${lastRetried.message}`));
+            }
+            await sleep(Math.min(nextDelayMs, remaining));
+            try {
+                current = await this.getRun(current.run_id);
+                nextDelayMs = this.#pollIntervalMs;
+                onProgress?.(current);
+            }
+            catch (error) {
+                // ОТБИТЫЙ ОПРОС — НЕ ПРОВАЛ РАНА. Ран уже запущен и уже оплачен: 429 на
+                // `GET /v1/runs/:id` до US-622 убивал `makeUgc` целиком, то есть бросал
+                // работу, за которую заплатили. Повторяем — но только то, что повторять
+                // ИМЕЕТ СМЫСЛ, и решает это core: 402 и прочие 4xx летят наружу
+                // немедленно, потому что повтор даст тот же ответ, а агент тем временем
+                // выест лимит частоты вместо того, чтобы сказать человеку правду.
+                if (!(error instanceof ClipwrightApiError) || !isRetryableFailure(error.failure)) {
+                    throw error;
+                }
+                lastRetried = error;
+                nextDelayMs = retryDelayMs(error.failure, this.#pollIntervalMs);
             }
-            await new Promise((r) => setTimeout(r, Math.min(this.#pollIntervalMs, remaining)));
-            current = await this.getRun(current.run_id);
-            onProgress?.(current);
         }
         // Терминально: различение исхода — именованной константой core (не
         // позиционным индексом массива: переупорядочивание молча инвертировало бы

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,9 +1,9 @@
 {
   "name": "@clipwright/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "TypeScript client for the Clipwright UGC video API",
   "license": "MIT",
-  "author": "Dimantika LLC",
+  "author": "Dimantika Sp. z o.o.",
   "homepage": "https://clipwright.io",
   "type": "module",
   "publishConfig": {
@@ -23,7 +23,7 @@
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@clipwright/core": "0.1.0"
+    "@clipwright/core": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.1"