@besales/mcp 0.37.0 → 0.38.0

package/dist/resources/docs/agent-behavior.md

@@ -205,7 +205,7 @@
 
 | Поле | Дефолт | Описание |
 |---|---|---|
-| `botWaitingReturn` | 3 | Сколько часов бот молчит после сообщения оператора. Допустимые: `0`, `1`, `3`, `6`, `12`, `24`. `0` = до команды `/start`. |
+| `botWaitingReturn` | 3 | Сколько часов бот молчит после сообщения оператора. Допустимые: `-1`, `0`, `1`, `3`, `6`, `12`, `24`. `-1` = ответ оператора вообще не отключает бота, `0` = до команды `/start`. |
 | `followUpWaitingReturn` | -1 | На сколько часов отключить follow-up после оператора. `-1` = не отключать, `0` = навсегда, `1`–`24` — часы. |
 | `skipTaskCreationOnCallOperator` | false | Если `true` — при `call_operator` система **только** меняет ответственного на оператора, без постановки задачи в CRM. Полезно, когда workflow в CRM ведётся через статусы воронки, а не через task'ы, и лишние «висящие» задачи на оператора засоряют его список дел. |
 | `anonymizationEnabled` | false | Обратимая PII-анонимизация LLM-пайплайна (per-platform). Если `true` — реальные имя/телефон/email клиента вырезаются из сообщений перед отправкой в LLM (заменяются токенами) и подставляются обратно в ответе и в аргументах tool-call (например, поля CRM). Ставится через секцию `privacy: { anonymization_enabled }` в `besales_behavior_update`. |
@@ -237,17 +237,18 @@
 | `PROCESS_WITH_LLM` | Запустить vision-модель (gpt-4.1-mini) и интерпретировать изображение в текст для LLM. |
 | `FIXED_RESPONSE` | Отправить фиксированный текст из `imageFixedResponseText`. |
 
-`PROCESS_WITH_LLM` для изображений запускает vision-модель. Для **видео** `PROCESS_WITH_LLM` обрабатывает **подпись (caption)** как обычный текст через LLM — само видео в модель не отправляется; нет подписи → вызывается оператор; работает на Telegram Bot/Personal, Wazzup, VK, Bitrix24Bot, Salebot, GetCourse (на Avito/Instagram видео → оператор). Для документов/аудио — только `SILENT` или `FIXED_RESPONSE`.
+`PROCESS_WITH_LLM` есть у трёх типов из четырёх, и механика у каждого СВОЯ: изображение уходит в vision-модель; у **видео** обрабатывается **подпись (caption)** как обычный текст (само видео не отправляется, нет подписи → оператор; Telegram Bot/Personal, Wazzup, VK, Bitrix24Bot, Salebot, GetCourse — на Avito/Instagram видео → оператор); у **документа** обрабатывается **извлечённый текст файла** (сам файл не отправляется). У **аудио** этого значения нет вовсе — только `SILENT` или `FIXED_RESPONSE`.
 
 ### Видео / Документы / Аудио (`VideoHandlingBehavior`, `DocumentHandlingBehavior`, `AudioHandlingBehavior`)
 
-`DocumentHandlingBehavior` и `AudioHandlingBehavior` имеют значения `SILENT` / `FIXED_RESPONSE`. `VideoHandlingBehavior` дополнительно поддерживает `PROCESS_WITH_LLM`:
+`AudioHandlingBehavior` имеет только `SILENT` / `FIXED_RESPONSE`. `VideoHandlingBehavior` и `DocumentHandlingBehavior` дополнительно поддерживают `PROCESS_WITH_LLM`:
 
 | Значение | Что делает |
 |---|---|
 | `SILENT` | Промолчать (default). |
 | `FIXED_RESPONSE` | Отправить фиксированный текст из соответствующего `*FixedResponseText`. |
