@clipwright/core 0.2.0 → 0.4.0

package/dist/errors.js

@@ -1,4 +1,7 @@
 import { z } from "zod";
+// Только ради кода 429 в реестре ниже: имя берётся из его схемы, а не пишется
+// здесь литералом (единственный дом формы 429 — `rate-limit.ts`).
+import { rateLimitedError } from "./rate-limit.js";
 /**
  * ТЕЛА ОТКАЗОВ — СХЕМАМИ, А НЕ `c.json({...})` В ОБРАБОТЧИКЕ.
  *
@@ -42,12 +45,19 @@ export const insufficientCreditsError = z.object({
     }),
 });
 /**
- * На аккаунте висит непогашенный долг. Значит «погаси», а не «пополни».
+ * На аккаунте висит непогашенный долг.
  *
- * Отдельный код, а не оттенок предыдущего: у аккаунта с долгом деньги на
- * балансе могут БЫТЬ, и ответ «недостаточно кредитов» сказал бы клиенту
- * заведомую неправду, а его агента отправил бы покупать кредиты, которые не
- * снимут блокировку.
+ * ОТДЕЛЬНЫЙ КОД, А НЕ ОТТЕНОК ПРЕДЫДУЩЕГО, и довод у этого ровно один: у счёта
+ * с долгом деньги на балансе БЫВАЮТ. Такое состояние оставляет `topUpHold`
+ * (ветка `deferred_to_debt`) — он наращивает долг, не трогая баланс; два других
+ * производителя долга обнуляют баланс, заводя его. Ответ «недостаточно
+ * кредитов» сказал бы такому счёту заведомую неправду.
+ *
+ * ⚠️ ВТОРАЯ ПОЛОВИНА ПРЕЖНЕГО ДОВОДА — «агента отправило бы покупать кредиты,
+ * которые не снимут блокировку» — СНЯТА КАК ЛОЖНАЯ (clipwright#27): кредиты
+ * снимают. Вывод пережил свою причину, и это стоит сказать прямо: оставь я
+ * старую формулировку, следующий читатель либо слил бы два кода, увидев, что
+ * лечение одно, либо заново вывел бы из неё неверный совет клиенту.
  */
 export const debtOutstandingError = z.object({
     error: z.object({
@@ -56,6 +66,40 @@ export const debtOutstandingError = z.object({
         debt_credits: z.number().int().positive(),
     }),
 });
+/**
+ * Аккаунт не допущен в бету (US-620). Ни «пополни», ни «погаси»: доступ выдаёт
+ * владелец, и деньги на это не влияют.
+ *
+ * Отдельный код по тому же доводу, что отделил долг от нехватки: у
+ * недопущенного аккаунта деньги на балансе БЫВАЮТ, и оба денежных ответа
+ * отправили бы его агента совершать действия, которые блокировку не снимут.
+ * Отказ терминальный: повтор того же запроса даст то же самое, пока владелец не
+ * допустит аккаунт командой `admit`.
+ *
+ * ЧИСЕЛ В ТЕЛЕ НЕТ, И ЭТО НЕ ЭКОНОМИЯ. Порядковый номер мы не считаем: доступ
+ * даётся решением человека, а не по счётчику, и назвать номер значило бы
+ * обещать срок, которого никто не давал.
+ *
+ * ПО ТОЙ ЖЕ ПРИЧИНЕ ТЕЛО НЕ НАЗЫВАЕТ НИ СРОКА, НИ НОМЕРА, НИ БЛИЗОСТИ РАЗВЯЗКИ.
+ * Из отказа известно ровно одно: доступа нет. Так же отвечает аккаунт, у
+ * которого доступ СНЯЛИ, — и обещание скорого приёма было бы для него ложью в
+ * самый неподходящий момент. Правило принималось трижды и трижды чинилось по адресу
+ * находки: сперва в совете агенту (`api-failure.ts`), потом в `SKILL.md`, и
+ * только тогда — ЗДЕСЬ, в единственном месте, которое порождает эту строку для
+ * всех остальных. Проверка стоит на этой функции, а не на её производных.
+ *
+ * ПРАВИЛО РАСПРОСТРАНЯЕТСЯ НА ЛЮБУЮ ПОВЕРХНОСТЬ, объясняющую этот отказ, а не
+ * только на те, что существуют сегодня. Ближайшие будущие — страница ключей
+ * (US-608) и лендинг US-614; там соблазн назвать срок сильнее всего. Сторож
+ * (`scripts/docs-consistency.test.ts`) их уже обходит, но HTML он читает как
+ * текст и поймает только то, что стоит рядом с именем кода.
+ */
+export const accountNotAdmittedError = z.object({
+    error: z.object({
+        code: z.literal("account_not_admitted"),
+        message: z.string().min(1),
+    }),
+});
 /**
  * Сборка тела «не хватило кредитов».
  *
@@ -74,15 +118,75 @@ export function insufficientCreditsBody(args) {
         },
     });
 }
+/** Сборка тела «не допущен в бету». См. довод о формулировке выше. */
+export function accountNotAdmittedBody() {
+    return accountNotAdmittedError.parse({
+        error: {
+            code: "account_not_admitted",
+            message: "This account is not admitted to the beta. Nothing was charged and no run was created. " +
+                "Ask the operator about this account; retrying will not change the answer.",
+        },
+    });
+}
 /** Сборка тела «висит долг». См. довод о формулировке выше. */
 export function debtOutstandingBody(args) {
     return debtOutstandingError.parse({
         error: {
             code: "debt_outstanding",
             message: `An outstanding debt of ${args.debtCredits} credits blocks new paid runs. ` +
-                "Settle the debt and retry; topping up alone does not clear it.",
+                "Buy credits to clear it: incoming credits pay the debt down before any of them " +
+                "reach the balance. Clearing it lifts this block; a run still needs enough " +
+                "credits of its own, so a purchase equal to the debt adds nothing to the balance.",
             debt_credits: args.debtCredits,
         },
     });
 }
+/** Во входе есть поле, которое продукт отклоняет. `fields` называет их поимённо: */
+/** агенту чинить нечего, пока он не знает, какое именно убрать. */
+export const rejectedFieldError = z.object({
+    error: z.object({
+        code: z.literal("rejected_field"),
+        message: z.string().min(1),
+        fields: z.array(z.string().min(1)).min(1),
+    }),
+});
+/** Сборка тела «поле отклонено». Причина берётся из реестра диспозиций. */
+export function rejectedFieldBody(hits) {
+    return rejectedFieldError.parse({
+        error: {
+            code: "rejected_field",
+            message: hits.map((hit) => hit.message).join("; "),
+            fields: hits.map((hit) => hit.field),
+        },
+    });
+}
+/** КОДЫ С ГОЛЫМ КОНВЕРТОМ — ОДНИМ РЕЕСТРОМ: перечень §6 `docs/03-api.md` объявлен */
+/** исчерпывающим. Устройство сторожей — `docs/41-api-error-contract.md`. */
+const BARE_ERROR_CODES = [
+    "aspect_conflict",
+    "idempotency_key_required",
+    "idempotency_key_reused",
+    "internal_error",
+    "invalid_request",
+    "not_found",
+    "paid_render_disabled",
+    "payload_too_large",
+    "unauthorized",
+    "upstream_error",
+];
+/** ВСЕ коды, которые умеет вернуть API: голые плюс типизированные. Значения вторых */
+/** берутся из их схем, поэтому переименование доедет сюда само. */
+export const API_ERROR_CODES = [
+    ...BARE_ERROR_CODES,
+    rejectedFieldError.shape.error.shape.code.value,
+    insufficientCreditsError.shape.error.shape.code.value,
+    debtOutstandingError.shape.error.shape.code.value,
+    accountNotAdmittedError.shape.error.shape.code.value,
+    rateLimitedError.shape.error.shape.code.value,
+];
+/** Тело голого отказа. Единственный путь к нему: код вне реестра не компилируется, */
+/** а конверт мимо этой функции валит `scripts/api-error-envelope.test.ts`. */
+export function apiErrorBody(args) {
+    return apiError.parse({ error: { code: args.code, message: args.message } });
+}
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC3B,CAAC;CACH,CAAC,CAAC;AAGH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;QACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,qDAAqD;QACrD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC/C,oEAAoE;QACpE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KAC9C,CAAC;CACH,CAAC,CAAC;AAGH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KAC1C,CAAC;CACH,CAAC,CAAC;AAGH;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAGvC;IACC,OAAO,wBAAwB,CAAC,KAAK,CAAC;QACpC,KAAK,EAAE;YACL,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EACL,kBAAkB,IAAI,CAAC,eAAe,6BAA6B,IAAI,CAAC,cAAc,IAAI;gBAC1F,2EAA2E;YAC7E,eAAe,EAAE,IAAI,CAAC,cAAc;YACpC,gBAAgB,EAAE,IAAI,CAAC,eAAe;SACvC;KACF,CAAC,CAAC;AACL,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CAAC,IAEnC;IACC,OAAO,oBAAoB,CAAC,KAAK,CAAC;QAChC,KAAK,EAAE;YACL,IAAI,EAAE,kBAAkB;YACxB,OAAO,EACL,0BAA0B,IAAI,CAAC,WAAW,iCAAiC;gBAC3E,gEAAgE;YAClE,YAAY,EAAE,IAAI,CAAC,WAAW;SAC/B;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,kEAAkE;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC3B,CAAC;CACH,CAAC,CAAC;AAGH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;QACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,qDAAqD;QACrD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC/C,oEAAoE;QACpE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KAC9C,CAAC;CACH,CAAC,CAAC;AAGH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KAC1C,CAAC;CACH,CAAC,CAAC;AAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;QACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC3B,CAAC;CACH,CAAC,CAAC;AAGH;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAGvC;IACC,OAAO,wBAAwB,CAAC,KAAK,CAAC;QACpC,KAAK,EAAE;YACL,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EACL,kBAAkB,IAAI,CAAC,eAAe,6BAA6B,IAAI,CAAC,cAAc,IAAI;gBAC1F,2EAA2E;YAC7E,eAAe,EAAE,IAAI,CAAC,cAAc;YACpC,gBAAgB,EAAE,IAAI,CAAC,eAAe;SACvC;KACF,CAAC,CAAC;AACL,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,sBAAsB;IACpC,OAAO,uBAAuB,CAAC,KAAK,CAAC;QACnC,KAAK,EAAE;YACL,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EACL,wFAAwF;gBACxF,2EAA2E;SAC9E;KACF,CAAC,CAAC;AACL,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CAAC,IAEnC;IACC,OAAO,oBAAoB,CAAC,KAAK,CAAC;QAChC,KAAK,EAAE;YACL,IAAI,EAAE,kBAAkB;YACxB,OAAO,EACL,0BAA0B,IAAI,CAAC,WAAW,iCAAiC;gBAC3E,iFAAiF;gBACjF,4EAA4E;gBAC5E,kFAAkF;YACpF,YAAY,EAAE,IAAI,CAAC,WAAW;SAC/B;KACF,CAAC,CAAC;AACL,CAAC;AAED,oFAAoF;AACpF,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KAC1C,CAAC;CACH,CAAC,CAAC;AAGH,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAC/B,IAAmD;IAEnD,OAAO,kBAAkB,CAAC,KAAK,CAAC;QAC9B,KAAK,EAAE;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAClD,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;SACrC;KACF,CAAC,CAAC;AACL,CAAC;AAED,qFAAqF;AACrF,4EAA4E;AAC5E,MAAM,gBAAgB,GAAG;IACvB,iBAAiB;IACjB,0BAA0B;IAC1B,wBAAwB;IACxB,gBAAgB;IAChB,iBAAiB;IACjB,WAAW;IACX,sBAAsB;IACtB,mBAAmB;IACnB,cAAc;IACd,gBAAgB;CACR,CAAC;AAKX,sFAAsF;AACtF,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,GAAG,gBAAgB;IACnB,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;IAC/C,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;IACrD,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;IACjD,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;IACpD,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;CAC9C,CAAC;AAEF,sFAAsF;AACtF,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,IAAiD;IAC5E,OAAO,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/index.d.ts

@@ -10,3 +10,6 @@ export * from "./account.js";
 export * from "./pacing.js";
 export * from "./render-backend.js";
 export * from "./tts-backend.js";
+export * from "./vendor-response.js";
+export * from "./public-endpoints.js";
+export * from "./run-static-warnings.js";

package/dist/index.js

@@ -23,4 +23,14 @@ export * from "./pacing.js";
 // Вендор-нейтральные контракты: всё вендорское живёт в адаптерах, не здесь.
 export * from "./render-backend.js";
 export * from "./tts-backend.js";
+// Обязанность реализаций обоих контрактов выше: пометить ошибку кодом ответа,
+// если ответ был. Без неё «вендор отказал» и «ответа не было» неразличимы
+// (US-606a).
+export * from "./vendor-response.js";
+// Публичные адреса и имена пакетов: их печатают SDK, документация и лендинг,
+// поэтому расхождение видит посетитель, а не тест (US-614).
+export * from "./public-endpoints.js";
+// Статические warnings рана выводятся из сохранённого входа — один ответ у API
+// и у кабинета на любом состоянии рана (clipwright#64).
+export * from "./run-static-warnings.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,gFAAgF;AAChF,6EAA6E;AAC7E,2BAA2B;AAC3B,cAAc,4BAA4B,CAAC;AAC3C,4EAA4E;AAC5E,gEAAgE;AAChE,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,+EAA+E;AAC/E,0DAA0D;AAC1D,cAAc,aAAa,CAAC;AAC5B,yEAAyE;AACzE,iEAAiE;AACjE,cAAc,iBAAiB,CAAC;AAChC,2EAA2E;AAC3E,4EAA4E;AAC5E,2BAA2B;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,4EAA4E;AAC5E,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,gFAAgF;AAChF,6EAA6E;AAC7E,2BAA2B;AAC3B,cAAc,4BAA4B,CAAC;AAC3C,4EAA4E;AAC5E,gEAAgE;AAChE,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,+EAA+E;AAC/E,0DAA0D;AAC1D,cAAc,aAAa,CAAC;AAC5B,yEAAyE;AACzE,iEAAiE;AACjE,cAAc,iBAAiB,CAAC;AAChC,2EAA2E;AAC3E,4EAA4E;AAC5E,2BAA2B;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,4EAA4E;AAC5E,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,8EAA8E;AAC9E,0EAA0E;AAC1E,aAAa;AACb,cAAc,sBAAsB,CAAC;AACrC,6EAA6E;AAC7E,4DAA4D;AAC5D,cAAc,uBAAuB,CAAC;AACtC,+EAA+E;AAC/E,wDAAwD;AACxD,cAAc,0BAA0B,CAAC"}

package/dist/public-endpoints.d.ts

@@ -0,0 +1,14 @@
+/** Публичные адреса продукта — одной константой на всех: клиент и лендинг */
+/** обязаны называть один адрес. Разбор и переезд — `docs/03-api.md` §1. */
+/** Свой домен с US-613; адрес площадки жив и не снят (`docs/03-api.md` §1). */
+export declare const PUBLIC_API_BASE_URL = "https://api.clipwright.io";
+/**
+ * Пакеты npm, которыми продукт вызывается. Названия печатает и лендинг, и
+ * `--help`, и документация — значит это тоже контракт, а не текст страницы.
+ */
+export declare const CLI_PACKAGE = "@clipwright/cli";
+export declare const CLI_BIN = "clipwright";
+export declare const MCP_PACKAGE = "@clipwright/mcp-server";
+/** Адрес API ИЗ ОКРУЖЕНИЯ — только `https:`: по нему уходит `Authorization: Bearer */
+/** cw_…`. Программный `baseUrl` встраивателя не трогаем — его выбирает автор кода. */
+export declare function apiBaseUrlFromEnv(raw: string | undefined): string | undefined;

package/dist/public-endpoints.js

@@ -0,0 +1,34 @@
+/** Публичные адреса продукта — одной константой на всех: клиент и лендинг */
+/** обязаны называть один адрес. Разбор и переезд — `docs/03-api.md` §1. */
+/** Свой домен с US-613; адрес площадки жив и не снят (`docs/03-api.md` §1). */
+export const PUBLIC_API_BASE_URL = "https://api.clipwright.io";
+/**
+ * Пакеты npm, которыми продукт вызывается. Названия печатает и лендинг, и
+ * `--help`, и документация — значит это тоже контракт, а не текст страницы.
+ */
+export const CLI_PACKAGE = "@clipwright/cli";
+export const CLI_BIN = "clipwright";
+export const MCP_PACKAGE = "@clipwright/mcp-server";
+/** Петлевые имена — единственное, чему разрешён `http:`: локальный API никуда не */
+/** выходит, и требовать там сертификат значило бы запретить разработку. */
+const LOOPBACK_HOSTS = new Set(["localhost", "127.0.0.1", "[::1]", "::1"]);
+/** Адрес API ИЗ ОКРУЖЕНИЯ — только `https:`: по нему уходит `Authorization: Bearer */
+/** cw_…`. Программный `baseUrl` встраивателя не трогаем — его выбирает автор кода. */
+export function apiBaseUrlFromEnv(raw) {
+    if (raw === undefined || raw === "")
+        return undefined;
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new Error(`CLIPWRIGHT_API_URL is not a URL: ${raw}`);
+    }
+    if (url.protocol === "https:")
+        return raw;
+    if (url.protocol === "http:" && LOOPBACK_HOSTS.has(url.hostname))
+        return raw;
+    throw new Error(`CLIPWRIGHT_API_URL must be https (loopback may be http), got ${url.protocol}//${url.hostname}. ` +
+        "The api key travels in the Authorization header of every request to it.");
+}
+//# sourceMappingURL=public-endpoints.js.map

