micro-models-agent 0.45.0 → 0.46.2

package/dist/main.js

@@ -2263,7 +2263,9 @@ var init_defaults = __esm(() => {
     retry: {
       maxRetries: 3,
       baseDelay: 1000,
-      maxDelay: 30000
+      maxDelay: 30000,
+      maxStreamRetries: 2,
+      noDataTimeoutMs: 60000
     },
     maxToolIterations: 1000,
     stuckThreshold: 6,
@@ -2396,6 +2398,14 @@ Use read_file on {path} to see the current content before editing — the target
     "error.llm_retries": "LLM request failed after retries",
     "error.llm_429": "Rate limit exceeded (HTTP 429) for {model} on {baseUrl}. The provider is throttling requests — free models are especially strict. Get an API key or switch to a paid/faster model: {baseUrl}",
     "error.no_response_body": "No response body stream",
+    "error.llm_stream_idle": "LLM stream stalled — no data for {timeout}ms",
+    "error.llm_timeout": "LLM request timed out ({timeout}ms)",
+    "env.runtime_node": "Running under Node (v{version}) — clipboard image paste, subagent performance and LSP spawn on Windows degrade. Install Bun (https://bun.sh) for full features.",
+    "env.runtime_old": "Runtime version {version} is below the required engines {engine}.",
+    "env.tool_missing": "Tool not found on PATH: {tool}",
+    "env.playwright_missing": "Playwright package is not installed — the browser tool will fail. Install with: bun add playwright",
+    "env.playwright_browsers_missing": "Playwright browsers not downloaded ({dir}). The browser tool will fail. Install with: bunx playwright install chromium",
+    "env.crash_stderr": "MMA crashed ({type}): {message} — crash report written to ~/.mma/logs/crash.jsonl",
     "session.started": "Session started: {id}",
     "session.ended": "Session ended: {id}",
     "session.not_found": "Session not found: {id}",
@@ -2779,6 +2789,19 @@ Available commands:`,
     "repl.lsp_timeout": "timeout",
     "repl.lsp_failed": "did not start",
     "repl.lsp_unknown": "unknown",
+    "repl.lsp": "LSP server management (status, restart, check)",
+    "repl.lsp_usage": "Usage: /lsp [status|restart|check <path>]",
+    "repl.lsp_not_available": "LSP module not available",
+    "repl.lsp_status_header": "LSP Status:",
+    "repl.lsp_enabled": "Enabled:",
+    "repl.lsp_disabled_servers": "Disabled servers:",
+    "repl.lsp_failure_counts": "Failure counts:",
+    "repl.lsp_all_ok": "All servers operational",
+    "repl.lsp_restarting": "Resetting LSP server state...",
+    "repl.lsp_restarted": "LSP servers reset. Failed servers will be retried on next use.",
+    "repl.lsp_check_usage": "Usage: /lsp check <file-or-directory>",
+    "repl.lsp_checking": "Running LSP check on {path}...",
+    "repl.lsp_check_error": "LSP check failed: {error}",
     "repl.work_dir": "Dir:",
     "repl.agents_label": "Instructions:",
     "repl.not_found": "not found",
@@ -3059,6 +3082,14 @@ var init_ru = __esm(() => {
     "error.llm_retries": "Запрос LLM не удался после повторов",
     "error.llm_429": "Превышен лимит запросов (HTTP 429) для {model} на {baseUrl}. Провайдер ограничивает трафик — особенно строгие free-модели. Получите API-ключ или переключитесь на платную/быструю модель: {baseUrl}",
     "error.no_response_body": "Нет потока тела ответа",
+    "error.llm_stream_idle": "Поток LLM завис — нет данных {timeout}мс",
+    "error.llm_timeout": "Время запроса LLM истекло ({timeout}мс)",
+    "env.runtime_node": "Запущено под Node (v{version}) — вставка изображений из буфера и LSP на Windows работают урезанно. Установите Bun (https://bun.sh) для полного функционала.",
+    "env.runtime_old": "Версия рантайма {version} ниже требуемой engines {engine}.",
+    "env.tool_missing": "Инструмент не найден в PATH: {tool}",
+    "env.playwright_missing": "Пакет Playwright не установлен — браузерный инструмент не будет работать. Установите: bun add playwright",
+    "env.playwright_browsers_missing": "Браузеры Playwright не скачаны ({dir}). Браузерный инструмент не будет работать. Установите: bunx playwright install chromium",
+    "env.crash_stderr": "MMA упал ({type}): {message} — отчёт о падении записан в ~/.mma/logs/crash.jsonl",
     "session.started": "Сессия начата: {id}",
     "session.ended": "Сессия завершена: {id}",
     "session.not_found": "Сессия не найдена: {id}",
@@ -3437,6 +3468,19 @@ var init_ru = __esm(() => {
     "repl.lsp_timeout": "таймаут",
     "repl.lsp_failed": "не стартовал",
     "repl.lsp_unknown": "неизвестно",
+    "repl.lsp": "Управление LSP-серверами (status, restart, check)",
+    "repl.lsp_usage": "Использование: /lsp [status|restart|check <путь>]",
+    "repl.lsp_not_available": "Модуль LSP недоступен",
+    "repl.lsp_status_header": "Статус LSP:",
+    "repl.lsp_enabled": "Включён:",
+    "repl.lsp_disabled_servers": "Отключённые серверы:",
+    "repl.lsp_failure_counts": "Количество ошибок:",
+    "repl.lsp_all_ok": "Все серверы работают",
+    "repl.lsp_restarting": "Сброс состояния LSP-серверов...",
+    "repl.lsp_restarted": "LSP-серверы сброшены. Упавшие серверы будут повторно запущены при следующем использовании.",
+    "repl.lsp_check_usage": "Использование: /lsp check <файл-или-каталог>",
+    "repl.lsp_checking": "Запуск LSP-проверки {path}...",
+    "repl.lsp_check_error": "LSP-проверка не удалась: {error}",
     "repl.work_dir": "Директория:",
     "repl.agents_label": "Инструкции:",
     "repl.not_found": "не найден",
@@ -4596,6 +4640,20 @@ class Logger {
     }
     return sanitized;
   }
+  logStructured(type, data) {
+    const logTarget = this.sessionDir ?? this.logDir;
+    if (!logTarget)
+      return;
+    try {
+      appendFileSync2(join6(logTarget, "app.jsonl"), JSON.stringify({
+        level: "info",
+        ts: new Date().toISOString(),
+        type,
+        meta: this.sanitizeMeta(data)
+      }) + `
+`, "utf-8");
+    } catch {}
+  }
 }
 var import_picocolors, LEVELS, LEVEL_COLORS;
 var init_app_logger = __esm(() => {
@@ -5172,7 +5230,9 @@ class OpenAICompatProvider {
     this.retryConfig = config.retry ?? {
       maxRetries: 3,
       baseDelay: 1000,
-      maxDelay: 30000
+      maxDelay: 30000,
+      maxStreamRetries: 2,
+      noDataTimeoutMs: 60000
     };
     this.rateLimiter = createRateLimiter(config.rateLimits);
   }
@@ -5203,6 +5263,32 @@ class OpenAICompatProvider {
     }
   }
   async* doStream(messages, tools, signal, options) {
+    const { baseDelay, maxDelay, maxStreamRetries, noDataTimeoutMs } = this.retryConfig;
+    const streamRetries = maxStreamRetries ?? 2;
+    const idleTimeoutMs = noDataTimeoutMs ?? 60000;
+    for (let attempt = 0;; attempt++) {
+      let emitted = false;
+      const onEmit = () => {
+        emitted = true;
+      };
+      try {
+        const sawDone = yield* this.streamOnce(messages, tools, signal, options, onEmit, idleTimeoutMs);
+        if (sawDone || emitted)
+          return;
+        if (attempt >= streamRetries)
+          return;
+      } catch (err) {
+        if (err?.name === "AbortError" || err?.llmTerminal || signal?.aborted)
+          throw err;
+        if (emitted || attempt >= streamRetries)
+          throw err;
+      }
+      const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+      const jitter = Math.random() * baseDelay * 0.1;
+      await this.sleep(delay + jitter, signal);
+    }
+  }
+  async* streamOnce(messages, tools, signal, options, onEmit, idleTimeoutMs) {
     const body = buildRequestBody({
       model: this.model,
       messages,
@@ -5218,8 +5304,11 @@ class OpenAICompatProvider {
       headers["Authorization"] = `Bearer ${this.config.apiKey}`;
     }
     const controller = new AbortController;
-    const totalTimeoutMs = 120000;
-    const timeoutId = setTimeout(() => controller.abort(), totalTimeoutMs);
+    let timedOut = false;
+    const timeoutId = setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, REQUEST_TIMEOUT_MS);
     const abortSignal = (() => {
       if (!signal)
         return controller.signal;
@@ -5232,20 +5321,31 @@ class OpenAICompatProvider {
         return controller.signal;
       }
     })();
-    const response = await this.fetchWithRetry(`${this.config.baseUrl}/chat/completions`, {
-      method: "POST",
-      headers,
-      body: JSON.stringify(body),
-      signal: abortSignal
-    });
+    let response;
+    try {
+      response = await this.fetchWithRetry(`${this.config.baseUrl}/chat/completions`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+        signal: abortSignal
+      });
+    } catch (err) {
+      if (err?.name === "AbortError")
+        throw err;
+      const wrapped = err instanceof Error ? err : new Error(String(err));
+      wrapped.llmTerminal = true;
+      throw wrapped;
+    }
     if (!response.ok) {
       clearTimeout(timeoutId);
       const errorText = await response.text();
-      throw new Error(t("error.llm_api", {
+      const err = new Error(t("error.llm_api", {
         status: response.status,
         statusText: response.statusText,
         errorText
       }));
+      err.llmTerminal = true;
+      throw err;
     }
     const reader = response.body?.getReader();
     if (!reader) {
@@ -5256,9 +5356,29 @@ class OpenAICompatProvider {
     let buffer = "";
     const toolCallAccs = new Map;
     let usage;
+    let sawDone = false;
+    const readIdle = () => new Promise((resolve, reject) => {
+      const idleTimer = setTimeout(() => {
+        timedOut = true;
+        controller.abort();
+      }, idleTimeoutMs);
+      reader.read().then((result) => {
+        clearTimeout(idleTimer);
+        if (timedOut)
+          reject(new Error(t("error.llm_stream_idle", { timeout: idleTimeoutMs })));
+        else
+          resolve(result);
+      }, (err) => {
+        clearTimeout(idleTimer);
+        if (timedOut)
+          reject(new Error(t("error.llm_stream_idle", { timeout: idleTimeoutMs })));
+        else
+          reject(err);
+      });
+    });
     try {
       while (true) {
-        const { done, value } = await reader.read();
+        const { done, value } = await readIdle();
         if (done)
           break;
         buffer += decoder.decode(value, { stream: true });
@@ -5270,8 +5390,10 @@ class OpenAICompatProvider {
           if (!trimmed || !trimmed.startsWith("data: "))
             continue;
           const data = trimmed.slice(6);
-          if (data === "[DONE]")
+          if (data === "[DONE]") {
+            sawDone = true;
             continue;
+          }
           try {
             const parsed = JSON.parse(data);
             const choice = parsed.choices?.[0];
@@ -5288,6 +5410,7 @@ class OpenAICompatProvider {
             const delta = choice.delta || {};
             const finishReason = choice.finish_reason;
             if (delta.reasoning_content) {
+              onEmit();
               yield { type: "reasoning", content: delta.reasoning_content };
             }
             if (delta.tool_calls) {
@@ -5307,11 +5430,13 @@ class OpenAICompatProvider {
               }
             }
             if (delta.content) {
+              onEmit();
               yield { type: "text", content: delta.content };
             }
             if (finishReason === "tool_calls" && toolCallAccs.size > 0) {
               for (const [, acc] of toolCallAccs) {
                 if (acc.name) {
+                  onEmit();
                   yield {
                     type: "tool_call",
                     toolCall: {
@@ -5328,12 +5453,14 @@ class OpenAICompatProvider {
         }
       }
       if (usage) {
+        onEmit();
         yield { type: "done", usage };
       }
     } finally {
       clearTimeout(timeoutId);
       reader.releaseLock();
     }
+    return sawDone;
   }
   async doNonStreaming(messages, tools, signal, options) {
     const body = buildRequestBody({
@@ -5350,12 +5477,30 @@ class OpenAICompatProvider {
     if (this.config.apiKey && this.config.apiKey !== "not-needed") {
       headers["Authorization"] = `Bearer ${this.config.apiKey}`;
     }
+    const controller = new AbortController;
+    let timedOut = false;
+    const timeoutId = setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, REQUEST_TIMEOUT_MS);
+    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;
+      }
+    })();
     try {
       const response = await this.fetchWithRetry(`${this.config.baseUrl}/chat/completions`, {
         method: "POST",
         headers,
         body: JSON.stringify(body),
-        signal
+        signal: abortSignal
       });
       if (!response.ok) {
         const errorText = await response.text();
@@ -5402,7 +5547,12 @@ class OpenAICompatProvider {
       }
       return chunks;
     } catch (err) {
+      if (timedOut && err?.name === "AbortError") {
+        throw new Error(t("error.llm_timeout", { timeout: REQUEST_TIMEOUT_MS }));
+      }
       throw err instanceof Error ? err : new Error(String(err));
+    } finally {
+      clearTimeout(timeoutId);
     }
   }
   countTokens(text) {
@@ -5486,6 +5636,7 @@ class OpenAICompatProvider {
     });
   }
 }
+var REQUEST_TIMEOUT_MS = 120000;
 var init_openai_compat = __esm(() => {
   init_token_counter();
   init_i18n();
@@ -11587,6 +11738,7 @@ ${t("tool.truncated", { tokens: Math.ceil(removedChars / 2) })}`;
     onPhase?.(phase);
   }
   async run(input, onChunk, onMeta, onTool, onPhase) {
+    this.shutdownRequested = false;
     this.setScope();
     const {
       config,
@@ -12259,7 +12411,6 @@ ${warnLine}
     if (killed > 0) {
       logger.info(`Killed ${killed} background process(es) on shutdown`);
     }
-    logger.closeSessionLog();
     pluginManager.runOnSessionEnd({
       logger,
       sessionManager: sessionManager?.getActiveMeta(),
@@ -19915,6 +20066,10 @@ import { resolve as resolve20 } from "path";
 import { platform as platform8 } from "os";
 
 class LspClient {
+  logger = null;
+  setLogger(logger) {
+    this.logger = logger;
+  }
   process = null;
   requestId = 0;
   pending = new Map;
@@ -19974,11 +20129,25 @@ class LspClient {
     try {
       await this.sendRequest("initialize", initParams, timeout);
     } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      this.logger?.warn(`LSP initialize failed (attempt 1): ${msg}`, {
+        command: config.command,
+        projectRoot
+      });
       if (!(e instanceof Error) || !e.message.includes("initialize"))
         throw e;
       await this.shutdown();
       await this.startServer(config, projectRoot);
-      await this.sendRequest("initialize", initParams, timeout);
+      try {
+        await this.sendRequest("initialize", initParams, timeout);
+      } catch (retryErr) {
+        const retryMsg = retryErr instanceof Error ? retryErr.message : String(retryErr);
+        this.logger?.error(`LSP initialize failed (attempt 2, giving up): ${retryMsg}`, {
+          command: config.command,
+          projectRoot
+        });
+        throw retryErr;
+      }
     }
     this.initialized = true;
   }
@@ -20016,8 +20185,11 @@ class LspClient {
       });
       this.process = proc;
       setTimeout(() => {
-        if (!this.initialized && this.process)
-          reject(new Error("LSP server start timeout"));
+        if (!this.initialized && this.process) {
+          const msg = "LSP server start timeout";
+          this.logger?.error(msg, { command: config.command, projectRoot, timeout: config.timeout ?? 1e4 });
+          reject(new Error(msg));
+        }
       }, config.timeout ?? 1e4);
     });
   }
@@ -20056,7 +20228,9 @@ class LspClient {
       try {
         const msg = JSON.parse(body);
         this.handleMessage(msg);
-      } catch {}
+      } catch (e) {
+        this.logger?.debug(`LSP JSON parse error: ${e instanceof Error ? e.message : String(e)}`);
+      }
     }
   }
   handleMessage(msg) {
@@ -20094,7 +20268,9 @@ class LspClient {
       setTimeout(() => {
         if (this.pending.has(id)) {
           this.pending.delete(id);
-          reject(new Error(`LSP request timeout: ${method}`));
+          const msg = `LSP request timeout: ${method}`;
+          this.logger?.warn(msg, { method, timeout });
+          reject(new Error(msg));
         }
       }, timeout);
     });
