micro-models-agent 2.16.0 → 2.17.1

package/dist/modules/processes/registry.js

@@ -1,294 +0,0 @@
-// Реестр фоновых процессов: спавн, буферизация лога, килл, ожидание выхода.
-import { spawn, spawnSync } from "child_process";
-import { platform } from "os";
-import { killTree } from "./kill-tree";
-const MAX_LOG_LINES = 2000;
-/** Кап одной незавершённой строки, чтобы дамп без переводов не дал OOM. */
-const MAX_PARTIAL_CHARS = 64 * 1024;
-const MAX_PARTIAL_BYTES = 64 * 1024;
-const MAX_KEPT_PROCESSES = 20;
-let seq = 0;
-/** OEM-декодер (русская CP866 / активная кодовая страница) — кеш после первого вызова. */
-let oemDecoder;
-function getOemDecoder() {
-    if (oemDecoder !== undefined)
-        return oemDecoder;
-    oemDecoder = null;
-    try {
-        const cpOut = spawnSync("chcp.com", {
-            encoding: "buffer",
-            timeout: 2000,
-            windowsHide: true,
-        }).stdout;
-        const m = cpOut ? cpOut.toString("latin1").match(/(\d+)/) : null;
-        if (m) {
-            try {
-                oemDecoder = new TextDecoder(`ibm${m[1]}`);
-            }
-            catch {
-                oemDecoder = null;
-            }
-        }
-    }
-    catch {
-        /* ignore */
-    }
-    if (!oemDecoder) {
-        try {
-            oemDecoder = new TextDecoder("ibm866");
-        }
-        catch {
-            oemDecoder = null;
-        }
-    }
-    return oemDecoder;
-}
-/**
- * Декодирует одну готовую строку вывода в UTF-8.
- *
- * Современные тулы (Bun, Node, npm, git) пишут UTF-8 в пайп независимо от
- * кодовой страницы консоли, а встроенные команды cmd.exe (echo, type, dir) —
- * OEM-страницу (CP866 на русской Windows). Сначала строгий UTF-8; если байты
- * невалидны — откат на OEM-декодер.
- */
-function decodeLineToUtf8(buf) {
-    try {
-        return new TextDecoder("utf-8", { fatal: true }).decode(buf);
-    }
-    catch {
-        /* невалидный UTF-8 → вывод в OEM-кодировке */
-    }
-    const oem = getOemDecoder();
-    if (oem) {
-        try {
-            return oem.decode(buf);
-        }
-        catch {
-            /* неизвестная кодировка — откат на latin1 */
-        }
-    }
-    return buf.toString("latin1");
-}
-/** Реэкспорт килла дерева для потребителей реестра. */
-export { killTree } from "./kill-tree";
-class ProcessRegistry {
-    procs = new Map();
-    children = new Map();
-    exitWaiters = new Map();
-    /**
-     * Запускает команду. Возвращённая запись буферизует вывод и отдаёт статус;
-     * дождаться завершения можно через `waitForExit(id)`.
-     */
-    start(command, cwd, sessionId) {
-        const id = `proc_${Date.now()}_${++seq}`;
-        const entry = {
-            id,
-            pid: 0,
-            command,
-            cwd,
-            sessionId,
-            status: "running",
-            exitCode: null,
-            startedAt: new Date().toISOString(),
-            log: [],
-        };
-        this.trimOldEntries();
-        this.procs.set(id, entry);
-        let child;
-        try {
-            child = spawn(command, {
-                cwd,
-                shell: true,
-                windowsHide: true,
-                detached: platform() !== "win32",
-                stdio: ["ignore", "pipe", "pipe"],
-            });
-        }
-        catch (e) {
-            entry.status = "killed";
-            entry.spawnError = e?.message || String(e);
-            entry.log.push(`[process error] ${entry.spawnError}`);
-            return entry;
-        }
-        this.children.set(id, child);
-        entry.pid = child.pid ?? 0;
-        let buf = "";
-        let byteBuf = Buffer.alloc(0);
-        const isWin = platform() === "win32";
-        const unixDecoder = new TextDecoder("utf-8");
-        const pushLine = (line) => {
-            if (entry.log.length >= MAX_LOG_LINES) {
-                entry.log.shift();
-            }
-            entry.log.push(line);
-        };
-        const append = (chunk) => {
-            if (!isWin) {
-                const decoded = unixDecoder.decode(chunk, { stream: true });
-                buf += decoded;
-                const lines = buf.split(/\r?\n/);
-                buf = lines.pop() ?? "";
-                for (const line of lines) {
-                    pushLine(line);
-                }
-                // Сбрасываем очень длинную частичную строку вместо безлимитной буферизации.
-                if (buf.length > MAX_PARTIAL_CHARS) {
-                    pushLine(buf);
-                    buf = "";
-                }
-                return;
-            }
-            // Windows: копим сырые байты и декодируем построчно. Современные тулы
-            // (Bun, Node, npm, git) пишут UTF-8 в пайп независимо от кодовой страницы
-            // консоли; встроенные команды cmd.exe (echo, type, dir) — OEM-страницу.
-            // Декодировка подбирается построчно, чтобы русский выживал в обоих случаях.
-            byteBuf = byteBuf.length ? Buffer.concat([byteBuf, chunk]) : Buffer.from(chunk);
-            let nl;
-            while ((nl = byteBuf.indexOf(0x0a)) !== -1) {
-                const raw = byteBuf.subarray(0, nl);
-                byteBuf = byteBuf.subarray(nl + 1);
-                pushLine(decodeLineToUtf8(raw).replace(/\r$/, ""));
-            }
-            // Сбрасываем очень длинную частичную строку вместо безлимитной буферизации.
-            if (byteBuf.length > MAX_PARTIAL_BYTES) {
-                pushLine(decodeLineToUtf8(byteBuf));
-                byteBuf = Buffer.alloc(0);
-            }
-        };
-        const flush = () => {
-            if (!isWin) {
-                buf += unixDecoder.decode();
-                if (buf) {
-                    pushLine(buf);
-                    buf = "";
-                }
-                return;
-            }
-            if (byteBuf.length) {
-                pushLine(decodeLineToUtf8(byteBuf));
-                byteBuf = Buffer.alloc(0);
-            }
-        };
-        const resolveExit = () => {
-            this.exitWaiters.get(id)?.resolve();
-        };
-        child.stdout?.on("data", append);
-        child.stderr?.on("data", append);
-        child.on("error", (err) => {
-            if (entry.status === "running") {
-                entry.status = "killed";
-            }
-            entry.spawnError = err.message;
-            // Пишем прямо в лог, не через `append`: упавший спавн часто вообще
-            // не эмитит `close`, и буферизованная строка не сбросилась бы —
-            // лог остался бы пустым (видно в тесте "records a spawn error").
-            pushLine(`[process error] ${err.message}`);
-            resolveExit();
-        });
-        child.on("close", (code) => {
-            flush();
-            if (entry.status === "running") {
-                entry.status = "exited";
-            }
-            entry.exitCode = code;
-            this.children.delete(id);
-            resolveExit();
-        });
-        let resolve;
-        const promise = new Promise((r) => {
-            resolve = r;
-        });
-        this.exitWaiters.set(id, { promise, resolve });
-        return entry;
-    }
-    /** Список процессов, опционально по сессии. */
-    list(sessionId) {
-        const all = Array.from(this.procs.values());
-        if (!sessionId)
-            return all;
-        return all.filter((p) => p.sessionId === sessionId);
-    }
-    /** Процесс по id; undefined, если нет. */
-    get(id) {
-        return this.procs.get(id);
-    }
-    /** Лог процесса целиком или хвостом `tail` строк. */
-    getLog(id, tail) {
-        const entry = this.procs.get(id);
-        if (!entry)
-            return "";
-        const lines = tail && tail > 0 ? entry.log.slice(-tail) : entry.log;
-        return lines.join("\n");
-    }
-    /** Убивает дерево фонового процесса. False, если не найден. */
-    kill(id) {
-        const entry = this.procs.get(id);
-        if (!entry)
-            return false;
-        if (entry.status === "running") {
-            entry.status = "killed";
-            const child = this.children.get(id);
-            if (child) {
-                killTree(child);
-            }
-        }
-        return true;
-    }
-    /** Убивает все управляемые фоновые процессы (при останове агента). Возвращает число. */
-    killAll(sessionId) {
-        const targets = this.list(sessionId);
-        for (const entry of targets) {
-            this.kill(entry.id);
-        }
-        return targets.length;
-    }
-    /**
-     * Резолвит `true`, если процесс вышел (или не спавнился) за `timeoutMs`,
-     * иначе `false` (всё ещё бежит → фоновый процесс).
-     */
-    waitForExit(id, timeoutMs) {
-        const entry = this.procs.get(id);
-        const waiter = this.exitWaiters.get(id);
-        if (entry?.status !== "running" || !waiter) {
-            return Promise.resolve(true);
-        }
-        return new Promise((resolve) => {
-            const timer = setTimeout(() => resolve(false), timeoutMs);
-            waiter.promise.then(() => {
-                clearTimeout(timer);
-                resolve(true);
-            });
-        });
-    }
-    /**
-     * Удаляет завершённую запись (foreground-результаты не залеживаются).
-     * Ещё бегущая сначала убивается, чтобы не осиротеть.
-     */
-    remove(id) {
-        const entry = this.procs.get(id);
-        if (!entry)
-            return false;
-        if (entry.status === "running") {
-            const child = this.children.get(id);
-            if (child) {
-                killTree(child);
-            }
-            entry.status = "killed";
-        }
-        this.procs.delete(id);
-        this.children.delete(id);
-        this.exitWaiters.delete(id);
-        return true;
-    }
-    trimOldEntries() {
-        if (this.procs.size < MAX_KEPT_PROCESSES)
-            return;
-        const sorted = Array.from(this.procs.values()).sort((a, b) => a.startedAt.localeCompare(b.startedAt));
-        const toRemove = sorted.slice(0, sorted.length - MAX_KEPT_PROCESSES + 1);
-        for (const entry of toRemove) {
-            this.remove(entry.id);
-        }
-    }
-}
-/** Синглтон реестра фоновых процессов. */
-export const processRegistry = new ProcessRegistry();

