micro-models-agent 2.16.0 → 2.17.1

package/dist/llm/token-counter.js

@@ -1,83 +0,0 @@
-/** Подсчёт токенов: точный (tiktoken) и дешёвая эвристика для блоков. */
-import { encodingForModel, getEncoding } from "js-tiktoken";
-import { getMessageText } from "./provider";
-/**
- * Скриптозависимая ОЦЕНКА токенов (дешёвая, без полной токенизации). Достаточно
- * дешёвая для каждого PromptBlock; на этапе сборки точного TokenCounter может
- * не быть в scope. Замерено на cl100k_base: латиница И кириллица — ~3.3–5
- * символов/токен (старый плоский len/4 для кириллицы был почти верен —
- * гипотеза «кириллица ≈ /2» ошибочна); CJK/хангыль — выбросы ~1–1.5 токена/
- * символ, им /1.5. В пределах ±30% от tiktoken на русском.
- */
-export function estimateTokens(text) {
-    if (!text)
-        return 0;
-    let cjk = 0;
-    let rest = 0;
-    for (const ch of text) {
-        const code = ch.codePointAt(0);
-        if ((code >= 0x3000 && code <= 0x9fff) || // CJK unified + symbols
-            (code >= 0xac00 && code <= 0xd7af) || // Hangul syllables
-            (code >= 0xff00 && code <= 0xffef) // fullwidth forms
-        ) {
-            cjk++;
-        }
-        else {
-            rest++;
-        }
-    }
-    return Math.ceil(cjk / 1.5 + rest / 4);
-}
-/** Точный счётчик токенов поверх tiktoken (энкодинг по модели). */
-export class TokenCounter {
-    encoder;
-    constructor(model = "gpt-4o") {
-        try {
-            this.encoder = encodingForModel(model);
-        }
-        catch {
-            // Фолбэк на cl100k_base для неизвестных моделей
-            this.encoder = getEncoding("cl100k_base");
-        }
-    }
-    /**
-     * Считает токены текста.
-     * @param text текст; @returns число токенов.
-     */
-    count(text) {
-        if (!text)
-            return 0;
-        return this.encoder.encode(text).length;
-    }
-    /**
-     * Считает токены сообщений с оверхедом ролей/границ (~4/сообщение).
-     * @param messages сообщения чата; @returns суммарные токены.
-     */
-    countMessages(messages) {
-        let total = 0;
-        for (const msg of messages) {
-            // ~4 токена оверхеда на сообщение (роль, границы)
-            total += 4;
-            const text = getMessageText(msg.content);
-            total += this.count(text);
-            if (msg.role === "tool")
-                total += 2; // tool_call_id
-        }
-        total += 2; // прайминг ассистента
-        return total;
-    }
-    /**
-     * Кодирует текст в токены.
-     * @param text текст; @returns массив id токенов.
-     */
-    encode(text) {
-        return this.encoder.encode(text);
-    }
-    /**
-     * Декодирует токены в текст.
-     * @param tokens id токенов; @returns текст.
-     */
-    decode(tokens) {
-        return this.encoder.decode(tokens);
-    }
-}

package/dist/llm/types.js

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

package/dist/logger/app-logger.js

