@besales/mcp 0.31.0 → 0.32.0

package/dist/tools/definitions/follow-up.d.ts

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+export declare const reactivationConfigSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    filterMode: z.ZodOptional<z.ZodEnum<{
+        status: "status";
+        variable: "variable";
+        eventType: "eventType";
+    }>>;
+    sequenceConditions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        variable: z.ZodString;
+        op: z.ZodEnum<{
+            in: "in";
+            eq: "eq";
+            neq: "neq";
+        }>;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    }, z.core.$loose>>>;
+    steps: z.ZodArray<z.ZodObject<{
+        stepType: z.ZodOptional<z.ZodEnum<{
+            message: "message";
+            webhook: "webhook";
+        }>>;
+        scheduleMode: z.ZodOptional<z.ZodEnum<{
+            offset: "offset";
+            clock: "clock";
+        }>>;
+        anchorMode: z.ZodOptional<z.ZodEnum<{
+            variable: "variable";
+            last_inbound: "last_inbound";
+        }>>;
+        anchorVariable: z.ZodOptional<z.ZodString>;
+        atTime: z.ZodOptional<z.ZodString>;
+        dayOffset: z.ZodOptional<z.ZodNumber>;
+        validityMinutes: z.ZodOptional<z.ZodNumber>;
+        slotGroup: z.ZodOptional<z.ZodString>;
+        conditions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            variable: z.ZodString;
+            op: z.ZodEnum<{
+                in: "in";
+                eq: "eq";
+                neq: "neq";
+            }>;
+            value: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$loose>>>;
+        delayHours: z.ZodOptional<z.ZodNumber>;
+        delayMinutes: z.ZodOptional<z.ZodNumber>;
+        messageConfig: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/**
+ * Применяет типизированную схему к `config` ТОЛЬКО для реактивационных цепочек.
+ *
+ * Через `z.union([reactivationConfigSchema, anyObjectSchema])` это делать нельзя: второй вариант
+ * принимает любой объект, поэтому union проходит всегда и ограничения (`steps.min(1)`,
+ * `filterMode` enum) не срабатывают ни разу — типизация выглядит рабочей, но её нет.
+ *
+ * @param input - Разобранный ввод тула
+ * @param ctx - Контекст zod для добавления ошибок
+ */
+export declare const refineFollowUpConfig: (input: {
+    type?: unknown;
+    config?: unknown;
+}, ctx: z.RefinementCtx) => void;
+export declare const followUpSequenceListSchema: z.ZodObject<{
+    platform_id: z.ZodString;
+    sequence_id: z.ZodOptional<z.ZodString>;
+    include_config: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const followUpStepStatsSchema: z.ZodObject<{
+    platform_id: z.ZodString;
+    sequence_id: z.ZodString;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const followUpTools: (import("./shared.js").ToolDefinition<{
+    platform_id: string;
+    sequence_id?: string | undefined;
+    include_config?: boolean | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    platform_id: string;
+    sequence_id: string;
+    from?: string | undefined;
+    to?: string | undefined;
+}>)[];

package/dist/tools/definitions/follow-up.js

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+import { anyObjectSchema, buildListQuery, defineTool, uuidSchema, withInstructions, } from './shared.js';
+/**
+ * Схема конфига реактивационной цепочки.
+ *
+ * ⚠️ Ключи ВНУТРИ `config` — camelCase, в отличие от snake_case параметров тулов: `config`
+ * уходит в тело запроса БЕЗ преобразования, а рантайм читает `anchorMode`/`anchorVariable`/
+ * `slotGroup`. Назвать их в snake_case значило бы сохранить конфиг, который рантайм не
+ * прочитает: календарный шаг молча стал бы обычным offset-шагом.
+ *
+ * ⚠️ `.passthrough()` на каждом уровне обязателен по двум причинам: legacy-конфиги несут поля
+ * вне этой схемы (`finalAction`, `maxCycleCount`, `webhookConfig`, …), и сама схема исполняется
+ * на машине оператора — она обновляется независимо от бэкенда и не должна отвергать конфиг,
+ * который бэкенд принял бы.
+ */
+const variableConditionSchema = z
+    .object({
+    variable: z.string().describe('Имя per-contact переменной'),
+    op: z.enum(['eq', 'neq', 'in']),
+    value: z
+        .union([z.string(), z.array(z.string())])
+        .describe("Строка для eq/neq, непустой массив непустых строк для 'in'"),
+})
+    .passthrough();
+const reactivationStepSchema = z
+    .object({
+    stepType: z.enum(['message', 'webhook']).optional(),
+    scheduleMode: z
+        .enum(['offset', 'clock'])
+        .optional()
+        .describe("'clock' — время суток + сдвиг дней вместо задержки от последней активности"),
+    anchorMode: z
+        .enum(['last_inbound', 'variable'])
+        .optional()
+        .describe("'variable' — расписание считается от даты из переменной контакта (календарная цепочка)"),
+    anchorVariable: z
+        .string()
+        .optional()
+        .describe('Имя переменной с якорной датой. Обязательно при anchorMode=variable; переменная должна ' +
+        'существовать у платформы и НЕ быть константой'),
+    atTime: z.string().optional().describe('Время суток "HH:MM" для scheduleMode=clock'),
+    dayOffset: z
+        .number()
+        .int()
+        .min(0)
+        .max(30)
+        .optional()
+        .describe('Сдвиг в днях от якоря для scheduleMode=clock'),
+    validityMinutes: z
+        .number()
+        .optional()
+        .describe('Окно валидности слота. Меньше 10 минут крон почти всегда промахнётся'),
+    slotGroup: z
+        .string()
+        .optional()
+        .describe('Метка взаимоисключающих вариантов одного момента (first-match-wins). Варианты ОБЯЗАНЫ ' +
+        'идти в steps подряд: разнесённые по цепочке перестают быть взаимоисключающими'),
+    conditions: z
+        .array(variableConditionSchema)
+        .max(3)
+        .optional()
+        .describe('Условия на переменные контакта; не прошли — шаг пропускается'),
+    delayHours: z.number().optional(),
+    delayMinutes: z.number().optional(),
+    messageConfig: anyObjectSchema.optional(),
+})
+    .passthrough();
+export const reactivationConfigSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    filterMode: z
+        .enum(['status', 'eventType', 'variable'])
+        .optional()
+        .describe('Режим отбора контактов. Неизвестное значение НЕ включает ни один фильтр — цепочка уйдёт ' +
+        'всем контактам канала, поэтому бэкенд отвергает такой конфиг'),
+    sequenceConditions: z
+        .array(variableConditionSchema)
+        .optional()
+        .describe("Обязателен и непуст при filterMode='variable'"),
+    steps: z.array(reactivationStepSchema).min(1),
+})
+    .passthrough();
+/**
+ * Применяет типизированную схему к `config` ТОЛЬКО для реактивационных цепочек.
+ *
+ * Через `z.union([reactivationConfigSchema, anyObjectSchema])` это делать нельзя: второй вариант
+ * принимает любой объект, поэтому union проходит всегда и ограничения (`steps.min(1)`,
+ * `filterMode` enum) не срабатывают ни разу — типизация выглядит рабочей, но её нет.
+ *
+ * @param input - Разобранный ввод тула
+ * @param ctx - Контекст zod для добавления ошибок
+ */
+export const refineFollowUpConfig = (input, ctx) => {
+    if (input.type !== 'INACTIVE_USER_REACTIVATION') {
+        return;
+    }
+    const parsed = reactivationConfigSchema.safeParse(input.config);
+    if (parsed.success) {
+        return;
+    }
+    for (const issue of parsed.error.issues) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['config', ...issue.path],
+            message: issue.message,
+        });
+    }
+};
+export const followUpSequenceListSchema = z.object({
+    platform_id: uuidSchema,
+    sequence_id: uuidSchema
+        .optional()
+        .describe('Вернуть одну цепочку вместе с полным конфигом'),
+    include_config: z
+        .boolean()
+        .optional()
+        .describe('Отдать конфиги всех цепочек. По умолчанию не отдаются — они объёмные'),
+});
+export const followUpStepStatsSchema = z.object({
+    platform_id: uuidSchema,
+    sequence_id: uuidSchema,
+    from: z.string().optional().describe('Начало окна, ISO-дата. По умолчанию 30 дней назад'),
+    to: z.string().optional().describe('Конец окна, ISO-дата. По умолчанию сейчас'),
+});
+export const followUpTools = [
+    defineTool({
+        name: 'besales_followup_sequence_list',
+        requiredFields: ['platform_id'],
+        schema: followUpSequenceListSchema,
+        // Параметры клеим в путь: транспорт (`ApiToolRequest`) знает только method/path/body, и
+        // отдельное поле `query` было бы молча выброшено — тул вернул бы 200 без учёта фильтров.
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/platforms/${input.platform_id}/follow-up/sequences${buildListQuery({
+                sequence_id: input.sequence_id,
+                include_config: input.include_config,
+            })}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'besales_followup_sequence_upsert заменяет config ЦЕЛИКОМ: прочитай конфиг здесь (sequence_id) и пришли ПОЛНЫЙ желаемый набор шагов, а не дельту.',
+            'Без sequence_id и include_config конфиги не отдаются — так список остаётся дешёвым по контексту.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_followup_step_stats',
+        requiredFields: ['platform_id', 'sequence_id'],
+        schema: followUpStepStatsSchema,
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/platforms/${input.platform_id}/follow-up/sequences/${input.sequence_id}/step-stats${buildListQuery({ from: input.from, to: input.to })}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'wasSent=false НЕ означает «отправка не удалась»: SEND_FAILED пишется только если до fence не дошло (мьют, стадия CRM, тихий канал).',
+            'SHADOWED — вариант слота, который не оценивался, потому что слот уже закрыт отправкой другого варианта. Это не ошибка.',
+            'SENT_UNVERIFIED — отправка зависла после fence: исходом владеет recovery, повтор запрещён.',
+            'waitingUpperBound — ВЕРХНЯЯ оценка ожидающих: прогресс создаётся всем включённым цепочкам платформы без проверки sequenceConditions.',
+            'Окно по умолчанию — 30 дней; для более раннего периода передай from/to.',
+        ]),
+    }),
+];
+//# sourceMappingURL=follow-up.js.map

