@deeeed/metamask-harness 0.19.0 → 0.20.0

package/library/manifests/extension.action-manifest.json

@@ -220,7 +220,7 @@
       ]
     },
     "ui.navigate": {
-      "description": "Navigate with either raw extension url/hash/path or a small stable page alias. Discover supported aliases here before hardcoding routes.",
+      "description": "Navigate by semantic page intent when available; the adapter uses the current visible UI or a verified route. Raw url/hash/path values must be verified against the current app first.",
       "schema": {
         "type": "object",
         "properties": {
@@ -257,14 +257,16 @@
             "type": "object"
           },
           "timeout_ms": {
-            "type": "number"
+            "type": "number",
+            "default": 20000,
+            "description": "Maximum time to discover and verify the requested page intent."
           }
         },
         "additionalProperties": false
       },
       "examples": [
         {
-          "description": "Open Perps through the stable alias",
+          "description": "Ask the adapter to discover and open the current Perps entry point",
           "node": {
             "action": "ui.navigate",
             "page": "perps",
@@ -272,7 +274,7 @@
           }
         },
         {
-          "description": "Open a Perps market through the stable alias",
+          "description": "Open a Perps market through the current verified adapter path",
           "node": {
             "action": "ui.navigate",
             "page": "perps-market",
@@ -281,7 +283,7 @@
           }
         },
         {
-          "description": "Fallback to a raw extension hash when no alias exists",
+          "description": "Use a raw extension hash only after verifying it in the current app",
           "node": {
             "action": "ui.navigate",
             "hash": "#/perps-home",
@@ -782,7 +784,11 @@
             "type": "string"
           },
           "value": {
-            "type": "string"
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Text or a typed numeric recipe parameter; numbers are entered as their decimal text."
           },
           "text": {
             "type": "string"
@@ -1602,17 +1608,23 @@
               "long",
               "short"
             ],
-            "description": "Optional position/order side filter."
+            "description": "Required order direction."
           },
           "timeout_ms": {
             "type": "number"
           },
           "amount": {
-            "type": "string",
+            "type": [
+              "string",
+              "number"
+            ],
             "description": "USD amount/notional alias."
           },
           "notional": {
-            "type": "string",
+            "type": [
+              "string",
+              "number"
+            ],
             "description": "USD notional alias."
           },
           "size": {
@@ -1963,11 +1975,25 @@
               "long",
               "short"
             ],
-            "description": "Optional position/order side filter."
+            "description": "Required when state=open/present; otherwise filters selected positions."
           },
           "timeout_ms": {
             "type": "number"
           },
+          "amount": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Explicit USD notional used only when creating a missing open position. Alias: notional."
+          },
+          "notional": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Alias for amount."
+          },
           "state": {
             "type": "string",
             "enum": [
@@ -2003,6 +2029,17 @@
             "mode": "all",
             "intent": "Converge Perps positions to the requested state"
           }
+        },
+        {
+          "description": "Ensure one ETH long position exists",
+          "node": {
+            "action": "metamask.perps.ensure_positions",
+            "market": "ETH",
+            "side": "long",
+            "state": "open",
+            "notional": "10",
+            "intent": "Converge ETH positions to one explicit testnet precondition"
+          }
         }
       ],
       "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
@@ -2015,7 +2052,7 @@
     {
       "name": "metamask.perps.ensure_orders",
       "owner": "metamask",
-      "description": "extension Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Higher-level wrapper that reads selected orders, cancels when needed, then asserts final order state.",
+      "description": "extension Converge selected testnet orders to open or absent, then independently assert the final state. Creating an open state uses a resting limit order.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2093,11 +2130,30 @@
               "long",
               "short"
             ],
-            "description": "Optional position/order side filter."
+            "description": "Required when state=open/present; otherwise filters selected orders."
           },
           "timeout_ms": {
             "type": "number"
           },
+          "amount": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Explicit USD notional used only when creating a missing open order. Alias: notional."
+          },
+          "notional": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Alias for amount."
+          },
+          "leverage": {
+            "type": "number",
+            "default": 3,
+            "description": "Testnet leverage used only when creating a missing open order."
+          },
           "state": {
             "type": "string",
             "enum": [
@@ -2124,6 +2180,18 @@
             "mode": "all",
             "intent": "Converge Perps orders to the requested state"
           }
+        },
+        {
+          "description": "Ensure one small resting ETH short order exists",
+          "node": {
+            "action": "metamask.perps.ensure_orders",
+            "market": "ETH",
+            "side": "short",
+            "state": "open",
+            "notional": 10,
+            "leverage": 2,
+            "intent": "Converge ETH open orders to one deterministic testnet precondition"
+          }
         }
       ],
       "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",

