@noobdemon/noob-cli 1.13.1 → 1.13.3

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 Tất cả thay đổi đáng kể của `@noobdemon/noob-cli` được ghi vào file này.
 
+## [1.13.3] - 2026-06-29
+
+### Fixed
+- **Message nhắc việc nội bộ không còn gây nhiễu mô hình** (`src/agent.js`): các message nhắc tiếp tục công việc (nhắc todo còn dở, hướng dẫn khi tool lỗi, cảnh báo gọi trùng tool) trước đây được chèn vào hội thoại như thể là tin nhắn người dùng và mở đầu bằng nhãn `[SYSTEM]`. Mô hình ở lượt sau đọc lại tưởng có người chèn lệnh giả dạng hệ thống vào cuộc trò chuyện nên sinh nghi ngờ, đi sửa lung tung. Giờ các message này đi đúng kênh kết quả tool và đổi nhãn thành `[TODO]`/`[TOOL GUIDANCE]`.
+
+### Verified
+- `npm test` 109/109 pass.
+
+## [1.13.2] - 2026-06-28
+
+### Added
+- **Hỗ trợ nhiều ảnh trong một tin nhắn**: paste hoặc nhắc nhiều ảnh `@file` trong cùng một lượt — tất cả được đính kèm cho mô hình vision, mỗi ảnh là một phần riêng. Trước đây chỉ ảnh đầu tiên được gửi đi.
+- **Smoke test chống README drift** (`scripts/smoke-readme-drift.mjs`): đối chiếu README với danh mục mô hình + tool thật — fail nếu README quảng cáo số mô hình lớn hơn thực tế hoặc thiếu tool. 20/20 pass.
+- **Gợi ý trang động cho `web_fetch`** (`src/tools.js`): khi tải một trang nhiều HTML nhưng bóc ra rất ít chữ (thường là trang render bằng JS), trả thêm gợi ý thử chế độ `raw` thay vì để mô hình tưởng trang trống. 16/16 pass.
+
+### Changed
+- **README viết lại khớp thực tế**: số lượng mô hình, danh sách tool và lệnh trong phiên, cấu trúc thư mục `src/` đều cập nhật cho đúng với mã hiện tại.
+
+### Internal
+- **Tách bớt `src/repl.js`** (`src/repl/commands/kg.js` + `src/repl/commands/goal.js`): khối `/kg` và `/goal` chuyển thành hàm riêng nhận dependency injected, không truy cập closure `startRepl`. Verify: import sạch, `smoke-kg` 45/45, `npm test` 109/109.
+- **Luồng ảnh dạng mảng** (`src/api.js` + `src/agent.js` + `src/repl.js`): tham số `images` (mảng) luồng xuyên `runAgent → streamWithRetry → stream → streamOnce`, giữ `image` đơn làm alias tương thích ngược.
+
 ## [1.13.1] - 2026-06-28
 
 ### Fixed

package/README.md

@@ -1,11 +1,11 @@
 # noob — agentic coding CLI
 
-A Claude-Code-style coding agent that lives in your terminal, powered by
-**Noob Demon** (34 models across 8 providers — GPT, Claude, Gemini, DeepSeek,
-Grok, Qwen, Kimi, Llama).
+Một coding agent kiểu Claude Code sống trong terminal, giao tiếp **tiếng Việt**,
+chạy qua gateway **Noob Demon** với 3 mô hình flagship (Claude Opus 4.8, GPT-5.5,
+DeepSeek V4 Pro).
 
-It reads and edits files, runs shell commands, and iterates on a task — asking
-permission before anything destructive — all inside a polished terminal UI.
+Nó đọc & sửa file, chạy lệnh shell, tự lặp để hoàn thành tác vụ — xin phép trước
+mọi thao tác có rủi ro — tất cả trong một giao diện terminal gọn gàng.
 
 ```
   ███╗   ██╗ ██████╗  ██████╗ ██████╗
@@ -21,15 +21,15 @@ permission before anything destructive — all inside a polished terminal UI.
 ```bash
 cd "noob cli"
 npm install
-npm link          # optional: makes `noob` available globally
+npm link          # tùy chọn: cho phép gõ `noob` toàn cục
 ```
 
-Requires Node.js ≥ 18 (tested on 22).
+Yêu cầu Node.js ≥ 18 (test trên 22).
 
-## Xác thực & gói cước (Authentication)
+## Xác thực & gói cước
 
-noob đi qua một **gateway** (Cloudflare Worker `claude-code-proxy`) để ẩn backend
-thật và quản lý API key qua Supabase. Bạn cần một API key để dùng:
+noob đi qua một **gateway** (Cloudflare Worker) để ẩn backend thật và quản lý API
+key. Bạn cần một API key để dùng:
 
 ```bash
 noob login nk_xxx_xxxxxxxx     # đăng nhập, key lưu ở ~/.noob/config.json