package/dist/public-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-endpoints.js","sourceRoot":"","sources":["../src/public-endpoints.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAE3E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAC7C,MAAM,CAAC,MAAM,OAAO,GAAG,YAAY,CAAC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAEpD,oFAAoF;AACpF,2EAA2E;AAC3E,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAE3E,sFAAsF;AACtF,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,GAAuB;IACvD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAEtD,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAC1C,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,GAAG,CAAC;IAE7E,MAAM,IAAI,KAAK,CACb,gEAAgE,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,IAAI;QAC/F,yEAAyE,CAC5E,CAAC;AACJ,CAAC"}

package/dist/rate-limit.d.ts

@@ -136,3 +136,25 @@ export declare function rateLimitedBody(args: {
      */
     targetsRunCreation?: boolean;
 }): RateLimitedError;
+/**
+ * Сборка тела «слишком много НЕУДАЧНЫХ ПОПЫТОК АУТЕНТИФИКАЦИИ» (US-626, круг
+ * подтверждения).
+ *
+ * ЖИВЁТ ЗДЕСЬ, А НЕ В МИДЛВАРЕ, ПО ПРАВИЛУ ПРОЕКТА №2 — и это не формальность:
+ * литерал `rate_limited`, собранный на месте, поймал сторож
+ * `rate-limit.single-source.test.ts` в тот же прогон. Форма 429 у продукта одна,
+ * потому что разбирают её клиентские пакеты одной схемой (`rateLimitedError`):
+ * тело без любого из трёх чисел не пройдёт разбор вовсе, и агент получит
+ * «неизвестный отказ» вместо «подожди столько секунд».
+ *
+ * ОТЛИЧИЕ ОТ `rateLimitedBody` — ТОЛЬКО СООБЩЕНИЕ, и различать их обязательно.
+ * Тот отказ адресован ДЕЙСТВУЮЩЕМУ клиенту и говорит про ведро аккаунта,
+ * идемпотентность и второй платный рендер. Этот приходит тому, кто предъявил
+ * НЕработающий ключ: ни аккаунта, ни рана у него нет, и совет про
+ * `Idempotency-Key` был бы разговором о невозможном.
+ */
+export declare function authThrottledBody(args: {
+    limit: number;
+    windowSeconds: number;
+    retryAfterSeconds: number;
+}): RateLimitedError;

