micro-models-agent 2.11.0 → 2.13.1

package/dist/logger/file-log.js

@@ -1,3 +1,4 @@
+// Файловый логер 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;
@@ -5,27 +6,28 @@ const MAX_LOG_FILES = 30;
 const DEFAULT_MAX_DAYS = 30;
 const TOOL_OUTPUT_LIMIT = 2000;
 /**
- * Tagged file logger (legacy MMA v1 behavior).
+ * Тегированный файловый логер (поведение legacy MMA v1).
  *
- * Writes human-readable log lines to `~/.mma/logs/`:
- * - `<sessionId>.log` while a session is active
- * - `YYYY-MM-DD.log` for everything outside a session
+ * Пишет читаемые строки в `~/.mma/logs/`:
+ * - `<sessionId>.log`, пока сессия активна;
+ * - `YYYY-MM-DD.log` для всего вне сессии.
  *
- * Features restored from v1:
- * - size-based rotation (5 MB → file.log.1, file.log.2, ...)
- * - cleanup of old logs (age + max file count)
- * - tagged helpers: LLM request/response, tool calls, REPL
+ * Фичи из 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 });
         }
     }
-    /** Open a per-session log file. Triggers cleanup of old logs. */
+    /** Открывает посессионный лог-файл. Триггерит чистку старых логов. */
     initSessionLog(sessionId) {
         if (!this.logDir)
             return;
@@ -35,10 +37,11 @@ export class FileLogWriter {
         this.sessionLogPath = join(this.logDir, `${sessionId}.log`);
         this.cleanupOldLogs();
     }
-    /** Fall back to daily log files when no session is active. */
+    /** Возврат к дневным лог-файлам, когда нет активной сессии. */
     closeSessionLog() {
         this.sessionLogPath = null;
     }
+    /** Путь к текущему лог-файлу (сессионный или дневной). */
     getLogPath() {
         if (this.sessionLogPath)
             return this.sessionLogPath;
@@ -47,7 +50,7 @@ export class FileLogWriter {
         const date = new Date().toISOString().slice(0, 10);
         return join(this.logDir, `${date}.log`);
     }
-    /** Rotate the file if it exceeds the size limit. */
+    /** Ротирует файл при превышении лимита размера. */
     rotateIfNeeded(filePath) {
         if (!existsSync(filePath))
             return;
@@ -59,6 +62,7 @@ export class FileLogWriter {
             idx++;
         renameSync(filePath, `${filePath}.${idx}`);
     }
+    /** Пишет одну строку. Файловый лог — best-effort, ошибки глотаются. */
     log(level, tag, message) {
         const fp = this.getLogPath();
         if (!fp)
@@ -75,10 +79,12 @@ export class FileLogWriter {
             /* 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) {
@@ -88,16 +94,18 @@ export class FileLogWriter {
             this.log("INFO", tag, `← ${model} | ${responseLength} chars | ${genTimeMs}ms`);
         }
     }
+    /** Пишет вызов тула с обрезанными превью аргументов и результата. */
     logToolCall(tool, preview, result) {
-        const previewTrimmed = preview.length > 200 ? preview.slice(0, 200) + "..." : preview;
+        const previewTrimmed = preview.length > 200 ? `${preview.slice(0, 200)}...` : preview;
         if (result !== undefined) {
-            const resultTrimmed = result.length > 200 ? result.slice(0, 200) + "..." : result;
+            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) +
@@ -105,14 +113,15 @@ export class FileLogWriter {
             : 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;
+        const trimmed = content.length > 400 ? `${content.slice(0, 400)}...` : content;
         this.log("INFO", `REPL/${tag}`, trimmed);
     }
     /**
-     * Clean up old log files.
-     * - Deletes files older than maxDays
-     * - Keeps at most maxFiles most recent .log files
+     * Чистит старые лог-файлы.
+     * - удаляет старше maxDays;
+     * - оставляет не более maxFiles самых свежих .log-файлов.
      */
     cleanupOldLogs(maxDays = DEFAULT_MAX_DAYS, maxFiles = MAX_LOG_FILES) {
         if (!this.logDir || !existsSync(this.logDir))
@@ -126,7 +135,7 @@ export class FileLogWriter {
             mtime: statSync(join(this.logDir, f)).mtimeMs,
         }))
             .sort((a, b) => b.mtime - a.mtime);
-        // 1. Delete by age.
+        // 1. Удаление по возрасту.
         for (const f of list()) {
             if (now - f.mtime > maxDays * 24 * 60 * 60 * 1000) {
                 try {
@@ -137,7 +146,7 @@ export class FileLogWriter {
                 }
             }
         }
-        // 2. Delete excess (fresh but more than maxFiles).
+        // 2. Удаление излишков (свежие, но сверх maxFiles).
         const remaining = list();
         for (let i = maxFiles; i < remaining.length; i++) {
             try {

package/dist/logger/index.js

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