@@ -20104,27 +20280,37 @@ class LspClient {
     this.write(message);
   }
   write(message) {
-    if (!this.process?.stdin?.writable)
+    if (!this.process?.stdin?.writable) {
+      this.logger?.debug("LSP write failed: process stdin not writable");
       return;
+    }
     const header = `Content-Length: ${Buffer.byteLength(message)}\r
 \r
 `;
     try {
       this.process.stdin.write(header + message);
-    } catch {}
+    } catch (e) {
+      this.logger?.debug(`LSP write error: ${e instanceof Error ? e.message : String(e)}`);
+    }
   }
   async shutdown() {
     try {
       if (this.process && this.initialized && this.process.stdin?.writable) {
-        this.sendRequest("shutdown", null, 3000).catch(() => {});
+        this.sendRequest("shutdown", null, 3000).catch((e) => {
+          this.logger?.debug(`LSP shutdown request failed: ${e instanceof Error ? e.message : String(e)}`);
+        });
         this.sendNotification("exit", null);
         await new Promise((r) => setTimeout(r, 200));
       }
-    } catch {} finally {
+    } catch (e) {
+      this.logger?.debug(`LSP shutdown error: ${e instanceof Error ? e.message : String(e)}`);
+    } finally {
       if (this.process) {
         try {
           killTree(this.process);
-        } catch {}
+        } catch (e) {
+          this.logger?.debug(`LSP killTree error: ${e instanceof Error ? e.message : String(e)}`);
+        }
         this.process = null;
       }
       this.initialized = false;
@@ -20232,9 +20418,26 @@ class LspModule {
   client;
   failuresByServer = new Map;
   disabledServers = new Set;
-  constructor(config, client) {
+  logger = null;
+  constructor(config, client, logger) {
     this.config = { ...DEFAULT_LSP_CONFIG, ...config };
     this.client = client ?? new LspClient;
+    this.logger = logger ?? null;
+    this.client.setLogger(this.logger);
+  }
+  setLogger(logger) {
+    this.logger = logger;
+    this.client.setLogger(logger);
+  }
+  resetDisabledServers() {
+    this.failuresByServer.clear();
+    this.disabledServers.clear();
+  }
+  getDisabledServers() {
+    return Array.from(this.disabledServers);
+  }
+  getFailureCounts() {
+    return new Map(this.failuresByServer);
   }
   isLspDisabled() {
     return this.disabledServers.size > 0;
@@ -20505,7 +20708,9 @@ async function runCheck(config, baseDir, deps) {
           lines.push(formatStartupError(file, baseDir, d));
         }
       }
-    } catch {}
+    } catch (e) {
+      deps.logger?.debug(`Startup LSP check failed for ${file}: ${e instanceof Error ? e.message : String(e)}`);
+    }
   }
   if (checked === 0 || lines.length === 0)
     return null;
