@besales/mcp 1.0.0-beta.2 → 1.0.0-beta.5

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-09-11",
+  "lastUpdated": "2026-11-09",
   "description": "MCP tool schemas для besales-mcp npm package. Активная v2-поверхность содержит ICP, Sandbox, Knowledge, prompt operations и stateless Platform Setup Bridge. 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.",
@@ -3872,7 +3872,7 @@
     },
     {
       "name": "besales_trigger_upsert",
-      "description": "Create trigger, patch trigger metadata, or replace its full action set (replace_actions=true) for an agent. Without replace_actions existing actions are not bulk-replaced; webhook, operator, silent AI, CRM, calendar, outbound and follow-up actions require explicit_confirmation. В ответе вместо самих шагов и условий приходит их количество (actionsCount / activationsCount): эхо повторяло отправленное целиком и уносило контекст на каждой правке, а правят их десятками подряд. Текущий состав читается через besales_platform_context_get. Включённое действие, сохраняющее почту, названную клиентом (шаг SAVE_CONTACT_INFO с полем email ровно {{slots.email}}), записывается только с allow_repeat_in_conversation=true, иначе 422: первая попытка заняла бы право до закрытия переписки, и исправленный адрес сохранить было бы нельзя. Действию, записывающему значение из переписки (поле CRM без шаблона — input_type ai_text или ai_dropdown; заметка с input_type=ai_text; переменная с value_source=MODEL; поле школы из ai_fields с вариантами options), повтор рекомендован, но не обязателен: частичное извлечение занимает право, и названное позже без allow_repeat_in_conversation=true не запишется. В getcourseCreateDealConfig для GETCOURSE_CREATE_DEAL можно передать reuse_open_invoice=true: переиспользуется только открытый счёт с продуктом из предложения шага; нового заказа нет. Срок давности счёта: по умолчанию не старше 14 суток; open_invoice_age=ANY_AGE — без срока, WITHIN_MAX_AGE — 14 суток. Отсутствующий ключ получает 14 суток, в том числе у перенесённых шагов; ключ умолчания при сохранении удаляется. Количество открытых счетов считается в пределах выбранного срока. ru/en/es/id/uz используют подпись поля и двух вариантов на языке пользователя. Упорядоченный список уникальных ответственных сотрудников своего подключения amoCRM. Пропуск ключа сохраняет прежний пул цепочки; [] или null снимают. При полной замене действий передай прочитанный пул явно. Ссылки — UUID из каталога операторов CRM, а не номера пользователей. Голосовые шаги: канон stepType=VOICE_INITIATE_OUTBOUND_CALL / VOICE_TRANSFER_CALL и config. Старые initiateOutboundCall/initiateOutboundCallConfig и transferCall/transferCallConfig принимаются как ввод. Конфликты и непустой чужой конфиг отклоняются до HTTP; снимается только служебное эхо верхнего уровня, вложенные поля сохраняются. Редактирование не выполняет звонок или перевод. При replace_actions=true явно сохраняй обе оси SILENT_MODE: config.silence_bot и config.silence_followups. Пропущенная ось получает true, а не прежнее значение. Для старого конверта — silenceBot/silenceFollowUps.",
+      "description": "Create trigger, patch trigger metadata, or replace its full action set (replace_actions=true) for an agent. Without replace_actions existing actions are not bulk-replaced; webhook, operator, silent AI, CRM, calendar, outbound and follow-up actions require explicit_confirmation. В ответе вместо самих шагов и условий приходит их количество (actionsCount / activationsCount): эхо повторяло отправленное целиком и уносило контекст на каждой правке, а правят их десятками подряд. Текущий состав читается через besales_platform_context_get. Включённое действие, сохраняющее почту, названную клиентом (шаг SAVE_CONTACT_INFO с полем email ровно {{slots.email}}), записывается только с allow_repeat_in_conversation=true, иначе 422: первая попытка заняла бы право до закрытия переписки, и исправленный адрес сохранить было бы нельзя. Действию, записывающему значение из переписки (поле CRM без шаблона — input_type ai_text или ai_dropdown; заметка с input_type=ai_text; переменная с value_source=MODEL; поле школы из ai_fields с вариантами options), повтор рекомендован, но не обязателен: частичное извлечение занимает право, и названное позже без allow_repeat_in_conversation=true не запишется. В getcourseCreateDealConfig для GETCOURSE_CREATE_DEAL можно передать reuse_open_invoice=true: переиспользуется только открытый счёт с продуктом из предложения шага; нового заказа нет. Срок давности счёта: по умолчанию не старше 14 суток; open_invoice_age=ANY_AGE — без срока, WITHIN_MAX_AGE — 14 суток. Отсутствующий ключ получает 14 суток, в том числе у перенесённых шагов; ключ умолчания при сохранении удаляется. Количество открытых счетов считается в пределах выбранного срока. ru/en/es/id/uz используют подпись поля и двух вариантов на языке пользователя. Упорядоченный список уникальных ответственных сотрудников своего подключения amoCRM. Пропуск ключа сохраняет прежний пул цепочки; [] или null снимают. При полной замене действий передай прочитанный пул явно. Ссылки — UUID из каталога операторов CRM, а не номера пользователей. Голосовые шаги: канон stepType=VOICE_INITIATE_OUTBOUND_CALL / VOICE_TRANSFER_CALL и config. Старые initiateOutboundCall/initiateOutboundCallConfig и transferCall/transferCallConfig принимаются как ввод. Конфликты и непустой чужой конфиг отклоняются до HTTP; снимается только служебное эхо верхнего уровня, вложенные поля сохраняются. Редактирование не выполняет звонок или перевод. При replace_actions=true явно сохраняй обе оси SILENT_MODE: config.silence_bot и config.silence_followups. Пропущенная ось получает true, а не прежнее значение. Для старого конверта — silenceBot/silenceFollowUps. Для автоматического запуска по событию передай trigger вместо scope и строкового condition верхнего уровня. NEW_CONVERSATION — начало новой переписки; CONTACT_MESSAGE — сообщение клиента; OPERATOR_REPLY — ответ живого оператора; AGENT_REPLY — после ответа бота клиенту, пустой или молчаливый ход события не даёт. Шаги событийного триггера статичные: без arguments, {{args.*}} и полей «заполняет ИИ» — автозапуск не получает значений ИИ. Для шагов с оператором или отправкой требуется explicit_confirmation=true. Горизонт allow_repeat_in_conversation — ПЕРЕПИСКА. В trigger.condition можно использовать conversation.lastActionFailureCode, если сервер его знает.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -4089,38 +4089,127 @@
                   "additionalProperties": true
                 },
                 "callOperatorConfig": {
-                  "type": "object",
-                  "properties": {
-                    "taskText": {
-                      "anyOf": [
-                        {
-                          "maxLength": 500,
-                          "type": "string"
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "taskText": {
+                          "anyOf": [
+                            {
+                              "maxLength": 500,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Свой текст задачи в CRM, до 500 знаков (кодовых точек Unicode); составной эмодзи может занимать несколько знаков (🇷🇺 — два). Передаётся буквально, без подстановки переменных. Пустой или пробельный текст включает штатный. Не передавай поле, чтобы сохранить прежний текст; null очищает его; строка заменяет."
                         },
-                        {
-                          "type": "null"
+                        "taskDueHours": {
+                          "anyOf": [
+                            {
+                              "maximum": 720,
+                              "minimum": 1,
+                              "type": "integer"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Срок задачи в CRM: целое число от 1 до 720 часов от момента передачи оператору. При запасном пути и повторе срок не сдвигается. Не передавай поле, чтобы сохранить прежний срок; null очищает его; число заменяет. Без своего срока amoCRM — момент передачи, Bitrix24 — через 24 часа."
                         }
-                      ],
-                      "description": "Свой текст задачи в CRM, до 500 знаков (кодовых точек Unicode); составной эмодзи может занимать несколько знаков (🇷🇺 — два). Передаётся буквально, без подстановки переменных. Пустой или пробельный текст включает штатный. Не передавай поле, чтобы сохранить прежний текст; null очищает его; строка заменяет."
+                      },
+                      "additionalProperties": {}
                     },
-                    "taskDueHours": {
-                      "anyOf": [
-                        {
-                          "maximum": 720,
-                          "minimum": 1,
-                          "type": "integer"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ],
-                      "description": "Срок задачи в CRM: целое число от 1 до 720 часов от момента передачи оператору. При запасном пути и повторе срок не сдвигается. Не передавай поле, чтобы сохранить прежний срок; null очищает его; число заменяет. Без своего срока amoCRM — момент передачи, Bitrix24 — через 24 часа."
+                    {
+                      "type": "null"
                     }
-                  },
-                  "additionalProperties": {}
+                  ]
                 },
                 "config": {
-                  "type": "object",
+                  "anyOf": [
+                    {},
+                    {
+                      "type": "object",
+                      "properties": {
+                        "task_text": {},
+                        "task_due_hours": {},
+                        "assign_responsible_operator_ids": {
+                          "anyOf": [
+                            {},
+                            {
+                              "description": "Упорядоченный список уникальных ответственных сотрудников своего подключения amoCRM. Пропуск ключа сохраняет прежний пул цепочки; [] или null снимают. При полной замене действий передай прочитанный пул явно. Ссылки — UUID из каталога операторов CRM, а не номера пользователей.",
+                              "anyOf": [
+                                {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string",
+                                    "format": "uuid",
+                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                                  }
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "uniqueItems": true
+                            }
+                          ]
+                        },
+                        "assignResponsibleOperatorIds": {
+                          "anyOf": [
+                            {},
+                            {
+                              "description": "Упорядоченный список уникальных ответственных сотрудников своего подключения amoCRM. Пропуск ключа сохраняет прежний пул цепочки; [] или null снимают. При полной замене действий передай прочитанный пул явно. Прежняя форма: положительные целые номера пользователей amoCRM; API преобразует их в ссылки каталога.",
+                              "anyOf": [
+                                {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "integer",
+                                    "exclusiveMinimum": 0,
+                                    "maximum": 9007199254740991
+                                  }
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "uniqueItems": true
+                            }
+                          ]
+                        },
+                        "extra": {
+                          "anyOf": [
+                            {},
+                            {
+                              "type": "object",
+                              "properties": {
+                                "assignResponsibleOperatorIds": {
+                                  "description": "Упорядоченный список уникальных ответственных сотрудников своего подключения amoCRM. Пропуск ключа сохраняет прежний пул цепочки; [] или null снимают. При полной замене действий передай прочитанный пул явно. Прежняя форма: положительные целые номера пользователей amoCRM; API преобразует их в ссылки каталога.",
+                                  "anyOf": [
+                                    {
+                                      "type": "array",
+                                      "items": {
+                                        "type": "integer",
+                                        "exclusiveMinimum": 0,
+                                        "maximum": 9007199254740991
+                                      }
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ],
+                                  "uniqueItems": true
+                                }
+                              },
+                              "additionalProperties": false
+                            }
+                          ]
+                        }
+                      },
+                      "additionalProperties": {}
+                    }
+                  ],
                   "properties": {
                     "task_text": {
                       "anyOf": [
@@ -4210,12 +4299,10 @@
                       },
                       "additionalProperties": false
                     }
-                  },
-                  "additionalProperties": {}
+                  }
                 },
                 "type": {
-                  "type": "string",
-                  "description": "Совместимое имя типа действия."
+                  "type": "string"
                 },
                 "crmMoveStage": {
                   "type": "object",
@@ -4891,6 +4978,58 @@
           "run_once_per_contact": {
             "description": "Прежняя однократность: true переводится в allow_repeat_in_conversation=false. После закрытия переписки право возвращается; повтор в CRM возможен. Не смешивайте с новым именем.",
             "type": "boolean"
+          },
+          "trigger": {
+            "type": "object",
+            "properties": {
+              "event": {
+                "type": "string",
+                "enum": [
+                  "NEW_CONVERSATION",
+                  "CONTACT_MESSAGE",
+                  "OPERATOR_REPLY",
+                  "AGENT_REPLY"
+                ]
+              },
+              "condition": {
+                "type": "object",
+                "properties": {
+                  "schema_version": {
+                    "type": "number",
+                    "const": 1
+                  },
+                  "combinator": {
+                    "type": "string",
+                    "enum": [
+                      "AND",
+                      "OR"
+                    ]
+                  },
+                  "rules": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {},
+                      "additionalProperties": {}
+                    }
+                  },
+                  "preset": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "schema_version",
+                  "combinator",
+                  "rules"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "event"
+            ],
+            "additionalProperties": false,
+            "description": "Для автоматического запуска по событию передай trigger вместо scope и строкового condition верхнего уровня. NEW_CONVERSATION — начало новой переписки; CONTACT_MESSAGE — сообщение клиента; OPERATOR_REPLY — ответ живого оператора; AGENT_REPLY — после ответа бота клиенту, пустой или молчаливый ход события не даёт. Шаги событийного триггера статичные: без arguments, {{args.*}} и полей «заполняет ИИ» — автозапуск не получает значений ИИ. Для шагов с оператором или отправкой требуется explicit_confirmation=true. Горизонт allow_repeat_in_conversation — ПЕРЕПИСКА. В trigger.condition можно использовать conversation.lastActionFailureCode, если сервер его знает."
           }
         }
       }
@@ -8492,7 +8631,7 @@
           "continuation": {
             "type": "boolean",
             "const": true,
-            "description": "Явное продолжение по contacts; только literal true, отсутствие сохраняет обычный режим. Сначала preview с теми же текстом, сегментом, продуктом и каналами, затем подтверждённый start."
+            "description": "Только по явной просьбе человека продолжить обращение по файлу contacts. Сначала preview с теми же текстом, сегментом, продуктом и каналами, затем подтверждённый start. Не выбирать автоматически по alreadyWelcomed."
           }
         }
       }
@@ -8642,12 +8781,12 @@
           "continuation": {
             "type": "boolean",
             "const": true,
-            "description": "Явное продолжение по contacts; только literal true, отсутствие сохраняет обычный режим. Сначала preview с теми же текстом, сегментом, продуктом и каналами, затем подтверждённый start."
+            "description": "Только по явной просьбе человека продолжить обращение по файлу contacts. Сначала preview с теми же текстом, сегментом, продуктом и каналами, затем подтверждённый start. Не выбирать автоматически по alreadyWelcomed."
           },
           "idempotency_key": {
             "type": "string",
             "format": "uuid",
-            "description": "UUID намерения. Сохрани до отправки вместе с подтверждёнными параметрами; повтор того же запуска использует тот же ключ. Передаётся заголовком Idempotency-Key. Отсутствие сохраняет прежний вызов без ключа."
+            "description": "UUID намерения: сохрани до отправки с подтверждёнными файлом и текстом. Повтор того же запуска — с тем же ключом; новый подтверждённый запуск — с новым. Передаётся заголовком Idempotency-Key."
           }
         }
       }
@@ -11003,6 +11142,45 @@
         }
       }
     },
