@besales/mcp 0.47.0 → 0.48.0

package/dist/schemas/mcp-tools.json

@@ -3272,10 +3272,18 @@
             "format": "uuid"
           },
           "name": {
-            "type": "string"
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100,
+            "pattern": "\\S",
+            "description": "Название, уникальное в рамках агента. Пробелы по краям обрезаются; не длиннее 100 знаков — граница общая с формой интерфейса: форма отправляет название целиком при каждом сохранении, и более длинное оператор из неё уже не сохранил бы."
           },
           "condition": {
-            "type": "string"
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 4000,
+            "pattern": "\\S",
+            "description": "Условие срабатывания; уходит в системный промпт агента целиком при каждом сообщении. Пробелы по краям обрезаются; не длиннее 4000 знаков — граница общая с формой интерфейса: форма отправляет условие целиком при каждом сохранении, и более длинное оператор из неё уже не сохранил бы."
           },
           "is_enabled": {
             "type": "boolean"
@@ -3729,7 +3737,7 @@
     },
     {
       "name": "besales_followup_sequence_upsert",
-      "description": "Create or patch a follow-up sequence definition only. Runtime executions and scheduled messages are read-only; enabling requires explicit_confirmation.",
+      "description": "Create or patch a follow-up sequence definition only. Runtime executions and scheduled messages are read-only; enabling requires explicit_confirmation. The response may carry warnings[] ({code, message}) when the saved chain will select nobody — the write is already done, fix the config instead of retrying.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -3793,7 +3801,7 @@
                   "eventType",
                   "variable"
                 ],
-                "description": "БАЗОВЫЙ отбор: по статусу CRM, по типу события платформы либо variable = базового фильтра нет (отбор только по sequenceConditions). Условия по переменным ортогональны и добавляются через И: чтобы ветвить цепочки по варианту рассылки, сохранив отбор по событию, бери eventType и задай sequenceConditions, а НЕ variable. Неизвестное значение НЕ включает ни один фильтр — цепочка ушла бы всем контактам канала, поэтому бэкенд его отвергает."
+                "description": "БАЗОВЫЙ отбор: по статусу CRM, по типу события платформы либо variable = базового фильтра нет (отбор только по sequenceConditions). Условия по переменным ортогональны и добавляются через И: чтобы ветвить цепочки по варианту рассылки, сохранив отбор по событию, бери eventType и задай sequenceConditions, а НЕ variable. Неизвестное значение НЕ включает ни один фильтр — цепочка ушла бы всем контактам канала, поэтому бэкенд его отвергает. ⚠️ status (и отсутствие поля) выбирает только контакты со статусом CRM: без активной CRM или на площадке, где статуса нет ни у одного контакта (например веб-виджет), цепочка молча не выберет никого — ответ записи вернёт warnings. Там бери eventType (только контакты с уже начатым диалогом) или variable с sequenceConditions."
               },
               "sequenceConditions": {
                 "type": "array",
@@ -3875,14 +3883,14 @@
                     },
                     "dayOffset": {
                       "type": "integer",
-                      "minimum": 0,
+                      "minimum": -7,
                       "maximum": 30,
-                      "description": "Сдвиг в днях от якоря."
+                      "description": "Сдвиг в днях от якоря; отрицательный — до якоря."
                     },
                     "validityMinutes": {
                       "type": "integer",
                       "minimum": 1,
-                      "description": "Окно валидности слота. Меньше 10 минут крон почти всегда промахнётся."
+                      "description": "Окно валидности слота. Крон ходит раз в 5 минут: окно меньше 5 минут он почти всегда пропустит."
                     },
                     "slotGroup": {
                       "type": "string",
@@ -4354,6 +4362,63 @@
                   "null"
                 ]
               },
+              "instagram_comment_templates": {
+                "type": "object",
+                "description": "Готовые тексты ответов на комментарии Instagram (способ PUBLIC_AND_DM). ПОЛНАЯ ЗАМЕНА: переданный объект записывается целиком, непереданные виды и языки пропадают; пустой объект очищает. Сначала прочитай текущие тексты через besales_platform_context_get и передай всё, что должно остаться.",
+                "properties": {
+                  "dm": {
+                    "type": "object",
+                    "properties": {
+                      "ru": {
+                        "type": "string",
+                        "maxLength": 500
+                      },
+                      "uz": {
+                        "type": "string",
+                        "maxLength": 500
+                      },
+                      "uz_cyrl": {
+                        "type": "string",
+                        "maxLength": 500
+                      }
+                    }
+                  },
+                  "dm_complaint": {
+                    "type": "object",
+                    "properties": {
+                      "ru": {
+                        "type": "string",
+                        "maxLength": 500
+                      },
+                      "uz": {
+                        "type": "string",
+                        "maxLength": 500
+                      },
+                      "uz_cyrl": {
+                        "type": "string",
+                        "maxLength": 500
+                      }
+                    }
+                  },
+                  "public_complaint": {
+                    "type": "object",
+                    "properties": {
+                      "ru": {
+                        "type": "string",
+                        "maxLength": 500
+                      },
+                      "uz": {
+                        "type": "string",
+                        "maxLength": 500
+                      },
+                      "uz_cyrl": {
+                        "type": "string",
+                        "maxLength": 500
+                      }
+                    }
+                  }
+                }
+              },
               "reply_to_story_mentions": {
                 "type": "boolean"
               }
