@deeeed/metamask-harness 0.34.0 → 0.34.2

package/dist/adapters/mobile/video-recorder.js

@@ -7,7 +7,16 @@ import {
 } from "../../recording-target.js";
 const RECORDING_START_TIMEOUT_MS = 5e3;
 const RECORDING_STOP_TIMEOUT_MS = 1e4;
-const RECORDING_TIME_LIMIT_SECONDS = 180;
+const RECORDING_TIME_LIMIT_SECONDS = 0;
+function androidScreenrecordArgs(remotePath) {
+  return [
+    "shell",
+    "screenrecord",
+    "--time-limit",
+    String(RECORDING_TIME_LIMIT_SECONDS),
+    remotePath
+  ];
+}
 function createAndroidVideoRecorder(serial) {
   return {
     name: "adb-screenrecord",
@@ -139,15 +148,7 @@ async function startAndroidRecording(serial, request) {
   const remotePath = `/sdcard/Download/mm-harness-recipe-${Date.now()}-${process.pid}.mp4`;
   const child = spawn(
     "adb",
-    [
-      "-s",
-      serial,
-      "shell",
-      "screenrecord",
-      "--time-limit",
-      String(RECORDING_TIME_LIMIT_SECONDS),
-      remotePath
-    ],
+    ["-s", serial, ...androidScreenrecordArgs(remotePath)],
     { stdio: ["ignore", "pipe", "pipe"] }
   );
   const stderr = [];
@@ -277,6 +278,7 @@ function sleep(durationMs) {
   return new Promise((resolve) => setTimeout(resolve, durationMs));
 }
 export {
+  androidScreenrecordArgs,
   createAndroidVideoRecorder,
   createIosSimulatorVideoRecorder
 };

package/dist/adapters.js

@@ -39,6 +39,8 @@ const LIVE_ONLY_PERPS_ACTIONS = /* @__PURE__ */ new Set([
   "metamask.perps.ensure_orders",
   "metamask.perps.assert_orders",
   "metamask.perps.clear_performance_caches",
+  "metamask.perps.measure_homepage_visible",
+  "metamask.perps.prepare_local_snapshot_endpoint",
   "metamask.perps.start_state",
   "metamask.perps.teardown_state",
   "metamask.perps.capture_performance"
@@ -198,7 +200,11 @@ function createMetaMaskSemanticAdapters(platform, declaredCustomActions = [], pr
     "metamask.perps.start_state",
     "metamask.perps.teardown_state",
     "metamask.perps.capture_performance",
-    ...platform === "mobile" ? ["metamask.perps.clear_performance_caches"] : [],
+    ...platform === "mobile" ? [
+      "metamask.perps.clear_performance_caches",
+      "metamask.perps.measure_homepage_visible",
+      "metamask.perps.prepare_local_snapshot_endpoint"
+    ] : [],
     // read_account is core-only: only the headless core adapter implements it.
     ...platform === "core" ? ["metamask.perps.read_account"] : []
   ];
@@ -283,6 +289,17 @@ function resolveMobileWaitTarget(payload) {
     visibility: expected === "visible" || expected === "hidden" ? "viewport" : "tree"
   };
 }
+const RETRYABLE_MOBILE_WAIT_CODES = /* @__PURE__ */ new Set([
+  MOBILE_BRIDGE_ERROR_CODES.NO_TARGET,
+  MOBILE_BRIDGE_ERROR_CODES.CDP_TIMEOUT,
+  MOBILE_BRIDGE_ERROR_CODES.WS_CLOSED,
+  MOBILE_BRIDGE_ERROR_CODES.METRO_UNREACHABLE
+]);
+function isRetryableMobileWaitError(error) {
+  return Boolean(
+    isRecord(error) && typeof error.code === "string" && RETRYABLE_MOBILE_WAIT_CODES.has(error.code)
+  );
+}
 async function waitForMobileTarget(input, payload) {
   const timeoutMs = Number(payload.timeout_ms ?? payload.timeoutMs ?? 1e4);
   const deadline = Date.now() + timeoutMs;
@@ -308,9 +325,28 @@ async function waitForMobileTarget(input, payload) {
       })()` : null;
   let lastResult = null;
   let lastText = null;
+  let lastBridgeError = null;
   const expectsAbsent = expected === "absent" || expected === "hidden" || expected === "not_present";
   while (Date.now() <= deadline) {
-    const result = await evalAsync(input, queryExpression);
+    const remainingMs = Math.max(1, deadline - Date.now());
+    const probeTimeoutMs = Math.min(5e3, remainingMs);
+    const probeInput = {
+      ...input,
+      node: {
+        ...input.node,
+        bridge_timeout_ms: probeTimeoutMs,
+        cdp_timeout_ms: probeTimeoutMs
+      }
+    };
+    let result;
+    try {
+      result = await evalAsync(probeInput, queryExpression);
+    } catch (error) {
+      if (!isRetryableMobileWaitError(error)) throw error;
+      lastBridgeError = error;
+      await sleep(250);
+      continue;
+    }
     if (!isRecord(result) || result.unsupported === true) {
       throw new Error(
         "Mobile ui.wait_for requires the current __AGENTIC__.queryUiTarget bridge for text-only or viewport-visible assertions."
@@ -321,7 +357,14 @@ async function waitForMobileTarget(input, payload) {
     const visible = result.visible === true;
     let textMatched = !expectedText || textMatch === "contains";
     if (expectedText && textMatch === "exact" && textExpression) {
-      lastText = await evalSync(input, textExpression);
+      try {
+        lastText = await evalSync(probeInput, textExpression);
+      } catch (error) {
+        if (!isRetryableMobileWaitError(error)) throw error;
+        lastBridgeError = error;
+        await sleep(250);
+        continue;
+      }
       textMatched = traceText(lastText) === expectedText;
     }
     const matched = expected === "visible" ? visible && textMatched : expected === "hidden" ? !visible : expectsAbsent ? !present : present && textMatched;
@@ -344,8 +387,9 @@ async function waitForMobileTarget(input, payload) {
     expectedText ? `text ${textMatch} ${JSON.stringify(expectedText)}` : ""
   ].filter(Boolean).join(" with ");
   const exactReason = textMatch === "exact" ? `; last text=${JSON.stringify(lastText)}` : "";
+  const bridgeReason = lastBridgeError ? `; last bridge error=${traceText(lastBridgeError)}` : "";
   throw new Error(
-    `Timed out waiting for mobile ${target} to be ${expected}; last result=${JSON.stringify(lastResult)}${exactReason}.`
+    `Timed out waiting for mobile ${target} to be ${expected}; last result=${JSON.stringify(lastResult)}${exactReason}${bridgeReason}.`
   );
 }
 const MOBILE_BRIDGE_HANDLERS = {
@@ -427,6 +471,48 @@ async function handleMobileScroll(payload, context) {
   const testId = optionalScalarText(payload.test_id ?? payload.testID, "ui.scroll.test_id");
   const offset = scalarText(payload.offset ?? payload.delta_y ?? payload.deltaY, "ui.scroll.offset", "600");
   const intoView = payload.scroll_into_view === true || payload.into_view === true;
+  const measureFromTestId = optionalScalarText(
+    payload.measure_from_test_id ?? payload.measureFromTestId,
+    "ui.scroll.measure_from_test_id"
+  );
+  const measureTargetTestId = optionalScalarText(
+    payload.measure_target_test_id ?? payload.measureTargetTestId,
+    "ui.scroll.measure_target_test_id"
+  );
+  const measureTargetText = optionalScalarText(
+    payload.measure_target_text ?? payload.measureTargetText,
+    "ui.scroll.measure_target_text"
+  );
+  const measureTargetCount = Number(Boolean(measureTargetTestId)) + Number(Boolean(measureTargetText));
+  const measureRequiredPresentTestId = optionalScalarText(
+    payload.measure_required_present_test_id ?? payload.measureRequiredPresentTestId,
+    "ui.scroll.measure_required_present_test_id"
+  );
+  if (Boolean(measureFromTestId) !== (measureTargetCount === 1)) {
+    throw new Error(
+      "ui.scroll visible-transition measurement requires measure_from_test_id and exactly one of measure_target_test_id or measure_target_text."
+    );
+  }
+  if (measureFromTestId && measureTargetCount === 1) {
+    if (intoView) {
+      throw new Error(
+        "ui.scroll visible-transition measurement uses an explicit offset and does not support scroll_into_view."
+      );
+    }
+    return measureMobileScrollTransition(input, {
+      animated: payload.animated === true,
+      fromTestId: measureFromTestId,
+      offset: Number(offset),
+      ...measureTargetTestId ? { targetTestId: measureTargetTestId } : {},
+      ...measureTargetText ? { targetText: measureTargetText } : {},
+      ...measureRequiredPresentTestId ? { requiredPresentTestId: measureRequiredPresentTestId } : {},
+      timeoutMs: Math.max(
+        1,
+        Number(payload.timeout_ms ?? payload.timeoutMs ?? 3e4)
+      ),
+      ...testId ? { scrollTestId: testId } : {}
+    });
+  }
   if (testId && intoView) {
     const before = await queryMobileViewportTarget(input, testId);
     if (before.visible === true) {
@@ -448,12 +534,23 @@ async function handleMobileScroll(payload, context) {
     ...intoView ? ["--into-view"] : [],
     animatedFlag(payload)
   ] : ["scroll-view", "--offset", offset, animatedFlag(payload)];
-  const result = await bridgeCommand(input, args);
+  const timeoutMs = Math.max(0, Number(payload.timeout_ms ?? payload.timeoutMs ?? 5e3));
+  const deadline = Date.now() + timeoutMs;
+  let result;
+  while (true) {
+    try {
+      result = await bridgeCommand(input, args);
+      break;
+    } catch (error) {
+      if (!testId || Date.now() >= deadline) throw error;
+      await sleep(100);
+    }
+  }
   if (testId && intoView) {
     const after = await waitForMobileViewportTarget(
       input,
       testId,
-      Number(payload.timeout_ms ?? payload.timeoutMs ?? 5e3)
+      timeoutMs
     );
     if (after.visible !== true) {
       throw new Error(
@@ -466,6 +563,36 @@ async function handleMobileScroll(payload, context) {
     intoView
   };
 }
+async function measureMobileScrollTransition(input, options) {
+  const result = await bridgeCommand(
+    {
+      ...input,
+      node: {
+        ...input.node,
+        bridge_timeout_ms: options.timeoutMs + 5e3,
+        cdp_timeout_ms: options.timeoutMs + 5e3
+      }
+    },
+    ["measure-scroll-transition", JSON.stringify(options)]
+  );
+  if (!isRecord(result) || result.unsupported === true) {
+    throw new Error(
+      "ui.scroll visible-transition measurement requires queryUiTarget and scrollView on the current mobile bridge."
+    );
+  }
+  if (result.ok !== true) {
+    throw new Error(
+      `ui.scroll visible-transition measurement failed: ${traceText(result.error ?? result)}.`
+    );
+  }
+  return {
+    ...result,
+    measureFromTestId: options.fromTestId,
+    ...options.targetTestId ? { measureTargetTestId: options.targetTestId } : {},
+    ...options.targetText ? { measureTargetText: options.targetText } : {},
+    ...options.requiredPresentTestId ? { measureRequiredPresentTestId: options.requiredPresentTestId } : {}
+  };
+}
 async function queryMobileViewportTarget(input, testId) {
   const expression = `(function(){
     const api = globalThis.__AGENTIC__;
@@ -851,6 +978,7 @@ export {
   createMetaMaskUiTransport,
   hideMobileHudOnTeardown,
   isMobileHudLifecycleSkip,
+  isRetryableMobileWaitError,
   normalizeUiWaitNode,
   resolveMobileWaitTarget
 };

package/dist/commands/launch/index.js

@@ -316,6 +316,15 @@ async function handleLaunchLocked(argv, stream) {
       originalError: attempt.output.trim() || void 0
     });
   }
+  if (adapter === "mobile" && tier === "build" && /open-device: (?:Android|iOS) native build failed/u.test(attempt.output)) {
+    return launchFail(jsonOutput, stream, adapter, mobileTarget, tier, state, target, {
+      code: "MOBILE_NATIVE_BUILD_FAILED",
+      message: "the selected Mobile native build failed; refusing to repeat the expensive build as a Metro recovery.",
+      recoverable: false,
+      exitCode: EXIT.runtime,
+      originalError: attempt.output.trim() || void 0
+    });
+  }
   const bound = checkHealBounds(target, attempt.output, state);
   if (bound !== null) {
     return launchFail(jsonOutput, stream, adapter, mobileTarget, tier, state, target, {

package/dist/commands/launch/mobile.js

@@ -1,18 +1,32 @@
 import { prepareMobile } from "../../adapters/mobile/prepare.js";
+import {
+  mobileSourceCheck,
+  recordMobileSourceBaseline
+} from "../../adapters/mobile/source-freshness.js";
 import { ensureHarnessFresh } from "../../adapters/harness-freshness.js";
+import { EXIT } from "../shared.js";
 async function launchMobile(target, mobileTarget, tier, json, restartApp = false, clearMetro = false) {
   await ensureHarnessFresh(target, "mobile");
   const platform = mobileTarget ?? "ios";
   const watcherPort = process.env.WATCHER_PORT ? parseInt(process.env.WATCHER_PORT, 10) : void 0;
-  const preflightMode = tier === "build" ? "auto" : "fast";
-  return prepareMobile(target, {
+  const preflightMode = tier === "build" ? "rebuild-native" : "fast";
+  const source = mobileSourceCheck(target);
+  const result = await prepareMobile(target, {
     platform,
     json,
     watcherPort,
     preflightMode,
-    restartApp,
+    restartApp: restartApp || source.status !== "current",
     clearMetro
   });
+  if (result.status !== 0) return result;
+  if (!recordMobileSourceBaseline(target, source.fingerprint)) {
+    const message = "Mobile source changed while the app was launching; the loaded-source baseline was not recorded.\n  Next: re-run mm-harness launch.";
+    if (!json) process.stderr.write(`${message}
+`);
+    return { status: EXIT.runtime, output: message };
+  }
+  return result;
 }
 export {
   launchMobile

package/dist/live-adapter-contract.js

@@ -352,9 +352,16 @@ function liveAdapterProcessTimeoutMs(node) {
   }
   const settleMs = Number(node.settle_ms);
   const settleAllowance = Number.isFinite(settleMs) && settleMs > 0 ? settleMs : 0;
-  if (node.timeout_ms != null) {
-    const timeoutMs = Number(node.timeout_ms);
-    return Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs + settleAllowance + 5e3 : 6e4;
+  const actionTimeouts = [
+    node.target_timeout_ms,
+    node.unlock_timeout_ms,
+    node.timeout_ms
+  ].map(Number).filter((value) => Number.isFinite(value) && value > 0);
+  if (actionTimeouts.length > 0) {
+    return Math.max(
+      6e4,
+      actionTimeouts.reduce((total, value) => total + value, 0) + settleAllowance + 5e3
+    );
   }
   return 6e4 + settleAllowance;
 }

package/dist/recipe-security.js

@@ -29,6 +29,8 @@ const APP_MUTATION_CUSTOM_ACTIONS = /* @__PURE__ */ new Set([
   "metamask.perps.ensure_positions",
   "metamask.perps.ensure_orders",
   "metamask.perps.clear_performance_caches",
+  "metamask.perps.measure_homepage_visible",
+  "metamask.perps.prepare_local_snapshot_endpoint",
   "metamask.perps.start_state",
   "metamask.perps.teardown_state",
   // Consent changes wallet state and is therefore an app mutation.

package/dist/runner.js

@@ -1,4 +1,4 @@
-import { execSync } from "node:child_process";
+import { execFileSync, execSync } from "node:child_process";
 import { OFFICIAL_RECIPE_ACTIONS } from "@farmslot/protocol";
 import { createMetaMaskAdapters, createMetaMaskUiTransport } from "./adapters.js";
 import { bridgeCommand } from "../library/actions/mobile/platform/bridge.mjs";
@@ -239,6 +239,8 @@ function isAutomaticHudProgress(action, node, nodeId) {
 function mobileSourceAwareLifecycleAdapters(adapter, lifecycle, readinessProbe = probeMobileLifecycleRuntime, sourceFreshness = {
   fingerprint: mobileSourceFingerprint,
   record: recordMobileSourceBaseline
+}, processIdentity = {
+  readIosPid: readIosAppPid
 }) {
   if (adapter !== "mobile") return lifecycle;
   return lifecycle.map((entry) => ({
@@ -246,6 +248,8 @@ function mobileSourceAwareLifecycleAdapters(adapter, lifecycle, readinessProbe =
     async execute(node, context) {
       const command = node.command ?? node.event ?? node.state;
       const reloadsSource = command === "launch" || command === "foreground" || command === "restart";
+      const checksIosContinuity = command === "foreground" && !isAndroidLifecycle(node, context.env ?? {});
+      const processBefore = checksIosContinuity ? processIdentity.readIosPid(node, context) : void 0;
       const fingerprint = reloadsSource ? sourceFreshness.fingerprint(context.projectRoot) : void 0;
       const androidRestart = command === "restart" && isAndroidLifecycle(node, context.env ?? {});
       const initialNode = androidRestart ? { ...node, settle_ms: 0 } : node;
@@ -261,6 +265,25 @@ function mobileSourceAwareLifecycleAdapters(adapter, lifecycle, readinessProbe =
       if (reloadsSource) {
         await readinessProbe(node, context);
       }
+      if (checksIosContinuity) {
+        const processAfter = processIdentity.readIosPid(node, context);
+        const actualTransition = processBefore !== null && processBefore === processAfter ? "foreground_resume" : processAfter !== null ? "cold_relaunch" : "unknown";
+        const resultRecord = asRecord(result);
+        result = {
+          ...resultRecord,
+          output: {
+            ...asRecord(resultRecord.output),
+            actualTransition,
+            processBefore,
+            processAfter
+          }
+        };
+        if (node.require_process_continuity === true && actualTransition !== "foreground_resume") {
+          throw new Error(
+            `iOS foreground did not preserve the app process (actualTransition=${actualTransition}, before=${String(processBefore)}, after=${String(processAfter)}); this lifecycle sample is a cold relaunch, not a reconnect.`
+          );
+        }
+      }
       if (fingerprint !== void 0 && !sourceFreshness.record(context.projectRoot, fingerprint)) {
         throw new Error(
           "Mobile source changed while the app was reloading; the loaded-source baseline was not recorded. Next: retry app.lifecycle restart."
@@ -270,6 +293,26 @@ function mobileSourceAwareLifecycleAdapters(adapter, lifecycle, readinessProbe =
     }
   }));
 }
+function readIosAppPid(node, context) {
+  const env = context.env ?? {};
+  const device = node.simulator ?? node.ios_simulator ?? env.SIM_UDID ?? env.IOS_SIMULATOR ?? process.env.SIM_UDID ?? process.env.IOS_SIMULATOR;
+  const bundleId = node.bundle_id ?? node.bundleId ?? env.IOS_BUNDLE_ID ?? process.env.IOS_BUNDLE_ID ?? "io.metamask.MetaMask";
+  if (typeof device !== "string" || typeof bundleId !== "string") return null;
+  try {
+    const output = execFileSync(
+      "xcrun",
+      ["simctl", "spawn", device, "launchctl", "list"],
+      { encoding: "utf8", timeout: 5e3 }
+    );
+    const labelPrefix = `UIKitApplication:${bundleId}[`;
+    const line = output.split("\n").find((candidate) => candidate.includes(labelPrefix));
+    if (!line) return null;
+    const pid = Number.parseInt(line.trim().split(/\s+/u)[0] ?? "", 10);
+    return Number.isInteger(pid) && pid > 0 ? pid : null;
+  } catch {
+    return null;
+  }
+}
 function isAndroidLifecycle(node, env) {
   const platform = node.platform ?? env.PLATFORM ?? process.env.PLATFORM;
   if (platform === "android") return true;
@@ -299,10 +342,9 @@ function mergeAndroidRestartResults(initialResult, foregroundResult) {
 }
 async function probeMobileLifecycleRuntime(node, context) {
   const command = node.command ?? node.event ?? node.state;
-  const defaultTimeoutMs = command === "restart" || command === "launch" ? 6e4 : 3e4;
-  const timeoutMs = lifecycleReadinessTimeout(
-    node.runtime_ready_timeout_ms,
-    defaultTimeoutMs
+  const timeoutMs = resolveMobileLifecycleReadinessTimeout(
+    command,
+    node.runtime_ready_timeout_ms
   );
   const deadline = Date.now() + timeoutMs;
   let lastError;
@@ -328,8 +370,10 @@ async function probeMobileLifecycleRuntime(node, context) {
     `Mobile lifecycle ${String(command)} did not expose a usable pinned __AGENTIC__ runtime within ${timeoutMs}ms: ${lastError instanceof Error ? lastError.message : String(lastError)}`
   );
 }
-function lifecycleReadinessTimeout(value, fallback) {
-  if (value === void 0) return fallback;
+function resolveMobileLifecycleReadinessTimeout(command, value) {
+  if (value === void 0) {
+    return command === "launch" || command === "restart" || command === "foreground" ? 6e4 : 3e4;
+  }
   const timeout = Number(value);
   if (!Number.isInteger(timeout) || timeout < 1e3 || timeout > 12e4) {
     throw new Error(
@@ -364,5 +408,6 @@ export {
   createMetaMaskMobileRunner,
   createMetaMaskRunner,
   isAutomaticHudProgress,
-  mobileSourceAwareLifecycleAdapters
+  mobileSourceAwareLifecycleAdapters,
+  resolveMobileLifecycleReadinessTimeout
 };

package/dist/runtime-context.js

@@ -244,6 +244,7 @@ function persistExplicitDevicePin(target, device) {
     return;
   }
   const next = { ...existing };
+  next.platform = device.platform;
   if (device.platform === "ios") {
     const simulatorName = device.name ? device.name.replace(/_/gu, " ").trim() : device.id;
     next.simulator = simulatorName;

package/library/actions/mobile/perps/measure_homepage_visible.mjs

@@ -0,0 +1,4 @@
+import { runAdapter } from '../platform/bridge.mjs';
+import { measureHomepageVisible } from './perps.mjs';
+
+runAdapter(measureHomepageVisible);