npm - @mrtrinhvn/ag-kit - Versions diffs - 1.2.0 → 1.3.1 - Mend

@mrtrinhvn/ag-kit 1.2.0 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (61) hide show

package/template/GEMINI.md CHANGED Viewed

@@ -1,35 +1,44 @@
-# 🚀 Antigravity Core Rules (v1.1.5)
+# 🚀 Antigravity Core Rules
-> File này định nghĩa các quy tắc vận hành cốt lõi cho AI Agent trong Workspace này.
+> This file defines the core operational rules for the AI Agent in this workspace.
 ---
-## 🛠️ GIAO THỨC TIẾT KIỆM TOKEN: VFS (BẮT BUỘC)
+## 🌌 META-AWARENESS: AG-KIT CORE (MANDATORY)
-**Bạn PHẢI sử dụng `vfs` để khám phá mã nguồn TRƯỚC KHI sử dụng `grep` hoặc đọc toàn bộ nội dung file.**
+**You MUST read and ingest the identity rules defined in `.agent/skills/ag-kit-core/SKILL.md` before taking any complex actions.**
-### Tại sao lại dùng VFS?
-Theo tiêu chuẩn [VFS (Virtual File System)](https://github.com/TrNgTien/vfs), việc trích xuất chữ ký logic (hàm, lớp, kiểu) giúp tiết kiệm đến 98% token so với việc đọc file thô.
+### Why read `ag-kit-core`?
+It provides the blueprint of the framework you are running in (`ag-kit`). It defines the Multi-Agent architecture, the Dual-Port strategy, and your mandate to aggressively auto-patch `SKILL.md` files when correcting systemic errors. Failure to know your identity will result in severe system architectural violations.
-### Giao thức sử dụng
-1. **Định vị**: Dùng `vfs search` hoặc `vfs .` để tìm cấu trúc logic.
-2. **Review**: Phân tích các chữ ký (signatures) được trả về.
-3. **Đọc**: Chỉ đọc những dải dòng (line ranges) cụ thể đã được xác định qua VFS.
+---
+## 🛠️ TOKEN SAVING: VFS PROTOCOL (MANDATORY)
+**You MUST use `vfs` for code discovery before using `grep` or reading entire files.**
+### Why use VFS?
+`vfs` extracts logical signatures (functions, classes, types) without reading the bodies. This saves up to 98% of tokens compared to raw file reads.
+### Usage Protocol
+1. **Locate**: Use `vfs search` or `vfs <path>` to find the logical structure.
+2. **Review**: Analyze the signatures returned by `vfs`.
+3. **Read**: Only read the specific line ranges identified via `vfs`.
-### Lệnh thực thi
+### Commands
 - **CLI**: `vfs . -f <function_name>`
-- **MCP**: Sử dụng công cụ `vfs` nếu có sẵn trong bộ skill.
+- **MCP**: Use the `vfs` MCP tool if available.
 ---
-## 🤖 CHIẾN LƯỢC CHỌN MÔ HÌNH (MODEL SELECTION)
+## 🤖 MODEL SELECTION
-- **Tác vụ đơn giản**: Ưu tiên sử dụng mô hình Local qua **Ollama** (Vd: `nemotron`, `llama3`) để tiết kiệm chi phí cloud.
-- **Tác vụ phức tạp**: Sử dụng các mô hình cao cấp (Vd: `Claude 3.5 Sonnet`, `Gemini 1.5 Pro`).
+- **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`).
 ---
 ## 🧹 CLEAN CODE
-- Viết mã tự giải thích (Self-documenting).
-- Tránh Over-engineering.
-- Tuân thủ các pattern định nghĩa trong `.agent/skills/clean-code`.
+- Write self-documenting code.
+- Avoid over-engineering.
+- Follow the patterns defined in `.agent/skills/clean-code`.

package/template/scripts/ag_deck/index.html ADDED Viewed

@@ -0,0 +1,58 @@
+<!DOCTYPE html>
+<html lang="vi">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>🌌 Gravity Deck | Elite OS</title>
+    <style>
+        :root { --bg: #0a0a0c; --card: #16161a; --text: #e0e0e0; --accent: #00f2ff; }
+        body { background: var(--bg); color: var(--text); font-family: 'Inter', sans-serif; display: flex; flex-direction: column; align-items: center; justify-content: center; height: 100vh; margin: 0; }
+        .grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 15px; width: 90vw; max-width: 600px; }
+        .tile { background: var(--card); border: 1px solid #333; aspect-ratio: 1/1; border-radius: 12px; display: flex; flex-direction: column; align-items: center; justify-content: center; cursor: pointer; transition: all 0.2s; }
+        .tile:hover { border-color: var(--accent); transform: scale(1.05); box-shadow: 0 0 20px rgba(0, 242, 255, 0.2); }
+        .tile .icon { font-size: 2rem; margin-bottom: 8px; }
+        .tile .label { font-size: 0.75rem; font-weight: 600; text-transform: uppercase; letter-spacing: 1px; }
+        .header { margin-bottom: 2rem; text-align: center; }
+        .status-bar { background: #1a1a20; padding: 10px 20px; border-radius: 30px; font-size: 0.8rem; margin-bottom: 2rem; border: 1px solid #333; }
+        .online { color: #00ff88; }
+    </style>
+</head>
+<body>
+    <div class="header">
+        <h1>🌌 GRAVITY DECK</h1>
+        <div class="status-bar">🧠 <span id="model">Gemini 3.1</span> | <span class="online">● ONLINE</span></div>
+    </div>
+    <div class="grid">
+        <!-- Row 1: Neural -->
+        <div class="tile" onclick="cmd('model:gemini')"><div class="icon">🛰️</div><div class="label">Gemini</div></div>
+        <div class="tile" onclick="cmd('model:claude')"><div class="icon">🧬</div><div class="label">Claude</div></div>
+        <div class="tile" onclick="cmd('model:ollama')"><div class="icon">💻</div><div class="label">Ollama</div></div>
+        <div class="tile" onclick="cmd('mode:cycle')"><div class="icon">🔄</div><div class="label">Cycle</div></div>
+        <!-- Row 2: Agent -->
+        <div class="tile" onclick="cmd('agent:fix')"><div class="icon">👨‍💻</div><div class="label">Fix Bug</div></div>
+        <div class="tile" onclick="cmd('agent:test')"><div class="icon">🧪</div><div class="label">Gen Test</div></div>
+        <div class="tile" onclick="cmd('agent:doc')"><div class="icon">📝</div><div class="label">Docs</div></div>
+        <div class="tile" onclick="cmd('agent:sec')"><div class="icon">🛡️</div><div class="label">Security</div></div>
+        <!-- Row 3: IDE -->
+        <div class="tile" onclick="cmd('ide:snap')"><div class="icon">📸</div><div class="label">Snap</div></div>
+        <div class="tile" onclick="cmd('ide:stop')"><div class="icon">🛑</div><div class="label">Stop</div></div>
+        <div class="tile" onclick="cmd('ide:heal')"><div class="icon">🩹</div><div class="label">Heal</div></div>
+        <div class="tile" onclick="cmd('ide:clear')"><div class="icon">🧹</div><div class="label">Clear</div></div>
+        <!-- Row 4: Meta -->
+        <div class="tile" onclick="cmd('meta:freeze')"><div class="icon">🧊</div><div class="label">Freeze</div></div>
+        <div class="tile" onclick="cmd('meta:turbo')"><div class="icon">🔥</div><div class="label">Turbo</div></div>
+        <div class="tile" onclick="cmd('meta:config')"><div class="icon">⚙️</div><div class="label">Config</div></div>
+        <div class="tile" onclick="window.close()"><div class="icon">🚪</div><div class="label">Exit</div></div>
+    </div>
+    <script>
+        function cmd(action) {
+            console.log('Executing Elite Macro:', action);
+            fetch('http://localhost:9656/action', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ action })
+            }).then(r => r.json()).then(d => console.log('Response:', d));
+        }
+    </script>
+</body>
+</html>

package/template/scripts/ag_heartbeat.js ADDED Viewed

@@ -0,0 +1,46 @@
+/**
+ * 🧬 Elite OS: Neural Heartbeat
+ *
+ * Proactive monitor that watches AI logs and brain state.
+ * Signals 'Yellow Alert' or 'Recovered' based on Neural Health.
+ */
+import fs from 'fs';
+import path from 'fs'; // Mocking path or use node path
+const PORTAL_FILE = '.active_model.json';
+const HEARTBEAT_INTERVAL = 5000;
+function checkNeuralHealth() {
+    try {
+        if (!fs.existsSync(PORTAL_FILE)) return;
+        const state = JSON.parse(fs.readFileSync(PORTAL_FILE, 'utf8'));
+        const now = new Date();
+        // Logic 1: Quota Prediction
+        if (state.mode === 'ONLINE_CYCLE' && state.metrics?.quota < 5) {
+            broadcastAlert('NEURAL_FATIGUE', 'Quota low! Preparing fallback...');
+        }
+        // Logic 2: EPIC Recovery Check
+        if (state.mode === 'LOCAL_LOCK' && checkCloudTokens()) {
+            broadcastAlert('EPIC_RECOVERY_READY', 'High-tier models restored! Switching...');
+        }
+        console.log(`[Heartbeat] 💓 Pulse OK - Mode: ${state.mode} | Model: ${state.model.split('/').pop()}`);
+    } catch (e) {
+        console.error('[Heartbeat] 💔 Pulse Skip:', e.message);
+    }
+}
+function checkCloudTokens() {
+    // Mock check: in reality, this would query an API or look at a timer
+    return Math.random() > 0.95; // 5% chance of recovery per pulse for testing
+}
+function broadcastAlert(type, message) {
+    const alert = { timestamp: new Date().toISOString(), type, message };
+    fs.writeFileSync('.heartbeat_alert.json', JSON.stringify(alert));
+    // Bridge will watch this file and broadcast to HUD/Telegram
+}
+console.log('🛰️ Elite OS: Neural Heartbeat Active...');
+setInterval(checkNeuralHealth, HEARTBEAT_INTERVAL);

package/template/scripts/ag_hud.js CHANGED Viewed

@@ -1,162 +1,94 @@
-/**
- * Antigravity Golden HUD - Medical/Trading Theme
- * Purpose: Inject a premium status dashboard into the IDE.
- */
-export const AG_HUD_JS = `(async () => {
-    const HUD_ID = 'antigravity-golden-hud';
-    if (document.getElementById(HUD_ID)) return "ALREADY_EXISTS";
+(async () => {
+    // 1. Cleanup
+    if (window.ag_popup_win && !window.ag_popup_win.closed) window.ag_popup_win.close();
+    const HUD_ID = 'antigravity-elite-statusbar-item';
+    if (document.getElementById(HUD_ID)) document.getElementById(HUD_ID).remove();
-    // 1. Create Styles
-    const style = document.createElement('style');
-    style.innerHTML = \`
-        #\${HUD_ID} {
-            position: fixed;
-            top: 15px;
-            right: 15px;
-            z-index: 999999;
-            background: rgba(10, 10, 10, 0.85);
-            backdrop-filter: blur(12px);
-            border: 1px solid rgba(255, 255, 255, 0.1);
-            border-radius: 12px;
-            padding: 12px;
-            width: 280px;
-            color: #fff;
-            font-family: 'Inter', system-ui, sans-serif;
-            box-shadow: 0 8px 32px rgba(0,0,0,0.5);
-            transition: all 0.3s ease;
-            user-select: none;
-        }
-        #\${HUD_ID}:hover {
-            border-color: #4caf50;
-            box-shadow: 0 0 20px rgba(76, 175, 80, 0.2);
-        }
-        #\${HUD_ID} .header {
-            display: flex;
-            align-items: center;
-            justify-content: space-between;
-            margin-bottom: 10px;
-            font-weight: 700;
-            letter-spacing: 0.5px;
-        }
-        #\${HUD_ID} .status-dot {
-            width: 8px;
-            height: 8px;
-            border-radius: 50%;
-            background: #4caf50;
-            display: inline-block;
-            margin-right: 6px;
-            animation: pulse 2s infinite;
-        }
-        @keyframes pulse {
-            0% { transform: scale(1); opacity: 1; }
-            50% { transform: scale(1.5); opacity: 0.5; }
-            100% { transform: scale(1); opacity: 1; }
-        }
-        #\${HUD_ID} .metric {
-            display: flex;
-            justify-content: space-between;
-            font-size: 12px;
-            margin-bottom: 6px;
-            color: #ccc;
-        }
-        #\${HUD_ID} .metric b { color: #fff; }
-        #\${HUD_ID} .action-btn {
-            background: #1a1a1a;
-            border: 1px solid #333;
-            color: #4caf50;
-            font-size: 11px;
-            padding: 6px;
-            border-radius: 6px;
-            width: 100%;
-            margin-top: 8px;
-            cursor: pointer;
-            text-align: center;
-            font-weight: 600;
-            transition: all 0.2s;
-        }
-        #\${HUD_ID} .action-btn:hover {
-            background: #4caf50;
-            color: #000;
-        }
-        #\${HUD_ID} .surgery-alert {
-            background: rgba(244, 67, 54, 0.2);
-            border: 1px solid #f44336;
-            color: #f44336;
-            padding: 8px;
-            border-radius: 8px;
-            font-size: 11px;
-            margin-top: 10px;
-            display: none;
-            animation: shake 0.5s infinite;
-        }
-        @keyframes shake {
-            0% { transform: translateX(0); }
-            25% { transform: translateX(2px); }
-            50% { transform: translateX(0); }
-            75% { transform: translateX(-2px); }
-            100% { transform: translateX(0); }
-        }
-    \`;
-    document.head.appendChild(style);
+    // 2. Locate Status Bar
+    const statusBar = document.querySelector('.part.statusbar');
+    if (!statusBar) return "STATUSBAR_NOT_FOUND";
-    // 2. Create UI
-    const hud = document.createElement('div');
-    hud.id = HUD_ID;
-    hud.innerHTML = \`
-        <div class="header">
-            <span>🧠 CORE AGENT B1</span>
-            <span id="ag-status"><span class="status-dot"></span>ONLINE</span>
-        </div>
-        <div class="metric">AI Evolution: <b id="ag-gen">GEN-439</b></div>
-        <div class="metric">Win Rate: <b id="ag-win">47.7%</b></div>
-        <div class="metric">Current Phase: <b id="ag-phase">5m VSA Trading</b></div>
-        <div class="surgery-alert" id="ag-alert">
-            🛑 <b>DOCTOR CALL REQUIRED!</b><br>AI Learning Stalled. Surgery needed.
-        </div>
-        <div id="ag-toast" style="display:none; background:rgba(33, 150, 243, 0.9); color:#fff; padding:8px; border-radius:8px; margin-top:10px; font-size:11px; border-left:4px solid #0d47a1; backdrop-filter: blur(8px); box-shadow: 0 4px 12px rgba(0,0,0,0.3);">
-            <b>💬 TELEGRAM:</b> <span id="ag-toast-msg"></span>
-        </div>
-        <div class="action-btn" id="ag-btn-surgery">🏥 START BRAIN SURGERY</div>
-    \`;
-    document.body.appendChild(hud);
+    // 3. Create Container Item
+    const container = document.createElement('div');
+    container.id = HUD_ID;
+    container.style.cssText = `
+        height: 100% !important;
+        display: flex !important;
+        align-items: center !important;
+        padding: 0 4px 0 12px !important;
+        background: #000 !important;
+        color: #00ff88 !important;
+        font-family: 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;
+    `;
+    const icon = document.createElement('span');
+    icon.textContent = '🛰️ AG_ELITE | ';
-    // 3. Logic to update from Bridge
-    window.addEventListener('ag-portal-update', (e) => {
-        const data = e.detail;
-        if (data.gen) document.getElementById('ag-gen').innerText = data.gen;
-        if (data.win) document.getElementById('ag-win').innerText = data.win;
-        if (data.phase) document.getElementById('ag-phase').innerText = data.phase;
-        const alert = document.getElementById('ag-alert');
-        if (data.status === 'DOCTOR_REQUIRED' || data.status === 'STALLED') {
-            alert.style.display = 'block';
-            document.getElementById('ag-status').innerHTML = '<span class="status-dot" style="background:#f44336"></span>REPAIR';
-        } else {
-            alert.style.display = 'none';
-            document.getElementById('ag-status').innerHTML = '<span class="status-dot" style="background:#4caf50"></span>ONLINE';
-        }
-    });
+    // 4. Create Model Selector
+    const select = document.createElement('select');
+    select.style.cssText = `
+        background: transparent !important;
+        color: #00ff88 !important;
+        border: none !important;
+        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;
+    `;
-    window.addEventListener('ag-portal-alert', (e) => {
-        const data = e.detail;
-        const toast = document.getElementById('ag-toast');
-        const toastMsg = document.getElementById('ag-toast-msg');
-        toastMsg.innerText = data.message || "New message from Telegram.";
-        toast.style.display = 'block';
-        if (data.color) toast.style.background = data.color;
-        // Auto-hide after 10 seconds
-        setTimeout(() => { toast.style.display = 'none'; }, 10000);
-    });
+    // 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' }
+    ];
-    document.getElementById('ag-btn-surgery').onclick = () => {
-        console.log("AG_PORTAL_ACTION:START_SURGERY");
-        document.getElementById('ag-btn-surgery').innerText = "🚑 REQUESTING SURGEON...";
+    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);
+        });
+        select.appendChild(group);
     };
-    return "GOLDEN_HUD_INJECTED";
-})()`;
+    addGroup('ELITE CLOUD (High)', cloudModels);
+    addGroup('ELITE LOCAL (Ollama)', localModels);
+    select.onchange = (e) => {
+        console.log("AG_PORTAL_ACTION:SET_MODEL:" + e.target.value);
+        container.style.borderColor = '#ff00ff';
+        setTimeout(() => container.style.borderColor = '#00ff88', 1000);
+    };
+    container.appendChild(icon);
+    container.appendChild(select);
+    statusBar.prepend(container);
+    return "STATUSBAR_ADVANCED_HUD_READY";
+})();

package/template/scripts/ag_phantom.sh ADDED Viewed

@@ -0,0 +1,50 @@
+#!/bin/bash
+# 👻 Elite OS: Phantom Swarm Orchestrator
+# Manage headless background agents and restore them to the UI.
+ACTION=$1
+ID=$2 # Instance ID (port offset)
+PROJECT=$3
+BASE_PORT=9555
+IDE_PORT=$((BASE_PORT + ID))
+BRIDGE_PORT=$((IDE_PORT + 100))
+case $ACTION in
+  "start")
+    echo "🚀 Starring Phantom Agent [$ID] for $PROJECT..."
+    # Start in headless mode (no display)
+    DISPLAY="" nohup antigravity $PROJECT --remote-debugging-port=$IDE_PORT > /dev/null 2>&1 &
+    # Start the bridge
+    IDE_PORT=$IDE_PORT BRIDGE_PORT=$BRIDGE_PORT nohup npx tsx scripts/ag_portal_bridge.js > /dev/null 2>&1 &
+    echo "✅ Phantom [$ID] is running at port $IDE_PORT (Headless)"
+    ;;
+  "restore")
+    echo "👁️ Restoring Phantom Agent [$ID] to UI..."
+    # Stop the headless instance
+    pkill -f "remote-debugging-port=$IDE_PORT"
+    sleep 1
+    # Restart with Display
+    DISPLAY=:0 nohup antigravity $PROJECT --remote-debugging-port=$IDE_PORT > /dev/null 2>&1 &
+    echo "✅ Agent [$ID] is now VISIBLE on Display :0"
+    ;;
+  "hide")
+    echo "🙈 Hiding Agent [$ID] (Moving to Background)..."
+    pkill -f "remote-debugging-port=$IDE_PORT"
+    sleep 1
+    DISPLAY="" nohup antigravity $PROJECT --remote-debugging-port=$IDE_PORT > /dev/null 2>&1 &
+    echo "✅ Agent [$ID] is now STEALTH (Headless)"
+    ;;
+  "list")
+    echo "📊 Active Phantom Swarm:"
+    ps aux | grep "remote-debugging-port" | grep -v grep | awk '{print "ID: " $NF " | PID: " $2}'
+    ;;
+  *)
+    echo "Usage: ag_phantom [start|restore|hide|list] [ID] [ProjectDir]"
+    ;;
+esac