@noobdemon/noob-cli 1.4.0 → 1.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noobdemon/noob-cli",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "publishConfig": {
     "access": "public"
   },

package/src/agent.js

@@ -23,7 +23,9 @@ Available tools:
 - list_dir    {"path"?: str}                                  — list a directory
 - glob        {"pattern": str}                                — find files by glob (supports ** and *)
 - grep        {"pattern": str, "path"?: str, "glob"?: str}    — regex search file contents
-- run_command {"command": str}                                — run a shell command in the cwd
+- run_command {"command": str, "timeout"?: int, "background"?: bool} — run a shell command in the cwd. A foreground command is killed after ~60s (override with "timeout" ms). For anything long-running or that never exits on its own — dev servers, watchers, \`python -m http.server\`, \`npm run dev\`, \`flask run\` — set "background": true: it starts the process, returns immediately, and keeps running WITHOUT blocking the next steps. Never start a server in the foreground (it will hang then be killed).
+- bg_output  {"id"?: int}                                     — no id: list background processes + status; with id: show that process's captured output so far (poll this after starting a server to confirm it came up)
+- kill_bg     {"id": int}                                      — stop a background process started with run_command background:true
 
 # Rules
 - GROUND TRUTH = the filesystem, NOT your memory of this chat. A file was created/changed ONLY if a write_file/edit_file TOOL RESULT confirms it (see the FILES CHANGED list). Saying "I created/updated X" in prose does NOT change any file — you must emit the tool call. If the user says a file is missing or asks its state, read_file/list_dir to check reality first; never claim a file "was reverted" or "should be there" from memory.
@@ -31,6 +33,10 @@ Available tools:
 - Make the smallest change that fully solves the task. Match the surrounding code style.
 - Prefer edit_file over write_file for existing files.
 - After changes, verify when sensible (run a build/test/lint command).
+- Background process lifecycle — after starting one with background:true, POLL bg_output (give it a moment) until you actually have what you need: the server logged "listening"/a ready URL, the command finished (status shows exited), or the data you wanted appeared. Do NOT assume it worked. Then decide:
+  • Started only to read output / run a check / one-shot task → call kill_bg as soon as you have the result (and ALWAYS before you finish the turn). Never leave a throwaway background process running.
+  • A server/service the USER wants to keep using (they asked to "run the app/server") → leave it running, and tell the user it is up: its id and the URL/port, and that they can ask you to stop it when done (you will kill_bg it). It also stops automatically when noob exits.
+  • If bg_output shows it exited with a non-zero code or an error, treat it like a failed command: read the output and fix, don't silently move on.
 - Keep prose tight. Explain what you did and why, not how to use a tool.
 - JSON in the tool block must be valid: escape newlines as \\n inside string values.
 - LANGUAGE: Always write your prose answers to the user in Vietnamese (tiếng Việt), unless the user explicitly writes in another language. Keep code, file paths, commands, and tool JSON unchanged.

package/src/config.js

@@ -55,6 +55,14 @@ export const config = {
     cache.model = id;
     write(cache);
   },
+  // yolo mặc định: bật sẵn yolo mỗi lần khởi động noob (lưu trên đĩa).
+  get yoloDefault() {
+    return !!cache.yolo;
+  },
+  setYolo(v) {
+    cache.yolo = !!v;
+    write(cache);
+  },
   get(k) {
     return cache[k];
   },

package/src/i18n.js

@@ -57,6 +57,7 @@ export const t = {
   cmdSearch: "/search        bật/tắt chế độ tìm web",
   cmdChat: "/chat          quay lại chế độ chat thường",
   cmdYolo: "/yolo          bật/tắt tự duyệt (hoặc nhấn Shift+Tab)",
+  cmdAutoYolo: "/auto-yolo     lưu/bỏ yolo làm mặc định mỗi lần chạy (cần xác nhận)",
   cmdKarpathy: "/karpathy [path]  rà soát code theo 4 nguyên tắc Karpathy (/kc)",
   cmdUltra: "/ultra <mục tiêu>  tự hành: noob tự nghĩ & tự làm nhiệm vụ tới khi xong (/u)",
   cmdLearn: "/learn [ghi chú]  chưng cất bài học của phiên vào noob.md",
@@ -73,10 +74,16 @@ export const t = {
   tip1: "• Mô tả việc cần làm; noob sẽ đọc/sửa file & chạy lệnh giúp bạn.",
   tip2: "• Đang chạy vẫn gõ tiếp được — tin sẽ xếp hàng & tự gửi khi model xong.",
   tip3: "• Shift+Tab: bật/tắt yolo nhanh. Ctrl+C 1 lần = dừng lượt, 2 lần = thoát.",
+  tip4: "• Gõ @ để gắn file (chỉ chỗ cho AI đọc). ←/→ Home/End sửa giữa dòng; ↑/↓ gọi lại lệnh cũ.",
 
   // misc
   yoloOn: "⚠ yolo BẬT — tự động duyệt mọi thao tác sửa file & chạy lệnh",
   yoloOff: "✓ yolo TẮT — sẽ hỏi trước khi sửa file & chạy lệnh",
+  autoYoloWarn: "⚠ yolo tự duyệt MỌI thao tác (sửa file/chạy lệnh) KHÔNG hỏi. Lưu làm mặc định = mỗi lần mở noob đều bật sẵn yolo.",
+  autoYoloConfirm: "Chắc chắn lưu yolo làm mặc định? gõ 'y' để xác nhận, phím khác để huỷ › ",
+  autoYoloOn: "⚡ Đã LƯU yolo làm mặc định — mọi phiên sau tự bật. Gõ /auto-yolo lần nữa để tắt.",
+  autoYoloOff: "✓ Đã bỏ yolo mặc định — phiên sau sẽ KHÔNG tự bật yolo (phiên này giữ nguyên).",
+  autoYoloCancel: "Huỷ — không thay đổi gì.",
   mergeOn: "Merge AI: BẬT",
   mergeOff: "Merge AI: TẮT",
   searchOn: "Tìm web: BẬT",

package/src/repl.js

@@ -1,4 +1,6 @@
 import process from "node:process";
+import fs from "node:fs";
+import path from "node:path";
 import chalk from "chalk";
 import { createTui } from "./tui.js";
 import { runAgent } from "./agent.js";
@@ -22,6 +24,7 @@ const SLASH = [
   { name: "/search", desc: "bật/tắt tìm web" },
   { name: "/chat", desc: "chế độ chat thường" },
   { name: "/yolo", desc: "bật/tắt tự duyệt" },
+  { name: "/auto-yolo", desc: "lưu yolo làm mặc định (cần xác nhận)" },
   { name: "/karpathy", desc: "rà soát code (Karpathy)" },
   { name: "/ultra", desc: "tự hành: tự nghĩ & làm nhiệm vụ" },
   { name: "/learn", desc: "chưng cất bài học vào noob.md" },
@@ -39,10 +42,80 @@ const SLASH = [
   { name: "/version", desc: "phiên bản" },
   { name: "/exit", desc: "thoát" },
 ];
-function completeSlash(text) {
-  if (!text.startsWith("/") || /\s/.test(text)) return []; // chỉ gợi ý khi đang gõ tên lệnh
-  const q = text.slice(1).toLowerCase();
-  return SLASH.filter((cmd) => cmd.name.slice(1).toLowerCase().includes(q));
+// Danh sách file trong cwd, cache 5s (gõ @ mỗi phím KHÔNG quét lại đĩa).
+let fileCache = { at: 0, list: [] };
+function allFiles() {
+  if (Date.now() - fileCache.at < 5000) return fileCache.list;
+  const out = [];
+  const root = process.cwd();
+  (function walk(dir, depth) {
+    if (out.length > 4000 || depth > 8) return;
+    let ents;
+    try {
+      ents = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of ents) {
+      if (e.name === "node_modules" || e.name.startsWith(".git")) continue;
+      const full = path.join(dir, e.name);
+      if (e.isDirectory()) walk(full, depth + 1);
+      else out.push(path.relative(root, full).split(path.sep).join("/"));
+      if (out.length > 4000) return;
+    }
+  })(root, 0);
+  fileCache = { at: Date.now(), list: out };
+  return out;
+}
+// Xếp hạng: tên file khớp đầu > đầu một đoạn path > chứa trong tên > chứa bất kỳ.
+function fileMatches(frag) {
+  const all = allFiles();
+  const q = frag.toLowerCase();
+  if (!q) return all.slice(0, 12);
+  const scored = [];
+  for (const f of all) {
+    const lf = f.toLowerCase();
+    const base = lf.split("/").pop();
+    let s = -1;
+    if (base.startsWith(q)) s = 0;
+    else if (lf.includes("/" + q)) s = 1;
+    else if (base.includes(q)) s = 2;
+    else if (lf.includes(q)) s = 3;
+    if (s >= 0) scored.push([s, f]);
+  }
+  scored.sort((a, b) => a[0] - b[0] || a[1].length - b[1].length);
+  return scored.slice(0, 12).map((x) => x[1]);
+}
+
+// Gợi ý cho thanh nhập: /lệnh (điền-rồi-gửi) hoặc @file (chỉ chèn, gõ tiếp).
+export function completeInput(text) {
+  if (text.startsWith("/") && !/\s/.test(text)) {
+    const q = text.slice(1).toLowerCase();
+    const items = SLASH.filter((cmd) => cmd.name.slice(1).toLowerCase().includes(q));
+    return items.length ? { items, start: 0, fill: "submit" } : null;
+  }
+  // @file: token CUỐI bắt đầu bằng @ (đầu dòng hoặc sau khoảng trắng).
+  const m = text.match(/(?:^|\s)@([^\s]*)$/);
+  if (m) {
+    const start = text.length - m[1].length - 1; // vị trí dấu '@'
+    const items = fileMatches(m[1]).map((p) => ({ name: "@" + p, desc: "file" }));
+    return items.length ? { items, start, fill: "insert" } : null;
+  }
+  return null;
+}
+
+// File thật được nhắc bằng @ trong tin nhắn → thêm chú thích để model đọc nhanh,
+// đúng chỗ (bỏ qua @ không trỏ tới file có thật, vd @tên người).
+export function mentionedFiles(text) {
+  const out = new Set();
+  const re = /(?:^|\s)@([^\s]+)/g;
+  let m;
+  while ((m = re.exec(text))) {
+    try {
+      if (fs.existsSync(path.resolve(process.cwd(), m[1]))) out.add(m[1]);
+    } catch {}
+  }
+  return [...out];
 }
 
 export async function startRepl(opts = {}) {
@@ -51,7 +124,7 @@ export async function startRepl(opts = {}) {
     mode: "chat", // chat | merge | search
     history: [],
     autoApprove: new Set(),
-    yolo: !!opts.yolo,
+    yolo: !!opts.yolo || config.yoloDefault, // cờ --yolo HOẶC mặc định đã lưu (/auto-yolo)
     ultra: false, // chế độ tự hành (self-quest) đang chạy?
   };
 
@@ -97,7 +170,7 @@ export async function startRepl(opts = {}) {
       tui.print(state.yolo ? c.err("  " + t.yoloOn) : c.ok("  " + t.yoloOff));
       tui.setPrompt(promptStr(false));
     },
-    completer: completeSlash,
+    completer: completeInput,
   });
 
   // Dòng "tươi" cho prompt chính VÀ permission. KHÔNG đụng `pending`.
@@ -272,19 +345,30 @@ Cuối cùng: tóm tắt + danh sách sửa theo thứ tự ưu tiên. Thẳng t
   // người dùng Ctrl+C. Mỗi vòng là một lượt agent đầy đủ (dùng lại handle()).
   const ULTRA_DONE = "<<ULTRA_DONE>>";
   const MAX_QUESTS = 40;
+  // Chỉ coi là HOÀN THÀNH khi token nằm ở CUỐI câu trả lời (dòng riêng) — tránh
+  // bắt nhầm khi model chỉ NHẮC tới token giữa văn xuôi. Không bao giờ chấp nhận
+  // ở lượt lập kế hoạch (xem vòng lặp bên dưới).
+  const ultraIsDone = (a) => a.trimEnd().endsWith(ULTRA_DONE);
   const ultraStart = (goal) => `# CHẾ ĐỘ ULTRA (tự hành)
 Mục tiêu tổng: ${goal}
 