@@ -50,51 +50,71 @@ Trong phiên: `/login <key>`, `/usage`, `/logout`.
 
 > Mỗi lệnh gọi mô hình (kể cả từng bước tool trong một tác vụ) tính là 1 request.
 
-Cấp/huỷ key (admin) — trong repo gateway `worker/`:
-
-```bash
-node scripts/admin.mjs create pro "khách A"
-node scripts/admin.mjs list
-node scripts/admin.mjs revoke nk_pro_xxx
-```
-
 ## Use
 
 ```bash
-noob                                   # interactive session
-noob "add input validation to api.js"  # start with a request
-noob -m gateway-claude-opus-4-8        # pick a model
-noob --yolo                            # auto-approve edits & commands
+noob                                   # phiên tương tác
+noob "add input validation to api.js"  # bắt đầu kèm yêu cầu
+noob -m gateway-claude-opus-4-8        # chọn mô hình
+noob --yolo                            # tự duyệt edit & lệnh
 ```
 
-Without `npm link`, run `node bin/noob.js …`.
-
-### In-session commands
-
-| Command         | What it does                                                       |
-| --------------- | ------------------------------------------------------------------ |
-| `/model [name]` | switch model (fuzzy match), or list all                            |
-| `/models`       | list every model grouped by provider                               |
-| `/merge`        | toggle **Merge AI** — synthesizes GPT-5.5 + Claude + Gemini via o3 |
-| `/search`       | toggle **web search** mode                                         |
-| `/chat`         | back to normal chat mode                                           |
-| `/yolo`         | toggle auto-approve for file/command tools (or **Shift+Tab**)      |
-| `/clear` `/new` | wipe conversation context                                          |
-| `/status`       | show current model + working directory                             |
-| `/exit`         | quit (Ctrl+C once = stop turn, twice = quit)                       |
+Không `npm link` thì chạy `node bin/noob.js …`.
+
+Cờ dòng lệnh: `--yolo`, `--ultra`, `--model <name>`, `--continue`, `--resume`,
+`--insecure-tls`.
+
+### Lệnh trong phiên
+
+| Lệnh              | Tác dụng                                                       |
+| ----------------- | ------------------------------------------------------------- |
+| `/help`           | danh sách lệnh                                                |
+| `/model [name]`   | đổi mô hình (fuzzy match), hoặc liệt kê tất cả                |
+| `/models`         | liệt kê mọi mô hình theo provider                             |
+| `/merge`          | bật/tắt **Merge AI** (tổng hợp đa mô hình)                    |
+| `/search`         | bật/tắt chế độ tìm web                                        |
+| `/chat`           | quay lại chế độ chat thường                                   |
+| `/agent on\|off`  | bật/tắt agent mode (đẻ sub-agent song song/tuần tự/phân cấp)  |
+| `/mode`           | build\|plan\|compose — đổi chế độ agent (Ctrl+T cycle)        |
+| `/goal [text]`    | đặt HARD GOAL cho phiên · `/goal clear` để xoá                |
+| `/loop <iv> <task>` | chạy task định kỳ · `/loop stop` để dừng                    |
+| `/ultra`          | chế độ tự hành: model tự nghĩ & làm tới khi xong              |
+| `/workflow`       | orchestrate workflow đa-agent (xem `/workflow help`)          |
+| `/kg`             | knowledge graph của project (xem `/kg help`)                  |
+| `/compact`        | tóm tắt phiên ngay để gọn ngữ cảnh                            |
+| `/tokens`         | xem token đã dùng trong phiên                                 |
+| `/memory`         | xem bộ nhớ `noob.md` · `/memory stats` xem kích thước         |
+| `/learn`          | chưng cất bài học vào `noob.md`                               |
+| `/init`           | quét dự án & tạo `noob.md`                                    |
+| `/karpathy`       | rà soát code theo nguyên tắc Karpathy                         |
+| `/frontend-design`| skill thiết kế UI frontend chất lượng cao                    |
+| `/improve`        | phân tích workspace & gợi ý tính năng cải thiện              |
+| `/add-dir <path>` | thêm thư mục ngoài cwd vào phạm vi · `remove` để gỡ          |
+| `/cwd`            | thư mục làm việc hiện tại                                     |
+| `/yolo`           | bật/tắt tự duyệt file/lệnh (hoặc **Shift+Tab**)              |
+| `/auto-yolo`      | lưu yolo làm mặc định mỗi lần chạy                            |
+| `/clear` `/new`   | xoá ngữ cảnh / phiên mới                                      |
+| `/continue`       | tiếp tục phiên gần nhất                                       |
+| `/resume`         | chọn & tiếp tục một phiên cũ                                  |
+| `/sessions`       | liệt kê phiên đã lưu                                          |
+| `/status`         | mô hình hiện tại + thư mục làm việc                           |
+| `/version`        | phiên bản                                                     |
+| `/login` `/logout` `/usage` | xác thực & hạn mức                                  |
+| `/update`         | tự cập nhật noob                                              |
+| `/exit`           | thoát (Ctrl+C một lần = dừng turn, hai lần = thoát)           |
 
 ## How it works
 