@@ -1,212 +0,0 @@
-// Логер: шина вывода + файловые логи (.log, app.jsonl), чистка секретов.
-import { appendFileSync, mkdirSync, existsSync } from "fs";
-import { join } from "path";
-import { sanitizeLogMessage } from "../modules/security/data-sanitizer";
-import { FileLogWriter } from "./file-log";
-import { defaultOutputBus } from "../output";
-const LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
-/** Центральный логер: консоль через шину, файлы, JSONL, тегированные хелперы. */
-export class Logger {
-    level;
-    prefix;
-    logDir = null;
-    sessionDir = null;
-    fileLog;
-    sink;
-    constructor(level = "info", prefix = "", sink = defaultOutputBus) {
-        this.level = level;
-        this.prefix = prefix;
-        this.sink = sink;
-        this.fileLog = new FileLogWriter();
-    }
-    setLevel(level) {
-        this.level = level;
-    }
-    setLogDir(dir) {
-        this.logDir = dir;
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        this.fileLog.setLogDir(dir);
-    }
-    setSessionDir(dir) {
-        this.sessionDir = dir;
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-    }
-    clearSessionDir() {
-        this.sessionDir = null;
-    }
-    /** Открывает посессионный `.log`-файл (поведение legacy v1). */
-    initSessionLog(sessionId) {
-        this.fileLog.initSessionLog(sessionId);
-    }
-    /** Возврат к дневным лог-файлам, когда нет активной сессии. */
-    closeSessionLog() {
-        this.fileLog.closeSessionLog();
-    }
-    /** Путь к текущему лог-файлу (сессионный или дневной). */
-    getLogPath() {
-        return this.fileLog.getLogPath();
-    }
-    /** Удаляет старые логи по возрасту/количеству. */
-    cleanupOldLogs(maxDays, maxFiles) {
-        this.fileLog.cleanupOldLogs(maxDays, maxFiles);
-    }
-    // Тегированные хелперы (API legacy v1).
-    /** Пишет запрос к LLM в файловый лог. */
-    logLLMRequest(model, messagesCount, promptPreview, caller) {
-        this.fileLog.logLLMRequest(model, messagesCount, sanitizeLogMessage(promptPreview), caller);
-    }
-    /** Пишет ответ LLM (или ошибку) в файловый лог. */
-    logLLMResponse(model, responseLength, genTimeMs, error, caller) {
-        this.fileLog.logLLMResponse(model, responseLength, genTimeMs, error, caller);
-    }
-    /** Пишет вызов тула и превью результата в файловый лог. */
-    logToolCall(tool, preview, result) {
-        this.fileLog.logToolCall(tool, sanitizeLogMessage(preview), result !== undefined ? sanitizeLogMessage(result) : undefined);
-    }
-    /** Пишет вывод тула с кодом выхода в файловый лог. */
-    logToolOutput(tool, output, exitCode) {
-        this.fileLog.logToolOutput(tool, sanitizeLogMessage(output), exitCode);
-    }
-    /** Пишет реплику REPL (user/assistant/system) в файловый лог. */
-    logREPL(tag, content) {
-        this.fileLog.logREPL(tag, sanitizeLogMessage(content));
-    }
-    /**
-     * Дочерний логер с расширенным префиксом; наследует уровень, sink и каталоги.
-     * @param prefix суффикс префикса. @returns новый Logger.
-     */
-    child(prefix) {
-        const childLogger = new Logger(this.level, this.prefix ? `${this.prefix}:${prefix}` : prefix, this.sink);
-        if (this.logDir)
-            childLogger.setLogDir(this.logDir);
-        if (this.sessionDir)
-            childLogger.setSessionDir(this.sessionDir);
-        return childLogger;
-    }
-    debug(msg, meta) {
-        this.log("debug", msg, meta);
-    }
-    info(msg, meta) {
-        this.log("info", msg, meta);
-    }
-    warn(msg, meta) {
-        this.log("warn", msg, meta);
-    }
-    error(msg, meta) {
-        this.log("error", msg, meta);
-    }
-    /**
-     * Внутренняя диагностика петли (ретраи галлюцинаций, аудит/компакция,
-     * вердикты критика, …). Персистентность та же, что у warn/info, но событие
-     * шины несёт `data.diagnostic = true`, и чат дропает его, пока
-     * `ui.verbosity !== "verbose"`.
-     */
-    diagnostic(level, msg, meta) {
-        this.log(level, msg, meta, true);
-    }
-    log(level, msg, meta, diagnostic) {
-        if (LEVELS[level] < LEVELS[this.level])
-            return;
-        // Чистим сообщение — вырезаем секреты.
-        const sanitizedMsg = sanitizeLogMessage(msg);
-        const sanitizedMeta = meta ? this.sanitizeMeta(meta) : undefined;
-        const ts = new Date().toISOString();
-        const metaStr = sanitizedMeta ? ` ${JSON.stringify(sanitizedMeta)}` : "";
-        const line = `${sanitizedMsg}${metaStr}`;
-        try {
-            this.sink.emit({
-                level,
-                source: this.prefix || "mma",
-                kind: "log",
-                text: line,
-                data: diagnostic ? { diagnostic: true } : undefined,
-            });
-        }
-        catch {
-            /* terminal output is best-effort; file logging below must still run */
-        }
-        // Поведение legacy v1: дубль в тегированный `.log` (сессионный или дневной).
-        this.fileLog.log(level.toUpperCase(), this.prefix || "MMA", `${ts} — ${sanitizedMsg}${metaStr}`);
-        const logTarget = this.sessionDir ?? this.logDir;
-        if (logTarget) {
-            try {
-                appendFileSync(join(logTarget, "app.jsonl"), `${JSON.stringify({
-                    level,
-                    ts,
-                    prefix: this.prefix,
-                    msg: sanitizedMsg,
-                    meta: sanitizedMeta ?? null,
-                })}\n`, "utf-8");
-            }
-            catch {
-                /* file logging is best-effort */
-            }
-        }
-    }
-    /** Рекурсивно чистит секреты в объекте метаданных. */
-    sanitizeMeta(meta) {
-        const sanitized = {};
-        for (const [key, value] of Object.entries(meta)) {
-            if (typeof value === "string") {
-                sanitized[key] = sanitizeLogMessage(value);
-            }
-            else if (typeof value === "object" && value !== null) {
-                sanitized[key] = this.sanitizeMeta(value);
-            }
-            else {
-                sanitized[key] = value;
-            }
-        }
-        return sanitized;
-    }
-    /**
-     * Структурная запись только в app.jsonl (без консоли и .log).
-     * Для машиночитаемых отчётов (окружение и т.п.), слишком шумных для терминала,
-     * но ценных для кросс-девайс диагностики.
-     */
-    logStructured(type, data) {
-        const logTarget = this.sessionDir ?? this.logDir;
-        if (!logTarget)
-            return;
-        try {
-            appendFileSync(join(logTarget, "app.jsonl"), `${JSON.stringify({
-                level: "info",
-                ts: new Date().toISOString(),
-                type,
-                meta: this.sanitizeMeta(data),
-            })}\n`, "utf-8");
-        }
-        catch {
-            /* file logging is best-effort */
-        }
-    }
-    /**
-     * Запись только в app.jsonl — без консоли и .log. Для шумных подсистем
-     * (LSP, пробники): предупреждения диагностируются по файлам сессии,
-     * но не мусорят в терминале.
-     */
-    logSilent(level, msg, meta) {
-        const logTarget = this.sessionDir ?? this.logDir;
-        if (!logTarget)
-            return;
-        const ts = new Date().toISOString();
-        const sanitizedMsg = sanitizeLogMessage(msg);
-        const sanitizedMeta = meta ? this.sanitizeMeta(meta) : undefined;
-        try {
-            appendFileSync(join(logTarget, "app.jsonl"), `${JSON.stringify({
-                level,
-                ts,
-                prefix: this.prefix,
-                msg: sanitizedMsg,
-                meta: sanitizedMeta ?? null,
-            })}\n`, "utf-8");
-        }
-        catch {
-            /* file logging is best-effort */
-        }
-    }
-}

