@besales/mcp 0.37.0 → 0.38.0

package/dist/schemas/mcp-tools.json

@@ -2849,7 +2849,7 @@
     },
     {
       "name": "besales_routing_rule_upsert",
-      "description": "Create or patch one router routing rule. Does not bulk replace the router. Direct agent routing requires explicit_confirmation. For CUSTOM_VARIABLE pass either conditions[] (N conditions joined by condition_logic ALL=AND / ANY=OR) or the legacy custom_variable_id+variable_value pair (single condition).",
+      "description": "Create or patch one router routing rule. Does not bulk replace the router. Direct agent routing requires explicit_confirmation. For CUSTOM_VARIABLE pass either conditions[] (N conditions joined by condition_logic ALL=AND / ANY=OR) or the legacy custom_variable_id+variable_value pair (single condition). Each condition holds a SET of values in variable_values[]: the condition matches when the contact variable equals ANY of them (OR inside the condition). Combined with condition_logic=ALL this expresses AND-of-ORs without nested parentheses, e.g. AI_TOPIC in [dbo] AND WAVE_SEGMENT in [post-web, post-web-2] — use ONE rule with two conditions, not two rules. Legacy single-value form variable_value is still accepted per condition. Editing an existing rule that has multi-value conditions requires conditions[]; the legacy scalar does not replace them and returns 409.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -2905,14 +2905,21 @@
             "items": {
               "type": "object",
               "required": [
-                "custom_variable_id",
-                "variable_value"
+                "custom_variable_id"
               ],
               "properties": {
                 "custom_variable_id": {
                   "type": "string",
                   "format": "uuid"
                 },
+                "variable_values": {
+                  "type": "array",
+                  "minItems": 1,
+                  "maxItems": 50,
+                  "items": {
+                    "type": "string"
+                  }
+                },
                 "variable_value": {
                   "type": "string"
                 }
@@ -3016,6 +3023,14 @@
           },
           "confirmation_reason": {
             "type": "string"
+          },
+          "allow_repeated_calls": {
+            "type": "boolean",
+            "description": "Повтор ВНУТРИ одного ответа модели."
+          },
+          "run_once_per_contact": {
+            "type": "boolean",
+            "description": "Одно срабатывание на контакт НАВСЕГДА. Другая ось, чем allow_repeated_calls."
           }
         }
       }
@@ -3046,7 +3061,8 @@
             "format": "uuid"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           },
           "confirmation_reason": {
             "type": "string"
@@ -3123,7 +3139,7 @@
           },
           "media_handling": {
             "type": "object",
-            "description": "Стратегии обработки image/video/audio/document.",
+            "description": "Стратегии обработки image/video/audio/document. PROCESS_WITH_LLM разбирает вложение по-разному: image → vision-модель, video → подпись как текст, document → извлечённый текст файла (PDF/DOCX/DOC/XLSX/XLS/CSV/TXT; скан без текстового слоя и неподдерживаемый формат уводят на оператора). Для audio его нет вовсе — там только SILENT и FIXED_RESPONSE, иначе бэкенд отвечает 400.",
             "properties": {
               "image": {
                 "$ref": "#/$defs/mediaHandler"
@@ -3132,7 +3148,7 @@
                 "$ref": "#/$defs/mediaHandler"
               },
               "audio": {
-                "$ref": "#/$defs/mediaHandler"
+                "$ref": "#/$defs/plainMediaHandler"
               },
               "document": {
                 "$ref": "#/$defs/mediaHandler"
@@ -3207,6 +3223,7 @@
               "bot_waiting_return_hours": {
                 "type": "integer",
                 "enum": [
+                  -1,
                   0,
                   1,
                   3,
@@ -3343,6 +3360,7 @@
         "$defs": {
           "mediaHandler": {
             "type": "object",
+            "description": "Обработчик вложения, поддерживающего разбор моделью (image, video, document).",
             "required": [
               "behavior"
             ],
@@ -3365,6 +3383,31 @@
                 "type": "string"
               }
             }
+          },
+          "plainMediaHandler": {
+            "type": "object",
+            "description": "Обработчик вложения без разбора моделью (audio): у AudioHandlingBehavior нет значения PROCESS_WITH_LLM.",
+            "required": [
+              "behavior"
+            ],
+            "properties": {
+              "behavior": {
+                "type": "string",
+                "enum": [
+                  "SILENT",
+                  "FIXED_RESPONSE"
+                ]
+              },
+              "fixed_response_text": {
+                "type": "string"
+              },
+              "call_operator": {
+                "type": "boolean"
+              },
+              "operator_comment": {
+                "type": "string"
+              }
+            }
           }
         }
       }
@@ -3435,7 +3478,7 @@
                   "eventType",
                   "variable"
                 ],
-                "description": "Режим отбора контактов. Неизвестное значение НЕ включает ни один фильтр — цепочка ушла бы всем контактам канала, поэтому бэкенд его отвергает."
+                "description": "БАЗОВЫЙ отбор: по статусу CRM, по типу события платформы либо variable = базового фильтра нет (отбор только по sequenceConditions). Условия по переменным ортогональны и добавляются через И: чтобы ветвить цепочки по варианту рассылки, сохранив отбор по событию, бери eventType и задай sequenceConditions, а НЕ variable. Неизвестное значение НЕ включает ни один фильтр — цепочка ушла бы всем контактам канала, поэтому бэкенд его отвергает."
               },
               "sequenceConditions": {
                 "type": "array",
@@ -3475,7 +3518,7 @@
                     }
                   }
                 },
