micro-models-agent 2.10.0 → 2.12.0

package/dist/modules/plugins/builtin/lint-on-write.js

@@ -4,30 +4,31 @@ import { resolve, extname, join } from "path";
 import { platform } from "os";
 import { findProjectRoot, resolveTscCommand } from "../../lsp/project-root";
 import { autoFixErrors, parseTscOutput } from "../../../tools/auto-fixer";
-const TYPE_CHECK_DEBOUNCE_MS = 2000;
-// Projects whose lint script points at a binary that is not installed
-// (keyed by baseDir::script). The run itself is expensive and the failure
-// marker is pure noise — skip for the rest of the process.
+import { LINT_TYPE_CHECK_DEBOUNCE_MS as TYPE_CHECK_DEBOUNCE_MS } from "../../../config/timeouts";
+import { settleChildClose } from "../../../utils/child-run";
+// Проекты, чей lint-скрипт ссылается на неустановленный бинарник
+// (ключ baseDir::script). Сам прогон дорог, а маркер провала — чистый шум,
+// поэтому пропускаем до конца процесса.
 const missingLintBinaries = new Set();
 function lintCacheKey(baseDir, lintScript) {
     return `${baseDir}::${lintScript}`;
 }
-// Shell-level "command not found" across locales/runtimes: POSIX `sh` prints
-// "command not found" (exit 127); Windows cmd.exe prints "is not recognized"
-// (en) / "не является внутренней или внешней командой" (ru) with exit 1/9009.
+// Шелл-уровень "command not found" по локалям/рантаймам: POSIX `sh` пишет
+// "command not found" (exit 127); Windows cmd.exe — "is not recognized"
+// (en) / "не является внутренней или внешней командой" (ru), exit 1/9009.
 const MISSING_BINARY_RE = /command not found|not recognized|не является внутренней|не распознан|не є внутрішньою|".+?" не является/i;
 function isMissingBinaryError(err, combinedOutput) {
     // 127 = POSIX sh "command not found"; 9009 = Windows cmd.exe "is not
-    // recognized" — both are authoritative regardless of output encoding.
+    // recognized" — оба авторитетны независимо от кодировки вывода.
     if (err.status === 127 || err.status === 9009)
         return true;
     if (err.code === "ENOENT")
         return true;
     return MISSING_BINARY_RE.test(combinedOutput);
 }