package/dist/tools/definitions/follow-up.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-up.js","sourceRoot":"","sources":["../../../src/tools/definitions/follow-up.ts"],"names":[],"mappings":"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"}

package/dist/tools/definitions/knowledge.d.ts

@@ -65,7 +65,7 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
     workspace_id?: string | undefined;
-    status?: "LOADED" | "SPLIT" | "EMBEDDINGS_GENERATED" | "VECTOR_DB_UPLOADED" | "COMPLETED" | "FAILED" | "TEXT_EXTRACTED" | "CHUNKS_SAVED" | undefined;
+    status?: "FAILED" | "LOADED" | "SPLIT" | "EMBEDDINGS_GENERATED" | "VECTOR_DB_UPLOADED" | "COMPLETED" | "TEXT_EXTRACTED" | "CHUNKS_SAVED" | undefined;
     page?: number | undefined;
     limit?: number | undefined;
 }> | import("./shared.js").ToolDefinition<{
@@ -149,7 +149,7 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
     workspace_id?: string | undefined;
-    status?: "COMPLETED" | "FAILED" | "PENDING" | "CRAWLING" | "PROCESSING" | undefined;
+    status?: "PENDING" | "FAILED" | "COMPLETED" | "CRAWLING" | "PROCESSING" | undefined;
     page?: number | undefined;
     limit?: number | undefined;
 }> | import("./shared.js").ToolDefinition<{

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

@@ -44,6 +44,51 @@ export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
 }> | 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;