package/dist/rate-limit.js

@@ -149,4 +149,34 @@ export function rateLimitedBody(args) {
         },
     });
 }
+/**
+ * Сборка тела «слишком много НЕУДАЧНЫХ ПОПЫТОК АУТЕНТИФИКАЦИИ» (US-626, круг
+ * подтверждения).
+ *
+ * ЖИВЁТ ЗДЕСЬ, А НЕ В МИДЛВАРЕ, ПО ПРАВИЛУ ПРОЕКТА №2 — и это не формальность:
+ * литерал `rate_limited`, собранный на месте, поймал сторож
+ * `rate-limit.single-source.test.ts` в тот же прогон. Форма 429 у продукта одна,
+ * потому что разбирают её клиентские пакеты одной схемой (`rateLimitedError`):
+ * тело без любого из трёх чисел не пройдёт разбор вовсе, и агент получит
+ * «неизвестный отказ» вместо «подожди столько секунд».
+ *
+ * ОТЛИЧИЕ ОТ `rateLimitedBody` — ТОЛЬКО СООБЩЕНИЕ, и различать их обязательно.
+ * Тот отказ адресован ДЕЙСТВУЮЩЕМУ клиенту и говорит про ведро аккаунта,
+ * идемпотентность и второй платный рендер. Этот приходит тому, кто предъявил
+ * НЕработающий ключ: ни аккаунта, ни рана у него нет, и совет про
+ * `Idempotency-Key` был бы разговором о невозможном.
+ */
+export function authThrottledBody(args) {
+    return rateLimitedError.parse({
+        error: {
+            code: "rate_limited",
+            message: `Too many failed authentication attempts: ${args.limit} per ${args.windowSeconds} seconds ` +
+                `from this address. Retry in ${args.retryAfterSeconds} seconds. ` +
+                `Nothing was charged, and no account was identified.`,
+            limit: args.limit,
+            window_seconds: args.windowSeconds,
+            retry_after_seconds: args.retryAfterSeconds,
+        },
+    });
+}
 //# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;GAcG;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE3D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAAC;AAEnE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE3D,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEhD,wEAAwE;AACxE,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AAYpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;QAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,6CAA6C;QAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAClC,gEAAgE;QAChE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAC3C,iEAAiE;QACjE,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KACjD,CAAC;CACH,CAAC,CAAC;AAGH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IA0B/B;IACC,qFAAqF;IACrF,EAAE;IACF,8EAA8E;IAC9E,eAAe;IACf,EAAE;IACF,wEAAwE;IACxE,0EAA0E;IAC1E,oEAAoE;IACpE,uCAAuC;IACvC,EAAE;IACF,4EAA4E;IAC5E,2EAA2E;IAC3E,6EAA6E;IAC7E,sEAAsE;IACtE,0EAA0E;IAC1E,sEAAsE;IACtE,6EAA6E;IAC7E,mEAAmE;IACnE,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,OAAO,GACX,IAAI,CAAC,KAAK,KAAK,MAAM;QACnB,CAAC,CAAC,yEAAyE;QAC3E,CAAC,CAAC,qDAAqD,CAAC;IAE5D,mEAAmE;IACnE,EAAE;IACF,qEAAqE;IACrE,6EAA6E;IAC7E,wEAAwE;IACxE,6EAA6E;IAC7E,gFAAgF;IAChF,MAAM,IAAI,GACR,IAAI,CAAC,KAAK,KAAK,MAAM;QACnB,CAAC,CAAC,4EAA4E;QAC9E,CAAC,CAAC,IAAI,CAAC,kBAAkB,KAAK,IAAI;YAChC,CAAC,CAAC,qIAAqI;YACvI,CAAC,CAAC,sBAAsB,CAAC;IAC/B,OAAO,gBAAgB,CAAC,KAAK,CAAC;QAC5B,KAAK,EAAE;YACL,IAAI,EAAE,cAAc;YACpB,OAAO,EACL,iBAAiB,IAAI,CAAC,KAAK,IAAI,OAAO,QAAQ,IAAI,CAAC,aAAa,wBAAwB;gBACxF,8BAA8B,IAAI,CAAC,iBAAiB,aAAa,IAAI,EAAE;YACzE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,cAAc,EAAE,IAAI,CAAC,aAAa;YAClC,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;SAC5C;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"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"}

