gdharness 0.13.39 → 0.13.40

package/build/cli.js

@@ -15373,7 +15373,7 @@ function buildToolDefinitions() {
     };
   });
 }
-var PROJECT_INFO_SECTIONS, PROJECT_PATH, RUNNING_PROJECT_PATH, SCENE_PATH, SCRIPT_PATH, RESOURCE_PATH, NODE_PATH, PROPERTIES, XY, ANIMATION_TRACK, SCRIPT_MODIFICATIONS, INPUT_EVENTS, TILESET_SOURCES, TILEMAP_CELLS, COLOUR, TOOL_SPECS, SPECS_BY_NAME;
+var PROJECT_INFO_SECTIONS, PROJECT_PATH, RUNNING_PROJECT_PATH, RUNNING_PID, SCENE_PATH, SCRIPT_PATH, RESOURCE_PATH, NODE_PATH, PROPERTIES, XY, ANIMATION_TRACK, SCRIPT_MODIFICATIONS, INPUT_EVENTS, TILESET_SOURCES, TILEMAP_CELLS, COLOUR, TOOL_SPECS, SPECS_BY_NAME;
 var init_tool_definitions = __esm(() => {
   PROJECT_INFO_SECTIONS = [
     "autoloads",
@@ -15391,6 +15391,10 @@ var init_tool_definitions = __esm(() => {
     type: "string",
     description: "Which game, when more than one is running: the project directory it was started from. Not needed with one game."
   };
+  RUNNING_PID = {
+    type: "number",
+    description: "Which game, when several are running from one project, such as a bench and its workers: its process id, as editor_status lists under runtimes. Not needed with one game per project."
+  };
   SCENE_PATH = {
     type: "string",
     description: 'Scene file inside the project, such as "scenes/main.tscn" or "res://scenes/main.tscn".'
@@ -16114,6 +16118,7 @@ var init_tool_definitions = __esm(() => {
       description: "Questions about the running game: what is written on the screen, the scene tree, the nodes matching a query, where one node is on screen, what one property reads, or the performance metrics. Needs the game running with the runtime addon.",
       parameters: {
         projectPath: RUNNING_PROJECT_PATH,
+        pid: RUNNING_PID,
         nodePath: {
           type: "string",
           ops: ["tree", "text", "find", "rect", "property"],
@@ -16192,6 +16197,7 @@ var init_tool_definitions = __esm(() => {
       description: "Sets a property or calls a method on a node in the running game. Needs the game running with the runtime addon.",
       parameters: {
         projectPath: RUNNING_PROJECT_PATH,
+        pid: RUNNING_PID,
         nodePath: { type: "string", description: 'Absolute node path, such as "/root/Main/Player".' },
         property: {
           type: "string",
@@ -16231,6 +16237,7 @@ var init_tool_definitions = __esm(() => {
       description: "A picture of the running game: the whole screen or one viewport, as an image. Needs the game running with a window.",
       parameters: {
         projectPath: RUNNING_PROJECT_PATH,
+        pid: RUNNING_PID,
         viewportPath: {
           type: "string",
           ops: ["viewport"],
@@ -16251,6 +16258,7 @@ var init_tool_definitions = __esm(() => {
       description: "Input to the running game: a whole click on a Control or a 3D node named by path, an item chosen out of a menu, typing into whatever has the focus, or a raw action, key, mouse button or mouse motion. All of it works headless, where the window is 64 by 64 and the GUI only takes what is inside it.",
       parameters: {
         projectPath: RUNNING_PROJECT_PATH,
+        pid: RUNNING_PID,
         nodePath: {
           type: "string",
           ops: ["click", "choose"],
@@ -16347,6 +16355,7 @@ var init_tool_definitions = __esm(() => {
       description: "Lets the running game get on with it and answers when something has happened: a number of frames, a signal, a property reaching a value, or words appearing on a screen. Needs the game running with the runtime addon.",
       parameters: {
         projectPath: RUNNING_PROJECT_PATH,
+        pid: RUNNING_PID,
         frames: {
           type: "number",
           ops: ["frames"],
@@ -16382,7 +16391,7 @@ var init_tool_definitions = __esm(() => {
     },
     {
       name: "debug_breakpoint",
-      description: "Sets or removes a breakpoint through the editor's debug adapter. Needs the editor, not a running game: set them first, then editor_run, and the game stops where you asked. The editor keeps a breakpoint set this way for one play, so every breakpoint this server holds is sent again before each play editor_run starts, and the start answer lists them under breakpoints. The set is also kept in the project, for the server that comes after a reconnect: a breakpoint stays until it is removed here, whichever server set it. Every answer lists the whole set under held.",
+      description: "Sets or removes a breakpoint through the editor's debug adapter. Needs the editor, not a running game: set them first, then editor_run, and the game stops where you asked. The editor keeps a breakpoint set this way for one play, so every breakpoint this server holds is sent again before each play editor_run starts, and the start answer lists them under breakpoints. The set is also kept in the project, for the server that comes after a reconnect: a breakpoint stays until it is removed here, whichever server set it. Every answer lists the whole set under held, and the breakpoints the user set in the editor's own gutter under setInEditor; setting one here never takes those away, and removing a line here clears it whoever set it. Godot clears every breakpoint in the editor when a debug session opens unless network/debug_adapter/sync_breakpoints is on, which the addon turns on as it loads; an editor running an older addon is said so under breakpointsAtRisk, here and in editor_status.",
       parameters: {
         projectPath: PROJECT_PATH,
         scriptPath: SCRIPT_PATH,
@@ -31481,6 +31490,8 @@ class GodotDAPClient {
   halt = null;
   holdKnown = false;
   breakpoints = new Map;
+  inEditor = new Map;
+  onBreakpointsChanged = null;
   constructor(port = portFromEnv("GDHARNESS_DAP_PORT", DEFAULT_DAP_PORT), host = "127.0.0.1") {
     this.port = port;
     this.host = host;
@@ -31570,6 +31581,7 @@ class GodotDAPClient {
     this.attached = false;
     this.halt = null;
     this.holdKnown = false;
+    this.inEditor.clear();
   }
   async ensureConnected() {
     if (!this.connected) {
@@ -31666,6 +31678,31 @@ class GodotDAPClient {
       this.holdKnown = true;
       return;
     }
+    if (eventName === "breakpoint") {
+      const body = event.body;
+      const breakpoint = body?.["breakpoint"];
+      const source = typeof breakpoint === "object" && breakpoint !== null ? breakpoint["source"] : undefined;
+      const path = typeof source === "object" && source !== null ? source["path"] : undefined;
+      const line = typeof breakpoint === "object" && breakpoint !== null ? breakpoint["line"] : undefined;
+      if (typeof path !== "string" || typeof line !== "number") {
+        return;
+      }
+      if (said(body, "reason") === "removed") {
+        this.inEditor.get(path)?.delete(line);
+        const held = this.breakpoints.get(path);
+        if (held?.delete(line) === true) {
+          if (held.size === 0) {
+            this.breakpoints.delete(path);
+          }
+          this.onBreakpointsChanged?.(this.breakpointsHeld());
+        }
+        return;
+      }
+      const known = this.inEditor.get(path) ?? new Set;
+      known.add(line);
+      this.inEditor.set(path, known);
+      return;
+    }
     if (eventName === "terminated" || eventName === "exited") {
       this.attached = false;
       this.halt = null;
@@ -31758,23 +31795,46 @@ class GodotDAPClient {
   async removeBreakpoint(filePath, line) {
     const wanted = new Set(this.breakpoints.get(filePath) ?? []);
     wanted.delete(line);
-    return await this.sendBreakpoints(filePath, wanted);
+    return await this.sendBreakpoints(filePath, wanted, line);
   }
-  async sendBreakpoints(filePath, lines) {
+  async sendBreakpoints(filePath, mine, clearing) {
     await this.ensureConnected();
     await this.initialize();
+    const lines = new Set([...mine, ...this.inEditor.get(filePath) ?? []]);
+    if (clearing !== undefined) {
+      lines.delete(clearing);
+    }
     const sorted = Array.from(lines).sort((a, b) => a - b);
     const answer = await this.sendRequest("setBreakpoints", {
       source: { path: filePath },
       breakpoints: sorted.map((breakpointLine) => ({ line: breakpointLine }))
     });
-    if (lines.size === 0) {
+    if (mine.size === 0) {
       this.breakpoints.delete(filePath);
     } else {
-      this.breakpoints.set(filePath, new Set(lines));
+      this.breakpoints.set(filePath, new Set(mine));
+    }
+    if (lines.size === 0) {
+      this.inEditor.delete(filePath);
+    } else {
+      this.inEditor.set(filePath, lines);
     }
     return answer;
   }
+  setBreakpointsSink(sink) {
+    this.onBreakpointsChanged = sink;
+  }
+  breakpointsInEditor() {
+    const theirs = [];
+    for (const [scriptPath, lines] of this.inEditor) {
+      const mine = this.breakpoints.get(scriptPath);
+      const rest = Array.from(lines).filter((line) => !mine?.has(line)).sort((a, b) => a - b);
+      if (rest.length > 0) {
+        theirs.push({ scriptPath, lines: rest });
+      }
+    }
+    return theirs;
+  }
   async reapplyBreakpoints() {
     const applied = [];
     const refused = [];
@@ -31790,6 +31850,9 @@ class GodotDAPClient {
         });
       }
     }
+    if (refused.length > 0) {
+      this.onBreakpointsChanged?.(this.breakpointsHeld());
+    }
     return { applied, refused };
   }
   breakpointsHeld() {
@@ -31992,14 +32055,10 @@ async function handleDAPTool(client, toolName, args) {
     }
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
+    const cure = toolName === "dap_set_breakpoint" || toolName === "dap_remove_breakpoint" ? "Breakpoints need the editor open, not a running game: editor_status says whether one is connected, and the path is the script as the project spells it." : "The debug tools answer for a game the editor is playing: start one with editor_run.";
     return {
       isError: true,
-      content: [
-        {
-          type: "text",
-          text: `DAP tool '${toolName}' failed: ${message}. ` + "The debug tools answer for a game the editor is playing: start one with editor_run."
-        }
-      ]
+      content: [{ type: "text", text: `DAP tool '${toolName}' failed: ${message}. ${cure}` }]
     };
   }
 }
@@ -35076,6 +35135,7 @@ var init_godot_bridge = __esm(() => {
         dapPort: this.connectionInfo?.dapPort,
         debugPort: this.connectionInfo?.debugPort,
         openedByAServer: this.connectionInfo?.openedByAServer,
+        syncsBreakpoints: this.connectionInfo?.syncsBreakpoints,
         pendingRequests: this.pendingRequests.size,
         queuedResources: this.resourceQueues.size,
         listeningSince: this.listeningSince ?? undefined
@@ -35218,6 +35278,7 @@ var init_godot_bridge = __esm(() => {
             this.connectionInfo.dapPort = servedPort(message.dap_port);
             this.connectionInfo.debugPort = servedPort(message.debug_port);
             this.connectionInfo.openedByAServer = message.opened_by_a_server === true;
+            this.connectionInfo.syncsBreakpoints = typeof message.syncs_breakpoints === "boolean" ? message.syncs_breakpoints : undefined;
             this.log("info", `Godot ready: ${message.project_path}`);
             this.emitBridgeEvent("godot_connected", { projectPath: message.project_path });
           }
@@ -36708,7 +36769,25 @@ function tooNew(unspoken) {
   const half = unspoken.some((game) => game.protocol > RUNTIME_PROTOCOL) ? "this server is the older half: reconnect it so it spawns the installed version" : "the addon is the older half: reinstall it and restart the game";
   return `A game is running, in a protocol this server does not speak ${named}. This server speaks ${RUNTIME_PROTOCOL}, so ${half}.`;
 }
-function chooseRuntime(endpoints, projectPath, unspoken = []) {
+function chooseRuntime(endpoints, projectPath, unspoken = [], pid) {
+  if (pid !== undefined) {
+    const named = endpoints.find((endpoint) => endpoint.pid === pid);
+    if (named !== undefined) {
+      if (projectPath !== undefined && resolve4(named.project.path) !== resolve4(projectPath)) {
+        return {
+          problem: `The game with pid ${pid} is running ${named.project.path}, not ${resolve4(projectPath)}. Running: ${endpoints.map(describe2).join("; ")}.`
+        };
+      }
+      return { endpoint: named };
+    }
+    const tooNewToo = unspoken.find((game) => game.pid === pid);
+    if (tooNewToo !== undefined) {
+      return { problem: tooNew([tooNewToo]) };
+    }
+    return {
+      problem: endpoints.length === 0 ? `No game with the runtime addon is running, so there is none with pid ${pid}. Start one with editor_run, or play the project from the editor with the addon enabled.` : `No running game has pid ${pid}. Running: ${endpoints.map(describe2).join("; ")}. editor_status lists them under runtimes as they come and go.`
+    };
+  }
   if (endpoints.length === 0) {
     if (unspoken.length > 0) {
       return { problem: tooNew(unspoken) };
@@ -36739,14 +36818,14 @@ function chooseRuntime(endpoints, projectPath, unspoken = []) {
       return { endpoint: matching[0] };
     }
     return {
-      problem: `Several games are running from ${wanted}: ${matching.map(describe2).join("; ")}. Stop all but one.`
+      problem: `Several games are running from ${wanted}: ${matching.map(describe2).join("; ")}. Pass pid to choose one.`
     };
   }
   if (endpoints.length === 1 && endpoints[0]) {
     return { endpoint: endpoints[0] };
   }
   return {
-    problem: `Several games are running: ${endpoints.map(describe2).join("; ")}. Pass projectPath to choose one.`
+    problem: `Several games are running: ${endpoints.map(describe2).join("; ")}. Pass projectPath to choose one, or pid when they are from one project.`
   };
 }
 function runtimeRequest(endpoint, command, params, timeoutMs) {
@@ -37151,6 +37230,9 @@ function patienceForFrames(frames, atLeast) {
 function projectSpelling(projectPath, absolutePath) {
   return `res://${relative3(realPathOr(projectPath), realPathOr(absolutePath)).replaceAll("\\", "/")}`;
 }
+function whichGame(args) {
+  return { projectPath: args["projectPath"], pid: args["pid"] };
+}
 function describeHalt(halt) {
   switch (halt.reason) {
     case "breakpoint":
@@ -37186,6 +37268,19 @@ function runIsUp(run, editorSays) {
   }
   return editorSays ?? stillRunning(run);
 }
+function endedPreviousRun(ended) {
+  if (ended === null) {
+    return;
+  }
+  return ended.pid ?? true;
+}
+function endedToStartThis(ended) {
+  if (ended === null) {
+    return "";
+  }
+  const which = ended.pid === null ? "The game the editor was playing" : `The run that was going, pid ${ended.pid},`;
+  return ` ${which} was ended to start this one; its output is no longer what editor_output answers about.`;
+}
 function runtimeVerdict(endpoint, after) {
   if (endpoint !== null) {
     return { listening: true, pid: endpoint.pid, port: endpoint.port };
@@ -37884,7 +37979,7 @@ class GodotServer {
         switch (op) {
           case "tree":
             return await this.handleRuntimeCommand("get_tree", {
-              projectPath: args["projectPath"],
+              ...whichGame(args),
               root: readNonEmptyString(args, "nodePath") ?? "/root",
               depth: readPositiveNumber(args, "depth") ?? 3,
               include_properties: readBoolean(args, "includeProperties") ?? false
@@ -37893,36 +37988,36 @@ class GodotServer {
             return await this.handleFindRuntimeNodes(args);
           case "text":
             return await this.handleRuntimeCommand("read_text", {
-              projectPath: args["projectPath"],
+              ...whichGame(args),
               root: readNonEmptyString(args, "nodePath") ?? "/root",
               include_hidden: readBoolean(args, "includeHidden") ?? false,
               limit: readPositiveNumber(args, "limit") ?? 500
             });
           case "rect":
             return await this.handleRuntimeCommand("get_rect", {
-              projectPath: args["projectPath"],
+              ...whichGame(args),
               path: readNonEmptyString(args, "nodePath") ?? ""
             });
           case "property":
             return await this.handleRuntimeCommand("get_property", {
-              projectPath: args["projectPath"],
+              ...whichGame(args),
               path: readNonEmptyString(args, "nodePath") ?? "",
               property: readNonEmptyString(args, "property") ?? ""
             });
           default:
             return await this.handleRuntimeCommand("get_metrics", {
-              projectPath: args["projectPath"],
+              ...whichGame(args),
               metrics: readArray(args, "metrics") ?? []
             });
         }
       case "runtime_invoke":
         return op === "set" ? await this.handleRuntimeCommand("set_property", {
-          projectPath: args["projectPath"],
+          ...whichGame(args),
           path: readNonEmptyString(args, "nodePath") ?? "",
           property: readString(args, "property") ?? "",
           value: args["value"]
         }) : await this.handleRuntimeCommand("call_method", {
-          projectPath: args["projectPath"],
+          ...whichGame(args),
           path: readNonEmptyString(args, "nodePath") ?? "",
           method: readString(args, "method") ?? "",
           args: readArray(args, "args") ?? []
@@ -37932,7 +38027,7 @@ class GodotServer {
       case "runtime_input":
         if (op === "click") {
           return await this.handleRuntimeCommand("click", {
-            projectPath: args["projectPath"],
+            ...whichGame(args),
             path: readNonEmptyString(args, "nodePath") ?? "",
             button: readString(args, "button") ?? "left",
             double: readBoolean(args, "doubleClick") ?? false
@@ -37940,7 +38035,7 @@ class GodotServer {
         }
         if (op === "choose") {
           return await this.handleRuntimeCommand("choose", {
-            projectPath: args["projectPath"],
+            ...whichGame(args),
             path: readNonEmptyString(args, "nodePath") ?? "",
             text: readString(args, "text") ?? "",
             ...args["index"] === undefined ? {} : { index: args["index"] }
@@ -37971,7 +38066,9 @@ class GodotServer {
         return this.jsonTextResponse({
           ...asParams(JSON.parse(answered.content[0]?.text ?? "{}")),
           held: this.breakpointsAsProjectSpells(project.value.path, held),
-          note: "The editor keeps a breakpoint set this way for one play. Every breakpoint held here is sent again before each play editor_run starts, and kept in the project for the server after a reconnect."
+          setInEditor: this.breakpointsAsProjectSpells(project.value.path, session.breakpointsInEditor()),
+          note: "The editor keeps a breakpoint set this way for one play. Every breakpoint held here is sent again before each play editor_run starts, and kept in the project for the server after a reconnect.",
+          ...this.breakpointsAtRisk()
         });
       }
       case "debug_control":
@@ -38045,6 +38142,16 @@ class GodotServer {
         response: this.createErrorResponse("No game is running, so there is no debug session to answer for.", ["Start one with editor_run start, which has the editor play it"])
       };
     }
+    const going = await this.runStillGoing(game);
+    if (!going) {
+      return {
+        ok: false,
+        response: this.createErrorResponse("The last run has already ended, so there is no debug session to answer for.", [
+          "editor_output still reads what it printed, until the next run starts",
+          "editor_run start plays another, which the debugger can hold"
+        ])
+      };
+    }
     if (!game.throughEditor) {
       return {
         ok: false,
@@ -38066,7 +38173,7 @@ class GodotServer {
       };
     }
     if (!this.dap().isStopped()) {
-      const hold = await this.holdOf(game);
+      const hold = await this.holdOf(game, going);
       if (hold.heldAt !== null) {
         if (intent === "move") {
           return { ok: true, value: game };
@@ -38632,6 +38739,12 @@ class GodotServer {
       this.dapClient.setOutputSink((line) => {
         this.writeToTranscript(line);
       });
+      this.dapClient.setBreakpointsSink((held) => {
+        const project = this.godotBridge.getStatus().projectPath ?? this.ownProject;
+        if (project !== null) {
+          writeBreakpointNote(project, held);
+        }
+      });
     }
     return this.dapClient;
   }
@@ -38643,6 +38756,15 @@ class GodotServer {
     }
     return client;
   }
+  breakpointsAtRisk() {
+    const status = this.godotBridge.getStatus();
+    if (!status.connected || status.syncsBreakpoints === true) {
+      return {};
+    }
+    return {
+      breakpointsAtRisk: status.syncsBreakpoints === false ? "This editor clears every breakpoint in its script editor whenever a debug session opens on its adapter, which this server does for its first breakpoint or stack read: network/debug_adapter/sync_breakpoints is off. The installed addon turns it on as it loads, so the editor is running an older one; editor_launch restart puts the installed addon in, or turn the setting on in Editor Settings > Network > Debug Adapter." : "Whether this editor keeps its breakpoints when a debug session opens cannot be told: the addon it is running predates the report. Godot clears them unless network/debug_adapter/sync_breakpoints is on, which the installed addon turns on as it loads; editor_launch restart puts the installed addon in."
+    };
+  }
   breakpointsAsProjectSpells(projectPath, held) {
     return held.map((one) => ({
       scriptPath: projectSpelling(projectPath, one.scriptPath),
@@ -38705,6 +38827,7 @@ class GodotServer {
       ...status.connected ? this.whatTheLaunchedEditorDropped() : {},
       startupError: this.bridgeStartupError,
       staleNote: stale ? addonMismatch(status.addonVersion, SERVER_VERSION) : undefined,
+      ...this.breakpointsAtRisk(),
       retryingBridge: this.bridgeRetry === null ? undefined : true,
       announcedAt: this.announcedAt ?? undefined,
       projectIs: this.projectHasMovedOn() ?? undefined,
@@ -38756,9 +38879,14 @@ class GodotServer {
       const playing = await this.editorPlayingState();
       await this.pickUpWhatTheEditorIsPlaying();
       const current = this.currentRun();
-      return { playing, hold: current === null ? {} : await this.holdOf(current) };
+      const active = current === null ? false : await this.runStillGoing(current, playing?.playing ?? null);
+      return {
+        playing,
+        active,
+        hold: current === null ? {} : await this.holdOf(current, active)
+      };
     })();
-    const [games, { playing, hold }] = await Promise.all([pinged, asked]);
+    const [games, { playing, active, hold }] = await Promise.all([pinged, asked]);
     return this.jsonTextResponse({
       editor: {
         ...this.getEditorStatusPayload(),
@@ -38770,7 +38898,7 @@ class GodotServer {
         problem: located.ok ? undefined : GodotLocator2.refusal(located).message
       },
       game: {
-        processActive: runIsUp(this.currentRun(), playing === null ? null : playing.playing),
+        processActive: active,
         playingInEditor: playing,
         ...hold,
         runtimeConnected: games.some((game) => game.reachable),
@@ -38983,10 +39111,12 @@ class GodotServer {
     if (op === "check") {
       return await this.checkBoot(engine.value, project.value.path, sceneArgument, args, given.value);
     }
+    await this.pickUpWhatTheEditorIsPlaying();
     let ended = null;
-    if (stillRunning(this.currentRun())) {
+    const before = this.currentRun();
+    if (before !== null && await this.runStillGoing(before)) {
       this.logDebug("Ending the running game before starting another");
-      ended = this.currentRun()?.pid ?? null;
+      ended = { pid: before.pid ?? this.announcedPidOf(before) ?? null };
       await this.endActiveGame("editor_run start, which ends the run that was going before it starts another");
     }
     const alreadyPlaying = new Set(discoverRuntimes().map((endpoint) => endpoint.pid));
@@ -39010,8 +39140,8 @@ class GodotServer {
     const started = this.spawnKeptGame(engine.value, cmdArgs, project.value.path);
     this.activeProcess = started;
     const spawnedInstead = this.godotBridge.isConnected() && editorWouldPlay && given.value.length > 0 ? " The editor cannot be handed arguments for a game it plays, so this one was started " + "here: the debug_* tools answer only for a game the editor is playing." : "";
-    const endedForThis = ended === null ? "" : ` The run that was going, pid ${ended}, was ended to start this one; its output is no longer what editor_output answers about.`;
-    const stranded = wereHereFirst.filter((one) => one.pid !== ended && alive(one.pid));
+    const endedForThis = endedToStartThis(ended);
+    const stranded = wereHereFirst.filter((one) => one.pid !== ended?.pid && alive(one.pid));
     const named = stranded.map((one) => one.protocol === null ? `pid ${one.pid}` : `pid ${one.pid} on protocol ${one.protocol}`).join(", ");
     const alsoRunning = stranded.length === 0 ? "" : ` A game of this project was already running and still is: ${named}. Starting this one did not end it and nothing here can, because this server did not start it. End it yourself, or bring the halves to one version where a protocol is named.`;
     return this.jsonTextResponse({
@@ -39022,23 +39152,38 @@ class GodotServer {
       arguments: cmdArgs,
       transcript: started.transcript,
       refreshedClasses: refreshed.value,
-      endedPreviousRun: ended ?? undefined,
+      endedPreviousRun: endedPreviousRun(ended),
       runtime: await this.runtimeUp(project.value.path, alreadyPlaying, runtimeWaitMs, given.value.length > 0),
       message: `Use editor_output for what it prints and editor_run stop to end it.${spawnedInstead}${endedForThis}${alsoRunning}`
     });
   }
-  async gameIsUp() {
-    const run = this.currentRun();
-    const editorSays = run?.throughEditor === true ? (await this.editorPlayingState())?.playing ?? null : null;
-    return runIsUp(run, editorSays);
-  }
   async runtimeUp(projectPath, before, budgetMs, withArgs) {
     if (!existsSync14(join19(projectPath, RUNTIME_AUTOLOAD2.path))) {
       return runtimeVerdict(null, { addon: false, budgetMs, heldAt: null, running: false, withArgs });
     }
+    let asking = null;
+    let editorAskedAt = 0;
+    let editorSaysGoing = true;
     const endpoint = await announcedSince(projectPath, before, {
       budgetMs,
-      giveUp: () => this.dapClient?.isStopped() === true || !stillRunning(this.currentRun())
+      giveUp: () => {
+        if (this.dapClient?.isStopped() === true) {
+          return true;
+        }
+        const run = this.currentRun();
+        if (run === null || !run.throughEditor) {
+          return !stillRunning(run);
+        }
+        if (asking === null && Date.now() - editorAskedAt >= RUN_POLL_MS) {
+          editorAskedAt = Date.now();
+          asking = this.runStillGoing(run).then((going) => {
+            editorSaysGoing = going;
+          }).finally(() => {
+            asking = null;
+          });
+        }
+        return !editorSaysGoing;
+      }
     });
     const going = this.currentRun();
     if (endpoint !== null && going?.throughEditor === true && going.announcedPid === undefined) {
@@ -39048,7 +39193,7 @@ class GodotServer {
       addon: true,
       budgetMs,
       heldAt: this.dapClient?.whereItStopped() ?? null,
-      running: await this.gameIsUp(),
+      running: endpoint !== null || going !== null && await this.runStillGoing(going),
       withArgs
     });
   }
@@ -39089,7 +39234,8 @@ class GodotServer {
       startedAt,
       exitCode: null,
       throughEditor: true,
-      brokeOn: null
+      brokeOn: null,
+      announcedBefore: alreadyPlaying
     };
     this.activeProcess = played;
     writeEditorRunNote({ projectPath, transcript: transcript.path, startedAt });
@@ -39100,14 +39246,14 @@ class GodotServer {
       scene: scene === null ? "the main scene" : `res://${scene}`,
       refreshedClasses,
       debugPort: readNumber(asParams(JSON.parse(answer.content[0]?.text ?? "{}")), "debugPort"),
-      endedPreviousRun: ended ?? undefined,
+      endedPreviousRun: endedPreviousRun(ended),
       breakpoints: breakpoints.applied.length === 0 ? undefined : this.breakpointsAsProjectSpells(projectPath, breakpoints.applied),
       breakpointsRefused: breakpoints.refused.length === 0 ? undefined : breakpoints.refused.map((one) => ({
         scriptPath: projectSpelling(projectPath, one.scriptPath),
         reason: one.reason
       })),
       runtime: await this.runtimeUp(projectPath, alreadyPlaying, runtimeWaitMs, false),
-      message: "The editor is playing it, so its debugger holds it: the debug_* tools can reach it, " + "editor_output reads its console through the debug adapter, and editor_run stop ends it." + (ended === null ? "" : ` The run that was going, pid ${ended}, was ended to start this one; its output is no longer what editor_output answers about.`)
+      message: "The editor is playing it, so its debugger holds it: the debug_* tools can reach it, " + "editor_output reads its console through the debug adapter, and editor_run stop ends it." + endedToStartThis(ended)
     });
   }
   drainEditorOutput(game) {
@@ -39323,15 +39469,19 @@ class GodotServer {
       brokeOn: null,
       pickedUpPlaying: true
     };
-    const announced = this.theOneAnnouncedForOurProject();
-    if (announced !== undefined) {
-      picked.announcedPid = announced.pid;
-    }
     this.activeProcess = picked;
   }
-  theOneAnnouncedForOurProject() {
-    const ofProject = this.allAnnouncedForOurProject(runtimesAnnounced().running);
-    return ofProject.length === 1 ? ofProject[0] : undefined;
+  announcedPidOf(run) {
+    if (!run.throughEditor || run.announcedPid !== undefined) {
+      return run.announcedPid;
+    }
+    const before = run.announcedBefore ?? new Set;
+    const fresh = this.allAnnouncedForOurProject(runtimesAnnounced().running).filter((one) => !before.has(one.pid));
+    const theOne = fresh.length === 1 ? fresh[0] : undefined;
+    if (theOne !== undefined) {
+      run.announcedPid = theOne.pid;
+    }
+    return run.announcedPid;
   }
   adoptRecordedRun() {
     const record = readRunRecord();
@@ -39461,12 +39611,22 @@ class GodotServer {
     }
     const budgetMs = readPositiveNumber(args, "timeoutMs") ?? WAIT_FOR_RUN_MS;
     const until = Date.now() + budgetMs;
-    while (stillRunning(run) && Date.now() < until) {
+    while (await this.runStillGoing(run) && Date.now() < until) {
       this.drainEditorOutput(run);
       this.drainTranscript(run);
       await delay3(RUN_POLL_MS);
     }
-    return await this.handleGetDebugOutput(args, stillRunning(run) ? budgetMs : undefined);
+    return await this.handleGetDebugOutput(args, await this.runStillGoing(run) ? budgetMs : undefined);
+  }
+  async runStillGoing(run, editorSays) {
+    if (!run.throughEditor) {
+      return stillRunning(run);
+    }
+    const announced = this.announcedPidOf(run);
+    if (announced !== undefined && !alive(announced)) {
+      return false;
+    }
+    return runIsUp(run, editorSays === undefined ? (await this.editorPlayingState())?.playing ?? null : editorSays);
   }
   async handleGetDebugOutput(args, waitedMs) {
     await this.pickUpWhatTheEditorIsPlaying();
@@ -39476,7 +39636,8 @@ class GodotServer {
     }
     this.drainEditorOutput(run);
     this.drainTranscript(run);
-    if (run.endedUnwatched !== true && !stillRunning(run)) {
+    const going = await this.runStillGoing(run);
+    if (run.endedUnwatched !== true && !going) {
       run.log.finish();
       run.endedUnwatched = run.exitCode === null;
     }
@@ -39487,12 +39648,13 @@ class GodotServer {
       contains: readNonEmptyString(args, "contains"),
       limit: readPositiveNumber(args, "limit") ?? 200
     });
-    const hold = await this.holdOf(run);
+    const hold = await this.holdOf(run, going);
     const wanted = readBoolean(args, "cpu") ?? false;
-    const cpuSeconds = wanted && run.pid !== null && stillRunning(run) ? await cpuSecondsOf(run.pid) : undefined;
+    const processToAsk = run.pid ?? this.announcedPidOf(run) ?? null;
+    const cpuSeconds = wanted && processToAsk !== null && stillRunning(run) ? await cpuSecondsOf(processToAsk) : undefined;
     const notes = [];
     if (wanted && cpuSeconds === undefined && stillRunning(run)) {
-      notes.push(run.pid === null ? "cpu was asked for and there is no process to ask: the editor is playing this run and holds it, so nothing here has its process id. editor_run start without a connected editor, or with args, starts the game here instead and that run answers cpuSeconds." : "cpu was asked for and this platform would not say what the run has used.");
+      notes.push(processToAsk === null ? "cpu was asked for and there is no process to ask: the editor is playing this run and holds it, and the game announced no runtime, so nothing here has its process id. A game with the runtime addon announces one; editor_run start without a connected editor, or with args, starts the game here instead and that run answers cpuSeconds either way." : "cpu was asked for and this platform would not say what the run has used.");
     }
     if (waitedMs !== undefined) {
       notes.push(`The wait of ${waitedMs}ms ran out and the run is still going, so this is what it had printed by then rather than everything it will print. editor_run wait again to keep waiting.`);
@@ -39516,10 +39678,10 @@ class GodotServer {
       notes.push(`Everything this run has printed is in ${run.transcript}, uncapped and still being written. Read it for output, not for whether the run is alive: a transcript that stops growing is a run between prints. running above is asked of the operating system while there is a process to ask about, and for an editor-played run that announced no runtime it is the editor's answer instead, which can lag after the game has gone.`);
     }
     return this.jsonTextResponse({
-      running: stillRunning(run),
+      running: going,
       exitCode: run.exitCode,
       through: run.throughEditor ? "editor" : "gdharness",
-      pid: run.pid,
+      pid: run.pid ?? this.announcedPidOf(run) ?? null,
       errors: run.log.count("error"),
       warnings: run.log.count("warning"),
       clean: run.consoleLost === true ? undefined : run.log.count("error") === 0,
@@ -39545,18 +39707,19 @@ class GodotServer {
     }
     this.drainEditorOutput(stopped);
     this.drainTranscript(stopped);
+    const wasRunning = await this.runStillGoing(stopped);
     this.logDebug("Stopping the running game");
     await this.endActiveGame("editor_run stop");
     return this.jsonTextResponse({
       stopped: true,
       through: stopped.throughEditor ? "editor" : "gdharness",
-      endedPid: stopped.pid,
-      exitedBeforeStop: stopped.exitCode !== null,
+      endedPid: stopped.pid ?? this.announcedPidOf(stopped) ?? null,
+      exitedBeforeStop: stopped.exitCode !== null || !wasRunning,
       exitCode: stopped.exitCode,
       errors: stopped.log.count("error"),
       warnings: stopped.log.count("warning"),
       clean: stopped.log.count("error") === 0,
-      note: stopped.throughEditor ? "The editor was asked to stop the scene it is playing. Anything that game started for itself, with OS.create_process or otherwise, is not the editor's to stop and is still running." : "The process named under endedPid was ended. Anything that game started for itself, with OS.create_process or otherwise, is a separate process and is still running.",
+      note: !wasRunning ? "This run was over before the stop, so nothing was ended here: editor_output has what it printed and how it ended. Anything that game started for itself, with OS.create_process or otherwise, is a separate process and may still be running." : stopped.throughEditor ? "The editor was asked to stop the scene it is playing. Anything that game started for itself, with OS.create_process or otherwise, is not the editor's to stop and is still running." : "The process named under endedPid was ended. Anything that game started for itself, with OS.create_process or otherwise, is a separate process and is still running.",
       entries: forAnswer(stopped.log.select({ severity: "warning", sinceLastCall: false, limit: 200 }).entries)
     });
   }
@@ -39713,21 +39876,21 @@ class GodotServer {
     if (run === null || !run.throughEditor || !stillRunning(run) || session === null) {
       return null;
     }
-    const its = run.announcedPid ?? this.theOneAnnouncedForOurProject()?.pid;
-    if (its !== endpoint.pid || !session.holdIsKnown()) {
+    if (this.announcedPidOf(run) !== endpoint.pid || !session.holdIsKnown()) {
       return null;
     }
     return session.whereItStopped();
   }
-  async holdOf(run) {
-    if (!run.throughEditor || !stillRunning(run)) {
+  async holdOf(run, going) {
+    if (!run.throughEditor || !(going ?? await this.runStillGoing(run))) {
       return { heldAt: null };
     }
     const session = this.dapClient;
     if (session?.holdIsKnown()) {
       return { heldAt: session.whereItStopped() };
     }
-    const endpoint = run.announcedPid !== undefined ? runtimesAnnounced().running.find((one) => one.pid === run.announcedPid) : this.theOneAnnouncedForOurProject();
+    const its = this.announcedPidOf(run);
+    const endpoint = its === undefined ? undefined : runtimesAnnounced().running.find((one) => one.pid === its);
     if (endpoint === undefined) {
       return {
         heldAt: undefined,
@@ -39752,9 +39915,9 @@ class GodotServer {
     return { heldAt: undefined, heldUnknown: true, heldNote: reply.message };
   }
   async handleRuntimeCommand(command, args, timeoutMs = this.runtimeTimeoutMs()) {
-    const { op: _op, projectPath, ...params } = asParams(args);
+    const { op: _op, projectPath, pid, ...params } = asParams(args);
     const announced = runtimesAnnounced();
-    const choice = chooseRuntime(announced.running, typeof projectPath === "string" ? projectPath : this.ownProject ?? undefined, announced.unspoken);
+    const choice = chooseRuntime(announced.running, typeof projectPath === "string" ? projectPath : this.ownProject ?? undefined, announced.unspoken, typeof pid === "number" ? pid : undefined);
     if ("problem" in choice) {
       return this.createErrorResponse(choice.problem);
     }
@@ -39820,7 +39983,7 @@ class GodotServer {
     const includeHidden = readBoolean(args, "includeHidden");
     return await this.handleRuntimeCommand("find_nodes", {
       ...filters,
-      projectPath: args["projectPath"],
+      ...whichGame(args),
       root: readNonEmptyString(args, "nodePath") ?? "/root",
       limit: readPositiveNumber(args, "limit") ?? 100,
       ...property === undefined ? {} : { property },
@@ -39831,18 +39994,18 @@ class GodotServer {
     if (op === "frames") {
       const frames = readPositiveNumber(args, "frames") ?? 1;
       const waited = patienceForFrames(frames, this.runtimeTimeoutMs());
-      return await this.handleRuntimeCommand("wait_frames", { projectPath: args["projectPath"], frames }, waited);
+      return await this.handleRuntimeCommand("wait_frames", { ...whichGame(args), frames }, waited);
     }
     const timeoutMs = readPositiveNumber(args, "timeoutMs") ?? 5000;
     const nodePath = readNonEmptyString(args, "nodePath") ?? "";
     const patience = Math.max(this.runtimeTimeoutMs(), timeoutMs + 5000);
     return op === "signal" ? await this.handleRuntimeCommand("wait_signal", {
-      projectPath: args["projectPath"],
+      ...whichGame(args),
       path: nodePath,
       signal: readString(args, "signal") ?? "",
       timeout_ms: timeoutMs
     }, patience) : await this.handleRuntimeCommand("wait_until", {
-      projectPath: args["projectPath"],
+      ...whichGame(args),
       path: nodePath,
       property: readString(args, "property") ?? "",
       value: args["value"],
@@ -41397,7 +41560,8 @@ that is running, and the project on disk. ${TOOL_SPECS.length} tools, named \`do
 ## Start here
 
 - ${projectPathSentence()}. The \`runtime_*\` and \`debug_*\` ones pick between running
-  games instead; the others answer about the editor this server is connected to. There is no
+  games instead, by \`projectPath\`, or by \`pid\` when several run from one project, as a bench
+  and its workers do; the others answer about the editor this server is connected to. There is no
   ambient project, and an argument a tool does not declare is refused rather than ignored.
 - \`editor_status\` says whether an editor is connected and whether its addon matches the server.
   \`addonIsStale\` means they differ, and \`staleNote\` says which half is behind: an editor that
@@ -41469,6 +41633,12 @@ The autoload reaches an export. \`gdharness runtime off\` in the project before
 move. There is no pause and no step out: Godot's debug adapter implements neither, so use a
 breakpoint on the line you want instead.
 
+A held game draws nothing and answers no \`runtime_*\` call. The server says so at once when it
+knows, naming why the game is held and \`debug_control continue\` as what lets it go, and
+\`editor_output\` and \`editor_status\` carry the same under \`heldAt\`. A breakpoint set with
+\`debug_breakpoint\` holds for every start until \`debug_breakpoint remove\`, across a reconnect,
+so take it off when the question it was for is answered.
+
 ## Editing
 
 \`scene_tree\` for what a scene holds, rather than what the \`.tscn\` text implies. \`scene_node\`,