package/dist/logger/file-log.js

@@ -1,160 +0,0 @@
-// Файловый логер legacy v1: тегированные строки, ротация, чистка старых логов.
-import { appendFileSync, mkdirSync, existsSync, readdirSync, renameSync, statSync, unlinkSync, } from "node:fs";
-import { join } from "node:path";
-const MAX_LOG_SIZE = 5 * 1024 * 1024;
-const MAX_LOG_FILES = 30;
-const DEFAULT_MAX_DAYS = 30;
-const TOOL_OUTPUT_LIMIT = 2000;
-/**
- * Тегированный файловый логер (поведение legacy MMA v1).
- *
- * Пишет читаемые строки в `~/.mma/logs/`:
- * - `<sessionId>.log`, пока сессия активна;
- * - `YYYY-MM-DD.log` для всего вне сессии.
- *
- * Фичи из v1:
- * - ротация по размеру (5 МБ → file.log.1, file.log.2, …);
- * - чистка старых логов (возраст + лимит файлов);
- * - тегированные хелперы: запрос/ответ LLM, вызовы тулов, REPL.
- */
-export class FileLogWriter {
-    logDir = null;
-    sessionLogPath = null;
-    /** Задаёт каталог логов (создаёт при отсутствии). */
-    setLogDir(dir) {
-        this.logDir = dir;
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-    }
-    /** Открывает посессионный лог-файл. Триггерит чистку старых логов. */
-    initSessionLog(sessionId) {
-        if (!this.logDir)
-            return;
-        if (!existsSync(this.logDir)) {
-            mkdirSync(this.logDir, { recursive: true });
-        }
-        this.sessionLogPath = join(this.logDir, `${sessionId}.log`);
-        this.cleanupOldLogs();
-    }
-    /** Возврат к дневным лог-файлам, когда нет активной сессии. */
-    closeSessionLog() {
-        this.sessionLogPath = null;
-    }
-    /** Путь к текущему лог-файлу (сессионный или дневной). */
-    getLogPath() {
-        if (this.sessionLogPath)
-            return this.sessionLogPath;
-        if (!this.logDir)
-            return "";
-        const date = new Date().toISOString().slice(0, 10);
-        return join(this.logDir, `${date}.log`);
-    }
-    /** Ротирует файл при превышении лимита размера. */
-    rotateIfNeeded(filePath) {
-        if (!existsSync(filePath))
-            return;
-        const size = statSync(filePath).size;
-        if (size < MAX_LOG_SIZE)
-            return;
-        let idx = 1;
-        while (existsSync(`${filePath}.${idx}`))
-            idx++;
-        renameSync(filePath, `${filePath}.${idx}`);
-    }
-    /** Пишет одну строку. Файловый лог — best-effort, ошибки глотаются. */
-    log(level, tag, message) {
-        const fp = this.getLogPath();
-        if (!fp)
-            return;
-        if (this.logDir && !existsSync(this.logDir)) {
-            mkdirSync(this.logDir, { recursive: true });
-        }
-        this.rotateIfNeeded(fp);
-        const line = `[${new Date().toISOString()}] [${level}] [${tag}] ${message}\n`;
-        try {
-            appendFileSync(fp, line, "utf-8");
-        }
-        catch {
-            /* file logging is best-effort */
-        }
-    }
-    /** Пишет запрос к LLM (модель, число сообщений, превью промпта). */
-    logLLMRequest(model, messagesCount, promptPreview, caller) {
-        const tag = caller ? `LLM/${caller}` : "LLM";
-        this.log("INFO", tag, `→ ${model} | ${messagesCount} messages | "${promptPreview.slice(0, 100)}"`);
-    }
-    /** Пишет ответ LLM (длина, время) или ошибку. */
-    logLLMResponse(model, responseLength, genTimeMs, error, caller) {
-        const tag = caller ? `LLM/${caller}` : "LLM";
-        if (error) {
-            this.log("ERROR", tag, `← ${model} | ${responseLength} chars | ${genTimeMs}ms | ERROR: ${error}`);
-        }
-        else {
-            this.log("INFO", tag, `← ${model} | ${responseLength} chars | ${genTimeMs}ms`);
-        }
-    }
-    /** Пишет вызов тула с обрезанными превью аргументов и результата. */
-    logToolCall(tool, preview, result) {
-        const previewTrimmed = preview.length > 200 ? `${preview.slice(0, 200)}...` : preview;
-        if (result !== undefined) {
-            const resultTrimmed = result.length > 200 ? `${result.slice(0, 200)}...` : result;
-            this.log("INFO", "TOOL", `${tool} | ${previewTrimmed} → ${resultTrimmed}`);
-        }
-        else {
-            this.log("INFO", "TOOL", `${tool} | ${previewTrimmed}`);
-        }
-    }
-    /** Пишет вывод тула с кодом выхода (тело режется лимитом). */
-    logToolOutput(tool, output, exitCode) {
-        const trimmed = output.length > TOOL_OUTPUT_LIMIT
-            ? output.slice(0, TOOL_OUTPUT_LIMIT) +
-                `\n... (truncated ${output.length - TOOL_OUTPUT_LIMIT} chars)`
-            : output;
-        this.log("DEBUG", "TOOL_OUTPUT", `${tool} exit:${exitCode}\n${trimmed}`);
-    }
-    /** Пишет реплику REPL (тело режется до 400 символов). */
-    logREPL(tag, content) {
-        const trimmed = content.length > 400 ? `${content.slice(0, 400)}...` : content;
-        this.log("INFO", `REPL/${tag}`, trimmed);
-    }
-    /**
-     * Чистит старые лог-файлы.
-     * - удаляет старше maxDays;
-     * - оставляет не более maxFiles самых свежих .log-файлов.
-     */
-    cleanupOldLogs(maxDays = DEFAULT_MAX_DAYS, maxFiles = MAX_LOG_FILES) {
-        if (!this.logDir || !existsSync(this.logDir))
-            return;
-        const now = Date.now();
-        const list = () => readdirSync(this.logDir)
-            .filter((f) => f.endsWith(".log") || /\.log\.\d+$/.test(f))
-            .map((f) => ({
-            name: f,
-            path: join(this.logDir, f),
-            mtime: statSync(join(this.logDir, f)).mtimeMs,
-        }))
-            .sort((a, b) => b.mtime - a.mtime);
-        // 1. Удаление по возрасту.
-        for (const f of list()) {
-            if (now - f.mtime > maxDays * 24 * 60 * 60 * 1000) {
-                try {
-                    unlinkSync(f.path);
-                }
-                catch {
-                    /* ignore */
-                }
-            }
-        }
-        // 2. Удаление излишков (свежие, но сверх maxFiles).
-        const remaining = list();
-        for (let i = maxFiles; i < remaining.length; i++) {
-            try {
-                unlinkSync(remaining[i].path);
-            }
-            catch {
-                /* ignore */
-            }
-        }
-    }
-}

