rbxstudio-mcp 2.3.1 → 2.4.0

package/dist/tools/defs/inspection.js

@@ -0,0 +1,202 @@
+/**
+ * Read-only inspection tools: place info, services, instance/class/project
+ * structure, current selection, and Studio output buffer.
+ */
+export const inspectionTools = [
+    {
+        name: 'get_place_info',
+        description: 'Get place ID, name, and game settings',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        handler: (_args, { tools }) => tools.getPlaceInfo(),
+    },
+    {
+        name: 'get_services',
+        description: 'Get available Roblox services and their children',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                serviceName: {
+                    type: 'string',
+                    description: 'Optional specific service name to query',
+                },
+            },
+        },
+        handler: (args, { tools }) => tools.getServices(args?.serviceName),
+    },
+    {
+        name: 'get_instance_properties',
+        description: 'Get all properties of a specific Roblox instance in Studio',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                instancePath: {
+                    type: 'string',
+                    description: 'Roblox instance path using dot notation (e.g., "game.Workspace.Part", "game.ServerScriptService.MainScript", "game.ReplicatedStorage.ModuleScript")',
+                },
+            },
+            required: ['instancePath'],
+        },
+        handler: (args, { tools }) => tools.getInstanceProperties(args?.instancePath),
+    },
+    {
+        name: 'get_class_info',
+        description: 'Get available properties/methods for a Roblox class via live Studio reflection (what this engine build actually exposes). For canonical docs with descriptions and deprecation notes, use get_roblox_api_reference instead.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                className: {
+                    type: 'string',
+                    description: 'Roblox class name',
+                },
+            },
+            required: ['className'],
+        },
+        handler: (args, { tools }) => tools.getClassInfo(args?.className),
+    },
+    {
+        name: 'get_project_structure',
+        description: 'Get complete game hierarchy. IMPORTANT: Use maxDepth parameter (default: 3) to explore deeper levels of the hierarchy. Set higher values like 5-10 for comprehensive exploration',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: 'Optional path to start from (defaults to workspace root)',
+                    default: '',
+                },
+                maxDepth: {
+                    type: 'number',
+                    description: 'Maximum depth to traverse (default: 3). RECOMMENDED: Use 5-10 for thorough exploration. Higher values provide more complete structure',
+                    default: 3,
+                },
+                scriptsOnly: {
+                    type: 'boolean',
+                    description: 'Show only scripts and script containers',
+                    default: false,
+                },
+            },
+        },
+        handler: (args, { tools }) => tools.getProjectStructure(args?.path, args?.maxDepth, args?.scriptsOnly),
+    },
+    {
+        name: 'get_selection',
+        description: 'Get all currently selected objects',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        handler: (_args, { tools }) => tools.getSelection(),
+    },
+    {
+        name: 'grep',
+        description: "Powerful grep over the Roblox instance tree — like Claude Code's Grep, but for the explorer instead of the filesystem. " +
+            'Walks descendants of `path` (default `game`), filters by `glob` (Name pattern) and `type` (ClassName / IsA), then searches script `Source` for `pattern`. ' +
+            'Use this FIRST when the user mentions a script/instance you have not seen — much faster than browsing get_project_structure.\n\n' +
+            '`output_mode` controls the shape: "files_with_matches" (default) = instance paths with hits; "content" = matching lines with numbers + optional context (-A/-B/-C); "count" = per-instance counts. -i, head_limit, and multiline behave like Claude Code Grep.\n\n' +
+            'Notes: `pattern` is a Luau string pattern (NOT PCRE — use `%.` for a literal dot). Default `type` is ["LuaSourceContainer"] (all script kinds); Source is only read for those, so to search non-script instances by Name pass a `type` like ["Part"] plus `glob`, and for a Name-only search pass `pattern: ".*"` with a `glob`.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                pattern: {
+                    type: 'string',
+                    description: 'The Luau pattern to search for in script Source. Matched line-by-line by default, or against the whole source if `multiline` is true. To do a name-only search, pass ".*" here and use `glob` to filter by Name.',
+                },
+                path: {
+                    type: 'string',
+                    description: 'Instance path to scope the search to (e.g. "game.ServerScriptService"). Defaults to "game" (the entire DataModel).',
+                },
+                glob: {
+                    type: 'string',
+                    description: 'Filter which instances to even consider by their Name (Luau pattern, e.g. "Damage.*", "PlayerHandler"). Analogous to glob in Claude Code Grep.',
+                },
+                type: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by ClassName(s) or IsA group(s). E.g. ["Script", "LocalScript"], or ["LuaSourceContainer"] (matches all script kinds), or ["GuiObject"] for any UI element. Defaults to ["LuaSourceContainer"]. Each entry is tested with `instance:IsA(name)` so abstract types work.',
+                },
+                '-i': {
+                    type: 'boolean',
+                    description: 'Case-insensitive matching. Applies to both `pattern` (Source) and `glob` (Name). Default false.',
+                    default: false,
+                },
+                '-A': {
+                    type: 'number',
+                    description: 'Lines of context AFTER each match (like grep -A). Requires output_mode="content".',
+                    default: 0,
+                },
+                '-B': {
+                    type: 'number',
+                    description: 'Lines of context BEFORE each match (like grep -B). Requires output_mode="content".',
+                    default: 0,
+                },
+                '-C': {
+                    type: 'number',
+                    description: 'Lines of context BEFORE AND AFTER each match (like grep -C). Requires output_mode="content". Overrides -A/-B.',
+                    default: 0,
+                },
+                output_mode: {
+                    type: 'string',
+                    enum: ['files_with_matches', 'content', 'count'],
+                    description: 'Output format. "files_with_matches" (default) = paths only, like `grep -l`. "content" = matching lines with line numbers and context. "count" = match count per instance.',
+                    default: 'files_with_matches',
+                },
+                head_limit: {
+                    type: 'number',
+                    description: 'Limit output to first N entries across all modes (like `| head -N`). 0 = unlimited (default).',
+                    default: 0,
+                },
+                multiline: {
+                    type: 'boolean',
+                    description: 'When true, match the pattern against the entire source as one string (so `.` matches newlines, patterns can span lines). When false (default), match line-by-line.',
+                    default: false,
+                },
+            },
+            required: ['pattern'],
+        },
+        handler: (args, { tools }) => tools.grep(args?.pattern, {
+            path: args?.path,
+            glob: args?.glob,
+            type: args?.type,
+            caseInsensitive: args?.['-i'] ?? false,
+            after: args?.['-A'] ?? 0,
+            before: args?.['-B'] ?? 0,
+            context: args?.['-C'] ?? 0,
+            outputMode: args?.output_mode ?? 'files_with_matches',
+            headLimit: args?.head_limit ?? 0,
+            multiline: args?.multiline ?? false,
+        }),
+    },
+    {
+        name: 'get_output',
+        description: 'Read the Output window content from Roblox Studio. Captures print(), warn(), and error() messages. Use after play_solo to debug scripts.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of messages to return (default: 100)',
+                    default: 100,
+                },
+                since: {
+                    type: 'number',
+                    description: 'Only return messages after this Unix timestamp',
+                },
+                messageTypes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by message type: MessageOutput, MessageInfo, MessageWarning, MessageError',
+                },
+                clear: {
+                    type: 'boolean',
+                    description: 'Clear the output buffer after reading (default: false)',
+                    default: false,
+                },
+            },
+        },
+        handler: (args, { tools }) => tools.getOutput(args?.limit, args?.since, args?.messageTypes, args?.clear),
+    },
+];
+//# sourceMappingURL=inspection.js.map