@@ -4755,7 +4820,7 @@
                 "items": {
                   "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."
+                "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. An offer is credited ONLY to contacts of the platform it is set on, not school-wide. On a WebWidget platform this is the only allowed getcourse_settings field: it holds the agent sale marker offer (e.g. «Консультация по программе (Ж)»), and any paid school order carrying it is credited to the person's widget card. Changes money attribution retroactively — dangerous, requires explicit_confirmation."
               },
               "guard_active_series": {
                 "type": [
@@ -6984,6 +7049,10 @@
           "constant_value": {
             "type": "string",
             "description": "Required when scope=CHANNEL AND is_constant=true"
+          },
+          "repeat_constant_value": {
+            "type": "string",
+            "description": "Cold mailings only: substituted instead of constant_value for a person we have already written to (e.g. intro «это снова Светлана.»). scope=CHANNEL AND is_constant=true only; no curly braces; empty string means not set"
           }
         }
       }
@@ -7078,6 +7147,13 @@
               "null"
             ],
             "description": "CHANNEL scope only; null clears"
+          },
+          "repeat_constant_value": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Cold mailings only: value for a person we have already written to. CHANNEL constants only; no curly braces; null or empty string clears (the repeat then gets constant_value)"
           }
         }
       }
@@ -8569,7 +8645,7 @@
     },
     {
       "name": "besales_model_comparison_run_start",
-      "description": "Запустить прогон сравнения промпта агента на нескольких моделях (один и тот же набор диалогов, меняется только модель агента). ДОРОГО — только по явному запросу оператора, НЕ после каждого фикса. models опционально (по умолчанию ~5 defaultSelected из besales_model_catalog_list), 1..26. dialogue_count по умолчанию 5, до 20. Возвращает run_id для besales_model_comparison_get.",
+      "description": "Запустить прогон сравнения промпта агента на нескольких моделях (один и тот же набор диалогов, меняется только модель агента). ДОРОГО — только по явному запросу оператора, НЕ после каждого фикса. models опционально (по умолчанию ~5 defaultSelected из besales_model_catalog_list), 1..32. dialogue_count по умолчанию 5, до 20. Возвращает run_id для besales_model_comparison_get.",
       "inputSchema": {
         "type": "object",
         "required": [
@@ -8587,8 +8663,8 @@
               "type": "string"
             },
             "minItems": 1,
-            "maxItems": 26,
-            "description": "Runnable id моделей из каталога (1..26). По умолчанию набор defaultSelected."
+            "maxItems": 35,
+            "description": "Runnable id моделей из каталога (1..35). По умолчанию набор defaultSelected."
           },
           "dialogue_count": {
             "type": "integer",
@@ -11223,7 +11299,7 @@
     },
     {
       "name": "besales_broadcast_launches_list",
-      "description": "История запусков рассылок одним списком: наша отправка (cold_welcome, со снимком текста и разбивкой исходов) и волны по файлу (wave).",
+      "description": "История запусков рассылок одним списком: ручная отправка (строка на задачу, пакет — одной строкой с блоками внутри), прогоны расписаний, автоприём регистраций (строка на день) и волны по файлу (wave).",
       "inputSchema": {
         "type": "object",
         "required": [],
@@ -11246,7 +11322,7 @@
           "schedule_id": {
             "type": "string",
             "format": "uuid",
-            "description": "Только прогоны этого расписания. Ручные отправки и волны при этом не возвращаются вовсе: расписанием они не запускались."
+            "description": "Только прогоны этого расписания. Ручные отправки, волны и автоприём регистраций при этом не возвращаются вовсе: расписанием они не запускались."
           }
         }
       }
@@ -11630,7 +11706,7 @@
           "target_url": {
             "type": "string",
             "maxLength": 2048,
-            "description": "Абсолютный http(s)-адрес, куда ведёт ссылка. Только http/https. В ЗНАЧЕНИЯ query-параметров можно подставлять переменные контакта: {firstName}, {lastName}, {fullName}, {username}, {email}, {phone}, {getcourseUserId}, {getcourseDealId} — например ?email={email}&param1={getcourseUserId}&autologin=1. Переменная обязана составлять ЦЕЛОЕ значение параметра; в хосте, пути, фрагменте, имени параметра или вперемешку с текстом она отвергается 400-й. Пустое у контакта значение убирает параметр из адреса целиком.",
+            "description": "Абсолютный http(s)-адрес, куда ведёт ссылка. Только http/https. В ЗНАЧЕНИЯ query-параметров можно подставлять переменные контакта: {firstName}, {lastName}, {fullName}, {username}, {email}, {phone}, {getcourseUserId}, {getcourseDealId}, а также номер шага дожима {followUpStep} (p1, p2… — вне дожима параметр выпадает) — например ?email={email}&param1={getcourseUserId}&autologin=1 или ?utm_content={followUpStep}. Переменная обязана составлять ЦЕЛОЕ значение параметра; в хосте, пути, фрагменте, имени параметра или вперемешку с текстом она отвергается 400-й. Пустое у контакта значение убирает параметр из адреса целиком.",
             "pattern": "^https?://"
           },
           "product_code": {
@@ -11669,7 +11745,7 @@
           "target_url": {
             "type": "string",
             "maxLength": 2048,
-            "description": "Абсолютный http(s)-адрес, куда ведёт ссылка. Только http/https. В ЗНАЧЕНИЯ query-параметров можно подставлять переменные контакта: {firstName}, {lastName}, {fullName}, {username}, {email}, {phone}, {getcourseUserId}, {getcourseDealId} — например ?email={email}&param1={getcourseUserId}&autologin=1. Переменная обязана составлять ЦЕЛОЕ значение параметра; в хосте, пути, фрагменте, имени параметра или вперемешку с текстом она отвергается 400-й. Пустое у контакта значение убирает параметр из адреса целиком.",
+            "description": "Абсолютный http(s)-адрес, куда ведёт ссылка. Только http/https. В ЗНАЧЕНИЯ query-параметров можно подставлять переменные контакта: {firstName}, {lastName}, {fullName}, {username}, {email}, {phone}, {getcourseUserId}, {getcourseDealId}, а также номер шага дожима {followUpStep} (p1, p2… — вне дожима параметр выпадает) — например ?email={email}&param1={getcourseUserId}&autologin=1 или ?utm_content={followUpStep}. Переменная обязана составлять ЦЕЛОЕ значение параметра; в хосте, пути, фрагменте, имени параметра или вперемешку с текстом она отвергается 400-й. Пустое у контакта значение убирает параметр из адреса целиком.",
             "pattern": "^https?://"
           },
           "product_code": {
@@ -11981,6 +12057,41 @@
             "maximum": 365,
             "description": "Не писать контакту, если он получал любую нашу рассылку за N дней"
           },
+          "handoff_from_school_platforms": {
+            "type": "boolean",
+            "description": "ПЕРЕДАЧА: забирать людей с ДРУГИХ площадок GetCourse той же школы В ДОПОЛНЕНИЕ к своим. Своим людям площадки и людям без карточек расписание пишет как обычно, а людей, чья карточка живёт на других площадках школы (и тех, кого прошлая попытка уже перевезла, но сообщение не ушло), перед отправкой переносит сюда — с перепином на заказ сегмента и остановкой цепочек прежней площадки. Поэтому флаг включают прямо на основной авторассылке сегмента, второе расписание на тот же сегмент не нужно (так с 15.09.2026; раньше флаг заменял пул, и свои люди площадки текста не получали). Площадки-источники считает сам отбор («вся школа минус своя»), поэтому новая площадка школы подхватывается без правки расписания. Включайте на площадке, КУДА переносить людей (обычно квал-площадка): на площадке серии флаг заберёт к ней людей квал-площадки. Флаг нужен на ВСЕХ пересекающихся старших сегментах площадки: претензия старшего сегмента о флаге не знает, и человек с соседней площадки иначе не получит ничего. Требует сегмента-ПРОДОЛЖЕНИЯ (снят «только нетронутым», без правила повтора): у человека с соседней площадки право первого сообщения уже сожжено. Ещё требует заполненного домена школы у площадки расписания и хотя бы одной другой площадки GetCourse в школе. Выключено — передачи нет."
+          },
+          "resend_segment_on_new_registration": {
+            "type": "boolean",
+            "description": "ПОВТОР СЕГМЕНТА ПО НОВОЙ РЕГИСТРАЦИИ (с 16.09.2026). Включено — человеку, которому этим сегментом уже писали, расписание напишет снова, только если он зарегистрировался ПОСЛЕ нашей последней отправки этого сегмента и с неё прошла пауза resend_segment_pause_days; продукт регистрации может быть любым. Выключено — сегмент человеку не повторяется никогда (причина alreadySentSegment). Действует только у сегмента-ПРОДОЛЖЕНИЯ без правила повтора: у сегмента «только нетронутым» второе сообщение держит право первого касания (alreadyGreeted). Не передано — у нового расписания включено, у существующего остаётся как было."
+          },
+          "resend_segment_pause_days": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 365,
+            "description": "Пауза повтора сегмента: сутки по 24 часа от нашей последней отправки этого сегмента человеку. Пока не прошла — причина resendPause, человек вернётся в пул сам. Не передано — у нового расписания 3, у существующего остаётся как было. ⚠️ Меньше трёх суток повтор обычно не ускорит: разговор после нашей реплики закрывается тремя сутками тишины, и до тех пор человека держит причина dialogQuiet."
+          },
+          "guard_active_series": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "enum": [
+              "OFF",
+              "WARN",
+              "BLOCK",
+              null
+            ],
+            "description": "Перекрытие предохранителя «идёт вебинарная серия» ДЛЯ ЭТОГО расписания. Не передано — у существующего остаётся как было; null — вернуть под настройку площадки. OFF — расписание пишет и во время серии человека; WARN — причина пишется в аудит, отправка идёт; BLOCK — отправка останавливается. Нужно сегментам, которые пишут внутрь серии ПО ЗАМЫСЛУ (якорь FIRST_SESSION_END_PLUS_WAIT, фасет attendedFirstSession=NO): у них серия идёт по определению. Площадочный переключатель для этого не годится — он один на ВСЕ расписания площадки и ослабил бы защиту у postweb*, prelist, closed-app и cta разом. Перекрывается только правило серии: заявка и оплата остаются площадочными."
+          },
+          "skip_after_segment_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 20,
+            "description": "НЕ ПИСАТЬ ПОСЛЕ СЕГМЕНТОВ (с 22.09.2026): id сегментов справочника (segment.id из besales_broadcast_schedule_list). Человеку, которому текст любого из них ушёл НЕ РАНЬШЕ его регистрации — той, по которой он попал в пул, — это расписание не пишет (причина skipAfterSegment); новая регистрация после того касания открывает человека снова. Сценарий: у расписания reg-no-show указать сегмент reg-no-show-day1 — получившему «пропустил первый эфир» обычное «не смогли прийти» по той же серии не уйдёт, остальным уйдёт. Не передано — у существующего остаётся как было; [] — снять правило. Сам сегмент расписания и чужие id сервер отвергает. Именно id, а не имена: имя сегмента переименовывают."
+          },
           "is_enabled": {
             "type": "boolean",
             "description": "Включено ли расписание. Создавай выключенным и включай после предпросмотра"
@@ -12161,6 +12272,41 @@
             "maximum": 365,
             "description": "Не писать контакту, если он получал любую нашу рассылку за N дней"
           },
