@besales/mcp 0.48.0 → 1.0.0-beta.4

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

@@ -1,14 +1,32 @@
-// Read-only данные раздела «Аналитика коммуникации» (/communication-analytics), режим
-// «Исходящие». Не пересчитывать эти показатели по сообщениям:
+// Read-only агрегаты страницы /broadcast-analytics. Не пересчитывать эти показатели по сообщениям:
 // backend уже держит когортную атрибуцию, delivery-гейт и дедуп событий между соседними волнами.
 import { z } from 'zod';
-import { defineTool, uuidSchema, withInstructions } from './shared.js';
-const calendarDateSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
-const filterValuesSchema = z.union([
-    z.string().min(1),
-    z.array(z.string().min(1)).min(1).max(50),
-]);
-const channelSchema = z.enum([
+import { MONEY_CURRENCY_INSTRUCTIONS, moneyCurrencySchema } from './money-currency.js';
+import { BROADCAST_REASON_FILTER_VALUES } from '../../shared/constants/broadcast-reason.constants.js';
+import { SCHEDULE_EXCLUSION_HINT, SCHEDULE_POOL_GROUPS_HINT } from './schedule-selection-hints.js';
+import { MAILING_VARIANT_CONTENT_INSTRUCTIONS, mailingVariantContentBody, mailingVariantContentShape, } from './mailing-variant-content.js';
+import { buildListQuery, compactObject, defineTool, uuidSchema, withInstructions, } from './shared.js';
+const calendarDateSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/).refine((value) => {
+    const date = new Date(value + 'T00:00:00.000Z');
+    return !Number.isNaN(date.getTime()) && date.toISOString().slice(0, 10) === value;
+}, 'Такой календарной даты не существует');
+/** Потолок отгруженной схемы: сузить его значит внести отказ там, где клиент уже пишет длиннее. */
+const MAILING_VARIANT_DESCRIPTION_MAX_LENGTH = 4000;
+const paymentCandidatePagination = {
+    minPage: 1,
+    defaultPage: 1,
+    minPageSize: 1,
+    defaultPageSize: 30,
+    maxPageSize: 100,
+};
+/**
+ * ⛔ Регистр значений каналов у сторон РАЗНЫЙ, и это не косметика: у приёмной стороны включён
+ * запрет незнакомых значений, поэтому семь из одиннадцати отгруженных названий дают отказ.
+ * Перевод живёт ЗДЕСЬ, в конструкторе запроса, — единственном месте, через которое проходят все
+ * отчёты из общего перечисления.
+ */
+// Этот набор сверяется с контрактом в wave-transports.spec.ts; трогая его, смотри туда.
+export const SHIPPED_CHANNELS = [
     'Site',
     'Email',
     'SMS',
@@ -20,278 +38,52 @@ const channelSchema = z.enum([
     'Viber',
     'MAX',
     'UNKNOWN',
-]);
-const preflightReasonSchema = z.enum([
-    'NO_MESSENGER',
-    'ACTIVE_INVOICE_SAME_PRODUCT',
-    'ACTIVE_DEAL_SAME_PRODUCT',
-    'PAID_SAME_PRODUCT',
-    'ACTIVE_DEAL_OTHER_PRODUCT',
-    'MANAGER_ASSIGNED_ACTIVE_DEAL',
-    'PRODUCT_CONTEXT_MISSING',
-    'GETCOURSE_CHECK_ERROR',
-    'ALREADY_SENT',
-    'USER_NOT_FOUND',
-]);
-const actionTypeSchema = z.string().min(1);
-const PAYMENT_CANDIDATES_MAX_PAGE_SIZE = 100;
-const analyticsReportSchema = z.enum([
-    'summary',
-    'cohorts',
-    'skip_reasons',
-    'recipients',
-    'deals',
-    'action_failures',
-    'indirect_payments',
-    'response_windows',
-    'insights',
-    'recent_leads',
-    'data_quality',
-    'segments_catalog',
-    'funnel_products',
-    'payment_candidates',
-    'payment_candidates_summary',
-]);
-const DRILLDOWN_REPORTS = new Set([
-    'recipients',
-    'deals',
-    'action_failures',
-    'indirect_payments',
-]);
-const PAGED_REPORTS = new Set([
-    ...DRILLDOWN_REPORTS,
-    'payment_candidates',
-]);
-const DATED_REPORTS = new Set([
-    ...DRILLDOWN_REPORTS,
-    'skip_reasons',
-]);
-const isPaymentReport = (report) => report === 'payment_candidates' || report === 'payment_candidates_summary';
-const isCatalogReport = (report) => report === 'segments_catalog' || report === 'funnel_products';
+];
+/** Шкала свежести базы — шесть корзин, как у сервера и у отгруженной копии моста. */
+const FRESHNESS_BUCKETS = ['0-7', '8-14', '15-30', '31-45', '46-60', '61+'];
+/**
+ * Источники «не отправлено» — те же, что у сервера (`reasonSource`). Без источника причина — код
+ * проверки перед волной, а поимённый список — проверка перед волной: прежний вход сохраняет смысл.
+ */
+export const SKIP_REASON_SOURCES = [
+    'WAVE_PREFLIGHT',
+    'WAVE_RUN',
+    'COLD_WELCOME',
+    'SCHEDULED_RUN',
+    'REGISTRATION_ANCHOR',
+];
+/** Значение ИЛИ массив значений — форма отгруженной схемы у всех фильтров-измерений. */
+const oneOrMany = (item) => z.union([item, z.array(item).min(1).max(50)]);
+const asArray = (value) => value === undefined ? [] : Array.isArray(value) ? value : [value];
+export const MECHANISMS = ['any', 'wave', 'cold_welcome'];
+export const LAUNCH_SOURCES = ['manual', 'registration', 'schedule'];
 const analyticsQueryFields = {
+    currency: moneyCurrencySchema.optional(),
+    mechanism: oneOrMany(z.enum(MECHANISMS)).optional(),
+    launch_source: oneOrMany(z.enum(LAUNCH_SOURCES)).optional(),
     workspace_id: uuidSchema.optional(),
     mode: z.enum(['all', 'days', 'range']).default('days'),
     days: z.number().int().min(1).optional(),
     from: calendarDateSchema.optional(),
     to: calendarDateSchema.optional(),
     platform_id: uuidSchema.optional(),
-    funnel: filterValuesSchema.optional(),
+    funnel: oneOrMany(z.string().min(1)).optional(),
     funnel_mode: z.literal('none').optional(),
-    segment: filterValuesSchema.optional(),
-    mailing_variant_id: z.union([uuidSchema, z.array(uuidSchema).min(1).max(50)]).optional(),
-    /**
-     * Механизм запуска. `wave` — доставляет процесс школы (мы штампуем поля сделки),
-     * `cold_welcome` — пишем первыми сами. Оба значения = фильтра нет.
-     */
-    mechanism: z
-        .union([z.enum(['wave', 'cold_welcome']), z.array(z.enum(['wave', 'cold_welcome'])).min(1).max(2)])
-        .optional(),
-    product: filterValuesSchema.optional(),
+    segment: oneOrMany(z.string().min(1)).optional(),
+    product: oneOrMany(z.string().min(1)).optional(),
     product_mode: z.literal('none').optional(),
-    freshness: z
-        .union([
-        z.enum(['0-7', '8-14', '15-30', '31-45', '46-60', '61+']),
-        z.array(z.enum(['0-7', '8-14', '15-30', '31-45', '46-60', '61+'])).min(1).max(6),
-    ])
-        .optional(),
-    channels: z.union([channelSchema, z.array(channelSchema).min(1).max(11)]).optional(),
-    /**
-     * `entry` — период по дате входа в сегмент (регистрация, конец серии, предсписок), а не по
-     * дате отправки. Строки без даты входа выпадают всегда, включая mode=all.
-     */
-    view: z.enum(['cohort', 'period', 'entry']).default('period'),
-};
-const analyticsToolSchema = z
-    .object({
-    ...analyticsQueryFields,
-    report: analyticsReportSchema.default('summary'),
-    date: calendarDateSchema.optional(),
-    channel: channelSchema.optional(),
-    import_job_id: z.string().min(1).optional(),
-    page: z.number().int().min(1).optional(),
-    page_size: z.number().int().min(1).max(200).optional(),
-    recipient_metric: z
-        .enum([
-        'sent',
-        'delivered',
-        'entered',
-        'deepDialog',
-        'handedOff',
-        'notDelivered',
-        'notSent',
-    ])
-        .optional(),
-    deal_metric: z.enum(['issued', 'paid', 'withoutCohort']).optional(),
-    reason: preflightReasonSchema.optional(),
-    action_type: actionTypeSchema.optional(),
-    payment_view: z.enum(['decidable', 'excluded', 'resolved']).optional(),
-    payment_status: z.enum(['PENDING', 'CONFIRMED', 'CONFIRMED_INDIRECT', 'REJECTED']).optional(),
-    payment_eligibility: z
-        .enum([
-        'PENDING_CHECK',
-        'VERIFIED',
-        'VERIFIED_WEAK',
-        'UNVERIFIED',
-        'EXCLUDED_NON_AUTOWEB',
-        'EXCLUDED_PREEXISTING',
-    ])
-        .optional(),
-    include_archived: z.boolean().optional(),
-})
-    .strict()
-    .superRefine((input, ctx) => {
-    const addUnsupportedFilterIssue = (path, report) => {
-        ctx.addIssue({
-            code: 'custom',
-            path: [path],
-            message: `${path} не поддерживается для report=${report}`,
-        });
-    };
-    if (input.report === 'recipients' && !input.recipient_metric) {
-        ctx.addIssue({
-            code: 'custom',
-            path: ['recipient_metric'],
-            message: 'recipient_metric обязателен для report=recipients',
-        });
-    }
-    if (input.report === 'deals' && !input.deal_metric) {
-        ctx.addIssue({
-            code: 'custom',
-            path: ['deal_metric'],
-            message: 'deal_metric обязателен для report=deals',
-        });
-    }
-    if (input.recipient_metric && input.report !== 'recipients') {
-        addUnsupportedFilterIssue('recipient_metric', input.report);
-    }
-    if (input.deal_metric && input.report !== 'deals') {
-        addUnsupportedFilterIssue('deal_metric', input.report);
-    }
-    if (input.reason &&
-        (input.report !== 'recipients' || input.recipient_metric !== 'notSent')) {
-        addUnsupportedFilterIssue('reason', input.report);
-    }
-    if (input.action_type && input.report !== 'action_failures') {
-        addUnsupportedFilterIssue('action_type', input.report);
-    }
-    if (input.mode === 'range') {
-        if (!input.from) {
-            ctx.addIssue({
-                code: 'custom',
-                path: ['from'],
-                message: 'from обязателен для mode=range',
-            });
-        }
-        if (!input.to) {
-            ctx.addIssue({
-                code: 'custom',
-                path: ['to'],
-                message: 'to обязателен для mode=range',
-            });
-        }
-        if (input.days !== undefined) {
-            ctx.addIssue({
-                code: 'custom',
-                path: ['days'],
-                message: 'days не поддерживается для mode=range',
-            });
-        }
-    }
-    else {
-        if (input.from) {
-            ctx.addIssue({
-                code: 'custom',
-                path: ['from'],
-                message: `from не поддерживается для mode=${input.mode}`,
-            });
-        }
-        if (input.to) {
-            ctx.addIssue({
-                code: 'custom',
-                path: ['to'],
-                message: `to не поддерживается для mode=${input.mode}`,
-            });
-        }
-        if (input.mode === 'all' && input.days !== undefined) {
-            ctx.addIssue({
-                code: 'custom',
-                path: ['days'],
-                message: 'days не поддерживается для mode=all',
-            });
-        }
-    }
-    if (input.from && input.to && input.from > input.to) {
-        ctx.addIssue({
-            code: 'custom',
-            path: ['to'],
-            message: 'to не может быть раньше from',
-        });
-    }
-    if ((input.page || input.page_size) && !PAGED_REPORTS.has(input.report)) {
-        addUnsupportedFilterIssue(input.page ? 'page' : 'page_size', input.report);
-    }
-    if (input.date && !DATED_REPORTS.has(input.report)) {
-        addUnsupportedFilterIssue('date', input.report);
-    }
-    if (input.import_job_id && !DATED_REPORTS.has(input.report)) {
-        addUnsupportedFilterIssue('import_job_id', input.report);
-    }
-    if (input.channel && !DRILLDOWN_REPORTS.has(input.report)) {
-        addUnsupportedFilterIssue('channel', input.report);
-    }
-    const hasAnalyticsOnlyFilter = input.days !== undefined ||
-        input.from !== undefined ||
-        input.to !== undefined ||
-        input.platform_id !== undefined ||
-        input.funnel !== undefined ||
-        input.funnel_mode !== undefined ||
-        input.segment !== undefined ||
-        input.mailing_variant_id !== undefined ||
-        input.mechanism !== undefined ||
-        input.product !== undefined ||
-        input.product_mode !== undefined ||
-        input.freshness !== undefined ||
-        input.channels !== undefined ||
-        input.mode !== 'days' ||
-        input.view !== 'period';
-    if ((isPaymentReport(input.report) || isCatalogReport(input.report)) && hasAnalyticsOnlyFilter) {
-        addUnsupportedFilterIssue('report', input.report);
-    }
-    const hasPaymentListFilter = input.payment_view !== undefined ||
-        input.payment_status !== undefined ||
-        input.payment_eligibility !== undefined ||
-        input.include_archived !== undefined;
-    if (hasPaymentListFilter && input.report !== 'payment_candidates') {
-        addUnsupportedFilterIssue('payment_view', input.report);
-    }
-    if (input.report === 'payment_candidates' &&
-        input.payment_view &&
-        (input.payment_status || input.payment_eligibility)) {
-        ctx.addIssue({
-            code: 'custom',
-            path: ['payment_view'],
-            message: 'payment_view нельзя сочетать с payment_status/payment_eligibility',
-        });
-    }
-    if (input.report === 'payment_candidates' &&
-        input.page_size !== undefined &&
-        input.page_size > PAYMENT_CANDIDATES_MAX_PAGE_SIZE) {
-        ctx.addIssue({
-            code: 'custom',
-            path: ['page_size'],
-            message: `page_size для report=payment_candidates не больше ${PAYMENT_CANDIDATES_MAX_PAGE_SIZE}`,
-        });
-    }
-});
-const appendFilterValues = (params, key, value) => {
-    if (!value)
-        return;
-    const values = Array.isArray(value) ? value : [value];
-    for (const item of values)
-        params.append(key, item);
+    channels: oneOrMany(z.enum(SHIPPED_CHANNELS)).optional(),
+    freshness: oneOrMany(z.enum(FRESHNESS_BUCKETS)).optional(),
+    mailing_variant_id: oneOrMany(uuidSchema).optional(),
 };
-function buildAnalyticsParams(input) {
+/** Отгруженное название канала → значение, которое принимает сервер. */
+function toServerChannel(value) {
+    return value.toUpperCase();
+}
+function buildQuery(input) {
     const params = new URLSearchParams();
+    if (input.currency !== undefined)
+        params.set('currency', input.currency);
     const mode = input.mode ?? 'days';
     params.set('mode', mode);
     if (mode === 'days')
@@ -301,182 +93,692 @@ function buildAnalyticsParams(input) {
     if (input.to)
         params.set('to', input.to);
     if (input.platform_id)
-        params.set('platformId', input.platform_id);
-    appendFilterValues(params, 'funnel', input.funnel);
+        params.set('channelId', input.platform_id);
+    for (const value of asArray(input.funnel))
+        params.append('funnel', value);
     if (input.funnel_mode)
         params.set('funnelMode', input.funnel_mode);
-    appendFilterValues(params, 'segment', input.segment);
-    appendFilterValues(params, 'mailingVariantId', input.mailing_variant_id);
-    appendFilterValues(params, 'mechanism', input.mechanism);
-    appendFilterValues(params, 'product', input.product);
+    for (const value of asArray(input.segment))
+        params.append('segment', value);
+    for (const value of asArray(input.product))
+        params.append('product', value);
     if (input.product_mode)
         params.set('productMode', input.product_mode);
-    appendFilterValues(params, 'freshness', input.freshness);
-    appendFilterValues(params, 'channels', input.channels);
-    params.set('view', input.view ?? 'period');
-    return params;
-}
-function toQuery(params) {
+    for (const value of asArray(input.channels))
+        params.append('transports', toServerChannel(value));
+    for (const value of asArray(input.freshness))
+        params.append('freshness', value);
+    for (const value of asArray(input.mailing_variant_id))
+        params.append('mailingVariantId', value);
+    for (const value of asArray(input.mechanism).includes('any') ? [] : asArray(input.mechanism))
+        params.append('mechanism', value);
+    for (const value of asArray(input.launch_source))
+        params.append('launchSource', value);
+    if (input.view)
+        params.set('view', input.view);
     const query = params.toString();
     return query ? `?${query}` : '';
 }
-function appendDrilldownParams(params, input) {
-    if (input.date)
-        params.set('date', input.date);
-    if (input.channel)
-        params.set('channel', input.channel);
-    if (input.import_job_id)
-        params.set('importJobId', input.import_job_id);
-    if (input.page)
-        params.set('page', String(input.page));
-    if (input.page_size)
-        params.set('pageSize', String(input.page_size));
-}
-function buildPaymentCandidatesQuery(input) {
+function buildPaymentCandidateQuery(input) {
     const params = new URLSearchParams();
-    if (input.payment_view)
-        params.set('view', input.payment_view);
-    if (input.payment_status)
-        params.set('status', input.payment_status);
-    if (input.payment_eligibility)
-        params.set('eligibility', input.payment_eligibility);
-    if (input.include_archived)
-        params.set('includeArchived', 'true');
-    if (input.page)
-        params.set('page', String(input.page));
-    if (input.page_size)
-        params.set('pageSize', String(input.page_size));
-    return toQuery(params);
+    if (input.view)
+        params.set('view', input.view);
+    if (input.status)
+        params.set('status', input.status);
+    if (input.eligibility)
+        params.set('eligibility', input.eligibility);
+    params.set('includeArchived', String(input.include_archived ?? false));
+    params.set('page', String(input.page ?? paymentCandidatePagination.defaultPage));
+    params.set('pageSize', String(input.page_size ?? paymentCandidatePagination.defaultPageSize));
+    return `?${params.toString()}`;
 }
-function buildReportPath(input) {
-    const workspaceBase = `/workspaces/${input.workspace_id}`;
-    const analyticsBase = `${workspaceBase}/broadcast-analytics`;
-    const params = buildAnalyticsParams(input);
-    switch (input.report) {
-        case 'summary':
-            return `${analyticsBase}${toQuery(params)}`;
-        case 'cohorts':
-            return `${analyticsBase}/cohorts${toQuery(params)}`;
-        case 'skip_reasons':
-            if (input.import_job_id)
-                params.set('importJobId', input.import_job_id);
-            if (input.date)
-                params.set('date', input.date);
-            return `${analyticsBase}/skip-reasons${toQuery(params)}`;
-        case 'recipients':
-            appendDrilldownParams(params, input);
-            params.set('metric', input.recipient_metric);
-            if (input.reason)
-                params.set('reason', input.reason);
-            return `${analyticsBase}/recipients${toQuery(params)}`;
-        case 'deals':
-            appendDrilldownParams(params, input);
-            params.set('metric', input.deal_metric);
-            return `${analyticsBase}/deals${toQuery(params)}`;
-        case 'action_failures':
-            appendDrilldownParams(params, input);
-            if (input.action_type)
-                params.set('actionType', input.action_type);
-            return `${analyticsBase}/action-failures${toQuery(params)}`;
-        case 'indirect_payments':
-            appendDrilldownParams(params, input);
-            return `${analyticsBase}/indirect-payments${toQuery(params)}`;
-        case 'response_windows':
-            return `${analyticsBase}/response-windows${toQuery(params)}`;
-        case 'insights':
-            return `${analyticsBase}/insights${toQuery(params)}`;
-        case 'recent_leads':
-            return `${analyticsBase}/recent-leads${toQuery(params)}`;
-        case 'data_quality':
-            return `${analyticsBase}/data-quality${toQuery(params)}`;
-        case 'segments_catalog':
-            return `${analyticsBase}/segments`;
-        case 'funnel_products':
-            return `${analyticsBase}/funnel-products`;
-        case 'payment_candidates':
-            return `${workspaceBase}/payment-candidates${buildPaymentCandidatesQuery(input)}`;
-        case 'payment_candidates_summary':
-            return `${workspaceBase}/payment-candidates/summary`;
-    }
+/** Отчёты страницы аналитики. Каждый — свой адрес; выбор делает поле `report`. */
+/**
+ * Отчёты фасада. ЭКСПОРТИРУЕТСЯ ради проверки полноты веток: она обязана брать перечень из КОДА,
+ * а не из опубликованного контракта. Отчёт, добавленный в код и забытый в контракте, иначе остался
+ * бы невидимым для проверки — при том, что фильтр аргументов его принимает.
+ */
+export const ANALYTICS_REPORTS = [
+    'summary',
+    'registration_intake',
+    'cohorts',
+    'skip_reasons',
+    'recipients',
+    'deals',
+    'action_failures',
+    'indirect_payments',
+    'response_windows',
+    'insights',
+    'recent_leads',
+    'data_quality',
+    'segments_catalog',
+    'funnel_products',
+    'payment_candidates',
+    'payment_candidates_summary',
+];
+/**
+ * ⛔ Отчёты, чей адрес лежит ВНЕ префикса аналитики. Слепой перенос «отчёт → суффикс» даёт им 404:
+ * два справочника живут прямо под воркспейсом, а оплаты — под своим разделом.
+ */
+const REPORT_PATHS = {
+    registration_intake: '/broadcast-analytics/registration-intake',
+    summary: '/broadcast-analytics',
+    cohorts: '/broadcast-analytics/cohorts',
+    skip_reasons: '/broadcast-analytics/skip-reasons',
+    recipients: '/broadcast-analytics/recipients',
+    deals: '/broadcast-analytics/deals',
+    action_failures: '/broadcast-analytics/action-failures',
+    indirect_payments: '/broadcast-analytics/indirect-payments',
+    response_windows: '/broadcast-analytics/response-windows',
+    insights: '/broadcast-analytics/insights',
+    recent_leads: '/broadcast-analytics/recent-leads',
+    data_quality: '/broadcast-analytics/data-quality',
+    segments_catalog: '/broadcast-segments',
+    funnel_products: '/broadcast-funnel-products',
+    payment_candidates: '/payment-candidates',
+    payment_candidates_summary: '/payment-candidates/summary',
+};
+/**
+ * Отгруженное имя метрики получателей → имя, которое принимает сервер.
+ *
+ * ⛔ `notSent` в перевод НЕ входит: у отсеянных нет строки отправки, они читаются другим адресом.
+ * Отдать его метрикой значило бы получить отказ по незнакомому значению.
+ */
+const RECIPIENT_METRIC_TO_SERVER = {
+    linkIssued: 'linkIssued',
+    clicked: 'clicked',
+    sent: 'sent',
+    delivered: 'received',
+    entered: 'enteredDialog',
+    deepDialog: 'deepDialog',
+    handedOff: 'handedOff',
+    notDelivered: 'notDelivered',
+};
+const SHIPPED_RECIPIENT_METRICS = [
+    'linkIssued',
+    'clicked',
+    'sent',
+    'delivered',
+    'entered',
+    'deepDialog',
+    'handedOff',
+    'notDelivered',
+    'notSent',
+];
+/** Степень доказанности оплаты; «слабо подтверждено» объявлено мёртвой осью и не доносится. */
+const SHIPPED_PAYMENT_ELIGIBILITIES = [
+    'PENDING_CHECK',
+    'VERIFIED',
+    'VERIFIED_WEAK',
+    'UNVERIFIED',
+    'EXCLUDED_NON_AUTOWEB',
+    'EXCLUDED_PREEXISTING',
+];
+/**
+ * Отчёты, у которых ЕСТЬ кликнутая ячейка: только им осмысленно передавать её координаты — день,
+ * канал и волну. У причин отсева канала не существует как понятия, и пробрасывать его туда значит
+ * ронять запрос на незнакомом параметре.
+ */
+const CELL_REPORTS = new Set([
+    'recipients',
+    'deals',
+    'action_failures',
+    'indirect_payments',
+]);
+const PAGINATED_REPORTS = new Set([
+    'recipients',
+    'deals',
+    'action_failures',
+    'indirect_payments',
+    'payment_candidates',
+]);
+/**
+ * Политика ответа — функция ОТЧЁТА, а не константа инструмента.
+ *
+ * Замеры: сводка 1,34 МБ (данные 897 КБ + итоги 437 КБ), когорты 635 КБ целиком в элементах.
+ * ⛔ У сводки выбрасываются ТОЛЬКО данные: прежняя редакция разрешала выбросить и итоги, и наружу
+ * уходил пустой отчёт под видом ответа.
+ */
+function facadeResultPolicy(report) {
+    const narrowingHint = 'Сузьте отчёт: mode/days либо from+to на меньший период, platform_id на один канал, funnel/segment/product на один разрез.';
+    if (report === 'summary')
+        return { droppablePaths: ['data'], narrowingHint };
+    // У постраничных выдач механизм сужения уже есть: конверт подменил бы его тихой потерей.
+    if (PAGINATED_REPORTS.has(report))
+        return { neverTruncate: true };
+    if (report === 'cohorts')
+        return { neverTruncate: true, narrowingHint };
+    return { neverTruncate: true };
 }
-function reportInstructions(report) {
-    if (isCatalogReport(report)) {
-        return [
-            'Это workspace-scoped справочник страницы аналитики, поэтому период и dimension-фильтры к нему не применяются.',
-            report === 'segments_catalog'
-                ? 'description — сохранённое бизнес-правило отбора сегмента; null означает, что правило ещё не описано.'
-                : 'unmappedKeys — нормализованные ключи воронок последних 90 дней, для которых продукт ещё не задан.',
-        ];
+function buildFacadePath(input) {
+    const report = input.report ?? 'summary';
+    const notSent = report === 'recipients' && input.recipient_metric === 'notSent';
+    const path = notSent ? '/broadcast-analytics/not-sent' : REPORT_PATHS[report];
+    if (report === 'payment_candidates' || report === 'payment_candidates_summary') {
+        // mode у оплат — раздел очереди, период имеет отдельное имя periodMode.
+        const params = new URLSearchParams(buildQuery(input).replace(/^\?/u, ''));
+        params.delete('view');
+        params.delete('mode');
+        const periodMode = input.mode ?? (input.days === undefined ? 'all' : 'days');
+        params.set('periodMode', periodMode);
+        if (periodMode !== 'days')
+            params.delete('days');
+        params.set('includeArchived', String(input.include_archived ?? false));
+        if (report === 'payment_candidates') {
+            if (input.payment_view)
+                params.set('view', input.payment_view);
+            if (input.payment_status)
+                params.set('status', input.payment_status);
+            if (input.payment_eligibility)
+                params.set('eligibility', input.payment_eligibility);
+            params.set('page', String(input.page ?? paymentCandidatePagination.defaultPage));
+            params.set('pageSize', String(input.page_size ?? paymentCandidatePagination.defaultPageSize));
+        }
+        const query = params.toString();
+        return `${path}${query ? `?${query}` : ''}`;
+    }
+    // Справочники разрезов фильтров не принимают вовсе: у них нет ни периода, ни измерений.
+    if (report === 'segments_catalog' || report === 'funnel_products')
+        return path;
+    const params = new URLSearchParams(buildQuery(input).replace(/^\?/u, ''));
+    // ⛔ Координаты кликнутой ЯЧЕЙКИ уходят только тем отчётам, у которых ячейка есть. Отгруженная
+    // схема плоская и разрешает прислать их с любым отчётом; пробросить их дальше значит уронить
+    // запрос целиком на незнакомом параметре — ровно тот отказ, который мы снимаем. Проверено
+    // прогоном отгруженного образца через настоящий вход маршрута: причины отсева канала не знают.
+    const cellReport = CELL_REPORTS.has(report);
+    if (cellReport || report === 'skip_reasons' || notSent) {
+        if (input.date)
+            params.set('date', input.date);
+        if (input.import_job_id)
+            params.set('importJobId', input.import_job_id);
+    }
+    if (cellReport && input.channel)
+        params.set('transport', toServerChannel(input.channel));
+    // Причина отсева осмысленна только там, где отсев и есть.
+    if ((report === 'skip_reasons' || notSent) && input.reason)
+        params.set('reason', input.reason);
+    // Источник задаёт и словарь причины, и то, чей поимённый список отдаётся.
+    if ((report === 'skip_reasons' || notSent) && input.reason_source) {
+        params.set('reasonSource', input.reason_source);
     }
-    if (isPaymentReport(report)) {
-        return [
-            'Это read-only данные вкладки «Подтверждение оплат». Общие фильтры аналитики к ней в UI не применяются; для списка используй payment_view либо payment_status/payment_eligibility и пагинацию.',
-            'Для payment_candidates максимальный page_size — 100.',
-            'Инструмент не подтверждает и не отклоняет оплаты: он только читает очередь и историю решений.',
-        ];
+    if (report === 'action_failures' && input.action_type) {
+        params.set('actionType', input.action_type);
     }
-    if (report === 'recipients' ||
-        report === 'deals' ||
-        report === 'action_failures' ||
-        report === 'indirect_payments') {
-        return [
-            'Это пагинированный drill-down той же страницы. Передавай те же общие фильтры, что использовались для агрегата, чтобы total совпадал с раскрываемой ячейкой.',
-            'Для следующей страницы увеличивай page; максимальный page_size — 200.',
-        ];
+    if (report === 'recipients' && !notSent && input.recipient_metric) {
+        params.set('metric', RECIPIENT_METRIC_TO_SERVER[input.recipient_metric] ?? '');
     }
-    return [
-        'Это authoritative данные раздела «Аналитика коммуникации» (/communication-analytics), режим «Исходящие». НЕ пересчитывай статистику рассылок через besales_dialogues_query или транскрипты.',
-        'Для «сегодня» используй mode=range, from=to=нужная дата YYYY-MM-DD; даты группируются по МСК.',
-    ];
+    if (report === 'deals' && input.deal_metric)
+        params.set('metric', input.deal_metric);
+    if (PAGINATED_REPORTS.has(report) || notSent) {
+        params.set('page', String(input.page ?? 1));
+        if (input.page_size !== undefined)
+            params.set('pageSize', String(input.page_size));
+    }
+    const query = params.toString();
+    return `${path}${query ? `?${query}` : ''}`;
+}
+/** Общая часть — верна для любого отчёта фасада. */
+const FACADE_COMMON_INSTRUCTIONS = [
+    ...MONEY_CURRENCY_INSTRUCTIONS,
+    'Это authoritative-выдача страницы /broadcast-analytics. НЕ пересчитывай статистику рассылок через besales_dialogues_query или транскрипты.',
+    'Для «сегодня» используй view=period, mode=range, from=to=нужная дата YYYY-MM-DD; даты группируются по МСК.',
+    'funnel здесь — бизнес-воронка волны. Названия CRM pipeline читай отдельно через besales_crm_list + besales_crm_pipeline_list.',
+];
+/** Подсказки по семействам отчётов; общее НЕ дублируется в каждой ветке. */
+function facadeInstructions(report) {
+    const byReport = {
+        registration_intake: [
+            'Состояние сверки отличает отказ внешнего реестра от нулевых регистраций; числа не получены — не ноль.',
+            'В ответе: всего, вошли, не вошли, люди с группой, исходом приёма и приветствия, воронкой, моментом, номерами заказов и ссылкой на живой контакт.',
+            'Результат напоминаний показывай отдельной подписью followupLabel; он не меняет исход приёма или доставки приветствия.',
+            'Группа REENTRY_DEFERRED означает ожидание повтора, а не состоявшуюся отправку. Момент retryAt подписан сервером в часовом поясе платформы; используй reasonLabel.',
+            'Сутки Москвы. Поздние вечерние регистрации и приветствия могут стать видны позже; внешний реестр отстаёт на 10 минут — 3 часа, редко сутки.',
+            'Если два канала принимают одну воронку, недошедший заказ без решения роутера виден обоим. Эти числа нельзя складывать между каналами.',
+        ],
+        summary: [
+            'Плитки прямой и косвенной выручки читают только moneyTotals.paidAmount и moneyTotals.indirectAmount за выбранный период и фильтры. Суммы data/totals/totalsByChannelId для плиток не складывать; поля potentialAmount в moneyTotals нет.',
+            'Общий итог, кроме денежных плиток, бери из totals, а не суммой data по каналам: один получатель мультиканальной волны присутствует в нескольких channel-строках.',
+            'view=entry группирует по настоящему моменту входа получателя в сегмент. entryCoverage (только на оси входа; на других осях null) показывает sentRows и paidDeals, а также rowsWithoutEntry и paidDealsWithoutEntry — сколько строк отправки и привязанных к волне оплат без настоящего входа выпали из дат. Возможные и косвенные оплаты в эти числа не входят.',
+            'sent — строки получателей волн, не число реплик агента и не обязательно уникальные люди между разными волнами.',
+            'received — доставленные строки получателей с учётом delivery-гейта канала.',
+            'enteredDialog — получатели, у которых было хотя бы одно входящее после этой волны и до следующей; это НЕ количество входящих сообщений.',
+            'handedOff — успешные GETCOURSE_CREATE_DEAL / GETCOURSE_SET_MANAGER / GETCOURSE_SET_DEAL_MANAGER / GETCOURSE_SET_PERSONAL_MANAGER. Назначение менеджера СДЕЛКИ без подходящей сделки — пропуск с причиной, а не успех: заявкой не считается (прежде считалось).',
+        ],
+        cohorts: [
+            'Каждый items[] — отдельный запуск рассылки, а не строка сообщения или диалог.',
+            'Список запусков и items[].date датируются запуском на любой оси view, в том числе view=entry; ось входа не передатирует запуск.',
+            'label — имя запуска; funnel/segment/product/channels — снимок бизнес-разрезов волны.',
+            'notSent у запуска — ТОЛЬКО проверка перед волной: notSent.total=null означает, что число неприменимо для этого запуска и выбранных фильтров; причину смотри в sources[].countAvailability.reasonLabel, это НЕ ноль. «Не отправлено» прогона волны (отказы самого прогона: цель статуса не нашлась, контакт не завёлся, сделка не перешла, исход неизвестен, прогон остановлен), холодного запуска, запуска по расписанию и автоприёма регистраций читай в sources[]: у каждого источника total (null — неизвестно или неприменимо, это НЕ ноль), tracedTotal и полнота countAvailability/detailsAvailability с причиной reasonLabel. Запуск «всё дошло» только если пусты ВСЕ источники — и только у долгого прогона: у одиночной волны источника «прогон волны» нет, её отказы импорта, статуса и сделки в sources[] не попадают (их показывает besales_getcourse_wave_status: failed и errorReasons).',
+        ],
+        skip_reasons: [
+            'total, items и byDayProduct — сумма ИЗВЕСТНОГО по всем доступным источникам; у строки items есть source. Неизвестное в сумму не входит — его называет sources[]. Исключение — отказы одиночной волны (не долгого прогона): источника у них нет вовсе, и sources[] о них молчит; их показывает besales_getcourse_wave_status.',
+            'unattributed — отсев волн без собственного значения выбранной воронки, сегмента или продукта: в total не входит, поимённого списка не имеет. unattributed=null означает «неприменимо», а не ноль.',
+            'При фильтре мессенджера, сужающей свежести или view=entry отсев неприменим у ВСЕХ источников: смотри sources[].countAvailability.reasonLabel, не трактуй null как ноль.',
+            'sources[]: total — сколько не отправлено (null — неизвестно, НЕ ноль); tracedTotal — сколько из них можно назвать поимённо; countAvailability/detailsAvailability — полнота числа и списка (COMPLETE/MISMATCH/PARTIAL/UNAVAILABLE) с причиной reasonLabel. Пересказывая, называй неполноту словами из reasonLabel, а не выдавай частичное число за полное.',
+            'У проверки перед волной разбивка считает проверку по разу на КАЖДУЮ её причину: сумма по причинам больше числа проверок. Фильтр reason без reason_source относится только к проверке перед волной; с reason_source — к реестру этого источника.',
+            'Причину называй подписью sources[].reasons[].label, а не кодом. У прогона волны «исход неизвестен» значит «сообщение могло уйти» — не пересказывай его как «не отправлено точно».',
+        ],
+        recipients: [
+            'Это строки выбранной метрики за кликнутую ячейку, а не все получатели волны.',
+            'У строк метрик получателей gcUserUrl и gcDealUrl — готовые адреса человека и заказа в GetCourse. null означает, что домен школы или идентификатор не доказан: адрес самостоятельно не составляй.',
+            'recipient_metric=notSent отдаёт поимённый список ОДНОГО источника: по умолчанию — проверки перед волной; reason_source выбирает другой (WAVE_RUN — отказы самого прогона волны, COLD_WELCOME и SCHEDULED_RUN — журнал пропусков собственной отправки). У строк нет ни канала, ни статуса доставки, зато есть массив причин (коды — подписи бери из sources отчёта skip_reasons). Полноту списка называет detailsAvailability.',
+        ],
+        deals: [
+            'withoutCohort — сделка без единой отметки волны, то есть оплата вне рассылок.',
+            'gcUserUrl и gcDealUrl — готовые адреса человека и заказа в GetCourse. Школу заказа агента определяет его CRM-подключение, а не канал диалога. null означает, что домен или идентификатор не доказан: адрес самостоятельно не составляй.',
+        ],
+        response_windows: [
+            'В conversionCycles поле cut различает overall — серверный итог стадии, product — строку продукта и segment — строку сегмента. Пустой ключ product или segment в строке разреза означает «без продукта» или «без сегмента», а не «Итого».',
+            'Для строки «Итого» бери cut=overall. Медианы строк продукта и сегмента не складывай: сервер считает медиану итога отдельно. Цикл оплаты начинается с первого получения человеком логической волны; оплату до получения сервер исключает.',
+        ],
+        action_failures: [
+            'Показаны только production-сбои в окне волны; разбивка идёт по ключу действия, заданному настройщиком.',
+            'gcUserUrl и gcDealUrl — готовые адреса человека и закреплённого заказа в GetCourse. null означает, что домен школы или идентификатор не доказан: адрес самостоятельно не составляй.',
+        ],
+        data_quality: [
+            'paymentsWithoutCohort приходит ПУСТЫМ при фильтрах воронки, сегмента, продукта, варианта рассылки, волны или свежести: у оплаты без волны этих измерений нет, и число под таким фильтром было бы неправдой.',
+            'noMessenger=null означает, что отсев без мессенджера неприменим при фильтре мессенджера, сужающей свежести или view=entry; это НЕ ноль.',
+            'total — строки отправки за период, а не уникальные люди.',
+        ],
+        recent_leads: [
+            'Окно считается по дате ОТВЕТА, а не по дате отправки волны; отдаётся до пятидесяти последних.',
+        ],
+        payment_candidates: [
+            'Это read-only отчёт. Решения по оплатам принимает только вошедший человек в интерфейсе Besales.',
+            'payment_view перекрывает payment_status и payment_eligibility; для точечных фильтров не передавай payment_view.',
+            'Общие фильтры оплат передаются списку и сводке; период — по дате оплаты. Без mode/days — всё время; mode=days без days — последние 30 дней.',
+        ],
+        payment_candidates_summary: [
+            'Счётчики учитывают те же общие фильтры оплат; include_archived=true включает архивные строки, по умолчанию только активные.',
+        ],
+        segments_catalog: ['Справочник разрезов; фильтры периода и измерений он не принимает.'],
+        funnel_products: ['Справочник разрезов; фильтры периода и измерений он не принимает.'],
+    };
+    return [...FACADE_COMMON_INSTRUCTIONS, ...(byReport[report] ?? [])];
 }
 export const broadcastAnalyticsTools = [
     defineTool({
         name: 'besales_broadcast_analytics_get',
         sideEffect: 'none',
+        closedWorld: true,
+        // Отчёты получателей, сделок, отсеянных и отказов действий несут имена и идентификаторы людей.
+        carriesCustomerData: true,
         requiredFields: [],
         defaultWorkspaceId: true,
-        resultPolicy: {
-            // `totals` — авторитетный итог отчёта; его нельзя выбрасывать вместе со строками.
-            droppablePaths: ['data'],
-            narrowingHint: 'Сузьте отчёт: mode/days либо from+to на меньший период, platform_id на один канал, funnel/segment/product на один разрез.',
-        },
-        schema: analyticsToolSchema,
+        // Самый тяжёлый замеренный отчёт — 1,34 МБ, из них data 897 КБ и totals 437 КБ. Сужать
+        // отчёт есть чем, поэтому при превышении выбрасываются именно эти два поля, а справочники
+        // разрезов остаются: по ним и строится следующий, суженный запрос.
+        // ⚠️ Выбрасывается ТОЛЬКО `data`. Прежняя редакция разрешала выбросить ещё и `totals`,
+        // и на замеренном ответе в 1,34 МБ срабатывали оба шага подряд: наружу уходил конверт без
+        // строк И без итогов — то есть пустой отчёт под видом ответа. Итоги вдвое легче строк и
+        // несут главное; если и без строк не влезло — честнее отказ с подсказкой, чем пустота.
+        resultPolicy: (input) => facadeResultPolicy(input.report ?? 'summary'),
+        schema: z
+            .object({
+            ...analyticsQueryFields,
+            // У оплат без периода — всё время; у аналитики — последние 30 дней.
+            mode: z.enum(['all', 'days', 'range']).optional(),
+            view: z.enum(['cohort', 'entry', 'period']).default('period'),
+            report: z.enum(ANALYTICS_REPORTS).default('summary'),
+            date: calendarDateSchema.optional(),
+            channel: z.enum(SHIPPED_CHANNELS).optional(),
+            // ⛔ Сужено до идентификатора намеренно: сервер принимает только его, и отказ на разборе
+            // называет поле и формат, тогда как отказ сервера приходит без подсказки.
+            import_job_id: uuidSchema.optional(),
+            page: z.number().int().min(1).optional(),
+            page_size: z.number().int().min(1).max(200).optional(),
+            recipient_metric: z.enum(SHIPPED_RECIPIENT_METRICS).optional(),
+            deal_metric: z.enum(['issued', 'paid', 'confirmedByOperator', 'withoutCohort']).optional(),
+            reason: z.enum(BROADCAST_REASON_FILTER_VALUES).optional(),
+            reason_source: z.enum(SKIP_REASON_SOURCES).optional(),
+            action_type: z.string().min(1).optional(),
+            payment_view: z.enum(['decidable', 'excluded', 'resolved']).optional(),
+            payment_status: z
+                .enum(['PENDING', 'CONFIRMED', 'CONFIRMED_INDIRECT', 'REJECTED'])
+                .optional(),
+            payment_eligibility: z.enum(SHIPPED_PAYMENT_ELIGIBILITIES).optional(),
+            include_archived: z.boolean().optional(),
+        })
+            .strict()
+            .superRefine((value, ctx) => {
+            const unsupported = (field) => {
+                ctx.addIssue({ code: 'custom', path: [field], message: field + ' не поддерживается для report=' + value.report });
+            };
+            const payment = ['payment_candidates', 'payment_candidates_summary'].includes(value.report);
+            const catalog = ['segments_catalog', 'funnel_products'].includes(value.report);
+            const dated = CELL_REPORTS.has(value.report) || value.report === 'skip_reasons';
+            const notSent = value.report === 'recipients' && value.recipient_metric === 'notSent';
+            if (value.mode === 'range') {
+                if (value.days !== undefined)
+                    unsupported('days');
+                if (payment && value.from === undefined && value.to === undefined) {
+                    ctx.addIssue({ code: 'custom', path: ['from'], message: 'mode=range для оплат требует хотя бы одну границу from или to' });
+                }
+            }
+            else {
+                for (const field of ['from', 'to'])
+                    if (value[field] !== undefined)
+                        unsupported(field);
+                if (value.mode === 'all' && value.days !== undefined)
+                    unsupported('days');
+            }
+            if (value.from !== undefined && value.to !== undefined && value.from > value.to) {
+                ctx.addIssue({ code: 'custom', path: ['to'], message: 'to не может быть раньше from' });
+            }
+            if (value.recipient_metric !== undefined && value.report !== 'recipients')
+                unsupported('recipient_metric');
+            if (value.deal_metric !== undefined && value.report !== 'deals')
+                unsupported('deal_metric');
+            if (!notSent && value.report !== 'skip_reasons') {
+                for (const field of ['reason', 'reason_source'])
+                    if (value[field] !== undefined)
+                        unsupported(field);
+            }
+            if (value.action_type !== undefined && value.report !== 'action_failures')
+                unsupported('action_type');
+            if (!PAGINATED_REPORTS.has(value.report)) {
+                for (const field of ['page', 'page_size'])
+                    if (value[field] !== undefined)
+                        unsupported(field);
+            }
+            if (!dated) {
+                for (const field of ['date', 'import_job_id'])
+                    if (value[field] !== undefined)
+                        unsupported(field);
+            }
+            if (value.channel !== undefined && !CELL_REPORTS.has(value.report))
+                unsupported('channel');
+            if (catalog) {
+                for (const field of ['days', 'from', 'to', 'platform_id', 'funnel', 'funnel_mode', 'segment', 'product', 'product_mode', 'channels', 'freshness', 'mailing_variant_id']) {
+                    if (value[field] !== undefined)
+                        unsupported(field);
+                }
+                if (value.mode !== undefined && value.mode !== 'days')
+                    unsupported('mode');
+                if (value.view !== 'period')
+                    unsupported('view');
+                for (const field of ['mechanism', 'launch_source'])
+                    if (value[field] !== undefined)
+                        unsupported(field);
+            }
+            if (payment && value.view !== 'period')
+                unsupported('view');
+            if (!payment && value.include_archived !== undefined)
+                unsupported('include_archived');
+            if (value.report !== 'payment_candidates') {
+                for (const field of ['payment_view', 'payment_status', 'payment_eligibility'])
+                    if (value[field] !== undefined)
+                        unsupported(field);
+            }
+            if (value.report === 'payment_candidates' && value.page_size !== undefined && value.page_size > paymentCandidatePagination.maxPageSize) {
+                ctx.addIssue({ code: 'custom', path: ['page_size'], message: 'page_size для report=payment_candidates не больше 100' });
+            }
+            if (value.currency !== undefined &&
+                ['segments_catalog', 'funnel_products', 'payment_candidates', 'payment_candidates_summary']
+                    .includes(value.report)) {
+                ctx.addIssue({
+                    code: 'custom',
+                    path: ['currency'],
+                    message: 'Этот отчёт не поддерживает валютный фильтр',
+                });
+            }
+            if (['payment_candidates', 'payment_candidates_summary'].includes(value.report) &&
+                value.launch_source !== undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ['launch_source'],
+                    message: 'В отдельной очереди оплат отбор по источнику запуска пока недоступен',
+                });
+            }
+            if (value.report === 'registration_intake' &&
+                value.view !== undefined &&
+                value.view !== 'period') {
+                ctx.addIssue({
+                    code: 'custom',
+                    path: ['view'],
+                    message: 'Для регистраций доступен только период регистрации',
+                });
+            }
+            if (value.report === 'recipients' && value.recipient_metric === undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ['recipient_metric'],
+                    message: 'report=recipients требует recipient_metric',
+                });
+            }
+            if (value.report === 'deals' && value.deal_metric === undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ['deal_metric'],
+                    message: 'report=deals требует deal_metric',
+                });
+            }
+            // ⛔ Отвергается ЗДЕСЬ, с причиной. Транслировать значение серверу нельзя: у него такой оси
+            // нет, и клиент получил бы отказ без объяснения.
+            if (value.payment_eligibility === 'VERIFIED_WEAK') {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    path: ['payment_eligibility'],
+                    message: 'VERIFIED_WEAK больше не существует: в проде у этого значения не было ни одного ' +
+                        'писателя, ось всегда была пуста и упразднена. Используйте VERIFIED или UNVERIFIED.',
+                });
+            }
+        }),
         createRequest: (input) => ({
             method: 'GET',
-            path: buildReportPath(input),
+            path: `/workspaces/${input.workspace_id}${buildFacadePath(input)}`,
         }),
-        enhanceResponse: (response, input) => withInstructions(response, [
-            ...reportInstructions(input.report),
-            ...(isPaymentReport(input.report)
-                ? []
-                : [
-                    'summary: общий итог бери из totals, а не суммой data по каналам — один получатель мультиканальной волны присутствует в нескольких channel-строках.',
-                    'enteredDialog/entered — ответившие получатели в окне волны, не число входящих сообщений.',
-                    'funnel — бизнес-воронка волны; названия CRM pipeline при необходимости читай через besales_crm_list + besales_crm_pipeline_list.',
-                ]),
-        ]),
+        // ⛔ Подсказки — ФУНКЦИЯ отчёта, как и политика усечения. Прежняя редакция объясняла только
+        // сводку; после возврата выбора она врала бы про оплаты, справочники и постраничные списки —
+        // рассказывала бы про totals и мультиканальные строки там, где ответ устроен иначе.
+        enhanceResponse: (response, input) => withInstructions(response, facadeInstructions(input.report ?? 'summary')),
     }),
     defineTool({
         name: 'besales_broadcast_cohorts_list',
         sideEffect: 'none',
+        closedWorld: true,
         requiredFields: [],
         defaultWorkspaceId: true,
+        // Замерено 635 КБ, и весь вес — в items. Выбросить их значит вернуть пустой конверт,
+        // поэтому здесь честнее отказ с указанием, чем сузить, чем ответ без содержимого.
         resultPolicy: {
             neverTruncate: true,
             narrowingHint: 'Сузьте выборку: mode/days либо from+to на меньший период, platform_id на один канал, funnel/segment/product на один разрез.',
         },
-        schema: z.object(analyticsQueryFields).strict(),
+        schema: z
+            .object({
+            ...analyticsQueryFields,
+            view: z.enum(['cohort', 'entry', 'period']).default('period'),
+        })
+            .strict(),
         createRequest: (input) => ({
             method: 'GET',
-            path: buildReportPath({ ...input, report: 'cohorts' }),
+            path: `/workspaces/${input.workspace_id}/broadcast-analytics/cohorts${buildQuery(input)}`,
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Backward-compatible alias для besales_broadcast_analytics_get с report=cohorts.',
+            ...MONEY_CURRENCY_INSTRUCTIONS,
             'Каждый items[] — отдельный запуск рассылки (importJobId/cohortId), а не строка сообщения или диалог.',
-            'Для общей статистики и остальных вкладок используй besales_broadcast_analytics_get.',
+            'Список запусков и items[].date датируются запуском на любой оси view, в том числе view=entry; ось входа не передатирует запуск.',
+            'label — имя запуска; funnel/segment/product/channels — снимок бизнес-разрезов волны.',
+            'notSent у запуска — ТОЛЬКО проверка перед волной: notSent.total=null означает, что число неприменимо для этого запуска и выбранных фильтров; причину смотри в sources[].countAvailability.reasonLabel, это НЕ ноль. Для других источников «не отправлено» смотри sources[].total, tracedTotal и countAvailability/detailsAvailability; null не считай нулём.',
+            'sent/delivered/entered/handedOff считаются по получателям этой волны; entered — ответившие получатели, не число их сообщений.',
+            'Для общей статистики по дням используй besales_broadcast_analytics_get; транскрипты нужны только для качественного разбора конкретных диалогов.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_broadcast_payment_candidates_list',
+        // Постраничная выдача уже работает: конверт подменил бы исправный механизм тихой потерей.
+        resultPolicy: { neverTruncate: true },
+        sideEffect: 'none',
+        closedWorld: true,
+        // Отдаёт имя человека, его идентификатор в кабинете школы и ссылку на карточку. Пометка была
+        // пропущена с самого начала: содержимое то же, что у фасада с отчётом оплат.
+        carriesCustomerData: true,
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            view: z.enum(['decidable', 'excluded', 'resolved']).optional(),
+            status: z.enum(['PENDING', 'CONFIRMED', 'CONFIRMED_INDIRECT', 'REJECTED']).optional(),
+            eligibility: z
+                .enum([
+                'PENDING_CHECK',
+                'VERIFIED',
+                'UNVERIFIED',
+                'EXCLUDED_NON_AUTOWEB',
+                'EXCLUDED_PREEXISTING',
+            ])
+                .optional(),
+            include_archived: z.boolean().default(false),
+            page: z
+                .number()
+                .int()
+                .min(paymentCandidatePagination.minPage)
+                .default(paymentCandidatePagination.defaultPage),
+            page_size: z
+                .number()
+                .int()
+                .min(paymentCandidatePagination.minPageSize)
+                .max(paymentCandidatePagination.maxPageSize)
+                .default(paymentCandidatePagination.defaultPageSize),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/payment-candidates${buildPaymentCandidateQuery(input)}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Это read-only отчёт. Решения по оплатам принимаются только вошедшим человеком в интерфейсе Besales.',
+            'view перекрывает status и eligibility; для точечных фильтров не передавай view.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_broadcast_payment_candidates_summary',
+        sideEffect: 'none',
+        closedWorld: true,
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z.object({ workspace_id: uuidSchema.optional() }).strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/payment-candidates/summary`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Счётчики охватывают только активные строки: решаемые, исключённые и уже решённые.',
+            'Это read-only отчёт; мост не принимает денежные решения.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_broadcast_mailing_variant_list',
+        sideEffect: 'none',
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            include_archived: z.boolean().default(false),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/broadcast-mailing-variants?includeArchived=${input.include_archived}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_broadcast_mailing_variant_create',
+        sideEffect: 'write',
+        requiredFields: ['name'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            name: z.string().min(1).max(200),
+            description: z.string().max(MAILING_VARIANT_DESCRIPTION_MAX_LENGTH).optional(),
+            ...mailingVariantContentShape,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/broadcast-mailing-variants`,
+            body: compactObject({
+                name: input.name,
+                description: input.description,
+                ...mailingVariantContentBody(input),
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Создаёт вариант или возвращает из архива вариант с тем же именем. Возврат из архива ОЧИЩАЕТ прежние тексты по сегментам, если message_text_by_segment не передан: иначе часть людей получила бы прошлые тексты, невидимые в этом вызове.',
+            ...MAILING_VARIANT_CONTENT_INSTRUCTIONS,
+        ]),
+    }),
+    defineTool({
+        name: 'besales_broadcast_mailing_variant_update',
+        sideEffect: 'write',
+        // ⛔ Имя НЕобязательно: правка частичная. Требование имени отвергало бы «верни из архива» и
+        // «поправь только пояснение», а присланное клиентом старое имя переписало бы снимки когорт.
+        requiredFields: ['mailing_variant_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            mailing_variant_id: uuidSchema,
+            name: z.string().min(1).max(200).optional(),
+            description: z.string().max(MAILING_VARIANT_DESCRIPTION_MAX_LENGTH).nullable().optional(),
+            archived: z.boolean().optional(),
+            explicit_confirmation: z.literal(true).optional(),
+            ...mailingVariantContentShape,
+        })
+            .strict()
+            .superRefine((value, ctx) => {
+            // Архивация — опасное действие: вариант исчезает из выдачи по умолчанию. Подтверждение
+            // требуется ИМЕННО на ней, а не на всей правке: переименование ничего не прячет.
+            if (value.archived === true && value.explicit_confirmation !== true) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'archived=true требует explicit_confirmation=true после подтверждения человека',
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/workspaces/${input.workspace_id}/broadcast-mailing-variants/${input.mailing_variant_id}`,
+            body: compactObject({
+                name: input.name,
+                description: input.description,
+                archived: input.archived,
+                ...mailingVariantContentBody(input),
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [...MAILING_VARIANT_CONTENT_INSTRUCTIONS]),
+    }),
+    defineTool({
+        name: 'besales_broadcast_mailing_variant_delete',
+        sideEffect: 'write',
+        requiredFields: ['mailing_variant_id', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            mailing_variant_id: uuidSchema,
+            explicit_confirmation: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/broadcast-mailing-variants/${input.mailing_variant_id}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Вариант только архивирован (`archivedAt`), а не удалён физически: hard-delete запрещён внешним ключом. Запись остаётся доступна через besales_broadcast_mailing_variant_list с include_archived=true.',
         ]),
     }),
 ];
+/**
+ * История запусков рассылок одним списком — четыре источника строк.
+ *
+ * ⛔ Схема — отгруженная без расхождения; тексты для модели — по ответу v2: код и подпись словами рядом, прогон
+ * называется «взято · отправлено» теми же числами, что у «Пула сегодня», остановка строки — полем `stop`.
+ */
 export const broadcastLaunchTools = [
     defineTool({
         name: 'besales_broadcast_launches_list',
@@ -488,36 +790,35 @@ export const broadcastLaunchTools = [
             workspace_id: uuidSchema.optional(),
             mailing_variant_id: uuidSchema.optional(),
             schedule_id: uuidSchema.optional(),
+            origin: z.enum(['MANUAL', 'WAVE', 'SCHEDULE', 'REGISTRATION', 'CAMPAIGN']).optional(),
+            cursor: z.string().max(512).optional(),
             limit: z.number().int().min(1).max(50).optional(),
         })
             .strict(),
-        createRequest: (input) => {
-            const query = new URLSearchParams();
-            if (input.mailing_variant_id)
-                query.set('mailingVariantId', input.mailing_variant_id);
-            if (input.schedule_id)
-                query.set('scheduleId', input.schedule_id);
-            if (input.limit)
-                query.set('limit', String(input.limit));
-            const suffix = query.toString();
-            return {
-                method: 'GET',
-                path: `/workspaces/${input.workspace_id}/broadcasts/launches${suffix ? `?${suffix}` : ''}`,
-            };
-        },
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/broadcasts/launches` +
+                buildListQuery({
+                    mailingVariantId: input.mailing_variant_id,
+                    scheduleId: input.schedule_id,
+                    limit: input.limit,
+                    origin: input.origin,
+                    cursor: input.cursor,
+                }),
+        }),
         enhanceResponse: (response) => withInstructions(response, [
-            'История запусков ЧЕТЫРЁХ видов. kind=cold_welcome — наша отправка (messageSnapshot = что реально ушло), kind=wave — волна по файлу (текст доставляет процесс школы). Прогон расписания и автоприём регистраций — тоже kind=cold_welcome: их различают НЕ по kind, а по наличию scheduleRun и registrationDay.',
-            '⚠️⚠️ Прогон расписания — строка с scheduleRun: механизм тот же cold_welcome (пишем первыми сами), различает их то, ЧТО запустило отправку. У такой строки totalContacts — это ПУЛ до исключений (а не размер когорты), sentCount — фактически доставленные, failedCount ВСЕГДА 0, outcomes ВСЕГДА null: разницу объясняют scheduleRun.selection и scheduleRun.facts (и reason).',
-            '⚠️⚠️ Числа прогона называй так же, как вкладки «История» и «Пул сегодня»: в строке «взято · отправлено», а план по людям — scheduleRun.dayBreakdown: расклад сегмента на день прогона из утреннего расчёта «Пула сегодня», те же числа, что вкладка «Пул» показывает у сегмента на этот день (registrations — регистраций, вошедших в сегмент от прошлого запуска; people — разных людей среди них; excluded — людей по группам отсева, словарь как у selection.excluded; selected — уйдёт из людей дня; carriedOver — уйдёт людей с прошлых дней; посчитан до запуска, поэтому selected + carriedOver может расходиться с selection.taken; null — утро этот сегмент не посчитало, плана нет, а не ноль). Пул запуска человеку людьми дня не называй: это регистрации всего окна свежести, почти всем из которых уже писали. scheduleRun.poolSize — пул запуска: регистрации в окне свежести авторассылки, которые запуск рассмотрел (не люди: человек с несколькими регистрациями посчитан несколько раз; null — пул ещё не измерен). scheduleRun.selection — те же числа, что facts.scheduleRuns у besales_broadcast_pool_today: collapsed — несколько регистраций у одного человека (poolSize − collapsed = людей в пуле); excluded — людей по группам отсева (noMessenger — нет мессенджера (в том числе прошлая подача этим расписанием закончилась «карточку не завели» или «каналами не достать»), inContact — на связи или писали недавно (этим сегментом уже писали, идёт разговор или трое суток тишины после нашей реплики, пауза повтора сегмента, пауза после любого нашего сообщения (поле расписания «Не писать, если писали за N дней»), подача этим расписанием ушла или ещё идёт), paid — купил продукт после регистрации, по которой попал в сегмент, withManager — с ним работает менеджер (действующая заявка на продукт после этой регистрации, операторский статус или передача диалога в отдел моложе трёх суток), blocked — бан, удалённая карточка или действующий мьют, activeSeries — идёт другая вебинарная серия, retryPause — прошлая попытка отправки этим расписанием не удалась, ждём паузу, overCap — не поместились в дневной потолок, higherPriority — уйдут в сегмент с большим приоритетом, otherPlatform — карточка на другой площадке школы, и эта авторассылка её не забирает (передача выключена, там ещё идёт серия эфиров или её дата неизвестна, карточек несколько, перенос не удался или уже увёз человека отсюда; у расчётов и прогонов до 22.09.2026 этой группы нет — эти люди в other), other — прочее (предохранитель не смог проверить заявки и оплаты, карточки на этой площадке нет, повтору не нашлось прошлого касания, непригодный номер человека); у прогонов до 16.09.2026 к новым группам добавляются прежние held (купил, менеджер, бан или мьют) и pause (пауза), только ненулевые; alreadyWritten у прогонов не бывает — называй их так и не складывай с новыми); unrecorded — людей пула без записанной причины (должно быть 0); taken — взято запуском (люди журнала подач, с этого числа начинается отправка); selection=null — пул не измерен. scheduleRun.facts — отправка по людям: sent — отправлено, noMessenger — карточку не завели или ни один канал не доходит, pending — ещё отправляется, notSent — не ушло по другой причине, notSentByReason — те же notSent по причинам: один исход на человека, сумма равна notSent; ключ — исход отказа отправки (SKIPPED_BOT_SILENCED — бот выключен у контакта, SKIPPED_ALREADY_IN_DIALOG — разговор уже идёт, SKIPPED_UNRESOLVED_VARS — переменные текста без значения и соседи, те же коды, что в outcomes ручной отправки), без следа отправки — исход журнала подач (UNRESOLVED_AFTER_BATCH — причина не записана: прогоны до 16.09.2026, RELEASED_LAUNCH_FAILED — запуск сорвался); человеку называй причины словами, а не кодами; facts=null — людей прогон не брал. excludedBy и selectedCount — сырые счётчики прогона: selectedCount после подачи уже без людей, которых импорт не завёл, — «взято» по нему не называй; причины источника в excludedBy (unverifiable, lowCoverageSkipped и соседи) отсеяны ДО пула — с пулом их не складывай и человеку не показывай как отсев пула.',
-            '⚠️⚠️ Ручная отправка ПАКЕТОМ — ОДНА строка с batch: id строки = batch.batchId, batch.blocks — блоки «сегмент × продукт × воронка» в порядке исполнения (status=pending и importJobId=null — блок ещё не стартовал). totalContacts — план всего пакета, sentCount/failedCount/outcomes — суммы по блокам, tracedOutcomes у строки пакета ВСЕГДА null: поимённый разбор — у блоков, по их importJobId. Пакет из одного блока отдаётся обычной строкой задачи (batch=null). Остановить пакет — besales_getcourse_cold_welcome_batch_cancel с batch.batchId, а не отменой задачи по id строки.',
-            '⚠️ Автоприём регистраций (приветствие по вебхуку регистрации) — ОДНА строка на день с registrationDay.day (дата МСК): sentCount = totalContacts = отправлено за день (списка «взяли» у потока нет), outcomes и tracedOutcomes null, status=running значит «день ещё идёт», а не «идёт прогон». Останавливать у такой строки нечего.',
-            '⚠️ scheduleRun.reason приходит и у прогона, доставившего ЧАСТЬ подачи: пакет пишет ошибку вместе с числом отправленных. status=failed у такой строки означает «дочерний пакет вернул не COMPLETED», а не «не ушло ничего».',
-            'schedule_id — только прогоны этого расписания; ручные отправки, волны и автоприём регистраций при этом не возвращаются вовсе, они расписанием не запускались.',
-            'status=failed у cold_welcome означает и обрыв процесса: прогон не финализировал себя. outcomes — разбивка «почему не ушло».',
-            'В outcomes чинится оператором: SKIPPED_NO_ANCHOR (нет даты эфира), SKIPPED_TEXT_TOO_LONG (текст длиннее лимита после подстановки), SKIPPED_UNRESOLVED_VARS (переменные текста без значения), SKIPPED_BOT_SILENCED (бот выключен у контакта), SKIPPED_NOT_IN_BASE (контакта нет в базе — сначала импорт файла). Отметка приветствия у них не сгорала — после починки повторный запуск их доберёт.',
-            'SKIPPED_RESEND_PAUSE — оператором НЕ чинится: этим сегментом человеку уже писали, после новой регистрации расписание повторяет ему сегмент, но пауза повтора после последней отправки ещё не прошла (чаще всего сегмент успел уйти ему соседним запуском). Бывает только у прогона расписания; человек вернётся в пул сам.',
-            '⚠️⚠️ sentWithoutChannelEvidence — сколько из sentCount ушло ВСЛЕПУЮ: канал взят резервным транспортом площадки, а не доказан привязками контакта или его ответом. Это ПОДМНОЖЕСТВО отправленных, а не отдельный исход: сообщение ушло, повторять его нельзя. Такие контакты с большой вероятностью получили сообщение в личный кабинет сайта, а не в мессенджер, — по outcomes они неотличимы от дошедших. null (а не 0) означает «счётчик не считался»: волна либо запуск до его появления.',
-            '⚠️ SKIPPED_ANCHOR_IN_PAST — ИСКЛЮЧЕНИЕ из строки выше: дата эфира у контакта ЕСТЬ и устарела (эфир перенесли). Повторный запуск даст ровно тот же исход, сколько ни запускай: автоматический добор якоря — set-if-absent и к заполненному значению не возвращается. Лечится ТОЛЬКО явным перечитыванием якорей из запинённой сделки (POST /api/chat-users/getcourse-anchor-refresh), после которого контакт доберётся обычным запуском.',
+            'История запусков ПЯТИ источников (origin): MANUAL — ручная отправка «Первого сообщения», WAVE — волна по файлу, SCHEDULE — прогон авторассылки, REGISTRATION — автоприём регистраций (строка на день), CAMPAIGN — прогон движка рассылок. У четырёх прежних источников mechanism: COLD_WELCOME — пишем первыми сами, WAVE — отправляет процесс школы. status: RUNNING, COMPLETED, CANCELLED, FAILED; человеку называй подписи (statusLabel, originLabel, label у исходов), а не коды.',
+            'У CAMPAIGN имя, канал, статус словами и автор — в campaignRecord (kind=RUN); card содержит адрес существующей карточки API. Инструмента открытия этой карточки в мосту нет. status и statusLabel совпадают с записью, включая PAUSED, ARCHIVED и пометку stopped; totalContacts — recipients, sentCount — переданные провайдеру строки, включая частичные, failedCount — ошибки/неизвестные без передачи. processed не означает отправлено. stop=null: общую отмену BATCH/JOB не вызывай. allowedTransitions называет допустимые состояния, а не право читателя управлять рассылкой. schedule_id или mailing_variant_id исключает CAMPAIGN. hasMore=true — продолжи с nextCursor без преобразования; ошибку курсора покажи, первую страницу вместо неё не запрашивай.',
+            '⚠️⚠️ Прогон авторассылки (origin=SCHEDULE) называй так же, как вкладки «История» и «Пул сегодня»: «взято · отправлено» из scheduleRun.headline (taken — люди журнала подач, sent — люди с доказанной отправкой). poolMeasured=false — «счётчиков отбора нет», taken=null, и это НЕ ноль: прогон ещё не обращался к источнику. Пул окна свежести (scheduleRun.poolSize) — регистрации всего окна, почти всем из которых уже писали: людьми дня его не называй. У прогона totalContacts — взято (люди журнала подач), sentCount — счётчик попыток прогона (доставленные и занятые без доказательства), failedCount всегда 0, outcomes — null.',
+            'scheduleRun.facts — отправка по людям: sent — отправлено, noMessenger — карточку не завели или ни один выбранный канал не доходит, pending — ещё отправляется, notSent — не ушло по другой причине, notSentByReason — [{code, label, count}], один исход на человека, сумма равна notSent (код — исход отказа отправки, без следа отправки — исход журнала подач). facts=null — «ещё неизвестно»: прогон не завершён и никого не взял; у завершённого прогона без взятых — нули, это доказанный ноль.',
+            'scheduleRun.dayPlan — план по людям из утреннего расчёта «Пула сегодня» ЭТОГО сегмента на день прогона: breakdown — те же числа, что вкладка «Пул» показывает у сегмента (registrations, people, excluded по группам, selected, carriedOver), planned — «Уйдёт» по плану, delta — «Взято» минус план (плюс — добавились к запуску, минус — отпали); dayPlan=null — плана нет, а не нули. scheduleRun.selection — отбор прогона в группах «Пула» (collapsed — несколько регистраций одного человека; excluded — noMessenger, inContact, paid, withManager, blocked, activeSeries, retryPause, overCap, higherPriority, otherPlatform, other, у прогонов до 16.09.2026 ещё held и pause; unrecorded — без записанной причины, должно быть 0). excludedBy и selectedCount — сырые счётчики: selectedCount «взято» не называй, отсев источника фактов в excludedBy (unverifiable и соседи) — до пула, с пулом его не складывай.',
+            '⚠️ scheduleRun.reason — причина закрытия или ожидания словами; приходит и у прогона, доставившего ЧАСТЬ подачи. reasonDetail — текст, который записал сам прогон (у отсрочки из-за источника фактов — подробности). status=RUNNING у прогона, ждущего ресурса, — период не сгорел, проход повторит его сам. guardUnchecked — предохранитель в этот день не проверил часть отобранных (causeLabel — почему): отсев доставки по серии, заявке и оплате в такой день выше обычного.',
+            '⚠️⚠️ Ручная отправка пакетом — ОДНА строка с batch: id строки = batch.batchId, batch.blocks — блоки в порядке исполнения (status=PENDING и importJobId=null — блок ещё не стартовал); totalContacts — план всего пакета, суммы — по всем блокам, mailingVariants — уникальные варианты начавшихся блоков; смешанный пакет принадлежит каждому из них, блоки содержат mailingVariantId/Name. Фильтр варианта сохраняет весь пакет, его время и суммы; сводка варианта считает отправку только его блоков, не начавшиеся запуска не дают, tracedOutcomes у строки пакета null: поимённый разбор — у блоков, по их importJobId. Пакет из одного блока — обычная строка задачи (batch=null). Остановить строку — по полю stop: kind=BATCH — besales_getcourse_cold_welcome_batch_cancel с targetId, kind=JOB — besales_getcourse_cold_welcome_cancel с targetId; stop=null — остановки нет (прогон, волна, день автоприёма, завершённая строка).',
+            SCHEDULE_POOL_GROUPS_HINT,
+            SCHEDULE_EXCLUSION_HINT,
+            'Автоприём регистраций — строка на день registrationDay.day (московский день): sentCount = totalContacts = отправлено за день (списка «взяли» у потока нет), status=RUNNING значит «день ещё идёт», а не «идёт прогон».',
+            'schedule_id — только прогоны этого расписания: ручные отправки, волны и автоприём регистраций не возвращаются вовсе. mailing_variant_id у прогона — рассылка его СНИМКА: сменили рассылку у расписания — вчерашние прогоны остались у прежней. hasMore=true — строк больше, чем limit: сузь выборку фильтром.',
+            'outcomes — [{code, label, count}] ручной отправки: почему человек остался без сообщения. Чинится оператором SKIPPED_NO_ANCHOR, SKIPPED_TEXT_TOO_LONG, SKIPPED_UNRESOLVED_VARS, SKIPPED_BOT_SILENCED, SKIPPED_NOT_IN_BASE — после починки повторный запуск их доберёт; SKIPPED_ANCHOR_IN_PAST — только перечитыванием якорей из сделки (besales_getcourse_anchor_refresh_start); SKIPPED_RESEND_PAUSE оператором не чинится: человек вернётся в пул сам. sentWithoutChannelEvidence — сколько из отправленных ушло вслепую (подмножество отправленных, повторять нельзя); null — не считалось.',
         ]),
     }),
 ];