@clipwright/core 0.1.0 → 0.3.0

package/dist/skills.js

@@ -49,7 +49,23 @@ export function resolveResolution(requested, isDev) {
     return isDev ? DEV_RESOLUTION : DEFAULT_RESOLUTION;
 }
 /**
- * Потолок длины скрипта (docs/12 §11, ~45с озвучки) — временная замена
+ * ⚠️ ЭТО БАЗИС ВЫВОДА ПОТОЛКА СЛОВ, А НЕ ПОТОЛОК СЕКУНД, и имя переименовано
+ * ровно поэтому (находка внешней приёмки, круг 23). Прежнее — `MAX_SCRIPT_SECONDS`
+ * — читалось как «максимум секунд» и дважды подряд стало источником ДЕНЕЖНОГО
+ * дефекта на публичной странице цены: ею зажимали длительность, обещая клиенту
+ * меньше возможного счёта. Схема ограничивает только СЛОВА; сколько из них выйдет
+ * секунд, не ограничено ничем, потому что гейт пейсинга удалён.
+ *
+ * Число осталось прежним, роль названа честно: это множимое, из которого вместе
+ * с быстрым краем пейсинга получается `MAX_SCRIPT_WORDS`.
+ *
+ * ⚠️ ИСХОДНЫЙ ДОВОД НИЖЕ ОПИСЫВАЕТ ПОЛОЖЕНИЕ ДО УДАЛЕНИЯ ГЕЙТА ПЕЙСИНГА и
+ * оставлен как история, а не как действующее объяснение (находка внешней
+ * приёмки, круг 24): он объясняет число через «~45с озвучки» и пейсинг-гейт,
+ * которого с 2026-07-22 не существует. Действующее объяснение — абзац выше:
+ * это множимое, и ограничивает контракт только слова.
+ *
+ * Исходный довод (docs/12 §11) — временная замена
  * мульти-тейка (docs/12 §3: длинные скрипты раньше резались на несколько
  * тейков, эта логика вырезана на время прототипа). Пока мульти-тейк не
  * вернули, скрипт длиннее одного тейка нужно отклонять на входе, а не
@@ -60,8 +76,24 @@ export function resolveResolution(requested, isDev) {
  * потолок секунд без нарушения пейсинг-гейта. Числа пейсинга не дублируем,
  * берём готовые константы из pacing.ts.
  */
-export const MAX_SCRIPT_SECONDS = 45;
-export const MAX_SCRIPT_WORDS = MAX_SCRIPT_SECONDS * WORDS_PER_SECOND_MAX;
+export const SCRIPT_SECONDS_BASIS = 45;
+export const MAX_SCRIPT_WORDS = SCRIPT_SECONDS_BASIS * WORDS_PER_SECOND_MAX;
+/** Потолок длины ЛЮБОГО адреса из чужого тела: без него поле берёт весь потолок */
+/** тела запроса. Число — верхний предел, который переваривает любой браузер и CDN. */
+export const MAX_URL_LENGTH = 2048;
+/** ЧТО ДЕЛАЕТ `make_ugc` — один текст на обе контрактные поверхности: публичный */
+/** REST-каталог и MCP `tools/list`. Разойдясь, они описали бы РАЗНЫЙ скилл. */
+export const MAKE_UGC_DESCRIPTION = "Start generation of a lip-synced UGC video. Give a script (any length); the actor comes " +
+    "from person (described in words) or image. Format and resolution follow the request and " +
+    "the source, defaulting to 1080x1920. Captions are OPT-IN: ask the user first. Fields the " +
+    "renderer does not honor yet carry a NOT HONORED YET note in their own description — read " +
+    "it instead of guessing.";
+/** Как ЗВАТЬ скилл по MCP. Отдельно от описания выше: имена соседних тулов и */
+/** поллинг — свойства протокола, и REST-каталогу они не адресованы. */
+export const MAKE_UGC_AGENT_PROTOCOL = "Call quote_ugc before generating and show the cost. This does NOT wait for the video: it " +
+    "starts the run and returns a run_id IMMEDIATELY. You MUST then poll get_run with that " +
+    "run_id until the state is 'succeeded' (video_url) or 'failed'. Pass attempt=2,3,… to " +
+    "deliberately start a NEW run for the same input (retry after a failure).";
 /**
  * Сырой zod-shape входа make_ugc — БЕЗ `.refine()`.
  *
@@ -85,7 +117,7 @@ export const ugcSegment = z.object({
     /** Реплика актёра. У `media`-сегмента отсутствует — там говорит соседний актёр. */
     script: z.string().min(1).max(10_000).optional(),
     /** Полнокадровый врез. Обязателен у `media`, запрещён у `actor`. */
