@deeeed/metamask-harness 0.26.4 → 0.27.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## Unreleased
 
+## 0.27.0 - 2026-07-31
+
+### Changed
+
+- Mobile UI actions now record bounded native-hierarchy observations, while defaulted Extension UI actions record screen and visible observations; Extension screenshots and recordings publish through symlink-safe private staging as regular `0600` files, Mobile launch and diagnostics resolve absolute device-tool paths, and iOS preparation enables application accessibility before relaunching.
+
+### Fixed
+
+- Serve analytics capture on both IPv4 and IPv6 loopback so Mobile clients resolving `localhost` to `::1` can reach the collector without exposing it on external interfaces.
+
+## 0.26.5 - 2026-07-31
+
+### Fixed
+
+- Forward Mobile launch's resolved Metro port to every runtime leaf so stale slot context cannot start, compile, launch, or observe a second Metro.
+- Propagate inline Segment configuration into detached Mobile Metro runs and invalidate the Metro cache when it changes.
+- Navigate through Mobile's root settings navigator before changing analytics consent.
+
 ## 0.26.4 - 2026-07-31
 
 ### Fixed

package/adapters/mobile/open-device.sh

@@ -25,6 +25,7 @@ PLATFORM="ios"
 TARGET="$PWD"
 SIMULATOR="${IOS_SIMULATOR:-${SIM_UDID:-booted}}"
 ADB_SERIAL_ARG="${ADB_SERIAL:-${ANDROID_SERIAL:-}}"
+ADB_BIN="${MM_HARNESS_ADB_PATH:-}"
 PREFLIGHT_MODE="${MOBILE_PREFLIGHT_MODE:-fast}"
 PORT="${WATCHER_PORT:-${METRO_PORT:-8081}}"
 UI_ONLY=false
@@ -54,6 +55,17 @@ case "$PLATFORM" in
   ios|android) ;;
   *) printf 'open-device: --platform must be ios or android (got: %s)\n' "$PLATFORM" >&2; exit 2 ;;
 esac
+if [ "$PLATFORM" = "android" ]; then
+  if [ -z "$ADB_BIN" ]; then
+    ADB_BIN="$(command -v adb 2>/dev/null || true)"
+  fi
+  if [ -z "$ADB_BIN" ] || [ "${ADB_BIN#/}" = "$ADB_BIN" ] || [ ! -x "$ADB_BIN" ]; then
+    printf 'open-device: Android SDK Platform-Tools (adb) is required but no executable was found.\n' >&2
+    printf 'Next: brew install android-platform-tools\n' >&2
+    exit 1
+  fi
+  export MM_HARNESS_ADB_PATH="$ADB_BIN"
+fi
 if $UI_ONLY && [ "$PLATFORM" != "ios" ]; then
   printf 'open-device: --ui-only is supported only for ios.\n' >&2
   exit 2
