@besales/mcp 0.46.0 → 0.47.0

package/dist/tools/result.js

@@ -1,29 +1,178 @@
 import { ErrorCode, McpError, } from '@modelcontextprotocol/sdk/types.js';
 import { ZodError } from 'zod';
 import { WorkspaceResolutionError } from '../auth/connection-store.js';
-import { ApiClientError, ApiClientNetworkError } from '../http/api-client.js';
-export function jsonToolResult(value) {
+import { ApiClientError, ApiClientNetworkError, } from '../http/api-client.js';
+import { IncompleteListError } from './incomplete-list.js';
+import { isEnvelopeEnabled, shapeErrorMessage, shapeToolResult, } from './result-envelope.js';
+/**
+ * Единственный формат успешного ответа инструмента.
+ *
+ * ⚠️ Функция обязана быть ТОТАЛЬНОЙ. Она выполняется ПОСЛЕ успешной мутации: если она
+ * бросит, вызывающий увидит ошибку инструмента и повторит платный побочный эффект. Поэтому
+ * любой внутренний сбой форматирования отдаёт минимальную квитанцию — и БЕЗ `isError`,
+ * иначе получилось бы то же самое приглашение повторить.
+ */
+export function jsonToolResult(value, policy, sideEffect = 'write') {
+    let shaped;
+    try {
+        shaped = shapeToolResult(value, policy, isEnvelopeEnabled());
+    }
+    catch {
+        const receipt = { ...identityOf(value), _mcpFormattingFailed: true };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(receipt),
+                },
+            ],
+            ...(isEnvelopeEnabled() ? { structuredContent: receipt } : {}),
+        };
+    }
+    if (!shaped.refused) {
+        if (!isEnvelopeEnabled())
+            return { content: [{ type: 'text', text: shaped.text }] };
+        const structuredContent = structuredResult(shaped.text);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(structuredContent) }],
+            structuredContent,
+        };
+    }
+    // ⚠️ Отказ по размеру — ошибка ТОЛЬКО у читающего инструмента: там он означает «сузьте
+    // запрос и позовите снова». У мутирующего к этому моменту побочный эффект УЖЕ состоялся,
+    // и признак ошибки был бы приглашением повторить его — второй клон агента, вторая рассылка.
+    // Поэтому наружу уходит неошибочная квитанция с идентификаторами и объяснением.
+    if (sideEffect !== 'none') {
+        const receipt = {
+            ...identityOf(value),
+            _mcpOversized: true,
+            _mcpNote: `Операция ВЫПОЛНЕНА, но её ответ не помещается в потолок и не показан целиком. Повторный вызов выполнит операцию ЗАНОВО. ${shaped.text}`,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(receipt),
+                },
+            ],
+            structuredContent: receipt,
+        };
+    }
+    return { isError: true, content: [{ type: 'text', text: shaped.text }] };
+}
+/**
+ * Что вернуть, когда сериализовать ответ не удалось: идентификаторы созданной сущности, если
+ * они видны на верхнем уровне. Без них вызывающий не смог бы даже сослаться на результат
+ * уже состоявшейся мутации.
+ */
+export function identityOf(value) {
+    const identity = {};
+    const identityKeys = new Set([
+        'id',
+        'operationId',
+        'operation_id',
+        'runId',
+        'run_id',
+        'jobId',
+        'job_id',
+        'draftId',
+        'draft_id',
+        'setupRef',
+        'setup_ref',
+    ]);
+    const pending = [{ value, depth: 0 }];
+    const seen = new Set();
+    while (pending.length > 0) {
+        const current = pending.shift();
+        if (!current || current.depth > 4 || typeof current.value !== 'object' || current.value === null) {
+            continue;
+        }
+        if (seen.has(current.value))
+            continue;
+        seen.add(current.value);
+        const entries = Array.isArray(current.value)
+            ? current.value.map((item, index) => [String(index), item])
+            : Object.entries(current.value);
+        for (const [key, candidate] of entries) {
+            if (identityKeys.has(key) &&
+                identity[key] === undefined &&
+                (typeof candidate === 'string' || typeof candidate === 'number')) {
+                identity[key] = candidate;
+            }
+            if (typeof candidate === 'object' && candidate !== null) {
+                pending.push({ value: candidate, depth: current.depth + 1 });
+            }
+        }
+    }
+    return identity;
+}
+/** Безошибочная квитанция, когда API уже ответил, а локальная постобработка сломалась. */
+export function acceptedResponseReceipt(value, _cause) {
+    const receipt = {
+        ...identityOf(value),
+        _mcpPostprocessingFailed: true,
+        _mcpNote: 'API принял операцию, но MCP не смог обработать полученный ответ. Не повторяйте мутацию; проверьте созданный объект по квитанции.',
+        _mcpCause: 'local_postprocessing_failed',
+    };
     return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify(value, null, 2),
-            },
-        ],
+        content: [{ type: 'text', text: JSON.stringify(receipt) }],
+        ...(isEnvelopeEnabled() ? { structuredContent: receipt } : {}),
     };
 }
