@deeeed/metamask-harness 0.38.1 → 0.39.0

package/CHANGELOG.md

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

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/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/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/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);
+  }
+});

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

@@ -0,0 +1,96 @@
+import { runAdapter } from '../platform/bridge.mjs';
+import {
+  closeNativeSession,
+  createNativeSession,
+  nativeLabel,
+  nativeNode,
+} from '../platform/native-session.mjs';
+
+const NON_SYMBOL_LABELS = new Set([
+  'BUY',
+  'COPY',
+  'MORE',
+  'RECEIVE',
+  'SEND',
+  'SHARE',
+  'SWAP',
+]);
+
+function observedSymbol(labels, expectedSymbol) {
+  if (expectedSymbol) {
+    return labels.find((label) => label.toUpperCase() === expectedSymbol) ?? null;
+  }
+  return labels.find((label) => {
+    const candidate = label.trim();
+    return candidate === candidate.toUpperCase()
+      && /^[A-Z][A-Z0-9._-]{1,19}$/u.test(candidate)
+      && !NON_SYMBOL_LABELS.has(candidate);
+  }) ?? null;
+}
+
+runAdapter(async (input) => {
+  const expectedSymbol = String(input.node?.expected_symbol ?? '').trim().toUpperCase();
+  const requireChart = input.node?.require_chart === true;
+  const requireMarketCap = input.node?.require_market_cap === true;
+  const timeoutMs = Number(input.node?.timeout_ms ?? 30_000);
+  const session = createNativeSession(input, 'Assets', `read-details-${process.pid}`);
+  try {
+    await session.open();
+    const deadline = Date.now() + timeoutMs;
+    let snapshot;
+    let labels = [];
+    let symbol = null;
+    let price = null;
+    let chartRendered = false;
+    let chartEmpty = false;
+    let marketCap = null;
+    let malformed = false;
+    while (Date.now() <= deadline) {
+      snapshot = await session.snapshot();
+      labels = snapshot.nodes.map(nativeLabel).filter(Boolean);
+      symbol = observedSymbol(labels, expectedSymbol);
+      price = nativeLabel(nativeNode(snapshot, 'token-price')) || null;
+      chartRendered = Boolean(
+        nativeNode(snapshot, 'chart_surface')
+        ?? nativeNode(snapshot, 'tv_chart_container'),
+      );
+      chartEmpty = labels.some((label) => /no chart data/iu.test(label));
+      marketCap = labels.find((label) => /market cap/iu.test(label)) ?? null;
+      malformed = labels.some((label) => /(?:\bNaN\b|\bundefined\b|\bnull\b)/u.test(label));
+      const ready = nativeNode(snapshot, 'token-asset-overview') && symbol && price
+        && (!requireChart || chartRendered || chartEmpty)
+        && (!requireMarketCap || marketCap);
+      if (ready) break;
+      await new Promise((resolve) => setTimeout(resolve, 250));
+    }
+    if (!nativeNode(snapshot, 'token-asset-overview')) {
+      throw new Error('Expected the visible Mobile token details surface.');
+    }
+    if (expectedSymbol && !symbol) {
+      throw new Error(`Expected ${expectedSymbol} asset details, but the symbol was not visible.`);
+    }
+    if (!price) throw new Error('Expected a formatted current token price.');
+    if (requireChart && (!chartRendered || chartEmpty)) {
+      throw new Error('Expected a rendered asset price chart without an empty state.');
+    }
+    if (requireMarketCap && !marketCap) {
+      throw new Error('Expected a formatted asset market cap.');
+    }
+    if (malformed) throw new Error('Asset details contain a malformed visible value.');
+    return {
+      action: input.action,
+      source: 'visible-ui',
+      platform: 'mobile',
+      surface: 'asset-details',
+      symbol,
+      price,
+      marketCap,
+      chartRendered,
+      chartEmpty,
+      malformed,
+      proofPath: 'native-accessibility-token-details',
+    };
+  } finally {
+    await closeNativeSession(session);
+  }
+});