@deeeed/metamask-harness 0.47.2 → 0.47.3

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.47.3 - 2026-09-05
+
+### Fixed
+
+- Select the requested Mobile Perps mode through the first-entry chooser, verify its detail root, and restore the requested market after mode selection changes the navigation stack.
+- Preserve earlier `call` evidence by assigning each invocation a fresh default artifact directory; approval retries still use the explicit directory in the printed next command.
+
+### Changed
+
+- Teach authors to inspect existing state and limit setup mutations to prerequisites required by their proof.
+
 ## 0.47.2 - 2026-09-05
 
 ### Changed

package/adapters/mobile/bridge-runtime/cdp-bridge.cjs

@@ -195,6 +195,7 @@ const NESTED_ROUTE_PARENTS = {
   PerpsPnlHeroCard: 'Perps', PerpsHIP3Debug: 'Perps',
   PerpsSelectModifyAction: 'Perps', PerpsSelectAdjustMarginAction: 'Perps',
   PerpsSelectOrderType: 'Perps', PerpsTradingView: 'Perps',
+  PerpsModeSelection: 'PerpsModals',
   // Predict
   PredictMarketList: 'Predict', PredictMarketDetails: 'Predict',
   PredictActivityDetail: 'Predict',

package/dist/commands/call.js

@@ -1,5 +1,5 @@
 import fs from "node:fs";
-import { createHash } from "node:crypto";
+import { randomUUID } from "node:crypto";
 import path from "node:path";
 import { resolveActionManifest } from "../manifest.js";
 import { importRecipeProtocol } from "../paths.js";
@@ -212,7 +212,7 @@ async function handleCall(argv) {
     }
     return EXIT.validation;
   }
-  const artifactsDir = optionString(options, "artifactsDir") ?? defaultCallArtifactsDir(target, resolvedAction, args);
+  const artifactsDir = optionString(options, "artifactsDir") ?? defaultCallArtifactsDir(target, resolvedAction);
   recordCommandEvidence(artifactsDir);
   const requestedRuntimeOptions = runtimeOptionsFromCli(options);
   const inheritedSource = process.env.FARMSLOT_RECIPE_SOURCE_TRUST || process.env.FARMSLOT_RECIPE_SOURCE_KIND || process.env.FARMSLOT_RECIPE_SOURCE_NAME || process.env.FARMSLOT_RECIPE_SOURCE_DIGEST;
@@ -493,10 +493,9 @@ function renderDefaultsUsed(defaults, stream) {
   const values = Object.entries(defaults).map(([name, value]) => `${out("cmd", name)}=${out("accent", JSON.stringify(value) ?? String(value))}`).join(", ");
   return `${out("label", "Defaults used:")} ${values}`;
 }
