micro-models-agent 2.16.1 → 2.17.1

package/dist/tools/grep-tool.js

@@ -1,142 +0,0 @@
-/** Тул поиска по содержимому (rg с fallback на grep -r). */
-import { spawn, } from "child_process";
-import { resolve } from "path";
-import { t } from "../i18n/index";
-import { logBashCommand, logSecurityBlock } from "../modules/security/audit-log";
-import { isPathInScope } from "../modules/security/path-validator";
-import { DEFAULT_SECURITY_CONFIG } from "../config/security";
-import { MAX_PREVIEW_LINES } from "./preview";
-/** Обрезает вывод до MAX_PREVIEW_LINES строк. */
-function truncateLines(output) {
-    const lines = output.split("\n");
-    if (lines.length <= MAX_PREVIEW_LINES)
-        return output;
-    return (lines.slice(0, MAX_PREVIEW_LINES).join("\n") +
-        `\n... (${lines.length - MAX_PREVIEW_LINES} more lines)`);
-}
-/**
- * Поисковая команда асинхронно, с kill по таймауту. Exit code 1 (нет совпадений)
- * резолвится в пустую строку. Возврат: stdout поиска.
- */
-export function runSearch(bin, args, cwd, timeoutMs = 30000) {
-    return new Promise((resolvePromise, reject) => {
-        const child = spawn(bin, args, { cwd, windowsHide: true });
-        let out = "";
-        let err = "";
-        let timedOut = false;
-        const timer = setTimeout(() => {
-            timedOut = true;
-            child.kill();
-        }, timeoutMs);
-        child.stdout?.on("data", (d) => {
-            out += d;
-        });
-        child.stderr?.on("data", (d) => {
-            err += d;
-        });
-        child.on("error", (e) => {
-            clearTimeout(timer);
-            reject(e);
-        });
-        child.on("close", (code) => {
-            clearTimeout(timer);
-            if (timedOut) {
-                reject(new Error(`search timed out after ${timeoutMs}ms`));
-            }
-            else if (code === 1) {
-                resolvePromise("");
-            }
-            else if (code === 0) {
-                resolvePromise(out);
-            }
-            else {
-                reject(new Error(err || `exit ${code}`));
-            }
-        });
-    });
-}
-/** Ищет по содержимому через regex (rg, иначе grep -r); кешируемый. */
-export const grepTool = {
-    name: "grep",
-    icon: "🔍",
-    description: `Search file contents using a regular expression. Shows up to ${MAX_PREVIEW_LINES} matching lines by default. Uses ripgrep (rg) if available, otherwise falls back to grep -r.`,
-    tags: ["file", "code", "research"],
-    cacheable: true,
-    parameters: {
-        type: "object",
-        properties: {
-            pattern: { type: "string", description: "Regex pattern to search" },
-            include: {
-                type: "string",
-                description: "File pattern to filter (e.g. *.ts)",
-            },
-            path: {
-                type: "string",
-                description: "Directory to search (defaults to baseDir)",
-            },
-        },
-        required: ["pattern"],
-    },
-    handler: async (ctx, args) => {
-        const pattern = String(args.pattern);
-        const searchPath = args.path ? resolve(ctx.baseDir, String(args.path)) : ctx.baseDir;
-        // Каталог поиска обязан оставаться внутри baseDir/скоупа: `path: "../../.."`
-        // не должен читать вне песочницы.
-        const scopeCheck = isPathInScope(ctx.baseDir, searchPath, ctx.scope, ctx.config?.security?.paths || DEFAULT_SECURITY_CONFIG.paths);
-        if (!scopeCheck.allowed) {
-            logSecurityBlock(ctx.sessionId || undefined, "file_read", scopeCheck.reason || "grep path not allowed", String(args.path ?? ctx.baseDir));
-            return {
-                success: false,
-                output: t("file.path_not_allowed", {
-                    path: `${args.path ?? "."} — ${scopeCheck.reason}`,
-                }),
-            };
-        }
-        // Аргументы rg массивом, чтобы шелл не трактовал метасимволы regex
-        // (|, (, )) как операторы — это паттерны, не команды шелла.
-        const rgArgs = ["-n", "--with-filename", pattern, searchPath];
-        if (args.include) {
-            rgArgs.push("-g", String(args.include));
-        }
-        logBashCommand(ctx.sessionId, `rg ${rgArgs.join(" ")}`, false, "grep-tool");
-        try {
-            const output = await runSearch("rg", rgArgs, ctx.baseDir);
-            return {
-                success: true,
-                output: truncateLines(output || t("file.no_matches")),
-            };
-        }
-        catch (e) {
-            if (e.code === "ENOENT") {
-                // fall through to grep fallback
-            }
-            else if (/timed out/.test(e.message)) {
-                return { success: false, output: t("error.grep_failed", { message: e.message }) };
-            }
-            else if (e.status === 1) {
-                return { success: true, output: t("file.no_matches") };
-            }
-            // Fallback на plain grep -r, когда rg нет или упал. Массив аргументов —
-            // защита от shell injection.
-            try {
-                const grepArgs = ["-rn", pattern, searchPath];
-                if (args.include) {
-                    grepArgs.push("--include", String(args.include));
-                }
-                const output = await runSearch("grep", grepArgs, ctx.baseDir);
-                return {
-                    success: true,
-                    output: truncateLines(output || t("file.no_matches")),
-                };
-            }
-            catch (e2) {
-                if (e2.status === 1)
-                    return { success: true, output: t("file.no_matches") };
-                return {
-                    success: false,
-                    output: t("error.grep_failed", { message: e2.message }),
-                };
-            }
-        }
-    },
-};