package/library/manifests/mobile.action-manifest.json

@@ -221,7 +221,7 @@
       ]
     },
     "ui.navigate": {
-      "description": "Navigate with either raw React Navigation route/screen params or a small stable page alias. Discover supported aliases here before hardcoding routes.",
+      "description": "Navigate by semantic page intent through the adapter-owned current route mapping, then verify the live destination. Route drift fails loudly; raw route/screen params must be verified against the current app first.",
       "schema": {
         "type": "object",
         "properties": {
@@ -265,7 +265,7 @@
       },
       "examples": [
         {
-          "description": "Open Perps through the stable alias",
+          "description": "Ask the adapter to open the current Perps entry point",
           "node": {
             "action": "ui.navigate",
             "page": "perps",
@@ -273,7 +273,7 @@
           }
         },
         {
-          "description": "Open a Perps market through the stable alias",
+          "description": "Open a Perps market through the current verified adapter path",
           "node": {
             "action": "ui.navigate",
             "page": "perps-market",
@@ -282,7 +282,7 @@
           }
         },
         {
-          "description": "Fallback to a raw React Navigation route when no alias exists",
+          "description": "Use a raw React Navigation route only after verifying it in the current app",
           "node": {
             "action": "ui.navigate",
             "route": "PerpsMarketListView",
@@ -316,6 +316,10 @@
           },
           "settle": {
             "type": "boolean"
+          },
+          "long_press": {
+            "type": "boolean",
+            "description": "Invoke the target component's long-press gesture. Requires identifier targeting."
           }
         },
         "additionalProperties": false
@@ -336,6 +340,15 @@
             "text": "Ethereum",
             "intent": "Press the component containing the visible Ethereum label"
           }
+        },
+        {
+          "description": "Long-press a component by stable React Native testID",
+          "node": {
+            "action": "ui.press",
+            "test_id": "keypad-delete-button",
+            "long_press": true,
+            "intent": "Clear the current keypad value through its human reset gesture"
+          }
         }
       ]
     },
@@ -1730,17 +1743,23 @@
               "long",
               "short"
             ],
-            "description": "Optional position/order side filter."
+            "description": "Required order direction."
           },
           "timeout_ms": {
             "type": "number"
           },
           "amount": {
-            "type": "string",
+            "type": [
+              "string",
+              "number"
+            ],
             "description": "USD amount/notional alias."
           },
           "notional": {
-            "type": "string",
+            "type": [
+              "string",
+              "number"
+            ],
             "description": "USD notional alias."
           },
           "size": {
@@ -2091,11 +2110,25 @@
               "long",
               "short"
             ],
-            "description": "Optional position/order side filter."
+            "description": "Required when state=open/present; otherwise filters selected positions."
           },
           "timeout_ms": {
             "type": "number"
           },
+          "amount": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Explicit USD notional used only when creating a missing open position. Alias: notional."
+          },
+          "notional": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Alias for amount."
+          },
           "state": {
             "type": "string",
             "enum": [
@@ -2131,6 +2164,17 @@
             "mode": "all",
             "intent": "Converge Perps positions to the requested state"
           }
+        },
+        {
+          "description": "Ensure one ETH long position exists",
+          "node": {
+            "action": "metamask.perps.ensure_positions",
+            "market": "ETH",
+            "side": "long",
+            "state": "open",
+            "notional": "10",
+            "intent": "Converge ETH positions to one explicit testnet precondition"
+          }
         }
       ],
       "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
@@ -2143,7 +2187,7 @@
     {
       "name": "metamask.perps.ensure_orders",
       "owner": "metamask",
-      "description": "mobile Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Higher-level wrapper that reads selected orders, cancels when needed, then asserts final order state.",
+      "description": "mobile Converge selected testnet orders to open or absent, then independently assert the final state. Creating an open state uses a resting limit order.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2221,11 +2265,30 @@
               "long",
               "short"
             ],
-            "description": "Optional position/order side filter."
+            "description": "Required when state=open/present; otherwise filters selected orders."
           },
           "timeout_ms": {
             "type": "number"
           },
+          "amount": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Explicit USD notional used only when creating a missing open order. Alias: notional."
+          },
+          "notional": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Alias for amount."
+          },
+          "leverage": {
+            "type": "number",
+            "default": 3,
+            "description": "Testnet leverage used only when creating a missing open order."
+          },
           "state": {
             "type": "string",
             "enum": [
@@ -2252,6 +2315,18 @@
             "mode": "all",
             "intent": "Converge Perps orders to the requested state"
           }
+        },
+        {
+          "description": "Ensure one small resting ETH short order exists",
+          "node": {
+            "action": "metamask.perps.ensure_orders",
+            "market": "ETH",
+            "side": "short",
+            "state": "open",
+            "notional": 10,
+            "leverage": 2,
+            "intent": "Converge ETH open orders to one deterministic testnet precondition"
+          }
         }
       ],
       "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",

