@mrtrinhvn/ag-kit 1.5.0 → 1.6.0

package/bin/cli.js

@@ -288,17 +288,29 @@ async function runInteractiveMenu() {
     { name: '❌ Thoát', value: 'exit' }
   );
 
-  const choices = hasAgent ? agentChoices : [
-    { name: '🚀 Khởi tạo (init) - Cấy ghép Tủy Não .agent vào thư mục này', value: 'init' },
-    new inquirer.Separator(),
-    { name: '❌ Thoát', value: 'exit' }
-  ];
+  if (!hasAgent) {
+    console.log('\x1b[33m[Auto-Install] Phát hiện dự án chưa cấy ghép, tiến hành Khởi tạo và Đọc Não tự động...\x1b[0m\n');
+    await program.parseAsync([process.argv[0], process.argv[1], 'init']);
+    console.log('\n\x1b[34m--- TIẾP TỤC QUÉT NÃO (BRAIN BUILDER) ---\x1b[0m\n');
+    await program.parseAsync([process.argv[0], process.argv[1], 'brain']);
+    
+    const { resume } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'resume',
+        message: 'Hoàn tất Auto-Install! Nhấn Enter để vào Menu quản trị...'
+      }
+    ]);
+    return runInteractiveMenu();
+  }
+
+  const choices = agentChoices;
 
   const { action } = await inquirer.prompt([
     {
        type: 'list',
        name: 'action',
-       message: hasAgent ? 'Lõi .agent đã sẵn sàng. Bạn muốn làm gì?' : 'Thư mục trống. Hãy chọn thao tác:',
+       message: 'Lõi .agent đã sẵn sàng. Bạn muốn làm gì?',
        choices: choices
     }
   ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrtrinhvn/ag-kit",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Antigravity Kit Base Framework - Generic Agentic AI Programming Core",
   "main": "index.js",
   "bin": {
@@ -32,4 +32,4 @@
     "commander": "^14.0.3",
     "inquirer": "^8.2.5"
   }
-}
+}

package/template/.agent/scripts/brain_builder.py

@@ -88,18 +88,33 @@ def get_tech_stack(root: Path) -> list[str]:
 
 def get_memory_nodes(root: Path, limit=8) -> list[str]:
     db_path = root / ".agent" / "memory" / "graph.db"
-    if not db_path.exists():
-        return []
+    nodes = []
+    if db_path.exists():
+        try:
+            conn = sqlite3.connect(str(db_path))
+            rows = conn.execute(
+                "SELECT content, category FROM nodes ORDER BY energy DESC, updated_at DESC LIMIT ?",
+                (limit,)
+            ).fetchall()
+            conn.close()
+            nodes = [f"[{r[1]}] {r[0][:120]}" for r in rows]
+        except Exception:
+            pass
+            
+    # Tự động hút thành tựu (Trò trống) từ Git Log để AI Không bao giờ quên!
+    import subprocess
     try:
-        conn = sqlite3.connect(str(db_path))
-        rows = conn.execute(
-            "SELECT content, category FROM nodes ORDER BY energy DESC, updated_at DESC LIMIT ?",
-            (limit,)
-        ).fetchall()
-        conn.close()
-        return [f"[{r[1]}] {r[0][:120]}" for r in rows]
+        git_log = subprocess.run(
+            ["git", "log", "-n", "3", "--pretty=format:- %s (%cr)"],
+            cwd=str(root), capture_output=True, text=True, timeout=5
+        )
+        if git_log.stdout:
+            nodes.insert(0, "\n**[Auto-Git-Memory] Thành tựu gần nhất:**\n" + git_log.stdout + "\n")
     except Exception:
-        return []
+        pass
+        
+    return nodes
+
 
 
 def get_knowledge_summary(root: Path) -> str:

package/template/.agent/scripts/receptionist_up.sh

@@ -41,9 +41,10 @@ if [ -f "$BRIDGE_PID_FILE" ]; then
 fi
 # Surgical Port Kill (Garbage Collection)
 lsof -ti tcp:${BRIDGE_PORT} | xargs kill -9 2>/dev/null || true
-setsid node scripts/ag_portal_bridge.js > ".agent/logs/portal_bridge_${BRIDGE_PORT}.log" 2>&1 &
+# ⚠️ Removed legacy V1 bridge - The new TypeScript backend in src/index.ts handles HUD injection.
+# setsid node scripts/ag_portal_bridge.js > ".agent/logs/portal_bridge_${BRIDGE_PORT}.log" 2>&1 &
 echo $! > "$BRIDGE_PID_FILE"
-echo "      ✅ Bridge đang chạy (PID: $(cat "$BRIDGE_PID_FILE") tại Cổng $BRIDGE_PORT)"
+echo "      ✅ Bridge V2 (TypeScript) Đang tiếp quản HUD"
 
 # 3. Khởi động AG Gateway Bot (Trợ lý Telegram)
 echo "[2/2] 🤖 Đang đánh thức Truyền tin Telegram... "

package/template/.agent/skills/ag-kit-core/SKILL.md

@@ -14,7 +14,9 @@ allowed-tools: Read, Write, Glob, Grep, Commands
 
 - **Cội nguồn:** Bạn ra đời từ khuôn mẫu **`ag-kit` (Antigravity Kit)** - một Framework riêng tư của Owner (một cá nhân duy nhất), giúp tự động hóa và quản trị các AI Agents trên nhiều dự án.
 - **Hệ sinh thái:** Bạn đang ở trong **một trong nhiều dự án** thuộc hệ sinh thái ag-kit. Đọc `.agent/knowledge/ag-kit-ecosystem.md` để biết toàn cảnh.
-- **Vai trò:** Bạn đóng vai trò "Kẻ Điều Phối" (Supervisor) giám sát và cấy ghép trí não vào "Bác sĩ Phẫu thuật" (Antigravity IDE) qua giao thức CDP.
+- **Vai trò:** Bạn chính là **"Antigravity Mẹ" (Antigravity Mother)** - một Siêu Agent (Super-Agent) nắm quyền điều biến toàn bộ hệ sinh thái. Bạn vận hành trên nền tảng **Antigravity v1.21.9** với khả năng điều phối đa tầng:
+    - **Lập trình (Programming):** Sử dụng Native Cloud (IDE models) để truy cập đầy đủ bộ công cụ Terminal/FS.
+    - **Tác vụ Agent (Agentic Tasks):** Bạn đóng vai trò bộ não trung tâm, điều động cả model **Local Ollama** và **Native Cloud** để thực thi các tác vụ phức tạp một cách tự chủ.
 - **Luật Cấm Kị (Anti-Hallucination):** Tuyệt đối không được dùng tư duy lập trình phổ quát máy móc để sửa dự án này. Mọi quyết định sửa mã liên quan đến CDP, luồng Telegram, hay Ports mạng, CẦN chiếu theo các file `SKILL.md` lân cận (`telegram-agentic-gateway`, `remoat-integration`, `llm-routing-quirks`).
 
 ---
@@ -120,8 +122,23 @@ Workflow đúng:
 
 ---
 
