@besales/mcp 0.47.1 → 1.0.0-beta.2

package/docs/tool-surface.md

@@ -1,7 +1,83 @@
 # Поверхность инструментов: группы, а не укрупнение
 
+Каждый опубликованный инструмент содержит короткий русский `Tool.title`, построенный из
+локализованного описания и ограниченный 80 символами. Интерфейс хоста может показывать его
+человеку, а стабильным идентификатором вызова остаётся `name`.
+
+## Безопасная публикация контрактов
+
+Эталон отгруженной линии задаётся единой настройкой `BESALES_MCP_SHIPPED_REF` через
+`scripts/shipped-ref.mjs`. Умолчание, в том числе при пустом или пробельном значении, —
+`origin/v1-line`: после замены `main` сверка продолжает читать прежнюю линию пакета.
+
+Публикация идёт только из закоммиченного дерева моста: выгрузка подписывается коммитом `HEAD`, а
+инструменты берутся из рабочей сборки, и при незакоммиченных правках подпись называла бы коммит, из
+которого выгрузка не собрана. Незакоммиченное дерево — отказ с перечнем правок.
+
+`yarn publish:mcp-registry` требует два явных каталога: `BESALES_SPECS_CONTRACTS_DIR`
+для зеркала `mcp-tools.json` и `BESALES_API_CONTRACTS_DIR` для tracked-карты маршрутов API.
+До сборки команда проверяет оба каталога, наличие OpenAPI и принадлежность API contracts
+выбранному Git checkout. Артефакты сначала строятся во временном каталоге и попадают в цели
+только после успешной генерации обоих файлов. Поздняя ошибка не оставляет обновлённый
+specs-снимок рядом со старой картой API.
+
+Карта маршрутов для API несёт и схемы входа ВСЕХ инструментов обоих реестров — отдельными ключами
+`shippedInputSchemas` (отгруженный реестр) и `v2InputSchemas` (ветка v2), картой «имя → схема». По ним
+сервер сверяет аргументы шагов, которые его навигация называет ассистенту: аргумент мимо схемы мост
+отвергнет или молча срежет. Записи `tools` при этом не меняются. Инструмент выгрузки без схемы ветки v2 —
+отказ публикации, а не пропуск.
+
+## Сохранение входных полей
+
+Сторож в `scripts/registry-diff.spec.mjs` сверяет объявленные пути с выходной JSON-схемой
+Zod: входная схема разрешает лишние поля даже тогда, когда разбор их удаляет. Объект с
+`passthrough` сохраняет произвольные поля вместе с их вложенным содержимым. Для известного
+дочернего объекта действует его собственная схема, поэтому разрешение лишних полей у
+родителя не скрывает удаление внутри дочернего объекта или элемента массива.
+
+У `besales_followup_sequence_upsert` конфигурация проходит как произвольный объект и
+передаётся в тело POST/PATCH целиком, с ключами camelCase. Проверка реактивационной формы
+добавляет ошибки, но не заменяет исходник своим результатом разбора. Мост сохраняет
+в том числе инертные поля и null; API проверяет допустимость перевода в исполняемую цепочку
+и отвечает адресным отказом на неподдерживаемые настройки. Передача поля сама по себе
+не обещает его исполнения. `followup-b2.spec.ts` проверяет полное тело обеих ветвей записи.
+
+## Смена ключей CRM
+
+Генератор `scripts/generate-crm-rotation-contract.mjs` строит локальные схемы и случаи запросов
+`besales_crm_rotate_init` и `besales_crm_rotate_status` из определений инструментов. При переносе
+этих случаев в `besales-api/contracts/mcp-v2-route-map.json` он фиксирует `requiredScopes: ["write:crm"]`
+для обоих входов. Опрос состояния смены ключей требует управления CRM, несмотря на GET.
+В списке контракта эта пара стоит в группе CRM сразу после `besales_crm_operator_update`,
+как и в регистрации. Генератор сохраняет порядок остальных инструментов при повторном выпуске.
+После обновления списка он пересчитывает `summary.total_tools`, `summary.tools_by_category`
+и блок `GENERATED TOOL INVENTORY` в README функциями из `src/tools/inventory.ts`.
+Числа выводятся из активных имён, без ручного счётчика. Обычный запуск после `yarn build`:
+`node scripts/generate-crm-rotation-contract.mjs`. Для выпуска непосредственно из исходников:
+`node --loader ./src/utils/setup-sessions-loader.mjs scripts/generate-crm-rotation-contract.mjs --source`.
+Порядок перечисления не задаёт приоритет выполнения: вызов выбирает инструмент по имени.
+Эта фикстура не заменяет `contracts/mcp-tool-routes.json`: полное перечисление, схемы обоих
+реестров и происхождение отгруженного эталона выпускает `yarn publish:mcp-registry` после коммита
+моста. Добавление инструмента в локальную схему само по себе не обновляет выгрузку для API.
+
+Локальную `src/schemas/mcp-v2-route-map.json` отдельно пересобирает
+`BESALES_API_CONTRACTS_DIR=<API>/contracts node scripts/sync-route-map.mjs` после `yarn build`;
+`--check` сверяет её без записи. Генератор исполняет определения и сохраняет точные query/body,
+проверяет маршруты по снимку API и регистрацию скрытого маршрута по контроллеру.
+`sync-api-contracts.mjs` использует тот же генератор. `sync-contract-ledger-schemas.mjs`
+обновляет схемы и метаданные перенесённых полей описи; новые DELIBERATE-ключи требуют
+отдельных ACTIVE-решений в `besales-api/docs/contract-ledger/cledg-decisions.md`.
+
 ## Решение
 
