thincoder 0.8.1 → 0.8.3

package/src/tui/agent-turn.mjs

@@ -3,8 +3,8 @@ import { saveSession } from "../session.mjs"
 import { sliceByWidth } from "./render.mjs"
 import { ansi, C } from "./ansi.mjs"
 
-/** 执行一轮 agent 对话（从 submit 或队列取出调用）。
- *  从 index.mjs 抽出：agent 循环 + 回调构建 + 错误处理 + 队列处理。
+/** Execute one agent conversation turn (triggered by submit or queue).
+ *  Extracted from index.mjs: agent loop + callback construction + error handling + queue processing.
  *  ctx: { agent, state, pushLine, pushLabel, render, scheduleRender,
  *         ensureAssistantLabel, askPermission, askQuestion,
  *         handleSlash, summarize } */
@@ -13,12 +13,12 @@ export async function runAgentTurn(ctx, text) {
   pushLabel(`❯ You:`, ansi.bold + C.user)
   pushLine(text, C.text)
 
-  // 任务开始前自动打存档点 (git 仓库内；失败静默，不挡任务）
+  // Auto-checkpoint before task (git repo only; failure is silent, doesn't block the task)
   try {
     const { createCheckpoint } = await import("../git/checkpoint.mjs")
     await createCheckpoint(agent.cwd)
   } catch {
-    // 存档失败不影响任务
+    // Checkpoint failure doesn't block the task
   }
 
   ctx.assistantLabeled = false
@@ -30,7 +30,7 @@ export async function runAgentTurn(ctx, text) {
   state.currentTool = null
   state.processingStarted = Date.now()
   state.controller = new AbortController()
-  // 处理中每秒刷新一次状态栏 (运行计时）
+  // Refresh status bar every second during processing (elapsed timer)
   const ticker = setInterval(() => {
     if (state.processing) render()
   }, 1000)
@@ -49,7 +49,7 @@ export async function runAgentTurn(ctx, text) {
 
   const callbacks = {
     onToken: (t) => {
-      // 子 agent 流式输出：前缀格式 role#id/ → 提取 id，更新对应 subTask 的流式文本
+      // Subagent streaming: prefix format role#id/ → extract id, update subTask streaming text
       const subMatch = t.match(/^(\w+)#(\d+)\//)
       if (subMatch) {
         const key = `${subMatch[1]}#${subMatch[2]}`
@@ -69,7 +69,7 @@ export async function runAgentTurn(ctx, text) {
       scheduleRender()
     },
     onReasoning: (t) => {
-      // 子 agent 的思考 token 同样带 role#id/ 前缀，进 subTasks 面板
+      // Subagent reasoning tokens also carry role#id/ prefix, go into subTasks panel
       const subMatch = t.match(/^(\w+)#(\d+)\//)
       if (subMatch) {
         const key = `${subMatch[1]}#${subMatch[2]}`
@@ -84,7 +84,7 @@ export async function runAgentTurn(ctx, text) {
       scheduleRender()
     },
     onToolCall: (name, args) => {
-      // 子 agent 工具调用：前缀 role#id/toolName → 更新对应 subTask 的当前工具
+      // Subagent tool call: prefix role#id/toolName → update subTask current tool
       const subMatch = name.match(/^(\w+)#(\d+)\//)
       if (subMatch) {
         const key = `${subMatch[1]}#${subMatch[2]}`
@@ -105,7 +105,7 @@ export async function runAgentTurn(ctx, text) {
     },
     onToolResult: (name, result) => {
       state.currentTool = null
-      // 子 agent 结束：标记最早创建的 running subTask 为 done
+      // Subagent complete: mark earliest running subTask as done
       const isSubagent = name === "subagent"
       if (isSubagent) {
         const running = Object.entries(state.subTasks)
@@ -116,12 +116,12 @@ export async function runAgentTurn(ctx, text) {
           state.subTasks[key].done = true
           state.subTasks[key].tool = null
         }
-        // 子 agent 报告摘要 (最多 8 行）直接展示在对话区
+        // Subagent report preview (max 8 lines) displayed directly in conversation
         const lines = result.split("\n")
         const preview = lines.slice(0, 8).map((l) => l.slice(0, 120)).join("\n")
         if (preview) pushLine(preview, C.dim)
         if (lines.length > 8) pushLine(`  ... (${lines.length - 8} more lines)`, C.dim)
-        // 3 秒后清除面板中 done 的条目
+        // Clear done entries from panel after 3 seconds
         setTimeout(() => {
           for (const key of Object.keys(state.subTasks)) {
             if (state.subTasks[key].done) delete state.subTasks[key]
@@ -130,22 +130,47 @@ export async function runAgentTurn(ctx, text) {
         }, 3000)
       }
       const stream = state.toolStreams[name]
-      if (stream) {
+      const panel = state.outputPanels[name]
+      if (panel) {
+        // Tool with output panel: mark panel as done, conversation gets only summary
+        panel.done = true
+        delete state.toolStreams[name]
+        const summary = formatPanelSummary(name, result)
+        if (summary) pushLine(`  ${summary}`, C.dim)
+        // Clear panel after 3 seconds
+        setTimeout(() => {
+          delete state.outputPanels[name]
+          if (state.processing) render()
+        }, 3000)
+      } else if (stream) {
         const tail = stream.trimEnd().slice(-4000)
         if (tail) pushLine(tail, C.dim)
         delete state.toolStreams[name]
       }
-      if (!isSubagent) {
+      if (!isSubagent && !panel) {
         const first = result.split("\n")[0]
         pushLine(`  [done] ${name} → ${sliceByWidth(first, 100)}`, C.dim)
       }
     },
     onToolOutput: (name, chunk) => {
-      state.toolStreams[name] = (state.toolStreams[name] ?? "") + chunk
+      // Route streaming output to a panel if one exists or was requested via outputPanel flag.
+      let panel = state.outputPanels[name]
+      if (!panel) {
+        // Lazy-create panel: defensive against race conditions where setupOutputPanel
+        // hasn't fired yet or the callbacks chain dropped it (subagent relay, reconnect, etc.)
+        state.outputPanels[name] = { text: "", done: false }
+        panel = state.outputPanels[name]
+      }
+      panel.text = (panel.text ?? "") + chunk
+      if (panel.text.length > 4000) panel.text = panel.text.slice(-4000)
       scheduleRender()
     },
     onPermissionRequest: (name, args) => askPermission(name, args),
     onQuestion: (text, options) => askQuestion(text, options),
+    setupOutputPanel: (name) => {
+      state.outputPanels[name] = { text: "", done: false }
+      scheduleRender()
+    },
     onCompress: () => {
       pushLine("  [context] Context too long, auto-compacted (early conversation summarized by LLM, task state preserved)", C.warn)
     },
@@ -155,7 +180,7 @@ export async function runAgentTurn(ctx, text) {
       state.tokens.cacheHit += usage.prompt_cache_hit_tokens ?? 0
       state.tokens.cacheMiss += usage.prompt_cache_miss_tokens ?? 0
     },
-    // 节流等待 (主动闸门 / 429 退避）：状态栏明示，防用户以为卡死
+    // Throttle wait (active gate / 429 backoff): show in status bar so user knows it's not frozen
     onWait: ({ phase, seconds }) => {
       state.status = phase === "gate" ? `TPM throttle wait ~${seconds}s` : `Rate-limited 429, retry in ${seconds}s`
       render()
@@ -163,12 +188,12 @@ export async function runAgentTurn(ctx, text) {
     onTaskUpdate: (items) => {
       state.tasks = items
       const done = items.filter((i) => i.status === "done").length
-      // 留痕带上current任务标题：回看历史时知道进行到哪一项
+      // Leave trace with current task title: reviewing history shows what was in progress
       const current = items.find((i) => i.status === "in_progress")
       pushLine(`  [task] ${done}/${items.length}${current ? ` ▶ ${current.title}` : ""}`, C.dim)
       render()
     },
-    // 增量保存：每 5 个工具 turn 落一次盘，中途崩溃丢失窗口从一整轮缩到几轮
+    // Incremental save: flush to disk every 5 tool turns — mid-crash loss window shrinks from an entire round to a few turns
     onTurnEnd: (() => {
       let n = 0
       return () => {
@@ -182,7 +207,7 @@ export async function runAgentTurn(ctx, text) {
     try {
       await runAgent(agent, text, callbacks, { signal: state.controller.signal, resume })
       flushStream()
-      break // 正常完成，退出循环
+      break // Normal completion, exit loop
     } catch (error) {
       flushStream()
       if (error.name === "AbortError" || state.controller?.signal.aborted) {
@@ -192,7 +217,7 @@ export async function runAgentTurn(ctx, text) {
       if (error instanceof ContinueError) {
         pushLabel(`❯ Continue`, ansi.bold + C.warn)
         pushLine(`Ran ${error.turn} turns (limit ${error.turn}). Continue?`, C.warn)
-        // 暂停询问：复用 permission 机制
+        // Pause to ask: reuse permission mechanism
         const willContinue = await new Promise((resolve) => {
           state.permission = {
             name: "continue",
@@ -208,7 +233,7 @@ export async function runAgentTurn(ctx, text) {
           break
         }
         pushLine("[continuing…]", C.tool)
-        // 重创新 AbortController：旧 signal 一旦 abort 过，resume 会立即失败 (防御性，current路径不可达但耦合紧）
+        // Recreate AbortController: once aborted, resume immediately fails (defensive; current path unreachable but tightly coupled)
         state.controller = new AbortController()
         continue
       }
@@ -222,26 +247,26 @@ export async function runAgentTurn(ctx, text) {
   state.subTasks = {}
   state.controller = null
   state.status = "Ready"
-  // 全部完成时自动收起 todo 面板 (对齐 kimi-code TUI；agent.tasks 本身保留）
+  // Auto-collapse todo panel when all tasks done (matching kimi-code TUI; agent.tasks are preserved)
   if (state.tasks.length > 0 && state.tasks.every((t) => t.status === "done")) {
     state.tasks = []
   }
-  // 每轮结束后保存会话 (崩溃也不丢）
+  // Save session after every turn (survives crashes)
   try {
     saveSession(agent, state.lines)
   } catch {
-    // 存失败不打断使用
+    // Save failure doesn't interrupt usage
   }
   render()
 
-  // 队列里有待执行消息：自动取下一条执行
+  // Queued messages: auto-process next one
   if (state.queue.length > 0) {
     const next = state.queue.shift()
-    // 队列里的斜杠命令直接执行
+    // Queued slash commands execute directly
     if (next.text.startsWith("/")) {
       await handleSlash(next.text)
       render()
-      // 斜杠命令执行完也继续检查队列
+      // After slash command completes, continue checking queue
       if (state.queue.length > 0 && !state.processing) {
         const next2 = state.queue.shift()
         await runAgentTurn(ctx, next2.text)
@@ -252,3 +277,34 @@ export async function runAgentTurn(ctx, text) {
     }
   }
 }
+
+/** Extract a one-line summary from a panel tool's output */
+function formatPanelSummary(name, result) {
+  if (name === "verify") return _verifySummary(result)
+  // Default: first non-empty line
+  const first = result.split("\n").find((l) => l.trim())
+  return first ? `${name}: ${first.slice(0, 100)}` : null
+}
+
+function _verifySummary(result) {
+  const lines = result.split("\n")
+  const summary = []
+  // Changed files count
+  const changed = lines.find((l) => l.startsWith("Changed files:"))
+  if (changed) {
+    const m = changed.match(/files changed/) ? changed.replace(/^Changed files \(.*?\)/, "Changed files") : changed
+    summary.push(m)
+  }
+  // Syntax check results
+  const syntax = lines.filter((l) => l.startsWith("  ✗"))
+  if (syntax.length > 0) {
+    summary.push(`${syntax.length} syntax error(s)`)
+  }
+  // Test results
+  const testLine = lines.find((l) => l.startsWith("✓ Tests passed.") || l.startsWith("✗ Tests FAILED"))
+  if (testLine) summary.push(testLine.trim())
+  // Task list
+  const taskLine = lines.find((l) => l.startsWith("Task list:"))
+  if (taskLine) summary.push(taskLine)
+  return summary.length > 0 ? `verify: ${summary.join(" — ")}` : ""
+}

package/src/tui/ansi.mjs

@@ -1,6 +1,6 @@
 /**
- * tui-ansi.mjs — ANSI 转义序列与终端颜色常量
- * 零依赖，纯常量导出。
+ * tui-ansi.mjs — ANSI escape sequences and terminal color constants.
+ * Zero dependencies, pure constant exports.
  */
 
 export const ESC = "\x1b"
@@ -11,6 +11,8 @@ export const ansi = {
   mainBuffer: `${ESC}[?1049l`,
   mouseOn: `${ESC}[?1000h${ESC}[?1006h`,
   mouseOff: `${ESC}[?1000l${ESC}[?1006l`,
+  bracketedPasteOn: `${ESC}[?2004h`,
+  bracketedPasteOff: `${ESC}[?2004l`,
   home: `${ESC}[H`,
   clearLine: `${ESC}[K`,
   reset: `${ESC}[0m`,

package/src/tui/clipboard.mjs

@@ -1,7 +1,7 @@
 import { C } from "./ansi.mjs"
 
-/** Ctrl+V / Alt+V：读取剪贴板图片 → 写入工作目录临时文件 → 输入框插入 read_image 命令。
- *  从 index.mjs 抽出。
+/** Ctrl+V / Alt+V: read clipboard image → write temp file in working directory → insert read_image command into input box.
+ *  Extracted from index.mjs.
  *  ctx: { agent, state, pushLine, render } */
 export async function pasteClipboardImage(ctx) {
   const { agent, state, pushLine, render } = ctx

package/src/tui/cmd-auto.mjs

@@ -1,6 +1,6 @@
 import { ansi, C } from "./ansi.mjs"
 
-/** /auto 命令：切换 auto-approve 模式。
+/** /auto command: toggle auto-approve mode.
  *  ctx: { agent, pushLine, pushLabel } */
 export async function handleAutoCommand(ctx) {
   const { agent, pushLine, pushLabel } = ctx

package/src/tui/cmd-clear.mjs

@@ -1,4 +1,4 @@
-/** /clear 命令：清屏（二次确认防误触）。
+/** /clear command: clear screen (confirm to prevent accidental trigger).
  *  ctx: { state, openPicker, render } */
 export async function handleClearCommand(ctx) {
   const { state, openPicker, render } = ctx

package/src/tui/cmd-config.mjs

@@ -1,8 +1,8 @@
 import { existsSync, readFileSync } from "node:fs"
 import { ansi, C } from "./ansi.mjs"
 
-/** /config 命令：设置 embedding key / 高级 path=value 配置。
- *  从 slash-commands.mjs 抽出。
+/** /config command: set embedding key / advanced path=value config.
+ *  Extracted from slash-commands.mjs.
  *  ctx: { agent, pushLine, pushLabel, openPicker, askQuestion, persistRaw, maskKey, ansi, C } */
 export async function handleConfigCommand(ctx) {
   const { agent, pushLine, pushLabel, openPicker, askQuestion, persistRaw, maskKey } = ctx

package/src/tui/cmd-exit.mjs

@@ -1,5 +1,5 @@
-/** /exit 命令：退出 TUI。
- *  ctx: { exit } — exit 是 index.mjs 注入的 cleanup + process.exit 回调 */
+/** /exit command: exit TUI.
+ *  ctx: { exit } — exit is the cleanup + process.exit callback injected by index.mjs */
 export async function handleExitCommand(ctx) {
   ctx.exit()
 }

package/src/tui/cmd-extract.mjs

@@ -1,4 +1,4 @@
-/** /extract 命令：从当前会话提取知识。
+/** /extract command: extract knowledge from current session.
  *  ctx: { runDistill } */
 export async function handleExtractCommand(ctx) {
   await ctx.runDistill()

package/src/tui/cmd-goal.mjs

@@ -1,7 +1,7 @@
 import { ansi, C } from "./ansi.mjs"
 
-/** /goal 命令：设置/查看/取消长期目标。
- *  从 slash-commands.mjs 抽出。
+/** /goal command: set/view/cancel long-term goal.
+ *  Extracted from slash-commands.mjs.
  *  ctx: { agent, pushLine, pushLabel, openPicker, askQuestion } */
 export async function handleGoalCommand(ctx) {
   const { agent, pushLine, pushLabel, openPicker, askQuestion } = ctx
@@ -31,7 +31,7 @@ export async function handleGoalCommand(ctx) {
         pushLine(`Goal cancelled.`, C.dim)
         return
       }
-      // set — 需要输入目标文本
+      // set — requires entering goal text
       const goalText = await askQuestion("Enter goal description (; separates criteria)")
       if (!goalText) return
       const semi = goalText.indexOf("；") >= 0 ? "；" : goalText.indexOf(";") >= 0 ? ";" : null
@@ -41,7 +41,7 @@ export async function handleGoalCommand(ctx) {
       pushLabel(`❯ Goal`, ansi.bold + C.warn)
       pushLine(`Goal set: ${objective}`, C.tool)
       if (criteria) pushLine(`  Criteria: ${criteria}`, C.dim)
-      else pushLine(`  ⚠ No criteria — agent will be asked to provide verifiable criteria when using goal set`, C.warn)
+      else pushLine(`  ⚠ No criteria provided — the agent will determine its own criteria as it works on this goal`, C.warn)
     },
   })
 }

package/src/tui/cmd-help.mjs

@@ -1,6 +1,6 @@
 import { ansi, C } from "./ansi.mjs"
 
-/** /help 命令：列出所有斜杠命令及别名。
+/** /help command: list all slash commands and aliases.
  *  ctx: { pushLine, pushLabel, SLASH_COMMANDS } */
 export async function handleHelpCommand(ctx) {
   const { pushLine, pushLabel, SLASH_COMMANDS } = ctx

package/src/tui/cmd-init.mjs

@@ -2,8 +2,8 @@ import { existsSync } from "node:fs"
 import { basename } from "node:path"
 import { ansi, C } from "./ansi.mjs"
 
-/** /init 命令：探测项目类型，生成 AGENTS.md 骨架。
- *  从 slash-commands.mjs 抽出。
+/** /init command: detect project type, generate AGENTS.md skeleton.
+ *  Extracted from slash-commands.mjs.
  *  ctx: { agent, pushLine, pushLabel } */
 export async function handleInitCommand(ctx) {
   const { agent, pushLine, pushLabel } = ctx
@@ -15,7 +15,7 @@ export async function handleInitCommand(ctx) {
     return
   }
 
-  // 探测项目类型与关键信息
+  // Detect project type and key information
   let name = basename(agent.cwd)
   let lang = "", cmds = ""
 

package/src/tui/cmd-mcp.mjs

@@ -1,7 +1,7 @@
 import { ansi, C } from "./ansi.mjs"
 
-/** /mcp 命令处理器：查看/添加/删除/重连 MCP server。
- *  从 slash-commands.mjs 抽出，含 /mcp 专用的 parseHeaders / addAndConnect helper。
+/** /mcp command handler: view/add/remove/reconnect MCP server.
+ *  Extracted from slash-commands.mjs, includes /mcp-specific parseHeaders / addAndConnect helpers.
  *  ctx: { agent, pushLine, pushLabel, openPicker, askQuestion, persistRaw, ansi, C } */
 
 function parseHeaders(pairs) {
@@ -13,7 +13,7 @@ function parseHeaders(pairs) {
   return headers
 }
 
-/** /mcp 共享 helper: 保存 Config + Connecting (persistRaw 从 ctx 获取) */
+/** /mcp shared helper: save config + connect (persistRaw obtained from ctx) */
 async function addAndConnect(ctx, srv) {
   const { agent, pushLine, pushLabel, persistRaw } = ctx
   await persistRaw((raw) => {
@@ -83,10 +83,10 @@ export async function handleMcpCommand(ctx) {
           title: "Remove MCP Server",
           entries: removeEntries,
           onSelect: async (se) => {
-            // 从配置删除
+            // Remove from config
             agent.config.mcp.servers = servers.filter((s) => s.name !== se.name)
             await persistRaw((raw) => { raw.mcp.servers = agent.config.mcp.servers })
-            // 从工具列表删除
+            // Remove from tool list
             const { removeMcpTools } = await import("../mcp.mjs")
             removeMcpTools(agent, se.name)
             pushLine(`[mcp] ${se.name} removed`, C.tool)

package/src/tui/cmd-model.mjs

@@ -1,6 +1,6 @@
 import { C } from "./ansi.mjs"
 
-/** /model 命令：打开模型选择器。
+/** /model command: open model picker.
  *  ctx: { openModelPicker, pushLine } */
 export async function handleModelCommand(ctx) {
   ctx.openModelPicker().catch((e) => ctx.pushLine(`[error] ${e.message}`, C.error))

package/src/tui/cmd-new.mjs

@@ -1,7 +1,7 @@
 import { clearSession } from "../session.mjs"
 import { C } from "./ansi.mjs"
 
-/** /new 命令：新建会话（旧会话归档到槽位）。
+/** /new command: start new session (old session archived to slot).
  *  ctx: { agent, state, pushLine } */
 export async function handleNewCommand(ctx) {
   const { agent, state, pushLine } = ctx

package/src/tui/cmd-plan.mjs

@@ -1,6 +1,6 @@
 import { ansi, C } from "./ansi.mjs"
 
-/** /plan 命令：切换 plan mode（只读探索 → 设计 → 实现）。
+/** /plan command: toggle plan mode (read-only explore → design → implement).
  *  ctx: { agent, pushLine, pushLabel } */
 export async function handlePlanCommand(ctx) {
   const { agent, pushLine, pushLabel } = ctx

package/src/tui/cmd-reindex.mjs

@@ -1,6 +1,6 @@
 import { C } from "./ansi.mjs"
 
-/** /reindex 命令：重建记忆索引（files + code_chunks + doc_chunks）。
+/** /reindex command: rebuild memory index (files + code_chunks + doc_chunks).
  *  ctx: { agent, distillOpts, pushLine } */
 export async function handleReindexCommand(ctx) {
   const { agent, distillOpts, pushLine } = ctx
@@ -20,7 +20,7 @@ export async function handleReindexCommand(ctx) {
     total += s.added
     pushLine(`  team: +${s.added} ~${s.updated} -${s.removed}`, C.dim)
   }
-  // 重建代码索引和文档索引并行（读写不同表，WAL 支持）
+  // Rebuild code index and doc index in parallel (read/write different tables, WAL supports)
   pushLine(`  [code+doc] Rebuilding indexes...`, C.tool)
   const [cr, dr] = await Promise.all([
     codeSync(agent.memory, agent.cwd, {

package/src/tui/cmd-restore.mjs

@@ -1,6 +1,6 @@
 import { ansi, C } from "./ansi.mjs"
 
-/** /restore 命令：列出 git checkpoint 并回滚到选中快照。
+/** /restore command: list git checkpoints and roll back to selected snapshot.
  *  ctx: { agent, openPicker, pushLine, pushLabel } */
 export async function handleRestoreCommand(ctx) {
   const { agent, openPicker, pushLine, pushLabel } = ctx

package/src/tui/cmd-session.mjs

@@ -1,7 +1,7 @@
 import { listSlots, switchToSlot, applySession } from "../session.mjs"
 import { ansi, C } from "./ansi.mjs"
 
-/** /session 命令：列出/切换归档会话槽位。
+/** /session command: list/switch archived session slots.
  *  ctx: { agent, state, openPicker, pushLine, pushLabel, render } */
 export async function handleSessionCommand(ctx) {
   const { agent, state, openPicker, pushLine, pushLabel, render } = ctx

package/src/tui/cmd-skills.mjs

@@ -1,6 +1,6 @@
 import { ansi, C } from "./ansi.mjs"
 
-/** /skills 命令：列出项目技能。
+/** /skills command: list project skills.
  *  ctx: { agent, pushLine, pushLabel } */
 export async function handleSkillsCommand(ctx) {
   const { agent, pushLine, pushLabel } = ctx

package/src/tui/cmd-think.mjs

@@ -1,7 +1,7 @@
 import { ansi, C } from "./ansi.mjs"
 
-/** /think 命令：切换思考模式、设置 reasoning effort。
- *  从 slash-commands.mjs 抽出。
+/** /think command: toggle thinking mode, set reasoning effort.
+ *  Extracted from slash-commands.mjs.
  *  ctx: { agent, pushLine, pushLabel, openPicker, syncProviderField } */
 export async function handleThinkCommand(ctx) {
   const { agent, pushLine, pushLabel, openPicker, syncProviderField } = ctx

package/src/tui/config-helpers.mjs

@@ -1,10 +1,10 @@
 import { existsSync, readFileSync } from "node:fs"
 
-/** persistRaw / syncProviderField / maskKey：配置读写辅助。
- *  从 index.mjs 抽出，供 slash-commands / wizard / pickers 共用。
- *  createConfigHelpers(agent) 返回 { persistRaw, syncProviderField, maskKey } */
+/** persistRaw / syncProviderField / maskKey: config read/write helpers.
+ *  Extracted from index.mjs for shared use by slash-commands, wizard, and pickers.
+ *  createConfigHelpers(agent) returns { persistRaw, syncProviderField, maskKey } */
 export function createConfigHelpers(agent) {
-  /** 读取 config.json → mutate → 落盘 */
+  /** Read config.json → mutate → persist to disk */
   async function persistRaw(mutate) {
     const { saveConfig, configPath } = await import("../config.mjs")
     const raw = existsSync(configPath) ? JSON.parse(readFileSync(configPath, "utf8")) : {}
@@ -12,7 +12,7 @@ export function createConfigHelpers(agent) {
     saveConfig(raw)
   }
 
-  /** 同步当前 provider 的某个字段到 providers 数组并落盘 */
+  /** Sync a field of the current provider to the providers array and persist to disk */
   async function syncProviderField(field, value) {
     const target = agent.providers.find((p) => p.name === agent.activeProvider)
     if (!target) return
@@ -23,7 +23,7 @@ export function createConfigHelpers(agent) {
     })
   }
 
-  /** API key 脱敏显示 */
+  /** Mask API key for display */
   function maskKey(key) {
     if (!key) return "(none)"
     if (key.length <= 8) return "***"

package/src/tui/distill-cmd.mjs

@@ -1,7 +1,7 @@
 import { C } from "./ansi.mjs"
 
-/** /distill 命令：从当前会话提取候选，逐条 y/n 确认后入库。
- *  从 index.mjs 抽出。
+/** /distill command: extract candidates from current session, confirm each y/n, then save to memory.
+ *  Extracted from index.mjs.
  *  ctx: { agent, state, pushLine, render, askPermission, distillOpts } */
 export async function runDistill(ctx) {
   const { agent, state, pushLine, render, askPermission, distillOpts } = ctx
@@ -24,7 +24,7 @@ export async function runDistill(ctx) {
     for (const c of candidates) {
       pushLine(`── Candidate [${c.type}] ${c.title} (scope: ${c.scope ?? "personal"})`, C.warn)
       for (const line of c.content.split("\n").slice(0, 6)) pushLine(`   ${line}`, C.dim)
-      if (c.type === "rule") pushLine("   (rule  type — consider writing manually; press y to extract)", C.warn)
+      if (c.type === "rule") pushLine("   (rule type — consider writing manually; press y to extract)", C.warn)
       const accept = await askPermission("distill-save", { title: c.title })
       if (!accept) {
         pushLine("   skipped", C.dim)