npm - @deeeed/metamask-harness - Versions diffs - 0.34.0 → 0.34.2 - Mend

@deeeed/metamask-harness 0.34.0 → 0.34.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (33) hide show

package/CHANGELOG.md +29 -0
package/adapters/manifest.json +0 -8
package/adapters/mobile/bridge-runtime/cdp-bridge.cjs +236 -3
package/adapters/mobile/bridge-runtime/console-forwarder.cjs +22 -1
package/adapters/mobile/bridge-runtime/lib/target-discovery.cjs +22 -15
package/adapters/mobile/bridge-runtime/lib/ws-client.cjs +18 -0
package/adapters/mobile/launch-metro.cjs +6 -4
package/adapters/mobile/open-device.sh +170 -19
package/adapters/mobile/start-metro.sh +165 -93
package/adapters/mobile/stop-metro.sh +1 -0
package/dist/adapters/mobile/prepare.js +1 -4
package/dist/adapters/mobile/video-recorder.js +12 -10
package/dist/adapters.js +134 -6
package/dist/commands/launch/index.js +9 -0
package/dist/commands/launch/mobile.js +17 -3
package/dist/live-adapter-contract.js +10 -3
package/dist/recipe-security.js +2 -0
package/dist/runner.js +53 -8
package/dist/runtime-context.js +1 -0
package/library/actions/mobile/perps/measure_homepage_visible.mjs +4 -0
package/library/actions/mobile/perps/performance-capture.mjs +579 -111
package/library/actions/mobile/perps/perps.mjs +221 -38
package/library/actions/mobile/perps/prepare_local_snapshot_endpoint.mjs +58 -0
package/library/actions/mobile/platform/bridge.mjs +102 -8
package/library/actions/mobile/wallet/ensure_unlocked.mjs +35 -8
package/library/manifests/mobile.action-manifest.json +243 -511
package/library/recipes/mobile/perps/performance.homepage.android-cold-disk-cache.recipe.json +20 -2
package/library/recipes/mobile/perps/performance.homepage.android-cold-no-cache.recipe.json +2 -0
package/library/recipes/mobile/perps/performance.homepage.cold-position-sample.recipe.json +120 -0
package/library/recipes/mobile/perps/performance.homepage.ios-background-reconnect.recipe.json +7 -6
package/library/recipes/mobile/perps/performance.homepage.ios-cold-no-cache.recipe.json +5 -5
package/package.json +1 -1
package/adapters/mobile/metro-config.cjs +0 -93

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

@@ -77,9 +77,7 @@
             "type": "string"
           }
         },
-        "required": [
-          "path"
-        ],
+        "required": ["path"],
         "additionalProperties": false
       }
     },
@@ -123,13 +121,7 @@
                   "array"
                 ],
                 "items": {
-                  "type": [
-                    "string",
-                    "number",
-                    "integer",
-                    "boolean",
-                    "object"
-                  ]
+                  "type": ["string", "number", "integer", "boolean", "object"]
                 }
               },
               "all": {
@@ -154,10 +146,7 @@
             "additionalProperties": false
           }
         },
-        "required": [
-          "path",
-          "assert"
-        ],
+        "required": ["path", "assert"],
         "additionalProperties": false
       }
     },
@@ -237,13 +226,7 @@
                   "array"
                 ],
                 "items": {
-                  "type": [
-                    "string",
-                    "number",
-                    "integer",
-                    "boolean",
-                    "object"
-                  ]
+                  "type": ["string", "number", "integer", "boolean", "object"]
                 }
               },
               "all": {
@@ -292,15 +275,10 @@
           },
           "scope": {
             "type": "string",
-            "enum": [
-              "run",
-              "file"
-            ]
+            "enum": ["run", "file"]
           }
         },
-        "required": [
-          "path"
-        ],
+        "required": ["path"],
         "additionalProperties": false
       }
     },