-export function errorToolResult(message) {
+function structuredResult(text) {
+    const value = JSON.parse(text);
+    if (Array.isArray(value))
+        return { items: value };
+    if (typeof value === 'object' && value !== null)
+        return value;
+    return { value };
+}
+export function errorToolResult(message, structuredError) {
     return {
         isError: true,
         content: [
             {
                 type: 'text',
-                text: message,
+                // Сообщение бэкенда ничем не ограничено и попадало наружу как есть. Обрезка — часть
+                // конверта, поэтому она под тем же флагом: пакет ставится без версии (`npx -y`), и
+                // изменение формы ответа не должно доезжать до пользователей само.
+                text: isEnvelopeEnabled() ? shapeErrorMessage(message) : message,
             },
         ],
+        ...(structuredError ? { structuredContent: { error: structuredError } } : {}),
     };
 }
-export function mapToolError(error, restartToolName, workspaceId) {
+/**
+ * Мог ли вызов оставить след, которого мы не видим.
+ *
+ * Читающий инструмент — нет; идемпотентный — след есть, но повтор его не удвоит. Всё
+ * остальное: запрос ушёл, ответа нет, и отсутствие подтверждения НЕ доказывает, что операция
+ * не состоялась.
+ */
+function outcomeIsAmbiguous(context) {
+    return context.sideEffect !== 'none' && context.idempotent !== true;
+}
+/**
+ * Ответ на неоднозначный исход: ни `isError`-совета «попробуйте позже», ни тишины.
+ *
+ * ⛔ Совет повторить здесь опаснее самой ошибки: повторное создание заведёт вторую сущность,
+ * повторный запуск волны отправит сообщения людям второй раз, повторный перевыпуск отзовёт
+ * ключ, который партнёр только что получил. Поэтому текст называет проверку, а не повтор.
+ */
+function ambiguousOutcomeResult(cause, context) {
+    const verify = context.verifyWithToolName
+        ? `Сверьтесь через \`${context.verifyWithToolName}\`.`
+        : 'Сверьтесь состоянием на стороне Besales (списком или *_status-инструментом этой операции).';
+    const message = `OUTCOME_UNKNOWN: ${cause} Запрос ушёл, ответа нет — операция могла СОСТОЯТЬСЯ. ` +
+        `Не повторяйте вызов: повтор ${context.sideEffect === 'spend' ? 'заплатит второй раз' : 'заведёт второй экземпляр'}. ${verify}`;
+    return errorToolResult(message, {
+        code: 'OUTCOME_UNKNOWN',
+        message,
+        continuation: verify,
+        requestIdentity: context.requestIdentity,
+    });
+}
+export function mapToolError(error, context = { sideEffect: 'none' }, workspaceId) {
     if (error instanceof ZodError) {
         throw new McpError(ErrorCode.InvalidParams, formatZodError(error));
     }
@@ -32,11 +181,20 @@ export function mapToolError(error, restartToolName, workspaceId) {
     if (error instanceof WorkspaceResolutionError) {
         return errorToolResult(error.message);
     }
+    // Отказ отдать неполный список — это «позови снова, попросив страницу», а не внутренний
+    // сбой: ветка Error ниже превратила бы его в InternalError и спрятала бы объяснение.
+    if (error instanceof IncompleteListError) {
+        return errorToolResult(error.message);
+    }
     if (error instanceof ApiClientError) {
-        return mapApiClientError(error, restartToolName, workspaceId);
+        return mapApiClientError(error, context, workspaceId);
     }
     if (error instanceof ApiClientNetworkError) {
-        return errorToolResult(`Animaly API network error: ${error.message}`);
+        // Обрыв связи — самый неоднозначный из исходов: запрос мог дойти и выполниться целиком,
+        // а потерян только ответ.
+        return outcomeIsAmbiguous(context)
+            ? ambiguousOutcomeResult(`связь с Besales оборвалась (${error.message}).`, context)
+            : errorToolResult(`Besales API network error: ${error.message}`);
     }
     if (error instanceof McpError) {
         throw error;
@@ -46,42 +204,86 @@ export function mapToolError(error, restartToolName, workspaceId) {
     }
     throw new McpError(ErrorCode.InternalError, 'Unknown tool execution error');
 }
-function mapApiClientError(error, restartToolName, workspaceId) {
+function mapApiClientError(error, context, workspaceId) {
     if (!error.status) {
         return errorToolResult('Not connected to Animaly. Run `besales-mcp connect` first.');
     }
     if (error.status >= 500) {
-        return errorToolResult(`Animaly API is temporarily unavailable (${error.status}). Try again later.`);
+        // ⚠️ Пятисотый — это отказ ПОСЛЕ того, как запрос дошёл до сервера. Он мог упасть на
+        // ответе, на записи в очередь или на пути назад, уже совершив основную работу.
+        return outcomeIsAmbiguous(context)
+            ? ambiguousOutcomeResult(`Besales ответил ошибкой ${error.status}.`, context)
+            : apiErrorResult(error, `Besales API is temporarily unavailable (${error.status}). Try again later.`, 'Повтори читающий или доказанно идемпотентный вызов позже.');
     }
     if (error.status === 401) {
-        return errorToolResult(workspaceId
+        const message = workspaceId
             ? `Animaly rejected stored credentials for workspace ${workspaceId}. Run \`besales-mcp connect\` again for it.`
-            : 'Animaly rejected stored credentials. Run `besales-mcp connect` again.');
+            : 'Animaly rejected stored credentials. Run `besales-mcp connect` again.';
+        return apiErrorResult(error, message, 'Переподключи этот workspace и повтори только после успешного connect.');
     }
     if (error.status === 403) {
         // Сообщение бэкенда НАЗЫВАЕТ недостающий scope, и оно важнее нашей догадки: композит
         // `mcp:*` покрывает не все эндпоинты (например, cold-welcome требует `read:campaigns`),
         // и подсказка про `mcp:*`/`mcp:platform-setup` там уводит в ложный диагноз «ключ не тот».
-        return errorToolResult(error.responseMessage
+        const message = error.responseMessage
             ? `Animaly rejected this request: ${error.responseMessage}`
-            : 'Animaly rejected this request: the stored key lacks the scope this endpoint requires.');
+            : 'Animaly rejected this request: the stored key lacks the scope this endpoint requires.';
+        return apiErrorResult(error, message, 'Добавь недостающий scope через connect, не заменяя уже выданные права.');
     }
     if (error.status === 410) {
-        return errorToolResult(restartToolName
-            ? `Operation expired. Restart from \`${restartToolName}\` and submit the new operation.`
-            : 'Operation expired. Restart from the matching get_instructions tool.');
+        const message = context.restartToolName
+            ? `Operation expired. Restart from \`${context.restartToolName}\` and submit the new operation.`
+            : 'Operation expired. Restart from the matching get_instructions tool.';
+        return apiErrorResult(error, message, context.restartToolName
+            ? `Начни новую operation через ${context.restartToolName}; старый operationId больше не используй.`
+            : 'Начни новую operation через соответствующий get_instructions.');
     }
     if (error.status === 422) {
-        return errorToolResult(error.responseMessage
+        const message = error.responseMessage
             ? `Animaly rejected tool input: ${error.responseMessage}`
-            : 'Animaly rejected tool input.');
+            : 'Animaly rejected tool input.';
+        return apiErrorResult(error, message, 'Исправь указанные поля и отправь тот же замысел снова.');
     }
     if (error.status === 429) {
-        return errorToolResult('Animaly rate limit reached. Try again later.');
+        const retryAfter = error.details?.retryAfterSeconds;
+        return apiErrorResult(error, retryAfter === undefined
+            ? 'Animaly rate limit reached. Try again later.'
+            : `Animaly rate limit reached. Retry after ${retryAfter} seconds.`, retryAfter === undefined
+            ? 'Подожди и повтори после снятия ограничения.'
+            : `Повтори не раньше чем через ${retryAfter} секунд.`);
     }
-    return errorToolResult(error.responseMessage
+    const message = error.responseMessage
         ? `Animaly rejected request (${error.status}): ${error.responseMessage}`
-        : `Animaly rejected request (${error.status}).`);
+        : `Animaly rejected request (${error.status}).`;
+    return apiErrorResult(error, message, error.details?.remediation ? undefined : 'Исправь причину из сообщения и повтори вызов.');
+}
+function apiErrorResult(error, message, continuation) {
+    const detailsText = formatSafeDetails(error.details);
+    const visibleMessage = detailsText ? `${message} ${detailsText}` : message;
+    return errorToolResult(visibleMessage, {
+        code: error.details?.code ?? `HTTP_${error.status ?? 'UNKNOWN'}`,
+        message,
+        status: error.status,
+        details: error.details,
+        continuation: continuation ??
+            (typeof error.details?.remediation === 'string'
+                ? error.details.remediation
+                : error.details?.remediation?.join(' ')),
+    });
+}
+function formatSafeDetails(details) {
+    if (!details)
+        return undefined;
+    const parts = [];
+    if (details.serviceAccountEmail) {
+        parts.push(`Дай доступ Google Sheets сервисному аккаунту ${details.serviceAccountEmail}.`);
+    }
+    const remediation = details.remediation;
+    if (typeof remediation === 'string')
+        parts.push(remediation);
+    if (Array.isArray(remediation))
+        parts.push(...remediation);
+    return parts.length > 0 ? parts.join(' ') : undefined;
 }
 function formatZodError(error) {
     return error.issues

package/dist/tools/result.js.map

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

package/dist/tools/tool-title.d.ts

@@ -0,0 +1,2 @@
+/** Короткий человекочитаемый заголовок для MCP-хоста из уже локализованного описания. */
+export declare function toolTitle(description: string): string;

package/dist/tools/tool-title.js

@@ -0,0 +1,12 @@
+const TITLE_MAX_LENGTH = 80;
+/** Короткий человекочитаемый заголовок для MCP-хоста из уже локализованного описания. */
+export function toolTitle(description) {
+    const sentences = description.split(/(?<=[.!?])\s+/u);
+    const source = sentences.find((sentence) => /[А-Яа-яЁё]/u.test(sentence)) ?? description;
+    const normalized = source.replace(/[.!?]+$/u, '').trim();
+    if (normalized.length <= TITLE_MAX_LENGTH) {
+        return normalized;
+    }
+    return `${normalized.slice(0, TITLE_MAX_LENGTH - 1).trimEnd()}…`;
+}
+//# sourceMappingURL=tool-title.js.map

package/dist/tools/tool-title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-title.js","sourceRoot":"","sources":["../../src/tools/tool-title.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,WAAW,CAAC;IACzF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzD,IAAI,UAAU,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC;QAC1C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;AACnE,CAAC"}

package/dist/tools/toolsets.d.ts

@@ -0,0 +1,37 @@
+import type { ToolDefinition } from './definitions/shared.js';
+export declare const TOOLSETS_ENV = "BESALES_MCP_TOOLSETS";
+/**
+ * Профиль «только чтение»: пересекается с доменными группами, поэтому имя выделено.
+ * Состав выводится из уже объявленного `sideEffect`, а не из отдельного списка: список
+ * пришлось бы вести руками, и он бы отстал от первого же нового инструмента.
+ */
+export declare const READ_ONLY_TOOLSET = "readonly";
+/**
+ * Доменная группа инструмента — второй токен имени (`besales_<группа>_...`).
+ *
+ * ⚠️ Выводится, а не объявляется. Рукописный реестр «инструмент → группа» пришлось бы
+ * пополнять при каждом добавлении, и забытая строка тихо выкидывала бы новый инструмент
+ * из всех профилей: он переставал бы существовать для тех, кто выбрал группу.
+ */
+export declare function toolsetOf(toolName: string): string;
+/**
+ * Разбор объявления профилей. `null` — ограничения нет (значение по умолчанию и
+ * обязательное поведение при пустой переменной: молча урезать поверхность нельзя).
+ */
+export declare function parseToolsets(raw: string | undefined): readonly string[] | null;
+/**
+ * Пропускает ли выбранный набор профилей этот инструмент.
+ *
+ * ⛔ Фильтр применяется и к перечислению, и к вызову. Профиль, который только прячет, —
+ * декорация: хост, знающий имя, всё равно позовёт скрытое, а именно от такого вызова
+ * профиль и заводится. Аннотации этого не закрывают: они подсказка, а не запрет.
+ */
+export declare function isToolAllowed(definition: Pick<ToolDefinition<unknown>, 'name' | 'sideEffect'>, toolsets: readonly string[] | null): boolean;
+/**
+ * Проверяет, что каждое объявленное имя профиля кому-то соответствует.
+ *
+ * ⛔ Опечатка в объявлении не должна давать пустую или урезанную поверхность молча: хост
+ * покажет «инструментов нет», и это будет выглядеть поломкой моста, а не опечаткой в
+ * настройке. Поэтому отказ громкий и с перечнем доступных имён.
+ */
+export declare function assertKnownToolsets(definitions: readonly Pick<ToolDefinition<unknown>, 'name' | 'sideEffect'>[], toolsets: readonly string[] | null): void;

package/dist/tools/toolsets.js

@@ -0,0 +1,64 @@
+export const TOOLSETS_ENV = 'BESALES_MCP_TOOLSETS';
+/**
+ * Профиль «только чтение»: пересекается с доменными группами, поэтому имя выделено.
+ * Состав выводится из уже объявленного `sideEffect`, а не из отдельного списка: список
+ * пришлось бы вести руками, и он бы отстал от первого же нового инструмента.
+ */
+export const READ_ONLY_TOOLSET = 'readonly';
+/**
+ * Доменная группа инструмента — второй токен имени (`besales_<группа>_...`).
+ *
+ * ⚠️ Выводится, а не объявляется. Рукописный реестр «инструмент → группа» пришлось бы
+ * пополнять при каждом добавлении, и забытая строка тихо выкидывала бы новый инструмент
+ * из всех профилей: он переставал бы существовать для тех, кто выбрал группу.
+ */
+export function toolsetOf(toolName) {
+    const parts = toolName.split('_');
+    return parts.length > 2 ? parts[1] : toolName;
+}
+/**
+ * Разбор объявления профилей. `null` — ограничения нет (значение по умолчанию и
+ * обязательное поведение при пустой переменной: молча урезать поверхность нельзя).
+ */
+export function parseToolsets(raw) {
+    const requested = (raw ?? '')
+        .split(',')
+        .map((entry) => entry.trim().toLowerCase())
+        .filter((entry) => entry.length > 0);
+    return requested.length > 0 ? requested : null;
+}
+/**
+ * Пропускает ли выбранный набор профилей этот инструмент.
+ *
+ * ⛔ Фильтр применяется и к перечислению, и к вызову. Профиль, который только прячет, —
+ * декорация: хост, знающий имя, всё равно позовёт скрытое, а именно от такого вызова
+ * профиль и заводится. Аннотации этого не закрывают: они подсказка, а не запрет.
+ */
+export function isToolAllowed(definition, toolsets) {
+    if (toolsets === null) {
+        return true;
+    }
+    if (toolsets.includes(READ_ONLY_TOOLSET) && definition.sideEffect === 'none') {
+        return true;
+    }
+    return toolsets.includes(toolsetOf(definition.name));
+}
+/**
+ * Проверяет, что каждое объявленное имя профиля кому-то соответствует.
+ *
+ * ⛔ Опечатка в объявлении не должна давать пустую или урезанную поверхность молча: хост
+ * покажет «инструментов нет», и это будет выглядеть поломкой моста, а не опечаткой в
+ * настройке. Поэтому отказ громкий и с перечнем доступных имён.
+ */
+export function assertKnownToolsets(definitions, toolsets) {
+    if (toolsets === null) {
+        return;
+    }
+    const known = new Set([READ_ONLY_TOOLSET, ...definitions.map((one) => toolsetOf(one.name))]);
+    const unknown = toolsets.filter((name) => !known.has(name));
+    if (unknown.length === 0) {
+        return;
+    }
+    throw new Error(`${TOOLSETS_ENV}: неизвестные профили ${unknown.join(', ')}. Доступные: ${[...known].sort().join(', ')}`);
+}
+//# sourceMappingURL=toolsets.js.map

package/dist/tools/toolsets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolsets.js","sourceRoot":"","sources":["../../src/tools/toolsets.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAuB;IACnD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;SAC1B,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SAC1C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEvC,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAgE,EAChE,QAAkC;IAElC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,UAAU,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAA4E,EAC5E,QAAkC;IAElC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,GAAG,YAAY,yBAAyB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzG,CAAC;AACJ,CAAC"}

package/dist/tools/verify-with.d.ts

@@ -0,0 +1,5 @@
+export declare function deriveVerifyToolName(toolName: string, knownToolNames: ReadonlySet<string>): string | undefined;
+export declare function resolveVerifyToolName(definition: {
+    readonly name: string;
+    readonly verifyWithToolName?: string;
+}, knownToolNames: ReadonlySet<string>): string | undefined;

package/dist/tools/verify-with.js

@@ -0,0 +1,36 @@
+/**
+ * Чем свериться после неоднозначного исхода: имя выводится из имени самого инструмента.
+ *
+ * ⚠️ Выводится, а не перечисляется. Рукописная таблица «операция → проверка» отстала бы от
+ * первого же нового асинхронного инструмента, и он молча остался бы без указания, чем
+ * проверить, — ровно там, где цена ошибки максимальна. Пара, которую вывести нельзя,
+ * объявляется полем `verifyWithToolName` у самого определения и имеет приоритет.
+ */
+const ASYNC_STARTER_SUFFIXES = [
+    '_init',
+    '_start',
+    '_import',
+    '_execute',
+    '_request',
+];
+export function deriveVerifyToolName(toolName, knownToolNames) {
+    for (const suffix of ASYNC_STARTER_SUFFIXES) {
+        if (!toolName.endsWith(suffix)) {
+            continue;
+        }
+        const candidate = `${toolName.slice(0, -suffix.length)}_status`;
+        if (knownToolNames.has(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+export function resolveVerifyToolName(definition, knownToolNames) {
+    if (definition.verifyWithToolName) {
+        return knownToolNames.has(definition.verifyWithToolName)
+            ? definition.verifyWithToolName
+            : undefined;
+    }
+    return deriveVerifyToolName(definition.name, knownToolNames);
+}
+//# sourceMappingURL=verify-with.js.map

package/dist/tools/verify-with.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-with.js","sourceRoot":"","sources":["../../src/tools/verify-with.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,sBAAsB,GAAG;IAC7B,OAAO;IACP,QAAQ;IACR,SAAS;IACT,UAAU;IACV,UAAU;CACF,CAAC;AAEX,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,cAAmC;IAEnC,KAAK,MAAM,MAAM,IAAI,sBAAsB,EAAE,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QAChE,IAAI,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,UAA2E,EAC3E,cAAmC;IAEnC,IAAI,UAAU,CAAC,kBAAkB,EAAE,CAAC;QAClC,OAAO,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC;YACtD,CAAC,CAAC,UAAU,CAAC,kBAAkB;YAC/B,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IACD,OAAO,oBAAoB,CAAC,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AAC/D,CAAC"}