@adiholick/nvstudio-mcp 2.2.0 → 2.2.2

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`).
 
 ---
 
@@ -126,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

@@ -66,6 +66,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
 });
 // 5. Handler untuk menangani pemanggilan call_mcp_tool
 server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    await roblox_bridge_1.bridgeReadyPromise;
     if (request.params.name !== "call_mcp_tool") {
         throw new Error(`Tool tidak dikenali: ${request.params.name}`);
     }
@@ -140,6 +141,27 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
         let result;
         if (roblox_bridge_1.isBridgeHosting) {
             // Instance ini sendiri yang meng-host bridge server
+            if (!(0, roblox_bridge_1.isStudioConnected)()) {
+                for (let i = 0; i < 6; i++) {
+                    await new Promise(r => setTimeout(r, 50));
+                    if ((0, roblox_bridge_1.isStudioConnected)())
+                        break;
+                }
+                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 {

package/dist/roblox-bridge.js

@@ -3,7 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isBridgeHosting = void 0;
+exports.bridgeReadyPromise = exports.isBridgeHosting = void 0;
+exports.isStudioConnected = isStudioConnected;
 exports.setMcpConnected = setMcpConnected;
 exports.startBridgeServer = startBridgeServer;
 const express_1 = __importDefault(require("express"));
@@ -14,6 +15,10 @@ const child_process_1 = require("child_process");
 const task_queue_1 = require("./task-queue");
 const { version: SERVER_VERSION } = require('../package.json');
 exports.isBridgeHosting = false;
+let resolveBridgeReady;
+exports.bridgeReadyPromise = new Promise((resolve) => {
+    resolveBridgeReady = resolve;
+});
 // Global process error handlers agar server bridge tidak mati mendadak
 process.on('uncaughtException', (err) => {
     console.error('[Bridge] Uncaught Exception:', err);
@@ -29,15 +34,58 @@ const sessionStart = new Date().toISOString();
 // Per-studio pending events queue: events yang belum diambil oleh Studio
 const studioEventQueues = new Map();
 const studioLastSeen = new Map();
+const activeStudioPollers = new Map();
 setInterval(() => {
     const now = Date.now();
+    let changed = false;
     for (const [sid, lastSeen] of studioLastSeen.entries()) {
-        if (now - lastSeen > 60000) {
+        if (now - lastSeen > 35000) {
             studioEventQueues.delete(sid);
             studioLastSeen.delete(sid);
+            const poller = activeStudioPollers.get(sid);
+            if (poller) {
+                clearTimeout(poller.timer);
+                try {
+                    poller.res.end();
+                }
+                catch { }
+                activeStudioPollers.delete(sid);
+            }
+            changed = true;
         }
     }
-}, 30000);
+    if (changed) {
+        broadcastStatus();
+    }
+}, 5000);
+function isStudioConnected() {
+    return studioEventQueues.size > 0 || activeStudioPollers.size > 0;
+}
+function flushEventsToStudio(sid) {
+    const poller = activeStudioPollers.get(sid);
+    if (!poller)
+        return false;
+    const queue = studioEventQueues.get(sid) ?? [];
+    if (queue.length === 0)
+        return false;
+    studioEventQueues.set(sid, []); // kosongkan antrian
+    clearTimeout(poller.timer);
+    activeStudioPollers.delete(sid);
+    const events = [
+        { kind: 'status', mcpConnected, studioCount: Math.max(studioEventQueues.size, 1), serverVersion: SERVER_VERSION },
+        ...queue
+    ];
+    try {
+        poller.res.setHeader('Content-Type', 'text/plain');
+        poller.res.setHeader('Cache-Control', 'no-cache, no-store');
+        const body = events.map(ev => `data: ${JSON.stringify(ev)}`).join('\n');
+        poller.res.send(body);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 function enqueueForStudio(studioId, event) {
     if (studioId) {
         // Event untuk studio tertentu
@@ -47,6 +95,7 @@ function enqueueForStudio(studioId, event) {
         q.push(event);
         if (q.length > 100)
             q.shift();
+        flushEventsToStudio(studioId);
     }
     else {
         // Broadcast ke semua studio yang terdaftar
@@ -54,6 +103,7 @@ function enqueueForStudio(studioId, event) {
             q.push(event);
             if (q.length > 100)
                 q.shift();
+            flushEventsToStudio(sid);
         }
     }
 }
@@ -92,7 +142,7 @@ function sendEvent(peer, kind, payload) {
 function broadcastStatus() {
     const statusEvent = {
         mcpConnected,
-        studioCount: Math.max(ssePeers.size, studioEventQueues.size),
+        studioCount: studioEventQueues.size,
         serverVersion: SERVER_VERSION,
     };
     broadcastEvent('status', statusEvent);
@@ -179,12 +229,12 @@ function startBridgeServer(port, isDaemon = false) {
     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,
@@ -196,7 +246,7 @@ function startBridgeServer(port, isDaemon = false) {
     // ── /api/ping ─────────────────────────────────────────────────────────────
     app.get('/api/ping', (req, res) => {
         const uptime = Math.floor((Date.now() - new Date(sessionStart).getTime()) / 1000);
-        const activeStudios = Math.max(ssePeers.size, studioEventQueues.size);
+        const activeStudios = studioEventQueues.size;
         res.json({
             status: 'ok',
             version: SERVER_VERSION,
@@ -205,18 +255,18 @@ function startBridgeServer(port, isDaemon = false) {
             activeStudios: activeStudios
         });
     });
-    // ── /api/stream (Snapshot endpoint untuk Roblox GetAsync) ───────────────
-    // Roblox HttpService:GetAsync() TIDAK bisa streaming — ia block sampai
-    // koneksi ditutup. Endpoint ini: daftarkan studio, kirim semua events
-    // yang tertunda (status + queued tasks), lalu TUTUP koneksi.
-    // Plugin mengulang GET ini setiap ~0.5 detik (pseudo-polling via snapshot).
+    // ── /api/stream (True Long-Polling endpoint untuk Roblox GetAsync) ─────
+    // Roblox HttpService:GetAsync() menahan koneksi sampai server merespons.
+    // Jika ada task yang menunggu: kirim seketika (<1ms).
+    // Jika tidak ada task: tahan koneksi (hanging GET) hingga task baru tiba
+    // atau timeout 15 detik (heartbeat) untuk menjaga koneksi tetap segar.
     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 });
+            io.emit('studio-status', { connected: true, studioCount: Math.max(studioEventQueues.size, 1), studioId });
             addLog(io, 'system', `Studio terdaftar. (ID: ${studioId.substring(0, 8)}…, Total: ${studioEventQueues.size})`);
             if (!isDaemon && !dashboardOpened) {
                 dashboardOpened = true;
@@ -228,26 +278,55 @@ function startBridgeServer(port, isDaemon = false) {
                 });
             }
         }
+        // Jika poller lama untuk studio ini masih aktif, selesaikan dulu
+        const oldPoller = activeStudioPollers.get(studioId);
+        if (oldPoller) {
+            clearTimeout(oldPoller.timer);
+            try {
+                oldPoller.res.end();
+            }
+            catch { }
+            activeStudioPollers.delete(studioId);
+        }
         // Kumpulkan semua events yang belum dikirim ke studio ini
         const queue = studioEventQueues.get(studioId) ?? [];
-        studioEventQueues.set(studioId, []); // kosongkan antrian
-        // Selalu sertakan status terkini
-        const events = [
-            { kind: 'status', mcpConnected, studioCount: studioEventQueues.size, serverVersion: SERVER_VERSION },
-        ];
-        // Tambahkan events tertunda (misalnya task requests)
-        for (const ev of queue) {
-            // Hindari duplikat status
-            if (ev.kind !== 'status')
-                events.push(ev);
+        if (queue.length > 0) {
+            studioEventQueues.set(studioId, []); // kosongkan antrian
+            const events = [
+                { kind: 'status', mcpConnected, studioCount: studioEventQueues.size, serverVersion: SERVER_VERSION },
+            ];
+            for (const ev of queue) {
+                if (ev.kind !== 'status')
+                    events.push(ev);
+            }
+            res.setHeader('Content-Type', 'text/plain');
+            res.setHeader('Cache-Control', 'no-cache, no-store');
+            const body = events.map(ev => `data: ${JSON.stringify(ev)}`).join('\n');
+            return res.send(body);
         }
-        // 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');
-        const body = events
-            .map(ev => `data: ${JSON.stringify(ev)}`)
-            .join('\n');
-        res.send(body);
+        // Jika antrean kosong, TAHAN koneksi (Long-Polling) maksimal 15 detik
+        const timer = setTimeout(() => {
+            activeStudioPollers.delete(studioId);
+            try {
+                const events = [
+                    { kind: 'heartbeat', timestamp: Date.now() },
+                    { kind: 'status', mcpConnected, studioCount: studioEventQueues.size, serverVersion: SERVER_VERSION }
+                ];
+                res.setHeader('Content-Type', 'text/plain');
+                res.setHeader('Cache-Control', 'no-cache, no-store');
+                const body = events.map(ev => `data: ${JSON.stringify(ev)}`).join('\n');
+                res.send(body);
+            }
+            catch { }
+        }, 15000);
+        activeStudioPollers.set(studioId, { res, timer });
+        req.on('close', () => {
+            const current = activeStudioPollers.get(studioId);
+            if (current && current.res === res) {
+                clearTimeout(current.timer);
+                activeStudioPollers.delete(studioId);
+            }
+        });
     });
     // ── /api/events (SSE persisten untuk browser/klien modern) ───────────────
     app.get('/api/events', (req, res) => {
@@ -329,6 +408,20 @@ function startBridgeServer(port, isDaemon = false) {
     // ── /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 (!isStudioConnected()) {
+            for (let i = 0; i < 6; i++) {
+                await new Promise(r => setTimeout(r, 50));
+                if (isStudioConnected())
+                    break;
+            }
+            if (!isStudioConnected()) {
+                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 });
@@ -374,6 +467,7 @@ function startBridgeServer(port, isDaemon = false) {
         const server = httpServer.listen(port, () => {
             exports.isBridgeHosting = true;
             console.error(`[Bridge] SSE Bridge Server aktif di http://localhost:${port}`);
