@deeeed/metamask-harness 0.74.0 → 0.76.0

package/dist/commands/provision.js

@@ -1,8 +1,7 @@
 import { detectAdapter } from "../harness.js";
 import { assertAdapter } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
-import { clearMobileReleaseArtifactState } from "../adapters/mobile/release-artifact-state.js";
-import { ADAPTER_DETECT_NEXT, usageOut, writeInteractiveProgress } from "./shared.js";
+import { ADAPTER_DETECT_NEXT, usageOut } from "./shared.js";
 import {
   applyWatcherPortOption,
   optionFlag,
@@ -27,10 +26,7 @@ async function handleProvision({ positional, options, rawArgv }) {
   const surface = getAdapterSurface(adapter);
   const rerunCommand = provisionRerunCommand(rawArgv, options, adapter, target);
   const platform = optionString(options, "platform") ?? optionString(options, "devicePlatform") ?? (positional[0] === "runway" ? positional[1] : positional[0]) ?? "ios";
-  if (adapter === "mobile") {
-    writeInteractiveProgress(json, `\u2192 provision mobile ${platform} \u2014 resolving simulator and Runway artifact`);
-    if (!optionFlag(options, "resolveOnly")) clearMobileReleaseArtifactState(target);
-  }
+  surface.runwayProvision.before?.(target, { json, platform, resolveOnly: optionFlag(options, "resolveOnly") });
   const result = await surface.runwayProvision.run(target, {
     json,
     platform,
@@ -50,7 +46,7 @@ async function handleProvision({ positional, options, rawArgv }) {
   });
   const provisionedSimulator = typeof result.simulator === "object" && result.simulator ? result.simulator : void 0;
   const provisionedDevice = typeof provisionedSimulator?.udid === "string" ? provisionedSimulator.udid : typeof provisionedSimulator?.name === "string" ? provisionedSimulator.name : void 0;
-  const next = result.status === "pass" && adapter === "mobile" && result.resolveOnly !== true ? `mm-harness launch ${String(result.platform ?? platform)} --adapter mobile --target ${shellQuote(target)}` + (provisionedDevice ? ` --device ${shellQuoteArg(provisionedDevice)}` : "") : void 0;
+  const next = result.status === "pass" && surface.runwayProvision.launchNext && result.resolveOnly !== true ? `mm-harness launch ${String(result.platform ?? platform)} --adapter ${adapter} --target ${shellQuote(target)}` + (provisionedDevice ? ` --device ${shellQuoteArg(provisionedDevice)}` : "") : void 0;
   const output = next ? { ...result, next } : result;
   if (json) {
     console.log(JSON.stringify(output, null, 2));

package/dist/commands/reload.js

@@ -1,13 +1,9 @@
-import path from "node:path";
-import { runnerDir } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
 import {
   ADAPTER_DETECT_NEXT,
-  EXIT,
   flag,
   parseFlags,
   resolveAdapter,
-  spawnScript,
   targetOf,
   usageOut
 } from "./shared.js";
@@ -25,55 +21,20 @@ async function handleReload(argv) {
       ADAPTER_DETECT_NEXT
     );
   }
-  if (adapter === "core") {
+  const surface = getAdapterSurface(adapter);
+  if (surface.headless) {
     return usageOut(
       json,
       "reload",
-      "core is headless; there is no app runtime to reload.",
-      "mm-harness run <core-recipe>"
+      `${adapter} is headless; there is no app runtime to reload.`,
+      `mm-harness run <${adapter}-recipe>`
     );
   }
-  getAdapterSurface(adapter).resolveSlotPorts(target);
-  if (adapter === "extension") {
-    if (!process.env.CDP_PORT) {
-      return usageOut(
-        json,
-        "reload",
-        "the Extension CDP port could not be resolved.",
-        "mm-harness launch"
-      );
-    }
-    const script2 = path.join(runnerDir, "adapters/extension/reattach.sh");
-    const args2 = ["--target", target, "--cdp-port", process.env.CDP_PORT];
-    if (process.env.WATCHER_PORT) {
-      args2.push("--watcher-port", process.env.WATCHER_PORT);
-    }
-    const result2 = spawnScript(script2, args2, target, json);
-    if (json) {
-      console.log(
-        JSON.stringify(
-          {
-            ok: result2.status === 0,
-            adapter,
-            method: "cdp-reattach",
-            command: "reload",
-            cdpPort: Number(process.env.CDP_PORT),
-            ...result2.status === 0 ? {} : { error: result2.output.slice(-4e3) || "Extension reload failed." }
-          },
-          null,
-          2
-        )
-      );
-    }
-    return result2.status === 0 ? EXIT.ok : EXIT.runtime;
+  if (!surface.reload) {
+    return usageOut(json, "reload", `reload does not support the ${adapter} adapter.`, surface.hints.launch);
   }
-  const script = path.join(runnerDir, "adapters/mobile/reload-app.mjs");
-  const args = [];
-  if (process.env.WATCHER_PORT) args.push("--port", process.env.WATCHER_PORT);
-  if (json) args.push("--json");
-  const result = spawnScript(process.execPath, [script, ...args], target, json);
-  if (json) process.stdout.write(result.output);
-  return result.status === 0 ? EXIT.ok : EXIT.runtime;
+  surface.resolveSlotPorts(target);
+  return surface.reload(target, json);
 }
 export {
   handleReload

package/dist/commands/run-engine.js

@@ -14,9 +14,6 @@ import {
 import { resolveActionManifest, validateManifest } from "../manifest.js";
 import { getAdapterSurface } from "../adapters/surface.js";
 import { extensionProductConfigBlock } from "../adapters/extension/product-config.js";
-import {
-  requireCurrentMobileReleaseArtifactState
-} from "../adapters/mobile/release-artifact-state.js";
 import {
   importRecipeHarness,
   importRecipeProtocol,
@@ -121,13 +118,8 @@ async function runRecipe(adapter, recipe, artifactsDir, projectRoot, actionManif
         );
       }
     } finally {
-      if (adapter === "mobile") {
-        const { hideMobileHudOnTeardown } = await import("../adapters.js");
-        await hideMobileHudOnTeardown(
-          projectRoot,
-          recipeRunEnv(adapter, runtimeOptions)
-        );
-      }
+      const teardown = getAdapterSurface(adapter).run?.teardown;
+      if (teardown) await teardown(projectRoot, recipeRunEnv(adapter, runtimeOptions));
     }
     let recordingError;
     if (executionError === void 0 && result) {
@@ -240,11 +232,12 @@ async function resolveRecipeExecution(adapter, recipe, artifactsDir, projectRoot
     projectRoot,
     rootRecipe: recipeDocument
   });
-  const suppressHudForOpaqueMobile = adapter === "mobile" && process.env.METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME === "1";
+  const surface = getAdapterSurface(adapter);
+  const suppressAutoHud = surface.run?.autoHud?.() === false;
   const runnerOptions = {
     quietStdout: runtimeOptions.stdoutIsMachineContract === true,
     suppressLibraryResolutionLogs: runtimeOptions.suppressLibraryResolutionLogs,
-    autoHud: suppressHudForOpaqueMobile ? false : trust.source && trust.source.trust !== "trusted" ? false : runtimeOptions.autoHud,
+    autoHud: suppressAutoHud ? false : trust.source && trust.source.trust !== "trusted" ? false : runtimeOptions.autoHud,
     onActionEvent: runtimeOptions.onActionEvent,
     actionSources,
     // A direct engineer invocation is the explicit trust boundary for a
@@ -256,7 +249,7 @@ async function resolveRecipeExecution(adapter, recipe, artifactsDir, projectRoot
     ...runnerOptions,
     trustedMutation
   });
-  const useFramedExtensionRecording = adapter === "extension" && recordVideo === "full-run" && trust.source?.trust !== "untrusted" && trust.source?.trust !== "unknown" && captureHelperSupportsRecordSessionSnapshots(projectRoot);
+  const useFramedExtensionRecording = surface.recording?.framed !== void 0 && recordVideo === "full-run" && trust.source?.trust !== "untrusted" && trust.source?.trust !== "unknown" && captureHelperSupportsRecordSessionSnapshots(projectRoot);
   const runRequest = {
     ...recipeDocument !== void 0 ? { recipeDocument } : absoluteRecipePath ? { recipePath: absoluteRecipePath } : { recipeDocument: recipe },
     artifactsDir: absoluteArtifactsDir,
@@ -447,31 +440,22 @@ function executionLibrarySources(sources, invocationTrust) {
     };
   });
 }
+const RUN_ENV_KEYS = [
+  "CDP_PORT",
+  "RECIPE_CDP_PORT",
+  "WATCHER_PORT",
+  "METRO_PORT",
+  "METAMASK_RECIPE_EXTENSION_AUTOLAUNCH"
+];
 function activateRecipeRuntimeEnvironment(adapter, projectRoot, runtimeOptions) {
-  const previousCdpPort = process.env.CDP_PORT;
-  const previousRecipeCdpPort = process.env.RECIPE_CDP_PORT;
-  const previousWatcherPort = process.env.WATCHER_PORT;
-  const previousMetroPort = process.env.METRO_PORT;
-  const previousExtensionAutolaunch = process.env.METAMASK_RECIPE_EXTENSION_AUTOLAUNCH;
-  const previousMobileOpaqueRuntime = process.env.METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME;
-  const previousAndroidPackageId = process.env.ANDROID_PACKAGE_ID;
-  const previousAdbSerial = process.env.ADB_SERIAL;
-  const previousAndroidSerial = process.env.ANDROID_SERIAL;
-  const explicitMobileDeviceEnv = adapter === "mobile" && process.env.MM_HARNESS_EXPLICIT_PLATFORM ? Object.fromEntries(
-    [
-      "PLATFORM",
-      "MM_HARNESS_EXPLICIT_PLATFORM",
-      "IOS_SIMULATOR",
-      "SIM_UDID",
-      "ADB_SERIAL",
-      "ANDROID_SERIAL",
-      "ANDROID_DEVICE",
-      "ANDROID_TARGET_DEVICE_NAME"
-    ].map((key) => [key, process.env[key]])
-  ) : void 0;
-  getAdapterSurface(adapter).resolveSlotPorts(projectRoot);
-  if (explicitMobileDeviceEnv) {
-    for (const [key, value] of Object.entries(explicitMobileDeviceEnv)) {
+  const surface = getAdapterSurface(adapter);
+  const previousEnv = Object.fromEntries(
+    [...RUN_ENV_KEYS, ...surface.run?.envKeys ?? []].map((key) => [key, process.env[key]])
+  );
+  const pinnedEnv = surface.run?.pinnedEnv?.();
+  surface.resolveSlotPorts(projectRoot);
+  if (pinnedEnv) {
+    for (const [key, value] of Object.entries(pinnedEnv)) {
       restoreEnv(key, value);
     }
   }
@@ -486,37 +470,9 @@ function activateRecipeRuntimeEnvironment(adapter, projectRoot, runtimeOptions)
   if (runtimeOptions.launchExistingDist) {
     process.env.METAMASK_RECIPE_EXTENSION_AUTOLAUNCH = "1";
   }
-  if (adapter === "mobile") {
-    const state = requireCurrentMobileReleaseArtifactState(projectRoot);
-    if (state) {
-      const selected = process.env.ADB_SERIAL ?? process.env.ANDROID_SERIAL;
-      if (selected && selected !== state.deviceSerial) {
-        throw new Error(
-          `The Mobile release artifact is installed on ${state.deviceSerial}, not ${selected}. Next: rerun runtime-launch for ${selected}.`
-        );
-      }
-      process.env.METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME = "1";
-      process.env.ANDROID_PACKAGE_ID = state.packageId;
-      process.env.ADB_SERIAL = state.deviceSerial;
-      process.env.ANDROID_SERIAL = state.deviceSerial;
-    }
-  }
+  surface.run?.activateEnv?.(projectRoot);
   return () => {
-    restoreEnv("CDP_PORT", previousCdpPort);
-    restoreEnv("RECIPE_CDP_PORT", previousRecipeCdpPort);
-    restoreEnv("WATCHER_PORT", previousWatcherPort);
-    restoreEnv("METRO_PORT", previousMetroPort);
-    restoreEnv(
-      "METAMASK_RECIPE_EXTENSION_AUTOLAUNCH",
-      previousExtensionAutolaunch
-    );
-    restoreEnv(
-      "METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME",
-      previousMobileOpaqueRuntime
-    );
-    restoreEnv("ANDROID_PACKAGE_ID", previousAndroidPackageId);
-    restoreEnv("ADB_SERIAL", previousAdbSerial);
-    restoreEnv("ANDROID_SERIAL", previousAndroidSerial);
+    for (const [key, value] of Object.entries(previousEnv)) restoreEnv(key, value);
   };
 }
 function actionSourceMap(sources) {
@@ -539,42 +495,11 @@ function recipeRunEnv(adapter, runtimeOptions = {}) {
     PLATFORM: process.env.PLATFORM,
     MM_HARNESS_EXPLICIT_PLATFORM: process.env.MM_HARNESS_EXPLICIT_PLATFORM
   };
-  if (adapter !== "mobile") return base;
-  return {
-    ...base,
-    WATCHER_PORT: process.env.WATCHER_PORT ?? base.CDP_PORT ?? base.RECIPE_CDP_PORT,
-    METRO_PORT: process.env.METRO_PORT ?? process.env.WATCHER_PORT ?? base.CDP_PORT ?? base.RECIPE_CDP_PORT,
-    IOS_SIMULATOR: process.env.IOS_SIMULATOR,
-    SIM_UDID: process.env.SIM_UDID,
-    ANDROID_DEVICE: process.env.ANDROID_DEVICE,
-    ANDROID_TARGET_DEVICE_NAME: process.env.ANDROID_TARGET_DEVICE_NAME,
-    ADB_SERIAL: process.env.ADB_SERIAL,
-    ANDROID_SERIAL: process.env.ANDROID_SERIAL,
-    ANDROID_PACKAGE_ID: process.env.ANDROID_PACKAGE_ID,
-    METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME: process.env.METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME
-  };
+  const childEnv = getAdapterSurface(adapter).run?.childEnv;
+  return childEnv ? childEnv(base) : base;
 }
 async function prepareRuntimeIfNeeded(adapter, projectRoot, runtimeOptions) {
-  if (adapter !== "extension" || runtimeOptions.skipExtensionRuntimePrepare === true)
-    return;
-  const { releaseArtifactState, runtimeDistCheck } = await import("../adapters/extension/runtime-decision.js");
-  const artifact = releaseArtifactState(projectRoot);
-  const runtimeSnapshot = runtimeDistCheck(projectRoot, artifact);
-  if (artifact.status !== "none") {
-    if (artifact.status === "valid" && runtimeSnapshot.status === "fresh") return;
-    throw new Error(
-      "The loaded release artifact identity is invalid or stale. Next: rerun runtime-launch with the same artifact source."
-    );
-  }
-  const { prepareExtensionRuntime } = await import("../adapters/extension/runtime.js");
-  await prepareExtensionRuntime({
-    projectRoot,
-    cdpPort: runtimeOptions.cdpPort,
-    slot: runtimeOptions.slot,
-    launchExistingDist: runtimeOptions.launchExistingDist === true,
-    validationRuntimeDir: runtimeOptions.validationRuntimeDir,
-    pageMode: "home-or-sidepanel"
-  });
+  await getAdapterSurface(adapter).run?.prepareRuntime?.(projectRoot, runtimeOptions);
 }
 function restoreEnv(key, value) {
   if (value === void 0) delete process.env[key];
@@ -1051,7 +976,15 @@ async function prepareHeal(adapter, target, options, json, prepareOptions = {})
     return EXIT.usage;
   }
   const state = newHealState();
-  const mobileArtifact = adapter === "mobile" ? requireCurrentMobileReleaseArtifactState(target) : null;
+  const runtimeCheck = getAdapterSurface(adapter).run?.runtimeCheck?.({
+    target,
+    options,
+    heal,
+    state,
+    json,
+    appRestartAuthored: prepareOptions.appRestartAuthored,
+    onRecovery: (code) => prepareOptions.onPhase?.("recover", { code })
+  });
   prepareOptions.onPhase?.("install");
   const ensured = await ensureOverlay(
     adapter,
@@ -1089,41 +1022,8 @@ async function prepareHeal(adapter, target, options, json, prepareOptions = {})
     return EXIT.infra;
   }
   prepareOptions.onPhase?.("healthcheck");
-  if (adapter === "extension") {
-    const previousCdpPort = process.env.CDP_PORT;
-    const previousRecipeCdpPort = process.env.RECIPE_CDP_PORT;
-    const previousWatcherPort = process.env.WATCHER_PORT;
-    const explicitCdpPort = optionString(options, "cdpPort");
-    const explicitWatcherPort = optionString(options, "watcherPort") ?? optionString(options, "metroPort");
-    if (explicitCdpPort) {
-      process.env.CDP_PORT = explicitCdpPort;
-      process.env.RECIPE_CDP_PORT = explicitCdpPort;
-    }
-    if (explicitWatcherPort) process.env.WATCHER_PORT = explicitWatcherPort;
-    try {
-      const current = await ensureExtensionProofRuntime(
-        target,
-        heal,
-        state,
-        json,
-        {
-          onRecovery: (code) => prepareOptions.onPhase?.("recover", { code })
-        }
-      );
-      if (current !== null) return current;
-    } finally {
-      restoreEnv("CDP_PORT", previousCdpPort);
-      restoreEnv("RECIPE_CDP_PORT", previousRecipeCdpPort);
-      restoreEnv("WATCHER_PORT", previousWatcherPort);
-    }
-  }
-  if (adapter === "mobile" && mobileArtifact === null && prepareOptions.skipMobileSourceFreshness !== true) {
-    const current = await ensureMobileProofRuntime(
-      target,
-      heal,
-      state,
-      json
-    );
+  if (runtimeCheck) {
+    const current = await runtimeCheck();
     if (current !== null) return current;
   }
   return { state, heal };
@@ -1372,7 +1272,7 @@ async function executeWithHealBounds(exec, target, state) {
   };
 }
 function emitHealViolation(json, command, result, violation, state, adapter) {
-  const userAction = adapter === "core" && violation.code === "WALLET_STATE_REQUIRED" ? "for signing, configure a reserved wallet-fixture.json account and pass its non-empty name; an explicit 0x address is supported only by read-only actions" : violation.userAction ?? `inspect ${shellQuoteArg(result.summaryPath)} and ${shellQuoteArg(result.tracePath)}; fix the application or recipe failure before retrying`;
+  const userAction = (adapter ? getAdapterSurface(adapter).run?.violationUserAction?.(violation) : void 0) ?? violation.userAction ?? `inspect ${shellQuoteArg(result.summaryPath)} and ${shellQuoteArg(result.tracePath)}; fix the application or recipe failure before retrying`;
   if (json) {
     console.log(
       JSON.stringify(

package/dist/commands/run-report.js

@@ -1,8 +1,7 @@
 import fs from "node:fs";
-import { createRequire } from "node:module";
 import path from "node:path";
 import { execFileSync } from "node:child_process";
-import { recipeRuntimeDir } from "../paths.js";
+import { getAdapterSurface } from "../adapters/surface.js";
 import { isRecord } from "./parse-args.js";
 function writeRunReport(result) {
   const summaryPath = String(result.summaryPath);
@@ -95,33 +94,6 @@ function indexProductProvenanceArtifact(artifactManifestPath, target, adapter, b
 `
   );
 }
-function readRecord(file) {
-  try {
-    const recorded = JSON.parse(fs.readFileSync(file, "utf8"));
-    return isRecord(recorded) ? recorded : null;
-  } catch {
-    return null;
-  }
-}
-const browserCdp = createRequire(import.meta.url)("../../adapters/shared/browser-cdp.cjs");
-function verifyLaunch(record, cdpPort) {
-  const launch = isRecord(record.launch) ? record.launch : {};
-  const pid = Number(launch.pid);
-  const port = Number(launch.cdpPort);
-  if (!Number.isInteger(pid) || !Number.isInteger(port) || typeof launch.profile !== "string" || typeof launch.processStartedAt !== "string") {
-    return "the browser record has no process identity (pid, start time, profile, CDP port)";
-  }
-  if (cdpPort && port !== Number(cdpPort)) return `the browser record is for CDP port ${port}, not ${cdpPort}`;
-  try {
-    const owner = browserCdp.cdpOwner(port, launch.profile);
-    if (owner.pid !== pid || owner.startedAt !== launch.processStartedAt) {
-      return `CDP port ${port} is now held by another browser process than the recorded pid ${pid}`;
-    }
-  } catch (error) {
-    return error instanceof Error ? error.message : String(error);
-  }
-  return null;
-}
 function resolveTemplatedPort(value, params, recipe) {
   let resolved = value;
   const template = /^\{\{\s*params\.([\w-]+)\s*\}\}$/u.exec(String(value).trim());
@@ -155,26 +127,11 @@ function recipeCdpPorts(request) {
   return [...ports];
 }
 function executedBrowser(adapter, target, artifactManifestPath, ports) {
-  if (adapter !== "extension") return null;
+  const launched = getAdapterSurface(adapter).run?.launchedBrowser;
+  if (!launched) return null;
   if (ports.length === 0) return { boundTo: "none", reason: "the run had no known CDP port" };
   if (ports.length > 1) return { boundTo: "none", reason: `the run drove several CDP ports (${ports.join(", ")})` };
-  return launchedBrowser(target, path.dirname(artifactManifestPath), ports[0]);
-}
-function launchedBrowser(target, artifactsDir, cdpPort) {
-  const runtime = readRecord(path.join(artifactsDir, "extension-runtime", "runtime.json"));
-  const autolaunched = runtime && isRecord(runtime.browser) ? runtime.browser : null;
-  const candidates = [];
-  if (autolaunched) candidates.push([autolaunched, "run-autolaunch"]);
-  const slot = readRecord(path.join(path.resolve(target), recipeRuntimeDir(), "browser-resolution.json"));
-  if (slot) candidates.push([slot, "slot-runtime"]);
-  if (candidates.length === 0) return null;
-  const reasons = [];
-  for (const [record, boundTo] of candidates) {
-    const problem = verifyLaunch(record, cdpPort);
-    if (problem === null) return { ...record, boundTo };
-    reasons.push(`${boundTo}: ${problem}`);
-  }
-  return { boundTo: "none", reason: reasons.join("; ") };
+  return launched(target, path.dirname(artifactManifestPath), ports[0]);
 }
 function renderRunReport(summary, entries) {
   const lines = [
@@ -279,7 +236,6 @@ function indexRunReportArtifact(artifactManifestPath) {
 export {
   executedBrowser,
   indexProductProvenanceArtifact,
-  launchedBrowser,
   recipeCdpPorts,
   writeRunReport
 };

package/dist/commands/run.js

@@ -28,8 +28,6 @@ import {
 import { handleDescribeRecipe, handleListExecutables } from "./list-executables.js";
 import { applyDeviceTargeting } from "./device-target.js";
 import { getAdapterSurface } from "../adapters/surface.js";
-import { coreDependencyBlock } from "./core-readiness.js";
-import { readMobileReleaseArtifactState } from "../adapters/mobile/release-artifact-state.js";
 import {
   indexProductProvenanceArtifact,
   writeRunReport
@@ -244,7 +242,10 @@ async function handleRunInner({ positional, options }, stream) {
       actionLibraryContextArgs(validated.librarySources)
     );
   }
-  const depsBlock = adapter === "core" && await recipeUsesCoreController(validated.recipe, validated.librarySources) ? coreDependencyBlock(target) : null;
+  const depsBlock = await getAdapterSurface(adapter).run?.dependencyBlock?.(target, {
+    recipe: validated.recipe,
+    librarySources: validated.librarySources
+  }) ?? null;
   if (depsBlock) {
     return emitRunUsageError(jsonOutput, stream, adapter, validated.recipeFile, depsBlock.code, depsBlock.message, depsBlock.userAction);
   }
@@ -295,8 +296,7 @@ async function handleRunInner({ positional, options }, stream) {
   }
   try {
     const prepared = await prepareHeal(adapter, target, options, machine, {
-      onPhase: (phase, fields) => stream.phase(phase, fields),
-      skipMobileSourceFreshness: adapter === "mobile" && readMobileReleaseArtifactState(target) !== null
+      onPhase: (phase, fields) => stream.phase(phase, fields)
     });
     if (typeof prepared === "number") {
       stream.error({
@@ -511,48 +511,6 @@ function formatPreviewLine(line, out) {
   const rest = match[2];
   return `${out(status === "PASS" ? "ok" : "err", status)} ${rest}`;
 }
-async function recipeUsesCoreController(recipe, librarySources) {
-  if (objectUsesCoreController(recipe)) return true;
-  const refs = collectCallRefs(recipe);
-  if (refs.length === 0) return false;
-  const sources = librarySources ?? [];
-  if (sources.length === 0) return false;
-  const { loadRecipeLibraries } = await import("@farmslot/recipe-harness");
-  const recipes = (await loadRecipeLibraries(sources, { adapter: "core" })).recipes;
-  const visited = /* @__PURE__ */ new Set();
-  const visit = (ref) => {
-    if (visited.has(ref)) return false;
-    visited.add(ref);
-    const dependency = recipes.get(ref);
-    if (!dependency) return false;
-    if (objectUsesCoreController(dependency.document)) return true;
-    return collectCallRefs(dependency.document).some(visit);
-  };
-  return refs.some(visit);
-}
-function objectUsesCoreController(value) {
-  if (Array.isArray(value)) return value.some(objectUsesCoreController);
-  if (!isRecord(value)) return false;
-  if (actionUsesCoreController(value.action)) return true;
-  return Object.values(value).some(objectUsesCoreController);
-}
-function collectCallRefs(value) {
-  const refs = [];
-  const visit = (node) => {
-    if (Array.isArray(node)) {
-      for (const item of node) visit(item);
-      return;
-    }
-    if (!isRecord(node)) return;
-    if (node.action === "call" && typeof node.ref === "string" && node.ref) refs.push(node.ref);
-    for (const child of Object.values(node)) visit(child);
-  };
-  visit(value);
-  return [...new Set(refs)];
-}
-function actionUsesCoreController(action) {
-  return typeof action === "string" && action.startsWith("metamask.perps.");
-}
 async function handleRunPlan(recipeArg, params, options, stream) {
   const json = optionFlag(options, "json");
   const jsonOutput = json && !stream.enabled;
@@ -635,7 +593,7 @@ async function handleRunPlan(recipeArg, params, options, stream) {
       status: "planned",
       detail: "would auto-ensure the runtime overlay if missing (install phase)"
     },
-    ...adapter === "core" ? [] : [
+    ...getAdapterSurface(adapter).headless ? [] : [
       {
         step: "launch.app",
         confidence: "conditional",

package/dist/commands/runtime-decision.js

@@ -1,32 +1,16 @@
-import { decideExtensionReadiness } from "../adapters/extension/runtime-decision.js";
-import { decideMobileReadiness } from "../adapters/mobile/runtime-decision.js";
+import { getAdapterSurface } from "../adapters/surface.js";
 import {
   adapterOption,
   applyRuntimeDirOption,
   optionFlag,
-  optionString,
-  parsePort,
   targetPath
 } from "./parse-args.js";
 async function handleRuntimeDecision({ options }) {
   applyRuntimeDirOption(options);
   const adapter = adapterOption(options);
   const target = targetPath(options);
-  if (adapter === "mobile") {
-    const watcherPortRaw = optionString(options, "watcherPort") ?? process.env.WATCHER_PORT ?? process.env.METRO_PORT;
-    const watcherPort = watcherPortRaw === void 0 ? void 0 : parsePort(watcherPortRaw, "runtime-decision --watcher-port must be a port.");
-    const report2 = await decideMobileReadiness(target, {
-      watcherPort,
-      metroLog: optionString(options, "metroLog"),
-      platform: optionString(options, "platform") ?? process.env.PLATFORM ?? process.env.RECIPE_HARNESS_PLATFORM,
-      record: optionFlag(options, "record"),
-      preflightMode: optionString(options, "preflightMode")
-    });
-    if (optionFlag(options, "json")) console.log(JSON.stringify(report2, null, 2));
-    else console.log(`${report2.decision} ${report2.reasonCode} \u2014 ${report2.reasons[0] ?? ""}`);
-    return 0;
-  }
-  if (adapter !== "extension") {
+  const decide = getAdapterSurface(adapter).runtimeDecision;
+  if (!decide) {
     const report2 = {
       schemaVersion: 1,
       adapter,
@@ -42,15 +26,9 @@ async function handleRuntimeDecision({ options }) {
     else console.log(`unknown adapter-unsupported \u2014 ${report2.reasons[0]}`);
     return 0;
   }
-  const cdpPortRaw = optionString(options, "cdpPort") ?? process.env.CDP_PORT ?? process.env.RECIPE_CDP_PORT;
-  const cdpPort = cdpPortRaw === void 0 ? void 0 : parsePort(cdpPortRaw, "runtime-decision --cdp-port must be a port.");
-  const report = await decideExtensionReadiness(target, {
-    cdpPort,
-    watchLog: optionString(options, "watchLog"),
-    record: optionFlag(options, "record")
-  });
+  const { report, line } = await decide(target, options);
   if (optionFlag(options, "json")) console.log(JSON.stringify(report, null, 2));
-  else console.log(`${report.decision}${report.clean ? " (clean)" : ""} ${report.reasonCode} \u2014 ${report.reasons[0] ?? ""}`);
+  else console.log(line);
   return 0;
 }
 export {

package/dist/commands/self-test.js

@@ -25,9 +25,7 @@ async function runSelfTest(options) {
     for (const adapter of ["mobile", "extension"]) {
       const manifest = loadActionManifest(adapter);
       const manifestValidation = await validateManifest(manifest);
-      const smokeRecipe = recipePath(
-        adapter === "mobile" ? "mobile/runner/smoke.recipe.json" : "extension/runner/smoke.recipe.json"
-      );
+      const smokeRecipe = recipePath(`${adapter}/runner/smoke.recipe.json`);
       const artifactsDir = path.join(root, adapter);
       const result = await runRecipe(adapter, smokeRecipe, artifactsDir, runnerDir, void 0, {
         skipExtensionRuntimePrepare: true