micro-models-agent 2.16.1 → 2.17.2

package/dist/tools/syntax-validator.js

@@ -1,379 +0,0 @@
-/** Превалидация синтаксиса перед записью (TS/JS/JSON/XML), без шелла. */
-import { writeFileSync, existsSync, unlinkSync } from "fs";
-import { extname, dirname } from "path";
-import { spawn } from "child_process";
-import { Logger } from "../logger/app-logger";
-import { settleChildClose } from "../utils/child-run";
-const SYNTAX_CACHE = new Map();
-const logger = new Logger("warn", "syntax-validator");
-/** Хэш контента для кэша проверок. */
-function contentHash(content) {
-    let h = 5381;
-    for (let i = 0; i < content.length; i++) {
-        h = ((h << 5) + h + content.charCodeAt(i)) | 0;
-    }
-    return String(h);
-}
-/**
- * Прогон компилятора с таймаутом. Успех — stdout/stderr, провал — throw.
- * Спавн БЕЗ шелла: путь файла от модели, интерполяция шелла выполнила бы
- * `$()`/бэктики/`%VAR%` в имени.
- */
-function runCommand(file, args, cwd, timeoutMs) {
-    return new Promise((resolve, reject) => {
-        const child = spawn(file, args, {
-            cwd,
-            shell: false,
-            windowsHide: true,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        const stdoutChunks = [];
-        const stderrChunks = [];
-        child.stdout?.on("data", (d) => stdoutChunks.push(d));
-        child.stderr?.on("data", (d) => stderrChunks.push(d));
-        const timer = setTimeout(() => {
-            child.kill();
-            reject(new Error(`Syntax check timed out after ${timeoutMs}ms`));
-        }, timeoutMs);
-        child.on("error", (err) => {
-            clearTimeout(timer);
-            reject(err);
-        });
-        child.on("close", (code) => {
-            clearTimeout(timer);
-            const stdout = Buffer.concat(stdoutChunks).toString("utf-8");
-            const stderr = Buffer.concat(stderrChunks).toString("utf-8");
-            settleChildClose(code, stdout, stderr, `Syntax check failed with exit code ${code}`, resolve, reject);
-        });
-    });
-}
-/** Расширения с валидацией синтаксиса. */
-const TS_EXTENSIONS = new Set([".ts", ".tsx", ".cts", ".mts"]);
-const JS_EXTENSIONS = new Set([".js", ".jsx", ".cjs", ".mjs"]);
-const JSON_EXTENSIONS = new Set([".json", ".jsonc"]);
-/** XML-семейство: только well-formedness, без внешних зависимостей. */
-const XML_EXTENSIONS = new Set([".xml", ".drawio", ".svg", ".xaml", ".plist", ".iml"]);
-const XML_SPANS = [
-    { open: "<!--", close: "-->", kind: "comment" },
-    { open: "<![CDATA[", close: "]]>", kind: "cdata" },
-    { open: "<?", close: "?>", kind: "pi" },
-];
-/** Спан коммента/CDATA/PI: конец (за закрывателем) или -1, если открыт. */
-function skipXmlSpan(content, i) {
-    for (const s of XML_SPANS) {
-        if (!content.startsWith(s.open, i))
-            continue;
-        const end = content.indexOf(s.close, i + s.open.length);
-        return end === -1 ? { end: -1, kind: s.kind } : { end: end + s.close.length, kind: s.kind };
-    }
-    return null;
-}
-/**
- * Индекс за первым `>` вне кавычек, или -1. С trackBrackets (для `<!...>`
- * с `[...]`-секциями) `>` внутри скобок тоже пропускается.
- */
-function findClosingGt(content, from, trackBrackets) {
-    let j = from;
-    let quote = null;
-    let depth = 0;
-    while (j < content.length) {
-        const d = content[j];
-        quote = nextQuoteState(quote, d);
-        if (quote) {
-            j++;
-            continue;
-        }
-        if (trackBrackets && d === "[")
-            depth++;
-        else if (trackBrackets && d === "]")
-            depth--;
-        else if (d === ">" && depth <= 0)
-            return j + 1;
-        j++;
-    }
-    return -1;
-}
-/** Кавычко-состояние на один символ: вход, выход или удержание спана. */
-function nextQuoteState(quote, d) {
-    if (quote)
-        return d === quote ? null : quote;
-    return d === '"' || d === "'" ? d : null;
-}
-/** Сырой текст обычного `<...>`-тега плюс конечный индекс, или null. */
-function readXmlTag(content, i) {
-    const end = findClosingGt(content, i + 1, false);
-    if (end === -1)
-        return null;
-    return { raw: content.slice(i + 1, end - 1).trim(), end };
-}
-/** Число переводов строк. */
-function countLines(s) {
-    return s.split("\n").length - 1;
-}
-/** Шаг через один `<...>`-элемент. Ошибка (без суффикса строки) или null. */
-function scanXmlMarkup(st) {
-    const { content } = st;
-    const span = skipXmlSpan(content, st.i);
-    if (span) {
-        if (span.end === -1)
-            return `Unclosed XML ${span.kind}`;
-        st.line += countLines(content.slice(st.i, span.end));
-        st.i = span.end;
-        return null;
-    }
-    if (content.startsWith("<!", st.i)) {
-        const end = findClosingGt(content, st.i + 2, true);
-        if (end === -1)
-            return "Unclosed declaration";
-        st.line += countLines(content.slice(st.i, end));
-        st.i = end;
-        return null;
-    }
-    const tag = readXmlTag(content, st.i);
-    if (!tag)
-        return "Unclosed tag";
-    st.line += countLines(content.slice(st.i, tag.end));
-    st.i = tag.end;
-    return matchXmlTag(st.stack, tag.raw, st.line);
-}
-/** Сверка закрывающего тега со стеком. Ошибка или null. */
-function matchXmlCloseTag(stack, raw) {
-    const name = raw.slice(1).split(/[\s/>]/, 1)[0];
-    if (!name)
-        return "Empty closing tag";
-    const open = stack.pop();
-    if (!open)
-        return `Stray closing tag </${name}> with no open element`;
-    if (open.name !== name) {
-        return `Mismatched tag: expected </${open.name}> (opened line ${open.line}), got </${name}>`;
-    }
-    return null;
-}
-/** Сверка открывающего/самозакрытого тега со стеком. Ошибка или null. */
-function matchXmlOpenTag(stack, raw, tagLine) {
-    const selfClosed = /\/\s*$/.test(raw);
-    const name = raw.split(/[\s/>]/, 1)[0];
-    if (!name || name.startsWith("/") || name === "?") {
-        return `Malformed tag <${raw.slice(0, 32)}>`;
-    }
-    if (!selfClosed)
-        stack.push({ name, line: tagLine });
-    return null;
-}
-/**
- * Сверка одного тега (open/self-close/close) со стеком. Стек мутирует, больше
- * ничего. Ошибка (без суффикса строки) или null.
- */
-function matchXmlTag(stack, raw, tagLine) {
-    if (!raw)
-        return "Empty tag <>";
-    if (raw.startsWith("/"))
-        return matchXmlCloseTag(stack, raw);
-    return matchXmlOpenTag(stack, raw, tagLine);
-}
-/** Проверяет XML well-formedness. Первая ошибка с номером строки или null. */
-export function checkXmlWellFormed(content) {
-    const st = { content, i: 0, line: 1, stack: [] };
-    const err = (msg) => `${msg} (line ${st.line})`;
-    while (st.i < content.length) {
-        if (content[st.i] === "\n") {
-            st.line++;
-            st.i++;
-            continue;
-        }
-        if (content[st.i] !== "<") {
-            st.i++;
-            continue;
-        }
-        const problem = scanXmlMarkup(st);
-        if (problem)
-            return err(problem);
-    }
-    if (st.stack.length > 0) {
-        const open = st.stack[st.stack.length - 1];
-        return err(`Unclosed tag <${open.name}> (opened line ${open.line})`);
-    }
-    return null;
-}
-/**
- * Best-effort JSONC-нормалайзер: сносит `//` и `/* ... *\/`-комменты и висячие
- * запятые, чтобы валидный комментированный `tsconfig.json` не отклонялся
- * pre-write гейтом как syntax error (гейт заставлял малые модели сносить
- * нужные комменты).
- */
-function stripJsonComments(input) {
-    let out = "";
-    let inString = false;
-    let inLine = false;
-    let inBlock = false;
-    for (let i = 0; i < input.length; i++) {
-        const c = input[i];
-        const n = input[i + 1];
-        if (inLine) {
-            if (c === "\n") {
-                inLine = false;
-                out += c;
-            }
-            continue;
-        }
-        if (inBlock) {
-            if (c === "*" && n === "/") {
-                inBlock = false;
-                i++;
-            }
-            continue;
-        }
-        if (inString) {
-            out += c;
-            if (c === "\\") {
-                out += n ?? "";
-                i++;
-            }
-            else if (c === '"') {
-                inString = false;
-            }
-            continue;
-        }
-        if (c === '"') {
-            inString = true;
-            out += c;
-            continue;
-        }
-        if (c === "/" && n === "/") {
-            inLine = true;
-            i++;
-            continue;
-        }
-        if (c === "/" && n === "*") {
-            inBlock = true;
-            i++;
-            continue;
-        }
-        out += c;
-    }
-    return out.replace(/,\s*([}\]])/g, "$1");
-}
-/**
- * Превалидация синтаксиса ДО записи на диск.
- * `{ valid: true }` — синтаксис ок или язык не поддерживается;
- * `{ valid: false, error }` — синтаксис бит.
- *
- * TypeScript/JavaScript: временный файл + прогон компилятора.
- * JSON: прямой парсинг.
- */
-export async function preValidateSyntax(filePath, content, _baseDir) {
-    const ext = extname(filePath).toLowerCase();
-    // JSON / JSONC — прямой парсинг, комменты и висячие запятые терпим.
-    if (JSON_EXTENSIONS.has(ext))
-        return validateJsonContent(content);
-    // XML-семейство — чистая well-formedness (компилятор не спавним).
-    if (XML_EXTENSIONS.has(ext))
-        return validateXmlContent(content);
-    // TypeScript — синтаксис через bun build.
-    if (TS_EXTENSIONS.has(ext)) {
-        return validateWithCompiler(filePath, ext, content, "bun", (tmpFile) => ["build", "--no-bundle", "--target=bun", tmpFile], "TypeScript syntax error", true);
-    }
-    // JavaScript — синтаксис через node --check.
-    if (JS_EXTENSIONS.has(ext)) {
-        return validateWithCompiler(filePath, ext, content, "node", (tmpFile) => ["--check", tmpFile], "JavaScript syntax error", false);
-    }
-    // Неподдерживаемое расширение — без валидации.
-    return { valid: true };
-}
-/**
- * Проверка компилятором через временный файл (без шелла — путь от модели).
- * Общая для TypeScript (`bun build`) и JavaScript (`node --check`); результаты
- * кэшируются по хэшу контента.
- */
-async function validateWithCompiler(filePath, ext, content, command, args, fallbackError, useStdout) {
-    const hash = contentHash(content);
-    const cached = SYNTAX_CACHE.get(filePath);
-    if (cached && cached.hash === hash) {
-        return cached.error ? { valid: false, error: cached.error } : { valid: true };
-    }
-    const tmpFile = `${filePath}.tmp${ext}`;
-    try {
-        writeFileSync(tmpFile, content, "utf-8");
-        await runCommand(command, args(tmpFile), dirname(filePath), 5000);
-        SYNTAX_CACHE.set(filePath, { hash, error: null });
-        return { valid: true };
-    }
-    catch (err) {
-        const stderr = err.stderr || (useStdout ? err.stdout || "" : "");
-        const firstError = stderr.split("\n").find((line) => line.trim()) || fallbackError;
-        const error = firstError.trim();
-        SYNTAX_CACHE.set(filePath, { hash, error });
-        return { valid: false, error };
-    }
-    finally {
-        removeTempFile(tmpFile);
-    }
-}
-/** Best-effort чистка временного файла: проверка уже вернулась, падения только
- * логируются ради диагностики, а не глотаются молча. */
-function removeTempFile(tmpFile) {
-    try {
-        if (existsSync(tmpFile))
-            unlinkSync(tmpFile);
-    }
-    catch (cleanupErr) {
-        logger.warn(`failed to remove syntax-check temp file ${tmpFile}`, {
-            error: String(cleanupErr),
-        });
-    }
-}
-/** JSON / JSONC — прямой парсинг, комменты и висячие запятые терпим. */
-function validateJsonContent(content) {
-    try {
-        JSON.parse(content);
-        return { valid: true };
-    }
-    catch (e) {
-        try {
-            JSON.parse(stripJsonComments(content));
-            return { valid: true };
-        }
-        catch {
-            return { valid: false, error: e.message };
-        }
-    }
-}
-/** XML-семейство — чистая well-formedness (компилятор не спавним). */
-function validateXmlContent(content) {
-    const error = checkXmlWellFormed(content);
-    return error ? { valid: false, error } : { valid: true };
-}
-/**
- * Детект конфликтов import/export в TS/JS. Возвращает конфликтующие имена.
- */
-export function detectImportConflicts(content) {
-    const conflicts = [];
-    // Все именованные импорты: import { foo, bar as baz } from '...'.
-    const importRegex = /import\s+(?:type\s+)?\{([^}]+)\}\s+from/g;
-    const exportRegex = /export\s+(?:function|class|const|let|var|type|interface|async\s+function)\s+(\w+)/g;
-    const imports = new Set();
-    const exports = new Set();
-    let match;
-    while ((match = importRegex.exec(content))) {
-        const names = match[1]
-            .split(",")
-            .map((s) => s.trim())
-            .map((s) => {
-            // "foo as bar" — берём локальное имя (foo).
-            const asMatch = s.match(/^(\w+)\s+as\s+\w+$/);
-            return asMatch ? asMatch[1] : s;
-        })
-            .filter((s) => /^\w+$/.test(s));
-        names.forEach((n) => imports.add(n));
-    }
-    while ((match = exportRegex.exec(content))) {
-        exports.add(match[1]);
-    }
-    // Сверка конфликтов.
-    for (const name of imports) {
-        if (exports.has(name)) {
-            conflicts.push(name);
-        }
-    }
-    return conflicts;
-}

