@clipwright/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dimantika LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @clipwright/mcp-server
+
+MCP server for [Clipwright](https://clipwright.io): generate UGC videos from
+your coding agent. A talking-head clip is rendered from a script you pass in;
+the agent gets a `run_id` and polls until a video URL is ready.
+
+## Install
+
+```bash
+claude mcp add clipwright \
+  -e CLIPWRIGHT_API_KEY="cw_your_token" \
+  -e CLIPWRIGHT_CLIENT_ID="$(uuidgen | tr -d '-')" \
+  -- npx -y @clipwright/mcp-server
+```
+
+Any MCP host works — the server speaks JSON-RPC over stdio.
+
+## Environment
+
+| Variable | Required | Meaning |
+|---|---|---|
+| `CLIPWRIGHT_API_KEY` | yes | Your `cw_*` token. The process exits immediately without it. |
+| `CLIPWRIGHT_CLIENT_ID` | yes | Identifies this **installation**. It is mixed into the idempotency key, so two installations never collapse into one run. Falls back to `~/.clipwright/client-id`, and fails loudly rather than inventing a throwaway value. |
+| `CLIPWRIGHT_API_URL` | no | Defaults to the hosted API. |
+
+## Tools
+
+- `list_voices` — voice catalog. Free, spends no credits.
+- `quote_ugc` — estimated duration and price. Free.
+- `make_ugc` — **renders a clip; this is the call that costs money.** Returns a
+  `run_id` immediately instead of blocking, because a render takes minutes.
+- `get_run` — status of a run. Free; poll it every few seconds.
+
+Call `quote_ugc` before `make_ugc`: the quote is where the contract tells you
+what it will and will not honor. Anything the API cannot deliver comes back in
+`warnings[]` rather than being dropped silently, and unsupported fields are
+rejected up front instead of being accepted and ignored.
+
+Bumping the `attempt` field starts a **new paid render**. It is the way to retry
+a failed run on purpose, not a free refresh.
+
+`SKILL.md` ships inside the package with the full operating instructions.

package/SKILL.md

@@ -0,0 +1,540 @@
+# SKILL.md — установка и эксплуатация `clipwright-mcp`
+
+Самодостаточная инструкция для АГЕНТА (или человека в Claude Code) без устной
+помощи от разработчика. Следуй шагам по порядку. Не путать с
+`apps/web/.claude/skills/*` — это скиллы дашборда Next.js, к MCP-серверу
+отношения не имеют.
+
+Пакет `@clipwright/mcp-server` (`bin: clipwright-mcp`) опубликован в npm под
+лицензией MIT, поэтому репозиторий для установки НЕ НУЖЕН — хватит `npx`.
+Сборка из исходников осталась ниже как путь для разработки.
+
+Три пакета клиентской поверхности — `@clipwright/core`, `@clipwright/sdk`,
+`@clipwright/mcp-server` — открыты по MIT; сам сервис (REST API, рендер-пайплайн,
+дашборд) закрыт. Это намеренное разделение, а не недосмотр: см. `LICENSE` в
+корне репозитория.
+
+## 1. Установка
+
+### 1.1 Из npm — обычный путь
+
+```bash
+npx -y -p @clipwright/mcp-server@latest clipwright-mcp
+```
+
+Ожидаемо: процесс НЕ завершается, в stderr печатается
+`clipwright mcp server running on stdio` и висит, ожидая JSON-RPC. Это и есть
+признак исправного сервера, а не зависание. Останови `Ctrl+C`.
+
+Немедленный выход с `CLIPWRIGHT_API_KEY env var is required` — тоже ожидаемое
+поведение при пустом ключе (`src/index.ts:11-15`), а не поломка сборки.
+
+Дальше сразу к разделу 1.3: конфиг хоста для этого варианта отличается только
+командой (`npx` вместо `node` с абсолютным путём), оба показаны там.
+
+### 1.2 Из исходников — только для разработки
+
+Требования: Node ≥24, pnpm (`packageManager: pnpm@11.13.1` в корневом
+`package.json` — при наличии corepack: `corepack enable`).
+
+```bash
+git clone <repo-url> ugc-video-platform   # или используй уже готовый чекаут
+cd ugc-video-platform
+pnpm install
+pnpm build          # pnpm -r build — собирает ВСЕ пакеты монорепо в топологическом порядке
+```
+
+Если нужна только эта поверхность (быстрее, но зависимости `@clipwright/core`
+и `@clipwright/sdk` обязаны быть собраны первыми — `...` тянет их
+автоматически):
+
+```bash
+pnpm --filter @clipwright/mcp-server... build
+```
+
+После сборки должен существовать файл `packages/mcp-server/dist/index.js`.
+Проверь:
+
+```bash
+ls packages/mcp-server/dist/index.js
+```
+
+#### Предполётная проверка собранного бинаря
+
+Относится к сборке из исходников. Прежде чем подключать сервер к хосту,
+убедись, что он вообще стартует и не падает на импортах:
+
+```bash
+CLIPWRIGHT_API_KEY=cw_test node packages/mcp-server/dist/index.js
+```
+
+Ожидаемо: процесс НЕ завершается сам, в stderr печатается
+`clipwright mcp server running on stdio` и висит на stdio (ждёт JSON-RPC).
+Останови `Ctrl+C`. Если вместо этого немедленный выход с
+`CLIPWRIGHT_API_KEY env var is required` — значит переменная не была передана
+(это ожидаемое поведение при пустом ключе, см. `src/index.ts:11-15`), не баг.
+Если падает на импорте модуля — сборка неполная, вернись к шагу 1.2
+(`pnpm build` из корня, не адресный `--filter`, чтобы точно пересобрать
+`@clipwright/core`/`@clipwright/sdk`).
+
+### 1.3 Подключение к MCP-хосту
+
+Варианты A и B ниже запускают сервер ИЗ ИСХОДНИКОВ и потому требуют
+АБСОЛЮТНЫЙ путь до `dist/index.js`:
+
+```bash
+realpath packages/mcp-server/dist/index.js
+```
+
+Если ставил из npm (раздел 1.1), путь не нужен — бери вариант В в конце
+раздела, он отличается только полями `command`/`args`.
+
+**Вариант A — `.mcp.json` (проектный конфиг хоста, стиль как в
+`apps/web/.mcp.json` этого репо):**
+
+```json
+{
+  "mcpServers": {
+    "clipwright": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/абсолютный/путь/до/ugc-video-platform/packages/mcp-server/dist/index.js"],
+      "env": {
+        "CLIPWRIGHT_API_KEY": "cw_...",
+        "CLIPWRIGHT_API_URL": "https://api-production-7e69.up.railway.app",
+        "CLIPWRIGHT_CLIENT_ID": "<см. раздел 2 — сгенерировать ДО первого запуска>"
+      }
+    }
+  }
+}
+```
+
+**Вариант B — CLI `claude mcp add`** (эквивалент варианта A одной командой):
+
+```bash
+claude mcp add clipwright \
+  -e CLIPWRIGHT_API_KEY=cw_... \
+  -e CLIPWRIGHT_API_URL=https://api-production-7e69.up.railway.app \
+  -e CLIPWRIGHT_CLIENT_ID="$(uuidgen | tr -d '-')" \
+  -- node /абсолютный/путь/до/ugc-video-platform/packages/mcp-server/dist/index.js
+```
+
+**Вариант В — из npm, без репозитория.** То же самое, но команда — `npx`:
+
+```json
+{
+  "mcpServers": {
+    "clipwright": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "-p", "@clipwright/mcp-server@latest", "clipwright-mcp"],
+      "env": {
+        "CLIPWRIGHT_API_KEY": "cw_...",
+        "CLIPWRIGHT_API_URL": "https://api-production-7e69.up.railway.app",
+        "CLIPWRIGHT_CLIENT_ID": "<см. раздел 2 — сгенерировать ДО первого запуска>"
+      }
+    }
+  }
+}
+```
+
+Одной командой:
+
+```bash
+claude mcp add clipwright \
+  -e CLIPWRIGHT_API_KEY=cw_... \
+  -e CLIPWRIGHT_API_URL=https://api-production-7e69.up.railway.app \
+  -e CLIPWRIGHT_CLIENT_ID="$(uuidgen | tr -d '-')" \
+  -- npx -y -p @clipwright/mcp-server@latest clipwright-mcp
+```
+
+**`@latest` здесь — осознанный выбор, а не небрежность.** Он тянет свежую
+версию при каждом запуске: для прототипа это правильно, потому что контракт
+ещё меняется и рассинхрон клиента с сервером дороже, чем неожиданное
+обновление. Когда контракт устоится, версию надо будет прибить.
+
+Переменные окружения:
+
+| Переменная | Обязательна | Значение |
+|---|---|---|
+| `CLIPWRIGHT_API_KEY` | ДА | Bearer-токен формата `cw_*`. Без него процесс завершается сразу с ошибкой (`src/index.ts:11-15`). Токен ВЫДАН ЛИЧНО ТЕБЕ (US-550): он лежит в таблице `api_tokens`, привязан к аккаунту и отзывается отдельно от чужих. Не пересылай его дальше — второму человеку выпускается свой. Разным аккаунтам не видны раны друг друга, и суточный потолок трат у каждого свой. |
+| `CLIPWRIGHT_API_URL` | НЕТ | Прод-URL. Если не задать — SDK сам подставляет `https://api-production-7e69.up.railway.app` (дефолт в `packages/sdk/src/index.ts:18`). Указывай явно только если целишься в другое окружение. |
+| `CLIPWRIGHT_CLIENT_ID` | ДА (см. раздел 2) | Уникальный идентификатор УСТАНОВКИ. |
+
+После подключения перезапусти/переоткрой MCP-хост и убедись, что `tools/list`
+отдаёт четыре тула: `make_ugc`, `get_run`, `quote_ugc`, `list_voices`.
+
+## 2. `CLIPWRIGHT_CLIENT_ID` — обязательно и ПОЧЕМУ
+
+**Правило: КАЖДАЯ установка обязана получить СВОЙ уникальный
+`CLIPWRIGHT_CLIENT_ID` ДО первого вызова `make_ugc`.** Не копировать значение
+с другой машины, не оставлять пустым в расчёте на дефолт "как-нибудь
+сработает".
+
+### Почему это не опционально
+
+Ключ идемпотентности, которым SDK помечает каждый платный `POST
+/v1/skills/make_ugc/run`, детерминированно вычисляется из **хеша входа
+(`script`/`person`/`image`/… после canonicalize) И идентичности клиента**
+(`idempotencyKeyFor`, `packages/core/src/idempotency.ts`; используется в
+`packages/sdk/src/index.ts:104-115`). Сервер дедуплицирует по этому ключу:
+`apps/api/src/app.ts:103` — если для уже сохранённого ключа
+`existing.request_hash === hash`, он возвращает 200 с раном, который
+**создал первый запрос с этим ключом**, а не запускает новый платный рендер.
+
+Это правильное поведение для ретрая ОДНОГО И ТОГО ЖЕ пользователя (не платить
+дважды за случайный дубль-клик агента). Но:
+
+- поиск по ключу идемпотентности идёт по ключу, а не по аккаунту
+  (`runs_idempotency_key_unique` — частичный индекс по одной колонке);
+- поэтому **разделение аккаунтов токеном (US-550) само по себе НЕ разводит
+  одинаковые входы**: `clientId`, примешанный в хеш ключа, остаётся тем, что
+  делает ключи разными;
+- и он же нужен внутри одного аккаунта: ноутбук и CI одного человека обязаны
+  ретраить независимо.
+
+Если второй пользователь не выставил СВОЙ `CLIPWRIGHT_CLIENT_ID` и его запрос
+(тот же скрипт, те же опции — например, оба используют пример из этого
+SKILL.md дословно) совпадает по входу с чужим уже выполненным раном, сервер
+схлопнёт их в ОДИН ран. Второй пользователь получит 200, `run_id` и играющуюся
+ссылку — но это будет ЧУЖОЕ видео, представленное ему как его собственный
+успех. Это дефект 3.2 плана Этапа 5: диагностический инструмент/установка
+прочитались бы как «работает», хотя платный рендер для второго пользователя
+никогда не запускался.
+
+### Как выставить
+
+Явный `CLIPWRIGHT_CLIENT_ID` в env хоста (раздел 1.3, вариант A/B) — самый
+надёжный путь, не зависящий от состояния файловой системы. Значение — любая
+уникальная строка; для согласованности с генератором SDK используй тот же
+формат (UUID без дефисов):
+
+```bash
+uuidgen | tr -d '-'
+```
+
+Если переменная НЕ задана, `resolveClientId()`
+(`packages/sdk/src/client-id.ts`) падает на файл `~/.clipwright/client-id`:
+при первом запуске генерирует случайный id и сохраняет его туда, дальше читает
+оттуда. Это рабочий фолбэк для одиночной установки на чистой машине, но НЕ
+полагайся на него как на единственную защиту при установке агентом: домашние
+каталоги при клонировании образов/контейнеров/дев-окружений могут унести файл
+`~/.clipwright/client-id` с собой и породить коллизию, которую этот фолбэк
+не заметит. Для установки по этой инструкции — **всегда выставляй
+`CLIPWRIGHT_CLIENT_ID` явно в env хоста**, не полагайся на автогенерацию.
+
+Если ни env, ни запись файла невозможны (read-only `$HOME`), `resolveClientId()`
+намеренно БРОСАЕТ исключение вместо тихого эфемерного id на каждый запуск —
+молчаливый фолбэк убил бы дедупликацию целиком (`packages/sdk/src/client-id.ts:9-19`).
+Если сервер упал с этой ошибкой — это сигнал поставить `CLIPWRIGHT_CLIENT_ID`
+явно, а не искать баг.
+
+## 3. ПОРЯДОК ВЫЗОВОВ — сначала `quote_ugc`, потом `make_ugc`
+
+Это не совет по вежливости, а механизм, без которого контракт молчит о своих
+решениях.
+
+```
+quote_ugc  →  прочитать source / resolved_aspect_ratio / warnings  →  make_ugc  →  get_run (поллинг)
+```
+
+**Что даёт `quote_ugc`, чего не даёт ничего другого.** Он бесплатен, ничего не
+резервирует и отвечает на вопросы, которые иначе выяснятся уже после списания:
+
+| Поле ответа | Что из него видно |
+|---|---|
+| `credits_estimate` | цена — покажи её пользователю ДО генерации |
+| `source` | размеры источника кадра: пробленный `image` либо дефолтный актёр (432×768) |
+| `resolved_aspect_ratio` | формат, который РЕАЛЬНО будет отрендерен на этом входе |
+| `warnings[]` | какие переданные параметры не будут соблюдены |
+| `contract_version` | под какой версией контракта получена эта цена |
+
+**Вердикт `quote_ugc` и вердикт `make_ugc` совпадают по построению** — обе
+поверхности зовут одну функцию. Если quote вернул 400, ран вернёт тот же 400;
+если quote показал `resolved_aspect_ratio: "9:16"` на запрошенном `1:1`, то
+именно 9:16 и отрендерится.
+
+**Отклонённые поля — не пытайся их передавать.** Они не объявлены в схеме тула,
+и сервер отвечает 400 `rejected_field` ещё до создания рана:
+
+| Поле | Чем заменить |
+|---|---|
+| `character` | `person` — описание актёра словами, или ничего (дефолтный актёр) |
+| `webhook_url` | поллинг `get_run` — вебхуки не доставляются вообще |
+| `segments`, `broll_url` | одним `script`; сегментные ролики ещё не доступны |
+| `disclosure_overlay` | ничем: маркировка уже есть в ответе рана и в самом файле |
+| `image` при выключенном килсвитче | опустить — рендер пойдёт на дефолтном актёре |
+
+**Формат может быть отклонён.** Запрос `aspect_ratio: "1:1"` без `image`
+вернёт отказ: дефолтный актёр вертикальный (432×768), и квадратный кадр из
+него получился бы только центр-кропом вендора, чего мы не делаем молча. Чтобы
+получить `1:1`, передай `image` с квадратным публичным https-источником.
+
+## 4. Четыре тула
+
+Схемы — единый источник правды `@clipwright/core`
+(`packages/core/src/skills.ts`, барррель `packages/core/src/index.ts`), MCP их
+не переписывает руками (`packages/mcp-server/src/index.ts:6-8`).
+
+### `quote_ugc` — бесплатно
+
+Вход — `offeredUgcInputShape` (`packages/mcp-server/src/server.ts`), то есть
+контракт МИНУС отклонённые поля: их там просто нет, и перечислять их здесь
+значило бы предлагать то, за что сервер накажет (раздел 3).
+
+`script` (≤10000 симв., счёт слов ≤`MAX_SCRIPT_WORDS` ≈45 с речи; формально
+`.optional()`, но обязателен, пока `segments` отклонён), опционально `person`
+ИЛИ `image` (публичный `https`-URL), плюс `name`, `captions` (по умолчанию
+`false` — **субтитры opt-in, СНАЧАЛА спроси пользователя**), `caption_style`
+(`hormozi`/`tiktok`/`minimal`), `look` (`natural`/`commercial`/`raw_iphone`),
+`aspect_ratio` (`9:16`/`1:1`, БЕЗ дефолта — молчание и явный выбор различаются),
+`resolution` (`720p`/`1080p`/`4k`), `voice`/`voice_id`.
+
+Точный список всегда доступен из самой схемы тула: `tools/list` порождается из
+того же shape, и поля, которые не соблюдаются, несут `NOT HONORED YET` прямо в
+своём `description`.
+
+Не тратит кредиты. Ответ — необработанный `quote` целиком
+(`packages/mcp-server/src/server.ts`):
+
+```json
+{
+  "skill": "make_ugc",
+  "credits_estimate": 360,
+  "duration_estimate_sec": 12,
+  "warnings": []
+}
+```
+
+`warnings[]` здесь ПРИСУТСТВУЕТ (передаётся без фильтрации) — читай его:
+несоблюдённые параметры (например, `captions` проигнорирован в этой сборке)
+объявляются сюда, а не молча теряются.
+
+**Всегда вызывай `quote_ugc` первым и покажи пользователю цену до `make_ugc`**
+(императив в описании тула, `packages/mcp-server/src/index.ts:83-85`).
+
+### `make_ugc` — платный, создаёт ран
+
+Вход — тот же `makeUgcInputShape` + `attempt` (целое ≥1, опционален; см.
+раздел 4). Денежный контур: это ОДИН платный рендер за вызов (если не сработал
+дедуп идемпотентности — раздел 4). **Тул НЕ ждёт готовности видео** — он
+стартует ран и немедленно возвращает `run_id`
+(`packages/mcp-server/src/index.ts:28-29,39-40`):
+
+```json
+{
+  "status": "IN_PROGRESS",
+  "run_id": "run_...",
+  "state": "queued",
+  "video_url": null,
+  "next_action": "Video is NOT ready. Call get_run with run_id=run_... in ~5 seconds. Repeat until state is 'succeeded' or 'failed'. Do NOT tell the user the video is done until you have a video_url."
+}
+```
+
+Дальше ОБЯЗАТЕЛЬНО поллить `get_run` этим `run_id` каждые ~5–10 секунд до
+терминала. Не сообщай пользователю, что видео готово, пока не получил
+`video_url`.
+
+#### Выбор голоса (`voice` / `voice_id`)
+
+Два взаимоисключающих опциональных поля во входе `make_ugc`:
+
+- `voice` — имя **курируемого пресета**. **Рекомендуемый путь.** Список — тул
+  `list_voices` (бесплатный): `owner_ru_clone`, `sarah`, `george`, `eric`,
+  `daria_ru_female`. Валидируется на границе: неизвестное имя → 400 сразу,
+  платный вызов не создаётся.
+- `voice_id` — **сырой ElevenLabs id** (20-символьный), escape hatch для
+  голосов ВНЕ каталога, включая клонированные. Проверяется бесплатно против
+  аккаунта в начале рана (не на `quote`): несуществующий id → ран `failed` ДО
+  единого платного вызова.
+- **Ни одного не задавай без просьбы пользователя.** Голос по умолчанию уже
+  подобран под текущий аватар; менять его не нужно. `list_voices` — курируемый
+  каталог по дизайну, не полный список голосов вендора.
+
+Детали и инвариант «неверный голос не стоит денег» — `docs/16-voice-selection.md`.
+
+### `get_run` — поллинг статуса
+
+Вход: `{ "run_id": "run_..." }`. Форма ответа реализована в
+`packages/mcp-server/src/format.ts` (`formatGetRun`) — ниже она приведена
+ФАКТИЧЕСКИ, после исправления US-501.
+
+**Нетерминальный ран** (`queued`/`scripting`/`tts`/`avatar`/`compositing`/`uploading`)
+несёт `state` стадии, `status` всегда `"IN_PROGRESS"`:
+
+```json
+{
+  "status": "IN_PROGRESS",
+  "run_id": "run_...",
+  "state": "avatar",
+  "video_url": null,
+  "next_action": "Video is NOT ready. Call get_run with run_id=run_... again in ~5 seconds. Repeat until state is 'succeeded' or 'failed'. Do NOT tell the user the video is done until you have a video_url."
+}
+```
+
+**Терминальный успех** несёт И `status: "SUCCEEDED"`, И `state: "succeeded"`
+(до US-501 `state` в терминальной успешной ветке отсутствовал — грабля №4
+`docs/14-gate4-heygen.md:75-79` — теперь это исправлено, поле есть всегда):
+
+```json
+{
+  "status": "SUCCEEDED",
+  "run_id": "run_...",
+  "state": "succeeded",
+  "video_url": "https://...",
+  "duration_seconds": 13.08
+}
+```
+
+**Терминальный отказ** несёт И `status: "FAILED"`, И `state: "failed"`:
+
+```json
+{
+  "status": "FAILED",
+  "run_id": "run_...",
+  "state": "failed",
+  "error": "<текст ошибки>"
+}
+```
+
+**`warnings[]` в `get_run`:** каждая ветка ответа (`IN_PROGRESS`, `SUCCEEDED`,
+`FAILED`) несёт `warnings` рана (US-512; правило проекта №3 — несоблюдённые
+параметры объявляются, никогда молча). Читай его на терминале обязательно:
+например, отсутствие субтитров в прототипе объявляется именно здесь.
+
+**Неизвестный терминальный статус на сервере** (например гипотетический
+`"canceled"`, не входящий в `TERMINAL_STATES`) — осознанная деградация:
+`isTerminal` вернёт `false`, и такой ран попадёт в ветку `IN_PROGRESS` (агенту
+скажут «продолжай поллить» про уже завершённый ран). Это принятое поведение
+прототипа (MCP и API деплоятся одной версией), не баг форматтера.
+
+### `list_voices` — бесплатно, без входа
+
+Отдаёт курируемый каталог пресетов для поля `voice` у `make_ugc`
+(`packages/mcp-server/src/server.ts`, регистрация четвёртым; `inputSchema: {}` —
+аргументов нет). Денег не стоит и рана не создаёт.
+
+Сетевой вызов при этом есть: тула ходит в НАШ `/v1/voices` и требует рабочий
+`CLIPWRIGHT_API_KEY`, как и остальные три. К вендору не ходит никто — список
+статический и живёт в `packages/core/src/voices.ts`, поэтому вендорский ключ на
+этой поверхности не нужен.
+
+Зови его до `make_ugc`, если пользователь просит «другой голос»: имя пресета
+предпочтительнее сырого `voice_id`, потому что пресет переживает смену вендора,
+а идентификатор — нет (раздел про `voice`/`voice_id` выше).
+
+## 5. Повтор упавшего рана — это НЕ перманентный отказ
+
+Если `get_run` вернул терминальный `FAILED` и ты вызываешь `make_ugc` СНОВА с
+ТЕМ ЖЕ входом (тот же `script`/опции) и БЕЗ изменения `attempt` — сервер
+вернёт ТОТ ЖЕ терминальный `failed`-ран как есть (та же ошибка, тот же
+`run_id`), а НЕ запустит новый платный рендер. Это дедупликация по ключу
+идемпотентности (раздел 2), а не признак того, что видео навсегда
+недостижимо.
+
+**Чтобы реально повторить попытку, передай `attempt` со значением на единицу
+больше предыдущего** (по умолчанию первый вызов имеет `attempt=1`; для второй
+попытки — `attempt: 2`, для третьей — `attempt: 3`, и т.д.). Это дословно
+поведение, задокументированное в описании тула `make_ugc`
+(`packages/mcp-server/src/index.ts:29-30`):
+
+> "Pass attempt=2,3,… to deliberately start a NEW run for the same input
+> (retry after a failure)."
+
+Технически `attempt` уходит не в тело рендер-запроса, а в опции SDK
+(`packages/mcp-server/src/index.ts:35-40`) и превращается в суффикс
+`:N` у ключа идемпотентности (`packages/sdk/src/index.ts:104-115`) — другой
+суффикс даёт другой ключ → сервер видит НОВЫЙ запрос → новый `run_id` → новый
+платный вызов вендора.
+
+Не путай это с `CLIPWRIGHT_CLIENT_ID`: `attempt` — сознательное решение агента
+«это новая попытка», а `clientId` — фиксированная идентичность установки, её
+менять между попытками НЕ нужно.
+
+### ⚠️ КАЖДЫЙ БАМП `attempt` СТОИТ ДЕНЕГ
+
+Новый `attempt` — это новый ран и **новый платный вызов вендора**, а не
+бесплатная переотправка. Цикл «упало → бампнул → упало → бампнул» тратит
+реальные кредиты на каждой итерации.
+
+Поэтому:
+
+- **перед повтором прочитай `error` упавшего рана.** Отказы вида
+  `rejected_field`, `aspect_conflict`, `daily_cap_exceeded` повтором НЕ
+  чинятся — они детерминированы входом или потолком, и следующая попытка
+  упадёт так же, только уже за деньги;
+- **бампай `attempt` только при отказе, похожем на временный** (таймаут
+  вендора, 5xx, обрыв сети);
+- **потолок существует и он суточный.** Исчерпав его, ты получишь
+  `daily_cap_exceeded` — это сработавшая защита, а не поломка продукта.
+  Дожидаться следующих суток или просить владельца поднять лимит.
+
+## 6. При отказе — curl-скрипт как разделитель диагнозов
+
+Если MCP-путь не доводит до играющегося видео, запусти
+`scripts/clipwright-smoke.sh` (US-506) — он бьёт по тому же публичному REST
+`POST /v1/skills/make_ugc/run` → `GET /v1/runs/{id}` напрямую curl'ом, в обход
+MCP/SDK/CLI целиком:
+
+```bash
+CLIPWRIGHT_API_TOKEN=cw_... ./scripts/clipwright-smoke.sh "Привет! Тестовая фраза."
+```
+
+(`CLIPWRIGHT_API_TOKEN` — то же значение, что `CLIPWRIGHT_API_KEY` в env MCP,
+см. раздел 1.3; `CLIPWRIGHT_API_URL` опционален, тот же дефолт-прод.)
+
+Диагноз по результату:
+
+- **curl доходит до `succeeded` со своим `run_id` и играющейся ссылкой, а MCP —
+  нет:** первопричина в слое MCP-пакетирования (сборка/конфиг хоста/env,
+  раздел 1) — не в REST API и не в доступе/токене. Это допустимое закрытие с
+  документированным остаточным (курл-гейт Architect, US-511).
+- **curl тоже падает:** проблема не в MCP — проверь `CLIPWRIGHT_API_TOKEN`
+  (формат `cw_*`, не обрезан при копировании), сетевой доступ к
+  `$CLIPWRIGHT_API_URL`, и (для истории про клонированные раны) что
+  `CLIPWRIGHT_CLIENT_ID` реально уникален на этой машине (раздел 2) — если
+  ответ 200 с ЧУЖИМ по смыслу `run_id`, это симптом дефекта 3.2 на MCP-пути,
+  который curl (у него собственный, случайный `Idempotency-Key` на каждый
+  вызов — `scripts/clipwright-smoke.sh:112`) не воспроизведёт напрямую, но
+  который стоит проверить отдельно через `get_run` на этот `run_id`.
+
+Скрипт также поддерживает бесплатный `--poll-only <run_id>` для проверки уже
+существующего рана без нового платного вызова.
+
+## Итоговая последовательность (что должно воспроизвестись)
+
+1. Установить сервер: `npx -y -p @clipwright/mcp-server@latest clipwright-mcp`
+   стартует и печатает `running on stdio` (раздел 1.1). Из исходников —
+   `pnpm install && pnpm build` из корня репо → `dist/index.js` существует.
+2. Сгенерировать уникальный `CLIPWRIGHT_CLIENT_ID` (раздел 2) и прописать его
+   вместе с `CLIPWRIGHT_API_KEY` в конфиг MCP-хоста (раздел 1.3).
+3. Перезапустить хост, убедиться, что `tools/list` отдаёт 4 тула
+   (`make_ugc`, `quote_ugc`, `get_run`, `list_voices`).
+4. `quote_ugc` со скриптом → показать цену И прочитать `source`,
+   `resolved_aspect_ratio`, `warnings[]` (раздел 3).
+5. `make_ugc` → получить `run_id` немедленно.
+6. `get_run` каждые ~5–10 с, читая `state` в процессе и `status`+`state` на
+   терминале, до `SUCCEEDED` (`video_url`) или `FAILED` (`error`).
+7. При отказе — `scripts/clipwright-smoke.sh` (раздел 6) для разделения
+   диагнозов.
+
+### Если ты — второй пользователь, проверяющий продукт
+
+Задача одна: **дойти до играющегося видео по этому файлу, без устной помощи
+владельца.** Проверяется не ты, а полнота инструкции — поэтому не спрашивай,
+а записывай, где застрял.
+
+Перед началом убедись, что в конфиге стоит **твой собственный**
+`CLIPWRIGHT_CLIENT_ID` (раздел 2). Без него сервер вернёт РАН ВЛАДЕЛЬЦА с
+ответом 200 и играющей ссылкой — то есть ложный успех, который выглядит
+убедительнее настоящего.
+
+Отличай два класса отказа, они чинятся по-разному:
+
+- **`rejected_field`, `aspect_conflict`, `daily_cap_exceeded`** — это
+  сработавший контракт или сработавшая защита, а не дефект. Прочитай текст
+  ошибки: в нём назван и повод, и замена;
+- **всё остальное** (таймаут, 5xx, пустой ответ, тул не найден) — кандидат в
+  настоящие дефекты. Здесь запусти `scripts/clipwright-smoke.sh`: если curl
+  доходит до играющейся ссылки, а MCP нет — причина в слое упаковки MCP, и это
+  надо записать отдельно от остального.

package/dist/format.js

@@ -0,0 +1,77 @@
+import { FAILED_STATE, isTerminal } from "@clipwright/core";
+/**
+ * Чистое форматирование ответа `get_run` (вынесено из хендлера, чтобы
+ * тестировать терминальную форму без подъёма stdio-транспорта и env).
+ *
+ * ОБЕ терминальные ветки несут И `status` (SUCCEEDED/FAILED — императив для
+ * агента), И `state` (фактический `run.state` — исправление US-501, контракт
+ * поллинга: терминал теперь виден в самом `state`, не только в `status`).
+ *
+ * Осознанная деградация (минор Critic №3, зафиксировать в docs/15): неизвестный
+ * ТЕРМИНАЛЬНЫЙ статус сервера (напр. `"canceled"`) НЕ входит в `TERMINAL_STATES`
+ * → `isTerminal=false` → проваливается в IN_PROGRESS-ветку (агенту скажут
+ * «продолжай поллить» про завершённый ран). В прототипе это принято осознанно:
+ * MCP и API деплоятся одной версией, а против текущего краша это строгое
+ * улучшение.
+ */
+export function formatGetRun(run) {
+    if (isTerminal(run.state)) {
+        // Терминально: различение исхода — именованной константой core (не
+        // позиционным индексом: переупорядочивание массива молча инвертировало бы
+        // успех/провал).
+        if (run.state === FAILED_STATE) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "FAILED",
+                            run_id: run.run_id,
+                            state: run.state,
+                            // Правило проекта №3: расхождения никогда не молчат — warnings
+                            // пробрасываются в КАЖДУЮ ветку get_run (US-512).
+                            warnings: run.warnings,
+                            error: run.error,
+                        }),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        status: "SUCCEEDED",
+                        run_id: run.run_id,
+                        state: run.state,
+                        video_url: run.final_output?.video_url ?? null,
+                        duration_seconds: run.final_output?.duration_seconds ?? null,
+                        warnings: run.warnings,
+                    }),
+                },
+            ],
+        };
+    }
+    // Нетерминальное (и неизвестное терминальное — см. деградация выше) состояние:
+    // тот же императивный формат, что и у make_ugc.
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    status: "IN_PROGRESS",
+                    run_id: run.run_id,
+                    state: run.state,
+                    video_url: null,
+                    warnings: run.warnings,
+                    next_action: "Video is NOT ready. Call get_run with run_id=" +
+                        run.run_id +
+                        " again in ~5 seconds. Repeat until state is 'succeeded' or 'failed'. Do NOT tell " +
+                        "the user the video is done until you have a video_url.",
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAgB,MAAM,kBAAkB,CAAC;AAY1E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,mEAAmE;QACnE,0EAA0E;QAC1E,iBAAiB;QACjB,IAAI,GAAG,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;YAC/B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,QAAQ;4BAChB,MAAM,EAAE,GAAG,CAAC,MAAM;4BAClB,KAAK,EAAE,GAAG,CAAC,KAAK;4BAChB,+DAA+D;4BAC/D,kDAAkD;4BAClD,QAAQ,EAAE,GAAG,CAAC,QAAQ;4BACtB,KAAK,EAAE,GAAG,CAAC,KAAK;yBACjB,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,MAAM,EAAE,WAAW;wBACnB,MAAM,EAAE,GAAG,CAAC,MAAM;wBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;wBAChB,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE,SAAS,IAAI,IAAI;wBAC9C,gBAAgB,EAAE,GAAG,CAAC,YAAY,EAAE,gBAAgB,IAAI,IAAI;wBAC5D,QAAQ,EAAE,GAAG,CAAC,QAAQ;qBACvB,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC;IACD,+EAA+E;IAC/E,gDAAgD;IAChD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,MAAM,EAAE,aAAa;oBACrB,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,SAAS,EAAE,IAAI;oBACf,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,WAAW,EACT,+CAA+C;wBAC/C,GAAG,CAAC,MAAM;wBACV,mFAAmF;wBACnF,wDAAwD;iBAC3D,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ClipwrightClient } from "@clipwright/sdk";
+import { createServer } from "./server.js";
+const apiKey = process.env.CLIPWRIGHT_API_KEY;
+if (!apiKey) {
+    console.error("CLIPWRIGHT_API_KEY env var is required");
+    process.exit(1);
+}
+const client = new ClipwrightClient({ apiKey, baseUrl: process.env.CLIPWRIGHT_API_URL });
+const server = createServer(client);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("clipwright mcp server running on stdio");
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEzF,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChC,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC"}

