@el4cteo/rbx-studio-mcp 0.5.9 → 0.6.1

package/README.md

@@ -83,7 +83,7 @@ Two things to watch: a playtest connects a second session, so pass `studioId` an
 
 ## The console panel
 
-Every call is logged with how long it took. Below the header is a command line — type a command, or type a sentence and a coding agent answers it.
+Every call is logged with how long it took. At the foot of the panel is a command line — type a command, or type a sentence and a coding agent answers it.
 
 | | |
 |---|---|
@@ -91,12 +91,12 @@ Every call is logged with how long it took. Below the header is a command line
 | `doctor` | check the setup |
 | `status` `version` `place` `clients` | what this session is |
 | `studios` `use <n>` | which Studio window calls go to |
-| `theme [name]` `visuals` `log [level]` `clear` `copy` | the panel |
+| `theme [name]` `visuals` `autoopen [on\|off]` `log [level]` `clear` `copy` | the panel |
 | `port [n]` `reconnect` | the connection |
 | `agent [use <id>\|new]` `stop` | which agent runs your prompts |
 | anything else | sent to that agent |
 
-Arrows walk the history, Tab completes.
+Click the bar and every command is listed with what it does. Keep typing to filter, scroll for the rest, click one to fill it in.
 
 **Prompts start a real agent** — whichever you have on PATH: Claude Code, Codex, opencode, Gemini, Cursor, Amp, Qwen Code, Factory Droid, goose, Copilot CLI, Aider, Crush, DeepSeek Harness. It runs headless, drives the same Studio, and its work appears in the log. It is a separate session from your terminal, billed separately, and allowed the `rbx-studio` tools only. `stop` cancels it.
 
@@ -111,15 +111,23 @@ Eight themes behind the tab on the right edge. Your pick is remembered.
 
 ## DeepSeek Harness (dsh)
 