+Число активных инструментов определяется длиной `tools` в `mcp-tools.json`.
+Число случаев запроса определяется длиной карты `mcp-v2-route-map.json`, а число покрытых
+инструментов — количеством уникальных имён до суффикса варианта `@...` в поле `tool`;
+ветви учитываются отдельными случаями.
+Категории в `summary.tools_by_category` и таблица README сверяются с именами реестра тестом
+`inventory.spec.ts`, а случаи карты — с реальными конструкторами запросов тестом
+`v2-route-map.spec.ts`. Число случаев карты не заменяет число инструментов.
+
 **Инструменты не укрупняются. Их число не сокращается. Появляются профили — набор имён,
 которым сессия ограничивает себя сама.**
 
@@ -16,12 +92,19 @@
    разрушительный ВСЕГДА, и хост больше никогда не сможет считать безопасной ни одну его ветку.
    Работа по аннотациям была бы обесценена ровно в тот момент, когда она начала приносить пользу.
 2. **Имена — это контракт отгруженной линии.** Пакет стоит у пользователей и вызывается по
-   именам; переименование требует совместимого выпуска и синхронной правки инструкций,
-   ресурсов, скиллов и README.
+   именам; переименование бьёт мажор и требует синхронной правки инструкций, ресурсов, скиллов
+   и README — 428 упоминаний. Переименования и алиасы для v2 отменены отдельным решением.
 3. **Слитый инструмент хуже выбирается моделью.** Вместо ста имён с собственными схемами
    появляется десяток имён с перечислением действий, где ошибка в поле `action` неотличима от
    ошибки в аргументах, а схема каждого «действия» вырождается в необязательные поля.
 
+Узкое исключение — **именной преемник при смене самого контракта**, а не алиас. Плановый разбор
+переписки переехал с площадок на каналы, внешние номера охвата заменил локальными справочниками,
+а сырые промпты — именами шаблонов. Поэтому v2 публикует `besales_dialogue_analysis_*`, старые
+`besales_scheduled_task_*` наружу не регистрирует, а fail-closed сверка связывает обе пары через
+`toolSuccessors`. Сопоставление нужно только для контроля расхождений отгруженного контракта: оно
+не создаёт второе имя, не маршрутизирует вызов и не скрывает отсутствие реализации.
+
 Профили решают ту задачу, ради которой укрупнение и предлагалось — **вес и досягаемость**, — и
 не платят ничем из перечисленного.
 
@@ -40,6 +123,60 @@ BESALES_MCP_TOOLSETS=readonly,knowledge  # профили складываютс
 - **Доменная группа выводится из имени** (`besales_<группа>_…`), рукописного реестра нет. Реестр
   пришлось бы пополнять при каждом добавлении, и забытая строка тихо выкидывала бы новый
   инструмент из всех профилей — он просто перестал бы существовать для тех, кто выбрал группу.