package/dist/tools/defs/inspection.js.map

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

package/dist/tools/defs/objects.d.ts

@@ -0,0 +1,6 @@
+import type { ToolDef } from '../types.js';
+/**
+ * Object lifecycle tools: create, delete, clone, move, insert from Creator Store.
+ */
+export declare const objectTools: ToolDef[];
+//# sourceMappingURL=objects.d.ts.map

package/dist/tools/defs/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../../src/tools/defs/objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,EAqHhC,CAAC"}

package/dist/tools/defs/objects.js

@@ -0,0 +1,111 @@
+/**
+ * Object lifecycle tools: create, delete, clone, move, insert from Creator Store.
+ */
+export const objectTools = [
+    {
+        name: 'create_object',
+        description: 'Create a new Roblox object instance (basic, without properties)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                className: {
+                    type: 'string',
+                    description: 'Roblox class name (e.g., "Part", "Script", "Folder")',
+                },
+                parent: {
+                    type: 'string',
+                    description: 'Path to the parent instance (e.g., "game.Workspace")',
+                },
+                name: {
+                    type: 'string',
+                    description: 'Optional name for the new object',
+                },
+            },
+            required: ['className', 'parent'],
+        },
+        handler: (args, { tools }) => tools.createObject(args?.className, args?.parent, args?.name),
+    },
+    {
+        name: 'delete_object',
+        description: 'Delete a Roblox object instance',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                instancePath: {
+                    type: 'string',
+                    description: 'Path to the instance to delete',
+                },
+            },
+            required: ['instancePath'],
+        },
+        handler: (args, { tools }) => tools.deleteObject(args?.instancePath),
+    },
+    {
+        name: 'clone_instance',
+        description: 'Clone (copy) a Roblox instance to a new parent location. Creates a deep copy including all children and properties.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sourcePath: {
+                    type: 'string',
+                    description: 'Path to the instance to clone (e.g., "game.Workspace.walkietalkie")',
+                },
+                targetParent: {
+                    type: 'string',
+                    description: 'Path to the new parent (e.g., "game.ReplicatedStorage")',
+                },
+                newName: {
+                    type: 'string',
+                    description: 'Optional new name for the cloned instance',
+                },
+            },
+            required: ['sourcePath', 'targetParent'],
+        },
+        handler: (args, { tools }) => tools.cloneInstance(args?.sourcePath, args?.targetParent, args?.newName),
+    },
+    {
+        name: 'move_instance',
+        description: 'Move a Roblox instance to a new parent location. Changes the Parent property.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                instancePath: {
+                    type: 'string',
+                    description: 'Path to the instance to move (e.g., "game.Workspace.Tool")',
+                },
+                newParent: {
+                    type: 'string',
+                    description: 'Path to the new parent (e.g., "game.StarterPack")',
+                },
+            },
+            required: ['instancePath', 'newParent'],
+        },
+        handler: (args, { tools }) => tools.moveInstance(args?.instancePath, args?.newParent),
+    },
+    {
+        name: 'insert_asset',
+        description: 'Download and insert a Creator Store asset (model, package, etc.) into Roblox Studio for reference. Uses game:GetObjects() which works with any free/public asset. Perfect for loading reference code, example implementations, or asset libraries that the AI can then read and analyze using get_instance_children and get_script_source.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                assetId: {
+                    type: 'number',
+                    description: 'The Creator Store asset ID (the number from the asset URL, e.g., 104116977416770)',
+                },
+                folderName: {
+                    type: 'string',
+                    description: 'Name of the folder to create/use for storing assets (default: "AIReferences")',
+                    default: 'AIReferences',
+                },
+                targetParent: {
+                    type: 'string',
+                    description: 'Parent path where the folder should be created (default: "game.Workspace"). Use "game.ReplicatedStorage" or "game.ServerStorage" to keep assets out of the visible workspace.',
+                    default: 'game.Workspace',
+                },
+            },
+            required: ['assetId'],
+        },
+        handler: (args, { tools }) => tools.insertAsset(args?.assetId, args?.folderName, args?.targetParent),
+    },
+];
+//# sourceMappingURL=objects.js.map

