@besales/mcp 0.45.0 → 0.47.0

package/dist/schemas/mcp-tools.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "besales-mcp Tool Definitions",
   "version": "1.3.0-draft",
-  "lastUpdated": "2026-08-18",
+  "lastUpdated": "2026-09-11",
   "description": "MCP tool schemas для besales-mcp npm package. Active v1.5 set содержит PromptHub/ICP/Sandbox/Knowledge external-execution operations и stateless Platform Setup Bridge direct tools. Setup Pipeline session tools сохранены как Phase 4+ future design, но не входят в active toolset.",
   "executionModes": {
     "summary": "Каждая active LLM-операция имеет 2 MCP tools: get_instructions + submit. Claude локально между tools выполняет LLM-вызовы своими моделями. Auto-detection через JWT scope mcp:* → external default.",
@@ -237,7 +237,7 @@
                   "type": "array",
                   "items": {}
                 },
-                "language_style": {
+                "languageStyle": {
                   "type": "object"
                 }
               }
@@ -249,13 +249,13 @@
               "type": "object",
               "required": [
                 "name",
-                "segment_id"
+                "segmentId"
               ],
               "properties": {
                 "name": {
                   "type": "string"
                 },
-                "segment_id": {
+                "segmentId": {
                   "type": "string",
                   "format": "uuid",
                   "description": "Existing segment id or id of a segment in this submit payload."
@@ -263,7 +263,7 @@
                 "description": {
                   "type": "string"
                 },
-                "pain_points": {
+                "painPoints": {
                   "type": "array",
                   "items": {}
                 },
@@ -274,7 +274,7 @@
                 "objections": {
                   "type": "object"
                 },
-                "messaging_hints": {
+                "messagingHints": {
                   "type": "object"
                 }
               }
@@ -423,8 +423,11 @@
         "required": [
           "agent_id",
           "operation_id",
-          "stages",
-          "final_content"
+          "stages"
+        ],
+        "anyOf": [
+          { "required": ["final_content"] },
+          { "required": ["finalContent"] }
         ],
         "properties": {
           "agent_id": {
@@ -463,6 +466,10 @@
           "final_content": {
             "type": "string"
           },
+          "finalContent": {
+            "type": "string",
+            "description": "Имя из schema результата instructions; эквивалент final_content."
+          },
           "metadata": {
             "type": "object",
             "properties": {
@@ -524,8 +531,11 @@
         "required": [
           "agent_id",
           "operation_id",
-          "stages",
-          "aggregated_issues"
+          "stages"
+        ],
+        "anyOf": [
+          { "required": ["aggregated_issues"] },
+          { "required": ["aggregatedIssues"] }
         ],
         "properties": {
           "agent_id": {
@@ -566,6 +576,13 @@
             "items": {
               "type": "object"
             }
+          },
+          "aggregatedIssues": {
+            "type": "array",
+            "description": "Имя из schema результата instructions; эквивалент aggregated_issues.",
+            "items": {
+              "type": "object"
+            }
           }
         }
       }
@@ -607,6 +624,12 @@
             "type": "string",
             "format": "uuid"
           },
+          "candidate_prompt": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 100000,
+            "description": "Неактивированный промпт для изолированного single_agent-прогона; production-конфигурация не меняется."
+          },
           "scenario_ids": {
             "type": "array",
             "items": {
@@ -673,6 +696,68 @@
         }
       }
     },
+    {
+      "name": "besales_sandbox_run_list",
+      "description": "Список sandbox-прогонов выбранного агента. Возвращает постраничные краткие состояния; продолжай по cursor до null, если нужен весь список.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["agent_id"],
+        "properties": {
+          "agent_id": { "type": "string", "format": "uuid" },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 100 },
+          "cursor": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "besales_sandbox_run_get",
+      "description": "Получить статус, прогресс, ошибки и результаты одного sandbox-прогона. QUEUED/RUNNING ещё не доказывают результат; терминальные статусы: COMPLETED, FAILED, CANCELLED. passRate — живучесть ответов, qualityRate и checksRate оцениваются отдельно.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["run_id"],
+        "properties": {
+          "run_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_sandbox_run_cancel",
+      "description": "Идемпотентно отменить незавершённый sandbox-прогон. После ответа проверь тот же run_id через besales_sandbox_run_get.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["run_id"],
+        "properties": {
+          "run_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_sandbox_run_feedback",
+      "description": "Сохранить человеческую оценку завершённого sandbox-прогона. Это отдельный отзыв проверяющего; автоматические findings отправляются через besales_sandbox_findings_submit.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["run_id", "reviewed_issues"],
+        "properties": {
+          "run_id": { "type": "string", "format": "uuid" },
+          "reviewed_issues": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "scenario_id": { "type": "string", "format": "uuid" },
+                "turn_index": { "type": "integer", "minimum": 0 },
+                "category": {
+                  "type": "string",
+                  "enum": ["hallucination", "wrong_action", "bad_tone", "missed_context", "other"]
+                },
+                "description": { "type": "string" }
+              }
+            }
+          },
+          "general_comments": { "type": "string" }
+        }
+      }
+    },
     {
       "name": "besales_sandbox_findings_get_instructions",
       "description": "⭐ EXTERNAL EXECUTION (NEW v3.1) — получить instructions для analysis sandbox results. Claude локально получает sandbox report + ICP/ТЗ контекст из чата → выдаёт structured findings (категория / severity / suggestion). Это ключевой fix для кейса с irrelevant findings от gpt-4o-mini.",
@@ -696,7 +781,7 @@
     },
     {
       "name": "besales_sandbox_findings_submit",
-      "description": "Submit Claude-generated sandbox findings. Findings сохраняются как SandboxRunFeedback с status=SUBMITTED (improvement-lab consumes). ВАЖНО: category — строго из enum ЭТОЙ submit-схемы (hallucination/wrong_action/wrong_routing/missed_trigger/wrong_pipeline_transition/rag_miss/bad_tone/other); он РАСХОДИТСЯ с enum в besales_sandbox_findings_get_instructions (там есть missed_context). Категорию из get_instructions, которой здесь нет (например missed_context), маппь на other — иначе 400.",
+      "description": "Сохранить findings sandbox-прогона. Поля и enum совпадают со schema, которую возвращает besales_sandbox_findings_get_instructions; legacy snake_case/message/suggestion по-прежнему принимаются рантаймом для совместимости.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -725,10 +810,10 @@
               "required": [
                 "category",
                 "severity",
-                "message"
+                "description"
               ],
               "properties": {
-                "scenario_id": {
+                "scenarioId": {
                   "type": "string",
                   "format": "uuid"
                 },
@@ -738,8 +823,7 @@
                     "hallucination",
                     "wrong_action",
                     "wrong_routing",
-                    "missed_trigger",
-                    "wrong_pipeline_transition",
+                    "missed_context",
                     "rag_miss",
                     "bad_tone",
                     "other"
@@ -753,13 +837,16 @@
                     "critical"
                   ]
                 },
-                "message": {
+                "description": {
                   "type": "string"
                 },
-                "suggestion": {
+                "evidence": {
+                  "type": "string"
+                },
+                "recommendation": {
                   "type": "string"
                 },
-                "turn_index": {
+                "turnIndex": {
                   "type": "integer"
                 }
               }
@@ -822,7 +909,7 @@
                 "message"
               ],
               "properties": {
-                "dialogue_id": {
+                "dialogueId": {
                   "type": "string",
                   "format": "uuid"
                 },
@@ -852,7 +939,7 @@
                 "suggestion": {
                   "type": "string"
                 },
-                "reference_message_index": {
+                "referenceMessageIndex": {
                   "type": "integer"
                 }
               }
@@ -900,8 +987,11 @@
         "type": "object",
         "required": [
           "agent_id",
-          "operation_id",
-          "qa_pairs"
+          "operation_id"
+        ],
+        "anyOf": [
+          { "required": ["qa_pairs"] },
+          { "required": ["qaPairs"] }
         ],
         "properties": {
           "agent_id": {
@@ -916,6 +1006,10 @@
             "type": "string",
             "format": "uuid"
           },
+          "knowledgeSpaceId": {
+            "type": "string",
+            "format": "uuid"
+          },
           "qa_pairs": {
             "type": "array",
             "items": {
@@ -939,6 +1033,19 @@
                 }
               }
             }
+          },
+          "qaPairs": {
+            "type": "array",
+            "description": "Имя из schema результата instructions; эквивалент qa_pairs.",
+            "items": {
+              "type": "object",
+              "required": ["question", "answer"],
+              "properties": {
+                "question": { "type": "string" },
+                "answer": { "type": "string" },
+                "tags": { "type": "array", "items": { "type": "string" } }
+              }
+            }
           }
         }
       }
@@ -1192,6 +1299,70 @@
         }
       }
     },
+    {
+      "name": "besales_workspace_navigate",
+      "description": "Навигатор по намерению: возвращает цель, выбранные объекты, выполненное и недостающее, нужный ввод человека, один следующий tool с аргументами и проверкой результата. Учитывает тип FAQ/sales/booking/outbound/support и живой workspace overview; свободный вопрос не превращает в обязательный мастер.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "intent"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "intent": {
+            "type": "string",
+            "enum": [
+              "CREATE_BOT",
+              "IMPROVE_AGENT",
+              "DIAGNOSE_CONTACT",
+              "AUDIT_DIALOGUES",
+              "CAMPAIGN_REPORT",
+              "CONNECT_CRM",
+              "CONNECT_DATASOURCE",
+              "CONFIGURE_FOLLOWUP",
+              "CONTINUE_TASK",
+              "FREEFORM"
+            ]
+          },
+          "bot_type": {
+            "type": "string",
+            "enum": [
+              "FAQ",
+              "SALES",
+              "BOOKING",
+              "OUTBOUND",
+              "SUPPORT",
+              "UNKNOWN"
+            ]
+          },
+          "platform_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "contact_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "task_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "question": {
+            "type": "string",
+            "minLength": 2,
+            "maxLength": 500
+          }
+        }
+      }
+    },
     {
       "name": "besales_platform_context_get",
       "description": "Get sanitized platform setup context first when user gives platformId. Returns platform, agents, router, triggers, behavior, follow-up, pipeline settings and readiness flags; never returns channel credentials or secrets.",
@@ -1204,13 +1375,51 @@
           "platform_id": {
             "type": "string",
             "format": "uuid"
+          },
+          "sections": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string",
+              "enum": [
+                "platform",
+                "agent_summaries",
+                "agents_full",
+                "router",
+                "behavior",
+                "follow_up",
+                "pipeline_settings",
+                "readiness"
+              ]
+            },
+            "description": "Необязательный срез большого снимка. agent_summaries не содержит compiledPrompt; agents_full содержит."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_trigger_action_catalog_get",
+      "description": "Получить актуальную JSON-схему, минимальный валидный пример, имя входного config-поля, relation ответа, зависимости, эффект и способ проверки trigger action. Перед новым типом действия вызывай с action_type, чтобы не перебирать варианты через ошибки 400.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "platform_id"
+        ],
+        "properties": {
+          "platform_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "action_type": {
+            "type": "string",
+            "minLength": 1
           }
         }
       }
     },
     {
       "name": "besales_agent_list",
-      "description": "List agents attached to an existing platform. Use after context when the user wants to inspect or choose an agent before targeted setup mutations.",
+      "description": "Компактно найти агентов существующей площадки по обычному имени. Возвращает summaries без полного compiledPrompt, точный total, selection.status и cursor. Непустой cursor означает, что показана только страница; для массовой операции дочитай все страницы.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -1220,10 +1429,53 @@
           "platform_id": {
             "type": "string",
             "format": "uuid"
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 200,
+            "description": "Размер страницы. Без параметра список отдаётся целиком."
+          },
+          "cursor": {
+            "type": "string",
+            "minLength": 1,
+            "description": "cursor предыдущей страницы."
+          },
+          "query": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Поиск без учёта регистра по name или displayName."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_agent_get",
+      "description": "Прочитать полную карточку выбранного агента, включая текущий compiledPrompt и runtime-конфигурацию. Вызывай явно после выбора агента из компактного besales_agent_list.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
           }
         }
       }
     },
