micro-models-agent 2.16.0 → 2.17.1

package/dist/output/channel.js

@@ -1,285 +0,0 @@
-// Канал вывода: единственный владелец терминала (режимы idle/stream/modal/quiet).
-import { defaultOutputBus } from "./bus";
-import { formatEventLine } from "./format";
-/** Единственный писатель в терминал; подписывается на шину и рендерит события. */
-export class OutputChannel {
-    bus;
-    out;
-    err;
-    color;
-    mode = "idle";
-    modeBeforeQuiet = "idle";
-    modeBeforeModal = "idle";
-    modalDepth = 0;
-    sink = null;
-    queue = [];
-    pending = null;
-    partialOpen = false;
-    /**
-     * Log/block-события stdout, пойманные при активном промпте. Сбрасываются раз
-     * в микротаску, чтобы синхронный всплеск (например, 20-строчный результат
-     * команды) дал один `printAbove` + один ререндер кадра, а не по одному на
-     * строку (каждый стирал/перерисовывал кадр и слал DSR-запрос).
-     */
-    blockLines = null;
-    blockFlushScheduled = false;
-    unsub;
-    /**
-     * Глушит `info`-логи на человеческом терминале. Структурные логи — это
-     * диагностика, а не чат: quiet оставляет только warn/error. `writeLine`-блоки
-     * (help, status, вывод команд) не затрагиваются.
-     */
-    suppressInfoLogs = false;
-    /**
-     * Показ `data.diagnostic`-событий (внутренняя диагностика петли) в терминале.
-     * По умолчанию выкл: диагностика живёт в `.log`/`app.jsonl` и выходит в чат
-     * только при `ui.verbosity === "verbose"`.
-     */
-    showDiagnostics = false;
-    constructor(bus = defaultOutputBus, opts = {}) {
-        this.bus = bus;
-        this.out = opts.out ?? process.stdout;
-        this.err = opts.err ?? process.stderr;
-        const outTTY = this.out.isTTY === true;
-        this.color = opts.color ?? (!process.env.NO_COLOR && !process.env.CI && outTTY);
-        this.unsub = this.bus.subscribe((ev) => this.onEvent(ev));
-    }
-    /** Отписка от шины и сброс состояния. */
-    dispose() {
-        this.flushBlocks();
-        this.unsub();
-        this.queue = [];
-        this.pending = null;
-        this.partialOpen = false;
-        this.sink = null;
-        this.mode = "idle";
-    }
-    /** Привязка/отвязка промпта (null — терминал свободен). */
-    attachPrompt(sink) {
-        this.sink = sink;
-    }
-    /** Текущий режим канала. */
-    getMode() {
-        return this.mode;
-    }
-    /** Начало стрима ответа. Quiet не сбрасывается: `--json` молчит весь прогон. */
-    beginStreaming() {
-        // Переход в стрим не должен сбрасывать quiet: `--json` ставит quiet на весь
-        // прогон, и стримящиеся прогоны обязаны молчать.
-        if (this.mode === "quiet")
-            return;
-        this.flushBlocks();
-        this.flushPendingAsBlock();
-        this.mode = "streaming";
-    }
-    /** Конец стрима. Симметрично beginStreaming: quiet владеет режимом до setQuiet(false). */
-    endStreaming() {
-        // Симметрично beginStreaming: quiet владеет режимом до setQuiet(false).
-        if (this.mode === "quiet")
-            return;
-        this.closePartial();
-        this.mode = "idle";
-    }
-    /** Вход в модалку: события копятся в очередь до endModal. */
-    beginModal() {
-        this.flushBlocks();
-        this.flushPendingAsBlock();
-        if (this.mode === "quiet")
-            return; // quiet владеет setQuiet
-        // Вложенные модалки (визард внутри другой эксклюзивной области) не должны
-        // затирать режим, сохранённый самой внешней beginModal.
-        if (this.modalDepth === 0)
-            this.modeBeforeModal = this.mode;
-        this.modalDepth++;
-        this.mode = "modal";
-    }
-    /** Выход из модалки: сброс очереди накопленных событий в onEvent. */
-    endModal() {
-        if (this.modalDepth > 0)
-            this.modalDepth--;
-        if (this.mode === "modal" && this.modalDepth === 0)
-            this.mode = this.modeBeforeModal;
-        const q = this.queue;
-        this.queue = [];
-        for (const ev of q)
-            this.onEvent(ev);
-    }
-    /** Вкл/выкл quiet (`--json`): человеческий вывод дропается. */
-    setQuiet(quiet) {
-        this.flushBlocks();
-        if (quiet) {
-            if (this.mode !== "quiet") {
-                this.modeBeforeQuiet = this.mode;
-                this.mode = "quiet";
-            }
-        }
-        else if (this.mode === "quiet") {
-            this.mode = this.modeBeforeQuiet;
-        }
-    }
-    /** Скрыть `info`-логи терминала (warn/error остаются). */
-    setSuppressInfoLogs(suppress) {
-        this.suppressInfoLogs = suppress;
-    }
-    /** Показать внутреннюю диагностику (`Logger.diagnostic`) — только verbose. */
-    setShowDiagnostics(show) {
-        this.showDiagnostics = show;
-    }
-    /** Сырая запись в поток. В modal/quiet дропается, в idle идёт поверх промпта. */
-    writeRaw(text, stream = "stdout") {
-        // Сырой вывод не должен обгонять очередь блочных строк.
-        this.flushBlocks();
-        // modal осознанно дропает прямые записи: рендерер в модальном промпте не работает.
-        if (this.mode === "modal" || this.mode === "quiet")
-            return;
-        if (this.mode === "idle" && this.sink?.isActive() && stream === "stdout") {
-            const prev = this.pending?.stream === "stdout" ? this.pending.text : "";
-            this.pending = { stream, text: prev + text };
-            this.drainPending();
-            return;
-        }
-        if (stream === "stdout")
-            this.partialOpen = !text.endsWith("\n");
-        (stream === "stderr" ? this.err : this.out).write(text);
-    }
-    /** Блочная запись через шину (help, status, вывод команд). */
-    writeLine(text, stream = "stdout") {
-        this.bus.emit({ level: "info", source: "", kind: "block", text, stream });
-    }
-    /** Очистка экрана через промпт или ANSI. Буферный raw-партиал сбрасывается первым. */
-    clearScreen() {
-        this.flushBlocks();
-        // Иначе буферная raw-частичная строка всплывёт после очистки.
-        this.flushPendingAsBlock();
-        this.partialOpen = false;
-        if (this.mode === "quiet")
-            return;
-        if (this.sink?.isActive() && this.sink.clearScreen) {
-            this.sink.clearScreen();
-            return;
-        }
-        this.out.write("\x1b[2J\x1b[H");
-    }
-    /** Оверлей (спиннер) в stderr. В modal/quiet и при активном промпте дропается. */
-    writeOverlay(text) {
-        // modal осознанно дропает оверлеи: рендерер в модальном промпте не работает.
-        // Спиннер обязан остановиться до любого лога, иначе оверлей делит строку с логом.
-        if (this.mode === "modal" || this.mode === "quiet")
-            return;
-        if (this.mode === "idle" && this.sink?.isActive())
-            return;
-        this.err.write(text);
-    }
-    /** Режимы и фильтры, держащие событие вне терминала. */
-    shouldDrop(ev) {
-        if (this.mode === "quiet")
-            return true;
-        // Структурные info-логи — диагностика, а не чат: quiet их прячет.
-        if (this.suppressInfoLogs && ev.kind === "log" && ev.level === "info")
-            return true;
-        // Внутренняя диагностика петли — материал логов сессии, а не чата: в терминал
-        // только через verbose (setShowDiagnostics).
-        if (!this.showDiagnostics && ev.kind === "log" && ev.data?.diagnostic === true)
-            return true;
-        return false;
-    }
-    /** Пакует синхронный всплеск в один printAbove/рендер (см. blockLines). */
-    queueBlockLine(line) {
-        // Оба потока идут поверх промпта, иначе stderr-лог ляжет прямо на кадр
-        // ввода в обход порядка flushBlocks.
-        if (this.blockLines === null)
-            this.blockLines = [];
-        this.blockLines.push(line);
-        if (this.blockFlushScheduled)
-            return;
-        this.blockFlushScheduled = true;
-        queueMicrotask(() => this.flushBlocks());
-    }
-    onEvent(ev) {
-        if (this.shouldDrop(ev))
-            return;
-        if (this.mode === "modal") {
-            this.queue.push(ev);
-            return;
-        }
-        if (ev.kind === "raw") {
-            this.writeRaw(ev.text, ev.stream);
-            return;
-        }
-        const stream = ev.stream ?? "stdout";
-        const line = ev.kind === "block" ? ev.text : formatEventLine(ev, this.color);
-        if (this.mode === "idle" && this.sink?.isActive()) {
-            this.queueBlockLine(line);
-            return;
-        }
-        // Сохраняем FIFO: буферные блоки не должен обгонять эвент, писанный
-        // напрямую в raw-поток (например, stderr-лог посреди стрима).
-        this.flushBlocks();
-        if (this.mode === "streaming")
-            this.closePartial();
-        (stream === "stderr" ? this.err : this.out).write(`${line}\n`);
-    }
-    flushBlocks() {
-        this.blockFlushScheduled = false;
-        const lines = this.blockLines;
-        this.blockLines = null;
-        if (!lines || lines.length === 0)
-            return;
-        const text = lines.join("\n");
-        if (this.sink?.isActive()) {
-            this.sink.printAbove(text);
-        }
-        else {
-            this.out.write(`${text}\n`);
-        }
-    }
-    closePartial() {
-        if (this.partialOpen) {
-            this.out.write("\n");
-            this.partialOpen = false;
-        }
-    }
-    drainPending() {
-        if (!this.pending)
-            return;
-        const { stream, text } = this.pending;
-        const idx = text.lastIndexOf("\n");
-        if (idx < 0)
-            return;
-        const head = text.slice(0, idx + 1);
-        this.pending = { stream, text: text.slice(idx + 1) };
-        const lines = head.replace(/\n$/, "").split("\n");
-        if (this.sink?.isActive())
-            this.sink.printAbove(lines.join("\n"));
-        else
-            this.out.write(head);
-    }
-    flushPendingAsBlock() {
-        this.flushBlocks();
-        if (!this.pending)
-            return;
-        const text = this.pending.text;
-        const { stream } = this.pending;
-        this.pending = null;
-        if (this.sink?.isActive()) {
-            this.sink.printAbove(text);
-            this.partialOpen = false;
-        }
-        else {
-            (stream === "stderr" ? this.err : this.out).write(text);
-            this.partialOpen = stream === "stdout" ? !text.endsWith("\n") : this.partialOpen;
-        }
-    }
-}
-let defaultChannel = null;
-/** Канал-синглтон текущего процесса. */
-export function getDefaultChannel() {
-    if (!defaultChannel)
-        defaultChannel = new OutputChannel(defaultOutputBus);
-    return defaultChannel;
-}
-/** Сброс синглтона (изоляция тестов). */
-export function resetDefaultChannel() {
-    defaultChannel?.dispose();
-    defaultChannel = null;
-}

