@deeeed/metamask-harness 0.79.0 → 0.81.0

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

@@ -649,7 +649,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to read positions for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "network": {
             "type": "string",
@@ -759,7 +759,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to read orders for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "network": {
             "type": "string",
@@ -793,7 +793,7 @@
         "properties": {
           "account": {
             "type": "string",
-            "description": "EVM address to read account state for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "timeout_ms": {
             "type": "number"
@@ -818,6 +818,76 @@
       ],
       "execution_capabilities": []
     },
+    "metamask.perps.quote_fees": {
+      "description": "core Quote an order's fees through the perps controller's calculateFees (HyperLiquid, testnet by default, read-only): protocol and MetaMask fee rates and amounts (plus the winning fee source on a core that reports it), with the rewards discount the headless RewardsController answers: the rewards API's answer for the selected wallet fixture account, the calls Mobile makes (UAT by default, like Mobile dev builds; CORE_PERPS_REWARDS_API_URL selects another).",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "description": "Market to quote, e.g. BTC."
+          },
+          "symbol": {
+            "type": "string",
+            "description": "Alias for market."
+          },
+          "order_type": {
+            "type": "string",
+            "enum": [
+              "market",
+              "limit"
+            ],
+            "description": "Fee schedule to quote; defaults to market."
+          },
+          "is_maker": {
+            "type": "boolean",
+            "description": "Quote maker fees (limit orders that rest)."
+          },
+          "amount": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Order notional in USD; adds fee amounts and the blended rate for that size."
+          },
+          "rewards_discount_bips": {
+            "type": "integer",
+            "description": "Rewards discount the headless RewardsController answers with, an integer in basis points from 0 through 10000 (6500 = 65%). Replaces the rewards API's answer, to prove a discount the fixture accounts do not hold."
+          },
+          "account": {
+            "type": "string",
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
+          },
+          "account_name": {
+            "type": "string",
+            "description": "Alias for a wallet fixture account name."
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "testnet",
+              "mainnet"
+            ],
+            "description": "Venue to quote. Defaults to testnet."
+          },
+          "timeout_ms": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "metamask.perps.quote_fees",
+          "market": "BTC",
+          "amount": "100",
+          "rewards_discount_bips": 6500,
+          "intent": "Quote a $100 BTC market order with a 65% rewards discount",
+          "next": "done"
+        }
+      ],
+      "execution_capabilities": []
+    },
     "metamask.perps.read_snapshot": {
       "description": "Read global market and account snapshots through the public PerpsController API used by wallet clients.",
       "schema": {
@@ -835,7 +905,7 @@
           },
           "account": {
             "type": "string",
-            "description": "Wallet fixture account name or EVM address; defaults to dev1."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "account_name": {
             "type": "string",
@@ -1023,9 +1093,13 @@
             "type": "number",
             "default": 3
           },
+          "close_immediately": {
+            "type": "boolean",
+            "description": "Close the opened position again inside this action and prove the market flat (market orders only; the market must start flat). Required on mainnet, with leverage 1 and notional at most $15 from a fixture account."
+          },
           "account": {
             "type": "string",
-            "description": "EVM address to trade for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "timeout_ms": {
             "type": "number"
@@ -1344,7 +1418,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to close for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "timeout_ms": {
             "type": "number"
@@ -1471,7 +1545,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to read for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "network": {
             "type": "string",
@@ -1627,7 +1701,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to trade for; defaults to the canonical wallet fixture account."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "timeout_ms": {
             "type": "number"
@@ -1681,7 +1755,7 @@
           },
           "account": {
             "type": "string",
-            "description": "Wallet fixture account name used for signing; defaults to dev1."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "market": {
             "type": "string",
@@ -1803,7 +1877,7 @@
         "properties": {
           "account": {
             "type": "string",
-            "description": "Wallet fixture account name, defaulting to dev1. Without a fixture, an EVM address permits read-only assertions."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or 0x address; defaults to dev1. An address outside the fixture is read as given."
           },
           "market": {
             "type": "string",
@@ -2010,7 +2084,7 @@
         "properties": {
           "account": {
             "type": "string",
-            "description": "Wallet fixture account name used for convergence and assertions; defaults to dev1."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "market": {
             "type": "string",
@@ -2887,7 +2961,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to act for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "timeout_ms": {
             "type": "number"
@@ -3010,7 +3084,7 @@
           },
           "account": {
             "type": "string",
-            "description": "EVM address to act for; defaults to MM_TEST_ACCOUNT_ADDRESS."
+            "description": "Wallet fixture account name (dev1, dev2, ...) or the 0x address of one; defaults to dev1."
           },
           "timeout_ms": {
             "type": "number"

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

@@ -4371,6 +4371,10 @@
             "type": "number",
             "default": 1
           },
+          "close_immediately": {
+            "type": "boolean",
+            "description": "Close the opened position again inside this action and prove the market flat (market orders only; the market must start flat). Required on mainnet, with leverage 1 and notional at most $15 from a fixture account."
+          },
           "provider": {
             "type": "string",
             "description": "Exact Perps provider required before background dispatch."

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

@@ -2775,6 +2775,18 @@
           "leverage": {
             "type": "number",
             "default": 3
+          },
+          "network": {
+            "type": "string",
+            "enum": [
+              "mainnet",
+              "testnet"
+            ],
+            "description": "Perps network the order must run on; checked against the live app. A mainnet order must declare mainnet."
+          },
+          "close_immediately": {
+            "type": "boolean",
+            "description": "Close the opened position again inside this action and prove the market flat (market orders only; the market must start flat). Required on mainnet, with leverage 1 and notional at most $15 from a fixture account."
           }
         },
         "additionalProperties": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.79.0",
+  "version": "0.81.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -21,18 +21,18 @@
     "check:syntax": "find . -name '*.mjs' -print0 | xargs -0 -n1 node --check"
   },
   "dependencies": {
-    "@farmslot/adapter-sdk": "0.1.0",
-    "@farmslot/adapter-web": "0.1.0",
-    "@farmslot/agent-runtime": "0.16.0",
-    "@farmslot/expo-recipe": "0.14.0",
+    "@farmslot/adapter-rn": "0.17.0",
+    "@farmslot/adapter-sdk": "0.4.0",
+    "@farmslot/adapter-web": "0.3.1",
+    "@farmslot/agent-runtime": "0.17.0",
     "@farmslot/handoff": "^0.3.1",
     "@farmslot/protocol": "0.34.0",
-    "@farmslot/recipe-cli": "0.2.0",
-    "@farmslot/recipe-runner": "0.23.0",
+    "@farmslot/recipe-cli": "0.5.0",
+    "@farmslot/recipe-runner": "0.24.0",
     "agent-device": "0.19.3",
     "commander": "^12.0.0",
-    "es-module-lexer": "2.3.1",
     "esbuild": "0.28.1",
+    "tsx": "^4.23.0",
     "viem": "^2.54.3",
     "ws": "8.21.0"
   },
@@ -48,7 +48,6 @@
     "eslint": "^9",
     "globals": "^17.7.0",
     "proper-lockfile": "^4.1.2",
-    "tsx": "^4.23.0",
     "typescript": "^5.6.0",
     "typescript-eslint": "^8",
     "vitest": "^4.1.10"

package/site/assets/help-recipes.json

@@ -173,6 +173,7 @@
         "Graph: no unconditional pass, generic intent, hidden start state, or opaque node that collapses preparation, action, assertion, evidence, and teardown.",
         "Assertion modes such as require_unchanged must fail before any corrective action. Verify the negative path leaves the inspected state untouched; an assertion must not repair the behavior it is supposed to test.",
         "Reuse structured reads with assert_output instead of adding a new domain action for every comparison: source names the earlier node, and assert can select $.matchingCount with operator eq and the expected parameter. A status-report action can succeed while reporting missing prerequisites; assert required values before the dependent action. Checking three rows exist does not prove there are exactly three, or that they belong to this task.",
+        "Test command nodes: assert_output on the literal pass count. An exit code alone is not proof: jest -t exits 0 when no test matches.",
         "Evidence: inspect the recipe resolution, summary, trace, manifest, logs, and actual artifacts. Verify the values and state required by the claim.",
         "For a change claim, compare the actual before/after values for the same subject. Two captures alone prove neither an update nor freshness. Preserve unchanged observations as unproven rather than retrying to obtain a pass.",
         {

package/adapters/extension/lib/slot-title.cjs

@@ -1,292 +0,0 @@
-'use strict';
-
-/**
- * Operator slot title for headed extension Chrome.
- *
- * Chrome's window label is the active tab's document.title. Farmslot stamps
- * home.html to "<slot-id> — MetaMask" so operators can tell which slot owns a
- * window when several farms run side by side.
- *
- * Stamping is best-effort: missing slot context or an uninspectable tab must
- * never fail launch/readiness. A MutationObserver keeps the prefix across
- * MetaMask SPA title resets.
- */
-
-const fs = require('node:fs');
-const http = require('node:http');
-const path = require('node:path');
-
-function sanitizeSlotId(value) {
-  const slotId = typeof value === 'string' ? value.trim() : '';
-  return /^[A-Za-z0-9._:-]{1,64}$/u.test(slotId) ? slotId : '';
-}
-
-function readSlotId(target, runtimeDir) {
-  for (const key of ['RECIPE_SLOT_ID', 'SLOT_ID', 'FARMSLOT_SLOT_ID']) {
-    const value = sanitizeSlotId(process.env[key]);
-    if (value) return value;
-  }
-  if (!target || !runtimeDir) return '';
-  try {
-    const runtimeContext = JSON.parse(
-      fs.readFileSync(path.join(target, runtimeDir, 'agentic-runtime.json'), 'utf8'),
-    );
-    return sanitizeSlotId(runtimeContext.slotId);
-  } catch {
-    // Standalone harness users do not need a custom browser title.
-    return '';
-  }
-}
-
-/**
- * Serialized page-evaluation callback. Must stay a plain function (no closure).
- */
-function applyPersistentSlotTitle(slot) {
-  // Inline sanitize because the serialized function cannot call Node helpers.
-  const id =
-    typeof slot === 'string' && /^[A-Za-z0-9._:-]{1,64}$/u.test(slot.trim())
-      ? slot.trim()
-      : '';
-  if (!id) return document.title;
-  window.__farmslotSlotId = id;
-
-  const stripSlotPrefixes = (title) => {
-    let base = String(title || 'MetaMask');
-    // Accept em dash, en dash, or hyphen — historical stampers mixed them.
-    for (let i = 0; i < 32; i += 1) {
-      const stripped = base.replace(/^.+?\s+[—–-]\s+/u, '');
-      if (stripped === base) break;
-      base = stripped;
-    }
-    return base || 'MetaMask';
-  };
-
-  const desiredTitle = () => {
-    const id = window.__farmslotSlotId;
-    if (!id) return document.title;
-    return `${id} — ${stripSlotPrefixes(document.title)}`;
-  };
-
-  const setTitle = () => {
-    if (window.__farmslotSlotTitleLock) {
-      window.__farmslotSlotTitlePending = true;
-      return;
-    }
-    const next = desiredTitle();
-    if (document.title === next) return;
-    window.__farmslotSlotTitleLock = true;
-    try {
-      document.title = next;
-    } finally {
-      // Release after the title mutation is delivered so the observer cannot
-      // re-enter and stack prefixes while React also mutates the DOM. If a
-      // mutation arrived while locked, re-apply once after unlock.
-      queueMicrotask(() => {
-        window.__farmslotSlotTitleLock = false;
-        if (window.__farmslotSlotTitlePending) {
-          window.__farmslotSlotTitlePending = false;
-          setTitle();
-        }
-      });
-    }
-  };
-
-  setTitle();
-  if (!window.__farmslotSlotTitleObserver) {
-    let node = document.querySelector('title');
-    if (!node) {
-      node = document.createElement('title');
-      (document.head || document.documentElement).appendChild(node);
-    }
-    window.__farmslotSlotTitleObserver = new MutationObserver(setTitle);
-    // Observe only the <title> element — watching head/documentElement with
-    // subtree:true re-fires on every React DOM mutation and can livelock CDP.
-    window.__farmslotSlotTitleObserver.observe(node, {
-      childList: true,
-      characterData: true,
-      subtree: true,
-    });
-  }
-  return document.title;
-}
-
-function buildStampExpression(slotId) {
-  const slot = sanitizeSlotId(slotId);
-  if (!slot) return 'document.title';
-  // Single source of truth: serialize the Playwright callback for CDP evaluate.
-  return `(${applyPersistentSlotTitle.toString()})(${JSON.stringify(slot)})`;
-}
-
-function assertLocalUrl(url) {
-  if (!/^http:\/\/127\.0\.0\.1:\d+\//u.test(url)) {
-    throw new Error(`slot-title: refusing non-local URL: ${url}`);
-  }
-}
-
-function assertLocalWebSocketUrl(url) {
-  if (!/^ws:\/\/(?:127\.0\.0\.1|localhost):\d+\//u.test(String(url))) {
-    throw new Error(`slot-title: refusing non-local websocket URL: ${url}`);
-  }
-}
-
-function httpJson(url, timeoutMs = 3000) {
-  assertLocalUrl(url);
-  return new Promise((resolve, reject) => {
-    const req = http.get(url, (res) => {
-      let data = '';
-      res.setEncoding('utf8');
-      res.on('data', (chunk) => {
-        data += chunk;
-      });
-      res.on('end', () => {
-        try {
-          resolve(JSON.parse(data));
-        } catch (err) {
-          reject(new Error(`invalid JSON from ${url}: ${err.message}`));
-        }
-      });
-    });
-    req.setTimeout(timeoutMs, () => {
-      req.destroy(new Error(`timeout from ${url}`));
-    });
-    req.on('error', reject);
-  });
-}
-
-function resolveWebSocket(target) {
-  try {
-    // Prefer the target checkout's ws, then the harness install.
-    const { createRequire } = require('node:module');
-    const req = createRequire(__filename);
-    if (target) {
-      try {
-        return req(req.resolve('ws', { paths: [target] }));
-      } catch {
-        // Fall through to harness / global.
-      }
-    }
-    return req('ws');
-  } catch {
-    return typeof WebSocket === 'function' ? WebSocket : null;
-  }
-}
-
-async function cdpEvaluate(target, webSocketDebuggerUrl, expression, timeoutMs = 5000) {
-  assertLocalWebSocketUrl(webSocketDebuggerUrl);
-  const WebSocketImpl = resolveWebSocket(target);
-  if (!WebSocketImpl) return { skipped: true, reason: 'WebSocket unavailable' };
-  return new Promise((resolve, reject) => {
-    const ws = new WebSocketImpl(webSocketDebuggerUrl);
-    const timer = setTimeout(() => {
-      try {
-        ws.close();
-      } catch {
-        // Best-effort timeout cleanup.
-      }
-      reject(new Error('timeout evaluating extension page via CDP'));
-    }, timeoutMs);
-    const onOpen = () => {
-      ws.send(
-        JSON.stringify({
-          id: 1,
-          method: 'Runtime.evaluate',
-          params: { expression, awaitPromise: true, returnByValue: true },
-        }),
-      );
-    };
-    const onMessage = (event) => {
-      const raw = event?.data ?? event;
-      const msg = JSON.parse(Buffer.isBuffer(raw) ? raw.toString('utf8') : String(raw));
-      if (msg.id !== 1) return;
-      clearTimeout(timer);
-      ws.close();
-      if (msg.error) {
-        reject(new Error(msg.error.message || JSON.stringify(msg.error)));
-        return;
-      }
-      resolve(msg.result?.result?.value ?? null);
-    };
-    const onError = (err) => {
-      clearTimeout(timer);
-      reject(new Error(`CDP websocket error while stamping slot title: ${err?.message || err || 'unknown'}`));
-    };
-    if (typeof ws.on === 'function') {
-      ws.on('open', onOpen);
-      ws.on('message', onMessage);
-      ws.on('error', onError);
-    } else {
-      ws.addEventListener('open', onOpen);
-      ws.addEventListener('message', onMessage);
-      ws.addEventListener('error', onError);
-    }
-  });
-}
-
-function isHomePage(target, extensionId) {
-  if (!target || target.type !== 'page' || typeof target.url !== 'string') return false;
-  if (!target.url.startsWith(`chrome-extension://${extensionId}/`)) return false;
-  return target.url.includes('/home.html');
-}
-
-/**
- * Stamp every inspectable home.html tab for this extension over CDP.
- * Attached tabs (no webSocketDebuggerUrl) are skipped — another client owns them.
- */
-async function stampHomeTabsViaCdp(options) {
-  const {
-    target = process.cwd(),
-    cdpPort,
-    extensionId,
-    slotId: slotIdOption,
-    runtimeDir,
-  } = options || {};
-  const slotId = sanitizeSlotId(slotIdOption) || readSlotId(target, runtimeDir);
-  const empty = { slotId: slotId || '', stamped: 0, skipped: 0, titles: [] };
-  if (!slotId || !cdpPort || !extensionId) return empty;
-
-  let targets;
-  try {
-    targets = await httpJson(`http://127.0.0.1:${cdpPort}/json/list`);
-  } catch {
-    return empty;
-  }
-  if (!Array.isArray(targets)) return empty;
-
-  const homes = targets.filter((t) => isHomePage(t, extensionId));
-  const titles = [];
-  let stamped = 0;
-  let skipped = 0;
-  const expression = buildStampExpression(slotId);
-
-  for (const home of homes) {
-    if (typeof home.webSocketDebuggerUrl !== 'string') {
-      skipped += 1;
-      continue;
-    }
-    try {
-      const title = await cdpEvaluate(target, home.webSocketDebuggerUrl, expression);
-      if (title && typeof title === 'object' && title.skipped) {
-        skipped += 1;
-        continue;
-      }
-      if (typeof title === 'string') {
-        titles.push(title);
-        stamped += 1;
-      } else {
-        skipped += 1;
-      }
-    } catch {
-      skipped += 1;
-    }
-  }
-
-  return { slotId, stamped, skipped, titles };
-}
-
-module.exports = {
-  sanitizeSlotId,
-  readSlotId,
-  applyPersistentSlotTitle,
-  buildStampExpression,
-  stampHomeTabsViaCdp,
-};