package/dist/tools/defs/objects.js.map

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

package/dist/tools/defs/properties.d.ts

@@ -0,0 +1,6 @@
+import type { ToolDef } from '../types.js';
+/**
+ * Property modification tools: single-instance and bulk set/get.
+ */
+export declare const propertyTools: ToolDef[];
+//# sourceMappingURL=properties.d.ts.map

package/dist/tools/defs/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../src/tools/defs/properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,EAsElC,CAAC"}

package/dist/tools/defs/properties.js

@@ -0,0 +1,71 @@
+/**
+ * Property modification tools: single-instance and bulk set/get.
+ */
+export const propertyTools = [
+    {
+        name: 'set_property',
+        description: 'Set a property on any Roblox instance',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                instancePath: {
+                    type: 'string',
+                    description: 'Path to the instance (e.g., "game.Workspace.Part")',
+                },
+                propertyName: {
+                    type: 'string',
+                    description: 'Name of the property to set',
+                },
+                propertyValue: {
+                    description: 'Value to set the property to (any type)',
+                },
+            },
+            required: ['instancePath', 'propertyName', 'propertyValue'],
+        },
+        handler: (args, { tools }) => tools.setProperty(args?.instancePath, args?.propertyName, args?.propertyValue),
+    },
+    {
+        name: 'mass_set_property',
+        description: 'Set the same property on multiple instances at once',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                paths: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of instance paths to modify',
+                },
+                propertyName: {
+                    type: 'string',
+                    description: 'Name of the property to set',
+                },
+                propertyValue: {
+                    description: 'Value to set the property to (any type)',
+                },
+            },
+            required: ['paths', 'propertyName', 'propertyValue'],
+        },
+        handler: (args, { tools }) => tools.massSetProperty(args?.paths, args?.propertyName, args?.propertyValue),
+    },
+    {
+        name: 'mass_get_property',
+        description: 'Get the same property from multiple instances at once',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                paths: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of instance paths to read from',
+                },
+                propertyName: {
+                    type: 'string',
+                    description: 'Name of the property to get',
+                },
+            },
+            required: ['paths', 'propertyName'],
+        },
+        handler: (args, { tools }) => tools.massGetProperty(args?.paths, args?.propertyName),
+    },
+];
+//# sourceMappingURL=properties.js.map