+    {
+      "name": "besales_agent_readiness_get",
+      "description": "Проверить готовность выбранного агента: channel/prompt/greeting/knowledge/ICP/sandbox gates, findingsStatus, qualityRate, checksRate. Сейчас возвращает NOT_PROVEN: configurationCurrent=null, полная версия зависимых настроек не зафиксирована. promptAndAgentCurrent проверяет только промпт и запись агента; повтор sandbox не устраняет unverifiedDependencies. CRM live authorization проверяется отдельно.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["agent_id"],
+        "properties": {
+          "agent_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
     {
       "name": "besales_agent_variable_overrides_get",
       "description": "Read-only: current variable overrides set on an agent — workspaceOverrides[] (WorkspaceVariable, referenced as {{{name}}}) and customOverrides[] (platform CustomVariable, {name}), each with variable id, name, type, overrideValue. Read this BEFORE besales_agent_update: agent_workspace_variable_overrides / agent_variable_overrides replace the whole set (delete missing + upsert sent), so resend any existing override you want to keep.",
@@ -1325,7 +1577,7 @@
           "funnel": {
             "type": "string",
             "maxLength": 200,
-            "description": "Канонический ключ/название бизнес-воронки для аналитики. НЕ имя файла, batch/resend или дата запуска."
+            "description": "Воронка ШКОЛЫ в форме «f11 — ДБО / NR / ВК / In Stream» — код fNN ОБЯЗАТЕЛЕН. ⚠️ Это НЕ когорта и НЕ подпись запуска: «reg-no-show», «post-web|дбо», «svs-zapusk» сюда класть нельзя — тип отбора идёт в segment, продукт в product_code, подпись запуска в cohort_label. Ось «Воронка» сравнивается по коду, поэтому значение без кода становится отдельной «воронкой» и засоряет фильтр аналитики."
           },
           "segment": {
             "type": "string",
@@ -1610,7 +1862,7 @@
           "funnel": {
             "type": "string",
             "maxLength": 200,
-            "description": "Canonical business-funnel key/name for analytics."
+            "description": "Воронка ШКОЛЫ в форме «f11 — ДБО / NR / ВК / In Stream» — код fNN ОБЯЗАТЕЛЕН. ⚠️ Это НЕ когорта и НЕ подпись запуска: «reg-no-show», «post-web|дбо», «svs-zapusk» сюда класть нельзя — тип отбора идёт в segment, продукт в product_code, подпись запуска в cohort_label. Ось «Воронка» сравнивается по коду, поэтому значение без кода становится отдельной «воронкой» и засоряет фильтр аналитики."
           },
           "segment": {
             "type": "string",
@@ -2053,7 +2305,7 @@
                 "funnel": {
                   "type": "string",
                   "maxLength": 200,
-                  "description": "Canonical business-funnel key/name for analytics."
+                  "description": "Воронка ШКОЛЫ в форме «f11 — ДБО / NR / ВК / In Stream» — код fNN ОБЯЗАТЕЛЕН. ⚠️ Это НЕ когорта и НЕ подпись запуска: «reg-no-show», «post-web|дбо», «svs-zapusk» сюда класть нельзя — тип отбора идёт в segment, продукт в product_code, подпись запуска в cohort_label. Ось «Воронка» сравнивается по коду, поэтому значение без кода становится отдельной «воронкой» и засоряет фильтр аналитики."
                 },
                 "segment": {
                   "type": "string",
@@ -4504,6 +4756,53 @@
                   "type": "integer"
                 },
                 "description": "GetCourse offer ids whose paid orders are credited to us regardless of who created the order — the agent via GETCOURSE_CREATE_DEAL or a manager by hand in the GetCourse admin. Empty array turns the rule off. The set applies to the whole school (every platform sharing the GetCourse domain), not to a single platform. Changes money attribution retroactively — dangerous, requires explicit_confirmation."
+              },
+              "guard_active_series": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "enum": [
+                  "OFF",
+                  "WARN",
+                  "BLOCK",
+                  null
+                ],
+                "description": "Outbound guard: do not write while the person's webinar series is running. OFF — rule off; WARN — reason audited, send proceeds; BLOCK — send stopped. null = not configured (default: active_series BLOCK, others WARN). See docs/features/outbound-guards.md."
+              },
+              "guard_active_application": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "enum": [
+                  "OFF",
+                  "WARN",
+                  "BLOCK",
+                  null
+                ],
+                "description": "Outbound guard: do not write while a sales rep works an active application. OFF — rule off; WARN — reason audited, send proceeds; BLOCK — send stopped. null = not configured (default: active_series BLOCK, others WARN). See docs/features/outbound-guards.md."
+              },
+              "guard_paid": {
+                "type": [
+                  "string",
+                  "null"
+                ],
+                "enum": [
+                  "OFF",
+                  "WARN",
+                  "BLOCK",
+                  null
+                ],
+                "description": "Outbound guard: do not write to someone who already paid for THIS product. OFF — rule off; WARN — reason audited, send proceeds; BLOCK — send stopped. null = not configured (default: active_series BLOCK, others WARN). See docs/features/outbound-guards.md."
+              },
+              "quiet_days": {
+                "type": [
+                  "integer",
+                  "null"
+                ],
+                "minimum": 0,
+                "description": "ТИХИЙ ПЕРИОД площадки в сутках: не писать человеку N суток после НАШЕГО касания — отправки или шага календарной цепочки. Считается ПО ЧЕЛОВЕКУ во всём воркспейсе, волна школы касанием НЕ считается (замер: широкий периметр отсекал бы 15,3 % отправок). null = «не настраивали», действующее значение 0 (правила нет); рекомендация владельца — 7. Расписание этим числом НЕ судится: у него своё поле cooldown_days. Перекрытие — у рассылки (quiet_days_override)."
               }
             }
           },
@@ -4512,60 +4811,174 @@
           },
           "confirmation_reason": {
             "type": "string"
-          }
-        }
-      }
-    },
-    {
-      "name": "besales_audit_revert",
-      "description": "Revert a reversible audit log. Передай `platform_id` для platform-scoped logs (записи через platform-setup-adapter); опусти для workspace-scoped logs (variables-adapter и аналоги).",
-      "inputSchema": {
-        "type": "object",
-        "required": [
-          "audit_log_id"
-        ],
-        "properties": {
-          "workspace_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "platform_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "audit_log_id": {
-            "type": "string",
-            "format": "uuid"
-          }
-        }
-      }
-    },
-    {
-      "name": "besales_feedback_sheet_link",
-      "description": "Привязать Google Sheets-таблицу с замечаниями тестировщиков к промпту агента. Принимает ссылку docs.google.com/spreadsheets/...; один файл можно привязать к нескольким промптам. В ответе — serviceAccountEmail: расшарьте таблицу на этот email (Viewer для READ_ONLY, Editor для EDITABLE).",
-      "inputSchema": {
-        "type": "object",
-        "required": [
-          "agent_id",
-          "source_url"
-        ],
-        "properties": {
-          "agent_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "source_url": {
-            "type": "string",
-            "description": "Ссылка на Google Sheet (docs.google.com/spreadsheets/...)."
-          },
-          "access_mode": {
-            "type": "string",
-            "enum": [
-              "READ_ONLY",
-              "EDITABLE"
-            ],
-            "default": "READ_ONLY",
-            "description": "Намерение: READ_ONLY — только чтение; EDITABLE — Phase 2 запись статусов строк."
+          },
+          "funnel_analytics": {
+            "type": "object",
+            "description": "Настройки раздела «Воронка канала»: ворота решения (тройка стадий «отправлено → одобрено | отклонено»), целевая стадия «Пути до стадии», пороги вовлечённости и «застрял». null у ворот и цели — СБРОС, отсутствие поля — «не трогать». Запись делегируется сервисам раздела, поэтому их проверки (стадии разные, стадии есть в каталоге площадки) не обходятся.",
+            "properties": {
+              "decision_gate": {
+                "type": [
+                  "object",
+                  "null"
+                ],
+                "required": [
+                  "submitted",
+                  "approved",
+                  "rejected"
+                ],
+                "properties": {
+                  "submitted": {
+                    "type": "object",
+                    "required": [
+                      "pipeline_crm_id",
+                      "pipeline_id",
+                      "status_id"
+                    ],
+                    "properties": {
+                      "pipeline_crm_id": {
+                        "type": "string"
+                      },
+                      "pipeline_id": {
+                        "type": "integer"
+                      },
+                      "status_id": {
+                        "type": "integer"
+                      }
+                    }
+                  },
+                  "approved": {
+                    "type": "object",
+                    "required": [
+                      "pipeline_crm_id",
+                      "pipeline_id",
+                      "status_id"
+                    ],
+                    "properties": {
+                      "pipeline_crm_id": {
+                        "type": "string"
+                      },
+                      "pipeline_id": {
+                        "type": "integer"
+                      },
+                      "status_id": {
+                        "type": "integer"
+                      }
+                    }
+                  },
+                  "rejected": {
+                    "type": "object",
+                    "required": [
+                      "pipeline_crm_id",
+                      "pipeline_id",
+                      "status_id"
+                    ],
+                    "properties": {
+                      "pipeline_crm_id": {
+                        "type": "string"
+                      },
+                      "pipeline_id": {
+                        "type": "integer"
+                      },
+                      "status_id": {
+                        "type": "integer"
+                      }
+                    }
+                  }
+                }
+              },
+              "path_target_stage": {
+                "type": [
+                  "object",
+                  "null"
+                ],
+                "required": [
+                  "pipeline_crm_id",
+                  "pipeline_id",
+                  "status_id"
+                ],
+                "properties": {
+                  "pipeline_crm_id": {
+                    "type": "string"
+                  },
+                  "pipeline_id": {
+                    "type": "integer"
+                  },
+                  "status_id": {
+                    "type": "integer"
+                  }
+                }
+              },
+              "engaged_inbound_count": {
+                "type": [
+                  "integer",
+                  "null"
+                ],
+                "minimum": 2,
+                "maximum": 20
+              },
+              "stuck_threshold_hours": {
+                "type": [
+                  "integer",
+                  "null"
+                ],
+                "minimum": 1,
+                "maximum": 720
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_audit_revert",
+      "description": "Revert a reversible audit log. Передай `platform_id` для platform-scoped logs (записи через platform-setup-adapter); опусти для workspace-scoped logs (variables-adapter и аналоги).",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "audit_log_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "platform_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "audit_log_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_feedback_sheet_link",
+      "description": "Привязать Google Sheets-таблицу с замечаниями тестировщиков к промпту агента. Принимает ссылку docs.google.com/spreadsheets/...; один файл можно привязать к нескольким промптам. В ответе — serviceAccountEmail: расшарьте таблицу на этот email (Viewer для READ_ONLY, Editor для EDITABLE).",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "source_url"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "source_url": {
+            "type": "string",
+            "description": "Ссылка на Google Sheet (docs.google.com/spreadsheets/...)."
+          },
+          "access_mode": {
+            "type": "string",
+            "enum": [
+              "READ_ONLY",
+              "EDITABLE"
+            ],
+            "default": "READ_ONLY",
+            "description": "Намерение: READ_ONLY — только чтение; EDITABLE — Phase 2 запись статусов строк."
           },
           "agent_version_id": {
             "type": "string",
@@ -4829,7 +5242,7 @@
     },
     {
       "name": "besales_prompt_patch_apply",
-      "description": "S3.8: применяет batch operations к draft.currentContent. Resets TTL на 24h (activity-based). Возвращает `appliedCount` + `skippedCount` (anchor не найден / growth guard >30%). Endpoint: PATCH /api/v2/agents/{agentId}/prompt/drafts/{draftId}/operations. Scope: write:prompt-drafts. ВАЖНО: ведущие и замыкающие пробелы/переводы строк в replacement_text срезаются — чтобы вставить пустую строку-разделитель между абзацами, держи перевод строки В СЕРЕДИНЕ replacement_text или включи окружающий текст в anchor/target; иначе соседние заголовки/абзацы склеятся. Ответ возвращает весь обновлённый currentContent (может быть очень большим) — сверяйся по appliedCount/skippedCount, не перечитывай весь контент между батчами.",
+      "description": "S3.8: применяет batch operations к draft.currentContent. Resets TTL на 24h (activity-based). Возвращает `appliedCount` + `skippedCount` (anchor не найден / growth guard >30%). Endpoint: PATCH /api/v2/agents/{agentId}/prompt/drafts/{draftId}/operations. Scope: write:prompt-drafts. ВАЖНО: ведущие и замыкающие пробелы/переводы строк в replacement_text срезаются — чтобы вставить пустую строку-разделитель между абзацами, держи перевод строки В СЕРЕДИНЕ replacement_text или включи окружающий текст в anchor/target; иначе соседние заголовки/абзацы склеятся. Ответ НЕ содержит текст черновика: приезжают appliedCount/skippedCount, метаданные (draft.characters — длина после правки) и diff — построчная разница «до → после» (removedLines/addedLines, при обрезке truncated: true). ВНИМАНИЕ: пустые removedLines/addedLines НЕ означают «ничего не применилось» — diff строится как разность множеств строк, поэтому move_text_after_text и правка одних пробелов дают пустые списки; факт изменения читай по diff.contentChanged. Перечитать промпт целиком — besales_prompt_patch_get. между батчами.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -4892,7 +5305,7 @@
     },
     {
       "name": "besales_prompt_patch_commit",
-      "description": "S3.8: коммитит draft как новую PromptVersion. Pipeline: (1) Lint (PromptLintService) — hard_fail блокирует commit с 400; (2) Optimistic lock в prompt-services — `agentSideHash` server-side читается из AgentChat (если production prompt изменился между fork и commit → 409 PROMPT_DRAFT_REBASE_REQUIRED, discard и создай новый); (3) AgentChat sync с conditional UPDATE; (4) если sync упал после успешного PS commit → retry queue (success клиенту). Endpoint: POST /api/v2/agents/{agentId}/prompt/drafts/{draftId}/commit. Scope: write:prompt-drafts.",
+      "description": "S3.8: коммитит draft как новую PromptVersion. Pipeline: (1) Lint (PromptLintService) — hard_fail блокирует commit с 400; (2) Optimistic lock в prompt-services — `agentSideHash` server-side читается из AgentChat (если production prompt изменился между fork и commit → 409 PROMPT_DRAFT_REBASE_REQUIRED, discard и создай новый); (3) AgentChat sync с conditional UPDATE; (4) если sync упал после успешного PS commit → retry queue (success клиенту). Endpoint: POST /api/v2/agents/{agentId}/prompt/drafts/{draftId}/commit. Scope: write:prompt-drafts. Ответ несёт только адресацию новой версии (newVersion.id + version) и метаданные черновика — текст промпта не дублируется.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -4940,7 +5353,8 @@
         "additionalProperties": false,
         "required": [
           "agent_ids",
-          "operations"
+          "operations",
+          "explicit_confirmation"
         ],
         "properties": {
           "agent_ids": {
@@ -5003,6 +5417,10 @@
           "platform_id": {
             "type": "string",
             "format": "uuid"
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true
           }
         }
       }
@@ -5094,7 +5512,7 @@
     },
     {
       "name": "besales_workbook_inspect",
-      "description": "v1.5 workbook ingestion: открыть xlsx (по stored_file_id) или Google Sheets (по google_sheets_url) и вернуть структуру всех вкладок — sample rows с per-cell данными (value + hyperlink + formula) + per-column hyperlink статистика (lead/contact amoCRM). Создаёт SourceWorkbook record для provenance. Для xlsx — сначала загрузите файл через POST /api/v2/files. Для Google Sheets — если 403, response содержит serviceAccountEmail для расшарить. Sheet identifier в дальнейших вызовах — sheetTitle/sheetGid/sheetIndex в body. Scope: mcp:*.",
+      "description": "Инвентаризация workbook: открыть ранее загруженный xlsx (stored_file_id) или Google Sheets и вернуть список всех вкладок с ограниченным sample. Создаёт SourceWorkbook для provenance. Это не полная вычитка: поздние строки и колонки читай через besales_workbook_sheet_read, а readError не трактуй как пустой лист. xlsx загружается через browser flow besales_file_upload_request/status. Scope: mcp:*.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -5130,6 +5548,87 @@
         }
       }
     },
+    {
+      "name": "besales_workbook_get",
+      "description": "Получить метаданные, classification и archivedAt зарегистрированного SourceWorkbook без чтения содержимого листов. Scope: mcp:*.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["workbook_id"],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session (BESALES_WORKSPACE_ID or active connection)."
+          },
+          "workbook_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_workbook_sheet_read",
+      "description": "Постранично прочитать выбранный диапазон листа SourceWorkbook без записи в RAG. Возвращает hasMore/next offsets, известный либо null total и SHA-256 pageFingerprint для обнаружения изменений. Ровно один из sheet_title/sheet_gid/sheet_index обязателен. Scope: mcp:*.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["workbook_id"],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session (BESALES_WORKSPACE_ID or active connection)."
+          },
+          "workbook_id": { "type": "string", "format": "uuid" },
+          "sheet_title": { "type": "string" },
+          "sheet_gid": { "type": "integer" },
+          "sheet_index": { "type": "integer", "minimum": 0 },
+          "row_offset": { "type": "integer", "minimum": 0, "default": 0 },
+          "row_limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 50 },
+          "column_offset": { "type": "integer", "minimum": 0, "default": 0 },
+          "column_limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 50
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_workbook_classification_update",
+      "description": "Сохранить решения классификации вкладок в SourceWorkbook. Перед записью дочитай нужные страницы и проверь pageFingerprint. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["workbook_id", "classification"],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session (BESALES_WORKSPACE_ID or active connection)."
+          },
+          "workbook_id": { "type": "string", "format": "uuid" },
+          "classification": {
+            "type": "array",
+            "items": { "type": "object", "additionalProperties": true }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_workbook_archive",
+      "description": "Архивировать SourceWorkbook после явного подтверждения. Созданные документы знаний сохраняются. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["workbook_id", "explicit_confirmation"],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session (BESALES_WORKSPACE_ID or active connection)."
+          },
+          "workbook_id": { "type": "string", "format": "uuid" },
+          "explicit_confirmation": { "type": "boolean", "const": true }
+        }
+      }
+    },
     {
       "name": "besales_workbook_extract_amocrm_leads",
       "description": "v1.5 workbook ingestion: прочитать вкладку SourceWorkbook ЦЕЛИКОМ (без sample-лимита inspect) и извлечь все amoCRM lead-ID из ячеек (value + hyperlink + formula). Используй когда `inspect` sample недостаточен — например, для большого диалог-индекса с 100+ ссылок. Sheet identifier — один из sheet_title / sheet_gid / sheet_index. Опционально include_contacts=true возвращает также contacts. Hard cap 10000 строк на лист. Scope: mcp:*.",
@@ -5577,6 +6076,7 @@
           },
           "explicit_confirmation": {
             "type": "boolean",
+            "const": true,
             "description": "Должен быть true. False → 400 BadRequest."
           }
         }