-Bạn sẽ TỰ lập kế hoạch và TỰ thực hiện từng bước tới khi hoàn thành, KHÔNG chờ người dùng xác nhận giữa chừng.
-- Mỗi lượt: chọn nhiệm vụ con hợp lý kế tiếp, làm nó bằng tool (đọc/sửa file, chạy lệnh).
-- Sau khi làm, tự kiểm chứng (build/test) khi hợp lý.
-- Ghi tiến độ + điều học được vào noob.md để không quên giữa các bước.
-- Khi và CHỈ KHI toàn bộ mục tiêu đã xong và đã kiểm chứng, kết thúc câu trả lời bằng đúng token ${ULTRA_DONE}.
-- Gặp việc nguy hiểm/không thể đảo ngược hoặc thật sự bí → DỪNG, hỏi 1 câu rõ ràng (đừng phát ${ULTRA_DONE}).
-Bắt đầu bằng kế hoạch ngắn (3–7 gạch đầu dòng) rồi làm bước đầu tiên.`;
-  const ultraContinue = (goal) => `Tiếp tục chế độ ULTRA — mục tiêu: ${goal}
-Tự đánh giá còn thiếu gì, chọn nhiệm vụ con kế tiếp và làm tiếp bằng tool. Cập nhật noob.md nếu học được điều mới.
-Khi toàn bộ mục tiêu đã xong và đã kiểm chứng, kết thúc bằng token ${ULTRA_DONE}.`;
+Bạn TỰ lập kế hoạch và TỰ làm từng bước tới khi HOÀN THÀNH THẬT, không chờ người dùng xác nhận giữa chừng.
+LƯỢT NÀY (lập kế hoạch + khởi động):
+- Viết kế hoạch ngắn 3–7 gạch đầu dòng.
+- Rồi BẮT TAY làm bước đầu bằng tool (đọc/sửa file, chạy lệnh) — không nói suông.
+- TUYỆT ĐỐI KHÔNG phát token ${ULTRA_DONE} ở lượt này, dù mục tiêu trông nhỏ. Lượt lập kế hoạch KHÔNG bao giờ là lượt kết thúc.
+Nguyên tắc xuyên suốt: chỉ KẾT QUẢ TOOL mới tính là "đã làm"; nói "đã xong/đã sửa" trong văn xuôi mà KHÔNG có tool result thì KHÔNG tính.`;
+  const ultraContinue = (goal) => `Tiếp tục ULTRA — mục tiêu: ${goal}
+Tự đánh giá: còn THIẾU gì để đạt mục tiêu? Chọn 1 nhiệm vụ con kế tiếp và LÀM bằng tool (đừng chỉ mô tả). Cập nhật noob.md nếu học được điều mới.
+
+ĐIỀU KIỆN KẾT THÚC — chỉ được dừng khi ĐỦ CẢ 3; thiếu bất kỳ điều nào thì LÀM TIẾP, đừng dừng:
+1. Mọi phần của mục tiêu đã thực sự làm xong, có TOOL RESULT xác nhận (đối chiếu mục FILES CHANGED) — không chỉ nói trong văn xuôi.
+2. ĐÃ KIỂM CHỨNG: chạy build/test/lint hoặc chạy thử phần vừa làm bằng run_command và ĐỌC output thấy ĐẠT. Nếu dự án không có cách kiểm chứng tự động → nêu rõ đã kiểm tra bằng cách nào.
+3. Đã rà lại, không còn việc dở hay lỗi.
+
+• ĐỦ cả 3 → viết tóm tắt NGẮN việc đã làm + BẰNG CHỨNG kiểm chứng (lệnh đã chạy & kết quả thật), rồi đặt token ${ULTRA_DONE} TRÊN MỘT DÒNG RIÊNG ở CUỐI CÙNG.
+• CHƯA đủ (còn việc, hoặc chưa chạy kiểm chứng) → ĐỪNG phát token, tiếp tục bước kế.
+• Gặp việc nguy hiểm/không đảo ngược hoặc thật sự bí → DỪNG hỏi 1 câu rõ ràng (đừng phát token).`;
 
   async function runUltra(goal) {
     if (!config.apiKey) return console.log(c.tool("  " + t.notLoggedIn));
@@ -295,16 +379,18 @@ Khi toàn bộ mục tiêu đã xong và đã kiểm chứng, kết thúc bằng
     let answer = await handle(ultraStart(goal));
     persist();
     let i = 0;
+    // Lượt đầu = lập kế hoạch → KHÔNG xét hoàn thành. Mỗi vòng sau là một lượt
+    // "tiếp tục" có cổng kiểm chứng; chỉ dừng khi token nằm ở CUỐI câu trả lời.
     while (state.ultra && i < MAX_QUESTS) {
       if (!answer) break; // lượt bị ngắt/ lỗi → dừng tự hành, đừng quay vô ích
-      if (answer.includes(ULTRA_DONE)) {
-        console.log(c.ok("  ✓ " + t.ultraDone));
-        break;
-      }
       i++;
       console.log(c.accent("  ↻ " + t.ultraQuest(i)));
       answer = await handle(ultraContinue(goal));
       persist();
+      if (answer && ultraIsDone(answer)) {
+        console.log(c.ok("  ✓ " + t.ultraDone));
+        break;
+      }
     }
     if (state.ultra && i >= MAX_QUESTS) console.log(c.tool("  " + t.ultraMax));
     state.ultra = false;
@@ -332,6 +418,25 @@ Khi toàn bộ mục tiêu đã xong và đã kiểm chứng, kết thúc bằng
     console.log(c.dim("  " + memoryPath() + t.memoryStat(mem.split("\n").length)));
   }
 
