@deeeed/metamask-harness 0.92.12 → 0.92.15

package/CHANGELOG.md

@@ -6,6 +6,18 @@
 
 - Refresh Terminal contract goldens for the shipped console-error window, capture-provider metadata and engine evidence inventories.
 
+## 0.92.15 - 2026-10-16
+
+### Fixed
+
+- Add Extension viewer-only teardown for browser reservations, retaining the browser and webpack while verifying console collectors exit and reporting cleanup failures.
+
+## 0.92.14 - 2026-10-16
+
+### Fixed
+
+- Pin the worker dependency set to recipe-runner 0.38.1 so nested recipe nodes produce safe still filenames and publication preserves retained evidence links.
+
 ## 0.92.12 - 2026-10-16
 
 ### Fixed

package/adapters/extension/inject.mjs

@@ -127,6 +127,7 @@ copyFile(path.join(runnerDir, 'adapters/shared/path-defaults.json'), path.join(h
 copyFile(path.join(runnerDir, 'adapters/shared/json-field.sh'), path.join(harnessDir, 'scripts/lib/json-field.sh'));
 copyFile(path.join(runnerDir, 'adapters/shared/tmux-session.sh'), path.join(harnessDir, 'scripts/lib/tmux-session.sh'));
 copyFile(path.join(runnerDir, 'adapters/shared/tmux-viewer.sh'), path.join(harnessDir, 'scripts/lib/tmux-viewer.sh'));
+copyFile(path.join(runnerDir, 'adapters/shared/process-identity.sh'), path.join(harnessDir, 'scripts/lib/process-identity.sh'));
 copyFile(path.join(runnerDir, 'adapters/shared/log-tui.mjs'), path.join(harnessDir, 'scripts/lib/log-tui.mjs'));
 copyAdapterWeb(path.join(harnessDir, 'scripts/node_modules/@farmslot/adapter-web'));
 copyFile(path.join(runnerDir, 'adapters/extension/lib/product-config.cjs'), path.join(harnessDir, 'scripts/lib/product-config.cjs'));

package/adapters/extension/stop-viewers.sh

@@ -28,6 +28,18 @@ for _tv_src in "$SCRIPT_DIR/lib/tmux-viewer.sh" "$SCRIPT_DIR/../shared/tmux-view
 done
 unset _tv_src
 
+_process_lib="$SCRIPT_DIR/lib/process-identity.sh"
+[ -f "$_process_lib" ] || _process_lib="$SCRIPT_DIR/../shared/process-identity.sh"
+# shellcheck disable=SC1090
+. "$_process_lib"
+unset _process_lib
+
+_console_collector_owned() {
+  [ "$(process_identity "$1")" = "$2" ] &&
+    [ "$(ps -ww -p "$1" -o command= 2>/dev/null | sed 's/^[[:space:]]*//')" = "$3" ] &&
+    [ "$(process_identity "$1")" = "$2" ]
+}
+
 runtime_dir="$TARGET/$(recipe_runtime_dir)"
 set +e
 
@@ -40,16 +52,25 @@ if command -v tmux_viewer_sweep_prefix >/dev/null 2>&1; then
   tmux_viewer_sweep_prefix "console" "$runtime_dir"
 fi
 
-ps -axo pid=,command= 2>/dev/null | while read -r pid command; do
+ps -ww -axo pid=,command= 2>/dev/null | while read -r pid command; do
   [ -n "${pid:-}" ] || continue
   case "$command" in
     *console-tail.mjs*) ;;
     *) continue ;;
   esac
   case "$command" in
-    *"$runtime_dir/"*) kill "$pid" 2>/dev/null || true ;;
+    *"$runtime_dir/"*)
+      identity="$(process_identity "$pid")"
+      if [ -z "$identity" ] && ! kill -0 "$pid" 2>/dev/null; then continue; fi
+      stop_verified_process "$pid" "$identity" TERM 0.05 _console_collector_owned "$pid" "$identity" "$command" || exit 1
+      ;;
   esac
 done
