@besales/mcp 0.33.0 → 0.37.0

package/dist/tools/definitions/platform-setup.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { refineFollowUpConfig } from './follow-up.js';
-import { agentOutputConfigSchema, agentRuntimeConfigSchema, agentScopeSchema, agentToolPatchSchema, anyObjectSchema, behaviorErrorHandlingSchema, behaviorGreetingSchema, behaviorMediaHandlingSchema, behaviorMessageFilterSchema, behaviorMessageSplittingSchema, behaviorOperatorScheduleSchema, behaviorPrivacySchema, behaviorTypingBehaviorSchema, behaviorUrlHandlingSchema, compactObject, defineTool, feedbackSheetRowSchema, followUpSequenceTypeSchema, followUpTriggerSchema, mapBehaviorErrorHandlingInput, mapBehaviorGreetingInput, mapBehaviorMediaHandlingInput, mapBehaviorOperatorScheduleInput, mapBehaviorTypingInput, mapBehaviorUrlHandlingInput, mapOutputConfigInput, mapPipelineAutoFinishInput, mapPipelineCrmBehaviorInput, mapPlatformAccessControlInput, mapPlatformBitrix24BotSettingsInput, mapPlatformCrmBehaviorInput, mapPlatformGeneralSettingsInput, mapPlatformGetcourseSettingsInput, mapPlatformInstagramCommentInput, mapPlatformSalebotSettingsInput, mapPlatformSmsgorodSettingsInput, mapPlatformVariablesConfigInput, mapPlatformWidgetMarketingInput, mapRuntimeConfigInput, modelLaneSchema, pipelineAutoFinishSchema, pipelineCrmBehaviorSchema, platformAccessControlSchema, platformBitrix24BotSettingsSchema, platformCrmBehaviorSchema, platformGeneralSettingsSchema, platformGetcourseSettingsSchema, platformInstagramCommentSchema, platformSalebotSettingsSchema, platformSetupConfirmationSchema, platformSmsgorodSettingsSchema, platformVariablesConfigSchema, platformWidgetMarketingSchema, routingRuleConditionSchema, routingRuleLeadStatusSchema, routingStrategySchema, setupConfirmation, triggerScopeSchema, uuidSchema, withInstructions, } from './shared.js';
+import { getCourseWaveTools } from './getcourse-wave.js';
+import { agentOutputConfigSchema, agentRuntimeConfigSchema, agentScopeSchema, agentToolPatchSchema, anyObjectSchema, behaviorErrorHandlingSchema, behaviorGreetingSchema, behaviorMediaHandlingSchema, behaviorMessageFilterSchema, behaviorMessageSplittingSchema, behaviorOperatorScheduleSchema, behaviorPrivacySchema, behaviorTypingBehaviorSchema, behaviorUrlHandlingSchema, buildListQuery, compactObject, defineTool, feedbackSheetRowSchema, followUpSequenceTypeSchema, followUpTriggerSchema, mapBehaviorErrorHandlingInput, mapBehaviorGreetingInput, mapBehaviorMediaHandlingInput, mapBehaviorOperatorScheduleInput, mapBehaviorTypingInput, mapBehaviorUrlHandlingInput, mapOutputConfigInput, mapPipelineAutoFinishInput, mapPipelineCrmBehaviorInput, mapPlatformAccessControlInput, mapPlatformBitrix24BotSettingsInput, mapPlatformCrmBehaviorInput, mapPlatformGeneralSettingsInput, mapPlatformGetcourseSettingsInput, mapPlatformInstagramCommentInput, mapPlatformSalebotSettingsInput, mapPlatformSmsgorodSettingsInput, mapPlatformVariablesConfigInput, mapPlatformWidgetMarketingInput, mapRuntimeConfigInput, modelLaneSchema, pipelineAutoFinishSchema, pipelineCrmBehaviorSchema, platformAccessControlSchema, platformBitrix24BotSettingsSchema, platformCrmBehaviorSchema, platformGeneralSettingsSchema, platformGetcourseSettingsSchema, platformInstagramCommentSchema, platformSalebotSettingsSchema, platformSetupConfirmationSchema, platformSmsgorodSettingsSchema, platformVariablesConfigSchema, mapPromptPatchOperationInput, platformWidgetMarketingSchema, PROMPT_BATCH_IDEMPOTENCY_KEY_MAX_LENGTH, PROMPT_BATCH_MAX_AGENTS, PROMPT_DIFF_MAX_LINES_LIMIT, promptPatchOperationSchema, routingRuleConditionSchema, routingRuleLeadStatusSchema, routingStrategySchema, setupConfirmation, triggerScopeSchema, uuidSchema, withInstructions, } from './shared.js';
 export const platformSetupTools = [
     defineTool({
         name: 'besales_workspace_overview',
@@ -79,484 +80,7 @@ export const platformSetupTools = [
             'Используй department.id как target_department_id в besales_platform_settings_update (getcourse_settings) для department-routing.',
         ]),
     }),