@@ -5841,6 +6341,7 @@
           },
           "explicit_confirmation": {
             "type": "boolean",
+            "const": true,
             "description": "Должен быть true. False → 400 BadRequest."
           }
         }
@@ -5911,6 +6412,7 @@
           },
           "explicit_confirmation": {
             "type": "boolean",
+            "const": true,
             "description": "Должен быть true. False → 400 BadRequest."
           }
         }
@@ -6036,6 +6538,7 @@
           },
           "explicit_confirmation": {
             "type": "boolean",
+            "const": true,
             "description": "Должен быть true. False → 400 BadRequest."
           }
         }
@@ -6255,14 +6758,15 @@
             "format": "uuid"
           },
           "explicit_confirmation": {
-            "type": "boolean"
+            "type": "boolean",
+            "const": true
           }
         }
       }
     },
     {
       "name": "besales_knowledge_table_reindex",
-      "description": "v1.5 Increment 3: полная переиндексация таблицы (delete vectors + re-fetch CSV + re-embed + Pinecone upsert). SYNC operation — может занять время для больших таблиц. Scope: write:knowledge.",
+      "description": "Запустить полную фоновую переиндексацию knowledge table: delete vectors + re-fetch CSV + re-embed + Pinecone upsert. Возвращает job_id; проверяй исход через besales_knowledge_table_reindex_status. Scope: write:knowledge.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -6284,18 +6788,47 @@
             "format": "uuid"
           },
           "explicit_confirmation": {
-            "type": "boolean"
+            "type": "boolean",
+            "const": true
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_knowledge_table_reindex_status",
+      "description": "Проверить состояние фоновой переиндексации knowledge table: QUEUED/RUNNING/COMPLETED/FAILED/EXPIRED, progress, result/error и timestamps. Состояние хранится 24 часа. Scope: read:knowledge.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "knowledge_space_id",
+          "table_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "knowledge_space_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "table_id": {
+            "type": "string",
+            "format": "uuid"
           }
         }
       }
     },
     {
       "name": "besales_knowledge_namespace_reindex",
-      "description": "Фоновая (BullMQ) переиндексация knowledge space: re-embed существующих Q&A + чанков документов из Postgres → Pinecone, идемпотентно (upsert по стабильному id). Восстанавливает поиск, когда данные есть в Postgres, но besales_knowledge_qa_search пуст (рассинхрон PG↔Pinecone после транзиентного сбоя upsert при сохранении или смены scope). ASYNC — итог в логах воркера, повтори поиск через ~минуту. types опционально (по умолчанию [qa, doc]). Scope: mcp:platform-setup.",
+      "description": "Запустить фоновую переиндексацию knowledge space: re-embed существующих Q&A и чанков документов из Postgres → Pinecone. Возвращает job_id; проверяй исход через besales_knowledge_namespace_reindex_status. types опционально (по умолчанию [qa, doc]). Scope: mcp:platform-setup.",
       "inputSchema": {
         "type": "object",
         "required": [
-          "knowledge_space_id"
+          "knowledge_space_id",
+          "explicit_confirmation"
         ],
         "properties": {
           "workspace_id": {
@@ -6316,13 +6849,39 @@
               ]
             },
             "description": "Какие типы переиндексировать; default [qa, doc]"
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_knowledge_namespace_reindex_status",
+      "description": "Проверить состояние фоновой переиндексации knowledge space: QUEUED/RUNNING/COMPLETED/FAILED/EXPIRED, progress, result/error и timestamps. Состояние хранится 24 часа. Scope: read:knowledge.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "knowledge_space_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "knowledge_space_id": {
+            "type": "string",
+            "format": "uuid"
           }
         }
       }
     },
     {
       "name": "besales_variable_list",
-      "description": "v1.5 Increment 4a: список переменных. scope=WORKSPACE возвращает глобальные WorkspaceVariable (доступны всем платформам); scope=CHANNEL требует platform_id и возвращает CustomVariable одной платформы (filter: all|variables|constants). Референс в промпте/шаблоне: WORKSPACE → {{{name}}} (тройные фигурные), CHANNEL-константа → {{name}} (двойные). Scope: mcp:platform-setup.",
+      "description": "Список переменных workspace или платформы. scope=WORKSPACE возвращает глобальные WorkspaceVariable; scope=CHANNEL требует platform_id и возвращает CustomVariable одной платформы (filter: all|variables|constants). Постраничная выдача: сервер ограничивает страницу, до 200 по limit. Если показана не вся выборка, ответ содержит nextCursor, а вызов без явных limit/cursor откажется возвращать неполный снимок. Дочитывайте страницы, пока nextCursor не опустеет. Референс: WORKSPACE → {{{name}}}, CHANNEL-константа → {{name}}. Scope: mcp:platform-setup.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -6354,6 +6913,17 @@
               "constants"
             ],
             "description": "Filter для CHANNEL scope; default=all"
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 200,
+            "description": "Размер страницы. Умолчания у аргумента НЕТ намеренно: молча усечённый перечень настройки хуже отказа."
+          },
+          "cursor": {
+            "type": "string",
+            "minLength": 1,
+            "description": "nextCursor предыдущей страницы."
           }
         }
       }
