@satelliteoflove/godot-mcp 3.14.0 → 3.15.0

package/addon/command_router.gd

@@ -23,6 +23,7 @@ func setup(plugin: EditorPlugin) -> void:
 	_register_handler(MCPProfilerCommands.new(), plugin)
 	_register_handler(MCPRuntimeStateCommands.new(), plugin)
 	_register_handler(MCPGameTimeCommands.new(), plugin)
+	_register_handler(MCPExecCommands.new(), plugin)
 
 
 func _register_handler(handler: MCPBaseCommand, plugin: EditorPlugin) -> void:

package/addon/commands/exec_commands.gd

@@ -0,0 +1,117 @@
+@tool
+extends MCPBaseCommand
+class_name MCPExecCommands
+
+# godot_exec relay (#243): run / list / remove / clear execute in the game
+# bridge (mcp_game_bridge.gd); this side only forwards over the debugger
+# channel and waits, exactly like game_time_commands.gd. The server derives the
+# timeout cascade from the call's declared budget and pushes relay_timeout_ms
+# in params; the constants are fallbacks for an older server that pushes none.
+# RUN_TIMEOUT is generous because a synchronous user script cannot be aborted
+# mid-flight — the relay waiting is what turns a hung script into a typed
+# TIMEOUT instead of a socket kill.
+const BASE_TIMEOUT := 10.0
+const RUN_TIMEOUT := 28.0
+
+var _last_error: Dictionary = {}
+var _call_seq := 0
+
+
+func get_commands() -> Dictionary:
+	return {
+		"exec_run": exec_run,
+		"exec_list": exec_list,
+		"exec_remove": exec_remove,
+		"exec_clear": exec_clear,
+	}
+
+
+func exec_run(params: Dictionary) -> Dictionary:
+	return await _relay("exec_run", params, _relay_timeout(params, RUN_TIMEOUT))
+
+
+func exec_list(params: Dictionary) -> Dictionary:
+	return await _relay("exec_list", params, BASE_TIMEOUT)
+
+
+func exec_remove(params: Dictionary) -> Dictionary:
+	return await _relay("exec_remove", params, BASE_TIMEOUT)
+
+
+func exec_clear(params: Dictionary) -> Dictionary:
+	return await _relay("exec_clear", params, BASE_TIMEOUT)
+
+
+func _relay_timeout(params: Dictionary, fallback: float) -> float:
+	# Use the server-pushed relay budget when present (#276); the local constant
+	# is only a fallback for an older server that does not derive the cascade.
+	var ms: float = float(params.get("relay_timeout_ms", fallback * 1000.0))
+	return ms / 1000.0
+
+
+func _relay(msg_type: String, params: Dictionary, timeout: float) -> Dictionary:
+	# Explicit request/response correlation: the debugger plugin keys responses
+	# by msg_type alone, so a timed-out call's LATE response (a slow script that
+	# finished after we gave up) could otherwise be consumed as the answer to
+	# the next call of the same type — wrong result, silently, and every result
+	# after it shifted by one. The bridge echoes call_id; the wait loop discards
+	# mismatches. A response with no call_id (older addon) is accepted as-is.
+	_call_seq += 1
+	var call_id := _call_seq
+	params = params.duplicate()
+	params["call_id"] = call_id
+	var response = await _send_and_wait(msg_type, [params], timeout, call_id)
+	if response == null:
+		return _last_error
+	if response is Dictionary:
+		response.erase("call_id")  # transport detail, not part of the result
+		if response.has("error"):
+			return _error("EXEC_ERROR", str(response["error"]))
+		return _success(response)
+	return _success({"data": response})
+
+
+func _send_and_wait(msg_type: String, args: Array, timeout: float, call_id: int):
+	if not EditorInterface.is_playing_scene():
+		_last_error = _error("NOT_RUNNING", "No game is currently running")
+		return null
+
+	var debugger_plugin = _plugin.get_debugger_plugin() if _plugin else null
+	if debugger_plugin == null or not debugger_plugin.has_active_session():
+		_last_error = _error("NO_SESSION", "No active debug session")
+		return null
+
+	var sent: bool = debugger_plugin.send_game_message(msg_type, args)
+	if not sent:
+		_last_error = _error("SEND_FAILED", "Failed to send message to game")
+		return null
+
+	var start_time := Time.get_ticks_msec()
+	while true:
+		await Engine.get_main_loop().process_frame
+		# A hard runtime error (or failed assert) in exec'd code breaks the game
+		# into the editor debugger, suspending the bridge handler mid-call —
+		# left alone, the game sits paused and this relay times out.
+		# Auto-continue: the handler resumes, the error lands in its logger
+		# window, and the response arrives with runtime_errors as designed.
+		# Honest limit: the break REASON is not queryable, so this resumes ANY
+		# break in the window — including a developer's own breakpoint hit by
+		# unrelated game code while an exec call is in flight. Accepted for the
+		# dev-tooling threat model and surfaced in the tool description.
+		if debugger_plugin.is_session_breaked():
+			debugger_plugin.continue_session()
+		if debugger_plugin.has_response(msg_type):
+			var response = debugger_plugin.get_response(msg_type)
+			debugger_plugin.clear_response(msg_type)
+			if response is Dictionary and response.has("call_id") \
+					and int(response["call_id"]) != call_id:
+				continue  # a previous call's late response — discard, keep waiting for ours
+			return response
+		if (Time.get_ticks_msec() - start_time) / 1000.0 > timeout:
+			debugger_plugin.clear_response(msg_type)
+			var hint := ""
+			if debugger_plugin.is_session_breaked():
+				hint = " (the game is paused in the editor debugger and did not resume; press Continue in the editor or run godot_editor stop)"
+			_last_error = _error("TIMEOUT", "Timed out waiting for %s response%s" % [msg_type, hint])
+			return null
+	return null  # unreachable; satisfies the parser

package/addon/commands/exec_commands.gd.uid

@@ -0,0 +1 @@
+uid://clbw4kvqpf2py

package/addon/core/mcp_debugger_plugin.gd

@@ -326,3 +326,27 @@ func toggle_frame_profiler(enable: bool) -> void:
 	var session := get_session(_active_session_id)
 	if session:
 		session.toggle_profiler("mcp_frame_profiler", enable)
