micro-models-agent 2.11.0 → 2.12.0

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

@@ -1,15 +1,14 @@
+// Аудит-лог: запись действий агента в audit.jsonl (глобально или в каталог сессии).
 import { existsSync, mkdirSync, appendFileSync } from "fs";
-import { resolve, join } from "path";
-import { homedir } from "os";
 import { globalAuditNotifier } from "./audit-notifier";
-let _globalAuditDir = resolve(homedir(), ".mma", "logs");
+import { auditLogFile, globalLogsDir } from "../../config/paths";
+let _globalAuditDir = globalLogsDir();
 let _sessionAuditDir = null;
 function getAuditDir() {
     return _sessionAuditDir ?? _globalAuditDir;
 }
 /**
- * Set the session directory for audit logs. When set, all audit entries
- * are written to the session-specific directory instead of the global one.
+ * Назначить каталог аудита для сессии: записи идут туда вместо глобального.
  */
 export function setAuditSessionDir(dir) {
     _sessionAuditDir = dir;
@@ -17,15 +16,11 @@ export function setAuditSessionDir(dir) {
         mkdirSync(dir, { recursive: true, mode: 0o700 });
     }
 }
-/**
- * Clear the session directory — fall back to global audit dir.
- */
+/** Сбросить каталог сессии — возврат к глобальному каталогу аудита. */
 export function clearAuditSessionDir() {
     _sessionAuditDir = null;
 }
