micro-models-agent 2.16.1 → 2.17.2

package/dist/tools/edit-file.js

@@ -1,136 +0,0 @@
-/** Тул точечной правки: exact-match замена, скан, валидация, diff. */
-import { readFileSync, writeFileSync } from "fs";
-import { resolve } from "path";
-import { t } from "../i18n/index";
-import { isPathWritable } from "../modules/security/path-validator";
-import { scanContent } from "../modules/security/content-scanner";
-import { logFileWrite, logSecurityBlock } from "../modules/security/audit-log";
-import { getSessionSecurityConfig } from "../modules/security/session-isolation";
-import { generateDiff } 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";
-/** Заменяет точный фрагмент в существующем файле (не regex). */
-export const editFileTool = {
-    name: "edit_file",
-    icon: "✏️",
-    description: "Find and replace text in an existing file. Uses exact string match (not regex).",
-    tags: ["file", "code"],
-    parameters: {
-        type: "object",
-        properties: {
-            path: { type: "string", description: "File path" },
-            old: { type: "string", description: "Text to replace" },
-            new: { type: "string", description: "Replacement text" },
-        },
-        required: ["path", "old", "new"],
-    },
-    handler: async (ctx, args) => {
-        const path = String(args.path);
-        const resolved = safeResolvePath(ctx.baseDir, 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"),
-                    }),
-                };
-            }
-        }
-        // Сессионный security-конфиг.
-        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`, path);
-            return {
-                success: false,
-                output: `[SECURITY BLOCKED] Maximum file operations (${maxFileOps}) exceeded`,
-            };
-        }
-        // Проверка прав на путь.
-        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);
-            return {
-                success: false,
-                output: t("file.path_not_allowed", {
-                    path: `${path} — ${scopeCheck.reason}`,
-                }),
-            };
-        }
-        // Защищённые пути (.git/, .env, ключи) — всегда спросить юзера.
-        const protectedBlock = protectedPathBlock(ctx, resolved, path);
-        if (protectedBlock)
-            return protectedBlock;
-        // Строковые аргументы обязательны: String(null) дало бы "null" и молча
-        // испортило файл. Явно отклоняем не-строки с понятной ошибкой.
-        if (typeof args.old !== "string" || typeof args.new !== "string") {
-            return {
-                success: false,
-                output: t("file.edit_args_invalid", {
-                    oldType: typeof args.old,
-                    newType: typeof args.new,
-                }),
-            };
-        }
-        const oldStr = args.old;
-        const newStr = args.new;
-        let content;
-        try {
-            content = readFileSync(resolved, "utf-8");
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: t("file.read_failed", { path, error: errMsg(err) }),
-            };
-        }
-        if (!content.includes(oldStr)) {
-            return {
-                success: false,
-                output: t("file.string_not_found", { str: oldStr, path }),
-            };
-        }
-        // Замена через функцию — иначе newStr трактуется как шаблон и `$&`, `$1`
-        // молча испортят содержимое файла.
-        const updated = content.replace(oldStr, () => newStr);
-        // Скан нового контента — только при включённой безопасности.
-        if (securityConfig?.enabled && securityConfig?.contentScan?.enabled) {
-            const scanResult = scanContent(updated, path, securityConfig.contentScan);
-            if (!scanResult.allowed) {
-                logSecurityBlock(ctx.sessionId, "file_write", scanResult.reason || "Content contains dangerous patterns", path);
-                return {
-                    success: false,
-                    output: `[SECURITY BLOCKED] ${scanResult.reason}`,
-                };
-            }
-        }
-        // Превалидация синтаксиса ДО записи — иначе петля "файл записан" + syntax error.
-        const validation = await preValidateSyntax(resolved, updated, ctx.baseDir);
-        if (!validation.valid) {
-            return {
-                success: false,
-                output: t("file.syntax_error", { path, error: validation.error || "Unknown syntax error" }),
-            };
-        }
-        // Конфликты import/export — только warning.
-        const conflicts = detectImportConflicts(updated);
-        writeFileSync(resolved, updated, "utf-8");
-        const diff = generateDiff(content, updated);
-        ctx.fileOperationsCount = currentCount + 1;
-        logFileWrite(ctx.sessionId, path, true, "File edited");
-        let output = t("file.replaced_in", { path });
-        if (conflicts.length > 0) {
-            output += `\n[WARNING] Import/export conflicts: ${conflicts.join(", ")}`;
-        }
-        return { success: true, output, diff };
-    },
-};

package/dist/tools/enable-tools.js

@@ -1,59 +0,0 @@
-/** On-demand тул: включает скрытые категории тулов на сессию. */
-import { t } from "../i18n/index";
-/**
- * On-demand активация тулов. Главный цикл показывает только
- * `config.tools.defaultTags` (+ структурные `alwaysOn`); спецтулы (web,
- * browser, memory, process) скрыты из схемы ради экономии токенов. Модель
- * включает их этим тулом; хендлер дописывает теги в общий мутабельный
- * `ctx.activeToolTags`, который цикл перечитывает каждую итерацию.
- */
-export const enableToolsTool = {
-    name: "enable_tools",
-    icon: "🔌",
-    description: "Enable hidden tool categories for the current session. Only the essential tools (file/code/shell) are active by default. Call this with the tags you need and they become available from the next turn. Available tags: file, code, shell, research, browser, vision, image, memory, core. Returns the newly available tools. To run a task in a separate context instead, use subagent with tool_tags.",
-    alwaysOn: true,
-    parameters: {
-        type: "object",
-        properties: {
-            tags: {
-                type: "array",
-                items: { type: "string" },
-                description: 'Tool tags to enable (e.g. ["research"] for web_search/web_fetch, ["browser"] for the browser, ["memory"] for remember/recall, ["shell"] for process management).',
-            },
-        },
-        required: ["tags"],
-    },
-    handler: async (ctx, args) => {
-        const requested = Array.isArray(args.tags) ? args.tags.map(String).filter(Boolean) : [];
-        if (requested.length === 0) {
-            return { success: false, output: t("tools.enable_no_tags") };
-        }
-        const active = ctx.activeToolTags ?? [];
-        const added = [];
-        for (const tag of requested) {
-            if (!active.includes(tag)) {
-                active.push(tag);
-                added.push(tag);
-            }
-        }
-        if (!ctx.toolExecutor) {
-            return { success: false, output: t("tools.enable_no_executor") };
-        }
-        const nowVisible = ctx.toolExecutor.getToolDefinitions([...active]).map((t) => t.name);
-        if (added.length === 0) {
-            return {
-                success: true,
-                output: t("tools.enable_already_active", {
-                    tags: requested.join(", "),
-                }),
-            };
-        }
-        return {
-            success: true,
-            output: t("tools.enable_added", {
-                tags: added.join(", "),
-                tools: nowVisible.join(", "),
-            }),
-        };
-    },
-};

package/dist/tools/executor.js

@@ -1,304 +0,0 @@
-import { killByCallId } from "../modules/processes/runner";
-import { t } from "../i18n/index";
-import { TOOL_EXECUTION_TIMEOUT_MS, TOOL_MEMO_TTL_MS as MEMO_TTL_MS, } from "../config/timeouts";
-const MEMO_MAX_ENTRIES = 100;
-/** Стабильная сериализация: сортировка ключей, порядок аргументов на ключ не влияет. */
-function stableArgsKey(value) {
-    if (Array.isArray(value))
-        return value.map(stableArgsKey);
-    if (value && typeof value === "object") {
-        const entries = Object.keys(value)
-            .sort()
-            .map((k) => [k, stableArgsKey(value[k])]);
-        return Object.fromEntries(entries);
-    }
-    return value;
-}
-/** Исполнитель: реестр, контекст, плагины, сессионное мемо. */
-export class ToolExecutor {
-    registry;
-    ctx;
-    pluginManager;
-    /**
-     * Сессионное мемо детерминированных read-only результатов
-     * (`ToolDefinition.cacheable` + ручные записи `manualMemo`-тулов вроде bash).
-     * Ключ: `sessionId::name::stableArgs`.
-     */
-    memo = new Map();
-    constructor(registry, ctx, pluginManager) {
-        this.registry = registry;
-        this.ctx = ctx;
-        this.pluginManager = pluginManager;
-    }
-    /**
-     * Запуск тула по имени с plain-аргументами (без call id и таймаут-обвязки).
-     * Для внутреннего использования — напр. bash перенаправляет ошибочный
-     * tool-call-как-команду в настоящий тул. Идёт через те же реестр и хуки.
-     *
-     * Внимание по реентрантности: временно подменяет `this.ctx`. Безопасно для
-     * последовательных вызовов, но НЕ для конкурентных на одном инстансе —
-     * будет гонка на подмене. Сейчас все вызовы последовательны (bash-редирект,
-     * один subagent-тул); так и держать.
-     */
-    async executeByName(name, args, ctx) {
-        const prevCtx = this.ctx;
-        if (ctx)
-            this.ctx = ctx;
-        try {
-            return await this.execute({
-                id: `redirect_${Date.now()}`,
-                name,
-                arguments: args,
-            });
-        }
-        finally {
-            this.ctx = prevCtx;
-        }
-    }
-    /** Есть ли тул с таким именем (проверка перед редиректами). */
-    hasTool(name) {
-        return this.registry.has(name);
-    }
-    memoKey(name, args) {
-        return `${this.ctx.sessionId ?? ""}::${name}::${JSON.stringify(stableArgsKey(args))}`;
-    }
-    /**
-     * Чтение мемо для `manualMemo`-тулов (bash). Возвращает откреплённую копию —
-     * `toolCallId` вызывающий ставит сам.
-     */
-    memoGet(name, args) {
-        const hit = this.memo.get(this.memoKey(name, args));
-        if (!hit)
-            return undefined;
-        if (Date.now() - hit.at > MEMO_TTL_MS) {
-            this.memo.delete(this.memoKey(name, args));
-            return undefined;
-        }
-        return { ...hit.result };
-    }
-    /** Запись в мемо для `manualMemo`-тулов. Хранит откреплённую копию. */
-    memoSet(name, args, result) {
-        const key = this.memoKey(name, args);
-        if (!this.memo.has(key) && this.memo.size >= MEMO_MAX_ENTRIES) {
-            const oldest = this.memo.keys().next();
-            if (!oldest.done)
-                this.memo.delete(oldest.value);
-        }
-        this.memo.set(key, { result: { ...result }, at: Date.now() });
-    }
-    /** Сброс мемо — после всего, что могло мутировать состояние. */
-    memoInvalidate() {
-        this.memo.clear();
-    }
-    /**
-     * Имена разрешённых тулов множеством, `null` — без ограничений.
-     * `undefined` — без ограничений; `[]` — запрещено всё.
-     */
-    allowedNames() {
-        const allow = this.ctx.toolAllowlist;
-        return allow ? new Set(allow) : null;
-    }
-    /** Выполнить tool call: allowlist → плагины → хендлер → post-хуки. */
-    async execute(call, signal) {
-        const allow = this.allowedNames();
-        if (allow && !allow.has(call.name)) {
-            return {
-                success: false,
-                output: t("tool.not_allowed", { name: call.name }),
-                toolCallId: call.id,
-            };
-        }
-        const tool = this.registry.get(call.name);
-        if (!tool) {
-            return {
-                success: false,
-                output: t("tool.unknown", { name: call.name }),
-                toolCallId: call.id,
-            };
-        }
-        for (const plugin of this.pluginManager.getAllPlugins()) {
-            if (plugin.onBeforeTool) {
-                try {
-                    const proceed = await plugin.onBeforeTool(this.ctx, call);
-                    if (proceed === false || typeof proceed === "string") {
-                        const pluginName = plugin.name || plugin.constructor?.name || "unknown";
-                        const reason = typeof proceed === "string" ? proceed : undefined;
-                        return {
-                            success: false,
-                            blocked: true,
-                            output: reason
-                                ? t("tool.blocked_reason", { plugin: pluginName, reason })
-                                : t("tool.blocked", { plugin: pluginName }),
-                            toolCallId: call.id,
-                        };
-                    }
-                }
-                catch (e) {
-                    this.ctx.logger.warn(`Plugin onBeforeTool error: ${e.message}`);
-                }
-            }
-        }
-        let result;
-        // Мемоизированный повтор детерминированного чтения (cacheable): хендлер
-        // пропускается, но общий хвост (post-плагины, логирование) идёт как обычно,
-        // чтобы мемо-хит был неотличим от свежего прогона.
-        const memoHit = tool.cacheable ? this.memoGet(call.name, call.arguments) : undefined;
-        try {
-            this.ctx.activeCallId = call.id;
-            if (tool.interactive) {
-                // Интерактивные тулы ждут ввода — без таймаута.
-                result = memoHit ?? (await tool.handler(this.ctx, call.arguments));
-            }
-            else {
-                const timeoutMs = tool.timeoutMs ?? TOOL_EXECUTION_TIMEOUT_MS;
-                const failFast = (message) => {
-                    // Убить долгоживущий дочерний процесс этого вызова.
-                    killByCallId(call.id);
-                    // Тул-специфичный cleanup (напр. восстановление скоупа subagent) —
-                    // до reject, чтобы общее состояние восстановилось и при abandonment.
-                    const cleanup = this.ctx.cleanup;
-                    if (cleanup) {
-                        cleanup();
-                        // Сбрасывать, только если более новый вызов не подменил тем временем.
-                        if (this.ctx.cleanup === cleanup)
-                            this.ctx.cleanup = undefined;
-                    }
-                    return new Error(message);
-                };
-                let timer;
-                let onAbort;
-                const timeoutPromise = new Promise((_, reject) => {
-                    timer = setTimeout(() => {
-                        reject(failFast(t("tool.timeout", {
-                            name: call.name,
-                            seconds: Math.round(timeoutMs / 1000),
-                        })));
-                    }, timeoutMs);
-                });
-                const racePromises = [
-                    memoHit ? Promise.resolve(memoHit) : tool.handler(this.ctx, call.arguments),
-                    timeoutPromise,
-                ];
-                if (signal) {
-                    const abortPromise = new Promise((_, reject) => {
-                        onAbort = () => reject(failFast(t("tool.aborted", { name: call.name })));
-                        if (signal.aborted) {
-                            onAbort();
-                        }
-                        else {
-                            signal.addEventListener("abort", onAbort, { once: true });
-                        }
-                    });
-                    racePromises.push(abortPromise);
-                }
-                try {
-                    result = await Promise.race(racePromises);
-                }
-                finally {
-                    // Остановить таймер и снять abort-слушатель, чтобы они не сработали
-                    // против контекста/cleanup УЖЕ ДРУГОГО вызова.
-                    if (timer !== undefined)
-                        clearTimeout(timer);
-                    if (onAbort && signal)
-                        signal.removeEventListener("abort", onAbort);
-                    // У проигравших промисов потребителя после settled race нет (их
-                    // kill/cleanup-эффекты уже применены в failFast). Залогировать
-                    // reject и отцепить, чтобы не всплыл как unhandled rejection.
-                    for (const p of racePromises.slice(1)) {
-                        p.catch((e) => {
-                            this.ctx.logger.debug(`Tool ${call.name}: discarded race loser: ${e.message}`);
-                        });
-                    }
-                }
-            }
-            result.toolCallId = call.id;
-        }
-        catch (e) {
-            result = {
-                success: false,
-                output: `${t("error.prefix")}${e.message}`,
-                toolCallId: call.id,
-            };
-        }
-        if (!memoHit) {
-            // Успешные детерминированные чтения мемоизируются; всё остальное, что
-            // реально выполнялось, могло мутировать состояние (даже упавшая команда
-            // применяется наполовину) — мемо сбрасывается. `manualMemo` (bash) ведут
-            // свои записи сами.
-            if (tool.cacheable && result.success) {
-                this.memoSet(call.name, call.arguments, result);
-            }
-            else if (!tool.cacheable && !tool.manualMemo) {
-                this.memoInvalidate();
-            }
-        }
-        // После аборта работа тула отбрасывается (цикл агента завершается без
-        // рендера/логирования), поэтому медленные post-плагины (LSP, lint, tsc)
-        // пропускаются целиком. Аборт посреди плагина виден ему через signal
-        // в контексте хука — плагин убьёт свои дочерние процессы.
-        if (signal?.aborted) {
-            this.ctx.logger.debug(`Tool ${call.name}: abort, skipping onAfterTool plugins`);
-        }
-        else {
-            const pluginCtx = signal ? { ...this.ctx, signal } : this.ctx;
-            for (const plugin of this.pluginManager.getAllPlugins()) {
-                if (plugin.onAfterTool) {
-                    try {
-                        await plugin.onAfterTool(pluginCtx, call, result);
-                    }
-                    catch (e) {
-                        this.ctx.logger.warn(`Plugin onAfterTool error: ${e.message}`);
-                    }
-                }
-            }
-        }
-        this.ctx.logger.logToolCall(call.name, JSON.stringify(call.arguments)?.slice(0, 200) ?? "", result.success ? "OK" : `FAIL: ${result.output?.slice(0, 200)}`);
-        this.ctx.logger.logToolOutput(call.name, result.output ?? "", result.success ? 0 : 1);
-        this.ctx.logger.debug(`Tool ${call.name}: ${result.success ? "OK" : "FAIL"}`);
-        return result;
-    }
-    /** Определения тулов с учётом allowlist (для схемы LLM). */
-    getToolDefinitions(tags) {
-        const allow = this.allowedNames();
-        if (allow) {
-            return this.registry
-                .getAll()
-                .filter((t) => allow.has(t.name))
-                .map((t) => ({
-                name: t.name,
-                description: t.description,
-                parameters: t.parameters,
-                boundedOutput: t.boundedOutput,
-            }));
-        }
-        return this.registry.getAllForLLM(tags);
-    }
-    /** Доступ к реестру. */
-    getRegistry() {
-        return this.registry;
-    }
-    /** Установить скоуп shared-исполнителя. */
-    setScope(scope) {
-        this.ctx.scope = scope;
-    }
-    /** Текущий скоуп shared-исполнителя (для compare-and-restore субагентов). */
-    getScope() {
-        return this.ctx.scope;
-    }
-    /** Установить prompt-поверхность для интерактивных тулов. */
-    setPromptIO(io) {
-        this.ctx.promptIO = io;
-    }
-    /** Текущая глубина рекурсии субагентов. */
-    getRecursionDepth() {
-        return this.ctx.recursionDepth ?? 0;
-    }
-    /** Установить глубину рекурсии. */
-    setRecursionDepth(depth) {
-        this.ctx.recursionDepth = depth;
-    }
-    /** Подменить LLM-провайдер в контексте. */
-    updateProvider(provider) {
-        this.ctx.llmProvider = provider;
-    }
-}

package/dist/tools/file-info.js

@@ -1,49 +0,0 @@
-/** Тул метаданных файла/каталога (размер, даты; кешируемый). */
-import { statSync, existsSync } from "fs";
-import { t } from "../i18n/index";
-import { isPathInScope } from "../modules/security/path-validator";
-import { safeResolvePath } from "./path-utils";
-/** Возвращает JSON с размером, типом, датами создания/изменения. */
-export const fileInfoTool = {
-    name: "file_info",
-    icon: "ℹ️",
-    description: "Get metadata about a file or directory (size, creation date, modification date).",
-    tags: ["file"],
-    boundedOutput: true,
-    cacheable: true,
-    parameters: {
-        type: "object",
-        properties: {
-            path: { type: "string", description: "File 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.not_found_short", { path }) };
-        }
-        const stat = statSync(resolved);
-        return {
-            success: true,
-            output: JSON.stringify({
-                path,
-                size: stat.size,
-                isDirectory: stat.isDirectory(),
-                isFile: stat.isFile(),
-                created: stat.birthtime,
-                modified: stat.mtime,
-            }, null, 2),
-        };
-    },
-};

package/dist/tools/filter-tools.js

@@ -1,17 +0,0 @@
-/**
- * Фильтрует тулы по набору тегов, всегда оставляя `alwaysOn`. Для MoE-роутинга
- * экспертов и subagent tool_tags — структурные тулы (plan/todo/verify,
- * project_map, lsp_check, enable_tools) переживают сужение.
- */
-export function filterToolsByTags(tools, toolTags) {
-    if (!toolTags || toolTags.length === 0)
-        return tools;
-    const tagSet = new Set(toolTags);
-    return tools.filter((t) => {
-        if (t.alwaysOn)
-            return true;
-        if (!t.tags || t.tags.length === 0)
-            return false;
-        return t.tags.some((tag) => tagSet.has(tag));
-    });
-}

package/dist/tools/glob-tool.js

@@ -1,37 +0,0 @@
-/** Тул поиска файлов по glob-паттерну (кешируемый, jail в baseDir). */
-import { globSync } from "fs";
-import { t } from "../i18n/index";
-import { MAX_PREVIEW_LINES } from "./preview";
-/** Ищет файлы по glob; выдача обрезана MAX_PREVIEW_LINES. */
-export const globTool = {
-    name: "glob",
-    icon: "🔎",
-    description: `Search for files matching a glob pattern. Shows up to ${MAX_PREVIEW_LINES} results by default. Uses standard glob syntax (e.g., **/*.ts, src/**/*.test.ts).`,
-    tags: ["file", "code", "research"],
-    cacheable: true,
-    parameters: {
-        type: "object",
-        properties: {
-            pattern: { type: "string", description: "Glob pattern" },
-        },
-        required: ["pattern"],
-    },
-    handler: async (ctx, args) => {
-        const pattern = String(args.pattern);
-        // Абсолютные паттерны (/etc/*) и ".." выводят за baseDir — запретить.
-        if (/^([a-zA-Z]:)?[\\/]/.test(pattern) || pattern.split(/[\\/]/).includes("..")) {
-            return {
-                success: false,
-                output: t("file.path_not_allowed", { path: pattern }),
-            };
-        }
-        const results = globSync(pattern, { cwd: ctx.baseDir });
-        if (results.length === 0) {
-            return { success: true, output: t("file.no_matches") };
-        }
-        const truncated = results.length > MAX_PREVIEW_LINES
-            ? `\n... (${results.length - MAX_PREVIEW_LINES} more files)`
-            : "";
-        return { success: true, output: results.slice(0, MAX_PREVIEW_LINES).join("\n") + truncated };
-    },
-};