@adiholick/nvstudio-mcp 2.1.8 → 2.2.1

package/README.md

@@ -32,8 +32,8 @@ curl -fsSL https://raw.githubusercontent.com/Adiholick/nvstudio-mcp/main/install
 **Apa saja yang dilakukan installer ini secara otomatis?**
 1. 📦 Mengunduh source code, memasang dependensi Node.js, dan mengkompilasi TypeScript (*Bridge Server*).
 2. 🧩 **Memasang Plugin Roblox Studio (`nvstudio_mcp.rbxmx`) otomatis** ke folder sistem Roblox Studio Anda (`%LOCALAPPDATA%\Roblox\Plugins` di Windows atau `~/Documents/ROBLOX/Plugins` di macOS).
-3. 🤖 Mengintegrasikan *AI Agent Skills* anti-halusinasi langsung ke **Antigravity IDE** (`~/.gemini/config/plugins/nvstudio-mcp`).
-4. ⚙️ Melakukan auto-konfigurasi jika mendeteksi editor **Cursor** (`.cursor/mcp.json`).
+3. 🧠 **Universal AI Skill Installer**: Secara cerdas memindai dan mengunduh library skill 29+ *roblox-brain* dan *nvstudio-mcp-guide*, lalu menginjeksinya langsung ke dalam struktur `skills/` dari **AI Agent apapun** yang Anda gunakan (mendukung **Antigravity IDE**, **Cursor**, **Claude Code**, **Codex**, **OpenCode**, dan **Roo Code**).
+4. ⚙️ Melakukan auto-konfigurasi jika mendeteksi editor **Cursor** (`.cursor/mcp.json`) atau **Antigravity** (`mcp_config.json`).
 
 ---
 
