gdharness 1.2.22 → 1.2.23

package/build/cli.js

@@ -11422,7 +11422,7 @@ var init_tool_definitions = __esm(() => {
       name: "scene_tree",
       title: "Scene tree",
       effect: "read",
-      description: "The nodes of a scene file: names, classes and hierarchy, with properties when asked. Needs the editor connected.",
+      description: "The nodes of a scene file: names, classes and hierarchy, with properties when asked. Needs the editor connected. For the nodes of a game that is running, runtime_inspect tree, which needs no editor.",
       parameters: {
         projectPath: PROJECT_PATH,
         scenePath: SCENE_PATH,
@@ -44893,7 +44893,7 @@ class GodotServer {
     const { op: _op, ...arguments_ } = args;
     const bridge = async (command, extra = {}) => {
       const contained = this.containProjectFiles({ ...arguments_, ...extra });
-      return contained.ok ? await this.handleViaBridge(command, contained.value) : contained.response;
+      return contained.ok ? await this.handleViaBridge(command, contained.value, tool) : contained.response;
     };
     switch (tool) {
       case "project_info":
@@ -49101,9 +49101,11 @@ class GodotServer {
     const holds = held["classes"].map(String);
     return { unseen: unseenByEditor(projectPath, holds), stillHeld: heldButGone(projectPath, holds) };
   }
-  async handleViaBridge(toolName, args) {
+  async handleViaBridge(toolName, args, askedAs) {
     if (!this.godotBridge.isConnected()) {
+      const instead = askedAs !== undefined && Object.hasOwn(EDITOR_FREE_INSTEAD, askedAs) ? EDITOR_FREE_INSTEAD[askedAs] : undefined;
       return this.createErrorResponse("Editor not connected: no Godot editor with the gdharness editor addon has reached this server.", [
+        ...instead === undefined ? [] : [instead],
         "Open the project in the editor with editor_launch, or by hand",
         "Enable the addon under Project > Project Settings > Plugins",
         "editor_status says whether the bridge is up and what it is listening on"
@@ -49416,7 +49418,7 @@ async function runGodotServer() {
   const server = new GodotServer;
   await server.run();
 }
-var UPDATE_NOTICE_EVERY = 500, FEEDBACK_NOTICE_EVERY = 250, run4, __dirname2, EDITOR_SERVERS_START_MS = 20000, HOLD_PING_MS = 2000, SLOWEST_FRAME_RATE = 20, PLAY_STARTS_WITHIN_MS = 30000, KEEPER_ANSWER_MS = 15000, EXIT_REPORTED_WITHIN_MS = 2000, CONSOLE_WRAPPER, LONGEST_BOOT_NOTED_MS, PROFILE_SEND_MS = 5000, MOST_GROUPS = 20, RUNTIME_LISTENING_LINE = "[gdharness] runtime listening on ", VALUE_NAMES, BRIDGE_RETRY_MS = 2000, SUCCESSOR_CHECK_MS = 1e4, CONSOLE_WATCH_MS = 250, BOUNDARY_WAIT_MS = 2000, HANDOVER_MS, HANDOVER_POLL_MS = 250, CACHE_WRITE_MS = 2000, STREAMS_GRACE_MS = 2000, PLAYING_STATUS_MS = 1000, SCAN_START_MS = 2000, SCAN_SETTLED_MS = 500, REIMPORT_TIMEOUT_MS = 300000, OPS_ELSEWHERE, AUDIO_BUS_OPS, STALLED_AFTER_MS = 30000, TEST_HEARTBEAT_MS = 20000, DEPENDED_FAILED = "Failed to compile depended scripts", WAIT_FOR_RUN_MS = 600000, RUN_POLL_MS = 250, PATH_SOLUTIONS, PROJECT_FILE_ARGUMENTS, DEBUG_STATE_CALLS, PROJECT_INFO_SECTIONS2, RUNNER_DIRECTORY = "addons/gdUnit4/", PROFILE_FUNCTIONS = 30, PROFILER_ON_MS = 3000, PROPERTY_PLACES = "It is a property, so each place says whether it writes it (access write), which runs its set block, or reads it (access read), which runs its get block: withinCalls on a read says nothing of the set block, nor on a write of the get block unless the write is a compound one such as +=. Inside the property's own blocks its name is the value stored, which the engine reads and writes without running them, so those lines are not listed.", CALLERS_FOUND_BY_NAME = "Found by name in the project's scripts, since the engine's profiler counts calls and time per function and records nothing about who made them: a method of the same name on another class is listed too, unless one class was asked about and it is called through another class by name or through a variable declared as one. Each place carries the profile's numbers for the function it is written in.", MOST_ENGINE_ENTRIES = 200, ERROR_ASSERT = "GdUnitGodotErrorAssertImpl.gd", EXTERNAL_MEMBER = 'Could not resolve external class member "', STATIC_LIST_HINT;
+var UPDATE_NOTICE_EVERY = 500, FEEDBACK_NOTICE_EVERY = 250, run4, __dirname2, EDITOR_SERVERS_START_MS = 20000, HOLD_PING_MS = 2000, SLOWEST_FRAME_RATE = 20, PLAY_STARTS_WITHIN_MS = 30000, KEEPER_ANSWER_MS = 15000, EXIT_REPORTED_WITHIN_MS = 2000, CONSOLE_WRAPPER, LONGEST_BOOT_NOTED_MS, PROFILE_SEND_MS = 5000, MOST_GROUPS = 20, RUNTIME_LISTENING_LINE = "[gdharness] runtime listening on ", VALUE_NAMES, BRIDGE_RETRY_MS = 2000, SUCCESSOR_CHECK_MS = 1e4, CONSOLE_WATCH_MS = 250, BOUNDARY_WAIT_MS = 2000, HANDOVER_MS, HANDOVER_POLL_MS = 250, CACHE_WRITE_MS = 2000, STREAMS_GRACE_MS = 2000, PLAYING_STATUS_MS = 1000, SCAN_START_MS = 2000, SCAN_SETTLED_MS = 500, REIMPORT_TIMEOUT_MS = 300000, EDITOR_FREE_INSTEAD, OPS_ELSEWHERE, AUDIO_BUS_OPS, STALLED_AFTER_MS = 30000, TEST_HEARTBEAT_MS = 20000, DEPENDED_FAILED = "Failed to compile depended scripts", WAIT_FOR_RUN_MS = 600000, RUN_POLL_MS = 250, PATH_SOLUTIONS, PROJECT_FILE_ARGUMENTS, DEBUG_STATE_CALLS, PROJECT_INFO_SECTIONS2, RUNNER_DIRECTORY = "addons/gdUnit4/", PROFILE_FUNCTIONS = 30, PROFILER_ON_MS = 3000, PROPERTY_PLACES = "It is a property, so each place says whether it writes it (access write), which runs its set block, or reads it (access read), which runs its get block: withinCalls on a read says nothing of the set block, nor on a write of the get block unless the write is a compound one such as +=. Inside the property's own blocks its name is the value stored, which the engine reads and writes without running them, so those lines are not listed.", CALLERS_FOUND_BY_NAME = "Found by name in the project's scripts, since the engine's profiler counts calls and time per function and records nothing about who made them: a method of the same name on another class is listed too, unless one class was asked about and it is called through another class by name or through a variable declared as one. Each place carries the profile's numbers for the function it is written in.", MOST_ENGINE_ENTRIES = 200, ERROR_ASSERT = "GdUnitGodotErrorAssertImpl.gd", EXTERNAL_MEMBER = 'Could not resolve external class member "', STATIC_LIST_HINT;
 var init_server = __esm(() => {
   init_dist();
   init_stdio();
@@ -49480,6 +49482,9 @@ var init_server = __esm(() => {
     object: "an object"
   };
   HANDOVER_MS = SUCCESSOR_CHECK_MS + 5000;
+  EDITOR_FREE_INSTEAD = {
+    scene_tree: "runtime_inspect tree reads the nodes of a game that is running, and needs no editor; scene_tree reads a scene file through the editor"
+  };
   OPS_ELSEWHERE = {
     runtime_invoke: { get: "runtime_inspect property", property: "runtime_inspect property" }
   };

package/build/godot/operations/dependencies.gd

@@ -284,6 +284,15 @@ static func _code_of(line: String) -> String:
 	return bare if mark == -1 else bare.substr(0, mark)
 
 
+# [param content] with each line's comment taken off and its strings kept, which is where the paths
+# a script loads are written.
+static func _code_lines(content: String) -> String:
+	var kept: Array[String] = []
+	for line: String in content.split("\n"):
+		kept.append(Patterns.without_comment(line))
+	return "\n".join(kept)
+
+
 # The comment on [param line], strings emptied first so a # inside one does not start it.
 static func _comment_of(line: String) -> String:
 	var bare: String = Patterns.compiled(STRING_LITERAL).sub(line, '""', true)
@@ -361,6 +370,11 @@ func _analyze_resource(path: String, current_depth: int, walk: DependencyWalk) -
 	if file:
 		var content: String = file.get_as_text()
 		file.close()
+		# A script's comments name paths as examples, and read as references they were answered as
+		# dependencies, one of a file that does not exist: the shipped serialisation module's comment
+		# about `["res://addons/x/plugin.cfg"]` was a dependency of every project with the addon.
+		if path.get_extension() == "gd":
+			content = _code_lines(content)
 
 		for pattern: String in REFERENCE_PATTERNS:
 			var regex: RegEx = Patterns.compiled(pattern)

package/build/godot/operations/gdscript_analysis.gd

@@ -59,7 +59,7 @@ func get_gdscript_info(params: Dictionary) -> Dictionary:
 			if _triple_quotes(raw) % 2 == 1:
 				in_multiline_string = false
 			continue
-		var stripped: String = _without_comment(raw)
+		var stripped: String = Patterns.without_comment(raw)
 
 		if stripped.is_empty():
 			continue
@@ -101,7 +101,7 @@ func get_gdscript_info(params: Dictionary) -> Dictionary:
 		if _can_wrap(header):
 			while _bracket_depth(stripped) > 0 and i + 1 < lines.size():
 				i += 1
-				stripped = (stripped + " " + _without_comment(lines[i])).strip_edges()
+				stripped = (stripped + " " + Patterns.without_comment(lines[i])).strip_edges()
 			header = Patterns.without_annotations(stripped)
 		var declaration: RegExMatch = Patterns.declared_class(header)
 		if declaration != null:
@@ -508,28 +508,6 @@ func _up_to(text: String, needle: String) -> String:
 	return text
 
 
-# The line with any trailing comment taken off, quote-aware so a `#` inside a string stays.
-#
-# The only one of these scanners that does not count brackets, on purpose: a `#` starts a comment
-# wherever it is, and there is no depth at which it does not. Giving this one the depth its
-# neighbours have puts the comment into the value of `var table := {  # keyed by name`, because the
-# brace opens before the `#` and closes on a later line. Held by a case, since the argument for the
-# difference is not visible from the code and reads like an oversight beside its neighbours.
-func _without_comment(line: String) -> String:
-	var quote: String = ""
-	for i: int in range(line.length()):
-		var ch: String = line[i]
-		if not quote.is_empty():
-			if ch == quote and line[i - 1] != "\\":
-				quote = ""
-			continue
-		if ch == "#":
-			return line.substr(0, i).strip_edges()
-		if ch == '"' or ch == "'":
-			quote = ch
-	return line.strip_edges()
-
-
 # Where the bracket opened at [from] closes, or -1 if it does not.
 #
 # `rfind(")")` took the last one on the line, which is the right answer until something after the

package/build/godot/operations/patterns.gd

@@ -84,3 +84,25 @@ static func without_annotations(line: String) -> String:
 		rest = rest.substr(found.get_end()).strip_edges()
 		found = annotation.search(rest)
 	return rest
+
+
+# The line with any trailing comment taken off, quote-aware so a `#` inside a string stays.
+#
+# The only one of the scanners here that does not count brackets, on purpose: a `#` starts a comment
+# wherever it is, and there is no depth at which it does not. Giving this one the depth its
+# neighbours have puts the comment into the value of `var table := {  # keyed by name`, because the
+# brace opens before the `#` and closes on a later line. Held by a case, since the argument for the
+# difference is not visible from the code and reads like an oversight beside its neighbours.
+static func without_comment(line: String) -> String:
+	var quote: String = ""
+	for i: int in range(line.length()):
+		var ch: String = line[i]
+		if not quote.is_empty():
+			if ch == quote and line[i - 1] != "\\":
+				quote = ""
+			continue
+		if ch == "#":
+			return line.substr(0, i).strip_edges()
+		if ch == '"' or ch == "'":
+			quote = ch
+	return line.strip_edges()

package/build/index.js

@@ -34454,7 +34454,7 @@ var TOOL_SPECS = [
     name: "scene_tree",
     title: "Scene tree",
     effect: "read",
-    description: "The nodes of a scene file: names, classes and hierarchy, with properties when asked. Needs the editor connected.",
+    description: "The nodes of a scene file: names, classes and hierarchy, with properties when asked. Needs the editor connected. For the nodes of a game that is running, runtime_inspect tree, which needs no editor.",
     parameters: {
       projectPath: PROJECT_PATH2,
       scenePath: SCENE_PATH,
@@ -36448,6 +36448,9 @@ function engineFlagsNote(args) {
   const named = among.join(", ");
   return `${named} ${among.length === 1 ? "is a flag" : "are flags"} the engine reads, and args goes to the game after --, where the engine does not read ${among.length === 1 ? "it" : "them"}. engineArgs hands the engine its own flags; ${among.length === 1 ? "leave it" : "leave them"} in args only for a game that reads ${among.length === 1 ? "that flag" : "those flags"} itself.`;
 }
+var EDITOR_FREE_INSTEAD = {
+  scene_tree: "runtime_inspect tree reads the nodes of a game that is running, and needs no editor; scene_tree reads a scene file through the editor"
+};
 var OPS_ELSEWHERE = {
   runtime_invoke: { get: "runtime_inspect property", property: "runtime_inspect property" }
 };
@@ -37638,7 +37641,7 @@ class GodotServer {
     const { op: _op, ...arguments_ } = args;
     const bridge = async (command, extra = {}) => {
       const contained = this.containProjectFiles({ ...arguments_, ...extra });
-      return contained.ok ? await this.handleViaBridge(command, contained.value) : contained.response;
+      return contained.ok ? await this.handleViaBridge(command, contained.value, tool) : contained.response;
     };
     switch (tool) {
       case "project_info":
@@ -41846,9 +41849,11 @@ class GodotServer {
     const holds = held["classes"].map(String);
     return { unseen: unseenByEditor(projectPath, holds), stillHeld: heldButGone(projectPath, holds) };
   }
-  async handleViaBridge(toolName, args) {
+  async handleViaBridge(toolName, args, askedAs) {
     if (!this.godotBridge.isConnected()) {
+      const instead = askedAs !== undefined && Object.hasOwn(EDITOR_FREE_INSTEAD, askedAs) ? EDITOR_FREE_INSTEAD[askedAs] : undefined;
       return this.createErrorResponse("Editor not connected: no Godot editor with the gdharness editor addon has reached this server.", [
+        ...instead === undefined ? [] : [instead],
         "Open the project in the editor with editor_launch, or by hand",
         "Enable the addon under Project > Project Settings > Plugins",
         "editor_status says whether the bridge is up and what it is listening on"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdharness",
-  "version": "1.2.22",
+  "version": "1.2.23",
   "mcpName": "io.github.Aureliolo/gdharness",
   "description": "A harness for driving a Godot 4 project from an agent: editor addons, a runtime bridge into the running game, an MCP server in front of them, and a CLI that installs and diagnoses the Godot side.",
   "type": "module",