@besales/mcp 0.47.1 → 1.0.0-beta.2

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

@@ -1,29 +1,41 @@
+import { SCHEDULE_GUARD_HINT, SCHEDULE_BLOCKS_HINT } from './v15-port-descriptions.js';
+// Планировщик рассылок: расписания (список, сохранение, удаление, история прогонов) и правило отбора
+// сегмента. Схемы инструментов — ровно отгруженные: клиент, зовущий инструмент сегодня, не получает
+// отказа ни на одном поле, которое принимал. Тело запроса — в именах сервера v2 (канал, а не
+// «площадка»). «Запустить сейчас» и настройка источника фактов мосту не выставлены намеренно, как и у
+// отгруженного: необратимая массовая отправка и адрес источника остаются за человеком.
 import { z } from 'zod';
+import { SCHEDULE_EXCLUSION_HINT, SCHEDULE_POOL_GROUPS_HINT, SCHEDULE_CLOSE_CLASS_HINT } from './schedule-selection-hints.js';
 import { buildListQuery, compactObject, defineTool, getcourseTransportEnum, uuidSchema, withInstructions, } from './shared.js';
-/** Границы — паритет с DTO бэкенда: расхождение даёт 400 уже после подтверждения оператором. */
+/** Границы расписания — паритет с DTO бэкенда: расхождение даёт 400 уже после подтверждения человеком. */
 const DAILY_CAP_MAX = 5000;
 /**
- * ⚠️⚠️ 78, а не 365. Бэкенд выводит потолок из потолка источника фактов
- * (92 дня окна минус 14 дней добавки на созревание серии), и значение 79…365 проходило zod,
- * а падало 400 уже ПОСЛЕ того, как оператор подтвердил расписание.
+ * ⚠️⚠️ 78, а не 365. Сервер выводит потолок из потолка окна источника фактов (92 дня) минус запас
+ * окна регистраций (14 дней): значение 79…365 проходило бы схему и падало 400 уже ПОСЛЕ того, как
+ * человек подтвердил расписание.
  */
 const FRESHNESS_DAYS_MAX = 78;
 const COOLDOWN_DAYS_MAX = 365;
+/** Потолок паузы повтора сегмента — серверный `SCHEDULE_RESEND_PAUSE_DAYS_MAX`. */
+const RESEND_PAUSE_DAYS_MAX = 365;
+/** Потолок списка «не писать после сегментов» — серверный `SCHEDULE_SKIP_AFTER_SEGMENTS_MAX`. */
+const SKIP_AFTER_SEGMENTS_MAX = 20;
+/** Потолок списка каналов — отгруженный. */
+const CHANNELS_MAX = 20;
 /**
  * Окно свежести строк без расписания в «Пуле сегодня» — паритет с `POOL_TODAY_WINDOW_DAYS_MAX`
  * бэкенда: окно регистраций строки (окно + 14 суток запаса) обязано уложиться в общую выкачку
  * (30 суток). Больше сервер отвергнет 400.
  */
 const POOL_TODAY_WINDOW_DAYS_MAX = 16;
-const WAIT_HOURS_MAX = 720;
-/** Локальная дата площадки — та же форма, что у бэкенда. */
+/** Локальная дата канала — та же форма, что у бэкенда. */
 const LOCAL_DATE_RE = /^\d{4}-\d{2}-\d{2}$/u;
 /**
  * Списки фильтров — ОДНА форма у расписания и у «Пула сегодня»: `'all'` либо список кодов.
  *
- * ⚠️ Границы повторяют DTO бэкенда (`POOL_TODAY_FUNNELS_MAX`, `POOL_TODAY_PRODUCTS_MAX`,
- * `POOL_TODAY_FILTER_VALUE_MAX_LENGTH`): разойдясь, схема пропускала бы то, что сервер отвергает
- * 400-м, и модель узнавала бы о границе из ошибки.
+ * ⚠️ Границы повторяют DTO бэкенда (`SCHEDULE_FUNNELS_MAX`, `SCHEDULE_PRODUCT_CODES_MAX`,
+ * `SCHEDULE_FILTER_VALUE_MAX_LENGTH`): разойдясь, схема пропускала бы то, что сервер отвергает 400-м,
+ * и модель узнавала бы о границе из ошибки.
  */
 const FILTER_VALUE_MAX_LENGTH = 64;
 const FUNNELS_MAX = 100;
@@ -33,25 +45,42 @@ const filterListSchema = (max) => z.union([
     z.array(z.string().trim().min(1).max(FILTER_VALUE_MAX_LENGTH)).max(max),
 ]);
 const orderSchema = z.enum(['FRESH_FIRST', 'OLD_FIRST']);
+/** Потолок ожидания после эфира — серверный `SEGMENT_WAIT_AFTER_SERIES_END_HOURS_MAX`. */
+const WAIT_HOURS_MAX = 720;
+/** Границы приоритета — серверные `SEGMENT_RULE_PRIORITY_MIN/MAX`. */
+const PRIORITY_MIN = -1000;
+const PRIORITY_MAX = 1000;
+/**
+ * Суток с прошлого касания: снизу — граница владельца (повтор снимает единственную вечную защиту
+ * от второго сообщения), сверху — окно свежести расписания. Паритет серверных констант: ниже 30
+ * сервер откажет уже после подтверждения человеком.
+ */
+const REPEAT_TOUCH_MIN_DAYS = 30;
+const REPEAT_TOUCH_MAX_DAYS = 78;
+/** Потолок длины имени прошлого касания — отгруженный; сервер принимает и длиннее. */
+const PREVIOUS_SEGMENT_KEY_MAX_LENGTH = 64;
+const triStateSchema = z.enum(['YES', 'NO', 'ANY']);
+/**
+ * Откуда берётся момент входа человека в сегмент.
+ *
+ * ⚠️ Схема СТРОГАЯ: значение, объявленное на сервере и забытое здесь, отвергается ещё до запроса.
+ */
 const anchorSchema = z.enum([
     'SERIES_END',
     'SERIES_END_PLUS_WAIT',
+    // Конец ПЕРВОГО эфира серии плюс ожидание — для сегментов, которые пишут пропустившему первый
+    // эфир, пока серия идёт. Требует признака attendedFirstSession.
+    'FIRST_SESSION_END_PLUS_WAIT',
     'LAST_APPLICATION',
     'REGISTRATION',
-    // ⚠️ Схема СТРОГАЯ: значение, объявленное на сервере и забытое здесь, отвергается ещё до
-    // запроса — фича остаётся недостижимой через MCP, и выглядит это как ошибка ввода агента.
     'PRELIST',
 ]);
-/**
- * Тело расписания. `funnels`/`product_codes` принимают литерал `all` — обычный пользователь
- * говорит «шли по всем воронкам», и заставлять его перечислять их руками незачем.
- */
 /**
  * Пара «дни недели + числа месяца» запрещена.
  *
- * ⚠️ Правило продублировано в схеме намеренно: бэкенд и CHECK базы её тоже не пускают, но модель
- * узнавала бы об этом из 400-й — а описание инструмента для того и существует, чтобы правило было
- * известно ДО вызова.
+ * ⚠️ Правило продублировано в схеме намеренно: сервер и проверка таблицы её тоже не пускают, но
+ * модель узнавала бы об этом из 400-й — а описание инструмента для того и существует, чтобы правило
+ * было известно ДО вызова.
  */
 const assertSingleRepeatAxis = (input, ctx) => {
     if ((input.days_of_week?.length ?? 0) > 0 && (input.days_of_month?.length ?? 0) > 0) {
@@ -63,6 +92,11 @@ const assertSingleRepeatAxis = (input, ctx) => {
         });
     }
 };
