@mrtrinhvn/ag-kit 1.4.3 → 1.4.6

package/README.md

@@ -58,6 +58,19 @@ Gói `ag-kit` khuyến khích nguyên lý kết hợp 2 AI:
 
 > Vui lòng tải model: `ollama pull nomic-embed-text` để kích hoạt tính năng Semantic Search của `ag-kit`.
 
+## 🚀 Agentic Port Fusion (Cơ chế Hợp Thể Cổng)
+
+AG-Kit sử dụng kỹ thuật **JSON Introspection** và **Chromium Multiplexing** để giải quyết vĩnh viễn bài toán đụng độ Cổng (Port) khi chạy nhiều Agent/IDE cùng lúc trên một máy:
+
+1. **Lớp IDE (Cổng Trạm - `IDE_PORT`):** 
+   - Mọi dự án có thể **dùng chung một cổng duy nhất (VD: 9555)**. 
+   - `start.sh` sẽ tự động ping cổng 9555, dùng `curl` quét danh sách JSON (`/json/list`) xem dự án của mình đã mở chưa.
+   - Nếu chưa, nó ra lệnh cho Chrome tự động rẽ nhánh thêm một cửa sổ (Workspace) ngay trên cổng 9555 đó. Bot của dự án nào sẽ tự động bắt đúng UUID WebSocket của dự án đó! Chấm dứt cảnh spam Port làm rác cấu hình.
+
+2. **Lớp Bot (Cổng Nội Bộ - `BRIDGE_PORT`):**
+   - Không thể xài chung do giới hạn của Node.js. 
+   - Khi chạy lệnh `ag-kit init`, AG-Kit sẽ tự động săn tìm một cổng Bridge đang trống (từ 9656 trở lên) và cấp phát **độc quyền** cho dự án thông qua file `.env`.
+
 ---
 
 ## 🔄 Cập nhật & Bảo trì

package/bin/cli.js

@@ -32,16 +32,44 @@ program
 
 program.command('init')
   .description('Cấy ghép Lõi Trí Nhớ (.agent) vào dự án này')
