@deeeed/metamask-harness 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.14.0 - 2026-07-08
+
+### Added
+- `mm-harness call` accepts action fields as direct `key=value` shorthand in addition to repeated `--arg k=v`, so commands like `mm-harness call ui.navigate page=perps` now match the examples agents naturally write.
+- Packaged recipes are grouped by domain under `library/recipes/<domain>/` and still resolve by dotted names (`perps.smoke`, `runner.smoke`) with legacy aliases for the former flat names.
+- Packaged `perps.smoke` recipes for mobile, extension, and core provide an explicit non-mutating Perps domain smoke. The existing bare `smoke` alias remains a runner/transport smoke for compatibility.
+
+### Fixed
+- `status` now hydrates slot runtime context before device enumeration, so a Farmslot checkout pinned to `IOS_SIMULATOR=mm-1` reports only the selected slot simulator instead of every booted simulator/device on the machine. Live status also updates `Next:` to `mm-harness logs` when the selected bridge is reachable.
+- The tmux Metro window opened by `launch ios|android` now streams the Metro output it writes to `metro.log` instead of opening a blank server window.
+- `log-tui watch` now matches success/failure patterns only against log content emitted after the watcher starts, so stale markers already present in long-lived Metro/webpack logs cannot false-pass readiness checks.
+- `start-metro` now reaps any existing mobile console-forwarder attached to the same Metro port before spawning this slot's forwarder, even when the old process was launched from another checkout or package install path.
+
 ## 0.13.0 - 2026-07-08
 
 ### Added
@@ -29,7 +42,7 @@
 ### Added
 - Mobile recipes can now use the standard outer `app.lifecycle` action for deterministic performance start states without rebuilding (Android background/foreground/terminate/restart, iOS simulator launch/terminate/restart through the shared Farmslot lifecycle adapter).
 - `fixtures set --device <serial|udid|name>` now pins mobile fixture sync to the requested device using the same targeting rules as `run`, `call`, and `doctor`.
-- New lifecycle-controlled measured flows in the packaged library: `app-lifecycle-android-smoke`, `perps-performance-warm-start`, `perps-performance-background-resume`, `perps-performance-cold-start`; performance recipes now keep lifecycle/unlock in `setup[]`/`startState` so measured nodes carry only CUF timings.
+- New lifecycle-controlled measured flows in the packaged library: `app.lifecycle.android-smoke`, `perps.performance.warm-start`, `perps.performance.background-resume`, `perps.performance.cold-start`; performance recipes now keep lifecycle/unlock in `setup[]`/`startState` so measured nodes carry only CUF timings.
 
 ### Changed
 - `@farmslot/recipe-harness` dependency raised to `^0.4.0` (ships the `app.lifecycle` adapter — the `FARMSLOT_ROOT` local-source fallback is no longer needed at runtime).
@@ -46,9 +59,9 @@
 ## 0.10.0 - 2026-07-07
 
 ### Added
-- **Canonical `perps-performance` measured flow** (`library/recipes/perps-performance.mobile.recipe.json`): unlock → open the Perps market list → read live state → open a market detail — one node per user-visible step with stable node names, so the per-node `duration`s in `trace.json` are the timings you monitor. Run pinned: `mm-harness run perps-performance --device <serial> --heal off`. Device-proven end-to-end on a physical Pixel.
+- **Canonical `perps.performance` measured flow** (`library/recipes/perps/performance.mobile.recipe.json`): unlock → open the Perps market list → read live state → open a market detail — one node per user-visible step with stable node names, so the per-node `duration`s in `trace.json` are the timings you monitor. Run pinned: `mm-harness run perps.performance --device <serial> --heal off`. Device-proven end-to-end on a physical Pixel.
 - **`run <name>` resolves personal/team recipe libraries.** Previously only the packaged library was probed by name; custom recipes ran by path. Sources resolve in library-precedence order (personal > team shadow the packaged canonical — a same-named personal recipe wins), path-shaped args never probe libraries, and a miss teaches which sources were searched. Zero-flag default: `$FARMSLOT_HOME/recipe-library`.