@@ -7452,14 +8022,29 @@
       }
     },
     {
-      "name": "besales_crm_field_mapping_get",
-      "description": "v1.5 Increment 5c: текущий маппинг полей CRM + доступные поля. Только AmoCRM/Bitrix24 (иначе unsupported_reason). Scope: mcp:platform-setup.",
+      "name": "besales_crm_amocrm_channel_registration",
+      "description": "Заявка на регистрацию чат-канала AmoCRM: адрес вебхука воркспейса + текст письма в техподдержку AmoCRM. Без зарегистрированного канала бот управляет сделкой, но переписка в её карточке не появляется — channelId/channelSecretKey выдаёт только их поддержка по письму заданной формы. Текст собирает бэкенд, тот же ответ показывает страница AmoCRM в интерфейсе: пересылай дословно, адрес сам не собирай. Scope: mcp:platform-setup.",
       "inputSchema": {
         "type": "object",
-        "required": [
-          "crm_id"
-        ],
-        "additionalProperties": false,
+        "required": [],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_crm_field_mapping_get",
+      "description": "v1.5 Increment 5c: текущий маппинг полей CRM + доступные поля. Только AmoCRM/Bitrix24 (иначе unsupported_reason). Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "crm_id"
+        ],
+        "additionalProperties": false,
         "properties": {
           "workspace_id": {
             "type": "string",
@@ -7818,7 +8403,8 @@
         "required": [
           "data_source_id",
           "catalog_external_code",
-          "enabled"
+          "enabled",
+          "explicit_confirmation"
         ],
         "additionalProperties": false,
         "properties": {
@@ -7840,13 +8426,17 @@
           "name": {
             "type": "string",
             "description": "Опц. имя векторной таблицы при включении."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "const": true
           }
         }
       }
     },
     {
       "name": "besales_workspace_use",
-      "description": "Привязать ТЕКУЩУЮ Claude-сессию к воркспейсу (in-memory, до конца сессии). Для GUI-хостов (Claude Desktop), где нельзя задать env на сессию: если подключено несколько воркспейсов — этим тулом биндишь сессию к нужному, не трогая другие сессии и keychain `active`. workspace_id бери из besales_workspace_current. Запрещён, если сессия запиннена через BESALES_WORKSPACE_ID.",
+      "description": "Привязать ТЕКУЩУЮ Claude-сессию к выбранному workspace (in-memory, до конца сессии). Сначала вызови besales_workspace_current и покажи человеку названия компаний и безопасные подписи аккаунтов; UUID передай сам. Запрещён, если сессия запиннена через BESALES_WORKSPACE_ID.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -7856,20 +8446,117 @@
           "workspace_id": {
             "type": "string",
             "format": "uuid",
-            "description": "UUID подключённого воркспейса (см. besales_workspace_current.connected[].workspace_id)."
+            "description": "UUID подключённого workspace из besales_workspace_current.connected[].workspace_id; человек выбирает по workspace_name/account_label, а не ищет UUID сам."
           }
         }
       }
     },
     {
       "name": "besales_workspace_current",
-      "description": "Показать воркспейс текущей сессии (+ source: env/session/active/sole/none) и список всех подключённых воркспейсов. Read-only, без обращения к backend. Зови перед besales_workspace_use, чтобы узнать доступные workspace_id.",
+      "description": "Показать выбранный workspace, источник выбора (env/session/sole/ambiguous/none) и все подключения с workspace_name, безопасной account_label и свежестью подписи. Для неизвестных/устаревших подписей делает лёгкий scoped refresh без workspace overview. current/cached/stale/unknown и label_refresh_error различают свежесть, старый backend, ключ и scope. При ambiguous покажи названия человеку и сам передай UUID в besales_workspace_use.",
       "inputSchema": {
         "type": "object",
         "required": [],
         "properties": {}
       }
     },
+    {
+      "name": "besales_task_create",
+      "description": "Сохранить цель и минимальный прогресс работы между MCP-сессиями на этой машине. Состояние workspace-scoped, не содержит credentials и не заменяет свежую проверку объектов/прав. Возвращает task_id и version для CAS-обновлений.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["goal"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "goal": { "type": "string", "minLength": 3, "maxLength": 500 },
+          "context": { "type": "string", "minLength": 1, "maxLength": 2000 },
+          "constraints": { "type": "array", "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 500 }, "default": [] },
+          "object_refs": { "type": "array", "maxItems": 100, "items": { "type": "object", "required": ["type", "id"], "additionalProperties": false, "properties": { "type": { "type": "string", "minLength": 1, "maxLength": 80 }, "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "label": { "type": "string", "minLength": 1, "maxLength": 200 } } }, "default": [] },
+          "checkpoints": { "type": "array", "maxItems": 100, "items": { "type": "object", "required": ["key", "label", "status"], "additionalProperties": false, "properties": { "key": { "type": "string", "minLength": 1, "maxLength": 80 }, "label": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "type": "string", "enum": ["PENDING", "COMPLETED", "BLOCKED"] }, "evidence": { "type": "string", "minLength": 1, "maxLength": 500 } } }, "default": [] },
+          "pending_operations": { "type": "array", "maxItems": 50, "items": { "type": "object", "required": ["operation", "status"], "additionalProperties": false, "properties": { "operation": { "type": "string", "minLength": 1, "maxLength": 120 }, "object_ref": { "type": "object", "required": ["type", "id"], "additionalProperties": false, "properties": { "type": { "type": "string", "minLength": 1, "maxLength": 80 }, "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "label": { "type": "string", "minLength": 1, "maxLength": 200 } } }, "idempotency_key": { "type": "string", "minLength": 1, "maxLength": 200 }, "verify_with": { "type": "string", "minLength": 1, "maxLength": 120 }, "status": { "type": "string", "enum": ["PLANNED", "AWAITING_USER", "OUTCOME_UNKNOWN"] } } }, "default": [] },
+          "expected_user_action": { "type": ["string", "null"], "minLength": 1, "maxLength": 1000 },
+          "retention_days": { "type": "integer", "minimum": 1, "maximum": 180 }
+        }
+      }
+    },
+    {
+      "name": "besales_task_list",
+      "description": "Список сохранённых задач только выбранного workspace. При нескольких задачах возвращает selection_required=true: выбери task_id явно, не продолжай самую новую автоматически.",
+      "inputSchema": {
+        "type": "object",
+        "required": [],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "status": { "type": "string", "enum": ["ACTIVE", "COMPLETED", "CANCELLED", "EXPIRED"] }
+        }
+      }
+    },
+    {
+      "name": "besales_task_get",
+      "description": "Прочитать сохранённую задачу по task_id в выбранном workspace. Перед продолжением перечитай актуальные объекты и besales_workspace_current: сохранённое состояние не доказывает текущую конфигурацию или права.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["task_id"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "task_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_task_update",
+      "description": "Обновить сохранённую ACTIVE-задачу с compare-and-swap по expected_version. При TASK_VERSION_CONFLICT перечитай задачу и согласуй изменения; не повторяй pending mutation автоматически.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["task_id", "expected_version"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "task_id": { "type": "string", "format": "uuid" },
+          "expected_version": { "type": "integer", "minimum": 1 },
+          "goal": { "type": "string", "minLength": 3, "maxLength": 500 },
+          "context": { "type": "string", "minLength": 1, "maxLength": 2000 },
+          "constraints": { "type": "array", "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 500 } },
+          "object_refs": { "type": "array", "maxItems": 100, "items": { "type": "object", "required": ["type", "id"], "additionalProperties": false, "properties": { "type": { "type": "string", "minLength": 1, "maxLength": 80 }, "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "label": { "type": "string", "minLength": 1, "maxLength": 200 } } } },
+          "checkpoints": { "type": "array", "maxItems": 100, "items": { "type": "object", "required": ["key", "label", "status"], "additionalProperties": false, "properties": { "key": { "type": "string", "minLength": 1, "maxLength": 80 }, "label": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "type": "string", "enum": ["PENDING", "COMPLETED", "BLOCKED"] }, "evidence": { "type": "string", "minLength": 1, "maxLength": 500 } } } },
+          "pending_operations": { "type": "array", "maxItems": 50, "items": { "type": "object", "required": ["operation", "status"], "additionalProperties": false, "properties": { "operation": { "type": "string", "minLength": 1, "maxLength": 120 }, "object_ref": { "type": "object", "required": ["type", "id"], "additionalProperties": false, "properties": { "type": { "type": "string", "minLength": 1, "maxLength": 80 }, "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "label": { "type": "string", "minLength": 1, "maxLength": 200 } } }, "idempotency_key": { "type": "string", "minLength": 1, "maxLength": 200 }, "verify_with": { "type": "string", "minLength": 1, "maxLength": 120 }, "status": { "type": "string", "enum": ["PLANNED", "AWAITING_USER", "OUTCOME_UNKNOWN"] } } } },
+          "expected_user_action": { "type": ["string", "null"], "minLength": 1, "maxLength": 1000 }
+        }
+      }
+    },
+    {
+      "name": "besales_task_close",
+      "description": "Закрыть ACTIVE-задачу как COMPLETED или CANCELLED с проверкой expected_version. Закрытая задача не возобновляется автоматически.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["task_id", "expected_version", "outcome"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "task_id": { "type": "string", "format": "uuid" },
+          "expected_version": { "type": "integer", "minimum": 1 },
+          "outcome": { "type": "string", "enum": ["COMPLETED", "CANCELLED"] }
+        }
+      }
+    },
+    {
+      "name": "besales_task_delete",
+      "description": "Безвозвратно удалить локальное состояние задачи. Требует точную expected_version и explicit_confirmation=true; не удаляет созданные объекты Besales.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["task_id", "expected_version", "explicit_confirmation"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "task_id": { "type": "string", "format": "uuid" },
+          "expected_version": { "type": "integer", "minimum": 1 },
+          "explicit_confirmation": { "type": "boolean", "const": true }
+        }
+      }
+    },
     {
       "name": "besales_model_catalog_list",
       "description": "Каталог моделей для сравнения промпта (model bake-off): id, label, tier (budget/balanced/premium), bestFor-теги «когда что лучше», notes, viaOpenRouter, defaultSelected, available (доступен ли провайдер сейчас) + лимиты. По этим тегам ИИ выбирает ~5 моделей под use-case агента. Read-only.",
@@ -7882,7 +8569,7 @@
     },
     {
       "name": "besales_model_comparison_run_start",
-      "description": "Запустить прогон сравнения промпта агента на нескольких моделях (один и тот же набор диалогов, меняется только модель агента). ДОРОГО — только по явному запросу оператора, НЕ после каждого фикса. models опционально (по умолчанию ~5 defaultSelected из besales_model_catalog_list), 1..21. dialogue_count по умолчанию 5, до 20. Возвращает run_id для besales_model_comparison_get.",
+      "description": "Запустить прогон сравнения промпта агента на нескольких моделях (один и тот же набор диалогов, меняется только модель агента). ДОРОГО — только по явному запросу оператора, НЕ после каждого фикса. models опционально (по умолчанию ~5 defaultSelected из besales_model_catalog_list), 1..26. dialogue_count по умолчанию 5, до 20. Возвращает run_id для besales_model_comparison_get.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -7900,8 +8587,8 @@
               "type": "string"
             },
             "minItems": 1,
-            "maxItems": 21,
-            "description": "Runnable id моделей из каталога (1..21). По умолчанию набор defaultSelected."
+            "maxItems": 26,
+            "description": "Runnable id моделей из каталога (1..26). По умолчанию набор defaultSelected."
           },
           "dialogue_count": {
             "type": "integer",
@@ -8008,7 +8695,7 @@
     },
     {
       "name": "besales_external_api_channel_create",
-      "description": "v1.5: создать канал External API (партнёрский relay, ChannelType.EXTERNAL_API). Ответ { channelId, apiKey, webhookSecret, ingestPath } — apiKey (Bearer для входящих партнёра) и webhookSecret (HMAC-подпись наших колбэков) показываются ОДИН раз. Перевыпуск — rotate-тулы. Scope: mcp:platform-setup.",
+      "description": "v1.5: создать канал External API. Ответ { channelId, ingestPath, revealUrl, revealExpiresAt }; секреты через MCP не проходят. Человек открывает revealUrl, входит и получает ключ с webhook-подписью один раз. Scope: mcp:platform-setup.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -8043,7 +8730,7 @@
     },
     {
       "name": "besales_external_api_channel_rotate_key",
-      "description": "v1.5: перевыпустить bsl-ключ External API канала. Ответ { apiKey } — новый ключ, показывается ОДИН раз; старый ОТОЗВАН немедленно (партнёр должен обновить интеграцию). Scope: mcp:platform-setup.",
+      "description": "v1.5: выдать browser-handoff ссылку на перевыпуск bsl-ключа. До открытия ссылки прежний ключ продолжает работать; новый ключ показывается вошедшему человеку один раз. Scope: mcp:platform-setup.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -8065,7 +8752,7 @@
     },
     {
       "name": "besales_external_api_channel_rotate_secret",
-      "description": "v1.5: перевыпустить webhook-secret External API канала. Ответ { webhookSecret } — новый секрет, показывается ОДИН раз; старый инвалидирован (партнёр должен обновить проверку подписи колбэков). Scope: mcp:platform-setup.",
+      "description": "v1.5: выдать browser-handoff ссылку на замену webhook-secret. До открытия ссылки прежняя подпись действует; новая показывается вошедшему человеку один раз. Scope: mcp:platform-setup.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -8409,7 +9096,8 @@
             "type": "string",
             "enum": [
               "cohort",
-              "period"
+              "period",
+              "entry"
             ],
             "default": "period",
             "description": "period — по дате события (как вкладка по дням); cohort — по дате запуска волны."
@@ -8422,20 +9110,24 @@
                   "0-7",
                   "8-14",
                   "15-30",
-                  "31+"
+                  "31-45",
+                  "46-60",
+                  "61+"
                 ]
               },
               {
                 "type": "array",
                 "minItems": 1,
-                "maxItems": 4,
+                "maxItems": 6,
                 "items": {
                   "type": "string",
                   "enum": [
                     "0-7",
                     "8-14",
                     "15-30",
-                    "31+"
+                    "31-45",
+                    "46-60",
+                    "61+"
                   ]
                 }
               }
@@ -8752,20 +9444,24 @@
                   "0-7",
                   "8-14",
                   "15-30",
-                  "31+"
+                  "31-45",
+                  "46-60",
+                  "61+"
                 ]
               },
               {
                 "type": "array",
                 "minItems": 1,
-                "maxItems": 4,
+                "maxItems": 6,
                 "items": {
                   "type": "string",
                   "enum": [
                     "0-7",
                     "8-14",
                     "15-30",
-                    "31+"
+                    "31-45",
+                    "46-60",
+                    "61+"
                   ]
                 }
               }
@@ -8816,7 +9512,8 @@
             "type": "string",
             "enum": [
               "cohort",
-              "period"
+              "period",
+              "entry"
             ],
             "default": "period"
           },
@@ -8907,7 +9604,7 @@
     },
     {
       "name": "besales_followup_reactions",
-      "description": "Read-only аналитика дожимов: на какой шаг follow-up-цепочки контакт реально отреагировал. Метрик ТРИ — операционная (следует за длиной окна шага, шаги по ней сравнивать нельзя), сравнительная на равном горизонте (сравнивать можно только при comparableReliable=true) и runs — отклик на ПРОХОЖДЕНИЕ цепочки за run_window_days от входа, единственная, на которую не влияет частота шагов. Срезы по сегменту/продукту/мессенджеру доступны только у каналов с рассылками. Scope: read:analytics.",
+      "description": "Read-only аналитика дожимов: на какой шаг follow-up-цепочки контакт реально отреагировал. Метрик ТРИ — операционная (следует за длиной окна шага, шаги по ней сравнивать нельзя), сравнительная на равном горизонте (сравнивать можно только при comparableReliable=true) и runs — отклик на ПРОХОЖДЕНИЕ цепочки за run_window_days от входа, единственная, на которую не влияет частота шагов. Срезы по сегменту/продукту/мессенджеру доступны только у каналов с рассылками. Scope: read:analytics. ⚠️ Реакцией считается не только ответ: `horizonEngaged` — ответили ИЛИ перешли по ссылке касания в том же горизонте, разность с `horizonReplied` даёт «не ответил, но кликнул». Складывать `horizonReplied` и `linkClicked` нельзя — ответивший часто ещё и кликает.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -9493,6 +10190,14 @@
               "ADD"
             ],
             "description": "⚠️ УСТАРЕЛО и на поведение НЕ влияет (с 23.08.2026). Список channels значит «слать сюда», а судьбу КАЖДОГО канала решает сервер: мессенджер (Telegram/VK/MAX) уходит, только если школа подтвердила его наличие у контакта; SMS — только при известном телефоне; Email, WhatsApp, Viber, Сайт, Chatium уходят вслепую всем выбранным. Просят «написать ещё и на почту» — добавь Email в channels и перечисли мессенджеры явно, иначе уедет только письмо. Поле принимается ради обратной совместимости и игнорируется."
+          },
+          "quiet_days_override": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "minimum": 0,
+            "description": "ПЕРЕКРЫТИЕ тихого периода этой рассылкой, в сутках. 0 = «этот текст можно слать внутри тихого периода» — это и есть разрешение. null = рассылка не перекрывает, действует настройка площадки, затем воркспейса, затем 0. ⚠️ null и 0 — РАЗНЫЕ значения: не подставляй ноль вместо «не задано»."
           }
         }
       }
