@besales/mcp 0.48.0 → 1.0.0-beta.4

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

@@ -1,514 +1,45 @@
+import { withEditVersionInstructions, editVersionInstruction } from './edit-version.js';
+import { agentSettingsTools } from './agent-settings.js';
+import { triggerSetupActionItemSchema } from './trigger-action-item.schema.js';
+import { followupSequenceConfigSchema as followupCompatSequenceConfigSchema } from './followup-getcourse-compat.js';
+import { followUpPromotionInstructions } from './follow-up-promotion-instructions.js';
+import { triggerUpsertTool } from './trigger-upsert.tool.js';
 import { z } from 'zod';
-import { assertCompleteList } from '../incomplete-list.js';
+import { crmStagePoolMessage } from './crm-stage-pool.messages.js';
+import { refineFollowUpConfig } from './follow-up-config.js';
 import { followUpSetupTools } from './follow-up-setup.js';
-import { getCourseWaveTools } from './getcourse-wave.js';
-import { normalizeTriggerActions } from '../trigger-action-config.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';
+import { withProjectedRoutingRule } from './routing-condition-projection.js';
+import { withoutDraftPromptText, withoutDuplicatedPromptText } from './prompt-text-projection.js';
+import { droppedShippedFields, shippedFormConflicts, shippedFormErrorHandlingSchema, shippedFormGreetingSchema, shippedFormMessageFiltersSchema, shippedFormMessageSplittingSchema, shippedFormOperatorScheduleSchema, shippedFormPrivacySchema, shippedFormTypingBehaviorSchema, translateShippedBehavior, } from './behavior-shipped-form.js';
+import { behaviorCrmSchema, behaviorMediaHandlingSchema, behaviorUnsupportedInputHandlingSchema, behaviorUrlHandlingSchema, buildListQuery, compactObject, defineTool, feedbackSheetRowSchema, followUpSequenceTypeSchema, followUpTriggerSchema, knowledgeSpaceIdSchema, mapPipelineAutoFinishInput, mapPipelineCrmBehaviorInput, mapPromptPatchOperationInput, pipelineAutoFinishSchema, pipelineCrmBehaviorSchema, platformSetupConfirmationSchema, PROMPT_BATCH_IDEMPOTENCY_KEY_MAX_LENGTH, PROMPT_BATCH_MAX_AGENTS, PROMPT_DIFF_MAX_LINES_LIMIT, promptPatchOperationSchema, routingRuleConditionSchema, routingRuleLeadStatusSchema, routingStrategySchema, setupConfirmation, uuidSchema, withInstructions, withSchemaVersion, } from './shared.js';
+import { platformSettingsSections, platformSettingsUpdateSchema, } from './platform-settings-update.js';
+import { platformSetupWaveTools } from './platform-setup-wave.js';
+import { feedbackDocumentConfirmationSchema } from './feedback-document-access.js';
 /**
- * Потолки названия и условия триггера — зеркала `AGENT_TRIGGER_NAME_MAX_LENGTH` и
- * `AGENT_TRIGGER_CONDITION_MAX_LENGTH` бэкенда. Границы общие с формой интерфейса: форма шлёт
- * все поля целиком на каждом сохранении, и записанное здесь значение длиннее потолка оператор
- * уже не смог бы сохранить из неё.
+ * Потолок БАЗЫ имени копии цепочки дожимов. Зеркалит `@MaxLength` DTO v2: без него агент получал
+ * бы поздний 400 вместо ранней понятной ошибки.
+ *
+ * ⚠️ Отгружаемая линия знает 200 — предел индекса v1.5. В v2 имя цепочки ограничено 160 на всей
+ * API-границе, поэтому здесь сознательно у́же; сужение объявлено строкой реестра отставания.
  */
