@inso_web/els-mcp 0.1.0

package/dist/prompts/index.js

@@ -0,0 +1,202 @@
+import { z } from 'zod';
+export const ALL_PROMPT_NAMES = [
+    'triage-recent-errors',
+    'find-regression-since-deploy',
+    'explain-error-cluster',
+    'weekly-error-report',
+];
+function userMessage(text) {
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: { type: 'text', text },
+            },
+        ],
+    };
+}
+export function registerPrompts(server, opts = {}) {
+    const registered = [];
+    // ─── triage-recent-errors ────────────────────────────────────────────────
+    server.registerPrompt('triage-recent-errors', {
+        title: 'Triage recent errors',
+        description: 'On-call инцидент-triage: какие ошибки случились за последние N часов, сгруппированные по severity и fingerprint.',
+        argsSchema: {
+            hours: z.string().optional().describe('Окно анализа в часах (1-24). Default: 1.'),
+            level: z.string().optional().describe('Минимальный уровень severity. Default: CRITICAL.'),
+        },
+    }, async (args) => {
+        const hoursStr = args.hours ?? '1';
+        const hoursNum = Math.max(1, Math.min(24, Number(hoursStr) || 1));
+        const level = args.level ?? 'CRITICAL';
+        const minutes = hoursNum * 60;
+        const text = [
+            'Ты — опытный SRE, дежурный по платформе ELS. Сейчас инцидент-triage.',
+            '',
+            'Контекст:',
+            `- Окно анализа: последние ${hoursNum} ч.`,
+            `- Severity: ${level} и выше.`,
+            '',
+            'Сделай следующее, используя доступные tools:',
+            '',
+            `1. Вызови \`triage_recent_critical\` с minutesBack=${minutes}, sampleSize=10.`,
+            '2. Если найдено ≥ 1 fingerprint, вызови `grouped_errors` за то же окно и покажи топ-5 по count.',
+            '3. Для top-1 fingerprint вызови `find_similar_errors` (по traceId из samples) — ошибка новая или recurring?',
+            '4. Сделай выводы в формате:',
+            '   - **Заголовок:** одна строка — что сломалось',
+            `   - **Severity:** ${level} × N`,
+            '   - **Top causes (top-3):** fingerprint + краткое описание + count',
+            '   - **Recurring vs new:** для top-1 — сколько раз за 7д',
+            '   - **Recommended next step:** что проверять руками',
+            '',
+            'Отвечай по-русски, без emoji, кратко.',
+        ].join('\n');
+        return userMessage(text);
+    });
+    registered.push('triage-recent-errors');
+    // ─── find-regression-since-deploy ────────────────────────────────────────
+    server.registerPrompt('find-regression-since-deploy', {
+        title: 'Find regressions after deploy',
+        description: 'Сравни ошибки между двумя версиями релиза и определи, что появилось нового в candidate.',
+        argsSchema: {
+            baselineVersion: z.string().min(1).describe('Стабильная предыдущая версия, напр. v2.3.0.'),
+            candidateVersion: z.string().min(1).describe('Новая версия для анализа, напр. v2.4.0.'),
+        },
+    }, async (args) => {
+        const baseline = args.baselineVersion;
+        const candidate = args.candidateVersion;
+        const text = [
+            `Ты — release-engineer. Только что был развёрнут ${candidate}.`,
+            `До этого работал ${baseline}. Нужно проверить, нет ли регрессий.`,
+            '',
+            'Шаги:',
+            '',
+            `1. Вызови \`version_regression\` с baselineVersion=${baseline}, candidateVersion=${candidate}.`,
+            '2. Если в `newFingerprints` есть записи — для каждого из топ-3 по `count`:',
+            '   2.1. Вызови `find_similar_errors` с traceId примера.',
+            '   2.2. Если ошибка появилась впервые за последние 24 часа — пометь как "REGRESSION SUSPECT".',
+            '3. Если в `disappeared` есть записи — упомяни их кратко.',
+            '',
+            'Финальный отчёт — markdown:',
+            '',
+            `# Regression check ${baseline} → ${candidate}`,
+            '',
+            '## Новые fingerprint\'ы (suspect regressions)',
+            '| FP | Message | Count | First seen | Verdict |',
+            '|----|---------|-------|------------|---------|',
+            '',
+            '## Исчезнувшие',
+            '- ...',
+            '',
+            '## Рекомендация',
+            '- (rollback / hotfix / safe-to-ignore)',
+            '',
+            'Отвечай по-русски, без emoji.',
+        ].join('\n');
+        return userMessage(text);
+    });
+    registered.push('find-regression-since-deploy');
+    // ─── explain-error-cluster ───────────────────────────────────────────────
+    server.registerPrompt('explain-error-cluster', {
+        title: 'Explain error cluster',
+        description: 'Возьми traceId или fingerprint, собери контекст (similar, correlated) и объясни читабельно.',
+        argsSchema: {
+            traceId: z.string().optional().describe('TraceId конкретной ошибки.'),
+            fingerprint: z.string().optional().describe('Альтернатива traceId — fingerprint кластера.'),
+            locale: z.string().optional().describe('Язык объяснения: ru или en. Default: ru.'),
+        },
+    }, async (args) => {
+        const traceId = args.traceId;
+        const fingerprint = args.fingerprint;
+        const locale = args.locale ?? 'ru';
+        if (!traceId && !fingerprint) {
+            return userMessage('Не задан ни traceId, ни fingerprint. Уточни у пользователя одно из значений и повтори вызов prompt.');
+        }
+        const stepsTrace = traceId
+            ? [
+                `Старт: traceId=${traceId}.`,
+                '',
+                'Шаги:',
+                `1. \`get_log_details\` с traceId=${traceId}.`,
+                `2. \`find_similar_errors\` с этим же traceId.`,
+                `3. \`find_correlated_errors\` (windowMinutes=15).`,
+                `4. \`explain_error\` traceId=${traceId} — соберёт контекст; AI-summary в Phase 2 пустое, синтезируй сам.`,
+            ].join('\n')
+            : [
+                `Старт: fingerprint=${fingerprint}.`,
+                '',
+                'Шаги:',
+                `1. Вызови \`search_logs\` с filter \`fingerprint=${fingerprint}\`, limit=1 — получи свежий traceId.`,
+                '2. Дальше как с traceId — пункты 2-4.',
+            ].join('\n');
+        const text = [
+            'Объясни этот кластер ошибок понятно, как для junior-разработчика.',
+            '',
+            stepsTrace,
+            '',
+            `Финальный ответ (${locale}):`,
+            '- **Что произошло:** 1-2 предложения',
+            '- **Почему скорее всего:** 2-3 гипотезы, ранжированные',
+            '- **Какие ещё ошибки случались рядом:** перечисли correlated (если есть)',
+            '- **Что проверить руками:** конкретные команды / dashboards',
+            '',
+            'Без emoji. Без markdown-heavy форматирования вне нужного.',
+        ].join('\n');
+        return userMessage(text);
+    });
+    registered.push('explain-error-cluster');
+    // ─── weekly-error-report ─────────────────────────────────────────────────
+    server.registerPrompt('weekly-error-report', {
+        title: 'Weekly error report',
+        description: 'Сгенерируй markdown-отчёт за последние 7 дней: total, growth vs prev week, top fingerprints, регрессии, impact-priority.',
+        argsSchema: {
+            appSlug: z.string().min(1).describe('Slug приложения для отчёта.'),
+        },
+    }, async (args) => {
+        const appSlug = args.appSlug;
+        const locale = 'ru';
+        const text = [
+            `Подготовь еженедельный отчёт об ошибках для приложения ${appSlug}.`,
+            '',
+            'Окно: последние 7 дней. Сравни с предыдущей неделей.',
+            '',
+            'Шаги:',
+            '1. `error_stats_breakdown` с compareTo=previous-week.',
+            '2. `grouped_errors` take=10, sortBy=count.',
+            '3. Определи две последние версии в выборке через `error_histogram` (или прямо в фильтрах). Вызови `version_regression` baseline=prev, candidate=latest.',
+            '4. `impact_analysis` take=5 — приоритет на следующую неделю.',
+            '',
+            `Финальный отчёт (${locale}, markdown):`,
+            '',
+            `# Weekly Error Report — ${appSlug}`,
+            '**Период:** ...',
+            '**Тренд:** ↑/↓ NN%',
+            '',
+            '## Summary',
+            '- Total errors: ... (vs prev week: ...)',
+            '- Unique fingerprints: ...',
+            '- Affected users: ...',
+            '',
+            '## Top 10 проблем недели',
+            '| FP | Message | Count | trend |',
+            '|----|---------|-------|-------|',
+            '',
+            '## Регрессии (после deploy последней версии)',
+            '| FP | Message | First seen |',
+            '|----|---------|------------|',
+            '',
+            '## Приоритет на след. неделю (impact-ranked top-5)',
+            '1. ...',
+            '',
+            '## Что улучшилось',
+            '- ...',
+            '',
+            'Без emoji. Без «выводов» от себя — только данные.',
+        ].join('\n');
+        return userMessage(text);
+    });
+    registered.push('weekly-error-report');
+    opts.log?.info?.({ prompts: registered }, 'MCP prompts registered');
+    return registered;
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

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

package/dist/redaction/argsRedactor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Рекурсивная редакция структуры args / arbitrary JSON value.
+ *
+ * Для каждого string-value применяем `redactString` (regex PII). Для ключей
+ * password/token/secret/apiKey/authorization → drop value (заменяем на
+ * `[REDACTED]`). Не модифицируем исходный объект — возвращаем глубокий
+ * клон с применёнными правками.
+ *
+ * Ограничения:
+ *   - Защита от циклов через Set<seen>. При обнаружении цикла подставляем
+ *     строку `[CIRCULAR]`.
+ *   - Защита от глубоких структур: depth-limit 16, дальше — `[TRUNCATED]`.
+ */
+export interface RedactResult {
+    value: unknown;
+    fieldsHit: Set<string>;
+}
+/**
+ * Главный entrypoint для редакции произвольных args / JSON value.
+ */
+export declare function redactValue(input: unknown): RedactResult;
+//# sourceMappingURL=argsRedactor.d.ts.map

package/dist/redaction/argsRedactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argsRedactor.d.ts","sourceRoot":"","sources":["../../src/redaction/argsRedactor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4CH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxB;AA8CD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAIxD"}

package/dist/redaction/argsRedactor.js

@@ -0,0 +1,97 @@
+/**
+ * Рекурсивная редакция структуры args / arbitrary JSON value.
+ *
+ * Для каждого string-value применяем `redactString` (regex PII). Для ключей
+ * password/token/secret/apiKey/authorization → drop value (заменяем на
+ * `[REDACTED]`). Не модифицируем исходный объект — возвращаем глубокий
+ * клон с применёнными правками.
+ *
+ * Ограничения:
+ *   - Защита от циклов через Set<seen>. При обнаружении цикла подставляем
+ *     строку `[CIRCULAR]`.
+ *   - Защита от глубоких структур: depth-limit 16, дальше — `[TRUNCATED]`.
+ */
+import { redactString } from './fields.js';
+const SENSITIVE_KEYS = new Set([
+    'password',
+    'passwd',
+    'pwd',
+    'token',
+    'access_token',
+    'refresh_token',
+    'secret',
+    'apikey',
+    'api_key',
+    'authorization',
+    'cookie',
+    'set-cookie',
+    'session',
+    'csrf',
+    'private_key',
+    'client_secret',
+    'ssn',
+    'cardnumber',
+    'card_number',
+    'cvv',
+    'cvc',
+    // PII ключи — даже если значение «обычное», drop, чтобы не утекало
+    // в LLM-контекст через структурированный args. PII regex в текстовых
+    // полях обработает inline-вхождения (например, email в сообщении лога).
+    'email',
+    'mail',
+    'phone',
+    'ip',
+    'remoteaddr',
+    'remote_addr',
+]);
+const MAX_DEPTH = 16;
+const REDACTED_VALUE = '[REDACTED]';
+function isSensitiveKey(key) {
+    return SENSITIVE_KEYS.has(key.toLowerCase());
+}
+function redactInternal(input, fieldsHit, seen, depth) {
+    if (depth > MAX_DEPTH)
+        return '[TRUNCATED]';
+    if (input === null || input === undefined)
+        return input;
+    if (typeof input === 'string') {
+        const { value, fieldsHit: hits } = redactString(input);
+        for (const f of hits)
+            fieldsHit.add(f);
+        return value;
+    }
+    if (typeof input === 'number' || typeof input === 'boolean' || typeof input === 'bigint') {
+        return input;
+    }
+    if (Array.isArray(input)) {
+        if (seen.has(input))
+            return '[CIRCULAR]';
+        seen.add(input);
+        return input.map((v) => redactInternal(v, fieldsHit, seen, depth + 1));
+    }
+    if (typeof input === 'object') {
+        if (seen.has(input))
+            return '[CIRCULAR]';
+        seen.add(input);
+        const out = {};
+        for (const [k, v] of Object.entries(input)) {
+            if (isSensitiveKey(k)) {
+                fieldsHit.add(`key:${k.toLowerCase()}`);
+                out[k] = REDACTED_VALUE;
+                continue;
+            }
+            out[k] = redactInternal(v, fieldsHit, seen, depth + 1);
+        }
+        return out;
+    }
+    return input;
+}
+/**
+ * Главный entrypoint для редакции произвольных args / JSON value.
+ */
+export function redactValue(input) {
+    const fieldsHit = new Set();
+    const value = redactInternal(input, fieldsHit, new WeakSet(), 0);
+    return { value, fieldsHit };
+}
+//# sourceMappingURL=argsRedactor.js.map

package/dist/redaction/argsRedactor.js.map

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

package/dist/redaction/fields.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Regex-паттерны и маскировщики для PII redaction.
+ *
+ * Контракт: все функции — pure (без side effects), принимают строку и
+ * возвращают строку с применённой маской. Поведение детерминировано;
+ * порядок применения — IP → email → JWT → credit card → phone, чтобы более
+ * специфичные совпадения (например IP внутри текста) не были разрушены
+ * последующими более «жадными» regex'ами.
+ */
+/** IPv4: четыре октета 0–255, разделены `.`. */
+export declare const IPV4_RE: RegExp;
+/**
+ * IPv6 (упрощённо): 2–8 групп hex, разделённых `:`, с поддержкой `::`-сжатия.
+ * Не идеально, но покрывает типичные случаи в логах. False-positives на адресах
+ * вида `aaaa:bbbb` принимаемы — мы перестрахуемся.
+ */
+export declare const IPV6_RE: RegExp;
+/** Email: local-part + @ + domain. */
+export declare const EMAIL_RE: RegExp;
+/**
+ * JWT: три base64url-сегмента, разделённые точкой. Начало `eyJ` (header `{"`)
+ * добавлено как anchor для снижения false-positives.
+ */
+export declare const JWT_RE: RegExp;
+/** Bearer/Authorization header value. */
+export declare const BEARER_RE: RegExp;
+/**
+ * Phone: loose — от 8 цифр, **обязательно** с `+` префиксом или хотя бы
+ * одним разделителем (пробел / скобка / дефис). Это исключает совпадения
+ * с длинными числовыми ID и неаутентичными номерами карт.
+ */
+export declare const PHONE_RE: RegExp;
+/**
+ * Credit card: 13–19 цифр с опциональными разделителями. После regex применяем
+ * Luhn-check, чтобы не маскировать обычные числовые ID.
+ */
+export declare const CARD_RE: RegExp;
+/**
+ * Заменить IPv4 на «анонимизированный»: 192.168.1.42 → 192.168.1.0.
+ * IPv6 → /64 prefix (первые 4 группы + ::).
+ */
+export declare function maskIpv4(ip: string): string;
+export declare function maskIpv6(ip: string): string;
+/** Luhn algorithm для credit card validation. */
+export declare function luhnValid(digits: string): boolean;
+export declare const REDACTION_TOKENS: {
+    readonly ip: "[IP_REDACTED]";
+    readonly email: "[EMAIL_REDACTED]";
+    readonly jwt: "[JWT_REDACTED]";
+    readonly bearer: "[BEARER_REDACTED]";
+    readonly phone: "[PHONE_REDACTED]";
+    readonly card: "[CARD_REDACTED]";
+};
+/**
+ * Применить все базовые правки к строке. Порядок важен (см. §1).
+ *
+ * Возвращает { value, fieldsHit } — массив имён полей, которые сработали
+ * (для метрик / `_meta.redactionFields`).
+ */
+export declare function redactString(input: string): {
+    value: string;
+    fieldsHit: string[];
+};
+//# sourceMappingURL=fields.d.ts.map

package/dist/redaction/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/redaction/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gDAAgD;AAChD,eAAO,MAAM,OAAO,QAA+E,CAAC;AAEpG;;;;GAIG;AACH,eAAO,MAAM,OAAO,QAAqI,CAAC;AAE1J,sCAAsC;AACtC,eAAO,MAAM,QAAQ,QAAoD,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,MAAM,QAAyD,CAAC;AAE7E,yCAAyC;AACzC,eAAO,MAAM,SAAS,QAAuC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,QAAQ,QAA+E,CAAC;AAErG;;;GAGG;AACH,eAAO,MAAM,OAAO,QAA4B,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAK3C;AAgBD,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAejD;AAED,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAkDlF"}

package/dist/redaction/fields.js

@@ -0,0 +1,155 @@
+/**
+ * Regex-паттерны и маскировщики для PII redaction.
+ *
+ * Контракт: все функции — pure (без side effects), принимают строку и
+ * возвращают строку с применённой маской. Поведение детерминировано;
+ * порядок применения — IP → email → JWT → credit card → phone, чтобы более
+ * специфичные совпадения (например IP внутри текста) не были разрушены
+ * последующими более «жадными» regex'ами.
+ */
+/** IPv4: четыре октета 0–255, разделены `.`. */
+export const IPV4_RE = /\b(?:(?:25[0-5]|2[0-4]\d|1?\d{1,2})\.){3}(?:25[0-5]|2[0-4]\d|1?\d{1,2})\b/g;
+/**
+ * IPv6 (упрощённо): 2–8 групп hex, разделённых `:`, с поддержкой `::`-сжатия.
+ * Не идеально, но покрывает типичные случаи в логах. False-positives на адресах
+ * вида `aaaa:bbbb` принимаемы — мы перестрахуемся.
+ */
+export const IPV6_RE = /\b(?:[0-9a-fA-F]{1,4}:){2,7}[0-9a-fA-F]{1,4}\b|\b(?:[0-9a-fA-F]{1,4}:){1,7}:\b|\b::(?:[0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4}\b/g;
+/** Email: local-part + @ + domain. */
+export const EMAIL_RE = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g;
+/**
+ * JWT: три base64url-сегмента, разделённые точкой. Начало `eyJ` (header `{"`)
+ * добавлено как anchor для снижения false-positives.
+ */
+export const JWT_RE = /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g;
+/** Bearer/Authorization header value. */
+export const BEARER_RE = /\b[Bb]earer\s+[A-Za-z0-9._\-+/=]+/g;
+/**
+ * Phone: loose — от 8 цифр, **обязательно** с `+` префиксом или хотя бы
+ * одним разделителем (пробел / скобка / дефис). Это исключает совпадения
+ * с длинными числовыми ID и неаутентичными номерами карт.
+ */
+export const PHONE_RE = /(?<![\d])(?:\+\d[\d\s()\-]{6,}\d|\d{1,4}[\s\-()][\d\s()\-]{5,}\d)(?![\d])/g;
+/**
+ * Credit card: 13–19 цифр с опциональными разделителями. После regex применяем
+ * Luhn-check, чтобы не маскировать обычные числовые ID.
+ */
+export const CARD_RE = /\b(?:\d[ -]?){13,19}\b/g;
+/**
+ * Заменить IPv4 на «анонимизированный»: 192.168.1.42 → 192.168.1.0.
+ * IPv6 → /64 prefix (первые 4 группы + ::).
+ */
+export function maskIpv4(ip) {
+    const parts = ip.split('.');
+    if (parts.length !== 4)
+        return ip;
+    return `${parts[0]}.${parts[1]}.${parts[2]}.0`;
+}
+export function maskIpv6(ip) {
+    // Раскрыть `::`-сжатие до 8 групп, взять первые 4, склеить обратно с `::`.
+    const expanded = expandIpv6(ip);
+    if (!expanded)
+        return ip;
+    return `${expanded.slice(0, 4).join(':')}::/64`;
+}
+function expandIpv6(ip) {
+    if (!ip.includes(':'))
+        return null;
+    const [head, tail] = ip.split('::');
+    const headParts = head ? head.split(':') : [];
+    const tailParts = tail ? tail.split(':') : [];
+    const missing = 8 - headParts.length - tailParts.length;
+    if (missing < 0)
+        return null;
+    if (ip.includes('::')) {
+        return [...headParts, ...Array(missing).fill('0'), ...tailParts];
+    }
+    if (headParts.length !== 8)
+        return null;
+    return headParts;
+}
+/** Luhn algorithm для credit card validation. */
+export function luhnValid(digits) {
+    const clean = digits.replace(/\D/g, '');
+    if (clean.length < 13 || clean.length > 19)
+        return false;
+    let sum = 0;
+    let alt = false;
+    for (let i = clean.length - 1; i >= 0; i--) {
+        let n = parseInt(clean.charAt(i), 10);
+        if (alt) {
+            n *= 2;
+            if (n > 9)
+                n -= 9;
+        }
+        sum += n;
+        alt = !alt;
+    }
+    return sum % 10 === 0;
+}
+export const REDACTION_TOKENS = {
+    ip: '[IP_REDACTED]',
+    email: '[EMAIL_REDACTED]',
+    jwt: '[JWT_REDACTED]',
+    bearer: '[BEARER_REDACTED]',
+    phone: '[PHONE_REDACTED]',
+    card: '[CARD_REDACTED]',
+};
+/**
+ * Применить все базовые правки к строке. Порядок важен (см. §1).
+ *
+ * Возвращает { value, fieldsHit } — массив имён полей, которые сработали
+ * (для метрик / `_meta.redactionFields`).
+ */
+export function redactString(input) {
+    if (typeof input !== 'string' || input.length === 0) {
+        return { value: input, fieldsHit: [] };
+    }
+    const fieldsHit = new Set();
+    let out = input;
+    // IPv6 первым — он не пересекается с другими ID'шками так часто, как IPv4.
+    out = out.replace(IPV6_RE, (m) => {
+        const masked = maskIpv6(m);
+        if (masked !== m) {
+            fieldsHit.add('ip');
+            return masked;
+        }
+        return m;
+    });
+    out = out.replace(IPV4_RE, (m) => {
+        fieldsHit.add('ip');
+        return maskIpv4(m);
+    });
+    out = out.replace(JWT_RE, () => {
+        fieldsHit.add('jwt');
+        return REDACTION_TOKENS.jwt;
+    });
+    out = out.replace(BEARER_RE, () => {
+        fieldsHit.add('bearer');
+        return REDACTION_TOKENS.bearer;
+    });
+    out = out.replace(EMAIL_RE, () => {
+        fieldsHit.add('email');
+        return REDACTION_TOKENS.email;
+    });
+    out = out.replace(CARD_RE, (m) => {
+        if (luhnValid(m)) {
+            fieldsHit.add('card');
+            return REDACTION_TOKENS.card;
+        }
+        return m;
+    });
+    out = out.replace(PHONE_RE, (m) => {
+        // Игнорим, если в найденной подстроке уже подменили IP/Card/etc.
+        if (m.includes('[') && m.includes('_REDACTED]'))
+            return m;
+        // Минимум 8 цифр.
+        const digits = m.replace(/\D/g, '');
+        if (digits.length < 8)
+            return m;
+        fieldsHit.add('phone');
+        return REDACTION_TOKENS.phone;
+    });
+    return { value: out, fieldsHit: Array.from(fieldsHit) };
+}
+//# sourceMappingURL=fields.js.map

package/dist/redaction/fields.js.map

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

package/dist/redaction/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Pipeline редакции ErrorLog items перед возвратом из tools.
+ *
+ * Контракт:
+ *   - Не мутирует исходный объект, возвращает плоский клон.
+ *   - Применяет PII regex ко всем string-полям (включая компактные варианты).
+ *   - Анонимизирует `ip` (last octet → 0 для IPv4, /64 для IPv6).
+ *   - Усекает `userAgent` до family.
+ *   - Strip query из `url` и `referrer`.
+ *   - Оборачивает `message`/`stack` в `<untrusted>...</untrusted>` для compact/full форматов.
+ *   - Считает `suspiciousContent` по deny-list (см. promptInjection.ts).
+ *
+ * Конфиг управляется ENV (см. src/config.ts):
+ *   - MCP_REDACTION_ENABLED  (default true)
+ *   - MCP_REDACTION_FIELDS   (csv override — например `email,phone,jwt`)
+ */
+export interface RedactionConfig {
+    enabled: boolean;
+    /** Опциональный whitelist полей. Если задан — применяем только их. */
+    fields?: Set<string>;
+    /** Оборачивать ли строковые поля в <untrusted> при выводе. Default true. */
+    wrapUntrusted?: boolean;
+}
+export interface RedactionStats {
+    fieldsHit: string[];
+    suspiciousContentBlocked: boolean;
+    suspiciousRule?: string;
+}
+export declare const DEFAULT_REDACTION_CONFIG: RedactionConfig;
+export interface RedactItemOptions {
+    config?: RedactionConfig;
+}
+/**
+ * Редактирует один ErrorLog (или его compact-вариант). Возвращает новый объект.
+ */
+export declare function redactErrorLog<T extends Record<string, unknown>>(log: T, opts?: RedactItemOptions): {
+    value: T;
+    stats: RedactionStats;
+};
+/**
+ * Массовая редакция items. Объединяет stats по всем.
+ */
+export declare function redactErrorLogs<T extends Record<string, unknown>>(logs: T[], opts?: RedactItemOptions): {
+    items: T[];
+    stats: RedactionStats;
+};
+export { redactValue } from './argsRedactor.js';
+export { wrapUntrusted, detectSuspicious, containsSuspicious } from './promptInjection.js';
+export { userAgentFamily } from './userAgent.js';
+export { stripUrlQuery } from './url.js';
+export { redactString } from './fields.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/redaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redaction/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wBAAwB,EAAE,OAAO,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,wBAAwB,EAAE,eAGtC,CAAC;AA2BF,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,GAAG,EAAE,CAAC,EACN,IAAI,GAAE,iBAAsB,GAC3B;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CA2ErC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,GAAE,iBAAsB,GAC3B;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAiBvC;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}