@deeeed/metamask-harness 0.15.0 → 0.15.2

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## 0.15.2 - 2026-07-13
+
+### Fixed
+
+- Mobile `ui.press text=<visible text>` now invokes the app bridge's text-content press path, while `test_id`, `testID`, and `selector` continue to use exact testID matching; ambiguous target combinations fail before bridge execution.
+
+## 0.15.1 - 2026-07-13
+
+### Fixed
+
+- `doctor --fix` recovery `nextActions` (numbered fixture choices, overlay install, runtime-context retry) now embed the resolved `--adapter` and absolute `--target`, shell-quoted, so each command works verbatim from any cwd. They are also prefixed with the resolved `bin/mm-harness` executable path, so they work in task-local installs where `mm-harness` is not on PATH.
+
 ## 0.15.0 - 2026-07-13
 
 ### Changed

package/adapters/mobile/bridge-runtime/cdp-bridge.cjs

@@ -254,6 +254,21 @@ const COMMANDS = {
     return { ...result, testId, deviceName };
   },
 
+  async 'press-text'(client, args, { deviceName } = {}) {
+    const text = args[0];
+    if (!text) {
+      throw new Error('Usage: press-text <text>');
+    }
+    const expr = `(function() {
+      if (typeof globalThis.__AGENTIC__?.pressText !== 'function') {
+        return { ok: false, error: 'The app bridge does not expose pressText' };
+      }
+      return globalThis.__AGENTIC__.pressText(${JSON.stringify(text)});
+    })()`;
+    const result = await cdpEval(client, expr);
+    return { ...result, text, deviceName };
+  },
+
   async 'scroll-view'(client, args, { deviceName } = {}) {
     let testId;
     let offset = 300;
@@ -678,6 +693,7 @@ Commands:
   get-selected-account                 Get the currently selected account
   switch-account <address>             Switch to account by address
   press-test-id <testId>               Press a component by its testID prop
+  press-text <text>                     Press a component containing visible text
   scroll-view [--test-id <id>] [--offset <n>] [--animated]
                                        Scroll a ScrollView/FlatList
   set-input <testId> <value>           Set text input value by testID (calls onChangeText)

package/bin/mm-harness

@@ -50,6 +50,13 @@ if [ -n "${MM_HARNESS_BIN:-}" ]; then
   fi
 fi
 
+# Internal executable identity (not part of the public env surface): the CLI
+# embeds this in emitted recovery commands so they run verbatim even when
+# mm-harness is not on PATH (task-local installs). Set AFTER the MM_HARNESS_BIN
+# delegation above so the final executable entered always overwrites any
+# inherited/stale value with its own resolved self path.
+export MM_HARNESS_EXECUTABLE="$SCRIPT_DIR/$(basename "$SOURCE")"
+
 ENTRY_TS="$RUNNER_DIR/src/mm-harness-cli.ts"
 ENTRY_DIST="$RUNNER_DIR/dist/mm-harness-cli.js"
 

package/dist/adapters.js

@@ -287,8 +287,15 @@ async function handleMobileNavigate(payload, context) {
   return isRecord(live.result) ? { ...live.result, liveAdapter: live.script } : live.result;
 }
 async function handleMobilePress(payload, context) {
-  const target = firstScalarText(payload, ["test_id", "testID", "selector", "text"], "ui.press");
-  return bridgeCommand(mobileUiInput(context, "press", payload), ["press-test-id", target]);
+  const identifiers = ["test_id", "testID", "selector"].map((field) => optionalScalarText(payload[field], `ui.press.${field}`)).filter((value) => value !== void 0);
+  const text = optionalScalarText(payload.text, "ui.press.text");
+  if (identifiers.length + Number(text !== void 0) !== 1) {
+    throw new Error("ui.press requires exactly one of: test_id, testID, selector, text.");
+  }
+  const target = text ?? identifiers[0];
+  if (target.trim() === "") throw new Error("ui.press target must be non-empty.");
+  const input = mobileUiInput(context, "press", payload);
+  return text !== void 0 ? bridgeCommand(input, ["press-text", target]) : bridgeCommand(input, ["press-test-id", target]);
 }
 async function handleMobileSetInput(payload, context) {
   const input = mobileUiInput(context, "set_input", payload);

package/dist/commands/doctor.js

@@ -4,7 +4,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { color } from "../cli-color.js";
 import { createDoctorReport, fixtureSummary, renderRuntimeContext, requiredDoctorCheckSummary } from "../doctor.js";
-import { detectAdapter } from "../harness.js";
+import { detectAdapter, resolveRuntimeContextPath } from "../harness.js";
 import { assertAdapter, runnerDir } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
 import { ensureMobilePerpsEnvironment, mobilePerpsEnvironment } from "../adapters/mobile/perps-env.js";
@@ -27,6 +27,7 @@ import {
   applyRuntimeDirOption,
   optionFlag,
   optionString,
+  shellQuote,
   targetPath
 } from "./parse-args.js";
 function applyDoctorRuntimePorts(options) {
@@ -95,7 +96,7 @@ async function handleDoctor({ options }) {
       lock.release();
     }
     const result2 = createDoctorReport(adapter, target, manifestValidation, actionManifestPath);
-    const nextActions = doctorFixNextActions(failed, result2.fixture);
+    const nextActions = doctorFixNextActions(failed, result2.fixture, adapter, target);
     const status = result2.status === "pass" && failed.length === 0 ? "pass" : "fail";
     if (json) console.log(JSON.stringify({ ...result2, status, fixed, failed, nextActions }, null, 2));
     else {
@@ -215,15 +216,21 @@ function doctorRuntimeCheck(runtime, error, expectLive) {
     detail: runtime?.reasons.join(" | ") || "Runtime readiness probe returned no result."
   };
 }
-function doctorFixNextActions(failed, fixture) {
+function doctorFixNextActions(failed, fixture, adapter, target) {
   const actions = [];
+  const executable = process.env.MM_HARNESS_EXECUTABLE ? shellQuote(process.env.MM_HARNESS_EXECUTABLE) : "mm-harness";
+  const scope = `--adapter ${adapter} --target ${shellQuote(target)}`;
   if (failed.includes("wallet-fixture")) {
     const force = fixture.status === "invalid" || fixture.status === "incomplete" ? " --force" : "";
-    actions.push(`1) mm-harness fixtures init --from <path>${force}   # existing team/test fixture`);
-    actions.push(`2) mm-harness fixtures init --dev${force}           # disposable public test wallet; never real funds`);
+    actions.push(`1) ${executable} fixtures init --from <path>${force} ${scope}   # existing team/test fixture`);
+    actions.push(`2) ${executable} fixtures init --dev${force} ${scope}           # disposable public test wallet; never real funds`);
   }
-  if (failed.includes("runtime-context")) actions.push("inspect temp/recipe/runtime/agentic-runtime.json, then retry mm-harness doctor --fix");
-  if (failed.includes("overlay")) actions.push("mm-harness install --target .");
+  if (failed.includes("runtime-context")) {
+    actions.push(
+      `inspect ${shellQuote(resolveRuntimeContextPath(target))}, then retry ${executable} doctor --fix ${scope}`
+    );
+  }
+  if (failed.includes("overlay")) actions.push(`${executable} install ${scope}`);
   return actions;
 }
 function emitExpectLiveVerdict(adapter, target, runtime, verdict) {
@@ -389,6 +396,7 @@ function readTextSnapshot(file) {
   }
 }
 export {
+  doctorFixNextActions,
   ensureExtensionPerpsBuildFlag,
   handleDoctor
 };

package/docs/live-adapter-contract.md

@@ -185,4 +185,4 @@ ui.screenshot
 
 Navigation supports a small discoverable `page` alias set (`home`, `perps`, `perps-market`) plus raw React Navigation route/params fallback. Check the action manifest before hardcoding routes.
 
-Read-only position checks use `Engine.context.PerpsController.getPositions()` through Hermes CDP. State-changing Perps actions use supported controller APIs (`placeOrder`, `closePositions`) through the same app bridge rather than mutating Redux/React/local storage. UI actions delegate to existing bridge capabilities such as `press-test-id` and `scroll-view`. Screenshot capture uses `xcrun simctl io <simulator> screenshot` for iOS simulator proof.
+Read-only position checks use `Engine.context.PerpsController.getPositions()` through Hermes CDP. State-changing Perps actions use supported controller APIs (`placeOrder`, `closePositions`) through the same app bridge rather than mutating Redux/React/local storage. Mobile `ui.press` uses `press-test-id` for `test_id`/`testID`/`selector` and `press-text` for visible `text`; scrolling uses `scroll-view`. Screenshot capture uses `xcrun simctl io <simulator> screenshot` for iOS simulator proof.

package/library/manifests/mobile.action-manifest.json

@@ -156,13 +156,38 @@
       ]
     },
     "ui.press": {
-      "description": "Press/tap/click a UI target through the platform adapter.",
+      "description": "Press a React Native component by exact testID/test_id, a legacy selector identifier, or contained visible text.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": { "const": "ui.press" },
+          "test_id": { "type": "string", "minLength": 1 },
+          "testID": { "type": "string", "minLength": 1 },
+          "selector": { "type": "string", "minLength": 1 },
+          "text": { "type": "string", "minLength": 1 }
+        },
+        "oneOf": [
+          { "required": ["test_id"] },
+          { "required": ["testID"] },
+          { "required": ["selector"] },
+          { "required": ["text"] }
+        ]
+      },
       "examples": [
         {
+          "description": "Press by stable React Native testID",
+          "node": {
+            "action": "ui.press",
+            "test_id": "perps-tab",
+            "intent": "Open Perps through its stable testID"
+          }
+        },
+        {
+          "description": "Press a component that is reachable only by visible text",
           "node": {
             "action": "ui.press",
-            "target": "Perps",
-            "intent": "Press/tap/click a UI target through the platform adapter"
+            "text": "Ethereum",
+            "intent": "Press the component containing the visible Ethereum label"
           }
         }
       ]

package/package.json

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