micro-models-agent 2.10.0 → 2.12.0

package/dist/modules/pricing/prices.js

@@ -1,11 +1,11 @@
 /**
- * Built-in price table (USD per 1M tokens) for OpenCode Zen / Go models.
- * Values from https://opencode.ai/docs/zen/ and /docs/go/ (August 2026).
- * Model ids are stored WITHOUT the `opencode/` or `opencode-go/` prefix so a
- * single table serves both providers; lookup strips the prefix.
+ * Встроенная таблица цен (USD за 1M токенов) для моделей OpenCode Zen / Go.
+ * Значения из https://opencode.ai/docs/zen/ и /docs/go/ (август 2026).
+ * Id хранятся БЕЗ префиксов `opencode/` и `opencode-go/`, чтобы одна таблица
+ * обслуживала обоих провайдеров; лукап срезает префикс.
  */
 const ZEN_PRICES = {
-    // Free models
+    // Бесплатные модели
     "big-pickle": { input: 0, output: 0 },
     "mimo-v2.5-free": { input: 0, output: 0 },
     "hy3-free": { input: 0, output: 0 },
@@ -32,7 +32,7 @@ const ZEN_PRICES = {
     "qwen3.6-plus": { input: 0.5, output: 3.0 },
     "qwen3.5-plus": { input: 0.2, output: 1.2 },
     "qwen3.8-max": { input: 2.5, output: 7.5 },
-    // DeepSeek (off-peak)
+    // DeepSeek (внепиковые тарифы)
     "deepseek-v4-pro": { input: 0.66, output: 1.98 },
     "deepseek-v4-flash": { input: 0.22, output: 0.66 },
     // Claude
@@ -59,7 +59,7 @@ const ZEN_PRICES = {
     "grok-build-0.1": { input: 1, output: 2 },
     // Muse Spark
     "muse-spark-1.2": { input: 1.25, output: 4.25 },
-    // GPT-5.x (Zen pricing; Go may differ)
+    // GPT-5.x (цены Zen; у Go могут отличаться)
     "gpt-5.6-sol": { input: 5, output: 30 },
     "gpt-5.6-terra": { input: 2, output: 12 },
     "gpt-5.6-luna": { input: 0.2, output: 1.2 },
@@ -81,9 +81,9 @@ const ZEN_PRICES = {
     "gpt-5-codex": { input: 1.07, output: 8.5 },
     "gpt-5-nano": { input: 0.05, output: 0.4 },
 };
-/** Provider prefixes stripped before a price lookup. */
+/** Префиксы провайдеров, срезаемые перед поиском цены. */
 const PROVIDER_PREFIXES = ["opencode-go/", "opencode/", "openai/", "anthropic/"];
-/** Normalize a model id to its bare form for the price table lookup. */
+/** Нормализует id модели к голой форме для поиска в таблице цен. */
 export function normalizeModelId(model) {
     let id = model.trim();
     for (const prefix of PROVIDER_PREFIXES) {
@@ -92,11 +92,11 @@ export function normalizeModelId(model) {
             break;
         }
     }
-    // Strip a vendor path like qwen/qwen3.5-9b -> qwen3.5-9b (keeps bare ids).
+    // Срезаем вендорный путь вида qwen/qwen3.5-9b -> qwen3.5-9b (голые id не трогаем).
     const parts = id.split("/");
     return parts[parts.length - 1];
 }
-/** Resolve the price for a model id. Overrides win, then the builtin table. */
+/** Резолвит цену модели. Оверрайды побеждают, затем встроенная таблица. */
 export function resolvePrice(model, config) {
     if (!config?.enabled)
         return undefined;
@@ -135,7 +135,7 @@ export function calculateCostDetailed(model, promptTokens, completionTokens, con
 export function calculateCost(model, promptTokens, completionTokens, config, cache) {
     return calculateCostDetailed(model, promptTokens, completionTokens, config, cache)?.cost;
 }
-/** Format a USD cost for display. Zero and very small amounts stay readable. */
+/** Форматирует USD-стоимость для показа. Ноль и копейки остаются читаемыми. */
 export function formatCost(cost) {
     if (cost === 0)
         return "$0.00";

package/dist/modules/processes/index.js

@@ -1,3 +1,4 @@
+// Публичная поверхность фоновых процессов: реестр, килл дерева и kill-колбэки тулов.
 export { registerKillable, unregisterKillable, killByCallId } from "./runner";
 export { processRegistry } from "./registry";
 export { killTree } from "./kill-tree";

package/dist/modules/processes/kill-tree.js

@@ -1,45 +1,41 @@
-import { spawnSync } from "child_process";
+// Кроссплатформенный килл дерева процессов, неблокирующий (без stall event loop).
+import { spawn } from "child_process";
 import { platform } from "os";
-/** Synchronous pause without blocking the event loop (via Atomics.wait). */
-function sleepSync(ms) {
-    try {
-        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-    }
-    catch {
-        /* ignore */
-    }
-}
+/** Fire a `taskkill /T /F` and resolve when it exits (never rejects). */
 function taskkillPid(pid) {
-    try {
-        spawnSync("taskkill", ["/pid", String(pid), "/T", "/F"], {
-            windowsHide: true,
-            stdio: "ignore",
-            timeout: 5000,
-        });
-    }
-    catch {
-        /* already dead */
-    }
+    return new Promise((resolve) => {
+        try {
+            const child = spawn("taskkill", ["/pid", String(pid), "/T", "/F"], {
+                windowsHide: true,
+                stdio: "ignore",
+            });
+            child.on("close", () => resolve());
+            child.on("error", () => resolve());
+        }
+        catch {
+            /* уже мёртв / нет taskkill */
+        }
+    });
 }
 /**
- * Kill a spawned process tree — cross-platform.
+ * Убивает дерево спавненного процесса — кроссплатформенно, неблокирующе.
  *
- * Windows: double `taskkill /T /F` with a 150ms settle gap. The second pass
- * catches late-attaching children that were still being created during the
- * first tree walk (e.g. `cmd.exe → node → tsserver` chains where node is
- * still starting up when cmd is killed).
+ * Windows: два прохода `taskkill /T /F` с паузой 150мс (второй добирает детей,
+ * ещё создававшихся во время первого обхода дерева, напр. `cmd → node →
+ * tsserver`). Оба АСИНХРОННЫ: прежние `spawnSync` + `Atomics.wait` стопили
+ * event loop (фроз UI/стрима) до ~10с на процесс при шатдауне.
  *
- * POSIX: process-group kill (`-pid`). Falls back to `SIGKILL` on the direct
- * child when the group kill fails (e.g. non-detached process).
+ * POSIX: килл группы (`-pid`), при неудаче — `SIGKILL` прямому ребёнку
+ * (напр. не-detached процесс).
  */
 export function killTree(child) {
     const pid = child.pid;
     if (!pid)
         return;
     if (platform() === "win32") {
-        taskkillPid(pid);
-        sleepSync(150);
-        taskkillPid(pid);
+        void taskkillPid(pid).then(() => {
+            setTimeout(() => void taskkillPid(pid), 150);
+        });
         return;
     }
     try {
@@ -50,7 +46,7 @@ export function killTree(child) {
             child.kill("SIGKILL");
         }
         catch {
-            /* already dead */
+            /* уже мёртв */
         }
     }
 }

package/dist/modules/processes/registry.js

@@ -1,10 +1,14 @@
+// Реестр фоновых процессов: спавн, буферизация лога, килл, ожидание выхода.
 import { spawn, spawnSync } from "child_process";
 import { platform } from "os";
 import { killTree } from "./kill-tree";
 const MAX_LOG_LINES = 2000;
+/** Кап одной незавершённой строки, чтобы дамп без переводов не дал OOM. */
+const MAX_PARTIAL_CHARS = 64 * 1024;
+const MAX_PARTIAL_BYTES = 64 * 1024;
 const MAX_KEPT_PROCESSES = 20;
 let seq = 0;
-/** OEM decoder (Russian CP866 / active code page) — cached after first use. */
+/** OEM-декодер (русская CP866 / активная кодовая страница) — кеш после первого вызова. */
 let oemDecoder;
 function getOemDecoder() {
     if (oemDecoder !== undefined)
@@ -19,7 +23,7 @@ function getOemDecoder() {
         const m = cpOut ? cpOut.toString("latin1").match(/(\d+)/) : null;
         if (m) {
             try {
-                oemDecoder = new TextDecoder("ibm" + m[1]);
+                oemDecoder = new TextDecoder(`ibm${m[1]}`);
             }
             catch {
                 oemDecoder = null;
@@ -40,19 +44,19 @@ function getOemDecoder() {
     return oemDecoder;
 }
 /**
- * Decode one complete line of output to UTF-8.
+ * Декодирует одну готовую строку вывода в UTF-8.
  *
- * Modern tools (Bun, Node, npm, git) write UTF-8 into the pipe regardless of
- * the console code page, while built-in cmd.exe commands (echo, type, dir)
- * emit the OEM code page (CP866 on Russian Windows). Try strict UTF-8 first;
- * fall back to the OEM decoder when the bytes are not valid UTF-8.
+ * Современные тулы (Bun, Node, npm, git) пишут UTF-8 в пайп независимо от
+ * кодовой страницы консоли, а встроенные команды cmd.exe (echo, type, dir) —
+ * OEM-страницу (CP866 на русской Windows). Сначала строгий UTF-8; если байты
+ * невалидны — откат на OEM-декодер.
  */
 function decodeLineToUtf8(buf) {
     try {
         return new TextDecoder("utf-8", { fatal: true }).decode(buf);
     }
     catch {
-        /* not valid UTF-8 → OEM code page output */
+        /* невалидный UTF-8 → вывод в OEM-кодировке */
     }
     const oem = getOemDecoder();
     if (oem) {
@@ -60,19 +64,20 @@ function decodeLineToUtf8(buf) {
             return oem.decode(buf);
         }
         catch {
-            /* unknown encoding — latin1 fallback */
+            /* неизвестная кодировка — откат на latin1 */
         }
     }
     return buf.toString("latin1");
 }
+/** Реэкспорт килла дерева для потребителей реестра. */
 export { killTree } from "./kill-tree";
 class ProcessRegistry {
     procs = new Map();
     children = new Map();
     exitWaiters = new Map();
     /**
-     * Start a command. The returned entry buffers output and reports status; a
-     * call may check `waitForExit(id)` to learn when (if ever) it finishes.
+     * Запускает команду. Возвращённая запись буферизует вывод и отдаёт статус;
+     * дождаться завершения можно через `waitForExit(id)`.
      */
     start(command, cwd, sessionId) {
         const id = `proc_${Date.now()}_${++seq}`;
@@ -126,12 +131,17 @@ class ProcessRegistry {
                 for (const line of lines) {
                     pushLine(line);
                 }
+                // Сбрасываем очень длинную частичную строку вместо безлимитной буферизации.
+                if (buf.length > MAX_PARTIAL_CHARS) {
+                    pushLine(buf);
+                    buf = "";
+                }
                 return;
             }
-            // Windows: buffer raw bytes and decode per line. Modern tools (Bun, Node,
-            // npm, git) write UTF-8 into the pipe regardless of the console code
-            // page; cmd.exe builtins (echo, type, dir) emit the OEM code page. Pick
-            // the right decoding per line so Russian text survives either way.
+            // Windows: копим сырые байты и декодируем построчно. Современные тулы
+            // (Bun, Node, npm, git) пишут UTF-8 в пайп независимо от кодовой страницы
+            // консоли; встроенные команды cmd.exe (echo, type, dir) — OEM-страницу.
+            // Декодировка подбирается построчно, чтобы русский выживал в обоих случаях.
             byteBuf = byteBuf.length ? Buffer.concat([byteBuf, chunk]) : Buffer.from(chunk);
             let nl;
             while ((nl = byteBuf.indexOf(0x0a)) !== -1) {
@@ -139,6 +149,11 @@ class ProcessRegistry {
                 byteBuf = byteBuf.subarray(nl + 1);
                 pushLine(decodeLineToUtf8(raw).replace(/\r$/, ""));
             }
+            // Сбрасываем очень длинную частичную строку вместо безлимитной буферизации.
+            if (byteBuf.length > MAX_PARTIAL_BYTES) {
+                pushLine(decodeLineToUtf8(byteBuf));
+                byteBuf = Buffer.alloc(0);
+            }
         };
         const flush = () => {
             if (!isWin) {
@@ -164,9 +179,9 @@ class ProcessRegistry {
                 entry.status = "killed";
             }
             entry.spawnError = err.message;
-            // Write directly to the log, not through `append`: a failed spawn often
-            // never emits `close`, so the buffered line would never be flushed and
-            // the log would be empty (observed: "records a spawn error" test).
+            // Пишем прямо в лог, не через `append`: упавший спавн часто вообще
+            // не эмитит `close`, и буферизованная строка не сбросилась бы —
+            // лог остался бы пустым (видно в тесте "records a spawn error").
             pushLine(`[process error] ${err.message}`);
             resolveExit();
         });
@@ -186,15 +201,18 @@ class ProcessRegistry {
         this.exitWaiters.set(id, { promise, resolve });
         return entry;
     }
+    /** Список процессов, опционально по сессии. */
     list(sessionId) {
         const all = Array.from(this.procs.values());
         if (!sessionId)
             return all;
         return all.filter((p) => p.sessionId === sessionId);
     }
+    /** Процесс по id; undefined, если нет. */
     get(id) {
         return this.procs.get(id);
     }
+    /** Лог процесса целиком или хвостом `tail` строк. */
     getLog(id, tail) {
         const entry = this.procs.get(id);
         if (!entry)
@@ -202,7 +220,7 @@ class ProcessRegistry {
         const lines = tail && tail > 0 ? entry.log.slice(-tail) : entry.log;
         return lines.join("\n");
     }
-    /** Kill a background process tree. Returns false when not found. */
+    /** Убивает дерево фонового процесса. False, если не найден. */
     kill(id) {
         const entry = this.procs.get(id);
         if (!entry)
@@ -216,7 +234,7 @@ class ProcessRegistry {
         }
         return true;
     }
-    /** Kill every managed background process (used on agent shutdown). */
+    /** Убивает все управляемые фоновые процессы (при останове агента). Возвращает число. */
     killAll(sessionId) {
         const targets = this.list(sessionId);
         for (const entry of targets) {
@@ -225,13 +243,13 @@ class ProcessRegistry {
         return targets.length;
     }
     /**
-     * Resolve `true` when the process exits (or fails to spawn) within
-     * `timeoutMs`, otherwise `false` (still running → a background process).
+     * Резолвит `true`, если процесс вышел (или не спавнился) за `timeoutMs`,
+     * иначе `false` (всё ещё бежит → фоновый процесс).
      */
     waitForExit(id, timeoutMs) {
         const entry = this.procs.get(id);
         const waiter = this.exitWaiters.get(id);
-        if (!entry || entry.status !== "running" || !waiter) {
+        if (entry?.status !== "running" || !waiter) {
             return Promise.resolve(true);
         }
         return new Promise((resolve) => {
@@ -243,8 +261,8 @@ class ProcessRegistry {
         });
     }
     /**
-     * Remove a finished entry (foreground results do not linger). A still-running
-     * entry is killed first so nothing is orphaned.
+     * Удаляет завершённую запись (foreground-результаты не залеживаются).
+     * Ещё бегущая сначала убивается, чтобы не осиротеть.
      */
     remove(id) {
         const entry = this.procs.get(id);
@@ -272,4 +290,5 @@ class ProcessRegistry {
         }
     }
 }
+/** Синглтон реестра фоновых процессов. */
 export const processRegistry = new ProcessRegistry();

package/dist/modules/processes/runner.js

@@ -1,13 +1,13 @@
 const activeChildren = new Map();
-/** Register a kill callback for a tool call id (executor timeout/abort). */
+/** Регистрирует kill-колбэк тул-вызова (для таймаута/аборта экзекутора). */
 export function registerKillable(callId, kill) {
     activeChildren.set(callId, { kill });
 }
-/** Unregister a tool call's kill callback once its handler finished. */
+/** Снимает kill-колбэк завершившегося хендлера. */
 export function unregisterKillable(callId) {
     activeChildren.delete(callId);
 }
-/** Invoke (and drop) the kill callback registered for `callId`. */
+/** Вызывает (и снимает) kill-колбэк для `callId`; false — не было. */
 export function killByCallId(callId) {
     const entry = activeChildren.get(callId);
     if (!entry)
@@ -17,7 +17,7 @@ export function killByCallId(callId) {
         entry.kill();
     }
     catch {
-        /* already dead */
+        /* уже мёртв */
     }
     return true;
 }

package/dist/modules/providers/capabilities.js

@@ -0,0 +1,28 @@
+/**
+ * Консервативный фолбэк, когда ни пресет, ни probe, ни конфиг не дали данных.
+ * "false" безопаснее "true": неверное "нет vision" ведёт к текстовому
+ * snapshot'у, неверное "есть vision" — к отправке картинки, которую бэкенд
+ * отвергнет или проигнорирует.
+ */
+export const DEFAULT_MODEL_CAPABILITIES = {
+    vision: false,
+    tools: false,
+};
+/**
+ * Единый источник правды о возможностях АКТИВНОЙ модели (данные, не
+ * эвристика по имени — правило #10). Приоритет слоёв, от высшего к низшему:
+ *
+ *   1. явный конфиг-оверрайд пользователя (`config.modelCapabilities[model]`);
+ *   2. живой probe провайдера (LM Studio native API и т.п.);
+ *   3. пресет провайдера (`providers/presets.ts`).
+ *
+ * Всегда возвращает новый объект: вызывающий не рискует мутировать общий
+ * пресет или конфиг. Отсутствующие в probe поля берутся из нижнего слоя —
+ * probe может уточнять только часть возможностей.
+ */
+export function resolveModelCapabilities(preset, probe, override) {
+    const base = preset
+        ? { vision: preset.vision, tools: preset.tools }
+        : { ...DEFAULT_MODEL_CAPABILITIES };
+    return { ...base, ...(probe ?? {}), ...(override ?? {}) };
+}

package/dist/modules/providers/create.js

@@ -1,9 +1,8 @@
 import { BUILTIN_PROVIDERS } from "./presets";
 import { ProviderRegistry as Registry } from "./registry";
 /**
- * The single entry point for building a provider. Unknown types fall back to
- * the OpenAI-compatible provider (backward compatible with legacy configs that
- * use a custom `type` + baseUrl).
+ * Единая точка сборки провайдера. Неизвестные типы откатываются на
+ * OpenAI-совместимый (совместимость с легаси-конфигами: кастомный `type` + baseUrl).
  */
 export function createProvider(type, opts, registry = defaultRegistry()) {
     const spec = registry.get(type);
@@ -12,7 +11,7 @@ export function createProvider(type, opts, registry = defaultRegistry()) {
     }
     return spec.create(opts);
 }
-/** Registry preloaded with all builtin provider presets. */
+/** Реестр, предзагруженный всеми builtin-пресетами. */
 export function defaultRegistry() {
     const registry = new Registry();
     for (const spec of BUILTIN_PROVIDERS) {

package/dist/modules/providers/factory.js

@@ -1,14 +1,14 @@
 import { ProviderManager } from "./manager";
 import { FallbackProvider } from "./fallback";
 /**
- * Shared factory for building the ACTIVE provider from a config, used by both
- * bootstrap and Agent.setProvider/reconfigure. Previously the three
- * construction sites drifted — bootstrap wrapped the manager in
- * FallbackProvider when `fallback && entries > 1`, but a hot-swap
- * (setProvider) rebuilt a bare manager and silently dropped failover (B4).
- * The wrapper reads `manager.active` live, so switching the manager after
- * build keeps the failover active.
+ * Общая фабрика АКТИВНОГО провайдера из конфига — для bootstrap и
+ * Agent.setProvider/reconfigure. Раньше три места сборки дрейфовали: bootstrap
+ * оборачивал менеджер в FallbackProvider при `fallback && entries > 1`, а
+ * hot-swap (setProvider) пересобирал голый менеджер и молча ронял failover (B4).
+ * Обёртка читает `manager.active` живьём, так что переключение менеджера после
+ * сборки failover сохраняет.
  */
+/** Собрать активный провайдер (+ failover-обёртка при entries > 1). */
 export function buildActiveProvider(config, logger, opts) {
     const manager = new ProviderManager(config.provider, {
         contextWindow: config.contextWindow,

package/dist/modules/providers/fallback.js

@@ -1,14 +1,14 @@
 import { LlmError } from "../../llm/llm-errors";
-/** True when the error is worth failing over to another provider. */
+/** Стоит ли ошибка переключения на другой провайдер. */
 export function isFailoverError(err) {
     if (err instanceof Error && err.name === "AbortError")
         return false;
-    // HTTP status, attached by openai-compat as a typed LlmError: retryable only.
+    // HTTP-статус, прикреплённый openai-compat как типизированный LlmError: только ретраируемые.
     if (err instanceof LlmError && typeof err.llmStatus === "number") {
         return err.llmStatus === 429 || err.llmStatus >= 500;
     }
-    // Network-level failures by errno-style code (Bun: "ConnectionRefused",
-    // Node: "ECONNREFUSED", DNS: "ENOTFOUND"/"EAI_AGAIN", etc).
+    // Сетевые падения по errno-коду (Bun: "ConnectionRefused",
+    // Node: "ECONNREFUSED", DNS: "ENOTFOUND"/"EAI_AGAIN" и т.д.).
     const e = err;
     const normCode = (e?.code ?? "").replace(/[-_]/g, "").toLowerCase();
     if (/^abort/.test(normCode))
@@ -16,15 +16,15 @@ export function isFailoverError(err) {
     if (/conn(refused|reset|timedout)|enotfound|eai_again|namenotresolved/.test(normCode)) {
         return true;
     }
-    // Network-level failures by message (fetch failed, timeouts, socket resets).
+    // Сетевые падения по сообщению (fetch failed, таймауты, сбросы сокета).
     return /fetch failed|unable to connect|network|econnrefused|enotfound|etimedout|socket hang up|connection refused|connection reset/i.test(e?.message ?? "");
 }
 /**
- * Wraps a FallbackSource so that retryable failures (429/5xx/network) on the
- * active provider transparently switch to the next configured entry and retry
- * there. Failover happens ONLY before any chunk was emitted — mid-stream
- * failures rethrow to avoid duplicated output. The last provider that served
- * a successful call becomes the new active entry (sticky).
+ * Оборачивает FallbackSource: ретраируемые падения (429/5xx/сеть) активного
+ * провайдера прозрачно переключаются на следующую запись с ретраем там.
+ * Failover — ТОЛЬКО до первого чанка: падение посреди стрима пробрасывается,
+ * чтобы не дублировать вывод. Последний провайдер с успешным вызовом
+ * становится активным (sticky).
  */
 export class FallbackProvider {
     source;
@@ -61,8 +61,8 @@ export class FallbackProvider {
                 return;
             }
             catch (err) {
-                // Mid-stream failure after content was delivered: a restart would
-                // duplicate chunks — surface the error instead of failing over.
+                // Падение посреди стрима после отданного контента: рестарт
+                // задублировал бы чанки — пробросить ошибку вместо failover.
                 if (emitted || !isFailoverError(err))
                     throw err;
                 lastError = err;

package/dist/modules/providers/health.js

@@ -1,8 +1,8 @@
 import { errMsg } from "../../utils";
 /**
- * Probe providers concurrently (bounded by the caller passing few entries)
- * and report ✓/✗ per entry. Uses `listModels()` — a free, cheap call — never
- * a billed chat completion. Input order is preserved in the output.
+ * Пробить провайдеры конкурентно и отчитаться ✓/✗ по каждой записи.
+ * Только `listModels()` — бесплатный дешёвый вызов, никогда не платный chat.
+ * Порядок входа в выводе сохраняется.
  */
 export async function probeProviders(targets, opts) {
     const timeoutMs = opts?.timeoutMs ?? 5000;
@@ -38,7 +38,7 @@ function withTimeout(promise, ms) {
         });
     });
 }
-/** Build probe targets from a name→provider mapping (priority order). */
+/** Собрать цели проб из маппинга имя→провайдер (порядок приоритетов). */
 export function targetsFromProviders(entries) {
     return entries.map(({ name, provider }) => ({
         name,