@deeeed/metamask-harness 0.78.0 → 0.80.0

package/library/actions/harness-exports.mjs

@@ -1,4 +1,4 @@
-// Bridge from library actions to the harness path/recording helpers. Published
+// Bridge from library actions to the harness path helpers. Published
 // installs load the compiled dist (node cannot type-strip .ts under
 // node_modules); source checkouts without dist fall back to src. Deliberately
 // narrow — importing the package entry here would close an import cycle
@@ -14,20 +14,15 @@ async function load(distRelative, srcRelative) {
 }
 
 const paths = await load('dist/paths.js', 'src/paths.ts');
-const recording = await load('dist/run-recording.js', 'src/run-recording.ts');
 const featureFlags = await load('dist/feature-flags.js', 'src/feature-flags.ts');
 
 export const {
   importRecipeHarnessRuntimeBrowserExtension,
   importRecipeHarnessRuntimeCdp,
   extensionIdPath,
-  recipeHarnessPath,
-  recipeRuntimeDir,
   walletFixturePath,
 } = paths;
 
-export const { captureActiveRecipeRecordingSnapshot } = recording;
-
 // One normalisation for --remote-flag specs, fixture objects, and the
 // doctor/status summary line. See src/feature-flags.ts.
 export const {

package/library/actions/mobile/app/network-control.mjs

@@ -3,7 +3,9 @@
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 
-import { resolveMobileToolPath } from '../platform/tool-paths.mjs';
+import { resolveMobileToolPath } from '@farmslot/adapter-rn';
+
+import { nativeAppId } from '../platform/native-session-name.mjs';
 
 const execFileAsync = promisify(execFile);
 
@@ -31,13 +33,9 @@ function selectedAndroidSerial(input) {
 }
 
 function selectedAndroidPackage(input) {
-  return String(
-    input.node?.package_id ??
-      input.node?.app_id ??
-      input.context?.env?.ANDROID_PACKAGE_ID ??
-      process.env.ANDROID_PACKAGE_ID ??
-      'io.metamask',
-  ).trim();
+  const explicit = input.node?.package_id ?? input.node?.app_id;
+  if (explicit != null) return String(explicit).trim();
+  return nativeAppId({ ...process.env, ...(input.context?.env ?? {}) }, 'android');
 }
 
 async function defaultRun(file, args) {

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

@@ -4,7 +4,7 @@ import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 
 import { runAdapter } from '../platform/bridge.mjs';
-import { resolveMobileToolPath } from '../platform/tool-paths.mjs';
+import { resolveMobileToolPath } from '@farmslot/adapter-rn';
 
 const execFileAsync = promisify(execFile);
 

package/library/actions/mobile/platform/bridge.mjs

@@ -8,10 +8,10 @@ import { promisify } from 'node:util';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import bridgeErrors from '../../../../adapters/mobile/bridge-runtime/lib/bridge-errors.cjs';
-import brokerModule from '../../../../adapters/mobile/bridge-runtime/lib/cdp-broker.cjs';
-import configModule from '../../../../adapters/mobile/bridge-runtime/lib/config.cjs';
-import { resolveMobileToolPath } from './tool-paths.mjs';
+import bridgeErrors from '@farmslot/adapter-rn/bridge-runtime/lib/bridge-errors.cjs';
+import brokerModule from '@farmslot/recipe-runner/cdp-broker';
+import configModule from '@farmslot/adapter-rn/bridge-runtime/lib/config.cjs';
+import { resolveMobileToolPath } from '@farmslot/adapter-rn';
 
 const {
   BRIDGE_ERROR_CODES,
@@ -155,8 +155,8 @@ export async function bridgeEnv(input) {
     ...(input.context?.env || {}),
     CDP_TIMEOUT: String(input.node?.cdp_timeout_ms ?? process.env.CDP_TIMEOUT ?? '10000'),
   };
-  if (adbPath) env.MM_HARNESS_ADB_PATH = adbPath;
-  if (idbPath) env.MM_HARNESS_IDB_PATH = idbPath;
+  if (adbPath) env.RECIPE_RN_ADB_PATH = adbPath;
+  if (idbPath) env.RECIPE_RN_IDB_PATH = idbPath;
   const target = resolveMobileTarget(input);
   const requestedPlatform = target.requestedPlatform;
   const watcherPort = target.watcherPort;
@@ -238,8 +238,8 @@ export function resolveMobileTarget(input) {
     input.node?.sim_udid ?? contextEnv.SIM_UDID ?? process.env.SIM_UDID;
   const configuredPlatform = String(
     input.node?.platform ??
-      contextEnv.MM_HARNESS_EXPLICIT_PLATFORM ??
-      process.env.MM_HARNESS_EXPLICIT_PLATFORM ??
+      contextEnv.RECIPE_RN_EXPLICIT_PLATFORM ??
+      process.env.RECIPE_RN_EXPLICIT_PLATFORM ??
       contextEnv.PLATFORM ??
       process.env.PLATFORM ??
       '',

package/library/actions/mobile/platform/native-session-name.mjs

@@ -1,7 +1,27 @@
 // Derive native session names and device-specific state directories, honoring configured overrides.
 import path from 'node:path';
 
-export function nativeSessionName(env, device, app = 'io.metamask') {
+// The host adapter supplies the app under test in the action env
+// (ANDROID_PACKAGE_ID / IOS_BUNDLE_ID, display name in
+// METAMASK_RECIPE_MOBILE_APP_LABEL); the library has no default app.
+export function nativeAppId(env, platform) {
+  const key = platform === 'android' ? 'ANDROID_PACKAGE_ID' : 'IOS_BUNDLE_ID';
+  const app = String(env[key] ?? '').trim();
+  if (!app) {
+    throw new Error(`Mobile native UI needs the app identity in ${key}. Next: run through mm-harness run or call, or set ${key}.`);
+  }
+  return app;
+}
+
+export function nativeAppLabel(env) {
+  const label = String(env.METAMASK_RECIPE_MOBILE_APP_LABEL ?? '').trim();
+  if (!label) {
+    throw new Error('Mobile native UI needs the app display name in METAMASK_RECIPE_MOBILE_APP_LABEL. Next: run through mm-harness run or call, or set METAMASK_RECIPE_MOBILE_APP_LABEL.');
+  }
+  return label;
+}
+
+export function nativeSessionName(env, device, app) {
   const configured = String(env.METAMASK_RECIPE_MOBILE_SESSION ?? '').trim();
   const source = configured || `mm-harness-${app}-${device}`;
   return source.replace(/[^A-Za-z0-9._-]/gu, '-').slice(0, 120);

package/library/actions/mobile/platform/native-session.mjs

@@ -1,6 +1,6 @@
 // Create device-targeted native UI sessions for actions and accessibility snapshots.
 // Opening an instrumented iOS session hides the accessibility-masking HUD.
-import { createAgentDeviceUiTransport } from '@farmslot/expo-recipe';
+import { createAgentDeviceUiTransport } from '@farmslot/adapter-rn';
 import { createAgentDeviceClient } from 'agent-device';
 
 import { resolveMobileTarget } from './bridge.mjs';
@@ -8,6 +8,7 @@ import { hideAccessibilityMaskingHud } from './observe-ui.mjs';
 
 import {
   nativeAgentDeviceStateDir,
+  nativeAppId,
   nativeSessionName,
 } from './native-session-name.mjs';
 
@@ -19,9 +20,7 @@ export function createNativeSession(input, domain, sessionSuffix = '') {
     ? target.adbSerial ?? ''
     : input.node?.sim_udid ?? env.SIM_UDID ?? target.iosSimulator ?? '').trim();
   if (!device) throw new Error(`Mobile ${domain} native actions require one explicit ${platform} device. Next: pass --device <device>.`);
-  const app = String(platform === 'android'
-    ? env.ANDROID_PACKAGE_ID ?? 'io.metamask'
-    : env.IOS_BUNDLE_ID ?? 'io.metamask.MetaMask');
+  const app = nativeAppId(env, platform);
   const baseSession = nativeSessionName(env, device, app);
   const session = sessionSuffix
     ? `${baseSession}-${String(sessionSuffix).replace(/[^A-Za-z0-9._-]/gu, '-')}`.slice(0, 120)

package/library/actions/mobile/platform/observe-ui.mjs

@@ -7,9 +7,11 @@ import { createAgentDeviceClient } from 'agent-device';
 import { bridgeCommand } from './bridge.mjs';
 import {
   nativeAgentDeviceStateDir,
+  nativeAppId,
+  nativeAppLabel,
   nativeSessionName,
 } from './native-session-name.mjs';
-import { mobileToolRecovery, resolveMobileToolPath } from './tool-paths.mjs';
+import { mobileToolRecovery, resolveMobileToolPath } from '@farmslot/adapter-rn';
 
 const execFileAsync = promisify(execFile);
 const VISIBLE_LIMIT = 200;
@@ -93,8 +95,13 @@ async function readNativeHierarchy(payload, context) {
     env.METAMASK_RECIPE_PROJECT_ROOT = String(context.projectRoot);
   }
   const platform = resolvePlatform(node, env);
-  if (platform === 'android') return readAndroidHierarchy(node, env);
-  return readIosHierarchy(node, env);
+  const appLabel = nativeAppLabel(env);
+  const hierarchy = platform === 'android'
+    ? await readAndroidHierarchy(node, env)
+    : await readIosHierarchy(node, env);
+  // No screen name and no labelled item: name the screen after the app.
+  hierarchy.screen.name ??= appLabel;
+  return hierarchy;
 }
 
 async function readIosHierarchy(node, env) {
@@ -166,7 +173,7 @@ async function readAndroidHierarchy(node, env) {
 }
 
 async function readAndroidAgentDeviceHierarchy(serial, env) {
-  const app = text(env.ANDROID_PACKAGE_ID) ?? 'io.metamask';
+  const app = nativeAppId(env, 'android');
   const session = nativeSessionName(env, serial, app);
   const stateDir = nativeAgentDeviceStateDir(env, env.METAMASK_RECIPE_PROJECT_ROOT ?? process.cwd(), serial);
   const client = createAgentDeviceClient({
@@ -257,8 +264,7 @@ function normalizedHierarchy(
   const items = nodes.slice(0, VISIBLE_LIMIT);
   const hiddenOrOffscreen = hiddenNodes.slice(0, HIDDEN_LIMIT);
   const name = metadata.screenName ??
-    items.find((item) => item.label)?.label ??
-    'MetaMask';
+    items.find((item) => item.label)?.label;
   return {
     screen: {
       provider,

package/library/actions/mobile/ui/native-navigation.mjs

@@ -1,9 +1,10 @@
 // Navigate Android Home, Swap, and Perps through native controls and verify visible destinations.
 // Switch Perps Lite or Pro mode through visible controls on Android and iOS.
-import { createAgentDeviceUiTransport } from '@farmslot/expo-recipe';
+import { createAgentDeviceUiTransport } from '@farmslot/adapter-rn';
 import { createAgentDeviceClient } from 'agent-device';
 import {
   nativeAgentDeviceStateDir,
+  nativeAppId,
   nativeSessionName,
 } from '../platform/native-session-name.mjs';
 import { bridgeCommand } from '../platform/bridge.mjs';
@@ -51,7 +52,7 @@ export async function navigateOpaqueMobile(input, destination) {
   if (!device) {
     throw new Error('Opaque Mobile navigation requires one explicit Android device serial.');
   }
-  const app = String(env.ANDROID_PACKAGE_ID ?? 'io.metamask');
+  const app = nativeAppId(env, 'android');
   const session = nativeSessionName(env, device, app);
   const stateDir = nativeAgentDeviceStateDir(env, input.context.projectRoot, device);
   const client = createAgentDeviceClient({
@@ -184,7 +185,7 @@ export async function ensureVisibleAndroidPerpsMode(input, perpsMode) {
       'Android Perps mode requires one explicit device serial.',
     );
   }
-  const app = String(env.ANDROID_PACKAGE_ID ?? 'io.metamask');
+  const app = nativeAppId(env, 'android');
   const session = nativeSessionName(env, device, app);
   const stateDir = nativeAgentDeviceStateDir(env, input.context.projectRoot, device);
   const client = createAgentDeviceClient({

package/library/actions/mobile/wallet/native-ui.mjs

@@ -1,9 +1,10 @@
 // Drive Android wallet onboarding, lock, unlock, and reset through native accessibility.
 // Wallet observations can navigate home and open the address list to verify the selected account.
-import { createAgentDeviceUiTransport } from '@farmslot/expo-recipe';
+import { createAgentDeviceUiTransport } from '@farmslot/adapter-rn';
 import { createAgentDeviceClient } from 'agent-device';
 import {
   nativeAgentDeviceStateDir,
+  nativeAppId,
   nativeSessionName,
 } from '../platform/native-session-name.mjs';
 
@@ -249,7 +250,7 @@ function nativeSession(input) {
   const env = { ...process.env, ...(input.context?.env ?? {}) };
   const device = String(env.ADB_SERIAL ?? env.ANDROID_SERIAL ?? '').trim();
   if (!device) throw new Error('Opaque Mobile UI execution requires one explicit Android device serial.');
-  const app = String(env.ANDROID_PACKAGE_ID ?? 'io.metamask');
+  const app = nativeAppId(env, 'android');
   const session = nativeSessionName(env, device, app);
   const stateDir = nativeAgentDeviceStateDir(env, input.context.projectRoot, device);
   const client = createAgentDeviceClient({

package/library/actions/shared/analytics/_adapter.mjs

@@ -1,6 +1,6 @@
 // Minimal adapter IO for the shared analytics actions.
 //
-// Mirrors the live-adapter contract in src/live-adapter-contract.ts. Neither
+// Mirrors the live-adapter contract in @farmslot/recipe-cli/harness. Neither
 // existing runAdapter fits: extension's lives under actions/extension/platform
 // and core's carries PerpsController teardown and expect_error handling. A
 // `shared/` action importing either would couple every platform to one of them,

package/library/actions/shared/console-findings.mjs

@@ -1,6 +1,6 @@
 // The one console matcher: classify application console events and apply a
 // recipe-library allowlist of known noise. Used by run diagnostics
-// (src/run-diagnostics.ts), the assert_no_console_errors action, the
+// (src/console-classifier.ts), the assert_no_console_errors action, the
 // allowlist generator, and the recipe library's checks/console-guard.mjs
 // (which imports this file), so every caller judges an event the same way.
 //

package/library/actions/terminal/platform/runtime.mjs

@@ -9,7 +9,8 @@ import { pathToFileURL } from 'node:url';
 
 import { mnemonicToAccount, privateKeyToAccount } from 'viem/accounts';
 
-import { recipeRuntimeDir, walletFixturePath } from '../../harness-exports.mjs';
+import { recipeRuntimeDir } from '@farmslot/recipe-cli/harness';
+import { walletFixturePath } from '../../harness-exports.mjs';
 
 export const SIGNER_MODES = Object.freeze(['extension', 'injected']);
 export const DEFAULT_ACCOUNT = 'dev1';

package/library/manifests/core.action-manifest.json

@@ -649,7 +649,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to read positions for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "network": {
             "type": "string",
@@ -759,7 +759,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to read orders for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "network": {
             "type": "string",
@@ -793,7 +793,7 @@
         "properties": {
           "account": {
             "type": "string",
-            "description": "EVM address to read account state for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "timeout_ms": {
             "type": "number"
@@ -818,6 +818,76 @@
       ],
       "execution_capabilities": []
     },
+    "metamask.perps.quote_fees": {
+      "description": "core Quote an order's fees through the perps controller's calculateFees (HyperLiquid, testnet by default, read-only): protocol and MetaMask fee rates and amounts (plus the winning fee source on a core that reports it), with an optional rewards discount supplied as RewardsController:getPerpsDiscountForAccount.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "description": "Market to quote, e.g. BTC."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "order_type": {
+            "type": "string",
+            "enum": [
+              "market",
+              "limit"
+            ],
+            "description": "Fee schedule to quote; defaults to market."
+          },
+          "is_maker": {
+            "type": "boolean",
+            "description": "Quote maker fees (limit orders that rest)."
+          },
+          "amount": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Order notional in USD; adds fee amounts and the blended rate for that size."
+          },
+          "rewards_discount_bips": {
+            "type": "integer",
+            "description": "Rewards discount the headless RewardsController answers with, an integer in basis points from 0 through 10000 (6500 = 65%). Omitted: no rewards source, the controller's 'not known yet'."
+          },
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
+          },
+          "account_name": {
+            "type": "string",
+            "description": "Alias for a wallet fixture account name."
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "description": "Venue to quote. Defaults to testnet."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.quote_fees",
+          "market": "BTC",
+          "amount": "100",
+          "rewards_discount_bips": 6500,
+          "intent": "Quote a $100 BTC market order with a 65% rewards discount",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": []
+    },
     "metamask.perps.read_snapshot": {
       "description": "Read global market and account snapshots through the public PerpsController API used by wallet clients.",
       "schema": {
@@ -835,7 +905,7 @@
           },
           "account": {
             "type": "string",
-            "description": "Wallet fixture account name or EVM address; defaults to dev1."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "account_name": {
             "type": "string",
@@ -1025,7 +1095,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to trade for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "timeout_ms": {
             "type": "number"
@@ -1344,7 +1414,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to close for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "timeout_ms": {
             "type": "number"
@@ -1471,7 +1541,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to read for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "network": {
             "type": "string",
@@ -1627,7 +1697,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to trade for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "timeout_ms": {
             "type": "number"
@@ -1681,7 +1751,7 @@
           },
           "account": {
             "type": "string",
-            "description": "Wallet fixture account name used for signing; defaults to dev1."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "market": {
             "type": "string",
@@ -1803,7 +1873,7 @@
         "properties": {
           "account": {
             "type": "string",
-            "description": "Wallet fixture account name, defaulting to dev1. Without a fixture, an EVM address permits read-only assertions."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "market": {
             "type": "string",
@@ -2010,7 +2080,7 @@
         "properties": {
           "account": {
             "type": "string",
-            "description": "Wallet fixture account name used for convergence and assertions; defaults to dev1."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "market": {
             "type": "string",
@@ -2887,7 +2957,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to act for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "timeout_ms": {
             "type": "number"
@@ -3010,7 +3080,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to act for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "timeout_ms": {
             "type": "number"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.78.0",
+  "version": "0.80.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -21,17 +21,18 @@
     "check:syntax": "find . -name '*.mjs' -print0 | xargs -0 -n1 node --check"
   },
   "dependencies": {
-    "@farmslot/adapter-web": "0.1.0",
-    "@farmslot/agent-runtime": "0.16.0",
-    "@farmslot/expo-recipe": "0.13.1",
+    "@farmslot/adapter-rn": "0.17.0",
+    "@farmslot/adapter-sdk": "0.3.1",
+    "@farmslot/adapter-web": "0.2.0",
+    "@farmslot/agent-runtime": "0.17.0",
     "@farmslot/handoff": "^0.3.1",
     "@farmslot/protocol": "0.34.0",
-    "@farmslot/recipe-cli": "0.1.2",
-    "@farmslot/recipe-harness": "0.22.1",
+    "@farmslot/recipe-cli": "0.4.1",
+    "@farmslot/recipe-runner": "0.24.0",
     "agent-device": "0.19.3",
     "commander": "^12.0.0",
-    "es-module-lexer": "2.3.1",
     "esbuild": "0.28.1",
+    "tsx": "^4.23.0",
     "viem": "^2.54.3",
     "ws": "8.21.0"
   },
@@ -47,7 +48,6 @@
     "eslint": "^9",
     "globals": "^17.7.0",
     "proper-lockfile": "^4.1.2",
-    "tsx": "^4.23.0",
     "typescript": "^5.6.0",
     "typescript-eslint": "^8",
     "vitest": "^4.1.10"