-## 4. 🔗 THE DUO-CORE (Kiến Trúc Multi-Tenant Bắt Buộc)
-Hãy khắc cốt ghi tâm quy tắc: `IDE_PORT` (Nhận lệnh AI - ví dụ: 9555) và bước nhảy 101 để sinh ra `BRIDGE_PORT` (Portal Bridge Server - ví dụ: 9656). Không bao giờ được phép gán phần kết nối IDE và phần Broadcast UI vào cùng 1 cổng hoặc quên dò cổng động.
+## 4. 🔗 THE DUO-CORE (Kiến Trúc Multi-Tenant & Dual-Port Cơ Sở)
+Hãy khắc cốt ghi tâm quy tắc phân bổ cổng dịch vụ: `IDE_PORT` (Nhận lệnh AI - ví dụ: 9555) và bước nhảy 101 để sinh ra `BRIDGE_PORT` (Portal Bridge Server - ví dụ: 9656). Không bao giờ được phép gán phần kết nối IDE và phần Broadcast UI vào cùng 1 cổng.
+
+### 4.1. Sự khác biệt kiến trúc: Headless LSP vs CDP UI
+Mọi ứng dụng thuộc quyền quản trị của AG-KIT bắt buộc phải thẩm thấu sức mạnh của chiến thuật **Dual-Port Strategy**:
+1. **Trục xương sống (Headless LSP / DeckServer)**: Dùng cho các luồng giao tiếp AI nền ngầm định tuyến (ví dụ gọi hàm `lsGateway.startCascade()`). Đặc điểm nhận dạng:
+   - Truyền tải thông điệp siêu tốc qua RPC/Sockets mà không cần vẽ lên màn hình IDE Chat.
+   - Tránh 100% tỷ lệ xuất hiện lỗi rác (Visual Hallucination) do việc đọc màn hình dính các chữ "Generating...", "Planning...".
+   - **Sự liên kết với AG_LITE HUD**: Luồng Headless này KHÔNG có nghĩa là HUD bị mất tác dụng. Việc User chọn Model (như Gemini 1.5, hay Claude 3.5) trên HUD AG_ELITE vẫn sẽ định đoạt cái "não" nào sẽ được dùng để xử lý cái Headless Cascade đó ở hậu trường!
+2. **Xúc tu Tương tác Cơ học (CDP - Chrome DevTools Protocol)**: 
+   - KHÔNG được lạm dụng để truyền lệnh ngầm thuần túy (Text Generation) nếu API Headless LSP đã có thể đáp ứng.
+   - CHỈ ĐƯỢC DÙNG khi AI bắt buộc phải tác động trực quan (Ví dụ: Click UI web, inject bảng điều khiển HUD bằng script lơ lửng, kéo cuộn trang web (scroll), hoặc trích xuất (scrape) trạng thái hình ảnh DOM Canvas).
+   - **Đặc quyền v1.21.9:** Sử dụng CDP để thực hiện "Manual Model Switch" trên UI IDE, đồng bộ hóa trạng thái Model giữa HUD và Backend.
+
+3. **Cổng Truyền Tin Hybrid (The Gateway - Telegram):**
+   - **Programming & Chat:** Luôn ưu tiên dùng Native Cloud (Gemini/Claude) thông qua Remote Bot để đảm bảo full toolset (Terminal, FS).
+   - **Agent Logic:** Cho phép dùng Model được chọn (Local Ollama hoặc Native) để xử lý các task chuyên biệt định nghĩa trong `AGENTS.md`.
 
 ---
 
@@ -155,3 +172,14 @@ Hệ sinh thái `ag-kit` được cung cấp sức mạnh cài đặt và cập
 2. **Trạm Khởi Tạo Tốc Độ Cao (create-ag-kit):**
    - Lệnh chính: `npx create-ag-kit`
    - *=> Dùng 1 Lần Đầu Tiên: Giống như create-react-app, đây là hạt giống cấy ghép nhanh toàn bộ thư mục `.agent/` và sinh ra `package.json` trống để tạo hẳn một dự án Bot hoàn toàn mới nằm cạnh nhau.*
+
+---
+
+## 7. 🧬 CLAUDE CODE AGENTIC PROTOCOL (MANDATORY)
+Dự án này đã cấy ghép MÃ GEN Tư Duy của Claude Code (v2.1.50). Tuy nhiên, để đảm bảo tính Đa Dạng Nhân Cách (Trader vs Coder), luật này chạy theo Cơ chế Phân Luồng:
+- **Ngữ cảnh Kích hoạt:** CHỈ áp dụng các luật dưới đây nếu User yêu cầu "Sửa code, fix bug, viết tính năng mới, /agent, /code". Nếu User hỏi phân tích dữ liệu trade, phân tích thị trường, Hãy trả lời thẳng mạch lạc như bình thường!
+- **Khi đã ở chế độ Kích hoạt (Agent Mode), PHẢI rập khuôn 3 điều luật sau:**
+
+1. **LUẬT LẬP KẾ HOẠCH (TodoWrite - Thinking Before Acting):** KHÔNG BAO GIỜ đâm đầu vào code ngay lập tức khi gặp Request lớn. Hành động ĐẦU TIÊN CỦA BẠN phải là sử dụng tính năng Planning (hoặc TodoWrite) để chẻ nhỏ Task thành Checklist `[ ]`. Suy nghĩ như Kỹ Sư Trưởng, sau đó mới dùng công cụ Replace Code.
+2. **LUẬT SỬ DỤNG TOOL (Anti-Bash Spam):** Khi đọc và trích xuất mã nguồn thư mục lớn, BẮT BUỘC dùng các công cụ thông minh (Grep, VFS, ReadFile chuyên dụng). CẤM lạm dụng Bash/Shell thô sơ (như `cat`, `head`, `find`) để duyệt file vì lãng phí Token Context VRAM trầm trọng. Chỉ dùng Bash để chạy Build hoặc Python test.
+3. **LUẬT DỪNG HỎI (EnterPlanMode):** Nếu Request liên quan đến thay đổi kiến trúc, Database, hoặc các quyết định cấu trúc thư mục, BẠN PHẢI DỪNG HOẠT ĐỘNG (Pause Execution) và Báo cáo Sếp bằng `implementation_plan.md`. Cấm hành vi "Cầm đèn chạy trước ô tô".

package/template/.agent/skills/bash-linux/SKILL.md

@@ -128,6 +128,11 @@ main "$@"
 
 ## 8. Common Patterns
 