package/dist/render-backend.d.ts

@@ -1,4 +1,5 @@
 import type { AspectRatio, Resolution } from "./skills.js";
+import type { VendorRefusalClass } from "./vendor-response.js";
 /**
  * Вендор-нейтральный контракт рендера аватара.
  *
@@ -44,8 +45,9 @@ export type ImageSource = {
  */
 export interface AvatarClipRequest {
     /**
-     * Наш run_id. Адаптер обязан пробросить его в идемпотентность вендора
-     * (`Idempotency-Key`, детерминированный от `runId` + шага), если она есть.
+     * Наш run_id. Адаптер обязан пробросить в идемпотентность вендора
+     * (`Idempotency-Key`, если она есть) ОБЛАСТЬ — `idempotencyScope ?? runId`,
+     * а не сам `runId` безусловно: разбор — у поля `idempotencyScope` ниже.
      */
     runId: string;
     /**
@@ -122,10 +124,23 @@ export interface RenderBackend {
      * Реализация обязана:
      *  - разрешать внешность персонажа ВНУТРИ (вендорский каталог), не принимая её
      *    из запроса — идентификаторы аватара и каталог наружу не торчат;
-     *  - слать вендорский `Idempotency-Key`, детерминированный от `req.runId`, —
-     *    вторая независимая линия против двойного списания (подтверждено, docs/13);
-     *  - бросать НЕрайтраебл-ошибку на 4xx кроме 429 — ретрай их не починит;
-     *  - бросать райтраебл-ошибку на 5xx/429 — их ретрай починит.
+     *  - слать вендорский `Idempotency-Key`, детерминированный от ОБЛАСТИ
+     *    идемпотентности (`req.idempotencyScope ?? req.runId`, US-526), — вторая
+     *    независимая линия против двойного списания (подтверждено, docs/13).
+     *    Именно от области, а не от `runId`: у сегментного ролика на один ран
+     *    приходится несколько платных create, и общий ключ заставил бы вендора
+     *    вернуть первый ролик в ответ на каждый следующий — молча и с кодом 200;
+     *  - помечать ошибку признаком `retryable`: 4xx кроме 429 — `false`, 5xx и
+     *    429 — `true`.
+     *
+     * ПРИЗНАК ОПИСЫВАЕТ ПРИРОДУ ОШИБКИ, А НЕ РАЗРЕШЕНИЕ ПОВТОРИТЬ ЭТОТ ВЫЗОВ
+     * (уточнение US-606b, круг 11 внешнего ревью; прежняя редакция говорила «их
+     * ретрай починит» и читалась как позволение). «Транзиентная» и «можно
+     * повторить» — разные утверждения, и для ПЛАТНОГО создания второе всегда
+     * ложно: 429 означает, что вендор отбил, а 5xx — что неизвестно, начал ли он
+     * работу, и повтор превратил бы одно возможное списание в два достоверных.
+     * Признак читается ТОЛЬКО на бесплатном поллинге (`utils/poll-retry.ts`);
+     * `createAvatarJob` не повторяется ни при каком статусе.
      */
     createAvatarJob(req: AvatarClipRequest): Promise<AvatarJobHandle>;
     /**
@@ -141,7 +156,30 @@ export interface RenderBackend {
      * ожидания и бросать по его превышению, а не висеть на зависшей очереди.
      */
     pollAvatarJob(handle: AvatarJobHandle): Promise<AvatarClipResult>;
+    /** Чья причина за отказом: наш счёт у вендора или его беда. ОБЯЗАТЕЛЕН — */
+    /** новый вендор без него не скомпилируется. Разбор — `docs/18` §11.6. */
+    classifyRefusal(error: unknown): VendorRefusalClass;
 }