+          "handoff_from_school_platforms": {
+            "type": "boolean",
+            "description": "ПЕРЕДАЧА: забирать людей с ДРУГИХ площадок GetCourse той же школы В ДОПОЛНЕНИЕ к своим. Своим людям площадки и людям без карточек расписание пишет как обычно, а людей, чья карточка живёт на других площадках школы (и тех, кого прошлая попытка уже перевезла, но сообщение не ушло), перед отправкой переносит сюда — с перепином на заказ сегмента и остановкой цепочек прежней площадки. Поэтому флаг включают прямо на основной авторассылке сегмента, второе расписание на тот же сегмент не нужно (так с 15.09.2026; раньше флаг заменял пул, и свои люди площадки текста не получали). Площадки-источники считает сам отбор («вся школа минус своя»), поэтому новая площадка школы подхватывается без правки расписания. Включайте на площадке, КУДА переносить людей (обычно квал-площадка): на площадке серии флаг заберёт к ней людей квал-площадки. Флаг нужен на ВСЕХ пересекающихся старших сегментах площадки: претензия старшего сегмента о флаге не знает, и человек с соседней площадки иначе не получит ничего. Требует сегмента-ПРОДОЛЖЕНИЯ (снят «только нетронутым», без правила повтора): у человека с соседней площадки право первого сообщения уже сожжено. Ещё требует заполненного домена школы у площадки расписания и хотя бы одной другой площадки GetCourse в школе. Выключено — передачи нет."
+          },
+          "resend_segment_on_new_registration": {
+            "type": "boolean",
+            "description": "ПОВТОР СЕГМЕНТА ПО НОВОЙ РЕГИСТРАЦИИ (с 16.09.2026). Включено — человеку, которому этим сегментом уже писали, расписание напишет снова, только если он зарегистрировался ПОСЛЕ нашей последней отправки этого сегмента и с неё прошла пауза resend_segment_pause_days; продукт регистрации может быть любым. Выключено — сегмент человеку не повторяется никогда (причина alreadySentSegment). Действует только у сегмента-ПРОДОЛЖЕНИЯ без правила повтора: у сегмента «только нетронутым» второе сообщение держит право первого касания (alreadyGreeted). Не передано — у нового расписания включено, у существующего остаётся как было."
+          },
+          "resend_segment_pause_days": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 365,
+            "description": "Пауза повтора сегмента: сутки по 24 часа от нашей последней отправки этого сегмента человеку. Пока не прошла — причина resendPause, человек вернётся в пул сам. Не передано — у нового расписания 3, у существующего остаётся как было. ⚠️ Меньше трёх суток повтор обычно не ускорит: разговор после нашей реплики закрывается тремя сутками тишины, и до тех пор человека держит причина dialogQuiet."
+          },
+          "guard_active_series": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "enum": [
+              "OFF",
+              "WARN",
+              "BLOCK",
+              null
+            ],
+            "description": "Перекрытие предохранителя «идёт вебинарная серия» ДЛЯ ЭТОГО расписания. Не передано — у существующего остаётся как было; null — вернуть под настройку площадки. OFF — расписание пишет и во время серии человека; WARN — причина пишется в аудит, отправка идёт; BLOCK — отправка останавливается. Нужно сегментам, которые пишут внутрь серии ПО ЗАМЫСЛУ (якорь FIRST_SESSION_END_PLUS_WAIT, фасет attendedFirstSession=NO): у них серия идёт по определению. Площадочный переключатель для этого не годится — он один на ВСЕ расписания площадки и ослабил бы защиту у postweb*, prelist, closed-app и cta разом. Перекрывается только правило серии: заявка и оплата остаются площадочными."
+          },
+          "skip_after_segment_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 20,
+            "description": "НЕ ПИСАТЬ ПОСЛЕ СЕГМЕНТОВ (с 22.09.2026): id сегментов справочника (segment.id из besales_broadcast_schedule_list). Человеку, которому текст любого из них ушёл НЕ РАНЬШЕ его регистрации — той, по которой он попал в пул, — это расписание не пишет (причина skipAfterSegment); новая регистрация после того касания открывает человека снова. Сценарий: у расписания reg-no-show указать сегмент reg-no-show-day1 — получившему «пропустил первый эфир» обычное «не смогли прийти» по той же серии не уйдёт, остальным уйдёт. Не передано — у существующего остаётся как было; [] — снять правило. Сам сегмент расписания и чужие id сервер отвергает. Именно id, а не имена: имя сегмента переименовывают."
+          },
           "is_enabled": {
             "type": "boolean",
             "description": "Включено ли расписание. Создавай выключенным и включай после предпросмотра"
@@ -12259,7 +12405,7 @@
     },
     {
       "name": "besales_broadcast_schedule_runs",
-      "description": "История прогонов расписания со счётчиками исключений. Scope: read:campaigns. ⚠️ selectedCount — сколько ОТОБРАНО, launchedCount — сколько фактически доставлено; расхождение нормально. WAITING_RESOURCE — воркспейс был занят другим импортом, период не сгорел.",
+      "description": "История прогонов расписания со счётчиками исключений. Scope: read:campaigns. ⚠️ selectedCount — сколько ОТОБРАНО, launchedCount — сколько фактически доставлено; расхождение нормально. WAITING_RESOURCE — прогон отложен (воркспейс занят импортом или пакетом, не ответил источник фактов или не прочитаны старшие сегменты — причина в error), период не сгорел.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -12284,8 +12430,8 @@
       }
     },
     {
-      "name": "besales_broadcast_schedule_pool_snapshots",
-      "description": "Суточные снимки пула отбора по всем расписаниям воркспейса. Scope: read:campaigns. Строка на «расписание × локальный день площадки», включая дни без запуска и выключенные расписания. Три состояния РАЗНЫЕ: строки нет — не считали; status=FAILED — считали и не смогли (poolSize/selectedCount = null, причина в error); truncated — снимок упёрся в бюджет строк источника, показано начало окна, а не окно. Читается мгновенно, в отличие от besales_broadcast_schedule_preview.",
+      "name": "besales_broadcast_pool_today",
+      "description": "«Пул сегодня»: сегменты с правилом на площадке — сколько сейчас в пуле и сколько уйдёт. Scope: read:campaigns. Расчёт идёт на сервере фоном, одной выкачкой источника фактов на площадку: вызов заказывает его и сразу отдаёт последний посчитанный (run); activeRun не пуст — вызови ещё раз через минуту с теми же параметрами, это опрос. Строки с расписанием считаются как его тик — параметры вызова на них не действуют; строки без расписания — по параметрам вызова (окно по умолчанию 3 суток), это верхняя граница. local_day — утренний расчёт того дня (история), без фильтров.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -12293,21 +12439,86 @@
             "type": "string",
             "description": "UUID воркспейса. Подставляется MCP-сервером из подключения — спрашивать у пользователя не нужно."
           },