package/dist/logger/index.js

@@ -1,2 +0,0 @@
-// Логер приложения: единая точка логирования (терминал, файлы, JSONL).
-export { Logger } from "./app-logger";

package/dist/migration/backup.js

@@ -1,56 +0,0 @@
-// Бэкапы перед миграцией: config.json.bak и копия всего configDir.
-import { copyFileSync, cpSync, existsSync, mkdirSync, readdirSync, writeFileSync } from "fs";
-import { join } from "path";
-import { t } from "../i18n/index";
-import { defaultOutputBus } from "../output";
-/** Делает бэкапы конфига перед миграцией v1 → v2. */
-export class BackupManager {
-    configDir;
-    constructor(configDir) {
-        this.configDir = configDir;
-    }
-    /** Копия config.json в config.json.bak. Нет файла — ничего не делает. */
-    backupConfig() {
-        const configPath = join(this.configDir, "config.json");
-        if (!existsSync(configPath))
-            return;
-        const bakPath = join(this.configDir, "config.json.bak");
-        copyFileSync(configPath, bakPath);
-    }
-    /** Рекурсивная копия всего configDir в `<dir>.bak` (один раз, не перезаписывает). */
-    backupAll() {
-        const bakDir = `${this.configDir}.bak`;
-        if (existsSync(bakDir)) {
-            // Повторная миграция не перезаписывает бэкап — фиксируем в логе, чтобы
-            // «нет бэкапа за этот запуск» не выглядело как потеря данных.
-            defaultOutputBus.log("debug", "migration", `Backup already exists at ${bakDir}; keeping the previous state (not overwritten).`);
-            return;
-        }
-        if (existsSync(this.configDir)) {
-            cpSync(this.configDir, bakDir, { recursive: true });
-        }
-    }
-    /** Пишет свежий конфиг v2 в config.json (создаёт каталог при нужде). */
-    writeFreshConfig(config) {
-        if (!existsSync(this.configDir)) {
-            mkdirSync(this.configDir, { recursive: true });
-        }
-        writeFileSync(join(this.configDir, "config.json"), JSON.stringify(config, null, 2), "utf-8");
-    }
-    /** Человекочитаемая сводка: какие бэкапы есть, или что миграция не нужна. */
-    getBackupSummary() {
-        const lines = [];
-        const bakConfig = join(this.configDir, "config.json.bak");
-        const bakDir = `${this.configDir}.bak`;
-        if (existsSync(bakConfig)) {
-            lines.push(t("migration.config_bak"));
-        }
-        if (existsSync(bakDir)) {
-            const files = readdirSync(bakDir);
-            lines.push(t("migration.dir_bak", { count: files.length }));
-        }
-        return lines.length > 0
-            ? `${t("migration.migrated")}\n${lines.join("\n")}`
-            : t("migration.not_needed");
-    }
-}