package/dist/output/format.js

@@ -1,15 +0,0 @@
-// Форматирование событий в строки вида `[LEVEL] [source] ISO — text`.
-import { createColors } from "picocolors";
-const colored = createColors(true);
-const LEVEL_COLORS = {
-    debug: (s) => colored.dim(s),
-    info: (s) => s,
-    warn: (s) => colored.yellow(s),
-    error: (s) => colored.red(s),
-};
-/** Форматирует событие как в legacy-логере: `[LEVEL] [source] ISO — text`. */
-export function formatEventLine(ev, color) {
-    const prefix = ev.source ? ` [${ev.source}]` : "";
-    const line = `[${ev.level.toUpperCase()}]${prefix} ${new Date(ev.ts).toISOString()} — ${ev.text}`;
-    return color ? LEVEL_COLORS[ev.level](line) : line;
-}

package/dist/output/index.js

@@ -1,8 +0,0 @@
-// Публичный фасад вывода: типы, шина, канал, стоки, машинный вывод.
-export * from "./types";
-export { OutputBus, defaultOutputBus } from "./bus";
-export { formatEventLine } from "./format";
-export { JsonOutputSink } from "./json-sink";
-export { SessionOutputSink } from "./session-sink";
-export { OutputChannel, getDefaultChannel, resetDefaultChannel, } from "./channel";
-export { writeMachineJson, writeNonTtyLine } from "./machine";