-- **Custom-library walkthrough** ("Your own measured flow" in `docs/recipe-libraries.md`): a peer engineer scaffolds a personal library, copies the canonical flow, retargets the nodes to their journey, and runs it by name. Every step is executed by the `perps-performance-recipe` contract test, so the doc cannot drift from reality.
+- **Custom-library walkthrough** ("Your own measured flow" in `docs/recipe-libraries.md`): a peer engineer scaffolds a personal library, copies the canonical flow, retargets the nodes to their journey, and runs it by name. Every step is executed by the `perps.performance-recipe` contract test, so the doc cannot drift from reality.
 - **`call` declared on mobile and extension manifests** (was core-only) with self-discovery metadata — personal `flows/` segments are now usable from mobile/extension recipes. Honest limitation documented: flows carry no adapter dimension in the protocol yet, so a cross-adapter `call` fails at live-run rather than plan time.
 
 ### Fixed
@@ -71,7 +84,7 @@
 ## 0.8.0 - 2026-07-07
 
 ### Added
-- **`run <name>` — the recipe positional resolves packaged-library recipe names.** An existing file path (absolute or cwd-relative) wins; otherwise the arg is a library recipe name, adapter-scoped first (`run smoke` on mobile → `smoke.mobile.recipe.json`), then adapterless (`run perps-lifecycle`), then the exact library filename. A miss teaches `RECIPE_NOT_FOUND` naming the library recipes available for the adapter — no more `$LIB`-style path prefixes in docs or demo scripts. A directory shadowing a library name never wins, and path-shaped args (containing a separator) never fall through to the library.
+- **`run <name>` — the recipe positional resolves packaged-library recipe names.** An existing file path (absolute or cwd-relative) wins; otherwise the arg is a library recipe name, adapter-scoped first (`run smoke` on mobile → `library/recipes/runner/smoke.mobile.recipe.json`), then adapterless (`run perps.lifecycle` → `library/recipes/perps/lifecycle.recipe.json`), then the exact library filename. A miss teaches `RECIPE_NOT_FOUND` naming the library recipes available for the adapter — no more `$LIB`-style path prefixes in docs or demo scripts. A directory shadowing a library name never wins, and path-shaped args (containing a separator) never fall through to the library.
 - **`--device <udid|serial|name>` — first-class mobile device targeting on `run`, `call`, and `doctor`.** Resolves against connected devices (adb + booted simulators; exact id first, then exact name with an ambiguity teaching error) and sets the same env `launch --device` does. Mobile `run`/`call` **without** `--device` while more than one targetable device is connected (across android + ios; android state `device`, iOS `Booted`) fail fast listing the devices and the `--device` hint, so a recipe never lands on the wrong device silently. `run --plan`/`--list` are exempt; extension/core teach. Errors honor `--json` with structured envelopes.
 - **`status` gains `devices[]`** (additive): `{platform, id, name, state, selected}` for connected android devices and booted iOS simulators on mobile checkouts — the `yarn a:status` successor; `selected` reflects the current env pinning.
 

package/adapters/extension/verify.sh

@@ -88,7 +88,7 @@ RUNNER_BIN="$HARNESS_DIR/runner/bin/mm-harness"
 # --out (optional): a task-local recipes dir. Resolve it safely within the target
 # (resolve_harness_out rejects absolute/.. escapes) and prefer its smoke recipe so
 # `live --out <dir>` does not silently fall back to the installed default.
-SMOKE_RECIPE="$HARNESS_DIR/runner/recipes/smoke.extension.recipe.json"
+SMOKE_RECIPE="$HARNESS_DIR/runner/recipes/runner/smoke.extension.recipe.json"
 if [ -n "$OUT" ]; then
   # Fail fast on a task-local --out that does not contain the requested recipe.
   # Silently falling back to the installed default would validate a different