package/dist/migration/detect.js

@@ -1,61 +0,0 @@
-// Детект необходимости миграции: отличает конфиг v1 от v2 и битого файла.
-import { existsSync, readFileSync, readdirSync } from "fs";
-import { join } from "path";
-const V1_ONLY_FIELDS = ["apiBase", "apiKey", "chatEndpoint", "temperature", "maxTokens"];
-/** Проверяет, лежит ли в configDir конфиг формата v1. Битый файл — не v1. */
-export class MigrationDetector {
-    configDir;
-    constructor(configDir) {
-        this.configDir = configDir;
-    }
-    /**
-     * Нужна ли миграция: есть v1-поля или нет всех обязательных v2-полей.
-     * Битый/вручную правленный конфиг — не повод: loadConfig предупредит
-     * и откатится на дефолты, файл не трогаем.
-     */
-    needsMigration() {
-        const configPath = join(this.configDir, "config.json");
-        if (!existsSync(configPath))
-            return false;
-        try {
-            const content = readFileSync(configPath, "utf-8");
-            const config = JSON.parse(content);
-            if (config.version?.startsWith("2."))
-                return false;
-            for (const field of V1_ONLY_FIELDS) {
-                if (field in config)
-                    return true;
-            }
-            const v2Required = ["provider", "contextWindow", "contextBudget"];
-            const hasAllV2Fields = v2Required.every((f) => f in config);
-            if (!hasAllV2Fields)
-                return true;
-            return false;
-        }
-        catch {
-            // Битый или вручную правленный конфиг — НЕ v1, удалять нельзя.
-            // loadConfig предупредит и откатится на дефолты.
-            return false;
-        }
-    }
-    /** Есть ли старые сессии в каталоге sessions. */
-    hasOldSessions() {
-        const sessionsDir = join(this.configDir, "sessions");
-        if (!existsSync(sessionsDir))
-            return false;
-        return readdirSync(sessionsDir).length > 0;
-    }
-    /** Профиль старого формата: есть profile.json без полей platform/os. */
-    hasOldProfile() {
-        const profilePath = join(this.configDir, "profile.json");
-        if (!existsSync(profilePath))
-            return false;
-        try {
-            const profile = JSON.parse(readFileSync(profilePath, "utf-8"));
-            return !profile.platform && !profile.os;
-        }
-        catch {
-            return false;
-        }
-    }
-}