-// Per-file syntax checks are cached by (path, content hash): re-writing a file
-// with identical content skips the (expensive) check. Content changes → cache
-// miss → fresh check.
+// Пофайловые синтаксис-проверки кешируются по (путь, хеш содержимого): перезапись
+// файла с тем же содержимым скипает (дорогую) проверку. Смена контента →
+// промах кеша → свежая проверка.
 const syntaxCache = new Map();
 function contentHash(content) {
     let h = 5381;
@@ -38,10 +39,10 @@ function contentHash(content) {
 }
 let _winDecoder;
 /**
- * OEM decoder for the active console code page (CP866 on Russian Windows).
- * Mirrors `getOemDecoder()` in modules/processes/registry.ts: a transient
- * chcp.com failure under load must NOT be cached — only a successful probe
- * (or the hard ibm866 fallback) is memoized.
+ * OEM-декодер активной консольной кодовой страницы (CP866 на русской Windows).
+ * Зеркалит `getOemDecoder()` из modules/processes/registry.ts: транзиентный
+ * провал chcp.com под нагрузкой НЕ кешируется — мемоизируется только успешный
+ * проб (или жёсткий фолбэк ibm866).
  */
 function getWinDecoder() {
     if (_winDecoder !== undefined)
@@ -59,26 +60,26 @@ function getWinDecoder() {
         }).toString("latin1");
         const m = cpOut.match(/(\d+)/);
         if (m)
-            decoder = new TextDecoder("ibm" + m[1]);
+            decoder = new TextDecoder(`ibm${m[1]}`);
     }
     catch {
-        /* chcp failed (load/ENOENT) — retry on the next call */
+        /* chcp упал (нагрузка/ENOENT) — повторим при следующем вызове */
     }
     if (!decoder) {
         try {
             decoder = new TextDecoder("ibm866");
         }
         catch {
-            return new TextDecoder("utf-8"); // unknown encoding — do not cache
+            return new TextDecoder("utf-8"); // неизвестная кодировка — не кешируем
         }
     }
     _winDecoder = decoder;
     return _winDecoder;
 }
 /**
- * Decode child-process output to UTF-8. Modern tools (bun, node, npm, tsc)
- * write UTF-8 into the pipe; cmd.exe builtins/errors use the OEM code page.
- * Strict UTF-8 first; on invalid byte sequences fall back to OEM.
+ * Декодирует вывод дочернего процесса в UTF-8. Современные тулы (bun, node,
+ * npm, tsc) пишут UTF-8 в пайп; встроенные команды/ошибки cmd.exe — OEM-страницу.
+ * Сначала строгий UTF-8; на невалидных байтах — откат на OEM.
  */
 function decodeOutput(chunks) {
     const raw = Buffer.concat(chunks);
@@ -86,7 +87,7 @@ function decodeOutput(chunks) {
         return new TextDecoder("utf-8", { fatal: true }).decode(raw);
     }
     catch {
-        /* not valid UTF-8 → OEM code page output */
+        /* невалидный UTF-8 → вывод в OEM-кодировке */
     }
     try {
         return getWinDecoder().decode(raw);
@@ -95,12 +96,15 @@ function decodeOutput(chunks) {
         return raw.toString("latin1");
     }
 }
+/** Встроенный плагин: проверяет каждую запись/правку файла (синтаксис, lint, типы). */
 export class LintOnWritePlugin {
     name = "lint-on-write";
     priority = 10;
     isBuiltin = true;
-    _checkPromise = null;
-    _checkTimestamp = 0;
+    // Дебаунснутый проектный typecheck по корню проекта. Один общий слот
+    // протекал tsc-ошибками одного проекта в записи другого (монорепо).
+    _checks = new Map();
+    /** После записи/правки: синтаксис файла, затем проектные lint и typecheck. */
     async onAfterTool(ctx, call, result) {
         if (call.name !== "write_file" && call.name !== "edit_file") {
             return;
@@ -132,9 +136,9 @@ export class LintOnWritePlugin {
     }
     async checkSyntax(filePath, ext, baseDir, signal) {
         if (ext === ".ts" || ext === ".tsx" || ext === ".cts" || ext === ".mts") {
-            // Syntax-only check via bun's parser (~200ms) instead of `npx tsc`
-            // (~3-5s per write). Full type errors are still surfaced by the
-            // debounced project typecheck below when a tsconfig exists.
+            // Проверка только синтаксиса парсером bun (~200мс) вместо `npx tsc`
+            // (~3-5с на запись). Полные ошибки типов всё равно отдаёт дебаунснутый
+            // проектный typecheck ниже, когда есть tsconfig.
             let content = "";
             try {
                 content = readFileSync(filePath, "utf-8");
@@ -148,8 +152,8 @@ export class LintOnWritePlugin {
                 return cached.error;
             }
             try {
-                await runAsync(`bun build --no-bundle --target=bun "${filePath}"`, baseDir, 10000, signal);
-                // Aborted check (interrupt) never validated the file — don't cache it.
+                await runAsync({ file: "bun", args: ["build", "--no-bundle", "--target=bun", filePath] }, baseDir, 10000, signal);
+                // Прерванная проверка (interrupt) файл не валидировала — не кешируем.
                 if (signal?.aborted)
                     return null;
                 syntaxCache.set(filePath, { hash, error: null });
@@ -169,7 +173,7 @@ export class LintOnWritePlugin {
         }
         if (ext === ".js" || ext === ".jsx" || ext === ".cjs" || ext === ".mjs") {
             try {
-                await runAsync(`node --check "${filePath}"`, baseDir, 5000, signal);
+                await runAsync({ file: "node", args: ["--check", filePath] }, baseDir, 5000, signal);
                 return null;
             }
             catch (err) {
@@ -192,10 +196,10 @@ export class LintOnWritePlugin {
             if (!lintScript) {
                 return;
             }
-            // A declared-but-missing linter binary ("eslint" not installed) is a
-            // project-setup gap, not a code problem — appending it to every write
-            // result polluted the context ~25×/session (ses_mt4fn58c). Detect it
-            // once and skip silently for the rest of the process.
+            // Объявленный, но неустановленный бинарник линтера ("eslint" не стоит) —
+            // пробел проектного сетапа, а не проблема кода: дописывание его к каждой
+            // записи засоряло контекст ~25×/сессию (ses_mt4fn58c). Детектим раз
+            // и дальше скипаем молча до конца процесса.
             if (missingLintBinaries.has(lintCacheKey(ctx.baseDir, lintScript))) {
                 ctx.logger.debug(`Lint skipped (linter for "${lintScript}" not installed)`);
                 return;
@@ -224,10 +228,10 @@ export class LintOnWritePlugin {
         }
     }
     async runProjectTypeCheck(filePath, baseDir, result, signal) {
-        // Resolve the project root from the EDITED FILE, not the agent baseDir.
-        // In a nested layout (`baseDir/proj/tsconfig.json`) the old baseDir-based
-        // lookup silently skipped the typecheck on every write — the whole
-        // session then ran with zero type feedback (observed in ses_mst2r0r5).
+        // Корень проекта резолвим от РЕДАКТИРОВАННОГО ФАЙЛА, а не от baseDir агента.
+        // Во вложенной раскладке (`baseDir/proj/tsconfig.json`) старый поиск от
+        // baseDir молча скипал typecheck на каждой записи — вся сессия шла
+        // вообще без типового фидбэка (наблюдено в ses_mst2r0r5).
         const projectRoot = findProjectRoot(filePath, baseDir, ["tsconfig.json", "package.json"]);
         const tsconfigPath = join(projectRoot, "tsconfig.json");
         if (!existsSync(tsconfigPath)) {
@@ -239,28 +243,29 @@ export class LintOnWritePlugin {
             return;
         }
         const now = Date.now();
-        if (this._checkPromise && now - this._checkTimestamp < TYPE_CHECK_DEBOUNCE_MS) {
-            const error = await this._checkPromise;
+        const prev = this._checks.get(projectRoot);
+        if (prev && now - prev.at < TYPE_CHECK_DEBOUNCE_MS) {
+            const error = await prev.promise;
             if (error) {
                 result.output += `\n\n[Project typecheck failed]: ${error}`;
             }
             return;
         }
-        this._checkTimestamp = now;
-        this._checkPromise = this.runTscCheck(tsc, projectRoot, signal);
-        const error = await this._checkPromise;
+        const promise = this.runTscCheck(tsc, projectRoot, signal);
+        this._checks.set(projectRoot, { at: now, promise });
+        const error = await promise;
         if (error) {
-            // Try to auto-fix fixable errors
+            // Пробуем автофиксить чинимые ошибки
             const { stdout, stderr } = await runAsync(`${tsc} --noEmit --skipLibCheck 2>&1`, projectRoot, 30000, signal).catch(() => ({ stdout: "", stderr: error }));
             const output = stderr || stdout;
             const errors = parseTscOutput(output);
             if (errors.length > 0) {
                 const fixResult = autoFixErrors(filePath, readFileSync(filePath, "utf-8"), errors);
                 if (fixResult.fixed) {
-                    // Write the fixed content
+                    // Пишем починенное содержимое
                     writeFileSync(filePath, fixResult.newContent, "utf-8");
                     result.output += `\n\n[Auto-fixed]: ${fixResult.applied.join("; ")}`;
-                    // If there are remaining errors, show them
+                    // Если остались ошибки — показываем их
                     if (fixResult.remaining.length > 0) {
                         const remainingMsg = fixResult.remaining
                             .map((e) => `TS${e.code}: ${e.message}`)
@@ -279,7 +284,7 @@ export class LintOnWritePlugin {
     }
     async runTscCheck(tsc, baseDir, signal) {
         try {
-            const { stdout, stderr } = await runAsync(`${tsc} --noEmit --skipLibCheck`, baseDir, 30000, signal);
+            await runAsync(`${tsc} --noEmit --skipLibCheck`, baseDir, 30000, signal);
             return null;
         }
         catch (err) {
@@ -299,17 +304,29 @@ export class LintOnWritePlugin {
     }
 }
 /**
- * Run a command asynchronously (non-blocking event loop) and resolve when it
- * exits. Rejects with captured stderr/stdout on non-zero exit or timeout.
+ * Гоняет команду асинхронно (не стопая event loop) и резолвится на выходе.
+ * Реджектит с захваченными stderr/stdout при ненулевом коде или таймауте.
+ *
+ * Простая строка идёт через шелл (проектные скрипты). Спецификация
+ * `{file,args}` спавнится БЕЗ шелла — обязательно для всего, собранного из
+ * модельного пути (`bun build … <file>`, `node --check <file>`): в имени могут
+ * быть `$()`, бектики или `%VAR%`, а shell:true их исполнил бы (инъекция).
  */
 function runAsync(command, cwd, timeoutMs, signal) {
     return new Promise((resolve, reject) => {
-        const child = spawn(command, {
-            cwd,
-            shell: true,
-            windowsHide: true,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
+        const child = typeof command === "string"
+            ? spawn(command, {
+                cwd,
+                shell: true,
+                windowsHide: true,
+                stdio: ["ignore", "pipe", "pipe"],
+            })
+            : spawn(command.file, command.args, {
+                cwd,
+                shell: false,
+                windowsHide: true,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
         const utf8Chunks = [];
         const oemChunks = [];
         child.stdout?.on("data", (d) => {
@@ -322,10 +339,10 @@ function runAsync(command, cwd, timeoutMs, signal) {
             child.kill();
             reject(new Error(`Command timed out after ${timeoutMs}ms`));
         }, timeoutMs);
-        // Interrupt (Esc/Ctrl+C): kill the child so the agent loop can return to
-        // the prompt immediately instead of waiting out a long tsc/lint run. The
-        // close handler resolves empty when aborted — the caller's `signal.aborted`
-        // guard discards the result anyway.
+        // Прерывание (Esc/Ctrl+C): убиваем ребёнка, чтобы петля агента сразу
+        // вернулась в промпт, а не высиживала длинный tsc/lint. Хендлер close
+        // при аборте резолвит пусто — гард `signal.aborted` вызывающего результат
+        // всё равно отбрасывает.
         const onAbort = () => child.kill();
         if (signal?.aborted) {
             child.kill();
@@ -348,17 +365,13 @@ function runAsync(command, cwd, timeoutMs, signal) {
             signal?.removeEventListener("abort", onAbort);
             const stdout = decodeOutput(utf8Chunks);
             const stderr = decodeOutput(oemChunks);
-            if (signal?.aborted || code === 0) {
+            if (signal?.aborted) {
                 resolve({ stdout, stderr });
+                return;
             }
-            else {
-                const err = new Error(`Command failed with exit code ${code}`);
-                err.stdout = stdout;
-                err.stderr = stderr;
-                err.status = code;
-                reject(err);
-            }
+            settleChildClose(code, stdout, stderr, `Command failed with exit code ${code}`, resolve, reject);
         });
     });
 }
+/** Готовый инстанс для регистрации. */
 export const plugin = new LintOnWritePlugin();

package/dist/modules/plugins/builtin/notify.js

@@ -1,3 +1,4 @@
+/** Встроенный плагин: пишет в лог завершение сессии. */
 export class NotifyPlugin {
     name = "notify";
     priority = 5;
@@ -6,4 +7,5 @@ export class NotifyPlugin {
         ctx.logger.info("Session ended");
     }
 }
+/** Готовый инстанс для регистрации. */
 export const plugin = new NotifyPlugin();

package/dist/modules/plugins/index.js

@@ -1 +1,2 @@
+// Публичная поверхность плагинов: менеджер и тип плагина.
 export { PluginManager } from "./manager";

package/dist/modules/plugins/loader.js

@@ -1,20 +1,35 @@
+// Загрузчик плагинов из каталогов: файлы и папки, гейт по minMmaVersion.
 import { readdirSync, existsSync, statSync } from "fs";
 import { join, basename } from "path";
 import { t } from "../../i18n/index";
 import { semverGt } from "../updater/checker";
 /**
- * Entry file candidates for folder plugins. Looked up in order:
+ * Кандидаты точки входа для плагинов-папок. Порядок:
  * `plugin.ts` > `plugin.js` > `index.ts` > `index.js`.
  */
 const FOLDER_ENTRY_NAMES = ["plugin.ts", "plugin.js", "index.ts", "index.js"];
+/** Грузит плагины из каталога и регистрирует в менеджере (битые — скип с варном). */
 export class PluginLoader {
+    /**
+     * Сканирует каталог (файлы .ts/.js и папки с точкой входа).
+     * Нет каталога — no-op.
+     */
     loadFromDir(dirPath, pluginManager, logger, options) {
         if (!existsSync(dirPath))
             return;
         const entries = readdirSync(dirPath).sort();
         for (const entry of entries) {
             const fullPath = join(dirPath, entry);
-            const stat = statSync(fullPath);
+            // Битый симлинк / отказ в доступе не должен ронять весь скан плагинов
+            // (а с ним и bootstrap) — пропускаем с предупреждением.
+            let stat;
+            try {
+                stat = statSync(fullPath);
+            }
+            catch (e) {
+                logger?.warn(`Skipping unreadable plugin entry "${fullPath}": ${String(e)}`);
+                continue;
+            }
             if (stat.isFile()) {
                 if (!entry.endsWith(".ts") && !entry.endsWith(".js"))
                     continue;
@@ -40,7 +55,7 @@ export class PluginLoader {
         try {
             const mod = require(fullPath);
             const plugin = mod.default || mod.plugin;
-            if (plugin && plugin.name) {
+            if (plugin?.name) {
                 if (plugin.minMmaVersion &&
                     options?.mmaVersion &&
                     semverGt(plugin.minMmaVersion, options.mmaVersion)) {

package/dist/modules/plugins/manager.js

@@ -2,16 +2,16 @@ import { semverGt } from "../updater/checker";
 import { Logger } from "../../logger/app-logger";
 const logger = new Logger("warn", "plugins");
 /**
- * Run a (possibly async) plugin hook with error isolation. Sync throws and
- * async rejections are both logged and swallowed — one broken plugin must
- * never crash the agent or other plugins.
+ * Гоняет (возможно асинхронный) хук плагина с изоляцией ошибок. Синхронные
+ * броски и асинхронные реджекты логгируются и глотаются — один битый плагин
+ * не должен ронять агента и остальные плагины.
  */
 function safeInvoke(plugin, hookName, fn) {
     try {
         const out = fn();
         if (out instanceof Promise) {
-            // The promise rejects AFTER this try/catch has exited — attach a catch
-            // now, otherwise isolation is broken by an unhandledRejection.
+            // Промис реджектится УЖЕ ПОСЛЕ выхода из этого try/catch — вешаем catch
+            // сразу, иначе изоляцию ломает необработанный unhandledRejection.
             out.catch((e) => {
                 logger.warn(`plugin "${plugin.name}" ${hookName} rejected`, { error: String(e) });
             });
@@ -24,17 +24,18 @@ function safeInvoke(plugin, hookName, fn) {
         return undefined;
     }
 }
+/** Менеджер плагинов: реестр, сортировка по приоритету, диспатч хуков. */
 export class PluginManager {
     plugins = [];
     hostBridge = null;
     /**
-     * Register the host bridge (set once by the REPL). It is merged into every
-     * hook context as `ctx.hostBridge` unless the caller already provided one.
+     * Регистрирует host-мост (ставит REPL один раз). Подмешивается в каждый
+     * хук-контекст как `ctx.hostBridge`, если вызывающий не дал свой.
      */
     setHostBridge(bridge) {
         this.hostBridge = bridge;
     }
-    /** Merge the host bridge into a hook context (caller-provided value wins). */
+    /** Подмешивает host-мост в хук-контекст (значение вызывающего побеждает). */
     withHost(ctx) {
         if (!ctx || typeof ctx !== "object")
             return ctx;
@@ -44,9 +45,9 @@ export class PluginManager {
         return { ...ctx, hostBridge: this.hostBridge };
     }
     /**
-     * Register a plugin. Plugins with the same `name` are deduplicated — the
-     * higher `version` wins (unversioned plugins count as "0.0.0"). The loser is
-     * discarded; `skipped_older` lets the caller warn about the dropped copy.
+     * Регистрирует плагин. Одноимённые дедупятся — побеждает старшая `version`
+     * (безверсейные считаются "0.0.0"). Проигравший отбрасывается; `skipped_older`
+     * даёт вызывающему предупредить о выкинутой копии.
      */
     register(plugin, source) {
         if (source)
@@ -68,27 +69,36 @@ export class PluginManager {
     sort() {
         this.plugins.sort((a, b) => (b.priority || 0) - (a.priority || 0));
     }
+    /** Все зарегистрированные плагины (копия, по приоритету). */
     getAllPlugins() {
         return [...this.plugins];
     }
-    /** Detailed plugin list (name, version, source) for REPL / CLI display. */
+    /** Детальный список (имя, версия, источник) для показа в REPL/CLI. */
     getPluginInfos() {
         return [...this.plugins].map((plugin) => ({ plugin, source: plugin.source }));
     }
-    /** Find a registered plugin by name, or null. */
+    /** Ищет зарегистрированный плагин по имени; null, если нет. */
     getPlugin(name) {
         return this.plugins.find((p) => p.name === name) ?? null;
     }
+    /** Гоняет хук сборки промпта по всем плагинам; собирает вклады. */
     runOnBuildPrompt() {
         return this.plugins.map((p) => safeInvoke(p, "onBuildPrompt", () => p.onBuildPrompt?.() ?? null) ?? null);
     }
+    /**
+     * Хук перед тулом. False (любой плагин против) — не выполнять.
+     * Возвращает false при блокировке, true при разрешении.
+     */
     async runOnBeforeTool(rawCtx, call) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
             if (plugin.onBeforeTool) {
                 try {
                     const result = await plugin.onBeforeTool(ctx, call);
-                    if (result === false)
+                    // Контракт плагина разрешает блокировать `false` ИЛИ строкой-причиной
+                    // (экзекутор тулов понимает оба). Проигнорировать строку здесь —
+                    // молча не заблокировать, если путь когда-нибудь задействуют.
+                    if (result === false || typeof result === "string")
                         return false;
                 }
                 catch (e) {
@@ -98,6 +108,7 @@ export class PluginManager {
         }
         return true;
     }
+    /** Хук после тула: отдаёт вызов и результат всем плагинам. */
     async runOnAfterTool(rawCtx, call, result) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -111,6 +122,7 @@ export class PluginManager {
             }
         }
     }
+    /** Хук ошибки агента: рассылает ошибку всем плагинам. */
     async runOnError(rawCtx, error) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -124,6 +136,7 @@ export class PluginManager {
             }
         }
     }
+    /** Хук старта сессии. */
     runOnSessionStart(rawCtx) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -132,6 +145,7 @@ export class PluginManager {
             }
         }
     }
+    /** Хук перед обдумыванием (THINK). */
     runOnBeforeThink(rawCtx) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -140,6 +154,7 @@ export class PluginManager {
             }
         }
     }
+    /** Хук после ответа LLM. */
     runOnAfterThink(rawCtx, response) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -148,6 +163,7 @@ export class PluginManager {
             }
         }
     }
+    /** Хук конца сессии. */
     runOnSessionEnd(rawCtx) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -156,6 +172,7 @@ export class PluginManager {
             }
         }
     }
+    /** Хук вызова тула (факт вызова, без результата). */
     runOnToolCall(rawCtx) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -164,6 +181,7 @@ export class PluginManager {
             }
         }
     }
+    /** Хук смены фазы агента. */
     runOnPhase(rawCtx, phase) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -172,6 +190,7 @@ export class PluginManager {
             }
         }
     }
+    /** Хук старта тул-вызова. */
     runOnToolStart(rawCtx, call) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -180,6 +199,7 @@ export class PluginManager {
             }
         }
     }
+    /** Хук конца тул-вызова (вызов, результат, длительность). */
     runOnToolEnd(rawCtx, call, result, durationMs) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -188,7 +208,7 @@ export class PluginManager {
             }
         }
     }
-    /** Pipe a text chunk through plugin transforms; returns the (possibly replaced) chunk. */
+    /** Прогоняет текстовый чанк через трансформы плагинов; возвращает (возможно заменённый) чанк. */
     runOnText(rawCtx, chunk) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -200,7 +220,7 @@ export class PluginManager {
         }
         return chunk;
     }
-    /** Pipe a meta chunk through plugin transforms; returns the (possibly replaced) chunk. */
+    /** Прогоняет мета-чанк через трансформы плагинов; возвращает (возможно заменённый) чанк. */
     runOnMeta(rawCtx, chunk) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {
@@ -212,7 +232,7 @@ export class PluginManager {
         }
         return chunk;
     }
-    /** Dispatch a completed-run summary to all plugins (once per Agent.run()). */
+    /** Рассылает сводку завершённого прогона всем плагинам (раз за Agent.run()). */
     runOnTurnEnd(rawCtx, summary) {
         const ctx = this.withHost(rawCtx);
         for (const plugin of this.plugins) {

package/dist/modules/pricing/index.js

@@ -1,10 +1,9 @@
 import { calculateCostDetailed, formatCost } from "./prices";
 /**
- * Accumulates per-call LLM cost for a session, attributed to the provider
- * that served the call. Call `record()` after each LLM call with the
- * (estimated or API) token usage and the provider name; read `total` for the
- * running total, `totalFor(provider)` / `breakdown()` for per-provider
- * attribution. When the model has no known price, `record` is a no-op.
+ * Копит стоимость LLM-вызовов сессии с атрибуцией обслужившему провайдеру.
+ * После каждого вызова — `record()` с usage (оценочным или API) и именем
+ * провайдера; `total` даёт running-итог, `totalFor(provider)` / `breakdown()` —
+ * разбивку. Без известной цены модели `record` — no-op.
  */
 export class CostTracker {
     config;
@@ -17,7 +16,7 @@ export class CostTracker {
         this.model = model;
         this.config = config;
     }
-    /** Update the model (on /model switch). Later records use the new price. */
+    /** Сменяет модель (при /model switch). Дальнейшие записи — по новой цене. */
     setModel(model) {
         this.model = model;
     }
@@ -42,7 +41,7 @@ export class CostTracker {
         entry.known = true;
         entry.total += result.cost;
     }
-    /** Running total cost in USD, or undefined if no model price is known. */
+    /** Итоговая стоимость в USD; undefined без известной цены модели. */
     get total() {
         return this._known ? this._total : undefined;
     }
@@ -50,12 +49,12 @@ export class CostTracker {
     get saved() {
         return this._known ? this._saved : undefined;
     }
-    /** Total for one provider, or undefined when nothing was priced for it. */
+    /** Итог по одному провайдеру; undefined, если по нему ничего не оценено. */
     totalFor(provider) {
         const entry = this.byProvider.get(provider);
-        return entry && entry.known ? entry.total : undefined;
+        return entry?.known ? entry.total : undefined;
     }
-    /** Per-provider totals sorted by cost descending (priced providers only). */
+    /** Итоги по провайдерам по убыванию стоимости (только оценённые). */
     breakdown() {
         const entries = [];
         for (const [provider, entry] of this.byProvider) {
@@ -64,7 +63,7 @@ export class CostTracker {
         }
         return entries.sort((a, b) => b.cost - a.cost);
     }
-    /** Human-readable total, or undefined when pricing is unavailable. */
+    /** Читаемый итог; undefined, когда цен нет. */
     get formatted() {
         return this._known ? formatCost(this._total) : undefined;
     }