@besales/mcp 0.46.0 → 0.47.0

package/dist/tools/registry.js

@@ -1,20 +1,39 @@
 import { ConnectionStore, WorkspaceResolutionError } from '../auth/connection-store.js';
 import { getSessionWorkspaceId } from '../auth/session-workspace.js';
 import { ApiClient } from '../http/api-client.js';
+import { toolAnnotations } from './annotations.js';
 import { getToolContract } from './contracts.js';
 import { toolDefinitions } from './definitions.js';
-import { jsonToolResult, mapToolError } from './result.js';
+import { acceptedResponseReceipt, jsonToolResult, mapToolError } from './result.js';
+import { isEnvelopeEnabled } from './result-envelope.js';
+import { toolTitle } from './tool-title.js';
+import { resolveVerifyToolName } from './verify-with.js';
+import { TOOLSETS_ENV, assertKnownToolsets, isToolAllowed, parseToolsets } from './toolsets.js';
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 export function createTools(options = {}) {
     const apiClient = options.apiClient ?? new ApiClient();
     const store = options.store ?? new ConnectionStore();
-    return toolDefinitions.map((rawDefinition) => {
+    const toolsets = options.toolsets === undefined ? parseToolsets(process.env[TOOLSETS_ENV]) : options.toolsets;
+    assertKnownToolsets(toolDefinitions, toolsets);
+    const allowedDefinitions = toolDefinitions.filter((rawDefinition) => isToolAllowed(rawDefinition, toolsets));
+    // Называть скрытый status-tool нельзя: человек получит неисполнимый следующий шаг. Если
+    // профиль его не разрешает, OUTCOME_UNKNOWN честно остаётся нерешённым.
+    const knownToolNames = new Set(allowedDefinitions.map((one) => one.name));
+    // ⛔ Отбор идёт ЗДЕСЬ, до сборки. Тогда и перечисление, и вызов работают с одним набором
+    // по построению: второй список нечему разойтись с первым.
+    return allowedDefinitions
+        .map((rawDefinition) => {
         const definition = rawDefinition;
         const contract = getToolContract(definition.name);
         return {
             name: contract.name,
+            title: toolTitle(contract.description),
             description: contract.description,
             inputSchema: contract.inputSchema,
+            ...(isEnvelopeEnabled()
+                ? { outputSchema: { type: 'object', additionalProperties: true } }
+                : {}),
+            annotations: toolAnnotations(definition),
             async handler(args) {
                 let resolvedWorkspaceId;
                 try {
@@ -24,8 +43,10 @@ export function createTools(options = {}) {
                         const localOutput = await definition.localHandler(parsedInput, {
                             store,
                             env: process.env,
+                            apiClient,
+                            availableToolNames: knownToolNames,
                         });
-                        return jsonToolResult(localOutput);
+                        return jsonToolResult(localOutput, definition.resultPolicy, definition.sideEffect);
                     }
                     const { workspaceId, apiKey } = await resolveWorkspace(parsedInput, definition, store);
                     resolvedWorkspaceId = workspaceId;
@@ -37,18 +58,49 @@ export function createTools(options = {}) {
                     const response = request.method
                         ? await apiClient.request(request.method, request.path, apiKey, request.body)
                         : await apiClient.post(request.path, apiKey, request.body);
-                    const output = definition.enhanceResponse
-                        ? definition.enhanceResponse(response, input)
-                        : response;
-                    return jsonToolResult(output);
+                    try {
+                        const output = definition.enhanceResponse
+                            ? definition.enhanceResponse(response, input)
+                            : response;
+                        return jsonToolResult(output, definition.resultPolicy, definition.sideEffect);
+                    }
+                    catch (error) {
+                        if (definition.sideEffect !== 'none')
+                            return acceptedResponseReceipt(response, error);
+                        throw error;
+                    }
                 }
                 catch (error) {
-                    return mapToolError(error, definition.restartToolName, resolvedWorkspaceId);
+                    return mapToolError(error, {
+                        restartToolName: definition.restartToolName,
+                        verifyWithToolName: resolveVerifyToolName(definition, knownToolNames),
+                        sideEffect: definition.sideEffect,
+                        idempotent: definition.idempotent,
+                        requestIdentity: safeRequestIdentity(args),
+                    }, resolvedWorkspaceId);
                 }
             },
         };
     });
 }
+function safeRequestIdentity(args) {
+    const safeKeys = [
+        'id',
+        'operation_id',
+        'run_id',
+        'agent_id',
+        'platform_id',
+        'workspace_id',
+        'idempotency_key',
+    ];
+    const identity = {};
+    for (const key of safeKeys) {
+        const value = args[key];
+        if (typeof value === 'string' || typeof value === 'number')
+            identity[key] = value;
+    }
+    return Object.keys(identity).length > 0 ? identity : undefined;
+}
 export const tools = createTools();
 /**
  * Выбирает воркспейс и его api_key для вызова. Приоритет (env — authoritative):

package/dist/tools/registry.js.map

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

package/dist/tools/result-envelope.d.ts

@@ -0,0 +1,46 @@
+import type { ToolResultPolicy } from './definitions/shared.js';
+/** Потолок обычного ответа. Покрывает 95 % замеренных ответов с запасом. */
+export declare const DEFAULT_RESULT_BYTES = 64000;
+/**
+ * Порог отказа для снимков, которые обрезать нельзя. Заведомо выше наблюдаемого максимума
+ * работающих снимков (77,6 КБ), чтобы предохранитель не гасил живые сценарии.
+ */
+export declare const NEVER_TRUNCATE_REFUSAL_BYTES = 256000;
+/** Потолок текста ошибки: сообщение бэкенда ничем не ограничено и идёт наружу как есть. */
+export declare const ERROR_MESSAGE_BYTES = 4000;
+/** Потолок одного ресурса — сеть безопасности от роста справочников, а не инструмент обрезки. */
+export declare const RESOURCE_BYTES = 128000;
+/**
+ * Конверт включается переменной окружения. Дефолт — ВЫКЛЮЧЕН: README везде рекомендует
+ * запуск без пина версии, то есть правка доезжает до всех установок сама, посреди рабочих
+ * сессий. Один релиз выключенным, включение — следующим.
+ */
+export declare const RESULT_ENVELOPE_ENV = "BESALES_MCP_RESULT_ENVELOPE";
+export declare function isEnvelopeEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function byteLength(value: string): number;
+export interface ShapedResult {
+    /** Готовый текст ответа. */
+    readonly text: string;
+    /** Ответ не влез и обрезать его было нельзя — наружу уходит отказ, а не данные. */
+    readonly refused: boolean;
+}
+/**
+ * Приводит значение к тексту ответа с учётом политики инструмента.
+ *
+ * Порядок: компактный JSON → влезло? → выбросить объявленные необязательные пути →
+ * влезло? → обрезать массив верхнего уровня → влезло? → отказ.
+ */
+export declare function shapeToolResult(value: unknown, policy: ToolResultPolicy | undefined, enabled: boolean): ShapedResult;
+/** Текст ошибки проходит тот же потолок: иначе через него уходит неограниченное сообщение. */
+export declare function shapeErrorMessage(message: string): string;
+export declare function shapeResourceText(uri: string, text: string): string;
+interface DropOutcome {
+    readonly value: unknown;
+    readonly changed: boolean;
+}
+/**
+ * Удаляет путь из структуры, не мутируя исходную. Сегмент `[]` означает «каждый элемент
+ * массива»: путь `agents[].baseSystemPrompt` снимает промпт у всех агентов сразу.
+ */
+export declare function dropPath(value: unknown, path: string): DropOutcome;
+export {};

package/dist/tools/result-envelope.js

@@ -0,0 +1,184 @@
+/** Потолок обычного ответа. Покрывает 95 % замеренных ответов с запасом. */
+export const DEFAULT_RESULT_BYTES = 64_000;
+/**
+ * Порог отказа для снимков, которые обрезать нельзя. Заведомо выше наблюдаемого максимума
+ * работающих снимков (77,6 КБ), чтобы предохранитель не гасил живые сценарии.
+ */
+export const NEVER_TRUNCATE_REFUSAL_BYTES = 256_000;
+/** Потолок текста ошибки: сообщение бэкенда ничем не ограничено и идёт наружу как есть. */
+export const ERROR_MESSAGE_BYTES = 4_000;
+/** Потолок одного ресурса — сеть безопасности от роста справочников, а не инструмент обрезки. */
+export const RESOURCE_BYTES = 128_000;
+/**
+ * Конверт включается переменной окружения. Дефолт — ВЫКЛЮЧЕН: README везде рекомендует
+ * запуск без пина версии, то есть правка доезжает до всех установок сама, посреди рабочих
+ * сессий. Один релиз выключенным, включение — следующим.
+ */
+export const RESULT_ENVELOPE_ENV = 'BESALES_MCP_RESULT_ENVELOPE';
+export function isEnvelopeEnabled(env = process.env) {
+    return (env[RESULT_ENVELOPE_ENV] ?? '').trim().toLowerCase() === 'on';
+}
+export function byteLength(value) {
+    return Buffer.byteLength(value, 'utf8');
+}
+/**
+ * Приводит значение к тексту ответа с учётом политики инструмента.
+ *
+ * Порядок: компактный JSON → влезло? → выбросить объявленные необязательные пути →
+ * влезло? → обрезать массив верхнего уровня → влезло? → отказ.
+ */
+export function shapeToolResult(value, policy, enabled) {
+    const text = stringify(value);
+    if (!enabled) {
+        return { text, refused: false };
+    }
+    const limit = policy?.maxResultBytes ??
+        (policy?.neverTruncate ? NEVER_TRUNCATE_REFUSAL_BYTES : DEFAULT_RESULT_BYTES);
+    const size = byteLength(text);
+    if (size <= limit) {
+        return { text, refused: false };
+    }
+    const dropped = [];
+    let current = value;
+    for (const path of policy?.droppablePaths ?? []) {
+        const next = dropPath(current, path);
+        if (next.changed) {
+            dropped.push(path);
+            current = next.value;
+            // ⚠️ Меряется ИТОГОВАЯ строка, вместе с маркерами и подсказкой. Проверка «влезло ли
+            // значение» до их добавления давала ответ чуть больше объявленного потолка ровно в том
+            // случае, ради которого потолок и вводился, — на границе.
+            const marked = stringify(markDropped(current, dropped, policy));
+            if (byteLength(marked) <= limit) {
+                return { text: marked, refused: false };
+            }
+        }
+    }
+    if (policy?.neverTruncate) {
+        return { text: refusal(size, limit, policy), refused: true };
+    }
+    if (Array.isArray(current)) {
+        const kept = fitArray(current, limit, dropped.length > 0 ? dropped : undefined, policy);
+        if (kept) {
+            return { text: kept, refused: false };
+        }
+    }
+    return { text: refusal(size, limit, policy), refused: true };
+}
+/** Текст ошибки проходит тот же потолок: иначе через него уходит неограниченное сообщение. */
+export function shapeErrorMessage(message) {
+    if (byteLength(message) <= ERROR_MESSAGE_BYTES) {
+        return message;
+    }
+    return `${cutToBytes(message, ERROR_MESSAGE_BYTES)}… [сообщение обрезано]`;
+}
+export function shapeResourceText(uri, text) {
+    if (byteLength(text) <= RESOURCE_BYTES) {
+        return text;
+    }
+    // Место под пометку резервируется заранее: иначе итог оказался бы длиннее объявленного потолка.
+    const notice = `\n\n[Ресурс ${uri} обрезан на ${RESOURCE_BYTES} байтах: целиком он не помещается в ответ. Дочитать нечем — справочник нужно разделить на части.]`;
+    return `${cutToBytes(text, RESOURCE_BYTES - byteLength(notice))}${notice}`;
+}
+function stringify(value) {
+    return JSON.stringify(value) ?? 'null';
+}
+function refusal(size, limit, policy) {
+    const hint = policy?.narrowingHint
+        ? ` ${policy.narrowingHint}`
+        : ' Сузьте запрос параметрами инструмента.';
+    return (`Ответ весит ${size} байт при потолке ${limit}. ` +
+        `Обрезать его нельзя: неполный ответ здесь неотличим от полного и приводит к потере данных при обратной записи.${hint}`);
+}
+function markDropped(value, dropped, policy) {
+    if (!isPlainObject(value)) {
+        return { items: value, _mcpDropped: dropped, ...hintField(policy) };
+    }
+    return { ...value, _mcpDropped: dropped, ...hintField(policy) };
+}
+/** Подсказка ставится ТОЛЬКО когда у инструмента есть чем сузить: общий текст был бы ложью. */
+function hintField(policy) {
+    return policy?.narrowingHint ? { _mcpHint: policy.narrowingHint } : {};
+}
+/**
+ * Обрезка массива верхнего уровня — последнее средство и единственная форма, где смена
+ * формы ответа допустима: она происходит РОВНО тогда, когда обрезка реально случилась.
+ */
+function fitArray(items, limit, dropped, policy) {
+    let kept = items.length;
+    while (kept > 0) {
+        const candidate = {
+            items: items.slice(0, kept),
+            _mcpTruncated: { keptItems: kept, totalItems: items.length },
+            ...(dropped ? { _mcpDropped: dropped } : {}),
+            ...hintField(policy),
+        };
+        const text = stringify(candidate);
+        if (byteLength(text) <= limit) {
+            return text;
+        }
+        kept = Math.floor(kept / 2);
+    }
+    return null;
+}
+/**
+ * Удаляет путь из структуры, не мутируя исходную. Сегмент `[]` означает «каждый элемент
+ * массива»: путь `agents[].baseSystemPrompt` снимает промпт у всех агентов сразу.
+ */
+export function dropPath(value, path) {
+    return dropSegments(value, path.split('.').flatMap(splitArraySegment));
+}
+function splitArraySegment(segment) {
+    return segment.endsWith('[]') ? [segment.slice(0, -2), '[]'] : [segment];
+}
+function dropSegments(value, segments) {
+    const [head, ...rest] = segments;
+    if (head === undefined) {
+        return { value, changed: false };
+    }
+    if (head === '[]') {
+        if (!Array.isArray(value)) {
+            return { value, changed: false };
+        }
+        let changed = false;
+        const next = value.map((item) => {
+            const outcome = dropSegments(item, rest);
+            changed = changed || outcome.changed;
+            return outcome.value;
+        });
+        return changed ? { value: next, changed: true } : { value, changed: false };
+    }
+    if (!isPlainObject(value) || !(head in value)) {
+        return { value, changed: false };
+    }
+    if (rest.length === 0) {
+        const { [head]: _removed, ...remainder } = value;
+        return { value: remainder, changed: true };
+    }
+    const outcome = dropSegments(value[head], rest);
+    return outcome.changed ? { value: { ...value, [head]: outcome.value }, changed: true } : { value, changed: false };
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Режет по границе кодовой точки: половина суррогатной пары наружу уходить не должна. */
+function cutToBytes(text, limit) {
+    if (byteLength(text) <= limit) {
+        return text;
+    }
+    let low = 0;
+    let high = text.length;
+    while (low < high) {
+        const middle = Math.ceil((low + high) / 2);
+        if (byteLength(text.slice(0, middle)) <= limit) {
+            low = middle;
+        }
+        else {
+            high = middle - 1;
+        }
+    }
+    const cut = text.slice(0, low);
+    const lastCode = cut.charCodeAt(cut.length - 1);
+    return lastCode >= 0xd800 && lastCode <= 0xdbff ? cut.slice(0, -1) : cut;
+}
+//# sourceMappingURL=result-envelope.js.map

package/dist/tools/result-envelope.js.map

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

package/dist/tools/result.d.ts

@@ -1,4 +1,42 @@
 import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-export declare function jsonToolResult(value: unknown): CallToolResult;
-export declare function errorToolResult(message: string): CallToolResult;
-export declare function mapToolError(error: unknown, restartToolName?: string, workspaceId?: string): CallToolResult;
+import { type SafeApiErrorDetails } from '../http/api-client.js';
+import type { ToolResultPolicy, ToolSideEffect } from './definitions/shared.js';
+/**
+ * Единственный формат успешного ответа инструмента.
+ *
+ * ⚠️ Функция обязана быть ТОТАЛЬНОЙ. Она выполняется ПОСЛЕ успешной мутации: если она
+ * бросит, вызывающий увидит ошибку инструмента и повторит платный побочный эффект. Поэтому
+ * любой внутренний сбой форматирования отдаёт минимальную квитанцию — и БЕЗ `isError`,
+ * иначе получилось бы то же самое приглашение повторить.
+ */
+export declare function jsonToolResult(value: unknown, policy?: ToolResultPolicy, sideEffect?: ToolSideEffect): CallToolResult;
+/**
+ * Что вернуть, когда сериализовать ответ не удалось: идентификаторы созданной сущности, если
+ * они видны на верхнем уровне. Без них вызывающий не смог бы даже сослаться на результат
+ * уже состоявшейся мутации.
+ */
+export declare function identityOf(value: unknown): Record<string, unknown>;
+/** Безошибочная квитанция, когда API уже ответил, а локальная постобработка сломалась. */
+export declare function acceptedResponseReceipt(value: unknown, _cause: unknown): CallToolResult;
+interface StructuredToolError {
+    readonly code: string;
+    readonly message: string;
+    readonly status?: number;
+    readonly details?: SafeApiErrorDetails;
+    readonly continuation?: string;
+    readonly requestIdentity?: Readonly<Record<string, string | number>>;
+}
+export declare function errorToolResult(message: string, structuredError?: StructuredToolError): CallToolResult;
+/**
+ * Что известно об инструменте в момент ошибки. Одного `restartToolName` мало: исход вызова
+ * читается по-разному в зависимости от того, мог ли вызов что-то изменить и безопасен ли повтор.
+ */
+export interface ToolErrorContext {
+    readonly restartToolName?: string;
+    readonly verifyWithToolName?: string;
+    readonly sideEffect: ToolSideEffect;
+    readonly idempotent?: boolean;
+    readonly requestIdentity?: Readonly<Record<string, string | number>>;
+}
+export declare function mapToolError(error: unknown, context?: ToolErrorContext, workspaceId?: string): CallToolResult;
+export {};