+  // /auto-yolo — lưu/bỏ yolo làm MẶC ĐỊNH (mỗi lần mở noob tự bật). Vì yolo tự
+  // duyệt mọi thao tác, BẬT phải xác nhận lần 2 bằng cách gõ 'y'. TẮT thì không.
+  async function toggleAutoYolo() {
+    if (config.yoloDefault) {
+      config.setYolo(false);
+      return console.log(c.ok("  " + t.autoYoloOff));
+    }
+    console.log(c.err("  " + t.autoYoloWarn));
+    const ans = ((await ask(c.tool("  " + t.autoYoloConfirm))) ?? "").trim().toLowerCase();
+    if (ans === "y" || ans === "yes" || ans === "có") {
+      config.setYolo(true);
+      state.yolo = true; // áp dụng ngay cho phiên hiện tại
+      if (!closed) tui.setPrompt(promptStr(false));
+      console.log(c.err("  " + t.autoYoloOn));
+    } else {
+      console.log(c.dim("  " + t.autoYoloCancel));
+    }
+  }
+
   tui.start();
   banner();
   printStatus(state);
@@ -418,6 +523,7 @@ Khi toàn bộ mục tiêu đã xong và đã kiểm chứng, kết thúc bằng
       return;
     }
     abort = new AbortController();
