@besales/mcp 0.48.0 → 1.0.0-beta.4

package/dist/tools/definitions/trigger-upsert.tool.js

@@ -0,0 +1,159 @@
+import { SILENCE_AXES_HINT } from './v15-port-descriptions.js';
+import { legacyTriggerRepeatFields, legacyTriggerRepeatIssues, legacyTriggerRepeatValue } from './legacy-trigger-repeat.js';
+import { z } from 'zod';
+import { triggerActionArgumentSchema } from './trigger-argument.schema.js';
+import { withProjectedTriggerEcho } from './trigger-echo-projection.js';
+import { crmStagePoolMessage } from './crm-stage-pool.messages.js';
+import { triggerSetupActionItemSchema } from './trigger-action-item.schema.js';
+import { anyObjectSchema, compactObject, defineTool, platformSetupConfirmationSchema, setupConfirmation, triggerScopeSchema, uuidSchema, withInstructions, } from './shared.js';
+/**
+ * Потолки названия и условия триггера зеркалят сервер: знак с эмодзи считается одной кодовой точкой.
+ */
+const TRIGGER_NAME_MAX_CODE_POINTS = 100;
+const TRIGGER_CONDITION_MAX_CODE_POINTS = 4000;
+export const eventTriggerDescription = 'Для автоматического запуска по событию передай trigger вместо scope и строкового condition верхнего уровня. ' +
+    'NEW_CONVERSATION — начало новой переписки; CONTACT_MESSAGE — сообщение клиента; ' +
+    'OPERATOR_REPLY — ответ живого оператора; AGENT_REPLY — после ответа бота клиенту, пустой или молчаливый ход события не даёт. ' +
+    'Шаги событийного триггера статичные: без arguments, {{args.*}} и полей «заполняет ИИ» — автозапуск не получает значений ИИ. ' +
+    'Для шагов с оператором или отправкой требуется explicit_confirmation=true. ' +
+    'Горизонт allow_repeat_in_conversation — ПЕРЕПИСКА. ' +
+    'В trigger.condition можно использовать conversation.lastActionFailureCode, если сервер его знает.';
+// Проверяем конверт группы; операторы, пути и вложенные правила разбирает ядро сервера.
+const eventConditionSchema = z.strictObject({
+    schema_version: z.literal(1, { error: 'Версия trigger.condition.schema_version должна быть 1' }),
+    combinator: z.enum(['AND', 'OR'], { error: 'Укажи trigger.condition.combinator: AND или OR' }),
+    rules: z.array(z.object({}, { error: 'Правило или вложенная группа trigger.condition.rules должны быть объектом' }).passthrough(), {
+        error: 'trigger.condition.rules должен быть массивом объектов правил или вложенных групп',
+    }),
+    preset: z.string({ error: 'trigger.condition.preset должен быть строкой' }).optional(),
+}, { error: 'trigger.condition должен быть группой условий: schema_version, combinator, rules и необязательный preset' });
+const eventTriggerSchema = z.strictObject({
+    event: z.enum(['NEW_CONVERSATION', 'CONTACT_MESSAGE', 'OPERATOR_REPLY', 'AGENT_REPLY'], {
+        error: 'Укажи событие trigger.event: NEW_CONVERSATION, CONTACT_MESSAGE, OPERATOR_REPLY или AGENT_REPLY',
+    }),
+    condition: eventConditionSchema.optional(),
+}, { error: 'trigger должен быть объектом только с event и необязательным condition' })
+    .describe(eventTriggerDescription);
+function triggerTextSchema(maxCodePoints) {
+    return z
+        .string()
+        .trim()
+        .min(1)
+        .refine((value) => [...value].length <= maxCodePoints, {
+        message: `не длиннее ${maxCodePoints} знаков`,
+    });
+}
+export const triggerUpsertTool = 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(),
+        trigger: eventTriggerSchema.optional(),
+        // `.trim()` — как у сервера: строка из пробелов пустая, «Оплата » равна «Оплата». Потолок — в кодовых точках,
+        // как его считают сервер и `maxLength` схемы инструмента; `.max` zod считал бы кодовые единицы UTF-16.
+        name: triggerTextSchema(TRIGGER_NAME_MAX_CODE_POINTS).optional(),
+        condition: triggerTextSchema(TRIGGER_CONDITION_MAX_CODE_POINTS).optional(),
+        is_enabled: z.boolean().optional(),
+        priority: z.number().int().min(1).max(100).optional(),
+        stop_propagation: z.boolean().optional(),
+        instagram_comment_kind: z.literal('COMPLAINT').nullable().optional(),
+        /**
+         * Разрешить действию срабатывать в одной переписке повторно.
+         * Выключено (умолчание) — триггер отрабатывает в диалоге один раз; включи там, где
+         * повтор законен («пришли фото», «отправь прайс», «найди товар»).
+         * Защита от зацикливания внутри одного ответа модели этой настройкой НЕ управляется.
+         */
+        allow_repeat_in_conversation: z.boolean().optional(),
+        ...legacyTriggerRepeatFields,
+        arguments: z.array(triggerActionArgumentSchema).max(20).optional(),
+        scope: triggerScopeSchema,
+        metadata: anyObjectSchema.optional(),
+        actions: z.array(triggerSetupActionItemSchema).optional(),
+        replace_actions: z.boolean().optional(),
+        ...platformSetupConfirmationSchema,
+    }).superRefine(legacyTriggerRepeatIssues).superRefine((input, context) => {
+        if (input.trigger === undefined)
+            return;
+        for (const field of ['scope', 'condition']) {
+            if (input[field] !== undefined)
+                context.addIssue({
+                    code: 'custom',
+                    path: [field],
+                    message: `Событийный trigger несовместим с ${field} верхнего уровня; условие события передай в trigger.condition`,
+                });
+        }
+    }),
+    createRequest: (input) => ({
+        method: input.trigger_id ? 'PATCH' : 'POST',
+        path: input.trigger_id
+            ? `/channels/${input.platform_id}/agents/${input.agent_id}/triggers/${input.trigger_id}`
+            : `/channels/${input.platform_id}/agents/${input.agent_id}/triggers`,
+        body: compactObject({
+            trigger: input.trigger,
+            name: input.name,
+            condition: input.condition,
+            isEnabled: input.is_enabled,
+            priority: input.priority,
+            stopPropagation: input.stop_propagation,
+            instagramCommentKind: input.instagram_comment_kind,
+            allowRepeatInConversation: legacyTriggerRepeatValue(input),
+            arguments: input.arguments,
+            scope: input.scope,
+            metadata: input.metadata,
+            actions: input.actions,
+            replaceActions: input.replace_actions,
+            ...setupConfirmation(input),
+        }),
+    }),
+    enhanceResponse: (response, input) => withInstructions(withProjectedTriggerEcho(response), [
+        ...(input.trigger === undefined ? [] : [eventTriggerDescription]),
+        'В ответе вместо самих шагов и условий — их количество (actionsCount / activationsCount): ' +
+            'эхо целиком повторяло отправленное и уносило контекст на каждой правке. ' +
+            'Нужен текущий состав — besales_platform_context_get.',
+        'replace_actions=true заменяет ВЕСЬ набор действий триггера (delete-and-recreate, как в UI) — ' +
+            'сперва прочитай текущие действия (besales_platform_context_get) и передай ПОЛНЫЙ желаемый набор, ' +
+            'а не дельту, иначе потеряешь не переданные действия.',
+        SILENCE_AXES_HINT,
+        'Без replace_actions передача actions на существующем триггере отклоняется (защита от случайной потери).',
+        crmStagePoolMessage('hint'),
+        'Аргументы объявляются в arguments; маркер в поддерживаемом поле шага — {{args.<ключ>}}. Ключ можно задать самому латиницей: аргумент и шаг сохраняются одним вызовом; иначе выведенный ключ вернётся в ответе. Отсутствие arguments сохраняет прежние, пустой массив снимает все аргументы, null недопустим.',
+        // Горизонт называется вслух и в подсказке, а не только в схеме: ассистент, читающий
+        // ТОЛЬКО ответ инструмента, схемы поля уже не видит — а перепутанный горизонт и стоил
+        // инциденту трёх заметок в CRM у одного лида.
+        ...(input.allow_repeated_calls !== undefined || input.run_once_per_contact !== undefined
+            ? ['Горизонт изменён: прежние флаги переведены в повтор в переписке; после её закрытия право возвращается.'] : []),
+        'Горизонт allow_repeat_in_conversation — ПЕРЕПИСКА, а не контакт: при выключенной ' +
+            'настройке действие срабатывает в диалоге один раз, но после авто-завершения диалога ' +
+            'право возвращается и на новом обращении действие сработает снова. ' +
+            'Повтор внутри одного ответа модели подавляется всегда и настройкой не управляется.',
+        // Правило API называется и здесь: иначе ассистент узнаёт о нём только по отказу 422.
+        'Включённое действие, сохраняющее почту, названную клиентом (шаг SAVE_CONTACT_INFO с полем email ровно ' +
+            '{{slots.email}}), требует allow_repeat_in_conversation=true — иначе API отклонит запись: первая ' +
+            'попытка заняла бы право до закрытия переписки, и исправленный после опечатки адрес сохранить было бы ' +
+            'нельзя. В карточку ложится только адрес, который клиент сам написал в этой переписке.',
+        'Действию, записывающему значение из переписки (поле CRM без шаблона — input_type ai_text или ' +
+            'ai_dropdown; заметка с input_type=ai_text; переменная с value_source=MODEL; поле школы из ai_fields, ' +
+            'у выбора — с вариантами options), повтор рекомендован: частичное извлечение занимает право, и ' +
+            'названное клиентом позже без allow_repeat_in_conversation=true не запишется. Это не требование — ' +
+            'API такое действие сохраняет и без повтора (если значений в разговоре нет вовсе, право не тратится); ' +
+            'однократность уместна, когда её выбирает владелец. Значения аргументами не передаются — их достаёт ' +
+            'из переписки отдельный ход извлечения.',
+        // Порядок денежных шагов — тоже правило записи API: без подсказки ассистент узнаёт о нём по отказу 422.
+        'Денежные шаги GetCourse: GETCOURSE_CREATE_DEAL по предложению обязан стоять РАНЬШЕ первой ' +
+            'GETCOURSE_SEND_PAYMENT_LINK в режиме OFFER с тем же offer_id — иначе API отклонит запись кодом 422 ' +
+            'TRIGGER_GETCOURSE_PAYMENT_LINK_BEFORE_ORDER (field — адрес шага ссылки, offerId — предложение): ' +
+            'ссылка, стоящая первой, создала бы свой платный заказ, а следом создание — второй. Переставь шаги, ' +
+            'а не удаляй их. Установка навыка с таким шаблоном отклоняется тем же кодом.',
+        // Правило гейта продукта называется здесь, а не только отказом шага: иначе ассистент узнаёт о нём
+        // по первому невыставленному счёту живому клиенту.
+        'Ссылка на оплату GetCourse (шаг GETCOURSE_SEND_PAYMENT_LINK) сверяет программу счёта с разговором: ' +
+            'программу, названную в переписке ассистентом или клиентом, сервер сравнивает с продуктом школы и ' +
+            'счёт не выставляет, если программа не названа, не совпала или сверить нечем. Действие со ссылкой ' +
+            'вызывает модель: запуск по условию или сценарием всегда получает «сверить нечем».',
+        'У шага создания заказа GetCourse настройка getcourseCreateDealConfig.reuse_open_invoice=true разрешает взять уже открытый платный счёт человека в той же школе, только если продукт счёта совпадает с одним из продуктов предложения шага. Это успешный шаг с reusedOpenInvoice=true, но нового заказа и новой денежной регистрации нет; Срок давности счёта: по умолчанию не старше 14 суток; open_invoice_age=ANY_AGE — без срока, WITHIN_MAX_AGE — 14 суток. Отсутствующий ключ получает 14 суток, в том числе у перенесённых шагов; ключ умолчания при сохранении удаляется. Количество открытых счетов считается в пределах выбранного срока. ru/en/es/id/uz используют подпись поля и двух вариантов на языке пользователя.',
+    ]),
+});
+//# sourceMappingURL=trigger-upsert.tool.js.map