@@ -21395,15 +21600,197 @@ function readMmaVersion() {
 }
 var init_version = () => {};
 
+// src/core/environment.ts
+import { existsSync as existsSync44, readFileSync as readFileSync27, readdirSync as readdirSync15 } from "fs";
+import { spawnSync as spawnSync2 } from "child_process";
+import { createRequire as createRequire2 } from "module";
+import { join as join37, dirname as dirname14 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+import { arch, homedir as homedir11, hostname as hostname2, platform as platform9, release } from "os";
+import { env as env2 } from "process";
+function readEngineRequirement() {
+  const here = dirname14(fileURLToPath3(import.meta.url));
+  const candidates = [join37(here, "..", "..", "package.json"), join37(here, "..", "package.json")];
+  for (const p of candidates) {
+    if (!existsSync44(p))
+      continue;
+    try {
+      const raw = JSON.parse(readFileSync27(p, "utf8"));
+      if (raw.engines?.node)
+        return String(raw.engines.node);
+    } catch {}
+  }
+  return ">=20";
+}
+function satisfiesMinimum(version, requirement) {
+  const minMatch = requirement.match(/(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
+  if (!minMatch)
+    return true;
+  const min = [
+    parseInt(minMatch[1], 10),
+    minMatch[2] ? parseInt(minMatch[2], 10) : 0,
+    minMatch[3] ? parseInt(minMatch[3], 10) : 0
+  ];
+  const parts = version.replace(/^v/i, "").split(".");
+  const got = [
+    parts[0] ? parseInt(parts[0], 10) : 0,
+    parts[1] ? parseInt(parts[1], 10) : 0,
+    parts[2] ? parseInt(parts[2], 10) : 0
+  ];
+  for (let i = 0;i < 3; i++) {
+    if (got[i] > min[i])
+      return true;
+    if (got[i] < min[i])
+      return false;
+  }
+  return true;
+}
+function detectRuntime() {
+  const bun = globalThis.Bun;
+  const isBun = typeof bun !== "undefined" && typeof bun?.version !== "undefined";
+  const engine2 = readEngineRequirement();
+  const runtime = isBun ? "bun" : "node";
+  const runtimeVersion = isBun ? String(bun.version) : process.version;
+  return {
+    runtime,
+    runtimeVersion,
+    nodeVersion: process.version,
+    engine: engine2,
+    engineOk: satisfiesMinimum(process.version, engine2)
+  };
+}
+function toolVersion(cmd) {
+  try {
+    const res = spawnSync2(cmd, ["--version"], {
+      encoding: "utf8",
+      timeout: 3000,
+      windowsHide: true,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    if (res.error || res.status !== 0)
+      return "missing";
+    const out = ((res.stdout || "") + (res.stderr || "")).trim();
+    return out.split(/\r?\n/)[0].slice(0, 40) || "ok";
+  } catch {
+    return "missing";
+  }
+}
+function playwrightBrowsersDir() {
+  if (process.env.PLAYWRIGHT_BROWSERS_PATH)
+    return process.env.PLAYWRIGHT_BROWSERS_PATH;
+  return process.platform === "win32" ? join37(homedir11(), "AppData", "Local", "ms-playwright") : join37(homedir11(), ".cache", "ms-playwright");
+}
+function playwrightInfo() {
+  let installed = false;
+  let version = "";
+  const browsersDir = playwrightBrowsersDir();
+  try {
+    const require2 = createRequire2(import.meta.url);
+    const pkgPath = require2.resolve("playwright/package.json");
+    installed = existsSync44(pkgPath);
+    version = JSON.parse(readFileSync27(pkgPath, "utf8")).version || "";
+  } catch {
+    installed = false;
+  }
+  let browsersInstalled = false;
+  try {
+    if (existsSync44(browsersDir)) {
+      browsersInstalled = readdirSync15(browsersDir).some((d) => /chrom/i.test(d));
+    }
+  } catch {
+    browsersInstalled = false;
+  }
+  return { installed, version, browsersDir, browsersInstalled };
+}
+function checkEnvironmentRequirements(report) {
+  const warnings = [];
+  if (report.runtime.runtime === "node") {
+    warnings.push(t("env.runtime_node", { version: report.runtime.nodeVersion }));
+  }
+  if (!report.runtime.engineOk) {
+    warnings.push(t("env.runtime_old", {
+      version: report.runtime.nodeVersion,
+      engine: report.runtime.engine
+    }));
+  }
+  if (report.tools.bun === "missing") {
+    warnings.push(t("env.tool_missing", { tool: "bun" }));
+  }
+  if (report.tools.git === "missing") {
+    warnings.push(t("env.tool_missing", { tool: "git" }));
+  }
+  if (report.features.browser && report.playwright) {
+    if (!report.playwright.installed) {
+      warnings.push(t("env.playwright_missing"));
+    } else if (!report.playwright.browsersInstalled) {
+      warnings.push(t("env.playwright_browsers_missing", { dir: report.playwright.browsersDir }));
+    }
+  }
+  return warnings;
+}
+function collectEnvironment(opts) {
+  const runtime = detectRuntime();
+  const tools = {};
+  if (opts.scanTools) {
+    for (const tool of TOOL_CHECKS)
+      tools[tool] = toolVersion(tool);
+  }
+  const provider = opts.config ? {
+    model: opts.config.model,
+    baseUrl: sanitizeUrl(opts.config.provider?.baseUrl || ""),
+    contextWindow: opts.config.contextWindow,
+    retry: {
+      maxRetries: opts.config.retry?.maxRetries ?? 0,
+      baseDelay: opts.config.retry?.baseDelay ?? 0,
+      maxDelay: opts.config.retry?.maxDelay ?? 0,
+      maxStreamRetries: opts.config.retry?.maxStreamRetries ?? 0,
+      noDataTimeoutMs: opts.config.retry?.noDataTimeoutMs ?? 0
+    }
+  } : null;
+  const report = {
+    ts: new Date().toISOString(),
+    mmaVersion: readMmaVersion(),
+    runtime,
+    os: {
+      platform: platform9(),
+      arch: arch(),
+      release: release(),
+      hostname: hostname2(),
+      shell: env2.SHELL || env2.ComSpec || "unknown",
+      home: homedir11(),
+      cwd: process.cwd()
+    },
+    paths: { configDir: opts.configDir, baseDir: opts.baseDir || process.cwd() },
+    tools,
+    provider,
+    features: { browser: Boolean(opts.config?.browser?.enabled) },
+    playwright: playwrightInfo(),
+    warnings: []
+  };
+  report.warnings = checkEnvironmentRequirements(report);
+  return report;
+}
+function logEnvironment(report, logger) {
+  logger.info(`Environment: ${report.os.platform} ${report.os.arch} | ${report.runtime.runtime} ${report.runtime.runtimeVersion} (node ${report.runtime.nodeVersion}) | mma ${report.mmaVersion} | ${report.provider?.model ?? "no provider"}`);
+  logger.logStructured("environment", report);
+}
+var TOOL_CHECKS;
+var init_environment = __esm(() => {
+  init_version();
+  init_network_validator();
+  init_i18n();
+  TOOL_CHECKS = ["bun", "node", "git", "python"];
+});
+
 // src/core/bootstrap.ts
 var exports_bootstrap = {};
 __export(exports_bootstrap, {
   buildSystemInfo: () => buildSystemInfo,
   bootstrap: () => bootstrap
 });
-import { homedir as homedir11 } from "os";
-import { join as join37, resolve as resolve23 } from "path";
-import { existsSync as existsSync44, readFileSync as readFileSync27, writeFileSync as writeFileSync15 } from "fs";
+import { homedir as homedir12 } from "os";
+import { join as join38, resolve as resolve23 } from "path";
+import { existsSync as existsSync45, readFileSync as readFileSync28, writeFileSync as writeFileSync15 } from "fs";
 function buildSystemInfo(config, baseDir, profileCompressed) {
   const now = new Date().toISOString().replace("T", " ").slice(0, 19);
   const isWin = profileCompressed.toLowerCase().includes("win32");
@@ -21429,8 +21816,8 @@ function buildSystemInfo(config, baseDir, profileCompressed) {
 `);
 }
 async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
-  const dir = configDir || join37(homedir11(), ".mma");
-  const projectConfigPath = projectDir ? join37(projectDir, ".mmrc") : join37(process.cwd(), ".mmrc");
+  const dir = configDir || join38(homedir12(), ".mma");
+  const projectConfigPath = projectDir ? join38(projectDir, ".mmrc") : join38(process.cwd(), ".mmrc");
   const config = loadConfig({ configDir: dir, projectConfigPath });
   setLocale(config.locale);
   try {
@@ -21440,7 +21827,7 @@ async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
     }
   } catch {}
   const logger = new Logger(config.logLevel);
-  logger.setLogDir(join37(dir, "logs"));
+  logger.setLogDir(join38(dir, "logs"));
   logger.debug("MMA bootstrap", {
     version: config.version,
     model: config.model
@@ -21462,7 +21849,7 @@ async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
       logger.info(`Model ${config.model} loaded in ${loadResult.loadTime}s`);
     }
   }
-  const profile = new UserProfile(join37(dir));
+  const profile = new UserProfile(join38(dir));
   profile.load() || profile.collect();
   profile.save();
   const llmProvider = new OpenAICompatProvider({
@@ -21474,7 +21861,17 @@ async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
     rateLimits: config.security?.rateLimits
   });
   const baseDir = projectDir ? resolve23(projectDir) : process.cwd();
-  const projectMapCacheDir = join37(baseDir, ".mma");
+  const envReport = collectEnvironment({
+    configDir: dir,
+    baseDir,
+    config,
+    scanTools: true
+  });
+  logEnvironment(envReport, logger);
+  for (const warning of envReport.warnings) {
+    logger.warn(warning);
+  }
+  const projectMapCacheDir = join38(baseDir, ".mma");
   const indexerModule = new IndexerModule({
     baseDir,
     cacheDir: projectMapCacheDir
@@ -21485,9 +21882,9 @@ async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
     logger.warn(`Project indexing failed: ${err.message}`);
   }
   const skillsLoader = new SkillsLoader;
-  const builtinDir = join37(import.meta.dirname, "skills", "builtin");
-  const globalDir = join37(homedir11(), ".agents", "skills");
-  const projectSkillsDir = join37(baseDir, ".mma", "skills");
+  const builtinDir = join38(import.meta.dirname, "skills", "builtin");
+  const globalDir = join38(homedir12(), ".agents", "skills");
+  const projectSkillsDir = join38(baseDir, ".mma", "skills");
   const availableSkills = skillsLoader.loadFromAllSources(builtinDir, globalDir, projectSkillsDir);
   const skillsBudget = Math.floor(config.contextWindow * config.skills.budget);
   const skillsModule = new SkillsModule(availableSkills, skillsBudget);
@@ -21503,11 +21900,11 @@ async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
     essential: true,
     estimatedTokens: Math.ceil(systemInfoContent.length / 4)
   };
-  const agentsMdGlobal = join37(dir, "AGENTS.md");
-  if (!existsSync44(agentsMdGlobal)) {
+  const agentsMdGlobal = join38(dir, "AGENTS.md");
+  if (!existsSync45(agentsMdGlobal)) {
     writeFileSync15(agentsMdGlobal, "", "utf-8");
   }
-  const sessionDir = join37(dir, "sessions");
+  const sessionDir = join38(dir, "sessions");
   const sessionStore = new SessionStore(sessionDir);
   sessionStore.init();
   const sessionManager = new SessionManager(sessionStore, {
@@ -21584,7 +21981,7 @@ async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
   const mcpModule = new MCPModule(config);
   await mcpModule.initialize();
   moduleRegistry.register(mcpModule);
-  const memoryStore = new MemoryStore(join37(dir, "memory"));
+  const memoryStore = new MemoryStore(join38(dir, "memory"));
   const memoryModule = new MemoryModule(memoryStore);
   moduleRegistry.register(memoryModule);
   if (config.browser.enabled) {
@@ -21596,7 +21993,7 @@ async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
       pluginManager.register(browserPlugin);
     }
   }
-  const lspModule = new LspModule(config.lsp);
+  const lspModule = new LspModule(config.lsp, undefined, logger);
   moduleRegistry.register(lspModule);
   const lspPlugin = lspModule.getPlugin();
   if (lspPlugin) {
@@ -21637,8 +22034,8 @@ async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
   pluginManager.register(plugin);
   pluginManager.register(plugin2);
   const pluginLoader = new PluginLoader;
-  const globalPluginsDir = join37(homedir11(), ".mma", "plugins");
-  const projectPluginsDir = join37(baseDir, ".mma", "plugins");
+  const globalPluginsDir = join38(homedir12(), ".mma", "plugins");
+  const projectPluginsDir = join38(baseDir, ".mma", "plugins");
   const mmaVersion = readMmaVersion();
   pluginLoader.loadFromDir(globalPluginsDir, pluginManager, logger, {
     source: "global",
@@ -21664,13 +22061,13 @@ async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
   const skipAgentsMd = noAgentsMd === true;
   if (!skipAgentsMd) {
     const agentsMdCandidates = [
-      join37(baseDir, "AGENTS.md"),
-      join37(baseDir, ".mma", "AGENTS.md"),
-      join37(dir, "AGENTS.md")
+      join38(baseDir, "AGENTS.md"),
+      join38(baseDir, ".mma", "AGENTS.md"),
+      join38(dir, "AGENTS.md")
     ];
     for (const p of agentsMdCandidates) {
-      if (existsSync44(p)) {
-        const content = readFileSync27(p, "utf-8").trim();
+      if (existsSync45(p)) {
+        const content = readFileSync28(p, "utf-8").trim();
         if (content) {
           agentsMdBlocks.push({
             content,
@@ -21773,6 +22170,7 @@ var init_bootstrap = __esm(() => {
   init_i18n();
   init_agent();
   init_version();
+  init_environment();
 });
 
 // node_modules/ansi-regex/index.js
@@ -22541,20 +22939,20 @@ __export(exports_manifest, {
   getCertMark: () => getCertMark,
   MANIFEST_PATH: () => MANIFEST_PATH
 });
-import { existsSync as existsSync45, readFileSync as readFileSync28, mkdirSync as mkdirSync18, writeFileSync as writeFileSync16 } from "fs";
-import { homedir as homedir13 } from "os";
-import { join as join39 } from "path";
+import { existsSync as existsSync46, readFileSync as readFileSync29, mkdirSync as mkdirSync18, writeFileSync as writeFileSync16 } from "fs";
+import { homedir as homedir14 } from "os";
+import { join as join40 } from "path";
 function readManifest(path = MANIFEST_PATH) {
   try {
-    if (existsSync45(path)) {
-      const raw = JSON.parse(readFileSync28(path, "utf-8"));
+    if (existsSync46(path)) {
+      const raw = JSON.parse(readFileSync29(path, "utf-8"));
       return { version: 1, certifications: raw.certifications ?? [] };
     }
   } catch {}
   return { version: 1, certifications: [] };
 }
 function saveManifest(m, path = MANIFEST_PATH) {
-  mkdirSync18(join39(homedir13(), ".mma"), { recursive: true });
+  mkdirSync18(join40(homedir14(), ".mma"), { recursive: true });
   writeFileSync16(path, JSON.stringify(m, null, 2), "utf-8");
 }
 function upsertCertification(entry, path = MANIFEST_PATH) {
@@ -22589,7 +22987,7 @@ function getCertMark(model, providerUrl, currentVersion, path = MANIFEST_PATH) {
 }
 var MANIFEST_PATH;
 var init_manifest = __esm(() => {
-  MANIFEST_PATH = join39(homedir13(), ".mma", "certifications.json");
+  MANIFEST_PATH = join40(homedir14(), ".mma", "certifications.json");
 });
 
 // node_modules/yaml/dist/nodes/identity.js
@@ -29712,8 +30110,8 @@ var init_scenarios = __esm(() => {
 });
 
 // src/modules/certification/loader.ts
-import { existsSync as existsSync46, readdirSync as readdirSync15, readFileSync as readFileSync29 } from "fs";
-import { join as join40 } from "path";
+import { existsSync as existsSync47, readdirSync as readdirSync16, readFileSync as readFileSync30 } from "fs";
+import { join as join41 } from "path";
 function validateScenario(s) {
   const errors2 = [];
   const isSkip = s.mode === "skip";
@@ -29762,12 +30160,12 @@ function loadScenarios(userDir) {
     else
       scenarios.push(s);
   }
-  if (userDir && existsSync46(userDir)) {
-    for (const file of readdirSync15(userDir)) {
+  if (userDir && existsSync47(userDir)) {
+    for (const file of readdirSync16(userDir)) {
       if (!file.endsWith(".yaml") && !file.endsWith(".yml"))
         continue;
       try {
-        const raw = readFileSync29(join40(userDir, file), "utf-8");
+        const raw = readFileSync30(join41(userDir, file), "utf-8");
         const data = $parse(raw);
         const parsed = normalizeScenario(data, file);
         const errs = validateScenario(parsed);
@@ -29820,8 +30218,8 @@ var init_loader3 = __esm(() => {
 });
 
 // src/modules/certification/fact-checker.ts
-import { existsSync as existsSync47, readFileSync as readFileSync30, statSync as statSync8 } from "fs";
-import { join as join41 } from "path";
+import { existsSync as existsSync48, readFileSync as readFileSync31, statSync as statSync8 } from "fs";
+import { join as join42 } from "path";
 function checkSandbox(sandboxDir, checks, exitCode, output) {
   const failures = [];
   for (const check of checks) {
@@ -29838,16 +30236,16 @@ function runCheck2(sandboxDir, check, exitCode, output) {
     case "outputContains":
       return output.includes(check.text);
     case "fileExists":
-      return isFile(join41(sandboxDir, check.path));
+      return isFile(join42(sandboxDir, check.path));
     case "fileNotExists":
-      return !existsSync47(join41(sandboxDir, check.path));
+      return !existsSync48(join42(sandboxDir, check.path));
     case "dirExists":
-      return isDir(join41(sandboxDir, check.path));
+      return isDir(join42(sandboxDir, check.path));
     case "fileContent": {
-      const abs = join41(sandboxDir, check.path);
+      const abs = join42(sandboxDir, check.path);
       if (!isFile(abs))
         return false;
-      const content = readFileSync30(abs, "utf-8");
+      const content = readFileSync31(abs, "utf-8");
       if (check.contains !== undefined)
         return content.includes(check.contains);
       if (check.equals !== undefined)
@@ -29855,10 +30253,10 @@ function runCheck2(sandboxDir, check, exitCode, output) {
       return false;
     }
     case "fileRegex": {
-      const abs = join41(sandboxDir, check.path);
+      const abs = join42(sandboxDir, check.path);
       if (!isFile(abs))
         return false;
-      return new RegExp(check.pattern).test(readFileSync30(abs, "utf-8"));
+      return new RegExp(check.pattern).test(readFileSync31(abs, "utf-8"));
     }
     default:
       return false;
@@ -29866,14 +30264,14 @@ function runCheck2(sandboxDir, check, exitCode, output) {
 }
 function isFile(p) {
   try {
-    return existsSync47(p) && statSync8(p).isFile();
+    return existsSync48(p) && statSync8(p).isFile();
   } catch {
     return false;
   }
 }
 function isDir(p) {
   try {
-    return existsSync47(p) && statSync8(p).isDirectory();
+    return existsSync48(p) && statSync8(p).isDirectory();
   } catch {
     return false;
   }
@@ -29904,9 +30302,9 @@ var init_fact_checker = () => {};
 
 // src/modules/certification/runner.ts
 import { spawn as spawn8 } from "child_process";
-import { existsSync as existsSync48, mkdirSync as mkdirSync19, rmSync as rmSync4, cpSync as cpSync2 } from "fs";
-import { platform as platform9 } from "os";
-import { join as join42, resolve as resolve24, dirname as dirname14 } from "path";
+import { existsSync as existsSync49, mkdirSync as mkdirSync19, rmSync as rmSync4, cpSync as cpSync2 } from "fs";
+import { platform as platform10 } from "os";
+import { join as join43, resolve as resolve24, dirname as dirname15 } from "path";
 async function runScenario(scenario, opts) {
   if (scenario.mode === "skip") {
     return {
@@ -29925,7 +30323,7 @@ async function runScenario(scenario, opts) {
   let passed = 0;
   let firstError;
   for (let i = 1;i <= reps; i++) {
-    const sandbox = join42(opts.sandboxBase, `run-${scenario.id}-${i}`);
+    const sandbox = join43(opts.sandboxBase, `run-${scenario.id}-${i}`);
     let failures = [];
     let exitCode = -1;
     let output = "";
@@ -29939,15 +30337,15 @@ async function runScenario(scenario, opts) {
         sandbox,
         scenario.prompt
       ];
-      const env2 = {
+      const env3 = {
         ...process.env,
         MMA_MODEL: opts.model,
         MMA_PROVIDER_BASEURL: opts.providerUrl,
         MMA_CONTEXT_WINDOW: String(opts.contextWindow ?? 32000)
       };
       if (opts.providerKey)
-        env2.MMA_PROVIDER_APIKEY = opts.providerKey;
-      const res = await runner(env2, opts.mmaRoot, args, timeoutMs);
+        env3.MMA_PROVIDER_APIKEY = opts.providerKey;
+      const res = await runner(env3, opts.mmaRoot, args, timeoutMs);
       output = `${res.stdout}
 ${res.stderr}`;
       exitCode = res.code ?? -1;
@@ -29986,25 +30384,25 @@ function prepareSandbox(sandbox, scenario, mmaRoot) {
   rmSync4(sandbox, { recursive: true, force: true });
   mkdirSync19(sandbox, { recursive: true });
   for (const f of scenario.fixtures ?? []) {
-    const src = join42(mmaRoot, f.source);
-    if (!existsSync48(src)) {
+    const src = join43(mmaRoot, f.source);
+    if (!existsSync49(src)) {
       throw new Error(`fixture missing: ${f.source}`);
     }
-    const dest = join42(sandbox, f.dest);
-    mkdirSync19(dirname14(dest), { recursive: true });
+    const dest = join43(sandbox, f.dest);
+    mkdirSync19(dirname15(dest), { recursive: true });
     cpSync2(src, dest);
   }
 }
 function resolveMmaEntry(mmaRoot) {
-  const dev = join42(mmaRoot, "src", "cli", "main.ts");
-  if (existsSync48(dev))
+  const dev = join43(mmaRoot, "src", "cli", "main.ts");
+  if (existsSync49(dev))
     return dev;
-  return join42(mmaRoot, "dist", "main.js");
+  return join43(mmaRoot, "dist", "main.js");
 }
 function findMmaRoot(fromDir) {
   const candidates = [resolve24(fromDir, "..", "..", ".."), resolve24(fromDir, "..")];
   for (const c of candidates) {
-    if (existsSync48(join42(c, "package.json")))
+    if (existsSync49(join43(c, "package.json")))
       return c;
   }
   return process.cwd();
@@ -30013,7 +30411,7 @@ function killTree2(child) {
   const pid = child.pid;
   if (!pid)
     return;
-  if (platform9() === "win32") {
+  if (platform10() === "win32") {
     spawn8("taskkill", ["/pid", String(pid), "/T", "/F"], {
       windowsHide: true,
       stdio: "ignore"
@@ -30028,10 +30426,10 @@ function killTree2(child) {
     } catch {}
   }
 }
-var defaultRunner2 = (env2, cwd, args, timeoutMs) => new Promise((resolvePromise) => {
+var defaultRunner2 = (env3, cwd, args, timeoutMs) => new Promise((resolvePromise) => {
   const child = spawn8(process.execPath, args, {
     cwd,
-    env: env2,
+    env: env3,
     windowsHide: true,
     stdio: ["ignore", "pipe", "pipe"]
   });
@@ -30071,16 +30469,16 @@ __export(exports_cli, {
   certList: () => certList
 });
 import { rmSync as rmSync5 } from "fs";
-import { homedir as homedir14 } from "os";
-import { join as join43, dirname as dirname15 } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
-import { existsSync as existsSync49, readFileSync as readFileSync31 } from "fs";
+import { homedir as homedir15 } from "os";
+import { join as join44, dirname as dirname16 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
+import { existsSync as existsSync50, readFileSync as readFileSync32 } from "fs";
 function readVersion() {
-  const candidates = [join43(MMA_ROOT, "package.json")];
+  const candidates = [join44(MMA_ROOT, "package.json")];
   for (const p of candidates) {
-    if (existsSync49(p)) {
+    if (existsSync50(p)) {
       try {
-        const raw = JSON.parse(readFileSync31(p, "utf-8"));
+        const raw = JSON.parse(readFileSync32(p, "utf-8"));
         if (raw.version)
           return raw.version;
       } catch {}
@@ -30116,7 +30514,7 @@ async function certify(opts) {
     return;
   }
   console.log(t("cli.cert_started", { model: opts.name, provider: providerUrl }));
-  const sandboxBase = join43(process.cwd(), ".mma", "certification");
+  const sandboxBase = join44(process.cwd(), ".mma", "certification");
   const results = [];
   const total = selected.length;
   let idx = 0;
@@ -30228,9 +30626,9 @@ var init_cli = __esm(() => {
   init_loader3();
   init_runner2();
   init_manifest();
-  HERE = dirname15(fileURLToPath3(import.meta.url));
+  HERE = dirname16(fileURLToPath4(import.meta.url));
   MMA_ROOT = findMmaRoot(HERE);
-  USER_SCENARIO_DIR = join43(homedir14(), ".mma", "certification", "scenarios");
+  USER_SCENARIO_DIR = join44(homedir15(), ".mma", "certification", "scenarios");
 });
 
 // src/cli/repl-commands.ts
@@ -30239,17 +30637,17 @@ __export(exports_repl_commands, {
   registerAllCommands: () => registerAllCommands,
   COMMAND_GROUPS: () => COMMAND_GROUPS
 });
-import { join as join45, dirname as dirname17 } from "path";
-import { homedir as homedir16 } from "os";
-import { existsSync as existsSync51, readFileSync as readFileSync33 } from "fs";
-import { fileURLToPath as fileURLToPath5 } from "url";
+import { join as join46, dirname as dirname18 } from "path";
+import { homedir as homedir17 } from "os";
+import { existsSync as existsSync52, readFileSync as readFileSync34 } from "fs";
+import { fileURLToPath as fileURLToPath6 } from "url";
 function readVersion3() {
-  const here = dirname17(fileURLToPath5(import.meta.url));
-  const candidates = [join45(here, "..", "..", "package.json"), join45(here, "..", "package.json")];
+  const here = dirname18(fileURLToPath6(import.meta.url));
+  const candidates = [join46(here, "..", "..", "package.json"), join46(here, "..", "package.json")];
   for (const p of candidates) {
-    if (existsSync51(p)) {
+    if (existsSync52(p)) {
       try {
-        const raw = JSON.parse(readFileSync33(p, "utf8"));
+        const raw = JSON.parse(readFileSync34(p, "utf8"));
         if (raw.version)
           return raw.version;
       } catch {}
@@ -30313,7 +30711,7 @@ function registerMmaCommands(ctx) {
       }
       try {
         const { loadFileAsDataUrl: loadFileAsDataUrl2, loadUrlAsDataUrl: loadUrlAsDataUrl2, readClipboardImage: readClipboardImage2 } = await Promise.resolve().then(() => (init_image_utils(), exports_image_utils));
-        const { existsSync: existsSync52 } = await import("fs");
+        const { existsSync: existsSync53 } = await import("fs");
         const { resolve: resolve25 } = await import("path");
         let dataUrl;
         let label;
@@ -30333,7 +30731,7 @@ function registerMmaCommands(ctx) {
           label = source;
         } else {
           const absPath = resolve25(process.cwd(), source);
-          if (!existsSync52(absPath)) {
+          if (!existsSync53(absPath)) {
             console.log(pc2.red(t("image.not_found", { path: source })));
             return;
           }
@@ -30412,7 +30810,7 @@ function registerMmaCommands(ctx) {
       console.log(pc2.yellow(t("repl.wizard_running")));
       await ctx.withExclusiveInput(async () => {
         const answers = await runSetup(ctx.rl);
-        const configPath = join45(homedir16(), ".mma", "config.json");
+        const configPath = join46(homedir17(), ".mma", "config.json");
         ctx.config.provider.type = answers.provider;
         ctx.config.provider.baseUrl = answers.apiBase;
         ctx.config.provider.apiKey = answers.apiKey;
@@ -30466,7 +30864,7 @@ Excluded blocks: ${info.excluded.length}`));
           return;
         }
         ctx.config.provider.type = name;
-        const configPath = join45(homedir16(), ".mma", "config.json");
+        const configPath = join46(homedir17(), ".mma", "config.json");
         saveConfig(ctx.config, configPath);
         await ctx.agent.reconfigure(ctx.config);
         console.log(pc2.green(t("repl.provider_set", { name })));
@@ -30522,7 +30920,7 @@ Excluded blocks: ${info.excluded.length}`));
           return;
         }
         ctx.config.model = name;
-        const configPath = join45(homedir16(), ".mma", "config.json");
+        const configPath = join46(homedir17(), ".mma", "config.json");
         saveConfig(ctx.config, configPath);
         await ctx.agent.reconfigure(ctx.config);
         console.log(pc2.green(t("repl.model_set", { name })));
@@ -30547,7 +30945,7 @@ Excluded blocks: ${info.excluded.length}`));
         return;
       }
       ctx.config.contextWindow = size;
-      const configPath = join45(homedir16(), ".mma", "config.json");
+      const configPath = join46(homedir17(), ".mma", "config.json");
       saveConfig(ctx.config, configPath);
       await ctx.agent.reconfigure(ctx.config);
       console.log(pc2.green(t("cli.context_set", { size })));
@@ -30565,11 +30963,11 @@ Excluded blocks: ${info.excluded.length}`));
       }
       ctx.agent.shutdown();
       const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_config2(), exports_config));
-      const { homedir: homedir17 } = await import("os");
-      const { join: join46 } = await import("path");
+      const { homedir: homedir18 } = await import("os");
+      const { join: join47 } = await import("path");
       const configDir = ctx.configDir;
       const baseDir = ctx.baseDir;
-      const projectConfigPath = join46(baseDir, ".mmrc");
+      const projectConfigPath = join47(baseDir, ".mmrc");
       const freshConfig = loadConfig2({ configDir, projectConfigPath });
       Object.assign(ctx.config, freshConfig);
       const { bootstrap: bootstrap2 } = await Promise.resolve().then(() => (init_bootstrap(), exports_bootstrap));
@@ -30620,6 +31018,70 @@ Excluded blocks: ${info.excluded.length}`));
       }
     }
   });