@@ -327,10 +305,7 @@
           "artifacts": {
             "type": "array",
             "items": {
-              "type": [
-                "string",
-                "object"
-              ],
+              "type": ["string", "object"],
               "properties": {
                 "path": {
                   "type": "string"
@@ -364,9 +339,7 @@
             }
           }
         },
-        "required": [
-          "artifacts"
-        ],
+        "required": ["artifacts"],
         "additionalProperties": false
       }
     },
@@ -414,15 +387,10 @@
             "type": "string"
           }
         },
-        "required": [
-          "value",
-          "equals"
-        ],
+        "required": ["value", "equals"],
         "additionalProperties": false
       },
-      "result_cases": [
-        "match"
-      ]
+      "result_cases": ["match"]
     },
     "ui.navigate": {
       "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.",
@@ -431,11 +399,7 @@
         "properties": {
           "page": {
             "type": "string",
-            "enum": [
-              "home",
-              "perps",
-              "perps-market"
-            ]
+            "enum": ["home", "perps", "perps-market"]
           },
           "market": {
             "type": "string"
@@ -559,9 +523,7 @@
             "type": "boolean"
           }
         },
-        "required": [
-          "key"
-        ],
+        "required": ["key"],
         "additionalProperties": false
       },
       "examples": [
@@ -656,6 +618,22 @@
           "offset": {
             "type": "number"
           },
+          "measure_from_test_id": {
+            "type": "string",
+            "description": "Visible start target sampled inside the app immediately before scrolling. Requires exactly one measurement target."
+          },
+          "measure_target_test_id": {
+            "type": "string",
+            "description": "Visible testID whose first in-app observation ends the measured scroll transition. Mutually exclusive with measure_target_text."
+          },
+          "measure_target_text": {
+            "type": "string",
+            "description": "Visible text whose first in-app observation ends the measured scroll transition. Mutually exclusive with measure_target_test_id."
+          },
+          "measure_required_present_test_id": {
+            "type": "string",
+            "description": "Optional React-tree testID that must be present at the same observation as the visible measurement target."
+          },
           "scroll_into_view": {
             "type": "boolean"
           },
@@ -879,13 +857,7 @@
           },
           "expected": {
             "type": "string",
-            "enum": [
-              "present",
-              "visible",
-              "absent",
-              "hidden",
-              "not_present"
-            ]
+            "enum": ["present", "visible", "absent", "hidden", "not_present"]
           },
           "visible": {
             "type": "boolean"
@@ -922,9 +894,7 @@
     },
     "ui.locators": {
       "description": "List ranked, copy-pasteable ui.press targets from the current ui.visible observation. Prefer high-confidence test IDs when updating durable recipe source after exploratory interaction.",
-      "execution_capabilities": [
-        "host-read-export"
-      ],
+      "execution_capabilities": ["host-read-export"],
       "schema": {
         "type": "object",
         "properties": {},
@@ -1045,12 +1015,12 @@
           "runtime_ready_timeout_ms": {
             "type": "integer"
           },
+          "require_process_continuity": {
+            "type": "boolean"
+          },
           "platform": {
             "type": "string",
-            "enum": [
-              "ios",
-              "android"
-            ]
+            "enum": ["ios", "android"]
           },
           "watcher_port": {
             "type": "number"
@@ -1174,11 +1144,7 @@
           },
           "status": {
             "type": "string",
-            "enum": [
-              "running",
-              "pass",
-              "fail"
-            ]
+            "enum": ["running", "pass", "fail"]
           },
           "node_id": {
             "type": "string"
@@ -1285,9 +1251,7 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation"
-      ]
+      "execution_capabilities": ["app-mutation"]
     },
     "metamask.wallet.ensure_unlocked": {
       "description": "Unlock the wallet with the fixture password when it is currently locked.",
@@ -1310,9 +1274,7 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation"
-      ]
+      "execution_capabilities": ["app-mutation"]
     },
     "metamask.wallet.select_account": {
       "description": "mobile action to select a wallet account by address, id, or display name.",
@@ -1353,9 +1315,7 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation"
-      ]
+      "execution_capabilities": ["app-mutation"]
     },
     "metamask.wallet.list_accounts": {
       "description": "List redacted wallet accounts and identify the selected account without mutating the app.",
@@ -1365,12 +1325,7 @@
           "scope": {
             "type": "string",
             "default": "named",
-            "enum": [
-              "selected",
-              "named",
-              "evm",
-              "all"
-            ],
+            "enum": ["selected", "named", "evm", "all"],
             "description": "Account scope. Defaults to named human-visible accounts; use selected for the active account, evm for EVM accounts, or all for the full inventory."
           }
         },