-    media_url: z.string().url().optional(),
+    media_url: z.string().url().max(MAX_URL_LENGTH).optional(),
 });
 /** Потолок актёрских сегментов — ограничение ОДНОГО рана, не суточных трат. */
 export const MAX_ACTOR_SEGMENTS = 3;
@@ -107,10 +139,10 @@ export const makeUgcInputShape = {
     // исключительно `{type:"url"}`, а заливка data-URI в R2 с presigned-выдачей
     // вскрыла бы инвариант Этапа 4 «R2-URL вендору не передаются». Отказ на входе
     // честнее, чем приём поля, которое некуда деть.
-    image: z.string().url().startsWith("https://").optional(),
+    image: z.string().url().startsWith("https://").max(MAX_URL_LENGTH).optional(),
     character: z.string().regex(/^char_[a-zA-Z0-9]+$/).optional(),
     name: z.string().max(100).optional(),
-    broll_url: z.string().url().optional(),
+    broll_url: z.string().url().max(MAX_URL_LENGTH).optional(),
     captions: z.boolean().default(false),
     caption_style: z.enum(CAPTION_STYLES).default("hormozi"),
     look: z.enum(LOOKS).default("natural"),
@@ -132,7 +164,7 @@ export const makeUgcInputShape = {
     // (enum порождает tools/list), voice_id — сырой вендорский id как escape hatch.
     voice: z.enum(VOICE_PRESET_NAMES).optional(),
     voice_id: z.string().regex(VOICE_ID_PATTERN).optional(),
-    webhook_url: z.string().url().optional(),
+    webhook_url: z.string().url().max(MAX_URL_LENGTH).optional(),
     /**
      * Видимая плашка «сделано ИИ» поверх кадра — OPT-IN, а не обязательная.
      *
@@ -228,7 +260,15 @@ export const makeUgcInput = z
     .refine((v) => countWords(spokenTextOf(v)) <= MAX_SCRIPT_WORDS, {
     error: (issue) => {
         const wordCount = countWords(spokenTextOf(issue.input));
-        return `script is ~${wordCount} words; ceiling is ${MAX_SCRIPT_WORDS} words (≈${MAX_SCRIPT_SECONDS}s of speech at the pacing gate)`;
+        /*
+         * ⚠️ ССЫЛКА НА «≈45s of speech at the pacing gate» СНЯТА (находка
+         * внешней приёмки, круг 23), и снята как ЛОЖЬ, а не как многословие.
+         * Гейта пейсинга не существует с 2026-07-22 — `validatePacing` не
+         * вызывается ниоткуда, — а число секунд агент читал как границу, хотя
+         * ограничены только слова. Текст ошибки на платной поверхности чинят
+         * перебором, и перебор по несуществующей границе стоит денег.
+         */
+        return `script is ~${wordCount} words; ceiling is ${MAX_SCRIPT_WORDS} words`;
     },
 });
 /** Склейка произносимого текста без проверок — общая база для гейтов и хелпера. */

package/dist/skills.js.map

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

package/dist/tts-backend.d.ts