package/dist/output/json-sink.js

@@ -1,24 +0,0 @@
-/**
- * Копит события шины, чтобы машиночитаемый прогон (`--json`) включил
- * warn/error-диагностику, которую человеческий канал гасит через `setQuiet`.
- * Info/debug игнорируются: это шум прогресса, а не диагностика.
- */
-/** Сток warn/error-диагностики для `--json`. @param bus шина для подписки. */
-export class JsonOutputSink {
-    events = [];
-    unsub;
-    constructor(bus) {
-        this.unsub = bus.subscribe((ev) => {
-            this.events.push(ev);
-        });
-    }
-    /** Только warn/error события в виде плоских записей. */
-    diagnostics() {
-        return this.events
-            .filter((e) => e.level === "warn" || e.level === "error")
-            .map((e) => ({ level: e.level, source: e.source, text: e.text }));
-    }
-    dispose() {
-        this.unsub();
-    }
-}

package/dist/output/machine.js

@@ -1,9 +0,0 @@
-// Машиночитаемый вывод (JSON-контракты CLI). Единственное место с raw stdout.
-/** Пишет JSON в stdout (контракт `--json`). @param value любой сериализуемый объект. */
-export function writeMachineJson(value) {
-    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
-}
-/** Строка в stdout для non-TTY фолбэка REPL (оговорённое исключение single-writer). */
-export function writeNonTtyLine(text) {
-    process.stdout.write(`${text}\n`);
-}