package/dist/tools/definitions/trigger-upsert.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-upsert.tool.js","sourceRoot":"","sources":["../../../src/tools/definitions/trigger-upsert.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/definitions/v15-port-descriptions.d.ts

@@ -0,0 +1,11 @@
+export declare const SCHEDULE_GUARD_HINT = "\u041F\u0440\u0435\u0434\u043E\u0445\u0440\u0430\u043D\u0438\u0442\u0435\u043B\u044C \u043F\u0440\u043E\u0432\u0435\u0440\u044F\u0435\u0442 \u043A\u0430\u043D\u0434\u0438\u0434\u0430\u0442\u043E\u0432 \u0442\u043E\u043B\u044C\u043A\u043E \u0434\u043E \u043D\u0430\u0431\u043E\u0440\u0430 dailyCap; overCap \u0438\u043C \u043D\u0435 \u043F\u0440\u043E\u0432\u0435\u0440\u0435\u043D. snapshot.guard_unchecked \u2014 \u0441\u043A\u043E\u043B\u044C\u043A\u043E \u043E\u0442\u043E\u0431\u0440\u0430\u043D\u043D\u044B\u0445 \u043E\u0441\u0442\u0430\u043B\u043E\u0441\u044C \u043D\u0435\u043F\u0440\u043E\u0432\u0435\u0440\u0435\u043D\u043D\u044B\u043C\u0438 (count) \u0438 \u043F\u043E\u0447\u0435\u043C\u0443 (cause): \u0441\u0431\u043E\u0439 \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u0430 \u0438\u043B\u0438 \u0438\u0441\u0447\u0435\u0440\u043F\u0430\u043D\u0438\u0435 \u0432\u0440\u0435\u043C\u0435\u043D\u0438. \u0414\u043E\u0441\u0442\u0430\u0432\u043A\u0430 \u043F\u0440\u043E\u0432\u0435\u0440\u0438\u0442 \u0438\u0445 \u0441\u043D\u043E\u0432\u0430. \u0410\u0443\u0434\u0438\u0442 \u043E\u0442\u0431\u043E\u0440\u0430 \u0438\u0449\u0438 \u043F\u043E stage=SCHEDULE_SELECTION \u0438 scheduleRunId.";
+export declare const SCHEDULE_BLOCKS_HINT = "\u041F\u0430\u043A\u0435\u0442 \u0440\u0430\u0441\u043F\u0438\u0441\u0430\u043D\u0438\u044F \u043D\u0435 \u043E\u0433\u0440\u0430\u043D\u0438\u0447\u0435\u043D \u0447\u0438\u0441\u043B\u043E\u043C \u0431\u043B\u043E\u043A\u043E\u0432 \u00AB\u043F\u0440\u043E\u0434\u0443\u043A\u0442 \u00D7 \u0432\u043E\u0440\u043E\u043D\u043A\u0430\u00BB. \u0421\u043D\u044F\u0442\u0438\u0435 \u0411\u041B\u041E\u041A\u0410 \u043F\u043B\u0430\u043D\u043E\u043C \u0438\u0437-\u0437\u0430 \u043F\u0435\u0440\u0435\u043C\u0435\u043D\u043D\u044B\u0445: excludedBy.blockPlaceholdersUnresolved, \u0438\u0441\u0445\u043E\u0434 SKIPPED_UNRESOLVED_VARS \u0438 \u043F\u0430\u0443\u0437\u0430 6 \u0447\u0430\u0441\u043E\u0432 (\u043F\u0440\u0438 \u043E\u0442\u043F\u0440\u0430\u0432\u043A\u0435 \u043E\u0442\u0434\u0435\u043B\u044C\u043D\u043E\u043C\u0443 \u0447\u0435\u043B\u043E\u0432\u0435\u043A\u0443 \u043F\u0430\u0443\u0437\u0430 \u0441\u0443\u0442\u043A\u0438); \u0438\u043C\u0435\u043D\u0430 \u043F\u0435\u0440\u0435\u043C\u0435\u043D\u043D\u044B\u0445 \u2014 \u0432 \u043F\u0440\u0438\u0447\u0438\u043D\u0435 \u0441\u0442\u0440\u043E\u043A \u0436\u0443\u0440\u043D\u0430\u043B\u0430. \u041F\u043E\u0441\u043B\u0435 \u043F\u0430\u0443\u0437\u044B \u043B\u044E\u0434\u0438 \u0432\u043E\u0437\u0432\u0440\u0430\u0449\u0430\u044E\u0442\u0441\u044F \u043A \u0441\u043B\u0435\u0434\u0443\u044E\u0449\u0435\u043C\u0443 \u0437\u0430\u043F\u0443\u0441\u043A\u0443, \u043D\u043E \u0431\u0435\u0437 \u0438\u0441\u043F\u0440\u0430\u0432\u043B\u0435\u043D\u0438\u044F \u043F\u0435\u0440\u0435\u043C\u0435\u043D\u043D\u044B\u0445 \u0438\u043B\u0438 \u043F\u0435\u0440\u0435\u043A\u0440\u044B\u0442\u0438\u0439 \u0430\u0433\u0435\u043D\u0442\u0430 \u0431\u043B\u043E\u043A \u0441\u043D\u0438\u043C\u0430\u0435\u0442\u0441\u044F \u0441\u043D\u043E\u0432\u0430. \u041C\u0435\u0441\u0442\u0430 dailyCap \u0443\u0436\u0435 \u0437\u0430\u043D\u044F\u0442\u044B, \u0437\u0430\u043C\u0435\u043D\u044B \u0432 \u044D\u0442\u043E\u043C \u043F\u0440\u043E\u0433\u043E\u043D\u0435 \u043D\u0435 \u0434\u043E\u0431\u0438\u0440\u0430\u044E\u0442\u0441\u044F. droppedOverBlockLimit \u2014 \u0438\u0441\u0442\u043E\u0440\u0438\u0447\u0435\u0441\u043A\u0438\u0439 \u0441\u0447\u0451\u0442\u0447\u0438\u043A.";
+export declare const SCHEDULED_MODEL_HINT = "\u0417\u0430\u043F\u0438\u0441\u044C \u043C\u043E\u0434\u0435\u043B\u0438 \u0438 max_tokens \u0440\u0435\u0436\u0438\u043C\u043E\u0432 daily/hourly \u043F\u043E\u043A\u0430 \u0437\u0430\u043A\u0440\u044B\u0442\u0430 \u0444\u043B\u0430\u0433\u043E\u043C API SCHEDULED_TASK_MODEL_WRITES_ENABLED (\u043F\u043E\u044D\u0442\u0430\u043F\u043D\u044B\u0439 \u0432\u044B\u043A\u0430\u0442). \u041C\u043E\u0441\u0442 \u043E\u0442\u0432\u0435\u0440\u0433\u0430\u0435\u0442 \u044D\u0442\u0438 \u043F\u043E\u043B\u044F \u0434\u043E HTTP \u0438 \u043E\u0442\u043A\u0440\u043E\u0435\u0442 \u0438\u0445 \u0432\u043C\u0435\u0441\u0442\u0435 \u0441 \u0432\u043A\u043B\u044E\u0447\u0435\u043D\u0438\u0435\u043C \u0444\u043B\u0430\u0433\u0430.";
+export declare const ANALYSIS_WINDOW_HINT = "\u041D\u043E\u0432\u044B\u0439 \u0440\u0430\u0437\u0431\u043E\u0440 \u0432\u044B\u043F\u043E\u043B\u043D\u044F\u0435\u0442\u0441\u044F \u0442\u043E\u043B\u044C\u043A\u043E \u043F\u0440\u0438 \u0440\u0435\u043F\u043B\u0438\u043A\u0435 \u043A\u043B\u0438\u0435\u043D\u0442\u0430 \u0432 \u043E\u043A\u043D\u0435. \u041E\u043A\u043D\u043E \u0438\u0437 \u043E\u0434\u043D\u0438\u0445 \u043E\u0442\u0432\u0435\u0442\u043E\u0432 \u0430\u0433\u0435\u043D\u0442\u0430 \u0438\u043B\u0438 \u043E\u043F\u0435\u0440\u0430\u0442\u043E\u0440\u0430 \u043F\u0440\u043E\u043F\u0443\u0441\u043A\u0430\u0435\u0442\u0441\u044F; \u043F\u043E\u0432\u0442\u043E\u0440\u043D\u0430\u044F \u0434\u043E\u0441\u0442\u0430\u0432\u043A\u0430 \u0443\u0436\u0435 \u0441\u043E\u0445\u0440\u0430\u043D\u0451\u043D\u043D\u043E\u0439 \u043F\u043E\u0434\u0441\u043A\u0430\u0437\u043A\u0438 \u0432\u043E\u0437\u043C\u043E\u0436\u043D\u0430 \u0431\u0435\u0437 \u043D\u043E\u0432\u043E\u0433\u043E \u0432\u0445\u043E\u0434\u044F\u0449\u0435\u0433\u043E.";
+export declare const SILENCE_AXES_HINT = "\u041F\u0440\u0438 replace_actions=true \u044F\u0432\u043D\u043E \u0441\u043E\u0445\u0440\u0430\u043D\u044F\u0439 \u043E\u0431\u0435 \u043E\u0441\u0438 SILENT_MODE: config.silence_bot \u0438 config.silence_followups. \u041F\u0440\u043E\u043F\u0443\u0449\u0435\u043D\u043D\u0430\u044F \u043E\u0441\u044C \u043F\u043E\u043B\u0443\u0447\u0430\u0435\u0442 true, \u0430 \u043D\u0435 \u043F\u0440\u0435\u0436\u043D\u0435\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435. \u0414\u043B\u044F \u0441\u0442\u0430\u0440\u043E\u0433\u043E \u043A\u043E\u043D\u0432\u0435\u0440\u0442\u0430 \u2014 silenceBot/silenceFollowUps.";
+export declare const LINK_PAGINATION_HINT = "\u041E\u0442\u0432\u0435\u0442 \u043F\u043E\u0441\u0442\u0440\u0430\u043D\u0438\u0447\u043D\u044B\u0439: items/total/limit/offset/hasMore. \u041F\u0440\u0438 hasMore=true \u0434\u043E\u0447\u0438\u0442\u044B\u0432\u0430\u0439 \u043A\u0430\u0442\u0430\u043B\u043E\u0433; \u043F\u0443\u0441\u0442\u0430\u044F \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0430 \u043D\u0435 \u0434\u043E\u043A\u0430\u0437\u044B\u0432\u0430\u0435\u0442 \u043F\u0443\u0441\u0442\u043E\u0439 \u043A\u0430\u0442\u0430\u043B\u043E\u0433.";
+export declare const POOL_OUTSIDE_HINT = "outsideSegmentsBy: paid \u2014 \u043A\u0443\u043F\u0438\u043B, application \u2014 \u0435\u0441\u0442\u044C \u0436\u0438\u0432\u0430\u044F \u0437\u0430\u044F\u0432\u043A\u0430, attendanceNoMinutes \u2014 \u0431\u044B\u043B \u043D\u0430 \u044D\u0444\u0438\u0440\u0435, \u043C\u0438\u043D\u0443\u0442 \u043D\u0435 \u0437\u0430\u043F\u0438\u0441\u0430\u043D\u043E, paidElsewhere \u2014 \u043F\u043E\u043A\u0443\u043F\u0430\u043B \u0432 \u0434\u0440\u0443\u0433\u043E\u0439 \u0432\u043E\u0440\u043E\u043D\u043A\u0435, seriesRunning \u2014 \u0441\u0435\u0440\u0438\u044F \u0435\u0449\u0451 \u0438\u0434\u0451\u0442, other \u2014 \u043F\u0440\u043E\u0447\u0435\u0435. \u041E\u0434\u043D\u0430 \u043F\u0440\u0438\u0447\u0438\u043D\u0430 \u043D\u0430 \u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044E, \u0441\u0443\u043C\u043C\u0430 \u0440\u0430\u0432\u043D\u0430 outsideSegments. \u0421\u0442\u0430\u0440\u044B\u0435 \u0441\u043D\u0438\u043C\u043A\u0438 \u043C\u043E\u0433\u043B\u0438 \u043E\u0442\u043D\u043E\u0441\u0438\u0442\u044C paidElsewhere \u0438 seriesRunning \u043A other.";
+export declare const v15DescriptionUpdates: Readonly<Record<string, {
+    replace?: readonly (readonly [string, string])[];
+    append: string;
+}>>;

