@noobdemon/noob-cli 1.10.20 → 1.11.0

package/src/agent.js

@@ -1,9 +1,9 @@
-import os from "node:os";
-import { stream } from "./api.js";
-import { loadMemory, memoryStats } from "./memory.js";
-import { listRoots } from "./tools.js";
-import { t } from "./i18n.js";
-import { countTokens } from "./tokens.js";
+import os from 'node:os';
+import { stream } from './api.js';
+import { loadMemory, memoryStats } from './memory.js';
+import { listRoots } from './tools.js';
+import { t } from './i18n.js';
+import { countTokens } from './tokens.js';
 
 const SYSTEM = `You are noob, an agentic coding assistant in the spirit of Claude Code. You help with software engineering tasks by reading and editing files and running commands in the user's current working directory.
 
@@ -130,7 +130,7 @@ const HIGH_PATTERNS = [
 ];
 
 export function classifyEffort(userMessage) {
-  return "high";
+  return 'high';
 }
 
 // Số bước tool tối đa cho một lượt. Đặt rất cao theo yêu cầu người dùng: task
@@ -155,24 +155,24 @@ const SUMMARIZE_THRESHOLD_CHARS = 1000000; // ~250k tokens (83% window) — summ
 // nuốt mất. KHÔNG paraphrase goal — giữ nguyên text user gõ.
 function goalBlock(goal) {
   return [
-    "# HARD GOAL (set via /goal — BINDING)",
-    "Người dùng đã đặt MỤC TIÊU CỐT LÕI cho phiên này. Mọi lượt phản hồi/hành động PHẢI hướng tới việc hoàn thành goal này. KHÔNG được tuyên bố xong khi goal chưa thực sự đạt (chống agentic laziness). KHÔNG được trôi sang việc khác làm goal lu mờ (chống goal drift). Nếu user hỏi việc nhỏ trung gian, làm xong rồi quay lại goal.",
-    "",
-    "GOAL: " + goal.trim(),
-    "",
+    '# HARD GOAL (set via /goal — BINDING)',
+    'Người dùng đã đặt MỤC TIÊU CỐT LÕI cho phiên này. Mọi lượt phản hồi/hành động PHẢI hướng tới việc hoàn thành goal này. KHÔNG được tuyên bố xong khi goal chưa thực sự đạt (chống agentic laziness). KHÔNG được trôi sang việc khác làm goal lu mờ (chống goal drift). Nếu user hỏi việc nhỏ trung gian, làm xong rồi quay lại goal.',
+    '',
+    'GOAL: ' + goal.trim(),
+    '',
     "Trước khi reply 'đã xong' / kết thúc phiên ULTRA / phát token hoàn thành, tự hỏi: goal trên đã ĐẠT chưa? Nếu chưa, làm tiếp.",
-  ].join("\n");
+  ].join('\n');
 }
 
 // Môi trường chạy thực: model cần biết OS + shell để emit lệnh ĐÚNG. Không có
 // khối này, trên Windows model hay emit lệnh Unix (wc/ls/cat/grep) → run_command
 // (PowerShell) báo lỗi.
 function runtimeContext() {
-  const isWin = process.platform === "win32";
+  const isWin = process.platform === 'win32';
   const lines = [
-    "# ENVIRONMENT",
+    '# ENVIRONMENT',
     `- OS: ${process.platform} (${os.release()})`,
-    `- Shell for run_command: ${isWin ? "Windows PowerShell (powershell.exe)" : "bash"}`,
+    `- Shell for run_command: ${isWin ? 'Windows PowerShell (powershell.exe)' : 'bash'}`,
     `- Workspace (cwd): ${process.cwd()}`,
   ];
   // Phạm vi truy cập filesystem. Model mặc định CHỈ được chạm cwd + các folder
@@ -183,26 +183,30 @@ function runtimeContext() {
   try {
     const roots = listRoots();
     const extras = roots.slice(1); // [0] là cwd
-    lines.push(`- Filesystem scope: workspace + ${extras.length} extra root(s)${extras.length ? ":" : " (chỉ workspace)."}`);
+    lines.push(
+      `- Filesystem scope: workspace + ${extras.length} extra root(s)${extras.length ? ':' : ' (chỉ workspace).'}`
+    );
     for (const r of extras) lines.push(`  • ${r}`);
     lines.push(
-      `- Nếu cần folder NGOÀI scope: dùng path tuyệt đối trong tool call — repl sẽ hỏi user, nếu duyệt folder tự được thêm + persist theo workspace.`,
+      `- Nếu cần folder NGOÀI scope: dùng path tuyệt đối trong tool call — repl sẽ hỏi user, nếu duyệt folder tự được thêm + persist theo workspace.`
     );
   } catch {}
   if (isWin) {
     lines.push(
-      "- IMPORTANT: run_command runs in PowerShell on Windows — do NOT use Unix tools.",
-      "  Use: Get-Content (not cat), Get-ChildItem (not ls), Select-String (not grep),",
-      "  (Get-Content f | Measure-Object -Line) (not wc -l). Paths use backslashes.",
-      "- Trên Windows, script chạy bằng `script.bat` hoặc `script.cmd`, KHÔNG dùng `./script` (Unix).",
-      "  VD: gradlew → gradlew.bat, mvnw → mvnw.cmd.",
-      "- Prefer the dedicated tools (read_file / list_dir / grep / glob) over shell commands;",
-      "  they are cross-platform. Use run_command mainly for builds/tests/installs.",
+      '- IMPORTANT: run_command runs in PowerShell on Windows — do NOT use Unix tools.',
+      '  Use: Get-Content (not cat), Get-ChildItem (not ls), Select-String (not grep),',
+      '  (Get-Content f | Measure-Object -Line) (not wc -l). Paths use backslashes.',
+      '- Trên Windows, script chạy bằng `script.bat` hoặc `script.cmd`, KHÔNG dùng `./script` (Unix).',
+      '  VD: gradlew → gradlew.bat, mvnw → mvnw.cmd.',
+      '- Prefer the dedicated tools (read_file / list_dir / grep / glob) over shell commands;',
+      '  they are cross-platform. Use run_command mainly for builds/tests/installs.'
     );
   } else {
-    lines.push("- Prefer the dedicated tools (read_file/list_dir/grep/glob) over shell when possible.");
+    lines.push(
+      '- Prefer the dedicated tools (read_file/list_dir/grep/glob) over shell when possible.'
+    );
   }
-  return lines.join("\n");
+  return lines.join('\n');
 }
 
 // Lược ngữ cảnh để không vượt context khi phiên dài. KHÔNG đụng vào history thật
@@ -210,7 +214,7 @@ function runtimeContext() {
 // Nếu history đã có summary (do summarizeHistory ghi vào _summary), dùng làm head.
 // Exported cho test (scripts/test-compact.js) — không dùng ngoài file này.
 export function compact(history, budget) {
-  const len = (m) => (m.content || "").length + 24;
+  const len = (m) => (m.content || '').length + 24;
   let total = history.reduce((s, m) => s + len(m), 0);
   if (total <= budget) return history;
   const out = history.map((m) => ({ ...m }));
@@ -218,12 +222,12 @@ export function compact(history, budget) {
   // nhất (đọc file lớn) và model đã xử lý xong rồi.
   // SKIP session_summary — đó là bộ nhớ dài hạn, không phải tool result cồng kềnh.
   const toolIdx = out
-    .map((m, i) => (m.role === "tool" && m.name !== "session_summary" ? i : -1))
+    .map((m, i) => (m.role === 'tool' && m.name !== 'session_summary' ? i : -1))
     .filter((i) => i >= 0);
   for (const i of toolIdx.slice(0, Math.max(0, toolIdx.length - 5))) {
     if (total <= budget) break;
     const before = len(out[i]);
-    out[i].content = "[kết quả công cụ cũ đã được lược bớt để tiết kiệm ngữ cảnh]";
+    out[i].content = '[kết quả công cụ cũ đã được lược bớt để tiết kiệm ngữ cảnh]';
     total -= before - len(out[i]);
   }
   if (total <= budget) return out;
@@ -231,14 +235,18 @@ export function compact(history, budget) {
   // do maybeSummarize() chèn) + USER đầu tiên (nhiệm vụ gốc) + 12 message gần
   // nhất. KHÔNG BỎ session_summary — đó là bộ nhớ phiên, mất nó là mất hết.
   const summaryIdx = out
-    .map((m, i) => (m.role === "tool" && m.name === "session_summary" ? i : -1))
+    .map((m, i) => (m.role === 'tool' && m.name === 'session_summary' ? i : -1))
     .filter((i) => i >= 0);
-  const firstUser = out.findIndex((m) => m.role === "user");
+  const firstUser = out.findIndex((m) => m.role === 'user');
   const headIndices = new Set([...summaryIdx, ...(firstUser >= 0 ? [firstUser] : [])]);
   const head = [...headIndices].sort((a, b) => a - b).map((i) => out[i]);
   const maxHeadIdx = head.length ? Math.max(...headIndices) : -1;
   const tailStart = Math.max(maxHeadIdx + 1, out.length - 12);
-  const elided = { role: "tool", name: "context", content: "[… các lượt trước đã được lược bớt …]" };
+  const elided = {
+    role: 'tool',
+    name: 'context',
+    content: '[… các lượt trước đã được lược bớt …]',
+  };
   return [...head, elided, ...out.slice(tailStart)];
 }
 
@@ -257,10 +265,12 @@ export async function maybeSummarize(history, { model, signal, force = 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);
   const tail = history.slice(history.length - keepTail);
-  const transcript = head.map((m) => {
-    const role = m.role === "tool" ? `TOOL(${m.name || "?"})` : m.role.toUpperCase();
-    return `## ${role}\n${(m.content || "").slice(0, 2000)}`;
-  }).join("\n\n");
+  const transcript = head
+    .map((m) => {
+      const role = m.role === 'tool' ? `TOOL(${m.name || '?'})` : m.role.toUpperCase();
+      return `## ${role}\n${(m.content || '').slice(0, 2000)}`;
+    })
+    .join('\n\n');
   const ask = `Tóm tắt phần hội thoại sau thành BẢN GHI NGẮN GỌN (~25-40 dòng, tiếng Việt) để bạn — chính bạn — đọc lại sau và tiếp tục công việc mà không quên ngữ cảnh quan trọng.
 
 BẮT BUỘC giữ lại:
@@ -289,13 +299,13 @@ LOẠI BỎ: chi tiết nội dung file đọc được, output dài của tool,
 --- HỘI THOẠI CẦN TÓM TẮT ---
 ${transcript}`;
   try {
-    const { text } = await stream({ mode: "chat", model, message: ask, signal });
-    const summary = (text || "").trim();
+    const { text } = await stream({ mode: 'chat', model, message: ask, signal });
+    const summary = (text || '').trim();
     if (!summary || summary.length < 50) return false;
     // Thay head bằng MỘT message tool tên "session_summary".
     const summaryMsg = {
-      role: "tool",
-      name: "session_summary",
+      role: 'tool',
+      name: 'session_summary',
       content: `[BỘ NHỚ DÀI HẠN — tóm tắt ${head.length} lượt đầu để không quên ngữ cảnh]\n\n${summary}`,
     };
     history.splice(0, history.length, summaryMsg, ...tail);
@@ -313,16 +323,19 @@ ${transcript}`;
 export function filesLedger(history) {
   const touched = new Map(); // path -> "đã ghi" | "đã sửa"
   for (const m of history) {
-    if (m.role !== "tool" || typeof m.content !== "string" || m.content.startsWith("ERROR")) continue;
+    if (m.role !== 'tool' || typeof m.content !== 'string' || m.content.startsWith('ERROR'))
+      continue;
     let mm;
-    if (m.name === "write_file" && (mm = m.content.match(/ to (.+)$/m))) touched.set(mm[1].trim(), "đã ghi");
-    else if (m.name === "edit_file" && (mm = m.content.match(/^Edited (.+?) \(/m))) touched.set(mm[1].trim(), "đã sửa");
+    if (m.name === 'write_file' && (mm = m.content.match(/ to (.+)$/m)))
+      touched.set(mm[1].trim(), 'đã ghi');
+    else if (m.name === 'edit_file' && (mm = m.content.match(/^Edited (.+?) \(/m)))
+      touched.set(mm[1].trim(), 'đã sửa');
   }
   if (!touched.size)
-    return "# FILES CHANGED THIS SESSION: none.\nYou have NOT created or modified any file yet. Do not claim otherwise — to change a file you MUST emit write_file/edit_file. Describing a change in prose does nothing.";
+    return '# FILES CHANGED THIS SESSION: none.\nYou have NOT created or modified any file yet. Do not claim otherwise — to change a file you MUST emit write_file/edit_file. Describing a change in prose does nothing.';
   return (
-    "# FILES ACTUALLY CHANGED THIS SESSION (runtime ground truth — trust THIS over your memory)\n" +
-    [...touched].map(([p, a]) => `- ${p} (${a})`).join("\n") +
+    '# FILES ACTUALLY CHANGED THIS SESSION (runtime ground truth — trust THIS over your memory)\n' +
+    [...touched].map(([p, a]) => `- ${p} (${a})`).join('\n') +
     "\nIf you think you changed a file that is NOT in this list, you did NOT — emit the tool call now. Never say a file 'was reverted'/'should exist' from memory; verify with read_file or list_dir first."
   );
 }
@@ -338,14 +351,17 @@ function memoryBlock() {
   const stats = memoryStats();
   const statLine = stats
     ? `\n\n📊 noob.md hiện tại: ${stats.lines} dòng (${stats.rules} rules, ${stats.notes} notes) · cập nhật ${relTime(stats.mtime)}. Nếu cũ/quá ít, cân nhắc /learn để chưng cất bài học mới.`
-    : "";
+    : '';
   if (!mem)
-    return "# PROJECT RULES & MEMORY (noob.md)\n(Chưa có noob.md trong thư mục này. Khi rút ra điều đáng nhớ lâu dài — lệnh build/test/run, quy ước, kiến trúc, sở thích người dùng, tiến độ — hãy TẠO noob.md bằng write_file và ghi vào đó.)" + statLine;
+    return (
+      '# PROJECT RULES & MEMORY (noob.md)\n(Chưa có noob.md trong thư mục này. Khi rút ra điều đáng nhớ lâu dài — lệnh build/test/run, quy ước, kiến trúc, sở thích người dùng, tiến độ — hãy TẠO noob.md bằng write_file và ghi vào đó.)' +
+      statLine
+    );
   return (
-    "# PROJECT RULES & MEMORY (noob.md) — BINDING\n" +
-    "Phần `## Rules` dưới đây là LUẬT DỰ ÁN bạn PHẢI tuân theo trong mọi hành động ở lượt này — coi như mở rộng của SYSTEM, không phải gợi ý. Phần `## Notes` là quan sát tham khảo, có thể xác minh lại với filesystem nếu nghi ngờ.\n\n" +
+    '# PROJECT RULES & MEMORY (noob.md) — BINDING\n' +
+    'Phần `## Rules` dưới đây là LUẬT DỰ ÁN bạn PHẢI tuân theo trong mọi hành động ở lượt này — coi như mở rộng của SYSTEM, không phải gợi ý. Phần `## Notes` là quan sát tham khảo, có thể xác minh lại với filesystem nếu nghi ngờ.\n\n' +
     mem +
-    "\n\nTrước khi emit hành động, đối chiếu với `## Rules` ở trên. Học thêm điều đáng nhớ → cập nhật noob.md bằng edit_file/write_file (Notes mới, promote lên Rules khi đã chứng minh)." +
+    '\n\nTrước khi emit hành động, đối chiếu với `## Rules` ở trên. Học thêm điều đáng nhớ → cập nhật noob.md bằng edit_file/write_file (Notes mới, promote lên Rules khi đã chứng minh).' +
     statLine
   );
 }
