micro-models-agent 0.39.1 → 0.40.0

package/dist/i18n/ru.json

@@ -26,6 +26,7 @@
     "error.llm": "Ошибка LLM: {message}",
     "error.response_blocked": "Ответ заблокирован: {reason}",
     "error.max_iters": "Достигнут максимум итераций ({max})",
+    "error.empty_response": "Модель вернула пустой ответ после повторных попыток",
     "error.grep_failed": "Ошибка grep: {message}",
     "error.search_failed": "Ошибка поиска: {message}",
     "error.fetch_failed": "Ошибка загрузки: {message}",
@@ -63,6 +64,7 @@
     "tool.failed": "Инструмент {name} упал: {error}",
     "tool.unknown": "Неизвестный инструмент: {name}",
     "tool.blocked": "Заблокировано плагином: {plugin}",
+    "tool.blocked_reason": "Заблокировано плагином: {plugin}. Причина: {reason}",
     "tool.using": "[{label}]",
     "tool.friendly.write_file": "Запись файла",
     "tool.friendly.read_file": "Чтение файла",
@@ -82,6 +84,9 @@
     "tool.friendly.web_search": "Поиск в интернете",
     "tool.friendly.web_fetch": "Загрузка страницы",
     "tool.friendly.web_browse": "Просмотр страницы",
+    "tool.web_fetch_result": "Загружена страница: {url} — {chars} симв., {lines} строк{truncated}",
+    "tool.web_browse_result": "Просмотрена страница: {url} — {chars} симв., {lines} строк{truncated}",
+    "tool.web_search_result": "Результаты поиска \"{query}\" — {count} результатов",
     "tool.friendly.browser": "Браузер",
     "tool.friendly.subagent": "Задача подагенту",
     "tool.friendly.question": "Вопрос пользователю",
@@ -112,7 +117,7 @@
     "tool.question.answered": "Пользователь ответил на ваши вопросы: {formatted}. Теперь продолжайте с учётом ответов.",
     "tool.name_or_task": "Укажите параметр \"name\" или \"task\"",
     "tool.invalid_params": "Неверные параметры",
-    "tool.skill_budget": "[Скилл загружен. Осталось {remaining} токенов в бюджете скиллов]",
+    "tool.skill_budget": "Скилл \"{name}\" загружен ({tokens} токенов, осталось {remaining} в бюджете скиллов). Контент скилла теперь в системном промпте — перезагрузка после компрессии не нужна.",
     "tool.skill_available_hint": "Доступные скиллы",
     "tool.no_results": "Нет результатов по \"{query}\"",
     "tool.search_results": "Результаты поиска \"{query}\":\n{results}",
@@ -123,9 +128,10 @@
     "tool.memory_error": "Ошибка памяти: {error}",
     "tool.screenshot_unavailable": "[Скриншот сделан — изображение недоступно для текстовой модели]",
     "tool.timeout": "Инструмент {name} превысил таймаут ({seconds} сек)",
+    "tool.aborted": "Инструмент {name} прерван пользователем",
     "tool.interactive_disabled": "Интерактивный инструмент отключён в режиме exit-on-complete. Продолжай без вопроса пользователю.",
     "proc.started": "Фоновый процесс запущен: {id} (PID {pid}).\nКоманда: {command}",
-    "proc.detected_hint": "[Обнаружена длительная команда — запущена в фоне]",
+    "proc.promoted_hint": "Команда всё ещё выполняется через {ms} мс — переведена в фоновый режим",
     "proc.manage_hint": "Проверить вывод: process_log id={id}. Остановить: process_kill id={id}. Список всех: process_list.",
     "proc.none": "Фоновых процессов нет.",
     "proc.not_found": "Процесс не найден: {id}",
@@ -134,7 +140,6 @@
     "proc.list_header": "Фоновые процессы",
     "proc.log_header": "Вывод процесса {id} ({status}):",
     "proc.log_empty": "(вывода пока нет)",
-    "proc.timed_out": "Команда превысила таймаут {ms} мс и была остановлена.",
     "proc.hint": "Управление: {list}, {log}, {kill}.",
     "proc.status_running": "работает",
     "proc.status_exited": "завершён",
@@ -142,19 +147,29 @@
     "tool.friendly.process_list": "Список фоновых процессов",
     "tool.friendly.process_log": "Вывод процесса",
     "tool.friendly.process_kill": "Остановка процесса",
