@besales/mcp 0.47.1 → 1.0.0-beta.2

package/dist/tools/definitions/trigger-claim-alias.js

@@ -0,0 +1,90 @@
+// Отгруженные имена заявок срабатывания одноразовых триггеров, вернувшиеся в ветку `v2`.
+//
+// ⛔ ЕДИНИЦА ПРАВА ИЗМЕНИЛАСЬ, и это ратифицированное решение, а не пробел. У прежней системы право
+// сжигалось по КАНАЛУ навсегда, и ограничения «раз в переписку» там не было вовсе; у v2 право
+// живёт в ПЕРЕПИСКЕ (ратификация владельца 2026-08-05, спека 24 помечает это «МЕНЯЕТ ПОВЕДЕНИЕ»).
+// Следствие названо в подсказке: у человека, чья переписка переоткрывалась, держателей права
+// столько же, сколько переписок, и снятие одного не снимает остальные.
+import { z } from 'zod';
+import { defineTool, uuidSchema, withInstructions } from './shared.js';
+const UNIT_OF_RIGHT = [
+    '⛔ Право живёт в ПЕРЕПИСКЕ, а не в канале. У прежней версии оно сжигалось по каналу навсегда; здесь у контакта столько держателей права, сколько у него переписок, и снятие одного не снимает остальные.',
+    'Строка выдачи несёт переписку, канал и её состояние: по ним видно, живая это переписка или закрытая.',
+];
+export const triggerClaimAliasTools = [
+    defineTool({
+        name: 'besales_trigger_claim_list',
+        sideEffect: 'none',
+        closedWorld: true,
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            contact_id: uuidSchema.optional(),
+            chat_user_id: uuidSchema.optional(),
+        })
+            .strict()
+            .superRefine((input, context) => {
+            if (input.contact_id === undefined && input.chat_user_id === undefined) {
+                context.addIssue({ code: 'custom', path: ['contact_id'], message: 'Передайте contact_id или прежний chat_user_id' });
+            }
+            if (input.contact_id !== undefined && input.chat_user_id !== undefined && input.contact_id !== input.chat_user_id) {
+                context.addIssue({ code: 'custom', path: ['chat_user_id'], message: 'contact_id и chat_user_id адресуют разных людей' });
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/contacts/${input.contact_id ?? input.chat_user_id}/burnt-actions`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Это отгруженное имя поверх маршрута v2. Единица прежней версии — карточка канала; у v2 её место занял КОНТАКТ, contact_id и прежнее имя chat_user_id принимаются как синонимы.',
+            ...UNIT_OF_RIGHT,
+            '⛔ Выдача собирается из ДВУХ источников: строк права (hold=GRANT) и ИДУЩИХ исполнений (hold=IN_FLIGHT). Второй обязателен: строка права пишется только на терминальном переходе, и без него инструмент отвечал бы «прав нет» ровно тогда, когда право занято.',
+            'Выключенные действия и действия со снятой однократностью ВХОДЯТ в выдачу: право переживает выключение настройки, и спрятав такую строку, мы оставили бы «снимать нечего» при занятом праве.',
+            'stillOneTime=false у ЧИТАЮЩЕГО действия — не ошибка: правило однократности к нему не применяется вовсе, и строка права у него ничего не держит.',
+            'canReset=false означает ровно одно: право держит идущее исполнение. Причина временная — подождите, а не чините.',
+            'truncated=true означает, что показано не всё: курсора у выдачи нет, как и у прежней версии.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_trigger_claim_reset',
+        sideEffect: 'write',
+        requiredFields: ['conversation_id', 'action_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            conversation_id: uuidSchema,
+            action_id: uuidSchema,
+            /**
+             * ⛔ Подтверждение НЕОБЯЗАТЕЛЬНО, и это не ослабление проверки, а условие того, чтобы
+             * подтверждать было чем. Сервер без подтверждения отвечает отказом, ПЕРЕЧИСЛЯЮЩИМ, что
+             * именно действие сможет повторить. Требуя подтверждение схемой, инструмент делал этот
+             * отказ недостижимым в принципе: конструктор запроса всегда дописывал подтверждение, и
+             * единственный живой потребитель — мост — никогда не видел предмета подтверждения.
+             *
+             * Порядок: зови БЕЗ подтверждения, покажи человеку перечень, дождись его согласия и зови
+             * второй раз с `explicit_confirmation: true`. Значение по-прежнему пришпилено к истине —
+             * «подтверждаю: нет» подтверждением не бывает.
+             */
+            explicit_confirmation: z.literal(true).optional(),
+        })
+            .strict(),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/conversations/${input.conversation_id}/burnt-actions/${input.action_id}` +
+                (input.explicit_confirmation === true ? '?confirm=true' : ''),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            '⚠️ Возвращённое право позволяет действию ПОВТОРИТЬ необратимое — запись в CRM, передачу диалога человеку, отправку сообщения. Зови только после явного подтверждения оператора.',
+            '⛔ Снимается право ОДНОЙ переписки. У прежней версии снятие освобождало канал целиком; здесь переписки независимы, и остальные держатели остаются.',
+            'Строка права не удаляется, а помечается возвращённой: именно её существование не даёт проверке повтора уйти в журнал исполнений, который режется сроком хранения.',
+            '⛔ ПОРЯДОК ДВУХШАГОВЫЙ. Первый вызов делай БЕЗ explicit_confirmation: сервер откажет и перечислит СЛОВАМИ, что именно действие сможет повторить (repeatableEffects). Покажи человеку именно их, дождись согласия и зови второй раз с explicit_confirmation: true. Рядом лежат машинные имена шагов (repeatableStepTypes) — они для кода, а не для показа.',
+            'Подтвердить, не увидев перечня, нельзя было бы осмысленно: «подтвердите» без предмета — это подтверждение вслепую.',
+            'Отказ «право держит идущее исполнение» временный: подождите завершения. Отказ «право не занято» покрывает и «уже возвращено» — различить их нечем, поэтому успех не объявляется.',
+            'Повторное срабатывание занимает право заново, и режим «один раз» не отменяется. ⚠️ Но «ровно одна попытка» обещать нельзя: если следующее исполнение права не займёт (действие только читает либо ни один его шаг не выполнился), пометка возврата остаётся, и попытки повторяются, пока одна не даст побочку.',
+        ]),
+    }),
+];
+//# sourceMappingURL=trigger-claim-alias.js.map