+
+
+# True when the debugger has paused the running game (script error, failed
+# assert, or breakpoint). A break suspends whatever bridge handler was running
+# mid-call, so relays that would otherwise time out can detect and recover.
+func is_session_breaked() -> bool:
+	if _active_session_id < 0:
+		return false
+	var session := get_session(_active_session_id)
+	return session != null and session.is_breaked()
+
+
+# Resume a debugger-paused game. EditorDebuggerSession exposes no continue API,
+# but the raw "continue" command is the same wire message the editor's Continue
+# button sends (ScriptEditorDebugger::_put_msg), and the game's RemoteDebugger
+# handles it in its break loop. Returns false when there is nothing to resume.
+func continue_session() -> bool:
+	if _active_session_id < 0:
+		return false
+	var session := get_session(_active_session_id)
+	if session == null or not session.is_breaked():
+		return false
+	session.send_message("continue", [])
+	return true

package/addon/game_bridge/mcp_exec_guard.gd

@@ -0,0 +1,225 @@
+extends RefCounted
+class_name MCPExecGuard
+
+## Pure helpers behind godot_exec (#243): the static denylist scan and the
+## function-body wrapper that turn agent-provided GDScript into something the
+## game bridge can compile and run. No engine-state access — everything here is
+## headless-testable (test/exec_guard_headless_test.gd).
+##
+## The scan is an ACCIDENT GUARD, not a security boundary: GDScript cannot be
+## sandboxed, and a determined author can trivially evade a token scan (string-
+## built calls, indirection). Its job is to stop a well-meaning agent from
+## casually reaching outside the game process (spawning processes, writing
+## files, persisting project damage) — the threat model of local dev tooling
+## where the agent already has shell access anyway.
+
+# Tokens that reach outside the game process or persist damage to disk.
+# Granularity rationale:
+#  - OS.* spawn/kill/shell methods individually (the rest of OS is harmless and
+#    frequently legitimate: get_ticks, environment reads, ...).
+#  - DirAccess whole-class: every directory mutation lives there; losing
+#    read-only listing is acceptable collateral.
+#  - FileAccess at the WRITE-constant level: any direct write-mode open must
+#    name one of these constants, while read access (loading a save file to
+#    inspect it) stays available — which is why FileAccess is not class-blocked.
+#  - ResourceSaver whole-class: writes res:// and user:// resources.
+#  - EditorInterface: belt-and-suspenders; not normally reachable from a game.
+const DENYLIST: Array[String] = [
+	"OS.execute",
+	"OS.execute_with_pipe",
+	"OS.create_process",
+	"OS.create_instance",
+	"OS.kill",
+	"OS.shell_open",
+	"OS.shell_show_in_file_manager",
+	"OS.move_to_trash",
+	"DirAccess",
+	"FileAccess.WRITE",
+	"FileAccess.READ_WRITE",
+	"FileAccess.WRITE_READ",
+	"ResourceSaver",
+	"ProjectSettings.save",
+	"ProjectSettings.save_custom",
+	"EditorInterface",
+]
+
+# Wrapped user code must compile under projects that escalate warnings to
+# errors, and snippets legitimately ignore parameters, shadow autoload names,
+# discard return values, etc. An invalid warning name here is itself a parse
+# error — pinned by the headless compile test on the Godot version in use.
+const WRAPPER_WARNING_IGNORES := "@warning_ignore(\"unused_parameter\", \"shadowed_global_identifier\", \"shadowed_variable\", \"shadowed_variable_base_class\", \"standalone_expression\", \"return_value_discarded\", \"unused_variable\", \"unreachable_code\", \"integer_division\")"
+
+
+## Scan agent-provided source BEFORE compiling. Comments and string contents
+## are stripped first, so `print("OS.execute")` passes while `OS.execute(...)`
+## is caught. Returns {ok: true} or {ok: false, token, message}.
+static func scan_source(source: String) -> Dictionary:
+	var lex := _lex(_normalize(source))
+	var stripped: String = lex["stripped"]
+	if stripped.strip_edges().is_empty():
+		return {
+			"ok": false,
+			"token": "",
+			"message": "NO_CODE: exec source contains no executable code (comments only or empty)",
+		}
+	# Normalize the SCAN copy (never the wrapper input) so the two formatter-
+	# plausible token splits — `OS . execute` and a line continuation after the
+	# dot — still match. Over-matching here only over-blocks, which is the safe
+	# direction for an accident guard.
+	stripped = stripped.replace("\\\n", "")
+	var dot_ws := RegEx.new()
+	dot_ws.compile("\\s*\\.\\s*")
+	stripped = dot_ws.sub(stripped, ".", true)
+	if _token_re("await").search(stripped) != null:
+		return {
+			"ok": false,
+			"token": "await",
+			"message": "SYNC_ONLY: exec source is synchronous-only; 'await' is not allowed. " +
+				"For waiting on game state, compose with godot_game_time step/step_until; " +
+				"for sustained behavior, attach a node under `holder`.",
+		}
+	for token in DENYLIST:
+		if _token_re(token).search(stripped) != null:
+			return {
+				"ok": false,
+				"token": token,
+				"message": "DENIED_TOKEN: source contains '%s' — blocked by the exec denylist " % token +
+					"(an accident guard against process/file-write escape, not a security boundary). " +
+					"Exec is for mutating the running game's state, not the system around it.",
+			}
+	return {"ok": true}
+
+
+## Wrap user source as the body of `_mcp_run(<binding_names>)` on a RefCounted,
+## so bindings are bare names (`G.wave = 5` just works) and multi-statement
+## code with control flow compiles. Lines inside multiline strings are left
+## untouched (prefixing them would corrupt string content); everything else is
+## prefixed with one indent unit matched to the user's own indent character, so
+## the wrapper can never introduce a mixed-tabs-and-spaces parse error.
+static func build_wrapper(source: String, binding_names: PackedStringArray) -> String:
+	var normalized := _normalize(source)
+	var lex := _lex(normalized)
+	var in_string_lines: Array = lex["in_string_lines"]
+	var lines := normalized.split("\n")
+	var indent := _detect_indent_unit(lines, in_string_lines, lex["in_bracket_lines"])
+	var body: Array = []
+	for i in lines.size():
+		var line: String = lines[i]
+		var starts_in_string: bool = in_string_lines[i] if i < in_string_lines.size() else false
+		if starts_in_string or line.strip_edges().is_empty():
+			body.append(line)
+		else:
+			body.append(indent + line)
+	return "extends RefCounted\n\n%s\nfunc _mcp_run(%s):\n%s\n" % [
+		WRAPPER_WARNING_IGNORES,
+		", ".join(binding_names),
+		"\n".join(body),
+	]
+
+
+static func _normalize(source: String) -> String:
+	return source.replace("\r\n", "\n").replace("\r", "\n")
+
+
+static func _token_re(token: String) -> RegEx:
+	# Word-boundary match so `OS.execute` does not hit `MyOS.executed` — and,
+	# because `_` is a word character, `OS.execute` does NOT match
+	# `OS.execute_with_pipe` (which has its own entry).
+	var re := RegEx.new()
+	re.compile("\\b%s\\b" % token.replace(".", "\\."))
+	return re
+
+
+## One lexical pass tracking string/comment/bracket state. Returns:
+##   stripped:         source with comments removed and string CONTENTS removed
+##                     (quotes kept), line structure preserved — the scan target
+##   in_string_lines:  per line, whether it STARTS inside a (triple-quoted)
+##                     string — those lines must not be indent-prefixed
+##   in_bracket_lines: per line, whether it STARTS inside an open ()/[]/{} —
+##                     bracket interiors have free-form indentation, so these
+##                     lines must not drive indent-unit detection
+## Known accepted miss: raw strings (r"...") treat backslash as an escape here
+## though GDScript does not — the failure mode is over-blocking or an honest
+## compile error, never silent corruption.
+static func _lex(source: String) -> Dictionary:
+	var stripped := ""
+	var in_string_lines: Array = [false]
+	var in_bracket_lines: Array = [false]
+	var quote := ""  # active quote: '"', "'", '"""', or "'''"
+	var depth := 0  # open-bracket depth, tracked outside strings/comments
+	var i := 0
+	var n := source.length()
+	while i < n:
+		var c := source[i]
+		if quote != "":
+			if c == "\n":
+				stripped += "\n"
+				in_string_lines.append(true)
+				in_bracket_lines.append(depth > 0)
+				i += 1
+			elif c == "\\":
+				# An escaped char never ends the string — but an escaped
+				# NEWLINE (a line continuation inside the string) still starts
+				# a new physical line. Record it, or every following line would
+				# be mis-indexed and build_wrapper would prefix indent into the
+				# string's runtime value: silent corruption.
+				if i + 1 < n and source[i + 1] == "\n":
+					stripped += "\n"
+					in_string_lines.append(true)
+					in_bracket_lines.append(depth > 0)
+				i += 2
+			elif source.substr(i, quote.length()) == quote:
+				stripped += quote
+				i += quote.length()
+				quote = ""
+			else:
+				i += 1
+			continue
+		if c == "#":
+			while i < n and source[i] != "\n":
+				i += 1
+			continue
+		if c == "\"" or c == "'":
+			quote = c.repeat(3) if source.substr(i, 3) == c.repeat(3) else c
+			stripped += quote
+			i += quote.length()
+			continue
+		if c == "(" or c == "[" or c == "{":
+			depth += 1
+		elif c == ")" or c == "]" or c == "}":
+			depth = maxi(0, depth - 1)
+		if c == "\n":
+			stripped += "\n"
+			in_string_lines.append(false)
+			in_bracket_lines.append(depth > 0)
+			i += 1
+			continue
+		stripped += c
+		i += 1
+	return {
+		"stripped": stripped,
+		"in_string_lines": in_string_lines,
+		"in_bracket_lines": in_bracket_lines,
+	}
+
+
+static func _detect_indent_unit(lines: PackedStringArray, in_string_lines: Array, in_bracket_lines: Array) -> String:
+	# Match the user's indent character: GDScript rejects mixed tabs/spaces in
+	# one indentation run, so the wrapper prefix must agree with the body. Four
+	# spaces composes with any space width (nesting only has to increase).
+	# Bracket-continuation lines are skipped: their indentation is free-form
+	# (a space-aligned array literal in otherwise tab-indented code is legal),
+	# so they must not decide the prefix for real block lines.
+	for i in lines.size():
+		if i < in_string_lines.size() and in_string_lines[i]:
+			continue
+		if i < in_bracket_lines.size() and in_bracket_lines[i]:
+			continue
+		var line := lines[i]
+		if line.strip_edges().is_empty():
+			continue
+		if line.begins_with("\t"):
+			return "\t"
+		if line.begins_with(" "):
+			return "    "
+	return "\t"