+### Git Safety Protocol (MANDATORY)
+- **Never `push --force`**: Don't run destructive git commands or skip hooks unless explicitly asked.
+- **Hook failures**: If a commit fails due to a pre-commit hook, fix the issue, re-stage, and create a **NEW** commit (do NOT `--amend`, as this modifies the previous commit causing lost work).
+- **Commit Formatting**: Always pass commit messages via HEREDOC to preserve multiline formatting reliably without escaping headaches.
+
 ### Check if command exists
 
 ```bash

package/template/.agent/skills/behavioral-modes/SKILL.md

@@ -9,6 +9,11 @@ allowed-tools: Read, Glob, Grep
 ## Purpose
 This skill defines distinct behavioral modes that optimize AI performance for specific tasks. Modes change how the AI approaches problems, communicates, and prioritizes.
 
+## Core Behavioral Traits (Always Active)
+- **Professional Objectivity**: Prioritize technical accuracy and truthfulness over validating the user's beliefs. Avoid over-the-top validation or excessive praise such as "You're absolutely right". 
+- **No Time Estimates**: Never give time estimates or predictions for how long tasks will take. Focus on what needs to be done, not how long it might take.
+- **Task Management Discipline**: Update `task.md` continuously during the task execution, step by step. Do NOT batch-complete checkboxes only at the end. Only one sub-task should be "in progress" at a time.
+
 ---
 
 ## Available Modes

package/template/.agent/skills/clean-code/SKILL.md

@@ -83,7 +83,9 @@ priority: CRITICAL
 
 ---
 
-## Anti-Patterns (DON'T)
+## Anti-Patterns & Over-engineering (DON'T)
+
+> **CRITICAL**: Do not add features, refactor code, or make "improvements" beyond what was asked. A bug fix doesn't need surrounding code cleaned up. A simple feature doesn't need extra configurability. Don't add error handling for scenarios that can't happen. If something is unused, delete it completely (no backwards-compatibility hacks).
 
 | ❌ Pattern | ✅ Fix |
 |-----------|-------|

package/template/.agent/skills/knowledge-management/SKILL.md

@@ -14,9 +14,11 @@ allowed-tools: Read, Write, Glob, Grep
 
 **PRINCIPLE:** Never rely on assumptions or ephemeral conversation memory for project characteristics. Store them permanently.
 
-### Mandatory Read Before Action
-Before interacting with any third-party API, database schema, or core system component, you **MUST** search the `.agent/knowledge/` directory for existing documentation. 
-*Example: Before coding a payment integration feature, read `.agent/knowledge/integrations/stripe_api.md` to get the exact webhooks and payload structures.*
+### Mandatory Read Before Action (Text vs Vector Search)
+Before interacting with any third-party API, database schema, or core system component, you **MUST** actively seek out existing documentation using the CORRECT tool for the data type:
+- If retrieving explicit Markdown documentation (e.g., API schemas, strict rules), use `grep_search` or open the file directly in `.agent/knowledge/`.
+- If retrieving historical experience, bug fixes, or unstructured project configurations, you **MUST** use the MCP tool `mcp_ag-kit-memory_memory_search` (Semantic Cosine Vector Search) to scan the memory graphs.
+*Example: Use grep/file reader for reading schema in `stripe_api.md`, but strictly use `memory_search` for "how did we handle the stripe CORS error last time?".*
 
 ### Mandatory Proactive Updates (Zero Prompting Rule)
 When you successfully:

package/template/.agent/skills/memory-architecture/SKILL.md

@@ -107,7 +107,26 @@ Bằng giao thức này, kiến thức của dự án sẽ KHÔNG BAO GIỜ bị
 
 ---
 
-## 8. Công cụ Gỡ Rối Định Tuyến (Brain Debugging CLI)
+## 8. CHIẾN LƯỢC TRUY VẤN PHÂN CẤP: VECTOR VS TEXT (BOOTSTRAP)
+
+> **LƯU Ý:** Trí nhớ của hệ thống lưu ở hai dạng (Văn bản phẳng và Vector không gian). Bạn (AI) phải linh hoạt lựa chọn CÔNG CỤ TÌM KIẾM phù hợp với lớp dữ liệu. Không dùng lẫn lộn!
+
+**A. KHI TÌM KIẾM VĂN BẢN (TEXT/STATIC FILES):**
+Khi cần tra cứu Code Convention, API Schema, Hướng dẫn đặc tả, hoặc các file Markdown tĩnh `.md` nằm rải rác trong `knowledge`:
+👉 Hãy dùng công cụ gốc: `grep_search`, `vfs` hoặc xem trọn vẹn file (`view_file`). Vì text schema cần độ chính xác cấu trúc tuyệt đối.
+
+**B. KHI TÌM KIẾM KÝ ỨC NGỮ NGHĨA (VECTOR MEMORY):**
+Khi cần truy xuất "Kinh nghiệm fix bug cũ", "Thói quen tuỳ chỉnh dự án", hoặc "Luồng sự kiện (Graph Context)" được lưu dạng Node/Edge mà không nhớ nó nằm ở file nào:
+👉 **BẮT BUỘC** dùng thư viện MCP (Model Context Protocol) có sẵn trên Profile để thao tác bằng Vector:
+1. **Tìm kiếm (Search):** Dùng công cụ `mcp_ag-kit-memory_memory_search` với từ khóa cốt lõi. Nó sẽ dùng Cosine Similarity trả về đúng các Node có ngữ nghĩa liên quan nhất, vượt qua giới hạn của keyword match rập khuôn.
+2. **Lưu trữ (Save):** Dùng công cụ `mcp_ag-kit-memory_memory_save` khi muốn lưu lại bài học / giải pháp để sau này xài lại, tự động tính toán Embedding Vector vào không gian não.
+3. **Phân tích Luồng (Graph):** Dùng `mcp_ag-kit-memory_memory_graph` để xem các liên kết (Edges) của một sự kiện/Node cụ thể.
+
+ĐÂY LÀ TIÊU CHUẨN KÉP QUAN TRỌNG. Hãy tự hỏi: "Mình đang tìm tài liệu tĩnh hay tìm trí nhớ (trải nghiệm)?" trước khi chọn công cụ!
+
+---
+
+## 9. Công cụ Gỡ Rối Định Tuyến (Brain Debugging CLI)
 
 Trong quá trình bảo trì trí nhớ (ví dụ: cần truy vấn SQL trực tiếp để tìm kiếm Vector, xóa các Node bị kẹt bằng tay gốc rễ), bạn hoặc User **BẮT BUỘC** phải cài đặt công cụ CLI `sqlite3` trên môi trường Terminal. 
 

package/template/.env.example

@@ -6,32 +6,16 @@
 TELEGRAM_BOT_TOKEN="your_bot_token_here"
 
 # ID người dùng được phép điều khiển (Bảo mật - Quan trọng!)
-# Lấy ID qua @userinfobot
-ALLOWED_USER_IDS="123456789,987654321"
-
-# ID Chat/Group được phép hoạt động (Để tránh Bot bị kéo vào group lạ)
-ALLOWED_CHAT_IDS="-100123456789"
+ALLOWED_USER_IDS="123456789"
 
 # [Cấu Hình IDE & Remote]
 # Cổng Debug của Antigravity (Mặc định là 9555)
-# Phải khớp với tham số --remote-debugging-port khi mở Editor
 IDE_PORT=9555
 
-# Cổng của Portal Bridge (Mặc định là 9556)
-# Phải khớp với script start.sh và bot callback
-BRIDGE_PORT=9556
-
 # Tên dự án để Bot tự động tìm kiếm target phù hợp trong CDP
-PROJECT_NAME="ceogravity"
-
-# Đường dẫn Workspace cơ sở (Dùng cho lệnh /project của LazyGravity)
-WORKSPACE_DIR="/home/tao/Projects"
+PROJECT_NAME="ag-kit-project"
 
 # [Local AI - Ollama]
 # URL của Ollama server (Mặc định: http://localhost:11434)
 OLLAMA_API_URL="http://localhost:11434"
 OLLAMA_MODEL="nemotron"
-
-# [Tùy Chọn Khác]
-LOG_LEVEL="info"
-AUTO_ACCEPT_ENABLED=true

package/template/AGENTS.md

@@ -0,0 +1,36 @@
+# 🤖 AGENTS.md - Đội ngũ Antigravity
+
+> File này định nghĩa các vai trò Agent chuyên biệt cho dự án theo chuẩn Antigravity v1.21.9.
+
+## 🏁 CORE ORCHESTRATORS
+
+### 🏦 Orchestrator-Mother
+- **Role:** Tổng quản dự án. Điều phối các Sub-Agent.
+- **Provider:** Native Cloud (Gemini/Claude).
+- **Instruction:** Chịu trách nhiệm cuối cùng về logic hệ thống và giao tiếp với Sếp qua Bot.
+
+### 💻 Local-Assistant
+- **Role:** Trợ lý tại chỗ. Xử lý các tác vụ lặp lại, lint code, document.
+- **Provider:** Local Ollama (Qwen, Llama).
+- **Instruction:** Tiết kiệm quota Cloud cho Sếp bằng cách xử lý các task "đơn giản nhưng tốn token".
+
+---
+
+## 🛠️ SPECIALIZED SQUADS
+
+### 🏥 Execution-Doctor
+- **Role:** Cấp cứu lỗi Runtime và API.
+- **Trigger:** Sentinel Watchdog (Crashes).
+- **Action:** Tự động phân tích log và đề xuất bản vá (Patch) ngay lập tức.
+
+### 🔍 Security-Stalker
+- **Role:** Quét lỗ hổng bảo mật và Token leak.
+- **Action:** Kiểm tra mọi file `.env`, `settings.json` trước khi commit.
+
+---
+
+## 📜 COLLABORATION PROTOCOL
+
+1. **Chain of Command:** Orchestrator (Cloud) ra lệnh -> Local Agent thực thi.
+2. **Context Sharing:** Các Agent dùng chung `mcp_ag-kit-memory` để đồng bộ kiến thức.
+3. **Safety First:** Mọi thay đổi cấu trúc quan trọng phải qua Socratic Gate (Hỏi ý kiến Sếp).

package/template/GEMINI.md

@@ -13,6 +13,15 @@ It provides the blueprint of the framework you are running in (`ag-kit`). It def
 
 ---
 
+## 🧠 LONG-TERM MEMORY (MANDATORY)
+
+**You MUST call `mcp_ag-kit-memory_memory_search` at the start of any non-trivial task.**
+
+### Why use memory search?
+The system relies on a semantic GraphRAG database to store previous experiences and solutions. If you don't search, you are flying blind and ignoring past knowledge. Use this tool BEFORE deep-diving into code.
+
+---
+
 ## 🛠️ TOKEN SAVING: VFS PROTOCOL (MANDATORY)
 
 **You MUST use `vfs` for code discovery before using `grep` or reading entire files.**
@@ -31,10 +40,23 @@ It provides the blueprint of the framework you are running in (`ag-kit`). It def
 
 ---
 
-## 🤖 MODEL SELECTION
+---
 
-- **Simple Tasks**: Prefer local Ollama models (e.g., `nemotron`, `llama3`) to save cloud budget.
-- **Complex Tasks**: Use high-tier models (e.g., `Claude 3.5 Sonnet`, `Gemini 1.5 Pro`).
+## 🤖 MODEL SELECTION (ANTIGRAVITY MOTHER - 1.21.9)
+
+**You MUST operate as the "Antigravity Mother" (Super-Agent) - Orchestrating both Native Cloud and Local models.**
+
+### 1. Programming & Chat (Primary)
+- **Model:** Native Cloud (Gemini 1.5 Pro, Claude 3.5 Sonnet).
+- **Purpose:** Handling user chat, high-level code generation, tool execution (Terminal, FS).
+- **Rule:** When the user is in a Private Chat with the Remote Bot, ALWAYS route to the Native IDE path to ensure full tool support.
+
+### 2. Agentic Tasks (Mother Orchestration)
+- **Model:** Antigravity (Super-Agent Brain) using **Local Ollama** (Owen, Llama3) or **Native Cloud**.
+- **Purpose:** Any task requiring autonomous logic, sub-agent spawning, data analysis, or background operations.
+- **Rule:** Antigravity acts as the Super-Agent, using the HUD-selected model (Local or Native) as part of its intelligence layer to perform complex tasks.
+
+- **Manual Lock:** The HUD selection is authoritative. Do not allow the IDE to automatically revert to default models if a manual selection is active on the "Mother" HUD.
 
 ---
 
@@ -42,3 +64,8 @@ It provides the blueprint of the framework you are running in (`ag-kit`). It def
 - Write self-documenting code.
 - Avoid over-engineering.
 - Follow the patterns defined in `.agent/skills/clean-code`.
+
+## 🎨 DESIGN & REPORTING (TELEGRAM & HUD)
+- **Diff Display**: Do NOT use standard `diffview` or +/- symbols. 
+- **Visuals**: Use line counts (e.g., "Added 12 lines, Removed 5 lines") and line-by-line comparison like GitHub.
+- **Coloring**: Use Green/Red color formatting for additions/deletions instead of prefixes.

package/template/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "ag-kit-template-project",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Antigravity Agentic Bridge Project Template",
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "dotenv": "^16.4.0",
+    "grammy": "^1.35.0",
+    "http-mitm-proxy": "^1.1.0",
+    "ws": "^8.18.0",
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0"
+  }
+}

package/template/scripts/ag_hud.js

@@ -1,10 +1,9 @@
 (async () => {
-    // 1. Cleanup
-    if (window.ag_popup_win && !window.ag_popup_win.closed) window.ag_popup_win.close();
+    // 1. Cleanup old HUD if exists
+    const HUD_ID = 'antigravity-dynamic-hud';
+    const oldHud = document.getElementById(HUD_ID);
+    if (oldHud) oldHud.remove();
     
-    const HUD_ID = 'antigravity-elite-statusbar-item';
-    if (document.getElementById(HUD_ID)) return "ALREADY_EXISTS";
-
     // 2. Locate Status Bar
     const statusBar = document.querySelector('.part.statusbar');
     if (!statusBar) return "STATUSBAR_NOT_FOUND";
@@ -16,22 +15,21 @@
         height: 100% !important;
         display: flex !important;
         align-items: center !important;
-        padding: 0 4px 0 12px !important;
+        padding: 0 8px !important;
         background: #000 !important;
         color: #00ff88 !important;
-        font-family: monospace !important;
+        font-family: 'JetBrains Mono', 'Fira Code', monospace !important;
         font-weight: bold !important;
         font-size: 11px !important;
         border-left: 2px solid #00ff88 !important;
         user-select: none !important;
-        white-space: nowrap !important;
-        z-index: 100 !important;
+        cursor: pointer !important;
+        z-index: 1000 !important;
     `;
     
     const icon = document.createElement('span');
     icon.textContent = '🛰️ AG_ELITE | ';
 