package/dist/modules/processes/runner.js

@@ -1,23 +0,0 @@
-const activeChildren = new Map();
-/** Регистрирует kill-колбэк тул-вызова (для таймаута/аборта экзекутора). */
-export function registerKillable(callId, kill) {
-    activeChildren.set(callId, { kill });
-}
-/** Снимает kill-колбэк завершившегося хендлера. */
-export function unregisterKillable(callId) {
-    activeChildren.delete(callId);
-}
-/** Вызывает (и снимает) kill-колбэк для `callId`; false — не было. */
-export function killByCallId(callId) {
-    const entry = activeChildren.get(callId);
-    if (!entry)
-        return false;
-    activeChildren.delete(callId);
-    try {
-        entry.kill();
-    }
-    catch {
-        /* уже мёртв */
-    }
-    return true;
-}

package/dist/modules/providers/cache.js

@@ -1,23 +0,0 @@
-/**
- * Фолбэк для провайдеров без кеша и без полей запроса о кеше. Используется,
- * когда пресет не объявляет `cache`-возможность.
- */
-export const NO_CACHE_CAPABILITY = {
-    mechanism: "none",
-    report: "none",
-    sessionHeader: false,
-    requestCachePrompt: false,
-    requestPromptCacheKey: false,
-    requestSessionId: false,
-    requestCacheControl: false,
-    requestStreamUsage: false,
-};
-/**
- * Резолвит эффективную cache-возможность провайдера: дефолт пресета, поверх
- * которого накладывается переопределение из записи конфига. Всегда возвращает
- * новый объект, чтобы вызывающий не рисковал мутировать общее состояние.
- */
-export function resolveCacheCapability(spec, override) {
-    const base = spec?.capabilities.cache ?? NO_CACHE_CAPABILITY;
-    return { ...base, ...(override ?? {}) };
-}