@@ -9657,6 +10362,14 @@
               "ADD"
             ],
             "description": "⚠️ УСТАРЕЛО и на поведение НЕ влияет (с 23.08.2026). Список channels значит «слать сюда», а судьбу КАЖДОГО канала решает сервер: мессенджер (Telegram/VK/MAX) уходит, только если школа подтвердила его наличие у контакта; SMS — только при известном телефоне; Email, WhatsApp, Viber, Сайт, Chatium уходят вслепую всем выбранным. Просят «написать ещё и на почту» — добавь Email в channels и перечисли мессенджеры явно, иначе уедет только письмо. Поле принимается ради обратной совместимости и игнорируется."
+          },
+          "quiet_days_override": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "minimum": 0,
+            "description": "ПЕРЕКРЫТИЕ тихого периода этой рассылкой, в сутках. 0 = «этот текст можно слать внутри тихого периода» — это и есть разрешение. null = рассылка не перекрывает, действует настройка площадки, затем воркспейса, затем 0. ⚠️ null и 0 — РАЗНЫЕ значения: не подставляй ноль вместо «не задано»."
           }
         },
         "if": {
@@ -9704,6 +10417,72 @@
         }
       }
     },
+    {
+      "name": "besales_contact_search",
+      "description": "Найти контакты по имени, email, телефону, внешнему ID или каналу / Search contacts by name, email, phone, external ID or channel. Возвращает cursor; страница не равна всему workspace.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid", "description": "Подставляется из выбранного подключения." },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 50 },
+          "cursor": { "type": "string", "minLength": 1 },
+          "search": { "type": "string", "minLength": 1 },
+          "external_id": { "type": "string", "minLength": 1, "description": "CSV provider:value, например getcourse:123." },
+          "phone": { "type": "string", "minLength": 1, "description": "Один телефон или CSV." },
+          "email": { "type": "string", "minLength": 1, "description": "Один email или CSV." },
+          "channel_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_contact_get",
+      "description": "Прочитать карточку контакта и безопасный текущий снимок / Read one contact detail and safe current snapshot. Текст недавних сообщений зависит от effective scope read:conversations.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["contact_id"],
+        "additionalProperties": false,
+        "properties": {
+          "contact_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_contact_diagnostics_get",
+      "description": "Объяснить, почему бот молчит, не передал оператору, не вызвал действие или не доставил ответ / Diagnose silence, operator handoff, actions and delivery from stored evidence. Не возвращает тексты сообщений, аргументы, результаты и raw errors; отсутствие RAG trace честно помечает unknown.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["contact_id"],
+        "additionalProperties": false,
+        "properties": {
+          "contact_id": { "type": "string", "format": "uuid" },
+          "message_id": { "type": "string", "format": "uuid", "description": "Если не задан, берётся последнее сообщение контакта." }
+        }
+      }
+    },
+    {
+      "name": "besales_contact_touch_history",
+      "description": "ИСТОРИЯ КАСАНИЙ человека школы: что мы ему отправляли и по какому праву. Сводит ТРИ источника с разными ключами: touches (журнал касаний — ПРАВО, взятое ДО отправки; строка есть и у попытки, которая никуда не ушла), sends (реестр получателей — пишется ПОСЛЕ доставки и best-effort, его отсутствие неотправки НЕ доказывает) и firstWelcomeAt (самая ранняя метка по карточкам). Складывать touches и sends нельзя — это ответы на разные вопросы. Инструмент только читает.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "getcourse_user_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Рабочее пространство. Подставляется из подключения, если не задано."
+          },
+          "getcourse_user_id": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Идентификатор человека в школе GetCourse (getcourse_user_id). Ключ — ЧЕЛОВЕК, а не карточка: история включает касания со всех площадок воркспейса."
+          }
+        }
+      }
+    },
     {
       "name": "besales_getcourse_cold_welcome_preview",
       "description": "Охват рассылки «Первое сообщение» БЕЗ отправки: totalContacts (ещё могут получить), alreadyWelcomed (уже получали — первое сообщение одноразово на контакт), foundContacts.",
@@ -9782,6 +10561,16 @@
             "format": "uuid",
             "description": "Рассылка — источник каналов по умолчанию и «Платформы по умолчанию»."
           },
+          "segment": {
+            "type": "string",
+            "maxLength": 200,
+            "description": "Метка сегмента запуска. Ею считается правило «этим сегментом человеку уже уходило»: без неё прогноз правил (policyForecast) по этому правилу структурно пуст, и ноль читается как «проверили, никого». Аудиторию метка не отбирает."
+          },
+          "message": {
+            "type": "string",
+            "maxLength": 4000,
+            "description": "Разовый текст запуска — им считается правило «тот же текст не дважды» (журнал касаний ключуется отпечатком шаблона). Для запуска с сохранённой рассылкой не нужен: текст берётся из неё тем же резолвером, что на старте."
+          },
           "channels_mode": {
             "type": "string",
             "enum": [
@@ -9795,7 +10584,7 @@
     },
     {
       "name": "besales_getcourse_cold_welcome_start",
-      "description": "Запустить рассылку «Первое сообщение» (мы пишем первыми контактам без диалога). НЕОБРАТИМО: у GetCourse нет идемпотентности, отправку нельзя отозвать. Всегда сначала preview и подтверждение пользователя. Аудитория: по дате (created_after) или по файлу (contacts). Поля сделки штампуются после отправки. Если у рассылки заданы тексты по сегментам, значение segment ВЫБИРАЕТ текст: назови пользователю выбранный текст ДО подтверждения и не запускай посегментный текст по created_after.",
+      "description": "Запустить рассылку «Первое сообщение» (мы пишем первыми тем, кому НАШЕГО исходящего ещё не было; человек, написавший школе и оставшийся без ответа, — законный адресат, исключать его не надо). НЕОБРАТИМО: у GetCourse нет идемпотентности, отправку нельзя отозвать. Всегда сначала preview и подтверждение пользователя. Аудитория: по дате (created_after) или по файлу (contacts). Поля сделки штампуются после отправки. Если у рассылки заданы тексты по сегментам, значение segment ВЫБИРАЕТ текст: назови пользователю выбранный текст ДО подтверждения и не запускай посегментный текст по created_after. Фоновый job проверяй через besales_getcourse_contact_import_status.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -9839,7 +10628,8 @@
           },
           "funnel": {
             "type": "string",
-            "maxLength": 200
+            "maxLength": 200,
+            "description": "Воронка ШКОЛЫ в форме «f11 — ДБО / NR / ВК / In Stream» — код fNN ОБЯЗАТЕЛЕН. ⚠️ Это НЕ когорта и НЕ подпись запуска: «reg-no-show», «post-web|дбо», «svs-zapusk» сюда класть нельзя — тип отбора идёт в segment, продукт в product_code, подпись запуска в cohort_label. Ось «Воронка» сравнивается по коду, поэтому значение без кода становится отдельной «воронкой» и засоряет фильтр аналитики. Файл из НЕСКОЛЬКИХ воронок — заполняй воронку построчно в contacts[].funnel."
           },
           "cohort_label": {
             "type": "string",
@@ -9877,6 +10667,12 @@
                   "type": "string",
                   "format": "date-time",
                   "description": "Точный момент входа контакта в когорту (ISO с зоной). На нём считается свежесть в «Аналитике рассылок». Заполняй, когда предсписок собран ПРАВИЛОМ и у строки есть свой момент события. Дату запуска подставлять нельзя — она схлопнула бы месяцы когорт в одну."
+                },
+                "funnel": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200,
+                  "description": "Воронка ЭТОГО контакта (например «f11 — ДБО / NR / ВК / In Stream»). Заполняй, когда файл собран из НЕСКОЛЬКИХ воронок: одна метка на запуск заставляет писать в поле воронки когорту («reg-no-show|дбо»), и фильтр по воронке перестаёт отвечать на свой вопрос. Не передан — берётся воронка запуска."
                 }
               }
             }
@@ -9977,7 +10773,8 @@
                 },
                 "funnel": {
                   "type": "string",
-                  "maxLength": 200
+                  "maxLength": 200,
+                  "description": "Воронка ШКОЛЫ в форме «f11 — ДБО / NR / ВК / In Stream» — код fNN ОБЯЗАТЕЛЕН. ⚠️ Это НЕ когорта и НЕ подпись запуска: «reg-no-show», «post-web|дбо», «svs-zapusk» сюда класть нельзя — тип отбора идёт в segment, продукт в product_code, подпись запуска в cohort_label. Ось «Воронка» сравнивается по коду, поэтому значение без кода становится отдельной «воронкой» и засоряет фильтр аналитики."
                 },
                 "cohort_label": {
                   "type": "string",
@@ -10052,13 +10849,47 @@
               "ADD"
             ],
             "description": "⚠️ УСТАРЕЛО и на поведение НЕ влияет (с 23.08.2026). Список channels значит «слать сюда», а судьбу КАЖДОГО канала решает сервер: мессенджер (Telegram/VK/MAX) уходит, только если школа подтвердила его наличие у контакта; SMS — только при известном телефоне; Email, WhatsApp, Viber, Сайт, Chatium уходят вслепую всем выбранным. Просят «написать ещё и на почту» — добавь Email в channels и перечисли мессенджеры явно, иначе уедет только письмо. Поле принимается ради обратной совместимости и игнорируется."