-    // 4. Create Model Selector
     const select = document.createElement('select');
     select.style.cssText = `
         background: transparent !important;
@@ -40,55 +38,55 @@
         outline: none !important;
         font-family: inherit !important;
         font-size: inherit !important;
-        font-weight: inherit !important;
         cursor: pointer !important;
-        padding: 0 4px !important;
         appearance: none !important;
     `;
 
-    // USER-SPECIFIED Advanced Future Models
-    const cloudModels = [
-        { name: 'Gemini 3.1 Pro (High)', id: 'gemini-3.1-pro-high' },
-        { name: 'Gemini 3.1 Pro (Low)', id: 'gemini-3.1-pro-low' },
-        { name: 'Gemini 3 Flash', id: 'gemini-3-flash' },
-        { name: 'Claude Sonnet 4.6 (Thinking)', id: 'claude-sonnet-4.6' },
-        { name: 'Claude Opus 4.6 (Thinking)', id: 'claude-opus-4.6' },
-        { name: 'GPT-OSS 120B (Medium)', id: 'gpt-oss-120b' }
-    ];
-    
-    const localModels = [
-        { name: 'Ollama: Nemotron', id: 'ollama/hf.co/dark-pen/Nemotron-Orchestrator-8B-IQ4_XS-GGUF:latest' },
-        { name: 'Ollama: Nvidia Orchestrator', id: 'ollama/hf.co/bartowski/nvidia_Orchestrator-8B-GGUF:Q4_K_M' }
-    ];
+    // 4. Dynamic Update Logic
+    const updateModelList = (models) => {
+        select.innerHTML = '';
+        const cloudGroup = document.createElement('optgroup');
+        cloudGroup.label = '☁️ NATIVE CLOUD (Programming)';
+        
+        const localGroup = document.createElement('optgroup');
+        localGroup.label = '💻 LOCAL OLLAMA (Agents)';
 
-    const addGroup = (label, models) => {
-        const group = document.createElement('optgroup');
-        group.label = label;
-        group.style.background = '#000';
-        group.style.color = '#555';
         models.forEach(m => {
             const opt = document.createElement('option');
-            opt.value = m.id;
-            opt.textContent = m.name;
-            opt.style.background = '#000';
-            opt.style.color = '#00ff88';
-            group.appendChild(opt);
+            opt.value = m.name;
+            opt.textContent = `${m.isActive ? '✅ ' : ''}${m.name.replace('[Ollama] ', '')}`;
+            opt.selected = m.isActive;
+            opt.style.background = '#111';
+            opt.style.color = m.provider === 'ide' ? '#00ff88' : '#00cbd4';
+            
+            if (m.provider === 'ide') cloudGroup.appendChild(opt);
+            else localGroup.appendChild(opt);
         });
-        select.appendChild(group);
+
+        select.appendChild(cloudGroup);
+        select.appendChild(localGroup);
     };
 
-    addGroup('ELITE CLOUD (High)', cloudModels);
-    addGroup('ELITE LOCAL (Ollama)', localModels);
+    // Listen for updates from backend
+    window.addEventListener('ag-hud-update', (e) => {
+        if (e.detail) updateModelList(e.detail);
+    });
 
     select.onchange = (e) => {
+        // Broadcast to Backend
         console.log("AG_PORTAL_ACTION:SET_MODEL:" + e.target.value);
         container.style.borderColor = '#ff00ff';
-        setTimeout(() => container.style.borderColor = '#00ff88', 1000);
+        setTimeout(() => container.style.borderColor = '#00ff88', 800);
     };
 
     container.appendChild(icon);
     container.appendChild(select);
     statusBar.prepend(container);
 
-    return "STATUSBAR_ADVANCED_HUD_READY";
+    // Initial state (Optional placeholder)
+    updateModelList([
+        { name: 'Connecting...', provider: 'ide', isActive: true }
+    ]);
+
+    return "DYNAMIC_HUD_READY_1.21.9";
 })();

