@deeeed/metamask-harness 0.70.0 → 0.71.0

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

@@ -0,0 +1,1786 @@
+{
+  "$schema": "https://farmslot.io/schemas/action-manifest-v1.schema.json",
+  "actions": {
+    "app.status": {
+      "description": "Report the platform, checkout path and repository shape of the Web Terminal checkout.",
+      "examples": [
+        {
+          "action": "app.status",
+          "intent": "Record the resolved application state before continuing.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      }
+    },
+    "app.hud": {
+      "description": "Display recipe progress in an overlay on the terminal app tab: recipe, step N/M, the current node intent and the last pass/fail. Never drawn in MetaMask's own pages; ignored by clicks and page text. --hud auto shows it only when the browser is headful.",
+      "examples": [
+        {
+          "action": "app.hud",
+          "status": "running",
+          "intent": "Show the current goal to the supervising human.",
+          "progress": {
+            "current": 12,
+            "total": 19
+          },
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "clear": {
+            "type": "boolean"
+          },
+          "title": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "running",
+              "pass",
+              "fail"
+            ]
+          },
+          "node_id": {
+            "type": "string"
+          },
+          "nodeId": {
+            "type": "string"
+          },
+          "phase": {
+            "type": "string"
+          },
+          "action_name": {
+            "type": "string"
+          },
+          "recipe_action": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "detail": {
+            "type": "string"
+          },
+          "error": {
+            "type": "string"
+          },
+          "display": {
+            "type": "object"
+          },
+          "progress": {
+            "type": "object"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "assert_exit_code": {
+      "description": "Assert the exit code captured from a command node output.",
+      "examples": [
+        {
+          "action": "assert_exit_code",
+          "source": "run-tests",
+          "expected": 0,
+          "intent": "Confirm the project command completed with the expected result.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "node": {
+            "type": "string"
+          },
+          "expected": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "assert_file": {
+      "description": "Assert that a project file exists and optionally contains text.",
+      "examples": [
+        {
+          "action": "assert_file",
+          "path": "reports/result.txt",
+          "contains": "ok",
+          "intent": "Confirm the requested project file state.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "contains": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "assert_json": {
+      "description": "Assert a JSON file value with a JSONPath-style selector.",
+      "examples": [
+        {
+          "action": "assert_json",
+          "path": "reports/result.json",
+          "assert": {
+            "path": "$.status",
+            "operator": "eq",
+            "value": "ok"
+          },
+          "intent": "Confirm the recorded data satisfies the requested condition.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "assert": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              },
+              "operator": {
+                "type": "string"
+              },
+              "value": {
+                "type": [
+                  "string",
+                  "number",
+                  "integer",
+                  "boolean",
+                  "object",
+                  "array"
+                ],
+                "items": {
+                  "type": [
+                    "string",
+                    "number",
+                    "integer",
+                    "boolean",
+                    "object"
+                  ]
+                }
+              },
+              "all": {
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
+              },
+              "any": {
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
+              },
+              "none": {
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "required": [
+          "path",
+          "assert"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "assert_output": {
+      "description": "Assert a previous node's stdout/stderr with contains or match, or compare a structured output field using assert.path and an operator such as eq or length_eq.",
+      "examples": [
+        {
+          "action": "assert_output",
+          "source": "run-tests",
+          "stream": "stdout",
+          "contains": "PASS",
+          "intent": "Confirm the recorded output satisfies the requested condition.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "node": {
+            "type": "string"
+          },
+          "stream": {
+            "type": "string"
+          },
+          "contains": {
+            "type": "string"
+          },
+          "match": {
+            "type": "string"
+          },
+          "assert": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              },
+              "operator": {
+                "type": "string"
+              },
+              "value": {
+                "type": [
+                  "string",
+                  "number",
+                  "integer",
+                  "boolean",
+                  "object",
+                  "array"
+                ],
+                "items": {
+                  "type": [
+                    "string",
+                    "number",
+                    "integer",
+                    "boolean",
+                    "object"
+                  ]
+                }
+              },
+              "all": {
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
+              },
+              "any": {
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
+              },
+              "none": {
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "call": {
+      "description": "Invoke a named recipe by ref and run its steps inline.",
+      "examples": [
+        {
+          "action": "call",
+          "ref": "shared/setup",
+          "intent": "Run a shared recipe",
+          "next": "done"
+        }
+      ]
+    },
+    "cdp.target": {
+      "description": "Probe the slot browser Chrome CDP endpoint and report whether it is reachable.",
+      "examples": [
+        {
+          "action": "cdp.target",
+          "cdp_port": 9323,
+          "required": true,
+          "intent": "Confirm the requested application target is available.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "cdp_port": {
+            "type": "number"
+          },
+          "metro_port": {
+            "type": "number"
+          },
+          "watcher_port": {
+            "type": "number"
+          },
+          "probe_timeout_ms": {
+            "type": "number"
+          },
+          "cdp_timeout_ms": {
+            "type": "number"
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "require_reachable": {
+            "type": "boolean"
+          },
+          "required": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "end": {
+      "description": "Base terminal action.",
+      "examples": [
+        {
+          "action": "end",
+          "status": "pass"
+        }
+      ]
+    },
+    "index_artifacts": {
+      "description": "Index extra recipe-authored artifacts that already exist on disk.",
+      "examples": [
+        {
+          "action": "index_artifacts",
+          "artifacts": [
+            {
+              "path": "reports/result.json",
+              "type": "report",
+              "category": "validation",
+              "label": "Validation report"
+            }
+          ],
+          "intent": "Preserve generated evidence in the review package.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "artifacts": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "object"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string"
+                },
+                "type": {
+                  "type": "string"
+                },
+                "label": {
+                  "type": "string"
+                },
+                "nodeId": {
+                  "type": "string"
+                },
+                "mimeType": {
+                  "type": "string"
+                },
+                "category": {
+                  "type": "string"
+                },
+                "proofTarget": {
+                  "type": "string"
+                },
+                "covers": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "artifacts"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "metamask.app.launch": {
+      "description": "Explicit lifecycle step: start or reuse the terminal slot browser with signer=extension (MetaMask extension with the fixture account imported) or signer=injected (strict test wallet), plus the wallet host that records wallet requests. fresh_profile forgets the stored agent key and dapp permission.",
+      "execution_capabilities": [
+        "app-mutation"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "signer": {
+            "type": "string",
+            "enum": [
+              "extension",
+              "injected"
+            ],
+            "default": "extension"
+          },
+          "account": {
+            "type": "string",
+            "default": "dev1"
+          },
+          "account_name": {
+            "type": "string"
+          },
+          "fresh_profile": {
+            "type": "boolean"
+          },
+          "headless": {
+            "type": "boolean",
+            "description": "true starts the browser headless; false forces a visible window. Default: env TERMINAL_HEADLESS, else headful."
+          },
+          "headful": {
+            "type": "boolean",
+            "description": "Older spelling of headless: false."
+          },
+          "slow_mo_ms": {
+            "type": "number",
+            "description": "Delay before each UI action in ms. Default: env TERMINAL_SLOW_MO, else 0."
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "default": "testnet",
+            "description": "testnet requires the slot dev server to force Hyperliquid testnet; mainnet requires mainnet_confirmation."
+          },
+          "mainnet_confirmation": {
+            "type": "string",
+            "description": "REAL_FUNDS to launch against a mainnet dev server."
+          },
+          "start_chain": {
+            "type": "number",
+            "description": "injected mode: the wallet active chain (default 42161)."
+          },
+          "cdp_port": {
+            "type": "number"
+          },
+          "app_port": {
+            "type": "number"
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.app.launch",
+          "signer": "extension",
+          "account": "dev1",
+          "intent": "Start the slot browser with MetaMask and the dev1 fixture account.",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.app.assert_no_console_errors": {
+      "description": "Fail when the terminal page logged an error or uncaught exception since the slot browser's launch that no recipe-library console allowlist (diagnostics/console-allowlist.json) marks as known third-party noise. Reads the slot console capture; the same classification feeds run diagnostics. Fails as unavailable unless the slot's own console collector runs on the browser's CDP port and, for each capture file a requested source reads, a control line logged in its target (the app page; MetaMask for the extension source) reaches that file. Allowlist entries are exact signatures (schemaVersion 3).",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "sources": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "page",
+                "extension",
+                "browser"
+              ]
+            },
+            "description": "Default [\"page\",\"browser\"]: the terminal tab's console and its browser log entries."
+          },
+          "levels": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "warning",
+                "error",
+                "exception"
+              ]
+            },
+            "description": "Default [\"error\",\"exception\"]."
+          },
+          "since": {
+            "type": "string",
+            "enum": [
+              "launch",
+              "start-of-log"
+            ],
+            "default": "launch"
+          },
+          "allowlist_root": {
+            "type": "string",
+            "description": "An extra directory holding diagnostics/console-allowlist.json."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.app.assert_no_console_errors",
+          "intent": "Prove the terminal page logged no unexpected error during the journey",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.perps.assert_orders": {
+      "description": "Assert presence, absence, count and fields (limit/trigger price, trigger type, reduce-only, size) of the selected venue open orders, polling up to timeout_ms.",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "description": "Single market symbol, e.g. ETH. Alias: symbol."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "symbols": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "matching",
+              "all"
+            ],
+            "description": "all selects every item; otherwise a market is required."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ]
+          },
+          "order_kind": {
+            "type": "string",
+            "enum": [
+              "limit",
+              "trigger"
+            ],
+            "description": "Only plain limit orders, or only trigger (TP/SL) orders."
+          },
+          "trigger_kind": {
+            "type": "string",
+            "enum": [
+              "take_profit",
+              "stop_loss"
+            ]
+          },
+          "only_trigger_orders": {
+            "type": "boolean"
+          },
+          "order_ids": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "number"
+              ]
+            },
+            "description": "Restrict to these venue order ids."
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "none",
+              "absent",
+              "closed",
+              "open",
+              "present"
+            ]
+          },
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name (default: the running browser account, else dev1) or an EVM address for read-only use."
+          },
+          "account_name": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "default": "testnet",
+            "description": "Hyperliquid network read from the public info API. Mutating actions refuse mainnet."
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "expect_count": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Exact number of matching items."
+          },
+          "expectCount": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Exact number of matching items."
+          },
+          "expect_limit_price": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Required limit price on every matching order."
+          },
+          "expect_trigger_price": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "expect_trigger_order_type": {
+            "type": "string",
+            "enum": [
+              "stop_market",
+              "stop_limit",
+              "take_profit_market",
+              "take_profit_limit"
+            ]
+          },
+          "expect_reduce_only": {
+            "type": "boolean"
+          },
+          "expect_size": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "price_tolerance_pct": {
+            "type": "number",
+            "description": "Relative tolerance for price expectations (tick rounding); default exact."
+          }
+        },
+        "required": [
+          "state"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.assert_orders",
+          "market": "ETH",
+          "state": "open",
+          "expect_limit_price": "2000",
+          "intent": "Prove one resting ETH limit order at the placed price.",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.perps.assert_positions": {
+      "description": "Assert presence, absence or exact count of the selected venue positions, polling up to timeout_ms.",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "description": "Single market symbol, e.g. ETH. Alias: symbol."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "symbols": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "matching",
+              "all"
+            ],
+            "description": "all selects every item; otherwise a market is required."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ]
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "none",
+              "absent",
+              "closed",
+              "open",
+              "present"
+            ]
+          },
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name (default: the running browser account, else dev1) or an EVM address for read-only use."
+          },
+          "account_name": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "default": "testnet",
+            "description": "Hyperliquid network read from the public info API. Mutating actions refuse mainnet."
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "expect_count": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Exact number of matching items."
+          },
+          "expectCount": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Exact number of matching items."
+          }
+        },
+        "required": [
+          "state"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.assert_positions",
+          "market": "ETH",
+          "state": "open",
+          "timeout_ms": 30000,
+          "intent": "Independently prove the venue holds the ETH position.",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.perps.read_orders": {
+      "description": "Read the fixture account Hyperliquid open orders for the selected markets from the venue info API (frontendOpenOrders).",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "description": "Single market symbol, e.g. ETH. Alias: symbol."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "symbols": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "matching",
+              "all"
+            ],
+            "description": "all selects every item; otherwise a market is required."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ]
+          },
+          "order_kind": {
+            "type": "string",
+            "enum": [
+              "limit",
+              "trigger"
+            ],
+            "description": "Only plain limit orders, or only trigger (TP/SL) orders."
+          },
+          "trigger_kind": {
+            "type": "string",
+            "enum": [
+              "take_profit",
+              "stop_loss"
+            ]
+          },
+          "only_trigger_orders": {
+            "type": "boolean"
+          },
+          "order_ids": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "number"
+              ]
+            },
+            "description": "Restrict to these venue order ids."
+          },
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name (default: the running browser account, else dev1) or an EVM address for read-only use."
+          },
+          "account_name": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "default": "testnet",
+            "description": "Hyperliquid network read from the public info API. Mutating actions refuse mainnet."
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.read_orders",
+          "market": "ETH",
+          "intent": "Read the open ETH orders of the fixture account.",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.perps.read_positions": {
+      "description": "Read the fixture account Hyperliquid positions for the selected markets from the venue info API (clearinghouseState).",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "description": "Single market symbol, e.g. ETH. Alias: symbol."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "symbols": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "matching",
+              "all"
+            ],
+            "description": "all selects every item; otherwise a market is required."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ]
+          },
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name (default: the running browser account, else dev1) or an EVM address for read-only use."
+          },
+          "account_name": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "default": "testnet",
+            "description": "Hyperliquid network read from the public info API. Mutating actions refuse mainnet."
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.read_positions",
+          "market": "ETH",
+          "intent": "Read the ETH position held by the fixture account.",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.perps.read_snapshot": {
+      "description": "Snapshot venue positions, open orders, approved agents and balances for the fixture account, optionally scoped to markets, for before/after comparison.",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "description": "Single market symbol, e.g. ETH. Alias: symbol."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "symbols": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "matching",
+              "all"
+            ],
+            "description": "all selects every item; otherwise a market is required."
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ]
+          },
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name (default: the running browser account, else dev1) or an EVM address for read-only use."
+          },
+          "account_name": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "default": "testnet",
+            "description": "Hyperliquid network read from the public info API. Mutating actions refuse mainnet."
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.read_snapshot",
+          "market": "ETH",
+          "intent": "Record the ETH venue state before the journey.",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.perps.revoke_agent": {
+      "description": "Lifecycle step (testnet; mainnet only with mainnet_confirmation=REAL_FUNDS): revoke the Web Terminal Hyperliquid agent(s) (mm-terminal*) of the fixture account outside the UI (approveAgent to the zero address, user-signed in Node) and assert none remains, so the next UI write must request a fresh ApproveAgent.",
+      "execution_capabilities": [
+        "app-mutation",
+        "external-mutation"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name (default: the running browser account, else dev1) or an EVM address for read-only use."
+          },
+          "account_name": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "default": "testnet",
+            "description": "Hyperliquid network read from the public info API. Mutating actions refuse mainnet."
+          },
+          "agent_name": {
+            "type": "string",
+            "default": "mm-terminal"
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "mainnet_confirmation": {
+            "type": "string",
+            "enum": [
+              "REAL_FUNDS"
+            ],
+            "description": "Required with network=mainnet: confirms a real-funds mutation."
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.revoke_agent",
+          "network": "testnet",
+          "intent": "Revoke the terminal agent so the next order needs re-approval.",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.perps.teardown_state": {
+      "description": "Testnet cleanup of one reserved market: cancel its open orders (or only order_ids) and close its position with a reduce-only IOC order signed in Node by the fixture account, then assert none remain. Refuses mode=all; mainnet only with mainnet_confirmation=REAL_FUNDS. Never passes through the browser wallet.",
+      "execution_capabilities": [
+        "app-mutation",
+        "external-mutation"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "description": "Single market symbol, e.g. ETH. Alias: symbol."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "markets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "symbols": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "side": {
+            "type": "string",
+            "enum": [
+              "long",
+              "short"
+            ]
+          },
+          "order_ids": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "number"
+              ]
+            },
+            "description": "Restrict to these venue order ids."
+          },
+          "positions": {
+            "type": "object",
+            "properties": {
+              "state": {
+                "type": "string",
+                "enum": [
+                  "none",
+                  "absent",
+                  "closed",
+                  "open",
+                  "present"
+                ]
+              }
+            },
+            "additionalProperties": false
+          },
+          "orders": {
+            "type": "object",
+            "properties": {
+              "state": {
+                "type": "string",
+                "enum": [
+                  "none",
+                  "absent",
+                  "closed",
+                  "open",
+                  "present"
+                ]
+              }
+            },
+            "additionalProperties": false
+          },
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name (default: the running browser account, else dev1) or an EVM address for read-only use."
+          },
+          "account_name": {
+            "type": "string"
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "default": "testnet",
+            "description": "Hyperliquid network read from the public info API. Mutating actions refuse mainnet."
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "mainnet_confirmation": {
+            "type": "string",
+            "enum": [
+              "REAL_FUNDS"
+            ],
+            "description": "Required with network=mainnet: confirms a real-funds mutation."
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.teardown_state",
+          "market": "ETH",
+          "positions": {
+            "state": "none"
+          },
+          "orders": {
+            "state": "none"
+          },
+          "network": "testnet",
+          "intent": "Restore the reserved ETH market to flat after success or failure.",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.wallet.assert_signatures": {
+      "description": "Assert the wallet request window: allowed EIP-712 primary types, exact signed counts per type, zero L1 (Agent / chainId 1337) payloads by default, domain chain = active chain, method counts and confirmations shown. The window is retained as evidence either way.",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "allowed_primary_types": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "counts": {
+            "type": "object",
+            "description": "Exact signed count per primary type, e.g. {\"ApproveAgent\": 1}."
+          },
+          "request_counts": {
+            "type": "object"
+          },
+          "methods": {
+            "type": "object",
+            "description": "Exact request count per RPC method."
+          },
+          "max_l1_requests": {
+            "type": "number",
+            "default": 0
+          },
+          "max_typed_data_requests": {
+            "type": "number"
+          },
+          "max_rejected": {
+            "type": "number"
+          },
+          "expect_confirmations": {
+            "type": "number",
+            "description": "Exact confirmations MetaMask showed (signer=extension)."
+          },
+          "require_active_chain": {
+            "type": "boolean"
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.wallet.assert_signatures",
+          "allowed_primary_types": [
+            "ApproveAgent",
+            "ApproveBuilderFee"
+          ],
+          "counts": {
+            "ApproveAgent": 1
+          },
+          "max_l1_requests": 0,
+          "intent": "Prove the main wallet only approved the agent once.",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.wallet.list_accounts": {
+      "description": "List the wallet fixture account names and addresses available to the slot browser, marking the one in use. Addresses only.",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.wallet.list_accounts",
+          "intent": "Show which fixture account the slot browser signs as.",
+          "next": "done"
+        }
+      ]
+    },
+    "metamask.wallet.read_signatures": {
+      "description": "Read the wallet request log (what the app asked the main wallet: method, EIP-712 primary type, domain/active chain, outcome; confirmations MetaMask showed) since the last reset, retained as evidence. reset=true starts a new window.",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "reset": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.wallet.read_signatures",
+          "reset": true,
+          "intent": "Start the signature window for this journey.",
+          "next": "done"
+        }
+      ]
+    },
+    "switch": {
+      "description": "Choose a graph branch when one resolved string equals another.",
+      "examples": [
+        {
+          "action": "switch",
+          "value": "{{params.mode}}",
+          "equals": "background_resume",
+          "cases": {
+            "match": "background"
+          },
+          "default": "warm",
+          "intent": "Choose the graph path matching the observed state."
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "value": {
+            "type": "string"
+          },
+          "equals": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "value",
+          "equals"
+        ],
+        "additionalProperties": false
+      },
+      "result_cases": [
+        "match"
+      ]
+    },
+    "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"
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "settle": {
+            "type": "boolean"
+          },
+          "surface": {
+            "type": "string",
+            "enum": [
+              "app",
+              "wallet"
+            ],
+            "default": "app",
+            "description": "app (default): the Web Terminal tab. wallet: the MetaMask side panel / notification showing the pending dapp request (signer=extension only)."
+          },
+          "wallet_timeout_ms": {
+            "type": "number",
+            "description": "surface=wallet: how long to wait for MetaMask to show the request."
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.key_press",
+          "key": "Enter",
+          "intent": "Continue the requested keyboard interaction.",
+          "next": "done"
+        }
+      ]
+    },
+    "ui.navigate": {
+      "description": "Navigate the terminal tab to a product page (order/<MARKET>, portfolio, home) or an explicit app path on the slot dev server and wait for the document.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "page": {
+            "type": "string",
+            "enum": [
+              "order",
+              "market",
+              "portfolio",
+              "home"
+            ]
+          },
+          "market": {
+            "type": "string",
+            "description": "Market symbol for page=order, e.g. ETH."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "path": {
+            "type": "string",
+            "description": "Explicit app path starting with /."
+          },
+          "settle_ms": {
+            "type": "number"
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.navigate",
+          "page": "order",
+          "market": "ETH",
+          "intent": "Open the ETH order page on the slot dev server.",
+          "next": "done"
+        }
+      ]
+    },
+    "ui.press": {
+      "description": "Press/tap/click a UI target on the terminal tab or the MetaMask wallet surface.",
+      "examples": [
+        {
+          "action": "ui.press",
+          "intent": "Activate the requested visible control.",
+          "text": "Perps",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "selector": {
+            "type": "string"
+          },
+          "test_id": {
+            "type": "string"
+          },
+          "testID": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "settle": {
+            "type": "boolean"
+          },
+          "surface": {
+            "type": "string",
+            "enum": [
+              "app",
+              "wallet"
+            ],
+            "default": "app",
+            "description": "app (default): the Web Terminal tab. wallet: the MetaMask side panel / notification showing the pending dapp request (signer=extension only)."
+          },
+          "wallet_timeout_ms": {
+            "type": "number",
+            "description": "surface=wallet: how long to wait for MetaMask to show the request."
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "ui.screenshot": {
+      "description": "Capture the current native browser window on macOS, with bounded Chrome viewport capture as fallback. A native window can include a separate side panel or a tab other than the driven page. For report evidence of the driven document, use ui.capture_surface. Always inspect the resulting PNG and artifact metadata; failed real capture does not produce a reconstructed DOM image.",
+      "examples": [
+        {
+          "action": "ui.screenshot",
+          "path": "screenshots/example.png",
+          "intent": "Preserve the visible application state as review evidence.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "category": {
+            "type": "string"
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "surface": {
+            "type": "string",
+            "enum": [
+              "app",
+              "wallet"
+            ],
+            "default": "app",
+            "description": "app (default): the Web Terminal tab. wallet: the MetaMask side panel / notification showing the pending dapp request (signer=extension only)."
+          },
+          "wallet_timeout_ms": {
+            "type": "number",
+            "description": "surface=wallet: how long to wait for MetaMask to show the request."
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "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": [
+        {
+          "action": "ui.scroll",
+          "delta_y": 300,
+          "intent": "Expose the requested content for visible review.",
+          "next": "done"
+        },
+        {
+          "action": "ui.scroll",
+          "selector": "[data-testid=\"example\"]",
+          "scroll_into_view": true,
+          "intent": "Expose the requested content for visible review.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "selector": {
+            "type": "string"
+          },
+          "test_id": {
+            "type": "string"
+          },
+          "testID": {
+            "type": "string"
+          },
+          "delta_x": {
+            "type": "number"
+          },
+          "delta_y": {
+            "type": "number"
+          },
+          "deltaX": {
+            "type": "number"
+          },
+          "deltaY": {
+            "type": "number"
+          },
+          "offset": {
+            "type": "number"
+          },
+          "scroll_into_view": {
+            "type": "boolean"
+          },
+          "into_view": {
+            "type": "boolean"
+          },
+          "animated": {
+            "type": "boolean"
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "settle": {
+            "type": "boolean"
+          },
+          "surface": {
+            "type": "string",
+            "enum": [
+              "app",
+              "wallet"
+            ],
+            "default": "app",
+            "description": "app (default): the Web Terminal tab. wallet: the MetaMask side panel / notification showing the pending dapp request (signer=extension only)."
+          },
+          "wallet_timeout_ms": {
+            "type": "number",
+            "description": "surface=wallet: how long to wait for MetaMask to show the request."
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "ui.set_input": {
+      "description": "Set text on the terminal tab or the MetaMask wallet surface.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "selector": {
+            "type": "string"
+          },
+          "test_id": {
+            "type": "string"
+          },
+          "testID": {
+            "type": "string"
+          },
+          "value": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Text or a typed numeric recipe parameter; numbers are entered as their decimal text. Use an empty string to clear the field."
+          },
+          "text": {
+            "type": "string"
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "settle": {
+            "type": "boolean"
+          },
+          "surface": {
+            "type": "string",
+            "enum": [
+              "app",
+              "wallet"
+            ],
+            "default": "app",
+            "description": "app (default): the Web Terminal tab. wallet: the MetaMask side panel / notification showing the pending dapp request (signer=extension only)."
+          },
+          "wallet_timeout_ms": {
+            "type": "number",
+            "description": "surface=wallet: how long to wait for MetaMask to show the request."
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.set_input",
+          "selector": "[data-testid=multichain-account-list-search] input",
+          "value": "Account",
+          "intent": "Provide the requested value in the visible form.",
+          "next": "done"
+        }
+      ]
+    },
+    "ui.wait_for": {
+      "description": "Wait for a UI condition on the terminal tab or the MetaMask wallet surface.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "selector": {
+            "type": "string"
+          },
+          "test_id": {
+            "type": "string"
+          },
+          "testID": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "text_match": {
+            "type": "string"
+          },
+          "textMatch": {
+            "type": "string"
+          },
+          "expected": {
+            "type": "string"
+          },
+          "visible": {
+            "type": "boolean"
+          },
+          "timeout_ms": {
+            "type": "number"
+          },
+          "surface": {
+            "type": "string",
+            "enum": [
+              "app",
+              "wallet"
+            ],
+            "default": "app",
+            "description": "app (default): the Web Terminal tab. wallet: the MetaMask side panel / notification showing the pending dapp request (signer=extension only)."
+          },
+          "wallet_timeout_ms": {
+            "type": "number",
+            "description": "surface=wallet: how long to wait for MetaMask to show the request."
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.wait_for",
+          "text": "Perps",
+          "intent": "Confirm the requested application state is visible.",
+          "next": "done"
+        },
+        {
+          "action": "ui.wait_for",
+          "selector": "[data-testid=example]",
+          "visible": false,
+          "timeout_ms": 2000,
+          "intent": "Confirm the requested application state is visible.",
+          "next": "done"
+        }
+      ]
+    },
+    "wait": {
+      "description": "Base wait action.",
+      "examples": [
+        {
+          "action": "wait",
+          "duration_ms": 1,
+          "intent": "Allow the requested asynchronous state to settle.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "duration_ms": {
+            "type": "integer"
+          },
+          "ms": {
+            "type": "integer"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  }
+}