@besales/mcp 0.33.0 → 0.37.1

package/README.md

@@ -132,11 +132,22 @@ Workspace selection precedence, per tool call:
 2. an explicit `workspace_id` argument (only when the env var is not set).
 3. the session binding set by the `besales_workspace_use` tool (in-memory, this
    session/process only — see below).
-4. the global active workspace set by `besales-mcp use <id>`.
-5. the only connected workspace (error if several are connected and none chosen).
-
-`active` is global across all env-less sessions, and `BESALES_WORKSPACE_ID`
-always overrides it. Get workspace ids from `besales-mcp connections`.
+4. the only connected workspace.
+5. otherwise the call is refused — several workspaces are connected and none was
+   chosen.
+
+**The global `active` workspace is not an implicit fallback.** It is set on the
+very first `connect` and never revisited, so using it silently would send calls
+to whichever workspace you happened to connect first — returning another
+workspace's data with no error at all. When several workspaces are connected and
+nothing above selects one, the call fails closed; the error names the current
+`active` so you can pass it explicitly if that is what you meant. With exactly
+one connection nothing changes. `besales_workspace_current` reports
+`source: "ambiguous"` and `workspace_id: null` in the same situation, so the
+diagnostic never claims a binding the real call would not use.
+
+`BESALES_WORKSPACE_ID` always overrides everything. Get workspace ids from
+`besales-mcp connections`.
 
 ### GUI hosts without per-session env (e.g. Claude Desktop)
 
@@ -279,7 +290,7 @@ connect each once and pin sessions via `BESALES_WORKSPACE_ID` (or switch the
 global default with `besales-mcp use <id>`) — see
 [Multiple Workspaces](#multiple-workspaces).
 
-## Available tools (160 tools by category)
+## Available tools (169 tools by category)
 
 Counts are derived from `src/schemas/mcp-tools.json` (`summary.tools_by_category`)
 and asserted in `src/tools/registry.spec.ts`:
@@ -288,7 +299,7 @@ and asserted in `src/tools/registry.spec.ts`:
 |---|---|---|
 | ICP (profiles, dialogue import, analysis) | 5 | incl. `besales_icp_analysis_*` external pair |
 | ICP — read (profile / segments / scenarios / samples) | 4 | `besales_icp_list` / `_get` / `_scenarios_list` / `_sample_messages` (read-only over existing GET `/api/v2/icp/*`) |
-| Prompt generation / analysis / lint / patch sessions | 13 | `besales_prompt_*`, `besales_qa_generation_*` external pairs |
+| Prompt generation / analysis / lint / patch sessions | 18 | `besales_prompt_*`, `besales_qa_generation_*` external pairs; `besales_prompt_headroom` — lint headroom + section weights **before** building a draft; `besales_prompt_diff` — line-level divergence between two agents' prompts; `besales_prompt_batch_start` / `_status` / `_resume` — roll one edit across a fleet of agents as a background run |
 | Sandbox / simulation / test-scenario generation | 7 | `besales_sandbox_*`, `besales_simulation_*`, `besales_test_scenario_*` |
 | Model comparison (bake-off) | 4 | `besales_model_catalog_list` + `besales_model_comparison_run_start` / `_get` / `_eval_submit` (on-demand multi-model prompt comparison) |
 | Agent / router / triggers / behavior / facts | 14 | Platform Setup Bridge (incl. `besales_agent_clone`, `besales_behavior_update`, `besales_pipeline_settings_update`, `besales_platform_settings_update`) + `besales_facts_*` |
@@ -309,13 +320,23 @@ and asserted in `src/tools/registry.spec.ts`:
 | Context / overview / audit | 3 | `besales_workspace_overview`, `besales_platform_context_get`, `besales_audit_revert` |
 | Session / workspace binding | 2 | `besales_workspace_use`, `besales_workspace_current` (in-memory per-session, local — no backend) |
 | Dialogue audit | 2 | `besales_dialogues_query`, `besales_dialogue_transcript` — read-only transcript + trigger-action evidence |
-| Broadcast analytics | 2 | `besales_broadcast_analytics_get`, `besales_broadcast_cohorts_list` — authoritative read-only metrics from `/broadcast-analytics`, not transcript-derived counts |
-| GetCourse waves | 10 | `besales_getcourse_wave_import`, `besales_getcourse_wave_status`, `besales_getcourse_wave_run_start`, `besales_getcourse_wave_run_status`, `besales_getcourse_wave_run_contacts`, `besales_getcourse_wave_run_cancel`, `besales_getcourse_wave_run_batch_start`, `besales_getcourse_wave_run_batch_status`, `besales_getcourse_wave_run_batch_cancel`, `besales_getcourse_wave_run_batch_resume` |
+| Broadcast analytics | 2 | `besales_broadcast_analytics_get`, `besales_broadcast_cohorts_list` — authoritative read-only aggregates, drill-downs, segment/product catalogs, insights and payment-candidate reports from `/broadcast-analytics`, not transcript-derived counts |
+| GetCourse waves | 10 | `besales_getcourse_wave_import`, `besales_getcourse_wave_status`, `besales_getcourse_wave_run_start`, `besales_getcourse_wave_run_status`, `besales_getcourse_wave_run_contacts`, `besales_getcourse_wave_run_cancel`, `besales_getcourse_wave_run_batch_start`, `besales_getcourse_wave_run_batch_status`, `besales_getcourse_wave_run_batch_cancel`, `besales_getcourse_wave_run_batch_resume`; durable confirm использует стабильный `launch_key` + `dry_run_hash`, import/run/batch принимают `segment_description` |
 | Scheduled tasks | 2 | `besales_scheduled_task_list`, `besales_scheduled_task_update` — cron-driven dialogue analysis («суфлёр»): daily summary + hourly status written to the CRM timeline or as a hidden open-line message, never to the client |
 | Follow-up (read) | 2 | `besales_followup_sequence_list`, `besales_followup_step_stats` — read a sequence config before a read-modify-write upsert, and see per-step delivery/skip reasons |
 
 Recent capabilities:
 
+- **Prompt lint diagnostics** — a rejected `besales_prompt_patch_commit` now carries the
+  backend's `lintIssues` (up to 3, e.g. the exact character count over the 80000 hard
+  limit) instead of a bare 400. `besales_prompt_headroom` answers the same question
+  *before* a draft is built; `besales_prompt_diff` compares two agents' prompts without
+  pulling both full texts into context.
+- **Fleet prompt rollout** — `besales_prompt_batch_start` applies one set of patch
+  operations across many agents as a background run (33 agents × 3 calls do not fit the
+  60s client timeout). Every agent is prepared and fully linted first; only those that
+  pass are committed. Poll `besales_prompt_batch_status`; roll forward the failures with
+  `besales_prompt_batch_resume` — never by starting a second run.
 - **OAuth PKCE provisioning** — `besales_platform_create_oauth_init` opens the
   authorization flow in the browser for Instagram/Avito so the OAuth code never
   passes through the LLM.
