@besales/mcp 0.48.0 → 1.0.0-beta.4

package/dist/utils/credential-signatures.d.ts

@@ -0,0 +1,3 @@
+/** Сигнатуры credential-signatures.util сервера; анализ пар name/value здесь не нужен.
+ * NFKC используется только для проверки: обычные настройки выдаются в исходном виде. */
+export declare function hasCredentialSignature(value: string): boolean;

package/dist/utils/credential-signatures.js

@@ -0,0 +1,10 @@
+/** Сигнатуры credential-signatures.util сервера; анализ пар name/value здесь не нужен.
+ * NFKC используется только для проверки: обычные настройки выдаются в исходном виде. */
+export function hasCredentialSignature(value) {
+    const normalized = value.normalize("NFKC").replace(/\p{M}/gu, "");
+    return (/(?:^|[^A-Za-z0-9_])(?:(?:sk-|xai-|gsk_|ghp_|glpat-|xox[baprs]-)[A-Za-z0-9_-]{10,}|AKIA[A-Z0-9]{16}(?![A-Za-z0-9_-])|AIza[A-Za-z0-9_-]{30,})/u.test(normalized) ||
+        /(?:^|[^A-Za-z0-9_-])(?:\d{6,12}:[A-Za-z0-9_-]{30,50}(?![A-Za-z0-9_-])|eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+)/u.test(normalized) ||
+        /(?:^|[^A-Za-z0-9_-])bearer\s+[A-Za-z0-9._~+/-]+/iu.test(normalized) ||
+        /-----BEGIN (?:(?:RSA|EC|OPENSSH|ENCRYPTED) )?PRIVATE KEY-----/u.test(normalized));
+}
+//# sourceMappingURL=credential-signatures.js.map

package/dist/utils/credential-signatures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-signatures.js","sourceRoot":"","sources":["../../src/utils/credential-signatures.ts"],"names":[],"mappings":"AAAA;wFACwF;AACxF,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAClE,OAAO,CACL,8IAA8I,CAAC,IAAI,CACjJ,UAAU,CACX;QACD,2HAA2H,CAAC,IAAI,CAC9H,UAAU,CACX;QACD,mDAAmD,CAAC,IAAI,CAAC,UAAU,CAAC;QACpE,gEAAgE,CAAC,IAAI,CACnE,UAAU,CACX,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/data-source-column-name.d.ts

@@ -0,0 +1,10 @@
+export type ColumnNameDecision = "INVALID" | "CREDENTIAL" | "SAFE";
+/** Metadata names, not general OData identifiers. Derived from Ref_Key/Code and the
+ * full ONE_C_DEFAULT_CATALOG_ENRICHMENT: Russian letters, ASCII, separators;
+ * Catalog_ and _Key are the only mixed-script affixes in that dictionary.
+ * 512 is the existing ONE_C_IDENTIFIER_MAX_LENGTH. Never normalize before grammar.
+ * Keep the companion MCP copy and the shared decision vectors in sync. */
+export declare function dataSourceColumnNameDecision(value: string): ColumnNameDecision;
+/** Only a leaf at an actual schema position is a column name. Containers and
+ * extensions keep ordinary recursive credential checking at every depth. */
+export declare function isDataSourceColumnNamePosition(path: readonly (string | number)[]): boolean;

package/dist/utils/data-source-column-name.js

