micro-models-agent 2.10.0 → 2.12.0

package/dist/tools/web-search.js

@@ -1,13 +1,13 @@
+/** Веб-поиск (DuckDuckGo HTML): тул и shared-функция для автопоиска ошибок. */
 import { t } from "../i18n/index";
 import { isUrlAllowed, sanitizeUrl } from "../modules/security/network-validator";
 import { logNetworkRequest, logSecurityBlock } from "../modules/security/audit-log";
 import { getSessionSecurityConfig } from "../modules/security/session-isolation";
 /**
- * Shared web search (DuckDuckGo HTML) used by BOTH the web_search tool and
- * the automatic error search (execution module). `networkConfig` is the
- * resolved security network config (may be undefined when security is off);
- * `requestTimeoutMs` overrides the timeout when the caller has its own
- * setting (the error search uses errorWebSearch.requestTimeoutMs).
+ * Общий веб-поиск (DuckDuckGo HTML) для тула web_search и автопоиска ошибок
+ * (execution-модуль). `networkConfig` — резолвленная сетевая security-конфигурация
+ * (undefined при выключенной безопасности); `requestTimeoutMs` переопределяет
+ * таймаут, когда у вызывающего свой (автопоиск — errorWebSearch.requestTimeoutMs).
  */
 export async function performWebSearch(query, numResults, networkConfig, requestTimeoutMs) {
     const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
@@ -41,11 +41,13 @@ export async function performWebSearch(query, numResults, networkConfig, request
         return { success: false, results: [], error: err.message };
     }
 }
+/** Форматирует выдачу нумерованным списком. */
 function formatResults(results) {
     return results
         .map((r, i) => `${i + 1}. ${r.title}\n   URL: ${r.url}\n   ${r.snippet}`)
         .join("\n");
 }
