vg-coder-cli 2.0.50 → 2.0.52

package/INTEGRATION.md

@@ -40,9 +40,13 @@ External Service ◀── POST <webhookUrl>    (push, retry 3×)
 
 ```bash
 npm install -g vg-coder-cli   # hoặc: cd repo && npm run build
-vg start                      # khởi động server :6868
+vg start                      # khởi động server :6868 (loopback)
+vg start --host 0.0.0.0       # bind LAN/Docker
+vg start --worker             # ẩn bubble + dashboard panel trên tab AI Studio
 ```
 
+> **Worker-only mode** (`--worker`): server inject `window.__VG_WORKER_ONLY__=true` vào bundle khi serve `/dist/vg-coder-bundle.js`. Dashboard sẽ ẩn `#vg-coder-shadow-host` và chỉ chạy `initTaskWorker()` — không render bubble + tool panels. REST API vẫn đầy đủ. Sau khi đổi flag phải **reload tab AI Studio** để bundle mới load.
+
 ### Worker (browser tab)
 
 Mỗi Google account muốn dùng → 1 Chrome profile riêng:
@@ -180,7 +184,7 @@ Server có thể chủ động list / đóng / mở tab AI Studio trong từng p
 |---|---|---|---|
 | `GET` | `/api/launcher/tabs` | `?label=<email>` (optional) | List tabs trong profile (hoặc all profiles nếu bỏ label) |
 | `POST` | `/api/launcher/close-tab` | `{ workerLabel?, tabId? }` | Đóng tab cụ thể, hoặc tất cả tab AI Studio nếu bỏ `tabId` |
-| `POST` | `/api/launcher/open-tab` | `{ workerLabel?, model?, url?, active? }` | Mở tab mới. `model` mặc định `gemini-3-flash-preview` |
+| `POST` | `/api/launcher/open-tab` | `{ workerLabel?, model?, url?, active? }` | Mở tab mới. `model` mặc định `gemini-3-flash-preview`. Response v2.0.52+ kèm `requested_model` / `actual_model` / `fallback_occurred` để detect AI Studio silent-fallback (account thiếu access tới preview model) |
 
 ```bash
 # List tab tất cả profile
@@ -193,6 +197,26 @@ curl -X POST -d '{"workerLabel":"alice@gmail.com","model":"gemini-3-flash-previe
   -H 'Content-Type: application/json' http://127.0.0.1:6868/api/launcher/open-tab
 ```
 
+`open-tab` response (v2.0.52+):
+
+```json
+{
+  "ok": true,
+  "tabId": 477055248,
+  "windowId": 477055217,
+  "url": "https://aistudio.google.com/prompts/new_chat?model=gemini-3-flash-preview",
+  "requested_url": "https://aistudio.google.com/prompts/new_chat?model=gemini-3-pro-preview",
+  "requested_model": "gemini-3-pro-preview",
+  "actual_model": "gemini-3-flash-preview",
+  "fallback_occurred": true
+}
+```
+
+Khi `fallback_occurred: true` — AI Studio đã redirect sang model khác do account
+không có access. Client nên check field này để fail-fast hoặc retry với model
+khác. Trước v2.0.52, response chỉ trả URL request → silent quality degradation
+không detect được.
+
 ### Modal auto-handling
 
 AI Studio thỉnh thoảng pop modal chặn task. Worker tự detect + click button đúng (poll mỗi 400 ms):
@@ -403,7 +427,7 @@ User vẫn có thể:
 
 ```bash
 curl http://127.0.0.1:6868/health
-# {"status":"ok","version":"2.0.48"}
+# {"status":"ok","version":"2.0.50"}
 ```
 
 ## End-to-end smoke test

package/README.md

@@ -73,13 +73,20 @@ vg clean --output ./my-output
 
 #### 4. **Khởi động API Server** 🆕
 ```bash
-# Start server (mặc định port 6868)
+# Start server (mặc định port 6868, bind 127.0.0.1)
 vg start
 vg s                    # Alias rút gọn
 
 # Custom port
 vg start -p 8080
 
+# Bind LAN/Docker (cho phép truy cập từ host khác)
+vg start --host 0.0.0.0
+
+# Worker-only mode: ẩn bubble + dashboard panel trên tab AI Studio,
+# chỉ chạy task automation (cho server headless điều phối từ xa)
+vg start --worker
+
 # Browser tự động mở dashboard tại http://localhost:6868
 ```
 
@@ -94,7 +101,7 @@ GET http://localhost:6868/health
 ```json
 {
   "status": "ok",
-  "version": "2.0.48",
+  "version": "2.0.50",
   "timestamp": "2026-05-09T10:07:13.000Z"
 }
 ```
@@ -194,6 +201,8 @@ Content-Type: application/json
 | Option | Mô tả | Default |
 |--------|-------|---------|
 | `-p, --port <port>` | Port cho server | 6868 |
+| `--host <host>` | Bind address. Set `0.0.0.0` cho LAN/Docker port-forward (env: `VG_HOST`) | 127.0.0.1 |
+| `--worker` | Worker-only mode: ẩn bubble + dashboard panel trên tab AI Studio, chỉ giữ task automation | false |
 
 ## 🎨 Dashboard UI
 
@@ -369,7 +378,13 @@ MIT License - xem file [LICENSE](LICENSE) để biết thêm chi tiết.
 
 ## 📊 Version History
 
-### v2.0.48 (Latest)
+### v2.0.50 (Latest)
+- 🤖 Worker-only mode (`vg start --worker`): server prepend `window.__VG_WORKER_ONLY__=true` vào bundle, dashboard skip bubble + panels, chỉ chạy `initTaskWorker()` — tab AI Studio sạch không bị che bởi UI
+- ⏲️ Idle worker tab TTL (env `VG_WORKER_IDLE_TTL_MS`, default 120 000): không có task mới → launcher đóng tab → CPU container về 0%; task tới sẽ tự mở lại tab
+- 🐳 Configurable bind address: `vg start --host 0.0.0.0` (hoặc env `VG_HOST`) cho LAN/Docker port-forward
+- 🧱 Dynamic CSP bypass via `chrome.declarativeNetRequest.updateDynamicRules` — fix lỗi parse static rules.json trên Chromium 120 (Linux/Docker)
+
+### v2.0.48
 - 🤖 Remote Task API: external service push task chat AI Studio + nhận callback (`POST /api/tasks` + webhook)
 - 🧠 Multi-worker pool: mỗi Chrome profile = 1 worker, parallel + auto-failover khi rate-limit
 - 🪟 Launcher SW per profile + tab management API (`GET /api/launcher/tabs`, `POST /api/launcher/{open,close}-tab`)