@@ -1430,10 +1385,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ],
+            "enum": ["matching", "all"],
             "description": "matching selects requested symbols; all selects every live item returned by the product."
           },
           "selector": {
@@ -1441,10 +1393,7 @@
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -1466,20 +1415,14 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               }
             },
             "additionalProperties": false
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
+            "enum": ["long", "short"],
             "description": "Optional position/order side filter."
           },
           "timeout_ms": {
@@ -1527,10 +1470,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ],
+            "enum": ["matching", "all"],
             "description": "matching selects requested symbols; all selects every live item returned by the product."
           },
           "selector": {
@@ -1538,10 +1478,7 @@
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -1563,20 +1500,14 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               }
             },
             "additionalProperties": false
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
+            "enum": ["long", "short"],
             "description": "Optional position/order side filter."
           },
           "timeout_ms": {
@@ -1624,10 +1555,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ],
+            "enum": ["matching", "all"],
             "description": "matching selects requested symbols; all selects every live item returned by the product."
           },
           "selector": {
@@ -1635,10 +1563,7 @@
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -1660,20 +1585,14 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               }
             },
             "additionalProperties": false
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
+            "enum": ["long", "short"],
             "description": "Optional position/order side filter."
           },
           "timeout_ms": {
@@ -1691,18 +1610,12 @@
         },
         {
           "action": "metamask.perps.close_positions",
-          "markets": [
-            "BTC",
-            "ETH"
-          ],
+          "markets": ["BTC", "ETH"],
           "intent": "Close selected Perps positions before continuing",
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
+      "execution_capabilities": ["app-mutation", "external-mutation"]
     },
     "metamask.perps.close_orders": {
       "description": "mobile Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Cancel selected live Perps open orders. Use selector/mode params to cancel matching symbols or all orders.",
@@ -1733,10 +1646,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ],
+            "enum": ["matching", "all"],
             "description": "matching selects requested symbols; all selects every live item returned by the product."
           },
           "selector": {
@@ -1744,10 +1654,7 @@
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -1769,20 +1676,14 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               }
             },
             "additionalProperties": false
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
+            "enum": ["long", "short"],
             "description": "Optional position/order side filter."
           },
           "timeout_ms": {
@@ -1805,10 +1706,7 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
+      "execution_capabilities": ["app-mutation", "external-mutation"]
     },
     "metamask.perps.place_order": {
       "description": "mobile Place a Perps order through a supported app/API path. Default to testnet; mainnet order placement requires an explicit user request.",
@@ -1839,10 +1737,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ],
+            "enum": ["matching", "all"],
             "description": "matching selects requested symbols; all selects every live item returned by the product."
           },
           "selector": {
@@ -1850,10 +1745,7 @@
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -1875,37 +1767,25 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               }
             },
             "additionalProperties": false
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
+            "enum": ["long", "short"],
             "description": "Required order direction."
           },
           "timeout_ms": {
             "type": "number"
           },
           "amount": {
-            "type": [
-              "string",
-              "number"
-            ],
+            "type": ["string", "number"],
             "description": "USD amount/notional alias."
           },
           "notional": {
-            "type": [
-              "string",
-              "number"
-            ],
+            "type": ["string", "number"],
             "description": "USD notional alias."
           },
           "size": {
@@ -1930,10 +1810,7 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
+      "execution_capabilities": ["app-mutation", "external-mutation"]
     },
     "metamask.perps.assert_positions": {
       "description": "mobile Assert live Perps positions are present or absent for an explicit market selection or mode=all.",
@@ -1964,10 +1841,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ],
+            "enum": ["matching", "all"],
             "description": "matching selects requested symbols; all selects every live item returned by the product."
           },
           "selector": {
@@ -1975,10 +1849,7 @@
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -2000,20 +1871,14 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               }
             },
             "additionalProperties": false
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
+            "enum": ["long", "short"],
             "description": "Optional position/order side filter."
           },
           "timeout_ms": {
@@ -2021,19 +1886,11 @@
           },
           "state": {
             "type": "string",
-            "enum": [
-              "none",
-              "absent",
-              "closed",
-              "open",
-              "present"
-            ],
+            "enum": ["none", "absent", "closed", "open", "present"],
             "description": "Desired/expected selected collection state."
           }
         },