@@ -207,7 +219,7 @@ focus_simulator() {
 android_app_installed() {
   local pkg="$1"
   shift
-  adb "$@" shell pm list packages 2>/dev/null | grep -q "package:${pkg}"
+  "$ADB_BIN" "$@" shell pm list packages 2>/dev/null | grep -q "package:${pkg}"
 }
 
 run_android_native_build() {
@@ -315,14 +327,14 @@ else
   [ -n "$ADB_SERIAL_ARG" ] && ADB_ARGS+=("-s" "$ADB_SERIAL_ARG")
 
   # Reverse-tunnel Metro port so the device can reach localhost:PORT.
-  adb "${ADB_ARGS[@]}" reverse "tcp:${PORT}" "tcp:${PORT}" >/dev/null 2>&1 || \
+  "$ADB_BIN" "${ADB_ARGS[@]}" reverse "tcp:${PORT}" "tcp:${PORT}" >/dev/null 2>&1 || \
     printf 'open-device: adb reverse failed (non-fatal — device may already be reachable)\n' >&2
 
   LAUNCHED=false
   for PKG in "${ANDROID_PKGS[@]}"; do
     ensure_android_app_for_mode "$PKG" "$PREFLIGHT_MODE" "${ADB_ARGS[@]}" || continue
     if $RESTART; then
-      adb "${ADB_ARGS[@]}" shell am force-stop "$PKG" >/dev/null 2>&1 || true
+      "$ADB_BIN" "${ADB_ARGS[@]}" shell am force-stop "$PKG" >/dev/null 2>&1 || true
       printf 'Restarting Android dev client %s\n' "$PKG" >&2
     fi
 
@@ -331,7 +343,7 @@ else
     DEEP_LINK="expo-metamask://expo-development-client/?url=${ENCODED_URL}"
 
     printf 'Launching Android dev client %s\n' "$PKG" >&2
-    if adb "${ADB_ARGS[@]}" shell am start \
+    if "$ADB_BIN" "${ADB_ARGS[@]}" shell am start \
         -a android.intent.action.VIEW \
         -d "$DEEP_LINK" >/dev/null 2>&1; then
       LAUNCHED=true

package/adapters/mobile/start-metro.sh

@@ -57,6 +57,7 @@ LOG_DIR="$TARGET/$(recipe_runtime_dir)" || exit 1
 mkdir -p "$LOG_DIR"
 LOG_FILE="$LOG_DIR/metro.log"
 PID_FILE="$LOG_DIR/metro.pid"
+INLINE_ENV_FILE="$LOG_DIR/metro-inline-env.sh"
 
 # --- helpers ------------------------------------------------------------------
 
@@ -73,6 +74,24 @@ default_metro_workers() {
   fi
 }
 
+write_inline_metro_env() {
+  local temporary name
+  temporary="$(mktemp "$LOG_DIR/.metro-inline-env.XXXXXX")" || return 1
+  chmod 600 "$temporary" || { rm -f "$temporary"; return 1; }
+  for name in \
+    SEGMENT_PROXY_URL \
+    SEGMENT_WRITE_KEY \
+    SEGMENT_FLUSH_INTERVAL \
+    SEGMENT_FLUSH_EVENT_LIMIT
+  do
+    if declare -p "$name" >/dev/null 2>&1; then
+      printf 'export %s=%q\n' "$name" "${!name}" >> "$temporary" \
+        || { rm -f "$temporary"; return 1; }
+    fi
+  done
+  mv -f "$temporary" "$INLINE_ENV_FILE"
+}
+
 # Log-tail viewer window (session-safe): sourced so its run-owned-session rule is
 # unit-testable and can never leak a window into an unrelated user session.
 # shellcheck disable=SC1091
@@ -96,6 +115,10 @@ set +a
 # build.sh remaps MM_SENTRY_DSN from MM_SENTRY_DSN_DEV for dev builds; quick-launch
 # bypasses it, so without this Sentry never initializes in the dev client.
 [ -n "\${MM_SENTRY_DSN:-}" ] || export MM_SENTRY_DSN="\${MM_SENTRY_DSN_DEV:-}"
+[ ! -f $(printf '%q' "$INLINE_ENV_FILE") ] || {
+  . $(printf '%q' "$INLINE_ENV_FILE")
+  rm -f $(printf '%q' "$INLINE_ENV_FILE")
+}
 export EXPO_NO_TYPESCRIPT_SETUP=1
 export WATCHER_PORT="$(printf '%q' "$PORT")" METRO_PORT="$(printf '%q' "$PORT")"
 export METRO_MAX_WORKERS="$(printf '%q' "$METRO_WORKERS")"
@@ -165,6 +188,11 @@ printf 'Starting Metro on port %s (workers=%s%s)\n' \
   "$PORT" "$METRO_WORKERS" "$CLEAR_LABEL" >&2
 printf '(Full log: %s — mm-harness logs | mm-harness logs --full)\n' "$LOG_FILE" >&2
 
+write_inline_metro_env || {
+  printf 'start-metro: could not stage inline Metro environment\n' >&2
+  exit 1
+}
+
 if ! start_metro_tmux; then
   # Metro runs detached, writing to the log. The tmux window is a read-only tail.
   (
@@ -189,6 +217,11 @@ if ! start_metro_tmux; then
     # = build.sh ios main dev); quick-launch bypasses build.sh, so without this the
     # dev client's MM_SENTRY_DSN stays empty and Sentry never initializes.
     [ -n "${MM_SENTRY_DSN:-}" ] || export MM_SENTRY_DSN="${MM_SENTRY_DSN_DEV:-}"
+    [ ! -f "$INLINE_ENV_FILE" ] || {
+      # shellcheck disable=SC1090
+      . "$INLINE_ENV_FILE"
+      rm -f "$INLINE_ENV_FILE"
+    }
     export EXPO_NO_TYPESCRIPT_SETUP=1
     export WATCHER_PORT="${PORT}" METRO_PORT="${PORT}"
     export METRO_MAX_WORKERS="${METRO_WORKERS}"

package/dist/adapters/mobile/metro-env.js

@@ -3,6 +3,12 @@ import fs from "node:fs";
 import path from "node:path";
 import { recipeRuntimePath } from "../../paths.js";
 const ENV_INPUTS = [".js.env", ".env", ".env.local"];
+const PROCESS_ENV_INPUTS = [
+  "SEGMENT_PROXY_URL",
+  "SEGMENT_WRITE_KEY",
+  "SEGMENT_FLUSH_INTERVAL",
+  "SEGMENT_FLUSH_EVENT_LIMIT"
+];
 const BASELINE_FILE = "metro-env-baseline.json";
 function mobileMetroEnvFingerprint(target) {
   const hash = createHash("sha256");
@@ -13,6 +19,9 @@ function mobileMetroEnvFingerprint(target) {
     else hash.update("<absent>");
     hash.update("\0");
   }
+  for (const name of PROCESS_ENV_INPUTS) {
+    hash.update(`${name}\0${process.env[name] ?? "<absent>"}\0`);
+  }
   return hash.digest("hex");
 }
 function mobileMetroEnvCheck(target) {

package/dist/adapters/mobile/prepare.js

@@ -1,5 +1,7 @@
+import { execFileSync } from "node:child_process";
 import path from "node:path";
 import { recordDepsBaseline } from "@farmslot/recipe-harness/runtime/deps-readiness";
+import { resolveAndExportMobileToolPaths } from "../../../library/actions/mobile/platform/tool-paths.mjs";
 import { EXIT, spawnScriptStreaming } from "../../commands/shared.js";
 import { runnerDir } from "../../paths.js";
 import {
@@ -33,6 +35,14 @@ async function prepareMobile(target, opts = {}) {
   const preflightMode = opts.preflightMode ?? "fast";
   const clearMetro = opts.clearMetro ?? false;
   const restartApp = opts.restartApp ?? false;
+  try {
+    resolveAndExportMobileToolPaths(platform);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (!json) process.stderr.write(`${message}
+`);
+    return { status: EXIT.runtime, output: message };
+  }
   const report = await decideMobileReadiness(target, {
     watcherPort: opts.watcherPort,
     metroLog: opts.metroLog,
@@ -49,27 +59,42 @@ async function prepareMobile(target, opts = {}) {
 `);
     return { status: EXIT.runtime, output: msg };
   }
+  const iosAccessibilityChanged = platform === "ios" && report.decision !== "unknown" && enableIosAccessibility(json);
   if (report.decision === "ready") {
-    if (restartApp) {
+    if (restartApp || iosAccessibilityChanged) {
       const launch2 = await dispatchActionSequence(
         withAppRestart(launchActions(path.resolve(target)), true),
         target,
         platform,
         json,
-        preflightMode
+        preflightMode,
+        opts.watcherPort
       );
-      return launch2.status === 0 ? startMobileConsoleForwarder(target, platform, json) : launch2;
+      return launch2.status === 0 ? startMobileConsoleForwarder(target, platform, json, opts.watcherPort) : launch2;
     }
-    const surface = await ensureMobileHumanSurface(target, platform, json);
+    const surface = await ensureMobileHumanSurface(
+      target,
+      platform,
+      json,
+      opts.watcherPort
+    );
     if (surface.status !== 0) return surface;
     const confirm = await dispatchAction(
       { id: "wait-for-bridge", cwd: target, argv: ["--max-polls", String(READY_BRIDGE_CONFIRM_POLLS)] },
       target,
       platform,
       json,
-      preflightMode
+      preflightMode,
+      opts.watcherPort
     );
-    if (confirm.status === 0) return startMobileConsoleForwarder(target, platform, json);
+    if (confirm.status === 0) {
+      return startMobileConsoleForwarder(
+        target,
+        platform,
+        json,
+        opts.watcherPort
+      );
+    }
     if (!json) {
       process.stderr.write(
         `launch: runtime looked ready but no ${platform} bridge target answered; launching the app.
@@ -77,13 +102,17 @@ async function prepareMobile(target, opts = {}) {
       );
     }
     const launch = await dispatchActionSequence(
-      withAppRestart(launchActions(path.resolve(target)), restartApp),
+      withAppRestart(
+        launchActions(path.resolve(target)),
+        restartApp || iosAccessibilityChanged
+      ),
       target,
       platform,
       json,
-      preflightMode
+      preflightMode,
+      opts.watcherPort
     );
-    return launch.status === 0 ? startMobileConsoleForwarder(target, platform, json) : launch;
+    return launch.status === 0 ? startMobileConsoleForwarder(target, platform, json, opts.watcherPort) : launch;
   }
   if (report.decision === "unknown") {
     const msg = "mobile prepare: runtime state unknown\n  Next: run mm-harness verify --adapter mobile --target <checkout>";
@@ -95,9 +124,16 @@ async function prepareMobile(target, opts = {}) {
     clearMetro ? report.actions.map(
       (a) => a.id === "start-metro" && !a.argv?.includes("--clear") ? { ...a, argv: [...a.argv ?? [], "--clear"] } : a
     ) : report.actions,
-    restartApp
+    restartApp || iosAccessibilityChanged
+  );
+  const actionResult = await dispatchActionSequence(
+    actions,
+    target,
+    platform,
+    json,
+    preflightMode,
+    opts.watcherPort
   );
-  const actionResult = await dispatchActionSequence(actions, target, platform, json, preflightMode);
   if (actionResult.status !== 0) return actionResult;
   if (report.decision === "install" && !process.env["RECIPE_UP_INSTALL_ATTEMPTED"]) {
     process.env["RECIPE_UP_INSTALL_ATTEMPTED"] = "1";
@@ -116,19 +152,35 @@ async function prepareMobile(target, opts = {}) {
         return { status: EXIT.runtime, output: msg };
       }
       case "ready": {
-        const surface = await ensureMobileHumanSurface(target, platform, json);
+        const surface = await ensureMobileHumanSurface(
+          target,
+          platform,
+          json,
+          opts.watcherPort
+        );
         if (surface.status !== 0) return surface;
-        const bridge = await dispatchAction({ id: "wait-for-bridge", cwd: target }, target, platform, json, preflightMode);
+        const bridge = await dispatchAction(
+          { id: "wait-for-bridge", cwd: target },
+          target,
+          platform,
+          json,
+          preflightMode,
+          opts.watcherPort
+        );
         if (bridge.status !== 0) return bridge;
         break;
       }
       case "launch": {
         const result = await dispatchActionSequence(
-          withAppRestart(postInstall.actions, restartApp),
+          withAppRestart(
+            postInstall.actions,
+            restartApp || iosAccessibilityChanged
+          ),
           target,
           platform,
           json,
-          preflightMode
+          preflightMode,
+          opts.watcherPort
         );
         if (result.status !== 0) return result;
         break;
@@ -142,19 +194,33 @@ async function prepareMobile(target, opts = {}) {
       }
     }
   }
-  return startMobileConsoleForwarder(target, platform, json);
+  return startMobileConsoleForwarder(
+    target,
+    platform,
+    json,
+    opts.watcherPort
+  );
 }
-function startMobileConsoleForwarder(target, platform, json) {
+function startMobileConsoleForwarder(target, platform, json, watcherPort) {
   return dispatchAction(
     { id: "start-console-forwarder", cwd: target, argv: json ? ["--quiet"] : [] },
     target,
     platform,
-    json
+    json,
+    "fast",
+    watcherPort
   );
 }
-function ensureMobileHumanSurface(target, platform, json) {
+function ensureMobileHumanSurface(target, platform, json, watcherPort) {
   if (platform !== "ios") return Promise.resolve({ status: 0, output: "" });
-  return dispatchAction({ id: "ensure-device-ui", cwd: target }, target, platform, json);
+  return dispatchAction(
+    { id: "ensure-device-ui", cwd: target },
+    target,
+    platform,
+    json,
+    "fast",
+    watcherPort
+  );
 }
 function withAppRestart(actions, restartApp) {
   if (!restartApp) return actions;
@@ -162,7 +228,7 @@ function withAppRestart(actions, restartApp) {
     (action) => action.id === "launch-mobile-runtime" ? { ...action, argv: [...action.argv ?? [], "--restart"] } : action
   );
 }
-async function dispatchActionSequence(requestedActions, target, platform, json, preflightMode) {
+async function dispatchActionSequence(requestedActions, target, platform, json, preflightMode, watcherPort) {
   const resolved = path.resolve(target);
   const actions = applyMobileMetroEnvPolicy(resolved, requestedActions);
   let pendingMetroEnvFingerprint;
@@ -170,7 +236,14 @@ async function dispatchActionSequence(requestedActions, target, platform, json,
     if (action.id === "start-metro") {
       pendingMetroEnvFingerprint = mobileMetroEnvCheck(resolved).fingerprint;
     }
-    const result = await dispatchAction(action, target, platform, json, preflightMode);
+    const result = await dispatchAction(
+      action,
+      target,
+      platform,
+      json,
+      preflightMode,
+      watcherPort
+    );
     if (result.status !== 0) return result;
     if (action.id === "yarn-setup") recordDepsBaseline(resolved);
     if (action.id === "prewarm-bundle" && pendingMetroEnvFingerprint) {
@@ -184,7 +257,100 @@ async function dispatchActionSequence(requestedActions, target, platform, json,
   }
   return { status: 0, output: "" };
 }
-async function dispatchAction(action, target, platform, json, preflightMode = "fast") {
+function enableIosAccessibility(json) {
+  const simulator = process.env.SIM_UDID || process.env.IOS_SIMULATOR || "booted";
+  const defaultsArgs = [
+    "simctl",
+    "spawn",
+    simulator,
+    "defaults"
+  ];
+  try {
+    execFileSync("xcrun", ["simctl", "boot", simulator], {
+      stdio: "ignore",
+      timeout: 15e3
+    });
+  } catch {
+  }
+  try {
+    execFileSync("xcrun", ["simctl", "bootstatus", simulator, "-b"], {
+      stdio: "ignore",
+      timeout: 12e4
+    });
+  } catch (error) {
+    if (!json) {
+      process.stderr.write(
+        `mobile prepare: selected iOS simulator was unavailable (${error instanceof Error ? error.message : String(error)}); continuing with native-view fallback.
+`
+      );
+    }
+    return false;
+  }
+  try {
+    const current = execFileSync(
+      "xcrun",
+      [...defaultsArgs, "read", "com.apple.Accessibility", "ApplicationAccessibilityEnabled"],
+      {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        timeout: 5e3
+      }
+    ).trim().toLowerCase();
+    if (current === "1" || current === "true" || current === "yes") return false;
+  } catch {
+  }
+  try {
+    execFileSync(
+      "xcrun",
+      [
+        ...defaultsArgs,
+        "write",
+        "com.apple.Accessibility",
+        "ApplicationAccessibilityEnabled",
+        "-bool",
+        "YES"
+      ],
+      {
+        stdio: "ignore",
+        timeout: 5e3
+      }
+    );
+    try {
+      execFileSync("xcrun", ["simctl", "shutdown", simulator], {
+        stdio: "ignore",
+        timeout: 15e3
+      });
+    } catch {
+    }
+    try {
+      execFileSync("xcrun", ["simctl", "boot", simulator], {
+        stdio: "ignore",
+        timeout: 15e3
+      });
+    } catch {
+    }
+    execFileSync("xcrun", ["simctl", "bootstatus", simulator, "-b"], {
+      stdio: "ignore",
+      timeout: 12e4
+    });
+    if (!json) {
+      process.stderr.write(
+        `Enabled iOS application accessibility on ${simulator}; restarted the simulator before app launch.
+`
+      );
+    }
+    return true;
+  } catch (error) {
+    if (!json) {
+      process.stderr.write(
+        `mobile prepare: iOS accessibility enablement was unavailable (${error instanceof Error ? error.message : String(error)}); continuing with native-view fallback.
+`
+      );
+    }
+    return false;
+  }
+}
+async function dispatchAction(action, target, platform, json, preflightMode = "fast", watcherPort) {
   const cwd = action.cwd ?? target;
   switch (action.id) {
     case "yarn-setup": {
@@ -194,34 +360,62 @@ async function dispatchAction(action, target, platform, json, preflightMode = "f
     case "start-metro": {
       const leaf = path.join(runnerDir, "adapters/mobile/start-metro.sh");
       const extra = action.argv ?? [];
-      return spawnScriptStreaming(leaf, ["--target", cwd, ...extra], target);
+      return spawnScriptStreaming(
+        leaf,
+        withWatcherPort(["--target", cwd, ...extra], watcherPort),
+        target
+      );
     }
     case "start-console-forwarder": {
       const leaf = path.join(runnerDir, "adapters/mobile/start-console-forwarder.sh");
-      return spawnScriptStreaming(leaf, ["--target", cwd, ...action.argv ?? []], target);
+      return spawnScriptStreaming(
+        leaf,
+        withWatcherPort(
+          ["--target", cwd, ...action.argv ?? []],
+          watcherPort
+        ),
+        target
+      );
     }
     case "prewarm-bundle": {
       const leaf = path.join(runnerDir, "adapters/mobile/prewarm-bundle.sh");
-      return spawnScriptStreaming(leaf, ["--platform", platform, "--target", cwd], target);
+      return spawnScriptStreaming(
+        leaf,
+        withWatcherPort(
+          ["--platform", platform, "--target", cwd, ...action.argv ?? []],
+          watcherPort
+        ),
+        target
+      );
     }
     case "wait-for-bridge": {
       const leaf = path.join(runnerDir, "adapters/mobile/wait-for-bridge.sh");
       const extra = action.argv ?? [];
-      return spawnScriptStreaming(leaf, ["--target", cwd, "--platform", platform, ...extra], target);
+      return spawnScriptStreaming(
+        leaf,
+        withWatcherPort(
+          ["--target", cwd, "--platform", platform, ...extra],
+          watcherPort
+        ),
+        target
+      );
     }
     case "launch-mobile-runtime": {
       const leaf = path.join(runnerDir, "adapters/mobile/open-device.sh");
       return spawnScriptStreaming(
         leaf,
-        [
-          "--platform",
-          platform,
-          "--target",
-          cwd,
-          "--preflight-mode",
-          preflightMode,
-          ...action.argv ?? []
-        ],
+        withWatcherPort(
+          [
+            "--platform",
+            platform,
+            "--target",
+            cwd,
+            "--preflight-mode",
+            preflightMode,
+            ...action.argv ?? []
+          ],
+          watcherPort
+        ),
         target,
         POD_PROBE_ENV
       );
@@ -230,7 +424,10 @@ async function dispatchAction(action, target, platform, json, preflightMode = "f
       const leaf = path.join(runnerDir, "adapters/mobile/open-device.sh");
       return spawnScriptStreaming(
         leaf,
-        ["--platform", platform, "--target", cwd, "--ui-only"],
+        withWatcherPort(
+          ["--platform", platform, "--target", cwd, "--ui-only"],
+          watcherPort
+        ),
         target,
         POD_PROBE_ENV
       );
@@ -245,6 +442,10 @@ async function dispatchAction(action, target, platform, json, preflightMode = "f
       return { status: 0, output: "" };
   }
 }
+function withWatcherPort(args, watcherPort) {
+  if (watcherPort === void 0 || args.includes("--port")) return args;
+  return [...args, "--port", String(watcherPort)];
+}
 export {
   mobileRuntimeStatus,
   prepareMobile

package/dist/adapters/mobile/runtime-decision.js

@@ -13,6 +13,7 @@ import {
 } from "@farmslot/recipe-harness/runtime/log-analysis";
 import { probeMetroPackager } from "@farmslot/recipe-harness/runtime/metro-probe";
 import { recipeRuntimePath } from "../../paths.js";
+import { resolveMobileToolPath } from "../../../library/actions/mobile/platform/tool-paths.mjs";
 import { mobileProductMarkers } from "./deps-markers.js";
 import { applyMobileMetroEnvPolicy, mobileMetroEnvCheck } from "./metro-env.js";
 const BUNDLE_ERR = /Bundling failed|Unable to resolve /u;
@@ -66,9 +67,11 @@ const installActions = (target) => [
 function appRunningOnDevice(platform) {
   try {
     if (platform === "android") {
+      const adbPath = resolveMobileToolPath("adb");
+      if (!adbPath) return false;
       const serial = process.env.ADB_SERIAL || process.env.ANDROID_SERIAL;
       const args = serial ? ["-s", serial] : [];
-      const out2 = execFileSync("adb", [...args, "shell", "ps", "-A"], {
+      const out2 = execFileSync(adbPath, [...args, "shell", "ps", "-A"], {
         encoding: "utf8",
         stdio: ["ignore", "pipe", "ignore"],
         timeout: 5e3

package/dist/adapters.js

@@ -5,6 +5,7 @@ import {
 } from "./live-adapter-contract.js";
 import { withExtensionPage } from "../library/actions/extension/platform/cdp.mjs";
 import { bridgeCommand, evalSync, MOBILE_BRIDGE_ERROR_CODES, selectBridgeStatusEntry, simulatorScreenshot } from "../library/actions/mobile/platform/bridge.mjs";
+import { observeNativeUi } from "../library/actions/mobile/platform/observe-ui.mjs";
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -276,7 +277,8 @@ const MOBILE_BRIDGE_HANDLERS = {
   setInput: handleMobileSetInput,
   scroll: handleMobileScroll,
   waitFor: handleMobileWaitFor,
-  hud: handleMobileHud
+  hud: handleMobileHud,
+  observeUi: handleMobileObserveUi
 };
 function createMetaMaskMobileBridge() {
   return {
@@ -302,6 +304,20 @@ async function handleMobileScreenshot(payload, context) {
 async function handleMobileStatus(payload, context) {
   return bridgeCommand(mobileUiInput(context, "status", payload), ["status"]);
 }
+async function handleMobileObserveUi(payload, context) {
+  try {
+    await bridgeCommand(
+      mobileUiInput(context, "observe", {
+        ...payload,
+        bridge_timeout_ms: 2e3,
+        cdp_timeout_ms: 2e3
+      }),
+      ["hide-step"]
+    );
+  } catch {
+  }
+  return observeNativeUi(payload, context);
+}
 async function handleMobileNavigate(payload, context) {
   const live = await runLiveAdapterScript({
     platform: "mobile",
@@ -496,7 +512,8 @@ function createMetaMaskUiTransport(platform, harness, preparedLiveAdapters) {
       );
     }
   });
-  const transport = {
+  return {
+    ...base.observe ? { observe: base.observe.bind(base) } : {},
     async execute(action, node, context) {
       if (action === "ui.navigate") {
         const live = await runLiveFirst(
@@ -513,10 +530,6 @@ function createMetaMaskUiTransport(platform, harness, preparedLiveAdapters) {
       return base.execute(action, action === "ui.wait_for" ? normalizeUiWaitNode(node) : node, context);
     }
   };
-  if (base.observe) {
-    transport.observe = (refs, node, context) => base.observe(refs, node, context);
-  }
-  return transport;
 }
 function normalizeUiWaitNode(node) {
   if (node.expected !== void 0 || typeof node.visible !== "boolean") return node;

package/dist/commands/device-target.js

@@ -1,12 +1,15 @@
 import { execFileSync } from "node:child_process";
+import { resolveMobileToolPath } from "../../library/actions/mobile/platform/tool-paths.mjs";
 import { listConnectedDevices } from "../devices.js";
 import { optionString, shellQuoteArg, targetPath } from "./parse-args.js";
 function normalizeDeviceName(value) {
   return value.replace(/_/gu, " ").trim();
 }
 function resolveAndroidModel(serial) {
+  const adbPath = resolveMobileToolPath("adb");
+  if (!adbPath) return void 0;
   try {
-    const output = execFileSync("adb", ["-s", serial, "shell", "getprop", "ro.product.model"], {
+    const output = execFileSync(adbPath, ["-s", serial, "shell", "getprop", "ro.product.model"], {
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"],
       timeout: 5e3