@clipwright/core 0.18.0 → 0.20.0

package/CHANGELOG.md

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

package/dist/__fixtures__/queue-promises.d.ts

@@ -1,87 +1,8 @@
-/**
- * ОБЕЩАНИЯ ОЧЕРЕДИ, ЗАПРЕЩЁННЫЕ НА ОТКАЗЕ `account_not_admitted` (US-620).
- *
- * ПРАВИЛО (держится чтением; проверка ниже — лишь регрессионный сторож против
- * уже случавшихся формулировок, см. «что она не гарантирует»). Из 403 известно
- * ровно одно: у аккаунта нет доступа. Тем же ответом
- * отвечает аккаунт, у которого доступ СНЯЛИ (третья поверхность вентиля
- * построена вокруг именно этого случая — `credit-guard.ts`), и обещание скорого
- * приёма было бы для него ложью в самый неподходящий момент. Поэтому ни одна
- * поверхность, объясняющая этот отказ, не называет ни срока, ни номера.
- *
- * ПОЧЕМУ СПИСОК ОДИН НА ВСЕХ. Правило нарушалось ПЯТЬ раз подряд, и каждый раз
- * чинилось по адресу находки: совет агенту, `SKILL.md`, тело ответа, снова
- * совет, публичная дока. Когда сторожей стало двое, список немедленно
- * разошёлся: у одного было `yet`, у другого — русские корни. Два ответа на
- * вопрос «что такое это правило» — тот же дефект, который эта же приёмка дважды
- * признавала блокером (два перечня писателей `admitted_at`, два текста про
- * очередь). Лечение одно и то же: одна копия, остальные ссылаются.
- *
- * ЯЗЫКА ДВА, ПОТОМУ ЧТО КОРПУС ДВУЯЗЫЧНЫЙ. Код и агентские тексты английские,
- * документация и комментарии русские. Пятое вхождение уцелело ровно потому, что
- * сторож знал только английский.
- *
- * КОРНИ, А НЕ СЛОВОФОРМЫ: `волн` ловит «волну» и «волнами», `очеред` —
- * «очередь» и «очереди».
- *
- * ЧТО ЭТА ПРОВЕРКА НЕ ГАРАНТИРУЕТ, И ЭТО ГЛАВНОЕ ПРО НЕЁ.
- *
- * Она НЕ обеспечивает инвариант «не называет срока» — обеспечить смысловой
- * инвариант списком подстрок невозможно в принципе. «access will be granted
- * tomorrow», «доступ появится в пятницу», «soon» пройдут: их в списке нет, и
- * добавить все нельзя — язык не кончается. Обещание, написанное вовсе без имени
- * отказа, тоже пройдёт: якорь его не найдёт.
- *
- * ЧЕГО СПИСОК НЕ ЗНАЕТ, названо поимённо, чтобы следующий автор не полагался на
- * сторожа там, где тот слеп: `soon`, `shortly`, `waitlist`, `invite`, `batch`,
- * «скоро», «в ближайшее время», «лист ожидания», «пригласим», «завтра». Все они
- * пройдут. Добавлять их нельзя: «скоро» и `soon` встречаются в верных текстах
- * повсюду, и сторож станет шумным — а шумного снимают.
- *
- * Что она РЕАЛЬНО делает: не даёт вернуться ШЕСТИ формулировкам, которые в этой
- * стори уже возвращались — по одной на круг приёмки, в шести разных местах.
- * Регрессионный сторож против известного класса, а не доказательство свойства.
- * Само свойство держит чтение: правило и его довод записаны у
- * `accountNotAdmittedError`, и рецензент, читающий текст отказа, проверяет
- * смысл, а не подстроки. Считать иначе — значит второй раз поверить, что
- * зелёный тест равен верному коду.
- *
- * ЧЕМ ЭТА ПРОВЕРКА ПЛАТИТ, названо прямо. Подстрочный поиск не отличает
- * обещание от его отрицания: верная фраза «отказ не ставит аккаунт в очередь»
- * покраснеет. Это осознанный обмен — сторож ошибается ГРОМКО и чинится
- * переписыванием фразы, тогда как сторож, разбирающий отрицания, ошибётся ТИХО
- * и пропустит обещание. Тексты запретов в этом проекте пишутся без запрещаемых
- * слов; так уже сделано в `SKILL.md` и в `docs/03-api.md`.
- *
- * ЛЕЖИТ В `__fixtures__`, а не в публичном экспорте пакета: это тестовый
- * материал, а не часть контракта клиентов.
- */
+/** One list for every guard, in both corpus languages; stems, not word forms. Substring */
+/** matching also flags negations, which is accepted: the guard fails loudly, not silently. */
 export declare const QUEUE_PROMISES: readonly ["in waves", "in the queue", "next wave", "yet", "волн", "очеред", "пока что", "подожди"];
