@besales/mcp 0.33.0 → 0.37.1

package/dist/tools/definitions/getcourse-wave.d.ts

@@ -0,0 +1,147 @@
+export declare const getCourseWaveTools: (import("./shared.js").ToolDefinition<{
+    platform_id: string;
+    crm_id: string;
+    channels: string[];
+    contacts: {
+        contact_id: string;
+        deal_id?: string | undefined;
+        transport?: string | undefined;
+        dialog_id?: string | undefined;
+        email?: string | undefined;
+        phone?: string | undefined;
+        first_name?: string | undefined;
+        last_name?: string | undefined;
+        lead_last_active_at?: string | undefined;
+        segment_entered_at?: string | undefined;
+    }[];
+    workspace_id?: string | undefined;
+    launch_type?: "status" | "board" | "group" | undefined;
+    funnel?: string | undefined;
+    segment?: string | undefined;
+    segment_description?: string | undefined;
+    cohort_label?: string | undefined;
+    mailing_variant_id?: string | undefined;
+    message_variant?: string | undefined;
+    found_count?: number | undefined;
+    product_code?: string | undefined;
+    product_name?: string | undefined;
+    deal_fields?: Record<string, string | number | boolean | null> | undefined;
+    pipeline_id?: number | undefined;
+    status_id?: number | undefined;
+    group_id?: number | undefined;
+    confirm?: boolean | undefined;
+    check_messenger_presence?: boolean | undefined;
+    dedup_window_days?: number | undefined;
+    dedup_scope?: "any" | "same_funnel" | undefined;
+    preflight?: {
+        enabled?: boolean | undefined;
+        product_title?: string | undefined;
+        product_match_key?: string | undefined;
+        offer_id?: number | undefined;
+        other_product_active_deal_mode?: "warn" | "block" | "ignore" | undefined;
+    } | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    job_id: string;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    platform_id: string;
+    crm_id: string;
+    channels: string[];
+    contacts: {
+        contact_id: string;
+        deal_id?: string | undefined;
+        transport?: string | undefined;
+        dialog_id?: string | undefined;
+        email?: string | undefined;
+        phone?: string | undefined;
+        first_name?: string | undefined;
+        last_name?: string | undefined;
+        lead_last_active_at?: string | undefined;
+        segment_entered_at?: string | undefined;
+    }[];
+    workspace_id?: string | undefined;
+    launch_key?: string | undefined;
+    dry_run_hash?: string | undefined;
+    launch_type?: "status" | undefined;
+    funnel?: string | undefined;
+    segment?: string | undefined;
+    segment_description?: string | undefined;
+    cohort_label?: string | undefined;
+    mailing_variant_id?: string | undefined;
+    message_variant?: string | undefined;
+    found_count?: number | undefined;
+    product_code?: string | undefined;
+    product_name?: string | undefined;
+    deal_fields?: Record<string, string | number | boolean | null> | undefined;
+    confirm?: boolean | undefined;
+    check_messenger_presence?: boolean | undefined;
+    dedup_window_days?: number | undefined;
+    dedup_scope?: "any" | "same_funnel" | undefined;
+    preflight?: {
+        enabled?: boolean | undefined;
+        product_title?: string | undefined;
+        product_match_key?: string | undefined;
+        offer_id?: number | undefined;
+        other_product_active_deal_mode?: "warn" | "block" | "ignore" | undefined;
+    } | undefined;
+    chunk_size?: number | undefined;
+    explicit_confirmation?: true | undefined;
+    confirmation_reason?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    run_id: string;
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    run_id: string;
+    workspace_id?: string | undefined;
+    status?: "PENDING" | "CLAIMED" | "SENT" | "SKIPPED" | "FAILED" | "UNKNOWN" | undefined;
+    cursor?: string | undefined;
+    limit?: number | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    batch_key: string;
+    platform_id: string;
+    crm_id: string;
+    segments: {
+        contacts: {
+            contact_id: string;
+            deal_id?: string | undefined;
+            transport?: string | undefined;
+            dialog_id?: string | undefined;
+            email?: string | undefined;
+            phone?: string | undefined;
+            first_name?: string | undefined;
+            last_name?: string | undefined;
+            lead_last_active_at?: string | undefined;
+            segment_entered_at?: string | undefined;
+        }[];
+        channels: string[];
+        deal_fields: Record<string, string | number | boolean | null>;
+        launch_type?: "status" | undefined;
+        funnel?: string | undefined;
+        segment?: string | undefined;
+        segment_description?: string | undefined;
+        cohort_label?: string | undefined;
+        mailing_variant_id?: string | undefined;
+        message_variant?: string | undefined;
+        found_count?: number | undefined;
+        product_code?: string | undefined;
+        product_name?: string | undefined;
+        preflight?: {
+            enabled?: boolean | undefined;
+            product_title?: string | undefined;
+            product_match_key?: string | undefined;
+            offer_id?: number | undefined;
+            other_product_active_deal_mode?: "warn" | "block" | "ignore" | undefined;
+        } | undefined;
+        check_messenger_presence?: boolean | undefined;
+        dedup_window_days?: number | undefined;
+        dedup_scope?: "any" | "same_funnel" | undefined;
+        chunk_size?: number | undefined;
+    }[];
+    workspace_id?: string | undefined;
+    confirm?: boolean | undefined;
+    explicit_confirmation?: true | undefined;
+    confirmation_reason?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    batch_id: string;
+    workspace_id?: string | undefined;
+}>)[];