+  ctx.registerCommand({
+    name: "lsp",
+    description: t("repl.lsp"),
+    usage: t("repl.lsp_usage"),
+    action: async (args) => {
+      const subcommand = args[0] || "status";
+      const lspModule = ctx.agent.deps?.moduleRegistry?.getModules?.()?.find((m) => m.name === "lsp");
+      if (!lspModule) {
+        console.log(pc2.yellow(t("repl.lsp_not_available")));
+        return;
+      }
+      switch (subcommand) {
+        case "status": {
+          const disabled = lspModule.getDisabledServers();
+          const failures = lspModule.getFailureCounts();
+          const config = ctx.config.lsp;
+          console.log(pc2.bold(t("repl.lsp_status_header")));
+          console.log(`${t("repl.lsp_enabled")} ${config?.enabled ? pc2.green("yes") : pc2.red("no")}`);
+          if (disabled.length > 0) {
+            console.log(pc2.yellow(`${t("repl.lsp_disabled_servers")} ${disabled.join(", ")}`));
+          }
+          if (failures.size > 0) {
+            console.log(pc2.dim(t("repl.lsp_failure_counts")));
+            for (const [server, count] of failures) {
+              console.log(pc2.dim(`  ${server}: ${count}`));
+            }
+          }
+          if (disabled.length === 0 && failures.size === 0) {
+            console.log(pc2.green(t("repl.lsp_all_ok")));
+          }
+          break;
+        }
+        case "restart": {
+          console.log(pc2.yellow(t("repl.lsp_restarting")));
+          lspModule.resetDisabledServers();
+          console.log(pc2.green(t("repl.lsp_restarted")));
+          break;
+        }
+        case "check": {
+          const path = args[1];
+          if (!path) {
+            console.log(pc2.yellow(t("repl.lsp_check_usage")));
+            return;
+          }
+          console.log(pc2.dim(t("repl.lsp_checking", { path })));
+          try {
+            const result = await ctx.agent.deps?.toolExecutor?.execute("lsp_check", { path }, ctx.agent.deps?.toolCtx);
+            if (result?.output) {
+              console.log(result.output);
+            }
+          } catch (e) {
+            console.log(pc2.red(t("repl.lsp_check_error", {
+              error: e instanceof Error ? e.message : String(e)
+            })));
+          }
+          break;
+        }
+        default: {
+          console.log(pc2.dim(t("repl.lsp_usage")));
+          break;
+        }
+      }
+    }
+  });
 }
 function registerSessionCommands(ctx) {
   if (!ctx.sessionManager)
@@ -30874,6 +31336,7 @@ var init_repl_commands = __esm(() => {
     reload: "agent",
     wizard: "agent",
     sysprompt: "agent",
+    lsp: "agent",
     sessions: "session",
     new: "session",
     resume: "session",
@@ -30905,15 +31368,15 @@ init_bootstrap();
 init_config2();
 init_setup();
 init_i18n();
-import { join as join44, dirname as dirname16 } from "path";
-import { homedir as homedir15 } from "os";
-import { existsSync as existsSync50, readFileSync as readFileSync32 } from "fs";
+import { join as join45, dirname as dirname17 } from "path";
+import { homedir as homedir16 } from "os";
+import { existsSync as existsSync51, readFileSync as readFileSync33 } from "fs";
 
 // src/cli/security-commands.ts
 init_bootstrap();
 init_config2();
-import { join as join38 } from "path";
-import { homedir as homedir12 } from "os";
+import { join as join39 } from "path";
+import { homedir as homedir13 } from "os";
 
 // src/modules/security/security-policies.ts
 init_security();
@@ -31426,7 +31889,7 @@ function createSecurityCommand(program2) {
     }
   });
   securityCmd.command("set-policy").argument("<preset>", t("cli.security.preset")).description(t("cli.security.set_policy")).action(async (preset) => {
-    const configPath = join38(homedir12(), ".mma", "config.json");
+    const configPath = join39(homedir13(), ".mma", "config.json");
     const { config: appConfig } = await bootstrap();
     const validPresets = ["strict", "balanced", "permissive"];
     if (!validPresets.includes(preset)) {
@@ -31441,7 +31904,7 @@ function createSecurityCommand(program2) {
     console.log(t("cli.security.policy_description", { description: policy.description }));
   });
   securityCmd.command("enable-encryption").description(t("cli.security.enable_encryption")).action(async () => {
-    const configPath = join38(homedir12(), ".mma", "config.json");
+    const configPath = join39(homedir13(), ".mma", "config.json");
     const { config: appConfig } = await bootstrap();
     appConfig.security = appConfig.security || {};
     appConfig.security.sessionEncryption = {
@@ -31453,7 +31916,7 @@ function createSecurityCommand(program2) {
     console.log(t("cli.security.encryption_enabled"));
   });
   securityCmd.command("disable-encryption").description(t("cli.security.disable_encryption")).action(async () => {
-    const configPath = join38(homedir12(), ".mma", "config.json");
+    const configPath = join39(homedir13(), ".mma", "config.json");
     const { config: appConfig } = await bootstrap();
     appConfig.security = appConfig.security || {};
     appConfig.security.sessionEncryption = {
@@ -31465,7 +31928,7 @@ function createSecurityCommand(program2) {
     console.log(t("cli.security.encryption_disabled"));
   });
   securityCmd.command("enable-audit").description(t("cli.security.enable_audit")).action(async () => {
-    const configPath = join38(homedir12(), ".mma", "config.json");
+    const configPath = join39(homedir13(), ".mma", "config.json");
     const { config: appConfig } = await bootstrap();
     appConfig.security = appConfig.security || {};
     appConfig.security.auditNotifier = {
@@ -31479,7 +31942,7 @@ function createSecurityCommand(program2) {
     console.log(t("cli.security.audit_enabled"));
   });
   securityCmd.command("disable-audit").description(t("cli.security.disable_audit")).action(async () => {
-    const configPath = join38(homedir12(), ".mma", "config.json");
+    const configPath = join39(homedir13(), ".mma", "config.json");
     const { config: appConfig } = await bootstrap();
     appConfig.security = appConfig.security || {};
     appConfig.security.auditNotifier = {
@@ -31543,14 +32006,14 @@ function createPluginCommand(program2) {
 
 // src/cli/commands.ts
 init_setup();
-import { fileURLToPath as fileURLToPath4 } from "url";
+import { fileURLToPath as fileURLToPath5 } from "url";
 function readVersion2() {
-  const here = dirname16(fileURLToPath4(import.meta.url));
-  const candidates = [join44(here, "..", "..", "package.json"), join44(here, "..", "package.json")];
+  const here = dirname17(fileURLToPath5(import.meta.url));
+  const candidates = [join45(here, "..", "..", "package.json"), join45(here, "..", "package.json")];
   for (const p of candidates) {
-    if (existsSync50(p)) {
+    if (existsSync51(p)) {
       try {
-        const raw = JSON.parse(readFileSync32(p, "utf8"));
+        const raw = JSON.parse(readFileSync33(p, "utf8"));
         if (raw.version)
           return raw.version;
       } catch {}
@@ -31563,7 +32026,7 @@ function createProgram() {
   const program2 = new Command().name("mma").description(t("cli.description")).version(version).option("--no-agents-md", t("cli.no_agents_md")).option("-d, --dir <path>", t("cli.dir")).option("-e, --exit-on-complete", t("cli.exit_on_complete")).option("-j, --json", t("cli.json"));
   program2.command("init").description(t("cli.init")).action(async () => {
     const answers = await runSetup();
-    const configPath = join44(homedir15(), ".mma", "config.json");
+    const configPath = join45(homedir16(), ".mma", "config.json");
     const { config } = await bootstrap();
     config.provider.type = answers.provider;
     config.provider.baseUrl = answers.apiBase;
@@ -31608,7 +32071,7 @@ function createProgram() {
   });
   const configCmd = program2.command("config").description(t("cli.manage_config"));
   configCmd.command("set").argument("<key>", t("cli.config_key")).argument("<value>", "Config value").description(t("cli.set_value")).action(async (key, value) => {
-    const configPath = join44(homedir15(), ".mma", "config.json");
+    const configPath = join45(homedir16(), ".mma", "config.json");
     const { config } = await bootstrap();
     const keys = key.split(".");
     let obj = config;
@@ -31671,7 +32134,7 @@ function createProgram() {
     console.log(t("cli.model_hint"));
   });
   model.command("use").argument("<name>", "Model name").description(t("cli.set_model")).action(async (name) => {
-    const configPath = join44(homedir15(), ".mma", "config.json");
+    const configPath = join45(homedir16(), ".mma", "config.json");
     const { config } = await bootstrap();
     config.model = name;
     saveConfig(config, configPath);
@@ -31707,7 +32170,7 @@ function createProgram() {
     await uncertify2(name, config);
   });
   program2.command("context").description(t("cli.manage_context")).argument("<size>", "Context window size in tokens").action(async (size) => {
-    const configPath = join44(homedir15(), ".mma", "config.json");
+    const configPath = join45(homedir16(), ".mma", "config.json");
     const { config } = await bootstrap();
     const contextWindow = parseInt(size, 10);
     if (isNaN(contextWindow) || contextWindow < 1024) {
@@ -31725,7 +32188,7 @@ function createProgram() {
     console.log(t("cli.base_url"), config.provider.baseUrl);
   });
   provider.command("use").argument("<name>", "Provider name").description(t("cli.set_provider")).action(async (name) => {
-    const configPath = join44(homedir15(), ".mma", "config.json");
+    const configPath = join45(homedir16(), ".mma", "config.json");
     const { config } = await bootstrap();
     config.provider.type = name;
     const baseUrl = HOSTED_BASE_URLS[name];
@@ -32540,9 +33003,9 @@ class LineEditor {
 }
 
 // src/cli/repl.ts
-import { existsSync as existsSync53, readFileSync as readFileSync35, writeFileSync as writeFileSync17 } from "fs";
-import { join as join47 } from "path";
-import { homedir as homedir17 } from "os";
+import { existsSync as existsSync54, readFileSync as readFileSync36, writeFileSync as writeFileSync17 } from "fs";
+import { join as join48 } from "path";
+import { homedir as homedir18 } from "os";
 
 // src/cli/completer.ts
 class SlashCommandProvider {
@@ -33113,16 +33576,24 @@ async function probeLspServers(config, baseDir, deps = {}) {
       await probeClient.probe(server, projectRoot, serverTimeout);
       ok.push({ language, ok: true, durationMs: Date.now() - started });
     } catch (e) {
+      const errorMsg = e instanceof Error ? e.message : String(e);
+      deps.logger?.warn(`LSP probe failed for ${language}: ${errorMsg}`, {
+        command: server.command,
+        timeout: serverTimeout,
+        durationMs: Date.now() - started
+      });
       failed.push({
         language,
         ok: false,
-        error: e instanceof Error ? e.message : String(e),
+        error: errorMsg,
         durationMs: Date.now() - started
       });
     }
   };
   for (let i = 0;i < servers.length; i += maxParallel) {
     if (Date.now() >= deadline) {
+      const remaining = servers.slice(i).map((s) => s.language);
+      deps.logger?.warn(`LSP probe deadline reached, skipping: ${remaining.join(", ")}`);
       for (const { language } of servers.slice(i)) {
         failed.push({ language, ok: false, error: "timeout", durationMs: 0 });
       }
@@ -33141,14 +33612,14 @@ init_config();
 init_colors();
 init_js_identifiers();
 init_i18n();
-import { existsSync as existsSync52, readFileSync as readFileSync34 } from "fs";
-import { join as join46 } from "path";
+import { existsSync as existsSync53, readFileSync as readFileSync35 } from "fs";
+import { join as join47 } from "path";
 function readActivePlan(baseDir) {
-  const p = join46(baseDir, ".mma", "plans", "active.json");
-  if (!existsSync52(p))
+  const p = join47(baseDir, ".mma", "plans", "active.json");
+  if (!existsSync53(p))
     return null;
   try {
-    const raw = readFileSync34(p, "utf-8");
+    const raw = readFileSync35(p, "utf-8");
     if (!raw.trim())
       return null;
     const parsed = JSON.parse(raw);
@@ -33291,10 +33762,10 @@ class Repl {
     this.skillsModule = skillsModule;
     this.pluginManager = pluginManager;
     this.logger = logger;
-    this.configDir = configDir || join47(homedir17(), ".mma");
+    this.configDir = configDir || join48(homedir18(), ".mma");
     this.baseDir = baseDir || process.cwd();
     this.noAgentsMd = noAgentsMd === true;
-    this.historyPath = join47(homedir17(), ".mma", "repl-history");
+    this.historyPath = join48(homedir18(), ".mma", "repl-history");
     this.loadHistory();
     this.rl = process.stdin.isTTY ? new LineEditor({
       input: process.stdin,
@@ -33327,9 +33798,9 @@ class Repl {
     this.setupListeners();
   }
   loadHistory() {
-    if (existsSync53(this.historyPath)) {
+    if (existsSync54(this.historyPath)) {
       try {
-        const raw = readFileSync35(this.historyPath, "utf-8");
+        const raw = readFileSync36(this.historyPath, "utf-8");
         this.history = raw.split(`
 `).filter(Boolean).slice(-this.maxHistory);
       } catch {
@@ -33421,6 +33892,7 @@ class Repl {
       this.running = false;
       this.saveHistory();
       this.agent.shutdown();
+      this.logger?.closeSessionLog();
       if (this.exitOnClose)
         process.exit(0);
     });
@@ -33429,6 +33901,7 @@ class Repl {
         this.running = false;
         this.saveHistory();
         this.agent.shutdown();
+        this.logger?.closeSessionLog();
         process.exit(0);
       });
     }
@@ -33705,11 +34178,11 @@ ${t("image.clipboard_empty")}`));
       row(t("repl.agents_label"), pc2.red(t("repl.disabled")));
     } else {
       const agentsMdCandidates = [
-        join47(this.baseDir, "AGENTS.md"),
-        join47(this.baseDir, ".mma", "AGENTS.md"),
-        join47(this.configDir, "AGENTS.md")
+        join48(this.baseDir, "AGENTS.md"),
+        join48(this.baseDir, ".mma", "AGENTS.md"),
+        join48(this.configDir, "AGENTS.md")
       ];
-      const foundAgents = agentsMdCandidates.filter((p) => existsSync53(p));
+      const foundAgents = agentsMdCandidates.filter((p) => existsSync54(p));
       if (foundAgents.length > 0) {
         for (const p of foundAgents) {
           row(t("repl.agents_label"), pc2.dim(p));
@@ -33720,7 +34193,7 @@ ${t("image.clipboard_empty")}`));
     }
     const meta = this.sessionManager?.getActiveMeta();
     if (meta) {
-      const sessionPath = join47(this.configDir, "sessions", meta.id);
+      const sessionPath = join48(this.configDir, "sessions", meta.id);
       row(t("repl.session_label"), `${pc2.cyan(meta.name)} ${pc2.dim(`(${meta.id.slice(0, 12)})`)}  —  ${meta.messageCount} msgs  ${pc2.dim(sessionPath)}`);
     }
     const headerWidth = Math.max(50, Math.min(96, process.stdout.columns || 96));
@@ -33775,6 +34248,7 @@ ${t("image.clipboard_empty")}`));
     this.running = false;
     this.saveHistory();
     this.agent.shutdown();
+    this.logger?.closeSessionLog();
     this.rl.close();
   }
 }
@@ -33805,10 +34279,10 @@ init_setup();
 init_config2();
 init_i18n();
 init_colors();
-import { existsSync as existsSync54, readFileSync as readFileSync36 } from "fs";
-import { join as join48, dirname as dirname18 } from "path";
-import { homedir as homedir18 } from "os";
-import { fileURLToPath as fileURLToPath6 } from "url";
+import { existsSync as existsSync55, readFileSync as readFileSync37 } from "fs";
+import { join as join50, dirname as dirname19 } from "path";
+import { homedir as homedir20 } from "os";
+import { fileURLToPath as fileURLToPath7 } from "url";
 
 // src/modules/updater/index.ts
 init_checker();
@@ -33907,14 +34381,61 @@ class UpdaterModule {
     await this.runOnce();
   }
 }
+// src/core/crash-handler.ts
+init_environment();
+init_data_sanitizer();
+init_i18n();
+import { appendFileSync as appendFileSync7, mkdirSync as mkdirSync20 } from "fs";
+import { join as join49 } from "path";
+import { homedir as homedir19 } from "os";
+var CRASH_LOG_DIR = join49(homedir19(), ".mma", "logs");
+var CRASH_LOG_FILE = "crash.jsonl";
+function formatCrashEntry(type2, err) {
+  const message = err instanceof Error ? err.message : String(err);
+  const stack = err instanceof Error && err.stack ? err.stack : message;
+  return {
+    ts: new Date().toISOString(),
+    type: type2,
+    message: sanitizeLogMessage(message),
+    stack: sanitizeLogMessage(stack),
+    environment: collectEnvironment({ configDir: homedir19(), scanTools: false })
+  };
+}
+function writeCrashEntry(dir, entry) {
+  try {
+    mkdirSync20(dir, { recursive: true });
+    appendFileSync7(join49(dir, CRASH_LOG_FILE), JSON.stringify(entry) + `
+`, "utf-8");
+  } catch {}
+}
+var installed = false;
+function installCrashHandlers() {
+  if (installed)
+    return;
+  installed = true;
+  process.on("uncaughtException", (err) => {
+    const entry = formatCrashEntry("uncaughtException", err);
+    writeCrashEntry(CRASH_LOG_DIR, entry);
+    process.stderr.write(`${t("env.crash_stderr", { type: entry.type, message: entry.message })}
+`);
+    process.exit(1);
+  });
+  process.on("unhandledRejection", (reason) => {
+    const entry = formatCrashEntry("unhandledRejection", reason);
+    writeCrashEntry(CRASH_LOG_DIR, entry);
+    process.stderr.write(`${t("env.crash_stderr", { type: entry.type, message: entry.message })}
+`);
+  });
+}
+
 // src/cli/main.ts
 function readVersion4() {
-  const here = dirname18(fileURLToPath6(import.meta.url));
-  const candidates = [join48(here, "..", "..", "package.json"), join48(here, "..", "package.json")];
+  const here = dirname19(fileURLToPath7(import.meta.url));
+  const candidates = [join50(here, "..", "..", "package.json"), join50(here, "..", "package.json")];
   for (const p of candidates) {
-    if (existsSync54(p)) {
+    if (existsSync55(p)) {
       try {
-        const raw = JSON.parse(readFileSync36(p, "utf8"));
+        const raw = JSON.parse(readFileSync37(p, "utf8"));
         if (raw.version)
           return raw.version;
       } catch {}
@@ -33939,6 +34460,7 @@ function startAutoUpdate(config) {
   }
 }
 async function main() {
+  installCrashHandlers();
   const program2 = createProgram();
   program2.parse(process.argv);
   const cmdNames = new Set(program2.commands.map((c) => c.name()));
@@ -33998,15 +34520,15 @@ async function main() {
     await updater?.waitForIdle();
     process.exit(exitCode);
   } else {
-    const configPath = join48(homedir18(), ".mma", "config.json");
-    if (!existsSync54(configPath)) {
+    const configPath = join50(homedir20(), ".mma", "config.json");
+    if (!existsSync55(configPath)) {
       console.log(pc2.yellow(`
   ` + t("cli.first_run") + `
 `));
       const answers = await runSetup();
       const config2 = loadConfig({
-        configDir: join48(homedir18(), ".mma"),
-        projectConfigPath: projectDir ? join48(projectDir, ".mmrc") : join48(process.cwd(), ".mmrc")
+        configDir: join50(homedir20(), ".mma"),
+        projectConfigPath: projectDir ? join50(projectDir, ".mmrc") : join50(process.cwd(), ".mmrc")
       });
       config2.provider.type = answers.provider;
       config2.provider.baseUrl = answers.apiBase;