@noobdemon/noob-cli 1.13.0 → 1.13.2

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 Tất cả thay đổi đáng kể của `@noobdemon/noob-cli` được ghi vào file này.
 
+## [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
+- **Text-loop detection** (`src/agent.js`): model lặp cùng 1 câu liên tiếp mà không gọi tool (vd "Tôi sẽ bắt đầu bằng việc khảo sát workspace" 40 lần) — phát hiện ≥2 lần trùng → nudge `[TEXT LOOP]`, ≥3 lần → force stop `[LOOP STOPPED]`. Reset khi model gọi tool thành công.
+- **Duplicate tool call block trước execution** (`src/agent.js`): kiểm tra `duplicateToolGuidance` chạy TRƯỚC `onTool()` (chỉ post-execution trước đó).
+- **Edit-file retry guidance** (`src/tools.js` + `src/agent.js`): lỗi `old_string not found` giờ inject `NEXT REQUIRED TOOL: read_file {path,offset,limit}` + `toolErrorGuidance` system nudge ép model đọc lại file trước khi retry.
+- **Todo nudge phân biệt success/failure** (`src/agent.js`): `todoContinuationMessage` nói "vừa LỖI" khi tool trả `ERROR:`, không đẩy model lặp lại thao tác thất bại.
+- **nearbyContext mở rộng** (`src/tools.js`): context lines khi edit_file lỗi scales với độ dài `old_string` (`Math.max(8, oldLineCount + 5)`).
+
+### Verified
+- `npm test` 109/109 pass.
+
 ## [1.13.0] - 2026-06-27
 
 ### 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.0",
+  "version": "1.13.2",
   "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

@@ -475,6 +475,24 @@ export function buildUserMessage(history) {
   return parts.join('\n');
 }
 
+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.`;
+}
+
+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.`;
+}
+
+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.`;
+}
+
 // Detect câu trả lời bị cắt giữa chừng — KHÔNG phải câu hoàn chỉnh.
 // Trả true nếu text kết thúc đột ngột (thiếu dấu câu, list chưa đóng, v.v.).
 function isIncompleteResponse(text) {
@@ -563,6 +581,7 @@ export async function runAgent({
   history,
   model,
   image,
+  images,
   signal,
   onTool,
   onStatus,
@@ -578,9 +597,13 @@ export async function runAgent({
   // [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.
-  const recentCalls = []; // {name, inputStr} — theo dõi vòng lặp
+  const recentCalls = []; // {name, inputStr} — theo dõi vòng lặp tool call
   let loopDetectedCount = 0; // số lần loop detection liên tiếp — reset khi model gọi tool khác
   const MAX_LOOP_DETECTIONS = 3; // sau 3 lần loop detection liên tiếp → force stop
+  // ponytail: text-loop detection — model lặp cùng 1 câu mà không gọi tool
+  let lastTextHash = '';
+  let textRepeatCount = 0;
+  const MAX_TEXT_REPEATS = 3; // cùng text 3 lần 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 || '');
@@ -616,6 +639,7 @@ export async function runAgent({
       model,
       message,
       image,
+      images,
       system,
       signal,
       tokenMeter,
@@ -654,29 +678,59 @@ export async function runAgent({
         });
         continue;
       }
+      // ponytail: text-loop detection — model lặp cùng 1 câu không tool
+      const textHash = text.trim().slice(0, 200);
+      if (textHash === lastTextHash) {
+        textRepeatCount++;
+        if (textRepeatCount >= MAX_TEXT_REPEATS) {
+          history.push({
+            role: 'tool',
+            name: 'loop_detection',
+            content: `[TEXT LOOP × ${textRepeatCount}] Bạn vừa nói cùng 1 câu ${textRepeatCount} lần liên tiếp mà KHÔNG gọi tool. DỪNG NGAY. Gọi read_file/list_dir/grep để thực sự bắt đầu, hoặc trả lời Markdown nếu đã xong.`,
+          });
+          return `[LOOP STOPPED] Model kẹt trong vòng lặp text: "${text.slice(0, 80)}…"`;
+        }
+        history.push({
+          role: 'tool',
+          name: 'loop_detection',
+          content: `[TEXT LOOP × ${textRepeatCount}] Bạn vừa lặp lại câu trả lời giống hệt. Hãy gọi tool (read_file/grep/list_dir) hoặc trả lời Markdown khác đi. KHÔNG nói lại câu cũ.`,
+        });
+        continue; // quay lại loop, ép model gọi tool
+      }
+      lastTextHash = textHash;
+      textRepeatCount = 0;
       // Model dừng (không tool call, không incomplete) → return để repl quyết định tiếp tục hay không
       return text; // final answer
     }
 
+    const inputStr = JSON.stringify(call.input || {});
+    const prev = recentCalls[recentCalls.length - 1];
+    if (prev && prev.name === call.name && prev.inputStr === inputStr) {
+      history.push({
+        role: 'tool',
+        name: 'loop_detection',
+        content: duplicateToolGuidance(call.name, call.input),
+      });
+      continue;
+    }
+
     const { allow, result } = await onTool(call.name, call.input);
     history.push({
       role: 'tool',
       name: call.name,
       content: allow ? result : t.toolDenied,
     });
+    const toolOk = allow && !String(result || '').startsWith('ERROR:');
+    const errorNudge = allow ? toolErrorGuidance(call.name, { result }) : null;
+    if (errorNudge) history.push({ role: 'user', content: errorNudge });
 
     // ── Todo continuation nudge ──────────────────────────────────────────
     // Sau mỗi tool result, inject nudge nếu còn task chưa xong.
     // Dùng pendingTasks (caller gửi vào) thay vì parse output của model.
     {
       const tasks = pendingTasks || [];
-      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.`,
-        });
-      }
+      const msg = todoContinuationMessage(call.name, toolOk, tasks);
+      if (msg) history.push({ role: 'user', content: msg });
     }
 
     // ── Loop detection ──────────────────────────────────────────────────
@@ -685,7 +739,6 @@ export async function runAgent({
     //   (B) Pattern vòng (A-B-A-B, A-B-C-A-B-C) — model xen kẽ 2-3 tool
     //       khác nhau để tránh phát hiện cũ. So nửa đầu vs nửa cuối window.
     // Nếu phát hiện → inject cảnh báo. Nếu tái diễn → force stop.
-    const inputStr = JSON.stringify(call.input || {});
     recentCalls.push({ name: call.name, inputStr });
     if (recentCalls.length > LOOP_DETECT_WINDOW) recentCalls.shift();
     let loopType = null; // 'consecutive' | 'pattern' | null
@@ -749,6 +802,8 @@ export async function runAgent({
       });
     } else {
       loopDetectedCount = 0; // tool khác → reset
+      lastTextHash = ''; // text-loop: reset sau tool call thành công
+      textRepeatCount = 0;
     }
   }
   return t.maxSteps;
@@ -765,6 +820,7 @@ async function streamWithRetry({
   model,
   message,
   image,
+  images,
   system,
   signal,
   tokenMeter,
@@ -781,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;