@@ -0,0 +1,36 @@
+import { hasCredentialSignature } from "./credential-signatures.js";
+/** Metadata names, not general OData identifiers. Derived from Ref_Key/Code and the
+ * full ONE_C_DEFAULT_CATALOG_ENRICHMENT: Russian letters, ASCII, separators;
+ * Catalog_ and _Key are the only mixed-script affixes in that dictionary.
+ * 512 is the existing ONE_C_IDENTIFIER_MAX_LENGTH. Never normalize before grammar.
+ * Keep the companion MCP copy and the shared decision vectors in sync. */
+export function dataSourceColumnNameDecision(value) {
+    if (value.length === 0 ||
+        value.length > 512 ||
+        !/^[A-Za-z0-9_А-Яа-яЁё-]+(?:\.[A-Za-z0-9_А-Яа-яЁё-]+)*(?![\s\S])/u.test(value))
+        return "INVALID";
+    const stem = value.replace(/^Catalog_/u, "").replace(/_Key$/u, "");
+    if (/[A-Za-z]/u.test(stem) && /[А-Яа-яЁё]/u.test(stem))
+        return "INVALID";
+    return hasCredentialSignature(value) ? "CREDENTIAL" : "SAFE";
+}
+/** Only a leaf at an actual schema position is a column name. Containers and
+ * extensions keep ordinary recursive credential checking at every depth. */
+export function isDataSourceColumnNamePosition(path) {
+    if (path[0] === "fieldMap")
+        return path.length === 2;
+    if (path[0] === "register")
+        return path.length === 2 && path[1] === "virtualTable";
+    if (path[0] !== "catalog_enrichment")
+        return false;
+    return ((path.length === 2 &&
+        ["title_column", "parent_group_column"].includes(String(path[1]))) ||
+        (path.length === 3 &&
+            ["title_fields", "content_fields"].includes(String(path[1])) &&
+            typeof path[2] === "number") ||
+        (path.length === 4 &&
+            path[1] === "lookups" &&
+            typeof path[2] === "number" &&
+            ["field", "catalog", "column"].includes(String(path[3]))));
+}
+//# sourceMappingURL=data-source-column-name.js.map

package/dist/utils/data-source-column-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source-column-name.js","sourceRoot":"","sources":["../../src/utils/data-source-column-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAIpE;;;;0EAI0E;AAC1E,MAAM,UAAU,4BAA4B,CAC1C,KAAa;IAEb,IACE,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,KAAK,CAAC,MAAM,GAAG,GAAG;QAClB,CAAC,iEAAiE,CAAC,IAAI,CACrE,KAAK,CACN;QAED,OAAO,SAAS,CAAC;IACnB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACnE,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACzE,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/D,CAAC;AAED;4EAC4E;AAC5E,MAAM,UAAU,8BAA8B,CAC5C,IAAkC;IAElC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU;QACxB,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC;IACzD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,oBAAoB;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,CACL,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAChB,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAChB,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;QAC9B,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAChB,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;YACrB,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;YAC3B,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC5D,CAAC;AACJ,CAAC"}

package/dist/utils/logger.d.ts

@@ -9,5 +9,6 @@ export declare const REDACTION_PLACEHOLDER = "[Redacted]";
  * (Массивы, вопреки ожиданию, покрывались и путями: индекс ведёт себя как обычный ключ.)
  */
 export declare function scrubSecrets(value: unknown, depth?: number, seen?: WeakSet<object>): unknown;
+export declare function createSafeLogger(destination?: pino.DestinationStream): pino.Logger;
 export declare const logger: pino.Logger<never, boolean>;
 export declare const REDACTED_LOG_FIELDS: readonly string[];

package/dist/utils/logger.js

@@ -1,5 +1,10 @@
 import pino from 'pino';
+import { maskSetupSecretsInText } from './setup-secrets.js';
 const STDERR_FD = 2;
+/** Маска ключей применяется только к журналу и не меняет проверку содержимого задач. */
+function maskLogSecrets(text) {
+    return maskSetupSecretsInText(text).replace(/mcp_[A-Za-z0-9_-]+/gu, '[REDACTED]');
+}
 /**
  * Имена полей, значения которых в лог не попадают никогда. Список ведётся ОТ ОБРАТНОГО:
  * перечисляется то, что является секретом, а не то, что безопасно, — иначе новый носитель
@@ -40,6 +45,10 @@ const MAX_SCRUB_DEPTH = 12;
  * (Массивы, вопреки ожиданию, покрывались и путями: индекс ведёт себя как обычный ключ.)
  */
 export function scrubSecrets(value, depth = 0, seen = new WeakSet()) {
+    if (typeof value === 'string')
+        return maskLogSecrets(value);
+    if (typeof value === 'function')
+        return REDACTION_PLACEHOLDER;
     if (typeof value !== 'object' || value === null) {
         return value;
     }
@@ -51,20 +60,35 @@ export function scrubSecrets(value, depth = 0, seen = new WeakSet()) {
         return value.map((item) => scrubSecrets(item, depth + 1, seen));
     }
     const out = {};
+    if (value instanceof Error) {
+        out.type = maskLogSecrets(value.name);
+        out.message = maskLogSecrets(value.message);
+        out.stack = maskLogSecrets(value.stack ?? '');
+    }
     for (const [key, nested] of Object.entries(value)) {
-        out[key] = SECRET_FIELDS.has(key)
+        out[maskLogSecrets(key)] = SECRET_FIELDS.has(key) || key.toLowerCase() === 'authorization'
             ? REDACTION_PLACEHOLDER
             : scrubSecrets(nested, depth + 1, seen);
     }
     return out;
 }
