thincoder 0.8.2 → 0.8.4

package/src/tui/key-handler.mjs

@@ -1,7 +1,7 @@
 import { ansi, C } from "./ansi.mjs"
 
-/** 键盘事件分发：权限确认 / 问答 / picker / wizard / 编辑 / 翻页 / 历史 / 粘贴。
- *  从 index.mjs 抽出。
+/** Keyboard event dispatch: permission confirm / question / picker / wizard / edit / scroll / history / paste.
+ *  Extracted from index.mjs.
  *  ctx: { agent, state, render, renderPickerLines, closePicker,
  *         handleSlash, handleTab, submit, pasteClipboardImage,
  *         wizardChooseProvider, wizardSubmitText, cancelWizard, wizardProviderItems,
@@ -10,7 +10,7 @@ export function createKeyHandler(ctx) {
   const { agent, state, render, closePicker, renderPickerLines, handleSlash, handleTab, submit, pasteClipboardImage, wizardChooseProvider, wizardSubmitText, cancelWizard, wizardProviderItems, renderWizard, pushLine, cleanup } = ctx
 
   return function onKeypress(str, key = {}) {
-    // 权限确认态：y 批准 / n 拒绝 / a 批准并On AUTO (后续不再询问）
+    // permission confirm state: y approve / n deny / a approve + turn ON AUTO (no further prompts)
     if (state.permission) {
       const answer = (str || "").toLowerCase()
       const isContinue = state.permission.name === "continue"
@@ -27,7 +27,7 @@ export function createKeyHandler(ctx) {
           pushLine(`  [auto] AUTO ON: tool calls no longer prompt for approval (/auto to disable)`, C.warn)
         }
         const approved = answer === "y" || (answer === "a" && !isContinue)
-        // 决定落痕：对话区留下批准/拒绝记录 (continue 询问有自己的输出，不重复记）
+        // leave trail: record approval/denial in conversation (continue prompt has its own output, don't duplicate)
         if (!isContinue) {
           pushLine(`  [${approved ? "approved" : "denied"}] ${name}`, approved ? C.dim : C.error)
         }
@@ -37,13 +37,13 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // question 工具回调：自由文本 / 选项选择
+    // question tool callback: free text / option selection
     if (state.question) {
       const q = state.question
       if (q.options.length > 0) {
-        // 选项模式：↑↓ 选择，Enter 确认，Esc 取消
+        // options mode: ↑↓ select, Enter confirm, Esc cancel
         if (key.name === "escape") {
-          q.resolve("(cancelled)")
+          q.resolve("")
           state.question = null
           state.status = "Processing..."
           render()
@@ -62,15 +62,15 @@ export function createKeyHandler(ctx) {
           render()
         }
       } else {
-        // 自由文本：键入答案，Enter 提交，Esc 取消
+        // free text: type answer, Enter submit, Esc cancel
         if (key.name === "escape") {
-          q.resolve("(cancelled)")
+          q.resolve("")
           state.question = null
           state.status = "Processing..."
           render()
         } else if (key.name === "return") {
           const answer = (q.answer ?? "").trim()
-          q.resolve(answer || "(empty answer)")
+          q.resolve(answer || "")
           state.question = null
           state.status = "Processing..."
           pushLine(`  → ${answer || "(empty)"}`, C.tool)
@@ -97,7 +97,7 @@ export function createKeyHandler(ctx) {
       setTimeout(() => process.exit(0), 100)
     }
 
-    // 通用列表选择器：↑↓ 移动，Enter 确认，Esc 取消
+    // generic list picker: ↑↓ move, Enter confirm, Esc cancel
     if (state.picker) {
       const items = state.picker?.entries.filter((e) => e.type === "item") ?? []
       if (key.name === "escape") {
@@ -111,8 +111,8 @@ export function createKeyHandler(ctx) {
       } else if (key.name === "return" && items.length) {
         const selected = items[state.picker.index]
         const handler = state.picker.onSelect
-        state.picker = null // 先关 picker，避免 onSelect 内部 render 时 picker 还在
-        // onSelect 是 async（如删 provider 要写文件），用 catch 兜住错误不被吞
+        state.picker = null // close picker first, avoid picker still being present during onSelect render
+        // onSelect is async (e.g. removing a provider writes file), catch errors so they aren't swallowed
         Promise.resolve(handler?.(selected)).catch((err) => {
           pushLine(`[error] ${err.message}`, C.error)
         }).finally(() => render())
@@ -120,7 +120,7 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 初始Config向导：菜单步 ↑↓/Enter/Esc；文本步 Enter 提交、Esc 取消，编辑键落到正常输入
+    // initial config wizard: menu step ↑↓/Enter/Esc; text step Enter submit, Esc cancel, edit keys fall through to normal input
     if (state.wizard) {
       const w = state.wizard
       if (key.name === "escape") {
@@ -144,11 +144,11 @@ export function createKeyHandler(ctx) {
         wizardSubmitText()
         return
       }
-      // 文本步骤屏蔽翻页/历史，其余编辑键放行到下面的普通输入逻辑
+      // text steps: block scroll/history, remaining edit keys fall through to normal input logic below
       if (key.name === "up" || key.name === "down" || key.name === "pageup" || key.name === "pagedown") return
     }
 
-    // 翻页
+    // page scroll
     if (key.name === "pageup") {
       state.scroll += Math.max(1, (process.stdout.rows || 24) - 8)
       render()
@@ -161,9 +161,9 @@ export function createKeyHandler(ctx) {
     }
 
     if (state.processing) {
-      // 处理中允许输入（排队），但屏蔽方向键历史和 Tab 补全
+      // during processing, allow input (queued), but block arrow-key history and Tab completion
       if (key.name === "tab" || key.name === "up" || key.name === "down") return
-      // Ctrl+D：删除队列中最后一条
+      // Ctrl+D: remove last item from queue
       if (key.ctrl && key.name === "d") {
         if (state.queue.length > 0) {
           state.queue.pop()
@@ -171,16 +171,24 @@ export function createKeyHandler(ctx) {
         }
         return
       }
-      // 其余可打印字符正常进入输入框
+      // remaining printable characters go into input box normally
     }
 
-    // Tab：斜杠Commands补全 (循环候选）；其余输入忽略 (\t 会顶破输入框，永不直接插入）
+    // Tab: slash-command completion (cycle candidates); other input ignored (\t would blow up input box, never inserted directly)
     if (key.name === "tab") {
       handleTab()
       return
     }
 
-    // 输入历史
+    // Ctrl+U: clear entire input box
+    if ((key.name === "u" && key.ctrl) || str === "\x15") {
+      state.input = []
+      state.cursor = 0
+      render()
+      return
+    }
+
+    // input history
     if (key.name === "up") {
       if (state.history.length) {
         state.historyIndex = state.historyIndex === -1 ? state.history.length - 1 : Math.max(0, state.historyIndex - 1)
@@ -205,7 +213,7 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 光标移动
+    // cursor movement
     if (key.name === "left") {
       state.cursor = Math.max(0, state.cursor - 1)
       render()
@@ -227,7 +235,7 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 编辑
+    // editing
     if (key.name === "backspace") {
       if (state.cursor > 0) {
         state.input.splice(state.cursor - 1, 1)
@@ -248,15 +256,15 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // Ctrl+V (Unix) / Alt+V (Windows)：粘贴剪贴板图片 → 存临时文件 → 输入框插入 read_image
+    // Ctrl+V (Unix) / Alt+V (Windows): paste clipboard image → save temp file → insert read_image into input box
     const isPasteImage = (key.name === "v" && (key.ctrl || key.meta)) || (key.name === "v" && key.alt)
     if (isPasteImage) {
       pasteClipboardImage(agent).catch((e) => pushLine(`[error] ${e.message}`, C.error))
       return
     }
 
-    // 可打印字符 / 粘贴 (str 可能一次多个字符）；Tab 一律转成两个空格 (\t 显示宽度不定，会顶破输入框）
-    // \r\n 在 Windows raw mode 下可能漏进来冲乱页面
+    // printable characters / paste (str may contain multiple chars at once); Tab always converted to two spaces (\t has variable display width, would blow up input box)
+    // \r\n may leak through in Windows raw mode and scramble the display
     if (str && !key.ctrl && !key.meta) {
       const chars = [...str.replace(/[\r\n]+/g, "").replace(/\t/g, "  ")]
       state.input.splice(state.cursor, 0, ...chars)

package/src/tui/layout.mjs

@@ -1,11 +1,11 @@
 /**
- * layout.mjs — TUI 布局引擎（纯函数）
- * 从 state + 终端尺寸计算每个面板的位置和高度。
- * 不修改 state——副作用由调用方在渲染前执行。
+ * layout.mjs — TUI layout engine (pure function)
+ * Computes position and height of each panel from state + terminal dimensions.
+ * Does not modify state — side effects are performed by the caller before rendering.
  *
- * 面板布局（自上而下）：
- *   header → conversation → picker → todo → subagent → permission → queue → input → status
- * 固定面板先扣除，条件面板按优先级分配，剩余空间全给 conversation。
+ * Panel layout (top to bottom):
+ *   header → conversation → subagent → output → todo → permission → queue → input → status
+ * Fixed panels deducted first, conditional panels allocated by priority, remaining space to conversation.
  */
 import { layoutInput, wrapText } from "./render.mjs"
 