package/dist/migration/index.js

@@ -1,3 +0,0 @@
-// Миграция конфига v1 → v2: детект устаревшего формата и бэкапы.
-export { MigrationDetector } from "./detect";
-export { BackupManager } from "./backup";

package/dist/modules/artifacts/store.js

@@ -1,62 +0,0 @@
-// Хранилище артефактов сессии: запись/чтение файлов в <baseDir>/.mma/artifacts/<sessionId>.
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { resolve, relative, isAbsolute } from "node:path";
-/** Файловое хранилище артефактов сессии (jail внутри root). */
-export class ArtifactStore {
-    root;
-    constructor(opts) {
-        const artifactsDir = opts.artifactsDir || ".mma/artifacts";
-        this.root = resolve(opts.baseDir, artifactsDir, opts.sessionId);
-    }
-    /** Нормализует имя к [a-zA-Z0-9._-]; никогда не пустое, не "." и не "..". */
-    static sanitizeName(name) {
-        // Срезаем префиксы обхода: "../../etc/passwd" станет "etc_passwd", а не ".._.._etc_passwd".
-        const stripped = name.replace(/^(\.\.?[\\/])+/g, "").replace(/^\.{1,2}$/, "");
-        const cleaned = stripped
-            .replace(/[^a-zA-Z0-9._-]/g, "_")
-            .replace(/_{2,}/g, "_")
-            .replace(/^_+|_+$/g, "");
-        if (cleaned === "" || cleaned === "." || cleaned === "..") {
-            return "artifact";
-        }
-        return cleaned;
-    }
-    /** True, если `candidate` строго внутри `root` (или равен ему). */
-    static isInside(root, candidate) {
-        const rel = relative(root, candidate);
-        if (rel === "")
-            return true;
-        return !rel.startsWith("..") && !isAbsolute(rel);
-    }
-    /**
-     * Сохраняет контент в <root>/<name>.<ext>, возвращает абсолютный путь.
-     * Бросает, если путь выходит за root (defense in depth — sanitizeName уже убрал разделители).
-     */
-    save(name, content, ext = "md") {
-        const safe = ArtifactStore.sanitizeName(name);
-        const dir = resolve(this.root);
-        mkdirSync(dir, { recursive: true });
-        const abs = resolve(dir, `${safe}.${ext}`);
-        if (!ArtifactStore.isInside(dir, abs)) {
-            throw new Error(`Artifact path escapes root: ${abs}`);
-        }
-        writeFileSync(abs, content, "utf8");
-        return abs;
-    }
-    /** Читает артефакт по имени файла (относительно root); null, если вне root или нет файла. */
-    read(path) {
-        const abs = resolve(this.root, path);
-        if (!ArtifactStore.isInside(this.root, abs))
-            return null;
-        if (!existsSync(abs))
-            return null;
-        return readFileSync(abs, "utf8");
-    }
-    /** Первые maxChars символов (обрезанные справа) + маркер усечения. */
-    summary(content, maxChars) {
-        if (content.length <= maxChars)
-            return content;
-        const head = content.slice(0, maxChars).trimEnd();
-        return `${head}\n…[truncated: ${content.length - maxChars} chars]`;
-    }
-}