+/**
+ * ЧИТАТЕЛЬ ПРИЗНАКА, КОТОРЫЙ ТРЕБУЕТ КОНТРАКТ ВЫШЕ (US-606b).
+ *
+ * ЧТО ОН ЧИТАЕТ: природу ошибки, а не разрешение повторить операцию. Кто и что
+ * повторяет — решает вызывающий, и на ПЛАТНОМ создании ответ всегда «ничего»
+ * (см. `createAvatarJob` выше). Сегодня единственный потребитель — ретрай
+ * бесплатного поллинга.
+ *
+ * ЗАЧЕМ ЗДЕСЬ, А НЕ У ВЫЗЫВАЮЩЕГО. Обязанность помечать ошибку записана строкой
+ * выше, и до этой стори её никто не читал: адаптер считал признак, а
+ * потребителя у него не было — то есть контракт держался тестами адаптера на
+ * самого себя. Читатель обязан жить там же, где написана обязанность, иначе он
+ * станет разбором формы КОНКРЕТНОГО адаптера по месту, и второй бэкенд (Argil в
+ * docs/05) выполнит контракт, а вызывающий его не заметит.
+ *
+ * СТРОГОЕ РАВЕНСТВО `true`, А НЕ ПРИВЕДЕНИЕ К ИСТИНЕ: решение о повторе рядом с
+ * деньгами — последнее место, где уместна догадка «похоже на да». Чего в
+ * признаке нет (ошибка без поля, чужой объект, строка) — то не повторяется.
+ */
+export declare function isRetryableVendorError(error: unknown): boolean;
 /**
  * Приведение запроса к возможностям бэкенда.
  *

package/dist/render-backend.js

@@ -1,3 +1,27 @@
+/**
+ * ЧИТАТЕЛЬ ПРИЗНАКА, КОТОРЫЙ ТРЕБУЕТ КОНТРАКТ ВЫШЕ (US-606b).
+ *
+ * ЧТО ОН ЧИТАЕТ: природу ошибки, а не разрешение повторить операцию. Кто и что
+ * повторяет — решает вызывающий, и на ПЛАТНОМ создании ответ всегда «ничего»
+ * (см. `createAvatarJob` выше). Сегодня единственный потребитель — ретрай
+ * бесплатного поллинга.
+ *
+ * ЗАЧЕМ ЗДЕСЬ, А НЕ У ВЫЗЫВАЮЩЕГО. Обязанность помечать ошибку записана строкой
+ * выше, и до этой стори её никто не читал: адаптер считал признак, а
+ * потребителя у него не было — то есть контракт держался тестами адаптера на
+ * самого себя. Читатель обязан жить там же, где написана обязанность, иначе он
+ * станет разбором формы КОНКРЕТНОГО адаптера по месту, и второй бэкенд (Argil в
+ * docs/05) выполнит контракт, а вызывающий его не заметит.
+ *
+ * СТРОГОЕ РАВЕНСТВО `true`, А НЕ ПРИВЕДЕНИЕ К ИСТИНЕ: решение о повторе рядом с
+ * деньгами — последнее место, где уместна догадка «похоже на да». Чего в
+ * признаке нет (ошибка без поля, чужой объект, строка) — то не повторяется.
+ */
+export function isRetryableVendorError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        error.retryable === true);
+}
 /**
  * Приведение запроса к возможностям бэкенда.
  *

package/dist/render-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-backend.js","sourceRoot":"","sources":["../src/render-backend.ts"],"names":[],"mappings":"AAmJA;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAA0D,EAC1D,IAAyB,EACzB,WAAmB;IAEnB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,oCAAoC,CAAC,CAAC;QAC9E,CAAC;QACD,QAAQ,CAAC,IAAI,CACX,cAAc,UAAU,wBAAwB,WAAW,iBAAiB,QAAQ,EAAE,CACvF,CAAC;QACF,UAAU,GAAG,QAAQ,CAAC;IACxB,CAAC;IAED,IAAI,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IAClC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,sCAAsC,CAAC,CAAC;QAChF,CAAC;QACD,QAAQ,CAAC,IAAI,CACX,gBAAgB,WAAW,wBAAwB,WAAW,iBAAiB,QAAQ,EAAE,CAC1F,CAAC;QACF,WAAW,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"render-backend.js","sourceRoot":"","sources":["../src/render-backend.ts"],"names":[],"mappings":"AAsKA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,SAAS,KAAK,IAAI,CACtD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAA0D,EAC1D,IAAyB,EACzB,WAAmB;IAEnB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,oCAAoC,CAAC,CAAC;QAC9E,CAAC;QACD,QAAQ,CAAC,IAAI,CACX,cAAc,UAAU,wBAAwB,WAAW,iBAAiB,QAAQ,EAAE,CACvF,CAAC;QACF,UAAU,GAAG,QAAQ,CAAC;IACxB,CAAC;IAED,IAAI,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IAClC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,sCAAsC,CAAC,CAAC;QAChF,CAAC;QACD,QAAQ,CAAC,IAAI,CACX,gBAAgB,WAAW,wBAAwB,WAAW,iBAAiB,QAAQ,EAAE,CAC1F,CAAC;QACF,WAAW,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC"}

package/dist/run-static-warnings.d.ts

@@ -0,0 +1,5 @@
+/** Сохранённый вход нечитаем: перечислить несоблюдённые поля нечем. */
+export declare const UNREADABLE_RUN_INPUT_WARNING = "run input could not be read: parameters that are accepted but not honored cannot be listed for this run";
+export declare function derivedRunWarnings(storedInput: unknown): string[];
+/** Полный `warnings[]` рана. Выводимое первым — тем же порядком, что у `quote`. */
+export declare function composeRunWarnings(stored: unknown, storedInput: unknown): string[];