@@ -1,3 +1,4 @@
+import type { VendorRefusalClass } from "./vendor-response.js";
 /**
  * Вендор-нейтральный контракт синтеза речи.
  *
@@ -53,6 +54,9 @@ export interface TtsBackend {
     readonly name: string;
     readonly capabilities: TtsCapabilities;
     synthesize(req: SpeechRequest): Promise<SpeechResult>;
+    /** Тот же обязательный член, что у `RenderBackend`: контрактов два, и */
+    /** ElevenLabs реализует ЭТОТ. Разбор — `docs/18` §11.6. */
+    classifyRefusal(error: unknown): VendorRefusalClass;
 }
 /**
  * Склейка посимвольных таймингов в пословные.

package/dist/tts-backend.js

@@ -1,16 +1,3 @@
-/**
- * Вендор-нейтральный контракт синтеза речи.
- *
- * ЗАЧЕМ отдельно от рендера: провайдеры TTS меняются независимо от провайдеров
- * аватара, и «ElevenLabs + HeyGen» — лишь одна из комбинаций.
- *
- * Ключевая причина существования этого файла — ТАЙМИНГИ. ElevenLabs отдаёт их
- * ПОСИМВОЛЬНО (проверено 18.07.2026: 134 символа → 134 тайминга), а этап B
- * ждёт пословные для `createTikTokStyleCaptions()`. Другой провайдер отдаст
- * пословные сразу или не отдаст вовсе. Нормализация обязана происходить в
- * адаптере, иначе посимвольный формат ElevenLabs протечёт в пайплайн субтитров
- * и намертво привяжет нас к вендору.
- */
 /**
  * Склейка посимвольных таймингов в пословные.
  *

package/dist/tts-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"tts-backend.js","sourceRoot":"","sources":["../src/tts-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkDH;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA6B,EAC7B,UAA6B,EAC7B,QAA2B;IAE3B,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CACb,qCAAqC,UAAU,CAAC,MAAM,UAAU;YAC9D,GAAG,UAAU,CAAC,MAAM,YAAY,QAAQ,CAAC,MAAM,OAAO,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACxD,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,KAAK,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QAClC,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAW,CAAC;IAC9B,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"tts-backend.js","sourceRoot":"","sources":["../src/tts-backend.ts"],"names":[],"mappings":"AAoEA;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA6B,EAC7B,UAA6B,EAC7B,QAA2B;IAE3B,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CACb,qCAAqC,UAAU,CAAC,MAAM,UAAU;YAC9D,GAAG,UAAU,CAAC,MAAM,YAAY,QAAQ,CAAC,MAAM,OAAO,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACxD,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,KAAK,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QAClC,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAW,CAAC;IAC9B,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/vendor-response.d.ts

@@ -0,0 +1,98 @@
+/**
+ * ЧТО УСПЕЛО СЛУЧИТЬСЯ С ПЛАТНЫМ ЗАПРОСОМ — ПРИЗНАК НА ОШИБКЕ, А НЕ ДОГАДКА ПО
+ * ЕЁ ТЕКСТУ (US-606a).
+ *
+ * ЗАЧЕМ ЭТО СУЩЕСТВУЕТ. Провалившийся платный вызов кончается одним из трёх, и
+ * различать их обязан код, а не человек, читающий лог:
+ *
+ *  - платный запрос ещё НЕ УХОДИЛ (упал наш префлайт, бесплатный шаг, гард
+ *    длины) — денег не взяли точно;
+ *  - вендор ОТВЕТИЛ — дальше всё решает код: 4xx означает отказ без денег, а
+ *    2xx, которым мы не смогли воспользоваться, означает, что работу приняли и
+ *    посчитали;
+ *  - ОТВЕТА НЕ БЫЛО ВОВСЕ (обрыв, тайм-аут) — взяли или нет, неизвестно.
+ *
+ * Третий случай — единственная причина, по которой US-606a вообще написана.
+ * Свалив его в «не получилось», мы объявили бы неизвестность отсутствием траты,
+ * то есть соврали бы в свою пользу ровно там, где ошибка дороже всего.
+ *
+ * ПОЧЕМУ ОТСУТСТВИЕ ПРИЗНАКА ЗНАЧИТ «НЕИЗВЕСТНО», А НЕ «НЕ УХОДИЛ». Это
+ * fail-closed: непомеченная ошибка поднимает лишний алерт, непомеченная в
+ * другую сторону — прячет возможную трату. Цена первой ошибки — внимание
+ * владельца, цена второй — необнаруженное списание. Поэтому умолчание такое.
+ *
+ * ПОЧЕМУ РАЗБОР ТЕКСТА ОШИБКИ НЕ ГОДИТСЯ. Он завёл бы второй источник правды:
+ * формат сообщений адаптера и его копию в парсере. Они расходятся на первой же
+ * правке текста — молча, потому что парсер просто перестаёт узнавать строку.
+ * Тот же довод уже стоил нам одного дефекта в `SpendRefusedError`.
+ *
+ * ПОЧЕМУ В `core`, А НЕ В СЕРВИСНОМ ПАКЕТЕ. Это обязанность реализаций
+ * `RenderBackend` и `TtsBackend`, а оба контракта живут здесь — вместе с
+ * требованием различать райтраебл и нерайтраебл ошибки, которое той же природы.
+ * Модуль не тянет ничего: три функции над свойством объекта.
+ */
+/**
+ * Что известно о судьбе платного запроса к моменту броска.
+ *
+ * `unsent` — платный запрос не уходил. `responded` — вендор ответил, и код
+ * ответа известен числом: флага «ответил» не хватило бы, потому что 200 и 402
+ * — разные события с разной ценой.
+ */
+export type VendorDispatchFact = {
+    readonly kind: "unsent";
+} | {
+    readonly kind: "responded";
+    readonly status: number;
+};
+/** Платный запрос ещё не уходил: упал префлайт, гард или бесплатный шаг. */
+export declare function markVendorUnsent<E>(error: E): E;
+/** Вендор ответил, и вот с каким кодом. */
+export declare function markVendorResponse<E>(error: E, status: number): E;
+/**
+ * Что известно о судьбе запроса. `undefined` — не известно НИЧЕГО, и это
+ * утверждение о незнании, а не об отказе.
+ *
+ * Читает и не-Error значения: в `catch` приходит `unknown`, и бросить могли что
+ * угодно.
+ */
+export declare function vendorDispatchFact(error: unknown): VendorDispatchFact | undefined;
+/**
+ * ВЕРДИКТ ВЕНДОРА О САМОЙ ЗАДАЧЕ — вторая ось, отдельная от судьбы запроса.
+ *
+ * ЗАЧЕМ ОТДЕЛЬНО ОТ `VendorDispatchFact`. Тот отвечает на вопрос «дошёл ли
+ * платный запрос»; этот — на вопрос «что вендор СКАЗАЛ о работе, которую уже
+ * принял». Оси независимы: запрос дошёл и получил 200 (первая ось довольна), а
+ * задача через десять минут поллинга объявлена проваленной (вторая ось — нет).
+ *
+ * ЗАЧЕМ ЭТО ВООБЩЕ ЕСТЬ. Без вердикта учёт не может отличить «мы не узнали, чем
+ * кончилось» от «вендор сам сказал, что провалил». Первое обязано оставаться
+ * незакрытым, второе — записаться: молчать о том, что знаешь, в аудиторском
+ * следе так же плохо, как утверждать то, чего не знаешь. Круг 2 внешней приёмки
+ * поймал первую ошибку, круг 3 — вторую.
+ *
+ * `succeeded` здесь означает «вендор довёл работу до конца», даже если
+ * воспользоваться результатом мы не смогли (пришёл `completed` без
+ * положительной длительности). Наша неспособность прочитать ответ — не провал
+ * вендора и не повод записывать его в отчёт как провал.
+ */
+export type VendorJobVerdict = "succeeded" | "failed";
+/** Помечает ошибку тем, что вендор сказал о САМОЙ задаче. */
+export declare function markVendorJobVerdict<E>(error: E, verdict: VendorJobVerdict): E;
+/**
+ * Вердикт вендора о задаче. `undefined` — вендор ничего терминального не
+ * сказал: оборвался поллинг, вышел срок, ответил не тот код. Это незнание, и
+ * закрывать по нему операцию нельзя.
+ */
+export declare function vendorJobVerdict(error: unknown): VendorJobVerdict | undefined;
+/** Чья причина за отказом вендора. `unknown` — честный ответ и ПРЕЖНЕЕ */
+/** поведение (не ноль): разбор и цена обратного — `docs/18` §11.5. */
+export type VendorRefusalClass = "account_standing" | "vendor" | "unknown";
+/** Помечает ошибку тем, что о причине отказа сказал сам вендор. */
+export declare function markVendorRefusal<E>(error: E, refusal: VendorRefusalClass): E;
+/** Непомеченная ошибка — `unknown`: fail-closed здесь смотрит в прежнее поведение. */
+export declare function vendorRefusalClass(error: unknown): VendorRefusalClass;
+/** Пометить класс отказа ответом САМОГО адаптера. Без неё обязательный член */
+/** задавал бы вендору вопрос, ответ на который никуда не едет (§11.6). */
+export declare function withRefusalClass<T>(backend: {
+    classifyRefusal(error: unknown): VendorRefusalClass;
+}, call: () => Promise<T>): Promise<T>;