+    "plan.no_steps": "Не указаны шаги плана. Укажите конкретные шаги с файлами и командами.",
     "plan.created": "План создан: {title} ({steps} шагов)",
+    "plan.coverage_warning": "План может не покрывать требуемые файлы из постановки: {missing}. Добавьте шаги, покрывающие их.",
     "plan.step_done": "Шаг {n}/{total}: {description} ✓",
     "plan.complete": "Задача выполнена: {summary}",
     "plan.title_steps": "План \"{title}\" создан с {count} шагами",
     "plan.step_marked": "Шаг {step} отмечен как {status}",
     "plan.aborted": "План отменён",
     "plan.unknown_action": "Неизвестное действие плана: {action}",
+    "plan.updated": "План обновлён: {title} ({steps} шагов)",
     "plan.acknowledged": "План {action}: принято",
     "plan.step_status": "Шаг {step}: {status}",
     "plan.no_active": "Нет активного плана",
     "plan.step_not_found": "Шаг не найден",
     "plan.show_header": "Статус плана:",
     "plan.show_empty": "(в плане нет шагов)",
+    "plan.list_header": "Планы:",
+    "plan.list_empty": "Нет планов",
+    "plan.switch_no_id": "Укажите id плана для переключения",
+    "plan.not_found": "План не найден: {id}",
+    "plan.switched": "Переключено на план {id}: {title}",
+    "plan.replanned": "План перепланирован: {kept} выполненных шагов сохранено, {steps} новых шагов добавлено",
+    "plan.replan_no_steps": "Укажите новые шаги для перепланирования",
     "todo.added": "Добавлено {count} задач: {items}",
     "todo.marked_done": "Отмечено выполненными: {count}",
     "todo.no_active": "Нет активных задач",
@@ -188,6 +203,35 @@
     "cli.context_set": "Контекстное окно установлено: {size} токенов",
     "cli.set_model": "Установить модель по умолчанию",
     "cli.model_set": "Модель установлена: {name}",
+    "cli.certify": "Запустить сертификационный набор для модели",
+    "cli.cert_provider_url": "Базовый URL провайдера для сертификации (по умолчанию — текущий конфиг)",
+    "cli.cert_provider_key": "API-ключ провайдера (необязательно)",
+    "cli.cert_context_window": "Размер контекстного окна в токенах",
+    "cli.cert_tags": "Теги сценариев через запятую (core, security, image, network, browser)",
+    "cli.cert_reps": "Повторов по умолчанию на сценарий (переопределяется сценарием)",
+    "cli.cert_force": "Перепрогнать существующую сертификацию",
+    "cli.cert_clean": "Удалить песочницы после успешного прогона",
+    "cli.cert_security_required": "Безопасность отключена. Включите её (например `mma security set-policy balanced`), чтобы запустить security-сьют.",
+    "cli.cert_no_scenarios": "Нет сценариев под теги: {tags}",
+    "cli.cert_exists": "Сертификация {model} на этом провайдере уже существует.",
+    "cli.cert_exists_hint": "Используйте --force для перепрогона.",
+    "cli.cert_started": "Сертификация {model} на {provider}...",
+    "cli.cert_done": "Сертификация завершена: {passed} pass, {failed} fail, {skipped} skipped ({total} всего)",
+    "cli.cert_rep_pass": "pass",
+    "cli.cert_rep_fail": "fail",
+    "cli.cert_status": "Показать статус сертификации модели",
+    "cli.cert_list": "Список всех сертификаций",
+    "cli.cert_uncertify": "Удалить сертификацию",
+    "cli.cert_not_found": "Сертификация {model} не найдена",
+    "cli.cert_uncertified": "Сертификация {model} удалена",
+    "cli.cert_empty": "Сертификаций пока нет. Запустите `mma model certify <модель>`.",
+    "cli.cert_provider_col": "провайдер",
+    "cli.cert_suite_col": "сьют",
+    "cli.cert_date_col": "дата",
+    "cli.cert_version_col": "версия MMA",
+    "cli.cert_stale_hint": "Запустите `mma model certify --force` для обновления.",
+    "cli.cert_fixture_missing": "Фикстура отсутствует для {id}: {path}",
+    "cli.cert_marks_hint": "Маркеры: ✔ сертифицировано на этом провайдере, ○ сертифицировано на старой версии MMA, · не сертифицировано",
     "cli.manage_providers": "Управление провайдерами",
     "cli.list_providers": "Список провайдеров",
     "cli.current_provider": "Текущий провайдер:",