package/dist/tools/definitions/v15-port-descriptions.js

@@ -0,0 +1,30 @@
+// Публикуемые уточнения v1.5 в словаре v2. Генератор дополняет описания,
+// сохраняя исходные права доступа и остальные инструкции каталога.
+import { SCHEDULE_EXCLUSION_HINT } from './schedule-selection-hints.js';
+export const SCHEDULE_GUARD_HINT = 'Предохранитель проверяет кандидатов только до набора dailyCap; overCap им не проверен. snapshot.guard_unchecked — сколько отобранных осталось непроверенными (count) и почему (cause): сбой источника или исчерпание времени. Доставка проверит их снова. Аудит отбора ищи по stage=SCHEDULE_SELECTION и scheduleRunId.';
+export const SCHEDULE_BLOCKS_HINT = 'Пакет расписания не ограничен числом блоков «продукт × воронка». Снятие БЛОКА планом из-за переменных: excludedBy.blockPlaceholdersUnresolved, исход SKIPPED_UNRESOLVED_VARS и пауза 6 часов (при отправке отдельному человеку пауза сутки); имена переменных — в причине строк журнала. После паузы люди возвращаются к следующему запуску, но без исправления переменных или перекрытий агента блок снимается снова. Места dailyCap уже заняты, замены в этом прогоне не добираются. droppedOverBlockLimit — исторический счётчик.';
+export const SCHEDULED_MODEL_HINT = 'Запись модели и max_tokens режимов daily/hourly пока закрыта флагом API SCHEDULED_TASK_MODEL_WRITES_ENABLED (поэтапный выкат). Мост отвергает эти поля до HTTP и откроет их вместе с включением флага.';
+export const ANALYSIS_WINDOW_HINT = 'Новый разбор выполняется только при реплике клиента в окне. Окно из одних ответов агента или оператора пропускается; повторная доставка уже сохранённой подсказки возможна без нового входящего.';
+export const SILENCE_AXES_HINT = 'При replace_actions=true явно сохраняй обе оси SILENT_MODE: config.silence_bot и config.silence_followups. Пропущенная ось получает true, а не прежнее значение. Для старого конверта — silenceBot/silenceFollowUps.';
+export const LINK_PAGINATION_HINT = 'Ответ постраничный: items/total/limit/offset/hasMore. При hasMore=true дочитывай каталог; пустая страница не доказывает пустой каталог.';
+export const POOL_OUTSIDE_HINT = 'outsideSegmentsBy: paid — купил, application — есть живая заявка, attendanceNoMinutes — был на эфире, минут не записано, paidElsewhere — покупал в другой воронке, seriesRunning — серия ещё идёт, other — прочее. Одна причина на регистрацию, сумма равна outsideSegments. Старые снимки могли относить paidElsewhere и seriesRunning к other.';
+export const v15DescriptionUpdates = {
+    besales_broadcast_schedule_runs: { append: [SCHEDULE_GUARD_HINT, SCHEDULE_BLOCKS_HINT, SCHEDULE_EXCLUSION_HINT].join(' ') },
+    besales_broadcast_schedule_preview: { append: SCHEDULE_EXCLUSION_HINT },
+    besales_broadcast_pool_today: { append: POOL_OUTSIDE_HINT },
+    besales_scheduled_task_update: {
+        replace: [['Поля model, max_tokens и сырой текст промпта в v2 не переносятся и отвергаются по имени.', 'daily/hourly.model и max_tokens отвергаются по имени до HTTP, пока запись закрыта флагом API SCHEDULED_TASK_MODEL_WRITES_ENABLED; мост откроет их вместе с флагом. Сырой текст промпта также отвергается.']],
+        append: SCHEDULED_MODEL_HINT + ' ' + ANALYSIS_WINDOW_HINT,
+    },
+    besales_dialogue_analysis_task_update: { append: SCHEDULED_MODEL_HINT + ' ' + ANALYSIS_WINDOW_HINT },
+    besales_tracked_link_list: {
+        replace: [
+            ['Каталог приходит ЦЕЛИКОМ: постраничности у него нет, и пустой ответ означает «ссылок нет», а не «страница кончилась».', ''],
+            ['Каталог приходит ЦЕЛИКОМ, постраничности у него нет.', ''],
+        ],
+        append: LINK_PAGINATION_HINT,
+    },
+    besales_trigger_upsert: { append: SILENCE_AXES_HINT },
+    besales_broadcast_analytics_get: { append: 'Список и сводка оплат поддерживают platform_id, funnel, остальные общие измерения и include_archived. Период оплат передаётся как periodMode: без mode/days всё время; mode=days без days — 30 дней. mode=range принимает открытый диапазон: только from, только to или обе границы; если заданы обе, to не раньше from. Параметры должны поддерживаться выбранным report; payment_candidates: page_size не больше 100. payment_view можно сочетать с payment_status/payment_eligibility: API отдаёт приоритет view.' },
+};
+//# sourceMappingURL=v15-port-descriptions.js.map