@@ -60,8 +60,7 @@ Jika Anda **tidak** menggunakan skrip installer otomatis di atas (misalnya hanya
 
 ## 🔌 Cara Menggunakan (Konfigurasi MCP Klien AI)
 
-Jika Anda menggunakan AI Client lain seperti **Claude Desktop**, **Windsurf**, atau ingin menambahkan konfigurasi secara manual:
-
+### Klien Berbasis NPM (Cursor, Claude Desktop, Windsurf)
 Tambahkan konfigurasi berikut ke file `mcp.json` Anda:
 ```json
 {
@@ -78,13 +77,30 @@ Tambahkan konfigurasi berikut ke file `mcp.json` Anda:
 ```
 *(AI Anda akan selalu menjalankan versi terbaru dari server Bridge langsung dari NPM!)*
 
+### Klien Berbasis Instalasi Lokal (Antigravity IDE)
+Jika Anda menggunakan instalasi lokal via installer di `%USERPROFILE%\.nvstudio-mcp`, tambahkan ke `~/.gemini/config/mcp_config.json`:
+```json
+{
+  "mcpServers": {
+    "nvstudio-mcp": {
+      "command": "node",
+      "args": [
+        "C:/Users/<Username>/.nvstudio-mcp/dist/index.js"
+      ]
+    }
+  }
+}
+```
+
 ---
 
-## 🖥️ Dashboard Visual & Fitur Pintar v2.0
+## 🖥️ Dashboard Visual & Fitur Unggulan v2.1
 
+- **High-Performance Polling Stream & SSE:** Komunikasi antara Roblox Studio dan Bridge Server menggunakan arsitektur snapshot stream sub-detik yang sangat responsif, stabil, dan bebas latensi.
+- **Clean Log Engine:** Log status pada Roblox Studio hanya diperbarui saat ada perubahan status koneksi sebenarnya (bebas dari log spam berulang).
 - **Visual Dashboard Real-time:** Buka [http://localhost:3055](http://localhost:3055) di browser Anda untuk melihat monitor antrean perintah, log aktivitas AI, status koneksi Studio, dan statistik eksekusi secara visual.
-- **Auto-Detect & Auto-Connect:** Plugin Roblox Studio otomatis menyambung ke server saat aktif dan kembali menunggu (*Waiting*) saat server mati tanpa interupsi manual.
-- **Anti-Zombie Port Handling:** Tidak perlu khawatir error `EADDRINUSE`. Jika port `3055` tertahan oleh proses zombie akibat restart editor/IDE, server akan otomatis membersihkan port tersebut secara aman.
+- **Auto-Detect & Auto-Connect:** Plugin Roblox Studio otomatis menyambung ke server saat aktif dan kembali menunggu (*Waiting*) saat server mati tanpa perlu campur tangan manual.
+- **Anti-Zombie Port Handling:** Port `3055` dibersihkan secara otomatis jika terjadi penutupan atau restart IDE secara paksa.
 
 ---
 
@@ -110,9 +126,15 @@ Installer `install.sh` sebelumnya mengkloning repositori dan menginstal Node.js
 rm -rf ~/.nvstudio-mcp
 ```
 
-### 4. Hapus Konfigurasi dari Editor AI Anda
+### 4. Hapus Konfigurasi dan Skills dari Editor AI Anda
 Jika Anda memasukkan konfigurasi MCP secara otomatis ke Cursor atau secara manual ke Claude Desktop, buka file pengaturan `mcp.json` tersebut dan **hapus blok `"nvstudio-mcp"`** dari dalam objek `mcpServers`.
 
+**Untuk membersihkan skill bawaan (Universal Skill Installer):**
+Anda bisa menghapus manual symlink/folder shortcut (yang bernama awalan `roblox-`) dari dalam folder konfigurasi agen Anda:
+- **Cursor / Workspace Lokal**: Hapus isi `.cursor/skills` dan `.cursor/roblox-brain.md`
+- **Claude Code**: Hapus dari `~/.claude/skills`
+- **Codex / OpenCode**: Hapus dari direktori lokal atau global (`~/.codex/skills`, `~/.opencode/skills`).
+
 ---
 
 **Selamat Menciptakan Game Impian Anda dengan AI! 🎮🤖**

package/dist/index.js

@@ -12,7 +12,7 @@ const task_queue_1 = require("./task-queue");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const luau_validator_1 = require("./luau-validator");
-const HISTORY_DIR = path_1.default.join(process.cwd(), '.history');
+const HISTORY_DIR = path_1.default.join(__dirname, '..', '.history');
 if (!fs_1.default.existsSync(HISTORY_DIR)) {
     fs_1.default.mkdirSync(HISTORY_DIR, { recursive: true });
 }
@@ -24,11 +24,12 @@ function backupScript(target, code) {
 }
 const isDaemon = process.argv.includes('--daemon') || process.argv.includes('-d');
 // 1. Impor dan jalankan server Express lokal di port 3055
-(0, roblox_bridge_1.startBridgeServer)(3055);
+(0, roblox_bridge_1.startBridgeServer)(3055, isDaemon);
 // 2. Inisialisasi server MCP
+const pkg = require('../package.json');
 const server = new index_js_1.Server({
     name: "nvstudio-mcp",
-    version: "2.1.8",
+    version: pkg.version,
 }, {
     capabilities: {
         tools: {},
@@ -40,13 +41,13 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
         tools: [
             {
                 name: "call_mcp_tool",
-                description: "ALAT MUTLAK UNTUK ROBLOX. Command: patch_script_source, get_children, get_script_source, update_script_source, rollback_script, get_logs, create_instance, search_instance, generate_terrain, insert_asset, delete_instance, get_properties, script_grep, execute_luau, search_asset.",
+                description: "ALAT MUTLAK UNTUK ROBLOX. Command: patch_script_source, get_children, get_full_tree, get_script_source, update_script_source, rollback_script, get_logs, create_instance, search_instance, generate_terrain, insert_asset, delete_instance, get_properties, set_properties, script_grep, execute_luau, search_asset.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         command: {
                             type: "string",
-                            description: "Perintah yang dieksekusi (contoh: 'patch_script_source', 'get_script_source', 'update_script_source').",
+                            description: "Perintah yang dieksekusi (contoh: 'set_properties', 'get_full_tree', 'patch_script_source').",
                         },
                         target: {
                             type: "string",
@@ -54,10 +55,10 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
                         },
                         data: {
                             type: "string",
-                            description: "Data tambahan (misal payload JSON untuk patch_script_source, atau source code penuh untuk update_script_source).",
+                            description: "Data tambahan. Untuk set_properties: JSON string dari properti. Untuk delete_instance: kirim 'force' jika descendants > 10. Untuk patch/update: source code.",
                         },
                     },
-                    required: ["command", "target"],
+                    required: ["command"],
                 },
             },
         ],
@@ -70,14 +71,14 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     }
     const args = request.params.arguments;
     const { command, target, data } = args;
-    if (!command || !target) {
+    if (!command) {
         return {
             content: [
                 {
                     type: "text",
                     text: JSON.stringify({
                         status: "error",
-                        error: "Parameter 'command' dan 'target' wajib diisi.",
+                        error: "Parameter 'command' wajib diisi.",
                     }),
                 },
             ],
@@ -99,7 +100,6 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 isError: true
             };
         }
-        backupScript(target, String(data));
     }
     // Intercept command yang dieksekusi di server lokal (Node.js) alih-alih di Studio
     if (command === "search_asset" && data) {
@@ -137,12 +137,26 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     }
     // 8. Teruskan ke antrean tugas
     try {
-        if (command === "update_script_source" && data) {
-            backupScript(target, String(data));
-        }
         let result;
         if (roblox_bridge_1.isBridgeHosting) {
             // Instance ini sendiri yang meng-host bridge server
+            if (!(0, roblox_bridge_1.isStudioConnected)()) {
+                await new Promise(r => setTimeout(r, 2000));
+                if (!(0, roblox_bridge_1.isStudioConnected)()) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    status: "error",
+                                    error: "Roblox Studio tidak terdeteksi aktif. Pastikan Roblox Studio dibuka, place telah dimuat, dan plugin nvstudio-mcp dalam status terhubung.",
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            }
             result = await (0, task_queue_1.addTaskToQueue)(command, target, data);
         }
         else {
@@ -166,13 +180,15 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     }
                     result = bridgeJson.result;
                 }
+                else {
+                    throw new Error(`Bridge server returned HTTP ${bridgeRes.status}`);
+                }
             }
             catch (err) {
                 if (forwardedToBridge) {
                     throw err;
                 }
-                // Fallback in-process jika HTTP gagal dihubungi
-                result = await (0, task_queue_1.addTaskToQueue)(command, target, data);
+                throw new Error("Gagal menghubungi server Bridge. Pastikan server daemon berjalan di port 3055.");
             }
         }
         return {

package/dist/luau-validator.js

@@ -6,9 +6,6 @@ function validateLuauSyntax(source) {
     // Stack for blocks: function, do, if, for, while, repeat
     // We'll keep it simple: just count block openers vs block closers (end, until)
     // Note: This is a heuristic pre-commit check. It doesn't replace a full AST parser,
-    // but catches 90% of AI hallucination syntax errors (missing 'end', etc.)
-    let blockDepth = 0;
-    let repeatDepth = 0;
     // Bracket stacks
     let parenDepth = 0; // ()
     let braceDepth = 0; // {}
@@ -84,6 +81,10 @@ function validateLuauSyntax(source) {
                         j = k + 1;
                         continue;
                     }
+                    // If it ended at end of line, we can't reliably detect it. Let's just avoid bracket counting
+                    if (line[k] === undefined) {
+                        break;
+                    }
                 }
             }
             if (inString) {
@@ -116,61 +117,34 @@ function validateLuauSyntax(source) {
             }
             // At this point, we are outside strings and comments.
             // Check brackets
-            if (char === '(')
-                parenDepth++;
-            else if (char === ')') {
-                parenDepth--;
-                if (parenDepth < 0)
-                    return { valid: false, error: 'Kelebihan tutup kurung ")"', line: i + 1 };
-            }
-            else if (char === '{')
-                braceDepth++;
-            else if (char === '}') {
-                braceDepth--;
-                if (braceDepth < 0)
-                    return { valid: false, error: 'Kelebihan tutup kurawal "}"', line: i + 1 };
-            }
-            else if (char === '[')
-                bracketDepth++;
-            else if (char === ']') {
-                bracketDepth--;
-                if (bracketDepth < 0)
-                    return { valid: false, error: 'Kelebihan tutup siku "]"', line: i + 1 };
+            if (!inString && !inMultilineString && !inMultilineComment) {
+                if (char === '(')
+                    parenDepth++;
+                else if (char === ')') {
+                    parenDepth--;
+                    if (parenDepth < 0)
+                        return { valid: false, error: 'Kelebihan tutup kurung ")"', line: i + 1 };
+                }
+                else if (char === '{')
+                    braceDepth++;
+                else if (char === '}') {
+                    braceDepth--;
+                    if (braceDepth < 0)
+                        return { valid: false, error: 'Kelebihan tutup kurawal "}"', line: i + 1 };
+                }
+                else if (char === '[')
+                    bracketDepth++;
+                else if (char === ']') {
+                    bracketDepth--;
+                    if (bracketDepth < 0)
+                        return { valid: false, error: 'Kelebihan tutup siku "]"', line: i + 1 };
+                }
             }
             j++;
         }
         if (inString) {
             return { valid: false, error: 'String tidak ditutup (unclosed string literal)', line: i + 1 };
         }
-        // Tokenize line to check blocks (very simplified heuristic)
-        // We only check for keywords bounded by word boundaries
-        if (!inMultilineString && !inMultilineComment) {
-            // Remove string literals and comments for naive keyword counting
-            let cleanLine = line.replace(/(--.*)/, ''); // remove single line comments
-            cleanLine = cleanLine.replace(/(["'])(?:(?=(\\?))\2.)*?\1/g, ''); // remove inline strings
-            // Avoid false positives like `local func = "do"` by looking at word boundaries
-            // This is a naive regex matching. 
-            // In Luau: 'do', 'if', 'function', 'for', 'while' need an 'end'.
-            // 'repeat' needs 'until'.
-            const words = cleanLine.split(/[^a-zA-Z0-9_]+/).filter(w => w.length > 0);
-            for (let w = 0; w < words.length; w++) {
-                const word = words[w];
-                if (word === 'if' || word === 'function' || word === 'for' || word === 'while' || word === 'do') {
-                    // 'elseif' does not create a new block.
-                    // 'if' does.
-                    blockDepth++;
-                }
-                else if (word === 'end') {
-                    blockDepth--;
-                }
-                else if (word === 'repeat') {
-                    repeatDepth++;
-                }
-                else if (word === 'until') {
-                    repeatDepth--;
-                }
-            }
-        }
     }
     if (inMultilineString)
         return { valid: false, error: 'Multiline string tidak ditutup (unclosed [[ ]])' };
@@ -182,10 +156,5 @@ function validateLuauSyntax(source) {
         return { valid: false, error: 'Kekurangan tutup kurawal "}"' };
     if (bracketDepth > 0)
         return { valid: false, error: 'Kekurangan tutup siku "]"' };
-    // We can't strictly enforce blockDepth == 0 because our heuristic is very naive
-    // and might be thrown off by complex inline patterns, but it catches massive missing 'end's.
-    // So we'll return a warning instead of blocking if blockDepth != 0, 
-    // or we can just let it pass to Studio which will output the real error.
-    // For now, let's just use it as a basic check.
     return { valid: true };
 }

package/dist/roblox-bridge.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isBridgeHosting = void 0;
+exports.isStudioConnected = isStudioConnected;
 exports.setMcpConnected = setMcpConnected;
 exports.startBridgeServer = startBridgeServer;
 const express_1 = __importDefault(require("express"));
@@ -12,6 +13,7 @@ const socket_io_1 = require("socket.io");
 const path_1 = __importDefault(require("path"));
 const child_process_1 = require("child_process");
 const task_queue_1 = require("./task-queue");
+const { version: SERVER_VERSION } = require('../package.json');
 exports.isBridgeHosting = false;
 // Global process error handlers agar server bridge tidak mati mendadak
 process.on('uncaughtException', (err) => {
@@ -27,17 +29,40 @@ let errorCount = 0;
 const sessionStart = new Date().toISOString();
 // Per-studio pending events queue: events yang belum diambil oleh Studio
 const studioEventQueues = new Map();
+const studioLastSeen = new Map();
+setInterval(() => {
+    const now = Date.now();
+    let changed = false;
+    for (const [sid, lastSeen] of studioLastSeen.entries()) {
+        if (now - lastSeen > 6000) {
+            studioEventQueues.delete(sid);
+            studioLastSeen.delete(sid);
+            changed = true;
+        }
+    }
+    if (changed) {
+        broadcastStatus();
+    }
+}, 3000);
+function isStudioConnected() {
+    return studioEventQueues.size > 0;
+}
 function enqueueForStudio(studioId, event) {
     if (studioId) {
         // Event untuk studio tertentu
         if (!studioEventQueues.has(studioId))
             studioEventQueues.set(studioId, []);
-        studioEventQueues.get(studioId).push(event);
+        const q = studioEventQueues.get(studioId);
+        q.push(event);
+        if (q.length > 100)
+            q.shift();
     }
     else {
         // Broadcast ke semua studio yang terdaftar
-        for (const [sid] of studioEventQueues) {
-            studioEventQueues.get(sid).push(event);
+        for (const [sid, q] of studioEventQueues.entries()) {
+            q.push(event);
+            if (q.length > 100)
+                q.shift();
         }
     }
 }
@@ -76,12 +101,10 @@ function sendEvent(peer, kind, payload) {
 function broadcastStatus() {
     const statusEvent = {
         mcpConnected,
-        studioCount: Math.max(ssePeers.size, studioEventQueues.size),
-        serverVersion: '2.1.8',
+        studioCount: studioEventQueues.size,
+        serverVersion: SERVER_VERSION,
     };
     broadcastEvent('status', statusEvent);
-    // Juga enqueue untuk Studio yang belum polling saat ini
-    enqueueForStudio(null, { kind: 'status', ...statusEvent });
 }
 /**
  * Push task ke semua Studio peer (broadcast ke semua Studio yang terbuka).
@@ -95,14 +118,13 @@ function broadcastTask(task) {
         data: task.data ?? null,
         remainingMs: 29000,
     };
-    broadcastEvent('request', taskEvent);
-    // Juga enqueue untuk Studio yang sedang tidak polling
     enqueueForStudio(null, { kind: 'request', ...taskEvent });
 }
 // ── Logging ───────────────────────────────────────────────────────────────────
+let logCounter = 0;
 function addLog(io, type, message) {
     const log = {
-        id: Date.now().toString(),
+        id: `${Date.now()}-${++logCounter}`,
         time: new Date().toLocaleTimeString('id-ID'),
         type,
         message,
@@ -123,6 +145,9 @@ function killZombieOnPort(port) {
             const lines = output.trim().split('\n');
             for (const line of lines) {
                 const parts = line.trim().split(/\s+/);
+                const localAddress = parts[1];
+                if (!localAddress || !localAddress.endsWith(`:${port}`))
+                    continue;
                 const pid = parts[parts.length - 1];
                 if (pid && pid !== '0' && pid !== String(process.pid)) {
                     try {
@@ -152,7 +177,7 @@ function killZombieOnPort(port) {
         return false;
     }
 }
-function startBridgeServer(port = 3055) {
+function startBridgeServer(port, isDaemon = false) {
     const app = (0, express_1.default)();
     const httpServer = (0, http_1.createServer)(app);
     const io = new socket_io_1.Server(httpServer, { cors: { origin: '*' } });
@@ -163,12 +188,12 @@ function startBridgeServer(port = 3055) {
     io.on('connection', (socket) => {
         socket.emit('init', {
             logs: activityLogs,
-            stats: { totalTasks, successCount, errorCount, sessionStart, studioConnected: Math.max(ssePeers.size, studioEventQueues.size) > 0, port },
+            stats: { totalTasks, successCount, errorCount, sessionStart, studioConnected: studioEventQueues.size > 0, port },
         });
     });
     // ── /api/stats ─────────────────────────────────────────────────────────────
     app.get('/api/stats', (req, res) => {
-        const activeStudios = Math.max(ssePeers.size, studioEventQueues.size);
+        const activeStudios = studioEventQueues.size;
         res.json({
             totalTasks, successCount, errorCount, sessionStart,
             studioConnected: activeStudios > 0,
@@ -178,10 +203,16 @@ function startBridgeServer(port = 3055) {
         });
     });
     // ── /api/ping ─────────────────────────────────────────────────────────────
-    // Dipertahankan untuk backward-compat (installer check, health check).
     app.get('/api/ping', (req, res) => {
-        const activeStudios = Math.max(ssePeers.size, studioEventQueues.size);
-        res.json({ status: 'ok', studioCount: activeStudios, mcpConnected, timestamp: Date.now() });
+        const uptime = Math.floor((Date.now() - new Date(sessionStart).getTime()) / 1000);
+        const activeStudios = studioEventQueues.size;
+        res.json({
+            status: 'ok',
+            version: SERVER_VERSION,
+            uptimeSeconds: uptime,
+            totalTasksProcessed: totalTasks,
+            activeStudios: activeStudios
+        });
     });
     // ── /api/stream (Snapshot endpoint untuk Roblox GetAsync) ───────────────
     // Roblox HttpService:GetAsync() TIDAK bisa streaming — ia block sampai
@@ -190,12 +221,13 @@ function startBridgeServer(port = 3055) {
     // Plugin mengulang GET ini setiap ~0.5 detik (pseudo-polling via snapshot).
     app.get('/api/stream', (req, res) => {
         const studioId = req.query.studioId || `anon-${Date.now()}`;
+        studioLastSeen.set(studioId, Date.now());
         // Daftarkan studio jika belum ada
         if (!studioEventQueues.has(studioId)) {
             studioEventQueues.set(studioId, []);
             io.emit('studio-status', { connected: true, studioCount: studioEventQueues.size, studioId });
             addLog(io, 'system', `Studio terdaftar. (ID: ${studioId.substring(0, 8)}…, Total: ${studioEventQueues.size})`);
-            if (!dashboardOpened) {
+            if (!isDaemon && !dashboardOpened) {
                 dashboardOpened = true;
                 const url = `http://localhost:${port}`;
                 const startCmd = process.platform === 'win32' ? `start "" "${url}"` : process.platform === 'darwin' ? `open "${url}"` : `xdg-open "${url}"`;
@@ -210,7 +242,7 @@ function startBridgeServer(port = 3055) {
         studioEventQueues.set(studioId, []); // kosongkan antrian
         // Selalu sertakan status terkini
         const events = [
-            { kind: 'status', mcpConnected, studioCount: studioEventQueues.size, serverVersion: '2.1.8' },
+            { kind: 'status', mcpConnected, studioCount: studioEventQueues.size, serverVersion: SERVER_VERSION },
         ];
         // Tambahkan events tertunda (misalnya task requests)
         for (const ev of queue) {
@@ -218,20 +250,6 @@ function startBridgeServer(port = 3055) {
             if (ev.kind !== 'status')
                 events.push(ev);
         }
-        // Jika ada task di queue global, sertakan juga
-        if (task_queue_1.taskQueue.length > 0) {
-            const task = task_queue_1.taskQueue.shift();
-            totalTasks++;
-            addLog(io, 'task', `Mengirim perintah '${task.command}' ke Studio (ID: ${studioId.substring(0, 8)}…).`);
-            events.push({
-                kind: 'request',
-                requestId: task.id,
-                command: task.command,
-                target: task.target,
-                data: task.data ?? null,
-                remainingMs: 29000,
-            });
-        }
         // Format sebagai teks SSE (setiap event = satu baris "data: ...\n\n")
         res.setHeader('Content-Type', 'text/plain');
         res.setHeader('Cache-Control', 'no-cache, no-store');
@@ -248,18 +266,26 @@ function startBridgeServer(port = 3055) {
         res.setHeader('Connection', 'keep-alive');
         res.setHeader('X-Accel-Buffering', 'no');
         res.flushHeaders();
+        let silenceTimer;
         const heartbeatTimer = setInterval(() => {
             try {
-                res.write(`data: ${JSON.stringify({ kind: 'heartbeat', timestamp: Date.now() })}\n\n`);
+                const payload = JSON.stringify({
+                    kind: 'heartbeat',
+                    timestamp: Date.now(),
+                    mcpConnected,
+                    serverVersion: SERVER_VERSION,
+                });
+                res.write(`data: ${payload}\n\n`);
+                silenceTimer.refresh();
             }
             catch {
                 cleanup();
             }
         }, 5000);
-        const silenceTimer = setTimeout(() => cleanup(), 60000);
+        silenceTimer = setTimeout(() => cleanup(), 60000);
         const peer = { studioId, res, connectedAt: Date.now(), heartbeatTimer, silenceTimer };
         ssePeers.set(studioId, peer);
-        sendEvent(peer, 'status', { mcpConnected, studioCount: studioEventQueues.size, serverVersion: '2.1.8' });
+        sendEvent(peer, 'status', { mcpConnected, studioCount: studioEventQueues.size, serverVersion: SERVER_VERSION });
         function cleanup() {
             clearInterval(heartbeatTimer);
             clearTimeout(silenceTimer);
@@ -304,15 +330,24 @@ function startBridgeServer(port = 3055) {
     // ── Notifikasi task baru ke Dashboard ────────────────────────────────────
     // Pengiriman task ke Studio dilakukan via /api/stream (snapshot polling).
     // Di sini kita hanya log ke dashboard browser.
-    task_queue_1.taskEmitter.on('new_task', () => {
-        if (task_queue_1.taskQueue.length === 0)
-            return;
-        const task = task_queue_1.taskQueue[0]; // preview saja, tidak shift
-        addLog(io, 'task', `Task baru antri: '${task.command}'${task.target ? ` → ${task.target}` : ''}. Menunggu Studio polling...`);
+    task_queue_1.taskEmitter.on('new_task', (task) => {
+        totalTasks++;
+        addLog(io, 'task', `Task dikirim ke Studio: '${task.command}'${task.target ? ` → ${task.target}` : ''}`);
+        broadcastTask(task);
     });
     // ── /api/tasks/enqueue (dari proses MCP eksternal / bridge forwarding) ────
     app.post('/api/tasks/enqueue', async (req, res) => {
         const { command, target, data } = req.body;
+        // Fast-check: pastikan setidaknya 1 Studio aktif polling
+        if (studioEventQueues.size === 0) {
+            await new Promise(r => setTimeout(r, 2000));
+            if (studioEventQueues.size === 0) {
+                return res.json({
+                    status: 'error',
+                    error: 'Roblox Studio tidak terdeteksi aktif. Pastikan Roblox Studio dibuka, place telah dimuat, dan plugin nvstudio-mcp dalam status terhubung.'
+                });
+            }
+        }
         try {
             const result = await (0, task_queue_1.addTaskToQueue)(command, target, data);
             res.json({ status: 'success', result });
@@ -324,32 +359,30 @@ function startBridgeServer(port = 3055) {
     // ── /api/tasks (legacy long-poll — dipertahankan untuk backward-compat) ───
     // Studio lama yang belum update plugin masih bisa bekerja via polling.
     const waitingPollers = [];
-    task_queue_1.taskEmitter.on('new_task_legacy', () => {
-        if (task_queue_1.taskQueue.length > 0 && waitingPollers.length > 0) {
+    task_queue_1.taskEmitter.on('new_task', (task) => {
+        if (waitingPollers.length > 0) {
             const pollRes = waitingPollers.shift();
-            const task = task_queue_1.taskQueue.shift();
-            totalTasks++;
-            addLog(io, 'task', `[Legacy] Mengirim perintah '${task?.command}' ke Studio.`);
+            const index = task_queue_1.taskQueue.findIndex(t => t.id === task.id);
+            if (index !== -1)
+                task_queue_1.taskQueue.splice(index, 1);
+            for (const queue of studioEventQueues.values()) {
+                const qIndex = queue.findIndex((e) => e.requestId === task.id);
+                if (qIndex !== -1)
+                    queue.splice(qIndex, 1);
+            }
+            addLog(io, 'task', `[Legacy] Mengirim perintah '${task.command}' ke Studio.`);
             pollRes?.json(task);
         }
     });
     app.get('/api/tasks', (req, res) => {
         if (task_queue_1.taskQueue.length > 0) {
             const task = task_queue_1.taskQueue.shift();
-            totalTasks++;
-            addLog(io, 'task', `[Legacy] Mengirim perintah '${task?.command}' ke Studio.`);
-            return res.json(task);
+            addLog(io, 'task', `[Legacy] Mengirim perintah tertunda '${task?.command}' ke Studio.`);
+            res.json(task);
+            return;
         }
-        const timeoutId = setTimeout(() => {
-            const index = waitingPollers.indexOf(res);
-            if (index !== -1) {
-                waitingPollers.splice(index, 1);
-                res.json({ id: null });
-            }
-        }, 20000);
         waitingPollers.push(res);
         req.on('close', () => {
-            clearTimeout(timeoutId);
             const index = waitingPollers.indexOf(res);
             if (index !== -1)
                 waitingPollers.splice(index, 1);

package/dist/task-queue.js

@@ -26,7 +26,18 @@ function addTaskToQueue(command, target, data) {
         }, 30000);
         exports.pendingTasks.set(id, { resolve, reject, timer });
         exports.taskQueue.push(task);
-        exports.taskEmitter.emit('new_task');
+        if (exports.taskQueue.length > 50) {
+            const droppedTask = exports.taskQueue.shift();
+            if (droppedTask) {
+                const pending = exports.pendingTasks.get(droppedTask.id);
+                if (pending) {
+                    clearTimeout(pending.timer);
+                    pending.reject(new Error("Timeout: Antrean Studio penuh, task dibuang."));
+                    exports.pendingTasks.delete(droppedTask.id);
+                }
+            }
+        }
+        exports.taskEmitter.emit('new_task', task);
     });
 }
 /**
@@ -39,6 +50,9 @@ function resolvePendingTask(id, status, result, error) {
     }
     clearTimeout(pending.timer);
     exports.pendingTasks.delete(id);
+    const index = exports.taskQueue.findIndex(t => t.id === id);
+    if (index !== -1)
+        exports.taskQueue.splice(index, 1);
     if (status === "success") {
         pending.resolve(result);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adiholick/nvstudio-mcp",
-  "version": "2.1.8",
+  "version": "2.2.1",
   "description": "Local Bridge Server MCP for Roblox Studio",
   "main": "dist/index.js",
   "bin": {