-          "from": {
+          "platform_id": {
             "type": "string",
-            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "description": "Начало периода включительно: локальный день ПЛОЩАДКИ в формате ГГГГ-ММ-ДД. Проверяется форма; существование даты сверяет сервер."
+            "description": "GetCourse-площадка. Не передан — первая активная площадка с расписанием."
           },
-          "to": {
+          "window_days": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 16,
+            "description": "Окно свежести строк БЕЗ расписания, в сутках (по умолчанию 3). Потолок 16: окно регистраций строки (окно + 14 суток) обязано уложиться в общую выборку 30 суток."
+          },
+          "funnels": {
+            "description": "Коды воронок источника для строк без расписания, либо \"all\" (без фильтра)",
+            "oneOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "all"
+                ]
+              },
+              {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "maxItems": 100
+              }
+            ]
+          },
+          "product_codes": {
+            "description": "Канонические коды продуктов для строк без расписания, либо \"all\" (без фильтра)",
+            "oneOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "all"
+                ]
+              },
+              {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "maxItems": 50
+              }
+            ]
+          },
+          "channels": {
+            "type": "array",
+            "maxItems": 10,
+            "items": {
+              "type": "string",
+              "enum": [
+                "Site",
+                "Email",
+                "SMS",
+                "Telegram",
+                "Facebook",
+                "VK",
+                "Chatium",
+                "WhatsApp",
+                "Viber",
+                "MAX"
+              ]
+            },
+            "description": "Каналы для строк без расписания (GetCourseTransport). Пусто — без ограничения. Канал, который площадка не обслуживает, отвергается 400: школа отвергает набор целиком."
+          },
+          "cooldown_days": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 365,
+            "description": "Тихий период строк без расписания, в сутках; 0 — правило выключено."
+          },
+          "local_day": {
             "type": "string",
             "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-            "description": "Конец периода включительно: локальный день ПЛОЩАДКИ в формате ГГГГ-ММ-ДД."
+            "description": "Локальный день ПЛОЩАДКИ ГГГГ-ММ-ДД: вернуть утренний расчёт этого дня (история «сегмент × день»). С окном, воронками, продуктами, каналами, кулдауном и force не сочетается."
           },