-function defaultCallArtifactsDir(target, action, args) {
+function defaultCallArtifactsDir(target, action) {
   const actionStem = action.replace(/[^a-zA-Z0-9._-]/gu, "_");
-  const digest = createHash("sha256").update(JSON.stringify({ action, args })).digest("hex").slice(0, 12);
-  return path.join(target, "temp", "recipe", "calls", `${actionStem}-${digest}`);
+  return path.join(target, "temp", "recipe", "calls", `${actionStem}-${randomUUID()}`);
 }
 function readCallOutput(tracePath) {
   try {

package/library/actions/mobile/perps/perps.mjs

@@ -131,7 +131,7 @@ function withRemainingDeadline(input, requestedDeadline, attemptTimeoutMs) {
   };
 }
 
-async function isModePresent(input, mode, deadline) {
+async function queryModeState(input, mode, deadline) {
   const rootTarget = JSON.stringify({
     testId: MODE_ROOT_TEST_IDS[mode],
     visibility: 'viewport',
@@ -140,6 +140,10 @@ async function isModePresent(input, mode, deadline) {
     testId: MODE_TEST_IDS[mode],
     visibility: 'tree',
   });
+  const choiceTarget = JSON.stringify({
+    testId: `perps-mode-selection-${mode}-option`,
+    visibility: 'viewport',
+  });
   const result = await evalAsync(
     withRemainingDeadline(input, deadline, READ_ATTEMPT_TIMEOUT_MS),
     `(function(){
@@ -149,21 +153,25 @@ async function isModePresent(input, mode, deadline) {
       }
       return Promise.all([
         api.queryUiTarget(${rootTarget}),
-        api.queryUiTarget(${controlTarget})
+        api.queryUiTarget(${controlTarget}),
+        api.queryUiTarget(${choiceTarget})
       ]).then(function(values){
-        return JSON.stringify({ root: values[0], control: values[1] });
+        return JSON.stringify({ root: values[0], control: values[1], choice: values[2] });
       });
     })()`,
   );
   if (result?.unsupported) {
     throw new Error('metamask.perps.ensure_mode requires UI target queries.');
   }
-  return result?.root?.visible === true && result?.control?.present === true;
+  return {
+    present: result?.root?.visible === true && result?.control?.present === true,
+    choiceVisible: result?.choice?.visible === true,
+  };
 }
 
-async function readModePresence(input, mode, deadline) {
+async function readModeState(input, mode, deadline) {
   try {
-    return await isModePresent(input, mode, deadline);
+    return await queryModeState(input, mode, deadline);
   } catch (error) {
     if (!isTargetTransition(error)) throw error;
     return null;
@@ -181,14 +189,15 @@ export async function ensureMode(input) {
     Number(input.node?.timeout_ms ?? 30_000),
   );
   let switched = false;
+  let choiceSelected = false;
 
   while (Date.now() < deadline) {
-    const requestedModePresent = await readModePresence(
+    const requestedState = await readModeState(
       input,
       requestedMode,
       deadline,
     );
-    if (requestedModePresent) {
+    if (requestedState?.present && !requestedState.choiceVisible) {
       return {
         action: input.action,
         mode: requestedMode,
@@ -197,13 +206,23 @@ export async function ensureMode(input) {
       };
     }
     if (Date.now() >= deadline) break;
-    if (requestedModePresent !== null && !switched) {
-      const otherModePresent = await readModePresence(
+    if (requestedState?.choiceVisible && !choiceSelected) {
+      const pressed = await bridgeCommand(withRemainingDeadline(input, deadline), [
+        'press-test-id',
+        `perps-mode-selection-${requestedMode}-option`,
+      ]);
+      if (pressed?.ok === false) {
+        throw new Error(String(pressed.error || 'Perps mode choice press failed.'));
+      }
+      choiceSelected = true;
+      switched = true;
+    } else if (requestedState !== null && !switched) {
+      const otherState = await readModeState(
         input,
         otherMode,
         deadline,
       );
-      if (otherModePresent && Date.now() < deadline) {
+      if (otherState?.present && Date.now() < deadline) {
         // The visible control names the mode it will switch to, not the mode
         // currently selected.
         const pressed = await bridgeCommand(withRemainingDeadline(input, deadline), [
@@ -1818,7 +1837,7 @@ export async function startState(input) {
   const navigation = await applyStateNavigation(stateInput(), config);
   const provider = await ensureProvider(stateInput(), config);
   const network = await ensureNetwork(stateInput(), config);
-  const resolvedNavigation = provider.changed || network.changed
+  let resolvedNavigation = provider.changed || network.changed
     ? await applyStateNavigation(stateInput(), config)
     : navigation;
   const modeInput = stateInput();
@@ -1833,6 +1852,9 @@ export async function startState(input) {
         },
       })
     : { skipped: true };
+  if (marketMode.alreadySelected === false) {
+    resolvedNavigation = await applyStateNavigation(stateInput(), config);
+  }
   const tutorial = await applyTutorialState(stateInput(), config);
   const readyToTrade = await assertReadyToTrade(stateInput(), config);
   const balance = await assertBalance(stateInput(), config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.47.2",
+  "version": "0.47.3",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"

package/site/assets/help-recipes.json

@@ -52,6 +52,7 @@
       "instruction": "Use static call references for unchanged sub-journeys. Keep preparation, action, assertion, evidence, and guaranteed teardown visible as separate nodes with human-facing intent.",
       "details": [
         "Use idempotent ensure actions for required start state and independently assert their postconditions.",
+        "Inspect existing state before creating or cleaning fixtures. Establish only prerequisites required by the claim; a history or display check may already have usable records and need no trade or cleanup. Record the selected records and verify they still satisfy the proof boundary.",
         "Actions translate stable UI, CDP, or controller operations. Recipes compose them. Product code owns business rules."
       ],
       "commands": []