@deeeed/metamask-harness 0.81.0 → 0.82.0

package/dist/manifest.js

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { OFFICIAL_RECIPE_ACTIONS } from "@farmslot/protocol";
 import { getAdapterSurface } from "./adapters/surface.js";
-import { manifestPath, readJson, importRecipeProtocol } from "./paths.js";
+import { manifestPath, readJson, importRecipeProtocol, runnerDir } from "./paths.js";
 function loadMetaMaskMobileActionManifest() {
   return asActionManifest(readJson(manifestPath("mobile")));
 }
@@ -12,14 +12,26 @@ function loadMetaMaskExtensionActionManifest() {
 function loadMetaMaskCoreActionManifest() {
   return asActionManifest(readJson(manifestPath("core")));
 }
-function loadMetaMaskTerminalActionManifest() {
-  return asActionManifest(readJson(manifestPath("terminal")));
-}
 function loadActionManifest(adapter, overridePath) {
   if (overridePath) return asActionManifest(readJson(path.resolve(overridePath)));
   return asActionManifest(readJson(getAdapterSurface(adapter).actions.manifestPath()));
 }
+class ActionManifestError extends Error {
+  code = "ACTION_MANIFEST_INVALID";
+  userAction;
+  constructor(adapter, cause) {
+    super(cause instanceof Error ? cause.message : String(cause));
+    this.userAction = `fix the ${adapter} action manifest the message names, then rerun`;
+  }
+}
 async function resolveActionManifest(adapter, overridePath, librarySources, taskActionRoot) {
+  try {
+    return await resolveActionManifestSources(adapter, overridePath, librarySources, taskActionRoot);
+  } catch (error) {
+    throw error instanceof ActionManifestError ? error : new ActionManifestError(adapter, error);
+  }
+}
+async function resolveActionManifestSources(adapter, overridePath, librarySources, taskActionRoot) {
   if (overridePath) {
     const manifestPath2 = path.resolve(overridePath);
     const implementationRoot = path.resolve(
@@ -38,9 +50,12 @@ async function resolveActionManifest(adapter, overridePath, librarySources, task
       })
     };
   }
-  const canonicalPath = path.resolve(getAdapterSurface(adapter).actions.manifestPath());
+  const surfaceActions = getAdapterSurface(adapter).actions;
+  const canonicalPath = path.resolve(surfaceActions.manifestPath());
   const canonicalRoot = path.dirname(path.dirname(canonicalPath));
-  const sources = librarySources?.length ? librarySources : [{ name: "metamask", root: canonicalRoot }];
+  const bundledRoot = path.resolve(runnerDir, "library");
+  const canonicalName = canonicalRoot === bundledRoot ? "metamask" : path.basename(canonicalRoot);
+  const sources = librarySources?.length ? librarySources : [{ name: canonicalName, root: canonicalRoot }];
   const manifests = [];
   for (const source of sources) {
     const file = path.resolve(source.root, "manifests", `${adapter}.action-manifest.json`);
@@ -49,31 +64,39 @@ async function resolveActionManifest(adapter, overridePath, librarySources, task
     await validateManifest(manifest);
     manifests.push({ source, file, manifest });
   }
+  for (const declared of surfaceActions.manifestPaths?.() ?? []) {
+    const file = path.resolve(declared);
+    if (file === canonicalPath || manifests.some((entry) => entry.file === file)) continue;
+    const manifest = asActionManifest(readJson(file));
+    await validateManifest(manifest);
+    const root = path.dirname(path.dirname(file));
+    const source = sources.find((candidate) => path.resolve(candidate.root) === root) ?? { name: path.basename(root), root };
+    manifests.push({ source, file, manifest });
+  }
   if (!manifests.some((entry) => entry.file === canonicalPath)) {
     const manifest = loadActionManifest(adapter);
     await validateManifest(manifest);
     manifests.push({
-      source: { name: "metamask", root: canonicalRoot },
+      source: { name: canonicalName, root: canonicalRoot },
       file: canonicalPath,
       manifest
     });
   }
   const canonical = manifests.find((entry) => entry.file === canonicalPath);
   if (!canonical) throw new Error(`No ${adapter} action manifest could be resolved.`);
+  const isBundled = (entry) => path.resolve(entry.source.root) === bundledRoot;
+  const bundledParents = manifests.filter((entry) => entry !== canonical && isBundled(entry));
   const official = new Set(OFFICIAL_RECIPE_ACTIONS);
-  const canonicalActions = actionsOf(canonical.manifest);
   const mergedActions = {};
-  for (const [name, entry] of Object.entries(canonicalActions)) {
-    if (official.has(name)) mergedActions[name] = entry;
-  }
   const actionSources = /* @__PURE__ */ new Map();
-  for (const name of Object.keys(mergedActions)) {
-    actionSources.set(name, {
-      name: "official",
-      tier: "official",
-      manifestPath: canonical.file
-    });
+  for (const entry of [canonical, ...bundledParents]) {
+    for (const [name, action] of Object.entries(actionsOf(entry.manifest))) {
+      if (!official.has(name) || name in mergedActions) continue;
+      mergedActions[name] = action;
+      actionSources.set(name, { name: "official", tier: "official", manifestPath: entry.file });
+    }
   }
+  const observers = bundledParents.length ? [canonical, ...bundledParents].flatMap((entry) => entry.manifest.observers ?? []).filter((observer, index, all) => all.findIndex((other) => other.ref === observer.ref) === index) : canonical.manifest.observers;
   const custom = /* @__PURE__ */ new Set();
   const ordered = [
     ...manifests.filter((entry) => entry.file !== canonicalPath),
@@ -81,24 +104,25 @@ async function resolveActionManifest(adapter, overridePath, librarySources, task
   ];
   for (const entry of ordered) {
     const isCanonical = entry.file === canonicalPath;
-    if (!isCanonical && entry.manifest.observers?.length) {
+    const bundled = isBundled(entry);
+    if (!isCanonical && !bundled && entry.manifest.observers?.length) {
       throw new Error(
         `Library manifest ${entry.file} declares observers, but external library observers are not executable; remove observers or use an explicit task action manifest.`
       );
     }
-    const sourceName = isCanonical ? "metamask" : entry.source.name ?? path.basename(entry.source.root);
-    const tier = isCanonical ? "canonical" : sourceName === "personal" ? "personal" : "team";
+    const sourceName = bundled ? "metamask" : entry.source.name ?? path.basename(entry.source.root);
+    const tier = bundled ? "canonical" : sourceName === "personal" ? "personal" : "team";
     const implementationRoot = path.join(entry.source.root, "actions");
     const sourceInfo = {
       name: sourceName,
       tier,
       manifestPath: entry.file,
       implementationRoot,
-      trust: entry.source.provenance?.trust ?? (isCanonical ? "trusted" : "unknown")
+      trust: entry.source.provenance?.trust ?? (bundled ? "trusted" : "unknown")
     };
     for (const [name, action] of Object.entries(actionsOf(entry.manifest))) {
       if (official.has(name)) {
-        if (!isCanonical) {
+        if (!isCanonical && !bundled) {
           throw new Error(
             `Library action ${name} from ${entry.file} conflicts with an official action; team libraries may declare namespaced custom actions only.`
           );
@@ -121,7 +145,7 @@ async function resolveActionManifest(adapter, overridePath, librarySources, task
     manifest: {
       $schema: canonical.manifest.$schema,
       actions: mergedActions,
-      ...canonical.manifest.observers ? { observers: canonical.manifest.observers } : {}
+      ...observers ? { observers } : {}
     },
     actionSources
   };
@@ -163,11 +187,11 @@ function asActionManifest(value) {
   return value;
 }
 export {
+  ActionManifestError,
   loadActionManifest,
   loadMetaMaskCoreActionManifest,
   loadMetaMaskExtensionActionManifest,
   loadMetaMaskMobileActionManifest,
-  loadMetaMaskTerminalActionManifest,
   resolveActionManifest,
   validateManifest
 };

package/dist/mm-harness-cli.js

@@ -11,7 +11,9 @@ import { metaMaskEngine } from "./engine.js";
 import { handleHelp } from "./commands/help.js";
 import { handleTutorial } from "./commands/tutorial.js";
 import { handleSetupBase } from "./commands/setup-base.js";
+import { loadSelectedAdapter } from "./adapters/plugin-surface.js";
 import { getAdapterSurface } from "./adapters/surface.js";
+import { ActionManifestError } from "./manifest.js";
 import { configPath, hydrateLibraryPathEnv, readConfig } from "./review/knowledge.js";
 import {
   PUBLIC_COMMAND_CONTRACTS,
@@ -1088,6 +1090,17 @@ async function delegate(argv) {
   try {
     return await recipeMain(argv);
   } catch (error) {
+    const own = argv.includes("--") ? argv.slice(0, argv.indexOf("--")) : argv;
+    if (error instanceof ActionManifestError && own.includes("--json")) {
+      console.log(JSON.stringify({
+        schemaVersion: 1,
+        command: argv[0],
+        status: "fail",
+        exitCode: 1,
+        error: { code: error.code, message: error.message, userAction: error.userAction }
+      }, null, 2));
+      return 1;
+    }
     console.error(error instanceof Error ? error.message : String(error));
     return error !== null && typeof error === "object" && "exitCode" in error && typeof error.exitCode === "number" ? error.exitCode : 1;
   }
@@ -1226,6 +1239,10 @@ if (!preflightBypass.has(rawArgv[0] ?? "")) {
   }
 }
 await hydrateLibraryPathEnv({ target: targetFromArgv(rawArgv), config: readConfig(configPath()) });
+{
+  const refused = await loadSelectedAdapter(rawArgv[0] ?? "", rawArgv.slice(1));
+  if (refused !== void 0) process.exit(refused);
+}
 if (hasPassthroughHelp(rawArgv)) {
   process.exit(await delegate(rawArgv));
 }

package/dist/performance-observation.js

@@ -15,17 +15,13 @@ const sessions = /* @__PURE__ */ new Map();
 const DEFAULT_MAX_DURATION_MS = 5 * 60 * 1e3;
 const MAX_DURATION_MS = 60 * 60 * 1e3;
 const gzipAsync = promisify(gzip);
-function startRunPerformanceObservation(observer, { target, artifactsDir, env, ports }) {
+function startRunPerformanceObservation(observer, { target, artifactsDir, env }) {
   const key = path.resolve(artifactsDir);
   const session = {
     observer,
     artifactsDir: key,
-    env: {
-      ...env,
-      ...ports.watcherPort ? { WATCHER_PORT: ports.watcherPort } : {}
-    },
+    env,
     nodeEvents: [],
-    ports,
     target,
     windows: /* @__PURE__ */ new Map()
   };
@@ -152,7 +148,7 @@ async function performanceBackend(session) {
   if (session.backend) return session.backend;
   if (session.backendError) throw new Error(session.backendError);
   try {
-    session.backend = await session.observer.backend(session.target, session.env, session.ports);
+    session.backend = await session.observer.backend(session.target, session.env);
     return session.backend;
   } catch (error) {
     session.backendError = errorMessage(error);
@@ -515,13 +511,11 @@ function unavailableCapture(session, window, reason) {
     session.nodeEvents
   );
 }
-async function createExtensionPerformanceObserver(target, env, ports) {
-  return createExtensionPerformanceBackend(extensionCdpPort(ports, env), target);
+async function createExtensionPerformanceObserver(target, env) {
+  return createExtensionPerformanceBackend(extensionCdpPort(env), target);
 }
-function extensionCdpPort(ports, env) {
-  const port = Number(
-    ports.cdpPort ?? env.CDP_PORT ?? env.RECIPE_CDP_PORT
-  );
+function extensionCdpPort(env) {
+  const port = Number(env.CDP_PORT ?? env.RECIPE_CDP_PORT);
   if (!Number.isInteger(port) || port <= 0) {
     throw new Error("Extension performance observation requires CDP_PORT.");
   }

package/dist/runner.js

@@ -1,4 +1,5 @@
 import { execSync } from "node:child_process";
+import { createHash } from "node:crypto";
 import { OFFICIAL_RECIPE_ACTIONS } from "@farmslot/protocol";
 import { createMetaMaskAdapters, createMetaMaskUiTransport } from "./adapters.js";
 import { getAdapterSurface } from "./adapters/surface.js";
@@ -8,6 +9,7 @@ import {
   resolveMetaMaskMobileLifecycleTarget
 } from "./app-lifecycle.js";
 import { loadMetaMaskExtensionActionManifest, loadMetaMaskMobileActionManifest } from "./manifest.js";
+import { adapterPlugin } from "@farmslot/recipe-cli/harness";
 import { actionSourceIntegrity, metaMaskActionExecutionCapabilities } from "./recipe-security.js";
 import {
   createRecordingTargetProvider,
@@ -50,7 +52,12 @@ async function createMetaMaskRunner(adapter, actionManifest, options = {}) {
   const { createReactNativeBridgeUiTransport } = await importRecipeHarnessRuntimeReactNativeBridge();
   const { createAppLifecycleAdapters } = await importRecipeHarnessAppLifecycle();
   const actions = Object.keys(actionManifest.actions);
-  const customActions = actions.filter((action) => !OFFICIAL_ACTIONS.has(action));
+  const surface = getAdapterSurface(adapter);
+  const coded = await surface.actions.adapters?.() ?? [];
+  const codedActions = new Set(coded.map((entry) => entry.action));
+  const customActions = actions.filter(
+    (action) => !OFFICIAL_ACTIONS.has(action) && !codedActions.has(action)
+  );
   const actionSources = options.actionSources ? new Map([...options.actionSources].map(([action, source]) => [action, { ...source }])) : void 0;
   const preparedLiveAdapters = await prepareLiveAdapterImplementations(
     adapter,
@@ -58,6 +65,7 @@ async function createMetaMaskRunner(adapter, actionManifest, options = {}) {
     actionSources,
     options.trustTaskActions
   );
+  bindPluginDigest(actionSources, codedActions, adapterPlugin(adapter)?.digest);
   const declaredActions = new Set(actions);
   const core = createStandardCoreAdapters({ actions });
   const projectOwnedOfficialActions = /* @__PURE__ */ new Set(["app.status", "app.lifecycle"]);
@@ -73,7 +81,6 @@ async function createMetaMaskRunner(adapter, actionManifest, options = {}) {
     }, preparedLiveAdapters, { hudPolicy: options.autoHud === true ? "show" : "auto" })
   });
   const existing = new Set([...core, ...ui].map((entry) => entry.action));
-  const surface = getAdapterSurface(adapter);
   const lifecycleAdapters = bindMetaMaskMobileLifecycleDeadline(
     createAppLifecycleAdapters({
       actions,
@@ -82,11 +89,12 @@ async function createMetaMaskRunner(adapter, actionManifest, options = {}) {
     })
   );
   const lifecycle = surface.actions.lifecycle ? await surface.actions.lifecycle(lifecycleAdapters) : lifecycleAdapters;
-  const custom = createMetaMaskAdapters(
-    adapter,
-    customActions,
-    preparedLiveAdapters
-  ).filter(
+  const custom = [
+    ...coded,
+    ...createMetaMaskAdapters(adapter, customActions, preparedLiveAdapters).filter(
+      (entry) => !codedActions.has(entry.action)
+    )
+  ].filter(
     (entry) => declaredActions.has(entry.action) && !existing.has(entry.action) && !lifecycle.some((lifecycleEntry) => lifecycleEntry.action === entry.action)
   );
   const autoHudDisabled = options.autoHud === false || options.autoHud === void 0 && (process.env.METAMASK_RECIPE_AUTO_HUD === "0" || process.env.METAMASK_RECIPE_AUTO_HUD === "false");
@@ -197,6 +205,17 @@ function deduplicateLibraryResolutionLogs(logger, suppress = false) {
     }
   };
 }
+function bindPluginDigest(sources, actions, pluginDigest) {
+  if (!sources || !pluginDigest) return;
+  const bind = (digest) => `sha256:${createHash("sha256").update(`${digest}\0${pluginDigest}`).digest("hex")}`;
+  for (const action of actions) {
+    const source = sources.get(action);
+    if (!source) continue;
+    const { digest, resolveDigest } = source;
+    source.digest = bind(digest ?? "");
+    source.resolveDigest = resolveDigest ? async () => bind(await resolveDigest()) : void 0;
+  }
+}
 async function prepareLiveAdapterImplementations(platform, actions, sources, trustTaskActions = false) {
   const prepared = /* @__PURE__ */ new Map();
   if (!sources) return prepared;

package/docs/cli-contract.md

@@ -92,9 +92,11 @@ These are real farm bugs. The goldens freeze the current rejections, so fixing e
 
 ## Terminal adapter
 
-`goldens-terminal` freezes the `va-mmcx-terminal-farm` hooks with their exact argv (`recipe_action_manifest`, `recipe_doctor`, `recipe_harness_{install,verify,cleanup}`, `recipe_run`, the browser `boot`/`shutdown` resources and `teardown`), against a fresh fixture slot: no slot dev server, no Extension dist, and the farm's wallet fixture outside the slot, so `install` copies it in. `launch` is frozen on its cold path: it refuses at the missing dist before any browser starts. The slot's CDP port is the one port no port holder reserves: a farm slot with no browser has it free, and the Terminal's port checks probe it. `goldens-discovery` covers `terminal` in its per-adapter loop, so `terminal/actions-raw` and `discovery/actions-raw-terminal` freeze the same manifest and change together.
+`goldens-terminal` freezes the `va-mmcx-terminal-farm` hooks with their exact argv (`recipe_action_manifest`, `recipe_doctor`, `recipe_harness_{install,verify,cleanup}`, `recipe_run`, the browser `boot`/`shutdown` resources and `teardown`), against a fresh fixture slot: no slot dev server, no Extension dist, and the farm's wallet fixture outside the slot, so `install` copies it in. `launch` is frozen on its cold path: it refuses at the missing dist before any browser starts. The slot's CDP port is the one port no port holder reserves: a farm slot with no browser has it free, and the Terminal's port checks probe it.
 
-Outside this boundary: a successful `launch` and the `temp/recipe/runtime/terminal/` layout (`browser.pid`), recipes and actions from the farm's `RECIPE_LIBRARY_PATH` libraries, `run terminal.perps.<name> --plan`, and the recipe-terminal `console-guard.mjs` import paths.
+`terminal` is the plugin the `experimental-metamask-recipe-terminal` library declares (`adapters.terminal`, extends the built-in `web-dapp`), so the family loads it: set `GOLDENS_TERMINAL_LIBRARY` to a checkout of that library, which the family copies into its sandbox and puts on `RECIPE_LIBRARY_PATH`. CI has no access to the private library and skips the family (`CI` set); local runs need the variable, and without it outside CI the family fails. A release gate must set it too (proposed for the release checklist). `goldens-discovery` covers the built-in `web-dapp` in its per-adapter loop.
+
+Outside this boundary: a successful `launch` and the `temp/recipe/runtime/terminal/` layout (`browser.pid`), the library's recipes, `run terminal.perps.<name> --plan`, and the recipe-terminal `console-guard.mjs` import paths.
 
 ## Running the goldens
 
@@ -142,7 +144,7 @@ The goldens need the harness to be a git checkout: `execution-provenance.json` `
 2. UUIDs become `<UUID>`. Git object ids (40 hex, or a short hex value under a `*head`/`*gitRef`/`*commit` key) become `<GIT_REF>`. ISO-8601 timestamps become `<TIMESTAMP>`, and compact stamps in names `<STAMP>`. Path-derived slot ids `local-<adapter>-<8 hex>` become `local-<adapter>-<HASH>`.
 3. The package version becomes `<HARNESS_VERSION>`. Any other `x.y.z` under a key ending in `version` becomes `<VERSION>`.
 4. Numbers under volatile keys: `*pid` becomes `<PID>`, `inode` `<INODE>`, `*port` `<PORT>`, `*At`/`*Time`/`*timestamp`/`mtime*` `<TIMESTAMP>`, and `*Ms`/`duration*`/`elapsed*` `<DURATION>`. Values inside `schema` and `examples` subtrees (static manifest content) are never rewritten.
-5. `invocationDigest` becomes `<DIGEST>`: it hashes `recipe-invocation.json`, which carries sandbox paths and timestamps and is frozen itself in normalised form. `runner.sourceFingerprint` becomes `<FINGERPRINT>`: it hashes the harness source tree, so any harness edit changes it. A `status` holding `git status --porcelain` output (provenance `runner.status` and `libraries[].status`, empty when clean) becomes `<GIT_STATUS>`. Content-only digests (recipe and dependency digests) stay frozen.
+5. `invocationDigest` becomes `<DIGEST>`: it hashes `recipe-invocation.json`, which carries sandbox paths and timestamps and is frozen itself in normalised form. `runner.sourceFingerprint` becomes `<FINGERPRINT>`: it hashes the harness source tree, so any harness edit changes it. A `status` holding `git status --porcelain` output (provenance `runner.status` and `libraries[].status`, empty when clean) becomes `<GIT_STATUS>`. A loaded adapter plugin's code digest in doctor's `adapter-plugin:<id>` message becomes `sha256:<PLUGIN_DIGEST>`: it hashes the recipe library's plugin files, so any library edit changes it. Content-only digests (recipe and dependency digests) stay frozen.
 6. Durations in text (`0.3s`, `123ms`) become `<DURATION>`.
 
 In tree listings, files whose names differ only by a volatile token collapse into one row: a count and the union of their key shapes, or the sorted list of their values in a value tree.

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

@@ -15,7 +15,7 @@ export const COLLECTOR_SCRIPT_NAME = 'console-tail.mjs';
 export const CAPTURE_CONTROL_MARK = '[mm-harness-capture-control]';
 
 // Same derivation as ownerMarker('console-collector', …) in
-// adapters/terminal/lib/processes.mjs, so the terminal stop path finds it.
+// adapters/web-dapp/lib/processes.mjs, so the web-dapp stop path finds it.
 export function collectorOwnerMarker(runtimeDir) {
   const id = createHash('sha256').update(path.resolve(runtimeDir)).digest('hex').slice(0, 32);
   return `--mm-harness-owner=console-collector-${id}`;

package/library/actions/{terminal → web-dapp}/app/assert_no_console_errors.mjs

@@ -1,4 +1,4 @@
-// Fail the recipe when the terminal page logged an error or uncaught exception
+// Fail the recipe when the app page logged an error or uncaught exception
 // that the recipe libraries' console allowlist does not mark as known
 // third-party noise. Reads the slot console capture (app-console.log, and
 // extension-console.log when asked) from where the current slot browser's
@@ -20,7 +20,7 @@ import {
   loadConsoleAllowlist,
 } from '../../shared/console-findings.mjs';
 import { collectorOwnerMarker, collectorStatus, verifyCapture } from '../../shared/console-collector.mjs';
-import { isDirectRun, readBrowserState, runAdapter, terminalRuntimeDir } from '../platform/runtime.mjs';
+import { isDirectRun, readBrowserState, runAdapter, webDappPolicy, webDappRuntimeDir } from '../platform/runtime.mjs';
 
 const LOGS = Object.freeze({ page: 'app-console.log', extension: 'extension-console.log' });
 
@@ -55,7 +55,7 @@ export async function assertNoConsoleErrors(input, env = process.env, deps = {})
   const projectRoot = input.context?.projectRoot;
   const sources = Array.isArray(node.sources) && node.sources.length ? node.sources.map(String) : ['page', 'browser'];
   const levels = new Set(Array.isArray(node.levels) && node.levels.length ? node.levels.map(String) : ['error', 'exception']);
-  const runtime = terminalRuntimeDir(projectRoot);
+  const runtime = webDappRuntimeDir(projectRoot);
   const state = await readBrowserState(projectRoot);
   if (!state?.cdpPort || !state.appOrigin) throw unavailable('no slot browser state (browser.json)');
   const capture = (deps.collectorStatus ?? collectorStatus)({
@@ -107,7 +107,7 @@ export async function assertNoConsoleErrors(input, env = process.env, deps = {})
     // The recorded launch offset was past the end of a replaced capture
     // file; that file was read from its start.
     offsetResets,
-    proofPath: 'terminal-console-capture',
+    proofPath: `${webDappPolicy().adapterId}-console-capture`,
   };
   if (failing.size > 0) {
     const list = [...failing.values()].map((item) => `${item.level} [${item.source}] ${item.example} ×${item.count}`).join('\n  ');

package/library/actions/{terminal → web-dapp}/app/launch.mjs

@@ -1,15 +1,15 @@
-// Explicit lifecycle step: start (or reuse) the terminal slot browser with the
+// Explicit lifecycle step: start (or reuse) the web-dapp slot browser with the
 // requested signer (MetaMask extension or injected strict wallet) and fixture
 // account, and the wallet host that records wallet requests. A fresh_profile
 // start forgets the app's stored agent key and the extension's dapp permission.
 
-import { appPort, cdpPort, isDirectRun, resolveSigner, runAdapter } from '../platform/runtime.mjs';
-import { launchTerminalBrowser } from '../../../../adapters/terminal/launch.mjs';
-import { policy } from '../../../../adapters/terminal/policy.mjs';
+import { appPort, cdpPort, isDirectRun, resolveSigner, runAdapter, webDappPolicy } from '../platform/runtime.mjs';
+import { launchWebDappBrowser } from '../../../../adapters/web-dapp/launch.mjs';
 
 export async function launch(input) {
   const node = input.node ?? {};
-  const state = await launchTerminalBrowser({
+  const policy = webDappPolicy();
+  const state = await launchWebDappBrowser({
     target: input.context?.projectRoot,
     'cdp-port': cdpPort(input),
     'app-port': appPort(input),
@@ -24,7 +24,7 @@ export async function launch(input) {
     network: node.network,
     'mainnet-confirmation': node.mainnet_confirmation,
     'start-chain': node.start_chain ?? policy.startChain,
-  }, process.env, { policy });
+  }, process.env);
   return {
     action: input.action,
     status: 'ready',
@@ -39,7 +39,7 @@ export async function launch(input) {
     slowMoMs: state.slowMoMs ?? 0,
     extension: state.extension ? { id: state.extension.id, version: state.extension.version } : null,
     freshProfile: state.freshProfile,
-    proofPath: 'terminal-browser-launch',
+    proofPath: `${policy.adapterId}-browser-launch`,
   };
 }
 

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

@@ -1,12 +1,12 @@
-// app.hud for the terminal: fold the runner's progress update into
+// app.hud for web-dapp: fold the runner's progress update into
 // <runtime>/hud.json and draw it on the app tab now. The wallet host redraws
 // the same state after every navigation. The HUD is advisory: a missing
 // browser or a busy tab skips the update instead of failing the recipe.
 
 import { isAppUrl } from '@farmslot/adapter-web/origin';
 
-import { clearHudState, hudRenderExpression, nextHudState, readHudState, writeHudState } from '../../../../adapters/terminal/lib/hud.mjs';
-import { appOrigin, cdpPort, readBrowserState, terminalRuntimeDir } from './runtime.mjs';
+import { clearHudState, hudRenderExpression, nextHudState, readHudState, writeHudState } from '../../../../adapters/web-dapp/lib/hud.mjs';
+import { appOrigin, cdpPort, readBrowserState, webDappRuntimeDir } from './runtime.mjs';
 import { importRecipeHarnessRuntimeCdp } from '../../harness-exports.mjs';
 
 // --hud show draws in any mode; --hud auto (the default) only for a visible
@@ -47,14 +47,14 @@ async function drawOnAppTabs(input, expression, timeoutMs = 3000) {
   return results;
 }
 
-export async function showTerminalHud(input, { hudPolicy = 'auto' } = {}) {
+export async function showAppHud(input, { hudPolicy = 'auto' } = {}) {
   const node = input.node ?? {};
   const projectRoot = input.context?.projectRoot;
   const nodeId = input.context?.nodeId ?? '';
   const browserState = projectRoot ? await readBrowserState(projectRoot) : null;
   if (!browserState) return { hud: false, skipped: true, reason: 'no slot browser yet' };
   if (!hudVisible(hudPolicy, browserState)) return { hud: false, skipped: true, reason: 'headless browser (--hud show draws anyway)' };
-  const runtimeDir = terminalRuntimeDir(projectRoot);
+  const runtimeDir = webDappRuntimeDir(projectRoot);
   let state = null;
   if (node.clear === true) {
     clearHudState(runtimeDir);

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

@@ -1,4 +1,4 @@
-// Select the CDP page a terminal UI action drives: the app tab (default) or the
+// Select the CDP page a web-dapp UI action drives: the app tab (default) or the
 // MetaMask wallet surface (side panel / notification / popup) that shows the
 // pending dapp request. Pages are never brought to front unless
 // FARMSLOT_FOCUS_BROWSER=1, as in the Extension adapter: Page.bringToFront
@@ -8,9 +8,9 @@
 
 import { isAppUrl } from '@farmslot/adapter-web/origin';
 
-import { resolveSlowMo } from '../../../../adapters/terminal/lib/display.mjs';
-import { HUD_ELEMENT } from '../../../../adapters/terminal/lib/hud.mjs';
-import { cdpListenerPids } from '../../../../adapters/terminal/lib/processes.mjs';
+import { resolveSlowMo } from '../../../../adapters/web-dapp/lib/display.mjs';
+import { HUD_ELEMENT } from '../../../../adapters/web-dapp/lib/hud.mjs';
+import { cdpListenerPids } from '../../../../adapters/web-dapp/lib/processes.mjs';
 import { appOrigin, cdpPort, readBrowserState } from './runtime.mjs';
 import { importRecipeHarnessRuntimeCdp } from '../../harness-exports.mjs';
 
@@ -41,7 +41,7 @@ export function pickAppTarget(targets, origin) {
   return pages.find((target) => isAppUrl(target.url, origin)) ?? pages.find((target) => target.url === 'about:blank') ?? null;
 }
 
-export async function selectTerminalTarget(input) {
+export async function selectAppTarget(input) {
   const node = input.node ?? {};
   const port = cdpPort(input);
   const surface = resolveSurface(node);
@@ -75,7 +75,7 @@ export async function selectTerminalTarget(input) {
 // the DOM instead.
 class WalletSurfacePage extends CdpWebPage {
   evaluate(expression) {
-    return this.evaluateInIsolatedWorld(expression, 'mm-terminal-wallet-surface');
+    return this.evaluateInIsolatedWorld(expression, 'web-dapp-wallet-surface');
   }
 }
 
@@ -89,7 +89,7 @@ export function hudVisibilityExpression(visible) {
   return `(() => { const host = document.documentElement.querySelector(':scope > ${HUD_ELEMENT}'); if (!host) return false; host.style.visibility = ${JSON.stringify(visible ? '' : 'hidden')}; return true; })()`;
 }
 
-class TerminalAppPage extends CdpWebPage {
+class AppPage extends CdpWebPage {
   async screenshot(context, relPath, metadata = {}) {
     const hidden = await this.evaluate(hudVisibilityExpression(false)).catch(() => false);
     try {
@@ -144,7 +144,7 @@ class TerminalAppPage extends CdpWebPage {
       }
       const top = document.elementFromPoint(rect.left + rect.width / 2, rect.top + rect.height / 2);
       return { error: 'Target is fully covered by ' + (top ? top.tagName.toLowerCase() : 'nothing') + ': ' + ${JSON.stringify(selector)} };
-    })()`, 'mm-terminal-click');
+    })()`, 'web-dapp-click');
   }
 
   async setInput(selector, value) {
@@ -217,14 +217,14 @@ export function assertAppListenersUnchanged(state, current) {
 
 const PAGE_DEPS = Object.freeze({
   listeners: (port) => cdpListenerPids(port),
-  select: (input) => selectTerminalTarget(input),
+  select: (input) => selectAppTarget(input),
   connect: (url) => CdpSession.connect(url),
   browserState: (projectRoot) => readBrowserState(projectRoot),
   sleep: (ms) => sleep(ms),
   env: process.env,
 });
 
-export async function withTerminalPage(input, callback, deps = PAGE_DEPS) {
+export async function withAppPage(input, callback, deps = PAGE_DEPS) {
   const state = input.context?.projectRoot ? await deps.browserState(input.context.projectRoot) : null;
   const delay = slowMoFor(state, deps.env);
   if (delay > 0) await deps.sleep(delay);
@@ -237,7 +237,7 @@ export async function withTerminalPage(input, callback, deps = PAGE_DEPS) {
     await session.call('Page.enable');
     await session.call('Runtime.enable');
     if (focusBrowserRequested(deps.env)) await session.call('Page.bringToFront');
-    const page = surface === 'wallet' ? new WalletSurfacePage(session) : new TerminalAppPage(session);
+    const page = surface === 'wallet' ? new WalletSurfacePage(session) : new AppPage(session);
     const result = await callback(page);
     return result && typeof result === 'object' && !Array.isArray(result)
       ? { ...result, surface, cdpPort: port, targetUrl: target.url.replace(/0x[0-9a-fA-F]{40}/gu, '<address>') }

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;
   }
 }