-The Noob Demon gateway is a **stateless single-message** endpoint with no native
-function-calling. noob layers an agent on top:
+Gateway Noob Demon là một endpoint **stateless single-message** không có
+function-calling gốc. noob phủ một lớp agent lên trên:
 
-1. The full transcript (system prompt + history + tool results) is serialized into
-   one `message` and streamed to the gateway's `/api/chat`.
-2. The model replies with either a final answer or a single \`\`\`tool JSON block.
-3. noob parses the tool call, asks permission if it's destructive, executes it, and
-   feeds the result back — looping until the model answers without a tool block.
+1. Toàn bộ transcript (system prompt + history + kết quả tool) được serialize
+   thành một `message` rồi stream tới `/api/chat`.
+2. Model trả về hoặc câu trả lời cuối, hoặc một khối ```tool JSON duy nhất.
+3. noob parse tool call, xin phép nếu nó có rủi ro, thực thi, rồi feed kết quả
+   lại — lặp tới khi model trả lời không kèm tool block.
 
-### Architecture (high-level)
+### Kiến trúc (tổng quan)
 
 ```mermaid
 flowchart LR
@@ -104,8 +124,8 @@ flowchart LR
   API -->|HTTPS stream| GW[(Noob Demon<br/>Gateway)]
   GW -->|delta tokens| API
   API -->|onDelta callbacks| Agent
-  Agent -->|parse tool block| Tools[tools.js<br/>read/write/edit/run]
-  Tools -->|fs / spawn| FS[(workspace)]
+  Agent -->|parse tool block| Tools[tools.js<br/>read/write/edit/run/fetch]
+  Tools -->|fs / spawn / http| FS[(workspace)]
   Tools -->|result text| Agent
   Agent -->|final answer| REPL
   REPL -->|persist| Sessions[(~/.noob/sessions/)]
@@ -114,109 +134,122 @@ flowchart LR
   Subagent -->|isolated context| API
 ```
 
-### Tools the agent can call
+### Tool agent gọi được
 
-`read_file` · `write_file` · `edit_file` · `list_dir` · `glob` · `grep` · `run_command`
+Đọc/khám phá (chạy tự do, không xin phép):
+`read_file` · `list_dir` · `glob` · `grep` · `web_fetch`
 
-Destructive tools (`write_file`, `edit_file`, `run_command`) prompt for approval
-(`y` / `n` / `a`lways) unless `/yolo` is on.
+Thao tác có rủi ro (xin phép `y`/`n`/`a`, thêm `t`=hết turn, `f`=file này khi
+bật rich TTY):
+`write_file` · `edit_file` · `run_command`
+
+Quản lý tiến trình nền & điều phối:
+`bg_output` · `kill_bg` · `write_todos` · `spawn_agent` / `spawn_agents` (khi
+`/agent` bật) · `kg_search` / `kg_add` / `kg_link` / `kg_obs` (knowledge graph)
+
+> `web_fetch` truy cập mạng (http/https) nhưng read-only nên không xin phép.
+> Nó strip HTML bằng regex; với trang render bằng JS (SPA) sẽ trả về gần rỗng
+> kèm gợi ý thử `raw:true`.
 
 ## Configuration
 
-| Env var               | Effect                                                                                                                                   |
-| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| `NOOB_API_BASE`       | override the gateway URL                                                                                                                 |
-| `NOOB_API_KEY`        | API key (overrides `~/.noob/config.json`)                                                                                                |
-| `NOOB_INSECURE_TLS=1` | disable TLS verification — **last resort** for machines behind a TLS-intercepting proxy. Prefer adding your proxy CA to the trust store. |
+| Env var               | Tác dụng                                                            |
+| --------------------- | ------------------------------------------------------------------ |
+| `NOOB_API_BASE`       | ghi đè URL gateway                                                 |
+| `NOOB_API_KEY`        | API key (ghi đè `~/.noob/config.json`)                            |
+| `NOOB_INSECURE_TLS=1` | tắt verify TLS — **giải pháp cuối** cho máy sau proxy chặn TLS.    |
 
 ## Model compatibility
 
