mcp-scraper 0.74.0 → 0.75.0

package/dist/{chunk-IBJAMD4I.js → chunk-DT7UD2ER.js}

@@ -32,7 +32,7 @@ import {
 } from "./chunk-VXLU74YZ.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-O5IRADYV.js";
+} from "./chunk-RDPWFAR3.js";
 import {
   createPrivateArtifact,
   privateArtifactOwnerId,
@@ -45,7 +45,7 @@ import {
   PAA_QUESTION_CREDITS,
   PAGE_SCRAPE_CREDITS,
   SERP_SEARCH_CREDITS
-} from "./chunk-EQJRPDUS.js";
+} from "./chunk-6W4ADSWE.js";
 import {
   PUBLIC_ERROR_CODES,
   buildPublicErrorEnvelope,
@@ -640,6 +640,18 @@ var FIELD_DESCRIPTIONS = {
   eventName: "Optional normalized analytics event-name filter.",
   eventId: "Caller-owned canonical event identifier used for end-to-end deduplication.",
   eventKind: "Canonical event family used for journey storage and conversion-rule evaluation.",
+  definitionId: "Browser event-definition identifier returned by analytics_list_event_definitions.",
+  timeoutMs: "Bounded server wait in milliseconds before returning a not-observed result.",
+  maxAgeSeconds: "Maximum age in seconds for a persisted matching event to count as live verification.",
+  operatingAccountId: "Google Ads operating account identifier required for Google Data Manager destinations.",
+  destinationId: "Activation destination identifier returned by analytics_list_activation_destinations.",
+  previewFingerprint: "Exact SHA-256 fingerprint returned by analytics_preview_crm_import.",
+  acknowledgedPurpose: "Explicit governed purpose acknowledgement required for advertising identifiers or activation exports.",
+  mappings: "Bounded typed event-mapping rows for this activation destination.",
+  providerEvent: "Exact provider event or conversion-action name receiving the confirmed X-Ray event.",
+  role: "Primary conversion or supporting observation role for this enabled mapping.",
+  valueMode: "Whether the provider event receives no value, the confirmed event value, or a fixed configured value.",
+  fixedValue: "Non-negative fixed major-unit value used only when valueMode is fixed.",
   occurredAt: "ISO 8601 timestamp when the source event actually occurred.",
   sourceEventId: "Stable identifier assigned by the source system for idempotent ingestion.",
   sourceAccountRef: "Stable non-secret account identifier at the phone, CRM, or event source.",
@@ -11516,15 +11528,17 @@ var AnalyticsReportTypeSchema = z8.enum([
   "sessions",
   "funnel"
 ]);
-var AnalyticsAttributionModelSchema = z8.enum([
+var AnalyticsAttributionModelInputSchema = z8.enum([
   "first_touch",
   "last_touch",
   "last_non_direct",
   "linear",
   "time_decay",
   "position_based",
+  "position_40_20_40",
   "custom_weighted"
 ]);
+var AnalyticsAttributionModelSchema = AnalyticsAttributionModelInputSchema.transform((model) => model === "position_40_20_40" ? "position_based" : model);
 var AnalyticsAttributionWindowSchema = z8.union([
   z8.literal(7),
   z8.literal(14),
@@ -11780,6 +11794,46 @@ var AnalyticsSavedViewSchema = z8.object({
   createdAt: z8.string().datetime().optional(),
   updatedAt: z8.string().datetime().optional()
 }).strict();
+var AnalyticsAttributionQuerySchema = z8.object({
+  model: AnalyticsAttributionModelSchema.default("position_based"),
+  clickWindow: z8.union([z8.coerce.number().int(), z8.literal("lifetime")]).pipe(AnalyticsAttributionWindowSchema).default(90),
+  viewWindow: z8.union([z8.coerce.number().int(), z8.literal("lifetime")]).pipe(AnalyticsAttributionWindowSchema).default(30),
+  journeyTier: AnalyticsJourneyTierSchema.default("confirmed"),
+  compareModels: z8.array(AnalyticsAttributionModelSchema).max(2).default([]),
+  customWeights: z8.object({
+    first: z8.number().finite().min(0),
+    middle: z8.number().finite().min(0),
+    last: z8.number().finite().min(0)
+  }).strict().optional()
+}).strict().superRefine((query, ctx) => {
+  const usesCustomWeights = query.model === "custom_weighted" || query.compareModels.includes("custom_weighted");
+  if (usesCustomWeights && !query.customWeights) {
+    ctx.addIssue({ code: "custom", path: ["customWeights"], message: "custom_weighted requires first, middle, and last weights." });
+  }
+  if (!usesCustomWeights && query.customWeights) {
+    ctx.addIssue({ code: "custom", path: ["customWeights"], message: "customWeights is only valid for custom_weighted." });
+  }
+  if (query.customWeights && query.customWeights.first + query.customWeights.middle + query.customWeights.last <= 0) {
+    ctx.addIssue({ code: "custom", path: ["customWeights"], message: "Custom weights must have a positive total." });
+  }
+  if (query.compareModels.includes(query.model)) {
+    ctx.addIssue({ code: "custom", path: ["compareModels"], message: "Comparison models must differ from the primary model." });
+  }
+  if (new Set(query.compareModels).size !== query.compareModels.length) {
+    ctx.addIssue({ code: "custom", path: ["compareModels"], message: "Comparison models must be unique." });
+  }
+});
+function parseAnalyticsAttributionQuery(input) {
+  const weights = input.customWeights?.split(",").map((value) => Number(value.trim()));
+  return AnalyticsAttributionQuerySchema.parse({
+    model: input.attributionModel || void 0,
+    clickWindow: input.clickWindow || void 0,
+    viewWindow: input.viewWindow || void 0,
+    journeyTier: input.journeyTier || void 0,
+    compareModels: input.compareModels ?? [],
+    customWeights: weights ? { first: weights[0], middle: weights[1], last: weights[2] } : void 0
+  });
+}
 function parseAnalyticsReportView(input) {
   return AnalyticsReportViewSchema.parse(input);
 }
@@ -12062,6 +12116,7 @@ var AnalyticsCrmOutboundReceiptSchema = z10.object({
 }).strict();
 
 // src/mcp/analytics-mcp-schemas.ts
+var AnalyticsLegacyIdempotencyKey = z11.string().trim().min(8).max(160).describe("Retry key; reuse only for this exact mutation.");
 var AnalyticsListSitesInputSchema = {};
 var AnalyticsGetEntitlementInputSchema = {};
 var AnalyticsReportInputSchema = {
@@ -12113,7 +12168,8 @@ var AnalyticsCreateCampaignLinkInputSchema = {
   content: z11.string().max(240).optional(),
   adGroup: z11.string().max(240).optional(),
   adName: z11.string().max(240).optional(),
-  creativeId: z11.string().max(240).optional()
+  creativeId: z11.string().max(240).optional(),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsCreateFormInputSchema = {
   siteId: z11.string().uuid(),
@@ -12135,14 +12191,17 @@ var AnalyticsCreateFormInputSchema = {
   submitLabel: z11.string().min(1).max(80).optional(),
   successMessage: z11.string().min(1).max(500).optional(),
   consentText: z11.string().max(1e3).optional(),
-  publish: z11.boolean().default(true)
+  publish: z11.boolean().default(true),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsCreateActivationInputSchema = {
   siteId: z11.string().uuid(),
   platform: z11.enum(["meta", "google", "tiktok", "reddit"]),
   name: z11.string().min(1).max(120),
   connectionRef: z11.string().trim().min(1).max(240),
-  externalDatasetId: z11.string().trim().min(1).max(240)
+  externalDatasetId: z11.string().trim().min(1).max(240),
+  operatingAccountId: z11.string().trim().min(1).max(256).optional(),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsCreateConnectionInputSchema = {
   siteId: z11.string().uuid(),
@@ -12151,7 +12210,8 @@ var AnalyticsCreateConnectionInputSchema = {
   sourceAccountRef: z11.string().min(1).max(240),
   serviceConnectionRef: z11.string().max(240).optional(),
   webhookSecret: z11.string().min(8).max(1e3).optional(),
-  config: z11.record(z11.string(), z11.unknown()).optional()
+  config: z11.record(z11.string(), z11.unknown()).optional(),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsCreateRuleInputSchema = {
   siteId: z11.string().uuid(),
@@ -12170,7 +12230,8 @@ var AnalyticsCreateRuleInputSchema = {
   }),
   defaultValueMinor: z11.number().int().min(0).max(Number.MAX_SAFE_INTEGER).optional(),
   defaultCurrency: z11.string().length(3).default("USD"),
-  enabled: z11.boolean().default(true)
+  enabled: z11.boolean().default(true),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsEventDefinitionFields = {
   name: z11.string().min(1).max(120).describe("Human-readable definition name unique within the Site."),
@@ -12192,7 +12253,8 @@ var AnalyticsEventDefinitionFields = {
 };
 var AnalyticsCreateEventDefinitionInputSchema = {
   siteId: z11.string().uuid(),
-  ...AnalyticsEventDefinitionFields
+  ...AnalyticsEventDefinitionFields,
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsUpdateEventDefinitionInputSchema = {
   siteId: z11.string().uuid(),
@@ -12206,11 +12268,13 @@ var AnalyticsUpdateEventDefinitionInputSchema = {
   hostnames: z11.array(z11.string().min(1).max(253)).max(25).optional().describe("Replacement approved bare-hostname scope."),
   metadata: AnalyticsEventDefinitionFields.metadata.unwrap().nullable().optional().describe("Replacement safe metadata; null clears it."),
   oncePerSession: z11.boolean().optional().describe("Replacement once-per-browser-session behavior."),
-  enabled: z11.boolean().optional().describe("Replacement enabled state.")
+  enabled: z11.boolean().optional().describe("Replacement enabled state."),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsArchiveEventDefinitionInputSchema = {
   siteId: z11.string().uuid(),
-  definitionId: z11.string().uuid().describe("Event definition id returned by analytics_list_event_definitions.")
+  definitionId: z11.string().uuid().describe("Event definition id returned by analytics_list_event_definitions."),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsTestEventDefinitionInputSchema = {
   siteId: z11.string().uuid(),
@@ -12221,11 +12285,18 @@ var AnalyticsTestEventDefinitionInputSchema = {
   tagEventName: z11.string().regex(/^[a-z][a-z0-9_]{1,79}$/).optional().describe("Validated data-xray-event name observed by the browser."),
   selectorMatched: z11.boolean().optional().describe("The browser-reported match result. The server never receives HTML or evaluates a selector.")
 };
+var AnalyticsVerifyLiveEventDefinitionInputSchema = {
+  siteId: z11.string().uuid(),
+  definitionId: z11.string().uuid(),
+  timeoutMs: z11.number().int().min(0).max(15e3).default(0).describe("Bounded wait for a newly persisted matching event."),
+  maxAgeSeconds: z11.number().int().min(1).max(86400).default(300).describe("Maximum accepted age of the persisted matching event.")
+};
 var AnalyticsTestActivationDestinationInputSchema = {
   siteId: z11.string().uuid(),
   destinationId: z11.string().uuid().describe("Activation destination id returned by analytics_list_activation_destinations."),
   testEventCode: z11.string().trim().min(1).max(128).optional().describe("Provider test event code required by Meta and TikTok. Obtain it from the authorized provider test-events screen; it is sent only to that configured destination."),
-  testId: z11.string().trim().min(1).max(255).optional().describe("Provider test ID required by Reddit Conversions API. It is sent only to that configured destination.")
+  testId: z11.string().trim().min(1).max(255).optional().describe("Provider test ID required by Reddit Conversions API. It is sent only to that configured destination."),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsListActivationReceiptsInputSchema = {
   siteId: z11.string().uuid(),
@@ -12235,11 +12306,13 @@ var AnalyticsListActivationReceiptsInputSchema = {
 };
 var AnalyticsRetryActivationDeliveryInputSchema = {
   siteId: z11.string().uuid(),
-  jobId: z11.string().uuid().describe("Failed activation job id returned by analytics_list_activation_receipts.")
+  jobId: z11.string().uuid().describe("Failed activation job id returned by analytics_list_activation_receipts."),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsReconcileConnectionInputSchema = {
   siteId: z11.string().uuid(),
-  connectionId: z11.string().uuid().describe("Phone or CRM connection id returned by analytics_list_connections.")
+  connectionId: z11.string().uuid().describe("Phone or CRM connection id returned by analytics_list_connections."),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsRecordExternalEventInputSchema = {
   siteId: z11.string().uuid(),
@@ -12277,7 +12350,8 @@ var AnalyticsRecordExternalEventInputSchema = {
     li_fat_id: z11.string().max(500).optional(),
     snapclid: z11.string().max(500).optional()
   }).optional(),
-  properties: z11.record(z11.string(), z11.unknown()).optional()
+  properties: z11.record(z11.string(), z11.unknown()).optional(),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsJourneyInputSchema = {
   siteId: z11.string().uuid(),
@@ -12296,7 +12370,68 @@ var AnalyticsCrmImportInputSchema = {
     phone: z11.string().optional(),
     company: z11.string().optional(),
     externalId: z11.string().optional()
-  })
+  }),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
+};
+var AnalyticsManualImportMapping = z11.record(z11.enum([
+  "email",
+  "firstName",
+  "lastName",
+  "name",
+  "phone",
+  "company",
+  "externalId",
+  "stage",
+  "outcome",
+  "occurredAt",
+  "value",
+  "currency",
+  "gclid",
+  "gbraid",
+  "wbraid",
+  "fbclid"
+]), z11.string().trim().min(1).max(240));
+var AnalyticsManualImportFields = {
+  siteId: z11.string().uuid(),
+  sourceSystem: z11.enum(["hubspot", "salesforce", "gohighlevel", "zoho", "pipedrive", "keap", "other"]),
+  filename: z11.string().trim().min(1).max(240),
+  csv: z11.string().min(1).max(8e6),
+  mapping: AnalyticsManualImportMapping
+};
+var AnalyticsPreviewCrmImportInputSchema = AnalyticsManualImportFields;
+var AnalyticsCommitCrmImportInputSchema = {
+  ...AnalyticsManualImportFields,
+  previewFingerprint: z11.string().regex(/^[a-f0-9]{64}$/),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
+};
+var AnalyticsCrmExportField = z11.enum([
+  "person_id",
+  "crm_person_ref",
+  "journey_url",
+  "first_seen_at",
+  "last_seen_at",
+  "signal_count",
+  "form_submission_count",
+  "conversion_count",
+  "revenue_minor",
+  "currency",
+  "stage",
+  "outcome",
+  "gclid",
+  "gbraid",
+  "wbraid",
+  "fbclid"
+]);
+var AnalyticsCrmManualExportInputSchema = {
+  siteId: z11.string().uuid(),
+  fields: z11.array(AnalyticsCrmExportField).min(1).max(16).optional(),
+  acknowledgedPurpose: z11.enum(["business_operations", "advertising_measurement"]).optional(),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
+};
+var AnalyticsAdManualExportInputSchema = {
+  siteId: z11.string().uuid(),
+  acknowledgedPurpose: z11.literal("advertising_measurement"),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsCreateExportInputSchema = {
   ...AnalyticsReportInputSchema,
@@ -12589,7 +12724,31 @@ var AnalyticsActivationMappingInputSchema = {
   journeyTier: z11.literal("confirmed").default("confirmed").describe("External activation is confirmed-only. Best-guess and candidate-assisted journey evidence is schema-invalid."),
   platform: z11.enum(["meta", "google", "tiktok", "reddit"]).describe("Destination provider."),
   externalDatasetId: z11.string().min(1).max(500).describe("Authorized dataset, Pixel, or conversion-action id."),
-  eventMapping: z11.record(z11.string().regex(/^[a-z][a-z0-9_]{1,79}$/), z11.string().min(1).max(160)).describe("Confirmed X-Ray event to provider event mapping. Candidate-assisted events are ineligible.")
+  eventMapping: z11.record(z11.string().regex(/^[a-z][a-z0-9_]{1,79}$/), z11.string().min(1).max(160)).describe("Confirmed X-Ray event to provider event mapping.")
+};
+var AnalyticsSaveActivationMappingInputSchema = {
+  siteId: z11.string().uuid(),
+  destinationId: z11.string().uuid(),
+  journeyTier: z11.literal("confirmed").default("confirmed"),
+  eventMapping: z11.object({
+    schemaVersion: z11.literal(1),
+    mappings: z11.array(z11.object({
+      source: z11.string().min(1).max(160),
+      providerEvent: z11.string().min(1).max(160),
+      enabled: z11.boolean(),
+      role: z11.enum(["primary", "observation"]),
+      valueMode: z11.enum(["none", "event", "fixed"]),
+      fixedValue: z11.number().finite().min(0).max(1e9).optional(),
+      currency: z11.string().length(3).optional()
+    }).strict()).max(200)
+  }).strict().describe("Typed confirmed-event mapping; enabled rows require exactly one primary event."),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
+};
+var AnalyticsSetActivationAutomationInputSchema = {
+  siteId: z11.string().uuid(),
+  destinationId: z11.string().uuid(),
+  enabled: z11.boolean().describe("Explicitly enable or disable automatic delivery. Enabling requires a verified destination."),
+  idempotencyKey: AnalyticsLegacyIdempotencyKey
 };
 var AnalyticsListSitesOutputSchema = {
   ok: z11.boolean(),
@@ -12641,9 +12800,103 @@ var AnalyticsReportOutputSchema = {
 };
 var AnalyticsGenericOutputSchema = { ok: z11.boolean() };
 var AnalyticsSafeOutputRecord = z11.record(z11.string(), z11.unknown());
-var AnalyticsSafeOutputRecords = z11.array(AnalyticsSafeOutputRecord);
+var AnalyticsSafeOutputRecords = z11.array(AnalyticsSafeOutputRecord).max(500);
 var analyticsRecordOutput = (field) => ({ ok: z11.boolean(), [field]: AnalyticsSafeOutputRecord });
 var analyticsRecordsOutput = (field) => ({ ok: z11.boolean(), [field]: AnalyticsSafeOutputRecords });
+var AnalyticsManualImportPreviewOutputSchema = {
+  ok: z11.boolean(),
+  preview: z11.object({
+    schemaVersion: z11.literal(1),
+    fingerprint: z11.string().regex(/^[a-f0-9]{64}$/),
+    headers: z11.array(z11.string().max(240)).max(240),
+    totalRows: z11.number().int().min(0).max(2500),
+    acceptedRows: z11.number().int().min(0).max(2500),
+    rejectedRows: z11.number().int().min(0).max(2500),
+    sample: z11.array(AnalyticsSafeOutputRecord).max(5),
+    errors: z11.array(AnalyticsSafeOutputRecord).max(100),
+    errorReceipt: AnalyticsSafeOutputRecord.nullable()
+  }).strict()
+};
+var AnalyticsManualImportCommitOutputSchema = {
+  ok: z11.boolean(),
+  import: AnalyticsSafeOutputRecord,
+  receipt: AnalyticsSafeOutputRecord
+};
+var AnalyticsManualExportOutputSchema = {
+  ok: z11.boolean(),
+  artifact: z11.object({
+    schemaVersion: z11.string().min(1).max(120),
+    kind: z11.enum(["crm_csv", "google_ads_offline_csv", "meta_conversions_api_jsonl"]),
+    filename: z11.string().min(1).max(500),
+    mediaType: z11.string().min(1).max(160),
+    nativeUploadSupported: z11.boolean(),
+    label: z11.string().min(1).max(500),
+    content: z11.string().max(65536),
+    rowCount: z11.number().int().min(0).max(2500),
+    omittedForConsent: z11.number().int().min(0)
+  }).strict()
+};
+var AnalyticsActivationDestinationOutputSchema = analyticsRecordOutput("destination");
+var AnalyticsLiveEventVerificationOutputSchema = {
+  ok: z11.boolean(),
+  verification: z11.object({
+    status: z11.enum(["observed_live_match", "not_observed"]),
+    definitionId: z11.string().uuid(),
+    definitionVersion: z11.number().int().positive(),
+    eventId: z11.string().min(8).max(200).nullable(),
+    observedAt: z11.string().datetime().nullable(),
+    maxAgeSeconds: z11.number().int().min(1).max(86400)
+  }).strict()
+};
+var AnalyticsLegacyOperationOutputSchemas = {
+  analytics_get_timeseries: AnalyticsReportOutputSchema,
+  analytics_get_events: AnalyticsReportOutputSchema,
+  analytics_get_dimensions: AnalyticsReportOutputSchema,
+  analytics_get_business_metrics: AnalyticsReportOutputSchema,
+  analytics_get_forecast: analyticsRecordOutput("data"),
+  analytics_list_pixels: analyticsRecordsOutput("pixels"),
+  analytics_list_campaign_links: analyticsRecordOutput("data"),
+  analytics_list_forms: analyticsRecordOutput("data"),
+  analytics_list_crm_imports: analyticsRecordOutput("data"),
+  analytics_list_activation_destinations: analyticsRecordsOutput("destinations"),
+  analytics_list_connections: analyticsRecordsOutput("connections"),
+  analytics_list_conversion_rules: analyticsRecordsOutput("rules"),
+  analytics_list_event_definitions: analyticsRecordsOutput("definitions"),
+  analytics_get_coverage: analyticsRecordOutput("coverage"),
+  analytics_get_person_journey: analyticsRecordOutput("journey"),
+  analytics_create_campaign_link: analyticsRecordOutput("link"),
+  analytics_create_form: analyticsRecordOutput("form"),
+  analytics_create_activation_destination: analyticsRecordOutput("destination"),
+  analytics_create_connection: {
+    ok: z11.boolean(),
+    connection: AnalyticsSafeOutputRecord,
+    webhookUrl: z11.string().url().max(3e3)
+  },
+  analytics_create_conversion_rule: analyticsRecordOutput("rule"),
+  analytics_create_event_definition: analyticsRecordOutput("definition"),
+  analytics_record_external_event: {
+    ok: z11.boolean(),
+    id: z11.string().uuid().nullable(),
+    created: z11.boolean(),
+    personId: z11.string().uuid().nullable(),
+    identityTier: z11.enum(["confirmed", "unlinked"]),
+    namespaceId: z11.string().uuid().nullable(),
+    conversionIds: z11.array(z11.string().uuid()).max(500),
+    consentEligibility: AnalyticsSafeOutputRecord,
+    valueProvenance: z11.record(z11.string(), AnalyticsSafeOutputRecord),
+    scoreEvaluationIds: z11.array(z11.string().min(1).max(240)).max(500),
+    predictionEvidence: z11.unknown(),
+    candidatePromotion: AnalyticsSafeOutputRecord.nullable()
+  },
+  analytics_import_crm_csv: analyticsRecordOutput("import"),
+  analytics_update_event_definition: analyticsRecordOutput("definition"),
+  analytics_archive_event_definition: analyticsRecordOutput("definition"),
+  analytics_test_event_definition: analyticsRecordOutput("test"),
+  analytics_test_activation_destination: analyticsRecordOutput("test"),
+  analytics_list_activation_receipts: analyticsRecordsOutput("receipts"),
+  analytics_retry_activation_delivery: analyticsRecordOutput("job"),
+  analytics_reconcile_connection: analyticsRecordOutput("reconciliation")
+};
 var AnalyticsJourneyRevenueSchema = z11.object({
   valueMinor: z11.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
   currency: z11.string().length(3).nullable()
@@ -13063,7 +13316,15 @@ var productionOutputSchemas = {
   analytics_export_privacy_subject: AnalyticsPrivacyExportOutputSchema,
   analytics_delete_privacy_subject: AnalyticsPrivacyDeleteOutputSchema,
   analytics_discover_activation_assets: AnalyticsActivationAssetsOutputSchema,
-  analytics_validate_activation_mapping: AnalyticsActivationMappingOutputSchema
+  analytics_validate_activation_mapping: AnalyticsActivationMappingOutputSchema,
+  analytics_preview_crm_import: AnalyticsManualImportPreviewOutputSchema,
+  analytics_commit_crm_import: AnalyticsManualImportCommitOutputSchema,
+  analytics_export_crm_csv: AnalyticsManualExportOutputSchema,
+  analytics_export_google_ads_csv: AnalyticsManualExportOutputSchema,
+  analytics_export_meta_technical: AnalyticsManualExportOutputSchema,
+  analytics_save_activation_mapping: AnalyticsActivationDestinationOutputSchema,
+  analytics_set_activation_automation: AnalyticsActivationDestinationOutputSchema,
+  analytics_verify_live_event_definition: AnalyticsLiveEventVerificationOutputSchema
 };
 var ANALYTICS_MCP_RESULT_MAX_BYTES = 65536;
 var ANALYTICS_RESTRICTED_RESULT_KEY = /^(?:email|emailAddress|phone|phoneNumber|contact|contactInfo|rawIp|ipAddress|deviceId|userAgent|gclid|fbclid|ttclid|msclkid|accessToken|refreshToken|authorization|cookie|password|secret)$/i;
@@ -13073,18 +13334,31 @@ function redactAnalyticsResult(value, depth = 0) {
   if (!value || typeof value !== "object") return value;
   return Object.fromEntries(Object.entries(value).map(([key, item]) => [
     key,
-    ANALYTICS_RESTRICTED_RESULT_KEY.test(key) ? "[redacted]" : redactAnalyticsResult(item, depth + 1)
+    ANALYTICS_RESTRICTED_RESULT_KEY.test(key.replace(/[-_\s]/g, "")) ? "[redacted]" : redactAnalyticsResult(item, depth + 1)
   ]));
 }
 function safeAnalyticsResult(result) {
   const textPart = result.content.find((part) => part.type === "text");
-  if (!textPart || textPart.type !== "text") return result;
-  let parsed;
-  try {
-    parsed = JSON.parse(textPart.text);
-  } catch {
-    if (new TextEncoder().encode(textPart.text).byteLength <= ANALYTICS_MCP_RESULT_MAX_BYTES) return result;
-    parsed = null;
+  let parsed = result.structuredContent;
+  if (parsed === void 0 && textPart?.type === "text") {
+    try {
+      parsed = JSON.parse(textPart.text);
+    } catch {
+      const bounded = {
+        ok: false,
+        error: "analytics_result_invalid",
+        message: "The analytics service returned a non-JSON result. Retry once; if it persists, inspect X-Ray health."
+      };
+      return { content: [{ type: "text", text: JSON.stringify(bounded) }], structuredContent: bounded, isError: true };
+    }
+  }
+  if (parsed === void 0) {
+    const bounded = {
+      ok: false,
+      error: "analytics_result_invalid",
+      message: "The analytics service returned no structured result. Retry once; if it persists, inspect X-Ray health."
+    };
+    return { content: [{ type: "text", text: JSON.stringify(bounded) }], structuredContent: bounded, isError: true };
   }
   const sanitized = redactAnalyticsResult(parsed);
   const serialized = JSON.stringify(sanitized);
@@ -13101,25 +13375,25 @@ function safeAnalyticsResult(result) {
   }
   return {
     ...result,
-    content: result.content.map((part) => part === textPart ? { type: "text", text: serialized } : part),
+    content: textPart ? result.content.map((part) => part === textPart ? { type: "text", text: serialized } : part) : [{ type: "text", text: serialized }, ...result.content],
     structuredContent: sanitized
   };
 }
 function registerAnalyticsMcpTools(server, executor) {
   server.registerTool("analytics_get_entitlement", {
     title: "Get X-Ray Pixel Access",
-    description: "Check whether Thorbit X-Ray Pixel is connected and entitled for this MCP Scraper account. X-Ray Pixel is owned and billed by Thorbit, requires an active $50+ Thorbit subscription after its 30-day trial, and does not consume MCP Scraper Credits. Call this before analytics_list_sites when access may not be configured. Account linking must be completed in the MCP Scraper dashboard; never ask a user to paste a Thorbit API key into an AI conversation.",
+    description: "Check X-Ray access before analytics_list_sites. X-Ray is billed by Thorbit and uses no MCP Scraper Credits. Link only in the dashboard; never request its API key.",
     inputSchema: AnalyticsGetEntitlementInputSchema,
     outputSchema: recordOutputSchema("analytics_get_entitlement", AnalyticsGetEntitlementOutputSchema),
     annotations: readAnnotations("Get X-Ray Pixel Access")
-  }, async (input) => executor.analyticsGetEntitlement(input));
+  }, async (input) => safeAnalyticsResult(await executor.analyticsGetEntitlement(input)));
   server.registerTool("analytics_list_sites", {
     title: "List Analytics Businesses",
-    description: "List the authenticated account's analytics Businesses, roles, Pixel counts, and latest activity. Call this first to obtain the siteId used by every analytics report tool. Tenant access is enforced by the analytics API.",
+    description: "List authorized analytics Businesses, roles, Pixel counts, and activity. Call first to obtain the siteId required by analytics tools.",
     inputSchema: AnalyticsListSitesInputSchema,
     outputSchema: recordOutputSchema("analytics_list_sites", AnalyticsListSitesOutputSchema),
     annotations: readAnnotations("List Analytics Businesses")
-  }, async (input) => executor.analyticsListSites(input));
+  }, async (input) => safeAnalyticsResult(await executor.analyticsListSites(input)));
   const reports = [
     ["analytics_get_overview", "Analytics Overview", "overview", "analyticsGetOverview"],
     ["analytics_get_acquisition", "Analytics Acquisition", "acquisition", "analyticsGetAcquisition"],
@@ -13131,54 +13405,54 @@ function registerAnalyticsMcpTools(server, executor) {
   for (const [name, title, report, handler] of reports) {
     server.registerTool(name, {
       title,
-      description: `Read the ${report} report for one analytics Business. Use analytics_list_sites first. Filters use the same normalized Site, Pixel, hostname, date, source, medium, campaign, and event contract as the dashboard, REST API, and exports.`,
+      description: `Read the ${report} report. Get siteId with analytics_list_sites; filters match dashboard, REST, and exports.`,
       inputSchema: AnalyticsReportInputSchema,
       outputSchema: recordOutputSchema(name, AnalyticsReportOutputSchema),
       annotations: readAnnotations(title)
-    }, async (input) => executor[handler](input));
+    }, async (input) => safeAnalyticsResult(await executor[handler](input)));
   }
   const reads = [
-    ["analytics_get_timeseries", "Analytics Timeseries", "Read daily time-series rows for an AI-selected line, area, or comparative visualization.", AnalyticsReportInputSchema, "analyticsGetTimeseries"],
-    ["analytics_get_events", "Analytics Events", "Read paginated event counts. Follow pageInfo cursors instead of requesting an unbounded result.", AnalyticsPaginatedReportInputSchema, "analyticsGetEvents"],
-    ["analytics_get_dimensions", "Analytics Dimensions", "Read visualization-ready device, source, country, region, or weekday-hour rows. Chart recommendations are advisory.", AnalyticsDimensionInputSchema, "analyticsGetDimensions"],
-    ["analytics_get_business_metrics", "Analytics Business Metrics", "Read the configured lead-generation, SaaS, or e-commerce metric pack with explicit missing-input signals.", AnalyticsReportInputSchema, "analyticsGetBusinessMetrics"],
-    ["analytics_get_forecast", "Analytics Forecast", "Read historical monthly revenue and spend plus bounded forward scenarios and ROAS when enough evidence exists.", AnalyticsSiteResourceInputSchema, "analyticsGetForecast"],
-    ["analytics_list_pixels", "List Analytics Pixels", "List Site Pixels, installation snippets, detected domains, approval states, and health.", AnalyticsSiteResourceInputSchema, "analyticsListPixels"],
-    ["analytics_list_campaign_links", "List Campaign Links", "List paginated tracked links and canonical UTM and ad hierarchy fields.", AnalyticsSiteResourceInputSchema, "analyticsListCampaignLinks"],
-    ["analytics_list_forms", "List Analytics Forms", "List paginated Pixel-linked forms, embed snippets, fields, versions, and submission counts.", AnalyticsSiteResourceInputSchema, "analyticsListForms"],
-    ["analytics_list_crm_imports", "List CRM Imports", "List paginated encrypted CSV import receipts without exposing contact PII in analytics.", AnalyticsSiteResourceInputSchema, "analyticsListCrmImports"],
-    ["analytics_list_activation_destinations", "List Ad Activation Destinations", "List Meta, Google, TikTok, and Reddit destinations with pending, delivered, and failed conversion counts.", AnalyticsSiteResourceInputSchema, "analyticsListActivationDestinations"],
-    ["analytics_list_connections", "List X-Ray Connections", "List phone, CRM, and webhook connections with honest readiness, receipt, and error state.", AnalyticsSiteResourceInputSchema, "analyticsListConnections"],
-    ["analytics_list_conversion_rules", "List Conversion Rules", "List deterministic versioned rules that turn canonical phone, CRM, transaction, and server events into conversions.", AnalyticsSiteResourceInputSchema, "analyticsListConversionRules"],
-    ["analytics_list_event_definitions", "List Browser Event Definitions", "List declarative page, click, and form-submit tags applied by the first-party X-Ray Pixel.", AnalyticsSiteResourceInputSchema, "analyticsListEventDefinitions"],
-    ["analytics_get_coverage", "Get Attribution Coverage", "Measure click-ID coverage and call/CRM journey join rates. Null rates mean there is not yet a denominator.", AnalyticsSiteResourceInputSchema, "analyticsGetCoverage"],
-    ["analytics_get_person_journey", "Get Person Journey", "Read CRM-oriented identified-person history: touches, calls, CRM stages, conversions, and delivery receipts. For analytics chronology use analytics_get_visitor_journey.", AnalyticsJourneyInputSchema, "analyticsGetPersonJourney"]
+    ["analytics_get_timeseries", "Analytics Timeseries", "Read bounded daily rows for line, area, or comparison charts.", AnalyticsReportInputSchema, "analyticsGetTimeseries"],
+    ["analytics_get_events", "Analytics Events", "Read paginated event counts; follow pageInfo cursors.", AnalyticsPaginatedReportInputSchema, "analyticsGetEvents"],
+    ["analytics_get_dimensions", "Analytics Dimensions", "Read chart-ready device, source, country, region, or weekday-hour rows.", AnalyticsDimensionInputSchema, "analyticsGetDimensions"],
+    ["analytics_get_business_metrics", "Analytics Business Metrics", "Read the configured business metric pack with explicit missing inputs.", AnalyticsReportInputSchema, "analyticsGetBusinessMetrics"],
+    ["analytics_get_forecast", "Analytics Forecast", "Read historical revenue and spend plus evidence-bounded scenarios.", AnalyticsSiteResourceInputSchema, "analyticsGetForecast"],
+    ["analytics_list_pixels", "List Analytics Pixels", "List Pixels, install snippets, approved domains, and health.", AnalyticsSiteResourceInputSchema, "analyticsListPixels"],
+    ["analytics_list_campaign_links", "List Campaign Links", "List paginated tracked links with UTM and ad hierarchy fields.", AnalyticsSiteResourceInputSchema, "analyticsListCampaignLinks"],
+    ["analytics_list_forms", "List Analytics Forms", "List paginated Pixel-linked forms, embeds, versions, and submission counts.", AnalyticsSiteResourceInputSchema, "analyticsListForms"],
+    ["analytics_list_crm_imports", "List CRM Imports", "List encrypted CSV import receipts without contact PII.", AnalyticsSiteResourceInputSchema, "analyticsListCrmImports"],
+    ["analytics_list_activation_destinations", "List Ad Activation Destinations", "List ad destinations with delivery counts and readiness.", AnalyticsSiteResourceInputSchema, "analyticsListActivationDestinations"],
+    ["analytics_list_connections", "List X-Ray Connections", "List phone, CRM, and webhook connections with readiness and errors.", AnalyticsSiteResourceInputSchema, "analyticsListConnections"],
+    ["analytics_list_conversion_rules", "List Conversion Rules", "List versioned rules that turn canonical events into conversions.", AnalyticsSiteResourceInputSchema, "analyticsListConversionRules"],
+    ["analytics_list_event_definitions", "List Browser Event Definitions", "List declarative page, click, and form-submit Pixel tags.", AnalyticsSiteResourceInputSchema, "analyticsListEventDefinitions"],
+    ["analytics_get_coverage", "Get Attribution Coverage", "Measure click-ID coverage and call/CRM joins; null means no denominator.", AnalyticsSiteResourceInputSchema, "analyticsGetCoverage"],
+    ["analytics_get_person_journey", "Get Person Journey", "Read CRM-oriented identified-person history: touches, calls, stages, conversions, and receipts. For chronology use analytics_get_visitor_journey.", AnalyticsJourneyInputSchema, "analyticsGetPersonJourney"]
   ];
   for (const [name, title, description, inputSchema, handler] of reads) {
     server.registerTool(name, {
       title,
       description,
       inputSchema,
-      outputSchema: recordOutputSchema(name, name.startsWith("analytics_get_") ? AnalyticsReportOutputSchema : AnalyticsGenericOutputSchema),
+      outputSchema: recordOutputSchema(name, AnalyticsLegacyOperationOutputSchemas[name]),
       annotations: readAnnotations(title)
-    }, async (input) => executor[handler](input));
+    }, async (input) => safeAnalyticsResult(await executor[handler](input)));
   }
   const writes = [
     ["analytics_create_campaign_link", "Create Campaign Link", "Create one tracked campaign URL with canonical UTMs and optional ad-group, ad, and creative identifiers.", AnalyticsCreateCampaignLinkInputSchema, "analyticsCreateCampaignLink", false],
     ["analytics_create_form", "Create Pixel-linked Form", "Create and optionally publish a branded form that inherits the parent Pixel identity and session.", AnalyticsCreateFormInputSchema, "analyticsCreateForm", false],
     ["analytics_create_activation_destination", "Create Ad Activation Destination", "Create a Meta, Google, TikTok, or Reddit conversion destination using an existing provider connection reference.", AnalyticsCreateActivationInputSchema, "analyticsCreateActivation", false],
-    ["analytics_create_connection", "Create X-Ray Connection", "Create a CallRail, CallTrackingMetrics, Twilio, HubSpot, HighLevel, or generic CRM connection. Creation is configured-unverified until a signed receipt succeeds.", AnalyticsCreateConnectionInputSchema, "analyticsCreateConnection", false],
+    ["analytics_create_connection", "Create X-Ray Connection", "Create a phone or CRM connection. It remains configured-unverified until a signed receipt succeeds.", AnalyticsCreateConnectionInputSchema, "analyticsCreateConnection", false],
     ["analytics_create_conversion_rule", "Create Conversion Rule", "Create a versioned declarative conversion rule. This is a safe event-routing layer, not arbitrary JavaScript like Google Tag Manager.", AnalyticsCreateRuleInputSchema, "analyticsCreateConversionRule", false],
     ["analytics_create_event_definition", "Create Browser Event Definition", "Create a declarative page, click, or third-party form-submit event tag without injecting arbitrary JavaScript or capturing form fields.", AnalyticsCreateEventDefinitionInputSchema, "analyticsCreateEventDefinition", false],
     ["analytics_record_external_event", "Record Server Event", "Idempotently record a canonical server-side call, CRM, transaction, or custom event and evaluate conversion rules.", AnalyticsRecordExternalEventInputSchema, "analyticsRecordExternalEvent", true],
-    ["analytics_import_crm_csv", "Import CRM CSV", "Map and stage a bounded CRM CSV import. Contact fields are encrypted and analytics retains only opaque person references and identity signals.", AnalyticsCrmImportInputSchema, "analyticsImportCrmCsv", false]
+    ["analytics_import_crm_csv", "Legacy CRM CSV Import", "Legacy direct CRM CSV import; prefer preview then commit.", AnalyticsCrmImportInputSchema, "analyticsImportCrmCsv", false]
   ];
   for (const [name, title, description, inputSchema, handler, idempotent] of writes) {
     server.registerTool(name, {
       title,
       description,
       inputSchema,
-      outputSchema: recordOutputSchema(name, AnalyticsGenericOutputSchema),
+      outputSchema: recordOutputSchema(name, AnalyticsLegacyOperationOutputSchemas[name]),
       annotations: {
         title,
         readOnlyHint: false,
@@ -13186,12 +13460,12 @@ function registerAnalyticsMcpTools(server, executor) {
         idempotentHint: idempotent,
         openWorldHint: false
       }
-    }, async (input) => executor[handler](input));
+    }, async (input) => safeAnalyticsResult(await executor[handler](input)));
   }
   const operations = [
     ["analytics_update_event_definition", "Update Browser Event Definition", "Update a versioned declarative browser event definition. Null path, selector, or metadata clears that optional field.", AnalyticsUpdateEventDefinitionInputSchema, "analyticsUpdateEventDefinition", false, false, false, false],
     ["analytics_archive_event_definition", "Archive Browser Event Definition", "Idempotently archive a browser event definition so the Pixel no longer receives it.", AnalyticsArchiveEventDefinitionInputSchema, "analyticsArchiveEventDefinition", false, true, true, false],
-    ["analytics_test_event_definition", "Test Browser Event Definition", "Preview a definition against validated hostname, path, trigger, tag, and browser-reported selector-match facts. This never accepts HTML or executes selectors server-side.", AnalyticsTestEventDefinitionInputSchema, "analyticsTestEventDefinition", true, true, false, false],
+    ["analytics_test_event_definition", "Preview Browser Event Definition", "Preview supplied browser match facts. This is not live event verification: it does not open a site, run selectors, or prove Pixel delivery.", AnalyticsTestEventDefinitionInputSchema, "analyticsTestEventDefinition", true, true, false, false],
     ["analytics_test_activation_destination", "Test Ad Activation Destination", "Send the provider-specific verification test for a configured activation destination and return its safe receipt. Meta and TikTok require testEventCode; Reddit requires testId.", AnalyticsTestActivationDestinationInputSchema, "analyticsTestActivationDestination", false, false, false, true],
     ["analytics_list_activation_receipts", "List Ad Activation Receipts", "List bounded provider delivery receipts for one activation destination.", AnalyticsListActivationReceiptsInputSchema, "analyticsListActivationReceipts", true, true, false, false],
     ["analytics_retry_activation_delivery", "Retry Ad Activation Delivery", "Requeue one failed or dead-lettered activation job. This may cause an external provider delivery.", AnalyticsRetryActivationDeliveryInputSchema, "analyticsRetryActivationDelivery", false, false, false, true],
@@ -13202,7 +13476,7 @@ function registerAnalyticsMcpTools(server, executor) {
       title,
       description,
       inputSchema,
-      outputSchema: recordOutputSchema(name, AnalyticsGenericOutputSchema),
+      outputSchema: recordOutputSchema(name, AnalyticsLegacyOperationOutputSchemas[name]),
       annotations: {
         title,
         readOnlyHint: readOnly,
@@ -13210,7 +13484,7 @@ function registerAnalyticsMcpTools(server, executor) {
         idempotentHint: idempotent,
         openWorldHint: openWorld
       }
-    }, async (input) => executor[handler](input));
+    }, async (input) => safeAnalyticsResult(await executor[handler](input)));
   }
   server.registerTool("analytics_get_health", {
     title: "Analytics Pixel Health",
@@ -13218,7 +13492,7 @@ function registerAnalyticsMcpTools(server, executor) {
     inputSchema: AnalyticsReportInputSchema,
     outputSchema: recordOutputSchema("analytics_get_health", AnalyticsHealthOutputSchema),
     annotations: readAnnotations("Analytics Pixel Health")
-  }, async (input) => executor.analyticsGetHealth(input));
+  }, async (input) => safeAnalyticsResult(await executor.analyticsGetHealth(input)));
   server.registerTool("analytics_create_export", {
     title: "Create Analytics Export",
     description: "Create a persisted, versioned CSV, JSON, or Markdown analytics artifact. Supply a caller-owned idempotencyKey and reuse it only when retrying the same logical export.",
@@ -13231,7 +13505,7 @@ function registerAnalyticsMcpTools(server, executor) {
       idempotentHint: true,
       openWorldHint: false
     }
-  }, async (input) => executor.analyticsCreateExport(input));
+  }, async (input) => safeAnalyticsResult(await executor.analyticsCreateExport(input)));
   const productionReads = [
     ["analytics_get_onboarding_state", "Get X-Ray Setup State", "Read evidence-derived setup milestones. Client input cannot mark evidence milestones complete.", AnalyticsSiteResourceInputSchema, "analyticsGetOnboardingState"],
     ["analytics_list_sessions", "List X-Ray Sessions", "Read bounded sessions using opaque references. Raw visitor/session/device identifiers, contact data, IP, and click IDs are omitted.", AnalyticsExplorerInputSchema, "analyticsListSessions"],
@@ -13254,7 +13528,8 @@ function registerAnalyticsMcpTools(server, executor) {
     ["analytics_list_lead_scores", "List Lead Scores", "List transparent versioned fit, engagement, and combined scores. Scores are neither probabilities nor currency values.", AnalyticsNamespaceResourceInputSchema, "analyticsListLeadScores"],
     ["analytics_list_prediction_targets", "List Prediction Targets", "List namespace-local outcome targets and horizons without claiming a model is eligible.", AnalyticsNamespaceResourceInputSchema, "analyticsListPredictionTargets"],
     ["analytics_get_prediction_eligibility", "Get Prediction Eligibility", "Read evidence gates, model state, target horizon, calibration, and safe unavailable reasons. No probability is synthesized from a lead score.", AnalyticsPredictionEligibilityInputSchema, "analyticsGetPredictionEligibility"],
-    ["analytics_discover_activation_assets", "Discover Ad Destination Assets", "Read bounded authorized provider datasets/conversion actions through an existing connection. Credentials and unrestricted provider bodies are omitted.", AnalyticsActivationAssetsInputSchema, "analyticsDiscoverActivationAssets"]
+    ["analytics_discover_activation_assets", "Discover Ad Destination Assets", "Read bounded authorized provider datasets/conversion actions through an existing connection. Credentials and unrestricted provider bodies are omitted.", AnalyticsActivationAssetsInputSchema, "analyticsDiscoverActivationAssets"],
+    ["analytics_verify_live_event_definition", "Verify Live Browser Event", "Wait briefly for a persisted event matching this definition; returns observed or not observed.", AnalyticsVerifyLiveEventDefinitionInputSchema, "analyticsVerifyLiveEventDefinition"]
   ];
   for (const [name, title, description, inputSchema, handler] of productionReads) {
     const outputSchema = productionOutputSchemas[name];
@@ -13277,21 +13552,28 @@ function registerAnalyticsMcpTools(server, executor) {
     ["analytics_delete_saved_view", "Delete Saved Analytics View", "Delete one account-scoped saved report view.", AnalyticsSavedViewResourceInputSchema, "analyticsDeleteSavedView", true, true, false],
     ["analytics_withdraw_consent", "Withdraw Analytics Consent", "Record a purpose-scoped withdrawal for an opaque subject. Necessary processing cannot be withdrawn here, and MCP can never grant visitor consent.", AnalyticsConsentWithdrawalInputSchema, "analyticsWithdrawConsent", true, true, false],
     ["analytics_plan_crm_provisioning", "Plan CRM Provisioning", "Preview existing mappings and missing namespaced fields. This read-like plan does not mutate provider schema.", AnalyticsCrmPlanInputSchema, "analyticsPlanCrmProvisioning", true, false, true],
-    ["analytics_approve_crm_provisioning", "Approve CRM Provisioning", "Create the exact approved namespaced fields in the connected CRM. Provider field creation may be irreversible and cleanup is manual; inspect analytics_plan_crm_provisioning before approving.", AnalyticsCrmApprovalInputSchema, "analyticsApproveCrmProvisioning", true, true, true],
+    ["analytics_approve_crm_provisioning", "Approve CRM Provisioning", "Create the planned CRM fields. Creation may be irreversible; inspect analytics_plan_crm_provisioning first.", AnalyticsCrmApprovalInputSchema, "analyticsApproveCrmProvisioning", true, true, true],
     ["analytics_test_crm_provisioning", "Test CRM Provisioning", "Perform the authorized reversible test write/readback/cleanup and return a redacted receipt.", AnalyticsCrmPlanResourceInputSchema, "analyticsTestCrmProvisioning", true, false, true],
-    ["analytics_start_crm_sync", "Start Inbound CRM Synchronization", "Pull inbound CRM objects and stages into X-Ray through a capability-gated idempotent synchronization. This does not push X-Ray people or deals to the CRM; candidate identities and evidence are excluded.", AnalyticsCrmSyncInputSchema, "analyticsStartCrmSync", true, false, true],
+    ["analytics_start_crm_sync", "Start Inbound CRM Synchronization", "Pull supported CRM objects into X-Ray. This does not push people or deals; candidate evidence is excluded.", AnalyticsCrmSyncInputSchema, "analyticsStartCrmSync", true, false, true],
     ["analytics_update_crm_sync_schedule", "Update CRM Sync Schedule", "Enable or disable a bounded CRM synchronization schedule.", AnalyticsCrmScheduleInputSchema, "analyticsUpdateCrmSyncSchedule", true, false, true],
     ["analytics_discover_crm_sync_objects", "Discover CRM Sync Objects", "Discover bounded provider objects for an explicit mapping. Credentials and unrestricted records are omitted.", AnalyticsCrmSyncDiscoverInputSchema, "analyticsDiscoverCrmSyncObjects", true, false, true],
     ["analytics_test_crm_sync_mapping", "Test CRM Sync Mapping", "Validate a typed CRM mapping without starting synchronization.", AnalyticsCrmMappingTestInputSchema, "analyticsTestCrmSyncMapping", true, false, false],
-    ["analytics_sync_crm_person", "Push Confirmed Person to CRM", "Push one confirmed-person projection from X-Ray to the connected CRM after provisioning approval. This is not the inbound analytics_start_crm_sync lane; candidate identity or evidence is schema-invalid.", AnalyticsCrmPersonSyncInputSchema, "analyticsSyncCrmPerson", true, false, true],
+    ["analytics_sync_crm_person", "Push Confirmed Person to CRM", "Push one confirmed person after CRM provisioning. This is not inbound sync; candidate evidence is invalid.", AnalyticsCrmPersonSyncInputSchema, "analyticsSyncCrmPerson", true, false, true],
     ["analytics_apply_crm_pipeline_mapping", "Push CRM Pipeline Event", "Push an explicit versioned pipeline event for a confirmed person from X-Ray to the connected CRM. This is the only MCP lane that may create or update a deal/opportunity.", AnalyticsPipelineApplyInputSchema, "analyticsApplyCrmPipelineMapping", true, false, true],
     ["analytics_cancel_crm_sync", "Cancel CRM Synchronization", "Cancel one synchronization and disable its active work.", AnalyticsCrmSyncStatusInputSchema, "analyticsCancelCrmSync", true, true, true],
-    ["analytics_upsert_crm_outbound_policy", "Configure CRM Outbound Policy", "Create or update one immutable-version CRM outbound policy. Policies are disabled unless explicitly enabled, cannot grant visitor consent, and reject candidate identity, raw IP/device signals, and unrestricted journey data.", AnalyticsCrmOutboundPolicyInputSchema, "analyticsUpsertCrmOutboundPolicy", true, false, false],
+    ["analytics_upsert_crm_outbound_policy", "Configure CRM Outbound Policy", "Version a CRM outbound policy. It cannot grant consent or send candidate identity, raw IP/device signals, or full journeys.", AnalyticsCrmOutboundPolicyInputSchema, "analyticsUpsertCrmOutboundPolicy", true, false, false],
     ["analytics_create_lead_score", "Create Lead Score", "Create a bounded declarative score. Arbitrary code, raw HTML, candidate CRM projection, dollars, and probability labels are forbidden.", AnalyticsCreateLeadScoreInputSchema, "analyticsCreateLeadScore", true, false, false],
     ["analytics_create_prediction_target", "Create Prediction Target", "Register a namespace-local confirmed outcome and horizon. This begins evidence collection and does not claim model eligibility.", AnalyticsPredictionTargetInputSchema, "analyticsCreatePredictionTarget", true, false, false],
     ["analytics_export_privacy_subject", "Export Privacy Subject", "Create a governed export for one opaque Site-scoped subject without accepting email or phone lookup.", AnalyticsPrivacyExportInputSchema, "analyticsExportPrivacySubject", true, false, false],
     ["analytics_delete_privacy_subject", "Delete Privacy Subject", "Irreversibly delete one opaque subject and related deterministic/candidate/model data according to lifecycle policy.", AnalyticsPrivacySubjectInputSchema, "analyticsDeletePrivacySubject", true, true, false],
-    ["analytics_validate_activation_mapping", "Validate Activation Event Mapping", "Validate explicit confirmed-event mappings against an authorized destination. Candidate-assisted events are rejected; this does not enable delivery.", AnalyticsActivationMappingInputSchema, "analyticsValidateActivationMapping", true, false, false]
+    ["analytics_validate_activation_mapping", "Validate Activation Event Mapping", "Validate confirmed-event mappings. This cannot save mappings or enable delivery.", AnalyticsActivationMappingInputSchema, "analyticsValidateActivationMapping", true, false, false],
+    ["analytics_preview_crm_import", "Preview CRM CSV Import", "Validate mappings and return bounded row/error counts without importing.", AnalyticsPreviewCrmImportInputSchema, "analyticsPreviewCrmImport", true, false, false],
+    ["analytics_commit_crm_import", "Commit CRM CSV Import", "Commit the exact preview fingerprint with a caller retry key.", AnalyticsCommitCrmImportInputSchema, "analyticsCommitCrmImport", true, false, false],
+    ["analytics_export_crm_csv", "Export CRM CSV", "Create a governed CRM CSV; advertising fields require purpose acknowledgement.", AnalyticsCrmManualExportInputSchema, "analyticsExportCrmCsv", true, false, false],
+    ["analytics_export_google_ads_csv", "Export Google Ads CSV", "Create a consent-gated native offline-conversion upload CSV.", AnalyticsAdManualExportInputSchema, "analyticsExportGoogleAdsCsv", true, false, false],
+    ["analytics_export_meta_technical", "Export Meta Technical JSONL", "Create a consent-gated technical JSONL relay artifact; Meta does not accept it as a native upload.", AnalyticsAdManualExportInputSchema, "analyticsExportMetaTechnical", true, false, false],
+    ["analytics_save_activation_mapping", "Save Activation Event Mapping", "Save a typed confirmed-event mapping on an existing destination without enabling delivery.", AnalyticsSaveActivationMappingInputSchema, "analyticsSaveActivationMapping", true, false, false],
+    ["analytics_set_activation_automation", "Set Activation Automation", "Explicitly enable or disable automatic delivery; enablement requires verified readiness.", AnalyticsSetActivationAutomationInputSchema, "analyticsSetActivationAutomation", true, false, false]
   ];
   for (const [name, title, description, inputSchema, handler, idempotent, destructive, openWorld] of productionWrites) {
     const outputSchema = productionOutputSchemas[name];
@@ -13302,7 +13584,7 @@ function registerAnalyticsMcpTools(server, executor) {
       outputSchema: recordOutputSchema(name, outputSchema),
       annotations: {
         title,
-        readOnlyHint: name === "analytics_plan_crm_provisioning" || name === "analytics_test_funnel" || name === "analytics_discover_crm_sync_objects" || name === "analytics_test_crm_sync_mapping" || name === "analytics_validate_activation_mapping",
+        readOnlyHint: name === "analytics_plan_crm_provisioning" || name === "analytics_test_funnel" || name === "analytics_discover_crm_sync_objects" || name === "analytics_test_crm_sync_mapping" || name === "analytics_validate_activation_mapping" || name === "analytics_preview_crm_import" || name === "analytics_export_crm_csv" || name === "analytics_export_google_ads_csv" || name === "analytics_export_meta_technical",
         destructiveHint: destructive,
         idempotentHint: idempotent,
         openWorldHint: openWorld
@@ -14527,8 +14809,9 @@ function analyticsReportPath(input, report) {
 function analyticsSitePath(siteId, suffix) {
   return `/analytics/sites/${encodeURIComponent(siteId)}/${suffix}`;
 }
-function analyticsIdempotencyHeaders(scope, key) {
-  return { "Idempotency-Key": `${scope}-${createHash4("sha256").update(key).digest("hex")}` };
+function analyticsIdempotencyHeaders(scope, key, deterministicFallback) {
+  const resolved = key ?? JSON.stringify(deterministicFallback ?? { scope });
+  return { "Idempotency-Key": `${scope}-${createHash4("sha256").update(resolved).digest("hex")}` };
 }
 var HttpMcpToolExecutor = class {
   baseUrl;
@@ -15093,43 +15376,43 @@ var HttpMcpToolExecutor = class {
     return this.getJson(`/analytics/sites/${encodeURIComponent(input.siteId)}/people/${encodeURIComponent(input.personId)}/journey`);
   }
   analyticsCreateCampaignLink(input) {
-    const { siteId, ...body } = input;
-    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/campaign-links`, body, this.timeoutMs, "POST");
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/campaign-links`, body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-campaign-link", idempotencyKey));
   }
   analyticsCreateForm(input) {
-    const { siteId, ...body } = input;
-    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/forms`, body, this.timeoutMs, "POST");
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/forms`, body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-form", idempotencyKey));
   }
   analyticsCreateActivation(input) {
-    const { siteId, ...body } = input;
-    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/activation-destinations`, body, this.timeoutMs, "POST");
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/activation-destinations`, body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-activation-destination", idempotencyKey));
   }
   analyticsCreateConnection(input) {
-    const { siteId, ...body } = input;
-    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/connections`, body, this.timeoutMs, "POST");
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/connections`, body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-connection", idempotencyKey));
   }
   analyticsCreateConversionRule(input) {
-    const { siteId, ...body } = input;
-    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/conversion-rules`, body, this.timeoutMs, "POST");
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/conversion-rules`, body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-conversion-rule", idempotencyKey));
   }
   analyticsCreateEventDefinition(input) {
-    const { siteId, ...body } = input;
-    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/event-definitions`, body, this.timeoutMs, "POST");
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/event-definitions`, body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-event-definition", idempotencyKey));
   }
   analyticsUpdateEventDefinition(input) {
-    const { siteId, definitionId, ...body } = input;
-    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/event-definitions/${encodeURIComponent(definitionId)}`, body, this.timeoutMs, "PATCH");
+    const { siteId, definitionId, idempotencyKey, ...body } = input;
+    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/event-definitions/${encodeURIComponent(definitionId)}`, body, this.timeoutMs, "PATCH", analyticsIdempotencyHeaders("analytics-event-definition-update", idempotencyKey));
   }
   analyticsArchiveEventDefinition(input) {
-    return this.call(`/analytics/sites/${encodeURIComponent(input.siteId)}/event-definitions/${encodeURIComponent(input.definitionId)}`, {}, this.timeoutMs, "DELETE");
+    return this.call(`/analytics/sites/${encodeURIComponent(input.siteId)}/event-definitions/${encodeURIComponent(input.definitionId)}`, {}, this.timeoutMs, "DELETE", analyticsIdempotencyHeaders("analytics-event-definition-archive", input.idempotencyKey));
   }
   analyticsTestEventDefinition(input) {
     const { siteId, definitionId, ...body } = input;
     return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/event-definitions/${encodeURIComponent(definitionId)}/test`, body, this.timeoutMs, "POST");
   }
   analyticsTestActivationDestination(input) {
-    const { siteId, destinationId, ...body } = input;
-    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/activation-destinations/${encodeURIComponent(destinationId)}/test`, body, this.timeoutMs, "POST");
+    const { siteId, destinationId, idempotencyKey, ...body } = input;
+    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/activation-destinations/${encodeURIComponent(destinationId)}/test`, body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-activation-test", idempotencyKey, { siteId, destinationId, body }));
   }
   analyticsListActivationReceipts(input) {
     const query = new URLSearchParams({ limit: String(input.limit) });
@@ -15137,18 +15420,18 @@ var HttpMcpToolExecutor = class {
     return this.getJson(`/analytics/sites/${encodeURIComponent(input.siteId)}/activation-destinations/${encodeURIComponent(input.destinationId)}/receipts?${query}`);
   }
   analyticsRetryActivationDelivery(input) {
-    return this.call(`/analytics/sites/${encodeURIComponent(input.siteId)}/activation-jobs/${encodeURIComponent(input.jobId)}/retry`, {}, this.timeoutMs, "POST");
+    return this.call(`/analytics/sites/${encodeURIComponent(input.siteId)}/activation-jobs/${encodeURIComponent(input.jobId)}/retry`, {}, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-activation-retry", input.idempotencyKey));
   }
   analyticsReconcileConnection(input) {
-    return this.call(`/analytics/sites/${encodeURIComponent(input.siteId)}/connections/${encodeURIComponent(input.connectionId)}/reconcile`, {}, this.timeoutMs, "POST");
+    return this.call(`/analytics/sites/${encodeURIComponent(input.siteId)}/connections/${encodeURIComponent(input.connectionId)}/reconcile`, {}, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-connection-reconcile", input.idempotencyKey));
   }
   analyticsRecordExternalEvent(input) {
-    const { siteId, ...body } = input;
-    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/external-events`, body, this.timeoutMs, "POST");
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/external-events`, body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-external-event", idempotencyKey));
   }
   analyticsImportCrmCsv(input) {
-    const { siteId, ...body } = input;
-    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/crm-imports`, body, this.timeoutMs, "POST");
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(`/analytics/sites/${encodeURIComponent(siteId)}/crm-imports`, body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-crm-import", idempotencyKey));
   }
   analyticsGetHealth(input) {
     return this.getJson(`/analytics/sites/${encodeURIComponent(input.siteId)}/health`);
@@ -15358,6 +15641,38 @@ var HttpMcpToolExecutor = class {
     const { siteId, journeyTier: _journeyTier, ...body } = input;
     return this.call(analyticsSitePath(siteId, "activation-mappings/validate"), body, this.timeoutMs, "POST");
   }
+  analyticsPreviewCrmImport(input) {
+    const { siteId, ...body } = input;
+    return this.call(analyticsSitePath(siteId, "manual-imports/preview"), body, this.timeoutMs, "POST");
+  }
+  analyticsCommitCrmImport(input) {
+    const { siteId, ...body } = input;
+    return this.call(analyticsSitePath(siteId, "manual-imports/commit"), body, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-manual-import", input.idempotencyKey));
+  }
+  analyticsExportCrmCsv(input) {
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(analyticsSitePath(siteId, "manual-exports"), { kind: "crm_csv", ...body }, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-crm-export", idempotencyKey));
+  }
+  analyticsExportGoogleAdsCsv(input) {
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(analyticsSitePath(siteId, "manual-exports"), { kind: "google_ads_offline_csv", ...body }, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-google-export", idempotencyKey));
+  }
+  analyticsExportMetaTechnical(input) {
+    const { siteId, idempotencyKey, ...body } = input;
+    return this.call(analyticsSitePath(siteId, "manual-exports"), { kind: "meta_conversions_api_jsonl", ...body }, this.timeoutMs, "POST", analyticsIdempotencyHeaders("analytics-meta-export", idempotencyKey));
+  }
+  analyticsSaveActivationMapping(input) {
+    const { siteId, destinationId, journeyTier: _journeyTier, idempotencyKey, ...body } = input;
+    return this.call(analyticsSitePath(siteId, `activation-destinations/${encodeURIComponent(destinationId)}`), body, this.timeoutMs, "PATCH", analyticsIdempotencyHeaders("analytics-activation-mapping", idempotencyKey));
+  }
+  analyticsSetActivationAutomation(input) {
+    const { siteId, destinationId, idempotencyKey, ...body } = input;
+    return this.call(analyticsSitePath(siteId, `activation-destinations/${encodeURIComponent(destinationId)}`), body, this.timeoutMs, "PATCH", analyticsIdempotencyHeaders("analytics-activation-automation", idempotencyKey));
+  }
+  analyticsVerifyLiveEventDefinition(input) {
+    const query = new URLSearchParams({ timeoutMs: String(input.timeoutMs), maxAgeSeconds: String(input.maxAgeSeconds) });
+    return this.getJson(analyticsSitePath(input.siteId, `event-definitions/${encodeURIComponent(input.definitionId)}/verification?${query}`));
+  }
   commonsSearchEntities(input) {
     return this.call("/commons/entities/search", input);
   }
@@ -21987,7 +22302,9 @@ export {
   isLoopbackBaseUrl,
   permitsLocalNetworkAccess,
   handleMcpTasksHttpRequest,
+  parseAnalyticsAttributionQuery,
   parseAnalyticsReportView,
+  XrayCrmOutcomePageSchema,
   parseXrayCrmOutcomePage,
   AnalyticsCrmProviderIdSchema,
   AnalyticsResolvedCrmCapabilitySchema,