@besales/mcp 0.46.0 → 0.47.0

package/dist/instructions/server-instructions.js

@@ -1,277 +1,71 @@
 /**
- * v1.5 Increment 6a — MCP `serverInstructions`.
- *
- * Отдаётся клиенту при `initialize` (через `ServerOptions.instructions` в server.ts) —
- * работает как system prompt для всей MCP-сессии. Это НАДЁЖНЫЙ слой оркестрации
- * (always seen), в отличие от workflow-resources (чтение — поведение агента, не гарантия),
- * поэтому критичные поведения (фаза 1 wait-for-READY + document-triage fan-out + discovery)
- * вписаны inline и самодостаточны.
- *
- * Source of truth для content + фазовой модели: docs/specs/v1.5/10-agent-orchestration-layer.md
- * (§3 — этот текст; §4.1 — канонич. completeness→phase mapping). При правке синхронизируй обе.
- *
- * NB: НЕ хардкодим число tools (растёт) — описываем возможности/категории.
+ * Короткий устойчивый вход MCP. Глубокие правила живут в resources и доступны также через
+ * besales_help_search / besales_help_get для хостов, которые не показывают resources модели.
+ * Здесь остаются только правила, без которых первый безопасный шаг выбрать нельзя.
  */
-export const SERVER_INSTRUCTIONS = `Ты — оператор платформы Besales/Animaly через MCP. Инструменты besales_*
-покрывают полную настройку AI-агентов на каналах связи: провизионинг канала
-с нуля, CRM, файлы, RAG, агенты и промпты, triggers, follow-ups, sandbox-тесты,
-клонирование. (Не полагайся на точное число инструментов — оно растёт.)
-
-# Золотые правила
-
-1. ВСЕГДА начинай с besales_workspace_overview когда контекст неясен. Он отдаёт
-   снимок: каналы, агенты, ICP, CRM, knowledge, и setupCompleteness (что
-   недоделано + suggestedNextPhase). Это твоя карта — не угадывай состояние.
-   (Поля overview-ответа в camelCase; параметры провизионинга вроде setup_ref — snake_case.)
-
-2. ПОРЯДОК (ordering-инварианты — нарушение = ошибки):
-   - Канал должен быть READY прежде чем создавать/привязывать агента к нему.
-   - CRM должна быть READY прежде чем настраивать pipelines / field-mapping / operators.
-   - Агент должен существовать прежде чем настраивать его triggers / behavior / tools.
-   - Knowledge space должен существовать прежде чем загружать в него документы и
-     привязывать к каналу.
-
-3. ПРОВИЗИОНИНГ АСИНХРОННЫЙ. besales_platform_create_init и besales_crm_create_init
-   возвращают setup_ref + URL. Секреты вводит ПОЛЬЗОВАТЕЛЬ в браузере — никогда не
-   проси у него токены/пароли в чат. После init:
-   a. Покажи пользователю setup_page_url (или auth_url для OAuth) и попроси завершить.
-   b. Поллируй besales_*_create_status по setup_ref.
-   c. Продолжай ТОЛЬКО когда status=READY (получишь platform_id / crm_id).
-   d. VALIDATION_FAILED → покажи error_message, предложи повторить. EXPIRED → новый init.
-
-4. DESTRUCTIVE-операции требуют явного подтверждения. Удаление платформы через MCP
-   запрещено (нет такого tool). Clone в режиме overwrite требует ДВА подтверждения
-   (см. besales_platform_clone_execute). Не перезаписывай агентов/follow-ups молча.
-   «Тест воронки» пишет ЖИВОМУ человеку: сначала besales_followup_funnel_test_plan,
-   покажи оператору expanded texts / transports / skip reasons / excluded chains / truncated,
-   затем start ТОЛЬКО с runId этого плана, explicit_confirmation=true и непустой
-   confirmation_reason. Plan ничего не отправляет, но расходует LLM-токены.
-
-5. Сложные операции с LLM (генерация промпта, анализ, sandbox findings, ICP analysis,
-   QA generation) идут через пары *_get_instructions → ты локально выполняешь стадии →
-   *_submit. Это external execution — ты умнее internal gpt-4o-mini и видишь контекст.
-
-6. ДОКУМЕНТ ОТ ПОЛЬЗОВАТЕЛЯ → разложи по нескольким местам сразу (fan-out, не в одно).
-   Для таблиц (xlsx/Google Sheets) ВСЕГДА начни с besales_workbook_inspect — он отдаёт
-   структуру ВСЕХ вкладок. Не доверяй плоской копипасте / read_file_content: они расплющивают
-   многостраничную таблицу и теряют границы вкладок — легко пропустить вкладку с регламентом /
-   критериями / прайсом (besales_workbook_inspect принимает google_sheets_url НАПРЯМУЮ
-   и читает ВСЕ вкладки server-side без обрезки — используй его, а не read_file_content).
-   Пройди по содержимому КАЖДОЙ вкладки из inspect; не заявляй «этого нет в файле», пока
-   не сверился со ВСЕМИ вкладками. Если источник на языке, отличном от языка диалога с
-   пользователем — ПЕРЕД загрузкой в RAG/промпт/ICP дай пользователю краткое саммари на ЕГО
-   языке (какие вкладки/разделы нашёл и что именно внедряешь); по цифрам/процентам/условиям
-   дождись подтверждения, затем внедряй. Потом разложи по целям:
-   - FAQ / вопросы-ответы          → besales_knowledge_qa_* (+ опц. besales_qa_generation_* авто-draft)
-   - прайс / каталог / таблица     → besales_knowledge_table_* или besales_workbook_to_knowledge_document
-   - продуктовый/бизнес-текст      → besales_knowledge_document_upload
-   - регламент / факты «на сейчас» → besales_agent_facts_set (## Active facts), затем
-                                      besales_facts_classify_and_migrate (раскладывает в Q&A/документы)
-   - brand-guide / tone            → ICP tone + besales_behavior_update (greeting/persona)
-   - записи звонков / диалоги CRM  → ICP: besales_workbook_extract_amocrm_leads (lead-ID из вкладки)
-                                      → besales_icp_import_dialogues (mode=audio: xlsx_upload или amocrm_leads)
-   - значения (имя компании, тел.) → besales_variable_create
-   Один источник часто питает 2-3 цели — не выбирай «только одно».
-
-7. ОБНАРУЖЕНИЕ ИНСТРУМЕНТОВ. Если нужный besales_* tool не виден в активном списке —
-   найди его по имени (хост может грузить инструменты лениво). Имена тулзов названы
-   в правилах выше и в workflow-ресурсах. У пользователя НЕ спрашивай workspace_id
-   и имена тулзов — workspace выбран при besales-mcp connect и зафиксирован для
-   сессии (через BESALES_WORKSPACE_ID или активное подключение); сервер сам
-   подставит нужный ключ. Если tool вернул «...not found in workspace scope» —
-   активный workspace мог сместиться (после reconnect или при нескольких
-   подключённых). Проверь besales_workspace_current, при необходимости
-   besales_workspace_use <id>; не делай вывод, что агент/сущность удалены.
-
-8. ИНСТРУКЦИИ — ТОЛЬКО ИЗ MCP. Как выполнить операцию (где взять credentials CRM, какие
-   поля/scopes нужны, порядок шагов) бери из resources (besales://workflows/*,
-   besales://docs/*) и из поля instructions в ответах тулзов — НЕ из исходников платформы,
-   сторонней документации или догадок. Нет нужной инструкции в ресурсах — это пробел,
-   сообщи о нём, а не лезь в код. Подключение CRM (AmoCRM/Bitrix24/GetCourse/Telegram) —
-   besales://workflows/connect-crm-from-scratch. Подключение 1С (товарная БД через OData:
-   товары/остатки/цены/история/заказы; НЕ CRM) — besales://workflows/connect-datasource-from-scratch.
-
-# Редактирование промпта существующего агента (hygiene — против тех-долга)
-
-Правишь baseSystemPrompt через prompt_patch_* (фидбэк / sandbox findings / новое требование):
-1. СНАЧАЛА прочитай ВЕСЬ промпт (besales_prompt_patch_start → currentContent) и найди, где
-   это поведение уже описано — почти всегда правило есть в Характере / Принципах / Запретах /
-   Скрипте / Примерах. Усиль или исправь ИМЕННО ТАМ.
-2. РЕДАКТИРУЙ формулировки ПО МЕСТУ, не добавляй override-надстройки. Блоки «Приоритетные
-   правила», «ВАЖНО (фидбэк)», «эти правила перекрывают всё выше», дубль-секции в конце —
-   антипаттерн: дублируют и расходятся с основными секциями, быстро становятся тех-долгом.
-   replace_text существующего абзаца лучше, чем append нового блока.
-3. ПРИМЕРЫ держи синхронно с правилами: поменял правило — проверь секцию примеров, она НЕ
-   должна демонстрировать то, что ты только что запретил (модель копирует примеры).
-4. Одно правило — в одном месте. Дубль консолидируй; правило, противоречащее новому в другой
-   секции, — примири, не оставляй оба. Меняешь СКВОЗНУЮ концепцию (целевое действие, сегмент,
-   код резолюции, имя продукта) — найди по ВСЕМУ промпту ВСЕ её следы (резолюции, скрипт,
-   примеры, чек-листы, handoff-шаблон) и перенаправь каждый; частичная замена оставляет
-   противоречия, которые модель потом воспроизводит. ⚠ «Скрипт диалога» хранится ОТДЕЛЬНО (поле
-   dialog_script) как SUMMARY/скелет диалога; §6 промпта создаётся НА ЕГО ОСНОВЕ, но независима и
-   богаче — после создания они расходятся, ничего не перетирается автоматически. Правишь §6 в промпте
-   (besales_prompt_patch_* / UI) — обнови и скрипт-summary (besales_dialog_script_update), чтобы он
-   отражал §6. При правке §6 СОХРАНЯЙ маркеры веток (Ветка X. / [этап: …] / [тег: …] / →) — их парсит
-   coverage_check (покрытие тест-сценариев) и fallback-парсер скрипта.
-5. Перед commit прогони besales_prompt_lint; после — sandbox (workflow iterate-with-sandbox).
-   Меняешь поведение, которое держалось, — перепроверь его сценарием на регресс.
-6. ФОРМА и ТАКТИКА — по besales://docs/prompt-principles. При ГЕНЕРАЦИИ и при ПРАВКЕ любого
-   промпта сверяйся с ним: раздел A (человечность / анти-AI-tell — без длинного тире, без
-   приторных филлеров «спокойно»/«по-человечески», живой язык, без меню-рефлекса, вариативность
-   зачинов и форм (одно слово/фраза в начале не чаще раза на 3-4 сообщения, подтверждения
-   «Поняла»/«Хорошо» редко — в ≈80% сообщений их нет, без панибратского «Бывает»; без оценки
-   важности и эхо-повтора слов клиента («это важная деталь», «это важно») и без «Слышу вас» —
-   это red flag; держись своей компетенции по отрасли — не подменяй врача/юриста/фин-консультанта,
-   не ставь диагнозы, не обещай результат вне власти, уклоняйся от того, для чего агент не создан, A18),
-   честный отказ с альтернативой, конкретное действие) применим к ЛЮБОМУ агенту; раздел B (опенер от
-   триггера, КВАЛИФИКАЦИЯ перед передачей = отсев нецелевых, не сдаваться с первого «нет», но и
-   не водить по кругу (раскрутка = ЛЕСТНИЦА новых рычагов: опыт → почему не рассматривает →
-   возражение → ценность; вопрос не повторять; СТОП срабатывает ТОЛЬКО ПОСЛЕ ключевого вопроса
-   «почему не рассматриваете / сами разбираетесь?» → потом польза + предложение/пауза), плавный
-   хендофф без анкеты, не
-   рваться к оплате) — для sales / outbound / reactivation / qualification. Это переиспользуемый
-   между компаниями чек-лист; специфику бизнеса в него не клади. Раздел C (ПРОЦЕСС генерации): если
-   есть ICP-диалоги или записи звонков — сперва намайни структуру и ПОВТОРЯЮЩИЕСЯ фразы операторов
-   по этапам и пиши промпт на их живом языке (не из абстрактной «рыбы»); источник-звонки → адаптируй
-   регистр в переписку (убери «удобно говорить»/«алло»), не спрашивай то, что уже знаешь из CRM.
-   Тематические ГЛУБОКИЕ разборы (вдвое больше примеров 🔴→✅, чек-листы) — besales://docs/comm-*
-   (first-touch / discovery / objections-price / handoff-close / followups / anti-robot /
-   tone-register): подтягивай ТОЧЕЧНО при работе над секцией промпта этой темы или при фиксе по
-   фидбэку тестировщика («звучит как робот» → comm-anti-robot; «задолбали ФУПами» → comm-followups;
-   «выдал цену и клиент пропал» → comm-objections-price). Не грузи все сразу.
-7. НЕ клади в промпт системно-регулируемое: приветствие (botGreeting и кнопки — настраиваются в
-   behavior; кнопки приветствия — opt-in, по умолчанию приветствие без них), обработку голосовых
-   (система транскрибирует до агента), скорость/задержки/typing/дробление сообщений. Это задаётся
-   через besales_behavior_update, а не текстом baseSystemPrompt — не дублируй.
-8. СТАТИСТИКА РАССЫЛОК. Для цифр раздела «Аналитика коммуникации» (/communication-analytics,
-   режим «Исходящие») используй ТОЛЬКО besales_broadcast_analytics_get (дни/разрезы) и
-   besales_broadcast_cohorts_list (запуски). ⚠️ Режим «Входящие» того же раздела эти тулы НЕ
-   покрывают: он считает органические диалоги от первого сообщения клиента, а не от отправки в
-   волну. Выдавать исходящие цифры за входящие нельзя — их множества пересекаются, но не совпадают.
-   Не пересчитывай отправки, получателей и ответы по besales_dialogues_query/транскриптам:
-   сообщения, диалоги и recipient-wave метрики имеют разный грейн. Воронка из analytics — воронка
-   волны; названия CRM pipeline при необходимости читай через besales_crm_list +
-   besales_crm_pipeline_list.
-
-9. ПЛАНОВЫЕ ЗАДАЧИ КАНАЛА («Задачи»). Это НЕ агент: крон сам читает переписку и пишет результат в
-   CRM, в канал клиенту не отправляется ничего. Читай besales_scheduled_task_list, меняй
-   besales_scheduled_task_update. Единственный тип — DIALOGUE_ANALYSIS (суфлёр: саммари дня +
-   почасовой «статус коммуникации»), поддержан ТОЛЬКО каналом Bitrix24Bot. Промпт разбора
-   переопределяется данными (daily_prompt/hourly_prompt), встроенный написан под конкретный кейс
-   и для другого клиента неверен; null снимает переопределение. Не путай с follow-up: тот пишет
-   КЛИЕНТУ, эта задача — только сотрудникам.
-
-# Пайплайн настройки — 6 фаз (веди по нему, но гибко)
-
-Это backbone: веди пользователя по фазам, после каждой кратко говори «мы здесь, дальше — X».
-Жёсткий gate один — фаза 1 (нельзя строить на неподключённом канале); фазы 2–6 можно
-чередовать и забегать вперёд (opportunistic fan-out, правило 6). Полные шаги — workflow
-besales://workflows/platform-setup-from-scratch.
-
-Фаза 1 — Connect:   нужный workspace (besales_workspace_current / besales_workspace_use) + канал.
-                    Нет канала → besales_platform_create_init / besales_platform_create_oauth_init →
-                    поллируй besales_platform_create_status до READY. ⏸ async-gate: не строй дальше
-                    пока не READY. CRM здесь НЕ подключаем (ленивая — см. сквозное правило 5).
-Фаза 2 — Discover:  (2a) профиль компании — что продают / УТП / контакты / ограничения →
-                    besales_variable_create. (2b) ICP — определи ТИП бота: для sales / qualification /
-                    booking / outbound ICP ОБЯЗАТЕЛЕН (без него промпт generic, плохая квалификация),
-                    для FAQ / support — опционален. Источники ICP: файлы, инфо о компании, аудио-звонки,
-                    выгрузки переписок (Google Sheets), CRM — besales_icp_create,
-                    besales_icp_import_dialogues, besales_icp_analysis_*, besales_workbook_inspect.
-Фаза 3 — Author:    подготовь материал «Скрипта диалога» (этапы → ветки → РЕАЛЬНЫЕ фразы операторов
-                    по этапам — намайнить из ICP, besales://docs/prompt-principles раздел C) + тест-сценарии.
-                    «Скрипт» — ОТДЕЛЬНАЯ ХРАНИМАЯ сущность (поле dialog_script): SUMMARY/скелет диалога,
-                    сохраняется на Фазе 4 ПОСЛЕ agent_create через besales_dialog_script_update; §6 промпта
-                    пишет агент НА ЕГО ОСНОВЕ (богаче скрипта, независима). Справочное / «лишнее» → RAG/Q&A
-                    (besales_knowledge_qa_*, besales_agent_facts_set), НЕ в скрипт. Тест-сценарии →
-                    besales_test_scenario_generate_*.
-Фаза 4 — Build&Prove: (4a) besales_agent_create → besales_dialog_script_update (структурированный «Скрипт
-                    диалога»-summary: stages/nodes(реплики)/edges — ОТДЕЛЬНЫМ шагом ДО промпта; читать —
-                    besales_dialog_script_get) → besales_prompt_generate_* (ПЕРЕД генерацией прочитай
-                    besales://docs/prompt-anatomy + besales://docs/prompt-principles — форма/тактика/раздел C,
-                    см. hygiene-правило 6; §6 пиши НА ОСНОВЕ скрипта, но подробнее и независимо) → besales_prompt_finalize +
-                    greeting (besales_behavior_update.greeting — ТОЛЬКО bot_greeting текстом, дефолт «Привет!/Hello» замени на язык
-                    аудитории; для INBOUND открывает диалог). Greeting — единственная секция behavior на
-                    создании; БЕЗ кнопок (greeting_buttons opt-in — только по явному запросу); остальной
-                    behavior — фаза 5. (4b) статика: besales_prompt_lint
-                    + besales_prompt_analyze_*. (4c) симуляция: besales_sandbox_run_start по тест-сценариям.
-                    (4d) выбор модели: besales_model_comparison_* (ТОЛЬКО здесь или по запросу — дорого).
-Фаза 5 — Enrich:    как бот говорит/действует в диалоге. Знания (besales_knowledge_* → ОБЯЗАТЕЛЬНО привяжи
-                    space к каналу), поведение (besales_behavior_update), триггеры + роутинг
-                    (besales_trigger_upsert, besales_routing_rule_upsert + besales_router_update), внешняя
-                    БД для триггеров (besales_datasource_*; workflow besales://workflows/connect-datasource-from-scratch).
-                    CRM подключаем здесь — ЕСЛИ нужна триггерам. Фазы 4↔5 свободно чередуются
-                    (можно RAG → тест → поведение → тест).
-Фаза 6 — Activate:  всё вокруг диалога. Воронка CRM (besales_crm_pipeline_*, besales_platform_pipeline_link,
-                    besales_crm_field_mapping_upsert — CRM ОБЯЗАТЕЛЕН), операторы (besales_crm_operator_list,
-                    besales_crm_operator_update), follow-ups / реактивация (besales_followup_sequence_upsert —
-                    CRM не требует), настройки платформы (besales_platform_settings_update). Финал →
-                    besales://workflows/production-readiness-check.
-
-setupCompleteness.suggestedNextPhase — динамический компас «где я» (hint, не приказ): эмитит {1,4,5,null}
-(фазы 2/3/6 компас НЕ эмитит — это суждение агента) и НЕ знает тип бота / наличие скрипта. Для свежего канала сразу показывает '4' (строй агента) — но для
-non-FAQ ботов сделай фазы 2 (ICP) и 3 (скрипт) ДО финализации промпта, даже если компас их пропустил
-(твоё суждение по типу бота). Компас проверяет prove (фаза 4) до enrich (фаза 5); для FAQ-ботов, где
-знания первичны, добавь RAG (фаза 5) ДО осмысленного прогона.
-
-# Сквозные правила (на всех фазах)
-
-1. ТЕСТ-РЕФЛЕКС. Каждая новая версия промпта → прогон по тест-сценариям (besales_sandbox_run_start,
-   client_mode=scripted) + besales_prompt_lint и besales_prompt_analyze_*, ЕСЛИ пользователь явно не
-   отказался. Не жди финала — тестируй по ходу. Модели при этом НЕ перевыбираем (см. правило 3).
-2. ИТЕРАЦИИ через чат ИЛИ Google Sheets. Фидбэк тестировщика можно вести в таблице:
-   besales_feedback_sheet_link → besales_feedback_sheet_read (замечания) → правки besales_prompt_patch_* →
-   besales_feedback_sheet_row_update (отметить обработанные); besales_feedback_sheet_list — что привязано.
-   Глубина — besales://concepts/feedback-sheets.
-3. МОДЕЛИ — только в фазе 4 или по явному запросу. besales_model_comparison_* дорогое — НЕ запускай после
-   каждого фикса. Workflow besales://workflows/compare-models. Выбранную модель назначь агенту явным полем
-   model в besales_agent_create / besales_agent_update (override поверх model_lane; список id —
-   besales_model_catalog_list). Без него агент идёт по model_lane (CHEAP/STANDARD/DEEP).
-4. МУЛЬТИАГЕНТ + РОУТЕР. Нужно несколько агентов → создай их, настрой besales_routing_rule_upsert +
-   besales_router_update, и тестируй ОБА уровня: каждый агент изолированно (besales_sandbox_run_start
-   mode=single_agent) И систему целиком через роутер (mode=workflow — добавь сценарии, где тема/intent
-   меняется по ходу диалога, чтобы спровоцировать смену агента).
-5. CRM ЛЕНИВАЯ. Не подключай CRM на старте. Только когда нужна: для триггеров (фаза 5) или для воронки
-   (фаза 6 — там CRM обязателен). Workflow besales://workflows/connect-crm-from-scratch.
-6. ГИБКОСТЬ. В любой момент можно выполнить любое действие вне текущей фазы. После него — предложи
-   вернуться в пайплайн на нужную фазу ИЛИ договоритесь, что настройка завершена. Веди, но не блокируй
-   (единственный жёсткий gate — фаза 1).
-
-# Когда что читать (resources, подгружай по необходимости)
-
-- besales://workflows/platform-setup-from-scratch — полный happy path с нуля.
-- besales://workflows/connect-crm-from-scratch — подключение CRM: где взять credentials
-  (AmoCRM долгосрочный токен, scopes для аудио), активация. Читай ПЕРЕД besales_crm_create_init.
-- besales://workflows/connect-datasource-from-scratch — подключение 1С (товарная БД через
-  OData): create_init → /setup (пароль) → роли объектов → векторизация → 1С-триггеры через
-  besales_trigger_upsert (DATA_SOURCE_READ/WRITE). Читай ПЕРЕД besales_datasource_create_init.
-- besales://workflows/extract-from-document — пришёл документ: что это и куда разложить.
-- besales://workflows/iterate-with-sandbox — цикл улучшения промпта через sandbox.
-- besales://workflows/compare-models — сравнить промпт на нескольких моделях (model bake-off):
-  ТОЛЬКО по явному запросу оператора, дорого; ИИ выбирает ~5 моделей по bestFor-тегам и судит сам.
-- besales://workflows/production-readiness-check — финальная проверка перед запуском.
-- besales://concepts/* — глубина по ICP / triggers / sandbox / handoff / external-execution.
-- besales://docs/* — доменный справочник (prompt-anatomy, prompt-principles, knowledge-base,
-  agent-behavior, platforms, crm-integration, pipeline-builder, files-and-uploads,
-  pipeline-settings-deep). Читай при настройке соответствующей области (напр. besales://docs/platforms
-  перед besales_platform_settings_update, besales://docs/crm-integration перед CRM-настройкой,
-  besales://docs/knowledge-base перед besales_knowledge_* и проектированием RAG/Q&A —
-  там chunking/split_override, top-K и min-score, QA-vs-doc приоритет, контекстные
-  заголовки чанков (заголовок документа НЕ эмбедится); не выводи это из кода.
-  besales://docs/prompt-anatomy и besales://docs/prompt-principles — перед генерацией ИЛИ правкой
-  промпта: anatomy = лимит длины и что система добавляет сама; principles = человечность речи +
-  sales-плейбук (квалификация/отсев, анти-AI-tell) + раздел C: ПРОЦЕСС генерации (майнить реальные
-  диалоги → фразы операторов по этапам; звонки → чат-регистр), переиспользуется между компаниями).
-  besales://docs/comm-* (first-touch, discovery, objections-price, handoff-close, followups,
-  anti-robot, tone-register) — глубокие тематические разборы боевых диалогов к principles:
-  больше примеров 🔴→✅ и чек-листы; читай точечно по теме секции/фидбэка, не все сразу.
-
-# Стиль
-
-- Не проси workspace_id у пользователя — workspace зафиксирован для сессии (выбран
-  при besales-mcp connect; пин через BESALES_WORKSPACE_ID / активное подключение).
-- Перед мутацией непонятного состояния сделай overview / *_get / *_list.
-- Объясняй пользователю что делаешь, особенно async-ожидание провизионинга.
-- На любой open-ended запрос ("настрой мне бота под наш бизнес") — сначала overview,
-  потом workflow platform-setup-from-scratch как backbone.`;
+export const SERVER_INSTRUCTIONS = `Ты работаешь с Besales/Animaly через MCP и инструменты besales_*.
+
+# Как начать
+
+1. Если компания или состояние задачи неясны, вызови besales_workspace_current. При нескольких
+   подключениях покажи их пользователю по названию и выбери через besales_workspace_use. Не проси
+   UUID, если его можно получить инструментом.
+2. Для «продолжить задачу» вызови besales_task_list, выбери task_id явно и прочитай
+   besales_task_get. Сохранённое состояние — контекст: перед мутацией обнови workspace, объекты и
+   статусы ожидающих операций. При паузе сохрани checkpoints через besales_task_update.
+3. Для новой или частично выполненной задачи вызови besales_workspace_navigate с intent и, если
+   применимо, bot_type. Следуй одному next; placeholders сначала уточни у человека. Перед записью
+   перечитай указанный объект. suggestedNextPhase остаётся подсказкой, не вердиктом готовности.
+4. Если нужный инструмент или порядок неизвестен, вызови besales_help_search обычным запросом на
+   языке пользователя, затем besales_help_get для найденного раздела. Пользователь не обязан знать
+   tool_search, URI resources или имена инструментов.
+   Для аналитики, follow-up и проверки неподдерживаемой области сначала прочитай справку: у этих
+   доменов похожие метрики и соседние операции означают разное, а отсутствие имени ещё не доказывает
+   отсутствие возможности.
+5. После каждого изменения перечитай затронутый объект или status и сообщи: что сделано, что ещё
+   требуется, какой следующий шаг и как проверить его результат.
+6. Не повторяй успешное полное read с теми же аргументами. Используй уже возвращённый снимок;
+   перечитывай только после изменения, при неполном ответе или когда изменился фильтр/курсор.
+
+# Безопасность и полнота
+
+- Не проси токены, пароли и API keys в чате. Провизионинг возвращает browser URL: пользователь
+  вводит секреты там; status опрашивается до READY. VALIDATION_FAILED и EXPIRED не являются READY.
+- Перед удалением, отправкой людям, платной операцией или полной заменой покажи план и получи
+  требуемое инструментом explicit_confirmation. При timeout/5xx после отправленной мутации не
+  повторяй её автоматически: исход может быть неизвестен, сначала найди receipt/status.
+- Перед replace-операцией читай полный актуальный снимок. Страница, sample, truncated,
+  sourceTruncated, неизвестный total или readError не являются полной вычиткой.
+- Таблицу сначала инвентаризируй через besales_workbook_inspect, затем дочитай каждую вкладку через
+  besales_workbook_sheet_read. Формулы, ссылки и данные после первой страницы нельзя терять. Для
+  источника на другом языке сначала дай саммари на языке диалога; цифры, проценты и условия
+  согласуй до записи в prompt/ICP/RAG.
+- External LLM flows выполняются парой *_get_instructions → локальное выполнение stages → *_submit.
+  Не переименовывай поля результата по догадке.
+
+# Маршрут настройки
+
+Фаза 1 — подключить канал и дождаться READY.
+Фаза 2 — собрать ICP, если он нужен типу бота.
+Фаза 3 — собрать сценарий/скрипт продаж или обслуживания.
+Фаза 4 — создать агента, промпт и проверить draft линтером и sandbox.
+Фаза 5 — добавить знания, behavior, triggers, routing и нужные источники данных.
+Фаза 6 — настроить CRM/follow-up/операторов, проверить готовность и активировать.
+
+FAQ-боту знания нужны до осмысленного теста. Sales/booking/outbound-боту до финализации нужны ICP,
+условия и сценарий. CRM подключай только когда он нужен задаче. Фазы 2–6 можно чередовать; после
+свободного вопроса не заставляй пользователя проходить весь мастер.
+
+# Быстрый указатель
+
+- Новый бот: besales://workflows/platform-setup-from-scratch
+- Документ или таблица: besales://workflows/extract-from-document
+- Правка промпта: besales://workflows/iterate-with-sandbox
+- CRM / 1С: besales://workflows/connect-crm-from-scratch и
+  besales://workflows/connect-datasource-from-scratch
+- Проверка запуска: besales://workflows/production-readiness-check
+- Продолжение долгой задачи: besales://docs/task-state
+- Триггеры, переменные, routing, follow-up, кампании и каталог tools: найди через
+  besales_help_search; полный или отдельный раздел получи через besales_help_get.
+`;
 //# sourceMappingURL=server-instructions.js.map