@@ -286,10 +330,14 @@
     "repl.skill_unknown_sub": "Неизвестная подкоманда скилла: {subcmd}",
     "repl.skill_usage": "Использование: /skill [list|loaded|load|unload|search]",
     "repl.agent": "Агент: ",
-    "repl.title": "MMA REPL v2",
+    "repl.interrupt": "Прервано (Esc)",
+    "repl.title": "MMA REPL v{version}",
     "repl.model": "Модель:",
     "repl.provider": "Провайдер:",
     "repl.context": "Контекст:",
+    "repl.sysprompt_label": "Системный промпт:",
+    "repl.sysprompt_size": "{used} / {budget} токенов",
+    "repl.sysprompt_desc": "Показать системный промпт",
     "repl.max_iters": "Макс итераций:",
     "repl.stuck_thresh": "Порог зависания:",
     "repl.reasoning_label": "Рассуждения:",
@@ -371,25 +419,34 @@
     "skill.prompt_hint": "НЕ загружайте скиллы автоматически. Загружайте скилл ТОЛЬКО когда пользователь явно об этом просит (например 'используй скилл X' или 'загрузи скилл Y'). Скиллы ниже перечислены только для справки — не угадывайте какой скилл подходит по описанию задачи.",
     "skill.prompt_fallback": "Если load_skill не удался из-за большого размера скилла, продолжайте задачу без него — не останавливайтесь.",
     "skill.loaded_content": "[Скилл загружен: {name}]\n{content}\n\nИспользуйте эти знания для ответа на вопрос пользователя.",