package/dist/vendor-response.js

@@ -0,0 +1,152 @@
+/**
+ * ЧТО УСПЕЛО СЛУЧИТЬСЯ С ПЛАТНЫМ ЗАПРОСОМ — ПРИЗНАК НА ОШИБКЕ, А НЕ ДОГАДКА ПО
+ * ЕЁ ТЕКСТУ (US-606a).
+ *
+ * ЗАЧЕМ ЭТО СУЩЕСТВУЕТ. Провалившийся платный вызов кончается одним из трёх, и
+ * различать их обязан код, а не человек, читающий лог:
+ *
+ *  - платный запрос ещё НЕ УХОДИЛ (упал наш префлайт, бесплатный шаг, гард
+ *    длины) — денег не взяли точно;
+ *  - вендор ОТВЕТИЛ — дальше всё решает код: 4xx означает отказ без денег, а
+ *    2xx, которым мы не смогли воспользоваться, означает, что работу приняли и
+ *    посчитали;
+ *  - ОТВЕТА НЕ БЫЛО ВОВСЕ (обрыв, тайм-аут) — взяли или нет, неизвестно.
+ *
+ * Третий случай — единственная причина, по которой US-606a вообще написана.
+ * Свалив его в «не получилось», мы объявили бы неизвестность отсутствием траты,
+ * то есть соврали бы в свою пользу ровно там, где ошибка дороже всего.
+ *
+ * ПОЧЕМУ ОТСУТСТВИЕ ПРИЗНАКА ЗНАЧИТ «НЕИЗВЕСТНО», А НЕ «НЕ УХОДИЛ». Это
+ * fail-closed: непомеченная ошибка поднимает лишний алерт, непомеченная в
+ * другую сторону — прячет возможную трату. Цена первой ошибки — внимание
+ * владельца, цена второй — необнаруженное списание. Поэтому умолчание такое.
+ *
+ * ПОЧЕМУ РАЗБОР ТЕКСТА ОШИБКИ НЕ ГОДИТСЯ. Он завёл бы второй источник правды:
+ * формат сообщений адаптера и его копию в парсере. Они расходятся на первой же
+ * правке текста — молча, потому что парсер просто перестаёт узнавать строку.
+ * Тот же довод уже стоил нам одного дефекта в `SpendRefusedError`.
+ *
+ * ПОЧЕМУ В `core`, А НЕ В СЕРВИСНОМ ПАКЕТЕ. Это обязанность реализаций
+ * `RenderBackend` и `TtsBackend`, а оба контракта живут здесь — вместе с
+ * требованием различать райтраебл и нерайтраебл ошибки, которое той же природы.
+ * Модуль не тянет ничего: три функции над свойством объекта.
+ */
+/**
+ * Имя свойства. Намеренно длинное и с префиксом проекта: свойство садится на
+ * чужие объекты ошибок, и короткое имя вроде `status` затёрло бы поле, которое
+ * туда положил кто-то другой.
+ */
+const VENDOR_DISPATCH_FACT = "clipwrightVendorDispatchFact";
+/**
+ * Общая запись признака. Неперечислимо: ошибки уезжают в логи и в `runs.error`,
+ * и лишний ключ в их сериализации — шум, за который никто не просил.
+ *
+ * НА ПРИМИТИВЕ — НИЧЕГО НЕ ДЕЛАЕТ, И ЭТО НАЗВАННОЕ СВОЙСТВО, А НЕ НЕДОСМОТР:
+ * `throw "строка"` пометить нечем, и такая ошибка попадёт в `unknown`. Это
+ * сторона fail-closed (лишний алерт, а не потерянная трата), поэтому терпимо.
+ */
+function mark(error, fact) {
+    if (typeof error !== "object" || error === null) {
+        return error;
+    }
+    Object.defineProperty(error, VENDOR_DISPATCH_FACT, {
+        value: fact,
+        enumerable: false,
+        writable: false,
+        // `configurable`, чтобы повторная пометка не бросала TypeError: ошибка
+        // проходит несколько уровней адаптера, и внешний слой вправе уточнить факт.
+        configurable: true,
+    });
+    return error;
+}
+/** Платный запрос ещё не уходил: упал префлайт, гард или бесплатный шаг. */
+export function markVendorUnsent(error) {
+    return mark(error, { kind: "unsent" });
+}
+/** Вендор ответил, и вот с каким кодом. */
+export function markVendorResponse(error, status) {
+    return mark(error, { kind: "responded", status });
+}
+/**
+ * Что известно о судьбе запроса. `undefined` — не известно НИЧЕГО, и это
+ * утверждение о незнании, а не об отказе.
+ *
+ * Читает и не-Error значения: в `catch` приходит `unknown`, и бросить могли что
+ * угодно.
+ */
+export function vendorDispatchFact(error) {
+    if (typeof error !== "object" || error === null) {
+        return undefined;
+    }
+    const value = error[VENDOR_DISPATCH_FACT];
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const fact = value;
+    if (fact.kind === "unsent") {
+        return { kind: "unsent" };
+    }
+    if (fact.kind === "responded" && typeof fact.status === "number") {
+        return { kind: "responded", status: fact.status };
+    }
+    return undefined;
+}
+const VENDOR_JOB_VERDICT = "clipwrightVendorJobVerdict";
+/** Помечает ошибку тем, что вендор сказал о САМОЙ задаче. */
+export function markVendorJobVerdict(error, verdict) {
+    if (typeof error !== "object" || error === null) {
+        return error;
+    }
+    Object.defineProperty(error, VENDOR_JOB_VERDICT, {
+        value: verdict,
+        enumerable: false,
+        writable: false,
+        configurable: true,
+    });
+    return error;
+}
+/**
+ * Вердикт вендора о задаче. `undefined` — вендор ничего терминального не
+ * сказал: оборвался поллинг, вышел срок, ответил не тот код. Это незнание, и
+ * закрывать по нему операцию нельзя.
+ */
+export function vendorJobVerdict(error) {
+    if (typeof error !== "object" || error === null) {
+        return undefined;
+    }
+    const value = error[VENDOR_JOB_VERDICT];
+    return value === "succeeded" || value === "failed" ? value : undefined;
+}
+const VENDOR_REFUSAL_CLASS = "clipwrightVendorRefusalClass";
+/** Помечает ошибку тем, что о причине отказа сказал сам вендор. */
+export function markVendorRefusal(error, refusal) {
+    if (typeof error !== "object" || error === null) {
+        return error;
+    }
+    Object.defineProperty(error, VENDOR_REFUSAL_CLASS, {
+        value: refusal,
+        enumerable: false,
+        writable: false,
+        configurable: true,
+    });
+    return error;
+}
+/** Непомеченная ошибка — `unknown`: fail-closed здесь смотрит в прежнее поведение. */
+export function vendorRefusalClass(error) {
+    if (typeof error !== "object" || error === null) {
+        return "unknown";
+    }
+    const value = error[VENDOR_REFUSAL_CLASS];
+    return value === "account_standing" || value === "vendor" ? value : "unknown";
+}
+/** Пометить класс отказа ответом САМОГО адаптера. Без неё обязательный член */
+/** задавал бы вендору вопрос, ответ на который никуда не едет (§11.6). */
+export async function withRefusalClass(backend, call) {
+    try {
+        return await call();
+    }
+    catch (error) {
+        throw markVendorRefusal(error, backend.classifyRefusal(error));
+    }
+}
+//# sourceMappingURL=vendor-response.js.map