+stop_status=$?
+if [ "$stop_status" -ne 0 ]; then
+  echo "Console collector stop was not confirmed. Next: mm-harness status --target \"$TARGET\" --json" >&2
+  exit "$stop_status"
+fi
 
 rm -f "$runtime_dir/console.tmux" "$runtime_dir/webpack.tmux" "$runtime_dir/console-tail.pid"
 exit 0

package/adapters/manifest.json

@@ -527,6 +527,11 @@
       "entry": "adapters/shared/reap-checkout-metros.sh",
       "kind": "lib"
     },
+    {
+      "id": "lib/process-identity",
+      "entry": "adapters/shared/process-identity.sh",
+      "kind": "lib"
+    },
     {
       "id": "lib/sync-wallet-fixture",
       "entry": "adapters/shared/sync-wallet-fixture.sh",

package/adapters/mobile/lib/idb-companion.sh

@@ -1,8 +1,11 @@
 #!/usr/bin/env bash
 # Stop only companions bound to this checkout and its selected simulator.
 
+# shellcheck disable=SC1091
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")/../../shared" && pwd)/process-identity.sh"
+
 _idb_companion_identity() {
-  ps -p "$1" -o pid=,pgid=,lstart=,comm= 2>/dev/null
+  process_identity "$1"
 }
 
 # 1 is foreign; 2 is unknown and must not authorize a signal.