+    {
+      "name": "besales_crm_bitrix24_deal_tab_get",
+      "description": "Состояние CRM-регистрации вкладки AI Агенты в сделке Bitrix24: NOT_ATTEMPTED, BOUND или FAILED с безопасной reason и checkedAt. BOUND — последнее наблюдение placement.get, не проверка браузера. Scope: read:crm.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "crm_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "crm_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_crm_bitrix24_deal_tab_register",
+      "description": "Повторить регистрацию вкладки AI Агенты без переустановки приложения. Адрес берётся из окружения сервера, токен и домен — из сохранённого подключения. Нужны CRM_MANAGE и write:crm. HTTP 200 с FAILED не означает успех; 409 BITRIX24_DEAL_TAB_BUSY означает, что нужно повторить позже.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "crm_id",
+          "acknowledge_external_side_effect"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "crm_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "acknowledge_external_side_effect": {
+            "type": "boolean",
+            "const": true
+          }
+        }
+      }
+    },
     {
       "name": "besales_crm_pipeline_list",
       "description": "Список v2 CRM pipelines со статусами; перед чтением выполняется best-effort sync, include_deleted поддерживается. Scope: read:crm. Ответ: data + cursor. Непустой cursor означает, что показан НЕ весь перечень воронок; вызов без limit/cursor при неполной выдаче вернёт ошибку — недостающая воронка = молча суженный охват задачи.",
@@ -12856,7 +13034,7 @@
           "outreach": {
             "type": "string",
             "const": "true",
-            "description": "Только сохранённый факт начала холодного обращения, не подтверждение доставки; старая история может быть неполной. Дата outreachInitiatedAt — ISO либо null."
+            "description": "Люди с сохранённым фактом начала холодного обращения; это допуск к отправке, а не подтверждение доставки. outreachInitiatedAt — ISO-момент либо null; старая история может быть неполной."
           }
         }
       }