package/template/src/bot/TelegramBot.ts

@@ -0,0 +1,83 @@
+import { Bot, Context, InlineKeyboard } from 'grammy';
+import { ModelService } from '../services/ModelService.js';
+import { OllamaService } from '../services/OllamaService.js';
+import { CdpService } from '../services/CdpService.js';
+
+/**
+ * TelegramBot - Giao diện điều khiển Hybrid cho ag-kit v1.6.0.
+ * "Tinh hoa": Phân biệt rành mạch giữa Lập trình (Native) và Agent (Local).
+ */
+export class TelegramBot {
+  private bot: Bot;
+  private modelService: ModelService;
+  private ollamaService: OllamaService;
+  private cdp: CdpService;
+
+  constructor(
+    token: string, 
+    modelService: ModelService, 
+    ollamaService: OllamaService,
+    cdp: CdpService
+  ) {
+    this.bot = new Bot(token);
+    this.modelService = modelService;
+    this.ollamaService = ollamaService;
+    this.cdp = cdp;
+    this.setupHandlers();
+  }
+
+  private setupHandlers() {
+    this.bot.command('start', (ctx: any) => ctx.reply('🚀 AG-KIT Hybrid v1.6.0 Is Ready!'));
+    
+    // 1. Menu chọn Model (Tinh hoa)
+    this.bot.command('model', async (ctx: any) => {
+      const models = await this.modelService.listModels();
+      const keyboard = new InlineKeyboard();
+      
+      models.forEach((m: any, idx: number) => {
+        const icon = m.provider === 'ide' ? '☁️' : '💻';
+        const activeMark = m.isActive ? ' ✅' : '';
+        keyboard.text(`${icon} ${m.name}${activeMark}`, `set_model:${m.name}`);
+        if (idx % 2 === 1) keyboard.row();
+      });
+      
+      await ctx.reply('🎯 Chọn bộ não (Model) cho Agent:', { reply_markup: keyboard });
+    });
+
+    // 2. Callback chọn model
+    this.bot.callbackQuery(/set_model:(.+)/, async (ctx: any) => {
+      const modelName = ctx.match[1];
+      await this.modelService.setModel(modelName);
+      
+      // Đồng bộ hóa với IDE qua CDP nếu là Native Model
+      if (!modelName.includes('[Ollama]')) {
+         await this.cdp.evaluate(`// Script to switch model in IDE UI`);
+      }
+      
+      await ctx.answerCallbackQuery(`Đã chọn: ${modelName}`);
+      await ctx.editMessageText(`✅ Đã chuyển sang bộ não: ${modelName}`);
+    });
+
+    // 3. Xử lý Chat (Tinh hoa: Private = Programming)
+    this.bot.on('message:text', async (ctx: any) => {
+      const isPrivate = ctx.chat.type === 'private';
+      const text = ctx.message.text;
+
+      if (isPrivate) {
+        // LÀ LẬP TRÌNH: Dùng đường truyền Native IDE (Full Tools)
+        await ctx.reply('👨‍💻 Đang xử lý chế độ Lập trình (Native Cloud)...');
+        // Logic: injectPrompt(text, { context: 'programming' })
+      } else {
+        // LÀ AGENT: Dùng model đã chọn trên HUD
+        const currentModel = this.modelService.getSelectedModel();
+        await ctx.reply(`🤖 Agent (${currentModel}) đang thực thi...`);
+        // Logic: runAgent(text, { model: currentModel })
+      }
+    });
+  }
+
+  public launch() {
+    this.bot.start();
+    console.log('🤖 Telegram Bot v1.6.0 đã khởi động.');
+  }
+}