package/dist/vendor-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor-response.js","sourceRoot":"","sources":["../src/vendor-response.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAaH;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAE5D;;;;;;;GAOG;AACH,SAAS,IAAI,CAAI,KAAQ,EAAE,IAAwB;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE;QACjD,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,uEAAuE;QACvE,4EAA4E;QAC5E,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAI,KAAQ;IAC1C,OAAO,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,kBAAkB,CAAI,KAAQ,EAAE,MAAc;IAC5D,OAAO,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAI,KAAiC,CAAC,oBAAoB,CAAC,CAAC;IACvE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,KAA6C,CAAC;IAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACpD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAuBD,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAExD,6DAA6D;AAC7D,MAAM,UAAU,oBAAoB,CAAI,KAAQ,EAAE,OAAyB;IACzE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE;QAC/C,KAAK,EAAE,OAAO;QACd,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAI,KAAiC,CAAC,kBAAkB,CAAC,CAAC;IACrE,OAAO,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACzE,CAAC;AAMD,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAE5D,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAI,KAAQ,EAAE,OAA2B;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE;QACjD,KAAK,EAAE,OAAO;QACd,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAI,KAAiC,CAAC,oBAAoB,CAAC,CAAC;IACvE,OAAO,KAAK,KAAK,kBAAkB,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED,+EAA+E;AAC/E,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAgE,EAChE,IAAsB;IAEtB,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/voices.d.ts