-    "exec.stuck": "Застряли на шаге {stepId}. Текущий: {description}. Нет прогресса {iterations} итераций.",
-    "exec.stuck_recovery": "[Обнаружено застревание: {iterations} итераций без прогресса. Прекратите повторять тот же подход. Попробуйте принципиально другую стратегию: используйте другой инструмент (например, 'browser' для сайтов с JavaScript вместо 'web_browse'), разбейте задачу на подзадачи или объясните пользователю что пошло не так и спросите совета.]",
-    "exec.tool_errors": "Инструмент {tool} сбоил {count} раз. Предложите другой подход.",
-    "exec.tool_errors_recovery": "[Инструмент {tool} сбоил {count} раз. Прекратите использовать этот инструмент и попробуйте другой подход или объясните проблему пользователю.]",
-    "exec.repetitive_tool": "[Вы вызвали {tool} {count} раз подряд с одинаковыми аргументами и результатом. Прекратите повторять — попробуйте другой подход: создайте файлы, измените аргументы или объясните пользователю проблему.]",
-    "exec.consecutive_failures_recovery": "[{count} последовательных вызовов тулов завершились ошибкой. Вы ходите по кругу — прекратите пытаться выполнить команды, которые постоянно падают. Объясните проблему пользователю или попробуйте совершенно другой подход: напишите файлы напрямую, используйте другой инструмент или разбейте задачу на части.]",
-    "exec.task_reminder": "[Напоминание о задаче: {task}. Не переключайтесь на посторонние задачи. Если не можете выполнить задачу — объясните почему и спросите совета.]",
-    "exec.plan_warning": "[⚠ Внимание: вы работаете над шагом {step} — \"{description}\". Ваш вызов {tool} касается файлов, не упомянутых в текущем шаге. Сосредоточьтесь на текущем шаге или обновите план через plan update.]",
-    "exec.off_track": "[⚠ Вне плана: шаг {stepId} — \"{description}\", но вы используете {tool} для другого пути. Объясните или вернитесь.]",
+    "exec.stuck": "Нет прогресса на шаге {stepId} ({description}) — {iterations} итераций.",
+    "exec.stuck_recovery": "Шаг {stepId} — \"{description}\" — без прогресса уже {iterations} итераций. Попробуйте другой подход: проверьте что нужно для этого шага, установлены ли зависимости, или создайте файлы напрямую через write_file вместо команд терминала. После завершения шага вызовите plan update step={stepId} status=done.",
+    "exec.tool_errors": "Инструмент {tool} упал {count} раз. Попробуйте другой инструмент.",
+    "exec.tool_errors_recovery": "Инструмент {tool} упал {count} раз подряд. Попробуйте альтернативу: создайте файлы напрямую через write_file, используйте другую команду, или пропустите этот шаг через plan update step=N status=skipped с пометкой почему.",
+    "exec.repetitive_tool": "Инструмент {tool} вызван {count} раз с одинаковыми аргументами и результатом. Попробуйте другой подход — создайте файлы напрямую, измените аргументы или проверьте статус процесса через process_log.",
+    "exec.consecutive_failures_recovery": "{count} инструментов подряд упали. Создавайте файлы напрямую через write_file вместо команд терминала. Проверьте что зависимости установлены (npm install). Не запускайте сборку/тесты пока не созданы все файлы.",
+    "exec.plan_warning": "Текущий шаг плана {step} — \"{description}\", но вызывается {tool} для файлов вне этого шага. Завершите текущий шаг, вызовите plan update step={step} status=done, затем переходите к следующему.",
+    "exec.plan_blocked": "{max} вызовов подряд вне текущего шага. Завершите шаг {step} — остальные шаги ждут пока этот не будет выполнен.",
+    "exec.off_track": "Шаг {stepId} — \"{description}\", но используется {tool} для другого пути. Вернитесь к текущему шагу.",
+    "exec.step_gate_deps": "[⚠ Шаг {step} \"{description}\": зависимости не установлены. Сначала выполните команду установки (npm install, pip install и т.д.). Проверьте что lock-файл или директория зависимостей существует. Если этот шаг на самом деле не нужен (внешних зависимостей нет) — пропусти его: plan update step={step} status=skipped note=\"зависимости не нужны\".]",
+    "exec.step_gate_deps_force": "[⚠ Шаг {step}: зависимости всё ещё не установлены (нет lock-файла) — второе предупреждение. Если этот шаг НЕ нужен — НЕМЕДЛЕННО вызови: plan update step={step} status=skipped note=\"зависимости не нужны\". Если нужен — выполни установку прямо сейчас. Не делай других вызовов инструментов до обновления плана.]",
+    "exec.step_gate_empty": "[⚠ Шаг {step}: файлы существуют, но выглядят пустыми: {files}. Добавьте реальный код в эти файлы перед тем как переходить к следующему шагу.]",
+    "exec.step_gate_ok": "[✓] Шаг {step} завершён и проверен. ПЕРЕХОДИМ к шагу {nextStep}: \"{nextDesc}\". Работайте ТОЛЬКО над этим шагом.",
+    "exec.step_gate_last": "[✓] Шаг {step} завершён — это был последний шаг. Проверьте всё вместе и предоставьте финальный ответ.]",
     "exec.audit_pass": "[✓] Задача выполнена: {done}/{total} шагов, {files} файлов проверено",
     "exec.audit_fail": "[✗] Задача не выполнена: {done}/{total} шагов, {files} файлов отсутствует",
     "exec.audit_fail_typecheck": "[✗] Задача не выполнена: {done}/{total} шагов, {missing} файлов отсутствует, ошибка typecheck: {typeError}",
     "exec.audit_incomplete": "[⚠ Финальная проверка не пройдена: {summary}. Задача НЕ завершена — продолжайте работу. Оставшиеся шаги: {steps}]",
+    "exec.mass_edit_warning": "⚠️ План затрагивает {count} файлов — проверьте полный список перед продолжением.",
+    "exec.escalation": "\n\n⚠️ Агент застрял на шаге {stepId} ({description}). Эскалация к пользователю — пожалуйста, подскажите как действовать.",
+    "exec.hints": "\n[Подсказки]\n{hints}",
+    "exec.file_rewrite_warning": "⚠️ Файл {file} был перезаписан {count} раз. Попробуйте другой подход — текущая стратегия исправлений не работает.",
     "hall.max_retries_exhausted": "Модель вернула пустой или недостаточный ответ после нескольких попыток",
     "hall.short_response": "Слишком короткий или пустой ответ",
     "hall.repetitive": "Слишком повторяющийся ответ ({pct}% совпадение)",
     "hall.uncertainty": "Маркеры неопределённости: {markers}",
     "hall.unknown_paths": "Упомянутые файлы не найдены: {paths}",
-    "hall.contradiction": "Противоречит предыдущему решению: \"{decision}\" в {location}",
+    "hall.contradiction_llm": "Противоречит ранее принятому решению{reason}",
     "hall.uncertainty_prefix": "\n\n[⚠️ Неопределённость] ",
     "browser.repeated_action": "Вы повторили то же действие ({action}) {threshold} раз. Попробуйте другой подход: используйте \"snapshot\" для перечитки страницы, другие номера элементов или другой URL.",
     "browser.unknown_action": "Неизвестное действие: {action}",