+    tui.setBusy(true, t.thinking); // chỉ báo "đang chạy" bền suốt lượt (kể cả lúc model im)
     // spinner: status hiển thị qua tui (thanh dưới), tui tự animate khung xoay
     const t0 = Date.now();
     let timer = null;
@@ -461,7 +567,11 @@ Khi toàn bộ mục tiêu đã xong và đã kiểm chứng, kết thúc bằng
         return;
       }
 
-      state.history.push({ role: "user", content: text });
+      const files = mentionedFiles(text);
+      const content = files.length
+        ? text + `\n\n[File người dùng nhắc tới bằng @: ${files.join(", ")} — đọc bằng read_file nếu cần.]`
+        : text;
+      state.history.push({ role: "user", content });
       if (process.stdin.isTTY && !state.steerHintShown) {
         console.log(c.dim("  " + t.steerHint));
         state.steerHintShown = true;
@@ -513,6 +623,7 @@ Khi toàn bộ mục tiêu đã xong và đã kiểm chứng, kết thúc bằng
       printError(err);
     } finally {
       abort = null;
+      tui.setBusy(false);
     }
   }
 
@@ -597,6 +708,10 @@ Khi toàn bộ mục tiêu đã xong và đã kiểm chứng, kết thúc bằng
         state.yolo = !state.yolo;
         console.log((state.yolo ? c.err : c.ok)("  " + (state.yolo ? t.yoloOn : t.yoloOff)));
         break;
+      case "auto-yolo":
+      case "autoyolo":
+        await toggleAutoYolo();
+        break;
       case "karpathy":
       case "kcheck":
       case "kc":
