@besales/mcp 0.1.0 → 0.11.1

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

@@ -0,0 +1,738 @@
+import { z } from 'zod';
+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, routingRuleLeadStatusSchema, routingStrategySchema, setupConfirmation, triggerScopeSchema, uuidSchema, withInstructions, } from './shared.js';
+export const platformSetupTools = [
+    defineTool({
+        name: 'besales_workspace_overview',
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/overview`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Single-shot snapshot всего workspace: platforms (с agentsCount), ICP profiles (с segments/samples counts), feedback sheets, MCP connections summary.',
+            'Используй ПЕРВЫМ когда user задаёт open-ended вопросы вида "что у меня есть?" / "покажи мою настройку" — заменяет N round-trips.',
+            '`setupCompleteness` — readiness-сигнал «что недоделано»: channelsConnected/Pending, crmConnected, hasAnchorAgent, hasKnowledge, knowledgeLinkedToChannel, hasTriggers/Followups, hasIcp, lastSandboxRunAt, suggestedNextPhase. Используй suggestedNextPhase как мягкий hint следующего фокуса (не приказ); продолжай настройку с него, а не с нуля.',
+            'После overview перейди на drill-down: `besales_platform_context_get` для конкретной платформы, `besales_agent_list` для агентов внутри неё.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_platform_context_get',
+        requiredFields: ['platform_id'],
+        schema: z.object({
+            platform_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/platforms/${input.platform_id}/setup/context`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Use this sanitized context first for Platform Setup Bridge flows.',
+            'Read readiness flags, then call targeted mutation tools. Do not ask the user for workspace_id.',
+            'Prompt content changes still go through besales_prompt_* tools and besales_prompt_finalize.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_agent_list',
+        requiredFields: ['platform_id'],
+        schema: z.object({
+            platform_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/platforms/${input.platform_id}/agents`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_agent_create',
+        requiredFields: ['platform_id', 'name', 'model_lane'],
+        schema: z.object({
+            platform_id: uuidSchema,
+            name: z.string(),
+            description: z.string().nullable().optional(),
+            model_lane: modelLaneSchema,
+            default_icp_profile_id: uuidSchema.optional(),
+        }),
+        createRequest: (input) => ({
+            path: `/platforms/${input.platform_id}/agents`,
+            body: compactObject({
+                name: input.name,
+                description: input.description,
+                modelLane: input.model_lane,
+                defaultIcpProfileId: input.default_icp_profile_id,
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_agent_update',
+        requiredFields: ['platform_id', 'agent_id'],
+        schema: z.object({
+            platform_id: uuidSchema,
+            agent_id: uuidSchema,
+            name: z.string().optional(),
+            description: z.string().nullable().optional(),
+            model_lane: modelLaneSchema.optional(),
+            default_icp_profile_id: uuidSchema.nullable().optional(),
+            use_global_history: z.boolean().optional(),
+            adapt_to_user_language: z.boolean().optional(),
+            // v1.5 Increment 3 Group B — typed sections.
+            runtime_config: agentRuntimeConfigSchema.optional(),
+            output_config: agentOutputConfigSchema.optional(),
+            knowledge_space_ids: z.array(uuidSchema).optional(),
+            agent_scope: agentScopeSchema.optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/platforms/${input.platform_id}/agents/${input.agent_id}`,
+            body: compactObject({
+                name: input.name,
+                description: input.description,
+                modelLane: input.model_lane,
+                defaultIcpProfileId: input.default_icp_profile_id,
+                useGlobalHistory: input.use_global_history,
+                adaptToUserLanguage: input.adapt_to_user_language,
+                runtimeConfig: input.runtime_config
+                    ? mapRuntimeConfigInput(input.runtime_config)
+                    : undefined,
+                outputConfig: input.output_config ? mapOutputConfigInput(input.output_config) : undefined,
+                knowledgeSpaceIds: input.knowledge_space_ids,
+                agentScope: input.agent_scope,
+            }),
+        }),
+    }),
+    // Phase B (2026-05-27): `besales_agent_legacy_self_analysis_set` удалён.
+    // В v2 заменён post_processors (Routing Studio Critic node) + post_processor_bindings.
+    defineTool({
+        name: 'besales_agent_tools_update',
+        requiredFields: ['platform_id', 'agent_id', 'tools'],
+        schema: z.object({
+            platform_id: uuidSchema,
+            agent_id: uuidSchema,
+            tools: z.array(agentToolPatchSchema).min(1),
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/platforms/${input.platform_id}/agents/${input.agent_id}/tools`,
+            body: {
+                tools: input.tools.map((tool) => compactObject({
+                    toolId: tool.tool_id,
+                    priority: tool.priority,
+                    isEnabled: tool.is_enabled,
+                    agentSpecificConditions: tool.agent_specific_conditions,
+                })),
+            },
+        }),
+    }),
+    defineTool({
+        name: 'besales_router_update',
+        requiredFields: ['platform_id'],
+        schema: z.object({
+            platform_id: uuidSchema,
+            name: z.string().optional(),
+            model: z.string().optional(),
+            temperature: z.number().min(0).max(2).optional(),
+            max_tokens: z.number().int().min(1).nullable().optional(),
+            additional_prompt: z.string().nullable().optional(),
+            adapt_to_user_language: z.boolean().optional(),
+            skip_llm_routing: z.boolean().optional(),
+            direct_routing_agent_id: uuidSchema.nullable().optional(),
+            ...platformSetupConfirmationSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/platforms/${input.platform_id}/router`,
+            body: compactObject({
+                name: input.name,
+                model: input.model,
+                temperature: input.temperature,
+                maxTokens: input.max_tokens,
+                additionalPrompt: input.additional_prompt,
+                adaptToUserLanguage: input.adapt_to_user_language,
+                skipLlmRouting: input.skip_llm_routing,
+                directRoutingAgentId: input.direct_routing_agent_id,
+                ...setupConfirmation(input),
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_routing_rule_upsert',
+        requiredFields: ['platform_id', 'routing_strategy', 'custom_router_prompt'],
+        schema: z.object({
+            platform_id: uuidSchema,
+            routing_rule_id: uuidSchema.optional(),
+            routing_strategy: routingStrategySchema,
+            deal_mode: z.string().nullable().optional(),
+            custom_variable_id: uuidSchema.nullable().optional(),
+            variable_value: z.string().nullable().optional(),
+            custom_router_prompt: z.string(),
+            is_enabled: z.boolean().optional(),
+            priority: z.number().int().min(0).optional(),
+            skip_llm: z.boolean().optional(),
+            direct_agent_id: uuidSchema.nullable().optional(),
+            lead_statuses: z.array(routingRuleLeadStatusSchema).optional(),
+            ...platformSetupConfirmationSchema,
+        }),
+        createRequest: (input) => ({
+            method: input.routing_rule_id ? 'PATCH' : 'POST',
+            path: `/platforms/${input.platform_id}/router/routing-rules`,
+            body: compactObject({
+                routingRuleId: input.routing_rule_id,
+                routingStrategy: input.routing_strategy,
+                dealMode: input.deal_mode,
+                customVariableId: input.custom_variable_id,
+                variableValue: input.variable_value,
+                customRouterPrompt: input.custom_router_prompt,
+                isEnabled: input.is_enabled,
+                priority: input.priority,
+                skipLlm: input.skip_llm,
+                directAgentId: input.direct_agent_id,
+                leadStatuses: input.lead_statuses?.map((status) => compactObject({
+                    leadStatusName: status.lead_status_name,
+                    leadStatusPipelineCrmId: status.lead_status_pipeline_crm_id,
+                    leadStatusPipelineId: status.lead_status_pipeline_id,
+                    leadStatusId: status.lead_status_id,
+                })),
+                ...setupConfirmation(input),
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_trigger_upsert',
+        requiredFields: ['platform_id', 'agent_id'],
+        schema: z.object({
+            platform_id: uuidSchema,
+            agent_id: uuidSchema,
+            trigger_id: uuidSchema.optional(),
+            name: z.string().optional(),
+            condition: z.string().optional(),
+            is_enabled: z.boolean().optional(),
+            priority: z.number().int().min(1).max(100).optional(),
+            stop_propagation: z.boolean().optional(),
+            scope: triggerScopeSchema,
+            metadata: anyObjectSchema.optional(),
+            actions: z.array(anyObjectSchema).optional(),
+            ...platformSetupConfirmationSchema,
+        }),
+        createRequest: (input) => ({
+            method: input.trigger_id ? 'PATCH' : 'POST',
+            path: input.trigger_id
+                ? `/platforms/${input.platform_id}/agents/${input.agent_id}/triggers/${input.trigger_id}`
+                : `/platforms/${input.platform_id}/agents/${input.agent_id}/triggers`,
+            body: compactObject({
+                name: input.name,
+                condition: input.condition,
+                isEnabled: input.is_enabled,
+                priority: input.priority,
+                stopPropagation: input.stop_propagation,
+                scope: input.scope,
+                metadata: input.metadata,
+                actions: input.actions,
+                ...setupConfirmation(input),
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_behavior_update',
+        requiredFields: ['platform_id'],
+        schema: z
+            .object({
+            platform_id: uuidSchema,
+            // v1.5 Increment 3 Group C.1 (Phase B, 2026-05-27): только typed sections.
+            greeting: behaviorGreetingSchema.optional(),
+            media_handling: behaviorMediaHandlingSchema.optional(),
+            url_handling: behaviorUrlHandlingSchema.optional(),
+            error_handling: behaviorErrorHandlingSchema.optional(),
+            operator_schedule: behaviorOperatorScheduleSchema.optional(),
+            typing_behavior: behaviorTypingBehaviorSchema.optional(),
+            message_filters: z.array(behaviorMessageFilterSchema).optional(),
+            message_splitting: behaviorMessageSplittingSchema.optional(),
+            privacy: behaviorPrivacySchema.optional(),
+            ...platformSetupConfirmationSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/platforms/${input.platform_id}/agent-behavior`,
+            body: compactObject({
+                greeting: input.greeting ? mapBehaviorGreetingInput(input.greeting) : undefined,
+                mediaHandling: input.media_handling
+                    ? mapBehaviorMediaHandlingInput(input.media_handling)
+                    : undefined,
+                urlHandling: input.url_handling
+                    ? mapBehaviorUrlHandlingInput(input.url_handling)
+                    : undefined,
+                errorHandling: input.error_handling
+                    ? mapBehaviorErrorHandlingInput(input.error_handling)
+                    : undefined,
+                operatorSchedule: input.operator_schedule
+                    ? mapBehaviorOperatorScheduleInput(input.operator_schedule)
+                    : undefined,
+                typingBehavior: input.typing_behavior
+                    ? mapBehaviorTypingInput(input.typing_behavior)
+                    : undefined,
+                messageFilters: input.message_filters
+                    ? input.message_filters.map((filter) => ({
+                        id: filter.id,
+                        source: filter.source,
+                        target: filter.target,
+                        enabled: filter.enabled,
+                        order: filter.order,
+                    }))
+                    : undefined,
+                messageSplitting: input.message_splitting
+                    ? { messageChunkSeparator: input.message_splitting.message_chunk_separator }
+                    : undefined,
+                privacy: input.privacy
+                    ? {
+                        anonymizationEnabled: input.privacy.anonymization_enabled,
+                        anonymizationDisabledTypes: input.privacy.anonymization_disabled_types,
+                    }
+                    : undefined,
+                ...setupConfirmation(input),
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_followup_sequence_upsert',
+        requiredFields: ['platform_id', 'name', 'type', 'trigger', 'config'],
+        schema: z.object({
+            platform_id: uuidSchema,
+            sequence_id: uuidSchema.optional(),
+            name: z.string(),
+            description: z.string().nullable().optional(),
+            type: followUpSequenceTypeSchema,
+            enabled: z.boolean().optional(),
+            trigger: followUpTriggerSchema,
+            config: anyObjectSchema,
+            ...platformSetupConfirmationSchema,
+        }),
+        createRequest: (input) => ({
+            method: input.sequence_id ? 'PATCH' : 'POST',
+            path: input.sequence_id
+                ? `/platforms/${input.platform_id}/follow-up/sequences/${input.sequence_id}`
+                : `/platforms/${input.platform_id}/follow-up/sequences`,
+            body: compactObject({
+                name: input.name,
+                description: input.description,
+                type: input.type,
+                enabled: input.enabled,
+                trigger: input.trigger,
+                config: input.config,
+                ...setupConfirmation(input),
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_pipeline_settings_update',
+        requiredFields: ['platform_id'],
+        schema: z
+            .object({
+            platform_id: uuidSchema,
+            // v1.5 Increment 3 Group C.3 (Phase B, 2026-05-27): только typed sections.
+            crm_pipeline_behavior: pipelineCrmBehaviorSchema.optional(),
+            auto_finish: pipelineAutoFinishSchema.optional(),
+            ...platformSetupConfirmationSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/platforms/${input.platform_id}/pipeline-settings`,
+            body: compactObject({
+                crmPipelineBehavior: input.crm_pipeline_behavior
+                    ? mapPipelineCrmBehaviorInput(input.crm_pipeline_behavior)
+                    : undefined,
+                autoFinish: input.auto_finish ? mapPipelineAutoFinishInput(input.auto_finish) : undefined,
+                ...setupConfirmation(input),
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_platform_settings_update',
+        requiredFields: ['platform_id'],
+        schema: z
+            .object({
+            platform_id: uuidSchema,
+            // v1.5 Increment 3 Group C.2 (Phase B, 2026-05-27).
+            // Flat-only fields — backward compat для existing UI clients (deprecated через 2 weeks).
+            // Новый код должен использовать generalSettings.* typed section.
+            name: z.string().nullable().optional(),
+            off_message: z.string().optional(),
+            timezone: z.string().optional(),
+            // Typed sections (single source of truth для access/variables/crm/widget/instagram).
+            access_control: platformAccessControlSchema.optional(),
+            variables_config: platformVariablesConfigSchema.optional(),
+            crm_behavior: platformCrmBehaviorSchema.optional(),
+            widget_marketing: platformWidgetMarketingSchema.optional(),
+            instagram_comment_behavior: platformInstagramCommentSchema.optional(),
+            // v1.5 Increment 4c — per-channel typed sections (hard 400 для unsupported channel type)
+            general_settings: platformGeneralSettingsSchema.optional(),
+            salebot_settings: platformSalebotSettingsSchema.optional(),
+            smsgorod_settings: platformSmsgorodSettingsSchema.optional(),
+            bitrix24_bot_settings: platformBitrix24BotSettingsSchema.optional(),
+            getcourse_settings: platformGetcourseSettingsSchema.optional(),
+            ...platformSetupConfirmationSchema,
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/platforms/${input.platform_id}/settings`,
+            body: compactObject({
+                name: input.name,
+                offMessage: input.off_message,
+                timezone: input.timezone,
+                accessControl: input.access_control
+                    ? mapPlatformAccessControlInput(input.access_control)
+                    : undefined,
+                variablesConfig: input.variables_config
+                    ? mapPlatformVariablesConfigInput(input.variables_config)
+                    : undefined,
+                crmBehavior: input.crm_behavior
+                    ? mapPlatformCrmBehaviorInput(input.crm_behavior)
+                    : undefined,
+                widgetMarketing: input.widget_marketing
+                    ? mapPlatformWidgetMarketingInput(input.widget_marketing)
+                    : undefined,
+                instagramCommentBehavior: input.instagram_comment_behavior
+                    ? mapPlatformInstagramCommentInput(input.instagram_comment_behavior)
+                    : undefined,
+                generalSettings: input.general_settings
+                    ? mapPlatformGeneralSettingsInput(input.general_settings)
+                    : undefined,
+                salebotSettings: input.salebot_settings
+                    ? mapPlatformSalebotSettingsInput(input.salebot_settings)
+                    : undefined,
+                smsgorodSettings: input.smsgorod_settings
+                    ? mapPlatformSmsgorodSettingsInput(input.smsgorod_settings)
+                    : undefined,
+                bitrix24BotSettings: input.bitrix24_bot_settings
+                    ? mapPlatformBitrix24BotSettingsInput(input.bitrix24_bot_settings)
+                    : undefined,
+                getcourseSettings: input.getcourse_settings
+                    ? mapPlatformGetcourseSettingsInput(input.getcourse_settings)
+                    : undefined,
+                ...setupConfirmation(input),
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Per-channel typed sections (salebot/smsgorod/bitrix24Bot/getcourse) — hard 400 при mismatched platform.type.',
+            'generalSettings.* — closes Phase B gap для name/offMessage/timezone/isActive; flat fields deprecated через 2 недели.',
+            'Response.warnings[] содержит Phase A soft-warnings для widgetMarketing/instagramCommentBehavior на mismatched channel (hard reject после 2026-06-10).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_audit_revert',
+        requiredFields: ['audit_log_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            // `platform_id` — для platform-scoped audit logs (записи через platform-setup-adapter).
+            // Если опущен — revert идёт через workspace-scoped endpoint (variables-adapter и т.п.,
+            // где audit logs пишутся с platformId=null).
+            platform_id: uuidSchema.optional(),
+            audit_log_id: uuidSchema,
+        })
+            .strict(),
+        createRequest: (input) => {
+            if (input.platform_id) {
+                return {
+                    method: 'POST',
+                    path: `/platforms/${input.platform_id}/audit/${input.audit_log_id}/revert`,
+                };
+            }
+            return {
+                method: 'POST',
+                path: `/workspaces/${input.workspace_id}/audit/${input.audit_log_id}/revert`,
+            };
+        },
+        enhanceResponse: (response) => withInstructions(response, [
+            'Передай `platform_id` для platform-scoped logs (audit через platform-setup-adapter).',
+            'Опусти `platform_id` для workspace-scoped logs (variables-adapter и аналоги).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_feedback_sheet_link',
+        requiredFields: ['agent_id', 'source_url'],
+        schema: z.object({
+            agent_id: uuidSchema,
+            source_url: z.string().url(),
+            access_mode: z.enum(['READ_ONLY', 'EDITABLE']).default('READ_ONLY'),
+            agent_version_id: uuidSchema.optional(),
+        }),
+        createRequest: (input) => ({
+            path: `/agents/${input.agent_id}/feedback-sheets`,
+            body: compactObject({
+                sourceUrl: input.source_url,
+                accessMode: input.access_mode,
+                agentVersionId: input.agent_version_id,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Таблица привязана к промпту. Расшарьте её на service account из поля serviceAccountEmail (Viewer для READ_ONLY, Editor для EDITABLE).',
+            'Прочитайте замечания через besales_feedback_sheet_read по feedbackSheet.id.',
+            'accessMode определяет режим: READ_ONLY — только предлагаете правки промпта; EDITABLE — дополнительно отмечаете статусы строк (Phase 2).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_feedback_sheet_list',
+        requiredFields: ['agent_id'],
+        schema: z.object({
+            agent_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/agents/${input.agent_id}/feedback-sheets`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_feedback_sheet_read',
+        requiredFields: ['agent_id', 'feedback_sheet_id'],
+        schema: z.object({
+            agent_id: uuidSchema,
+            feedback_sheet_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/agents/${input.agent_id}/feedback-sheets/${input.feedback_sheet_id}/content`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Проанализируйте строки замечаний тестировщиков, сгруппируйте по смыслу и важности.',
+            'Для правки промпта используйте patch flow: besales_prompt_patch_start → besales_prompt_patch_apply (с операциями replace_text / insert_after_text / etc) → besales_prompt_patch_commit.',
+            'Не финализируйте промпт (besales_prompt_finalize) без подтверждения пользователя.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_feedback_sheet_unlink',
+        requiredFields: ['agent_id', 'feedback_sheet_id'],
+        schema: z.object({
+            agent_id: uuidSchema,
+            feedback_sheet_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/agents/${input.agent_id}/feedback-sheets/${input.feedback_sheet_id}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_feedback_sheet_row_update',
+        requiredFields: ['agent_id', 'feedback_sheet_id', 'rows'],
+        schema: z.object({
+            agent_id: uuidSchema,
+            feedback_sheet_id: uuidSchema,
+            rows: z.array(feedbackSheetRowSchema).min(1),
+            status_column: z.string().optional(),
+            comment_column: z.string().optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/agents/${input.agent_id}/feedback-sheets/${input.feedback_sheet_id}/rows`,
+            body: compactObject({
+                rows: input.rows.map((row) => compactObject({
+                    rowNumber: row.row_number,
+                    rowHash: row.row_hash,
+                    status: row.status,
+                    comment: row.comment,
+                })),
+                statusColumn: input.status_column,
+                commentColumn: input.comment_column,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Статусы строк записаны в таблицу с цветовой заливкой.',
+            'Если ответ — ошибка про service account, запись недоступна: работай в read-only режиме (только besales_feedback_sheet_read + предложение правок промпта).',
+            'Если ошибка 409 — строки сдвинулись: перечитай таблицу через besales_feedback_sheet_read и повтори с актуальными rowHash.',
+        ]),
+    }),
+    // S4.13 — besales_facts_classify_and_migrate
+    defineTool({
+        name: 'besales_facts_classify_and_migrate',
+        requiredFields: ['agent_id'],
+        schema: z.object({
+            agent_id: uuidSchema,
+            namespace_record_id: uuidSchema.optional(),
+        }),
+        createRequest: (input) => ({
+            path: `/agents/${input.agent_id}/facts/classify-and-migrate`,
+            body: compactObject({
+                namespaceRecordId: input.namespace_record_id,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Active facts разобраны: Q&A pairs созданы через QaService, document chunks отмечены как pending.',
+            'Мигрированные chunks перемещены в секцию `## Migrated` в AgentChat.factualContext (audit trail).',
+            'Если категория `document` — text→document loader pending, повторно вызовы безопасны (idempotent per chunk).',
+        ]),
+    }),
+    // S2.5 extra — besales_agent_facts_set
+    defineTool({
+        name: 'besales_agent_facts_set',
+        requiredFields: ['agent_id', 'factual_context'],
+        schema: z.object({
+            agent_id: uuidSchema,
+            factual_context: z.string(),
+        }),
+        createRequest: (input) => ({
+            method: 'PUT',
+            path: `/agents/${input.agent_id}/facts`,
+            body: { factualContext: input.factual_context },
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'factualContext записан целиком (PUT-семантика, replace not patch).',
+            'Если в warnings есть `soft_limit_exceeded` (~8000 chars / 2K tokens) — рекомендую запустить `besales_facts_classify_and_migrate`.',
+            'Структура: `## Active facts` блок инъектится в системный промпт; `## Migrated` — лог миграций (не инъектится).',
+        ]),
+    }),
+    // ─────────────────────────────────────────────────────────────────
+    // S3.8-integration .5 — Patch-based PromptDraft tools
+    // (Должны быть ПЕРЕД besales_prompt_lint чтобы matched contract order.)
+    // ─────────────────────────────────────────────────────────────────
+    defineTool({
+        name: 'besales_prompt_patch_start',
+        requiredFields: ['agent_id'],
+        schema: z.object({
+            agent_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/agents/${input.agent_id}/prompt/drafts`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'PromptDraft создан. ID в `draft.id`. TTL 24h, resets на каждом `_apply`.',
+            'Дальше: `besales_prompt_patch_apply(draft_id, operations[])` → batch правок → `besales_prompt_patch_commit(draft_id)`.',
+            'Если `conflictsWithOtherUsers` непустой — другой пользователь редактирует тот же агент. Не блокирует, но warning.',
+            'Server-side hash → клиенту не нужно знать про activePromptContentHash.',
+            'Гигиена: правь формулировки ПО МЕСТУ в существующих секциях; не добавляй override-блоки/дубли-секции в конец (антипаттерн → тех-долг). Сначала прочти весь промпт (besales_prompt_patch_get) и найди, где правило уже есть. См. «Редактирование промпта» в serverInstructions.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_prompt_patch_get',
+        requiredFields: ['agent_id', 'draft_id'],
+        schema: z.object({
+            agent_id: uuidSchema,
+            draft_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/agents/${input.agent_id}/prompt/drafts/${input.draft_id}`,
+        }),
+    }),
+    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),
+        }),
+        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,
+                })),
+            },
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Operations применены. `appliedCount` — успешно, `skippedCount` — anchor не найден или growth guard сработал (>30% size).',
+            'Если `skippedCount > 0` — проверь target_text / anchor_text на точность. matchVariants[] помогает fuzzy-match.',
+            'TTL draft сброшен на 24h.',
+            'Когда правки готовы — `besales_prompt_patch_commit(draft_id)`.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_prompt_patch_commit',
+        requiredFields: ['agent_id', 'draft_id'],
+        schema: z.object({
+            agent_id: uuidSchema,
+            draft_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/agents/${input.agent_id}/prompt/drafts/${input.draft_id}/commit`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Commit: lint pass → новая PromptVersion в prompt-services → AgentChat.baseSystemPrompt обновлён.',
+            'Если ошибка 400 с `lintIssues` — поправь через `_apply` (hard_fail issues блокируют commit).',
+            'Если ошибка 409 PROMPT_DRAFT_REBASE_REQUIRED — другой commit прошёл первым. Discard этот draft и сделай новый.',
+            'Server-side hash → клиенту не нужно передавать activePromptContentHash.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_prompt_patch_discard',
+        requiredFields: ['agent_id', 'draft_id'],
+        schema: z.object({
+            agent_id: uuidSchema,
+            draft_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/agents/${input.agent_id}/prompt/drafts/${input.draft_id}`,
+        }),
+    }),
+    // S2.6 extra — besales_prompt_lint (после patches, чтобы matched catalog order)
+    defineTool({
+        name: 'besales_prompt_lint',
+        requiredFields: ['prompt_text'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            prompt_text: z.string(),
+            agent_id: uuidSchema.optional(),
+            channel: z.string().optional(),
+            agent_scope: z
+                .enum([
+                'sale',
+                'reactivation',
+                'support',
+                'onboarding',
+                'faq',
+                'qualification',
+                'complaint',
+                'other',
+            ])
+                .optional(),
+            feedback_banned_terms: z.array(z.string()).optional(),
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/prompt-lint`,
+            body: compactObject({
+                promptText: input.prompt_text,
+                agentId: input.agent_id,
+                channel: input.channel,
+                agentScope: input.agent_scope,
+                feedbackBannedTerms: input.feedback_banned_terms,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Standalone lint: проверка ДО `besales_prompt_finalize` (избегает цикла «finalize → 400 → fix»).',
+            'Severity: `hard_fail` блокирует finalize; `warn` — рекомендация; `info` — заметки.',
+            'Если передан `agent_id` — channel и agentScope резолвятся из AgentChat (markdown-checker и scope-consistency активны).',
+        ]),
+    }),
+];
+//# sourceMappingURL=platform-setup.js.map