-  .action(() => {
+  .action(async () => {
     console.log('\x1b[36m🚀 Đang khởi tạo bộ Tủy Não Lập Trình AI (AG-Kit)...\x1b[0m');
     
     const srcAgent = path.join(TEMPLATE_DIR, '.agent');
     if (!fs.existsSync(TARGET_AGENT_DIR)) {
       copyRecursiveSync(srcAgent, TARGET_AGENT_DIR);
       fs.writeFileSync(path.join(TARGET_AGENT_DIR, '.version'), pkg.version);
-      console.log(`\x1b[32m✅ Đã cấy ghép thành công thư mục .agent (v${pkg.version}) vào Project!\x1b[0m`);
+
+      ['scripts', 'start.sh', 'stop_bot.sh', '.gitignore'].forEach(item => {
+        const srcPath = path.join(TEMPLATE_DIR, item);
+        const destPath = path.join(process.cwd(), item);
+        if (fs.existsSync(srcPath) && !fs.existsSync(destPath)) {
+          copyRecursiveSync(srcPath, destPath);
+        }
+      });
+
+      const net = require('net');
+      const getPort = (port) => new Promise((resolve) => {
+          const s = net.createServer();
+          s.listen(port, () => { s.close(() => resolve(port)); });
+          s.on('error', () => { resolve(getPort(port + 1)); });
+      });
+      const bridgePort = await getPort(9656);
+      
+      const envEx = path.join(TEMPLATE_DIR, '.env.example');
+      if (fs.existsSync(envEx) && !fs.existsSync('.env')) {
+         let content = fs.readFileSync(envEx, 'utf-8');
+         const projectName = path.basename(process.cwd());
+         content = content.replace(/PROJECT_NAME=.*/, `PROJECT_NAME=${projectName}`);
+         content = content.replace(/BRIDGE_PORT=.*/, `BRIDGE_PORT=${bridgePort}`);
+         fs.writeFileSync('.env', content);
+         console.log(`\x1b[32m✅ Đã cấp phát .env với BRIDGE_PORT=${bridgePort} độc quyền.\x1b[0m`);
+      }
+
+      console.log(`\x1b[32m✅ Đã cấy ghép thành công AG-Kit (v${pkg.version}) vào Project!\x1b[0m`);
       
-      console.log('\x1b[35m👉 Bước tiếp theo: Hãy chọn menu "Build Bộ Não" để quét dự án.\x1b[0m');
+      console.log('\x1b[35m👉 Bước 1: Mở .env và điền TELEGRAM_BOT_TOKEN.\x1b[0m');
+      console.log('\x1b[35m👉 Bước 2: Chạy "./start.sh" để gọi Bot thức dậy.\x1b[0m');
     } else {
       console.log('\x1b[33m⚠️ Thư mục .agent đã tồn tại.\x1b[0m');
       const vPath = path.join(TARGET_AGENT_DIR, '.version');
@@ -122,7 +150,7 @@ program.command('memory')
 
 program.command('gateway')
   .description('Kiểm tra trạng thái Agentic Gateway (IDE, Ollama, Telegram)')
-  .action(() => {
+  .action(async () => {
     console.log('\x1b[36m🤖 Đang kiểm tra hệ sinh thái Agentic Gateway...\x1b[0m');
     if (!fs.existsSync(TARGET_AGENT_DIR)) {
       console.log('\x1b[31m❌ Chưa cấy ghép .agent.\x1b[0m');
@@ -130,20 +158,43 @@ program.command('gateway')
     }
     const envPath = path.join(process.cwd(), '.env');
     let targetPort = null;
+    let bridgePort = null;
     if (fs.existsSync(envPath)) {
-      const match = fs.readFileSync(envPath, 'utf-8').match(/IDE_PORT=(\d+)/);
-      if (match) targetPort = parseInt(match[1]);
+      const content = fs.readFileSync(envPath, 'utf-8');
+      const matchIde = content.match(/IDE_PORT=(\d+)/);
+      if (matchIde) targetPort = parseInt(matchIde[1]);
+      const matchBridge = content.match(/BRIDGE_PORT=(\d+)/);
+      if (matchBridge) bridgePort = parseInt(matchBridge[1]);
     }
     
+    // 1. Kiểm tra lớp IDE (Hub)
     if (targetPort) {
       try { 
         execSync(`curl -s --max-time 2 http://127.0.0.1:${targetPort}/json/version`, { stdio: 'ignore' }); 
-        console.log(`\x1b[32m✅ IDE CDP: Cổng riêng của dự án (${targetPort}) đang Online!\x1b[0m`); 
+        console.log(`\x1b[32m✅ IDE CDP: Cổng Trạm (Hub ${targetPort}) đang Online!\x1b[0m`); 
       } catch (e) {
-        console.log(`\x1b[31m❌ IDE CDP: Cổng dự án (${targetPort}) Offline. Hãy chạy IDE với port này.\x1b[0m`);
+        console.log(`\x1b[31m❌ IDE CDP: Cổng Trạm (Hub ${targetPort}) Offline. Chạy ./start.sh để tự gọi.\x1b[0m`);
       }
     } else {
-      console.log(`\x1b[33m⚠️ IDE CDP: Không tìm thấy IDE_PORT trong .env. Khuyên dùng "ag-kit init" để cấp port.\x1b[0m`);
+      console.log(`\x1b[33m⚠️ IDE CDP: Không tìm thấy IDE_PORT trong .env.\x1b[0m`);
+    }
+
+    // 2. Kiểm tra lớp Bot Nodejs (Bridge)
+    if (bridgePort) {
+      const net = require('net');
+      const checkBridge = () => new Promise((resolve) => {
+         const s = new net.Socket();
+         s.setTimeout(2000);
+         s.on('connect', () => { s.destroy(); resolve(true); });
+         s.on('error', () => { resolve(false); });
+         s.on('timeout', () => { s.destroy(); resolve(false); });
+         s.connect(bridgePort, '127.0.0.1');
+      });
+      const up = await checkBridge();
+      if (up) console.log(`\x1b[32m✅ BRIDGE: Cổng nội bộ Bot (${bridgePort}) đang Online!\x1b[0m`);
+      else console.log(`\x1b[31m❌ BRIDGE: Cổng nội bộ Bot (${bridgePort}) đang Offline. Bot chưa nhúng.\x1b[0m`);
+    } else {
+      console.log(`\x1b[33m⚠️ BRIDGE: Không tìm thấy BRIDGE_PORT trong .env.\x1b[0m`);
     }
     
     try {
@@ -196,28 +247,48 @@ program.command('status')
 async function runInteractiveMenu() {
   const inquirer = require('inquirer');
   console.clear();
-  console.log('\x1b[35m\n🧠 AG-KIT - BẢNG ĐIỀU KHIỂN HỆ SINH THÁI AI\x1b[0m');
-  console.log('\x1b[34m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m');
 
   const hasAgent = fs.existsSync(TARGET_AGENT_DIR);
   const vPath = path.join(TARGET_AGENT_DIR, '.version');
   let updateTag = '';
+  let hasUpdate = false;
+  let statusText = '\x1b[31mTrắng\x1b[0m';
+  
   if (hasAgent && fs.existsSync(vPath)) {
     const installed = fs.readFileSync(vPath, 'utf-8').trim();
+    statusText = `\x1b[32mv${installed}\x1b[0m`;
     if (installed !== pkg.version) {
-      updateTag = `\x1b[31m(Có bản mới: v${pkg.version})\x1b[0m `;
+      updateTag = `\x1b[31m(Cần lên v${pkg.version})\x1b[0m `;
+      hasUpdate = true;
     }
   }
 
-  const choices = hasAgent ? [
+  let brainStatus = '\x1b[33mChưa quét\x1b[0m';
+  const brainPath = path.join(TARGET_AGENT_DIR, 'brain', 'summary.md');
+  if (hasAgent && fs.existsSync(brainPath)) {
+    brainStatus = '\x1b[32mĐã có não\x1b[0m';
+  }
+
+  console.log('\x1b[35m\n🧠 AG-KIT - BẢNG ĐIỀU KHIỂN HỆ SINH THÁI AI\x1b[0m');
+  console.log(`   Lõi: ${statusText}  |  Nhận thức: ${brainStatus}`);
+  console.log('\x1b[34m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m');
+
+  const agentChoices = [
     { name: `🧠 Xây dựng / Cập nhật Bộ Não (build brain) - Thu thập Context`, value: 'brain' },
     { name: `🕸️ Khám phá Ký ức (memory) - Xem dữ liệu Vector`, value: 'memory' },
     { name: `🤖 Kiểm tra Agentic Gateway (gateway) - Test IDE/Bot`, value: 'gateway' },
-    { name: `🔄 Nâng cấp Kiến thức (update) ${updateTag}`, value: 'update' },
-    { name: '📊 Trạng thái (status) - Xem version & độ nhận thức', value: 'status' },
+  ];
+
+  if (hasUpdate) {
+    agentChoices.push({ name: `🔄 Nâng Cấp Kiến Thức (update) ${updateTag}`, value: 'update' });
+  }
+
+  agentChoices.push(
     new inquirer.Separator(),
     { 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' }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrtrinhvn/ag-kit",
-  "version": "1.4.3",
+  "version": "1.4.6",
   "description": "Antigravity Kit Base Framework - Generic Agentic AI Programming Core",
   "main": "index.js",
   "bin": {

package/template/.agent/knowledge/ag-kit-ecosystem.md

@@ -141,7 +141,21 @@ Khi đang làm việc ở Project A và cần hiểu Project B:
 
 ---
 
-## 8. KHỞI ĐỘNG PROJECT MỚI (Bootstrap Protocol)
+## 8. CƠ CHẾ PORT FUSION (Cấp phát động và Hợp thể)
+
+Để giúp Agentic Server (Cầu nối) và Lõi Trí Tuệ (IDE Chromium) không dẫm chân lên nhau khi Owner chạy nhiềuvproject cùng lúc, hệ sinh thái sử dụng kiến trúc phân tầng Port:
+
+- **`IDE_PORT` (Khuyến nghị dùng chung 9555)**: 
+  Lớp hệ điều hành Chromium hỗ trợ **Multiplexing - Dùng chung Hub**, cho phép hàng chục dự án dùng chung 1 cổng mạng duy nhất. Script `start.sh` tích hợp "JSON X-Ray", tự động ping vào cổng 9555 để kiểm tra JSON API `/json/list` xem project của mình đã nạp chưa. 
+  - Nếu có: Hệ thống tự trích xuất UUID (mấu WebSocket) và hợp thể. 
+  - Nếu không: Nó ép tiến trình Chromium đang chạy rẽ thêm Workspace, tuyệt đối không spam port ảo.
+
+- **`BRIDGE_PORT` (Cấp phát động từ 9656)**: 
+  Lớp kết nối mạng nội bộ Node.js (phục vụ Gateway/Telegram) đòi hỏi giao thức **độc quyền**. Lệnh `ag-kit init` sẽ tự động săn một cổng rỗng trên hệ điều hành vật lý (9656++) và khắc tử vào trong file `.env` của project mới.
+
+---
+
+## 9. KHỞI ĐỘNG PROJECT MỚI (Bootstrap Protocol)
 
 Khi anh muốn thêm một project mới vào hệ sinh thái:
 

package/template/.agent/scripts/receptionist_down.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-# --- Antigravity Unified Shutdown (Golden V6 - High Precision) ---
+# --- Antigravity Unified Shutdown (Port Fusion Edition) ---
 # Dọn dẹp trạm gác Agentic Gateway.
 
 PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
@@ -10,36 +10,29 @@ if [ -f .env ]; then
     source .env
 fi
 
-BRIDGE_PORT=${BRIDGE_PORT:-9558}
+BRIDGE_PORT=${BRIDGE_PORT:-9656}
 
 echo "════════════════════════════════════════════════════"
-echo "  🛑 SHUTTING DOWN AG GATEWAY [$BRIDGE_PORT]..."
+echo "  🛑 ĐANG TẮT AG GATEWAY [$BRIDGE_PORT]..."
 echo "════════════════════════════════════════════════════"
 
-# 1. Tắt Sentinel Monitor
-SENTINEL_PID_FILE=".sentinel_${BRIDGE_PORT}.pid"
-if [ -f "$SENTINEL_PID_FILE" ]; then
-    kill $(cat "$SENTINEL_PID_FILE") 2>/dev/null && rm "$SENTINEL_PID_FILE"
-    echo "✅ Sentinel stopped."
-fi
-
-# 2. Tắt Portal Bridge
-BRIDGE_PID_FILE=".portal_bridge_${BRIDGE_PORT}.pid"
+# 1. Tắt Portal Bridge
+BRIDGE_PID_FILE=".agent/logs/.portal_bridge_${BRIDGE_PORT}.pid"
 if [ -f "$BRIDGE_PID_FILE" ]; then
     kill $(cat "$BRIDGE_PID_FILE") 2>/dev/null && rm "$BRIDGE_PID_FILE"
-    echo "✅ HUD Bridge stopped."
+    echo "✅ HUD Bridge đã tắt."
 fi
 
-# 3. Tắt Bot
-BOT_PID_FILE=".ag_gateway_bot.pid"
+# 2. Tắt Bot
+BOT_PID_FILE=".agent/logs/.ag_gateway_bot.pid"
 if [ -f "$BOT_PID_FILE" ]; then
     PID=$(cat "$BOT_PID_FILE")
     # Kill the whole process group for the bash loop
-    pkill -P $PID
+    pkill -P $PID 2>/dev/null
     kill $PID 2>/dev/null && rm "$BOT_PID_FILE"
-    echo "✅ AG Gateway Bot stopped."
+    echo "✅ Bot Telegram đã tắt."
 fi
 
 echo "════════════════════════════════════════════════════"
-echo "✅ AG GATEWAY IS IDLE."
+echo "✅ HỆ THỐNG AG GATEWAY ĐĐA NGỦ."
 echo "════════════════════════════════════════════════════"

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

@@ -1,159 +1,57 @@
 #!/bin/bash
 
-# --- Antigravity Unified Receptionist (Golden V6 - High Precision) ---
+# --- Antigravity Unified Receptionist (Port Fusion Edition) ---
 # Trạm gác hợp nhất: AG Gateway Bot + Portal Bridge (HUD)
-# Dự án: Template Agentic Orchestrator
 
-# 1. Load Cấu hình & Xử lý Cổng Thông minh
 PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
 cd "$PROJECT_DIR"
 
-if [ -f .agent/scripts/port_utils.sh ]; then
-    source .agent/scripts/port_utils.sh
-else
+mkdir -p .agent/logs
+
+# 1. Load Cấu hình Tĩnh từ .env
+if [ -f .env ]; then
     source .env
-    export IDE_PORT=${IDE_PORT:-9557}
-    export BRIDGE_PORT=${BRIDGE_PORT:-9658}
 fi
 
+export IDE_PORT=${IDE_PORT:-9555}
+export BRIDGE_PORT=${BRIDGE_PORT:-9656}
+
 echo "════════════════════════════════════════════════════"
-echo "  🏢 AG GATEWAY - PORTAL [$BRIDGE_PORT]"
+echo "  🏢 AG GATEWAY - CẦU NỐI NỘI BỘ [$BRIDGE_PORT]"
 echo "════════════════════════════════════════════════════"
 
-# 2. Xử lý Chế độ Headless & Cloudflare Tunnel
-HEADLESS=false
-TUNNEL=false
-for arg in "$@"; do
-    if [ "$arg" == "--headless" ]; then HEADLESS=true; fi
-    if [ "$arg" == "--tunnel" ]; then TUNNEL=true; fi
-done
-
-# 3. Kiểm tra/Khởi động IDE
-echo -n "[2/4] 🛰️  Checking IDE Portal (Port $IDE_PORT)... "
-if curl -s http://127.0.0.1:$IDE_PORT/json/version > /dev/null; then
-    echo "✅ READY."
-    if [ "$HEADLESS" != true ]; then
-        echo "      🔄 Attempting to wake/focus UI..."
-        # Cố gắng push UI lên (nếu đang ngầm)
-        antigravity "$PROJECT_DIR" > /dev/null 2>&1 &
-        
-        if [ -t 0 ]; then
-            echo -n "      🤔 Did the IDE window appear? [Y/n] (Auto-yes in 5s): "
-            read -t 5 -n 1 user_input
-            echo ""
-            user_input=${user_input:-Y}
-        else
-            user_input="Y"
-        fi
-        
-        if [[ "$user_input" =~ ^[Nn]$ ]]; then
-            echo "      💀 UI Failed. Killing specific phantom instance for this project..."
-            # Chỉ kill những process chứa flag remote và project hiện tại
-            pkill -f "antigravity.*--remote-debugging-port=$IDE_PORT"
-            pkill -f "antigravity.*$PROJECT_DIR"
-            sleep 2
-            echo "      🚀 Launching fresh Antigravity with UI on port $IDE_PORT..."
-            nohup antigravity --remote-debugging-port=$IDE_PORT "$PROJECT_DIR" > /dev/null 2>&1 &
-            sleep 5
-        fi
-    fi
-else
-    echo "❌ NOT FOUND."
-    if [ "$HEADLESS" = true ]; then
-        echo "      🚀 Launching Antigravity in HEADLESS mode on port $IDE_PORT..."
-        nohup antigravity --server --remote-debugging-port=$IDE_PORT "$PROJECT_DIR" > /dev/null 2>&1 &
-    else
-        echo "      🚀 Launching Antigravity with UI on port $IDE_PORT..."
-        nohup antigravity --remote-debugging-port=$IDE_PORT "$PROJECT_DIR" > /dev/null 2>&1 &
-    fi
-    sleep 5
-fi
-
-# 4. Cloudflare Tunnel & QR Code (If requested)
-if [ "$TUNNEL" = true ]; then
-    echo "[T] 🌐 Starting Cloudflare Tunnel..."
-    if ! command -v cloudflared &> /dev/null; then
-        echo "      ❌ Error: cloudflared not installed."
-    else
-        nohup cloudflared tunnel --url http://127.0.0.1:$BRIDGE_PORT > .tunnel.log 2>&1 &
-        sleep 5
-        TUNNEL_URL=$(grep -o 'https://.*\.trycloudflare\.com' .tunnel.log | head -n 1)
-        if [ -n "$TUNNEL_URL" ]; then
-            echo "      ✅ Tunnel Active: $TUNNEL_URL"
-            echo "      📱 Generating QR Code..."
-            python3 -c "import qrcode; qr = qrcode.QRCode(); qr.add_data('$TUNNEL_URL'); qr.print_ascii()"
-        else
-            echo "      ⚠️  Could not extract tunnel URL. Check .tunnel.log"
-        fi
-    fi
-fi
-echo "✅ READY."
-
-# 3. Khởi động Portal Bridge (HUD Injector)
-echo "[3/4] 🧪 Injected Golden HUD Bridge... "
-BRIDGE_PID_FILE=".portal_bridge_${BRIDGE_PORT}.pid"
+# 2. Khởi động Portal Bridge (HUD Injector)
+echo "[1/2] 🧪 Đang gắn kết Golden HUD Bridge... "
+BRIDGE_PID_FILE=".agent/logs/.portal_bridge_${BRIDGE_PORT}.pid"
 if [ -f "$BRIDGE_PID_FILE" ]; then
     kill $(cat "$BRIDGE_PID_FILE") 2>/dev/null
 fi
-nohup node scripts/ag_portal_bridge.js > ".portal_bridge_${BRIDGE_PORT}.log" 2>&1 &
+nohup node scripts/ag_portal_bridge.js > ".agent/logs/portal_bridge_${BRIDGE_PORT}.log" 2>&1 &
 echo $! > "$BRIDGE_PID_FILE"
-echo "      ✅ Bridge running (PID: $(cat "$BRIDGE_PID_FILE") on Port $BRIDGE_PORT)"
+echo "      ✅ Bridge đang chạy (PID: $(cat "$BRIDGE_PID_FILE") tại Cổng $BRIDGE_PORT)"
 
-# 4. Khởi động AG Gateway Bot (Trợ lý Telegram)
-echo "[4/4] 🤖 Waking up AG Gateway Bot... "
-BOT_PID_FILE=".ag_gateway_bot.pid"
+# 3. Khởi động AG Gateway Bot (Trợ lý Telegram)
+echo "[2/2] 🤖 Đang đánh thức Truyền tin Telegram... "
+BOT_PID_FILE=".agent/logs/.ag_gateway_bot.pid"
 
-# Kill loop AND all tsx/node processes belonging to this token/project
-# Chỉ kill nếu dự án có thư mục src/index.ts (tránh kill nhầm project khác chạy chung server)
 if [ -f "src/index.ts" ] || [ -f "bot/index.ts" ]; then
     pkill -f "tsx src/index.ts" 2>/dev/null
     pkill -f "node src/index.ts" 2>/dev/null
 fi
-pkill -f "interaction_final.log" 2>/dev/null
+
 if [ -f "$BOT_PID_FILE" ]; then
     kill -9 $(cat "$BOT_PID_FILE") 2>/dev/null
 fi
-sleep 2
+sleep 1
 
-# Start the bot with a more robust monitor
 nohup bash -c "while true; do 
-    echo \"\$(date): Starting Bot...\" >> interaction_final.log
-    npx tsx src/index.ts >> interaction_final.log 2>&1
+    echo \"\$(date): Khởi động Bot...\" >> .agent/logs/bot_interaction.log
+    npx tsx src/index.ts >> .agent/logs/bot_interaction.log 2>&1
     EXIT_CODE=\$?
-    if [ \$EXIT_CODE -eq 0 ]; then break; fi # Exit loop if deliberate stop
-    echo \"\$(date): AG Gateway Bot crashed (Code: \$EXIT_CODE). Restarting in 5s...\" >> interaction_final.log
+    if [ \$EXIT_CODE -eq 0 ]; then break; fi
+    echo \"\$(date): Bot sụp đổ (Code: \$EXIT_CODE). Khởi động lại sau 5s...\" >> .agent/logs/bot_interaction.log
     sleep 5
-done" &
+done" > /dev/null 2>&1 &
 echo $! > "$BOT_PID_FILE"
-echo "      ✅ AG Gateway Bot active (PID: $(cat "$BOT_PID_FILE"))"
-
-# 5. Sentinel Monitor (Giám sát Trí não)
-echo "🛡️  Sentinel Active: Auto-shutdown if IDE connection lost."
-SENTINEL_PID_FILE=".sentinel_${BRIDGE_PORT}.pid"
-
-function start_sentinel() {
-    (
-        local fail_count=0
-        local PROJ_NAME=$(basename "$PROJECT_DIR")
-        # Give more time for the first check
-        sleep 60
-        while true; do
-            if ! curl -s "http://127.0.0.1:$IDE_PORT/json" | grep -q "$PROJ_NAME" > /dev/null 2>&1; then
-                fail_count=$((fail_count + 1))
-                if [ $fail_count -ge 3 ]; then
-                    echo "$(date): ⚠️ IDE Lost. Auto-shutting down project..." >> .sentinel_crash.log
-                    bash .agent/scripts/receptionist_down.sh
-                    exit 0
-                fi
-            else
-                fail_count=0
-            fi
-        done
-    ) &
-    echo $! > "$SENTINEL_PID_FILE"
-}
-start_sentinel
-
-# Monitor
-echo "----------------------------------------------------"
-tail -f interaction_final.log
+echo "      ✅ Truyền tin Telegram đã lên sóng (PID: $(cat "$BOT_PID_FILE"))"
+echo "✅ HOÀN TẤT. Hệ thống chạy ngầm, bạn có thể tắt Terminal này!"

package/template/.agent/skills/telegram-agentic-gateway/templates/start.sh.template

@@ -10,25 +10,38 @@ else
 fi
 
 PORT=${IDE_PORT:-9555}
+PROJ=${PROJECT_NAME:-"UnknownProject"}
 
-echo "🔍 Đang kiểm tra IDE tại cổng $PORT..."
+echo "🔍 Đang kiểm tra IDE cho [$PROJ] tại cổng $PORT..."
 
-# 2. Logic Hợp thể & Mở mới linh hoạt
-if nc -z 127.0.0.1 $PORT &>/dev/null; then
-    echo "✅ [HỢP THỂ]: Đã tìm thấy một IDE đang chạy riêng cho dự án ở cổng $PORT. Đang cắm ngầm Bot vào..."
-else
-    echo "⚠️ [MỞ MỚI]: Không tìm thấy IDE ở cổng $PORT. Đang tự động phóng một IDE mới chuyên biệt cho dự án này..."
-    
-    if command -v cursor &> /dev/null; then
+open_ide() {
+    if command -v antigravity &> /dev/null; then
+        antigravity --remote-debugging-port=$PORT . &
+    elif command -v cursor &> /dev/null; then
         cursor --remote-debugging-port=$PORT . &
     elif command -v code &> /dev/null; then
         code --remote-debugging-port=$PORT . &
     else
-        echo "❌ Lỗi: Không tìm thấy lệnh 'cursor' hoặc 'code' trong cửa sổ lệnh."
-        echo "👉 Hãy tự mở IDE bằng tay cho thư mục này bằng lệnh: cursor --remote-debugging-port=$PORT ."
+        echo "❌ Lỗi: Không tìm thấy lệnh 'antigravity', 'cursor' hoặc 'code'."
+        echo "👉 Hãy tự mở IDE bằng tay cho thư mục này."
     fi
-    
-    echo "⏳ Đang đợi IDE kích hoạt cổng CDP..."
+}
+
+# 2. Logic Hợp thể & Mở mới linh hoạt
+if nc -z 127.0.0.1 $PORT &>/dev/null; then
+    # Cổng đã mở, thám thính xem bên trong có dự án của mình không (lọc theo JSON Title/Url)
+    if curl -s --max-time 2 http://127.0.0.1:$PORT/json/list | grep -i "\"title\":.*$PROJ" &>/dev/null; then
+        echo "✅ [HỢP THỂ]: Cổng $PORT đang mở và Workspace [$PROJ] đang được hiển thị. Trực tiếp cắm ngầm Bot vào màn hình này..."
+    else
+        echo "⚠️ [GỌI CỬA]: Cổng $PORT có IDE đang chạy, nhưng chưa mở màn hình cho [$PROJ]. Đang ra lệnh mở thêm giao diện cho dự án này..."
+        open_ide
+        echo "⏳ Đang đợi màn hình phụ tải xong..."
+        sleep 4
+    fi
+else
+    echo "⚠️ [MỞ MỚI TỪ ĐẦU]: Cổng CDP $PORT hoàn toàn trống. Đang phóng cỗ máy IDE chuyên biệt..."
+    open_ide
+    echo "⏳ Đang đợi rễ CDP bám rễ..."
     sleep 4
 fi
 

package/template/start.sh

@@ -10,25 +10,38 @@ else
 fi
 
 PORT=${IDE_PORT:-9555}
+PROJ=${PROJECT_NAME:-"UnknownProject"}
 
-echo "🔍 Đang kiểm tra IDE tại cổng $PORT..."
+echo "🔍 Đang kiểm tra IDE cho [$PROJ] tại cổng $PORT..."
 
-# 2. Logic Hợp thể & Mở mới linh hoạt
-if nc -z 127.0.0.1 $PORT &>/dev/null; then
-    echo "✅ [HỢP THỂ]: Đã tìm thấy một IDE đang chạy riêng cho dự án ở cổng $PORT. Đang cắm ngầm Bot vào..."
-else
-    echo "⚠️ [MỞ MỚI]: Không tìm thấy IDE ở cổng $PORT. Đang tự động phóng một IDE mới chuyên biệt cho dự án này..."
-    
-    if command -v cursor &> /dev/null; then
+open_ide() {
+    if command -v antigravity &> /dev/null; then
+        antigravity --remote-debugging-port=$PORT . &
+    elif command -v cursor &> /dev/null; then
         cursor --remote-debugging-port=$PORT . &
     elif command -v code &> /dev/null; then
         code --remote-debugging-port=$PORT . &
     else
-        echo "❌ Lỗi: Không tìm thấy lệnh 'cursor' hoặc 'code' trong Terminal này."
-        echo "👉 Hãy tự mở IDE bằng tay cho thư mục này bằng lệnh: \cursor --remote-debugging-port=$PORT .\ "
+        echo "❌ Lỗi: Không tìm thấy lệnh 'antigravity', 'cursor' hoặc 'code'."
+        echo "👉 Hãy tự mở IDE bằng tay cho thư mục này."
     fi
-    
-    echo "⏳ Đang đợi IDE kích hoạt cổng CDP..."
+}
+
+# 2. Logic Hợp thể & Mở mới linh hoạt
+if nc -z 127.0.0.1 $PORT &>/dev/null; then
+    # Cổng đã mở, thám thính xem bên trong có dự án của mình không (lọc theo JSON Title/Url)
+    if curl -s --max-time 2 http://127.0.0.1:$PORT/json/list | grep -i "\"title\":.*$PROJ" &>/dev/null; then
+        echo "✅ [HỢP THỂ]: Cổng $PORT đang mở và Workspace [$PROJ] đang được hiển thị. Trực tiếp cắm ngầm Bot vào màn hình này..."
+    else
+        echo "⚠️ [GỌI CỬA]: Cổng $PORT có IDE đang chạy, nhưng chưa mở màn hình cho [$PROJ]. Đang ra lệnh mở thêm giao diện cho dự án này..."
+        open_ide
+        echo "⏳ Đang đợi màn hình phụ tải xong..."
+        sleep 4
+    fi
+else
+    echo "⚠️ [MỞ MỚI TỪ ĐẦU]: Cổng CDP $PORT hoàn toàn trống. Đang phóng cỗ máy IDE chuyên biệt..."
+    open_ide
+    echo "⏳ Đang đợi rễ CDP bám rễ..."
     sleep 4
 fi
 

package/template/.agent/scripts/port_utils.sh

@@ -1,106 +0,0 @@
-#!/bin/bash
-
-# --- Port Management Utility (Golden V6 - High Precision) ---
-# Tự động quét và thu nạp cổng IDE theo từng dự án.
-# Đảm bảo "Chính chủ" mới dùng, "Người lạ" thì né.
-
-ENV_FILE=".env"
-PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
-
-# 1. Tìm cổng trống dựa trên netstat
-function find_free_port() {
-    local port=$1
-    while netstat -atn | grep -q ":$port "; do
-        port=$((port + 1))
-    done
-    echo $port
-}
-
-# 2. Cập nhật .env (Dùng sed tương thích đa hệ điều hành)
-function update_env_port() {
-    local key=$1
-    local value=$2
-    if grep -q "^${key}=" "$ENV_FILE"; then
-        if [[ "$OSTYPE" == "darwin"* ]]; then
-            sed -i '' "s/^${key}=.*/${key}=${value}/" "$ENV_FILE"
-        else
-            sed -i "s/^${key}=.*/${key}=${value}/" "$ENV_FILE"
-        fi
-    else
-        echo "${key}=${value}" >> "$ENV_FILE"
-    fi
-}
-
-# 3. Quét dải cổng để tìm IDE của chính dự án này
-function scan_project_ide() {
-    local start_p=$1
-    local end_p=$2
-    for ((p=start_p; p<=end_p; p++)); do
-        if netstat -atn | grep -q ":$p "; then
-            # Kiểm tra xem có đúng là IDE của dự án này đang ở cổng p không
-            PROJECT_NAME=$(basename "$PROJECT_DIR")
-            if curl -s "http://127.0.0.1:$p/json" | grep -q "$PROJECT_NAME" > /dev/null 2>&1; then
-                echo $p
-                return 0
-            fi
-        fi
-    done
-    echo ""
-    return 1
-}
-
-# --- Main Logic ---
-
-# Nạp config cũ
-if [ -f "$ENV_FILE" ]; then
-    source "$ENV_FILE"
-fi
-
-DEFAULT_IDE_START=9555
-IDE_RANGE_END=9655
-BRIDGE_OFFSET=101  # IDE 9555 -> Bridge 9656
-
-CURRENT_CONFIG_IDE=${IDE_PORT:-$DEFAULT_IDE_START}
-
-echo "🔍 Đang rà soát "Brain Portal" (Dải 100 cổng) cho dự án: $(basename "$PROJECT_DIR")..."
-
-# Bước 1: Quét xem có IDE nào đang mở dự án này không (Dải 9555 - 9655)
-FOUND_PORT=$(scan_project_ide $DEFAULT_IDE_START $IDE_RANGE_END)
-
-if [ ! -z "$FOUND_PORT" ]; then
-    echo "✅ Phát hiện IDE đang chạy tại cổng: $FOUND_PORT"
-    export IDE_PORT=$FOUND_PORT
-    export BRIDGE_PORT=$((FOUND_PORT + BRIDGE_OFFSET))
-    
-    # Cập nhật .env nếu có thay đổi
-    if [ "$FOUND_PORT" != "$CURRENT_CONFIG_IDE" ]; then
-        echo "📝 Cập nhật cổng mới vào .env..."
-        update_env_port "IDE_PORT" "$FOUND_PORT"
-        update_env_port "BRIDGE_PORT" "$BRIDGE_PORT"
-    fi
-else
-    # Bước 2: Không thấy IDE cũ, kiểm tra cổng trong .env có bị "người lạ" chiếm không
-    echo "❓ Không tìm thấy IDE đang chạy. Tiến hành rà soát cổng khả dụng..."
-    
-    # Nếu cổng hiện tại bị "người lạ" chiếm
-    if netstat -atn | grep -q ":$CURRENT_CONFIG_IDE "; then
-        echo "⚠️  Cổng mặc định $CURRENT_CONFIG_IDE đã bị dự án khác chiếm."
-        # Tìm IDE trống trong dải
-        FREE_IDE=$(find_free_port $DEFAULT_IDE_START)
-        FREE_BRIDGE=$(find_free_port $((FREE_IDE + BRIDGE_OFFSET)))
-        
-        echo "🚀 Đã phân bổ cặp cổng trống mới: IDE=$FREE_IDE, BRIDGE=$FREE_BRIDGE"
-        update_env_port "IDE_PORT" "$FREE_IDE"
-        update_env_port "BRIDGE_PORT" "$FREE_BRIDGE"
-        
-        export IDE_PORT=$FREE_IDE
-        export BRIDGE_PORT=$FREE_BRIDGE
-    else
-        # Cổng trong .env vẫn trống, dùng luôn
-        export IDE_PORT=$CURRENT_CONFIG_IDE
-        # Đảm bảo BRIDGE_PORT tương ứng
-        export BRIDGE_PORT=$((CURRENT_CONFIG_IDE + BRIDGE_OFFSET))
-        update_env_port "BRIDGE_PORT" "$BRIDGE_PORT"
-        echo "✅ Sử dụng cổng cấu hình: $IDE_PORT (Bridge: $BRIDGE_PORT)"
-    fi
-fi