@besales/mcp 1.0.0-beta.4 → 1.0.0-beta.7

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-11-09",
+  "lastUpdated": "2026-11-12",
   "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.",
@@ -996,7 +996,7 @@
     },
     {
       "name": "besales_sandbox_run_start",
-      "description": "Start sandbox run для agent (full multi-persona × multi-scenario testing). Queued async. Без вопроса запускай обычный прогон: mode=single_agent и client_mode=scripted (умолчания схемы) — это дешёвый, воспроизводимый прогон для регрессии и проверки кандидата промпта до публикации (candidate_prompt). Перед запуском спроси пользователя одним коротким вопросом с ценой в одну фразу только если нужен client_mode=simulated (LLM играет клиента — дороже и каждый раз по-разному), оба режима клиента (= два прогона) либо mode=workflow (все агенты канала через роутер — шире и дороже).",
+      "description": "Start sandbox run для agent (full multi-persona × multi-scenario testing). Queued async. Без вопроса запускай обычный прогон: mode=single_agent и client_mode=scripted (умолчания схемы) — это дешёвый, воспроизводимый прогон для регрессии и проверки кандидата промпта до публикации (candidate_prompt). Перед запуском спроси пользователя одним коротким вопросом с ценой в одну фразу только если нужен client_mode=simulated (LLM играет клиента — дороже и каждый раз по-разному), оба режима клиента (= два прогона) либо mode=workflow (все агенты канала через роутер — шире и дороже). request_key (UUID) — идемпотентность повторного запуска: для повтора того же намерения передай тот же ключ; без поля мост генерирует один ключ на вызов, транспорт внутри вызова использует его повторно. icp_profile_id: UUID — выбранный портрет, null — без выбора, отсутствие — основной портрет агента.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -1075,6 +1075,19 @@
                 "default": 10
               }
             }
+          },
+          "request_key": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Ключ идемпотентности запуска; один на намерение. Если пропущен, мост генерирует UUID один раз на вызов."
+          },
+          "icp_profile_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "uuid",
+            "description": "UUID выбранного портрета; null — без выбора; отсутствие — основной портрет агента."
           }
         }
       }
@@ -3341,7 +3354,7 @@
     },
     {
       "name": "besales_agent_clone",
-      "description": "Deep-clone an existing agent into a NEW agent on the SAME platform (mirrors the besales GUI clone button). Copies baseSystemPrompt, knowledge namespaces, model/model_lane/runtime config, tools + builtin tools, agent + workspace variable overrides, ICP links, and ALL triggers + actions (with FK remap to new ids). Does NOT copy routing rules (per-router) or per-platform behavior — the clone is inert until wired into the router. Prompt is identical to source; PromptHub auto-bootstraps a fresh version on the first prompt op. Cross-platform clone is not supported — use besales_platform_clone_* for that.",
+      "description": "Deep-clone an existing agent into a NEW agent on the SAME platform (mirrors the besales GUI clone button). Copies baseSystemPrompt, knowledge namespaces, model/model_lane/runtime config, tools + builtin tools, agent + workspace variable overrides, ICP links, and ALL triggers + actions (with FK remap to new ids). Does NOT copy routing rules (per-router) or per-platform behavior — the clone is inert until wired into the router. Prompt is identical to source; PromptHub auto-bootstraps a fresh version on the first prompt op. Cross-platform clone is not supported — use besales_platform_clone_* for that. Если у исходного агента есть необратимые действия, включая закрытие разговора после тишины, требуется отдельное явное согласие человека: explicit_confirmation=true. Без него API вернёт 400 TRIGGER_DANGEROUS_CONFIRMATION_REQUIRED. Не подтверждай за человека.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -3367,6 +3380,10 @@
           "display_name": {
             "type": "string",
             "description": "Отображаемое имя нового агента; если не задано — зеркалит name."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "description": "Отдельное согласие человека на копирование необратимых действий, включая закрытие разговора после тишины. При таких действиях требуется true."
           }
         }
       }