+/** Ищет в вебе (заголовки + сниппеты); поисковики открывать не надо. */
 export const webSearchTool = {
     name: "web_search",
     icon: "🌍",

package/dist/tools/write-file.js

@@ -1,5 +1,6 @@
+/** Тул записи файла: скоуп, security-скан, валидация синтаксиса, diff. */
 import { writeFileSync, mkdirSync, existsSync, readFileSync } from "fs";
-import { dirname } from "path";
+import { resolve, dirname } from "path";
 import { t } from "../i18n/index";
 import { isPathWritable } from "../modules/security/path-validator";
 import { scanContent } from "../modules/security/content-scanner";
@@ -8,6 +9,9 @@ import { getSessionSecurityConfig } from "../modules/security/session-isolation"
 import { generateDiff, generateNewFileDiff } from "../ui/diff";
 import { safeResolvePath } from "./path-utils";
 import { preValidateSyntax, detectImportConflicts } from "./syntax-validator";
+import { errMsg } from "../utils";
+import { protectedPathBlock } from "../modules/security/protected-paths";
+/** Создаёт/перезаписывает файл; parent-dirs, проверки, diff в ответе. */
 export const writeFileTool = {
     name: "write_file",
     icon: "📝",
@@ -24,7 +28,19 @@ export const writeFileTool = {
     handler: async (ctx, args) => {
         const path = String(args.path);
         const resolved = safeResolvePath(ctx.baseDir, path);
-        // Check path permissions using the resolved path
+        if (ctx.writePathAllowlist) {
+            const ok = ctx.writePathAllowlist.some((p) => resolve(p).toLowerCase() === resolve(resolved).toLowerCase());
+            if (!ok) {
+                return {
+                    success: false,
+                    output: t("file.path_not_allowed", {
+                        path: `${path} — ${t("onboarding.write_restricted")}`,
+                        reason: t("onboarding.write_restricted"),
+                    }),
+                };
+            }
+        }
+        // Проверка прав по резолвленному пути.
         const scopeCheck = isPathWritable(ctx.baseDir, resolved, ctx.scope, ctx.config.security?.paths);
         if (!scopeCheck.allowed) {
             logSecurityBlock(ctx.sessionId, "file_write", scopeCheck.reason || "Path not allowed", path);
@@ -35,11 +51,15 @@ export const writeFileTool = {
                 }),
             };
         }
-        // Get session-specific security config
+        // Always-on fallback (security выкл): защищённые пути — спросить юзера.
+        const protectedBlock = protectedPathBlock(ctx, resolved, path);
+        if (protectedBlock)
+            return protectedBlock;
+        // Сессионный security-конфиг.
         const securityConfig = ctx.sessionContext
             ? getSessionSecurityConfig(ctx.config, ctx.sessionContext)
             : ctx.config.security;
-        // Check file operations limit
+        // Лимит файловых операций.
         const maxFileOps = securityConfig?.maxFileOperations ?? 100;
         const currentCount = ctx.fileOperationsCount ?? 0;
         if (currentCount >= maxFileOps) {
@@ -49,9 +69,9 @@ export const writeFileTool = {
                 output: `[SECURITY BLOCKED] Maximum file operations (${maxFileOps}) exceeded`,
             };
         }
-        // Check content for dangerous patterns — only when security is enabled.
-        // contentScan has its own `enabled` flag, but it must NOT fire while the
-        // global security switch is off (false positives on ordinary CLI code).
+        // Скан контента на опасные паттерны — только при включённой безопасности.
+        // У contentScan свой флаг `enabled`, но при выключенном глобальном свитче
+        // он молчит (ложные срабатывания на обычном CLI-коде).
         const content = String(args.content);
         if (securityConfig?.enabled && securityConfig?.contentScan?.enabled) {
             const scanResult = scanContent(content, path, securityConfig.contentScan);
@@ -67,7 +87,7 @@ export const writeFileTool = {
         if (!existsSync(dir)) {
             mkdirSync(dir, { recursive: true });
         }
-        // Pre-validate syntax BEFORE writing — prevents "file written" + syntax error loop
+        // Превалидация синтаксиса ДО записи — иначе петля "файл записан" + syntax error.
         const validation = await preValidateSyntax(resolved, content, ctx.baseDir);
         if (!validation.valid) {
             return {
@@ -75,20 +95,30 @@ export const writeFileTool = {
                 output: t("file.syntax_error", { path, error: validation.error || "Unknown syntax error" }),
             };
         }
-        // Detect import/export conflicts — warning only (code may be valid)
+        // Конфликты import/export — только warning (код может быть валиден).
         const conflicts = detectImportConflicts(content);
         const fileExists = existsSync(resolved);
         let oldContent = "";
-        if (fileExists) {
-            oldContent = readFileSync(resolved, "utf-8");
+        try {
+            if (fileExists) {
+                oldContent = readFileSync(resolved, "utf-8");
+            }
+            writeFileSync(resolved, content, "utf-8");
+        }
+        catch (err) {
+            // Ошибка ФС (ENOSPC/EPERM/…) должна вернуть путь и причину, а не
+            // вылететь голым Node-исключением в цикл агента.
+            return {
+                success: false,
+                output: t("file.write_failed", { path, error: errMsg(err) }),
+            };
         }
-        writeFileSync(resolved, content, "utf-8");
         const diff = fileExists ? generateDiff(oldContent, content) : generateNewFileDiff(content);
-        // Increment file operations counter
+        // Счётчик файловых операций.
         ctx.fileOperationsCount = currentCount + 1;
-        // Log successful file write
+        // Успешная запись в аудит-лог.
         logFileWrite(ctx.sessionId, path, true, `File ${fileExists ? "updated" : "created"}`);
-        // Add conflict warning to output if any
+        // Предупреждение о конфликтах — в вывод.
         let output = t("file.written", { path });
         if (conflicts.length > 0) {
             output += `\n[WARNING] Import/export conflicts: ${conflicts.join(", ")}`;

package/dist/ui/action-log.js

@@ -0,0 +1,13 @@
+let last = null;
+/** Запоминает последнее действие. */
+export function recordLastAction(action) {
+    last = action;
+}
+/** Отдаёт последнее действие (null — не было). */
+export function getLastAction() {
+    return last;
+}
+/** Сбрасывает запомненное действие. */
+export function clearLastAction() {
+    last = null;
+}

package/dist/ui/box.js

@@ -1,7 +1,8 @@
+// Рамки только для мастера первого запуска (в чате запрещены, см. STYLE.md).
 import stringWidth from "string-width";
 import { pc } from "./colors";
 import { getTerminalWidth } from "./table";
-/** Wrap a string to `width` columns, keeping ANSI codes intact. */
+/** Переносит строку по колонкам, сохраняя ANSI-коды. */
 export function wrapText(text, width) {
     if (width < 1)
         return text ? [text] : [];
@@ -45,7 +46,7 @@ function padTo(text, width) {
     const gap = Math.max(0, width - stringWidth(text));
     return text + " ".repeat(gap);
 }
-/** Render a box with an optional title embedded in the top border. */
+/** Рендерит рамку с опц. заголовком в верхней границе. */
 export function box(lines, opts = {}) {
     const pad = opts.padding ?? 1;
     const width = Math.max(20, Math.min(opts.width ?? getTerminalWidth(), 120));
@@ -70,7 +71,7 @@ export function box(lines, opts = {}) {
     out.push(pc.dim(`└${"─".repeat(width - 2)}┘`));
     return out;
 }
-/** A horizontal rule that respects the terminal width (max 60 cols). */
+/** Горизонтальная линейка по ширине терминала (макс. 60 кол.). */
 export function divider(width) {
     const w = Math.min(width ?? getTerminalWidth(), 60);
     return pc.dim("─".repeat(w));

package/dist/ui/colors.js

@@ -1,4 +1,6 @@
+// Цвета терминала (picocolors): вкл только в TTY и без CI/NO_COLOR.
 import { createColors } from "picocolors";
 const isTty = () => process.stdout.isTTY === true;
 const enabled = isTty() && !process.env.CI && !process.env.NO_COLOR;
+/** Палитра picocolors (no-op вне TTY / при CI / NO_COLOR). */
 export const pc = createColors(enabled);

package/dist/ui/diff.js

@@ -1,9 +1,9 @@
+// Диффы правок файлов для чата: LCS с капами, цветные строки ±.
 import { pc } from "./colors";
 const CONTEXT_LINES = 3;
 const MAX_DIFF_LINES = 100;
-// LCS is O(m*n) in time and memory — cap the DP input so a huge edit_file
-// can't allocate hundreds of MB. Beyond the cap, diff degrades to a
-// "changed N lines" summary instead of a full LCS.
+// LCS — O(m*n) по времени и памяти: режем вход DP, чтобы огромный edit_file не
+// отъел сотни МБ. За капом дифф деградирует до сводки "изменено N строк".
 const MAX_LCS_INPUT_LINES = 2000;
 function computeLCS(oldLines, newLines) {
     const m = oldLines.length;
@@ -126,6 +126,7 @@ function formatLine(line, maxNumWidth) {
         return `  ${numStr}   ${line.content}`;
     }
 }
+/** Строка диффа старого/нового содержимого. */
 export function generateDiff(oldContent, newContent) {
     if (oldContent === newContent)
         return "";
@@ -133,8 +134,7 @@ export function generateDiff(oldContent, newContent) {
     const newLines = newContent.split("\n");
     if (oldLines.length > MAX_LCS_INPUT_LINES ||
         newLines.length > MAX_LCS_INPUT_LINES) {
-        // Too large for the O(m*n) DP — show a bounded summary instead of
-        // allocating an m*n matrix.
+        // Слишком велик для O(m*n) DP — ограниченная сводка вместо матрицы m*n.
         return pc.dim(`  ... (file too large for line diff: ${oldLines.length} -> ${newLines.length} lines)`);
     }
     const diff = buildDiff(oldLines, newLines);
@@ -153,6 +153,7 @@ export function generateDiff(oldContent, newContent) {
     }
     return lines.join("\n");
 }
+/** Дифф нового файла: все строки как добавленные. */
 export function generateNewFileDiff(content) {
     const lines = content.split("\n");
     const maxNumWidth = Math.max(String(lines.length).length, 3);

package/dist/ui/index.js

@@ -1,3 +1,4 @@
+// Фасад UI: форматтеры, вывод, таблицы, спиннер, рендерер.
 export { formatMarkdown, formatError, formatSuccess, formatWarning, FormattingStream, } from "./md-formatter";
 export { writeOutput, writeError, writeSuccess, writeWarning } from "./output";
 export { formatTable, splitRow, isSeparatorRow, getTerminalWidth } from "./table";