@deeeed/metamask-harness 0.92.5 → 0.92.7

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## 0.92.7 - 2026-10-15
+
+### Changed
+
+- Adopt the shared ProjectRuntime, ActionCatalog and ActionHandler contracts and pin their coordinated public package versions.
+
+## 0.92.6 - 2026-10-15
+
+### Changed
+
+- Pin adapter-web 0.10.2 and use the shared Android recorder and wallet HUD, preserving device selection, mirror fallback, recording failures and footer spacing. Remove the duplicate implementations and the unnecessary Android ffmpeg readiness check.
+
 ## 0.92.5 - 2026-10-15
 
 ### Fixed

package/dist/adapters/mobile/run.js

@@ -111,11 +111,10 @@ async function selectMobileRecorder() {
   const androidSerial = resolveAndroidDeviceSerial();
   const iosSimulator = androidSerial ? void 0 : resolveMobileIosSimulatorName();
   if (!androidSerial && !iosSimulator) return void 0;
+  const { createAndroidVideoRecorder, createIosSimulatorVideoRecorder } = await import("@farmslot/adapter-rn");
   if (androidSerial && resolveAndroidRecorderKind(androidSerial) === "screenrecord") {
-    const { createAndroidScreenrecordRecorder } = await import("./android-screenrecord.js");
-    return { recorder: createAndroidScreenrecordRecorder(androidSerial), device: androidSerial };
+    return { recorder: createAndroidVideoRecorder(androidSerial), device: androidSerial };
   }
-  const { createAndroidVideoRecorder, createIosSimulatorVideoRecorder } = await import("@farmslot/adapter-rn");
   if (androidSerial) {
     const { createAndroidMirrorVideoRecorder } = await import("@farmslot/recipe-runner");
     const mirror = createAndroidMirrorVideoRecorder({ serial: androidSerial, fallback: createAndroidVideoRecorder(androidSerial) });

package/library/actions/web-dapp/platform/page.mjs

@@ -9,7 +9,7 @@
 import { isAppUrl } from '@farmslot/adapter-web/origin';
 import { cdpListenerPids } from '@farmslot/adapter-web/web-dapp';
 
-import { readHudState, resolveSlowMo } from './adapter-web-lib.mjs';
+import { hudRenderExpression, readHudState, resolveSlowMo } from './adapter-web-lib.mjs';
 import { appOrigin, cdpPort, readBrowserState, webDappRuntimeDir } from './runtime.mjs';
 import { importRecipeHarnessRuntimeCdp } from '../../harness-exports.mjs';
 
@@ -77,6 +77,14 @@ export async function selectAppTarget(input) {
 // step is drawn on the MetaMask page for the capture only, then removed. A
 // finished or absent state (--hud hide) draws nothing.
 class WalletSurfacePage extends CdpWebPage {
+  #origin;
+
+  constructor(session, targetUrl) {
+    super(session);
+    const target = new URL(targetUrl);
+    this.#origin = `${target.protocol}//${target.host}`;
+  }
+
   evaluate(expression) {
     return this.evaluateInIsolatedWorld(expression, 'web-dapp-wallet-surface');
   }
@@ -84,61 +92,16 @@ class WalletSurfacePage extends CdpWebPage {
   async screenshot(context, relPath, metadata = {}) {
     const state = context?.projectRoot ? readHudState(webDappRuntimeDir(context.projectRoot)) : null;
     const drawn = state?.current && !state.finished
-      ? await this.evaluate(walletHudExpression(state)).then((result) => result?.hud === true, () => false)
+      ? await this.evaluate(hudRenderExpression(state, this.#origin, { layout: 'bottom-dock' })).then((result) => result?.hud === true, () => false)
       : false;
     try {
       return await super.screenshot(context, relPath, metadata);
     } finally {
-      if (drawn) await this.evaluate(walletHudExpression(null)).catch(() => {});
+      if (drawn) await this.evaluate(hudRenderExpression(null, this.#origin, { layout: 'bottom-dock' })).catch(() => {});
     }
   }
 }
 
-// The wallet-page HUD: a bar docked to the bottom edge that reserves its own
-// height (a spacer after the content and the body's bottom padding), as the
-// Extension's HUD does on MetaMask pages, so the request and its footer
-// buttons move up instead of being covered. Inert, aria-hidden, pointer-events
-// none. null removes it and restores the body padding.
-export const WALLET_HUD_ID = 'mm-harness-wallet-hud';
-
-export function walletHudExpression(state) {
-  const progress = state?.current?.progress;
-  const view = state ? {
-    badge: ['RUN', progress ? `${progress.current}/${progress.total}` : ''].filter(Boolean).join(' '),
-    intent: String(state.current?.intent ?? ''),
-  } : null;
-  return `(() => {
-    const view = ${JSON.stringify(view)};
-    const id = ${JSON.stringify(WALLET_HUD_ID)};
-    const old = document.getElementById(id);
-    if (old) {
-      document.body.style.paddingBottom = old.dataset.previousPadding || '';
-      old.remove();
-      document.getElementById(id + '-space')?.remove();
-    }
-    if (!view) return { hud: false, cleared: Boolean(old) };
-    const bar = document.createElement('div');
-    bar.id = id;
-    bar.setAttribute('aria-hidden', 'true');
-    bar.inert = true;
-    bar.dataset.previousPadding = document.body.style.paddingBottom;
-    Object.assign(bar.style, { position: 'fixed', left: '0', right: '0', bottom: '0', zIndex: '2147483647', pointerEvents: 'none', boxSizing: 'border-box', padding: '5px 8px', background: 'rgba(8, 10, 14, 0.9)', color: '#fff', font: '600 11px/1.3 -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif', borderTop: '1px solid rgba(255,255,255,0.14)' });
-    const badge = document.createElement('span');
-    Object.assign(badge.style, { color: '#8ab4ff', fontSize: '9px', fontWeight: '800', marginRight: '6px' });
-    badge.textContent = view.badge;
-    bar.append(badge, view.intent);
-    document.body.append(bar);
-    const height = Math.ceil(bar.getBoundingClientRect().height);
-    const space = document.createElement('div');
-    space.id = id + '-space';
-    space.setAttribute('aria-hidden', 'true');
-    Object.assign(space.style, { display: 'block', height: height + 'px', pointerEvents: 'none' });
-    document.body.insertBefore(space, bar);
-    document.body.style.paddingBottom = height + 'px';
-    return { hud: true, docked: true, height };
-  })()`;
-}
-
 // Number inputs ignore select(), so the generic setInput would append to a
 // prefilled value (the order form prefills the mid price). Clear the field with
 // the editor's selectAll command, as a user's Cmd+A would, type over the
@@ -282,7 +245,7 @@ export async function withAppPage(input, callback, deps = PAGE_DEPS) {
     await session.call('Page.enable');
     await session.call('Runtime.enable');
     if (focusBrowserRequested(deps.env)) await session.call('Page.bringToFront');
-    const page = surface === 'wallet' ? new WalletSurfacePage(session) : new AppPage(session);
+    const page = surface === 'wallet' ? new WalletSurfacePage(session, target.url) : new AppPage(session);
     const result = await callback(page);
     return result && typeof result === 'object' && !Array.isArray(result)
       ? { ...result, surface, cdpPort: port, targetUrl: target.url.replace(/0x[0-9a-fA-F]{40}/gu, '<address>') }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.92.5",
+  "version": "0.92.7",
   "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.23",
-    "@farmslot/adapter-rn": "0.22.9",
-    "@farmslot/adapter-sdk": "0.14.0",
-    "@farmslot/adapter-web": "0.10.1",
-    "@farmslot/agent-runtime": "0.22.4",
+    "@farmslot/adapter-node": "0.1.26",
+    "@farmslot/adapter-rn": "0.22.13",
+    "@farmslot/adapter-sdk": "0.15.0",
+    "@farmslot/adapter-web": "0.10.5",
+    "@farmslot/agent-runtime": "0.23.3",
     "@farmslot/handoff": "^0.3.1",
-    "@farmslot/protocol": "0.45.0",
-    "@farmslot/recipe-cli": "0.18.0",
-    "@farmslot/recipe-runner": "0.36.0",
+    "@farmslot/protocol": "0.47.0",
+    "@farmslot/recipe-cli": "0.18.4",
+    "@farmslot/recipe-runner": "0.37.0",
     "agent-device": "0.19.3",
     "commander": "^12.0.0",
     "esbuild": "0.28.1",

package/dist/adapters/mobile/android-screenrecord.js

@@ -1,244 +0,0 @@
-import { spawn, spawnSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-import { createAndroidVideoRecorder } from "@farmslot/adapter-rn";
-import { optionalVideoTiming } from "@farmslot/recipe-runner";
-import { recordingFailure } from "./recording-outcome.js";
-const SEGMENT_SECONDS = 180;
-const START_TIMEOUT_MS = 5e3;
-const STOP_TIMEOUT_MS = 1e4;
-const START_GRACE_MS = 1e3;
-const HOST_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
-function createAndroidScreenrecordRecorder(serial, options = {}) {
-  const adb = (args) => spawnSync("adb", ["-s", serial, ...args], { encoding: "utf8", timeout: 6e4 });
-  return {
-    name: "adb-screenrecord",
-    platform: "android",
-    async doctor() {
-      const device = await createAndroidVideoRecorder(serial).doctor();
-      if (!device.ok) return device;
-      const ffmpeg = spawnSync(ffmpegPath(), ["-version"], { encoding: "utf8", timeout: 1e4 });
-      if (ffmpeg.status !== 0) {
-        return {
-          ok: false,
-          code: "ffmpeg_unavailable",
-          message: `ffmpeg, which joins Android screenrecord files, is unavailable: ${failure(ffmpeg)}`,
-          suggestedFix: "Install ffmpeg (brew install ffmpeg) or set FFMPEG_PATH."
-        };
-      }
-      return { ok: true, code: "ok", message: `Android on-device screen recording is ready on ${serial}.` };
-    },
-    start: (request) => startRecording(serial, request, adb, options)
-  };
-}
-async function startRecording(serial, request, adb, options) {
-  if (request.target.kind !== "android-device" || request.target.serial !== serial) {
-    throw new Error("Android recording target does not match the selected device.");
-  }
-  const pollMs = options.pollMs ?? 100;
-  const host = options.host ?? process;
-  const running = screenrecordPids(adb);
-  if (running.length > 0) {
-    throw new Error(`Android screenrecord is already running on ${serial} (pid ${running.join(", ")}). Stop that recording before retrying.`);
-  }
-  const prefix = `${options.remoteDir ?? "/sdcard/Download"}/mm-harness-recording-${Date.now()}-${process.pid}`;
-  const segments = [];
-  let stopping = false;
-  let interruption;
-  let chain = Promise.resolve();
-  const localFiles = /* @__PURE__ */ new Set();
-  const segmentFailure = (segment) => `screenrecord on ${serial} stopped with exit ${segment.exitCode ?? "error"}: ${segment.output.trim() || "no recorder output"}`;
-  const startSegment = async () => {
-    const remotePath = `${prefix}-${segments.length}.mp4`;
-    const startedAtUnixMs = Date.now();
-    const child = spawn(
-      "adb",
-      ["-s", serial, "shell", "screenrecord", "--time-limit", String(options.segmentSeconds ?? SEGMENT_SECONDS), remotePath],
-      { stdio: ["ignore", "ignore", "pipe"] }
-    );
-    const exited = new Promise((resolve) => {
-      child.once("error", () => resolve(null));
-      child.once("exit", (code) => resolve(code));
-    });
-    const segment = { remotePath, child, output: "", startedAtUnixMs, exited };
-    child.stderr?.setEncoding("utf8");
-    child.stderr?.on("data", (chunk) => {
-      segment.output = (segment.output + chunk).slice(-2e3);
-    });
-    segments.push(segment);
-    void exited.then((code) => {
-      segment.stoppedAtUnixMs = Date.now();
-      segment.exitCode = code;
-      if (!segment.pid || segment.killed || interruption || stopping) return;
-      if (code !== 0) {
-        interruption = segmentFailure(segment);
-        return;
-      }
-      chain = startSegment().catch((error) => {
-        interruption ??= error instanceof Error ? error.message : String(error);
-      });
-    });
-    const deadline = Date.now() + (options.startTimeoutMs ?? START_TIMEOUT_MS);
-    while (Date.now() < deadline) {
-      if (segment.stoppedAtUnixMs !== void 0) {
-        throw new Error(`Android screenrecord exited before capture started on ${serial}: ${segment.output.trim() || "no recorder output"}`);
-      }
-      const pid = screenrecordPids(adb)[0];
-      if (pid) {
-        segment.pid = pid;
-        return;
-      }
-      await delay(pollMs);
-    }
-    child.kill("SIGTERM");
-    throw new Error(`Android screenrecord did not start on ${serial} within ${options.startTimeoutMs ?? START_TIMEOUT_MS}ms.`);
-  };
-  const abandon = () => {
-    const live = segments.filter((segment) => segment.stoppedAtUnixMs === void 0);
-    for (const segment of live) segment.killed = true;
-    if (live.length > 0) {
-      const starting = live.some((segment) => !segment.pid);
-      const graceUntil = Date.now() + (starting ? START_GRACE_MS : 0);
-      const giveUpAt = Date.now() + (options.stopTimeoutMs ?? STOP_TIMEOUT_MS);
-      const signaled = /* @__PURE__ */ new Set();
-      while (Date.now() < giveUpAt) {
-        const pids = screenrecordPids(adb).filter((pid) => starting || live.some((segment) => segment.pid === pid));
-        if (pids.length === 0 && Date.now() >= graceUntil) break;
-        for (const pid of pids) {
-          if (!signaled.has(pid)) adb(["shell", "kill", "-2", pid]);
-          signaled.add(pid);
-        }
-        sleepSync(pollMs);
-      }
-      for (const segment of live) segment.child.kill("SIGTERM");
-    }
-    if (segments.length > 0) adb(["shell", "rm", "-f", ...segments.map((segment) => segment.remotePath)]);
-    for (const localPath of localFiles) fs.rmSync(localPath, { force: true });
-  };
-  const onExit = () => abandon();
-  const signalHandlers = Object.fromEntries(
-    HOST_SIGNALS.map((signal) => [
-      signal,
-      () => {
-        stopping = true;
-        abandon();
-        removeGuards();
-        if (host.listenerCount(signal) === 0) host.kill(host.pid, signal);
-      }
-    ])
-  );
-  const removeGuards = () => {
-    host.removeListener("exit", onExit);
-    for (const signal of HOST_SIGNALS) host.removeListener(signal, signalHandlers[signal]);
-  };
-  host.once("exit", onExit);
-  for (const signal of HOST_SIGNALS) host.once(signal, signalHandlers[signal]);
-  try {
-    await startSegment();
-  } catch (error) {
-    stopping = true;
-    abandon();
-    removeGuards();
-    throw error;
-  }
-  let stopped = false;
-  return {
-    async stop() {
-      if (stopped) throw new Error(`Android screen recording on ${serial} was already stopped.`);
-      stopped = true;
-      stopping = true;
-      const stagingDir = path.dirname(request.outputPath);
-      try {
-        await chain;
-        const tail = segments.at(-1);
-        if (tail.stoppedAtUnixMs === void 0 && tail.pid) adb(["shell", "kill", "-2", tail.pid]);
-        if (!await settles(tail.exited, options.stopTimeoutMs ?? STOP_TIMEOUT_MS)) {
-          tail.killed = true;
-          tail.child.kill("SIGKILL");
-          throw new Error(`Android screenrecord on ${serial} did not stop within ${options.stopTimeoutMs ?? STOP_TIMEOUT_MS}ms.`);
-        }
-        const kept = interruption ? segments.filter((segment) => segment.exitCode === 0) : tail.exitCode === 0 ? segments : segments.slice(0, -1);
-        if (kept.length === 0) {
-          throw recordingFailure(interruption ? "RECORDER_INTERRUPTED" : "RECORDING_FAILED", interruption ?? segmentFailure(tail));
-        }
-        fs.mkdirSync(stagingDir, { recursive: true });
-        const recorded = [];
-        for (const [index, segment] of kept.entries()) {
-          const localPath = path.join(stagingDir, `${path.basename(request.outputPath)}.segment-${index}.mp4`);
-          localFiles.add(localPath);
-          const pull = adb(["pull", segment.remotePath, localPath]);
-          if (pull.status !== 0) throw new Error(`Could not pull Android recording from ${serial}: ${failure(pull)}`);
-          const bytes = fs.statSync(localPath).size;
-          if (bytes > 0) recorded.push({ ...segment, localPath, bytes });
-        }
-        if (recorded.length === 0) throw recordingFailure("RECORDING_FAILED", `Android recording output is empty: ${request.outputPath}`);
-        const startedAtUnixMs = recorded[0].startedAtUnixMs;
-        const placed = recorded.map((segment) => ({ ...segment, offsetMs: segment.startedAtUnixMs - startedAtUnixMs }));
-        const timingEvidencePath = `${path.basename(request.outputPath)}.segments.json`;
-        fs.writeFileSync(path.join(stagingDir, timingEvidencePath), `${JSON.stringify({
-          recorder: "adb-screenrecord",
-          serial,
-          segments: placed.map(({ offsetMs, startedAtUnixMs: startedAtUnixMs2, stoppedAtUnixMs, bytes }) => ({
-            offsetMs,
-            startedAtUnixMs: startedAtUnixMs2,
-            stoppedAtUnixMs,
-            bytes
-          }))
-        })}
-`);
-        const recorder = { name: "adb-screenrecord", platform: "android", target: { selector: "adb-serial", value: serial } };
-        const originals = await Promise.all(recorded.map(async (segment, index) => ({
-          path: path.basename(segment.localPath),
-          ...index > 0 ? { gapBefore: true } : {},
-          ...await optionalVideoTiming(segment.localPath, {
-            startedAtUnixMs: segment.startedAtUnixMs,
-            stoppedAtUnixMs: segment.stoppedAtUnixMs
-          }),
-          timingEvidencePath,
-          recorder
-        })));
-        for (const segment of recorded) localFiles.delete(segment.localPath);
-        return {
-          segments: originals,
-          ...interruption ? { interruption: {
-            frames: originals.reduce((sum, segment) => sum + (segment.timing?.framesMs.length ?? 0), 0),
-            mediaTimeMs: placed.at(-1).offsetMs + (originals.at(-1).timing?.framesMs.at(-1) ?? 0),
-            cause: interruption
-          } } : {}
-        };
-      } finally {
-        abandon();
-        removeGuards();
-      }
-    }
-  };
-}
-function ffmpegPath() {
-  return process.env.FFMPEG_PATH || "ffmpeg";
-}
-function screenrecordPids(adb) {
-  const result = adb(["shell", "pidof", "screenrecord"]);
-  if (result.status !== 0) return [];
-  return result.stdout.trim().split(/\s+/u).filter(Boolean);
-}
-function settles(promise, ms) {
-  return new Promise((resolve) => {
-    const timer = setTimeout(() => resolve(false), ms);
-    void promise.then(() => {
-      clearTimeout(timer);
-      resolve(true);
-    });
-  });
-}
-function failure(result) {
-  return result.error?.message || result.stderr?.trim() || result.stdout?.trim() || `exit ${result.status ?? "unknown"}`;
-}
-function sleepSync(ms) {
-  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
-function delay(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-export {
-  createAndroidScreenrecordRecorder
-};