@@ -11954,7 +11971,7 @@
     },
     {
       "name": "besales_platform_create_init",
-      "description": "v1.5 Increment 5b: создать platform provisioning сессию (Setup URL pattern) для API-key канала. Секреты НЕ передаются через MCP — пользователь вводит их на setup_page_url. Возвращает { setup_ref, setup_page_url, expires_at, required_secret_fields }. OAuth-каналы (Instagram/Avito) — besales_platform_create_oauth_init; TelegramPersonal не поддержан. Scope: mcp:platform-setup.",
+      "description": "v1.5 Increment 5b: создать platform provisioning сессию (Setup URL pattern) для API-key канала. Секреты НЕ передаются через MCP — пользователь вводит их на setup_page_url. Возвращает { setup_ref, setup_page_url, expires_at, required_secret_fields }. OAuth-каналы (Instagram/Avito) — besales_platform_create_oauth_init; TelegramPersonal не поддержан; номера в существующий канал — besales_platform_telegram_personal_connect_link. Scope: mcp:platform-setup.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -13504,6 +13521,49 @@
         "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.",
@@ -18715,32 +18775,771 @@
           }
         }
       }
-    }
-  ],
-  "resources": [
-    {
-      "uri": "besales://concepts/icp",
-      "name": "ICP Concept Reference",
-      "description": "Что такое ICP, segments / personas / scenarios.",
-      "mimeType": "text/markdown"
-    },
-    {
-      "uri": "besales://concepts/triggers",
-      "name": "Actions & Triggers Reference",
-      "description": "agent_actions, step types, condition language.",
-      "mimeType": "text/markdown"
     },
     {
-      "uri": "besales://concepts/sandbox",
-      "name": "Sandbox Reference",
-      "description": "Что такое sandbox, какие сценарии тестирует.",
-      "mimeType": "text/markdown"
+      "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"
+                ]
+              }
+            ]
+          }
+        ]
+      }
     },
     {
-      "uri": "besales://concepts/handoff",
-      "name": "Multi-agent Routing & Handoffs",
-      "description": "Routing rules vs handoff rules, memory transfer.",
-      "mimeType": "text/markdown"
+      "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
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxy_import_link",
+      "description": "Выдать ссылку для массовой загрузки прокси личного Telegram в пул канала. Требует manage:channels; профиль platform. Ссылку отдать человеку: логины и пароли он вводит на защищённой странице после входа в приложение, не в чате. Ссылка одноразовая, живёт до expires_at. В ответе session_id, setup_page_url, expires_at; итог читай через besales_platform_telegram_personal_proxy_import_status. Создание ссылки ещё не означает загрузку прокси. Не передавай строки прокси через MCP.",
+      "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_proxy_import_status",
+      "description": "Прочитать итог загрузки прокси личного Telegram по session_id и channel_id. Требует manage:channels (контракт защищённого импорта); профили readonly и platform. Возвращает только sessionId, status, expiresAt и summary: total, pending, accepted, duplicates, invalid, checkFailed, rejected, registered. Строк, логинов и паролей нет. COMPLETED — обработка завершена, итог смотри в счётчиках; AWAITING_INPUT — ждёт человека, SUBMITTING/PROCESSING — в работе, UNKNOWN — исход неизвестен, повтори чтение позже; EXPIRED/CANCELLED — сессия закрыта. Ничего не меняет.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "session_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "session_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxy_delete",
+      "description": "Удалить свободный прокси из пула канала личного Telegram. Требует manage:channels; профиль platform. Удаление необратимо: покажи человеку канал и proxy_id и получи явное согласие, затем передай explicit_confirmation:true. Без подтверждения отказ до HTTP. 204 — прокси удалён; 409 TELEGRAM_PROXY_NOT_EMPTY — сначала переключите номера на другой прокси; 404 TELEGRAM_PROXY_NOT_FOUND — прокси не найден. Логины, пароли, host и port через MCP не принимаются.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "proxy_id",
+          "explicit_confirmation"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "proxy_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Только после явного согласия человека."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_account_proxy_change",
+      "description": "Переключить свой личный номер Telegram на существующий прокси пула канала. Требует manage:channels; профиль platform. Номер переподключится: покажи человеку номер и целевой прокси и получи явное согласие, затем передай explicit_confirmation:true. Обязательны channel_id, account_id, proxy_id, стабильный action_id (UUID) и явный country_change_confirmed; значение по умолчанию не подставляй. Ответ — квитанция message, action_id, state, code?, retry_after_ms?. Успех только state=SUCCEEDED; UNKNOWN/PENDING не объявляй успехом, FAILED/EXPIRED — отказ. При повторе того же намерения сохраняй action_id и все аргументы, новый ключ автоматически не создавай. 404 TELEGRAM_PROXY_NOT_FOUND — целевой прокси не найден. При смене страны без согласия передай отказ человеку, автоматически согласие не повышай. Логины, пароли, host, port и edit-proxy через MCP не принимаются.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "account_id",
+          "action_id",
+          "proxy_id",
+          "country_change_confirmed",
+          "explicit_confirmation"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "account_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "action_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Стабильный UUID намерения: создай один раз, сохрани для повтора с теми же аргументами."
+          },
+          "proxy_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "country_change_confirmed": {
+            "type": "boolean",
+            "description": "Явное решение человека о смене страны: true подтверждает, false не подтверждает. Обязательное поле без значения по умолчанию."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Только после явного согласия человека."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxy_stock_list",
+      "description": "Прочитать общий запас прокси пространства. Требует read:channels; профили readonly и platform. Фильтры status, country_code (две заглавные буквы), search (до 200 знаков), cursor (UUID), limit (1–100, сервер по умолчанию 50). nextCursor продолжает список; counts, freeProxies, countryCounts и freeCountryCounts относятся ко всему пулу без фильтров. Занятость — occupiedSlots, ёмкость — maxAccounts; accountsCount не показывает свободные места. Данные о стране — IPinfo (https://ipinfo.io). Запаса ещё нет — пустой список и нули. Логины и пароли не возвращаются.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "ACTIVE",
+              "CHECKING",
+              "ERROR",
+              "INACTIVE"
+            ]
+          },
+          "country_code": {
+            "type": "string",
+            "pattern": "^[A-Z]{2}$"
+          },
+          "search": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "cursor": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxy_stock_import_link",
+      "description": "Выдать ссылку массового импорта в общий запас прокси пространства. Требует manage:channels и ключ вида MCP: ядро проверяет живой ключ, создателя и его свежую роль CHANNEL_MANAGE, аудит пишет до вызова фермы. Профиль platform. Логины и пароли человек вводит на защищённой странице после входа, не в чате. Одноразовая ссылка действует до expires_at; в ответе session_id, setup_page_url, expires_at, без setup_ref. До 50 строк, 1–3 номера на прокси. Выдача ссылки не означает загрузку; итог — besales_platform_telegram_personal_proxy_stock_import_status. После обрыва автоматически новую ссылку не создавай.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxy_stock_import_status",
+      "description": "Прочитать состояние и счётчики импорта в общий запас по session_id. Требует manage:channels и ключ вида MCP со свежей ролью CHANNEL_MANAGE создателя; профили readonly и platform. Только sessionId, status, expiresAt, summary (total, pending, accepted, duplicates, invalid, checkFailed, rejected, registered), без строк прокси. COMPLETED — обработка завершена, смотри счётчики; UNKNOWN не означает успех, повтори чтение позже; EXPIRED/CANCELLED — закрыта.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "session_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "session_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxy_stock_delete",
+      "description": "Удалить свободный прокси из общего запаса пространства. Требует manage:channels и ключ вида MCP: ядро проверяет живой ключ, создателя и его свежую роль CHANNEL_MANAGE, аудит пишет до вызова фермы. Профиль platform. Удаление необратимо: покажи человеку пространство и proxy_id, получи явное согласие и передай explicit_confirmation:true. Без него отказ до HTTP. 204 — удалён; 409 TELEGRAM_PROXY_NOT_EMPTY — идёт операция, повторить позже; 404 TELEGRAM_PROXY_NOT_FOUND — не найден; 503 не означает успех.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "proxy_id",
+          "explicit_confirmation"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "proxy_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Только после явного согласия человека."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxy_stock_check",
+      "description": "Проверить прокси общего запаса по proxy_id, обновить здоровье и страну. Требует manage:channels и ключ вида MCP: ядро проверяет живой ключ, создателя и его свежую роль CHANNEL_MANAGE, аудит пишет до вызова фермы. Профиль platform. 200 — результат проверки, 202 CHECKING — проверка ещё идёт, не объявляй прокси рабочим. Данные о стране — IPinfo (https://ipinfo.io).",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "proxy_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "proxy_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxy_stock_check_all",
+      "description": "Поставить на проверку все прокси общего запаса пространства. Требует manage:channels и ключ вида MCP: ядро проверяет живой ключ, создателя и его свежую роль CHANNEL_MANAGE, аудит пишет до вызова фермы. Профиль platform. queued — сколько поставлено в очередь, не число рабочих прокси. Итог перечитай через besales_platform_telegram_personal_proxy_stock_list.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxies",
+      "description": "Прочитать прокси существующего канала личного Telegram. Требует read:channels; профили readonly и platform. Фильтры status, country_code (две заглавные буквы), search (до 200 знаков), cursor (UUID), limit (1–100, сервер по умолчанию 50). nextCursor продолжает список; counts, freeProxies, countryCounts и freeCountryCounts относятся ко всему пулу без фильтров. Занятость — occupiedSlots, ёмкость — maxAccounts; accountsCount не показывает свободные места. Данные о стране — IPinfo (https://ipinfo.io). Для явной пары используй proxy_id, свободный прокси выбирай с учётом occupiedSlots, статуса и ёмкости.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "ACTIVE",
+              "CHECKING",
+              "ERROR",
+              "INACTIVE"
+            ]
+          },
+          "country_code": {
+            "type": "string",
+            "pattern": "^[A-Z]{2}$"
+          },
+          "search": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "cursor": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxy_take_from_stock",
+      "description": "Забрать прокси из общего запаса пространства в канал целиком, всё или ничего. Требует manage:channels и ключ вида MCP: ядро проверяет живой ключ, создателя и его свежую роль CHANNEL_MANAGE, аудит пишет до вызова фермы. Профиль platform. Перед вызовом покажи человеку, какие прокси (или сколько и из какой страны) и в какой канал переносишь, и получи «да». Поля explicit_confirmation нет. Ровно одна форма: proxy_ids (1–50 разных UUID) или count с необязательной country_code. count — число прокси: сколько ПРОКСИ забрать; у прокси 1–3 места (maxAccounts). При country_code прокси без определённой страны не участвуют; страны не смешиваются: нехватка означает отказ, без добора из других стран. Под N номеров выбирай proxy_ids из списка запаса по местам: заранее вычти места явных пар, затем выбери конкретные ACTIVE свободные прокси нужной страны, пока сумма maxAccounts не покроет недостачу. Если мест не хватает, не вызывай перенос. action_id (UUID) создаётся один на намерение и передаётся только заголовком X-Idempotency-Key. Новое намерение человека — новый action_id. Повтор того же намерения — тот же ключ и аргументы, в том числе при 503 (исход неизвестен). NOT_ENOUGH/REFUSED — ничего не перенесено, исправь причину; отказ ключом не запоминается. Изменение набора прокси согласуй как новое намерение с новым action_id. При IDEMPOTENCY_REQUEST_MISMATCH для того же намерения восстанови прежние аргументы и сохрани action_id; для нового намерения создай новый action_id после согласия человека.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "action_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "action_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "proxy_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "minItems": 1,
+            "maxItems": 50,
+            "uniqueItems": true
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 50,
+            "description": "Число прокси, не мест. Под номера выбирай proxy_ids по maxAccounts."
+          },
+          "country_code": {
+            "type": "string",
+            "pattern": "^[A-Z]{2}$"
+          }
+        },
+        "oneOf": [
+          {
+            "required": [
+              "proxy_ids"
+            ],
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "count"
+                  ]
+                },
+                {
+                  "required": [
+                    "country_code"
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "required": [
+              "count"
+            ],
+            "not": {
+              "required": [
+                "proxy_ids"
+              ]
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_proxy_return_to_stock",
+      "description": "Вернуть свободный прокси канала в общий запас пространства. Требует manage:channels и ключ вида MCP: ядро проверяет живой ключ, создателя и его свежую роль CHANNEL_MANAGE, аудит пишет до вызова фермы. Профиль platform. Перед вызовом покажи человеку, какой прокси из какого канала возвращаешь в общий запас пространства, и получи «да». Поля explicit_confirmation нет. Обязательный action_id (UUID) создаётся один на намерение и передаётся только заголовком X-Idempotency-Key, тело отсутствует. Новое намерение человека — новый action_id. Повтор того же намерения — тот же ключ и аргументы; при 503 исход неизвестен, сохрани их. При IDEMPOTENCY_REQUEST_MISMATCH для того же намерения восстанови прежние аргументы и сохрани action_id; для нового намерения создай новый action_id после согласия человека. TELEGRAM_PROXY_NOT_EMPTY — сначала освободи прокси; TELEGRAM_PROXY_ADDRESS_IN_USE — такой адрес уже в запасе, предложи удалить этот прокси из канала; NOT_FOUND — перечитай список.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id",
+          "proxy_id",
+          "action_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "proxy_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "action_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_connect_link",
+      "description": "Выдать ссылку подключения номеров в существующий канал личного Telegram. Требует manage:channels, ключ MCP и свежую роль CHANNEL_MANAGE создателя на канал; профиль platform. channel_id обязателен. proxy_plan необязателен: ровно pairs (1–50 пар phone E.164 и proxy_id; разные телефоны, не больше трёх пар на один прокси) или country_code. При country_code прокси без определённой страны не участвуют; страны не смешиваются: нехватка означает отказ, без добора из других стран. План только заполняет страницу, не бронирует, не переносит и не подключает. Пары хранят исходный proxy_id: адрес только для показа, обратного разрешения адреса нет; пропавший id блокирует старт до правки человеком. Занятость проверяет страница при старте. Коды Telegram и пароль 2FA вводит человек на защищённой странице после входа, не в чате. В ответе setup_page_url и expires_at, без setup_ref и телефонов. Итог — besales_platform_telegram_personal_accounts. После обрыва автоматически новую ссылку не создавай.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "channel_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "channel_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "proxy_plan": {
+            "oneOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "pairs"
+                ],
+                "properties": {
+                  "pairs": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 50,
+                    "uniqueItems": true,
+                    "description": "Разные телефоны E.164; один proxy_id не больше трёх раз. Исходный id сохраняется, адрес обратно в id не разрешается.",
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "required": [
+                        "phone",
+                        "proxy_id"
+                      ],
+                      "properties": {
+                        "phone": {
+                          "type": "string",
+                          "pattern": "^\\+[1-9]\\d{6,14}$"
+                        },
+                        "proxy_id": {
+                          "type": "string",
+                          "format": "uuid"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "country_code"
+                ],
+                "properties": {
+                  "country_code": {
+                    "type": "string",
+                    "pattern": "^[A-Z]{2}$"
+                  }
+                }
+              }
+            ]
+          }
+        }
+      }
+    }
+  ],
+  "resources": [
+    {
+      "uri": "besales://concepts/icp",
+      "name": "ICP Concept Reference",
+      "description": "Что такое ICP, segments / personas / scenarios.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://concepts/triggers",
+      "name": "Actions & Triggers Reference",
+      "description": "agent_actions, step types, condition language.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://concepts/sandbox",
+      "name": "Sandbox Reference",
+      "description": "Что такое sandbox, какие сценарии тестирует.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://concepts/handoff",
+      "name": "Multi-agent Routing & Handoffs",
+      "description": "Routing rules vs handoff rules, memory transfer.",
+      "mimeType": "text/markdown"
     },
     {
       "uri": "besales://concepts/external-execution",
@@ -18954,7 +19753,7 @@
     }
   ],
   "summary": {
-    "total_tools": 303,
+    "total_tools": 320,
     "tools_by_category": {
       "workspace_and_help": 18,
       "agent_configuration": 15,
@@ -18962,8 +19761,8 @@
       "icp": 11,
       "knowledge_and_content": 52,
       "crm_and_data_sources": 32,
-      "channels_and_credentials": 24,
-      "dialogues_and_contacts": 34,
+      "channels_and_credentials": 40,
+      "dialogues_and_contacts": 35,
       "automation": 5,
       "outbound_and_analytics": 72
     },
@@ -19177,6 +19976,24 @@
         "besales_followup_sequence_list",
         "besales_followup_step_stats"
       ]
-    }
+    },
+    "newly_added_in_PROXYMCP1M": [
+      "besales_platform_telegram_personal_proxy_import_link",
+      "besales_platform_telegram_personal_proxy_import_status",
+      "besales_platform_telegram_personal_proxy_delete",
+      "besales_platform_telegram_personal_account_proxy_change"
+    ],
+    "newly_added_in_PROXYPOOL1M": [
+      "besales_platform_telegram_personal_proxy_stock_list",
+      "besales_platform_telegram_personal_proxy_stock_import_link",
+      "besales_platform_telegram_personal_proxy_stock_import_status",
+      "besales_platform_telegram_personal_proxy_stock_delete",
+      "besales_platform_telegram_personal_proxy_stock_check",
+      "besales_platform_telegram_personal_proxy_stock_check_all",
+      "besales_platform_telegram_personal_proxies",
+      "besales_platform_telegram_personal_proxy_take_from_stock",
+      "besales_platform_telegram_personal_proxy_return_to_stock",
+      "besales_platform_telegram_personal_connect_link"
+    ]
   }
 }