@besales/mcp 0.28.0 → 0.32.0

package/CHANGELOG.md

@@ -1,531 +0,0 @@
-# Changelog
-
-All notable changes to `@besales/mcp` are documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and the project aims to follow [Semantic Versioning](https://semver.org/).
-
-> **Versioning.** Under 0.x SemVer a breaking change bumps the minor version (not
-> major). Minors have carried breaking changes: `0.2.0` removed deprecated MCP tool
-> shapes (Phase B hard break, 2026-05-27); `0.3.0` removed the `CredentialReader` /
-> `CredentialStorage` exports and `ToolApiClient.getStoredWorkspaceId()`.
-> `package.json` tracks the latest released version.
-
-The tool counts below are derived from `src/schemas/mcp-tools.json`
-(`tools.length`) at each milestone commit and are asserted in
-`src/tools/registry.spec.ts`. The active toolset grew from 18 → 138.
-
-## [Unreleased]
-
-### Changed
-
-- `besales_crm_pipeline_status_update` получил optional `is_system_managed` —
-  master-переключатель «Управляется системой» из Pipeline Builder UI. Локальные настройки
-  статуса не вызывают пустой PATCH во внешний CRM. Tool count не изменился.
-
-- `besales_getcourse_wave_import` синхронизирован с аналитикой запусков: `funnel` теперь явно
-  означает каноническую бизнес-воронку, а имя конкретного запуска передаётся отдельно через
-  `cohort_label`. Добавлены `message_variant`, `found_count` и per-contact timestamps
-  `segment_entered_at` / legacy `lead_last_active_at`; все поля валидируются и маппятся в v2 API.
-  Tool count не изменился.
-
-## 0.26.0
-
-- `product_code` валидируется zod-паттерном `^[^\s/]+# Changelog
-
-All notable changes to `@besales/mcp` are documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and the project aims to follow [Semantic Versioning](https://semver.org/).
-
-> **Versioning.** Under 0.x SemVer a breaking change bumps the minor version (not
-> major). Minors have carried breaking changes: `0.2.0` removed deprecated MCP tool
-> shapes (Phase B hard break, 2026-05-27); `0.3.0` removed the `CredentialReader` /
-> `CredentialStorage` exports and `ToolApiClient.getStoredWorkspaceId()`.
-> `package.json` tracks the latest released version.
-
-The tool counts below are derived from `src/schemas/mcp-tools.json`
-(`tools.length`) at each milestone commit and are asserted in
-`src/tools/registry.spec.ts`. The active toolset grew from 18 → 138.
-
- (после `.trim()`, чтобы не быть строже бэкенда на краевых пробелах); `pattern` продублирован в обеих копиях `mcp-tools.json` и в OpenAPI-контракте. Поведенческий тест в `registry.spec.ts`.
-
-- `besales_getcourse_wave_import`: новые опциональные поля `product_code` / `product_name` — привязывают воронку волны к продукту справочника «воронка → продукт» (аналитика рассылок). Правило create-if-absent: уже замапленная воронка НЕ перезаписывается, конфликты возвращаются в `productMapping` ответа. `product_code` требует `funnel`; `product_name` без кода → 400. Не путать с `preflight.product_title` (сверка оплат).
-
-## [0.25.0] — 2026-07-09
-
-### Added
-
-- **`output_config.response_mode` в `besales_agent_update` — «тихий режим» агента (tool count unchanged, 143).**
-  Новое поле `response_mode: TEXT | SILENT` (backend `AgentChat.responseMode`): SILENT-агент
-  не отправляет ответы в канал, но полностью выполняет триггеры/действия (CRM, заметки,
-  вебхуки; исключение — `GETCOURSE_SEND_PAYMENT_LINK`, у тихого агента пропускается целиком,
-  включая создание заказа в GetCourse). Неотправленные ответы сохраняются в истории чата
-  с пометкой «[Тихий режим — не отправлено]». Правки: Zod `agentOutputConfigSchema` +
-  `mapOutputConfigInput` + advertisement в `mcp-tools.json` (обе копии синхронно, codegen
-  не запускался). Read-back — `responseMode` в `Agent` (`besales_agent_list` /
-  `besales_platform_context_get`).
-
-## [0.24.0] — 2026-07-06
-
-### Added
-
-- **`besales_agent_clone` — deep-clone AgentChat на той же платформе (142 → 143 tools).**
-  Зеркало GUI-кнопки «клонировать»: `POST /api/v2/platforms/:platformId/agents/:agentId/clone`,
-  scope `mcp:platform-setup`. Копирует baseSystemPrompt (+prompt-линковку NULL → PromptHub
-  bootstrap), knowledge namespaces, модель/tools/переменные, ICP-линки и ВСЕ триггеры+действия;
-  НЕ копирует routing rules и per-platform `AgentBehavior` (клон инертен до привязки к роутеру).
-  cross-platform не поддержан. Increment 21.
-- **`besales_getcourse_wave_import.check_messenger_presence` (optional, default TRUE) — 0 new tools.**
-  На Шаге 1 отсеивает контакты без мессенджера (Telegram/Max/VK): не импортируются и не уходят в
-  волну (число — в `contactsSkippedNoMessenger`). Проверка = API-вызов на КАЖДЫЙ контакт, запуск
-  синхронно ждёт Шаг 1 → для БОЛЬШИХ когорт (сотни) риск таймаута клиента: тогда `false` + сначала
-  backfill `POST /chat-users/import/getcourse-refresh-messengers`. Contract↔zod parity.
-
-## [0.21.0] — 2026-06-26
-
-### Added
-
-- **External API channel provisioning — 4 direct tools (134 → 138 tools).**
-  `besales_external_api_channel_create` / `_rotate_key` / `_rotate_secret` / `_update` —
-  провижининг открытого партнёрского relay-канала `ExternalApi` через MCP (зеркало
-  `besales_crm_activate`): direct POST/PATCH на `/api/v2/workspaces/:workspaceId/external-api-channels`,
-  scope `mcp:platform-setup`, `defaultWorkspaceId`. `create` возвращает `{ channelId, apiKey,
-  webhookSecret, ingestPath }` — apiKey (Bearer входящих партнёра) и webhookSecret (HMAC-подпись
-  наших колбэков) показываются ОДИН раз; `_rotate_key` / `_rotate_secret` перевыпускают их (старое
-  инвалидируется немедленно); `_update` меняет несекретные `callback_url` / `source_channel`.
-  Канал также провиженится из UI (front-aniomaly `AddPlatformPage` / `PlatformPage`) и принимает
-  входящие на `POST /api/v2/channels/:channelId/messages` (Bearer bsl-ключ) → AI → HMAC-колбэк
-  (`message.reply`; проактивный follow-up — `message.followup` без `requestId`). Новый
-  `src/tools/definitions/external-api-channels.ts` + записи в `mcp-tools.json`; contract↔zod parity
-  (`registry.spec.ts` / `server.spec.ts` → 138).
-
-## [0.20.0] — 2026-06-25
-
-### Added
-
-- **`besales_agent_variable_overrides_get` — read-only текущие перезаписи переменных агента (133 → 134 tools).**
-  `GET /platforms/:platformId/agents/:agentId/variable-overrides` (workspace-scoped) → `{ workspaceOverrides[],
-  customOverrides[] }`: для каждой перезаписи — id переменной + `name` + `type` + `overrideValue`.
-  `workspaceOverrides` — перезаписи `WorkspaceVariable` (референс `{{{name}}}`), `customOverrides` —
-  платформенной `CustomVariable` (`{name}`). Закрывает асимметрию: перезаписи через MCP можно было
-  ЗАПИСАТЬ (`besales_agent_update.agent_variable_overrides` / `agent_workspace_variable_overrides`), но не
-  ПРОЧИТАТЬ (read-back существовал только GUI-эндпоинтом под `JwtAuthGuard`). Эти поля заменяют набор
-  ЦЕЛИКОМ (`replaceForAgent` = delete отсутствующих + upsert присланных), поэтому read-back обязателен,
-  чтобы не затереть уже выставленную перезапись (напр. `registration_link`): прочитал → добавил новые →
-  переотправил весь набор. Backend: `getAgentVariableOverrides` в `platform-setup-adapter` (+spec).
-
-## [0.18.0] — 2026-06-23
-
-### Fixed
-
-- **`besales-mcp connect` — печатает authorization URL и не падает, если браузер не открылся
-  (0 new tools).** Раньше `connect` молча полагался на авто-открытие браузера (пакет `open`) и сам URL
-  **не печатал** — если браузер не открывался (WSL / RDP / нет дефолтного браузера / тихий фейл `open`),
-  пользователь висел до 5-минутного таймаута, и **открыть ссылку вручную было нечем**. Теперь CLI
-  **печатает authorization URL перед ожиданием** колбэка (открой вручную, если авто-открытие не
-  сработало) и **не прерывает флоу при ошибке авто-открытия** — продолжает ждать колбэк (до 5 мин), пока
-  ты завершаешь вход по напечатанной ссылке. Добавлен опциональный hook `OauthClient.onAuthorizationUrl(url)`
-  (CLI печатает URL через него). Особенно важно на Windows/WSL, где авто-открытие браузера часто молчит.
-
-## [0.15.0] — 2026-06-15
-
-### Added
-
-- **`besales_trigger_delete` — удаление триггера агента через MCP (130 → 131 tools).** Destructive:
-  `explicit_confirmation: true` обязателен (паттерн `besales_crm_pipeline_delete`); маршрут
-  `DELETE /platforms/:platformId/agents/:agentId/triggers/:triggerId`. Audit пишет **non-reversible**
-  запись со снапшотом before (для ручного восстановления) — faithful recreate вложенного дерева
-  действий+конфигов отложен (как `revertClone`), safety = подтверждение.
-
-### Changed
-
-- **`besales_trigger_upsert` — `replace_actions: true` снимает запрет на замену действий существующего
-  триггера.** Раньше PATCH с `actions` отвергался (additive-only, «не правится через MCP»); теперь с явным
-  `replace_actions=true` действия заменяются целиком (delete-and-recreate через ядровый `updateTrigger`,
-  как в UI). Без флага — прежнее поведение (отказ, защита от случайной потери соседних действий).
-  enhanceResponse напоминает: прочитай текущие действия (`besales_platform_context_get`) и передай
-  ПОЛНЫЙ набор, а не дельту. Закрывает «правка triggers/actions только через UI» (напр. смена searchMode
-  у DATA_SOURCE_READ-действия). Backend: `replaceActions` opt-in в `besales_trigger_upsert` PATCH +
-  новый `DELETE` в platform-setup-adapter (ai-aniomaly), audit non-reversible со снапшотом.
-
-## [0.14.0] — 2026-06-12
-
-### Added
-
-- **`url_handling.use_youtube_data_api` — опциональный флаг обогащения YouTube-ссылок (0 new tools, 130).**
-  `besales_behavior_update` через типизированную секцию `url_handling` принимает `use_youtube_data_api: boolean`.
-  Когда влючён и `behavior` — non-terminal (`PASS_THROUGH`/`PROCESS_WITH_CRAWLER`), backend на YouTube-ссылку
-  дёргает YouTube Data API v3 (`videos.list?part=snippet`) и подмешивает title/description/tags **текстом** в
-  контекст LLM (само видео не смотрится). `SILENT`/`FIXED_RESPONSE` флаг не вскрывает. Backend остаётся no-op,
-  пока в env не задан `YOUTUBE_DATA_API_KEY`. Маппер `mapBehaviorUrlHandlingInput` протаскивает snake→camel
-  (`use_youtube_data_api` → `useYoutubeDataApi`). Контракты (`mcp-tools.json` url_handling + openapi
-  `BehaviorUrlHandlingJson`) и сгенерированные типы синхронизированы. Tool counts без изменений (130).
-- **Тест маппера** `mapBehaviorUrlHandlingInput` (`shared.spec.ts`): snake→camel, сохранение `false`,
-  дроп `undefined` (189 → 192 теста).
-
-### Changed
-
-- **Point-of-action nudge для ГЕНЕРАЦИИ промпта (0 new tools, 130) — завершает набор симметричных nudge'ей.**
-  `besales_prompt_generate_get_instructions` теперь ПЕРВОЙ инструкцией велит свериться с
-  `besales://docs/prompt-anatomy` (лимит длины + что система добавляет сама) и `besales://docs/prompt-principles`
-  (человечность/анти-AI-tell + sales-плейбук + раздел C: майнить реальные диалоги операторов) — форму/тактику
-  брать из ресурсов, не из догадок. Раньше это жило только в serverInstructions (session-level, легко дрейфит
-  к моменту генерации); теперь напоминание есть в точке действия — как у `prompt_patch_commit` (0.12.0) и
-  `dialog_script_update`. Backbone Фаза 4a (serverInstructions) тоже получила указатель «ПЕРЕД генерацией
-  читай anatomy + principles». Чистый instruction-текст, схемы/счётчики без изменений.
-
-### Fixed
-
-- **Контракт `mcp-tools.json` досинхронизирован с `src/schemas` (7 comm-resources + расширенное описание
-  `prompt-principles`, добавленные в Increment 13 только в `src/schemas`).** Контракт-источник отставал на
-  23 ресурса → `yarn types:gen:mcp` (`cp` contract→src/schemas) ронял 7 comm-ресурсов и валил
-  `registry.spec`/`server.spec` (ждут 30). Теперь контракт == src/schemas → codegen идемпотентен.
-  `api-contract.gen.ts` (`BehaviorUrlHandlingJson`) тоже получил `useYoutubeDataApi` руками (telephony-дрейф
-  в этом неиспользуемом файле не трогали).
-
-## [0.13.0] — 2026-06-10
-
-### Added
-
-- **7 comm-skill ресурсов `besales://docs/comm-*` (0 new tools, 130; 23 → 30 resources).** Глубокие
-  тематические разборы 97 боевых диалогов (Партии 1+3 разметки Антона): first-touch / discovery /
-  objections-price / handoff-close / followups / anti-robot / tone-register — второй слой к always-on
-  `besales://docs/prompt-principles` (расширен до A33/B39). Source of truth:
-  `docs/dialog-corpus/deep/comm_*.md` (animaly), синк markdown-копий — `scripts/sync-comm-skills.sh`.
-
-## [0.12.0] — 2026-06-10
-
-### Changed
-
-- **«Скрипт диалога» — loose-связь со §6 (снята жёсткая сцепка `§6 = render(скрипт)`).** Скрипт
-  (`dialogScript`) теперь SUMMARY/скелет диалога, а §6 промпта создаётся агентом НА ЕГО ОСНОВЕ, но
-  богаче и независима — после создания расходятся, ничего не перетирается автоматически. Источник
-  истины для рантайма — промпт. `besales_dialog_script_*` описания + serverInstructions Фаза 3/4a +
-  workflow `platform-setup-from-scratch` переформулированы под loose-модель (§6 пиши на основе скрипта,
-  подробнее; после правки §6 — обнови скрипт-summary). Симметричный point-of-action nudge: `besales_prompt_patch_commit`
-  при коммите правки промпта напоминает обновить скрипт-summary, если правка затронула этапы/ветки/переходы
-  (а не тон/факты) — связь loose, авто-синка нет.
-- **serverInstructions hygiene: восстановлено правило «сохраняй маркеры §6 при правке».** Маркеры
-  `Ветка X. / [этап:] / [тег:] / →` активно парсит `coverage_check` (покрытие тест-сценариев) +
-  fallback-парсер — это НЕ только legacy. Убран ошибочный «silent-revert warning» (правка §6 больше
-  не откатывается — сцепки нет). Tool counts без изменений (130).
-
-### Fixed
-
-- **`besales_test_scenario_generate_get_instructions`: дрейф «1-4 turns» → «минимум 4 turns».**
-  Backend (JSON-схема `minItems:4` + DTO + service-валидация) требует ≥4 turns на сценарий —
-  старая инструкция «1-4 turns» вела к 400 на submit при 1-3 turns. Заодно добавлена краткость
-  client-реплик: мессенджер-стиль 3-15 слов, стиль из languageStyle сегмента/persona (синхронно
-  с backend-инструкциями scenario_builder и тестер-промптом симуляции prompt-services).
-
-## [0.11.0] — 2026-06-10
-
-### Added
-
-- **«Скрипт диалога» как отдельная хранимая сущность (+2 tools, 128 → 130).** `besales_dialog_script_get`
-  (read структурного скрипта из поля `dialogScript`) + `besales_dialog_script_update` (записать/поправить
-  граф: этапы/ветки/реплики/переходы). Инверсия источника правды: `dialogScript` (поле на агенте) =
-  source of truth, §6 «Скрипт диалога» в промпте рендерится ИЗ него детерминированно при генерации
-  (`besales_prompt_generate`). Скрипт и промпт — отдельные шаги.
-
-### Changed
-
-- **serverInstructions Фаза 3/4 reframe.** «Скрипт» теперь отдельная хранимая сущность (не «секция промпта»):
-  на 4a после `besales_agent_create` → `besales_dialog_script_update` (структура ДО промпта) →
-  `besales_prompt_generate` (§6 рендерится из поля). Hygiene §6-маркеров остаётся валидной для legacy/ручных правок.
-
-## [0.10.1] — 2026-06-09
-
-### Changed
-
-- **Приветствие на создании агента — только текст, кнопки opt-in.** Уточнена guidance
-  (0 новых tools/resources): на фазе 4 (Build&Prove) из секций `besales_behavior_update`
-  ставится ТОЛЬКО `greeting.bot_greeting` текстом (язык аудитории, открывает INBOUND-диалог) —
-  это единственная behavior-секция при создании, остальной behavior (typing/media/splitting/
-  operator_schedule/privacy) откладывается на фазу 5 (Enrich). `greeting_buttons` —
-  **opt-in**: добавляются лишь по явному запросу пользователя (кнопки дают menu-feel, против
-  принципа «звучит как человек»). Синхронно: `SERVER_INSTRUCTIONS` (фаза 4a + golden rule 7),
-  workflow `platform-setup-from-scratch`, doc-bridge `besales://docs/agent-behavior` (§6,
-  MCP-operator-пометка), success-сообщение `besales_prompt_finalize`. Требует reconnect MCP-хоста.
-  (2026-06-09)
-
-## [0.10.0] — 2026-06-09
-
-### Changed
-
-- **Оркестрация: пайплайн-модель переписана на 6 фаз `1–6`** (1 Connect · 2 Discover ·
-  3 Author · 4 Build&Prove · 5 Enrich · 6 Activate) взамен прежней `0/A–E`. `SERVER_INSTRUCTIONS`
-  и workflow `platform-setup-from-scratch` теперь ведут пользователя по фазам (директивнее, но
-  гибко: любое действие в любой момент → возврат в пайплайн) + сквозные правила: тест-рефлекс на
-  каждую версию промпта, Google-Sheets feedback-loop (`besales_feedback_sheet_*`), выбор модели
-  только в фазе 4, тестирование мультиагент+роутер (`mode=single_agent` + `mode=workflow`),
-  ленивая CRM. **0 новых tools, 0 новых resource-файлов** (orchestration-only — правит контент
-  существующих ресурсов/инструкций) — поверхность 128 tools / 23 resources. (2026-06-09)
-- **`besales_workspace_overview.setupCompleteness.suggestedNextPhase` — значения `0/A–E` → `1–6`**
-  (contract-изменение enum в `openapi-besales-api.yaml`; регенерён `api-contract.gen.ts`). Эвристика
-  эмитит `{1,4,5,null}`; reorder — «prove» (sandbox, фаза 4) проверяется до «enrich» (knowledge,
-  фаза 5). MCP релеит значение прозрачно (логика не ветвится на нём).
-
-### Notes
-
-- Канонич. источник модели — `docs/specs/v1.5/10-agent-orchestration-layer.md` §4/§4.1.
-- Требует **перезапуск / reconnect MCP-хоста** — running-процесс держит старые instructions/resources.
-
-## [0.9.1] — 2026-06-09
-
-### Added
-
-- **`besales_behavior_update` — секция `privacy`** — typed-секция
-  `privacy: { anonymization_enabled }` включает обратимую PII-анонимизацию
-  LLM-пайплайна (per-platform флаг `AgentBehavior.anonymizationEnabled`: реальные
-  имя/телефон/email вырезаются перед отправкой в LLM и подставляются обратно в ответ
-  и аргументы tool-call). Проксируется на v2-эндпоинт
-  `PATCH /api/v2/platforms/:platformId/agent-behavior` (схема `BehaviorPrivacyJson`).
-  Новых tool'ов нет — toolset остаётся 128, resources 23. (2026-06-09)
-
-## [0.9.0] — 2026-06-08
-
-### Added
-
-- **Data sources — 1С provisioning + management (9 tools)** —
-  `besales_datasource_create_init` / `_create_status` (Setup URL pattern: пароль
-  OData вводится в браузере на `/setup/:ref`, минуя чат), `_list`, `_health`,
-  `_catalogs`, `_catalog_roles`, `_role_assign` (one-role-per-object: PRODUCT_CATALOG
-  /STOCK/PRICE/ORDER/CUSTOMER/OTHER), `_enable` (вкл/выкл подключение), `_vectorize`
-  (семантический поиск по каталогу товаров → Pinecone). Категория «БД»: 1С — товарная
-  БД через OData; чтение/запись данных агент делает через ДЕЙСТВИЯ ТРИГГЕРОВ
-  (`DATA_SOURCE_READ` / `DATA_SOURCE_WRITE`), а не через MCP-tools или tools агента —
-  у агента остаются ровно 3 attachable tool (`run_trigger` / `send_pic` / `call_qa`).
-  Проксируют v2-адаптер `/api/v2/.../data-sources` + `datasource-setup-sessions`.
-  Tool count 119 → 128, resources 22 → 23 (+workflow `connect-datasource-from-scratch`). Scope: `mcp:platform-setup`.
-  (2026-06-08)
-
-## [0.8.0] — 2026-06-06
-
-### Added
-
-- **Model comparison — «model bake-off» (4 tools)** — `besales_model_catalog_list`,
-  `besales_model_comparison_run_start`, `besales_model_comparison_get`,
-  `besales_model_comparison_eval_submit`. On-demand сравнение промпта на нескольких
-  моделях: один и тот же набор persona-диалогов гоняется на N моделях (модель агента
-  варьируется, тестер фиксирован — apples-to-apples), бэкенд считает per-model
-  детерминированные метрики, оператор-ИИ судит победителя и фиксирует вердикт через
-  eval-submit. Internal prompt-services-операция (не external dual-mode). Новый
-  workflow-ресурс `besales://workflows/compare-models` + строка в serverInstructions.
-  Tool count 115 → 119, resources 21 → 22. (2026-06-06)
-
-### Fixed
-
-- Сверена loose-canonical `docs/specs/v2/contracts/mcp-tools.json` (была 114/20) с
-  проверенным `src/schemas`-базисом (115/21) ПЕРЕД добавлением: `besales_crm_list` +
-  ресурс `besales://docs/prompt-principles` были в src, но отсутствовали в loose —
-  следующий `types:gen:mcp` откатил бы src. (2026-06-06)
-
-### Changed
-
-- **serverInstructions golden rule #6 + `besales_workbook_inspect` response instructions** —
-  теперь явно требуют: (1) пройти по содержимому ВСЕХ вкладок и не заявлять «этого нет в файле»,
-  пока не сверился с каждой (`google_sheets_url` inspect читает все вкладки server-side без обрезки —
-  использовать его, а не `read_file_content`, который молча режет большие многотабовые файлы);
-  (2) если источник на языке, отличном от языка диалога с пользователем — ПЕРЕД загрузкой в
-  RAG/промпт/ICP дать пользователю краткое саммари на его языке (что нашёл, что внедряешь;
-  по цифрам/процентам/условиям — подтверждение). Docs-only, без новых tools, tool count без изменений.
-  Спека-зеркало: `docs/specs/v1.5/10-agent-orchestration-layer.md` §3. (2026-06-04)
-
-## [0.7.0] — 2026-06-03
-
-### Added
-
-- **`install:claude-desktop --name <server> --workspace <uuid>`** — writes an
-  env-pinned named `mcpServers` entry (with a timestamped config backup), so each
-  workspace gets its own server with tools namespaced `mcp__<server>__besales_*`.
-  The pin lives in the host config, so it **survives MCP reconnects and never
-  silently drifts** — the durable way to run several workspaces concurrently in a
-  GUI host (Claude Desktop), unlike the in-memory `besales_workspace_use`. With no
-  flags the command still installs the local-dev `besales` server as before. Not
-  an MCP tool — tool count unchanged at 114. (2026-06-03)
-
-## [0.6.0] — 2026-06-03
-
-### Added
-
-- **CRM activation tool** — `besales_crm_activate({ crm_id })` activates a CRM
-  (live token check + deactivates the other workspace CRMs + enables linked
-  triggers). Closes the gap where MCP could connect a CRM but not enable it
-  (activation used to be UI-only). Tool count 113 → 114.
-- **CRM provisioning auto-activation** — on `READY`, AmoCRM auto-activates when it
-  is the workspace's only CRM (the long-lived token is live-validated during
-  activation). If another CRM is already active it stays inactive — switch with
-  `besales_crm_activate` (no silent clobber).
-- **Connect-CRM workflow resource** — `besales://workflows/connect-crm-from-scratch`:
-  operational steps to connect each CRM (AmoCRM long-lived token, where to find
-  sub_domain/client_id/secrets, the scopes needed for call-audio export, and
-  activation). Resource count 19 → 20.
-
-### Changed
-
-- **All CRM fields are entered on the setup page** — `besales_crm_create_init.fields`
-  is now optional; the non-secret fields (sub_domain / client_id / domain /
-  account_domain / forum_group_id) are entered by the human on `/setup/:ref`
-  alongside the secrets, so even non-secret IDs no longer pass through the chat.
-  Init now also returns `required_non_secret_fields`.
-- **serverInstructions golden rule #8** — operational instructions must come from
-  MCP resources / a tool's `instructions`, never from the platform source code.
-- **`besales://docs/crm-integration`** — §7 now distinguishes AmoCRM OAuth (UI)
-  from MCP long-lived-token provisioning (it previously read as OAuth-only).
-
-## [0.5.0] — 2026-06-03
-
-### Added
-
-- **Per-session workspace binding for GUI hosts** — `besales_workspace_use`
-  (bind THIS session to a workspace, in-memory) and `besales_workspace_current`
-  (show the binding + source, list connected workspaces). Each host session runs
-  its own `besales-mcp` process, so the binding is per-session and touches neither
-  the global `active` nor other sessions — the answer for Claude Desktop "new
-  session", where `BESALES_WORKSPACE_ID` cannot be set per session. Not persisted
-  (a fresh session starts on `active`; re-bind when needed); refused under a
-  `BESALES_WORKSPACE_ID` pin. Resolution precedence is now env → explicit
-  `workspace_id` → session binding → active → sole. Tool count 111 → 113.
-  (2026-06-03)
-
-## [0.4.0] — 2026-06-02
-
-### Added
-
-- **ICP read tools (4)** — `besales_icp_list`, `besales_icp_get`,
-  `besales_icp_scenarios_list`, `besales_icp_sample_messages`. Read-only wrappers
-  over the existing `GET /api/v2/icp/*` endpoints, so a host can read live ICP
-  data (profile + segments + personas + recent samples; test scenarios; sample
-  dialogue messages). Previously only `besales_workspace_overview` summary counts
-  were exposed — there was no way to read the actual segment/persona/scenario/
-  dialogue content through MCP. No backend or OpenAPI change (the GET routes and
-  contract already existed). Tool count 107 → 111. (2026-06-02)
-
-## [0.3.0] — 2026-06-02
-
-### Added
-
-- **Multiple workspaces in one keychain** — `connect` now *appends* a key per
-  workspace instead of overwriting, so several workspaces (even across accounts)
-  coexist. New commands: `connections` (list + active marker), `use <workspaceId>`
-  (set the active default), `disconnect <workspaceId>` / `disconnect --all`. Bare
-  `disconnect` now removes only the active workspace (was: clear everything).
-  (2026-06-02)
-- **Per-session workspace pinning** — `BESALES_WORKSPACE_ID` env var binds a host
-  session to one workspace and overrides the global active pointer. Per-call
-  resolution precedence: env → explicit `workspace_id` → active → sole connection.
-  A mismatching explicit `workspace_id` under a pinned env var is refused.
-  (2026-06-02)
-- **Automatic legacy migration** — a pre-0.3 single-workspace connection
-  (`api_key` + `workspace_id`) is folded into the multi-workspace store on the
-  first storage command or tool call; no reconnect needed. (2026-06-02)
-
-### Changed
-
-- `besales_*` tool calls resolve their workspace key per call from the connection
-  store. `workspace_id` argument descriptions now read "defaults to the workspace
-  bound to this session (BESALES_WORKSPACE_ID or active connection)". No tool
-  schema changes. (2026-06-02)
-
-### Removed
-
-- Public exports `CredentialReader`, `CredentialStorage`, and the
-  `ToolApiClient.getStoredWorkspaceId()` method — the HTTP client now takes the
-  api key per request instead of reading a single stored key. (2026-06-02)
-
-## [0.2.0] — 2026-05-29
-
-### Added
-
-- **OAuth PKCE platform provisioning** — `besales_platform_create_oauth_init`
-  opens the browser authorization flow for Instagram/Avito so the OAuth code
-  never passes through the LLM. (`d4d2c3d`, 2026-05-29)
-- **AmoCRM / Bitrix24 connection via browser-secrets** — `besales_crm_create_init`
-  now also provisions AmoCRM and Bitrix24 (credentials pasted in the browser, not
-  the chat), and `besales_crm_operator_update` toggles operators. Tool count
-  92 → 95 → 105 → **107**. (`d4d2c3d`, 2026-05-29)
-- **Increment 5 — files + platform/CRM provisioning (10 tools)** — file upload
-  flow (`besales_file_upload_request` / `_upload_status` / `besales_file_list`,
-  5a), platform provisioning (`besales_platform_create_init` / `_create_status`,
-  5b), and CRM connection + field mapping + operators
-  (`besales_crm_create_*`, `besales_crm_field_mapping_*`,
-  `besales_crm_operator_*`, 5c). All use the Setup URL pattern for sensitive
-  input. Tool count 95 → 105. (`d4882f1`, 2026-05-29)
-- **Increment 4d — platform clone (3 tools)** —
-  `besales_platform_clone_preview` / `_execute` / `_status` plus safety
-  hardening. Tool count 92 → 95. (`a10ec46`, 2026-05-28)
-- **Increment 4b — CRM pipelines, statuses, platform link (11 tools)** —
-  `besales_crm_pipeline_*` (5), `besales_crm_pipeline_status_*` (4),
-  `besales_platform_pipeline_link` / `_unlink` (2). Tool count 81 → 92.
-  (`144a7bf`, 2026-05-27)
-- **Increment 4a — unified Variables API (5 tools)** — `besales_variable_*`
-  CRUD. Tool count 76 → 81. (`c20f74c`, 2026-05-27)
-- **Increment 3 — knowledge tables + typed agent/behavior sections (7 tools)** —
-  `besales_knowledge_table_*` (6) plus typed-section expansion of
-  `besales_agent_update` / `besales_behavior_update` /
-  `besales_platform_settings_update` / `besales_pipeline_settings_update`.
-  Tool count 70 → 77. (`c3c60b8`, 2026-05-27)
-- **Increment 2 — knowledge Q&A + websites (11 tools)** — `besales_knowledge_qa_*`
-  (7, incl. semantic search and move) and `besales_knowledge_website_*` (4).
-  Tool count 59 → 70. (`b507dbf`, 2026-05-27)
-- **Increment 1 — knowledge ingestion (10 tools)** — `besales_knowledge_space_*`
-  (6) and `besales_knowledge_document_*` (4). Tool count 49 → 59.
-  (`c71157a`, 2026-05-27)
-- **Workbook ingestion (3 tools)** — `besales_workbook_inspect`,
-  `besales_workbook_extract_amocrm_leads`, `besales_workbook_to_knowledge_document`
-  for xlsx and Google Sheets sources. Tool count 46 → 49. (`282fa2f`, 2026-05-27)
-- `besales_workspace_overview` tool. (`9d19f38`, 2026-05-26)
-- **Prompt patch sessions (5 tools)** — `besales_prompt_patch_start` / `_get` /
-  `_apply` / `_commit` / `_discard`. (`c5fc4d8`, 2026-05-26)
-- **Google Sheets feedback integration (5 tools)** — `besales_feedback_sheet_*`
-  (link / list / read / unlink / row_update) for binding tester-feedback sheets
-  to a prompt. (`383b6b3`, 2026-05-21)
-- `besales_test_scenario_generate_get_instructions` / `_submit` external pair,
-  closing the single-tool gap for the sandbox flow. Tool count 31 → 33.
-  (`fc26398`, 2026-05-19)
-- `client_mode` (`scripted` / `simulated`) and `mode` options on
-  `besales_sandbox_run_start` (schema-only; tool count unchanged).
-  (`ee508bd`, `d93c724`, 2026-05-21/22)
-
-### Changed
-
-- Reconciled the published catalog count to match `mcp-tools.json` after drift
-  (markdown table said 38; JSON synced to 41). (`36b4c05`, 2026-05-26)
-- Regenerated `api-contract.gen.ts` against successive OpenAPI drafts
-  (SandboxScenarioMetric, PromptDraft, feedback-path removal, OpenAPI 2.0.7).
-
-### Removed (BREAKING)
-
-- **Phase B hard break (2026-05-27)** — removed deprecated MCP tool shapes:
-  the generic `updates` field on `besales_behavior_update` and
-  `besales_pipeline_settings_update`, and the generic `settings` field on
-  `besales_platform_settings_update` are now rejected with HTTP 400; only typed
-  JSONB-shaped sections remain. `besales_agent_legacy_self_analysis_set` was
-  deleted (replaced in v2 by post-processors / the Routing Studio Critic node).
-  Tool count 77 → 76. (`cacfb74`, 2026-05-27)
-- `besales_prompt_iterate_*` (2 tools) fully removed in favor of the
-  `besales_prompt_analyze_*` + `besales_prompt_patch_*` flow. (`c5fc4d8`,
-  `b14fe89`, 2026-05-26)
-
-## [0.1.0] — 2026-05-13
-
-Initial package scaffold and first active toolset.
-
-### Added
-
-- npm package bootstrap, OAuth client, and MCP server skeleton.
-  (`66266e7`, `dd3256c`, 2026-05-13)
-- First active MCP tools and concept resources (18 tools). (`e094b01`,
-  2026-05-13)
-- **Platform Setup Bridge tools** — `besales_platform_context_get`,
-  `besales_agent_*`, `besales_router_update`, `besales_routing_rule_upsert`,
-  `besales_trigger_upsert`, `besales_behavior_update`,
-  `besales_followup_sequence_upsert`, `besales_pipeline_settings_update`,
-  `besales_platform_settings_update`, `besales_audit_revert`. Tool count
-  18 → 31. (`32f36ec`, 2026-05-15)
-- MCP host setup runbook (`docs/host-setup.md`) and npm package setup flow in the
-  README. (`90ef122`, `4e3cac1`, 2026-05-14/15)
-- Split `BESALES_OAUTH_AUTHORIZE_URL` from `BESALES_API_BASE_URL`. (`0656d0b`,
-  2026-05-18)