package/dist/modules/providers/capabilities.js

@@ -1,28 +0,0 @@
-/**
- * Консервативный фолбэк, когда ни пресет, ни probe, ни конфиг не дали данных.
- * "false" безопаснее "true": неверное "нет vision" ведёт к текстовому
- * snapshot'у, неверное "есть vision" — к отправке картинки, которую бэкенд
- * отвергнет или проигнорирует.
- */
-export const DEFAULT_MODEL_CAPABILITIES = {
-    vision: false,
-    tools: false,
-};
-/**
- * Единый источник правды о возможностях АКТИВНОЙ модели (данные, не
- * эвристика по имени — правило #10). Приоритет слоёв, от высшего к низшему:
- *
- *   1. явный конфиг-оверрайд пользователя (`config.modelCapabilities[model]`);
- *   2. живой probe провайдера (LM Studio native API и т.п.);
- *   3. пресет провайдера (`providers/presets.ts`).
- *
- * Всегда возвращает новый объект: вызывающий не рискует мутировать общий
- * пресет или конфиг. Отсутствующие в probe поля берутся из нижнего слоя —
- * probe может уточнять только часть возможностей.
- */
-export function resolveModelCapabilities(preset, probe, override) {
-    const base = preset
-        ? { vision: preset.vision, tools: preset.tools }
-        : { ...DEFAULT_MODEL_CAPABILITIES };
-    return { ...base, ...(probe ?? {}), ...(override ?? {}) };
-}