@@ -21,7 +24,7 @@ _idb_companion_owned() {
 }
 
 stop_checkout_idb_companions() {
-  local repo="$1" udid="${2:-}" pids pid identity status signal current attempt stopped
+  local repo="$1" udid="${2:-}" pids pid identity status
   if pids="$(pgrep -u "$(id -u)" -x idb_companion 2>/dev/null)"; then :
   else
     status=$?
@@ -41,26 +44,8 @@ stop_checkout_idb_companions() {
       printf 'Companion ownership is unknown. Next: mm-harness status --target "%s"\n' "$repo" >&2
       return 1
     fi
-    stopped=false
-    for signal in TERM KILL; do
-      if ! _idb_companion_owned "$repo" "$udid" "$pid" "$identity"; then
-        printf 'Companion ownership changed. Next: mm-harness status --target "%s"\n' "$repo" >&2
-        return 1
-      fi
-      kill -"$signal" "$pid" 2>/dev/null || true
-      for attempt in $(seq 1 20); do
-        current="$(_idb_companion_identity "$pid")"
-        if [ -z "$current" ] && ! kill -0 "$pid" 2>/dev/null; then stopped=true; break; fi
-        if [ "$current" != "$identity" ]; then
-          printf 'Companion identity changed during stop. Next: mm-harness status --target "%s"\n' "$repo" >&2
-          return 1
-        fi
-        sleep 0.1
-      done
-      [ "$stopped" = true ] && break
-    done
-    if [ "$stopped" != true ]; then
-      printf 'Companion %s did not stop. Next: mm-harness status --target "%s"\n' "$pid" "$repo" >&2
+    if ! stop_verified_process "$pid" "$identity" 'TERM KILL' 0.1 _idb_companion_owned "$repo" "$udid" "$pid" "$identity"; then
+      printf 'Companion %s cleanup was not confirmed. Next: mm-harness status --target "%s"\n' "$pid" "$repo" >&2
       return 1
     fi
     printf 'Stopped checkout idb companion %s\n' "$pid" >&2

package/adapters/shared/process-identity.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Confirm process identity and caller-owned scope before signalling.
+
+process_identity() {
+  LC_ALL=C ps -p "$1" -o pid=,pgid=,lstart=,comm= 2>/dev/null
+}
+
+stop_verified_process() {
+  local pid="$1" identity="$2" signals="$3" interval="$4" signal attempt current
+  shift 4
+  if [ -z "$identity" ]; then
+    if ! kill -0 "$pid" 2>/dev/null; then return 0; fi
+    printf 'Process %s identity is unknown; stop refused.\n' "$pid" >&2
+    return 1
+  fi
+  for signal in $signals; do
+    if ! "$@"; then
+      if [ -z "$(process_identity "$pid")" ] && ! kill -0 "$pid" 2>/dev/null; then return 0; fi
+      printf 'Process %s ownership changed before stop.\n' "$pid" >&2
+      return 1
+    fi
+    kill -"$signal" "$pid" 2>/dev/null || true
+    for attempt in $(seq 1 20); do
+      current="$(process_identity "$pid")"
+      if [ -z "$current" ] && ! kill -0 "$pid" 2>/dev/null; then return 0; fi
+      if [ "$current" != "$identity" ]; then
+        printf 'Process %s identity changed during stop.\n' "$pid" >&2
+        return 1
+      fi
+      sleep "$interval"
+    done
+  done
+  printf 'Process %s did not stop.\n' "$pid" >&2
+  return 1
+}

package/dist/adapters/extension/surface.js

@@ -21,6 +21,16 @@ function watcherStatus(buildLog) {
   if (buildLog === "no-watch") return "down";
   return buildLog;
 }
+function stopExtensionViewers(target) {
+  const result = spawnSync("bash", [path.join(runnerDir, "adapters/extension/stop-viewers.sh"), "--target", target], {
+    encoding: "utf8",
+    timeout: 5e3
+  });
+  return {
+    status: result.error ? 1 : result.status ?? 1,
+    detail: result.error?.message || result.stderr.trim() || result.stdout.trim()
+  };
+}
 function extensionRuntimeNextAction(reasonCode, target) {
   const resolved = shellQuote(path.resolve(target));
   if (reasonCode === "rpc-execution-failed") return `mm-harness logs --target ${resolved} --full`;
@@ -85,8 +95,16 @@ const extensionSurface = defineAdapter({
     describe: () => "Extension runtime",
     stop(target) {
       const stopped = stopExtensionRuntime(target);
-      const stopViewers = path.join(runnerDir, "adapters/extension/stop-viewers.sh");
-      spawnSync("bash", [stopViewers, "--target", target], { stdio: "ignore", timeout: 5e3 });
+      const viewers = stopExtensionViewers(target);
+      if (viewers.status !== 0) {
+        return {
+          kind: "stopped",
+          status: viewers.status,
+          signalled: stopped.signalled,
+          summary: `failed to stop Extension viewers for ${target}`,
+          output: viewers.detail
+        };
+      }
       const summary = stopped.signalled > 0 || stopped.removedMarkers > 0 ? `stopped Extension runtime (${stopped.signalled} process${stopped.signalled === 1 ? "" : "es"}, ${stopped.removedMarkers} stale marker${stopped.removedMarkers === 1 ? "" : "s"}) for ${target}` : `Extension runtime not running for ${target} \u2014 nothing to stop`;
       return { kind: "stopped", status: 0, summary, signalled: stopped.signalled };
     },
@@ -154,5 +172,6 @@ const extensionSurface = defineAdapter({
 adapterRegistry.register(extensionSurface);
 export {
   extensionRuntimeNextAction,
-  extensionSurface
+  extensionSurface,
+  stopExtensionViewers
 };

package/dist/command-contract.js

@@ -696,6 +696,21 @@ Example:
       })
     }
   },
+  {
+    name: "stop-viewers",
+    summary: "Stop checkout console collectors and log viewers while retaining the Extension browser and webpack.",
+    example: "mm-harness stop-viewers --adapter extension",
+    helpText: `mm-harness stop-viewers [flags]
+
+  Stop this checkout's Extension console collectors and log viewers.
+  The browser, profile and development server stay running. Used when an
+  Extension farm releases its browser reservation.
+
+  --adapter extension               Target adapter
+  --target <path>                    Checkout path (default: cwd)
+  --json                             Machine-readable output`,
+    contract: { options: options(HELP, JSON, TARGET, ADAPTER) }
+  },
   {
     name: "call",
     summary: "Run one action in isolation as a one-node recipe through the real engine path (fuzzy short names; key=value inputs; same trace/evidence as run).",

package/dist/commands/stop.js

@@ -0,0 +1,31 @@
+import { optionFlag, parseArgs, resolveAdapter, shellQuote, usageOut } from "@farmslot/recipe-cli/harness";
+import { stopExtensionViewers } from "../adapters/extension/surface.js";
+async function handleStopViewers(argv) {
+  const parsed = parseArgs(argv);
+  const json = optionFlag(parsed.options, "json");
+  const { adapter, target } = resolveAdapter(parsed.options);
+  if (adapter !== "extension") {
+    return usageOut(json, "stop-viewers", "Viewer-only cleanup requires the Extension adapter.", "mm-harness stop-viewers --adapter extension");
+  }
+  const result = stopExtensionViewers(target);
+  const exitCode = result.status;
+  const detail = result.detail;
+  const userAction = `mm-harness status --target ${shellQuote(target)} --json`;
+  if (json) {
+    console.log(JSON.stringify({
+      schemaVersion: 1,
+      command: "stop-viewers",
+      adapter,
+      target,
+      status: exitCode === 0 ? "pass" : "fail",
+      exitCode,
+      ...exitCode === 0 ? {} : { error: { code: "VIEWER_STOP_FAILED", message: detail || "Checkout viewers did not stop.", userAction } }
+    }));
+  } else {
+    console.error(exitCode === 0 ? `Stopped checkout viewers for ${target}; browser and watcher retained.` : `${detail || "Checkout viewers did not stop."} Next: ${userAction}`);
+  }
+  return exitCode;
+}
+export {
+  handleStopViewers
+};

package/dist/mm-harness-cli.js

@@ -20,6 +20,7 @@ import {
   parseArgs,
   targetPath
 } from "@farmslot/recipe-cli/harness";
+import { handleStopViewers } from "./commands/stop.js";
 import { stopOptions } from "./provider-lifecycle.js";
 import { adoptPluginAdapter, afterAdapterLoad, configuredLibrarySources } from "./adapters/plugin-surface.js";
 import { withMainnetOrderAbort } from "./adapters/perps-mainnet-cleanup.js";
@@ -150,6 +151,7 @@ const PUBLIC_RUN = {
   "execution-template": { run: handleExecutionTemplate },
   actions: { run: (args) => handleActions(parseArgs(args), { catalog: metaMaskEngine }) },
   stop: { run: (args) => handleStop(args, stopOptions) },
+  "stop-viewers": { run: handleStopViewers },
   // A signal during run or call still cancels the run's mainnet orders.
   call: { run: (args) => withMainnetOrderAbort(targetPath(parseArgs(args).options), () => handleCall(args, callOptions)) },
   run: { run: (args) => withMainnetOrderAbort(targetPath(parseArgs(args).options), () => handleRun(args, runOptions)) },
@@ -188,7 +190,7 @@ const HELP_GROUPS = [
   {
     title: "DAILY LOOP",
     blurb: "what a teammate runs many times a day (auto-ensures the overlay; --heal owns recovery)",
-    commands: ["status", "task", "prepare", "launch", "stop", "logs", "debug", "reload", "fixtures"]
+    commands: ["status", "task", "prepare", "launch", "stop", "stop-viewers", "logs", "debug", "reload", "fixtures"]
   },
   {
     title: "DISCOVER",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.92.12",
+  "version": "0.92.15",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -21,15 +21,15 @@
     "check:syntax": "find . -name '*.mjs' -print0 | xargs -0 -n1 node --check"
   },
   "dependencies": {
-    "@farmslot/adapter-node": "0.1.27",
-    "@farmslot/adapter-rn": "0.22.16",
-    "@farmslot/adapter-sdk": "0.15.1",
-    "@farmslot/adapter-web": "0.10.7",
-    "@farmslot/agent-runtime": "0.25.1",
+    "@farmslot/adapter-node": "0.1.30",
+    "@farmslot/adapter-rn": "0.22.19",
+    "@farmslot/adapter-sdk": "0.16.1",
+    "@farmslot/adapter-web": "0.10.10",
+    "@farmslot/agent-runtime": "0.25.4",
     "@farmslot/handoff": "^0.3.1",
-    "@farmslot/protocol": "0.48.0",
-    "@farmslot/recipe-cli": "0.20.0",
-    "@farmslot/recipe-runner": "0.37.1",
+    "@farmslot/protocol": "0.50.0",
+    "@farmslot/recipe-cli": "0.22.2",
+    "@farmslot/recipe-runner": "0.38.1",
     "agent-device": "0.19.3",
     "commander": "^12.0.0",
     "esbuild": "0.28.1",