mcpscraper-cli 0.35.1 → 0.37.0

package/dist/bin/cli.js

@@ -10,7 +10,7 @@ import { randomUUID } from "crypto";
 import { ScraperClient, ScraperApiError } from "mcpscraper-sdk";
 
 // src/version.ts
-var CLI_VERSION = "0.35.1";
+var CLI_VERSION = "0.37.0";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -28157,6 +28157,1529 @@ var MCP_TOOL_CATALOG = [
       "idempotentHint": true,
       "openWorldHint": true
     }
+  },
+  {
+    "name": "analytics_apply_site_setup",
+    "category": "analytics",
+    "title": "Apply X-Ray Site Setup",
+    "description": "Publish a confirmed measurement-plan revision to the installed X-Ray tag using an idempotent retry key. No repository access or visitor-experiment authority.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id owning the setup."
+        },
+        "setupId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Durable owner-bound setup id returned by an X-Ray setup operation; it is not a browser session id."
+        },
+        "revision": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Exact current setup revision. Reload stale revisions before any mutation or canary."
+        },
+        "confirmed": {
+          "type": "boolean",
+          "const": true,
+          "description": "Confirms publishing this exact measurement manifest to the installed X-Ray tag runtime. This does not activate an experiment."
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "setupId",
+        "revision",
+        "confirmed",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Apply X-Ray Site Setup",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "analytics_create_experiment",
+    "category": "analytics",
+    "title": "Create X-Ray Experiment Draft",
+    "description": "Create an owner-bound, preregistered experiment draft from a measured site. Requires a hypothesis, primary metric, guardrails, audience, duration, sample threshold, expiry, control, allocations, and only allowlisted visual operations. It never approves or activates the experiment.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "plan": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 120,
+              "description": "Owner-facing experiment name."
+            },
+            "hypothesis": {
+              "type": "string",
+              "minLength": 10,
+              "maxLength": 500,
+              "description": "Falsifiable prediction connecting the declared change to the primary metric."
+            },
+            "primaryMetricEvent": {
+              "type": "string",
+              "pattern": "^[a-z][a-z0-9_]{1,79}$",
+              "description": "Persisted X-Ray event used as the sole primary outcome metric."
+            },
+            "guardrailEvents": {
+              "default": [],
+              "description": "Events monitored for unacceptable harm; these do not replace the primary metric.",
+              "maxItems": 10,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_]{1,79}$"
+              }
+            },
+            "guardrailMaximumAbsoluteIncrease": {
+              "default": 0.05,
+              "description": "Maximum allowed absolute increase in any declared harm-event rate versus control before automatic pause.",
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "maximum": 1
+            },
+            "stoppingRule": {
+              "default": {
+                "method": "fixed_horizon",
+                "actionOnSampleRatioMismatch": "pause",
+                "actionOnGuardrailBreach": "pause",
+                "winnerRequiresSignificance": true
+              },
+              "description": "Pre-registered stopping behavior; no continuous peeking or automatic winner rollout.",
+              "type": "object",
+              "properties": {
+                "method": {
+                  "type": "string",
+                  "const": "fixed_horizon",
+                  "description": "Evaluate only after the registered minimum duration and sample."
+                },
+                "actionOnSampleRatioMismatch": {
+                  "type": "string",
+                  "const": "pause",
+                  "description": "Pause when assignment balance is invalid."
+                },
+                "actionOnGuardrailBreach": {
+                  "type": "string",
+                  "const": "pause",
+                  "description": "Pause when a registered harm guardrail is breached."
+                },
+                "winnerRequiresSignificance": {
+                  "type": "boolean",
+                  "const": true,
+                  "description": "Require the registered significance threshold before calling a winner."
+                }
+              },
+              "required": [
+                "method",
+                "actionOnSampleRatioMismatch",
+                "actionOnGuardrailBreach",
+                "winnerRequiresSignificance"
+              ],
+              "additionalProperties": false
+            },
+            "rollbackPlan": {
+              "default": {
+                "action": "restore_control",
+                "triggers": [
+                  "pause",
+                  "kill",
+                  "expiry",
+                  "manifest_error",
+                  "selector_ambiguity",
+                  "performance_guardrail"
+                ]
+              },
+              "description": "Closed rollback contract executed by the Pixel.",
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "restore_control",
+                  "description": "Restore every captured control value."
+                },
+                "triggers": {
+                  "minItems": 6,
+                  "maxItems": 6,
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "pause",
+                      "kill",
+                      "expiry",
+                      "manifest_error",
+                      "selector_ambiguity",
+                      "performance_guardrail"
+                    ],
+                    "description": "Fail-to-control condition."
+                  },
+                  "description": "Complete closed rollback trigger set."
+                }
+              },
+              "required": [
+                "action",
+                "triggers"
+              ],
+              "additionalProperties": false
+            },
+            "performanceGuardrailMs": {
+              "default": 16,
+              "description": "Maximum synchronous DOM-application time before the Pixel restores control.",
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 50
+            },
+            "audience": {
+              "type": "object",
+              "properties": {
+                "routePrefixes": {
+                  "minItems": 1,
+                  "maxItems": 25,
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "maxLength": 2e3,
+                    "pattern": "^\\/.*"
+                  },
+                  "description": "Approved route prefixes eligible for assignment."
+                },
+                "trafficClass": {
+                  "default": "production",
+                  "description": "Declared traffic population; canary state remains separately gated.",
+                  "type": "string",
+                  "enum": [
+                    "internal",
+                    "test",
+                    "production"
+                  ]
+                }
+              },
+              "required": [
+                "routePrefixes"
+              ],
+              "additionalProperties": false,
+              "description": "Bounded route and traffic audience."
+            },
+            "assignmentUnit": {
+              "default": "visitor",
+              "description": "Stable mutually exclusive assignment unit.",
+              "type": "string",
+              "enum": [
+                "visitor",
+                "session"
+              ]
+            },
+            "minimumDurationHours": {
+              "type": "integer",
+              "minimum": 24,
+              "maximum": 2160,
+              "description": "Minimum active hours before a result may be called."
+            },
+            "minimumExposures": {
+              "type": "integer",
+              "minimum": 100,
+              "maximum": 1e7,
+              "description": "Minimum visible variant exposures before evaluation."
+            },
+            "minimumDetectableEffect": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "maximum": 1,
+              "description": "Smallest absolute effect worth detecting, expressed from 0 to 1."
+            },
+            "alpha": {
+              "default": 0.05,
+              "description": "Pre-registered false-positive threshold.",
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "maximum": 0.2
+            },
+            "power": {
+              "default": 0.8,
+              "description": "Pre-registered statistical power target.",
+              "type": "number",
+              "minimum": 0.7,
+              "maximum": 0.99
+            },
+            "variants": {
+              "minItems": 2,
+              "maxItems": 8,
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "variantId": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9_-]{1,79}$",
+                    "description": "Stable variant identifier."
+                  },
+                  "label": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120,
+                    "description": "Owner-facing variant label."
+                  },
+                  "allocation": {
+                    "type": "number",
+                    "exclusiveMinimum": 0,
+                    "maximum": 1,
+                    "description": "Traffic allocation from 0 to 1; all variants must total 1."
+                  },
+                  "operations": {
+                    "maxItems": 12,
+                    "type": "array",
+                    "items": {
+                      "oneOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "kind": {
+                              "type": "string",
+                              "const": "replace_text",
+                              "description": "Replace plain text only."
+                            },
+                            "selector": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500,
+                              "description": "Unique bounded CSS selector."
+                            },
+                            "text": {
+                              "type": "string",
+                              "maxLength": 240,
+                              "description": "Replacement text without markup."
+                            }
+                          },
+                          "required": [
+                            "kind",
+                            "selector",
+                            "text"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "kind": {
+                              "type": "string",
+                              "const": "set_style_token",
+                              "description": "Apply one product-owned style token."
+                            },
+                            "selector": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500,
+                              "description": "Unique bounded CSS selector."
+                            },
+                            "token": {
+                              "type": "string",
+                              "enum": [
+                                "cta_primary",
+                                "cta_secondary",
+                                "cta_contrast",
+                                "muted",
+                                "highlight"
+                              ],
+                              "description": "Allowlisted style token."
+                            }
+                          },
+                          "required": [
+                            "kind",
+                            "selector",
+                            "token"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "kind": {
+                              "type": "string",
+                              "const": "swap_image",
+                              "description": "Swap one image using HTTPS."
+                            },
+                            "selector": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500,
+                              "description": "Unique image selector."
+                            },
+                            "src": {
+                              "type": "string",
+                              "maxLength": 2e3,
+                              "format": "uri",
+                              "description": "HTTPS image URL."
+                            },
+                            "alt": {
+                              "type": "string",
+                              "maxLength": 240,
+                              "description": "Required bounded alternative text."
+                            }
+                          },
+                          "required": [
+                            "kind",
+                            "selector",
+                            "src",
+                            "alt"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "kind": {
+                              "type": "string",
+                              "const": "move_relative",
+                              "description": "Move one sibling before or after another."
+                            },
+                            "selector": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500,
+                              "description": "Unique element selector."
+                            },
+                            "anchorSelector": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500,
+                              "description": "Unique sibling anchor selector."
+                            },
+                            "position": {
+                              "type": "string",
+                              "enum": [
+                                "before",
+                                "after"
+                              ],
+                              "description": "Placement relative to the anchor."
+                            }
+                          },
+                          "required": [
+                            "kind",
+                            "selector",
+                            "anchorSelector",
+                            "position"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "kind": {
+                              "type": "string",
+                              "const": "set_visibility",
+                              "description": "Show or hide one unique element."
+                            },
+                            "selector": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500,
+                              "description": "Unique bounded CSS selector."
+                            },
+                            "visible": {
+                              "type": "boolean",
+                              "description": "Whether the selected element should be visible."
+                            }
+                          },
+                          "required": [
+                            "kind",
+                            "selector",
+                            "visible"
+                          ],
+                          "additionalProperties": false
+                        }
+                      ]
+                    },
+                    "description": "Closed, data-only presentation operations; an empty list is the control."
+                  }
+                },
+                "required": [
+                  "variantId",
+                  "label",
+                  "allocation",
+                  "operations"
+                ],
+                "additionalProperties": false,
+                "description": "One control or treatment variant."
+              },
+              "description": "Two to eight mutually exclusive variants including one control."
+            },
+            "expiresAt": {
+              "type": "string",
+              "format": "date-time",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+              "description": "Hard experiment expiry; the Pixel rolls back after this instant."
+            }
+          },
+          "required": [
+            "name",
+            "hypothesis",
+            "primaryMetricEvent",
+            "audience",
+            "minimumDurationHours",
+            "minimumExposures",
+            "minimumDetectableEffect",
+            "variants",
+            "expiresAt"
+          ],
+          "additionalProperties": false,
+          "description": "Preregistered hypothesis, metric, audience, sample requirements, expiry, allocations, and allowlisted visual operations. One control variant must have no operations."
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "plan",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Create X-Ray Experiment Draft",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_experiment",
+    "category": "analytics",
+    "title": "Get X-Ray Experiment",
+    "description": "Read the preregistered plan, exact state, assignment counts, exposures, outcomes, and decision status for one authorized experiment. Browser intent is never reported as a terminal business outcome.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "experimentId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Owner-bound experiment id returned by analytics_create_experiment."
+        }
+      },
+      "required": [
+        "siteId",
+        "experimentId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get X-Ray Experiment",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_prepare_site_setup",
+    "category": "analytics",
+    "title": "Prepare X-Ray Site Setup",
+    "description": "Inspect the public site and prepare an expiring measurement plan for an already installed X-Ray tag. No repository access, credentials, code changes, visitor delivery, or MCP Scraper Credits.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id returned by analytics_list_sites."
+        },
+        "startUrl": {
+          "type": "string",
+          "maxLength": 3e3,
+          "format": "uri",
+          "description": "Public same-origin URL from which X-Ray discovers bounded routes and rendering surfaces."
+        },
+        "goal": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": "Plain-language customer outcome to measure; do not paste credentials, source code, form contents, or visitor data."
+        },
+        "businessModel": {
+          "description": "Optional user-confirmed model; omit to receive an evidence-backed recommendation.",
+          "type": "string",
+          "enum": [
+            "saas",
+            "lead_generation",
+            "ecommerce"
+          ]
+        },
+        "scope": {
+          "default": "same_origin",
+          "description": "Bounded route discovery scope; neither mode authorizes third-party crawling.",
+          "type": "string",
+          "enum": [
+            "same_origin",
+            "sitemap"
+          ]
+        },
+        "maxPages": {
+          "default": 50,
+          "description": "Maximum pages inspected under the X-Ray entitlement; this consumes zero MCP Scraper Credits.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 250
+        },
+        "pixelId": {
+          "description": "Optional existing Pixel belonging to the Site; omit to let the service resolve the canonical Pixel.",
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+        },
+        "consentMode": {
+          "default": "required",
+          "description": "Consent expectation for non-delivering discovery. It never grants a visitor consent choice.",
+          "type": "string",
+          "enum": [
+            "required",
+            "granted_test",
+            "unknown"
+          ]
+        }
+      },
+      "required": [
+        "siteId",
+        "startUrl"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Prepare X-Ray Site Setup",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "analytics_set_experiment_state",
+    "category": "analytics",
+    "title": "Set X-Ray Experiment State",
+    "description": "Approve, canary, activate, pause, kill, or archive one exact experiment revision. Approval and visitor activation are separate confirmed steps. Activation publishes the signed tag manifest; pause and kill publish rollback. Reuse the same idempotency key only for the identical transition.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "experimentId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Owner-bound experiment id returned by analytics_create_experiment."
+        },
+        "revision": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Exact experiment revision being changed."
+        },
+        "operation": {
+          "type": "string",
+          "enum": [
+            "approve",
+            "activate_canary",
+            "activate",
+            "pause",
+            "kill",
+            "archive"
+          ],
+          "description": "Approval and activation are distinct operations. Pause and kill publish rollback immediately."
+        },
+        "confirmed": {
+          "description": "Required for approve, activate_canary, and activate. This confirms only the exact state transition.",
+          "type": "boolean",
+          "const": true
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "experimentId",
+        "revision",
+        "operation",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Set X-Ray Experiment State",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_setup_site",
+    "category": "analytics",
+    "title": "Install X-Ray on a Site",
+    "description": "Use for \u201Cset up X-Ray\u201D or \u201Ctell me what drives customers.\u201D One installed X-Ray tag loads a digest-bound, versioned measurement manifest across approved pages; GitHub access is not required. State is a durable owner-bound setupId and revision, never a browser session. Setup charges zero MCP Scraper Credits. Apply publishes measurement rules only. Experiment approval and activation are separate. Returns exactly one honest next action.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "description": "Authorized Analytics Site id. Supply siteId or startUrl on the first call.",
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+        },
+        "startUrl": {
+          "description": "Public same-origin URL to set up. Supply only when siteId is not yet known.",
+          "type": "string",
+          "maxLength": 3e3,
+          "format": "uri"
+        },
+        "goal": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": "Plain-language customer outcome to measure; do not paste credentials, source code, form contents, or visitor data."
+        },
+        "setupId": {
+          "description": "Reuse to continue an existing durable setup after approval, deployment, or reconnecting.",
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+        },
+        "revision": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Exact current setup revision. Reload stale revisions before any mutation or canary."
+        },
+        "businessModel": {
+          "description": "Optional explicit business model; omit to infer it from bounded site evidence.",
+          "type": "string",
+          "enum": [
+            "saas",
+            "lead_generation",
+            "ecommerce"
+          ]
+        },
+        "goalAction": {
+          "default": "continue",
+          "description": "Desired lifecycle step. Continue lets the fa\xE7ade select the single safe next operation from durable state.",
+          "type": "string",
+          "enum": [
+            "continue",
+            "prepare",
+            "apply",
+            "verify",
+            "first_answers"
+          ]
+        },
+        "authority": {
+          "description": "Source authority or ownership context supporting this content.",
+          "type": "object",
+          "properties": {
+            "confirmed": {
+              "description": "Confirms publishing this exact setup revision to the installed X-Ray tag runtime. It does not authorize a visitor experiment.",
+              "type": "boolean",
+              "const": true
+            },
+            "confirmedCanary": {
+              "description": "Separately authorizes labeled verification canaries for this exact revision; it does not authorize apply, merge, or deploy.",
+              "type": "boolean",
+              "const": true
+            }
+          },
+          "additionalProperties": false
+        },
+        "idempotencyKey": {
+          "description": "Required only for apply or canary-capable verify; reuse for the exact same intent after an unknown result.",
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160
+        }
+      },
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Install X-Ray on a Site",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "analytics_verify_site_setup",
+    "category": "analytics",
+    "title": "Verify X-Ray Site Setup",
+    "description": "Expert live proof. Defaults non-delivering; confirmedCanary allows labeled canaries. A PR/build is not deployed definition or outcome proof.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id owning the setup."
+        },
+        "setupId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Durable owner-bound setup id returned by an X-Ray setup operation; it is not a browser session id."
+        },
+        "revision": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Exact current setup revision. Reload stale revisions before any mutation or canary."
+        },
+        "confirmedCanary": {
+          "description": "Omit for non-delivering interception. True separately authorizes only labeled, bounded canaries; it does not authorize merge or deploy.",
+          "type": "boolean",
+          "const": true
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "setupId",
+        "revision",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Verify X-Ray Site Setup",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "analytics_apply_revenue_source",
+    "category": "analytics",
+    "title": "Apply SaaS Revenue Authority",
+    "description": "Apply one exact reviewed revenue-source revision using an idempotency key. It binds an authorized provider account and authority role; it never accepts credentials and does not claim the source live before provider receipt verification.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "setupId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Owner-bound revenue setup id returned by prepare or the facade."
+        },
+        "revision": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Exact current revenue setup revision; reload before retrying a stale mutation."
+        },
+        "confirmed": {
+          "type": "boolean",
+          "const": true,
+          "description": "Confirms this exact provider account, role, and event-family revision."
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "setupId",
+        "revision",
+        "confirmed",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Apply SaaS Revenue Authority",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "analytics_create_post_purchase_survey",
+    "category": "analytics",
+    "title": "Create Post-Purchase Survey Draft",
+    "description": "Create an idempotent, structured, contact-free post-purchase survey draft. Customer answers remain reported influence and cannot establish identity, mutate CRM, qualify activation, or change observed touches.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 160,
+          "description": "Owner-facing survey name."
+        },
+        "question": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": "Customer-visible structured influence question; do not request contact data or free text."
+        },
+        "selectionMode": {
+          "type": "string",
+          "enum": [
+            "single",
+            "multiple"
+          ],
+          "description": "Whether a respondent may select one influence or several."
+        },
+        "eligibleOutcomeFamilies": {
+          "minItems": 1,
+          "maxItems": 20,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 80
+          },
+          "description": "Authoritative outcome families eligible to receive an invitation."
+        },
+        "exchangeTtlSeconds": {
+          "type": "integer",
+          "minimum": 60,
+          "maximum": 86400,
+          "description": "Short-lived merchant exchange-code lifetime."
+        },
+        "sessionTtlSeconds": {
+          "type": "integer",
+          "minimum": 60,
+          "maximum": 86400,
+          "description": "Hosted survey session lifetime after one-time exchange."
+        },
+        "approvedCopyId": {
+          "description": "Versioned privacy disclosure approval. A draft may omit it; production publication may not.",
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "options": {
+          "minItems": 2,
+          "maxItems": 20,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "optionId": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 80,
+                "description": "Stable opaque option id; changing a label never changes this id."
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 160,
+                "description": "Bounded owner-authored influence label. Free-text customer testimony is not accepted."
+              }
+            },
+            "required": [
+              "optionId",
+              "label"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Two to twenty stable structured influences."
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "name",
+        "question",
+        "selectionMode",
+        "eligibleOutcomeFamilies",
+        "exchangeTtlSeconds",
+        "sessionTtlSeconds",
+        "options",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Create Post-Purchase Survey Draft",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_attribution_methodology",
+    "category": "analytics",
+    "title": "Get X-Ray Attribution Methodology",
+    "description": "Read the seven observed models, default position weights, explicit observed-plus-reported methodology, and evidence boundaries. Use before requesting combined impact; this never turns survey testimony or aggregate impressions into deterministic touches.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get X-Ray Attribution Methodology",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_impact_report",
+    "category": "analytics",
+    "title": "Get Observed and Reported Impact",
+    "description": "Read an opt-in impact projection that keeps observed attribution and customer-reported influence in separate ledgers. Requires a published survey, one existing observed model, an immutable methodology version, and explicit weights totaling 1,000,000 micros.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "surveyId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Published or paused post-purchase survey whose immutable responses supply the reported ledger."
+        },
+        "baseModel": {
+          "type": "string",
+          "enum": [
+            "first_touch",
+            "last_touch",
+            "last_non_direct",
+            "linear",
+            "time_decay",
+            "position_based",
+            "custom_weighted"
+          ],
+          "description": "Existing observed attribution model; observed_plus_reported is deliberately not an observed model."
+        },
+        "observedWeightMicros": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1e6,
+          "description": "Observed share in micros. It must total exactly 1,000,000 with reportedWeightMicros."
+        },
+        "reportedWeightMicros": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1e6,
+          "description": "Customer-reported share in micros. It must total exactly 1,000,000 with observedWeightMicros."
+        },
+        "methodologyVersion": {
+          "type": "string",
+          "const": "xray_observed_plus_reported_equal_selected_v1",
+          "description": "Immutable methodology selected after reading analytics_get_attribution_methodology."
+        },
+        "from": {
+          "description": "Inclusive observed-evidence start. Omit with to for the last 30 days.",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+        },
+        "to": {
+          "description": "Exclusive observed-evidence end. Omit to use now.",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+        },
+        "clickWindow": {
+          "default": 90,
+          "description": "Independent observed click window.",
+          "anyOf": [
+            {
+              "type": "number",
+              "const": 7
+            },
+            {
+              "type": "number",
+              "const": 14
+            },
+            {
+              "type": "number",
+              "const": 30
+            },
+            {
+              "type": "number",
+              "const": 60
+            },
+            {
+              "type": "number",
+              "const": 90
+            },
+            {
+              "type": "number",
+              "const": 180
+            },
+            {
+              "type": "number",
+              "const": 365
+            },
+            {
+              "type": "string",
+              "const": "lifetime"
+            }
+          ]
+        },
+        "viewWindow": {
+          "default": 90,
+          "description": "Independent view window; provider-unavailable state never manufactures view touches.",
+          "anyOf": [
+            {
+              "type": "number",
+              "const": 7
+            },
+            {
+              "type": "number",
+              "const": 14
+            },
+            {
+              "type": "number",
+              "const": 30
+            },
+            {
+              "type": "number",
+              "const": 60
+            },
+            {
+              "type": "number",
+              "const": 90
+            },
+            {
+              "type": "number",
+              "const": 180
+            },
+            {
+              "type": "number",
+              "const": 365
+            },
+            {
+              "type": "string",
+              "const": "lifetime"
+            }
+          ]
+        }
+      },
+      "required": [
+        "siteId",
+        "surveyId",
+        "baseModel",
+        "observedWeightMicros",
+        "reportedWeightMicros",
+        "methodologyVersion"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get Observed and Reported Impact",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_post_purchase_survey_report",
+    "category": "analytics",
+    "title": "Get Post-Purchase Survey Report",
+    "description": "Read aggregate response coverage, option counts, and separately labeled reported-influence evidence for one survey. The output excludes contact fields, raw invitation tokens, and deterministic touch claims.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "surveyId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Owner-bound survey id."
+        }
+      },
+      "required": [
+        "siteId",
+        "surveyId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get Post-Purchase Survey Report",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_view_evidence_status",
+    "category": "analytics",
+    "title": "Get Provider View Evidence Status",
+    "description": "Read provider-by-provider availability for event-level view evidence. Unavailable or unproven is an honest result; aggregate campaign impressions can never create person-level attribution touches.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get Provider View Evidence Status",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_prepare_revenue_source",
+    "category": "analytics",
+    "title": "Prepare SaaS Revenue Authority",
+    "description": "Inspect an already-authorized provider connection and return a revisioned primary-or-observation revenue plan. This read-like preparation may query the provider but cannot create revenue or receive a provider credential.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "serviceConnectionRef": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 240,
+          "description": "Already-authorized connected-account reference. Credentials never belong in this input."
+        },
+        "role": {
+          "default": "primary",
+          "description": "Choose one primary authority per subscription-revenue outcome family; observation sources cannot create revenue.",
+          "type": "string",
+          "enum": [
+            "primary",
+            "observation"
+          ]
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "serviceConnectionRef",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Prepare SaaS Revenue Authority",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "analytics_set_post_purchase_survey_state",
+    "category": "analytics",
+    "title": "Set Post-Purchase Survey State",
+    "description": "Publish, pause, or irreversibly archive one exact survey revision. Production publication requires approved privacy disclosure evidence. Reuse the same idempotency key only for the identical transition; archive cannot be undone.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "surveyId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Owner-bound survey id."
+        },
+        "revision": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Exact survey revision being changed."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "published",
+            "paused",
+            "archived"
+          ],
+          "description": "Publish or pause this revision. Archive is irreversible."
+        },
+        "approvedCopyId": {
+          "description": "Approved privacy disclosure identifier required for production publication; it is not legal approval by itself.",
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "surveyId",
+        "revision",
+        "state",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Set Post-Purchase Survey State",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_setup_revenue_source",
+    "category": "analytics",
+    "title": "Set Up SaaS Revenue Authority",
+    "description": "Use as the customer-facing SaaS revenue setup facade after tag and measurement readiness. It prepares, reads, applies, or verifies one owner-authorized subscription authority without accepting credentials. Provider calls may occur only through the approved connected account; reuse setupId and revision.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "action": {
+          "default": "continue",
+          "description": "Lifecycle action. Continue reads an existing setup or prepares one when serviceConnectionRef is supplied.",
+          "type": "string",
+          "enum": [
+            "continue",
+            "prepare",
+            "apply",
+            "verify"
+          ]
+        },
+        "setupId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Owner-bound revenue setup id returned by prepare or the facade."
+        },
+        "serviceConnectionRef": {
+          "description": "Already-authorized connected-account reference. Never supply a credential, token, or provider key.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 240
+        },
+        "role": {
+          "default": "primary",
+          "description": "Primary may create subscription outcomes; observation only compares provider evidence.",
+          "type": "string",
+          "enum": [
+            "primary",
+            "observation"
+          ]
+        },
+        "revision": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Exact current revenue setup revision; reload before retrying a stale mutation."
+        },
+        "confirmed": {
+          "description": "Required only to apply the exact reviewed revision.",
+          "type": "boolean",
+          "const": true
+        },
+        "idempotencyKey": {
+          "description": "Required for apply and verify. Reuse only for the identical operation.",
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Set Up SaaS Revenue Authority",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "analytics_verify_revenue_source",
+    "category": "analytics",
+    "title": "Verify SaaS Revenue Authority",
+    "description": "Verify one applied revenue source through the approved provider connection and return a redacted non-customer receipt state. A successful API call without a signed webhook or reconciliation receipt is not live proof.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Authorized Analytics Site id."
+        },
+        "setupId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Owner-bound revenue setup id returned by prepare or the facade."
+        },
+        "revision": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Exact current revenue setup revision; reload before retrying a stale mutation."
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "setupId",
+        "revision",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Verify SaaS Revenue Authority",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    }
   }
 ];
 var MCP_TOOL_NAMES = MCP_TOOL_CATALOG.map((tool) => tool.name);