@besales/mcp 0.48.0 → 1.0.0-beta.2

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

@@ -1,11 +1,18 @@
+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;
@@ -13,21 +20,22 @@ const COOLDOWN_DAYS_MAX = 365;
 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;
@@ -37,29 +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 и перекрытия предохранителя серии
-    // на расписании (guard_active_series), иначе отправку остановит правило площадки.
+    // эфир, пока серия идёт. Требует признака 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) {
@@ -71,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,
@@ -81,46 +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 той же школы В ДОПОЛНЕНИЕ к своим. Своим людям площадки и людям без карточек расписание пишет как обычно, а людей, чья карточка живёт на других площадках школы (и тех, кого прошлая попытка уже перевезла, но сообщение не ушло), перед отправкой переносит сюда — с перепином на заказ сегмента и остановкой цепочек прежней площадки. Поэтому флаг включают прямо на основной авторассылке сегмента, второе расписание на тот же сегмент не нужно (так с 15.09.2026; раньше флаг заменял пул, и свои люди площадки текста не получали). Площадки-источники считает сам отбор («вся школа минус своя»), поэтому новая площадка школы подхватывается без правки расписания. Включайте на площадке, КУДА переносить людей (обычно квал-площадка): на площадке серии флаг заберёт к ней людей квал-площадки. Флаг нужен на ВСЕХ пересекающихся старших сегментах площадки: претензия старшего сегмента о флаге не знает, и человек с соседней площадки иначе не получит ничего. Требует сегмента-ПРОДОЛЖЕНИЯ (снят «только нетронутым», без правила повтора): у человека с соседней площадки право первого сообщения уже сожжено. Ещё требует заполненного домена школы у площадки расписания и хотя бы одной другой площадки GetCourse в школе. Выключено — передачи нет.'),
-    resend_segment_on_new_registration: z.boolean().optional().describe('ПОВТОР СЕГМЕНТА ПО НОВОЙ РЕГИСТРАЦИИ (с 16.09.2026). Включено — человеку, которому этим сегментом уже писали, расписание напишет снова, только если он зарегистрировался ПОСЛЕ нашей последней отправки этого сегмента и с неё прошла пауза resend_segment_pause_days; продукт регистрации может быть любым. Выключено — сегмент человеку не повторяется никогда (причина alreadySentSegment). Действует только у сегмента-ПРОДОЛЖЕНИЯ без правила повтора: у сегмента «только нетронутым» второе сообщение держит право первого касания (alreadyGreeted). Не передано — у нового расписания включено, у существующего остаётся как было.'),
-    resend_segment_pause_days: z.number().int().min(0).max(RESEND_PAUSE_DAYS_MAX).optional().describe('Пауза повтора сегмента: сутки по 24 часа от нашей последней отправки этого сегмента человеку. Пока не прошла — причина resendPause, человек вернётся в пул сам. Не передано — у нового расписания 3, у существующего остаётся как было. ⚠️ Меньше трёх суток повтор обычно не ускорит: разговор после нашей реплики закрывается тремя сутками тишины, и до тех пор человека держит причина dialogQuiet.'),
+    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 — вернуть под настройку площадки. OFF — расписание пишет и во время серии человека; WARN — причина пишется в аудит, отправка идёт; BLOCK — отправка останавливается. Нужно сегментам, которые пишут внутрь серии ПО ЗАМЫСЛУ (например «пропустил первый эфир», якорь FIRST_SESSION_END_PLUS_WAIT): у них серия идёт по определению, а площадочный переключатель один на ВСЕ расписания площадки и ослабил бы защиту у postweb*, prelist, closed-app и cta разом. Перекрывается только правило серии: заявка и оплата остаются площадочными.'),
+        .describe('Перекрытие предохранителя «идёт вебинарная серия» ДЛЯ ЭТОГО расписания. Не передано — у существующего остаётся как было; null — вернуть под настройку канала. Перекрывается только правило серии: заявка и оплата остаются настройкой канала.'),
     skip_after_segment_ids: z
         .array(uuidSchema)
         .max(SKIP_AFTER_SEGMENTS_MAX)
         .optional()
