micro-models-agent 2.11.0 → 2.12.0

package/dist/modules/security/rate-limiter.js

@@ -1,14 +1,8 @@
-/**
- * Rate limiter for LLM requests
- * Prevents DoS attacks by limiting the number of requests per time window
- */
 const DEFAULT_CONFIG = {
     maxRequestsPerMinute: 60,
     maxParallelTasks: 5,
 };
-/**
- * Rate limiter class for tracking LLM requests
- */
+/** Лимитер запросов к LLM (окно + параллелизм). */
 export class RateLimiter {
     config;
     state;
@@ -20,10 +14,7 @@ export class RateLimiter {
             parallelTasks: 0,
         };
     }
-    /**
-     * Check if a new request is allowed
-     * Returns true if the request is allowed, false if rate limited
-     */
+    /** Разрешён ли новый запрос (true) или сработал лимит (false). */
     canMakeRequest() {
         this.cleanupOldRequests();
         if (this.state.requests.length >= this.config.maxRequestsPerMinute) {
@@ -31,50 +22,38 @@ export class RateLimiter {
         }
         return true;
     }
-    /**
-     * Record a request
-     */
+    /** Записать запрос в окно. */
     recordRequest() {
         this.cleanupOldRequests();
         this.state.requests.push(Date.now());
     }
-    /**
-     * Check if a new parallel task is allowed
-     */
+    /** Можно ли стартовать параллельную задачу. */
     canStartParallelTask() {
         if (this.state.parallelTasks >= this.config.maxParallelTasks) {
             return false;
         }
         return true;
     }
-    /**
-     * Start a parallel task
-     */
+    /** Старт параллельной задачи. */
     startParallelTask() {
         this.state.parallelTasks++;
     }
-    /**
-     * End a parallel task
-     */
+    /** Финиш параллельной задачи. */
     endParallelTask() {
         this.state.parallelTasks = Math.max(0, this.state.parallelTasks - 1);
     }
-    /**
-     * Get current parallel task count
-     */
+    /** Текущее число параллельных задач. */
     getParallelTaskCount() {
         return this.state.parallelTasks;
     }
-    /**
-     * Get remaining requests in current window
-     */
+    /** Остаток запросов в текущем окне. */
     getRemainingRequests() {
         this.cleanupOldRequests();
         return Math.max(0, this.config.maxRequestsPerMinute - this.state.requests.length);
     }
     /**
-     * Milliseconds until a request slot frees up (the oldest request ages out of
-     * the 1-minute window). Returns 0 when a request can be made immediately.
+     * Миллисекунд до освобождения слота (старейший запрос вывалится из минутного
+     * окна). 0 — запрос можно слать сразу.
      */
     msUntilRequest() {
         this.cleanupOldRequests();
@@ -83,48 +62,37 @@ export class RateLimiter {
         const oldest = this.state.requests[0];
         return Math.max(0, 60_000 - (Date.now() - oldest));
     }
-    /**
-     * Clean up old requests (older than 1 minute)
-     */
+    /** Выкинуть запросы старше минуты. */
     cleanupOldRequests() {
         const now = Date.now();
         const oneMinuteAgo = now - 60_000;
-        // Only cleanup every 5 seconds to avoid performance overhead
+        // Чистка не чаще раза в 5 секунд — без оверхеда
         if (now - this.lastCleanup < 5000) {
             return;
         }
         this.state.requests = this.state.requests.filter((timestamp) => timestamp > oneMinuteAgo);
         this.lastCleanup = now;
     }
-    /**
-     * Reset the rate limiter
-     */
+    /** Сбросить лимитер. */
     reset() {
         this.state.requests = [];
         this.state.parallelTasks = 0;
         this.lastCleanup = 0;
     }
-    /**
-     * Get rate limit configuration
-     */
+    /** Текущий конфиг лимитов. */
     getConfig() {
         return this.config;
     }
-    /**
-     * Update rate limit configuration
-     */
+    /** Обновить конфиг лимитов. */
     updateConfig(config) {
         this.config = { ...this.config, ...config };
     }
 }
 /**
- * Global rate limiter instance
- * Can be used by LLM provider to enforce rate limits
+ * Глобальный лимитер для LLM-провайдера.
  */
 export const globalRateLimiter = new RateLimiter();
-/**
- * Create a rate limiter with custom configuration
- */
+/** Создать лимитер с кастомным конфигом. */
 export function createRateLimiter(config) {
     return new RateLimiter(config);
 }

package/dist/modules/security/security-policies.js

@@ -1,7 +1,7 @@
 import { mergeSecurityConfig } from "../../config/security";
 /**
- * Strict security policy - maximum security, minimum flexibility
- * Recommended for: production environments, sensitive data, multi-user systems
+ * Strict: максимум безопасности, минимум гибкости.
+ * Для: продакшн, чувствительные данные, многопользовательские системы.
  */
 export const STRICT_POLICY = {
     name: "Strict",
@@ -141,7 +141,7 @@ export const STRICT_POLICY = {
                 /require\('net'\)\.createServer/,
                 /process\.exit\(/,
                 /while\(true\)/,
-                /for\(\;\;\)/,
+                /for\(;;\)/,
                 /rm -rf/,
                 /dd if=/,
                 /chmod 777/,
@@ -174,8 +174,8 @@ export const STRICT_POLICY = {
     },
 };
 /**
- * Balanced security policy - good security with reasonable flexibility
- * Recommended for: development, single-user systems, general use
+ * Balanced: вменяемая безопасность с разумной гибкостью.
+ * Для: разработка, однопользовательские системы, общее использование.
  */
 export const BALANCED_POLICY = {
     name: "Balanced",
@@ -274,7 +274,7 @@ export const BALANCED_POLICY = {
                 /require\('child_process'\)/,
                 /process\.exit\(/,
                 /while\(true\)/,
-                /for\(\;\;\)/,
+                /for\(;;\)/,
                 /rm -rf/,
                 /dd if=/,
                 /chmod 777/,
@@ -294,8 +294,8 @@ export const BALANCED_POLICY = {
     },
 };
 /**
- * Permissive security policy - minimal security, maximum flexibility
- * Recommended for: trusted environments, local development, testing
+ * Permissive: минимум безопасности, максимум гибкости.
+ * Для: доверенные окружения, локальная разработка, тесты.
  */
 export const PERMISSIVE_POLICY = {
     name: "Permissive",
@@ -348,7 +348,7 @@ export const PERMISSIVE_POLICY = {
                 /eval\(/,
                 /new Function\(/,
                 /while\(true\)/,
-                /for\(\;\;\)/,
+                /for\(;;\)/,
                 /rm -rf/,
                 /dd if=/,
             ],
@@ -366,9 +366,7 @@ export const PERMISSIVE_POLICY = {
         },
     },
 };
-/**
- * All available security policies
- */
+/** Все доступные политики безопасности. */
 export const SECURITY_POLICIES = {
     strict: STRICT_POLICY,
     balanced: BALANCED_POLICY,
@@ -381,27 +379,19 @@ export const SECURITY_POLICIES = {
         config: {},
     },
 };
-/**
- * Security policy manager
- */
+/** Менеджер политик безопасности (текущая + кастом). */
 export class SecurityPolicyManager {
     currentPolicy = "balanced";
     customConfig = {};
-    /**
-     * Get all available policies
-     */
+    /** Все доступные политики. */
     getPolicies() {
         return Object.values(SECURITY_POLICIES);
     }
-    /**
-     * Get a specific policy by name
-     */
+    /** Политика по имени (неизвестная — balanced). */
     getPolicy(preset) {
         return SECURITY_POLICIES[preset] || SECURITY_POLICIES.balanced;
     }
-    /**
-     * Get the current policy
-     */
+    /** Текущая политика (custom — с кастомным конфигом). */
     getCurrentPolicy() {
         if (this.currentPolicy === "custom") {
             return {
@@ -411,22 +401,16 @@ export class SecurityPolicyManager {
         }
         return this.getPolicy(this.currentPolicy);
     }
-    /**
-     * Set the current policy
-     */
+    /** Назначить текущую политику. */
     setPolicy(preset) {
         this.currentPolicy = preset;
     }
-    /**
-     * Set custom configuration (for 'custom' preset)
-     */
+    /** Задать кастомный конфиг (переключает на 'custom'). */
     setCustomConfig(config) {
         this.customConfig = config;
         this.currentPolicy = "custom";
     }
-    /**
-     * Get the current security configuration
-     */
+    /** Текущий security-конфиг (политика + мерж дефолтов). */
     getConfig() {
         const policy = this.getCurrentPolicy();
         return mergeSecurityConfig({
@@ -434,9 +418,7 @@ export class SecurityPolicyManager {
             ...(this.currentPolicy === "custom" ? this.customConfig : {}),
         });
     }
-    /**
-     * Apply a policy and return the merged configuration
-     */
+    /** Применить политику с опциональными оверрайдами; вернуть смерженный конфиг. */
     applyPolicy(preset, customOverrides) {
         this.setPolicy(preset);
         if (customOverrides) {
@@ -445,9 +427,7 @@ export class SecurityPolicyManager {
         }
         return this.getConfig();
     }
-    /**
-     * Get policy recommendation for a use case
-     */
+    /** Рекомендованная политика для кейса (иначе — balanced). */
     getRecommendation(useCase) {
         for (const policy of this.getPolicies()) {
             if (policy.recommendedFor.includes(useCase)) {
@@ -456,9 +436,7 @@ export class SecurityPolicyManager {
         }
         return BALANCED_POLICY;
     }
-    /**
-     * Check if current policy allows a specific action
-     */
+    /** Разрешает ли текущая политика действие (bash/file_access/network). */
     allowsAction(action, context) {
         const config = this.getConfig();
         switch (action) {
@@ -490,9 +468,7 @@ export class SecurityPolicyManager {
                 return true;
         }
     }
-    /**
-     * Get policy comparison
-     */
+    /** Посравнить две политики по ключам конфига. */
     comparePolicies(policy1, policy2) {
         const config1 = this.getPolicy(policy1).config;
         const config2 = this.getPolicy(policy2).config;
@@ -507,25 +483,17 @@ export class SecurityPolicyManager {
         return comparison;
     }
 }
-/**
- * Global security policy manager instance
- */
+/** Глобальный менеджер политик. */
 export const globalSecurityPolicyManager = new SecurityPolicyManager();
-/**
- * Create a security policy manager with custom configuration
- */
+/** Создать менеджер политик. */
 export function createSecurityPolicyManager() {
     return new SecurityPolicyManager();
 }
-/**
- * Get a policy by name
- */
+/** Политика по имени через глобальный менеджер. */
 export function getSecurityPolicy(preset) {
     return globalSecurityPolicyManager.getPolicy(preset);
 }
-/**
- * Apply a security policy
- */
+/** Применить политику через глобальный менеджер. */
 export function applySecurityPolicy(preset, customOverrides) {
     return globalSecurityPolicyManager.applyPolicy(preset, customOverrides);
 }

package/dist/modules/security/session-encryption.js

@@ -1,45 +1,36 @@
+// Шифрование файлов сессий (history.jsonl, session.jsonl): чтение/запись/append.
 import { readFileSync, writeFileSync, existsSync, readdirSync, unlinkSync } from "fs";
 import { join } from "path";
-import { homedir } from "os";
 import { encryptString, decryptString, isEncryptedString, ConfigEncryptor, } from "./encryption";
 import { defaultOutputBus } from "../../output";
-/**
- * Default session encryption configuration
- */
+import { globalMmaDir } from "../../config/paths";
+/** Дефолтный конфиг шифрования сессии (выключено). */
 export const DEFAULT_SESSION_ENCRYPTION = {
     enabled: false,
     encryptHistory: true,
     encryptSessionLog: true,
 };
-/**
- * Session file encryptor/decryptor
- */
+/** Шифровальщик/расшифровщик файлов сессии. */
 export class SessionFileEncryptor {
     config;
     encryptor;
     constructor(config) {
         this.config = { ...DEFAULT_SESSION_ENCRYPTION, ...config };
         this.encryptor = new ConfigEncryptor({
-            keyPath: config?.keyPath || join(homedir(), ".mma", ".session-encryption-key"),
+            keyPath: config?.keyPath || join(globalMmaDir(), ".session-encryption-key"),
         });
     }
-    /**
-     * Check if session file encryption is enabled
-     */
+    /** Включено ли шифрование файлов сессии. */
     isEnabled() {
         return this.config.enabled;
     }
-    /**
-     * Encrypt a session file content
-     */
+    /** Зашифровать содержимое файла сессии. */
     encryptFileContent(content) {
         if (!this.config.enabled)
             return content;
         return encryptString(content, this.encryptor.getKey());
     }
-    /**
-     * Decrypt a session file content
-     */
+    /** Расшифровать содержимое файла сессии (plain text — как есть). */
     decryptFileContent(content) {
         if (!this.config.enabled)
             return content;
@@ -47,17 +38,13 @@ export class SessionFileEncryptor {
             return content;
         return decryptString(content, this.encryptor.getKey());
     }
-    /**
-     * Encrypt a JSON object (for structured files)
-     */
+    /** Зашифровать JSON-объект (для структурных файлов). */
     encryptJSON(obj) {
         if (!this.config.enabled)
             return JSON.stringify(obj);
         return this.encryptFileContent(JSON.stringify(obj));
     }
-    /**
-     * Decrypt a JSON string
-     */
+    /** Расшифровать JSON-строку; мусор — ошибка. */
     decryptJSON(content) {
         let plain = content;
         if (this.config.enabled) {
@@ -70,18 +57,16 @@ export class SessionFileEncryptor {
             throw new Error("Invalid JSON content in session file — file may be corrupted or encrypted with a different key");
         }
     }
-    /**
-     * Encrypt a JSONL file (one JSON object per line)
-     */
+    /** Зашифровать JSONL-файл (по строке на объект). */
     encryptJSONL(lines) {
         if (!this.config.enabled)
             return lines;
         return lines.map((line) => this.encryptFileContent(line));
     }
     /**
-     * Decrypt a JSONL file. A line that fails to decrypt (corrupted, truncated
-     * by a crash, or foreign plaintext) is logged and SKIPPED — one bad line
-     * must not make the whole session history unreadable.
+     * Расшифровать JSONL. Строка с ошибкой (битая, оборванная крашем, чужой
+     * plaintext) логируется и ПРОПУСКАЕТСЯ — одна плохая строка не должна
+     * убивать всю историю сессии.
      */
     decryptJSONL(lines) {
         if (!this.config.enabled)
@@ -96,42 +81,32 @@ export class SessionFileEncryptor {
             }
         });
     }
-    /**
-     * Read and decrypt a session file
-     */
+    /** Прочитать и расшифровать файл сессии. */
     readSessionFile(filePath) {
         const content = readFileSync(filePath, "utf8");
         return this.decryptFileContent(content);
     }
-    /**
-     * Write and encrypt a session file
-     */
+    /** Зашифровать и записать файл сессии. */
     writeSessionFile(filePath, content) {
         const encrypted = this.encryptFileContent(content);
         writeFileSync(filePath, encrypted, "utf8");
     }
-    /**
-     * Read and decrypt a JSON session file
-     */
+    /** Прочитать и расшифровать JSON-файл сессии. */
     readSessionJSON(filePath) {
         const content = readFileSync(filePath, "utf8");
         return this.decryptJSON(content);
     }
-    /**
-     * Write and encrypt a JSON session file
-     */
+    /** Зашифровать и записать JSON-файл сессии. */
     writeSessionJSON(filePath, obj) {
         const content = this.encryptJSON(obj);
         writeFileSync(filePath, content, "utf8");
     }
-    /**
-     * Read and decrypt a JSONL session file
-     */
+    /** Прочитать и расшифровать JSONL-файл сессии (битые строки пропускаются). */
     readSessionJSONL(filePath) {
         const content = readFileSync(filePath, "utf8");
         const lines = content.split("\n").filter((line) => line.trim());
         const decryptedLines = this.decryptJSONL(lines);
-        // Skip malformed lines instead of crashing the whole session log
+        // Кривые строки пропускаем, а не роняем весь лог сессии
         return decryptedLines.flatMap((line) => {
             try {
                 return [JSON.parse(line)];
@@ -141,19 +116,15 @@ export class SessionFileEncryptor {
             }
         });
     }
-    /**
-     * Append an encrypted entry to a JSONL file
-     */
+    /** Добавить зашифрованную запись в JSONL-файл. */
     appendToSessionJSONL(filePath, obj) {
         const encryptedLine = this.encryptFileContent(JSON.stringify(obj));
-        writeFileSync(filePath, encryptedLine + "\n", {
+        writeFileSync(filePath, `${encryptedLine}\n`, {
             flag: "a",
             encoding: "utf8",
         });
     }
-    /**
-     * Encrypt all session files in a directory
-     */
+    /** Зашифровать все файлы каталога сессии (*.enc, оригиналы удаляются). */
     encryptSessionDirectory(sessionDir) {
         if (!this.config.enabled)
             return;
@@ -164,18 +135,16 @@ export class SessionFileEncryptor {
                 try {
                     const content = readFileSync(filePath, "utf8");
                     const encrypted = this.encryptFileContent(content);
-                    writeFileSync(filePath + ".enc", encrypted, "utf8");
+                    writeFileSync(`${filePath}.enc`, encrypted, "utf8");
                     unlinkSync(filePath);
                 }
                 catch {
-                    // Skip binary files or files we can't read
+                    // Бинарники и нечитаемое пропускаем
                 }
             }
         }
     }
-    /**
-     * Decrypt all session files in a directory
-     */
+    /** Расшифровать все *.enc в каталоге сессии (оригиналы восстанавливаются). */
     decryptSessionDirectory(sessionDir) {
         if (!this.config.enabled)
             return;
@@ -183,7 +152,7 @@ export class SessionFileEncryptor {
         for (const file of files) {
             if (file.endsWith(".enc")) {
                 const encFilePath = join(sessionDir, file);
-                const decFilePath = encFilePath.slice(0, -4); // Remove .enc
+                const decFilePath = encFilePath.slice(0, -4); // снять .enc
                 try {
                     const content = readFileSync(encFilePath, "utf8");
                     const decrypted = this.decryptFileContent(content);
@@ -191,31 +160,23 @@ export class SessionFileEncryptor {
                     unlinkSync(encFilePath);
                 }
                 catch {
-                    // Skip files we can't decrypt
+                    // Нерасшифровываемое пропускаем
                 }
             }
         }
     }
 }
-/**
- * Global session file encryptor instance
- */
+/** Глобальный шифровальщик файлов сессии. */
 export const globalSessionEncryptor = new SessionFileEncryptor();
-/**
- * Create a session file encryptor with custom configuration
- */
+/** Создать шифровальщик файлов сессии с кастомным конфигом. */
 export function createSessionFileEncryptor(config) {
     return new SessionFileEncryptor(config);
 }
-/**
- * Helper to encrypt a message object (for SessionMessage)
- */
+/** Хелпер: зашифровать объект сообщения (для SessionMessage). */
 export function encryptSessionMessage(msg) {
     return globalSessionEncryptor.encryptJSON(msg);
 }
-/**
- * Helper to decrypt a session message
- */
+/** Хелпер: расшифровать сообщение сессии. */
 export function decryptSessionMessage(encrypted) {
     return globalSessionEncryptor.decryptJSON(encrypted);
 }

package/dist/modules/security/session-isolation.js

@@ -1,30 +1,27 @@
+// Изоляция сессий: свой temp-каталог, свои security-оверрайды, скоуп путей.
 import { join, resolve } from "path";
-import { homedir } from "os";
 import { mkdirSync, existsSync } from "fs";
 import { DEFAULT_SECURITY_CONFIG } from "../../config/security";
 import { isInsideDir } from "../../tools/path-utils";
-/**
- * Default session isolation configuration
- */
+import { globalSessionsDir } from "../../config/paths";
+/** Дефолтный конфиг изоляции сессий (выключена). */
 export const DEFAULT_SESSION_ISOLATION = {
     enabled: false,
     isolatePlugins: true,
     isolateTempFiles: true,
 };
-/**
- * Create a session context with isolation
- */
+/** Создать контекст сессии с изоляцией (temp-каталог 0700). */
 export function createSessionContext(sessionId, projectDir, isolationConfig, securityOverrides) {
     const config = { ...DEFAULT_SESSION_ISOLATION, ...isolationConfig };
-    // Create session-specific temporary directory
-    const baseDir = config.baseDir || join(homedir(), ".mma", "sessions", sessionId);
+    // Временный каталог сессии
+    const baseDir = config.baseDir || join(globalSessionsDir(), sessionId);
     const tempDir = join(baseDir, "temp");
     if (config.isolateTempFiles && !existsSync(tempDir)) {
         try {
             mkdirSync(tempDir, { recursive: true, mode: 0o700 });
         }
         catch {
-            // If we can't create the temp dir, continue without isolation
+            // Каталог не создался — работаем без изоляции
         }
     }
     return {
@@ -35,8 +32,7 @@ export function createSessionContext(sessionId, projectDir, isolationConfig, sec
     };
 }
 /**
- * Get session-specific security configuration
- * Merges global security config with session overrides
+ * Security-конфиг сессии: глобальный + оверрайды (вложенные объекты мержатся).
  */
 export function getSessionSecurityConfig(globalConfig, sessionContext) {
     const globalSecurity = globalConfig.security || DEFAULT_SECURITY_CONFIG;
@@ -47,7 +43,7 @@ export function getSessionSecurityConfig(globalConfig, sessionContext) {
     return {
         ...globalSecurity,
         ...sessionOverrides,
-        // Merge nested objects
+        // Вложенные объекты — мерж, не замена
         bash: { ...globalSecurity.bash, ...sessionOverrides.bash },
         paths: { ...globalSecurity.paths, ...sessionOverrides.paths },
         network: { ...globalSecurity.network, ...sessionOverrides.network },
@@ -55,31 +51,22 @@ export function getSessionSecurityConfig(globalConfig, sessionContext) {
         contentScan: { ...globalSecurity.contentScan, ...sessionOverrides.contentScan },
     };
 }
-/**
- * Get session-specific temporary directory
- */
+/** Временный каталог сессии. */
 export function getSessionTempDir(sessionContext) {
     return sessionContext.tempDir;
 }
-/**
- * Clean up session-specific temporary data
- */
-export function cleanupSessionTempDir(sessionContext) {
-    // Note: In a real implementation, we would recursively delete the temp dir
-    // For now, we just leave it as the OS will clean up eventually
-    // In production, you might want to implement proper cleanup
+/** Убрать временные данные сессии (пока no-op — чистит ОС). */
+export function cleanupSessionTempDir(_sessionContext) {
+    // Заглушка: рекурсивное удаление не реализовано, чистит ОС.
 }
 /**
- * Create a session-specific file path
- * Ensures the path is within the session's working directory or temp directory
+ * Путь к файлу сессии: обязан лежать в рабочем или temp-каталоге сессии.
  */
 export function createSessionFilePath(sessionContext, relativePath, useTempDir = false) {
     const baseDir = useTempDir ? sessionContext.tempDir : sessionContext.workingDir;
     return resolve(baseDir, relativePath);
 }
-/**
- * Check if a path is within the session's allowed directories
- */
+/** Путь в разрешённых каталогах сессии (рабочий или temp) или нет. */
 export function isPathInSessionScope(sessionContext, path) {
     const resolvedPath = resolve(path);
     const workingDir = resolve(sessionContext.workingDir);