@deeeed/metamask-harness 0.17.5 → 0.18.0

package/library/actions/core/perps/read_account.mjs

@@ -1,4 +1,4 @@
-import { getCoreController, runAdapter } from './_controller.mjs';
+import { getCoreController, isDirectRun, runAdapter } from './_controller.mjs';
 
 function redactAccount(account) {
   return {
@@ -27,4 +27,4 @@ export async function readAccount(input) {
   };
 }
 
-runAdapter(readAccount);
+if (isDirectRun(import.meta.url)) runAdapter(readAccount);

package/library/actions/core/perps/read_orders.mjs

@@ -1,5 +1,6 @@
 import {
   getCoreController,
+  isDirectRun,
   redactOrder,
   runAdapter,
   selectedItems,
@@ -24,4 +25,4 @@ export async function readOrders(input) {
   };
 }
 
-runAdapter(readOrders);
+if (isDirectRun(import.meta.url)) runAdapter(readOrders);

package/library/actions/core/perps/read_positions.mjs

@@ -1,5 +1,6 @@
 import {
   getCoreController,
+  isDirectRun,
   redactPosition,
   runAdapter,
   selectedItems,
@@ -24,4 +25,4 @@ export async function readPositions(input) {
   };
 }
 
-runAdapter(readPositions);
+if (isDirectRun(import.meta.url)) runAdapter(readPositions);

package/library/actions/core/wallet/list_accounts.mjs

@@ -0,0 +1,95 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { pathToFileURL } from 'node:url';
+import { mnemonicToAccount, privateKeyToAccount } from 'viem/accounts';
+
+import { walletFixturePath } from '../../harness-exports.mjs';
+
+function fixtureAccountName(base, index, count) {
+  if (count === 1) return base || 'account1';
+  const match = /^(.*?)(\d+)$/u.exec(base || 'account1');
+  return match
+    ? `${match[1]}${Number(match[2]) + index}`
+    : `${base || 'account'}${index + 1}`;
+}
+
+function mnemonicCount(entry, fixturePath, index) {
+  const count = Number(entry.count ?? entry.numberOfAccounts ?? 1);
+  if (!Number.isInteger(count) || count < 1 || count > 100) {
+    throw new Error(`${fixturePath} accounts[${index}] mnemonic count must be an integer from 1 through 100.`);
+  }
+  return count;
+}
+
+function deriveFixtureAccounts(fixture, fixturePath) {
+  if (!Array.isArray(fixture.accounts) || fixture.accounts.length === 0) {
+    throw new Error(`wallet fixture at ${fixturePath} has no accounts array.`);
+  }
+  return fixture.accounts.flatMap((entry, fixtureIndex) => {
+    if (!entry || typeof entry !== 'object' || typeof entry.value !== 'string' || !entry.value.trim()) {
+      throw new Error(`${fixturePath} accounts[${fixtureIndex}] must contain a non-empty value.`);
+    }
+    if (entry.type === 'mnemonic') {
+      const count = mnemonicCount(entry, fixturePath, fixtureIndex);
+      return Array.from({ length: count }, (_, addressIndex) => {
+        const account = mnemonicToAccount(entry.value.trim(), { addressIndex });
+        return {
+          id: `fixture:${fixtureAccountName(entry.name, addressIndex, count)}`,
+          address: account.address,
+          name: fixtureAccountName(entry.name, addressIndex, count),
+          type: 'eip155:eoa',
+        };
+      });
+    }
+    if (entry.type === 'privateKey') {
+      const raw = entry.value.trim();
+      const normalized = raw.startsWith('0x') ? raw : `0x${raw}`;
+      if (!/^0x[0-9a-fA-F]{64}$/u.test(normalized)) {
+        throw new Error(`${fixturePath} accounts[${fixtureIndex}] privateKey is not a 32-byte hex key.`);
+      }
+      const account = privateKeyToAccount(normalized);
+      const name = entry.name || `account${fixtureIndex + 1}`;
+      return [{ id: `fixture:${name}`, address: account.address, name, type: 'eip155:eoa' }];
+    }
+    throw new Error(`${fixturePath} accounts[${fixtureIndex}].type must be mnemonic or privateKey.`);
+  });
+}
+
+async function listAccounts(input) {
+  const scope = input.node?.scope == null ? 'named' : String(input.node.scope);
+  if (scope !== 'selected' && scope !== 'named' && scope !== 'evm' && scope !== 'all') {
+    throw new Error('metamask.wallet.list_accounts scope must be selected, named, evm, or all.');
+  }
+  const fixturePath = walletFixturePath(input.context.projectRoot);
+  const fixture = JSON.parse(await readFile(fixturePath, 'utf8'));
+  const selectedName = String(input.node?.account_name ?? input.node?.account ?? 'dev1');
+  const accounts = deriveFixtureAccounts(fixture, fixturePath)
+    .map((account) => ({
+      ...account,
+      selected: account.name === selectedName,
+    }))
+    .filter((account) => {
+      if (scope === 'selected') return account.selected;
+      if (scope === 'all') return true;
+      if (scope === 'evm') return /^0x[0-9a-f]{40}$/iu.test(account.address);
+      return account.selected || Boolean(account.name.trim());
+    });
+  return {
+    action: input.action,
+    source: 'core-headless-wallet-fixture',
+    scope,
+    accounts,
+    count: accounts.length,
+    redacted: true,
+    selectionSource: 'explicit-controller-account-input',
+    proofPath: 'core-wallet-fixture-accounts',
+  };
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  const inputPath = process.argv[2] || process.env.METAMASK_RECIPE_ADAPTER_INPUT;
+  if (!inputPath) throw new Error('Adapter input path is required.');
+  const input = JSON.parse(await readFile(inputPath, 'utf8'));
+  const result = await listAccounts(input);
+  if (input.outputPath) await writeFile(input.outputPath, `${JSON.stringify(result, null, 2)}\n`);
+  else process.stdout.write(`${JSON.stringify(result)}\n`);
+}

package/library/actions/extension/platform/cdp.mjs

@@ -397,6 +397,7 @@ async function launchExistingDistRuntime(input, port) {
   try {
     child = spawn(chrome, [
       `--user-data-dir=${profileDir}`,
+      ...(process.platform === 'darwin' ? ['--use-mock-keychain'] : []),
       '--remote-debugging-address=127.0.0.1',
       `--remote-debugging-port=${port}`,
       '--no-first-run',

package/library/actions/extension/wallet/list_accounts.mjs

@@ -0,0 +1,41 @@
+import { runAdapter, withExtensionPage } from '../platform/cdp.mjs';
+
+runAdapter((input) => withExtensionPage(input, async (page) => {
+  const scope = input.node?.scope == null ? 'named' : String(input.node.scope);
+  if (scope !== 'selected' && scope !== 'named' && scope !== 'evm' && scope !== 'all') {
+    throw new Error('metamask.wallet.list_accounts scope must be selected, named, evm, or all.');
+  }
+  const result = await page.evaluate(`(() => {
+    const store = globalThis.stateHooks?.store;
+    if (!store || typeof store.getState !== 'function') {
+      throw new Error('stateHooks.store.getState is unavailable.');
+    }
+    const internal = store.getState()?.metamask?.internalAccounts || {};
+    const selectedId = internal.selectedAccount || null;
+    const scope = ${JSON.stringify(scope)};
+    const accounts = Object.entries(internal.accounts || {})
+      .map(([id, account]) => ({
+        id,
+        address: account?.address || null,
+        name: account?.metadata?.name || null,
+        type: account?.type || null,
+        selected: id === selectedId
+      }))
+      .filter((account) => {
+        if (scope === 'selected') return account.selected;
+        if (scope === 'all') return true;
+        if (scope === 'evm') return /^0x[0-9a-f]{40}$/iu.test(account.address || '');
+        return account.selected || Boolean(String(account.name || '').trim());
+      });
+    return { accounts };
+  })()`);
+  return {
+    action: input.action,
+    source: 'extension-stateHooks-store',
+    scope,
+    ...result,
+    count: result.accounts.length,
+    redacted: true,
+    proofPath: 'extension-wallet-accounts',
+  };
+}));

package/library/actions/mobile/wallet/list_accounts.mjs

@@ -0,0 +1,37 @@
+import { bridgeCommand, runAdapter } from '../platform/bridge.mjs';
+
+runAdapter(async (input) => {
+  const scope = input.node?.scope == null ? 'named' : String(input.node.scope);
+  if (scope !== 'selected' && scope !== 'named' && scope !== 'evm' && scope !== 'all') {
+    throw new Error('metamask.wallet.list_accounts scope must be selected, named, evm, or all.');
+  }
+  const rawAccounts = await bridgeCommand(input, ['list-accounts']);
+  if (!Array.isArray(rawAccounts)) {
+    throw new Error(`metamask.wallet.list_accounts expected an array, got ${typeof rawAccounts}.`);
+  }
+  const selected = await bridgeCommand(input, ['get-selected-account']);
+  const selectedAddress = String(selected?.address ?? selected ?? '').toLowerCase();
+  const accounts = rawAccounts
+    .map((account) => ({
+      id: account?.id ?? null,
+      address: account?.address ?? null,
+      name: account?.name ?? null,
+      type: account?.type ?? null,
+      selected: Boolean(selectedAddress && String(account?.address ?? '').toLowerCase() === selectedAddress),
+    }))
+    .filter((account) => {
+      if (scope === 'selected') return account.selected;
+      if (scope === 'all') return true;
+      if (scope === 'evm') return /^0x[0-9a-f]{40}$/iu.test(String(account.address ?? ''));
+      return account.selected || Boolean(String(account.name ?? '').trim());
+    });
+  return {
+    action: input.action,
+    source: 'mobile-accounts-controller',
+    scope,
+    accounts,
+    count: accounts.length,
+    redacted: true,
+    proofPath: 'agentic-wallet-accounts',
+  };
+});

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

@@ -162,6 +162,18 @@
         }
       ]
     },
+    "metamask.wallet.list_accounts": {
+      "description": "List redacted headless fixture accounts available to Core controller actions.",
+      "examples": [
+        {
+          "description": "List configured Core accounts",
+          "node": {
+            "action": "metamask.wallet.list_accounts",
+            "intent": "Discover the accounts available to headless controller actions"
+          }
+        }
+      ]
+    },
     "metamask.perps.read_positions": {
       "description": "Read live Perps positions directly from the perps controller (HyperLiquid testnet, HTTP read-only) and return the selected subset.",
       "examples": [
@@ -392,6 +404,51 @@
     }
   },
   "custom_actions": [
+    {
+      "name": "metamask.wallet.list_accounts",
+      "owner": "metamask",
+      "description": "List redacted headless fixture accounts available to Core controller actions.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.wallet.list_accounts"
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "selected",
+              "named",
+              "evm",
+              "all"
+            ],
+            "description": "Account scope. Core fixtures are EVM-only today; selected filters to the explicit controller account input."
+          },
+          "account": {
+            "type": "string",
+            "description": "Optional account name to mark as selected for the next controller operation; defaults to dev1."
+          },
+          "account_name": {
+            "type": "string",
+            "description": "Alias for account."
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "List configured Core accounts",
+          "node": {
+            "action": "metamask.wallet.list_accounts",
+            "intent": "Discover the accounts available to headless controller actions"
+          }
+        }
+      ],
+      "proof_effect": "Records the redacted addresses derived from the same wallet fixture used by headless controller actions.",
+      "safety_notes": "Read-only fixture metadata; must never return private keys, mnemonics, passwords, or vault data."
+    },
     {
       "name": "metamask.perps.read_positions",
       "owner": "metamask",
@@ -446,7 +503,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to read positions for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "EVM address to read positions for; defaults to the canonical wallet fixture account."
           },
           "timeout_ms": {
             "type": "number"
@@ -523,7 +580,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to read orders for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "EVM address to read orders for; defaults to the canonical wallet fixture account."
           },
           "timeout_ms": {
             "type": "number"
@@ -558,7 +615,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to read account state for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "EVM address to read account state for; defaults to the canonical wallet fixture account."
           },
           "timeout_ms": {
             "type": "number"
@@ -653,7 +710,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to trade for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "EVM address to trade for; defaults to the canonical wallet fixture account."
           },
           "timeout_ms": {
             "type": "number"
@@ -748,7 +805,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to close for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "EVM address to close for; defaults to the canonical wallet fixture account."
           },
           "timeout_ms": {
             "type": "number"
@@ -837,7 +894,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to read for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "EVM address to read for; defaults to the canonical wallet fixture account."
           },
           "timeout_ms": {
             "type": "number"
@@ -937,7 +994,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to trade for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "EVM address to trade for; defaults to the canonical wallet fixture account."
           },
           "timeout_ms": {
             "type": "number"
@@ -1486,6 +1543,10 @@
       "action": "app.status",
       "implementation": "@metamask/recipe-runner/platform-status"
     },
