micro-models-agent 2.11.0 → 2.12.0

package/dist/core/bootstrap/session-phase.js

@@ -0,0 +1,204 @@
+/**
+ * Фаза 4 bootstrap: сессии, context-лог, менеджер контекста и ToolContext.
+ *
+ * Порядок 1:1 с исходником: SessionStore/SessionManager (+ привязка ленивого
+ * session id фазы провайдера, autoSave) → запись context-probe в сессию фоном
+ * → ContextLogger (opt-in) → TokenCounter/activeToolTags/ContextManager →
+ * общий бокс живого конфига → ToolContext с живыми геттерами (config,
+ * sessionId, sessionContext, sessionManager, capabilities) → ToolExecutor →
+ * HallucinationDetector.
+ *
+ * Shared mutable state вынесен вместе с фазой: `configRef` (живой бокс
+ * конфига) и сам `toolCtx` возвращаются наружу следующим фазам.
+ */
+import { join } from "path";
+import { ContextManager } from "../../modules/context/manager";
+import { TokenCounter } from "../../llm/token-counter";
+import { ToolExecutor } from "../../tools/executor";
+import { HallucinationDetector } from "../../modules/hallucination/detector";
+import { SessionStore, SessionManager } from "../../modules/session/index";
+import { BUILTIN_PROVIDERS } from "../../modules/providers/presets";
+import { resolveModelCapabilities } from "../../modules/providers/capabilities";
+import { ContextLogger } from "../agent/context-log";
+import { t } from "../../i18n/index";
+import { errMsg } from "../../utils";
+/**
+ * Поднимает сессии, контекст и общий ToolContext.
+ * @param input связный вход фазы (см. SessionPhaseInput).
+ * @returns менеджер сессий, контекст, toolCtx и исполнители.
+ */
+export async function setupSessionPhase(input) {
+    const { config, logger, dir, baseDir, exitOnComplete, contextLogFlag, contextProbePromise, capabilitiesRef, llmProvider, bindSessionManager, toolRegistry, pluginManager, } = input;
+    const sessionDir = join(dir, "sessions");
+    const sessionStore = new SessionStore(sessionDir, config.security?.sessionEncryption);
+    sessionStore.init();
+    // Архивируем сессии старше 30 дней (gzip истории + метка rotated). Был мёртвый
+    // код — не вызывался, старые сессии не сжимались. Отложено, чтобы синхронное
+    // сжатие старт не тормозило; сбои не фатальны.
+    setTimeout(() => {
+        try {
+            sessionStore.rotateOldSessions();
+        }
+        catch (err) {
+            logger.warn(`session rotation failed: ${String(err)}`);
+        }
+    }, 0);
+    const sessionManager = new SessionManager(sessionStore, {
+        model: config.model,
+        contextWindow: config.contextWindow,
+        projectDir: baseDir,
+        maxSessions: config.session.maxSessions,
+        isolation: config.sessionIsolation,
+    });
+    bindSessionManager(() => sessionManager);
+    if (config.session.autoSave && !sessionManager.getActive()) {
+        sessionManager.create();
+    }
+    // Context-пробу — в сессию сразу по резолву, в ОБОИХ режимах (интерактив и
+    // one-shot). Раньше писал только REPL, и one-shot терял расхождение
+    // загруженного vs настроенного контекста целиком (наблюдалось: LM Studio
+    // держит 86016 при contextWindow 32768 — молча).
+    void contextProbePromise
+        .then((probe) => {
+        if (!probe)
+            return;
+        try {
+            sessionManager.appendLog({
+                ts: new Date().toISOString(),
+                type: "context_probe",
+                content: `model=${probe.model} actual=${probe.actual} configured=${config.contextWindow}`,
+            });
+        }
+        catch {
+            // best-effort
+        }
+    })
+        .catch(() => { });
+    // Git-style лог контекста (opt-in через --context-log / конфиг / env). Рядом
+    // с файлами сессии, чтобы путешествовал с ней. Best-effort: лог не должен
+    // ломать прогон никогда.
+    const contextLogEnabled = contextLogFlag === true || config.contextLog?.enabled === true;
+    let contextLogger;
+    if (contextLogEnabled) {
+        const activeMeta = sessionManager.getActiveMeta();
+        if (activeMeta) {
+            try {
+                contextLogger = new ContextLogger({
+                    path: join(sessionStore.getSessionDir(activeMeta.id), "context.diff"),
+                    sessionId: activeMeta.id,
+                    model: config.model,
+                    contextWindow: config.contextWindow,
+                    redact: config.contextLog?.redact !== false,
+                });
+            }
+            catch (err) {
+                logger.warn(t("error.context_log_init", { error: errMsg(err) }));
+                contextLogger = undefined;
+            }
+        }
+    }
+    const tokenCounter = new TokenCounter(config.model);
+    // Мутабельный набор активных тегов тулов — общий у цикла агента и тула
+    // `enable_tools`. Цикл перечитывает его каждую итерацию для пересборки
+    // видимого модели набора; enable_tools дотолкивает теги внутрь. При выключенном
+    // on-demand набор пуст — легаси «все тулы» (getAllForLLM на пустых отдаёт всё).
+    const enableOnDemand = config.tools?.enableOnDemand !== false;
+    const activeToolTags = enableOnDemand
+        ? config.tools?.defaultTags
+            ? [...config.tools.defaultTags]
+            : []
+        : [];
+    const contextManager = new ContextManager(config.contextWindow, config.contextBudget, tokenCounter);
+    // Общий бокс ЖИВОГО конфига. `Agent.reconfigure` меняет и deps.config, и
+    // этот бокс, чтобы захватившие ссылку при bootstrap — toolCtx.config,
+    // валидаторы, правила тулов — видели ТЕКУЩИЕ настройки после /model use или
+    // визарда. Фиксация значения раз означала: тулы весь сеанс enforced
+    // до-reconfigure security/maxTool.
+    const configRef = { current: config };
+    const toolCtx = {
+        baseDir,
+        logger,
+        exitOnComplete,
+        contextManager,
+        activeToolTags,
+        recursionDepth: 0,
+        fileOperationsCount: 0,
+        sessionHistory: {
+            append: async (type, content) => {
+                const meta = sessionManager.getActiveMeta();
+                if (!meta)
+                    return;
+                sessionManager.appendMessage({
+                    role: "tool",
+                    content: typeof content === "string" ? content : JSON.stringify(content),
+                    name: type,
+                    timestamp: new Date().toISOString(),
+                });
+            },
+        },
+        sessionLog: {
+            plan: (event, detail, iteration) => {
+                sessionManager.appendLog({
+                    ts: new Date().toISOString(),
+                    type: "plan",
+                    tool: event,
+                    content: detail,
+                    ...(iteration !== undefined ? { iteration } : {}),
+                });
+            },
+        },
+    };
+    // `config` — ЖИВОЙ геттер поверх общего configRef: тулы и валидаторы видят
+    // ТЕКУЩИЕ настройки после reconfigure.
+    Object.defineProperty(toolCtx, "config", {
+        get: () => configRef.current,
+        configurable: true,
+    });
+    // `sessionId`/`sessionContext` — ЖИВЫЕ геттеры поверх менеджера сессий, а не
+    // снимок при bootstrap. Снимок пинил сессию старта, и после REPL /new или
+    // /resume записи audit.jsonl новой сессии тегировались id ПРЕДЫДУЩЕЙ
+    // (наблюдалось: записи ses_msyghz8w с id ses_msyg892p_78kqhc), а sessionHistory
+    // читал живую мету. Теперь потребители ctx.sessionId — аудит, реестр
+    // процессов, счётчики файлов — всегда видят реально активную сессию.
+    Object.defineProperty(toolCtx, "sessionId", {
+        get: () => sessionManager.getActiveMeta()?.id,
+        configurable: true,
+    });
+    Object.defineProperty(toolCtx, "sessionContext", {
+        get: () => sessionManager.getSessionContext() ?? undefined,
+        configurable: true,
+    });
+    Object.defineProperty(toolCtx, "sessionManager", {
+        get: () => sessionManager,
+        configurable: true,
+    });
+    // Возможности активной модели — LIVE: пресет провайдера + native-probe +
+    // конфиг-оверрайд пересчитываются при каждом обращении тула, поэтому
+    // инструменты (browser и т.п.) видят актуальный vision/tools после
+    // смены модели или /provider use.
+    Object.defineProperty(toolCtx, "capabilities", {
+        get: () => {
+            const cfg = configRef.current;
+            const spec = BUILTIN_PROVIDERS.find((p) => p.type === cfg.provider.type);
+            return resolveModelCapabilities(spec?.capabilities, capabilitiesRef.probe, cfg.modelCapabilities?.[cfg.model]);
+        },
+        configurable: true,
+    });
+    const toolExecutor = new ToolExecutor(toolRegistry, toolCtx, pluginManager);
+    toolCtx.llmProvider = llmProvider;
+    toolCtx.toolExecutor = toolExecutor;
+    const hallucinationDetector = new HallucinationDetector(baseDir, llmProvider, {
+        judgeEnabled: config.hallucination?.judge?.enabled ?? false,
+    });
+    return {
+        sessionManager,
+        sessionStore,
+        contextLogger,
+        contextManager,
+        configRef,
+        activeToolTags,
+        toolCtx,
+        toolExecutor,
+        hallucinationDetector,
+    };
+}