@@ -15,13 +15,13 @@ export const MAX_SUB_LINES = 4
 const QWIN = 5
 
 /**
- * 计算布局。返回面板坐标 + 预计算的内容（影响高度的部分）。
- * 纯函数：不修改 state。
+ * Computes layout. Returns panel coordinates + precomputed content (height-affecting parts).
+ * Pure function: does not modify state.
  */
 export function computeLayout(state, { cols, rows }) {
   const W = Math.max(20, cols - 1)
 
-  // --- 输入框 ---
+  // --- input box ---
   const inputLayout = layoutInput(state.input, state.cursor, W - 4)
   let inputOffset = 0
   if (inputLayout.lines.length > MAX_INPUT_LINES) {
@@ -41,11 +41,11 @@ export function computeLayout(state, { cols, rows }) {
   }
   const inputBoxH = boxLines.length + 2
 
-  // --- 固定面板 ---
+  // --- fixed panels ---
   const headerH = 1
   const statusH = 1
 
-  // --- 条件面板 ---
+  // --- conditional panels ---
   const overlay = state.picker ?? state.wizard
   const pickerH = overlay ? Math.min(overlay.lines.length + 1, Math.max(6, rows - 12)) : 0
 
@@ -67,6 +67,10 @@ export function computeLayout(state, { cols, rows }) {
     ? Math.min(allSubs.length, MAX_SUB_LINES) + (allSubs.length > MAX_SUB_LINES ? 1 : 0)
     : 0
 
+  // Tool output panels: max 8 lines per panel, capped at reasonable total
+  const panels = Object.values(state.outputPanels).filter((p) => !p.done)
+  const outputPanelsH = panels.length > 0 ? Math.min(panels.length * 8, rows - 10) : 0
+
   // Permission preview (height depends on wrapped content)
   let permPreviewLines = []
   let permPreviewH = 0
@@ -84,17 +88,18 @@ export function computeLayout(state, { cols, rows }) {
   // Queue preview (1 line when queue has items and processing)
   const queueH = state.queue.length > 0 && state.processing ? 1 : 0
 
-  // --- 弹性面板：conversation 占剩余空间 ---
-  const fixedH = headerH + inputBoxH + statusH + pickerH + taskPanelH + subPanelH + permPreviewH + queueH
+  // --- elastic panel: conversation takes remaining space ---
+  const fixedH = headerH + inputBoxH + statusH + pickerH + taskPanelH + subPanelH + outputPanelsH + permPreviewH + queueH
   const convH = Math.max(1, rows - fixedH)
 
-  // --- Y 坐标（0-indexed，ANSI 用时 +1）---
+  // --- Y coordinates (0-indexed, +1 when used with ANSI) ---
   let y = 0
   const header = { y, h: headerH }; y += headerH
   const conversation = { y, h: convH }; y += convH
+  const subagent = subPanelH > 0 ? { y, h: subPanelH } : null; y += subPanelH
+  const output = outputPanelsH > 0 ? { y, h: outputPanelsH } : null; y += outputPanelsH
   const picker = pickerH > 0 ? { y, h: pickerH } : null; y += pickerH
   const todo = taskPanelH > 0 ? { y, h: taskPanelH } : null; y += taskPanelH
-  const subagent = subPanelH > 0 ? { y, h: subPanelH } : null; y += subPanelH
   const permission = permPreviewH > 0 ? { y, h: permPreviewH } : null; y += permPreviewH
   const queue = queueH > 0 ? { y, h: queueH } : null; y += queueH
   const inputBox = { y, h: inputBoxH }; y += inputBoxH
@@ -102,8 +107,8 @@ export function computeLayout(state, { cols, rows }) {
 
   return {
     W, cols, rows,
-    panels: { header, conversation, picker, todo, subagent, permission, queue, inputBox, status },
-    // 预计算内容（影响高度，渲染时复用）
+    panels: { header, conversation, picker, todo, subagent, output, permission, queue, inputBox, status },
+    // precomputed content (affects height, reused during render)
     inputLayout,
     inputOffset,
     boxLines,

package/src/tui/pickers.mjs

@@ -1,16 +1,16 @@
 import { sliceByWidth } from "./render.mjs"
 import { PROVIDER_PRESETS as PRESETS } from "../config.mjs"
 
-/** 通用列表选择器 + 统一模型/provider 管理 picker。
- *  通过 createPickers(ctx) 接收闭包依赖，
- *  返回 { openPicker, closePicker, renderPickerLines, openModelPicker, setProviderKey }。 */
+/** Generic list picker + unified model/provider management picker.
+ *  Receives closure dependencies via createPickers(ctx),
+ *  returns { openPicker, closePicker, renderPickerLines, openModelPicker, setProviderKey }. */
 export function createPickers(ctx) {
   const { agent, state, render, ansi, C, pushLine, persistRaw, askQuestion, maskKey } = ctx
 
   const pickerItems = () => state.picker?.entries.filter((e) => e.type === "item") ?? []
 
-  /** 打开通用列表选择器。entries 含 { type: "header"|"item", text, note?, ...extra }，
-   *  onSelect 拿到选中条目 (含 extra 字段透传），onCancel 在 Esc 时调。 */
+  /** Open a generic list picker. entries contain { type: "header"|"item", text, note?, ...extra },
+   *  onSelect receives the selected entry (with extra fields forwarded), onCancel called on Esc. */
   function openPicker({ title, entries, onSelect, onCancel, defaultIndex = 0 }) {
     state.picker = { title, entries, lines: [], index: defaultIndex, scroll: 0, selectedLine: 0, onSelect, onCancel }
     renderPickerLines()
@@ -22,7 +22,7 @@ export function createPickers(ctx) {
     render()
   }
 
-  /** 按 entries 重建显示行并刷新 */
+  /** Rebuild display lines from entries and refresh */
   function renderPickerLines() {
     const p = state.picker
     if (!p) return
@@ -48,7 +48,7 @@ export function createPickers(ctx) {
     render()
   }
 
-  // ========== 统一 picker：模型切换 + provider 管理 ==========
+  // ========== unified picker: model switch + provider management ==========
 
   async function openModelPicker() {
     const entries = buildModelEntries()
@@ -64,14 +64,14 @@ export function createPickers(ctx) {
       }
     }
     openPicker({ title: "Models & Providers", entries, onSelect })
-    // 默认选中当前在用的模型
+    // default select the currently active model
     const current = pickerItems().findIndex(
       (e) => e.action === "switch" && e.provider === agent.activeProvider && e.model === agent.provider.model,
     )
     if (current >= 0) state.picker.index = current
     renderPickerLines()
 
-    // 异步拉取远端模型列表，追加到对应 provider 下
+    // async fetch remote model list, append under each provider
     const { listModels } = await import("../provider/index.mjs")
     await Promise.all(
       agent.providers.map(async (p) => {
@@ -84,7 +84,7 @@ export function createPickers(ctx) {
             { baseURL: p.baseURL, apiKey: apiKey ?? "" },
             { signal: AbortSignal.timeout(10000) },
           )
-          // 找到当前 provider 在 entries 里的模型 item 位置，在其后插入新模型
+          // find the model item position for this provider in entries, insert new models after it
           const at = entries.findLastIndex(
             (e) => e.type === "item" && e.action === "switch" && e.provider === p.name,
           )
@@ -97,7 +97,7 @@ export function createPickers(ctx) {
                 .map((m) => ({ type: "item", text: m, action: "switch", provider: p.name, model: m })),
             )
           }
-          // 更新 header note 去掉 loading
+          // update header note to remove "loading..."
           const header = entries.find((e) => e.type === "header" && e.text === p.name)
           if (header) header.note = `${p.baseURL}${p.apiKey ? "" : " (no key)"}`
         } catch (error) {
@@ -109,7 +109,7 @@ export function createPickers(ctx) {
     )
   }
 
-  /** 构建 picker entries：每个 provider 一个 header + 模型列表，底部是管理操作 */
+  /** Build picker entries: each provider gets a header + model list, management actions at the bottom */
   function buildModelEntries() {
     const entries = []
     for (const p of agent.providers) {
@@ -128,7 +128,7 @@ export function createPickers(ctx) {
         marker: active ? "●" : "",
       })
     }
-    // 管理操作
+    // management actions
     entries.push({ type: "header", text: "Provider Management" })
     entries.push({ type: "item", text: "Add provider…", action: "add" })
     if (agent.providers.length > 1) {
@@ -138,7 +138,7 @@ export function createPickers(ctx) {
     return entries
   }
 
-  /** 切换 provider + 模型，持久化，阈值随模型走 */
+  /** Switch provider + model, persist, threshold follows model */
   async function selectModel(item) {
     closePicker()
     const target = agent.providers.find((pp) => pp.name === item.provider)
@@ -167,7 +167,7 @@ export function createPickers(ctx) {
     }
   }
 
-  /** 添加 provider：预设菜单 → 输入 key → 完成，或自定义逐项输入 */
+  /** Add provider: preset menu → input key → done, or custom step-by-step input */
   async function addProviderFlow() {
     const presetEntries = [
       { type: "header", text: "Select a preset provider" },
@@ -204,7 +204,7 @@ export function createPickers(ctx) {
           openModelPicker().catch(() => {})
           return
         }
-        // 预设
+        // preset
         if (agent.providers.some((p) => p.name === se.name)) { openModelPicker().catch(() => {}); return }
         const preset = PRESETS[se.name]
         const providerCfg = { name: se.name, baseURL: preset.baseURL, model: preset.model }
@@ -222,7 +222,7 @@ export function createPickers(ctx) {
     })
   }
 
-  /** 删除 provider（不能删当前激活的） */
+  /** Remove provider (cannot remove the currently active one) */
   async function removeProviderFlow() {
     const candidates = agent.providers.filter((p) => p.name !== agent.activeProvider)
     if (candidates.length === 0) { openModelPicker().catch(() => {}); return }
@@ -243,7 +243,7 @@ export function createPickers(ctx) {
     })
   }
 
-  /** 设置/更改 API key：选 provider → 输入 key */
+  /** Set/change API key: select provider → enter key */
   async function setKeyFlow() {
     const keyEntries = [
       { type: "header", text: "Select provider to configure key" },
@@ -266,7 +266,7 @@ export function createPickers(ctx) {
     })
   }
 
-  /** 给指定 provider 写 key (内存 + Config文件）；若它是current激活的，同步运行时 */
+  /** Write key for a given provider (memory + config file); if it's the currently active one, sync runtime too */
   async function setProviderKey(name, key) {
     const target = agent.providers.find((p) => p.name === name)
     if (!target) return

package/src/tui/render-frame.mjs

@@ -1,9 +1,9 @@
 /**
- * render-frame.mjs — 终端帧渲染（纯计算，无副作用）
- * 从 state + agent + layout 产生 ANSI 帧字符串，返回光标位置。
+ * render-frame.mjs — terminal frame renderer (pure computation, no side effects)
+ * Produces an ANSI frame string from state + agent + layout, returns cursor position.
  *
- * 布局计算见 layout.mjs（computeLayout 纯函数）。
- * 副作用（scroll 归位、ctxCache 更新）由调用方在渲染前执行。
+ * Layout calculation lives in layout.mjs (computeLayout pure function).
+ * Side effects (scroll clamping, ctxCache update) are performed by the caller before rendering.
  */
 import { ansi, C, ESC } from "./ansi.mjs"
 import { computeLayout, MAX_SUB_LINES } from "./layout.mjs"
@@ -13,7 +13,7 @@ import {
 import { specForModel } from "../config.mjs"
 import { basename } from "node:path"
 
-// ---------- status bar slash-command hints (查表替代 if-else 链) ----------
+// ---------- status bar slash-command hints (lookup table instead of if-else chain) ----------
 const SLASH_HINTS = {
   "/config": "open config menu",
   "/model": "select model & manage providers",
@@ -25,8 +25,8 @@ const SLASH_HINTS = {
 }
 
 /**
- * 渲染一帧，返回 { frame, cursorRow, cursorCol }。
- * 纯函数：不修改 state/agent。
+ * Render one frame, returns { frame, cursorRow, cursorCol }.
+ * Pure function: does not modify state/agent.
  */
 export function renderFrame(state, agent, opts) {
   const cols = opts.cols || 80
@@ -111,6 +111,29 @@ export function renderFrame(state, agent, opts) {
     }
   }
 
+  // ---- tool output panels (streaming output like tail -f, auto-clears when done) ----
+  if (panels.output) {
+    const active = Object.values(state.outputPanels).filter((p) => !p.done)
+    if (active.length > 0) {
+      const linesPerPanel = Math.max(1, Math.floor(panels.output.h / active.length))
+      for (const p of active) {
+        const textLines = (p.text ?? "").split("\n").filter((l) => l.trim())
+        const tail = textLines.slice(-linesPerPanel)
+        for (const line of tail) {
+          out.push(`${C.dim}  │ ${sliceByWidth(sanitizeDisplay(line), W - 5)}${ansi.reset}${ansi.clearLine}`)
+        }
+      }
+      // fill remaining rows
+      const used = active.reduce((s, p) => {
+        const tl = (p.text ?? "").split("\n").filter((l) => l.trim()).slice(-linesPerPanel)
+        return s + tl.length
+      }, 0)
+      for (let i = used; i < panels.output.h; i++) {
+        out.push(ansi.clearLine)
+      }
+    }
+  }
+
   // ---- permission preview ----
   if (panels.permission) {
     out.push(`${ansi.bold}${C.warn}❯ Permission Request${ansi.reset}${ansi.clearLine}`)
@@ -122,7 +145,7 @@ export function renderFrame(state, agent, opts) {
   // ---- queue preview ----
   if (panels.queue) {
     const preview = sliceByWidth(state.queue[0].text, W - 20)
-    out.push(`${C.dim}❯ Queue: ${state.queue.length} pending${state.queue.length > 1 ? ` (next: ${preview}…)` : ` (next: ${preview})`} — Ctrl+D del${ansi.reset}${ansi.clearLine}`)
+    out.push(`${C.dim}❯ Queue: ${state.queue.length} pending${state.queue.length > 1 ? ` (next: ${preview}…)` : ` (next: ${preview})`} — Ctrl+D delete${ansi.reset}${ansi.clearLine}`)
   }
 
   // ---- input box ----
@@ -131,6 +154,9 @@ export function renderFrame(state, agent, opts) {
   if (title === " Input " && isMultimodal) {
     const hint = platform === "win32" ? " Alt+V paste " : " Ctrl+V paste "
     topBorder = `╭─${title}${"─".repeat(Math.max(0, W - 4 - stringWidth(title) - stringWidth(hint)))}${hint}─╮`
+  } else if (title === " Input ") {
+    const hint = " Ctrl+U clear "
+    topBorder = `╭─${title}${"─".repeat(Math.max(0, W - 4 - stringWidth(title) - stringWidth(hint)))}${hint}─╮`
   } else {
     topBorder = `╭─${title}${"─".repeat(Math.max(0, W - 3 - stringWidth(title)))}╮`
   }
@@ -161,7 +187,7 @@ export function renderFrame(state, agent, opts) {
   return { frame, cursorRow, cursorCol }
 }
 
-// ---------------------------------------------------------- 内部实现
+// ---------------------------------------------------------- internal helpers
 
 /** Count conversation lines after sanitize + wrap (for scroll clamping). Pure. */
 export function countConvLines(state, cols) {
@@ -282,8 +308,8 @@ function buildStatusLine(state, agent, { cols, slashCommands }) {
   const ctxPct = Math.round((state.ctxCache.tokens / ctxThreshold) * 100)
   const ctxHint = ctxPct > 0
     ? ctxPct >= 80
-      ? ` │ ${ansi.reset}${C.warn}ctx ${ctxPct}%${ansi.reset}${ansi.dim}`
-      : ` │ ctx ${ctxPct}%`
+      ? ` │ ${ansi.reset}${C.warn}context ${ctxPct}%${ansi.reset}${ansi.dim}`
+      : ` │ context ${ctxPct}%`
     : ""
   const queueHint = state.queue.length > 0 ? ` │ queue: ${state.queue.length}` : ""
   return ` ${statusText}${taskHint}${tokenHint}${ctxHint}${queueHint}${scrollHint} │ Enter: send${state.processing ? " (queue)" : ""} │ /: commands │ wheel/PgUp/PgDn: scroll │ Ctrl+C: exit`

package/src/tui/render.mjs

@@ -1,14 +1,14 @@
 /**
- * tui-render.mjs — 终端显示工具（纯函数，零依赖）
- * 字符宽度计算、CJK/emoji 排版、文本折行、markdown 表格重排。
+ * tui-render.mjs — terminal display utilities (pure functions, zero dependencies)
+ * Character width calculation, CJK/emoji typesetting, text wrapping, markdown table reformatting.
  */
 
-/** 字符显示宽度：CJK/emoji 计 2，组合字符计 0，其余计 1 */
+/** Character display width: CJK/emoji count as 2, combining characters as 0, rest as 1 */
 export function charWidth(cp) {
   if (
-    (cp >= 0x300 && cp <= 0x36f) || // 组合变音符
-    (cp >= 0x200b && cp <= 0x200f) || // 零宽
-    cp === 0xfe0f // emoji 变体选择符
+    (cp >= 0x300 && cp <= 0x36f) || // combining diacritics
+    (cp >= 0x200b && cp <= 0x200f) || // zero-width
+    cp === 0xfe0f // emoji variation selector
   ) {
     return 0
   }
@@ -29,13 +29,14 @@ export function charWidth(cp) {
   return 1
 }
 
+/** Compute the display width of a string (CJK characters count as 2) */
 export function stringWidth(text) {
   let w = 0
   for (const ch of text) w += charWidth(ch.codePointAt(0))
   return w
 }
 
-/** 按显示宽度裁剪 */
+/** Slice by display width */
 export function sliceByWidth(text, maxWidth) {
   let w = 0
   let out = ""
@@ -48,19 +49,19 @@ export function sliceByWidth(text, maxWidth) {
   return out
 }
 
-/** 按显示宽度右补空格 */
+/** Right-pad by display width */
 function padByWidth(text, width) {
   return text + " ".repeat(Math.max(0, width - stringWidth(text)))
 }
 
-// ---------------------------------------------------------------- markdown 表格重排
+// ---------------------------------------------------------------- markdown table reformatting
 
 const isTableRow = (line) => (line.match(/\|/g) ?? []).length >= 2
 const isTableSeparator = (line) => /^\s*\|?[\s:|-]+\|[\s:|-]*$/.test(line) && line.includes("-")
 
 /**
- * 识别文本中的 markdown 表格块，按显示宽度重排 (修 CJK 错位）。
- * width 为可用显示宽度；过宽的表格按列收缩。非表格行原样保留。
+ * Identify markdown table blocks in text, reformat by display width (fix CJK misalignment).
+ * width is the available display width; over-wide tables shrink columns. Non-table lines are kept as-is.
  */
 export function formatTables(text, width) {
   const lines = text.split("\n")
@@ -94,31 +95,31 @@ function renderTable(block, width) {
   const colCount = Math.max(...rows.map((r) => r.length))
   for (const r of rows) while (r.length < colCount) r.push("")
 
-  // 列宽：先按内容，超宽则从最宽列开始收缩 (收缩到至少 3）
+  // Column widths: content first; if too wide, shrink from widest column (down to at least 3)
   const widths = Array.from({ length: colCount }, (_, c) =>
     Math.max(3, ...rows.map((r) => stringWidth(r[c] ?? ""))),
   )
-  const borders = colCount * 3 + 1 // " │ " 分隔 + 首尾 |
+  const borders = colCount * 3 + 1 // " │ " separators + leading/trailing |
   while (widths.reduce((a, b) => a + b, 0) + borders > width && Math.max(...widths) > 3) {
     const widest = widths.indexOf(Math.max(...widths))
     widths[widest]--
   }
 
-  // 单元格渲染：sliceByWidth 截断 (表头单行），padByWidth 补齐
+  // Cell rendering: sliceByWidth truncates (single-line for header), padByWidth pads
   const fmtCell = (text, ci) => padByWidth(sliceByWidth(text, widths[ci]), widths[ci])
   const fmtRow = (cells) => "│ " + cells.map((c, i) => fmtCell(c, i)).join(" │ ") + " │"
 
-  // 分隔线
+  // separator line
   const separator = "├" + widths.map((w) => "─".repeat(w + 2)).join("┼") + "┤"
 
   const out = []
-  // 表头：单行截断 (表头通常是短标签，折行不如截断直观）
+  // Header: single-line truncation (header labels are usually short, truncation beats wrapping)
   out.push(fmtRow(rows[0]))
   out.push(separator)
 
-  // 数据行：过长单元格按列宽折行，一个逻辑行可能对应多条显示行
+  // Data rows: over-long cells wrap by column width; one logical row may produce multiple display lines
   for (let r = 2; r < rows.length; r++) {
-    // wrapText 返回按 width 折行后的行数组，保留内部 \n
+    // wrapText returns array of lines wrapped by width, preserving internal \n
     const wrapped = rows[r].map((cell, ci) => wrapText(cell, widths[ci]))
     const height = Math.max(...wrapped.map((lines) => lines.length))
     for (let lineIdx = 0; lineIdx < height; lineIdx++) {
@@ -129,7 +130,7 @@ function renderTable(block, width) {
   return out
 }
 
-/** 输入区布局：把输入缓冲折行，同时算出光标的 (行, 列) 位置 (显示宽度） */
+/** Input area layout: wrap input buffer into lines, also compute cursor (row, col) position (display width) */
 export function layoutInput(chars, cursor, width) {
   const PROMPT = "\u25b8 "
   const lines = []
@@ -147,8 +148,6 @@ export function layoutInput(chars, cursor, width) {
   }
   for (let i = 0; i <= chars.length; i++) {
     const ch = chars[i]
-    // 先处理 flush：宽字符可能触发换行，cursorCol 必须在 flush 之后取，
-    // 否则光标会停在上一行的末尾而非下一行的起始
     if (ch !== undefined && ch !== "\n") {
       const w = charWidth(ch.codePointAt(0))
       if (col + w > avail()) flush()
@@ -171,8 +170,10 @@ export function layoutInput(chars, cursor, width) {
 }
 
 /**
- * 显示净化：控制字符会破坏终端网格数学 (\r 回车覆盖、\t 宽度误判致整帧错位、ANSI/响铃冲屏）。
- * 只动显示层——模型看到的工具结果原文不变；session 里已存的脏 display 回放时也经此净化。
+ * Display sanitization: control characters can break terminal grid math (\r carriage return overwrite,
+ * \t width misjudgment causing entire frame misalignment, ANSI/bell screen floods).
+ * Display-layer only — raw tool results the model sees are unchanged; dirty displays already in session
+ * are also cleaned during replay.
  */
 const ANSI_SEQUENCE_RE = /\x1b\[[0-9;?]*[a-zA-Z]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b[()][0-9A-B]|\x1b[=>#][0-9]?/g
 export function sanitizeDisplay(s) {
@@ -185,7 +186,7 @@ export function sanitizeDisplay(s) {
     .replace(/\n+$/, "")
 }
 
-/** 文本按宽度折行 (保留 \n），返回行数组 */
+/** Wrap text by display width (preserving \n), returns array of lines */
 export function wrapText(text, width) {
   const lines = []
   for (const rawLine of text.split("\n")) {