package/dist/tools/types.js

@@ -1 +0,0 @@
-export {};

package/dist/tools/user-input.js

@@ -1,134 +0,0 @@
-/** Низкоуровневый ввод юзера: меню/парсинг выбора по STYLE.md, readline-фолбэк. */
-import * as readline from "readline";
-import { t } from "../i18n/index";
-import { getDefaultChannel } from "../output/index";
-/** Индекс выбора "свой ответ" из askChoice. */
-export const CUSTOM_INDEX = -1;
-/**
- * Парсит ввод вида "1" или "1,3" в 0-based индексы. Невалидное (пусто,
- * нецифры, вне диапазона, дубли, несколько при multiple=false) — null.
- */
-export function parseSelection(input, optionCount, multiple) {
-    const trimmed = input.trim();
-    if (!trimmed)
-        return null;
-    const parts = trimmed.split(",").map((p) => p.trim());
-    if (!multiple && parts.length > 1)
-        return null;
-    const indexes = [];
-    for (const part of parts) {
-        if (!/^\d+$/.test(part))
-            return null;
-        const idx = Number(part) - 1;
-        if (idx < 0 || idx >= optionCount)
-            return null;
-        if (indexes.includes(idx))
-            return null;
-        indexes.push(idx);
-    }
-    return indexes.length ? indexes : null;
-}
-/** Рендерит `? <вопрос>` + опции с отступом по STYLE.md. */
-export function formatMenu(question, options, opts = {}) {
-    const parts = question.split("\n");
-    parts[parts.length - 1] = `? ${parts[parts.length - 1]}`;
-    const lines = [...parts];
-    options.forEach((opt, i) => {
-        lines.push(`  [${i + 1}] ${opt.label} — ${opt.description}`);
-    });
-    if (opts.allowCustom) {
-        lines.push(`  [${options.length + 1}] ${t("tool.user_input.custom_option")}`);
-    }
-    return lines.join("\n");
-}
-/** Маркер промпта выбора `>`, по STYLE.md. */
-export function choicePrompt(optionCount, multiple) {
-    return multiple
-        ? t("tool.user_input.choice_multiple")
-        : t("tool.user_input.choice_single", { max: optionCount });
-}
-/** Создаёт readline-интерфейс на stdio. */
-function createRl() {
-    return readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-}
-/** Одна строка промпта через readline. */
-function promptLine(rl, prompt) {
-    return new Promise((resolve) => {
-        rl.question(prompt, (answer) => resolve(answer));
-    });
-}
-/** Free-text вопрос. Возвращает триммированный ответ (может быть пуст). */
-export async function askText(question) {
-    const rl = createRl();
-    try {
-        const answer = await promptLine(rl, `${question} `);
-        return answer.trim();
-    }
-    finally {
-        rl.close();
-    }
-}
-/**
- * Вопрос с выбором: нумерованное меню, ожидание валидного ввода.
- * Возвращает 0-based индексы; CUSTOM_INDEX — кастомный пункт.
- * Переспрашивает до валидного.
- */
-export async function askChoice(question, options, opts = {}) {
-    const multiple = opts.multiple ?? false;
-    const entryCount = options.length + (opts.allowCustom ? 1 : 0);
-    const customEntry = options.length; // index of the custom entry, if enabled
-    const rl = createRl();
-    try {
-        const channel = getDefaultChannel();
-        channel.writeLine(formatMenu(question, options, opts));
-        for (;;) {
-            const answer = await promptLine(rl, choicePrompt(entryCount, multiple));
-            const parsed = parseSelection(answer, entryCount, multiple);
-            if (parsed) {
-                return parsed.map((i) => (opts.allowCustom && i === customEntry ? CUSTOM_INDEX : i));
-            }
-            channel.writeLine(t("tool.user_input.invalid"));
-        }
-    }
-    finally {
-        rl.close();
-    }
-}
-/**
- * Высокоуровневый хелпер тула question.
- * - Без опций: free-text, `[text]` или `[]` при пустом.
- * - С опциями: выбранные labels; кастомный пункт — введённый текст.
- *
- * При `io` (REPL) весь промптинг идёт через него (терминал взаймы у редактора
- * ввода). Без него (headless/non-REPL) — module-level readline-фолбэк выше.
- */
-export async function askUser(question, opts = {}, io) {
-    const header = [opts.progress, opts.header].filter(Boolean).join(" — ");
-    if (!opts.options || opts.options.length === 0) {
-        const text = header ? `${header}\n? ${question}` : `? ${question}`;
-        const answer = io ? await io.askText(text) : await askText(text);
-        return answer ? [answer] : [];
-    }
-    const text = header ? `${header}\n${question}` : question;
-    const allowCustom = opts.custom ?? true;
-    const indexes = io
-        ? await io.askChoice(text, opts.options, { multiple: opts.multiple, allowCustom })
-        : await askChoice(text, opts.options, { multiple: opts.multiple, allowCustom });
-    const labels = [];
-    for (const idx of indexes) {
-        if (idx === CUSTOM_INDEX) {
-            const custom = io
-                ? await io.askText(t("tool.user_input.custom_prompt"))
-                : await askText(t("tool.user_input.custom_prompt"));
-            if (custom)
-                labels.push(custom);
-        }
-        else {
-            labels.push(opts.options[idx].label);
-        }
-    }
-    return labels;
-}

