@deeeed/metamask-harness 0.92.21 → 0.92.22

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 0.92.22 - 2026-10-18
+
+### Fixed
+
+- Mobile: the recipe HUD no longer satisfies or blocks a text-only `ui.wait_for` whose own HUD text (badge, intent or detail) contains the asserted text. Each poll hides the HUD (an earlier node's HUD included), then checks every 50 ms, for about 1 s, that the intent has left the app tree before it queries. It hides again if a late HUD update brings the HUD back. That node's HUD comes back with the next update. Such a wait reports `hud: "hidden"`. A poll that can't confirm the HUD left decides nothing. If the app itself shows the whole intent text, the wait times out and says so; reword the intent. Before, `expected: absent` never passed and `expected: visible` could pass on the HUD text alone. Waits with a `test_id` and waits that don't collide with the HUD are unchanged.
+
 ## 0.92.21 - 2026-10-17
 
 ### Added

package/dist/adapters/mobile/ui.js

@@ -1,5 +1,6 @@
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
+import { hudIntentDisplay } from "@farmslot/protocol/recipe";
 import { bridgeCommand, evalAsync, evalSync, MOBILE_BRIDGE_ERROR_CODES, selectBridgeStatusEntry, simulatorScreenshot } from "../../../library/actions/mobile/platform/bridge.mjs";
 import { observeNativeUi } from "../../../library/actions/mobile/platform/observe-ui.mjs";
 import { nativeAgentDeviceStateDir } from "../../../library/actions/mobile/platform/native-session-name.mjs";
@@ -188,6 +189,16 @@ async function hiddenRouteOnly(input, probeInput, payload, testId, deadline) {
   const nativeVisible = visible.items.some((item) => isRecord(item) && item.test_id === testId && item.visible !== false);
   return nativeVisible ? null : { hiddenRoute: true, nativeVisible: false };
 }
+const HUD_HIDE_SETTLE_MS = 1e3;
+function hudIntentCollidingWith(payload, testId, expectedText) {
+  if (testId || !expectedText || typeof payload.intent !== "string") return null;
+  const intent = hudIntentDisplay(payload.intent).text;
+  if (!intent) return null;
+  const detail = typeof payload.detail === "string" ? payload.detail : "";
+  const needle = expectedText.toLowerCase();
+  const inBadge = ["run", "pass", "fail"].some((word) => `${word} 0/0`.includes(needle.replace(/\d+/gu, "0")));
+  return inBadge || [intent, detail].some((text) => text.toLowerCase().includes(needle)) ? intent : null;
+}
 async function waitForMobileTarget(input, payload) {
   const timeoutMs = Number(payload.timeout_ms ?? payload.timeoutMs ?? 1e4);
   const deadline = Date.now() + timeoutMs;
@@ -197,13 +208,43 @@ async function waitForMobileTarget(input, payload) {
     ...expectedText && textMatch === "contains" ? { textContains: expectedText } : {},
     visibility
   };
+  const hudIntent = hudIntentCollidingWith(payload, testId, expectedText);
   const queryExpression = `(function(){
     const api = globalThis.__AGENTIC__;
     if (!api || typeof api.queryUiTarget !== 'function') {
       return Promise.resolve(JSON.stringify({ unsupported: true }));
     }
-    return api.queryUiTarget(${JSON.stringify(query)}).then(function(result){
-      return JSON.stringify(result);
+    const query = function(){
+      return Promise.resolve(api.queryUiTarget(${JSON.stringify(query)}));
+    };
+    const hudIntent = ${JSON.stringify(hudIntent)};
+    if (hudIntent === null || typeof api.hideStep !== 'function') {
+      return query().then(function(result){ return JSON.stringify(result); });
+    }
+    const hudShown = function(){
+      return Promise.resolve(api.queryUiTarget({ textContains: hudIntent, visibility: 'tree' }))
+        .then(function(found){ return Boolean(found && found.present); });
+    };
+    // Hide, let React commit it, then look: an earlier node's HUD can still be
+    // up, and the tree only drops it after the commit. Hide again while this
+    // node's intent is shown, since a late HUD update can land after a hide.
+    const settle = function(waitedMs){
+      api.hideStep();
+      return new Promise(function(resolve){ setTimeout(resolve, 50); })
+        .then(hudShown)
+        .then(function(shown){
+          if (!shown) return true;
+          if (waitedMs + 50 >= ${HUD_HIDE_SETTLE_MS}) return false;
+          return settle(waitedMs + 50);
+        });
+    };
+    return settle(0).then(function(hidden){
+      if (!hidden) return JSON.stringify({ hudShown: true });
+      return query().then(function(result){
+        return hudShown().then(function(shown){
+          return JSON.stringify(shown ? { hudShown: true } : Object.assign({}, result, { hud: 'hidden' }));
+        });
+      });
     });
   })()`;
   const textExpression = testId ? `(function(){
@@ -241,6 +282,10 @@ async function waitForMobileTarget(input, payload) {
       );
     }
     lastResult = result;
+    if (result.hudShown === true) {
+      await sleep(100);
+      continue;
+    }
     let present = result.present === true;
     let visible = result.visible === true;
     let cachedRoute = null;
@@ -280,7 +325,8 @@ async function waitForMobileTarget(input, payload) {
         visible,
         visibility,
         ...cachedRoute ?? {},
-        ...isRecord(result.rect) ? { rect: result.rect } : {}
+        ...isRecord(result.rect) ? { rect: result.rect } : {},
+        ...typeof result.hud === "string" ? { hud: result.hud } : {}
       };
     }
     await sleep(250);
@@ -291,8 +337,9 @@ async function waitForMobileTarget(input, payload) {
   ].filter(Boolean).join(" with ");
   const exactReason = textMatch === "exact" ? `; last text=${JSON.stringify(lastText)}` : "";
   const bridgeReason = lastBridgeError ? `; last bridge error=${traceText(lastBridgeError)}` : "";
+  const hudReason = lastResult?.hudShown === true ? `; the recipe HUD showing this node's intent never left the app tree, so the text was not checked without it (if the app itself shows the intent text, reword the intent)` : "";
   throw new Error(
-    `Timed out waiting for mobile ${target} to be ${expected}; last result=${JSON.stringify(lastResult)}${exactReason}${bridgeReason}.`
+    `Timed out waiting for mobile ${target} to be ${expected}; last result=${JSON.stringify(lastResult)}${exactReason}${bridgeReason}${hudReason}.`
   );
 }
 const MOBILE_BRIDGE_HANDLERS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.92.21",
+  "version": "0.92.22",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"