@besales/mcp 0.48.0 → 1.0.0-beta.2

package/dist/tools/definitions/getcourse-cold-welcome.js

@@ -1,140 +1,94 @@
+// «Первое сообщение» GetCourse (холодное приветствие): предпросмотр, запуск, пакет сегментов, ход пакета,
+// возобновление и отмена. Схемы — с отгруженной линии (`getcourse-cold-welcome.ts`): клиент,
+// зовущий инструменты сегодня, не получает отказа ни на одном поле, которое принимал. Отличия v2 — в теле
+// запроса (канал называется channelId, подтверждение отправки людям уходит на сервер), в текстах для модели и
+// в одном добавленном поле: `product_code` у предпросмотра — прогноз предохранителя обязан судить тот же
+// продукт, что запуск.
 import { z } from 'zod';
-import { compactObject, defineTool, coldWelcomeChannelsModeEnum, getcourseTransportEnum, guardModeEnum, uuidSchema, withInstructions, } from './shared.js';
+import { guardModeEnum } from './getcourse-cold-outbound-settings.js';
+import { compactObject, defineTool, getcourseTransportEnum, uuidSchema, withInstructions, } from './shared.js';
 const MESSAGE_MAX_LENGTH = 4000;
 const LABEL_MAX_LENGTH = 200;
 const MAX_CONTACTS = 5000;
-/** Потолок сегментов в пакете — паритет с бэкендом и с батчем волны. */
+/** Потолок сегментов в пакете — паритет с сервером и с пакетом волны. */
 const MAX_BATCH_SEGMENTS = 10;
+const continuationSchema = z
+    .literal(true)
+    .describe('Только по явной просьбе человека продолжить обращение по файлу contacts. Сначала preview с теми же текстом, сегментом, продуктом и каналами, затем подтверждённый start. Не выбирать автоматически по alreadyWelcomed.')
+    .optional();
+const continuationHasContacts = (input) => input.continuation === undefined || input.contacts !== undefined;
+const continuationHasText = (input) => input.continuation === undefined ||
+    input.message !== undefined ||
+    input.mailing_variant_id !== undefined;
+const CONTINUATION_AUDIENCE = 'continuation разрешён только по файлу contacts, без created_after';
+const CONTINUATION_TEXT = 'continuation: передай message или mailing_variant_id с выбранным текстом и сегментом';
+function continuationPreviewHints(response) {
+    const data = response;
+    const total = data?.totalContacts;
+    const narrowed = data?.narrowedOutByTransports ?? data?.narrowedOutByChannels;
+    return [
+        'ПРОДОЛЖЕНИЕ: totalContacts — аудитория прогноза. alreadyWelcomed — справка о прежнем первом сообщении, НЕ вычитается из охвата. Охват = totalContacts − narrowedOutByTransports (прежнее имя narrowedOutByChannels); channelsUnknown не вычитается. В текущем v2 channelsUnknown=0: отправка школу не переспрашивает.',
+        ...(typeof total === 'number' &&
+            Number.isSafeInteger(total) &&
+            typeof narrowed === 'number' &&
+            Number.isSafeInteger(narrowed) &&
+            narrowed >= 0 &&
+            total >= narrowed
+            ? [
+                `Охват прогноза: ${total - narrowed}. Это прогноз, окончательная доставка видна в статусе задачи.`,
+            ]
+            : []),
+        'В продолжении touchClaimed может быть больше нуля; blockedBy.alreadyGreeted=0. alreadySentSegment запрещает повтор того же текста тому же сегменту; тот же шаблон другому сегменту разрешается лишь спустя больше трёх суток. Прежние приветствия права не освобождают.',
+        'Разговор блокирует отправку, только если прежде была наша реплика: человек ответил после неё либо наша реплика моложе трёх суток. Ровно трое суток временной гейт отпускает. Без нашей реплики одно сообщение человека этот гейт не включает.',
+        'Продолжение выбирай только по явной просьбе человека. Сначала preview с теми же continuation, файлом, текстом, сегментом, продуктом и каналами; после подтверждения start с explicit_confirmation=true. При 400 исправь названные в ошибке текст, сегмент или список; не повторяй отправку автоматически.',
+    ];
+}
 /**
- * Строка предсписка: getcourseUserId, опциональный пин сделки для штампа полей и — опционально —
- * момент входа человека в когорту.
- *
- * Оба ИДЕНТИФИКАТОРА — ЧИСЛА в строковом виде, и проверяется именно форма: паритет с сестринской
- * `besales_getcourse_wave_run_start`. Непустоты мало — «AB-123» доезжал до штампа уже ПОСЛЕ
- * доставки сообщения, а «user@mail.ru» молча выпадал в отбракованные строки.
+ * Режим набора каналов, снятый прежней системой: принимается ради старых клиентов и на поведение не
+ * влияет. Список `channels` значит «слать сюда», судьбу КАЖДОГО канала решает сервер по фактам о человеке.
  */
-const numericIdSchema = (field) => z
-    .string()
-    .trim()
-    .regex(/^\d+$/, `${field} обязан быть числовым идентификатором GetCourse`);
+export const coldWelcomeChannelsModeEnum = z.enum(['RESTRICT', 'ADD']);
+/**
+ * Идентификаторы строки — ЧИСЛА в строковом виде, и проверяется именно форма: «AB-123» доезжал бы до штампа
+ * уже ПОСЛЕ доставки сообщения.
+ */
+const numericIdSchema = (field) => z.string().trim().regex(/^\d+$/, `${field} обязан быть числовым идентификатором GetCourse`);
 const contactSchema = z
     .object({
     contact_id: numericIdSchema('contact_id'),
     deal_id: numericIdSchema('deal_id').optional(),
     /**
-     * Момент входа контакта в когорту — на нём считается свежесть в «Аналитике рассылок».
-     *
-     * ⚠️⚠️ Заполняй его, когда предсписок собран ПРАВИЛОМ (события LeakEngine, выгрузка по
-     * сегменту): у каждой строки там свой момент, и он ФАКТ О ЧЕЛОВЕКЕ. Пока поле не принималось,
-     * все холодные строки уезжали без возраста и выпадали из любого непустого фильтра свежести.
-     *
-     * ⚠️⚠️ Дату запуска сюда подставлять НЕЛЬЗЯ. Разброс возраста в таких когортах — от часа до
-     * 294 дней при медиане 6,3 дня: общий момент схлопнул бы месяцы когорт в одну корзину, а
-     * разрез при этом выглядел бы наполненным. Не знаешь момента строки — не передавай ключ.
-     *
-     * `{ offset: true }` — зона обязательна (…Z либо ±ЧЧ:ММ), паритет с сестринской
-     * `besales_getcourse_wave_run_start`: без зоны момент читался бы по зоне процесса, и возраст
-     * разошёлся бы на часы между средами.
+     * Момент входа человека в когорту — на нём считается свежесть в «Аналитике рассылок». Дату запуска
+     * подставлять НЕЛЬЗЯ: общий момент схлопнул бы месяцы когорт в одну корзину. Зона обязательна.
      */
     segment_entered_at: z.string().datetime({ offset: true }).optional(),
     /**
-     * Момент регистрации, по которой человек попал в сегмент, — граница ТЕКУЩЕГО потока у
-     * предохранителя: заявки и оплаты раньше неё не держат (решение владельца 15.09.2026).
-     *
-     * ⚠️⚠️ Это момент РЕГИСТРАЦИИ строки сегмента (регистрация в лике), и ничто другое: подставлять
-     * `segment_entered_at` или «созрел с» НЕЛЬЗЯ — у reg-no-show и postweb это конец серии плюс
-     * ожидание, и заявка или оплата во время серии выпала бы из правила (холодное сообщение
-     * купившему). Не знаешь момента регистрации — не передавай ключ: судится вся история. Зона
-     * обязательна, как у `segment_entered_at`.
+     * Момент РЕГИСТРАЦИИ, по которой человек попал в сегмент, — граница потока у предохранителя: заявки и
+     * оплаты раньше неё не держат. Подставлять `segment_entered_at` или «созрел с» НЕЛЬЗЯ. Зона обязательна.
      */
     registered_at: z.string().datetime({ offset: true }).optional(),
-    /**
-     * Воронка ЭТОГО контакта — паритет со строкой волнового импорта (колонка
-     * `funnel | funnel_name | воронка | funnel_code`).
-     *
-     * ⚠️⚠️ Заполняй, когда файл собран из НЕСКОЛЬКИХ воронок: одна метка на запуск заставляла
-     * писать в поле воронки когорту («reg-no-show|дбо»), и ось «Воронка» переставала отвечать
-     * на свой вопрос — по f11 фильтр показывал НОЛЬ отправок за 30 дней при 3267 регистрациях
-     * и 1496 реально написанных людях (замер 02.09.2026). Когорта и продукт при этом уже лежат
-     * в своих полях `segment` и `product_code` — дублировать их в воронке нечем.
-     *
-     * Не передан — берётся воронка запуска (`funnel`), поведение прежнее.
-     */
+    /** Воронка ЭТОГО человека (файл из нескольких воронок); не передана — воронка запуска. */
     funnel: z.string().min(1).max(LABEL_MAX_LENGTH).optional(),
 })
     .strict();