@@ -333,7 +354,19 @@ Recent capabilities:
 - **GetCourse wave-run batches** — queue 1–10 status-mode segments sequentially
   through `besales_getcourse_wave_run_batch_start`; use one `_batch_status` poll,
   reuse a generated `batch_key` on retry, and resume only after resolving two
-  consecutive rejected segments.
+  consecutive rejected segments. `UNKNOWN` и небезопасный `FAILED` жёстко
+  блокируются между волнами; repeat mode не является обходом неопределённого исхода.
+  Контакты import/run/batch принимают `email`, `phone`, `first_name`, `last_name` и передают их
+  backend-у без потери snake_case→camelCase.
+- **Broadcast mailing variants** — `besales_broadcast_mailing_variant_list/create/update/delete`;
+  архивирование через delete или `update(archived=true)` требует `explicit_confirmation=true`
+  управляют workspace-каталогом «Вариантов рассылки». Передавай выбранный UUID как
+  `mailing_variant_id` в direct, durable или batch GetCourse wave; analytics принимает тот же
+  фильтр. Удаление использованного варианта архивирует его и сохраняет историю когорт.
+- **GetCourse school bindings** — `besales_platform_settings_update` принимает
+  `getcourse_settings.wave_field_bindings`: роли `launch_type/product/segment/funnel/channels`
+  связываются с numeric custom-field ID сделки; `product_value_source` выбирает код или название
+  продукта, а `null` очищает настройку школы.
 
 ## Resources
 