@@ -98,11 +98,11 @@ if [ -n "$OUT" ]; then
     echo "extension verify: --out '$OUT' did not resolve to a safe path under the target." >&2
     exit 2
   fi
-  if [ ! -f "$OUT_ABS/smoke.extension.recipe.json" ]; then
-    echo "extension verify: --out '$OUT' (resolved: $OUT_ABS) has no smoke.extension.recipe.json. Refusing to fall back to the installed default recipe; place the recipe under --out or omit --out." >&2
+  if [ ! -f "$OUT_ABS/runner/smoke.extension.recipe.json" ]; then
+    echo "extension verify: --out '$OUT' (resolved: $OUT_ABS) has no runner/smoke.extension.recipe.json. Refusing to fall back to the installed default recipe; place the recipe under --out or omit --out." >&2
     exit 2
   fi
-  SMOKE_RECIPE="$OUT_ABS/smoke.extension.recipe.json"
+  SMOKE_RECIPE="$OUT_ABS/runner/smoke.extension.recipe.json"
 fi
 ARTIFACTS="${ARTIFACTS:-$HARNESS_DIR/verify/$(date -u +%Y%m%dT%H%M%SZ)}"
 mkdir -p "$ARTIFACTS/logs"

package/adapters/mobile/start-metro.sh

@@ -86,6 +86,20 @@ start_console_forwarder() {
   local fwd_pid_file="$LOG_DIR/console-forwarder.pid"
   [ "${METAMASK_RECIPE_CONSOLE_FORWARD:-1}" != "0" ] || return 0
   { [ -f "$forwarder" ] && command -v node >/dev/null 2>&1; } || return 0
+  # Only one debugger can own a React Native page. Reap any forwarder already
+  # attached to this Metro port, even if it was launched from another checkout or
+  # package install path and therefore does not own this runtime dir's pid file.
+  while IFS= read -r line; do
+    local pid cmd
+    pid="${line%% *}"
+    cmd="${line#* }"
+    [ "$pid" != "$line" ] || continue
+    case "$cmd" in
+      *console-forwarder.cjs*" --port $PORT "*|*console-forwarder.cjs*" --port=$PORT "*)
+        kill "$pid" 2>/dev/null || true
+        ;;
+    esac
+  done < <(ps -axo pid=,command= 2>/dev/null || true)
   if [ -f "$fwd_pid_file" ]; then
     local old_fwd
     old_fwd="$(cat "$fwd_pid_file" 2>/dev/null || true)"
@@ -126,7 +140,7 @@ set +a
 export EXPO_NO_TYPESCRIPT_SETUP=1
 export WATCHER_PORT="$(printf '%q' "$PORT")" METRO_PORT="$(printf '%q' "$PORT")"
 export METRO_MAX_WORKERS="$(printf '%q' "$METRO_WORKERS")"
-exec yarn expo start --port "$(printf '%q' "$PORT")"$clear_flag >> "$(printf '%q' "$LOG_FILE")" 2>&1
+yarn expo start --port "$(printf '%q' "$PORT")"$clear_flag 2>&1 | tee -a "$(printf '%q' "$LOG_FILE")"
 EOF
   chmod +x "$runner"
 }

package/adapters/mobile/verify.sh

@@ -216,6 +216,34 @@ process.stdout.write(value);
 NODE
 }
 