-        "required": [
-          "state"
-        ],
+        "required": ["state"],
         "additionalProperties": false
       },
       "examples": [
@@ -2076,10 +1933,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ],
+            "enum": ["matching", "all"],
             "description": "matching selects requested symbols; all selects every live item returned by the product."
           },
           "selector": {
@@ -2087,10 +1941,7 @@
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -2112,20 +1963,14 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               }
             },
             "additionalProperties": false
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
+            "enum": ["long", "short"],
             "description": "Optional position/order side filter."
           },
           "timeout_ms": {
@@ -2133,19 +1978,11 @@
           },
           "state": {
             "type": "string",
-            "enum": [
-              "none",
-              "absent",
-              "closed",
-              "open",
-              "present"
-            ],
+            "enum": ["none", "absent", "closed", "open", "present"],
             "description": "Desired/expected selected collection state."
           }
         },
-        "required": [
-          "state"
-        ],
+        "required": ["state"],
         "additionalProperties": false
       },
       "examples": [
@@ -2188,10 +2025,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ],
+            "enum": ["matching", "all"],
             "description": "matching selects requested symbols; all selects every live item returned by the product."
           },
           "selector": {
@@ -2199,10 +2033,7 @@
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -2224,54 +2055,34 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               }
             },
             "additionalProperties": false
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
+            "enum": ["long", "short"],
             "description": "Required when state=open/present; otherwise filters selected positions."
           },
           "timeout_ms": {
             "type": "number"
           },
           "amount": {
-            "type": [
-              "string",
-              "number"
-            ],
+            "type": ["string", "number"],
             "description": "Explicit USD notional used only when creating a missing open position. Alias: notional."
           },
           "notional": {
-            "type": [
-              "string",
-              "number"
-            ],
+            "type": ["string", "number"],
             "description": "Alias for amount."
           },
           "state": {
             "type": "string",
-            "enum": [
-              "none",
-              "absent",
-              "closed",
-              "open",
-              "present"
-            ],
+            "enum": ["none", "absent", "closed", "open", "present"],
             "description": "Desired/expected selected collection state."
           }
         },
-        "required": [
-          "state"
-        ],
+        "required": ["state"],
         "additionalProperties": false
       },
       "examples": [
@@ -2299,10 +2110,7 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
+      "execution_capabilities": ["app-mutation", "external-mutation"]
     },
     "metamask.perps.ensure_orders": {
       "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.",
@@ -2333,10 +2141,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ],
+            "enum": ["matching", "all"],
             "description": "matching selects requested symbols; all selects every live item returned by the product."
           },
           "selector": {
@@ -2344,10 +2149,7 @@
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -2369,37 +2171,25 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               }
             },
             "additionalProperties": false
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
+            "enum": ["long", "short"],
             "description": "Required when state=open/present; otherwise filters selected orders."
           },
           "timeout_ms": {
             "type": "number"
           },
           "amount": {
-            "type": [
-              "string",
-              "number"
-            ],
+            "type": ["string", "number"],
             "description": "Explicit USD notional used only when creating a missing open order. Alias: notional."
           },
           "notional": {
-            "type": [
-              "string",
-              "number"
-            ],
+            "type": ["string", "number"],
             "description": "Alias for amount."
           },
           "leverage": {
@@ -2409,19 +2199,11 @@
           },
           "state": {
             "type": "string",
-            "enum": [
-              "none",
-              "absent",
-              "closed",
-              "open",
-              "present"
-            ],
+            "enum": ["none", "absent", "closed", "open", "present"],
             "description": "Desired/expected selected collection state."
           }
         },