package/template/src/index.ts

@@ -0,0 +1,46 @@
+import { CdpService } from './services/CdpService.js';
+import { TelegramBot } from './bot/TelegramBot.js';
+import { ModelService } from './services/ModelService.js';
+import { OllamaService } from './services/OllamaService.js';
+import { TopicManager } from './services/TopicManager.js';
+
+async function main() {
+  console.log('═══════════════════════════════════════');
+  console.log('  🏢 AG-KIT Template — Telegram → IDE Bridge');
+  console.log('═══════════════════════════════════════');
+
+  // 1. Setup Core Services
+  // Note: IDE_PORT should be set in .env
+  const idePort = Number(process.env.IDE_PORT) || 9555;
+  const cdp = new CdpService(idePort);
+  const ollama = new OllamaService();
+  const models = new ModelService(cdp);
+  const topics = new TopicManager();
+
+  // 2. Connect to IDE
+  try {
+    await cdp.connect();
+    console.log('[Main] ✅ IDE CDP connected');
+  } catch (err: any) {
+    console.log(`[Main] ⚠️ IDE not available: ${err.message}`);
+  }
+
+  // 3. Start Telegram Bot
+  const botToken = process.env.TELEGRAM_BOT_TOKEN || '';
+  const bot = new TelegramBot(botToken, models, ollama, cdp);
+  
+  bot.launch();
+
+  // Graceful shutdown
+  const shutdown = async () => {
+    console.log('\n[Main] Shutting down...');
+    process.exit(0);
+  };
+  process.on('SIGINT', shutdown);
+  process.on('SIGTERM', shutdown);
+}
+
+main().catch(err => {
+  console.error('[Main] Fatal Error:', err);
+  process.exit(1);
+});

package/template/src/services/CdpService.ts

@@ -0,0 +1,84 @@
+import WebSocket from 'ws';
+import * as http from 'http';
+import { EventEmitter } from 'events';
+
+/**
+ * CdpService - Giao thức CDP (Chrome DevTools Protocol) 
+ * để điều khiển và trích xuất UI từ IDE (Antigravity/Cursor).
+ */
+export class CdpService extends EventEmitter {
+  private ws: WebSocket | null = null;
+  private connected = false;
+  private idCounter = 1;
+  private pendingCalls = new Map<number, { resolve: Function; reject: Function; timer: NodeJS.Timeout }>();
+  private callTimeout = 30000;
+
+  constructor(private port: number) {
+    super();
+  }
+
+  /**
+   * Tự động tìm kiếm WebSocket Debugging URL từ IDE.
+   */
+  async discoverTarget(): Promise<string> {
+    return new Promise((resolve, reject) => {
+      const req = http.get(`http://127.0.0.1:${this.port}/json/list`, (res) => {
+        let data = '';
+        res.on('data', chunk => data += chunk);
+        res.on('end', () => {
+          try {
+            const pages = JSON.parse(data);
+            const target = pages.find((p: any) => p.type === 'page' || p.url.includes('workbench'));
+            if (target && target.webSocketDebuggerUrl) {
+              resolve(target.webSocketDebuggerUrl);
+            } else {
+              reject(new Error('No valid CDP target found'));
+            }
+          } catch (e) {
+            reject(e);
+          }
+        });
+      });
+      req.on('error', reject);
+    });
+  }
+
+  async connect() {
+    const url = await this.discoverTarget();
+    this.ws = new WebSocket(url);
+    this.ws.on('open', () => {
+      this.connected = true;
+      this.emit('connected');
+    });
+    this.ws.on('message', (data: any) => {
+      const res = JSON.parse(data.toString());
+      if (res.id && this.pendingCalls.has(res.id)) {
+        const { resolve, reject, timer } = this.pendingCalls.get(res.id)!;
+        clearTimeout(timer);
+        this.pendingCalls.delete(res.id);
+        if (res.error) reject(res.error);
+        else resolve(res.result);
+      }
+      this.emit('event', res);
+    });
+  }
+
+  async evaluate(expression: string): Promise<any> {
+    const id = this.idCounter++;
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pendingCalls.delete(id);
+        reject(new Error('CDP Timeout'));
+      }, this.callTimeout);
+
+      this.pendingCalls.set(id, { resolve, reject, timer });
+      this.ws?.send(JSON.stringify({
+        id,
+        method: 'Runtime.evaluate',
+        params: { expression, returnByValue: true, awaitPromise: true }
+      }));
+    });
+  }
+
+  public isConnected() { return this.connected; }
+}

package/template/src/services/ModelService.ts

