@deeeed/metamask-harness 0.2.0

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

@@ -0,0 +1,1749 @@
+{
+  "runner_protocol_version": 1,
+  "action_registry_version": 1,
+  "supported_official_actions": [
+    "command",
+    "wait",
+    "assert_file",
+    "assert_json",
+    "assert_exit_code",
+    "assert_output",
+    "watch_logs",
+    "index_artifacts",
+    "end",
+    "ui.navigate",
+    "ui.press",
+    "ui.key_press",
+    "ui.set_input",
+    "ui.scroll",
+    "ui.wait_for",
+    "ui.screenshot",
+    "app.status",
+    "app.hud",
+    "cdp.target"
+  ],
+  "action_metadata": {
+    "command": {
+      "description": "Run a shell command from the project root.",
+      "examples": [
+        {
+          "node": {
+            "action": "command",
+            "cmd": "pwd",
+            "intent": "Run a shell command from the project root"
+          }
+        }
+      ]
+    },
+    "wait": {
+      "description": "Base wait action.",
+      "examples": [
+        {
+          "node": {
+            "action": "wait",
+            "duration_ms": 1,
+            "intent": "Base wait action"
+          }
+        }
+      ]
+    },
+    "watch_logs": {
+      "description": "Base log assertion/capture action.",
+      "examples": [
+        {
+          "node": {
+            "action": "watch_logs",
+            "path": "logs/app.log",
+            "intent": "Base log assertion/capture action"
+          }
+        }
+      ]
+    },
+    "index_artifacts": {
+      "description": "Index extra recipe-authored artifacts that already exist on disk. Do not use after ui.screenshot; screenshots are registered by the runner.",
+      "examples": [
+        {
+          "node": {
+            "action": "index_artifacts",
+            "artifacts": [
+              {
+                "path": "reports/result.json",
+                "type": "report",
+                "category": "validation",
+                "label": "Validation report"
+              }
+            ],
+            "intent": "Register a pre-existing report artifact"
+          }
+        }
+      ]
+    },
+    "end": {
+      "description": "Base terminal action.",
+      "examples": [
+        {
+          "node": {
+            "action": "end",
+            "status": "pass"
+          }
+        }
+      ]
+    },
+    "ui.navigate": {
+      "description": "Navigate with either raw extension url/hash/path or a small stable page alias. Discover supported aliases here before hardcoding routes.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "page": {
+            "type": "string",
+            "enum": [
+              "home",
+              "perps",
+              "perps-market"
+            ],
+            "description": "Small stable page aliases; use raw route/hash when you need a route outside this list."
+          },
+          "market": {
+            "type": "string",
+            "description": "Market symbol for page=perps-market, e.g. ETH."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "url": {
+            "type": "string",
+            "description": "Raw extension URL."
+          },
+          "hash": {
+            "type": "string",
+            "description": "Raw extension hash, e.g. #/?tab=perps."
+          },
+          "path": {
+            "type": "string",
+            "description": "Alias for hash."
+          }
+        }
+      },
+      "examples": [
+        {
+          "description": "Open Perps through the stable alias",
+          "node": {
+            "action": "ui.navigate",
+            "page": "perps",
+            "intent": "Open Perps"
+          }
+        },
+        {
+          "description": "Open a Perps market through the stable alias",
+          "node": {
+            "action": "ui.navigate",
+            "page": "perps-market",
+            "market": "ETH",
+            "intent": "Open ETH Perps market"
+          }
+        },
+        {
+          "description": "Fallback to a raw extension hash when no alias exists",
+          "node": {
+            "action": "ui.navigate",
+            "hash": "#/?tab=perps",
+            "intent": "Open a raw extension route"
+          }
+        }
+      ]
+    },
+    "ui.press": {
+      "description": "Press/tap/click a UI target through the platform adapter.",
+      "examples": [
+        {
+          "node": {
+            "action": "ui.press",
+            "target": "Perps",
+            "intent": "Press/tap/click a UI target through the platform adapter"
+          }
+        }
+      ]
+    },
+    "ui.scroll": {
+      "description": "Scroll through the UI through the Farmslot base platform adapter. Supports deltas and scroll_into_view for selector/test-id proof positioning.",
+      "examples": [
+        {
+          "node": {
+            "action": "ui.scroll",
+            "delta_y": 300,
+            "intent": "Scroll through the UI through the Farmslot base platform adapter. Supports deltas and scroll_into_view for selector/test-id proof positioning"
+          }
+        },
+        {
+          "description": "Bring a web selector into view before screenshot proof",
+          "node": {
+            "action": "ui.scroll",
+            "selector": "[data-testid=\"example\"]",
+            "scroll_into_view": true,
+            "intent": "Bring a web selector into view before screenshot proof"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must include a passing ui-scroll-into-view trace event with output.intoView=true."
+    },
+    "ui.wait_for": {
+      "description": "Wait for a UI condition through the Extension CDP adapter.",
+      "examples": [
+        {
+          "node": {
+            "action": "ui.wait_for",
+            "text": "Perps",
+            "intent": "Wait for visible Extension text"
+          }
+        }
+      ]
+    },
+    "ui.screenshot": {
+      "description": "Capture visual evidence through capture-helper snapshot; the runner registers the screenshot artifact automatically. CDP/DOM-raster fallback is not valid Extension evidence.",
+      "examples": [
+        {
+          "node": {
+            "action": "ui.screenshot",
+            "path": "screenshots/example.png",
+            "intent": "Capture visual evidence after a wait/assert step"
+          }
+        }
+      ]
+    },
+    "assert_file": {
+      "description": "Assert that a project file exists and optionally contains text.",
+      "examples": [
+        {
+          "node": {
+            "action": "assert_file",
+            "path": "reports/result.txt",
+            "contains": "ok",
+            "intent": "Assert that a project file exists and optionally contains text"
+          }
+        }
+      ]
+    },
+    "assert_json": {
+      "description": "Assert a JSON file value with a JSONPath-style selector.",
+      "examples": [
+        {
+          "node": {
+            "action": "assert_json",
+            "path": "reports/result.json",
+            "assert": {
+              "path": "$.status",
+              "operator": "eq",
+              "value": "ok"
+            },
+            "intent": "Assert a JSON file value with a JSONPath-style selector"
+          }
+        }
+      ]
+    },
+    "assert_exit_code": {
+      "description": "Assert the exit code captured from a command node output.",
+      "examples": [
+        {
+          "node": {
+            "action": "assert_exit_code",
+            "source": "run-tests",
+            "expected": 0,
+            "intent": "Assert the exit code captured from a command node output"
+          }
+        }
+      ]
+    },
+    "assert_output": {
+      "description": "Assert stdout or stderr captured from a command node output.",
+      "examples": [
+        {
+          "node": {
+            "action": "assert_output",
+            "source": "run-tests",
+            "stream": "stdout",
+            "contains": "PASS",
+            "intent": "Assert stdout or stderr captured from a command node output"
+          }
+        }
+      ]
+    },
+    "app.hud": {
+      "description": "Display minimal human-readable recipe progress. The intent must explain the current agent goal; debug metadata and flow/domain labels are hidden unless explicitly opted in.",
+      "examples": [
+        {
+          "description": "Default one-intent progress HUD",
+          "node": {
+            "action": "app.hud",
+            "status": "running",
+            "intent": "Open a small ETH long position",
+            "progress": {
+              "current": 12,
+              "total": 19
+            }
+          }
+        }
+      ],
+      "safety_notes": "HUD is reviewer feedback only. It must not mutate product state or carry task assertions; trace/artifacts remain authoritative.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": [
+              "running",
+              "pass",
+              "fail"
+            ]
+          },
+          "intent": {
+            "type": "string"
+          },
+          "progress": {
+            "type": "object",
+            "properties": {
+              "current": {
+                "type": "number"
+              },
+              "total": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "current",
+              "total"
+            ]
+          },
+          "detail": {
+            "type": "string"
+          },
+          "error": {
+            "type": "string"
+          },
+          "display": {
+            "type": "object",
+            "properties": {
+              "showDetail": {
+                "type": "boolean"
+              },
+              "showDebug": {
+                "type": "boolean"
+              },
+              "showTitle": {
+                "type": "boolean"
+              },
+              "layout": {
+                "type": "string"
+              },
+              "position": {
+                "type": "string"
+              }
+            }
+          },
+          "clear": {
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    "ui.set_input": {
+      "description": "Set text on an extension DOM input through the CDP UI transport.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "selector": {
+            "type": "string"
+          },
+          "test_id": {
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "next": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": true
+      },
+      "examples": [
+        {
+          "node": {
+            "action": "ui.set_input",
+            "selector": "[data-testid=multichain-account-list-search] input",
+            "value": "Account",
+            "intent": "Set text on an extension DOM input through the CDP UI transport"
+          }
+        }
+      ]
+    },
+    "ui.key_press": {
+      "description": "Send a trusted keyboard press to the currently focused UI element through the UI transport.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "next": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "additionalProperties": true
+      },
+      "examples": [
+        {
+          "node": {
+            "action": "ui.key_press",
+            "key": "Enter",
+            "intent": "Send a trusted Enter key press to the focused UI element"
+          }
+        }
+      ]
+    }
+  },
+  "custom_actions": [
+    {
+      "name": "metamask.wallet.fixture_status",
+      "owner": "metamask",
+      "description": "extension manifest-declared action metamask.wallet.fixture_status.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.wallet.fixture_status"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Minimal node",
+          "node": {
+            "action": "metamask.wallet.fixture_status",
+            "intent": "Check wallet fixture status"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.wallet.setup",
+      "owner": "metamask",
+      "description": "extension manifest-declared action metamask.wallet.setup.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.wallet.setup"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Minimal node",
+          "node": {
+            "action": "metamask.wallet.setup",
+            "intent": "Prepare the wallet fixture for recipe execution"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.wallet.ensure_unlocked",
+      "owner": "metamask",
+      "description": "extension manifest-declared action metamask.wallet.ensure_unlocked.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.wallet.ensure_unlocked"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Minimal node",
+          "node": {
+            "action": "metamask.wallet.ensure_unlocked",
+            "intent": "Ensure the wallet is unlocked before proof steps"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.wallet.select_account",
+      "description": "extension action to select a wallet account by address, id, or display name.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.wallet.select_account"
+          },
+          "address": {
+            "type": "string",
+            "description": "EVM address of the account to select."
+          },
+          "id": {
+            "type": "string",
+            "description": "Internal account id to select."
+          },
+          "name": {
+            "type": "string",
+            "description": "Display name of the account to select."
+          }
+        },
+        "required": [
+          "action"
+        ],
+        "anyOf": [
+          {
+            "required": [
+              "address"
+            ]
+          },
+          {
+            "required": [
+              "id"
+            ]
+          },
+          {
+            "required": [
+              "name"
+            ]
+          }
+        ]
+      },
+      "examples": [
+        {
+          "description": "Select by deterministic fixture address",
+          "node": {
+            "action": "metamask.wallet.select_account",
+            "address": "0x8dc623e964475d4d669da601fd15ea9125469003",
+            "intent": "Select the requested wallet account"
+          }
+        },
+        {
+          "description": "Select by fixture display name",
+          "node": {
+            "action": "metamask.wallet.select_account",
+            "name": "dev1",
+            "intent": "Select the requested wallet account"
+          }
+        }
+      ]
+    },
+    {
+      "name": "metamask.wallet.read_state",
+      "owner": "metamask",
+      "description": "extension manifest-declared action metamask.wallet.read_state.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.wallet.read_state"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Minimal node",
+          "node": {
+            "action": "metamask.wallet.read_state",
+            "intent": "Read wallet state needed for the proof"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.read_positions",
+      "owner": "metamask",
+      "description": "extension Read live Perps positions and return the selected subset.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.perps.read_positions"
+          },
+          "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",
+            "description": "Optional structured selector with mode, symbols/markets, and side."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ],
+            "description": "Optional position/order side filter."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Read selected live state",
+          "node": {
+            "action": "metamask.perps.read_positions",
+            "market": "BTC",
+            "intent": "Read Perps positions needed for the proof"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.read_orders",
+      "owner": "metamask",
+      "description": "extension Read live Perps open orders and return the selected subset.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.perps.read_orders"
+          },
+          "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",
+            "description": "Optional structured selector with mode, symbols/markets, and side."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ],
+            "description": "Optional position/order side filter."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Read selected live state",
+          "node": {
+            "action": "metamask.perps.read_orders",
+            "market": "BTC",
+            "intent": "Read Perps open orders needed for the proof"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.close_positions",
+      "owner": "metamask",
+      "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.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.perps.close_positions"
+          },
+          "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",
+            "description": "Optional structured selector with mode, symbols/markets, and side."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ],
+            "description": "Optional position/order side filter."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Close every open position",
+          "node": {
+            "action": "metamask.perps.close_positions",
+            "mode": "all",
+            "intent": "Close selected Perps positions before continuing",
+            "network": "testnet"
+          }
+        },
+        {
+          "description": "Close selected BTC/ETH positions",
+          "node": {
+            "action": "metamask.perps.close_positions",
+            "markets": [
+              "BTC",
+              "ETH"
+            ],
+            "intent": "Close selected Perps positions before continuing",
+            "network": "testnet"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.close_orders",
+      "owner": "metamask",
+      "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": {
+          "action": {
+            "const": "metamask.perps.close_orders"
+          },
+          "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",
+            "description": "Optional structured selector with mode, symbols/markets, and side."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ],
+            "description": "Optional position/order side filter."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Cancel every open order",
+          "node": {
+            "action": "metamask.perps.close_orders",
+            "mode": "all",
+            "intent": "Cancel selected Perps orders before continuing",
+            "network": "testnet"
+          }
+        },
+        {
+          "description": "Cancel BTC orders only",
+          "node": {
+            "action": "metamask.perps.close_orders",
+            "market": "BTC",
+            "intent": "Cancel selected Perps orders before continuing",
+            "network": "testnet"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.place_order",
+      "owner": "metamask",
+      "description": "extension Place a Perps order through a supported app/API path. Default to testnet; mainnet order placement requires an explicit user request.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.perps.place_order"
+          },
+          "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",
+            "description": "Optional structured selector with mode, symbols/markets, and side."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ],
+            "description": "Optional position/order side filter."
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "amount": {
+            "type": "string",
+            "description": "USD amount/notional alias."
+          },
+          "notional": {
+            "type": "string",
+            "description": "USD notional alias."
+          },
+          "size": {
+            "type": "string",
+            "description": "Base asset size when supported."
+          },
+          "leverage": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Place BTC market order",
+          "node": {
+            "action": "metamask.perps.place_order",
+            "market": "BTC",
+            "side": "long",
+            "notional": "10",
+            "leverage": 2,
+            "intent": "Place the requested Perps order",
+            "network": "testnet"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.assert_positions",
+      "owner": "metamask",
+      "description": "extension Assert selected live Perps positions are present or absent.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.perps.assert_positions"
+          },
+          "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",
+            "description": "Optional structured selector with mode, symbols/markets, and side."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ],
+            "description": "Optional position/order side filter."
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "none",
+              "absent",
+              "closed",
+              "open",
+              "present"
+            ],
+            "description": "Desired/expected selected collection state."
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Assert BTC position is open",
+          "node": {
+            "action": "metamask.perps.assert_positions",
+            "state": "open",
+            "market": "BTC",
+            "intent": "Assert the expected Perps position state"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.assert_orders",
+      "owner": "metamask",
+      "description": "extension Assert selected live Perps open orders are present or absent.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.perps.assert_orders"
+          },
+          "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",
+            "description": "Optional structured selector with mode, symbols/markets, and side."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ],
+            "description": "Optional position/order side filter."
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "none",
+              "absent",
+              "closed",
+              "open",
+              "present"
+            ],
+            "description": "Desired/expected selected collection state."
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Assert no BTC open orders",
+          "node": {
+            "action": "metamask.perps.assert_orders",
+            "state": "none",
+            "market": "BTC",
+            "intent": "Assert the expected Perps open order state"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.ensure_positions",
+      "owner": "metamask",
+      "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.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.perps.ensure_positions"
+          },
+          "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",
+            "description": "Optional structured selector with mode, symbols/markets, and side."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ],
+            "description": "Optional position/order side filter."
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "none",
+              "absent",
+              "closed",
+              "open",
+              "present"
+            ],
+            "description": "Desired/expected selected collection state."
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Ensure no BTC position before proof window",
+          "node": {
+            "action": "metamask.perps.ensure_positions",
+            "state": "none",
+            "market": "BTC",
+            "intent": "Converge Perps positions to the requested state",
+            "network": "testnet"
+          }
+        },
+        {
+          "description": "Ensure any existing positions are closed",
+          "node": {
+            "action": "metamask.perps.ensure_positions",
+            "state": "none",
+            "mode": "all",
+            "intent": "Converge Perps positions to the requested state",
+            "network": "testnet"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.ensure_orders",
+      "owner": "metamask",
+      "description": "extension Default to testnet for Perps mutations; mainnet is read-only unless explicitly requested. Higher-level wrapper that reads selected orders, cancels when needed, then asserts final order state.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.perps.ensure_orders"
+          },
+          "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",
+            "description": "Optional structured selector with mode, symbols/markets, and side."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ],
+            "description": "Optional position/order side filter."
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "none",
+              "absent",
+              "closed",
+              "open",
+              "present"
+            ],
+            "description": "Desired/expected selected collection state."
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Ensure no open orders before proof window",
+          "node": {
+            "action": "metamask.perps.ensure_orders",
+            "state": "none",
+            "mode": "all",
+            "intent": "Converge Perps orders to the requested state",
+            "network": "testnet"
+          }
+        }
+      ],
+      "proof_effect": "E2E validation must record this action in trace.json; live-proof actions include liveAdapter/proofPath or target runtime output.",
+      "safety_notes": "Must not inject mid-recipe UI/app state to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.start_state",
+      "owner": "metamask",
+      "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": {
+          "action": {
+            "const": "metamask.perps.start_state"
+          },
+          "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": {
+            "oneOf": [
+              {
+                "type": "string"
+              },
+              {
+                "const": false
+              }
+            ],
+            "description": "Final page target; false skips navigation for teardown."
+          },
+          "positions": {
+            "oneOf": [
+              {
+                "type": "object"
+              },
+              {
+                "const": false
+              }
+            ],
+            "description": "Desired position baseline or false to skip."
+          },
+          "orders": {
+            "oneOf": [
+              {
+                "type": "object"
+              },
+              {
+                "const": false
+              }
+            ],
+            "description": "Desired open-order baseline or false to skip."
+          },
+          "hud": {
+            "type": "object"
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Clean BTC testnet market state",
+          "node": {
+            "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"
+          }
+        },
+        {
+          "description": "Start with an open ETH long position",
+          "node": {
+            "action": "metamask.perps.start_state",
+            "profile": "open_position_testnet",
+            "market": "ETH",
+            "side": "long",
+            "positions": {
+              "state": "open",
+              "notional": "10",
+              "leverage": 2
+            },
+            "intent": "Prepare the Perps start state for the proof",
+            "network": "testnet"
+          }
+        }
+      ],
+      "proof_effect": "Runs in setup/teardown phase and must be visible in trace.json; proof videos can keep this as trace-only setup.",
+      "safety_notes": "Composes supported app/API paths and must not mutate React/Redux/MobX/DOM/local storage to fabricate proof."
+    },
+    {
+      "name": "metamask.perps.teardown_state",
+      "owner": "metamask",
+      "description": "extension Recommended configurable Perps teardown state that restores the selected environment after proof.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "const": "metamask.perps.teardown_state"
+          },
+          "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": {
+            "oneOf": [
+              {
+                "type": "string"
+              },
+              {
+                "const": false
+              }
+            ],
+            "description": "Final page target; false skips navigation for teardown."
+          },
+          "positions": {
+            "oneOf": [
+              {
+                "type": "object"
+              },
+              {
+                "const": false
+              }
+            ],
+            "description": "Desired position baseline or false to skip."
+          },
+          "orders": {
+            "oneOf": [
+              {
+                "type": "object"
+              },
+              {
+                "const": false
+              }
+            ],
+            "description": "Desired open-order baseline or false to skip."
+          },
+          "hud": {
+            "type": "object"
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "action"
+        ]
+      },
+      "examples": [
+        {
+          "description": "Return BTC test account to clean state",
+          "node": {
+            "action": "metamask.perps.teardown_state",
+            "market": "BTC",
+            "positions": {
+              "state": "none"
+            },
+            "orders": {
+              "state": "none"
+            },
+            "page": "home",
+            "intent": "Restore Perps state after the proof"
+          }
+        },
+        {
+          "description": "Teardown only state created by selected market",
+          "node": {
+            "action": "metamask.perps.teardown_state",
+            "market": "BTC",
+            "intent": "Restore Perps state after the proof"
+          }
+        }
+      ],
+      "proof_effect": "Runs in setup/teardown phase and must be visible in trace.json; proof videos can keep this as trace-only setup.",
+      "safety_notes": "Composes supported app/API paths and must not mutate React/Redux/MobX/DOM/local storage to fabricate proof."
+    }
+  ],
+  "state_refs": [
+    {
+      "name": "wallet.redacted_state",
+      "description": "Redacted wallet state reported by metamask.wallet.read_state."
+    },
+    {
+      "name": "perps.positions",
+      "description": "Normalized Perps position state."
+    }
+  ],
+  "pre_conditions": [
+    {
+      "id": "no-mid-recipe-state-injection",
+      "description": "Recipes must drive real supported UI/app/API paths for proof state."
+    }
+  ],
+  "native_bindings": [
+    {
+      "action": "command",
+      "implementation": "@farmslot/recipe-harness/adapters/core"
+    },
+    {
+      "action": "wait",
+      "implementation": "@farmslot/recipe-harness/adapters/core"
+    },
+    {
+      "action": "assert_file",
+      "implementation": "@farmslot/recipe-harness/adapters/core"
+    },
+    {
+      "action": "assert_json",
+      "implementation": "@farmslot/recipe-harness/adapters/core"
+    },
+    {
+      "action": "assert_exit_code",
+      "implementation": "@farmslot/recipe-harness/adapters/core"
+    },
+    {
+      "action": "assert_output",
+      "implementation": "@farmslot/recipe-harness/adapters/core"
+    },
+    {
+      "action": "watch_logs",
+      "implementation": "@farmslot/recipe-harness/adapters/core"
+    },
+    {
+      "action": "index_artifacts",
+      "implementation": "@farmslot/recipe-harness/adapters/core"
+    },
+    {
+      "action": "end",
+      "implementation": "@farmslot/recipe-harness/adapters/core"
+    },
+    {
+      "action": "ui.navigate",
+      "implementation": "@farmslot/recipe-harness/runtime/cdp"
+    },
+    {
+      "action": "ui.press",
+      "implementation": "@farmslot/recipe-harness/runtime/cdp"
+    },
+    {
+      "action": "ui.key_press",
+      "implementation": "@farmslot/recipe-harness/runtime/cdp"
+    },
+    {
+      "action": "ui.set_input",
+      "implementation": "@metamask/recipe-runner/extension/cdp-set-input"
+    },
+    {
+      "action": "ui.scroll",
+      "implementation": "@farmslot/recipe-harness/runtime/cdp"
+    },
+    {
+      "action": "ui.wait_for",
+      "implementation": "@farmslot/recipe-harness/runtime/cdp"
+    },
+    {
+      "action": "ui.screenshot",
+      "implementation": "@farmslot/recipe-harness/runtime/cdp"
+    },
+    {
+      "action": "app.status",
+      "implementation": "@metamask/recipe-runner/platform-status"
+    },
+    {
+      "action": "app.hud",
+      "implementation": "@farmslot/recipe-harness/runtime/cdp"
+    },
+    {
+      "action": "cdp.target",
+      "implementation": "@metamask/recipe-runner/platform-cdp-target"
+    },
+    {
+      "action": "metamask.wallet.fixture_status",
+      "implementation": "@metamask/recipe-runner/extension/wallet"
+    },
+    {
+      "action": "metamask.wallet.setup",
+      "implementation": "@metamask/recipe-runner/extension/wallet"
+    },
+    {
+      "action": "metamask.wallet.ensure_unlocked",
+      "implementation": "@metamask/recipe-runner/extension/wallet"
+    },
+    {
+      "action": "metamask.wallet.select_account",
+      "implementation": "@metamask/recipe-runner/extension/wallet"
+    },
+    {
+      "action": "metamask.wallet.read_state",
+      "implementation": "@metamask/recipe-runner/extension/wallet"
+    },
+    {
+      "action": "metamask.perps.read_positions",
+      "implementation": "@metamask/recipe-runner/extension/perps"
+    },
+    {
+      "action": "metamask.perps.read_orders",
+      "implementation": "@metamask/recipe-runner/extension/perps"
+    },
+    {
+      "action": "metamask.perps.close_positions",
+      "implementation": "@metamask/recipe-runner/extension/perps"
+    },
+    {
+      "action": "metamask.perps.close_orders",
+      "implementation": "@metamask/recipe-runner/extension/perps"
+    },
+    {
+      "action": "metamask.perps.place_order",
+      "implementation": "@metamask/recipe-runner/extension/perps"
+    },
+    {
+      "action": "metamask.perps.assert_positions",
+      "implementation": "@metamask/recipe-runner/extension/perps"
+    },
+    {
+      "action": "metamask.perps.assert_orders",
+      "implementation": "@metamask/recipe-runner/extension/perps"
+    },
+    {
+      "action": "metamask.perps.ensure_positions",
+      "implementation": "@metamask/recipe-runner/extension/perps"
+    },
+    {
+      "action": "metamask.perps.ensure_orders",
+      "implementation": "@metamask/recipe-runner/extension/perps"
+    },
+    {
+      "action": "metamask.perps.start_state",
+      "implementation": "@metamask/recipe-runner/extension/perps-domain-dispatcher"
+    },
+    {
+      "action": "metamask.perps.teardown_state",
+      "implementation": "@metamask/recipe-runner/extension/perps-domain-dispatcher"
+    }
+  ],
+  "capability_notes": [
+    "Perps safety: default to testnet for setup and order/position mutations. Mainnet is read-only unless the user explicitly requests a mainnet mutation."
+  ],
+  "action_profiles": []
+}