@deeeed/metamask-harness 0.15.1 → 0.15.2

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## 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

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/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/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.1",
+  "version": "0.15.2",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"