vg-coder-cli 2.0.49 → 2.0.51

package/INTEGRATION.md

@@ -29,6 +29,7 @@ External Service ◀── POST <webhookUrl>    (push, retry 3×)
 - **Workers**: mỗi tab Chrome trên `aistudio.google.com` với extension VG Coder = 1 worker. Server tự load-balance song song giữa các worker idle.
 - **Launchers**: mỗi Chrome profile = 1 launcher (background service worker của extension). Dùng để mở/đóng tab AI Studio và lock model cho từng task.
 - **Auto-recycle**: sau mỗi task done/failed, server gọi launcher đóng tab worker đó + mở lại tab mới với `?model=<target>` — guarantee model lock per task. Mark worker `recycling` để tránh race.
+- **Idle tab TTL** (v2.0.50+): sau khi recycle xong, nếu không có task mới trong `VG_WORKER_IDLE_TTL_MS` (default `120000` = 2 phút), launcher đóng tab → CPU container về ~0%. Task tiếp theo sẽ trigger `launcher:open_aistudio` để mở lại tab. Set `VG_WORKER_IDLE_TTL_MS=0` để giữ tab always-on (behavior cũ); set `=1` để đóng ngay sau mỗi task.
 - **Failover**: rate-limit / quota error → mark worker `rate_limited` 30 phút, requeue task sang worker khác (max 3 attempts). Tab giữ nguyên qua cooldown (không recycle khi rate-limited).
 - **Default model**: `gemini-3-flash-preview` (free + multimodal — verified working với image + PDF). Avoid `-lite` (text-only) hoặc `-pro-preview` (paid alias to Deep Research).
 - **Persistence**: tasks lưu vào `.vg/tasks/<id>/{task.json,result.md,files/}` của active project.
@@ -39,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:
@@ -402,7 +407,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`)