-const TRIGGER_NAME_MAX_LENGTH = 100;
-const TRIGGER_CONDITION_MAX_LENGTH = 4000;
+const FOLLOWUP_CLONE_NAME_MAX_LENGTH = 160;
+export const triggerActionItemSchema = triggerSetupActionItemSchema;
+export const followupSequenceConfigSchema = followupCompatSequenceConfigSchema;
 export const platformSetupTools = [
-    defineTool({
-        name: 'besales_workspace_overview',
-        sideEffect: 'none',
-        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_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` +
-                (input.sections
-                    ? `?sections=${encodeURIComponent(input.sections.join(','))}`
-                    : ''),
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'Для точечного чтения передай 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: `/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,
-        }),
-        createRequest: (input) => ({
-            method: 'GET',
-            path: `/platforms/${input.platform_id}/agents/${input.agent_id}/variable-overrides`,
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'Read-only: текущие перезаписи переменных агента. `workspaceOverrides[]` — перезаписи WorkspaceVariable ({{{name}}}); `customOverrides[]` — перезаписи платформенной CustomVariable ({name}). Каждая: id переменной + name + type + overrideValue.',
-            'Читай ПЕРЕД besales_agent_update: поля agent_workspace_variable_overrides / agent_variable_overrides заменяют набор ЦЕЛИКОМ (delete отсутствующих + upsert присланных). Чтобы не затереть уже выставленную перезапись (напр. registration_link), переотправь её вместе с новыми.',
-            'Пустой набор → у агента нет перезаписей, он наследует дефолты переменных воркспейса/платформы.',
-        ]),
-    }),
-    defineTool({
-        name: 'besales_getcourse_departments_list',
-        sideEffect: 'none',
-        requiredFields: ['platform_id'],
-        schema: z.object({
-            platform_id: uuidSchema,
-        }),
-        createRequest: (input) => ({
-            method: 'GET',
-            path: `/platforms/${input.platform_id}/getcourse/departments`,
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'Живой список отделов GetCourse Inbox школы ({ id, title }).',
-            'Используй department.id как target_department_id в besales_platform_settings_update (getcourse_settings) для department-routing.',
-        ]),
-    }),
-    ...getCourseWaveTools,
-    defineTool({
-        name: 'besales_wazzup_templates_list',
-        sideEffect: 'none',
-        requiredFields: ['platform_id'],
-        defaultWorkspaceId: true,
-        schema: z.object({
-            workspace_id: uuidSchema.optional(),
-            platform_id: uuidSchema,
-        }),
-        createRequest: (input) => ({
-            method: 'GET',
-            path: `/workspaces/${input.workspace_id}/wazzup-waves/templates/${input.platform_id}`,
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'Шаблоны WABA платформы Wazzup: templateGuid, title, status модерации Meta, bodyText, variableCount (сколько значений переменных нужно), usable + unsupportedReasons.',
-            'В волне используй ТОЛЬКО шаблоны с usable=true. Остальные либо не одобрены Meta, либо содержат медиа-заголовок / переменную в URL-кнопке — там значения ушли бы не в те слоты.',
-            'variableCount считается по МАКСИМАЛЬНОМУ индексу {{n}}: «{{1}} … {{2}} … {{1}}» — это 2 значения, а не 3.',
-        ]),
-    }),
-    defineTool({
-        name: 'besales_wazzup_wave_import',
-        sideEffect: 'spend',
-        requiredFields: ['platform_id', 'template_guid', 'contacts'],
-        defaultWorkspaceId: true,
-        schema: z
-            .object({
-            workspace_id: uuidSchema.optional(),
-            platform_id: uuidSchema,
-            template_guid: z.string().trim().max(100),
-            template_values: z.array(z.string()).max(20).optional(),
-            contacts: z
-                .array(z.object({
-                phone: z.string().trim().max(32),
-                name: z.string().max(200).optional(),
-            }))
-                .min(1)
-                .max(500),
-            funnel: z.string().max(200).optional(),
-            segment: z.string().max(200).optional(),
-            product_code: z
-                .string()
-                .trim()
-                .max(100)
-                .regex(/^[^\s/]+$/, 'product_code: без пробелов и «/»')
-                .optional(),
-            product_name: z.string().max(200).optional(),
-            cohort_label: z.string().max(200).optional(),
-            confirm: z.boolean().optional(),
-            /**
-             * Обязателен ВМЕСТЕ с confirm=true: волна необратима и платна (каждый WABA-шаблон
-             * тарифицируется Meta). Dry-run (без confirm) подтверждения не требует.
-             */
-            explicit_confirmation: z.literal(true).optional(),
-            confirmation_reason: z.string().optional(),
-        })
-            .refine((input) => !input.confirm || input.explicit_confirmation === true, {
-            message: 'Реальный запуск волны требует explicit_confirmation=true: сообщения платные и необратимые',
-            path: ['explicit_confirmation'],
-        }),
-        createRequest: (input) => ({
-            method: 'POST',
-            path: `/workspaces/${input.workspace_id}/wazzup-waves/import`,
-            body: compactObject({
-                platformId: input.platform_id,
-                templateGuid: input.template_guid,
-                templateValues: input.template_values,
-                funnel: input.funnel,
-                segment: input.segment,
-                productCode: input.product_code,
-                productName: input.product_name,
-                cohortLabel: input.cohort_label,
-                contacts: input.contacts?.map((c) => compactObject({ phone: c.phone, name: c.name })),
-                confirm: input.confirm,
-            }),
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'Волна WhatsApp через Wazzup: одобренный WABA-шаблон уходит по когорте телефонов. Ответы получателей обрабатывает AI-агент платформы, волна видна в «Аналитике рассылок» (канал WhatsApp).',
-            'БЕЗ confirm=true — DRY-RUN: прогоняется ПОЛНЫЙ preflight (платформа, живой WABA-канал, шаблон, число значений) и возвращается previewText — НИ ОДНО сообщение не отправляется. Покажи previewText пользователю и запускай реально только с confirm=true.',
-            'Реальный запуск требует ОДНОВРЕМЕННО confirm=true и explicit_confirmation=true — второе ставится только после явного согласия пользователя на отправку платных сообщений.',
-            'КАЖДОЕ маркетинговое сообщение WhatsApp ПЛАТНОЕ, а Meta ограничивает число уникальных получателей в сутки (на старте 250, дальше растёт после верификации бизнеса). Не запускай большие когорты без явного согласия пользователя.',
-            'template_guid бери из besales_wazzup_templates_list (только usable=true). Длина template_values обязана совпасть с variableCount шаблона, иначе запуск отклонят.',
-            'Повторная отправка ТОГО ЖЕ шаблона тому же контакту в течение суток пропускается автоматически (защита от двойного списания). Другой шаблон той же когорте не блокируется.',
-            'Пропускаются контакты, остановившие бота, ждущие оператора и заблокированные — они попадут в skipped, а не в failed.',
-            'В ответе confirm-запуска — jobId. Опрашивай его через besales_wazzup_wave_status до status=COMPLETED (отправки идут с паузами).',
-        ]),
-    }),
-    defineTool({
-        name: 'besales_wazzup_wave_status',
-        sideEffect: 'none',
-        requiredFields: ['job_id'],
-        defaultWorkspaceId: true,
-        schema: z.object({
-            workspace_id: uuidSchema.optional(),
-            job_id: uuidSchema,
-        }),
-        createRequest: (input) => ({
-            method: 'GET',
-            path: `/workspaces/${input.workspace_id}/wazzup-waves/${input.job_id}`,
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'Статус волны WhatsApp: status (PROCESSING|COMPLETED), processedRows, sent/failed/skipped, errors (построчные причины).',
-            'skipped — сознательные пропуски (клиент остановил бота, ждёт оператора, недавно уже получал этот шаблон). Это НЕ ошибки: сумма sent+failed+skipped равна числу обработанных строк.',
-            'Доставка приходит вебхуками WhatsApp и живёт ОТДЕЛЬНО от исхода отправки: delivered/read/deliveryFailed + deliveryErrors (коды). Докладывай их вместе с sent — «отправлено» означает лишь, что Wazzup принял сообщение.',
-            'delivered и deliveryFailed взаимоисключающи; read — подмножество delivered. unknownOutcome — строки, занятые под отправку без известного исхода (краш между claim и ответом Wazzup); автоматически они НЕ переотправляются и требуют ручного разбора.',
-        ]),
-    }),
-    defineTool({
-        name: 'besales_agent_create',
-        sideEffect: 'write',
-        requiredFields: ['platform_id', 'name', 'model_lane'],
-        schema: z.object({
-            platform_id: uuidSchema,
-            name: z.string(),
-            description: z.string().nullable().optional(),
-            model_lane: modelLaneSchema,
-            // Явный id модели (override). Если задан — побеждает model_lane.
-            // Список доступных моделей — besales_model_catalog_list.
-            model: z.string().optional(),
-            default_icp_profile_id: uuidSchema.optional(),
-            // Phase 1 — перезаписи переменных на уровне агента (бьют по CustomVariable платформы).
-            agent_variable_overrides: z
-                .array(z.object({
-                custom_variable_id: uuidSchema,
-                override_value: z.union([z.string(), z.number(), z.boolean()]),
-            }))
-                .optional(),
-            // Перезаписи переменных воркспейса на уровне агента (бьют по WorkspaceVariable).
-            agent_workspace_variable_overrides: z
-                .array(z.object({
-                workspace_variable_id: uuidSchema,
-                override_value: z.union([z.string(), z.number(), z.boolean()]),
-            }))
-                .optional(),
-        }),
-        createRequest: (input) => ({
-            path: `/platforms/${input.platform_id}/agents`,
-            body: compactObject({
-                name: input.name,
-                description: input.description,
-                modelLane: input.model_lane,
-                model: input.model,
-                defaultIcpProfileId: input.default_icp_profile_id,
-                agentVariableOverrides: input.agent_variable_overrides?.map((o) => ({
-                    customVariableId: o.custom_variable_id,
-                    overrideValue: o.override_value,
-                })),
-                agentWorkspaceVariableOverrides: input.agent_workspace_variable_overrides?.map((o) => ({
-                    workspaceVariableId: o.workspace_variable_id,
-                    overrideValue: o.override_value,
-                })),
-            }),
-        }),
-    }),
-    defineTool({
-        name: 'besales_agent_clone',
-        sideEffect: 'write',
-        requiredFields: ['platform_id', 'source_agent_id', 'name'],
-        schema: z.object({
-            // Платформа-источник; клон приземляется на неё же (cross-platform не поддерживается).
-            platform_id: uuidSchema,
-            // Исходный AgentChat для глубокого копирования (обязан принадлежать platform_id).
-            source_agent_id: uuidSchema,
-            // Системное имя нового агента; при коллизии backend добавит суффикс _N.
-            name: z.string(),
-            // Отображаемое имя нового агента; если не задано — зеркалит name.
-            display_name: z.string().optional(),
-        }),
-        createRequest: (input) => ({
-            method: 'POST',
-            path: `/platforms/${input.platform_id}/agents/${input.source_agent_id}/clone`,
-            body: compactObject({
-                name: input.name,
-                displayName: input.display_name,
-            }),
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'Клон — глубокая копия исходного агента на ТОЙ ЖЕ платформе (platform_id): baseSystemPrompt, knowledge namespaces, модель/model-lane/runtime, tools + builtin tools, перезаписи переменных (agent + workspace), ICP-линки и ВСЕ триггеры+действия скопированы на новый agent id (в ответе agent.id).',
-            'НЕ скопированы (осознанно): routing rules (per-router) и per-platform behavior. Клон инертен, пока не привязан к роутеру — добавь routing rule (besales_routing_rule_upsert), чтобы диалоги на него попадали.',
-            'Промпт идентичен источнику; PromptHub авто-bootstrap создаст новую версию при первой prompt-операции (besales_prompt_*). Cross-platform клон не поддерживается — для переноса на другую платформу используй besales_platform_clone_*.',
-        ]),
-    }),
-    defineTool({
-        name: 'besales_agent_update',
-        sideEffect: 'write',
-        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(),
-            // Явный id модели (override). Если задан — побеждает model_lane.
-            // Список доступных моделей — besales_model_catalog_list.
-            model: z.string().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(),
-            // Phase 1 — перезаписи переменных на уровне агента (полная замена набора).
-            agent_variable_overrides: z
-                .array(z.object({
-                custom_variable_id: uuidSchema,
-                override_value: z.union([z.string(), z.number(), z.boolean()]),
-            }))
-                .optional(),
-            // Перезаписи переменных воркспейса на уровне агента (полная замена набора).
-            agent_workspace_variable_overrides: z
-                .array(z.object({
-                workspace_variable_id: uuidSchema,
-                override_value: z.union([z.string(), z.number(), z.boolean()]),
-            }))
-                .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,
-                model: input.model,
-                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,
-                agentVariableOverrides: input.agent_variable_overrides?.map((o) => ({
-                    customVariableId: o.custom_variable_id,
-                    overrideValue: o.override_value,
-                })),
-                agentWorkspaceVariableOverrides: input.agent_workspace_variable_overrides?.map((o) => ({
-                    workspaceVariableId: o.workspace_variable_id,
-                    overrideValue: o.override_value,
-                })),
-            }),
-        }),
-    }),
+    ...platformSetupWaveTools,
+    ...agentSettingsTools,
     // 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',