package/library/recipes/perps/lifecycle.recipe.json

@@ -40,20 +40,14 @@
         "action": "ui.navigate",
         "intent": "Show the Perps home surface",
         "next": "navigate-market",
-        "route": "PerpsMarketListView",
-        "hash": "#/?tab=perps"
+        "page": "perps"
       },
       "navigate-market": {
         "action": "ui.navigate",
         "intent": "Show the ETH Perps market details",
         "next": "start-state",
-        "route": "PerpsMarketDetails",
-        "params": {
-          "market": {
-            "symbol": "ETH"
-          }
-        },
-        "hash": "#/perps/market/ETH"
+        "page": "perps-market",
+        "market": "ETH"
       },
       "start-state": {
         "action": "metamask.perps.start_state",

package/library/recipes/runner/action-validation.extension.recipe.json

@@ -116,7 +116,7 @@
         "action": "ui.navigate",
         "next": "ui-wait-perps",
         "intent": "Open the Perps tab",
-        "hash": "#/?tab=perps"
+        "page": "perps"
       },
       "ui-wait-perps": {
         "action": "ui.wait_for",
@@ -148,19 +148,20 @@
         "action": "ui.navigate",
         "next": "perps-navigate-home",
         "intent": "Show the Perps home surface",
-        "hash": "#/?tab=perps"
+        "page": "perps"
       },
       "perps-navigate-home": {
         "action": "ui.navigate",
         "next": "perps-navigate-market",
         "intent": "Show the Perps home surface",
-        "hash": "#/?tab=perps"
+        "page": "perps"
       },
       "perps-navigate-market": {
         "action": "ui.navigate",
         "next": "start-state",
         "intent": "Show the ETH Perps market details",
-        "hash": "#/perps/market/ETH"
+        "page": "perps-market",
+        "market": "ETH"
       },
       "ensure-clean": {
         "action": "metamask.perps.ensure_positions",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -19,9 +19,10 @@
     "check:syntax": "find . -name '*.mjs' -print0 | xargs -0 -n1 node --check"
   },
   "dependencies": {
-    "@farmslot/agent-runtime": "^0.2.0",
-    "@farmslot/protocol": "^0.11.0",
-    "@farmslot/recipe-harness": "^0.9.0",
+    "@farmslot/agent-runtime": "^0.3.0",
+    "@farmslot/handoff": "^0.3.1",
+    "@farmslot/protocol": "^0.11.1",
+    "@farmslot/recipe-harness": "^0.9.4",
     "commander": "^12.0.0",
     "es-module-lexer": "2.3.1",
     "esbuild": "0.28.1",

package/scripts/completions.sh

@@ -77,7 +77,7 @@ if [ -n "${BASH_VERSION:-}" ]; then
     case "$cmd" in
       launch)      [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "ios android" -- "$cur")) ;;
       fixtures)    [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "init sync set generate finalize" -- "$cur")) ;;
-      checklist)   [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "mark" -- "$cur")) ;;
+      checklist)   [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "mark closeout" -- "$cur")) ;;
       completions) [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "install bash zsh status" -- "$cur")) ;;
       call)        [ "$cword" -eq 2 ] && COMPREPLY=($(compgen -W "$(_mmh_actions)" -- "$cur")) ;;
       run)         COMPREPLY=($(compgen -f -- "$cur"; compgen -W "$(_mmh_recipes)" -- "$cur")) ;;
@@ -111,7 +111,7 @@ if [ -n "${ZSH_VERSION:-}" ]; then
     case "$cmd" in
       launch)      (( CURRENT == 3 )) && { candidates=(ios android); compadd -a candidates; } ;;
       fixtures)    (( CURRENT == 3 )) && { candidates=(init sync set generate finalize); compadd -a candidates; } ;;
-      checklist)   (( CURRENT == 3 )) && { candidates=(mark); compadd -a candidates; } ;;
+      checklist)   (( CURRENT == 3 )) && { candidates=(mark closeout); compadd -a candidates; } ;;
       completions) (( CURRENT == 3 )) && { candidates=(install bash zsh status); compadd -a candidates; } ;;
       call)        (( CURRENT == 3 )) && { candidates=("${(@f)$(_mmh_actions)}"); compadd -a candidates; } ;;
       run)         candidates=("${(@f)$(_mmh_recipes)}"); compadd -a candidates; _files ;;