+            resolveBridgeReady(true);
         });
         server.on('error', async (err) => {
             if (err.code === 'EADDRINUSE') {
@@ -385,6 +479,7 @@ function startBridgeServer(port, isDaemon = false) {
                     if (pingRes.ok) {
                         exports.isBridgeHosting = false;
                         console.error(`[Bridge] Port ${port} sudah digunakan oleh NVStudio Bridge aktif. Menggunakan instance yang sudah berjalan.`);
+                        resolveBridgeReady(false);
                         return;
                     }
                 }
@@ -392,14 +487,16 @@ function startBridgeServer(port, isDaemon = false) {
                 if (retriesLeft > 0) {
                     console.error(`[Bridge] Port ${port} zombie. Mencoba membunuh...`);
                     killZombieOnPort(port);
-                    setTimeout(() => tryListen(retriesLeft - 1), 1500);
+                    setTimeout(() => tryListen(retriesLeft - 1), 500);
                 }
                 else {
                     console.error(`[Bridge] FATAL: Port ${port} tidak dapat dibuka.`);
+                    resolveBridgeReady(false);
                 }
             }
             else {
                 console.error(`[Bridge] FATAL: Gagal mendengarkan port ${port}:`, err.message);
+                resolveBridgeReady(false);
                 process.exit(1);
             }
         });

package/package.json

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

package/studio-plugin/Main.server.lua

@@ -335,7 +335,7 @@ function startConnectionLoop()
 					handleSSELine(line)
 				end
 			end
-			task.wait(0.8)
+			task.wait(0.05) -- Instant loop: server menahan request (hanging GET) saat idle
 		else
 			consecutiveErrors = consecutiveErrors + 1
 			-- Toleransi 2x gagal sebelum menandai server unreachable

package/studio-plugin/nvstudio_mcp.rbxmx

@@ -824,7 +824,7 @@ function startConnectionLoop()
 					handleSSELine(line)
 				end
 			end
-			task.wait(0.8)
+			task.wait(0.05) -- Instant loop: server menahan request (hanging GET) saat idle
 		else
 			consecutiveErrors = consecutiveErrors + 1
 			-- Toleransi 2x gagal sebelum menandai server unreachable
@@ -1088,7 +1088,8 @@ end
     if targetInstance and targetInstance ~= game then
         local descendants = {}
         pcall(function() descendants = targetInstance:GetDescendants() end)
-        for _, desc in ipairs(descendants) do
+        for i, desc in ipairs(descendants) do
+            if i % 300 == 0 then task.wait() end
             if matchCount >= MAX_MATCHES then break end
             if desc:IsA("LuaSourceContainer") then
                 if searchInScript(desc) then
@@ -1100,7 +1101,8 @@ end
         for _, service in ipairs(searchableServices) do
             local descendants = {}
             pcall(function() descendants = service:GetDescendants() end)
-            for _, desc in ipairs(descendants) do
+            for i, desc in ipairs(descendants) do
+                if i % 300 == 0 then task.wait() end
                 if matchCount >= MAX_MATCHES then break end
                 if desc:IsA("LuaSourceContainer") then
                     if searchInScript(desc) then

package/studio-plugin/script_grep.lua

@@ -48,7 +48,8 @@ return function(targetInstance, data, ctx, targetPath)
     if targetInstance and targetInstance ~= game then
         local descendants = {}
         pcall(function() descendants = targetInstance:GetDescendants() end)
-        for _, desc in ipairs(descendants) do
+        for i, desc in ipairs(descendants) do
+            if i % 300 == 0 then task.wait() end
             if matchCount >= MAX_MATCHES then break end
             if desc:IsA("LuaSourceContainer") then
                 if searchInScript(desc) then
@@ -60,7 +61,8 @@ return function(targetInstance, data, ctx, targetPath)
         for _, service in ipairs(searchableServices) do
             local descendants = {}
             pcall(function() descendants = service:GetDescendants() end)
-            for _, desc in ipairs(descendants) do
+            for i, desc in ipairs(descendants) do
+                if i % 300 == 0 then task.wait() end
                 if matchCount >= MAX_MATCHES then break end
                 if desc:IsA("LuaSourceContainer") then
                     if searchInScript(desc) then