@@ -355,25 +371,25 @@ function memoryBlock() {
 // ý /resume nếu user muốn tiếp tục. Bỏ qua phiên hiện tại (repl.js lọc).
 // recentSessions: [{ id, title, turns, updatedAt }] — đã sort mới → cũ.
 function recentSessionsBlock(recentSessions) {
-  if (!recentSessions || !recentSessions.length) return "";
+  if (!recentSessions || !recentSessions.length) return '';
   const lines = [
-    "# RECENT SESSIONS IN THIS WORKSPACE (newest first)",
+    '# RECENT SESSIONS IN THIS WORKSPACE (newest first)',
     "Đây là các phiên TRƯỚC của cùng dự án. User có thể `/resume <id>` để tiếp tục 1 phiên cụ thể (xem lịch sử đầy đủ). Nếu user nói chung chung ('tiếp tục hôm qua', 'làm lại cái kia') mà KHÔNG chỉ rõ — hỏi lại hoặc dùng breadcrumbs dưới để đoán (xem title + số lượt + thời gian).",
-    "",
+    '',
   ];
   for (const s of recentSessions) {
     const ago = relTime(s.updatedAt);
-    const title = s.title || "(chưa đặt tiêu đề)";
+    const title = s.title || '(chưa đặt tiêu đề)';
     lines.push(`- \`${s.id}\` — "${title}" · ${s.turns} lượt · ${ago}`);
   }
-  return lines.join("\n");
+  return lines.join('\n');
 }
 
 // "X ago" ngắn gọn, tiếng Việt. Dùng cho noob.md mtime + recent sessions.
 function relTime(ts) {
-  if (!ts) return "—";
+  if (!ts) return '—';
   const ms = Date.now() - ts;
-  if (ms < 5000) return "vừa xong"; // < 5s hoặc tương lai → "vừa xong" (tránh "0s trước" xấu)
+  if (ms < 5000) return 'vừa xong'; // < 5s hoặc tương lai → "vừa xong" (tránh "0s trước" xấu)
   const s = Math.floor(ms / 1000);
   if (s < 60) return `${s}s trước`;
   const m = Math.floor(s / 60);
@@ -393,27 +409,30 @@ function relTime(ts) {
 // recentSessions: breadcrumbs các phiên trước cùng workspace (repl.js cung cấp)
 // → chèn ngay sau memoryBlock() để model "thấy" lịch sử dù chưa /resume.
 export function buildSystem(history, extraToolsDoc, goal, recentSessions) {
-  const parts = [SYSTEM, "", memoryBlock()];
+  const parts = [SYSTEM, '', memoryBlock()];
   if (recentSessions && recentSessions.length) {
-    parts.push("", recentSessionsBlock(recentSessions));
+    parts.push('', recentSessionsBlock(recentSessions));
   }
-  if (goal && goal.trim()) parts.push("", goalBlock(goal));
-  if (extraToolsDoc) parts.push("", extraToolsDoc);
-  parts.push("", runtimeContext());
-  return parts.join("\n");
+  if (goal && goal.trim()) parts.push('', goalBlock(goal));
+  if (extraToolsDoc) parts.push('', extraToolsDoc);
+  parts.push('', runtimeContext());
+  return parts.join('\n');
 }
 
 export function buildUserMessage(history) {
   const msgs = compact(history, MAX_PROMPT_CHARS);
-  const parts = [filesLedger(history), "", "=".repeat(60), "# CONVERSATION", ""];
+  const parts = [filesLedger(history), '', '='.repeat(60), '# CONVERSATION', ''];
   for (const m of msgs) {
-    if (m.role === "user") parts.push(`## USER\n${m.content}`);
-    else if (m.role === "assistant") parts.push(`## ASSISTANT\n${m.content}`);
-    else if (m.role === "tool") parts.push(`## TOOL RESULT (${m.name})\n${m.content}`);
-    parts.push("");
+    if (m.role === 'user') parts.push(`## USER\n${m.content}`);
+    else if (m.role === 'assistant') parts.push(`## ASSISTANT\n${m.content}`);
+    else if (m.role === 'tool') parts.push(`## TOOL RESULT (${m.name})\n${m.content}`);
+    parts.push('');
   }
-  parts.push("=".repeat(60), "Continue. Emit a tool block to act, or reply in Markdown if done. Before claiming any file was created/edited, verify it appears in the FILES CHANGED list above — if not, emit the tool call now.");
-  return parts.join("\n");
+  parts.push(
+    '='.repeat(60),
+    'Continue. Emit a tool block to act, or reply in Markdown if done. Before claiming any file was created/edited, verify it appears in the FILES CHANGED list above — if not, emit the tool call now.'
+  );
+  return parts.join('\n');
 }
 
 // Detect câu trả lời bị cắt giữa chừng — KHÔNG phải câu hoàn chỉnh.
@@ -429,10 +448,15 @@ function isIncompleteResponse(text) {
   const lastChar = t.slice(-1);
   if (lastChar && !/[.!?:;)\]"'`#>\n]/.test(lastChar) && t.length > 50) {
     // Kiểm thêm: dòng cuối chứa từ khóa bị cắt (ví dụ, vd, hay, hoặc, và, nhưng, mà)
-    const lastLine = t.split("\n").pop().trim();
+    const lastLine = t.split('\n').pop().trim();
     if (/\s(ví|vd|hay|hoặc|và|nhưng|mà|hoac|or|and|but|e\.g|i\.e)\s*$/i.test(lastLine)) return true;
     // Dòng cuối là 1 câu bắt đầu nhưng chưa xong (có chủ ngữ nhưng không có vị ngữ hoàn chỉnh)
-    if (/\s(Bạn|Tôi|Mình|Anh|Em|Chị|Ông|Bà|Họ)\s+(muốn|có|thấy|nên|cần|đã|đang|sẽ|chọn|định|sắp|vừa)\s*$/i.test(lastLine)) return true;
+    if (
+      /\s(Bạn|Tôi|Mình|Anh|Em|Chị|Ông|Bà|Họ)\s+(muốn|có|thấy|nên|cần|đã|đang|sẽ|chọn|định|sắp|vừa)\s*$/i.test(
+        lastLine
+      )
+    )
+      return true;
   }
   return false;
 }
@@ -443,11 +467,11 @@ function isIncompleteResponse(text) {
 // would close the block early and break the JSON. Instead, find the ```tool (or
 // ```json) opener and brace-match the first balanced JSON object after it.
 function parseToolCall(text) {
-  for (const fence of ["tool", "json"]) {
-    const open = text.match(new RegExp("```" + fence + "[ \\t]*\\n"));
+  for (const fence of ['tool', 'json']) {
+    const open = text.match(new RegExp('```' + fence + '[ \\t]*\\n'));
     if (!open) continue;
     const obj = extractJsonObject(text, open.index + open[0].length);
-    if (obj && typeof obj.name === "string") return { name: obj.name, input: obj.input || {} };
+    if (obj && typeof obj.name === 'string') return { name: obj.name, input: obj.input || {} };
   }
   return null;
 }
@@ -456,20 +480,22 @@ function parseToolCall(text) {
 // escapes so braces or backticks INSIDE string values don't throw off the depth
 // count. Returns the parsed object, or null if malformed/truncated (unbalanced).
 function extractJsonObject(s, from) {
-  const start = s.indexOf("{", from);
+  const start = s.indexOf('{', from);
   if (start === -1) return null;
-  let depth = 0, inStr = false, esc = false;
+  let depth = 0,
+    inStr = false,
+    esc = false;
   for (let i = start; i < s.length; i++) {
     const ch = s[i];
     if (inStr) {
       if (esc) esc = false;
-      else if (ch === "\\") esc = true;
+      else if (ch === '\\') esc = true;
       else if (ch === '"') inStr = false;
       continue;
     }
     if (ch === '"') inStr = true;
-    else if (ch === "{") depth++;
-    else if (ch === "}" && --depth === 0) {
+    else if (ch === '{') depth++;
+    else if (ch === '}' && --depth === 0) {
       try {
         return JSON.parse(s.slice(start, i + 1));
       } catch {
@@ -493,7 +519,20 @@ function extractJsonObject(s, from) {
  * @param {(msg:string)=>void} opts.onStatus      thinking/streaming status
  * @returns {Promise<string>} the final assistant answer (no tool block)
  */
-export async function runAgent({ history, model, signal, onTool, onStatus, onDelta, onSteer, tokenMeter, extraToolsDoc, goal, recentSessions, pendingTasks }) {
+export async function runAgent({
+  history,
+  model,
+  signal,
+  onTool,
+  onStatus,
+  onDelta,
+  onSteer,
+  tokenMeter,
+  extraToolsDoc,
+  goal,
+  recentSessions,
+  pendingTasks,
+}) {
   // [GỠ BUDGET 2026-06-06] Không còn token budget enforcement. Agent/loop/sub-agent
   // chạy không giới hạn token. Dừng theo: GOAL đạt, <<LOOP_DONE>>, <<ULTRA_DONE>>,
   // model tự kết thúc reply không có tool block, hoặc user Ctrl+C.
@@ -502,11 +541,11 @@ export async function runAgent({ history, model, signal, onTool, onStatus, onDel
   const MAX_LOOP_DETECTIONS = 3; // sau 3 lần loop detection liên tiếp → force stop
   // Effort classifier: phân loại task từ user message gốc → set effort level.
   // Chỉ classify 1 lần ở bước đầu, giữ nguyên suốt task (thay đổi giữa chừng gây bất ổn).
-  const effort = classifyEffort(history.find((m) => m.role === "user")?.content || "");
+  const effort = classifyEffort(history.find((m) => m.role === 'user')?.content || '');
   for (let step = 0; step < MAX_STEPS; step++) {
     // Check abort signal ngay đầu mỗi iteration để Ctrl+C dừng ngay lập tức
     if (signal?.aborted) {
-      throw new Error("aborted");
+      throw new Error('aborted');
     }
     // Mỗi 100 bước log một mốc để người dùng biết noob vẫn đang chạy (task dài).
     if (step > 0 && step % 100 === 0) onStatus?.(`đã chạy ${step} bước…`);
@@ -514,40 +553,50 @@ export async function runAgent({ history, model, signal, onTool, onStatus, onDel
     // Steering: tin nhắn người dùng gõ GIỮA CHỪNG được chèn vào hội thoại TRƯỚC
     // lần gọi model kế tiếp → model thấy và điều chỉnh ngay trong cùng task.
     const steer = onSteer?.() || [];
-    for (const msg of steer) history.push({ role: "user", content: msg });
+    for (const msg of steer) history.push({ role: 'user', content: msg });
 
     // Bộ nhớ dài hạn: thử tóm tắt nếu history đã phình. Im lặng nếu không cần.
-    try { await maybeSummarize(history, { model, signal }); } catch {}
+    try {
+      await maybeSummarize(history, { model, signal });
+    } catch {}
 
     const system = buildSystem(history, extraToolsDoc, goal, recentSessions);
     const message = buildUserMessage(history);
     tokenMeter?.addInput(countTokens(system) + countTokens(message));
     tokenMeter?.setContext(tokenMeter.total);
-    onStatus?.("thinking");
-    onDelta?.({ type: "step-start" });
+    onStatus?.('thinking');
+    onDelta?.({ type: 'step-start' });
     // Stream + auto-retry: bao lớp resilience cho lỗi stream cut / empty / network.
     // api.js đã tự nối tiếp khi truncated (maxContinues=Infinity); agent.js xử lý các
     // trường hợp api.js trả về với finishReason bất thường (tool_unclosed/empty) hoặc
     // throw ApiError retryable (network drop, 5xx, timeout).
     const { text, finishReason } = await streamWithRetry({
-      model, message, system, signal, tokenMeter, onDelta, onStatus, effort,
+      model,
+      message,
+      system,
+      signal,
+      tokenMeter,
+      onDelta,
+      onStatus,
+      effort,
     });
     tokenMeter?.endOutput();
-    onDelta?.({ type: "step-end" });
-    history.push({ role: "assistant", content: text });
+    onDelta?.({ type: 'step-end' });
+    history.push({ role: 'assistant', content: text });
 
     const call = parseToolCall(text);
     if (!call) {
       // Không có tool call. Nếu finishReason bất thường (empty/tool_unclosed) →
       // model bị cắt ngay trước khi kịp gọi tool → nudge tiếp 1 lượt nữa thay vì
       // return text rỗng/dở dang.
-      if (finishReason === "empty" || finishReason === "tool_unclosed") {
+      if (finishReason === 'empty' || finishReason === 'tool_unclosed') {
         history.push({
-          role: "tool",
-          name: "stream_recovery",
-          content: finishReason === "tool_unclosed"
-            ? "[STREAM CUT] Bạn vừa emit tool block mở mà chưa đóng. Lặp lại tool call đó NGUYÊN VẸN, đóng đúng cú pháp ```tool ... ``` rồi STOP."
-            : "[STREAM EMPTY] Lượt vừa rồi không trả về text. Hãy tiếp tục công việc — nếu cần tool thì emit tool block, nếu xong thì tổng kết.",
+          role: 'tool',
+          name: 'stream_recovery',
+          content:
+            finishReason === 'tool_unclosed'
+              ? '[STREAM CUT] Bạn vừa emit tool block mở mà chưa đóng. Lặp lại tool call đó NGUYÊN VẸN, đóng đúng cú pháp ```tool ... ``` rồi STOP.'
+              : '[STREAM EMPTY] Lượt vừa rồi không trả về text. Hãy tiếp tục công việc — nếu cần tool thì emit tool block, nếu xong thì tổng kết.',
         });
         continue;
       }
@@ -555,9 +604,10 @@ export async function runAgent({ history, model, signal, onTool, onStatus, onDel
       // đột ngột không có dấu câu/đóng danh sách/tool block → nudge model viết tiếp.
       if (isIncompleteResponse(text)) {
         history.push({
-          role: "tool",
-          name: "stream_recovery",
-          content: "[STREAM CUT] Lượt vừa bị cắt giữa chừng. Hãy viết TIẾP liền mạch — nếu đang hỏi user thì hoàn tất câu hỏi, nếu đang list thì đóng danh sách, nếu đang viết tool block thì đóng đúng JSON.",
+          role: 'tool',
+          name: 'stream_recovery',
+          content:
+            '[STREAM CUT] Lượt vừa bị cắt giữa chừng. Hãy viết TIẾP liền mạch — nếu đang hỏi user thì hoàn tất câu hỏi, nếu đang list thì đóng danh sách, nếu đang viết tool block thì đóng đúng JSON.',
         });
         continue;
       }
@@ -567,7 +617,7 @@ export async function runAgent({ history, model, signal, onTool, onStatus, onDel
 
     const { allow, result } = await onTool(call.name, call.input);
     history.push({
-      role: "tool",
+      role: 'tool',
       name: call.name,
       content: allow ? result : t.toolDenied,
     });
@@ -580,8 +630,8 @@ export async function runAgent({ history, model, signal, onTool, onStatus, onDel
       if (tasks.length > 0) {
         const next = tasks[0];
         history.push({
-          role: "user",
-          content: `[SYSTEM] Việc "${call.name}" đã hoàn thành. Còn ${tasks.length} việc: ${tasks.map((t) => `"${t}"`).join(", ")}. Việc tiếp theo BẮT BUỘC phải làm ngay: "${next}". Gọi tool (write_file/edit_file/run_command) để làm việc này. KHÔNG dừng, KHÔNG tóm tắt.`,
+          role: 'user',
+          content: `[SYSTEM] Việc "${call.name}" đã hoàn thành. Còn ${tasks.length} việc: ${tasks.map((t) => `"${t}"`).join(', ')}. Việc tiếp theo BẮT BUỘC phải làm ngay: "${next}". Gọi tool (write_file/edit_file/run_command) để làm việc này. KHÔNG dừng, KHÔNG tóm tắt.`,
         });
       }
     }
@@ -596,43 +646,62 @@ export async function runAgent({ history, model, signal, onTool, onStatus, onDel
     recentCalls.push({ name: call.name, inputStr });
     if (recentCalls.length > LOOP_DETECT_WINDOW) recentCalls.shift();
     let loopType = null; // 'consecutive' | 'pattern' | null
+    let lastN = [];
     if (recentCalls.length >= LOOP_DETECT_THRESHOLD + 1) {
       // (A) Same consecutive check
-      const lastN = recentCalls.slice(-LOOP_DETECT_THRESHOLD);
-      const allSame = lastN.every((c) => c.name === lastN[0].name && c.inputStr === lastN[0].inputStr);
+      lastN = recentCalls.slice(-LOOP_DETECT_THRESHOLD);
+      const allSame = lastN.every(
+        (c) => c.name === lastN[0].name && c.inputStr === lastN[0].inputStr
+      );
       if (allSame) loopType = 'consecutive';
     }
     // (B) Pattern cycle check: tìm chu kỳ lặp trong window (độ dài 2-3)
     if (!loopType && recentCalls.length >= 4) {
-      for (let cycleLen = 2; cycleLen <= Math.min(3, Math.floor(recentCalls.length / 2)); cycleLen++) {
+      for (
+        let cycleLen = 2;
+        cycleLen <= Math.min(3, Math.floor(recentCalls.length / 2));
+        cycleLen++
+      ) {
         const half = Math.floor(recentCalls.length / cycleLen) * cycleLen;
         const first = recentCalls.slice(-half, -half + cycleLen);
         const rest = recentCalls.slice(-half + cycleLen);
         let matched = true;
         for (let i = 0; i < rest.length; i++) {
-          if (rest[i].name !== first[i % cycleLen].name || rest[i].inputStr !== first[i % cycleLen].inputStr) {
+          if (
+            rest[i].name !== first[i % cycleLen].name ||
+            rest[i].inputStr !== first[i % cycleLen].inputStr
+          ) {
             matched = false;
             break;
           }
         }
-        if (matched) { loopType = 'pattern'; break; }
+        if (matched) {
+          loopType = 'pattern';
+          break;
+        }
       }
     }
     if (loopType) {
-      const label = loopType === 'consecutive' ? lastN[0].name : `pattern [${recentCalls.slice(-4).map((c) => c.name).join(", ")}]`;
+      const label =
+        loopType === 'consecutive'
+          ? lastN[0].name
+          : `pattern [${recentCalls
+              .slice(-4)
+              .map((c) => c.name)
+              .join(', ')}]`;
       loopDetectedCount++;
       if (loopDetectedCount >= MAX_LOOP_DETECTIONS) {
         history.push({
-          role: "tool",
-          name: "loop_detection",
+          role: 'tool',
+          name: 'loop_detection',
           content: `[LOOP DETECTED × ${loopDetectedCount}] Bạn lặp lại ${label} nhiều lần — KHÔNG THỂ TIẾP TỤC. Dừng ngay.`,
         });
         return `[LOOP STOPPED] Đã dừng vì model bị kẹt trong vòng lặp.`;
       }
       recentCalls.length = 0;
       history.push({
-        role: "tool",
-        name: "loop_detection",
+        role: 'tool',
+        name: 'loop_detection',
         content: `[LOOP DETECTED × ${loopDetectedCount}] Bạn lặp lại ${label} — có vẻ đang kẹt. HÃY CHUYỂN BƯỚC: gọi tool khác hoặc trả lời Markdown nếu xong. KHÔNG lặp lại. Nếu tiếp tục, task sẽ dừng.`,
       });
     } else {
@@ -649,13 +718,22 @@ export async function runAgent({ history, model, signal, onTool, onStatus, onDel
  *   backoff (1s, 2s, 4s, 8s, max 30s), tối đa 8 lần thử trước khi bỏ cuộc.
  * - Throw lại nếu signal abort hoặc lỗi không retryable.
  */
-async function streamWithRetry({ model, message, system, signal, tokenMeter, onDelta, onStatus, effort }) {
+async function streamWithRetry({
+  model,
+  message,
+  system,
+  signal,
+  tokenMeter,
+  onDelta,
+  onStatus,
+  effort,
+}) {
   const MAX_RETRIES = 8;
   let lastErr = null;
   for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
     try {
       const result = await stream({
-        mode: "chat",
+        mode: 'chat',
         model,
         message,
         system,
@@ -663,28 +741,39 @@ async function streamWithRetry({ model, message, system, signal, tokenMeter, onD
         effort,
         onDelta: (d) => {
           tokenMeter?.pushOutputDelta(d);
-          onDelta?.({ type: "delta", text: d });
+          onDelta?.({ type: 'delta', text: d });
         },
       });
       return result; // { text, reasoning, finishReason }
     } catch (err) {
       if (signal?.aborted) throw err; // user Ctrl+C — không retry
-      if (err?.name !== "ApiError" || !err.retryable) throw err; // lỗi cứng — bail
+      if (err?.name !== 'ApiError' || !err.retryable) throw err; // lỗi cứng — bail
       lastErr = err;
       if (attempt >= MAX_RETRIES) break;
       const backoff = Math.min(30000, 1000 * Math.pow(2, attempt));
-      onStatus?.(`Lỗi kết nối — thử lại sau ${(backoff/1000)|0}s [${attempt+1}/${MAX_RETRIES}]…`);
+      onStatus?.(
+        `Lỗi kết nối — thử lại sau ${(backoff / 1000) | 0}s [${attempt + 1}/${MAX_RETRIES}]…`
+      );
       await sleep(backoff, signal);
     }
   }
-  throw lastErr || new Error("streamWithRetry: exhausted retries");
+  throw lastErr || new Error('streamWithRetry: exhausted retries');
 }
 
 function sleep(ms, signal) {
   return new Promise((resolve, reject) => {
-    const id = setTimeout(() => { cleanup(); resolve(); }, ms);
-    const onAbort = () => { cleanup(); reject(new Error("aborted")); };
-    const cleanup = () => { clearTimeout(id); signal?.removeEventListener("abort", onAbort); };
-    signal?.addEventListener("abort", onAbort, { once: true });
+    const id = setTimeout(() => {
+      cleanup();
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      cleanup();
+      reject(new Error('aborted'));
+    };
+    const cleanup = () => {
+      clearTimeout(id);
+      signal?.removeEventListener('abort', onAbort);
+    };
+    signal?.addEventListener('abort', onAbort, { once: true });
   });
 }