@deeeed/metamask-harness 0.81.0 → 0.82.1

package/library/actions/{terminal → web-dapp}/platform/runtime.mjs

@@ -1,6 +1,6 @@
-// Resolve the Web Terminal slot runtime: ports, runtime paths, browser state and
-// wallet-fixture accounts. Key material is only ever returned as a viem account
-// object; callers must never log or persist it.
+// Resolve the web-dapp slot runtime: the venue policy, ports, runtime paths,
+// browser state and wallet-fixture accounts. Key material is only ever
+// returned as a viem account object; callers must never log or persist it.
 
 import { realpathSync } from 'node:fs';
 import { readFile, writeFile } from 'node:fs/promises';
@@ -11,6 +11,9 @@ import { mnemonicToAccount, privateKeyToAccount } from 'viem/accounts';
 
 import { recipeRuntimeDir } from '@farmslot/recipe-cli/harness';
 import { walletFixturePath } from '../../harness-exports.mjs';
+import { POLICY_ENV, webDappAdapterId, webDappPolicy } from '../../../../adapters/web-dapp/lib/policy.mjs';
+
+export { POLICY_ENV, webDappAdapterId, webDappPolicy };
 
 export const SIGNER_MODES = Object.freeze(['extension', 'injected']);
 export const DEFAULT_ACCOUNT = 'dev1';
@@ -26,12 +29,13 @@ export function canonicalPath(target) {
   }
 }
 
