gdharness 0.13.43 → 0.13.44

package/build/cli.js

@@ -16155,7 +16155,7 @@ var init_tool_definitions = __esm(() => {
         says: {
           type: "string",
           ops: ["find"],
-          description: "find: part of what the node has written on it, case-insensitively, which is how a button is reached by the word on it rather than by a generated path. Its own text, so a row is found by the label in it, and hidden nodes match. A bare word is a contains; write a glob and it is one, matched against the whole of what the node says, the same as namePattern."
+          description: "find: part of what the node has written on it, case-insensitively, which is how a button is reached by the word on it rather than by a generated path. Its own text, so a row is found by the label in it, and hidden nodes match. A bare word is a contains; write a glob and it is one, matched against the whole of what the node says, the same as namePattern. A label with a line break is matched with the break in the words, and a backslash followed by n counts as one."
         },
         limit: {
           type: "number",
@@ -16373,7 +16373,7 @@ var init_tool_definitions = __esm(() => {
         says: {
           type: "string",
           ops: ["until"],
-          description: "until: wait for these words to appear anywhere under nodePath instead of for a property, which is how a panel that rebuilds its labels is waited on at all: the labels are named afresh each redraw and the panel is what stays put. Case-insensitive, part of a line, hidden nodes included. Instead of, not as well as: a call carrying this and a property is refused, because they ask about different things and answering one of them silently is how a caller watches a screen believing they are watching a property."
+          description: "until: wait for these words to appear anywhere under nodePath instead of for a property, which is how a panel that rebuilds its labels is waited on at all: the labels are named afresh each redraw and the panel is what stays put. Case-insensitive, part of a line, hidden nodes included; a label with a line break is matched with the break in the words, and a backslash followed by n counts as one. Instead of, not as well as: a call carrying this and a property is refused, because they ask about different things and answering one of them silently is how a caller watches a screen believing they are watching a property."
         },
         timeoutMs: {
           type: "number",

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

@@ -212,7 +212,18 @@ static func _is_literal(pattern: String) -> bool:
 ## only, a glob matched nothing at all and an empty answer reads as a control that is not on the
 ## screen: twice in one session here, over a button that was.
 static func _says(said: String, wanted: String) -> bool:
-	return said.containsn(wanted) if _is_literal(wanted) else said.matchn(wanted)
+	var words: String = as_said(wanted)
+	return said.containsn(words) if _is_literal(words) else said.matchn(words)
+
+
+## [param wanted] as words on a screen: a backslash followed by n is a line break.
+##
+## A button with two lines on it was asked for with the break written as the two characters, the
+## way it is typed into a JSON string one escape short, and was answered as not there: 0 found,
+## which reads as a control that is not on the screen. Nothing on a screen says a backslash and
+## an n, so the two characters mean the break to everybody who writes them.
+static func as_said(wanted: String) -> String:
+	return wanted.replace("\\n", "\n")
 
 
 ## Every filter but the name, so a find that came back empty can say how many nodes the name was

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

@@ -198,10 +198,11 @@ func wait_until(params: Dictionary) -> Dictionary:
 ## and the screen is the part that stays put.
 func _wait_until_said(node_path: String, said: String, timeout_ms: int) -> Dictionary:
 	var started: int = Time.get_ticks_msec()
-	var found: bool = _anything_says(node_path, said)
+	var words: String = Queries.as_said(said)
+	var found: bool = _anything_says(node_path, words)
 	while not found and Time.get_ticks_msec() - started < timeout_ms:
 		await _host.get_tree().process_frame
-		found = _anything_says(node_path, said)
+		found = _anything_says(node_path, words)
 
 	return {
 		"type": "condition",

package/build/index.js

@@ -29770,7 +29770,7 @@ var TOOL_SPECS = [
       says: {
         type: "string",
         ops: ["find"],
-        description: "find: part of what the node has written on it, case-insensitively, which is how a button is reached by the word on it rather than by a generated path. Its own text, so a row is found by the label in it, and hidden nodes match. A bare word is a contains; write a glob and it is one, matched against the whole of what the node says, the same as namePattern."
+        description: "find: part of what the node has written on it, case-insensitively, which is how a button is reached by the word on it rather than by a generated path. Its own text, so a row is found by the label in it, and hidden nodes match. A bare word is a contains; write a glob and it is one, matched against the whole of what the node says, the same as namePattern. A label with a line break is matched with the break in the words, and a backslash followed by n counts as one."
       },
       limit: {
         type: "number",
@@ -29988,7 +29988,7 @@ var TOOL_SPECS = [
       says: {
         type: "string",
         ops: ["until"],
-        description: "until: wait for these words to appear anywhere under nodePath instead of for a property, which is how a panel that rebuilds its labels is waited on at all: the labels are named afresh each redraw and the panel is what stays put. Case-insensitive, part of a line, hidden nodes included. Instead of, not as well as: a call carrying this and a property is refused, because they ask about different things and answering one of them silently is how a caller watches a screen believing they are watching a property."
+        description: "until: wait for these words to appear anywhere under nodePath instead of for a property, which is how a panel that rebuilds its labels is waited on at all: the labels are named afresh each redraw and the panel is what stays put. Case-insensitive, part of a line, hidden nodes included; a label with a line break is matched with the break in the words, and a backslash followed by n counts as one. Instead of, not as well as: a call carrying this and a property is refused, because they ask about different things and answering one of them silently is how a caller watches a screen believing they are watching a property."
       },
       timeoutMs: {
         type: "number",

package/package.json

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