micro-models-agent 2.11.0 → 2.12.0

package/dist/ui/spinner.js

@@ -1,15 +1,16 @@
+// Спиннер прогресса: одна перезаписываемая строка в stderr (только TTY).
 import { pc } from "./colors";
 import stringWidth from "string-width";
 import { getTerminalWidth } from "./table";
 const FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+/** Поддерживается ли спиннер на потоке (TTY и не CI). */
 export function isSpinnerSupported(stream) {
     const s = stream ?? process.stderr;
     return Boolean(s.isTTY) && !process.env.CI;
 }
 /**
- * Zero-dependency ANSI spinner. Writes to stderr using a single
- * overwritten line (`\r` + text + clear-to-end). Disabled automatically
- * when the target stream is not a TTY.
+ * ANSI-спиннер без зависимостей. Пишет в stderr одной перезаписываемой строкой
+ * (`\r` + текст + чистка до конца). На не-TTY автоматически выключен.
  */
 export class Spinner {
     timer = null;
@@ -20,6 +21,7 @@ export class Spinner {
     stream;
     intervalMs;
     width;
+    startedAt = 0;
     constructor(opts = {}) {
         this.channel = opts.channel;
         this.stream = process.stderr;
@@ -27,23 +29,28 @@ export class Spinner {
         this.intervalMs = opts.intervalMs ?? 80;
         this.width = opts.width ?? getTerminalWidth();
     }
+    /** Крутится ли сейчас. */
     get running() {
         return this.timer !== null;
     }
+    /** Старт с сообщением (перезапускает, если уже крутится). */
     start(message) {
         if (!this.enabled)
             return;
         this.stop();
         this.message = this.truncate(message);
         this.frame = 0;
+        this.startedAt = Date.now();
         this.timer = setInterval(() => this.tick(), this.intervalMs);
         this.tick();
     }
+    /** Смена сообщения на лету. */
     setMessage(message) {
         this.message = this.truncate(message);
         if (this.timer)
             this.tick();
     }
+    /** Стоп со стиранием строки. */
     stop() {
         if (this.timer) {
             clearInterval(this.timer);
@@ -64,14 +71,18 @@ export class Spinner {
                 break;
             acc += ch;
         }
-        return acc + "…";
+        return `${acc}…`;
     }
     tick() {
         if (!this.timer)
             return;
         const frame = FRAMES[this.frame % FRAMES.length];
         this.frame++;
-        const text = "\r" + pc.cyan(frame) + " " + this.message + "\x1b[K";
+        // Секунды показываем, лишь когда ожидание заметно: тихий хинт, что тул
+        // ещё работает, а не быстрый вывод.
+        const elapsed = Date.now() - this.startedAt;
+        const suffix = elapsed >= 3000 ? pc.dim(` · ${Math.floor(elapsed / 1000)}s`) : "";
+        const text = `\r${pc.cyan(frame)} ${this.message}${suffix}\x1b[K`;
         if (this.channel)
             this.channel.writeOverlay(text);
         else

package/dist/ui/table.js

@@ -1,3 +1,4 @@
+// Таблицы чата: парсинг markdown-строк, выравнивание колонок (без рамок, см. STYLE.md).
 import stringWidth from "string-width";
 import { pc } from "./colors";
 const ELLIPSIS = "…";
@@ -23,7 +24,7 @@ function truncate(text, width) {
     }
     return acc + ELLIPSIS;
 }
-/** Split a markdown table row `| a | b |` into cells. */
+/** Режет строку `| a | b |` на ячейки. */
 export function splitRow(line) {
     const trimmed = line.trim();
     let body = trimmed;
@@ -33,7 +34,7 @@ export function splitRow(line) {
         body = body.slice(0, -1);
     return body.split("|").map((c) => c.trim());
 }
-/** Detect a markdown table separator row like `|---|---|` / `:---:` / `---:`. */
+/** Детект строки-разделителя вида `|---|---|` / `:---:` / `---:`. */
 export function isSeparatorRow(line) {
     const trimmed = line.trim();
     if (!trimmed.includes("-"))
@@ -43,7 +44,7 @@ export function isSeparatorRow(line) {
         return false;
     return cells.every((c) => /^:?-{3,}:?$/.test(c));
 }
-/** Alignments encoded by a separator row, keyed by column index. */
+/** Выравнивания из строки-разделителя, по индексу колонки. */
 export function parseAlignments(separator) {
     const out = {};
     splitRow(separator).forEach((cell, i) => {
@@ -57,8 +58,8 @@ export function parseAlignments(separator) {
     return out;
 }
 /**
- * Render a markdown table block into aligned box-drawing lines.
- * `tableLines` must include the header row and (optionally) the separator row.
+ * Рендерит markdown-блок таблицы в выровненные строки без рамок.
+ * `tableLines` включает строку шапки и опц. строку-разделитель.
  */
 export function formatTable(tableLines, opts = {}) {
     const align = opts.align ?? {};
@@ -85,9 +86,9 @@ export function formatTable(tableLines, opts = {}) {
         widths.push(w);
     }
     const maxWidth = opts.maxWidth ?? getTerminalWidth();
+    const GAP = "  ";
     const contentWidth = widths.reduce((a, b) => a + b, 0);
-    const borderWidth = columnCount * 3 + 1;
-    const totalWidth = contentWidth + borderWidth;
+    const totalWidth = contentWidth + GAP.length * Math.max(0, columnCount - 1);
     if (totalWidth > maxWidth) {
         const over = totalWidth - maxWidth;
         let remaining = over;
@@ -106,33 +107,30 @@ export function formatTable(tableLines, opts = {}) {
         for (let c = 0; c < columnCount; c++) {
             const raw = row[c] ?? "";
             const cell = truncate(raw, widths[c]);
-            const a = isHeader && align[c] === undefined ? "center" : (align[c] ?? "left");
+            const a = isHeader && align[c] === undefined ? "left" : (align[c] ?? "left");
             cells.push(pad(cell, widths[c], a));
         }
-        const content = cells.map((c) => pc.dim("│ ") + c).join("") + pc.dim("│");
+        const content = cells.join(GAP);
         return isHeader ? pc.bold(content) : content;
     };
-    const border = (l, m, r) => {
-        const seg = widths.map((w) => "─".repeat(w + 2)).join(m);
-        return pc.dim(l + seg + r);
-    };
+    // Без box-рамок: жирная шапка, dim-линейка, выровненные колонки.
     const out = [];
-    out.push(border("┌", "┬", "┐"));
     out.push(renderRow(headerRow, true));
-    out.push(border("├", "┼", "┤"));
+    const ruleWidth = widths.reduce((a, b) => a + b, 0) + GAP.length * Math.max(0, columnCount - 1);
+    out.push(pc.dim("─".repeat(Math.max(3, Math.min(ruleWidth, maxWidth - 1)))));
     for (const row of dataRows) {
         out.push(renderRow(row, false));
     }
-    out.push(border("└", "┴", "┘"));
     return out;
 }
+/** Ширина терминала; вне TTY — 80. */
 export function getTerminalWidth() {
     if (process.stdout.isTTY && process.stdout.columns) {
         return process.stdout.columns;
     }
     return 80;
 }
-/** Build pipe lines from structured data and render them as a table. */
+/** Строит pipe-строки из структурных данных и рендерит таблицей. */
 export function renderTable(headers, rows, opts = {}) {
     const lines = [];
     lines.push(`| ${headers.join(" | ")} |`);

package/dist/ui/theme.js

@@ -0,0 +1,143 @@
+// Тема чата: глифы, болтливость, акцентные цвета категорий тулов (см. STYLE.md).
+import { pc } from "./colors";
+/**
+ * Канонические глифы чата — единственный источник правды.
+ * См. `docs/design/ui/STYLE.md`. Свои маркеры по модулям не выдумывать.
+ */
+export const glyph = {
+    /** Действие (дальше — локализованный ярлык тула). */
+    action: "◇",
+    success: "✓",
+    failure: "✗",
+    warning: "⚠",
+    /** Рассуждение / обдумывание. */
+    thinking: "✦",
+    question: "?",
+    /** Эхо ввода пользователя в транскрипте. */
+    user: "↵",
+    /** Деталь или хинт восстановления. */
+    detail: "↳",
+    /** Продолжение сгруппированного прогона. */
+    group: "│",
+    /** Строка сводных метрик. */
+    metric: "⟡",
+    /** Компакция / обновление. */
+    compact: "⟳",
+};
+/** Тайпгард болтливости. */
+export function isVerbosity(value) {
+    return value === "quiet" || value === "normal" || value === "verbose";
+}
+/**
+ * Резолвит итоговую болтливость из конфига. Явный `verbosity` побеждает;
+ * иначе legacy-bool `verbose` маппится в `verbose`/`quiet`.
+ */
+export function resolveVerbosity(ui) {
+    if (ui?.verbosity)
+        return ui.verbosity;
+    return ui?.verbose ? "verbose" : "quiet";
+}
+/** Акцентная метка действия (cyan). */
+export function actionMark() {
+    return pc.cyan(glyph.action);
+}
+const CATEGORY_TOOLS = {
+    recon: new Set([
+        "read_file",
+        "list_dir",
+        "glob",
+        "grep",
+        "file_info",
+        "project_map",
+        "chunk_query",
+        "web_search",
+        "web_fetch",
+        "web_browse",
+        "search_history",
+        "recall",
+        "session_info",
+        "process_list",
+        "process_log",
+        "process_wait",
+    ]),
+    mutate: new Set([
+        "write_file",
+        "edit_file",
+        "create_dir",
+        "delete_file",
+        "move_file",
+        "attach_image",
+    ]),
+    execute: new Set([
+        "bash",
+        "process_kill",
+        "pipeline_run",
+        "browser",
+        "download_file",
+        "subagent",
+        "mcp_call",
+    ]),
+    meta: new Set([
+        "plan",
+        "plan_step",
+        "todo",
+        "verify",
+        "lsp_check",
+        "enable_tools",
+        "set_thinking",
+        "load_skill",
+        "remember",
+    ]),
+};
+/** Категория тула по имени. Неизвестные — meta. */
+export function toolCategory(tool) {
+    for (const [category, tools] of Object.entries(CATEGORY_TOOLS)) {
+        if (tools.has(tool))
+            return category;
+    }
+    return "meta";
+}
+/**
+ * Акцентный цвет категории тула. Один цвет красит И глиф действия, И
+ * локализованный ярлык — они читаются как единое целое
+ * (см. `docs/design/ui/STYLE.md`). Цвета не пересекаются с семантическими
+ * success/warning/error, чтобы цветной ярлык не читался как исход.
+ */
+export function toolAccent(tool) {
+    switch (toolCategory(tool)) {
+        case "recon":
+            return pc.cyan;
+        case "mutate":
+            return pc.magenta;
+        case "execute":
+            return pc.blue;
+        default:
+            return pc.dim;
+    }
+}
+/** Метка действия в цвете категории тула. */
+export function actionMarkFor(tool) {
+    return toolAccent(tool)(glyph.action);
+}
+/** Зелёная метка успеха. */
+export function successMark() {
+    return pc.green(glyph.success);
+}
+/** Красная метка провала — только реальные сбои, не мягкие гарды. */
+export function failureMark() {
+    return pc.red(glyph.failure);
+}
+/** Жёлтая метка предупреждения — мягкие блоки, защищённые пути, нефатальное. */
+export function warningMark() {
+    return pc.yellow(glyph.warning);
+}
+/** Dim-метка детали/хинта. */
+export function detailMark() {
+    return pc.dim(glyph.detail);
+}
+/** Человеческая длительность: `ms` до секунды, `s` выше (как в мокапе). */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}

package/dist/utils/child-run.js

@@ -0,0 +1,20 @@
+/**
+ * Общий финал ожидания child-процесса: закрывает дублированный `close`-хендлер
+ * в verifier / syntax-validator / lint-on-write (один клон на троих по fallow).
+ */
+/**
+ * Резолвит промис раннера на `code === 0`, иначе реджектит обогащённой
+ * ошибкой (сообщение + `stdout`/`stderr`/`status` полями). Поведение 1:1
+ * с инлайн-версиями: текст сообщения формирует вызывающий.
+ */
+export function settleChildClose(code, stdout, stderr, message, resolve, reject) {
+    if (code === 0) {
+        resolve({ stdout, stderr });
+        return;
+    }
+    const err = new Error(message);
+    err.stdout = stdout;
+    err.stderr = stderr;
+    err.status = code;
+    reject(err);
+}

package/dist/utils/error.js

@@ -1,4 +1,4 @@
-/** Extract a human-readable message from an unknown thrown value. */
+/** Извлекает читаемое сообщение из брошенного значения любого типа. */
 export function errMsg(e) {
     return e instanceof Error ? e.message : String(e);
 }

package/dist/utils/index.js

@@ -1,4 +1,6 @@
+// Общие утилиты без зависимостей: сон, обрезка строк, бэкофф, ошибки, child-процессы.
 export { sleep } from "./sleep";
 export { truncate } from "./truncate";
 export { backoffDelay } from "./retry";
 export { errMsg } from "./error";
+export { settleChildClose } from "./child-run";

package/dist/utils/retry.js

@@ -11,7 +11,7 @@
  */
 export function backoffDelay(attempt, baseDelay, maxDelay, jitterFactor = 0) {
     const base = maxDelay !== undefined
-        ? Math.min(baseDelay * Math.pow(2, attempt), maxDelay)
-        : baseDelay * Math.pow(2, attempt);
+        ? Math.min(baseDelay * 2 ** attempt, maxDelay)
+        : baseDelay * 2 ** attempt;
     return base + Math.random() * baseDelay * jitterFactor;
 }

package/dist/utils/truncate.js

@@ -5,5 +5,5 @@
 export function truncate(s, max) {
     if (s.length <= max)
         return s;
-    return s.slice(0, max - 3) + "...";
+    return `${s.slice(0, max - 3)}...`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "micro-models-agent",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "Micro Models Agent (MMA) — LLM agent harness for small models (Qwen3.5-9B, 32K-64K context)",
   "type": "module",
   "bin": {