-This server registers as a dsh plugin. The row ships in the package, at
-`node_modules/@el4cteo/rbx-studio-mcp/config/dsh.cordis.yml`:
-
-```sh
-dsh --profile headless --patch <that path> "add a spawn point"
+This server registers as a dsh plugin. Append this row to `$DSH_HOME/cordis.patch.yml`,
+or to `$DSH_HOME/profiles/<name>/cordis.patch.yml` for one profile only:
+
+```yaml
+- insert:
+    - id: mcp-rbx-studio
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: rbx-studio
+        transport: stdio
+        command: npx
+        args: ['-y', '@el4cteo/rbx-studio-mcp']
+        cwd: !!js process.cwd()
 ```
 
-To keep it, append the row to `$DSH_HOME/profiles/<name>/cordis.patch.yml` for one
-profile, or `$DSH_HOME/cordis.patch.yml` for all of them. Needs `DEEPSEEK_API_KEY`.
+Then `dsh --profile headless "what is in workspace"`. Needs `DEEPSEEK_API_KEY`.
+The same row, commented, is in `config/dsh.cordis.yml` for use with `dsh --patch`.
 
 ## Security
 

package/package.json

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

package/plugin/src/Commands.luau

@@ -40,6 +40,9 @@ export type Hooks = {
 	-- has to outlive the session is handed back to the script that can persist it.
 	savePort: (number) -> (),
 	saveTheme: (string) -> (),
+	-- Whether the panel may open itself on load, and the setter for it.
+	autoOpen: () -> boolean,
+	saveAutoOpen: (boolean) -> (),
 	-- The transport's own view of the connection, which the console only ever
 	-- receives second-hand as a string to display.
 	status: () -> string,
@@ -247,6 +250,63 @@ define({
 	end,
 })
 
+define({
+	name = "autoopen",
+	usage = "autoopen [on|off]",
+	summary = "let this panel open itself, or only ever from the toolbar",
+	run = function(args)
+		local current = hooks
+		if current == nil then
+			return
+		end
+
+		local wanted = args[1]
+		if wanted == nil then
+			Console.log(
+				"dim",
+				if current.autoOpen()
+					then "autoopen on -- the panel opens with the place, and with Play"
+					else "autoopen off -- the panel opens only from the toolbar button"
+			)
+			return
+		end
+
+		local value: boolean
+		if wanted == "on" then
+			value = true
+		elseif wanted == "off" then
+			value = false
+		else
+			Console.log("error", string.format("%q is not on or off", wanted), "autoopen [on|off]")
+			return
+		end
+
+		if value == current.autoOpen() then
+			Console.log("dim", string.format("already autoopen %s", wanted))
+			return
+		end
+
+		current.saveAutoOpen(value)
+		--[[
+			Said plainly, because nothing about it can be seen from here.
+
+			A dock widget's initial state is decided when Studio creates it, and
+			this one already exists -- so the change shows up at the next load,
+			not now. A setting that appears to do nothing is a setting the user
+			runs again, and then a third time, before deciding it is broken.
+		]]
+		if value then
+			Console.log("ok", "autoopen on", "the panel will come back on its own")
+		else
+			Console.log(
+				"ok",
+				"autoopen off",
+				"from the next place or playtest, open it from the toolbar"
+			)
+		end
+	end,
+})
+
 define({
 	name = "place",
 	usage = "place",

package/plugin/src/Config.luau

@@ -9,7 +9,7 @@
 
 local Config = {}
 
-Config.PLUGIN_VERSION = "0.5.9"
+Config.PLUGIN_VERSION = "0.6.1"
 
 -- 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/init.server.luau

@@ -47,6 +47,19 @@ local SETTING_AUTOCONNECT = "autoConnect"
 local SETTING_FORCE_POLL = "forcePoll"
 local SETTING_THEME = "theme"
 local SETTING_WIDGET_OPEN = "widgetOpen"
+--[[
+	Whether the panel is allowed to come up on its own at all.
+
+	Separate from `widgetOpen`, which is where the user last left it. That one
+	answers "was it open?"; this one answers "may it open itself?", and they are
+	different questions -- someone who wants the panel there when they ask for it
+	and nowhere else has no way to say so with a single remembered flag, because
+	opening it once would arm it for every load afterwards.
+
+	Off means the toolbar button is the only thing that opens it: not a place
+	being opened, not a Studio launch, not pressing Play. Set by `autoopen off`.
+]]
+local SETTING_AUTO_OPEN = "autoOpen"
 local SETTING_WIDGET_SIZE = "widgetSize"
 local SETTING_WIDGET_TRACE = "widgetTrace"
 
@@ -210,6 +223,27 @@ button.ClickableWhenViewportHidden = true
 local storedOpen = plugin:GetSetting(SETTING_WIDGET_OPEN)
 local wantOpen = if typeof(storedOpen) == "boolean" then storedOpen else true
 
+--[[
+	`autoopen off` means this load does not put the panel on screen.
+
+	Every DataModel, deliberately. The first version of this only covered the
+	playtest, on the reading that a window over the game view was the complaint
+	-- but a panel that reappears every time a place is opened is the same
+	complaint arriving through the other door, and one switch for "open yourself"
+	is easier to hold in your head than two.
+
+	Read here rather than acted on later because a dock widget's initial state is
+	fixed when it is created: bringing it up and hiding it again would flash a
+	window on screen, which is the thing being asked for less of. `widgetOpen` is
+	left exactly as it was, so turning this back on restores the panel to however
+	it was last left rather than to a default.
+]]
+local storedAutoOpen = plugin:GetSetting(SETTING_AUTO_OPEN)
+local autoOpen = if typeof(storedAutoOpen) == "boolean" then storedAutoOpen else true
+if not autoOpen then
+	wantOpen = false
+end
+
 local floatWidth, floatHeight = 560, 320
 local storedSize = plugin:GetSetting(SETTING_WIDGET_SIZE)
 if typeof(storedSize) == "table" then
@@ -435,6 +469,15 @@ Commands.setup({
 	saveTheme = function(id)
 		plugin:SetSetting(SETTING_THEME, id)
 	end,
+	autoOpen = function()
+		return autoOpen
+	end,
+	saveAutoOpen = function(value)
+		-- The live copy moves too, so `autoopen` with no argument reports what
+		-- was just set rather than what the session started with.
+		autoOpen = value
+		plugin:SetSetting(SETTING_AUTO_OPEN, value)
+	end,
 	status = function()
 		return currentStatus
 	end,