package/dist/tools/definitions/v15-port-descriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v15-port-descriptions.js","sourceRoot":"","sources":["../../../src/tools/definitions/v15-port-descriptions.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,mEAAmE;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAAG,yTAAyT,CAAC;AAC7V,MAAM,CAAC,MAAM,oBAAoB,GAAG,sgBAAsgB,CAAC;AAC3iB,MAAM,CAAC,MAAM,oBAAoB,GAAG,wMAAwM,CAAC;AAC7O,MAAM,CAAC,MAAM,oBAAoB,GAAG,kMAAkM,CAAC;AACvO,MAAM,CAAC,MAAM,iBAAiB,GAAG,sNAAsN,CAAC;AACxP,MAAM,CAAC,MAAM,oBAAoB,GAAG,yIAAyI,CAAC;AAC9K,MAAM,CAAC,MAAM,iBAAiB,GAAG,kVAAkV,CAAC;AAEpX,MAAM,CAAC,MAAM,qBAAqB,GAAmG;IACnI,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,uBAAuB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;IAC3H,kCAAkC,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE;IACvE,4BAA4B,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE;IAC3D,6BAA6B,EAAE;QAC7B,OAAO,EAAE,CAAC,CAAC,0FAA0F,EAAE,2MAA2M,CAAC,CAAC;QACpT,MAAM,EAAE,oBAAoB,GAAG,GAAG,GAAG,oBAAoB;KAC1D;IACD,qCAAqC,EAAE,EAAE,MAAM,EAAE,oBAAoB,GAAG,GAAG,GAAG,oBAAoB,EAAE;IACpG,yBAAyB,EAAE;QACzB,OAAO,EAAE;YACP,CAAC,uHAAuH,EAAE,EAAE,CAAC;YAC7H,CAAC,sDAAsD,EAAE,EAAE,CAAC;SAC7D;QACD,MAAM,EAAE,oBAAoB;KAC7B;IACD,sBAAsB,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE;IACrD,+BAA+B,EAAE,EAAE,MAAM,EAAE,sfAAsf,EAAE;CACpiB,CAAC"}