-const toContacts = (contacts) => contacts?.map((contact) => ({
-    contactId: contact.contact_id,
+const toContacts = (contacts) => contacts?.map((contact) => compactObject({
+    getcourseUserId: contact.contact_id,
     dealId: contact.deal_id,
     segmentEnteredAt: contact.segment_entered_at,
     registeredAt: contact.registered_at,
     funnel: contact.funnel,
 }));
-/**
- * Пустая строка = поля НЕТ.
- *
- * ⚠️ В экспорте GetCourse пустая ячейка приезжает как `''`, и список, собранный из него, почти
- * всегда содержит пустые почты, телефоны и имена. Без этого `email: ''` завалил бы ВЕСЬ вызов
- * валидацией, хотя у файлового импорта та же строка проходит нормально: разбор считает пустое
- * значение отсутствующим. Симметрично `EmptyToUndefined` в DTO бэкенда.
- */
-const emptyAsAbsent = (schema) => z.preprocess((value) => (typeof value === 'string' && value.trim() === '' ? undefined : value), schema.optional());
-/**
- * Строка ИМПОРТА — шире отправочной: кроме идентификаторов несёт данные самого контакта.
- *
- * Ключи остаются snake_case и уезжают на бэкенд КАК ЕСТЬ: там их читает разбор по алиасам колонок
- * экспорта GetCourse (`contact_id`, `gc_deal_id`, `first_name`, …), тот же, что и для файла.
- * Переименование в camelCase завело бы вторую копию правил разбора — а разбор решает, какой
- * транспорт у контакта и попадёт ли он в базу вообще.
- */
-const importContactSchema = z
-    .object({
-    contact_id: numericIdSchema('contact_id'),
-    deal_id: emptyAsAbsent(numericIdSchema('deal_id')),
-    dialog_id: emptyAsAbsent(numericIdSchema('dialog_id')),
-    transport: emptyAsAbsent(z.string().trim().max(50)),
-    email: emptyAsAbsent(z.string().trim().email('email невалиден').max(320)),
-    phone: emptyAsAbsent(z.string().trim().max(64)),
-    first_name: emptyAsAbsent(z.string().trim().max(200)),
-    last_name: emptyAsAbsent(z.string().trim().max(200)),
-})
-    .strict();
-/**
- * Рассылка «Первое сообщение» (холодное приветствие GetCourse): МЫ пишем первыми тем, кому НАШЕГО
- * исходящего ещё не было.
- *
- * ⚠️⚠️ Именно «нашего исходящего не было», а не «диалога нет»: человек, который написал школе и
- * остался без ответа, — законный адресат (замер 01.09.2026: 4216 таких карточек из 8428 с диалогом,
- * и их частые реплики «я буду», «ок», «+» это подтверждения участия в эфире). Исключать их из
- * когорты НЕ надо. Отправка НЕОБРАТИМА и не идемпотентна на стороне GetCourse — повтор создал
- * бы второе сообщение живому человеку, поэтому старт требует explicit_confirmation и всегда
- * предваряется preview.
- */
+const dealFieldsSchema = z.record(z.string().regex(/^\d+$/, 'Ключ deal_fields обязан быть числовым fieldId GetCourse'), z.union([z.string(), z.number(), z.boolean(), z.null()]));
+/** Ровно одна аудитория. */
+const ONE_AUDIENCE = 'Ровно одна аудитория: created_after (по дате) ЛИБО contacts (по файлу)';
+/** Ровно один источник текста — у запуска и пакета. */
+const ONE_TEXT_SOURCE = 'Ровно один источник текста: message (разовый) ЛИБО mailing_variant_id (сохранённая рассылка)';
+const CHANNELS_MODE_DEPRECATED = '⚠️ channels_mode УСТАРЕЛ и на поведение НЕ влияет. Список channels значит «слать сюда», а судьбу КАЖДОГО канала решает сервер: мессенджер (Telegram/VK/MAX) уходит, только если школа подтвердила его наличие у человека; SMS — только при известном телефоне; Email, WhatsApp, Viber, Сайт, Chatium уходят вслепую всем выбранным. Просят «написать ещё и на почту» — добавь Email в channels, а мессенджеры перечисли явно, иначе уедет только письмо. Поле принимается ради обратной совместимости и игнорируется.';
+/** Предохранитель — общий текст запуска, пакета и предпросмотра. */
+const GUARD_INSTRUCTION = 'ПРЕДОХРАНИТЕЛИ. Перед отправкой каждый человек проверяется по фактам школы: идёт ли у него вебинарная серия, есть ли действующая заявка (с ним работает менеджер), оплачен ли продукт запуска. Заявка держит только отправку своего продукта. Заявки и оплаты судятся только после регистрации, по которой человек попал в сегмент: передавай её моментом contacts[].registered_at (не segment_entered_at и не «созрел с»: у reg-no-show и postweb они на дни позже, и заявка или оплата во время серии выпала бы из правила); без него судится вся история человека. Режимы правил (выключено / предупреждать / блокировать) настраиваются у канала — besales_platform_settings_update, getcourse_settings.guard_*: там решение видно всей команде. Исходы в итоге: SKIPPED_ACTIVE_SERIES, SKIPPED_ACTIVE_DEAL, SKIPPED_GUARD_UNAVAILABLE.';
+const GUARD_SERIES_IS_DEFERRAL = '⚠️ Блокировка по серии — это ОТСРОЧКА, а не потеря: серия кончится, и человек станет доступен следующему запуску. Не пытайся обойти правило, чтобы «добрать объём».';
+const GUARD_PAID_NEEDS_PRODUCT = '⚠️ Правило оплаты сверяет продукт запуска с оплаченными. Не задан product_code (и у рассылки нет продукта по умолчанию), а у человека есть оплата — отправка пропускается с SKIPPED_GUARD_UNAVAILABLE («сверять не с чем»): чинится запуском с продуктом.';
 export const getcourseColdWelcomeTools = [
-    defineTool({
-        name: 'besales_contact_touch_history',
-        sideEffect: 'none',
-        requiredFields: ['getcourse_user_id'],
-        defaultWorkspaceId: true,
-        schema: z
-            .object({
-            workspace_id: uuidSchema.optional(),
-            getcourse_user_id: z.number().int().positive(),
-        })
-            .strict(),
-        createRequest: (input) => ({
-            method: 'GET',
-            path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/touch-history/${input.getcourse_user_id}`,
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            '⚠️⚠️ touches и sends отвечают на РАЗНЫЕ вопросы, складывать их нельзя. touches — журнал касаний: это ПРАВО, взятое ДО отправки, поэтому строка есть и у попытки, которая никуда не ушла (status UNKNOWN или зависший CLAIMED). sends — реестр получателей, он пишется ПОСЛЕ доставки и best-effort: его отсутствие неотправки НЕ доказывает (замер: 10 198 приветствий против 9 802 строк).',
-            'На вопрос «писали ли мы этому человеку» отвечает НАЛИЧИЕ строки в touches со статусом не RELEASED (RELEASED — доказанная неотправка, касание свободно) либо непустой firstWelcomeAt.',
-            'touchKey — служебное имя права, не показывай его пользователю как есть. Роды: ярлык сегмента; text:<отпечаток шаблона>@segment:<ярлык> (продолжение сегмента с 16.09.2026: этот текст этим сегментом не дважды, другим сегментом — после трёх суток тишины), с хвостом @after:<мс> — повтор сегмента по новой регистрации; голый text:<отпечаток шаблона> (отправка без ярлыка и продолжения до 16.09.2026); registration:<заказ> (приветствие регистранта); legacy:welcome (право, восстановленное за период до появления журнала). Человеку называй mailingName и дату.',
-            'mailingName пуст у строк до 09.09.2026 — колонки тогда не было; это не потеря данных.',
-            'Ключ — человек ШКОЛЫ, поэтому история включает касания со ВСЕХ площадок воркспейса. Это и есть право: две площадки одной школы — один живой человек.',
-            'truncated=true — строк больше, чем поместилось; для разбора этого обычно достаточно, полная выгрузка сюда не помещается намеренно.',
-        ]),
-    }),
     defineTool({
         name: 'besales_getcourse_cold_welcome_preview',
         sideEffect: 'none',
@@ -146,47 +100,76 @@ export const getcourseColdWelcomeTools = [
             platform_id: uuidSchema,
             created_after: z.string().datetime({ offset: true }).optional(),
             contacts: z.array(contactSchema).min(1).max(MAX_CONTACTS).optional(),
+            continuation: continuationSchema,
             mailing_variant_id: uuidSchema.optional(),
             /**
-             * ⚠️⚠️ ИДЕНТИЧНОСТЬ КАСАНИЯ: метка сегмента и разовый текст. Ими считается прогноз правил
-             * отправки — «этим сегментом уже слали» ключуется меткой, «тот же текст не дважды»
-             * отпечатком шаблона. Без них прогноз молчит там, где старт ответит DUPLICATE.
+             * ⚠️⚠️ ИДЕНТИЧНОСТЬ КАСАНИЯ: сегмент и текст запуска — ими считается прогноз правил («этим сегментом
+             * уже слали», «тот же текст не дважды»). Передавай ровно те, с которыми пойдёт старт.
              */
             segment: z.string().max(LABEL_MAX_LENGTH).optional(),
             message: z.string().max(MESSAGE_MAX_LENGTH).optional(),
+            /**
+             * ⚠️⚠️ Продукт запуска — тот же, что пойдёт в старт: им предохранитель сверяет оплату и живую заявку.
+             * Без него прогноз судил бы «продукт неизвестен» и показал бы охват, которого у запуска с продуктом не будет.
+             */
+            product_code: z.string().max(LABEL_MAX_LENGTH).optional(),
             channels: z.array(getcourseTransportEnum).optional(),
             channels_mode: coldWelcomeChannelsModeEnum.optional(),
         })
             .strict()
             .refine((input) => (input.created_after !== undefined) !== (input.contacts !== undefined), {
-            message: 'Ровно одна аудитория: created_after (по дате) ЛИБО contacts (по файлу)',
-        }),
+            message: ONE_AUDIENCE,
+        })
+            .refine(continuationHasContacts, { message: CONTINUATION_AUDIENCE })
+            .refine(continuationHasText, { message: CONTINUATION_TEXT })
+            .refine((input) => input.continuation !== true ||
+            input.message === undefined ||
+            input.mailing_variant_id === undefined, { message: ONE_TEXT_SOURCE }),
         createRequest: (input) => ({
             method: 'POST',
             path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/preview`,
             body: compactObject({
-                platformId: input.platform_id,
+                channelId: input.platform_id,
                 createdAfter: input.created_after,
                 contacts: toContacts(input.contacts),
+                continuation: input.continuation,
                 mailingVariantId: input.mailing_variant_id,
                 segment: input.segment,
                 message: input.message,
-                channels: input.channels,
-                channelsMode: input.channels_mode,
+                productCode: input.product_code,
+                transports: input.channels,
+                transportsMode: input.channels_mode,
             }),
         }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'totalContacts — сколько ЕЩЁ может получить первое сообщение; alreadyWelcomed — сколько уже получали его раньше (оно одноразово НА КОНТАКТ, не на рассылку).',
-            '⚠️⚠️ Если задано ограничение каналов, ФАКТИЧЕСКИЙ охват = totalContacts − narrowedOutByChannels (доказанно отсечённые каналами). Называй пользователю именно эту разность: сырой totalContacts завысит обещание, а отправку не отозвать. channelsUnknown вычитать НЕ надо — у этих контактов привязки просто ещё не проверены, при отправке их спросят у школы живьём.',
-            `⚠️ channels_mode УСТАРЕЛ и на поведение НЕ влияет (с 23.08.2026). Список channels значит «слать сюда», а судьбу КАЖДОГО канала решает сервер: мессенджер (Telegram/VK/MAX) уходит, только если школа подтвердила его наличие у контакта; SMS — только при известном телефоне; Email, WhatsApp, Viber, Сайт, Chatium уходят вслепую всем выбранным. Просят «написать ещё и на почту» — добавь Email в channels, а мессенджеры перечисли явно, иначе уедет только письмо. Поле принимается ради обратной совместимости и игнорируется.`,
-            'channelsNotAllowedByPlatform — выбранные каналы, не включённые на площадке: они не уедут ни в каком режиме. Назови их пользователю, это чинится в настройках площадки, а не повтором запуска.',
-            'Для аудитории по файлу дополнительно приходят alreadyInDialog и notInBase: контакты предсписка обязаны быть импортированы (Шаг 1) до запуска.',
-            'Всегда показывай пользователю фактический охват и alreadyWelcomed ДО старта: отправку нельзя отозвать.',
-            'Часть контактов отсеется уже в прогоне (мьют бота, нет даты эфира, недостижимость, переменные без значения) — разбивка по причинам будет в outcomes задачи.',
-            '⚠️⚠️ policyForecast — ПРАВИЛА ОТПРАВКИ. blockedBy.alreadySentSegment — этим сегментом человеку уже уходило НАШЕЙ отправкой; blockedBy.alreadyGreeted — уже получал первое сообщение; blockedBy.activeEpisode — идёт приветствие по регистрации; blockedBy.cooldown — тихий период (пока не настраивается); touchClaimed — касание этого сегмента уже занято в журнале под другим именем либо тот же текст ушёл человеку другим сегментом меньше трёх суток назад (только у продолжения расписания; у ручного запуска 0). Причины взаимно исключают друг друга, поэтому сумма — это ЛЮДИ, а не срабатывания: называй пользователю сумму, разбор — только по запросу.',
-            '⚠️⚠️ policyForecast считается по МЕТКЕ и ТЕКСТУ. Без segment (и без message у запуска разовым текстом) правила молча дают нули — передавай в preview ровно те segment/message, с которыми пойдёт старт.',
-            '⚠️ policyForecast.externalWaveTouched — ИНФОРМАЦИЯ, а не запрет: этим ярлыком человека рассылала школа своими процессами (или WABA-волна), и наш догон в мессенджерах уйдёт как обычно. В отсев это число НЕ входит.',
-            '⚠️ Прогноз — на МОМЕНТ ЗАПРОСА. Блокирует сама отправка: она пересчитывает правила постранично вплотную к транспорту, поэтому итог в outcomes может отличаться (SKIPPED_ALREADY_SENT_SEGMENT, SKIPPED_ACTIVE_EPISODE, SKIPPED_SESSION_AHEAD).',
+        enhanceResponse: (response, input) => withInstructions(response, [
+            ...(input.continuation === true ? continuationPreviewHints(response) : []),
+            input.continuation === true
+                ? 'Ничего не отправляет и ничего не пишет. Для продолжения нужен ровно один источник текста: message либо mailing_variant_id с выбранным непустым текстом и сегментом. Отсутствие или пробельный текст, вариант без выбранного текста или сегмента — ошибка: исправь текст/сегмент до запуска.'
+                : 'Ничего не отправляет и ничего не пишет. В предпросмотре message может переопределять текст mailing_variant_id; настройки рассылки при этом сохраняются. У запуска выбери ровно один источник текста.',
+            ...(input.continuation === true
+                ? []
+                : [
+                    '⚠️ Текст предпросмотру не обязателен: без message и mailing_variant_id (или когда у рассылки нет текста для сегмента запуска) охват считается без проверок текста, textSource: null, а warnings[] с code TEXT_CHECKS_SKIPPED словами называет причину. Скажи пользователю, что запуск без текста не начнётся: нужен текст или рассылка с текстом для этого сегмента.',
+                    'totalContacts — сколько ЕЩЁ может получить первое сообщение; alreadyWelcomed — сколько уже получали его раньше (оно одноразово НА ЧЕЛОВЕКА, не на рассылку); foundContacts — сколько нашлось всего.',
+                    '⚠️⚠️ ФАКТИЧЕСКИЙ охват = totalContacts − narrowedOutByChannels (доказанно недостижимые выбранными каналами). Называй пользователю именно эту разность: сырой totalContacts завысит обещание, а отправку не отозвать. channelsUnknown всегда 0: отправка школу не переспрашивает.',
+                ]),
+            CHANNELS_MODE_DEPRECATED,
+            'transportsNotAllowedByChannel — выбранные каналы, не включённые у канала GetCourse: они не уедут ни в каком случае. Назови их пользователю, это чинится в настройках канала, а не повтором запуска.',
+            'segment и textSource — какой сегмент (в том числе сегмент рассылки по умолчанию) и какой текст уйдут: разовый (MESSAGE), текст сегмента у рассылки (SEGMENT) или общий текст рассылки (DEFAULT); null — текста нет (причина — в warnings). Назови их пользователю ДО подтверждения.',
+            'alreadyInDialog — разговор с человеком уже идёт; blockedByContact — состояние человека запрещает писать (удалён, заблокирован, отказался, у менеджера, бот заглушён) по исходу. Для аудитории по файлу дополнительно приходят notInBase (человека нет на канале: импортируй его до запуска), invalidRows, duplicateRows, rowsWithoutSegmentEntry и rowsWithoutRegistration.',
+            '⚠️⚠️ guardForecast — ПРЕДОХРАНИТЕЛЬ: blockedBy — сколько людей он остановит по правилу (идёт вебинарная серия, действующая заявка, оплатил продукт; guardUnverified — проверить было нечем), warned — правило в режиме «предупреждать» сработало, отправка пойдёт; unverifiedCause — почему проверить не смогли. Заявки и оплаты судятся после contacts[].registered_at, если он передан, иначе за всю историю человека.',
+            '⚠️⚠️ product_code передавай ТОТ ЖЕ, с которым пойдёт besales_getcourse_cold_welcome_start: им предохранитель сверяет оплату и живую заявку (заявка держит только отправку своего продукта). Не передан — берётся продукт рассылки по умолчанию; нет и его — продукт неизвестен, и прогноз назовёт заблокированными людей, которых запуск с продуктом пропустил бы.',
+            'Часть людей отсеется только в прогоне: нет даты эфира календарной цепочки, переменные текста без значения — разбивка будет в outcomes задачи.',
+            ...(input.continuation === true
+                ? [
+                    'policyForecast — правила отправки: alreadySentSegment — этот текст этим сегментом уже отправлен; activeEpisode — идёт приветствие по регистрации; cooldown — тихий период. Причины взаимно исключают друг друга: сумма — люди, а не срабатывания.',
+                ]
+                : [
+                    '⚠️⚠️ policyForecast — ПРАВИЛА ОТПРАВКИ. blockedBy.alreadySentSegment — этим сегментом человеку уже уходило НАШЕЙ отправкой; blockedBy.alreadyGreeted — уже получал первое сообщение; blockedBy.activeEpisode — идёт приветствие по регистрации; blockedBy.resendPause — пауза повтора сегмента (только у расписания); blockedBy.cooldown — тихий период; touchClaimed — касание этого сегмента уже занято (только у продолжения расписания; у ручного запуска 0). Причины взаимно исключают друг друга, поэтому сумма — это ЛЮДИ, а не срабатывания: называй пользователю сумму, разбор — только по запросу.',
+                ]),
+            '⚠️ policyForecast.externalWaveTouched — ИНФОРМАЦИЯ, а не запрет: этим сегментом человека рассылала школа своими процессами, и наш догон в мессенджерах уйдёт как обычно. В отсев это число НЕ входит.',
+            'warnings — предупреждения словами, с кодом: TEXT_CHECKS_SKIPPED — текста нет, охват посчитан без проверок текста (почему — в message); ENTRY_VARIABLE_NOT_IN_FIELD_MAP — переменная входа календарной цепочки не в карте полей сделки: первое сообщение уйдёт, а цепочка человека не подхватит. Назови их пользователю до запуска.',
+            '⚠️ Прогноз — на МОМЕНТ ЗАПРОСА. Блокирует сама отправка: она пересчитывает правила постранично вплотную к транспорту, поэтому итог в outcomes может отличаться.',
         ]),
     }),
     defineTool({
@@ -201,39 +184,39 @@ export const getcourseColdWelcomeTools = [
             platform_id: uuidSchema.optional(),
             created_after: z.string().datetime({ offset: true }).optional(),
             contacts: z.array(contactSchema).min(1).max(MAX_CONTACTS).optional(),
-            deal_fields: z
-                .record(z.string().regex(/^\d+$/, 'Ключ deal_fields обязан быть числовым fieldId GetCourse'), z.union([z.string(), z.number(), z.boolean(), z.null()]))
-                .optional(),
+            continuation: continuationSchema,
+            deal_fields: dealFieldsSchema.optional(),
             message: z.string().trim().min(1).max(MESSAGE_MAX_LENGTH).optional(),
             mailing_variant_id: uuidSchema.optional(),
             segment: z.string().max(LABEL_MAX_LENGTH).optional(),
             product_code: z.string().max(LABEL_MAX_LENGTH).optional(),
-            /**
-             * ⚠️⚠️ Воронка ШКОЛЫ («f11 — ДБО / NR / ВК / In Stream»), а НЕ когорта. Тип отбора идёт
-             * в `segment`, продукт в `product_code`, подпись запуска в `cohort_label`. Текст правила
-             * живёт в описании поля (`mcp-tools.json`) — его читает агент; здесь напоминание для
-             * того, кто правит схему.
-             */
+            /** Воронка ШКОЛЫ («f11 — ДБО / NR / ВК / In Stream»), а НЕ когорта: текст правила — в описании поля. */
             funnel: z.string().max(LABEL_MAX_LENGTH).optional(),
             cohort_label: z.string().max(LABEL_MAX_LENGTH).optional(),
             channels: z.array(getcourseTransportEnum).optional(),
             channels_mode: coldWelcomeChannelsModeEnum.optional(),
             explicit_confirmation: z.literal(true),
+            idempotency_key: uuidSchema
+                .describe('UUID намерения: сохрани до отправки с подтверждёнными файлом и текстом. Повтор того же запуска — с тем же ключом; новый подтверждённый запуск — с новым. Передаётся заголовком Idempotency-Key.')
+                .optional(),
         })
             .strict()
             .refine((input) => (input.message !== undefined) !== (input.mailing_variant_id !== undefined), {
-            message: 'Ровно один источник текста: message (разовый) ЛИБО mailing_variant_id (сохранённая рассылка)',
+            message: ONE_TEXT_SOURCE,
         })
             .refine((input) => (input.created_after !== undefined) !== (input.contacts !== undefined), {
-            message: 'Ровно одна аудитория: created_after (по дате) ЛИБО contacts (по файлу)',
-        }),
+            message: ONE_AUDIENCE,
+        })
+            .refine(continuationHasContacts, { message: CONTINUATION_AUDIENCE }),
         createRequest: (input) => ({
             method: 'POST',
             path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome`,
+            ...(input.idempotency_key === undefined ? {} : { idempotencyKey: input.idempotency_key }),
             body: compactObject({
-                platformId: input.platform_id,
+                channelId: input.platform_id,
                 createdAfter: input.created_after,
                 contacts: toContacts(input.contacts),
+                continuation: input.continuation,
                 dealFields: input.deal_fields,
                 message: input.message,
                 mailingVariantId: input.mailing_variant_id,
@@ -241,23 +224,30 @@ export const getcourseColdWelcomeTools = [
                 productCode: input.product_code,
                 funnel: input.funnel,
                 cohortLabel: input.cohort_label,
-                channels: input.channels,
-                channelsMode: input.channels_mode,
+                transports: input.channels,
+                transportsMode: input.channels_mode,
+                explicitConfirmation: input.explicit_confirmation,
             }),
         }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'Рассылка запущена фоном: опрашивай besales_getcourse_contact_import_status по jobId каждые 10–30 секунд до COMPLETED, PARTIAL или FAILED; прогресс и разбивка исходов живут в этой задаче импорта.',
-            'cohort_label — имя ЭТОГО запуска в «Аналитике рассылок». Задавай его на каждом запуске: без него разрез «по запускам» различает их только датой, а два запуска одной рассылки за день сольются в одну подпись.',
+        enhanceResponse: (response, input) => withInstructions(response, [
+            'Сохрани idempotency_key вместе с подтверждёнными параметрами. При неизвестном исходе сверяй статус и повторяй только тот же запуск с тем же ключом, не создавай новое намерение автоматически.',
+            'Рассылка запущена фоном: опрашивай besales_getcourse_contact_import_status по jobId каждые 10–30 секунд до COMPLETED, PARTIAL или FAILED; прогресс, разбивка исходов (outcomes), отправленные «вслепую» и штамп полей сделки (dealStamp) живут в этой задаче. Запуск идёт пакетом из одного сегмента: batchId — его пакет, ход виден и через besales_getcourse_cold_welcome_batch_status.',
+            'policyForecast — прогноз правил на момент старта; null — прогноз не посчитался (отказ чтения), запуск при этом идёт. null НЕ значит «никого не заблокировали».',
+            'cohort_label — имя ЭТОГО запуска в «Аналитике рассылок». Задавай его на каждом запуске: без него разрез «по запускам» различает их только датой.',
             'Текст заморожен снимком: правка рассылки НЕ меняет идущий запуск.',
-            'Если у рассылки заданы message_text_by_segment и segment совпал — уедет ТЕКСТ СЕГМЕНТА. Назови пользователю, какой текст выбран, ДО подтверждения: отправку не отозвать.',
-            '⚠️ Метка segment аудиторию НЕ отбирает. Поэтому посегментный текст разрешён только с contacts (файл): с created_after он ушёл бы ВСЕЙ когорте после даты и выжег бы отметку приветствия — второй сегмент получил бы нулевой охват. Такой запуск отвергается 400.',
-            'Повторный запуск по той же границе безопасен: уже получившие первое сообщение не получат второе.',
+            'Если у рассылки заданы тексты по сегментам и segment совпал — уедет ТЕКСТ СЕГМЕНТА. Назови пользователю, какой текст выбран, ДО подтверждения: отправку не отозвать.',
+            '⚠️ Сегмент аудиторию НЕ отбирает. Поэтому посегментный текст разрешён только с contacts (файл): с created_after он ушёл бы ВСЕЙ когорте после даты. Такой запуск отвергается 400.',
+            input.continuation === true
+                ? 'Продолжение поставлено в очередь. alreadyWelcomed — справка; тот же текст тому же сегменту повторно не уйдёт. Прогноз и постановка не доказывают доставку: итог — в статусе задачи.'
+                : 'Повторный запуск по той же границе безопасен: уже получившие первое сообщение не получат второе.',
             'platform_id и deal_fields можно опустить, если они заданы в рассылке как «по умолчанию» — сервер подставит их сам.',
-            'Пустой объект deal_fields — НЕ то же, что отсутствие ключа: он означает «на этом запуске без полей» и гасит дефолты рассылки.',
-            `⚠️ channels_mode УСТАРЕЛ и на поведение НЕ влияет (с 23.08.2026). Список channels значит «слать сюда», а судьбу КАЖДОГО канала решает сервер: мессенджер (Telegram/VK/MAX) уходит, только если школа подтвердила его наличие у контакта; SMS — только при известном телефоне; Email, WhatsApp, Viber, Сайт, Chatium уходят вслепую всем выбранным. Просят «написать ещё и на почту» — добавь Email в channels, а мессенджеры перечисли явно, иначе уедет только письмо. Поле принимается ради обратной совместимости и игнорируется.`,
-            'deal_fields штампуются ПОСЛЕ успешной отправки (пин из строки файла, иначе закреплённая сделка контакта); их отказ не отменяет отправку и виден счётчиком dealStamp.',
-            'contacts[].segment_entered_at — точный ISO-момент (с зоной) входа человека в когорту; на нём считается свежесть в «Аналитике рассылок». Передавай его, когда предсписок собран ПРАВИЛОМ и у каждой строки есть свой момент события. ⚠️ Дату запуска подставлять НЕЛЬЗЯ: разброс возраста бывает от часа до 294 дней, и общий момент схлопнул бы месяцы когорт в одну.',
-            'Контакт, у которого переменная текста осталась без значения, ПРОПУСКАЕТСЯ (outcome SKIPPED_UNRESOLVED_VARS) — сырые {скобки} живому человеку не уедут. Отметка приветствия при этом не сгорает: проставьте значение или перезапись у агента и запустите повторно, контакт доберётся.',
+            'Пустой объект deal_fields — НЕ то же, что отсутствие ключа: он означает «на этом запуске без полей» и гасит умолчания рассылки.',
+            CHANNELS_MODE_DEPRECATED,
+            'deal_fields штампуются ПОСЛЕ успешной отправки (пин из строки файла, иначе сделка человека); их отказ не отменяет отправку и виден счётчиком dealStamp в besales_getcourse_contact_import_status.',
+            'contacts[].segment_entered_at — точный ISO-момент (с зоной) входа человека в когорту; на нём считается свежесть в «Аналитике рассылок». ⚠️ Дату запуска подставлять НЕЛЬЗЯ.',
+            GUARD_INSTRUCTION,
+            GUARD_PAID_NEEDS_PRODUCT,
+            'Человек, у которого переменная текста осталась без значения, ПРОПУСКАЕТСЯ (outcome SKIPPED_UNRESOLVED_VARS) — сырые {скобки} живому человеку не уедут. Отметка приветствия при этом не сгорает: проставь значение и запусти повторно, человек доберётся.',
         ]),
     }),
     defineTool({
@@ -280,19 +270,14 @@ export const getcourseColdWelcomeTools = [
                 product_code: z.string().max(LABEL_MAX_LENGTH).optional(),
                 funnel: z.string().max(LABEL_MAX_LENGTH).optional(),
                 cohort_label: z.string().max(LABEL_MAX_LENGTH).optional(),
-                deal_fields: z
-                    .record(z
-                    .string()
-                    .regex(/^\d+$/, 'Ключ deal_fields обязан быть числовым fieldId GetCourse'), z.union([z.string(), z.number(), z.boolean(), z.null()]))
-                    .optional(),
+                deal_fields: dealFieldsSchema.optional(),
                 contacts: z.array(contactSchema).min(1).max(MAX_CONTACTS),
             })
                 .strict())
                 .min(1)
                 .max(MAX_BATCH_SEGMENTS),
-            // Перекрытие предохранителей на ЭТОТ пакет. Не передано — настройки площадки.
-            // Ослабление здесь — аварийный обход одной отправки; постоянное решение принимается
-            // в настройках площадки, чтобы его было видно всем, а не только автору вызова.
+            // Перекрытие предохранителей на ЭТОТ пакет. Не передано — настройки канала. Ослабление здесь —
+            // аварийный обход одной отправки; постоянное решение принимается в настройках канала.
             guards: z
                 .object({
                 active_series: guardModeEnum.optional(),
@@ -304,18 +289,16 @@ export const getcourseColdWelcomeTools = [
             explicit_confirmation: z.literal(true),
         })
             .strict()
-            .refine((input) => (input.message !== undefined) !== (input.mailing_variant_id !== undefined), {
-            message: 'Ровно один источник текста: message (разовый) ЛИБО mailing_variant_id (сохранённая рассылка)',
-        }),
+            .refine((input) => (input.message !== undefined) !== (input.mailing_variant_id !== undefined), { message: ONE_TEXT_SOURCE }),
         createRequest: (input) => ({
             method: 'POST',
             path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/batch`,
             body: compactObject({
-                platformId: input.platform_id,
+                channelId: input.platform_id,
                 message: input.message,
                 mailingVariantId: input.mailing_variant_id,
-                channels: input.channels,
-                channelsMode: input.channels_mode,
+                transports: input.channels,
+                transportsMode: input.channels_mode,
                 segments: input.segments.map((segment) => compactObject({
                     segment: segment.segment,
                     productCode: segment.product_code,
@@ -331,24 +314,24 @@ export const getcourseColdWelcomeTools = [
                         paid: input.guards.paid,
                     })
                     : undefined,
+                explicitConfirmation: input.explicit_confirmation,
             }),
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Пакет: несколько сегментов одним вызовом, у каждого свой список контактов, свои метки и свои поля сделки.',
-            'cohort_label задаётся ПОСЕГМЕНТНО: каждый сегмент — отдельный запуск со своей задачей и когортой, и общая на пакет подпись схлопнула бы их в отчёте в одну корзину.',
-            'Сегменты идут ПО ОЧЕРЕДИ — задачи импорта не могут выполняться параллельно. Прогресс смотри через besales_getcourse_cold_welcome_batch_status по batchId; о ЗАВЕРШЕНИИ пакета платформа доложит сама в чат уведомлений воркспейса, поэтому опрашивать в цикле не нужно.',
-            'contacts[].segment_entered_at — точный ISO-момент (с зоной) входа человека в когорту; на нём считается свежесть в «Аналитике рассылок». Передавай его посегментно, когда предсписок собран ПРАВИЛОМ и у каждой строки есть свой момент события. ⚠️ Дату запуска подставлять НЕЛЬЗЯ: разброс возраста бывает от часа до 294 дней, и общий момент схлопнул бы месяцы когорт в одну.',
-            'Весь пакет проверяется ДО первой отправки: сегмент без текста ИЛИ текст с переменными, которые не подставляются его контактам, отменяет пакет целиком, пока никому ничего не ушло. В ошибке названы сами переменные, контакт проверки и агент — чинить надо значение переменной или перезапись у этого агента.',
-            '⚠️ Проверка переменных на плане ВЫБОРОЧНАЯ (несколько контактов сегмента) и не гарантирует, что подставится всем: агента выбирает роутер по контакту. Полноту держит гейт на самой отправке — контакт с сырыми скобками пропускается с outcome SKIPPED_UNRESOLVED_VARS.',
-            '⚠️ Переменные, которые отправка дочитывает из сделки (календарные поля замапленной площадки), план НЕ проверяет — судить по до-синковому снимку значило бы блокировать каждый пакет календарной площадки. Все остальные проверяются. Если пакет упал на календарной переменной — это баг, а не настройка.',
+            'Пакет: несколько сегментов одним вызовом, у каждого свой список людей, свои метки и свои поля сделки.',
+            'cohort_label задаётся ПОСЕГМЕНТНО: каждый сегмент — отдельный запуск со своей задачей и когортой.',
+            'Сегменты идут ПО ОЧЕРЕДИ. Прогресс смотри через besales_getcourse_cold_welcome_batch_status по batchId; о ЗАВЕРШЕНИИ пакета платформа доложит сама в чат уведомлений пространства, поэтому опрашивать в цикле не нужно.',
+            'contacts[].segment_entered_at — точный ISO-момент (с зоной) входа человека в когорту; передавай его посегментно, когда предсписок собран ПРАВИЛОМ. ⚠️ Дату запуска подставлять НЕЛЬЗЯ.',
+            'Весь пакет проверяется ДО первой отправки: сегмент без текста ИЛИ текст с переменными, которые не подставляются его людям, отменяет пакет целиком, пока никому ничего не ушло. В ошибке названы сегмент и сами переменные: чинить надо значение переменной.',
+            '⚠️ Проверка переменных на плане ВЫБОРОЧНАЯ (несколько человек сегмента) и не гарантирует, что подставится всем. Полноту держит гейт на самой отправке — человек с сырыми скобками пропускается с outcome SKIPPED_UNRESOLVED_VARS. Имена, которые отправка дочитает из закреплённой сделки, план у человека с закреплённой сделкой не проверяет.',
             'Отказ одного сегмента НЕ останавливает остальные — смотри разбивку в статусе.',
-            'ПРЕДОХРАНИТЕЛИ. Перед отправкой каждый контакт проверяется по фактам школы: идёт ли у него вебинарная серия, есть ли действующая заявка (работает менеджер), оплачен ли этот продукт. Заявка держит только отправку своего продукта. Заявки и оплаты судятся только после регистрации, по которой человек попал в сегмент: у авторассылки — когда момент регистрации известен, у ручного запуска — если в contacts[].registered_at передан именно момент этой регистрации (не segment_entered_at и не «созрел с»: у reg-no-show и postweb они на дни позже, и заявка или оплата во время серии выпала бы из правила), иначе за всю историю человека. Исходы: SKIPPED_ACTIVE_SERIES, SKIPPED_ACTIVE_DEAL, SKIPPED_GUARD_UNAVAILABLE.',
-            '⚠️ Правило серии видит только тех, кто ДЕЙСТВИТЕЛЬНО смотрел эфиры: серии школы строятся из фактов посещения. Зарегистрировавшийся и не пришедший под это правило не попадает — это не пробел проверки, а граница данных.',
-            '⚠️ Правило оплаты сверяет продукт запуска с оплаченными. Если у пакета не задан product_code, а у контакта есть оплата, отправка пропускается с SKIPPED_GUARD_UNAVAILABLE («сверять не с чем») — это чинится повторным запуском с продуктом, а не считается работой менеджера.',
-            '⚠️ Блокировка по серии — это ОТСРОЧКА, а не потеря: серия кончится, и контакт станет доступен следующему запуску (замер: из 55 контактов сегодня проходят 10, завтра 39, через трое суток 47). Не пытайся обойти гейт, чтобы «добрать объём».',
-            '⚠️ Поле guards ослабляет проверку на ОДИН пакет и предназначено для аварийного обхода. Постоянное решение принимается в настройках площадки (besales_platform_settings_update) — там его видно всей команде, а не только автору вызова.',
-            '⚠️⚠️ policyForecast — прогноз ПРАВИЛ ОТПРАВКИ ПОСЕГМЕНТНО: сколько людей блока не пропустят «этим сегментом уже слали», «уже получал первое сообщение», «идёт приветствие по регистрации», «эфир ещё не прошёл», тихий период и «тот же текст». Показывай пользователю сумму по блокам сразу после запуска: у пакета отдельного предпросмотра нет, и это единственные числа правил, которые он увидит.',
+            GUARD_INSTRUCTION,
+            GUARD_SERIES_IS_DEFERRAL,
+            GUARD_PAID_NEEDS_PRODUCT,
+            '⚠️ Поле guards ослабляет проверку на ОДИН пакет и предназначено для аварийного обхода; оно сохраняется в план и переживает возобновление. Постоянное решение принимается в настройках канала (besales_platform_settings_update, getcourse_settings.guard_*) — там его видно всей команде.',
+            '⚠️⚠️ policyForecast — прогноз ПРАВИЛ ОТПРАВКИ ПОСЕГМЕНТНО (segment — сегмент блока): сколько людей блока не пропустят «этим сегментом уже слали», «уже получал первое сообщение», «идёт приветствие по регистрации», тихий период. Показывай пользователю сумму по блокам сразу после запуска.',
             '⚠️ policyForecast — best-effort: ПУСТОЙ массив значит «прогноз не посчитался» (отказ чтения), а НЕ «никого не заблокировали». Пакет при этом идёт. Нужны надёжные числа до запуска — сделай besales_getcourse_cold_welcome_preview на каждый блок с его segment.',
+            '⚠️ 409 «в пространстве уже идёт пакет „Первого сообщения“» — не сбой: дождись его (besales_getcourse_cold_welcome_batch_status) или отмени. Людям при таком отказе ничего не ушло.',
         ]),
     }),
     defineTool({
@@ -356,21 +339,19 @@ export const getcourseColdWelcomeTools = [
         sideEffect: 'none',
         requiredFields: ['batch_id'],
         defaultWorkspaceId: true,
-        schema: z
-            .object({ workspace_id: uuidSchema.optional(), batch_id: uuidSchema })
-            .strict(),
+        schema: z.object({ workspace_id: uuidSchema.optional(), batch_id: uuidSchema }).strict(),
         createRequest: (input) => ({
             method: 'GET',
             path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/batch/${input.batch_id}`,
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'state — агрегат по пакету, segments[] — разбивка: у каждого свой статус, свой importJobId и своя причина отказа.',
-            'completedAt — момент, когда закрылись ВСЕ сегменты; null означает «пакет ещё идёт». Это и есть ответ на вопрос «закончилось ли»: лезть в import_jobs и chat_users не нужно.',
-            'summary — план, ДОКАЗАННЫЕ доставки (строки реестра рассылок) и слитая разбивка исходов; у каждого сегмента те же delivered/outcomes. SKIPPED_UNRESOLVED_VARS означает «переменные текста без значения»: такие контакты не приветствованы и доберутся повторным запуском. SKIPPED_RESEND_PAUSE бывает только у пакета расписания: повтор сегмента по новой регистрации разрешён, но пауза после прошлой отправки этого сегмента ещё идёт — человек вернётся к одному из следующих запусков сам.',
+            'state — агрегат по пакету, segments[] — разбивка: у каждого свой статус, свой importJobId и своя причина отказа (error — словами).',
+            'completedAt — момент, когда закрылись ВСЕ сегменты; null означает «пакет ещё идёт». Это и есть ответ на вопрос «закончилось ли».',
+            'summary — план, ДОКАЗАННЫЕ доставки и слитая разбивка исходов; у каждого сегмента те же delivered/outcomes; sentWithoutChannelEvidence — отправлено «вслепую» (без доказательства, что человек есть в этом канале). SKIPPED_UNRESOLVED_VARS означает «переменные текста без значения»: такие люди не приветствованы и доберутся повторным запуском. SKIPPED_RESEND_PAUSE бывает только у пакета расписания.',
             '⚠️ summary.segmentsWithoutOutcomes > 0 — у стольких сегментов прогон оборвался, не записав итог: их исходы в разбивку НЕ вошли, и судить о них можно только по delivered. outcomes=null у сегмента значит ровно это, а НЕ «все нули».',
-            '⚠️ Опрашивать в цикле не нужно: о завершении пакета и о его обрыве платформа сама докладывает в чат уведомлений воркспейса (там же batchId, доставлено/из скольких и разбивка исходов). Оборванный пакет крон-подметатель находит сам в пределах ~15 минут и освобождает задачу импорта, чтобы воркспейс не оставался заблокированным.',
-            'stalled=true означает, что драйвер оборвался (рестарт инстанса). НЕ запускай пакет заново — зови besales_getcourse_cold_welcome_batch_resume по тому же batch_id: источник текста хранится в плане, пересобирать списки не нужно, а уже отправленным контактам повтор не уйдёт (приветствие одноразово НА КОНТАКТ).',
-            '⚠️ Исключение — пакет, который запустило РАСПИСАНИЕ: resume ответит 409 «собран расписанием». Не повторяй вызов: неначатые сегменты такого пакета подметатель гасит сам (через 10–15 минут после обрыва), а их люди уйдут следующим запуском расписания.',
+            '⚠️ Опрашивать в цикле не нужно: о завершении пакета и о его обрыве платформа сама докладывает в чат уведомлений пространства. Оборванный пакет подметатель находит сам в пределах ~15 минут и освобождает задачу импорта.',
+            'stalled=true означает, что исполнитель пакета оборвался (перезапуск сервиса). НЕ запускай пакет заново — зови besales_getcourse_cold_welcome_batch_resume по тому же batch_id: план хранится на сервере, пересобирать списки не нужно, а уже отправленным людям повтор не уйдёт.',
+            '⚠️ Исключение — пакет, который собрало РАСПИСАНИЕ (origin = SCHEDULE): resume ответит 409. Не повторяй вызов: не начатые сегменты такого пакета подметатель гасит сам, а их люди уйдут следующим запуском расписания.',
         ]),
     }),
     defineTool({
@@ -378,16 +359,15 @@ export const getcourseColdWelcomeTools = [
         sideEffect: 'spend',
         requiredFields: ['batch_id'],
         defaultWorkspaceId: true,
-        schema: z
-            .object({ workspace_id: uuidSchema.optional(), batch_id: uuidSchema })
-            .strict(),
+        schema: z.object({ workspace_id: uuidSchema.optional(), batch_id: uuidSchema }).strict(),
         createRequest: (input) => ({
             method: 'POST',
             path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/batch/${input.batch_id}/resume`,
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Поднимает драйвер для НЕ НАЧАТЫХ сегментов пакета. Подтверждения не требует: повтора отправки не будет — приветствие одноразово НА КОНТАКТ, а уже начатые сегменты не перезапускаются.',
-            '⚠️ Пакет, собранный РАСПИСАНИЕМ, вручную не возобновляется — 409 «собран расписанием». Это не сбой: владелец его остатка — прогон расписания, неначатые сегменты гасит подметатель, а людей возвращает в пул следующий запуск. Не повторяй вызов и не запускай пакет заново руками.',
+            'Поднимает исполнителя для НЕ НАЧАТЫХ сегментов оборвавшегося пакета. Подтверждения не требует: повтора отправки не будет — приветствие одноразово НА ЧЕЛОВЕКА, а оборвавшийся идущий сегмент не переигрывается.',
+            '⚠️ Пакет, собранный РАСПИСАНИЕМ, вручную не возобновляется — 409. Это не сбой: владелец его остатка — прогон расписания. Не повторяй вызов и не запускай пакет заново руками.',
+            '⚠️ 409 «пакет не оборвался» — возобновлять нечего: пакет идёт сам.',
         ]),
     }),
     defineTool({
@@ -407,7 +387,7 @@ export const getcourseColdWelcomeTools = [
             path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/batch/${input.batch_id}/cancel`,
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Отменяет ОСТАТОК пакета: не начатые сегменты и идущую задачу. Уже отправленное не отзывается.',
+            'Отменяет ОСТАТОК пакета: не начатые сегменты и идущий сегмент. Уже отправленное не отзывается.',
         ]),
     }),
     defineTool({
@@ -426,61 +406,7 @@ export const getcourseColdWelcomeTools = [
             path: `/workspaces/${input.workspace_id}/getcourse-cold-welcome/${input.job_id}/cancel`,
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Останавливает ОСТАТОК когорты в пределах ~10 секунд; уже отправленное не отзывается.',
-        ]),
-    }),
-    defineTool({
-        name: 'besales_getcourse_contacts_import',
-        sideEffect: 'write',
-        verifyWithToolName: 'besales_getcourse_contact_import_status',
-        requiredFields: ['platform_id', 'contacts'],
-        defaultWorkspaceId: true,
-        schema: z
-            .object({
-            workspace_id: uuidSchema.optional(),
-            platform_id: uuidSchema,
-            contacts: z.array(importContactSchema).min(1).max(MAX_CONTACTS),
-            check_messenger_presence: z.boolean().optional(),
-        })
-            .strict(),
-        createRequest: (input) => ({
-            method: 'POST',
-            path: `/workspaces/${input.workspace_id}/chat-users/import/getcourse-contacts`,
-            body: compactObject({
-                platformId: input.platform_id,
-                contacts: input.contacts,
-                checkMessengerPresence: input.check_messenger_presence,
-            }),
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'НИЧЕГО НЕ ОТПРАВЛЯЕТ: заводит или обновляет контакты в базе платформы, чтобы по ним можно было запускать «Нашу отправку». Матчинг существующих — по contact_id (getcourse_user_id).',
-            'Импорт нужен ровно тогда, когда preview показал notInBase > 0: отправке нужен ChatUser, иначе контакт получает исход SKIPPED_NOT_IN_BASE и остаётся без сообщения.',
-            'Идёт фоном — вернувшийся jobId опрашивай через besales_getcourse_contact_import_status каждые 10–30 секунд до COMPLETED, PARTIAL или FAILED; отвечает сразу, а не по завершении.',
-            '⚠️ Гейт «один активный импорт на воркспейс» общий с волнами и пакетами: 409 означает «идёт другой импорт», а не сбой — дождись его и повтори.',
-            '⚠️ first_name прямо влияет на текст: обращение подставляется системным {greeting}, и у контакта без имени обращения не будет вовсе. Передавай имя, если оно есть в источнике.',
-            'check_messenger_presence по умолчанию включён и отсеивает контакты без Telegram/MAX/VK. Это API-вызов на КАЖДЫЙ контакт, поэтому на тысячах строк импорт идёт заметно дольше.',
-            'Повторный импорт того же списка безопасен: существующий контакт обновляется, второй не создаётся.',
-        ]),
-    }),
-    defineTool({
-        name: 'besales_getcourse_contact_import_status',
-        sideEffect: 'none',
-        requiredFields: ['job_id'],
-        defaultWorkspaceId: true,
-        schema: z
-            .object({
-            workspace_id: uuidSchema.optional(),
-            job_id: uuidSchema,
-        })
-            .strict(),
-        createRequest: (input) => ({
-            method: 'GET',
-            path: `/workspaces/${input.workspace_id}/getcourse-contact-imports/${input.job_id}`,
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'Опрашивай каждые 10–30 секунд до terminal state: COMPLETED, PARTIAL или FAILED.',
-            'PARTIAL означает, что часть контактов записана, а часть завершилась ошибками; сверяй successCount, failedCount и errors перед следующим шагом.',
-            'Отмены нет: импорт пишет контакты по мере обработки. Повтор того же списка безопасен — существующие карточки обновятся без дублей.',
+            'Останавливает ОСТАТОК аудитории в пределах ~10 секунд; уже отправленное не отзывается. 409 — запуск уже завершён, останавливать нечего.',
         ]),
     }),
 ];