micro-models-agent 2.16.1 → 2.17.2

package/dist/modules/reasoning/probe.js

@@ -1,116 +0,0 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
-import { join, dirname } from "path";
-import { globalMmaDir } from "../../config/paths";
-import { readEnv } from "../../config/env";
-import { REASONING_CACHE_TTL_MS as CACHE_TTL_MS } from "../../config/timeouts";
-const PROBE_MESSAGES = [
-    { role: "user", content: "Reply with exactly: ok" },
-];
-/** Путь дискового кэша: ~/.mma/reasoning-cache.json (переопределяется MMA_REASONING_CACHE). */
-function cachePath() {
-    return readEnv("REASONING_CACHE") ?? join(globalMmaDir(), "reasoning-cache.json");
-}
-/** In-memory L1-кэш (быстрый путь в пределах процесса). */
-const memCache = new Map();
-/**
- * Проверяет, уважает ли бэкенд механизм reasoning effort.
- * Шлёт тривиальный запрос с уровнем "none": если reasoning_content всё равно
- * появился — механизм игнорируется.
- * @returns `true` — механизм уважается, `false` — игнорируется,
- *          `null` — транзиентная ошибка (вызывающий НЕ должен кэшировать).
- */
-export async function probeReasoningSupport(provider, strategy, signal) {
-    if (strategy === "none")
-        return false;
-    // "openai-effort" — стандартное поле OpenAI. Sentinel "none", которым проба
-    // измеряет подавление, транспорт вырезает (strict OpenAI на "none" отвечает
-    // 400), поэтому измерить нечем — считаем механизм поддерживаемым. Если
-    // бэкенд поле игнорирует, это безопасно (effort просто не влияет).
-    if (strategy === "openai-effort")
-        return true;
-    try {
-        let hasReasoning = false;
-        for await (const chunk of provider.chat(PROBE_MESSAGES, undefined, signal, {
-            maxTokens: 32,
-            reasoningEffort: "none",
-            reasoningStrategy: strategy,
-        })) {
-            if (chunk.type === "reasoning")
-                hasReasoning = true;
-        }
-        // reasoning_content появился вопреки "none" — механизм игнорируется
-        return !hasReasoning;
-    }
-    catch {
-        // Транзиентная ошибка (сеть/авторизация/стрим) — НЕ сообщаем "не поддерживается".
-        // Возврат null запрещает вызывающему кэшировать, чтобы разовый сбой
-        // не отключал reasoning-механизм на весь 24ч TTL.
-        return null;
-    }
-}
-/** Ключ кэша пробы: baseUrl + модель. */
-export function cacheKey(baseUrl, model) {
-    return `${baseUrl}|${model}`;
-}
-/**
- * Читает кэшированный результат пробы. Сначала память, потом диск.
- * Возвращает `undefined` при промахе или протухании (>24ч).
- */
-export function getCachedProbeResult(key) {
-    // L1: память
-    const mem = memCache.get(key);
-    if (mem && Date.now() - mem.ts < CACHE_TTL_MS) {
-        return mem.result;
-    }
-    // L2: диск
-    const disk = readDiskCache();
-    const entry = disk[key];
-    if (entry) {
-        const age = Date.now() - new Date(entry.ts).getTime();
-        if (age < CACHE_TTL_MS) {
-            memCache.set(key, { result: entry.result, ts: Date.now() });
-            return entry.result;
-        }
-    }
-    return undefined;
-}
-/**
- * Кладет результат пробы в память и на диск.
- */
-export function setCachedProbeResult(key, result) {
-    const now = new Date().toISOString();
-    memCache.set(key, { result, ts: Date.now() });
-    const disk = readDiskCache();
-    disk[key] = { result, ts: now };
-    writeDiskCache(disk);
-}
-/** Сбрасывает кэш пробы (память + дисковый файл). */
-export function resetProbeCache() {
-    memCache.clear();
-    const path = cachePath();
-    if (existsSync(path)) {
-        writeFileSync(path, "{}", "utf-8");
-    }
-}
-function readDiskCache() {
-    try {
-        const path = cachePath();
-        if (existsSync(path)) {
-            return JSON.parse(readFileSync(path, "utf-8"));
-        }
-    }
-    catch {
-        // Битый кэш — начинаем с чистого
-    }
-    return {};
-}
-function writeDiskCache(data) {
-    try {
-        const path = cachePath();
-        mkdirSync(dirname(path), { recursive: true });
-        writeFileSync(path, JSON.stringify(data, null, 2), "utf-8");
-    }
-    catch {
-        // Best-effort: сбой записи на диск не должен ронять агента
-    }
-}

package/dist/modules/registry.js