package/dist/output/session-sink.js

@@ -1,27 +0,0 @@
-/**
- * Сохраняет в лог сессии только явно помеченные события (`data.persist === true`).
- * Остальной вывод — транзиентный прогресс терминала и осознанно НЕ персистится;
- * основной файловый путь долговечных записей — `SessionLogger.logSilent` /
- * `logStructured`.
- */
-export class SessionOutputSink {
-    session;
-    unsub;
-    constructor(bus, session) {
-        this.session = session;
-        this.unsub = bus.subscribe((ev) => {
-            if (ev.data?.persist !== true)
-                return;
-            this.session.appendLog({
-                ts: new Date(ev.ts).toISOString(),
-                type: "output",
-                level: ev.level,
-                source: ev.source,
-                content: ev.text,
-            });
-        });
-    }
-    dispose() {
-        this.unsub();
-    }
-}

package/dist/output/types.js

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

package/dist/tools/approve.js

@@ -1,41 +0,0 @@
-/** Тул явного Yes/No-подтверждения действия (интерактивный, alwaysOn). */
-import { t } from "../i18n/index";
-import { askChoice } from "./user-input";
-/** Просит подтверждение; reject — success:false (сигнал сбоя для цикла). */
-export const approveTool = {
-    name: "approve",
-    icon: "🙋",
-    description: "Request user approval for an action. The user picks Yes or No from a menu.",
-    tags: ["core"],
-    // Как в question.ts: интерактивные тулы переживают сужение (P5).
-    alwaysOn: true,
-    interactive: true,
-    parameters: {
-        type: "object",
-        properties: {
-            action: {
-                type: "string",
-                description: "Description of the action requiring approval",
-            },
-        },
-        required: ["action"],
-    },
-    handler: async (ctx, args) => {
-        if (ctx.exitOnComplete) {
-            return { success: false, output: t("tool.interactive_disabled") };
-        }
-        const action = String(args.action || "");
-        const question = t("tool.approve_prompt", { action });
-        const options = [
-            { label: t("tool.approve_yes"), description: t("tool.approve_yes_desc") },
-            { label: t("tool.approve_no"), description: t("tool.approve_no_desc") },
-        ];
-        const indexes = ctx.promptIO
-            ? await ctx.promptIO.askChoice(question, options, { allowCustom: false })
-            : await askChoice(question, options);
-        if (indexes[0] === 0) {
-            return { success: true, output: t("tool.approved") };
-        }
-        return { success: false, output: t("tool.rejected") };
-    },
-};

package/dist/tools/attach-image.js