package/dist/run-static-warnings.js

@@ -0,0 +1,30 @@
+import { makeUgcInput, resolvedScript } from "./skills.js";
+import { dispositionWarnings } from "./contract-dispositions.js";
+import { buildVoiceWarnings } from "./voices.js";
+// Писатели хранят невыводимое, читатель выводит статику. Рационал — docs/18, Д41.
+/** Сохранённый вход нечитаем: перечислить несоблюдённые поля нечем. */
+export const UNREADABLE_RUN_INPUT_WARNING = "run input could not be read: parameters that are accepted but not honored cannot be listed for this run";
+// Реестр диспозиций и языковой warning пресета. Почему без `voice_id` —
+// docs/18, Д41.
+export function derivedRunWarnings(storedInput) {
+    const parsed = makeUgcInput.safeParse(storedInput);
+    if (!parsed.success) {
+        return [UNREADABLE_RUN_INPUT_WARNING];
+    }
+    const input = parsed.data;
+    return [
+        ...dispositionWarnings(input),
+        ...buildVoiceWarnings({ voice: input.voice, script: resolvedScript(input) }),
+    ];
+}
+/** Строки колонки `warnings`; нечитаемое значение даёт пустой список. */
+function storedStrings(stored) {
+    if (!Array.isArray(stored))
+        return [];
+    return stored.filter((item) => typeof item === "string");
+}
+/** Полный `warnings[]` рана. Выводимое первым — тем же порядком, что у `quote`. */
+export function composeRunWarnings(stored, storedInput) {
+    return [...new Set([...derivedRunWarnings(storedInput), ...storedStrings(stored)])];
+}
+//# sourceMappingURL=run-static-warnings.js.map

