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

package/dist/schemas/mcp-tools.json

@@ -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 (все агенты канала через роутер — шире и дороже). request_key (UUID) — идемпотентность повторного запуска: для повтора того же намерения передай тот же ключ; без поля мост генерирует один ключ на вызов, транспорт внутри вызова использует его повторно. icp_profile_id: UUID — выбранный портрет, null — без выбора, отсутствие — основной портрет агента.",
+      "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 — без выбора, отсутствие — основной портрет агента. Сохрани request_key. При таймауте или 5xx повтори вызов с тем же request_key и тем же намерением: вернётся тот же прогон. Новый ключ — новый платный прогон; другое намерение с прежним ключом даёт START_KEY_CONFLICT.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -1079,7 +1079,7 @@
           "request_key": {
             "type": "string",
             "format": "uuid",
-            "description": "Ключ идемпотентности запуска; один на намерение. Если пропущен, мост генерирует 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)$"
           },
           "icp_profile_id": {
             "type": [
@@ -3889,7 +3889,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. Для автоматического запуска по событию передай trigger вместо scope и строкового condition верхнего уровня. NEW_CONVERSATION — начало новой переписки; CONTACT_MESSAGE — сообщение клиента; OPERATOR_REPLY — ответ живого оператора; AGENT_REPLY — после ответа бота клиенту, пустой или молчаливый ход события не даёт. Шаги событийного триггера статичные: без arguments, {{args.*}} и полей «заполняет ИИ» — автозапуск не получает значений ИИ. Для шагов с оператором или отправкой требуется explicit_confirmation=true. Горизонт allow_repeat_in_conversation — ПЕРЕПИСКА. В trigger.condition можно использовать conversation.lastActionFailureCode, если сервер его знает.",
+      "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, если сервер его знает. Правка одного шага: нетронутые шаги присылай как { stepId } (id — из besales_platform_context_get, раздел agents_full), изменённый — { stepId, stepType, config } с полной настройкой из снимка; HTTP-запрос и шаг со скрытыми полями — только { stepId }, пропуск скрытого шага запрещён. После записи id шагов меняются — перед следующей правкой перечитай снимок. Подробно — besales://docs/trigger-actions.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -4906,6 +4906,23 @@
                     }
                   ],
                   "description": "Совместимый ввод голосового конфига. Используй один config или одно прежнее имя; relation вместе с input, даже null, отклоняется до HTTP."
+                },
+                "stepId": {
+                  "description": "Ссылка на сохранённый шаг этого триггера (id из besales_platform_context_get)",
+                  "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)$"
+                },
+                "onError": {
+                  "type": "string",
+                  "enum": [
+                    "STOP",
+                    "SKIP",
+                    "RETRY"
+                  ]
+                },
+                "stopOnSuccess": {
+                  "type": "boolean"
                 }
               },
               "additionalProperties": true,
@@ -15636,6 +15653,186 @@
         ]
       }
     },