-The agent drives tools through a text protocol (the proxy has no native
-function-calling). Models differ in how willingly they follow it:
+Agent điều khiển tool qua một text protocol (gateway không có function-calling
+gốc). Các model khác nhau về mức độ sẵn lòng tuân theo:
 
-| Provider               | Agentic tools    | Notes                                    |
+| Provider               | Agentic tools    | Ghi chú                                  |
 | ---------------------- | ---------------- | ---------------------------------------- |
-| **Anthropic** (Claude) | ✅ best          | default — `gateway-claude-opus-4-8`      |
-| **DeepSeek**           | ✅ works         | good free alternative                    |
-| OpenAI (GPT/o-series)  | ⚠️ often refuses | replies "I can't access your filesystem" |
-| Google (Gemini)        | ⚠️ often refuses | same                                     |
+| **Anthropic** (Claude) | ✅ tốt nhất      | mặc định — `gateway-claude-opus-4-8`     |
+| **DeepSeek**           | ✅ chạy tốt      | lựa chọn thay thế tốt                    |
+| OpenAI (GPT)           | ⚠️ hay từ chối   | trả "I can't access your filesystem"     |
 
-Stick with Claude or DeepSeek for file edits & commands. Any model is fine for
-plain chat, `/merge`, and `/search`.
+Dùng Claude hoặc DeepSeek cho edit file & chạy lệnh. Mọi model đều ổn cho chat
+thường, `/merge`, và `/search`.
 
 ## Project structure
 
 ```
 src/
-├── api.js              # gateway client + stream parser + memory token
-├── agent.js            # tool-loop driver, summarization, prompt assembly
-├── tools.js            # read/write/edit/list_dir/glob/grep/run_command + bg
-├── repl.js             # input loop, slash commands, session state (88 KB)
+├── api.js              # gateway client + stream parser + quota warning
+├── agent.js            # tool-loop driver, SYSTEM prompt, summarization
+├── tools.js            # read/write/edit/list_dir/glob/grep/run_command/web_fetch/bg/kg
+├── repl.js             # input loop, slash commands, session state
 ├── repl/
-│   ├── complete.js     # SLASH catalog + autocomplete
-│   ├── todos.js        # parseTodosFromHistory (pure)
-│   ├── ultra.js        # ULTRA mode constants + prompt templates
-│   └── workflow-commands.js  # /workflow help/list/load/delete (pure)
+│   ├── agent-dispatch.js   # spawn_agent + write_todos dispatcher
+│   ├── complete.js         # SLASH catalog + autocomplete
+│   ├── permission.js       # askPermission (y/n/a/t/f scopes)
+│   ├── state.js            # createState — session state shape
+│   ├── stream-printer.js   # render stream theo dòng (heading/table/code)
+│   ├── todos.js            # parseTodosFromHistory (pure)
+│   ├── ultra.js            # ULTRA mode prompt templates
+│   ├── workflow-commands.js # /workflow help/list/load/delete (pure)
+│   └── commands/           # nhóm slash command tách rời
 ├── subagent.js         # spawn_agent / spawn_agents — sub-agent isolation
-├── tui.js              # terminal UI (input, status bar, prompt rendering)
-├── ui.js               # color helpers, markdown renderer, banner
+├── workflow-bg.js      # workflow chạy nền
+├── workflow-runs.js    # lưu/khôi phục lần chạy workflow
+├── workflows.js        # ~/.noob/workflows/ — workflow user lưu
+├── workflows-builtin.js # workflow ship-sẵn (deep-research, verify-claims, triage)
+├── kg.js               # knowledge graph (.noob/kg.jsonl per project)
+├── tui.js              # terminal UI (input, status bar, todo progress)
+├── ui.js               # color, markdown renderer, banner
+├── diff.js             # render diff khi edit_file
 ├── config.js           # ~/.noob/config.json (api key, gateway, model)
 ├── sessions.js         # ~/.noob/sessions/ — save/list/resume
-├── skills.js           # ~/.noob/skills/ — user-defined skill loader
-├── workflows.js        # ~/.noob/workflows/ — user-saved workflows
-├── workflows-builtin.js # ship-with-binary workflows (deep-research, etc)
+├── skills.js           # skill loader (cwd → package)
 ├── memory.js           # noob.md per-project agent memory
-├── tokens.js           # local token counter (o200k_base / cl100k_base)
-├── models.js           # 34-model catalog + fuzzy resolver
-├── i18n.js             # Vietnamese string table
-├── update.js           # `noob update` self-updater
-└── prompts/
-    └── system.md       # base system prompt template
-
-tests/                   # vitest unit tests (96 tests)
-scripts/                 # check-imports, notify-discord, release.ps1
+├── tokens.js           # local token counter (gpt-tokenizer)
+├── models.js           # 3-model flagship catalog + fuzzy resolver
+├── i18n.js             # bảng chuỗi tiếng Việt
+└── update.js           # `noob update` self-updater
+
+tests/                   # vitest unit tests
+scripts/                 # smoke tests + notify-discord
 ```
 
 ## Development
 
 ```bash
-npm test                 # run vitest unit tests (96 tests across 7 files)
-npm run lint             # eslint --check
+npm test                 # chạy vitest unit tests
+npm run lint             # eslint
 npm run lint:fix         # eslint --fix
 npm run format           # prettier --write
 npm run format:check     # prettier --check
-npm run check            # lint + format:check + test (pre-commit gate)
+npm run check            # lint + format:check + test (cổng pre-commit)
 ```
 
 Husky chạy `lint-staged` + `npm test` trước mỗi commit. Bỏ qua bằng
 `git commit --no-verify` nếu thực sự cần (vd commit WIP).
 