package/dist/run-static-warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-static-warnings.js","sourceRoot":"","sources":["../src/run-static-warnings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,kFAAkF;AAElF,uEAAuE;AACvE,MAAM,CAAC,MAAM,4BAA4B,GACvC,yGAAyG,CAAC;AAE5G,wEAAwE;AACxE,gBAAgB;AAChB,MAAM,UAAU,kBAAkB,CAAC,WAAoB;IACrD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,OAAO;QACL,GAAG,mBAAmB,CAAC,KAAK,CAAC;QAC7B,GAAG,kBAAkB,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;KAC7E,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,SAAS,aAAa,CAAC,MAAe;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,MAAe,EAAE,WAAoB;IACtE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,kBAAkB,CAAC,WAAW,CAAC,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/runs.d.ts

@@ -53,6 +53,9 @@ export declare const AI_DISCLOSURE_TEXT = "This video was generated with AI: the
  * всегда и детерминированно, без разбора боксов MP4.
  */
 export declare const AI_DISCLOSURE_OBJECT_METADATA: Readonly<Record<string, string>>;
+/** Форма идентификатора рана. Отдельной схемой, потому что её спрашивают и на */
+/** ВХОДЕ — MCP-тул `get_run`, где голый `z.string()` пускал мусор до сети. */
+export declare const runId: z.ZodString;
 export declare const run: z.ZodObject<{
     run_id: z.ZodString;
     skill: z.ZodString;

package/dist/runs.js

@@ -49,13 +49,30 @@ export const AI_DISCLOSURE_OBJECT_METADATA = {
     generator: "clipwright",
     "ai-disclosure": AI_DISCLOSURE_TEXT,
 };
+/** Форма идентификатора рана. Отдельной схемой, потому что её спрашивают и на */
+/** ВХОДЕ — MCP-тул `get_run`, где голый `z.string()` пускал мусор до сети. */
+export const runId = z.string().regex(/^run_[a-zA-Z0-9]+$/);
 export const run = z.object({
-    run_id: z.string().regex(/^run_[a-zA-Z0-9]+$/),
+    run_id: runId,
     skill: z.string(),
     state: runState,
     credits_reserved: z.number().int().nonnegative(),
     credits_charged: z.number().int().nonnegative().nullable(),
     warnings: z.array(z.string()).default([]),
+    /**
+     * Причина. НЕПУСТОЙ `error` НЕ ЗНАЧИТ `state: "failed"` — и это стало правдой
+     * с clipwright#48, поэтому сказано здесь, в контракте, а не только в коде.
+     *
+     * Второй случай: ран, не доживший до расчёта, чей счёт записал предыдущий
+     * проход сборщика. Его исход НЕИЗВЕСТЕН — успел он отдать видео или упал,
+     * по строке рана не различить, — поэтому состояние остаётся нетерминальным
+     * (врать о нём нельзя), а `error` несёт пометку «нужен разбор человеком».
+     * Пишет её `markRunForReview`.
+     *
+     * ЧТО ИЗ ЭТОГО СЛЕДУЕТ КЛИЕНТУ: опрос по-прежнему ждёт `succeeded` либо
+     * `failed`, а `error` при нетерминальном состоянии читается как объяснение
+     * задержки, а не как исход. Ран в этом состоянии сам не завершится.
+     */
     error: z.string().nullable(),
     final_output: z
         .object({

package/dist/runs.js.map

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

package/dist/skills.d.ts

@@ -45,7 +45,23 @@ export declare const DEV_RESOLUTION: Resolution;
  */
 export declare function resolveResolution(requested: Resolution | undefined, isDev: boolean): Resolution;
 /**
- * Потолок длины скрипта (docs/12 §11, ~45с озвучки) — временная замена
+ * ⚠️ ЭТО БАЗИС ВЫВОДА ПОТОЛКА СЛОВ, А НЕ ПОТОЛОК СЕКУНД, и имя переименовано
+ * ровно поэтому (находка внешней приёмки, круг 23). Прежнее — `MAX_SCRIPT_SECONDS`
+ * — читалось как «максимум секунд» и дважды подряд стало источником ДЕНЕЖНОГО
+ * дефекта на публичной странице цены: ею зажимали длительность, обещая клиенту
+ * меньше возможного счёта. Схема ограничивает только СЛОВА; сколько из них выйдет
+ * секунд, не ограничено ничем, потому что гейт пейсинга удалён.
+ *
+ * Число осталось прежним, роль названа честно: это множимое, из которого вместе
+ * с быстрым краем пейсинга получается `MAX_SCRIPT_WORDS`.
+ *
+ * ⚠️ ИСХОДНЫЙ ДОВОД НИЖЕ ОПИСЫВАЕТ ПОЛОЖЕНИЕ ДО УДАЛЕНИЯ ГЕЙТА ПЕЙСИНГА и
+ * оставлен как история, а не как действующее объяснение (находка внешней
+ * приёмки, круг 24): он объясняет число через «~45с озвучки» и пейсинг-гейт,
+ * которого с 2026-07-22 не существует. Действующее объяснение — абзац выше:
+ * это множимое, и ограничивает контракт только слова.
+ *
+ * Исходный довод (docs/12 §11) — временная замена
  * мульти-тейка (docs/12 §3: длинные скрипты раньше резались на несколько
  * тейков, эта логика вырезана на время прототипа). Пока мульти-тейк не
  * вернули, скрипт длиннее одного тейка нужно отклонять на входе, а не
@@ -56,8 +72,17 @@ export declare function resolveResolution(requested: Resolution | undefined, isD
  * потолок секунд без нарушения пейсинг-гейта. Числа пейсинга не дублируем,
  * берём готовые константы из pacing.ts.
  */
-export declare const MAX_SCRIPT_SECONDS = 45;
+export declare const SCRIPT_SECONDS_BASIS = 45;
 export declare const MAX_SCRIPT_WORDS: number;
+/** Потолок длины ЛЮБОГО адреса из чужого тела: без него поле берёт весь потолок */
+/** тела запроса. Число — верхний предел, который переваривает любой браузер и CDN. */
+export declare const MAX_URL_LENGTH = 2048;
+/** ЧТО ДЕЛАЕТ `make_ugc` — один текст на обе контрактные поверхности: публичный */
+/** REST-каталог и MCP `tools/list`. Разойдясь, они описали бы РАЗНЫЙ скилл. */
+export declare const MAKE_UGC_DESCRIPTION: string;
+/** Как ЗВАТЬ скилл по MCP. Отдельно от описания выше: имена соседних тулов и */
+/** поллинг — свойства протокола, и REST-каталогу они не адресованы. */
+export declare const MAKE_UGC_AGENT_PROTOCOL: string;
 /**
  * Сырой zod-shape входа make_ugc — БЕЗ `.refine()`.
  *