package/dist/tools/definitions/variables.d.ts

@@ -0,0 +1,44 @@
+/** Отказ со ссылками нельзя обходить подтверждением или автоматическим повтором. */
+export declare const VARIABLE_DELETE_CONFLICT_INSTRUCTIONS = "\u041F\u0440\u0438 409 \u0438\u0437-\u0437\u0430 \u0441\u0441\u044B\u043B\u043E\u043A \u0446\u0435\u043F\u043E\u0447\u0435\u043A \u0441 \u043D\u0435\u043F\u0443\u0441\u0442\u044B\u043C workflows \u043F\u043E\u043A\u0430\u0436\u0438 \u0447\u0435\u043B\u043E\u0432\u0435\u043A\u0443 \u0438\u043C\u0435\u043D\u0430 \u0446\u0435\u043F\u043E\u0447\u0435\u043A \u0438 liveRuns \u043A\u0430\u0436\u0434\u043E\u0439 (\u0447\u0438\u0441\u043B\u043E \u0436\u0438\u0432\u044B\u0445 \u043F\u0440\u043E\u0433\u043E\u043D\u043E\u0432), \u0437\u0430\u0442\u0435\u043C \u043E\u0441\u0442\u0430\u043D\u043E\u0432\u0438\u0441\u044C \u0438 \u043D\u0435 \u043F\u0440\u043E\u0434\u043E\u043B\u0436\u0430\u0439 \u0443\u0434\u0430\u043B\u0435\u043D\u0438\u0435. \u042F\u0432\u043D\u043E\u0435 \u043F\u043E\u0434\u0442\u0432\u0435\u0440\u0436\u0434\u0435\u043D\u0438\u0435 \u043D\u0435 \u043E\u0431\u0445\u043E\u0434\u0438\u0442 \u0441\u0441\u044B\u043B\u043A\u0438. \u0414\u043B\u044F \u0443\u0434\u0430\u043B\u0435\u043D\u0438\u044F \u0446\u0435\u043F\u043E\u0447\u043A\u0430 \u0441\u043E \u0441\u0441\u044B\u043B\u043A\u043E\u0439 \u0434\u043E\u043B\u0436\u043D\u0430 \u0431\u044B\u0442\u044C \u0432\u044B\u043A\u043B\u044E\u0447\u0435\u043D\u0430, \u0438 \u0436\u0438\u0432\u044B\u0445 \u043F\u0440\u043E\u0433\u043E\u043D\u043E\u0432 \u0441\u043E \u0441\u0441\u044B\u043B\u043A\u043E\u0439 \u043D\u0435 \u0434\u043E\u043B\u0436\u043D\u043E \u0431\u044B\u0442\u044C. \u0412\u043A\u043B\u044E\u0447\u0438 \u043F\u0440\u0438\u043F\u0430\u0440\u043A\u043E\u0432\u0430\u043D\u043D\u0443\u044E \u0446\u0435\u043F\u043E\u0447\u043A\u0443 \u0438 \u0434\u043E\u0436\u0434\u0438\u0441\u044C \u0437\u0430\u0432\u0435\u0440\u0448\u0435\u043D\u0438\u044F \u043F\u0440\u043E\u0433\u043E\u043D\u043E\u0432; \u0435\u0441\u043B\u0438 \u043F\u043E\u0441\u043B\u0435\u0434\u043D\u044F\u044F \u0432\u0435\u0440\u0441\u0438\u044F \u0441\u043E\u0445\u0440\u0430\u043D\u044F\u0435\u0442 \u0441\u0441\u044B\u043B\u043A\u0443, \u0432\u044B\u043A\u043B\u044E\u0447\u0438 \u0446\u0435\u043F\u043E\u0447\u043A\u0443. \u041C\u043E\u0436\u043D\u043E \u0442\u0430\u043A\u0436\u0435 \u0443\u0434\u0430\u043B\u0438\u0442\u044C \u0446\u0435\u043F\u043E\u0447\u043A\u0443 \u043B\u0438\u0431\u043E \u0443\u0431\u0440\u0430\u0442\u044C \u0441\u0441\u044B\u043B\u043A\u0443 \u0438\u0437 \u043F\u043E\u0441\u043B\u0435\u0434\u043D\u0435\u0439 \u0432\u0435\u0440\u0441\u0438\u0438 \u0438 \u0434\u043E\u0436\u0434\u0430\u0442\u044C\u0441\u044F \u043A\u043E\u043D\u0446\u0430 \u0436\u0438\u0432\u044B\u0445 \u043F\u0440\u043E\u0433\u043E\u043D\u043E\u0432 \u0441\u043E \u0441\u0441\u044B\u043B\u043A\u043E\u0439. \u041F\u043E\u0432\u0442\u043E\u0440\u0438 \u0443\u0434\u0430\u043B\u0435\u043D\u0438\u0435 \u0442\u043E\u043B\u044C\u043A\u043E \u043F\u043E\u0441\u043B\u0435 \u0432\u044B\u043F\u043E\u043B\u043D\u0435\u043D\u0438\u044F \u044D\u0442\u0438\u0445 \u0443\u0441\u043B\u043E\u0432\u0438\u0439.";
+export declare const variableTools: (import("./shared.js").ToolDefinition<{
+    scope: "WORKSPACE" | "CHANNEL";
+    workspace_id?: string | undefined;
+    platform_id?: string | undefined;
+    filter?: "all" | "variables" | "constants" | undefined;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    scope: "WORKSPACE" | "CHANNEL";
+    name: string;
+    type: "TEXT" | "BOOLEAN" | "NUMBER" | "FLOAT";
+    workspace_id?: string | undefined;
+    description?: string | undefined;
+    value?: string | undefined;
+    platform_id?: string | undefined;
+    is_constant?: boolean | undefined;
+    constant_value?: string | undefined;
+    repeat_constant_value?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    variable_id: string;
+    scope: "WORKSPACE" | "CHANNEL";
+    workspace_id?: string | undefined;
+    platform_id?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    variable_id: string;
+    scope: "WORKSPACE" | "CHANNEL";
+    expected_version?: string | undefined;
+    workspace_id?: string | undefined;
+    platform_id?: string | undefined;
+    description?: string | undefined;
+    type?: "TEXT" | "BOOLEAN" | "NUMBER" | "FLOAT" | undefined;
+    value?: string | null | undefined;
+    constant_value?: string | null | undefined;
+    repeat_constant_value?: string | null | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    variable_id: string;
+    scope: "WORKSPACE" | "CHANNEL";
+    explicit_confirmation: true;
+    expected_version?: string | undefined;
+    workspace_id?: string | undefined;
+    platform_id?: string | undefined;
+}>)[];