+    {
+      "name": "besales_broadcast_campaign_list",
+      "description": "Список кампаний рассылок с поиском, статусом и курсором. Scope: read:campaigns.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "DRAFT",
+              "SCHEDULED",
+              "RUNNING",
+              "PAUSED",
+              "COMPLETED",
+              "ARCHIVED"
+            ]
+          },
+          "search": {
+            "type": "string"
+          },
+          "cursor": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_broadcast_campaign_get",
+      "description": "Карточка кампании по ID: настройки, статус, расписание запуска и части кампании. Scope: read:campaigns.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "campaign_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        },
+        "required": [
+          "campaign_id"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_broadcast_campaign_create",
+      "description": "Создать черновик кампании с существующим шаблоном и аудиторией. Для повтора того же создания используй прежний idempotency_key. Scope: manage:campaigns.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 160
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "template_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "audience_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "idempotency_key": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[!-~]+$"
+          }
+        },
+        "required": [
+          "name",
+          "template_id",
+          "audience_id",
+          "idempotency_key"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_broadcast_campaign_update",
+      "description": "Изменить имя, описание, шаблон или аудиторию кампании до запуска. Прочитай текущую карточку. Сервер проверяет права и состояние кампании. Scope: manage:campaigns.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "campaign_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 160
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "template_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "audience_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        },
+        "required": [
+          "campaign_id"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_broadcast_campaign_schedule",
+      "description": "Установить время автоматического запуска кампании в очереди BeSales или снять его. В указанное время могут уйти сообщения реальным получателям. Согласуй время и аудиторию перед включением. Scopes: manage:campaigns, launch:campaigns для включения.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "campaign_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "scheduled_at": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "format": "date-time",
+            "description": "Момент запуска с UTC-смещением или null для снятия расписания."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true,
+            "description": "Передай true после явного подтверждения пользователем момента запуска или его отмены."
+          }
+        },
+        "required": [
+          "campaign_id",
+          "scheduled_at",
+          "explicit_confirmation"
+        ],
+        "additionalProperties": false
+      }
+    },
     {
       "name": "besales_ai_costs_get",
       "description": "Фактический расход моделей рабочей области: summary, tasks и breakdown. group_by/page/limit есть только у breakdown, и там group_by обязателен. Период разбирается строго: параметр не своего режима, mode=days без days и диапазон без одной границы — отказ с именем параметра, а не молчаливый ответ за всё время; days при mode=range принимается и не действует — окно задают границы. Границы диапазона — дата-время С часовым поясом. unpricedEvents остаются неизвестной стоимостью, а не нулём. Видят владелец и администраторы. Scope: read:ai-costs.",
@@ -18536,12 +18733,12 @@
             "minLength": 1,
             "maxLength": 500,
             "pattern": "\\S",
-            "description": "Необязательный текст: 1–500 знаков после удаления пробелов по краям. Без text система подбирает разные английские апелляции для каждого номера."
+            "description": "Необязательный текст. По умолчанию система подбирает разные английские апелляции для каждого номера."
           },
           "explicit_confirmation": {
             "type": "boolean",
             "const": true,
-            "description": "Явное согласие человека на необратимую отправку апелляции от номера."
+            "description": "Только после явного согласия человека: номер отправит апелляцию @SpamBot от своего имени; отменить отправку нельзя."
           }
         },
         "oneOf": [
@@ -18778,7 +18975,7 @@
     },
     {
       "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-символов без пробелов): повтор того же намерения — с тем же ключом и аргументами; при неизвестном исходе новый ключ автоматически не создавай.",
+      "description": "Изменить профили своих личных номеров Telegram пачкой. Меняются СВОИ номера канала, не клиенты: имя first_name, фамилия last_name, описание bio, дата рождения birthday (null снимает) и ники. Фото: передай stored_file_id из besales_file_upload_request → besales_file_upload_status (дождись READY) — одно фото для всех выбранных номеров. Статичный JPEG, PNG или WebP до 5 МиБ из библиотеки этой рабочей области; пропуск сохраняет фото. При загрузке укажи file_type:IMAGE и source:USER_UPLOAD, без owner_kind/owner_id. FILE_NOT_FOUND (404) — загрузи файл в рабочую область канала; TELEGRAM_AVATAR_INVALID (400) или TELEGRAM_AVATAR_TOO_LARGE (413) — выбери корректное фото до 5 МиБ; TELEGRAM_AVATAR_CHANGED (409) — выбери файл заново. Для изменённого намерения нужен новый ключ. Требует 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,
@@ -18899,6 +19096,12 @@
             "minLength": 1,
             "maxLength": 200,
             "pattern": "^[!-~]+$"
+          },
+          "stored_file_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})$",
+            "description": "Одно фото для выбранных номеров: stored_file_id из besales_file_upload_request → besales_file_upload_status. Статичный JPEG, PNG или WebP до 5 МиБ из библиотеки этой рабочей области. Пропуск сохраняет фото."
           }
         },
         "allOf": [
@@ -18988,6 +19191,11 @@
                 "required": [
                   "username_base"
                 ]
+              },
+              {
+                "required": [
+                  "stored_file_id"
+                ]
               }
             ]
           }
