gdharness 0.12.13 → 0.12.15

package/build/cli.js

@@ -15759,7 +15759,7 @@ var init_tool_definitions = __esm(() => {
     },
     {
       name: "editor_status",
-      description: "Whether the editor addon is connected, which Godot answers, whether the editor is playing something, and whether a game with the runtime addon is reachable.",
+      description: 'Whether the editor addon is connected, which Godot answers, whether the editor is playing something, and whether a game with the runtime addon is reachable. When connected is false, mayYetConnect says whether that is final: the editor dials this server rather than the other way round and backs off between tries, so for the first half-minute after a server starts, false means "not reached yet" as often as it means "no editor". True is worth waiting out; false is an editor that is not there. listeningSince is when this server took the bridge port, which is what that window is measured from and what a caller wanting its own window should read.',
       parameters: {},
       requires: []
     },
@@ -34405,17 +34405,21 @@ function resolveDefaultBridgeHost() {
 function servedPort(said) {
   return typeof said === "number" && Number.isInteger(said) && said > 0 && said <= 65535 ? said : undefined;
 }
+function mayYetConnect(listeningSince, now = Date.now()) {
+  return listeningSince === undefined || now - listeningSince.getTime() < CONNECT_WINDOW_MS;
+}
 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, OTHER_PROJECT_CLOSE_CODE = 4001, 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, CONNECT_WINDOW_MS = 35000, GodotBridge, defaultBridge = null;
 var init_godot_bridge = __esm(() => {
   init_wrapper();
   init_errors();
   init_paths();
   init_ports();
   GodotBridge = class GodotBridge extends EventEmitter {
+    listeningSince = null;
     httpServer = null;
     godotWss = null;
     socket = null;
@@ -34478,6 +34482,7 @@ var init_godot_bridge = __esm(() => {
         });
         server.once("listening", () => {
           settled = true;
+          this.listeningSince = new Date;
           this.httpServer = server;
           this.godotWss = godotWss;
           const bound = server.address();
@@ -34554,7 +34559,8 @@ var init_godot_bridge = __esm(() => {
         debugPort: this.connectionInfo?.debugPort,
         openedByAServer: this.connectionInfo?.openedByAServer,
         pendingRequests: this.pendingRequests.size,
-        queuedResources: this.resourceQueues.size
+        queuedResources: this.resourceQueues.size,
+        listeningSince: this.listeningSince ?? undefined
       };
     }
     invokeTool(toolName, args) {
@@ -37337,8 +37343,11 @@ class GodotServer {
       return this.createErrorResponse(`Cannot create ${dirname9(output.relativePath)} to export into: ${errorMessage(error)}`);
     }
     const debug = readBoolean(args, "debug") ?? false;
+    const exportLogs = mkdtempSync3(join16(tmpdir5(), "gdharness-export-"));
     const exportArgs = [
       "--headless",
+      "--log-file",
+      join16(exportLogs, "engine.log"),
       "--path",
       project.value.path,
       debug ? "--export-debug" : "--export-release",
@@ -37360,6 +37369,8 @@ class GodotServer {
       log.append("stdout", failed.stdout);
       log.append("stderr", failed.stderr);
       exitCode = typeof failed.code === "number" ? failed.code : -1;
+    } finally {
+      rmSync9(exportLogs, { recursive: true, force: true });
     }
     log.finish();
     const problems = log.select({ severity: "warning", sinceLastCall: false, limit: 200 });
@@ -37609,6 +37620,7 @@ class GodotServer {
       serverVersion: SERVER_VERSION,
       addonIsStale: status.connected ? stale : undefined,
       bridgeAvailable: this.bridgeStartupError === null,
+      mayYetConnect: status.connected ? undefined : mayYetConnect(status.listeningSince),
       startupError: this.bridgeStartupError,
       staleNote: stale ? addonMismatch(status.addonVersion, SERVER_VERSION) : undefined,
       retryingBridge: this.bridgeRetry === null ? undefined : true,
@@ -39268,6 +39280,32 @@ function registered(harness, projectPath) {
   const held = existing[harness.container];
   return typeof held === "object" && held !== null && !Array.isArray(held) && SERVER_KEY in held;
 }
+function recordedEnginePath(projectPath) {
+  for (const harness of HARNESSES) {
+    if (harness.scope !== "project" || harness.toml || harness.yaml || harness.snippet) {
+      continue;
+    }
+    const path = configPath(harness, projectPath);
+    if (!existsSync4(path)) {
+      continue;
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(readFileSync(path, "utf8"));
+    } catch {
+      continue;
+    }
+    const entry = reach(reach(parsed, harness.container), SERVER_KEY);
+    const named = reach(reach(entry, harness.shape === "opencode" ? "environment" : "env"), "GODOT_PATH");
+    if (typeof named === "string" && named !== "" && existsSync4(named)) {
+      return named;
+    }
+  }
+  return null;
+}
+function reach(held, key) {
+  return typeof held === "object" && held !== null && !Array.isArray(held) ? held[key] : undefined;
+}
 function disconnect(harness, projectPath) {
   const path = configPath(harness, projectPath);
   if (!existsSync4(path)) {
@@ -40057,8 +40095,8 @@ function projectArgument(at) {
   }
   return projectPath;
 }
-async function engine() {
-  const godotPath = await new GodotLocator().find();
+async function engine(projectPath) {
+  const godotPath = await new GodotLocator().find() ?? (projectPath === undefined ? null : recordedEnginePath(projectPath));
   if (godotPath === null) {
     throw new UsageError(`No Godot executable found. ${GodotLocator.ADVICE.join(". ")}.`);
   }
@@ -40181,7 +40219,7 @@ export, so turn it off before you ship: gdharness runtime off${where}`);
 async function setup() {
   const projectPath = projectArgument(1);
   const runtime = !args.includes("--no-runtime");
-  const godot = await engine();
+  const godot = await engine(projectPath);
   for (const addon of installAddons(projectPath)) {
     console.log(`${addon.replaced ? "replaced" : "installed"} ${addon.path}`);
   }
@@ -40231,7 +40269,7 @@ async function setup() {
 }
 async function uninstall() {
   const projectPath = projectArgument(1);
-  const godot = await engine();
+  const godot = await engine(projectPath);
   const named = namedHarnesses();
   const from = named.length > 0 ? named : HARNESSES;
   for (const harness of from) {
@@ -40282,8 +40320,8 @@ async function upgrade() {
     const where = projectPath === process.cwd() ? "" : ` ${projectPath}`;
     throw new UsageError(`gdharness is not installed in ${projectPath}. Run  gdharness setup${where}  instead.`);
   }
+  const godot = await engine(projectPath);
   console.log(installed === version ? `already ${version}; reinstalling` : `${installed} -> ${version}`);
-  const godot = await engine();
   for (const addon of installAddons(projectPath)) {
     console.log(`${addon.replaced ? "replaced" : "installed"} ${addon.path}`);
   }
@@ -40341,7 +40379,7 @@ async function runtime3() {
     throw new UsageError("gdharness runtime takes on or off, then the project directory.");
   }
   const projectPath = projectArgument(2);
-  const godot = await engine();
+  const godot = await engine(projectPath);
   if (state === "on") {
     await registerRuntime(godot, projectPath);
     return;
@@ -40363,7 +40401,7 @@ async function runtime3() {
 }
 async function classes() {
   const projectPath = projectArgument(1);
-  const godot = await engine();
+  const godot = await engine(projectPath);
   const outcome = await runOperation(godot, "refresh_class_cache", {}, projectPath);
   said2(outcome, "rebuilding the class list");
   if (outcome.ok) {

package/build/index.js

@@ -25611,8 +25611,13 @@ function resolveDefaultBridgeHost() {
 function servedPort(said) {
   return typeof said === "number" && Number.isInteger(said) && said > 0 && said <= 65535 ? said : undefined;
 }
+var CONNECT_WINDOW_MS = 35000;
+function mayYetConnect(listeningSince, now = Date.now()) {
+  return listeningSince === undefined || now - listeningSince.getTime() < CONNECT_WINDOW_MS;
+}
 
 class GodotBridge extends EventEmitter {
+  listeningSince = null;
   httpServer = null;
   godotWss = null;
   socket = null;
@@ -25675,6 +25680,7 @@ class GodotBridge extends EventEmitter {
       });
       server.once("listening", () => {
         settled = true;
+        this.listeningSince = new Date;
         this.httpServer = server;
         this.godotWss = godotWss;
         const bound = server.address();
@@ -25751,7 +25757,8 @@ class GodotBridge extends EventEmitter {
       debugPort: this.connectionInfo?.debugPort,
       openedByAServer: this.connectionInfo?.openedByAServer,
       pendingRequests: this.pendingRequests.size,
-      queuedResources: this.resourceQueues.size
+      queuedResources: this.resourceQueues.size,
+      listeningSince: this.listeningSince ?? undefined
     };
   }
   invokeTool(toolName, args) {
@@ -28655,7 +28662,7 @@ var TOOL_SPECS = [
   },
   {
     name: "editor_status",
-    description: "Whether the editor addon is connected, which Godot answers, whether the editor is playing something, and whether a game with the runtime addon is reachable.",
+    description: 'Whether the editor addon is connected, which Godot answers, whether the editor is playing something, and whether a game with the runtime addon is reachable. When connected is false, mayYetConnect says whether that is final: the editor dials this server rather than the other way round and backs off between tries, so for the first half-minute after a server starts, false means "not reached yet" as often as it means "no editor". True is worth waiting out; false is an editor that is not there. listeningSince is when this server took the bridge port, which is what that window is measured from and what a caller wanting its own window should read.',
     parameters: {},
     requires: []
   },
@@ -30119,8 +30126,11 @@ class GodotServer {
       return this.createErrorResponse(`Cannot create ${dirname4(output.relativePath)} to export into: ${errorMessage(error)}`);
     }
     const debug = readBoolean(args, "debug") ?? false;
+    const exportLogs = mkdtempSync2(join10(tmpdir4(), "gdharness-export-"));
     const exportArgs = [
       "--headless",
+      "--log-file",
+      join10(exportLogs, "engine.log"),
       "--path",
       project.value.path,
       debug ? "--export-debug" : "--export-release",
@@ -30142,6 +30152,8 @@ class GodotServer {
       log.append("stdout", failed.stdout);
       log.append("stderr", failed.stderr);
       exitCode = typeof failed.code === "number" ? failed.code : -1;
+    } finally {
+      rmSync5(exportLogs, { recursive: true, force: true });
     }
     log.finish();
     const problems = log.select({ severity: "warning", sinceLastCall: false, limit: 200 });
@@ -30391,6 +30403,7 @@ class GodotServer {
       serverVersion: SERVER_VERSION,
       addonIsStale: status.connected ? stale : undefined,
       bridgeAvailable: this.bridgeStartupError === null,
+      mayYetConnect: status.connected ? undefined : mayYetConnect(status.listeningSince),
       startupError: this.bridgeStartupError,
       staleNote: stale ? addonMismatch(status.addonVersion, SERVER_VERSION) : undefined,
       retryingBridge: this.bridgeRetry === null ? undefined : true,

package/package.json

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