package/dist/modules/providers/create.js

@@ -1,21 +0,0 @@
-import { BUILTIN_PROVIDERS } from "./presets";
-import { ProviderRegistry as Registry } from "./registry";
-/**
- * Единая точка сборки провайдера. Неизвестные типы откатываются на
- * OpenAI-совместимый (совместимость с легаси-конфигами: кастомный `type` + baseUrl).
- */
-export function createProvider(type, opts, registry = defaultRegistry()) {
-    const spec = registry.get(type);
-    if (!spec) {
-        return BUILTIN_PROVIDERS[0].create(opts);
-    }
-    return spec.create(opts);
-}
-/** Реестр, предзагруженный всеми builtin-пресетами. */
-export function defaultRegistry() {
-    const registry = new Registry();
-    for (const spec of BUILTIN_PROVIDERS) {
-        registry.register(spec);
-    }
-    return registry;
-}

package/dist/modules/providers/factory.js

@@ -1,28 +0,0 @@
-import { ProviderManager } from "./manager";
-import { FallbackProvider } from "./fallback";
-/**
- * Общая фабрика АКТИВНОГО провайдера из конфига — для bootstrap и
- * Agent.setProvider/reconfigure. Раньше три места сборки дрейфовали: bootstrap
- * оборачивал менеджер в FallbackProvider при `fallback && entries > 1`, а
- * hot-swap (setProvider) пересобирал голый менеджер и молча ронял failover (B4).
- * Обёртка читает `manager.active` живьём, так что переключение менеджера после
- * сборки failover сохраняет.
- */
-/** Собрать активный провайдер (+ failover-обёртка при entries > 1). */
-export function buildActiveProvider(config, logger, opts) {
-    const manager = new ProviderManager(config.provider, {
-        contextWindow: config.contextWindow,
-        retry: config.retry,
-        rateLimits: config.security?.rateLimits,
-        getSessionId: opts?.getSessionId,
-        logger,
-    });
-    manager.setModel(config.model);
-    let provider = manager.active;
-    if (config.provider.fallback && manager.listNames().length > 1) {
-        provider = new FallbackProvider(manager, (from, to, error) => {
-            logger?.warn(`provider failover: ${from} -> ${to} (${error.message.slice(0, 120)})`);
-        });
-    }
-    return { manager, provider };
-}

package/dist/modules/providers/fallback.js

