@besales/mcp 0.45.0 → 0.46.0

package/dist/schemas/mcp-tools.json

@@ -1325,7 +1325,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 +1610,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 +2053,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 +4504,45 @@
                   "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."
               }
             }
           },
@@ -4512,6 +4551,120 @@
           },
           "confirmation_reason": {
             "type": "string"
+          },
+          "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
+              }
+            }
           }
         }
       }
@@ -4829,7 +4982,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 +5045,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": [
@@ -7451,6 +7604,21 @@
         }
       }
     },
+    {
+      "name": "besales_crm_amocrm_channel_registration",
+      "description": "Заявка на регистрацию чат-канала AmoCRM: адрес вебхука воркспейса + текст письма в техподдержку AmoCRM. Без зарегистрированного канала бот управляет сделкой, но переписка в её карточке не появляется — channelId/channelSecretKey выдаёт только их поддержка по письму заданной формы. Текст собирает бэкенд, тот же ответ показывает страница AmoCRM в интерфейсе: пересылай дословно, адрес сам не собирай. Scope: mcp:platform-setup.",
+      "inputSchema": {
+        "type": "object",
+        "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.",
@@ -7882,7 +8050,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 +8068,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",
@@ -8409,7 +8577,8 @@
             "type": "string",
             "enum": [
               "cohort",
-              "period"
+              "period",
+              "entry"
             ],
             "default": "period",
             "description": "period — по дате события (как вкладка по дням); cohort — по дате запуска волны."
@@ -8422,20 +8591,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 +8925,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 +8993,8 @@
             "type": "string",
             "enum": [
               "cohort",
-              "period"
+              "period",
+              "entry"
             ],
             "default": "period"
           },
@@ -8907,7 +9085,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": [
@@ -9839,7 +10017,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 +10056,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 +10162,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 +10238,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": [
@@ -10365,6 +10585,11 @@
             "type": "integer",
             "minimum": 1,
             "maximum": 50
+          },
+          "schedule_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Только прогоны этого расписания. Ручные отправки и волны при этом не возвращаются вовсе: расписанием они не запускались."
           }
         }
       }
@@ -10665,7 +10890,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 +11041,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 +11099,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 +11260,7 @@
             "type": "integer",
             "minimum": 1,
             "maximum": 78,
-            "description": "Окно свежести: берём вошедших в сегмент за последние N дней"
+            "description": "Окно свежести при window_mode=ROLLING: вошедшие в сегмент за последние N дней. При FIXED не читается"
           },
           "time_local": {
             "type": "string",
@@ -11023,6 +11277,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 +11338,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 +11440,7 @@
             "type": "integer",
             "minimum": 1,
             "maximum": 78,
-            "description": "Окно свежести: берём вошедших в сегмент за последние N дней"
+            "description": "Окно свежести при window_mode=ROLLING: вошедшие в сегмент за последние N дней. При FIXED не читается"
           },
           "time_local": {
             "type": "string",
@@ -11175,6 +11457,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 +11522,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": [
@@ -11372,6 +11682,38 @@
                   "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 приветствия — единственную защиту от второго сообщения живому человеку"
               }
             },
             "required": [
@@ -11385,7 +11727,8 @@
               "SERIES_END",
               "SERIES_END_PLUS_WAIT",
               "LAST_APPLICATION",
-              "REGISTRATION"
+              "REGISTRATION",
+              "PRELIST"
             ],
             "description": "Откуда берётся момент входа контакта в сегмент"
           },
@@ -11393,7 +11736,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 +11751,56 @@
           "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": "Обязательное подтверждение оператора: триггер сможет повторить необратимые действия во внешних системах. Проверяется и на сервере."
+          }
+        }
+      }
     }
   ],
   "resources": [
@@ -11599,12 +11992,12 @@
     }
   ],
   "summary": {
-    "total_tools": 209,
+    "total_tools": 213,
     "tools_by_category": {
       "getcourse_wave": 10,
       "files_upload": 3,
       "platform_provisioning": 3,
-      "crm_provisioning": 6,
+      "crm_provisioning": 7,
       "data_sources": 9,
       "workspace_overview": 1,
       "icp_management": 3,
@@ -11643,7 +12036,8 @@
       "link_tracking": 6,
       "dialogue_audit_external": 2,
       "link_tracking_domain": 2,
-      "broadcast_scheduler": 6
+      "broadcast_scheduler": 6,
+      "trigger_contact_claims": 2
     },
     "external_execution_pairs": [
       "besales_icp_analysis_get_instructions / submit",
@@ -11861,6 +12255,13 @@
       "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"
     ]
   }
 }