+    {
+      "action": "metamask.wallet.list_accounts",
+      "implementation": "@metamask/recipe-runner/core/wallet"
+    },
     {
       "action": "metamask.perps.read_positions",
       "implementation": "@metamask/recipe-runner/core/perps"

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

@@ -516,6 +516,18 @@
         }
       ]
     },
+    "metamask.wallet.list_accounts": {
+      "description": "List redacted wallet accounts and identify the selected account without mutating the app.",
+      "examples": [
+        {
+          "description": "List wallet accounts",
+          "node": {
+            "action": "metamask.wallet.list_accounts",
+            "intent": "Discover the available wallet accounts"
+          }
+        }
+      ]
+    },
     "metamask.wallet.read_state": {
       "description": "Read the redacted wallet state (selected account, route, and device) from the running app.",
       "examples": [
@@ -911,6 +923,43 @@
       ],
       "owner": "metamask"
     },
+    {
+      "name": "metamask.wallet.list_accounts",
+      "owner": "metamask",
+      "description": "List redacted wallet accounts and identify the selected account without mutating the app.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.wallet.list_accounts"
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "selected",
+              "named",
+              "evm",
+              "all"
+            ],
+            "description": "Account scope. Defaults to named human-visible accounts; use selected for the active account, evm for EVM accounts, or all for the full inventory."
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "List wallet accounts",
+          "node": {
+            "action": "metamask.wallet.list_accounts",
+            "intent": "Discover the available wallet accounts"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Read-only account metadata; must never expose keys, mnemonics, vault data, or credentials."
+    },
     {
       "name": "metamask.wallet.read_state",
       "owner": "metamask",
@@ -2045,6 +2094,10 @@
       "action": "metamask.wallet.select_account",
       "implementation": "@metamask/recipe-runner/extension/wallet"
     },