package/dist/tools/definitions/getcourse-wave.js

@@ -0,0 +1,505 @@
+import { z } from 'zod';
+import { compactObject, defineTool, uuidSchema, withInstructions } from './shared.js';
+const BROADCAST_SEGMENT_DESCRIPTION_MAX_LENGTH = 4000;
+const UNCERTAIN_WAVE_OUTCOME_INSTRUCTION = 'UNKNOWN и FAILED с неопределённым внешним исходом жёстко блокируются между волнами: repeat-режим и dedup_window_days=0 их не обходят. Повтор допустим только для FAILED, который подтверждённо возник до внешней отправки; остальные случаи требуют отдельного ручного разбора исхода.';
+const getCourseWaveContactSchema = z.object({
+    contact_id: z.string(),
+    deal_id: z.string().optional(),
+    transport: z.string().optional(),
+    dialog_id: z.string().optional(),
+    email: z.string().email().max(320).optional(),
+    phone: z.string().max(64).optional(),
+    first_name: z.string().max(200).optional(),
+    last_name: z.string().max(200).optional(),
+    lead_last_active_at: z.string().datetime({ offset: true }).optional(),
+    segment_entered_at: z.string().datetime({ offset: true }).optional(),
+});
+const mapGetCourseWaveContact = (contact) => compactObject({
+    contactId: contact.contact_id,
+    dealId: contact.deal_id,
+    transport: contact.transport,
+    dialogId: contact.dialog_id,
+    email: contact.email,
+    phone: contact.phone,
+    firstName: contact.first_name,
+    lastName: contact.last_name,
+    leadLastActiveAt: contact.lead_last_active_at,
+    segmentEnteredAt: contact.segment_entered_at,
+});
+export const getCourseWaveTools = [
+    defineTool({
+        name: 'besales_getcourse_wave_import',
+        requiredFields: ['platform_id', 'crm_id', 'channels', 'contacts'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            platform_id: uuidSchema,
+            crm_id: uuidSchema,
+            launch_type: z.enum(['status', 'board', 'group']).optional(),
+            channels: z.array(z.string()).min(1),
+            funnel: z.string().max(200).optional(),
+            segment: z.string().max(200).optional(),
+            segment_description: z.string().max(BROADCAST_SEGMENT_DESCRIPTION_MAX_LENGTH).optional(),
+            cohort_label: z.string().max(200).optional(),
+            mailing_variant_id: uuidSchema.optional(),
+            message_variant: z.string().max(120).optional(),
+            found_count: z.number().int().min(0).max(10_000_000).optional(),
+            product_code: z
+                .string()
+                .trim()
+                .max(100)
+                .regex(/^[^\s/]+$/, 'product_code: без пробелов и «/»')
+                .optional(),
+            product_name: z.string().max(200).optional(),
+            deal_fields: z
+                .record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()]))
+                .optional(),
+            pipeline_id: z.number().int().positive().optional(),
+            status_id: z.number().int().positive().optional(),
+            group_id: z.number().int().positive().optional(),
+            contacts: z.array(getCourseWaveContactSchema).min(1).max(500),
+            confirm: z.boolean().optional(),
+            check_messenger_presence: z.boolean().optional(),
+            dedup_window_days: z.number().int().min(0).max(365).optional(),
+            dedup_scope: z.enum(['any', 'same_funnel']).optional(),
+            preflight: z
+                .object({
+                enabled: z.boolean().optional(),
+                product_title: z.string().max(500).optional(),
+                product_match_key: z.string().max(500).optional(),
+                offer_id: z.number().int().positive().optional(),
+                other_product_active_deal_mode: z.enum(['warn', 'block', 'ignore']).optional(),
+            })
+                .optional(),
+        })
+            .refine((input) => input.segment_description === undefined || Boolean(input.segment?.trim()), {
+            message: 'segment_description требует непустой segment',
+            path: ['segment_description'],
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-waves/import`,
+            body: compactObject({
+                platformId: input.platform_id,
+                crmId: input.crm_id,
+                launchType: input.launch_type,
+                channels: input.channels,
+                funnel: input.funnel,
+                segment: input.segment,
+                segmentDescription: input.segment_description,
+                cohortLabel: input.cohort_label,
+                mailingVariantId: input.mailing_variant_id,
+                messageVariant: input.message_variant,
+                foundCount: input.found_count,
+                productCode: input.product_code,
+                productName: input.product_name,
+                dealFields: input.deal_fields,
+                pipelineId: input.pipeline_id,
+                statusId: input.status_id,
+                groupId: input.group_id,
+                dedupWindowDays: input.dedup_window_days,
+                dedupScope: input.dedup_scope,
+                contacts: input.contacts?.map(mapGetCourseWaveContact),
+                confirm: input.confirm,
+                checkMessengerPresence: input.check_messenger_presence,
+                preflight: input.preflight
+                    ? compactObject({
+                        enabled: input.preflight.enabled,
+                        productTitle: input.preflight.product_title,
+                        productMatchKey: input.preflight.product_match_key,
+                        offerId: input.preflight.offer_id,
+                        otherProductActiveDealMode: input.preflight.other_product_active_deal_mode,
+                    })
+                    : undefined,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Запуск outbound-волны GetCourse: Шаг 1 (импорт контактов + пин сделок) → Шаг 2 (отправка). По умолчанию launch_type=status (простановка полей → «Процесс» GetCourse шлёт welcome).',
+            'БЕЗ confirm=true — DRY-RUN: вернётся summary (totalContacts/withDeal/channels/dealFields/sample), НИЧЕГО не отправляется. Покажи summary пользователю и запускай реально только с confirm=true.',
+            'channels — значения GetCourseTransport: "VK" | "Telegram" | "MAX" | "SMS" | "Email" | "Site" (для аналитики «Канал волны»).',
+            'funnel — канонический ключ/название БИЗНЕС-воронки. Не передавай сюда имя файла, batch/resend или дату запуска. cohort_label — человекочитаемое имя конкретного запуска волны.',
+            'mailing_variant_id — ID именованного «Варианта рассылки» из besales_broadcast_mailing_variant_list/create. Backend tenant-scoped проверяет активность и сохраняет связь для фильтра аналитики.',
+            'segment_description — явное бизнес-правило отбора segment. Передавай только вместе с segment: новый сегмент создастся с описанием, существующий явно обновит его. Если описание не передать, сохранённый текст не изменится.',
+            'contacts[].segment_entered_at — точный ISO-момент попадания контакта в сегмент. contacts[].lead_last_active_at — только legacy/последняя активность; не используй её как замену segment_entered_at.',
+            'launch_type=status требует deal_fields = { "<числовой fieldId GetCourse>": значение } (одинаковые на всю волну). board требует pipeline_id+status_id, group — group_id.',
+            'preflight (default enabled=true) — pre-send гейт перед каждой строкой Шага 2: блокирует контакт, если уже есть активная/оплаченная сделка по этому продукту или проверка GetCourse упала. Передавай product_title/product_match_key или funnel; если контекста продукта нет вообще, backend отклонит запуск до создания job.',
+            'В ответе confirm-запуска — waveJobId. Опрашивай его через besales_getcourse_wave_status до status=COMPLETED (Шаг 2 идёт медленно, с паузами).',
+            'check_messenger_presence (default TRUE): на Шаге 1 отсеивает контакты без мессенджера (Telegram/Max/VK) — они не импортируются и не уходят в волну (число — в contactsSkippedNoMessenger). Проверка = API-вызов на КАЖДЫЙ контакт, запуск синхронно ждёт Шаг 1 → для БОЛЬШИХ когорт (сотни контактов) возможен таймаут: тогда ставь check_messenger_presence=false и сначала прогони backfill POST /api/v2/.../chat-users/import/getcourse-refresh-messengers.',
+            'dedup_window_days (default 30, 0–365) и dedup_scope (default any | same_funnel): any учитывает любую прошлую волну, same_funnel — ту же каноническую бизнес-воронку (legacy batch/resend-суффиксы игнорируются). 0 = выключить дедуп полностью — только для осознанного повторного запуска.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_wave_status',
+        requiredFields: ['job_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            job_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/getcourse-waves/${input.job_id}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Статус волны (джоб Шага 2): status (PROCESSING|COMPLETED), processedRows/successCount/failedCount, errorReasons (первые построчные ошибки), preflight aggregates.',
+            'COMPLETED + failedCount>0 — часть контактов не прошла (см. errorReasons: нет сделки, поле вне «Предложения» заказа и т.п.).',
+            'preflight.blocked/errors — контакты, которым НЕ отправляли; BroadcastRecipient для них не создаётся, поэтому received в аналитике не раздувается.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_wave_run_start',
+        requiredFields: ['platform_id', 'crm_id', 'channels', 'contacts'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            platform_id: uuidSchema,
+            crm_id: uuidSchema,
+            launch_key: uuidSchema.optional(),
+            dry_run_hash: z.string().regex(/^[0-9a-f]{64}$/).optional(),
+            launch_type: z.literal('status').optional(),
+            channels: z.array(z.string()).min(1),
+            funnel: z.string().max(200).optional(),
+            segment: z.string().max(200).optional(),
+            segment_description: z.string().max(BROADCAST_SEGMENT_DESCRIPTION_MAX_LENGTH).optional(),
+            cohort_label: z.string().max(200).optional(),
+            mailing_variant_id: uuidSchema.optional(),
+            message_variant: z.string().max(120).optional(),
+            found_count: z.number().int().min(0).max(10_000_000).optional(),
+            product_code: z
+                .string()
+                .trim()
+                .max(100)
+                .regex(/^[^\s/]+$/, 'product_code: без пробелов и «/»')
+                .optional(),
+            product_name: z.string().max(200).optional(),
+            deal_fields: z
+                .record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()]))
+                .optional(),
+            contacts: z.array(getCourseWaveContactSchema).min(1).max(5000),
+            confirm: z.boolean().optional(),
+            check_messenger_presence: z.boolean().optional(),
+            dedup_window_days: z.number().int().min(0).max(365).optional(),
+            dedup_scope: z.enum(['any', 'same_funnel']).optional(),
+            preflight: z
+                .object({
+                enabled: z.boolean().optional(),
+                product_title: z.string().max(500).optional(),
+                product_match_key: z.string().max(500).optional(),
+                offer_id: z.number().int().positive().optional(),
+                other_product_active_deal_mode: z.enum(['warn', 'block', 'ignore']).optional(),
+            })
+                .optional(),
+            chunk_size: z.number().int().min(1).max(500).optional(),
+            explicit_confirmation: z.literal(true).optional(),
+            confirmation_reason: z.string().optional(),
+        })
+            .refine((input) => input.segment_description === undefined || Boolean(input.segment?.trim()), {
+            message: 'segment_description требует непустой segment',
+            path: ['segment_description'],
+        })
+            .refine((input) => !input.confirm || input.explicit_confirmation === true, {
+            message: 'Реальный запуск требует explicit_confirmation=true: отправка волны необратима',
+            path: ['explicit_confirmation'],
+        })
+            .refine((input) => !input.confirm || Boolean(input.launch_key), {
+            message: 'confirm=true требует стабильный launch_key UUID',
+            path: ['launch_key'],
+        })
+            .refine((input) => !input.confirm || Boolean(input.dry_run_hash), {
+            message: 'confirm=true требует dry_run_hash из предыдущего dry-run',
+            path: ['dry_run_hash'],
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-wave-runs`,
+            body: compactObject({
+                platformId: input.platform_id,
+                crmId: input.crm_id,
+                launchKey: input.launch_key,
+                dryRunHash: input.dry_run_hash,
+                launchType: input.launch_type,
+                channels: input.channels,
+                funnel: input.funnel,
+                segment: input.segment,
+                segmentDescription: input.segment_description,
+                cohortLabel: input.cohort_label,
+                mailingVariantId: input.mailing_variant_id,
+                messageVariant: input.message_variant,
+                foundCount: input.found_count,
+                productCode: input.product_code,
+                productName: input.product_name,
+                dealFields: input.deal_fields,
+                contacts: input.contacts?.map(mapGetCourseWaveContact),
+                confirm: input.confirm,
+                checkMessengerPresence: input.check_messenger_presence,
+                dedupWindowDays: input.dedup_window_days,
+                dedupScope: input.dedup_scope,
+                preflight: input.preflight
+                    ? compactObject({
+                        enabled: input.preflight.enabled,
+                        productTitle: input.preflight.product_title,
+                        productMatchKey: input.preflight.product_match_key,
+                        offerId: input.preflight.offer_id,
+                        otherProductActiveDealMode: input.preflight.other_product_active_deal_mode,
+                    })
+                    : undefined,
+                chunkSize: input.chunk_size,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Durable-прогон сам режет когорту на куски и отправляет их последовательно, сам ждёт освобождения лока импорта и переживает рестарт сервиса. Опрашивай ОДИН прогон через besales_getcourse_wave_run_status, не собирай волну вручную.',
+            'mailing_variant_id — ID именованного «Варианта рассылки» из besales_broadcast_mailing_variant_list/create. Backend tenant-scoped проверяет активность и сохраняет связь для фильтра аналитики.',
+            'БЕЗ confirm=true — DRY-RUN: возвращается проверка, но прогон НЕ создаётся и ничего не отправляется.',
+            'Реальный запуск требует confirm=true, explicit_confirmation=true, launch_key и dry_run_hash из последнего dry-run. Сгенерируй launch_key один раз на намерение и повторяй ТОТ ЖЕ ключ при сетевом ретрае.',
+            'Поддерживается ТОЛЬКО launch_type=status. Для board/group используй старый besales_getcourse_wave_import.',
+            'HTTP 409 означает, что на платформе уже идёт активный прогон: в ответе есть его runId — не создавай новую волну, опрашивай этот runId.',
+            'Статус прогона отдаёт только агрегаты. Полный построчный разбор получай через besales_getcourse_wave_run_contacts с курсорной пагинацией.',
+            'Исходы контактов: SENT — отправлено; SKIPPED — дедуп, нет мессенджера или preflight заблокировал; FAILED — построчная ошибка; UNKNOWN — исход НЕИЗВЕСТЕН: кусок был прерван, но отправка могла состояться.',
+            UNCERTAIN_WAVE_OUTCOME_INSTRUCTION,
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_wave_run_status',
+        requiredFields: ['run_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            run_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/getcourse-wave-runs/${input.run_id}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Это единый агрегированный статус durable-прогона: он сам последовательно обрабатывает куски, ждёт лок импорта и продолжает после рестарта сервиса. Не собирай и не запускай куски вручную.',
+            'Статус содержит только агрегаты. Для полного построчного разбора используй besales_getcourse_wave_run_contacts с курсорной пагинацией.',
+            'SENT — отправлено; SKIPPED — дедуп, нет мессенджера или блокировка preflight; FAILED — построчная ошибка; UNKNOWN — исход НЕИЗВЕСТЕН после прерванного куска, отправка могла состояться.',
+            UNCERTAIN_WAVE_OUTCOME_INSTRUCTION,
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_wave_run_contacts',
+        requiredFields: ['run_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            run_id: uuidSchema,
+            status: z
+                .enum(['PENDING', 'CLAIMED', 'SENT', 'SKIPPED', 'FAILED', 'UNKNOWN'])
+                .optional(),
+            cursor: uuidSchema.optional(),
+            limit: z.number().int().min(1).max(500).optional(),
+        }),
+        createRequest: (input) => {
+            const params = new URLSearchParams();
+            if (input.status)
+                params.set('status', input.status);
+            if (input.cursor)
+                params.set('cursor', input.cursor);
+            if (input.limit !== undefined)
+                params.set('limit', String(input.limit));
+            const query = params.toString();
+            return {
+                method: 'GET',
+                path: `/workspaces/${input.workspace_id}/getcourse-wave-runs/${input.run_id}/contacts${query ? `?${query}` : ''}`,
+            };
+        },
+        enhanceResponse: (response) => withInstructions(response, [
+            'Полный построчный разбор durable-прогона. Продолжай курсорную пагинацию по nextCursor до конца; агрегированный besales_getcourse_wave_run_status строк контактов не возвращает.',
+            'Фильтр status: PENDING | CLAIMED | SENT | SKIPPED | FAILED | UNKNOWN. SKIPPED означает дедуп, отсутствие мессенджера или блокировку preflight; FAILED — построчную ошибку.',
+            'UNKNOWN означает, что исход НЕИЗВЕСТЕН: кусок был прерван, но отправка могла состояться.',
+            UNCERTAIN_WAVE_OUTCOME_INSTRUCTION,
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_wave_run_cancel',
+        requiredFields: ['run_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            run_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-wave-runs/${input.run_id}/cancel`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Отмена запрещает прогону заявлять новые куски. Уже заявленный кусок может завершиться; после отмены опроси besales_getcourse_wave_run_status.',
+            'Для полного построчного результата используй besales_getcourse_wave_run_contacts с курсорной пагинацией; статус прогона отдаёт только агрегаты.',
+            'UNKNOWN — исход НЕИЗВЕСТЕН после прерванного куска, отправка могла состояться.',
+            UNCERTAIN_WAVE_OUTCOME_INSTRUCTION,
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_wave_run_batch_start',
+        requiredFields: ['batch_key', 'platform_id', 'crm_id', 'segments'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            batch_key: z.string(),
+            platform_id: uuidSchema,
+            crm_id: uuidSchema,
+            segments: z
+                .array(z
+                .object({
+                // Имя поля обязано совпадать с WaveLaunchParamsDto.launchType: у бэкенда
+                // включён forbidNonWhitelisted, поэтому лишний ключ роняет весь батч в 400.
+                launch_type: z.literal('status').optional(),
+                contacts: z.array(getCourseWaveContactSchema).min(1).max(2000),
+                channels: z.array(z.string()).min(1),
+                deal_fields: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()])),
+                funnel: z.string().max(200).optional(),
+                segment: z.string().max(200).optional(),
+                segment_description: z
+                    .string()
+                    .max(BROADCAST_SEGMENT_DESCRIPTION_MAX_LENGTH)
+                    .optional(),
+                cohort_label: z.string().max(200).optional(),
+                mailing_variant_id: uuidSchema.optional(),
+                message_variant: z.string().max(120).optional(),
+                found_count: z.number().int().min(0).max(10_000_000).optional(),
+                product_code: z
+                    .string()
+                    .trim()
+                    .max(100)
+                    .regex(/^[^\s/]+$/, 'product_code: без пробелов и «/»')
+                    .optional(),
+                product_name: z.string().max(200).optional(),
+                preflight: z
+                    .object({
+                    enabled: z.boolean().optional(),
+                    product_title: z.string().max(500).optional(),
+                    product_match_key: z.string().max(500).optional(),
+                    offer_id: z.number().int().positive().optional(),
+                    other_product_active_deal_mode: z.enum(['warn', 'block', 'ignore']).optional(),
+                })
+                    .optional(),
+                check_messenger_presence: z.boolean().optional(),
+                dedup_window_days: z.number().int().min(1).max(365).optional(),
+                dedup_scope: z.enum(['any', 'same_funnel']).optional(),
+                chunk_size: z.number().int().min(1).max(500).optional(),
+            })
+                .strict()
+                .refine((segment) => segment.segment_description === undefined || Boolean(segment.segment?.trim()), {
+                message: 'segment_description требует непустой segment',
+                path: ['segment_description'],
+            }))
+                .min(1)
+                .max(10)
+                .refine((segments) => segments.reduce((total, segment) => total + segment.contacts.length, 0) <= 5000, {
+                message: 'В батче может быть не более 5000 контактов суммарно',
+            }),
+            confirm: z.boolean().optional(),
+            explicit_confirmation: z.literal(true).optional(),
+            confirmation_reason: z.string().optional(),
+        })
+            .refine((input) => !input.confirm || input.explicit_confirmation === true, {
+            message: 'Реальный запуск требует explicit_confirmation=true: отправка волны необратима',
+            path: ['explicit_confirmation'],
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-wave-runs/batch`,
+            body: compactObject({
+                batchKey: input.batch_key,
+                platformId: input.platform_id,
+                crmId: input.crm_id,
+                segments: input.segments.map((segment) => compactObject({
+                    launchType: segment.launch_type,
+                    contacts: segment.contacts.map(mapGetCourseWaveContact),
+                    channels: segment.channels,
+                    dealFields: segment.deal_fields,
+                    funnel: segment.funnel,
+                    segment: segment.segment,
+                    segmentDescription: segment.segment_description,
+                    cohortLabel: segment.cohort_label,
+                    mailingVariantId: segment.mailing_variant_id,
+                    messageVariant: segment.message_variant,
+                    foundCount: segment.found_count,
+                    productCode: segment.product_code,
+                    productName: segment.product_name,
+                    preflight: segment.preflight
+                        ? compactObject({
+                            enabled: segment.preflight.enabled,
+                            productTitle: segment.preflight.product_title,
+                            productMatchKey: segment.preflight.product_match_key,
+                            offerId: segment.preflight.offer_id,
+                            otherProductActiveDealMode: segment.preflight.other_product_active_deal_mode,
+                        })
+                        : undefined,
+                    checkMessengerPresence: segment.check_messenger_presence,
+                    dedupWindowDays: segment.dedup_window_days,
+                    dedupScope: segment.dedup_scope,
+                    chunkSize: segment.chunk_size,
+                })),
+                confirm: input.confirm,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Очередь исполняет сегменты ПОСЛЕДОВАТЕЛЬНО: в один момент на платформе идёт только один прогон. Опрашивай ОДИН besales_getcourse_wave_run_batch_status, не собирай сегменты и их статусы вручную.',
+            'Для каждого сегмента mailing_variant_id — ID именованного «Варианта рассылки» из besales_broadcast_mailing_variant_list/create. Перед запуском backend повторно tenant-scoped проверяет активность всех вариантов под транзакционным lock.',
+            'batch_key сгенерируй ОДИН раз на попытку и ПЕРЕИСПОЛЬЗУЙ при ретрае: это ключ идемпотентности. Повтор с тем же ключом вернёт существующий батч; новый ключ создаст ВТОРУЮ копию кампании, которую дедуп не остановит.',
+            'Если повторить тот же batch_key с ИЗМЕНЁННЫМ составом сегментов, сервер вернёт HTTP 409 «ключ занят другим составом». Не меняй состав при ретрае — сначала прочитай статус существующего батча.',
+            'HTTP 400 отклоняет батч до запуска, если контакт есть в двух сегментах, пересекается с незавершённым прогоном платформы или ему уже отправляли за последние 30 дней. В ответе будут пары contactId + сегменты либо конфликтующий runId; исправь состав, а не обходи проверку новым ключом.',
+            'Два подряд отказавших сегмента ставят батч на паузу. Продолжай только через besales_getcourse_wave_run_batch_resume после проверки причин отказов.',
+            UNCERTAIN_WAVE_OUTCOME_INSTRUCTION,
+            'БЕЗ confirm=true — DRY-RUN: батч не создаётся и ничего не отправляется. Реальный запуск дополнительно требует MCP-only explicit_confirmation=true; это поле в HTTP-запрос не передаётся.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_wave_run_batch_status',
+        requiredFields: ['batch_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            batch_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/getcourse-wave-runs/batches/${input.batch_id}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Это ЕДИНСТВЕННЫЙ агрегированный статус очереди: она запускает сегменты последовательно и держит только один прогон на платформу. Опрашивай этот batch-status, а не статусы сегментов вручную.',
+            'Если батч на паузе после двух подряд отказавших сегментов, сначала проверь причины, затем снимай паузу только besales_getcourse_wave_run_batch_resume.',
+            UNCERTAIN_WAVE_OUTCOME_INSTRUCTION,
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_wave_run_batch_cancel',
+        requiredFields: ['batch_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            batch_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-wave-runs/batches/${input.batch_id}/cancel`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Отмена останавливает очередь батча; после неё опроси ОДИН besales_getcourse_wave_run_batch_status, не собирая сегменты вручную.',
+            UNCERTAIN_WAVE_OUTCOME_INSTRUCTION,
+        ]),
+    }),
+    defineTool({
+        name: 'besales_getcourse_wave_run_batch_resume',
+        requiredFields: ['batch_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            batch_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/getcourse-wave-runs/batches/${input.batch_id}/resume`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Снимает паузу батча, которую вызывают два подряд отказавших сегмента. После resume опрашивай ОДИН besales_getcourse_wave_run_batch_status: очередь продолжит сегменты последовательно, один прогон на платформу.',
+            UNCERTAIN_WAVE_OUTCOME_INSTRUCTION,
+        ]),
+    }),
+];
+//# sourceMappingURL=getcourse-wave.js.map