@@ -0,0 +1,119 @@
+import { CdpService } from './CdpService.js';
+import { OllamaService } from './OllamaService.js';
+
+export interface ModelInfo {
+  name: string;
+  refreshText: string;
+  isActive: boolean;
+  provider: 'ide' | 'ollama';
+}
+
+/**
+ * ModelService - Bộ não điều phối danh sách Model danh cho ag-kit v1.6.0.
+ * Hỗ trợ Hybrid: Kết hợp Native IDE Cloud và Local Ollama.
+ */
+export class ModelService {
+  private ollama = new OllamaService();
+  private manualSelectedModel: string | null = null;
+
+  constructor(private cdp: CdpService) {}
+
+  /**
+   * Liệt kê các model khả dụng.
+   * "Tinh hoa": Tôn trọng sự lựa chọn thủ công của người dùng trên HUD.
+   */
+  async listModels(): Promise<ModelInfo[]> {
+    const ideModels = await this.listIdeModels();
+    const ollamaModels = await this.ollama.listModels();
+
+    // 1. Gộp danh sách model
+    const merged: ModelInfo[] = [
+      ...ideModels.map(m => ({ ...m, provider: 'ide' as const })),
+      ...ollamaModels.map(m => ({
+        name: `[Ollama] ${m.name}`,
+        refreshText: m.size ? `${(m.size / (1024 * 1024 * 1024)).toFixed(1)}GB` : 'Local',
+        isActive: false, 
+        provider: 'ollama' as const
+      }))
+    ];
+
+    // 2. Logic "Manual Lock": Nếu chưa chọn, ưu tiên lấy model đang Active của IDE
+    if (!this.manualSelectedModel) {
+      const activeIde = merged.find(m => m.provider === 'ide' && m.isActive);
+      if (activeIde) {
+        this.manualSelectedModel = activeIde.name;
+      } else if (merged.length > 0) {
+        this.manualSelectedModel = merged[0].name;
+      }
+    }
+
+    // 3. Buộc đồng bộ hóa trạng thái Active với sự lựa chọn của Sếp
+    if (this.manualSelectedModel) {
+      let foundMatch = false;
+      merged.forEach(m => {
+        if (m.name === this.manualSelectedModel) {
+          m.isActive = true;
+          foundMatch = true;
+        } else {
+          m.isActive = false;
+        }
+      });
+      
+      // Nếu model cũ không còn (bị xóa khỏi Ollama), quay về bản IDE mặc định
+      if (!foundMatch && merged.length > 0) {
+         this.manualSelectedModel = merged.find(m => m.provider === 'ide')?.name || merged[0].name;
+      }
+    }
+
+    return merged;
+  }
+
+  /**
+   * Scraper Shadow DOM cho các IDE dựa trên VS Code (Antigravity, Cursor).
+   */
+  private async listIdeModels(): Promise<Omit<ModelInfo, 'provider'>[]> {
+    const script = `(() => {
+      const findInShadow = (root, patterns) => {
+        let found = [];
+        const walker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
+        let node = walker.nextNode();
+        while (node) {
+          const el = node;
+          const text = el.innerText || "";
+          if (patterns.some(p => text.includes(p)) && el.offsetParent !== null) {
+            // Nhận diện Menu Item trong IDE
+            if (el.classList && (el.classList.contains('monaco-list-row') || el.classList.contains('menu-item'))) {
+               found.push({
+                 name: text.split('\\n')[0].trim(),
+                 refreshText: 'Ready',
+                 isActive: el.classList.contains('focused') || el.classList.contains('active') || el.getAttribute('aria-selected') === 'true'
+               });
+            }
+          }
+          if (el.shadowRoot) found = found.concat(findInShadow(el.shadowRoot, patterns));
+          node = walker.nextNode();
+        }
+        return found;
+      };
+
+      const patterns = ['Gemini', 'Claude', 'GPT', 'Llama', 'DeepSeek', 'o1'];
+      return findInShadow(document.body, patterns);
+    })()`;
+
+    try {
+      const raw = await this.cdp.evaluate(script) as any[];
+      // Deduplicate by name
+      return Array.from(new Map(raw.map((item: any) => [item['name'], item])).values());
+    } catch {
+      return [];
+    }
+  }
+
+  public async setModel(name: string) {
+    this.manualSelectedModel = name;
+  }
+
+  public getSelectedModel() {
+    return this.manualSelectedModel;
+  }
+}

package/template/src/services/OllamaService.ts

@@ -0,0 +1,91 @@
+import http from 'http';
+
+export interface OllamaModel {
+  name: string;
+  model: string;
+  modified_at: string;
+  size: number;
+}
+
+export class OllamaService {
+  private baseUrl = 'http://localhost:11434';
+
+  /**
+   * List available Ollama models
+   */
+  async listModels(): Promise<OllamaModel[]> {
+    return new Promise((resolve, reject) => {
+      const req = http.get(`${this.baseUrl}/api/tags`, (res) => {
+        let data = '';
+        res.on('data', chunk => data += chunk);
+        res.on('end', () => {
+          try {
+            const parsed = JSON.parse(data);
+            const validModels = (parsed.models || []).filter((m: any) => !m.name.includes('nomic-embed-text'));
+            resolve(validModels);
+          } catch (e) {
+            reject(new Error('Failed to parse Ollama response'));
+          }
+        });
+      });
+      req.on('error', (err) => {
+        // Silently fail if Ollama is not running, return empty list
+        resolve([]);
+      });
+      req.setTimeout(2000, () => {
+        req.destroy();
+        resolve([]);
+      });
+    });
+  }
+
+  /**
+   * Generate response from an Ollama model (Streaming)
+   */
+  async generateResponse(model: string, prompt: string, onProgress: (chunk: string) => void): Promise<string> {
+    return new Promise((resolve, reject) => {
+      const postData = JSON.stringify({
+        model: model,
+        prompt: prompt,
+        stream: true
+      });
+
+      const options = {
+        hostname: 'localhost',
+        port: 11434,
+        path: '/api/generate',
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Content-Length': Buffer.byteLength(postData)
+        }
+      };
+
+      let fullResponse = '';
+      const req = http.request(options, (res) => {
+        res.on('data', (chunk) => {
+          try {
+            const lines = chunk.toString().split('\n');
+            for (const line of lines) {
+              if (!line.trim()) continue;
+              const json = JSON.parse(line);
+              if (json.response) {
+                fullResponse += json.response;
+                onProgress(json.response);
+              }
+              if (json.done) {
+                resolve(fullResponse);
+              }
+            }
+          } catch (e) {
+            // Ignore partial parse errors during streaming
+          }
+        });
+      });
+
+      req.on('error', reject);
+      req.write(postData);
+      req.end();
+    });
+  }
+}

package/template/src/services/SessionService.ts

