micro-models-agent 2.10.0 → 2.12.0

package/dist/output/channel.js

@@ -1,5 +1,7 @@
+// Канал вывода: единственный владелец терминала (режимы idle/stream/modal/quiet).
 import { defaultOutputBus } from "./bus";
 import { formatEventLine } from "./format";
+/** Единственный писатель в терминал; подписывается на шину и рендерит события. */
 export class OutputChannel {
     bus;
     out;
@@ -14,14 +16,26 @@ export class OutputChannel {
     pending = null;
     partialOpen = false;
     /**
-     * Log/block stdout events captured while a prompt is active. They are
-     * flushed once per microtask so a synchronous burst (e.g. a 20-line command
-     * result) produces a single `printAbove` + one frame render instead of one
-     * per line (which erased/redrew the frame and fired a DSR query each time).
+     * Log/block-события stdout, пойманные при активном промпте. Сбрасываются раз
+     * в микротаску, чтобы синхронный всплеск (например, 20-строчный результат
+     * команды) дал один `printAbove` + один ререндер кадра, а не по одному на
+     * строку (каждый стирал/перерисовывал кадр и слал DSR-запрос).
      */
     blockLines = null;
     blockFlushScheduled = false;
     unsub;
+    /**
+     * Глушит `info`-логи на человеческом терминале. Структурные логи — это
+     * диагностика, а не чат: quiet оставляет только warn/error. `writeLine`-блоки
+     * (help, status, вывод команд) не затрагиваются.
+     */
+    suppressInfoLogs = false;
+    /**
+     * Показ `data.diagnostic`-событий (внутренняя диагностика петли) в терминале.
+     * По умолчанию выкл: диагностика живёт в `.log`/`app.jsonl` и выходит в чат
+     * только при `ui.verbosity === "verbose"`.
+     */
+    showDiagnostics = false;
     constructor(bus = defaultOutputBus, opts = {}) {
         this.bus = bus;
         this.out = opts.out ?? process.stdout;
@@ -30,6 +44,7 @@ export class OutputChannel {
         this.color = opts.color ?? (!process.env.NO_COLOR && !process.env.CI && outTTY);
         this.unsub = this.bus.subscribe((ev) => this.onEvent(ev));
     }
+    /** Отписка от шины и сброс состояния. */
     dispose() {
         this.flushBlocks();
         this.unsub();
@@ -39,40 +54,46 @@ export class OutputChannel {
         this.sink = null;
         this.mode = "idle";
     }
+    /** Привязка/отвязка промпта (null — терминал свободен). */
     attachPrompt(sink) {
         this.sink = sink;
     }
+    /** Текущий режим канала. */
     getMode() {
         return this.mode;
     }
+    /** Начало стрима ответа. Quiet не сбрасывается: `--json` молчит весь прогон. */
     beginStreaming() {
-        // A streaming transition must never discard the quiet state: `--json`
-        // sets quiet for the whole run and streamed runs must stay silent.
+        // Переход в стрим не должен сбрасывать quiet: `--json` ставит quiet на весь
+        // прогон, и стримящиеся прогоны обязаны молчать.
         if (this.mode === "quiet")
             return;
         this.flushBlocks();
         this.flushPendingAsBlock();
         this.mode = "streaming";
     }
+    /** Конец стрима. Симметрично beginStreaming: quiet владеет режимом до setQuiet(false). */
     endStreaming() {
-        // Symmetric with beginStreaming: quiet owns the mode until setQuiet(false).
+        // Симметрично beginStreaming: quiet владеет режимом до setQuiet(false).
         if (this.mode === "quiet")
             return;
         this.closePartial();
         this.mode = "idle";
     }
+    /** Вход в модалку: события копятся в очередь до endModal. */
     beginModal() {
         this.flushBlocks();
         this.flushPendingAsBlock();
         if (this.mode === "quiet")
-            return; // setQuiet owns quiet
-        // Nested modals (e.g. a wizard command inside another exclusive scope)
-        // must not overwrite the mode saved by the outermost beginModal.
+            return; // quiet владеет setQuiet
+        // Вложенные модалки (визард внутри другой эксклюзивной области) не должны
+        // затирать режим, сохранённый самой внешней beginModal.
         if (this.modalDepth === 0)
             this.modeBeforeModal = this.mode;
         this.modalDepth++;
         this.mode = "modal";
     }
+    /** Выход из модалки: сброс очереди накопленных событий в onEvent. */
     endModal() {
         if (this.modalDepth > 0)
             this.modalDepth--;
@@ -83,6 +104,7 @@ export class OutputChannel {
         for (const ev of q)
             this.onEvent(ev);
     }
+    /** Вкл/выкл quiet (`--json`): человеческий вывод дропается. */
     setQuiet(quiet) {
         this.flushBlocks();
         if (quiet) {
@@ -95,10 +117,19 @@ export class OutputChannel {
             this.mode = this.modeBeforeQuiet;
         }
     }
+    /** Скрыть `info`-логи терминала (warn/error остаются). */
+    setSuppressInfoLogs(suppress) {
+        this.suppressInfoLogs = suppress;
+    }
+    /** Показать внутреннюю диагностику (`Logger.diagnostic`) — только verbose. */
+    setShowDiagnostics(show) {
+        this.showDiagnostics = show;
+    }
+    /** Сырая запись в поток. В modal/quiet дропается, в idle идёт поверх промпта. */
     writeRaw(text, stream = "stdout") {
-        // Raw output must never jump ahead of queued block lines.
+        // Сырой вывод не должен обгонять очередь блочных строк.
         this.flushBlocks();
-        // modal intentionally drops direct writes: the Renderer never runs during a modal prompt.
+        // modal осознанно дропает прямые записи: рендерер в модальном промпте не работает.
         if (this.mode === "modal" || this.mode === "quiet")
             return;
         if (this.mode === "idle" && this.sink?.isActive() && stream === "stdout") {
@@ -111,12 +142,14 @@ export class OutputChannel {
             this.partialOpen = !text.endsWith("\n");
         (stream === "stderr" ? this.err : this.out).write(text);
     }
+    /** Блочная запись через шину (help, status, вывод команд). */
     writeLine(text, stream = "stdout") {
         this.bus.emit({ level: "info", source: "", kind: "block", text, stream });
     }
+    /** Очистка экрана через промпт или ANSI. Буферный raw-партиал сбрасывается первым. */
     clearScreen() {
         this.flushBlocks();
-        // A buffered raw partial line would otherwise re-appear after the clear.
+        // Иначе буферная raw-частичная строка всплывёт после очистки.
         this.flushPendingAsBlock();
         this.partialOpen = false;
         if (this.mode === "quiet")
@@ -127,17 +160,43 @@ export class OutputChannel {
         }
         this.out.write("\x1b[2J\x1b[H");
     }
+    /** Оверлей (спиннер) в stderr. В modal/quiet и при активном промпте дропается. */
     writeOverlay(text) {
-        // modal intentionally drops overlays: the Renderer never runs during a modal prompt.
-        // Task 6's Spinner must stop before any log so an overlay never shares a row with a log line.
+        // modal осознанно дропает оверлеи: рендерер в модальном промпте не работает.
+        // Спиннер обязан остановиться до любого лога, иначе оверлей делит строку с логом.
         if (this.mode === "modal" || this.mode === "quiet")
             return;
         if (this.mode === "idle" && this.sink?.isActive())
             return;
         this.err.write(text);
     }
-    onEvent(ev) {
+    /** Режимы и фильтры, держащие событие вне терминала. */
+    shouldDrop(ev) {
         if (this.mode === "quiet")
+            return true;
+        // Структурные info-логи — диагностика, а не чат: quiet их прячет.
+        if (this.suppressInfoLogs && ev.kind === "log" && ev.level === "info")
+            return true;
+        // Внутренняя диагностика петли — материал логов сессии, а не чата: в терминал
+        // только через verbose (setShowDiagnostics).
+        if (!this.showDiagnostics && ev.kind === "log" && ev.data?.diagnostic === true)
+            return true;
+        return false;
+    }
+    /** Пакует синхронный всплеск в один printAbove/рендер (см. blockLines). */
+    queueBlockLine(line) {
+        // Оба потока идут поверх промпта, иначе stderr-лог ляжет прямо на кадр
+        // ввода в обход порядка flushBlocks.
+        if (this.blockLines === null)
+            this.blockLines = [];
+        this.blockLines.push(line);
+        if (this.blockFlushScheduled)
+            return;
+        this.blockFlushScheduled = true;
+        queueMicrotask(() => this.flushBlocks());
+    }
+    onEvent(ev) {
+        if (this.shouldDrop(ev))
             return;
         if (this.mode === "modal") {
             this.queue.push(ev);
@@ -150,20 +209,11 @@ export class OutputChannel {
         const stream = ev.stream ?? "stdout";
         const line = ev.kind === "block" ? ev.text : formatEventLine(ev, this.color);
         if (this.mode === "idle" && this.sink?.isActive()) {
-            // Batch a synchronous burst into one printAbove/render (see blockLines).
-            // Both streams route above the prompt, otherwise a stderr log writes
-            // directly over the active input frame and skips flushBlocks ordering.
-            if (this.blockLines === null)
-                this.blockLines = [];
-            this.blockLines.push(line);
-            if (!this.blockFlushScheduled) {
-                this.blockFlushScheduled = true;
-                queueMicrotask(() => this.flushBlocks());
-            }
+            this.queueBlockLine(line);
             return;
         }
-        // Preserve FIFO ordering: buffered blocks must not be overtaken by an
-        // event written straight to a raw stream (e.g. a stderr log mid-stream).
+        // Сохраняем FIFO: буферные блоки не должен обгонять эвент, писанный
+        // напрямую в raw-поток (например, stderr-лог посреди стрима).
         this.flushBlocks();
         if (this.mode === "streaming")
             this.closePartial();
@@ -222,11 +272,13 @@ export class OutputChannel {
     }
 }
 let defaultChannel = null;
+/** Канал-синглтон текущего процесса. */
 export function getDefaultChannel() {
     if (!defaultChannel)
         defaultChannel = new OutputChannel(defaultOutputBus);
     return defaultChannel;
 }
+/** Сброс синглтона (изоляция тестов). */
 export function resetDefaultChannel() {
     defaultChannel?.dispose();
     defaultChannel = null;

package/dist/output/format.js

@@ -1,3 +1,4 @@
+// Форматирование событий в строки вида `[LEVEL] [source] ISO — text`.
 import { createColors } from "picocolors";
 const colored = createColors(true);
 const LEVEL_COLORS = {
@@ -6,7 +7,7 @@ const LEVEL_COLORS = {
     warn: (s) => colored.yellow(s),
     error: (s) => colored.red(s),
 };
-/** Reproduces the legacy Logger format: `[LEVEL] [source] ISO — text`. */
+/** Форматирует событие как в legacy-логере: `[LEVEL] [source] ISO — text`. */
 export function formatEventLine(ev, color) {
     const prefix = ev.source ? ` [${ev.source}]` : "";
     const line = `[${ev.level.toUpperCase()}]${prefix} ${new Date(ev.ts).toISOString()} — ${ev.text}`;

package/dist/output/index.js

@@ -1,3 +1,4 @@
+// Публичный фасад вывода: типы, шина, канал, стоки, машинный вывод.
 export * from "./types";
 export { OutputBus, defaultOutputBus } from "./bus";
 export { formatEventLine } from "./format";

package/dist/output/json-sink.js

@@ -1,8 +1,9 @@
 /**
- * Collects bus events so a machine-readable run (`--json`) can include the
- * warn/error diagnostics that the human channel suppresses via `setQuiet`.
- * Info/debug events are ignored: they are progress noise, not diagnostics.
+ * Копит события шины, чтобы машиночитаемый прогон (`--json`) включил
+ * warn/error-диагностику, которую человеческий канал гасит через `setQuiet`.
+ * Info/debug игнорируются: это шум прогресса, а не диагностика.
  */
+/** Сток warn/error-диагностики для `--json`. @param bus шина для подписки. */
 export class JsonOutputSink {
     events = [];
     unsub;
@@ -11,6 +12,7 @@ export class JsonOutputSink {
             this.events.push(ev);
         });
     }
+    /** Только warn/error события в виде плоских записей. */
     diagnostics() {
         return this.events
             .filter((e) => e.level === "warn" || e.level === "error")

package/dist/output/machine.js

@@ -1,8 +1,9 @@
-/** Machine-readable output (CLI JSON contracts). The only place with raw stdout. */
+// Машиночитаемый вывод (JSON-контракты CLI). Единственное место с raw stdout.
+/** Пишет JSON в stdout (контракт `--json`). @param value любой сериализуемый объект. */
 export function writeMachineJson(value) {
     process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
 }
-/** Raw stdout write for the non-TTY REPL fallback (documented single-writer exception). */
+/** Строка в stdout для non-TTY фолбэка REPL (оговорённое исключение single-writer). */
 export function writeNonTtyLine(text) {
-    process.stdout.write(text + "\n");
+    process.stdout.write(`${text}\n`);
 }

package/dist/output/session-sink.js

@@ -1,8 +1,8 @@
 /**
- * Persists explicitly marked output events (`data.persist === true`) into the
- * session log. Most output is transient terminal progress and is deliberately
- * NOT persisted; the primary file path for durable records stays
- * `SessionLogger.logSilent` / `logStructured`.
+ * Сохраняет в лог сессии только явно помеченные события (`data.persist === true`).
+ * Остальной вывод — транзиентный прогресс терминала и осознанно НЕ персистится;
+ * основной файловый путь долговечных записей — `SessionLogger.logSilent` /
+ * `logStructured`.
  */
 export class SessionOutputSink {
     session;

package/dist/tools/approve.js

@@ -1,10 +1,14 @@
+/** Тул явного Yes/No-подтверждения действия (интерактивный, alwaysOn). */
 import { t } from "../i18n/index";
 import { askChoice } from "./user-input";
+/** Просит подтверждение; reject — success:false (сигнал сбоя для цикла). */
 export const approveTool = {
     name: "approve",
     icon: "🙋",
     description: "Request user approval for an action. The user picks Yes or No from a menu.",
     tags: ["core"],
+    // Как в question.ts: интерактивные тулы переживают сужение (P5).
+    alwaysOn: true,
     interactive: true,
     parameters: {
         type: "object",

package/dist/tools/attach-image.js

@@ -1,8 +1,10 @@
+/** Тул аттача картинки в контекст (файл/URL/буфер обмена). */
 import { existsSync } from "fs";
 import { resolve } from "path";
 import { t } from "../i18n/index";
 import { loadFileAsDataUrl, loadUrlAsDataUrl, readClipboardImage, bufferToDataUrl, } from "../llm/image-utils";
 import { logSecurityBlock } from "../modules/security/audit-log";
+/** Кладёт картинку в pending-очередь контекста (PNG/JPEG/GIF/WebP). */
 export const attachImageTool = {
     name: "attach_image",
     icon: "🖼️",
@@ -37,7 +39,7 @@ export const attachImageTool = {
                 dataUrl = result.dataUrl;
             }
             else if (source.startsWith("http://") || source.startsWith("https://")) {
-                // Security: validate URL against the network policy (SSRF).
+                // URL — по сетевой политике (SSRF).
                 const { isUrlAllowed } = await import("../modules/security/network-validator");
                 const { getSessionSecurityConfig } = await import("../modules/security/session-isolation");
                 const networkConfig = ctx.sessionContext
@@ -59,8 +61,7 @@ export const attachImageTool = {
                         output: t("image.not_found", { path: source }),
                     };
                 }
-                // Security: check global path policy AND subagent scope (same
-                // combination as read_file).
+                // Пути: глобальная политика + скоуп субагента (та же связка, что у read_file).
                 const { isPathInScope } = await import("../modules/security/path-validator");
                 const { DEFAULT_SECURITY_CONFIG } = await import("../config/security");
                 const validation = isPathInScope(ctx.baseDir, absPath, ctx.scope, ctx.config?.security?.paths || DEFAULT_SECURITY_CONFIG.paths);
@@ -74,7 +75,7 @@ export const attachImageTool = {
                 const result = await loadFileAsDataUrl(absPath);
                 dataUrl = result.dataUrl;
             }
-            // Add the image as a pending content part on the context manager
+            // Картинка — pending content part на менеджере контекста.
             if (!ctx.contextManager) {
                 return {
                     success: false,

package/dist/tools/auto-fixer.js

@@ -1,7 +1,6 @@
+/** Автофиксы LSP-ошибок tsc (конфликты импортов, неиспользуемые). */
 import { extname } from "path";
-/**
- * LSP error codes that can be auto-fixed.
- */
+/** Коды LSP-ошибок, поддающиеся автофиксу. */
 const AUTO_FIXABLE_CODES = new Set([
     2307, // Cannot find module (import missing)
     2440, // Import declaration conflicts with local declaration
@@ -9,8 +8,8 @@ const AUTO_FIXABLE_CODES = new Set([
     2769, // No overload matches this call (simple type mismatches)
 ]);
 /**
- * Extract LSP errors from tsc output.
- * Format: file(line,col): error TSxxxx: message
+ * Извлекает LSP-ошибки из вывода tsc.
+ * Формат: file(line,col): error TSxxxx: message. Возврат: список ошибок.
  */
 export function parseTscOutput(output) {
     const errors = [];
@@ -30,10 +29,9 @@ export function parseTscOutput(output) {
     return errors;
 }
 /**
- * Try to auto-fix LSP errors in TypeScript/JavaScript code.
- * Only fixes common, safe patterns:
- * - TS2440: Import conflict → rename import with `as`
- * - TS6133: Unused import → remove from import list
+ * Пробует автофиксить LSP-ошибки в TS/JS. Только частые безопасные паттерны:
+ * - TS2440: конфликт импорта → переименование через `as`;
+ * - TS6133: неиспользуемый импорт → удаление из списка.
  */
 export function autoFixErrors(filePath, content, errors) {
     const ext = extname(filePath).toLowerCase();
@@ -71,16 +69,14 @@ export function autoFixErrors(filePath, content, errors) {
         remaining,
     };
 }
-/**
- * Try to fix a single LSP error.
- */
+/** Пробует починить одну LSP-ошибку. */
 function fixError(content, error) {
     const lines = content.split("\n");
     const lineIndex = error.line - 1;
     if (lineIndex < 0 || lineIndex >= lines.length) {
         return { fixed: false, newContent: content };
     }
-    const line = lines[lineIndex];
+    const _line = lines[lineIndex];
     switch (error.code) {
         case 2440: // Import declaration conflicts with local declaration
             return fixImportConflict(lines, lineIndex, error);
@@ -91,25 +87,18 @@ function fixError(content, error) {
     }
 }
 /**
- * Fix TS2440: Import declaration conflicts with local declaration.
- * Strategy: Add `as LocalName` to the import.
- *
- * Example:
- *   import { foo } from './module';
- *   export function foo() { ... }
- * Becomes:
- *   import { foo as fooImport } from './module';
- *   export function foo() { ... }
+ * Фикс TS2440: конфликт импорта с локальной декларацией.
+ * Стратегия: добавить `as LocalName` к импорту (`foo` → `foo as fooImport`).
  */
 function fixImportConflict(lines, lineIndex, error) {
-    const line = lines[lineIndex];
-    // Find the conflicting name in the error message
+    const _line = lines[lineIndex];
+    // Конфликтное имя — из текста ошибки.
     const nameMatch = error.message.match(/Import declaration conflicts with local declaration of '(\w+)'/);
     if (!nameMatch) {
         return { fixed: false, newContent: lines.join("\n") };
     }
     const conflictingName = nameMatch[1];
-    // Find the import line (might be above the current line)
+    // Строка импорта (может быть выше текущей) — для TS2440-фикса.
     let importLineIndex = lineIndex;
     while (importLineIndex >= 0 && !lines[importLineIndex].includes("import")) {
         importLineIndex--;
@@ -118,14 +107,14 @@ function fixImportConflict(lines, lineIndex, error) {
         return { fixed: false, newContent: lines.join("\n") };
     }
     const importLine = lines[importLineIndex];
-    // Check if this is a named import: import { ... } from '...'
+    // Только именованный импорт вида import { ... } from '...'.
     const namedImportMatch = importLine.match(/import\s+(?:type\s+)?\{([^}]+)\}\s+from/);
     if (!namedImportMatch) {
         return { fixed: false, newContent: lines.join("\n") };
     }
     const imports = namedImportMatch[1];
     const importParts = imports.split(",").map((s) => s.trim());
-    // Check if the conflicting name is in the imports
+    // Конфликтное имя — в списке импортов?
     const nameIndex = importParts.findIndex((part) => {
         const baseName = part.split(/\s+as\s+/)[0].trim();
         return baseName === conflictingName;
@@ -133,36 +122,29 @@ function fixImportConflict(lines, lineIndex, error) {
     if (nameIndex === -1) {
         return { fixed: false, newContent: lines.join("\n") };
     }
-    // Check if already has an alias
+    // Алиас уже есть — не трогаем.
     const currentImport = importParts[nameIndex];
     if (currentImport.includes(" as ")) {
         return { fixed: false, newContent: lines.join("\n") };
     }
-    // Add alias
+    // Добавить алиас.
     importParts[nameIndex] = `${conflictingName} as ${conflictingName}Import`;
     lines[importLineIndex] = importLine.replace(namedImportMatch[1], importParts.join(", "));
     return { fixed: true, newContent: lines.join("\n") };
 }
 /**
- * Fix TS6133: Variable is declared but its value is never read.
- * Strategy: Remove the unused import from the import list.
- *
- * Example:
- *   import { foo, bar } from './module';
- *   console.log(bar);
- * Becomes:
- *   import { bar } from './module';
- *   console.log(bar);
+ * Фикс TS6133: объявлена, но не читается. Стратегия: выкинуть неиспользуемый
+ * импорт из списка (`{ foo, bar }` → `{ bar }`); пустой импорт — строкой целиком.
  */
 function fixUnusedImport(lines, lineIndex, error) {
-    const line = lines[lineIndex];
-    // Find the unused name in the error message
+    const _line = lines[lineIndex];
+    // Неиспользуемое имя — из текста ошибки.
     const nameMatch = error.message.match(/'(\w+)' is declared but its value is never read/);
     if (!nameMatch) {
         return { fixed: false, newContent: lines.join("\n") };
     }
     const unusedName = nameMatch[1];
-    // Find the import line (might be above the current line)
+    // Строка импорта (может быть выше текущей) — для TS6133-фикса.
     let importLineIndex = lineIndex;
     while (importLineIndex >= 0 && !lines[importLineIndex].includes("import")) {
         importLineIndex--;
@@ -171,14 +153,14 @@ function fixUnusedImport(lines, lineIndex, error) {
         return { fixed: false, newContent: lines.join("\n") };
     }
     const importLine = lines[importLineIndex];
-    // Check if this is a named import: import { ... } from '...'
+    // Только именованный импорт вида import { ... } from '...' (TS6133).
     const namedImportMatch = importLine.match(/import\s+(?:type\s+)?\{([^}]+)\}\s+from/);
     if (!namedImportMatch) {
         return { fixed: false, newContent: lines.join("\n") };
     }
     const imports = namedImportMatch[1];
     const importParts = imports.split(",").map((s) => s.trim());
-    // Find and remove the unused import
+    // Найти и выкинуть неиспользуемый импорт.
     const nameIndex = importParts.findIndex((part) => {
         const baseName = part.split(/\s+as\s+/)[0].trim();
         return baseName === unusedName;
@@ -187,7 +169,7 @@ function fixUnusedImport(lines, lineIndex, error) {
         return { fixed: false, newContent: lines.join("\n") };
     }
     importParts.splice(nameIndex, 1);
-    // If no imports left, remove the entire import line
+    // Импортов не осталось — снести строку целиком.
     if (importParts.length === 0) {
         lines.splice(importLineIndex, 1);
     }

package/dist/tools/auto-tags.js

@@ -0,0 +1,83 @@
+/**
+ * Детерминированный вывод tool-тегов по типу задачи (P5 auto-narrowing).
+ *
+ * Главный цикл показывает LLM только `defaultTags` (+ структурные `alwaysOn`);
+ * остальное скрыто за `enable_tools`. Без preseed веб-задача тратит первый ход
+ * на поиск `enable_tools`, а 9B-модель иногда уходит в shell/MCP (из-за этого
+ * сужение и откатывали к `enableOnDemand: false`).
+ *
+ * Классификатор работает ДО первого LLM-вызова на сыром сообщении и только
+ * ДОБАВЛЯЕТ теги (дефолты не снимает): простой чат остаётся узким (file/code +
+ * alwaysOn), а research/browser/memory-задача сразу видит нужные тулы.
+ * Без LLM-вызова и затрат контекста.
+ *
+ * Правила — keyword-эвристики (en+ru): `research` со сдвигом в recall
+ * (пропуск веб-намерения стоит лишний enable_tools round-trip), `browser`/
+ * `shell`/`memory`/`vision` — в precision (простые ходы остаются узкими).
+ * Неизвестный текст — дефолты без изменений.
+ */
+/** Известные теги тулов. */
+export const KNOWN_TOOL_TAGS = [
+    "file",
+    "code",
+    "shell",
+    "research",
+    "browser",
+    "vision",
+    "image",
+    "memory",
+    "core",
+];
+const RESEARCH_RE = /search|google|найди|найти|поиск|погод|новост|интернет|сайт|документ|стать|цен|стоим|курс|билет|рейтинг|обзор|рецепт|http|www\.|url|\bsite\b|\bweb\b|fetch|download|скача|загруз|stackoverflow|github\.com|wikipedia|википеди/i;
+const BROWSER_RE = /screenshot|скриншот|playwright|browser|браузер|кликни|click\b|открой.*стран|automation|автоматизац.*браузер|селектор|selector/i;
+const SHELL_RE = /process_|фонов|background|dev.?server|docker|deploy|депло|pipeline|пайплайн|контейнер|процесс/i;
+const MEMORY_RE = /запомни|remember|recall|вспомни|память|\bmemory\b|мой день рождения|my birthday|мой рост|обо мне|preferences|предпочтени/i;
+const VISION_RE = /image|картинк|фото|изображен|скрин|attach|vision|png|\bjpg\b|jpeg|сфотографируй|разбери.*фото/i;
+const CODE_RE = /код|code|typescript|python|javascript|bun|npm|git|коммит|тест|lint|build|сборк|баг|ошибк.*код|файл|file|папк|директори|рефактор|refactor/i;
+/**
+ * Дополнительные теги из сообщения пользователя. Всегда подмножество
+ * KNOWN_TOOL_TAGS, без `file`/`code` (это дефолты). Чистая функция —
+ * безопасно вызывать на каждом ходе.
+ */
+export function inferExtraToolTags(input) {
+    if (!input || !input.trim())
+        return [];
+    const extra = new Set();
+    if (RESEARCH_RE.test(input))
+        extra.add("research");
+    if (BROWSER_RE.test(input)) {
+        extra.add("browser");
+        extra.add("vision");
+    }
+    if (SHELL_RE.test(input))
+        extra.add("shell");
+    if (MEMORY_RE.test(input))
+        extra.add("memory");
+    if (VISION_RE.test(input)) {
+        extra.add("vision");
+        extra.add("image");
+    }
+    // Явное code/shell-намерение возвращает `shell` (bash виден и через `code`,
+    // но process_*/pipeline нужен именно shell-тег).
+    if (CODE_RE.test(input) && /process|фонов|background|pipeline|docker/i.test(input)) {
+        extra.add("shell");
+    }
+    return [...extra];
+}
+/**
+ * Аддитивный preseed: дописывает выведенные теги в `activeTags`, возвращает
+ * добавленные. Ничего не удаляет (гранты `enable_tools` сохраняются).
+ * No-op при выключенном сужении (`activeTags` undefined = legacy-режим).
+ */
+export function seedToolTags(activeTags, input) {
+    if (!activeTags)
+        return [];
+    const added = [];
+    for (const tag of inferExtraToolTags(input)) {
+        if (!activeTags.includes(tag)) {
+            activeTags.push(tag);
+            added.push(tag);
+        }
+    }
+    return added;
+}