-        "required": [
-          "state"
-        ],
+        "required": ["state"],
         "additionalProperties": false
       },
       "examples": [
@@ -2443,13 +2225,10 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
+      "execution_capabilities": ["app-mutation", "external-mutation"]
     },
     "metamask.perps.capture_performance": {
-      "description": "Capture only run-window [HomepagePerf] DevLogger records and a parsed stage/lifecycle summary for Perps on-device validation.",
+      "description": "Capture run-window [HomepagePerf] and optional [StartupPerf] DevLogger records with parsed Perps on-device validation summaries.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2472,12 +2251,25 @@
               "type": "string"
             }
           },
+          "required_startup_stages": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
           "required_lifecycles": {
             "type": "array",
             "items": {
               "type": "string"
             }
           },
+          "required_fresh_lifecycles": {
+            "type": "array",
+            "description": "Require a demand in each named lifecycle to reach a correlated fresh visible frame; prevents another lifecycle's socket records from satisfying the proof.",
+            "items": {
+              "type": "string"
+            }
+          },
           "required_sources": {
             "type": "array",
             "items": {
@@ -2489,6 +2281,30 @@
             "items": {
               "type": "string"
             }
+          },
+          "require_cache_before_fresh": {
+            "type": "boolean"
+          },
+          "first_fresh_delivery_requirements": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "stream": { "type": "string" },
+                "lifecycle": { "type": "string" },
+                "subscriber_throttle_ms": { "type": "number", "minimum": 0 },
+                "max_socket_to_subscriber_ms": {
+                  "type": "number",
+                  "minimum": 0
+                }
+              },
+              "required": [
+                "stream",
+                "subscriber_throttle_ms",
+                "max_socket_to_subscriber_ms"
+              ],
+              "additionalProperties": false
+            }
           }
         },
         "required": ["phase"],
@@ -2511,6 +2327,59 @@
       ],
       "execution_capabilities": []
     },
+    "metamask.perps.measure_homepage_visible": {
+      "description": "Confirm the existing wallet is usable, then measure Wallet-ready to visible Perps content in one direct-CDP action so recipe-runner gaps are excluded.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "target_timeout_ms": { "type": "number", "minimum": 1 },
+          "unlock_timeout_ms": { "type": "number", "minimum": 1 },
+          "stable_unlocked_ms": { "type": "number", "minimum": 0 },
+          "scroll_test_id": { "type": "string" },
+          "from_test_id": { "type": "string" },
+          "offset": { "type": "number" },
+          "poll_interval_ms": { "type": "number", "minimum": 16 },
+          "visible_event_stage": { "type": "string" },
+          "visible_event_grace_ms": { "type": "number", "minimum": 0 },
+          "animated": { "type": "boolean" },
+          "target_test_id": { "type": "string" },
+          "target_text": { "type": "string" },
+          "required_present_test_id": { "type": "string" },
+          "timeout_ms": { "type": "number", "minimum": 1 }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.measure_homepage_visible",
+          "target_test_id": "homepage-section-title-perps",
+          "required_present_test_id": "homepage-perps-positions",
+          "intent": "Measure Wallet-ready to meaningful Perps content without runner timing",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.perps.prepare_local_snapshot_endpoint": {
+      "description": "Prepare the configurable local Terminal snapshot endpoint for physical Android with adb reverse; iOS Simulator requires no mapping.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "port": { "type": "number", "minimum": 1 }
+        },
+        "required": ["port"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.prepare_local_snapshot_endpoint",
+          "port": 3000,
+          "intent": "Make the configured local Terminal snapshot endpoint reachable",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["app-mutation"]
+    },
     "metamask.perps.clear_performance_caches": {
       "description": "mobile Clear only persisted Perps market/user performance caches in the development app before a cold-no-cache validation run.",
       "schema": {
@@ -2525,9 +2394,7 @@
           "next": "restart-app"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation"
-      ]
+      "execution_capabilities": ["app-mutation"]
     },
     "metamask.perps.start_state": {
       "description": "mobile Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Recommended configurable Perps start state that first restores the fixture-backed unlocked wallet, then composes reusable domain operations before the proof window.",
@@ -2538,6 +2405,16 @@
             "type": "string",
             "description": "Optional profile such as clean_market_testnet, open_position_testnet, open_order_testnet, or provider_mainnet_readonly."
           },
