@deeeed/metamask-harness 0.38.0 → 0.39.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## Unreleased
 
+## 0.39.0 - 2026-08-14
+
+### Added
+
+- Add opaque Android release actions for token details, sorting, visibility, custom-token import, custom-network lifecycle, Perps search and watchlists, Swap Max, slippage, guarded submission, and wallet locking through native accessibility.
+- Make shared Assets, Perps, and Swap release recipes executable on untouched Extension and Android release artifacts with parameterized visible-state assertions.
+
+### Fixed
+
+- Keep physical-device actions on isolated semantic sessions, bypass biometric authentication with password unlock, verify every recovery-phrase field, and reject incorrect token metadata as a product failure.
+- Prove Extension token visibility changes and parse visible custom-slippage labels consistently across both clients.
+
+## 0.38.1 - 2026-08-14
+
+### Fixed
+
+- Read release evidence through verified regular-file descriptors, escape generated Markdown safely, and keep UI waits out of dynamically constructed page expressions.
+
 ## 0.38.0 - 2026-08-14
 
 ### Added

package/dist/adapters.js

@@ -8,6 +8,7 @@ import {
 import { withExtensionPage } from "../library/actions/extension/platform/cdp.mjs";
 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";
 import { resolveMobileToolPath } from "../library/actions/mobile/platform/tool-paths.mjs";
 import { resolveWalletImportCredentials, validateWalletImportOptions } from "../library/actions/shared/wallet/import-source.mjs";
 const execFileAsync = promisify(execFile);
@@ -37,6 +38,7 @@ function simpleAdapter(action, executor) {
 }
 const LIVE_ONLY_ACTIONS = /* @__PURE__ */ new Set([
   "metamask.assets.read_visible_state",
+  "metamask.assets.open_details",
   "metamask.assets.read_details",
   "metamask.assets.verify_sorting",
   "metamask.assets.set_token_visibility",
@@ -52,6 +54,7 @@ const LIVE_ONLY_ACTIONS = /* @__PURE__ */ new Set([
   "metamask.networks.add_chainlist",
   "metamask.networks.remove_custom",
   "metamask.perps.read_visible_state",
+  "metamask.perps.search_markets",
   "metamask.perps.compare_provider_market",
   "metamask.perps.read_eligibility",
   "metamask.perps.select_market_filter",
@@ -250,10 +253,11 @@ function createMetaMaskSemanticAdapters(platform, declaredCustomActions = [], pr
   const bundledActions = [
     ...walletActions,
     "metamask.assets.read_visible_state",
-    ...platform === "extension" ? ["metamask.assets.read_details"] : [],
-    ...platform === "extension" ? ["metamask.assets.verify_sorting"] : [],
-    ...platform === "extension" ? ["metamask.assets.set_token_visibility"] : [],
-    ...platform === "extension" ? ["metamask.assets.import_custom_token"] : [],
+    "metamask.assets.open_details",
+    "metamask.assets.read_details",
+    "metamask.assets.verify_sorting",
+    "metamask.assets.set_token_visibility",
+    "metamask.assets.import_custom_token",
     ...platform === "extension" ? [
       "metamask.assets.prepare_send",
       "metamask.assets.review_send",
@@ -261,10 +265,14 @@ function createMetaMaskSemanticAdapters(platform, declaredCustomActions = [], pr
       "metamask.assets.set_custom_gas",
       "metamask.assets.select_network_scope"
     ] : [],
-    ...platform === "extension" ? ["metamask.wallet.lock"] : [],
-    ...platform === "extension" ? ["metamask.networks.read_visible_state"] : [],
-    ...platform === "extension" ? ["metamask.networks.add_custom", "metamask.networks.add_chainlist", "metamask.networks.remove_custom"] : [],
+    "metamask.wallet.lock",
+    "metamask.networks.read_visible_state",
+    "metamask.networks.add_custom",
+    ...platform === "extension" ? ["metamask.networks.add_chainlist"] : [],
+    "metamask.networks.remove_custom",
     "metamask.perps.read_visible_state",
+    "metamask.perps.search_markets",
+    "metamask.perps.set_market_favorite",
     ...platform === "extension" ? ["metamask.perps.compare_provider_market"] : [],
     ...platform === "extension" ? ["metamask.perps.read_eligibility"] : [],
     ...platform === "extension" ? [
@@ -275,9 +283,9 @@ function createMetaMaskSemanticAdapters(platform, declaredCustomActions = [], pr
     "metamask.swap_bridge.read_visible_state",
     "metamask.swap_bridge.select_assets",
     "metamask.swap_bridge.set_amount",
-    ...platform === "extension" ? ["metamask.swap_bridge.set_max_amount"] : [],
-    ...platform === "extension" ? ["metamask.swap_bridge.set_slippage"] : [],
-    ...platform === "extension" ? ["metamask.swap_bridge.submit_transaction"] : [],
+    "metamask.swap_bridge.set_max_amount",
+    "metamask.swap_bridge.set_slippage",
+    "metamask.swap_bridge.submit_transaction",
     ...platform === "extension" ? ["metamask.settings.set_basic_functionality"] : [],
     "metamask.perps.read_positions",
     "metamask.perps.ensure_positions",
@@ -900,9 +908,10 @@ async function executeNativeProviderAction(action, node, context, createTranspor
   }
   const app = platform === "android" ? context.env.ANDROID_PACKAGE_ID ?? process.env.ANDROID_PACKAGE_ID ?? "io.metamask" : context.env.IOS_BUNDLE_ID ?? process.env.IOS_BUNDLE_ID ?? "io.metamask.MetaMask";
   const session = `mm-harness-${process.pid}-${context.nodeId}`.replace(/[^a-zA-Z0-9._-]/gu, "-");
+  const stateDir = nativeAgentDeviceStateDir(context.env ?? {}, context.projectRoot, String(device));
   let transport;
   try {
-    transport = await createTransport({ platform, device, app, session });
+    transport = await createTransport({ platform, device, app, session, stateDir });
   } catch (error) {
     throw new Error(
       `${action} could not start the MetaMask native UI provider. Next: npm install -g @deeeed/metamask-harness@latest`,

package/library/actions/extension/assets/open_details.mjs

@@ -0,0 +1,30 @@
+import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
+
+runAdapter(async (input) => withExtensionPage(input, async (page) => {
+  const symbol = String(input.node?.symbol ?? '').trim().toUpperCase();
+  const timeoutMs = Number(input.node?.timeout_ms ?? 30_000);
+  if (!/^[A-Z0-9._-]{2,20}$/u.test(symbol)) {
+    throw new Error('metamask.assets.open_details requires a valid token symbol.');
+  }
+  const selector = await page.evaluate(`(() => {
+    const symbol = ${JSON.stringify(symbol)};
+    for (const [index, row] of [...document.querySelectorAll('[data-testid="multichain-token-list-button"]')].entries()) {
+      const amount = String(row.querySelector('[data-testid="multichain-token-list-item-value"]')?.innerText || '').trim();
+      const observed = amount.match(/\\b([A-Za-z][A-Za-z0-9._-]{1,19})$/u)?.[1]?.toUpperCase();
+      if (observed !== symbol) continue;
+      row.setAttribute('data-mm-harness-asset-index', String(index));
+      return '[data-mm-harness-asset-index="' + index + '"]';
+    }
+    return null;
+  })()`);
+  if (!selector) throw new Error(`Visible asset ${symbol} was not found.`);
+  await page.click(selector);
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() <= deadline) {
+    if (String(await page.evaluate('location.hash')).startsWith('#/asset/')) {
+      return { action: input.action, symbol, proofPath: 'trusted-pointer-visible-ui' };
+    }
+    await page.evaluate('new Promise((resolve) => setTimeout(resolve, 100))');
+  }
+  throw new Error(`Asset details for ${symbol} did not open.`);
+}));

package/library/actions/extension/assets/set_token_visibility.mjs

@@ -75,6 +75,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
   }
   const requested = input.node.visible;
   const requireUnchanged = input.node?.require_unchanged === true;
+  const requireChange = input.node?.require_change === true;
   const timeoutMs = Number(input.node?.timeout_ms ?? 45_000);
 
   if (!(await visible(page, MANAGE))) await page.click(OPTIONS);
@@ -91,6 +92,9 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
   if (requireUnchanged && before.enabled !== requested) {
     throw new Error(`${query} token visibility did not persist as ${requested ? 'enabled' : 'disabled'}.`);
   }
+  if (requireChange && before.enabled === requested) {
+    throw new Error(`${query} token visibility was already ${requested ? 'enabled' : 'disabled'}.`);
+  }
   if (before.enabled !== requested) {
     await page.click(dataTestId(before.testId));
   }
@@ -120,6 +124,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
     query,
     requested,
     requireUnchanged,
+    requireChange,
     changed: before.enabled !== after.enabled,
     searchResult: after.label,
     toggleTestId: after.testId,

package/library/actions/extension/perps/open_balance_action.mjs

@@ -13,12 +13,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
   }
   await page.click(dataTestId('perps-balance-dropdown-balance'));
   const actionSelector = dataTestId(actionTestId);
-  const deadline = Date.now() + 10_000;
-  while (Date.now() <= deadline) {
-    const present = await page.evaluate(`(() => Boolean(document.querySelector(${JSON.stringify(actionSelector)})))()`);
-    if (present) break;
-    await new Promise((resolve) => setTimeout(resolve, 100));
-  }
+  await page.waitForSelector(actionSelector, { timeoutMs: 10_000 });
   await page.click(actionSelector);
   const expected = balanceAction === 'withdraw'
     ? ['perps-withdraw-page', 'perps-withdraw-container', 'perps-withdraw-view']

package/library/actions/extension/perps/search_markets.mjs

@@ -0,0 +1,32 @@
+import { dataTestId, runAdapter, withExtensionPage } from '../platform/cdp.mjs';
+
+runAdapter(async (input) => withExtensionPage(input, async (page) => {
+  const query = String(input.node?.query ?? '').trim();
+  const timeoutMs = Number(input.node?.timeout_ms ?? 30_000);
+  if (!query) throw new Error('metamask.perps.search_markets requires a non-empty query.');
+  await page.setInput(dataTestId('search-input'), query);
+  const deadline = Date.now() + timeoutMs;
+  let marketIds = [];
+  while (Date.now() <= deadline) {
+    marketIds = await page.evaluate(`(() => [...document.querySelectorAll('[data-testid^="market-row-"]')]
+      .filter((element) => {
+        const style = getComputedStyle(element);
+        const rect = element.getBoundingClientRect();
+        return style.display !== 'none' && style.visibility !== 'hidden' && rect.width > 0 && rect.height > 0;
+      })
+      .map((element) => String(element.getAttribute('data-testid') || ''))
+      .filter(Boolean)
+      .slice(0, 100))()`);
+    if (marketIds.length > 0) break;
+    await page.evaluate('new Promise((resolve) => setTimeout(resolve, 200))');
+  }
+  if (marketIds.length === 0) {
+    throw new Error(`Perps market search returned no visible rows for ${JSON.stringify(query)}.`);
+  }
+  return {
+    action: input.action,
+    query,
+    marketIds,
+    proofPath: 'trusted-keyboard-visible-ui',
+  };
+}));

package/library/actions/extension/perps/select_market_filter.mjs

@@ -31,8 +31,9 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
   });
   await page.click(dataTestId('filter-select-button'));
   const optionSelector = dataTestId(`filter-select-option-${option}`);
-  const found = await page.evaluate(`(() => Boolean(document.querySelector(${JSON.stringify(optionSelector)})))()`);
-  if (!found) {
+  try {
+    await page.waitForSelector(optionSelector, { timeoutMs: 2_000 });
+  } catch {
     throw new Error(`Perps market filter ${JSON.stringify(filter)} is not available in this release.`);
   }
   await page.click(optionSelector);

package/library/actions/extension/perps/set_market_favorite.mjs

@@ -9,6 +9,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
     throw new Error('metamask.perps.set_market_favorite requires favorite=true or false.');
   }
   const desired = input.node.favorite;
+  const requireUnchanged = input.node?.require_unchanged === true;
   const selector = dataTestId('perps-market-detail-favorite-button');
   const readState = () => page.evaluate(`(() => {
     const market = ${JSON.stringify(market)};
@@ -35,11 +36,15 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
   if (after.favorite !== desired) {
     throw new Error(`Perps favorite state did not become ${desired}.`);
   }
+  const changed = before.favorite !== after.favorite;
+  if (requireUnchanged && changed) {
+    throw new Error(`Perps favorite state for ${market} did not persist across navigation.`);
+  }
   return {
     action: input.action,
     market,
     requestedFavorite: desired,
-    changed: before.favorite !== after.favorite,
+    changed,
     before,
     after,
     proofPath: 'trusted-pointer-visible-ui',

package/library/actions/extension/swap_bridge/read_visible_state.mjs

@@ -13,6 +13,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
       'bridge-source-button',
       'bridge-destination-button',
       'bridge__header-settings-button',
+      'slippage-edit-button',
       'prepare-swap-page-error',
       'bridge-missing-price-banner',
     ];
@@ -39,6 +40,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
       route: location.hash,
       title: document.title,
       items,
+      slippage: String(slippageButton?.parentElement?.innerText || '').replace(/\\s+/gu, ' ').trim() || null,
       quote: {
         slippage: String(slippageButton?.parentElement?.innerText || '').replace(/\\s+/gu, ' ').trim() || null,
         networkFee: text('[data-testid="network-fees-sponsored"], [data-testid="network-fees-included"], [data-testid="network-fees"]') || null,
@@ -52,16 +54,10 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
   })()`);
   const state = normalizeVisibleSwapBridgeState(raw, options, 'extension');
   const requireQuote = input.node?.require_quote === true;
-  const expectedSlippage = input.node?.expected_slippage == null
-    ? null
-    : Number(input.node.expected_slippage);
   if (requireQuote && (!raw.quote.ctaEnabled || !(Number(state.destinationAmount) > 0)
     || !/^(?:Swap|Bridge)$/iu.test(String(raw.quote.cta)))) {
     throw new Error('Swap quote is not ready for review.');
   }
-  if (expectedSlippage !== null && raw.quote.slippage !== `${expectedSlippage}%`) {
-    throw new Error(`Swap slippage mismatch: expected ${expectedSlippage}%, observed ${raw.quote.slippage ?? 'none'}.`);
-  }
   return {
     action: input.action,
     ...state,

package/library/actions/extension/swap_bridge/set_amount.mjs

@@ -7,6 +7,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
   await page.setInput(source, options.amount);
   const deadline = Date.now() + options.timeoutMs;
   let observed;
+  let lastRefreshAt = 0;
   do {
     observed = await page.evaluate(`(() => {
       const value = (testId) => {
@@ -23,13 +24,21 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
         noQuote: document.body.innerText.includes("This trade route isn't available right now"),
       };
     })()`);
-    if (!options.waitForQuote || observed.noQuote || (Number(observed.destinationAmount) > 0 && observed.cta && observed.ctaEnabled)) break;
+    if (!options.waitForQuote || observed.noQuote) break;
+    if (/^(?:Get new quote|Refresh quote)$/iu.test(String(observed.cta))
+      && observed.ctaEnabled && Date.now() - lastRefreshAt >= 1000) {
+      await page.click(dataTestId('bridge-cta-button'));
+      lastRefreshAt = Date.now();
+    }
+    if (Number(observed.destinationAmount) > 0 && observed.ctaEnabled
+      && /^(?:Swap|Bridge)$/iu.test(String(observed.cta))) break;
     await page.evaluate('new Promise((resolve) => setTimeout(resolve, 250))');
   } while (Date.now() < deadline);
   if (observed.sourceAmount !== options.amount) {
     throw new Error(`Swap source amount mismatch: expected ${options.amount}, observed ${observed.sourceAmount}.`);
   }
-  if (options.waitForQuote && !observed.noQuote && !(Number(observed.destinationAmount) > 0 && observed.cta && observed.ctaEnabled)) {
+  if (options.waitForQuote && !observed.noQuote && !(Number(observed.destinationAmount) > 0
+    && observed.ctaEnabled && /^(?:Swap|Bridge)$/iu.test(String(observed.cta)))) {
     throw new Error(`Swap quote did not resolve within ${options.timeoutMs}ms.`);
   }
   return { action: input.action, ...observed, proofPath: 'visible-ui-amount' };

package/library/actions/extension/swap_bridge/submit_transaction.mjs

@@ -11,8 +11,8 @@ const selectors = {
   swap: dataTestId('bottom-nav-swaps'),
 };
 
-async function pause(page, timeoutMs = 200) {
-  await page.evaluate(`new Promise((resolve) => setTimeout(resolve, ${JSON.stringify(timeoutMs)}))`);
+async function pause(timeoutMs = 200) {
+  await new Promise((resolve) => setTimeout(resolve, timeoutMs));
 }
 
 async function activatePoint(page, point) {
@@ -66,14 +66,14 @@ async function openActivity(page, timeoutMs) {
     if (isActivityRoute(state.route) && await visible(page, selectors.swap) && Date.now() - lastResetAt >= 1000) {
       await activateSelector(page, selectors.swap);
       lastResetAt = Date.now();
-      await pause(page);
+      await pause();
       continue;
     }
     if (await visible(page, selectors.activity) && Date.now() - lastActivationAt >= 1000) {
       await activateSelector(page, selectors.activity);
       lastActivationAt = Date.now();
     }
-    await pause(page);
+    await pause();
   }
   throw new Error('Activity did not open after swap.');
 }
@@ -107,11 +107,11 @@ async function submittableQuote(page, timeoutMs) {
     const quote = await quoteState(page);
     if (/^(?:Get new quote|Refresh quote)$/iu.test(String(quote.cta)) && quote.ctaEnabled) {
       await page.click(selectors.cta);
-      await pause(page, 500);
+      await pause(500);
       continue;
     }
     if (/^(?:Swap|Bridge)$/iu.test(String(quote.cta)) && quote.ctaEnabled && !quote.loading) return quote;
-    await pause(page);
+    await pause();
   }
   throw new Error('Swap did not expose a fresh submittable quote.');
 }
@@ -186,7 +186,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
       || quote.warning) {
       throw new Error(`Swap quote is not safe to submit: ${JSON.stringify(quote)}.`);
     }
-    await pause(page, 2000);
+    await pause(2000);
     quote = await submittableQuote(page, Math.min(timeoutMs, 60_000));
     if (!quote.sourceSymbol.toUpperCase().includes(sourceSymbol)
       || !quote.destinationSymbol.toUpperCase().includes(destinationSymbol)
@@ -210,14 +210,14 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
     while (Date.now() < submissionDeadline) {
       if (await visible(page, selectors.warningProceed)) {
         await page.click(selectors.warningProceed);
-        await pause(page);
+        await pause();
         continue;
       }
       if (await visible(page, selectors.confirm)) {
         await page.click(selectors.confirm);
         confirmed = true;
         submitted = true;
-        await pause(page);
+        await pause();
         continue;
       }
       const state = await bodyState(page);
@@ -228,7 +228,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
       if (submitted && (state.route === '' || state.route === '#/' || isActivityRoute(state.route) || /Processing|Transaction complete|submitted/iu.test(state.text))) {
         break;
       }
-      await pause(page);
+      await pause();
     }
     if (!submitted) {
       throw new Error('Swap submission did not reach a signed or submitted state.');
@@ -259,7 +259,7 @@ runAdapter(async (input) => withExtensionPage(input, async (page) => {
       if (row?.status === 'confirmed') return row;
       if (Date.now() - lastActivityRefresh >= 5000 && await visible(page, selectors.home)) {
         await page.click(selectors.home);
-        await pause(page, 500);
+        await pause(500);
         await openActivity(page, Math.min(10_000, Math.max(1, timeoutMs)));
         lastActivityRefresh = Date.now();
       }

package/library/actions/mobile/assets/import_custom_token.mjs

@@ -0,0 +1,181 @@
+import { runAdapter } from '../platform/bridge.mjs';
+import {
+  closeNativeSession,
+  createNativeSession,
+  nativeLabel,
+  nativeNode,
+} from '../platform/native-session.mjs';
+
+async function waitForSnapshot(session, timeoutMs, predicate, message) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() <= deadline) {
+    const snapshot = await session.snapshot();
+    const value = predicate(snapshot);
+    if (value) return { snapshot, value };
+    await new Promise((resolve) => setTimeout(resolve, 200));
+  }
+  throw new Error(message);
+}
+
+async function openCustomToken(session, timeoutMs) {
+  let snapshot = await session.snapshot();
+  if (nativeNode(snapshot, 'input-token-address')) return snapshot;
+  if (!nativeNode(snapshot, 'add-token-screen')) {
+    if (!nativeNode(snapshot, 'token-list')) {
+      await session.execute('ui.press', {
+        test_id: 'homepage-section-title-tokens',
+        timeout_ms: timeoutMs,
+        settle: false,
+      });
+      await waitForSnapshot(
+        session,
+        timeoutMs,
+        (current) => nativeNode(current, 'token-list'),
+        'The Mobile token list did not open.',
+      );
+    }
+    await session.execute('ui.press', {
+      test_id: 'import-token-button',
+      timeout_ms: timeoutMs,
+      settle: false,
+    });
+    snapshot = (await waitForSnapshot(
+      session,
+      timeoutMs,
+      (current) => nativeNode(current, 'add-token-screen'),
+      'The Mobile token import screen did not open.',
+    )).snapshot;
+  }
+  if (!nativeNode(snapshot, 'input-token-address')) {
+    await session.execute('ui.press', { text: 'Custom token', timeout_ms: timeoutMs, settle: false });
+    snapshot = (await waitForSnapshot(
+      session,
+      timeoutMs,
+      (current) => nativeNode(current, 'input-token-address'),
+      'The Mobile custom-token form did not open.',
+    )).snapshot;
+  }
+  return snapshot;
+}
+
+async function selectNetwork(session, network, timeoutMs) {
+  let snapshot = await session.snapshot();
+  const selected = (current) =>
+    nativeNode(current, 'select-network-button') &&
+    current.nodes.some((node) => node.visibleToUser !== false && nativeLabel(node) === network);
+  if (selected(snapshot)) return;
+  await session.execute('ui.press', {
+    test_id: 'select-network-button',
+    timeout_ms: timeoutMs,
+    settle: false,
+  });
+  await waitForSnapshot(
+    session,
+    timeoutMs,
+    (current) => current.nodes.find((node) =>
+      node.visibleToUser !== false && node.hittable === true && nativeLabel(node) === network
+    ),
+    `${network} was not available in the Mobile token network selector.`,
+  );
+  await session.execute('ui.press', { text: network, timeout_ms: timeoutMs, settle: false });
+  snapshot = (await waitForSnapshot(
+    session,
+    timeoutMs,
+    selected,
+    `The Mobile token importer did not select ${network}.`,
+  )).snapshot;
+  return snapshot;
+}
+
+async function findTokenRow(session, symbol, timeoutMs) {
+  for (let attempt = 0; attempt < 8; attempt += 1) {
+    const snapshot = await session.snapshot();
+    const row = nativeNode(snapshot, `asset-${symbol}`);
+    if (row) return row;
+    await session.execute('ui.scroll', {
+      direction: 'down',
+      amount: 0.75,
+      timeout_ms: timeoutMs,
+      settle: false,
+    });
+  }
+  throw new Error(`${symbol} did not appear in the Mobile token list after import.`);
+}
+
+runAdapter(async (input) => {
+  const network = String(input.node?.network ?? '').trim();
+  const chainId = Number(input.node?.chain_id);
+  const address = String(input.node?.address ?? '').trim();
+  const expectedSymbol = String(input.node?.expected_symbol ?? '').trim().toUpperCase();
+  const expectedDecimals = input.node?.decimals == null ? null : String(input.node.decimals);
+  const timeoutMs = Number(input.node?.timeout_ms ?? 60_000);
+  if (!network || !Number.isInteger(chainId) || chainId <= 0 || !/^0x[0-9a-f]{40}$/iu.test(address) || !expectedSymbol) {
+    throw new Error('metamask.assets.import_custom_token requires network, positive chain_id, ERC-20 address, and expected_symbol.');
+  }
+
+  const session = createNativeSession(input, 'Assets', `custom-token-${process.pid}`);
+  try {
+    await session.open();
+    await openCustomToken(session, timeoutMs);
+    await selectNetwork(session, network, timeoutMs);
+    await openCustomToken(session, timeoutMs);
+    await session.execute('ui.set_input', {
+      test_id: 'input-token-address',
+      value: address,
+      timeout_ms: timeoutMs,
+      settle: false,
+    });
+    const metadata = (await waitForSnapshot(
+      session,
+      Math.min(timeoutMs, 20_000),
+      (snapshot) => {
+        const symbol = nativeLabel(nativeNode(snapshot, 'input-token-symbol'));
+        const decimals = nativeLabel(nativeNode(snapshot, 'input-token-decimal'));
+        return symbol ? { symbol, decimals } : null;
+      },
+      'Mobile custom-token metadata did not resolve.',
+    )).value;
+    if (metadata.symbol.toUpperCase() !== expectedSymbol) {
+      throw new Error(`Expected token symbol ${expectedSymbol}, but Mobile metadata resolved ${metadata.symbol}.`);
+    }
+    if (expectedDecimals !== null && metadata.decimals !== expectedDecimals) {
+      throw new Error(`Expected token decimals ${expectedDecimals}, but Mobile metadata resolved ${metadata.decimals}.`);
+    }
+    await waitForSnapshot(
+      session,
+      timeoutMs,
+      (snapshot) => nativeNode(snapshot, 'token-import-next-button')?.enabled === true,
+      'Mobile custom-token metadata did not enable the import action.',
+    );
+    await session.execute('ui.press', {
+      test_id: 'token-import-next-button',
+      timeout_ms: timeoutMs,
+      settle: false,
+    });
+    await waitForSnapshot(
+      session,
+      timeoutMs,
+      (snapshot) => nativeNode(snapshot, 'add-confirm-custom-asset'),
+      'The Mobile custom-token confirmation did not open.',
+    );
+    await session.execute('ui.press', { text: 'Import', timeout_ms: timeoutMs, settle: false });
+    await waitForSnapshot(
+      session,
+      timeoutMs,
+      (snapshot) => nativeNode(snapshot, 'token-list'),
+      'The Mobile token list did not reopen after import.',
+    );
+    const token = await findTokenRow(session, expectedSymbol, timeoutMs);
+    return {
+      action: input.action,
+      network,
+      chainId,
+      address,
+      metadata,
+      token: nativeLabel(token),
+      proofPath: 'native-accessibility-custom-token-import',
+    };
+  } finally {
+    await closeNativeSession(session);
+  }
+});

package/library/actions/mobile/assets/open_details.mjs

@@ -0,0 +1,43 @@
+import { runAdapter } from '../platform/bridge.mjs';
+import {
+  closeNativeSession,
+  createNativeSession,
+  nativeLabel,
+  nativeNode,
+} from '../platform/native-session.mjs';
+
+runAdapter(async (input) => {
+  const symbol = String(input.node?.symbol ?? '').trim().toUpperCase();
+  const timeoutMs = Number(input.node?.timeout_ms ?? 30_000);
+  if (!/^[A-Z0-9._-]{2,20}$/u.test(symbol)) {
+    throw new Error('metamask.assets.open_details requires a valid token symbol.');
+  }
+  const session = createNativeSession(input, 'Assets', `details-${process.pid}`);
+  try {
+    await session.open();
+    let snapshot = await session.snapshot();
+    if (!nativeNode(snapshot, 'token-asset-overview')) {
+      await session.execute('ui.press', {
+        test_id: `asset-${symbol}`,
+        timeout_ms: timeoutMs,
+        settle: false,
+      });
+    }
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() <= deadline) {
+      snapshot = await session.snapshot();
+      const symbolVisible = snapshot.nodes.some((node) => nativeLabel(node).toUpperCase() === symbol);
+      if (nativeNode(snapshot, 'token-asset-overview') && symbolVisible) {
+        return {
+          action: input.action,
+          symbol,
+          proofPath: 'native-accessibility-token-details-navigation',
+        };
+      }
+      await new Promise((resolve) => setTimeout(resolve, 200));
+    }
+    throw new Error(`Asset details for ${symbol} did not become visible.`);
+  } finally {
+    await closeNativeSession(session);
+  }
+});