-        .describe('НЕ ПИСАТЬ ПОСЛЕ СЕГМЕНТОВ (с 22.09.2026): id сегментов справочника (segment.id из besales_broadcast_schedule_list). Человеку, которому текст любого из них ушёл НЕ РАНЬШЕ его регистрации — той, по которой он попал в пул, — это расписание не пишет (причина skipAfterSegment); новая регистрация после того касания открывает человека снова. Сценарий: у расписания reg-no-show указать сегмент reg-no-show-day1 — получившему «пропустил первый эфир» обычное «не смогли прийти» по той же серии не уйдёт, остальным уйдёт. Не передано — у существующего остаётся как было; [] — снять правило. Сам сегмент расписания и чужие id сервер отвергает. Именно id, а не имена: имя сегмента переименовывают.'),
+        .describe('НЕ ПИСАТЬ ПОСЛЕ СЕГМЕНТОВ: идентификаторы сегментов справочника (segment.id из besales_broadcast_schedule_list). Не передано — у существующего остаётся как было; [] — снять правило. Запрет действует, если текст указанного сегмента ушёл не раньше регистрации, по которой человек попал в пул; регистрация новее касания открывает человека снова, неизвестная регистрация запрет не снимает. Сам сегмент расписания, чужие идентификаторы и сегменты со служебным именем сервер отвергает.'),
     is_enabled: z.boolean().optional(),
 };
 /** `all` — это «фильтра нет», то есть ПУСТОЙ список на стороне API. */
