@besales/mcp 0.37.1 → 0.39.0

package/dist/schemas/mcp-tools.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "besales-mcp Tool Definitions",
   "version": "1.2.0-draft",
-  "lastUpdated": "2026-07-28",
+  "lastUpdated": "2026-08-14",
   "description": "MCP tool schemas для besales-mcp npm package. Active v1.5 set содержит PromptHub/ICP/Sandbox/Knowledge external-execution operations и stateless Platform Setup Bridge direct tools. Setup Pipeline session tools сохранены как Phase 4+ future design, но не входят в active toolset.",
   "executionModes": {
     "summary": "Каждая active LLM-операция имеет 2 MCP tools: get_instructions + submit. Claude локально между tools выполняет LLM-вызовы своими моделями. Auto-detection через JWT scope mcp:* → external default.",
@@ -3061,7 +3061,8 @@
             "format": "uuid"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           },
           "confirmation_reason": {
             "type": "string"
@@ -3517,7 +3518,7 @@
                     }
                   }
                 },
-                "description": "Условия принадлежности контакта цепочке, соединяются через И. Применяются при ЛЮБОМ filterMode (при variable обязателен и непуст, иначе цепочка не выберет никого). Для ветвления по варианту рассылки: переменная WAVE_MAILING_VARIANT, значение — UUID варианта из каталога воркспейса, а НЕ его имя (first-ver будет отвергнут). Отдельные цепочки НЕ взаимоисключающи: прогресс изолирован по sequenceId, поэтому безусловная ловящая цепочка рядом с eq A и eq B не подстрахует, а удвоит отправку. Набор обязан быть строгим разбиением: eq A, eq B и fallback neq A AND neq B (у контакта без переменной eq/in ложно, neq истинно)."
+                "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",
@@ -3767,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"
@@ -3956,7 +3958,8 @@
                 "type": "string"
               },
               "is_active": {
-                "type": "boolean"
+                "type": "boolean",
+                "description": "У Instagram это НАМЕРЕНИЕ держать канал включённым, а не факт работы. Эффективная активность = намерение И подтверждённая подписка на вебхуки, поэтому besales_platform_context_get может вернуть is_active=false сразу после успешного сохранения is_active=true — это не отказ операции, а неподтверждённая подписка (лечится повтором подписки в настройках канала). У остальных 12 каналов значение совпадает с фактом работы."
               }
             }
           },
@@ -4326,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."
               }
             }
           },
@@ -6367,7 +6377,8 @@
             "description": "Required when scope=CHANNEL"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6462,7 +6473,8 @@
             "description": "Required для GetCourse (manual funnel_id); ignored для AmoCRM/Bitrix24"
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6506,7 +6518,8 @@
             "type": "boolean"
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6536,10 +6549,12 @@
             "type": "integer"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6629,7 +6644,8 @@
             "description": "Required для GetCourse (manual funnel_stage_id)"
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6696,7 +6712,8 @@
             ]
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6730,10 +6747,12 @@
             "type": "integer"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           },
           "acknowledge_external_side_effect": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6797,7 +6816,8 @@
             "format": "uuid"
           },
           "explicit_confirmation": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           }
         }
       }
