@el4cteo/rbx-studio-mcp 0.3.5 → 0.3.6

package/dist/tools/input.js

@@ -20,8 +20,19 @@ import { defineTool } from "../lib/tool.js";
  * An earlier version of this file claimed the error was the ratio between the
  * device resolution and the screenshot's, which is wrong, and wrong in a way
  * that happens to land close to correct in the middle of the screen where it
- * was first observed. Reporting the measurement retires the guesswork: aim
- * once, read the delta, correct.
+ * was first observed.
+ *
+ * Applying it automatically was tried and reverted. The translation is real
+ * with nothing emulated -- (0,-58), which is exactly GuiService:GetGuiInset()
+ * -- and on an iPhone 16 in portrait, measured equal at two points 215px apart.
+ * On the SAME phone in LandscapeRight it is not a translation at all: the
+ * horizontal term inverts and scales (seen.x fitted 919 - 1.4 * sent.x), so
+ * subtracting the measured constant moved the aim from 187px out to 449px out.
+ *
+ * Nor can a better fit be sampled. Synthetic MOVES report no position --
+ * InputChanged never fires for SendMousePosition -- so the map is observable
+ * only by clicking, and probe clicks press whatever they land on. Aim once,
+ * read the delta, correct.
  */
 function landingNote(landed) {
     const dx = landed.seen.x - landed.sent.x;
@@ -31,7 +42,8 @@ function landingNote(landed) {
     }
     return (` COORDINATES ARE OFFSET: the last click was aimed at (${landed.sent.x}, ${landed.sent.y}) and the client read it at (${landed.seen.x}, ${landed.seen.y}) — ` +
         `off by (${dx}, ${dy}). Add (${-dx}, ${-dy}) to coordinates taken from a \`screenshot\` to hit what you are aiming at. ` +
-        "The offset is constant across the viewport but changes with the device and orientation, so re-read it from this field after either changes.");
+        "That correction is a constant translation with no device emulated and in portrait, but NOT in landscape emulation, where the horizontal term inverts — " +
+        "so under an emulated device treat it as one sample: click, read this field again, and correct from the newest one rather than reusing an earlier value.");
 }
 export function registerInputTools(context) {
     const { bridge } = context;
@@ -64,7 +76,15 @@ export function registerInputTools(context) {
             "get an error, not a success — check where things really are with " +
             "`character op=\"state\"`.\n\n" +
             "Mouse coordinates are viewport pixels from the top-left, so pair this " +
-            "with `screenshot` to see what is where before clicking it.",
+            "with `screenshot` to see what is where before clicking it. The client " +
+            "reads them at an offset the reply reports as `landed` — aim once, read " +
+            "where it actually landed, then correct. Under an emulated device that " +
+            "offset is large and stops being a simple translation, so re-read it " +
+            "after each click rather than reusing an earlier one.\n\n" +
+            "A `text` step types into the FOCUSED TextBox. Click the box in the same " +
+            "call, one step before the text, and the focus is taken for you; with no " +
+            "box to type into the step is reported as having done nothing rather " +
+            "than as delivered.",
         inputSchema: {
             steps: z
                 .array(z
@@ -91,7 +111,10 @@ export function registerInputTools(context) {
                     .describe("click only: which button. Defaults to left."),
                 x: z.number().optional().describe("click/move only: viewport pixels from the left."),
                 y: z.number().optional().describe("click/move only: viewport pixels from the top."),
-                text: z.string().optional().describe("text only: the string to type."),
+                text: z
+                    .string()
+                    .optional()
+                    .describe("text only: the string to type. Goes to the focused TextBox — click it first, in the same call."),
                 hold: z
                     .number()
                     .min(0)
@@ -163,6 +186,16 @@ export function registerInputTools(context) {
         else {
             parts.push('Read the result with `character op="state"`, `console`, or `screenshot`.');
         }
+        /*
+         * A step that ran and changed nothing is the failure this whole file
+         * exists to avoid reporting as success, so the client's own words about
+         * it go at the front where they cannot be skimmed past.
+         */
+        if (Array.isArray(response.notes)) {
+            for (const line of response.notes) {
+                parts.unshift(`WARNING: ${line}`);
+            }
+        }
         const note = parts.join(" ");
         return json(response, note);
     });

package/dist/tools/input.js.map

@@ -1 +1 @@
-{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/tools/input.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/tools/input.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@el4cteo/rbx-studio-mcp",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "MCP server for Roblox Studio. 29 tools, push-based SSE bridge, editor-safe script edits, one-step undo.",
   "type": "module",
   "license": "MIT",

package/plugin/src/Config.luau

@@ -9,7 +9,7 @@
 
 local Config = {}
 
-Config.PLUGIN_VERSION = "0.3.5"
+Config.PLUGIN_VERSION = "0.3.6"
 
 -- Fingerprint of plugin/src, stamped in by scripts/build-plugin.mjs. The server
 -- computes the same hash from its own copy of the sources and compares, so a

package/plugin/src/Console.luau

@@ -49,6 +49,43 @@ local MAX_RECORDS = 300
 ]]
 local PALETTE: Themes.Palette = Themes.palette()
 
+--[[
+	An optional listener on everything this console is told.
+
+	Exists for `Mirror`, which relays a playtest server's activity to the client
+	view that cannot reach the bridge itself. Kept as one hook rather than as
+	calls sprinkled through the file so there is a single place where "what the
+	console was told" is defined, and so the client half -- which sets no
+	observer -- cannot echo what it replays back into the channel.
+]]
+local observer: ((string, { any }) -> ())? = nil
+
+function Console.setObserver(fn: ((string, { any }) -> ())?)
+	observer = fn
+end
+
+local function notify(kind: string, arguments: { any })
+	local listener = observer
+	if listener ~= nil then
+		task.spawn(listener, kind, arguments)
+	end
+end
+
+--[[
+	Set on the console that is REPLAYING someone else's events.
+
+	A replayed call must not grow its own consequences. `recordCall` schedules
+	the "agent idle" summary, so a mirrored session scheduled one of its own and
+	then received the original over the channel too -- the same line twice, a
+	few pixels apart, which is exactly the sort of thing that makes a panel look
+	broken. The origin is the only session entitled to decide the burst ended.
+]]
+local mirroring = false
+
+function Console.setMirroring(value: boolean)
+	mirroring = value
+end
+
 -- Sigil plus colour per level. The sigil is what makes the log scannable at a
 -- glance; colour alone fails for anyone who cannot separate red from green.
 -- Named by palette key rather than by colour, because this table is built once
@@ -385,6 +422,7 @@ function Console.log(level: Level, message: string, detail: string?)
 		table.remove(state.records, 1)
 	end
 	redraw()
+	notify("log", { level, message, detail })
 end
 
 --[[
@@ -422,6 +460,7 @@ function Console.beginCall(title: string, kind: string)
 	Visuals.setCaption(title)
 	Visuals.setKind(PALETTE[look.key], look.urgency)
 	refreshCounters()
+	notify("beginCall", { title, kind })
 end
 
 --[[
@@ -446,6 +485,7 @@ function Console.recordCall(ok: boolean, milliseconds: number)
 	-- The band plots it: bar height is how long it took, colour is whether it
 	-- worked, and a failure knocks the solid off its axis as well.
 	Visuals.recordCall(milliseconds, ok, title)
+	notify("recordCall", { ok, milliseconds, title })
 
 	--[[
 		Says so when the session goes quiet, once per burst.
@@ -459,6 +499,9 @@ function Console.recordCall(ok: boolean, milliseconds: number)
 	]]
 	state.generation += 1
 	local mine = state.generation
+	if mirroring then
+		return
+	end
 	task.delay(QUIET_SECONDS, function()
 		if state.generation ~= mine or state.calls == 0 then
 			return
@@ -604,7 +647,7 @@ function Console.setStatus(status: string, meta: string)
 	local color = if status == "connected"
 		then PALETTE.green
 		elseif status == "connecting" then PALETTE.amber
-		elseif status == "standby" then PALETTE.dim
+		elseif status == "standby" or status == "mirroring" then PALETTE.dim
 		else PALETTE.red
 
 	dot.TextColor3 = color

package/plugin/src/Mirror.luau

@@ -0,0 +1,126 @@
+--!strict
+--[[
+	Carries console activity from a playtest's SERVER view to its CLIENT view.
+
+	Pressing Play gives this plugin three lives: the editor's, the playtest
+	server's, and the playtest client's. Studio shows whichever belongs to the
+	view you are looking at, and it defaults to the client -- which is the one
+	life that can do nothing. Roblox forbids HTTP from a client session, so that
+	panel has no way to see the bridge, and it sat on a standby notice while the
+	agent worked a few feet away in a view the user was not looking at.
+
+	The two DataModels share no memory, no globals and no services. The only
+	channel between them is the game's own replication, so that is what this
+	uses: the server plugin puts a RemoteEvent in ReplicatedStorage and fires
+	each console event across it; the client plugin listens and replays them
+	into its own console. The prism reacts, the log fills, and the view the user
+	actually has open stops lying about what is happening.
+
+	The cost is honest and worth stating: this plugin writes one instance into
+	the running game. It is `Archivable = false` so it can never be saved with
+	the place, it exists only while a playtest is running, and it goes when the
+	playtest's DataModel does. Nothing reads it but the client half of this
+	plugin, and nothing is sent up from the client -- the traffic is one-way, so
+	a game's own scripts cannot use it to reach the editor.
+]]
+
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local RunService = game:GetService("RunService")
+
+--[[
+	Named to be recognised in the Explorer rather than to be hidden.
+
+	Someone will see this appear in ReplicatedStorage mid-playtest and want to
+	know what put it there; a cryptic name turns that into a hunt. The prefix is
+	unlikely enough to collide with a real game's instances.
+]]
+local CHANNEL = "__rbxStudioMcpMirror"
+
+local Mirror = {}
+
+local remote: RemoteEvent? = nil
+
+--[[
+	True only in the half of a playtest that can reach the bridge.
+
+	`IsRunning` separates a playtest from the editor, and `IsServer` separates
+	the two halves of it. The editor session must not do any of this: it has no
+	playtest to mirror and writing to its ReplicatedStorage would put the
+	instance in the user's actual place.
+]]
+function Mirror.isPlaytestServer(): boolean
+	return RunService:IsRunning() and RunService:IsServer()
+end
+
+function Mirror.isPlaytestClient(): boolean
+	return RunService:IsRunning() and RunService:IsClient()
+end
+
+--[[
+	Opens the channel from the playtest server.
+
+	A leftover from an earlier test in the same DataModel is replaced rather
+	than reused: reusing one whose connections are gone looks like a working
+	channel that silently delivers nothing.
+]]
+function Mirror.startServer()
+	if not Mirror.isPlaytestServer() then
+		return
+	end
+	local existing = ReplicatedStorage:FindFirstChild(CHANNEL)
+	if existing ~= nil then
+		existing:Destroy()
+	end
+	local event = Instance.new("RemoteEvent")
+	event.Name = CHANNEL
+	-- Never saved with the place, whatever the user does while the test runs.
+	event.Archivable = false
+	event.Parent = ReplicatedStorage
+	remote = event
+end
+
+--[[
+	Sends one console event, and never fails loudly.
+
+	This is decoration on top of the console. A replication error here must not
+	take down the call it was reporting on, so every send is guarded and a dead
+	channel simply stops mirroring.
+]]
+function Mirror.send(kind: string, arguments: { any })
+	local event = remote
+	if event == nil then
+		return
+	end
+	pcall(function()
+		event:FireAllClients(kind, arguments)
+	end)
+end
+
+--[[
+	Listens on the playtest client.
+
+	`WaitForChild` with a timeout rather than an indefinite wait: if the server
+	half never opens the channel the client should go quiet, not hang a thread
+	for the length of the playtest.
+]]
+function Mirror.startClient(onMessage: (string, { any }) -> ())
+	if not Mirror.isPlaytestClient() then
+		return
+	end
+	task.spawn(function()
+		local event = ReplicatedStorage:WaitForChild(CHANNEL, 30)
+		if event == nil or not event:IsA("RemoteEvent") then
+			return
+		end
+		event.OnClientEvent:Connect(function(kind, arguments)
+			-- Shape-checked because anything on the wire can be forged by a
+			-- script in the place being tested. Nothing here is trusted enough
+			-- to index without looking.
+			if typeof(kind) == "string" and typeof(arguments) == "table" then
+				onMessage(kind, arguments :: { any })
+			end
+		end)
+	end)
+end
+
+return Mirror