micro-models-agent 2.16.1 → 2.17.2

package/dist/modules/context/chunk-query.js

@@ -1,122 +0,0 @@
-import { errMsg } from "../../utils";
-/** Макс. символов склеенных ответов чанков для синтез-вызова. Не даёт
- * промпту синтеза вылезти за окно контекста на больших входах. */
-const MAX_SYNTHESIS_INPUT_CHARS = 20_000;
-/** Системный промпт чанка по умолчанию (строго по тексту, иначе NO_EVIDENCE). */
-export const DEFAULT_CHUNK_SYSTEM_PROMPT = 'Answer the query using ONLY the provided text. Be concise. If the text does not contain the answer, say "NO_EVIDENCE".';
-/** Системный промпт синтеза по умолчанию (сводка ответов чанков). */
-export const DEFAULT_SYNTHESIS_SYSTEM_PROMPT = "You are given a query and per-chunk answers over a large text. Produce the final answer to the query, combining evidence from the chunks. If no chunk had evidence, say so.";
-/** Режет текст на чанки по переводам строк, каждый ≤ chunkChars символов. */
-export function splitTextIntoChunks(text, chunkChars) {
-    if (chunkChars <= 0)
-        throw new Error("chunkChars must be > 0");
-    if (text.length <= chunkChars)
-        return [text];
-    const lines = text.split("\n");
-    const chunks = [];
-    let current = [];
-    let size = 0;
-    for (const line of lines) {
-        if (current.length > 0 && size + line.length + 1 > chunkChars) {
-            chunks.push(current.join("\n"));
-            current = [];
-            size = 0;
-        }
-        current.push(line);
-        size += line.length + 1;
-    }
-    if (current.length > 0)
-        chunks.push(current.join("\n"));
-    return chunks;
-}
-async function chatText(provider, messages, maxTokens, reasoningEffort, signal) {
-    let out = "";
-    for await (const chunk of provider.chat(messages, undefined, signal, {
-        maxTokens,
-        reasoningEffort,
-    })) {
-        if (chunk.type === "text" && chunk.content)
-            out += chunk.content;
-    }
-    return out;
-}
-/**
- * RLM-стиль llm_query: отвечает на `query` по `text` через чанкинг и опрос
- * модели по каждому чанку фиксированным системным промптом (дружит с KV-кэшем),
- * ограниченный параллелизм и опциональный проход синтеза.
- */
-export async function runChunkQuery(provider, text, query, opts = {}) {
-    const chunkChars = opts.chunkChars ?? 12000;
-    const maxParallel = Math.max(1, opts.maxParallel ?? 4);
-    const maxChunkTokens = opts.maxChunkTokens ?? 1024;
-    const maxSynthesisTokens = opts.maxSynthesisTokens ?? 2048;
-    const reasoningEffort = opts.reasoningEffort ?? "none";
-    const chunks = splitTextIntoChunks(text, chunkChars);
-    const answers = new Array(chunks.length);
-    const chunkSystem = opts.querySystemPrompt ?? DEFAULT_CHUNK_SYSTEM_PROMPT;
-    const logger = opts.logger;
-    if (chunks.length === 1) {
-        logger?.debug(`runChunkQuery: single chunk (${text.length} chars), no chunking needed`);
-    }
-    else {
-        logger?.debug(`runChunkQuery: ${chunks.length} chunks over ${text.length} chars (chunkChars=${chunkChars}, maxParallel=${maxParallel})`);
-    }
-    let cursor = 0;
-    let inFlight = 0;
-    let maxParallelObserved = 0;
-    const signal = opts.signal;
-    const workers = Array.from({ length: Math.min(maxParallel, chunks.length) }, async () => {
-        while (cursor < chunks.length) {
-            if (signal?.aborted)
-                break;
-            const idx = cursor++;
-            inFlight++;
-            maxParallelObserved = Math.max(maxParallelObserved, inFlight);
-            try {
-                answers[idx] = await chatText(provider, [
-                    { role: "system", content: chunkSystem },
-                    { role: "user", content: `Query: ${query}\n\nText:\n${chunks[idx]}` },
-                ], maxChunkTokens, reasoningEffort, signal);
-            }
-            catch (err) {
-                // Один упавший чанк не должен убивать весь запрос. Кладём ошибку,
-                // остальные чанки + синтез идут дальше.
-                const msg = errMsg(err);
-                answers[idx] = `[FAILED] ${msg.slice(0, 200)}`;
-                logger?.debug(`runChunkQuery: chunk ${idx + 1}/${chunks.length} failed: ${msg}`);
-            }
-            finally {
-                inFlight--;
-            }
-        }
-    });
-    await Promise.all(workers);
-    let synthesis = "";
-    if (opts.synthesize !== false && chunks.length > 0) {
-        let joined = answers
-            .map((a, i) => `--- Chunk ${i + 1}/${chunks.length} ---\n${a}`)
-            .join("\n\n");
-        // Кап входа синтеза — защита от переполнения контекста на больших текстах.
-        if (joined.length > MAX_SYNTHESIS_INPUT_CHARS) {
-            const truncated = joined.slice(0, MAX_SYNTHESIS_INPUT_CHARS);
-            joined = `${truncated}\n\n[TRUNCATED — synthesis input exceeded ${MAX_SYNTHESIS_INPUT_CHARS} chars]`;
-            logger?.debug(`runChunkQuery: synthesis input truncated from ${answers.join("").length} to ${MAX_SYNTHESIS_INPUT_CHARS} chars`);
-        }
-        logger?.debug(`runChunkQuery: synthesis pass over ${chunks.length} answers`);
-        synthesis = await chatText(provider, [
-            {
-                role: "system",
-                content: opts.synthesisSystemPrompt ?? DEFAULT_SYNTHESIS_SYSTEM_PROMPT,
-            },
-            { role: "user", content: `Query: ${query}\n\nChunk answers:\n${joined}` },
-        ], maxSynthesisTokens, reasoningEffort, signal);
-    }
-    logger?.debug(`runChunkQuery: done, ${chunks.length} chunks, max parallel observed ${maxParallelObserved}, synthesis ${synthesis.length} chars`);
-    return {
-        chunks: chunks.length,
-        answers,
-        synthesis,
-        totalChars: text.length,
-        maxParallelObserved,
-    };
-}