@@ -1,48 +0,0 @@
-export class ModuleRegistry {
-    modules = new Map();
-    register(mod) {
-        this.modules.set(mod.name, mod);
-        return this;
-    }
-    get(name) {
-        return this.modules.get(name);
-    }
-    listModules() {
-        return Array.from(this.modules.keys()).sort();
-    }
-    collectPromptBlocks(exclude = []) {
-        const blocks = [];
-        for (const [name, mod] of this.modules) {
-            if (exclude.includes(name))
-                continue;
-            if (mod.getSystemPromptBlock) {
-                const block = mod.getSystemPromptBlock();
-                if (block)
-                    blocks.push(block);
-            }
-        }
-        return blocks;
-    }
-    collectToolDefinitions() {
-        const tools = [];
-        for (const mod of this.modules.values()) {
-            if (mod.getToolDefinitions) {
-                const defs = mod.getToolDefinitions();
-                if (defs)
-                    tools.push(...defs);
-            }
-        }
-        return tools;
-    }
-    collectPlugins() {
-        const plugins = [];
-        for (const mod of this.modules.values()) {
-            if (mod.getPlugin) {
-                const plugin = mod.getPlugin();
-                if (plugin)
-                    plugins.push(plugin);
-            }
-        }
-        return plugins;
-    }
-}

package/dist/modules/security/audit-log.js

@@ -1,119 +0,0 @@
-// Аудит-лог: запись действий агента в audit.jsonl (глобально или в каталог сессии).
-import { existsSync, mkdirSync, appendFileSync } from "fs";
-import { globalAuditNotifier } from "./audit-notifier";
-import { auditLogFile, globalLogsDir } from "../../config/paths";
-let _globalAuditDir = globalLogsDir();
-let _sessionAuditDir = null;
-function getAuditDir() {
-    return _sessionAuditDir ?? _globalAuditDir;
-}
-/**
- * Назначить каталог аудита для сессии: записи идут туда вместо глобального.
- */
-export function setAuditSessionDir(dir) {
-    _sessionAuditDir = dir;
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true, mode: 0o700 });
-    }
-}
-/** Сбросить каталог сессии — возврат к глобальному каталогу аудита. */
-export function clearAuditSessionDir() {
-    _sessionAuditDir = null;
-}
-/** Назначить глобальный каталог аудита (когда каталог сессии не активен). */
-export function setGlobalAuditDir(dir) {
-    _globalAuditDir = dir;
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true, mode: 0o700 });
-    }
-}
-/**
- * Записать запись аудита в audit.jsonl и уведомить notifier.
- * Ошибки записи/уведомления глушатся — аудит не должен ронять агента.
- */
-export function logAudit(entry) {
-    const dir = getAuditDir();
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true, mode: 0o700 });
-    }
-    try {
-        const logEntry = JSON.stringify(entry);
-        appendFileSync(auditLogFile(dir), `${logEntry}\n`, "utf8");
-    }
-    catch {
-        // молча: невозможность записи не должна ломать агента
-    }
-    // Уведомить нотификатор аудита, если включён
-    try {
-        globalAuditNotifier.notify(entry);
-    }
-    catch {
-        // молча: падение нотификации не должно ломать агента
-    }
-}
-/** Залогировать вызов тула. */
-export function logToolCall(sessionId, tool, success, details) {
-    logAudit({
-        timestamp: new Date().toISOString(),
-        sessionId,
-        action: "tool_call",
-        tool,
-        success,
-        details,
-    });
-}
-/** Залогировать запись файла. */
-export function logFileWrite(sessionId, path, success, details) {
-    logAudit({
-        timestamp: new Date().toISOString(),
-        sessionId,
-        action: "file_write",
-        path,
-        success,
-        details,
-    });
-}
-/** Залогировать удаление файла. */
-export function logFileDelete(sessionId, path, success, details) {
-    logAudit({
-        timestamp: new Date().toISOString(),
-        sessionId,
-        action: "file_delete",
-        path,
-        success,
-        details,
-    });
-}
-/** Залогировать выполнение bash-команды. */
-export function logBashCommand(sessionId, command, success, details) {
-    logAudit({
-        timestamp: new Date().toISOString(),
-        sessionId,
-        action: "bash_command",
-        command,
-        success,
-        details,
-    });
-}
-/** Залогировать сетевой запрос. */
-export function logNetworkRequest(sessionId, url, success, details) {
-    logAudit({
-        timestamp: new Date().toISOString(),
-        sessionId,
-        action: "network_request",
-        url,
-        success,
-        details,
-    });
-}
-/** Залогировать срабатывание security-блока. */
-export function logSecurityBlock(sessionId, _action, reason, details) {
-    logAudit({
-        timestamp: new Date().toISOString(),
-        sessionId,
-        action: "security_block",
-        success: false,
-        reason,
-        details,
-    });
-}

package/dist/modules/security/audit-notifier.js