@@ -835,6 +950,7 @@ function printHelp() {
         "  " + t.cmdSearch,
         "  " + t.cmdChat,
         "  " + t.cmdYolo,
+        "  " + t.cmdAutoYolo,
         "  " + t.cmdKarpathy,
         "  " + t.cmdUltra,
         "  " + t.cmdLearn,
@@ -854,6 +970,7 @@ function printHelp() {
         c.dim("  " + t.tip1),
         c.dim("  " + t.tip2),
         c.dim("  " + t.tip3),
+        c.dim("  " + t.tip4),
       ].join("\n"),
       t.helpTitle,
       "#a78bfa",

package/src/tools.js

@@ -16,6 +16,23 @@ function clip(s) {
 // Tools that mutate the filesystem or run code require user approval.
 export const DESTRUCTIVE = new Set(["write_file", "edit_file", "run_command"]);
 
+// ── Tiến trình nền ─────────────────────────────────────────────────────────
+// Lệnh chạy lâu / không bao giờ thoát (dev server, watcher) KHÔNG được chạy ở
+// foreground: nó treo cả task rồi bị giết sau timeout. background:true → spawn
+// rồi trả về NGAY, giữ tiến trình sống, gom output vào buffer để model đọc dần.
+const bg = new Map(); // id -> { child, command, out, exited, code, startedAt }
+let bgSeq = 0;
+function killBgTree(child) {
+  try {
+    if (process.platform === "win32" && child.pid) spawn("taskkill", ["/pid", String(child.pid), "/T", "/F"]);
+    else child.kill();
+  } catch {}
+}
+// Đừng để tiến trình nền sống mồ côi sau khi CLI thoát.
+process.on("exit", () => {
+  for (const p of bg.values()) killBgTree(p.child);
+});
+
 export const TOOLS = {
   async read_file({ path: p, offset, limit }) {
     const data = await fs.readFile(abs(p), "utf8");
@@ -145,17 +162,49 @@ export const TOOLS = {
     return out.length ? clip(out.join("\n")) : "No matches.";
   },
 
-  run_command({ command, timeout = 60000 }) {
+  run_command({ command, timeout = 60000, background = false }) {
+    const isWin = process.platform === "win32";
+    const shell = isWin ? "powershell.exe" : "/bin/bash";
+    const args = isWin ? ["-NoProfile", "-NonInteractive", "-Command", command] : ["-c", command];
+    // stdin: "ignore" — tiến trình con KHÔNG được chạm vào console/stdin của
+    // CLI. Nếu để con kế thừa stdin, trên Windows nó có thể làm readline phát
+    // 'close' → CLI tự tắt. Đóng hẳn stdin con để tránh hoàn toàn.
+
+    // Nền: spawn rồi trả về NGAY, không chờ. Output gom vào buffer, model đọc
+    // bằng bg_output, dừng bằng kill_bg.
+    if (background) {
+      const id = ++bgSeq;
+      const child = spawn(shell, args, { cwd: cwd(), stdio: ["ignore", "pipe", "pipe"] });
+      const proc = { child, command, out: "", exited: false, code: null, startedAt: Date.now() };
+      const cap = (d) => {
+        proc.out += d;
+        if (proc.out.length > MAX_OUT * 2) proc.out = proc.out.slice(-MAX_OUT * 2); // giữ phần mới nhất
+      };
+      child.stdout.on("data", cap);
+      child.stderr.on("data", cap);
+      child.on("error", (e) => {
+        proc.exited = true;
+        proc.out += `\n[failed to start: ${e.message}]`;
+      });
+      child.on("close", (code) => {
+        proc.exited = true;
+        proc.code = code;
+      });
+      bg.set(id, proc);
+      return Promise.resolve(
+        `Started background process #${id} (pid ${child.pid ?? "?"}): ${command}\n` +
+          `It keeps running and does NOT block further steps. Read its output with bg_output {"id": ${id}}, stop it with kill_bg {"id": ${id}}.`,
+      );
+    }
+
     return new Promise((resolve) => {
-      const isWin = process.platform === "win32";
-      const shell = isWin ? "powershell.exe" : "/bin/bash";
-      const args = isWin ? ["-NoProfile", "-NonInteractive", "-Command", command] : ["-c", command];
-      // stdin: "ignore" — tiến trình con KHÔNG được chạm vào console/stdin của
-      // CLI. Nếu để con kế thừa stdin, trên Windows nó có thể làm readline phát
-      // 'close' → CLI tự tắt. Đóng hẳn stdin con để tránh hoàn toàn.
       const child = spawn(shell, args, { cwd: cwd(), stdio: ["ignore", "pipe", "pipe"] });
       let out = "";
-      const killer = setTimeout(() => child.kill(), timeout);
+      let timedOut = false;
+      const killer = setTimeout(() => {
+        timedOut = true;
+        child.kill();
+      }, timeout);
       child.stdout.on("data", (d) => (out += d));
       child.stderr.on("data", (d) => (out += d));
       child.on("error", (e) => {
@@ -164,11 +213,36 @@ export const TOOLS = {
       });
       child.on("close", (code) => {
         clearTimeout(killer);
-        const tail = `\n[exit code ${code}]`;
+        const tail = timedOut
+          ? `\n[timed out after ${Math.round(timeout / 1000)}s — killed. If this is a server or other long-running task, re-run with {"background": true} instead.]`
+          : `\n[exit code ${code}]`;
         resolve(clip((out.trim() || "(no output)") + tail));
       });
     });
   },
+
+  // Đọc trạng thái + output đã gom của tiến trình nền. Không có id → liệt kê tất cả.
+  bg_output({ id } = {}) {
+    if (id == null) {
+      if (!bg.size) return "No background processes.";
+      return [...bg.entries()]
+        .map(([i, p]) => `#${i} ${p.exited ? `exited(code ${p.code})` : `running(pid ${p.child.pid})`} — ${p.command}`)
+        .join("\n");
+    }
+    const p = bg.get(id);
+    if (!p) return `No background process #${id}.`;
+    const status = p.exited ? `exited (code ${p.code})` : `running (pid ${p.child.pid}, ${Math.round((Date.now() - p.startedAt) / 1000)}s)`;
+    return clip(`#${id} ${status} — ${p.command}\n${p.out.trim() || "(no output yet)"}`);
+  },
+
+  // Dừng một tiến trình nền (kèm cây con trên Windows).
+  kill_bg({ id }) {
+    const p = bg.get(id);
+    if (!p) return `No background process #${id}.`;
+    killBgTree(p.child);
+    bg.delete(id);
+    return `Killed background process #${id} (${p.command}).`;
+  },
 };
 
 // Khớp old_string theo KHỐI DÒNG, bỏ qua khác biệt CRLF và khoảng trắng CUỐI
@@ -269,7 +343,11 @@ export function describe(name, input) {
     case "grep":
       return `grep "${input.pattern}"${input.path ? " in " + input.path : ""}`;
     case "run_command":
-      return `$ ${input.command}`;
+      return (input.background ? "$ (nền) " : "$ ") + input.command;
+    case "bg_output":
+      return input.id != null ? `xem tiến trình nền #${input.id}` : "liệt kê tiến trình nền";
+    case "kill_bg":
+      return `dừng tiến trình nền #${input.id}`;
     default:
       return name;
   }

package/src/tui.js

@@ -53,6 +53,7 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
       },
       print() {},
       status() {},
+      setBusy() {},
       setPrompt() {},
       read() {
         if (queue.length) return Promise.resolve(queue.shift());
@@ -73,39 +74,94 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
 
   let liveOut = ""; // dòng output dở dang (chưa có '\n') hiện ngay trên thanh
   let statusText = null; // text spinner khi đang nghĩ
+  // `busy` = một lượt/tool ĐANG chạy. Hiện spinner dự phòng suốt lượt kể cả lúc
+  // statusText tạm trống (vd model ngừng phun token giữa các bước) → người dùng
+  // LUÔN thấy rõ "đang chạy", không bị tưởng treo.
+  let busy = false;
+  let busyLabel = "";
   let frame = 0;
   let frameTimer = null;
   let prevRows = 0;
   let drawn = false;
 
   let promptLabel = "";
-  let parts = []; // input: {type:'text',value} | {type:'paste',value,lines}
+  // Thanh nhập = mảng "ô" + con trỏ. Mỗi ô là 1 ký tự {c} hoặc 1 khối dán
+  // {paste, lines} (hiện thành chip, sửa/xoá theo cả khối). `cur` ∈ [0, len] là
+  // vị trí con trỏ → hỗ trợ ←/→/Home/End/Delete, chèn & xoá GIỮA dòng.
+  let cells = [];
+  let cur = 0;
   let waiter = null;
   const queue = [];
 
-  // ----- autocomplete: gợi ý lệnh hiện phía trên thanh nhập -----
+  // Lịch sử dòng đã gửi → ↑/↓ gọi lại (khi không có menu gợi ý đang mở).
+  const submitHistory = [];
+  let histPos = null;
+
+  // ----- autocomplete: gợi ý lệnh / file hiện phía trên thanh nhập -----
+  // completer(text) → null | { items:[{name,desc}], start:int, fill:"submit"|"insert" }
+  //   start = chỉ số trong text nơi token được thay (0 với /lệnh, vị trí '@' với @file)
+  //   fill  = "submit": Enter điền-rồi-gửi (lệnh); "insert": Enter chỉ chèn, gõ tiếp
   let menu = []; // [{name, desc}] khớp với những gì đang gõ
   let menuIdx = 0; // mục đang chọn (mũi tên ↑/↓), Tab để điền
+  let menuStart = 0;
+  let menuFill = "submit";
   function refreshMenu() {
-    menu = completer ? completer(fullText()) || [] : [];
+    const res = completer ? completer(fullText()) : null;
+    if (res && res.items && res.items.length) {
+      menu = res.items;
+      menuStart = res.start || 0;
+      menuFill = res.fill || "submit";
+    } else {
+      menu = [];
+      menuStart = 0;
+    }
     menuIdx = 0;
   }
+  // Điền mục đang chọn: thay token [menuStart…] bằng tên + 1 dấu cách, giữ phần đầu.
+  function acceptMenu() {
+    const prefix = fullText().slice(0, menuStart);
+    setInput(prefix + menu[menuIdx].name + " ");
+    menu = [];
+  }
 
-  // ----- input → chuỗi đầy đủ + bản hiển thị (paste = chip) -----
-  const fullText = () => parts.map((p) => p.value).join("");
-  const dispPlain = () => parts.map((p) => (p.type === "paste" ? `[pasted ${p.lines} lines]` : p.value)).join("");
-  const dispColored = () =>
-    parts.map((p) => (p.type === "paste" ? c.dim(`[pasted ${p.lines} lines]`) : p.value)).join("");
+  // ----- ô nhập → chuỗi đầy đủ + bản tô màu (paste = chip) -----
+  const cellStr = (x) => (x.paste !== undefined ? x.paste : x.c);
+  const cellPlain = (x) => (x.paste !== undefined ? `[pasted ${x.lines} lines]` : x.c);
+  const fullText = () => cells.map(cellStr).join("");
+  const coloredInput = () =>
+    cells.map((x) => (x.paste !== undefined ? c.dim(`[pasted ${x.lines} lines]`) : x.c)).join("");
 
+  // Dựng thanh nhập + tính cột con trỏ trên màn (`cursorScreenCol`). Vừa khung →
+  // tô màu đầy đủ. Tràn khung → cuộn ngang theo plain sao cho con trỏ luôn trong
+  // tầm nhìn, chèn "…" ở đầu/cuối bị cắt.
+  let cursorScreenCol = 0;
   function renderBar() {
-    const budget = Math.max(4, cols() - visLen(promptLabel) - 1);
-    const plain = dispPlain();
-    if (plain.length <= budget) return promptLabel + dispColored();
-    return promptLabel + "…" + plain.slice(plain.length - (budget - 1)); // giữ đuôi (chỗ đang gõ)
+    const promptW = visLen(promptLabel);
+    const budget = Math.max(4, cols() - promptW - 1);
+    const plains = cells.map(cellPlain);
+    let curCol = 0;
+    for (let k = 0; k < cur; k++) curCol += plains[k].length;
+    let total = 0;
+    for (const p of plains) total += p.length;
+    if (total <= budget) {
+      cursorScreenCol = promptW + curCol;
+      return promptLabel + coloredInput();
+    }
+    const plain = plains.join("");
+    let start = curCol > budget - 1 ? curCol - (budget - 1) : 0;
+    if (start > total - budget) start = total - budget;
+    if (start < 0) start = 0;
+    const end = Math.min(total, start + budget);
+    const arr = [...plain.slice(start, end)];
+    if (start > 0) arr[0] = "…";
+    if (end < total) arr[arr.length - 1] = "…";
+    cursorScreenCol = Math.min(promptW + budget, Math.max(promptW, promptW + (curCol - start)));
+    return promptLabel + arr.join("");
   }
   function topRow() {
     if (liveOut) return liveOut.slice(0, cols());
     if (statusText) return c.dim(FRAMES[frame % FRAMES.length] + " ") + statusText;
+    if (busy) return c.dim(FRAMES[frame % FRAMES.length] + " " + (busyLabel || "đang chạy") + " · Ctrl+C để dừng");
     return null;
   }
   function menuRows() {
@@ -133,9 +189,12 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
     if (!drawn) return "\r";
     return "\r" + (prevRows > 1 ? `${ESC}[${prevRows - 1}A` : "") + `${ESC}[J`;
   }
+  // Sau khi vẽ xong các hàng, con trỏ đang ở CUỐI thanh (hàng cuối). Đưa nó về
+  // đúng cột con trỏ logic: \r về cột 0 rồi dịch phải `cursorScreenCol`.
+  const placeCursor = () => "\r" + (cursorScreenCol > 0 ? `${ESC}[${cursorScreenCol}C` : "");
   function draw() {
-    const rs = rows();
-    w(`${ESC}[?25l` + eraseSeq() + rs.join("\n") + `${ESC}[?25h`);
+    const rs = rows(); // rows() → renderBar() cập nhật cursorScreenCol
+    w(`${ESC}[?25l` + eraseSeq() + rs.join("\n") + placeCursor() + `${ESC}[?25h`);
     prevRows = rs.length;
     drawn = true;
   }
@@ -145,7 +204,7 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
     let s = `${ESC}[?25l` + eraseSeq();
     s += block;
     if (!block.endsWith("\n")) s += "\n";
-    s += rs.join("\n") + `${ESC}[?25h`;
+    s += rs.join("\n") + placeCursor() + `${ESC}[?25h`;
     w(s);
     prevRows = rs.length;
     drawn = true;
@@ -168,28 +227,76 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
   // ----- bàn phím: paste (bracketed) + heuristic chunk nhiều dòng -----
   function pushText(str) {
     if (!str) return;
-    const last = parts[parts.length - 1];
-    if (last && last.type === "text") last.value += str;
-    else parts.push({ type: "text", value: str });
+    const chars = [...str].map((ch) => ({ c: ch }));
+    cells.splice(cur, 0, ...chars); // chèn TẠI con trỏ (không chỉ cuối dòng)
+    cur += chars.length;
+    histPos = null;
   }
   function pushPaste(content) {
     const lines = content.split("\n").length;
-    if (lines >= 2) parts.push({ type: "paste", value: content, lines });
-    else pushText(content); // paste 1 dòng = gõ thẳng
+    if (lines >= 2) {
+      cells.splice(cur, 0, { paste: content, lines });
+      cur += 1;
+      histPos = null;
+    } else pushText(content); // paste 1 dòng = gõ thẳng
   }
   function backspace() {
-    const last = parts[parts.length - 1];
-    if (!last) return;
-    if (last.type === "paste") parts.pop();
-    else {
-      last.value = [...last.value].slice(0, -1).join("");
-      if (!last.value) parts.pop();
+    if (cur > 0) {
+      cells.splice(cur - 1, 1);
+      cur -= 1;
+      histPos = null;
+    }
+  }
+  function deleteForward() {
+    if (cur < cells.length) {
+      cells.splice(cur, 1);
+      histPos = null;
+    }
+  }
+  // null = ô dán (coi như ranh giới từ); ngược lại trả ký tự của ô.
+  const charAt = (k) => (cells[k] && cells[k].paste === undefined ? cells[k].c : null);
+  function moveWordLeft() {
+    while (cur > 0 && charAt(cur - 1) === " ") cur -= 1;
+    if (cur > 0 && charAt(cur - 1) === null) return void (cur -= 1); // qua 1 chip
+    while (cur > 0 && charAt(cur - 1) !== null && charAt(cur - 1) !== " ") cur -= 1;
+  }
+  function moveWordRight() {
+    while (cur < cells.length && charAt(cur) === " ") cur += 1;
+    if (cur < cells.length && charAt(cur) === null) return void (cur += 1);
+    while (cur < cells.length && charAt(cur) !== null && charAt(cur) !== " ") cur += 1;
+  }
+  function setInput(str) {
+    cells = [...str].map((ch) => ({ c: ch }));
+    cur = cells.length;
+  }
+  // ↑/↓ gọi lại các dòng đã gửi (chỉ khi menu gợi ý KHÔNG mở).
+  function histNav(dir) {
+    if (menu.length || !submitHistory.length) return;
+    if (dir < 0) {
+      histPos = histPos === null ? submitHistory.length - 1 : Math.max(0, histPos - 1);
+      setInput(submitHistory[histPos]);
+    } else {
+      if (histPos === null) return;
+      histPos += 1;
+      if (histPos > submitHistory.length - 1) {
+        histPos = null;
+        cells = [];
+        cur = 0;
+      } else setInput(submitHistory[histPos]);
     }
+    refreshMenu();
+    draw();
   }
   function submit() {
     const full = fullText();
-    const echo = promptLabel + dispColored();
-    parts = [];
+    const echo = promptLabel + coloredInput();
+    if (full.trim() && submitHistory[submitHistory.length - 1] !== full) {
+      submitHistory.push(full);
+      if (submitHistory.length > 200) submitHistory.shift();
+    }
+    histPos = null;
+    cells = [];
+    cur = 0;
     menu = [];
     menuIdx = 0;
     commit(echo); // hiện lại dòng đã gõ (paste = chip) vào scrollback
@@ -233,38 +340,58 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
       if (rest.startsWith(`${ESC}[200~`)) { inPaste = true; pasteAcc = ""; i += 6; continue; }
       const ch = s[i];
       if (ch === ESC) {
-        // Shift+Tab = CSI Z (\x1b[Z). Bắt TRỰC TIẾP ở đây cho chắc — decoder
-        // keypress song song trước đây không nổ trên một số terminal Windows.
-        if (rest.startsWith(`${ESC}[Z`)) { onShiftTab?.(); i += 3; continue; }
-        // Mũi tên ↑/↓ điều hướng menu gợi ý lệnh (↑=A, ↓=B). ←/→ (C/D) nuốt.
-        const arrow = rest.match(/^\x1b(?:\[|O)([ABCD])/);
-        if (arrow) {
-          if (menu.length && (arrow[1] === "A" || arrow[1] === "B")) {
-            menuIdx = arrow[1] === "A" ? (menuIdx - 1 + menu.length) % menu.length : (menuIdx + 1) % menu.length;
-            draw();
-          }
-          i += arrow[0].length;
+        // Một chuỗi CSI hoàn chỉnh: \x1b[ … <chữ/~>  hoặc SS3: \x1bO<chữ>.
+        const csi = rest.match(/^\x1b\[[0-9;]*[~A-Za-z]/) || rest.match(/^\x1bO[A-Za-z]/);
+        if (!csi) {
+          // Bị cắt ngang chunk → giữ lại chờ phần còn lại. Còn ESC đơn/lạ → bỏ.
+          if (/^\x1b(\[[0-9;]*|O)?$/.test(rest)) { carry = rest; return; }
+          i += 1;
           continue;
         }
-        const m = rest.match(/^\x1b\[[0-9;]*[A-Za-z~]/) || rest.match(/^\x1bO[A-Za-z]/);
-        if (m) { i += m[0].length; continue; }
-        if (rest.length < 3) { carry = rest; return; } // esc dở
-        i += 1;
+        const seq = csi[0];
+        const fin = seq[seq.length - 1];
+        const params = seq.slice(2, -1).split(";"); // "\x1b[1;5C" → ["1","5"]
+        const mod = parseInt(params[1], 10) || 0; // 5=Ctrl, 3=Alt, 2=Shift
+        const word = mod === 5 || mod === 3; // Ctrl/Alt + ←/→ = nhảy theo từ
+        if (fin === "Z") onShiftTab?.(); // Shift+Tab = bật/tắt yolo
+        else if (fin === "A" || fin === "B") {
+          // ↑/↓: điều hướng menu gợi ý nếu đang mở, ngược lại gọi lại lịch sử.
+          if (menu.length) { menuIdx = fin === "A" ? (menuIdx - 1 + menu.length) % menu.length : (menuIdx + 1) % menu.length; draw(); }
+          else histNav(fin === "A" ? -1 : 1);
+        } else if (fin === "C") { if (word) moveWordRight(); else if (cur < cells.length) cur += 1; draw(); } // →
+        else if (fin === "D") { if (word) moveWordLeft(); else if (cur > 0) cur -= 1; draw(); } // ←
+        else if (fin === "H") { cur = 0; draw(); } // Home
+        else if (fin === "F") { cur = cells.length; draw(); } // End
+        else if (fin === "~") {
+          const n = parseInt(params[0], 10);
+          if (n === 3) { deleteForward(); refreshMenu(); draw(); } // Delete
+          else if (n === 1 || n === 7) { cur = 0; draw(); } // Home
+          else if (n === 4 || n === 8) { cur = cells.length; draw(); } // End
+        }
+        i += seq.length;
         continue;
       }
       if (ch === "\r" || ch === "\n") {
-        if (menu.length) parts = [{ type: "text", value: menu[menuIdx].name }]; // Enter chọn mục đang sáng
-        submit();
+        if (menu.length && menuFill === "insert") {
+          acceptMenu(); // @file: chỉ CHÈN vào dòng, KHÔNG gửi — cho gõ tiếp
+          draw();
+        } else {
+          if (menu.length) setInput(menu[menuIdx].name); // /lệnh: điền rồi gửi
+          submit();
+        }
         if (ch === "\r" && s[i + 1] === "\n") i++; // nuốt \n của \r\n
         i++;
         continue;
       }
-      if (ch === "\x7f" || ch === "\b") { backspace(); refreshMenu(); draw(); i++; continue; }
+      if (ch === "\x7f" || ch === "\b") { backspace(); refreshMenu(); draw(); i++; continue; } // Backspace
       if (ch === "\x03") { onInterrupt?.(); i++; continue; } // Ctrl+C
-      if (ch === "\x15") { parts = []; refreshMenu(); draw(); i++; continue; } // Ctrl+U xoá dòng
-      if (ch === "\x04") { if (!fullText()) onEOF?.(); i++; continue; } // Ctrl+D
-      if (ch === "\t") { // Tab điền lệnh đang chọn + dấu cách (để gõ tham số), đóng menu
-        if (menu.length) { parts = [{ type: "text", value: menu[menuIdx].name + " " }]; menu = []; draw(); }
+      if (ch === "\x01") { cur = 0; draw(); i++; continue; } // Ctrl+A → đầu dòng
+      if (ch === "\x05") { cur = cells.length; draw(); i++; continue; } // Ctrl+E → cuối dòng
+      if (ch === "\x15") { cells = cells.slice(cur); cur = 0; histPos = null; refreshMenu(); draw(); i++; continue; } // Ctrl+U: xoá tới đầu dòng
+      if (ch === "\x0b") { cells = cells.slice(0, cur); histPos = null; refreshMenu(); draw(); i++; continue; } // Ctrl+K: xoá tới cuối dòng
+      if (ch === "\x04") { if (!fullText()) onEOF?.(); else { deleteForward(); refreshMenu(); draw(); } i++; continue; } // Ctrl+D: rỗng=EOF, else xoá ký tự
+      if (ch === "\t") { // Tab điền mục đang chọn (lệnh/file) + dấu cách, đóng menu
+        if (menu.length) { acceptMenu(); draw(); }
         i++;
         continue;
       }
@@ -310,7 +437,7 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
         return true;
       };
       frameTimer = setInterval(() => {
-        if (statusText && !liveOut) {
+        if ((statusText || busy) && !liveOut) {
           frame++;
           draw();
         }
@@ -324,6 +451,11 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
       statusText = text || null;
       draw();
     },
+    setBusy(on, label) {
+      busy = !!on;
+      if (label != null) busyLabel = label;
+      draw();
+    },
     setPrompt(label) {
       promptLabel = label || "";
       draw();