@besales/mcp 0.46.0 → 0.47.0

package/dist/resources/concepts/workbook-classification.md

@@ -29,9 +29,8 @@ KnowledgeDocument / ICP samples). Структура файла у разных
 Для Google Sheets — сразу шаг 2 с URL.
 
 Для xlsx:
-1. Залей файл через **существующий files endpoint** (`POST /api/v2/files` с
-   multipart) — это **не** workbook MCP tool, это общий files upload.
-2. В ответе получишь `storedFileId`.
+1. Вызови `besales_file_upload_request` и передай человеку полученный browser upload URL.
+2. После загрузки проверь `besales_file_upload_status`; из результата возьми `storedFileId`.
 
 Сам workbook MCP **не** загружает файлы — он только инспектирует уже
 загруженные. Это разделение позволяет переиспользовать SourceWorkbook для
@@ -55,6 +54,13 @@ besales_workbook_inspect({
   `hyperlinkStats[]` (per-column число amoCRM lead/contact ссылок),
   `truncated` (применён ли лимит).
 
+`inspect` — только инвентаризация и sample. Для Google Sheets точный total может быть
+неизвестен (`rowCount`/`columnCount = null`, `dimensionsKnown=false`). `readError` означает
+ошибку чтения конкретного листа, а не пустой лист. Дочитывай нужные страницы через
+`besales_workbook_sheet_read`: для каждого `columnOffset` пройди строки до
+`scanUpperBoundRowCount`, затем сбрось `rowOffset` в 0 и перейди к `nextColumnOffset` до
+`scanUpperBoundColumnCount`. Пустая страница внутри этой области не означает конец листа.
+
 **Если Google Sheets вернул 403 (`error: google_sheets_not_shared`)** — покажи
 пользователю `serviceAccountEmail` из response и попроси расшарить таблицу
 на этот email (Viewer достаточно для чтения). Без этого никакие операции не
@@ -100,22 +106,20 @@ besales_workbook_inspect({
 2 + router?». По его ответу — либо `besales_agent_create` + `besales_router_update`
 + `besales_trigger_upsert`, либо склей в один промпт.
 
-## Шаг 5 — Извлечение lead_ids из диалог-индекса (regex локально)
+## Шаг 5 — Извлечение lead_ids из диалог-индекса
 
-Для `dialogue_corpus_with_amocrm_links` — **не зови отдельный MCP tool**. Данные
-уже в `inspect` response (`sampleRows[][]`). Прогони regex по `cell.value`,
-`cell.hyperlink`, `cell.formula`:
+Для `dialogue_corpus_with_amocrm_links` вызови
+`besales_workbook_extract_amocrm_leads`: он читает вкладку целиком до явного hard cap и
+возвращает координаты найденных ссылок. Не извлекай полный набор из `inspect.sampleRows`.
 
 ```
 /https?:\/\/[\w-]+\.amocrm\.ru\/leads\/detail\/(\d+)/   → leadId
 /https?:\/\/[\w-]+\.amocrm\.ru\/contacts\/detail\/(\d+)/ → contactId
 ```
 
-Поддерживается любой amoCRM поддомен (`aslzar`, `acme-crm`, и т.д.). Если в
-inspect-sample слишком мало строк — попроси `inspect` повторно с большим
-`sample_rows_per_sheet` (до 50). Если и этого мало — обрати внимание что для
-больших таблиц извлечение в полном объёме сейчас не покрыто отдельным
-helper-tool'ом; в Phase 1 это покрывается доступным sample'ом.
+Поддерживается любой amoCRM поддомен (`aslzar`, `acme-crm`, и т.д.). Если
+`truncated=true`, сообщи о hard cap и не называй результат полным. Для иных правил и ссылок
+используй общее постраничное чтение `besales_workbook_sheet_read`.
 
 ## Шаг 6 — `besales_workbook_to_knowledge_document` (bulk knowledge)
 
@@ -158,7 +162,7 @@ path** (потому что названия вкладок содержат к
 Для `product_knowledge_compact` НЕ зови `besales_workbook_to_knowledge_document`.
 Вместо этого:
 
-1. Прочитай sample вкладки из `inspect` response.
+1. Дочитай вкладку через `besales_workbook_sheet_read`; sample из inspect недостаточен.
 2. Сам сделай LLM-выжимку: возьми ключевые факты, сожми в markdown ≤8k chars.
    Формат:
    ```
@@ -176,8 +180,8 @@ path** (потому что названия вкладок содержат к
 После того как все вкладки разобраны:
 
 ```
-PATCH /api/v2/workspaces/:wsId/workbooks/:id/classification
-body: {
+besales_workbook_classification_update({
+  workbook_id: "<uuid>",
   classification: [
     { sheetTitle: "Свод", detectedKind: "metadata_summary", destination: "ignored" },
     { sheetTitle: "Все разговоры", detectedKind: "dialogue_corpus_with_amocrm_links",
@@ -188,7 +192,7 @@ body: {
       destination: "knowledge_document", mappedEntityId: "<kd-id>" },
     { sheetTitle: "Задачи", detectedKind: "tasks_log", destination: "ignored" }
   ]
-}
+})
 ```
 
 Это даёт audit trail («откуда взялся этот факт») и позволяет потом
@@ -196,7 +200,7 @@ body: {
 
 ## Шаг 9 — Архивация (когда больше не нужен)
 
-`POST /api/v2/workspaces/:wsId/workbooks/:id/archive` — soft delete.
+`besales_workbook_archive({workbook_id, explicit_confirmation: true})` — soft delete.
 KnowledgeDocument'ы остаются (благодаря `onDelete: SetNull`), просто теряют
 ссылку на workbook. Hard delete для SourceWorkbook не предусмотрен —
 provenance не должна теряться.
@@ -205,7 +209,8 @@ provenance не должна теряться.
 
 > Заказчик прислал `Сухбатлар тахлили 100+100-2.xlsx` (7 вкладок).
 
-1. User загружает xlsx через `/api/v2/files` → `storedFileId = abc123`.
+1. `besales_file_upload_request` → пользователь загружает xlsx в браузере →
+   `besales_file_upload_status` возвращает `storedFileId = abc123`.
 2. `besales_workbook_inspect({stored_file_id: "abc123"})` →
    - `workbook.id = wb-1` создан
    - 7 вкладок: Свод (6 строк), Все разговоры (435 строк), Плохие (101),
@@ -218,7 +223,7 @@ provenance не должна теряться.
    - Критерии → `behavior_rules` (2 параллельные колонки!)
    - Регламенты → `product_knowledge_bulk` (53k chars)
    - Задачи → `tasks_log` (ignore)
-4. Regex по sampleRows[Все разговоры].column[2] → 124 leadId.
+4. `besales_workbook_extract_amocrm_leads` по вкладке «Все разговоры» → 124 leadId.
 5. `besales_icp_import_dialogues mode=audio audio_source_type=amocrm_leads` с
    этими leadId.
 6. `AskUserQuestion`: «В Критериях вижу 2 параллельных набора правил (звонок 1
@@ -228,7 +233,7 @@ provenance не должна теряться.
 8. `besales_workbook_to_knowledge_document({workbook_id: "wb-1",
    sheet_title: "Регламенты продаж", namespace: "aslzar-product-knowledge"})`.
 9. `besales_agent_update` — добавить knowledge_space_id в `knowledge_space_ids` агента (UUID, не cleanNamespace).
-10. `PATCH /workbooks/wb-1/classification` — зафиксировать решения.
+10. `besales_workbook_classification_update` — зафиксировать решения.
 
 ## Что НЕ делать
 
@@ -237,5 +242,5 @@ provenance не должна теряться.
   каждый запрос инференса. Большие материалы → в KnowledgeDocument.
 - ❌ Не создавай агентов / промпты / документы без подтверждения user'а для
   high-impact операций (новый агент, router rule).
-- ❌ Не пытайся найти tool типа `besales_workbook_to_facts` — его нет. Compact
+- ❌ Для записи compact facts нет отдельного workbook-tool. Используй
   knowledge ты сам сжимаешь LLM-вызовом и кладёшь через `besales_agent_facts_set`.

package/dist/resources/docs/campaigns.md

@@ -0,0 +1,20 @@
+# Рассылки и кампании
+
+## Подготовка
+
+Разделяй сущности: mailing variant хранит текст, schedule — правило отбора и время, launch/run —
+конкретный запуск, cohort — снимок аудитории запуска. Доступный набор операций всегда сверяй с
+`besales://docs/tools-catalog`.
+
+## Аналитика
+
+`besales_broadcast_analytics_get` — канонический исходящий отчёт; `besales_broadcast_cohorts_list`
+— перечень запусков. Сохраняй оси cohort/period/entry и зерно recipient/channel. Не считай число
+сообщений числом людей и не выдавай исходящую аналитику за входящую.
+
+## Запись и запуск
+
+Если линия предоставляет mailing/schedule tools, сначала создай выключенную конфигурацию, затем
+получи preview, проверь ограничения, окно, каналы и дедуп, и только после явного подтверждения
+включай или запускай. При pause/timeout/UNKNOWN сначала читай run/status; повтор может написать
+человеку второй раз.

package/dist/resources/docs/follow-up.md

@@ -0,0 +1,19 @@
+# Follow-up и дожимы
+
+## Чтение
+
+Начни с `besales_followup_sequence_list`. Для редактирования одной цепочки запроси её полный config;
+список без config — только инвентаризация. Статистика шага — `besales_followup_step_stats`, реакции
+— `besales_followup_reactions`.
+
+## Изменение
+
+`besales_followup_sequence_upsert` заменяет конфигурацию цепочки целиком. Сохрани все существующие
+шаги, условия и exclusions. Клонирование — `besales_followup_sequence_clone`; наличие отдельной
+правки текста шага проверяй по динамическому каталогу текущей линии.
+
+## Безопасная проверка
+
+Перед отправкой живому человеку используй funnel-test plan, если его инструменты есть в каталоге,
+покажи transports, тексты, skip reasons и truncated, затем запускай только с явным подтверждением.
+Timeout или UNKNOWN не разрешает повторную отправку без status.

package/dist/resources/docs/platforms.md

@@ -6,9 +6,9 @@
 
 ## 1. Назначение
 
-`Platform` — это «канал», через который бот общается с пользователями. Каждая платформа — один внешний account/bot/instance. Animaly поддерживает **11 типов** платформ (`PlatformType`): Telegram Bot, Telegram Personal, Wazzup (WhatsApp), Avito, Instagram DM, VKontakte, SmsGorod (SMS), Web Widget, Bitrix24 Bot, Salebot и **GetCourse**.
+`Platform` — это «канал», через который бот общается с пользователями. Каждая платформа — один внешний account/bot/instance. Animaly поддерживает **13 типов** платформ (`PlatformType`): Telegram Bot, Telegram Personal, Wazzup (WhatsApp), Avito, Instagram DM, VKontakte, SmsGorod (SMS), Web Widget, Bitrix24 Bot, Salebot, **GetCourse**, Telephony и External API.
 
-> Ранее в обзорной части документации фигурировало «10 каналов» — это устаревшая цифра. GetCourse — отдельный полноценный адаптер с собственным контроллером (`/api/getcourse/webhook/:platformId/:secret/...`), и его нужно учитывать при настройке.
+> Старые цифры «10» и «11» устарели. GetCourse, Telephony и External API — самостоятельные значения `PlatformType`. Наличие типа в runtime не означает, что MCP умеет провизионировать его: актуальный поддерживаемый набор возвращает схема `besales_platform_create_init`.
 
 ## 2. Общая структура `Platform`
 

package/dist/resources/docs/routing.md

@@ -0,0 +1,18 @@
+# Маршрутизация агентов
+
+## Контекст
+
+Сначала прочитай `besales_platform_context_get` и список агентов площадки. Routing нужен, когда
+входящий диалог должен выбирать между несколькими агентами; одиночному агенту отдельное правило
+не добавляй без причины.
+
+## Настройка
+
+Правило создаётся или обновляется через `besales_routing_rule_upsert`, затем состояние роутера —
+через `besales_router_update`. Условие, приоритет, fallback и активность проверяй по ответу
+контекста, не по памяти предыдущей сессии.
+
+## Проверка
+
+Тестируй каждого агента отдельно и систему целиком в workflow sandbox со сценариями, где тема
+меняется по ходу диалога. Успех одного агента не доказывает правильный выбор роутером.

package/dist/resources/docs/task-state.md

@@ -0,0 +1,30 @@
+# Состояние длительной задачи
+
+`besales-mcp` хранит задачи локально в `~/.besales-mcp/tasks-v1.json`. Claude Desktop, Claude Code
+и Codex на одной машине под одним OS-аккаунтом видят один набор. Автоматической синхронизации между
+компьютерами нет. В файл нельзя помещать credentials, setup-секреты и исходные диалоги.
+
+## Жизненный цикл
+
+1. Создай задачу через `besales_task_create`: зафиксируй цель, ограничения, ссылки на объекты,
+   checkpoints, ожидающие операции и следующее действие человека.
+2. При паузе обнови её через `besales_task_update` с текущим `expected_version`.
+3. Для «продолжить» вызови `besales_task_list`, выбери `task_id` явно и прочитай
+   `besales_task_get`. Самая свежая запись не выбирается автоматически.
+4. Перед новой мутацией вызови `besales_workspace_current`, перечитай объекты из `object_refs` и
+   статусы `pending_operations`. Сохранённое состояние — контекст, а не доказательство.
+5. Заверши задачу через `besales_task_close`. Удали локальную запись через `besales_task_delete`
+   только с точной версией и `explicit_confirmation=true`.
+
+Статусы: `ACTIVE`, `COMPLETED`, `CANCELLED`, `EXPIRED`. Только `ACTIVE` можно менять. По умолчанию
+TTL равен 30 дням; допустимо 1–180. Истёкшая запись остаётся видимой до явного удаления.
+
+## Конкуренция и неизвестный исход
+
+Каждая запись имеет монотонную `version`. Конфликт `TASK_VERSION_CONFLICT` означает, что другая
+сессия уже изменила задачу: перечитай её и согласуй свежий payload. Межпроцессная блокировка и
+атомарная замена файла не дают двум сессиям принять одну старую версию.
+
+Для `OUTCOME_UNKNOWN` сохрани `idempotency_key`, `object_ref` и `verify_with`. Не повторяй мутацию
+автоматически: сначала найди receipt или status. Setup URL и состояние async job остаются своими
+сущностями и не заменяют общую задачу.

package/dist/resources/docs/trigger-actions.md

@@ -0,0 +1,28 @@
+# Триггеры и действия
+
+## С чего начать
+
+Прочитай `besales_platform_context_get`: он возвращает триггеры и полный набор их actions. Для
+изменения одного действия сохрани остальные и передай полный массив только с
+`replace_actions=true`. Неполный или усечённый снимок нельзя использовать для замены.
+
+## Конфигурация действия
+
+У каждого `actionType` свой ключ конфига. Не угадывай его: вызови
+`besales_trigger_action_catalog_get` с нужным `action_type`. Ответ содержит текущую JSON-схему,
+минимальный валидный пример, точное имя config-поля, имя relation в ответе, зависимости, эффект
+и способ проверки. В ответе API имя связи может отличаться от имени входа; MCP нормализует
+известные пары.
+
+## Запись и проверка
+
+Создание/правка — `besales_trigger_upsert`, удаление — `besales_trigger_delete`. Внешние действия,
+отправка, CRM, operator handoff и полная замена требуют явного подтверждения по схеме инструмента.
+После записи перечитай `besales_platform_context_get` и сравни actionType, порядок, enabled и весь
+конфиг. `run_once_per_contact` и `allow_repeated_calls` — разные оси.
+
+## Ошибки
+
+400 по неизвестному полю означает несовпадение схемы, а не повод перебрать названия. Отсутствие
+конфига у обязательного действия должно останавливать запись. Для одноразового trigger право
+контакта проверяется через claim tools только когда они есть в динамическом каталоге линии.

package/dist/resources/docs/variables.md

@@ -0,0 +1,18 @@
+# Переменные
+
+## Область и выбор
+
+`besales_variable_list` читает переменные в scope WORKSPACE или CHANNEL. Используй пагинацию до
+явного завершения и выбирай по имени; UUID нужен только следующему инструменту. CHANNEL требует
+scope_id конкретной площадки.
+
+## Операции
+
+- `besales_variable_get` — полный объект.
+- `besales_variable_create` — новая переменная.
+- `besales_variable_update` — правка выбранной переменной.
+- `besales_variable_delete` — удаление с подтверждением.
+- `besales_agent_variable_overrides_get` — полный снимок overrides агента перед заменой.
+
+После записи перечитай объект. Не смешивай workspace variables `{{{name}}}` и channel custom
+variables `{name}`; overrides агента заменяются полным набором.

package/dist/resources/registry.js

@@ -1,5 +1,8 @@
 import { readFile } from 'node:fs/promises';
-import { getResourceContracts } from '../tools/contracts.js';
+import { getActiveToolContracts, getResourceContracts, } from '../tools/contracts.js';
+import { isEnvelopeEnabled, shapeResourceText } from '../tools/result-envelope.js';
+import { toolInventoryCategoryKey } from '../tools/inventory.js';
+import { readPackageVersion } from '../package-metadata.js';
 // URI → относительный путь от `src/resources/` (включая подпапку).
 // concepts/* — справочники паттернов; workflows/* — orchestration-маршруты (v1.5 Increment 6a).
 const resourceFilesByUri = {
@@ -27,6 +30,12 @@ const resourceFilesByUri = {
     'besales://docs/pipeline-builder': 'docs/pipeline-builder.md',
     'besales://docs/files-and-uploads': 'docs/files-and-uploads.md',
     'besales://docs/pipeline-settings-deep': 'docs/pipeline-settings-deep.md',
+    'besales://docs/trigger-actions': 'docs/trigger-actions.md',
+    'besales://docs/variables': 'docs/variables.md',
+    'besales://docs/routing': 'docs/routing.md',
+    'besales://docs/follow-up': 'docs/follow-up.md',
+    'besales://docs/campaigns': 'docs/campaigns.md',
+    'besales://docs/task-state': 'docs/task-state.md',
     // Дистиллят принципов промптинга (человечность + sales-плейбук), переиспользуется между компаниями.
     'besales://docs/prompt-principles': 'docs/prompt-principles.md',
     // Тематические comm-скиллы — глубокие разборы боевых диалогов (Партии 1+3, разметка Антона).
@@ -40,10 +49,46 @@ const resourceFilesByUri = {
     'besales://docs/comm-anti-robot': 'docs/comm-anti-robot.md',
     'besales://docs/comm-tone-register': 'docs/comm-tone-register.md',
 };
+const TOOL_CATALOG_URI = 'besales://docs/tools-catalog';
+function renderToolCatalog() {
+    const grouped = new Map();
+    for (const tool of getActiveToolContracts()) {
+        const category = toolInventoryCategoryKey(tool.name);
+        const entries = grouped.get(category) ?? [];
+        entries.push({ name: tool.name, description: tool.description.split(/(?<=[.!?])\s/u)[0] ?? '' });
+        grouped.set(category, entries);
+    }
+    const sections = [...grouped.entries()]
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([category, entries]) => `## ${category}\n\n${entries.map((tool) => `- \`${tool.name}\` — ${tool.description}`).join('\n')}`);
+    return [
+        '# Каталог инструментов Besales MCP',
+        '',
+        `Версия пакета: ${readPackageVersion()}. Инструментов: ${getActiveToolContracts().length}.`,
+        '',
+        'Каталог построен из фактически публикуемого MCP-контракта. Для поиска по задаче используй `besales_help_search`.',
+        '',
+        ...sections,
+        '',
+    ].join('\n');
+}
 function resourceUrl(relativePath) {
     return new URL(`./${relativePath}`, import.meta.url);
 }
 function createResource(contract) {
+    if (contract.uri === TOOL_CATALOG_URI) {
+        return {
+            ...contract,
+            async read() {
+                const text = renderToolCatalog();
+                return {
+                    uri: contract.uri,
+                    mimeType: contract.mimeType,
+                    text: isEnvelopeEnabled() ? shapeResourceText(contract.uri, text) : text,
+                };
+            },
+        };
+    }
     const relativePath = resourceFilesByUri[contract.uri];
     if (!relativePath) {
         throw new Error(`Resource file mapping not found: ${contract.uri}`);
@@ -54,10 +99,14 @@ function createResource(contract) {
         description: contract.description,
         mimeType: contract.mimeType,
         async read() {
+            const text = await readFile(resourceUrl(relativePath), 'utf-8');
             return {
                 uri: contract.uri,
                 mimeType: contract.mimeType,
-                text: await readFile(resourceUrl(relativePath), 'utf-8'),
+                // Справочник отдаётся целиком, одним чтением: самый тяжёлый весит 105 КБ. Потолок
+                // здесь — сеть безопасности от дальнейшего роста, а не инструмент сжатия: добрать
+                // отрезанное нечем, поэтому срабатывание означает «файл пора разделить».
+                text: isEnvelopeEnabled() ? shapeResourceText(contract.uri, text) : text,
             };
         },
     };

package/dist/resources/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/resources/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI5C,OAAO,EAAE,oBAAoB,EAAyB,MAAM,uBAAuB,CAAC;AAMpF,mEAAmE;AACnE,gGAAgG;AAChG,MAAM,kBAAkB,GAAqC;IAC3D,wBAAwB,EAAE,iBAAiB;IAC3C,6BAA6B,EAAE,sBAAsB;IACrD,4BAA4B,EAAE,qBAAqB;IACnD,4BAA4B,EAAE,qBAAqB;IACnD,uCAAuC,EAAE,gCAAgC;IACzE,oCAAoC,EAAE,6BAA6B;IACnE,4CAA4C,EAAE,qCAAqC;IACnF,iDAAiD,EAAE,0CAA0C;IAC7F,qCAAqC,EAAE,8BAA8B;IACrE,8CAA8C,EAAE,uCAAuC;IACvF,qDAAqD,EACnD,8CAA8C;IAChD,2CAA2C,EAAE,oCAAoC;IACjF,0CAA0C,EAAE,mCAAmC;IAC/E,oCAAoC,EAAE,6BAA6B;IACnE,gDAAgD,EAAE,yCAAyC;IAC3F,gGAAgG;IAChG,+BAA+B,EAAE,wBAAwB;IACzD,+BAA+B,EAAE,wBAAwB;IACzD,+BAA+B,EAAE,wBAAwB;IACzD,0BAA0B,EAAE,mBAAmB;IAC/C,gCAAgC,EAAE,yBAAyB;IAC3D,iCAAiC,EAAE,0BAA0B;IAC7D,kCAAkC,EAAE,2BAA2B;IAC/D,uCAAuC,EAAE,gCAAgC;IACzE,oGAAoG;IACpG,kCAAkC,EAAE,2BAA2B;IAC/D,6FAA6F;IAC7F,kGAAkG;IAClG,sCAAsC;IACtC,iCAAiC,EAAE,0BAA0B;IAC7D,+BAA+B,EAAE,wBAAwB;IACzD,sCAAsC,EAAE,+BAA+B;IACvE,mCAAmC,EAAE,4BAA4B;IACjE,+BAA+B,EAAE,wBAAwB;IACzD,gCAAgC,EAAE,yBAAyB;IAC3D,mCAAmC,EAAE,4BAA4B;CAClE,CAAC;AAEF,SAAS,WAAW,CAAC,YAAoB;IACvC,OAAO,IAAI,GAAG,CAAC,KAAK,YAAY,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,cAAc,CAAC,QAA0B;IAChD,MAAM,YAAY,GAAG,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAEtD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,OAAO;QACL,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,KAAK,CAAC,IAAI;YACR,OAAO;gBACL,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,MAAM,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;aACzD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAyB,oBAAoB,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/resources/registry.ts"],"names":[],"mappings":"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"}

package/dist/resources/workflows/extract-from-document.md

@@ -6,7 +6,11 @@
 
 ## Шаг 1 — Осмотр
 
-- xlsx / Google Sheets: `besales_workbook_inspect` (вкладки, заголовки, типы колонок).
+- xlsx: `besales_file_upload_request` → browser upload → `besales_file_upload_status` →
+  `besales_workbook_inspect`.
+- Google Sheets: `besales_workbook_inspect` по URL.
+- Inspect показывает инвентаризацию и sample. Нужные вкладки дочитай через
+  `besales_workbook_sheet_read`; `readError` не означает пустой лист.
 - Иначе: прочитай содержимое и классифицируй сам.
 - Глубже про таксономию вкладок — concept `besales://concepts/workbook-classification`.
 
@@ -34,3 +38,6 @@
 Документ редко = «одна сущность». Прайс-лист несёт и таблицу для RAG, и переменные
 (контакты), и иногда tone. Раскладывай по всем релевантным целям за один проход.
 Затем возвращайся в `besales://workflows/platform-setup-from-scratch`.
+
+Перед записью результатов сохрани решения через `besales_workbook_classification_update`.
+Архивируй исходник только по просьбе пользователя через `besales_workbook_archive`.

package/dist/resources/workflows/iterate-with-sandbox.md

@@ -5,8 +5,10 @@
 
 ## Цикл
 
-1. **Прогон.** `besales_sandbox_run_start` (на ICP test scenarios / personas).
-2. **Анализ findings (external execution).**
+1. **Прогон.** `besales_sandbox_run_start` (на ICP test scenarios / personas), сохрани
+   `run_id`. Проверяй `besales_sandbox_run_get` каждые 10–30 секунд до терминального статуса;
+   при отмене вызови `besales_sandbox_run_cancel` и проверь тот же run повторно.
+2. **Анализ findings (external execution, только после `COMPLETED`).**
    - `besales_sandbox_findings_get_instructions` → локально проанализируй прогон →
      `besales_sandbox_findings_submit`.
    - Для персонажных симуляций: `besales_simulation_findings_get_instructions` /
@@ -23,6 +25,7 @@
 
 - Findings ниже порога серьёзности и нет регрессий между прогонами.
 - Ключевые ICP-сценарии проходят.
+- `checksRate` и `qualityRate` проверены отдельно; один `passRate` не доказывает качество.
 - Не гонись за идеалом — после стабилизации иди в
   `besales://workflows/production-readiness-check`.
 

package/dist/resources/workflows/platform-setup-from-scratch.md

@@ -9,7 +9,8 @@ Backbone happy-path настройки с нуля по **6-фазной мод
 
 ## Шаг 0 — Ориентация (всегда)
 
-1. `besales_workspace_overview` → прочитай `setupCompleteness` и `suggestedNextPhase`.
+1. `besales_workspace_navigate` с `intent=CREATE_BOT` и известным `bot_type` → получи один
+   адресный следующий шаг. Для полного снимка используй `besales_workspace_overview`.
 2. Если workspace частично настроен — **не начинай с нуля**, продолжи с `suggestedNextPhase`.
 3. Убедись, что выбран нужный workspace (`besales_workspace_current`; при необходимости
    `besales_workspace_use`).
@@ -65,13 +66,17 @@ Backbone happy-path настройки с нуля по **6-фазной мод
    а) построй структуру скрипта (этапы/ветки/реплики/переходы) → `besales_dialog_script_update`
       (поле `dialog_script` — SUMMARY/скелет; читать/сверять — `besales_dialog_script_get`);
    б) промпт: `besales_prompt_generate_get_instructions` → локально выполни стадии →
-   `besales_prompt_generate_submit` → `besales_prompt_finalize` (§6 пиши НА ОСНОВЕ скрипта, но подробнее и независимо). Структура — `besales://docs/prompt-anatomy`.
+   `besales_prompt_generate_submit`. До `besales_prompt_finalize` передай полученный текст как
+   `candidate_prompt` в `besales_sandbox_run_start` с `mode=single_agent`; после COMPLETED + findings
+   сверь `testedConfiguration.promptContentHash` и только затем активируй отдельным finalize.
+   §6 пиши НА ОСНОВЕ скрипта, но подробнее и независимо. Структура — `besales://docs/prompt-anatomy`.
 3. `besales_behavior_update` — приветствие: ТОЛЬКО `bot_greeting` текстом, БЕЗ кнопок (дефолт
    «Привет!/Hello» → язык аудитории; для INBOUND открывает диалог). `greeting_buttons` opt-in — лишь
    по явному запросу; остальной behavior (persona/тон/typing) — фаза Enrich. `besales://docs/agent-behavior`.
 4. **Статика:** `besales_prompt_lint` + анализ `besales_prompt_analyze_get_instructions` /
    `besales_prompt_analyze_submit`.
 5. **Симуляция:** `besales_sandbox_run_start` по тест-сценариям (фаза 3) → findings → правки.
+   Черновик проверяй через `candidate_prompt`: это не меняет ответы работающего бота.
    Глубже — `besales://workflows/iterate-with-sandbox`.
 6. **Выбор модели (только здесь или по запросу — дорого):** `besales://workflows/compare-models`
    (`besales_model_catalog_list` → `besales_model_comparison_run_start` → `_get` → `_eval_submit`).
@@ -111,3 +116,86 @@ Backbone happy-path настройки с нуля по **6-фазной мод
 сразу показывает `'4'`. Для non-FAQ ботов сделай фазы 2 (ICP) и 3 (скрипт) ДО финализации промпта,
 даже если компас их пропустил. Сквозные правила (тест-рефлекс, Sheets-feedback, модели→фаза 4,
 мультиагент+роутер, ленивая CRM, гибкость) — в serverInstructions.
+
+## Маршруты обычных задач
+
+Шесть фаз выше нужны для новой настройки. Свободный вопрос или точечная правка не запускают
+полный мастер. Каждый маршрут начинается с `besales_workspace_current`, затем выбирает объект
+обычным именем и заканчивается перечитыванием либо lifecycle-status.
+
+### Новый FAQ-бот
+
+1. Предусловие: канал `READY`; получить `platform,agent_summaries,readiness` через
+   `besales_platform_context_get`.
+2. Собрать темы ответов и ограничения; ICP предложить, но не делать gate.
+3. Создать агента, положить факты в Q&A/RAG, сгенерировать prompt и greeting.
+4. Создать FAQ-сценарии, выполнить sandbox, получить findings.
+5. Завершение: привязка агента/knowledge видна в context, run `COMPLETED`, quality policy
+   выполнена. Иначе назвать конкретный следующий tool и аргументы.
+
+### Новый sales-бот
+
+Тот же путь, но до финализации обязательны релевантный ICP и скрипт диалога. CRM нужна только
+если задача включает сделку, поля или стадии. Наличие строки CRM не доказывает live authorization:
+проверить setup status/health и фактические pipelines.
+
+### Правка работающего агента
+
+1. `besales_agent_list(query=...)`; при нескольких совпадениях показать их и остановить выбор.
+2. `besales_agent_get`/`besales_prompt_patch_get` и полный относящийся к записи снимок.
+3. Изменить draft или одиночным `besales_prompt_batch_start` с idempotency key.
+4. Протестировать версию изолированно; commit/finalize — отдельный шаг.
+5. Перечитать agent/version. `skippedCount > 0`, lint failure или stale test не являются успехом.
+
+### Документ → знания, правила или ICP
+
+Использовать `besales://workflows/extract-from-document`. Inspect/sample не равны полной вычитке.
+Для другого языка сначала перечислить листы/разделы и дать саммари на языке диалога. Чтение
+продолжается; перед записью чисел, процентов и условий получить подтверждение, если человек их
+ещё не согласовал. Завершение: source fingerprint, сохранённая classification, созданные IDs и
+повторное чтение связей.
+
+### CRM или 1С
+
+CRM: `besales://workflows/connect-crm-from-scratch`; 1С/data source:
+`besales://workflows/connect-datasource-from-scratch`. Browser setup поллится до `READY`.
+После записи проверить live health/catalog/pipeline, а не только существование строки.
+
+### Follow-up
+
+Прочитать полный config последовательности и ограничения площадки, затем
+`besales_followup_sequence_upsert`. Проверить повторным list и статистикой шагов. Сезонная пауза,
+disabled draft и отсутствие ожидаемого запуска различаются; closed dialogue не получает касаний.
+
+### Подготовка и проверка рассылки
+
+Сначала preview/dry-run и полный список ошибок/контактов, потом явное подтверждение фактической
+отправки. Сохранить `idempotency_key` до вызова, затем поллить соответствующий status. При
+`OUTCOME_UNKNOWN` искать запуск по receipt/key и не повторять отправку.
+
+### Исходящая аналитика
+
+`besales_broadcast_analytics_get`: передать период, `view=cohort|period|entry` и нужное зерно.
+`summary.totals` — канонический общий итог денег; multichannel rows не суммировать повторно.
+Исходящие метрики не доказывают отсутствие входящих сообщений.
+
+### Бот молчит или не доставил
+
+1. Выбрать контакт/сообщение по обычным данным; если MCP-пути чтения нет, честно назвать
+   unsupported и перейти в UI, не угадывать причину.
+2. По времени проверить mute/silence/operator status, routing/model, RAG evidence,
+   trigger/action execution, transport и delivery receipt.
+3. Отсутствие evidence назвать «не найдено свидетельство», а не нулём.
+4. Завершение — одна доказанная причина либо перечень точных недостающих данных.
+
+### Аудит
+
+`besales://workflows/audit-dialogues`: start → status → result/findings. Pending/failed/unknown
+не становятся success; доказательства маскируются и не копируются без необходимости.
+
+### Продолжение после ошибки
+
+401 → reconnect конкретного workspace; 403 → добавить названный scope, сохранив прежние;
+410 → новый get_instructions; 422 → исправить поля; 429 → ждать `retryAfter`; timeout/5xx
+неидемпотентной мутации → `OUTCOME_UNKNOWN`, receipt/status/list. Перед продолжением перечитать
+объект и права: сохранённый план не заменяет свежую проверку.

package/dist/resources/workflows/production-readiness-check.md

@@ -1,31 +1,35 @@
 # Workflow: Production Readiness Check
 
-Финальная проверка перед запуском бота. Опирается на `besales_workspace_overview` →
-`setupCompleteness`. Формируй список «готово / недоделано», не блокируй жёстко —
-часть пунктов опциональна по бизнес-цели.
+Финальная проверка перед запуском бота. Workspace overview нужен для выбора площадки, но
+`besales_agent_readiness_get` проверяет конкретного агента. Сейчас API не фиксирует полную
+версию зависимых настроек и возвращает `NOT_PROVEN`, даже если промпт и quality evidence
+актуальны. Не обещай, что повтор sandbox даст `READY`. Часть бизнес-возможностей остаётся опциональной.
 
 ## Шаг 1 — Снимок
 
-`besales_workspace_overview` → читай `setupCompleteness`. При необходимости детали:
-`besales_platform_context_get` (по конкретному каналу), `besales_agent_list`.
+`besales_workspace_overview` → выбери канал → `besales_agent_list` → выбери агента →
+`besales_agent_readiness_get`. Для drill-down используй `besales_platform_context_get`.
 
-## Чеклист (по `setupCompleteness`, поля camelCase)
+## Чеклист (по readiness выбранного агента)
 
 **Блокирующее (должно быть):**
-- `channelsConnected ≥ 1` и нет залипших `channelsPending`. Канал `isActive` + AI включён.
-- `hasAnchorAgent` — агент существует, с непустым промптом (проверь `besales_prompt_lint`)
-  и приветствием (`besales_behavior_update`).
+
+- `channelActive`, `aiEnabled`, `promptConfigured`, `promptHashInvariant`, `greetingConfigured`.
+- `knowledgeLinked`: все объявленные namespace существуют в workspace.
+- `icp.passed`: ICP обязателен для sales/qualification/reactivation.
+- `sandbox.status=COMPLETED`, `configurationCurrent=true`, `findingsStatus=SUBMITTED`,
+  `qualityRate ≥ policy.minQualityRate`, `checksRate ≥ policy.minChecksRate` и есть expectations.
+  Сейчас `configurationCurrent=null`: `promptAndAgentCurrent` проверяет только промпт и запись
+  агента, а `unverifiedDependencies` перечисляет непроверенные зависимости. Это блокирует общий
+  положительный вердикт, даже при `promptAndAgentCurrent=true`.
 
 **Сильно рекомендуется:**
-- `hasKnowledge` И `knowledgeLinkedToChannel` — knowledge не просто загружен, а **привязан**
-  к каналу (`besales_knowledge_space_channel_link_upsert`). «Загружен но не связан» = агент не видит.
-- `lastSandboxRunAt` не null — прогонялся sandbox, findings закрыты
-  (см. `besales://workflows/iterate-with-sandbox`).
-
-**По типу бота:**
-- **sales / qualification / booking** → `hasIcp` должен быть true. Для таких ботов ICP —
-  не опция, а условие качества (без него промпт generic). Если false — это «недоделано».
-- **FAQ / support** → ICP опционален, `hasIcp=false` не блокирует.
+- `passRate` — только живучесть. Даже 1.0 не заменяет quality/checks/findings.
+- `crmAuthorization=NOT_EVALUATED` означает, что live-доступ CRM надо проверить отдельно,
+  когда CRM входит в цель запуска.
+
+`NOT_PROVEN` — нормальный честный исход. Выполни адресные пункты `missing`, затем перечитай
+readiness: сохранённый ответ не заменяет свежую проверку объекта и прав.
 
 **По бизнес-цели (опционально — НЕ «недоделано» если не нужно):**
 - Triggers / follow-ups: `besales_trigger_upsert` / `besales_followup_sequence_upsert`.