package/dist/tools/web-browse.js

@@ -1,93 +0,0 @@
-/** Тул чтения веб-страницы в plain text (без JS; SSRF-защита, cap вывода). */
-import { t } from "../i18n/index";
-import { BlockedRedirectError, fetchValidated, isUrlAllowed, sanitizeUrl, } from "../modules/security/network-validator";
-import { logNetworkRequest, logSecurityBlock } from "../modules/security/audit-log";
-import { getSessionSecurityConfig } from "../modules/security/session-isolation";
-import { MAX_PREVIEW_LINES } from "./preview";
-/** Потолок символов до построчной обрезки. */
-const MAX_CHARS = 3000;
-/** Читает страницу в plain text; JS-приложения вернут пустоту — для них browser. */
-export const webBrowseTool = {
-    name: "web_browse",
-    icon: "🌐",
-    description: `Fetch and read a web page. Returns the page content as plain text (max ${MAX_PREVIEW_LINES} lines / ${MAX_CHARS} chars). This is a plain HTTP request — it does NOT execute JavaScript, so JS-rendered single-page apps (weather sites, dashboards, modern SPAs) return empty or near-empty content. For such pages use the "browser" tool instead.`,
-    tags: ["research"],
-    parameters: {
-        type: "object",
-        properties: {
-            url: { type: "string", description: "URL to fetch" },
-        },
-        required: ["url"],
-    },
-    handler: async (ctx, args) => {
-        const url = String(args.url || "");
-        const securityConfig = ctx.sessionContext
-            ? getSessionSecurityConfig(ctx.config, ctx.sessionContext).network
-            : ctx.config.security?.network;
-        const validation = isUrlAllowed(url, securityConfig);
-        if (!validation.allowed) {
-            logSecurityBlock(ctx.sessionId, "network_request", validation.reason || "URL blocked by security policy", sanitizeUrl(url));
-            return {
-                success: false,
-                output: `[SECURITY BLOCKED] URL is not allowed: ${validation.reason}`,
-            };
-        }
-        try {
-            const { response } = await fetchValidated(url, securityConfig, {
-                signal: AbortSignal.timeout(securityConfig?.requestTimeout || 15000),
-            });
-            const text = await response.text();
-            const stripped = text
-                .replace(/<script[\s\S]*?<\/script>/gi, "")
-                .replace(/<style[\s\S]*?<\/style>/gi, "")
-                .replace(/<[^>]+>/g, "")
-                .replace(/&[^;]+;/g, " ")
-                .replace(/\s+/g, " ")
-                .trim();
-            logNetworkRequest(ctx.sessionId, sanitizeUrl(url), true, `Status: ${response.status}`);
-            const fullChars = stripped.length;
-            const fullLines = stripped.split("\n").length;
-            const maxChars = securityConfig?.maxResponseSize || MAX_CHARS;
-            let content;
-            if (stripped.length > maxChars) {
-                content = stripped.slice(0, maxChars) + t("file.truncated");
-            }
-            else {
-                content = stripped;
-            }
-            const contentLines = content.split("\n");
-            if (contentLines.length > MAX_PREVIEW_LINES) {
-                content =
-                    contentLines.slice(0, MAX_PREVIEW_LINES).join("\n") +
-                        `\n... (${contentLines.length - MAX_PREVIEW_LINES} more lines)`;
-            }
-            const truncated = stripped.length > maxChars || fullLines > MAX_PREVIEW_LINES
-                ? t("file.truncated").trim()
-                : "";
-            return {
-                success: true,
-                output: content || t("file.empty_page"),
-                display: t("tool.web_browse_result", {
-                    url: sanitizeUrl(url),
-                    chars: String(fullChars),
-                    lines: String(fullLines),
-                    truncated,
-                }),
-            };
-        }
-        catch (err) {
-            if (err instanceof BlockedRedirectError) {
-                logSecurityBlock(ctx.sessionId, "network_request", err.reason, sanitizeUrl(url));
-                return { success: false, output: `[SECURITY BLOCKED] redirect: ${err.reason}` };
-            }
-            logNetworkRequest(ctx.sessionId, sanitizeUrl(url), false, `Error: ${err.message}`);
-            return {
-                success: false,
-                output: t("error.fetch_url_failed", {
-                    url: sanitizeUrl(url),
-                    message: err.message,
-                }),
-            };
-        }
-    },
-};