package/dist/tools/hidden-tools-block.js

@@ -1,37 +0,0 @@
-/** Блок системного промпта о скрытых tag-фильтром тулах. */
-import { t } from "../i18n/index";
-/**
- * Компактный блок системного промпта со скрытыми тулами. Модель должна знать
- * об их существовании (и пути доступа), хотя их нет в tool-схеме LLM.
- * Группировка по тегам, размер ограничен.
- */
-export function buildHiddenToolsBlock(allTools, activeTags) {
-    if (!allTools.length)
-        return "";
-    const activeSet = new Set(activeTags);
-    const visible = new Set();
-    for (const tool of allTools) {
-        if (tool.alwaysOn || (tool.tags?.some((tag) => activeSet.has(tag)))) {
-            visible.add(tool.name);
-        }
-    }
-    const hidden = allTools.filter((tool) => !visible.has(tool.name));
-    if (hidden.length === 0)
-        return "";
-    // Группировка по тегам, внутри тега — по имени тула.
-    const byTag = new Map();
-    for (const tool of hidden) {
-        const tags = tool.tags && tool.tags.length > 0 ? tool.tags : ["other"];
-        for (const tag of tags) {
-            if (!byTag.has(tag))
-                byTag.set(tag, []);
-            byTag.get(tag).push(tool);
-        }
-    }
-    const lines = [t("tools.hidden_header")];
-    for (const [tag, tools] of [...byTag.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
-        const names = [...new Set(tools.map((tool) => tool.name))].sort().join(", ");
-        lines.push(`- [${tag}] ${names}`);
-    }
-    return lines.join("\n");
-}

package/dist/tools/index.js

@@ -1,88 +0,0 @@
-/** Точка сборки каталога тулов: импорты, реэкспорты, регистрация. */
-import { ToolRegistry } from "./registry";
-import { ToolExecutor } from "./executor";
-import { readFileTool } from "./read-file";
-import { writeFileTool } from "./write-file";
-import { editFileTool } from "./edit-file";
-import { globTool } from "./glob-tool";
-import { grepTool } from "./grep-tool";
-import { listDirTool } from "./list-dir";
-import { createDirTool } from "./create-dir";
-import { deleteFileTool } from "./delete-file";
-import { moveFileTool } from "./move-file";
-import { fileInfoTool } from "./file-info";
-import { bashTool } from "./bash";
-import { processListTool } from "./process-list";
-import { processLogTool } from "./process-log";
-import { processKillTool } from "./process-kill";
-import { processWaitTool } from "./process-wait";
-import { subagentTool } from "./subagent";
-import { chunkQueryTool } from "./chunk-query";
-import { webSearchTool } from "./web-search";
-import { webFetchTool } from "./web-fetch";
-import { webBrowseTool } from "./web-browse";
-import { downloadFileTool } from "./download-file";
-// question/approve — основной набор: question покрывает выбор + свободный
-// текст (с pre-check памяти), approve — явное Yes/No (reject даёт success:false,
-// и цикл трактует это как сигнал сбоя, а не текст ответа).
-import { questionTool } from "./question";
-import { approveTool } from "./approve";
-import { createLoadSkillTool } from "./load-skill";
-import { pipelineRunTool } from "./pipeline-run";
-import { mcpCallTool } from "./mcp-call";
-import { searchHistoryTool } from "./search-history";
-import { rememberTool } from "./remember";
-import { recallTool } from "./recall";
-import { meetDoneTool } from "./meet-done";
-import { createBrowserTool } from "./browser";
-import { attachImageTool } from "./attach-image";
-import { enableToolsTool } from "./enable-tools";
-import { sessionInfoTool } from "./session-info";
-export { ToolRegistry, ToolExecutor };
-export { filterToolsByTags } from "./filter-tools";
-export { readFileTool, writeFileTool, editFileTool, globTool, grepTool, listDirTool, createDirTool, deleteFileTool, moveFileTool, fileInfoTool, bashTool, subagentTool, chunkQueryTool, processListTool, processLogTool, processKillTool, processWaitTool, webSearchTool, webFetchTool, webBrowseTool, downloadFileTool, createLoadSkillTool, pipelineRunTool, mcpCallTool, searchHistoryTool, rememberTool, recallTool, meetDoneTool, createBrowserTool, attachImageTool, enableToolsTool, sessionInfoTool, questionTool, approveTool, };
-/** Регистрирует все тулы; опционально — on-demand тул и скиллы. */
-export function registerAllTools(registry, skillsModule, opts) {
-    const tools = [
-        readFileTool,
-        writeFileTool,
-        editFileTool,
-        globTool,
-        grepTool,
-        listDirTool,
-        createDirTool,
-        deleteFileTool,
-        moveFileTool,
-        fileInfoTool,
-        bashTool,
-        subagentTool,
-        chunkQueryTool,
-        processListTool,
-        processLogTool,
-        processKillTool,
-        processWaitTool,
-        webSearchTool,
-        webFetchTool,
-        webBrowseTool,
-        downloadFileTool,
-        pipelineRunTool,
-        mcpCallTool,
-        searchHistoryTool,
-        attachImageTool,
-        sessionInfoTool,
-        meetDoneTool,
-        questionTool,
-        approveTool,
-    ];
-    // On-demand активация — дефолт. При явном enableOnDemand:false тул не
-    // регистрируется вовсе — с пустым defaultTags это legacy-режим «все тулы».
-    if (opts?.enableOnDemand !== false) {
-        tools.push(enableToolsTool);
-    }
-    if (skillsModule) {
-        tools.push(createLoadSkillTool(skillsModule));
-    }
-    for (const tool of tools) {
-        registry.register(tool);
-    }
-}

package/dist/tools/list-dir.js

@@ -1,53 +0,0 @@
-/** Тул листинга каталога (игнор мусора, cap вывода, кешируемый). */
-import { readdirSync, statSync, existsSync } from "fs";
-import { resolve } from "path";
-import { t } from "../i18n/index";
-import { isPathInScope } from "../modules/security/path-validator";
-import { safeResolvePath } from "./path-utils";
-import { MAX_PREVIEW_LINES } from "./preview";
-/** Каталоги вне выдачи list_dir (едино с walker'ом индексёра). */
-const IGNORED_DIRS = new Set(["node_modules", ".git", "dist", "build", "coverage", ".mma"]);
-/** Показывает файлы/подкаталоги (каталоги с `/`); мусор скрыт. */
-export const listDirTool = {
-    name: "list_dir",
-    icon: "📂",
-    description: `List files and directories in a given path. Shows up to ${MAX_PREVIEW_LINES} entries by default.`,
-    tags: ["file"],
-    boundedOutput: true,
-    cacheable: true,
-    parameters: {
-        type: "object",
-        properties: {
-            path: { type: "string", description: "Directory path" },
-        },
-        required: ["path"],
-    },
-    handler: async (ctx, args) => {
-        const path = String(args.path);
-        const resolved = safeResolvePath(ctx.baseDir, path);
-        const scopeCheck = isPathInScope(ctx.baseDir, resolved, ctx.scope, ctx.config.security?.paths);
-        if (!scopeCheck.allowed) {
-            return {
-                success: false,
-                output: t("file.path_not_allowed", {
-                    path: `${path} — ${scopeCheck.reason}`,
-                }),
-            };
-        }
-        if (!existsSync(resolved)) {
-            return { success: false, output: t("file.dir_notfound", { path }) };
-        }
-        const entries = readdirSync(resolved).filter((e) => !IGNORED_DIRS.has(e));
-        const lines = entries.map((e) => {
-            const full = resolve(resolved, e);
-            return statSync(full).isDirectory() ? `${e}/` : e;
-        });
-        if (lines.length === 0) {
-            return { success: true, output: t("file.empty") };
-        }
-        const truncated = lines.length > MAX_PREVIEW_LINES
-            ? `\n... (${lines.length - MAX_PREVIEW_LINES} more entries)`
-            : "";
-        return { success: true, output: lines.slice(0, MAX_PREVIEW_LINES).join("\n") + truncated };
-    },
-};

package/dist/tools/load-skill.js

@@ -1,51 +0,0 @@
-/** Фабрика тула загрузки скилла (инжект в системный промпт). */
-import { t } from "../i18n/index";
-import { estimateTokens } from "../llm/token-counter";
-/**
- * Фабрика тула load_skill. Контент скилла инжектится в системный промпт
- * (не в историю) — переживает компакцию. Возврат: определение тула.
- */
-export function createLoadSkillTool(skillsModule) {
-    return {
-        name: "load_skill",
-        icon: "🎯",
-        tags: ["core"],
-        // Роутинг скиллов — вне сужения (P5): модель использует только видимый скилл.
-        alwaysOn: true,
-        description: "Load a skill by name. Skills provide specialized instructions and workflows. When loaded, the skill content is injected into the system prompt (not conversation history) so it persists through context compaction. Only use when the task clearly requires domain-specific knowledge.",
-        parameters: {
-            type: "object",
-            properties: {
-                name: {
-                    type: "string",
-                    description: "Exact skill name to load (see [Available Skills] for names)",
-                },
-            },
-            required: ["name"],
-        },
-        handler: async (_ctx, args) => {
-            const name = args.name ? String(args.name) : undefined;
-            if (!name) {
-                return { success: false, output: t("tool.invalid_params") };
-            }
-            const result = skillsModule.loadByName(name);
-            if (!result.success) {
-                const available = skillsModule.getAvailable();
-                const hint = available.length > 0
-                    ? `\n\n${t("tool.skill_available_hint")}: ${available.map((s) => s.name).join(", ")}`
-                    : "";
-                return { success: false, output: result.message + hint };
-            }
-            const budget = skillsModule.getBudget();
-            const tokens = result.skill ? estimateTokens(result.skill.content) : 0;
-            return {
-                success: true,
-                output: t("tool.skill_budget", {
-                    name,
-                    tokens,
-                    remaining: budget.remaining,
-                }),
-            };
-        },
-    };
-}

package/dist/tools/mcp-call.js

@@ -1,80 +0,0 @@
-/** Тул вызова тула на MCP-сервере (ленивая регистрация из конфига). */
-import { t } from "../i18n/index";
-import { MCPClient } from "../modules/mcp/client";
-import { MCPRegistry } from "../modules/mcp/registry";
-const registry = new MCPRegistry();
-let initialized = false;
-/** Ленивая регистрация MCP-серверов из конфига (один раз на процесс). */
-function ensureInitialized(ctx) {
-    if (initialized)
-        return;
-    initialized = true;
-    const servers = ctx.config.mcpServers || {};
-    for (const [name, cfg] of Object.entries(servers)) {
-        if (cfg.enabled !== false) {
-            registry.register({
-                name: cfg.name || name,
-                command: cfg.command,
-                args: cfg.args,
-                env: cfg.env,
-                transport: cfg.transport,
-                url: cfg.url,
-                headers: cfg.headers,
-                timeout: cfg.timeout,
-            });
-        }
-    }
-}
-/** Вызывает тул на MCP-сервере. Параметры: server, tool, args. */
-export const mcpCallTool = {
-    name: "mcp_call",
-    icon: "🔗",
-    description: "Call a tool on an MCP (Model Context Protocol) server. MCP servers provide external capabilities like databases, APIs, or specialized tools.",
-    tags: ["research"],
-    parameters: {
-        type: "object",
-        properties: {
-            server: { type: "string", description: "MCP server name" },
-            tool: { type: "string", description: "Tool name on the server" },
-            args: { type: "object", description: "Arguments to pass to the tool" },
-        },
-        required: ["server", "tool"],
-    },
-    handler: async (ctx, args) => {
-        const serverName = String(args.server || "");
-        const toolName = String(args.tool || "");
-        const toolArgs = (args.args || {});
-        if (!serverName || !toolName) {
-            return { success: false, output: "Server and tool names are required" };
-        }
-        ensureInitialized(ctx);
-        const serverConfig = registry.get(serverName);
-        if (!serverConfig) {
-            const available = registry.list();
-            return {
-                success: false,
-                output: t("tool.mcp_server_not_found", {
-                    server: serverName,
-                    available: available.join(", ") || "(none)",
-                }),
-            };
-        }
-        const client = new MCPClient(serverConfig);
-        try {
-            await client.connect();
-            const result = await client.callTool(toolName, toolArgs);
-            return {
-                success: true,
-                output: `MCP call result:\n${JSON.stringify(result, null, 2)}`,
-            };
-        }
-        catch (e) {
-            return { success: false, output: t("tool.mcp_call_failed", { error: e.message }) };
-        }
-        finally {
-            // Клиент закрывать всегда: раньше ошибка/таймаут в callTool пропускала
-            // disconnect и сиротила stdio-дочерний процесс на сессию.
-            await client.disconnect().catch(() => { });
-        }
-    },
-};

package/dist/tools/meet-done.js

@@ -1,14 +0,0 @@
-/** Сентинел завершения meet-интервью: ставит флаг, REPL выходит из режима. */
-import { t } from "../i18n/index";
-/** Модель зовёт по финальному саммари; вне онбординга — no-op по флагу. */
-export const meetDoneTool = {
-    name: "meet_done",
-    description: "Signal that the get-acquainted interview is complete. Call only after the final summary.",
-    tags: ["memory"],
-    parameters: { type: "object", properties: {} },
-    handler: async (ctx) => {
-        if (ctx.onboarding)
-            ctx.onboarding.done = true;
-        return { success: true, output: t("tool.meet_done") };
-    },
-};

package/dist/tools/move-file.js

@@ -1,94 +0,0 @@
-/** Тул перемещения/переименования файла или каталога. */
-import { renameSync, existsSync, mkdirSync } from "fs";
-import { resolve, normalize, dirname } from "path";
-import { t } from "../i18n/index";
-import { isPathWritable } from "../modules/security/path-validator";
-import { logFileWrite, logSecurityBlock } from "../modules/security/audit-log";
-import { getSessionSecurityConfig } from "../modules/security/session-isolation";
-import { generateMoveDiff } from "../ui/diff";
-import { safeResolvePath } from "./path-utils";
-import { protectedPathBlock } from "../modules/security/protected-paths";
-/** Перемещает/переименовывает; обе стороны проверяются по скоупу. */
-export const moveFileTool = {
-    name: "move_file",
-    icon: "📦",
-    description: "Move or rename a file or directory.",
-    tags: ["file"],
-    parameters: {
-        type: "object",
-        properties: {
-            from: { type: "string", description: "Source path" },
-            to: { type: "string", description: "Destination path" },
-        },
-        required: ["from", "to"],
-    },
-    handler: async (ctx, args) => {
-        const fromPath = String(args.from);
-        const toPath = String(args.to);
-        const baseDir = resolve(ctx.baseDir);
-        const fromResolved = safeResolvePath(baseDir, normalize(fromPath));
-        const toResolved = safeResolvePath(baseDir, normalize(toPath));
-        const securityConfig = ctx.sessionContext
-            ? getSessionSecurityConfig(ctx.config, ctx.sessionContext)
-            : ctx.config.security;
-        // Лимит файловых операций.
-        const maxFileOps = securityConfig?.maxFileOperations ?? 100;
-        const currentCount = ctx.fileOperationsCount ?? 0;
-        if (currentCount >= maxFileOps) {
-            logSecurityBlock(ctx.sessionId, "file_write", `Maximum file operations (${maxFileOps}) exceeded`, `${fromPath} -> ${toPath}`);
-            return {
-                success: false,
-                output: `[SECURITY BLOCKED] Maximum file operations (${maxFileOps}) exceeded`,
-            };
-        }
-        // Права источника — по РЕЗОЛВЛЕННОМУ пути (по нему же работает renameSync),
-        // никогда по сырому аргументу.
-        const fromCheck = isPathWritable(ctx.baseDir, fromResolved, ctx.scope, ctx.config.security?.paths);
-        if (!fromCheck.allowed) {
-            logSecurityBlock(ctx.sessionId, "file_write", fromCheck.reason || "Source path not allowed", fromPath);
-            return {
-                success: false,
-                output: t("file.path_not_allowed", {
-                    path: `${fromPath} — ${fromCheck.reason}`,
-                }),
-            };
-        }
-        // Права приёмника — тоже по резолвленному.
-        const toCheck = isPathWritable(ctx.baseDir, toResolved, ctx.scope, ctx.config.security?.paths);
-        if (!toCheck.allowed) {
-            logSecurityBlock(ctx.sessionId, "file_write", toCheck.reason || "Destination path not allowed", toPath);
-            return {
-                success: false,
-                output: t("file.path_not_allowed", {
-                    path: `${toPath} — ${toCheck.reason}`,
-                }),
-            };
-        }
-        // Защищённые пути с любой стороны (.git/, .env, ключи) — спросить юзера.
-        const fromProtected = protectedPathBlock(ctx, fromResolved, fromPath);
-        if (fromProtected)
-            return fromProtected;
-        const toProtected = protectedPathBlock(ctx, toResolved, toPath);
-        if (toProtected)
-            return toProtected;
-        if (!existsSync(fromResolved)) {
-            return {
-                success: false,
-                output: t("file.not_found_short", { path: fromPath }),
-            };
-        }
-        const toDir = dirname(toResolved);
-        if (!existsSync(toDir)) {
-            mkdirSync(toDir, { recursive: true });
-        }
-        renameSync(fromResolved, toResolved);
-        const diff = generateMoveDiff(fromPath, toPath);
-        ctx.fileOperationsCount = currentCount + 1;
-        logFileWrite(ctx.sessionId, `${fromPath} -> ${toPath}`, true, "File moved");
-        return {
-            success: true,
-            output: t("file.moved", { from: fromPath, to: toPath }),
-            diff,
-        };
-    },
-};

package/dist/tools/path-utils.js

@@ -1,108 +0,0 @@
-/** Утилиты путей: нормализация, jail-проверки, резолв от baseDir. */
-import { resolve, normalize, dirname, basename, sep, relative, isAbsolute } from "path";
-import { existsSync } from "fs";
-/**
- * Бэкслэши → прямые слэши для показа и сравнения.
- * На POSIX no-op; на Windows `src\foo\bar.ts` → `src/foo/bar.ts`.
- */
-export function toForwardSlash(p) {
-    return p.replace(/\\/g, "/");
-}
-/**
- * True, если targetPath равен dirPath или внутри него.
- *
- * Кроссплатформенно:
- * - через path.relative(), а не raw startsWith: сосед с общим префиксом
- *   ("src" vs "src-other") не пройдёт;
- * - на Windows ФС регистронезависима: обе стороны lowercased до сравнения.
- */
-export function isInsideDir(targetPath, dirPath) {
-    const norm = (p) => (process.platform === "win32" ? p.toLowerCase() : p);
-    const t = norm(resolve(targetPath));
-    const d = norm(resolve(dirPath));
-    if (t === d)
-        return true;
-    const rel = relative(d, t);
-    // Побег наверх — только реальный `..`/`../…`. Файл буквально `..foo`
-    // даёт rel === "..foo" и легально внутри.
-    return rel.length > 0 && !isAbsolute(rel) && rel !== ".." && !rel.startsWith(`..${sep}`);
-}
-/**
- * True, если targetPath — сам scope-entry или внутри него. Проверка
- * сепараторов и регистра — как в isInsideDir.
- */
-export function matchesScopeEntry(targetResolved, entryResolved) {
-    if (targetResolved === entryResolved)
-        return true;
-    return isInsideDir(targetResolved, entryResolved);
-}
-/**
- * Резолв пользовательского пути от baseDir.
- *
- * Чинит типовые ошибки модели:
- * 1. Ведущий слэш: "/testing/cat3" → относительно baseDir.
- * 2. Пропущенный сепаратор: "E:\agent_test" при baseDir "E:\agent\_test"
- *    → вставка недостающего бэкслэша.
- *
- * Для новых файлов обязан существовать родитель — проверяется он, а не
- * полный путь, иначе write_file не сработает.
- */
-export function safeResolvePath(baseDir, userPath) {
-    // Существующий абсолютный путь — как есть.
-    const asIs = resolve(normalize(userPath));
-    if (userPath.startsWith("/") || userPath.startsWith("\\")) {
-        if (existsSync(asIs) || existsSync(dirname(asIs)))
-            return asIs;
-    }
-    const norm = normalize(userPath);
-    // Абсолютные пути — дословно, БЕЗ сдирания ведущего слэша и перерезолва
-    // от baseDir (иначе /var/folders/... станет baseDir/var/folders/... на POSIX).
-    // Эвристика ведущего слэша ниже — только fallback, когда путь не на диске.
-    if (isAbsolute(norm)) {
-        if (existsSync(norm) || existsSync(dirname(norm)))
-            return norm;
-        // Абсолютный, но ещё не на диске (новый файл без существующих dirs).
-        // Восстановление ошибки модели: ведущий слэш мог значить "от baseDir".
-        const stripped = norm.replace(/^[/\\]/, "");
-        const relativeCandidate = resolve(baseDir, stripped);
-        if (existsSync(relativeCandidate) || existsSync(dirname(relativeCandidate))) {
-            return relativeCandidate;
-        }
-        return norm;
-    }
-    const stripped = norm.replace(/^[/\\]/, "");
-    const resolved = resolve(baseDir, stripped);
-    // Быстрый путь: существует сам (или родитель для новых файлов).
-    if (existsSync(resolved) || existsSync(dirname(resolved)))
-        return resolved;
-    const baseNorm = normalize(baseDir);
-    // Подъём по предкам в поиске пропущенных сепараторов.
-    let cur = baseNorm;
-    while (cur && cur !== dirname(cur)) {
-        const name = basename(cur);
-        if (!name) {
-            cur = dirname(cur);
-            continue;
-        }
-        let idx = stripped.toLowerCase().indexOf(name.toLowerCase());
-        while (idx >= 0) {
-            const afterIdx = idx + name.length;
-            const afterChar = stripped[afterIdx];
-            if (afterChar && afterChar !== "\\" && afterChar !== "/") {
-                const fixed = stripped.slice(0, afterIdx) + sep + stripped.slice(afterIdx);
-                const fixedResolved = resolve(baseDir, normalize(fixed));
-                if (existsSync(fixedResolved) || existsSync(dirname(fixedResolved))) {
-                    return fixedResolved;
-                }
-                // Проба от родителя предка.
-                const fromParent = resolve(dirname(cur), normalize(fixed));
-                if (existsSync(fromParent) || existsSync(dirname(fromParent))) {
-                    return fromParent;
-                }
-            }
-            idx = stripped.toLowerCase().indexOf(name.toLowerCase(), idx + 1);
-        }
-        cur = dirname(cur);
-    }
-    return resolved;
-}