@besales/mcp 0.45.0 → 0.47.0

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

@@ -1,11 +1,13 @@
 import { z } from 'zod';
+import { assertCompleteList } from '../incomplete-list.js';
 import { followUpSetupTools } from './follow-up-setup.js';
 import { getCourseWaveTools } from './getcourse-wave.js';
 import { normalizeTriggerActions } from '../trigger-action-config.js';
-import { agentOutputConfigSchema, agentRuntimeConfigSchema, agentScopeSchema, agentToolPatchSchema, anyObjectSchema, behaviorErrorHandlingSchema, behaviorGreetingSchema, behaviorMediaHandlingSchema, behaviorMessageFilterSchema, behaviorMessageSplittingSchema, behaviorOperatorScheduleSchema, behaviorPrivacySchema, behaviorTypingBehaviorSchema, behaviorUrlHandlingSchema, buildListQuery, compactObject, defineTool, feedbackSheetRowSchema, mapBehaviorErrorHandlingInput, mapBehaviorGreetingInput, mapBehaviorMediaHandlingInput, mapBehaviorOperatorScheduleInput, mapBehaviorTypingInput, mapBehaviorUrlHandlingInput, mapOutputConfigInput, mapPipelineAutoFinishInput, mapPipelineCrmBehaviorInput, mapPlatformAccessControlInput, mapPlatformBitrix24BotSettingsInput, mapPlatformCrmBehaviorInput, mapPlatformGeneralSettingsInput, mapPlatformGetcourseSettingsInput, mapPlatformInstagramCommentInput, mapPlatformSalebotSettingsInput, mapPlatformSmsgorodSettingsInput, mapPlatformVariablesConfigInput, mapPlatformWidgetMarketingInput, mapRuntimeConfigInput, modelLaneSchema, pipelineAutoFinishSchema, pipelineCrmBehaviorSchema, platformAccessControlSchema, platformBitrix24BotSettingsSchema, platformCrmBehaviorSchema, platformGeneralSettingsSchema, platformGetcourseSettingsSchema, platformInstagramCommentSchema, platformSalebotSettingsSchema, platformSetupConfirmationSchema, platformSmsgorodSettingsSchema, platformVariablesConfigSchema, mapPromptPatchOperationInput, platformWidgetMarketingSchema, PROMPT_BATCH_IDEMPOTENCY_KEY_MAX_LENGTH, PROMPT_BATCH_MAX_AGENTS, PROMPT_DIFF_MAX_LINES_LIMIT, promptPatchOperationSchema, routingRuleConditionSchema, routingRuleLeadStatusSchema, routingStrategySchema, setupConfirmation, triggerScopeSchema, uuidSchema, withInstructions, } from './shared.js';
+import { PLATFORM_AGENTS_MAX_PAGE_SIZE, agentOutputConfigSchema, agentRuntimeConfigSchema, agentScopeSchema, agentToolPatchSchema, anyObjectSchema, behaviorErrorHandlingSchema, behaviorGreetingSchema, behaviorMediaHandlingSchema, behaviorMessageFilterSchema, behaviorMessageSplittingSchema, behaviorOperatorScheduleSchema, behaviorPrivacySchema, behaviorTypingBehaviorSchema, behaviorUrlHandlingSchema, buildListQuery, compactObject, defineTool, feedbackSheetRowSchema, mapBehaviorErrorHandlingInput, mapBehaviorGreetingInput, mapBehaviorMediaHandlingInput, mapBehaviorOperatorScheduleInput, mapBehaviorTypingInput, mapBehaviorUrlHandlingInput, mapOutputConfigInput, mapPipelineAutoFinishInput, mapPipelineCrmBehaviorInput, mapPlatformAccessControlInput, mapPlatformBitrix24BotSettingsInput, mapPlatformCrmBehaviorInput, mapPlatformGeneralSettingsInput, mapPlatformGetcourseSettingsInput, mapPlatformFunnelAnalyticsInput, mapPlatformInstagramCommentInput, mapPlatformSalebotSettingsInput, mapPlatformSmsgorodSettingsInput, mapPlatformVariablesConfigInput, mapPlatformWidgetMarketingInput, mapRuntimeConfigInput, modelLaneSchema, pipelineAutoFinishSchema, pipelineCrmBehaviorSchema, platformAccessControlSchema, platformBitrix24BotSettingsSchema, platformCrmBehaviorSchema, platformGeneralSettingsSchema, platformGetcourseSettingsSchema, platformFunnelAnalyticsSchema, platformInstagramCommentSchema, platformSalebotSettingsSchema, platformSetupConfirmationSchema, platformSmsgorodSettingsSchema, platformVariablesConfigSchema, mapPromptPatchOperationInput, platformWidgetMarketingSchema, PROMPT_BATCH_IDEMPOTENCY_KEY_MAX_LENGTH, PROMPT_BATCH_MAX_AGENTS, PROMPT_DIFF_MAX_LINES_LIMIT, promptPatchOperationSchema, routingRuleConditionSchema, routingRuleLeadStatusSchema, routingStrategySchema, setupConfirmation, triggerScopeSchema, uuidSchema, withInstructions, } from './shared.js';
 export const platformSetupTools = [
     defineTool({
         name: 'besales_workspace_overview',
+        sideEffect: 'none',
         requiredFields: [],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -22,36 +24,178 @@ export const platformSetupTools = [
             'После overview перейди на drill-down: `besales_platform_context_get` для конкретной платформы, `besales_agent_list` для агентов внутри неё.',
         ]),
     }),