-                "description": "Обязателен и непуст при filterMode=variable."
+                "description": "Условия принадлежности контакта цепочке, соединяются через И. Применяются при ЛЮБОМ filterMode (при variable обязателен и непуст, иначе цепочка не выберет никого). Ветвление по измерениям рассылки GetCourse: WAVE_MAILING_VARIANT — UUID варианта из каталога воркспейса, а НЕ его имя (first-ver будет отвергнут); WAVE_PRODUCT — код продукта строчными без пробелов (dbo); WAVE_FUNNEL — КЛЮЧ воронки (f-код f11, иначе вся строка строчными), а НЕ метка запуска (f11 — ВК NR ДБО будет отвергнут); WAVE_SEGMENT — имя сегмента. Значения проставляет запуск рассылки, у контакта без рассылки их нет. Отдельные цепочки НЕ взаимоисключающи: прогресс изолирован по sequenceId, поэтому безусловная ловящая цепочка рядом с eq A и eq B не подстрахует, а удвоит отправку. Набор обязан быть строгим разбиением: eq A, eq B и fallback neq A AND neq B (у контакта без переменной eq/in ложно, neq истинно)."
               },
               "steps": {
                 "type": "array",
@@ -3595,6 +3638,33 @@
         }
       }
     },
+    {
+      "name": "besales_followup_sequence_clone",
+      "description": "Скопировать follow-up sequence на ТОЙ ЖЕ платформе. Копия всегда создаётся ВЫКЛЮЧЕННОЙ: прогресс изолирован по sequenceId, и включённая копия слала бы те же касания тем же контактам вторым потоком. Копируется только определение (имя, тип, триггер, config) — прогресс контактов, история отправок и запланированные сообщения не копируются. Имя не передано — сервер подберёт свободное (<имя>-copy, <имя>-copy-2, …). Cross-platform не поддерживается: конфиг ссылается на статусы CRM, агентов, файлы и переменные своей платформы.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "platform_id",
+          "sequence_id"
+        ],
+        "properties": {
+          "platform_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Платформа источника; копия приземляется на неё же."
+          },
+          "sequence_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Исходный FollowUpSequence для копирования."
+          },
+          "name": {
+            "type": "string",
+            "description": "Имя копии. Не передано — сервер подберёт свободное от имени источника; передано и занято — тот же подбор применится к нему."
+          }
+        }
+      }
+    },
     {
       "name": "besales_pipeline_settings_update",
       "description": "Patch allowlisted platform PipelineSettings via typed sections (crm_pipeline_behavior, auto_finish). Phase B (2026-05-27): generic `updates` field удалён — отвергается с 400. CRM stage movement or lead/contact creation fields require explicit_confirmation.",
@@ -3698,7 +3768,8 @@
             "type": "object",
             "properties": {
               "is_active": {
-                "type": "boolean"
+                "type": "boolean",
+                "description": "У Instagram это НАМЕРЕНИЕ держать канал включённым, а не факт работы. Эффективная активность = намерение И подтверждённая подписка на вебхуки, поэтому besales_platform_context_get может вернуть is_active=false сразу после успешного сохранения is_active=true — это не отказ операции, а неподтверждённая подписка (лечится повтором подписки в настройках канала). У остальных 12 каналов значение совпадает с фактом работы."
               },
               "is_ai_enabled": {
                 "type": "boolean"
@@ -3887,7 +3958,8 @@
                 "type": "string"
               },
               "is_active": {
-                "type": "boolean"
+                "type": "boolean",
+                "description": "У Instagram это НАМЕРЕНИЕ держать канал включённым, а не факт работы. Эффективная активность = намерение И подтверждённая подписка на вебхуки, поэтому besales_platform_context_get может вернуть is_active=false сразу после успешного сохранения is_active=true — это не отказ операции, а неподтверждённая подписка (лечится повтором подписки в настройках канала). У остальных 12 каналов значение совпадает с фактом работы."
               }
             }
           },