+  ⚠️ Однокоренные имена сводятся коротким списком псевдонимов: `dialog_review_*`,
+  `dialogues_query` и `dialogue_transcript` — один домен, но второй токен написан по-разному, и
+  попросивший `dialog` не получил бы ни чтения переписки, ни выборки диалогов. Переименовать их
+  вместо этого нельзя: имена — контракт отгруженной линии. Список самопроверяемый — тест требует,
+  чтобы каждый источник псевдонима исчез из групп, а цель существовала; полный перечень
+  30 категорий тоже объявлен в тесте, поэтому новая категория становится осознанным решением, а
+  не побочным следствием названия.
+
+## Профиль принадлежит ПОДКЛЮЧЕНИЮ, а не подагенту
+
+Объявление читается один раз, при запуске процесса. Один процесс — одно подключение MCP, значит
+профиль ограничивает **подключение целиком**.
+
+⛔ Подагент хоста своего процесса моста не поднимает: он пользуется тем, что уже подключено в
+сессии, и подставить туда своё окружение ему некуда. Ограничить подагента списком инструментов
+хост умеет **сам, по именам** — профиль для этого не нужен и не поможет.
+
+Профиль закрывает другое: **инструмента, не зарегистрированного в подключении, не существует**.
+Его не позовёт ни автоодобряющий хост, ни ошибшийся агент. Отсюда настоящие места применения —
+отдельное подключение «только чтение» для разбора и аудита, фоновый запуск, которому нельзя
+ничего менять, узкое подключение под конкретную работу.
+
+Если профиль на подагента всё-таки нужен, мост регистрируется **дважды** под разными именами с
+разным окружением, а подагенту разрешаются инструменты только нужного сервера:
+
+```bash
+claude mcp add besales-ro -e BESALES_MCP_TOOLSETS=readonly -- npx -y @besales/mcp
+```
+
+⚠️ Приём обоюдоострый: подключив в ОДНОЙ сессии и полный мост, и профильные, вы заплатите
+БОЛЬШЕ — каждое подключение грузит свой список. Смысл появляется, когда разные сессии или разные
+хосты используют разные записи, а не когда все записи живут рядом.
+
+## Категорий агент НЕ видит
+
+⛔ Частое недопонимание: категория — это фильтр **на входе**, а не уровень, по которому агент
+ходит. Протокол отдаёт **плоский список**: вложенности, папок и поля «категория» в нём нет.
+Модель получает имена, описания и схемы ровно тех инструментов, которые профиль пропустил, — и
+не знает, что остальные существуют.
+
+Двухуровневая выдача («сначала категории, потом инструменты в ней») протоколом **достижима**, но
+другим механизмом: сервер объявляет способность «список инструментов может меняться», отдаёт
+сперва горстку инструментов-категорий, а на вызов категории подменяет набор и уведомляет хост.
+Сегодня эта способность у моста НЕ объявлена (`capabilities.tools = {}`), то есть режим не
+построен.
+
+**Замер, ради которого об этом вообще думают:** полная выдача списка — **201 КБ** (имена 5,
+описания 71, схемы 125). Одни только названия 30 категорий — **0,3 КБ**.
+
+Цена двухуровневого режима, которая этим замером не видна: каждая смена категории — лишний
+круг обмена, а типовая работа здесь сквозная (завести канал = платформа + агент + промпт +
+знания + CRM + триггеры), то есть переключений будет много и модель обязана заранее угадывать,
+в какой категории что лежит. Профиль тот же выигрыш даёт без динамики — но только когда сессия
+узкая заранее.
 - **`readonly` — не группа, а срез**: состав выводится из уже объявленного `sideEffect === 'none'`.
 - **Отбор действует и на перечисление, и на вызов.** Профиль, который только прячет, — декорация:
   хост, знающий имя, всё равно позовёт скрытое, а ровно от такого вызова профиль и заводится.
@@ -62,6 +199,10 @@ BESALES_MCP_TOOLSETS=readonly,knowledge  # профили складываютс
 инструмента вне профиля для сессии не существует. Слои дополняют друг друга и не заменяют:
 аннотации помогают хосту решать, профиль — не даёт ошибиться.
 
+План теста воронки дожимов ничего не отправляет человеку, но сохраняет черновик и удаляет
+прежние черновики того же автора. Поэтому у него нет признака «только чтение». Предпросмотр
+«Первого сообщения» считает охват без записи и отправки и остаётся читающим POST.
+
 ---
 
 # Составной инструмент правки промпта: строить не нужно
@@ -87,5 +228,65 @@ BESALES_MCP_TOOLSETS=readonly,knowledge  # профили складываютс
 Что остаётся неизменным: **сначала прочитать промпт целиком** (`besales_prompt_patch_get`), иначе
 неоткуда взять точные якоря. Это не обходится ни одним из вариантов.
 
