micro-models-agent 2.11.0 → 2.13.1

package/dist/tools/search-history.js

@@ -1,7 +1,9 @@
+/** Тул поиска по истории сессий (JSONL всех сессий, cap результатов). */
 import * as fs from "fs";
 import { join } from "path";
-import { homedir } from "os";
 import { t } from "../i18n/index";
+import { globalSessionsDir } from "../config/paths";
+/** Ищет запрос в одном history.jsonl, складывает ужатые JSON-записи. */
 function searchFile(filePath, query, maxResults, results) {
     if (!fs.existsSync(filePath))
         return;
@@ -20,6 +22,7 @@ function searchFile(filePath, query, maxResults, results) {
             break;
     }
 }
+/** Ищет по прошлым взаимодействиям всех сессий. Параметры: query, maxResults, sessionId. */
 export const searchHistoryTool = {
     name: "search_history",
     icon: "🕵️",
@@ -44,7 +47,7 @@ export const searchHistoryTool = {
         const query = String(args.query || "").toLowerCase();
         const maxResults = Number(args.maxResults) || 5;
         const sessionId = args.sessionId ? String(args.sessionId) : null;
-        const sessionDir = join(homedir(), ".mma", "sessions");
+        const sessionDir = globalSessionsDir();
         const results = [];
         try {
             if (!fs.existsSync(sessionDir)) {

package/dist/tools/session-info.js

@@ -1,4 +1,6 @@
+/** Тул метаданных текущей сессии (id, модель, бюджет контекста; alwaysOn). */
 import { t } from "../i18n/index";
+/** Показывает сессию и загрузку контекстного бюджета. Без активной — пометка. */
 export const sessionInfoTool = {
     name: "session_info",
     icon: "ℹ️",

package/dist/tools/set-thinking.js

@@ -1,6 +1,11 @@
-// src/tools/set-thinking.ts
+/** Тул ручной установки reasoning-уровня (транзиентный, с кулдауном). */
 import { t } from "../i18n/index";
+/** Допустимые уровни reasoning. */
 const VALID_LEVELS = ["default", "none", "low", "medium", "high", "max"];
+/**
+ * Фабрика тула set_thinking (уровень на следующий LLM-вызов; штатно рулит
+ * харнесс). Возврат: определение тула.
+ */
 export function createSetThinkingTool(state, config, getCurrentIteration) {
     return {
         name: "set_thinking",
@@ -32,7 +37,7 @@ export function createSetThinkingTool(state, config, getCurrentIteration) {
                     output: t("tool.thinking_invalid_level", { level: requested }),
                 };
             }
-            // Cooldown check
+            // Проверка кулдауна.
             const currentIter = getCurrentIteration();
             const elapsed = currentIter - state.overrideIteration;
             if (elapsed > 0 && elapsed < config.overrideCooldown) {
@@ -44,7 +49,7 @@ export function createSetThinkingTool(state, config, getCurrentIteration) {
                     }),
                 };
             }
-            // Clamp to configured bounds
+            // Кламп в настроенные границы.
             let level = requested;
             const levelOrder = ["none", "low", "medium", "high", "max"];
             const minIdx = levelOrder.indexOf(config.min);
@@ -59,7 +64,6 @@ export function createSetThinkingTool(state, config, getCurrentIteration) {
                 level = config.max;
                 clamped = true;
             }
-            // Apply
             state.level = level;
             state.overrideIteration = currentIter;
             const msg = clamped

package/dist/tools/subagent.js

@@ -1,3 +1,4 @@
+/** Тул изолированного субагента (свой контекст, скоуп, теги тулов, MoE-off). */
 import { t } from "../i18n/index";
 import { Agent } from "../core/agent";
 import { ContextManager } from "../modules/context/manager";
@@ -7,7 +8,7 @@ import { logSecurityBlock } from "../modules/security/audit-log";
 import { getSessionSecurityConfig } from "../modules/security/session-isolation";
 import { ArtifactStore } from "../modules/artifacts/store";
 import { ScopeDenialCollector, formatScopeRequest } from "./scope-request";
-/** Fixed system prompt (KV-cache friendly when stableSystemPrompt is on). */
+/** Фиксированный системный промпт (KV-cache дружит при stableSystemPrompt). */
 export const SUBAGENT_SYSTEM_PROMPT_TEMPLATE = `You are a sub-agent working on a specific task. You have your own context window and tool set.
 
 Workflow rules:
@@ -15,11 +16,13 @@ Workflow rules:
 - For large outputs, write the result to a file with write_file instead of reproducing it in your answer.
 - If the task is big and decomposable, delegate parts to the subagent tool instead of doing everything in one context.
 - When you finish, return a concise final answer; do not repeat file contents verbatim if you already wrote them to disk.`;
+/** Собирает системный промпт субагента (стабильный или с контекстом). */
 function buildSubagentSystemPrompt(context, stable) {
     if (stable)
         return SUBAGENT_SYSTEM_PROMPT_TEMPLATE;
     return `You are a sub-agent working on a specific task. ${context ? `Context: ${context}` : ""}`;
 }
+/** Спавнит изолированного субагента. Параметры: task, scope-файлы, tool_tags, result_mode. */
 export const subagentTool = {
     name: "subagent",
     icon: "🤖",
@@ -82,14 +85,14 @@ export const subagentTool = {
         if (!task) {
             return { success: false, output: t("tool.name_or_task") };
         }
-        // Get session-specific security config
+        // Сессионный security-конфиг.
         const securityConfig = ctx.sessionContext
             ? getSessionSecurityConfig(ctx.config, ctx.sessionContext)
             : ctx.config.security;
-        // Security check: limit recursion depth. Read the depth from the SHARED
-        // executor ctx (which nested sub-agents actually see) — `ctx.recursionDepth`
-        // was captured once at bootstrap and never incremented, so the guard never
-        // fired and a sub-agent could spawn sub-agents unbounded.
+        // Лимит глубины рекурсии. Глубину читаем из SHARED-контекста исполнителя
+        // (его видят вложенные субагенты) — `ctx.recursionDepth` снапшотился раз при
+        // bootstrap и не инкрементился, поэтому гард не срабатывал и субагент мог
+        // спавнить субагентов безгранично.
         const executor = ctx.toolExecutor;
         const parentDepth = executor?.getRecursionDepth?.() ?? (ctx.recursionDepth ?? 0);
         const maxDepth = securityConfig?.maxRecursionDepth ?? 3;
@@ -111,14 +114,14 @@ export const subagentTool = {
         if (!ctx.llmProvider || !ctx.toolExecutor) {
             return {
                 success: false,
-                output: "Sub-agent cannot run: missing llmProvider or toolExecutor in context",
+                output: t("tool.subagent_cannot_run"),
             };
         }
-        // Defensive guard: if the caller requested specific tool tags but none of the
-        // registered tools match, the sub-agent would have zero tools and would
-        // hallucinate instead of acting. Warn the caller so it can correct the tags.
-        // Uses getByTags (not getAllForLLM) because alwaysOn tools always match the
-        // latter — the guard must test real tag coverage, not schema presence.
+        // Оборонительный гард: запрошенные tool_tags ни с чем не мэтчатся — у
+        // субагента ноль тулов, и он галлюцинирует вместо действий. Предупредить
+        // вызывающего для коррекции тегов. Проверка через getByTags (не
+        // getAllForLLM): alwaysOn мэтчатся всегда — гард меряет реальное покрытие,
+        // а не присутствие в схеме.
         if (toolTags && toolTags.length > 0) {
             const matched = ctx.toolExecutor.getRegistry().getByTags(toolTags);
             if (matched.length === 0) {
@@ -128,24 +131,34 @@ export const subagentTool = {
                 };
             }
         }
+        // Сейв/рестор shared-скоупа исполнителя, чтобы субагент не мутировал скоуп
+        // родителя навсегда. Текущий скоуп — из shared-исполнителя, не `ctx.scope`:
+        // MoE зовёт тул с ad-hoc контекстом без scope — снапшот `ctx.scope` ресторил
+        // бы "unrestricted" и сносил изоляцию всей волне.
+        const parentScope = executor?.getScope?.() ?? ctx.scope;
+        const appliedScope = scope || { allowed_files: [], read_only_files: [] };
+        // Compare-and-restore: параллельная MoE-волна могла тем временем поставить
+        // свой скоуп — чужого свежего владельца не затирать.
+        const restoreScope = () => {
+            if (ctx.toolExecutor?.getScope?.() === appliedScope) {
+                ctx.toolExecutor.setScope(parentScope);
+            }
+        };
         try {
             const subContextManager = new ContextManager(ctx.config.contextWindow, ctx.config.contextBudget);
             const subPluginManager = new PluginManager();
-            // Deterministic scope-denial tracking: when the child's file tools are
-            // blocked by the scope guard, the denial is surfaced as a machine-readable
-            // <scope-request> block in the result (see MoE executor / Router).
+            // Детерминированный трекинг scope-отказов: блокировки файловых тулов
+            // ребёнка скоуп-гардом всплывают машиночитаемым блоком <scope-request>
+            // в результате (см. MoE executor / Router).
             const scopeCollector = new ScopeDenialCollector();
             subPluginManager.register(scopeCollector.plugin, "builtin");
             const hallucinationDetector = new HallucinationDetector(ctx.baseDir, ctx.llmProvider);
-            // Save/restore the shared executor scope so the sub-agent doesn't
-            // permanently mutate the parent's scope.
-            const parentScope = ctx.scope;
-            ctx.toolExecutor.setScope(scope || { allowed_files: [], read_only_files: [] });
-            // Register cleanup so the executor restores scope on timeout/abort
-            // even when the agent's `finally` block never runs (abandoned promise).
-            ctx.cleanup = () => ctx.toolExecutor?.setScope(parentScope);
-            // Increment recursion depth on the shared executor ctx so NESTED
-            // sub-agents see the deeper level (and the guard above can fire).
+            ctx.toolExecutor.setScope(appliedScope);
+            // Cleanup на исполнителе — рестор скоупа при таймауте/аборте, даже если
+            // `finally` агента не отработал (брошенный промис).
+            ctx.cleanup = restoreScope;
+            // Глубину — на shared-контекст исполнителя, чтобы ВЛОЖЕННЫЕ субагенты
+            // видели уровень глубже (и гард выше мог сработать).
             ctx.recursionDepth = currentDepth + 1;
             executor?.setRecursionDepth?.(currentDepth + 1);
             const systemPrompt = {
@@ -154,12 +167,11 @@ export const subagentTool = {
                 essential: true,
                 estimatedTokens: 150,
             };
-            // MoE is a TOP-LEVEL orchestration mode: a sub-agent spawned by the
-            // subagent tool must always run the plain single-agent loop. Sharing the
-            // parent's config here made every MoE sub-agent re-enter runWithMoE —
-            // planning its own subtasks and spawning nested sub-agents recursively
-            // (bounded only by maxRecursionDepth), which hung execution for many
-            // minutes with zero progress events.
+            // MoE — TOP-LEVEL режим оркестрации: субагент от тула subagent всегда идёт
+            // plain single-agent циклом. Шаринг родительского конфига заставлял каждого
+            // MoE-субагента реентерить runWithMoE — планировать свои сабтаски и рекурсивно
+            // спавнить вложенных субагентов (лимит — лишь maxRecursionDepth), что вешало
+            // исполнение на минуты без прогресс-событий.
             const subConfig = { ...ctx.config, moe: { ...ctx.config.moe, enabled: false } };
             const subDeps = {
                 config: subConfig,
@@ -186,7 +198,10 @@ export const subagentTool = {
                     }
                     : undefined;
                 if (!result.success) {
-                    let output = `Sub-agent failed: ${result.error}\nPartial output: ${result.text}`;
+                    let output = t("tool.subagent_failed", {
+                        error: String(result.error),
+                        text: result.text,
+                    });
                     const scopeReq = scopeCollector.toScopeRequest();
                     if (scopeReq)
                         output += `\n${formatScopeRequest(scopeReq)}`;
@@ -209,29 +224,34 @@ export const subagentTool = {
                             iterations: String(result.iterationCount),
                             summary,
                         }),
-                        // Structured path so callers (MoE executor) don't parse the
-                        // localized `output` string.
+                        // Структурированный путь, чтобы вызывающие (MoE executor) не парсили
+                        // локализованную строку `output`.
                         artifactPath: abs,
                         usage: pickUsage(),
                     };
                 }
                 return {
                     success: true,
-                    output: `Sub-agent completed:\n${result.text}\n\nIterations: ${result.iterationCount}`,
+                    output: t("tool.subagent_completed", {
+                        text: result.text,
+                        iterations: String(result.iterationCount),
+                    }),
                     usage: pickUsage(),
                 };
             }
             finally {
-                // Restore the parent's exact scope: undefined means "no restrictions"
-                // and must not become an empty scope (which denies everything).
-                ctx.toolExecutor.setScope(parentScope);
-                ctx.cleanup = undefined;
+                // Рестор точного скоупа родителя (compare-and-restore — свежий скоуп
+                // параллельного сиблинга не затирать). undefined — "без ограничений",
+                // пустым скоупом (запрет всего) становиться не должен.
+                restoreScope();
+                if (ctx.cleanup === restoreScope)
+                    ctx.cleanup = undefined;
                 ctx.recursionDepth = currentDepth;
                 executor?.setRecursionDepth?.(currentDepth);
             }
         }
         catch (e) {
-            return { success: false, output: `Sub-agent error: ${e.message}` };
+            return { success: false, output: t("tool.subagent_error", { error: e.message }) };
         }
     },
 };