-/**
- * Set the global audit log directory (used when no session dir is active).
- */
+/** Назначить глобальный каталог аудита (когда каталог сессии не активен). */
 export function setGlobalAuditDir(dir) {
     _globalAuditDir = dir;
     if (!existsSync(dir)) {
@@ -33,7 +28,8 @@ export function setGlobalAuditDir(dir) {
     }
 }
 /**
- * Write an audit log entry
+ * Записать запись аудита в audit.jsonl и уведомить notifier.
+ * Ошибки записи/уведомления глушатся — аудит не должен ронять агента.
  */
 export function logAudit(entry) {
     const dir = getAuditDir();
@@ -42,23 +38,20 @@ export function logAudit(entry) {
     }
     try {
         const logEntry = JSON.stringify(entry);
-        appendFileSync(join(dir, "audit.jsonl"), logEntry + "\n", "utf8");
+        appendFileSync(auditLogFile(dir), `${logEntry}\n`, "utf8");
     }
     catch {
-        // Silently fail if we can't write to audit log
-        // This shouldn't break the agent
+        // молча: невозможность записи не должна ломать агента
     }
-    // Notify audit notifier if enabled
+    // Уведомить нотификатор аудита, если включён
     try {
         globalAuditNotifier.notify(entry);
     }
     catch {
-        // Silently fail if notification fails
+        // молча: падение нотификации не должно ломать агента
     }
 }
-/**
- * Log a tool call
- */
+/** Залогировать вызов тула. */
 export function logToolCall(sessionId, tool, success, details) {
     logAudit({
         timestamp: new Date().toISOString(),
@@ -69,9 +62,7 @@ export function logToolCall(sessionId, tool, success, details) {
         details,
     });
 }
-/**
- * Log a file write operation
- */
+/** Залогировать запись файла. */
 export function logFileWrite(sessionId, path, success, details) {
     logAudit({
         timestamp: new Date().toISOString(),
@@ -82,9 +73,7 @@ export function logFileWrite(sessionId, path, success, details) {
         details,
     });
 }
-/**
- * Log a file delete operation
- */
+/** Залогировать удаление файла. */
 export function logFileDelete(sessionId, path, success, details) {
     logAudit({
         timestamp: new Date().toISOString(),
@@ -95,9 +84,7 @@ export function logFileDelete(sessionId, path, success, details) {
         details,
     });
 }
-/**
- * Log a bash command execution
- */
+/** Залогировать выполнение bash-команды. */
 export function logBashCommand(sessionId, command, success, details) {
     logAudit({
         timestamp: new Date().toISOString(),
@@ -108,9 +95,7 @@ export function logBashCommand(sessionId, command, success, details) {
         details,
     });
 }
-/**
- * Log a network request
- */
+/** Залогировать сетевой запрос. */
 export function logNetworkRequest(sessionId, url, success, details) {
     logAudit({
         timestamp: new Date().toISOString(),
@@ -121,10 +106,8 @@ export function logNetworkRequest(sessionId, url, success, details) {
         details,
     });
 }
-/**
- * Log a security block event
- */
-export function logSecurityBlock(sessionId, action, reason, details) {
+/** Залогировать срабатывание security-блока. */
+export function logSecurityBlock(sessionId, _action, reason, details) {
     logAudit({
         timestamp: new Date().toISOString(),
         sessionId,

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

@@ -1,23 +1,19 @@
+// Нотификации о security-событиях: файл + webhook с ретраями и очередью.
 import { writeFileSync, appendFileSync, existsSync, mkdirSync } from "fs";
 import { join, dirname } from "path";
-import { homedir } from "os";
 import { backoffDelay } from "../../utils/retry";
 import { defaultOutputBus } from "../../output";
-/**
- * Severity weights for comparison
- */
+/** Веса severity для сравнения. */
 const SEVERITY_WEIGHTS = {
     low: 1,
     medium: 2,
     high: 3,
     critical: 4,
 };
-/**
- * Default audit notifier configuration
- */
+/** Дефолтный конфиг нотификатора (выключен). */
 export const DEFAULT_AUDIT_NOTIFIER_CONFIG = {
     enabled: false,
-    filePath: join(homedir(), ".mma", "logs", "audit-notifications.jsonl"),
+    filePath: join(globalLogsDir(), "audit-notifications.jsonl"),
     webhookTimeout: 5000,
     minSeverity: "medium",
     eventTypes: [
@@ -30,9 +26,7 @@ export const DEFAULT_AUDIT_NOTIFIER_CONFIG = {
     ],
     maxRetries: 3,
 };
-/**
- * Audit notifier for sending notifications about security events
- */
+/** Нотификатор security-событий: файл + webhook с ретраями. */
 export class AuditNotifier {
     config;
     retryQueue = [];
@@ -41,60 +35,44 @@ export class AuditNotifier {
         this.config = { ...DEFAULT_AUDIT_NOTIFIER_CONFIG, ...config };
         this.ensureLogDirectory();
     }
-    /**
-     * Check if notifier is enabled
-     */
+    /** Включён ли нотификатор. */
     isEnabled() {
         return this.config.enabled;
     }
-    /**
-     * Enable the notifier
-     */
+    /** Включить нотификатор. */
     enable() {
         this.config.enabled = true;
     }
-    /**
-     * Disable the notifier
-     */
+    /** Выключить нотификатор. */
     disable() {
         this.config.enabled = false;
     }
-    /**
-     * Update configuration
-     */
+    /** Обновить конфиг. */
     updateConfig(config) {
         this.config = { ...this.config, ...config };
         this.ensureLogDirectory();
     }
-    /**
-     * Ensure the log directory exists
-     */
+    /** Гарантировать каталог лога. */
     ensureLogDirectory() {
         if (this.config.filePath) {
             const dir = dirname(this.config.filePath);
             mkdirSync(dir, { recursive: true });
         }
     }
-    /**
-     * Check if an event type should be notified
-     */
+    /** Подпадает ли тип события под нотификацию. */
     shouldNotify(eventType) {
         if (!this.config.enabled)
             return false;
         return this.config.eventTypes?.includes(eventType) ?? false;
     }
-    /**
-     * Check if a severity level should be notified
-     */
+    /** Дотягивает ли severity до порога. */
     shouldNotifySeverity(severity) {
         const minSeverity = this.config.minSeverity ?? "medium";
         const minWeight = SEVERITY_WEIGHTS[minSeverity];
         const eventWeight = SEVERITY_WEIGHTS[severity];
         return eventWeight >= minWeight;
     }
-    /**
-     * Send a notification for an audit event
-     */
+    /** Нотифицировать аудит-событие: файл + webhook, падение — в retry-очередь. */
     async notify(entry) {
         if (!this.config.enabled)
             return null;
@@ -112,9 +90,9 @@ export class AuditNotifier {
             details: entry.details ? { details: entry.details } : undefined,
             sessionId: entry.sessionId,
         };
-        // Write to file
+        // Пишем в файл
         this.writeToFile(notification);
-        // Send to webhook if configured
+        // Шлём в webhook, если задан
         if (this.config.webhookUrl) {
             try {
                 await this.sendToWebhook(notification);
@@ -126,9 +104,7 @@ export class AuditNotifier {
         }
         return notification;
     }
-    /**
-     * Map audit log entry action to notification event type
-     */
+    /** Маппинг action записи аудита в тип события нотификации. */
     mapEventType(action) {
         const typeMap = {
             tool_call: "tool_call",
@@ -140,11 +116,9 @@ export class AuditNotifier {
         };
         return typeMap[action] || null;
     }
-    /**
-     * Determine severity from audit log entry
-     */
+    /** Severity из записи аудита (по типу action). */
     determineSeverity(entry) {
-        // Default severity based on action type
+        // Дефолтная severity по типу action
         const typeSeverity = {
             security_block: "high",
             bash_command: "high",
@@ -157,23 +131,22 @@ export class AuditNotifier {
         };
         return typeSeverity[entry.action] || "low";
     }
-    /**
-     * Write notification to file
-     */
+    /** Записать нотификацию в файл. */
     writeToFile(notification) {
         if (!this.config.filePath)
             return;
         try {
             const line = JSON.stringify(notification);
-            appendFileSync(this.config.filePath, line + "\n", "utf8");
+            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 });
         }
     }
     /**
-     * Send notification to webhook. Throws on failure — retry policy is the
-     * caller's decision (notify() queues; processRetryQueue() counts attempts).
+     * Отправить нотификацию в webhook. Падение бросает исключение — политику
+     * ретраев решает вызывающий (notify() кладёт в очередь, processRetryQueue()
+     * считает попытки).
      */
     async sendToWebhook(notification) {
         if (!this.config.webhookUrl)
@@ -195,18 +168,14 @@ export class AuditNotifier {
             clearTimeout(timeoutId);
         }
     }
-    /**
-     * Add notification to retry queue
-     */
+    /** Положить нотификацию в retry-очередь. */
     addToRetryQueue(notification) {
         this.retryQueue.push({ entry: notification, retries: 0 });
         if (!this.isProcessing) {
             this.processRetryQueue();
         }
     }
-    /**
-     * Process the retry queue
-     */
+    /** Разобрать retry-очередь (бэкофф, лимит попыток). */
     async processRetryQueue() {
         if (this.retryQueue.length === 0 || this.isProcessing)
             return;
@@ -224,11 +193,11 @@ export class AuditNotifier {
                     this.retryQueue.shift();
                 }
                 catch (error) {
-                    // sendToWebhook no longer queues copies itself — the retry counter
-                    // actually increments and maxRetries is reachable.
+                    // sendToWebhook сам в очередь не кладёт — счётчик ретраев реально
+                    // растёт, и maxRetries достижим.
                     item.retries++;
                     defaultOutputBus.log("warn", "audit", `[AuditNotifier] Webhook retry ${item.retries} failed: ${error instanceof Error ? error.message : String(error)}`, { persist: true });
-                    // Exponential backoff before the next attempt on the same head item.
+                    // Экспоненциальный бэкофф перед следующей попыткой того же head-элемента.
                     const delay = backoffDelay(item.retries, 1000);
                     await new Promise((resolve) => setTimeout(resolve, delay));
                 }
@@ -238,9 +207,7 @@ export class AuditNotifier {
             this.isProcessing = false;
         }
     }
-    /**
-     * Read notifications from file
-     */
+    /** Прочитать нотификации из файла (последние N). */
     readNotifications(limit = 100) {
         if (!this.config.filePath || !existsSync(this.config.filePath)) {
             return [];
@@ -255,18 +222,14 @@ export class AuditNotifier {
             return [];
         }
     }
-    /**
-     * Clear all notifications
-     */
+    /** Очистить нотификации (файл + очередь). */
     clearNotifications() {
         if (this.config.filePath) {
             writeFileSync(this.config.filePath, "", "utf8");
         }
         this.retryQueue = [];
     }
-    /**
-     * Get notification statistics
-     */
+    /** Статистика нотификаций: всего, по severity, по типам. */
     getStats() {
         const notifications = this.readNotifications();
         const bySeverity = { low: 0, medium: 0, high: 0, critical: 0 };
@@ -293,15 +256,12 @@ export class AuditNotifier {
         };
     }
 }
-/**
- * Global audit notifier instance
- */
+/** Глобальный инстанс нотификатора аудита. */
 export const globalAuditNotifier = new AuditNotifier();
-/**
- * Create an audit notifier with custom configuration
- */
+/** Создать нотификатор аудита с кастомным конфигом. */
 export function createAuditNotifier(config) {
     return new AuditNotifier(config);
 }
-// Import readFileSync for readNotifications
+// Импорт readFileSync для readNotifications
 import { readFileSync } from "fs";
+import { globalLogsDir } from "../../config/paths";