sbox-mcp-server 1.5.0 → 1.5.1

package/dist/index.js

@@ -147,6 +147,8 @@ To get good results:
 
 5. Scene-mutating tools (create_gameobject, set_property, etc.) refuse during play mode and return a clear error. Stop play before making scene edits.
 
+6. First session with the bridge (or when the user asks "how do I start?" / "what can this do?")? Offer to run setup — invoke the \`sbox-setup\` skill: it verifies the connection, detects the user's installed libraries (\`list_libraries\`), recommends a first move, and points to help + feedback.
+
 If you're running inside Claude Code, install the companion plugin for the full workflow:
     /plugin marketplace add LouSputthole/Sbox-Claude
     /plugin install sbox-claude

package/dist/tools/discovery.js

@@ -18,6 +18,13 @@ export function registerDiscoveryTools(server, bridge) {
             return { content: [{ type: "text", text: `Error: ${res.error}` }] };
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
+    // ── list_libraries ───────────────────────────────────────────────
+    server.tool("list_libraries", "List the s&box libraries/addons installed in this project (reads Libraries/ + each .sbproj). Discovers what's available to build ON — e.g. character controllers (fish.scc = Shrimple Character Controller, facepunch.playercontroller), world/spline/road tools — so you can leverage an installed library (add its components via add_component_with_properties, or generate code against its API) instead of writing from scratch. Returns ident/org/title/type/enabled per library. Read-only.", {}, async () => {
+        const res = await bridge.send("list_libraries", {});
+        if (!res.success)
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    });
     // ── search_types ─────────────────────────────────────────────────
     server.tool("search_types", "Find types matching a name pattern. Pass components_only=true to filter to Component subclasses only. Useful for discovering 'is there a built-in X for this?'", {
         pattern: z.string().describe("Substring to match against type name (case-insensitive)"),

package/dist/tools/status.js

@@ -1,3 +1,4 @@
+import { z } from "zod";
 /**
  * Diagnostic and health-check tool (get_bridge_status).
  * Reports connection state, latency, host/port, and editor version.
@@ -60,5 +61,62 @@ export function registerStatusTools(server, bridge) {
             ],
         };
     });
+    // ── restart_editor ────────────────────────────────────────────────
+    server.tool("restart_editor", "Restart the s&box editor and wait for the bridge to reconnect — closes the C#-edit→recompile loop so addon/bridge changes apply without a manual restart. Relaunches straight back into the current project (EditorUtility.RestartEditor). Saves unsaved scenes by default (pass save:false to discard them). Blocks until the bridge is back (or waitMs elapses), then reports the handler count.", {
+        save: z
+            .boolean()
+            .optional()
+            .describe("Save unsaved scenes before restarting (default true; false discards them)"),
+        waitMs: z
+            .number()
+            .int()
+            .optional()
+            .describe("Max ms to wait for reconnect (default 150000)"),
+    }, async (params) => {
+        const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+        // Fire the restart. The editor closes mid-request, so a timeout/no-response here is EXPECTED.
+        try {
+            await bridge.send("restart_editor", { save: params.save ?? true }, 5000);
+        }
+        catch {
+            /* editor going down — expected */
+        }
+        const waitMs = params.waitMs ?? 150000;
+        const deadline = Date.now() + waitMs;
+        // Let the old process actually exit (heartbeat goes stale) before checking, so we
+        // don't false-positive on the pre-restart connection.
+        await sleep(8000);
+        while (Date.now() < deadline) {
+            await sleep(2500);
+            if (bridge.isConnected()) {
+                // Heartbeat is fresh again — confirm the request loop drains + read the count.
+                try {
+                    const st = await bridge.send("get_bridge_status", {}, 5000);
+                    if (st.success && st.data) {
+                        const hc = st.data.handlerCount;
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Editor restarted — bridge reconnected${hc ? ` with ${hc} handlers` : ""}.`,
+                                },
+                            ],
+                        };
+                    }
+                }
+                catch {
+                    /* still settling — keep polling */
+                }
+            }
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Restart fired, but the bridge didn't reconnect within ${waitMs}ms — the editor may still be compiling. Try get_bridge_status in a moment.`,
+                },
+            ],
+        };
+    });
 }
 //# sourceMappingURL=status.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbox-mcp-server",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "MCP Server for s&box game engine — enables Claude to build games through conversation",
   "type": "module",
   "main": "dist/index.js",