@@ -19095,7 +19303,7 @@
           "explicit_confirmation": {
             "type": "boolean",
             "const": true,
-            "description": "Только после явного согласия человека."
+            "description": "Явное согласие человека на удаление прокси."
           }
         }
       }
@@ -19143,7 +19351,7 @@
           "explicit_confirmation": {
             "type": "boolean",
             "const": true,
-            "description": "Только после явного согласия человека."
+            "description": "Явное согласие человека: номер переподключится."
           }
         }
       }
@@ -19247,7 +19455,7 @@
           "explicit_confirmation": {
             "type": "boolean",
             "const": true,
-            "description": "Только после явного согласия человека."
+            "description": "Явное согласие человека на удаление прокси из запаса."
           }
         }
       }
@@ -19514,6 +19722,146 @@
           }
         }
       }
+    },
+    {
+      "name": "besales_platform_telegram_personal_session_import_link",
+      "description": "Выдать ссылку для загрузки до 50 файлов сессий Telegram в существующий канал. Требует manage:channels; профиль platform. Человек открывает ссылку, входит в приложение и выбирает импорт файлов, прокси на файл или автоназначение в браузере. MCP файлы, манифест, api_hash и пароли не принимает. Используется существующая страница подключения, TTL 15 минут. В ответе setup_page_url и expires_at; operation_id=null и import_status_available=false: ядро пока не выдаёт безопасный id операции и пофайловый статус для MCP. Итог сверить в браузере и через besales_platform_telegram_personal_accounts. Выдача ссылки не означает импорт. После обрыва автоматически новую ссылку не создавай.",
+      "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)$"
+          },
+          "channel_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)$"
+          }
+        },
+        "required": [
+          "channel_id"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_outreach_calendar_get",
+      "description": "Прочитать календарь рассылок личного Telegram-канала. Scope manage:channels. Вернёт переключатель, часы отправки, часовой пояс канала, рабочие дни с лимитами первых сообщений на номер и дату паузы.",
+      "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)$"
+          },
+          "platform_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)$"
+          }
+        },
+        "required": [
+          "platform_id"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_platform_telegram_personal_outreach_calendar_set",
+      "description": "Заменить календарь рассылок личного Telegram-канала. Scope manage:channels. Сначала прочитай календарь и сохрани нужные значения. enabled=false возвращает стандартный режим. Часы внутри 10:00–19:00 в поясе канала. weekday от 1 (понедельник) до 7 (воскресенье); пропущенные дни закрыты, max_per_number=null оставляет день без дополнительного лимита. pause_until — абсолютная дата ISO 8601 с часовым поясом либо null.",
+      "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)$"
+          },
+          "platform_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)$"
+          },
+          "calendar": {
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "boolean"
+              },
+              "start_hour": {
+                "type": "integer",
+                "minimum": 10,
+                "maximum": 18
+              },
+              "end_hour": {
+                "type": "integer",
+                "minimum": 11,
+                "maximum": 19
+              },
+              "days": {
+                "minItems": 1,
+                "maxItems": 7,
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "weekday": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 7
+                    },
+                    "max_per_number": {
+                      "anyOf": [
+                        {
+                          "type": "integer",
+                          "minimum": 1,
+                          "maximum": 1000
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    }
+                  },
+                  "required": [
+                    "weekday",
+                    "max_per_number"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "pause_until": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "format": "date-time",
+                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "enabled",
+              "start_hour",
+              "end_hour",
+              "days",
+              "pause_until"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "required": [
+          "platform_id",
+          "calendar"
+        ],
+        "additionalProperties": false
+      }
     }
   ],
   "resources": [
@@ -19753,7 +20101,7 @@
     }
   ],
   "summary": {
-    "total_tools": 320,
+    "total_tools": 328,
     "tools_by_category": {
       "workspace_and_help": 18,
       "agent_configuration": 15,
@@ -19761,10 +20109,10 @@
       "icp": 11,
       "knowledge_and_content": 52,
       "crm_and_data_sources": 32,
-      "channels_and_credentials": 40,
+      "channels_and_credentials": 43,
       "dialogues_and_contacts": 35,
       "automation": 5,
-      "outbound_and_analytics": 72
+      "outbound_and_analytics": 77
     },
     "external_execution_pairs": [
       "besales_icp_analysis_get_instructions / submit",

package/dist/tools/definitions/agent-design.d.ts

@@ -170,7 +170,7 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     changelog_note?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
-    request_key?: string | undefined;
+    request_key: string;
     icp_profile_id?: string | null | undefined;
     candidate_prompt?: string | undefined;
     scenario_ids?: string[] | undefined;

package/dist/tools/definitions/agent-design.js

@@ -1,5 +1,5 @@
-import { icpImportSourceSchema, legacyIcpImportConfigSchema } from './icp-import-source.js';
 import { randomUUID } from 'node:crypto';
+import { icpImportSourceSchema, legacyIcpImportConfigSchema } from './icp-import-source.js';
 import { z } from 'zod';
 import { assertCompleteList } from '../incomplete-list.js';
 import { PROMPT_LANGUAGE_CODE_MAX_LENGTH } from './prompt-authoring.constants.js';
@@ -582,7 +582,8 @@ export const agentDesignTools = [
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
-            request_key: uuidSchema.optional(),
+            // Генерация при разборе сохраняет ОДИН ключ и для запроса, и для ответа/сбоя.
+            request_key: uuidSchema.optional().transform((key) => key ?? randomUUID()),
             icp_profile_id: uuidSchema.nullable().optional(),
             // Прогон по ещё не активированному тексту промпта: проверка кандидата ДО того, как он
             // станет промптом агента. Без поля кандидата проверить нечем — приходилось бы активировать
@@ -609,7 +610,7 @@ export const agentDesignTools = [
         createRequest: (input) => ({
             path: `/agents/${input.agent_id}/sandbox-runs`,
             body: compactObject({
-                requestKey: input.request_key ?? randomUUID(),
+                requestKey: input.request_key,
                 icpProfileId: input.icp_profile_id,
                 candidatePrompt: input.candidate_prompt,
                 scenarioIds: input.scenario_ids,
@@ -629,11 +630,16 @@ export const agentDesignTools = [
                     : undefined,
             }),
         }),
+        // Чтение статуса требует run_id из успешного старта; при потерянном ответе повторяем ключ.
         verifyWithToolName: 'besales_sandbox_run_get',
-        enhanceResponse: (response) => withInstructions(response, [
-            'Сохрани id прогона как run_id. Проверяй только этот прогон через besales_sandbox_run_get.',
-            'Первую проверку делай через 10–30 секунд; повторяй, пока status не станет COMPLETED, FAILED или CANCELLED.',
-        ]),
+        enhanceResponse: (response, input) => ({
+            ...withInstructions(response, [
+                'Сохрани id прогона как run_id. Проверяй только этот прогон через besales_sandbox_run_get.',
+                'Сохрани request_key. При таймауте или 5xx повтори вызов с тем же request_key и тем же намерением: вернётся тот же прогон. Новый ключ — новый платный прогон; другое намерение с прежним ключом даёт START_KEY_CONFLICT.',
+                'Первую проверку делай через 10–30 секунд; повторяй, пока status не станет COMPLETED, FAILED или CANCELLED.',
+            ]),
+            request_key: input.request_key,
+        }),
     }),
     defineTool({
         name: 'besales_sandbox_run_list',