-    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(),
-            cohort_label: z.string().max(200).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(z.object({
-                contact_id: z.string(),
-                deal_id: z.string().optional(),
-                transport: z.string().optional(),
-                dialog_id: z.string().optional(),
-                lead_last_active_at: z.string().datetime({ offset: true }).optional(),
-                segment_entered_at: z.string().datetime({ offset: true }).optional(),
-            }))
-                .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(),
-        }),
-        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,
-                cohortLabel: input.cohort_label,
-                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((c) => compactObject({
-                    contactId: c.contact_id,
-                    dealId: c.deal_id,
-                    transport: c.transport,
-                    dialogId: c.dialog_id,
-                    leadLastActiveAt: c.lead_last_active_at,
-                    segmentEnteredAt: c.segment_entered_at,
-                })),
-                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 — человекочитаемое имя конкретного запуска волны.',
-            '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_type: z.literal('status').optional(),
-            channels: z.array(z.string()).min(1),
-            funnel: z.string().max(200).optional(),
-            segment: z.string().max(200).optional(),
-            cohort_label: z.string().max(200).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(z.object({
-                contact_id: z.string(),
-                deal_id: z.string().optional(),
-                transport: z.string().optional(),
-                dialog_id: z.string().optional(),
-                lead_last_active_at: z.string().datetime({ offset: true }).optional(),
-                segment_entered_at: z.string().datetime({ offset: true }).optional(),
-            }))
-                .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.confirm || input.explicit_confirmation === true, {
-            message: 'Реальный запуск требует explicit_confirmation=true: отправка волны необратима',
-            path: ['explicit_confirmation'],
-        }),
-        createRequest: (input) => ({
-            method: 'POST',
-            path: `/workspaces/${input.workspace_id}/getcourse-wave-runs`,
-            body: compactObject({
-                platformId: input.platform_id,
-                crmId: input.crm_id,
-                launchType: input.launch_type,
-                channels: input.channels,
-                funnel: input.funnel,
-                segment: input.segment,
-                cohortLabel: input.cohort_label,
-                messageVariant: input.message_variant,
-                foundCount: input.found_count,
-                productCode: input.product_code,
-                productName: input.product_name,
-                dealFields: input.deal_fields,
-                contacts: input.contacts?.map((contact) => compactObject({
-                    contactId: contact.contact_id,
-                    dealId: contact.deal_id,
-                    transport: contact.transport,
-                    dialogId: contact.dialog_id,
-                    leadLastActiveAt: contact.lead_last_active_at,
-                    segmentEnteredAt: contact.segment_entered_at,
-                })),
-                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, не собирай волну вручную.',
-            'БЕЗ confirm=true — DRY-RUN: возвращается проверка, но прогон НЕ создаётся и ничего не отправляется.',
-            'Реальный запуск требует ОДНОВРЕМЕННО confirm=true и explicit_confirmation=true. explicit_confirmation — MCP-гейт явного согласия оператора и в HTTP-запрос не передаётся.',
-            'Поддерживается ТОЛЬКО launch_type=status. Для board/group используй старый besales_getcourse_wave_import.',
-            'HTTP 409 означает, что на платформе уже идёт активный прогон: в ответе есть его runId — не создавай новую волну, опрашивай этот runId.',
-            'Статус прогона отдаёт только агрегаты. Полный построчный разбор получай через besales_getcourse_wave_run_contacts с курсорной пагинацией.',
-            'Исходы контактов: SENT — отправлено; SKIPPED — дедуп, нет мессенджера или preflight заблокировал; FAILED — построчная ошибка; UNKNOWN — исход НЕИЗВЕСТЕН: кусок был прерван, но отправка могла состояться.',
-            'UNKNOWN и FAILED НИКОГДА не переотправляются автоматически. Повторная отправка таких контактов — только осознанное решение оператора отдельной волной: отсутствие строки получателя не доказывает отсутствие отправки.',
-        ]),
-    }),
-    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 — исход НЕИЗВЕСТЕН после прерванного куска, отправка могла состояться.',
-            'UNKNOWN и FAILED НИКОГДА не переотправляются автоматически. Решение о повторе принимает оператор и запускает отдельную волну, потому что отсутствие строки получателя не доказывает отсутствие отправки.',
-        ]),
-    }),
-    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 означает, что исход НЕИЗВЕСТЕН: кусок был прерван, но отправка могла состояться. UNKNOWN и FAILED НИКОГДА не переотправляются автоматически.',
-            'Повтор UNKNOWN/FAILED допустим только осознанным решением оператора отдельной волной: отсутствие строки получателя не доказывает отсутствие отправки.',
-        ]),
-    }),
-    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 — исход НЕИЗВЕСТЕН после прерванного куска, отправка могла состояться. UNKNOWN и FAILED автоматически не переотправляются; повтор возможен только отдельной волной по осознанному решению оператора.',
-        ]),
-    }),
-    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({
-                mode: z.literal('status'),
-                contacts: z
-                    .array(z.object({
-                    contact_id: z.string(),
-                    deal_id: z.string().optional(),
-                    transport: z.string().optional(),
-                    dialog_id: z.string().optional(),
-                    lead_last_active_at: z.string().datetime({ offset: true }).optional(),
-                    segment_entered_at: z.string().datetime({ offset: true }).optional(),
-                }))
-                    .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(),
-                cohort_label: z.string().max(200).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())
-                .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({
-                    mode: segment.mode,
-                    contacts: segment.contacts.map((contact) => compactObject({
-                        contactId: contact.contact_id,
-                        dealId: contact.deal_id,
-                        transport: contact.transport,
-                        dialogId: contact.dialog_id,
-                        leadLastActiveAt: contact.lead_last_active_at,
-                        segmentEnteredAt: contact.segment_entered_at,
-                    })),
-                    channels: segment.channels,
-                    dealFields: segment.deal_fields,
-                    funnel: segment.funnel,
-                    segment: segment.segment,
-                    cohortLabel: segment.cohort_label,
-                    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, не собирай сегменты и их статусы вручную.',
-            'batch_key сгенерируй ОДИН раз на попытку и ПЕРЕИСПОЛЬЗУЙ при ретрае: это ключ идемпотентности. Повтор с тем же ключом вернёт существующий батч; новый ключ создаст ВТОРУЮ копию кампании, которую дедуп не остановит.',
-            'Если повторить тот же batch_key с ИЗМЕНЁННЫМ составом сегментов, сервер вернёт HTTP 409 «ключ занят другим составом». Не меняй состав при ретрае — сначала прочитай статус существующего батча.',
-            'HTTP 400 отклоняет батч до запуска, если контакт есть в двух сегментах, пересекается с незавершённым прогоном платформы или ему уже отправляли за последние 30 дней. В ответе будут пары contactId + сегменты либо конфликтующий runId; исправь состав, а не обходи проверку новым ключом.',
-            'Два подряд отказавших сегмента ставят батч на паузу. Продолжай только через besales_getcourse_wave_run_batch_resume после проверки причин отказов.',
-            'UNKNOWN и FAILED НИКОГДА не переотправляются автоматически. Повтор возможен только отдельным осознанным запуском оператора.',
-            'БЕЗ 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.',
-            'UNKNOWN и FAILED никогда не переотправляются автоматически; отсутствие подтверждённого исхода не означает, что отправки не было.',
-        ]),
-    }),
-    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, не собирая сегменты вручную.',
-            'UNKNOWN и FAILED автоматически не переотправляются. Любой повтор — только отдельное осознанное решение оператора.',
-        ]),
-    }),
-    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: очередь продолжит сегменты последовательно, один прогон на платформу.',
-            'UNKNOWN и FAILED никогда не переотправляются автоматически; повтор таких контактов — только отдельная осознанная волна.',
-        ]),
-    }),
+    ...getCourseWaveTools,
     defineTool({
         name: 'besales_wazzup_templates_list',
         requiredFields: ['platform_id'],
@@ -1353,42 +877,66 @@ export const platformSetupTools = [
             path: `/agents/${input.agent_id}/prompt/drafts/${input.draft_id}`,
         }),
     }),