@@ -357,7 +390,7 @@ Inspect them locally:
 yarn dlx @modelcontextprotocol/inspector node bin/besales-mcp.js
 ```
 
-The Inspector should show 160 tools and 31 resources.
+The Inspector should show 169 tools and 31 resources.
 
 ## Codex Dialogue Audit Skill
 
@@ -401,7 +434,7 @@ Claude Code, and Codex CLI are documented in
 - This package calls Animaly only through `ai-aniomaly` `/api/v2/*`.
 - Direct calls to `prompt-services` are intentionally out of scope.
 
-The package exposes 128 active MCP tools from `src/schemas/mcp-tools.json`.
+The package exposes 169 active MCP tools from `src/schemas/mcp-tools.json`.
 
 ### Token scopes
 

package/dist/http/api-client.d.ts

@@ -1,4 +1,6 @@
 export declare const API_REQUEST_TIMEOUT_MS = 60000;
+/** Сколько lint-замечаний включать в текст ошибки инструмента, чтобы он остался читаемым. */
+export declare const LINT_ISSUES_IN_ERROR_LIMIT = 3;
 export type ApiMethod = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
 export interface ApiTransportRequest {
     readonly method: ApiMethod;

package/dist/http/api-client.js

@@ -2,6 +2,8 @@ import axios from 'axios';
 import { normalizeApiBaseUrl } from '../auth/oauth-client.js';
 import { logger } from '../utils/logger.js';
 export const API_REQUEST_TIMEOUT_MS = 60_000;
+/** Сколько lint-замечаний включать в текст ошибки инструмента, чтобы он остался читаемым. */
+export const LINT_ISSUES_IN_ERROR_LIMIT = 3;
 export class ApiClientError extends Error {
     status;
     responseMessage;
@@ -89,7 +91,60 @@ export function buildApiUrl(apiBaseUrl, path) {
     }
     return `${normalizedBaseUrl}${normalizedPath}`;
 }
+/**
+ * Текст ошибки для инструмента: `message` из тела плюс диагностические поля, которые
+ * бэкенд кладёт рядом с ним.
+ *
+ * Раньше отдавался только `message`, из-за чего `lintIssues` при 400 на
+ * `POST /agents/{id}/prompt/drafts/{draftId}/commit` терялись, и вызывающий видел
+ * «Prompt failed lint validation» без причины и без цифры (например без «Промпт 81590
+ * символов — превышает жёсткий лимит 80000»).
+ */
 function getSafeResponseMessage(data) {
+    const baseMessage = extractResponseMessage(data);
+    const lintDetail = extractLintIssuesDetail(data);
+    if (baseMessage && lintDetail) {
+        return `${baseMessage} | ${lintDetail}`;
+    }
+    return baseMessage ?? lintDetail;
+}
+/**
+ * Диагностика из `lintIssues` — whitelist полей, а не тело целиком: в ответе может быть PII,
+ * и она не должна попадать в текст ошибки инструмента.
+ */
+function extractLintIssuesDetail(data) {
+    if (!data || typeof data !== 'object') {
+        return undefined;
+    }
+    const issues = data.lintIssues;
+    if (!Array.isArray(issues) || issues.length === 0) {
+        return undefined;
+    }
+    const formatted = issues
+        .slice(0, LINT_ISSUES_IN_ERROR_LIMIT)
+        .map((issue) => formatLintIssue(issue))
+        .filter((item) => item !== undefined);
+    if (formatted.length === 0) {
+        return undefined;
+    }
+    const hidden = issues.length - formatted.length;
+    const suffix = hidden > 0 ? ` (и ещё ${hidden})` : '';
+    return `lint: ${formatted.join('; ')}${suffix}`;
+}
+function formatLintIssue(issue) {
+    if (!issue || typeof issue !== 'object') {
+        return undefined;
+    }
+    const { severity, category, message } = issue;
+    if (typeof message !== 'string' || message.length === 0) {
+        return undefined;
+    }
+    const prefix = [severity, category]
+        .filter((part) => typeof part === 'string' && part.length > 0)
+        .join('/');
+    return prefix ? `${prefix} — ${message}` : message;
+}
+function extractResponseMessage(data) {
     if (!data || typeof data !== 'object') {
         return undefined;
     }

package/dist/http/api-client.js.map

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

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/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. Не повторяй уже сказанное.** Если ты уже описал состав/факт или задал вопрос — не описывай
 блоки снова и не задавай тот же вопрос второй раз. Каждое сообщение двигает диалог НОВЫМ шагом.