-          "limit": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 2000,
-            "description": "Сколько строк вернуть, считая от самого свежего дня. По умолчанию 2000. Ответ печатается целиком, поэтому у полного периода это мегабайты текста — спрашивай окно, которое читаешь."
+          "force": {
+            "type": "boolean",
+            "description": "Посчитать в обход свежего (до 5 минут) расчёта — только после своей правки расписания, правила сегмента или запуска."
           }
         },
         "required": []
@@ -12315,7 +12526,7 @@
     },
     {
       "name": "besales_broadcast_segment_rule_set",
-      "description": "Задать правило отбора сегмента: фасеты поведения, якорь свежести, окно ожидания и приоритет. Scope: launch:campaigns. ⚠️⚠️ 409 означает, что сегментом уже отправляли и правило заморожено — заведи НОВЫЙ сегмент, правка задним числом сделала бы разрез отчёта несопоставимым. Секунды, а не минуты: «от 120 минут» — это activeSecondsMin=7200.",
+      "description": "Задать правило отбора сегмента: фасеты поведения, якорь свежести, окно ожидания и приоритет. Scope: launch:campaigns. ⚠️⚠️ 409 означает, что сегментом уже отправляли и правило заморожено — заведи НОВЫЙ сегмент, правка задним числом сделала бы разрез отчёта несопоставимым. У замороженного меняются только priority и facets.untouchedOnly (остальное правило передай тем же). Секунды, а не минуты: «от 120 минут» — это activeSecondsMin=7200.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -12340,6 +12551,15 @@
                 ],
                 "description": "Был на вебинаре. NO проходит только достоверный «не пришёл»"
               },
