gdharness 0.9.1 → 0.9.2

package/build/cli.js

@@ -14711,6 +14711,9 @@ var init_types = __esm(() => {
 
 // src/paths.ts
 import { isAbsolute, relative, resolve, sep } from "node:path";
+function isSameDirectory(onePath, otherPath) {
+  return relative(resolve(onePath), resolve(otherPath)) === "";
+}
 function isWithinRoot(rootPath, candidatePath) {
   const step = relative(resolve(rootPath), resolve(candidatePath));
   return step !== ".." && !step.startsWith(`..${sep}`) && !isAbsolute(step);
@@ -15845,7 +15848,11 @@ var init_tool_definitions = __esm(() => {
           blank: true,
           description: `set: the value, fitted to the property's type. "" writes an empty string.`
         },
-        method: { type: "string", ops: ["call"] },
+        method: {
+          type: "string",
+          ops: ["call"],
+          description: 'call: which one to call. Colons call through the objects a node holds, "_game:run:advance", the same way a property is written through them.'
+        },
         args: {
           type: "array",
           ops: ["call"],
@@ -15858,7 +15865,10 @@ var init_tool_definitions = __esm(() => {
           summary: "set a property, on a node or on an object it holds",
           requires: ["property", "value"]
         },
-        call: { summary: "call a method and return its result", requires: ["method"] }
+        call: {
+          summary: "call a method, on a node or on an object it holds, and return its result",
+          requires: ["method"]
+        }
       }
     },
     {
@@ -30772,11 +30782,29 @@ var init_stdio2 = __esm(() => {
 });
 
 // src/bridge-announce.ts
-import { mkdirSync as mkdirSync5, rmSync as rmSync6, writeFileSync as writeFileSync7 } from "node:fs";
+import { mkdirSync as mkdirSync5, readFileSync as readFileSync9, rmSync as rmSync6, writeFileSync as writeFileSync7 } from "node:fs";
 import { dirname as dirname6, join as join11 } from "node:path";
 function announcementPath(projectPath) {
   return join11(projectPath, ".godot", "gdharness-bridge.json");
 }
+function readAnnouncement(path) {
+  try {
+    const parsed = JSON.parse(readFileSync9(path, "utf8"));
+    if (typeof parsed !== "object" || parsed === null) {
+      return null;
+    }
+    const said = parsed;
+    if (typeof said.port !== "number" || typeof said.pid !== "number") {
+      return null;
+    }
+    return said;
+  } catch {
+    return null;
+  }
+}
+function announcementIsOurs(path) {
+  return readAnnouncement(path)?.pid === process.pid;
+}
 function announceBridge(projectPath, bridge) {
   const path = announcementPath(projectPath);
   try {
@@ -30798,7 +30826,7 @@ function announceBridge(projectPath, bridge) {
   }
 }
 function withdrawBridge(path) {
-  if (path === null) {
+  if (path === null || !announcementIsOurs(path)) {
     return;
   }
   try {
@@ -34324,14 +34352,15 @@ function resolveDefaultBridgeHost() {
 function servedPort(said) {
   return typeof said === "number" && Number.isInteger(said) && said > 0 && said <= 65535 ? said : undefined;
 }
-function getDefaultBridge(mayMove = false) {
-  defaultBridge ??= new GodotBridge(resolveDefaultBridgePort(), resolveDefaultBridgeHost(), DEFAULT_TIMEOUT_MS, mayMove);
+function getDefaultBridge(ownProject = null) {
+  defaultBridge ??= new GodotBridge(resolveDefaultBridgePort(), resolveDefaultBridgeHost(), DEFAULT_TIMEOUT_MS, ownProject);
   return defaultBridge;
 }
-var DEFAULT_PORT = 6505, DEFAULT_HOST = "127.0.0.1", DEFAULT_TIMEOUT_MS = 30000, KEEPALIVE_INTERVAL_MS = 1e4, SECOND_CONNECTION_CLOSE_CODE = 4000, GodotBridge, defaultBridge = null;
+var DEFAULT_PORT = 6505, DEFAULT_HOST = "127.0.0.1", DEFAULT_TIMEOUT_MS = 30000, KEEPALIVE_INTERVAL_MS = 1e4, SECOND_CONNECTION_CLOSE_CODE = 4000, OTHER_PROJECT_CLOSE_CODE = 4001, GodotBridge, defaultBridge = null;
 var init_godot_bridge = __esm(() => {
   init_wrapper();
   init_errors();
+  init_paths();
   init_ports();
   GodotBridge = class GodotBridge extends EventEmitter {
     httpServer = null;
@@ -34345,13 +34374,16 @@ var init_godot_bridge = __esm(() => {
     boundPort = null;
     host;
     timeoutMs;
-    mayMove;
-    constructor(port = DEFAULT_PORT, host = DEFAULT_HOST, timeoutMs = DEFAULT_TIMEOUT_MS, mayMove = false) {
+    ownProject;
+    constructor(port = DEFAULT_PORT, host = DEFAULT_HOST, timeoutMs = DEFAULT_TIMEOUT_MS, ownProject = null) {
       super();
       this.wantedPort = port;
       this.host = host;
       this.timeoutMs = timeoutMs;
-      this.mayMove = mayMove;
+      this.ownProject = ownProject;
+    }
+    get mayMove() {
+      return this.ownProject !== null;
     }
     get port() {
       return this.boundPort ?? this.wantedPort;
@@ -34597,6 +34629,10 @@ var init_godot_bridge = __esm(() => {
         }
         case "godot_ready":
           if (this.connectionInfo) {
+            if (this.belongsElsewhere(message.project_path)) {
+              this.sendElsewhere(message.project_path);
+              return;
+            }
             this.connectionInfo.projectPath = message.project_path;
             this.connectionInfo.addonVersion = message.addon_version ?? "";
             this.connectionInfo.editorPid = message.editor_pid;
@@ -34679,6 +34715,21 @@ var init_godot_bridge = __esm(() => {
       clearInterval(this.pingInterval);
       this.pingInterval = null;
     }
+    belongsElsewhere(theirProject) {
+      if (this.ownProject === null || theirProject.trim() === "") {
+        return false;
+      }
+      return !isSameDirectory(this.ownProject, theirProject);
+    }
+    sendElsewhere(theirProject) {
+      const said = `this server serves ${this.ownProject ?? ""}, and that editor has ${theirProject} open`;
+      this.log("warn", `Turning away an editor from another project: ${said}`);
+      const stranger = this.socket;
+      this.socket = null;
+      this.connectionInfo = null;
+      this.stopKeepalive();
+      stranger?.close(OTHER_PROJECT_CLOSE_CODE, said);
+    }
     handleDisconnect(disconnectedSocket, reason) {
       if (disconnectedSocket && this.socket && disconnectedSocket !== this.socket) {
         this.log("debug", "Ignoring stale Godot socket disconnect event");
@@ -35603,7 +35654,7 @@ var init_lsp_client = __esm(() => {
 });
 
 // src/project-scan.ts
-import { readdirSync as readdirSync4, readFileSync as readFileSync9 } from "node:fs";
+import { readdirSync as readdirSync4, readFileSync as readFileSync10 } from "node:fs";
 import { join as join12 } from "node:path";
 function projectStructure(projectPath) {
   const structure = { scenes: 0, scripts: 0, assets: 0, other: 0 };
@@ -35666,7 +35717,7 @@ function searchProject(projectPath, options) {
       }
       result.summary.files_searched += 1;
       const matches = [];
-      for (const [index, line] of readFileSync9(entryPath, "utf8").split(`
+      for (const [index, line] of readFileSync10(entryPath, "utf8").split(`
 `).entries()) {
         if (full()) {
           break;
@@ -35694,7 +35745,7 @@ var init_project_scan = __esm(() => {
 });
 
 // src/runtime-client.ts
-import { existsSync as existsSync10, readdirSync as readdirSync5, readFileSync as readFileSync10, unlinkSync } from "node:fs";
+import { existsSync as existsSync10, readdirSync as readdirSync5, readFileSync as readFileSync11, unlinkSync } from "node:fs";
 import { createConnection as createConnection3 } from "node:net";
 import { tmpdir as tmpdir4 } from "node:os";
 import { join as join13, resolve as resolve4 } from "node:path";
@@ -35725,7 +35776,7 @@ function processAlive(pid) {
 function parseAnnouncement(file, pid) {
   let fields;
   try {
-    fields = asParams(JSON.parse(readFileSync10(file, "utf8")));
+    fields = asParams(JSON.parse(readFileSync11(file, "utf8")));
   } catch {
     return { kind: "rubbish" };
   }
@@ -35918,14 +35969,14 @@ var init_runtime_client = __esm(() => {
 });
 
 // src/setup.ts
-import { cpSync as cpSync2, existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync11, rmSync as rmSync7, writeFileSync as writeFileSync8 } from "node:fs";
+import { cpSync as cpSync2, existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync12, rmSync as rmSync7, writeFileSync as writeFileSync8 } from "node:fs";
 import { dirname as dirname8, join as join14 } from "node:path";
 function installedAddonVersion(projectPath) {
   const marker = join14(projectPath, "addons", ADDONS2[0], VERSION_MARKER2);
   if (!existsSync11(marker)) {
     return null;
   }
-  const said = readFileSync11(marker, "utf8").trim();
+  const said = readFileSync12(marker, "utf8").trim();
   return said === "" ? null : said;
 }
 var ADDONS2, VERSION_MARKER2 = ".gdharness-version";
@@ -35939,7 +35990,7 @@ var init_setup = __esm(() => {
 
 // src/server.ts
 import { execFile as execFile5, spawn } from "node:child_process";
-import { existsSync as existsSync12, mkdtempSync as mkdtempSync3, readdirSync as readdirSync6, readFileSync as readFileSync12, realpathSync as realpathSync2, rmSync as rmSync8 } from "node:fs";
+import { existsSync as existsSync12, mkdtempSync as mkdtempSync3, readdirSync as readdirSync6, readFileSync as readFileSync13, realpathSync as realpathSync2, rmSync as rmSync8 } from "node:fs";
 import { tmpdir as tmpdir5 } from "node:os";
 import { basename as basename2, dirname as dirname9, join as join15, normalize as normalize3 } from "node:path";
 import { setTimeout as delay2 } from "node:timers/promises";
@@ -36020,11 +36071,11 @@ function aboveTheRunner(entry) {
   };
 }
 function hasMainScene(projectFile) {
-  const scene = parseProjectGodot(readFileSync12(projectFile, "utf8"))["application"]?.["run/main_scene"];
+  const scene = parseProjectGodot(readFileSync13(projectFile, "utf8"))["application"]?.["run/main_scene"];
   return typeof scene === "string" && scene !== "";
 }
 function editorPlaysHeadless(projectFile) {
-  const runArgs = parseProjectGodot(readFileSync12(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
+  const runArgs = parseProjectGodot(readFileSync13(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
   return typeof runArgs === "string" && /(?:^|\s)--headless(?:\s|$)/.test(runArgs);
 }
 function camelCased(params) {
@@ -36052,13 +36103,14 @@ class GodotServer {
   dapClient = null;
   bridgeStartupError = null;
   bridgeRetry = null;
+  successorWatch = null;
   lastProjectPath = null;
   shutdownInitiated = false;
   ownProject;
   announcedAt = null;
   constructor() {
     this.ownProject = envValue("GDHARNESS_PROJECT") ?? null;
-    this.godotBridge = getDefaultBridge(this.ownProject !== null);
+    this.godotBridge = getDefaultBridge(this.ownProject);
     this.mcp = new McpServer({ name: "gdharness", version: SERVER_VERSION }, { capabilities: { tools: {}, resources: {} } });
     this.setupToolHandlers();
     setupResourceHandlers(this.mcp, () => this.lastProjectPath);
@@ -36151,6 +36203,7 @@ class GodotServer {
       port: status.port,
       version: SERVER_VERSION
     });
+    this.watchForASuccessor();
   }
   stopTryingTheBridge() {
     if (this.bridgeRetry !== null) {
@@ -36158,9 +36211,46 @@ class GodotServer {
       this.bridgeRetry = null;
     }
   }
+  watchForASuccessor() {
+    if (this.ownProject === null || this.successorWatch !== null) {
+      return;
+    }
+    const watch = setInterval(() => {
+      const successor = this.supersededBy();
+      if (successor === null) {
+        return;
+      }
+      console.error(`[SERVER] pid ${successor} now serves ${this.ownProject}; this server is finished and is stopping.`);
+      this.handleShutdown(`superseded by ${successor}`, 0);
+    }, SUCCESSOR_CHECK_MS);
+    watch.unref();
+    this.successorWatch = watch;
+  }
+  supersededBy() {
+    if (this.ownProject === null) {
+      return null;
+    }
+    const announced = readAnnouncement(announcementPath(this.ownProject));
+    if (announced === null || announced.pid === process.pid) {
+      return null;
+    }
+    try {
+      process.kill(announced.pid, 0);
+      return announced.pid;
+    } catch {
+      return null;
+    }
+  }
+  stopWatchingForASuccessor() {
+    if (this.successorWatch !== null) {
+      clearInterval(this.successorWatch);
+      this.successorWatch = null;
+    }
+  }
   async cleanup() {
     this.logDebug("Cleaning up resources");
     this.stopTryingTheBridge();
+    this.stopWatchingForASuccessor();
     withdrawBridge(this.announcedAt);
     this.announcedAt = null;
     if (this.activeProcess) {
@@ -36742,7 +36832,7 @@ class GodotServer {
     if (!engine.ok) {
       return engine.response;
     }
-    const application = parseProjectGodot(readFileSync12(project.value.file, "utf8"))["application"] ?? {};
+    const application = parseProjectGodot(readFileSync13(project.value.file, "utf8"))["application"] ?? {};
     const name = application["config/name"];
     const mainScene = application["run/main_scene"];
     const info = {
@@ -36917,7 +37007,7 @@ class GodotServer {
       const written = existsSync12(reportsDir) ? readdirSync6(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
       const newest = written.at(-1);
       if (newest !== undefined) {
-        report = parseJUnit(readFileSync12(join15(reportsDir, newest, "results.xml"), "utf8"));
+        report = parseJUnit(readFileSync13(join15(reportsDir, newest, "results.xml"), "utf8"));
       }
     } catch (error) {
       reportProblem = errorMessage(error);
@@ -37507,7 +37597,7 @@ class GodotServer {
       return {
         content: [
           { type: "text", text: `Screenshot captured: ${dimensions}` },
-          { type: "image", data: readFileSync12(screenshotPath).toString("base64"), mimeType: "image/png" }
+          { type: "image", data: readFileSync13(screenshotPath).toString("base64"), mimeType: "image/png" }
         ]
       };
     } finally {
@@ -37573,7 +37663,7 @@ async function runGodotServer() {
   const server = new GodotServer;
   await server.run();
 }
-var UPDATE_NOTICE_EVERY = 500, FEEDBACK_NOTICE_EVERY = 250, run5, __dirname2, EDITOR_RESTART_TIMEOUT_MS = 90000, SLOWEST_FRAME_RATE = 20, VALUE_NAMES, BRIDGE_RETRY_MS = 2000, PATH_SOLUTIONS, PROJECT_FILE_ARGUMENTS, DEBUG_STATE_CALLS, HEADLESS_OPERATIONS, PROJECT_INFO_SECTIONS, RUNNER_DIRECTORY = "addons/gdUnit4/";
+var UPDATE_NOTICE_EVERY = 500, FEEDBACK_NOTICE_EVERY = 250, run5, __dirname2, EDITOR_RESTART_TIMEOUT_MS = 90000, SLOWEST_FRAME_RATE = 20, VALUE_NAMES, BRIDGE_RETRY_MS = 2000, SUCCESSOR_CHECK_MS = 1e4, PATH_SOLUTIONS, PROJECT_FILE_ARGUMENTS, DEBUG_STATE_CALLS, HEADLESS_OPERATIONS, PROJECT_INFO_SECTIONS, RUNNER_DIRECTORY = "addons/gdUnit4/";
 var init_server3 = __esm(() => {
   init_mcp();
   init_stdio2();

package/build/godot/addons/gdharness_editor/bridge_client.gd

@@ -18,6 +18,10 @@ const ANNOUNCE_PROTOCOL: int = 1
 const RECONNECT_DELAY: float = 3.0
 const MAX_RECONNECT_DELAY: float = 30.0
 
+## What a server closes with when the editor that said hello belongs to another project. Kept in
+## step with `OTHER_PROJECT_CLOSE_CODE` in src/godot-bridge.ts.
+const ELSEWHERE_CLOSE_CODE: int = 4001
+
 ## Where Godot keeps the three ports an editor serves. None of them is per editor: the settings
 ## file is one for every editor on the machine, so two open at once want the same three and the
 ## second one binds nothing.
@@ -67,6 +71,10 @@ var _since_looked: float = 0.0
 ## anything connects or the project names a different one.
 var _refused_url: String = ""
 var _tried_announced: bool = false
+
+## The address this editor has already been told is another project's, so a reconnect loop says it
+## once rather than every few seconds for the rest of the session.
+var _told_about_url: String = ""
 var _connecting_for: float = 0.0
 
 
@@ -343,12 +351,35 @@ func _loaded_version() -> String:
 
 func _handle_disconnect() -> void:
 	_is_connected = false
+	_said_elsewhere()
 	disconnected.emit()
 
 	if _should_reconnect:
 		_schedule_reconnect()
 
 
+## Says so when the server turned this editor away as another project's.
+##
+## The fallback address is tried by every project whose own server has not run yet and so has
+## announced nothing, which means any server holding it took the connection and served it. It is
+## refused now, and the refusal is worth a person's attention rather than a quiet backoff: nothing
+## about waiting reaches a server that is not this project's, and the answer is to start one.
+##
+## Said once per address. This is a reconnect loop, and a line every few seconds for the rest of
+## the session is a line nobody reads.
+func _said_elsewhere() -> void:
+	if socket.get_close_code() != ELSEWHERE_CLOSE_CODE:
+		return
+	if _told_about_url == server_url:
+		return
+	_told_about_url = server_url
+	var said: String = (
+		"[gdharness] %s is another project's server, so this editor is not connected: %s."
+		+ " Start this project's own server, or point it at one with GDHARNESS_BRIDGE_PORT."
+	)
+	push_warning(said % [server_url, socket.get_close_reason()])
+
+
 func _schedule_reconnect() -> void:
 	if _reconnect_timer == null:
 		return

package/build/godot/addons/gdharness_runtime/runtime_capture.gd

@@ -2,6 +2,8 @@ extends RefCounted
 
 ## A picture of the running game, as a PNG written where the server asked for it.
 
+const Values = preload("runtime_values.gd")
+
 var _host: Node
 
 
@@ -18,9 +20,10 @@ func capture_viewport(params: Dictionary) -> Dictionary:
 	if viewport_path.is_empty():
 		return capture_screenshot(params)
 
-	var node: Node = _host.get_tree().root.get_node_or_null(viewport_path)
-	if node == null:
-		return {"type": "error", "message": "Viewport not found: " + viewport_path}
+	var standing: Dictionary = Values.node_at(_host.get_tree().root, viewport_path)
+	if standing.has("message"):
+		return standing
+	var node: Node = standing["node"]
 	if not node is Viewport:
 		return {"type": "error", "message": "Node is not a Viewport: " + viewport_path}
 	return _capture(node, params)

package/build/godot/addons/gdharness_runtime/runtime_input.gd

@@ -440,9 +440,10 @@ func click(params: Dictionary) -> Dictionary:
 	if node_path.is_empty():
 		return {"type": "error", "message": "Node path required"}
 
-	var node: Node = _host.get_tree().root.get_node_or_null(node_path)
-	if node == null:
-		return {"type": "error", "message": "Node not found: " + node_path}
+	var standing: Dictionary = Values.node_at(_host.get_tree().root, node_path)
+	if standing.has("message"):
+		return standing
+	var node: Node = standing["node"]
 	if node is Node3D:
 		return await _click_in_the_world(node_path, node, params)
 	if not node is Control:
@@ -580,9 +581,10 @@ func choose(params: Dictionary) -> Dictionary:
 	var node_path: String = str(params.get("path", ""))
 	if node_path.is_empty():
 		return {"type": "error", "message": "Node path required"}
-	var node: Node = _host.get_tree().root.get_node_or_null(node_path)
-	if node == null:
-		return {"type": "error", "message": "Node not found: " + node_path}
+	var standing: Dictionary = Values.node_at(_host.get_tree().root, node_path)
+	if standing.has("message"):
+		return standing
+	var node: Node = standing["node"]
 
 	var menu: PopupMenu = _menu_of(node)
 	if menu == null:

package/build/godot/addons/gdharness_runtime/runtime_queries.gd

@@ -34,9 +34,10 @@ func get_tree(params: Dictionary) -> Dictionary:
 	var max_depth: int = int(params.get("depth", 3))
 	var include_properties: bool = bool(params.get("include_properties", false))
 
-	var root: Node = _host.get_tree().root.get_node_or_null(root_path)
-	if root == null:
-		return {"type": "error", "message": "Node not found: " + root_path}
+	var reached: Dictionary = Values.node_at(_host.get_tree().root, root_path)
+	if reached.has("message"):
+		return reached
+	var root: Node = reached["node"]
 
 	return {"type": "tree", "root": _serialize_node_tree(root, 0, max_depth, include_properties)}
 
@@ -64,9 +65,10 @@ func find_nodes(params: Dictionary) -> Dictionary:
 	if not wanted["script"].is_empty() and not wanted["script"].begins_with("res://"):
 		wanted["script"] = "res://" + wanted["script"]
 
-	var root: Node = _host.get_tree().root.get_node_or_null(root_path)
-	if root == null:
-		return {"type": "error", "message": "Node not found: " + root_path}
+	var reached: Dictionary = Values.node_at(_host.get_tree().root, root_path)
+	if reached.has("message"):
+		return reached
+	var root: Node = reached["node"]
 
 	var found: Array[Dictionary] = []
 	var pending: Array[Node] = [root]
@@ -128,7 +130,7 @@ func _found(node: Node, wanted_property: String) -> Dictionary:
 		entry["has_property"] = false
 		return entry
 	var holder: Object = reached["holder"]
-	var named: String = reached["property"]
+	var named: String = reached["name"]
 	var has: bool = _has_property(holder, named)
 	entry["has_property"] = has
 	if has:
@@ -208,9 +210,10 @@ func read_text(params: Dictionary) -> Dictionary:
 	var include_hidden: bool = bool(params.get("include_hidden", false))
 	var limit: int = clampi(int(params.get("limit", READ_LIMIT)), 1, READ_LIMIT)
 
-	var root: Node = _host.get_tree().root.get_node_or_null(root_path)
-	if root == null:
-		return {"type": "error", "message": "Node not found: " + root_path}
+	var reached: Dictionary = Values.node_at(_host.get_tree().root, root_path)
+	if reached.has("message"):
+		return reached
+	var root: Node = reached["node"]
 
 	# One line further than asked for, so that whether anything was left behind is read off the
 	# walk rather than guessed at from the count: a panel of exactly as many lines as the caller
@@ -275,9 +278,10 @@ func get_rect(params: Dictionary) -> Dictionary:
 	if node_path.is_empty():
 		return {"type": "error", "message": "Node path required"}
 
-	var node: Node = _host.get_tree().root.get_node_or_null(node_path)
-	if node == null:
-		return {"type": "error", "message": "Node not found: " + node_path}
+	var standing: Dictionary = Values.node_at(_host.get_tree().root, node_path)
+	if standing.has("message"):
+		return standing
+	var node: Node = standing["node"]
 
 	if node is Control:
 		var control: Control = node
@@ -426,16 +430,17 @@ func get_property(params: Dictionary) -> Dictionary:
 	if node_path.is_empty() or property.is_empty():
 		return {"type": "error", "message": "Node path and property required"}
 
-	var node: Node = _host.get_tree().root.get_node_or_null(node_path)
-	if node == null:
-		return {"type": "error", "message": "Node not found: " + node_path}
+	var standing: Dictionary = Values.node_at(_host.get_tree().root, node_path)
+	if standing.has("message"):
+		return standing
+	var node: Node = standing["node"]
 
 	var reached: Dictionary = _reached(node, node_path, property)
 	if reached.has("message"):
 		return reached
 
 	var holder: Object = reached["holder"]
-	var named: String = reached["property"]
+	var named: String = reached["name"]
 	# Asked of the property list rather than read and compared to null, because a property the
 	# holder does not have and a property that is null both read as null.
 	if not _has_property(holder, named):
@@ -449,11 +454,14 @@ func get_property(params: Dictionary) -> Dictionary:
 	}
 
 
-## What [param property] is a property of, which is the node itself until the name has a colon in
-## it, and the last name along that path.
+## What [param reaching] names something on, which is the node itself until the name has a colon
+## in it, and the last name along that path.
 ##
 ## A game's state does not sit on nodes, it hangs off them: the speed of the clock is a property of
 ## a [RefCounted] held by a [RefCounted] held by the root, and that is what an agent asks about.
+## What a game does hangs off them the same way, so the last name is a property to read, a property
+## to write or a method to call, and the walk to it is one walk.
+##
 ## Colons, because that is the separator [method Object.get_indexed] already takes. Walked a step
 ## at a time rather than handed to that method, which answers null for a path that goes wrong
 ## halfway along and for one that ends on null.
@@ -461,8 +469,8 @@ func get_property(params: Dictionary) -> Dictionary:
 ## Answers with a `message` instead when a step along the way is not there or holds something that
 ## is not an object, naming the step rather than the whole path: "/root/Main:_game has no property
 ## clocks" is a typo found, and "no property _game:clocks:speed" is a puzzle.
-func _reached(node: Node, node_path: String, property: String) -> Dictionary:
-	var parts: PackedStringArray = property.split(":")
+func _reached(node: Node, node_path: String, reaching: String) -> Dictionary:
+	var parts: PackedStringArray = reaching.split(":")
 	var holder: Object = node
 	var called: String = node_path
 	for step: int in parts.size() - 1:
@@ -475,7 +483,7 @@ func _reached(node: Node, node_path: String, property: String) -> Dictionary:
 			var wanted: String = parts[step + 1]
 			return {"type": "error", "message": "%s holds no object to read %s off" % [called, wanted]}
 		holder = next
-	return {"holder": holder, "property": parts[parts.size() - 1], "called": called}
+	return {"holder": holder, "name": parts[parts.size() - 1], "called": called}
 
 
 ## Whether [param holder] declares [param named]. Its own function because three ops ask it and a
@@ -495,9 +503,10 @@ func set_property(params: Dictionary) -> Dictionary:
 	if node_path.is_empty() or property.is_empty():
 		return {"type": "error", "message": "Node path and property required"}
 
-	var node: Node = _host.get_tree().root.get_node_or_null(node_path)
-	if node == null:
-		return {"type": "error", "message": "Node not found: " + node_path}
+	var standing: Dictionary = Values.node_at(_host.get_tree().root, node_path)
+	if standing.has("message"):
+		return standing
+	var node: Node = standing["node"]
 
 	# Through a path as well, for the reason [method _reached] gives, and read back off the same
 	# holder afterwards: a set that does not take says so by answering with the old value, which is
@@ -507,7 +516,7 @@ func set_property(params: Dictionary) -> Dictionary:
 		return reached
 
 	var holder: Object = reached["holder"]
-	var named: String = reached["property"]
+	var named: String = reached["name"]
 	var old_value: Variant = holder.get(named)
 	holder.set(named, _values.fitted(value, typeof(old_value)))
 
@@ -528,18 +537,28 @@ func call_method(params: Dictionary) -> Dictionary:
 	if node_path.is_empty() or method.is_empty():
 		return {"type": "error", "message": "Node path and method required"}
 
-	var node: Node = _host.get_tree().root.get_node_or_null(node_path)
-	if node == null:
-		return {"type": "error", "message": "Node not found: " + node_path}
+	var standing: Dictionary = Values.node_at(_host.get_tree().root, node_path)
+	if standing.has("message"):
+		return standing
+	var node: Node = standing["node"]
 
-	if not node.has_method(method):
-		return {"type": "error", "message": "Method not found: " + method}
+	# Through a path as well, for the reason [method _reached] gives. What a game does hangs off its
+	# nodes as much as its state does, so reading `_game:run:day` while being unable to call
+	# `_game:run:advance` answers half of what a node holds and refuses the other half.
+	var reached: Dictionary = _reached(node, node_path, method)
+	if reached.has("message"):
+		return reached
+
+	var holder: Object = reached["holder"]
+	var named: String = reached["name"]
+	if not holder.has_method(named):
+		return {"type": "error", "message": "%s has no method %s" % [reached["called"], named]}
 
 	var deserialized_args: Array = []
 	for index: int in args.size():
-		deserialized_args.append(_values.fitted(args[index], _values.parameter_type(node, method, index)))
+		deserialized_args.append(_values.fitted(args[index], _values.parameter_type(holder, named, index)))
 
-	var result: Variant = node.callv(method, deserialized_args)
+	var result: Variant = holder.callv(named, deserialized_args)
 
 	return {"type": "method_result", "path": node_path, "method": method, "result": _values.serialize(result)}
 

package/build/godot/addons/gdharness_runtime/runtime_values.gd

@@ -42,6 +42,37 @@ func serialize(value: Variant) -> Variant:
 	return call(serialiser, value) if not serialiser.is_empty() else value
 
 
+## The node [param path] names under [param root], or a refusal saying why there is not one.
+##
+## The other direction of what a node serialises as, and here for that reason: a node crosses the
+## wire as its path, so a path crossing back is a node or it is nothing. One answer for every op,
+## because each of them read a path for itself and they could disagree about what one means.
+##
+## A colon is the disagreement worth its own sentence. Godot reads everything after the first one
+## as subnames and [method Node.get_node_or_null] drops them, so "/root/Main:_game:run" was quietly
+## answered about "/root/Main", and an op that then said the path had no method `advance` was right
+## about an object nobody had asked for. Colons reach through what a node holds, and the arguments
+## that take them are the property and the method.
+static func node_at(root: Node, path: String) -> Dictionary:
+	if path.is_empty():
+		return {"type": "error", "message": "Node path required"}
+
+	if path.contains(":"):
+		var shape: String = (
+			'"%s" names a node and colons reach past one: "%s" is the node,'
+			+ ' and "%s" goes in the property or the method'
+		)
+		return {
+			"type": "error",
+			"message": shape % [path, path.get_slice(":", 0), path.substr(path.find(":") + 1)],
+		}
+
+	var node: Node = root.get_node_or_null(path)
+	if node == null:
+		return {"type": "error", "message": "Node not found: " + path}
+	return {"node": node}
+
+
 func _serialize_nil(_value: Variant) -> Variant:
 	return null
 

package/build/godot/addons/gdharness_runtime/runtime_waits.gd

@@ -53,9 +53,10 @@ func wait_signal(params: Dictionary) -> Dictionary:
 	if node_path.is_empty() or signal_name.is_empty():
 		return {"type": "error", "message": "Node path and signal name required"}
 
-	var node: Node = _host.get_tree().root.get_node_or_null(node_path)
-	if node == null:
-		return {"type": "error", "message": "Node not found: " + node_path}
+	var standing: Dictionary = Values.node_at(_host.get_tree().root, node_path)
+	if standing.has("message"):
+		return standing
+	var node: Node = standing["node"]
 	if not node.has_signal(signal_name):
 		return {"type": "error", "message": "%s has no signal %s" % [node_path, signal_name]}
 
@@ -90,8 +91,9 @@ func wait_until(params: Dictionary) -> Dictionary:
 		return _out_of_range("timeout_ms", timeout_ms, 1, CEILING_MSEC)
 	if node_path.is_empty():
 		return {"type": "error", "message": "Node path required"}
-	if _host.get_tree().root.get_node_or_null(node_path) == null:
-		return {"type": "error", "message": "Node not found: " + node_path}
+	var standing: Dictionary = Values.node_at(_host.get_tree().root, node_path)
+	if standing.has("message"):
+		return standing
 	if not says.is_empty():
 		return await _wait_until_said(node_path, says, timeout_ms)
 	if property.is_empty():
@@ -99,7 +101,7 @@ func wait_until(params: Dictionary) -> Dictionary:
 	if not params.has("value"):
 		return {"type": "error", "message": "A value to wait for is required"}
 
-	var node: Node = _host.get_tree().root.get_node_or_null(node_path)
+	var node: Node = standing["node"]
 
 	var current: Variant = node.get(property)
 	var wanted: Variant = _values.fitted(params["value"], typeof(current))

package/build/index.js

@@ -10126,7 +10126,7 @@ function defectReport(where, error, godotVersion) {
 
 // src/server.ts
 import { execFile as execFile3, spawn } from "node:child_process";
-import { existsSync as existsSync7, mkdtempSync as mkdtempSync2, readdirSync as readdirSync5, readFileSync as readFileSync8, realpathSync as realpathSync2, rmSync as rmSync4 } from "node:fs";
+import { existsSync as existsSync7, mkdtempSync as mkdtempSync2, readdirSync as readdirSync5, readFileSync as readFileSync9, realpathSync as realpathSync2, rmSync as rmSync4 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
 import { basename, dirname as dirname4, join as join9, normalize as normalize2 } from "node:path";
 import { setTimeout as delay2 } from "node:timers/promises";
@@ -24697,12 +24697,30 @@ class StdioServerTransport {
 }
 
 // src/bridge-announce.ts
-import { mkdirSync as mkdirSync2, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync3, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { dirname, join as join2 } from "node:path";
 function announcementPath(projectPath) {
   return join2(projectPath, ".godot", "gdharness-bridge.json");
 }
 var BRIDGE_ANNOUNCE_PROTOCOL = 1;
+function readAnnouncement(path) {
+  try {
+    const parsed = JSON.parse(readFileSync3(path, "utf8"));
+    if (typeof parsed !== "object" || parsed === null) {
+      return null;
+    }
+    const said = parsed;
+    if (typeof said.port !== "number" || typeof said.pid !== "number") {
+      return null;
+    }
+    return said;
+  } catch {
+    return null;
+  }
+}
+function announcementIsOurs(path) {
+  return readAnnouncement(path)?.pid === process.pid;
+}
 function announceBridge(projectPath, bridge) {
   const path = announcementPath(projectPath);
   try {
@@ -24724,7 +24742,7 @@ function announceBridge(projectPath, bridge) {
   }
 }
 function withdrawBridge(path) {
-  if (path === null) {
+  if (path === null || !announcementIsOurs(path)) {
     return;
   }
   try {
@@ -24735,7 +24753,7 @@ function withdrawBridge(path) {
 }
 
 // src/class-cache.ts
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync4 } from "node:fs";
 import { join as join3 } from "node:path";
 function declaredClasses(projectPath) {
   const declared = new Map;
@@ -24748,7 +24766,7 @@ function declaredClasses(projectPath) {
       if (entry.isDirectory()) {
         visit(path, `${prefix}${entry.name}/`);
       } else if (entry.isFile() && entry.name.endsWith(".gd")) {
-        const found = /^class_name\s+([A-Za-z_][A-Za-z0-9_]*)/m.exec(readFileSync3(path, "utf8"));
+        const found = /^class_name\s+([A-Za-z_][A-Za-z0-9_]*)/m.exec(readFileSync4(path, "utf8"));
         if (found?.[1]) {
           declared.set(found[1], `res://${prefix}${entry.name}`);
         }
@@ -24764,7 +24782,7 @@ function cachedClasses(projectPath) {
     return null;
   }
   const listed = new Map;
-  const text = readFileSync3(cache, "utf8");
+  const text = readFileSync4(cache, "utf8");
   for (const entry of text.matchAll(/"class":\s*&"([^"]+)"[\s\S]*?"path":\s*"([^"]+)"/g)) {
     listed.set(entry[1] ?? "", entry[2] ?? "");
   }
@@ -25494,12 +25512,64 @@ var import_subprotocol = __toESM(require_subprotocol(), 1);
 var import_websocket = __toESM(require_websocket(), 1);
 var import_websocket_server = __toESM(require_websocket_server(), 1);
 
+// src/paths.ts
+import { isAbsolute, relative, resolve, sep } from "node:path";
+var RESOURCE_SCHEME = "res://";
+var OTHER_SCHEME = /^[a-zA-Z][a-zA-Z\d+.-]+:\/\//;
+function isSameDirectory(onePath, otherPath) {
+  return relative(resolve(onePath), resolve(otherPath)) === "";
+}
+function isWithinRoot(rootPath, candidatePath) {
+  const step = relative(resolve(rootPath), resolve(candidatePath));
+  return step !== ".." && !step.startsWith(`..${sep}`) && !isAbsolute(step);
+}
+function resolveWithinProject(projectPath, candidatePath) {
+  const trimmed = candidatePath.trim();
+  if (trimmed === "") {
+    return { ok: false, reason: "Path is empty." };
+  }
+  if (trimmed.includes("\x00")) {
+    return { ok: false, reason: "Path contains a null byte." };
+  }
+  const withoutScheme = trimmed.startsWith(RESOURCE_SCHEME) ? trimmed.slice(RESOURCE_SCHEME.length) : trimmed;
+  const scheme = OTHER_SCHEME.exec(withoutScheme);
+  if (scheme) {
+    return {
+      ok: false,
+      reason: `Path '${trimmed}' uses the '${scheme[0]}' scheme, which names somewhere other than this project.`
+    };
+  }
+  if (withoutScheme.startsWith("/") || withoutScheme.startsWith("\\") || isAbsolute(withoutScheme)) {
+    return {
+      ok: false,
+      reason: `Path '${trimmed}' is absolute; give a path inside the project, such as 'scenes/main.tscn'.`
+    };
+  }
+  if (withoutScheme.includes(":")) {
+    return {
+      ok: false,
+      reason: `Path '${trimmed}' contains ':', which no file inside a project is named with.`
+    };
+  }
+  const root = resolve(projectPath);
+  const absolutePath = resolve(root, withoutScheme);
+  if (!isWithinRoot(root, absolutePath)) {
+    return { ok: false, reason: `Path '${trimmed}' resolves outside the project directory.` };
+  }
+  const relativePath = relative(root, absolutePath).split(sep).join("/");
+  if (relativePath === "") {
+    return { ok: false, reason: `Path '${trimmed}' is the project directory itself, not a file in it.` };
+  }
+  return { ok: true, absolutePath, relativePath };
+}
+
 // src/godot-bridge.ts
 var DEFAULT_PORT = 6505;
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_TIMEOUT_MS = 30000;
 var KEEPALIVE_INTERVAL_MS = 1e4;
 var SECOND_CONNECTION_CLOSE_CODE = 4000;
+var OTHER_PROJECT_CLOSE_CODE = 4001;
 function resolveDefaultBridgePort() {
   return portFromEnv("GDHARNESS_BRIDGE_PORT", DEFAULT_PORT);
 }
@@ -25523,13 +25593,16 @@ class GodotBridge extends EventEmitter {
   boundPort = null;
   host;
   timeoutMs;
-  mayMove;
-  constructor(port = DEFAULT_PORT, host = DEFAULT_HOST, timeoutMs = DEFAULT_TIMEOUT_MS, mayMove = false) {
+  ownProject;
+  constructor(port = DEFAULT_PORT, host = DEFAULT_HOST, timeoutMs = DEFAULT_TIMEOUT_MS, ownProject = null) {
     super();
     this.wantedPort = port;
     this.host = host;
     this.timeoutMs = timeoutMs;
-    this.mayMove = mayMove;
+    this.ownProject = ownProject;
+  }
+  get mayMove() {
+    return this.ownProject !== null;
   }
   get port() {
     return this.boundPort ?? this.wantedPort;
@@ -25775,6 +25848,10 @@ class GodotBridge extends EventEmitter {
       }
       case "godot_ready":
         if (this.connectionInfo) {
+          if (this.belongsElsewhere(message.project_path)) {
+            this.sendElsewhere(message.project_path);
+            return;
+          }
           this.connectionInfo.projectPath = message.project_path;
           this.connectionInfo.addonVersion = message.addon_version ?? "";
           this.connectionInfo.editorPid = message.editor_pid;
@@ -25857,6 +25934,21 @@ class GodotBridge extends EventEmitter {
     clearInterval(this.pingInterval);
     this.pingInterval = null;
   }
+  belongsElsewhere(theirProject) {
+    if (this.ownProject === null || theirProject.trim() === "") {
+      return false;
+    }
+    return !isSameDirectory(this.ownProject, theirProject);
+  }
+  sendElsewhere(theirProject) {
+    const said = `this server serves ${this.ownProject ?? ""}, and that editor has ${theirProject} open`;
+    this.log("warn", `Turning away an editor from another project: ${said}`);
+    const stranger = this.socket;
+    this.socket = null;
+    this.connectionInfo = null;
+    this.stopKeepalive();
+    stranger?.close(OTHER_PROJECT_CLOSE_CODE, said);
+  }
   handleDisconnect(disconnectedSocket, reason) {
     if (disconnectedSocket && this.socket && disconnectedSocket !== this.socket) {
       this.log("debug", "Ignoring stale Godot socket disconnect event");
@@ -25933,8 +26025,8 @@ class GodotBridge extends EventEmitter {
   }
 }
 var defaultBridge = null;
-function getDefaultBridge(mayMove = false) {
-  defaultBridge ??= new GodotBridge(resolveDefaultBridgePort(), resolveDefaultBridgeHost(), DEFAULT_TIMEOUT_MS, mayMove);
+function getDefaultBridge(ownProject = null) {
+  defaultBridge ??= new GodotBridge(resolveDefaultBridgePort(), resolveDefaultBridgeHost(), DEFAULT_TIMEOUT_MS, ownProject);
   return defaultBridge;
 }
 
@@ -26495,56 +26587,6 @@ import { readFile, realpath } from "node:fs/promises";
 import { createConnection as createConnection2 } from "node:net";
 import { dirname as dirname2, resolve as resolve2 } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-
-// src/paths.ts
-import { isAbsolute, relative, resolve, sep } from "node:path";
-var RESOURCE_SCHEME = "res://";
-var OTHER_SCHEME = /^[a-zA-Z][a-zA-Z\d+.-]+:\/\//;
-function isWithinRoot(rootPath, candidatePath) {
-  const step = relative(resolve(rootPath), resolve(candidatePath));
-  return step !== ".." && !step.startsWith(`..${sep}`) && !isAbsolute(step);
-}
-function resolveWithinProject(projectPath, candidatePath) {
-  const trimmed = candidatePath.trim();
-  if (trimmed === "") {
-    return { ok: false, reason: "Path is empty." };
-  }
-  if (trimmed.includes("\x00")) {
-    return { ok: false, reason: "Path contains a null byte." };
-  }
-  const withoutScheme = trimmed.startsWith(RESOURCE_SCHEME) ? trimmed.slice(RESOURCE_SCHEME.length) : trimmed;
-  const scheme = OTHER_SCHEME.exec(withoutScheme);
-  if (scheme) {
-    return {
-      ok: false,
-      reason: `Path '${trimmed}' uses the '${scheme[0]}' scheme, which names somewhere other than this project.`
-    };
-  }
-  if (withoutScheme.startsWith("/") || withoutScheme.startsWith("\\") || isAbsolute(withoutScheme)) {
-    return {
-      ok: false,
-      reason: `Path '${trimmed}' is absolute; give a path inside the project, such as 'scenes/main.tscn'.`
-    };
-  }
-  if (withoutScheme.includes(":")) {
-    return {
-      ok: false,
-      reason: `Path '${trimmed}' contains ':', which no file inside a project is named with.`
-    };
-  }
-  const root = resolve(projectPath);
-  const absolutePath = resolve(root, withoutScheme);
-  if (!isWithinRoot(root, absolutePath)) {
-    return { ok: false, reason: `Path '${trimmed}' resolves outside the project directory.` };
-  }
-  const relativePath = relative(root, absolutePath).split(sep).join("/");
-  if (relativePath === "") {
-    return { ok: false, reason: `Path '${trimmed}' is the project directory itself, not a file in it.` };
-  }
-  return { ok: true, absolutePath, relativePath };
-}
-
-// src/lsp_client.ts
 var DEFAULT_LSP_PORT = 6005;
 var DIAGNOSTICS_TIMEOUT_MS = 5000;
 function diagnosticsKey(uri) {
@@ -27038,7 +27080,7 @@ async function handleLSPTool(client, toolName, args) {
 }
 
 // src/project-scan.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync4 } from "node:fs";
+import { readdirSync as readdirSync3, readFileSync as readFileSync5 } from "node:fs";
 import { join as join6 } from "node:path";
 var SKIPPED = new Set([".git", ".godot", ".import", "node_modules"]);
 var ASSET_EXTENSIONS = new Set(["png", "jpg", "jpeg", "webp", "svg", "ttf", "otf", "wav", "mp3", "ogg"]);
@@ -27103,7 +27145,7 @@ function searchProject(projectPath, options) {
       }
       result.summary.files_searched += 1;
       const matches = [];
-      for (const [index, line] of readFileSync4(entryPath, "utf8").split(`
+      for (const [index, line] of readFileSync5(entryPath, "utf8").split(`
 `).entries()) {
         if (full()) {
           break;
@@ -27126,7 +27168,7 @@ function searchProject(projectPath, options) {
 }
 
 // src/resources.ts
-import { readFileSync as readFileSync5 } from "node:fs";
+import { readFileSync as readFileSync6 } from "node:fs";
 import { extname, resolve as resolve3 } from "node:path";
 var STATIC_RESOURCES = [
   {
@@ -27297,7 +27339,7 @@ function readResourceText(uri, getProjectPath) {
   const parsedUri = parseGodotUri(uri);
   if (parsedUri.kind === "project-info") {
     const projectFilePath = resolveProjectFile(projectPath, "project.godot");
-    const rawProject = readFileSync5(projectFilePath, "utf-8");
+    const rawProject = readFileSync6(projectFilePath, "utf-8");
     const parsedProject = parseProjectGodot(rawProject);
     return {
       mimeType: "application/json",
@@ -27306,7 +27348,7 @@ function readResourceText(uri, getProjectPath) {
   }
   const filePath = resolveProjectFile(projectPath, parsedUri.resourcePath);
   ensureAllowedExtension(parsedUri.kind, filePath);
-  const text = readFileSync5(filePath, "utf-8");
+  const text = readFileSync6(filePath, "utf-8");
   return {
     mimeType: parsedUri.kind === "script" ? "text/x-gdscript" : "text/plain",
     text
@@ -27343,7 +27385,7 @@ function setupResourceHandlers(mcp, getProjectPath) {
 }
 
 // src/runtime-client.ts
-import { existsSync as existsSync5, readdirSync as readdirSync4, readFileSync as readFileSync6, unlinkSync } from "node:fs";
+import { existsSync as existsSync5, readdirSync as readdirSync4, readFileSync as readFileSync7, unlinkSync } from "node:fs";
 import { createConnection as createConnection3 } from "node:net";
 import { tmpdir as tmpdir3 } from "node:os";
 import { join as join7, resolve as resolve4 } from "node:path";
@@ -27429,7 +27471,7 @@ function processAlive(pid) {
 function parseAnnouncement(file, pid) {
   let fields;
   try {
-    fields = asParams(JSON.parse(readFileSync6(file, "utf8")));
+    fields = asParams(JSON.parse(readFileSync7(file, "utf8")));
   } catch {
     return { kind: "rubbish" };
   }
@@ -27619,7 +27661,7 @@ function runtimeRequest(endpoint, command, params, timeoutMs) {
 }
 
 // src/setup.ts
-import { cpSync, existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync7, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "node:fs";
+import { cpSync, existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync8, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "node:fs";
 import { dirname as dirname3, join as join8 } from "node:path";
 var ADDONS = ["gdharness_editor", "gdharness_runtime", "auto_reload"];
 var VERSION_MARKER = ".gdharness-version";
@@ -27628,7 +27670,7 @@ function installedAddonVersion(projectPath) {
   if (!existsSync6(marker)) {
     return null;
   }
-  const said = readFileSync7(marker, "utf8").trim();
+  const said = readFileSync8(marker, "utf8").trim();
   return said === "" ? null : said;
 }
 
@@ -28398,7 +28440,11 @@ var TOOL_SPECS = [
         blank: true,
         description: `set: the value, fitted to the property's type. "" writes an empty string.`
       },
-      method: { type: "string", ops: ["call"] },
+      method: {
+        type: "string",
+        ops: ["call"],
+        description: 'call: which one to call. Colons call through the objects a node holds, "_game:run:advance", the same way a property is written through them.'
+      },
       args: {
         type: "array",
         ops: ["call"],
@@ -28411,7 +28457,10 @@ var TOOL_SPECS = [
         summary: "set a property, on a node or on an object it holds",
         requires: ["property", "value"]
       },
-      call: { summary: "call a method and return its result", requires: ["method"] }
+      call: {
+        summary: "call a method, on a node or on an object it holds, and return its result",
+        requires: ["method"]
+      }
     }
   },
   {
@@ -28714,6 +28763,7 @@ function wrongTypes(spec, args) {
   return complaints;
 }
 var BRIDGE_RETRY_MS = 2000;
+var SUCCESSOR_CHECK_MS = 1e4;
 var PATH_SOLUTIONS = [
   'Give the path relative to the project, such as "scenes/main.tscn" or "res://scenes/main.tscn"',
   "Point projectPath at the project the file belongs to"
@@ -28801,11 +28851,11 @@ function aboveTheRunner(entry) {
   };
 }
 function hasMainScene(projectFile) {
-  const scene = parseProjectGodot(readFileSync8(projectFile, "utf8"))["application"]?.["run/main_scene"];
+  const scene = parseProjectGodot(readFileSync9(projectFile, "utf8"))["application"]?.["run/main_scene"];
   return typeof scene === "string" && scene !== "";
 }
 function editorPlaysHeadless(projectFile) {
-  const runArgs = parseProjectGodot(readFileSync8(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
+  const runArgs = parseProjectGodot(readFileSync9(projectFile, "utf8"))["editor"]?.["run/main_run_args"];
   return typeof runArgs === "string" && /(?:^|\s)--headless(?:\s|$)/.test(runArgs);
 }
 function camelCased(params) {
@@ -28833,13 +28883,14 @@ class GodotServer {
   dapClient = null;
   bridgeStartupError = null;
   bridgeRetry = null;
+  successorWatch = null;
   lastProjectPath = null;
   shutdownInitiated = false;
   ownProject;
   announcedAt = null;
   constructor() {
     this.ownProject = envValue("GDHARNESS_PROJECT") ?? null;
-    this.godotBridge = getDefaultBridge(this.ownProject !== null);
+    this.godotBridge = getDefaultBridge(this.ownProject);
     this.mcp = new McpServer({ name: "gdharness", version: SERVER_VERSION }, { capabilities: { tools: {}, resources: {} } });
     this.setupToolHandlers();
     setupResourceHandlers(this.mcp, () => this.lastProjectPath);
@@ -28932,6 +28983,7 @@ class GodotServer {
       port: status.port,
       version: SERVER_VERSION
     });
+    this.watchForASuccessor();
   }
   stopTryingTheBridge() {
     if (this.bridgeRetry !== null) {
@@ -28939,9 +28991,46 @@ class GodotServer {
       this.bridgeRetry = null;
     }
   }
+  watchForASuccessor() {
+    if (this.ownProject === null || this.successorWatch !== null) {
+      return;
+    }
+    const watch = setInterval(() => {
+      const successor = this.supersededBy();
+      if (successor === null) {
+        return;
+      }
+      console.error(`[SERVER] pid ${successor} now serves ${this.ownProject}; this server is finished and is stopping.`);
+      this.handleShutdown(`superseded by ${successor}`, 0);
+    }, SUCCESSOR_CHECK_MS);
+    watch.unref();
+    this.successorWatch = watch;
+  }
+  supersededBy() {
+    if (this.ownProject === null) {
+      return null;
+    }
+    const announced = readAnnouncement(announcementPath(this.ownProject));
+    if (announced === null || announced.pid === process.pid) {
+      return null;
+    }
+    try {
+      process.kill(announced.pid, 0);
+      return announced.pid;
+    } catch {
+      return null;
+    }
+  }
+  stopWatchingForASuccessor() {
+    if (this.successorWatch !== null) {
+      clearInterval(this.successorWatch);
+      this.successorWatch = null;
+    }
+  }
   async cleanup() {
     this.logDebug("Cleaning up resources");
     this.stopTryingTheBridge();
+    this.stopWatchingForASuccessor();
     withdrawBridge(this.announcedAt);
     this.announcedAt = null;
     if (this.activeProcess) {
@@ -29523,7 +29612,7 @@ class GodotServer {
     if (!engine.ok) {
       return engine.response;
     }
-    const application = parseProjectGodot(readFileSync8(project.value.file, "utf8"))["application"] ?? {};
+    const application = parseProjectGodot(readFileSync9(project.value.file, "utf8"))["application"] ?? {};
     const name = application["config/name"];
     const mainScene = application["run/main_scene"];
     const info = {
@@ -29698,7 +29787,7 @@ class GodotServer {
       const written = existsSync7(reportsDir) ? readdirSync5(reportsDir).filter((name) => name.startsWith("report_")).sort((a, b) => Number(a.slice("report_".length)) - Number(b.slice("report_".length))) : [];
       const newest = written.at(-1);
       if (newest !== undefined) {
-        report = parseJUnit(readFileSync8(join9(reportsDir, newest, "results.xml"), "utf8"));
+        report = parseJUnit(readFileSync9(join9(reportsDir, newest, "results.xml"), "utf8"));
       }
     } catch (error) {
       reportProblem = errorMessage(error);
@@ -30288,7 +30377,7 @@ class GodotServer {
       return {
         content: [
           { type: "text", text: `Screenshot captured: ${dimensions}` },
-          { type: "image", data: readFileSync8(screenshotPath).toString("base64"), mimeType: "image/png" }
+          { type: "image", data: readFileSync9(screenshotPath).toString("base64"), mimeType: "image/png" }
         ]
       };
     } finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdharness",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "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",