gdharness 1.2.36 → 1.2.37

package/build/index.js

@@ -3373,7 +3373,8 @@ import {
   readFileSync as readFileSync24,
   readSync as readSync2,
   rmdirSync as rmdirSync2,
-  statSync as statSync12
+  statSync as statSync12,
+  writeFileSync as writeFileSync16
 } from "node:fs";
 import { basename as basename7, dirname as dirname18, extname as extname4, isAbsolute as isAbsolute4, join as join26, normalize as normalize2, relative as relative5 } from "node:path";
 import { setTimeout as delay5 } from "node:timers/promises";
@@ -32974,6 +32975,7 @@ var AGAIN_AFTER_MS = [250, 500, 1000, 2000, 4000, 8000, 16000];
 var waiting = new Set;
 var atExit = new Set;
 var KINDS = [
+  "answers",
   "desktop",
   "export",
   "import",
@@ -33078,8 +33080,14 @@ function snakeCased(params) {
 }
 function engineExtras(outcome) {
   const after = outcome.afterAnswerMessages ?? [];
+  const before = outcome.beforeOperationMessages ?? [];
   return {
     ...outcome.messages.length > 0 ? { engine_messages: outcome.messages } : {},
+    ...before.length > 0 ? {
+      engine_messages_before_operation: before,
+      engine_messages_before_operation_note: BEFORE_OPERATION_NOTE
+    } : {},
+    ...outcome.beforeOperationOmitted === undefined ? {} : { engine_messages_before_operation_omitted: outcome.beforeOperationOmitted },
     ...outcome.messagesOmitted === undefined ? {} : { engine_messages_omitted: outcome.messagesOmitted },
     ...after.length > 0 ? { engine_messages_after_answer: after, engine_messages_after_answer_note: AFTER_ANSWER_NOTE } : {},
     ...outcome.afterAnswerOmitted === undefined ? {} : { engine_messages_after_answer_omitted: outcome.afterAnswerOmitted },
@@ -33087,8 +33095,11 @@ function engineExtras(outcome) {
   };
 }
 var AFTER_ANSWER_NOTE = "Printed after this operation had written its answer, while the engine ran the project's autoloads and shut down: Godot starts a project's autoloads in every script run and cannot be told not to. An error raised in a project script here is that autoload's own, and none of these changes the answer.";
+var BEFORE_OPERATION_NOTE = "Printed while the engine started the project's autoloads, before this operation ran: an operation that compiles the project's scripts waits for them, because the engine knows an autoload's name only once it is in the tree. An error raised in a project script here is that autoload's own.";
 var OWN_ERROR = "[ERROR] ";
 var ANSWERED = "[gdharness] answered";
+var WAITING = "[gdharness] waiting for the autoloads";
+var BEGUN = "[gdharness] begun";
 var MESSAGES_KEPT = 200;
 var ERRORS_NAMED = 3;
 function problemsIn(log) {
@@ -33229,12 +33240,22 @@ async function runOperation(engine, operation, params, projectPath) {
     discard(paramsDir);
   }
   const everything = ran.log.everything();
-  const answered = everything.findIndex((entry) => entry.source === "stderr" && entry.text === ANSWERED);
-  const problems = problemsAmong(answered === -1 ? everything : everything.slice(0, answered));
+  const marked = (text) => everything.findIndex((entry) => entry.source === "stderr" && entry.text === text);
+  const answered = marked(ANSWERED);
+  const waiting = marked(WAITING);
+  const begun = marked(BEGUN);
+  const ended = answered === -1 ? everything.length : answered;
+  const problems = waiting === -1 ? problemsAmong(everything.slice(0, ended)) : problemsAmong([
+    ...everything.slice(0, waiting),
+    ...begun === -1 ? [] : everything.slice(begun + 1, ended)
+  ]);
+  const startup = waiting === -1 ? [] : problemsAmong(everything.slice(waiting + 1, begun === -1 ? ended : begun));
   const after = answered === -1 ? [] : problemsAmong(everything.slice(answered + 1));
   const afterAnswered = {
     ...after.length === 0 ? {} : { afterAnswerMessages: after.slice(-MESSAGES_KEPT) },
-    ...after.length > MESSAGES_KEPT ? { afterAnswerOmitted: after.length - MESSAGES_KEPT } : {}
+    ...after.length > MESSAGES_KEPT ? { afterAnswerOmitted: after.length - MESSAGES_KEPT } : {},
+    ...startup.length === 0 ? {} : { beforeOperationMessages: startup.slice(-MESSAGES_KEPT) },
+    ...startup.length > MESSAGES_KEPT ? { beforeOperationOmitted: startup.length - MESSAGES_KEPT } : {}
   };
   if (answer.kind === "unreadable") {
     return {
@@ -33245,6 +33266,14 @@ async function runOperation(engine, operation, params, projectPath) {
     };
   }
   if (answer.kind === "none") {
+    if (waiting !== -1 && begun === -1) {
+      return {
+        ok: false,
+        message: `${operation} never ran: the engine ended (${howItEnded(ran)}) while it started the project's ` + `autoloads, which this operation waits for. The last it reported: ${reason(ran.log, startup)}`,
+        ...reported2(problems),
+        ...afterAnswered
+      };
+    }
     const refusals = refusalsIn(ran.log);
     if (refusals.length > 0) {
       const said = new Set(refusals.map((entry) => entry.index));
@@ -33686,6 +33715,31 @@ ${note}`;
     return detail === entry.detail ? entry : { ...entry, detail };
   });
 }
+var MOST_REPORTS_SHOWN = 20;
+var LONGEST_DETAIL = 20000;
+function shortened(detail) {
+  if (detail === null || detail.length <= LONGEST_DETAIL) {
+    return detail;
+  }
+  return `${detail.slice(0, LONGEST_DETAIL)}
+[${detail.length - LONGEST_DETAIL} more characters left out]`;
+}
+function foldedReports(reports) {
+  const first = new Map;
+  for (const report of reports) {
+    const key = JSON.stringify([report.kind, report.message, report.detail]);
+    const seen = first.get(key);
+    if (seen === undefined) {
+      first.set(key, { report, times: 1 });
+    } else {
+      seen.times += 1;
+    }
+  }
+  return [...first.values()].map(({ report, times }) => {
+    const kept = { ...report, detail: shortened(report.detail) };
+    return times === 1 ? kept : { ...kept, times };
+  });
+}
 function failedCases(report, printed) {
   const cases = report.suites.flatMap((suite) => suite.cases.filter((entry) => entry.status === "failed" || entry.status === "error").map((entry) => ({ entry, path: suite.path })));
   const read = withActualsPrinted(cases.flatMap(({ entry }) => entry.reports), printed);
@@ -33693,6 +33747,8 @@ function failedCases(report, printed) {
   return cases.map(({ entry, path }) => {
     const reports = read.slice(next, next + entry.reports.length);
     next += entry.reports.length;
+    const folded = foldedReports(reports);
+    const shown = folded.slice(0, MOST_REPORTS_SHOWN);
     return {
       suite: entry.suite,
       name: entry.name,
@@ -33700,11 +33756,34 @@ function failedCases(report, printed) {
       time: entry.time,
       path,
       message: reports[0]?.message ?? null,
-      detail: reports[0]?.detail ?? null,
-      ...reports.length > 1 ? { reports } : {}
+      detail: shortened(reports[0]?.detail ?? null),
+      ...reports.length > 1 ? { reports: shown, reportCount: reports.length } : {},
+      ...folded.length > shown.length ? { reportsLeftOut: folded.length - shown.length } : {}
     };
   });
 }
+function failedWithin(failed, budget) {
+  const sizes = failed.map((entry) => JSON.stringify(entry).length);
+  const smallestFirst = sizes.map((_, index) => index).sort((a, b) => (sizes[a] ?? 0) - (sizes[b] ?? 0));
+  const whole = new Set;
+  let spent = 0;
+  for (const index of smallestFirst) {
+    const size = sizes[index] ?? 0;
+    if (spent + size > budget) {
+      break;
+    }
+    spent += size;
+    whole.add(index);
+  }
+  const kept = failed.map((entry, index) => {
+    if (whole.has(index)) {
+      return entry;
+    }
+    const { detail: _detail, reports: _reports, reportsLeftOut: _left, ...named } = entry;
+    return { ...named, message: entry.message?.slice(0, 500) ?? null, detail: null };
+  });
+  return { failed: kept, briefed: failed.length - whole.size };
+}
 var MASKED_BRACKET = "[lb]";
 function masked(expected, actual) {
   const allSpelled = (value) => !PRINTED_DICTIONARY.test(value) && value.split("[").length === value.split(MASKED_BRACKET).length;
@@ -34899,6 +34978,8 @@ var SCENE_PATH = {
   type: "string",
   description: 'Scene file inside the project, such as "scenes/main.tscn" or "res://scenes/main.tscn".'
 };
+var WITHOUT_AN_EDITOR = "Through the editor when one serves the project; with none, a headless engine runs the editor's own tool and the answer says so under writtenBy, or readBy for a read. That engine runs every script of the file, where the editor runs only tool scripts, so what a script changes as the file loads or as a property is set is put back before anything is saved, and a file where that cannot be done, such as a scene whose script does not compile, is refused and nothing is written. An editor of the project that is running and has not reached this server is waited for rather than written around.";
+var WHOLE_NUMBERS = 'A whole number of 2^53 or more, such as a 64-bit seed or a resource uid, is written as its digits, {"_type": "int", "value": "9007199254740993"}, the form a read answers with: a JSON number that large can arrive as a neighbour of the one sent, so sent as a number it is refused.';
 var SCRIPT_PATH = {
   type: "string",
   description: 'Script file inside the project, such as "scripts/player.gd".'
@@ -34911,7 +34992,7 @@ var NODE_PATH = {
 };
 var PROPERTIES = {
   type: "object",
-  description: 'Properties to set, keyed by Godot property name. Vectors, colours and the like may be written as {"x": 1, "y": 2} or tagged {"_type": "Vector2", "x": 1, "y": 2}, which is the form a read answers with, so a value read off one node can be written straight to another. A key may also be a colon path into one of the components of a vector, a colour, a rectangle or a transform, as GDScript names them, so one axis is written alone: "position:x", "modulate:a", "region_rect:size:y"; a component the value does not have is refused, naming the ones it has. A property holding a node takes the path to it from the node being set, such as "../Player". Each value is read back once set, and one the engine changed or refused is refused with what it holds.',
+  description: `Properties to set, keyed by Godot property name. Vectors, colours and the like may be written as {"x": 1, "y": 2} or tagged {"_type": "Vector2", "x": 1, "y": 2}, which is the form a read answers with, so a value read off one node can be written straight to another. A key may also be a colon path into one of the components of a vector, a colour, a rectangle or a transform, as GDScript names them, so one axis is written alone: "position:x", "modulate:a", "region_rect:size:y"; a component the value does not have is refused, naming the ones it has. A property holding a node takes the path to it from the node being set, such as "../Player". Each value is read back once set, and one the engine changed or refused is refused with what it holds. ${WHOLE_NUMBERS}`,
   additionalProperties: true
 };
 var XY = {
@@ -34955,7 +35036,10 @@ var SCRIPT_MODIFICATIONS = {
       name: { type: "string" },
       params: { type: "string", description: 'Functions and signals: the parameter list, "delta: float".' },
       returnType: { type: "string", description: "Functions: the return type." },
-      body: { type: "string", description: "Functions: the body." },
+      body: {
+        type: "string",
+        description: "Functions: the body, its lines separated by \\n. Indent shared by every line is taken off and one tab put on, so it can be written indented or not."
+      },
       varType: {
         type: "string",
         description: "Variables and constants: the type annotation; without one, the type the value evaluates to."
@@ -35058,7 +35142,7 @@ var TOOL_SPECS = [
   {
     name: "project_settings",
     title: "Project settings",
-    description: "Reads or writes project.godot: settings, autoloads, the main scene, input actions, plugins and audio buses. A write with an editor open on the project is handed to the editor, which takes the settings the write changed or names from the file (named under editorAdopted), including a setting the file already held, since the editor can hold another value after the file was put back, or reloads the bus layout, so it answers the new values and does not save the old ones back over them. editorNote is an editor that could not take the write, one on an addon from before this, which still holds the old values until editor_launch restart. An enabled plugin's code still loads on the editor's next start. set answers old_value and new_value, with was_new true when project.godot did not set the setting before, and was_default true when what it held was the engine's own default, which old_value then is. add_input_action on an action that exists, one of the engine's ui_ actions included, replaces its events and deadzone, and answers was_new false with what it held under old_events and old_deadzone. A set of the value the setting already holds, in the same type, writes nothing and answers unchanged true and saved false. Every write keeps the sections and keys of project.godot in the order the file had them, so a change touches only its own lines. get answers exists, true for any setting the engine knows, and at_default, true when the value is the engine's own default and so has no line in project.godot. Each setting under prefix carries at_default too, so a family read separates what the project sets from the engine's defaults; it is absent for a setting the engine registers no default for, such as an input action the project added, which only the project can have set.",
+    description: "Reads or writes project.godot: settings, autoloads, the main scene, input actions, plugins and audio buses. A write with an editor open on the project is handed to the editor, which takes the settings the write changed or names from the file (named under editorAdopted), including a setting the file already held, since the editor can hold another value after the file was put back, or reloads the bus layout, so it answers the new values and does not save the old ones back over them. editorNote is an editor that could not take the write, one on an addon from before this, which still holds the old values until editor_launch restart. An enabled plugin's code still loads on the editor's next start. set answers old_value and new_value, with was_new true when project.godot did not set the setting before, and was_default true when what it held was the engine's own default, which old_value then is. add_input_action on an action that exists, one of the engine's ui_ actions included, replaces its events and deadzone, and answers was_new false with what it held under old_events and old_deadzone. A set of the value the setting already holds, in the same type, writes nothing and answers unchanged true and saved false. Every write keeps the sections and keys of project.godot in the order the file had them, so a change moves no other line; the save is the engine's, and like the editor's it writes Godot's header and config/features into a file that lacks them. get answers exists, true for any setting the engine knows, and at_default, true when the value is the engine's own default and so has no line in project.godot. Each setting under prefix carries at_default too, so a family read separates what the project sets from the engine's defaults; it is absent for a setting the engine registers no default for, such as an input action the project added, which only the project can have set.",
     parameters: {
       projectPath: PROJECT_PATH2,
       setting: {
@@ -35236,24 +35320,32 @@ var TOOL_SPECS = [
     description: "The import pipeline: what needs importing, how a resource is imported, reimports, UIDs, and the global class list the editor and the engine read.",
     parameters: {
       projectPath: PROJECT_PATH2,
-      resourcePath: RESOURCE_PATH,
+      resourcePath: { ...RESOURCE_PATH, ops: ["status", "options", "set_options", "uid", "reimport"] },
       includeUpToDate: {
         type: "boolean",
+        ops: ["status"],
         description: "status: list resources that are current as well. Default false."
       },
       options: {
         type: "object",
+        ops: ["set_options"],
         description: `set_options: import options keyed as the .import file spells them, {"compress/mode": 1}. A dictionary option whose keys are numbers, a font's opentype_features or any option already holding number keys, takes them written as strings of digits, and opentype_features also takes an OpenType tag by its four-letter name: {"opentype_features": {"liga": 0}} turns ligatures off. Both are written as the numbers the engine reads.`,
         additionalProperties: true
       },
       reimport: {
         type: "boolean",
+        ops: ["set_options"],
         description: "set_options: reimport afterwards, answered under reimport as project_import reimport answers. Default true."
       },
-      force: { type: "boolean", description: "reimport: reimport even what is current. Default false." },
+      force: {
+        type: "boolean",
+        ops: ["reimport"],
+        description: "reimport: reimport even what is current. Default false."
+      },
       timeoutMs: {
         type: "integer",
         minimum: 1,
+        ops: ["reimport", "set_options"],
         description: "reimport, set_options: how long to wait for the editor to finish reimporting. Default 300000."
       }
     },
@@ -35331,7 +35423,7 @@ var TOOL_SPECS = [
     name: "project_test",
     title: "Run tests",
     effect: "additive",
-    description: "Runs the project's gdUnit4 tests headless and answers with every case that did not pass: where it is, and what the assertion said. Each entry under failed carries its first report as message and detail, and, when it has more than one, every report under reports in the order the case met them: gdUnit4 goes on past a failed assertion, and a case can fail several and then stop on a runtime error, which makes its status error. failures counts the cases that failed an assertion and errors the cases that hit an error, so such a case counts in both. Suites where everything passed are counted rather than listed, and an engine message keeps the frames above gdUnit4 rather than the twenty inside it, so a clean tier answers in a few lines; identical engine messages come back once under engineEntries, with times saying how often they were printed, and engineErrors counts every one. The class list is rebuilt first, so a suite written a moment ago is found, and the rebuild's answer is under classes, with the classes each addon declares counted under addedInAddons and changedInAddons rather than named: a class it puts back that the cache had after the last rebuild is named under classes.lostSinceLastRebuild, which is the editor writing its shorter list over the file on every save until restarted. On Windows and Linux the run gets a user:// of its own, so a suite that saves a game writes nowhere near the saves of the copy somebody plays. On macOS the engine reads user:// off HOME and the run writes where the player keeps theirs, which the answer says under savesNote rather than leaving to be found in a save list. A run that found nothing to run is never called a pass: gdUnit4 exits cleanly for one, so the answer says so and names the path it looked in. A script that does not load stops gdUnit4 before any suite runs: its errors come back in full under scriptErrors, and the scripts that failed only because one they depend on did are listed by path under failedThroughDependency. When they failed on a class whose own script has a parser error, which gdUnit4 never names, that script is checked by the engine and its error comes first under scriptErrors, with the class it declares under declares, and the errors a script has only because that class did not resolve, which the engine reads as Variant, are kept apart under followFromUnresolved. A client that sends a progress token is told as each suite finishes, and at least every twenty seconds through a long one, so an idle limit does not end a long tier. A run that ends without a report, at its timeout or otherwise, names the suites it finished under suitesFinished, the failing ones with their failed cases under suitesFailing, and the one it was in under suiteRunning. When a client cuts a run off, that is kept in the project and the next project_test there carries it under previousRunCut. A run where nothing failed but nodes were left in the tree comes back under warnings, with the count per suite: gdUnit4 decides its verdict on those and keeps them out of its report, so they are read off what it printed. A run whose every case passed is still not called passed when it printed a script error that no case failed on: gdUnit4 fails a case on the script errors its logger sees, and it cannot see a stack overflow, so the cases pass on whatever the faulted calls returned. Those errors come back under uncaughtScriptErrors, and under engineEntries by index with detailUnder rather than with their backtrace a second time; a backtrace that repeats, as a recursion's does, has each repeated frame or cycle of frames written once with the frames it covers and how many times. One raised inside assert_error(...).is_runtime_error is the test's own and does not count, and none count when the project turns off gdUnit4's report/godot/script_error setting. Needs gdUnit4 under addons/gdUnit4.",
+    description: "Runs the project's gdUnit4 tests headless and answers with every case that did not pass: where it is, and what the assertion said. Each entry under failed carries its first report as message and detail, and, when it has more than one, its reports under reports in the order the case met them: gdUnit4 goes on past a failed assertion, and a case can fail several and then stop on a runtime error, which makes its status error. Identical reports fold into one with times, at most twenty different ones are kept (reportsLeftOut counts the rest), and past about a megabyte the largest cases keep only their first message (failedWithoutDetail). failures counts the cases that failed an assertion and errors the cases that hit an error, so such a case counts in both. Suites where everything passed are counted rather than listed, and an engine message keeps the frames above gdUnit4 rather than the twenty inside it, so a clean tier answers in a few lines; identical engine messages come back once under engineEntries, with times saying how often they were printed, and engineErrors counts every one. The class list is rebuilt first, so a suite written a moment ago is found, and the rebuild's answer is under classes, with the classes each addon declares counted under addedInAddons and changedInAddons rather than named: a class it puts back that the cache had after the last rebuild is named under classes.lostSinceLastRebuild, which is the editor writing its shorter list over the file on every save until restarted. On Windows and Linux the run gets a user:// of its own, so a suite that saves a game writes nowhere near the saves of the copy somebody plays. On macOS the engine reads user:// off HOME and the run writes where the player keeps theirs, which the answer says under savesNote rather than leaving to be found in a save list. A run that found nothing to run is never called a pass: gdUnit4 exits cleanly for one, so the answer says so and names the path it looked in. A script that does not load stops gdUnit4 before any suite runs: its errors come back in full under scriptErrors, and the scripts that failed only because one they depend on did are listed by path under failedThroughDependency. When they failed on a class whose own script has a parser error, which gdUnit4 never names, that script is checked by the engine and its error comes first under scriptErrors, with the class it declares under declares, and the errors a script has only because that class did not resolve, which the engine reads as Variant, are kept apart under followFromUnresolved. A client that sends a progress token is told as each suite finishes, and at least every twenty seconds through a long one, so an idle limit does not end a long tier. A run that ends without a report, at its timeout or otherwise, names the suites it finished under suitesFinished, the failing ones with their failed cases under suitesFailing, and the one it was in under suiteRunning. When a client cuts a run off, that is kept in the project and the next project_test there carries it under previousRunCut. A run where nothing failed but nodes were left in the tree comes back under warnings, with the count per suite: gdUnit4 decides its verdict on those and keeps them out of its report, so they are read off what it printed. A run whose every case passed is still not called passed when it printed a script error that no case failed on: gdUnit4 fails a case on the script errors its logger sees, and it cannot see a stack overflow, so the cases pass on whatever the faulted calls returned. Those errors come back under uncaughtScriptErrors, and under engineEntries by index with detailUnder rather than with their backtrace a second time; a backtrace that repeats, as a recursion's does, has each repeated frame or cycle of frames written once with the frames it covers and how many times. One raised inside assert_error(...).is_runtime_error is the test's own and does not count, and none count when the project turns off gdUnit4's report/godot/script_error setting. Needs gdUnit4 under addons/gdUnit4.",
     parameters: {
       projectPath: PROJECT_PATH2,
       path: {
@@ -35368,7 +35460,7 @@ var TOOL_SPECS = [
   {
     name: "scene_create",
     title: "Create or save a scene",
-    description: "Creates a scene file where none is, saves one, or saves a copy under a new path. A save of a scene open in the editor saves the editor's copy, unsaved changes included. Needs the editor connected.",
+    description: `Creates a scene file where none is, saves one, or saves a copy under a new path. A save of a scene open in the editor saves the editor's copy, unsaved changes included. ${WITHOUT_AN_EDITOR}`,
     parameters: {
       projectPath: PROJECT_PATH2,
       scenePath: SCENE_PATH,
@@ -35413,17 +35505,19 @@ var TOOL_SPECS = [
   {
     name: "scene_node",
     title: "Scene nodes",
-    description: "One node in a scene file: add, read, set, duplicate, reparent or delete it, or paint TileMap cells. Any ClassDB node type can be added, so a NavigationRegion2D, an AnimationTree or a Camera3D is an add with that nodeType and its properties, and another scene is instanced by an add with instancePath. set with name renames a node. A property holding a Resource takes the res:// path of one, so a texture, a material or a theme is a set like any other. A write is refused while the editor holds unsaved changes to the scene, and for a node that belongs to a scene this one instances or inherits. Needs the editor connected.",
+    description: `One node in a scene file: add, read, set, duplicate, reparent or delete it, or paint TileMap cells. Any ClassDB node type can be added, so a NavigationRegion2D, an AnimationTree or a Camera3D is an add with that nodeType and its properties, and another scene is instanced by an add with instancePath. A set with properties {"name": "Boss"} renames a node. A property holding a Resource takes the res:// path of one, so a texture, a material or a theme is a set like any other. A write is refused while the editor holds unsaved changes to the scene, and for a node that belongs to a scene this one instances or inherits. ${WITHOUT_AN_EDITOR}`,
     parameters: {
       projectPath: PROJECT_PATH2,
       scenePath: SCENE_PATH,
-      nodePath: NODE_PATH,
+      nodePath: { ...NODE_PATH, ops: ["get", "set", "duplicate", "reparent", "delete", "set_tilemap_cells"] },
       parentNodePath: {
         type: "string",
+        ops: ["add", "duplicate"],
         description: "add: where the node goes. Default the root. duplicate: where the copy goes."
       },
       nodeType: {
         type: "string",
+        ops: ["add"],
         description: 'add: the node class, such as "CharacterBody2D". Give this or instancePath.'
       },
       instancePath: {
@@ -35431,11 +35525,12 @@ var TOOL_SPECS = [
         ops: ["add"],
         description: `add: a scene to instance as the new node instead of a class, such as "ui/panel.tscn". It is saved as an instance of that file, the way the editor's Instantiate Child Scene saves one, so changes to that scene reach it; properties set its root. A scene that is the target or instances it is refused.`
       },
-      nodeName: { type: "string", description: "add: the new node's name." },
-      properties: PROPERTIES,
-      newName: { type: "string", description: "duplicate: the copy's name." },
+      nodeName: { type: "string", ops: ["add"], description: "add: the new node's name." },
+      properties: { ...PROPERTIES, ops: ["add", "set"] },
+      newName: { type: "string", ops: ["duplicate"], description: "duplicate: the copy's name." },
       newParentPath: {
         type: "string",
+        ops: ["reparent"],
         description: "reparent: the new parent, which may be the one it has, to move it among its siblings."
       },
       index: {
@@ -35446,13 +35541,15 @@ var TOOL_SPECS = [
       },
       includeDefaults: {
         type: "boolean",
+        ops: ["get"],
         description: "get: include properties still at their default. Default false."
       },
       layer: {
         type: "number",
+        ops: ["set_tilemap_cells"],
         description: "set_tilemap_cells: the layer of a TileMap. Default 0. A TileMapLayer is one layer."
       },
-      cells: TILEMAP_CELLS
+      cells: { ...TILEMAP_CELLS, ops: ["set_tilemap_cells"] }
     },
     requires: ["projectPath", "scenePath"],
     operations: {
@@ -35492,16 +35589,32 @@ var TOOL_SPECS = [
   {
     name: "scene_signal",
     title: "Scene signals",
-    description: "Signal connections in a scene file. Each connection answers with its flags as the number and as flagNames; persist is on every connection, since a scene saves no other kind. A connect of a pair already connected says alreadyConnected, with flagsBefore when it changed the flags. Needs the editor connected.",
+    description: `Signal connections in a scene file. Each connection answers with its flags as the number and as flagNames; persist is on every connection, since a scene saves no other kind. A connect of a pair already connected says alreadyConnected, with flagsBefore when it changed the flags. ${WITHOUT_AN_EDITOR}`,
     parameters: {
       projectPath: PROJECT_PATH2,
       scenePath: SCENE_PATH,
-      sourceNodePath: { type: "string", description: "The node that emits." },
-      signalName: { type: "string", description: 'The signal it emits, such as "pressed".' },
-      targetNodePath: { type: "string", description: "The node whose method is called." },
-      methodName: { type: "string", description: "The method on that node, called when it emits." },
-      flags: { type: "number", description: "connect: Object.ConnectFlags, such as 1 for deferred." },
-      nodePath: { type: "string", description: "list: only connections involving this node." }
+      sourceNodePath: { type: "string", ops: ["connect", "disconnect"], description: "The node that emits." },
+      signalName: {
+        type: "string",
+        ops: ["connect", "disconnect"],
+        description: 'The signal it emits, such as "pressed".'
+      },
+      targetNodePath: {
+        type: "string",
+        ops: ["connect", "disconnect"],
+        description: "The node whose method is called."
+      },
+      methodName: {
+        type: "string",
+        ops: ["connect", "disconnect"],
+        description: "The method on that node, called when it emits."
+      },
+      flags: {
+        type: "number",
+        ops: ["connect"],
+        description: "connect: Object.ConnectFlags, such as 1 for deferred."
+      },
+      nodePath: { type: "string", ops: ["list"], description: "list: only connections involving this node." }
     },
     requires: ["projectPath", "scenePath"],
     operations: {
@@ -35626,18 +35739,28 @@ var TOOL_SPECS = [
     parameters: {
       projectPath: PROJECT_PATH2,
       scriptPath: SCRIPT_PATH,
-      className: { type: "string", description: "create: a class_name for the script. Not with content." },
-      extends: { type: "string", description: "create: the base class. Default Node. Not with content." },
+      className: {
+        type: "string",
+        ops: ["create"],
+        description: "create: a class_name for the script. Not with content."
+      },
+      extends: {
+        type: "string",
+        ops: ["create"],
+        description: "create: the base class. Default Node. Not with content."
+      },
       content: {
         type: "string",
+        ops: ["create"],
         description: "create: the whole file, written as given, instead of a template, className and extends."
       },
       template: {
         type: "string",
         enum: ["singleton", "state_machine", "component", "resource"],
+        ops: ["create"],
         description: "create: a starting shape."
       },
-      modifications: SCRIPT_MODIFICATIONS,
+      modifications: { ...SCRIPT_MODIFICATIONS, ops: ["modify"] },
       symbol: {
         type: "string",
         ops: ["rename"],
@@ -35675,16 +35798,19 @@ var TOOL_SPECS = [
       scriptPath: SCRIPT_PATH,
       includeInherited: {
         type: "boolean",
+        ops: ["structure"],
         description: "structure: also list what the script inherits, walking extends through the project's other scripts. Each such member carries inherited_from, the file declaring it, and the answer gains inherits_from, the chain that was walked. A name the script overrides is listed at both its lines rather than once. A native base is not walked, since it declares nothing in a file: editor_classes info answers for those. Default false."
       },
       line: {
         type: "integer",
         minimum: 1,
+        ops: ["completion", "hover"],
         description: "completion, hover: the line, counted from 1 as the editor shows it."
       },
       character: {
         type: "integer",
         minimum: 1,
+        ops: ["completion", "hover"],
         description: "completion, hover: the column, counted from 1 as the editor shows it, with a tab counted as one. symbols gives each name at the line and column hover is asked at."
       }
     },
@@ -35692,7 +35818,7 @@ var TOOL_SPECS = [
     operations: {
       structure: {
         effect: "read",
-        summary: "functions, variables, signals, class_name and extends, read from the file, and dependencies: the paths it loads or preloads as written, then the scripts declaring each project class_name its code uses, which classes_used names with the class",
+        summary: "functions, variables, signals, class_name and extends, read from the file, and dependencies: the paths it loads or preloads as written, then the scripts declaring each project class_name its code uses, which classes_used names with the class; autoloads_used names each autoload the code uses by its global name, with the autoload's script, which the project loads rather than this script, so it is not under dependencies",
         requires: []
       },
       symbols: {
@@ -35727,7 +35853,7 @@ var TOOL_SPECS = [
   {
     name: "resource_edit",
     title: "Edit resources",
-    description: 'Resource files: read one, create any ClassDB resource as .tres, change one, write a shader, build a TileSet, or set a Theme colour or font size. A material is a create with resourceType StandardMaterial3D, ShaderMaterial or CanvasItemMaterial. read answers with the properties the file sets, in the form modify takes, and a Theme lists its items there as "Button/colors/font_color". move takes any file of the project, a script or an image as much as a resource, or a directory, and works from the files, so it needs no editor; one serving the project is brought up to it as after a move in its own FileSystem dock, its open scenes and cached resources named for the new paths and the project settings the move rewrote taken from the file. read needs no editor either: with none serving the project, a headless engine reads the file. The ops that write a resource need the editor connected.',
+    description: 'Resource files: read one, create any ClassDB resource as .tres, change one, write a shader, build a TileSet, or set a Theme colour or font size. A material is a create with resourceType StandardMaterial3D, ShaderMaterial or CanvasItemMaterial. read answers with the properties the file sets, in the form modify takes, and a Theme lists its items there as "Button/colors/font_color". move takes any file of the project, a script or an image as much as a resource, or a directory, and works from the files, so it needs no editor; one serving the project is brought up to it as after a move in its own FileSystem dock, its open scenes and cached resources named for the new paths and the project settings the move rewrote taken from the file. read needs no editor either: with none serving the project, a headless engine reads the file. The ops that write a resource go through the editor when one serves the project; with none, a headless engine runs the tool the editor would and the answer says so under writtenBy. That engine runs the script of the resource, where the editor runs only tool scripts, so what a script changes as the file loads or as a property is set is put back before the save, and a resource where that cannot be done is refused and the file left as it was.',
     parameters: {
       projectPath: PROJECT_PATH2,
       resourcePath: {
@@ -36078,9 +36204,10 @@ var TOOL_SPECS = [
     description: "The engine's ClassDB: find classes, read one in full, or walk an inheritance tree.",
     parameters: {
       projectPath: PROJECT_PATH2,
-      filter: { type: "string", description: "query: a substring of the class name." },
+      filter: { type: "string", ops: ["query"], description: "query: a substring of the class name." },
       category: {
         type: "string",
+        ops: ["query"],
         enum: [
           "node",
           "node2d",
@@ -36097,9 +36224,21 @@ var TOOL_SPECS = [
         ],
         description: "query: limit to one family."
       },
-      instantiableOnly: { type: "boolean", description: "query: leave out abstract classes. Default false." },
-      className: { type: "string", description: "info, inheritance: the class." },
-      includeInherited: { type: "boolean", description: "info: include inherited members. Default false." },
+      instantiableOnly: {
+        type: "boolean",
+        ops: ["query"],
+        description: "query: leave out abstract classes. Default false."
+      },
+      className: {
+        type: "string",
+        ops: ["info", "inheritance"],
+        description: "info, inheritance: the class."
+      },
+      includeInherited: {
+        type: "boolean",
+        ops: ["info"],
+        description: "info: include inherited members. Default false."
+      },
       member: {
         type: "string",
         ops: ["info"],
@@ -36253,7 +36392,7 @@ var TOOL_SPECS = [
       value: {
         ops: ["set"],
         blank: true,
-        description: `set: the value, fitted to the property's type. A number the property would have to cut is refused rather than truncated: a fraction into an int, a number other than 0 or 1 into a bool. A vector, colour or the like may be written as its fields, {"x": 140, "y": 300}, or tagged, {"_type": "Vector2", "x": 140, "y": 300}, which is the form a read answers with. "" writes an empty string. A property typed as or holding an object takes a path naming one the game holds, the way call's args do, and holds that instance, or null, which the text null also means, to empty it. One declared as Variant or untyped takes anything, as the engine does: a value of the kind it holds is fitted to it, an int staying an int, and any other is stored as sent, a fraction into one holding an int included. A typed list or map, such as Array[int] or Dictionary[String, int], takes a JSON list or object with each element fitted to its element type, and an element that cannot become one is refused by its index or key, as is an object of another script than the one the list holds, whether or not that script has a class_name.`
+        description: `set: the value, fitted to the property's type. ${WHOLE_NUMBERS} A number the property would have to cut is refused rather than truncated: a fraction into an int, a number other than 0 or 1 into a bool. A vector, colour or the like may be written as its fields, {"x": 140, "y": 300}, or tagged, {"_type": "Vector2", "x": 140, "y": 300}, which is the form a read answers with. "" writes an empty string. A property typed as or holding an object takes a path naming one the game holds, the way call's args do, and holds that instance, or null, which the text null also means, to empty it. One declared as Variant or untyped takes anything, as the engine does: a value of the kind it holds is fitted to it, an int staying an int, and any other is stored as sent, a fraction into one holding an int included. A typed list or map, such as Array[int] or Dictionary[String, int], takes a JSON list or object with each element fitted to its element type, and an element that cannot become one is refused by its index or key, as is an object of another script than the one the list holds, whether or not that script has a class_name.`
       },
       method: {
         type: "string",
@@ -36263,7 +36402,7 @@ var TOOL_SPECS = [
       args: {
         type: "array",
         ops: ["call"],
-        description: `call: the arguments, fitted to the method's parameter types. A number a parameter would have to cut is refused rather than truncated: a fraction for an int, a number other than 0 or 1 for a bool. A vector, colour or the like may be written as its fields, {"x": 140, "y": 300}, or tagged, {"_type": "Vector2", "x": 140, "y": 300}. A parameter typed as an object takes a path naming one the game holds and is handed that instance: a colon path read from nodePath, "_game:run:wares:3", or one starting at a node, "/root/Main/Hud" or "/root/Main:_game:run". A path that reaches no object, or an object of another class than the parameter declares, is refused, and so are too few or too many arguments. The engine names a parameter typed as a script class without class_name by the class the script extends, so an object of that class with another script passes that check and the engine refuses the call: the answer says the method did not run, with the engine's reason. A parameter typed as a list or map, such as Array[int] or Array[Gear], is built from a JSON list or object element by element, objects named by their paths. The method itself takes its arguments here only: brackets on it holding arguments are refused.`
+        description: `call: the arguments, fitted to the method's parameter types. An RID is passed as the {"_type": "RID", "id": ...} a read answers it with, such as a viewport's for RenderingServer's render timing. ${WHOLE_NUMBERS} A number a parameter would have to cut is refused rather than truncated: a fraction for an int, a number other than 0 or 1 for a bool. A vector, colour or the like may be written as its fields, {"x": 140, "y": 300}, or tagged, {"_type": "Vector2", "x": 140, "y": 300}. A parameter typed as an object takes a path naming one the game holds and is handed that instance: a colon path read from nodePath, "_game:run:wares:3", or one starting at a node, "/root/Main/Hud" or "/root/Main:_game:run". A path that reaches no object, or an object of another class than the parameter declares, is refused, and so are too few or too many arguments. The engine names a parameter typed as a script class without class_name by the class the script extends, so an object of that class with another script passes that check and the engine refuses the call: the answer says the method did not run, with the engine's reason. A parameter typed as a list or map, such as Array[int] or Array[Gear], is built from a JSON list or object element by element, objects named by their paths. The method itself takes its arguments here only: brackets on it holding arguments are refused.`
       },
       properties: {
         type: ["boolean", "array"],
@@ -36992,6 +37131,8 @@ function argumentShape(schema) {
 // src/server.ts
 var UPDATE_NOTICE_EVERY = 500;
 var FEEDBACK_NOTICE_EVERY = 250;
+var FAILED_BUDGET = 1e6;
+var ANSWER_BUDGET = 4000000;
 var __dirname2 = dirname18(fileURLToPath4(import.meta.url));
 var PARENT_ASKED_AFTER_MS = 5000;
 function editorRestartTimeoutMs() {
@@ -38364,6 +38505,7 @@ class GodotServer {
   inFlight = new Map;
   callsOnGames = new Set;
   callsTaken = 0;
+  answersDirectory;
   clientNoted = null;
   parentCommand = null;
   endNoted = false;
@@ -38762,12 +38904,66 @@ class GodotServer {
       this.inFlight.set(call, { tool: spec.name, op: checked.op ?? "", startedAt: Date.now() });
       try {
         const answer = await withCallSignal(ctx.mcpReq.signal, () => this.answered(spec.name, checked.op ?? "", args), progress);
-        return this.withFeedbackNotice(this.withUpdateNotice(answer));
+        return this.withinTheClientsLimit(spec.name, this.withFeedbackNotice(this.withUpdateNotice(answer)));
       } finally {
         this.inFlight.delete(call);
       }
     });
   }
+  withinTheClientsLimit(tool, answer) {
+    const sizeOf = (item) => item.type === "text" ? Buffer.byteLength(item.text) : item.data.length;
+    const bytes = answer.content.reduce((sum, item) => sum + sizeOf(item), 0);
+    if (bytes <= ANSWER_BUDGET) {
+      return answer;
+    }
+    this.answersDirectory ??= scratchDirectory("answers");
+    const directory = this.answersDirectory;
+    const stem = `${tool}-${Date.now()}`;
+    let savedAt;
+    let notSaved;
+    try {
+      savedAt = answer.content.map((item, index) => {
+        const file = join26(directory, item.type === "text" ? `${stem}-${index}.txt` : `${stem}-${index}.${item.mimeType.split("/")[1] ?? "bin"}`);
+        writeFileSync16(file, item.type === "text" ? item.text : Buffer.from(item.data, "base64"));
+        return file;
+      });
+    } catch (error) {
+      notSaved = errorMessage(error);
+    }
+    const first = answer.content[0];
+    let parsed = null;
+    try {
+      parsed = first?.type === "text" ? JSON.parse(first.text) : null;
+    } catch {}
+    const small = {};
+    const leftOut = [];
+    if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+      for (const [key, value] of Object.entries(parsed)) {
+        if (JSON.stringify(value).length <= 2000) {
+          small[key] = value;
+        } else {
+          leftOut.push(key);
+        }
+      }
+    }
+    return {
+      ...answer,
+      content: [
+        {
+          type: "text",
+          text: answerJson({
+            ...small,
+            answerTooLarge: {
+              bytes,
+              savedAt,
+              leftOut: leftOut.length > 0 ? leftOut : undefined,
+              note: savedAt === undefined ? `The answer was ${bytes} bytes, past the ${ANSWER_BUDGET} this server sends in one message (Claude Code closes the connection past 16 MB), and writing it to a file failed: ${notSaved ?? "no reason given"}. The fields of its top level that are short are kept here.` : `The answer was ${bytes} bytes, past the ${ANSWER_BUDGET} this server sends in one message (Claude Code closes the connection past 16 MB), so it was written whole to savedAt; read it from there. The fields of its top level that are short are kept here. The files are removed once this server has stopped.`
+            }
+          })
+        }
+      ]
+    };
+  }
   async answered(tool, op, args) {
     try {
       return await this.dispatch(tool, op, args);
@@ -39019,6 +39215,7 @@ class GodotServer {
       const contained = this.containProjectFiles({ ...arguments_, ...extra });
       return contained.ok ? await this.handleViaBridge(command, contained.value, op === "" ? tool : `${tool} ${op}`) : contained.response;
     };
+    const editorOrEngine = async (command, effect, extra = {}) => await this.editorOrEngine(command, { ...arguments_, ...extra }, `${tool} ${op}`, effect);
     switch (tool) {
       case "project_info":
         return await this.handleProjectInfo(args);
@@ -39031,7 +39228,7 @@ class GodotServer {
       case "project_test":
         return await this.handleRunTests(args);
       case "scene_create":
-        return op === "create" ? await bridge("create_scene") : await bridge("save_scene");
+        return op === "create" ? await editorOrEngine("create_scene", "writes") : await editorOrEngine("save_scene", "writes");
       case "scene_tree":
         return await this.readFromFile(args, "scenePath", "read_scene_tree", (file) => ({
           scenePath: file,
@@ -39041,28 +39238,28 @@ class GodotServer {
       case "scene_node":
         switch (op) {
           case "add":
-            return await bridge("add_node");
+            return await editorOrEngine("add_node", "writes");
           case "get":
-            return await bridge("get_node_properties");
+            return await editorOrEngine("get_node_properties", "reads");
           case "set":
-            return await bridge("set_node_properties");
+            return await editorOrEngine("set_node_properties", "writes");
           case "duplicate":
-            return await bridge("duplicate_node", { parentPath: args["parentNodePath"] });
+            return await editorOrEngine("duplicate_node", "writes", { parentPath: args["parentNodePath"] });
           case "reparent":
-            return await bridge("reparent_node");
+            return await editorOrEngine("reparent_node", "writes");
           case "delete":
-            return await bridge("delete_node");
+            return await editorOrEngine("delete_node", "writes");
           default:
-            return await bridge("set_tilemap_cells", { tilemapNodePath: args["nodePath"] });
+            return await editorOrEngine("set_tilemap_cells", "writes", { tilemapNodePath: args["nodePath"] });
         }
       case "scene_signal":
         switch (op) {
           case "connect":
-            return await bridge("connect_signal");
+            return await editorOrEngine("connect_signal", "writes");
           case "disconnect":
-            return await bridge("disconnect_signal");
+            return await editorOrEngine("disconnect_signal", "writes");
           default:
-            return await bridge("list_connections");
+            return await editorOrEngine("list_connections", "reads");
         }
       case "scene_animation":
         switch (op) {
@@ -39113,17 +39310,17 @@ class GodotServer {
             }), async () => await bridge("read_resource", kept));
           }
           case "create":
-            return await bridge("create_resource");
+            return await editorOrEngine("create_resource", "writes");
           case "modify":
-            return await bridge("modify_resource");
+            return await editorOrEngine("modify_resource", "writes");
           case "create_shader":
-            return await bridge("create_shader", { shaderPath: args["resourcePath"] });
+            return await editorOrEngine("create_shader", "writes", { shaderPath: args["resourcePath"] });
           case "create_tileset":
-            return await bridge("create_tileset", { tilesetPath: args["resourcePath"] });
+            return await editorOrEngine("create_tileset", "writes", { tilesetPath: args["resourcePath"] });
           case "set_theme_color":
-            return await bridge("set_theme_color", { themePath: args["resourcePath"] });
+            return await editorOrEngine("set_theme_color", "writes", { themePath: args["resourcePath"] });
           default:
-            return await bridge("set_theme_font_size", { themePath: args["resourcePath"] });
+            return await editorOrEngine("set_theme_font_size", "writes", { themePath: args["resourcePath"] });
         }
       case "editor_launch":
         if (op === "close") {
@@ -39989,6 +40186,10 @@ class GodotServer {
     if (unknown.length > 0) {
       return this.createErrorResponse(`project_info cannot include ${unknown.join(", ")}. Sections: ${Object.keys(PROJECT_INFO_SECTIONS2).join(", ")}.`);
     }
+    const forValidation = ["preset", "detail"].filter((name) => args[name] !== undefined);
+    if (forValidation.length > 0 && !include.includes("validation")) {
+      return this.createErrorResponse(`${forValidation.join(" and ")} ${forValidation.length === 1 ? "is" : "are"} read only by the validation section, which this call does not include: add "validation" to include, or leave ${forValidation.length === 1 ? "it" : "them"} out.`);
+    }
     const project = this.project(args);
     if (!project.ok) {
       return project.response;
@@ -40373,7 +40574,7 @@ class GodotServer {
         isError: true
       };
     }
-    const failed = failedCases(report, Buffer.concat(console2).toString("utf8"));
+    const { failed, briefed } = failedWithin(failedCases(report, Buffer.concat(console2).toString("utf8")), FAILED_BUDGET);
     const orphans = orphansPrinted(said);
     const leftBehind = new Map(orphans.suites.map((suite) => [suite.path, suite.orphans]));
     const orphansIn = (path) => path === null ? 0 : leftBehind.get(path) ?? 0;
@@ -40413,6 +40614,7 @@ class GodotServer {
       skipped: report.skipped,
       time: report.time,
       failed,
+      failedWithoutDetail: briefed > 0 ? briefed : undefined,
       hookFailures: hookFailures.length > 0 ? hookFailures : undefined,
       uncaughtScriptErrors: uncaughtFolded.length > 0 ? uncaughtFolded : undefined,
       warnings: warnings.length > 0 ? warnings : undefined,
@@ -40424,6 +40626,7 @@ class GodotServer {
       ...scanned,
       note: [
         missingNote,
+        briefed > 0 ? `${briefed} of the ${failed.length} failing cases, those with the largest reports, are named with their first message only, since their reports would have made the answer too large to deliver; pass one case's suite path to see its reports.` : undefined,
         notApplied.length > 0 ? "An ignore entry named a case that ran all the same: gdUnit4 leaves a case out only as suite_name:test_name, and reads an entry with no colon as a suite name or a piece of a suite path. ignoreNotApplied gives the form for each case that ran." : undefined,
         uncaughtNote(uncaught),
         ranAs.startsWith("warnings") && warnings.length === 0 ? "gdUnit4 exits 101 for orphan nodes when nothing failed, and this run printed no count of them: orphan reporting may be off in the project settings." : notRunNote(notRun, readBoolean(args, "failFast") === true)
@@ -40587,7 +40790,11 @@ class GodotServer {
     };
   }
   markedIfStale(answer) {
-    return markIfStale(answer, this.godotBridge.getStatus().addonVersion, SERVER_VERSION, this.godotBridge.getStatus().addonDigest, shippedEditorDigest(), this.editorCodeOnDisk());
+    const status = this.godotBridge.getStatus();
+    if (!hasSaidWhoItIs(status)) {
+      return answer;
+    }
+    return markIfStale(answer, status.addonVersion, SERVER_VERSION, status.addonDigest, shippedEditorDigest(), this.editorCodeOnDisk());
   }
   async diagnosticsOf(args) {
     const waited = await this.waitForTheEditorOpenedHere(args, []);
@@ -41408,7 +41615,7 @@ class GodotServer {
       return;
     }
     const connected = this.godotBridge.isConnected() ? this.godotBridge.getStatus().editorPid : undefined;
-    const pids = editorsOfProjectIn(tree, projectPath).filter((pid) => pid !== connected);
+    const pids = editorsOfProjectIn(tree, projectPath).filter((pid) => pid !== connected && alive(pid));
     const started = await startTimesOf(pids);
     return pids.map((pid) => {
       const at = started.get(pid) ?? tree.get(pid)?.startedAt;
@@ -43647,6 +43854,45 @@ class GodotServer {
       ...engineExtras(outcome)
     });
   }
+  async editorOrEngine(command, args, askedAs, effect) {
+    const contained = this.containProjectFiles(args);
+    if (!contained.ok) {
+      return contained.response;
+    }
+    const project = this.project(contained.value);
+    if (!project.ok) {
+      return project.response;
+    }
+    const projectPath = project.value.path;
+    const waited = await this.waitForTheEditorOpenedHere(contained.value, []);
+    if (this.editorHasOpen(projectPath)) {
+      return await this.handleViaBridge(command, contained.value, askedAs);
+    }
+    if (effect === "writes") {
+      if (waited !== null) {
+        return waited;
+      }
+      const arriving = await this.editorsNotYetConnected(projectPath);
+      if (arriving !== undefined && arriving.length > 0) {
+        const named = arriving.map((one) => `pid ${one.pid}`).join(", ");
+        return this.createErrorResponse(`${askedAs} was not run: an editor of this project is running (${named}) and has not reached this server, and saving a scene or resource it holds would put back what a write made around it.`, [
+          "editor_status names it under editorsNotYetConnected and says when it has connected; the write then goes through it",
+          `If it never connects it is not reaching this server: end ${arriving.length === 1 ? "that pid" : "those pids"} and ask again`
+        ]);
+      }
+    }
+    const outcome = await this.operation("run_editor_tool", { command, arguments: contained.value }, projectPath);
+    if (!outcome.ok) {
+      return this.answer(outcome);
+    }
+    return this.jsonTextResponse({
+      ...outcome.payload,
+      ...effect === "reads" ? {
+        readBy: "a headless engine, since no editor serves this project; unsaved changes in an editor are not seen"
+      } : { writtenBy: "a headless engine, since no editor serves this project" },
+      ...engineExtras(outcome)
+    });
+  }
   async handleMoveFile(given) {
     const project = this.project(given);
     if (!project.ok) {