+    {
+      "action": "metamask.wallet.list_accounts",
+      "implementation": "@metamask/recipe-runner/extension/wallet"
+    },
     {
       "action": "metamask.wallet.read_state",
       "implementation": "@metamask/recipe-runner/extension/wallet"

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

@@ -156,13 +156,38 @@
       ]
     },
     "ui.press": {
-      "description": "Press/tap/click a UI target through the platform adapter.",
+      "description": "Press a React Native component by exact testID/test_id, selector identifier, or contained visible text.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": { "const": "ui.press" },
+          "test_id": { "type": "string", "minLength": 1 },
+          "testID": { "type": "string", "minLength": 1 },
+          "selector": { "type": "string", "minLength": 1 },
+          "text": { "type": "string", "minLength": 1 }
+        },
+        "oneOf": [
+          { "required": ["test_id"] },
+          { "required": ["testID"] },
+          { "required": ["selector"] },
+          { "required": ["text"] }
+        ]
+      },
       "examples": [
         {
+          "description": "Press by stable React Native testID",
           "node": {
             "action": "ui.press",
-            "target": "Perps",
-            "intent": "Press/tap/click a UI target through the platform adapter"
+            "test_id": "perps-tab",
+            "intent": "Open Perps through its stable testID"
+          }
+        },
+        {
+          "description": "Press a component that is reachable only by visible text",
+          "node": {
+            "action": "ui.press",
+            "text": "Ethereum",
+            "intent": "Press the component containing the visible Ethereum label"
           }
         }
       ]