@@ -1,19 +1,6 @@
-/**
- * Каталог голосовых пресетов — НАШИ имена + метадата, БЕЗ вендорских id.
- *
- * ЗАЧЕМ имена здесь, а id в адаптере (условие плана R4-b, принцип 5):
- * `VOICE_PRESET_NAMES` порождает `z.enum` во входе `make_ugc` (`makeUgcInputShape`),
- * а он, в свою очередь, — `tools/list`/OpenAPI/типы SDK. Значит имена ОБЯЗАНЫ жить
- * в core. Вендорские ElevenLabs-id — платный секрет вендора и живут ровно в одном
- * месте — адаптере воркера (`PRESET_TO_VOICE_ID`, US-514); в core их нет ни одного,
- * иначе поверхность ключа расширилась бы (был инцидент 6fbe5b6). Расщепление
- * «имя в core / id в адаптере» вынуждено этими двумя инвариантами.
- *
- * ПОЧЕМУ у `owner_ru_clone` нет `gender`: это клон голоса владельца, и у вендора
- * для него нет лейбла гендера. Выдумывать метадату за вендора нельзя (принцип
- * «мы не должны выдумывать», условие §6) — отсутствие поля само по себе значимо
- * и участвует в precedence-логике verify-voices (US-520) и warnings (US-517).
- */
+import { z } from "zod";
+/** Каталог голосовых пресетов — НАШИ имена и метадата, БЕЗ вендорских id: имена */
+/** порождают `tools/list` и типы SDK, id живут только в адаптере воркера. */
 export interface VoicePreset {
     /** Язык голоса в терминах BCP-47-подобного короткого кода (ru/en). */
     language: string;
@@ -61,6 +48,42 @@ export declare const VOICE_PRESETS: {
  */
 export declare const VOICE_PRESET_NAMES: [keyof typeof VOICE_PRESETS, ...(keyof typeof VOICE_PRESETS)[]];
 export type VoicePresetName = keyof typeof VOICE_PRESETS;
+/** Ответ `/v1/voices` — схема, а не догадка обеих сторон. Сервер отдаёт разобранное */
+/** ею тело, SDK разбирает им же: `Array.isArray` пропускал массив чего угодно. */
+export declare const voiceCatalogEntry: z.ZodObject<{
+    name: z.ZodEnum<{
+        daria_ru_female: "daria_ru_female";
+        eric: "eric";
+        george: "george";
+        owner_ru_clone: "owner_ru_clone";
+        sarah: "sarah";
+    }>;
+    language: z.ZodString;
+    gender: z.ZodOptional<z.ZodEnum<{
+        female: "female";
+        male: "male";
+    }>>;
+    description: z.ZodString;
+}, z.core.$strip>;
+export type VoiceCatalogEntry = z.infer<typeof voiceCatalogEntry>;
+export declare const voicesResponse: z.ZodObject<{
+    voices: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            daria_ru_female: "daria_ru_female";
+            eric: "eric";
+            george: "george";
+            owner_ru_clone: "owner_ru_clone";
+            sarah: "sarah";
+        }>;
+        language: z.ZodString;
+        gender: z.ZodOptional<z.ZodEnum<{
+            female: "female";
+            male: "male";
+        }>>;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type VoicesResponse = z.infer<typeof voicesResponse>;
 /**
  * Дефолт под текущий аватар (look-01 «warm storyteller»): `george` —
  * британский повествовательный голос, семантически совпадает с образом.
@@ -104,8 +127,8 @@ export type VoiceSelection = {
  * отличать явный выбор от умолчания (warnings US-517).
  */
 export declare function resolveVoiceSelection(input: {
-    voice?: VoicePresetName;
-    voice_id?: string;
+    voice?: VoicePresetName | undefined;
+    voice_id?: string | undefined;
 }): VoiceSelection;
 /**
  * Семейство письменности скрипта — грубый детектор для языкового warning'а
@@ -122,14 +145,7 @@ export declare function resolveVoiceSelection(input: {
  */
 export declare const SCRIPT_DOMINANCE_THRESHOLD = 0.6;
 export declare function detectScriptFamily(script: string): "cyrillic" | "latin" | "neutral";
-/**
- * Warning отложенной проверки сырого voice_id на ПУТИ QUOTE (US-517). На quote
- * префлайта ещё нет (он бесплатный, но живёт в воркере, US-515), поэтому честно
- * сообщаем: существование id сверяется со счётом на СТАРТЕ рана, не сейчас. На
- * пути рана этот warning НЕ выдаётся — там префлайт уже отработал и, если каталог
- * неполон, добавит собственный `VOICE_CATALOG_INCOMPLETE_WARNING` (воркер зовёт
- * buildVoiceWarnings без voice_id, чтобы эти два не дублировали друг друга).
- */
+/** Только путь QUOTE (US-517); почему не на пути рана — docs/18, Д41. */
 export declare const RAW_VOICE_ID_VALIDATION_WARNING = "raw voice_id is verified against your account at run start, not at quote time";
 /**
  * Голосовые warnings по ТЕСТУ ДОПУСТИМОСТИ (план §Р3). Warning допустим, только

package/dist/voices.js

@@ -1,3 +1,4 @@
+import { z } from "zod";
 /**
  * Стартовый набор из 5 пресетов (условие плана §4). Порядок значим только для
  * презентации; дефолт задаётся отдельно через `DEFAULT_VOICE_PRESET`.
@@ -33,6 +34,15 @@ export const VOICE_PRESETS = {
  * список имён и метадата не разъехались (правило проекта №2 — не дублировать).
  */
 export const VOICE_PRESET_NAMES = Object.keys(VOICE_PRESETS);
+/** Ответ `/v1/voices` — схема, а не догадка обеих сторон. Сервер отдаёт разобранное */
+/** ею тело, SDK разбирает им же: `Array.isArray` пропускал массив чего угодно. */
+export const voiceCatalogEntry = z.object({
+    name: z.enum(VOICE_PRESET_NAMES),
+    language: z.string().min(1),
+    gender: z.enum(["female", "male"]).optional(),
+    description: z.string().min(1),
+});
+export const voicesResponse = z.object({ voices: z.array(voiceCatalogEntry) });
 /**
  * Дефолт под текущий аватар (look-01 «warm storyteller»): `george` —
  * британский повествовательный голос, семантически совпадает с образом.
@@ -119,14 +129,7 @@ const LANGUAGE_TO_SCRIPT_FAMILY = {
     ru: "cyrillic",
     en: "latin",
 };
-/**
- * Warning отложенной проверки сырого voice_id на ПУТИ QUOTE (US-517). На quote
- * префлайта ещё нет (он бесплатный, но живёт в воркере, US-515), поэтому честно
- * сообщаем: существование id сверяется со счётом на СТАРТЕ рана, не сейчас. На
- * пути рана этот warning НЕ выдаётся — там префлайт уже отработал и, если каталог
- * неполон, добавит собственный `VOICE_CATALOG_INCOMPLETE_WARNING` (воркер зовёт
- * buildVoiceWarnings без voice_id, чтобы эти два не дублировали друг друга).
- */
+/** Только путь QUOTE (US-517); почему не на пути рана — docs/18, Д41. */
 export const RAW_VOICE_ID_VALIDATION_WARNING = "raw voice_id is verified against your account at run start, not at quote time";
 /**
  * Голосовые warnings по ТЕСТУ ДОПУСТИМОСТИ (план §Р3). Warning допустим, только

package/dist/voices.js.map

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

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@clipwright/core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Zod schemas and the shared request/response contract of the Clipwright UGC video API",
   "license": "MIT",
-  "author": "Dimantika LLC",
+  "author": "Dimantika Sp. z o.o.",
   "homepage": "https://clipwright.io",
   "type": "module",
   "publishConfig": {