@@ -4257,6 +4329,13 @@
                   "null"
                 ],
                 "description": "OPTIONAL GetCourse stage id inside the funnel above. Must be set together with create_missing_deal_funnel_id."
+              },
+              "revenue_offer_ids": {
+                "type": "array",
+                "items": {
+                  "type": "integer"
+                },
+                "description": "GetCourse offer ids whose paid orders are credited to us regardless of who created the order — the agent via GETCOURSE_CREATE_DEAL or a manager by hand in the GetCourse admin. Empty array turns the rule off. The set applies to the whole school (every platform sharing the GetCourse domain), not to a single platform. Changes money attribution retroactively — dangerous, requires explicit_confirmation."
               }
             }
           },
@@ -6298,7 +6377,8 @@
             "description": "Required when scope=CHANNEL"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6393,7 +6473,8 @@
             "description": "Required для GetCourse (manual funnel_id); ignored для AmoCRM/Bitrix24"
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6437,7 +6518,8 @@
             "type": "boolean"
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6467,10 +6549,12 @@
             "type": "integer"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6560,7 +6644,8 @@
             "description": "Required для GetCourse (manual funnel_stage_id)"
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6627,7 +6712,8 @@
             ]
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6661,10 +6747,12 @@
             "type": "integer"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6728,7 +6816,8 @@
             "format": "uuid"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6838,10 +6927,12 @@
             "format": "uuid"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           },
           "acknowledge_destructive_overwrite": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           },
           "idempotency_key": {
             "type": "string",
@@ -7237,7 +7328,8 @@
             "format": "uuid"
           },
           "replace_all_existing": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           },
           "enabled": {
             "type": "boolean"
@@ -8121,6 +8213,30 @@
             ],
             "description": "Один или несколько ID именованных вариантов рассылки."
           },
+          "mechanism": {
+            "oneOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "wave",
+                  "cold_welcome"
+                ]
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 2,
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "wave",
+                    "cold_welcome"
+                  ]
+                }
+              }
+            ],
+            "description": "Механизм запуска: wave — доставляет процесс школы (мы штампуем поля сделки), cold_welcome — пишем первыми сами. Оба значения = фильтра нет."
+          },
           "product": {
             "oneOf": [
               {
@@ -8437,6 +8553,30 @@
               }
             ]
           },
+          "mechanism": {
+            "oneOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "wave",
+                  "cold_welcome"
+                ]
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 2,
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "wave",
+                    "cold_welcome"
+                  ]
+                }
+              }
+            ],
+            "description": "Механизм запуска: wave — доставляет процесс школы (мы штампуем поля сделки), cold_welcome — пишем первыми сами. Оба значения = фильтра нет."
+          },
           "product": {
             "oneOf": [
               {
@@ -8597,6 +8737,77 @@
         }
       }
     },