+              "attendedFirstSession": {
+                "type": "string",
+                "enum": [
+                  "YES",
+                  "NO",
+                  "ANY"
+                ],
+                "description": "Был на ПЕРВОМ эфире серии. NO — пропустил первый эфир, и это единственный способ написать человеку, пока его серия ИДЁТ (attended спрашивает про всю серию и до её конца равен «нечем проверить»). Требует freshness_anchor=FIRST_SESSION_END_PLUS_WAIT и guard_active_series=OFF у расписания, иначе предохранитель площадки остановит отправку."
+              },
               "activeSecondsMin": {
                 "type": "integer",
                 "minimum": 0,
@@ -12417,7 +12637,7 @@
                   "key",
                   "minDaysSince"
                 ],
-                "description": "ПОВТОРНОЕ касание: сегмент уходит тем, у кого названный сегмент был ПОСЛЕДНИМ нашим касанием и кто нам не ответил. Снимает вечный одноразовый claim приветствия — единственную защиту от второго сообщения живому человеку"
+                "description": "ПОВТОРНОЕ касание: сегмент уходит тем, у кого названный сегмент был ПОСЛЕДНИМ касанием — нашей отправкой или волной школы на этой площадке — и кто нам не ответил; нужна живая карточка человека на этой площадке. Снимает вечный одноразовый claim приветствия — единственную защиту от второго сообщения живому человеку"
               },
               "untouchedOnly": {
                 "type": "boolean",
@@ -12434,11 +12654,12 @@
             "enum": [
               "SERIES_END",
               "SERIES_END_PLUS_WAIT",
+              "FIRST_SESSION_END_PLUS_WAIT",
               "LAST_APPLICATION",
               "REGISTRATION",
               "PRELIST"
             ],
-            "description": "Откуда берётся момент входа контакта в сегмент"
+            "description": "Откуда берётся момент входа контакта в сегмент. FIRST_SESSION_END_PLUS_WAIT — конец ПЕРВОГО эфира серии плюс ожидание: для сегментов, которые пишут пропустившему первый эфир, пока серия ещё идёт"
           },
           "wait_after_series_end_hours": {
             "type": "integer",
@@ -13194,7 +13415,10 @@
       "besales_trigger_claim_list",
       "besales_trigger_claim_reset"
     ],