+    // Остаток до лимитов линтера ДО сборки черновика. Порядок здесь обязан совпадать с
+    // mcp-tools.json (registry.spec проверяет parity), поэтому вставка строго после _patch_get.
+    defineTool({
+        name: 'besales_prompt_headroom',
+        requiredFields: ['agent_id'],
+        // .strict() — иначе опечатка `draftId` вместо `draft_id` молча отбрасывается zod'ом,
+        // и тулза измеряет закоммиченный промпт вместо черновика.
+        schema: z
+            .object({
+            agent_id: uuidSchema,
+            draft_id: uuidSchema.optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            // `query` в ApiToolRequest нет — параметр был бы молча выброшен, поэтому клеим в path.
+            path: `/agents/${input.agent_id}/prompt/headroom${buildListQuery({ draftId: input.draft_id })}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            '`hardHeadroom` — сколько символов ещё можно добавить. Признак перебора — `exceedsHardLimit: true`; ровно на лимите (`hardHeadroom: 0`) commit ещё проходит.',
+            'Если запас меньше объёма планируемой правки — сначала сокращай промпт, а не собирай черновик.',
+            '`sections` отсортированы по весу DESC — это кандидаты на сокращение.',
+            '`exceedsSoftLimit` — промпт выше рекомендованных 40000: факты стоит вынести в Базу знаний.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_prompt_diff',
+        requiredFields: ['agent_id', 'compare_agent_id'],
+        schema: z
+            .object({
+            agent_id: uuidSchema,
+            compare_agent_id: uuidSchema,
+            max_lines: z.number().int().min(1).max(PROMPT_DIFF_MAX_LINES_LIMIT).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/agents/${input.agent_id}/prompt/diff`,
+            body: { compareAgentId: input.compare_agent_id, maxLines: input.max_lines },
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            '`identicalBytes: true` — текущие тексты совпадают побайтово, значит один и тот же набор patch-операций найдёт те же якоря. Это НЕ гарантия одинакового исхода commit: lint резолвит канал каждого агента отдельно (одна и та же markdown-правка проходит в веб-виджете и падает в Telegram), а свой черновик каждый агент коммитит независимо.',
+            '`identicalNormalized: true` при `identicalBytes: false` — расходятся только пробелы/переводы строк, правила те же.',
+            '`onlyInBase` / `onlyInCompare` — что есть на одной стороне и нет на другой; `count` — превышение кратности.',
+            '`truncated: true` — список обрезан по `max_lines`. Обрезка ТЕКСТА строки — отдельный признак `textTruncated`; у таких строк сравнивай `characters`, а не `text`.',
+        ]),
+    }),
     defineTool({
         name: 'besales_prompt_patch_apply',
         requiredFields: ['agent_id', 'draft_id', 'operations'],
         schema: z.object({
             agent_id: uuidSchema,
             draft_id: uuidSchema,
-            operations: z
-                .array(z.object({
-                id: z.string().optional(),
-                type: z.enum([
-                    'replace_text',
-                    'replace_all_text',
-                    'insert_after_text',
-                    'insert_before_text',
-                    'remove_text',
-                    'move_text_after_text',
-                ]),
-                target_text: z.string().optional(),
-                anchor_text: z.string().optional(),
-                replacement_text: z.string().optional(),
-                match_variants: z.array(z.string()).optional(),
-            }))
-                .min(1),
+            operations: z.array(promptPatchOperationSchema).min(1),
         }),
         createRequest: (input) => ({
             method: 'PATCH',
             path: `/agents/${input.agent_id}/prompt/drafts/${input.draft_id}/operations`,
             body: {
-                operations: input.operations.map((op) => compactObject({
-                    id: op.id,
-                    type: op.type,
-                    targetText: op.target_text,
-                    anchorText: op.anchor_text,
-                    replacementText: op.replacement_text,
-                    matchVariants: op.match_variants,
-                })),
+                operations: input.operations.map(mapPromptPatchOperationInput),
             },
         }),
         enhanceResponse: (response) => withInstructions(response, [
@@ -1431,6 +979,60 @@ export const platformSetupTools = [
             path: `/agents/${input.agent_id}/prompt/drafts/${input.draft_id}`,
         }),
     }),
+    // Пакетная раскатка одной правки по парку агентов. Порядок обязан совпадать с
+    // mcp-tools.json — registry.spec сверяет имена позиционно.
+    defineTool({
+        name: 'besales_prompt_batch_start',
+        requiredFields: ['agent_ids', 'operations'],
+        schema: z
+            .object({
+            agent_ids: z.array(uuidSchema).min(1).max(PROMPT_BATCH_MAX_AGENTS),
+            operations: z.array(promptPatchOperationSchema).min(1),
+            all_or_nothing: z.boolean().optional(),
+            idempotency_key: z.string().max(PROMPT_BATCH_IDEMPOTENCY_KEY_MAX_LENGTH).optional(),
+            platform_id: uuidSchema.optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: '/prompt-batch/runs',
+            body: compactObject({
+                agentIds: input.agent_ids,
+                operations: input.operations.map(mapPromptPatchOperationInput),
+                allOrNothing: input.all_or_nothing,
+                idempotencyKey: input.idempotency_key,
+                platformId: input.platform_id,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Прогон фоновый: опрашивай `besales_prompt_batch_status` по `runId`, пока `counts.PENDING` и `counts.PREPARED` не станут нулями.',
+            '`SKIPPED` — не ошибка: смотри `skipReason`, чаще всего это NO_OPERATIONS_APPLIED (у агента другой промпт, якоря не нашлись).',
+            'Упавших агентов докатывай `besales_prompt_batch_resume` — повторный `_start` создаст ВТОРОЙ прогон и применит операции ещё раз.',
+            'Перед раскаткой на парк проверь запас длины у самого тяжёлого агента через `besales_prompt_headroom`.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_prompt_batch_status',
+        requiredFields: ['run_id'],
+        schema: z.object({ run_id: uuidSchema }).strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/prompt-batch/runs/${input.run_id}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_prompt_batch_resume',
+        requiredFields: ['run_id'],
+        schema: z.object({ run_id: uuidSchema }).strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/prompt-batch/runs/${input.run_id}/resume`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Докатываются только FAILED-агенты. Уже закоммиченные не трогаются — повторное применение операций удвоило бы вставки.',
+            '400 «Run is still in progress» означает, что прогон жив: дождись, а не повторяй resume.',
+        ]),
+    }),
     // S2.6 extra — besales_prompt_lint (после patches, чтобы matched catalog order)
     defineTool({
         name: 'besales_prompt_lint',