@besales/mcp 0.47.1 → 1.0.0-beta.2

package/dist/tools/definitions/dialogue-export.js

@@ -2,7 +2,7 @@
 // по фильтрам + транскрипт одного диалога. Scope read:conversations (входит в mcp:*).
 // MCP файлы НЕ пишет — данные возвращаются, вызывающий AI раскладывает по файлам.
 import { z } from 'zod';
-import { defineTool, uuidSchema, withInstructions } from './shared.js';
+import { compactObject, defineTool, uuidSchema, withInstructions } from './shared.js';
 const workLogEventSchema = z.enum([
     'START',
     'IN_PROCESS',
@@ -15,6 +15,7 @@ const workLogEventSchema = z.enum([
 export const dialogueExportTools = [
     defineTool({
         name: 'besales_dialogues_query',
+        carriesCustomerData: true,
         sideEffect: 'none',
         closedWorld: true,
         requiredFields: [],
@@ -24,37 +25,84 @@ export const dialogueExportTools = [
         schema: z
             .object({
             workspace_id: uuidSchema.optional(),
-            // Фильтр по каналам (ChatUser.platformId IN ...).
+            source: z.enum(['export', 'inbox']).optional(),
+            channel_id: uuidSchema.optional(),
+            contact_id: uuidSchema.optional(),
+            purchased: z.boolean().optional(),
+            has_payment: z.boolean().optional(),
+            with_totals: z.boolean().optional(),
+            // Фильтр по каналам диалога.
             platform_ids: z.array(uuidSchema).optional(),
-            // Окно активности диалога (по сообщениям), ISO 8601.
+            // Окно, ISO 8601: по сообщениям, а при фильтре действия — по времени исполнения.
             date_from: z.string().datetime().optional(),
             date_to: z.string().datetime().optional(),
-            // CRM лид-статусы (ChatUser.leadStatus).
+            // CRM-статусы контакта.
             lead_status: z.array(z.string().min(1)).optional(),
-            // Причины деактивации бота (ChatUser.deactivateReason).
+            // Причины остановки автоматизации контакта.
             deactivate_reason: z.array(z.string().min(1)).optional(),
             // Фильтр по ПОСЛЕДНЕМУ событию platform_work_logs диалога.
             work_log_event: z.array(workLogEventSchema).optional(),
-            // ActionType выполненного на сообщении действия. Backend валидирует enum.
+            // Типы ШАГОВ действия (GETCOURSE_CREATE_DEAL…). Неизвестный тип — 400 со списком.
             action_type: z.array(z.string().min(1)).optional(),
-            // Успешность подходящего trigger-action.
+            // Успех шага указанного типа; без типа — успех исполнения целиком.
             action_success: z.boolean().optional(),
-            // Режим того же выполнения триггера.
+            // Режим исполнения; test — 422: тестовые диалоги в выгрузку не входят.
             action_execution_mode: z.enum(['production', 'test']).optional(),
-            // ChatUser.isBotActive.
+            // Активность AI для контакта.
             ai_enabled: z.boolean().optional(),
-            // ChatUser.isFollowUpActive.
+            // Активность follow-up для контакта.
             followups_enabled: z.boolean().optional(),
             // true — только с сообщениями; false — только без.
             has_messages: z.boolean().optional(),
             limit: z.number().int().min(1).max(100).optional(),
             cursor: z.string().optional(),
         })
-            .strict(),
+            .strict()
+            .superRefine((input, context) => {
+            const fields = input.source === 'inbox'
+                ? [
+                    'platform_ids',
+                    'date_from',
+                    'date_to',
+                    'lead_status',
+                    'deactivate_reason',
+                    'work_log_event',
+                    'action_type',
+                    'action_success',
+                    'action_execution_mode',
+                    'ai_enabled',
+                    'followups_enabled',
+                    'has_messages',
+                ]
+                : ['channel_id', 'contact_id', 'purchased', 'has_payment', 'with_totals'];
+            for (const field of fields)
+                if (input[field] !== undefined)
+                    context.addIssue({
+                        code: 'custom',
+                        path: [field],
+                        message: input.source === 'inbox'
+                            ? 'Этот фильтр относится к выгрузке диалогов; для Входящих он недоступен.'
+                            : 'Для фильтров Входящих выбери source=inbox.',
+                    });
+        }),
         createRequest: (input) => {
+            if (input.source === 'inbox')
+                return {
+                    method: 'POST',
+                    path: `/workspaces/${input.workspace_id}/conversations/search`,
+                    body: compactObject({
+                        channelId: input.channel_id,
+                        contactId: input.contact_id,
+                        purchased: input.purchased,
+                        hasPayment: input.has_payment,
+                        withTotals: input.with_totals,
+                        limit: input.limit,
+                        cursor: input.cursor,
+                    }),
+                };
             const params = new URLSearchParams();
             if (input.platform_ids?.length) {
-                params.set('platformIds', input.platform_ids.join(','));
+                params.set('channelIds', input.platform_ids.join(','));
             }
             if (input.date_from) {
                 params.set('dateFrom', input.date_from);
@@ -101,20 +149,29 @@ export const dialogueExportTools = [
                 path: `/workspaces/${input.workspace_id}/dialogue-export${query ? `?${query}` : ''}`,
             };
         },
-        enhanceResponse: (response) => withInstructions(response, [
-            'Манифест подходящих диалогов: { data: DialogueExportItem[], total, cursor }. total — «найдено N диалогов».',
-            'Пагинация: если cursor не null — повтори тот же вызов с этим cursor, пока не соберёшь все диалоги.',
-            'Для точного аудита новых заявок используй action_type=["GETCOURSE_CREATE_DEAL"], action_success=true и action_execution_mode="production".',
-            'GETCOURSE_SEND_PAYMENT_LINK анализируй отдельно: он может обновлять существующий заказ и сам по себе не доказывает создание новой заявки.',
-            'Тексты переписки здесь НЕ отдаются — по каждому conversationId вызывай besales_dialogue_transcript.',
-            'lastWaveSentAt / firstPaidAt / paidAmount — LIFETIME-маркеры контакта, а НЕ одна цепочка: это ПОСЛЕДНЯЯ волна, ПЕРВАЯ оплата и сумма всех прямых оплат. У контакта с несколькими волнами разность firstPaidAt − lastWaveSentAt может выйти отрицательной — вычитать их нельзя.',
-            'Для атрибуции оплаты к конкретной волне бери когортные цифры из besales_broadcast_analytics_get: там оплаты считаются переходами относительно даты волны.',
-            'firstPaidAt/paidAmount заполняются только для GetCourse и только при наличии scope read:analytics; null означает «неизвестно», а не «не платил». paidAmount — прямые оплаты по реестру, косвенные (подтверждённые оператором) в него не входят.',
-            'MCP файлы не пишет: сохрани результаты локально сам (по файлу на диалог).',
-        ]),
+        enhanceResponse: (response, input) => input.source === 'inbox'
+            ? withInstructions(response, [
+                'Входящие: purchased=true — успешный заказ агента ИЛИ текущая продажная стадия; false — нет обоих признаков. Это не оплата; has_payment — отдельный фильтр.',
+                'hasPurchase в строке, отбор и итоги считает сервер до пагинации. С channel_id область ограничена каналом, без него — видимыми каналами человека. Не вычисляй покупку по hasPayment.',
+                'Если cursor непустой, повтори source=inbox с теми же фильтрами и cursor. with_totals возвращает ограниченные итоги только первой страницы; capped=true означает 999+, а не точный итог.',
+            ])
+            : withInstructions(response, [
+                'Манифест подходящих диалогов: { data: DialogueExportItem[], total, cursor }. total — число ДИАЛОГОВ, а не заявок: в одном диалоге их бывает несколько, считай заявки по транскрипту.',
+                'Пагинация: если cursor не null — повтори тот же вызов с этим cursor, пока не соберёшь все диалоги.',
+                'Для аудита новых заявок используй action_type=["GETCOURSE_CREATE_DEAL"] и action_execution_mode="production" БЕЗ action_success и считай исходы шагов по транскрипту: action_success=true отсекает провалы и неизвестные исходы, которым нужен REVIEW. Успешный шаг с reusedOpenInvoice=true использовал открытый счёт: нового заказа нет. Тип, успех и окно дат сходятся на ОДНОМ шаге одного исполнения, окно — по времени исполнения.',
+                'action_success БЕЗ action_type — по исходу исполнения: true — действие ВЫПОЛНЕНО по-настоящему (outcome=DONE в транскрипте; действие, все МЕНЯЮЩИЕ шаги которого пропущены защитой, успехом не считается, хотя его status=SUCCEEDED), false — всё невыполненное: пропуск, сбой, незавершённое. С action_type пропуск шага не считается ни успехом, ни провалом.',
+                'GETCOURSE_SEND_PAYMENT_LINK анализируй отдельно: он может обновлять существующий заказ и сам по себе не доказывает создание новой заявки.',
+                'Тексты переписки здесь НЕ отдаются — по каждому conversationId вызывай besales_dialogue_transcript.',
+                'lastWaveSentAt / firstPaidAt / paidAmount — LIFETIME-маркеры контакта, а НЕ одна цепочка: это ПОСЛЕДНЯЯ волна, ПЕРВАЯ оплата и сумма всех прямых оплат. У контакта с несколькими волнами разность firstPaidAt − lastWaveSentAt может выйти отрицательной — вычитать их нельзя.',
+                'Метки lastWaveSentAt / firstPaidAt / paidAmount / lastWorkLogEvent считаются по ЧЕЛОВЕКУ через все его каналы: у человека с двумя диалогами обе строки несут одни и те же значения — не складывай их.',
+                'Для атрибуции оплаты к конкретной волне бери когортные цифры из besales_broadcast_analytics_get: там оплаты считаются переходами относительно даты волны.',
+                'firstPaidAt/paidAmount заполняются только для GetCourse и только при наличии scope read:analytics; null означает «неизвестно», а не «не платил». paidAmount — прямые оплаты по реестру, косвенные (подтверждённые оператором) в него не входят.',
+                'MCP файлы не пишет: сохрани результаты локально сам (по файлу на диалог).',
+            ]),
     }),
     defineTool({
         name: 'besales_dialogue_transcript',
+        carriesCustomerData: true,
         sideEffect: 'none',
         closedWorld: true,
         requiredFields: ['conversation_id'],
@@ -130,7 +187,7 @@ export const dialogueExportTools = [
         schema: z
             .object({
             workspace_id: uuidSchema.optional(),
-            // ID диалога = conversationId из манифеста (ChatUser.id).
+            // ID диалога = conversationId из манифеста.
             conversation_id: uuidSchema,
             limit: z.number().int().min(1).max(100).optional(),
             cursor: z.string().optional(),
@@ -151,15 +208,15 @@ export const dialogueExportTools = [
             };
         },
         enhanceResponse: (response) => withInstructions(response, [
-            'Транскрипт диалога: { conversationId, channelType, contactName, turns[], triggerExecutions[], transcriptMarkdown, cursor }.',
+            'Транскрипт диалога: { conversationId, turns[], actionExecutions[], transcriptMarkdown, cursor }.',
             'Сохрани transcriptMarkdown в ОТДЕЛЬНЫЙ файл на диалог, напр. dialogs/<conversationId>.md.',
-            'Роли реплик: client (клиент) / agent. Автора исходящего бери из turn.authorType: AI_AGENT — ответ модели, AUTOMATION — наша рассылка/follow-up/приветствие, HUMAN_OPERATOR — живой человек.',
-            'НЕ считай исходящее операторским по isAi=false: у автоматики он тоже false. Вывод «продажу дожал человек» делай только по authorType=HUMAN_OPERATOR.',
-            'authorType=null — сообщение клиента ИЛИ строка старше 2026-07-20 без разметки; для таких автора считай неизвестным, а не оператором.',
-            'turn.sentAt у agent — фактическое время отправки ответа. У строк старше 2026-07-20 оно равно времени реплики клиента, поэтому интервал «наш ответ → ответ клиента» на старом периоде не вычисляется (получится ноль).',
-            'turn.delivered=false — реплика записана в историю, но клиенту НЕ отправлена (тихий режим, не влезший ответ). Такие реплики исключай из подсчёта касаний и интервалов: их sentAt — время строки, а не отправки.',
-            'turn.messageId связывает реплику с triggerExecutions.messageId. В actions есть type/success/time и только безопасный resultSummary; сырой result не отдаётся.',
-            'Если cursor не null — у диалога есть ещё сообщения: повтори с этим cursor. Первая страница содержит заголовок; последующие — только реплики: дописывай их в тот же файл.',
+            'turn.role: client, agent, operator или automation; isAi=true только у agent.',
+            'turn.delivered=false — исходящее не было доставлено, исключай его из подсчёта касаний.',
+            'actionExecutions — исполнения действий ЭТОЙ страницы, каждое ровно на одной странице. У исполнения: actionName, status, startedAt, triggerMessageId (реплика человека, начавшая ход), responseMessageId (ответ того же прогона) и steps[] — stepType, status, outcomeUnknown, dealId, dealNumber.',
+            'Новый заказ = шаг stepType=GETCOURSE_CREATE_DEAL со status=OK, reusedOpenInvoice=false, без outcomeUnknown и startedAt исполнения в периоде. reusedOpenInvoice=true означает успешное переиспользование открытого счёта, но нового заказа нет; status=SKIPPED — дубль, нового заказа тоже нет. Шаг с outcomeUnknown=true — исход неизвестен, пометь REVIEW. abandoned=true — неизвестен исход только незавершённого шага: OK-шаг с номером сделки в том же исполнении остаётся подтверждённым.',
+            'У исполнения есть исход для человека: outcome (DONE — выполнено, SKIPPED — пропущено, FAILED — сбой, UNKNOWN — исход неизвестен), outcomeLabel, skipReasons (code + label), noEffect (выполнено без изменений), emptyInputs (поля, которые действие берёт из разговора и которые остались пустыми, — названиями для человека; только у DONE, outcomeLabel их уже называет), stepsDone/stepsTotal. status=SUCCEEDED у действия, все МЕНЯЮЩИЕ шаги которого пропущены защитой, — не «выполнено»: смотри outcome. Человеку показывай подписи (outcomeLabel, skipReasons[].label), а не коды.',
+            'runId=null и пустые triggerMessageId/responseMessageId значат «прогон неизвестен» (ручной запуск, перенесённая строка, ход без ответа), а не «действий не было»: связь с репликами тогда определяй по времени — строка действия в transcriptMarkdown уже стоит между репликами по startedAt.',
+            'Если cursor не null — у диалога есть ещё сообщения: повтори с этим cursor. Первая страница содержит заголовок; последующие — реплики и строки действий без заголовка: дописывай их в тот же файл.',
         ]),
     }),
 ];

package/dist/tools/definitions/dialogue-export.js.map

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

package/dist/tools/definitions/dialogue-followup-state.d.ts

@@ -0,0 +1,9 @@
+/** API сам разрешает пару contact × channel и проверяет доступ к диалогу. */
+export declare const dialogueFollowupStateTools: (import("./shared.js").ToolDefinition<{
+    conversation_id: string;
+}> | import("./shared.js").ToolDefinition<{
+    conversation_id: string;
+    action: "MUTE_FOREVER" | "MUTE_TEMPORARY" | "ENABLE";
+    expected_version: string;
+    mute_expires_at?: string | undefined;
+}>)[];

package/dist/tools/definitions/dialogue-followup-state.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { compactObject, defineTool, uuidSchema, withInstructions } from './shared.js';
+const resultPolicy = {
+    neverTruncate: true,
+    narrowingHint: 'Читай состояние одного диалога; последствия и ограничения нужны целиком.',
+};
+/** API сам разрешает пару contact × channel и проверяет доступ к диалогу. */
+export const dialogueFollowupStateTools = [
+    defineTool({
+        name: 'besales_dialogue_followup_state_get',
+        sideEffect: 'none',
+        closedWorld: true,
+        requiredFields: ['conversation_id'],
+        resultPolicy,
+        schema: z.object({ conversation_id: uuidSchema }).strict(),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/conversations/${input.conversation_id}/followup-state`,
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Покажи persisted, effective на measuredAt, editVersion, allowedActions, consequences и blockers из ответа сервера. Не выводи состояние дожимов из botState или наличия цепочки.',
+            'NONE — ось включена, FOREVER — выключена, TEMPORARY — пауза до expiresAt. Включение не воскрешает отменённый run и не возвращает одноразовые права.',
+            'Состояние относится к паре contact × channel. Оно не меняет ответы агента, назначение оператора, бан или очередь рассылки; уже доставленное не отзывается.',
+            'externalConstraints=NOT_CHECKED и processPause=UNAVAILABLE не обещают отправку или сохранение шага. Сохраняй тексты последствий сервера на его языке.',
+            '403 — нет права чтения, 404 — диалог недоступен, 503 — состояние неизвестно: не подменяй отказ состоянием NONE.',
+            'Для записи используй besales_dialogue_followup_state_update с editVersion из этого чтения в expected_version. Сначала покажи человеку последствия и ограничения выбранного действия; выполняй только его явное решение.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_dialogue_followup_state_update',
+        sideEffect: 'write',
+        closedWorld: true,
+        verifyWithToolName: 'besales_dialogue_followup_state_get',
+        requiredFields: ['conversation_id', 'action', 'expected_version'],
+        resultPolicy,
+        schema: z
+            .object({
+            conversation_id: uuidSchema,
+            action: z.enum(['ENABLE', 'MUTE_FOREVER', 'MUTE_TEMPORARY']),
+            expected_version: z.string().min(1).max(1024),
+            mute_expires_at: z.iso.datetime({ offset: true }).max(64).optional(),
+        })
+            .strict()
+            .superRefine((input, context) => {
+            if ((input.action === 'MUTE_TEMPORARY') !== (input.mute_expires_at !== undefined)) {
+                context.addIssue({
+                    code: 'custom',
+                    path: ['mute_expires_at'],
+                    message: 'MUTE_TEMPORARY requires mute_expires_at; other actions forbid it',
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/conversations/${input.conversation_id}/followup-state/bridge`,
+            body: compactObject({
+                action: input.action,
+                expectedVersion: input.expected_version,
+                muteExpiresAt: input.mute_expires_at,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Покажи outcome и state целиком: состояние, новую editVersion, последствия и ограничения. Сохраняй тексты сервера на его языке.',
+            '409/428: сохрани намерение человека, перечитай besales_dialogue_followup_state_get, покажи изменившиеся последствия. Повторяй запись только после нового явного решения человека с прочитанной версией; автоматически не повторяй.',
+            'При неизвестном исходе сначала прочитай состояние. Включение не воскрешает отменённые касания; уже доставленное не отзывается.',
+        ]),
+    }),
+];
+//# sourceMappingURL=dialogue-followup-state.js.map

package/dist/tools/definitions/dialogue-followup-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue-followup-state.js","sourceRoot":"","sources":["../../../src/tools/definitions/dialogue-followup-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,YAAY,GAAG;IACnB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,0EAA0E;CACjF,CAAC;AAEX,6EAA6E;AAC7E,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,UAAU,CAAC;QACT,IAAI,EAAE,qCAAqC;QAC3C,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,CAAC,iBAAiB,CAAC;QACnC,YAAY;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1D,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB,KAAK,CAAC,eAAe,iBAAiB;SAC/D,CAAC;QACF,eAAe,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC5B,gBAAgB,CAAC,QAAQ,EAAE;YACzB,iLAAiL;YACjL,qJAAqJ;YACrJ,4JAA4J;YAC5J,uJAAuJ;YACvJ,iHAAiH;YACjH,yNAAyN;SAC1N,CAAC;KACL,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,wCAAwC;QAC9C,UAAU,EAAE,OAAO;QACnB,WAAW,EAAE,IAAI;QACjB,kBAAkB,EAAE,qCAAqC;QACzD,cAAc,EAAE,CAAC,iBAAiB,EAAE,QAAQ,EAAE,kBAAkB,CAAC;QACjE,YAAY;QACZ,MAAM,EAAE,CAAC;aACN,MAAM,CAAC;YACN,eAAe,EAAE,UAAU;YAC3B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;YAC5D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;YAC7C,eAAe,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SACrE,CAAC;aACD,MAAM,EAAE;aACR,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,EAAE,CAAC;gBAClF,OAAO,CAAC,QAAQ,CAAC;oBACf,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,iBAAiB,CAAC;oBACzB,OAAO,EAAE,kEAAkE;iBAC5E,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QACJ,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzB,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,kBAAkB,KAAK,CAAC,eAAe,wBAAwB;YACrE,IAAI,EAAE,aAAa,CAAC;gBAClB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,eAAe,EAAE,KAAK,CAAC,gBAAgB;gBACvC,aAAa,EAAE,KAAK,CAAC,eAAe;aACrC,CAAC;SACH,CAAC;QACF,eAAe,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC5B,gBAAgB,CAAC,QAAQ,EAAE;YACzB,gIAAgI;YAChI,oOAAoO;YACpO,gIAAgI;SACjI,CAAC;KACL,CAAC;CACH,CAAC"}

package/dist/tools/definitions/edit-version-transport.test-fixtures.d.ts

@@ -0,0 +1,13 @@
+interface Case {
+    readonly name: string;
+    readonly variant?: string;
+    readonly input: Record<string, unknown>;
+    readonly method: 'PATCH' | 'POST' | 'PUT' | 'DELETE';
+    readonly path: string;
+    readonly body?: Record<string, unknown>;
+    readonly version: string;
+    readonly required: readonly string[];
+}
+export declare const versionTransportCases: readonly Case[];
+export declare function assertVersionTransport(row: Case): Promise<void>;
+export {};

package/dist/tools/definitions/edit-version-transport.test-fixtures.js

@@ -0,0 +1,292 @@
+import assert from 'node:assert/strict';
+import { platformSetupTools } from './platform-setup.js';
+import { crmPlatformTools } from './crm-platform.js';
+import { variableTools } from './variables.js';
+import { executeToolRequests } from '../follow-up-request.js';
+import { ApiClient, ApiClientError } from '../../http/api-client.js';
+import registry from '../../schemas/mcp-tools.json' with { type: 'json' };
+const registered = registry;
+const channel = '00000000-0000-4000-8000-000000000002';
+const resource = '00000000-0000-4000-8000-000000000003';
+const settingsVersion = '00000000-0000-4000-8000-000000000004';
+const routing = `rs1.c.workspace.${resource}.${channel}.${resource}.7.1`;
+export const versionTransportCases = [
+    {
+        name: 'besales_followup_step_message_set',
+        input: {
+            platform_id: channel,
+            sequence_id: resource,
+            step_index: 0,
+            content: 'new',
+            expected_content: '',
+        },
+        method: 'PATCH',
+        path: `/channels/${channel}/followup-sequences/${resource}/steps/0/message`,
+        body: { content: 'new', expectedContent: '' },
+        version: '7',
+        required: ['platform_id', 'sequence_id', 'step_index', 'content', 'expected_content'],
+    },
+    {
+        name: 'besales_router_update',
+        input: {
+            platform_id: channel,
+            additional_prompt: null,
+            skip_llm_routing: false,
+            explicit_confirmation: true,
+            confirmation_reason: 'approved',
+        },
+        method: 'PATCH',
+        path: `/channels/${channel}/router`,
+        body: {
+            additionalPrompt: null,
+            skipLlmRouting: false,
+            explicitConfirmation: true,
+            confirmationReason: 'approved',
+        },
+        version: routing,
+        required: ['platform_id'],
+    },
+    ...[false, true].map((update) => ({
+        name: 'besales_routing_rule_upsert',
+        variant: update ? 'update' : 'create',
+        input: {
+            platform_id: channel,
+            ...(update ? { routing_rule_id: resource } : {}),
+            routing_strategy: 'LEAD_STATUS',
+            custom_router_prompt: '',
+            is_enabled: false,
+            direct_agent_id: null,
+        },
+        method: update ? 'PATCH' : 'POST',
+        path: `/channels/${channel}/router/routing-rules`,
+        body: {
+            ...(update ? { routingRuleId: resource } : {}),
+            routingStrategy: 'LEAD_STATUS',
+            customRouterPrompt: '',
+            isEnabled: false,
+            directAgentId: null,
+        },
+        version: routing,
+        required: ['platform_id', 'routing_strategy', 'custom_router_prompt'],
+    })),
+    {
+        name: 'besales_behavior_update',
+        input: { platform_id: channel },
+        method: 'PATCH',
+        path: `/channels/${channel}/behavior`,
+        body: {},
+        version: routing,
+        required: ['platform_id'],
+    },
+    {
+        name: 'besales_pipeline_settings_update',
+        input: { platform_id: channel },
+        method: 'PATCH',
+        path: `/channels/${channel}/pipeline-settings`,
+        body: {},
+        version: routing,
+        required: ['platform_id'],
+    },
+    {
+        name: 'besales_platform_settings_update',
+        input: { platform_id: channel, general_settings: { is_ai_enabled: false } },
+        method: 'PATCH',
+        path: `/channels/${channel}/settings`,
+        body: { generalSettings: { isAiEnabled: false } },
+        version: routing,
+        required: ['platform_id'],
+    },
+    {
+        name: 'besales_platform_pipeline_link',
+        input: { platform_id: channel, pipeline_id: 1, pipeline_crm_id: resource, sort: 0 },
+        method: 'POST',
+        path: `/channels/${channel}/active-pipelines`,
+        body: { pipelineId: 1, pipelineCrmId: resource, sort: 0 },
+        version: routing,
+        required: ['platform_id', 'pipeline_id', 'pipeline_crm_id'],
+    },
+    {
+        name: 'besales_platform_pipeline_unlink',
+        input: { platform_id: channel, platform_pipeline_id: resource, explicit_confirmation: true },
+        method: 'DELETE',
+        path: `/channels/${channel}/active-pipelines/${resource}`,
+        body: { explicitConfirmation: true },
+        version: routing,
+        required: ['platform_id', 'platform_pipeline_id', 'explicit_confirmation'],
+    },
+    ...['CHANNEL', 'WORKSPACE'].flatMap((scope) => [
+        {
+            name: 'besales_variable_update',
+            variant: scope,
+            input: {
+                variable_id: resource,
+                scope,
+                ...(scope === 'CHANNEL'
+                    ? { platform_id: channel, constant_value: null, repeat_constant_value: null }
+                    : { value: null }),
+            },
+            method: 'PATCH',
+            path: `/variables/${resource}`,
+            body: { defaultValue: null, ...(scope === 'CHANNEL' ? { repeatConstantValue: null } : {}) },
+            version: resource,
+            required: ['variable_id', 'scope'],
+        },
+        {
+            name: 'besales_variable_delete',
+            variant: scope,
+            input: {
+                variable_id: resource,
+                scope,
+                ...(scope === 'CHANNEL' ? { platform_id: channel } : {}),
+                explicit_confirmation: true,
+            },
+            method: 'DELETE',
+            path: `/variables/${resource}?confirm=true`,
+            version: resource,
+            required: ['variable_id', 'scope', 'explicit_confirmation'],
+        },
+    ]),
+    {
+        name: 'besales_agent_update',
+        input: {
+            platform_id: channel,
+            agent_id: resource,
+            description: null,
+            use_global_history: false,
+            agent_variable_overrides: [],
+            agent_workspace_variable_overrides: [],
+        },
+        method: 'PATCH',
+        path: `/channels/${channel}/agents/${resource}`,
+        body: {
+            description: null,
+            useGlobalHistory: false,
+            agentVariableOverrides: [],
+            agentWorkspaceVariableOverrides: [],
+        },
+        version: settingsVersion,
+        required: ['platform_id', 'agent_id'],
+    },
+    {
+        name: 'besales_agent_facts_set',
+        input: { agent_id: resource, factual_context: 'F1' },
+        method: 'PUT',
+        path: `/agents/${resource}/facts`,
+        body: { factualContext: 'F1' },
+        version: resource,
+        required: ['agent_id', 'factual_context'],
+    },
+];
+const definitions = [
+    ...platformSetupTools,
+    ...crmPlatformTools,
+    ...variableTools,
+];
+export async function assertVersionTransport(row) {
+    const tool = definitions.find((tool) => tool.name === row.name);
+    assert.ok(tool, row.name);
+    const contract = registered.tools.find((tool) => tool.name === row.name);
+    assert.ok(contract, row.name);
+    assert.deepEqual(tool.requiredFields, row.required, 'required arguments unchanged');
+    assert.deepEqual([...contract.inputSchema.required].sort(), [...row.required].sort());
+    const legacy = tool.schema.safeParse(row.input);
+    assert.equal(legacy.success, true, 'legacy control parses');
+    const expected = {
+        method: row.method,
+        path: row.path,
+        ...(row.body === undefined ? {} : { body: row.body }),
+    };
+    assert.deepEqual(tool.createRequest(legacy.data), expected, 'legacy body, confirmation, null and false unchanged');
+    const input = { ...row.input, expected_version: row.version };
+    const parsed = tool.schema.safeParse(input);
+    assert.equal(parsed.success, true, 'original expected_version accepted');
+    const request = tool.createRequest(parsed.data);
+    assert.deepEqual(request, row.method === 'DELETE'
+        ? { ...expected, ifMatch: row.version }
+        : { ...expected, body: { ...row.body, expectedVersion: row.version } }, 'original token reaches the request');
+    for (const value of [null, 7, ''])
+        assert.equal(tool.schema.safeParse({ ...input, expected_version: value }).success, false);
+    if (row.version.length === resource.length)
+        assert.equal(tool.schema.safeParse({ ...input, expected_version: 'not-a-uuid' }).success, false);
+    if ([
+        'besales_followup_step_message_set',
+        'besales_behavior_update',
+        'besales_pipeline_settings_update',
+        'besales_platform_settings_update',
+        'besales_platform_pipeline_link',
+        'besales_platform_pipeline_unlink',
+        'besales_variable_update',
+        'besales_variable_delete',
+    ].includes(row.name))
+        assert.equal(tool.schema.safeParse({ ...input, surprise: true }).success, false, 'closed schema stays closed');
+    assert.ok('expected_version' in contract.inputSchema.properties, 'registered schema exposes expected_version');
+    assert.equal(contract.inputSchema.properties.expected_version.type, 'string');
+    assert.ok(!contract.inputSchema.required.includes('expected_version'), 'version stays optional');
+    assert.ok(contract.description.includes('без автоматического повтора'), 'description forbids automatic retry');
+    const response = JSON.stringify(tool.enhanceResponse?.({}, parsed.data));
+    assert.ok(response?.includes('409'), 'response describes conflicts');
+    assert.ok(response?.includes('явного решения человека'), 'human decision after conflict');
+    assert.ok(!response?.includes('повтори с его текущим текстом'), 'no stale edit replay instruction');
+    if (row.name === 'besales_followup_step_message_set')
+        assert.equal(tool.schema.safeParse({ ...input, expected_content: undefined }).success, false, 'text oracle still required');
+    if (row.method === 'DELETE')
+        assert.equal(tool.schema.safeParse({ ...input, explicit_confirmation: undefined }).success, false, 'destructive confirmation still required');
+    if (row.name === 'besales_agent_update') {
+        const both = tool.schema.safeParse({ ...input, expected_routing_version: routing });
+        assert.equal(both.success, true, 'separate Routing version accepted');
+        assert.deepEqual(tool.createRequest(both.data).body, {
+            ...row.body,
+            expectedVersion: settingsVersion,
+            expectedRoutingVersion: routing,
+        });
+        assert.equal(contract.inputSchema.properties.expected_routing_version?.type, 'string');
+        assert.ok(!contract.inputSchema.required.includes('expected_routing_version'));
+        assert.equal(tool.schema.safeParse({ ...input, expected_version: routing }).success, false, 'Routing is not a settings token');
+        for (const value of [null, 7, '']) {
+            assert.equal(tool.schema.safeParse({ ...input, expected_routing_version: value }).success, false);
+        }
+    }
+    const sent = [];
+    const client = new ApiClient({
+        apiBaseUrl: 'https://example.test/api/v2',
+        locale: 'ru',
+        transport: {
+            async request(wire) {
+                sent.push(wire);
+                return { status: 200, data: {} };
+            },
+        },
+    });
+    await executeToolRequests(client, 'fixture-key', request, undefined);
+    assert.equal(sent.length, 1, 'one write, no server-read token substitution');
+    assert.equal(sent[0].method, row.method);
+    assert.equal(new URL(sent[0].url).pathname + new URL(sent[0].url).search, '/api/v2' + row.path);
+    assert.deepEqual(sent[0].data, request.body);
+    assert.equal(sent[0].headers['If-Match'], row.method === 'DELETE' ? `"${row.version}"` : undefined, 'strong original header reaches HTTP');
+    assert.equal(sent[0].headers.Authorization, 'Bearer fixture-key');
+    assert.equal(sent[0].headers['Accept-Language'], 'ru');
+    assert.ok(sent[0].headers['Cache-Control'].includes('no-store'));
+    if (row.method === 'DELETE') {
+        await executeToolRequests(client, 'fixture-key', { ...request, idempotencyKey: resource }, undefined);
+        assert.equal(sent[1].headers['If-Match'], `"${row.version}"`);
+        assert.equal(sent[1].headers['Idempotency-Key'], resource, 'independent intent headers coexist');
+    }
+    sent.length = 0;
+    await executeToolRequests(client, 'fixture-key', tool.createRequest(legacy.data), undefined);
+    assert.equal(sent.length, 1);
+    assert.equal(sent[0].headers['If-Match'], undefined, 'legacy request has no version header');
+    let calls = 0;
+    const conflict = new ApiClientError('conflict', 409);
+    await assert.rejects(executeToolRequests({
+        async request() {
+            calls++;
+            throw conflict;
+        },
+        async post() {
+            calls++;
+            throw conflict;
+        },
+    }, 'fixture-key', request, undefined), (error) => error === conflict);
+    assert.equal(calls, 1, '409 is never retried or refreshed');
+}
+//# sourceMappingURL=edit-version-transport.test-fixtures.js.map