-    "newly_added_in_broadcast_pool_snapshots": [
+    "newly_added_in_broadcast_pool_today": [
+      "besales_broadcast_pool_today"
+    ],
+    "removed_in_broadcast_pool_today_2026_09_11": [
       "besales_broadcast_schedule_pool_snapshots"
     ],
     "newly_added_in_task_state": [

package/dist/tools/definitions/broadcast-analytics.js

@@ -506,12 +506,16 @@ export const broadcastLaunchTools = [
             };
         },
         enhanceResponse: (response) => withInstructions(response, [
-            'История запусков ТРЁХ видов. kind=cold_welcome — наша отправка (messageSnapshot = что реально ушло), kind=wave — волна по файлу (текст доставляет процесс школы).',
-            '⚠️⚠️ Третий вид РАЗЛИЧАЕТСЯ НЕ ПО kind, а по наличию scheduleRun: у прогона расписания механизм тот же cold_welcome (пишем первыми сами), различает их то, ЧТО запустило отправку. У такой строки totalContacts — это ПУЛ до исключений (а не размер когорты), sentCount — фактически доставленные, failedCount ВСЕГДА 0, outcomes ВСЕГДА null: разницу объясняет цепочка в scheduleRun (poolSize, excludedBy по причинам, selectedCount, reason).',
+            'История запусков ЧЕТЫРЁХ видов. kind=cold_welcome — наша отправка (messageSnapshot = что реально ушло), kind=wave — волна по файлу (текст доставляет процесс школы). Прогон расписания и автоприём регистраций — тоже kind=cold_welcome: их различают НЕ по kind, а по наличию scheduleRun и registrationDay.',
+            '⚠️⚠️ Прогон расписания — строка с scheduleRun: механизм тот же cold_welcome (пишем первыми сами), различает их то, ЧТО запустило отправку. У такой строки totalContacts — это ПУЛ до исключений (а не размер когорты), sentCount — фактически доставленные, failedCount ВСЕГДА 0, outcomes ВСЕГДА null: разницу объясняют scheduleRun.selection и scheduleRun.facts (и reason).',
+            '⚠️⚠️ Числа прогона называй так же, как вкладки «История» и «Пул сегодня»: в строке «взято · отправлено», а план по людям — scheduleRun.dayBreakdown: расклад сегмента на день прогона из утреннего расчёта «Пула сегодня», те же числа, что вкладка «Пул» показывает у сегмента на этот день (registrations — регистраций, вошедших в сегмент от прошлого запуска; people — разных людей среди них; excluded — людей по группам отсева, словарь как у selection.excluded; selected — уйдёт из людей дня; carriedOver — уйдёт людей с прошлых дней; посчитан до запуска, поэтому selected + carriedOver может расходиться с selection.taken; null — утро этот сегмент не посчитало, плана нет, а не ноль). Пул запуска человеку людьми дня не называй: это регистрации всего окна свежести, почти всем из которых уже писали. scheduleRun.poolSize — пул запуска: регистрации в окне свежести авторассылки, которые запуск рассмотрел (не люди: человек с несколькими регистрациями посчитан несколько раз; null — пул ещё не измерен). scheduleRun.selection — те же числа, что facts.scheduleRuns у besales_broadcast_pool_today: collapsed — несколько регистраций у одного человека (poolSize − collapsed = людей в пуле); excluded — людей по группам отсева (noMessenger — нет мессенджера (в том числе прошлая подача этим расписанием закончилась «карточку не завели» или «каналами не достать»), inContact — на связи или писали недавно (этим сегментом уже писали, идёт разговор или трое суток тишины после нашей реплики, пауза повтора сегмента, пауза после любого нашего сообщения (поле расписания «Не писать, если писали за N дней»), подача этим расписанием ушла или ещё идёт), paid — купил продукт после регистрации, по которой попал в сегмент, withManager — с ним работает менеджер (действующая заявка на продукт после этой регистрации, операторский статус или передача диалога в отдел моложе трёх суток), blocked — бан, удалённая карточка или действующий мьют, activeSeries — идёт другая вебинарная серия, retryPause — прошлая попытка отправки этим расписанием не удалась, ждём паузу, overCap — не поместились в дневной потолок, higherPriority — уйдут в сегмент с большим приоритетом, otherPlatform — карточка на другой площадке школы, и эта авторассылка её не забирает (передача выключена, там ещё идёт серия эфиров или её дата неизвестна, карточек несколько, перенос не удался или уже увёз человека отсюда; у расчётов и прогонов до 22.09.2026 этой группы нет — эти люди в other), other — прочее (предохранитель не смог проверить заявки и оплаты, карточки на этой площадке нет, повтору не нашлось прошлого касания, непригодный номер человека); у прогонов до 16.09.2026 к новым группам добавляются прежние held (купил, менеджер, бан или мьют) и pause (пауза), только ненулевые; alreadyWritten у прогонов не бывает — называй их так и не складывай с новыми); unrecorded — людей пула без записанной причины (должно быть 0); taken — взято запуском (люди журнала подач, с этого числа начинается отправка); selection=null — пул не измерен. scheduleRun.facts — отправка по людям: sent — отправлено, noMessenger — карточку не завели или ни один канал не доходит, pending — ещё отправляется, notSent — не ушло по другой причине, notSentByReason — те же notSent по причинам: один исход на человека, сумма равна notSent; ключ — исход отказа отправки (SKIPPED_BOT_SILENCED — бот выключен у контакта, SKIPPED_ALREADY_IN_DIALOG — разговор уже идёт, SKIPPED_UNRESOLVED_VARS — переменные текста без значения и соседи, те же коды, что в outcomes ручной отправки), без следа отправки — исход журнала подач (UNRESOLVED_AFTER_BATCH — причина не записана: прогоны до 16.09.2026, RELEASED_LAUNCH_FAILED — запуск сорвался); человеку называй причины словами, а не кодами; facts=null — людей прогон не брал. excludedBy и selectedCount — сырые счётчики прогона: selectedCount после подачи уже без людей, которых импорт не завёл, — «взято» по нему не называй; причины источника в excludedBy (unverifiable, lowCoverageSkipped и соседи) отсеяны ДО пула — с пулом их не складывай и человеку не показывай как отсев пула.',
+            '⚠️⚠️ Ручная отправка ПАКЕТОМ — ОДНА строка с batch: id строки = batch.batchId, batch.blocks — блоки «сегмент × продукт × воронка» в порядке исполнения (status=pending и importJobId=null — блок ещё не стартовал). totalContacts — план всего пакета, sentCount/failedCount/outcomes — суммы по блокам, tracedOutcomes у строки пакета ВСЕГДА null: поимённый разбор — у блоков, по их importJobId. Пакет из одного блока отдаётся обычной строкой задачи (batch=null). Остановить пакет — besales_getcourse_cold_welcome_batch_cancel с batch.batchId, а не отменой задачи по id строки.',
+            '⚠️ Автоприём регистраций (приветствие по вебхуку регистрации) — ОДНА строка на день с registrationDay.day (дата МСК): sentCount = totalContacts = отправлено за день (списка «взяли» у потока нет), outcomes и tracedOutcomes null, status=running значит «день ещё идёт», а не «идёт прогон». Останавливать у такой строки нечего.',
             '⚠️ scheduleRun.reason приходит и у прогона, доставившего ЧАСТЬ подачи: пакет пишет ошибку вместе с числом отправленных. status=failed у такой строки означает «дочерний пакет вернул не COMPLETED», а не «не ушло ничего».',
-            'schedule_id — только прогоны этого расписания; ручные отправки и волны при этом не возвращаются вовсе, они расписанием не запускались.',
+            'schedule_id — только прогоны этого расписания; ручные отправки, волны и автоприём регистраций при этом не возвращаются вовсе, они расписанием не запускались.',
             'status=failed у cold_welcome означает и обрыв процесса: прогон не финализировал себя. outcomes — разбивка «почему не ушло».',
             'В outcomes чинится оператором: SKIPPED_NO_ANCHOR (нет даты эфира), SKIPPED_TEXT_TOO_LONG (текст длиннее лимита после подстановки), SKIPPED_UNRESOLVED_VARS (переменные текста без значения), SKIPPED_BOT_SILENCED (бот выключен у контакта), SKIPPED_NOT_IN_BASE (контакта нет в базе — сначала импорт файла). Отметка приветствия у них не сгорала — после починки повторный запуск их доберёт.',
+            'SKIPPED_RESEND_PAUSE — оператором НЕ чинится: этим сегментом человеку уже писали, после новой регистрации расписание повторяет ему сегмент, но пауза повтора после последней отправки ещё не прошла (чаще всего сегмент успел уйти ему соседним запуском). Бывает только у прогона расписания; человек вернётся в пул сам.',
             '⚠️⚠️ sentWithoutChannelEvidence — сколько из sentCount ушло ВСЛЕПУЮ: канал взят резервным транспортом площадки, а не доказан привязками контакта или его ответом. Это ПОДМНОЖЕСТВО отправленных, а не отдельный исход: сообщение ушло, повторять его нельзя. Такие контакты с большой вероятностью получили сообщение в личный кабинет сайта, а не в мессенджер, — по outcomes они неотличимы от дошедших. null (а не 0) означает «счётчик не считался»: волна либо запуск до его появления.',
             '⚠️ SKIPPED_ANCHOR_IN_PAST — ИСКЛЮЧЕНИЕ из строки выше: дата эфира у контакта ЕСТЬ и устарела (эфир перенесли). Повторный запуск даст ровно тот же исход, сколько ни запускай: автоматический добор якоря — set-if-absent и к заполненному значению не возвращается. Лечится ТОЛЬКО явным перечитыванием якорей из запинённой сделки (POST /api/chat-users/getcourse-anchor-refresh), после которого контакт доберётся обычным запуском.',
         ]),