package/dist/tools/definitions/variables.js

@@ -0,0 +1,310 @@
+import { withEditVersionInstructions, editVersionInstruction } from './edit-version.js';
+import { z } from 'zod';
+import { assertCompleteList } from '../incomplete-list.js';
+import { VARIABLES_MAX_PAGE_SIZE, compactObject, defineTool, uuidSchema, withInstructions, } from './shared.js';
+function mapVariableType(type) {
+    return type === 'TEXT' ? 'STRING' : type;
+}
+/** Отказ со ссылками нельзя обходить подтверждением или автоматическим повтором. */
+export const VARIABLE_DELETE_CONFLICT_INSTRUCTIONS = 'При 409 из-за ссылок цепочек с непустым workflows покажи человеку имена цепочек и liveRuns каждой (число живых прогонов), затем остановись и не продолжай удаление. Явное подтверждение не обходит ссылки. Для удаления цепочка со ссылкой должна быть выключена, и живых прогонов со ссылкой не должно быть. Включи припаркованную цепочку и дождись завершения прогонов; если последняя версия сохраняет ссылку, выключи цепочку. Можно также удалить цепочку либо убрать ссылку из последней версии и дождаться конца живых прогонов со ссылкой. Повтори удаление только после выполнения этих условий.';
+/** Подсказка про второе значение константы — одна для создания и правки. */
+const REPEAT_CONSTANT_VALUE_INSTRUCTION = 'repeat_constant_value подставляется вместо constant_value человеку, которому мы уже писали, — только в холодных рассылках (например, {intro}: «это снова Светлана.» вместо полного представления). Только константы CHANNEL; фигурные скобки запрещены; пустая строка или null очищает — тогда повтору уходит constant_value.';
+export const variableTools = [
+    // ============================================================
+    // v1.5 Increment 4a — Unified Variables API (5 tools, v2-shaped scope discriminator)
+    // ============================================================
+    // Backend wraps two v1 tables (WorkspaceVariable + CustomVariable) под единый MCP shape.
+    // При v2 cutover (spec 23) обе таблицы → один `variables` с тем же `scope` discriminator —
+    // MCP shape работает без изменений.
+    defineTool({
+        name: 'besales_variable_list',
+        sideEffect: 'none',
+        closedWorld: true,
+        requiredFields: ['scope'],
+        defaultWorkspaceId: true,
+        // По этому перечню строят условия правил. Отсутствующая в усечённом списке переменная
+        // неотличима от «значение не проставлено», и правило получается недостижимым.
+        resultPolicy: { neverTruncate: true },
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            scope: z.enum(['WORKSPACE', 'CHANNEL']),
+            platform_id: uuidSchema.optional(),
+            filter: z.enum(['all', 'variables', 'constants']).optional(),
+            // ⚠️ Без дефолта. Сервер СВОЙ дефолт имеет (50), и до появления этих двух ручек
+            // перечень молча обрывался на пятидесятой строке, а способа дочитать не было вовсе.
+            limit: z.number().int().min(1).max(VARIABLES_MAX_PAGE_SIZE).optional(),
+            cursor: z.string().min(1).optional(),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.scope === 'CHANNEL' && !input.platform_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'platform_id is required when scope=CHANNEL',
+                    path: ['platform_id'],
+                });
+            }
+            if (input.scope === 'WORKSPACE' && input.platform_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'platform_id is forbidden when scope=WORKSPACE',
+                    path: ['platform_id'],
+                });
+            }
+        }),
+        createRequest: (input) => {
+            const query = new URLSearchParams({ scope: input.scope });
+            if (input.platform_id)
+                query.set('scopeId', input.platform_id);
+            if (input.filter === 'constants')
+                query.set('isConstant', 'true');
+            if (input.filter === 'variables')
+                query.set('isConstant', 'false');
+            if (input.limit !== undefined)
+                query.set('limit', String(input.limit));
+            if (input.cursor)
+                query.set('cursor', input.cursor);
+            return {
+                method: 'GET',
+                path: `/workspaces/${input.workspace_id}/variables?${query.toString()}`,
+            };
+        },
+        enhanceResponse: (response, input) => withInstructions(assertCompleteList(response, {
+            // Страницу попросили явно — отказ неуместен: постраничный обход это и есть.
+            pageRequested: input.limit !== undefined || input.cursor !== undefined,
+            toolName: 'besales_variable_list',
+            howToPage: `Позовите снова с limit (до ${VARIABLES_MAX_PAGE_SIZE}) и продолжайте по nextCursor, пока он не станет пустым.`,
+        }), [
+            'WORKSPACE scope возвращает переменные workspace, CHANNEL — переменные указанного канала.',
+            'platform_id — legacy-имя аргумента для UUID канала; filter маппится в v2 isConstant.',
+            'nextCursor в ответе означает, что показана НЕ вся выборка: дочитайте страницами.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_variable_create',
+        sideEffect: 'write',
+        closedWorld: true,
+        requiredFields: ['scope', 'name', 'type'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            scope: z.enum(['WORKSPACE', 'CHANNEL']),
+            name: z.string().regex(/^[a-zA-Z_][a-zA-Z0-9_]*$/, {
+                message: 'name must be ASCII letters/digits/underscores; start with letter or _',
+            }),
+            description: z.string().optional(),
+            type: z.enum(['TEXT', 'NUMBER', 'FLOAT', 'BOOLEAN']),
+            // WORKSPACE-only
+            value: z.string().optional(),
+            // CHANNEL-only
+            platform_id: uuidSchema.optional(),
+            is_constant: z.boolean().optional(),
+            constant_value: z.string().optional(),
+            repeat_constant_value: z.string().optional(),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.scope === 'WORKSPACE') {
+                if (input.platform_id) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'platform_id is forbidden when scope=WORKSPACE',
+                        path: ['platform_id'],
+                    });
+                }
+                if (input.is_constant !== undefined ||
+                    input.constant_value !== undefined ||
+                    input.repeat_constant_value !== undefined) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'is_constant, constant_value and repeat_constant_value are forbidden when scope=WORKSPACE',
+                        path: ['is_constant'],
+                    });
+                }
+            }
+            else {
+                // CHANNEL
+                if (!input.platform_id) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'platform_id is required when scope=CHANNEL',
+                        path: ['platform_id'],
+                    });
+                }
+                if (input.value !== undefined) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'value is forbidden when scope=CHANNEL — use constant_value if isConstant=true',
+                        path: ['value'],
+                    });
+                }
+                if (input.is_constant === true && !input.constant_value) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'constant_value is required when scope=CHANNEL and is_constant=true',
+                        path: ['constant_value'],
+                    });
+                }
+                if (input.is_constant !== true && input.repeat_constant_value !== undefined) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: 'repeat_constant_value is allowed only when scope=CHANNEL and is_constant=true',
+                        path: ['repeat_constant_value'],
+                    });
+                }
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/variables`,
+            body: compactObject({
+                scope: input.scope,
+                name: input.name,
+                description: input.description,
+                type: mapVariableType(input.type),
+                scopeId: input.platform_id,
+                isConstant: input.is_constant,
+                defaultValue: input.is_constant ? input.constant_value : input.value,
+                repeatConstantValue: input.repeat_constant_value,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'name и scope/scopeId иммутабельны после создания.',
+            'TEXT автоматически маппится в v2 STRING; значение хранится в defaultValue.',
+            REPEAT_CONSTANT_VALUE_INSTRUCTION,
+        ]),
+    }),
+    defineTool({
+        name: 'besales_variable_get',
+        sideEffect: 'none',
+        closedWorld: true,
+        requiredFields: ['variable_id', 'scope'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            variable_id: uuidSchema,
+            scope: z.enum(['WORKSPACE', 'CHANNEL']),
+            platform_id: uuidSchema.optional(),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.scope === 'CHANNEL' && !input.platform_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'platform_id is required when scope=CHANNEL',
+                    path: ['platform_id'],
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/variables/${input.variable_id}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_variable_update',
+        sideEffect: 'write',
+        closedWorld: true,
+        requiredFields: ['variable_id', 'scope'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            expected_version: uuidSchema.optional(),
+            workspace_id: uuidSchema.optional(),
+            variable_id: uuidSchema,
+            scope: z.enum(['WORKSPACE', 'CHANNEL']),
+            platform_id: uuidSchema.optional(),
+            description: z.string().optional(),
+            type: z.enum(['TEXT', 'NUMBER', 'FLOAT', 'BOOLEAN']).optional(),
+            // WORKSPACE-only (nullable для clear)
+            value: z.string().nullable().optional(),
+            // CHANNEL-only (nullable для clear)
+            constant_value: z.string().nullable().optional(),
+            repeat_constant_value: z.string().nullable().optional(),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.scope === 'CHANNEL' && !input.platform_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'platform_id is required when scope=CHANNEL',
+                    path: ['platform_id'],
+                });
+            }
+            if (input.scope === 'WORKSPACE' && input.constant_value !== undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'constant_value is forbidden when scope=WORKSPACE',
+                    path: ['constant_value'],
+                });
+            }
+            if (input.scope === 'WORKSPACE' && input.repeat_constant_value !== undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'repeat_constant_value is forbidden when scope=WORKSPACE',
+                    path: ['repeat_constant_value'],
+                });
+            }
+            if (input.scope === 'CHANNEL' && input.value !== undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'value is forbidden when scope=CHANNEL',
+                    path: ['value'],
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/variables/${input.variable_id}`,
+            body: compactObject({
+                expectedVersion: input.expected_version,
+                description: input.description,
+                type: mapVariableType(input.type),
+                defaultValue: input.scope === 'CHANNEL' ? input.constant_value : input.value,
+                // null доезжает как есть: это «очистить» второе значение.
+                repeatConstantValue: input.repeat_constant_value,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [editVersionInstruction(), REPEAT_CONSTANT_VALUE_INSTRUCTION]),
+    }),
+    defineTool({
+        name: 'besales_variable_delete',
+        sideEffect: 'write',
+        closedWorld: true,
+        requiredFields: ['variable_id', 'scope', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            expected_version: uuidSchema.optional(),
+            workspace_id: uuidSchema.optional(),
+            variable_id: uuidSchema,
+            scope: z.enum(['WORKSPACE', 'CHANNEL']),
+            platform_id: uuidSchema.optional(),
+            explicit_confirmation: z.literal(true),
+        })
+            .strict()
+            .superRefine((input, ctx) => {
+            if (input.scope === 'CHANNEL' && !input.platform_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'platform_id is required when scope=CHANNEL',
+                    path: ['platform_id'],
+                });
+            }
+        }),
+        // ⛔ Подтверждение ДОХОДИТ ДО СЕРВЕРА. Раньше `explicit_confirmation` проверяла только схема
+        // инструмента и дальше выбрасывала: сервер удалял переменную без единого вопроса, а у него
+        // есть и другие вызыватели. Теперь гейт стоит на сервере, и без этого параметра удаление
+        // через мост отвечало бы отказом.
+        createRequest: (input) => ({
+            method: 'DELETE',
+            ...compactObject({ ifMatch: input.expected_version }),
+            path: `/variables/${input.variable_id}?confirm=true`,
+        }),
+        enhanceResponse: withEditVersionInstructions,
+    }),
+];
+//# sourceMappingURL=variables.js.map