+    {
+      "name": "besales_followup_reactions",
+      "description": "Read-only аналитика дожимов: на какой шаг follow-up-цепочки контакт реально отреагировал. Метрик ДВЕ — операционная (следует за длиной окна шага, шаги по ней сравнивать нельзя) и сравнительная на равном горизонте (сравнивать можно только при comparableReliable=true). Срезы по сегменту/продукту/мессенджеру доступны только у каналов с рассылками. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "platform_id",
+          "from",
+          "to"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "platform_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "from": {
+            "type": "string",
+            "format": "date",
+            "description": "Начало периода по дате отправки шага (YYYY-MM-DD, московские сутки)."
+          },
+          "to": {
+            "type": "string",
+            "format": "date",
+            "description": "Конец периода. Период длиннее 366 суток отвергается с 400."
+          },
+          "sequence_id": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "description": "Фильтр цепочек. НЕ влияет на атрибуцию: окно ответа считается по полной шкале касаний."
+          },
+          "horizon_minutes": {
+            "type": "integer",
+            "enum": [
+              30,
+              60,
+              90,
+              180,
+              360,
+              720,
+              1440
+            ],
+            "description": "Горизонт сравнительной метрики, минуты. По умолчанию 90."
+          },
+          "segment": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Сегменты волны; доступные значения приходят в ответе (dimensions.segments)."
+          },
+          "product": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Продукты волны (dimensions.products)."
+          },
+          "channel": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Транспорты волны (dimensions.channels): Telegram, WhatsApp, MAX, VK."
+          }
+        }
+      }
+    },
     {
       "name": "besales_scheduled_task_list",
       "description": "Read-only список плановых задач канала (модуль «Задачи»). Единственный тип — DIALOGUE_ANALYSIS (суфлёр: саммари дня + почасовой «Статус коммуникации»). Scope: mcp:platform-setup.",
@@ -8773,6 +8984,39 @@
             },
             "description": "ASSIGNED_BY_ID ответственных Bitrix (не наши id — бери из besales_crm_operator_list). Разбираются ТОЛЬКО перечисленные. Пусто = не выбрано (включённая задача вернёт 400), а НЕ «все»."
           },