-/**
- * Предмет правила — В НОРМАЛИЗОВАННОМ ВИДЕ, а не одним написанием.
- *
- * Скоуп по ИМЕНИ, а не по файлу, проводит границу по смыслу: `CLAUDE.md` вправе
- * описывать приём волнами как операторский процесс, а `docs/03-api.md` §7 —
- * очередь рендеров при превышении потолка. Ни то, ни другое не утверждает
- * ничего про этот 403.
- *
- * НО ИМЯ У ПРЕДМЕТА НЕ ОДНО. Кодовая база называет его четырьмя написаниями:
- * `account_not_admitted` (тело и документы), `accountNotAdmittedBody`
- * (сборка), `NotAdmittedFailure` (вид отказа) и `kind: "not_admitted"` (вердикт
- * на четырёх поверхностях). Сторож, знавший только первое, не видел ЧЕТЫРЕХ
- * файлов, объясняющих тот же отказ, — включая сообщение `issue-token.ts`,
- * которое читает человек. Обе приёмки нашли это независимо, и это та же форма,
- * что «список слов английский, а корпус двуязычный»: скоуп по смыслу остаётся
- * скоупом по написанию, пока опознание однодиалектное.
- *
- * Поэтому сравнение идёт по нормализованному тексту: снимаем `_`, приводим к
- * нижнему регистру, ищем подстроку. Любое БУДУЩЕЕ написание ловится само, без
- * правки сторожа.
- *
- * ЛОЖНЫХ СРАБАТЫВАНИЙ НА СОСЕДЯХ НЕТ, и это проверено, а не предположено:
- * `already_admitted` (вердикт US-602 «у рана уже есть холд») нормализуется в
- * `alreadyadmitted` и подстроки `notadmitted` не содержит.
- */
+/** The subject in normalized form: `_` removed and lowercased, so every spelling of the */
+/** refusal (`account_not_admitted`, `NotAdmittedFailure`) matches; `already_admitted` does not. */
 export declare const NOT_ADMITTED_ANCHOR = "notadmitted";
-/** Снимает разницу написаний: `account_not_admitted` и `NotAdmittedFailure` — одно. */
+/** Removes spelling differences: `account_not_admitted` and `NotAdmittedFailure` are one. */
 export declare function normalizeForAnchor(text: string): string;

package/dist/__fixtures__/queue-promises.js