@@ -1,81 +0,0 @@
-import { LlmError } from "../../llm/llm-errors";
-/** Стоит ли ошибка переключения на другой провайдер. */
-export function isFailoverError(err) {
-    if (err instanceof Error && err.name === "AbortError")
-        return false;
-    // HTTP-статус, прикреплённый openai-compat как типизированный LlmError: только ретраируемые.
-    if (err instanceof LlmError && typeof err.llmStatus === "number") {
-        return err.llmStatus === 429 || err.llmStatus >= 500;
-    }
-    // Сетевые падения по errno-коду (Bun: "ConnectionRefused",
-    // Node: "ECONNREFUSED", DNS: "ENOTFOUND"/"EAI_AGAIN" и т.д.).
-    const e = err;
-    const normCode = (e?.code ?? "").replace(/[-_]/g, "").toLowerCase();
-    if (/^abort/.test(normCode))
-        return false;
-    if (/conn(refused|reset|timedout)|enotfound|eai_again|namenotresolved/.test(normCode)) {
-        return true;
-    }
-    // Сетевые падения по сообщению (fetch failed, таймауты, сбросы сокета).
-    return /fetch failed|unable to connect|network|econnrefused|enotfound|etimedout|socket hang up|connection refused|connection reset/i.test(e?.message ?? "");
-}
-/**
- * Оборачивает FallbackSource: ретраируемые падения (429/5xx/сеть) активного
- * провайдера прозрачно переключаются на следующую запись с ретраем там.
- * Failover — ТОЛЬКО до первого чанка: падение посреди стрима пробрасывается,
- * чтобы не дублировать вывод. Последний провайдер с успешным вызовом
- * становится активным (sticky).
- */
-export class FallbackProvider {
-    source;
-    onFailover;
-    constructor(source, onFailover) {
-        this.source = source;
-        this.onFailover = onFailover;
-    }
-    get model() {
-        return this.source.active.model;
-    }
-    get contextWindow() {
-        return this.source.active.contextWindow;
-    }
-    async *chat(messages, tools, signal, options) {
-        const names = this.source.listNames();
-        if (names.length <= 1) {
-            yield* this.source.active.chat(messages, tools, signal, options);
-            return;
-        }
-        let emitted = false;
-        let idx = Math.max(0, names.indexOf(this.source.activeName));
-        let lastError;
-        for (let attempt = 0; attempt < names.length; attempt++) {
-            const name = names[idx];
-            const provider = name === this.source.activeName
-                ? this.source.active
-                : this.source.switch(name);
-            try {
-                for await (const chunk of provider.chat(messages, tools, signal, options)) {
-                    emitted = true;
-                    yield chunk;
-                }
-                return;
-            }
-            catch (err) {
-                // Падение посреди стрима после отданного контента: рестарт
-                // задублировал бы чанки — пробросить ошибку вместо failover.
-                if (emitted || !isFailoverError(err))
-                    throw err;
-                lastError = err;
-                idx = (idx + 1) % names.length;
-                this.onFailover?.(name, names[idx], err);
-            }
-        }
-        throw lastError;
-    }
-    countTokens(text) {
-        return this.source.active.countTokens(text);
-    }
-    async listModels() {
-        return this.source.active.listModels();
-    }
-}

package/dist/modules/providers/health.js

@@ -1,47 +0,0 @@
-import { errMsg } from "../../utils";
-/**
- * Пробить провайдеры конкурентно и отчитаться ✓/✗ по каждой записи.
- * Только `listModels()` — бесплатный дешёвый вызов, никогда не платный chat.
- * Порядок входа в выводе сохраняется.
- */
-export async function probeProviders(targets, opts) {
-    const timeoutMs = opts?.timeoutMs ?? 5000;
-    const results = await Promise.all(targets.map((t) => probeOne(t, timeoutMs)));
-    return results;
-}
-async function probeOne(target, timeoutMs) {
-    const start = Date.now();
-    try {
-        const models = await withTimeout(target.listModels(), timeoutMs);
-        return { name: target.name, ok: true, ms: Date.now() - start, models: models.length };
-    }
-    catch (err) {
-        const message = errMsg(err);
-        return {
-            name: target.name,
-            ok: false,
-            ms: Date.now() - start,
-            models: 0,
-            error: message,
-        };
-    }
-}
-function withTimeout(promise, ms) {
-    return new Promise((resolve, reject) => {
-        const timer = setTimeout(() => reject(new Error(`timeout after ${ms}ms`)), ms);
-        promise.then((v) => {
-            clearTimeout(timer);
-            resolve(v);
-        }, (e) => {
-            clearTimeout(timer);
-            reject(e);
-        });
-    });
-}
-/** Собрать цели проб из маппинга имя→провайдер (порядок приоритетов). */
-export function targetsFromProviders(entries) {
-    return entries.map(({ name, provider }) => ({
-        name,
-        listModels: () => provider.listModels(),
-    }));
-}

package/dist/modules/providers/index.js

@@ -1,6 +0,0 @@
-export { ProviderRegistry } from "./registry";
-export { createProvider, defaultRegistry } from "./create";
-export { ProviderManager, presetOf } from "./manager";
-export { resolveCacheCapability, NO_CACHE_CAPABILITY } from "./cache";
-export { probeProviders, targetsFromProviders, } from "./health";
-export { BUILTIN_PROVIDERS, HOSTED_BASE_URLS } from "./presets";