+        lead_last_active_at?: string | undefined;
+        segment_entered_at?: string | undefined;
+    }[];
+    workspace_id?: string | undefined;
+    launch_type?: "status" | undefined;
+    funnel?: string | undefined;
+    segment?: string | undefined;
+    cohort_label?: 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<{
     platform_id: string;
     workspace_id?: string | undefined;
@@ -472,6 +517,10 @@ export declare const platformSetupTools: (import("./shared.js").ToolDefinition<{
         manual_mute_field_id?: string | null | undefined;
         manual_mute_value?: string | null | undefined;
         manual_mute_active_value?: string | null | undefined;
+        create_missing_deal_enabled?: boolean | undefined;
+        create_missing_deal_offer_id?: number | null | undefined;
+        create_missing_deal_funnel_id?: number | null | undefined;
+        create_missing_deal_stage_id?: number | null | undefined;
     } | undefined;
 }> | import("./shared.js").ToolDefinition<{
     audit_log_id: string;

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

@@ -1,4 +1,5 @@
 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';
 export const platformSetupTools = [
     defineTool({
@@ -204,6 +205,186 @@ export const platformSetupTools = [
             '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_wazzup_templates_list',
         requiredFields: ['platform_id'],
@@ -688,7 +869,8 @@ export const platformSetupTools = [
             trigger: followUpTriggerSchema,
             config: anyObjectSchema,
             ...platformSetupConfirmationSchema,
-        }),
+        })
+            .superRefine(refineFollowUpConfig),
         createRequest: (input) => ({
             method: input.sequence_id ? 'PATCH' : 'POST',
             path: input.sequence_id