package/dist/tools/defs/properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.js","sourceRoot":"","sources":["../../../src/tools/defs/properties.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,uCAAuC;QACpD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oDAAoD;iBAClE;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6BAA6B;iBAC3C;gBACD,aAAa,EAAE;oBACb,WAAW,EAAE,yCAAyC;iBACvD;aACF;YACD,QAAQ,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,eAAe,CAAC;SAC5D;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3B,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,CAAC;KACjF;IAED;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,qDAAqD;QAClE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,mCAAmC;iBACjD;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6BAA6B;iBAC3C;gBACD,aAAa,EAAE;oBACb,WAAW,EAAE,yCAAyC;iBACvD;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,eAAe,CAAC;SACrD;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3B,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,CAAC;KAC9E;IAED;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,uDAAuD;QACpE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,sCAAsC;iBACpD;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6BAA6B;iBAC3C;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC;SACpC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,CAAC;KACrF;CACF,CAAC"}

package/dist/tools/defs/runtime.d.ts

@@ -0,0 +1,6 @@
+import type { ToolDef } from '../types.js';
+/**
+ * Studio runtime tools: undo/redo and Play Solo session control.
+ */
+export declare const runtimeTools: ToolDef[];
+//# sourceMappingURL=runtime.d.ts.map

package/dist/tools/defs/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/tools/defs/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,EA0KjC,CAAC"}

package/dist/tools/defs/runtime.js