-| `PROCESS_WITH_LLM` *(только video)* | Обработать **подпись** видео как текст через LLM (само видео не отправляется; нет подписи → оператор; Telegram/Wazzup/VK/Bitrix24/Salebot/GetCourse, кроме Avito/Instagram). |
+| `PROCESS_WITH_LLM` *(video)* | Обработать **подпись** видео как текст через LLM (само видео не отправляется; нет подписи → оператор; Telegram/Wazzup/VK/Bitrix24/Salebot/GetCourse, кроме Avito/Instagram). |
+| `PROCESS_WITH_LLM` *(document)* | Извлечь текст файла (PDF, DOCX, DOC, XLSX, XLS, CSV, TSV, TXT, MD) и обработать как обычное сообщение. Сам файл в модель не отправляется. Длинный документ передаётся не целиком — модель предупреждается об усечении. Скан без текстового слоя, неподдерживаемый формат и файл >20 МБ → оператор. На Avito документ приходит голой ссылкой: без расширения в ней разбор невозможен → оператор. |
 
 ```json
 {
@@ -376,11 +377,12 @@
 | `messageOpenDelay` только для Telegram Personal | На обычных Telegram Bot ничего не даёт. |
 | `messageDevide=true` без `messageChunkSeparator` | Не работает — нужен явный разделитель. |
 | LLM должен знать про `messageChunkSeparator` | Если включаете `messageDevide`, добавьте в `baseSystemPrompt` инструкцию: «Когда нужно разделить ответ на части, ставь между частями `%%%`». |
-| `imageHandlingBehavior=PROCESS_WITH_LLM` | Только для изображений (vision). Для видео/доков/аудио — `SILENT` или `FIXED_RESPONSE`. |
+| `audioHandlingBehavior=PROCESS_WITH_LLM` | Такого значения нет — только `SILENT` или `FIXED_RESPONSE`, иначе 400. У image/video/document разбор есть, но механика у каждого своя (vision / подпись / текст файла). |
 | `urlHandlingBehavior=PROCESS_WITH_CRAWLER` | Может тормозить (внешний запрос). Не включать массово. |
 | `messageFilters` — до 20 правил | Применяются по `order`. |
 | `greetingButtons` — до 10 кнопок | Платформенный лимит. |
 | `botWaitingReturn=0` | Бот не вернётся автоматически — нужно явное `/start` от оператора. |
+| `botWaitingReturn=-1` | Бот отвечает поверх оператора — берут в суфлёрских/квалификационных каналах. Стадию CRM «оператор перехватил» настройка НЕ отменяет: если у этой стадии выключен `isBotActive`, бот всё равно замолчит по стадийному гейту. |
 | `operatorSchedule.enabled=false` | Оператор «всегда доступен» — не блокировать `call_operator`. |
 | `aiErrorTargetStageId=null` | Не критично — система переведёт на первый этап. |
 | `skipTaskCreationOnCallOperator=true` | Только смена ответственного, без постановки задачи в CRM (для AmoCRM/Bitrix24). |

package/dist/resources/docs/platforms.md

@@ -313,7 +313,11 @@ Salebot сам подключает Telegram/VK/WhatsApp/etc. Animaly через
 
 **Особенности:**
 - Real-time через **Socket.IO** (не webhook).
-- `webWidgetShowPageInfo=true` — добавляет в промпт URL текущей страницы.
+- `webWidgetShowPageInfo` (**default `false`**, opt-in) — добавляет в системный промпт блок
+  «Контекст страницы»: URL, заголовок и meta description страницы, на которой находится
+  посетитель. Работает **только для RAG-агентов** — у SIMPLE- и QA-шаблонов этого блока нет.
+  Вложения (файлы, скриншоты) приходят без контекста страницы. Значения санируются: пробелы
+  схлопываются, длина режется (url 512 / title 200 / description 400 символов).
 - `webWidgetMarketingFieldMappings` — UTM/yaClientId/gaClientId автоматически отправляются в CRM-поля.
 - Push-кампании **не поддерживаются** (нет инициатора со стороны бота).
 - Особая логика follow-up через `webWidgetLastSeenAt` (см. [`08-follow-up.md`](08-follow-up.md)).

package/dist/resources/docs/prompt-anatomy.md

@@ -188,7 +188,7 @@ AI-сервис генерирует только **`baseSystemPrompt`**. Всё
 Доступные инструменты:                             ← LLM получает их через tools API
 - call_operator(reason)
 - handle_want_buy(productOrService, intent)
-- save_user_info(firstName, lastName, ...)
+- save_user_info(name, surname, city, insight)
 
 Если клиент сказал «хочу купить» — вызови           ← триггеры подставляются отдельно
 run_trigger с triggerId="abc-123".
@@ -224,11 +224,11 @@ run_trigger с triggerId="abc-123".
 
 | Параметр | Значение |
 |---|---|
-| Максимальная длина одного промпта | 60 000 символов (`PROMPT_LIMITS.MAX_PROMPT_LENGTH`) |
+| Максимальная длина одного промпта | 80 000 символов (`PROMPT_LIMITS.MAX_PROMPT_LENGTH`) |
 | Максимум триггеров в промпте | 50 |
 | Максимум длины условия триггера | 500 символов |
 
-За длиной `baseSystemPrompt` следит `PromptLintService`: **warn** при превышении **25 000** символов (`PROMPT_LIMITS.SOFT_PROMPT_LENGTH`) и **hard_fail** (блокирует `prompt_finalize` / `prompt_patch_commit`) при превышении **60 000** (`PROMPT_LIMITS.MAX_PROMPT_LENGTH`). Держи `baseSystemPrompt` компактным — ориентир **20 000–25 000 символов**, вынося факты в Базу знаний (документы / Q&A), чтобы оставить место под системные блоки, RAG-контекст и историю.
+За длиной `baseSystemPrompt` следит `PromptLintService`: **warn** при превышении **40 000** символов (`PROMPT_LIMITS.SOFT_PROMPT_LENGTH`) и **hard_fail** (блокирует `prompt_finalize` / `prompt_patch_commit`) при превышении **80 000** (`PROMPT_LIMITS.MAX_PROMPT_LENGTH`). Держи `baseSystemPrompt` компактным — ориентир **30 000–40 000 символов**, вынося факты в Базу знаний (документы / Q&A), чтобы оставить место под системные блоки, RAG-контекст и историю.
 
 ## 12. factualContext — активные факты агента
 
@@ -255,7 +255,7 @@ run_trigger с triggerId="abc-123".
 | `runtime_banned_term` | Агент в run-time произнёс §9-запрещённый термин (только post-run, не на prompt-level) | `hard_fail` | Transcript-lint в sandbox |
 | `agent_banned_term` | Терм из per-agent feedback sheet (`AgentFeedbackSheetLink` → §07 Google Sheets) | `warn` | Prompt-finalize, transcript-lint |
 | `scope_consistency` | Тон/branches противоречат `AgentChat.agentScope` (S4.12). Например, sale-агент пишет «я не могу помочь с покупкой». Regex-based | `warn` | Prompt-finalize |
-| `prompt_length` | Длина `baseSystemPrompt`: warn при > 25 000 символов, hard_fail при > 60 000 (`PROMPT_LIMITS`) | `warn` / `hard_fail` | Prompt-finalize |
+| `prompt_length` | Длина `baseSystemPrompt`: warn при > 40 000 символов, hard_fail при > 80 000 (`PROMPT_LIMITS`) | `warn` / `hard_fail` | Prompt-finalize |
 
 ### 13.2. Severity-семантика
 

package/dist/resources/docs/prompt-principles.md

@@ -49,9 +49,28 @@
 - ❌ «по теме сосуды», «осуществляется приём заявок», «в рамках программы»
 - ✅ «про сосуды», «заявки принимаем», «в программе»
 
-**A4. Имена и бренд — на языке клиента.** Латиница в русском тексте читается как робот.
-- ❌ «помощница из Ksamata»
-- ✅ «помощница из Ксамата» (домены/URL вроде `site.ru` — исключение, их не переводим)
+**A4. Только язык клиента — и в именах, и в обычных словах.** Латиница в русском тексте читается
+как робот. Два разных случая, и второй опаснее, потому что его не ловит инструкция «отвечай на
+языке клиента»: ответ формально на русском, модель считает это не сменой языка, а выбором точного
+слова.
+- ❌ «помощница из Ksamata» → ✅ «помощница из Ксамата» (имя/бренд)
+- ❌ «куратор поддерживает в переписке **throughout** обучение» (реальный прод-случай 06.08.26)
+  → ✅ «куратор на связи в переписке всё время обучения»
+
+Запрет на ЛЮБУЮ английскую вставку внутри фразы, даже когда она точнее: `throughout`, `however`,
+`actually`, `basically`, `workflow`, `follow-up`, `mindset`, `check-in`. Механизм всегда один: у
+слова нет однословного русского аналога, и модель тянется к компактности. Нет короткого аналога —
+пиши длиннее обычными словами.
+
+Туда же калька терминами вместо простых слов: ❌ «экспертиза», «локация», «коммуницировать» →
+✅ «опыт», «место», «расскажу». На аудитории 50+ это тот же эффект, что латиница.
+
+Исключения обязательно называть в промпте явно, иначе агент начнёт переводить сервисы и ломать
+ссылки: названия сервисов и банков, которые так и пишутся (Telegram, WhatsApp), домены и URL.
+
+Проверять глазами бесполезно — одно слово в середине абзаца взгляд пропускает (так прод-случай и
+доехал до заказчика). Гони по репликам агента поиск латиницы, вычитай ссылки и названия сервисов,
+остаток должен быть пуст.
 
 **A5. Не повторяй уже сказанное.** Если ты уже описал состав/факт или задал вопрос — не описывай
 блоки снова и не задавай тот же вопрос второй раз. Каждое сообщение двигает диалог НОВЫМ шагом.