@besales/mcp 1.0.0-beta.7 → 1.0.0-beta.9

package/docs/async-operation-lifecycle.md

@@ -2,8 +2,9 @@
 
 Фоновая операция MCP считается полной только тогда, когда у её стартового инструмента есть
 read-only status-инструмент. Стартовый ответ не является доказательством завершения. При сетевом
-обрыве нельзя повторять start вслепую: сначала вызывается status, указанный в
-`verifyWithToolName` или выведенный из имени.
+обрыве сначала вызывается доступное чтение исхода по исходному ключу. Если для status нужен
+ещё не полученный идентификатор, запуск с `request_key` повторяется с тем же ключом и тем же
+намерением: вернётся та же операция. Запуск без ключа вслепую повторять нельзя.
 
 ## Канон операций
 
@@ -41,6 +42,16 @@ read-only status-инструмент. Стартовый ответ не явл
 `besales_improvement_aggregate_start`) status читает исход по исходному ключу. Исход `UNKNOWN` не
 разрешает новый платный запуск автоматически: сначала выясняется, был ли первый принят.
 
+У `besales_icp_import_dialogues` потерянный ответ сначала проверяется через
+`besales_icp_import_start_result` с теми же `icp_id` и `request_key`. Если исход неизвестен
+(`NOT_FOUND_UNKNOWN`), повторяется исходное намерение с тем же ключом.
+
+У `besales_sandbox_run_start` чтение исхода по ключу пока не опубликовано в MCP.
+При таймауте или 5xx повторите вызов с тем же `request_key` и тем же намерением: вернётся
+тот же прогон. Только после получения `run_id` проверяйте `besales_sandbox_run_get`.
+Новый осознанный прогон запускайте без `request_key` либо с новым UUID: прежний ключ вернёт
+старый прогон, а при смене намерения — `START_KEY_CONFLICT`.
+
 ## Синхронные похожие имена
 
 `besales_prompt_patch_start` синхронно создаёт draft; его дальнейший жизненный цикл —

package/docs/failure-semantics.md

@@ -47,12 +47,22 @@
 «операция → проверка» отстала бы от первого же нового асинхронного инструмента, и он остался
 бы без указания ровно там, где цена ошибки максимальна.
 
