@deeeed/metamask-harness 0.47.4 → 0.49.0

package/library/actions/shared/perps/visible-state.mjs

@@ -1,3 +1,5 @@
+// Normalize platform Perps observations and enforce the requested screen, content and count claims.
+
 const SURFACES = new Set([
   'auto',
   'home',
@@ -182,7 +184,7 @@ function visibleFeatures(items) {
   const short = has(/(?:short-cta-button|direction-short|market-details-short-button)$/u);
   return {
     activity: has(/^(?:transaction-card-|perps-(?:recent-activity|activity))/u),
-    balance: has(/^(?:perps-balance-dropdown|perps-market-(?:balance-value|available-balance-text))/u),
+    balance: has(/^(?:perps-balance-dropdown|perps-balance-actions-available-value|perps-market-(?:balance-value|available-balance-text))/u),
     chart: has(/^(?:chart_surface|tv_chart_container)$/u) ||
       has(/perps-(?:candlestick-chart|market-detail-chart|market-details-fullscreen-chart|pro-market-chart)/u),
     'long-short': long && short,
@@ -190,7 +192,7 @@ function visibleFeatures(items) {
     'order-entry': has(/perps-(?:order-entry|pro-order-form)/u),
     price: has(/perps-(?:market-detail-price|market-header-price|pro-market-price)$/u),
     'price-change': has(/perps-(?:market-detail-change|market-header-price-change|pro-market-price-change)$/u),
-    stats: has(/perps-(?:stats-section|market-details-market-summary|market-detail-oracle-price|pro-market-stats)/u),
+    stats: has(/perps-(?:stats-section|market-detail-oracle-price|pro-market-stats)/u),
   };
 }
 
@@ -199,6 +201,16 @@ export function normalizeVisiblePerpsState(raw, options, platform) {
     .map(normalizedItem)
     .filter(Boolean);
   const unique = Array.from(new Map(items.map((item) => [item.testId, item])).values());
+  const pairs = items.filter((item) => item.visible &&
+    /^(?:perps-market-detail-pair|perps-(?:pro-)?market-header-subtitle)$/u.test(item.testId));
+  const favoriteControls = items.filter((item) => item.visible &&
+    /^(?:perps-market-detail-favorite-button|perps-(?:pro-)?market-header-favorite-button)$/u.test(item.testId));
+  const requestedMarket = options.market?.replace(/^XYZ-/u, 'XYZ:');
+  const favoriteLabel = favoriteControls.length === 1 ? favoriteControls[0].label ?? '' : '';
+  const favorite = requestedMarket && pairs.length === 1 &&
+    pairs[0].label?.toUpperCase().startsWith(`${requestedMarket}-`) &&
+    /^(?:add to|remove from) (?:favorites|watchlist)$/iu.test(favoriteLabel)
+    ? /^remove from /iu.test(favoriteLabel) : null;
   const testIds = new Set(unique.map((item) => item.testId));
   const route = text(raw.route) ?? '';
   const surface = classifySurface(route, testIds);
@@ -216,10 +228,11 @@ export function normalizeVisiblePerpsState(raw, options, platform) {
     source: 'visible-ui',
     platform,
     surface,
+    favorite,
     ...(route ? { route } : {}),
     ...(text(raw.title) ? { title: text(raw.title) } : {}),
     balance: compactEntries(
-      selected(unique, (item) => /^(?:perps-balance-dropdown|perps-market-balance-value)$/u.test(item.testId), 1),
+      selected(unique, (item) => /^(?:perps-balance-dropdown|perps-balance-actions-available-value|perps-market-balance-value)$/u.test(item.testId), 1),
       1,
     )[0] ?? null,
     markets: marketItems,

package/library/actions/shared/swap-bridge/transaction.mjs

@@ -1,3 +1,6 @@
+// Validate cross-platform swap asset selections and positive amounts, including decimal normalization.
+// Platform actions perform the actual form changes and submission.
+
 function requiredText(value, name) {
   const resolved = String(value ?? '').trim();
   if (!resolved) throw new Error(`metamask.swap_bridge ${name} is required.`);

package/library/actions/shared/swap-bridge/visible-state.mjs

@@ -1,3 +1,5 @@
+// Normalize observed swap controls and enforce token, quote, settings and slippage requirements.
+
 function text(value) {
   if (typeof value !== 'string') return undefined;
   const normalized = value.replace(/\s+/gu, ' ').trim();

package/library/actions/shared/ui/locators.mjs

@@ -1,3 +1,5 @@
+// Rank locator suggestions from observed interactive elements and enforce observation visibility.
+
 const LOCATOR_LIMIT = 20;
 const INTERACTIVE_ROLE_PARTS = [
   'button',

package/library/actions/shared/wallet/import-source.mjs

@@ -1,3 +1,6 @@
+// Resolve wallet-import credentials from explicit environment or fixture sources.
+// Validate method/source combinations before platform onboarding runs.
+
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 

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

@@ -189,7 +189,7 @@
       }
     },
     "assert_output": {
-      "description": "Assert stdout or stderr captured from a command node 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",
@@ -1161,6 +1161,21 @@
       "schema": {
         "type": "object",
         "properties": {
+          "expected_positions": {
+            "type": "array",
+            "maxItems": 1,
+            "items": {
+              "type": "object",
+              "required": ["coin", "size", "entryPrice"],
+              "properties": {
+                "coin": { "type": "string" },
+                "size": { "type": ["string", "number"] },
+                "entryPrice": { "type": ["string", "number"] }
+              },
+              "additionalProperties": true
+            },
+            "description": "Optional seed receipt guard. Require the selected live market, signed size and entry price to match before dispatch; close at most that quantity in its reducing direction. Empty requires no selected position. Identical netted replacements cannot be distinguished."
+          },
           "market": {
             "type": "string",
             "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."
@@ -1565,10 +1580,19 @@
       ]
     },
     "metamask.perps.close_orders": {
-      "description": "core 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.",
+      "description": "Core Perps cancellation selects current orders by market/side or mode=all, then dispatches and verifies those exact order IDs. Missing or duplicate selected IDs fail before dispatch. Requires authorized signing and task-owned selection; defaults to testnet.",
       "schema": {
         "type": "object",
         "properties": {
+          "expected_order_ids": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Optional exact receipt set. Refuse a changed selected order set before dispatch and cancel only these IDs. Empty requires no selected open orders."
+          },
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name used for signing; defaults to dev1."
+          },
           "market": {
             "type": "string",
             "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."
@@ -1687,6 +1711,10 @@
       "schema": {
         "type": "object",
         "properties": {
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name, defaulting to dev1. Without a fixture, an EVM address permits read-only assertions."
+          },
           "market": {
             "type": "string",
             "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."
@@ -1890,6 +1918,10 @@
       "schema": {
         "type": "object",
         "properties": {
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name used for convergence and assertions; defaults to dev1."
+          },
           "market": {
             "type": "string",
             "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."

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

@@ -189,7 +189,7 @@
       }
     },
     "assert_output": {
-      "description": "Assert stdout or stderr captured from a command node 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",
@@ -593,7 +593,7 @@
               "string",
               "number"
             ],
-            "description": "Text or a typed numeric recipe parameter; numbers are entered as their decimal text."
+            "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"
@@ -750,7 +750,7 @@
       ]
     },
     "ui.pan": {
-      "description": "Pan through a continuous pointer path from a test-id target or screen coordinates through the shared browser UI transport.",
+      "description": "Pan from a test-id target or screen coordinates through the shared browser UI transport. path and delta are offsets from the resolved start, not absolute endpoints.",
       "schema": {
         "type": "object",
         "properties": {
@@ -848,7 +848,7 @@
       ]
     },
     "ui.drag": {
-      "description": "Drag a test-id target or screen coordinate through the shared browser UI transport.",
+      "description": "Drag a test-id target or screen coordinate through the shared browser UI transport. path and delta are offsets from the resolved start, not absolute endpoints.",
       "schema": {
         "type": "object",
         "properties": {
@@ -1062,7 +1062,7 @@
       ]
     },
     "ui.screenshot": {
-      "description": "Capture registered visual evidence through capture-helper, bounded Chrome-native capture, or an explicitly labeled computed-style DOM raster fallback. Always read the resulting PNG; artifact metadata records the provider.",
+      "description": "Capture the current native browser window on macOS, with bounded Chrome viewport capture as fallback. Always inspect the resulting PNG; artifact metadata records the provider. Failed real capture does not produce a reconstructed DOM image.",
       "examples": [
         {
           "action": "ui.screenshot",
@@ -1091,7 +1091,7 @@
       }
     },
     "ui.capture_surface": {
-      "description": "Capture the complete current browser page as one registered PNG while leaving ui.screenshot viewport-only.",
+      "description": "Capture the complete current browser document through Chrome as one registered PNG. Includes document content below the viewport, not browser chrome or the hidden contents of nested scroll areas. Keep viewport assertions separate.",
       "schema": {
         "type": "object",
         "properties": {
@@ -1968,7 +1968,7 @@
       ]
     },
     "metamask.assets.open_details": {
-      "description": "Open one visible Extension asset by symbol.",
+      "description": "Open the uniquely visible Extension asset matching a symbol; refuse ambiguous rows without clicking. Symbol alone does not prove funding or network identity.",
       "schema": {
         "type": "object",
         "properties": {
@@ -1990,7 +1990,7 @@
         {
           "action": "metamask.assets.open_details",
           "symbol": "ETH",
-          "intent": "Open the funded ETH details",
+          "intent": "Open ETH details only when one matching row is visible",
           "next": "done"
         }
       ],
@@ -1999,7 +1999,7 @@
       ]
     },
     "metamask.assets.read_details": {
-      "description": "Read and assert the current Extension asset details page through visible UI.",
+      "description": "Observe asset details until requested chart and market data are ready within the polling budget. A required chart needs visible price labels and an unmuted price, not just a canvas. Never refreshes the page.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2037,7 +2037,7 @@
       ]
     },
     "metamask.assets.verify_sorting": {
-      "description": "Select both visible Extension asset sort modes, assert their row order, and restore declining balance.",
+      "description": "Verify both Extension asset sort modes and restore the observed initial preference after success or failure. Already-selected modes skip redundant selection; row-order observation is bounded.",
       "schema": {
         "type": "object",
         "properties": {},
@@ -2055,10 +2055,14 @@
       ]
     },
     "metamask.assets.set_token_visibility": {
-      "description": "Enable or disable one searched Extension token through Manage tokens and verify the home list state.",
+      "description": "Enable or disable one uniquely matched Extension token through Manage tokens and verify the home list state. Ambiguous search results fail before toggling; require_unchanged verifies existing visibility without repairing it.",
       "schema": {
         "type": "object",
         "properties": {
+          "asset_id": {
+            "type": "string",
+            "description": "Optional ERC-20 CAIP asset ID binding the exact management toggle to a unique Home details route. Enabling waits for import completion and verifies Home identity afterward. Hiding requires visible=false, require_change=true and require_unchanged=false; verifies Home identity before hiding and Home absence after Back. Already-hidden exact checks are unsupported; empty uses query-only matching."
+          },
           "query": {
             "type": "string"
           },
@@ -2531,7 +2535,7 @@
       ]
     },
     "metamask.swap_bridge.read_visible_state": {
-      "description": "Read and assert the visible Swap surface from an untouched Extension runtime without product background hooks.",
+      "description": "Read the visible Swap surface without mutation. require_quote additionally needs exposed bridge quote state to verify current input/quote identity; surface-only reads do not require those hooks.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2632,7 +2636,7 @@
       ]
     },
     "metamask.swap_bridge.set_amount": {
-      "description": "Enter a positive Swap amount through visible UI and wait for a quote or explicit no-route state.",
+      "description": "Enter a positive Swap amount through visible UI. Quote waiting requires exposed bridge quote state to bind the current token-unit amount and assets to the quote; no implicit refresh or submission.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2700,7 +2704,7 @@
       ]
     },
     "metamask.swap_bridge.set_max_amount": {
-      "description": "Use the visible Swap Max control and wait for the derived live quote.",
+      "description": "Use the visible Swap Max control; quote waiting requires exposed bridge quote state and a reviewable quote matching current inputs. Never refresh or submit implicitly.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2729,7 +2733,7 @@
       ]
     },
     "metamask.perps.read_visible_state": {
-      "description": "Read and assert bounded visible Perps UI state from an untouched Extension runtime without product background hooks.",
+      "description": "Read and assert bounded visible Perps UI state without product background hooks. favorite is boolean only when the requested market pair and one favorite control are both visible; otherwise null, never an assumed false.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2996,6 +3000,10 @@
       "schema": {
         "type": "object",
         "properties": {
+          "placement_node": {
+            "type": "string",
+            "description": "Exact placement receipt node relative to this recipe call, such as submit or setup/place. Supports cleanup after a failed submission; never selects the newest receipt."
+          },
           "market": {
             "type": "string"
           },
@@ -3163,7 +3171,8 @@
           },
           "require_unchanged": {
             "type": "boolean",
-            "default": false
+            "default": false,
+            "description": "Assert the requested favorite state without clicking; a mismatch fails before any favorite change."
           }
         },
         "required": [
@@ -3809,6 +3818,11 @@
       "schema": {
         "type": "object",
         "properties": {
+          "network": {
+            "type": "string",
+            "enum": ["testnet", "mainnet"],
+            "description": "Require the currently selected Perps network before reading; never switches it."
+          },
           "market": {
             "type": "string",
             "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."
@@ -3906,6 +3920,11 @@
       "schema": {
         "type": "object",
         "properties": {
+          "network": {
+            "type": "string",
+            "enum": ["testnet", "mainnet"],
+            "description": "Require the currently selected Perps network before reading; never switches it."
+          },
           "market": {
             "type": "string",
             "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."
@@ -4003,6 +4022,10 @@
       "schema": {
         "type": "object",
         "properties": {
+          "placement_node": {
+            "type": "string",
+            "description": "Exact visible-form placement receipt node relative to this recipe call. Selects receipt-owned UI cancellation even when a controller bridge exists."
+          },
           "market": {
             "type": "string",
             "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."
@@ -4165,6 +4188,11 @@
       "schema": {
         "type": "object",
         "properties": {
+          "from_current_form": {
+            "type": "boolean",
+            "default": false,
+            "description": "Submit the already configured visible form once without navigation, field edits, or controller placement. Requires an empty position/order baseline, verified provider/network, matching market/direction/amount/leverage, and trusted funding. Prepared limit sizing currently requires 1x leverage. Preserves the current protection settings and observes the product's resulting route."
+          },
           "market": {
             "type": "string",
             "description": "Single market symbol, e.g. BTC or ETH. Alias: symbol."
@@ -4818,10 +4846,15 @@
       ]
     },
     "metamask.perps.teardown_state": {
-      "description": "Observe and assert the requested final Extension Perps order and position state, then optionally navigate. This action never closes or cancels financial state.",
+      "description": "Verify an optional expected network, assert the requested final Extension Perps order and position state, then optionally navigate. This action never switches networks, closes positions or cancels orders.",
       "schema": {
         "type": "object",
         "properties": {
+          "network": {
+            "type": "string",
+            "enum": ["testnet", "mainnet"],
+            "description": "Expected current Perps network; mismatch fails before state assertions or navigation, without switching it."
+          },
           "market": {
             "type": "string"
           },

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

@@ -178,7 +178,7 @@
       }
     },
     "assert_output": {
-      "description": "Assert stdout or stderr captured from a command node 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",
@@ -699,7 +699,7 @@
       ]
     },
     "ui.pan": {
-      "description": "Pan from a test-id target or screen coordinates through the shared native UI provider.",
+      "description": "Pan from a test-id target or screen coordinates through the shared native UI provider. path and delta are offsets from the resolved start, not absolute endpoints.",
       "schema": {
         "type": "object",
         "properties": {
@@ -754,7 +754,7 @@
       ]
     },
     "ui.drag": {
-      "description": "Drag a test-id target or screen coordinate through the shared native UI provider.",
+      "description": "Drag a test-id target or screen coordinate through the shared native UI provider. path and delta are offsets from the resolved start, not absolute endpoints.",
       "schema": {
         "type": "object",
         "properties": {
@@ -1814,7 +1814,7 @@
       "execution_capabilities": ["host-read-export"]
     },
     "metamask.assets.verify_sorting": {
-      "description": "Select alphabetical and declining-fiat token sorting and assert the visible native row order.",
+      "description": "Verify native name order under MetaMask's SES collation and declining-fiat order, then restore the original sort preference.",
       "schema": {
         "type": "object",
         "properties": {
@@ -1830,10 +1830,11 @@
       "execution_capabilities": ["app-mutation"]
     },
     "metamask.assets.set_token_visibility": {
-      "description": "Import or remove one Mobile token through visible native controls and verify the resulting state.",
+      "description": "Import or remove one uniquely matched Mobile token through native controls. Require an observed matching label for import state and reject duplicate matching rows before selection or removal.",
       "schema": {
         "type": "object",
         "properties": {
+          "asset_id": { "type": "string", "enum": [""], "description": "Exact asset-ID corroboration is not implemented on Mobile; only the omitted/empty query-only mode is supported." },
           "query": { "type": "string" },
           "visible": { "type": "boolean" },
           "require_unchanged": { "type": "boolean", "default": false },
@@ -2087,7 +2088,7 @@
       "execution_capabilities": ["app-mutation"]
     },
     "metamask.perps.read_visible_state": {
-      "description": "Read and assert bounded visible Perps UI state from an opaque Mobile runtime through native accessibility.",
+      "description": "Read and assert bounded visible Perps UI state through native accessibility. favorite is boolean only when the requested market pair and one favorite control are both observed as visible; otherwise null, never an assumed false.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2208,7 +2209,7 @@
         "properties": {
           "market": { "type": "string" },
           "favorite": { "type": "boolean" },
-          "require_unchanged": { "type": "boolean", "default": false },
+          "require_unchanged": { "type": "boolean", "default": false, "description": "Assert the requested favorite state without clicking; a mismatch fails before any favorite change." },
           "timeout_ms": { "type": "integer", "minimum": 1000, "default": 30000 }
         },
         "required": ["market", "favorite"],
@@ -3282,7 +3283,7 @@
       "execution_capabilities": ["app-mutation"]
     },
     "metamask.perps.clear_performance_caches": {
-      "description": "mobile Clear only persisted Perps market/user performance caches in the development app before a cold-no-cache validation run.",
+      "description": "Mobile source-dev cold-start preparation: clear Perps disk and controller market/user caches and disconnect its marketData, positions, orders and account channels. Preserve wallet/exchange state; follow with an explicit restart before proof, never use as recovery inside a proof action.",
       "schema": {
         "type": "object",
         "properties": {},
@@ -3298,7 +3299,7 @@
       "execution_capabilities": ["app-mutation"]
     },
     "metamask.perps.ensure_mode": {
-      "description": "Ensure the viewport-visible Perps market-detail root is Lite or Pro. The action presses the active mode control at most once and fails closed if that press opens another chooser or does not converge directly.",
+      "description": "Ensure the viewport-visible Perps market-detail root is Lite or Pro. Press the active mode control at most once and select the requested first-entry choice if shown; fail if the requested detail root does not appear before the deadline.",
       "schema": {
         "type": "object",
         "properties": {
@@ -3340,7 +3341,7 @@
           },
           "account": {
             "type": "string",
-            "description": "Optional exact account name. Omit it to keep the currently selected account."
+            "description": "Optional exact account name or EVM address. Prefer an address when the current product does not expose account names. Omit it to keep the currently selected account."
           },
           "provider": {
             "type": "string",

package/library/recipes/core/perps/smoke.recipe.json

@@ -2,6 +2,23 @@
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask core Perps smoke",
   "description": "Non-mutating Perps domain smoke for the headless core adapter: instantiates the Perps controller and reads live positions, orders, and account state.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "type": "string",
+        "default": "",
+        "description": "Fixture account name, defaulting to dev1. Without a fixture, supply an EVM address for read-only inspection."
+      },
+      "network": {
+        "type": "string",
+        "enum": ["testnet", "mainnet"],
+        "default": "testnet",
+        "description": "Network for every isolated controller read."
+      }
+    }
+  },
   "workflow": {
     "entry": "status",
     "nodes": {
@@ -12,18 +29,24 @@
       },
       "read-positions": {
         "action": "metamask.perps.read_positions",
+        "account": "{{params.account}}",
+        "network": "{{params.network}}",
         "mode": "all",
         "next": "read-orders",
         "intent": "Read live Perps positions from the headless controller"
       },
       "read-orders": {
         "action": "metamask.perps.read_orders",
+        "account": "{{params.account}}",
+        "network": "{{params.network}}",
         "mode": "all",
         "next": "read-account",
         "intent": "Read live Perps open orders from the headless controller"
       },
       "read-account": {
         "action": "metamask.perps.read_account",
+        "account": "{{params.account}}",
+        "network": "{{params.network}}",
         "next": "done",
         "intent": "Read live Perps account state from the headless controller"
       },

package/library/recipes/core/perps/snapshot.recipe.json

@@ -2,6 +2,29 @@
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask core Perps snapshots",
   "description": "Reads global market and account snapshots through the public PerpsController API used by wallet clients. Configure CORE_PERPS_TERMINAL_GLOBAL_SNAPSHOT_URL to exercise a Terminal schema-v2 endpoint.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "type": "string",
+        "default": "",
+        "description": "Fixture account name, defaulting to dev1. Without a fixture, supply an EVM address for read-only inspection."
+      },
+      "network": {
+        "type": "string",
+        "enum": ["testnet", "mainnet"],
+        "default": "testnet",
+        "description": "Perps network for this isolated snapshot read."
+      },
+      "scope": {
+        "type": "string",
+        "enum": ["markets", "account", "all"],
+        "default": "all",
+        "description": "Read market data, account state, or both through the public controller API."
+      }
+    }
+  },
   "workflow": {
     "entry": "status",
     "nodes": {
@@ -12,7 +35,9 @@
       },
       "read_snapshot": {
         "action": "metamask.perps.read_snapshot",
-        "scope": "all",
+        "scope": "{{params.scope}}",
+        "account": "{{params.account}}",
+        "network": "{{params.network}}",
         "next": "done",
         "intent": "Read coherent market and account snapshots through public controller methods"
       },

package/library/recipes/extension/assets/release-custom-network-token-persistence.recipe.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "Assets release custom-network token persistence",
-  "description": "Adds PulseChain and PLSX, proves both survive lock/unlock, then removes the custom network.",
+  "description": "Adds a previously absent custom network and token, proves persistence through lock/unlock, then removes the network this run confirmed adding. PulseChain and PLSX are the defaults.",
   "paramsSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -14,11 +14,14 @@
       "token_address": { "type": "string", "default": "0x95B303987A60C71504D99Aa1b13B4DA07b0790ab" },
       "token_symbol": { "type": "string", "default": "PLSX" },
       "token_decimals": { "type": "integer", "minimum": 0, "default": 18 },
+      "before_capture_path": { "type": "string", "default": "screenshots/custom-network-token-before-lock.png" },
+      "after_capture_path": { "type": "string", "default": "screenshots/custom-network-token-after-unlock.png" },
       "timeout_ms": { "type": "integer", "minimum": 1000, "default": 60000 }
     }
   },
   "workflow": {
     "entry": "open-wallet",
+    "teardown": "require-owned-network",
     "nodes": {
       "open-wallet": {
         "action": "ui.navigate",
@@ -51,9 +54,9 @@
       },
       "capture-before": {
         "action": "ui.screenshot",
-        "path": "screenshots/custom-network-token-before-lock.png",
+        "path": "{{params.before_capture_path}}",
         "label": "Custom network token before lock",
-        "intent": "Preserve pre-lock PulseChain and PLSX evidence",
+        "intent": "Preserve pre-lock {{params.network}} and {{params.token_symbol}} evidence",
         "next": "lock-wallet"
       },
       "lock-wallet": {
@@ -88,9 +91,22 @@
       },
       "capture-after": {
         "action": "ui.screenshot",
-        "path": "screenshots/custom-network-token-after-unlock.png",
+        "path": "{{params.after_capture_path}}",
         "label": "Custom network token after unlock",
-        "intent": "Preserve post-unlock PulseChain and PLSX evidence",
+        "intent": "Preserve post-unlock {{params.network}} and {{params.token_symbol}} evidence",
+        "next": "done"
+      },
+      "require-owned-network": {
+        "action": "assert_output",
+        "source": "add-network",
+        "stream": "added",
+        "match": "^true$",
+        "intent": "Refuse deletion without completed evidence that this run added the network",
+        "next": "unlock-cleanup"
+      },
+      "unlock-cleanup": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "intent": "Reach the confirmed task-owned network settings even if the lock-cycle proof failed",
         "next": "remove-network"
       },
       "remove-network": {
@@ -98,10 +114,11 @@
         "network": "{{params.network}}",
         "chain_id": "{{params.chain_id}}",
         "timeout_ms": "{{params.timeout_ms}}",
-        "intent": "Remove the custom network and its token during cleanup",
-        "next": "done"
+        "intent": "Remove only the custom network this run confirmed adding",
+        "next": "cleanup-done"
       },
-      "done": { "action": "end", "status": "pass" }
+      "done": { "action": "end", "status": "pass" },
+      "cleanup-done": { "action": "end", "status": "pass" }
     }
   }
 }