@@ -1,102 +0,0 @@
-/** Тул аттача картинки в контекст (файл/URL/буфер обмена). */
-import { existsSync } from "fs";
-import { resolve } from "path";
-import { t } from "../i18n/index";
-import { loadFileAsDataUrl, loadUrlAsDataUrl, readClipboardImage, bufferToDataUrl, } from "../llm/image-utils";
-import { logSecurityBlock } from "../modules/security/audit-log";
-/** Кладёт картинку в pending-очередь контекста (PNG/JPEG/GIF/WebP). */
-export const attachImageTool = {
-    name: "attach_image",
-    icon: "🖼️",
-    description: "Attach an image to the conversation from a file path, URL, or clipboard. The image will be included in the next message sent to the model. Supports PNG, JPEG, GIF, WebP.",
-    tags: ["vision", "image"],
-    parameters: {
-        type: "object",
-        properties: {
-            source: {
-                type: "string",
-                description: 'Image source: file path (e.g. "./screenshot.png"), URL (e.g. "https://example.com/img.png"), or "clipboard" to read from system clipboard.',
-            },
-        },
-        required: ["source"],
-    },
-    handler: async (ctx, args) => {
-        const source = String(args.source ?? "").trim();
-        if (!source) {
-            return { success: false, output: t("image.source_required") };
-        }
-        try {
-            let dataUrl;
-            if (source.toLowerCase() === "clipboard") {
-                const clipBuf = await readClipboardImage();
-                if (!clipBuf) {
-                    return {
-                        success: false,
-                        output: t("image.clipboard_empty"),
-                    };
-                }
-                const result = await bufferToDataUrl(clipBuf);
-                dataUrl = result.dataUrl;
-            }
-            else if (source.startsWith("http://") || source.startsWith("https://")) {
-                // URL — по сетевой политике (SSRF).
-                const { isUrlAllowed } = await import("../modules/security/network-validator");
-                const { getSessionSecurityConfig } = await import("../modules/security/session-isolation");
-                const networkConfig = ctx.sessionContext
-                    ? getSessionSecurityConfig(ctx.config, ctx.sessionContext).network
-                    : ctx.config?.security?.network;
-                const urlCheck = isUrlAllowed(source, networkConfig);
-                if (!urlCheck.allowed) {
-                    logSecurityBlock(ctx.sessionId, "network_request", urlCheck.reason ?? "attach_image URL blocked", source);
-                    return { success: false, output: `[SECURITY BLOCKED] ${urlCheck.reason}` };
-                }
-                const result = await loadUrlAsDataUrl(source);
-                dataUrl = result.dataUrl;
-            }
-            else {
-                const absPath = resolve(ctx.baseDir, source);
-                if (!existsSync(absPath)) {
-                    return {
-                        success: false,
-                        output: t("image.not_found", { path: source }),
-                    };
-                }
-                // Пути: глобальная политика + скоуп субагента (та же связка, что у read_file).
-                const { isPathInScope } = await import("../modules/security/path-validator");
-                const { DEFAULT_SECURITY_CONFIG } = await import("../config/security");
-                const validation = isPathInScope(ctx.baseDir, absPath, ctx.scope, ctx.config?.security?.paths || DEFAULT_SECURITY_CONFIG.paths);
-                if (!validation.allowed) {
-                    logSecurityBlock(ctx.sessionId, "file_read", validation.reason ?? "attach_image out of scope", absPath);
-                    return {
-                        success: false,
-                        output: t("file.path_not_allowed", { path: source }),
-                    };
-                }
-                const result = await loadFileAsDataUrl(absPath);
-                dataUrl = result.dataUrl;
-            }
-            // Картинка — pending content part на менеджере контекста.
-            if (!ctx.contextManager) {
-                return {
-                    success: false,
-                    output: t("image.no_context"),
-                };
-            }
-            ctx.contextManager.addPendingImage({
-                type: "image_url",
-                image_url: { url: dataUrl },
-            });
-            const sizeKb = Math.round((dataUrl.length * 3) / 4 / 1024);
-            return {
-                success: true,
-                output: t("image.attached", { source, size: `${sizeKb} KB` }),
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                output: t("image.error", { message: err.message }),
-            };
-        }
-    },
-};