-export function terminalRuntimeDir(projectRoot) {
-  return path.join(canonicalPath(projectRoot), recipeRuntimeDir(), 'terminal');
+// <checkout>/<runtime>/<adapter id>, e.g. temp/recipe/runtime/terminal.
+export function webDappRuntimeDir(projectRoot) {
+  return path.join(canonicalPath(projectRoot), recipeRuntimeDir(), webDappPolicy().adapterId);
 }
 
-export function terminalRuntimePath(projectRoot, ...segments) {
-  return path.join(terminalRuntimeDir(projectRoot), ...segments);
+export function webDappRuntimePath(projectRoot, ...segments) {
+  return path.join(webDappRuntimeDir(projectRoot), ...segments);
 }
 
 function portFrom(raw, label) {
@@ -53,7 +57,7 @@ export function appPort(input = {}, env = process.env) {
     portFrom(env.WATCHER_PORT, 'WATCHER_PORT');
   if (!port) {
     throw new Error(
-      'terminal adapter requires the slot dev-server port.\n' +
+      `${webDappPolicy().adapterId} adapter requires the slot dev-server port.\n` +
       'Next: pass --watcher-port <port> (Farmslot: {{port}}) or set TERMINAL_APP_PORT.',
     );
   }
@@ -71,7 +75,7 @@ export function cdpPort(input = {}, env = process.env) {
     portFrom(env.CDP_PORT, 'CDP_PORT');
   if (!port) {
     throw new Error(
-      'terminal adapter requires a per-slot browser CDP port.\n' +
+      `${webDappPolicy().adapterId} adapter requires a per-slot browser CDP port.\n` +
       'Next: pass --cdp-port <port> (Farmslot: {{cdp_port}}).',
     );
   }
@@ -92,7 +96,7 @@ export async function writePrivateJson(file, value) {
 }
 
 export async function readBrowserState(projectRoot) {
-  return readJsonFile(terminalRuntimePath(projectRoot, 'browser.json'));
+  return readJsonFile(webDappRuntimePath(projectRoot, 'browser.json'));
 }
 
 export function resolveSigner(raw) {
@@ -123,7 +127,7 @@ export async function loadWalletFixture(projectRoot, env = process.env) {
   if (!fixture) {
     throw new Error(
       `wallet fixture not found at ${file}.\n` +
-      'Next: mm-harness install --adapter terminal --target <checkout> with RECIPE_WALLET_FIXTURE set, or copy the fixture there (0600).',
+      `Next: mm-harness install --adapter ${webDappPolicy().adapterId} --target <checkout> with RECIPE_WALLET_FIXTURE set, or copy the fixture there (0600).`,
     );
   }
   if (!Array.isArray(fixture.accounts) || fixture.accounts.length === 0) {
@@ -195,7 +199,7 @@ export async function runAdapter(callback) {
     const output = await callback(input);
     await writeFile(input.outputPath, `${JSON.stringify(output, null, 2)}\n`);
   } catch (error) {
-    process.stderr.write(`[terminal] ${input.action} failed: ${error?.stack ?? error}\n`);
+    process.stderr.write(`[${webDappAdapterId()}] ${input.action} failed: ${error?.stack ?? error}\n`);
     process.exitCode = 1;
   }
 }

package/library/actions/web-dapp/ui/navigate.mjs

@@ -0,0 +1,24 @@
+// Navigate the app tab to an explicit app path, or a product page the venue
+// policy names (the Terminal's order/<MARKET>, portfolio, home), and wait for
+// the document to be ready.
+
+import { appOrigin, isDirectRun, runAdapter, webDappPolicy } from '../platform/runtime.mjs';
+import { withAppPage } from '../platform/page.mjs';
+
+export function pathFor(node = {}, policy = webDappPolicy()) {
+  if (typeof node.path === 'string' && node.path.startsWith('/')) return node.path;
+  return policy.pagePath(node);
+}
+
+export async function navigate(input) {
+  const node = input.node ?? {};
+  const url = `${appOrigin(input)}${pathFor(node)}`;
+  return withAppPage({ ...input, node: { ...node, surface: 'app' } }, async (page) => {
+    await page.navigate(url, Number(node.timeout_ms ?? 120000));
+    await page.waitForDocumentReady({ expectedUrl: url, timeoutMs: Number(node.timeout_ms ?? 120000) });
+    if (node.settle_ms) await new Promise((resolve) => setTimeout(resolve, Number(node.settle_ms)));
+    return { action: input.action, url, page: node.page ?? 'order', market: node.market ?? null };
+  });
+}
+
+if (isDirectRun(import.meta.url)) runAdapter((input) => navigate(input));

package/library/actions/web-dapp/wallet/_signature-log.mjs

@@ -0,0 +1,32 @@
+// The wallet request log: where the wallet host writes it, and what the venue
+// forbids in it. Reading, windowing and asserting the log are
+// @farmslot/adapter-web/dapp's; the venue's rules come from its policy
+// (`signatureLog`, the Terminal's L1 and mainnet rules).
+
+import { webDappPolicy, webDappRuntimePath } from '../platform/runtime.mjs';
+
+export function signatureLog(projectRoot) {
+  return {
+    logFile: webDappRuntimePath(projectRoot, 'wallet-requests.jsonl'),
+    cursorFile: webDappRuntimePath(projectRoot, 'wallet-requests.cursor.json'),
+  };
+}
+
+// What the venue forbids in the log (a SignaturePolicy), e.g. the Terminal's L1 and mainnet rules.
+export function signaturePolicy() {
+  return webDappPolicy().signatureLog ?? {};
+}
+
+// The id the actions report their evidence under, e.g. terminal-wallet-request-log.
+export function evidenceId(suffix) {
+  return `${webDappPolicy().adapterId}-${suffix}`;
+}
+
+// Evidence goes to <artifacts>/<adapter id>-wallet/<node>-signature-log.json.
+export function logArtifactTarget(input) {
+  return {
+    artifactsDir: input.context?.artifactsDir,
+    nodeId: input.context?.nodeId ?? input.action,
+    folder: evidenceId('wallet'),
+  };
+}

package/library/actions/{terminal → web-dapp}/wallet/assert_signatures.mjs

@@ -6,12 +6,12 @@
 import { awaitSignatureLog, writeLogArtifact } from '@farmslot/adapter-web/dapp';
 
 import { isDirectRun, runAdapter } from '../platform/runtime.mjs';
-import { TERMINAL_SIGNATURE_POLICY, logArtifactTarget, signatureLog } from './_signature-log.mjs';
+import { evidenceId, logArtifactTarget, signatureLog, signaturePolicy } from './_signature-log.mjs';
 
 export async function assertSignatures(input) {
   const node = input.node ?? {};
   // Entries arrive asynchronously from the wallet host; timeout_ms allows a short settle.
-  const { window, result } = await awaitSignatureLog(signatureLog(input.context?.projectRoot), node, TERMINAL_SIGNATURE_POLICY);
+  const { window, result } = await awaitSignatureLog(signatureLog(input.context?.projectRoot), node, signaturePolicy());
   const artifacts = await writeLogArtifact(logArtifactTarget(input), {
     cursor: window.cursor,
     total: window.total,
@@ -24,13 +24,13 @@ export async function assertSignatures(input) {
   }
   return {
     action: input.action,
-    source: 'terminal-wallet-request-log',
+    source: evidenceId('wallet-request-log'),
     cursor: window.cursor,
     count: window.entries.length,
     summary: result.summary,
     entries: window.entries,
     artifacts,
-    proofPath: 'terminal-wallet-request-log',
+    proofPath: evidenceId('wallet-request-log'),
   };
 }
 

package/library/actions/{terminal → web-dapp}/wallet/list_accounts.mjs

@@ -1,7 +1,7 @@
 // List the wallet-fixture account names and addresses available to the slot
 // browser, marking the one the running browser uses. Addresses only.
 
-import { isDirectRun, loadWalletFixture, readBrowserState, runAdapter, viemAccountFromEntry } from '../platform/runtime.mjs';
+import { isDirectRun, loadWalletFixture, readBrowserState, runAdapter, viemAccountFromEntry, webDappPolicy } from '../platform/runtime.mjs';
 
 export async function listAccounts(input) {
   const projectRoot = input.context?.projectRoot;
@@ -20,7 +20,7 @@ export async function listAccounts(input) {
     accounts,
     count: accounts.length,
     redacted: true,
-    proofPath: 'terminal-wallet-accounts',
+    proofPath: `${webDappPolicy().adapterId}-wallet-accounts`,
   };
 }
 

package/library/actions/{terminal → web-dapp}/wallet/read_signatures.mjs

@@ -5,7 +5,7 @@
 import { resetWindow, summarize, windowSinceCursor, writeLogArtifact } from '@farmslot/adapter-web/dapp';
 
 import { isDirectRun, runAdapter } from '../platform/runtime.mjs';
-import { TERMINAL_SIGNATURE_POLICY, logArtifactTarget, signatureLog } from './_signature-log.mjs';
+import { evidenceId, logArtifactTarget, signatureLog, signaturePolicy } from './_signature-log.mjs';
 
 export async function readSignatures(input) {
   const log = signatureLog(input.context?.projectRoot);
@@ -13,25 +13,25 @@ export async function readSignatures(input) {
     const { cursor, previousEntries } = await resetWindow(log);
     return {
       action: input.action,
-      source: 'terminal-wallet-request-log',
+      source: evidenceId('wallet-request-log'),
       reset: true,
       cursor,
       previousEntries,
-      proofPath: 'terminal-wallet-request-log',
+      proofPath: evidenceId('wallet-request-log'),
     };
   }
   const { cursor, entries, total } = await windowSinceCursor(log);
-  const summary = summarize(entries, TERMINAL_SIGNATURE_POLICY);
+  const summary = summarize(entries, signaturePolicy());
   const artifacts = await writeLogArtifact(logArtifactTarget(input), { cursor, total, summary, entries });
   return {
     action: input.action,
-    source: 'terminal-wallet-request-log',
+    source: evidenceId('wallet-request-log'),
     cursor,
     count: entries.length,
     summary,
     entries,
     artifacts,
-    proofPath: 'terminal-wallet-request-log',
+    proofPath: evidenceId('wallet-request-log'),
   };
 }