+Ngoài unit test, `scripts/` chứa nhiều smoke test chạy bằng
+`node scripts/smoke-<name>.mjs` (offline, không cần gateway).
+
 ## Troubleshooting
 
 **"CLI tự thoát sau khi hỏi quyền"** — thường là readline trên Windows phát sự
-kiện `close` từ tiến trình con chạm vào console. Đã có workaround trong
-`repl.js` (input layer tự re-arm). Nếu còn xảy ra, mở issue kèm OS + Node version.
+kiện `close` từ tiến trình con. Đã có workaround trong `repl.js`. Nếu còn xảy ra,
+mở issue kèm OS + Node version.
 
-**"TLS error / certificate"** — máy bạn sau proxy chặn TLS (Zscaler, Cisco
+**"TLS error / certificate"** — máy sau proxy chặn TLS (Zscaler, Cisco
 Umbrella…). Ưu tiên add CA của proxy vào trust store. Cuối cùng mới dùng
 `NOOB_INSECURE_TLS=1` (tắt verify TLS toàn process, MITM-vulnerable).
 
-**"Model OpenAI/Gemini từ chối tool"** — bình thường. GPT-o-series và Gemini
-thường refuse access filesystem qua text protocol. Dùng `/model claude-opus` hoặc
-`/model deepseek-v3` cho tasks cần tool.
-
-**"Token count có vẻ sai"** — `tokens.js` chọn encoder theo model id
-(`o200k_base` cho GPT-4o/5/o-series, `cl100k_base` cho phần còn lại). Đếm chính
-xác cho OpenAI, xấp xỉ ±5-15% cho Claude/Gemini/khác (các provider này không
-publish tokenizer public).
+**"Model OpenAI từ chối tool"** — GPT thường refuse access filesystem qua text
+protocol. Dùng `/model claude` hoặc `/model deepseek` cho task cần tool.
 
 ## Notes & limits
 
-- Free shared proxy: rate limits and occasional hiccups are expected.
-- Context is sent in full each turn, so very long sessions cost more tokens — use
-  `/clear` to reset.
-- This is an unofficial tool built against a public community endpoint; it is not
-  affiliated with Anthropic or the model providers.
+- Proxy chia sẻ miễn phí: rate limit và đôi lúc trục trặc là bình thường.
+- Context gửi đầy đủ mỗi lượt, nên phiên rất dài tốn nhiều token — dùng `/compact`
+  hoặc `/clear` để gọn lại.
+- Đây là công cụ không chính thức, không liên kết với Anthropic hay các nhà cung
+  cấp model.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noobdemon/noob-cli",
-  "version": "1.13.1",
+  "version": "1.13.3",
   "publishConfig": {
     "access": "public"
   },
@@ -25,7 +25,8 @@
     "format:check": "prettier --check .",
     "test": "vitest run",
     "test:watch": "vitest",
-    "check": "npm run lint && npm run format:check && npm run test",
+    "i18n:check": "node scripts/check-i18n-orphans.mjs",
+    "check": "npm run lint && npm run format:check && npm run i18n:check && npm run test",
     "postpublish": "node scripts/notify-discord.js",
     "prepare": "husky"
   },

