@besales/mcp 0.32.0 → 0.37.0

package/dist/tools/definitions/platform-setup.d.ts

@@ -1,11 +1,4 @@
 export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
-    workspace_id?: string | undefined;
-}> | import("./shared.js").ToolDefinition<{
-    platform_id: string;
-}> | import("./shared.js").ToolDefinition<{
-    platform_id: string;
-    agent_id: string;
-}> | import("./shared.js").ToolDefinition<{
     platform_id: string;
     crm_id: string;
     channels: string[];
@@ -14,6 +7,10 @@ export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
         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;
     }[];
@@ -21,7 +18,9 @@ export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
     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;
@@ -53,14 +52,22 @@ export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
         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;
@@ -89,6 +96,61 @@ export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
     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;
+}> | import("./shared.js").ToolDefinition<{
+    workspace_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    platform_id: string;
+}> | import("./shared.js").ToolDefinition<{
+    platform_id: string;
+    agent_id: string;
 }> | import("./shared.js").ToolDefinition<{
     platform_id: string;
     workspace_id?: string | undefined;
@@ -506,6 +568,29 @@ export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
         }[] | null | undefined;
         template_user_id?: number | null | undefined;
         template_deal_id?: number | null | undefined;
+        wave_field_bindings?: {
+            product_value_source: "CODE" | "NAME";
+            launch_type?: {
+                field_id: number;
+                field_label: string;
+            } | undefined;
+            product?: {
+                field_id: number;
+                field_label: string;
+            } | undefined;
+            segment?: {
+                field_id: number;
+                field_label: string;
+            } | undefined;
+            funnel?: {
+                field_id: number;
+                field_label: string;
+            } | undefined;
+            channels?: {
+                field_id: number;
+                field_label: string;
+            } | undefined;
+        } | null | undefined;
         field_variable_map?: {
             getcourse_field_name: string;
             variable_name: string;
@@ -556,6 +641,13 @@ export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
     draft_id: string;
+}> | import("./shared.js").ToolDefinition<{
+    agent_id: string;
+    draft_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    agent_id: string;
+    compare_agent_id: string;
+    max_lines?: number | undefined;
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
     draft_id: string;
@@ -567,6 +659,21 @@ export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
         replacement_text?: string | undefined;
         match_variants?: string[] | undefined;
     }[];
+}> | import("./shared.js").ToolDefinition<{
+    agent_ids: string[];
+    operations: {
+        type: "replace_text" | "replace_all_text" | "insert_after_text" | "insert_before_text" | "remove_text" | "move_text_after_text";
+        id?: string | undefined;
+        target_text?: string | undefined;
+        anchor_text?: string | undefined;
+        replacement_text?: string | undefined;
+        match_variants?: string[] | undefined;
+    }[];
+    all_or_nothing?: boolean | undefined;
+    idempotency_key?: string | undefined;
+    platform_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    run_id: string;
 }> | import("./shared.js").ToolDefinition<{
     prompt_text: string;
     workspace_id?: string | undefined;

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,312 +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 автоматически не переотправляются; повтор возможен только отдельной волной по осознанному решению оператора.',
-        ]),
-    }),
+    ...getCourseWaveTools,
     defineTool({
         name: 'besales_wazzup_templates_list',
         requiredFields: ['platform_id'],
@@ -1181,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, [
@@ -1259,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',