@besales/mcp 0.46.0 → 0.47.1

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

@@ -1,11 +1,21 @@
 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, 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';
+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';
+/**
+ * Потолки названия и условия триггера — зеркала `AGENT_TRIGGER_NAME_MAX_LENGTH` и
+ * `AGENT_TRIGGER_CONDITION_MAX_LENGTH` бэкенда. Границы общие с формой интерфейса: форма шлёт
+ * все поля целиком на каждом сохранении, и записанное здесь значение длиннее потолка оператор
+ * уже не смог бы сохранить из неё.
+ */
+const TRIGGER_NAME_MAX_LENGTH = 100;
+const TRIGGER_CONDITION_MAX_LENGTH = 4000;
 export const platformSetupTools = [
     defineTool({
         name: 'besales_workspace_overview',
+        sideEffect: 'none',
         requiredFields: [],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -22,36 +32,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 +220,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_getcourse_departments_list',
+        sideEffect: 'none',
         requiredFields: ['platform_id'],
         schema: z.object({
             platform_id: uuidSchema,
@@ -84,6 +237,7 @@ export const platformSetupTools = [
     ...getCourseWaveTools,
     defineTool({
         name: 'besales_wazzup_templates_list',
+        sideEffect: 'none',
         requiredFields: ['platform_id'],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -102,6 +256,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_wazzup_wave_import',
+        sideEffect: 'spend',
         requiredFields: ['platform_id', 'template_guid', 'contacts'],
         defaultWorkspaceId: true,
         schema: z
@@ -168,6 +323,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_wazzup_wave_status',
+        sideEffect: 'none',
         requiredFields: ['job_id'],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -187,6 +343,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 +390,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 +418,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_agent_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id', 'agent_id'],
         schema: z.object({
             platform_id: uuidSchema,
@@ -325,6 +484,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 +506,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_router_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id'],
         schema: z.object({
             platform_id: uuidSchema,
@@ -377,6 +538,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,13 +599,15 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_trigger_upsert',
+        sideEffect: 'write',
         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(),
+            // `.trim()` — как у формы и бэкенда: строка из пробелов пустая, «Оплата » равна «Оплата».
+            name: z.string().trim().min(1).max(TRIGGER_NAME_MAX_LENGTH).optional(),
+            condition: z.string().trim().min(1).max(TRIGGER_CONDITION_MAX_LENGTH).optional(),
             is_enabled: z.boolean().optional(),
             priority: z.number().int().min(1).max(100).optional(),
             stop_propagation: z.boolean().optional(),
@@ -530,6 +694,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 +717,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_behavior_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id'],
         schema: z
             .object({
@@ -615,6 +781,7 @@ export const platformSetupTools = [
     ...followUpSetupTools,
     defineTool({
         name: 'besales_pipeline_settings_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id'],
         schema: z
             .object({
@@ -639,6 +806,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_platform_settings_update',
+        sideEffect: 'write',
         requiredFields: ['platform_id'],
         schema: z
             .object({
@@ -721,6 +889,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_audit_revert',
+        sideEffect: 'write',
         requiredFields: ['audit_log_id'],
         defaultWorkspaceId: true,
         schema: z
@@ -752,6 +921,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_feedback_sheet_link',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'source_url'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -775,6 +945,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_feedback_sheet_list',
+        sideEffect: 'none',
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -786,6 +957,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_feedback_sheet_read',
+        sideEffect: 'none',
         requiredFields: ['agent_id', 'feedback_sheet_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -803,6 +975,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_feedback_sheet_unlink',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'feedback_sheet_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -815,6 +988,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,
@@ -846,6 +1020,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,
@@ -866,6 +1041,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,
@@ -888,6 +1064,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,
@@ -906,6 +1087,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,
@@ -920,6 +1106,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'ом,
         // и тулза измеряет закоммиченный промпт вместо черновика.
@@ -943,6 +1130,8 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_diff',
+        sideEffect: 'none',
+        closedWorld: true,
         requiredFields: ['agent_id', 'compare_agent_id'],
         schema: z
             .object({
@@ -965,6 +1154,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,
@@ -990,6 +1184,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_patch_commit',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'draft_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -1012,6 +1207,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_patch_discard',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'draft_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -1026,7 +1222,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),
@@ -1034,6 +1231,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) => ({
@@ -1056,6 +1254,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_batch_status',
+        sideEffect: 'none',
         requiredFields: ['run_id'],
         schema: z.object({ run_id: uuidSchema }).strict(),
         createRequest: (input) => ({
@@ -1065,6 +1264,7 @@ export const platformSetupTools = [
     }),
     defineTool({
         name: 'besales_prompt_batch_resume',
+        sideEffect: 'spend',
         requiredFields: ['run_id'],
         schema: z.object({ run_id: uuidSchema }).strict(),
         createRequest: (input) => ({
@@ -1079,6 +1279,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({