@@ -1,61 +1,7 @@
-/**
- * ОБЕЩАНИЯ ОЧЕРЕДИ, ЗАПРЕЩЁННЫЕ НА ОТКАЗЕ `account_not_admitted` (US-620).
- *
- * ПРАВИЛО (держится чтением; проверка ниже — лишь регрессионный сторож против
- * уже случавшихся формулировок, см. «что она не гарантирует»). Из 403 известно
- * ровно одно: у аккаунта нет доступа. Тем же ответом
- * отвечает аккаунт, у которого доступ СНЯЛИ (третья поверхность вентиля
- * построена вокруг именно этого случая — `credit-guard.ts`), и обещание скорого
- * приёма было бы для него ложью в самый неподходящий момент. Поэтому ни одна
- * поверхность, объясняющая этот отказ, не называет ни срока, ни номера.
- *
- * ПОЧЕМУ СПИСОК ОДИН НА ВСЕХ. Правило нарушалось ПЯТЬ раз подряд, и каждый раз
- * чинилось по адресу находки: совет агенту, `SKILL.md`, тело ответа, снова
- * совет, публичная дока. Когда сторожей стало двое, список немедленно
- * разошёлся: у одного было `yet`, у другого — русские корни. Два ответа на
- * вопрос «что такое это правило» — тот же дефект, который эта же приёмка дважды
- * признавала блокером (два перечня писателей `admitted_at`, два текста про
- * очередь). Лечение одно и то же: одна копия, остальные ссылаются.
- *
- * ЯЗЫКА ДВА, ПОТОМУ ЧТО КОРПУС ДВУЯЗЫЧНЫЙ. Код и агентские тексты английские,
- * документация и комментарии русские. Пятое вхождение уцелело ровно потому, что
- * сторож знал только английский.
- *
- * КОРНИ, А НЕ СЛОВОФОРМЫ: `волн` ловит «волну» и «волнами», `очеред` —
- * «очередь» и «очереди».
- *
- * ЧТО ЭТА ПРОВЕРКА НЕ ГАРАНТИРУЕТ, И ЭТО ГЛАВНОЕ ПРО НЕЁ.
- *
- * Она НЕ обеспечивает инвариант «не называет срока» — обеспечить смысловой
- * инвариант списком подстрок невозможно в принципе. «access will be granted
- * tomorrow», «доступ появится в пятницу», «soon» пройдут: их в списке нет, и
- * добавить все нельзя — язык не кончается. Обещание, написанное вовсе без имени
- * отказа, тоже пройдёт: якорь его не найдёт.
- *
- * ЧЕГО СПИСОК НЕ ЗНАЕТ, названо поимённо, чтобы следующий автор не полагался на
- * сторожа там, где тот слеп: `soon`, `shortly`, `waitlist`, `invite`, `batch`,
- * «скоро», «в ближайшее время», «лист ожидания», «пригласим», «завтра». Все они
- * пройдут. Добавлять их нельзя: «скоро» и `soon` встречаются в верных текстах
- * повсюду, и сторож станет шумным — а шумного снимают.
- *
- * Что она РЕАЛЬНО делает: не даёт вернуться ШЕСТИ формулировкам, которые в этой
- * стори уже возвращались — по одной на круг приёмки, в шести разных местах.
- * Регрессионный сторож против известного класса, а не доказательство свойства.
- * Само свойство держит чтение: правило и его довод записаны у
- * `accountNotAdmittedError`, и рецензент, читающий текст отказа, проверяет
- * смысл, а не подстроки. Считать иначе — значит второй раз поверить, что
- * зелёный тест равен верному коду.
- *
- * ЧЕМ ЭТА ПРОВЕРКА ПЛАТИТ, названо прямо. Подстрочный поиск не отличает
- * обещание от его отрицания: верная фраза «отказ не ставит аккаунт в очередь»
- * покраснеет. Это осознанный обмен — сторож ошибается ГРОМКО и чинится
- * переписыванием фразы, тогда как сторож, разбирающий отрицания, ошибётся ТИХО
- * и пропустит обещание. Тексты запретов в этом проекте пишутся без запрещаемых
- * слов; так уже сделано в `SKILL.md` и в `docs/03-api.md`.
- *
- * ЛЕЖИТ В `__fixtures__`, а не в публичном экспорте пакета: это тестовый
- * материал, а не часть контракта клиентов.
- */
+// Queue promises forbidden on an `account_not_admitted` refusal: a 403 says only that access is
+// missing, possibly revoked. A regression guard against known phrasings, not a proof of the rule.
+/** One list for every guard, in both corpus languages; stems, not word forms. Substring */
+/** matching also flags negations, which is accepted: the guard fails loudly, not silently. */
 export const QUEUE_PROMISES = [
     "in waves",
     "in the queue",
@@ -66,33 +12,10 @@ export const QUEUE_PROMISES = [
     "пока что",
     "подожди",
 ];
-/**
- * Предмет правила — В НОРМАЛИЗОВАННОМ ВИДЕ, а не одним написанием.
- *
- * Скоуп по ИМЕНИ, а не по файлу, проводит границу по смыслу: `CLAUDE.md` вправе
- * описывать приём волнами как операторский процесс, а `docs/03-api.md` §7 —
- * очередь рендеров при превышении потолка. Ни то, ни другое не утверждает
- * ничего про этот 403.
- *
- * НО ИМЯ У ПРЕДМЕТА НЕ ОДНО. Кодовая база называет его четырьмя написаниями:
- * `account_not_admitted` (тело и документы), `accountNotAdmittedBody`
- * (сборка), `NotAdmittedFailure` (вид отказа) и `kind: "not_admitted"` (вердикт
- * на четырёх поверхностях). Сторож, знавший только первое, не видел ЧЕТЫРЕХ
- * файлов, объясняющих тот же отказ, — включая сообщение `issue-token.ts`,
- * которое читает человек. Обе приёмки нашли это независимо, и это та же форма,
- * что «список слов английский, а корпус двуязычный»: скоуп по смыслу остаётся
- * скоупом по написанию, пока опознание однодиалектное.
- *
- * Поэтому сравнение идёт по нормализованному тексту: снимаем `_`, приводим к
- * нижнему регистру, ищем подстроку. Любое БУДУЩЕЕ написание ловится само, без
- * правки сторожа.
- *
- * ЛОЖНЫХ СРАБАТЫВАНИЙ НА СОСЕДЯХ НЕТ, и это проверено, а не предположено:
- * `already_admitted` (вердикт US-602 «у рана уже есть холд») нормализуется в
- * `alreadyadmitted` и подстроки `notadmitted` не содержит.
- */
+/** The subject in normalized form: `_` removed and lowercased, so every spelling of the */
+/** refusal (`account_not_admitted`, `NotAdmittedFailure`) matches; `already_admitted` does not. */
 export const NOT_ADMITTED_ANCHOR = "notadmitted";
-/** Снимает разницу написаний: `account_not_admitted` и `NotAdmittedFailure` — одно. */
+/** Removes spelling differences: `account_not_admitted` and `NotAdmittedFailure` are one. */
 export function normalizeForAnchor(text) {
     return text.replaceAll("_", "").toLowerCase();
 }

package/dist/__fixtures__/queue-promises.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue-promises.js","sourceRoot":"","sources":["../../src/__fixtures__/queue-promises.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU;IACV,cAAc;IACd,WAAW;IACX,KAAK;IACL,MAAM;IACN,QAAQ;IACR,UAAU;IACV,SAAS;CACD,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEjD,uFAAuF;AACvF,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAChD,CAAC"}
+{"version":3,"file":"queue-promises.js","sourceRoot":"","sources":["../../src/__fixtures__/queue-promises.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,kGAAkG;AAElG,2FAA2F;AAC3F,8FAA8F;AAC9F,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU;IACV,cAAc;IACd,WAAW;IACX,KAAK;IACL,MAAM;IACN,QAAQ;IACR,UAAU;IACV,SAAS;CACD,CAAC;AAEX,2FAA2F;AAC3F,mGAAmG;AACnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEjD,6FAA6F;AAC7F,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAChD,CAAC"}

package/dist/account-actors.d.ts

@@ -1,23 +1,23 @@
 import { z } from "zod";
 import { type ActorQuality } from "./actor-qualities.js";
 import { type AspectRatio } from "./skills.js";
-/** Личные актёры аккаунта (clipwright#120, этап 2). Решение и доводы — docs/adr/0003-account-actors.md. */
+/** Personal actors of an account. */
 export { ACTOR_DEFAULT_QUALITY, ACTOR_QUALITIES_ACCEPTED, ACTOR_QUALITIES_KNOWN } from "./actor-qualities.js";
 export type { ActorQuality, ActorQualityAccepted } from "./actor-qualities.js";
 export { ACTOR_AGE_FLOOR, ACTOR_ASPECTS_KNOWN, ACTOR_DESCRIPTION_MAX_CHARS, ACTOR_GENDERS_ACCEPTED, ACTOR_GENDERS_KNOWN, ACTOR_MAX_AGE, ACTOR_MIN_AGE, ACTOR_NAME_MAX_CHARS, } from "./actor-bounds.js";
 export type { ActorAspectKnown, ActorGender } from "./actor-bounds.js";
 export declare const PERSONAL_ACTOR_ID_PREFIX = "actor_u_";
-/** `actor_u_` и 26 знаков base32 (RFC 4648, строчные) — 128 случайных бит. */
+/** `actor_u_` plus 26 base32 characters (RFC 4648, lowercase): 128 random bits. */
 export declare const personalActorId: z.ZodString;
 export declare const ACTOR_SCOPES: readonly ["clipwright", "account"];
 export type ActorScope = (typeof ACTOR_SCOPES)[number];
-/** Чей актёр — по форме id. Каталог Clipwright префикс `actor_u_` не занимает: это сверяет тест. */
+/** Whose actor, by id shape. The Clipwright catalog never uses the `actor_u_` prefix; a test checks it. */
 export declare function actorIdScope(actorId: string): ActorScope;
-/** Случайность приходит снаружи: core не зависит от криптографии рантайма. */
+/** Randomness comes from outside: core does not depend on the runtime's crypto. */
 export declare function newPersonalActorId(random: Uint8Array): string;
-/** Портрет — всегда 9:16; остальные форматы правятся из него. */
+/** The portrait is always 9:16; the other formats are edited from it. */
 export declare const ACTOR_PORTRAIT_ASPECT: "9:16";
-/** Размеры генерации compact (решение владельца 2026-09-14, замер G0). */
+/** Compact generation sizes, measured. */
 export declare const ACTOR_SIZE_SET: {
     readonly "9:16": {
         readonly width: 1024;
@@ -33,7 +33,7 @@ export declare const ACTOR_SIZE_SET: {
     };
 };
 type AcceptedQualities = readonly [ActorQuality, ...ActorQuality[]];
-/** Вход при данном множестве принимаемых качеств. */
+/** The input for a given set of accepted qualities. */
 export declare function createActorInputWith<const Q extends AcceptedQualities>(accepted: Q, defaultQuality: Q[number]): z.ZodObject<{
     description: z.ZodString;
     gender: z.ZodEnum<{
@@ -68,10 +68,10 @@ export declare const createActorInput: z.ZodObject<{
     }>>;
 }, z.core.$strict>;
 export type CreateActorInput = z.infer<typeof createActorInput>;
-/** Вход ДО дефолтов — то, что пишет вызыватель: `quality` и `aspect_ratios` необязательны. */
-/** Тот же приём, что у `MakeUgcInputArgs`: клиенту нельзя навязывать поля со значением по умолчанию. */
+/** The input BEFORE defaults, as the caller writes it: `quality` and `aspect_ratios` are optional, */
+/** as with `MakeUgcInputArgs`, so callers are not forced to fill defaulted fields. */
 export type CreateActorInputArgs = z.input<typeof createActorInput>;
-/** Плоская форма для MCP: инструмент публикует ту же схему, что проверяет сервер. */
+/** Flat shape for MCP: the tool publishes the same schema the server checks. */
 export declare const createActorInputShape: {
     description: z.ZodString;
     gender: z.ZodEnum<{
@@ -94,7 +94,7 @@ export declare const actorUnitCredits: z.ZodObject<{
     portrait: z.ZodNumber;
     variant: z.ZodNumber;
 }, z.core.$strip>;
-/** Цены единиц и запрошенные форматы, закреплённые при допуске; расчёт идёт по ним, а не по таблице. */
+/** Unit prices and requested formats fixed at admission; settlement uses these, not the price table. */
 export declare const actorPricingSnapshot: z.ZodObject<{
     quality: z.ZodEnum<{
         high: "high";
@@ -111,7 +111,7 @@ export declare const actorPricingSnapshot: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type ActorPricingSnapshot = z.infer<typeof actorPricingSnapshot>;
-/** Снимок, который допуск создаёт: форматы приёма, портрет обязателен, повторов нет. */
+/** The snapshot admission creates: accepted formats, portrait required, no repeats. */
 export declare const admittedActorPricingSnapshot: z.ZodObject<{
     quality: z.ZodEnum<{
         high: "high";
@@ -127,8 +127,8 @@ export declare const admittedActorPricingSnapshot: z.ZodObject<{
         "9:16": "9:16";
     }>>;
 }, z.core.$strip>;
-/** Сохранённый вход рана. Качество и форматы обязаны совпасть со снимком: иначе генерация */
-/** разошлась бы со списанием, поэтому такой ран не читается (`run_input_unreadable`, ноль кредитов). */
+/** A stored run input. Quality and formats must match the snapshot, or generation would diverge */
+/** from the charge, so such a run does not read (`run_input_unreadable`, zero credits). */
 export declare const storedCreateActorInput: z.ZodObject<{
     description: z.ZodString;
     gender: z.ZodEnum<{
@@ -185,8 +185,8 @@ export declare const createActorQuote: z.ZodObject<{
     contract_version: z.ZodString;
 }, z.core.$strip>;
 export type CreateActorQuote = z.infer<typeof createActorQuote>;
-/** Актёр, созданный раном, при чтении. Удаление актёра стирает имя и снимает форматы с публикации, */
-/** а `get_run` старого рана обязан отвечать, поэтому пустые имя и форматы читаются. */
+/** The actor a run created, as read. Deleting an actor erases the name and unpublishes formats, */
+/** yet `get_run` on an old run must answer, so an empty name and formats read. */
 export declare const createdActor: z.ZodObject<{
     actor_id: z.ZodString;
     name: z.ZodString;
@@ -207,7 +207,7 @@ export declare const createdActor: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type CreatedActor = z.infer<typeof createdActor>;
-/** Итог, который пишет успешный ран: имя и опубликованные форматы, среди них портрет 9:16. */
+/** The result a successful run writes: a name and published formats, the 9:16 portrait among them. */
 export declare const producedCreatedActor: z.ZodObject<{
     actor_id: z.ZodString;
     gender: z.ZodEnum<{
@@ -227,7 +227,7 @@ export declare const producedCreatedActor: z.ZodObject<{
         "9:16": "9:16";
     }>>;
 }, z.core.$strip>;
-/** Решение по полю входа `create_actor`; смысл видов — как у реестра `make_ugc` (contract-dispositions.ts). */
+/** Decision for a `create_actor` input field; kinds mean what they do in the `make_ugc` registry. */
 export type CreateActorDisposition = {
     kind: "implemented";
     provenBy: "egress" | "listing";
@@ -262,9 +262,9 @@ export declare const CREATE_ACTOR_FIELD_DISPOSITIONS: {
         readonly provenBy: "egress";
     };
 };
-/** Предупреждения допуска — только из реестра; пишутся в `runs.warnings` и не пересчитываются при чтении. */
+/** Admission warnings come only from the registry; written to `runs.warnings`, not recomputed on read. */
 export declare function createActorAdmissionWarnings(input: Readonly<Record<string, unknown>>, dispositions?: Readonly<Record<string, CreateActorDisposition>>): string[];
-/** Коды провала рана `create_actor`: у каждого — ноль кредитов. Колонка `error` — `код: текст`. */
+/** `create_actor` run failure codes, each charging zero credits. The `error` column reads `code: text`. */
 export declare const CREATE_ACTOR_RUN_ERRORS: {
     readonly actor_portrait_unusable: "the generated portrait did not show exactly one face; no actor was created and nothing was charged";
     readonly actor_prompt_refused: string;
@@ -279,14 +279,14 @@ export declare const CREATE_ACTOR_RUN_ERRORS: {
 export type CreateActorRunErrorCode = keyof typeof CREATE_ACTOR_RUN_ERRORS;
 export declare const CREATE_ACTOR_RUN_ERROR_CODES: CreateActorRunErrorCode[];
 export declare function createActorRunError(code: CreateActorRunErrorCode): string;
-/** Формат `runs.error` для кода с уточнением: код до двоеточия читают алерты. */
+/** The `runs.error` format for a code with a detail: alerts read the code up to the colon. */
 export declare function createActorRunErrorWith(code: CreateActorRunErrorCode, detail: string): string;
 export declare const ACTOR_VARIANT_ASPECTS: ("16:9" | "1:1")[];
-/** Вариант, не созданный по нашей причине: успешный ран несёт эту строку в `warnings`. */
+/** A variant not created for a reason of ours: the successful run carries this line in `warnings`. */
 export declare function actorVariantWarning(aspect: AspectRatio, reason: string): string;
-/** Сорванная проверка лица на этапе вариантов: ран УСПЕШЕН, кода провала нет. */
-/** Одно определение на писателя (таск) и счётчик (алерт 10), сравнение — целой строкой. */
+/** A face check that failed at the variant stage: the run SUCCEEDS, with no failure code. One */
+/** definition for the writer (task) and the counter (alert), compared as whole lines. */
 export declare const ACTOR_VARIANT_FACE_CHECK_REASON = "the face check was unavailable";
 export declare const ACTOR_VARIANT_FACE_CHECK_WARNINGS: readonly string[];
-/** Что делает `create_actor` — один текст для публичного каталога скиллов и клиентов. */
+/** What `create_actor` does: one text for the public skill catalog and clients. */
 export declare const CREATE_ACTOR_DESCRIPTION: string;

package/dist/account-actors.js

@@ -2,20 +2,20 @@ import { z } from "zod";
 import { ACTOR_DEFAULT_QUALITY, ACTOR_QUALITIES_ACCEPTED, ACTOR_QUALITIES_KNOWN, } from "./actor-qualities.js";
 import { ACTOR_AGE_FLOOR, ACTOR_ASPECTS_KNOWN, ACTOR_DESCRIPTION_MAX_CHARS, ACTOR_GENDERS_ACCEPTED, ACTOR_GENDERS_KNOWN, ACTOR_MAX_AGE, ACTOR_MIN_AGE, ACTOR_NAME_MAX_CHARS, } from "./actor-bounds.js";
 import { ASPECT_RATIOS } from "./skills.js";
-/** Личные актёры аккаунта (clipwright#120, этап 2). Решение и доводы — docs/adr/0003-account-actors.md. */
+/** Personal actors of an account. */
 export { ACTOR_DEFAULT_QUALITY, ACTOR_QUALITIES_ACCEPTED, ACTOR_QUALITIES_KNOWN } from "./actor-qualities.js";
 export { ACTOR_AGE_FLOOR, ACTOR_ASPECTS_KNOWN, ACTOR_DESCRIPTION_MAX_CHARS, ACTOR_GENDERS_ACCEPTED, ACTOR_GENDERS_KNOWN, ACTOR_MAX_AGE, ACTOR_MIN_AGE, ACTOR_NAME_MAX_CHARS, } from "./actor-bounds.js";
 export const PERSONAL_ACTOR_ID_PREFIX = "actor_u_";
 const PERSONAL_ACTOR_ID_BYTES = 16;
 const BASE32_ALPHABET = "abcdefghijklmnopqrstuvwxyz234567";
-/** `actor_u_` и 26 знаков base32 (RFC 4648, строчные) — 128 случайных бит. */
+/** `actor_u_` plus 26 base32 characters (RFC 4648, lowercase): 128 random bits. */
 export const personalActorId = z.string().regex(/^actor_u_[a-z2-7]{26}$/);
 export const ACTOR_SCOPES = ["clipwright", "account"];
-/** Чей актёр — по форме id. Каталог Clipwright префикс `actor_u_` не занимает: это сверяет тест. */
+/** Whose actor, by id shape. The Clipwright catalog never uses the `actor_u_` prefix; a test checks it. */
 export function actorIdScope(actorId) {
     return personalActorId.safeParse(actorId).success ? "account" : "clipwright";
 }
-/** Случайность приходит снаружи: core не зависит от криптографии рантайма. */
+/** Randomness comes from outside: core does not depend on the runtime's crypto. */
 export function newPersonalActorId(random) {
     if (random.length !== PERSONAL_ACTOR_ID_BYTES) {
         throw new Error(`personal actor id needs ${PERSONAL_ACTOR_ID_BYTES} random bytes, got ${random.length}`);
@@ -36,9 +36,9 @@ export function newPersonalActorId(random) {
         encoded += BASE32_ALPHABET.charAt((buffer << (5 - bits)) & 31);
     return PERSONAL_ACTOR_ID_PREFIX + encoded;
 }
-/** Портрет — всегда 9:16; остальные форматы правятся из него. */
+/** The portrait is always 9:16; the other formats are edited from it. */
 export const ACTOR_PORTRAIT_ASPECT = "9:16";
-/** Размеры генерации compact (решение владельца 2026-09-14, замер G0). */
+/** Compact generation sizes, measured. */
 export const ACTOR_SIZE_SET = {
     "9:16": { width: 1024, height: 1824 },
     "1:1": { width: 1024, height: 1024 },
@@ -46,7 +46,7 @@ export const ACTOR_SIZE_SET = {
 };
 const includesPortrait = (ratios) => ratios.includes(ACTOR_PORTRAIT_ASPECT);
 const hasNoRepeats = (ratios) => new Set(ratios).size === ratios.length;
-/** Поля строгого входа без качества. Границы — из actor-bounds.ts; схемы чтения их не берут. */
+/** Strict input fields without quality. Bounds come from actor-bounds.ts; read schemas do not use them. */
 const actorFieldShape = {
     description: z
         .string()
@@ -82,7 +82,7 @@ function unknownFieldsRefusal(keys) {
     }
     return `unknown field(s) ${keys.join(", ")}: create_actor accepts description, gender, approximate_age, name, quality, aspect_ratios`;
 }
-/** Вход при данном множестве принимаемых качеств. */
+/** The input for a given set of accepted qualities. */
 export function createActorInputWith(accepted, defaultQuality) {
     return z.strictObject({
         ...actorFieldShape,
@@ -98,22 +98,22 @@ export function createActorInputWith(accepted, defaultQuality) {
     });
 }
 export const createActorInput = createActorInputWith(ACTOR_QUALITIES_ACCEPTED, ACTOR_DEFAULT_QUALITY);
-/** Плоская форма для MCP: инструмент публикует ту же схему, что проверяет сервер. */
+/** Flat shape for MCP: the tool publishes the same schema the server checks. */
 export const createActorInputShape = createActorInput.shape;
 export const actorUnitCredits = z.object({
     portrait: z.number().int().positive(),
     variant: z.number().int().positive(),
 });
-/** Схемы чтения зависят только от того, что могло быть записано: известных множеств и CHECK 0031. */
-/** Границы приёма в них не входят, поэтому сужение приёма старых ранов не ломает. */
+/** Read schemas depend only on what could have been written: the known sets and the DB check. */
+/** Intake bounds stay out, so narrowing intake never breaks old runs. */
 const storedAspects = z.array(z.enum(ACTOR_ASPECTS_KNOWN)).min(1);
-/** Цены единиц и запрошенные форматы, закреплённые при допуске; расчёт идёт по ним, а не по таблице. */
+/** Unit prices and requested formats fixed at admission; settlement uses these, not the price table. */
 export const actorPricingSnapshot = z.object({
     quality: z.enum(ACTOR_QUALITIES_KNOWN),
     unit_credits: actorUnitCredits,
     requested_aspects: storedAspects,
 });
-/** Снимок, который допуск создаёт: форматы приёма, портрет обязателен, повторов нет. */
+/** The snapshot admission creates: accepted formats, portrait required, no repeats. */
 export const admittedActorPricingSnapshot = actorPricingSnapshot.extend({
     requested_aspects: z
         .array(z.enum(ASPECT_RATIOS))
@@ -126,8 +126,8 @@ function sameFormats(left, right) {
     const b = new Set(right);
     return a.size === b.size && [...a].every((ratio) => b.has(ratio));
 }
-/** Сохранённый вход рана. Качество и форматы обязаны совпасть со снимком: иначе генерация */
-/** разошлась бы со списанием, поэтому такой ран не читается (`run_input_unreadable`, ноль кредитов). */
+/** A stored run input. Quality and formats must match the snapshot, or generation would diverge */
+/** from the charge, so such a run does not read (`run_input_unreadable`, zero credits). */
 export const storedCreateActorInput = z
     .object({
     description: z.string().min(1),
@@ -153,8 +153,8 @@ export const createActorQuote = z.object({
     warnings: z.array(z.string()).default([]),
     contract_version: z.string(),
 });
-/** Актёр, созданный раном, при чтении. Удаление актёра стирает имя и снимает форматы с публикации, */
-/** а `get_run` старого рана обязан отвечать, поэтому пустые имя и форматы читаются. */
+/** The actor a run created, as read. Deleting an actor erases the name and unpublishes formats, */
+/** yet `get_run` on an old run must answer, so an empty name and formats read. */
 export const createdActor = z.object({
     actor_id: personalActorId,
     name: z.string(),
@@ -164,7 +164,7 @@ export const createdActor = z.object({
     quality: z.enum(ACTOR_QUALITIES_KNOWN),
     aspect_ratios: z.array(z.enum(ACTOR_ASPECTS_KNOWN)),
 });
-/** Итог, который пишет успешный ран: имя и опубликованные форматы, среди них портрет 9:16. */
+/** The result a successful run writes: a name and published formats, the 9:16 portrait among them. */
 export const producedCreatedActor = createdActor.extend({
     name: z.string().min(1),
     aspect_ratios: storedAspects.refine(includesPortrait, {
@@ -179,11 +179,11 @@ export const CREATE_ACTOR_FIELD_DISPOSITIONS = {
     quality: { kind: "implemented", provenBy: "egress" },
     aspect_ratios: { kind: "implemented", provenBy: "egress" },
 };
-/** Предупреждения допуска — только из реестра; пишутся в `runs.warnings` и не пересчитываются при чтении. */
+/** Admission warnings come only from the registry; written to `runs.warnings`, not recomputed on read. */
 export function createActorAdmissionWarnings(input, dispositions = CREATE_ACTOR_FIELD_DISPOSITIONS) {
     return Object.entries(dispositions).flatMap(([field, disposition]) => disposition.kind === "warned" && input[field] !== undefined ? [disposition.warning] : []);
 }
-/** Коды провала рана `create_actor`: у каждого — ноль кредитов. Колонка `error` — `код: текст`. */
+/** `create_actor` run failure codes, each charging zero credits. The `error` column reads `code: text`. */
 export const CREATE_ACTOR_RUN_ERRORS = {
     actor_portrait_unusable: "the generated portrait did not show exactly one face; no actor was created and nothing was charged",
     actor_prompt_refused: "the description names or resembles a real person, or moderation refused the portrait; describe a fictional adult. " +
@@ -200,20 +200,20 @@ export const CREATE_ACTOR_RUN_ERROR_CODES = Object.keys(CREATE_ACTOR_RUN_ERRORS)
 export function createActorRunError(code) {
     return `${code}: ${CREATE_ACTOR_RUN_ERRORS[code]}`;
 }
-/** Формат `runs.error` для кода с уточнением: код до двоеточия читают алерты. */
+/** The `runs.error` format for a code with a detail: alerts read the code up to the colon. */
 export function createActorRunErrorWith(code, detail) {
     return `${createActorRunError(code)} (${detail})`;
 }
 export const ACTOR_VARIANT_ASPECTS = ASPECT_RATIOS.filter((aspect) => aspect !== ACTOR_PORTRAIT_ASPECT);
-/** Вариант, не созданный по нашей причине: успешный ран несёт эту строку в `warnings`. */
+/** A variant not created for a reason of ours: the successful run carries this line in `warnings`. */
 export function actorVariantWarning(aspect, reason) {
     return `${aspect} was not created: ${reason}; it was not charged`;
 }
-/** Сорванная проверка лица на этапе вариантов: ран УСПЕШЕН, кода провала нет. */
-/** Одно определение на писателя (таск) и счётчик (алерт 10), сравнение — целой строкой. */
+/** A face check that failed at the variant stage: the run SUCCEEDS, with no failure code. One */
+/** definition for the writer (task) and the counter (alert), compared as whole lines. */
 export const ACTOR_VARIANT_FACE_CHECK_REASON = "the face check was unavailable";
 export const ACTOR_VARIANT_FACE_CHECK_WARNINGS = ACTOR_VARIANT_ASPECTS.map((aspect) => actorVariantWarning(aspect, ACTOR_VARIANT_FACE_CHECK_REASON));
-/** Что делает `create_actor` — один текст для публичного каталога скиллов и клиентов. */
+/** What `create_actor` does: one text for the public skill catalog and clients. */
 export const CREATE_ACTOR_DESCRIPTION = "Create a personal actor for this account from words describing a fictional adult: a 9:16 portrait with exactly " +
     "one face, plus the other requested formats edited from it. Returns a run_id immediately; poll get_run until " +
     "'succeeded' (created_actor.actor_id, then pass it as actor_id to make_ugc) or 'failed'. Each published image is " +