micro-models-agent 2.16.1 → 2.17.1

package/dist/modules/lsp/client.js

@@ -1,406 +0,0 @@
-// LSP-клиент: spawn сервера, JSON-RPC поверх stdio, диагностики, tree-kill при shutdown.
-import { spawn, execSync } from "child_process";
-import { resolve } from "path";
-import { platform } from "os";
-import { resolveSpawnCommand, buildWinCommandLine } from "./command";
-import { killTree } from "../processes/registry";
-import { toForwardSlash } from "../../tools/path-utils";
-import { errMsg } from "../../utils";
-import { LSP_DEFAULT_TIMEOUT_MS as DEFAULT_TIMEOUT } from "../../config/timeouts";
-/**
- * Логгер-адаптер: LSP-диагностику только в app.jsonl, никогда в консоль/терминал.
- * LSP-предупреждения шумные (таймаут на первом запуске, установка npx) и должны
- * диагностироваться из файлов сессии, не мусор в чате пользователя.
- */
-export class FileOnlyLogger {
-    logger;
-    constructor(logger) {
-        this.logger = logger;
-    }
-    debug(msg, meta) {
-        this.logger.logSilent("debug", msg, meta);
-    }
-    info(msg, meta) {
-        this.logger.logSilent("info", msg, meta);
-    }
-    warn(msg, meta) {
-        this.logger.logSilent("warn", msg, meta);
-    }
-    error(msg, meta) {
-        this.logger.logSilent("error", msg, meta);
-    }
-}
-/** LSP-клиент: checkFile/probe поверх spawn + initialize + shutdown. */
-export class LspClient {
-    logger = null;
-    /** Назначить логгер (null — молчать). */
-    setLogger(logger) {
-        this.logger = logger;
-    }
-    process = null;
-    requestId = 0;
-    pending = new Map();
-    buffer = Buffer.alloc(0);
-    contentLength = -1;
-    diagnostics = [];
-    diagnosticsResolve = null;
-    diagnosticsTimer = null;
-    initialized = false;
-    /** Проверить файл: открыть в сервере, дождаться publishDiagnostics, вернуть их. */
-    async checkFile(filePath, baseDir, config, projectRoot = baseDir) {
-        const timeout = config.timeout ?? DEFAULT_TIMEOUT;
-        try {
-            await this.initialize(config, projectRoot, timeout);
-            this.sendNotification("initialized", {});
-            const uri = this.pathToUri(resolve(filePath));
-            const fs = await import("fs");
-            const content = fs.readFileSync(filePath, "utf-8");
-            const diagPromise = new Promise((resolve) => {
-                this.diagnosticsResolve = resolve;
-                this.diagnostics = [];
-                this.diagnosticsTimer = setTimeout(() => {
-                    this.diagnosticsResolve?.([]);
-                    this.diagnosticsResolve = null;
-                }, timeout);
-            });
-            this.sendNotification("textDocument/didOpen", {
-                textDocument: {
-                    uri,
-                    languageId: this.languageFromPath(filePath),
-                    version: 1,
-                    text: content,
-                },
-            });
-            return await diagPromise;
-        }
-        catch (e) {
-            // Пробросить наружу, чтобы LspModule показал падение, а не спрятал.
-            throw e instanceof Error ? e : new Error(String(e));
-        }
-        finally {
-            await this.shutdown();
-        }
-    }
-    /**
-     * Лёгкая проба «сервер реально стартует»: spawn + initialize + shutdown.
-     * Для баннера REPL — мёртвый сервер (упавшая npx-автоустановка, неверное имя
-     * пакета, нет бинарника) виден заранее, а не таймаутом первого write_file.
-     */
-    async probe(config, projectRoot, timeout) {
-        try {
-            await this.initialize(config, projectRoot, timeout);
-        }
-        finally {
-            await this.shutdown();
-        }
-    }
-    async initialize(config, projectRoot, timeout) {
-        await this.startServer(config, projectRoot);
-        const rootUri = this.pathToUri(projectRoot);
-        const initParams = {
-            processId: process.pid,
-            rootUri,
-            workspaceFolders: [{ uri: rootUri, name: "workspace" }],
-            capabilities: { textDocument: { publishDiagnostics: {} } },
-        };
-        try {
-            await this.sendRequest("initialize", initParams, timeout);
-        }
-        catch (e) {
-            const msg = errMsg(e);
-            this.logger?.warn(`LSP initialize failed (attempt 1): ${msg}`, {
-                command: config.command,
-                projectRoot,
-            });
-            // npx-автоустановка может вылететь за таймаут initialize на первом запуске — один ретрай.
-            if (!(e instanceof Error) || !e.message.includes("initialize"))
-                throw e;
-            await this.shutdown();
-            await this.startServer(config, projectRoot);
-            try {
-                await this.sendRequest("initialize", initParams, timeout);
-            }
-            catch (retryErr) {
-                const retryMsg = errMsg(retryErr);
-                this.logger?.error(`LSP initialize failed (attempt 2, giving up): ${retryMsg}`, {
-                    command: config.command,
-                    projectRoot,
-                });
-                throw retryErr;
-            }
-        }
-        this.initialized = true;
-    }
-    async startServer(config, projectRoot) {
-        if (config.autoInstall === false) {
-            try {
-                execSync(`where ${config.command}`, { stdio: "pipe", timeout: 3000 });
-            }
-            catch {
-                throw new Error(`${config.command} not found in PATH`);
-            }
-        }
-        // Команда npx — сначала ищем реальный бинарник глобально.
-        // npx качает пакеты на каждый вызов (на Windows медленно, ~8-15с),
-        // даже если бинарник уже стоит глобально.
-        let effectiveCommand = config.command;
-        let effectiveArgs = config.args ?? [];
-        if (config.command === "npx" && effectiveArgs.length > 0) {
-            const binaryName = this.extractBinaryFromNpxArgs(effectiveArgs);
-            if (binaryName) {
-                const whichCmd = platform() === "win32" ? `where ${binaryName}` : `which ${binaryName}`;
-                try {
-                    execSync(whichCmd, { stdio: "pipe", timeout: 3000 });
-                    // Бинарник есть глобально — напрямую, без npx.
-                    effectiveCommand = binaryName;
-                    effectiveArgs = effectiveArgs.filter((a) => a !== "--yes" && a !== "--package" && a !== binaryName && !this.isPackageVersion(a));
-                    this.logger?.debug(`LSP: using globally installed ${binaryName} (skipped npx)`);
-                }
-                catch {
-                    // Глобально нет — фолбэк на npx (самоустановится).
-                    this.logger?.debug(`LSP: ${binaryName} not found globally, falling back to npx`);
-                }
-            }
-        }
-        return new Promise((resolve, reject) => {
-            const args = effectiveArgs;
-            const isWin = platform() === "win32";
-            let spawnCommand = resolveSpawnCommand(effectiveCommand);
-            let spawnArgs = args;
-            const spawnOpts = {
-                stdio: ["pipe", "pipe", "pipe"],
-                env: { ...process.env, ...config.env },
-                cwd: projectRoot,
-                // POSIX: потомок — лидер группы, чтобы `kill(-pid)` killTree() доставал
-                // всю цепочку (npx → node → tsserver). Без этого групповой kill падает
-                // с ESRCH, а внуки выживают сиротами. Windows — taskkill /T.
-                detached: !isWin,
-            };
-            if (isWin) {
-                // `.cmd`-шим напрямую под Node не спавнится (`spawn npx EINVAL`) — через cmd.exe.
-                spawnCommand = buildWinCommandLine(spawnCommand, args);
-                spawnArgs = [];
-                spawnOpts.shell = true;
-            }
-            const proc = spawn(spawnCommand, spawnArgs, spawnOpts);
-            proc.on("error", reject);
-            proc.stdout.on("data", (chunk) => {
-                this.handleData(chunk);
-            });
-            proc.stderr.on("data", () => { });
-            proc.once("spawn", () => {
-                resolve();
-            });
-            this.process = proc;
-            setTimeout(() => {
-                if (!this.initialized && this.process) {
-                    const msg = "LSP server start timeout";
-                    this.logger?.error(msg, { command: config.command, projectRoot, timeout: config.timeout ?? DEFAULT_TIMEOUT });
-                    reject(new Error(msg));
-                }
-            }, config.timeout ?? DEFAULT_TIMEOUT);
-        });
-    }
-    handleData(chunk) {
-        this.buffer = Buffer.concat([this.buffer, chunk]);
-        this.parseMessages();
-    }
-    parseMessages() {
-        while (true) {
-            if (this.contentLength === -1) {
-                const headerEnd = this.buffer.indexOf("\r\n\r\n");
-                if (headerEnd === -1)
-                    return;
-                // Заголовки — ASCII: декодим только срез заголовка.
-                const header = this.buffer.subarray(0, headerEnd).toString("utf8");
-                const match = header.match(/Content-Length: (\d+)/i);
-                if (!match) {
-                    this.buffer = this.buffer.subarray(headerEnd + 4);
-                    continue;
-                }
-                this.contentLength = parseInt(match[1], 10);
-                // Защита от злонамеренных/битых серверов с абсурдным Content-Length
-                if (this.contentLength > 10 * 1024 * 1024) {
-                    this.buffer = this.buffer.subarray(headerEnd + 4);
-                    this.contentLength = -1;
-                    continue;
-                }
-                this.buffer = this.buffer.subarray(headerEnd + 4);
-            }
-            // Content-Length считает БАЙТЫ, не JS-символы. Нарезка декодированной
-            // строки по числу символов портит фреймы с многобайтным UTF-8
-            // (напр. кириллические диагностики) — остаток держим сырыми байтами.
-            if (this.buffer.length < this.contentLength)
-                return;
-            const body = this.buffer.subarray(0, this.contentLength).toString("utf8");
-            this.buffer = this.buffer.subarray(this.contentLength);
-            this.contentLength = -1;
-            try {
-                const msg = JSON.parse(body);
-                this.handleMessage(msg);
-            }
-            catch (e) {
-                this.logger?.debug(`LSP JSON parse error: ${errMsg(e)}`);
-            }
-        }
-    }
-    handleMessage(msg) {
-        if (msg.method === "textDocument/publishDiagnostics") {
-            const params = msg.params;
-            if (params?.diagnostics) {
-                this.diagnostics = params.diagnostics;
-                if (this.diagnosticsTimer) {
-                    clearTimeout(this.diagnosticsTimer);
-                    this.diagnosticsTimer = null;
-                }
-                this.diagnosticsResolve?.(this.diagnostics);
-                this.diagnosticsResolve = null;
-            }
-            return;
-        }
-        if (msg.id !== undefined && msg.id !== null) {
-            const pending = this.pending.get(msg.id);
-            if (pending) {
-                this.pending.delete(msg.id);
-                if (msg.error) {
-                    pending.reject(new Error(String(msg.error.message ?? "LSP error")));
-                }
-                else {
-                    pending.resolve(msg.result);
-                }
-            }
-        }
-    }
-    sendRequest(method, params, timeout) {
-        return new Promise((resolve, reject) => {
-            const id = ++this.requestId;
-            this.pending.set(id, { resolve, reject });
-            const message = JSON.stringify({ jsonrpc: "2.0", id, method, params });
-            this.write(message);
-            setTimeout(() => {
-                if (this.pending.has(id)) {
-                    this.pending.delete(id);
-                    const msg = `LSP request timeout: ${method}`;
-                    this.logger?.warn(msg, { method, timeout });
-                    reject(new Error(msg));
-                }
-            }, timeout);
-        });
-    }
-    sendNotification(method, params) {
-        const message = JSON.stringify({ jsonrpc: "2.0", method, params });
-        this.write(message);
-    }
-    write(message) {
-        if (!this.process?.stdin?.writable) {
-            this.logger?.debug("LSP write failed: process stdin not writable");
-            return;
-        }
-        const header = `Content-Length: ${Buffer.byteLength(message)}\r\n\r\n`;
-        try {
-            this.process.stdin.write(header + message);
-        }
-        catch (e) {
-            this.logger?.debug(`LSP write error: ${errMsg(e)}`);
-        }
-    }
-    async shutdown() {
-        try {
-            if (this.process && this.initialized && this.process.stdin?.writable) {
-                // Ответ shutdown ждём (с таймаутом), чтобы сервер успел подтвердить до
-                // exit и kill. Старый код слал shutdown fire-and-forget и тут же убивал —
-                // сервер ответить не успевал, сыпались ложные timeout-предупреждения.
-                try {
-                    await this.sendRequest("shutdown", null, 3000);
-                }
-                catch (e) {
-                    this.logger?.debug(`LSP shutdown request failed: ${errMsg(e)}`);
-                }
-                this.sendNotification("exit", null);
-                await new Promise((r) => setTimeout(r, 200));
-            }
-        }
-        catch (e) {
-            this.logger?.debug(`LSP shutdown error: ${errMsg(e)}`);
-        }
-        finally {
-            if (this.process) {
-                // Прямой потомок на win32 — cmd.exe-обёртка; её убийство в одиночку
-                // сиротит дерево npx → node → tsserver (наблюдались текущие node после
-                // каждого чека). Tree-kill — умирает вся цепочка.
-                try {
-                    killTree(this.process);
-                }
-                catch (e) {
-                    this.logger?.debug(`LSP killTree error: ${errMsg(e)}`);
-                }
-                this.process = null;
-            }
-            this.initialized = false;
-            this.buffer = Buffer.alloc(0);
-            this.contentLength = -1;
-            if (this.diagnosticsTimer) {
-                clearTimeout(this.diagnosticsTimer);
-                this.diagnosticsTimer = null;
-            }
-        }
-    }
-    pathToUri(filePath) {
-        const normalized = toForwardSlash(filePath);
-        return /^[a-zA-Z]:/.test(normalized) ? `file:///${normalized}` : `file://${normalized}`;
-    }
-    languageFromPath(filePath) {
-        const ext = filePath.split(".").pop()?.toLowerCase();
-        const map = {
-            ts: "typescript",
-            tsx: "typescriptreact",
-            mts: "typescript",
-            cts: "typescript",
-            js: "javascript",
-            jsx: "javascriptreact",
-            mjs: "javascript",
-            cjs: "javascript",
-            py: "python",
-            go: "go",
-            rs: "rust",
-            json: "json",
-            html: "html",
-            css: "css",
-            scss: "scss",
-            md: "markdown",
-            yaml: "yaml",
-            yml: "yaml",
-        };
-        return map[ext ?? ""] ?? "plaintext";
-    }
-    /**
-     * Имя реального бинарника из npx-args — только строгий layout
-     * `[--yes] [--package X]... <binary> --stdio`. Серверы с хвостовыми
-     * серверными аргументами (напр. angular `ngserver --stdio --tsProbeLocations …`)
-     * дают null и всегда идут через npx — их флаги не принять за бинарник
-     * и не вырезать.
-     */
-    extractBinaryFromNpxArgs(args) {
-        const stdioIdx = args.lastIndexOf("--stdio");
-        if (stdioIdx !== args.length - 1 || stdioIdx < 1)
-            return null;
-        const binary = args[stdioIdx - 1];
-        if (!binary || binary.startsWith("-") || this.isPackageVersion(binary))
-            return null;
-        for (let i = 0; i < stdioIdx - 1; i++) {
-            const a = args[i];
-            if (a === "--yes")
-                continue;
-            if (a === "--package") {
-                i++;
-                continue;
-            }
-            return null;
-        }
-        return binary;
-    }
-    /** Похоже ли на спецификатор версии пакета (напр. "typescript@5"). */
-    isPackageVersion(s) {
-        return /^[\w-]+@[\d.+*-]/.test(s);
-    }
-}