@@ -13291,6 +13469,84 @@
         ]
       }
     },
+    {
+      "name": "besales_dialogue_reprocess_last_inbound",
+      "description": "Заново ответить ботом на последнее сообщение клиента в одном или нескольких диалогах (1–50). Новой строки входящего в переписке нет; клиент получит настоящее сообщение. Применяй после сбоя, когда клиент ещё не видел ответа. Не применяй, если ответ уже доставлен, бот заглушён или ход идёт: сервер откажет. Нужно явное «да» человека и explicit_confirmation=true. Только администратор с управлением каналом; область run:conversation-reprocess входит в mcp:*. Запросы последовательные, 429 останавливает пакет. При неизвестном исходе сначала найди квитанцию/статус и проверь переписку, не повторяй отправку автоматически. ENQUEUED означает очередь, а не доставку.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Рабочая область; без поля используется выбранное подключение."
+          },
+          "conversation_ids": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 50,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "description": "Идентификаторы диалогов без дублей, в порядке обработки."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Только после явного «да» человека: каждый клиент получит настоящее сообщение бота."
+          }
+        },
+        "required": [
+          "conversation_ids",
+          "explicit_confirmation"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_dialogue_nudge_agent",
+      "description": "Подтолкнуть агента, если клиент без ответа из-за сбоя или ошибки бота, а переобработка последнего входящего не подходит. Полный ход по ВСЕЙ истории диалога; клиент получит настоящее сообщение, операция платная. Отказывает (REFUSED, при тишине обычно BOT_SILENCED) при тишине, поставленной человеком/оператором (ручная остановка, стоп-слово), отписке, блокировке, бане, вне срока переписки канала, при выключенном канале/ИИ и пока ход уже идёт. Служебную тишину (ожидание оператора «до /start», стадия CRM, фильтр сделки, тишина агента) СНИМАЕТ, возвращая reactivated: true. Перед подтверждением предупреди человека: клиент получит настоящее сообщение бота даже при служебном ожидании оператора. Покажи reactivated в итоге. Не обходи отказ сервера. Только после явного «да» человека: explicit_confirmation=true. От 1 до 30 диалогов без дублей, запросы последовательные, 429 останавливает пакет. Область run:conversation-nudge. attempt_key (до 64 символов, по умолчанию пусто) даёт стабильный ключ на диалог: тот же вход не отправит второй ответ. Новый ключ допустим для нового подтверждённого запуска позже. При 503, таймауте или неизвестном исходе не повторяй и не меняй ключ: проверь besales_dialogue_transcript. Отчёт отдельно: запущено / отказано (код+причина) / исход неизвестен / не обработано; доставка указана отдельно.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "description": "Рабочая область; без поля используется выбранное подключение."
+          },
+          "conversation_ids": {
+            "minItems": 1,
+            "maxItems": 30,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            },
+            "uniqueItems": true,
+            "description": "Идентификаторы диалогов без дублей, в порядке обработки (1–30)."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Только после явного «да» человека. Перед подтверждением предупреди: клиент получит настоящее сообщение бота даже при служебном ожидании оператора; служебная тишина снимается (reactivated: true)."
+          },
+          "attempt_key": {
+            "default": "",
+            "description": "Ключ осознанной попытки, до 64 символов; по умолчанию пусто. Тот же ключ для диалога возвращает прежний результат. Новый ключ — только для нового подтверждённого запуска позже, не для повтора неизвестного исхода.",
+            "type": "string",
+            "maxLength": 64
+          }
+        },
+        "required": [
+          "conversation_ids",
+          "explicit_confirmation"
+        ],
+        "additionalProperties": false
+      }
+    },
     {
       "name": "besales_broadcast_analytics_get",
       "description": "Отчёты страницы аналитики рассылок: выбор отчёта полем report (16 значений). Scope: read:analytics. Персональные отчёты recipients, recipients+notSent (recipient_metric=notSent), deals, action_failures, indirect_payments, recent_leads, payment_candidates, registration_intake требуют дополнительно read:conversations: ответ несёт имена и идентификаторы людей, номера заказов или ссылки на карточки. Агрегатные отчёты summary, cohorts, skip_reasons, response_windows, insights, data_quality, segments_catalog, funnel_products, payment_candidates_summary доступны с read:analytics. Для report=response_windows в conversionCycles поле cut различает overall (серверный итог), product и segment; пустой ключ в разрезе не является итогом. Строку «Итого» берите только по cut=overall, медианы строк не складывайте. registration_intake — сверка регистраций: состояние, всего/вошли/не вошли, группы, исход приёма и приветствия, воронка, момент, номера заказов, ссылка на живой контакт. Один канал, ограниченный период, view=period; фильтр funnel допустим. Поздние записи могут появиться позже; недошедший заказ без решения при двух каналах одной воронки виден обоим. Отчёт registration_intake также возвращает персональные данные клиентов воркспейса: имя, контакт и номера заказов. У регистраций применяется только view=period; entry/cohort отвергаются. Валютный фильтр currency: ISO 4217 или UNKNOWN. Точные десятичные строки сохраняются без округления; moneyTotalsByCurrency показывает раздельные итоги по валютам, currencyAssumed отмечает предположение. Для segments_catalog, funnel_products, payment_candidates и payment_candidates_summary валютный фильтр недоступен. Список и сводка оплат поддерживают platform_id, funnel, остальные общие измерения и include_archived. Период оплат передаётся как periodMode: без mode/days всё время; mode=days без days — 30 дней. mode=range принимает открытый диапазон: только from, только to или обе границы; если заданы обе, to не раньше from. Параметры должны поддерживаться выбранным report; payment_candidates: page_size не больше 100. payment_view можно сочетать с payment_status/payment_eligibility: API отдаёт приоритет view.",
@@ -18151,6 +18407,602 @@
           }
         ]
       }