package/dist/server.js

@@ -0,0 +1,102 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+// Схемы приходят из barrel `@clipwright/core` (единый источник правды, правило №2),
+// а НЕ из `/idempotency` — там живёт только ключ идемпотентности, не shape.
+// `offeredUgcInputShape`, а НЕ полный `makeUgcInputShape`: поля с диспозицией
+// `rejected` не должны предлагаться вызывателю, которого мы за их использование
+// накажем четырёхсотым (блокер B4). Множество выводится из реестра диспозиций,
+// поэтому смена решения по полю переносит его между поверхностями одной строкой.
+import { offeredUgcInputShape, agentRetryShape } from "@clipwright/core";
+import { formatGetRun } from "./format.js";
+/**
+ * Строит MCP-сервер с зарегистрированными тулами, БЕЗ подключения транспорта.
+ *
+ * Вынесено из index.ts (US-516): index.ts раньше и строил сервер, И сразу
+ * коннектил его к stdio на верхнем уровне модуля — это делало регистрацию
+ * тулов непроверяемой без реального stdio-процесса. Разделение — тот же
+ * паттерн, что app.ts/index.ts в apps/api (app — тестируемый, index —
+ * тонкий bootstrap).
+ */
+export function createServer(client) {
+    const server = new McpServer({ name: "clipwright", version: "0.1.0" });
+    // Полная схема публикуется в tools/list (у конкурента она пустая — антипаттерн).
+    server.registerTool("make_ugc", {
+        description: "Start generation of a lip-synced UGC video. Give a script (any length); optionally describe " +
+            "the actor in words with person. Fields the renderer does not honor yet carry a NOT HONORED YET " +
+            "note in their own description — read it instead of guessing. " +
+            "Captions are OPT-IN: ASK the user first. 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).",
+        // [Правило №2] Плоская схема = предлагаемый вход рендера + агентный ретрай,
+        // собранная из shape core. Проза описания держится в согласии со схемой
+        // намеренно: LLM-вызыватель читает описание РАНЬШЕ схемы, поэтому обещание
+        // в тексте («1080p 9:16», «character») было бы тем же дефектом
+        // «предлагаем и наказываем», просто слоем выше.
+        inputSchema: { ...offeredUgcInputShape, ...agentRetryShape },
+    }, async (args) => {
+        // [ARB-1] РАСЩЕПЛЯЕМ плоский вход: `attempt` живёт в opts SDK. Если передать
+        // его внутрь `input`, `makeUgcInput.parse` в `idempotencyKeyFor` молча срежет
+        // лишний ключ → суффикс всегда `:1` → повтор вернёт тот же run → M1 мёртв.
+        const { attempt, ...input } = args;
+        // [A5] Возврат СРАЗУ после старта (state≈"queued"), без bounded-wait и без цикла.
+        const run = await client.startUgc(input, { attempt });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        status: "IN_PROGRESS",
+                        run_id: run.run_id,
+                        state: run.state,
+                        video_url: null,
+                        next_action: "Video is NOT ready. Call get_run with run_id=" +
+                            run.run_id +
+                            " in ~5 seconds. Repeat until state is 'succeeded' or 'failed'. Do NOT tell the " +
+                            "user the video is done until you have a video_url.",
+                    }),
+                },
+            ],
+            isError: false,
+        };
+    });
+    server.registerTool("get_run", {
+        description: "Check the status of a video generation started by make_ugc. Pass the run_id. While the run " +
+            "is still working it returns status IN_PROGRESS with a next_action telling you to poll again; " +
+            "repeat every ~5 seconds until it reaches a terminal state — SUCCEEDED (with video_url) or FAILED.",
+        inputSchema: { run_id: z.string() },
+    }, async ({ run_id }) => {
+        // Терминальная форма + деградация вынесены в чистый `formatGetRun` (тест
+        // без stdio-транспорта). Терминал несёт И `status`, И `state` (US-501).
+        const run = await client.getRun(run_id);
+        return formatGetRun(run);
+    });
+    server.registerTool("quote_ugc", {
+        description: "Estimate the credit cost of a make_ugc call WITHOUT spending credits. " +
+            "Always call this first and show the user the price before make_ugc.",
+        // [Правило №2] Тот же shape core, что и у make_ugc: `script` — единственное
+        // обязательное поле (остальные .optional()/.default()), поэтому переиспользуем
+        // shape целиком вместо рукописного {script} — цена учитывает captions/look и не расходится со схемой.
+        inputSchema: offeredUgcInputShape,
+    }, async (args) => {
+        const quote = await client.quoteUgc(args);
+        return { content: [{ type: "text", text: JSON.stringify(quote) }] };
+    });
+    server.registerTool("list_voices", {
+        description: "List the curated voice catalog available for make_ugc's `voice` field. Presets are the " +
+            "RECOMMENDED path: pick one by name (e.g. voice=\"george\"). `voice_id` is an escape hatch for " +
+            "voices OUTSIDE this catalog, including cloned voices — pass a raw vendor voice id there instead " +
+            "of `voice`. The current avatar already has a matched default voice; do NOT change it unless the " +
+            "user explicitly asks for a different one. This catalog is CURATED BY DESIGN, not the vendor's " +
+            "full voice list: the paid vendor's full catalog is intentionally not proxied here, so its API " +
+            "key does not need to leave the worker process.",
+        inputSchema: {},
+    }, async () => {
+        // Каталог статический (US-513 core), тула лишь ретранслирует /v1/voices —
+        // без сети к вендору, без ключа вендора на этой поверхности (§5).
+        const voices = await client.listVoices();
+        return { content: [{ type: "text", text: JSON.stringify({ voices }) }] };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@clipwright/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Clipwright: generate UGC videos from your coding agent",
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "ugc",
+    "video"
+  ],
+  "license": "MIT",
+  "author": "Dimantika LLC",
+  "homepage": "https://clipwright.io",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "SKILL.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "clipwright-mcp": "dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3",
+    "@clipwright/core": "0.1.0",
+    "@clipwright/sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
+    "dev": "tsx src/index.ts"
+  }
+}