@@ -6907,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",
@@ -7306,7 +7328,8 @@
             "format": "uuid"
           },
           "replace_all_existing": {
-            "const": true
+            "const": true,
+            "type": "boolean"
           },
           "enabled": {
             "type": "boolean"
@@ -8068,7 +8091,7 @@
     },
     {
       "name": "besales_broadcast_analytics_get",
-      "description": "Read-only все данные страницы /broadcast-analytics: отчёты, drill-down, справочники сегментов и продуктов, качество данных и подтверждения оплат. Выбери report; общие фильтры совпадают с UI. Scope: read:analytics.",
+      "description": "Read-only все данные страницы /broadcast-analytics: отчёты, drill-down, справочники сегментов и продуктов, качество данных и подтверждения оплат. Выбери report; общие фильтры совпадают с UI. Scope: read:analytics для агрегатов; отчёты со строками про конкретных людей (recipients, deals, action_failures, indirect_payments, potential_payments, recent_leads, payment_candidates) требуют дополнительно read:conversations — композитный mcp:* покрывает оба.",
       "inputSchema": {
         "type": "object",
         "required": [],
@@ -8190,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": [
               {
@@ -8506,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": [
               {
@@ -9012,13 +9083,108 @@
           "description": {
             "type": "string",
             "maxLength": 4000
+          },
+          "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": "Платформа запуска по умолчанию; подставляется, если на запуске не передана."
           }
         }
       }
     },
     {
       "name": "besales_broadcast_mailing_variant_update",
-      "description": "Изменить название, описание или архивный статус «Варианта рассылки».",
+      "description": "Изменить название, описание или архивный статус «Варианта рассылки». Теперь вариант несёт и ТЕКСТ рассылки с дефолтами запуска.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -9054,6 +9220,101 @@
             "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": {
@@ -9102,8 +9363,8 @@
       }
     },
     {
-      "name": "besales_dialogue_audit_config_get",
-      "description": "Read-only настройки «Ревизора диалогов» на канале: включён ли плановый разбор, модель, час запуска, инструкции. isConfigured=false — строки конфига ещё нет, значения дефолтные. Запись настроек через MCP не выведена. Scope: read:analytics.",
+      "name": "besales_getcourse_cold_welcome_preview",
+      "description": "Охват рассылки «Первое сообщение» БЕЗ отправки: totalContacts (ещё могут получить), alreadyWelcomed (уже получали — первое сообщение одноразово на контакт), foundContacts.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -9111,66 +9372,426 @@
         ],
         "additionalProperties": false,
         "properties": {
-          "platform_id": {
+          "workspace_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": {
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
           "platform_id": {
             "type": "string",
-            "format": "uuid",
-            "description": "Канал."
+            "format": "uuid"
           },
-          "cursor": {
+          "created_after": {
             "type": "string",
-            "description": "nextCursor предыдущей страницы."
+            "format": "date-time",
+            "description": "Аудитория «по дате»: нижняя граница по дате создания контакта. Ровно одна аудитория — created_after ЛИБО contacts."
           },
-          "limit": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 100,
-            "description": "Размер страницы."
+          "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_dialogue_audit_run_get",
-      "description": "Отчёт прогона: статус, счётчики охвата (candidate/audited/failed segments), сводка, причина обрыва. Счётчики зафиксированы и не пересчитываются. Scope: read:analytics.",
+      "name": "besales_getcourse_cold_welcome_start",
+      "description": "Запустить рассылку «Первое сообщение» (мы пишем первыми контактам без диалога). НЕОБРАТИМО: у GetCourse нет идемпотентности, отправку нельзя отозвать. Всегда сначала preview и подтверждение пользователя. Аудитория: по дате (created_after) или по файлу (contacts). Поля сделки штампуются после отправки. Если у рассылки заданы тексты по сегментам, значение segment ВЫБИРАЕТ текст: назови пользователю выбранный текст ДО подтверждения и не запускай посегментный текст по created_after.",
       "inputSchema": {
         "type": "object",
         "required": [
-          "run_id"
+          "explicit_confirmation"
         ],
         "additionalProperties": false,
         "properties": {
-          "run_id": {
+          "workspace_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": [
+            "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_getcourse_cold_welcome_batch_status",
+      "description": "Состояние пакета: агрегат state и разбивка segments[] со своим статусом, importJobId и причиной отказа у каждого. stalled=true — драйвер оборвался, остаток пакета надо запустить заново.",
+      "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_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,
+        "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"
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": 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 + read:conversations — находка несёт цитату реплики конкретного человека, а не агрегат (композитный mcp:* покрывает оба).",
+      "inputSchema": {
+        "type": "object",
+        "required": [
           "run_id"
         ],
         "additionalProperties": false,
@@ -9258,6 +9879,224 @@
           }
         }
       }
+    },
+    {
+      "name": "besales_tracked_link_list",
+      "description": "Каталог коротких трекинговых ссылок workspace со сводкой «выдано → клики → ответы → заявки → оплаты». Поле placeholder — готовый токен {{link:slug}} для текстов дожимов, рассылок и шаблонов: вставляется ИМЕННО он, сырой URL мимо трекинга не считается. staticUrl — анонимный короткий адрес для мест без персональной выдачи (промпт агента, письмо школы). Ответ постраничный; hasMore=true означает, что каталог не дочитан. Scope: read:analytics. ⚠️ Токен берётся ТОЛЬКО копированием поля placeholder: собранный вручную токен с неточным слагом вырезается вместе с маркером, и клиент получает фразу без ссылки. В промпт агента токен не кладут — там staticUrl.",
+      "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."
+          },
+          "include_archived": {
+            "type": "boolean",
+            "description": "Показать и архивные ссылки. Их слаги ЗАНЯТЫ: создание с тем же слагом даст 409. Архивные идут первыми."
+          },
+          "days": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 366,
+            "description": "Глубина сводки в днях (по умолчанию 60)."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 200,
+            "description": "Размер страницы (по умолчанию 50)."
+          },
+          "offset": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Смещение страницы."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_tracked_link_create",
+      "description": "Завести трекинговую ссылку: имя, слаг и целевой http(s)-адрес. В ответе приходит placeholder {{link:slug}} — вставляй его в тексты вместо сырого URL, иначе переход не попадёт в аналитику. Слаг НЕИЗМЕНЯЕМ (он уходит в отправленные сообщения) и уникален в workspace; 409 значит, что слаг занят живой ИЛИ архивной ссылкой — архивную восстанавливают besales_tracked_link_update(restore=true), а не заводят новую. Scope: mcp:platform-setup. ⚠️ В тексты вставляется поле placeholder из ответа ДОСЛОВНО, а не собранный вручную токен: неточный слаг вырежется и клиент получит фразу без ссылки.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "name",
+          "slug",
+          "target_url"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "description": "Название для аналитики, например «Эфир 1, 15:00»."
+          },
+          "slug": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]{1,64}$",
+            "description": "Часть плейсхолдера {{link:slug}}: латиница, цифры, дефис, подчёркивание, до 64 символов. Изменить потом нельзя."
+          },
+          "target_url": {
+            "type": "string",
+            "maxLength": 2048,
+            "description": "Абсолютный http(s)-адрес, куда ведёт ссылка. Только http/https.",
+            "pattern": "^https?://"
+          },
+          "product_code": {
+            "type": "string",
+            "maxLength": 64,
+            "description": "Код продукта для сводки каталога."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_tracked_link_update",
+      "description": "Изменить название, целевой адрес или код продукта ссылки либо снять её из архива (restore=true). Требуется хотя бы одно изменяемое поле. ⚠️ Правка target_url действует ТОЛЬКО ВПЕРЁД: персональные коды, уже ушедшие людям, остаются на СТАРОМ адресе (каждая выдача хранит снимок адреса на момент отправки, резолвер читает его), новые выдачи получат новый адрес, анонимный staticUrl переключится сразу. Перенаправить тех, кому ссылка уже отправлена, правкой НЕЛЬЗЯ — нужна новая ссылка в новом тексте. Поля ответа сюда не копируются: slug неизменяем, archivedAt не поле записи (архивация — besales_tracked_link_archive), счётчики и placeholder только читаются. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "link_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "link_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "UUID ссылки из каталога."
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "target_url": {
+            "type": "string",
+            "maxLength": 2048,
+            "description": "Новый абсолютный http(s)-адрес. Действует только вперёд: уже отправленные персональные коды остаются на прежней цели (там снимок адреса).",
+            "pattern": "^https?://"
+          },
+          "product_code": {
+            "type": "string",
+            "maxLength": 64
+          },
+          "restore": {
+            "const": true,
+            "type": "boolean",
+            "description": "Снять ссылку из архива. Архивирует besales_tracked_link_archive."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_tracked_link_archive",
+      "description": "Архивировать ссылку. Удаления у трекинговых ссылок НЕТ и не будет: код уже лежит в отправленных людям сообщениях, и hard-delete превратил бы живую ссылку в 404. Архивная ссылка перестаёт подставляться в новые тексты, но её код продолжает резолвиться, клики считаются, а слаг остаётся занятым. Восстановление — besales_tracked_link_update(restore=true). Требует explicit_confirmation=true после явного подтверждения пользователя. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "link_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."
+          },
+          "link_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "UUID ссылки из каталога."
+          },
+          "explicit_confirmation": {
+            "const": true,
+            "type": "boolean",
+            "description": "Подтверждение пользователя на архивацию ссылки."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_tracked_link_breakdown",
+      "description": "Разрез одной ссылки по источникам выдачи: WAVE (волна), FOLLOWUP (дожим), CAMPAIGN (кампания), GREETING (приветствие), AGENT (обычный ответ агента) — с воронкой по каждому. Отвечает на вопрос «после чего по ссылке ходят», а не «каким сообщением она ушла». Оплата атрибутируется last-touch по ближайшему клику. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "link_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "link_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "UUID ссылки из каталога."
+          },
+          "days": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 366,
+            "description": "Глубина сводки в днях (по умолчанию 60)."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_tracked_link_clicks",
+      "description": "Лента переходов по ссылке: контакт, сообщение, источник выдачи и время. Клики-предпросмотры мессенджеров отсеяны. ⚠️ Анонимные переходы по staticUrl В ЛЕНТЕ ЕСТЬ — строками с null в chatUserId/contactName/messageId/issuedAt/sourceKind (у анонимного кода человека нет по построению); не считай их людьми, их суммарное число лежит в каталоге полем anonymousClicks. ⚠️ total — число КЛИКОВ (включая повторные и анонимные), а clicked в каталоге — число ВЫДАЧ с первым живым кликом: величины разные и сходиться не обязаны. Постранично: page + page_size (максимум 200). Scope: read:analytics + read:conversations (лента несёт имя контакта и id сообщения; композитный mcp:* покрывает оба).",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "link_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "link_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "UUID ссылки из каталога."
+          },
+          "days": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 366,
+            "description": "Глубина сводки в днях (по умолчанию 60)."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 200
+          }
+        }
+      }
     }
   ],
   "resources": [
@@ -9449,7 +10288,7 @@
     }
   ],
   "summary": {
-    "total_tools": 177,
+    "total_tools": 191,
     "tools_by_category": {
       "getcourse_wave": 10,
       "files_upload": 3,
@@ -9488,7 +10327,8 @@
       "broadcast_analytics": 2,
       "scheduled_tasks": 2,
       "follow_up_read": 3,
-      "dialogue_audit": 6
+      "dialogue_audit": 6,
+      "link_tracking": 6
     },
     "external_execution_pairs": [
       "besales_icp_analysis_get_instructions / submit",
@@ -9680,6 +10520,14 @@
     ],
     "newly_added_in_followup_reactions": [
       "besales_followup_reactions"
+    ],
+    "newly_added_in_link_tracking": [
+      "besales_tracked_link_list",
+      "besales_tracked_link_create",
+      "besales_tracked_link_update",
+      "besales_tracked_link_archive",
+      "besales_tracked_link_breakdown",
+      "besales_tracked_link_clicks"
     ]
   }
 }