micro-models-agent 2.16.1 → 2.17.2

package/dist/config/security.js

@@ -1,212 +0,0 @@
-/**
- * Дефолтный конфиг безопасности MMA.
- * Баланс между защитой и удобством.
- */
-export const DEFAULT_SECURITY_CONFIG = {
-    enabled: true,
-    bash: {
-        enabled: true,
-        // Всегда блокируемые команды (опасные).
-        blacklist: [
-            "rm",
-            "dd",
-            "chmod",
-            "wget",
-            "curl",
-            "scp",
-            "ssh",
-            "nc",
-            "netcat",
-            "mknod",
-            "mkfifo",
-            "ln",
-            "chown",
-            "chgrp",
-            "useradd",
-            "usermod",
-            "passwd",
-            "sudo",
-            "su",
-            "exec",
-            "eval",
-            "source",
-            "kill",
-            "pkill",
-            "killall",
-            "shutdown",
-            "reboot",
-            "halt",
-            "poweroff",
-            "format",
-            "fdisk",
-            "parted",
-            "mkfs",
-            "mount",
-            "umount",
-            "powershell",
-            "pwsh",
-            "cmd",
-            "bash",
-            "sh",
-            "zsh",
-            "dash",
-            "python",
-            "python3",
-            "node",
-            // "bun" осознанно НЕ в блэклисте: системный промпт велит модели
-            // гонять TypeScript через `bun <file.ts>` — запрет здесь противоречил бы
-            // ему и сжёг целую сессию на блокированных `bun run build`.
-            // Произвольный код через флаги всё равно ловит INTERPRETER_FLAGS.
-            "perl",
-            "ruby",
-            "del",
-            "rd",
-            "erase",
-            "taskkill",
-        ],
-        // Непустой whitelist — разрешены только эти команды.
-        whitelist: [],
-        // Блок опасных флагов вида --force, -rf и т.п.
-        blockDangerousFlags: true,
-        // Лог всех выполненных команд в аудит-лог.
-        logCommands: true,
-        // Всегда блокируемые опасные флаги.
-        // Замечание: -y/--yes осознанно отсутствуют — это рутинные безвредные
-        // флаги подтверждения (npm init -y, apt-get -y), их блок ломал бы скаффолдинг.
-        dangerousFlags: [
-            "--force",
-            "-rf",
-            "--no-preserve-root",
-            "--recursive",
-            "--all",
-            "-x",
-            "-e",
-            "--delete",
-            "--remove",
-            "--dangerous",
-            "--no-confirm",
-        ],
-        // Всегда блокируемые опасные операторы.
-        // Замечание: "&" (фон) не блокируется — "&&" (AND) легитимен. Одиночный "&"
-        // безвреден, а его блок ломал бы "cd dir && npm install".
-        dangerousOperators: [">", ">>", "2>", "2>>", ";", "&&", "||", "|", "`", "$("],
-    },
-    paths: {
-        enabled: false,
-        // Glob-паттерны всегда запрещённых путей.
-        denied: [
-            ".git/",
-            "node_modules/",
-            ".env",
-            "*.key",
-            "*.pem",
-            "*.crt",
-            "*.p12",
-            "*.pfx",
-            "*.secret",
-            "*.token",
-            "package-lock.json",
-            "bun.lock",
-            "yarn.lock",
-            "pnpm-lock.yaml",
-        ],
-        // Непустой allowed — разрешены только эти пути.
-        allowed: [],
-    },
-    network: {
-        // SSRF-защита (приватные/link-local IP, не-http схемы) — часть сбалансированной
-        // дефолтной политики: без флага проверки isUrlAllowed не стреляют, и веб-тулы
-        // дотягиваются до внутренних сетей.
-        enabled: true,
-        // Всегда запрещённые домены.
-        deniedDomains: ["localhost", "127.0.0.1", "::1"],
-        // Непустой allowedDomains — разрешены только эти домены.
-        allowedDomains: [],
-        // Таймаут сетевых запросов (мс).
-        requestTimeout: 15000,
-        // Максимум размера ответа (байты).
-        maxResponseSize: 15000,
-    },
-    // Максимум глубины рекурсии субагентов.
-    maxRecursionDepth: 3,
-    // Максимум файловых операций за сессию.
-    maxFileOperations: 100,
-    // Лимиты частоты LLM-запросов.
-    rateLimits: {
-        maxRequestsPerMinute: 60,
-        maxParallelTasks: 5,
-    },
-    // Настройки сканирования контента.
-    contentScan: {
-        enabled: false,
-        // Паттерны, считающиеся опасными в содержимом файлов.
-        dangerousPatterns: [
-            /eval\(/,
-            /new Function\(/,
-            /child_process\.exec\(/,
-            /child_process\.spawn\(/,
-            /require\('child_process'\)/,
-            /require\('http'\)\.createServer/,
-            /require\('net'\)\.createServer/,
-            /process\.exit\(/,
-            /while\(true\)/,
-            /for\(;;\)/,
-            /rm -rf/,
-            /dd if=/,
-            /chmod 777/,
-        ],
-    },
-    // Настройки шифрования файлов сессии.
-    sessionEncryption: {
-        enabled: false,
-        encryptHistory: true,
-        encryptSessionLog: true,
-    },
-    // Настройки аудит-нотификаций.
-    auditNotifier: {
-        enabled: false,
-        minSeverity: "medium",
-        eventTypes: ["security_block", "bash_command", "file_operation", "network_request"],
-        maxRetries: 3,
-        webhookTimeout: 5000,
-    },
-};
-/**
- * Мержит пользовательский конфиг безопасности с дефолтами.
- * Пользовательский конфиг приоритетнее.
- */
-export function mergeSecurityConfig(userConfig) {
-    return {
-        enabled: userConfig?.enabled ?? DEFAULT_SECURITY_CONFIG.enabled,
-        bash: {
-            ...DEFAULT_SECURITY_CONFIG.bash,
-            ...userConfig?.bash,
-        },
-        paths: {
-            ...DEFAULT_SECURITY_CONFIG.paths,
-            ...userConfig?.paths,
-        },
-        network: {
-            ...DEFAULT_SECURITY_CONFIG.network,
-            ...userConfig?.network,
-        },
-        maxRecursionDepth: userConfig?.maxRecursionDepth ?? DEFAULT_SECURITY_CONFIG.maxRecursionDepth,
-        maxFileOperations: userConfig?.maxFileOperations ?? DEFAULT_SECURITY_CONFIG.maxFileOperations,
-        rateLimits: {
-            ...DEFAULT_SECURITY_CONFIG.rateLimits,
-            ...userConfig?.rateLimits,
-        },
-        contentScan: {
-            ...DEFAULT_SECURITY_CONFIG.contentScan,
-            ...userConfig?.contentScan,
-        },
-        sessionEncryption: {
-            ...DEFAULT_SECURITY_CONFIG.sessionEncryption,
-            ...userConfig?.sessionEncryption,
-        },
-        auditNotifier: {
-            ...DEFAULT_SECURITY_CONFIG.auditNotifier,
-            ...userConfig?.auditNotifier,
-        },
-    };
-}

package/dist/config/timeouts.js

@@ -1,74 +0,0 @@
-/**
- * Канонический реестр таймаутов: все дефолтные ожидания/окна в миллисекундах.
- *
- * Правило: любое захардкоженное ожидание живёт здесь под именем с единицей
- * измерения в суффиксе (`*_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/types.js

@@ -1 +0,0 @@
-export {};

package/dist/config/utils.js

@@ -1,57 +0,0 @@
-// Общие хелперы конфига: 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;
-    const proto = Object.getPrototypeOf(v);
-    return proto === Object.prototype || proto === null;
-}
-/**
- * Глубокий мерж объектов. Массивы, скаляры и не-plain значения (RegExp, Date)
- * из source заменяют target по ссылке: спред RegExp молча ломал бы его в {}.
- */
-export function deepMerge(target, source) {
-    const result = {
-        ...target,
-    };
-    const srcRec = source;
-    const tgtRec = target;
-    for (const key of Object.keys(source)) {
-        const srcVal = srcRec[key];
-        const tgtVal = tgtRec[key];
-        if (isPlainObject(srcVal) && isPlainObject(tgtVal)) {
-            result[key] = deepMerge(tgtVal, srcVal);
-        }
-        else if (srcVal !== undefined) {
-            result[key] = srcVal;
-        }
-    }
-    return result;
-}
-/**
- * JSON-replacer: сериализует RegExp как {__regex, source, flags}, чтобы они
- * переживали round-trip JSON.stringify/parse.
- */
-export function regexReplacer(_key, value) {
-    if (value instanceof RegExp) {
-        return { __regex: true, source: value.source, flags: value.flags };
-    }
-    return value;
-}
-/** JSON-reviver: восстанавливает RegExp, сериализованные через regexReplacer. */
-export function regexReviver(_key, value) {
-    if (value &&
-        typeof value === "object" &&
-        value.__regex === true) {
-        const { source, flags } = value;
-        try {
-            return new RegExp(source, flags);
-        }
-        catch {
-            return value;
-        }
-    }
-    return value;
-}

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

@@ -1,59 +0,0 @@
-/**
- * Обобщённый детектор 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

@@ -1,79 +0,0 @@
-/**
- * Резолвер состояния файлов для проверки заявлений (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,53 +0,0 @@
-/** Финальный аудит ответа: принят, отклонён или повторы исчерпаны. */
-import { t } from "../../i18n/index";
-import { MAX_AUDIT_RETRIES } from "./constants";
-/**
- * Финальный аудит-вентиль: проверяет, что текстовый ответ действительно
- * выполнил задачу (при активном плане/скрипте), прежде чем принять его.
- *
- * Отклонение переспрашивает модель через <system-summary> и взводит
- * suppressRepetitionRetry — повторный ответ на выполненную задачу
- * естественно "повторяющийся" и не должен жечь бюджет халлюцинаций.
- * Исчерпание повторов (MAX_AUDIT_RETRIES или упор в лимит итераций)
- * переводит цикл в состояние auditFailed → success:false.
- */
-export class AuditGate {
-    finalAudit;
-    constructor(finalAudit) {
-        this.finalAudit = finalAudit;
-    }
-    /**
-     * Оценивает ответ через финальный аудит.
-     * @param deps состояние цикла и окружение; @returns вердикт либо null (аудит не настроен).
-     */
-    async evaluate(deps) {
-        if (!this.finalAudit)
-            return null;
-        const audit = await this.finalAudit();
-        if (!audit || audit.passed)
-            return { action: "pass" };
-        const { state, logger, contextManager } = deps;
-        state.iterAuditRejection = true;
-        logger.diagnostic("warn", `Final audit incomplete: ${audit.summary}`);
-        const steps = audit.pendingSteps.slice(0, 5).join("; ") || "—";
-        contextManager.addMessage({
-            role: "user",
-            content: `<system-summary>${t("exec.audit_incomplete", {
-                summary: audit.summary,
-                steps,
-            })}</system-summary>`,
-        });
-        deps.slog.logAudit(audit.summary, deps.iteration);
-        state.auditRetries++;
-        state.lastAuditSummary = audit.summary;
-        if (state.auditRetries >= MAX_AUDIT_RETRIES || deps.iteration >= deps.maxIterations - 1) {
-            logger.diagnostic("warn", `Final audit still incomplete after ${state.auditRetries} retries — reporting failure`);
-            state.auditFailed = true;
-            return { action: "exhausted", summary: audit.summary };
-        }
-        // Следующий текстовый ответ — принудительный повтор уже выполненной
-        // задачи: разрешаем одну повторность без халлюцинационного повтора.
-        state.suppressRepetitionRetry = true;
-        return { action: "reject" };
-    }
-}

package/dist/core/agent/compaction.js

@@ -1,89 +0,0 @@
-import { FORCED_COMPACTION_COOLDOWN, QUALITY_TRIGGER_THRESHOLD } from "./constants";
-/**
- * Единая точка компакции контекста. В agent.ts логика дублировалась в 4 местах:
- * 1) интервал (needsCompaction) в начале итерации;
- * 2) принудительно по низкому качеству (< QUALITY_TRIGGER_THRESHOLD) с cooldown;
- * 3) принудительно по переполнению бюджета истории;
- * 4) после добавления результата тула.
- *
- * Все четыре консолидированы здесь и выполняют одинаковый контракт:
- * компакция → логирование в session log → обогащение детектора халлюцинаций
- * известными файлами из сводки.
- */
-export class CompactionService {
-    deps;
-    constructor(deps) {
-        this.deps = deps;
-    }
-    /**
-     * Пре-итерационные проверки: интервал → качество → переполнение.
-     * Порядок сохранён из оригинального цикла: каждая следующая проверка
-     * видит контекст уже ПОСЛЕ предыдущей компакции.
-     */
-    compactIfNeeded(state) {
-        this.compactOnInterval(state.iteration);
-        this.compactOnQuality(state);
-        this.compactOnOverflow(state.iteration);
-    }
-    /** Проверка после добавления результата тула в контекст. */
-    compactAfterTool(state) {
-        const { contextManager } = this.deps;
-        if (!contextManager.needsCompaction())
-            return;
-        const result = contextManager.compact();
-        if (!result)
-            return;
-        this.deps.logger.debug("Context compacted after tool result");
-        this.deps.slog.logCompaction({ reason: "after_tool", iteration: state.iteration, ...result });
-        this.deps.hallucinationDetector.addKnownFiles(contextManager.getKnownFiles());
-    }
-    compactOnInterval(iteration) {
-        const { contextManager } = this.deps;
-        if (!contextManager.needsCompaction())
-            return;
-        const result = contextManager.compact();
-        if (!result)
-            return;
-        this.deps.logger.debug("Context compacted");
-        this.deps.slog.logCompaction({ reason: "interval", iteration, ...result });
-        this.deps.hallucinationDetector.addKnownFiles(contextManager.getKnownFiles());
-    }
-    compactOnQuality(state) {
-        const { contextManager } = this.deps;
-        const iteration = state.iteration;
-        const quality = contextManager.getQuality();
-        const cooldownElapsed = iteration - state.lastForcedCompactionIteration >= FORCED_COMPACTION_COOLDOWN;
-        if (quality < QUALITY_TRIGGER_THRESHOLD &&
-            contextManager.getCompactionCount() > 0 &&
-            cooldownElapsed) {
-            state.lastForcedCompactionIteration = iteration;
-            const result = contextManager.compact();
-            if (!result)
-                return;
-            this.deps.logger.diagnostic("warn", `Low context quality (${quality}%) — forced compaction`);
-            this.deps.slog.logCompaction({
-                reason: `quality-triggered (${quality}% < ${QUALITY_TRIGGER_THRESHOLD}%)`,
-                iteration,
-                ...result,
-            });
-            this.deps.hallucinationDetector.addKnownFiles(contextManager.getKnownFiles());
-        }
-    }
-    compactOnOverflow(iteration) {
-        const { contextManager } = this.deps;
-        const currentTokens = contextManager.getEstimatedTokens();
-        const budget = contextManager.getBudget();
-        if (currentTokens <= budget.history)
-            return;
-        const result = contextManager.compact();
-        if (!result)
-            return;
-        this.deps.logger.diagnostic("warn", `Context overflow (${currentTokens} > ${budget.history}), forced compaction`);
-        this.deps.slog.logCompaction({
-            reason: `overflow (${currentTokens} > ${budget.history})`,
-            iteration,
-            ...result,
-        });
-        this.deps.hallucinationDetector.addKnownFiles(contextManager.getKnownFiles());
-    }
-}