+runtime_context_value() {
+  TARGET_FOR_RUNTIME_CONTEXT="$TARGET" RUNTIME_DIR_FOR_RUNTIME_CONTEXT="$RUNTIME_DIR" RUNTIME_CONTEXT_NAME="$1" node <<'NODE'
+const fs = require('fs');
+const path = require('path');
+const target = process.env.TARGET_FOR_RUNTIME_CONTEXT;
+const runtimeDir = process.env.RUNTIME_DIR_FOR_RUNTIME_CONTEXT;
+const names = process.env.RUNTIME_CONTEXT_NAME.split(',');
+const file = path.join(target, runtimeDir, 'agentic-runtime.json');
+let data = {};
+try { data = JSON.parse(fs.readFileSync(file, 'utf8')); } catch {}
+for (const name of names) {
+  const value = data && data[name];
+  if (value !== undefined && value !== null && value !== '') {
+    process.stdout.write(String(value));
+    process.exit(0);
+  }
+}
+NODE
+}
+
+mobile_device_target() {
+  if [ "$PLATFORM" = "android" ]; then
+    printf '%s' "${ADB_SERIAL:-${ANDROID_SERIAL:-${ANDROID_DEVICE:-$(runtime_context_value adbSerial,androidDevice,device)}}}"
+    return
+  fi
+  printf '%s' "${SIM_UDID:-${IOS_SIMULATOR:-$(runtime_context_value simulator,iosSimulator,device)}}"
+}
+
 check_file() {
   local rel="$1"
   if [ -e "$TARGET/$rel" ]; then
@@ -331,6 +359,7 @@ run_with_timeout() {
 
 live_status_ok() {
   local log_path="$1"
+  local device_target="$2"
   cat > "$ARTIFACTS/mobile-status-smoke.recipe.json" <<'JSON'
 {
   "schema_version": 1,
@@ -349,12 +378,15 @@ live_status_ok() {
 JSON
   (
     cd "$TARGET"
-    "$RUNNER_BIN" run "$ARTIFACTS/mobile-status-smoke.recipe.json" --adapter mobile --project-root "$TARGET" --artifacts-dir "$ARTIFACTS/runner-status-smoke" --json
+    device_args=()
+    [ -n "$device_target" ] && device_args=(--device "$device_target")
+    "$RUNNER_BIN" run "$ARTIFACTS/mobile-status-smoke.recipe.json" --adapter mobile --project-root "$TARGET" "${device_args[@]}" --artifacts-dir "$ARTIFACTS/runner-status-smoke" --json
   ) > "$log_path" 2>&1
 }
 
 ensure_live_runtime() {
-  if live_status_ok "$ARTIFACTS/logs/app-status-precheck.log"; then
+  local device_target="$1"
+  if live_status_ok "$ARTIFACTS/logs/app-status-precheck.log" "$device_target"; then
     return 0
   fi
   if [ "$AUTO_START" = true ]; then
@@ -366,7 +398,17 @@ EOF
 }
 
 if [ "$STATIC_ONLY" = false ]; then
-  if ensure_live_runtime; then
+  device_target="$(mobile_device_target)"
+  if [ -z "$device_target" ]; then
+    if [ "$PLATFORM" = "android" ]; then
+      device_target="$(jsenv_value ADB_SERIAL)"
+      [ -n "$device_target" ] || device_target="$(jsenv_value ANDROID_DEVICE)"
+    else
+      device_target="$(jsenv_value IOS_SIMULATOR)"
+    fi
+  fi
+
+  if ensure_live_runtime "$device_target"; then
     checks+=('{"name":"mobile runtime controllable precheck","status":"pass"}')
   else
     checks+=('{"name":"mobile runtime controllable precheck","status":"fail","detail":"see logs/app-status-precheck.log"}')
@@ -394,20 +436,13 @@ if [ "$STATIC_ONLY" = false ]; then
 {
   "schema_version": 1,
   "title": "Mobile v1 runner live bridge smoke",
-  "description": "Verifies the installed MetaMask runner can drive the React Native debug bridge through Recipe v1 actions.",
+  "description": "Verifies the installed MetaMask runner can read the React Native debug bridge without mutating wallet state.",
   "validate": {
     "workflow": {
       "entry": "status",
       "nodes": {
         "status": { "action": "app.status", "intent": "Read Mobile app status through the v1 runner", "next": "cdp-probe" },
-        "cdp-probe": { "action": "cdp.target", "intent": "Verify the React Native debug bridge target is reachable", "required": true, "timeout_ms": 15000, "next": "wallet-setup" },
-        "wallet-setup": { "action": "metamask.wallet.setup", "intent": "Prepare the wallet fixture for the live bridge smoke", "timeout_ms": 45000, "next": "wallet-unlock" },
-        "wallet-unlock": { "action": "metamask.wallet.ensure_unlocked", "intent": "Unlock the wallet through the manifest-declared action", "timeout_ms": 45000, "next": "wallet-read" },
-        "wallet-read": { "action": "metamask.wallet.read_state", "intent": "Read wallet state before navigating to the wallet view", "timeout_ms": 45000, "next": "navigate-wallet" },
-        "navigate-wallet": { "action": "ui.navigate", "intent": "Open the wallet view through the UI navigation action", "route": "WalletView", "timeout_ms": 45000, "next": "wait-wallet" },
-        "wait-wallet": { "action": "ui.wait_for", "intent": "Wait until the wallet screen is present", "test_id": "wallet-screen", "expected": "present", "timeout_ms": 45000, "next": "hud-smoke" },
-        "hud-smoke": { "action": "app.hud", "status": "running", "intent": "Show the Mobile live bridge smoke HUD", "progress": { "current": 1, "total": 1 }, "timeout_ms": 45000, "next": "screenshot" },
-        "screenshot": { "action": "ui.screenshot", "intent": "Capture proof that the wallet screen is visible", "path": "screenshots/mobile-v1-live-smoke.png", "timeout_ms": 45000, "next": "done" },
+        "cdp-probe": { "action": "cdp.target", "intent": "Verify the React Native debug bridge target is reachable", "required": true, "timeout_ms": 15000, "next": "done" },
         "done": { "action": "end", "status": "pass" }
       }
     }
@@ -417,13 +452,15 @@ JSON
 
   ios_simulator_resolved="$(jsenv_value IOS_SIMULATOR)"
   adb_serial_resolved="$(jsenv_value ADB_SERIAL)"
+  device_args=()
+  [ -n "$device_target" ] && device_args=(--device "$device_target")
   if (
     cd "$TARGET"
     METAMASK_RECIPE_AUTO_HUD=0 \
     IOS_SIMULATOR="${IOS_SIMULATOR:-$ios_simulator_resolved}" \
     ADB_SERIAL="${ADB_SERIAL:-$adb_serial_resolved}" \
     ANDROID_SERIAL="${ANDROID_SERIAL:-$adb_serial_resolved}" \
-    "$RUNNER_BIN" run "$ARTIFACTS/mobile-v1-live-smoke.recipe.json" --adapter mobile --project-root "$TARGET" --artifacts-dir "$ARTIFACTS/runner-live-smoke" --json
+    "$RUNNER_BIN" run "$ARTIFACTS/mobile-v1-live-smoke.recipe.json" --adapter mobile --project-root "$TARGET" "${device_args[@]}" --artifacts-dir "$ARTIFACTS/runner-live-smoke" --json
   ) > "$ARTIFACTS/logs/runner-live-smoke.log" 2>&1; then
     checks+=("{\"name\":\"runner v1 live bridge smoke\",\"status\":\"pass\"}")
   else

package/adapters/shared/log-tui.mjs

@@ -222,13 +222,17 @@ async function watchLog(options) {
     const chunk = readNewContent(logPath, offset);
     offset = chunk.offset;
     const allText = fs.existsSync(logPath) ? fs.readFileSync(logPath, 'utf8') : '';
+    // Match readiness only against bytes read after this watch started. This
+    // assumes line-oriented log writes; a marker split across partial writes
+    // waits for a later complete marker instead of stale-passing.
+    const matchText = chunk.text;
     const events = extractEvents(allText, eventsLimit);
 
-    if (matchesPattern(allText, 'Module build failed|^ERROR in |compiled with [1-9][0-9]* error|FAIL runtime-launch|Extension harness launch fail')) {
+    if (matchesPattern(matchText, 'Module build failed|^ERROR in |compiled with [1-9][0-9]* error|FAIL runtime-launch|Extension harness launch fail')) {
       renderCompact({ label, logPath, events, quiet: mode === 'quiet' });
       return 1;
     }
-    if (matchesPattern(allText, successPattern)) {
+    if (matchesPattern(matchText, successPattern)) {
       renderCompact({ label, logPath, events, quiet: mode === 'quiet' });
       if (mode !== 'quiet') {
         const elapsed = Math.round((Date.now() - started) / 1000);
@@ -357,4 +361,4 @@ async function main() {
 main().catch((error) => {
   console.error(error instanceof Error ? error.message : String(error));
   process.exit(1);
-});
+});

package/dist/cli-commands.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { listRecipeFiles } from "./recipe-files.js";
 const SPEC = {
   shim: [
     { name: "sync", desc: "Copy fixture, write slot context, install harness", flags: ["--dry-run", "--no-install"] },
@@ -16,7 +17,7 @@ const SPEC = {
     { name: "fixtures", desc: "Manage the canonical wallet fixture (sync/set/generate)", args: ["sync", "set", "generate"], flags: ["--fixture", "--out", "--adapter", "--target", "--device", "--json"] },
     { name: "actions", desc: "List runnable recipe actions", flags: ["--json"] },
     { name: "doctor", desc: "Check harness/orchestration health", flags: ["--json", "--target", "--adapter", "--runtime-dir", "--expect-live", "--cdp-port", "--device"] },
-    { name: "run", desc: "Execute a proof recipe (path or library name, e.g. run smoke)", args: ["recipe.json|name"], flags: ["--list", "--device"] },
+    { name: "run", desc: "Execute a proof recipe (path or library name, e.g. run perps.smoke)", args: ["recipe.json|name"], flags: ["--list", "--device"] },
     { name: "recipe-quality", desc: "Build the recipe-quality artifact from compact JSON", args: ["build"], flags: ["--input", "--output", "--json"] },
     { name: "interactive", aliases: ["menu"], desc: "Interactive command menu" },
     { name: "prepare", desc: "Install harness (+ optional validate)", flags: ["--target", "--runtime-dir", "--json"] },
@@ -124,9 +125,9 @@ function listRunRecipes(adapter, root, cwd = process.cwd()) {
   for (const resolveDir of RUN_RECIPE_DIRS) {
     const dir = resolveDir(adapter, root);
     if (!fs.existsSync(dir)) continue;
-    for (const name of fs.readdirSync(dir)) {
-      if (!name.endsWith(".recipe.json") || byBase.has(name)) continue;
-      byBase.set(name, path.join(dir, name));
+    for (const rel of listRecipeFiles(dir)) {
+      if (byBase.has(rel)) continue;
+      byBase.set(rel, path.join(dir, rel));
     }
   }
   return [...byBase.values()].map((abs) => path.relative(cwd, abs)).sort();

package/dist/commands/call.js

@@ -16,6 +16,7 @@ import {
   runtimeOptionsFromCli,
   usageError
 } from "./parse-args.js";
+import { getAdapterSurface } from "../adapters/surface.js";
 import { handleListExecutables } from "./list-executables.js";
 import { applyDeviceTargeting } from "./device-target.js";
 import {
@@ -33,7 +34,7 @@ async function handleCall(argv) {
     return handleListExecutables("call", options2);
   }
   if (argv.length > 0 && argv[0].startsWith("--")) {
-    const message = "call requires <action> first: mm-harness call <action> [--arg k=v ...] [flags]";
+    const message = "call requires <action> first: mm-harness call <action> [key=value ...] [--arg k=v ...] [flags]";
     console.error(message);
     return EXIT.usage;
   }
@@ -60,6 +61,7 @@ async function handleCall(argv) {
     return EXIT.usage;
   }
   const { adapter, target } = resolveAdapter(options);
+  getAdapterSurface(adapter).resolveSlotPorts(target);
   const dtResult = applyDeviceTargeting("call", adapter, options, { gate: true, rerun: "" });
   if ("code" in dtResult) {
     if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, error: { code: dtResult.code, message: dtResult.message } }, null, 2));
@@ -127,6 +129,7 @@ async function handleCall(argv) {
     state
   );
   if (violation !== null) return emitHealViolation(json, "call", result, violation, state, adapter);
+  const callOutput = readCallOutput(result.tracePath);
   if (json) {
     console.log(
       JSON.stringify(
@@ -141,6 +144,7 @@ async function handleCall(argv) {
           summaryPath: result.summaryPath,
           tracePath: result.tracePath,
           artifactManifestPath: result.artifactManifestPath,
+          ...callOutput !== void 0 ? { output: callOutput } : {},
           recovered: state.recovered,
           mutations: state.mutations,
           exitCode: result.status === "pass" ? EXIT.ok : EXIT.runtime
@@ -150,11 +154,29 @@ async function handleCall(argv) {
       )
     );
   } else {
-    console.log(`call ${resolvedAction}: ${result.status}
+    const rendered = callOutput !== void 0 ? `
+Result:
+${formatCallOutput(callOutput)}` : "";
+    console.log(`call ${resolvedAction}: ${result.status}${rendered}
 Artifacts: ${result.artifactManifestPath}`);
   }
   return result.status === "pass" ? EXIT.ok : EXIT.runtime;
 }
+function readCallOutput(tracePath) {
+  try {
+    const trace = JSON.parse(fs.readFileSync(tracePath, "utf8"));
+    const entries = Array.isArray(trace) ? trace : isRecord(trace) && Array.isArray(trace.entries) ? trace.entries : [];
+    const entry = entries.find((item) => isRecord(item) && item.nodeId === "call");
+    return isRecord(entry) && Object.prototype.hasOwnProperty.call(entry, "output") ? entry.output : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function formatCallOutput(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean" || value === null) return String(value);
+  return JSON.stringify(value, null, 2);
+}
 async function handleCallHelp(argv, genericHelp) {
   const { action: shortName, rest } = parseCallArgs(argv.filter((arg) => arg !== "--help" && arg !== "-h"));
   const { options } = parseArgs(rest, "call");
@@ -194,13 +216,13 @@ function renderCallActionHelp(entry) {
   const required = new Set(
     Array.isArray(schema.required) ? schema.required.filter((r) => typeof r === "string") : []
   );
-  const lines = [`mm-harness call ${entry.name} [--arg k=v ...] [flags]`, ""];
+  const lines = [`mm-harness call ${entry.name} [key=value ...] [--arg k=v ...] [flags]`, ""];
   if (entry.description) lines.push(`  ${entry.description}`, "");
   const names = Object.keys(properties).sort();
   if (names.length === 0) {
     lines.push("  Fields: (none)");
   } else {
-    lines.push("  Fields (pass with --arg <name>=<value>):");
+    lines.push("  Fields (pass as <name>=<value> or --arg <name>=<value>):");
     const width = Math.max(...names.map((name) => name.length));
     for (const name of names) {
       const prop = isRecord(properties[name]) ? properties[name] : {};
@@ -226,7 +248,7 @@ function renderCallExamples(short, examples) {
   for (const example of examples.slice(0, 2)) {
     const node = isRecord(example) && isRecord(example.node) ? example.node : void 0;
     if (!node) continue;
-    const tokens = Object.entries(node).filter(([key]) => key !== "action" && key !== "intent").map(([key, value]) => `--arg ${key}=${typeof value === "string" ? value : JSON.stringify(value)}`);
+    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());
   }
   return out;
@@ -249,10 +271,44 @@ function parseCallArgs(argv) {
       action = arg;
       continue;
     }
+    if (action !== void 0 && !isForwardedOptionValue(argv, i) && isArgPair(arg)) {
+      const eq = arg.indexOf("=");
+      args[arg.slice(0, eq)] = arg.slice(eq + 1);
+      continue;
+    }
     rest.push(arg);
   }
   return { action, args, rest };
 }
+function isArgPair(value) {
+  const eq = value.indexOf("=");
+  return eq > 0;
+}
+function isForwardedOptionValue(argv, index) {
+  if (index === 0) return false;
+  const previous = argv[index - 1];
+  if (!previous.startsWith("--") || previous.includes("=")) return false;
+  return VALUE_TAKING_CALL_FLAGS.has(normalizeFlagName(previous));
+}
+const VALUE_TAKING_CALL_FLAGS = /* @__PURE__ */ new Set([
+  "action-manifest",
+  "adapter",
+  "artifacts-dir",
+  "cdp-port",
+  "device",
+  "heal",
+  "library",
+  "metro-port",
+  "platform",
+  "project-root",
+  "slot",
+  "target",
+  "validation-runtime-dir",
+  "watcher-port"
+]);
+function normalizeFlagName(flag) {
+  return flag.replace(/^--/u, "");
+}
 function resolveActionName(shortName, names) {
   if (names.includes(shortName)) return { status: "ok", resolved: shortName, candidates: [shortName] };
   const finalSegment = (name) => name.split(".").pop() ?? name;

package/dist/commands/device-target.js

@@ -111,9 +111,16 @@ function applyDeviceTargeting(command, adapter, options, opts) {
 ${formatConnectedDevices(connected2)}` : `  No devices are currently connected (adb devices / booted iOS simulators).`)
     };
   }
-  if (!opts.gate) return { ok: true };
   const connected = listConnectedDevices();
   const targetable = connected.filter(isTargetable);
+  const selectedTargetable = targetable.filter(deviceSelected);
+  if (selectedTargetable.length === 1) {
+    const selected = selectedTargetable[0];
+    if (selected.platform === "android") setAndroidDeviceEnv(selected.id, selected.name);
+    else setIosDeviceEnv(selected.id, selected.name);
+    return { ok: true };
+  }
+  if (!opts.gate) return { ok: true };
   if (targetable.length > 1) {
     return {
       ok: false,
@@ -121,8 +128,8 @@ ${formatConnectedDevices(connected2)}` : `  No devices are currently connected (
       message: `${targetable.length} mobile devices available \u2014 ${command} needs exactly one target.
   Connected devices:
 ${formatConnectedDevices(connected)}
-  Add --device <id> to disambiguate, e.g.:${targetable.map((d) => `
-    --device ${d.id}`).join("")}`
+` + (selectedTargetable.length > 1 ? `  The current slot context selects more than one target; fix the slot device pins or add --device <id>.` : `  Add --device <id> to disambiguate, e.g.:${targetable.map((d) => `
+    --device ${d.id}`).join("")}`)
     };
   }
   return { ok: true };

package/dist/commands/fixtures.js

@@ -39,13 +39,14 @@ async function handleFixtures(argv, deps) {
   if (!adapter) {
     return usageOut(json, "fixtures", `could not detect the MetaMask repo type for ${target}`, ADAPTER_DETECT_NEXT);
   }
+  const surface = getAdapterSurface(adapter);
+  surface.resolveSlotPorts(target);
   const dtResult = applyDeviceTargeting("fixtures", adapter, options, { gate: false, rerun: "" });
   if ("code" in dtResult) {
     return usageOut(json, "fixtures", dtResult.message, "mm-harness fixtures set --adapter mobile --device <adb-serial|simulator-udid>");
   }
   if (sub === "generate") return fixturesGenerate(adapter, target, options, json);
   if (sub === "finalize") return fixturesFinalize(adapter, target, options, json);
-  const surface = getAdapterSurface(adapter);
   if (surface.headless) return usageOut(json, "fixtures", "core is headless; it has no wallet fixture.", surface.hints.launch);
   const canonicalFixture = walletFixturePath(target);
   const retryHint = `${surface.hints.relaunch}   # relaunch, then retry: mm-harness fixtures set`;