@deeeed/metamask-harness 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## Unreleased
 
+## 0.21.0 - 2026-07-24
+
+### Changed
+
+- Simplified action manifests to one schema-backed keyed action map; action kind,
+  library identity, categories, and provenance are inferred from authoritative
+  runtime inputs.
+- Updated the Farmslot protocol, agent runtime, and recipe harness dependencies
+  for Recipe Protocol v1 trace consistency.
+
 ## 0.20.0 - 2026-07-24
 
 ### Added

package/adapters/core/inject.sh

@@ -111,9 +111,7 @@ install_v1_runner_assets() {
     rsync -a --delete "$METAMASK_RUNNER_DIR/library/recipes/" "$HARNESS_DIR/runner/recipes/"
   fi
   rm -rf "$HARNESS_DIR/runner/flows"
-  if [ -f "$METAMASK_RUNNER_DIR/library/library.json" ]; then
-    cp "$METAMASK_RUNNER_DIR/library/library.json" "$HARNESS_DIR/runner/library.json"
-  fi
+  rm -f "$HARNESS_DIR/runner/library.json"
   if [ ! -x "$HARNESS_DIR/runner/bin/mm-harness" ]; then
     echo "Refusing core recipe harness install: failed to make runner executable." >&2
     return 1

package/adapters/extension/inject.mjs

@@ -90,8 +90,8 @@ copyFile(path.join(runnerDir, 'library/manifests/mobile.action-manifest.json'),
 copyFile(path.join(runnerDir, 'library/manifests/extension.action-manifest.json'), path.join(harnessDir, 'runner/manifests/extension.action-manifest.json'));
 copyFile(path.join(runnerDir, 'library/manifests/extension.action-manifest.json'), path.join(harnessDir, 'action-manifest.json'));
 copyDir(path.join(runnerDir, 'library/recipes'), path.join(harnessDir, 'runner/recipes'));
-copyFile(path.join(runnerDir, 'library/library.json'), path.join(harnessDir, 'runner/library.json'));
 fs.rmSync(path.join(harnessDir, 'runner/flows'), { recursive: true, force: true });
+fs.rmSync(path.join(harnessDir, 'runner/library.json'), { force: true });
 // The installed overlay has a flat scripts/ runtime API independent of the
 // package's source layout.
 copyFile(path.join(runnerDir, 'adapters/extension/launch-browser.cjs'), path.join(harnessDir, 'scripts/launch-browser.cjs'));

package/adapters/mobile/inject.sh

@@ -74,8 +74,8 @@ cp "$RUNNER_DIR/library/manifests/mobile.action-manifest.json" "$HARNESS_DIR/act
 cp "$RUNNER_DIR/library/manifests/mobile.action-manifest.json" "$HARNESS_DIR/runner/manifests/mobile.action-manifest.json"
 cp "$RUNNER_DIR/library/manifests/extension.action-manifest.json" "$HARNESS_DIR/runner/manifests/extension.action-manifest.json"
 rsync -a --delete "$RUNNER_DIR/library/recipes/" "$HARNESS_DIR/runner/recipes/"
-cp "$RUNNER_DIR/library/library.json" "$HARNESS_DIR/runner/library.json"
 rm -rf "$HARNESS_DIR/runner/flows"
+rm -f "$HARNESS_DIR/runner/library.json"
 cp "$RUNNER_DIR/adapters/mobile/verify.sh" "$HARNESS_DIR/scripts/verify.sh"
 cp "$RUNNER_DIR/adapters/shared/harness-path.sh" "$HARNESS_DIR/scripts/lib/harness-path.sh"
 cp "$RUNNER_DIR/adapters/shared/path-defaults.json" "$HARNESS_DIR/scripts/lib/path-defaults.json"

package/dist/commands/call.js

@@ -470,7 +470,7 @@ function renderCallExamples(short, examples) {
   if (!Array.isArray(examples)) return [];
   const out = [];
   for (const example of examples.slice(0, 2)) {
-    const node = isRecord(example) && isRecord(example.node) ? example.node : void 0;
+    const node = isRecord(example) ? example : void 0;
     if (!node) continue;
     const tokens = Object.entries(node).filter(([key]) => key !== "action" && key !== "intent").map(([key, value]) => `${key}=${typeof value === "string" ? value : JSON.stringify(value)}`);
     out.push(`mm-harness call ${short} ${tokens.join(" ")}`.trim());

package/dist/commands/manifest.js

@@ -12,10 +12,12 @@ import {
 import { resolveMetaMaskLibrarySources } from "./run-engine.js";
 import { isSensitiveKey, redactStructuredValue } from "../command-journal.js";
 import {
+  OFFICIAL_RECIPE_ACTIONS,
   officialRecipeActionCapabilities
 } from "@farmslot/protocol";
 import { metaMaskActionExecutionCapabilities } from "../recipe-security.js";
 import { closest } from "../command-contract.js";
+const OFFICIAL_ACTIONS = new Set(OFFICIAL_RECIPE_ACTIONS);
 async function handleActions({ options, positional }) {
   const { adapter, target } = resolveAdapter(options);
   const librarySources = await resolveMetaMaskLibrarySources(optionStrings(options, "library"));
@@ -211,7 +213,7 @@ function authoredExampleNode(examples, preferredValues, schema) {
   if (!Array.isArray(examples)) return void 0;
   if (preferredValues && Object.keys(preferredValues).length > 0) {
     const normalizedValues = normalizePreferredValues(preferredValues, schema);
-    const nodes = examples.map((example) => isRecord(example) && isRecord(example.node) ? example.node : void 0).filter((node) => node !== void 0);
+    const nodes = examples.filter(isRecord);
     if (nodes.length === 0) return void 0;
     const ranked = nodes.map((node) => ({
       node,
@@ -226,7 +228,7 @@ function authoredExampleNode(examples, preferredValues, schema) {
     return { ...ranked[0].node, ...normalizedValues };
   }
   for (const example of examples) {
-    if (isRecord(example) && isRecord(example.node)) return example.node;
+    if (isRecord(example)) return example;
   }
   return void 0;
 }
@@ -305,22 +307,15 @@ function summarizeActionCategories(actions) {
 }
 function describeManifestActions(manifest, actionSources = /* @__PURE__ */ new Map()) {
   const manifestRecord = isRecord(manifest) ? manifest : {};
-  const metadata = isRecord(manifestRecord.action_metadata) ? manifestRecord.action_metadata : {};
-  const official = Array.isArray(manifestRecord.supported_official_actions) ? manifestRecord.supported_official_actions.filter((value) => typeof value === "string") : [];
-  const custom = Array.isArray(manifestRecord.custom_actions) ? manifestRecord.custom_actions.flatMap((entry) => {
-    if (typeof entry === "string") return [{ name: entry, metadata: metadata[entry] }];
-    if (isRecord(entry) && typeof entry.name === "string") {
-      const entryMetadata = { ...entry };
-      const metadataOverride = metadata[entry.name];
-      if (isRecord(metadataOverride)) Object.assign(entryMetadata, metadataOverride);
-      return [{ name: entry.name, metadata: entryMetadata }];
-    }
-    return [];
-  }) : [];
-  return [
-    ...official.map((name) => describeManifestAction(name, "official", metadata[name], actionSources.get(name))),
-    ...custom.map((entry) => describeManifestAction(entry.name, "custom", entry.metadata, actionSources.get(entry.name)))
-  ];
+  const actions = isRecord(manifestRecord.actions) ? manifestRecord.actions : {};
+  return Object.entries(actions).map(
+    ([name, metadata]) => describeManifestAction(
+      name,
+      OFFICIAL_ACTIONS.has(name) ? "official" : "custom",
+      metadata,
+      actionSources.get(name)
+    )
+  );
 }
 function describeManifestAction(name, kind, metadata, source) {
   const record = isRecord(metadata) ? metadata : {};
@@ -330,7 +325,7 @@ function describeManifestAction(name, kind, metadata, source) {
   return {
     name,
     kind,
-    category: actionCategory(name, record.category),
+    category: actionCategory(name),
     description: typeof record.description === "string" ? record.description : "",
     fields: properties,
     schema,
@@ -347,8 +342,7 @@ function describeManifestAction(name, kind, metadata, source) {
     ])]
   };
 }
-function actionCategory(name, configured) {
-  if (typeof configured === "string" && configured.trim()) return configured.trim().toLowerCase();
+function actionCategory(name) {
   const segments = name.split(".");
   if (segments[0] === "metamask" && segments.length > 2) return segments[1] ?? "metamask";
   if (segments[0] === "app" || segments[0] === "cdp") return "runtime";

package/dist/manifest.js

@@ -1,10 +1,8 @@
 import fs from "node:fs";
 import path from "node:path";
+import { OFFICIAL_RECIPE_ACTIONS } from "@farmslot/protocol";
 import { manifestPath, readJson, importRecipeProtocol } from "./paths.js";
-import {
-  actionSourceIntegrity,
-  metaMaskActionExecutionCapabilities
-} from "./recipe-security.js";
+import { actionSourceIntegrity } from "./recipe-security.js";
 function loadMetaMaskMobileActionManifest() {
   return asActionManifest(readJson(manifestPath("mobile")));
 }
@@ -26,12 +24,12 @@ async function resolveActionManifest(adapter, overridePath, librarySources, task
     const implementationRoot = path.resolve(
       taskActionRoot ?? defaultImplementationRoot(manifestPath2)
     );
-    const manifest = withMetaMaskExecutionCapabilities(loadActionManifest(adapter, manifestPath2));
+    const manifest = loadActionManifest(adapter, manifestPath2);
     await validateManifest(manifest);
     const integrity = await actionSourceIntegrity(manifestPath2, "task", implementationRoot);
     return {
       manifest,
-      actionSources: describeManifestSources(manifest, {
+      actionSources: await describeManifestSources(manifest, {
         name: "task",
         tier: "task",
         manifestPath: manifestPath2,
@@ -41,109 +39,125 @@ async function resolveActionManifest(adapter, overridePath, librarySources, task
       })
     };
   }
-  const canonicalPath = manifestPath(adapter);
-  const sources = librarySources?.length ? librarySources : [{ name: "metamask", root: path.dirname(path.dirname(canonicalPath)) }];
+  const canonicalPath = path.resolve(manifestPath(adapter));
+  const canonicalRoot = path.dirname(path.dirname(canonicalPath));
+  const sources = librarySources?.length ? librarySources : [{ name: "metamask", root: canonicalRoot }];
   const manifests = [];
   for (const source of sources) {
-    const file = path.join(source.root, "manifests", `${adapter}.action-manifest.json`);
+    const file = path.resolve(source.root, "manifests", `${adapter}.action-manifest.json`);
     if (!fs.existsSync(file)) continue;
     const manifest = asActionManifest(readJson(file));
     await validateManifest(manifest);
     manifests.push({ source, file, manifest });
   }
-  if (!manifests.some((entry) => path.resolve(entry.file) === path.resolve(canonicalPath))) {
+  if (!manifests.some((entry) => entry.file === canonicalPath)) {
     const manifest = loadActionManifest(adapter);
     await validateManifest(manifest);
-    manifests.push({ source: { name: "metamask", root: path.dirname(path.dirname(canonicalPath)) }, file: canonicalPath, manifest });
+    manifests.push({
+      source: { name: "metamask", root: canonicalRoot },
+      file: canonicalPath,
+      manifest
+    });
   }
-  const canonical = manifests.find((entry) => entry.source.name === "metamask") ?? manifests.at(-1);
+  const canonical = manifests.find((entry) => entry.file === canonicalPath);
   if (!canonical) throw new Error(`No ${adapter} action manifest could be resolved.`);
-  const base = cloneManifest(canonical.manifest);
-  const official = new Set(stringArray(recordOf(base).supported_official_actions));
-  const custom = /* @__PURE__ */ new Map();
-  const customMetadata = /* @__PURE__ */ new Map();
-  const bindings = /* @__PURE__ */ new Map();
+  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 canonicalImplementationRoot = path.join(canonical.source.root, "actions");
   const canonicalIntegrity = await actionSourceIntegrity(
     canonical.file,
     "canonical",
     canonicalImplementationRoot
   );
-  const actionSources = describeManifestSources(base, {
-    name: "metamask",
-    tier: "canonical",
-    manifestPath: canonical.file,
-    implementationRoot: canonicalImplementationRoot,
-    trust: "trusted",
-    ...canonicalIntegrity
-  });
-  for (const entry of manifests) {
-    const sourceName = entry.source.name ?? path.basename(entry.source.root);
-    const tier = sourceName === "metamask" ? "canonical" : sourceName === "personal" ? "personal" : "team";
+  const actionSources = /* @__PURE__ */ new Map();
+  for (const name of Object.keys(mergedActions)) {
+    actionSources.set(name, {
+      name: "official",
+      tier: "official",
+      manifestPath: canonical.file
+    });
+  }
+  const custom = /* @__PURE__ */ new Set();
+  const ordered = [
+    ...manifests.filter((entry) => entry.file !== canonicalPath),
+    canonical
+  ];
+  for (const entry of ordered) {
+    const isCanonical = entry.file === canonicalPath;
+    if (!isCanonical && 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 implementationRoot = path.join(entry.source.root, "actions");
-    const integrity = await actionSourceIntegrity(entry.file, tier, implementationRoot);
+    const integrity = isCanonical ? canonicalIntegrity : await actionSourceIntegrity(entry.file, tier, implementationRoot);
     const sourceInfo = {
       name: sourceName,
       tier,
       manifestPath: entry.file,
       implementationRoot,
-      trust: entry.source.provenance?.trust ?? (tier === "canonical" ? "trusted" : "unknown"),
+      trust: entry.source.provenance?.trust ?? (isCanonical ? "trusted" : "unknown"),
       ...integrity
     };
-    const manifestRecord = recordOf(entry.manifest);
-    const metadata = recordOf(manifestRecord.action_metadata);
-    for (const action of customActions(manifestRecord.custom_actions)) {
-      if (official.has(action.name)) {
-        throw new Error(`Library action ${action.name} from ${entry.file} conflicts with an official action.`);
+    for (const [name, action] of Object.entries(actionsOf(entry.manifest))) {
+      if (official.has(name)) {
+        if (!isCanonical) {
+          throw new Error(
+            `Library action ${name} from ${entry.file} conflicts with an official action; team libraries may declare namespaced custom actions only.`
+          );
+        }
+        continue;
       }
-      if (custom.has(action.name)) {
-        const existing = actionSources.get(action.name);
+      if (custom.has(name)) {
+        const existing = actionSources.get(name);
         if (existing && existing.name !== sourceName) {
           existing.shadows = [...existing.shadows ?? [], sourceName];
         }
         continue;
       }
-      custom.set(action.name, action.value);
-      customMetadata.set(action.name, metadata[action.name]);
-      actionSources.set(action.name, { ...sourceInfo });
-    }
-    for (const binding of objectArray(manifestRecord.native_bindings)) {
-      const action = typeof binding.action === "string" ? binding.action : void 0;
-      if (action && !bindings.has(action)) bindings.set(action, binding);
+      custom.add(name);
+      mergedActions[name] = action;
+      actionSources.set(name, { ...sourceInfo });
     }
   }
-  const baseRecord = recordOf(base);
-  baseRecord.custom_actions = [...custom.values()];
-  const baseMetadata = recordOf(baseRecord.action_metadata);
-  for (const [name, metadata] of customMetadata) {
-    if (metadata !== void 0) baseMetadata[name] = metadata;
+  return {
+    manifest: {
+      $schema: canonical.manifest.$schema,
+      actions: mergedActions,
+      ...canonical.manifest.observers ? { observers: canonical.manifest.observers } : {}
+    },
+    actionSources
+  };
+}
+function actionsOf(manifest) {
+  return manifest.actions;
+}
+async function describeManifestSources(manifest, customSource) {
+  const official = new Set(OFFICIAL_RECIPE_ACTIONS);
+  const sources = /* @__PURE__ */ new Map();
+  for (const name of Object.keys(actionsOf(manifest))) {
+    if (official.has(name)) {
+      sources.set(name, {
+        name: "official",
+        tier: "official",
+        manifestPath: customSource.manifestPath
+      });
+      continue;
+    }
+    sources.set(name, { ...customSource });
   }
-  baseRecord.action_metadata = baseMetadata;
-  baseRecord.native_bindings = [...bindings.values()];
-  return { manifest: withMetaMaskExecutionCapabilities(base), actionSources };
+  return sources;
 }
 function defaultImplementationRoot(selectedManifestPath) {
   const manifestDirectory = path.dirname(selectedManifestPath);
   return path.basename(manifestDirectory) === "manifests" ? path.join(path.dirname(manifestDirectory), "actions") : path.join(manifestDirectory, "actions");
 }
-function withMetaMaskExecutionCapabilities(manifest) {
-  const result = cloneManifest(manifest);
-  const record = recordOf(result);
-  if (!Array.isArray(record.custom_actions)) return result;
-  record.custom_actions = record.custom_actions.map((entry) => {
-    const name = typeof entry === "string" ? entry : recordOf(entry).name;
-    if (typeof name !== "string") return entry;
-    const capabilities = metaMaskActionExecutionCapabilities(name);
-    if (capabilities.length === 0) return entry;
-    const declaredValue = typeof entry === "string" ? void 0 : recordOf(entry).execution_capabilities;
-    const declared = Array.isArray(declaredValue) ? declaredValue.filter(
-      (capability) => typeof capability === "string"
-    ) : [];
-    const executionCapabilities = [.../* @__PURE__ */ new Set([...declared, ...capabilities])];
-    return typeof entry === "string" ? { name, execution_capabilities: executionCapabilities } : { ...recordOf(entry), execution_capabilities: executionCapabilities };
-  });
-  return result;
-}
 async function validateManifest(manifest) {
   const { validateRecipeActionManifestDocument } = await importRecipeProtocol();
   const result = validateRecipeActionManifestDocument(manifest);
@@ -157,41 +171,11 @@ async function validateManifest(manifest) {
 function asActionManifest(value) {
   return value;
 }
-function cloneManifest(value) {
-  return JSON.parse(JSON.stringify(value));
-}
-function recordOf(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
-}
-function stringArray(value) {
-  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
-}
-function objectArray(value) {
-  return Array.isArray(value) ? value.filter((entry) => Boolean(entry) && typeof entry === "object" && !Array.isArray(entry)) : [];
-}
-function customActions(value) {
-  if (!Array.isArray(value)) return [];
-  return value.flatMap((entry) => {
-    if (typeof entry === "string") return [{ name: entry, value: entry }];
-    const record = recordOf(entry);
-    return typeof record.name === "string" ? [{ name: record.name, value: entry }] : [];
-  });
-}
-function describeManifestSources(manifest, customSource) {
-  const record = recordOf(manifest);
-  const sources = /* @__PURE__ */ new Map();
-  for (const name of stringArray(record.supported_official_actions)) {
-    sources.set(name, { name: "official", tier: "official", manifestPath: customSource.manifestPath });
-  }
-  for (const action of customActions(record.custom_actions)) sources.set(action.name, { ...customSource });
-  return sources;
-}
 export {
   loadActionManifest,
   loadMetaMaskCoreActionManifest,
   loadMetaMaskExtensionActionManifest,
   loadMetaMaskMobileActionManifest,
   resolveActionManifest,
-  validateManifest,
-  withMetaMaskExecutionCapabilities
+  validateManifest
 };

package/dist/runner.js

@@ -1,4 +1,5 @@
 import { execSync } from "node:child_process";
+import { OFFICIAL_RECIPE_ACTIONS } from "@farmslot/protocol";
 import { createMetaMaskAdapters, createMetaMaskUiTransport } from "./adapters.js";
 import {
   mobileSourceFingerprint,
@@ -6,11 +7,13 @@ import {
 } from "./adapters/mobile/source-freshness.js";
 import { resolveMetaMaskMobileLifecycleTarget } from "./app-lifecycle.js";
 import { loadMetaMaskExtensionActionManifest, loadMetaMaskMobileActionManifest } from "./manifest.js";
+import { metaMaskActionExecutionCapabilities } from "./recipe-security.js";
 import {
   prepareLiveAdapterScript
 } from "./live-adapter-contract.js";
 import { createMetaMaskRecordingTargetProvider } from "./recording-target.js";
 import { importRecipeHarness, importRecipeHarnessAppLifecycle, importRecipeHarnessRuntimeCdp, importRecipeHarnessRuntimeReactNativeBridge, runnerDir } from "./paths.js";
+const OFFICIAL_ACTIONS = new Set(OFFICIAL_RECIPE_ACTIONS);
 async function createMetaMaskMobileRunner(options = {}) {
   return createMetaMaskRunner(
     "mobile",
@@ -32,9 +35,8 @@ async function createMetaMaskRunner(adapter, actionManifest, options = {}) {
   const { createCdpWebUiTransport } = await importRecipeHarnessRuntimeCdp();
   const { createReactNativeBridgeUiTransport } = await importRecipeHarnessRuntimeReactNativeBridge();
   const { createAppLifecycleAdapters } = await importRecipeHarnessAppLifecycle();
-  const customActions = (actionManifest.custom_actions ?? []).map(
-    (entry) => typeof entry === "string" ? entry : entry.name
-  );
+  const actions = Object.keys(actionManifest.actions);
+  const customActions = actions.filter((action) => !OFFICIAL_ACTIONS.has(action));
   const actionSources = options.actionSources ? new Map([...options.actionSources].map(([action, source]) => [action, { ...source }])) : void 0;
   const preparedLiveAdapters = await prepareLiveAdapterImplementations(
     adapter,
@@ -42,7 +44,6 @@ async function createMetaMaskRunner(adapter, actionManifest, options = {}) {
     actionSources,
     options.trustTaskActions
   );
-  const actions = [...actionManifest.supported_official_actions, ...customActions];
   const declaredActions = new Set(actions);
   const core = createStandardCoreAdapters({ actions });
   const projectOwnedOfficialActions = /* @__PURE__ */ new Set(["app.status", "app.lifecycle"]);
@@ -144,8 +145,10 @@ async function prepareLiveAdapterImplementations(platform, actions, sources, tru
 }
 function adapterSecurity(action, sources, trustTaskActions = false) {
   const source = sources?.get(action);
+  const capabilities = !OFFICIAL_ACTIONS.has(action) ? { capabilities: metaMaskActionExecutionCapabilities(action) } : {};
   if (source?.tier === "task") {
     return {
+      ...capabilities,
       source: {
         kind: "custom-adapter",
         trust: trustTaskActions ? "trusted" : "untrusted",
@@ -158,6 +161,7 @@ function adapterSecurity(action, sources, trustTaskActions = false) {
   }
   if (source && source.tier !== "official") {
     return {
+      ...capabilities,
       source: {
         kind: source.tier === "canonical" ? "bundled" : "custom-adapter",
         trust: source.trust ?? (source.tier === "canonical" ? "trusted" : "unknown"),
@@ -169,6 +173,7 @@ function adapterSecurity(action, sources, trustTaskActions = false) {
     };
   }
   return {
+    ...capabilities,
     source: {
       kind: "bundled",
       trust: "trusted",

package/docs/RECIPES.md

@@ -89,21 +89,11 @@ The protocol is authoritative:
 
 ```text
 team-recipes/
-  library.json
   manifests/extension.action-manifest.json
   actions/extension/wallet/ensure_ready.mjs
   recipes/onboarding/smoke.extension.recipe.json
 ```
 
-```json
-{
-  "kind": "recipe-library",
-  "schema_version": 1,
-  "name": "wallet-team",
-  "owner": "wallet-team"
-}
-```
-
 ```bash
 export RECIPE_LIBRARY_PATH="wallet=$HOME/shared-library/wallet-team"
 mm-harness run --list
@@ -111,7 +101,8 @@ mm-harness run onboarding.smoke --describe
 mm-harness run onboarding.smoke --plan
 ```
 
-Use `--library wallet=/path/to/library` for one command. Resolution follows the
+Use `--library wallet=/path/to/library` for one command. The alias is the
+source name; without one, the directory name is used. Resolution follows the
 explicit library order, then bundled MetaMask. Adapter-specific variants are
 selected deterministically. Every run records the root recipe, exact resolved
 dependency documents, their digests, call edges, selected sources, and shadows.