-        sideEffect: 'write',
-        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',
         sideEffect: 'write',
         requiredFields: ['platform_id'],
         schema: z.object({
+            expected_version: z
+                .string()
+                .min(1)
+                .regex(/^[A-Za-z0-9_.-]+$/u)
+                .optional(),
             platform_id: uuidSchema,
             name: z.string().optional(),
             model: z.string().optional(),
@@ -522,8 +53,9 @@ export const platformSetupTools = [
         }),
         createRequest: (input) => ({
             method: 'PATCH',
-            path: `/platforms/${input.platform_id}/router`,
+            path: `/channels/${input.platform_id}/router`,
             body: compactObject({
+                expectedVersion: input.expected_version,
                 name: input.name,
                 model: input.model,
                 temperature: input.temperature,
@@ -535,12 +67,18 @@ export const platformSetupTools = [
                 ...setupConfirmation(input),
             }),
         }),
+        enhanceResponse: withEditVersionInstructions,
     }),
     defineTool({
         name: 'besales_routing_rule_upsert',
         sideEffect: 'write',
         requiredFields: ['platform_id', 'routing_strategy', 'custom_router_prompt'],
         schema: z.object({
+            expected_version: z
+                .string()
+                .min(1)
+                .regex(/^[A-Za-z0-9_.-]+$/u)
+                .optional(),
             platform_id: uuidSchema,
             routing_rule_id: uuidSchema.optional(),
             routing_strategy: routingStrategySchema,
@@ -561,26 +99,19 @@ export const platformSetupTools = [
         }),
         createRequest: (input) => ({
             method: input.routing_rule_id ? 'PATCH' : 'POST',
-            path: `/platforms/${input.platform_id}/router/routing-rules`,
+            path: `/channels/${input.platform_id}/router/routing-rules`,
             body: compactObject({
+                expectedVersion: input.expected_version,
                 routingRuleId: input.routing_rule_id,
                 routingStrategy: input.routing_strategy,
                 dealMode: input.deal_mode,
                 customVariableId: input.custom_variable_id,
                 variableValue: input.variable_value,
                 conditionLogic: input.condition_logic,
-                conditions: input.conditions?.map((condition) => ({
+                conditions: input.conditions?.map((condition) => compactObject({
                     customVariableId: condition.custom_variable_id,
-                    // Набор — источник истины; legacy-скаляр пробрасываем как есть (API примет обе формы).
-                    // Без этого маппинга variable_values терялся бы молча: до правки сюда уходил только скаляр.
-                    // Незаданную форму не отправляем вовсе: явный undefined в теле выглядел бы как
-                    // «поле передано пустым» и мешал бы взаимоисключающей валидации на стороне API.
-                    ...(condition.variable_values !== undefined
-                        ? { variableValues: condition.variable_values }
-                        : {}),
-                    ...(condition.variable_value !== undefined
-                        ? { variableValue: condition.variable_value }
-                        : {}),
+                    variableValue: condition.variable_value,
+                    variableValues: condition.variable_values,
                 })),
                 customRouterPrompt: input.custom_router_prompt,
                 isEnabled: input.is_enabled,
@@ -596,102 +127,9 @@ export const platformSetupTools = [
                 ...setupConfirmation(input),
             }),
         }),
+        enhanceResponse: (response) => withEditVersionInstructions(withProjectedRoutingRule(response)),
     }),
-    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(),
-            // `.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(),
-            /** Повтор ВНУТРИ одного ответа модели. Горизонт — этот ответ, дальше состояние теряется. */
-            allow_repeated_calls: z.boolean().optional(),
-            /**
-             * Одно срабатывание на контакт НАВСЕГДА (право в `agent_trigger_contact_claims`).
-             * Ось другая, чем у `allow_repeated_calls`: тот живёт один ответ, этот переживает
-             * все следующие сообщения. Для действий, пишущих в чужие системы (заметка в CRM).
-             */
-            run_once_per_contact: z.boolean().optional(),
-            scope: triggerScopeSchema,
-            metadata: anyObjectSchema.optional(),
-            /**
-             * Действия триггера. Конфиг действия кладётся в поле, ИМЯ которого зависит от actionType:
-             * правило `camelCase(actionType) + 'Config'`, но у пяти типов имена легаси
-             * (см. `TRIGGER_ACTION_CONFIG_NAMES`). Имя в ОТВЕТЕ API другое — MCP принимает оба.
-             */
-            actions: z.array(anyObjectSchema).optional(),
-            replace_actions: z.boolean().optional(),
-            ...platformSetupConfirmationSchema,
-        }).superRefine((input, ctx) => {
-            if (!input.actions?.length) {
-                return;
-            }
-            for (const issue of normalizeTriggerActions(input.actions)
-                .issues) {
-                ctx.addIssue({
-                    code: z.ZodIssueCode.custom,
-                    path: ['actions', issue.index],
-                    message: issue.message,
-                });
-            }
-        }),
-        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,
-                allowRepeatedCalls: input.allow_repeated_calls,
-                runOncePerContact: input.run_once_per_contact,
-                scope: input.scope,
-                metadata: input.metadata,
-                // Конфиг под именем связи (как его отдаёт besales_platform_context_get) переименовывается
-                // в ключ входа: бэкенд с forbidNonWhitelisted отверг бы имя ответа как «лишнее свойство».
-                actions: input.actions
-                    ? normalizeTriggerActions(input.actions).actions
-                    : undefined,
-                replaceActions: input.replace_actions,
-                ...setupConfirmation(input),
-            }),
-        }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'Конфиг действия кладётся в поле, имя которого зависит от actionType: правило ' +
-                'camelCase(actionType)+"Config" (CRM_UPDATE_FIELD → crmUpdateFieldConfig). Пять исключений: ' +
-                'CRM_MOVE_STAGE → crmConfig, SCHEDULE_FOLLOWUP → scheduleFollowUpConfig, ' +
-                'SUMMARIZE_DIALOG → summarizeConfig, SEND_TELEGRAM_CHANNEL_MESSAGE → telegramChannelConfig, ' +
-                'CRM_RENAME_DEAL → renameDealConfig. В ОТВЕТЕ тот же конфиг приходит под именем связи ' +
-                '(crmMoveStage, summarizeAction, telegramChannelMessage, renameDeal, scheduleFollowUp) — ' +
-                'пересылать прочитанное можно как есть: MCP переименует конфиг и снимет поля, которые ' +
-                'ответ отдаёт, а вход не принимает (id, triggerId, createdAt, updatedAt, пустые связи).',
-            'Действие с обязательным конфигом, отправленное без него, бэкенд отвергает: раньше оно ' +
-                'сохранялось пустым, отвечало 200, а отказ всплывал только в живом диалоге.',
-            'replace_actions=true заменяет ВЕСЬ набор действий триггера (delete-and-recreate, как в UI) — ' +
-                'сперва прочитай текущие действия (besales_platform_context_get) и передай ПОЛНЫЙ желаемый набор, ' +
-                'а не дельту, иначе потеряешь не переданные действия.',
-            'Без replace_actions передача actions на существующем триггере отклоняется (защита от случайной потери).',
-            'SILENT_AI: оси молчания РАЗДЕЛЬНЫЕ (silenceBot — бот перестаёт отвечать; ' +
-                'silenceFollowUps — цепочки перестают инициировать касания), и обе включены ПО УМОЛЧАНИЮ. ' +
-                'При replace_actions передавай их ЯВНО: пересобрав действие без этих полей, ты молча ' +
-                'вернёшь выключенную ось во включённую (дефолт = прежнее поведение экшена, а не ' +
-                '«как было»). Обе выключенные отвергаются.',
-            'allow_repeated_calls и run_once_per_contact — РАЗНЫЕ оси, не синонимы: первый про повтор ' +
-                'внутри одного ответа модели, второй запрещает срабатывание навсегда после первого ' +
-                'успешного действия у этого контакта. Для действий, пишущих в чужие системы (заметка в CRM, ' +
-                'создание сделки), нужен именно run_once_per_contact.',
-        ]),
-    }),
+    triggerUpsertTool,
     defineTool({
         name: 'besales_trigger_delete',
         sideEffect: 'write',
@@ -707,7 +145,7 @@ export const platformSetupTools = [
             .strict(),
         createRequest: (input) => ({
             method: 'DELETE',
-            path: `/platforms/${input.platform_id}/agents/${input.agent_id}/triggers/${input.trigger_id}`,
+            path: `/channels/${input.platform_id}/agents/${input.agent_id}/triggers/${input.trigger_id}`,
             body: setupConfirmation(input),
         }),
         enhanceResponse: (response) => withInstructions(response, [
@@ -721,62 +159,174 @@ export const platformSetupTools = [
         requiredFields: ['platform_id'],
         schema: z
             .object({
+            expected_version: z
+                .string()
+                .min(1)
+                .regex(/^[A-Za-z0-9_.-]+$/u)
+                .optional(),
             platform_id: uuidSchema,
-            // v1.5 Increment 3 Group C.1 (Phase B, 2026-05-27): только typed sections.
-            greeting: behaviorGreetingSchema.optional(),
+            // Секции с прежними именами полей принимают и прежнюю форму вызова (перевод — behavior-shipped-form.ts).
+            greeting: shippedFormGreetingSchema.optional(),
             media_handling: behaviorMediaHandlingSchema.optional(),
+            unsupported_input_handling: behaviorUnsupportedInputHandlingSchema.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(),
+            error_handling: shippedFormErrorHandlingSchema.optional(),
+            operator_schedule: shippedFormOperatorScheduleSchema.optional(),
+            typing_behavior: shippedFormTypingBehaviorSchema.optional(),
+            message_filters: shippedFormMessageFiltersSchema.optional(),
+            message_splitting: shippedFormMessageSplittingSchema.optional(),
+            privacy: shippedFormPrivacySchema.optional(),
+            crm_behavior: behaviorCrmSchema.optional(),
             ...platformSetupConfirmationSchema,
         })
-            .strict(),
+            .strict()
+            .superRefine((value, context) => {
+            for (const conflict of shippedFormConflicts(value)) {
+                context.addIssue({
+                    code: 'custom',
+                    path: conflict.path,
+                    message: conflict.message,
+                });
+            }
+        }),
+        createRequest: (input) => {
+            // ⛔ Сервер видит только канон новой версии: прежние имена и форма переводятся ЗДЕСЬ, одной функцией.
+            const sections = translateShippedBehavior({
+                greeting: input.greeting,
+                error_handling: input.error_handling,
+                operator_schedule: input.operator_schedule,
+                typing_behavior: input.typing_behavior,
+                message_filters: input.message_filters,
+                message_splitting: input.message_splitting,
+                privacy: input.privacy,
+            });
+            const section = (name) => withSchemaVersion(sections[name]);
+            return {
+                method: 'PATCH',
+                path: `/channels/${input.platform_id}/behavior`,
+                body: compactObject({
+                    expectedVersion: input.expected_version,
+                    greeting: section('greeting'),
+                    mediaHandling: withSchemaVersion(input.media_handling),
+                    unsupportedInputHandling: withSchemaVersion(input.unsupported_input_handling),
+                    urlHandling: withSchemaVersion(input.url_handling),
+                    errorHandling: section('error_handling'),
+                    operatorSchedule: section('operator_schedule'),
+                    typingBehavior: section('typing_behavior'),
+                    messageFilters: section('message_filters'),
+                    messageSplitting: section('message_splitting'),
+                    privacy: section('privacy'),
+                    crmBehavior: withSchemaVersion(input.crm_behavior),
+                    ...setupConfirmation(input),
+                }),
+            };
+        },
+        enhanceResponse: (response, input) => withInstructions(response, [
+            editVersionInstruction(),
+            ...droppedShippedFields(input).map((field) => `Поле ${field} прежней версии не исполнялось и там, в новой не хранится — значение отброшено.`),
+            'Секция СЛИВАЕТСЯ с текущей: присылай только те поля, которые меняешь — соседние сохранятся. null у поля очищает его.',
+            'У канала, который ещё не настраивали, сливать не с чем: ПЕРВАЯ запись секции обязана быть полной. Текущее состояние читается besales_platform_context_get (поле behavior).',
+            'В message_filters.rules образец source должен быть непустым после trim(), но значимые краевые пробелы сохраняются. Несимволы Unicode запрещены и в source, и в target. Сервер раскрывает в target \\n, \\t, \\r и \\\\ за один проход; чтение экранирует обратную черту, поэтому прочитанное target можно отправить обратно без двойного раскрытия.',
+            '⚠️ Требуют explicit_confirmation: смена вызова оператора у вложений/ссылок/ошибок, включение PROCESS_WITH_LLM у картинки или документа (в модель уходит содержимое чужих файлов), выключение паузы после ответа оператора, выключение обезличивания и расширение списка исключённых типов PII, смена включённости и типа входящего фильтра по сделке.',
+            'crm_behavior.inbound_deal_filter — входящий фильтр по сделке GetCourse: бот отвечает только тем, у кого есть подходящая сделка (метка TAG либо значение поля CUSTOM_FIELD, для него нужен ещё field_id — ИМЯ поля). Включённый фильтр обязан быть полным, иначе отказ BEHAVIOR_SECTION_INVALID с путём inbound_deal_filter. Раздел сливается с сохранённым CRM-поведением: у канала без привязанной CRM его не записать.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_followup_sequence_upsert',
+        sideEffect: 'write',
+        requiredFields: ['platform_id', 'name', 'type', 'trigger', 'config'],
+        schema: z
+            .object({
+            platform_id: uuidSchema,
+            sequence_id: uuidSchema.optional(),
+            expected_version: z
+                .string()
+                .regex(/^[1-9][0-9]{0,9}$/u)
+                .optional()
+                .describe('expected_version — исходная editRevision открытой формы цепочки; передай её явно для защиты от перезаписи чужих изменений. Без expected_version для PATCH нужны read:workflows и write:workflows: мост читает текущую ревизию перед записью; ошибка чтения отменяет запись. Это защищает только окно между GET и PATCH, но не изменения после открытия формы и до GET. Конфликт 409 возвращается без автоматического повтора.'),
+            name: z.string(),
+            description: z.string().nullable().optional(),
+            type: followUpSequenceTypeSchema,
+            enabled: z.boolean().optional(),
+            trigger: followUpTriggerSchema,
+            config: followupSequenceConfigSchema,
+            ...platformSetupConfirmationSchema,
+        })
+            .superRefine(refineFollowUpConfig)
+            .superRefine((input, context) => {
+            if (input.trigger !== 'USER_INACTIVITY' &&
+                input.trigger !== 'LOST_CLIENTS' &&
+                (Object.hasOwn(input.config, 'assign_responsible_operator_ids') ||
+                    Object.hasOwn(input.config, 'assignResponsibleOperatorIds')))
+                context.addIssue({
+                    code: 'custom',
+                    path: ['config'],
+                    message: crmStagePoolMessage('unsupported'),
+                });
+        }),
         createRequest: (input) => ({
-            method: 'PATCH',
-            path: `/platforms/${input.platform_id}/agent-behavior`,
+            method: input.sequence_id ? 'PATCH' : 'POST',
+            path: input.sequence_id
+                ? `/channels/${input.platform_id}/followup-sequences/${input.sequence_id}`
+                : `/channels/${input.platform_id}/followup-sequences`,
+            ...(input.sequence_id && input.expected_version === undefined
+                ? {
+                    followupRevisionLookup: {
+                        path: `/channels/${input.platform_id}/followup-sequences?sequenceId=${input.sequence_id}`,
+                        sequenceId: input.sequence_id,
+                    },
+                }
+                : {}),
             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,
-                        contactNamePersonalizationMode: input.privacy.contact_name_personalization_mode,
-                        anonymizationDisabledTypes: input.privacy.anonymization_disabled_types,
-                    }
-                    : undefined,
+                name: input.name,
+                description: input.description,
+                type: input.type,
+                expectedVersion: input.expected_version,
+                enabled: input.enabled,
+                trigger: input.trigger,
+                config: input.config,
                 ...setupConfirmation(input),
             }),
         }),
+        enhanceResponse: (response) => withInstructions(response, [
+            crmStagePoolMessage('hint'),
+            ...followUpPromotionInstructions,
+            'Аудитория цепочки задаётся двумя частями: базовым фильтром config.filterMode и условиями config.sequenceConditions, которые СУЖАЮТ его через «И». Поддерживаются три режима: "variable" (базового фильтра нет, условия обязательны) и "eventType" (нужен непустой config.allowedEventTypes из значений START, IN_PROCESS, FINISH_WIN, FINISH_LOST, FAILED, OPERATOR_TAKEOVER, FINISH_AUTO). Режим "status" требует config.allowedStatuses; отсутствие режима отклоняется.',
+            'Условие пишется как {variable: "ИМЯ", op: "eq"|"neq"|"in", value}: строка для eq/neq, непустой массив строк для in. Условия соединяются только через «И». Переменная называется ИМЕНЕМ; константа, секрет и одноимённые переменные разных уровней отклоняются.',
+            '⚠️ Цепочки НЕ исключают друг друга: у каждой свой прогресс. Набор обязан быть строгим разбиением — «= A», «= B» и подстраховка «≠ A И ≠ B». Безусловная цепочка рядом с точными не подстраховывает, а УДВАИВАЕТ отправку тем, у кого значение есть. У контакта без значения eq/in ложны, neq истинно — именно поэтому подстраховка пишется отрицаниями, а не пустым набором условий.',
+            'config.stopOnPayment: true — выключать дожимы у оплатившего: при зачёте оплаты человеку ставится «дожимы выключены навсегда» на каналах, где такая цепочка включена (все его карточки в школе GetCourse и канал, из которого пришёл оплаченный заказ). Только true/false; читается у цепочки бездействия (USER_INACTIVITY), у «пропавших клиентов» не действует. Оператор может включить дожимы обратно — это держится до следующего зачёта оплаты (ночной разбор засчитывает оплату через часы после неё).',
+            'Календарная цепочка: у КАЖДОГО шага scheduleMode="clock", anchorMode="variable" и anchorVariable — имя переменной карточки с датой (ГГГГ-ММ-ДД или ДД.ММ.ГГГГ, можно со временем), плюс atTime (ЧЧ:ММ) и dayOffset (от −7 до 30 дней от даты). Такая цепочка запускается датой в карточке и перепиской на канале — в том числе у того, кто только получил наше первое сообщение; ответ клиента её не прерывает; касание сдвигается вместе с датой; опоздавшее дольше validityMinutes (по умолчанию 45) касание пропускается. Варианты одного момента — подряд идущие шаги с одинаковым slotGroup: уходит первый, чьи conditions выполнены. Некалендарный шаг в такой цепочке и finalAction отвергаются; skipIfContactRepliedSincePreviousSlot пропускает касание после ответа на предыдущий отличный момент.',
+            'config.contactVariablesOnSend — записка после успешной отправки: объект из 1–10 пар «имя переменной контакта этого канала → непустой текст до 500 кодовых единиц». Подготовь переменную контакта на канале цепочки и одноимённую константу канала рассылки: при холодной отправке значение контакта побеждает константу. Доступно цепочкам молчания и календаря, у потерянных клиентов сервер откажет. null снимает записку; отсутствие поля при полной правке тоже снимет её.',
+            'Если description или enabled не переданы, их прежнее значение сохраняется. null или пустая строка очищает описание.',
+            'Перенесённая цепочка сохраняет номер по месту исходного шага: добавление в конец даёт следующий номер, вставка или удаление сдвигает номера новых выдач. Уже выданные коды не меняются. Собственная цепочка нумерует группы действий между ожиданиями; номер назначает сервер. У пропавших клиентов номера нет.',
+            'Ответ записи может содержать warnings[] с кодом и сообщением о неготовой CRM-стадии. Это предупреждение, а не отказ; проверь состояние CRM до включения цепочки.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_followup_sequence_clone',
+        sideEffect: 'write',
+        requiredFields: ['platform_id', 'sequence_id'],
+        schema: z
+            .object({
+            platform_id: uuidSchema,
+            // Источник копирования; обязан принадлежать platform_id (cross-platform не поддерживается).
+            sequence_id: uuidSchema,
+            // База имени копии. Не передана — берётся имя источника; суффикс добавляется в любом случае.
+            name: z.string().max(FOLLOWUP_CLONE_NAME_MAX_LENGTH).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/channels/${input.platform_id}/followup-sequences/${input.sequence_id}/clone`,
+            body: compactObject({ name: input.name }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Копия создана ВЫКЛЮЧЕННОЙ и такой останется, пока её не включат явно: событие «контакт затих» веерится на КАЖДУЮ включённую цепочку канала, поэтому включённая копия слала бы те же касания тем же людям вторым потоком.',
+            'Скопировано только ОПРЕДЕЛЕНИЕ (имя, описание, триггер, шаги и переменные последней версии). Прогресс контактов, история отправок и запланированные касания источника не копируются и не затрагиваются.',
+            'Перед включением копии убедись, что условия цепочек образуют строгое разбиение (например «= A» / «= B» / «≠ A И ≠ B»). Две цепочки без взаимоисключающих условий удвоят отправку — они выполняются независимо.',
+            'Копия остаётся на ТОМ ЖЕ канале. Для переноса на другой канал используй besales_platform_clone_* — определение ссылается на статусы CRM, переменные и файлы своего канала.',
+            '⚠️ Повтор вызова НЕ идемпотентен: он создаёт следующую копию (`…-copy-2`, `…-copy-3`). Переданный name — это БАЗА имени, суффикс копии добавляется всегда; свободное имя ищется среди неудалённых цепочек всего воркспейса.',
+        ]),
     }),
     ...followUpSetupTools,
     defineTool({
@@ -785,6 +335,11 @@ export const platformSetupTools = [
         requiredFields: ['platform_id'],
         schema: z
             .object({
+            expected_version: z
+                .string()
+                .min(1)
+                .regex(/^[A-Za-z0-9_.-]+$/u)
+                .optional(),
             platform_id: uuidSchema,
             // v1.5 Increment 3 Group C.3 (Phase B, 2026-05-27): только typed sections.
             crm_pipeline_behavior: pipelineCrmBehaviorSchema.optional(),
@@ -794,8 +349,9 @@ export const platformSetupTools = [
             .strict(),
         createRequest: (input) => ({
             method: 'PATCH',
-            path: `/platforms/${input.platform_id}/pipeline-settings`,
+            path: `/channels/${input.platform_id}/pipeline-settings`,
             body: compactObject({
+                expectedVersion: input.expected_version,
                 crmPipelineBehavior: input.crm_pipeline_behavior
                     ? mapPipelineCrmBehaviorInput(input.crm_pipeline_behavior)
                     : undefined,
@@ -803,88 +359,43 @@ export const platformSetupTools = [
                 ...setupConfirmation(input),
             }),
         }),
+        enhanceResponse: withEditVersionInstructions,
     }),
     defineTool({
         name: 'besales_platform_settings_update',
         sideEffect: 'write',
         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(),
-            // Настройки раздела «Воронка канала»: ворота решения, цель «Пути до стадии», пороги.
-            // Бэкенд делегирует запись сервисам раздела — их валидация не обходится.
-            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(),
-            smsgorod_settings: platformSmsgorodSettingsSchema.optional(),
-            bitrix24_bot_settings: platformBitrix24BotSettingsSchema.optional(),
-            getcourse_settings: platformGetcourseSettingsSchema.optional(),
-            ...platformSetupConfirmationSchema,
-        })
-            .strict(),
+        // Пространство выбирает ключ подключения для составной правки настроек.
+        defaultWorkspaceId: true,
+        schema: platformSettingsUpdateSchema,
         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,
-                funnelAnalytics: input.funnel_analytics
-                    ? mapPlatformFunnelAnalyticsInput(input.funnel_analytics)
-                    : 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,
+            path: `/channels/${input.platform_id}/settings`,
+            body: {
+                ...platformSettingsSections(input),
                 ...setupConfirmation(input),
-            }),
+                ...compactObject({ expectedVersion: input.expected_version }),
+            },
         }),
         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).',
+            editVersionInstruction(),
+            'general_settings обновляет имя, сообщение при выключенном ИИ, зону, включённость канала, включённость ответов агента и phone_parsing_country. От страны разбора зависит, получит ли агент инструмент сохранения телефона; UZ значит, что девятизначный номер трактуется как узбекский, RU — инструмент выдаётся без разбора девяти цифр (российский номер разбирается по своей длине, девятизначный отклоняется). null снимает настройку и инструмент.',
+            'У виджета general_settings.page_rules задаёт показ: mode ALL — везде, ALLOW — только на указанных страницах (пустой список — нигде), DENY — кроме указанных. patterns — до 200 полных адресов или масок со звёздочкой до 2000 знаков; маска раздела с /* включает сам раздел. Правило заменяется целиком, null снимает его. Проверка выполняется сервером при подключении; это правило отображения, а не защита доступа.',
+            'crm_behavior принимает create_deal_on_first_outbound, finish_auto_enabled, finish_auto_days, send_finish_auto_note_to_crm, finish_auto_note_template, getcourse_create_deal_payment_tracking_enabled и getcourse_status_deal_fallback_enabled. finish_auto_days — целое число от 1 до защитного потолка 36500; null у finish_auto_note_template снимает шаблон и на свежем канале без сохранённых crm_behavior/auto_finish.',
+            'Если crm_behavior ещё не сохранён, единственное активное CRM-подключение требуется для send_to_crm, создания сделки по первой исходящей, стратегии и фиксированного ответственного, четырёх флагов отправки заметок, трёх полей маркера сделки, четырёх шаблонов заметок и обоих GetCourse-флагов. Ноль или несколько подключений дают 422 CRM_CONNECTION_UNRESOLVED. При сохранённом crm_behavior подключение этим маршрутом повторно не проверяется.',
+            'Опасные изменения create_deal_on_first_outbound, send_finish_auto_note_to_crm и getcourse_create_deal_payment_tracking_enabled требуют explicit_confirmation. Учёт оплат заказов агента GetCourse по умолчанию включён: при отсутствующем сохранённом ключе false требует подтверждения, а true проходит как неизменное действующее значение. Включение автозавершения не требует подтверждения, опасна отправка заметки.',
+            'Настройки веб-виджета живут в general_settings, НЕ в widget_marketing: список сайтов (allowed_origins), лимит обращений в минуту (rate_limit — целое число от 1 до 600), передача адреса страницы (show_page_info) и оформление (customization с одиннадцатью разделами). В widget_marketing остаются только две карты — соответствия маркетинговых полей CRM и перенос адреса входа в переменную. Прежняя форма тоже принимается и переводится: widget_marketing.web_widget_allowed_origins / _show_page_info / _rate_limit_per_minute / _customization уходят в general_settings (пустой или незаданный прежний список сайтов — «работать везде», как у прежней версии), web_widget_marketing_field_mappings и web_widget_entry_url_variable_mapping — в две карты раздела, access_control.is_active и is_ai_enabled — в general_settings. Прежнее и новое имя одного поля в одном вызове — отказ, кроме is_active: access_control.is_active и general_settings.is_active принимаются вместе, приоритет у general_settings.is_active.',
+            'Список сайтов принимает голый домен (site.ru), домен с портом (site.ru:8443), полный адрес (https://site.ru) и «*» (работать везде). Пустой список означает «не работать нигде» — это выключение виджета, а не сброс настройки. Список ЗАМЕЩАЕТСЯ целиком, разделы оформления сливаются.',
+            'smsgorod_settings сохраняет channel (DIGIT/CHAR) и sender на SMS-канале с подключением SMS-город. bitrix24_bot_settings сохраняет bot_name и ignore_crm_stage_gate на Bitrix24 Bot; смена ignore_crm_stage_gate требует explicit_confirmation=true. bot_id/bot_code/open_line_id управляются подключением: допустимо только точное ненулевое эхо, изменение/null даёт 422 BITRIX24_BOT_IDENTITY_MANAGED. Ответ bitrix24BotSettingsApply различает сохранение и применение у провайдера; не обещай применение при отложенном/неизвестном исходе.',
+            'crm_behavior.use_cross_platform_history сохраняет канальный выбор истории между каналами одного человека, включая false. Неверный тип канала — 400 BRIDGE_SETTINGS_CHANNEL_TYPE_MISMATCH; нет подключения, неверный sender или отсутствует подтверждение — адресный 422. Отказ любой секции не означает частично сохранённый запрос.',
+            'getcourse_settings принимается на канале GetCourse и пишется слиянием: соседние настройки не трогаются. Исключение — field_variable_map: её принимает канал ЛЮБОГО типа (виджет, мессенджер), и там поля заказа школы ложатся в переменные канала по человеку, которого опознали в школе по почте или по ссылке рассылки; прочие поля раздела на канале не GetCourse пропускаются предупреждением. Домен школы, кэш отделов, шаблонные пользователь и заказ здесь не пишутся — ответ назовёт причину и правильное место. wave_field_bindings — в какие поля сделки школы status-волна сама ставит свои метки: тип запуска (OUTGOING), продукт (кодом или названием — product_value_source), сегмент, воронка, каналы (набор через «+», например VK+Telegram). У роли — field_id (номер поля сделки) и field_label; один номер поля — одна роль. Объект ЗАМЕНЯЕТ сохранённые привязки целиком (роль, не названная в запросе, снимается), null снимает все; ручное поле запуска волны в поле роли даёт отказ WAVE_DEAL_FIELD_BINDING_CONFLICT; текущие привязки — в besales_platform_context_get, channel.connection.providerConfig.wave_field_bindings. field_variable_map ЗАМЕНЯЕТ карту «поле сделки → переменная» канала целиком (null очищает): поле называется так, как в школе (регистр не важен), переменная — строковая не-константная переменная ЭТОГО канала, поле и переменная — по разу. Негодная переменная — отказ FIELD_VARIABLE_MAP_VARIABLE_INVALID с перечнем подходящих (allowedVariableNames); текущая карта — в besales_platform_context_get, channel.getcourseFieldVariableMap.',
+            'getcourse_settings.guard_active_series / guard_active_application / guard_paid — режимы ПРЕДОХРАНИТЕЛЯ холодных отправок канала (вебинарная серия, действующая заявка, оплата продукта отправки): OFF — выключено, WARN — только записывается, BLOCK — отправка останавливается; null — «не настраивали» (действует BLOCK у всех трёх правил). quiet_days — тихий период канала в сутках (0 — правила нет, null — действует тихий период пространства). Эти поля сохраняются одним PATCH вместе с остальными секциями: ошибка любой секции отменяет всю запись. Ответ — в getcourseOutboundSettings (хранимое и действующее). Ослаблять правило ради одного запуска — не здесь: у пакета «Первого сообщения» для этого есть поле guards.',
+            'funnel_analytics — настройки раздела «Воронка канала»: ворота решения (три РАЗНЫЕ стадии «отправлено → одобрено | отклонено», только целиком), цель «Пути до стадии», пороги engaged_inbound_count (2–20) и stuck_threshold_hours (1–720). Стадия — stage_id из справочника либо pipeline_crm_id (подключение из besales_crm_list) + pipeline_id и status_id (числовые или строковые коды из besales_crm_pipeline_status_list); стадия обязана быть живой и в воронке, привязанной к каналу, иначе 422 FUNNEL_ANALYTICS_STAGE_INVALID с полем и причиной. null сбрасывает к «не настраивали», отсутствие поля не трогает, пустой раздел не принимается. Проверяются только присланные поля: уже негодная стадия в нетронутом поле приходит предупреждением FUNNEL_STAGE_UNUSABLE, а не отказом. Хранимое после записи — в ответе, funnelAnalytics. Коды Bitrix24 вида C3:NEW передавай строкой из справочника; числовая форма отгруженного клиента тоже принимается.',
+            'Тихий режим бота и создание отсутствующего заказа требуют explicit_confirmation (отказ приходит как EXPLICIT_CONFIRMATION_REQUIRED).',
+            'getcourse_settings.open_invoice_silence_enabled и четыре соседних поля (open_invoice_table_id, open_invoice_product_column, open_invoice_topic_column, open_invoice_topic_variable) настраивают молчание бота при подходящем открытом платном счёте за последние 14 суток по московской дате. Для включения все четыре поля должны быть сохранены; передача любого из пяти требует explicit_confirmation=true. Таблица знаний должна принадлежать рабочей области; колонка продукта содержит номера продуктов GetCourse, на которые ссылаются предложения открытого счёта, колонка темы — тему, переменная темы — строковая переменная контакта. Если данные школы, предложение или таблица неизвестны, бот отвечает; задержка кэша после оплаты возможна до 45 секунд. Используй серверные подписи причины на языке канала (ru/en/es/id/uz), не показывай внутренний код.',
+            'Деньги GetCourse (revenue_offer_ids, revenue_offers_paid_since) тоже требуют explicit_confirmation. Порядок: сначала дата у ЭТОГО канала (раньше или тем же вызовом), затем набор; снять дату можно только вместе с пустым набором. Предупреждение SECTION_ISSUE:getcourseSettings:revenue_offers_paid_since в ответе значит: у канала хранится набор без даты — задай дату. У канала виджета из денежных полей принимаются только revenue_offer_ids и revenue_offers_paid_since; карта field_variable_map принимается тоже. Денежные поля — метка продажи: совпавшее предложение разрешает автозачёт, а общий арбитр по заказам агента и рассылкам выбирает «Входящие» или «Исходящие»; прочие поля раздела пропускаются предупреждением. Порядок тот же, метка работает только при одной школе GetCourse в рабочей области (иначе WIDGET_SALE_LABEL_NEEDS_SINGLE_SCHOOL), предупреждение о метке без даты — SECTION_ISSUE:getcourseSettings:sale_label_paid_since.',
+            'target_department_id работает только при включённом входящем фильтре по сделке: без него перенос диалога в отдел молча не сработает. Фильтр задаётся здесь полями crm_behavior.inbound_deal_filter_enabled / _type / _value / _field_id (включённость и тип требуют explicit_confirmation, включённый фильтр обязан быть полным) либо разделом crm_behavior.inbound_deal_filter инструмента besales_behavior_update.',
+            'Response.warnings[] называет пропущенный раздел: widgetMarketing и instagramCommentBehavior — на неподходящем типе канала, generalSettings.widget — когда настройки виджета присланы каналу, который виджетом не является.',
         ]),
     }),
     defineTool({
@@ -900,13 +411,17 @@ export const platformSetupTools = [
             // где audit logs пишутся с platformId=null).
             platform_id: uuidSchema.optional(),
             audit_log_id: uuidSchema,
+            explicit_confirmation: z.boolean().optional(),
         })
             .strict(),
         createRequest: (input) => {
             if (input.platform_id) {
                 return {
                     method: 'POST',
-                    path: `/platforms/${input.platform_id}/audit/${input.audit_log_id}/revert`,
+                    path: `/channels/${input.platform_id}/audit/${input.audit_log_id}/revert`,
+                    ...(input.explicit_confirmation === undefined
+                        ? {}
+                        : { body: { explicitConfirmation: input.explicit_confirmation } }),
                 };
             }
             return {
@@ -915,19 +430,26 @@ export const platformSetupTools = [
             };
         },
         enhanceResponse: (response) => withInstructions(response, [
+            'Откат опасных настроек, в том числе откат клона, требует отдельного согласия человека и explicit_confirmation=true; без него сервер возвращает EXPLICIT_CONFIRMATION_REQUIRED. Безопасный откат подтверждения не требует.',
             'Передай `platform_id` для platform-scoped logs (audit через platform-setup-adapter).',
             'Опусти `platform_id` для workspace-scoped logs (variables-adapter и аналоги).',
+            'Откат удаления переменной возвращает и собранные значения контактов. Ответ несёт `variableValues: { backedUp, restored }`: если `restored` меньше `backedUp`, разницу составляют люди, стёртые между удалением и откатом — их значения не вернёт ничто. Скажи об этом человеку числом, а не словом «успешно».',
         ]),
     }),
     defineTool({
         name: 'besales_feedback_sheet_link',
         sideEffect: 'write',
+        resultPolicy: {
+            neverTruncate: true,
+            narrowingHint: 'Выбери документ с меньшим числом связей; для текущего документа перечитай полный список через besales_feedback_document_access_get.',
+        },
         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'),
+            access_mode: z.enum(['READ_ONLY', 'EDITABLE']).optional(),
             agent_version_id: uuidSchema.optional(),
+            ...feedbackDocumentConfirmationSchema,
         }),
         createRequest: (input) => ({
             path: `/agents/${input.agent_id}/feedback-sheets`,
@@ -935,12 +457,16 @@ export const platformSetupTools = [
                 sourceUrl: input.source_url,
                 accessMode: input.access_mode,
                 agentVersionId: input.agent_version_id,
+                confirmDocumentAccessChange: input.confirm_document_access_change,
+                expectedDocumentSnapshot: input.expected_document_snapshot,
             }),
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Таблица привязана к промпту. Расшарьте её на service account из поля serviceAccountEmail (Viewer для READ_ONLY, Editor для EDITABLE).',
+            'Таблица привязана к промпту. Email для настройки доступа в Google приходит в serviceAccountEmail.',
             'Прочитайте замечания через besales_feedback_sheet_read по feedbackSheet.id.',
-            'accessMode определяет режим: READ_ONLY — только предлагаете правки промпта; EDITABLE — дополнительно отмечаете статусы строк (Phase 2).',
+            'accessMode — намерение всего документа, независимое от прав Google. Без access_mode новая связь наследует текущий режим; новый документ начинает с READ_ONLY.',
+            'Перед сменой режима прочитайте besales_feedback_document_access_get, покажите все связи и получите согласие человека; передайте confirm_document_access_change=true и expected_document_snapshot.',
+            'Повторная привязка возвращает 409 с currentLink. Сохраните прежнюю связь и её версию; не делайте автоматические unlink/link.',
         ]),
     }),
     defineTool({
@@ -1024,7 +550,7 @@ export const platformSetupTools = [
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
-            namespace_record_id: uuidSchema.optional(),
+            namespace_record_id: knowledgeSpaceIdSchema.optional(),
         }),
         createRequest: (input) => ({
             path: `/agents/${input.agent_id}/facts/classify-and-migrate`,
@@ -1033,8 +559,8 @@ export const platformSetupTools = [
             }),
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Active facts разобраны: Q&A pairs созданы через QaService, document chunks отмечены как pending.',
-            'Мигрированные chunks перемещены в секцию `## Migrated` в AgentChat.factualContext (audit trail).',
+            'Active facts разобраны: Q&A pairs созданы в knowledge-пространстве, document chunks перенесены отдельными документами.',
+            'Мигрированные chunks перемещены в секцию `## Migrated` в факты агента (audit trail).',
             'Если категория `document` — text→document loader pending, повторно вызовы безопасны (idempotent per chunk).',
         ]),
     }),
@@ -1044,15 +570,20 @@ export const platformSetupTools = [
         sideEffect: 'write',
         requiredFields: ['agent_id', 'factual_context'],
         schema: z.object({
+            expected_version: uuidSchema.optional(),
             agent_id: uuidSchema,
             factual_context: z.string(),
         }),
         createRequest: (input) => ({
             method: 'PUT',
             path: `/agents/${input.agent_id}/facts`,
-            body: { factualContext: input.factual_context },
+            body: compactObject({
+                factualContext: input.factual_context,
+                expectedVersion: input.expected_version,
+            }),
         }),
         enhanceResponse: (response) => withInstructions(response, [
+            editVersionInstruction(),
             'factualContext записан целиком (PUT-семантика, replace not patch).',
             'Если в warnings есть `soft_limit_exceeded` (~8000 chars / 2K tokens) — рекомендую запустить `besales_facts_classify_and_migrate`.',
             'Структура: `## Active facts` блок инъектится в системный промпт; `## Migrated` — лог миграций (не инъектится).',
@@ -1069,18 +600,33 @@ export const platformSetupTools = [
         // текст здесь незаменим: по нему строят якоря правок, и усечённый даёт промах якоря.
         resultPolicy: { neverTruncate: true, maxResultBytes: 400_000 },
         sideEffect: 'write',
+        closedWorld: true,
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
+            include_prompt_text: z.boolean().optional(),
+            mode: z.enum(['START', 'CONTINUE', 'RESTART']).optional(),
+            draft_id: uuidSchema.optional(),
+            expected_content_hash: z
+                .string()
+                .regex(/^[a-f0-9]{64}$/)
+                .optional(),
         }),
         createRequest: (input) => ({
             method: 'POST',
             path: `/agents/${input.agent_id}/prompt/drafts`,
+            body: compactObject({
+                mode: input.mode,
+                draftId: input.draft_id,
+                expectedContentHash: input.expected_content_hash,
+            }),
         }),
-        enhanceResponse: (response) => withInstructions(response, [
-            'PromptDraft создан. ID в `draft.id`. TTL 24h, resets на каждом `_apply`.',
+        enhanceResponse: (response, input) => withInstructions(input.include_prompt_text === true ? response : withoutDraftPromptText(response), [
+            'Текст промпта по умолчанию НЕ возвращается: приходят отпечаток и длина. Нужен сам текст — ' +
+                'besales_prompt_patch_get либо include_prompt_text=true. Без текста не построить якоря правок.',
+            'При CREATED создан новый черновик; при CONTINUED возвращён выбранный свой черновик. При PROMPT_DRAFT_CHOICE_REQUIRED прочитай besales_prompt_drafts_mine и попроси человека выбрать CONTINUE или RESTART с draft_id и expected_content_hash.',
             'Дальше: `besales_prompt_patch_apply(draft_id, operations[])` → batch правок → `besales_prompt_patch_commit(draft_id)`.',
-            'Если `conflictsWithOtherUsers` непустой — другой пользователь редактирует тот же агент. Не блокирует, но warning.',
+            'conflictingDraftCount — число черновиков других авторов. Их идентификаторы и сроки не выдаются; conflictsWithOtherUsers всегда пустой.',
             'Server-side hash → клиенту не нужно знать про activePromptContentHash.',
             'Гигиена: правь формулировки ПО МЕСТУ в существующих секциях; не добавляй override-блоки/дубли-секции в конец (антипаттерн → тех-долг). Сначала прочти весь промпт (besales_prompt_patch_get) и найди, где правило уже есть. См. «Редактирование промпта» в serverInstructions.',
         ]),
@@ -1092,6 +638,7 @@ export const platformSetupTools = [
         // текст здесь незаменим: по нему строят якоря правок, и усечённый даёт промах якоря.
         resultPolicy: { neverTruncate: true, maxResultBytes: 400_000 },
         sideEffect: 'none',
+        closedWorld: true,
         requiredFields: ['agent_id', 'draft_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -1103,10 +650,11 @@ export const platformSetupTools = [
         }),
     }),
     // Остаток до лимитов линтера ДО сборки черновика. Порядок здесь обязан совпадать с
-    // mcp-tools.json (registry.spec проверяет parity), поэтому вставка строго после _patch_get.
+    // mcp-tools.json (registry.spec сверяет имена позиционно), поэтому вставка строго после _patch_get.
     defineTool({
         name: 'besales_prompt_headroom',
         sideEffect: 'none',
+        closedWorld: true,
         requiredFields: ['agent_id'],
         // .strict() — иначе опечатка `draftId` вместо `draft_id` молча отбрасывается zod'ом,
         // и тулза измеряет закоммиченный промпт вместо черновика.
@@ -1143,7 +691,10 @@ export const platformSetupTools = [
         createRequest: (input) => ({
             method: 'POST',
             path: `/agents/${input.agent_id}/prompt/diff`,
-            body: { compareAgentId: input.compare_agent_id, maxLines: input.max_lines },
+            body: {
+                compareAgentId: input.compare_agent_id,
+                maxLines: input.max_lines,
+            },
         }),
         enhanceResponse: (response) => withInstructions(response, [
             '`identicalBytes: true` — текущие тексты совпадают побайтово, значит один и тот же набор patch-операций найдёт те же якоря. Это НЕ гарантия одинакового исхода commit: lint резолвит канал каждого агента отдельно (одна и та же markdown-правка проходит в веб-виджете и падает в Telegram), а свой черновик каждый агент коммитит независимо.',
@@ -1159,11 +710,13 @@ export const platformSetupTools = [
         // текст здесь незаменим: по нему строят якоря правок, и усечённый даёт промах якоря.
         resultPolicy: { neverTruncate: true, maxResultBytes: 400_000 },
         sideEffect: 'write',
+        closedWorld: true,
         requiredFields: ['agent_id', 'draft_id', 'operations'],
         schema: z.object({
             agent_id: uuidSchema,
             draft_id: uuidSchema,
             operations: z.array(promptPatchOperationSchema).min(1),
+            include_prompt_text: z.boolean().optional(),
         }),
         createRequest: (input) => ({
             method: 'PATCH',
@@ -1172,12 +725,12 @@ export const platformSetupTools = [
                 operations: input.operations.map(mapPromptPatchOperationInput),
             },
         }),
-        enhanceResponse: (response) => withInstructions(response, [
+        enhanceResponse: (response, input) => withInstructions(input.include_prompt_text === true ? response : withoutDraftPromptText(response), [
+            'Текст промпта по умолчанию НЕ возвращается: приходят отпечаток и длина. Изменился ли текст — ' +
+                'видно по отпечатку; нужен сам текст для следующих якорей — include_prompt_text=true или ' +
+                'besales_prompt_patch_get.',
             '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)`.',
         ]),
@@ -1194,9 +747,10 @@ export const platformSetupTools = [
             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 обновлён.',
-            'В ответе только адресация версии (`newVersion.id`, `newVersion.version`) и метаданные черновика — текст промпта не дублируется.',
+        enhanceResponse: (response) => withInstructions(withoutDuplicatedPromptText(response), [
+            'Текст промпта приходил здесь ДВАЖДЫ — в черновике и в новой версии. Копия из черновика ' +
+                'заменена отпечатком; авторитетна версия (newVersion.content) — именно она уехала агенту.',
+            'Commit: lint pass → новая PromptVersion в prompt-services → системный промпт агента обновлён.',
             'Если ошибка 400 с `lintIssues` — поправь через `_apply` (hard_fail issues блокируют commit).',
             'Если ошибка 409 PROMPT_DRAFT_REBASE_REQUIRED — другой commit прошёл первым. Discard этот draft и сделай новый.',
             'Server-side hash → клиенту не нужно передавать activePromptContentHash.',
@@ -1208,6 +762,7 @@ export const platformSetupTools = [
     defineTool({
         name: 'besales_prompt_patch_discard',
         sideEffect: 'write',
+        closedWorld: true,
         requiredFields: ['agent_id', 'draft_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -1223,6 +778,9 @@ export const platformSetupTools = [
     defineTool({
         name: 'besales_prompt_batch_start',
         sideEffect: 'spend',
+        // Жёсткий гейт: правка уезжает разом на парк до 200 боевых агентов, у очереди одна
+        // попытка и авто-отката нет. Аннотация тут не помогает — она подсказка, которой хост
+        // вправе не поверить, а это условие входа, которое обойти нельзя.
         requiredFields: ['agent_ids', 'operations', 'explicit_confirmation'],
         schema: z
             .object({
@@ -1242,19 +800,21 @@ export const platformSetupTools = [
                 operations: input.operations.map(mapPromptPatchOperationInput),
                 allOrNothing: input.all_or_nothing,
                 idempotencyKey: input.idempotency_key,
-                platformId: input.platform_id,
+                channelId: input.platform_id,
             }),
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Прогон фоновый: опрашивай `besales_prompt_batch_status` по `runId`, пока `counts.PENDING` и `counts.PREPARED` не станут нулями.',
+            'Прогон фоновый: опрашивай `besales_prompt_batch_status` по `runId` до конечного состояния; STOPPED может сохранять не начатых агентов.',
             '`SKIPPED` — не ошибка: смотри `skipReason`, чаще всего это NO_OPERATIONS_APPLIED (у агента другой промпт, якоря не нашлись).',
-            'Упавших агентов докатывай `besales_prompt_batch_resume` — повторный `_start` создаст ВТОРОЙ прогон и применит операции ещё раз.',
+            'После потери ответа читай `besales_prompt_batch_by_key` с исходным idempotency_key. Повтор start с тем же ключом и составом возвращает тот же прогон; другой состав — 409. Новый ключ рискует второй раскаткой.',
+            'Для остановки после текущего агента используй `besales_prompt_batch_stop`, для продолжения оставшихся — `besales_prompt_batch_resume`.',
             'Перед раскаткой на парк проверь запас длины у самого тяжёлого агента через `besales_prompt_headroom`.',
         ]),
     }),
     defineTool({
         name: 'besales_prompt_batch_status',
         sideEffect: 'none',
+        resultPolicy: { neverTruncate: true, maxResultBytes: 400_000 },
         requiredFields: ['run_id'],
         schema: z.object({ run_id: uuidSchema }).strict(),
         createRequest: (input) => ({
@@ -1272,8 +832,9 @@ export const platformSetupTools = [
             path: `/prompt-batch/runs/${input.run_id}/resume`,
         }),
         enhanceResponse: (response) => withInstructions(response, [
-            'Докатываются только FAILED-агенты. Уже закоммиченные не трогаются — повторное применение операций удвоило бы вставки.',
+            'Продолжаются оставшиеся и сброшенные барьером агенты вместе с отказавшими, в том числе откатанные подготовкой allOrNothing. Уже записанные не повторяются.',
             '400 «Run is still in progress» означает, что прогон жив: дождись, а не повторяй resume.',
+            '409 — исход прежней операции не установлен: перечитай статус и не запускай новый прогон; 404 — прогон недоступен, 503 — управление или проверка секретов недоступны.',
         ]),
     }),
     // S2.6 extra — besales_prompt_lint (после patches, чтобы matched catalog order)
@@ -1315,7 +876,7 @@ export const platformSetupTools = [
         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 активны).',
+            'Если передан `agent_id` — channel и agentScope резолвятся из агента (markdown-checker и scope-consistency активны).',
         ]),
     }),
 ];