@deeeed/metamask-harness 0.37.0 → 0.38.0

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

@@ -432,17 +432,33 @@
           "page": {
             "type": "string",
             "enum": [
-              "home",
-              "perps",
-              "perps-market"
+          "back",
+          "home",
+          "network",
+          "perps",
+              "perps-market-list",
+              "perps-market",
+              "perps-activity",
+              "swap"
             ]
           },
           "market": {
             "type": "string"
           },
-          "symbol": {
-            "type": "string"
-          },
+      "symbol": {
+        "type": "string"
+      },
+      "network": {
+        "type": "string"
+      },
+      "chain_id": {
+        "type": "integer",
+        "minimum": 1
+      },
+      "add_if_missing": {
+        "type": "boolean",
+        "default": true
+      },
           "url": {
             "type": "string"
           },
@@ -529,6 +545,70 @@
         "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": {
@@ -1448,224 +1528,1167 @@
       ],
       "execution_capabilities": []
     },
-    "metamask.perps.read_snapshot": {
-      "description": "Read a bounded, redacted snapshot of live Extension Perps state through product background APIs.",
+    "metamask.assets.read_visible_state": {
+      "description": "Read and assert bounded visible wallet assets from an untouched Extension runtime without product background hooks.",
       "schema": {
         "type": "object",
         "properties": {
-          "include": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "enum": [
-                "account",
-                "markets",
-                "positions",
-                "orders",
-                "history",
-                "watchlist"
-              ]
-            },
-            "minItems": 1,
-            "default": [
-              "account",
-              "markets",
-              "positions",
-              "orders",
-              "history",
-              "watchlist"
-            ],
-            "description": "Sections to request. Every requested section must be available or the action fails."
+          "minimum_asset_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
           },
-          "market": {
-            "type": "string",
-            "description": "Optional single market filter."
+          "minimum_price_change_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
           },
-          "markets": {
+          "minimum_without_price_change_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "require_symbols": {
             "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 100,
-            "description": "Optional market filters applied to market-scoped sections."
+            "items": { "type": "string" },
+            "maxItems": 50
           },
-          "history": {
-            "type": "object",
-            "properties": {
-              "start_time_ms": {
-                "type": "integer",
-                "minimum": 0,
-                "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
+          "require_fiat": {
+            "type": "boolean",
+            "default": false
           },
-          "max_items_per_section": {
-            "type": "integer",
-            "minimum": 1,
-            "default": 100,
-            "description": "Maximum normalized items returned for each requested list section."
+          "require_price_change_styling": {
+            "type": "boolean",
+            "default": false
           },
-          "timeout_ms": {
+          "max_items": {
             "type": "integer",
-            "minimum": 1000,
-            "default": 20000,
-            "description": "Per-request background API timeout."
+            "minimum": 1,
+            "default": 100
           }
         },
         "additionalProperties": false
       },
       "examples": [
         {
-          "action": "metamask.perps.read_snapshot",
-          "include": [
-            "account",
-            "markets",
-            "positions",
-            "orders"
-          ],
-          "markets": [
-            "BTC",
-            "ETH"
-          ],
-          "intent": "Read the bounded Perps state needed for release validation",
+          "action": "metamask.assets.read_visible_state",
+          "minimum_asset_count": 2,
+          "require_symbols": ["USDC", "BNB"],
+          "require_fiat": true,
+          "require_price_change_styling": true,
+          "minimum_price_change_count": 1,
+          "minimum_without_price_change_count": 1,
+          "intent": "Assert live wallet assets through visible UI",
           "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.",
+    "metamask.assets.read_details": {
+      "description": "Read and assert the current Extension asset details page through visible UI.",
       "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
-          },
-          "side": {
-            "type": "string",
-            "enum": [
-              "long",
-              "short"
-            ],
-            "description": "Optional position/order side filter."
-          },
-          "timeout_ms": {
-            "type": "number"
-          }
+          "expected_symbol": { "type": "string" },
+          "require_chart": { "type": "boolean", "default": false },
+          "require_market_cap": { "type": "boolean", "default": false }
         },
         "additionalProperties": false
       },
       "examples": [
         {
-          "action": "metamask.perps.read_positions",
-          "market": "BTC",
-          "intent": "Read Perps positions needed for the proof",
+          "action": "metamask.assets.read_details",
+          "expected_symbol": "ETH",
+          "require_chart": true,
+          "require_market_cap": true,
+          "intent": "Prove the current asset details render live market data",
           "next": "done"
         }
       ],
-      "execution_capabilities": []
+      "execution_capabilities": ["host-read-export"]
     },
-    "metamask.perps.read_orders": {
-      "description": "extension Read live Perps open orders; without a selector, return all live orders.",
+    "metamask.assets.verify_sorting": {
+      "description": "Select both visible Extension asset sort modes, assert their row order, and restore declining balance.",
+      "schema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.assets.verify_sorting",
+          "intent": "Verify A-Z and fiat high-low asset sorting",
+          "next": "done"
+        }
+      ],
+      "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": {
-          "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."
-          },
+          "query": { "type": "string" },
+          "visible": { "type": "boolean" },
+          "require_unchanged": { "type": "boolean", "default": false },
+          "timeout_ms": { "type": "integer", "minimum": 1000, "default": 45000 }
+        },
+        "required": ["query", "visible"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.assets.set_token_visibility",
+          "query": "DAI",
+          "visible": true,
+          "intent": "Import DAI through live token search",
+          "next": "done"
+        }
+      ],
+      "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 }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.wallet.lock",
+          "intent": "Lock the wallet through visible UI",
+          "next": "done"
+        }
+      ],
+      "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 }
+        },
+        "required": ["network", "chain_id", "address", "expected_symbol"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.assets.import_custom_token",
+          "network": "Polygon",
+          "chain_id": 137,
+          "address": "0xc2132D05D31c914a87C6611C10748AaCbC5327aE",
+          "expected_symbol": "USDT",
+          "decimals": 6,
+          "intent": "Import Polygon USDT by contract address",
+          "next": "done"
+        }
+      ],
+      "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 }
+        },
+        "required": ["symbol", "recipient"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.assets.prepare_send",
+          "symbol": "USDC",
+          "recipient": "0x5993d2153f080470bfe765ae81f4fa5fa2080916",
+          "amount": "0.01",
+          "intent": "Prepare a tiny own-account USDC send",
+          "next": "done"
+        }
+      ],
+      "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 }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.assets.review_send",
+          "intent": "Review the prepared send and its fee",
+          "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"]
+    },
+    "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 }
+        },
+        "required": ["gas_limit"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.assets.set_custom_gas",
+          "gas_limit": 70000,
+          "intent": "Apply a custom gas limit to the reviewed send",
+          "next": "done"
+        }
+      ],
+      "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 }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.assets.select_network_scope",
+          "scope": "all",
+          "intent": "Show assets across all enabled networks",
+          "next": "done"
+        }
+      ],
+      "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 }
+        },
+        "required": ["network"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.networks.read_visible_state",
+          "network": "HyperEVM",
+          "chain_id": 999,
+          "require_symbols": ["HYPE"],
+          "settle_ms": 30000,
+          "intent": "Assert the selected custom-network balance remains visible",
+          "next": "done"
+        }
+      ],
+      "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 }
+        },
+        "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"]
+    },
+    "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 }
+        },
+        "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"]
+    },
+    "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 }
+        },
+        "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"]
+    },
+    "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 }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.swap_bridge.read_visible_state",
+          "require_amount_inputs": true,
+          "require_settings": true,
+          "intent": "Assert the visible Swap surface",
+          "next": "done"
+        }
+      ],
+      "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 }
+        },
+        "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"]
+    },
+    "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 }
+        },
+        "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"]
+    },
+    "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 }
+        },
+        "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"]
+    },
+    "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 }
+        },
+        "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"]
+    },
+    "metamask.perps.read_visible_state": {
+      "description": "Read and assert bounded visible Perps UI state from an untouched Extension runtime without product background hooks.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "surface": {
+            "type": "string",
+            "enum": ["auto", "home", "market-list", "market-details", "order-entry", "activity", "funds"],
+            "default": "auto"
+          },
+          "market": {
+            "type": "string",
+            "description": "Optional market that must be present in the visible state."
+          },
+          "direction": {
+            "type": "string",
+            "enum": ["long", "short"]
+          },
+      "order_type": {
+            "type": "string",
+            "enum": ["market", "limit"]
+          },
+          "amount": {
+            "type": ["string", "number"]
+          },
+          "percent": {
+            "type": ["string", "number"]
+          },
+          "leverage": {
+            "type": ["string", "number"]
+          },
+          "auto_close": {
+            "type": "boolean"
+          },
+          "submit_enabled": {
+            "type": "boolean"
+          },
+          "require_validation_text": {
+            "type": "array",
+            "items": { "type": "string" },
+            "maxItems": 20
+          },
+          "minimum_market_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "maximum_market_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 200
+          },
+          "minimum_position_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "maximum_position_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 200
+          },
+          "minimum_order_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "maximum_order_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 200
+          },
+          "minimum_activity_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0
+          },
+          "require_no_horizontal_overflow": {
+            "type": "boolean",
+            "default": false
+          },
+          "forbid_test_ids": {
+            "type": "array",
+            "items": { "type": "string" },
+            "maxItems": 100
+          },
+          "require_test_ids": {
+            "type": "array",
+            "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"]
+            },
+            "maxItems": 9
+          },
+          "include_offscreen": {
+            "type": "boolean",
+            "default": true
+          },
+          "max_items": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 100
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.read_visible_state",
+          "surface": "home",
+          "minimum_market_count": 1,
+          "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"]
+    },
+    "metamask.perps.select_market_filter": {
+      "description": "Select and assert a live Perps market category through trusted visible UI controls.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "filter": {
+            "type": "string",
+            "enum": ["all", "crypto", "stocks", "pre-ipo", "index", "etf", "commodities", "forex", "new"]
+          },
+          "minimum_market_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 1
+          },
+          "maximum_market_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 200
+          },
+          "max_items": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 100
+          }
+        },
+        "required": ["filter"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.select_market_filter",
+          "filter": "crypto",
+          "minimum_market_count": 1,
+          "intent": "Prove the Crypto market category through visible UI",
+          "next": "done"
+        }
+      ],
+      "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] },
+          "amount": {
+            "type": ["string", "number"],
+            "description": "Optional USD amount for a partial close; omit to close the full position."
+          }
+        },
+        "required": ["market", "confirm_live"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.close_visible_position",
+          "market": "BTC",
+          "confirm_live": true,
+          "intent": "Close the visible BTC position after the live release check",
+          "next": "done"
+        }
+      ],
+      "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 }
+        },
+        "required": ["market"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.compare_provider_market",
+          "market": "BTC",
+          "intent": "Compare the visible BTC market with the live production provider",
+          "next": "done"
+        }
+      ],
+      "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 }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.read_eligibility",
+          "intent": "Record the current release eligibility boundary",
+          "next": "done"
+        }
+      ],
+      "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" }
+        },
+        "required": ["market", "favorite"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.set_market_favorite",
+          "market": "BTC",
+          "favorite": true,
+          "intent": "Ensure BTC appears in the Perps watchlist",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["app-mutation"]
+    },
+    "metamask.perps.select_activity_filter": {
+      "description": "Select and read one live Perps activity category through semantic visible controls.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "filter": {
+            "type": "string",
+            "enum": ["trades", "orders", "funding", "deposits"]
+          }
+        },
+        "required": ["filter"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.select_activity_filter",
+          "filter": "trades",
+          "intent": "Show only Perps trade activity",
+          "next": "done"
+        }
+      ],
+      "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.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "balance_action": {
+            "type": "string",
+            "enum": ["add-funds", "withdraw"]
+          }
+        },
+        "required": ["balance_action"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.open_balance_action",
+          "balance_action": "withdraw",
+          "intent": "Open the Perps withdraw flow",
+          "next": "done"
+        }
+      ],
+      "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" },
+          "position_action": {
+            "type": "string",
+            "enum": ["add-exposure", "reduce-exposure", "reverse", "add-margin", "remove-margin", "auto-close"]
+          }
+        },
+        "required": ["market", "position_action"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.open_position_action",
+          "market": "BTC",
+          "position_action": "add-margin",
+          "intent": "Open Add margin for the BTC position",
+          "next": "done"
+        }
+      ],
+      "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" }
+        },
+        "required": ["market", "amount", "confirm_live"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.edit_margin",
+          "market": "BTC",
+          "margin_action": "add",
+          "amount": 1,
+          "confirm_live": true,
+          "intent": "Add one USDC of margin to the BTC position",
+          "next": "done"
+        }
+      ],
+      "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" }
+        },
+        "required": ["market", "confirm_live"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.update_position_tpsl",
+          "market": "BTC",
+          "take_profit_price": 65000,
+          "stop_loss_price": 55000,
+          "confirm_live": true,
+          "intent": "Update BTC position auto-close prices",
+          "next": "done"
+        }
+      ],
+      "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" }
+        },
+        "required": ["enabled"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.settings.set_basic_functionality",
+          "enabled": false,
+          "intent": "Turn Basic Functionality off through Privacy settings",
+          "next": "done"
+        }
+      ],
+      "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" }
+        },
+        "required": ["mode"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.read_funds_confirmation",
+          "mode": "withdraw",
+          "intent": "Read the Perps withdraw fee and receive context",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": ["host-read-export"]
+    },
+    "metamask.perps.read_snapshot": {
+      "description": "Read a bounded, redacted snapshot of live Extension Perps state through product background APIs.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "include": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "account",
+                "markets",
+                "positions",
+                "orders",
+                "history",
+                "watchlist"
+              ]
+            },
+            "minItems": 1,
+            "default": [
+              "account",
+              "markets",
+              "positions",
+              "orders",
+              "history",
+              "watchlist"
+            ],
+            "description": "Sections to request. Every requested section must be available or the action fails."
+          },
+          "market": {
+            "type": "string",
+            "description": "Optional single market filter."
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 100,
+            "description": "Optional market filters applied to market-scoped sections."
+          },
+          "history": {
+            "type": "object",
+            "properties": {
+              "start_time_ms": {
+                "type": "integer",
+                "minimum": 0,
+                "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
+          },
+          "max_items_per_section": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 100,
+            "description": "Maximum normalized items returned for each requested list section."
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1000,
+            "default": 20000,
+            "description": "Per-request background API timeout."
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.read_snapshot",
+          "include": [
+            "account",
+            "markets",
+            "positions",
+            "orders"
+          ],
+          "markets": [
+            "BTC",
+            "ETH"
+          ],
+          "intent": "Read the bounded Perps state needed for release validation",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": []
+    },
+    "metamask.perps.read_positions": {
+      "description": "extension Read live Perps positions; without a selector, return all live positions.",
+      "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
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ],
+            "description": "Optional position/order side filter."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.read_positions",
+          "market": "BTC",
+          "intent": "Read Perps positions needed for the proof",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": []
+    },
+    "metamask.perps.read_orders": {
+      "description": "extension Read live Perps open orders; without a selector, return all live 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."
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Explicit list of market symbols."
+          },
           "symbols": {
             "type": "array",
             "items": {
@@ -1935,6 +2958,10 @@
           },
           "timeout_ms": {
             "type": "number"
+          },
+      "confirm_live": {
+            "type": "boolean",
+            "description": "Required when cancellation uses visible controls against the live provider."
           }
         },
         "additionalProperties": false
@@ -2063,6 +3090,45 @@
           "leverage": {
             "type": "number",
             "default": 3
+          },
+          "order_type": {
+            "type": "string",
+            "enum": [
+              "market",
+              "limit"
+            ],
+            "default": "market"
+          },
+          "position_mode": {
+            "type": "string",
+            "enum": [
+              "new",
+              "modify"
+            ],
+            "default": "new"
+          },
+          "submit_attempts": {
+            "type": "integer",
+            "enum": [
+              1,
+              2
+            ],
+            "default": 1,
+            "description": "Dispatch one or two immediate trusted-pointer submissions; two asserts exactly one new limit order."
+          },
+          "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