+    defineTool({
+        name: 'besales_workspace_navigate',
+        sideEffect: 'none',
+        closedWorld: true,
+        requiredFields: ['intent'],
+        defaultWorkspaceId: true,
+        resultPolicy: { neverTruncate: true },
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            intent: z.enum([
+                'CREATE_BOT',
+                'IMPROVE_AGENT',
+                'DIAGNOSE_CONTACT',
+                'AUDIT_DIALOGUES',
+                'CAMPAIGN_REPORT',
+                'CONNECT_CRM',
+                'CONNECT_DATASOURCE',
+                'CONFIGURE_FOLLOWUP',
+                'CONTINUE_TASK',
+                'FREEFORM',
+            ]),
+            bot_type: z.enum(['FAQ', 'SALES', 'BOOKING', 'OUTBOUND', 'SUPPORT', 'UNKNOWN']).optional(),
+            platform_id: uuidSchema.optional(),
+            agent_id: uuidSchema.optional(),
+            contact_id: uuidSchema.optional(),
+            task_id: uuidSchema.optional(),
+            question: z.string().trim().min(2).max(500).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/navigation`,
+            body: compactObject({
+                intent: input.intent,
+                botType: input.bot_type,
+                platformId: input.platform_id,
+                agentId: input.agent_id,
+                contactId: input.contact_id,
+                taskId: input.task_id,
+                question: input.question,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'next.tool и next.arguments — один адресный следующий шаг; placeholders перечислены в requiredUserInput и не должны угадываться.',
+            'Сохранённый overview — evidence только на момент ответа. Перед записью перечитай выбранный объект, а после записи выполни next.verifyWith.',
+            'CREATE_BOT учитывает bot_type: FAQ не требует ICP/CRM автоматически, SALES/BOOKING/OUTBOUND требуют ICP и условий до доказательства готовности.',
+            'FREEFORM возвращает help route и не запускает обязательный шестишаговый мастер.',
+        ]),
+    }),
     defineTool({
         name: 'besales_platform_context_get',
+        sideEffect: 'none',
         requiredFields: ['platform_id'],
+        resultPolicy: {
+            neverTruncate: true,
+            droppablePaths: ['agents[].baseSystemPrompt'],
+            narrowingHint: 'Снимок канала отдаётся целиком и на канале с десятками агентов не помещается в ответ. Работайте по одному агенту: besales_agent_list для перечня, besales_prompt_patch_get для промпта.',
+        },
         schema: z.object({
             platform_id: uuidSchema,
+            sections: z
+                .array(z.enum([
+                'platform',
+                'agent_summaries',
+                'agents_full',
+                'router',
+                'behavior',
+                'follow_up',
+                'pipeline_settings',
+                'readiness',
+            ]))
+                .min(1)
+                .optional(),
         }),
         createRequest: (input) => ({
             method: 'GET',
-            path: `/platforms/${input.platform_id}/setup/context`,
+            path: `/platforms/${input.platform_id}/setup/context` +
+                (input.sections
+                    ? `?sections=${encodeURIComponent(input.sections.join(','))}`
+                    : ''),
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Use this sanitized context first for Platform Setup Bridge flows.',
+            'Для точечного чтения передай sections; agent_summaries не содержит полный промпт, agents_full содержит.',
             '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_trigger_action_catalog_get',
+        sideEffect: 'none',
+        requiredFields: ['platform_id'],
+        resultPolicy: { neverTruncate: true },
+        schema: z.object({
+            platform_id: uuidSchema,
+            action_type: z.string().trim().min(1).optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/platforms/${input.platform_id}/setup/trigger-action-catalog` +
+                (input.action_type ? `?actionType=${encodeURIComponent(input.action_type)}` : ''),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Каталог построен из боевого CreateTriggerActionDto и канона TRIGGER_ACTION_CONFIG.',
+            'Перед созданием нового actionType запроси его отдельно через action_type и используй minimalExample без угадывания имени config-поля.',
+            'После записи выполни verification из записи каталога; перечитывание контекста проверяет сохранение, но не внешний эффект.',
+        ]),
+    }),
     defineTool({
         name: 'besales_agent_list',
+        sideEffect: 'none',
         requiredFields: ['platform_id'],
+        resultPolicy: { neverTruncate: true },
         schema: z.object({
             platform_id: uuidSchema,
+            limit: z.number().int().min(1).max(PLATFORM_AGENTS_MAX_PAGE_SIZE).optional(),
+            cursor: z.string().min(1).optional(),
+            query: z.string().min(1).optional(),
+        }),
+        createRequest: (input) => {
+            const query = new URLSearchParams();
+            if (input.limit !== undefined)
+                query.set('limit', String(input.limit));
+            if (input.cursor)
+                query.set('cursor', input.cursor);
+            if (input.query)
+                query.set('q', input.query);
+            const suffix = query.size > 0 ? `?${query.toString()}` : '';
+            return { method: 'GET', path: `/platforms/${input.platform_id}/agents${suffix}` };
+        },
+        enhanceResponse: (response, input) => assertCompleteList(response, {
+            pageRequested: input.limit !== undefined || input.cursor !== undefined,
+            toolName: 'besales_agent_list',
+            howToPage: `Повтори вызов с limit до ${PLATFORM_AGENTS_MAX_PAGE_SIZE} и cursor из ответа, пока cursor не станет пустым.`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_agent_get',
+        sideEffect: 'none',
+        requiredFields: ['agent_id'],
+        resultPolicy: { neverTruncate: true },
+        schema: z.object({
+            agent_id: uuidSchema,
         }),
         createRequest: (input) => ({
             method: 'GET',
-            path: `/platforms/${input.platform_id}/agents`,
+            path: `/agents/${input.agent_id}`,
         }),
     }),
+    defineTool({
+        name: 'besales_agent_readiness_get',
+        sideEffect: 'none',
+        closedWorld: true,
+        requiredFields: ['agent_id'],
+        resultPolicy: { neverTruncate: true },
+        schema: z.object({ agent_id: uuidSchema }).strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/agents/${input.agent_id}/readiness`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Сейчас readiness всегда отвечает NOT_PROVEN: API не фиксирует версию зависимых настроек (behavior, routing, triggers, knowledge, ICP), и повтор sandbox этого не снимает. Не обещай пользователю READY.',
+            'Выполни адресные пункты missing и перечитай readiness; promptAndAgentCurrent=true означает только актуальность промпта и записи агента.',
+            'passRate не является quality. Нужны COMPLETED, свежая конфигурация, findings, qualityRate и checksRate с expectations.',
+            'crmAuthorization=NOT_EVALUATED не подтверждает live-доступ CRM; проверяй его отдельной health/authorization операцией, если CRM нужна сценарию.',
+        ]),
+    }),
     defineTool({
         name: 'besales_agent_variable_overrides_get',
+        sideEffect: 'none',
         requiredFields: ['platform_id', 'agent_id'],
+        resultPolicy: { neverTruncate: true },
         schema: z.object({
             platform_id: uuidSchema,
             agent_id: uuidSchema,
@@ -68,6 +212,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_getcourse_departments_list',
+        sideEffect: 'none',
         requiredFields: ['platform_id'],
         schema: z.object({
             platform_id: uuidSchema,
@@ -84,6 +229,7 @@ export const platformSetupTools = [
     ...getCourseWaveTools,
     defineTool({
         name: 'besales_wazzup_templates_list',
+        sideEffect: 'none',
         requiredFields: ['platform_id'],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -102,6 +248,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_wazzup_wave_import',
+        sideEffect: 'spend',
         requiredFields: ['platform_id', 'template_guid', 'contacts'],
         defaultWorkspaceId: true,
         schema: z
@@ -168,6 +315,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_wazzup_wave_status',
+        sideEffect: 'none',
         requiredFields: ['job_id'],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -187,6 +335,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_agent_create',
+        sideEffect: 'write',
         requiredFields: ['platform_id', 'name', 'model_lane'],
         schema: z.object({
             platform_id: uuidSchema,
@@ -233,6 +382,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_agent_clone',
+        sideEffect: 'write',
         requiredFields: ['platform_id', 'source_agent_id', 'name'],
         schema: z.object({
             // Платформа-источник; клон приземляется на неё же (cross-platform не поддерживается).
@@ -260,6 +410,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_agent_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id', 'agent_id'],
         schema: z.object({
             platform_id: uuidSchema,
@@ -325,6 +476,7 @@ export const platformSetupTools = [
     // В v2 заменён post_processors (Routing Studio Critic node) + post_processor_bindings.
     defineTool({
         name: 'besales_agent_tools_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id', 'agent_id', 'tools'],
         schema: z.object({
             platform_id: uuidSchema,
@@ -346,6 +498,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_router_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id'],
         schema: z.object({
             platform_id: uuidSchema,
@@ -377,6 +530,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_routing_rule_upsert',
+        sideEffect: 'write',
         requiredFields: ['platform_id', 'routing_strategy', 'custom_router_prompt'],
         schema: z.object({
             platform_id: uuidSchema,
@@ -437,6 +591,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_trigger_upsert',
+        sideEffect: 'write',
         requiredFields: ['platform_id', 'agent_id'],
         schema: z.object({
             platform_id: uuidSchema,
@@ -530,6 +685,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_trigger_delete',
+        sideEffect: 'write',
         requiredFields: ['platform_id', 'agent_id', 'trigger_id', 'explicit_confirmation'],
         schema: z
             .object({
@@ -552,6 +708,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_behavior_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id'],
         schema: z
             .object({
@@ -615,6 +772,7 @@ export const platformSetupTools = [
     ...followUpSetupTools,
     defineTool({
         name: 'besales_pipeline_settings_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id'],
         schema: z
             .object({
@@ -639,6 +797,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_platform_settings_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id'],
         schema: z
             .object({
@@ -655,6 +814,9 @@ export const platformSetupTools = [
             crm_behavior: platformCrmBehaviorSchema.optional(),
             widget_marketing: platformWidgetMarketingSchema.optional(),
             instagram_comment_behavior: platformInstagramCommentSchema.optional(),
+            // Настройки раздела «Воронка канала»: ворота решения, цель «Пути до стадии», пороги.
+            // Бэкенд делегирует запись сервисам раздела — их валидация не обходится.
+            funnel_analytics: platformFunnelAnalyticsSchema.optional(),
             // v1.5 Increment 4c — per-channel typed sections (hard 400 для unsupported channel type)
             general_settings: platformGeneralSettingsSchema.optional(),
             salebot_settings: platformSalebotSettingsSchema.optional(),
@@ -686,6 +848,9 @@ export const platformSetupTools = [
                 instagramCommentBehavior: input.instagram_comment_behavior
                     ? mapPlatformInstagramCommentInput(input.instagram_comment_behavior)
                     : undefined,
+                funnelAnalytics: input.funnel_analytics
+                    ? mapPlatformFunnelAnalyticsInput(input.funnel_analytics)
+                    : undefined,
                 generalSettings: input.general_settings
                     ? mapPlatformGeneralSettingsInput(input.general_settings)
                     : undefined,
@@ -705,6 +870,9 @@ export const platformSetupTools = [
             }),
         }),
         enhanceResponse: (response) => withInstructions(response, [
+            'funnel_analytics — настройки раздела «Воронка канала»: ворота решения (тройка стадий), целевая стадия «Пути до стадии», пороги. null у ворот и цели — СБРОС, отсутствие поля — «не трогать».',
+            '⚠️ Ворота проверяются бэкендом: три стадии обязаны быть РАЗНЫМИ и существовать в каталоге площадки — иначе 400. Совпади «одобрено» с «отклонено», доля одобрения стала бы вечными 50 % при любых данных.',
+            '⚠️ Секция НЕ попадает в audit log площадки: besales_audit_revert её НЕ откатит. Чтобы вернуть прежнее, пришлите прежние значения тем же тулом либо сбросьте через null.',
             '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).',
@@ -712,6 +880,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_audit_revert',
+        sideEffect: 'write',
         requiredFields: ['audit_log_id'],
         defaultWorkspaceId: true,
         schema: z
@@ -743,6 +912,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_feedback_sheet_link',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'source_url'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -766,6 +936,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_feedback_sheet_list',
+        sideEffect: 'none',
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -777,6 +948,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_feedback_sheet_read',
+        sideEffect: 'none',
         requiredFields: ['agent_id', 'feedback_sheet_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -794,6 +966,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_feedback_sheet_unlink',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'feedback_sheet_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -806,6 +979,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_feedback_sheet_row_update',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'feedback_sheet_id', 'rows'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -837,6 +1011,7 @@ export const platformSetupTools = [
     // S4.13 — besales_facts_classify_and_migrate
     defineTool({
         name: 'besales_facts_classify_and_migrate',
+        sideEffect: 'spend',
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -857,6 +1032,7 @@ export const platformSetupTools = [
     // S2.5 extra — besales_agent_facts_set
     defineTool({
         name: 'besales_agent_facts_set',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'factual_context'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -879,6 +1055,11 @@ export const platformSetupTools = [
     // ─────────────────────────────────────────────────────────────────
     defineTool({
         name: 'besales_prompt_patch_start',
+        // Ответ несёт ПОЛНЫЙ текст промпта — до 80 000 символов по боевой границе платформы, то
+        // есть до ~160 КБ кириллицей. Общий потолок в 64 КБ отказывал бы на штатном промпте, а
+        // текст здесь незаменим: по нему строят якоря правок, и усечённый даёт промах якоря.
+        resultPolicy: { neverTruncate: true, maxResultBytes: 400_000 },
+        sideEffect: 'write',
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -897,6 +1078,11 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_patch_get',
+        // Ответ несёт ПОЛНЫЙ текст промпта — до 80 000 символов по боевой границе платформы, то
+        // есть до ~160 КБ кириллицей. Общий потолок в 64 КБ отказывал бы на штатном промпте, а
+        // текст здесь незаменим: по нему строят якоря правок, и усечённый даёт промах якоря.
+        resultPolicy: { neverTruncate: true, maxResultBytes: 400_000 },
+        sideEffect: 'none',
         requiredFields: ['agent_id', 'draft_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -911,6 +1097,7 @@ export const platformSetupTools = [
     // mcp-tools.json (registry.spec проверяет parity), поэтому вставка строго после _patch_get.
     defineTool({
         name: 'besales_prompt_headroom',
+        sideEffect: 'none',
         requiredFields: ['agent_id'],
         // .strict() — иначе опечатка `draftId` вместо `draft_id` молча отбрасывается zod'ом,
         // и тулза измеряет закоммиченный промпт вместо черновика.
@@ -934,6 +1121,8 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_diff',
+        sideEffect: 'none',
+        closedWorld: true,
         requiredFields: ['agent_id', 'compare_agent_id'],
         schema: z
             .object({
@@ -956,6 +1145,11 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_patch_apply',
+        // Ответ несёт ПОЛНЫЙ текст промпта — до 80 000 символов по боевой границе платформы, то
+        // есть до ~160 КБ кириллицей. Общий потолок в 64 КБ отказывал бы на штатном промпте, а
+        // текст здесь незаменим: по нему строят якоря правок, и усечённый даёт промах якоря.
+        resultPolicy: { neverTruncate: true, maxResultBytes: 400_000 },
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'draft_id', 'operations'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -972,12 +1166,16 @@ export const platformSetupTools = [
         enhanceResponse: (response) => withInstructions(response, [
             'Operations применены. `appliedCount` — успешно, `skippedCount` — anchor не найден или growth guard сработал (>30% size).',
             'Если `skippedCount > 0` — проверь target_text / anchor_text на точность. matchVariants[] помогает fuzzy-match.',
+            'Текста черновика в ответе НЕТ — приезжает `diff` (`removedLines`/`addedLines`, `charactersDelta`) и `draft.characters`. Промпт целиком ты уже прочитал на `_start`; перечитать — `besales_prompt_patch_get`.',
+            'Пустые `removedLines`/`addedLines` — НЕ признак «ничего не применилось»: дифф это разность МНОЖЕСТВ строк, и `move_text_after_text` (как и правка одних пробелов) даёт пустые списки. Факт изменения читай по `diff.contentChanged`, объём — по `charactersDelta`.',
+            '`diff.truncated: true` — изменённых строк больше потолка; тогда сверяйся через `besales_prompt_patch_get`.',
             'TTL draft сброшен на 24h.',
             'Когда правки готовы — `besales_prompt_patch_commit(draft_id)`.',
         ]),
     }),
     defineTool({
         name: 'besales_prompt_patch_commit',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'draft_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -989,6 +1187,7 @@ export const platformSetupTools = [
         }),
         enhanceResponse: (response) => withInstructions(response, [
             'Commit: lint pass → новая PromptVersion в prompt-services → AgentChat.baseSystemPrompt обновлён.',
+            'В ответе только адресация версии (`newVersion.id`, `newVersion.version`) и метаданные черновика — текст промпта не дублируется.',
             'Если ошибка 400 с `lintIssues` — поправь через `_apply` (hard_fail issues блокируют commit).',
             'Если ошибка 409 PROMPT_DRAFT_REBASE_REQUIRED — другой commit прошёл первым. Discard этот draft и сделай новый.',
             'Server-side hash → клиенту не нужно передавать activePromptContentHash.',
@@ -999,6 +1198,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_patch_discard',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'draft_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -1013,7 +1213,8 @@ export const platformSetupTools = [
     // mcp-tools.json — registry.spec сверяет имена позиционно.
     defineTool({
         name: 'besales_prompt_batch_start',
-        requiredFields: ['agent_ids', 'operations'],
+        sideEffect: 'spend',
+        requiredFields: ['agent_ids', 'operations', 'explicit_confirmation'],
         schema: z
             .object({
             agent_ids: z.array(uuidSchema).min(1).max(PROMPT_BATCH_MAX_AGENTS),
@@ -1021,6 +1222,7 @@ export const platformSetupTools = [
             all_or_nothing: z.boolean().optional(),
             idempotency_key: z.string().max(PROMPT_BATCH_IDEMPOTENCY_KEY_MAX_LENGTH).optional(),
             platform_id: uuidSchema.optional(),
+            explicit_confirmation: z.literal(true),
         })
             .strict(),
         createRequest: (input) => ({
@@ -1043,6 +1245,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_batch_status',
+        sideEffect: 'none',
         requiredFields: ['run_id'],
         schema: z.object({ run_id: uuidSchema }).strict(),
         createRequest: (input) => ({
@@ -1052,6 +1255,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_batch_resume',
+        sideEffect: 'spend',
         requiredFields: ['run_id'],
         schema: z.object({ run_id: uuidSchema }).strict(),
         createRequest: (input) => ({
@@ -1066,6 +1270,8 @@ export const platformSetupTools = [
     // S2.6 extra — besales_prompt_lint (после patches, чтобы matched catalog order)
     defineTool({
         name: 'besales_prompt_lint',
+        sideEffect: 'none',
+        closedWorld: true,
         requiredFields: ['prompt_text'],
         defaultWorkspaceId: true,
         schema: z.object({