thincoder 0.8.2 → 0.8.4

package/src/tui/slash-commands.mjs

@@ -1,8 +1,8 @@
 /**
- * slash-commands.mjs — 斜杠命令定义、分发、Tab 补全。
- * 每个子命令的具体实现都在独立的 cmd-*.mjs 中，本文件只做 dispatch。
+ * slash-commands.mjs — slash command definitions, dispatch, Tab completion.
+ * Each subcommand's implementation lives in its own cmd-*.mjs file; this file only does dispatch.
  *
- * ctx 对象由 index.mjs 注入，透传给各 handler：
+ * ctx object is injected by index.mjs and forwarded to each handler:
  *   { agent, state, distillOpts, pushLine, pushLabel, render,
  *     openPicker, openModelPicker, setProviderKey, runDistill,
  *     persistRaw, syncProviderField, maskKey, exit, SLASH_COMMANDS }
@@ -33,21 +33,21 @@ export const SLASH_COMMANDS = [
   { name: "/model", group: "Agent", desc: "select model & manage providers" },
   { name: "/goal", group: "Agent", desc: "set/view/cancel long-term goal" },
   { name: "/think", group: "Agent", desc: "thinking mode & reasoning effort" },
-  { name: "/init", group: "Tools", desc: "generate project AGENTS.md skeleton" },
-  { name: "/skills", group: "Tools", desc: "list project skills" },
-  { name: "/mcp", group: "Tools", desc: "manage MCP servers" },
-  { name: "/config", group: "Config", desc: "config management (embedding / agent)" },
-  { name: "/reindex", group: "Config", desc: "rebuild memory index" },
+  { name: "/config", group: "Agent", desc: "config management (embedding / agent)" },
   { name: "/new", group: "Session", desc: "new session (old one archived to slot)" },
   { name: "/session", group: "Session", desc: "list/switch archived sessions" },
   { name: "/clear", group: "Session", desc: "clear screen" },
   { name: "/extract", group: "Session", desc: "extract knowledge from session" },
-  { name: "/restore", group: "Session", desc: "restore checkpoint" },
-  { name: "/exit", group: "Session", desc: "exit" },
-  { name: "/help", group: "", desc: "this list" },
+  { name: "/init", group: "Project", desc: "generate project AGENTS.md skeleton" },
+  { name: "/skills", group: "Project", desc: "list project skills" },
+  { name: "/mcp", group: "Project", desc: "manage MCP servers" },
+  { name: "/reindex", group: "Project", desc: "rebuild memory index" },
+  { name: "/restore", group: "Project", desc: "restore checkpoint" },
+  { name: "/exit", group: "System", desc: "exit" },
+  { name: "/help", group: "System", desc: "this list" },
 ]
 
-/** 命令 → handler 映射表 */
+/** Command → handler mapping table */
 const HANDLERS = {
   "/clear": handleClearCommand,
   "/new": handleNewCommand,
@@ -69,17 +69,17 @@ const HANDLERS = {
 }
 
 /**
- * 创建斜杠命令处理器。
- * 返回 { handleSlash, completions, handleTab }。
+ * Creates the slash command processor.
+ * Returns { handleSlash, completions, handleTab }.
  */
 export function createSlashCommands(ctx) {
   const { agent, state, render } = ctx
-  // 给 /help 传 SLASH_COMMANDS
+  // forward SLASH_COMMANDS to /help
   const handlerCtx = { ...ctx, SLASH_COMMANDS }
 
   async function handleSlash(text) {
     const [cmd] = text.split(/\s+/)
-    // 高频命令缩写
+    // high-frequency command aliases
     const aliases = { "/h": "/help", "/x": "/exit", "/m": "/model", "/p": "/plan", "/t": "/think", "/c": "/clear", "/n": "/new" }
     const resolved = aliases[cmd] ?? cmd
     const handler = HANDLERS[resolved]
@@ -90,18 +90,18 @@ export function createSlashCommands(ctx) {
     ctx.pushLine(`Unknown command: ${cmd} (/help for available commands)`, C.error)
   }
 
-  /** Tab 补全候选：Commands 名 / 子 Commands / provider 名 / 预设名 / think 参数 */
+  /** Tab completion candidates: command names / subcommands / provider names / preset names / think params */
   function completions(input) {
     if (!input.startsWith("/")) return []
     const parts = input.split(/\s+/)
-    // 还在敲第一个 token：补 Commands 名
+    // still typing the first token: complete command names
     if (parts.length === 1) {
       return SLASH_COMMANDS.filter((c) => c.name.startsWith(parts[0])).map((c) => c.name)
     }
     const cmd = parts[0]
-    const last = parts.at(-1) // 结尾是空格时，列出全部候选
+    const last = parts.at(-1) // when trailing space, list all candidates
     const head = parts.slice(0, -1).join(" ")
-    const argIndex = parts.length - 2 // 正在敲第几个参数 (0 基）
+    const argIndex = parts.length - 2 // which parameter is being typed (0-based)
     const match = (cands) => cands.filter((c) => c.startsWith(last)).map((c) => `${head} ${c}`)
     if (cmd === "/model" && argIndex === 0) return match(agent.providers.map((p) => p.name))
     if (cmd === "/think") {
@@ -117,11 +117,11 @@ export function createSlashCommands(ctx) {
     return []
   }
 
-  /** Tab：计算候选并循环替换输入 */
+  /** Tab: compute candidates and cycle through replacement */
   function handleTab() {
     const input = state.input.join("")
     if (state.completion && input === state.completion.candidates[state.completion.index]) {
-      // 上一次的候选还在输入框：循环到下一个
+      // previous candidate still in input box: cycle to next
       state.completion.index = (state.completion.index + 1) % state.completion.candidates.length
     } else {
       const candidates = completions(input)

package/src/tui/startup.mjs

@@ -2,13 +2,13 @@ import { listSlots } from "../session.mjs"
 import { sliceByWidth } from "./render.mjs"
 import { ansi, C } from "./ansi.mjs"
 
-/** 启动画面 + 会话恢复 + 后台索引。
- *  从 index.mjs 抽出。
+/** Startup screen + session recovery + background indexing.
+ *  Extracted from index.mjs.
  *  ctx: { agent, state, opts, pushLine, pushLabel, render, startWizard } */
 export function showStartup(ctx) {
   const { agent, state, opts, pushLine, pushLabel, render, startWizard } = ctx
 
-  // 启动画面
+  // Startup screen
   if (!agent.provider.apiKey) {
     pushLabel(`Welcome to ThinCoder!`, ansi.bold + C.tool)
     pushLine("No API key configured yet — entering initial setup (Esc to skip anytime)", C.text)
@@ -18,13 +18,14 @@ export function showStartup(ctx) {
   }
   pushLine(`Tools: ${agent.tools.map((t) => t.name).join(", ")}`, C.dim)
 
-  // 恢复上次会话：重建对话区显示 (tool 结果行省略，保持清爽）
+  // Recover previous session: rebuild conversation display (tool result lines omitted, keep it clean)
   if (opts.restored?.display?.length) {
-    // 用户视角的恢复：display 是退出前对话区的原样快照，所见即所得
+    // User-facing recovery: display is a WYSIWYG snapshot of the conversation before exit
     state.lines = [...opts.restored.display.map((l) => ({ text: l.text, color: l.color })), ...state.lines]
-    pushLabel(`── Restored previous session; /new for a fresh session ──`, C.warn)
+    const recoveryNote = opts.restored._recovered ? " (recovered from backup)" : ""
+    pushLabel(`── Restored previous session${recoveryNote}; /new for a fresh session ──`, C.warn)
   } else if (opts.restored?.history?.length) {
-    // 重建对话区：user/assistant 消息逐条展示，tool 结果行只保留首行摘要
+    // Rebuild conversation: user/assistant messages shown one by one, tool result lines show only first-line summary
     for (let i = 0; i < opts.restored.history.length; i++) {
       const m = opts.restored.history[i]
       if (m.role === "user") {
@@ -35,27 +36,27 @@ export function showStartup(ctx) {
         pushLabel(`❯ ThinCoder:`, ansi.bold + C.assistant)
         if (typeof m.content === "string" && m.content) pushLine(m.content, C.text)
         for (const tc of m.tool_calls ?? []) {
-          // 找到下一条对应的 tool 结果，显示首行摘要
+          // Find the next corresponding tool result, show first-line summary
           const toolResult = opts.restored.history[i + 1]
           const hasResult = toolResult?.role === "tool" && toolResult?.tool_call_id === tc.id
           const summary = hasResult ? " → " + sliceByWidth(String(toolResult.content).split("\n")[0], 80) : ""
           pushLine(`  [tool] ${tc.function?.name ?? "?"}${summary}`, C.tool)
         }
       }
-      // tool 消息本身不单独渲染——已在 assistant 的 tool_calls 后以摘要形式展示
+      // Tool messages aren't rendered separately — already shown as summary after assistant's tool_calls
     }
     pushLabel(`── Restored previous session (${opts.restored.history.length} messages); /new for a fresh session ──`, C.warn)
   }
 
-  // 有归档槽位时给个提示
+  // Hint when archived slots exist
   if (listSlots(agent.cwd).length > 0) {
     pushLine("Tip: archived sessions available — /session to view/switch", C.dim)
   }
   render()
 }
 
-/** 后台索引 (进界面后再跑，不阻塞启动）；进度走底部状态栏，不往对话区塞行。
- *  优先用 git diff 增量（快），git 不可用或首次运行时退到全量扫描。 */
+/** Background indexing (runs after startup screen, non-blocking); progress shown in status bar, not conversation.
+ *   Prefers git diff incremental (fast); falls back to full scan when git is unavailable or on first run. */
 export async function backgroundIndex(ctx) {
   const { agent, state, render } = ctx
   const { codeSync, docSync, gitSync } = await import("../memory.mjs")
@@ -75,11 +76,11 @@ export async function backgroundIndex(ctx) {
   })
 
   if (gitRes !== null) {
-    // git 增量成功，直接统计
+    // Git incremental succeeded, count directly
     codeFiles = agent.memory.db.prepare(`SELECT COUNT(DISTINCT path) AS n FROM code_chunks`).get()?.n ?? 0
     docFiles = agent.memory.db.prepare(`SELECT COUNT(DISTINCT path) AS n FROM doc_chunks`).get()?.n ?? 0
   } else {
-    // 退到全量扫描（codeSync 和 docSync 并行——读写不同表，SQLite WAL 天然支持）
+    // Fall back to full scan (codeSync and docSync in parallel — read/write different tables, SQLite WAL supports this natively)
     const [codeRes, docRes] = await Promise.allSettled([
       codeSync(agent.memory, cwd, {
         onProgress: (p) => {

package/src/tui/wizard.mjs

@@ -1,7 +1,7 @@
 /**
- * wizard.mjs — 首次启动 Config 向导
- * 从 index.mjs 抽出：provider 选择 → 逐项输入 (name/baseURL/model/key/embedkey) → 持久化 → 接模型选择器。
- * 通过 ctx 对象访问 startTUI 闭包中的共享状态与 UI 函数。
+ * wizard.mjs — first-launch config wizard
+ * Extracted from index.mjs: provider select → step-by-step input (name/baseURL/model/key/embedkey) → persist → then model picker.
+ * Accesses shared state and UI functions from the startTUI closure via ctx object.
  * ctx: { agent, state, pushLine, pushLabel, render, persistRaw, openModelPicker }
  */
 
@@ -9,13 +9,13 @@ import { PROVIDER_PRESETS as PRESETS } from "../config.mjs"
 import { ansi, C } from "./ansi.mjs"
 
 /**
- * 创建向导控制器。
- * 返回 { startWizard, renderWizard, wizardChooseProvider, wizardSubmitText, cancelWizard, finishWizard }
+ * Creates the wizard controller.
+ * Returns { startWizard, renderWizard, wizardChooseProvider, wizardSubmitText, cancelWizard, finishWizard }
  */
 export function createWizard(ctx) {
   const { agent, state, pushLine, pushLabel, render, persistRaw } = ctx
 
-  /** 菜单步的候选项：已有 provider (no key 的标注）+ 未添加的预设 + 自定义 */
+  /** Candidates for the menu step: existing providers (marked "no key" if missing), unadded presets, custom */
   function wizardProviderItems() {
     const items = []
     for (const p of agent.providers) {
@@ -30,7 +30,7 @@ export function createWizard(ctx) {
     return items
   }
 
-  /** 文本步骤定义：提示语 + 校验 (通过返回 true，否则返回错误文案） */
+  /** Text step definitions: prompt + validation (returns true if valid, otherwise error message) */
   const WIZARD_STEPS = {
     name: {
       prompt: "Name this provider (alphanumeric/-/_ e.g. my-openai)",
@@ -51,7 +51,7 @@ export function createWizard(ctx) {
     },
     embedkey: {
       prompt: "Optional: embedding API key (SiliconFlow, for memory vector search; press Enter to skip)",
-      validate: () => true, // 可跳过
+      validate: () => true, // skippable
     },
   }
   const WIZARD_NEXT = { name: "baseURL", baseURL: "model", model: "key", key: "embedkey", embedkey: null }
@@ -123,11 +123,11 @@ export function createWizard(ctx) {
 
   function cancelWizard() {
     state.wizard = null
-    pushLine("Skipped initial setup. Add a provider anytime via /provider add, set its key via /provider key.", C.dim)
+    pushLine("Skipped initial setup. Use /model to add providers and configure API keys anytime.", C.dim)
     render()
   }
 
-  /** 向导完成：写入 provider (有则更新）、设为激活、持久化，然后接模型选择器 */
+  /** Wizard complete: write provider (update if exists), set active, persist, then open model picker */
   async function finishWizard() {
     const f = state.wizard.fields
     state.wizard = null
@@ -147,7 +147,7 @@ export function createWizard(ctx) {
     agent.config.activeProvider = f.name
     pushLabel(`❯ Setup`, ansi.bold + C.tool)
     pushLine(`Setup complete: ${f.name} / ${f.model} (saved to config)`, C.tool)
-    // embedding key：配了就启用向量检索，没配提示事后通道
+    // embedding key: if provided, enable vector search; if not, show how to enable later
     if (f.embedkey) {
       agent.config.embedding ??= {}
       agent.config.embedding.apiKey = f.embedkey

package/src/tui.mjs

@@ -1,5 +1,5 @@
 /**
- * tui.mjs — 终端 UI（重新导出中心）
- * 子模块在 src/tui/ 目录下。
+ * tui.mjs — Terminal UI (re-export hub).
+ * Submodules under src/tui/ directory.
  */
 export { startTUI } from "./tui/index.mjs"

package/bin/thincoder.js

@@ -1,4 +0,0 @@
-#!/usr/bin/env node
-// Thin shim — npm's "bin" field doesn't accept .mjs entries.
-// Delegates to the real entry point.
-import "./thincoder.mjs"

package/src/tools/bash.mjs

@@ -1,144 +0,0 @@
-import {
-  DESC,
-  sanitizeOutput,
-  truncate,
-  makeDecoder,
-  BASH_TIMEOUT_MS,
-  hasFileRedirection,
-  shellSegments,
-  isDestructiveGitSegment,
-  isDestructiveCommand,
-  insideGitRepo,
-} from "./shared.mjs"
-import { spawn, execFileSync } from "node:child_process"
-
-/** 子进程环境变量白名单：只透传安全变量，隔离 API key 等敏感信息 */
-const SAFE_ENV_KEYS = new Set([
-  "PATH", "HOME", "USERPROFILE", "APPDATA", "LOCALAPPDATA",
-  "TEMP", "TMP", "TMPDIR", "LANG", "LC_ALL", "LC_CTYPE", "SHELL",
-  "ComSpec", "PATHEXT", "SystemRoot", "windir",
-  "NUMBER_OF_PROCESSORS", "PROCESSOR_ARCHITECTURE", "OS",
-  "PYTHONIOENCODING", "GIT_EDITOR", "EDITOR", "VISUAL",
-  "GIT_PAGER", "PAGER", "TERM",
-])
-
-export const bashTool = {
-  name: "bash",
-  description: DESC("bash"),
-  parameters: {
-    type: "object",
-    properties: {
-      command: { type: "string", description: "Shell command to execute" },
-      timeout: { type: "number", description: `Timeout in ms (default ${BASH_TIMEOUT_MS})` },
-    },
-    required: ["command"],
-  },
-  readonly: false,
-  async execute(args, ctx) {
-    // 安全预检：禁止 shell 重定向（> >> <）——应改用 write/edit/insert_after 工具
-    if (hasFileRedirection(args.command)) {
-      throw new Error("File redirection via bash is not allowed — use the write/edit/insert_after tools instead")
-    }
-    // 安全预检：破坏性非 git 命令（rm -rf / DROP TABLE 等）直接拒绝
-    if (shellSegments(args.command).some(isDestructiveCommand)) {
-      throw new Error("Destructive command blocked — use specific tools or confirm with the user first")
-    }
-    // 安全预检：销毁性 git 操作先检查未提交改动，有则拒绝——防一键清掉几小时工作
-    if (shellSegments(args.command).some(isDestructiveGitSegment)) {
-      if (!insideGitRepo(ctx.cwd)) {
-        throw new Error(`Refusing destructive git command: not a git repository: ${ctx.cwd}`)
-      }
-      const status = execFileSync("git", ["status", "--porcelain"], {
-        cwd: ctx.cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"],
-      }).trim()
-      if (status) {
-        throw new Error(
-          `Refusing destructive git command: uncommitted changes exist. Commit or stash first.\n` +
-          `(If uncommitted work was already lost, the checkpoint tool can restore the auto-snapshot: action=list, then action=rewind.)\n\n${status}`
-        )
-      }
-    }
-
-    return new Promise((resolve) => {
-      // detached: 让子进程成为进程组组长，超时/中断时才能整树杀掉（POSIX 用负 pid 组杀，
-      // Windows 用 taskkill /T）——只 kill 壳进程会把孙进程（如 npm test）留在后台继续跑
-      const killTree = () => {
-        if (process.platform === "win32") {
-          try { execFileSync("taskkill", ["/PID", String(child.pid), "/T", "/F"], { stdio: "ignore" }) } catch {}
-        } else {
-          try { process.kill(-child.pid, "SIGKILL") } catch {}
-          try { child.kill("SIGKILL") } catch {} // 组杀失败时兜底杀本体
-        }
-      }
-      // Windows 中文系统默认代码页是 GBK (CP936)，cmd.exe 重定向写文件时用 ANSI 代码页，
-      // chcp 65001 也改不了重定向的编码。bash 工具写含 CJK 的文件会产生 GBK——
-      // 提示词层已禁止用 bash 写文件（用 write/edit 工具替代），这里设 PYTHONIOENCODING
-      // 覆盖 Python 脚本的 stdout 编码（Python 是唯一可能正确响应环境变量的子进程）
-      const winCmd = process.platform === "win32"
-      const child = spawn(args.command, {
-        cwd: ctx.cwd,
-        shell: true,
-        windowsHide: true,
-        detached: process.platform !== "win32",
-        stdio: ["ignore", "pipe", "pipe"],
-        env: {
-          ...Object.fromEntries(
-            Object.entries(process.env).filter(([k]) => SAFE_ENV_KEYS.has(k))
-          ),
-          GIT_EDITOR: "true",
-          EDITOR: "true",
-          VISUAL: "true",
-          GIT_PAGER: "cat",
-          PAGER: "cat",
-          TERM: "dumb",
-          ...(winCmd ? { PYTHONIOENCODING: "utf-8" } : {}),
-        },
-      })
-      // stdout / stderr 各自独立解码（同进程通常同编码，但分开收集更干净，
-      // 且允许模型按 stderr 快速定位错误）
-      const outDecoder = makeDecoder()
-      const errDecoder = makeDecoder()
-      let outBuf = ""
-      let errBuf = ""
-      let truncatedNote = ""
-
-      const onStdout = (d) => {
-        const s = sanitizeOutput(outDecoder(d))
-        if (s) {
-          ctx.onOutput?.(s)
-          if (outBuf.length < 2_000_000) outBuf += s
-          else if (!truncatedNote) truncatedNote = "\n[... output exceeded 2MB, remainder discarded]"
-        }
-      }
-      const onStderr = (d) => {
-        const s = sanitizeOutput(errDecoder(d)) // 始终解码，防 pending 无限累积
-        if (errBuf.length < 2_000_000) errBuf += s
-      }
-
-      child.stdout.on("data", onStdout)
-      child.stderr.on("data", onStderr)
-
-      const timer = setTimeout(killTree, args.timeout ?? BASH_TIMEOUT_MS)
-      if (ctx.signal) {
-        ctx.signal.addEventListener("abort", killTree, { once: true })
-      }
-      child.on("error", (error) => {
-        clearTimeout(timer)
-        resolve(truncate(`Command failed: ${error.message}\n[stdout]:\n${outBuf || "(empty)"}`))
-      })
-      child.on("close", (code, signal) => {
-        clearTimeout(timer)
-        // 冲刷解码器尾部
-        outBuf += sanitizeOutput(outDecoder(Buffer.alloc(0), true))
-        errBuf += sanitizeOutput(errDecoder(Buffer.alloc(0), true))
-        const status = signal
-          ? `killed: ${ctx.signal?.aborted ? "user interrupted" : "timeout"}`
-          : `exit code ${code}`
-        const parts = [`[stdout]:\n${outBuf.trim() || "(empty)"}`]
-        if (errBuf.trim()) parts.push(`[stderr]:\n${errBuf.trim()}`)
-        parts.push(`(${status})`)
-        resolve(truncate(parts.join("\n\n") + truncatedNote))
-      })
-    })
-  },
-}

package/src/tools/glob.mjs

@@ -1,51 +0,0 @@
-import { DESC, truncate, resolveInCwd, globToRegex, IGNORED_DIRS } from "./shared.mjs"
-import { readdir } from "node:fs/promises"
-import { join } from "node:path"
-
-export const globTool = {
-  name: "glob",
-  description: DESC("glob"),
-  parameters: {
-    type: "object",
-    properties: {
-      pattern: { type: "string", description: "Glob pattern" },
-      path: { type: "string", description: "Directory to search in (default cwd)" },
-    },
-    required: ["pattern"],
-  },
-  readonly: true,
-  async execute(args, ctx) {
-    const base = resolveInCwd(ctx, args.path ?? ".")
-    const regex = globToRegex(args.pattern)
-    const results = []
-    for await (const relPath of walkFiles(base)) {
-      if (regex.test(relPath)) {
-        results.push(relPath)
-        if (results.length >= 1000) break
-      }
-    }
-    if (results.length === 0) return "(no matches)"
-    return truncate(results.sort().join("\n"))
-  },
-}
-
-// ---------------------------------------------------------- 内部实现
-
-/** 递归遍历文件，产出相对路径（跳过 IGNORED_DIRS） */
-async function* walkFiles(dir, rel = "") {
-  let entries
-  try {
-    entries = await readdir(dir, { withFileTypes: true })
-  } catch {
-    return
-  }
-  for (const e of entries) {
-    if (e.isDirectory() && IGNORED_DIRS.has(e.name)) continue
-    const relPath = rel ? `${rel}/${e.name}` : e.name
-    if (e.isDirectory()) {
-      yield* walkFiles(join(dir, e.name), relPath)
-    } else {
-      yield relPath
-    }
-  }
-}

package/src/tools/grep.mjs

@@ -1,100 +0,0 @@
-import { DESC, truncate, resolveInCwd, globToRegex, IGNORED_DIRS } from "./shared.mjs"
-import { readFile, readdir } from "node:fs/promises"
-import { stat, lstat } from "node:fs/promises"
-import { join } from "node:path"
-
-export const grepTool = {
-  name: "grep",
-  description: DESC("grep"),
-  parameters: {
-    type: "object",
-    properties: {
-      pattern: { type: "string", description: "Regular expression" },
-      path: { type: "string", description: "Directory or file to search (default cwd)" },
-      glob: { type: "string", description: "Only search files matching this glob (e.g. '*.mjs')" },
-      before: { type: "integer", description: "Lines of context to show before each match (grep -B). Default 0" },
-      after: { type: "integer", description: "Lines of context to show after each match (grep -A). Default 0" },
-    },
-    required: ["pattern"],
-  },
-  readonly: true,
-  async execute(args, ctx) {
-    const base = resolveInCwd(ctx, args.path ?? ".")
-    const regex = new RegExp(args.pattern)
-    const fileFilter = args.glob ? globToRegex(args.glob) : null
-    const before = Math.max(0, Math.floor(args.before ?? 0))
-    const after = Math.max(0, Math.floor(args.after ?? 0))
-    const wantCtx = before > 0 || after > 0
-    const hits = [] // { file, line(1-based), text }
-    const fileLines = new Map() // file -> string[]（仅 wantCtx 时缓存）
-
-    async function search(file) {
-      let content
-      try {
-        // 大文件保护：超 10MB 跳过，防 OOM
-        const fst = await stat(file)
-        if (fst.size > 10_000_000) return
-        content = await readFile(file, "utf8")
-      } catch {
-        return // 不可读文件跳过；二进制会被按 utf8 读入并照常搜索（可能产生乱码匹配）
-      }
-      const lines = content.split("\n")
-      if (wantCtx) fileLines.set(file, lines)
-      for (let i = 0; i < lines.length; i++) {
-        if (regex.test(lines[i])) {
-          hits.push({ file, line: i + 1, text: lines[i] })
-          if (hits.length >= 200) return
-        }
-      }
-    }
-
-    async function walk(target) {
-      if (hits.length >= 200) return
-      // 用 lstat 不跟随符号链接——防 ./evil → /etc 时 grep 读遍 /etc
-      let s
-      try { s = await lstat(target) } catch { return }
-      if (!s.isDirectory()) {
-        if (!fileFilter || fileFilter.test(target.split(/[\\/]/).pop())) await search(target)
-        return
-      }
-      let entries
-      try {
-        entries = await readdir(target, { withFileTypes: true })
-      } catch {
-        return
-      }
-      for (const e of entries) {
-        if (e.isDirectory() && IGNORED_DIRS.has(e.name)) continue
-        await walk(join(target, e.name))
-      }
-    }
-
-    await walk(base)
-    if (hits.length === 0) return "(no matches)"
-
-    // 无上下文：保持原 path:line: content 格式
-    if (!wantCtx) {
-      return truncate(hits.map((h) => `${h.file}:${h.line}: ${h.text}`).join("\n"))
-    }
-
-    // 带上下文：匹配行用 ':'，上下文行用 '-'（同 ripgrep）；同文件相邻区间去重合并
-    const fileMatched = new Map() // file -> Set<line>
-    for (const h of hits) {
-      if (!fileMatched.has(h.file)) fileMatched.set(h.file, new Set())
-      fileMatched.get(h.file).add(h.line)
-    }
-    const out = []
-    for (const [file, matchedLines] of fileMatched) {
-      const lines = fileLines.get(file) ?? []
-      const lineSet = new Set()
-      for (const ml of matchedLines) {
-        for (let l = Math.max(1, ml - before); l <= Math.min(lines.length, ml + after); l++) lineSet.add(l)
-      }
-      for (const l of [...lineSet].sort((a, b) => a - b)) {
-        const sep = matchedLines.has(l) ? ":" : "-"
-        out.push(`${file}${sep}${l}${sep} ${lines[l - 1]}`)
-      }
-    }
-    return truncate(out.join("\n"))
-  },
-}

package/src/tools/ls.mjs

@@ -1,36 +0,0 @@
-import { DESC, truncate, resolveInCwd } from "./shared.mjs"
-import { readdir } from "node:fs/promises"
-import { stat } from "node:fs/promises"
-import { join } from "node:path"
-
-export const lsTool = {
-  name: "ls",
-  description: DESC("ls"),
-  parameters: {
-    type: "object",
-    properties: {
-      path: { type: "string", description: "Directory path (default cwd)" },
-    },
-  },
-  readonly: true,
-  async execute(args, ctx) {
-    const abs = resolveInCwd(ctx, args.path ?? ".")
-    const entries = await readdir(abs, { withFileTypes: true })
-    const rows = await Promise.all(
-      entries.slice(0, 500).map(async (e) => {
-        const s = await stat(join(abs, e.name)).catch(() => null)
-        const isDir = e.isDirectory()
-        return {
-          dir: isDir,
-          name: e.name + (isDir ? "/" : ""),
-          size: s?.size ?? 0,
-          mtime: s ? s.mtime.toISOString().slice(0, 16).replace("T", " ") : "?",
-        }
-      }),
-    )
-    rows.sort((a, b) => (a.dir === b.dir ? a.name.localeCompare(b.name) : a.dir ? -1 : 1))
-    if (rows.length === 0) return "(empty directory)"
-    const out = rows.map((r) => `${r.dir ? "d" : "-"}  ${r.name.padEnd(40)} ${String(r.size).padStart(10)}  ${r.mtime}`)
-    return truncate(out.join("\n"))
-  },
-}

package/src/tools.mjs

@@ -1,2 +0,0 @@
-// Stub — see src/tools/index.mjs for actual implementation
-export * from "./tools/index.mjs"

package/src/tui-render.mjs

@@ -1,4 +0,0 @@
-/**
- * tui-render.mjs — 终端显示工具（重新导出）
- */
-export { charWidth, stringWidth, sliceByWidth, formatTables, layoutInput, sanitizeDisplay, wrapText } from "./tui/render.mjs"