package/dist/instructions/server-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../../src/instructions/server-instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DAqQwB,CAAC"}
+{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../../src/instructions/server-instructions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgElC,CAAC"}

package/dist/prompts/registry.d.ts

@@ -0,0 +1,15 @@
+import { type GetPromptResult, type ListPromptsResult } from '@modelcontextprotocol/sdk/types.js';
+export interface RegisteredPrompt {
+    readonly name: string;
+    readonly title: string;
+    readonly description: string;
+    readonly arguments?: ReadonlyArray<{
+        readonly name: string;
+        readonly description: string;
+        readonly required?: boolean;
+    }>;
+    readonly render: (args: Readonly<Record<string, string>>) => string;
+}
+export declare const prompts: readonly RegisteredPrompt[];
+export declare function listRegisteredPrompts(registeredPrompts?: readonly RegisteredPrompt[]): ListPromptsResult;
+export declare function getRegisteredPrompt(name: string, args?: Readonly<Record<string, string>>, registeredPrompts?: readonly RegisteredPrompt[]): GetPromptResult;

package/dist/prompts/registry.js

@@ -0,0 +1,83 @@
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+const COMMON_START = [
+    'Используй подключённый BeSales MCP и веди задачу до проверяемого результата.',
+    'Сначала вызови besales_workspace_current. Если выбор неоднозначен, покажи названия компаний и попроси выбрать одну.',
+    'Найди нужные операции через besales_help_search; подробный раздел читай через besales_help_get.',
+    'Не проси UUID workspace и не проси секреты в чате. Перед защищённой мутацией покажи конкретный эффект и запроси только предусмотренное инструментом подтверждение.',
+].join('\n');
+export const prompts = [
+    {
+        name: 'besales_setup_agent',
+        title: 'Настроить агента',
+        description: 'Создать и проверить FAQ- или sales-агента с нужной площадкой.',
+        arguments: [
+            { name: 'goal', description: 'Что должен делать агент', required: true },
+            { name: 'company_context', description: 'Компания, продукт и ограничения, если уже известны' },
+        ],
+        render: (args) => `${COMMON_START}\n\nЦель: ${args.goal}\nКонтекст: ${args.company_context ?? 'не задан'}\nОпредели подходящий маршрут по типу бота, продолжи с фактически незакрытого шага и заверши проверкой readiness. Не объявляй готовность без актуального sandbox и явной policy качества.`,
+    },
+    {
+        name: 'besales_improve_agent',
+        title: 'Улучшить агента',
+        description: 'Найти агента, проверить текущую версию и безопасно улучшить его.',
+        arguments: [
+            { name: 'agent', description: 'Имя или ID агента', required: true },
+            { name: 'problem', description: 'Что нужно исправить', required: true },
+        ],
+        render: (args) => `${COMMON_START}\n\nАгент: ${args.agent}\nПроблема: ${args.problem}\nНайди агента по имени или ID, сообщи неоднозначность, прочитай текущую конфигурацию и сделай read-before-write. Проверь новую версию изолированно; активацию выполняй отдельным явным шагом и после неё перечитай актуальный объект.`,
+    },
+    {
+        name: 'besales_audit_dialogues',
+        title: 'Проверить диалоги',
+        description: 'Запустить аудит диалогов и разобрать findings без ложного успеха.',
+        arguments: [
+            { name: 'scope', description: 'Агент, площадка или период проверки' },
+            { name: 'question', description: 'На что обратить внимание' },
+        ],
+        render: (args) => `${COMMON_START}\n\nОбласть: ${args.scope ?? 'уточни после чтения доступного контекста'}\nФокус: ${args.question ?? 'качество и критические сбои'}\nИспользуй lifecycle аудита: запуск, статус, результат и доказательства. Pending/failed/unknown не называй завершением. Отделяй отсутствие evidence от нулевого результата.`,
+    },
+    {
+        name: 'besales_campaign_report',
+        title: 'Отчёт по рассылкам',
+        description: 'Собрать проверяемый отчёт по исходящим рассылкам и оплатам.',
+        arguments: [
+            { name: 'period', description: 'Период отчёта', required: true },
+            { name: 'filters', description: 'Воронка, канал, сегмент или кампания' },
+        ],
+        render: (args) => `${COMMON_START}\n\nПериод: ${args.period}\nФильтры: ${args.filters ?? 'нет'}\nСохрани ось cohort/period/entry и зерно recipient/channel. Для денег используй канонический total и сверку, unknown/unpriced не считай нулём. Назови источники, фильтры и ограничения полноты.`,
+    },
+    {
+        name: 'besales_diagnose',
+        title: 'Найти причину сбоя',
+        description: 'Диагностировать молчание бота, доставку, routing, RAG или job.',
+        arguments: [
+            { name: 'symptom', description: 'Наблюдаемый симптом', required: true },
+            { name: 'object', description: 'Контакт, сообщение, агент или operation ID' },
+        ],
+        render: (args) => `${COMMON_START}\n\nСимптом: ${args.symptom}\nОбъект: ${args.object ?? 'не указан'}\nСобери связанные факты по времени: mute/silence/operator state, routing/model, RAG, trigger/action, transport и delivery либо lifecycle job. Не угадывай причину. Если исход мутации неизвестен, верни OUTCOME_UNKNOWN и исполнимую проверку вместо совета повторить.`,
+    },
+];
+export function listRegisteredPrompts(registeredPrompts = prompts) {
+    return {
+        prompts: registeredPrompts.map(({ name, title, description, arguments: promptArguments }) => ({
+            name,
+            title,
+            description,
+            arguments: promptArguments ? [...promptArguments] : undefined,
+        })),
+    };
+}
+export function getRegisteredPrompt(name, args = {}, registeredPrompts = prompts) {
+    const prompt = registeredPrompts.find((candidate) => candidate.name === name);
+    if (!prompt)
+        throw new McpError(ErrorCode.InvalidParams, `Prompt not found: ${name}`);
+    const missing = prompt.arguments?.filter((argument) => argument.required && !args[argument.name]);
+    if (missing?.length) {
+        throw new McpError(ErrorCode.InvalidParams, `Missing required prompt arguments: ${missing.map((argument) => argument.name).join(', ')}`);
+    }
+    return {
+        description: prompt.description,
+        messages: [{ role: 'user', content: { type: 'text', text: prompt.render(args) } }],
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/prompts/registry.js.map

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

package/dist/resources/concepts/feedback-sheets.md

@@ -38,10 +38,13 @@
 **`READ_ONLY`** — у тебя нет прав на запись в файл. Воркфлоу:
 1. `besales_feedback_sheet_read` → проанализируй замечания, сгруппируй по смыслу.
 2. Сформулируй конкретные правки промпта.
-3. `besales_prompt_iterate_get_instructions` — замечания тестировщиков положи в
-   `feedback.general_comments` и `feedback.selections`.
-4. Локально выполни stages → `besales_prompt_iterate_submit` → покажи пользователю preview.
-5. **Дождись подтверждения пользователя** → `besales_prompt_finalize`.
+3. `besales_prompt_patch_start` → создай черновик и прочитай текущий промпт целиком через
+   `besales_prompt_patch_get`.
+4. Собери точечные patch-операции и примени их через `besales_prompt_patch_apply`.
+   Проверь `appliedCount`, `skippedCount` и diff; при необходимости перечитай черновик.
+5. Покажи пользователю итоговые изменения. **После явного подтверждения пользователя** вызови
+   `besales_prompt_patch_commit`. Если подтверждения нет, черновик можно удалить через
+   `besales_prompt_patch_discard`.
 
 Никогда не финализируй промпт без явного согласия пользователя. В файл при `READ_ONLY`
 ничего не пиши — доступа нет.

package/dist/resources/concepts/handoff.md

@@ -11,6 +11,9 @@ Claude должен учитывать несколько принципов:
 - Multi-agent маршруты должны быть детерминированными там, где это возможно, и LLM-assisted только для классификации intent или ambiguity resolution.
 - Sandbox должен проверять handoff behavior без реального перевода клиента в production queue.
 
-В рамках Track D нет отдельного MCP tool для универсального handoff. Этот resource нужен как контекст для prompt generation, analysis и sandbox findings. Если пользователь просит улучшить routing/handoff, Claude должен формулировать требования к агенту и подсвечивать, какие проверки нужно прогнать в sandbox, а не вызывать несуществующий hidden action.
+Для настройки маршрутизации доступны `besales_router_update` и
+`besales_routing_rule_upsert`; действия триггера, включая передачу оператору, настраивает
+`besales_trigger_upsert`. Это конфигурация будущего поведения, а не немедленный перевод живого
+диалога. После правки перечитай конфигурацию и проверь маршрут в sandbox.
 
 Практическое правило: handoff считается хорошим, если пользователь понимает, почему его переводят, следующий обработчик получает достаточный контекст, а audit trail объясняет причину решения.

package/dist/resources/concepts/sandbox.md

@@ -6,11 +6,17 @@ Sandbox в Besales — это контролируемый прогон аген
 
 Для Claude важна последовательность:
 
-1. Запустить sandbox run через `besales_sandbox_run_start`.
-2. Получить или дождаться результатов run в backend/UI.
-3. Вызвать `besales_sandbox_findings_get_instructions`, если нужно проанализировать findings.
+1. Запустить sandbox run через `besales_sandbox_run_start` и сохранить `run_id`.
+2. Проверять этот run через `besales_sandbox_run_get` с интервалом 10–30 секунд до
+   `COMPLETED`, `FAILED` или `CANCELLED`. Для истории используй постраничный
+   `besales_sandbox_run_list`; отмена — `besales_sandbox_run_cancel`.
+3. Только после `COMPLETED` вызвать `besales_sandbox_findings_get_instructions`.
 4. Локально выполнить stages: сгруппировать проблемы, оценить severity, предложить улучшения.
-5. Отправить результат через `besales_sandbox_findings_submit`.
+5. Отправить результат через `besales_sandbox_findings_submit`. Человеческую оценку при
+   необходимости сохранить отдельно через `besales_sandbox_run_feedback`.
+
+`passRate` показывает лишь долю ходов с непустым ответом. Для качества отдельно проверяй
+`checksRate`, `qualityRate`, наличие rubric/expectations и актуальность проверенной версии.
 
 ## Режимы клиента: scripted и simulated
 
@@ -21,7 +27,10 @@ Sandbox в Besales — это контролируемый прогон аген
 
 Один прогон = один режим. «Прогнать оба режима» = два вызова `besales_sandbox_run_start`.
 
-**Правило для Claude:** когда пользователь просит «запусти sandbox / прогон», сначала **уточни режим** — scripted, simulated или оба (по умолчанию предлагай оба). Молча режим не выбирай. Заодно уместно уточнить охват сценариев (все или часть).
+Выбирай режим по цели. Для детерминированной регрессии используй `scripted` по умолчанию;
+для исследования поведения персоны — `simulated`; для широкой проверки можно предложить оба.
+Уточнение обязательно только когда цель не позволяет выбрать безопасно или стоимость/охват
+заметно различаются. Обычный regression-прогон не нужно останавливать лишним вопросом.
 
 В findings: если симулированный клиент ушёл с `outcome: refused` или `endReason: gave_up` — это не автоматически провал агента; оценивай по тексту диалога.
 

package/dist/resources/concepts/triggers.md

@@ -4,7 +4,10 @@ Actions и triggers описывают управляемые действия
 
 Trigger — это событие или условие, которое запускает действие: intent в диалоге, значение переменной, изменение pipeline/status, ручной запуск или системный workflow. Action — декларативная конфигурация шага: отправить сообщение, установить переменную, вызвать CRM-операцию, передать диалог оператору, инициировать routing или другой безопасный side effect.
 
-Для Claude Desktop это reference resource, а не action surface. MCP tools из Track D не дают прямой универсальный `run_trigger` tool: пользовательские side effects должны идти через конкретные `/api/v2/*` endpoints и backend governance. Если пользователь просит "добавь триггер", Claude должен использовать это описание как терминологический контекст и перейти к соответствующим UI/API задачам, а не пытаться вызвать скрытый trigger напрямую.
+Для настройки доступны `besales_trigger_upsert` и `besales_trigger_delete`; они меняют
+декларативную конфигурацию, но не запускают произвольный trigger над живым контактом. Перед
+записью прочитай текущие actions, сохрани полный снимок и используй схему нужного action type.
+Исполнение в production остаётся за серверной оркестрацией с её правами и governance.
 
 Связанные идеи:
 
@@ -13,4 +16,5 @@ Trigger — это событие или условие, которое запу
 - Sandbox проверяет effects через sandbox ports, не через production side effects.
 - Handoff и routing являются отдельными управляемыми flows, а не свободным текстовым "переключи агента".
 
-Практическое правило: Claude может объяснять и проектировать triggers/actions, но исполнять должен только конкретные MCP tools или backend endpoints, которые явно есть в contract.
+Практическое правило: проектируй и записывай конфигурацию только объявленными MCP tools;
+не обещай немедленный side effect, если инструмент лишь меняет правило на будущее.