package/src/agent.js

@@ -479,18 +479,18 @@ export function todoContinuationMessage(toolName, ok, tasks) {
   if (!tasks?.length) return null;
   const next = tasks[0];
   const status = ok ? `đã hoàn thành` : `vừa LỖI`;
-  return `[SYSTEM] Việc "${toolName}" ${status}. 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.`;
+  return `[TODO] Việc "${toolName}" ${status}. 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.`;
 }
 
 export function toolErrorGuidance(name, { result } = {}) {
   if (name !== 'edit_file' || !String(result || '').includes('old_string not found')) return null;
   const m = String(result).match(/NEXT REQUIRED TOOL:\s*(read_file \{[^\n]+\})/);
   if (!m) return null;
-  return `[SYSTEM] edit_file thất bại vì old_string sai. Bạn PHẢI gọi đúng tool này ngay: ${m[1]}. KHÔNG gọi edit_file lại trước khi đọc file. Sau đó copy đúng text từ read_file mới để retry.`;
+  return `[TOOL GUIDANCE] edit_file thất bại vì old_string sai. Bạn PHẢI gọi đúng tool này ngay: ${m[1]}. KHÔNG gọi edit_file lại trước khi đọc file. Sau đó copy đúng text từ read_file mới để retry.`;
 }
 
 export function duplicateToolGuidance(name, input) {
-  return `[SYSTEM] Tool call vừa rồi TRÙNG HỆT lần trước: ${name} ${JSON.stringify(input || {})}. KHÔNG chạy tool này lại. Dùng kết quả đã có trong history; nếu cần tiến thêm thì gọi tool khác (grep/read_file/edit_file/run_command) hoặc trả lời Markdown nếu xong.`;
+  return `[TOOL GUIDANCE] Tool call vừa rồi TRÙNG HỆT lần trước: ${name} ${JSON.stringify(input || {})}. KHÔNG chạy tool này lại. Dùng kết quả đã có trong history; nếu cần tiến thêm thì gọi tool khác (grep/read_file/edit_file/run_command) hoặc trả lời Markdown nếu xong.`;
 }
 
 // Detect câu trả lời bị cắt giữa chừng — KHÔNG phải câu hoàn chỉnh.