+          "target_timeout_ms": {
+            "type": "number",
+            "minimum": 1,
+            "description": "Bound for the pinned Mobile bridge target to become available before Perps state setup."
+          },
+          "unlock_timeout_ms": {
+            "type": "number",
+            "minimum": 1,
+            "description": "Bound for the fixture-backed wallet unlock within Perps state setup."
+          },
           "account": {
             "type": "string"
           },
@@ -2547,10 +2424,7 @@
           },
           "network": {
             "type": "string",
-            "enum": [
-              "testnet",
-              "mainnet"
-            ]
+            "enum": ["testnet", "mainnet"]
           },
           "market": {
             "type": "string"
@@ -2573,26 +2447,14 @@
           "page": {
             "description": "Initial Perps page target; omit it to use the profile or market default.",
             "type": "string",
-            "enum": [
-              "home",
-              "perps",
-              "perps_home",
-              "market",
-              "market_details"
-            ]
+            "enum": ["home", "perps", "perps_home", "market", "market_details"]
           },
           "positions": {
-            "type": [
-              "object",
-              "boolean"
-            ],
+            "type": ["object", "boolean"],
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -2614,38 +2476,20 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               },
               "state": {
                 "type": "string",
-                "enum": [
-                  "none",
-                  "closed",
-                  "absent",
-                  "open",
-                  "present"
-                ]
+                "enum": ["none", "closed", "absent", "open", "present"]
               },
               "amount": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "notional": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "size": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "leverage": {
                 "type": "number"
@@ -2693,17 +2537,11 @@
             "additionalProperties": false
           },
           "orders": {
-            "type": [
-              "object",
-              "boolean"
-            ],
+            "type": ["object", "boolean"],
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -2725,38 +2563,20 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               },
               "state": {
                 "type": "string",
-                "enum": [
-                  "none",
-                  "closed",
-                  "absent",
-                  "open",
-                  "present"
-                ]
+                "enum": ["none", "closed", "absent", "open", "present"]
               },
               "amount": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "notional": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "size": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "leverage": {
                 "type": "number"
@@ -2813,10 +2633,7 @@
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ]
+            "enum": ["long", "short"]
           },
           "account_name": {
             "type": "string"
@@ -2841,10 +2658,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ]
+            "enum": ["matching", "all"]
           }
         },
         "additionalProperties": false
