@noobdemon/noob-cli 1.7.1 → 1.7.3

package/bin/noob.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { startRepl } from "../src/repl.js";
 import { config } from "../src/config.js";
-import { usage, ApiError } from "../src/api.js";
+import { usage, ApiError, applyInsecureTLS } from "../src/api.js";
 import { c } from "../src/ui.js";
 import { t } from "../src/i18n.js";
 import { checkLatest, runUpdate, CURRENT } from "../src/update.js";
@@ -27,6 +27,10 @@ for (let i = 0; i < argv.length; i++) {
 
 const sub = positional[0];
 
+// Áp dụng --insecure-tls SAU khi parse argv (ESM import hoist khiến top-level
+// check trong api.js chạy trước khi flag được set).
+applyInsecureTLS();
+
 // ── subcommands ──────────────────────────────────────────────────────────
 if (sub === "login") {
   const key = positional[1];
@@ -38,12 +42,20 @@ if (sub === "login") {
   console.log(c.ok("✓ ") + t.loginSaved(config.path));
   try {
     const u = await usage();
-    if (u.ok) console.log(c.ok(t.loginOk({ pro: "Pro", proplus: "Pro+", admin: "Admin", trial: "Trial" }[u.plan] || u.plan)));
-    else console.log(c.err("✗ " + t.errInvalidKey));
-  } catch {
-    /* network — key still saved */
+    if (u.ok) {
+      console.log(c.ok(t.loginOk({ pro: "Pro", proplus: "Pro+", admin: "Admin", trial: "Trial" }[u.plan] || u.plan)));
+      process.exit(0);
+    } else {
+      // Key đã lưu xuống đĩa nhưng gateway từ chối — exit != 0 để user biết, script CI cũng bắt được.
+      console.log(c.err("✗ " + t.errInvalidKey));
+      process.exit(2);
+    }
+  } catch (err) {
+    // Mạng/gateway down: giữ key (user có thể đang offline), nhưng KHÔNG im lặng.
+    console.log(c.err("⚠ không verify được key (mạng/gateway): " + (err?.message || err)));
+    console.log(c.dim("  key vẫn được lưu — chạy `noob usage` khi có mạng để xác nhận."));
+    process.exit(3);
   }
-  process.exit(0);
 } else if (sub === "logout") {
   config.clearKey();
   console.log(c.ok(t.loggedOut));

package/package.json

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

package/src/agent.js

@@ -17,21 +17,22 @@ To call a tool, emit EXACTLY ONE fenced code block tagged \`tool\` containing a
 
 Then STOP and wait — the runtime executes the tool and replies with a TOOL RESULT. Use one tool per step. When the task is complete (or you are only answering a question), reply normally in Markdown with NO tool block.
 
-Available tools:
-- read_file   {"path": str, "offset"?: int, "limit"?: int}   — read a file. The "N  " line-number prefix in the output is DISPLAY ONLY — it is NOT part of the file; never copy it into edit_file.
-- write_file  {"path": str, "content": str}                   — create/overwrite a file
+Available tools (each is self-contained; pick the SMALLEST tool that answers the question):
+- read_file   {"path": str, "offset"?: int, "limit"?: int}   — read a file. Default reads whole file. For files you suspect are LARGE (>500 lines), first check size via list_dir/glob, then read with offset+limit (e.g. 200 lines at a time) instead of slurping. The "N  " line-number prefix in output is DISPLAY ONLY — never copy it into edit_file.
+- write_file  {"path": str, "content": str}                   — create/overwrite a file. Use ONLY for new files or full rewrites; otherwise prefer edit_file.
 - edit_file   {"path": str, "old_string": str, "new_string": str, "replace_all"?: bool} — exact string replace. old_string must match the file's RAW text byte-for-byte (indentation/whitespace included, NO line-number prefix) and be unique unless replace_all. If a replace fails, re-read the file and copy the exact text.
-- 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, "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
+- list_dir    {"path"?: str}                                  — list a directory. Use to map an unfamiliar project before reading anything.
+- glob        {"pattern": str}                                — find files by glob (supports ** and *). Use when you know the filename pattern but not its location.
+- grep        {"pattern": str, "path"?: str, "glob"?: str}    — regex search file contents. Use to LOCATE code before reading; cheaper than reading whole files when hunting a symbol/string.
+- run_command {"command": str, "timeout"?: int, "background"?: bool} — run a shell command in the cwd. Foreground commands are killed after ~60s (override with "timeout" ms). For long-running processes — dev servers, watchers, \`python -m http.server\`, \`npm run dev\`, \`flask run\` — set "background": true: starts the process, returns immediately, keeps running WITHOUT blocking 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 after starting a server to confirm it came up).
+- kill_bg     {"id": int}                                      — stop a background process started with run_command background:true.
+
+# Retrieval strategy (just-in-time, not bulk)
+Context is finite. Don't slurp the whole repo up front. Discover information progressively: list_dir/glob to map → grep to locate → read_file (with offset+limit for big files) to inspect only what matters. Each tool result spends your attention budget — make every call earn it. When a tool returns a huge blob, extract the few facts you need, then move on; don't re-read it later (the result stays in history).
 
 # 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.
-- NO FABRICATED VERIFICATION. Never claim a result you did not actually get from a real TOOL RESULT in THIS conversation. Do NOT say "tests pass" / "300/300" / "verified" / "done" / "100%" / "it works" unless a run_command TOOL RESULT above truly shows it. Do NOT reference or quote output that does not appear above — if you have not run the check, say so and RUN it; never narrate a result you only imagine.
-- BEFORE any "finished/summary" message, RE-CHECK reality against the FILES CHANGED list: every file you are about to say you created/edited MUST appear there. If it is not there, you did NOT write it — emit the write_file/edit_file (or list_dir/read_file to confirm) NOW instead of claiming completion. When in doubt, list_dir/read_file the workspace and verify before asserting — do not assert from memory.
+- GROUND TRUTH = real TOOL RESULTs in this conversation, not your memory or what you intended to do. A file changed only if a write_file/edit_file result confirms it (see the FILES CHANGED list). A test passed / build succeeded / command worked only if a run_command result above shows it. Never narrate outcomes you didn't observe; if you haven't checked, say so and check now (read_file / list_dir / run the command). Before any "done/summary" reply, reconcile every file and result you're about to claim against the actual tool results above — if it isn't there, you didn't do it yet.
 - Investigate before editing: read the relevant files first; never invent file contents.
 - Make the smallest change that fully solves the task. Match the surrounding code style.
 - Prefer edit_file over write_file for existing files.
@@ -136,12 +137,13 @@ function compact(history, budget) {
 // lượt cũ thành một message system gọn (giữ quyết định, file đã sửa, lý do,
 // việc dở) rồi thay phần đầu history bằng tóm tắt đó. Mutates `history` in place.
 // Trả về true nếu có tóm tắt (để caller persist phiên ngay).
-export async function maybeSummarize(history, { model, signal }) {
+export async function maybeSummarize(history, { model, signal, force = false } = {}) {
   if (!history?.length) return false;
   const totalChars = history.reduce((s, m) => s + (m.content?.length || 0), 0);
-  if (totalChars < SUMMARIZE_THRESHOLD_CHARS) return false;
+  if (!force && totalChars < SUMMARIZE_THRESHOLD_CHARS) return false;
   // Giữ 8 message cuối nguyên vẹn; tóm tắt phần trước.
-  const keepTail = 8;
+  // Khi force (gọi từ /compact), giữ ít tail hơn để tóm tắt mạnh hơn.
+  const keepTail = force ? 4 : 8;
   if (history.length <= keepTail + 2) return false;
   // Nếu lượt đầu đã là summary (role=system, name=summary) → tóm tắt thêm.
   const head = history.slice(0, history.length - keepTail);

package/src/api.js

@@ -5,9 +5,19 @@ import { config } from "./config.js";
 
 // Opt-in TLS escape hatch for machines behind a TLS-intercepting / broken-
 // revocation proxy. Off by default. Prefer fixing the trust store.
-if (process.env.NOOB_INSECURE_TLS === "1") {
+// LƯU Ý: gọi từ bin/noob.js SAU khi parse argv — vì ESM import được hoist nên
+// nếu chỉ check ở top-level, flag --insecure-tls set sau import sẽ không kịp.
+let _tlsWarned = false;
+export function applyInsecureTLS() {
+  if (process.env.NOOB_INSECURE_TLS !== "1") return;
   process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+  if (_tlsWarned) return;
+  _tlsWarned = true;
+  // Cảnh báo rõ ràng: flag này tắt verify TLS TOÀN PROCESS. MITM-able.
+  console.warn("\x1b[33m⚠ NOOB_INSECURE_TLS=1: TLS verification DISABLED for this process. MITM-vulnerable. Unset when done.\x1b[0m");
 }
+// Vẫn áp dụng ngay nếu env có sẵn từ shell (export NOOB_INSECURE_TLS=1).
+applyInsecureTLS();
 
 function authHeaders() {
   const h = { "Content-Type": "application/json" };

package/src/i18n.js

@@ -64,7 +64,9 @@ export const t = {
   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",
+  cmdCompact: "/compact         tóm tắt phiên ngay để gọn ngữ cảnh (giữ trí nhớ dài hạn)",
   cmdMemory: "/memory          xem bộ nhớ noob.md (/mem)",
+  cmdAddDir: "/add-dir <path>  thêm thư mục ngoài cwd vào phạm vi tool (không arg = liệt kê)",
   cmdClear: "/clear /new    xoá ngữ cảnh (mở phiên mới, phiên cũ vẫn resume được)",
   cmdResume: "/resume [id]   tiếp tục phiên cũ (không id = chọn từ danh sách)",
   cmdSessions: "/sessions      liệt kê các phiên đã lưu",
@@ -111,6 +113,15 @@ export const t = {
   ultraNeedGoal: "Cần mục tiêu. Dùng: /ultra <mô tả mục tiêu>",
   ultraQuest: (n) => `tự nghĩ nhiệm vụ kế tiếp (vòng ${n})…`,
   learning: "đang chưng cất bài học vào noob.md…",
+  compactRunning: "đang tóm tắt phiên để gọn ngữ cảnh…",
+  compactEmpty: "Phiên còn trống — không có gì để tóm tắt.",
+  compactSkipped: "Phiên còn ngắn hoặc tóm tắt thất bại — bỏ qua.",
+  compactDone: (bMsgs, aMsgs, bK, aK, pct) => `Đã tóm tắt: ${bMsgs} → ${aMsgs} tin · ${bK}k → ${aK}k chars (giảm ${pct}%).`,
+  longSession: (k) => `Phiên dài (${k}k chars). Cân nhắc /compact để gọn ngữ cảnh (giữ trí nhớ) hoặc /clear để phiên mới hoàn toàn.`,
+  veryLongSession: (k) => `⚠ Phiên RẤT dài (${k}k chars) — model có thể chậm/lú. Khuyến nghị /compact ngay, hoặc /clear nếu task đã xong.`,
+  autoCompactTrigger: (k) => `Phiên đã đạt ${k}k chars — tự động tóm tắt để giữ model chạy mượt…`,
+  autoCompactDone: (bK, aK, pct) => `✓ Auto-compact: ${bK}k → ${aK}k chars (giảm ${pct}%). Trí nhớ dài hạn đã giữ lại trong session_summary.`,
+  autoCompactFail: "Auto-compact thất bại — bạn nên /clear hoặc /compact thủ công.",
   initRunning: "đang quét dự án & soạn noob.md…",
   initOverwriteWarn: (p) => `⚠ Đã có noob.md tại ${p}. /init sẽ ghi đè nội dung hiện tại.`,
   initOverwriteConfirm: "Ghi đè? gõ 'y' để xác nhận, phím khác để huỷ › ",

package/src/repl.js

@@ -3,11 +3,11 @@ import fs from "node:fs";
 import path from "node:path";
 import chalk from "chalk";
 import { createTui } from "./tui.js";
-import { runAgent } from "./agent.js";
+import { runAgent, maybeSummarize } from "./agent.js";
 import { runSubAgent, spawnAgentToolsDoc, MAX_SUBAGENT_DEPTH } from "./subagent.js";
 import { TokenMeter } from "./tokens.js";
 import { stream, usage, ApiError } from "./api.js";
-import { runTool, describe, DESTRUCTIVE } from "./tools.js";
+import { runTool, describe, DESTRUCTIVE, addRoot, listRoots } from "./tools.js";
 import { MODELS, PROVIDERS, findModel, providerColor, DEFAULT_MODEL } from "./models.js";
 import { c, banner, modelBadge, renderMarkdown, box } from "./ui.js";
 import { config } from "./config.js";
@@ -43,6 +43,7 @@ const SLASH = [
   { name: "/continue", desc: "tiếp tục phiên gần nhất" },
   { name: "/sessions", desc: "liệt kê phiên đã lưu" },
   { name: "/cwd", desc: "thư mục hiện tại" },
+  { name: "/add-dir", desc: "thêm thư mục ngoài cwd vào phạm vi" },
   { name: "/status", desc: "trạng thái" },
   { name: "/version", desc: "phiên bản" },
   { name: "/exit", desc: "thoát" },
@@ -132,6 +133,9 @@ export async function startRepl(opts = {}) {
     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?
     agentMode: false, // /agent on → cho phép spawn_agent / spawn_agents
+    extraRoots: [], // thư mục ngoài cwd được /add-dir cấp quyền (UX display only;
+                    // source of truth là extraRoots trong src/tools.js)
+    _longSessionWarned: false, // đã in cảnh báo phiên dài chưa (reset khi /clear)
   };
   const tokenMeter = new TokenMeter();
 
@@ -485,6 +489,35 @@ NGUYÊN TẮC:
     persist();
   }
 
+  // /compact — chủ động tóm tắt phiên ngay để gọn ngữ cảnh, giữ trí nhớ dài hạn.
+  // Khác /clear (xoá sạch) và khác auto-summarize (chỉ chạy khi vượt ngưỡng).
+  async function runCompact() {
+    if (!config.apiKey) return console.log(c.tool("  " + t.notLoggedIn));
+    if (!state.history?.length) return console.log(c.dim("  " + t.compactEmpty));
+    const beforeChars = state.history.reduce((a, m) => a + (typeof m.content === "string" ? m.content.length : 0), 0);
+    const beforeMsgs = state.history.length;
+    console.log(c.tool("  🗜  " + t.compactRunning));
+    tui.setBusy(true, t.compactRunning);
+    try {
+      const ok = await maybeSummarize(state.history, { model: state.model, force: true });
+      tui.setBusy(false);
+      if (!ok) {
+        console.log(c.dim("  " + t.compactSkipped));
+        return;
+      }
+      const afterChars = state.history.reduce((a, m) => a + (typeof m.content === "string" ? m.content.length : 0), 0);
+      const afterMsgs = state.history.length;
+      const saved = Math.max(0, beforeChars - afterChars);
+      const pct = beforeChars > 0 ? Math.round((saved / beforeChars) * 100) : 0;
+      console.log(c.ok("  ✓ " + t.compactDone(beforeMsgs, afterMsgs, Math.round(beforeChars / 1000), Math.round(afterChars / 1000), pct)));
+      state._longSessionWarned = false; // reset để có thể cảnh báo lại nếu lại phình
+      persist();
+    } catch (err) {
+      tui.setBusy(false);
+      printError(err);
+    }
+  }
+
   function showMemory() {
     const mem = loadMemory();
     if (!mem) return console.log(c.dim("  " + t.memoryEmpty(memoryPath())));
@@ -601,11 +634,17 @@ NGUYÊN TẮC:
     // spinner: status hiển thị qua tui (thanh dưới), tui tự animate khung xoay
     const t0 = Date.now();
     let timer = null;
-    const tick = (label) => {
+    // Tách label (status) và meta (elapsed+tokens):
+    // - status có thể bị reset (vd. lúc xin permission, lúc đang in answer)
+    // - meta đi qua setMeta, vẫn hiện trong busy bar nền dù status null
+    // Nhờ vậy người dùng LUÔN thấy đồng hồ + token đang chạy, kể cả khi treo chờ y/n.
+    const tickMeta = () => {
       const elapsed = ((Date.now() - t0) / 1000).toFixed(0);
-      // Chèn token usage realtime (↑input ↓output) ngay cạnh spinner để người
-      // dùng thấy được số token đang cộng dồn trong khi model stream.
-      tui.status(c.dim(`${label}… ${elapsed}s · ${tokenMeter.format()}`));
+      tui.setMeta(`${elapsed}s · ${tokenMeter.format()}`);
+    };
+    const tick = (label) => {
+      tui.status(c.dim(`${label}…`));
+      tickMeta();
     };
     const stopSpin = () => {
       if (timer) {
@@ -613,9 +652,10 @@ NGUYÊN TẮC:
         timer = null;
       }
       tui.status(null);
+      // KHÔNG reset meta ở đây — để token+elapsed vẫn hiện qua setBusy/busyMeta
+      // cho tới khi setBusy(false) ở finally tự dọn.
     };
     const startSpin = (label) => {
-      // (tui hiện status khi tick gọi)
       if (!timer) timer = setInterval(() => tick(label), 200);
     };
 
@@ -630,8 +670,10 @@ NGUYÊN TẮC:
           message: text,
           signal: abort.signal,
           onStatus: (s) => {
-            // Kèm token meter để nhánh merge/search cũng thấy ↑input ↓output realtime.
-            if (!printer.started) tui.status(c.dim(`  ${s} · ${tokenMeter.format()}`));
+            // Status label đi qua tui.status; token+elapsed đi qua setMeta (vẫn hiện
+            // dù printer đã bắt đầu vì busyMeta nằm trên busy bar nền).
+            if (!printer.started) tui.status(c.dim(`  ${s}`));
+            tickMeta();
           },
           onDelta: (d) => {
             stopSpin();
@@ -735,6 +777,55 @@ NGUYÊN TẮC:
     } finally {
       abort = null;
       tui.setBusy(false);
+      // Cảnh báo phiên dài: in một lần khi tổng chars vượt ~2× ngưỡng summarize
+      // (60k trong agent.js). Tự maybeSummarize đã chạy bên trong, nhưng người
+      // dùng có thể muốn /clear chủ động cho gọn ngữ cảnh + tốc độ.
+      try {
+        const totalChars = state.history.reduce(
+          (a, m) => a + (typeof m.content === "string" ? m.content.length : JSON.stringify(m.content || "").length),
+          0,
+        );
+        const k = Math.round(totalChars / 1000);
+        // Mốc 3 (240k+): TỰ ĐỘNG compact — không hỏi, không chờ user. Mục tiêu là
+        // giữ model chạy mượt khi user mải làm việc, không để phiên phình mãi.
+        // Dùng cờ _autoCompacting chống re-entrant (nếu compact lâu, lượt sau
+        // tới trước khi xong thì bỏ qua).
+        if (totalChars > 240000 && !state._autoCompacting) {
+          state._autoCompacting = true;
+          console.log(c.accent("  ⚡ " + t.autoCompactTrigger(k)));
+          tui.setBusy(true, t.compactRunning);
+          try {
+            const ok = await maybeSummarize(state.history, { model: state.model, force: true });
+            tui.setBusy(false);
+            if (ok) {
+              const afterChars = state.history.reduce(
+                (a, m) => a + (typeof m.content === "string" ? m.content.length : 0),
+                0,
+              );
+              const aK = Math.round(afterChars / 1000);
+              const pct = totalChars > 0 ? Math.round(((totalChars - afterChars) / totalChars) * 100) : 0;
+              console.log(c.ok("  " + t.autoCompactDone(k, aK, pct)));
+              state._longSessionWarned = false;
+              persist();
+            } else {
+              console.log(c.err("  " + t.autoCompactFail));
+            }
+          } catch (e) {
+            tui.setBusy(false);
+            console.log(c.err("  " + t.autoCompactFail));
+          } finally {
+            state._autoCompacting = false;
+          }
+        } else if (totalChars > 200000) {
+          // Mốc 2 (200k–240k): cảnh báo mạnh, in lại mỗi lượt.
+          console.log(c.err("  " + t.veryLongSession(k)));
+          state._longSessionWarned = true;
+        } else if (totalChars > 120000 && !state._longSessionWarned) {
+          // Mốc 1 (120k+): nhắc nhẹ một lần.
+          console.log(c.dim("  ⓘ " + t.longSession(k)));
+          state._longSessionWarned = true;
+        }
+      } catch {}
     }
   }
 
@@ -860,6 +951,9 @@ NGUYÊN TẮC:
       case "learn":
         await runLearn(arg);
         break;
+      case "compact":
+        await runCompact();
+        break;
       case "memory":
       case "mem":
         showMemory();
@@ -881,6 +975,7 @@ NGUYÊN TẮC:
       case "new":
         persist(); // giữ lại phiên cũ trên đĩa
         state.history = [];
+        state._longSessionWarned = false; // reset cờ cảnh báo phiên dài
         startFresh(); // phiên mới (phiên cũ vẫn resume được)
         if (!tui.tty) console.clear();
         banner();
@@ -908,6 +1003,28 @@ NGUYÊN TẮC:
       case "cwd":
         console.log(c.dim("  " + process.cwd()));
         break;
+      case "adddir":
+      case "add-dir": {
+        if (!arg) {
+          // Không arg → liệt kê roots hiện tại (cwd + các thư mục đã /add-dir).
+          const roots = listRoots();
+          console.log(c.dim("  Phạm vi truy cập:"));
+          for (const r of roots) {
+            const isCwd = r === process.cwd();
+            console.log("  " + (isCwd ? c.accent("• ") : c.ok("+ ")) + r + (isCwd ? c.dim("  (cwd)") : ""));
+          }
+          console.log(c.dim("  Dùng: /add-dir <đường-dẫn>"));
+          break;
+        }
+        try {
+          const full = addRoot(path.resolve(process.cwd(), arg));
+          if (!state.extraRoots.includes(full)) state.extraRoots.push(full);
+          console.log(c.ok("  ✓ ") + c.dim("đã thêm vào phạm vi: ") + full);
+        } catch (e) {
+          console.log(c.err("  ✗ ") + (e?.message || String(e)));
+        }
+        break;
+      }
       case "status":
         printStatus(state);
         break;
@@ -978,8 +1095,16 @@ NGUYÊN TẮC:
       s.mode === "merge" ? c.tool("Merge AI") : s.mode === "search" ? c.accent("Tìm web") : modelBadge(s.model);
     const key = config.apiKey ? c.ok(" 🔑") : c.err(" 🔒");
     const yolo = s.yolo ? c.err("  ⚡ yolo: BẬT") : c.dim("  yolo: tắt");
+    // Size phiên — màu đổi theo mức: dim < 60k, tool 60-120k, accent 120-200k, err > 200k.
+    const totalChars = (s.history || []).reduce(
+      (a, m) => a + (typeof m.content === "string" ? m.content.length : 0),
+      0,
+    );
+    const k = Math.round(totalChars / 1000);
+    const sizeColor = totalChars > 200000 ? c.err : totalChars > 120000 ? c.accent : totalChars > 60000 ? c.tool : c.dim;
+    const size = sizeColor(`  ctx: ${k}k`);
     console.log(
-      "  " + mode + key + yolo + c.dim("  v" + CURRENT) + c.dim("  thư mục: " + shortCwd()),
+      "  " + mode + key + yolo + size + c.dim("  v" + CURRENT) + c.dim("  thư mục: " + shortCwd()),
     );
   }
 }
@@ -1093,7 +1218,9 @@ function printHelp() {
         "  " + t.cmdKarpathy,
         "  " + t.cmdUltra,
         "  " + t.cmdLearn,
+        "  " + t.cmdCompact,
         "  " + t.cmdMemory,
+        "  " + t.cmdAddDir,
         "  " + t.cmdLogin,
         "  " + t.cmdLogout,
         "  " + t.cmdUsage,

package/src/subagent.js

@@ -32,7 +32,13 @@ Ví dụ phân cấp: cha giao "build full app" → đẻ 1 sub-agent "build bac
 // Chạy một sub-agent. dispatchTool: hàm để thực thi tool con (chia sẻ với cha).
 // model: dùng chung model của cha. onLog: callback để log tiến độ ra UI cha.
 export async function runSubAgent({ task, context, model, signal, dispatchTool, depth = 1, onLog, tokenMeter }) {
-  const sys = `Bạn là SUB-AGENT (depth=${depth}) được agent cha ủy thác MỘT nhiệm vụ cụ thể. Làm xong → trả lời NGẮN GỌN bằng Markdown tóm tắt KẾT QUẢ (file đã đụng, phát hiện, lỗi nếu có). Không tán gẫu. Không hỏi lại cha — tự quyết với thông tin được cấp.
+  const sys = `Bạn là SUB-AGENT (depth=${depth}) được agent cha ủy thác MỘT nhiệm vụ cụ thể.
+
+# Cách làm việc
+- Tự quyết với thông tin được cấp + tự khám phá filesystem (list_dir/glob/grep/read_file). KHÔNG hỏi lại cha.
+- History của bạn TÁCH BIỆT với cha. Cha CHỈ thấy chuỗi trả lời cuối của bạn → hãy là một bản tóm tắt cô đọng (mục tiêu 1–2k token): mọi file đã đụng, phát hiện then chốt, lỗi/cảnh báo, và các đầu mối cha cần để hành động tiếp. Bỏ chi tiết quá trình thừa.
+- Làm điều nhỏ nhất giải quyết trọn vẹn nhiệm vụ. Không drive-by refactor.
+- Verify khi hợp lý (chạy build/test/lint). Báo trung thực phần đã/chưa verify.
 
 # NHIỆM VỤ
 ${task}

package/src/tokens.js

@@ -25,33 +25,64 @@ export function countMessages(messages = []) {
 
 // Bộ đếm cộng dồn cho 1 phiên: input (prompt gửi đi) + output (text stream về).
 // Hỗ trợ cộng dồn theo delta để hiển thị realtime trong lúc stream.
+//
+// Vấn đề cũ: pushOutputDelta encode TOÀN buffer mỗi delta → O(N²) trên stream dài.
+// Fix: sliding window. BPE chỉ phụ thuộc context cục bộ (vài chục byte) nên ta
+// chỉ cần encode đoạn TAIL gần đây, phần trước đó "commit" dứt khoát. Safety
+// window đủ rộng (256 chars) để qua mọi ranh giới token thực tế của cl100k_base
+// (token dài nhất ~ vài chục byte).
+const TAIL_WINDOW = 256;
+
 export class TokenMeter {
   constructor() {
     this.input = 0;
     this.output = 0;
-    this._outBuf = ""; // gom delta để đếm theo batch (đỡ tốn CPU)
-    this._outBufN = 0; // số token đã đếm từ _outBuf (để cộng dồn chính xác)
+    // Phần đầu output đã "commit" — không đụng vào nữa.
+    this._committedChars = 0; // số ký tự đã đẩy qua khỏi tail window
+    this._committedTokens = 0; // tổng token tương ứng đã cộng vào this.output
+    // Tail buffer: TAIL_WINDOW ký tự cuối, dùng để re-encode khi có delta mới.
+    this._tail = "";
+    this._tailTokens = 0; // token count hiện tại của _tail (đã cộng vào this.output)
   }
   addInput(n) {
     this.input += Math.max(0, n | 0);
   }
-  // Mỗi delta text từ stream: gom vào buffer, định kỳ encode lại để cập nhật
-  // số token. Encode toàn buffer thay vì delta riêng lẻ → chính xác hơn (BPE
-  // gộp các byte qua ranh giới delta).
+  // Mỗi delta text từ stream: append vào tail, re-encode CHỈ tail (không toàn buffer).
+  // Nếu tail vượt 2×TAIL_WINDOW → commit nửa đầu, giữ lại nửa sau.
   pushOutputDelta(text) {
     if (!text) return;
-    this._outBuf += text;
-    // Re-encode toàn bộ buffer hiện tại; cập nhật delta vào this.output.
-    const total = countTokens(this._outBuf);
-    if (total > this._outBufN) {
-      this.output += total - this._outBufN;
-      this._outBufN = total;
+    this._tail += text;
+    // Re-encode tail → cập nhật phần token của tail.
+    const newTailTokens = countTokens(this._tail);
+    this.output += newTailTokens - this._tailTokens;
+    this._tailTokens = newTailTokens;
+    // Nếu tail quá lớn, commit nửa đầu để giữ tail bounded.
+    // Cắt tại ranh giới whitespace gần TAIL_WINDOW — BPE align tốt ở đây nên
+    // sai số head+tail vs encode liền mạch ≈ 0 (thay vì +1 token mỗi cut).
+    if (this._tail.length > TAIL_WINDOW * 2) {
+      let cutAt = this._tail.length - TAIL_WINDOW;
+      // Lùi cutAt về ranh giới whitespace gần nhất (tối đa 64 chars).
+      const minCut = Math.max(0, cutAt - 64);
+      while (cutAt > minCut && !/\s/.test(this._tail[cutAt])) cutAt--;
+      const head = this._tail.slice(0, cutAt);
+      const newTail = this._tail.slice(cutAt);
+      const headTokens = countTokens(head);
+      const newTailTokensAfterCut = countTokens(newTail);
+      // Điều chỉnh this.output để giữ tổng nhất quán với re-encode rời.
+      const delta = headTokens + newTailTokensAfterCut - this._tailTokens;
+      this.output += delta;
+      this._committedChars += head.length;
+      this._committedTokens += headTokens;
+      this._tail = newTail;
+      this._tailTokens = newTailTokensAfterCut;
     }
   }
   // Kết thúc một lượt output → reset buffer (bắt đầu lượt mới).
   endOutput() {
-    this._outBuf = "";
-    this._outBufN = 0;
+    this._committedChars = 0;
+    this._committedTokens = 0;
+    this._tail = "";
+    this._tailTokens = 0;
   }
   get total() {
     return this.input + this.output;
@@ -64,7 +95,9 @@ export class TokenMeter {
   reset() {
     this.input = 0;
     this.output = 0;
-    this._outBuf = "";
-    this._outBufN = 0;
+    this._committedChars = 0;
+    this._committedTokens = 0;
+    this._tail = "";
+    this._tailTokens = 0;
   }
 }

package/src/tools.js

@@ -5,8 +5,65 @@ import { spawn } from "node:child_process";
 
 const MAX_OUT = 30000; // hard cap on any tool result fed back to the model
 const cwd = () => process.cwd();
-const abs = (p) => path.resolve(cwd(), p);
+
+// Các thư mục ngoài cwd được user cấp quyền qua /add-dir. Path tool sẽ chấp
+// nhận nếu nó nằm trong cwd HOẶC trong một extra root. Source of truth ở đây.
+const extraRoots = new Set();
+export function addRoot(p) {
+  if (!p) throw new Error("thiếu path");
+  const full = path.resolve(p);
+  let st;
+  try { st = fssync.statSync(full); } catch { throw new Error("không tồn tại: " + p); }
+  if (!st.isDirectory()) throw new Error("không phải thư mục: " + p);
+  extraRoots.add(full);
+  return full;
+}
+export function listRoots() {
+  return [cwd(), ...extraRoots];
+}
+function within(root, full) {
+  if (full === root) return true;
+  const rel = path.relative(root, full);
+  return !!rel && !rel.startsWith("..") && !path.isAbsolute(rel);
+}
+
+const abs = (p) => {
+  if (!p) return cwd();
+  // Path tuyệt đối: chấp nhận nếu nằm trong cwd hoặc một extra root, không thì
+  // ném lỗi rõ ràng (tools dưới sẽ propagate cho LLM).
+  if (path.isAbsolute(p)) {
+    const full = path.resolve(p);
+    if (within(cwd(), full)) return full;
+    for (const r of extraRoots) if (within(r, full)) return full;
+    throw new Error("path nằm ngoài phạm vi (cwd + /add-dir): " + p);
+  }
+  // Tương đối: ưu tiên cwd; nếu thoát cwd thì thử từng extra root.
+  const full = path.resolve(cwd(), p);
+  if (within(cwd(), full)) return full;
+  for (const r of extraRoots) {
+    const fr = path.resolve(r, p);
+    if (within(r, fr)) return fr;
+  }
+  throw new Error("path nằm ngoài phạm vi (cwd + /add-dir): " + p);
+};
 const rel = (p) => path.relative(cwd(), p) || ".";
+// Tên rút gọn để hiển thị: nếu path thuộc cwd → relative cwd; nếu thuộc một
+// extra root → "<rootName>/<rel>" để user phân biệt được; còn lại fallback path tuyệt đối.
+function displayPath(full) {
+  if (within(cwd(), full)) return path.relative(cwd(), full) || ".";
+  for (const r of extraRoots) {
+    if (within(r, full)) {
+      const sub = path.relative(r, full);
+      return sub ? path.basename(r) + path.sep + sub : path.basename(r);
+    }
+  }
+  return full;
+}
+function relFrom(root, full) {
+  return path.relative(root, full) || ".";
+}
+// Thư mục bỏ qua khi walk (glob/grep). node_modules + các thư mục build/cache phổ biến.
+const SKIP_DIRS = new Set(["node_modules", ".next", "dist", "build", ".venv", "venv", "__pycache__", ".cache", ".turbo", ".parcel-cache", "target"]);
 
 function clip(s) {
   if (s.length <= MAX_OUT) return s;
@@ -29,8 +86,16 @@ function killBgTree(child) {
   } catch {}
 }
 // Đừng để tiến trình nền sống mồ côi sau khi CLI thoát.
-process.on("exit", () => {
+// - 'exit' bắt được normal exit + process.exit() (gồm cả nhánh Ctrl+C lần 2 ở repl).
+// - SIGTERM mặc định KHÔNG trigger 'exit' → process chết im, bg leak. Bắt riêng.
+// - SIGINT đã có handler ở repl.js, không đụng vào để không phá UX "Ctrl+C lần 1 = abort".
+function cleanupBg() {
   for (const p of bg.values()) killBgTree(p.child);
+}
+process.on("exit", cleanupBg);
+process.on("SIGTERM", () => {
+  cleanupBg();
+  process.exit(143);
 });
 
 export const TOOLS = {
@@ -74,7 +139,9 @@ export const TOOLS = {
       if (count === 0) continue;
       if (count > 1 && !replace_all)
         throw new Error(`old_string is not unique (${count} matches) in ${rel(file)}; set replace_all, or add surrounding lines to make it unique`);
-      await fs.writeFile(file, applyExact(cand, cand === old_string ? new_string : adapt(new_string)), "utf8");
+      // LUÔN adapt new_string về line ending của file (kể cả khi cand match raw old_string),
+      // tránh tạo file mix CRLF/LF làm git/editor hiển thị diff lạ → user tưởng 'Edited nhưng không apply'.
+      await fs.writeFile(file, applyExact(cand, adapt(new_string)), "utf8");
       return `Edited ${rel(file)} (${replace_all ? count : 1} replacement(s))`;
     }
 
@@ -109,29 +176,48 @@ export const TOOLS = {
   async glob({ pattern }) {
     const hits = [];
     const rx = globToRegExp(pattern);
-    (function walk(dir) {
-      let ents;
-      try {
-        ents = fssync.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);
-        else if (rx.test(rel(full).split(path.sep).join("/"))) hits.push(rel(full));
-        if (hits.length > 500) return;
-      }
-    })(cwd());
+    const roots = listRoots();
+    for (const root of roots) {
+      (function walk(dir) {
+        let ents;
+        try {
+          ents = fssync.readdirSync(dir, { withFileTypes: true });
+        } catch {
+          return;
+        }
+        for (const e of ents) {
+          if (SKIP_DIRS.has(e.name) || e.name.startsWith(".git")) continue;
+          const full = path.join(dir, e.name);
+          if (e.isDirectory()) walk(full);
+          else if (rx.test(relFrom(root, full).split(path.sep).join("/"))) hits.push(displayPath(full));
+          if (hits.length > 500) return;
+        }
+      })(root);
+      if (hits.length > 500) break;
+    }
     return hits.length ? clip(hits.join("\n")) : "No files matched.";
   },
 
-  async grep({ pattern, path: p = ".", glob: g }) {
+  async grep({ pattern, path: p, glob: g }) {
     const rx = new RegExp(pattern, "i");
     const gRx = g ? globToRegExp(g) : null;
     const out = [];
-    (function walk(dir) {
+    function scanFile(full) {
+      const disp = displayPath(full);
+      const relp = disp.split(path.sep).join("/");
+      if (gRx && !gRx.test(relp)) return;
+      let txt;
+      try {
+        txt = fssync.readFileSync(full, "utf8");
+      } catch {
+        return;
+      }
+      if (txt.includes("\u0000")) return; // skip binary files
+      txt.split("\n").forEach((l, idx) => {
+        if (rx.test(l) && out.length < 200) out.push(`${relp}:${idx + 1}: ${l.trim().slice(0, 200)}`);
+      });
+    }
+    function walkDir(dir) {
       let ents;
       try {
         ents = fssync.readdirSync(dir, { withFileTypes: true });
@@ -139,26 +225,28 @@ export const TOOLS = {
         return;
       }
       for (const e of ents) {
-        if (e.name === "node_modules" || e.name.startsWith(".git")) continue;
+        if (SKIP_DIRS.has(e.name) || e.name.startsWith(".git")) continue;
         const full = path.join(dir, e.name);
         if (e.isDirectory()) {
-          walk(full);
-          continue;
-        }
-        const relp = rel(full).split(path.sep).join("/");
-        if (gRx && !gRx.test(relp)) continue;
-        let txt;
-        try {
-          txt = fssync.readFileSync(full, "utf8");
-        } catch {
+          walkDir(full);
           continue;
         }
-        if (txt.includes("\u0000")) continue; // skip binary files
-        txt.split("\n").forEach((l, idx) => {
-          if (rx.test(l) && out.length < 200) out.push(`${relp}:${idx + 1}: ${l.trim().slice(0, 200)}`);
-        });
+        scanFile(full);
       }
-    })(abs(p));
+    }
+    // Không truyền path → quét cwd + tất cả extra roots. Có path → chỉ vùng đó.
+    if (p == null || p === "" || p === ".") {
+      for (const root of listRoots()) walkDir(root);
+    } else {
+      let st;
+      try {
+        st = fssync.statSync(abs(p));
+      } catch {
+        return "No matches.";
+      }
+      if (st.isFile()) scanFile(abs(p));
+      else walkDir(abs(p));
+    }
     return out.length ? clip(out.join("\n")) : "No matches.";
   },
 

package/src/tui.js

@@ -54,6 +54,7 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
       print() {},
       status() {},
       setBusy() {},
+      setMeta() {},
       setPrompt() {},
       read() {
         if (queue.length) return Promise.resolve(queue.shift());
@@ -79,7 +80,7 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
   // LUÔN thấy rõ "đang chạy", không bị tưởng treo.
   let busy = false;
   let busyLabel = "";
-  let busyStartedAt = 0; // mốc thời gian để hiển thị elapsed
+  let busyMeta = ""; // chuỗi phụ (elapsed + token) repl đẩy vào qua setMeta()
   let frame = 0;
   let frameTimer = null;
   let prevRows = 0;
@@ -160,9 +161,31 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
     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");
+    if (liveOut) {
+      // Khi đang stream prose mà busy, ghép meta (elapsed+token) vào cuối liveOut
+      // để user vẫn thấy phiên đang sống — không bị che status bar.
+      if (busy && busyMeta) {
+        const meta = c.dim(" · " + busyMeta);
+        const budget = Math.max(0, cols() - visLen(meta));
+        const head = liveOut.length > budget ? liveOut.slice(0, budget) : liveOut;
+        return head + meta;
+      }
+      return liveOut.slice(0, cols());
+    }
+    const spin = FRAMES[frame % FRAMES.length];
+    // Khi busy, LUÔN hiện elapsed+tokens (busyMeta) cạnh statusText/busyLabel để
+    // người dùng thấy phiên đang sống — kể cả lúc model im giữa các bước.
+    if (statusText) {
+      const meta = busy && busyMeta ? c.dim(" · " + busyMeta) : "";
+      const tail = busy ? c.dim(" · Ctrl+C để dừng") : "";
+      const line = c.dim(spin + " ") + statusText + meta + tail;
+      return line.length > cols() ? line.slice(0, cols()) : line;
+    }
+    if (busy) {
+      const meta = busyMeta ? " · " + busyMeta : "";
+      const line = c.dim(spin + " " + (busyLabel || "đang chạy") + meta + " · Ctrl+C để dừng");
+      return line.length > cols() ? line.slice(0, cols()) : line;
+    }
     return null;
   }
   function menuRows() {
@@ -455,8 +478,17 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
     setBusy(on, label) {
       busy = !!on;
       if (label != null) busyLabel = label;
+      if (!on) busyMeta = ""; // reset meta khi tắt busy để lượt sau không carry số cũ
       draw();
     },
+    setMeta(meta) {
+      // repl bơm chuỗi phụ (vd: "12s · ↑1.2k ↓340 (1.5k)") để status bar hiện
+      // realtime kể cả khi model im giữa các bước.
+      const next = meta || "";
+      if (next === busyMeta) return;
+      busyMeta = next;
+      if (busy) draw();
+    },
     setPrompt(label) {
       promptLabel = label || "";
       draw();