@@ -581,6 +581,7 @@ export async function runAgent({
   history,
   model,
   image,
+  images,
   signal,
   onTool,
   onStatus,
@@ -638,6 +639,7 @@ export async function runAgent({
       model,
       message,
       image,
+      images,
       system,
       signal,
       tokenMeter,
@@ -720,7 +722,7 @@ export async function runAgent({
     });
     const toolOk = allow && !String(result || '').startsWith('ERROR:');
     const errorNudge = allow ? toolErrorGuidance(call.name, { result }) : null;
-    if (errorNudge) history.push({ role: 'user', content: errorNudge });
+    if (errorNudge) history.push({ role: 'tool', name: 'tool_guidance', content: errorNudge });
 
     // ── Todo continuation nudge ──────────────────────────────────────────
     // Sau mỗi tool result, inject nudge nếu còn task chưa xong.
@@ -728,7 +730,7 @@ export async function runAgent({
     {
       const tasks = pendingTasks || [];
       const msg = todoContinuationMessage(call.name, toolOk, tasks);
-      if (msg) history.push({ role: 'user', content: msg });
+      if (msg) history.push({ role: 'tool', name: 'todo_continuation', content: msg });
     }
 
     // ── Loop detection ──────────────────────────────────────────────────
@@ -818,6 +820,7 @@ async function streamWithRetry({
   model,
   message,
   image,
+  images,
   system,
   signal,
   tokenMeter,
@@ -834,6 +837,7 @@ async function streamWithRetry({
         model,
         message,
         image,
+        images,
         system,
         signal,
         effort,

package/src/api.js

@@ -158,6 +158,7 @@ export async function stream({
   mode = 'chat',
   message,
   image,
+  images,
   model,
   system,
   conversation,
@@ -188,6 +189,7 @@ export async function stream({
       mode,
       message: prompt,
       image,
+      images,
       model,
       system,
       conversation,
@@ -265,6 +267,7 @@ async function streamOnce({
   mode,
   message,
   image,
+  images,
   model,
   system,
   conversation,
@@ -281,7 +284,14 @@ async function streamOnce({
   else if (mode === 'merge') body = { message };
   else {
     body = { message, model, remember: true, memoryToken: getMemoryToken() };
-    if (image) body.image = image;
+    // Ảnh: chấp nhận cả `images` (mảng, multi-image) lẫn `image` (1 ảnh, cũ).
+    // Gửi `images` (mảng data URL) cho worker; giữ `image` = ảnh đầu cho
+    // tương thích ngược với worker/upstream cũ.
+    const imgList = Array.isArray(images) ? images.filter(Boolean) : image ? [image] : [];
+    if (imgList.length) {
+      body.images = imgList;
+      body.image = imgList[0];
+    }
     if (system) body.customInstructions = system;
     if (Array.isArray(conversation) && conversation.length) body.conversation = conversation;
     if (effort) body.effort = effort;

package/src/diff.js

@@ -8,6 +8,42 @@
 // File lớn hơn (write_file overwrite 1k+ dòng) → caller truncate trước khi gọi.
 import chalk from 'chalk';
 
+// Bề rộng khả dụng cho NỘI DUNG diff (trừ tiền tố '  │ ' = 4 cột + '+ '/'- ' = 2).
+// Cap tối thiểu 20 để không wrap loạn ở terminal hẹp; mặc định 80 khi không phải TTY.
+function contentWidth() {
+  const cols = process.stdout.columns || 80;
+  return Math.max(20, cols - 6);
+}
+
+// Soft-wrap 1 đoạn text THUẦN (không màu) thành mảng dòng có vis-width ≤ width.
+// Ưu tiên word boundary; không có space hợp lý → hard-slice. Diff text đã bị
+// slice(0,200) ở caller nên không cần ANSI-aware ở đây.
+function wrapPlain(text, width) {
+  if (text.length <= width) return [text];
+  const lines = [];
+  let remaining = text;
+  while (remaining.length > width) {
+    let cut = width;
+    const lastSpace = remaining.slice(0, width).lastIndexOf(' ');
+    if (lastSpace > width * 0.3) cut = lastSpace;
+    lines.push(remaining.slice(0, cut).trimEnd());
+    remaining = remaining.slice(cut).trimStart();
+  }
+  if (remaining) lines.push(remaining);
+  return lines.length ? lines : [''];
+}
+
+// Emit 1 dòng diff đã wrap: dòng đầu có dấu (+/-/space), dòng wrap kế thụt 2 cột
+// cho thẳng cột nội dung. Mỗi dòng con tự bọc tiền tố '│' + tô màu riêng (chalk
+// reset cuối từng đoạn) → wrap KHÔNG mất màu / mất khung.
+function emitDiffLine(out, text, color, sign) {
+  const segs = wrapPlain(text, contentWidth());
+  for (let i = 0; i < segs.length; i++) {
+    const prefix = i === 0 ? sign : '  ';
+    out.push(chalk.dim('  │ ') + color(prefix + segs[i]));
+  }
+}
+
 // LCS table giữa 2 mảng lines. Trả về matrix (M+1) x (N+1).
 function lcsTable(a, b) {
   const m = a.length;
@@ -129,11 +165,9 @@ export function renderUnifiedDiff(
         continue;
       }
       const text = String(op.text).slice(0, 200);
-      let line;
-      if (op.type === 'add') line = chalk.green('+ ') + chalk.green(text);
-      else if (op.type === 'del') line = chalk.red('- ') + chalk.red(text);
-      else line = chalk.dim('  ') + chalk.dim(text);
-      out.push(chalk.dim('  │ ') + line);
+      if (op.type === 'add') emitDiffLine(out, text, chalk.green, '+ ');
+      else if (op.type === 'del') emitDiffLine(out, text, chalk.red, '- ');
+      else emitDiffLine(out, text, chalk.dim, '  ');
       printed++;
     }
   }
@@ -153,7 +187,7 @@ export function renderNewFilePreview(content, { label = '', maxLines = 20 } = {}
   const out = [];
   out.push(chalk.dim('  ┌─ ' + label + ' ') + chalk.green(`(file MỚI · ${lines.length} dòng)`));
   for (const l of head) {
-    out.push(chalk.dim('  │ ') + chalk.green('+ ') + chalk.green(l.slice(0, 200)));
+    emitDiffLine(out, l.slice(0, 200), chalk.green, '+ ');
   }
   if (more > 0) out.push(chalk.dim('  │ ') + chalk.dim(`… +${more} dòng nữa`));
   out.push(chalk.dim('  └─'));

package/src/i18n.js

@@ -26,7 +26,6 @@ export const t = {
   // auth
   notLoggedIn:
     'Bạn chưa đăng nhập. Chạy:  noob login <api-key>\nChưa có key? Liên hệ admin để lấy key (Pro / Pro+ / Trial).',
-  loginOk: (plan) => `Đăng nhập thành công. Gói: ${plan}.`,
   loginSaved: (p) => `Đã lưu API key vào ${p}`,
   loggedOut: 'Đã đăng xuất, xoá API key khỏi máy.',
   needKeyArg: 'Thiếu key. Dùng:  noob login <api-key>',
@@ -173,11 +172,6 @@ export const t = {
   loopAutoStop: (n) => `Loop tự dừng sau tick #${n} — model phát <<LOOP_DONE>> (task hoàn tất).`,
   loopAlreadyRunning: 'Đã có loop đang chạy. /loop stop trước khi đặt loop mới.',
   learning: 'đang chưng cất bài học vào noob.md…',
-  learnSuggest: (n) =>
-    `💡 Phiên này có ${n} lượt. Gõ /learn trước để chưng cất bài học vào noob.md (sau khi /new thì history sẽ mất).`,
-  memoryStatus: (lines, rules, notes, ago) =>
-    `📝 noob.md: ${lines} dòng (${rules} rules, ${notes} notes) · cập nhật ${ago}`,
-  memoryMissing: '📝 noob.md: chưa có — gõ /init để tạo từ dự án.',
   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.',
@@ -199,12 +193,8 @@ export const t = {
     'cần mô tả yêu cầu. Ví dụ: /frontend-design landing page cho app nghe nhạc lo-fi',
   workflowRunning: 'đang chạy dynamic workflow đa sub-agent…',
   workflowNoSkill: 'không tìm thấy skills/dynamic-workflows/SKILL.md — skill chưa được cài.',
-  workflowNeedArg: 'cần mô tả task. Ví dụ: /workflow audit toàn bộ src/ tìm lỗ hổng SQL injection',
-  workflowAgentAutoOn: 'agent mode tự bật cho /workflow (cần spawn_agent)',
   workflowAgentAskHint:
     '🎼 /workflow cần spawn sub-agent (spawn_agent) — agent mode hiện đang TẮT.',
-  workflowAgentAskPrompt:
-    '  bật agent mode và chạy workflow? [y] có, bật & chạy / [n] huỷ (gõ /agent rồi chạy lại nếu muốn) › ',
   workflowAgentEnabled: 'đã bật agent mode cho workflow này.',
   bgWorkflowDone: (label) => `workflow nền ${label} đã xong`,
   bgWorkflowFailed: (label, err) => `workflow nền ${label} lỗi: ${err}`,
@@ -212,8 +202,6 @@ export const t = {
   workflowAgentDenied:
     'đã huỷ /workflow — agent mode vẫn TẮT. Gõ /agent rồi chạy lại lệnh nếu muốn.',
   // saved workflows (CRUD)
-  workflowListEmpty: (dir) =>
-    `Chưa có workflow đã lưu. Tạo bằng /workflow save <name> <yêu cầu>. Thư mục: ${dir}`,
   workflowListHeader: (dir) => `Workflow đã lưu (${dir}):`,
   workflowSaveNeedArgs: 'Cách dùng: /workflow save <name> <yêu cầu workflow>',
   workflowSaveEmptyPrompt:
@@ -228,7 +216,6 @@ export const t = {
   workflowSaveDescOk: (n, d) => `Đã thêm mô tả cho '${n}': ${d}`,
   workflowRunNeedName: 'Cách dùng: /workflow run <name> [thêm ngữ cảnh]',
   workflowRunError: (n, e) => `Không nạp được workflow '${n}': ${e}`,
-  workflowRunOk: (n) => `Chạy workflow đã lưu '${n}'…`,
   workflowRunPreviewBuiltin: (n, title) => `Built-in workflow '${n}' (${title})`,
   workflowRunPreviewSaved: (n) => `Workflow đã lưu '${n}'`,
   workflowLoadNeedName: 'Cách dùng: /workflow load <name>',
@@ -267,7 +254,6 @@ export const t = {
   updateBgDone: 'Đang cập nhật nền. Mở lại noob để dùng bản mới.',
   updateChecking: 'Đang kiểm tra cập nhật…',
   updateLatest: (cur) => `Đã ở bản mới nhất (${cur}).`,
-  updating: 'Đang cập nhật…',
   updateOk: '✓ Cập nhật xong. Mở lại noob để dùng bản mới.',
   updateFail: '✗ Cập nhật thất bại. Thử thủ công: npm i -g @noobdemon/noob-cli@latest',
 };