package/addon/game_bridge/mcp_exec_guard.gd.uid

@@ -0,0 +1 @@
+uid://cdscqjpsiv412

package/addon/game_bridge/mcp_game_bridge.gd

@@ -374,6 +374,18 @@ func _on_debugger_message(message: String, data: Array) -> bool:
 		"game_time_status":
 			_handle_game_time_status(data)
 			return true
+		"exec_run":
+			_handle_exec_run(data)
+			return true
+		"exec_list":
+			_handle_exec_list(data)
+			return true
+		"exec_remove":
+			_handle_exec_remove(data)
+			return true
+		"exec_clear":
+			_handle_exec_clear(data)
+			return true
 	return false
 
 
@@ -1031,7 +1043,7 @@ func _list_autoload_paths(scene_root: Node) -> Array:
 	if tree == null or tree.root == null:
 		return out
 	for child in tree.root.get_children():
-		if child == scene_root or child == self:
+		if child == scene_root or child == self or child == _exec_holder:
 			continue
 		out.append("/root/" + str(child.name))
 	return out
@@ -1075,6 +1087,10 @@ func _handle_watch_stop() -> void:
 class _MCPGameLogger extends Logger:
 	var _output: PackedStringArray = []
 	var _max_lines := 1000
+	# Lines trimmed off the front of the ring buffer, ever. Lets a caller hold a
+	# STABLE mark (dropped + size) across trims instead of a raw index that
+	# silently drifts when the buffer overflows (exec's runtime-error window).
+	var _dropped := 0
 	var _mutex := Mutex.new()
 
 	func _log_message(message: String, error: bool) -> void:
@@ -1083,6 +1099,7 @@ class _MCPGameLogger extends Logger:
 		_output.append(prefix + message)
 		if _output.size() > _max_lines:
 			_output.remove_at(0)