@@ -129,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),
@@ -146,26 +190,20 @@ const toScheduleBody = (input) => compactObject({
     dailyCap: input.daily_cap,
     selectionOrder: input.selection_order,
     cooldownDays: input.cooldown_days,
-    handoffFromSchoolPlatforms: input.handoff_from_school_platforms,
+    handoffFromSchoolChannels: input.handoff_from_school_platforms,
     resendSegmentOnNewRegistration: input.resend_segment_on_new_registration,
     resendSegmentPauseDays: input.resend_segment_pause_days,
-    channels: input.channels,
-    // ⚠️ Режим передаётся ТОЛЬКО если его задал вызывающий: сам он на поведение не влияет, но
-    // подставлять сюда `RESTRICT` значит записать в строку расписания решение, которого никто
-    // не принимал, — а прочитано оно будет как действующая настройка.
-    channelsMode: input.channels_mode,
-    // ⚠️ `null` проходит намеренно (`compactObject` режет только `undefined`): им снимают
-    // перекрытие, и «не передал» обязано отличаться от «верни под площадку».
+    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({
@@ -179,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({
@@ -199,41 +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 — этим сегментом уже слали (при включённом resend_segment_on_new_registration — и регистрации новее нашей отправки нет); alreadyGreeted — человек уже получал «Первое сообщение» (одно на контакт навсегда, любым сегментом; прежнее имя ключа coldWelcomeClaimed приходит от старого бэкенда в окне выкатки); activeEpisode — человека уже ведёт автоприём регистраций (приветствие должны и не отдали, либо подготовлен повторный вход на новый эфир); touchClaimed — касание этого сегмента уже занято в журнале, либо тот же текст ушёл человеку другим сегментом меньше трёх суток назад (с 16.09.2026 другой сегмент тем же шаблоном можно, но после трёх суток тишины); журнал подач этого расписания (с 16.09.2026 тремя причинами вместо journal): journalSubmitted — подача ушла, ещё идёт или касание занято, journalNoMessenger — прошлая подача закончилась «карточку не завели» или «каналами не достать» (пауза 7 суток), journalRetryPause — прошлая попытка не удалась, и пауза после неё ещё идёт; contactBlocked — бан, удалённая карточка или действующий мьют; contactWithManager — с человеком работает менеджер (операторский статус или передача диалога в отдел моложе трёх суток); прежние ключи journal и contactHeld приходят только от старого бэкенда в окне выкатки; cooldown — получал любую нашу рассылку в окне.',
-            '⚠️⚠️ productNotInList — у расписания задан список продуктов, а у этих людей продукт другой или не указан вовсе. Прежде этот отсев шёл МОЛЧА: строка выбрасывалась без счётчика, и часть пула исчезала без причины. Чинится списком продуктов в расписании.',
-            '⚠️⚠️ notReachable — ни один из ВЫБРАННЫХ каналов до человека не доходит, и это подтвердил ответ школы. Про невыбранные каналы число не говорит ничего. Чинится составом каналов расписания или рассылки, а не правилом сегмента: вердикт записывается вместе с набором каналов и перестаёт держать паузу, как только набор изменили.',
-            '⚠️⚠️ factsUnknown — НЕ отсев: эти люди в пуле. Число значит «школу про них ещё не спрашивали», и без него ноль в notReachable читается как «все достижимы». Доставки оно НЕ обещает: тот же прогон опрашивает школу перед подачей (по 300 за раз) и часть из них тогда отсеет — в отчёте прогона эти числа уже пересчитаны.',
-            '⚠️ Если notReachable равен размеру пула, сперва проверь площадку: когда НИ ОДИН выбранный канал ею не обслуживается, недостижимы будут все до единого, и чинится это в настройках площадки, а не в расписании. Предпросмотр в этом случае показывает отдельное предупреждение, а прогон закрывается своей причиной.', '⚠️ unverifiable — «нечем проверить», а НЕ «не подходит»: нет назначения серии, серия ещё идёт, нет длительности просмотра. Эти люди в рассылку не идут, и это правильно: отсутствие данных о явке не равно отсутствию человека на эфире.',
-            '⚠️⚠️ truncatedSeriesSkipped — ЕДИНСТВЕННАЯ источниковая причина, которую чинит сам оператор: выборка упёрлась в потолок строк, и запись о явке серии могла остаться за его границей, поэтому судить о ней нечем. Чинится окном расписания за минуту — сузить свежесть, список воронок или продуктов. До 10.09.2026 это число складывалось с unverifiable и читалось как жалоба на данные школы: не путай их снова.',
-            '⚠️⚠️ claimedByHigherPriority — НЕ отсев по данным, а приоритет: человек подходит и под сегмент с БОЛЬШИМ приоритетом, у которого на этой площадке включено расписание ТОГО ЖЕ механизма, он в его окне и фильтрах, и то расписание его возьмёт — или уже отправило ему свой текст, в том числе волной школы. Исключение одно: старшее пишет только нетронутым, а этому человеку мы уже писали ДРУГИМ сегментом — тогда он остаётся младшему. Если старшее этому человеку уже писало (с 16.09.2026): без регистрации новее той отправки он остаётся за старшим; при новой регистрации его забирает старшее, если само повторит сегмент (resend_segment_on_new_registration у сегмента-продолжения), а иначе он уходит младшему — только когда продукт младшего не совпадает ни с одной отправкой старшего (неизвестный продукт держит). Большое число — не поломка, а мера пересечения; меняется приоритетами сегментов. ⚠️ Число НЕ обещает, что человеку вообще что-то уйдёт: (1) потолок и день запуска старшего не проверяются — упрётся старшее в потолок, излишек ждёт следующего запуска, а при FRESH_FIRST самые старые из него выходят из окна ни с чем; (2) если текст старшего уже ушёл волной школы, подхватить человека может только расписание ПОВТОРА старшего сегмента, и его надо завести отдельно; (3) человек без живой карточки на этой площадке не получит ничего ни от кого — повтор старшего отсечёт его причиной repeatNoCard; (4) если у расписаний РАЗНЫЕ списки воронок, разведение неполно: воронки отсекаются на стороне источника фактов, и строк человека из чужой воронки в снимке нет вовсе — ставь пересекающимся сегментам одинаковые воронки.',
-            '⚠️⚠️ repeatNoCard — кандидат на ПОВТОР (прошлое касание годится), но живой карточки на ЭТОЙ площадке у человека нет: чаще всего волну школы записали на эту площадку, а карточка у него на соседней. Без карточки не проверить ответы и дожимы, а импорт карточку здесь не заведёт (обновит соседнюю), поэтому такие люди исключаются. Расписанием это не чинится.',
-            '⚠️⚠️ cardOnSiblingPlatform — человек живёт на СОСЕДНЕЙ площадке той же школы GetCourse, а на площадке расписания карточки у него нет. Импорт её сюда не перенесёт: он ищет человека по школе и обновляет ту карточку, что уже есть, — поэтому такие люди исключаются, а не уезжают в импорт (иначе каждую неделю они занимали бы слот дневного потолка и закрывались исходом NOT_IMPORTED). Расписанием не чинится: рассылать надо с той площадки, где человек живёт. Большое число у расписания на новой площадке — норма: люди школы живут на старой.',
-            '⚠️⚠️ noMessengerVerdict — школа УЖЕ отвечала, что привязанных мессенджеров у человека нет, и ответ ещё в силе. Карточки в базе у него нет, импорт её не заведёт, поэтому подача сожгла бы слот дневного потолка и слот импортов воркспейса и закрылась бы исходом NOT_IMPORTED на 7 суток. Срок доверия ответу задаётся у ПЛОЩАДКИ (getcourse_settings.reachability_ttl_days, по умолчанию 7 суток; 0 — спрашивать школу каждый раз). Срок считается СУТКАМИ площадки: ответ в силе, пока он новее полуночи дня запуска минус срок — поэтому «Пул сегодня» и любой запуск того же дня отвечают одинаково, как бы ни задержался отбор (с 17.09.2026); когда срок истечёт, человек снова уедет в импорт и школу спросят заново. Чинится почтой, но включать её надо В ДВУХ местах: в allowlist ПЛОЩАДКИ (getcourse_settings.available_transports) и в каналах рассылки/расписания. Гейт сужает каналы по allowlist площадки, поэтому Email только в рассылке ничего не меняет — и это верно: канал вне allowlist школа не отправит никогда.',
-            '⚠️⚠️ alreadyInDialog — с человеком идёт ЖИВОЙ разговор: он написал нам после нашей последней реплики (агента, оператора, дожима или процесса школы из импортированной истории). Сам такой разговор не закроется, пока ему не ответят. Это ЗЕРКАЛО отказа доставки SKIPPED_ALREADY_IN_DIALOG, поэтому место в дневном лимите он не занимает. С 16.09.2026 одинаково у сегмента «только нетронутым» и у продолжения. Расписанием не чинится.',
-            '⚠️⚠️ dialogQuiet — пауза тишины разговора, а не отсев навсегда: наша последняя реплика в чате моложе трёх суток (по 24 часа), человек после неё не писал. После трёх суток тишины разговор закрыт, и человек вернётся в пул сам — в том числе тот, кто когда-то нам отвечал (решение 16.09.2026). Доставка отказывает таким тем же SKIPPED_ALREADY_IN_DIALOG. «Пул сегодня» считает эту причину на момент запуска авторассылки.',
-            '⚠️⚠️ skipAfterSegment — человеку уже ушёл текст одного из сегментов списка skip_after_segment_ids расписания, и он не регистрировался после того касания (например, получил «пропустил первый эфир», и «не смогли прийти» по той же серии ему не уходит). Новая регистрация открывает его снова. У расписания без списка число всегда 0.',
-            '⚠️⚠️ resendPause — этим сегментом человеку уже писали, после нашей отправки он зарегистрировался снова, и расписание повторит ему сегмент (resend_segment_on_new_registration), но пауза resend_segment_pause_days ещё идёт. Вернётся в пул сам. При выключенном флаге такие люди стоят в alreadySentSegment.',
-            'resendOpened — НЕ отсев: сколько из selectedCount пустил повтор сегмента по новой регистрации (этим сегментом им уже писали, они зарегистрировались снова, и пауза прошла). Это мера самого правила: при выключенном флаге всегда 0.',
-            '⚠️⚠️ guardActiveSeries / guardPaid / guardActiveApplication / guardUnverified — ЗЕРКАЛО предохранителя школы (идёт вебинарная серия; guardPaid — купил продукт после регистрации, по которой человек попал в сегмент; guardActiveApplication — после этой регистрации есть действующая заявка на продукт, с человеком работает менеджер; заявки и оплаты до этой регистрации не держат; оплата и заявка сразу — guardPaid; прежний ключ guardActiveDeal приходит только от старого бэкенда; не смог проверить — нет в данных школы или продукт оплаты не определён). Отбор спрашивает те же правила площадки, что и отправка, поэтому остановленные не занимают дневной лимит, и его добирают следующие по очереди. ⚠️ Числа считаются только до набора дневного лимита: кто после — в overCap, их предохранитель не судил. Серия проходит сама: человек вернётся в отбор, как только она закончится. Режимы правил — в настройках площадки (getcourse_settings.guard_*).',
-            '⚠️⚠️ guardUnchecked — НЕ отсев: предохранитель не проверил столько отобранных (cause=SOURCE_UNAVAILABLE — источник фактов не ответил, error — текст отказа; OUT_OF_TIME — проверка не уложилась в время запроса). Они стоят в selectedCount без проверки серии, заявки и оплаты; перед отправкой их проверит сама отправка, и часть отсеется. Скажи пользователю, что число «уйдёт» в этот раз завышено. На крупной площадке предпросмотр почти всегда отвечает OUT_OF_TIME (выкачка кандидатов съедает почти весь предел ответа) — полная картина с проверкой в besales_broadcast_pool_today. После отказа источника проверка минуту не повторяется: повторный вызов сразу вернёт SOURCE_UNAVAILABLE.',
-            '⚠️⚠️ notHandoffCandidate — у расписания с передачей (включён handoff_from_school_platforms) человек живёт на ДРУГОЙ площадке той же школы, но переносить его нельзя: его серия там ещё идёт (последний шаг календарной цепочки источника впереди или у контакта нет даты эфира) либо у него карточки сразу на нескольких других площадках. Свои люди площадки и люди без карточек сюда НЕ попадают: с 15.09.2026 расписание берёт их как обычно. У обычного расписания число всегда ноль.',
-            '⚠️⚠️ 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',
@@ -262,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
@@ -286,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.',
         ]),
     }),
@@ -302,39 +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 — прогон отложен, период НЕ сгорел: воркспейс был занят другим импортом или пакетом (ручным или соседнего расписания), не ответил источник фактов («Источник фактов: …») или не прочитались старшие сегменты («Старшие сегменты не прочитаны: …») — причина в error; прогон повторится ближайшим тиком, когда расписание созреет (в тот же день и не раньше его времени, поэтому «Запустить сейчас» до времени расписания сам не повторится); SKIPPED — правило отбора не дало кандидатов (смотри excludedBy); FAILED — упал запуск пакета; RUNNING — пакет ещё идёт.',
-            '⚠️ selectedCount — сколько ОТОБРАНО, launchedCount — сколько фактически доставлено. Расхождение нормально: часть отсеивают гейты отправки внутри пакета. Не называй selectedCount «отправлено».',
-            '⚠️ snapshot.guardUnchecked у прогона — в этот день предохранитель не проверил часть отобранных (источник фактов не ответил или кончилось время), и отсев доставки по серии, заявке и оплате был выше обычного. Отсеянных ОТБОРОМ по предохранителю можно найти в аудите предохранителя: строки с details.stage=SCHEDULE_SELECTION и runId прогона.',
-            'attempts растёт на каждом WAITING_RESOURCE: большое число при error «Воркспейс занят …» означает, что воркспейс постоянно занят и расписание стоит передвинуть по времени; при «Источник фактов: …» чинится источник, а не время.',
-            '⚠️ Все блоки «продукт × воронка» прогона уходят ОДНИМ пакетом, без потолка (прежде — не больше 10). excludedBy.droppedOverBlockLimit бывает только у старых прогонов — люди блоков сверх 10, которые ничего не получили.',
-            '⚠️ excludedBy.blockPlaceholdersUnresolved — люди блоков, снятых проверкой плана: в тексте блока не подставились переменные (обычно у агента нет перекрытия переменной). Остальные блоки ушли; эти люди вернутся к следующему запуску (исход SKIPPED_UNRESOLVED_VARS, пауза 6 ч), и, пока агента не поправят, блок снимается на каждом запуске, занимая место в потолке прогона (dailyCap); имена переменных — в причине их строк журнала подач. Чинится значениями переменных или перекрытиями у агента — скажи об этом пользователю.',
+            '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',
@@ -348,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(),
@@ -360,7 +402,7 @@ export const broadcastSchedulerTools = [
         })
             .strict()
             .superRefine((input, ctx) => {
-            // ⚠️ Утренний расчёт дня считан с настройками по умолчанию: фильтры рядом с днём сервер
+            // ⚠️ Утренний расчёт дня посчитан с настройками по умолчанию: фильтры рядом с днём сервер
             // отвергает 400-й, и узнавать об этом из ошибки модель не должна.
             const withSettings = input.window_days !== undefined ||
                 input.funnels !== undefined ||
@@ -372,7 +414,7 @@ export const broadcastSchedulerTools = [
                 ctx.addIssue({
                     code: z.ZodIssueCode.custom,
                     path: ['local_day'],
-                    message: 'local_day читает утренний расчёт дня с настройками по умолчанию — окно, воронки, продукты, каналы, кулдаун и force с ним не передаются',
+                    message: 'local_day читает утренний расчёт дня с настройками по умолчанию — окно, воронки, продукты, каналы, тихий период и force с ним не передаются',
                 });
             }
         }),
@@ -380,35 +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 — источник фактов не настроен или выключен: расчёта не будет вовсе.',
+            '⚠️⚠️ 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 — утренний расчёт того дня (история «сегмент × день»), всегда с настройками по умолчанию.',
-            '⚠️ Вызов с ДРУГИМИ параметрами снимает твой прежний неначатый заказ (расчёт идёт по одному на всю систему). Сравнивая площадки или окна, дождись готовности одной комбинации и только потом заказывай следующую — иначе ни одна не досчитается.',
-            'Суммы по строкам не называй «людьми»: человек в двух сегментах посчитан дважды. Поимённых списков в ответе нет — людей смотрят в интерфейсе, под правом на контакты.',
-            '⚠️⚠️ «Сколько уйдёт сегодня» — это 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 — они же по причинам (одна на регистрацию, сумма равна outsideSegments): paid — оплатил в этой воронке, application — живая заявка, attendanceNoMinutes — был на эфире, минут не записано, paidElsewhere — покупал в ДРУГОЙ воронке, seriesRunning — серия ещё идёт (их возьмут авторассылки по концу эфира, когда она закончится), other — прочее; у расчётов до 01.10.2026 paidElsewhere и seriesRunning нет — эти люди там в other; registrations — регистраций, вошедших в сегменты окнами своих авторассылок (от прошлого отбора до запуска; enteredFrom…enteredTo — общий охват этих окон); people — людей из них, КАЖДЫЙ ОДИН раз при любом числе сегментов; excluded — людей по причине отсева (noMessenger — нет мессенджера (в том числе прошлая подача этим расписанием закончилась «карточку не завели» или «каналами не достать»), inContact — на связи или писали недавно (этим сегментом уже писали, идёт разговор или трое суток тишины после нашей реплики, пауза повтора сегмента, пауза после любого нашего сообщения (поле расписания «Не писать, если писали за N дней»), подача этим расписанием ушла или ещё идёт), paid — купил продукт после регистрации, по которой попал в сегмент, withManager — с ним работает менеджер (действующая заявка на продукт после этой регистрации, операторский статус или передача диалога в отдел моложе трёх суток), blocked — бан, удалённая карточка или действующий мьют, activeSeries — идёт другая вебинарная серия, retryPause — прошлая попытка отправки этим расписанием не удалась, ждём паузу, overCap — не поместились в дневной потолок, higherPriority — уйдут в сегмент с большим приоритетом, otherPlatform — карточка на другой площадке школы, и эта авторассылка её не забирает (передача выключена, там ещё идёт серия эфиров или её дата неизвестна, карточек несколько, перенос не удался или уже увёз человека отсюда; у расчётов и прогонов до 22.09.2026 этой группы нет — эти люди в other), other — прочее (предохранитель не смог проверить заявки и оплаты, карточки на этой площадке нет, повтору не нашлось прошлого касания, непригодный номер человека); у расчётов до 16.09.2026 вместо новых приходят прежние группы alreadyWritten (уже писали), held (купил, менеджер, бан или мьют), pause (пауза); у запусков до 16.09.2026 (facts.scheduleRuns) к новым группам добавляются прежние held и pause, только ненулевые — называй их так и не складывай с новыми); people = selected + сумма excluded; carriedOver — уйдут этим запуском люди с прошлых дней. ⚠️⚠️ После запуска экран показывает «Уйдёт» числом «Взято запусками» (facts: sent + noMessenger + notSent + pending), когда все авторассылки плана (scheduleIds без ranScheduleIds и notComputedScheduleIds) уже отобрали людей и ни одна отобравшая не лежит вне плана; разница с selected + carriedOver показана как «добавились к запуску» / «отпали к запуску»: авторассылки отбирают людей по очереди, по приоритету, и за это время у части людей кончаются паузы. Называя «Уйдёт» дня, чьи запуски прошли, называй это число и разницу с планом. У каждого сегмента то же в run.rows[].dayBreakdown (без matured; null — сегмент не посчитан или запуск его авторассылки уже прошёл), и его runDay может быть другим днём — у авторассылки не на каждый день; у выключенной авторассылки selected — «уйдёт, если включить», в план дня она не входит.',
-            'facts — исход запусков дня run.dayBreakdown.runDay по людям, по всем авторассылкам площадки: sent — отправлено, noMessenger — карточку не завели или ни один канал не доходит (школа ответила, что мессенджеров нет, каналы не подошли или сорвалась запись импорта), pending — подан в ещё идущий прогон, notSent — не ушло или доставка не подтвердилась (в том числе сорванная отправка); notSentByReason — те же notSent по причинам: один исход на человека, сумма равна notSent; ключ — исход отказа отправки (SKIPPED_BOT_SILENCED — бот выключен у контакта, SKIPPED_ALREADY_IN_DIALOG — разговор уже идёт, SKIPPED_UNRESOLVED_VARS — переменные текста без значения и соседи, как в outcomes у besales_broadcast_launches_list), без следа отправки — исход журнала подач (UNRESOLVED_AFTER_BATCH — причина не записана: прогоны до 16.09.2026, RELEASED_LAUNCH_FAILED — запуск сорвался); человеку называй причины словами, а не кодами; bySchedule — то же по авторассылкам; scheduleRuns — что увидел каждый запуск дня при отборе (без фильтров): poolSize — пул авторассылки на момент отбора (окно свежести, а не люди дня; null — ещё не отбирал), collapsed — свёрнутые дубли одного человека, excluded — отсев по тем же группам, taken — взято запуском (люди в журнале подач; с этого числа начинается отправка авторассылки в bySchedule, а люди, которых импорт не завёл, в нём есть), unrecorded — люди пула, которых не объясняют ни причины, ни взятые (должно быть 0; не ноль — счётчики прогона не сходятся с его журналом); суммы пулов разных авторассылок людьми дня не называй — человек в двух сегментах посчитан дважды; selectedScheduleIds — авторассылки, чей прогон дня уже отобрал людей или завершился (без фильтров): есть там, но нет в run.dayBreakdown.ranScheduleIds — запуск прошёл уже после расчёта, и без local_day план устарел: повтори вызов с теми же параметрами; ⚠️ под фильтром воронки или продукта план берёт человека с любой регистрацией в них, а факты — по регистрации, с которой ему написали: у людей с регистрациями в разных воронках план и факты расходятся; facts=null — прогонов авторассылок этого дня нет (запуска ещё не было). days — до 14 дней с утренним расчётом (в 8:00, до запусков дня и впереди заказов в очереди; опоздавший виден по непустому ranScheduleIds) и хотя бы одним запуском, а также дни с прошедшим запуском без утреннего расчёта, свежие первыми (для local_day); у такого дня run — null или без dayBreakdown, итог дня по людям — только facts, а отбор каждого запуска — facts.scheduleRuns. Человеку называй сегменты и авторассылки, а не «строки».',
-            '⚠️⚠️ «Сколько ушло СЕГОДНЯ» — это todayFacts, а не facts: today — сегодняшний день площадки (ГГГГ-ММ-ДД, по её часам), todayFacts — отправка сегодня в том же виде, что facts, какой бы день ни показывал расклад. После всех запусков дня run.dayBreakdown.runDay и facts уже про ЗАВТРА (facts=null — завтра запусков ещё не было), а сегодняшние итоги остаются в todayFacts. Отвечая, разделяй «Сегодня» (todayFacts) и план ближайшего дня (run.dayBreakdown). todayFacts=null — сегодня запусков не было; с local_day today и todayFacts всегда null — у дня истории итог только facts.',
-            'Сводка выкачки у run: fetchedRows (строк источника), fetchTruncated (выборка упёрлась в бюджет — у строк она отзывается preview.truncated), registeredFrom/registeredTo (окно регистраций), trigger (MORNING — утренний расчёт истории, ON_DEMAND — заказанный), settings (настройки строк без расписания). Называй их, объясняя расхождение чисел между днями.',
+            '⚠️ Вызов с ДРУГИМИ параметрами снимает твой прежний неначатый заказ (расчёт идёт по одному на всю систему). Сравнивая каналы или окна, дождись готовности одной комбинации и только потом заказывай следующую — иначе ни одна не досчитается.',
+            'Суммы по строкам не называй «людьми»: человек в двух сегментах посчитан дважды. Поимённых списков в ответе нет — людей смотрят в интерфейсе, под правом на контакты (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({
@@ -422,57 +470,50 @@ export const broadcastSchedulerTools = [
             segment_id: uuidSchema,
             facets: z
                 .object({
-                attended: z.enum(['YES', 'NO', 'ANY']).optional(),
+                attended: triStateSchema.optional(),
                 /**
-                 * Был на ПЕРВОМ эфире серии. `NO` — пропустил первый эфир; вопрос отвечается, пока
-                 * серия ещё идёт, поэтому с `attended` они не взаимозаменяемы: та спрашивает про всю
-                 * серию и до её конца равна «нечем проверить».
+                 * Был на ПЕРВОМ эфире серии. `NO` — пропустил первый эфир; вопрос отвечается, пока серия
+                 * ещё идёт, поэтому с `attended` они не взаимозаменяемы.
                  */
-                attendedFirstSession: z.enum(['YES', 'NO', 'ANY']).optional(),
+                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` — это сегодняшнее поведение платформы. Выключение
-                 * осознанное и снимает ровно одну защиту: человеку, уже получившему от нас холодное
-                 * приветствие, уйдёт ВТОРОЕ первое сообщение. Остальные гейты (ответ, оператор,
-                 * тихий период, «этим сегментом уже слали») продолжают работать. Единственный фасет,
-                 * который меняется и у замороженного сегмента (решение владельца 15.09.2026).
+                 * Право первого касания: молчание значит `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) => ({
@@ -486,14 +527,15 @@ export const broadcastSchedulerTools = [
             }),
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            '⚠️⚠️ 409 означает, что сегментом УЖЕ отправляли и правило заморожено. Это не ошибка доступа: строки отчётов уже несут это имя, и правка правила задним числом сделала бы разрез несопоставимым сам с собой. Заведи НОВЫЙ сегмент. Исключения — priority и facets.untouchedOnly: их меняют и у замороженного сегмента, передав остальное правило (фасеты, freshness_anchor, wait_after_series_end_hours) ТЕМ ЖЕ, что у сегмента сейчас; с даты переключения отчёт сегмента смешивает первые и повторные сообщения — скажи это человеку.',
-            'attendedFirstSession=NO — «пропустил ПЕРВЫЙ эфир», и это единственный способ написать человеку, пока его серия идёт. Требует: freshness_anchor=FIRST_SESSION_END_PLUS_WAIT (иначе вход в сегмент считался бы от конца серии — на 4–5 суток позже) и guard_active_series=OFF у РАСПИСАНИЯ (иначе предохранитель площадки остановит отправку: серия у человека идёт по определению). Источник фактов обязан отдавать явку по первому эфиру; пока не отдаёт, строки приходят непроверяемыми и никому ничего не уйдёт.',
-            '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 осознанно — это разрешает второе первое сообщение человеку, уже получившему от нас холодное приветствие.',
         ]),
     }),
 ];