+/**
+ * Тело расписания. `funnels`/`product_codes` принимают литерал `all` — человек говорит «шли по всем
+ * воронкам», и заставлять его перечислять их руками незачем. Имена полей входа — отгруженные
+ * (`platform_id`, `handoff_from_school_platforms`): клиент зовёт инструмент ими уже сегодня.
+ */
 const scheduleShape = {
     workspace_id: uuidSchema.optional(),
     segment_id: uuidSchema,
@@ -73,34 +107,56 @@ const scheduleShape = {
     product_codes: filterListSchema(PRODUCTS_MAX).optional(),
     freshness_days: z.number().int().min(1).max(FRESHNESS_DAYS_MAX),
     window_mode: z.enum(['ROLLING', 'FIXED']).optional(),
-    // ⚠️ ЛОКАЛЬНАЯ дата площадки, а не момент: момент сдвинул бы границу на смещение зоны.
+    // ⚠️ ЛОКАЛЬНАЯ дата канала, а не момент: момент сдвинул бы границу на смещение пояса.
     window_from_local: z.string().regex(LOCAL_DATE_RE, 'window_from_local: дата ГГГГ-ММ-ДД').optional(),
     // Конец ВКЛЮЧИТЕЛЬНО: «по 20 августа» берёт весь двадцатый день.
     window_to_local: z.string().regex(LOCAL_DATE_RE, 'window_to_local: дата ГГГГ-ММ-ДД').optional(),
     time_local: z
         .string()
-        .regex(/^([01]\d|2[0-3]):([0-5]\d)$/, 'time_local: формат HH:mm в таймзоне площадки'),
+        .regex(/^([01]\d|2[0-3]):([0-5]\d)$/, 'time_local: формат HH:mm в часовом поясе канала'),
     days_of_week: z.array(z.number().int().min(1).max(7)).max(7).optional(),
-    // ⚠️ Взаимоисключимо с `days_of_week`: вместе они означают «31-е И понедельник». Пару отвергает
-    // и бэкенд 400-й, и CHECK базы — но узнавать об этом из ошибки сервера модель не должна, поэтому
-    // запрет продублирован схемой (см. `superRefine` ниже). Число больше длины месяца попадает на
-    // ПОСЛЕДНИЙ его день.
+    // ⚠️ Взаимоисключимо с `days_of_week` (см. `assertSingleRepeatAxis`). Число больше длины месяца
+    // попадает на ПОСЛЕДНИЙ его день.
     days_of_month: z.array(z.number().int().min(1).max(31)).max(31).optional(),
     daily_cap: z.number().int().min(1).max(DAILY_CAP_MAX),
     selection_order: orderSchema,
     cooldown_days: z.number().int().min(0).max(COOLDOWN_DAYS_MAX),
-    handoff_from_school_platforms: z.boolean().optional().describe('ПЕРЕДАЧА: забирать людей с ДРУГИХ площадок GetCourse той же школы. Включённый флаг меняет смысл отбора: берутся ТОЛЬКО люди, чья карточка живёт на других площадках школы (и те, кого прошлая попытка уже перевезла, но сообщение не ушло), а перед отправкой карточка переносится сюда — с перепином на заказ сегмента и остановкой цепочек прежней площадки. Площадки-источники считает сам отбор («вся школа минус своя»), поэтому новая площадка школы подхватывается без правки расписания. Требует сегмента-ПРОДОЛЖЕНИЯ (снят «только нетронутым», без правила повтора): у человека с соседней площадки право первого сообщения уже сожжено. Ещё требует заполненного домена школы у площадки расписания и хотя бы одной другой площадки GetCourse в школе. Выключено — передачи нет.'),
+    handoff_from_school_platforms: z
+        .boolean()
+        .optional()
+        .describe('ПЕРЕДАЧА: забирать людей с ДРУГИХ каналов GetCourse той же школы В ДОПОЛНЕНИЕ к своим. Требует сегмента-ПРОДОЛЖЕНИЯ (снят «только нетронутым», без правила повтора), заполненного домена школы у канала расписания и хотя бы одного другого канала GetCourse в школе. Не передано — у существующего остаётся как было.'),
+    resend_segment_on_new_registration: z
+        .boolean()
+        .optional()
+        .describe('ПОВТОР СЕГМЕНТА ПО НОВОЙ РЕГИСТРАЦИИ. Включено — человеку, которому этим сегментом уже писали, расписание напишет снова, только если он зарегистрировался ПОСЛЕ нашей последней отправки этого сегмента и с неё прошла пауза resend_segment_pause_days. Действует у продолжения без previousSegment; продукт регистрации повтор не ограничивает. У «только нетронутым» сохраняется право первого сообщения. Не передано — у нового расписания включено, у существующего остаётся как было.'),
+    resend_segment_pause_days: z
+        .number()
+        .int()
+        .min(0)
+        .max(RESEND_PAUSE_DAYS_MAX)
+        .optional()
+        .describe('Пауза повтора сегмента: сутки по 24 часа от нашей последней отправки этого сегмента человеку. Не передано — у нового расписания 3, у существующего остаётся как было.'),
     channels: z
-        // ⚠️ Канон транспортов, а не свободная строка: иначе про допустимые значения модель узнаёт
-        // из 400-й ошибки. Ровно этот дефект уже закрыт parity-тестом контракта для соседних тулов.
+        // ⚠️ Канон транспортов, а не свободная строка: иначе про допустимые значения модель узнаёт из
+        // 400-й ошибки.
         .array(getcourseTransportEnum)
-        .max(20)
+        .max(CHANNELS_MAX)
         .optional()
-        .describe('Каналы «Первого сообщения» (GetCourseTransport). Пусто или ключ не передан — дефолт рассылки. Канал вне списка площадки отвергается: школа не сужает набор, а отвергает его ЦЕЛИКОМ.'),
+        .describe('Каналы «Первого сообщения» (GetCourseTransport), первый — канал денег. [] — каналы рассылки; не передано — у существующего остаётся как было. Канал вне способов отправки канала GetCourse отвергается: школа не сужает набор, а отвергает его ЦЕЛИКОМ.'),
     channels_mode: z
         .enum(['RESTRICT', 'ADD'])
         .optional()
-        .describe(`⚠️ УСТАРЕЛ и на поведение НЕ влияет (с 23.08.2026). Список channels значит «слать сюда», судьбу КАЖДОГО канала решает сервер: мессенджер уходит, только если школа подтвердила его наличие; SMS — только при известном телефоне; Email, WhatsApp, Viber, Сайт, Chatium — вслепую. Поле принимается ради обратной совместимости и игнорируется.`),
+        .describe('⚠️ УСТАРЕЛ и на поведение НЕ влияет. Список channels значит «слать сюда», судьбу КАЖДОГО канала решает сервер. Поле принимается ради обратной совместимости и игнорируется.'),
+    guard_active_series: z
+        .enum(['OFF', 'WARN', 'BLOCK'])
+        .nullable()
+        .optional()
+        .describe('Перекрытие предохранителя «идёт вебинарная серия» ДЛЯ ЭТОГО расписания. Не передано — у существующего остаётся как было; null — вернуть под настройку канала. Перекрывается только правило серии: заявка и оплата остаются настройкой канала.'),
+    skip_after_segment_ids: z
+        .array(uuidSchema)
+        .max(SKIP_AFTER_SEGMENTS_MAX)
+        .optional()
+        .describe('НЕ ПИСАТЬ ПОСЛЕ СЕГМЕНТОВ: идентификаторы сегментов справочника (segment.id из besales_broadcast_schedule_list). Не передано — у существующего остаётся как было; [] — снять правило. Запрет действует, если текст указанного сегмента ушёл не раньше регистрации, по которой человек попал в пул; регистрация новее касания открывает человека снова, неизвестная регистрация запрет не снимает. Сам сегмент расписания, чужие идентификаторы и сегменты со служебным именем сервер отвергает.'),
     is_enabled: z.boolean().optional(),
 };
 /** `all` — это «фильтра нет», то есть ПУСТОЙ список на стороне API. */
@@ -109,10 +165,18 @@ const toList = (value) => {
         return undefined;
     return value === 'all' ? [] : value;
 };
+/**
+ * Вход инструмента — в тело сервера v2.
+ *
+ * ⚠️ `compactObject` режет только `undefined`: поле, которого нет во входе, не уходит вовсе и у
+ * существующего расписания остаётся как было, а `null` у `guard_active_series` доезжает и снимает
+ * перекрытие — «не передал» обязано отличаться от «верни под канал».
+ */
 const toScheduleBody = (input) => compactObject({
     segmentId: input.segment_id,
     mailingVariantId: input.mailing_variant_id,
-    platformId: input.platform_id,
+    // Имя v2 — канал; отгруженное имя поля входа сохранено ради клиента.
+    channelId: input.platform_id,
     mechanism: input.mechanism,
     funnels: toList(input.funnels),
     productCodes: toList(input.product_codes),
@@ -126,20 +190,20 @@ const toScheduleBody = (input) => compactObject({
     dailyCap: input.daily_cap,
     selectionOrder: input.selection_order,
     cooldownDays: input.cooldown_days,
-    handoffFromSchoolPlatforms: input.handoff_from_school_platforms,
-    channels: input.channels,
-    // ⚠️ Режим передаётся ТОЛЬКО если его задал вызывающий: сам он на поведение не влияет, но
-    // подставлять сюда `RESTRICT` значит записать в строку расписания решение, которого никто
-    // не принимал, — а прочитано оно будет как действующая настройка.
-    channelsMode: input.channels_mode,
+    handoffFromSchoolChannels: input.handoff_from_school_platforms,
+    resendSegmentOnNewRegistration: input.resend_segment_on_new_registration,
+    resendSegmentPauseDays: input.resend_segment_pause_days,
+    transports: input.channels,
+    // ⚠️ Режим передаётся ТОЛЬКО если его задал вызывающий: сервер его принимает и игнорирует, а
+    // подставленный мостом он выглядел бы решением, которого никто не принимал.
+    transportsMode: input.channels_mode,
+    guardActiveSeries: input.guard_active_series,
+    skipAfterSegmentIds: input.skip_after_segment_ids,
     isEnabled: input.is_enabled,
 });
 /**
- * Планировщик рассылок: сегмент-правило × расписание, отбор идёт кроном.
- *
- * ⚠️⚠️ Расписание отправляет ЖИВЫМ ЛЮДЯМ без участия человека в момент отправки. Поэтому
- * создание всегда даёт выключенное расписание, а включение — отдельное действие после
- * предпросмотра.
+ * ⚠️⚠️ Расписание отправляет ЖИВЫМ ЛЮДЯМ без участия человека в момент отправки. Поэтому создание
+ * по умолчанию даёт выключенное расписание, а включение — отдельное действие после предпросмотра.
  */
 export const broadcastSchedulerTools = [
     defineTool({
@@ -153,8 +217,9 @@ export const broadcastSchedulerTools = [
             path: `/workspaces/${input.workspace_id}/broadcast-schedules`,
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'isEnabled=false означает, что расписание заведено, но крон его не берёт. Это нормальное состояние сразу после создания.',
+            'isEnabled=false означает, что расписание заведено, но проход планировщика его не берёт. Это нормальное состояние сразу после создания.',
             'Смотри на segment.priority: при пересечении сегментов побеждает больший — это и решает, какой текст получит человек, попавший под два правила.',
+            'Расписаний, убранных в архив (удалённых при существующей истории прогонов), в списке нет; их история читается besales_broadcast_schedule_runs по идентификатору.',
         ]),
     }),
     defineTool({
@@ -173,34 +238,31 @@ export const broadcastSchedulerTools = [
         ],
         defaultWorkspaceId: true,
         schema: z.object(scheduleShape).strict().superRefine(assertSingleRepeatAxis),
+        // Предпросмотр нового расписания: журнала подач у него нет. Предпросмотр правки существующего с его
+        // журналом — отдельный маршрут сервера; отгруженный инструмент его не зовёт.
         createRequest: (input) => ({
             method: 'POST',
             path: `/workspaces/${input.workspace_id}/broadcast-schedules/preview`,
             body: toScheduleBody(input),
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Ничего не отправляет и не пишет: считает ТЕМ ЖЕ путём, что и крон — тот же источник фактов, тот же компилятор правила, те же исключения.',
-            '⚠️ Показывай пользователю excludedBy числами. alreadySentSegment — этим сегментом уже слали; alreadyGreeted — человек уже получал «Первое сообщение» (одно на контакт навсегда, любым сегментом; прежнее имя ключа coldWelcomeClaimed приходит от старого бэкенда в окне выкатки); activeEpisode — человека уже ведёт автоприём регистраций (приветствие должны и не отдали, либо подготовлен повторный вход на новый эфир); touchClaimed — это касание уже занято в журнале; journal — контакт подавался этим расписанием и ждёт паузы; cooldown — получал любую нашу рассылку в окне.',
-            '⚠️⚠️ productNotInList — у расписания задан список продуктов, а у этих людей продукт другой или не указан вовсе. Прежде этот отсев шёл МОЛЧА: строка выбрасывалась без счётчика, и часть пула исчезала без причины. Чинится списком продуктов в расписании.',
-            '⚠️⚠️ notReachable — ни один из ВЫБРАННЫХ каналов до человека не доходит, и это подтвердил ответ школы. Про невыбранные каналы число не говорит ничего. Чинится составом каналов расписания или рассылки, а не правилом сегмента: вердикт записывается вместе с набором каналов и перестаёт держать паузу, как только набор изменили.',
-            '⚠️⚠️ factsUnknown — НЕ отсев: эти люди в пуле. Число значит «школу про них ещё не спрашивали», и без него ноль в notReachable читается как «все достижимы». Доставки оно НЕ обещает: тот же прогон опрашивает школу перед подачей (по 300 за раз) и часть из них тогда отсеет — в отчёте прогона эти числа уже пересчитаны.',
-            '⚠️ Если notReachable равен размеру пула, сперва проверь площадку: когда НИ ОДИН выбранный канал ею не обслуживается, недостижимы будут все до единого, и чинится это в настройках площадки, а не в расписании. Предпросмотр в этом случае показывает отдельное предупреждение, а прогон закрывается своей причиной.', '⚠️ unverifiable — «нечем проверить», а НЕ «не подходит»: нет назначения серии, серия ещё идёт, нет длительности просмотра. Эти люди в рассылку не идут, и это правильно: отсутствие данных о явке не равно отсутствию человека на эфире.',
-            '⚠️⚠️ truncatedSeriesSkipped — ЕДИНСТВЕННАЯ источниковая причина, которую чинит сам оператор: выборка упёрлась в потолок строк, и запись о явке серии могла остаться за его границей, поэтому судить о ней нечем. Чинится окном расписания за минуту — сузить свежесть, список воронок или продуктов. До 10.09.2026 это число складывалось с unverifiable и читалось как жалоба на данные школы: не путай их снова.',
-            '⚠️⚠️ claimedByHigherPriority — НЕ отсев по данным, а приоритет: человек подходит и под сегмент с БОЛЬШИМ приоритетом, у которого на этой площадке включено расписание ТОГО ЖЕ механизма, он в его окне и фильтрах, и то расписание его возьмёт — или уже отправило ему свой текст, в том числе волной школы. Исключение одно: старшее пишет только нетронутым, а этому человеку мы уже писали ДРУГИМ сегментом — тогда он остаётся младшему. Большое число — не поломка, а мера пересечения; меняется приоритетами сегментов. ⚠️ Число НЕ обещает, что человеку вообще что-то уйдёт: (1) потолок и день запуска старшего не проверяются — упрётся старшее в потолок, излишек ждёт следующего запуска, а при FRESH_FIRST самые старые из него выходят из окна ни с чем; (2) если текст старшего уже ушёл волной школы, подхватить человека может только расписание ПОВТОРА старшего сегмента, и его надо завести отдельно; (3) человек без живой карточки на этой площадке не получит ничего ни от кого — повтор старшего отсечёт его причиной repeatNoCard; (4) если у расписаний РАЗНЫЕ списки воронок, разведение неполно: воронки отсекаются на стороне источника фактов, и строк человека из чужой воронки в снимке нет вовсе — ставь пересекающимся сегментам одинаковые воронки.',
-            '⚠️⚠️ repeatNoCard — кандидат на ПОВТОР (прошлое касание годится), но живой карточки на ЭТОЙ площадке у человека нет: чаще всего волну школы записали на эту площадку, а карточка у него на соседней. Без карточки не проверить ответы и дожимы, а импорт карточку здесь не заведёт (обновит соседнюю), поэтому такие люди исключаются. Расписанием это не чинится.',
-            '⚠️⚠️ cardOnSiblingPlatform — человек живёт на СОСЕДНЕЙ площадке той же школы GetCourse, а на площадке расписания карточки у него нет. Импорт её сюда не перенесёт: он ищет человека по школе и обновляет ту карточку, что уже есть, — поэтому такие люди исключаются, а не уезжают в импорт (иначе каждый месяц они занимали бы слот дневного потолка и закрывались исходом NOT_IMPORTED). Расписанием не чинится: рассылать надо с той площадки, где человек живёт. Большое число у расписания на новой площадке — норма: люди школы живут на старой.',
-            '⚠️⚠️ noMessengerVerdict — школа УЖЕ отвечала, что привязанных мессенджеров у человека нет, и ответ ещё в силе. Карточки в базе у него нет, импорт её не заведёт, поэтому подача сожгла бы слот дневного потолка и слот импортов воркспейса и закрылась бы исходом NOT_IMPORTED на 30 суток. Срок доверия ответу задаётся у ПЛОЩАДКИ (getcourse_settings.reachability_ttl_days, по умолчанию 7 суток; 0 — спрашивать школу каждый раз); когда он истечёт, человек снова уедет в импорт и школу спросят заново. Чинится почтой, но включать её надо В ДВУХ местах: в allowlist ПЛОЩАДКИ (getcourse_settings.available_transports) и в каналах рассылки/расписания. Гейт сужает каналы по allowlist площадки, поэтому Email только в рассылке ничего не меняет — и это верно: канал вне allowlist школа не отправит никогда.',
-            '⚠️⚠️ notHandoffCandidate — расписание ПЕРЕДАЧИ (у него включён handoff_from_school_platforms) берёт только людей, чья карточка живёт на ДРУГИХ площадках той же школы и чья серия там уже закончилась (последний шаг календарной цепочки источника позади). Остальные — свои люди площадки, люди без карточек и те, у кого серия ещё идёт, — уходят в это число. У обычного расписания оно всегда ноль.',
-            '⚠️⚠️ handoffReturn — этого человека передача уже увозила С ЭТОЙ площадки, и в рамках текущего входа в сегмент он сюда не вернётся: иначе два расписания-продолжения возили бы его по кругу, а каждый переезд необратим. Новый вход спустя время запрету не подлежит. Ненулевое число означает, что у вас кольцо из двух расписаний передачи — это настройка, а не сбой данных.',
-            '⚠️⚠️ handoffBlocked — карточку не перенесли: предохранитель школы (идёт серия, действующая заявка, оплата), контактом занят человек (бан, оператор, мьют), личность занята другим процессом либо на площадке-адресате уже есть карточка с этим внешним id (последнее — навсегда). Такие люди в подачу не идут и получают исход HANDOFF_BLOCKED в журнале подач.',
-            'factsAsOf — момент, на который источник считает данные полными. Сильно устаревшее значение означает, что аналитика отстаёт и «не пришедшие» могут быть ложными.',
-            '⚠️⚠️ overlaps — контакты, которых за последнюю неделю подавали ДРУГИЕ расписания. Непустой список означает, что человек рискует получить несколько сообщений: разведи расписания кулдауном или приоритетом сегментов, прежде чем включать.',
-            'byProduct показывает, как отбор разложится по продуктам — крон нарежет подачу этими же блоками.',
+            'Ничего не отправляет и не пишет: считает ТЕМ ЖЕ отбором, что прогон, — тот же источник фактов, те же исключения, тот же предохранитель последним.',
+            SCHEDULE_EXCLUSION_HINT,
+            '⚠️ Отсев источника фактов — до пула: unverifiable — «нечем проверить» (нет назначения серии, серия идёт, нет длительности), а НЕ «не подходит»; missingIdentifiers — строки без номера ученика или заказа; lowCoverageSkipped — серии воронок с недостоверной явкой (воронки — в lowCoverageFunnels); truncatedSeriesSkipped — выборка упёрлась в потолок строк: чинится сужением окна, воронок или продуктов; productNotInList — продукт строки не из списка продуктов расписания.',
+            '⚠️⚠️ guardActiveSeries / guardPaid / guardActiveApplication / guardUnverified — зеркало предохранителя школы (идёт серия; купил после регистрации; живая заявка у менеджера; не смог проверить). Остановленные не занимают дневной потолок — его добирают следующие по очереди. guardUnchecked — НЕ отсев: столько отобранных предохранитель не проверил (cause=SOURCE_UNAVAILABLE — реестр не ответил; OUT_OF_TIME — проверка не уложилась во время запроса); их проверит сама отправка, и часть отсеется. На крупном канале предпросмотр почти всегда отвечает OUT_OF_TIME — полная картина с проверкой в besales_broadcast_pool_today.',
+            'factsUnknown — НЕ отсев: отобранные, про которых школу о мессенджерах ещё не спрашивали, — без этого числа ноль в notReachable читался бы как «все достижимы». needsImport — скольким прогон сначала заведёт карточку или адрес на канале: они уйдут не сразу. resendOpened — скольким повтор сегмента по новой регистрации открыт.',
+            '⚠️ allChannelsUnserved=true — ни один выбранный способ отправки канал GetCourse не обслуживает: недостижимы будут все, и чинится это настройкой канала, а не правилом сегмента.',
+            'factsAsOf — момент, на который источник считает данные полными; attendanceIngestAt=null — сигнала о приёме посещаемости нет. truncated=true — снимок упёрся в бюджет строк, показан не весь пул.',
+            '⚠️⚠️ overlaps — скольких из отобранных за последние 7 суток уже подавали ДРУГИЕ включённые расписания той же школы. Непустой список — риск нескольких сообщений одному человеку: разведи расписания приоритетом сегментов или тихим периодом, прежде чем включать.',
+            '⚠️⚠️ warnings — цена этой настройки, которую получит и сохранение: перескажи человеку каждое message своими словами ДО сохранения. SENIOR_FUNNELS_WIDER — у включённого расписания старшего сегмента того же канала список воронок шире: регистраций человека в его воронках этот отбор не видит, и приоритет пересечение не разведёт — человек может получить текст этого сегмента вместо старшего или оба. Предложи сделать списки funnels у этих расписаний одинаковыми.',
+            'byProduct показывает, как отбор разложится по продуктам: прогон нарежет подачу этими же блоками.',
         ]),
     }),
     defineTool({
         name: 'besales_broadcast_schedule_upsert',
         sideEffect: 'write',
+        // Без schedule_id вызов СОЗДАЁТ расписание: при неизвестном исходе повтор завёл бы второе.
+        verifyWithToolName: 'besales_broadcast_schedule_list',
         requiredFields: [
             'segment_id',
             'mailing_variant_id',
@@ -229,16 +291,21 @@ export const broadcastSchedulerTools = [
                 body: toScheduleBody(input),
             },
         enhanceResponse: (response) => withInstructions(response, [
-            '⚠️ Создавай расписание ПОСЛЕ предпросмотра и без is_enabled=true: включённое расписание начнёт слать живым людям на ближайшем тике крона (каждые 5 минут).',
-            'time_local — в таймзоне ПЛОЩАДКИ, не в UTC и не в твоей. Сутки расписания тоже считаются по ней.',
+            'Почему люди отсеялись — зови besales_broadcast_schedule_preview: в его подсказке объяснена каждая причина.',
+            '⚠️ Создавай расписание ПОСЛЕ предпросмотра и без is_enabled=true: включённое расписание начнёт слать живым людям на ближайшем проходе планировщика (каждые 5 минут).',
+            'time_local — в часовом поясе КАНАЛА, не в UTC и не в твоём. Сутки расписания тоже считаются по нему.',
             'daily_cap — потолок ОТОБРАННЫХ за прогон, а не доставленных: часть отсеется гейтами отправки уже внутри пакета. Историческую разницу смотри в besales_broadcast_schedule_runs.',
             'Пустые funnels/product_codes (или "all") означают «без фильтра», а не «ничего»: это правило пустого списка во всей платформе.',
+            'Поле, которого нет во входе, у существующего расписания остаётся как было; пустой список, false и null у guard_active_series — это значение, а не «не менять».',
+            '⚠️ Отказ сохранения — 400 с полем field (какое поле поправить) и объяснением в message: перескажи объяснение человеку своими словами и не повторяй вызов без правки названного поля.',
+            '⚠️⚠️ warnings — расписание СОХРАНЕНО, но у настройки есть цена: перескажи человеку каждое message своими словами. SENIOR_FUNNELS_WIDER — у включённого расписания старшего сегмента того же канала список воронок шире: приоритет не разведёт пересечение, человек может получить текст этого сегмента вместо старшего или оба. Предложи выровнять funnels у этих расписаний; повторять сохранение ради предупреждения не нужно.',
             'Механизм пока только cold_welcome: у волны свой контракт запуска, и планировщик не притворяется, что умеет её ставить в расписание.',
         ]),
     }),
     defineTool({
         name: 'besales_broadcast_schedule_delete',
         sideEffect: 'write',
+        verifyWithToolName: 'besales_broadcast_schedule_list',
         requiredFields: ['schedule_id', 'explicit_confirmation'],
         defaultWorkspaceId: true,
         schema: z
@@ -253,7 +320,9 @@ export const broadcastSchedulerTools = [
             path: `/workspaces/${input.workspace_id}/broadcast-schedules/${input.schedule_id}`,
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Удаление уносит и историю прогонов расписания. Журнал подач исчезнет вместе с ней — а он держит информацию «кому мы уже подавали»: после удаления те же контакты снова станут кандидатами для нового расписания с тем же сегментом.',
+            'outcome=DELETED — прогонов у расписания не было, оно удалено. outcome=ARCHIVED — прогоны были: расписание выключено и убрано из списка, история прогонов и журнал подач остались (история читается besales_broadcast_schedule_runs).',
+            '⚠️ Журнал подач читается по расписанию: новое расписание того же сегмента его не видит. От второго сообщения человека держат журнал касаний («этим сегментом уже слали») и право первого касания, а не архив.',
+            '409 — идёт прогон этого расписания: дождись его конца (besales_broadcast_schedule_runs) и повтори.',
             'Если нужно просто остановить рассылку — не удаляй, а сохрани расписание с is_enabled=false.',
         ]),
     }),
@@ -269,36 +338,42 @@ export const broadcastSchedulerTools = [
             limit: z.number().int().min(1).max(100).optional(),
         })
             .strict(),
-        // ⚠️⚠️ Параметр клеится в ПУТЬ. Транспорт (`ApiToolRequest`) знает только method/path/body,
-        // поля `query` в нём нет — оно выбрасывалось МОЛЧА, и `limit` не доезжал до бэкенда никогда:
-        // сколько бы прогонов агент ни просил, приходило серверных 30, без ошибки и без признака
-        // усечения. Тот же приём уже применён в `follow-up.ts` и `platform-setup.ts`.
+        // ⚠️⚠️ Параметр клеится в ПУТЬ: у транспорта (`ApiToolRequest`) поля `query` нет, и отдельное
+        // поле выбрасывалось бы молча — сервер отдавал бы свои 30 без признака усечения.
         createRequest: (input) => ({
             method: 'GET',
             path: `/workspaces/${input.workspace_id}/broadcast-schedules/${input.schedule_id}/runs` +
                 buildListQuery({ limit: input.limit }),
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'periodBucket — локальная ДАТА площадки: один прогон на сутки, повтор в тот же день невозможен.',
-            '⚠️ Статусы различают ПРИЧИНЫ, и чинятся они разным: DONE — пакет завершился; WAITING_RESOURCE — воркспейс был занят другим импортом, период НЕ сгорел и повторится следующим тиком; SKIPPED — правило отбора не дало кандидатов (смотри excludedBy); FAILED — упал запуск пакета; RUNNING — пакет ещё идёт.',
-            '⚠️ selectedCount — сколько ОТОБРАНО, launchedCount — сколько фактически доставлено. Расхождение нормально: часть отсеивают гейты отправки внутри пакета. Не называй selectedCount «отправлено».',
-            'attempts растёт на каждом WAITING_RESOURCE: большое число означает, что воркспейс постоянно занят и расписание стоит передвинуть по времени.',
+            'periodBucket — локальная ДАТА канала: один прогон на сутки, повтор в тот же день невозможен.',
+            '⚠️ Статусы различают ПРИЧИНЫ, и чинятся они разным: DONE — пакет завершился; WAITING_RESOURCE — прогон отложен, период НЕ сгорел, waitReason называет чем: WORKSPACE_BUSY_IMPORT — воркспейс занят импортом контактов; WORKSPACE_BUSY_BATCH — пакетом рассылки (ручным или соседнего расписания); FACTS_SOURCE_UNAVAILABLE — не ответил источник фактов; HIGHER_PRIORITY_CLAIMS_UNREADABLE — не прочитались старшие сегменты; CHANNEL_NOT_READY — канал школы не готов: подключение не читается или не отмечен ни один способ отправки (чинится настройкой канала); SEGMENT_RULE_CHANGED — правило сегмента правили, пока шёл отбор (отбор повторится по новому правилу); REPEAT_SEGMENT_PENDING — сегмент-повтор, его шаг отбора ещё не построен; ERASURE_RACE — во время отбора или записи плана стирали данные человека. Прогон повторится ближайшим проходом в тот же день и не раньше времени расписания; не дождался до конца дня — закрывается FAILED с closeReason PERIOD_ENDED_WAITING. SKIPPED и FAILED — период потрачен: closeReason называет причину (RUN_ABANDONED — исполнитель прогона оборвался, а период уже не догнать), closeReasonClass — её род (ANSWER — законный ответ «сегодня некому», FAILURE — отказ, который чинит оператор или настройка, OPERATOR — решение человека, UNKNOWN — перенесённый прогон, причина — текстом прежней системы в error). FAILED без closeReason — отбор отказал по самой настройке (расписания, сегмента или рассылки больше нет) или решение отбора прогона не читается: причина только словами в error. PENDING, RUNNING и IMPORTING — прогон ещё идёт; у IMPORTING тоже бывает waitReason (WORKSPACE_BUSY_IMPORT, WORKSPACE_BUSY_BATCH, CHANNEL_NOT_READY, ERASURE_RACE): карточки заведены, а подача ждёт — не дольше потолка фазы импорта, дальше FAILED с closeReason IMPORT_PHASE_TIMEOUT.',
+            SCHEDULE_CLOSE_CLASS_HINT,
+            SCHEDULE_GUARD_HINT,
+            SCHEDULE_BLOCKS_HINT,
+            'error — та же причина ожидания или закрытия СЛОВАМИ на языке воркспейса: человеку пересказывай её, а не ключ waitReason или closeReason.',
+            '⚠️ selectedCount — сколько ОТОБРАНО, launchedCount — сколько ПОПЫТОК отправки: доставленные плюс касания, занятые без доказательства доставки. Это не «доставлено»: не называй «доставлено» ни selectedCount, ни launchedCount. Расхождение с selectedCount нормально: часть отсеивают гейты отправки внутри пакета.',
+            SCHEDULE_EXCLUSION_HINT,
+            'attempts растёт на каждом WAITING_RESOURCE: большое число при WORKSPACE_BUSY_* означает, что воркспейс постоянно занят и расписание стоит передвинуть по времени; при FACTS_SOURCE_UNAVAILABLE чинится источник, при CHANNEL_NOT_READY — настройка канала, а не время.',
+            'trigger=RUN_NOW — прогон запущен кнопкой «Запустить сейчас»; actorType и actorId называют, кто её нажал.',
         ]),
     }),
     /**
-     * «Пул сегодня»: сегменты с правилом на площадке — сколько сейчас в пуле и сколько уйдёт.
+     * «Пул сегодня»: сегменты с правилом на канале — сколько сейчас в пуле и сколько уйдёт.
      *
-     * ⚠️⚠️ Считает СЕРВЕР фоном, одной выкачкой источника фактов на площадку: живой предпросмотр
-     * боевого расписания в таймаут MCP не укладывается (замер 09.09.2026). Вызов заказывает расчёт
-     * и сразу отдаёт последний посчитанный; повторный вызов с теми же параметрами — опрос, новый
-     * расчёт не заводится. С `local_day` — чтение утреннего расчёта того дня (история).
+     * ⚠️⚠️ Считает СЕРВЕР фоном, одной выкачкой источника фактов на канал: живой предпросмотр боевого
+     * расписания в таймаут MCP не укладывается. Вызов заказывает расчёт и сразу отдаёт последний
+     * посчитанный; повторный вызов с теми же параметрами — опрос, новый расчёт не заводится. С
+     * `local_day` — чтение утреннего расчёта того дня (история), без побочного эффекта.
      *
-     * ⚠️⚠️ Побочный эффект ЕСТЬ, и инструмент не читающий: вызов без `local_day` — это POST,
-     * который заводит расчёт (строка живёт до двух недель) и снимает прежние неначатые заказы того
-     * же ключа. Пометка «только чтение» отдала бы его хосту в профиль, где вызовы одобряются без
-     * спроса. Идемпотентность объявлена честно: повтор с теми же параметрами переиспользует живой
-     * и свежий (до 5 минут) расчёт — на этом и держится опрос; исключение — `force`, он и назван
+     * ⚠️⚠️ Побочный эффект ЕСТЬ, и инструмент не читающий: вызов без `local_day` — это POST, который
+     * заводит расчёт (строка живёт до двух недель) и снимает прежние неначатые заказы того же
+     * заказчика. Пометка «только чтение» отдала бы его хосту в профиль, где вызовы одобряются без
+     * спроса. Идемпотентность объявлена честно: повтор с теми же параметрами переиспользует живой и
+     * свежий (до 5 минут) расчёт — на этом и держится опрос; исключение — `force`, он и назван
      * «только после своей правки».
+     *
+     * Схема — отгруженная; тело и строка запроса — в именах сервера v2 (`channelId`, а не `platformId`).
      */
     defineTool({
         name: 'besales_broadcast_pool_today',
@@ -312,11 +387,14 @@ export const broadcastSchedulerTools = [
             workspace_id: uuidSchema.optional(),
             platform_id: uuidSchema
                 .optional()
-                .describe('GetCourse-площадка. Не передан — первая активная площадка с расписанием.'),
+                .describe('Канал GetCourse. Не передан — самый старый по дате создания активный канал GetCourse с расписанием, иначе самый старый активный'),
             window_days: z.number().int().min(1).max(POOL_TODAY_WINDOW_DAYS_MAX).optional(),
             funnels: filterListSchema(FUNNELS_MAX).optional(),
             product_codes: filterListSchema(PRODUCTS_MAX).optional(),
-            channels: z.array(getcourseTransportEnum).max(getcourseTransportEnum.options.length).optional(),
+            channels: z
+                .array(getcourseTransportEnum)
+                .max(getcourseTransportEnum.options.length)
+                .optional(),
             cooldown_days: z.number().int().min(0).max(COOLDOWN_DAYS_MAX).optional(),
             // ⚠️ Проверяется только ФОРМА: существование даты сверяет сервер.
             local_day: z.string().regex(LOCAL_DATE_RE, 'local_day: дата ГГГГ-ММ-ДД').optional(),
@@ -324,7 +402,7 @@ export const broadcastSchedulerTools = [
         })
             .strict()
             .superRefine((input, ctx) => {
-            // ⚠️ Утренний расчёт дня считан с настройками по умолчанию: фильтры рядом с днём сервер
+            // ⚠️ Утренний расчёт дня посчитан с настройками по умолчанию: фильтры рядом с днём сервер
             // отвергает 400-й, и узнавать об этом из ошибки модель не должна.
             const withSettings = input.window_days !== undefined ||
                 input.funnels !== undefined ||
@@ -336,7 +414,7 @@ export const broadcastSchedulerTools = [
                 ctx.addIssue({
                     code: z.ZodIssueCode.custom,
                     path: ['local_day'],
-                    message: 'local_day читает утренний расчёт дня с настройками по умолчанию — окно, воронки, продукты, каналы, кулдаун и force с ним не передаются',
+                    message: 'local_day читает утренний расчёт дня с настройками по умолчанию — окно, воронки, продукты, каналы, тихий период и force с ним не передаются',
                 });
             }
         }),
@@ -344,32 +422,41 @@ export const broadcastSchedulerTools = [
             ? {
                 method: 'GET',
                 path: `/workspaces/${input.workspace_id}/broadcast-pool` +
-                    buildListQuery({ platformId: input.platform_id, day: input.local_day }),
+                    buildListQuery({ channelId: input.platform_id, day: input.local_day }),
             }
             : {
                 method: 'POST',
                 path: `/workspaces/${input.workspace_id}/broadcast-pool/refresh`,
                 body: compactObject({
-                    platformId: input.platform_id,
+                    channelId: input.platform_id,
                     windowDays: input.window_days,
                     funnels: toList(input.funnels),
                     products: toList(input.product_codes),
-                    channels: input.channels,
+                    transports: input.channels,
                     cooldownDays: input.cooldown_days,
                     force: input.force,
                 }),
             },
         enhanceResponse: (response) => withInstructions(response, [
-            '⚠️⚠️ activeRun не пуст — идёт расчёт этих настроек: вызови инструмент ЕЩЁ РАЗ через минуту с теми же параметрами. Повторный вызов — опрос, новый расчёт он не заказывает. run — последний ПОСЧИТАННЫЙ расчёт этих настроек (run.finishedAt — когда); run=null — ещё не считали.',
-            '⚠️⚠️ Строка с расписанием (scheduleId не null) считается ТЕМ ЖЕ путём, что его тик: окно, воронки, продукты, каналы и тихий период — самого расписания; параметры вызова на неё не действуют. У выключенного расписания selectedCount значит «уйдёт, если включить». Строка без расписания считается по параметрам вызова (окно window_days, по умолчанию 3 суток; воронки, продукты, каналы, кулдаун), без рассылки и с потолком одного запуска — это верхняя граница того, что дало бы расписание.',
-            'Числа строки: poolSize — кандидаты после гейтов источника; selectedCount — отобрано на момент расчёта (не «уедет сегодня»); отсеяно = poolSize − selectedCount, причины — preview.excludedBy тем же реестром, что у besales_broadcast_schedule_preview; preview.unverifiable — «нечем проверить», отсев источника ДО пула, а не причина отбора.',
-            '⚠️ status: COMPUTED — посчитана; FAILED — не смогли (причина в error, числа null, а не 0); SKIPPED — не считается по правилу, код в skip.reason: REPEAT_NEEDS_SCHEDULE (повторному касанию нужно окно не короче skip.minDays — считается только расписанием), WINDOW_NOT_SHARED (окно регистраций шире общей выборки — только расписанием), PLATFORM_SERVES_NO_CHANNELS (площадка не обслуживает ни одного канала), DEADLINE (расчёт упёрся в потолок skip.deadlineMinutes раньше, чем дошёл до строки).',
-            '⚠️ preview.truncated=true — «не весь пул»: выборка источника не дошла до начала окна строки, самые давние регистрации не рассмотрены. Совет «сузить свежесть» здесь не годится: выборку обрезал общий расчёт площадки.',
-            'failedRun — отказ (status=FAILED, причина в error) или замена новым заказом того же заказчика (CANCELLED), случившиеся ПОСЛЕ показанного расчёта. factsSource ≠ READY — источник фактов не настроен или выключен: расчёта не будет вовсе.',
-            'force=true — только после своей правки расписания, правила сегмента или запуска: без него свежий (до 5 минут) расчёт тех же настроек переиспользуется. Опрашивая идущий расчёт, force НЕ передавай — он заказал бы ещё один расчёт следом. local_day — утренний расчёт того дня (история «сегмент × день»), всегда с настройками по умолчанию.',
-            '⚠️ Вызов с ДРУГИМИ параметрами снимает твой прежний неначатый заказ (расчёт идёт по одному на всю систему). Сравнивая площадки или окна, дождись готовности одной комбинации и только потом заказывай следующую — иначе ни одна не досчитается.',
-            'Суммы по строкам не называй «людьми»: человек в двух сегментах посчитан дважды. Поимённых списков в ответе нет — людей смотрят в интерфейсе, под правом на контакты.',
-            'Сводка выкачки у run: fetchedRows (строк источника), fetchTruncated (выборка упёрлась в бюджет — у строк она отзывается preview.truncated), registeredFrom/registeredTo (окно регистраций), trigger (MORNING — утренний расчёт истории, ON_DEMAND — заказанный), settings (настройки строк без расписания). Называй их, объясняя расхождение чисел между днями.',
+            '⚠️⚠️ activeRun не пуст — идёт расчёт этих настроек: вызови инструмент ЕЩЁ РАЗ через минуту с теми же параметрами. Повторный вызов — опрос, новый расчёт он не заказывает. run — последний ПОСЧИТАННЫЙ расчёт этих настроек (run.finishedAt — когда); run=null — ещё не считали. channelId — канал расчёта; channelId=null — у воркспейса нет активного канала GetCourse, считать нечего.',
+            '⚠️ 409 с кодом BROADCAST_POOL_WORKSPACE_ORDER_LIMIT — воркспейс уже держит два живых заказа с другими настройками (расчёт идёт по одному на всю систему): дождись готовности одного из них и повтори, НЕ перебирай параметры. factsSource ≠ READY (MISSING — источник фактов не настроен, DISABLED — выключен) — расчёта не будет вовсе. channelServesNoTransports=true — канал не обслуживает ни одного способа отправки: отправлять некуда, чинится настройкой канала.',
+            '⚠️⚠️ Строка с расписанием (scheduleId не null) считается ТЕМ ЖЕ путём, что его прогон, на момент ЗАПУСКА этой авторассылки: окно, воронки, продукты, способы отправки, тихий период, «не писать после» и перекрытие предохранителя серии — самого расписания; параметры вызова на неё не действуют. У выключенного расписания (schedule.isEnabled=false) selectedCount значит «уйдёт, если включить». Строка без расписания считается по параметрам вызова (окно window_days, по умолчанию 3 суток; воронки, продукты, способы отправки, тихий период), без рассылки и с потолком одного запуска — это верхняя граница того, что дало бы расписание. Сегмент без правила строки не получает.',
+            'Числа строки: poolSize — кандидаты после гейтов источника; selectedCount — отобрано на момент запуска авторассылки строки (у строки без расписания — на момент дня) по тому, что известно сейчас, а не «уже уехало»; отсеяно = poolSize − selectedCount, причины — preview.excludedBy тем же реестром, что у besales_broadcast_schedule_preview; unverifiable, missingIdentifiers, lowCoverageSkipped и соседи там — отсев источника ДО пула, а не причина отбора. preview.guardUnchecked не пуст — предохранитель не проверил столько отобранных: «уйдёт» в этот раз завышено.',
+            '⚠️ status: COMPUTED — посчитана; FAILED — не смогли: failure.label — причина словами (её и называй человеку), failure.code — для тебя (SCHEDULE_NOT_FOUND, SEGMENT_NOT_FOUND, MAILING_VARIANT_NOT_FOUND, CHANNEL_NOT_READY — отказ по самой настройке; RULE_MISSING, RULE_UNREADABLE, SOURCE_FAILED, ATTENDANCE_INGEST_* и соседи — отказ правила или источника фактов; HIGHER_PRIORITY_CLAIMS_UNREADABLE — не прочитались расписания старших сегментов; UNEXPECTED — непредвиденный сбой; LEGACY_REASON — причина, записанная прежней системой, её текст в label), числа null, а не 0; SKIPPED — не считается по правилу, skip.reason и skip.label: REPEAT_NEEDS_SCHEDULE (повторному касанию нужно окно не короче skip.minDays — считается только расписанием), WINDOW_NOT_SHARED (окно регистраций skip.registrationDays суток шире общей выборки skip.maxDays — только расписанием), CHANNEL_SERVES_NO_TRANSPORTS (канал не обслуживает ни одного способа отправки), DEADLINE (расчёт упёрся в потолок skip.deadlineMinutes минут раньше, чем дошёл до строки).',
+            '⚠️ preview.truncated=true — «не весь пул»: выборка источника не дошла до начала окна строки, самые давние регистрации не рассмотрены. Совет «сузить свежесть» здесь не годится: выборку обрезал общий расчёт канала.',
+            'failedRun — отказ (status=FAILED) или замена новым заказом того же заказчика (status=CANCELLED, reason.code=REPLACED_BY_NEW_ORDER), случившиеся ПОСЛЕ показанного расчёта; reason.label — причина словами (HEARTBEAT_LOST — расчёт прервался, DEADLINE — упёрся в потолок времени, FACTS_SOURCE — не ответил источник фактов).',
+            'force=true — только после своей правки расписания, правила сегмента или запуска: без него свежий (до 5 минут) расчёт тех же настроек переиспользуется (запуск дня, отобравший людей или завершившийся после расчёта, переиспользование сбрасывает сам). Опрашивая идущий расчёт, force НЕ передавай — он заказал бы ещё один расчёт следом. local_day — утренний расчёт того дня (история «сегмент × день»), всегда с настройками по умолчанию.',
+            '⚠️ Вызов с ДРУГИМИ параметрами снимает твой прежний неначатый заказ (расчёт идёт по одному на всю систему). Сравнивая каналы или окна, дождись готовности одной комбинации и только потом заказывай следующую — иначе ни одна не досчитается.',
+            'Суммы по строкам не называй «людьми»: человек в двух сегментах посчитан дважды. Поимённых списков в ответе нет — людей смотрят в интерфейсе, под правом на контакты (membersAvailable — список строки ещё хранится: только у двух последних расчётов канала и не дольше суток).',
+            '⚠️⚠️ «Сколько уйдёт сегодня» — это run.dayBreakdown, а не суммы poolSize/selectedCount: runDay (ГГГГ-ММ-ДД) — сегодня, пока хоть один запуск дня не завершился, потом — день ближайшего запуска; с local_day — сам этот день со всеми его запусками; scheduleIds — авторассылки этого дня; notComputedScheduleIds — авторассылки дня, которые не посчитались: числа дня без них неполные, так и скажи; ⚠️ план дня (registrations, people, excluded, selected, carriedOver, matured) — только по запускам, которые людей ещё не отбирали: ranScheduleIds — авторассылки дня, чей запуск уже прошёл: их итог — только facts.bySchedule, а у их сегментов run.rows[].dayBreakdown = null (списки после запуска планом не являются); с local_day непустой ranScheduleIds значит, что утренний расчёт досчитался уже после этих запусков, — так и скажи; allRan=true — все запуски дня уже прошли, плана нет: числа плана нулевые, не называй их, итог дня — facts; ranDuringComputation=true — запуск прошёл во время расчёта, числа неточны: без local_day повтори вызов с теми же параметрами (прошедший запуск сам сбрасывает переиспользование расчёта), с local_day утро не пересчитывается — оговори неточность; runTimes — время запусков дня по часам канала (прошедший — когда прогон отобрал людей, предстоящий — по правилу); ⚠️⚠️ план считается на момент ЗАПУСКА, а не расчёта: кто созреет к запуску по эфиру, который уже закончился, — уже в числах; явка эфира, который ещё идёт, не известна, и таких людей в числах нет, пока эфир не кончится; matured — registrations плюс outsideSegments (null — не посчитано), outsideSegments — созреют к запуску в окне авторассылок дня, которые их рассматривают (их воронки и продукты, не раньше их свежести, по закончившимся эфирам), но не попали в пул ни одной; outsideSegmentsBy — те же по причинам, только ненулевые ({code, label, count}: paid — купил, application — есть живая заявка, attendanceNoMinutes — был на эфире, минут не записано, paidElsewhere — покупал в другой воронке, seriesRunning — серия ещё идёт, other — прочее); одна причина на регистрацию, сумма равна outsideSegments; старые снимки могли относить paidElsewhere и seriesRunning к other; registrations — регистраций, вошедших в сегменты окнами своих авторассылок (от прошлого отбора до запуска; enteredFrom…enteredTo — общий охват этих окон); people — людей из них, КАЖДЫЙ ОДИН раз при любом числе сегментов; people = selected + сумма excluded; carriedOver — уйдут этим запуском люди с прошлых дней; unrecorded — люди без записанной причины (должно быть 0).',
+            SCHEDULE_POOL_GROUPS_HINT,
+            SCHEDULE_EXCLUSION_HINT,
+            '⚠️⚠️ После запуска экран показывает «Уйдёт» числом «Взято запусками» (facts.taken), когда все авторассылки плана (scheduleIds без ranScheduleIds и notComputedScheduleIds) уже отобрали людей и ни одна отобравшая не лежит вне плана; facts.morningPlanned — «Уйдёт» утреннего плана этого дня (selected + carriedOver утреннего расчёта; null — утреннего плана нет), разница с ним — «добавились к запуску» / «отпали к запуску»: авторассылки отбирают людей по очереди, по приоритету, и за это время у части людей кончаются паузы. Называя «Уйдёт» дня, чьи запуски прошли, называй «взято» и разницу с планом. У каждого сегмента то же в run.rows[].dayBreakdown (без matured; null — сегмент не посчитан или запуск его авторассылки уже прошёл), и его runDay может быть другим днём — у авторассылки не на каждый день; у выключенной авторассылки selected — «уйдёт, если включить», в план дня она не входит.',
+            'facts — исход запусков дня run.dayBreakdown.runDay по людям, по всем авторассылкам канала: taken — взято (люди журнала подач), sent — отправлено, noMessenger — карточку не завели или ни один канал не доходит, pending — подан в ещё идущий прогон, notSent — не ушло или доставка не подтвердилась; notSentByReason — те же notSent по причинам, список {code, label, count}: один исход на человека, сумма равна notSent; code — исход отказа отправки (SKIPPED_BOT_SILENCED — бот выключен у контакта, SKIPPED_ALREADY_IN_DIALOG — разговор уже идёт, SKIPPED_UNRESOLVED_VARS — переменные текста без значения и соседи, как в outcomes у besales_broadcast_launches_list), без следа отправки — исход журнала подач (UNRESOLVED_AFTER_BATCH — причина не записана: прогоны до 16.09.2026, RELEASED_LAUNCH_FAILED — запуск сорвался); человеку называй label, а не коды; bySchedule — то же по авторассылкам (scheduleId).',
+            'facts.scheduleRuns — запуски дня теми же числами, что строка прогона в besales_broadcast_launches_list: headline — «взято · отправлено» (poolMeasured=false — «счётчиков отбора нет», taken=null, и это НЕ ноль), selection — что увидел запуск при отборе (collapsed — несколько регистраций одного человека, excluded — люди ПУЛА по тем же группам, taken — взято, unrecorded — без записанной причины, должно быть 0; selection=null — пул не измерен), delivery — отправка прогона (null — «ещё неизвестно»: не завершён и никого не взял), planned — «Уйдёт» по утреннему плану сегмента на этот день, planDelta — «взято» минус план. Пул запуска — регистрации окна свежести, а не люди дня: суммы пулов разных авторассылок людьми дня не называй. selectedScheduleIds — авторассылки, чей прогон дня уже отобрал людей или завершился (без фильтров): есть там, но нет в run.dayBreakdown.ranScheduleIds — запуск прошёл уже после расчёта, и без local_day план устарел: повтори вызов с теми же параметрами. ⚠️ Под фильтром воронки или продукта план берёт человека с любой регистрацией в них, а факты — по регистрации, с которой ему написали: у людей с регистрациями в разных воронках план и факты расходятся. facts=null — прогонов авторассылок этого дня нет (запуска ещё не было).',
+            '⚠️⚠️ «Сколько ушло СЕГОДНЯ» — это todayFacts, а не facts: today — сегодняшний день канала (ГГГГ-ММ-ДД, по его часам), todayFacts — отправка сегодня в том же виде, что facts, какой бы день ни показывал расклад. После всех запусков дня run.dayBreakdown.runDay и facts уже про ЗАВТРА (facts=null — завтра запусков ещё не было), а сегодняшние итоги остаются в todayFacts. Отвечая, разделяй «Сегодня» (todayFacts) и план ближайшего дня (run.dayBreakdown). todayFacts=null — сегодня запусков не было; с local_day today и todayFacts всегда null — у дня истории итог только facts.',
+            'days — до 14 дней канала, свежие первыми (для local_day): дни с утренним расчётом (в 8:00 по часам канала, до запусков дня и впереди заказов в очереди; опоздавший виден по непустому ranScheduleIds) и хотя бы одним запуском, а также дни с прошедшим запуском без утреннего расчёта; у такого дня run — null, итог дня по людям — только facts, а отбор каждого запуска — facts.scheduleRuns. Человеку называй сегменты и авторассылки, а не «строки».',
+            'Сводка выкачки у run: fetchedRows (строк источника), fetchTruncated (выборка упёрлась в бюджет — у строк она отзывается preview.truncated), registeredFrom/registeredTo (окно регистраций), trigger (MORNING — утренний расчёт истории, ON_DEMAND — заказанный), settings (настройки строк без расписания). options — варианты фильтров (воронки и продукты, встреченные в выкачке). Называй их, объясняя расхождение чисел между днями.',
         ]),
     }),
     defineTool({
@@ -383,50 +470,50 @@ export const broadcastSchedulerTools = [
             segment_id: uuidSchema,
             facets: z
                 .object({
-                attended: z.enum(['YES', 'NO', 'ANY']).optional(),
+                attended: triStateSchema.optional(),
+                /**
+                 * Был на ПЕРВОМ эфире серии. `NO` — пропустил первый эфир; вопрос отвечается, пока серия
+                 * ещё идёт, поэтому с `attended` они не взаимозаменяемы.
+                 */
+                attendedFirstSession: triStateSchema.optional(),
                 activeSecondsMin: z.number().int().min(0).optional(),
                 activeSecondsMax: z.number().int().min(0).optional(),
                 webinarDayMin: z.number().int().min(0).optional(),
                 webinarDayMax: z.number().int().min(0).optional(),
-                bannerClick: z.enum(['YES', 'NO', 'ANY']).optional(),
-                // Применимость и метки заказа предсписка объявляет ВОРОНКА в источнике фактов, а не
-                // мы: у нас настройки больше нет. Правила у воронки нет или данные не готовы — строки
-                // приходят непроверяемыми, и людям не уйдёт ничего.
-                prelist: z.enum(['YES', 'NO', 'ANY']).optional(),
+                bannerClick: triStateSchema.optional(),
+                prelist: triStateSchema.optional(),
                 /**
-                 * ⚠️⚠️ ПОВТОРНОЕ касание. Сегмент уходит тем, у кого `key` был ПОСЛЕДНИМ касанием —
-                 * нашей отправкой или волной школы на этой площадке — и кто нам не ответил. Снимает
-                 * вечный одноразовый claim приветствия — единственную структурную защиту от второго
-                 * сообщения живому человеку, — поэтому порог снизу зеркалит серверную константу и здесь:
-                 * ниже 30 суток сервер откажет.
+                 * ⚠️⚠️ ПОВТОРНОЕ касание: снимает вечный одноразовый claim приветствия — единственную
+                 * структурную защиту от второго сообщения живому человеку. Имя сегмента сервер
+                 * переводит в его идентификатор при сохранении: переименование сегмента правило
+                 * дальше не ломает.
                  */
                 previousSegment: z
                     .object({
-                    key: z.string().min(1).max(64),
-                    minDaysSince: z.number().int().min(30).max(78),
+                    key: z.string().min(1).max(PREVIOUS_SEGMENT_KEY_MAX_LENGTH),
+                    minDaysSince: z
+                        .number()
+                        .int()
+                        .min(REPEAT_TOUCH_MIN_DAYS)
+                        .max(REPEAT_TOUCH_MAX_DAYS),
                 })
                     .strict()
                     .optional(),
                 /**
-                 * Право первого касания: сегмент уходит только тем, кому мы ещё НИКОГДА не писали.
-                 *
-                 * ⚠️⚠️ Молчание значит `true` — это сегодняшнее поведение платформы. Выключение
-                 * осознанное и снимает ровно одну защиту: человеку, уже получившему от нас холодное
-                 * приветствие, уйдёт ВТОРОЕ первое сообщение. Остальные гейты (ответ, оператор,
-                 * тихий период, «этим сегментом уже слали») продолжают работать.
+                 * Право первого касания: молчание значит `true`. Единственный признак, который
+                 * меняется и у замороженного сегмента.
                  */
                 untouchedOnly: z.boolean().optional(),
-                // ⚠️⚠️ ОБЯЗАТЕЛЬНЫ на сервере (`SEGMENT_FACETS_REQUIRED_GUARDS`): необязательное
-                // поле с дефолтом «неважно» делало законным правило целиком из умолчаний, а такое
-                // правило матчит КАЖДОГО в окне — рассылка ушла бы и людям с живой заявкой у
-                // менеджера, и уже заплатившим. `ANY` допустим, но выбирается ЯВНО.
+                // ⚠️⚠️ ОБЯЗАТЕЛЬНЫ: правило целиком из умолчаний подошло бы КАЖДОМУ в окне — рассылка
+                // ушла бы и людям с живой заявкой у менеджера, и уже заплатившим. `ANY` допустим, но
+                // выбирается ЯВНО.
                 application: z.enum(['NONE', 'CANCELLED', 'ANY']),
                 payment: z.enum(['NOT_IN_FUNNEL', 'NOT_ANYWHERE', 'ANY']),
             })
                 .strict(),
             freshness_anchor: anchorSchema,
             wait_after_series_end_hours: z.number().int().min(0).max(WAIT_HOURS_MAX).optional(),
-            priority: z.number().int().min(-1000).max(1000).optional(),
+            priority: z.number().int().min(PRIORITY_MIN).max(PRIORITY_MAX).optional(),
         })
             .strict(),
         createRequest: (input) => ({
@@ -440,13 +527,15 @@ export const broadcastSchedulerTools = [
             }),
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            '⚠️⚠️ 409 означает, что сегментом УЖЕ отправляли и правило заморожено. Это не ошибка доступа: строки отчётов уже несут это имя, и правка правила задним числом сделала бы разрез несопоставимым сам с собой. Заведи НОВЫЙ сегмент.',
-            'attended=NO проходит только достоверный «не пришёл». Человек, про которого данных нет (серия ещё идёт, назначения нет), в сегмент НЕ попадает — и это защита: отсутствие данных о явке не равно отсутствию человека на эфире.',
-            'Секунды, а не минуты: «от 120 минут» — это activeSecondsMin=7200. Контакт без известной длительности порог не проходит.',
-            'wait_after_series_end_hours — сколько ждать после эфира, прежде чем считать отсутствие явки доказанным. Дефолт 1 час: касание свежее, но явка к этому моменту досчитана у меньшинства (6 ч → 56 %, 24 ч → 74 %, 48 ч → 81 %), и недосчитанный контакт в отбор не попадает. Поэтому при коротком ожидании ставьте freshness_days от 3: при 1 человека смотрят ровно один раз.',
-            'application=CANCELLED требует отменённой заявки И отсутствия живой: с человеком, у которого заявка в работе, разговаривает менеджер.',
+            '⚠️⚠️ 409 означает, что сегментом УЖЕ отправляли и правило заморожено. Это не ошибка доступа: строки отчётов уже несут это имя, и правка правила задним числом сделала бы разрез несопоставимым сам с собой. Заведи НОВЫЙ сегмент. Исключения — priority и facets.untouchedOnly: их меняют и у замороженного сегмента, передав остальное правило (фасеты, freshness_anchor, wait_after_series_end_hours) ТЕМ ЖЕ, что у сегмента сейчас.',
+            'warnings в ответе — правка принята, но у неё есть цена: перескажи её человеку своими словами (например, смена права первого касания у сегмента, которым уже отправляли, смешивает в его отчёте первые и повторные сообщения).',
+            'attendedFirstSession=NO — «пропустил ПЕРВЫЙ эфир», единственный способ написать человеку, пока его серия идёт. Требует freshness_anchor=FIRST_SESSION_END_PLUS_WAIT (иначе сервер откажет: вход считался бы от конца серии — на 4–5 суток позже), а ни одно расписание сегмента не должно останавливать отправки внутри серии (guard_active_series не BLOCK — иначе сервер откажет, потому что пул отсеивался бы целиком на каждом запуске).',
+            'attended=NO проходит только достоверный «не пришёл» — и одни короткие заходы меньше пяти минут в сумме. Человек, про которого данных нет (серия ещё идёт, назначения нет), в сегмент НЕ попадает: отсутствие данных о явке не равно отсутствию человека на эфире.',
+            'Секунды, а не минуты: «от 120 минут» — это activeSecondsMin=7200. Человек без известной длительности порог не проходит.',
+            'wait_after_series_end_hours — сколько ждать после эфира, прежде чем считать отсутствие явки доказанным. Не передано — 24 часа: к этому моменту явка досчитана примерно у трёх четвертей (6 ч → 56 %, 24 ч → 74 %, 48 ч → 81 %), а недосчитанный человек в отбор не попадает.',
+            'application=CANCELLED требует отменённой заявки и отсутствия любой другой: живая, закрытая или незнакомая заявка бьёт отменённую.',
             'payment=NOT_ANYWHERE исключает всех, кто когда-либо успешно платил — включая тех, кому потом сделали возврат: он действительно платил.',
-            'untouchedOnly не указан = true: сегмент уходит только тем, кому мы никогда не писали. Ставьте false осознанно — это разрешает второе первое сообщение человеку, уже получившему от нас холодное приветствие в другой воронке.',
+            'previousSegment.key — имя сегмента; сервер хранит его идентификатор, и в ответе прошлое касание приходит идентификатором с текущим именем. untouchedOnly не указан = true: сегмент уходит только тем, кому мы никогда не писали. Ставь false осознанно — это разрешает второе первое сообщение человеку, уже получившему от нас холодное приветствие.',
         ]),
     }),
 ];