micro-models-agent 2.11.0 → 2.13.1

package/dist/config/security.js

@@ -1,12 +1,12 @@
 /**
- * Default security configuration for MMA.
- * These settings provide a balance between security and usability.
+ * Дефолтный конфиг безопасности MMA.
+ * Баланс между защитой и удобством.
  */
 export const DEFAULT_SECURITY_CONFIG = {
     enabled: true,
     bash: {
         enabled: true,
-        // Commands that are always blocked (dangerous)
+        // Всегда блокируемые команды (опасные).
         blacklist: [
             "rm",
             "dd",
@@ -53,10 +53,10 @@ export const DEFAULT_SECURITY_CONFIG = {
             "python",
             "python3",
             "node",
-            // "bun" intentionally NOT blacklisted: the system prompt tells the model
-            // to run TypeScript with `bun <file.ts>` — banning it here contradicts
-            // that and burned a whole session on blocked `bun run build` calls.
-            // Arbitrary-code execution via flags is still caught by INTERPRETER_FLAGS.
+            // "bun" осознанно НЕ в блэклисте: системный промпт велит модели
+            // гонять TypeScript через `bun <file.ts>` — запрет здесь противоречил бы
+            // ему и сжёг целую сессию на блокированных `bun run build`.
+            // Произвольный код через флаги всё равно ловит INTERPRETER_FLAGS.
             "perl",
             "ruby",
             "del",
@@ -64,16 +64,15 @@ export const DEFAULT_SECURITY_CONFIG = {
             "erase",
             "taskkill",
         ],
-        // If whitelist is non-empty, only these commands are allowed
+        // Непустой whitelist — разрешены только эти команды.
         whitelist: [],
-        // Block dangerous flags like --force, -rf, etc.
+        // Блок опасных флагов вида --force, -rf и т.п.
         blockDangerousFlags: true,
-        // Log all executed commands to audit log
+        // Лог всех выполненных команд в аудит-лог.
         logCommands: true,
-        // Dangerous flags that are always blocked
-        // Note: -y/--yes are intentionally absent — they are routine, harmless
-        // confirmation flags (npm init -y, apt-get -y) and blocking them breaks
-        // project scaffolding.
+        // Всегда блокируемые опасные флаги.
+        // Замечание: -y/--yes осознанно отсутствуют — это рутинные безвредные
+        // флаги подтверждения (npm init -y, apt-get -y), их блок ломал бы скаффолдинг.
         dangerousFlags: [
             "--force",
             "-rf",
@@ -87,14 +86,14 @@ export const DEFAULT_SECURITY_CONFIG = {
             "--dangerous",
             "--no-confirm",
         ],
-        // Dangerous operators that are always blocked
-        // Note: "&" (background) is not blocked — "&&" (AND) is a legitimate shell operator.
-        // Single "&" for backgrounding is harmless and blocking it breaks "cd dir && npm install".
+        // Всегда блокируемые опасные операторы.
+        // Замечание: "&" (фон) не блокируется — "&&" (AND) легитимен. Одиночный "&"
+        // безвреден, а его блок ломал бы "cd dir && npm install".
         dangerousOperators: [">", ">>", "2>", "2>>", ";", "&&", "||", "|", "`", "$("],
     },
     paths: {
         enabled: false,
-        // Glob patterns for paths that are always denied
+        // Glob-паттерны всегда запрещённых путей.
         denied: [
             ".git/",
             "node_modules/",
@@ -111,36 +110,36 @@ export const DEFAULT_SECURITY_CONFIG = {
             "yarn.lock",
             "pnpm-lock.yaml",
         ],
-        // If allowed is non-empty, only these paths are allowed
+        // Непустой allowed — разрешены только эти пути.
         allowed: [],
     },
     network: {
-        // SSRF protection (private/link-local IPs, non-http schemes) is part of
-        // the balanced default policy — without this flag the checks in
-        // isUrlAllowed never fire and web tools can reach internal networks.
+        // SSRF-защита (приватные/link-local IP, не-http схемы) — часть сбалансированной
+        // дефолтной политики: без флага проверки isUrlAllowed не стреляют, и веб-тулы
+        // дотягиваются до внутренних сетей.
         enabled: true,
-        // Domains that are always denied
+        // Всегда запрещённые домены.
         deniedDomains: ["localhost", "127.0.0.1", "::1"],
-        // If allowedDomains is non-empty, only these domains are allowed
+        // Непустой allowedDomains — разрешены только эти домены.
         allowedDomains: [],
-        // Timeout for network requests (ms)
+        // Таймаут сетевых запросов (мс).
         requestTimeout: 15000,
-        // Maximum response size (bytes)
+        // Максимум размера ответа (байты).
         maxResponseSize: 15000,
     },
-    // Maximum depth of subagent recursion
+    // Максимум глубины рекурсии субагентов.
     maxRecursionDepth: 3,
-    // Maximum number of file operations per session
+    // Максимум файловых операций за сессию.
     maxFileOperations: 100,
-    // Rate limits for LLM requests
+    // Лимиты частоты LLM-запросов.
     rateLimits: {
         maxRequestsPerMinute: 60,
         maxParallelTasks: 5,
     },
-    // Content scanning settings
+    // Настройки сканирования контента.
     contentScan: {
         enabled: false,
-        // Patterns that are considered dangerous in file content
+        // Паттерны, считающиеся опасными в содержимом файлов.
         dangerousPatterns: [
             /eval\(/,
             /new Function\(/,
@@ -151,19 +150,19 @@ export const DEFAULT_SECURITY_CONFIG = {
             /require\('net'\)\.createServer/,
             /process\.exit\(/,
             /while\(true\)/,
-            /for\(\;\;\)/,
+            /for\(;;\)/,
             /rm -rf/,
             /dd if=/,
             /chmod 777/,
         ],
     },
-    // Session file encryption settings
+    // Настройки шифрования файлов сессии.
     sessionEncryption: {
         enabled: false,
         encryptHistory: true,
         encryptSessionLog: true,
     },
-    // Audit notification settings
+    // Настройки аудит-нотификаций.
     auditNotifier: {
         enabled: false,
         minSeverity: "medium",
@@ -173,8 +172,8 @@ export const DEFAULT_SECURITY_CONFIG = {
     },
 };
 /**
- * Merge user-provided security config with defaults.
- * User config takes precedence over defaults.
+ * Мержит пользовательский конфиг безопасности с дефолтами.
+ * Пользовательский конфиг приоритетнее.
  */
 export function mergeSecurityConfig(userConfig) {
     return {

package/dist/config/timeouts.js

@@ -0,0 +1,74 @@
+/**
+ * Канонический реестр таймаутов: все дефолтные ожидания/окна в миллисекундах.
+ *
+ * Правило: любое захардкоженное ожидание живёт здесь под именем с единицей
+ * измерения в суффиксе (`*_MS`), а модули импортируют его вместо локальных
+ * `const`. Значения — ровно те, что были захардкожены (поведение 1:1);
+ * реестр не перенастраивает поведение, только убирает дубли.
+ * Сгруппировано по доменам: llm, tools, mcp, lsp, browser, webui, misc.
+ */
+/* ── llm ─────────────────────────────────────────────────────────────── */
+/** Таймаут одного LLM-запроса (было `REQUEST_TIMEOUT_MS` в openai-compat). */
+export const LLM_REQUEST_TIMEOUT_MS = 120000;
+/** Макс. ожидание собственного rate-limit слота перед сдачей (openai-compat). */
+export const LLM_MAX_RATE_WAIT_MS = 30_000;
+/** TTL кэша каталога models.dev: перечитывать после 24 часов (models-dev). */
+export const MODELS_DEV_CATALOG_TTL_MS = 24 * 60 * 60 * 1000;
+/** Дефолтный таймаут запроса каталога models.dev (models-dev, был инлайн `?? 10000`). */
+export const MODELS_DEV_FETCH_TIMEOUT_MS = 10000;
+/** Дефолтный таймаут запросов баланса провайдера (provider-budget). */
+export const PROVIDER_BUDGET_TIMEOUT_MS = 5000;
+/* ── tools ───────────────────────────────────────────────────────────── */
+/** Окно автобэкграунда bash: команда, живая после него, уходит в фон. */
+export const BASH_GRACE_MS = 5000;
+/** Короткое окно для явного `background: true` — ловит ошибки спавна. */
+export const BASH_SPAWN_SETTLE_MS = 100;
+/** Дефолтный таймаут выполнения тула в исполнителе. */
+export const TOOL_EXECUTION_TIMEOUT_MS = 60000;
+/** Время жизни мемо-записи успешных read-only тулов. */
+export const TOOL_MEMO_TTL_MS = 120000;
+/** Дефолтное ожидание тула process_wait. */
+export const PROCESS_WAIT_DEFAULT_MS = 30000;
+/** Верхняя граница ожидания тула process_wait (кламп). */
+export const PROCESS_WAIT_MAX_MS = 110000;
+/* ── mcp ─────────────────────────────────────────────────────────────── */
+/** Таймаут первичного discovery тулов MCP-серверов (не вешать старт). */
+export const MCP_DISCOVERY_TIMEOUT_MS = 5_000;
+/** Дефолтный таймаут MCP HTTP-запросов (коннект + вызовы тулов). */
+export const MCP_HTTP_TIMEOUT_MS = 10_000;
+/* ── lsp ─────────────────────────────────────────────────────────────── */
+/** Дефолтный таймаут LSP-запроса (был `DEFAULT_TIMEOUT` в client). */
+export const LSP_DEFAULT_TIMEOUT_MS = 15000;
+/** Кап таймаута пробы LSP-сервера (probe). */
+export const LSP_PROBE_TIMEOUT_MS = 30_000;
+/** Общий дедлайн пробы LSP-серверов (probe). */
+export const LSP_PROBE_DEADLINE_MS = 60_000;
+/** Общий кап стартового health-check — старт сессии дольше не блокируем. */
+export const LSP_STARTUP_CHECK_TIMEOUT_MS = 60_000;
+/* ── browser ─────────────────────────────────────────────────────────── */
+/** Таймаут одного запроса к node-мосту браузера. */
+export const BROWSER_BRIDGE_REQUEST_TIMEOUT_MS = 30000;
+/** Таймаут прямого запуска Playwright до отката на node-мост. */
+export const BROWSER_DIRECT_LAUNCH_TIMEOUT_MS = 8000;
+/* ── webui ───────────────────────────────────────────────────────────── */
+/** Интервал флаша буферизованных SSE-чанков (`mma web`). */
+export const WEBUI_FORWARD_FLUSH_MS = 350;
+/* ── misc ────────────────────────────────────────────────────────────── */
+/** TTL кэша имён файлов факт-чекера галлюцинаций. */
+export const HALLUCINATION_NAME_CACHE_TTL_MS = 5_000;
+/** Кулдаун перескана ФС факт-чекера галлюцинаций. */
+export const HALLUCINATION_RESCAN_COOLDOWN_MS = 2_000;
+/** Таймаут LLM-судьи консистентности. */
+export const HALLUCINATION_JUDGE_TIMEOUT_MS = 15000;
+/** Дебаунс фонового typecheck после записи (lint-on-write). */
+export const LINT_TYPE_CHECK_DEBOUNCE_MS = 2000;
+/** TTL кэша пробы поддержки reasoning (повторная проба через 24 часа). */
+export const REASONING_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+/** Минимальный интервал между автопоисками ошибок (execution-модуль). */
+export const EXECUTION_ERROR_SEARCH_MIN_INTERVAL_MS = 30000;
+/** Таймаут скана одного локального порта (setup discovery). */
+export const SETUP_SCAN_TIMEOUT_MS = 2000;
+/** Таймаут запроса списка моделей провайдера (setup discovery). */
+export const SETUP_MODELS_TIMEOUT_MS = 5000;
+/** Таймаут дешёвой chat-пробы провайдера (setup discovery). */
+export const SETUP_CHAT_TIMEOUT_MS = 10000;

package/dist/config/utils.js

@@ -1,7 +1,7 @@
-// src/config/utils.ts
-// Shared deep-merge + RegExp-safe JSON helpers. Previously duplicated across
-// config.ts and domains.ts, where the two copies had drifted (config.ts
-// assigned RegExp by reference; domains.ts spread it into {} and destroyed it).
+// Общие хелперы конфига: deep-merge и RegExp-безопасный JSON.
+// Раньше дублировались в config.ts и domains.ts, причём копии разошлись
+// (config.ts присваивал RegExp по ссылке, domains.ts спредом ломал его в {}).
+/** Проверка на plain-объект (не массив/RegExp/Date). */
 export function isPlainObject(v) {
     if (typeof v !== "object" || v === null)
         return false;
@@ -9,15 +9,18 @@ export function isPlainObject(v) {
     return proto === Object.prototype || proto === null;
 }
 /**
- * Deep merge two objects. Arrays, scalars, and non-plain values (RegExp, Date)
- * in source replace target by reference — spreading a RegExp would silently
- * destroy it to {}.
+ * Глубокий мерж объектов. Массивы, скаляры и не-plain значения (RegExp, Date)
+ * из source заменяют target по ссылке: спред RegExp молча ломал бы его в {}.
  */
 export function deepMerge(target, source) {
-    const result = { ...target };
+    const result = {
+        ...target,
+    };
+    const srcRec = source;
+    const tgtRec = target;
     for (const key of Object.keys(source)) {
-        const srcVal = source[key];
-        const tgtVal = target[key];
+        const srcVal = srcRec[key];
+        const tgtVal = tgtRec[key];
         if (isPlainObject(srcVal) && isPlainObject(tgtVal)) {
             result[key] = deepMerge(tgtVal, srcVal);
         }
@@ -28,8 +31,8 @@ export function deepMerge(target, source) {
     return result;
 }
 /**
- * JSON replacer that serializes RegExp objects as {__regex, source, flags}
- * so they survive JSON.stringify/parse round-trips.
+ * JSON-replacer: сериализует RegExp как {__regex, source, flags}, чтобы они
+ * переживали round-trip JSON.stringify/parse.
  */
 export function regexReplacer(_key, value) {
     if (value instanceof RegExp) {
@@ -37,9 +40,7 @@ export function regexReplacer(_key, value) {
     }
     return value;
 }
-/**
- * JSON reviver that restores RegExp objects serialized by regexReplacer.
- */
+/** JSON-reviver: восстанавливает RegExp, сериализованные через regexReplacer. */
 export function regexReviver(_key, value) {
     if (value &&
         typeof value === "object" &&

package/dist/core/agent/artifact-progress.js

@@ -0,0 +1,59 @@
+/**
+ * Обобщённый детектор churn тест/спек-артефактов.
+ *
+ * Наблюдение (реальный прогон): модель писала `*.test.*`, но реализацию не
+ * создавала, а при падении тестов переписывала САМ тест — «подгоняла тесты
+ * под код» вместо реализации. Предметной привязки здесь нет: правило
+ * опирается только на путь файла и на то, идут ли write/edit подряд по
+ * тест/спек-файлам без единой правки production-кода, поэтому работает для
+ * любого языка и фреймворка.
+ *
+ * Nudge выдаётся один раз за прогон и является совещательным (не блокирует).
+ */
+const TEST_DIR_RE = /(^|[\\/])(tests?|specs?|__tests__|__specs__)([\\/]|$)/i;
+const TEST_FILE_PATTERNS = [
+    /\.(test|spec)\.[a-z0-9]+$/i, // foo.test.ts, foo.spec.js
+    /(^|[\\/])test_[^\\/]+$/i, // python: test_foo.py
+    /_test\.[a-z0-9]+$/i, // go: foo_test.go
+    /[\\/][A-Za-z0-9_]*Tests?\.[a-z0-9]+$/i, // Java/C#: FooTest.java
+    /[\\/][A-Za-z0-9_]*Specs?\.[a-z0-9]+$/i,
+];
+/** Является ли путь тестовым/спецификационным артефактом (мультиязычно). */
+export function isTestOrSpecPath(filePath) {
+    if (!filePath)
+        return false;
+    const normalized = filePath.replace(/\\/g, "/");
+    if (TEST_DIR_RE.test(normalized))
+        return true;
+    return TEST_FILE_PATTERNS.some((re) => re.test(normalized));
+}
+/** Начальное состояние трекера churn. */
+export function createArtifactChurnState() {
+    return { testWriteStreak: 0, lastTestFile: null, nudged: false };
+}
+/** Сколько подряд идущих тест/спек-правок достаточно, чтобы счесть это churn. */
+export const TEST_CHURN_THRESHOLD = 3;
+/** Учесть один write/edit по указанному пути. */
+export function recordArtifactWrite(state, filePath) {
+    if (!filePath)
+        return;
+    if (isTestOrSpecPath(filePath)) {
+        state.testWriteStreak++;
+        state.lastTestFile = filePath;
+    }
+    else {
+        // Любая правка production-файла = прогресс; серия тестов прервана.
+        state.testWriteStreak = 0;
+    }
+}
+/**
+ * Пора ли подтолкнуть модель: подряд идут только тест/спек-правки, а
+ * production-код не менялся. Возвращает путь проблемного файла или null.
+ */
+export function testChurnFile(state) {
+    if (state.nudged)
+        return null;
+    if (state.testWriteStreak < TEST_CHURN_THRESHOLD)
+        return null;
+    return state.lastTestFile;
+}

package/dist/core/agent/artifact-resolve.js

@@ -0,0 +1,79 @@
+/**
+ * Резолвер состояния файлов для проверки заявлений (Fix B2).
+ *
+ * Извлекает файлоподобные токены из финального ответа, смотрит их под baseDir
+ * и парсит машинопроверяемые форматы: JSON через `JSON.parse`, семейство XML
+ * через `checkXmlWellFormed`. Форматы с компилятором (TS/JS) — только existence:
+ * сборка внутри гейта была бы медленной и флаки, а плановые работы и так
+ * покрывает верификатор плана.
+ *
+ * Ограничен (макс. путей, макс. байт) и в jail: токены вне baseDir
+ * пропускаются, не читаются.
+ */
+import { readFileSync, statSync } from "node:fs";
+import { extname, isAbsolute, relative, resolve } from "node:path";
+import { extractFileLikeTokens } from "../../modules/hallucination/js-identifiers";
+import { checkXmlWellFormed } from "../../tools/syntax-validator";
+const MAX_PATHS = 10;
+const MAX_BYTES = 500 * 1024;
+const JSON_EXTS = new Set([".json", ".jsonc"]);
+const XML_EXTS = new Set([".xml", ".drawio", ".svg", ".xaml", ".plist", ".iml"]);
+function parseIfSupported(ext, content) {
+    if (JSON_EXTS.has(ext)) {
+        try {
+            JSON.parse(content);
+            return undefined;
+        }
+        catch (e) {
+            return `invalid JSON: ${e instanceof Error ? e.message.split("\n")[0] : String(e)}`;
+        }
+    }
+    if (XML_EXTS.has(ext)) {
+        return checkXmlWellFormed(content) ?? undefined;
+    }
+    return undefined;
+}
+/**
+ * Резолвит состояния артефактов, упомянутых в ответе (в пределах baseDir).
+ * @param baseDir корень workspace (jail); @param response финальный ответ модели.
+ * @returns состояния найденных артефактов (существует/ошибка парсинга).
+ */
+export function resolveArtifactStates(baseDir, response) {
+    if (!response)
+        return [];
+    const out = [];
+    for (const token of extractFileLikeTokens(response).slice(0, MAX_PATHS)) {
+        const abs = isAbsolute(token) ? token : resolve(baseDir, token);
+        const rel = relative(baseDir, abs);
+        if (rel.startsWith("..") || isAbsolute(rel))
+            continue;
+        const state = resolveOneArtifact(token, abs);
+        if (state)
+            out.push(state);
+    }
+    return out;
+}
+/** Смотрит один путь внутри jail (и парсит, если формат поддерживается). Null, если нечитаем. */
+function resolveOneArtifact(token, abs) {
+    let size;
+    try {
+        const st = statSync(abs);
+        if (!st.isFile())
+            return { path: token, exists: false };
+        size = st.size;
+    }
+    catch {
+        return { path: token, exists: false };
+    }
+    if (size > MAX_BYTES)
+        return { path: token, exists: true };
+    let content;
+    try {
+        content = readFileSync(abs, "utf-8");
+    }
+    catch {
+        // Нечитаем между stat и read — существует, но не проверен.
+        return { path: token, exists: true };
+    }
+    return { path: token, exists: true, parseError: parseIfSupported(extname(token).toLowerCase(), content) };
+}

package/dist/core/agent/audit-gate.js

@@ -1,3 +1,4 @@
+/** Финальный аудит ответа: принят, отклонён или повторы исчерпаны. */
 import { t } from "../../i18n/index";
 import { MAX_AUDIT_RETRIES } from "./constants";
 /**
@@ -15,7 +16,10 @@ export class AuditGate {
     constructor(finalAudit) {
         this.finalAudit = finalAudit;
     }
-    /** Возвращает null, если аудит не настроен (ответ принимается безусловно). */
+    /**
+     * Оценивает ответ через финальный аудит.
+     * @param deps состояние цикла и окружение; @returns вердикт либо null (аудит не настроен).
+     */
     async evaluate(deps) {
         if (!this.finalAudit)
             return null;
@@ -24,7 +28,7 @@ export class AuditGate {
             return { action: "pass" };
         const { state, logger, contextManager } = deps;
         state.iterAuditRejection = true;
-        logger.warn(`Final audit incomplete: ${audit.summary}`);
+        logger.diagnostic("warn", `Final audit incomplete: ${audit.summary}`);
         const steps = audit.pendingSteps.slice(0, 5).join("; ") || "—";
         contextManager.addMessage({
             role: "user",
@@ -37,7 +41,7 @@ export class AuditGate {
         state.auditRetries++;
         state.lastAuditSummary = audit.summary;
         if (state.auditRetries >= MAX_AUDIT_RETRIES || deps.iteration >= deps.maxIterations - 1) {
-            logger.warn(`Final audit still incomplete after ${state.auditRetries} retries — reporting failure`);
+            logger.diagnostic("warn", `Final audit still incomplete after ${state.auditRetries} retries — reporting failure`);
             state.auditFailed = true;
             return { action: "exhausted", summary: audit.summary };
         }

package/dist/core/agent/compaction.js

@@ -60,7 +60,7 @@ export class CompactionService {
             const result = contextManager.compact();
             if (!result)
                 return;
-            this.deps.logger.warn(`Low context quality (${quality}%) — forced compaction`);
+            this.deps.logger.diagnostic("warn", `Low context quality (${quality}%) — forced compaction`);
             this.deps.slog.logCompaction({
                 reason: `quality-triggered (${quality}% < ${QUALITY_TRIGGER_THRESHOLD}%)`,
                 iteration,
@@ -78,7 +78,7 @@ export class CompactionService {
         const result = contextManager.compact();
         if (!result)
             return;
-        this.deps.logger.warn(`Context overflow (${currentTokens} > ${budget.history}), forced compaction`);
+        this.deps.logger.diagnostic("warn", `Context overflow (${currentTokens} > ${budget.history}), forced compaction`);
         this.deps.slog.logCompaction({
             reason: `overflow (${currentTokens} > ${budget.history})`,
             iteration,

package/dist/core/agent/constants.js

@@ -1,8 +1,6 @@
 /**
- * Константы агентного цикла. Вынесены из agent.ts, чтобы:
- * 1) не растекаться магическими числами по модулям;
- * 2) быть переиспользуемыми между extracted-модулями (compaction, tool-batch и т.д.);
- * 3) каждая константа несёт JSDoc с обоснованием значения.
+ * Константы агентного цикла. Вынесены из agent.ts: без магических чисел,
+ * переиспользуются extracted-модулями, каждая константа несёт JSDoc-обоснование.
  */
 /** Макс. доля бюджета истории под результат одного тула (по токенам). */
 export const TOOL_RESULT_MAX_TOKENS_RATIO = 0.3;
@@ -20,6 +18,13 @@ export const QUALITY_TRIGGER_THRESHOLD = 40;
  * которое уже несёт результат.
  */
 export const TOOL_ARGS_SUMMARY_MAX_CHARS = 240;
+/**
+ * Макс. длина одного строкового значения аргумента в <system-summary>.
+ * Более длинные значения (content/new_string/text) заменяются на `…(N chars)`:
+ * их полный текст уже присутствует в assistant-сообщении с tool_calls и в
+ * role:"tool" результате, поэтому дублировать тело в сводке не нужно.
+ */
+export const TOOL_ARG_VALUE_MAX_CHARS = 48;
 /**
  * Мин. число итераций между принудительными компакциями по качеству.
  * Без него компакция не может восстановить качество и выжигает весь
@@ -30,8 +35,32 @@ export const FORCED_COMPACTION_COOLDOWN = 3;
 export const MAX_LLM_ERROR_RETRIES = 2;
 /** Макс. повторов при вердикте халлюцинации "retry". */
 export const MAX_HALLUCINATION_RETRIES = 3;
+/**
+ * Макс. перепроверок заявления об успехе против свежих результатов тулов
+ * (success-claim check). Одна попытка: либо модель сверяется и правит
+ * формулировку, либо ответ принимается как есть (fail-open, не блок).
+ */
+export const MAX_CLAIM_CHECK_RETRIES = 1;
 /** Порог подряд идущих неудач тулов до сообщения о восстановлении. */
 export const MAX_CONSECUTIVE_TOOL_FAILURES = 5;
+/**
+ * Порог подряд идущих ПОЛНОСТЬЮ провальных пакетов тулов (каждый вызов —
+ * неудача или tool-level блок вроде `[SECURITY BLOCKED]`) до honest-stop
+ * директивы. Ниже, чем MAX_CONSECUTIVE_TOOL_FAILURES: смешанные пакеты
+ * (успех + неудача) и успехи сбрасывают счётчик, поэтому срабатывание
+ * означает именно топтание без прогресса (наблюдалось: qwen3.5-9b перебирал
+ * python/python3/bun/pip/npx после двух блоков, не останавливаясь).
+ * Plugin-level блоки (`result.blocked`, guard-rails) в счётчик не входят —
+ * см. контракт ToolResult.blocked.
+ */
+export const MAX_CONSECUTIVE_FAILED_BATCHES = 4;
+/**
+ * Жёсткая остановка retry-петли: столько полностью провальных пакетов подряд
+ * (директива honest-stop уже проигнорирована) — цикл прерывается с честной
+ * ошибкой вместо сжигания контекста. Зазор +2 к директиве даёт модели шанс
+ * остановиться самой или предложить честный ответ.
+ */
+export const HARD_STOP_FAILED_BATCHES = 6;
 /**
  * Мин. общих (не подряд идущих) неудач тула до записи правила в память.
  * Фиксирует системные проблемы (ENOENT у LSP, сломанный конфиг), которые