+    },
+    {
+      "name": "besales_platform_telegram_personal_restriction_check",
+      "description": "Проверить ограничения всех номеров канала (all:true) или выбранного списка (account_ids, 1–100). Требует manage:channels. Номер обращается только к системному боту @SpamBot; людям сообщения не отправляются, подтверждение не требуется. Ответ по каждому номеру: исход постановки и taskId принятой задачи. QUEUED означает очередь, не итог проверки. Используй стабильный idempotency_key. При неизвестном исходе сначала прочитай задачу или доступность номеров; новый ключ автоматически не создавай.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "idempotency_key"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "account_ids": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 100,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
+            }
+          },
+          "all": {
+            "type": "boolean",
+            "const": true
+          },
+          "idempotency_key": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "pattern": "^[!-~]+$"
+          }
+        },
+        "oneOf": [
+          {
+            "required": [
+              "account_ids"
+            ],
+            "not": {
+              "required": [
+                "all"
+              ]
+            }
+          },
+          {
+            "required": [
+              "all"
+            ],
+            "not": {
+              "required": [
+                "account_ids"
+              ]
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_restriction_appeal",
+      "description": "Подать апелляцию об ограничениях от всех номеров канала (all:true) или выбранного списка (account_ids, 1–100). Требует manage:channels. text необязателен: по умолчанию система подбирает английский текст из набора разных апелляций со спинтаксом (18 шаблонов, 144 раскрытия), отдельно для каждого номера. Свой text — 1–500 знаков после удаления пробелов по краям. Выбор сохраняется для повтора с тем же ключом; ответ содержит appealTemplateId, без текста. Жалоба в @SpamBot подаётся вручную, не чаще раза в сутки на номер; необратима — перед вызовом покажи человеку номер и свой text, если он задан (без text система подберёт английский шаблон сама), и получи явное согласие (explicit_confirmation: true). Автоматическая подача сейчас выключена. Только после явного согласия человека передай explicit_confirmation:true: каждый выбранный номер отправит текст системному боту @SpamBot от своего имени; отменить отправку нельзя. Не чаще раза в UTC-сутки на номер. Ответ по каждому номеру: QUEUED/taskId, FAILED или SKIPPED с причиной (нет ограничений либо суточный предел). При неизвестном исходе сначала прочитай задачу или доступность номеров; новый ключ автоматически не создавай, сохраняй ключ и аргументы прежнего намерения.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "idempotency_key",
+          "explicit_confirmation"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "account_ids": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 100,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
+            }
+          },
+          "all": {
+            "type": "boolean",
+            "const": true
+          },
+          "idempotency_key": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "pattern": "^[!-~]+$"
+          },
+          "text": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 500,
+            "pattern": "\\S",
+            "description": "Необязательный текст: 1–500 знаков после удаления пробелов по краям. Без text система подбирает разные английские апелляции для каждого номера."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Явное согласие человека на необратимую отправку апелляции от номера."
+          }
+        },
+        "oneOf": [
+          {
+            "required": [
+              "account_ids"
+            ],
+            "not": {
+              "required": [
+                "all"
+              ]
+            }
+          },
+          {
+            "required": [
+              "all"
+            ],
+            "not": {
+              "required": [
+                "account_ids"
+              ]
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_operational_task_get",
+      "description": "Прочитать состояние проверки ограничений или апелляции по task_id. Требует read:channels. Возвращает состояние задачи и restrictionStatus — текущий статус ограничений номера, прочитанный после задачи; это не исторический снимок её исхода. Успешное выполнение не означает отсутствие ограничений, более поздние действия могли изменить номер. null означает недоступный статус номера. Ничего не отправляет.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "task_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "task_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_accounts",
+      "description": "Прочитать таблицу личных номеров Telegram канала. Требует read:channels. Фильтры search, status, page, limit; summary — сводка до отбора, pagination — листание, truncated — неполное чтение. campaign и состояние строки показывают участие и ступень лесенки; warmup.active/reason/label/until/optedOut — отдельная пометка прогрева, он не блокирует рассылку. restriction — ограничение, последняя проверка и жалоба; autoAppealNotBefore — только время из ответа, автоматическая подача сейчас выключена. Лесенка 3, 4, 5, 6, 7 с первого дня рассылки; прогрев идёт параллельно 5 дней и включается сам при подключении номера, если его не выключить вручную.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "search": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "BANNED",
+              "CONNECTED",
+              "CONNECTING",
+              "DISCONNECTED",
+              "ERROR",
+              "NEEDS_CODE",
+              "NEEDS_PASSWORD",
+              "PENDING_VERIFICATION",
+              "SESSION_UPLOADED"
+            ]
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_warmup",
+      "description": "Прочитать настройки и аналитику прогрева личных номеров Telegram. Требует read:channels. Сообщения прогрева идут только между своими номерами. Лесенка 3, 4, 5, 6, 7 с первого дня рассылки; прогрев идёт параллельно 5 дней и включается сам при подключении номера, если его не выключить вручную.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_warmup_update",
+      "description": "Частично изменить настройки прогрева личных номеров Telegram. Требует manage:channels. Передавай только изменяемые поля; пропуск сохраняет прежнее значение. Подтверждение не требуется: сообщения прогрева идут только между своими номерами. Лесенка 3, 4, 5, 6, 7 с первого дня рассылки; прогрев идёт параллельно 5 дней и включается сам при подключении номера, если его не выключить вручную.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "images_enabled": {
+            "type": "boolean"
+          },
+          "messages_per_day": {
+            "type": "integer"
+          },
+          "time_variation_minutes": {
+            "type": "integer"
+          },
+          "response_delay_min_minutes": {
+            "type": "integer"
+          },
+          "response_delay_max_minutes": {
+            "type": "integer"
+          },
+          "image_chance_percent": {
+            "type": "integer"
+          },
+          "posts_to_react": {
+            "type": "integer"
+          },
+          "max_accounts_per_channel_reaction": {
+            "type": "integer"
+          },
+          "pairing_hour_utc": {
+            "type": "integer"
+          },
+          "hourly_interval_hours": {
+            "type": "number"
+          },
+          "reaction_types": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 100
+          },
+          "reaction_hours_utc": {
+            "type": "array",
+            "items": {
+              "type": "integer"
+            },
+            "maxItems": 24
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_account_warmup",
+      "description": "Включить или выключить прогрев одного личного номера Telegram. Требует manage:channels. is_warming_up:false означает выход номера из автоматического прогрева до ручного включения; true снимает ручной отказ. Подтверждение не требуется: сообщения только между своими номерами. Лесенка 3, 4, 5, 6, 7 с первого дня рассылки; прогрев идёт параллельно 5 дней и включается сам при подключении номера, если его не выключить вручную.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "account_id",
+          "is_warming_up"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "account_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "is_warming_up": {
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_ramp",
+      "description": "Прочитать, включена ли лесенка новых личных номеров Telegram в рабочей области. Требует read:channels. Возвращает только этот флаг. Лесенка 3, 4, 5, 6, 7 с первого дня рассылки; прогрев идёт параллельно 5 дней и включается сам при подключении номера, если его не выключить вручную.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_profile_bulk",
+      "description": "Изменить профили своих личных номеров Telegram пачкой. Меняются СВОИ номера канала, не клиенты: имя first_name, фамилия last_name, описание bio, дата рождения birthday (null снимает) и ники. Фото через этот инструмент не меняется — только в приложении. Требует manage:channels. Поля профиля одинаковы для всех выбранных номеров; пропуск поля сохраняет прежнее значение. Номера выбираются account_ids (1–100 уникальных UUID v4) либо all:true — ровно одно. Ники — один из двух режимов либо ни одного: usernames (по номерам: account_id и новый username; account_ids и all не передаются) или username_base (основа ника; номера выбираются account_ids или all). Оба режима ников сразу отвергаются до запроса. Ники необратимо освобождают прежние ники у Telegram: перед вызовом покажи человеку список номеров и новые значения и получи ответ «делать?»; явное explicit_confirmation не требуется. Операция идёт заданием фермы: ответ — принятие (job_id, state, total), а не итог; итог по каждому номеру смотри в besales_platform_telegram_personal_profile_job. Обязателен стабильный idempotency_key (1–200 видимых ASCII-символов без пробелов): повтор того же намерения — с тем же ключом и аргументами; при неизвестном исходе новый ключ автоматически не создавай.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "idempotency_key"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "account_ids": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 100,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
+            },
+            "description": "Номера канала (UUID из таблицы номеров), 1–100 уникальных. Вместо all; с usernames не передаётся."
+          },
+          "all": {
+            "type": "boolean",
+            "const": true,
+            "description": "Все номера канала. Вместо account_ids; с usernames не передаётся."
+          },
+          "first_name": {
+            "type": "string",
+            "maxLength": 64,
+            "description": "Имя, до 64 знаков. Ограничения Telegram проверяет ферма."
+          },
+          "last_name": {
+            "type": "string",
+            "maxLength": 64,
+            "description": "Фамилия, до 64 знаков."
+          },
+          "bio": {
+            "type": "string",
+            "maxLength": 140,
+            "description": "Описание профиля, до 140 знаков; лимит Telegram — до 70 без Premium, до 140 с Premium, его проверяет ферма по каждому номеру."
+          },
+          "birthday": {
+            "anyOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "day",
+                  "month"
+                ],
+                "properties": {
+                  "day": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 31
+                  },
+                  "month": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 12
+                  },
+                  "year": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 9999
+                  }
+                }
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Дата рождения: день, месяц, год необязателен. null снимает дату."
+          },
+          "usernames": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 100,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "account_id",
+                "username"
+              ],
+              "properties": {
+                "account_id": {
+                  "type": "string",
+                  "format": "uuid",
+                  "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
+                },
+                "username": {
+                  "type": "string",
+                  "minLength": 5,
+                  "maxLength": 32,
+                  "pattern": "^(?!.*__)[A-Za-z][A-Za-z0-9_]{3,30}[A-Za-z0-9]$"
+                }
+              }
+            },
+            "description": "Режим ников по номерам: пары account_id и новый username (5–32 знака: латиница, цифры, _, без двойного _, с буквы). Номера и ники не повторяются. С account_ids, all и username_base не передаётся."
+          },
+          "username_base": {
+            "type": "string",
+            "minLength": 5,
+            "maxLength": 32,
+            "pattern": "^(?!.*__)[A-Za-z][A-Za-z0-9_]{3,30}[A-Za-z0-9]$",
+            "description": "Режим основы ника: общая основа для выбранных account_ids или all. С usernames не передаётся."
+          },
+          "idempotency_key": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "pattern": "^[!-~]+$"
+          }
+        },
+        "allOf": [
+          {
+            "not": {
+              "required": [
+                "usernames",
+                "username_base"
+              ]
+            }
+          },
+          {
+            "if": {
+              "required": [
+                "usernames"
+              ]
+            },
+            "then": {
+              "not": {
+                "anyOf": [
+                  {
+                    "required": [
+                      "account_ids"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "all"
+                    ]
+                  }
+                ]
+              }
+            },
+            "else": {
+              "oneOf": [
+                {
+                  "required": [
+                    "account_ids"
+                  ],
+                  "not": {
+                    "required": [
+                      "all"
+                    ]
+                  }
+                },
+                {
+                  "required": [
+                    "all"
+                  ],
+                  "not": {
+                    "required": [
+                      "account_ids"
+                    ]
+                  }
+                }
+              ]
+            }
+          },
+          {
+            "anyOf": [
+              {
+                "required": [
+                  "first_name"
+                ]
+              },
+              {
+                "required": [
+                  "last_name"
+                ]
+              },
+              {
+                "required": [
+                  "bio"
+                ]
+              },
+              {
+                "required": [
+                  "birthday"
+                ]
+              },
+              {
+                "required": [
+                  "usernames"
+                ]
+              },
+              {
+                "required": [
+                  "username_base"
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_profile_job",
+      "description": "Прочитать итог задания фермы по изменению профилей номеров Telegram. Требует read:channels. Принимает channel_id и job_id из ответа besales_platform_telegram_personal_profile_bulk. Возвращает job_id, kind, state (PENDING, RUNNING, COMPLETED), counters (total, pending, running, succeeded, failed) и items по номерам: account_id, state (PENDING, RUNNING, SUCCEEDED, FAILED), failure_code и outcome.fields по каждому полю. Элемент с частичным успехом остаётся SUCCEEDED, поэтому читай поля: отдельное поле может быть FAILED. TELEGRAM_BIO_TOO_LONG — описание длиннее лимита Telegram (до 70 без Premium, до 140 с Premium); PROFILE_PROVIDER_OUTCOME_UNKNOWN — исход у Telegram неизвестен, не повторяй вслепую, сначала сверь профиль номера. Принятие задания итогом не является: пока state не COMPLETED, повтори чтение позже. Ничего не меняет.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "job_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "job_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          }
+        }
+      }
     }
   ],
   "resources": [
@@ -18390,16 +19242,16 @@
     }
   ],
   "summary": {
-    "total_tools": 292,
+    "total_tools": 306,
     "tools_by_category": {
       "workspace_and_help": 18,
       "agent_configuration": 15,
       "prompt_and_testing": 40,
       "icp": 11,
       "knowledge_and_content": 52,
-      "crm_and_data_sources": 30,
-      "channels_and_credentials": 16,
-      "dialogues_and_contacts": 33,
+      "crm_and_data_sources": 32,
+      "channels_and_credentials": 26,
+      "dialogues_and_contacts": 35,
       "automation": 5,
       "outbound_and_analytics": 72
     },