@@ -457,5 +514,12 @@
     "tool.remember.entry_required": "Требуется текст записи",
     "tool.recall.empty": "Ничего не найдено по \"{query}\"",
     "tool.recall.no_memory": "Память пуста",
-    "tool.recall.search_results": "Результаты {category}:\n{results}"
+    "tool.recall.search_results": "Результаты {category}:\n{results}",
+    "ctx.compactions": "сжатий: {count}",
+    "ctx.quality": "качество: {percent}%",
+    "ctx.delta_pos": "контекст +{tokens}",
+    "ctx.delta_neg": "контекст -{tokens} ↓",
+    "ctx.delta_zero": "контекст ±0",
+    "file.notfound_resolved": "Файл не найден: {path} (резолвится в {resolved})",
+    "bash.echo_write_blocked": "Запись файлов через echo/printf ненадёжна в Windows cmd.exe (кавычки и многострочность ломаются). Используй инструмент write_file вместо этого (цель: {path})."
 }

package/dist/index.js

@@ -1,22 +1,22 @@
-export { DEFAULTS, loadConfig } from './config/index';
-export { Logger } from './logger/index';
-export { PromptBuilder } from './core/index';
-export { OpenAICompatProvider, TokenCounter, parseChunks, OrchestratorClient } from './llm/index';
-export { ToolRegistry, ToolExecutor, readFileTool, writeFileTool, editFileTool, globTool, grepTool, listDirTool, createDirTool, deleteFileTool, moveFileTool, fileInfoTool, bashTool, subagentTool, webSearchTool, webFetchTool, webBrowseTool, questionTool, approveTool, createLoadSkillTool, pipelineRunTool, mcpCallTool, searchHistoryTool, registerAllTools, } from './tools/index';
-export { MigrationDetector, BackupManager } from './migration/index';
-import { MigrationDetector } from './migration/detect';
-import { BackupManager } from './migration/backup';
-import { t } from './i18n/index';
-import { homedir } from 'os';
-import { join } from 'path';
+export { DEFAULTS, loadConfig } from "./config/index";
+export { Logger } from "./logger/index";
+export { PromptBuilder } from "./core/index";
+export { OpenAICompatProvider, TokenCounter, parseChunks, OrchestratorClient, } from "./llm/index";
+export { ToolRegistry, ToolExecutor, readFileTool, writeFileTool, editFileTool, globTool, grepTool, listDirTool, createDirTool, deleteFileTool, moveFileTool, fileInfoTool, bashTool, subagentTool, webSearchTool, webFetchTool, webBrowseTool, createLoadSkillTool, pipelineRunTool, mcpCallTool, searchHistoryTool, registerAllTools, } from "./tools/index";
+export { MigrationDetector, BackupManager } from "./migration/index";
+import { MigrationDetector } from "./migration/detect";
+import { BackupManager } from "./migration/backup";
+import { t } from "./i18n/index";
+import { homedir } from "os";
+import { join } from "path";
 export function checkMigration(configDir) {
-    const dir = configDir || join(homedir(), '.mma');
+    const dir = configDir || join(homedir(), ".mma");
     const detector = new MigrationDetector(dir);
     if (detector.needsMigration()) {
         const backup = new BackupManager(dir);
         backup.backupConfig();
         backup.backupAll();
         const summary = backup.getBackupSummary();
-        console.log(t('migration.summary', { summary }));
+        console.log(t("migration.summary", { summary }));
     }
 }

package/dist/llm/openai-compat.js

@@ -1,6 +1,6 @@
 import { TokenCounter } from "./token-counter";
 import { t } from "../i18n/index";
-import { createRateLimiter } from "../modules/security/rate-limiter";
+import { createRateLimiter, } from "../modules/security/rate-limiter";
 export class OpenAICompatProvider {
     model;
     contextWindow;
@@ -20,14 +20,14 @@ export class OpenAICompatProvider {
         };
         this.rateLimiter = createRateLimiter(config.rateLimits);
     }