+          },
+          "guards": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Перекрытие предохранителей на ЭТОТ пакет — аварийный обход одной отправки. Не передано — берутся настройки площадки. Значение сохраняется в план пакета, поэтому resume после рестарта доедет с тем же решением. Постоянное ослабление делается в besales_platform_settings_update, где его видно всей команде.",
+            "properties": {
+              "active_series": {
+                "type": "string",
+                "enum": [
+                  "OFF",
+                  "WARN",
+                  "BLOCK"
+                ],
+                "description": "Не писать, пока у человека идёт вебинарная серия. По умолчанию BLOCK: до внедрения правило уже блокировало внешними скриптами, и WARN снял бы действующую защиту."
+              },
+              "active_application": {
+                "type": "string",
+                "enum": [
+                  "OFF",
+                  "WARN",
+                  "BLOCK"
+                ],
+                "description": "Не писать при действующей (не отменённой) заявке — с человеком работает менеджер. По умолчанию WARN."
+              },
+              "paid": {
+                "type": "string",
+                "enum": [
+                  "OFF",
+                  "WARN",
+                  "BLOCK"
+                ],
+                "description": "Не писать оплатившему ЭТОТ продукт. Скоуп по продукту, а не «платил хоть раз». По умолчанию WARN."
+              }
+            }
           }
         }
       }
     },
     {
       "name": "besales_getcourse_cold_welcome_batch_status",
-      "description": "Состояние пакета: агрегат state и разбивка segments[] со своим статусом, importJobId и причиной отказа у каждого. stalled=true — драйвер оборвался, остаток пакета надо запустить заново.",
+      "description": "Состояние пакета: агрегат state и разбивка segments[] со своим статусом, importJobId и причиной отказа у каждого. completedAt — момент закрытия ВСЕХ сегментов (null, пока пакет идёт). summary — план, доказанные доставки (реестр рассылок) и разбивка исходов; segmentsWithoutOutcomes>0 значит, что у стольких сегментов прогон оборвался, не записав итог, и их исходы в разбивку не вошли. stalled=true — драйвер оборвался: зови besales_getcourse_cold_welcome_batch_resume, а не запускай пакет заново. Опрашивать в цикле не нужно: о завершении и об обрыве платформа докладывает в чат уведомлений воркспейса.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -10152,7 +10983,7 @@
     },
     {
       "name": "besales_getcourse_contacts_import",
-      "description": "Импорт контактов GetCourse СПИСКОМ (без файла): заводит или обновляет их в базе платформы, чтобы по ним можно было запускать «Нашу отправку». НИЧЕГО НЕ ОТПРАВЛЯЕТ. Нужен ровно тогда, когда preview показал notInBase > 0: отправке нужен ChatUser, иначе контакт получает исход SKIPPED_NOT_IN_BASE. Матчинг существующих — по contact_id. Идёт фоном, вернётся jobId. Гейт «один активный импорт на воркспейс» общий с волнами и пакетами: 409 = идёт другой импорт, а не сбой. Максимум 5000 контактов. Scope: launch:campaigns.",
+      "description": "Импорт контактов GetCourse СПИСКОМ (без файла): заводит или обновляет их в базе платформы, чтобы по ним можно было запускать «Нашу отправку». НИЧЕГО НЕ ОТПРАВЛЯЕТ. Нужен ровно тогда, когда preview показал notInBase > 0: отправке нужен ChatUser, иначе контакт получает исход SKIPPED_NOT_IN_BASE. Матчинг существующих — по contact_id. Идёт фоном, вернётся jobId; проверяй его через besales_getcourse_contact_import_status. Гейт «один активный импорт на воркспейс» общий с волнами и пакетами: 409 = идёт другой импорт, а не сбой. Максимум 5000 контактов. Scope: launch:campaigns.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -10230,6 +11061,29 @@
         }
       }
     },
+    {
+      "name": "besales_getcourse_contact_import_status",
+      "description": "Статус фонового импорта контактов GetCourse и одиночного запуска «Первого сообщения» по jobId. Terminal states: COMPLETED, PARTIAL, FAILED; PARTIAL требует сверить successCount, failedCount и errors. Retained по правилам ImportJob. Scope: launch:campaigns.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "job_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "job_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "jobId из besales_getcourse_contacts_import или besales_getcourse_cold_welcome_start."
+          }
+        }
+      }
+    },
     {
       "name": "besales_getcourse_anchor_refresh_preview",
       "description": "Что перепишет перечитывание календарных якорей (даты эфира) — БЕЗ обращений к школе: сколько контактов в отборе, скольким откажет отсутствие пина сделки и какие значения они несут сейчас.",
@@ -10286,7 +11140,7 @@
     },
     {
       "name": "besales_getcourse_anchor_refresh_start",
-      "description": "Перечитать календарные якоря контактов из ЗАПИНЁННОЙ сделки GetCourse. Единственный способ донести ПЕРЕНЕСЁННУЮ дату эфира: автоматический добор — set-if-absent и к заполненному значению не возвращается. Прогресс цепочек НЕ откатывается.",
+      "description": "Перечитать календарные якоря контактов из ЗАПИНЁННОЙ сделки GetCourse. Единственный способ донести ПЕРЕНЕСЁННУЮ дату эфира: автоматический добор — set-if-absent и к заполненному значению не возвращается. Прогресс цепочек НЕ откатывается. Фоновый correlationId проверяй через besales_getcourse_anchor_refresh_status.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -10344,6 +11198,29 @@
         }
       }
     },
+    {
+      "name": "besales_getcourse_anchor_refresh_status",
+      "description": "Статус фонового перечитывания календарных якорей по correlationId. Terminal states: COMPLETED, FAILED, STALLED. STALLED означает потерю lock без terminal status: часть дат могла быть переписана, поэтому перед повтором нужен аудит. Retained 24 часа. Отмены нет: частичные перезаписи необратимы. Scope: read:campaigns.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "correlation_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "correlation_id": {
+            "type": "string",
+            "pattern": "^anchor-refresh:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
+            "description": "correlationId из besales_getcourse_anchor_refresh_start."
+          }
+        }
+      }
+    },
     {
       "name": "besales_broadcast_launches_list",
       "description": "История запусков рассылок одним списком: наша отправка (cold_welcome, со снимком текста и разбивкой исходов) и волны по файлу (wave).",
@@ -10365,6 +11242,11 @@
             "type": "integer",
             "minimum": 1,
             "maximum": 50
+          },
+          "schedule_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Только прогоны этого расписания. Ручные отправки и волны при этом не возвращаются вовсе: расписанием они не запускались."
           }
         }
       }
@@ -10404,7 +11286,7 @@
           },
           "cursor": {
             "type": "string",
-            "description": "nextCursor предыдущей страницы."
+            "description": "ID последнего показанного прогона (UUID из nextCursor предыдущего ответа). Курсор, а не offset."
           },
           "limit": {
             "type": "integer",
@@ -10455,11 +11337,28 @@
           },
           "category": {
             "type": "string",
-            "description": "Категория находки."
+            "enum": [
+              "HALLUCINATION",
+              "WRONG_ACTION",
+              "WRONG_ROUTING",
+              "BAD_TONE",
+              "MISSED_CONTEXT",
+              "RAG_MISS",
+              "SCRIPT_DEVIATION",
+              "PROMPT_VIOLATION",
+              "CUSTOM_RULE_CONFLICT",
+              "OTHER"
+            ],
+            "description": "Категория находки. Закрытый набор бэкенда: чужое значение отвергается с 400."
           },
           "severity": {
             "type": "string",
-            "description": "Важность находки."
+            "enum": [
+              "LOW",
+              "MEDIUM",
+              "CRITICAL"
+            ],
+            "description": "Важность находки. Значений ТРИ, «HIGH» среди них нет."
           },
           "status": {
             "type": "string",
@@ -10475,7 +11374,7 @@
     },
     {
       "name": "besales_dialogue_audit_run_start",
-      "description": "Запустить разбор сейчас. Durable: ответ приходит сразу с runId, работа идёт в очереди. Уже разобранное заново не оплачивается. 409 — на канале уже идёт прогон. Scope: mcp:platform-setup.",
+      "description": "Запустить разбор сейчас. Durable: ответ приходит сразу с runId, работа идёт в очереди; проверяй через besales_dialogue_audit_run_get. Уже разобранное заново не оплачивается. 409 — на канале уже идёт прогон. Scope: mcp:platform-setup.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -10665,7 +11564,7 @@
     },
     {
       "name": "besales_tracked_link_list",
-      "description": "Каталог коротких трекинговых ссылок workspace со сводкой «выдано → клики → ответы → заявки → оплаты». Поле placeholder — готовый токен {{link:slug}} для текстов дожимов, рассылок и шаблонов: вставляется ИМЕННО он, сырой URL мимо трекинга не считается. staticUrl — анонимный короткий адрес для мест без персональной выдачи (промпт агента, письмо школы). Ответ постраничный; hasMore=true означает, что каталог не дочитан. Scope: read:analytics. ⚠️ Токен берётся ТОЛЬКО копированием поля placeholder: собранный вручную токен с неточным слагом вырезается вместе с маркером, и клиент получает фразу без ссылки. В промпт агента токен не кладут — там staticUrl.",
+      "description": "Каталог коротких трекинговых ссылок workspace со сводкой «выдано → клики → ответы → заявки → оплаты». Поле placeholder — готовый токен {{link:slug}} для текстов дожимов, рассылок и шаблонов: вставляется ИМЕННО он, сырой URL мимо трекинга не считается. staticUrl — анонимный короткий адрес для мест без персональной выдачи (промпт агента, письмо школы). Ответ постраничный; hasMore=true означает, что каталог не дочитан. Scope: read:analytics. ⚠️ Токен берётся ТОЛЬКО копированием поля placeholder: собранный вручную токен с неточным слагом вырезается вместе с маркером, и клиент получает фразу без ссылки. В промпт агента токен не кладут — там staticUrl. ⚠️ days НЕ ЗАДАН — сводка за ВСЁ ВРЕМЯ (прежде подставлялось окно 60 дней, и оно расходилось само с собой: выданное раньше него показывалось как «выдано 0», тогда как выручка в той же строке считалась за всё время). Нужно окно — назови его явно.",
       "inputSchema": {
         "type": "object",
         "required": [],
@@ -10816,7 +11715,36 @@
     },
     {
       "name": "besales_tracked_link_breakdown",
-      "description": "Разрез одной ссылки по источникам выдачи: WAVE (волна), FOLLOWUP (дожим), CAMPAIGN (кампания), GREETING (приветствие), AGENT (обычный ответ агента) — с воронкой по каждому. Отвечает на вопрос «после чего по ссылке ходят», а не «каким сообщением она ушла». Оплата атрибутируется last-touch по ближайшему клику. Scope: read:analytics.",
+      "description": "Разрез одной ссылки по источникам выдачи: WAVE (волна), FOLLOWUP (дожим), CAMPAIGN (кампания), GREETING (приветствие), AGENT (обычный ответ агента) — с воронкой по каждому. Отвечает на вопрос «после чего по ссылке ходят», а не «каким сообщением она ушла». Оплата атрибутируется last-touch по ближайшему клику. Scope: read:analytics. ⚠️ days НЕ ЗАДАН — сводка за ВСЁ ВРЕМЯ (прежде подставлялось окно 60 дней, и оно расходилось само с собой: выданное раньше него показывалось как «выдано 0», тогда как выручка в той же строке считалась за всё время). Нужно окно — назови его явно.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "link_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Normally omit — defaults to the workspace bound to this session."
+          },
+          "link_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "UUID ссылки из каталога."
+          },
+          "days": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 366,
+            "description": "Глубина сводки в днях (по умолчанию 60)."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_tracked_link_reach",
+      "description": "Разрез одной ссылки по МЕСТУ применения: площадка и агент, через которых она уходила людям. Отвечает на «где ссылка работает», тогда как besales_tracked_link_breakdown — на «после какого касания по ней ходят». Оси независимые: одна выдача принадлежит ровно одной площадке и одному агенту. null в оси — «не определён», отдельная строка, а не ноль. Пустое имя при заполненном id значит, что площадку или агента удалили: id хранится снимком без внешнего ключа, чтобы история кликов пережила удаление. Scope: read:analytics.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -10845,7 +11773,7 @@
     },
     {
       "name": "besales_tracked_link_clicks",
-      "description": "Лента переходов по ссылке: контакт, сообщение, источник выдачи и время. Клики-предпросмотры мессенджеров отсеяны. ⚠️ Анонимные переходы по staticUrl В ЛЕНТЕ ЕСТЬ — строками с null в chatUserId/contactName/messageId/issuedAt/sourceKind (у анонимного кода человека нет по построению); не считай их людьми, их суммарное число лежит в каталоге полем anonymousClicks. ⚠️ total — число КЛИКОВ (включая повторные и анонимные), а clicked в каталоге — число ВЫДАЧ с первым живым кликом: величины разные и сходиться не обязаны. Постранично: page + page_size (максимум 200). Scope: read:analytics + read:conversations (лента несёт имя контакта и id сообщения; композитный mcp:* покрывает оба).",
+      "description": "Лента переходов по ссылке: контакт, сообщение, источник выдачи и время. Клики-предпросмотры мессенджеров отсеяны. ⚠️ Анонимные переходы по staticUrl В ЛЕНТЕ ЕСТЬ — строками с null в chatUserId/contactName/messageId/issuedAt/sourceKind (у анонимного кода человека нет по построению); не считай их людьми, их суммарное число лежит в каталоге полем anonymousClicks. ⚠️ total — число КЛИКОВ (включая повторные и анонимные), а clicked в каталоге — число ВЫДАЧ с первым живым кликом: величины разные и сходиться не обязаны. Постранично: page + page_size (максимум 200). Scope: read:analytics + read:conversations (лента несёт имя контакта и id сообщения; композитный mcp:* покрывает оба). ⚠️ days НЕ ЗАДАН — сводка за ВСЁ ВРЕМЯ (прежде подставлялось окно 60 дней, и оно расходилось само с собой: выданное раньше него показывалось как «выдано 0», тогда как выручка в той же строке считалась за всё время). Нужно окно — назови его явно.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -11006,7 +11934,7 @@
             "type": "integer",
             "minimum": 1,
             "maximum": 78,
-            "description": "Окно свежести: берём вошедших в сегмент за последние N дней"
+            "description": "Окно свежести при window_mode=ROLLING: вошедшие в сегмент за последние N дней. При FIXED не читается"
           },
           "time_local": {
             "type": "string",
@@ -11023,6 +11951,16 @@
             "maxItems": 7,
             "description": "Дни недели ISO (1 = понедельник). Пусто = каждый день"
           },