package/dist/modules/context/fact-extractor.js

@@ -1,170 +0,0 @@
-import { getMessageText } from "../../llm/provider";
-/**
- * Regex-извлечение фактов из tool/assistant-сообщений. Владеет списками фактов
- * файлов/удалений/решений/ошибок, переживающих компакцию. Вынесен из
- * ContextManager, чтобы ~115 строк regex-логики жили в одном месте (правило #2).
- */
-export class FactExtractor {
-    fileFacts = [];
-    deletedFacts = [];
-    decisionFacts = [];
-    errorFacts = [];
-    readFacts = [];
-    static MAX_FACTS = 20;
-    /** Число накопленных фактов ошибок. */
-    get errorCount() {
-        return this.errorFacts.length;
-    }
-    /** Сканирует пачку уплотняемых ходов и вливает их факты в списки. */
-    extract(turns) {
-        // Абсолютные Windows-пути ("E:\proj\src\a.ts") требуют опционального префикса
-        // диска; без него двоеточие ломает матч и факт молча теряется.
-        const DRIVE = "(?:[a-zA-Z]:[\\\\/])?";
-        const createdPatterns = [
-            new RegExp(`(?:Created|Updated|Written|Moved|Replaced in) ${DRIVE}([\\w./\\\\-]+\\.[a-z]+)`, "gi"),
-            new RegExp(`Файл (?:создан|обновлён|записан|перемещён):? ${DRIVE}([\\w./\\\\-]+\\.[a-z]+)`, "gi"),
-            new RegExp(`file (?:created|updated|written|moved):? ${DRIVE}([\\w./\\\\-]+\\.[a-z]+)`, "gi"),
-        ];
-        const deletedPatterns = [
-            new RegExp(`Deleted ${DRIVE}([\\w./\\\\-]+\\.[a-z]+)`, "gi"),
-            new RegExp(`(?:Удалён|Файл удалён):? ${DRIVE}([\\w./\\\\-]+\\.[a-z]+)`, "gi"),
-        ];
-        // Заголовок вывода read_file — независящий от локали префикс `── path (ext, …`
-        // (en: "lines", ru: "строк"). Путь в обеих локалях с тем же маркером,
-        // поэтому паттерну локализация не нужна.
-        const readPatterns = [new RegExp(`── (${DRIVE}[\\w./\\\\-]+\\.[a-z]+) \\(`, "gi")];
-        const newFiles = [];
-        const newDeleted = [];
-        const newDecisions = [];
-        const newErrors = [];
-        const newReads = [];
-        // Трекаем ПОСЛЕДНЕЕ событие тула на путь: удаление с пересозданием
-        // (или наоборот) в том же окне резолвится в финальное состояние, а не
-        // вылетает и из [Files:], и из [Deleted:].
-        const lastEvent = new Map();
-        for (const msg of turns) {
-            const content = getMessageText(msg.content);
-            // Системный промпт — никогда не источник фактов: модуль памяти встраивает
-            // туда errors.md с историческими "Tool X failed Nx" ПРОШЛЫХ дней, и их
-            // извлечение как текущих [Errors:] вводит модель в заблуждение, будто
-            // фейлит ОНА (было: ses_msvuao0h — протухшее "edit_file failed 3x"
-            // от 2026-08-15 попадало в каждую сводку как живой фейл сессии).
-            if (msg.role === "system")
-                continue;
-            // Прошлый <system-summary> — никогда не источник новых фактов, иначе
-            // рекурсивная вложенность сводок (сводка внутри сводки).
-            if (msg.role === "user" &&
-                (content.startsWith("<system-summary>") || content.includes("[Compressed:"))) {
-                continue;
-            }
-            if (msg.role === "tool") {
-                for (const pattern of createdPatterns) {
-                    for (const match of content.matchAll(pattern)) {
-                        newFiles.push(match[1]);
-                        lastEvent.set(match[1], "file");
-                    }
-                }
-                for (const pattern of deletedPatterns) {
-                    for (const match of content.matchAll(pattern)) {
-                        newDeleted.push(match[1]);
-                        lastEvent.set(match[1], "deleted");
-                    }
-                }
-                for (const pattern of readPatterns) {
-                    for (const match of content.matchAll(pattern)) {
-                        newReads.push(match[1]);
-                    }
-                }
-                if (content.includes("Plan:") && content.includes("[")) {
-                    const planLine = content.split("\n").find((line) => line.includes("Plan:"));
-                    if (planLine)
-                        newDecisions.push(planLine.trim());
-                }
-            }
-            if (msg.role === "assistant") {
-                if (content.includes("decided:") || content.includes("decision:")) {
-                    const line = content
-                        .split("\n")
-                        .find((l) => l.includes("decided:") || l.includes("decision:"));
-                    if (line)
-                        newDecisions.push(line.trim().slice(0, 200));
-                }
-            }
-            if (msg.role === "tool" || msg.role === "assistant") {
-                if (content.includes("Error:") ||
-                    content.includes("failed") ||
-                    content.includes("Ошибка:") ||
-                    content.includes("не удалось")) {
-                    // Строка "3 passed, 0 failed" — УСПЕШНЫЙ прогон тестов, не ошибка:
-                    // считать её деградирует качество контекста без причины.
-                    const ZERO_FAILURES = /\b0\s+(?:failed|failing|failures?)\b|(?:failed?|failures?|ошиб[а-я]*)\s*[:=]\s*0\b/i;
-                    const candidates = content
-                        .split("\n")
-                        .filter((l) => l.includes("Error:") ||
-                        l.includes("failed") ||
-                        l.includes("Ошибка:") ||
-                        l.includes("не удалось"));
-                    const line = candidates.find((l) => !ZERO_FAILURES.test(l));
-                    if (line)
-                        newErrors.push(line.trim().slice(0, 250));
-                }
-            }
-        }
-        // Дедуп и кап фактов против unbounded-роста. УДАЛЁННЫЕ файлы уходят из
-        // "известных": удалённый файл не должен числиться существующим (было:
-        // удалённые .js висели в каждом [Files: ...] всю сессию). Путь, удалённый
-        // и ПЕРЕСОЗДАННЫЙ (delete_file A → write_file A), возвращается в [Files:]
-        // и уходит из [Deleted:] — побеждает последнее событие окна.
-        const dedup = (arr) => [...new Set(arr)];
-        const finalFiles = dedup(newFiles.filter((p) => lastEvent.get(p) === "file"));
-        const finalDeleted = dedup(newDeleted.filter((p) => lastEvent.get(p) === "deleted"));
-        this.fileFacts = dedup([...this.fileFacts, ...finalFiles].filter((p) => !finalDeleted.includes(p))).slice(-FactExtractor.MAX_FACTS);
-        this.deletedFacts = dedup([...this.deletedFacts, ...finalDeleted].filter((p) => !finalFiles.includes(p))).slice(-FactExtractor.MAX_FACTS);
-        this.decisionFacts = dedup([...this.decisionFacts, ...newDecisions]).slice(-FactExtractor.MAX_FACTS);
-        this.errorFacts = dedup([...this.errorFacts, ...newErrors]).slice(-FactExtractor.MAX_FACTS);
-        this.readFacts = dedup([...this.readFacts, ...newReads]).slice(-FactExtractor.MAX_FACTS);
-    }
-    /** Строка `[Files: a; b]` для сводки компакции, или null. */
-    filesLine() {
-        const deletedSet = new Set(this.deletedFacts);
-        const liveFiles = this.fileFacts.filter((p) => !deletedSet.has(p));
-        if (liveFiles.length === 0)
-            return null;
-        return `[Files: ${liveFiles.slice(-15).join("; ")}]`;
-    }
-    /** Все известные живые файлы (не удалённые) — сидируют known-files проверки
-     *  галлюцинаций после компакции. */
-    getKnownFiles() {
-        const deletedSet = new Set(this.deletedFacts);
-        return this.fileFacts.filter((p) => !deletedSet.has(p));
-    }
-    /** Строка `[Deleted: c]`, или null. */
-    deletedLine() {
-        if (this.deletedFacts.length === 0)
-            return null;
-        return `[Deleted: ${this.deletedFacts.slice(-10).join("; ")}]`;
-    }
-    /** Строка `[Decisions: d]`, или null. */
-    decisionsLine() {
-        if (this.decisionFacts.length === 0)
-            return null;
-        return `[Decisions: ${this.decisionFacts.slice(-5).join("; ")}]`;
-    }
-    /** Строка `[Errors: e]`, или null. */
-    errorsLine() {
-        if (this.errorFacts.length === 0)
-            return null;
-        return `[Errors: ${this.errorFacts.slice(-3).join("; ")}]`;
-    }
-    /**
-     * Строка `[Read: p1; p2]` — файлы, уже просмотренные через read_file. После
-     * компакции модель переориентируется без рескана проекта: знает, что уже
-     * читала, и перечитывает только изменившееся (было: после компакции модель
-     * перечитывала те же файлы, т.к. "уже прочитано" компакцию не переживало).
-     */
-    readLine() {
-        if (this.readFacts.length === 0)
-            return null;
-        return `[Read: ${this.readFacts.slice(-12).join("; ")}]`;
-    }
-}

package/dist/modules/context/history.js

@@ -1,15 +0,0 @@
-import { appendFileSync, mkdirSync, existsSync } from 'fs';
-import { join } from 'path';
-export class SessionHistoryWriter {
-    historyPath;
-    constructor(sessionsDir, sessionId) {
-        const sessionDir = join(sessionsDir, sessionId);
-        if (!existsSync(sessionDir)) {
-            mkdirSync(sessionDir, { recursive: true });
-        }
-        this.historyPath = join(sessionDir, 'history.jsonl');
-    }
-    append(msg) {
-        appendFileSync(this.historyPath, JSON.stringify(msg) + '\n', 'utf-8');
-    }
-}

package/dist/modules/context/index.js

@@ -1,2 +0,0 @@
-// Контекст диалога: реэкспорт менеджера истории, компакции и бюджетов.
-export { ContextManager } from "./manager";