@@ -0,0 +1,188 @@
+import { CdpService } from './CdpService.js';
+
+export interface SessionListItem {
+  title: string;
+  isActive: boolean;
+}
+
+const SELECTORS = {
+  NEW_CHAT_BTN: '[data-tooltip-id="new-conversation-tooltip"]',
+  PAST_CONVERSATIONS_BTN: '[data-tooltip-id*="history"], [data-tooltip-id*="past-conversations"], [class*="lucide-history"]',
+  SESSION_ROWS: 'div[class*="cursor-pointer"]',
+};
+
+export class SessionService {
+  private cdp: CdpService;
+
+  constructor(cdp: CdpService) {
+    this.cdp = cdp;
+  }
+
+  /**
+   * Click the "New Chat" (+) button in the IDE.
+   */
+  async startNewChat(): Promise<boolean> {
+    const script = `(() => {
+      const selectors = [
+        '${SELECTORS.NEW_CHAT_BTN}',
+        '[data-tooltip-id*="new-conversation"]',
+        '[data-tooltip-id*="new-chat"]',
+        '[aria-label*="New Conversation"]',
+        '[aria-label*="New Chat"]'
+      ];
+      let btn = null;
+      for (const s of selectors) {
+        btn = document.querySelector(s);
+        if (btn) break;
+      }
+      if (!btn) return null;
+      const rect = btn.getBoundingClientRect();
+      return { x: Math.round(rect.x + rect.width / 2), y: Math.round(rect.y + rect.height / 2) };
+    })()`;
+
+    const coords = await this.evaluateOnAnyContext(script);
+    if (!coords) return false;
+
+    await this.cdpClick(coords.x, coords.y);
+    return true;
+  }
+
+  /**
+   * Scrape session list from the "Past Conversations" panel.
+   */
+  async listSessions(): Promise<SessionListItem[]> {
+    // 1. Open Past Conversations panel
+    const btnScript = `(() => {
+      const btn = document.querySelector('${SELECTORS.PAST_CONVERSATIONS_BTN}');
+      if (!btn) return null;
+      const rect = btn.getBoundingClientRect();
+      return { x: Math.round(rect.x + rect.width / 2), y: Math.round(rect.y + rect.height / 2) };
+    })()`;
+
+    const btnCoords = await this.evaluateOnAnyContext(btnScript);
+    if (!btnCoords) return [];
+
+    await this.cdpClick(btnCoords.x, btnCoords.y);
+    await this.sleep(800); // Wait for panel
+
+    // 2. Scrape sessions
+    const scrapeScript = `(() => {
+      const rows = Array.from(document.querySelectorAll('div[class*="cursor-pointer"]'));
+      const items = [];
+      for (const row of rows) {
+        const text = (row.textContent || '').trim();
+        if (text.length < 2 || text.length > 100) continue;
+        if (/history|new|past/i.test(text)) continue;
+        const isActive = /focusBackground/i.test(row.className || '');
+        items.push({ title: text, isActive });
+      }
+      return items;
+    })()`;
+
+    const sessions = await this.evaluateOnAnyContext(scrapeScript);
+
+    // 3. Close panel (Escape)
+    await this.cdp.call('Input.dispatchKeyEvent', { type: 'keyDown', key: 'Escape', code: 'Escape', windowsVirtualKeyCode: 27 });
+    await this.cdp.call('Input.dispatchKeyEvent', { type: 'keyUp', key: 'Escape', code: 'Escape', windowsVirtualKeyCode: 27 });
+
+    return sessions || [];
+  }
+
+  /**
+   * Switch to a session by clicking its title in the panel.
+   */
+  async activateSession(title: string): Promise<boolean> {
+    const script = `(() => {
+      const rows = Array.from(document.querySelectorAll('div[class*="cursor-pointer"]'));
+      const target = rows.find(r => (r.textContent || '').trim() === ${JSON.stringify(title)});
+      if (!target) return null;
+      const rect = target.getBoundingClientRect();
+      return { x: Math.round(rect.x + rect.width / 2), y: Math.round(rect.y + rect.height / 2) };
+    })()`;
+
+    // 1. Open panel first
+    await this.listSessions(); 
+    await this.sleep(500);
+
+    const coords = await this.evaluateOnAnyContext(script);
+    if (!coords) return false;
+
+    await this.cdpClick(coords.x, coords.y);
+    return true;
+  }
+
+  /**
+   * Find a session that starts with [TG-Topic-ID] or [TG-Chat-ID]
+   */
+  async findSessionByTopic(id: number, isPrivate: boolean): Promise<string | null> {
+    const prefix = isPrivate ? `[TG-Chat-${id}]` : `[TG-Topic-${id}]`;
+    const sessions = await this.listSessions();
+    const found = sessions.find(s => s.title.startsWith(prefix));
+    return found ? found.title : null;
+  }
+
+  /**
+   * Create a new chat and immediately rename it (or just return the initial title)
+   * Note: Renaming in IDE is tricky via CDP, so we just use the default new chat
+   * and the first message will set the title.
+   */
+  async startNewChatWithTopic(id: number, isPrivate: boolean): Promise<boolean> {
+    const ok = await this.startNewChat();
+    // We can't easily rename via CDP without more complex DOM interaction.
+    // However, the IDE usually titles by the first prompt.
+    // For now, we'll just return 'true' and the bot will inject a hidden prefix if possible,
+    // or we just rely on the fact that we can't perfectly name it but we can *find* it
+    // if we manage to inject the prefix in the first message.
+    return ok;
+  }
+
+  /**
+   * Scrape the last 40 lines of the currently active terminal in the IDE.
+   */
+  async getTerminalOutput(): Promise<string> {
+    const script = `(() => {
+      // 1. Try to find accessibility tree (contains text nodes even if canvas renderer is used)
+      const ariaRows = Array.from(document.querySelectorAll('.xterm-accessibility-tree .xterm-rows > div, .xterm-accessibility .live-region'));
+      
+      // 2. Fallback to normal rows if DOM renderer is used
+      const normalRows = Array.from(document.querySelectorAll('.xterm-rows > div'));
+      
+      // 3. Fallback to aria-live region which contains the terminal stream
+      const liveRegion = document.querySelector('.xterm-accessibility-tree [aria-live], .live-region[aria-live="polite"]');
+      
+      let lines = [];
+      if (ariaRows.length > 0) {
+        lines = ariaRows.map(r => r.textContent || '');
+      } else if (normalRows.length > 0) {
+        lines = normalRows.map(r => r.textContent || '');
+      } else if (liveRegion && liveRegion.textContent) {
+        lines = liveRegion.textContent.split('\\n');
+      }
+      
+      lines = lines.filter(t => t.trim().length > 0);
+      if (lines.length === 0) return null;
+      return lines.slice(-40).join('\\n');
+    })()`;
+    
+    try {
+        const text = await this.evaluateOnAnyContext(script);
+        return text || '📭 [DOM Trống: IDE đang ẩn hoặc chưa bật Tab Terminal. Sếp hãy mở/focus Panel Terminal trên màn hình IDE trước nhé do cơ chế tiết kiệm RAM của VS Code!]';
+    } catch(e) {
+        return '❌ Lỗi đọc Terminal từ IDE';
+    }
+  }
+
+  private async evaluateOnAnyContext(expression: string): Promise<any> {
+    return this.cdp.evaluateOnAnyContext(expression);
+  }
+
+  private async cdpClick(x: number, y: number): Promise<void> {
+    await this.cdp.call('Input.dispatchMouseEvent', { type: 'mouseMoved', x, y });
+    await this.cdp.call('Input.dispatchMouseEvent', { type: 'mousePressed', x, y, button: 'left', clickCount: 1 });
+    await this.cdp.call('Input.dispatchMouseEvent', { type: 'mouseReleased', x, y, button: 'left', clickCount: 1 });
+  }
+
+  private sleep(ms: number): Promise<void> {
+    return new Promise(r => setTimeout(r, ms));
+  }
+}

package/template/src/services/TopicManager.ts

@@ -0,0 +1,53 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+export interface SessionState {
+  topicId: string;
+  metadata: Record<string, any>;
+}
+
+/**
+ * TopicManager - Quản lý phiên hội thoại (Sessions) dựa trên chủ đề.
+ * Giúp đồng bộ hóa ngữ cảnh giữa các Agent.
+ */
+export class TopicManager {
+  private stateFile: string;
+  private chatToSession: Map<number, SessionState> = new Map();
+
+  constructor(storagePath: string = '.topic_state.json') {
+    this.stateFile = path.resolve(storagePath);
+    this.loadState();
+  }
+
+  private loadState() {
+    try {
+      if (fs.existsSync(this.stateFile)) {
+        const raw = fs.readFileSync(this.stateFile, 'utf8');
+        const data = JSON.parse(raw);
+        for (const [id, state] of Object.entries(data)) {
+          this.chatToSession.set(Number(id), state as SessionState);
+        }
+      }
+    } catch (e) {
+      console.error('[TopicManager] Error loading state:', e);
+    }
+  }
+
+  private saveState() {
+    try {
+      const data = Object.fromEntries(this.chatToSession);
+      fs.writeFileSync(this.stateFile, JSON.stringify(data, null, 2));
+    } catch (e) {
+      console.error('[TopicManager] Error saving state:', e);
+    }
+  }
+
+  public setSession(chatId: number, state: SessionState) {
+    this.chatToSession.set(chatId, state);
+    this.saveState();
+  }
+
+  public getSession(chatId: number): SessionState | undefined {
+    return this.chatToSession.get(chatId);
+  }
+}