package/dist/modules/lsp/command.js

@@ -1,53 +0,0 @@
-// Запуск LSP-серверов на Windows: резолв shim (.cmd/.bat) и строка для cmd.exe.
-import { delimiter, join } from "path";
-import { existsSync } from "fs";
-import { platform } from "os";
-const WIN_EXTS = [".cmd", ".bat", ".exe", ".com"];
-/**
- * Резолв команды для `child_process.spawn` на Windows.
- * Node-`spawn` не исполняет `.cmd`/`.bat`-шимы напрямую без shell, а голый
- * `npx` падает с `spawn npx ENOENT` — на Windows реальный бинарник это
- * `npx.cmd`. Возвращает первый найденный на PATH шим (`npx.cmd`, `npx.bat`,
- * `npx.exe`, …), а если ничего нет — голую команду (spawn упадёт с понятным
- * ENOENT). Не-Windows и команды с расширением/сепаратором — как есть.
- */
-export function resolveSpawnCommand(command, platformName = platform(), pathEnv = process.env.PATH ?? "") {
-    if (platformName !== "win32")
-        return command;
-    // Уже путь или с расширением — пропустить как есть.
-    if (command.includes("/") ||
-        command.includes("\\") ||
-        WIN_EXTS.some((ext) => command.toLowerCase().endsWith(ext))) {
-        return command;
-    }
-    const dirs = pathEnv.split(delimiter).filter(Boolean);
-    for (const dir of dirs) {
-        for (const ext of WIN_EXTS) {
-            const candidate = join(dir, `${command}${ext}`);
-            if (existsSync(candidate))
-                return `${command}${ext}`;
-        }
-    }
-    return command;
-}
-/**
- * Склейка резолвленной команды и args в одну строку для cmd.exe.
- * Под Node на Windows `spawn` `.cmd`/`.bat`-шима БЕЗ shell бросает
- * `spawn EINVAL` (CreateProcess не запускает батники напрямую). Резолв
- * `npx` → `npx.cmd` чинит старый `ENOENT`, но не `EINVAL` — shell'а всё равно
- * нет. Надёжный фикс — гнать всю строку через `cmd.exe /d /s /c`
- * (т.е. `spawn(line, { shell: true })`). Хелпер строит строку, квотируя
- * аргументы с cmd-метасимволами, чтобы имена пакетов и флаги LSP-конфигов
- * (`typescript-language-server --stdio`, `pyright --stdio`) пережили round-trip.
- * Не-Windows сюда не ходят (спавнят команду + args напрямую, без shell).
- */
-export function buildWinCommandLine(command, args) {
-    const quote = (part) => {
-        if (part === "")
-            return '""';
-        if (!/[\s"&|^<>()%!]/.test(part))
-            return part;
-        return `"${part.replace(/"/g, '\\"')}"`;
-    };
-    return [command, ...args].map(quote).join(" ");
-}

package/dist/modules/lsp/config.js

@@ -1,189 +0,0 @@
-// Дефолтные LSP-серверы и выбор сервера по файлу (язык, Angular-исключение).
-import { existsSync } from "fs";
-import { dirname, join } from "path";
-/**
- * Дефолты LSP-серверов.
- * Стратегия: предпочитать `npx` (самодокачка) глобальным бинарникам.
- * Серверы на системных тулах (rust-analyzer, gopls) — `autoInstall: false`,
- * при отсутствии молча скипаются.
- */
-export const DEFAULT_LSP_CONFIG = {
-    enabled: true,
-    timeout: 15000,
-    servers: {
-        typescript: {
-            command: "npx",
-            args: [
-                "--yes",
-                "--package",
-                "typescript-language-server",
-                "--package",
-                "typescript@5",
-                "typescript-language-server",
-                "--stdio",
-            ],
-            timeout: 30000,
-            autoInstall: true,
-            workspaceMarkers: ["package.json", "tsconfig.json"],
-        },
-        javascript: {
-            command: "npx",
-            args: [
-                "--yes",
-                "--package",
-                "typescript-language-server",
-                "--package",
-                "typescript@5",
-                "typescript-language-server",
-                "--stdio",
-            ],
-            timeout: 30000,
-            autoInstall: true,
-            workspaceMarkers: ["package.json", "tsconfig.json"],
-        },
-        python: {
-            command: "npx",
-            args: ["pyright", "--stdio"],
-            timeout: 15000,
-            autoInstall: true,
-            workspaceMarkers: ["pyproject.toml", "setup.py", "requirements.txt"],
-        },
-        rust: {
-            command: "rust-analyzer",
-            timeout: 15000,
-            autoInstall: false,
-            workspaceMarkers: ["Cargo.toml"],
-        },
-        go: {
-            command: "gopls",
-            timeout: 15000,
-            autoInstall: false,
-            workspaceMarkers: ["go.mod"],
-        },
-        json: {
-            command: "npx",
-            args: [
-                "--yes",
-                "--package",
-                "vscode-langservers-extracted",
-                "vscode-json-language-server",
-                "--stdio",
-            ],
-            timeout: 30000,
-            autoInstall: true,
-            workspaceMarkers: ["package.json"],
-        },
-        html: {
-            command: "npx",
-            args: [
-                "--yes",
-                "--package",
-                "vscode-langservers-extracted",
-                "--package",
-                "typescript@5",
-                "vscode-html-language-server",
-                "--stdio",
-            ],
-            timeout: 60000,
-            autoInstall: true,
-            workspaceMarkers: ["package.json"],
-        },
-        css: {
-            command: "npx",
-            args: [
-                "--yes",
-                "--package",
-                "vscode-langservers-extracted",
-                "--package",
-                "typescript@5",
-                "vscode-css-language-server",
-                "--stdio",
-            ],
-            timeout: 60000,
-            autoInstall: true,
-            workspaceMarkers: ["package.json"],
-        },
-        angular: {
-            command: "npx",
-            args: [
-                "--yes",
-                "--package",
-                "@angular/language-server",
-                "--package",
-                "typescript@5",
-                "ngserver",
-                "--stdio",
-                "--tsProbeLocations",
-                "./node_modules",
-                "--ngProbeLocations",
-                "./node_modules",
-            ],
-            timeout: 60000,
-            autoInstall: true,
-            workspaceMarkers: ["angular.json"],
-        },
-    },
-};
-const LANGUAGE_MAP = {
-    ts: "typescript",
-    tsx: "typescript",
-    mts: "typescript",
-    cts: "typescript",
-    js: "javascript",
-    jsx: "javascript",
-    mjs: "javascript",
-    cjs: "javascript",
-    py: "python",
-    rs: "rust",
-    go: "go",
-    json: "json",
-    html: "html",
-    css: "css",
-    scss: "css",
-};
-/** Id языка по расширению файла (через LANGUAGE_MAP), неподдерживаемое — null. */
-export function getLanguageForFile(filePath) {
-    const ext = filePath.split(".").pop()?.toLowerCase();
-    if (!ext)
-        return null;
-    return LANGUAGE_MAP[ext] ?? null;
-}
-const ANGULAR_MARKER = "angular.json";
-const ANGULAR_LOOKUP_DEPTH = 10;
-/**
- * Лежит ли файл внутри Angular-workspace (маркер `angular.json` в одном из
- * предков, поиск ограничен глубиной).
- */
-function isAngularProject(filePath) {
-    let dir = dirname(filePath);
-    for (let i = 0; i < ANGULAR_LOOKUP_DEPTH; i++) {
-        if (existsSync(join(dir, ANGULAR_MARKER)))
-            return true;
-        const parent = dirname(dir);
-        if (parent === dir)
-            return false;
-        dir = parent;
-    }
-    return false;
-}
-/**
- * Ключ конфига LSP-сервера для файла. `.html` идёт на сервер `angular` внутри
- * Angular-workspace (шаблонам с биндингами нужен Angular language service),
- * везде иначе — на generic `html`.
- */
-export function getServerKeyForFile(filePath, config) {
-    const lang = getLanguageForFile(filePath);
-    if (!lang)
-        return null;
-    if (lang === "html" && config.servers.angular && isAngularProject(filePath)) {
-        return "angular";
-    }
-    return lang;
-}
-/** Конфиг LSP-сервера для файла (null — не поддерживается). */
-export function getServerForFile(filePath, config) {
-    const key = getServerKeyForFile(filePath, config);
-    if (!key)
-        return null;
-    return config.servers[key] ?? null;
-}

package/dist/modules/lsp/index.js

@@ -1,4 +0,0 @@
-// Публичный фасад модуля LSP: модуль, клиент, конфиг, типы.
-export { LspModule } from "./module";
-export { LspClient, FileOnlyLogger } from "./client";
-export { getServerForFile, DEFAULT_LSP_CONFIG } from "./config";