@@ -0,0 +1,145 @@
+import { INSTRUMENT_OVER_PLAYTEST, RUN_LIVE_LUA_NUDGE } from '../nudges.js';
+/**
+ * Studio runtime tools: undo/redo and Play Solo session control.
+ */
+export const runtimeTools = [
+    {
+        name: 'undo',
+        description: 'Undo the last MCP mutation(s) in Roblox Studio. All MCP mutation tools (create, delete, set_property, edit_script, execute_lua, etc.) are automatically wrapped in ChangeHistoryService recordings, so each tool call = one Ctrl+Z. Pass `count` to undo multiple steps in one round-trip; stops early at the bottom of Studio\'s undo stack and reports `stopped_early: true` in that case. The response\'s `entries` array describes each action undone (most-recent first). Call `get_history` first if you want to peek without committing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                count: {
+                    type: 'number',
+                    description: 'How many steps to undo (default 1, max 100). Each step is one MCP tool call worth of changes — e.g. mass_create_objects of 100 parts is ONE step. Stops early at the bottom of the undo stack.',
+                    default: 1,
+                    minimum: 1,
+                    maximum: 100,
+                },
+            },
+        },
+        handler: (args, { tools }) => tools.undo(args?.count),
+    },
+    {
+        name: 'redo',
+        description: 'Redo previously undone change(s) in Roblox Studio. Mirrors `undo`: pass `count` to redo multiple steps; stops early at the top of the redo stack and reports `stopped_early`. The redo stack is cleared whenever a new mutation is made (standard undo/redo semantics).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                count: {
+                    type: 'number',
+                    description: 'How many steps to redo (default 1, max 100).',
+                    default: 1,
+                    minimum: 1,
+                    maximum: 100,
+                },
+            },
+        },
+        handler: (args, { tools }) => tools.redo(args?.count),
+    },
+    {
+        name: 'get_history',
+        description: "Read-only view of the recent MCP undo/redo stacks. Use it to peek at what `undo` would revert, to recover awareness after a session resume, or to choose how far back to roll an `undo`.\n\nReturns Studio's `can_undo`/`can_redo` flags plus both stacks (most-recent first; index 0 is what undo/redo consumes next). Each entry has action, target, summary, timestamp, age_seconds; pass include_details:true for the per-action payload (off by default to keep responses small). Note: the undo stack is shared with the user's own Ctrl+Z, so can_undo may be true even when tracked_undo_count is 0.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Max entries to return per stack (default 20, max 100). The plugin retains the last 100 MCP actions.',
+                    default: 20,
+                    minimum: 1,
+                    maximum: 100,
+                },
+                include_details: {
+                    type: 'boolean',
+                    description: 'Include the per-action `details` payload (e.g. property values, batch counts). Off by default to save context — turn on when you actually need the granular data.',
+                    default: false,
+                },
+            },
+        },
+        handler: (args, { tools }) => tools.getHistory(args?.limit, args?.include_details),
+    },
+    {
+        name: 'play_solo',
+        description: 'Start a play test (Play Solo) in Roblox Studio via StudioTestService:ExecutePlayModeAsync. Automatically injects an in-test companion script so stop_play and get_playtest_output work. If a previous test is still tracked, stops it first. Returns a sessionId that ties together start, stop, and output reads.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        nudge: INSTRUMENT_OVER_PLAYTEST,
+        handler: (_args, { tools }) => tools.playSolo(),
+    },
+    {
+        name: 'stop_play',
+        description: 'Stop the current play test cleanly via StudioTestService:EndTest (called from inside the test by an injected companion script). Restores pre-play state — unlike RunService:Stop, this is the proper way to end a Play Solo session. Idempotent: returns successfully if no test is running.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        handler: (_args, { tools }) => tools.stopPlay(),
+    },
+    {
+        name: 'get_playtest_output',
+        description: "Read script output (print/warn/error) captured DURING a play test session. Streamed live from the test's Server DataModel by the injected companion. Survives after the test ends so you can debug post-hoc. For non-playtest output (Edit-mode plugin output, build messages), use get_output instead. Use the sinceSeq cursor returned in nextSinceSeq to tail incrementally.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sinceSeq: {
+                    type: 'number',
+                    description: 'Only return entries with seq > this value. Pass back nextSinceSeq from a prior call to avoid re-reading.',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max entries to return (default 500, max 5000).',
+                    default: 500,
+                },
+                messageTypes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by MessageType: MessageOutput, MessageInfo, MessageWarning, MessageError.',
+                },
+            },
+        },
+        nudge: INSTRUMENT_OVER_PLAYTEST,
+        handler: (args, { tools }) => tools.getPlaytestOutput(args?.sinceSeq, args?.limit, args?.messageTypes),
+    },
+    {
+        name: 'run_live_lua',
+        description: 'Execute Lua/Luau INSIDE a running play test (call play_solo first). Runs in the test\'s live DataModel with full access to running game state — fire RemoteEvents, query Players, read Workspace at the current physics tick, mutate the world. Different from execute_lua, which runs in the Edit-mode plugin context.\n\ntarget="server" (default) is the primary mode and needs `Game Settings → Security → LoadString` enabled (execution uses loadstring). target="client" is currently engine-blocked (Roblox disables loadstring in LocalScripts) and always returns loadstring_disabled — drive client behavior from the server via Remotes instead.\n\nNever throws: failures come back as { success: false, error, message } with an error enum (e.g. no_playtest, loadstring_disabled, compile_error, runtime_error, timeout). On success returns ALL Lua returns in `values` (array), plus `logs` when captureLogs=true and a `traceback` on error. Avoid `while true do end` without a task.wait() — it wedges the companion; bound long work with task.wait or timeoutMs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                code: {
+                    type: 'string',
+                    description: 'Lua/Luau source to execute. Has access to the full Roblox API in the test DataModel: game, workspace, all services (Players, ReplicatedStorage, etc.), Instance, Vector3, CFrame, Color3, etc., plus loadstring, require, debug. Use `return` to send values back to the caller (multi-return supported).',
+                },
+                target: {
+                    type: 'string',
+                    enum: ['server', 'client'],
+                    description: 'Where to run the code. "server" runs in the test\'s Server DataModel (full Game/RemoteEvent/DataStore access; needs LoadStringEnabled=true in place settings). "client" runs in a Player\'s LocalPlayer context (PlayerGui, ContextActionService, LocalPlayer.Character). Defaults to "server".',
+                    default: 'server',
+                },
+                playerName: {
+                    type: 'string',
+                    description: 'Only used when target="client" and multiple clients are connected. The display name (or username) of the Player to run the code on. If omitted and exactly one client is connected, that one is used.',
+                },
+                timeoutMs: {
+                    type: 'number',
+                    description: 'Max time the code may run before the watchdog fires with errorType="timeout". Range 1000–30000ms, default 5000ms.',
+                    default: 5000,
+                    minimum: 1000,
+                    maximum: 30000,
+                },
+                captureLogs: {
+                    type: 'boolean',
+                    description: 'When true (default), capture print()/warn()/error() output emitted by the code and return it in `logs`. Set to false if your code is chatty and you only care about return values.',
+                    default: true,
+                },
+            },
+            required: ['code'],
+        },
+        nudge: RUN_LIVE_LUA_NUDGE,
+        handler: (args, { tools }) => tools.runLiveLua(args?.code, args?.target ?? 'server', args?.playerName, args?.timeoutMs, args?.captureLogs),
+    },
+];
+//# sourceMappingURL=runtime.js.map

package/dist/tools/defs/runtime.js.map

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

package/dist/tools/defs/scripts.d.ts

@@ -0,0 +1,18 @@
+import type { ToolDef } from '../types.js';
+/**
+ * Script editing tools — string-based (Claude Code-style) only.
+ *
+ * The legacy line-based partial editors (edit_script_lines /
+ * insert_script_lines / delete_script_lines) were removed: line numbers
+ * shift on every edit, the model has to count manually, and `edit_script`
+ * does the same job more reliably with exact string matching + automatic
+ * syntax validation.
+ *
+ * `search_script` was also removed: the `grep` tool (inspection.ts)
+ * supersedes it — passing a single script path as `grep`'s `path` does
+ * the exact same single-script search, plus everything `grep` adds
+ * (cross-file, glob/type filters, output modes, head limits). Keeping
+ * two near-identical tools just creates choice paralysis for the LLM.
+ */
+export declare const scriptTools: ToolDef[];
+//# sourceMappingURL=scripts.d.ts.map

package/dist/tools/defs/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../../src/tools/defs/scripts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,EAsLhC,CAAC"}