@@ -1,267 +0,0 @@
-// Нотификации о security-событиях: файл + webhook с ретраями и очередью.
-import { writeFileSync, appendFileSync, existsSync, mkdirSync } from "fs";
-import { join, dirname } from "path";
-import { backoffDelay } from "../../utils/retry";
-import { defaultOutputBus } from "../../output";
-/** Веса severity для сравнения. */
-const SEVERITY_WEIGHTS = {
-    low: 1,
-    medium: 2,
-    high: 3,
-    critical: 4,
-};
-/** Дефолтный конфиг нотификатора (выключен). */
-export const DEFAULT_AUDIT_NOTIFIER_CONFIG = {
-    enabled: false,
-    filePath: join(globalLogsDir(), "audit-notifications.jsonl"),
-    webhookTimeout: 5000,
-    minSeverity: "medium",
-    eventTypes: [
-        "security_block",
-        "bash_command",
-        "file_operation",
-        "network_request",
-        "authentication",
-        "configuration_change",
-    ],
-    maxRetries: 3,
-};
-/** Нотификатор security-событий: файл + webhook с ретраями. */
-export class AuditNotifier {
-    config;
-    retryQueue = [];
-    isProcessing = false;
-    constructor(config) {
-        this.config = { ...DEFAULT_AUDIT_NOTIFIER_CONFIG, ...config };
-        this.ensureLogDirectory();
-    }
-    /** Включён ли нотификатор. */
-    isEnabled() {
-        return this.config.enabled;
-    }
-    /** Включить нотификатор. */
-    enable() {
-        this.config.enabled = true;
-    }
-    /** Выключить нотификатор. */
-    disable() {
-        this.config.enabled = false;
-    }
-    /** Обновить конфиг. */
-    updateConfig(config) {
-        this.config = { ...this.config, ...config };
-        this.ensureLogDirectory();
-    }
-    /** Гарантировать каталог лога. */
-    ensureLogDirectory() {
-        if (this.config.filePath) {
-            const dir = dirname(this.config.filePath);
-            mkdirSync(dir, { recursive: true });
-        }
-    }
-    /** Подпадает ли тип события под нотификацию. */
-    shouldNotify(eventType) {
-        if (!this.config.enabled)
-            return false;
-        return this.config.eventTypes?.includes(eventType) ?? false;
-    }
-    /** Дотягивает ли severity до порога. */
-    shouldNotifySeverity(severity) {
-        const minSeverity = this.config.minSeverity ?? "medium";
-        const minWeight = SEVERITY_WEIGHTS[minSeverity];
-        const eventWeight = SEVERITY_WEIGHTS[severity];
-        return eventWeight >= minWeight;
-    }
-    /** Нотифицировать аудит-событие: файл + webhook, падение — в retry-очередь. */
-    async notify(entry) {
-        if (!this.config.enabled)
-            return null;
-        const eventType = this.mapEventType(entry.action);
-        if (!eventType || !this.shouldNotify(eventType))
-            return null;
-        const severity = this.determineSeverity(entry);
-        if (!this.shouldNotifySeverity(severity))
-            return null;
-        const notification = {
-            timestamp: new Date().toISOString(),
-            eventType,
-            severity,
-            message: entry.details || entry.reason || entry.action,
-            details: entry.details ? { details: entry.details } : undefined,
-            sessionId: entry.sessionId,
-        };
-        // Пишем в файл
-        this.writeToFile(notification);
-        // Шлём в webhook, если задан
-        if (this.config.webhookUrl) {
-            try {
-                await this.sendToWebhook(notification);
-            }
-            catch (error) {
-                defaultOutputBus.log("warn", "audit", `[AuditNotifier] Webhook failed, adding to retry queue: ${error instanceof Error ? error.message : String(error)}`, { persist: true });
-                this.addToRetryQueue(notification);
-            }
-        }
-        return notification;
-    }
-    /** Маппинг action записи аудита в тип события нотификации. */
-    mapEventType(action) {
-        const typeMap = {
-            tool_call: "tool_call",
-            bash_command: "bash_command",
-            file_write: "file_operation",
-            file_delete: "file_operation",
-            network_request: "network_request",
-            security_block: "security_block",
-        };
-        return typeMap[action] || null;
-    }
-    /** Severity из записи аудита (по типу action). */
-    determineSeverity(entry) {
-        // Дефолтная severity по типу action
-        const typeSeverity = {
-            security_block: "high",
-            bash_command: "high",
-            file_delete: "medium",
-            file_write: "medium",
-            network_request: "medium",
-            tool_call: "low",
-            session_start: "low",
-            session_end: "low",
-        };
-        return typeSeverity[entry.action] || "low";
-    }
-    /** Записать нотификацию в файл. */
-    writeToFile(notification) {
-        if (!this.config.filePath)
-            return;
-        try {
-            const line = JSON.stringify(notification);
-            appendFileSync(this.config.filePath, `${line}\n`, "utf8");
-        }
-        catch (error) {
-            defaultOutputBus.log("error", "audit", `[AuditNotifier] Failed to write to file: ${error instanceof Error ? error.message : String(error)}`, { persist: true });
-        }
-    }
-    /**
-     * Отправить нотификацию в webhook. Падение бросает исключение — политику
-     * ретраев решает вызывающий (notify() кладёт в очередь, processRetryQueue()
-     * считает попытки).
-     */
-    async sendToWebhook(notification) {
-        if (!this.config.webhookUrl)
-            return;
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), this.config.webhookTimeout);
-        try {
-            const response = await fetch(this.config.webhookUrl, {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify(notification),
-                signal: controller.signal,
-            });
-            if (!response.ok) {
-                throw new Error(`Webhook returned ${response.status}`);
-            }
-        }
-        finally {
-            clearTimeout(timeoutId);
-        }
-    }
-    /** Положить нотификацию в retry-очередь. */
-    addToRetryQueue(notification) {
-        this.retryQueue.push({ entry: notification, retries: 0 });
-        if (!this.isProcessing) {
-            this.processRetryQueue();
-        }
-    }
-    /** Разобрать retry-очередь (бэкофф, лимит попыток). */
-    async processRetryQueue() {
-        if (this.retryQueue.length === 0 || this.isProcessing)
-            return;
-        this.isProcessing = true;
-        try {
-            while (this.retryQueue.length > 0) {
-                const item = this.retryQueue[0];
-                if (item.retries >= (this.config.maxRetries ?? 3)) {
-                    defaultOutputBus.log("error", "audit", `[AuditNotifier] Max retries exceeded for notification: ${JSON.stringify(item.entry)}`, { persist: true });
-                    this.retryQueue.shift();
-                    continue;
-                }
-                try {
-                    await this.sendToWebhook(item.entry);
-                    this.retryQueue.shift();
-                }
-                catch (error) {
-                    // sendToWebhook сам в очередь не кладёт — счётчик ретраев реально
-                    // растёт, и maxRetries достижим.
-                    item.retries++;
-                    defaultOutputBus.log("warn", "audit", `[AuditNotifier] Webhook retry ${item.retries} failed: ${error instanceof Error ? error.message : String(error)}`, { persist: true });
-                    // Экспоненциальный бэкофф перед следующей попыткой того же head-элемента.
-                    const delay = backoffDelay(item.retries, 1000);
-                    await new Promise((resolve) => setTimeout(resolve, delay));
-                }
-            }
-        }
-        finally {
-            this.isProcessing = false;
-        }
-    }
-    /** Прочитать нотификации из файла (последние N). */
-    readNotifications(limit = 100) {
-        if (!this.config.filePath || !existsSync(this.config.filePath)) {
-            return [];
-        }
-        try {
-            const content = readFileSync(this.config.filePath, "utf8");
-            const lines = content.split("\n").filter(Boolean);
-            return lines.slice(-limit).map((line) => JSON.parse(line));
-        }
-        catch (error) {
-            defaultOutputBus.log("error", "audit", `[AuditNotifier] Failed to read notifications: ${error instanceof Error ? error.message : String(error)}`, { persist: true });
-            return [];
-        }
-    }
-    /** Очистить нотификации (файл + очередь). */
-    clearNotifications() {
-        if (this.config.filePath) {
-            writeFileSync(this.config.filePath, "", "utf8");
-        }
-        this.retryQueue = [];
-    }
-    /** Статистика нотификаций: всего, по severity, по типам. */
-    getStats() {
-        const notifications = this.readNotifications();
-        const bySeverity = { low: 0, medium: 0, high: 0, critical: 0 };
-        const byType = {
-            tool_call: 0,
-            tool_result: 0,
-            bash_command: 0,
-            file_operation: 0,
-            network_request: 0,
-            security_block: 0,
-            authentication: 0,
-            configuration_change: 0,
-            session_start: 0,
-            session_end: 0,
-        };
-        for (const n of notifications) {
-            bySeverity[n.severity] = (bySeverity[n.severity] || 0) + 1;
-            byType[n.eventType] = (byType[n.eventType] || 0) + 1;
-        }
-        return {
-            total: notifications.length,
-            bySeverity,
-            byType,
-        };
-    }
-}
-/** Глобальный инстанс нотификатора аудита. */
-export const globalAuditNotifier = new AuditNotifier();
-/** Создать нотификатор аудита с кастомным конфигом. */
-export function createAuditNotifier(config) {
-    return new AuditNotifier(config);
-}
-// Импорт readFileSync для readNotifications
-import { readFileSync } from "fs";
-import { globalLogsDir } from "../../config/paths";