@deeeed/metamask-harness 0.70.1 → 0.72.0

package/dist/commands/farmslot-ready.js

@@ -11,6 +11,8 @@ function farmslotReadyIndicator(adapter, devices) {
       return "OK";
     case "core":
       return "ready";
+    case "terminal":
+      return "OK";
     case "mobile": {
       const device = selectedDevice(devices);
       if (!device) return "";

package/dist/commands/help.js

@@ -4,9 +4,9 @@ import { color } from "../cli-color.js";
 import { detectAdapter } from "../harness.js";
 import { optionString, parseArgs, targetPath } from "./parse-args.js";
 import { handleHelpReview } from "./review.js";
-const UNSCOPED_NEXT = "cd into a MetaMask checkout or pass --adapter <mobile|extension|core>";
+const UNSCOPED_NEXT = "cd into a MetaMask checkout or pass --adapter <mobile|extension|core|terminal>";
 function validHelpLine(value) {
-  return typeof value === "string" || Boolean(value && typeof value.text === "string" && Array.isArray(value.adapters) && value.adapters.length > 0 && value.adapters.every((adapter) => ["mobile", "extension", "core"].includes(adapter)));
+  return typeof value === "string" || Boolean(value && typeof value.text === "string" && Array.isArray(value.adapters) && value.adapters.length > 0 && value.adapters.every((adapter) => ["mobile", "extension", "core", "terminal"].includes(adapter)));
 }
 function scopedSections(topic, adapter) {
   const select = (lines) => lines.flatMap((line) => typeof line === "string" ? [line] : line.adapters.includes(adapter) ? [line.text] : []);

package/dist/commands/launch/index.js

@@ -59,7 +59,10 @@ const LAUNCH_BOOLEANS = /* @__PURE__ */ new Set([
   "runway",
   "clearMetro",
   "json",
-  "jsonStream"
+  "jsonStream",
+  "freshProfile",
+  "headless",
+  "headful"
 ]);
 const DEFAULT_EXTENSION_DAPP_URL = "https://metamask.github.io/test-dapp/";
 function metroLaunchEvidence(adapter, target) {
@@ -117,6 +120,83 @@ async function handleLaunch(argv) {
     restoreStdout();
   }
 }
+const TERMINAL_ONLY_LAUNCH_OPTIONS = Object.freeze({
+  signer: "--signer",
+  account: "--account",
+  freshProfile: "--fresh-profile",
+  headless: "--headless",
+  headful: "--headful",
+  slowMo: "--slow-mo",
+  network: "--network",
+  mainnetConfirmation: "--mainnet-confirmation"
+});
+function terminalOnlyLaunchFlags(options) {
+  return Object.entries(TERMINAL_ONLY_LAUNCH_OPTIONS).filter(([key]) => options[key] !== void 0 && options[key] !== false).map(([, name]) => name);
+}
+function parseTerminalLauncherOutput(output) {
+  const text = output.trim();
+  if (!text) return { status: "fail", error: "the terminal launcher printed no summary" };
+  try {
+    return JSON.parse(text);
+  } catch {
+    const last = text.split("\n").filter((line) => line.trim()).pop() ?? "";
+    try {
+      return JSON.parse(last);
+    } catch {
+      return { status: "fail", error: `the terminal launcher printed no JSON summary: ${last.slice(0, 200)}` };
+    }
+  }
+}
+function launchTerminal(options, target, jsonOutput, stream) {
+  const cdpPort = str(options, "cdpPort") ?? process.env.RECIPE_CDP_PORT ?? process.env.CDP_PORT;
+  const appPort = str(options, "watcherPort") ?? process.env.TERMINAL_APP_PORT ?? process.env.RECIPE_WATCHER_PORT ?? process.env.WATCHER_PORT;
+  if (!cdpPort || !appPort) {
+    return launchUsage(
+      jsonOutput,
+      stream,
+      "terminal launch needs the slot browser CDP port and the slot dev-server port.",
+      "mm-harness launch --adapter terminal --cdp-port <port> --watcher-port <app port>"
+    );
+  }
+  const args = [
+    path.join(runnerDir, "adapters", "terminal", "launch.mjs"),
+    "--target",
+    target,
+    "--cdp-port",
+    cdpPort,
+    "--app-port",
+    appPort,
+    "--signer",
+    str(options, "signer") ?? process.env.TERMINAL_SIGNER ?? "extension",
+    "--account",
+    str(options, "account") ?? process.env.TERMINAL_ACCOUNT ?? "dev1",
+    "--json"
+  ];
+  if (flag(options, "freshProfile")) args.push("--fresh-profile");
+  if (flag(options, "headless")) args.push("--headless");
+  if (flag(options, "headful")) args.push("--headful");
+  const slowMo = str(options, "slowMo");
+  if (slowMo) args.push("--slow-mo", slowMo);
+  const network = str(options, "network");
+  if (network) args.push("--network", network);
+  const mainnetConfirmation = str(options, "mainnetConfirmation");
+  if (mainnetConfirmation) args.push("--mainnet-confirmation", mainnetConfirmation);
+  stream.phase("launch", { adapter: "terminal", cdpPort, appPort });
+  let output = "";
+  let status = 0;
+  try {
+    output = execFileSync(process.execPath, args, { encoding: "utf8", stdio: ["ignore", "pipe", "inherit"] });
+  } catch (error) {
+    status = 1;
+    output = String(error.stdout ?? "");
+  }
+  const result = parseTerminalLauncherOutput(output);
+  if (jsonOutput) console.log(JSON.stringify({ schemaVersion: 1, command: "launch", adapter: "terminal", target, ...result }, null, 2));
+  else if (result.status === "pass") console.log(`\u2713 terminal browser ${result.reused ? "reused" : "started"} on CDP ${result.cdpPort} (${result.signer}, ${result.account?.name})`);
+  else console.error(`\u2717 terminal launch failed: ${result.error ?? "unknown error"}`);
+  stream.complete(result.status === "pass" ? "pass" : "fail", status);
+  return result.status === "pass" ? 0 : 1;
+}
 async function handleLaunchLocked(argv, stream) {
   const { positional, options } = parseFlags(argv, LAUNCH_BOOLEANS);
   const json = flag(options, "json");
@@ -139,6 +219,18 @@ async function handleLaunchLocked(argv, stream) {
   if (adapter === "core") {
     return launchUsage(jsonOutput, stream, "core is headless; there is nothing to launch.", "mm-harness verify");
   }
+  if (adapter === "terminal") {
+    return launchTerminal(options, target, jsonOutput, stream);
+  }
+  const terminalOnly = terminalOnlyLaunchFlags(options);
+  if (terminalOnly.length > 0) {
+    return launchUsage(
+      jsonOutput,
+      stream,
+      `${terminalOnly.join(", ")} apply only to --adapter terminal; ${adapter} does not read them.`,
+      "drop the terminal flags, or pass --adapter terminal"
+    );
+  }
   if (adapter === "mobile" && !mobileTarget) {
     return launchUsage(
       jsonOutput,
@@ -943,5 +1035,8 @@ ${failure.originalError}` : "") + `
   return failure.exitCode;
 }
 export {
-  handleLaunch
+  TERMINAL_ONLY_LAUNCH_OPTIONS,
+  handleLaunch,
+  parseTerminalLauncherOutput,
+  terminalOnlyLaunchFlags
 };

package/dist/commands/manifest.js

@@ -18,7 +18,7 @@ import {
 import { metaMaskActionExecutionCapabilities } from "../recipe-security.js";
 import { closest } from "../command-contract.js";
 const OFFICIAL_ACTIONS = new Set(OFFICIAL_RECIPE_ACTIONS);
-const ACTION_MATRIX_ADAPTERS = ["mobile", "extension", "core"];
+const ACTION_MATRIX_ADAPTERS = ["mobile", "extension", "core", "terminal"];
 function actionLibraryContextArgs(librarySources) {
   return (librarySources ?? []).filter((source) => source.name !== "metamask").map((source) => {
     const entry = source.name ? `${source.name}=${source.root}` : source.root;
@@ -309,9 +309,9 @@ function renderHumanActionMatrix(actions) {
   return [
     out("bold", "action capability matrix"),
     out("comment", "Inspect one: mm-harness actions --matrix --action <name> --json"),
-    `${"action capability".padEnd(width)}  mobile  extension  core`,
+    `${"action capability".padEnd(width)}  mobile  extension  core  terminal`,
     ...actions.map(
-      (action) => `${action.name.padEnd(width)}  ${cell(action.support.mobile, 6)}  ${cell(action.support.extension, 9)}  ${cell(action.support.core, 4)}`
+      (action) => `${action.name.padEnd(width)}  ${cell(action.support.mobile, 6)}  ${cell(action.support.extension, 9)}  ${cell(action.support.core, 4)}  ${cell(action.support.terminal, 8)}`
     )
   ].join("\n");
 }

package/dist/commands/recipe-advice.js

@@ -29,7 +29,7 @@ async function runRecipeAdvice(options, mode) {
   const adapter = optionString(options, "adapter");
   const output = optionString(options, "output");
   const evidence = optionString(options, "evidence");
-  if (mode === "review" && !recipe || !task || !["mobile", "extension", "core"].includes(adapter ?? "")) {
+  if (mode === "review" && !recipe || !task || !["mobile", "extension", "core", "terminal"].includes(adapter ?? "")) {
     throw usageError("Use recipe-quality plan --task <task.json>, or advise --recipe <recipe.json> --task <TASK.md>, with --adapter <adapter> [--advisor <provider>].");
   }
   if (mode === "plan" && (recipe || evidence || optionString(options, "params"))) throw usageError("Planning runs before a recipe exists. Next: use advise to review a draft or evidence.");

package/dist/commands/review.js

@@ -27,7 +27,7 @@ function harnessVersion() {
 function adapterFromOptions(options, target) {
   const raw = optionString(options, "adapter") ?? optionString(options, "platform");
   if (raw !== void 0) {
-    if (raw !== "mobile" && raw !== "extension" && raw !== "core") throw usageError(`--adapter must be mobile, extension, or core (got ${raw}).`);
+    if (raw !== "mobile" && raw !== "extension" && raw !== "core" && raw !== "terminal") throw usageError(`--adapter must be mobile, extension, core, or terminal (got ${raw}).`);
     return raw;
   }
   return detectAdapter(target) ?? "unscoped";

package/dist/commands/run-engine.js

@@ -150,7 +150,7 @@ async function runRecipe(adapter, recipe, artifactsDir, projectRoot, actionManif
     if (executionError !== void 0) throw executionError;
     if (recordingError !== void 0) throw recordingError;
     if (!result) throw new Error("Recipe execution returned no result.");
-    const finalized = finishRunDiagnostics(diagnosticBaseline, result);
+    const finalized = await finishRunDiagnostics(diagnosticBaseline, result);
     persistRunEffects(
       finalized.summaryPath,
       finalized.artifactManifestPath,

package/dist/commands/shared.js

@@ -59,7 +59,7 @@ function flag(options, key) {
 function targetOf(options) {
   return path.resolve(str(options, "target") ?? process.cwd());
 }
-const ADAPTER_TOKENS = ["mobile", "extension", "core"];
+const ADAPTER_TOKENS = ["mobile", "extension", "core", "terminal"];
 function resolveAdapter(options, target, hint) {
   const platform = str(options, "platform");
   const explicit = str(options, "adapter") ?? (platform === "ios" || platform === "android" ? "mobile" : platform);

package/dist/doctor.js

@@ -45,6 +45,9 @@ function compatibilityMode(adapter, target) {
   if (adapter === "core") {
     return fs.existsSync(path.join(target, "packages/perps-controller/src/index.ts")) ? "headless controller (no bridge)" : "unsupported/no bridge";
   }
+  if (adapter === "terminal") {
+    return fs.existsSync(path.join(target, "src/features/perpetuals")) ? "slot browser over CDP (website; no product bridge)" : "unsupported/no bridge";
+  }
   if (adapter === "mobile") {
     if (shape.injectedHarness && shape.agenticService) return "runner bridge with injected app bridge";
     if (shape.agenticService) return "runner bridge with app bridge";

package/dist/harness.js

@@ -7,11 +7,11 @@ import { resolveExtensionSlotPorts } from "./adapters/slot-ports.js";
 import { recipeHarnessPath, recipeRuntimeDir, runnerDir } from "./paths.js";
 import { colorHumanMessage } from "./cli-color.js";
 const HARNESS_ACTIONS = ["install", "verify", "cleanup"];
-const ADAPTERS = ["mobile", "extension", "core"];
+const ADAPTERS = ["mobile", "extension", "core", "terminal"];
 function harnessUsage() {
   console.error(`mm-harness \u2014 install and validate the MetaMask recipe runtime in a checkout.
 
-Run it from inside a MetaMask checkout; the platform (mobile | extension | core)
+Run it from inside a MetaMask checkout; the platform (mobile | extension | core | terminal)
 is auto-detected from the repo. Pass --platform only to override.
 
 Commands (one copy-pasteable example each):
@@ -23,7 +23,7 @@ Commands (one copy-pasteable example each):
               mm-harness cleanup
 
 Options:
-  --platform <mobile|extension|core>   Override auto-detection (alias: --adapter).
+  --platform <mobile|extension|core|terminal>   Override auto-detection (alias: --adapter).
   --target <repo>                      Checkout to operate on (default: current dir).
   --json                               Machine-readable summary for agents/scripts.
   -- <args>                            Forward the rest verbatim to the underlying
@@ -67,7 +67,7 @@ function shellQuote(value) {
   return /^[A-Za-z0-9_./:=@+-]+$/u.test(value) ? value : `'${value.replace(/'/gu, `'\\''`)}'`;
 }
 function isAdapter(value) {
-  return value === "mobile" || value === "extension" || value === "core";
+  return value === "mobile" || value === "extension" || value === "core" || value === "terminal";
 }
 function parseHarnessArgs(args) {
   const forward = [];
@@ -125,7 +125,7 @@ function parseHarnessArgs(args) {
   }
   return { adapter, json, quiet, forward };
 }
-const ADAPTER_DETECT_NEXT = "cd into a MetaMask checkout or pass --target <path>, or force it with --adapter <mobile|extension|core>";
+const ADAPTER_DETECT_NEXT = "cd into a MetaMask checkout or pass --target <path>, or force it with --adapter <mobile|extension|core|terminal>";
 function detectAdapter(target) {
   let remote = "";
   try {
@@ -149,6 +149,7 @@ function detectAdapter(target) {
   if (exists("development/skills-sync.ts") || isDir("ui") && isDir("app/scripts")) return "extension";
   if (exists("scripts/skills-sync.mts") || isDir("ios") && isDir("android") && isDir("app/core")) return "mobile";
   if (isDir("packages/perps-controller") && exists("yarn.lock")) return "core";
+  if (remote.includes("va-mmcx-terminal") || isDir("src/features/perpetuals") && (exists("next.config.ts") || exists("next.config.mjs") || exists("next.config.js"))) return "terminal";
   return void 0;
 }
 function resolveRuntimeContextPath(target) {
@@ -227,29 +228,34 @@ function isExecutable(file) {
 const INJECT_CANDIDATES = {
   mobile: { entry: "adapters/mobile/inject.sh", fallback: "scripts/inject-mobile-harness.sh" },
   extension: { entry: "adapters/extension/inject.mjs", fallback: "scripts/inject-extension-harness.mjs" },
-  core: { entry: "adapters/core/inject.sh", fallback: "scripts/inject-core-harness.sh" }
+  core: { entry: "adapters/core/inject.sh", fallback: "scripts/inject-core-harness.sh" },
+  terminal: { entry: "adapters/terminal/inject.mjs", fallback: "adapters/terminal/inject.mjs" }
 };
 const CLEANUP_CANDIDATES = {
   mobile: { entry: "adapters/mobile/cleanup.sh", fallback: "scripts/cleanup-mobile-harness.sh" },
   extension: { entry: "adapters/extension/cleanup.mjs", fallback: "scripts/cleanup-extension-harness.mjs" },
-  core: { entry: "adapters/core/cleanup.sh", fallback: "scripts/cleanup-core-harness.sh" }
+  core: { entry: "adapters/core/cleanup.sh", fallback: "scripts/cleanup-core-harness.sh" },
+  terminal: { entry: "adapters/terminal/cleanup.mjs", fallback: "adapters/terminal/cleanup.mjs" }
 };
 function resolveHarnessDispatch(adapter, action, target) {
   if (action === "install") {
     const { entry, fallback } = INJECT_CANDIDATES[adapter];
-    if (adapter === "extension") {
+    if (adapter === "extension" || adapter === "terminal") {
       return { command: process.execPath, prefixArgs: [resolveEntry(runnerDir, [entry, fallback], "file")] };
     }
     return { command: resolveEntry(runnerDir, [entry, fallback], "file"), prefixArgs: [] };
   }
   if (action === "cleanup") {
     const { entry, fallback } = CLEANUP_CANDIDATES[adapter];
-    const base = installedRunnerSource(target, adapter) ?? runnerDir;
-    if (adapter === "extension") {
+    const base = adapter === "terminal" ? runnerDir : installedRunnerSource(target, adapter) ?? runnerDir;
+    if (adapter === "extension" || adapter === "terminal") {
       return { command: process.execPath, prefixArgs: [resolveEntry(base, [entry, fallback], "file")] };
     }
     return { command: resolveEntry(base, [entry, fallback], "file"), prefixArgs: [] };
   }
+  if (adapter === "terminal" && action === "verify") {
+    return { command: process.execPath, prefixArgs: [path.join(runnerDir, "adapters", "terminal", "verify.mjs")] };
+  }
   if (adapter === "core" && action === "verify") {
     const delegate = path.join(recipeHarnessPath(target, "core"), "runner", "bin", "mm-harness");
     if (!isExecutable(delegate)) {
@@ -282,7 +288,7 @@ async function handleHarness(argv) {
     if (quiet) {
       return 2;
     } else if (json) {
-      const detectError = adapter ? { code: "UNSUPPORTED_PLATFORM", message: `unsupported platform: ${adapter}`, userAction: "pass --adapter <mobile|extension|core> to specify a supported adapter" } : { code: "ADAPTER_DETECTION_FAILED", message: `could not detect the MetaMask repo type for ${target}`, userAction: ADAPTER_DETECT_NEXT };
+      const detectError = adapter ? { code: "UNSUPPORTED_PLATFORM", message: `unsupported platform: ${adapter}`, userAction: "pass --adapter <mobile|extension|core|terminal> to specify a supported adapter" } : { code: "ADAPTER_DETECTION_FAILED", message: `could not detect the MetaMask repo type for ${target}`, userAction: ADAPTER_DETECT_NEXT };
       console.log(harnessSummary(harnessAction, void 0, target, "fail", 2, false, detectError));
     } else {
       harnessUsage();

package/dist/manifest.js

@@ -11,10 +11,14 @@ 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)));
   if (adapter === "mobile") return loadMetaMaskMobileActionManifest();
   if (adapter === "core") return loadMetaMaskCoreActionManifest();
+  if (adapter === "terminal") return loadMetaMaskTerminalActionManifest();
   return loadMetaMaskExtensionActionManifest();
 }
 async function resolveActionManifest(adapter, overridePath, librarySources, taskActionRoot) {
@@ -165,6 +169,7 @@ export {
   loadMetaMaskCoreActionManifest,
   loadMetaMaskExtensionActionManifest,
   loadMetaMaskMobileActionManifest,
+  loadMetaMaskTerminalActionManifest,
   resolveActionManifest,
   validateManifest
 };

package/dist/mm-harness-cli.js

@@ -32,7 +32,7 @@ const REAL = [
 
   Loads the complete recipe guide shipped with this harness.
 
-  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
+  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Load the same guide as structured agent context
 
@@ -121,7 +121,7 @@ Example:
     helpText: `mm-harness config <list|path|get <key>|set <key> <value>|unset <key>> [--json]
 
   Stored outside every repo in ~/.mm-harness/config.json (override: MM_HARNESS_CONFIG).
-  Keys: libraries.<name> (team library checkout), references.<mobile|extension|core>
+  Keys: libraries.<name> (team library checkout), references.<mobile|extension|core|terminal>
   (the checkout used as the parity reference), advisor.enabled (true/false),
   advisor.provider, advisor.model, advisor.stages (plan,draft,evidence). Advisor
   settings contain no credentials and default to disabled with planning only.
@@ -267,7 +267,7 @@ Example:
   refuses with the numbered choice when that is ambiguous.
 
   --target <path>                    Checkout path (default: cwd)
-  --platform <mobile|extension|core> Force the platform (auto-detected inside a checkout)
+  --platform <mobile|extension|core|terminal> Force the platform (auto-detected inside a checkout)
   --mobile-platform <ios|android>    Mobile target when status cannot decide it
   --clear-metro                      Mobile only: clear Metro's transform cache in the launch step
   --artifacts-dir <dir>              Where sandbox.json and the per-step reports land
@@ -378,10 +378,10 @@ Materialize:
 
   query                              Search names, categories, fields, and descriptions (typo-tolerant)
   --action <name>                    Describe one action; fuzzy-resolves like call (short or full name)
-  --matrix                           Compare action availability across Mobile, Extension, and Core
+  --matrix                           Compare action availability across Mobile, Extension, Core, and Terminal
   --categories                       List compact action categories and counts
   --category <name>                  List only one category (for example ui, wallet, or perps)
-  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
+  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --raw                              Dump raw action registry JSON
   --json                             Machine-readable output
@@ -409,7 +409,7 @@ Example:
     core       headless \u2014 no dev server to stop (teaching error)
 
   --port <port>                      Metro/webpack port override; Extension CDP remains checkout-context scoped
-  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
+  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Machine-readable output
 
@@ -437,7 +437,7 @@ Example:
   --arg k=v                          Action field value (repeatable; equivalent to key=value shorthand)
   --device <udid|serial|name>        Mobile only: target this device (sets IOS_SIMULATOR / ADB_SERIAL and updates agentic-runtime.json). Without it, >1 connected mobile device fails fast and lists them. Do not shut down other devices to force selection.
   --cdp-port <port>                  Extension only: bind the action to this live browser runtime.
-  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
+  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --artifacts-dir <dir>              Where to write evidence (default: temp dir)
   --action-manifest <path>           Override the action manifest
@@ -477,7 +477,7 @@ Discovery:
 
 Common overrides:
   --device <udid|serial|name>        Mobile only: target this device (sets IOS_SIMULATOR / ADB_SERIAL and updates agentic-runtime.json). Without it, >1 connected mobile device fails fast and lists them. Do not shut down other devices to force selection.
-  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
+  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
   --platform <ios|android>           Mobile platform preference; use --adapter for the product adapter
   --target <path>                    Checkout path (default: cwd)
   --artifacts-dir <dir>              Override evidence output (default: active task/artifacts, otherwise a checkout-local temp/recipe/runs/<run>)
@@ -490,7 +490,7 @@ Common overrides:
   --json                             Machine-readable output
   --json-stream                      Line-flushed JSONL progress + terminal event
   --record-video=full-run            Record a video of the run
-  --hud <auto|show|hide>             Recipe HUD policy (auto shows normal Mobile recipes; hide is explicit)
+  --hud <auto|show|hide>             Recipe HUD policy (auto shows normal Mobile recipes and a headful terminal browser; hide is explicit)
 
 Advanced integrations:
   runtime: --cdp-port, --watcher-port/--metro-port, --runtime-dir, --slot,
@@ -537,7 +537,7 @@ Example:
   --cdp-port <port>                  Extension CDP port for the liveness probe (env: CDP_PORT / RECIPE_CDP_PORT)
   --device <udid|serial|name>        Mobile only: target this device (env: IOS_SIMULATOR / ADB_SERIAL). doctor reports the connected devices; it never gates on ambiguity.
   --all-devices                      Mobile only: show every connected device instead of the slot-scoped target
-  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
+  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --runtime-dir <dir>                Runtime dir containing agentic-runtime.json (relative to target)
   --json                             Machine-readable output (incompatible with --print-ready)
@@ -559,7 +559,7 @@ Example:
   when available. Does not launch an app or run a recipe.
 
   --target <path>                    Checkout path (default: cwd)
-  --adapter <mobile|extension|core>  Adapter label (auto-detected when possible)
+  --adapter <mobile|extension|core|terminal>  Adapter label (auto-detected when possible)
   --base <ref>                       Diff base (default: PR base, then remote HEAD, then repo fallback)
   --profile <fast|full>              Validation depth (default: fast)
   --fix                              Fix changed files, then validate them
@@ -596,11 +596,11 @@ Example:
 Optional advice:
   advisor-status --json
     Resolve saved settings and overrides without reading tasks or calling a model.
-  plan --task <task.json> --adapter <mobile|extension|core> --advisor typesafe
+  plan --task <task.json> --adapter <mobile|extension|core|terminal> --advisor typesafe
     Assess each acceptance criterion before a recipe exists. Task JSON contains
     acceptanceCriteria: ["criterion", "..."] (1\u201320 entries), with optional title/description.
     Returns known candidate refs for reuse/composition, or an explicit discovery gap.
-  advise --recipe <recipe.json> --task <TASK.md> --adapter <mobile|extension|core>
+  advise --recipe <recipe.json> --task <TASK.md> --adapter <mobile|extension|core|terminal>
     --advisor <provider|off> Override saved policy for this task (currently: typesafe)
     --advisor-model <model> Override the provider default model or alias
     --advisor-stages <csv>   Select plan,draft,evidence (saved/default: plan)
@@ -635,7 +635,7 @@ Example:
   provisioning path only: artifact cache + simulator create + simctl install.
   JavaScript dependencies and Metro remain dispatch-time launch concerns.
 
-  --adapter <mobile|extension|core>  Target adapter (mobile supported; extension/core teach)
+  --adapter <mobile|extension|core|terminal>  Target adapter (mobile supported; extension/core/terminal teach)
   --target <path>                    Slot checkout path (default: cwd)
   --platform <ios>                   Platform (default ios)
   --simulator <name|udid>            Override agentic-runtime.json simulator (alias: --device)
@@ -669,7 +669,7 @@ Example:
   artifact cache + simulator create + simctl install. JavaScript dependencies
   and Metro remain dispatch-time launch concerns.
 
-  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
+  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --runway                           Thin mobile Runway artifact install instead of overlay install
   --platform <ios>                   Runway platform (default ios)
@@ -698,7 +698,7 @@ Example:
   Extension live checks infer the checkout CDP port from runtime context,
   pool, or slot suffix when --cdp-port is omitted.
 
-  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
+  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Machine-readable output
 
@@ -714,7 +714,7 @@ Example:
 
   Remove the installed overlay and restore the checkout.
 
-  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
+  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
 
 Example:
@@ -730,6 +730,7 @@ Example:
   Launch the app \u2014 quick relaunch by default; --build for a full native/webpack build.
   Mobile: target is MANDATORY (ios | android). Extension: no target (--fullscreen default;
   --sidepanel to override). core is headless (teaching error \u2014 use verify/run).
+  Terminal: starts or reuses the slot browser (visible by default) against the slot dev server.
   Extension quick launch REUSES a healthy live runtime (reload in place, no rebuild);
   --build is the escape hatch that always clean-builds + relaunches a fresh runtime.
 
@@ -750,7 +751,19 @@ Example:
   --device <udid|name>               Target simulator/device (env: IOS_SIMULATOR / ADB_SERIAL)
   --cdp-port <port>                  Extension CDP port (env: CDP_PORT / RECIPE_CDP_PORT)
   --watcher-port <port>              Metro/webpack port (env: WATCHER_PORT / METRO_PORT)
-  --adapter <mobile|extension>       Target adapter (auto-detected inside a checkout)
+  --signer <extension|injected>      Terminal: MetaMask extension (default) or the injected test wallet
+  --account <name>                   Terminal: wallet-fixture account (default dev1)
+  --fresh-profile                    Terminal: start from a new browser profile
+  --headless                         Terminal: hide the browser (env: TERMINAL_HEADLESS=1); default is a
+                                     visible window placed per slot (--headful is accepted as the default)
+  --slow-mo <ms>                     Terminal: pause before each UI action (env: TERMINAL_SLOW_MO; default 0)
+  --network <testnet|mainnet>         Terminal: venue the slot dev server serves (default testnet)
+  --mainnet-confirmation <REAL_FUNDS> Terminal: required with --network mainnet (real funds)
+                                     Terminal flags are rejected for other adapters. The terminal launch
+                                     refuses unless the farm next dev server on --watcher-port forces
+                                     Hyperliquid testnet, or --network mainnet --mainnet-confirmation REAL_FUNDS
+                                     is passed (a recipe launch node carries network/mainnet_confirmation).
+  --adapter <mobile|extension|terminal> Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Machine-readable summary (recovered[] / mutations[] / phase)
   --json-stream                      Line-flushed JSONL progress + terminal event
@@ -777,7 +790,7 @@ Example:
   --source <label>                   Log source per adapter \u2014 mobile: metro|app;
                                      extension: extension|dapp|webpack|watcher|rebuild.
                                      Core is headless (teaching error).
-  --adapter <mobile|extension|core>  Target adapter (auto-detected inside a checkout)
+  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Machine-readable output
 
@@ -981,6 +994,7 @@ function adapterFromRuntimeContext(ctx) {
   if (raw === "mobile" || raw === "ios" || raw === "android") return "mobile";
   if (raw === "extension" || raw === "chrome-extension") return "extension";
   if (raw === "core") return "core";
+  if (raw === "terminal") return "terminal";
   return void 0;
 }
 function detectedSlotLine(out) {
@@ -1010,7 +1024,7 @@ function groupedHelp() {
   const out = (style, text) => color(style, text, { stream: process.stdout });
   const lines = [];
   lines.push(`${out("bold", "mm-harness")} \u2014 one front door for the MetaMask recipe loop: launch the app, prove behavior, manage the runtime overlay.`);
-  lines.push("Run it from inside a MetaMask checkout; the platform (mobile | extension | core) is auto-detected.");
+  lines.push("Run it from inside a MetaMask checkout; the platform (mobile | extension | core | terminal) is auto-detected.");
   lines.push(`Grammar: ${out("cmd", "mm-harness <command> [target] [flags]")}   (target is a positional: ios | android; flags add agent depth; --json is the agent contract)`);
   if (process.env.MM_HARNESS_BIN) {
     lines.push("");

package/dist/paths.js

@@ -88,8 +88,8 @@ function isProtocolRoot(candidate) {
   return fs.existsSync(path.join(candidate, "packages/recipe-harness/package.json")) && fs.existsSync(path.join(candidate, "packages/protocol/package.json"));
 }
 function assertAdapter(adapter) {
-  if (adapter !== "mobile" && adapter !== "extension" && adapter !== "core") {
-    throw new Error("Adapter must be mobile, extension, or core.");
+  if (adapter !== "mobile" && adapter !== "extension" && adapter !== "core" && adapter !== "terminal") {
+    throw new Error("Adapter must be mobile, extension, core, or terminal.");
   }
 }
 function manifestPath(adapter) {

package/dist/recipe-security.js

@@ -27,7 +27,12 @@ const READ_ONLY_CUSTOM_ACTIONS = /* @__PURE__ */ new Set([
   // Collector reads are host-only; starting capture remains arbitrary-code
   // because it spawns an HTTP listener.
   "metamask.analytics.read_events",
-  "metamask.analytics.assert_events"
+  "metamask.analytics.assert_events",
+  // Terminal wallet request log reads.
+  "metamask.wallet.read_signatures",
+  "metamask.wallet.assert_signatures",
+  // Terminal console capture read.
+  "metamask.app.assert_no_console_errors"
 ]);
 const APP_MUTATION_CUSTOM_ACTIONS = /* @__PURE__ */ new Set([
   "metamask.assets.verify_sorting",
@@ -72,7 +77,10 @@ const APP_MUTATION_CUSTOM_ACTIONS = /* @__PURE__ */ new Set([
   "metamask.perps.start_state",
   "metamask.perps.teardown_state",
   // Consent changes wallet state and is therefore an app mutation.
-  "metamask.analytics.set_consent"
+  "metamask.analytics.set_consent",
+  // Terminal slot browser lifecycle and venue agent revocation.
+  "metamask.app.launch",
+  "metamask.perps.revoke_agent"
 ]);
 const EXTERNAL_MUTATION_CUSTOM_ACTIONS = /* @__PURE__ */ new Set([
   "metamask.swap_bridge.submit_transaction",
@@ -82,7 +90,8 @@ const EXTERNAL_MUTATION_CUSTOM_ACTIONS = /* @__PURE__ */ new Set([
   "metamask.perps.close_visible_position",
   "metamask.perps.edit_margin",
   "metamask.perps.edit_order",
-  "metamask.perps.update_position_tpsl"
+  "metamask.perps.update_position_tpsl",
+  "metamask.perps.revoke_agent"
 ]);
 function metaMaskActionExecutionCapabilities(action) {
   const capabilities = [];

package/dist/review/knowledge.js

@@ -4,7 +4,7 @@ import os from "node:os";
 import path from "node:path";
 import { detectAdapter } from "../harness.js";
 import { usageError } from "../commands/parse-args.js";
-const REVIEW_ADAPTERS = ["mobile", "extension", "core"];
+const REVIEW_ADAPTERS = ["mobile", "extension", "core", "terminal"];
 const ADVISOR_STAGES = ["plan", "draft", "evidence"];
 function parseAdvisorSettings(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) throw usageError("advisor settings must be an object. Next: use mm-harness config set advisor.enabled false.");