@besales/mcp 0.1.0 → 0.11.1

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

@@ -0,0 +1,1070 @@
+import { z } from 'zod';
+import { MAX_FILE_UPLOAD_BYTES, apiKeyPlatformTypeSchema, buildFileListQuery, buildVariableListQuery, buildVariableScopeQuery, compactObject, crmFieldMappingItemSchema, defineTool, mcpFileSourceSchema, oauthPlatformTypeSchema, optionalAnyObjectSchema, provisionableCrmTypeSchema, storedFileTypeSchema, uuidSchema, withInstructions, } from './shared.js';
+export const crmPlatformTools = [
+    // ============================================================
+    // v1.5 Increment 4a — Unified Variables API (5 tools, v2-shaped scope discriminator)
+    // ============================================================
+    // Backend wraps two v1 tables (WorkspaceVariable + CustomVariable) под единый MCP shape.
+    // При v2 cutover (spec 23) обе таблицы → один `variables` с тем же `scope` discriminator —
+    // MCP shape работает без изменений.
+    defineTool({
+        name: 'besales_variable_list',
+        requiredFields: ['scope'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            scope: z.enum(['WORKSPACE', 'CHANNEL']),
+            platform_id: uuidSchema.optional(),
+            filter: z.enum(['all', 'variables', 'constants']).optional(),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.scope === 'CHANNEL' && !input.platform_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'platform_id is required when scope=CHANNEL',
+                    path: ['platform_id'],
+                });
+            }
+            if (input.scope === 'WORKSPACE' && input.platform_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'platform_id is forbidden when scope=WORKSPACE',
+                    path: ['platform_id'],
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/variables${buildVariableListQuery(input.scope, input.platform_id, input.filter)}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'WORKSPACE scope возвращает глобальные переменные workspace (доступны всем платформам).',
+            'CHANNEL scope требует platform_id; filter=variables (исключить константы), filter=constants (только константы), filter=all (по умолчанию).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_variable_create',
+        requiredFields: ['scope', 'name', 'type'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            scope: z.enum(['WORKSPACE', 'CHANNEL']),
+            name: z.string().regex(/^[a-zA-Z_][a-zA-Z0-9_]*$/, {
+                message: 'name must be ASCII letters/digits/underscores; start with letter or _',
+            }),
+            description: z.string().optional(),
+            type: z.enum(['TEXT', 'NUMBER', 'FLOAT', 'BOOLEAN']),
+            // WORKSPACE-only
+            value: z.string().optional(),
+            // CHANNEL-only
+            platform_id: uuidSchema.optional(),
+            is_constant: z.boolean().optional(),
+            constant_value: z.string().optional(),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.scope === 'WORKSPACE') {
+                if (input.platform_id) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'platform_id is forbidden when scope=WORKSPACE',
+                        path: ['platform_id'],
+                    });
+                }
+                if (input.is_constant !== undefined || input.constant_value !== undefined) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'is_constant and constant_value are forbidden when scope=WORKSPACE',
+                        path: ['is_constant'],
+                    });
+                }
+            }
+            else {
+                // CHANNEL
+                if (!input.platform_id) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'platform_id is required when scope=CHANNEL',
+                        path: ['platform_id'],
+                    });
+                }
+                if (input.value !== undefined) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'value is forbidden when scope=CHANNEL — use constant_value if isConstant=true',
+                        path: ['value'],
+                    });
+                }
+                if (input.is_constant === true && !input.constant_value) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'constant_value is required when scope=CHANNEL and is_constant=true',
+                        path: ['constant_value'],
+                    });
+                }
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/variables`,
+            body: compactObject({
+                scope: input.scope,
+                name: input.name,
+                description: input.description,
+                type: input.type,
+                value: input.value,
+                platformId: input.platform_id,
+                isConstant: input.is_constant,
+                constantValue: input.constant_value,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'name, scope, is_constant — immutable post-create (используй delete + create для смены).',
+            'WORKSPACE variables референсятся в шаблонах как {{{name}}} (triple braces), CHANNEL constants — {{name}} (double).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_variable_get',
+        requiredFields: ['variable_id', 'scope'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            variable_id: uuidSchema,
+            scope: z.enum(['WORKSPACE', 'CHANNEL']),
+            platform_id: uuidSchema.optional(),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.scope === 'CHANNEL' && !input.platform_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'platform_id is required when scope=CHANNEL',
+                    path: ['platform_id'],
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/variables/${input.variable_id}${buildVariableScopeQuery(input.scope, input.platform_id)}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_variable_update',
+        requiredFields: ['variable_id', 'scope'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            variable_id: uuidSchema,
+            scope: z.enum(['WORKSPACE', 'CHANNEL']),
+            platform_id: uuidSchema.optional(),
+            description: z.string().optional(),
+            type: z.enum(['TEXT', 'NUMBER', 'FLOAT', 'BOOLEAN']).optional(),
+            // WORKSPACE-only (nullable для clear)
+            value: z.string().nullable().optional(),
+            // CHANNEL-only (nullable для clear)
+            constant_value: z.string().nullable().optional(),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.scope === 'CHANNEL' && !input.platform_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'platform_id is required when scope=CHANNEL',
+                    path: ['platform_id'],
+                });
+            }
+            if (input.scope === 'WORKSPACE' && input.constant_value !== undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'constant_value is forbidden when scope=WORKSPACE',
+                    path: ['constant_value'],
+                });
+            }
+            if (input.scope === 'CHANNEL' && input.value !== undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'value is forbidden when scope=CHANNEL',
+                    path: ['value'],
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/workspaces/${input.workspace_id}/variables/${input.variable_id}`,
+            body: compactObject({
+                scope: input.scope,
+                platformId: input.platform_id,
+                description: input.description,
+                type: input.type,
+                value: input.value,
+                constantValue: input.constant_value,
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_variable_delete',
+        requiredFields: ['variable_id', 'scope', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            variable_id: uuidSchema,
+            scope: z.enum(['WORKSPACE', 'CHANNEL']),
+            platform_id: uuidSchema.optional(),
+            explicit_confirmation: z.literal(true),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.scope === 'CHANNEL' && !input.platform_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'platform_id is required when scope=CHANNEL',
+                    path: ['platform_id'],
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/variables/${input.variable_id}`,
+            body: compactObject({
+                scope: input.scope,
+                platformId: input.platform_id,
+                explicitConfirmation: input.explicit_confirmation,
+            }),
+        }),
+    }),
+    // ============================================================
+    // v1.5 Increment 4b — CRM Pipelines (11 tools)
+    // ============================================================
+    // CRUD CRM pipelines + statuses + platform-pipeline M:N junction.
+    // Pipeline/status create/update/delete HIT external CRM API (AmoCRM/Bitrix24);
+    // GetCourse manages locally с manual funnel_id / funnel_stage_id.
+    //
+    // Защита от accidental external CRM mutation: `acknowledge_external_side_effect: true`
+    // literal на всех mutation tools + `explicit_confirmation: true` на destructive.
+    //
+    // platform-pipeline link/unlink — local-only (M:N junction), audit reversible.
+    defineTool({
+        name: 'besales_crm_pipeline_list',
+        defaultWorkspaceId: true,
+        requiredFields: ['crm_id'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            include_deleted: z.boolean().optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/crm/${input.crm_id}/pipelines${input.include_deleted !== undefined ? `?includeDeleted=${input.include_deleted}` : ''}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Триггерит sync с external CRM (AmoCRM/Bitrix24) при каждом вызове — best-effort, не блокирует list при failure.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_pipeline_get',
+        defaultWorkspaceId: true,
+        requiredFields: ['crm_id', 'pipeline_id'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            pipeline_id: z.number().int(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/crm/${input.crm_id}/pipelines/${input.pipeline_id}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_crm_pipeline_create',
+        defaultWorkspaceId: true,
+        requiredFields: ['crm_id', 'name', 'acknowledge_external_side_effect'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            name: z.string(),
+            sort: z.number().int().optional(),
+            is_main: z.boolean().optional(),
+            is_unsorted_on: z.boolean().optional(),
+            is_active: z.boolean().optional(),
+            pipeline_id: z.number().int().optional(),
+            acknowledge_external_side_effect: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/crm/${input.crm_id}/pipelines`,
+            body: compactObject({
+                name: input.name,
+                sort: input.sort,
+                isMain: input.is_main,
+                isUnsortedOn: input.is_unsorted_on,
+                isActive: input.is_active,
+                pipelineId: input.pipeline_id,
+                acknowledgeExternalSideEffect: input.acknowledge_external_side_effect,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            '⚠️ Создаёт воронку в EXTERNAL CRM (AmoCRM/Bitrix24). Для GetCourse требуется pipeline_id (funnel_id).',
+            'External CRM ops NOT undoable через MCP. Используй с осторожностью.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_pipeline_update',
+        defaultWorkspaceId: true,
+        requiredFields: [
+            'crm_id',
+            'pipeline_id',
+            'acknowledge_external_side_effect',
+        ],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            pipeline_id: z.number().int(),
+            name: z.string().optional(),
+            sort: z.number().int().optional(),
+            is_main: z.boolean().optional(),
+            is_unsorted_on: z.boolean().optional(),
+            is_active: z.boolean().optional(),
+            acknowledge_external_side_effect: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/workspaces/${input.workspace_id}/crm/${input.crm_id}/pipelines/${input.pipeline_id}`,
+            body: compactObject({
+                name: input.name,
+                sort: input.sort,
+                isMain: input.is_main,
+                isUnsortedOn: input.is_unsorted_on,
+                isActive: input.is_active,
+                acknowledgeExternalSideEffect: input.acknowledge_external_side_effect,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Sync changes в external CRM (если поддерживается updatePipeline). Settings типа aiResponseMoveToStatus живут в PipelineSettings — обновляй через besales_pipeline_settings_update.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_pipeline_delete',
+        defaultWorkspaceId: true,
+        requiredFields: [
+            'crm_id',
+            'pipeline_id',
+            'explicit_confirmation',
+            'acknowledge_external_side_effect',
+        ],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            pipeline_id: z.number().int(),
+            explicit_confirmation: z.literal(true),
+            acknowledge_external_side_effect: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/crm/${input.crm_id}/pipelines/${input.pipeline_id}`,
+            body: {
+                explicitConfirmation: input.explicit_confirmation,
+                acknowledgeExternalSideEffect: input.acknowledge_external_side_effect,
+            },
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            '⚠️ Soft delete локально (`deletedAt`) + удаление в external CRM. Refuses если isMain=true.',
+            'External CRM ops NOT undoable через MCP.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_pipeline_status_list',
+        defaultWorkspaceId: true,
+        requiredFields: ['crm_id', 'pipeline_id'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            pipeline_id: z.number().int(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/crm/${input.crm_id}/pipelines/${input.pipeline_id}/statuses`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_crm_pipeline_status_create',
+        defaultWorkspaceId: true,
+        requiredFields: [
+            'crm_id',
+            'pipeline_id',
+            'name',
+            'sort',
+            'acknowledge_external_side_effect',
+        ],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            pipeline_id: z.number().int(),
+            name: z.string(),
+            sort: z.number().int(),
+            color: z.string().optional(),
+            status_types: z.array(z.string()).optional(),
+            is_editable: z.boolean().optional(),
+            is_bot_active: z.boolean().optional(),
+            is_operator_available: z.boolean().optional(),
+            on_message_received_move_to_status: z.number().int().nullable().optional(),
+            status_id: z.number().int().optional(),
+            acknowledge_external_side_effect: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/crm/${input.crm_id}/pipelines/${input.pipeline_id}/statuses`,
+            body: compactObject({
+                name: input.name,
+                sort: input.sort,
+                color: input.color,
+                statusTypes: input.status_types,
+                isEditable: input.is_editable,
+                isBotActive: input.is_bot_active,
+                isOperatorAvailable: input.is_operator_available,
+                onMessageReceivedMoveToStatus: input.on_message_received_move_to_status,
+                statusId: input.status_id,
+                acknowledgeExternalSideEffect: input.acknowledge_external_side_effect,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            '⚠️ Создаёт статус в EXTERNAL CRM. GetCourse требует status_id (manual funnel_stage_id).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_pipeline_status_update',
+        defaultWorkspaceId: true,
+        requiredFields: [
+            'crm_id',
+            'pipeline_id',
+            'status_id',
+            'acknowledge_external_side_effect',
+        ],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            pipeline_id: z.number().int(),
+            status_id: z.number().int(),
+            name: z.string().optional(),
+            sort: z.number().int().optional(),
+            color: z.string().optional(),
+            status_types: z.array(z.string()).optional(),
+            is_editable: z.boolean().optional(),
+            is_bot_active: z.boolean().optional(),
+            is_operator_available: z.boolean().optional(),
+            on_message_received_move_to_status: z.number().int().nullable().optional(),
+            acknowledge_external_side_effect: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/workspaces/${input.workspace_id}/crm/${input.crm_id}/pipelines/${input.pipeline_id}/statuses/${input.status_id}`,
+            body: compactObject({
+                name: input.name,
+                sort: input.sort,
+                color: input.color,
+                statusTypes: input.status_types,
+                isEditable: input.is_editable,
+                isBotActive: input.is_bot_active,
+                isOperatorAvailable: input.is_operator_available,
+                onMessageReceivedMoveToStatus: input.on_message_received_move_to_status,
+                acknowledgeExternalSideEffect: input.acknowledge_external_side_effect,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Если status.isEditable=false — skip external CRM update (только local DB).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_pipeline_status_delete',
+        defaultWorkspaceId: true,
+        requiredFields: [
+            'crm_id',
+            'pipeline_id',
+            'status_id',
+            'explicit_confirmation',
+            'acknowledge_external_side_effect',
+        ],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            pipeline_id: z.number().int(),
+            status_id: z.number().int(),
+            explicit_confirmation: z.literal(true),
+            acknowledge_external_side_effect: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/crm/${input.crm_id}/pipelines/${input.pipeline_id}/statuses/${input.status_id}`,
+            body: {
+                explicitConfirmation: input.explicit_confirmation,
+                acknowledgeExternalSideEffect: input.acknowledge_external_side_effect,
+            },
+        }),
+    }),
+    defineTool({
+        name: 'besales_platform_pipeline_link',
+        defaultWorkspaceId: true,
+        requiredFields: ['platform_id', 'pipeline_id', 'pipeline_crm_id'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            platform_id: uuidSchema,
+            pipeline_id: z.number().int(),
+            pipeline_crm_id: uuidSchema,
+            sort: z.number().int().min(0).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/platforms/${input.platform_id}/active-pipelines`,
+            body: compactObject({
+                pipelineId: input.pipeline_id,
+                pipelineCrmId: input.pipeline_crm_id,
+                sort: input.sort,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Local-only M:N junction. Reversible audit — unlink восстановится через besales_audit_revert.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_platform_pipeline_unlink',
+        defaultWorkspaceId: true,
+        requiredFields: ['platform_id', 'platform_pipeline_id', 'explicit_confirmation'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            platform_id: uuidSchema,
+            platform_pipeline_id: uuidSchema,
+            explicit_confirmation: z.literal(true),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/platforms/${input.platform_id}/active-pipelines/${input.platform_pipeline_id}`,
+            body: { explicitConfirmation: input.explicit_confirmation },
+        }),
+    }),
+    // ============================================================
+    // v1.5 Increment 4d — cross-platform clone (3 tools)
+    // ============================================================
+    // Two-phase clone: preview → execute. Preview returns token (15-min TTL Redis-cached)
+    // с summary/conflicts/warnings; execute replays plan в Prisma transaction с
+    // pg_advisory_xact_lock на target_platform_id.
+    //
+    // Strict mode (C-P1a): blocks unsafe fallback в PlatformCopyService (где если source
+    // пусто — сервис берёт ANY other platform). Plan-builder pre-check'ает что source
+    // has data per included group → throws 400 если нет.
+    //
+    // Hard cap: 1000 entities per clone. >1000 → 400 с suggestion to split groups.
+    // Async via BullMQ — Phase 2 of 4d (out of MVP scope).
+    defineTool({
+        name: 'besales_platform_clone_preview',
+        defaultWorkspaceId: true,
+        requiredFields: ['source_platform_id', 'target_platform_id', 'include'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            source_platform_id: uuidSchema,
+            target_platform_id: uuidSchema,
+            include: z
+                .object({
+                agents: z.boolean().optional(),
+                agent_tools: z.boolean().optional(),
+                triggers: z.boolean().optional(),
+                behavior: z.boolean().optional(),
+                platform_settings: z.boolean().optional(),
+                pipeline_settings: z.boolean().optional(),
+                knowledge_space_links: z.boolean().optional(),
+                follow_up_sequences: z.boolean().optional(),
+                custom_variables: z.boolean().optional(),
+            })
+                .strict()
+                .refine((flags) => Object.values(flags).some((v) => v === true), {
+                message: 'include должен содержать минимум один true flag',
+            }),
+            conflict_mode: z.enum(['reject', 'merge', 'overwrite']).optional(),
+            name_collision_strategy: z.enum(['suffix', 'keep']).optional(),
+        })
+            .strict()
+            .refine((input) => input.source_platform_id !== input.target_platform_id, {
+            message: 'source_platform_id и target_platform_id должны различаться',
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/platforms/clone/preview`,
+            body: compactObject({
+                sourcePlatformId: input.source_platform_id,
+                targetPlatformId: input.target_platform_id,
+                include: compactObject({
+                    agents: input.include.agents,
+                    agentTools: input.include.agent_tools,
+                    triggers: input.include.triggers,
+                    behavior: input.include.behavior,
+                    platformSettings: input.include.platform_settings,
+                    pipelineSettings: input.include.pipeline_settings,
+                    knowledgeSpaceLinks: input.include.knowledge_space_links,
+                    followUpSequences: input.include.follow_up_sequences,
+                    customVariables: input.include.custom_variables,
+                }),
+                conflictMode: input.conflict_mode,
+                nameCollisionStrategy: input.name_collision_strategy,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Inspect `summary.totalEntities` + `conflicts[]` + `warnings[]` ДО execute.',
+            'Pass `preview_token` в besales_platform_clone_execute (TTL 15 min).',
+            'Если `conflicts.length > 0` и `conflict_mode=reject` — execute fails 409. Re-run preview с merge или overwrite.',
+            'Если `requires_destructive_ack: true` — execute требует second literal `acknowledge_destructive_overwrite: true` (overwrite mode заменит existing target entities). Изучите `destructive_summary` ДО подтверждения.',
+        ]),
+    }),
+    // -----------------------------------------------------------------------------
+    // v1.5 Increment 4d safety policy: NO `besales_platform_delete` tool by design.
+    // Платформа удаляется ТОЛЬКО через UI (DELETE /platforms/:id с Permission.PLATFORM_DELETE)
+    // — НЕ через MCP. Cascade effect (chats, knowledge links, follow-ups) слишком
+    // destructive для agent-driven flow. Если будущий PR попытается добавить
+    // _delete tool — оставьте policy comment здесь как guard для review.
+    //
+    // Reciprocal safety: `besales_platform_clone_execute` ниже требует ВТОРОЙ ack literal
+    // `acknowledge_destructive_overwrite: true` для overwrite mode с реальными collisions
+    // (предотвращает silent agent/follow-up/behavior replace).
+    // -----------------------------------------------------------------------------
+    defineTool({
+        name: 'besales_platform_clone_execute',
+        defaultWorkspaceId: true,
+        requiredFields: [
+            'preview_token',
+            'source_platform_id',
+            'target_platform_id',
+            'explicit_confirmation',
+        ],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            preview_token: uuidSchema,
+            source_platform_id: uuidSchema,
+            target_platform_id: uuidSchema,
+            explicit_confirmation: z.literal(true),
+            /**
+             * v1.5 Increment 4d safety — second confirmation literal.
+             *
+             * REQUIRED когда preview ответил `requires_destructive_ack: true`
+             * (conflict_mode=overwrite + ≥1 entity to overwrite). Backend throws 400
+             * DESTRUCTIVE_ACK_REQUIRED если plan destructive но ack отсутствует.
+             *
+             * Для reject/merge mode или overwrite без collisions — поле игнорируется.
+             */
+            acknowledge_destructive_overwrite: z.literal(true).optional(),
+            idempotency_key: z.string().min(1).max(255).optional(),
+            actor_note: z.string().max(2000).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/platforms/clone/execute`,
+            body: compactObject({
+                previewToken: input.preview_token,
+                sourcePlatformId: input.source_platform_id,
+                targetPlatformId: input.target_platform_id,
+                explicitConfirmation: input.explicit_confirmation,
+                acknowledgeDestructiveOverwrite: input.acknowledge_destructive_overwrite,
+                idempotencyKey: input.idempotency_key,
+                actorNote: input.actor_note,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Result reversible через besales_audit_revert (kind=revertClone) — пометит CloneRun.status=REVERTED.',
+            'idempotency_key reuse → returns cached result БЕЗ повторного выполнения.',
+            'preview_token expired (15 min) → 410 Gone, нужно повторить preview.',
+            'Если preview вернул `requires_destructive_ack: true` — обязательно передайте `acknowledge_destructive_overwrite: true` (overwrite mode фактически удалит target агентов / follow-ups / behavior).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_platform_clone_status',
+        defaultWorkspaceId: true,
+        requiredFields: ['clone_id'],
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            clone_id: uuidSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/platforms/clone/${input.clone_id}`,
+        }),
+    }),
+    // ============================================================
+    // v1.5 Increment 5a — Generic File Upload (3 tools, Setup URL pattern)
+    // ============================================================
+    // Файл НЕ передаётся через MCP/LLM: AI создаёт upload-сессию → пользователь
+    // открывает upload_page_url в браузере → drag&drop файла → backend стримит в S3.
+    // AI поллит статус по upload_ref. Upload нереверсивный (удаление — только через UI).
+    defineTool({
+        name: 'besales_file_upload_request',
+        requiredFields: ['name'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            name: z.string().min(1).max(255),
+            file_type: storedFileTypeSchema.optional(),
+            section_id: uuidSchema.optional(),
+            source: mcpFileSourceSchema.optional(),
+            mime_type: z.string().max(255).optional(),
+            size_bytes: z.number().int().positive().max(MAX_FILE_UPLOAD_BYTES).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/file-upload-sessions`,
+            body: compactObject({
+                name: input.name,
+                file_type: input.file_type,
+                section_id: input.section_id,
+                source: input.source,
+                mime_type: input.mime_type,
+                size_bytes: input.size_bytes,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Отдайте пользователю `upload_page_url` — он откроет его в браузере (уже залогинен) и загрузит файл. Секрет/файл НЕ проходит через LLM.',
+            'Затем поллите `besales_file_upload_status({ upload_ref })`: status=READY → `stored_file_id` (используйте в knowledge_document_upload / behavior greeting).',
+            'TTL сессии 15 минут. Имя файла (`name`) должно быть уникальным в workspace.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_file_upload_status',
+        requiredFields: ['upload_ref'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            upload_ref: z.string().min(1),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/file-upload-sessions/${input.upload_ref}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'status: AWAITING_USER (ждём загрузку) → VALIDATING → READY (`stored_file_id` готов) | VALIDATION_FAILED (`error_message`, пользователь может повторить) | EXPIRED (создайте новую сессию).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_file_list',
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            file_type: storedFileTypeSchema.optional(),
+            source: mcpFileSourceSchema.optional(),
+            section_id: z.string().optional(),
+            limit: z.number().int().min(1).max(200).optional(),
+            offset: z.number().int().min(0).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/files${buildFileListQuery(input)}`,
+        }),
+    }),
+    // ============================================================
+    // v1.5 Increment 5b — Platform Provisioning (API-key + OAuth каналы, 3 tools, Setup URL pattern)
+    // ============================================================
+    // Секреты (botToken / wazzupCrmKey / ...) НЕ передаются через MCP: AI создаёт сессию →
+    // пользователь открывает setup_page_url и вводит секрет в браузере → backend создаёт платформу.
+    // OAuth-каналы (Instagram, Avito) — besales_platform_create_oauth_init (авторизация в браузере,
+    // код мимо LLM). TelegramPersonal (warmup) пока не поддержан.
+    defineTool({
+        name: 'besales_platform_create_init',
+        requiredFields: ['platform_type', 'name'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            platform_type: apiKeyPlatformTypeSchema,
+            name: z.string().min(1).max(255),
+            // Публичные (НЕ секретные) поля канала. Секреты вводятся на /setup/:ref.
+            // Per-type allowlist: Wazzup={wazzup_channel}; Salebot={salebot_project_id,salebot_group_id};
+            // SmsGorod={smsgorod_channel,smsgorod_sender}; VKon={vkon_group_id};
+            // GetCourse={getcourse_account_domain,getcourse_employee_user_id,getcourse_available_transports,...};
+            // Bitrix24Bot={bitrix24_bot_name}; TelegramBot/WebWidget=none.
+            fields: optionalAnyObjectSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/platform-setup-sessions`,
+            body: compactObject({
+                platform_type: input.platform_type,
+                name: input.name,
+                fields: input.fields,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Отдайте пользователю `setup_page_url` — он откроет его в браузере и введёт секреты (`required_secret_fields`). Секреты НЕ проходят через LLM.',
+            'Затем поллите `besales_platform_create_status({ setup_ref })`: status=READY → `platform_id`.',
+            'WebWidget/Bitrix24Bot не требуют секретов (required_secret_fields пуст); Bitrix24Bot требует предварительно подключённую Bitrix24 CRM.',
+            'OAuth-каналы (Instagram, Avito) — отдельный `besales_platform_create_oauth_init`; TelegramPersonal пока не поддержан.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_platform_create_status',
+        requiredFields: ['setup_ref'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            setup_ref: z.string().min(1),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/platform-setup-sessions/${input.setup_ref}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'status: AWAITING_USER → VALIDATING → READY (`platform_id` готов) | VALIDATION_FAILED (`error_message`, напр. невалидный токен — пользователь может повторить) | EXPIRED (создайте новую сессию).',
+            'READY = платформа создана + токен онлайн-проверен для TelegramBot/VKon/GetCourse/Wazzup/Bitrix24Bot (битый ключ → VALIDATION_FAILED). Salebot/SmsGorod НЕ проверяются онлайн — для них READY означает «создано»; попросите пользователя проверить работу канала.',
+            'OAuth-каналы (Instagram/Avito): после `besales_platform_create_oauth_init` поллите этим же tool по `setup_ref`.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_platform_create_oauth_init',
+        requiredFields: ['platform_type'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            platform_type: oauthPlatformTypeSchema,
+            // Опционально: канал обычно сам именует платформу из подключённого аккаунта.
+            name: z.string().min(1).max(255).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/platform-oauth-sessions`,
+            body: compactObject({ platform_type: input.platform_type, name: input.name }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Отдайте пользователю `auth_url` — он откроет его в браузере и авторизуется у провайдера (Instagram/Avito). Код авторизации НЕ проходит через LLM.',
+            'Затем поллите `besales_platform_create_status({ setup_ref })`: READY → `platform_id` | VALIDATION_FAILED (`error_message`) | EXPIRED (создайте новую сессию).',
+            'Требуется настроенное провайдер-приложение (Meta App для Instagram, Avito app). Имя канала задаётся из подключённого аккаунта.',
+        ]),
+    }),
+    // ============================================================
+    // v1.5 Increment 5c — CRM Connection + Field Mapping + Operators (5 tools)
+    // ============================================================
+    // CRM create через Setup URL pattern (секреты в браузере, минуя LLM): GETCOURSE/TELEGRAM
+    // (API-key) + AMOCRM/BITRIX24 (вставка credentials; Bitrix24 далее завершает local-app install
+    // вебхуком). Field mapping + operators — для уже подключённых CRM (AmoCRM/Bitrix24 для mapping;
+    // AmoCRM для operators).
+    defineTool({
+        name: 'besales_crm_create_init',
+        requiredFields: ['crm_type'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_type: provisionableCrmTypeSchema,
+            // Публичные non-secret поля: GETCOURSE={account_domain, managed_tag_prefix?};
+            // TELEGRAM={forum_group_id}; AMOCRM={sub_domain, client_id}; BITRIX24={domain, client_id}.
+            // Секреты (school_api_key / crm_bot_token / client_secret / long_access_token) — на /setup/:ref.
+            fields: optionalAnyObjectSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/crm-setup-sessions`,
+            body: compactObject({ crm_type: input.crm_type, fields: input.fields }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Отдайте пользователю `setup_page_url` — он вводит в браузере ВСЕ поля (и секреты, и несекретные sub_domain/client_id/domain/...), минуя чат. Несекретные — в `required_non_secret_fields`, секреты — в `required_secret_fields`.',
+            'НЕ проси у пользователя credentials или ID в чат — всё вводится на setup-странице. `fields` в init опционален (только pre-fill).',
+            'Затем поллите `besales_crm_create_status({ setup_ref })`: READY → `crm_id`.',
+            'Детали подключения (где взять токены, какие scopes — в т.ч. для выгрузки аудио, активация) — ресурс besales://workflows/connect-crm-from-scratch. Bitrix24 после создания требует установки local-app в портале (вебхук).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_create_status',
+        requiredFields: ['setup_ref'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            setup_ref: z.string().min(1),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/crm-setup-sessions/${input.setup_ref}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'status: AWAITING_USER → VALIDATING → READY (`crm_id`) | VALIDATION_FAILED (`error_message`) | EXPIRED.',
+            'READY = CRM создана + токен онлайн-проверен для Telegram-CRM (getMe) и GetCourse (read-only API-probe) → битый токен/ключ = VALIDATION_FAILED.',
+            'AmoCRM: на READY авто-активируется, ЕСЛИ это единственная CRM workspace (токен live-проверяется при активации). Если есть другая активная CRM или токен битый — остаётся inactive → включи besales_crm_activate({ crm_id }). Bitrix24: онлайн НЕ проверяется, требует РУЧНОЙ установки local-app в портале (вебхук).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_activate',
+        requiredFields: ['crm_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/crms/${input.crm_id}/activate`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'CRM активирована: токен live-проверен, остальные CRM workspace деактивированы, связанные триггеры включены.',
+            'Активна одна CRM на workspace за раз — этот вызов ДЕАКТИВИРУЕТ предыдущую активную. Предупреди пользователя перед переключением.',
+            'Битый/просроченный токен → ошибка активации (CRM остаётся неактивной). Зови после исправления токена либо для переключения активной CRM.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_list',
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/crms`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Список CRM workspace: id, type, status, is_active, account (поддомен/домен), created_at.',
+            'Пустой список → CRM не подключена (нужен besales_crm_create_init).',
+            'is_active=false → CRM есть, но не активна (besales_crm_activate); это объясняет, почему pipelines/field-mapping/operators могут не отвечать.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_field_mapping_get',
+        requiredFields: ['crm_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/crms/${input.crm_id}/field-mapping`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Возвращает `available_fields` (поля из CRM) + `current_mappings`. Только AmoCRM/Bitrix24 — иначе `unsupported_reason`.',
+            'Используйте `available_fields[].id` как `crm_field_id` в `besales_crm_field_mapping_upsert`.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_field_mapping_upsert',
+        requiredFields: ['crm_id', 'replace_all_existing', 'enabled', 'field_mappings'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            // Replace-all semantics: передаёт весь набор mappings (не патч).
+            replace_all_existing: z.literal(true),
+            enabled: z.boolean(),
+            field_mappings: z.array(crmFieldMappingItemSchema),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'PUT',
+            path: `/workspaces/${input.workspace_id}/crms/${input.crm_id}/field-mapping`,
+            body: {
+                replace_all_existing: input.replace_all_existing,
+                enabled: input.enabled,
+                field_mappings: input.field_mappings,
+            },
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Replace-all: передавайте ВЕСЬ набор маппингов (не патч). Только AmoCRM/Bitrix24 — иначе `unsupported_reason`.',
+            'Чтобы изменить — повторно вызовите с новым полным набором (это «undo»). Audit non-reversible (снимок before в diff).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_operator_list',
+        requiredFields: ['crm_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            sync: z.boolean().optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/crms/${input.crm_id}/operators${input.sync ? '?sync=true' : ''}`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Операторы для assignee-стратегий PipelineSettings. Только AmoCRM/Bitrix24 — иначе `unsupported_reason`.',
+            'sync=true пересинхронизирует операторов из CRM перед возвратом.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_crm_operator_update',
+        requiredFields: ['crm_id', 'operator_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            crm_id: uuidSchema,
+            operator_id: uuidSchema,
+            is_operator: z.boolean().optional(),
+            is_sdr: z.boolean().optional(),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.is_operator === undefined && input.is_sdr === undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'Provide at least one of is_operator / is_sdr',
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/workspaces/${input.workspace_id}/crms/${input.crm_id}/operators/${input.operator_id}`,
+            body: compactObject({ is_operator: input.is_operator, is_sdr: input.is_sdr }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Вкл/выкл роли конкретного оператора: is_operator (assignee диалогов) и/или is_sdr. Только AmoCRM/Bitrix24 — иначе `unsupported_reason`.',
+            'Передайте хотя бы один флаг; не указанный сохраняет текущее значение. operator_id берётся из `besales_crm_operator_list`.',
+        ]),
+    }),
+];
+//# sourceMappingURL=crm-platform.js.map