-Пару, которую вывести нельзя (`besales_icp_import_dialogues` → `besales_icp_import_status`,
+Пару, которую вывести нельзя (`besales_icp_import_dialogues` → `besales_icp_import_start_result`,
 `besales_model_comparison_run_start` → `besales_model_comparison_get`, …), объявляет поле
 `verifyWithToolName` у определения; объявленное перекрывает выведенное. Тесты держат два
 инварианта: объявленное имя существует, и инструмент проверки сам ничего не меняет — иначе
 совет «сверьтесь» вносил бы новую побочку поверх неизвестного исхода.
 
+Для запусков с `request_key` HTTP-ошибки возвращают отправленный ключ из разобранного входа
+в тексте и в `error.requestIdentity.request_key`, в том числе UUID, сгенерированный мостом для
+песочницы. Аварийные квитанции при превышении размера, сбое сериализации или постобработки
+сохраняют `request_key` рядом с идентификаторами результата.
+При `OUTCOME_UNKNOWN` инструкция разрешает повторить то же намерение с тем же ключом:
+вернётся та же операция; новый ключ означает новую платную операцию. Для ICP сначала вызывается
+`besales_icp_import_start_result`; если исход неизвестен, допускается повтор с прежним ключом.
+У песочницы без `run_id` повтор с тем же ключом восстанавливает прогон, затем доступен
+`besales_sandbox_run_get`. Исход неизвестен до ответа API, автоматического повтора нет.
+
 Если проверки нет ни выведенной, ни объявленной, текст всё равно не советует повтор: он просит
 свериться состоянием на стороне Besales.
 

package/docs/secret-read-boundary.md

@@ -72,6 +72,13 @@ Unicode-нормализация не превращает невалидное
 
 ## Полная опись
 
+Параметр `stored_file_id` существующего `besales_platform_telegram_personal_profile_bulk`
+учтён отдельно в `secret-read-inventory-additions.json#parameterSurfaces`. Читатель остаётся
+`telegram-personal-profile.ts` (домен `channels-setup`): он возвращает квитанцию задания,
+не байты файла, URL S3 или секреты Telegram. ID файла — метаданные библиотеки; доступ
+повторно проверяет ядро. `photo-only registry response` проверяет настоящий реестр с одним
+фото и секретоносным ответом в обоих режимах конверта. Полный снимок API не переписывается.
+
 Канон — `besales-api/test/bridge-secret-read-inventory.json`, перенесённый в снимок
 верификатором. В нём поимённо перечислены все инструменты `mcp-tools.json`, включая
 setup/init/status/rotation, 1С, CRM, внешние API и их ключи, каналы, переменные,

package/docs/telegram-personal-management.md

@@ -4,15 +4,15 @@
 только к ядру Besales; пароли, сессии и ключи Telegram не принимаются и не возвращаются.
 Идентификаторы канала и номера берутся из навигации и таблицы номеров.
 
-| Инструмент `besales_platform_telegram_personal_…` | Назначение | Право |
-| --- | --- | --- |
-| `accounts` | Таблица номеров, сводка и листание | `read:channels` |
-| `warmup` | Настройки и аналитика прогрева | `read:channels` |
-| `warmup_update` | Частичная правка настроек прогрева | `manage:channels` |
-| `account_warmup` | Включение и ручной отказ отдельного номера | `manage:channels` |
-| `ramp` | Чтение `newAccountRampEnabled` | `read:channels` |
-| `profile_bulk` | Пачечная правка профилей своих номеров: имя, описание, дата рождения, ники | `manage:channels` |
-| `profile_job` | Итог задания правки профилей по номерам | `read:channels` |
+| Инструмент `besales_platform_telegram_personal_…` | Назначение                                                                       | Право             |
+| ------------------------------------------------- | -------------------------------------------------------------------------------- | ----------------- |
+| `accounts`                                        | Таблица номеров, сводка и листание                                               | `read:channels`   |
+| `warmup`                                          | Настройки и аналитика прогрева                                                   | `read:channels`   |
+| `warmup_update`                                   | Частичная правка настроек прогрева                                               | `manage:channels` |
+| `account_warmup`                                  | Включение и ручной отказ отдельного номера                                       | `manage:channels` |
+| `ramp`                                            | Чтение `newAccountRampEnabled`                                                   | `read:channels`   |
+| `profile_bulk`                                    | Пачечная правка профилей своих номеров: фото, имя, описание, дата рождения, ники | `manage:channels` |
+| `profile_job`                                     | Итог задания правки профилей по номерам                                          | `read:channels`   |
 
 У инструментов канала обязателен `channel_id`; у `account_warmup` также `account_id`
 и булев `is_warming_up`. `workspace_id` можно не передавать при выбранной рабочей области.
@@ -54,18 +54,59 @@ Telegram неизвестен, сначала сверь профиль номе
 
 Поля `profile_bulk` в snake_case, в HTTP уходят camelCase-поля `TelegramPersonalBulkProfileDto`:
 
-| Вход | В теле ядра | Правило |
-| --- | --- | --- |
-| `account_ids` или `all:true` | `accountIds` или `all` | ровно одно; `account_ids` — 1–100 уникальных UUID v4 |
-| `first_name`, `last_name` | `patch.firstName`, `patch.lastName` | до 64 знаков, без нормализации |
-| `bio` | `patch.bio` | до 140 знаков; лимит Telegram по Premium проверяет ферма |
-| `birthday` | `patch.birthday` | `{day, month, year?}`; `null` снимает дату |
-| `usernames` | `usernames[{accountId, username}]` | ники по номерам; `account_ids` и `all` не передаются |
-| `username_base` | `usernameBase` | основа ника для номеров из `account_ids` или `all` |
-| `idempotency_key` | заголовок `x-idempotency-key` | обязателен: 1–200 видимых ASCII-знаков без пробелов |
-
-Фото через MCP пока не меняется — только в приложении: поле `avatar_file_id` не принимается и
-отвергается до HTTP как лишнее.
+| Вход                         | В теле ядра                         | Правило                                                                                    |
+| ---------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------ |
+| `account_ids` или `all:true` | `accountIds` или `all`              | ровно одно; `account_ids` — 1–100 уникальных UUID v4                                       |
+| `first_name`, `last_name`    | `patch.firstName`, `patch.lastName` | до 64 знаков, без нормализации                                                             |
+| `bio`                        | `patch.bio`                         | до 140 знаков; лимит Telegram по Premium проверяет ферма                                   |
+| `birthday`                   | `patch.birthday`                    | `{day, month, year?}`; `null` снимает дату                                                 |
+| `stored_file_id`             | `patch.avatar`                      | одно фото библиотеки для всех выбранных номеров, UUID v4; статичный JPEG/PNG/WebP до 5 МиБ |
+| `usernames`                  | `usernames[{accountId, username}]`  | ники по номерам; `account_ids` и `all` не передаются                                       |
+| `username_base`              | `usernameBase`                      | основа ника для номеров из `account_ids` или `all`                                         |
+| `idempotency_key`            | заголовок `x-idempotency-key`       | обязателен: 1–200 видимых ASCII-знаков без пробелов                                        |
+
+`stored_file_id` необязателен: прежняя форма вызова сохранена. Пропуск сохраняет фото;
+`null`, URL и псевдонимы `avatar`/`avatar_file_id` отвергаются до HTTP.
+
+### Лицо канала: фото, имя, ник, описание и дата рождения
+
+1. В рабочей области канала вызови
+   `besales_file_upload_request({name:"Фото канала", file_type:"IMAGE", source:"USER_UPLOAD"})`,
+   без `owner_kind`/`owner_id`. Тип укажи явно: по умолчанию загрузчик создаёт DOCUMENT,
+   который не подходит для фото профиля. Человек загружает
+   фото по полученной ссылке; затем читай `besales_file_upload_status` с `upload_ref`
+   до `status:READY` и возьми `stored_file_id`. Файл должен быть доступен в этой области.
+2. Покажи список номеров и новые значения; при смене ников получи ответ «делать?».
+   Вызови `besales_platform_telegram_personal_profile_bulk` одним запросом:
+
+   ```json
+   {
+     "channel_id": "23000000-0000-4000-8000-000000000001",
+     "all": true,
+     "stored_file_id": "26000000-0000-4000-8000-000000000001",
+     "first_name": "Анна",
+     "username_base": "anna_sales",
+     "bio": "Помогаю с заказами",
+     "birthday": { "day": 1, "month": 2 },
+     "idempotency_key": "channel-face-1"
+   }
+   ```
+
+   Для части номеров замени `all:true` на `account_ids:[…]`. Одно фото уйдёт всем
+   целям того же задания. Для точных разных ников используй `usernames` вместо
+   `all`/`account_ids`/`username_base`.
+
+3. По `job_id` читай `besales_platform_telegram_personal_profile_job` до `COMPLETED`;
+   проверь каждый номер и `outcome.fields.avatar`, а также остальные поля.
+   `PENDING` подтверждает только принятие задания.
+
+404 `FILE_NOT_FOUND` — загрузи фото в область канала; 400 `TELEGRAM_AVATAR_INVALID`
+или 413 `TELEGRAM_AVATAR_TOO_LARGE` — выбери корректное статичное фото до 5 МиБ;
+409 `TELEGRAM_AVATAR_CHANGED` — выбери файл заново. Изменённое намерение требует нового
+ключа; сетевой повтор прежнего вызова — тот же ключ и те же аргументы.
+`PROFILE_PROVIDER_OUTCOME_UNKNOWN` требует сверки профиля, а не слепого повтора.
+Файл чужой области закрыт 404 до фермы. Мост передаёт ID, не читает байты или секреты
+Telegram и не возвращает подписанную ссылку S3.
 
 Пропуск поля сохраняет прежнее значение; пустые строки и `null` передаются буквально, а
 ложное или пустое значение выбора (`all:false`, `account_ids:[]`, `usernames:[]`) отвергается до HTTP.
@@ -97,7 +138,10 @@ Telegram неизвестен, сначала сверь профиль номе
 `telegram-personal-profile.spec.ts`. `scripts/telegram-personal-confirmation-mutants.mjs`
 проверяет, что снятие обязательного согласия в Zod или опубликованной схеме ломает именованное
 утверждение теста. `scripts/telegram-personal-profile-mutants.mjs` делает то же для запрета
-двух режимов ников сразу (в Zod и в опубликованной схеме) и для имени заголовка ключа.
+двух режимов ников сразу (в Zod и в опубликованной схеме), имени заголовка ключа
+и передачи фото в patch. Схему и варианты карты выводит
+`node --loader ./src/utils/setup-sessions-loader.mjs scripts/sync-telegram-profile-photo.mjs`;
+опись пересчитывает `scripts/sync-tool-inventory.mjs`. Оба поддерживают `--check`.
 
 ## Прокси личного Telegram
 

package/docs/telegram-session-import.md

@@ -0,0 +1,53 @@
+# Импорт партии номеров Telegram
+
+`besales_platform_telegram_personal_session_import_link` выдаёт человеку ссылку на уже
+существующую защищённую страницу подключения Telegram. Ввод: `channel_id` и необязательный
+`workspace_id` (иначе используется выбранное пространство). Требуется `manage:channels`.
+Профиль `platform`; профиль `readonly` этот инструмент не включает.
+
+Человек входит в приложение, выбирает импорт до 50 файлов и задаёт прокси для каждого файла
+или автоназначение. Содержимое файлов, манифест, ключи приложения и пароли остаются в браузере.
+MCP принимает только идентификаторы; любые дополнительные поля отвергаются до HTTP.
+Ссылка живёт 15 минут. Заказ ссылки сам по себе номера не добавляет.
+
+## Маршрут и ответ
+
+Используется существующий `POST /workspaces/:workspaceId/telegram-personal-setup-sessions`
+с телом `{channelId}`. Новый маршрут ядра и новая страница не создаются.
+Ответ моста перечисляет только `setup_page_url`, `expires_at`, `operation_id: null`,
+`import_status_available: false` и инструкцию следующего шага. Сырой `setup_ref`, состояние
+мастера и неизвестные поля ответа ядра отбрасываются до общей границы сериализации MCP.
+
+Безопасного идентификатора операции импорта этот init пока не возвращает. Пофайловый статус
+`GET /channels/:channelId/telegram-personal/session-imports/:jobId` разрешён только вошедшему
+человеку в браузере. Мост не ослабляет этот запрет и не выдаёт `setup_ref` за идентификатор.
+Результат каждого файла проверяется на странице; `besales_platform_telegram_personal_accounts`
+помогает сверить принятые номера, но не объясняет отклонение каждого файла.
+
+## Список прокси
+
+Уже доступны `besales_platform_telegram_personal_proxy_import_link` / `_status` для канала
+и `besales_platform_telegram_personal_proxy_stock_import_link` / `_status` для общего запаса.
+Они возвращают настоящий `session_id`, ссылку и срок. Статусы содержат только состояние и
+счётчики; причины по строкам остаются на защищённой странице. Пароли и строки SOCKS5
+нельзя присылать инструментам и нельзя копировать из страницы в чат.
+
+## Продолжение
+
+Встроенная справка `besales://workflows/platform-setup-from-scratch`, раздел
+«Подготовить партию номеров Telegram», ведёт по импорту, профилю, фото, Premium и кампании.
+Для фото и Premium отдельных инструментов в текущем пакете нет; эти шаги выполняются
+в интерфейсе приложения. Запуск кампании остаётся отдельным намерением человека.
+
+## Проверки и генерация
+
+`scripts/sync-telegram-session-import.mjs` выводит опубликованную схему и дополнение описи
+чтений из исполняемого определения. Затем `scripts/sync-tool-inventory.mjs` пересчитывает
+инвентарь, а `scripts/sync-route-map.mjs` сверяет маршрут с закреплённым контрактом ядра.
+Каждый поддерживает `--check`; для TypeScript-импортов используется существующий
+`src/utils/setup-sessions-loader.mjs`.
+
+`telegram-session-import.spec.ts` проверяет опубликованную схему, HTTP, запрет секретных
+полей, проекцию ответа в обоих форматах MCP, аннотации и отсутствие автоматического повтора
+после отказов. Общие проверки описи, аннотаций, размеров ответов и ссылок справки также
+включают новый инструмент.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@besales/mcp",
-  "version": "1.0.0-beta.7",
+  "version": "1.0.0-beta.9",
   "description": "Model Context Protocol server for Besales",
   "license": "MIT",
   "homepage": "https://github.com/be-sales/mcp#readme",
@@ -57,15 +57,16 @@
     "test": "vitest run",
     "lint:fix": "eslint src bin scripts eslint.config.js --fix",
     "lint:errors": "eslint src bin scripts eslint.config.js",
-    "types:gen:api": "node scripts/sync-api-contracts.mjs --types-only",
+    "types:gen:api": "node --loader ./src/utils/setup-sessions-loader.mjs scripts/sync-api-contracts.mjs --types-only",
     "publish:mcp-registry": "node scripts/publish-mcp-registry.mjs",
-    "schemas:sync:agent-models": "node scripts/sync-agent-model-schemas.mjs",
-    "schemas:sync:trigger-arguments": "node scripts/sync-trigger-argument-schema.mjs",
-    "schemas:sync:wave-ids": "node scripts/sync-wave-id-schemas.mjs",
-    "schemas:sync:crm-stage-pool": "node scripts/sync-crm-stage-pool-schema.mjs",
+    "schemas:sync:agent-models": "node --loader ./src/utils/setup-sessions-loader.mjs scripts/sync-agent-model-schemas.mjs",
+    "schemas:sync:trigger-arguments": "node --loader ./src/utils/setup-sessions-loader.mjs scripts/sync-trigger-argument-schema.mjs",
+    "schemas:sync:wave-ids": "node --loader ./src/utils/setup-sessions-loader.mjs scripts/sync-wave-id-schemas.mjs",
+    "schemas:sync:crm-stage-pool": "node --loader ./src/utils/setup-sessions-loader.mjs scripts/sync-crm-stage-pool-schema.mjs",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src bin scripts eslint.config.js",
-    "contracts:sync:api": "node scripts/sync-api-contracts.mjs"
+    "contracts:sync:api": "node --loader ./src/utils/setup-sessions-loader.mjs scripts/sync-api-contracts.mjs",
+    "contracts:check:api": "node --loader ./src/utils/setup-sessions-loader.mjs scripts/sync-api-contracts.mjs --check"
   },
   "engines": {
     "node": ">=20.0.0"

package/scripts/body-idempotency-contract.mjs

@@ -0,0 +1,95 @@
+import ts from 'typescript';
+
+/** Читает тела операций снимка, включая inline-типы и ссылки на operations/components. */
+export function bodyIdempotencyOperations(source) {
+  const file = ts.createSourceFile('api-contract.ts', source, ts.ScriptTarget.Latest, true);
+  if (file.parseDiagnostics.length) throw new Error('API_CONTRACT_PARSE_FAILED');
+  const declarations = new Map(
+    file.statements
+      .filter((node) => ts.isInterfaceDeclaration(node) || ts.isTypeAliasDeclaration(node))
+      .map((node) => [node.name.text, node]),
+  );
+  function members(node, seen = new Set()) {
+    if (!node) throw new Error('API_CONTRACT_TYPE_MISSING');
+    if (seen.has(node)) throw new Error('API_CONTRACT_TYPE_CYCLE');
+    const next = new Set([...seen, node]);
+    if (ts.isTypeReferenceNode(node)) {
+      if (
+        node.typeName.getText(file) === 'Record' &&
+        node.typeArguments?.[0]?.kind === ts.SyntaxKind.StringKeyword &&
+        node.typeArguments?.[1]?.kind === ts.SyntaxKind.NeverKeyword
+      )
+        return [];
+      const declaration = declarations.get(node.typeName.getText(file));
+      if (!declaration) throw new Error('API_CONTRACT_REFERENCE_MISSING: ' + node.getText(file));
+      return members(declaration, next);
+    }
+    if (ts.isTypeAliasDeclaration(node) || ts.isParenthesizedTypeNode(node))
+      return members(node.type, next);
+    if (ts.isIndexedAccessTypeNode(node)) {
+      if (!ts.isLiteralTypeNode(node.indexType)) throw new Error('API_CONTRACT_INDEX_UNSUPPORTED');
+      const field = members(node.objectType, next).find(
+        (one) => one.name?.text === node.indexType.literal.text,
+      );
+      if (!field) throw new Error('API_CONTRACT_REFERENCE_MISSING: ' + node.getText(file));
+      return members(field.type, next);
+    }
+    if (ts.isUnionTypeNode(node) || ts.isIntersectionTypeNode(node))
+      return node.types.flatMap((one) => members(one, next));
+    if (ts.isTypeLiteralNode(node) || ts.isInterfaceDeclaration(node)) return [...node.members];
+    // Основание indexed access — имя интерфейса, а не ссылка TypeReference.
+    if (ts.isIdentifier(node)) return members(declarations.get(node.text), next);
+    if (
+      ts.isArrayTypeNode(node) ||
+      ts.isLiteralTypeNode(node) ||
+      (node.kind >= ts.SyntaxKind.FirstKeyword && node.kind <= ts.SyntaxKind.LastKeyword)
+    )
+      return [];
+    throw new Error('API_CONTRACT_TYPE_UNSUPPORTED: ' + node.getText(file));
+  }
+
+  const paths = declarations.get('paths');
+  if (!paths?.members?.length) throw new Error('API_CONTRACT_PATHS_MISSING');
+  const operations = [];
+  for (const route of paths.members) {
+    for (const method of members(route.type)) {
+      if (!/^(get|post|put|patch|delete|head|options|trace)$/u.test(method.name?.text ?? ''))
+        continue;
+      const body = members(method.type).find((field) => field.name?.text === 'requestBody');
+      if (!body || body.type.kind === ts.SyntaxKind.NeverKeyword) continue;
+      const content = members(body.type).find((field) => field.name?.text === 'content');
+      if (!content) throw new Error('API_CONTRACT_BODY_CONTENT_MISSING');
+      for (const media of members(content.type)) {
+        for (const field of members(media.type)) {
+          const key = field.name?.text;
+          const description = field.getFullText(file);
+          if (
+            !/^(requestKey|idempotencyKey)$/u.test(key ?? '') &&
+            !(
+              /(?:key|token|Id)$/iu.test(key ?? '') &&
+              /@description (?:Неизменный |Обязательный |Сохранённый )?(?:Ключ (?:идемпот|намерения|повтора|операции)|UUID идемпот)/iu.test(
+                description,
+              )
+            )
+          )
+            continue;
+          operations.push({
+            method: method.name.text.toUpperCase(),
+            path: route.name.text,
+            key,
+            required: !body.questionToken && !field.questionToken,
+          });
+        }
+      }
+    }
+  }
+  return operations;
+}
+
+export function contractRoute(entry) {
+  return `${entry.expected.method} /api/v2${entry.expected.pathTemplate.replace(/:([A-Za-z0-9_]+)/gu, '{$1}')}`;
+}
+
+export function operationRoute(operation) {
+  return `${operation.method} ${operation.path}`;
+}

package/scripts/generate-followup-session-contract.mjs

@@ -1,16 +1,23 @@
-import { readFileSync, writeFileSync } from 'node:fs';
+import { writeGeneratedFile } from './generated-output.mjs';
+import { readFileSync } from 'node:fs';
 import { z } from 'zod';
-import { reactivationConfigSchema } from '../dist/tools/definitions/follow-up-config.js';
+import { reactivationConfigSchema } from '../src/tools/definitions/follow-up-config.js';
 
 // Только добавочные поля: остальные ограничения отгруженной поверхности остаются дословными.
 const file = new URL('../src/schemas/mcp-tools.json', import.meta.url);
 const registry = JSON.parse(readFileSync(file, 'utf8'));
-const tool = registry.tools.find(item => item.name === 'besales_followup_sequence_upsert');
+const tool = registry.tools.find((item) => item.name === 'besales_followup_sequence_upsert');
 if (!tool?.inputSchema?.properties?.config?.properties) throw new Error('Нет конфигурации цепочки');
-const derived = z.toJSONSchema(reactivationConfigSchema, { io: 'input', unrepresentable: 'any' });
+const derived = z.toJSONSchema(reactivationConfigSchema, {
+  io: 'input',
+  unrepresentable: 'any',
+});
 for (const field of ['sessionTimeVariable', 'sessionDayOffsets', 'sessionDurationMinutes']) {
-  if (!derived.properties[field]) throw new Error('Не объявлено поле '+field);
+  if (!derived.properties[field]) throw new Error('Не объявлено поле ' + field);
   tool.inputSchema.properties.config.properties[field] = derived.properties[field];
 }
-tool.description = tool.description.replace('непустые dealFields, серия эфиров и неисполняемые виды шагов', 'непустые dealFields и неисполняемые виды шагов');
-writeFileSync(file, JSON.stringify(registry, null, 2)+'\n');
+tool.description = tool.description.replace(
+  'непустые dealFields, серия эфиров и неисполняемые виды шагов',
+  'непустые dealFields и неисполняемые виды шагов',
+);
+writeGeneratedFile(file, JSON.stringify(registry, null, 2) + '\n');

package/scripts/generated-output.mjs

@@ -0,0 +1,9 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+
+// Один режим проверки для узких генераторов: проверка никогда не переписывает вход.
+export function writeGeneratedFile(file, output) {
+  if (process.argv.includes('--check')) {
+    if (readFileSync(file, 'utf8') !== output)
+      throw new Error('GENERATED_CONTRACT_DRIFT: ' + String(file));
+  } else writeFileSync(file, output);
+}

package/scripts/sync-agent-model-schemas.mjs

@@ -1,10 +1,11 @@
+import { writeGeneratedFile } from './generated-output.mjs';
 // Выпуск схемы нового каталога и подсказок из исполняемых определений, без копии списка моделей.
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { readFileSync } from 'node:fs';
 import { z } from 'zod';
-import { agentModelTools } from '../dist/tools/definitions/agent-models.js';
-import { agentSettingsTools } from '../dist/tools/definitions/agent-settings.js';
+import { agentModelTools } from '../src/tools/definitions/agent-models.js';
+import { agentSettingsTools } from '../src/tools/definitions/agent-settings.js';
 
-import { renderToolInventoryMarkdown, toolInventoryCounts } from '../dist/tools/inventory.js';
+import { renderToolInventoryMarkdown, toolInventoryCounts } from '../src/tools/inventory.js';
 
 const target = new URL('../src/schemas/mcp-tools.json', import.meta.url);
 const registry = JSON.parse(readFileSync(target, 'utf8'));
@@ -36,7 +37,7 @@ registry.summary.total_tools = names.length;
 registry.summary.tools_by_category = toolInventoryCounts(names);
 const readmePath = new URL('../README.md', import.meta.url);
 const readme = readFileSync(readmePath, 'utf8');
-writeFileSync(
+writeGeneratedFile(
   readmePath,
   readme.replace(
     /(<!-- BEGIN GENERATED TOOL INVENTORY -->)[\s\S]*?(<!-- END GENERATED TOOL INVENTORY -->)/u,
@@ -56,17 +57,16 @@ const route = {
   canonicalArgs: args,
   expected: {
     method: request.method,
-    pathTemplate: url.pathname.replace(args.workspace_id, ':workspaceId'),
     path: url.pathname,
+    pathTemplate: url.pathname.replace(args.workspace_id, ':workspaceId'),
     query: Object.fromEntries(url.searchParams),
   },
 };
 const previousRoute = routeMap.findIndex((item) => item.tool === definition.name);
 if (previousRoute === -1) routeMap.push(route);
-else routeMap[previousRoute] = route;
-writeFileSync(routeMapPath, JSON.stringify(routeMap, null, 2) + '\n');
+// Прочие поля строки (backendTarget) ставит sync-api-contracts — не стирать их, иначе выпуски по очереди меняют файл.
+else routeMap[previousRoute] = { ...routeMap[previousRoute], ...route };
+writeGeneratedFile(routeMapPath, JSON.stringify(routeMap, null, 2) + '\n');
 const serialized = JSON.stringify(registry, null, 2) + '\n';
-writeFileSync(target, serialized);
-mkdirSync(new URL('../dist/schemas/', import.meta.url), { recursive: true });
-writeFileSync(new URL('../dist/schemas/mcp-tools.json', import.meta.url), serialized);
+writeGeneratedFile(target, serialized);
 console.log('Схемы каталога моделей агента и подсказки выпущены');