@besales/mcp 0.32.0 → 0.37.0

package/dist/tools/definitions/broadcast-mailing-variants.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { compactObject, defineTool, uuidSchema, withInstructions } from './shared.js';
+const NAME_MAX_LENGTH = 200;
+const DESCRIPTION_MAX_LENGTH = 4000;
+export const broadcastMailingVariantTools = [
+    defineTool({
+        name: 'besales_broadcast_mailing_variant_list',
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            include_archived: z.boolean().optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/broadcast-mailing-variants${input.include_archived ? '?includeArchived=true' : ''}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Возвращает workspace-scoped каталог «Вариантов рассылки». Для нового запуска выбирай ID активного варианта и передавай его как mailing_variant_id.',
+            'include_archived=true нужен для чтения исторических конфигураций аналитики; архивный вариант нельзя назначить новой волне.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_broadcast_mailing_variant_create',
+        requiredFields: ['name'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            name: z.string().trim().min(1).max(NAME_MAX_LENGTH),
+            description: z.string().max(DESCRIPTION_MAX_LENGTH).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/broadcast-mailing-variants`,
+            body: compactObject({
+                name: input.name,
+                description: input.description,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Создаёт именованный вариант рассылки или восстанавливает архивный вариант с тем же нормализованным именем.',
+            'Описание фиксирует гипотезу, сообщения и GetCourse-процесс; конкретные запуски по-прежнему различаются cohort_label.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_broadcast_mailing_variant_update',
+        requiredFields: ['mailing_variant_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            mailing_variant_id: uuidSchema,
+            name: z.string().trim().min(1).max(NAME_MAX_LENGTH).optional(),
+            description: z.union([z.string().max(DESCRIPTION_MAX_LENGTH), z.null()]).optional(),
+            archived: z.boolean().optional(),
+            explicit_confirmation: z.literal(true).optional(),
+        })
+            .strict()
+            .refine((input) => input.name !== undefined ||
+            input.description !== undefined ||
+            input.archived !== undefined, {
+            message: 'Передай хотя бы одно из полей: name, description, archived',
+        })
+            .refine((input) => input.archived !== true || input.explicit_confirmation === true, {
+            message: 'Архивация требует explicit_confirmation=true после подтверждения пользователя',
+            path: ['explicit_confirmation'],
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/workspaces/${input.workspace_id}/broadcast-mailing-variants/${input.mailing_variant_id}`,
+            body: compactObject({
+                name: input.name,
+                description: input.description,
+                archived: input.archived,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Переименование синхронно обновляет legacy-снимок имени в связанных когортах. archived=true скрывает вариант из новых запусков, но сохраняет аналитику.',
+            'archived=true требует explicit_confirmation=true после явного подтверждения пользователя; archived=false восстанавливает вариант без подтверждения.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_broadcast_mailing_variant_delete',
+        requiredFields: ['mailing_variant_id', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            mailing_variant_id: uuidSchema,
+            explicit_confirmation: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/broadcast-mailing-variants/${input.mailing_variant_id}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Архивирует вариант без hard-delete: UUID может уже находиться в отложенном durable-run до создания когорты.',
+            'explicit_confirmation=true передавай только после явного подтверждения пользователя. Архивный вариант скрыт из новых запусков, но сохраняет историю и может быть восстановлен.',
+        ]),
+    }),
+];
+//# sourceMappingURL=broadcast-mailing-variants.js.map

package/dist/tools/definitions/broadcast-mailing-variants.js.map

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

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

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