+          "days_of_month": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 31
+            },
+            "maxItems": 31,
+            "description": "Числа месяца 1–31. Пусто = не по числам месяца. Взаимоисключимо с days_of_week: вместе они означают «31-е И понедельник». Число больше длины месяца попадает на ПОСЛЕДНИЙ его день, иначе «31-е» пропускало бы февраль целиком."
+          },
           "daily_cap": {
             "type": "integer",
             "minimum": 1,
@@ -11074,6 +12012,24 @@
               "ADD"
             ],
             "description": "⚠️ УСТАРЕЛО и на поведение НЕ влияет (с 23.08.2026). Список channels значит «слать сюда», а судьбу КАЖДОГО канала решает сервер: мессенджер (Telegram/VK/MAX) уходит, только если школа подтвердила его наличие у контакта; SMS — только при известном телефоне; Email, WhatsApp, Viber, Сайт, Chatium уходят вслепую всем выбранным. Просят «написать ещё и на почту» — добавь Email в channels и перечисли мессенджеры явно, иначе уедет только письмо. Поле принимается ради обратной совместимости и игнорируется."
+          },
+          "window_mode": {
+            "type": "string",
+            "enum": [
+              "ROLLING",
+              "FIXED"
+            ],
+            "description": "ROLLING (правый край окна — «сейчас», по умолчанию) или FIXED (явная пара дат)"
+          },
+          "window_from_local": {
+            "type": "string",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "description": "Начало окна при FIXED — ЛОКАЛЬНАЯ дата площадки ГГГГ-ММ-ДД (не момент: момент сдвинул бы границу на смещение зоны)"
+          },
+          "window_to_local": {
+            "type": "string",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "description": "Конец окна при FIXED, ВКЛЮЧИТЕЛЬНО: «по 20 августа» берёт весь двадцатый день"
           }
         },
         "required": [
@@ -11158,7 +12114,7 @@
             "type": "integer",
             "minimum": 1,
             "maximum": 78,
-            "description": "Окно свежести: берём вошедших в сегмент за последние N дней"
+            "description": "Окно свежести при window_mode=ROLLING: вошедшие в сегмент за последние N дней. При FIXED не читается"
           },
           "time_local": {
             "type": "string",
@@ -11175,6 +12131,16 @@
             "maxItems": 7,
             "description": "Дни недели ISO (1 = понедельник). Пусто = каждый день"
           },
+          "days_of_month": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 31
+            },
+            "maxItems": 31,
+            "description": "Числа месяца 1–31. Пусто = не по числам месяца. Взаимоисключимо с days_of_week: вместе они означают «31-е И понедельник». Число больше длины месяца попадает на ПОСЛЕДНИЙ его день, иначе «31-е» пропускало бы февраль целиком."
+          },
           "daily_cap": {
             "type": "integer",
             "minimum": 1,
@@ -11230,6 +12196,24 @@
               "ADD"
             ],
             "description": "⚠️ УСТАРЕЛО и на поведение НЕ влияет (с 23.08.2026). Список channels значит «слать сюда», а судьбу КАЖДОГО канала решает сервер: мессенджер (Telegram/VK/MAX) уходит, только если школа подтвердила его наличие у контакта; SMS — только при известном телефоне; Email, WhatsApp, Viber, Сайт, Chatium уходят вслепую всем выбранным. Просят «написать ещё и на почту» — добавь Email в channels и перечисли мессенджеры явно, иначе уедет только письмо. Поле принимается ради обратной совместимости и игнорируется."
+          },
+          "window_mode": {
+            "type": "string",
+            "enum": [
+              "ROLLING",
+              "FIXED"
+            ],
+            "description": "ROLLING (правый край окна — «сейчас», по умолчанию) или FIXED (явная пара дат)"
+          },
+          "window_from_local": {
+            "type": "string",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "description": "Начало окна при FIXED — ЛОКАЛЬНАЯ дата площадки ГГГГ-ММ-ДД (не момент: момент сдвинул бы границу на смещение зоны)"
+          },
+          "window_to_local": {
+            "type": "string",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "description": "Конец окна при FIXED, ВКЛЮЧИТЕЛЬНО: «по 20 августа» берёт весь двадцатый день"
           }
         },
         "required": [
@@ -11299,6 +12283,36 @@
         ]
       }
     },
+    {
+      "name": "besales_broadcast_schedule_pool_snapshots",
+      "description": "Суточные снимки пула отбора по всем расписаниям воркспейса. Scope: read:campaigns. Строка на «расписание × локальный день площадки», включая дни без запуска и выключенные расписания. Три состояния РАЗНЫЕ: строки нет — не считали; status=FAILED — считали и не смогли (poolSize/selectedCount = null, причина в error); truncated — снимок упёрся в бюджет строк источника, показано начало окна, а не окно. Читается мгновенно, в отличие от besales_broadcast_schedule_preview.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "description": "UUID воркспейса. Подставляется MCP-сервером из подключения — спрашивать у пользователя не нужно."
+          },
+          "from": {
+            "type": "string",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "description": "Начало периода включительно: локальный день ПЛОЩАДКИ в формате ГГГГ-ММ-ДД. Проверяется форма; существование даты сверяет сервер."
+          },
+          "to": {
+            "type": "string",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "description": "Конец периода включительно: локальный день ПЛОЩАДКИ в формате ГГГГ-ММ-ДД."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 2000,
+            "description": "Сколько строк вернуть, считая от самого свежего дня. По умолчанию 2000. Ответ печатается целиком, поэтому у полного периода это мегабайты текста — спрашивай окно, которое читаешь."
+          }
+        },
+        "required": []
+      }
+    },
     {
       "name": "besales_broadcast_segment_rule_set",
       "description": "Задать правило отбора сегмента: фасеты поведения, якорь свежести, окно ожидания и приоритет. Scope: launch:campaigns. ⚠️⚠️ 409 означает, что сегментом уже отправляли и правило заморожено — заведи НОВЫЙ сегмент, правка задним числом сделала бы разрез отчёта несопоставимым. Секунды, а не минуты: «от 120 минут» — это activeSecondsMin=7200.",
@@ -11372,6 +12386,42 @@
                   "ANY"
                 ],
                 "description": "NOT_ANYWHERE исключает всех, кто когда-либо успешно платил (включая возврат)"
+              },
+              "prelist": {
+                "type": "string",
+                "enum": [
+                  "YES",
+                  "NO",
+                  "ANY"
+                ],
+                "description": "Предсписок: оформил заказ предсписка. Применимость и метки заказа объявляет ВОРОНКА в источнике фактов; если правило у воронки не задано или данные не готовы, строки приходят непроверяемыми и никому ничего не уйдёт"
+              },
+              "previousSegment": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "key": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 64,
+                    "description": "Имя сегмента ПРЕДЫДУЩЕГО касания"
+                  },
+                  "minDaysSince": {
+                    "type": "integer",
+                    "minimum": 30,
+                    "maximum": 78,
+                    "description": "Сколько суток должно пройти с прошлого касания (минимум 30 — граница владельца)"
+                  }
+                },
+                "required": [
+                  "key",
+                  "minDaysSince"
+                ],
+                "description": "ПОВТОРНОЕ касание: сегмент уходит тем, у кого названный сегмент был ПОСЛЕДНИМ нашим касанием и кто нам не ответил. Снимает вечный одноразовый claim приветствия — единственную защиту от второго сообщения живому человеку"
+              },
+              "untouchedOnly": {
+                "type": "boolean",
+                "description": "Право первого касания: сегмент уходит только тем, кому мы ещё НИКОГДА не писали. Молчание значит true — сегодняшнее поведение платформы. Ставьте false осознанно: это разрешает второе первое сообщение человеку, уже получившему холодное приветствие."
               }
             },
             "required": [
@@ -11385,7 +12435,8 @@
               "SERIES_END",
               "SERIES_END_PLUS_WAIT",
               "LAST_APPLICATION",
-              "REGISTRATION"
+              "REGISTRATION",
+              "PRELIST"
             ],
             "description": "Откуда берётся момент входа контакта в сегмент"
           },
@@ -11393,7 +12444,7 @@
             "type": "integer",
             "minimum": 0,
             "maximum": 720,
-            "description": "Сколько ждать после эфира до признания «не пришёл». Разумный дефолт 48"
+            "description": "Сколько ждать после эфира до признания «не пришёл». Дефолт 1 час: касание свежее, но явка к этому моменту досчитана у меньшинства (6 ч → 56 %, 24 ч → 74 %, 48 ч → 81 %), а недосчитанный контакт в отбор не попадает. При коротком ожидании ставьте freshness_days от 3: при 1 человека смотрят ровно один раз"
           },
           "priority": {
             "type": "integer",
@@ -11408,6 +12459,265 @@
           "freshness_anchor"
         ]
       }