+			_dropped += 1
 		_mutex.unlock()
 
 	func _log_error(function: String, file: String, line: int, code: String,
@@ -1093,13 +1110,18 @@ class _MCPGameLogger extends Logger:
 		_output.append("[ERROR] " + msg)
 		if _output.size() > _max_lines:
 			_output.remove_at(0)
+			_dropped += 1
 		_mutex.unlock()
 
 	func get_output() -> PackedStringArray:
 		return _output
 
+	func get_dropped() -> int:
+		return _dropped
+
 	func clear() -> void:
 		_mutex.lock()
+		_dropped += _output.size()  # cleared lines are gone the same as trimmed ones
 		_output.clear()
 		_mutex.unlock()
 
@@ -1844,3 +1866,213 @@ func _finish_step() -> void:
 	_step_predicate_inputs = []
 	_step_report = []
 	_send_game_time_response(response_type, result)
+
+
+# ── godot_exec: run agent-provided GDScript in this game process (#243) ───────
+#
+# One-shot scripts compile as the body of `_mcp_run(<bindings>)` (see
+# MCPExecGuard.build_wrapper) and run synchronously right here. Persistent
+# behaviors are nodes the script attaches under the `holder` binding — a child
+# of /root, NOT of this bridge: bridge children inherit PROCESS_MODE_ALWAYS and
+# would keep acting under a freeze, while a root child pauses with the tree
+# (bots respect freeze/step) yet survives scene reloads. The game process dying
+# on stop is the cleanup guarantee.
+
+# Cap on runtime-error lines echoed back per exec — the full text stays in the
+# game console either way.
+const EXEC_MAX_ERROR_LINES := 20
+
+var _exec_holder: Node = null
+
+
+func _exec_params(data: Array) -> Dictionary:
+	return data[0] if data.size() > 0 and data[0] is Dictionary else {}
+
+
+# Responses correlate by message type alone in the editor plugin, so a late
+# response from a timed-out call could be consumed as the answer to the NEXT
+# call of the same type — wrong result, silently. Echoing the relay's call_id
+# lets the relay discard mismatches. Absent when the relay pushed none (older
+# server): the relay accepts unmatched responses then, so skew is safe both ways.
+func _send_exec_response(msg_type: String, result: Dictionary, params: Dictionary) -> void:
+	if params.has("call_id"):
+		result["call_id"] = params["call_id"]
+	EngineDebugger.send_message("godot_mcp:game_response", [msg_type, result])
+
+
+func _ensure_exec_holder() -> Node:
+	if _exec_holder != null and is_instance_valid(_exec_holder):
+		return _exec_holder
+	_exec_holder = Node.new()
+	_exec_holder.name = "MCPExecHolder"
+	# Stamp attach time on whatever user scripts add, so exec_list can report an
+	# age without trusting the script to record one.
+	_exec_holder.child_entered_tree.connect(func(child: Node) -> void:
+		child.set_meta("mcp_exec_attached_ms", Time.get_ticks_msec()))
+	get_tree().root.add_child(_exec_holder)
+	return _exec_holder
+
+
+# A stable position in the logger stream (survives ring-buffer trims): lines
+# appended ever = dropped + currently held.
+func _exec_logger_mark() -> int:
+	return (_logger.get_dropped() + _logger.get_output().size()) if _logger else 0
+
+
+# The window of logger lines produced since `mark` (an _exec_logger_mark
+# value), error lines only. Process-wide, not per-script: a concurrent game
+# error inside the window rides along — acceptable for an honest "what went
+# wrong" echo. If the ring buffer trimmed past the mark (a >1000-line script),
+# the lost stretch is reported instead of silently misattributed.
+func _exec_logger_delta(mark: int) -> Array:
+	var out: Array = []
+	if _logger == null:
+		return out
+	var lines := _logger.get_output()
+	var start := mark - _logger.get_dropped()
+	if start < 0:
+		out.append("... (log buffer overflowed; %d earlier lines lost — see the game console)" % -start)
+		start = 0
+	for i in range(start, lines.size()):
+		if not lines[i].begins_with("[ERROR] "):
+			continue
+		if out.size() >= EXEC_MAX_ERROR_LINES:
+			out.append("... (more errors truncated; see the game console)")
+			break
+		out.append(lines[i].substr(8))
+	return out
+
+
+func _build_exec_context() -> Dictionary:
+	# The step_until predicate context (autoloads by name + tree/root), plus
+	# `holder`. If a project defines an autoload literally named "holder", the
+	# autoload keeps the name (a duplicate parameter would be a parse error);
+	# the exec holder is still reachable as root.get_node("MCPExecHolder").
+	var ctx := _build_predicate_context()
+	var names: PackedStringArray = ctx["names"]
+	var inputs: Array = ctx["inputs"]
+	if not ("holder" in names):
+		names.append("holder")
+		inputs.append(_ensure_exec_holder())
+	return {"names": names, "inputs": inputs}
+
+
+func _handle_exec_run(data: Array) -> void:
+	var params := _exec_params(data)
+	var source: String = str(params.get("source", ""))
+
+	var scan := MCPExecGuard.scan_source(source)
+	if not scan.get("ok", false):
+		_send_exec_response("exec_run", {"error": str(scan.get("message", "exec source rejected"))}, params)
+		return
+
+	var ctx := _build_exec_context()
+	var script := GDScript.new()
+	script.source_code = MCPExecGuard.build_wrapper(source, ctx["names"])
+
+	var mark := _exec_logger_mark()
+	if script.reload() != OK or not script.can_instantiate():
+		var detail := "; ".join(PackedStringArray(_exec_logger_delta(mark)))
+		var msg := "exec compile error"
+		if detail.is_empty():
+			msg += " (parser text not captured; check the game console, e.g. minimal-godot-mcp get_console_output)"
+		else:
+			msg += ": " + detail
+		_send_exec_response("exec_run", {"error": msg}, params)
+		return
+
+	var inst: Object = script.new()
+	mark = _exec_logger_mark()
+	var t0 := Time.get_ticks_msec()
+	# Synchronous and non-preemptible: an infinite loop here hangs the game (the
+	# relay/server time out; godot_editor stop kills the process). That is the
+	# documented contract — no wall budget is pretended.
+	var result: Variant = inst.callv("_mcp_run", ctx["inputs"])
+	var duration := Time.get_ticks_msec() - t0
+
+	# Runtime backstop for the scanner's SYNC_ONLY rule (a string-built await
+	# can slip past a token scan): a suspended call returns a function state.
+	if typeof(result) == TYPE_OBJECT and result != null \
+			and result.get_class() == "GDScriptFunctionState":
+		_send_exec_response("exec_run", {"error":
+			"SCRIPT_SUSPENDED: the script hit an await and suspended (exec is synchronous-only; " +
+			"side effects before the await have already run). Use godot_game_time step/step_until to wait."}, params)
+		return
+
+	var out: Dictionary = {
+		"completed": true,
+		"result": _sanitize_value(result),
+		"duration_ms": duration,
+		"holder_children": _exec_holder.get_child_count() \
+			if _exec_holder != null and is_instance_valid(_exec_holder) else 0,
+	}
+	var errs := _exec_logger_delta(mark)
+	if not errs.is_empty():
+		out["runtime_errors"] = errs
+	_send_exec_response("exec_run", out, params)
+
+
+func _handle_exec_list(data: Array) -> void:
+	var params := _exec_params(data)
+	var nodes: Array = []
+	if _exec_holder != null and is_instance_valid(_exec_holder):
+		var now := Time.get_ticks_msec()
+		for child in _exec_holder.get_children():
+			var script_chars := 0
+			var s: Variant = child.get_script()
+			if s is GDScript:
+				script_chars = (s as GDScript).source_code.length()
+			nodes.append({
+				"name": str(child.name),
+				"class": child.get_class(),
+				"script_chars": script_chars,
+				"age_ms": now - int(child.get_meta("mcp_exec_attached_ms", now)),
+				# Internal processing too: Timers and tweened nodes drive
+				# themselves internally and would otherwise read as idle.
+				"processing": child.is_processing() or child.is_physics_processing() \
+					or child.is_processing_internal() or child.is_physics_processing_internal(),
+			})
+	_send_exec_response("exec_list", {"nodes": nodes, "count": nodes.size()}, params)
+
+
+func _handle_exec_remove(data: Array) -> void:
+	var params := _exec_params(data)
+	var node_name := str(params.get("name", ""))
+	var child: Node = null
+	if _exec_holder != null and is_instance_valid(_exec_holder) and not node_name.is_empty():
+		# Name EQUALITY against direct children — never a NodePath lookup: a
+		# path-like name would traverse out of the holder (".." resolves to
+		# /root, "a/b" to a grandchild) and queue_free whatever it lands on.
+		for c in _exec_holder.get_children():
+			if str(c.name) == node_name:
+				child = c
+				break
+	if child == null:
+		var have: Array = []
+		if _exec_holder != null and is_instance_valid(_exec_holder):
+			for c in _exec_holder.get_children():
+				have.append(str(c.name))
+		_send_exec_response("exec_remove", {"error":
+			"NOT_FOUND: no exec node named '%s' (have: %s)" % [
+				node_name, ", ".join(PackedStringArray(have)) if not have.is_empty() else "none"]}, params)
+		return
+	# Detach immediately so a list right after this call already shows it gone;
+	# queue_free still frees the detached node at the end of the frame.
+	_exec_holder.remove_child(child)
+	child.queue_free()
+	_send_exec_response("exec_remove", {
+		"removed": true,
+		"name": node_name,
+		"remaining": _exec_holder.get_child_count(),
+	}, params)
+
+
+func _handle_exec_clear(data: Array) -> void:
+	var params := _exec_params(data)
+	var removed := 0
+	if _exec_holder != null and is_instance_valid(_exec_holder):
+		for child in _exec_holder.get_children():
+			_exec_holder.remove_child(child)
+			child.queue_free()
+			removed += 1
+	_send_exec_response("exec_clear", {"removed_count": removed}, params)

package/addon/plugin.cfg

@@ -3,6 +3,6 @@
 name="Godot MCP"
 description="Model Context Protocol server for AI assistant integration"
 author="godot-mcp"
-version="3.14.0"
+version="3.15.0"
 script="plugin.gd"
 godot_version_min="4.5"

package/dist/__tests__/connection/timeouts.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { deriveTimeouts, maxInGameBudgetMs, QUICK_TIMEOUT_MS, ABSOLUTE_CEILING_MS, READY_WAIT_MS, BRIDGE_WALL_SLOP_MS, STEP_BUDGET_CAP_MS, INPUT_BUDGET_CAP_MS, } from '../../connection/timeouts.js';
+import { deriveTimeouts, maxInGameBudgetMs, QUICK_TIMEOUT_MS, ABSOLUTE_CEILING_MS, READY_WAIT_MS, BRIDGE_WALL_SLOP_MS, STEP_BUDGET_CAP_MS, INPUT_BUDGET_CAP_MS, EXEC_BUDGET_CAP_MS, } from '../../connection/timeouts.js';
 describe('timeout cascade (#276)', () => {
     describe('deriveTimeouts stagger invariant', () => {
         // The whole point: bridge answers before relay answers before the server
@@ -50,6 +50,9 @@ describe('timeout cascade (#276)', () => {
         it('input cap <= max in-game budget (with ready-wait)', () => {
             expect(INPUT_BUDGET_CAP_MS).toBeLessThanOrEqual(maxInGameBudgetMs({ readyWait: true }));
         });
+        it('exec cap <= max in-game budget (no ready-wait)', () => {
+            expect(EXEC_BUDGET_CAP_MS).toBeLessThanOrEqual(maxInGameBudgetMs({ readyWait: false }));
+        });
     });
     it('keeps the quick default unchanged at 30s', () => {
         expect(QUICK_TIMEOUT_MS).toBe(30_000);

package/dist/__tests__/connection/timeouts.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeouts.test.js","sourceRoot":"","sources":["../../../src/__tests__/connection/timeouts.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"timeouts.test.js","sourceRoot":"","sources":["../../../src/__tests__/connection/timeouts.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAEtC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAChD,yEAAyE;QACzE,wEAAwE;QACxE,0DAA0D;QAC1D,MAAM,KAAK,GAAG;YACZ,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE;YAC/D,EAAE,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;YAClE,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,EAAE;YACtE,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE;YACrE,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE;YAC3D,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,mBAAmB,EAAE,SAAS,EAAE,IAAI,EAAE;YACvE,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;SAC/D,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,0CAA0C,EAAE,GAAG,EAAE;gBAC5D,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC/D,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC/C,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;gBAC3C,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,CAAC;gBAC5D,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;gBACpD,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAC/F,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,2DAA2D;QAC3D,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,mBAAmB,CAAC,CAAC;QACzD,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACxG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC3G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,8EAA8E,EAAE,GAAG,EAAE;QAC5F,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,CAAC,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,CAAC,mBAAmB,CAAC,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,CAAC,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/tools/exec.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exec.test.d.ts.map

package/dist/__tests__/tools/exec.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/tools/exec.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tools/exec.test.js

@@ -0,0 +1,124 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { createMockGodot, createToolContext, structuredOf } from '../helpers/mock-godot.js';
+import { exec } from '../../tools/exec.js';
+import { deriveTimeouts, EXEC_BUDGET_CAP_MS } from '../../connection/timeouts.js';
+describe('godot_exec tool', () => {
+    let mock;
+    beforeEach(() => {
+        mock = createMockGodot();
+    });
+    describe('schema validation', () => {
+        it('run requires a non-empty source within the size cap', () => {
+            expect(exec.schema.safeParse({ action: 'run' }).success).toBe(false);
+            expect(exec.schema.safeParse({ action: 'run', source: '' }).success).toBe(false);
+            expect(exec.schema.safeParse({ action: 'run', source: 'return 1' }).success).toBe(true);
+            expect(exec.schema.safeParse({ action: 'run', source: 'x'.repeat(16_384) }).success).toBe(true);
+            expect(exec.schema.safeParse({ action: 'run', source: 'x'.repeat(16_385) }).success).toBe(false);
+        });
+        it('run enforces the published budget cap', () => {
+            expect(exec.schema.safeParse({ action: 'run', source: 'pass', budget_ms: EXEC_BUDGET_CAP_MS }).success).toBe(true);
+            expect(exec.schema.safeParse({ action: 'run', source: 'pass', budget_ms: EXEC_BUDGET_CAP_MS + 1 }).success).toBe(false);
+            expect(exec.schema.safeParse({ action: 'run', source: 'pass', budget_ms: 0 }).success).toBe(false);
+        });
+        it('remove requires a name; list and clear take no extra arguments', () => {
+            expect(exec.schema.safeParse({ action: 'remove' }).success).toBe(false);
+            expect(exec.schema.safeParse({ action: 'remove', name: '' }).success).toBe(false);
+            expect(exec.schema.safeParse({ action: 'remove', name: 'GodGuard' }).success).toBe(true);
+            expect(exec.schema.safeParse({ action: 'list' }).success).toBe(true);
+            expect(exec.schema.safeParse({ action: 'clear' }).success).toBe(true);
+        });
+    });
+    describe('run', () => {
+        it('forwards the source and returns the structured result', async () => {
+            mock.mockResponse({ completed: true, result: 5, duration_ms: 2, holder_children: 0 });
+            const ctx = createToolContext(mock);
+            const result = await exec.execute({ action: 'run', source: 'G.wave = 5\nreturn G.wave' }, ctx);
+            expect(mock.calls[0].command).toBe('exec_run');
+            expect(mock.calls[0].params.source).toBe('G.wave = 5\nreturn G.wave');
+            const data = structuredOf(result);
+            expect(data.completed).toBe(true);
+            expect(data.result).toBe(5);
+        });
+        it('passes runtime_errors through (the call still completes)', async () => {
+            mock.mockResponse({
+                completed: true,
+                result: null,
+                duration_ms: 1,
+                holder_children: 0,
+                runtime_errors: ["Invalid access to property or key 'foo' on a base object of type 'Nil'."],
+            });
+            const ctx = createToolContext(mock);
+            const result = await exec.execute({ action: 'run', source: 'var x = null\nreturn x.foo' }, ctx);
+            const data = structuredOf(result);
+            expect(data.completed).toBe(true);
+            expect(data.runtime_errors).toHaveLength(1);
+        });
+        it('derives the timeout cascade from budget_ms and pushes the relay budget', async () => {
+            mock.mockResponse({ completed: true, result: null, duration_ms: 0, holder_children: 0 });
+            const ctx = createToolContext(mock);
+            await exec.execute({ action: 'run', source: 'pass', budget_ms: 5000 }, ctx);
+            const call = mock.calls[0];
+            const t = deriveTimeouts(5000); // no ready-wait, same class as game_time
+            expect(call.params.relay_timeout_ms).toBe(t.relayMs);
+            expect(call.opts?.timeoutMs).toBe(t.serverMs);
+            // No wall budget: a synchronous script cannot be aborted, so none is pretended.
+            expect(call.params.wall_budget_ms).toBeUndefined();
+        });
+        it('defaults the budget to 10s when omitted', async () => {
+            mock.mockResponse({ completed: true, result: null, duration_ms: 0, holder_children: 0 });
+            const ctx = createToolContext(mock);
+            await exec.execute({ action: 'run', source: 'pass' }, ctx);
+            expect(mock.calls[0].opts?.timeoutMs).toBe(deriveTimeouts(10_000).serverMs);
+        });
+        it('propagates a bridge-side rejection (denylist, compile error)', async () => {
+            mock.mockError(new Error("DENIED_TOKEN: source contains 'OS.execute'"));
+            const ctx = createToolContext(mock);
+            await expect(exec.execute({ action: 'run', source: 'OS.execute("cmd", [])' }, ctx)).rejects.toThrow('DENIED_TOKEN');
+        });
+    });
+    describe('lifecycle', () => {
+        it('list returns the structured holder inventory', async () => {
+            mock.mockResponse({
+                nodes: [{ name: 'GodGuard', class: 'Timer', script_chars: 0, age_ms: 4200, processing: true }],
+                count: 1,
+            });
+            const ctx = createToolContext(mock);
+            const result = await exec.execute({ action: 'list' }, ctx);
+            expect(mock.calls[0].command).toBe('exec_list');
+            const data = structuredOf(result);
+            expect(data.count).toBe(1);
+            expect(data.nodes[0].name).toBe('GodGuard');
+        });
+        it('list keeps the structured shape when the holder is empty', async () => {
+            mock.mockResponse({ nodes: [], count: 0 });
+            const ctx = createToolContext(mock);
+            const result = await exec.execute({ action: 'list' }, ctx);
+            const data = structuredOf(result);
+            expect(data.count).toBe(0);
+            expect(data.nodes).toEqual([]);
+        });
+        it('remove forwards the name and returns the structured result', async () => {
+            mock.mockResponse({ removed: true, name: 'GodGuard', remaining: 0 });
+            const ctx = createToolContext(mock);
+            const result = await exec.execute({ action: 'remove', name: 'GodGuard' }, ctx);
+            expect(mock.calls[0].command).toBe('exec_remove');
+            expect(mock.calls[0].params.name).toBe('GodGuard');
+            const data = structuredOf(result);
+            expect(data.removed).toBe(true);
+            expect(data.remaining).toBe(0);
+        });
+        it('remove propagates NOT_FOUND from the bridge', async () => {
+            mock.mockError(new Error("NOT_FOUND: no exec node named 'Bogus' (have: GodGuard)"));
+            const ctx = createToolContext(mock);
+            await expect(exec.execute({ action: 'remove', name: 'Bogus' }, ctx)).rejects.toThrow('NOT_FOUND');
+        });
+        it('clear reports the removed count', async () => {
+            mock.mockResponse({ removed_count: 2 });
+            const ctx = createToolContext(mock);
+            const result = await exec.execute({ action: 'clear' }, ctx);
+            expect(mock.calls[0].command).toBe('exec_clear');
+            expect(result).toContain('Removed 2');
+        });
+    });
+});
+//# sourceMappingURL=exec.test.js.map

package/dist/__tests__/tools/exec.test.js.map

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

package/dist/connection/timeouts.d.ts

@@ -44,4 +44,5 @@ export declare function maxInGameBudgetMs(opts?: DeriveOptions): number;
 export declare function deriveTimeouts(inGameBudgetMs: number, opts?: DeriveOptions): DerivedTimeouts;
 export declare const STEP_BUDGET_CAP_MS = 50000;
 export declare const INPUT_BUDGET_CAP_MS = 40000;
+export declare const EXEC_BUDGET_CAP_MS = 30000;
 //# sourceMappingURL=timeouts.d.ts.map

package/dist/connection/timeouts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeouts.d.ts","sourceRoot":"","sources":["../../src/connection/timeouts.ts"],"names":[],"mappings":"AAuBA,kGAAkG;AAClG,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,6GAA6G;AAC7G,eAAO,MAAM,aAAa,QAAS,CAAC;AAEpC,sGAAsG;AACtG,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AAEzC,6EAA6E;AAC7E,eAAO,MAAM,eAAe,OAAQ,CAAC;AAErC,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAItC,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,OAAO,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,aAAkB,GAAG,MAAM,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,eAAe,CAQhG;AAOD,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,mBAAmB,QAAS,CAAC"}
+{"version":3,"file":"timeouts.d.ts","sourceRoot":"","sources":["../../src/connection/timeouts.ts"],"names":[],"mappings":"AAuBA,kGAAkG;AAClG,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,6GAA6G;AAC7G,eAAO,MAAM,aAAa,QAAS,CAAC;AAEpC,sGAAsG;AACtG,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AAEzC,6EAA6E;AAC7E,eAAO,MAAM,eAAe,OAAQ,CAAC;AAErC,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAItC,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,OAAO,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,aAAkB,GAAG,MAAM,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,eAAe,CAQhG;AAOD,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAC1C,eAAO,MAAM,kBAAkB,QAAS,CAAC"}

package/dist/connection/timeouts.js

@@ -69,4 +69,5 @@ export function deriveTimeouts(inGameBudgetMs, opts = {}) {
 // the published cap can never time out server-side.
 export const STEP_BUDGET_CAP_MS = 50_000; // game_time step / step_until (no ready-wait)
 export const INPUT_BUDGET_CAP_MS = 40_000; // godot_input sequence span / capture offsets / type_text duration (ready-wait)
+export const EXEC_BUDGET_CAP_MS = 30_000; // godot_exec run (no ready-wait; scripts should be fast, the cap is patience not enforcement)
 //# sourceMappingURL=timeouts.js.map

package/dist/connection/timeouts.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeouts.js","sourceRoot":"","sources":["../../src/connection/timeouts.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,0EAA0E;AAC1E,qEAAqE;AACrE,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,uEAAuE;AACvE,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,sDAAsD;AACtD,EAAE;AACF,oFAAoF;AACpF,wFAAwF;AACxF,yFAAyF;AACzF,wFAAwF;AACxF,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,4CAA4C;AAE5C,kGAAkG;AAClG,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,6GAA6G;AAC7G,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AAEpC,sGAAsG;AACtG,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAEtC,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAkBnF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAsB,EAAE;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,mBAAmB,GAAG,iBAAiB,GAAG,KAAK,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,cAAsB,EAAE,OAAsB,EAAE;IAC7E,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/E,MAAM,YAAY,GAAG,eAAe,GAAG,mBAAmB,CAAC;IAC3D,MAAM,OAAO,GAAG,KAAK,GAAG,YAAY,GAAG,eAAe,CAAC;IACvD,MAAM,QAAQ,GAAG,OAAO,GAAG,gBAAgB,CAAC;IAC5C,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;AAC9D,CAAC;AAED,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,oDAAoD;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,CAAI,8CAA8C;AAC3F,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,CAAG,gFAAgF"}
+{"version":3,"file":"timeouts.js","sourceRoot":"","sources":["../../src/connection/timeouts.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,0EAA0E;AAC1E,qEAAqE;AACrE,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,uEAAuE;AACvE,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,sDAAsD;AACtD,EAAE;AACF,oFAAoF;AACpF,wFAAwF;AACxF,yFAAyF;AACzF,wFAAwF;AACxF,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,4CAA4C;AAE5C,kGAAkG;AAClG,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,6GAA6G;AAC7G,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AAEpC,sGAAsG;AACtG,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAEtC,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAkBnF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAsB,EAAE;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,mBAAmB,GAAG,iBAAiB,GAAG,KAAK,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,cAAsB,EAAE,OAAsB,EAAE;IAC7E,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/E,MAAM,YAAY,GAAG,eAAe,GAAG,mBAAmB,CAAC;IAC3D,MAAM,OAAO,GAAG,KAAK,GAAG,YAAY,GAAG,eAAe,CAAC;IACvD,MAAM,QAAQ,GAAG,OAAO,GAAG,gBAAgB,CAAC;IAC5C,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;AAC9D,CAAC;AAED,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,oDAAoD;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,CAAI,8CAA8C;AAC3F,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,CAAG,gFAAgF;AAC7H,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,CAAI,8FAA8F"}

package/dist/tools/exec.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import type { AnyToolDefinition } from '../core/types.js';
+export declare const exec: import("../core/types.js").ToolDefinition<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"run">;
+    source: z.ZodString;
+    budget_ms: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"list">;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"remove">;
+    name: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"clear">;
+}, z.core.$strip>], "action">>;
+export declare const execTools: AnyToolDefinition[];
+//# sourceMappingURL=exec.d.ts.map

package/dist/tools/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/tools/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA6E1D,eAAO,MAAM,IAAI;;;;;;;;;;;8BAuDf,CAAC;AAEH,eAAO,MAAM,SAAS,EAAa,iBAAiB,EAAE,CAAC"}

package/dist/tools/exec.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import { defineTool } from '../core/define-tool.js';
+import { structured } from '../core/structured.js';
+import { deriveTimeouts, EXEC_BUDGET_CAP_MS } from '../connection/timeouts.js';
+// Generous for a script, tiny for the transport: the editor websocket moves
+// multi-megabyte screenshots, so this cap is about keeping exec calls
+// reviewable, not about what the wire can carry.
+const EXEC_SOURCE_MAX_CHARS = 16_384;
+const EXEC_DEFAULT_BUDGET_MS = 10_000;
+const ExecSchema = z.discriminatedUnion('action', [
+    z.object({
+        action: z
+            .literal('run')
+            .describe('Run one-shot GDScript inside the running game and return its value'),
+        source: z
+            .string()
+            .min(1)
+            .max(EXEC_SOURCE_MAX_CHARS)
+            .describe('GDScript statements, compiled as a function body. In scope: every autoload by its own ' +
+            'name (e.g. `G.wave = 5`), `tree` (SceneTree), `root` (root Window) — the same context as ' +
+            'step_until predicates — plus `holder`, a Node that survives scene reloads: attach nodes ' +
+            'under it for behavior that persists between tool calls (a Timer-driven guard, an autofire ' +
+            'bot), then manage them with list/remove/clear. Holder children pause with the tree, so a ' +
+            'bot armed under a freeze acts only after thaw/step. Use an explicit `return` to get a ' +
+            'value back (there is no implicit return): primitives (bool/int/float/String) come back ' +
+            'intact; any other type (Array/Dictionary/Object/Vector2) comes back as a str() preview ' +
+            'TRUNCATED to 200 chars — return JSON.stringify(...) yourself when you need structure. ' +
+            'print() output is not returned — use return values, or minimal-godot-mcp ' +
+            'get_console_output. Function bodies cannot declare top-level func/class — use lambdas ' +
+            'for callbacks, or build a sub-script with GDScript.new() and set_script() it onto a ' +
+            'holder child for _process-driven behavior. No `await` (synchronous-only; compose with ' +
+            'godot_game_time to wait). A runtime error or failed assert() breaks the game into the ' +
+            'editor debugger mid-call; the relay auto-resumes it and the error comes back in ' +
+            'runtime_errors (any debugger break in the call window is resumed, including a breakpoint ' +
+            'hit by unrelated game code).'),
+        budget_ms: z
+            .number()
+            .int()
+            .min(1)
+            .max(EXEC_BUDGET_CAP_MS)
+            .optional()
+            .describe(`Wall-clock patience for the call, used to size the timeout cascade (default ${EXEC_DEFAULT_BUDGET_MS}, ` +
+            `max ${EXEC_BUDGET_CAP_MS}). NOT enforcement: a synchronous script cannot be preempted, so an ` +
+            'infinite loop hangs the game past any budget — recover with godot_editor stop.'),
+    }),
+    z.object({
+        action: z
+            .literal('list')
+            .describe('List the nodes currently attached under the exec holder (name, class, age, processing state)'),
+    }),
+    z.object({
+        action: z.literal('remove').describe('Remove one exec holder child by name (queue_free)'),
+        name: z.string().min(1).describe('Node name as reported by list'),
+    }),
+    z.object({
+        action: z.literal('clear').describe('Remove every exec holder child (queue_free all)'),
+    }),
+]);
+export const exec = defineTool({
+    name: 'godot_exec',
+    annotations: { title: 'Game Script Execution', readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+    description: 'Execute GDScript inside the RUNNING game process — the scenario-setup primitive: grant ' +
+        'weapons, skip waves, spawn entities, arm persistent test bots, without baking debug hooks ' +
+        'into game code. Errors when no game is running. For launch-time setup, compose: godot_editor ' +
+        'run frozen=true -> godot_exec run (mutate state, attach bots under `holder`) -> ' +
+        'godot_game_time thaw. A static denylist rejects accidental process/file-write escape ' +
+        '(OS.execute, DirAccess, write-mode FileAccess, ResourceSaver, ProjectSettings.save, ...) and ' +
+        'names the offending token — an accident guard, NOT a security boundary. Compile errors ' +
+        'reject the call with the parser message; runtime errors come back in runtime_errors with the ' +
+        'call still completing.',
+    schema: ExecSchema,
+    async execute(args, { godot }) {
+        switch (args.action) {
+            case 'run': {
+                // Same cascade class as game_time (no bridge-ready wait), but no
+                // wall_budget_ms is pushed: the bridge cannot abort a synchronous
+                // script mid-flight, and pretending it enforces a wall would be
+                // dishonest. The stagger still holds — the relay and this socket
+                // simply wait budget-long before declaring the script hung.
+                const t = deriveTimeouts(args.budget_ms ?? EXEC_DEFAULT_BUDGET_MS);
+                const result = await godot.sendCommand('exec_run', { source: args.source, relay_timeout_ms: t.relayMs }, { timeoutMs: t.serverMs });
+                return structured(result);
+            }
+            case 'list': {
+                const result = await godot.sendCommand('exec_list');
+                // Structured in both branches: a result whose SHAPE depends on runtime
+                // data would make the empty case unparseable for structured readers.
+                return structured(result);
+            }
+            case 'remove': {
+                const result = await godot.sendCommand('exec_remove', { name: args.name });
+                return structured(result);
+            }
+            case 'clear': {
+                const result = await godot.sendCommand('exec_clear');
+                return `Removed ${result.removed_count} exec node(s).`;
+            }
+        }
+    },
+});
+export const execTools = [exec];
+//# sourceMappingURL=exec.js.map

package/dist/tools/exec.js.map

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

package/dist/tools/index.d.ts

@@ -12,4 +12,5 @@ export { inputTools } from './input.js';
 export { profilerTools } from './profiler.js';
 export { runtimeStateTools } from './runtime-state.js';
 export { gameTimeTools } from './game-time.js';
+export { execTools } from './exec.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAeA,wBAAgB,gBAAgB,IAAI,IAAI,CAcvC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAgBA,wBAAgB,gBAAgB,IAAI,IAAI,CAevC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/tools/index.js

@@ -12,6 +12,7 @@ import { inputTools } from './input.js';
 import { profilerTools } from './profiler.js';
 import { runtimeStateTools } from './runtime-state.js';
 import { gameTimeTools } from './game-time.js';
+import { execTools } from './exec.js';
 export function registerAllTools() {
     registry.registerTools(sceneTools);
     registry.registerTools(nodeTools);
@@ -26,6 +27,7 @@ export function registerAllTools() {
     registry.registerTools(profilerTools);
     registry.registerTools(runtimeStateTools);
     registry.registerTools(gameTimeTools);
+    registry.registerTools(execTools);
 }
 export { sceneTools } from './scene.js';
 export { nodeTools } from './node.js';
@@ -40,4 +42,5 @@ export { inputTools } from './input.js';
 export { profilerTools } from './profiler.js';
 export { runtimeStateTools } from './runtime-state.js';
 export { gameTimeTools } from './game-time.js';
+export { execTools } from './exec.js';
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,UAAU,gBAAgB;IAC9B,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;AACxC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,UAAU,gBAAgB;IAC9B,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@satelliteoflove/godot-mcp",
-  "version": "3.14.0",
+  "version": "3.15.0",
   "description": "MCP server for Godot Engine integration",
   "type": "module",
   "main": "dist/index.js",