@@ -525,6 +550,18 @@
         }
       ]
     },
+    "metamask.wallet.list_accounts": {
+      "description": "List redacted wallet accounts and identify the selected account without mutating the app.",
+      "examples": [
+        {
+          "description": "List wallet accounts",
+          "node": {
+            "action": "metamask.wallet.list_accounts",
+            "intent": "Discover the available wallet accounts"
+          }
+        }
+      ]
+    },
     "metamask.wallet.read_state": {
       "description": "Read the redacted wallet state (selected account, route, and device) from the running app.",
       "examples": [
@@ -922,6 +959,43 @@
       "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
       "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
     },
+    {
+      "name": "metamask.wallet.list_accounts",
+      "owner": "metamask",
+      "description": "List redacted wallet accounts and identify the selected account without mutating the app.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.wallet.list_accounts"
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "selected",
+              "named",
+              "evm",
+              "all"
+            ],
+            "description": "Account scope. Defaults to named human-visible accounts; use selected for the active account, evm for EVM accounts, or all for the full inventory."
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "List wallet accounts",
+          "node": {
+            "action": "metamask.wallet.list_accounts",
+            "intent": "Discover the available wallet accounts"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Read-only account metadata; must never expose keys, mnemonics, vault data, or credentials."
+    },
     {
       "name": "metamask.wallet.read_state",
       "owner": "metamask",
@@ -2067,6 +2141,10 @@
       "action": "metamask.wallet.select_account",
       "implementation": "@metamask/recipe-runner/mobile/wallet"
     },
+    {
+      "action": "metamask.wallet.list_accounts",
+      "implementation": "@metamask/recipe-runner/mobile/wallet"
+    },
     {
       "action": "metamask.wallet.read_state",
       "implementation": "@metamask/recipe-runner/mobile/wallet"

package/library/recipes/runner/action-validation.extension.recipe.json

@@ -125,11 +125,18 @@
         },
         "wallet-read-state": {
           "action": "metamask.wallet.read_state",
-          "next": "extension-account-list",
+          "next": "wallet-list-accounts",
           "intent": "Read wallet state for proof",
           "detail": "Capture selected account and network state without mutating UI.",
           "flow": "wallet"
         },
+        "wallet-list-accounts": {
+          "action": "metamask.wallet.list_accounts",
+          "next": "extension-account-list",
+          "intent": "List wallet accounts for proof",
+          "detail": "Capture redacted account metadata and the selected account without mutating the app.",
+          "flow": "wallet"
+        },
         "app-navigate-wallet": {
           "action": "ui.navigate",
           "next": "app-navigate-perps",

package/library/recipes/runner/action-validation.mobile.recipe.json

@@ -125,11 +125,18 @@
         },
         "wallet-read-state": {
           "action": "metamask.wallet.read_state",
-          "next": "select-account",
+          "next": "wallet-list-accounts",
           "intent": "Read wallet state for proof",
           "detail": "Capture selected account and network state without mutating UI.",
           "flow": "wallet"
         },
+        "wallet-list-accounts": {
+          "action": "metamask.wallet.list_accounts",
+          "next": "select-account",
+          "intent": "List wallet accounts for proof",
+          "detail": "Capture redacted account metadata and the selected account without mutating the app.",
+          "flow": "wallet"
+        },
         "select-account": {
           "action": "metamask.wallet.select_account",
           "address": "0x8dc623e964475d4d669da601fd15ea9125469003",

package/library/recipes/runner/smoke.core.recipe.json

@@ -0,0 +1,27 @@
+{
+  "schema_version": 1,
+  "title": "MetaMask Core runner smoke",
+  "description": "Proves the headless Core runner resolves the checkout, executes generic actions, and writes a valid artifact package.",
+  "validate": {
+    "workflow": {
+      "entry": "status",
+      "nodes": {
+        "status": {
+          "action": "app.status",
+          "next": "package",
+          "intent": "Resolve the Core checkout and report headless readiness"
+        },
+        "package": {
+          "action": "assert_file",
+          "path": "package.json",
+          "next": "done",
+          "intent": "Prove generic project-file assertions work in Core"
+        },
+        "done": {
+          "action": "end",
+          "status": "pass"
+        }
+      }
+    }
+  }
+}

package/library/recipes/wallet/smoke.extension.recipe.json

@@ -0,0 +1,42 @@
+{
+  "schema_version": 1,
+  "title": "MetaMask Extension wallet smoke",
+  "description": "Fixture-backed proof that the Extension wallet is reachable, unlocked, readable, and visually capturable without depending on a product feature domain.",
+  "validate": {
+    "workflow": {
+      "entry": "status",
+      "nodes": {
+        "status": {
+          "action": "app.status",
+          "next": "fixture",
+          "intent": "Confirm the Extension runtime is reachable"
+        },
+        "fixture": {
+          "action": "metamask.wallet.fixture_status",
+          "next": "unlock",
+          "intent": "Confirm the checkout wallet fixture is ready"
+        },
+        "unlock": {
+          "action": "metamask.wallet.ensure_unlocked",
+          "next": "state",
+          "intent": "Ensure the fixture-backed wallet is unlocked"
+        },
+        "state": {
+          "action": "metamask.wallet.read_state",
+          "next": "screenshot",
+          "intent": "Read the current wallet state through the public adapter"
+        },
+        "screenshot": {
+          "action": "ui.screenshot",
+          "path": "screenshots/wallet-smoke.png",
+          "next": "done",
+          "intent": "Capture visual wallet evidence"
+        },
+        "done": {
+          "action": "end",
+          "status": "pass"
+        }
+      }
+    }
+  }
+}