package/dist/core/bootstrap/state.js

@@ -0,0 +1,94 @@
+/**
+ * Общее состояние и мелкие хелперы фаз bootstrap.
+ *
+ * Здесь живёт то, что нужно нескольким фазам сразу: флаг one-shot режима,
+ * регистрация встроенных плагинов, таймаут-обёртка, нормализация уровня
+ * лога и загрузка AGENTS.md-блоков. Своей логики фаза не несёт — только
+ * разделяемые примитивы, чтобы фазы не дублировали их друг у друга.
+ */
+import { estimateTokens } from "../../llm/token-counter";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { projectMmaDir } from "../../config/paths";
+/**
+ * One-shot CLI-подкоманды (`session show`, `usage`, `config` …) рисуют итог и
+ * выходят. Фоновый стартовый health-check спавнит дочерний процесс (LSP/tsc),
+ * который `process.exit` не пожинает — на Windows сирота держит stdout-пайп, и
+ * пайп команды (`mma session show <id> | cat`) виснет. Подкоманды агента не
+ * гоняют, поэтому чек там пропускается.
+ */
+let oneShotMode = false;
+/**
+ * Включает one-shot режим (пропуск фонового health-check для подкоманд).
+ * @param value true — подкоманда без агента.
+ */
+export function setOneShotMode(value) {
+    oneShotMode = value;
+}
+/**
+ * Проверяет one-shot режим (нужен фазе модулей для пропуска health-check).
+ * @returns true — фоновый стартовый чек пропускается.
+ */
+export function isOneShotMode() {
+    return oneShotMode;
+}
+/** Регистрация встроенного плагина модуля: пометка + регистрация. */
+export function registerBuiltinPlugin(pm, plugin) {
+    if (!plugin)
+        return;
+    plugin.isBuiltin = true;
+    pm.register(plugin);
+}
+/** Отклоняет `promise` через `ms`; таймер победителя снимается. */
+export function withTimeout(promise, ms) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`timeout after ${ms}ms`)), ms);
+        promise.then((v) => {
+            clearTimeout(timer);
+            resolve(v);
+        }, (e) => {
+            clearTimeout(timer);
+            reject(e);
+        });
+    });
+}
+const VALID_LOG_LEVELS = ["debug", "info", "warn", "error"];
+/** Нормализует строку из конфига в LogLevel (без `as any`); неизвестное → info. */
+export function normalizeLogLevel(value) {
+    return value && VALID_LOG_LEVELS.includes(value) ? value : "info";
+}
+/** Кандидаты AGENTS.md по приоритету: проект, проектный `.mma`, глобальный. */
+export function agentsMdPaths(baseDir, configDir) {
+    return [
+        join(baseDir, "AGENTS.md"),
+        join(projectMmaDir(baseDir), "AGENTS.md"),
+        join(configDir, "AGENTS.md"),
+    ];
+}
+/**
+ * Грузит AGENTS.md из каталога проекта и конфиг-каталога (по приоритету).
+ * Каждый найденный непустой файл — prompt-блок высокого приоритета.
+ * @param baseDir workspace; @param dir каталог конфига; @param skip пропустить загрузку.
+ * @returns блоки инструкций для системного промпта.
+ */
+export function loadAgentsMdBlocks(baseDir, dir, skip) {
+    if (skip)
+        return [];
+    const blocks = [];
+    const candidates = agentsMdPaths(baseDir, dir);
+    for (const p of candidates) {
+        if (existsSync(p)) {
+            const content = readFileSync(p, "utf-8").trim();
+            if (content) {
+                blocks.push({
+                    content,
+                    priority: "high",
+                    essential: false,
+                    estimatedTokens: estimateTokens(content),
+                    kind: "instructions",
+                });
+            }
+        }
+    }
+    return blocks;
+}

