@chrrxs/robloxstudio-mcp 2.16.0 → 2.16.1

package/dist/index.js

@@ -386,30 +386,60 @@ function createHttpServer(tools, bridge, allowedTools, serverConfig) {
   });
   app.post("/ready", (req, res) => {
     const { pluginSessionId, instanceId, role, placeId, placeName, dataModelName, isRunning, pluginVersion, pluginVariant } = req.body;
+    const requestContext = {
+      instanceId: typeof instanceId === "string" ? instanceId : void 0,
+      role: typeof role === "string" ? role : void 0,
+      placeId: typeof placeId === "number" ? placeId : void 0,
+      placeName: typeof placeName === "string" ? placeName : void 0,
+      dataModelName: typeof dataModelName === "string" ? dataModelName : void 0,
+      isRunning: typeof isRunning === "boolean" ? isRunning : void 0,
+      pluginVersion: typeof pluginVersion === "string" ? pluginVersion : void 0,
+      pluginVariant: typeof pluginVariant === "string" ? pluginVariant : void 0
+    };
     if (!pluginSessionId || !instanceId || !role) {
+      const missingFields = [
+        !pluginSessionId ? "pluginSessionId" : void 0,
+        !instanceId ? "instanceId" : void 0,
+        !role ? "role" : void 0
+      ].filter((field) => !!field);
       res.status(400).json({
         success: false,
-        error: "pluginSessionId, instanceId, and role are required"
+        error: "missing_ready_fields",
+        message: `/ready missing required field(s): ${missingFields.join(", ")}`,
+        missingFields,
+        request: requestContext
+      });
+      return;
+    }
+    let result;
+    try {
+      result = bridge.registerInstance({
+        pluginSessionId,
+        instanceId,
+        role,
+        placeId: typeof placeId === "number" ? placeId : 0,
+        placeName: typeof placeName === "string" ? placeName : "",
+        dataModelName: typeof dataModelName === "string" ? dataModelName : "",
+        isRunning: !!isRunning,
+        pluginVersion: typeof pluginVersion === "string" ? pluginVersion : "",
+        pluginVariant: typeof pluginVariant === "string" ? pluginVariant : "unknown",
+        serverVersion: serverConfig?.version ?? ""
+      });
+    } catch (err) {
+      res.status(500).json({
+        success: false,
+        error: "ready_registration_exception",
+        message: err instanceof Error ? err.message : String(err),
+        request: requestContext
       });
       return;
     }
-    const result = bridge.registerInstance({
-      pluginSessionId,
-      instanceId,
-      role,
-      placeId: typeof placeId === "number" ? placeId : 0,
-      placeName: typeof placeName === "string" ? placeName : "",
-      dataModelName: typeof dataModelName === "string" ? dataModelName : "",
-      isRunning: !!isRunning,
-      pluginVersion: typeof pluginVersion === "string" ? pluginVersion : "",
-      pluginVariant: typeof pluginVariant === "string" ? pluginVariant : "unknown",
-      serverVersion: serverConfig?.version ?? ""
-    });
     if (!result.ok) {
       res.status(409).json({
         success: false,
         error: result.error.code,
         message: result.error.message,
+        request: requestContext,
         existing: result.error.existing
       });
       return;
@@ -4324,9 +4354,20 @@ ${code}`
         };
       }
       async stopPlaytest(instance_id) {
-        const response = await this._callSingle("/api/stop-playtest", {}, "edit", instance_id);
+        const { instanceId } = this._resolveSingleTarget("edit", instance_id);
+        const response = await this.client.request("/api/stop-playtest", {}, instanceId, "edit");
+        let wait;
+        if (response?.success === true) {
+          wait = await this._waitForRuntimeRoles(instanceId, { noRuntime: true }, 15);
+        }
+        const body = wait ? {
+          ...response,
+          runtimeStopped: wait.ok,
+          timedOut: wait.timedOut,
+          roles: wait.roles
+        } : response;
         return {
-          content: [{ type: "text", text: JSON.stringify(response) }]
+          content: [{ type: "text", text: JSON.stringify(body) }]
         };
       }
       async getPlaytestOutput(target, instance_id) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrrxs/robloxstudio-mcp",
-  "version": "2.16.0",
+  "version": "2.16.1",
   "description": "MCP server for testing, debugging, and controlling Roblox Studio from AI coding tools",
   "main": "dist/index.js",
   "type": "module",