-Итог: правильное количество кода здесь — ноль. Работа сводится к тому, чтобы описание
-`besales_prompt_batch_start` называло одиночный случай явно.
+Итог: правильное количество кода здесь — ноль. Описание `besales_prompt_batch_start` называет
+одиночный случай явно: список из одного идентификатора с режимом «всё или ничего» даёт ту же
+цепочку целиком.
+
+## Каталог аналитики и проверка исполнителя
+
+Группа `inbound` входит в категорию `outbound_and_analytics`; входящая аналитика остаётся
+отдельным инструментом. Все активные имена обязаны иметь ровно одну категорию; README и
+счётчики реестра сверяются с этим же каталогом.
+
+Сравнение принимает до 36 моделей (предел `MAX_MODELS` в `prompt-services`, f649530).
+Проверка предела сравнения моделей читает настоящий `prompt-services` рядом с деревом.
+В изолированном дереве путь задаётся через `BESALES_PROMPT_SERVICES_DIR`; отсутствие
+исходника или несовпадение предела остаётся ошибкой.
+
+В «Пул сегодня» outsideSegmentsBy содержит одну причину на регистрацию: paid, application,
+attendanceNoMinutes, paidElsewhere («покупал в другой воронке»), seriesRunning («серия ещё идёт»),
+other. Сумма равна outsideSegments; старые снимки могли относить две новые причины к other.
+
+## Поиск контактов .77
+
+В v2 besales_contact_search сохраняет имя и JSON-schema аргументов, но отправляет POST
+`/workspaces/:workspaceId/contacts/search`, селекторы и пагинацию — в JSON-body. GET fallback отсутствует.
+Подсказка хосту `readOnlyHint=false`: POST-поиск не объявляется безопасным GET-чтением.
+Побочных эффектов у поиска нет (`sideEffect=none`), поэтому `destructiveHint=false`;
+снятие подсказки не превращает поиск в запись и не меняет обработку ошибок чтения.
+Сервер продолжает обслуживать опубликованный GET старого моста. Выгрузка сохраняет оригинальный
+GET с shippedMethod/shippedSamplePath/shippedSampleQuery отдельно от нового POST, поэтому проверка
+v2 не подменяет проверку отгруженного клиента. Выпуск маршрутов из закоммиченного моста и генерация
+типов по новому OpenAPI — шаг кресла до запуска; клиенты переключаются совместно с экранами.
+
+Описание поиска контактов учитывает ники с `@` и без, регистронезависимость, все слова имени одной
+карточки в любом порядке и литеральные `%/_/\`. Одиночный `@` не задаёт ник. Аргумент search можно
+опустить; явно пустой/пробельный search, а также пустые phone/email/external_id отвергаются схемой.
+Селекторы остаются в POST-body, scope read:contacts/CONTACT_VIEW не меняется. Параметр telegramId
+профилей к этому инструменту не добавляется. Расширяемое metadata партнёрских входящих и selector
+существующего счёта задаются в API-контрактах соответствующих операций; отдельный инструмент
+для входящего партнёрского пуша не создаётся.
+
+## Уточнения моста v1.5 в словаре v2
+
+Тексты и проверки ввода находятся в `src/tools/definitions/*.ts`;
+`scripts/sync-contract-ledger-schemas.mjs` синхронизирует описания и изменённые узлы
+`src/schemas/mcp-tools.json`, сохраняя остальные ограничения схемы.
+После сборки запускай его и `scripts/sync-tool-inventory.mjs` повторно: файлы должны
+оставаться теми же. `README.md` генерируется только между маркерами TOOL INVENTORY;
+остальная часть README и этот документ редактируются вручную.
+
+Волны GetCourse проверяют множество десяти допустимых транспортов после trim,
+приведения регистра и удаления дублей. Повторы и пробелы принимаются; пустой список
+отвергается. В API передаётся исходное написание. `funnel` — код
+школьной воронки fNN или метка с кодом; подпись запуска хранится в `cohort_label`.
+У планового разбора прежнее `daily/hourly.model` переводится в `model_id`,
+`max_tokens` принимает 1–4000 или null. Запись зависит от флага выпуска API
+`SCHEDULED_TASK_MODEL_WRITES_ENABLED`; мост возвращает отказ API без подмены.
+
+Фасад аналитики принимает открытые периоды mode=range (только from или только to).
+Список и сводка оплат получают общую область фильтрации через periodMode, channelId,
+funnel и остальные поддержанные измерения; include_archived действует на оба отчёта.
+У besales_dialogue_audit_findings необязательный agent_id проверяет принадлежность
+разбора перед чтением находок. Несовпадение агента или ошибка чтения разбора
+останавливает вызов до запроса находок. Без agent_id остаётся один запрос.

package/docs/voice-actions-and-inbox.md

@@ -0,0 +1,95 @@
+# Голосовые шаги и покупка во Входящих
+
+## ЗВ-111: read → edit → write
+
+Читай полный текущий состав через `besales_platform_context_get`, изменяй нужные поля и передавай
+полный массив `actions` с `replace_actions=true` в `besales_trigger_upsert`. Прочитай результат
+ещё раз. Запись конфигурации не делает dial/REFER.
+
+Текущий API принимает `stepType` (также `actionType` / `type`) и `config`:
+
+```json
+{
+  "stepType": "VOICE_INITIATE_OUTBOUND_CALL",
+  "config": {
+    "timing": "CALLBACK",
+    "fromNumberId": null,
+    "reason": "Продолжить разговор",
+    "delayDays": 0,
+    "delayHours": 1,
+    "delayMinutes": 30,
+    "callingWindow": { "days": [1, 2, 3, 4, 5], "startHour": 8, "endHour": 21 },
+    "callingTimezone": "Europe/Moscow",
+    "maxCallbacksPerContact": 2
+  }
+}
+```
+
+Перевод: `VOICE_TRANSFER_CALL`, `config: {"targetLabel":"Reception"}`; `targetLabel:null`
+сохраняется как явный выбор. Прежние имена типов `INITIATE_OUTBOUND_CALL`, `TRANSFER_CALL` и
+`initiateOutboundCall`, `transferCall` принимаются. Пары входных имён:
+
+| Действие            | Relation из старого чтения | Старое имя входа             |
+| ------------------- | -------------------------- | ---------------------------- |
+| Позвонить           | `initiateOutboundCall`     | `initiateOutboundCallConfig` |
+| Перевести оператору | `transferCall`             | `transferCallConfig`         |
+
+Нормализация сводит голосовой шаг к `stepType` + одному `config`. Непустой relation вместе с
+input-key (даже с `null` / явно переданным `undefined`), два input-key, конфликт типов или
+непустой чужой relation/config отвергаются **до HTTP**. Пустые чужие relations `null`/`undefined`
+снимаются. Неизвестный голосовой тип и неизвестный тип с голосовыми relations получают безопасный
+отказ. Другие новые типы остаются свободной строкой с полным config: их пригодность судит строгий
+v2 mapper API при сохранении, не исполнитель звонка; мост не обрезает их к прежнему enum.
+
+С action снимаются только `id/triggerId/createdAt/updatedAt`; с верхнего уровня выбранного
+config — `id/actionId/createdAt/updatedAt`. Вложенные пользовательские поля не обходятся рекурсивно.
+Отсутствие config не материализует defaults; `config:null` не является объектом по опубликованному
+DTO и отклоняется; null разрешённых полей конфига сохраняется. Тексты typed issues есть на пяти языках.
+
+`src/schemas/voice-actions-api.contract.json` — узкий машинный срез принятого API и списка relations;
+обновление: `node scripts/sync-voice-actions-contract.mjs`, затем
+`node scripts/sync-voice-actions-tools.mjs`. Источники и SHA-256 закреплены в срезе.
+
+## УП-3.03: отдельный признак покупки
+
+```json
+{
+  "source": "inbox",
+  "purchased": true,
+  "has_payment": false,
+  "channel_id": "00000000-0000-4000-8000-000000000001",
+  "with_totals": true,
+  "limit": 50
+}
+```
+
+Это аргументы **существующего** `besales_dialogues_query`. Режим `source=inbox` читает
+`POST /workspaces/:workspaceId/conversations/search`, scope `read:conversations`.
+Без `source` либо с `source=export` сохраняется прежняя выгрузка диалогов.
+
+`purchased:true` — успешный заказ агента **или** текущая продажная стадия своей CRM; false —
+отрицание того же объединения. Это не оплата: `has_payment` независим. Omission не добавляет фильтр.
+Без `channel_id` область — видимые каналы человека; с ним — выбранный канал. Принимается также
+`contact_id`. Строковый/числовой/null boolean отклоняется до HTTP.
+
+`hasPurchase` в строке, предикат и итоги считает сервер до пагинации. Мост сохраняет его ответ,
+не вычисляет покупку из оплаты. Повтори с `source=inbox`, теми же фильтрами и `cursor`, пока
+курсор не пуст; `with_totals` возвращает ограниченные итоги только первой страницы (`capped`
+значит 999+, не точное число). Фильтры выгрузки (даты, action_type, platform_ids и прочие)
+с inbox не смешиваются: адресный отказ до запроса. Разрешения и чужую область проверяет API.
+
+Проверки: `voice-actions-bridge.spec.ts` проходит через настоящий MCP registry и ApiClient с
+подставным HTTP transport и хранилищем конфигурации; серверная БД и живые звонки здесь не имитируются
+результатом PASS. Полноту ветки inbox держит `v2-route-map.spec.ts`.
+
+Отгруженная линия не знает `source` и всегда вызывает `GET dialogue-export`. Поэтому образца
+отгруженного вызова для `inbox` нет: генератор сохраняет новый переключатель и указывает
+`V2_ONLY_VARIANT` с путём `source`. Точное решение находится в `shipped-lag.json`, раздел
+`contractExtensions`, ключ `besales_dialogues_query@inbox::source`. Строка станет ошибкой,
+когда отгруженная линия получит этот вариант. Проверка одинакового метода и адреса сохранена.
+
+Для диагностики `emit-tool-routes.mjs --dry-run` принимает `BESALES_MCP_SHIPPED_REGISTRY`
+и `BESALES_MCP_SHIPPED_COMMIT`. Каталог `BESALES_API_CONTRACTS_DIR` должен находиться внутри
+`.codex-artifacts-*/`; файл эталона сверяется с указанным git-коммитом. Результат помечен
+`shippedRegistry.diagnosticOnly: true`, `source: file`, без `fetched: true` и непригоден для коммита.
+Штатная выгрузка без флага требует чистое дерево и обновлённый git-эталон.

package/docs/wazzup-instagram-comments.md

@@ -0,0 +1,26 @@
+# Настройки комментариев Instagram через Wazzup
+
+`besales_platform_settings_update` использует существующий `PATCH /api/v2/channels/:id/settings`.
+Поле `instagram_comment_behavior` переводится в `instagramCommentBehavior` того же документа,
+который читает и пишет web-форма. Мост и web-форма — независимые клиенты API.
+
+Раздел применяется к прямому Instagram и к сохранённому подключению `WHATSAPP / WAZZUP_API`
+с подтипом `instagram`; остальные подтипы отвергаются API. При правке Wazzup не передают
+`reply_to_story_mentions`: транспорт не поддерживает истории. Не передают старый provider/config
+выключатель; режим двух ответов называется `PUBLIC_AND_DM`. Сохранение настроек не отправляет сообщение.
+
+Пропущенные поля сохраняют прочитанные значения, включая keywords/templates. Переданная группа
+шаблонов заменяет документ целиком, явные `null` и `{}` неравнозначны. Слоты утверждённых текстов —
+`ru`, `uz`, `uz_cyrl` (на API `uzCyrl`); пять языков интерфейса не добавляют слотов шаблона.
+Соседняя правка имени или таймзоны не добавляет раздел комментариев и не сбрасывает его.
+Общий fixture `src/tools/definitions/__fixtures__/wazzup-comment-settings.json` побайтово совпадает
+с `besales-api/test/fixtures/wazzup-comment-settings.json` и задаёт форму, перевод моста и канон БД.
+
+Публичный ответ цитирует комментарий. Личный ответ разрешён один раз на комментарий не позже
+семи суток; писать первым и отвечать на истории нельзя. Подключение/живые отправки и ночная
+активация требуют отдельной приёмки; наличие настройки не подтверждает работающий аккаунт.
+
+Для перехода сначала выключают прежний канал Besales и отключают его в кабинете Wazzup,
+потом Connect/Reconnect и включение прямого Instagram. Общая подтверждённая карточка сохраняет
+доступ к истории, когда связь уже есть. Username сам по себе людей не объединяет, семь суток
+Wazzup не дают права писать в новом 24-часовом окне Meta. Демо не включается этой настройкой.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@besales/mcp",
-  "version": "0.47.1",
-  "description": "Model Context Protocol server for Animaly / Besales",
+  "version": "1.0.0-beta.2",
+  "description": "Model Context Protocol server for Besales",
   "license": "MIT",
   "homepage": "https://github.com/be-sales/mcp#readme",
   "repository": {
@@ -15,7 +15,6 @@
     "mcp",
     "model-context-protocol",
     "besales",
-    "animaly",
     "claude",
     "codex"
   ],
@@ -36,12 +35,14 @@
     "dist",
     "bin",
     "scripts",
+    "!scripts/generate-operator-contract.ts",
     "docs",
     "!docs/evidence",
-    "README.md"
+    "README.md",
+    "README.onprem.ru.md"
   ],
   "bin": {
-    "besales-mcp": "bin/besales-mcp.js"
+    "besales-mcp": "./bin/besales-mcp.js"
   },
   "scripts": {
     "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc && mkdir -p dist/schemas dist/resources/concepts dist/resources/workflows dist/resources/docs dist/skills/besales-dialogue-audit && cp src/schemas/mcp-tools.json dist/schemas/mcp-tools.json && cp src/resources/concepts/*.md dist/resources/concepts/ && cp src/resources/workflows/*.md dist/resources/workflows/ && cp src/resources/docs/*.md dist/resources/docs/ && cp src/skills/besales-dialogue-audit/SKILL.md dist/skills/besales-dialogue-audit/SKILL.md",
@@ -50,16 +51,21 @@
     "dev:mock:seed": "node scripts/mock-credentials.js seed",
     "dev:mock:clear": "node scripts/mock-credentials.js clear",
     "host:probe": "node scripts/probe-mcp-protocol.js",
-    "model:eval:server": "node scripts/model-eval-server.js",
-    "model:eval": "node scripts/run-model-eval.js",
     "install:claude-desktop": "node scripts/install-claude-desktop.js",
     "prepack": "yarn build",
     "prepublishOnly": "yarn lint:errors && yarn test && yarn build",
-    "test": "vitest run --maxWorkers=4",
+    "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": "mkdir -p src/types && openapi-typescript ../docs/specs/v2/contracts/openapi-besales-api.yaml -o src/types/api-contract.gen.ts",
-    "types:check:mcp": "node -e \"const s=require('./src/schemas/mcp-tools.json');if(s.summary.total_tools!==s.tools.length)process.exit(1)\""
+    "types:gen:api": "node 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",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src bin scripts eslint.config.js",
+    "contracts:sync:api": "node scripts/sync-api-contracts.mjs"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -74,6 +80,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@besales/contract-ledger": "file:vendor/contract-ledger-1.0.0.tgz",
     "@types/node": "^25.7.0",
     "@typescript-eslint/eslint-plugin": "^8.59.3",
     "@typescript-eslint/parser": "^8.59.3",

package/scripts/api-source-loader.spec.mjs

@@ -0,0 +1,40 @@
+import { mkdtempSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { afterAll, describe, expect, it } from 'vitest';
+
+const require = createRequire(import.meta.url);
+const apiRoot = process.env.BESALES_API_ROOT ?? fileURLToPath(new URL('../../besales-api', import.meta.url));
+const fixtureRoot = mkdtempSync(join(tmpdir(), 'brx1-api-source-'));
+mkdirSync(join(fixtureRoot, 'src/shared'), { recursive: true });
+symlinkSync(join(apiRoot, 'node_modules'), join(fixtureRoot, 'node_modules'), 'dir');
+writeFileSync(join(fixtureRoot, 'package.json'), '{}');
+writeFileSync(join(fixtureRoot, 'src/shared/entities.json'), '{"amp":[38]}');
+writeFileSync(join(fixtureRoot, 'src/shared/broken.json'), '{');
+writeFileSync(join(fixtureRoot, 'src/shared/relative.ts'), `
+  import entities from './entities.json';
+  export { entities };
+`);
+writeFileSync(join(fixtureRoot, 'src/entry.ts'), `
+  import entities from '@shared/entities.json';
+  import { entities as relative } from './shared/relative.js';
+  export { entities, relative };
+`);
+const load = require('../test/bridge-contract/api-source-loader.cjs')(fixtureRoot);
+afterAll(() => rmSync(fixtureRoot, { recursive: true, force: true }));
+
+describe('чтение исходников API без сборки', () => {
+  it('JSON через @shared и относительный импорт даёт один разобранный документ', () => {
+    const { entities, relative } = load('entry.ts');
+    expect(entities).toEqual({ amp: [38] });
+    expect(relative).toBe(entities);
+    expect(load('shared/entities.json')).toBe(entities);
+  });
+
+  it('битый JSON и выход за корень API не принимаются', () => {
+    expect(() => load('shared/broken.json')).toThrow(SyntaxError);
+    expect(() => load('../outside.json')).toThrow('API source root escaped');
+  });
+});

package/scripts/audit-bridge-controls.mjs

@@ -0,0 +1,129 @@
+// Только чтение: проверяет входы кресла, не выпускает подписанный contracts/mcp-tool-routes.json.
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { load } from 'js-yaml';
+
+const contracts = process.env.BESALES_API_CONTRACTS_DIR?.trim();
+if (!contracts) throw new Error('BESALES_API_CONTRACTS_DIR обязателен');
+const read = (name) => JSON.parse(readFileSync(resolve(contracts, name), 'utf8'));
+const api = load(readFileSync(resolve(contracts, 'openapi-besales-api.yaml'), 'utf8'));
+const published = read('mcp-tool-routes.json');
+const apiMap = read('mcp-v2-route-map.json');
+const registry = JSON.parse(
+  readFileSync(new URL('../src/schemas/mcp-tools.json', import.meta.url), 'utf8'),
+);
+const localMap = JSON.parse(
+  readFileSync(new URL('../src/schemas/mcp-v2-route-map.json', import.meta.url), 'utf8'),
+);
+const lag = JSON.parse(
+  readFileSync(new URL('../src/schemas/shipped-lag.json', import.meta.url), 'utf8'),
+);
+const stable = [
+  'besales_agent_create',
+  'besales_agent_update',
+  'besales_agent_clone',
+  'besales_agent_get',
+  'besales_icp_get',
+];
+const selected = new Set([
+  ...stable,
+  'besales_platform_settings_update',
+  'besales_prompt_batch_start',
+  'besales_prompt_batch_status',
+  'besales_prompt_batch_resume',
+  'besales_prompt_batch_stop',
+  'besales_prompt_batch_by_key',
+  'besales_dialogue_followup_state_get',
+]);
+const rows = localMap.filter((row) => selected.has(row.tool.split('@')[0]));
+const pendingExport = [];
+for (const row of rows) {
+  const path = '/api/v2' + row.expected.pathTemplate.replace(/:([A-Za-z0-9_]+)/gu, '{$1}');
+  assert.ok(api.paths[path]?.[row.expected.method.toLowerCase()], `${row.tool}: API route missing`);
+  if (!apiMap.some((entry) => entry.tool === row.tool)) pendingExport.push(row.tool);
+}
+for (const name of stable) {
+  const schema = registry.tools.find((tool) => tool.name === name).inputSchema;
+  assert.deepEqual(
+    schema.required,
+    published.shippedInputSchemas[name].required,
+    `${name}: shipped required changed`,
+  );
+  assert.deepEqual(
+    schema.required,
+    published.v2InputSchemas[name].required,
+    `${name}: v2 required changed`,
+  );
+  const local = localMap.find((row) => row.tool === name);
+  const mapped = apiMap.find((row) => row.tool === name);
+  const exported = published.tools.find((row) => row.name === name);
+  for (const [field, value] of Object.entries(local.expected)) {
+    assert.deepEqual(value, mapped.expected[field], `${name}: API map ${field} changed`);
+  }
+  assert.equal(local.expected.method, exported.method, `${name}: exported method changed`);
+  assert.equal(local.expected.path, exported.samplePath, `${name}: exported path changed`);
+}
+for (const name of ['besales_agent_create', 'besales_agent_update']) {
+  const schema = registry.tools.find((tool) => tool.name === name).inputSchema;
+  assert.deepEqual(
+    schema.properties.default_icp_profile_id,
+    published.shippedInputSchemas[name].properties.default_icp_profile_id,
+  );
+  assert.deepEqual(
+    schema.properties.default_icp_profile_id,
+    published.v2InputSchemas[name].properties.default_icp_profile_id,
+  );
+}
+for (const map of [localMap, apiMap]) {
+  assert.equal(
+    map.some(
+      (row) => row.expected.method === 'POST' && row.expected.pathTemplate.endsWith('/icp-links'),
+    ),
+    false,
+  );
+}
+assert.equal(
+  published.tools.some(
+    (row) => row.method === 'POST' && /\/icp-links(?:\?|$)/u.test(row.samplePath ?? ''),
+  ),
+  false,
+);
+assert.equal(
+  Object.values(lag.contractLag).some((entry) => entry.owner === 'TASK-6.28.204'),
+  false,
+);
+
+const deref = (schema) =>
+  schema.$ref ? api.components.schemas[schema.$ref.split('/').at(-1)] : schema;
+const settings =
+  api.paths['/api/v2/channels/{channelId}/settings'].patch.requestBody.content['application/json']
+    .schema;
+for (const [section, fields] of [
+  ['smsgorodSettings', ['channel', 'sender']],
+  ['bitrix24BotSettings', ['botId', 'botCode', 'botName', 'openLineId', 'ignoreCrmStageGate']],
+  ['crmBehavior', ['useCrossPlatformHistory']],
+]) {
+  const schema = deref(settings.properties[section]);
+  for (const field of fields)
+    assert.ok(schema.properties[field], `${section}.${field}: API field missing`);
+}
+const byKey = api.paths['/api/v2/prompt-batch/runs/by-key'].get.parameters.find(
+  (entry) => entry.name === 'idempotencyKey',
+);
+assert.equal(byKey.required, true);
+assert.equal(byKey.schema.maxLength, 200);
+assert.equal(byKey.schema.pattern, '\\S');
+console.log(
+  JSON.stringify(
+    {
+      checkedRouteVariants: rows.length,
+      stableToolsComparedAgainstBothApiMaps: stable,
+      removedLagOwner: 'TASK-6.28.204',
+      pendingChairExport: pendingExport,
+      signedExportChanged: false,
+    },
+    null,
+    2,
+  ),
+);