@@ -2879,10 +2693,7 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
+      "execution_capabilities": ["app-mutation", "external-mutation"]
     },
     "metamask.perps.teardown_state": {
       "description": "mobile Recommended configurable Perps teardown state that restores the selected environment after proof.",
@@ -2902,10 +2713,7 @@
           },
           "network": {
             "type": "string",
-            "enum": [
-              "testnet",
-              "mainnet"
-            ]
+            "enum": ["testnet", "mainnet"]
           },
           "market": {
             "type": "string"
@@ -2927,10 +2735,7 @@
           },
           "page": {
             "description": "Final page target; false skips navigation for teardown.",
-            "type": [
-              "string",
-              "boolean"
-            ],
+            "type": ["string", "boolean"],
             "enum": [
               "home",
               "perps",
@@ -2941,17 +2746,11 @@
             ]
           },
           "positions": {
-            "type": [
-              "object",
-              "boolean"
-            ],
+            "type": ["object", "boolean"],
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -2973,38 +2772,20 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               },
               "state": {
                 "type": "string",
-                "enum": [
-                  "none",
-                  "closed",
-                  "absent",
-                  "open",
-                  "present"
-                ]
+                "enum": ["none", "closed", "absent", "open", "present"]
               },
               "amount": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "notional": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "size": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "leverage": {
                 "type": "number"
@@ -3052,17 +2833,11 @@
             "additionalProperties": false
           },
           "orders": {
-            "type": [
-              "object",
-              "boolean"
-            ],
+            "type": ["object", "boolean"],
             "properties": {
               "mode": {
                 "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
+                "enum": ["matching", "all"]
               },
               "market": {
                 "type": "string"
@@ -3084,38 +2859,20 @@
               },
               "side": {
                 "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
+                "enum": ["long", "short"]
               },
               "state": {
                 "type": "string",
-                "enum": [
-                  "none",
-                  "closed",
-                  "absent",
-                  "open",
-                  "present"
-                ]
+                "enum": ["none", "closed", "absent", "open", "present"]
               },
               "amount": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "notional": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "size": {
-                "type": [
-                  "string",
-                  "number"
-                ]
+                "type": ["string", "number"]
               },
               "leverage": {
                 "type": "number"
@@ -3172,10 +2929,7 @@
           },
           "side": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ]
+            "enum": ["long", "short"]
           },
           "account_name": {
             "type": "string"
@@ -3200,10 +2954,7 @@
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ]
+            "enum": ["matching", "all"]
           }
         },
         "additionalProperties": false
@@ -3229,16 +2980,11 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
+      "execution_capabilities": ["app-mutation", "external-mutation"]
     },
     "metamask.deeplink.open": {
       "description": "Open an HTTPS deeplink through the selected Android device or iOS simulator so Mobile owns parsing and destination navigation.",
-      "execution_capabilities": [
-        "app-mutation"
-      ],
+      "execution_capabilities": ["app-mutation"],
       "examples": [
         {
           "action": "metamask.deeplink.open",
@@ -3259,17 +3005,13 @@
             "description": "Maximum time for the external navigation. Default 15000."
           }
         },
-        "required": [
-          "url"
-        ],
+        "required": ["url"],
         "additionalProperties": false
       }
     },
     "metamask.analytics.start_capture": {
       "description": "mobile Start capturing MetaMetrics events at the Segment transport and return a cursor to bracket later reads.",
-      "execution_capabilities": [
-        "arbitrary-code"
-      ],
+      "execution_capabilities": ["arbitrary-code"],
       "examples": [
         {
           "action": "metamask.analytics.start_capture",
@@ -3293,9 +3035,7 @@
     },
     "metamask.analytics.read_events": {
       "description": "mobile Read MetaMetrics events captured since a cursor, as [{ event, properties, ts }].",
-      "execution_capabilities": [
-        "host-read-export"
-      ],
+      "execution_capabilities": ["host-read-export"],
       "examples": [
         {
           "action": "metamask.analytics.read_events",
@@ -3321,9 +3061,7 @@
     },
     "metamask.analytics.assert_events": {
       "description": "mobile Assert MetaMetrics event names, property values and counts. Counts are the point: an exact count catches a double emit that a presence check cannot.",
-      "execution_capabilities": [
-        "host-read-export"
-      ],
+      "execution_capabilities": ["host-read-export"],
       "examples": [
         {
           "action": "metamask.analytics.assert_events",
@@ -3382,24 +3120,18 @@
                   "description": "Subset match on event properties; values may be exact or use $exists, $type, and $gt predicates."
                 }
               },
-              "required": [
-                "event"
-              ],
+              "required": ["event"],
               "additionalProperties": false
             }
           }
         },
-        "required": [
-          "expect"
-        ],
+        "required": ["expect"],
         "additionalProperties": false
       }
     },
     "metamask.analytics.set_consent": {
       "description": "mobile Set MetaMetrics consent flags through the Security & Privacy controls so events reach the Segment transport.",
-      "execution_capabilities": [
-        "app-mutation"
-      ],
+      "execution_capabilities": ["app-mutation"],
       "examples": [
         {
           "action": "metamask.analytics.set_consent",