+          "stages": {
+            "type": [
+              "array",
+              "null"
+            ],
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "pipeline_crm_id",
+                "pipeline_id",
+                "status_id"
+              ],
+              "properties": {
+                "pipeline_crm_id": {
+                  "type": "string",
+                  "format": "uuid",
+                  "description": "UUID CRM-интеграции."
+                },
+                "pipeline_id": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Числовой id воронки CRM."
+                },
+                "status_id": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Номер колонки внутри воронки."
+                }
+              }
+            },
+            "description": "Колонки ВНУТРИ выбранных воронок, общие для обоих режимов. Семантика пустоты ОБРАТНАЯ воронкам: ключа нет или null — все колонки выбранных воронок, воронка без выбранных колонок идёт целиком. ПУСТОЙ массив у включённой задачи вернёт 400. Стадия — тройка: номер колонки уникален лишь внутри пары (CRM, воронка)."
+          },
           "daily_prompt": {
             "type": [
               "string",
@@ -8839,74 +9083,577 @@
           "description": {
             "type": "string",
             "maxLength": 4000
-          }
-        }
-      }
-    },
-    {
-      "name": "besales_broadcast_mailing_variant_update",
-      "description": "Изменить название, описание или архивный статус «Варианта рассылки».",
-      "inputSchema": {
-        "type": "object",
-        "required": [
-          "mailing_variant_id"
-        ],
-        "additionalProperties": false,
-        "properties": {
-          "workspace_id": {
-            "type": "string",
-            "format": "uuid",
-            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
           },
-          "mailing_variant_id": {
-            "type": "string",
-            "format": "uuid"
+          "message_text": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4000,
+            "description": "Текст рассылки для механизма «Первое сообщение»: {firstName}, переменные платформы/воркспейса и {{link:slug}} позволены. null = очистить."
           },
-          "name": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 200
+          "message_text_by_segment": {
+            "type": [
+              "object",
+              "null"
+            ],
+            "description": "Тексты по сегментам: ключ — имя сегмента из справочника воркспейса, значение — текст для него. Запуск с меткой такого сегмента отправит его текст вместо message_text. Работает только при аудитории по файлу: когорта по дате сегментом не отбирается. null или {} — убрать посегментные тексты.",
+            "propertyNames": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            "additionalProperties": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4000
+            },
+            "maxProperties": 50
           },
-          "description": {
+          "default_segment": {
             "type": [
               "string",
               "null"
             ],
-            "maxLength": 4000
+            "maxLength": 200,
+            "description": "Метка аналитики по умолчанию; аудиторию НЕ фильтрует."
           },
-          "archived": {
-            "type": "boolean"
+          "default_product_code": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 200,
+            "description": "Метка аналитики по умолчанию."
           },
-          "explicit_confirmation": {
-            "type": "boolean",
-            "const": true,
-            "description": "Обязательно true при archived=true после явного подтверждения пользователя."
-          }
-        },
-        "if": {
+          "default_funnel": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 200,
+            "description": "Метка аналитики по умолчанию."
+          },
+          "default_channels": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "Site",
+                "Email",
+                "SMS",
+                "Telegram",
+                "Facebook",
+                "VK",
+                "Chatium",
+                "WhatsApp",
+                "Viber",
+                "MAX"
+              ]
+            },
+            "description": "Каналы Шага 2 волны по файлу по умолчанию; подставляются в запуск волны."
+          },
+          "default_deal_fields": {
+            "type": [
+              "object",
+              "null"
+            ],
+            "additionalProperties": {
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            },
+            "description": "Поля сделки Шага 2 по умолчанию: ключ — числовой fieldId GetCourse. null = очистить.",
+            "propertyNames": {
+              "pattern": "^\\d+$"
+            }
+          },
+          "default_platform_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid",
+            "description": "Платформа запуска по умолчанию; подставляется, если на запуске не передана."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_broadcast_mailing_variant_update",
+      "description": "Изменить название, описание или архивный статус «Варианта рассылки». Теперь вариант несёт и ТЕКСТ рассылки с дефолтами запуска.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "mailing_variant_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "mailing_variant_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4000
+          },
+          "archived": {
+            "type": "boolean"
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Обязательно true при archived=true после явного подтверждения пользователя."
+          },
+          "message_text": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4000,
+            "description": "Текст рассылки для механизма «Первое сообщение»: {firstName}, переменные платформы/воркспейса и {{link:slug}} позволены. null = очистить."
+          },
+          "message_text_by_segment": {
+            "type": [
+              "object",
+              "null"
+            ],
+            "description": "Тексты по сегментам: ключ — имя сегмента из справочника воркспейса, значение — текст для него. Запуск с меткой такого сегмента отправит его текст вместо message_text. Работает только при аудитории по файлу: когорта по дате сегментом не отбирается. null или {} — убрать посегментные тексты.",
+            "propertyNames": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            "additionalProperties": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4000
+            },
+            "maxProperties": 50
+          },
+          "default_segment": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 200,
+            "description": "Метка аналитики по умолчанию; аудиторию НЕ фильтрует."
+          },
+          "default_product_code": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 200,
+            "description": "Метка аналитики по умолчанию."
+          },
+          "default_funnel": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 200,
+            "description": "Метка аналитики по умолчанию."
+          },
+          "default_channels": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "Site",
+                "Email",
+                "SMS",
+                "Telegram",
+                "Facebook",
+                "VK",
+                "Chatium",
+                "WhatsApp",
+                "Viber",
+                "MAX"
+              ]
+            },
+            "description": "Каналы Шага 2 волны по файлу по умолчанию; подставляются в запуск волны."
+          },
+          "default_deal_fields": {
+            "type": [
+              "object",
+              "null"
+            ],
+            "additionalProperties": {
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            },
+            "description": "Поля сделки Шага 2 по умолчанию: ключ — числовой fieldId GetCourse. null = очистить.",
+            "propertyNames": {
+              "pattern": "^\\d+$"
+            }
+          },
+          "default_platform_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid",
+            "description": "Платформа запуска по умолчанию; подставляется, если на запуске не передана."
+          }
+        },
+        "if": {
           "properties": {
             "archived": {
               "const": true
             }
           },
-          "required": [
-            "archived"
-          ]
-        },
-        "then": {
-          "required": [
-            "explicit_confirmation"
-          ]
+          "required": [
+            "archived"
+          ]
+        },
+        "then": {
+          "required": [
+            "explicit_confirmation"
+          ]
+        }
+      }
+    },
+    {
+      "name": "besales_broadcast_mailing_variant_delete",
+      "description": "Архивировать «Вариант рассылки», сохранив историческую аналитику и ссылки отложенных durable-run.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "mailing_variant_id",
+          "explicit_confirmation"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "mailing_variant_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Обязательно true после явного подтверждения пользователя."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_getcourse_cold_welcome_preview",
+      "description": "Охват рассылки «Первое сообщение» БЕЗ отправки: totalContacts (ещё могут получить), alreadyWelcomed (уже получали — первое сообщение одноразово на контакт), foundContacts.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "platform_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "platform_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "created_after": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Аудитория «по дате»: нижняя граница по дате создания контакта. Ровно одна аудитория — created_after ЛИБО contacts."
+          },
+          "contacts": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 5000,
+            "description": "Аудитория «по файлу»: контакты предсписка. Ровно одна аудитория на запуск — created_after ЛИБО contacts.",
+            "items": {
+              "type": "object",
+              "required": [
+                "contact_id"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "contact_id": {
+                  "type": "string",
+                  "pattern": "^\\d+$",
+                  "description": "getcourseUserId контакта (число в строковом виде)"
+                },
+                "deal_id": {
+                  "type": "string",
+                  "pattern": "^\\d+$",
+                  "description": "Пин сделки для штампа полей (число в строковом виде)"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_getcourse_cold_welcome_start",
+      "description": "Запустить рассылку «Первое сообщение» (мы пишем первыми контактам без диалога). НЕОБРАТИМО: у GetCourse нет идемпотентности, отправку нельзя отозвать. Всегда сначала preview и подтверждение пользователя. Аудитория: по дате (created_after) или по файлу (contacts). Поля сделки штампуются после отправки. Если у рассылки заданы тексты по сегментам, значение segment ВЫБИРАЕТ текст: назови пользователю выбранный текст ДО подтверждения и не запускай посегментный текст по created_after.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "explicit_confirmation"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "platform_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Можно опустить, если у рассылки задана «Платформа по умолчанию»."
+          },
+          "created_after": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "message": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 4000,
+            "description": "Разовый текст. Ровно один источник: message ЛИБО mailing_variant_id."
+          },
+          "mailing_variant_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Сохранённая рассылка: текст берётся из неё, метки — из её дефолтов."
+          },
+          "segment": {
+            "type": "string",
+            "maxLength": 200,
+            "description": "Сегмент запуска. ⚠️ Аудиторию НЕ отбирает: когорту задают платформа и граница даты. ⚠️⚠️ Если у рассылки есть текст ИМЕННО для этого сегмента (message_text_by_segment), он выбирает текст запуска — и тогда аудитория обязана быть файловой (contacts): с created_after такой запуск отвергается 400, потому что текст ушёл бы всей базе после границы."
+          },
+          "product_code": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "funnel": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Подтверждение пользователя, полученное ПОСЛЕ показа охвата из preview."
+          },
+          "contacts": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 5000,
+            "description": "Аудитория «по файлу»: контакты предсписка. Ровно одна аудитория на запуск — created_after ЛИБО contacts.",
+            "items": {
+              "type": "object",
+              "required": [
+                "contact_id"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "contact_id": {
+                  "type": "string",
+                  "pattern": "^\\d+$",
+                  "description": "getcourseUserId контакта (число в строковом виде)"
+                },
+                "deal_id": {
+                  "type": "string",
+                  "pattern": "^\\d+$",
+                  "description": "Пин сделки для штампа полей (число в строковом виде)"
+                }
+              }
+            }
+          },
+          "deal_fields": {
+            "type": "object",
+            "propertyNames": {
+              "pattern": "^\\d+$"
+            },
+            "additionalProperties": {
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            },
+            "description": "Поля сделки, проставляемые ПОСЛЕ успешной отправки (ключ — числовой fieldId). Ключ не передан — берутся дефолты рассылки; передан ПУСТОЙ объект — явное «на этом запуске без полей»."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_getcourse_cold_welcome_batch_start",
+      "description": "Запустить ПАКЕТ сегментов «Первого сообщения»: несколько сегментов одним вызовом, у каждого свой список контактов, свои метки и свои поля сделки. НЕОБРАТИМО. Сегменты идут ПО ОЧЕРЕДИ — задачи импорта не могут выполняться параллельно. Весь пакет проверяется ДО первой отправки: сегмент без текста отменяет пакет целиком. Если у рассылки заданы посегментные тексты, каждый сегмент отправит СВОЙ текст.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "segments",
+          "explicit_confirmation"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "platform_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "message": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 4000
+          },
+          "mailing_variant_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "segments": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 10,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "contacts"
+              ],
+              "properties": {
+                "segment": {
+                  "type": "string",
+                  "maxLength": 200,
+                  "description": "Сегмент блока. Он же выбирает текст рассылки, если у неё есть посегментные тексты."
+                },
+                "product_code": {
+                  "type": "string",
+                  "maxLength": 200
+                },
+                "funnel": {
+                  "type": "string",
+                  "maxLength": 200
+                },
+                "deal_fields": {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string",
+                    "pattern": "^\\d+$"
+                  }
+                },
+                "contacts": {
+                  "type": "array",
+                  "minItems": 1,
+                  "maxItems": 5000,
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                      "contact_id"
+                    ],
+                    "properties": {
+                      "contact_id": {
+                        "type": "string",
+                        "pattern": "^\\d+$"
+                      },
+                      "deal_id": {
+                        "type": "string",
+                        "pattern": "^\\d+$"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Подтверждение пользователя. Обязательно: отправку нельзя отозвать."
+          }
         }
       }
     },
     {
-      "name": "besales_broadcast_mailing_variant_delete",
-      "description": "Архивировать «Вариант рассылки», сохранив историческую аналитику и ссылки отложенных durable-run.",
+      "name": "besales_getcourse_cold_welcome_batch_status",
+      "description": "Состояние пакета: агрегат state и разбивка segments[] со своим статусом, importJobId и причиной отказа у каждого. stalled=true — драйвер оборвался, остаток пакета надо запустить заново.",
       "inputSchema": {
         "type": "object",
         "required": [
-          "mailing_variant_id",
+          "batch_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "batch_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_getcourse_cold_welcome_batch_resume",
+      "description": "Возобновить остаток пакета «Первого сообщения» после обрыва драйвера (stalled). Источник текста хранится в плане — пересобирать списки контактов не нужно. Повтора отправки не будет: приветствие одноразово НА КОНТАКТ.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "batch_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "batch_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_getcourse_cold_welcome_batch_cancel",
+      "description": "Отменить ОСТАТОК пакета: не начатые сегменты и идущую задачу. Уже отправленное не отзывается.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "batch_id",
           "explicit_confirmation"
         ],
         "additionalProperties": false,
@@ -8916,14 +9663,219 @@
             "format": "uuid",
             "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
           },
-          "mailing_variant_id": {
+          "batch_id": {
             "type": "string",
             "format": "uuid"
           },
           "explicit_confirmation": {
             "type": "boolean",
             "const": true,
-            "description": "Обязательно true после явного подтверждения пользователя."
+            "description": "Подтверждение пользователя. Обязательно: отправку нельзя отозвать."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_getcourse_cold_welcome_cancel",
+      "description": "Остановить идущую рассылку «Первое сообщение»: действует на остаток когорты (~10 секунд), уже отправленное не отзывается.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "job_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "job_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_broadcast_launches_list",
+      "description": "История запусков рассылок одним списком: наша отправка (cold_welcome, со снимком текста и разбивкой исходов) и волны по файлу (wave).",
+      "inputSchema": {
+        "type": "object",
+        "required": [],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "mailing_variant_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 50
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_dialogue_audit_config_get",
+      "description": "Read-only настройки «Ревизора диалогов» на канале: включён ли плановый разбор, модель, час запуска, инструкции. isConfigured=false — строки конфига ещё нет, значения дефолтные. Запись настроек через MCP не выведена. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "platform_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "platform_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Канал, для которого настроен ревизор."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_dialogue_audit_runs_list",
+      "description": "История прогонов ревизора на канале, курсорная пагинация (offset показал бы один прогон дважды). Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "platform_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "platform_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Канал."
+          },
+          "cursor": {
+            "type": "string",
+            "description": "nextCursor предыдущей страницы."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Размер страницы."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_dialogue_audit_run_get",
+      "description": "Отчёт прогона: статус, счётчики охвата (candidate/audited/failed segments), сводка, причина обрыва. Счётчики зафиксированы и не пересчитываются. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "run_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "run_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Прогон ревизора."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_dialogue_audit_findings",
+      "description": "Находки прогона — материал для правки промпта. Фильтры: агент, категория, важность, статус разметки человеком (NEW/LIKED/DISLIKED). truncated=true означает обрезанный список. Разметка находок через MCP НЕ выведена: это человеческая оценка работы ревизора. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "run_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "run_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Прогон ревизора."
+          },
+          "agent_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Оставить находки одного агента."
+          },
+          "category": {
+            "type": "string",
+            "description": "Категория находки."
+          },
+          "severity": {
+            "type": "string",
+            "description": "Важность находки."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "NEW",
+              "LIKED",
+              "DISLIKED"
+            ],
+            "description": "Разметка человеком. LIKED — ревизор прав, DISLIKED — человек находку отверг (применять её нельзя)."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_dialogue_audit_run_start",
+      "description": "Запустить разбор сейчас. Durable: ответ приходит сразу с runId, работа идёт в очереди. Уже разобранное заново не оплачивается. 409 — на канале уже идёт прогон. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "platform_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "platform_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Канал."
+          },
+          "period_from": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Начало периода. Задаётся ВМЕСТЕ с period_to; без них — всё непроверенное."
+          },
+          "period_to": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Конец периода."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "description": "Обязательно true. Операция тратит (или прерывает уже оплаченную) работу LLM клиента — подтверждается оператором явно."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_dialogue_audit_run_cancel",
+      "description": "Остановить прогон. Переходит в CANCELLED (это не ошибка), захваченные отрезки возвращаются в пул, недоразобранное подхватит следующий прогон. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "run_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "run_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Прогон ревизора."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "description": "Обязательно true. Операция тратит (или прерывает уже оплаченную) работу LLM клиента — подтверждается оператором явно."
           }
         }
       }
@@ -9118,7 +10070,7 @@
     }
   ],
   "summary": {
-    "total_tools": 169,
+    "total_tools": 185,
     "tools_by_category": {
       "getcourse_wave": 10,
       "files_upload": 3,
@@ -9156,7 +10108,8 @@
       "dialog_script": 2,
       "broadcast_analytics": 2,
       "scheduled_tasks": 2,
-      "follow_up_read": 2
+      "follow_up_read": 3,
+      "dialogue_audit": 6
     },
     "external_execution_pairs": [
       "besales_icp_analysis_get_instructions / submit",
@@ -9192,6 +10145,7 @@
       "besales_trigger_upsert",
       "besales_behavior_update",
       "besales_followup_sequence_upsert",
+      "besales_followup_sequence_clone",
       "besales_pipeline_settings_update",
       "besales_platform_settings_update",
       "besales_audit_revert"
@@ -9344,6 +10298,9 @@
       "besales_setup_session_create",
       "besales_setup_session_get",
       "besales_setup_step_submit_output"
+    ],
+    "newly_added_in_followup_reactions": [
+      "besales_followup_reactions"
     ]
   }
 }