@deeeed/metamask-harness 0.19.1 → 0.20.0

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",
@@ -1743,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": {
@@ -2104,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": [
@@ -2144,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.",
@@ -2234,15 +2265,24 @@
               "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": "number",
-            "default": 10,
-            "description": "Small testnet USD notional used only when creating a missing open order."
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Alias for amount."
           },
           "leverage": {
             "type": "number",

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.1",
+  "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.1",
+    "@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 ;;