package/dist/tools/definitions/trigger-claim-alias.js.map

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

package/dist/tools/definitions/trigger-echo-projection.d.ts

@@ -0,0 +1 @@
+export declare function withProjectedTriggerEcho(response: unknown): unknown;

package/dist/tools/definitions/trigger-echo-projection.js

@@ -0,0 +1,41 @@
+/**
+ * Сжатие эха правки триггера.
+ *
+ * Сервер возвращает триггер ЦЕЛИКОМ — вместе со всеми шагами и условиями срабатывания. Это
+ * копия того, что вызывающий только что отправил, и весит она столько же: на канале триггеры
+ * правят десятками подряд, и каждый ответ уносит с собой ещё один экземпляр отправленного.
+ *
+ * ⚠️ Потолок ответа тут не помогает: один такой ответ до него не достаёт, он просто расходует
+ * контекст вызывающего раз за разом. Поэтому наружу уходят все скалярные поля (они дёшевы и
+ * среди них есть решённые СЕРВЕРОМ) и ЧИСЛА вместо двух тяжёлых массивов.
+ *
+ * ⛔ Функция обязана быть тотальной: она выполняется ПОСЛЕ состоявшейся записи, и исключение
+ * здесь стало бы приглашением повторить мутацию. Незнакомая форма возвращается как есть.
+ */
+const HEAVY_ARRAYS = [
+    ['steps', 'actionsCount'],
+    ['activations', 'activationsCount'],
+];
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function withProjectedTriggerEcho(response) {
+    if (!isRecord(response) || !isRecord(response['trigger'])) {
+        return response;
+    }
+    const trigger = response['trigger'];
+    const projected = { ...trigger };
+    let changed = false;
+    for (const [arrayKey, countKey] of HEAVY_ARRAYS) {
+        const value = trigger[arrayKey];
+        if (!Array.isArray(value)) {
+            continue;
+        }
+        delete projected[arrayKey];
+        projected[countKey] = value.length;
+        changed = true;
+    }
+    // Ничего не сократили — не подменяем и объект: лишняя копия только запутала бы сравнение.
+    return changed ? { ...response, trigger: projected } : response;
+}
+//# sourceMappingURL=trigger-echo-projection.js.map

package/dist/tools/definitions/trigger-echo-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-echo-projection.js","sourceRoot":"","sources":["../../../src/tools/definitions/trigger-echo-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,YAAY,GAAG;IACnB,CAAC,OAAO,EAAE,cAAc,CAAC;IACzB,CAAC,aAAa,EAAE,kBAAkB,CAAC;CAC3B,CAAC;AAEX,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAiB;IACxD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,SAAS,GAA4B,EAAE,GAAG,OAAO,EAAE,CAAC;IAC1D,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,YAAY,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3B,SAAS,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QACnC,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,0FAA0F;IAC1F,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClE,CAAC"}

package/dist/tools/definitions/trigger-upsert.tool.d.ts

@@ -0,0 +1,29 @@
+export declare const triggerUpsertTool: import("./shared.js").ToolDefinition<{
+    platform_id: string;
+    agent_id: string;
+    explicit_confirmation?: boolean | undefined;
+    confirmation_reason?: string | undefined;
+    arguments?: {
+        label: string;
+        description: string;
+        type: "TEXT" | "BOOLEAN" | "DATETIME" | "NUMBER";
+        key?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
+    scope?: "ON_USER_MESSAGE" | undefined;
+    metadata?: {
+        [x: string]: unknown;
+    } | undefined;
+    actions?: unknown[] | undefined;
+    replace_actions?: boolean | undefined;
+    allow_repeated_calls?: boolean | undefined;
+    run_once_per_contact?: boolean | undefined;
+    trigger_id?: string | undefined;
+    name?: string | undefined;
+    condition?: string | undefined;
+    is_enabled?: boolean | undefined;
+    priority?: number | undefined;
+    stop_propagation?: boolean | undefined;
+    instagram_comment_kind?: "COMPLAINT" | null | undefined;
+    allow_repeat_in_conversation?: boolean | undefined;
+}>;

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

@@ -0,0 +1,122 @@
+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;
+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(),
+        // `.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),
+    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({
+            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), [
+        'В ответе вместо самих шагов и условий — их количество (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;
+}>)[];