package/dist/core/bootstrap/workspace-phase.js

@@ -0,0 +1,115 @@
+/**
+ * Фаза 3 bootstrap: workspace, окружение, индекс проекта, скиллы и тулы.
+ *
+ * Порядок 1:1 с исходником: резолв baseDir (громкий фол на несуществующем
+ * `-d`) → отчёт окружения → построение индекса проекта → загрузка скиллов →
+ * реестр тулов → менеджер плагинов → системный systemInfo-блок.
+ */
+import { join, resolve } from "path";
+import { statSync } from "fs";
+import { buildSystemInfo } from "../system-prompt";
+import { collectEnvironment, logEnvironment } from "../environment";
+import { IndexerModule } from "../../modules/indexer/index";
+import { SkillsLoader, SkillsModule } from "../../modules/skills/index";
+import { ToolRegistry, registerAllTools } from "../../tools/index";
+import { PluginManager } from "../../modules/plugins/manager";
+import { estimateTokens } from "../../llm/token-counter";
+import { t } from "../../i18n/index";
+import { homedir } from "os";
+import { projectMmaDir } from "../../config/paths";
+/**
+ * Резолвит workspace агента. Несуществующий `-d` (классика: шелл режет по
+ * пробелам, висячий бэкслэш экранирует кавычку) должен упасть ГРОМКО здесь —
+ * иначе агент молча работает не в том каталоге и уверяет, что всё хорошо.
+ */
+export function resolveBaseDir(projectDir) {
+    if (!projectDir)
+        return process.cwd();
+    const abs = resolve(projectDir);
+    let isDir = false;
+    try {
+        isDir = statSync(abs).isDirectory();
+    }
+    catch {
+        isDir = false;
+    }
+    if (!isDir) {
+        throw new Error(`workspace directory does not exist: ${abs} (received ${JSON.stringify(projectDir)} — ` +
+            `if the path contains spaces, quote it without a trailing backslash)`);
+    }
+    return abs;
+}
+/**
+ * Готовит workspace, окружение, индекс, скиллы и реестр тулов.
+ * @param config живой конфиг; @param logger настроенный логгер;
+ * @param dir каталог конфига; @param projectDir запрошенный workspace (опционально);
+ * @param profile загруженный профиль пользователя (из фазы провайдера).
+ * @returns каталог, отчёт окружения, индекс, скиллы, реестр, system-блок.
+ */
+export async function setupWorkspacePhase(config, logger, dir, projectDir, profile) {
+    const baseDir = resolveBaseDir(projectDir);
+    // Кросс-девайс диагностика: полный отчёт окружения (ОС, рантайм, engines,
+    // PATH-тулы, провайдер/ретраи, playwright) на каждый старт.
+    const envReport = collectEnvironment({
+        configDir: dir,
+        baseDir,
+        config,
+        scanTools: process.env.NODE_ENV !== "test",
+    });
+    logEnvironment(envReport, logger);
+    for (const warning of envReport.warnings) {
+        logger.warn(warning);
+    }
+    const projectMapCacheDir = projectMmaDir(baseDir);
+    const indexerModule = new IndexerModule({
+        baseDir,
+        cacheDir: projectMapCacheDir,
+    });
+    try {
+        // Строим (или грузим из кэша) индекс проекта. На большом workspace первый
+        // обход подвисает старт без вывода — анонсируем оба конца, чтобы тишина
+        // была объяснена.
+        logger.info(t("env.indexing"));
+        const index = await indexerModule.buildIndex();
+        if (index) {
+            logger.info(t("env.indexed", { files: String(index.files.length) }));
+        }
+        else {
+            logger.warn(t("env.indexing_failed", { error: "no index produced" }));
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.warn(t("env.indexing_failed", { error: msg }));
+    }
+    const skillsLoader = new SkillsLoader();
+    const builtinDir = join(import.meta.dirname, "skills", "builtin");
+    const globalDir = join(homedir(), ".agents", "skills");
+    const projectSkillsDir = join(projectMmaDir(baseDir), "skills");
+    const availableSkills = skillsLoader.loadFromAllSources(builtinDir, globalDir, projectSkillsDir);
+    const skillsBudget = Math.floor(config.contextWindow * config.skills.budget);
+    const skillsModule = new SkillsModule(availableSkills, skillsBudget);
+    const toolRegistry = new ToolRegistry();
+    registerAllTools(toolRegistry, skillsModule, {
+        enableOnDemand: config.tools?.enableOnDemand,
+    });
+    const pluginManager = new PluginManager();
+    // SystemInfo собирается здесь из готового профиля (в исходнике — сразу
+    // после создания pluginManager; сайд-эффектов чтения профиля тут уже нет).
+    const systemInfoContent = buildSystemInfo(config, baseDir, profile.compress());
+    const systemInfoPrompt = {
+        content: systemInfoContent,
+        priority: "critical",
+        essential: true,
+        estimatedTokens: estimateTokens(systemInfoContent),
+    };
+    return {
+        baseDir,
+        envReport,
+        indexerModule,
+        skillsModule,
+        toolRegistry,
+        pluginManager,
+        systemInfoPrompt,
+    };
+}