-export const logger = pino({
-    level: process.env.LOG_LEVEL ?? (process.env.NODE_ENV === 'test' ? 'silent' : 'info'),
-    formatters: {
-        log(object) {
-            return scrubSecrets(object);
+export function createSafeLogger(destination = pino.destination(STDERR_FD)) {
+    return pino({
+        level: process.env.LOG_LEVEL ?? (process.env.NODE_ENV === 'test' ? 'silent' : 'info'),
+        hooks: {
+            logMethod(args, method) {
+                method.apply(this, args.map((value) => scrubSecrets(value)));
+            },
         },
-    },
-}, pino.destination(STDERR_FD));
+        formatters: {
+            bindings: (object) => scrubSecrets(object),
+            log(object) {
+                return scrubSecrets(object);
+            },
+        },
+        serializers: { msg: (value) => scrubSecrets(value) },
+    }, destination);
+}
+export const logger = createSafeLogger();
 export const REDACTED_LOG_FIELDS = SECRET_FIELD_NAMES;
 //# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB;;;;GAIG;AACH,MAAM,kBAAkB,GAAG;IACzB,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,eAAe;IACf,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,OAAO;IACP,aAAa;IACb,cAAc;IACd,cAAc;IACd,eAAe;IACf,UAAU;IACV,eAAe;IACf,eAAe;CACP,CAAC;AAEX,MAAM,aAAa,GAAG,IAAI,GAAG,CAAS,kBAAkB,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAElD;;;GAGG;AACH,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,EAAU;IAClF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,IAAI,eAAe,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEhB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;YAC/B,CAAC,CAAC,qBAAqB;YACvB,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CACxB;IACE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IACrF,UAAU,EAAE;QACV,GAAG,CAAC,MAA+B;YACjC,OAAO,YAAY,CAAC,MAAM,CAA4B,CAAC;QACzD,CAAC;KACF;CACF,EACD,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAsB,kBAAkB,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/secret-read-boundary.d.ts

@@ -0,0 +1,2 @@
+/** Старые опубликованные ответы сохраняют обычные настройки; сырой шаг закрывается по форме. */
+export declare function projectBridgeSecretRead(value: unknown): unknown;

package/dist/utils/secret-read-boundary.js

@@ -0,0 +1,88 @@
+import { hasCredentialSignature } from "./credential-signatures.js";
+import { dataSourceColumnNameDecision, isDataSourceColumnNamePosition, } from "./data-source-column-name.js";
+/** Старые опубликованные ответы сохраняют обычные настройки; сырой шаг закрывается по форме. */
+export function projectBridgeSecretRead(value) {
+    return projectRead(value, false, 0, { nodes: 0, ancestors: new WeakSet() });
+}
+const MAX_DEPTH = 64;
+const MAX_NODES = 100000;
+function projectRead(value, carrier, depth, budget, path = []) {
+    // Ошибка уходит в существующую безопасную квитанцию jsonToolResult, без повтора мутации.
+    if (depth > MAX_DEPTH || ++budget.nodes > MAX_NODES)
+        throw new Error("SECRET_READ_LIMIT");
+    if (typeof value === "string") {
+        if (isDataSourceColumnNamePosition(path) &&
+            !["***", "[REDACTED]", "[credential removed]"].includes(value) &&
+            dataSourceColumnNameDecision(value) !== "SAFE")
+            return "***";
+        // Проверяется каждый строковый лист, в том числе имена колонок в metadata.
+        if (hasCredentialSignature(value))
+            return "***";
+        return carrier
+            ? value.replace(/([?&](?:token|api_key|secret|password)=)([^&#\s]+)/giu, (_whole, prefix, literal) => prefix + maskLiteral(literal))
+            : value;
+    }
+    if (value === null || typeof value !== "object")
+        return value;
+    if (budget.ancestors.has(value))
+        throw new Error("SECRET_READ_CYCLE");
+    budget.ancestors.add(value);
+    try {
+        if (Array.isArray(value))
+            return value.map((entry, index) => projectRead(entry, carrier, depth + 1, budget, [...path, index]));
+        if (value instanceof Date)
+            return value.toJSON();
+        const row = value;
+        const result = Object.create(null);
+        const step = typeof (row.step_type ?? row.stepType) === "string";
+        for (const [key, child] of Object.entries(row)) {
+            if (row.type === "SECRET" &&
+                [
+                    "value",
+                    "defaultValue",
+                    "default_value",
+                    "constant_value",
+                    "constantValue",
+                    "repeatConstantValue",
+                    "repeat_constant_value",
+                ].includes(key)) {
+                result[key] = child === null ? null : "***";
+            }
+            else if (step && key === "config" && row.configReadable === false) {
+                result.config = {};
+                result.configReadable = false;
+            }
+            else if (key === "before_blob" || key === "after_blob") {
+                continue;
+            }
+            else if (/^(?:x)?(?:apikey|rawkey|accesstoken|refreshtoken|authtoken|clientsecret|webhooksecret|privatekey|token|secret|password|passwd|pwd|authorization|credentials|credentialsciphertext)$/iu.test(key.normalize("NFKC").replace(/[-_\s]/gu, ""))) {
+                result[key] =
+                    child === null
+                        ? null
+                        : typeof child === "string"
+                            ? maskLiteral(child)
+                            : "***";
+            }
+            else {
+                result[key] = projectRead(child, key === "metadata" ||
+                    key === "url_template" ||
+                    (step && key === "config") ||
+                    carrier, depth + 1, budget, key === "metadata" ? [] : [...path, key]);
+            }
+        }
+        return result;
+    }
+    finally {
+        budget.ancestors.delete(value);
+    }
+}
+function maskLiteral(value) {
+    if (hasCredentialSignature(value))
+        return "***";
+    if (/^\s*(?:(?:Bearer|Basic|Token|Bot|Digest|ApiKey)\s+)?(?:\[REDACTED\]|\*\*\*)\s*$/iu.test(value))
+        return value;
+    return /^\s*(?:(?:Bearer|Basic|Token|Bot|Digest|ApiKey)\s+)?\{\{[^{}]+\}\}\s*$/iu.test(value)
+        ? value
+        : "***";
+}
+//# sourceMappingURL=secret-read-boundary.js.map

package/dist/utils/secret-read-boundary.js.map

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

package/dist/utils/setup-secrets.d.ts

@@ -0,0 +1,4 @@
+/** Только диагностическая проекция: URL настоящего сетевого запроса остаётся исходным. */
+export declare function maskSetupSecretsInText(text: string): string;
+/** Ref сохраняется для продолжения; адрес страницы в долговечное хранилище задач не записывается. */
+export declare function containsSetupPageAddress(value: unknown): boolean;

package/dist/utils/setup-secrets.js

@@ -0,0 +1,40 @@
+/** Текстовые границы совпадают с серверной маской: хвост сообщения остаётся диагностикой. */
+const CAPABILITY_PATH = /(\/(?:setup|[a-z0-9-]*setup-sessions|file-upload-sessions|credential-reveals)\/)[^/\s?#"'<>()\[\]{},;]+/giu;
+const BITRIX_INSTALL_PATH = /(\/crm-connections\/[^/\s?#"'<>()\[\]{},;]+\/bitrix24\/install\/)[^/\s?#"'<>()\[\]{},;]+/giu;
+const SECRET_QUERY_NAMES = new Set([
+    'setup_ref',
+    'setupref',
+    'code',
+    'state',
+    'ticket',
+    'token',
+    'access_token',
+    'accesstoken',
+    'secret',
+    'api_key',
+    'apikey',
+]);
+/** Только диагностическая проекция: URL настоящего сетевого запроса остаётся исходным. */
+export function maskSetupSecretsInText(text) {
+    return text
+        .replace(CAPABILITY_PATH, (_match, prefix) => `${prefix}[REDACTED]`)
+        .replace(BITRIX_INSTALL_PATH, (_match, prefix) => `${prefix}[REDACTED]`)
+        .replace(/([?&])([^=&\s#]+)=([^&\s#"'<>)\]},;]*)/gu, (match, separator, name) => {
+        let decoded = name;
+        try {
+            decoded = decodeURIComponent(name);
+        }
+        catch {
+            /* Битое имя не является известным именем секрета. */
+        }
+        return SECRET_QUERY_NAMES.has(decoded.toLowerCase())
+            ? `${separator}${name}=[REDACTED]`
+            : match;
+    });
+}
+/** Ref сохраняется для продолжения; адрес страницы в долговечное хранилище задач не записывается. */
+export function containsSetupPageAddress(value) {
+    const serialized = JSON.stringify(value) ?? '';
+    return (/"(?:setup_page_url|setupPageUrl|upload_page_url|uploadPageUrl|auth_url|installation_url|revealUrl)"\s*:/u.test(serialized) || maskSetupSecretsInText(serialized) !== serialized);
+}
+//# sourceMappingURL=setup-secrets.js.map

package/dist/utils/setup-secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-secrets.js","sourceRoot":"","sources":["../../src/utils/setup-secrets.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,eAAe,GACnB,4GAA4G,CAAC;AAC/G,MAAM,mBAAmB,GACvB,6FAA6F,CAAC;AAChG,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,WAAW;IACX,UAAU;IACV,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,cAAc;IACd,aAAa;IACb,QAAQ;IACR,SAAS;IACT,QAAQ;CACT,CAAC,CAAC;AAEH,0FAA0F;AAC1F,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,IAAI;SACR,OAAO,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAc,EAAE,EAAE,CAAC,GAAG,MAAM,YAAY,CAAC;SAC3E,OAAO,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAc,EAAE,EAAE,CAAC,GAAG,MAAM,YAAY,CAAC;SAC/E,OAAO,CACN,0CAA0C,EAC1C,CAAC,KAAa,EAAE,SAAiB,EAAE,IAAY,EAAE,EAAE;QACjD,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC;YACH,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;QACD,OAAO,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAClD,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,aAAa;YAClC,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC,CACF,CAAC;AACN,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC/C,OAAO,CACL,0GAA0G,CAAC,IAAI,CAC7G,UAAU,CACX,IAAI,sBAAsB,CAAC,UAAU,CAAC,KAAK,UAAU,CACvD,CAAC;AACJ,CAAC"}

package/docs/agent-models.md

@@ -0,0 +1,9 @@
+# Выбор модели агента
+
+`besales_agent_models_list` читает GET /api/v2/workspaces/{workspaceId}/agent-models с правом read:agents. Рабочая область — текущая подключённая, либо явный workspace_id; agent_id необязателен и уточняет ориентир цены по инструкции и фактам. Инструмент ничего не пишет и не вызывает модель. Каталог сравнения моделей остаётся отдельным инструментом.
+
+`besales_agent_update` сохраняет прежний вход и PATCH канальной проекции. Отсутствующий model не добавляется в тело запроса; прежний неизменённый неизвестный model допускается сервером. Новый выбор проверяет серверный каталог, алиасы приводит сервер. model=null на канальном входе не допускается. Новая обязательная версия клиента не нужна: последнее успешное сохранение побеждает.
+
+get/list/update сохраняют технические runtimeConfig и effectiveModel целиком. При effectiveModel.substitutedFrom !== null добавляется безопасный modelNotice на языке BESALES_LOCALE (ru/en/es/id/uz; неизвестный язык — ru). Человек видит предложение выбрать другую модель; исходный ID не используется как подпись. Пустой или непрочитанный каталог не служит командой сбросить выбор.
+
+Схемы каталога и подсказки выпускаются из исполняемых определений: yarn build → yarn schemas:sync:agent-models. Типы API: yarn types:gen:api после выпуска OpenAPI. Финальная карта маршрутов выпускается штатным scripts/emit-tool-routes.mjs после коммита моста владельцем интеграции.

package/docs/agent-usage-guide.full.ru.md

@@ -95,9 +95,6 @@ Claude Code / Codex   ← здесь живёт AI-агент: понимает
 
 ## 3. Подключение (Claude Code и Codex)
 
-Отдельная пошаговая инструкция, включая закрепление сервера за компанией и обновление, —
-[connect.ru.md](connect.ru.md).
-
 > Делается **один раз**. Если не дружишь с терминалом — попроси технического коллегу:
 > это пара команд, дальше нужен только чат.
 
@@ -334,7 +331,6 @@ npx -y @besales/mcp connect
 | Каналы | подключить канал, настройки | `besales_platform_create_init` / `_oauth_init` / `_create_status`, `besales_platform_settings_update` |
 | Боты и промпты | создать бота, сочинить/улучшить промпт, скелет диалога, приветствие | `besales_agent_*`, `besales_prompt_*`, `besales_dialog_script_*`, `besales_behavior_update` |
 | Действия бота | что бот делает по условиям, несколько ботов + переключение | `besales_trigger_upsert` / `besales_trigger_delete`, `besales_routing_rule_upsert`, `besales_router_update` |
-| Права одноразовых действий | разрешить триггеру «один раз на контакт» сработать снова | `besales_trigger_claim_list`, `besales_trigger_claim_reset` |
 | База знаний | хранилища, документы, вопросы-ответы, таблицы, сайты | `besales_knowledge_*` |
 | Клиент (портрет) | портрет клиента, импорт диалогов, учебные ситуации | `besales_icp_*`, `besales_test_scenario_generate_*` |
 | CRM | подключить, активировать, воронки, поля, операторы | `besales_crm_*` |
@@ -343,6 +339,7 @@ npx -y @besales/mcp connect
 | Сравнение моделей | «соревнование» моделей на твоём промпте | `besales_model_*` |
 | Файлы/таблицы | загрузка файлов, чтение Excel/Sheets | `besales_file_*`, `besales_workbook_*` |
 | Напоминания/фидбэк | догоны клиентам, замечания из Google-листа | `besales_followup_sequence_upsert`, `besales_feedback_sheet_*` |
+| Отчёты | как сработали рассылки, на какой догон люди отвечают, переписки за период | `besales_broadcast_analytics_get`, `besales_followup_reactions`, `besales_followup_step_stats`, `besales_dialogues_query` |
 | Откат/копирование | откатить правку, скопировать на другой канал | `besales_audit_revert`, `besales_platform_clone_*` |
 
 ---

package/docs/analytics-contract.md

@@ -0,0 +1,67 @@
+# Контракт аналитики
+
+Входящие — отдельный источник. В текущем API построены денежный отчёт `money` и темы `topics`;
+серверные `summary`, `speed`, `cycle`, `quality` ещё не построены. Все шесть отгруженных значений и
+отдельные адреса сохранены. Четыре строки `routeLag` в `shipped-lag.json` с классом `ROUTE_ABSENT`
+проверяются против снимка API и выгружаются серверным сторожам. Исчезновение долга либо его
+сохранение после появления маршрута краснит проверку. Описание инструмента сообщает эту
+границу до вызова. Отказ маршрута не означает отсутствие данных.
+
+В `besales_inbound_analytics_get` правило периода едино для всех шести значений `report`:
+`summary`, `topics`, `speed`, `money`, `cycle`, `quality`. На входе инструмента `from` и `to`
+принимаются как ISO-моменты с обязательным часовым поясом (`Z` или смещение), на входе сервера —
+как календарные даты `YYYY-MM-DD`. Мост переводит каждый момент в дату суток `Europe/Moscow`;
+зона машины и дата в исходном часовом поясе не определяют результат.
+
+Сутки Москвы начинаются в `00:00+03:00`, то есть в `21:00Z` предыдущей даты UTC. Например,
+`2026-10-27T21:00:00Z` превращается в `2026-10-28`. Граница `from` задаёт начало этих суток,
+а `to` включает полученную календарную дату целиком: исключительная верхняя граница на
+бэкенде — начало следующих суток МСК. Для `to`, приведённого к `2026-10-28`, это
+`2026-10-29T00:00:00+03:00`, или `2026-10-28T21:00:00Z`.
+
+Отгруженные `platform_id` и `channels` передаются серверу как `channelId` и `transports`;
+названия транспортов переводятся в верхний регистр без изменения внешних аргументов.
+
+Список воронки `drilldown` отдаёт имена, логины, телефоны и ссылки CRM, поэтому инструмент
+помечен носителем персональных данных клиентов и требует `read:analytics` + `read:conversations`.
+Агрегатные отчёты воронки требуют только `read:analytics`. Право `read:conversations` входит в
+`mcp:*`; только `read:contacts` подключается отдельным согласием и не входит в `mcp:*`.
+Пара `read:analytics` + `read:conversations` требуется и для строки регистраций
+`registration_intake` в фасаде рассылок. У неё доступна ось периода регистрации; оси входа
+в сегмент и когорты отвергаются. Сверка пространства и потребители здоровья не обещаются.
+
+Путь до стадии принимает канал и целевой статус. Неприменимые поля периода, вида и менеджера
+отвергаются с адресом поля; дополнительные координаты списка не теряются у других отчётов.
+Список знает перечисление метрик и потолок страницы сервера. Для личного Telegram идентификатор
+канала берётся из `besales_platform_context_get`; прежний идентификатор площадки даст 404.
+
+Ошибки отправки используют людей выбранной когорты либо всех людей канала в режиме периода.
+Доказанные события отказа у этих людей берутся за всё время, без окна события.
+
+В аналитике рассылок агрегаты доступны с `read:analytics`. Персональные отчёты `recipients`
+(включая `recipient_metric=notSent`), `deals`, `action_failures`, `indirect_payments`,
+`recent_leads`, `payment_candidates` и `registration_intake` требуют также `read:conversations`.
+Отдельный список `besales_broadcast_payment_candidates_list` и лента `besales_tracked_link_clicks`
+требуют ту же пару. Для находок `besales_dialog_review_findings` и его отгруженного имени
+`besales_dialogue_audit_findings` нужна пара `read:agents` + `read:conversations`: находка
+содержит цитату реплики человека.
+
+Каталог отслеживаемых ссылок меняется с `write:analytics-catalog`, которое входит в
+`mcp:platform-setup`. В `target_url` можно использовать `{firstName}`, `{lastName}`, `{fullName}`,
+`{email}`, `{phone}`, `{username}`, `{getcourseUserId}`, `{getcourseDealId}`, `{followUpStep}`.
+Указывайте переменную только как целое значение query-параметра, например `?email={email}`
+или `?email=%7Bemail%7D`. Подставленное значение URL-кодируется; отсутствующее или пустое
+значение удаляет весь параметр. Номер дожима имеет форму `pN` только в `FOLLOWUP`; вне дожима
+параметр удаляется. Имя, фамилия и почта берутся из карточки контакта, полное имя собирается
+из доступных частей, телефон содержит только цифры, логин — из текущей идентичности,
+номера GetCourse — из контекста школы отправки.
+
+Переменные в хосте, пути, фрагменте, имени параметра или части его значения и новый чужой
+рекламный макрос приводят к отказу 400. Старый чужой макрос сохраняется до реальной смены
+адреса. Персональный шаблон требует HTTPS и `read:contacts` при создании или реальной смене
+цели. Это право выдаётся мосту через отдельное согласие подключения и не входит в `mcp:*`.
+Повтор прежней цели, переименование и восстановление ссылки не требуют этого дополнительного
+права. Уже отправленные персональные коды сохраняют снимок прежней цели; новые выдачи и
+анонимный `staticUrl` используют новую цель.
+
+Источник звонков воронки: velocity отдаёт одинаковые `responseSpeed.callSourceState` и `callsSourceState`; managers — `callSourceState`. Три состояния: не настроен, исправен, отстал. Свежесть `callsPolledAt` — подтверждённая граница полного чтения; null не заменяется временем страницы. `callsFailingTargets` называет число нечитаемых сущностей; `callsStaleReasonText` даёт причину словами языка запроса. При отставании `callsIncluded` остаётся истинным: история звонков не удаляется. `CAPACITY` определяется возрастом старейшей непрочитанной горячей цели, независимо от снимка остатка; один ненулевой свежий хвост не тревога. Ограниченный бюджет подтверждается сценарием настоящего обхода. Первый круг после переноса — отставание до полного покрытия. Удалённые подключения не входят в живое состояние, хотя их история остаётся в цифрах.

package/docs/async-operation-lifecycle.md

@@ -21,6 +21,7 @@ read-only status-инструмент. Стартовый ответ не явл
 | `besales_file_upload_request` | `besales_file_upload_status` | сессия сама истекает |
 | `besales_platform_create_init`, `besales_platform_create_oauth_init` | `besales_platform_create_status` | сессия сама истекает |
 | `besales_crm_create_init` | `besales_crm_create_status` | сессия сама истекает |
+| `besales_crm_rotate_init` | `besales_crm_rotate_status` | сессия сама истекает: браузерная ссылка с ограниченным сроком |
 | `besales_datasource_create_init` | `besales_datasource_create_status` | сессия сама истекает |
 | `besales_model_comparison_run_start` | `besales_model_comparison_get` | нет: уже начатые LLM-вызовы оплачены |
 | `besales_followup_funnel_test_start` | `besales_followup_funnel_test_status` | cancel |
@@ -29,18 +30,24 @@ read-only status-инструмент. Стартовый ответ не явл
 | `besales_getcourse_contacts_import` | `besales_getcourse_contact_import_status` | нет: повтор обновляет те же карточки |
 | `besales_getcourse_anchor_refresh_start` | `besales_getcourse_anchor_refresh_status` | нет: частично переписанные даты необратимы |
 | `besales_dialogue_audit_run_start` | `besales_dialogue_audit_run_get` | cancel; остаток подхватит новый прогон |
+| `besales_dialog_review_run_start` | `besales_dialog_review_launch_outcome` | cancel; находки разобранных отрезков остаются |
+| `besales_improvement_aggregate_start` | `besales_improvement_aggregate_launch_outcome` | нет отдельной остановки |
 
 Опрос делается с паузой, указанной инструментом, до terminal state. `PARTIAL` требует проверить
 счётчики и ошибки. `STALLED` не равен безопасному отказу: сначала проверяется уже записанный
 результат и аудит, затем принимается решение о повторе.
 
+У платных запусков с ключом намерения (`besales_dialog_review_run_start`,
+`besales_improvement_aggregate_start`) status читает исход по исходному ключу. Исход `UNKNOWN` не
+разрешает новый платный запуск автоматически: сначала выясняется, был ли первый принят.
+
 ## Синхронные похожие имена
 
 `besales_prompt_patch_start` синхронно создаёт draft; его дальнейший жизненный цикл —
 `get/apply/commit/discard`. `besales_dialogue_audit_import` синхронно принимает находки и двигает
-watermark. `besales_datasource_vectorize` возвращает результат в том же HTTP-ответе. Для них
-отдельный job-status не нужен.
+отметку разобранных отрезков. Для них отдельный job-status не нужен.
 
 Регрессионный тест `src/tools/async-lifecycle.spec.ts` перечисляет все инструменты с суффиксами
 `start/init/import/execute/request/reindex/resume`. Новый похожий инструмент обязан быть добавлен
-в канон либо явно классифицирован как синхронный.
+в канон либо явно классифицирован как синхронный. Тест же сверяет эту таблицу с каноном: каждая
+пара «start — status» из теста обязана быть названа здесь.