@deeeed/metamask-harness 0.38.1 → 0.40.0

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

@@ -432,10 +432,10 @@
           "page": {
             "type": "string",
             "enum": [
-          "back",
-          "home",
-          "network",
-          "perps",
+              "back",
+              "home",
+              "network",
+              "perps",
               "perps-market-list",
               "perps-market",
               "perps-activity",
@@ -445,20 +445,20 @@
           "market": {
             "type": "string"
           },
-      "symbol": {
-        "type": "string"
-      },
-      "network": {
-        "type": "string"
-      },
-      "chain_id": {
-        "type": "integer",
-        "minimum": 1
-      },
-      "add_if_missing": {
-        "type": "boolean",
-        "default": true
-      },
+          "symbol": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string"
+          },
+          "chain_id": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "add_if_missing": {
+            "type": "boolean",
+            "default": true
+          },
           "url": {
             "type": "string"
           },
@@ -545,70 +545,6 @@
         "additionalProperties": false
       }
     },
-    "ui.activate_and_observe": {
-      "description": "Activate a visible Extension control with a selector-derived trusted pointer and observe the resulting transient UI in the same CDP session.",
-      "execution_capabilities": [
-        "host-read-export",
-        "app-mutation",
-        "external-mutation"
-      ],
-      "schema": {
-        "type": "object",
-        "properties": {
-          "selector": {
-            "type": "string"
-          },
-          "test_id": {
-            "type": "string"
-          },
-          "testID": {
-            "type": "string"
-          },
-          "require_test_ids": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 100
-          },
-          "require_text": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 100
-          },
-          "settle_ms": {
-            "type": "integer",
-            "minimum": 0,
-            "default": 250
-          },
-          "timeout_ms": {
-            "type": "integer",
-            "minimum": 1,
-            "default": 10000
-          },
-          "max_items": {
-            "type": "integer",
-            "minimum": 1,
-            "default": 100
-          }
-        },
-        "additionalProperties": false
-      },
-      "examples": [
-        {
-          "action": "ui.activate_and_observe",
-          "test_id": "perps-balance-dropdown-balance",
-          "require_test_ids": [
-            "perps-balance-dropdown-add-funds",
-            "perps-balance-dropdown-withdraw"
-          ],
-          "intent": "Open and prove the transient balance menu.",
-          "next": "done"
-        }
-      ]
-    },
     "ui.key_press": {
       "description": "Send a trusted keyboard press to the currently focused UI element through the UI transport.",
       "schema": {
@@ -750,24 +686,55 @@
         "type": "object",
         "properties": {
           "target": {
-            "type": ["string", "object"],
+            "type": [
+              "string",
+              "object"
+            ],
             "properties": {
-              "x": { "type": "number" },
-              "y": { "type": "number" }
+              "x": {
+                "type": "number"
+              },
+              "y": {
+                "type": "number"
+              }
             },
-            "required": ["x", "y"],
+            "required": [
+              "x",
+              "y"
+            ],
             "additionalProperties": false
           },
           "direction": {
             "type": "string",
-            "enum": ["up", "down", "left", "right"]
+            "enum": [
+              "up",
+              "down",
+              "left",
+              "right"
+            ]
+          },
+          "distance": {
+            "type": "number",
+            "minimum": 1
+          },
+          "duration_ms": {
+            "type": "integer",
+            "minimum": 1
           },
-          "distance": { "type": "number", "minimum": 1 },
-          "duration_ms": { "type": "integer", "minimum": 1 },
-          "timeout_ms": { "type": "integer", "minimum": 1 },
-          "settle": { "type": "boolean" }
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "settle": {
+            "type": "boolean"
+          }
         },
-        "required": ["target", "direction", "distance", "duration_ms"],
+        "required": [
+          "target",
+          "direction",
+          "distance",
+          "duration_ms"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -788,12 +755,22 @@
         "type": "object",
         "properties": {
           "target": {
-            "type": ["string", "object"],
+            "type": [
+              "string",
+              "object"
+            ],
             "properties": {
-              "x": { "type": "number" },
-              "y": { "type": "number" }
+              "x": {
+                "type": "number"
+              },
+              "y": {
+                "type": "number"
+              }
             },
-            "required": ["x", "y"],
+            "required": [
+              "x",
+              "y"
+            ],
             "additionalProperties": false
           },
           "path": {
@@ -802,34 +779,68 @@
             "items": {
               "type": "object",
               "properties": {
-                "x": { "type": "number" },
-                "y": { "type": "number" }
+                "x": {
+                  "type": "number"
+                },
+                "y": {
+                  "type": "number"
+                }
               },
-              "required": ["x", "y"],
+              "required": [
+                "x",
+                "y"
+              ],
               "additionalProperties": false
             }
           },
           "delta": {
             "type": "object",
             "properties": {
-              "x": { "type": "number" },
-              "y": { "type": "number" }
+              "x": {
+                "type": "number"
+              },
+              "y": {
+                "type": "number"
+              }
             },
-            "required": ["x", "y"],
+            "required": [
+              "x",
+              "y"
+            ],
             "additionalProperties": false
           },
-          "duration_ms": { "type": "integer", "minimum": 1 },
-          "timeout_ms": { "type": "integer", "minimum": 1 },
-          "settle": { "type": "boolean" }
+          "duration_ms": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "settle": {
+            "type": "boolean"
+          }
         },
-        "required": ["target", "duration_ms"],
+        "required": [
+          "target",
+          "duration_ms"
+        ],
         "additionalProperties": false
       },
       "examples": [
         {
           "action": "ui.pan",
           "target": "example-surface",
-          "path": [{ "x": 40, "y": 10 }, { "x": 80, "y": 20 }],
+          "path": [
+            {
+              "x": 40,
+              "y": 10
+            },
+            {
+              "x": 80,
+              "y": 20
+            }
+          ],
           "duration_ms": 400,
           "intent": "Pan through the requested pointer path.",
           "next": "done"
@@ -842,12 +853,22 @@
         "type": "object",
         "properties": {
           "target": {
-            "type": ["string", "object"],
+            "type": [
+              "string",
+              "object"
+            ],
             "properties": {
-              "x": { "type": "number" },
-              "y": { "type": "number" }
+              "x": {
+                "type": "number"
+              },
+              "y": {
+                "type": "number"
+              }
             },
-            "required": ["x", "y"],
+            "required": [
+              "x",
+              "y"
+            ],
             "additionalProperties": false
           },
           "path": {
@@ -856,34 +877,62 @@
             "items": {
               "type": "object",
               "properties": {
-                "x": { "type": "number" },
-                "y": { "type": "number" }
+                "x": {
+                  "type": "number"
+                },
+                "y": {
+                  "type": "number"
+                }
               },
-              "required": ["x", "y"],
+              "required": [
+                "x",
+                "y"
+              ],
               "additionalProperties": false
             }
           },
           "delta": {
             "type": "object",
             "properties": {
-              "x": { "type": "number" },
-              "y": { "type": "number" }
+              "x": {
+                "type": "number"
+              },
+              "y": {
+                "type": "number"
+              }
             },
-            "required": ["x", "y"],
+            "required": [
+              "x",
+              "y"
+            ],
             "additionalProperties": false
           },
-          "duration_ms": { "type": "integer", "minimum": 1 },
-          "timeout_ms": { "type": "integer", "minimum": 1 },
-          "settle": { "type": "boolean" }
+          "duration_ms": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "settle": {
+            "type": "boolean"
+          }
         },
-        "required": ["target", "duration_ms"],
+        "required": [
+          "target",
+          "duration_ms"
+        ],
         "additionalProperties": false
       },
       "examples": [
         {
           "action": "ui.drag",
           "target": "example-slider",
-          "delta": { "x": 120, "y": 0 },
+          "delta": {
+            "x": 120,
+            "y": 0
+          },
           "duration_ms": 500,
           "intent": "Drag the requested control to a new value.",
           "next": "done"
@@ -896,19 +945,40 @@
         "type": "object",
         "properties": {
           "target": {
-            "type": ["string", "object"],
+            "type": [
+              "string",
+              "object"
+            ],
             "properties": {
-              "x": { "type": "number" },
-              "y": { "type": "number" }
+              "x": {
+                "type": "number"
+              },
+              "y": {
+                "type": "number"
+              }
             },
-            "required": ["x", "y"],
+            "required": [
+              "x",
+              "y"
+            ],
             "additionalProperties": false
           },
-          "hold_ms": { "type": "integer", "minimum": 1 },
-          "timeout_ms": { "type": "integer", "minimum": 1 },
-          "settle": { "type": "boolean" }
+          "hold_ms": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "settle": {
+            "type": "boolean"
+          }
         },
-        "required": ["target", "hold_ms"],
+        "required": [
+          "target",
+          "hold_ms"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -1025,10 +1095,18 @@
       "schema": {
         "type": "object",
         "properties": {
-          "path": { "type": "string" },
-          "label": { "type": "string" },
-          "category": { "type": "string" },
-          "timeout_ms": { "type": "number" }
+          "path": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "category": {
+            "type": "string"
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
         },
         "additionalProperties": false
       },
@@ -1186,7 +1264,11 @@
         "properties": {
           "credential_source": {
             "type": "string",
-            "enum": ["auto", "environment", "fixture"]
+            "enum": [
+              "auto",
+              "environment",
+              "fixture"
+            ]
           },
           "srp_env": {
             "type": "string"
@@ -1237,17 +1319,25 @@
       ]
     },
     "metamask.wallet.import": {
-      "description": "Make the wallet ready by reusing a fixture-backed profile or importing the primary mnemonic through visible onboarding UI.",
+      "description": "Make the wallet ready through visible onboarding or prove and select the derived account in an existing visible session when method=ui.",
       "schema": {
         "type": "object",
         "properties": {
           "method": {
             "type": "string",
-            "enum": ["auto", "profile", "ui"]
+            "enum": [
+              "auto",
+              "profile",
+              "ui"
+            ]
           },
           "credential_source": {
             "type": "string",
-            "enum": ["auto", "environment", "fixture"]
+            "enum": [
+              "auto",
+              "environment",
+              "fixture"
+            ]
           },
           "srp_env": {
             "type": "string"
@@ -1279,7 +1369,14 @@
             "type": "array",
             "items": {
               "type": "string",
-              "enum": ["swap_tokens", "trade_perpetuals", "prediction_markets", "send_receive_crypto", "earn_and_spend", "use_other_crypto_apps"]
+              "enum": [
+                "swap_tokens",
+                "trade_perpetuals",
+                "prediction_markets",
+                "send_receive_crypto",
+                "earn_and_spend",
+                "use_other_crypto_apps"
+              ]
             },
             "default": [],
             "description": "Mobile-only onboarding interests; ignored when empty on Extension."
@@ -1433,18 +1530,54 @@
       "schema": {
         "type": "object",
         "properties": {
-          "screen_hash": { "type": "string" },
-          "screen_test_id": { "type": "string" },
-          "return_hash": { "type": "string", "default": "#/" },
-          "cycles": { "type": "integer", "minimum": 2, "default": 8 },
-          "max_nodes_per_cycle": { "type": "number", "default": 2 },
-          "max_listeners_per_cycle": { "type": "number", "default": 4 },
-          "settle_ms": { "type": "integer", "minimum": 0, "default": 1500 },
-          "gc_settle_ms": { "type": "integer", "minimum": 0, "default": 300 },
-          "screen_timeout_ms": { "type": "integer", "minimum": 1, "default": 15000 },
-          "timeout_ms": { "type": "integer", "minimum": 1, "default": 400000 }
+          "screen_hash": {
+            "type": "string"
+          },
+          "screen_test_id": {
+            "type": "string"
+          },
+          "return_hash": {
+            "type": "string",
+            "default": "#/"
+          },
+          "cycles": {
+            "type": "integer",
+            "minimum": 2,
+            "default": 8
+          },
+          "max_nodes_per_cycle": {
+            "type": "number",
+            "default": 2
+          },
+          "max_listeners_per_cycle": {
+            "type": "number",
+            "default": 4
+          },
+          "settle_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 1500
+          },
+          "gc_settle_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 300
+          },
+          "screen_timeout_ms": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 15000
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 400000
+          }
         },
-        "required": ["screen_hash", "screen_test_id"],
+        "required": [
+          "screen_hash",
+          "screen_test_id"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -1467,17 +1600,50 @@
       "schema": {
         "type": "object",
         "properties": {
-          "screen_hash": { "type": "string" },
-          "screen_test_id": { "type": "string" },
-          "return_hash": { "type": "string", "default": "#/" },
-          "cycles": { "type": "integer", "minimum": 2, "default": 5 },
-          "max_detached_growth": { "type": "number", "default": 50 },
-          "settle_ms": { "type": "integer", "minimum": 0, "default": 1500 },
-          "gc_settle_ms": { "type": "integer", "minimum": 0, "default": 300 },
-          "screen_timeout_ms": { "type": "integer", "minimum": 1, "default": 15000 },
-          "timeout_ms": { "type": "integer", "minimum": 1, "default": 400000 }
+          "screen_hash": {
+            "type": "string"
+          },
+          "screen_test_id": {
+            "type": "string"
+          },
+          "return_hash": {
+            "type": "string",
+            "default": "#/"
+          },
+          "cycles": {
+            "type": "integer",
+            "minimum": 2,
+            "default": 5
+          },
+          "max_detached_growth": {
+            "type": "number",
+            "default": 50
+          },
+          "settle_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 1500
+          },
+          "gc_settle_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 300
+          },
+          "screen_timeout_ms": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 15000
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 400000
+          }
         },
-        "required": ["screen_hash", "screen_test_id"],
+        "required": [
+          "screen_hash",
+          "screen_test_id"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -1499,22 +1665,59 @@
       "schema": {
         "type": "object",
         "properties": {
-          "screen_hash": { "type": "string" },
-          "screen_test_id": { "type": "string" },
-          "return_hash": { "type": "string", "default": "#/" },
-          "rounds": { "type": "integer", "minimum": 2, "default": 8 },
-          "round_duration_ms": { "type": "integer", "minimum": 1, "default": 10000 },
-          "max_attributable_listeners_per_cycle": { "type": "number", "default": 2 },
-          "settle_ms": { "type": "integer", "minimum": 0, "default": 1500 },
-          "gc_settle_ms": { "type": "integer", "minimum": 0, "default": 300 },
-          "screen_timeout_ms": { "type": "integer", "minimum": 1, "default": 15000 },
-          "timeout_ms": { "type": "integer", "minimum": 1, "default": 400000 }
-        },
-        "required": ["screen_hash", "screen_test_id"],
-        "additionalProperties": false
-      },
-      "examples": [
-        {
+          "screen_hash": {
+            "type": "string"
+          },
+          "screen_test_id": {
+            "type": "string"
+          },
+          "return_hash": {
+            "type": "string",
+            "default": "#/"
+          },
+          "rounds": {
+            "type": "integer",
+            "minimum": 2,
+            "default": 8
+          },
+          "round_duration_ms": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 10000
+          },
+          "max_attributable_listeners_per_cycle": {
+            "type": "number",
+            "default": 2
+          },
+          "settle_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 1500
+          },
+          "gc_settle_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 300
+          },
+          "screen_timeout_ms": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 15000
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 400000
+          }
+        },
+        "required": [
+          "screen_hash",
+          "screen_test_id"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
           "action": "metamask.performance.compare_idle_navigation_memory",
           "screen_hash": "#/settings",
           "screen_test_id": "settings-tab-bar-grouped",
@@ -1550,7 +1753,9 @@
           },
           "require_symbols": {
             "type": "array",
-            "items": { "type": "string" },
+            "items": {
+              "type": "string"
+            },
             "maxItems": 50
           },
           "require_fiat": {
@@ -1573,7 +1778,10 @@
         {
           "action": "metamask.assets.read_visible_state",
           "minimum_asset_count": 2,
-          "require_symbols": ["USDC", "BNB"],
+          "require_symbols": [
+            "USDC",
+            "BNB"
+          ],
           "require_fiat": true,
           "require_price_change_styling": true,
           "minimum_price_change_count": 1,
@@ -1582,16 +1790,62 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["host-read-export"]
+      "execution_capabilities": [
+        "host-read-export"
+      ]
+    },
+    "metamask.assets.open_details": {
+      "description": "Open one visible Extension asset by symbol.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "symbol": {
+            "type": "string"
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 30000
+          }
+        },
+        "required": [
+          "symbol"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.assets.open_details",
+          "symbol": "ETH",
+          "intent": "Open the funded ETH details",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.assets.read_details": {
       "description": "Read and assert the current Extension asset details page through visible UI.",
       "schema": {
         "type": "object",
         "properties": {
-          "expected_symbol": { "type": "string" },
-          "require_chart": { "type": "boolean", "default": false },
-          "require_market_cap": { "type": "boolean", "default": false }
+          "expected_symbol": {
+            "type": "string"
+          },
+          "require_chart": {
+            "type": "boolean",
+            "default": false
+          },
+          "require_market_cap": {
+            "type": "boolean",
+            "default": false
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 30000
+          }
         },
         "additionalProperties": false
       },
@@ -1605,7 +1859,9 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["host-read-export"]
+      "execution_capabilities": [
+        "host-read-export"
+      ]
     },
     "metamask.assets.verify_sorting": {
       "description": "Select both visible Extension asset sort modes, assert their row order, and restore declining balance.",
@@ -1621,19 +1877,39 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.assets.set_token_visibility": {
       "description": "Enable or disable one searched Extension token through Manage tokens and verify the home list state.",
       "schema": {
         "type": "object",
         "properties": {
-          "query": { "type": "string" },
-          "visible": { "type": "boolean" },
-          "require_unchanged": { "type": "boolean", "default": false },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 45000 }
+          "query": {
+            "type": "string"
+          },
+          "visible": {
+            "type": "boolean"
+          },
+          "require_unchanged": {
+            "type": "boolean",
+            "default": false
+          },
+          "require_change": {
+            "type": "boolean",
+            "default": false
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 45000
+          }
         },
-        "required": ["query", "visible"],
+        "required": [
+          "query",
+          "visible"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -1645,14 +1921,20 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.wallet.lock": {
       "description": "Lock the Extension wallet through the visible global menu and prove the unlock page appears.",
       "schema": {
         "type": "object",
         "properties": {
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 15000 }
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 15000
+          }
         },
         "additionalProperties": false
       },
@@ -1663,21 +1945,44 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.assets.import_custom_token": {
       "description": "Import one ERC-20 on a selected Extension network through the custom-token form and verify its row.",
       "schema": {
         "type": "object",
         "properties": {
-          "network": { "type": "string" },
-          "chain_id": { "type": "integer", "minimum": 1 },
-          "address": { "type": "string" },
-          "expected_symbol": { "type": "string" },
-          "decimals": { "type": "integer", "minimum": 0 },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+          "network": {
+            "type": "string"
+          },
+          "chain_id": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "address": {
+            "type": "string"
+          },
+          "expected_symbol": {
+            "type": "string"
+          },
+          "decimals": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 60000
+          }
         },
-        "required": ["network", "chain_id", "address", "expected_symbol"],
+        "required": [
+          "network",
+          "chain_id",
+          "address",
+          "expected_symbol"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -1692,20 +1997,41 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.assets.prepare_send": {
       "description": "Prepare a wallet-initiated EVM asset send through visible UI without advancing to confirmation.",
       "schema": {
         "type": "object",
         "properties": {
-          "symbol": { "type": "string" },
-          "recipient": { "type": "string" },
-          "amount": { "type": ["string", "number"] },
-          "max": { "type": "boolean", "default": false },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+          "symbol": {
+            "type": "string"
+          },
+          "recipient": {
+            "type": "string"
+          },
+          "amount": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "max": {
+            "type": "boolean",
+            "default": false
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 30000
+          }
         },
-        "required": ["symbol", "recipient"],
+        "required": [
+          "symbol",
+          "recipient"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -1718,14 +2044,20 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.assets.review_send": {
       "description": "Advance a prepared Extension send to confirmation and prove its visible network fee.",
       "schema": {
         "type": "object",
         "properties": {
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 30000
+          }
         },
         "additionalProperties": false
       },
@@ -1736,46 +2068,30 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
-    },
-    "metamask.assets.finish_send": {
-      "description": "Confirm or cancel a reviewed Extension send, requiring explicit live consent for confirmation and proving confirmed Activity details.",
-      "schema": {
-        "type": "object",
-        "properties": {
-          "decision": { "type": "string", "enum": ["confirm", "cancel"] },
-          "symbol": { "type": "string" },
-          "amount": { "type": ["string", "number"] },
-          "confirm_live": { "type": "boolean", "default": false },
-          "resume_submitted": { "type": "boolean", "default": false },
-          "transaction_hash": { "type": "string" },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 120000 }
-        },
-        "required": ["decision", "symbol", "amount"],
-        "additionalProperties": false
-      },
-      "examples": [
-        {
-          "action": "metamask.assets.finish_send",
-          "decision": "confirm",
-          "symbol": "USDC",
-          "amount": "0.01",
-          "confirm_live": true,
-          "intent": "Confirm the authorized tiny send and prove final Activity state",
-          "next": "done"
-        }
-      ],
-      "execution_capabilities": ["app-mutation", "external-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.assets.set_custom_gas": {
       "description": "Set a custom EVM gas limit on the current Extension send confirmation through visible controls.",
       "schema": {
         "type": "object",
         "properties": {
-          "gas_limit": { "type": ["string", "number"] },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+          "gas_limit": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 30000
+          }
         },
-        "required": ["gas_limit"],
+        "required": [
+          "gas_limit"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -1786,15 +2102,27 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.assets.select_network_scope": {
       "description": "Select the all-networks Extension asset scope through the visible network filter.",
       "schema": {
         "type": "object",
         "properties": {
-          "scope": { "type": "string", "enum": ["all"], "default": "all" },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+          "scope": {
+            "type": "string",
+            "enum": [
+              "all"
+            ],
+            "default": "all"
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 30000
+          }
         },
         "additionalProperties": false
       },
@@ -1806,25 +2134,66 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.networks.read_visible_state": {
       "description": "Read one selected Extension network and prove its visible balance rows remain stable across a bounded settle window.",
       "schema": {
         "type": "object",
         "properties": {
-          "network": { "type": "string" },
-          "chain_id": { "type": "integer", "minimum": 1 },
-          "settle_ms": { "type": "integer", "minimum": 0, "default": 0 },
-          "minimum_asset_count": { "type": "integer", "minimum": 0, "default": 0 },
-          "minimum_price_change_count": { "type": "integer", "minimum": 0, "default": 0 },
-          "minimum_without_price_change_count": { "type": "integer", "minimum": 0, "default": 0 },
-          "require_symbols": { "type": "array", "items": { "type": "string" }, "maxItems": 50 },
-          "require_fiat": { "type": "boolean", "default": false },
-          "require_price_change_styling": { "type": "boolean", "default": false },
-          "max_items": { "type": "integer", "minimum": 1, "default": 100 }
+          "network": {
+            "type": "string"
+          },
+          "chain_id": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "settle_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "minimum_asset_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "minimum_price_change_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "minimum_without_price_change_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "require_symbols": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 50
+          },
+          "require_fiat": {
+            "type": "boolean",
+            "default": false
+          },
+          "require_price_change_styling": {
+            "type": "boolean",
+            "default": false
+          },
+          "max_items": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 100
+          }
         },
-        "required": ["network"],
+        "required": [
+          "network"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -1832,98 +2201,189 @@
           "action": "metamask.networks.read_visible_state",
           "network": "HyperEVM",
           "chain_id": 999,
-          "require_symbols": ["HYPE"],
+          "require_symbols": [
+            "HYPE"
+          ],
           "settle_ms": 30000,
           "intent": "Assert the selected custom-network balance remains visible",
           "next": "done"
         }
       ],
-      "execution_capabilities": ["host-read-export"]
+      "execution_capabilities": [
+        "host-read-export"
+      ]
     },
     "metamask.networks.add_custom": {
       "description": "Add or select one custom Extension network through visible network management controls.",
       "schema": {
         "type": "object",
         "properties": {
-          "network": { "type": "string" },
-          "rpc_url": { "type": "string" },
-          "chain_id": { "type": "integer", "minimum": 1 },
-          "symbol": { "type": "string" },
-          "explorer_url": { "type": "string" },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+          "network": {
+            "type": "string"
+          },
+          "rpc_url": {
+            "type": "string"
+          },
+          "chain_id": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "explorer_url": {
+            "type": "string"
+          },
+          "require_absent": {
+            "type": "boolean",
+            "default": false
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 60000
+          }
         },
-        "required": ["network", "rpc_url", "chain_id", "symbol"],
+        "required": [
+          "network",
+          "rpc_url",
+          "chain_id",
+          "symbol"
+        ],
         "additionalProperties": false
       },
-      "examples": [{
-        "action": "metamask.networks.add_custom",
-        "network": "PulseChain",
-        "rpc_url": "https://rpc.pulsechain.com",
-        "chain_id": 369,
-        "symbol": "PLS",
-        "explorer_url": "https://scan.pulsechain.com",
-        "intent": "Add and select PulseChain",
-        "next": "done"
-      }],
-      "execution_capabilities": ["app-mutation"]
+      "examples": [
+        {
+          "action": "metamask.networks.add_custom",
+          "network": "PulseChain",
+          "rpc_url": "https://rpc.pulsechain.com",
+          "chain_id": 369,
+          "symbol": "PLS",
+          "explorer_url": "https://scan.pulsechain.com",
+          "require_absent": true,
+          "intent": "Add and select PulseChain",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.networks.add_chainlist": {
       "description": "Add or select one Extension network from the visible ChainList search results.",
       "schema": {
         "type": "object",
         "properties": {
-          "network": { "type": "string" },
-          "query": { "type": "string" },
-          "chain_id": { "type": "integer", "minimum": 1 },
-          "symbol": { "type": "string" },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+          "network": {
+            "type": "string"
+          },
+          "query": {
+            "type": "string"
+          },
+          "chain_id": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "require_absent": {
+            "type": "boolean",
+            "default": false
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 60000
+          }
         },
-        "required": ["network", "chain_id", "symbol"],
+        "required": [
+          "network",
+          "chain_id",
+          "symbol"
+        ],
         "additionalProperties": false
       },
-      "examples": [{
-        "action": "metamask.networks.add_chainlist",
-        "network": "XDC Network",
-        "query": "XDC",
-        "chain_id": 50,
-        "symbol": "XDC",
-        "intent": "Add and select XDC Network from the exact ChainList result",
-        "next": "done"
-      }],
-      "execution_capabilities": ["app-mutation"]
+      "examples": [
+        {
+          "action": "metamask.networks.add_chainlist",
+          "network": "XDC Network",
+          "query": "XDC",
+          "chain_id": 50,
+          "symbol": "XDC",
+          "require_absent": true,
+          "intent": "Add and select XDC Network from the exact ChainList result",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.networks.remove_custom": {
       "description": "Remove one custom Extension network through visible network management controls.",
       "schema": {
         "type": "object",
         "properties": {
-          "network": { "type": "string" },
-          "chain_id": { "type": "integer", "minimum": 1 },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+          "network": {
+            "type": "string"
+          },
+          "chain_id": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 30000
+          }
         },
-        "required": ["network", "chain_id"],
+        "required": [
+          "network",
+          "chain_id"
+        ],
         "additionalProperties": false
       },
-      "examples": [{
-        "action": "metamask.networks.remove_custom",
-        "network": "PulseChain",
-        "chain_id": 369,
-        "intent": "Remove PulseChain after validation",
-        "next": "done"
-      }],
-      "execution_capabilities": ["app-mutation"]
+      "examples": [
+        {
+          "action": "metamask.networks.remove_custom",
+          "network": "PulseChain",
+          "chain_id": 369,
+          "intent": "Remove PulseChain after validation",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.swap_bridge.read_visible_state": {
       "description": "Read and assert the visible Swap surface from an untouched Extension runtime without product background hooks.",
       "schema": {
         "type": "object",
         "properties": {
-          "source_symbol": { "type": "string" },
-          "destination_symbol": { "type": "string" },
-          "require_amount_inputs": { "type": "boolean", "default": true },
-          "require_settings": { "type": "boolean", "default": false },
-          "require_quote": { "type": "boolean", "default": false },
-          "expected_slippage": { "type": "number", "minimum": 0 }
+          "source_symbol": {
+            "type": "string"
+          },
+          "destination_symbol": {
+            "type": "string"
+          },
+          "require_amount_inputs": {
+            "type": "boolean",
+            "default": true
+          },
+          "require_settings": {
+            "type": "boolean",
+            "default": false
+          },
+          "require_quote": {
+            "type": "boolean",
+            "default": false
+          },
+          "expected_slippage": {
+            "type": "number",
+            "minimum": 0
+          }
         },
         "additionalProperties": false
       },
@@ -1936,122 +2396,164 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["host-read-export"]
+      "execution_capabilities": [
+        "host-read-export"
+      ]
     },
     "metamask.swap_bridge.select_assets": {
       "description": "Select exact Swap source and destination assets through the visible asset pickers.",
       "schema": {
         "type": "object",
         "properties": {
-          "source_symbol": { "type": "string" },
-          "destination_symbol": { "type": "string" },
-          "source_chain": { "type": "string" },
-          "destination_chain": { "type": "string" },
-          "source_query": { "type": "string" },
-          "destination_query": { "type": "string" },
-          "source_asset_id": { "type": "string" },
-          "destination_asset_id": { "type": "string" },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+          "source_symbol": {
+            "type": "string"
+          },
+          "destination_symbol": {
+            "type": "string"
+          },
+          "source_chain": {
+            "type": "string"
+          },
+          "destination_chain": {
+            "type": "string"
+          },
+          "source_query": {
+            "type": "string"
+          },
+          "destination_query": {
+            "type": "string"
+          },
+          "source_asset_id": {
+            "type": "string"
+          },
+          "destination_asset_id": {
+            "type": "string"
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 60000
+          }
         },
-        "required": ["source_symbol", "destination_symbol", "source_chain", "destination_chain"],
+        "required": [
+          "source_symbol",
+          "destination_symbol",
+          "source_chain",
+          "destination_chain"
+        ],
         "additionalProperties": false
       },
-      "examples": [{
-        "action": "metamask.swap_bridge.select_assets",
-        "source_symbol": "ETH",
-        "destination_symbol": "WETH",
-        "source_chain": "eip155:1",
-        "destination_chain": "eip155:1",
-        "intent": "Select the funded Swap pair",
-        "next": "done"
-      }],
-      "execution_capabilities": ["app-mutation"]
+      "examples": [
+        {
+          "action": "metamask.swap_bridge.select_assets",
+          "source_symbol": "ETH",
+          "destination_symbol": "WETH",
+          "source_chain": "eip155:1",
+          "destination_chain": "eip155:1",
+          "intent": "Select the funded Swap pair",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.swap_bridge.set_amount": {
       "description": "Enter a positive Swap amount through visible UI and wait for a quote or explicit no-route state.",
       "schema": {
         "type": "object",
         "properties": {
-          "amount": { "type": "number", "minimum": 0.00000001 },
-          "wait_for_quote": { "type": "boolean", "default": true },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
+          "amount": {
+            "type": "number",
+            "minimum": 1E-8
+          },
+          "wait_for_quote": {
+            "type": "boolean",
+            "default": true
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 60000
+          }
         },
-        "required": ["amount"],
+        "required": [
+          "amount"
+        ],
         "additionalProperties": false
       },
-      "examples": [{
-        "action": "metamask.swap_bridge.set_amount",
-        "amount": 0.0001,
-        "intent": "Enter a capped Swap amount and wait for the quote",
-        "next": "done"
-      }],
-      "execution_capabilities": ["app-mutation"]
+      "examples": [
+        {
+          "action": "metamask.swap_bridge.set_amount",
+          "amount": 0.0001,
+          "intent": "Enter a capped Swap amount and wait for the quote",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.swap_bridge.set_slippage": {
       "description": "Set a custom Swap slippage percentage through the visible transaction settings.",
       "schema": {
         "type": "object",
         "properties": {
-          "percent": { "type": "number", "minimum": 0.01 },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
+          "percent": {
+            "type": "number",
+            "minimum": 0.01
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 30000
+          }
         },
-        "required": ["percent"],
+        "required": [
+          "percent"
+        ],
         "additionalProperties": false
       },
-      "examples": [{
-        "action": "metamask.swap_bridge.set_slippage",
-        "percent": 3,
-        "intent": "Set the release checklist custom slippage value",
-        "next": "done"
-      }],
-      "execution_capabilities": ["app-mutation"]
+      "examples": [
+        {
+          "action": "metamask.swap_bridge.set_slippage",
+          "percent": 3,
+          "intent": "Set the release checklist custom slippage value",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.swap_bridge.set_max_amount": {
       "description": "Use the visible Swap Max control and wait for the derived live quote.",
       "schema": {
         "type": "object",
         "properties": {
-          "wait_for_quote": { "type": "boolean", "default": true },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
-        },
-        "additionalProperties": false
-      },
-      "examples": [{
-        "action": "metamask.swap_bridge.set_max_amount",
-        "wait_for_quote": true,
-        "intent": "Use the available token balance for the return Swap",
-        "next": "done"
-      }],
-      "execution_capabilities": ["app-mutation"]
-    },
-    "metamask.swap_bridge.submit_transaction": {
-      "description": "Submit an explicitly authorized live Swap and prove its confirmed Activity details and destination balance.",
-      "schema": {
-        "type": "object",
-        "properties": {
-          "source_symbol": { "type": "string" },
-          "destination_symbol": { "type": "string" },
-          "amount": { "type": ["string", "number"] },
-          "confirm_live": { "type": "boolean", "default": false },
-          "resume_submitted": { "type": "boolean", "default": false },
-          "transaction_hash": { "type": "string" },
-          "activity_occurrence": { "type": "integer", "minimum": 0, "default": 0 },
-          "require_destination_balance": { "type": "boolean", "default": true },
-          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 300000 }
+          "wait_for_quote": {
+            "type": "boolean",
+            "default": true
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 60000
+          }
         },
-        "required": ["source_symbol", "destination_symbol", "amount"],
         "additionalProperties": false
       },
-      "examples": [{
-        "action": "metamask.swap_bridge.submit_transaction",
-        "source_symbol": "ETH",
-        "destination_symbol": "USDC",
-        "amount": "0.002",
-        "confirm_live": true,
-        "intent": "Submit the authorized release-check swap and prove its confirmed Activity details",
-        "next": "done"
-      }],
-      "execution_capabilities": ["app-mutation", "external-mutation"]
+      "examples": [
+        {
+          "action": "metamask.swap_bridge.set_max_amount",
+          "wait_for_quote": true,
+          "intent": "Use the available token balance for the return Swap",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.perps.read_visible_state": {
       "description": "Read and assert bounded visible Perps UI state from an untouched Extension runtime without product background hooks.",
@@ -2060,7 +2562,15 @@
         "properties": {
           "surface": {
             "type": "string",
-            "enum": ["auto", "home", "market-list", "market-details", "order-entry", "activity", "funds"],
+            "enum": [
+              "auto",
+              "home",
+              "market-list",
+              "market-details",
+              "order-entry",
+              "activity",
+              "funds"
+            ],
             "default": "auto"
           },
           "market": {
@@ -2069,20 +2579,35 @@
           },
           "direction": {
             "type": "string",
-            "enum": ["long", "short"]
+            "enum": [
+              "long",
+              "short"
+            ]
           },
-      "order_type": {
+          "order_type": {
             "type": "string",
-            "enum": ["market", "limit"]
+            "enum": [
+              "market",
+              "limit"
+            ]
           },
           "amount": {
-            "type": ["string", "number"]
+            "type": [
+              "string",
+              "number"
+            ]
           },
           "percent": {
-            "type": ["string", "number"]
+            "type": [
+              "string",
+              "number"
+            ]
           },
           "leverage": {
-            "type": ["string", "number"]
+            "type": [
+              "string",
+              "number"
+            ]
           },
           "auto_close": {
             "type": "boolean"
@@ -2092,7 +2617,9 @@
           },
           "require_validation_text": {
             "type": "array",
-            "items": { "type": "string" },
+            "items": {
+              "type": "string"
+            },
             "maxItems": 20
           },
           "minimum_market_count": {
@@ -2134,21 +2661,39 @@
             "type": "boolean",
             "default": false
           },
+          "require_no_control_overlap": {
+            "type": "boolean",
+            "default": false
+          },
           "forbid_test_ids": {
             "type": "array",
-            "items": { "type": "string" },
+            "items": {
+              "type": "string"
+            },
             "maxItems": 100
           },
           "require_test_ids": {
             "type": "array",
-            "items": { "type": "string" },
+            "items": {
+              "type": "string"
+            },
             "maxItems": 100
           },
           "require_features": {
             "type": "array",
             "items": {
               "type": "string",
-              "enum": ["activity", "balance", "chart", "long-short", "market-list", "order-entry", "price", "price-change", "stats"]
+              "enum": [
+                "activity",
+                "balance",
+                "chart",
+                "long-short",
+                "market-list",
+                "order-entry",
+                "price",
+                "price-change",
+                "stats"
+              ]
             },
             "maxItems": 9
           },
@@ -2169,13 +2714,51 @@
           "action": "metamask.perps.read_visible_state",
           "surface": "home",
           "minimum_market_count": 1,
-          "require_features": ["balance", "market-list"],
-          "require_test_ids": ["perps-balance-dropdown-balance"],
+          "require_features": [
+            "balance",
+            "market-list"
+          ],
+          "require_test_ids": [
+            "perps-balance-dropdown-balance"
+          ],
           "intent": "Assert the live Perps home surface through visible UI",
           "next": "done"
         }
       ],
-      "execution_capabilities": ["host-read-export"]
+      "execution_capabilities": [
+        "host-read-export"
+      ]
+    },
+    "metamask.perps.search_markets": {
+      "description": "Enter a Perps market query through the visible search field and prove visible results are returned.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string"
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 30000
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.search_markets",
+          "query": "Bitcoin",
+          "intent": "Filter the visible Perps market list",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.perps.select_market_filter": {
       "description": "Select and assert a live Perps market category through trusted visible UI controls.",
@@ -2184,7 +2767,17 @@
         "properties": {
           "filter": {
             "type": "string",
-            "enum": ["all", "crypto", "stocks", "pre-ipo", "index", "etf", "commodities", "forex", "new"]
+            "enum": [
+              "all",
+              "crypto",
+              "stocks",
+              "pre-ipo",
+              "index",
+              "etf",
+              "commodities",
+              "forex",
+              "new"
+            ]
           },
           "minimum_market_count": {
             "type": "integer",
@@ -2200,9 +2793,16 @@
             "type": "integer",
             "minimum": 1,
             "default": 100
-          }
-        },
-        "required": ["filter"],
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 10000
+          }
+        },
+        "required": [
+          "filter"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2214,21 +2814,88 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.perps.close_visible_position": {
       "description": "Close all or part of one live Perps position through semantic visible controls.",
       "schema": {
         "type": "object",
         "properties": {
-          "market": { "type": "string" },
-          "confirm_live": { "type": "boolean", "enum": [true] },
+          "market": {
+            "type": "string"
+          },
+          "confirm_live": {
+            "type": "boolean",
+            "enum": [
+              true
+            ]
+          },
+          "funding_side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ]
+          },
+          "funding_amount": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "provider": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "mainnet",
+              "testnet"
+            ]
+          },
+          "funding_position_size": {
+            "type": "string",
+            "description": "Exact visible position size required for a close-only cleanup."
+          },
+          "leverage": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "cleanup_only": {
+            "type": "boolean",
+            "enum": [
+              true
+            ],
+            "description": "Use a fresh exact close-only authorization and current visible balance baseline."
+          },
+          "identity_rounding_tolerance_base_units": {
+            "type": "string",
+            "default": "10000",
+            "description": "Maximum visible USD rounding delta in six-decimal USDC base units; default 10000 and capped at 1000000."
+          },
+          "balance_reconciliation_tolerance_base_units": {
+            "type": "string",
+            "description": "Maximum final-versus-preorder balance delta in six-decimal USDC base units; default/cap 1000000."
+          },
           "amount": {
-            "type": ["string", "number"],
+            "type": [
+              "string",
+              "number"
+            ],
             "description": "Optional USD amount for a partial close; omit to close the full position."
           }
         },
-        "required": ["market", "confirm_live"],
+        "required": [
+          "market",
+          "confirm_live",
+          "funding_side",
+          "funding_amount",
+          "provider",
+          "network",
+          "leverage"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2236,22 +2903,43 @@
           "action": "metamask.perps.close_visible_position",
           "market": "BTC",
           "confirm_live": true,
+          "funding_side": "long",
+          "funding_amount": "10",
+          "provider": "hyperliquid",
+          "network": "mainnet",
+          "leverage": 3,
+          "identity_rounding_tolerance_base_units": "10000",
           "intent": "Close the visible BTC position after the live release check",
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation", "external-mutation"]
+      "execution_capabilities": [
+        "app-mutation",
+        "external-mutation"
+      ]
     },
     "metamask.perps.compare_provider_market": {
       "description": "Compare one visible Perps market with the live Hyperliquid production response.",
       "schema": {
         "type": "object",
         "properties": {
-          "market": { "type": "string" },
-          "endpoint": { "type": "string", "enum": ["https://api.hyperliquid.xyz/info"] },
-          "timeout_ms": { "type": "integer", "minimum": 1 }
+          "market": {
+            "type": "string"
+          },
+          "endpoint": {
+            "type": "string",
+            "enum": [
+              "https://api.hyperliquid.xyz/info"
+            ]
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1
+          }
         },
-        "required": ["market"],
+        "required": [
+          "market"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2262,14 +2950,19 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["host-read-export"]
+      "execution_capabilities": [
+        "host-read-export"
+      ]
     },
     "metamask.perps.read_eligibility": {
       "description": "Read the current Extension Perps eligibility and live MetaMask geolocation without changing either.",
       "schema": {
         "type": "object",
         "properties": {
-          "timeout_ms": { "type": "integer", "minimum": 1 }
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1
+          }
         },
         "additionalProperties": false
       },
@@ -2280,17 +2973,30 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["host-read-export"]
+      "execution_capabilities": [
+        "host-read-export"
+      ]
     },
     "metamask.perps.set_market_favorite": {
       "description": "Converge one live Perps market favorite to the requested state through its semantic visible control.",
       "schema": {
         "type": "object",
         "properties": {
-          "market": { "type": "string" },
-          "favorite": { "type": "boolean" }
+          "market": {
+            "type": "string"
+          },
+          "favorite": {
+            "type": "boolean"
+          },
+          "require_unchanged": {
+            "type": "boolean",
+            "default": false
+          }
         },
-        "required": ["market", "favorite"],
+        "required": [
+          "market",
+          "favorite"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2302,7 +3008,9 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.perps.select_activity_filter": {
       "description": "Select and read one live Perps activity category through semantic visible controls.",
@@ -2311,10 +3019,17 @@
         "properties": {
           "filter": {
             "type": "string",
-            "enum": ["trades", "orders", "funding", "deposits"]
+            "enum": [
+              "trades",
+              "orders",
+              "funding",
+              "deposits"
+            ]
           }
         },
-        "required": ["filter"],
+        "required": [
+          "filter"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2325,7 +3040,9 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.perps.open_balance_action": {
       "description": "Open Add funds or Withdraw from the live Perps balance dropdown in one trusted UI session.",
@@ -2334,10 +3051,15 @@
         "properties": {
           "balance_action": {
             "type": "string",
-            "enum": ["add-funds", "withdraw"]
+            "enum": [
+              "add-funds",
+              "withdraw"
+            ]
           }
         },
-        "required": ["balance_action"],
+        "required": [
+          "balance_action"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2348,20 +3070,34 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.perps.open_position_action": {
       "description": "Open a position-management flow from a live Perps position through visible controls in one trusted UI session.",
       "schema": {
         "type": "object",
         "properties": {
-          "market": { "type": "string" },
+          "market": {
+            "type": "string"
+          },
           "position_action": {
             "type": "string",
-            "enum": ["add-exposure", "reduce-exposure", "reverse", "add-margin", "remove-margin", "auto-close"]
+            "enum": [
+              "add-exposure",
+              "reduce-exposure",
+              "reverse",
+              "add-margin",
+              "remove-margin",
+              "auto-close"
+            ]
           }
         },
-        "required": ["market", "position_action"],
+        "required": [
+          "market",
+          "position_action"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2373,20 +3109,85 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.perps.edit_margin": {
       "description": "Add or remove isolated margin from a live Perps position through visible controls and prove the reconciled position values.",
       "schema": {
         "type": "object",
         "properties": {
-          "market": { "type": "string" },
-          "margin_action": { "type": "string", "enum": ["add", "remove"], "default": "add" },
-          "amount": { "type": ["string", "number"] },
-          "confirm_live": { "type": "boolean" },
-          "timeout_ms": { "type": "number" }
+          "market": {
+            "type": "string"
+          },
+          "margin_action": {
+            "type": "string",
+            "enum": [
+              "add",
+              "remove"
+            ],
+            "default": "add"
+          },
+          "amount": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "funding_side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ]
+          },
+          "funding_amount": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "funding_position_size": {
+            "type": "string",
+            "description": "Exact stable visible position size identity."
+          },
+          "provider": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "mainnet",
+              "testnet"
+            ]
+          },
+          "leverage": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "balance_reconciliation_tolerance_base_units": {
+            "type": "string",
+            "default": "1000000"
+          },
+          "confirm_live": {
+            "type": "boolean"
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
         },
-        "required": ["market", "amount", "confirm_live"],
+        "required": [
+          "market",
+          "amount",
+          "funding_side",
+          "funding_amount",
+          "funding_position_size",
+          "provider",
+          "network",
+          "leverage",
+          "confirm_live"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2395,25 +3196,92 @@
           "market": "BTC",
           "margin_action": "add",
           "amount": 1,
+          "funding_side": "long",
+          "funding_amount": 10,
+          "funding_position_size": "0.00016 BTC",
+          "provider": "hyperliquid",
+          "network": "mainnet",
+          "leverage": 1,
           "confirm_live": true,
           "intent": "Add one USDC of margin to the BTC position",
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation", "external-mutation"]
+      "execution_capabilities": [
+        "app-mutation",
+        "external-mutation"
+      ]
     },
     "metamask.perps.update_position_tpsl": {
       "description": "Update take-profit and stop-loss for a live Extension Perps position through visible controls and prove the reconciled position row.",
       "schema": {
         "type": "object",
         "properties": {
-          "market": { "type": "string" },
-          "take_profit_price": { "type": ["string", "number"] },
-          "stop_loss_price": { "type": ["string", "number"] },
-          "confirm_live": { "type": "boolean" },
-          "timeout_ms": { "type": "number" }
+          "market": {
+            "type": "string"
+          },
+          "take_profit_price": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "stop_loss_price": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "funding_side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ]
+          },
+          "funding_amount": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "funding_position_size": {
+            "type": "string",
+            "description": "Exact stable visible position size identity."
+          },
+          "provider": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "mainnet",
+              "testnet"
+            ]
+          },
+          "leverage": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "confirm_live": {
+            "type": "boolean"
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
         },
-        "required": ["market", "confirm_live"],
+        "required": [
+          "market",
+          "take_profit_price",
+          "stop_loss_price",
+          "funding_side",
+          "funding_amount",
+          "funding_position_size",
+          "provider",
+          "network",
+          "leverage",
+          "confirm_live"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2422,21 +3290,34 @@
           "market": "BTC",
           "take_profit_price": 65000,
           "stop_loss_price": 55000,
+          "funding_side": "long",
+          "funding_amount": 10,
+          "funding_position_size": "0.00016 BTC",
+          "provider": "hyperliquid",
+          "network": "mainnet",
+          "leverage": 1,
           "confirm_live": true,
           "intent": "Update BTC position auto-close prices",
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation", "external-mutation"]
+      "execution_capabilities": [
+        "app-mutation",
+        "external-mutation"
+      ]
     },
     "metamask.settings.set_basic_functionality": {
       "description": "Converge the Extension Basic Functionality privacy setting through its visible toggle and confirmation modal.",
       "schema": {
         "type": "object",
         "properties": {
-          "enabled": { "type": "boolean" }
+          "enabled": {
+            "type": "boolean"
+          }
         },
-        "required": ["enabled"],
+        "required": [
+          "enabled"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2447,18 +3328,75 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["app-mutation"]
+      "execution_capabilities": [
+        "app-mutation"
+      ]
     },
     "metamask.perps.read_funds_confirmation": {
       "description": "Read the loaded Perps deposit or withdraw confirmation without submitting it.",
       "schema": {
         "type": "object",
         "properties": {
-          "mode": { "type": "string", "enum": ["deposit", "withdraw"] },
-          "require_no_horizontal_overflow": { "type": "boolean", "default": false },
-          "expected_submit_enabled": { "type": "boolean" }
+          "mode": {
+            "type": "string",
+            "enum": [
+              "deposit",
+              "withdraw"
+            ]
+          },
+          "require_no_horizontal_overflow": {
+            "type": "boolean",
+            "default": false
+          },
+          "require_preview_fields": {
+            "type": "boolean",
+            "default": false
+          },
+          "expected_submit_enabled": {
+            "type": "boolean"
+          },
+          "expected_submit_label": {
+            "type": "string"
+          },
+          "expected_amount": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "expected_amount_symbol": {
+            "type": "string"
+          },
+          "expected_pay_token_amount_visible": {
+            "type": "boolean"
+          },
+          "expected_pay_token": {
+            "type": "string"
+          },
+          "expected_receive_token": {
+            "type": "string"
+          },
+          "expected_visible_network": {
+            "type": "string"
+          },
+          "expected_percentage_controls": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 10
+          },
+          "require_visible_text": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 20
+          }
         },
-        "required": ["mode"],
+        "required": [
+          "mode"
+        ],
         "additionalProperties": false
       },
       "examples": [
@@ -2469,10 +3407,93 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": ["host-read-export"]
+      "execution_capabilities": [
+        "host-read-export"
+      ]
+    },
+    "metamask.perps.assert_visible_consistency": {
+      "description": "Assert bounded rendered Perps market or price changes, or recent-to-full activity containment, through visible Extension UI.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "mode": {
+            "type": "string",
+            "enum": [
+              "market-stream",
+              "watchlist-stream",
+              "activity-containment",
+              "price-stream"
+            ]
+          },
+          "surface": {
+            "type": "string",
+            "enum": [
+              "home",
+              "market-list",
+              "market-details",
+              "order-entry"
+            ]
+          },
+          "market": {
+            "type": "string"
+          },
+          "sample_count": {
+            "type": "integer",
+            "minimum": 2,
+            "default": 3
+          },
+          "sample_interval_ms": {
+            "type": "integer",
+            "minimum": 100,
+            "default": 1000
+          },
+          "minimum_changed_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 1
+          },
+          "minimum_recent_activity_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 1
+          },
+          "require_unique_ids": {
+            "type": "boolean",
+            "default": false
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 30000
+          },
+          "max_items": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 100
+          }
+        },
+        "required": [
+          "mode"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.assert_visible_consistency",
+          "mode": "market-stream",
+          "sample_count": 3,
+          "minimum_changed_count": 1,
+          "intent": "Prove rendered Perps market rows change over a bounded sample",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": [
+        "host-read-export",
+        "app-mutation"
+      ]
     },
     "metamask.perps.read_snapshot": {
-      "description": "Read a bounded, redacted snapshot of live Extension Perps state through product background APIs.",
+      "description": "Read a bounded, redacted source-dev snapshot of Extension Perps state through the optional product background hook.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2518,22 +3539,58 @@
               "start_time_ms": {
                 "type": "integer",
                 "minimum": 0,
-                "description": "Inclusive history start time in Unix milliseconds. Defaults to 30 days before end_time_ms."
+                "description": "Inclusive history start time in Unix milliseconds. Defaults to 30 days before end_time_ms."
+              },
+              "end_time_ms": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Inclusive history end time in Unix milliseconds. Defaults to the current time."
+              },
+              "account_id": {
+                "type": "string",
+                "description": "Optional CAIP account ID passed to the product history API; the value is not returned."
+              },
+              "limit": {
+                "type": "integer",
+                "minimum": 1,
+                "default": 100,
+                "description": "Maximum history items returned after product filtering."
+              }
+            },
+            "additionalProperties": false
+          },
+          "sampling": {
+            "type": "object",
+            "properties": {
+              "count": {
+                "type": "integer",
+                "minimum": 1,
+                "default": 1
+              },
+              "interval_ms": {
+                "type": "integer",
+                "minimum": 100,
+                "default": 1000
+              }
+            },
+            "additionalProperties": false
+          },
+          "expect": {
+            "type": "object",
+            "properties": {
+              "minimum_changed_market_count": {
+                "type": "integer",
+                "minimum": 0,
+                "default": 0
               },
-              "end_time_ms": {
+              "minimum_history_count": {
                 "type": "integer",
                 "minimum": 0,
-                "description": "Inclusive history end time in Unix milliseconds. Defaults to the current time."
-              },
-              "account_id": {
-                "type": "string",
-                "description": "Optional CAIP account ID passed to the product history API; the value is not returned."
+                "default": 0
               },
-              "limit": {
-                "type": "integer",
-                "minimum": 1,
-                "default": 100,
-                "description": "Maximum history items returned after product filtering."
+              "require_activity_history_agreement": {
+                "type": "boolean",
+                "default": false
               }
             },
             "additionalProperties": false
@@ -2570,7 +3627,9 @@
           "next": "done"
         }
       ],
-      "execution_capabilities": []
+      "execution_capabilities": [
+        "host-read-export"
+      ]
     },
     "metamask.perps.read_positions": {
       "description": "extension Read live Perps positions; without a selector, return all live positions.",
@@ -2766,8 +3825,8 @@
       ],
       "execution_capabilities": []
     },
-    "metamask.perps.close_positions": {
-      "description": "extension Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Close selected live Perps positions. Use selector/mode params to close matching symbols or all positions.",
+    "metamask.perps.close_orders": {
+      "description": "extension 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.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2849,134 +3908,77 @@
           },
           "timeout_ms": {
             "type": "number"
-          }
-        },
-        "additionalProperties": false
-      },
-      "examples": [
-        {
-          "action": "metamask.perps.close_positions",
-          "mode": "all",
-          "intent": "Close selected Perps positions before continuing",
-          "next": "done"
-        },
-        {
-          "action": "metamask.perps.close_positions",
-          "markets": [
-            "BTC",
-            "ETH"
-          ],
-          "intent": "Close selected Perps positions before continuing",
-          "next": "done"
-        }
-      ],
-      "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
-    },
-    "metamask.perps.close_orders": {
-      "description": "extension 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.",
-      "schema": {
-        "type": "object",
-        "properties": {
-          "market": {
-            "type": "string",
-            "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."
           },
-          "symbol": {
-            "type": "string",
-            "description": "Alias for market."
+          "confirm_live": {
+            "type": "boolean",
+            "description": "Required when cancellation uses visible controls against the live provider."
           },
-          "markets": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Explicit list of market symbols."
+          "amount": {
+            "type": [
+              "string",
+              "number"
+            ]
           },
-          "symbols": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Alias for markets."
+          "leverage": {
+            "type": "integer",
+            "minimum": 1
           },
-          "mode": {
+          "provider": {
+            "type": "string",
+            "description": "Exact Perps provider required before background cancellation dispatch."
+          },
+          "network": {
             "type": "string",
             "enum": [
-              "matching",
-              "all"
+              "mainnet",
+              "testnet"
             ],
-            "description": "matching selects requested symbols; all selects every live item returned by the product."
+            "description": "Exact Perps network required before background cancellation dispatch; the action never toggles it."
           },
-          "selector": {
-            "type": "object",
-            "properties": {
-              "mode": {
-                "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
-              },
-              "market": {
-                "type": "string"
-              },
-              "symbol": {
-                "type": "string"
-              },
-              "markets": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "symbols": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "side": {
-                "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
-              }
-            },
-            "additionalProperties": false
+          "limit_price": {
+            "type": [
+              "string",
+              "number"
+            ]
           },
-          "side": {
+          "order_id": {
             "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
-            "description": "Optional position/order side filter."
+            "description": "Exact product order ID required for receipt-bound background cancellation."
           },
-          "timeout_ms": {
+          "offset_pct": {
             "type": "number"
           },
-      "confirm_live": {
-            "type": "boolean",
-            "description": "Required when cancellation uses visible controls against the live provider."
+          "identity_rounding_tolerance_base_units": {
+            "type": "string",
+            "default": "10000",
+            "description": "Maximum visible notional/price rounding delta in six-decimal USDC base units; default 10000 and capped at 1000000."
           }
         },
+        "required": [
+          "market",
+          "side",
+          "amount",
+          "leverage",
+          "provider",
+          "network",
+          "limit_price",
+          "confirm_live"
+        ],
         "additionalProperties": false
       },
       "examples": [
-        {
-          "action": "metamask.perps.close_orders",
-          "mode": "all",
-          "intent": "Cancel selected Perps orders before continuing",
-          "next": "done"
-        },
         {
           "action": "metamask.perps.close_orders",
           "market": "BTC",
-          "intent": "Cancel selected Perps orders before continuing",
+          "side": "long",
+          "amount": "10",
+          "leverage": 3,
+          "provider": "hyperliquid",
+          "network": "testnet",
+          "limit_price": "100000",
+          "identity_rounding_tolerance_base_units": "10000",
+          "confirm_live": true,
+          "intent": "Cancel the exact trusted BTC limit order",
           "next": "done"
         }
       ],
@@ -3089,7 +4091,19 @@
           },
           "leverage": {
             "type": "number",
-            "default": 3
+            "default": 1
+          },
+          "provider": {
+            "type": "string",
+            "description": "Exact Perps provider required before background dispatch."
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "mainnet",
+              "testnet"
+            ],
+            "description": "Exact Perps network required before background dispatch; the action never toggles it."
           },
           "order_type": {
             "type": "string",
@@ -3119,150 +4133,44 @@
           "limit_price": {
             "type": [
               "string",
-              "number"
-            ]
-          },
-          "offset_pct": {
-            "type": "number",
-            "description": "Limit price offset from the current market price when limit_price is omitted."
-          },
-          "confirm_live": {
-            "type": "boolean",
-            "description": "Required when submission uses visible controls against the live provider."
-          }
-        },
-        "additionalProperties": false
-      },
-      "examples": [
-        {
-          "action": "metamask.perps.place_order",
-          "market": "BTC",
-          "side": "long",
-          "notional": "10",
-          "leverage": 2,
-          "intent": "Place the requested Perps order",
-          "next": "done"
-        }
-      ],
-      "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
-    },
-    "metamask.perps.assert_positions": {
-      "description": "extension Assert live Perps positions are present or absent for an explicit market selection or mode=all.",
-      "schema": {
-        "type": "object",
-        "properties": {
-          "market": {
-            "type": "string",
-            "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."
-          },
-          "symbol": {
-            "type": "string",
-            "description": "Alias for market."
-          },
-          "markets": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Explicit list of market symbols."
-          },
-          "symbols": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Alias for markets."
-          },
-          "mode": {
-            "type": "string",
-            "enum": [
-              "matching",
-              "all"
-            ],
-            "description": "matching selects requested symbols; all selects every live item returned by the product."
-          },
-          "selector": {
-            "type": "object",
-            "properties": {
-              "mode": {
-                "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
-              },
-              "market": {
-                "type": "string"
-              },
-              "symbol": {
-                "type": "string"
-              },
-              "markets": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "symbols": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "side": {
-                "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
-              }
-            },
-            "additionalProperties": false
+              "number"
+            ]
           },
-          "side": {
-            "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
-            "description": "Optional position/order side filter."
+          "offset_pct": {
+            "type": "number",
+            "description": "Limit price offset from the current market price when limit_price is omitted."
           },
-          "timeout_ms": {
-            "type": "number"
+          "confirm_live": {
+            "type": "boolean",
+            "description": "Required when submission uses visible controls against the live provider."
           },
-          "state": {
+          "identity_rounding_tolerance_base_units": {
             "type": "string",
-            "enum": [
-              "none",
-              "absent",
-              "closed",
-              "open",
-              "present"
-            ],
-            "description": "Desired/expected selected collection state."
+            "default": "10000",
+            "description": "Maximum visible amount/price rounding delta in six-decimal USDC base units; default 10000 and capped at 1000000."
           }
         },
-        "required": [
-          "state"
-        ],
         "additionalProperties": false
       },
       "examples": [
         {
-          "action": "metamask.perps.assert_positions",
-          "state": "open",
+          "action": "metamask.perps.place_order",
           "market": "BTC",
-          "intent": "Assert the expected Perps position state",
+          "side": "long",
+          "notional": "10",
+          "leverage": 1,
+          "identity_rounding_tolerance_base_units": "10000",
+          "intent": "Place the requested Perps order",
           "next": "done"
         }
       ],
-      "execution_capabilities": []
+      "execution_capabilities": [
+        "app-mutation",
+        "external-mutation"
+      ]
     },
-    "metamask.perps.assert_orders": {
-      "description": "extension Assert live Perps open orders are present or absent for an explicit market selection or mode=all.",
+    "metamask.perps.assert_positions": {
+      "description": "extension Assert live Perps positions are present or absent for an explicit market selection or mode=all.",
       "schema": {
         "type": "object",
         "properties": {
@@ -3364,17 +4272,17 @@
       },
       "examples": [
         {
-          "action": "metamask.perps.assert_orders",
-          "state": "none",
+          "action": "metamask.perps.assert_positions",
+          "state": "open",
           "market": "BTC",
-          "intent": "Assert the expected Perps open order state",
+          "intent": "Assert the expected Perps position state",
           "next": "done"
         }
       ],
       "execution_capabilities": []
     },
-    "metamask.perps.ensure_positions": {
-      "description": "extension Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Higher-level wrapper that reads selected positions, closes or places when needed, then asserts final position state.",
+    "metamask.perps.assert_orders": {
+      "description": "extension Assert live Perps open orders are present or absent for an explicit market selection or mode=all.",
       "schema": {
         "type": "object",
         "properties": {
@@ -3452,25 +4360,11 @@
               "long",
               "short"
             ],
-            "description": "Required when state=open/present; otherwise filters selected positions."
+            "description": "Optional position/order side filter."
           },
           "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": [
@@ -3490,36 +4384,17 @@
       },
       "examples": [
         {
-          "action": "metamask.perps.ensure_positions",
+          "action": "metamask.perps.assert_orders",
           "state": "none",
           "market": "BTC",
-          "intent": "Converge Perps positions to the requested state",
-          "next": "done"
-        },
-        {
-          "action": "metamask.perps.ensure_positions",
-          "state": "none",
-          "mode": "all",
-          "intent": "Converge Perps positions to the requested state",
-          "next": "done"
-        },
-        {
-          "action": "metamask.perps.ensure_positions",
-          "market": "ETH",
-          "side": "long",
-          "state": "open",
-          "notional": "10",
-          "intent": "Converge ETH positions to one explicit testnet precondition",
+          "intent": "Assert the expected Perps open order state",
           "next": "done"
         }
       ],
-      "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
+      "execution_capabilities": []
     },
-    "metamask.perps.ensure_orders": {
-      "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.",
+    "metamask.perps.ensure_positions": {
+      "description": "Read and assert the selected Extension Perps position state without creating or closing a position. Use an explicitly funded leaf action for any transition.",
       "schema": {
         "type": "object",
         "properties": {
@@ -3597,30 +4472,11 @@
               "long",
               "short"
             ],
-            "description": "Required when state=open/present; otherwise filters selected orders."
+            "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 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": [
@@ -3640,198 +4496,69 @@
       },
       "examples": [
         {
-          "action": "metamask.perps.ensure_orders",
+          "action": "metamask.perps.ensure_positions",
+          "state": "none",
+          "market": "BTC",
+          "intent": "Assert that no matching Perps position exists",
+          "next": "done"
+        },
+        {
+          "action": "metamask.perps.ensure_positions",
           "state": "none",
           "mode": "all",
-          "intent": "Converge Perps orders to the requested state",
+          "intent": "Assert that no Perps position exists",
           "next": "done"
         },
         {
-          "action": "metamask.perps.ensure_orders",
+          "action": "metamask.perps.ensure_positions",
           "market": "ETH",
-          "side": "short",
+          "side": "long",
           "state": "open",
-          "notional": 10,
-          "leverage": 2,
-          "intent": "Converge ETH open orders to one deterministic testnet precondition",
+          "intent": "Assert that the matching ETH long position already exists",
           "next": "done"
         }
       ],
       "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
-      ]
-    },
-    "metamask.perps.start_state": {
-      "description": "extension Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Recommended configurable Perps start state that composes reusable domain operations before the proof window.",
-      "schema": {
-        "type": "object",
-        "properties": {
-          "profile": {
-            "type": "string",
-            "description": "Optional profile such as clean_market_testnet, open_position_testnet, open_order_testnet, or provider_mainnet_readonly."
-          },
-          "account": {
-            "type": "string"
-          },
-          "provider": {
-            "type": "string",
-            "description": "Requested Perps provider, e.g. hyperliquid."
-          },
-          "network": {
-            "type": "string",
-            "enum": [
-              "testnet",
-              "mainnet"
-            ]
-          },
-          "market": {
-            "type": "string"
-          },
-          "symbol": {
-            "type": "string"
-          },
-          "markets": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "symbols": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "page": {
-            "type": "string",
-            "enum": [
-              "home",
-              "perps",
-              "perps_home",
-              "market",
-              "market_details",
-              "trade",
-              "order"
-            ],
-            "description": "Initial Perps page target; omit it to use the profile or market default. Extension start_state always enters Perps before convergence."
-          },
-          "positions": {
-            "type": [
-              "object",
-              "boolean"
-            ],
-            "properties": {
-              "mode": {
-                "type": "string",
-                "enum": [
-                  "matching",
-                  "all"
-                ]
-              },
-              "market": {
-                "type": "string"
-              },
-              "symbol": {
-                "type": "string"
-              },
-              "markets": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "symbols": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "side": {
-                "type": "string",
-                "enum": [
-                  "long",
-                  "short"
-                ]
-              },
-              "state": {
-                "type": "string",
-                "enum": [
-                  "none",
-                  "closed",
-                  "absent",
-                  "open",
-                  "present"
-                ]
-              },
-              "amount": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "notional": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "size": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "leverage": {
-                "type": "number"
-              },
-              "order_type": {
-                "type": "string"
-              },
-              "orderType": {
-                "type": "string"
-              },
-              "limit_price": {
-                "type": "number"
-              },
-              "limitPrice": {
-                "type": "number"
-              },
-              "offset_pct": {
-                "type": "number"
-              },
-              "offsetPct": {
-                "type": "number"
-              },
-              "current_price": {
-                "type": "number"
-              },
-              "currentPrice": {
-                "type": "number"
-              },
-              "max_slippage_bps": {
-                "type": "number"
-              },
-              "maxSlippageBps": {
-                "type": "number"
-              },
-              "close_attempts": {
-                "type": "integer"
-              },
-              "close_retry_delay_ms": {
-                "type": "integer"
-              },
-              "timeout_ms": {
-                "type": "number"
-              }
+        "host-read-export"
+      ]
+    },
+    "metamask.perps.ensure_orders": {
+      "description": "Read and assert the selected Extension Perps order state without creating or canceling an order. Use an explicitly funded leaf action for any transition.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
             },
-            "additionalProperties": false
+            "description": "Explicit list of market symbols."
           },
-          "orders": {
-            "type": [
-              "object",
-              "boolean"
+          "symbols": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Alias for markets."
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "matching",
+              "all"
             ],
+            "description": "matching selects requested symbols; all selects every live item returned by the product."
+          },
+          "selector": {
+            "type": "object",
             "properties": {
               "mode": {
                 "type": "string",
@@ -3864,184 +4591,64 @@
                   "long",
                   "short"
                 ]
-              },
-              "state": {
-                "type": "string",
-                "enum": [
-                  "none",
-                  "closed",
-                  "absent",
-                  "open",
-                  "present"
-                ]
-              },
-              "amount": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "notional": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "size": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "leverage": {
-                "type": "number"
-              },
-              "order_type": {
-                "type": "string"
-              },
-              "orderType": {
-                "type": "string"
-              },
-              "limit_price": {
-                "type": "number"
-              },
-              "limitPrice": {
-                "type": "number"
-              },
-              "offset_pct": {
-                "type": "number"
-              },
-              "offsetPct": {
-                "type": "number"
-              },
-              "current_price": {
-                "type": "number"
-              },
-              "currentPrice": {
-                "type": "number"
-              },
-              "max_slippage_bps": {
-                "type": "number"
-              },
-              "maxSlippageBps": {
-                "type": "number"
-              },
-              "close_attempts": {
-                "type": "integer"
-              },
-              "close_retry_delay_ms": {
-                "type": "integer"
-              },
-              "timeout_ms": {
-                "type": "number"
               }
             },
             "additionalProperties": false
           },
-          "hud": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-          },
-          "timeout_ms": {
-            "type": "number"
-          },
           "side": {
             "type": "string",
             "enum": [
               "long",
               "short"
-            ]
-          },
-          "account_name": {
-            "type": "string"
-          },
-          "readyToTrade": {
-            "type": "boolean"
+            ],
+            "description": "Required when state=open/present; otherwise filters selected orders."
           },
-          "balance": {
-            "type": "object",
-            "properties": {
-              "minWithdrawableUsd": {
-                "type": "number"
-              },
-              "minUsd": {
-                "type": "number"
-              },
-              "minSpendableUsd": {
-                "type": "number"
-              }
-            },
-            "additionalProperties": false
+          "timeout_ms": {
+            "type": "number"
           },
-          "mode": {
+          "state": {
             "type": "string",
             "enum": [
-              "matching",
-              "all"
-            ]
+              "none",
+              "absent",
+              "closed",
+              "open",
+              "present"
+            ],
+            "description": "Desired/expected selected collection state."
           }
         },
+        "required": [
+          "state"
+        ],
         "additionalProperties": false
       },
       "examples": [
         {
-          "action": "metamask.perps.start_state",
-          "profile": "clean_market_testnet",
-          "market": "BTC",
-          "positions": {
-            "state": "none"
-          },
-          "orders": {
-            "state": "none"
-          },
-          "intent": "Prepare the Perps start state for the proof",
-          "network": "testnet",
+          "action": "metamask.perps.ensure_orders",
+          "state": "none",
+          "mode": "all",
+          "intent": "Assert that no Perps order exists",
           "next": "done"
         },
         {
-          "action": "metamask.perps.start_state",
-          "profile": "open_position_testnet",
+          "action": "metamask.perps.ensure_orders",
           "market": "ETH",
-          "side": "long",
-          "positions": {
-            "state": "open",
-            "notional": "10",
-            "leverage": 2
-          },
-          "intent": "Prepare the Perps start state for the proof",
-          "network": "testnet",
+          "side": "short",
+          "state": "open",
+          "intent": "Assert that the matching ETH short order already exists",
           "next": "done"
         }
       ],
       "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
+        "host-read-export"
       ]
     },
     "metamask.perps.teardown_state": {
-      "description": "extension Recommended configurable Perps teardown state that restores the selected environment after proof.",
+      "description": "Observe and assert the requested final Extension Perps order and position state, then optionally navigate. This action never closes or cancels financial state.",
       "schema": {
         "type": "object",
         "properties": {
-          "profile": {
-            "type": "string",
-            "description": "Optional profile such as clean_market_testnet, open_position_testnet, open_order_testnet, or provider_mainnet_readonly."
-          },
-          "account": {
-            "type": "string"
-          },
-          "provider": {
-            "type": "string",
-            "description": "Requested Perps provider, e.g. hyperliquid."
-          },
-          "network": {
-            "type": "string",
-            "enum": [
-              "testnet",
-              "mainnet"
-            ]
-          },
           "market": {
             "type": "string"
           },
@@ -4125,63 +4732,6 @@
                   "present"
                 ]
               },
-              "amount": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "notional": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "size": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "leverage": {
-                "type": "number"
-              },
-              "order_type": {
-                "type": "string"
-              },
-              "orderType": {
-                "type": "string"
-              },
-              "limit_price": {
-                "type": "number"
-              },
-              "limitPrice": {
-                "type": "number"
-              },
-              "offset_pct": {
-                "type": "number"
-              },
-              "offsetPct": {
-                "type": "number"
-              },
-              "current_price": {
-                "type": "number"
-              },
-              "currentPrice": {
-                "type": "number"
-              },
-              "max_slippage_bps": {
-                "type": "number"
-              },
-              "maxSlippageBps": {
-                "type": "number"
-              },
-              "close_attempts": {
-                "type": "integer"
-              },
-              "close_retry_delay_ms": {
-                "type": "integer"
-              },
               "timeout_ms": {
                 "type": "number"
               }
@@ -4236,74 +4786,12 @@
                   "present"
                 ]
               },
-              "amount": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "notional": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "size": {
-                "type": [
-                  "string",
-                  "number"
-                ]
-              },
-              "leverage": {
-                "type": "number"
-              },
-              "order_type": {
-                "type": "string"
-              },
-              "orderType": {
-                "type": "string"
-              },
-              "limit_price": {
-                "type": "number"
-              },
-              "limitPrice": {
-                "type": "number"
-              },
-              "offset_pct": {
-                "type": "number"
-              },
-              "offsetPct": {
-                "type": "number"
-              },
-              "current_price": {
-                "type": "number"
-              },
-              "currentPrice": {
-                "type": "number"
-              },
-              "max_slippage_bps": {
-                "type": "number"
-              },
-              "maxSlippageBps": {
-                "type": "number"
-              },
-              "close_attempts": {
-                "type": "integer"
-              },
-              "close_retry_delay_ms": {
-                "type": "integer"
-              },
               "timeout_ms": {
                 "type": "number"
               }
             },
             "additionalProperties": false
           },
-          "hud": {
-            "type": "object",
-            "properties": {},
-            "additionalProperties": false
-          },
           "timeout_ms": {
             "type": "number"
           },
@@ -4314,27 +4802,6 @@
               "short"
             ]
           },
-          "account_name": {
-            "type": "string"
-          },
-          "readyToTrade": {
-            "type": "boolean"
-          },
-          "balance": {
-            "type": "object",
-            "properties": {
-              "minWithdrawableUsd": {
-                "type": "number"
-              },
-              "minUsd": {
-                "type": "number"
-              },
-              "minSpendableUsd": {
-                "type": "number"
-              }
-            },
-            "additionalProperties": false
-          },
           "mode": {
             "type": "string",
             "enum": [
@@ -4356,19 +4823,18 @@
             "state": "none"
           },
           "page": "home",
-          "intent": "Restore Perps state after the proof",
+          "intent": "Assert the final BTC Perps state and return home",
           "next": "done"
         },
         {
           "action": "metamask.perps.teardown_state",
           "market": "BTC",
-          "intent": "Restore Perps state after the proof",
+          "intent": "Assert that no matching BTC position or order exists",
           "next": "done"
         }
       ],
       "execution_capabilities": [
-        "app-mutation",
-        "external-mutation"
+        "app-mutation"
       ]
     },
     "metamask.deeplink.open": {