-    async *chat(messages, tools) {
+    async *chat(messages, tools, signal) {
         // Check rate limit before making request
         if (!this.rateLimiter.canMakeRequest()) {
             throw new Error(`Rate limit exceeded: ${this.rateLimiter.getConfig().maxRequestsPerMinute} requests per minute`);
         }
         // Record this request
         this.rateLimiter.recordRequest();
-        const streamResult = this.doStream(messages, tools);
+        const streamResult = this.doStream(messages, tools, signal);
         let hasToolCall = false;
         let hasText = false;
         let reasoningAcc = "";
@@ -42,13 +42,13 @@ export class OpenAICompatProvider {
             yield chunk;
         }
         if (!hasToolCall && !hasText) {
-            const fallback = await this.doNonStreaming(messages, tools);
+            const fallback = await this.doNonStreaming(messages, tools, signal);
             for (const chunk of fallback) {
                 yield chunk;
             }
         }
     }
-    async *doStream(messages, tools) {
+    async *doStream(messages, tools, signal) {
         const body = {
             model: this.model,
             messages,
@@ -75,11 +75,24 @@ export class OpenAICompatProvider {
         const controller = new AbortController();
         const totalTimeoutMs = 120000;
         const timeoutId = setTimeout(() => controller.abort(), totalTimeoutMs);
+        const abortSignal = (() => {
+            if (!signal)
+                return controller.signal;
+            try {
+                return AbortSignal.any([controller.signal, signal]);
+            }
+            catch {
+                signal.addEventListener("abort", () => controller.abort(), {
+                    once: true,
+                });
+                return controller.signal;
+            }
+        })();
         const response = await this.fetchWithRetry(`${this.config.baseUrl}/chat/completions`, {
             method: "POST",
             headers,
             body: JSON.stringify(body),
-            signal: controller.signal,
+            signal: abortSignal,
         });
         if (!response.ok) {
             clearTimeout(timeoutId);
@@ -182,7 +195,7 @@ export class OpenAICompatProvider {
             reader.releaseLock();
         }
     }
-    async doNonStreaming(messages, tools) {
+    async doNonStreaming(messages, tools, signal) {
         const body = {
             model: this.model,
             messages,
@@ -211,6 +224,7 @@ export class OpenAICompatProvider {
                 method: "POST",
                 headers,
                 body: JSON.stringify(body),
+                signal,
             });
             if (!response.ok) {
                 const errorText = await response.text();
@@ -310,7 +324,7 @@ export class OpenAICompatProvider {
             if (attempt < maxRetries) {
                 const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
                 const jitter = Math.random() * baseDelay * 0.1;
-                await this.sleep(delay + jitter);
+                await this.sleep(delay + jitter, init.signal ?? undefined);
             }
         }
         throw lastError ?? new Error(t("error.llm_retries"));
@@ -318,7 +332,22 @@ export class OpenAICompatProvider {
     isRetryable(status) {
         return status === 429 || status >= 500;
     }
-    sleep(ms) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
+    sleep(ms, signal) {
+        return new Promise((resolve, reject) => {
+            if (signal?.aborted) {
+                reject(new DOMException("Aborted", "AbortError"));
+                return;
+            }
+            let timer;
+            const onAbort = () => {
+                clearTimeout(timer);
+                reject(new DOMException("Aborted", "AbortError"));
+            };
+            timer = setTimeout(() => {
+                signal?.removeEventListener("abort", onAbort);
+                resolve();
+            }, ms);
+            signal?.addEventListener("abort", onAbort, { once: true });
+        });
     }
 }

package/dist/logger/app-logger.js

@@ -1,14 +1,28 @@
-import { appendFileSync, mkdirSync, existsSync } from 'fs';
-import { join } from 'path';
-import { sanitizeLogMessage } from '../modules/security/data-sanitizer';
+import { appendFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { sanitizeLogMessage } from "../modules/security/data-sanitizer";
+import { FileLogWriter } from "./file-log";
+import pc from "picocolors";
 const LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+const LEVEL_COLORS = {
+    debug: (s) => pc.dim(s),
+    info: (s) => s,
+    warn: (s) => pc.yellow(s),
+    error: (s) => pc.red(s),
+};
+function isColorEnabled() {
+    return (!process.env.NO_COLOR && !process.env.CI && process.stdout.isTTY === true);
+}
 export class Logger {
     level;
     prefix;
     logDir = null;
-    constructor(level = 'info', prefix = '') {
+    sessionDir = null;
+    fileLog;
+    constructor(level = "info", prefix = "") {
         this.level = level;
         this.prefix = prefix;
+        this.fileLog = new FileLogWriter();
     }
     setLevel(level) {
         this.level = level;
@@ -18,24 +32,66 @@ export class Logger {
         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;
+    }
+    /** Open a per-session `.log` file (legacy v1 behavior). */
+    initSessionLog(sessionId) {
+        this.fileLog.initSessionLog(sessionId);
+    }
+    /** Fall back to daily log files when no session is active. */
+    closeSessionLog() {
+        this.fileLog.closeSessionLog();
+    }
+    getLogPath() {
+        return this.fileLog.getLogPath();
+    }
+    cleanupOldLogs(maxDays, maxFiles) {
+        this.fileLog.cleanupOldLogs(maxDays, maxFiles);
+    }
+    // --- Tagged helpers (legacy v1 API) ---
+    logLLMRequest(model, messagesCount, promptPreview, caller) {
+        this.fileLog.logLLMRequest(model, messagesCount, promptPreview, caller);
+    }
+    logLLMResponse(model, responseLength, genTimeMs, error, caller) {
+        this.fileLog.logLLMResponse(model, responseLength, genTimeMs, error, caller);
+    }
+    logToolCall(tool, preview, result) {
+        this.fileLog.logToolCall(tool, preview, result);
+    }
+    logToolOutput(tool, output, exitCode) {
+        this.fileLog.logToolOutput(tool, output, exitCode);
+    }
+    logREPL(tag, content) {
+        this.fileLog.logREPL(tag, content);
     }
     child(prefix) {
         const childLogger = new Logger(this.level, this.prefix ? `${this.prefix}:${prefix}` : prefix);
         if (this.logDir)
             childLogger.setLogDir(this.logDir);
+        if (this.sessionDir)
+            childLogger.setSessionDir(this.sessionDir);
         return childLogger;
     }
     debug(msg, meta) {
-        this.log('debug', msg, meta);
+        this.log("debug", msg, meta);
     }
     info(msg, meta) {
-        this.log('info', msg, meta);
+        this.log("info", msg, meta);
     }
     warn(msg, meta) {
-        this.log('warn', msg, meta);
+        this.log("warn", msg, meta);
     }
     error(msg, meta) {
-        this.log('error', msg, meta);
+        this.log("error", msg, meta);
     }
     log(level, msg, meta) {
         if (LEVELS[level] < LEVELS[this.level])
@@ -44,15 +100,26 @@ export class Logger {
         const sanitizedMsg = sanitizeLogMessage(msg);
         const sanitizedMeta = meta ? this.sanitizeMeta(meta) : undefined;
         const ts = new Date().toISOString();
-        const prefix = this.prefix ? ` [${this.prefix}]` : '';
-        const metaStr = sanitizedMeta ? ` ${JSON.stringify(sanitizedMeta)}` : '';
+        const prefix = this.prefix ? ` [${this.prefix}]` : "";
+        const metaStr = sanitizedMeta ? ` ${JSON.stringify(sanitizedMeta)}` : "";
         const line = `[${level.toUpperCase()}]${prefix} ${ts} — ${sanitizedMsg}${metaStr}`;
-        console.log(line);
-        if (this.logDir) {
+        console.log(isColorEnabled() ? LEVEL_COLORS[level](line) : line);
+        // Legacy v1 behavior: also append to the tagged `.log` file (session or daily).
+        this.fileLog.log(level.toUpperCase(), this.prefix || "MMA", `${ts} — ${sanitizedMsg}${metaStr}`);
+        const logTarget = this.sessionDir ?? this.logDir;
+        if (logTarget) {
             try {
-                appendFileSync(join(this.logDir, 'app.jsonl'), JSON.stringify({ level, ts, prefix: this.prefix, msg: sanitizedMsg, meta: sanitizedMeta ?? null }) + '\n', 'utf-8');
+                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 */
             }
-            catch { /* file logging is best-effort */ }
         }
     }
     /**
@@ -61,10 +128,10 @@ export class Logger {
     sanitizeMeta(meta) {
         const sanitized = {};
         for (const [key, value] of Object.entries(meta)) {
-            if (typeof value === 'string') {
+            if (typeof value === "string") {
                 sanitized[key] = sanitizeLogMessage(value);
             }
-            else if (typeof value === 'object' && value !== null) {
+            else if (typeof value === "object" && value !== null) {
                 sanitized[key] = this.sanitizeMeta(value);
             }
             else {