@deeeed/metamask-harness 0.24.0 → 0.25.0

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

@@ -2760,6 +2760,193 @@
         "app-mutation",
         "external-mutation"
       ]
+    },
+    "metamask.analytics.start_capture": {
+      "description": "extension Start capturing MetaMetrics events at the Segment transport and return a cursor to bracket later reads.",
+      "execution_capabilities": [
+        "arbitrary-code"
+      ],
+      "examples": [
+        {
+          "action": "metamask.analytics.start_capture",
+          "intent": "Begin capturing analytics before driving the flow",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "port": {
+            "type": "integer",
+            "description": "Collector port. Defaults to cdp_port + 1000, else 9090. The client build must point its Segment host here (extension SEGMENT_HOST, mobile SEGMENT_PROXY_URL)."
+          },
+          "cdp_port": {
+            "type": "integer"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "metamask.analytics.read_events": {
+      "description": "extension Read MetaMetrics events captured since a cursor, as [{ event, properties, ts }].",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "examples": [
+        {
+          "action": "metamask.analytics.read_events",
+          "since": 0,
+          "intent": "Inspect which analytics events the flow emitted",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "since": {
+            "type": "number",
+            "description": "Cursor (epoch ms) from start_capture. Omit to read everything captured."
+          },
+          "event": {
+            "type": "string",
+            "description": "Optional exact event-name filter."
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "metamask.analytics.assert_events": {
+      "description": "extension Assert MetaMetrics event names, property values and counts. Counts are the point: an exact count catches a double emit that a presence check cannot.",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "examples": [
+        {
+          "action": "metamask.analytics.assert_events",
+          "expect": [
+            {
+              "event": "Perp Order Cancel Transaction",
+              "count": 1
+            }
+          ],
+          "intent": "Assert the cancel event was emitted exactly once",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "since": {
+            "type": "number",
+            "description": "Cursor from start_capture; brackets the assertion to this flow."
+          },
+          "exact": {
+            "type": "boolean",
+            "description": "When true, any captured event not named in expect is a failure."
+          },
+          "timeout_ms": {
+            "type": "number",
+            "description": "How long to wait for the lower bounds to be met. Default 15000."
+          },
+          "settle_ms": {
+            "type": "number",
+            "description": "Extra wait after the bounds are met, before judging. Default 1500. Required to catch a duplicate that arrives after the expected event."
+          },
+          "expect": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "event": {
+                  "type": "string",
+                  "description": "Exact event name."
+                },
+                "count": {
+                  "type": "integer",
+                  "description": "Exact number of matching events. Mutually exclusive with min/max."
+                },
+                "min": {
+                  "type": "integer",
+                  "description": "Lower bound on matching events. Default 1."
+                },
+                "max": {
+                  "type": "integer",
+                  "description": "Upper bound on matching events."
+                },
+                "properties": {
+                  "type": "object",
+                  "description": "Subset match on event properties; only events matching all of them are counted."
+                }
+              },
+              "required": [
+                "event"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "expect"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "metamask.analytics.set_consent": {
+      "description": "extension Set MetaMetrics consent flags so events actually reach the Segment transport. Wallet fixtures set neither, so capture yields nothing without this.",
+      "execution_capabilities": [
+        "app-mutation"
+      ],
+      "examples": [
+        {
+          "action": "metamask.analytics.set_consent",
+          "intent": "Opt in before capturing analytics",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "participate": {
+            "type": "boolean",
+            "description": "MetaMetrics optedIn state. Default true."
+          },
+          "marketing": {
+            "type": "boolean",
+            "description": "dataCollectionForMarketing. Default true. Required for utm_* properties to survive."
+          },
+          "timeout_ms": {
+            "type": "number",
+            "description": "Maximum time to navigate to Settings and apply each consent toggle. Default 15000."
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "observers": [
+    {
+      "ref": "ui.screen",
+      "default_for": [
+        "ui.navigate",
+        "ui.press",
+        "ui.key_press",
+        "ui.set_input",
+        "ui.scroll",
+        "ui.wait_for",
+        "ui.screenshot"
+      ]
+    },
+    {
+      "ref": "ui.visible",
+      "default_for": [
+        "ui.navigate",
+        "ui.press",
+        "ui.key_press",
+        "ui.set_input",
+        "ui.scroll",
+        "ui.wait_for",
+        "ui.screenshot"
+      ]
     }
-  }
+  ]
 }

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

@@ -2882,6 +2882,167 @@
         "app-mutation",
         "external-mutation"
       ]
+    },
+    "metamask.analytics.start_capture": {
+      "description": "mobile Start capturing MetaMetrics events at the Segment transport and return a cursor to bracket later reads.",
+      "execution_capabilities": [
+        "arbitrary-code"
+      ],
+      "examples": [
+        {
+          "action": "metamask.analytics.start_capture",
+          "intent": "Begin capturing analytics before driving the flow",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "port": {
+            "type": "integer",
+            "description": "Collector port. Defaults to cdp_port + 1000, else 9090. The client build must point its Segment host here (extension SEGMENT_HOST, mobile SEGMENT_PROXY_URL)."
+          },
+          "cdp_port": {
+            "type": "integer"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "metamask.analytics.read_events": {
+      "description": "mobile Read MetaMetrics events captured since a cursor, as [{ event, properties, ts }].",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "examples": [
+        {
+          "action": "metamask.analytics.read_events",
+          "since": 0,
+          "intent": "Inspect which analytics events the flow emitted",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "since": {
+            "type": "number",
+            "description": "Cursor (epoch ms) from start_capture. Omit to read everything captured."
+          },
+          "event": {
+            "type": "string",
+            "description": "Optional exact event-name filter."
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "metamask.analytics.assert_events": {
+      "description": "mobile Assert MetaMetrics event names, property values and counts. Counts are the point: an exact count catches a double emit that a presence check cannot.",
+      "execution_capabilities": [
+        "host-read-export"
+      ],
+      "examples": [
+        {
+          "action": "metamask.analytics.assert_events",
+          "expect": [
+            {
+              "event": "Perp Order Cancel Transaction",
+              "count": 1
+            }
+          ],
+          "intent": "Assert the cancel event was emitted exactly once",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "since": {
+            "type": "number",
+            "description": "Cursor from start_capture; brackets the assertion to this flow."
+          },
+          "exact": {
+            "type": "boolean",
+            "description": "When true, any captured event not named in expect is a failure."
+          },
+          "timeout_ms": {
+            "type": "number",
+            "description": "How long to wait for the lower bounds to be met. Default 15000."
+          },
+          "settle_ms": {
+            "type": "number",
+            "description": "Extra wait after the bounds are met, before judging. Default 1500. Required to catch a duplicate that arrives after the expected event."
+          },
+          "expect": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "event": {
+                  "type": "string",
+                  "description": "Exact event name."
+                },
+                "count": {
+                  "type": "integer",
+                  "description": "Exact number of matching events. Mutually exclusive with min/max."
+                },
+                "min": {
+                  "type": "integer",
+                  "description": "Lower bound on matching events. Default 1."
+                },
+                "max": {
+                  "type": "integer",
+                  "description": "Upper bound on matching events."
+                },
+                "properties": {
+                  "type": "object",
+                  "description": "Subset match on event properties; only events matching all of them are counted."
+                }
+              },
+              "required": [
+                "event"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "expect"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "metamask.analytics.set_consent": {
+      "description": "mobile Set MetaMetrics consent flags through the Security & Privacy controls so events reach the Segment transport.",
+      "execution_capabilities": [
+        "app-mutation"
+      ],
+      "examples": [
+        {
+          "action": "metamask.analytics.set_consent",
+          "intent": "Opt in before capturing analytics",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "participate": {
+            "type": "boolean",
+            "description": "MetaMetrics optedIn state. Default true."
+          },
+          "marketing": {
+            "type": "boolean",
+            "description": "dataCollectionForMarketing. Default true. Required for utm_* properties to survive."
+          },
+          "timeout_ms": {
+            "type": "number",
+            "description": "Maximum time to navigate to Settings, apply each consent toggle, and read back state. Default 15000."
+          }
+        },
+        "additionalProperties": false
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -21,8 +21,8 @@
   "dependencies": {
     "@farmslot/agent-runtime": "^0.4.0",
     "@farmslot/handoff": "^0.3.1",
-    "@farmslot/protocol": "^0.13.0",
-    "@farmslot/recipe-harness": "^0.10.0",
+    "@farmslot/protocol": "^0.14.0",
+    "@farmslot/recipe-harness": "^0.10.3",
     "commander": "^12.0.0",
     "es-module-lexer": "2.3.1",
     "esbuild": "0.28.1",