micro-models-agent 0.50.1 → 0.51.1

package/dist/main.js

@@ -2276,7 +2276,7 @@ var init_defaults = __esm(() => {
       baseDelay: 1000,
       maxDelay: 30000,
       maxStreamRetries: 2,
-      noDataTimeoutMs: 60000
+      noDataTimeoutMs: 180000
     },
     maxToolIterations: 1000,
     stuckThreshold: 6,
@@ -2388,6 +2388,7 @@ The path was joined onto the working directory because it does not exist as give
     "file.truncated": `
 ... (truncated)`,
     "file.read_header": "── {path} ({ext}, {total} lines, lines {from}-{to})",
+    "file.read_range": "lines {from}-{to} of {total}",
     "file.read_truncated": `
 
 [Truncated: {remaining} more lines. Use read_file with offset={next} to continue]`,
@@ -2411,7 +2412,10 @@ The path was joined onto the working directory because it does not exist as give
     "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_stream_idle": 'LLM stream stalled — no data for {timeout}ms. If the provider buffers streaming (e.g. LM Studio) or generates very long tool calls, raise "retry.noDataTimeoutMs" in ~/.mma/config.json (restart required)',
+    "error.llm_stream_idle_toolcall": 'LLM stream stalled after a tool_call started — no data for {timeout}ms. The provider most likely buffers SSE instead of streaming tool-call argument deltas (seen with LM Studio). Raise "retry.noDataTimeoutMs" in ~/.mma/config.json (restart required)',
+    "error.llm_truncated": 'Response hit the completion token limit ({tokens}) and was cut off before any content arrived. Split the task into smaller outputs or raise "maxCompletionTokens" in the config',
+    "error.llm_truncated_toolcall": 'Response hit the completion token limit ({tokens}) in the middle of a tool_call — its arguments were cut off. Write the file in smaller chunks (several write_file/edit_file calls) or raise "maxCompletionTokens" in the config',
     "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}.",
@@ -2910,6 +2914,7 @@ Use this knowledge to answer the user's question.`,
     "exec.tool_errors_recovery": "Tool {tool} has failed {count} times in a row. Try an alternative: create files directly via write_file, use a different command, or if nothing works — skip this step via plan update step=N status=skipped with a note explaining why.",
     "exec.repetitive_tool": "Called {tool} {count} times with identical arguments and result. Try a different approach — create files directly, change arguments, or check process status via process_log.",
     "exec.consecutive_failures_recovery": "{count} consecutive tool failures. Create files directly via write_file instead of terminal commands. Check that dependencies are installed (npm install). Do not run build/tests until all files are created.",
+    "exec.bash_flailing_recovery": "bash failed in {fails} of the last {window} attempts. Stop using shell commands for file operations on this machine — they do not work. Use the dedicated tools instead: read_file (the header shows line counts), write_file, edit_file, file_info (file size), glob/grep for search",
     "exec.read_only_loop": "No write/exec for {count} tool calls — the agent is only reading/exploring.",
     "exec.read_only_loop_recovery": "{count} consecutive read-only tool calls (read_file/glob/grep/browser) with no writes. STOP exploring and make the edit the task requires: read the file, then call write_file or edit_file. If you cannot finish the task, ask the user instead of re-reading the same files.",
     "exec.plan_warning": 'Current plan step {step} is "{description}", but {tool} is being called for files outside this step. Complete the current step first, then call plan update step={step} status=done before moving to the next step.',
@@ -3103,6 +3108,7 @@ var init_ru = __esm(() => {
     "file.truncated": `
 ... (обрезано)`,
     "file.read_header": "── {path} ({ext}, {total} строк, строки {from}-{to})",
+    "file.read_range": "строки {from}-{to} из {total}",
     "file.read_truncated": `
 
 [Обрезано: ещё {remaining} строк. Продолжите чтение через read_file с offset={next}]`,
@@ -3126,7 +3132,10 @@ 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_stream_idle": 'Поток LLM завис — нет данных {timeout}мс. Если провайдер буферизирует стрим (например, LM Studio) или генерирует очень длинные tool calls, увеличьте "retry.noDataTimeoutMs" в ~/.mma/config.json (нужен рестарт)',
+    "error.llm_stream_idle_toolcall": 'Поток LLM завис после начала tool_call — нет данных {timeout}мс. Скорее всего провайдер буферизирует SSE вместо потоковой передачи аргументов tool_call (наблюдается в LM Studio). Увеличьте "retry.noDataTimeoutMs" в ~/.mma/config.json (нужен рестарт)',
+    "error.llm_truncated": 'Ответ упёрся в лимит токенов генерации ({tokens}) и был обрезан до какого-либо содержимого. Разбейте задачу на меньшие порции вывода или увеличьте "maxCompletionTokens" в конфиге',
+    "error.llm_truncated_toolcall": 'Ответ упёрся в лимит токенов генерации ({tokens}) посреди tool_call — его аргументы обрезаны. Пишите файл частями (несколько вызовов write_file/edit_file) или увеличьте "maxCompletionTokens" в конфиге',
     "error.llm_timeout": "Время запроса LLM истекло ({timeout}мс)",
     "env.runtime_node": "Запущено под Node (v{version}) — вставка изображений из буфера и LSP на Windows работают урезанно. Установите Bun (https://bun.sh) для полного функционала.",
     "env.runtime_old": "Версия рантайма {version} ниже требуемой engines {engine}.",
@@ -3624,6 +3633,7 @@ var init_ru = __esm(() => {
     "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.bash_flailing_recovery": "bash упал в {fails} из последних {window} попыток. Хватит использовать шелл-команды для файловых операций на этой машине — они не работают. Используй специализированные инструменты: read_file (в заголовке число строк), write_file, edit_file, file_info (размер файла), glob/grep для поиска",
     "exec.read_only_loop": "Нет записи/выполнения за {count} вызовов — агент только читает/исследует.",
     "exec.read_only_loop_recovery": "{count} вызовов только для чтения подряд (read_file/glob/grep/browser) без записи. Хватит исследовать — внесите правку, которую требует задача: прочитайте файл, затем вызовите write_file или edit_file. Если не можете завершить задачу — спросите пользователя, а не перечитывайте одни и те же файлы.",
     "exec.plan_warning": 'Текущий шаг плана {step} — "{description}", но вызывается {tool} для файлов вне этого шага. Завершите текущий шаг, вызовите plan update step={step} status=done, затем переходите к следующему.',
@@ -5344,7 +5354,7 @@ class OpenAICompatProvider {
       baseDelay: 1000,
       maxDelay: 30000,
       maxStreamRetries: 2,
-      noDataTimeoutMs: 60000
+      noDataTimeoutMs: 180000
     };
     this.rateLimiter = createRateLimiter(config.rateLimits);
   }
@@ -5373,7 +5383,7 @@ class OpenAICompatProvider {
   async* doStream(messages, tools, signal, options) {
     const { baseDelay, maxDelay, maxStreamRetries, noDataTimeoutMs } = this.retryConfig;
     const streamRetries = maxStreamRetries ?? 2;
-    const idleTimeoutMs = noDataTimeoutMs ?? 60000;
+    const idleTimeoutMs = noDataTimeoutMs ?? 180000;
     for (let attempt = 0;; attempt++) {
       let emitted = false;
       const onEmit = () => {
@@ -5397,12 +5407,13 @@ class OpenAICompatProvider {
     }
   }
   async* streamOnce(messages, tools, signal, options, onEmit, idleTimeoutMs) {
+    const maxTokens = options?.maxTokens ?? this.config.maxCompletionTokens ?? 4096;
     const body = buildRequestBody({
       model: this.model,
       messages,
       tools,
       stream: true,
-      maxTokens: options?.maxTokens ?? this.config.maxCompletionTokens ?? 4096,
+      maxTokens,
       reasoningEffort: options?.reasoningEffort
     });
     const { headers, abortSignal, cleanup, isTimeout, flagTimeout, controller } = this.buildRequestSetup(signal);
@@ -5440,8 +5451,11 @@ class OpenAICompatProvider {
     const decoder = new TextDecoder;
     let buffer = "";
     const toolCallAccs = new Map;
+    let sawToolCallStart = false;
     let usage;
     let sawDone = false;
+    let lastFinishReason;
+    let sawText = false;
     const readIdle = () => new Promise((resolve, reject) => {
       const idleTimer = setTimeout(() => {
         flagTimeout();
@@ -5450,13 +5464,13 @@ class OpenAICompatProvider {
       reader.read().then((result) => {
         clearTimeout(idleTimer);
         if (isTimeout())
-          reject(new Error(t("error.llm_stream_idle", { timeout: idleTimeoutMs })));
+          reject(new Error(t(sawToolCallStart ? "error.llm_stream_idle_toolcall" : "error.llm_stream_idle", { timeout: idleTimeoutMs })));
         else
           resolve(result);
       }, (err) => {
         clearTimeout(idleTimer);
         if (isTimeout())
-          reject(new Error(t("error.llm_stream_idle", { timeout: idleTimeoutMs })));
+          reject(new Error(t(sawToolCallStart ? "error.llm_stream_idle_toolcall" : "error.llm_stream_idle", { timeout: idleTimeoutMs })));
         else
           reject(err);
       });
@@ -5494,11 +5508,14 @@ class OpenAICompatProvider {
             }
             const delta = choice.delta || {};
             const finishReason = choice.finish_reason;
+            if (finishReason)
+              lastFinishReason = finishReason;
             if (delta.reasoning_content) {
               onEmit();
               yield { type: "reasoning", content: delta.reasoning_content };
             }
             if (delta.tool_calls) {
+              sawToolCallStart = true;
               for (const tc of delta.tool_calls) {
                 const idx = tc.index ?? 0;
                 if (!toolCallAccs.has(idx)) {
@@ -5516,6 +5533,7 @@ class OpenAICompatProvider {
             }
             if (delta.content) {
               onEmit();
+              sawText = true;
               yield { type: "text", content: delta.content };
             }
             if (finishReason === "tool_calls" && toolCallAccs.size > 0) {
@@ -5541,6 +5559,17 @@ class OpenAICompatProvider {
         onEmit();
         yield { type: "done", usage };
       }
+      if (lastFinishReason === "length") {
+        const truncatedToolCall = sawToolCallStart && toolCallAccs.size > 0;
+        if (truncatedToolCall || !sawText) {
+          const err = new Error(t(truncatedToolCall ? "error.llm_truncated_toolcall" : "error.llm_truncated", {
+            tokens: maxTokens
+          }));
+          err.llmTerminal = true;
+          err.recoverableLlm = true;
+          throw err;
+        }
+      }
     } finally {
       cleanup();
       reader.releaseLock();
@@ -7117,7 +7146,12 @@ var init_read_file = __esm(() => {
         remaining: String(total - end),
         next: String(end + 1)
       }) : "";
-      const display = truncated ? `${header}${truncated}` : header;
+      const fullRead = offset === 1 && end >= total;
+      const display = fullRead ? "" : t("file.read_range", {
+        from: String(offset),
+        to: String(end),
+        total: String(total)
+      });
       return {
         success: true,
         output: `${header}
@@ -10504,6 +10538,7 @@ class StuckDetector {
   lastBashOutput = "";
   emptyBashRunCount = 0;
   readOnlyStreak = 0;
+  bashRecent = [];
   errorSignatureCounts = new Map;
   searchedErrorSignatures = new Set;
   webSearchThreshold;
@@ -10558,6 +10593,20 @@ class StuckDetector {
     this.lastBashCommand = command;
     this.lastBashOutput = output;
   }
+  recordBashAttempt(success) {
+    this.bashRecent.push(success);
+    if (this.bashRecent.length > BASH_FLAIL_WINDOW)
+      this.bashRecent.shift();
+  }
+  hasBashFlailing() {
+    if (this.bashRecent.length < BASH_FLAIL_THRESHOLD)
+      return false;
+    let failures = 0;
+    for (const ok of this.bashRecent)
+      if (!ok)
+        failures++;
+    return failures >= BASH_FLAIL_THRESHOLD;
+  }
   getLastBashCommand() {
     return this.lastBashCommand;
   }
@@ -10796,6 +10845,8 @@ class StuckDetector {
     const errorTool = Array.from(this.toolErrors.entries()).find(([_, c]) => c >= this.errorThreshold);
     if (errorTool)
       return `tool-errors:${errorTool[0]}`;
+    if (this.hasBashFlailing())
+      return "bash-flailing";
     if (this.hasConsecutiveFailures())
       return "consecutive";
     if (this.hasRepetitiveToolCalls())
@@ -10844,6 +10895,13 @@ class StuckDetector {
         count: this.consecutiveFailures
       });
     }
+    if (reason === "bash-flailing") {
+      const fails = this.bashRecent.filter((ok) => !ok).length;
+      return t("exec.bash_flailing_recovery", {
+        fails: String(fails),
+        window: String(this.bashRecent.length)
+      });
+    }
     if (reason === "repetitive") {
       return this.getRepetitiveToolMessage();
     }
@@ -10860,6 +10918,8 @@ class StuckDetector {
     const errorTool = Array.from(this.toolErrors.entries()).find(([_, c]) => c >= this.errorThreshold);
     if (errorTool)
       return "tool-errors";
+    if (this.hasBashFlailing())
+      return "bash-flailing";
     if (this.hasConsecutiveFailures())
       return "consecutive";
     if (this.hasRepetitiveToolCalls())
@@ -10881,6 +10941,7 @@ class StuckDetector {
     this.lastBashCommand = "";
     this.lastBashOutput = "";
     this.emptyBashRunCount = 0;
+    this.bashRecent = [];
     this.readOnlyStreak = 0;
     this.errorSignatureCounts.clear();
     this.searchedErrorSignatures.clear();
@@ -10897,6 +10958,7 @@ class StuckDetector {
     this.lastBashCommand = "";
     this.lastBashOutput = "";
     this.emptyBashRunCount = 0;
+    this.bashRecent = [];
     this.errorSignatureCounts.clear();
     this.searchedErrorSignatures.clear();
   }
@@ -10912,12 +10974,13 @@ class StuckDetector {
     this.lastBashCommand = "";
     this.lastBashOutput = "";
     this.emptyBashRunCount = 0;
+    this.bashRecent = [];
     this.readOnlyStreak = 0;
     this.errorSignatureCounts.clear();
     this.searchedErrorSignatures.clear();
   }
 }
-var READ_ONLY_TOOLS, READ_ONLY_LOOP_THRESHOLD = 10, ANSI_RE, ERROR_LOC_RE, SIGNATURE_MAX_CHARS = 120, SEARCHABLE_PATTERNS, RUNTIME_WORDS, FRAMEWORK_WORDS;
+var READ_ONLY_TOOLS, READ_ONLY_LOOP_THRESHOLD = 10, BASH_FLAIL_WINDOW = 6, BASH_FLAIL_THRESHOLD = 4, ANSI_RE, ERROR_LOC_RE, SIGNATURE_MAX_CHARS = 120, SEARCHABLE_PATTERNS, RUNTIME_WORDS, FRAMEWORK_WORDS;
 var init_stuck_detector = __esm(() => {
   init_i18n();
   READ_ONLY_TOOLS = new Set([
@@ -12576,16 +12639,41 @@ ${t("tool.truncated", { tokens: Math.ceil(removedChars / 2) })}`;
     }
     contextManager.addMessage({ role: "user", content: input });
     slog.logUser(input);
-    if (config.moe?.enabled) {
-      return runWithMoE({
+    const startedAt = Date.now();
+    let toolCalls = 0;
+    const countTool = (ev) => {
+      if (ev.type === "end")
+        toolCalls++;
+      onTool?.(ev);
+    };
+    const emitTurnEnd = (result, err) => {
+      const interrupted = err instanceof Error && err.name === "AbortError" || this.shutdownRequested;
+      pluginManager.runOnTurnEnd?.({
+        logger,
+        sessionManager: sessionManager?.getActiveMeta(),
+        contextManager
+      }, {
+        success: !!result && result.success !== false && !err,
+        durationMs: Date.now() - startedAt,
+        textLength: (result?.text || "").length,
+        toolCalls,
+        interrupted: interrupted || undefined
+      });
+    };
+    try {
+      const result = config.moe?.enabled === true ? await runWithMoE({
         config,
         llmProvider,
         toolExecutor,
         logger,
         baseDir: this.deps.baseDir
-      }, input, () => this.executeSingleAgentLoop(input, onChunk, onMeta, onTool, onPhase), { onMeta, onTool, onPhase });
+      }, input, () => this.executeSingleAgentLoop(input, onChunk, onMeta, countTool, onPhase), { onMeta, onTool: countTool, onPhase }) : await this.executeSingleAgentLoop(input, onChunk, onMeta, countTool, onPhase);
+      emitTurnEnd(result);
+      return result;
+    } catch (err) {
+      emitTurnEnd(null, err);
+      throw err;
     }
-    return this.executeSingleAgentLoop(input, onChunk, onMeta, onTool, onPhase);
   }
   async executeSingleAgentLoop(input, onChunk, onMeta, onTool, onPhase) {
     const {
@@ -12626,6 +12714,7 @@ ${t("tool.truncated", { tokens: Math.ceil(removedChars / 2) })}`;
     let suppressRepetitionRetry = false;
     let repeatedToolCount = 0;
     const MAX_REPEATED_TOOL_CALLS = 2;
+    let llmErrorRetries = 0;
     let allToolsForBudget = toolExecutor.getToolDefinitions(this.deps.toolTags);
     let boundedToolNames = new Set(allToolsForBudget.filter((t2) => t2.boundedOutput).map((t2) => t2.name));
     let toolTokenEstimate = allToolsForBudget.reduce((sum, t2) => sum + Math.ceil((t2.description.length + JSON.stringify(t2.parameters).length) / 4), 0);
@@ -12750,6 +12839,17 @@ ${t("tool.truncated", { tokens: Math.ceil(removedChars / 2) })}`;
           logger.info("LLM call aborted (interrupt)");
           break;
         }
+        if (err?.recoverableLlm && llmErrorRetries < MAX_LLM_ERROR_RETRIES) {
+          llmErrorRetries++;
+          logger.warn(`Recoverable LLM error, feeding back (${llmErrorRetries}/${MAX_LLM_ERROR_RETRIES}): ${err.message}`);
+          slog.logError(err.message);
+          pluginManager.runOnError({ iteration, logger, contextManager }, err);
+          contextManager.addMessage({
+            role: "user",
+            content: `<system-summary>${err.message}</system-summary>`
+          });
+          continue;
+        }
         logger.logLLMResponse(config.model, textContent.length, Date.now() - llmStart, err.message, "agent");
         logger.error(`LLM call failed: ${err.message}`);
         slog.logError(err.message);
@@ -13245,7 +13345,7 @@ ${warnLine}
     });
   }
 }
-var TOOL_RESULT_MAX_TOKENS_RATIO = 0.3, TOOL_RESULT_ABSOLUTE_MAX_CHARS = 15000, QUALITY_TRIGGER_THRESHOLD = 40, FORCED_COMPACTION_COOLDOWN = 3;
+var TOOL_RESULT_MAX_TOKENS_RATIO = 0.3, TOOL_RESULT_ABSOLUTE_MAX_CHARS = 15000, QUALITY_TRIGGER_THRESHOLD = 40, FORCED_COMPACTION_COOLDOWN = 3, MAX_LLM_ERROR_RETRIES = 2;
 var init_agent = __esm(() => {
   init_manager();
   init_i18n();
@@ -14228,6 +14328,18 @@ var init_checker = __esm(() => {
 // src/modules/plugins/manager.ts
 class PluginManager {
   plugins = [];
+  hostBridge = null;
+  setHostBridge(bridge) {
+    this.hostBridge = bridge;
+  }
+  withHost(ctx) {
+    if (!ctx || typeof ctx !== "object")
+      return ctx;
+    if (!this.hostBridge || ctx.hostBridge !== undefined) {
+      return ctx;
+    }
+    return { ...ctx, hostBridge: this.hostBridge };
+  }
   register(plugin, source) {
     if (source)
       plugin.source = source;
@@ -14266,7 +14378,8 @@ class PluginManager {
       }
     });
   }
-  async runOnBeforeTool(ctx, call) {
+  async runOnBeforeTool(rawCtx, call) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onBeforeTool) {
         try {
@@ -14278,7 +14391,8 @@ class PluginManager {
     }
     return true;
   }
-  async runOnAfterTool(ctx, call, result) {
+  async runOnAfterTool(rawCtx, call, result) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onAfterTool) {
         try {
@@ -14287,7 +14401,8 @@ class PluginManager {
       }
     }
   }
-  async runOnError(ctx, error) {
+  async runOnError(rawCtx, error) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onError) {
         try {
@@ -14296,7 +14411,8 @@ class PluginManager {
       }
     }
   }
-  runOnSessionStart(ctx) {
+  runOnSessionStart(rawCtx) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onSessionStart) {
         try {
@@ -14305,7 +14421,8 @@ class PluginManager {
       }
     }
   }
-  runOnBeforeThink(ctx) {
+  runOnBeforeThink(rawCtx) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onBeforeThink) {
         try {
@@ -14314,7 +14431,8 @@ class PluginManager {
       }
     }
   }
-  runOnAfterThink(ctx, response) {
+  runOnAfterThink(rawCtx, response) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onAfterThink) {
         try {
@@ -14323,7 +14441,8 @@ class PluginManager {
       }
     }
   }
-  runOnSessionEnd(ctx) {
+  runOnSessionEnd(rawCtx) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onSessionEnd) {
         try {
@@ -14332,7 +14451,8 @@ class PluginManager {
       }
     }
   }
-  runOnToolCall(ctx) {
+  runOnToolCall(rawCtx) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onToolCall) {
         try {
@@ -14341,7 +14461,8 @@ class PluginManager {
       }
     }
   }
-  runOnPhase(ctx, phase) {
+  runOnPhase(rawCtx, phase) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onPhase) {
         try {
@@ -14350,7 +14471,8 @@ class PluginManager {
       }
     }
   }
-  runOnToolStart(ctx, call) {
+  runOnToolStart(rawCtx, call) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onToolStart) {
         try {
@@ -14359,7 +14481,8 @@ class PluginManager {
       }
     }
   }
-  runOnToolEnd(ctx, call, result, durationMs) {
+  runOnToolEnd(rawCtx, call, result, durationMs) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onToolEnd) {
         try {
@@ -14368,7 +14491,8 @@ class PluginManager {
       }
     }
   }
-  runOnText(ctx, chunk) {
+  runOnText(rawCtx, chunk) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onText) {
         try {
@@ -14380,7 +14504,8 @@ class PluginManager {
     }
     return chunk;
   }
-  runOnMeta(ctx, chunk) {
+  runOnMeta(rawCtx, chunk) {
+    const ctx = this.withHost(rawCtx);
     for (const plugin of this.plugins) {
       if (plugin.onMeta) {
         try {
@@ -14392,6 +14517,16 @@ class PluginManager {
     }
     return chunk;
   }
+  runOnTurnEnd(rawCtx, summary) {
+    const ctx = this.withHost(rawCtx);
+    for (const plugin of this.plugins) {
+      if (plugin.onTurnEnd) {
+        try {
+          plugin.onTurnEnd(ctx, summary);
+        } catch {}
+      }
+    }
+  }
 }
 var init_manager3 = __esm(() => {
   init_checker();
@@ -18072,7 +18207,7 @@ function lintCacheKey(baseDir, lintScript) {
   return `${baseDir}::${lintScript}`;
 }
 function isMissingBinaryError(err, combinedOutput) {
-  if (err.status === 127)
+  if (err.status === 127 || err.status === 9009)
     return true;
   if (err.code === "ENOENT")
     return true;
@@ -18086,24 +18221,43 @@ function contentHash(content) {
   return String(h);
 }
 function getWinDecoder() {
-  if (_winDecoder === undefined) {
-    if (platform5() !== "win32") {
-      _winDecoder = null;
-    } else {
-      try {
-        const cpOut = execSync("chcp.com", {
-          encoding: "buffer",
-          timeout: 2000,
-          windowsHide: true
-        }).toString("latin1");
-        const m = cpOut.match(/(\d+)/);
-        _winDecoder = m ? new TextDecoder("ibm" + m[1]) : null;
-      } catch {
-        _winDecoder = null;
-      }
+  if (_winDecoder !== undefined)
+    return _winDecoder;
+  if (platform5() !== "win32") {
+    _winDecoder = new TextDecoder("utf-8");
+    return _winDecoder;
+  }
+  let decoder = null;
+  try {
+    const cpOut = execSync("chcp.com", {
+      encoding: "buffer",
+      timeout: 2000,
+      windowsHide: true
+    }).toString("latin1");
+    const m = cpOut.match(/(\d+)/);
+    if (m)
+      decoder = new TextDecoder("ibm" + m[1]);
+  } catch {}
+  if (!decoder) {
+    try {
+      decoder = new TextDecoder("ibm866");
+    } catch {
+      return new TextDecoder("utf-8");
     }
   }
-  return _winDecoder ?? new TextDecoder("utf-8");
+  _winDecoder = decoder;
+  return _winDecoder;
+}
+function decodeOutput(chunks) {
+  const raw = Buffer.concat(chunks);
+  try {
+    return new TextDecoder("utf-8", { fatal: true }).decode(raw);
+  } catch {}
+  try {
+    return getWinDecoder().decode(raw);
+  } catch {
+    return raw.toString("latin1");
+  }
 }
 
 class LintOnWritePlugin {
@@ -18275,14 +18429,13 @@ function runAsync(command, cwd, timeoutMs, signal) {
       windowsHide: true,
       stdio: ["ignore", "pipe", "pipe"]
     });
-    let stdout = "";
-    let stderr = "";
-    const decoder = getWinDecoder();
+    const utf8Chunks = [];
+    const oemChunks = [];
     child.stdout?.on("data", (d) => {
-      stdout += decoder.decode(d, { stream: true });
+      utf8Chunks.push(Buffer.from(d));
     });
     child.stderr?.on("data", (d) => {
-      stderr += decoder.decode(d, { stream: true });
+      oemChunks.push(Buffer.from(d));
     });
     const timer = setTimeout(() => {
       child.kill();
@@ -18298,7 +18451,7 @@ function runAsync(command, cwd, timeoutMs, signal) {
       clearTimeout(timer);
       signal?.removeEventListener("abort", onAbort);
       if (signal?.aborted) {
-        resolve19({ stdout, stderr });
+        resolve19({ stdout: decodeOutput(utf8Chunks), stderr: decodeOutput(oemChunks) });
       } else {
         reject(err);
       }
@@ -18306,8 +18459,8 @@ function runAsync(command, cwd, timeoutMs, signal) {
     child.on("close", (code) => {
       clearTimeout(timer);
       signal?.removeEventListener("abort", onAbort);
-      stdout += decoder.decode();
-      stderr += decoder.decode();
+      const stdout = decodeOutput(utf8Chunks);
+      const stderr = decodeOutput(oemChunks);
       if (signal?.aborted || code === 0) {
         resolve19({ stdout, stderr });
       } else {
@@ -18991,6 +19144,9 @@ Last compile error: ${first[1]}`;
         }
       }
       if (!result.success) {
+        if (call.name === "bash") {
+          deps.stuckDetector.recordBashAttempt(false);
+        }
         if (call.name === "bash" && platform6() === "win32") {
           const cmd = String(call.arguments?.command ?? "");
           const forbidden = forbiddenWindowsCommand(cmd);
@@ -19010,6 +19166,9 @@ Last compile error: ${first[1]}`;
         }
       } else {
         deps.stuckDetector.recordToolSuccess();
+        if (call.name === "bash") {
+          deps.stuckDetector.recordBashAttempt(true);
+        }
         if (call.name === "bash" && result.success) {
           const cmd = String(call.arguments?.command ?? "");
           const testRun = detectTestResults(String(result.output ?? ""));
@@ -33371,8 +33530,9 @@ function stripAnsi2(s) {
 function charLen(s) {
   return Array.from(s).length;
 }
-function wrapLine(line, width) {
+function wrapLine(line, width, firstRowWidth) {
   const w = width > 0 ? width : 80;
+  let limit = firstRowWidth !== undefined && firstRowWidth > 0 ? firstRowWidth : w;
   const chars = Array.from(line);
   const rows = [];
   let start = 0;
@@ -33387,10 +33547,11 @@ function wrapLine(line, width) {
       continue;
     }
     const cw = stringWidth(ch);
-    if (cells + cw > w && cells > 0) {
+    if (cells + cw > limit && cells > 0) {
       rows.push({ text: chars.slice(start, i).join(""), charStart: start });
       start = i;
       cells = cw;
+      limit = w;
     } else {
       cells += cw;
     }
@@ -33398,10 +33559,10 @@ function wrapLine(line, width) {
   rows.push({ text: chars.slice(start).join(""), charStart: start });
   return rows;
 }
-function buildLayout(lines, width) {
+function buildLayout(lines, width, firstRowWidth) {
   const rows = [];
   for (let b = 0;b < lines.length; b++) {
-    for (const r of wrapLine(lines[b], width)) {
+    for (const r of wrapLine(lines[b], width, b === 0 ? firstRowWidth : undefined)) {
       rows.push({ bufRow: b, charStart: r.charStart, text: r.text });
     }
   }
@@ -33438,6 +33599,7 @@ class LineEditor {
   input;
   output;
   onKeyInput;
+  onInterrupt;
   promptStr;
   completer;
   history;
@@ -33456,11 +33618,15 @@ class LineEditor {
   rawMode = false;
   listeners = {};
   prevCursorRow = 0;
+  frameTopAbs = null;
+  dsrPending = false;
+  dsrTail = "";
   constructor(opts) {
     this.input = opts.input;
     this.output = opts.output;
     this.promptStr = opts.prompt ?? "";
     this.completer = opts.completer;
+    this.onInterrupt = opts.onInterrupt;
     this.history = opts.history ?? [];
     this.historySize = opts.historySize ?? 50;
     if (this.history.length > this.historySize) {
@@ -33471,6 +33637,7 @@ class LineEditor {
       if (this.rawMode)
         this.input.setRawMode(true);
       this.enableTerminalProtocols();
+      this.input.on("data", (buf) => this.consumeDsrReplies(buf.toString("utf-8")));
       readline2.emitKeypressEvents(this.input);
       this.input.on("keypress", (str, key) => this.onKey(str, key));
     } else {
@@ -33513,7 +33680,7 @@ class LineEditor {
     this.col = 0;
     this.historyIndex = -1;
     this.stash = null;
-    this.prevCursorRow = 0;
+    this.invalidateAnchor();
     if (this.input.isTTY)
       this.render();
   }
@@ -33523,7 +33690,7 @@ class LineEditor {
     this.lines = [""];
     this.row = 0;
     this.col = 0;
-    this.prevCursorRow = 0;
+    this.invalidateAnchor();
     if (this.input.isTTY)
       this.render();
   }
@@ -33743,10 +33910,10 @@ class LineEditor {
       this.commitFrame();
       this.output.write(`\r
 `);
+      this.invalidateAnchor();
       this.lines = [""];
       this.row = 0;
       this.col = 0;
-      this.prevCursorRow = 0;
       cb(answer);
       return;
     }
@@ -33763,17 +33930,21 @@ class LineEditor {
     this.commitFrame();
     this.output.write(`\r
 `);
+    this.invalidateAnchor();
     this.lines = [""];
     this.row = 0;
     this.col = 0;
-    this.prevCursorRow = 0;
     this.emitLine(text);
   }
   commitFrame() {
-    const layout = this.layout();
+    const layout = this.visibleLayout();
+    const lastLen = charLen(stripAnsi2(layout[layout.length - 1].text));
+    if (this.frameTopAbs !== null) {
+      this.output.write(`\x1B[${this.frameTopAbs + layout.length - 1};${lastLen + 1}H`);
+      return;
+    }
     const idx = layoutIndexFor(layout, this.row, this.col);
     const rowsDown = layout.length - 1 - idx;
-    const lastLen = charLen(stripAnsi2(layout[layout.length - 1].text));
     const out = [];
     if (rowsDown > 0)
       out.push(`\x1B[${rowsDown}B`);
@@ -33786,9 +33957,15 @@ class LineEditor {
     this.lines = [""];
     this.row = 0;
     this.col = 0;
-    this.prevCursorRow = 0;
+    this.invalidateAnchor();
     this.render();
-    process.emit("SIGINT");
+    if (this.onInterrupt) {
+      this.onInterrupt();
+      return;
+    }
+    if (process.listenerCount("SIGINT") > 0) {
+      process.emit("SIGINT");
+    }
   }
   ctrlD() {
     if (this.lines.length === 1 && this.lines[0] === "") {
@@ -34055,28 +34232,68 @@ class LineEditor {
   }
   clearScreen() {
     this.output.write("\x1B[2J\x1B[H");
-    this.prevCursorRow = 0;
+    this.invalidateAnchor();
     this.render();
   }
   columns() {
     return this.output.columns || 80;
   }
   layout() {
-    return buildLayout(this.lines, this.columns());
+    const promptWidth = stringWidth(stripAnsi2(this.promptStr));
+    return buildLayout(this.lines, this.columns(), Math.max(1, this.columns() - promptWidth));
+  }
+  screenRows() {
+    const r = this.output.rows;
+    return typeof r === "number" && r > 3 ? r : null;
+  }
+  visibleLayout() {
+    const layout = this.layout();
+    const H = this.screenRows();
+    const maxRows = H ? H - 2 : 0;
+    if (maxRows > 0 && layout.length > maxRows) {
+      return layout.slice(layout.length - maxRows);
+    }
+    return layout;
+  }
+  invalidateAnchor() {
+    this.frameTopAbs = null;
+    this.dsrPending = false;
+    this.dsrTail = "";
+    this.prevCursorRow = 0;
+  }
+  consumeDsrReplies(chunk) {
+    this.dsrTail = (this.dsrTail + chunk).slice(-80);
+    const m = /\x1b\[(\d+);(\d+)R/.exec(this.dsrTail);
+    if (!m)
+      return;
+    this.dsrTail = "";
+    if (!this.dsrPending)
+      return;
+    this.dsrPending = false;
+    const row = Number(m[1]);
+    const idx = Number(m[2]);
+    const top = row - this.prevCursorRow;
+    if (top >= 1)
+      this.frameTopAbs = top;
   }
   render() {
     if (!this.input.isTTY || this.isDone)
       return;
-    const layout = this.layout();
+    const layout = this.visibleLayout();
     const promptWidth = stringWidth(stripAnsi2(this.promptStr));
     const idx = layoutIndexFor(layout, this.row, this.col);
     const vcol = visualColAt(layout, idx, this.col);
     const rowsAfter = layout.length - idx - 1;
     const ccol = (idx === 0 ? promptWidth : 0) + vcol;
     const out = [];
-    if (this.prevCursorRow > 0)
+    if (this.frameTopAbs !== null) {
+      out.push(`\x1B[${this.frameTopAbs};1H`);
+    } else if (this.prevCursorRow > 0) {
       out.push(`\x1B[${this.prevCursorRow}A`);
-    out.push("\r");
+      out.push("\r");
+    } else {
+      out.push("\r");
+    }
     for (let i = 0;i < layout.length; i++) {
       out.push("\x1B[2K");
       if (i === 0)
@@ -34092,8 +34309,17 @@ class LineEditor {
     out.push("\r");
     if (ccol > 0)
       out.push(`\x1B[${ccol}C`);
-    this.prevCursorRow = idx;
     this.output.write(out.join(""));
+    if (this.frameTopAbs !== null) {
+      const H = this.screenRows();
+      if (H) {
+        const T = this.frameTopAbs;
+        const L = layout.length;
+        if (T + L - 1 > H)
+          this.frameTopAbs = H - L + 1;
+      }
+    } else if (!this.dsrPending) {}
+    this.prevCursorRow = idx;
   }
   enableTerminalProtocols() {
     this.output.write("\x1B[?2004h");
@@ -34450,9 +34676,28 @@ init_box();
 init_table();
 init_i18n();
 init_prices();
+import { isAbsolute as isAbsolute4, relative as relative6, sep as sep2 } from "path";
 function formatUsd(cost) {
   return formatCost(cost);
 }
+var PATH_TOOLS = new Set([
+  "read_file",
+  "write_file",
+  "edit_file",
+  "delete_file",
+  "create_dir",
+  "move_file",
+  "list_dir",
+  "file_info"
+]);
+function toDisplayPath(baseDir, p) {
+  if (!baseDir || !isAbsolute4(p))
+    return p;
+  const rel = relative6(baseDir, p);
+  if (!rel || rel.startsWith("..") || isAbsolute4(rel))
+    return p;
+  return rel.split(sep2).join("/");
+}
 var GUTTER = "  ";
 var BUSY_TOOLS = new Set(["lsp_check"]);
 function toolMarker(tool) {
@@ -34506,6 +34751,7 @@ class Renderer {
   err;
   width;
   toolStyle;
+  baseDir;
   card = null;
   constructor(opts = {}) {
     this.rich = opts.rich ?? isRichTerminal();
@@ -34513,6 +34759,7 @@ class Renderer {
     this.err = opts.err ?? process.stderr;
     this.width = opts.width ?? getTerminalWidth();
     this.toolStyle = opts.toolStyle ?? "inline";
+    this.baseDir = opts.baseDir;
     this.spinner = new Spinner({
       enabled: this.rich && (opts.spinner ?? true),
       stream: this.err,
@@ -34560,7 +34807,8 @@ class Renderer {
   toolStart(tool, args, stepContext, icon) {
     this.endCard();
     this.spinner.stop();
-    const summary = summarizeArgs2(args);
+    const displayArgs = PATH_TOOLS.has(tool) && typeof args.path === "string" ? { ...args, path: toDisplayPath(this.baseDir, args.path) } : args;
+    const summary = summarizeArgs2(displayArgs);
     const step = stepContext ? ` ${pc2.cyan(`← ${stepContext}`)}` : "";
     const marker = icon || toolMarker(tool);
     if (!this.rich) {
@@ -34862,6 +35110,22 @@ function formatContextBar(used, limit, compactions, quality) {
   }
   return line;
 }
+function createHostBridge(opts) {
+  return {
+    isBusy: opts.isBusy,
+    async submit(text, o) {
+      if (opts.isBusy())
+        throw new Error("agent is busy");
+      for (const url of o?.images ?? [])
+        opts.addPendingImage(url);
+      return opts.runAgent(text);
+    },
+    interrupt() {
+      if (opts.isBusy())
+        opts.interruptRun();
+    }
+  };
+}
 
 class Repl {
   completer = new Completer;
@@ -34934,6 +35198,19 @@ class Repl {
     registerAllCommands(this);
     this.setupCompleter();
     this.setupListeners();
+    if (pluginManager) {
+      pluginManager.setHostBridge(createHostBridge({
+        isBusy: () => this.agentRunning,
+        addPendingImage: (url) => {
+          this.agent.contextManager?.addPendingImage?.({
+            type: "image_url",
+            image_url: { url }
+          });
+        },
+        runAgent: (text) => this.runAgent(text),
+        interruptRun: () => this.agent.shutdown()
+      }));
+    }
   }
   loadHistory() {
     if (existsSync52(this.historyPath)) {
@@ -35071,7 +35348,10 @@ class Repl {
       this.rl.onKeyInput = (str, key) => this.handleSpecialKey(str, key);
     }
     let forceExitTimer = null;
-    process.on("SIGINT", () => {
+    if (typeof Repl.sigintHandler === "function") {
+      process.removeListener("SIGINT", Repl.sigintHandler);
+    }
+    Repl.sigintHandler = () => {
       if (this.agentRunning) {
         console.log(pc2.yellow(t("repl.ctrl_c_interrupt")));
         this.agent.shutdown();
@@ -35082,7 +35362,8 @@ class Repl {
       } else {
         process.exit(0);
       }
-    });
+    };
+    process.on("SIGINT", Repl.sigintHandler);
   }
   handleSpecialKey(str, key) {
     if (key.name === "escape") {
@@ -35160,7 +35441,8 @@ ${t("image.clipboard_empty")}`));
 ` + pc2.green(t("repl.agent")));
       const renderer = new Renderer({
         spinner: this.config.ui?.spinner ?? true,
-        toolStyle: this.config.ui?.toolStyle ?? "inline"
+        toolStyle: this.config.ui?.toolStyle ?? "inline",
+        baseDir: this.baseDir
       });
       const result = await this.agent.run(input, (c) => renderer.text(c), (m) => renderer.meta(m), (ev) => {
         if (ev.type === "start") {
@@ -35642,7 +35924,7 @@ async function main() {
   }
   if (program2.args.length > 0) {
     const prompt = program2.args.join(" ");
-    const { agent, config } = await bootstrap(undefined, projectDir, noAgentsMd, exitOnComplete);
+    const { agent, config, baseDir } = await bootstrap(undefined, projectDir, noAgentsMd, exitOnComplete);
     const updater = exitOnComplete ? undefined : startAutoUpdate(config);
     if (jsonMode) {
       const result2 = await agent.run(prompt);
@@ -35667,7 +35949,8 @@ async function main() {
     }
     const renderer = new Renderer({
       spinner: config.ui?.spinner ?? true,
-      toolStyle: config.ui?.toolStyle ?? "inline"
+      toolStyle: config.ui?.toolStyle ?? "inline",
+      baseDir
     });
     const result = await agent.run(prompt, (chunk) => renderer.text(chunk), (meta) => renderer.meta(meta), (ev) => {
       if (ev.type === "start") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "micro-models-agent",
-  "version": "0.50.1",
+  "version": "0.51.1",
   "description": "Micro Models Agent (MMA) — LLM agent harness for small models (Qwen3.5-9B, 32K-64K context)",
   "type": "module",
   "bin": {