+    },
+    {
+      "name": "besales_trigger_claim_list",
+      "description": "Read-only список одноразовых триггеров (runOncePerContact), уже сработавших на контакте. Право сжигается навсегда после первого срабатывания. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "chat_user_id"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "chat_user_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Контакт (ChatUser). Единица права — канал, а не человек."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_trigger_claim_reset",
+      "description": "Возвращает контакту право на повторное срабатывание одноразового триггера. Триггер сможет повторить необратимые действия (запись в CRM, передача оператору), поэтому требуется explicit_confirmation. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "chat_user_id",
+          "trigger_id",
+          "explicit_confirmation"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "chat_user_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Контакт (ChatUser), которому возвращается право."
+          },
+          "trigger_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Одноразовый триггер, право на который снимается."
+          },
+          "explicit_confirmation": {
+            "type": "boolean",
+            "enum": [
+              true
+            ],
+            "description": "Обязательное подтверждение оператора: триггер сможет повторить необратимые действия во внешних системах. Проверяется и на сервере."
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_inbound_analytics_get",
+      "description": "Входящая аналитика: органические диалоги, темы, скорость ответа, деньги, цикл сделки и качество данных. Не заменяется исходящей аналитикой рассылок. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["report"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "report": { "type": "string", "enum": ["summary", "topics", "speed", "money", "cycle", "quality"] },
+          "platform_id": { "type": "string", "format": "uuid" },
+          "channels": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "maxItems": 20 },
+          "mode": { "type": "string", "enum": ["all", "days", "range"], "default": "days" },
+          "days": { "type": "integer", "minimum": 1 },
+          "from": { "type": "string", "format": "date-time" },
+          "to": { "type": "string", "format": "date-time" }
+        }
+      }
+    },
+    {
+      "name": "besales_funnel_analytics_get",
+      "description": "Аналитика воронки площадки: meta принимает только platform_id/workspace_id; summary/cohorts требуют from/to; view доступен только summary, cohorts всегда считает cohort. manager_id доступен summary/cohorts. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["report", "platform_id"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "report": { "type": "string", "enum": ["meta", "summary", "cohorts"] },
+          "platform_id": { "type": "string", "format": "uuid" },
+          "from": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" },
+          "to": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" },
+          "view": { "type": "string", "enum": ["cohort", "period"] },
+          "manager_id": { "type": "integer" }
+        }
+      }
+    },
+    {
+      "name": "besales_ai_costs_get",
+      "description": "Фактические AI-затраты из immutable usage ledger: summary, tasks и breakdown. group_by/page/limit доступны только breakdown; для него group_by обязателен. unpricedEvents остаются неизвестной стоимостью, а не нулём. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["report"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "report": { "type": "string", "enum": ["summary", "tasks", "breakdown"] },
+          "mode": { "type": "string", "enum": ["all", "days", "range"], "default": "all" },
+          "days": { "type": "integer", "minimum": 1 },
+          "from": { "type": "string", "format": "date-time" },
+          "to": { "type": "string", "format": "date-time" },
+          "scope": { "type": "string", "enum": ["production", "with_tests"], "default": "production" },
+          "group_by": { "type": "string", "enum": ["customer", "platform", "tag", "operation", "provider"] },
+          "page": { "type": "integer", "minimum": 1 },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 100 }
+        }
+      }
+    },
+    {
+      "name": "besales_custom_report_list",
+      "description": "Список сохранённых кастомных аналитических таблиц воркспейса без архивных. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": { "workspace_id": { "type": "string", "format": "uuid" } }
+      }
+    },
+    {
+      "name": "besales_custom_report_get",
+      "description": "Получить определение кастомного отчёта: источник, view, фильтры, оси, метрики и updatedAt. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["report_id"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "report_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_custom_report_run",
+      "description": "Рассчитать сохранённый кастомный отчёт за период с его каноническими source/view/grain. Scope: read:analytics.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["report_id", "from", "to"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "report_id": { "type": "string", "format": "uuid" },
+          "from": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" },
+          "to": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" },
+          "granularity": { "type": "string", "enum": ["day", "week", "month", "total"] }
+        }
+      }
+    },
+    {
+      "name": "besales_workspace_operational_overview",
+      "description": "Эксплуатационная сводка: цепочки, расписания, ожидаемые и фактические запуски, durable jobs, ошибки действий и доступная очередь операторов. Scope: read:analytics; строки очереди требуют read:conversations.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_workspace_operator_list",
+      "description": "Системные workspace operators Besales для фильтра и назначения. CRM operators не входят; assignable показывает текущую пригодность. Scope: read:conversations.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": { "workspace_id": { "type": "string", "format": "uuid" } }
+      }
+    },
+    {
+      "name": "besales_workspace_operator_queue_list",
+      "description": "Пагинированная очередь операторов с каноническим status, назначением и последним доказательством PlatformWorkLog. Scope: read:conversations.",
+      "inputSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "status": { "type": "string", "enum": ["WAITING_OPERATOR", "IN_PROGRESS", "WAITING_CUSTOMER", "RESOLVED"] },
+          "workspace_operator_id": { "type": "string", "format": "uuid" },
+          "contact_id": { "type": "string", "format": "uuid" },
+          "page": { "type": "integer", "minimum": 1, "default": 1 },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }
+        }
+      }
+    },
+    {
+      "name": "besales_workspace_operator_assignment_get",
+      "description": "Текущее назначение workspace operator, operator status, CAS-версия assignedAt и workflow evidence конкретного чата. Scope: read:conversations.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["contact_id"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "contact_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_workspace_operator_assignment_set",
+      "description": "CAS-защищённо назначить, переназначить или снять workspace operator. Не меняет CRM, статус очереди и не отправляет сообщения. Требует explicit_confirmation и scope write:operators.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["contact_id", "workspace_operator_id", "expected_workspace_operator_id", "expected_assigned_operator_at", "explicit_confirmation"],
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": { "type": "string", "format": "uuid" },
+          "contact_id": { "type": "string", "format": "uuid" },
+          "workspace_operator_id": { "type": ["string", "null"], "format": "uuid" },
+          "expected_workspace_operator_id": { "type": ["string", "null"], "format": "uuid" },
+          "expected_assigned_operator_at": { "type": ["string", "null"], "format": "date-time" },
+          "explicit_confirmation": { "type": "boolean", "enum": [true] }
+        }
+      }
+    },
+    {
+      "name": "besales_help_search",
+      "description": "Найти актуальную справку Besales по обычному русскому или английскому описанию задачи. Возвращает URI и подходящие разделы; работает даже когда MCP resources не показаны модели хостом.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["query"],
+        "properties": {
+          "query": {
+            "type": "string",
+            "minLength": 2,
+            "description": "Задача своими словами, например: настроить дожимы или бот молчит"
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 10,
+            "default": 5
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "besales_help_get",
+      "description": "Прочитать индекс, один раздел или полную версию документа Besales из того же источника, что MCP resource. Сначала используй besales_help_search, если URI неизвестен.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["uri"],
+        "properties": {
+          "uri": {
+            "type": "string",
+            "pattern": "^besales://"
+          },
+          "section": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Точный или однозначный фрагмент заголовка раздела"
+          },
+          "full": {
+            "type": "boolean",
+            "default": false,
+            "description": "Вернуть документ целиком; без section/full возвращается компактный индекс"
+          }
+        },
+        "additionalProperties": false
+      }
     }
   ],
   "resources": [
@@ -11596,54 +12906,63 @@
       "name": "Workflow: Compare models (model bake-off)",
       "description": "Маршрут прогона сравнения промпта на нескольких моделях: читай besales_model_catalog_list → выбери ~5 по bestFor под use-case агента → besales_model_comparison_run_start (по умолчанию 5 диалогов) → поллируй besales_model_comparison_get → суди по метрикам + диалогам → ответь оператору с аргументами и выдержками → besales_model_comparison_eval_submit. По запросу, дорого, НЕ после каждого фикса.",
       "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://docs/tools-catalog",
+      "name": "Каталог инструментов",
+      "description": "Динамический список фактически опубликованных tools по категориям с версией и точным количеством.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://docs/trigger-actions",
+      "name": "Триггеры и действия",
+      "description": "Чтение, конфигурация, полная замена и проверка trigger actions.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://docs/variables",
+      "name": "Переменные",
+      "description": "Workspace/channel variables и полные overrides агента.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://docs/routing",
+      "name": "Маршрутизация агентов",
+      "description": "Правила routing, router state и проверка multi-agent workflow.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://docs/follow-up",
+      "name": "Follow-up и дожимы",
+      "description": "Цепочки, статистика, реакции и безопасный funnel-test.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://docs/campaigns",
+      "name": "Рассылки и кампании",
+      "description": "Mailing variants, schedules, launches и каноническая аналитика рассылок.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://docs/task-state",
+      "name": "Состояние длительной задачи",
+      "description": "Как сохранить, выбрать, безопасно продолжить, закрыть или удалить длительную задачу между MCP-сессиями.",
+      "mimeType": "text/markdown"
     }
   ],
   "summary": {
-    "total_tools": 209,
+    "total_tools": 253,
     "tools_by_category": {
-      "getcourse_wave": 10,
-      "files_upload": 3,
-      "platform_provisioning": 3,
-      "crm_provisioning": 6,
-      "data_sources": 9,
-      "workspace_overview": 1,
-      "icp_management": 3,
-      "icp_external_execution": 2,
-      "icp_read": 4,
-      "test_scenario_generation_external": 2,
-      "prompt_generation_external": 2,
-      "prompt_analysis_external": 2,
-      "prompt_finalize": 1,
-      "sandbox_run_start": 1,
-      "sandbox_findings_external": 2,
-      "simulation_findings_external": 2,
-      "qa_generation_external": 2,
-      "platform_setup_bridge": 15,
-      "feedback_sheets": 5,
-      "facts_management": 2,
-      "prompt_lint_standalone": 1,
-      "prompt_drafts": 7,
-      "workbook_ingestion": 3,
-      "knowledge_spaces": 6,
-      "knowledge_documents": 4,
-      "knowledge_qa": 7,
-      "knowledge_websites": 4,
-      "knowledge_tables": 6,
-      "variables": 5,
-      "crm_pipelines": 11,
-      "platform_clone": 3,
-      "session_workspace": 2,
-      "model_comparison": 4,
-      "dialog_script": 2,
-      "broadcast_analytics": 2,
-      "scheduled_tasks": 2,
-      "follow_up_read": 3,
-      "follow_up_funnel_test": 4,
-      "dialogue_audit": 6,
-      "link_tracking": 6,
-      "dialogue_audit_external": 2,
-      "link_tracking_domain": 2,
-      "broadcast_scheduler": 6
+      "workspace_and_help": 18,
+      "agent_configuration": 14,
+      "prompt_and_testing": 33,
+      "icp": 9,
+      "knowledge_and_content": 50,
+      "crm_and_data_sources": 27,
+      "channels_and_credentials": 14,
+      "dialogues_and_contacts": 16,
+      "automation": 5,
+      "outbound_and_analytics": 67
     },
     "external_execution_pairs": [
       "besales_icp_analysis_get_instructions / submit",
@@ -11668,6 +12987,7 @@
     ],
     "newly_added_in_p3_x_platform_setup_bridge": [
       "besales_platform_context_get",
+      "besales_trigger_action_catalog_get",
       "besales_agent_list",
       "besales_agent_variable_overrides_get",
       "besales_getcourse_departments_list",
@@ -11710,6 +13030,10 @@
     ],
     "newly_added_in_v1_5_workbook_ingestion": [
       "besales_workbook_inspect",
+      "besales_workbook_get",
+      "besales_workbook_sheet_read",
+      "besales_workbook_classification_update",
+      "besales_workbook_archive",
       "besales_workbook_extract_amocrm_leads",
       "besales_workbook_to_knowledge_document"
     ],
@@ -11731,7 +13055,8 @@
       "besales_knowledge_table_get",
       "besales_knowledge_table_patch",
       "besales_knowledge_table_delete",
-      "besales_knowledge_table_reindex"
+      "besales_knowledge_table_reindex",
+      "besales_knowledge_table_reindex_status"
     ],
     "modified_in_v1_5_increment_3": [
       "besales_agent_update",
@@ -11861,6 +13186,41 @@
       "besales_broadcast_schedule_delete",
       "besales_broadcast_schedule_runs",
       "besales_broadcast_segment_rule_set"
+    ],
+    "newly_added_in_amocrm_channel_registration": [
+      "besales_crm_amocrm_channel_registration"
+    ],
+    "newly_added_in_trigger_contact_claims": [
+      "besales_trigger_claim_list",
+      "besales_trigger_claim_reset"
+    ],
+    "newly_added_in_broadcast_pool_snapshots": [
+      "besales_broadcast_schedule_pool_snapshots"
+    ],
+    "newly_added_in_task_state": [
+      "besales_task_create",
+      "besales_task_list",
+      "besales_task_get",
+      "besales_task_update",
+      "besales_task_close",
+      "besales_task_delete"
+    ],
+    "newly_added_in_analytics": [
+      "besales_inbound_analytics_get",
+      "besales_funnel_analytics_get",
+      "besales_ai_costs_get",
+      "besales_custom_report_list",
+      "besales_custom_report_get",
+      "besales_custom_report_run"
+    ],
+    "newly_added_in_operational_overview": [
+      "besales_workspace_operational_overview"
+    ],
+    "newly_added_in_operator_workflow": [
+      "besales_workspace_operator_list",
+      "besales_workspace_operator_queue_list",
+      "besales_workspace_operator_assignment_get",
+      "besales_workspace_operator_assignment_set"
     ]
   }
 }