@sealmetrics/mcp 0.1.0 → 1.3.0

package/dist/index.js

@@ -1,809 +1,3838 @@
 #!/usr/bin/env node
-/**
- * SealMetrics MCP Server
- *
- * A Model Context Protocol server that provides access to SealMetrics analytics data.
- * Allows AI assistants to query traffic, conversions, sales, and generate tracking pixels.
- */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+
+// dist/index.js
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-// SealMetrics API Configuration
-const API_BASE_URL = "https://app.sealmetrics.com/api";
-const tokenCache = { token: null, expiresAt: null };
-// Get credentials from environment
-const API_TOKEN = process.env.SEALMETRICS_API_TOKEN;
-const EMAIL = process.env.SEALMETRICS_EMAIL;
-const PASSWORD = process.env.SEALMETRICS_PASSWORD;
-const DEFAULT_ACCOUNT_ID = process.env.SEALMETRICS_ACCOUNT_ID;
-/**
- * Get authentication token
- */
-async function getToken() {
-    // If we have a direct API token, use it
-    if (API_TOKEN) {
-        return API_TOKEN;
-    }
-    // Check cached token
-    if (tokenCache.token && tokenCache.expiresAt && new Date() < tokenCache.expiresAt) {
-        return tokenCache.token;
-    }
-    // Login with email/password
-    if (!EMAIL || !PASSWORD) {
-        throw new Error("Missing credentials. Set SEALMETRICS_API_TOKEN or SEALMETRICS_EMAIL/PASSWORD");
-    }
-    const response = await fetch(`${API_BASE_URL}/auth/login`, {
+
+// dist/server.js
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+// dist/errors.js
+var SealMetricsAPIError = class extends Error {
+  statusCode;
+  userMessage;
+  detail;
+  constructor(statusCode, userMessage, detail) {
+    super(userMessage);
+    this.statusCode = statusCode;
+    this.userMessage = userMessage;
+    this.detail = detail;
+    this.name = "SealMetricsAPIError";
+  }
+};
+function mapHttpError(status, body, siteId) {
+  switch (status) {
+    case 401:
+      return new SealMetricsAPIError(401, "Invalid API key. Generate one at Settings > API Tokens in your SealMetrics dashboard.", body);
+    case 403:
+      return new SealMetricsAPIError(403, siteId ? `Access denied to site "${siteId}". Your API key may not have access to this site.` : "Access denied. Your API key does not have the required permissions.", body);
+    case 404:
+      return new SealMetricsAPIError(404, siteId ? `Site "${siteId}" not found. Use list_sites to see available sites.` : "Resource not found.", body);
+    case 422:
+      return new SealMetricsAPIError(422, `Invalid request parameters: ${extractValidationMessage(body)}`, body);
+    case 429:
+      return new SealMetricsAPIError(429, "Rate limit exceeded. Please wait a moment before retrying.", body);
+    default:
+      if (status >= 500) {
+        return new SealMetricsAPIError(status, "SealMetrics API is temporarily unavailable. Please try again later.", body);
+      }
+      return new SealMetricsAPIError(status, `API request failed with status ${status}.`, body);
+  }
+}
+function extractValidationMessage(body) {
+  try {
+    const parsed = JSON.parse(body);
+    if (parsed.detail) {
+      if (Array.isArray(parsed.detail)) {
+        return parsed.detail.map((d) => `${d.loc?.join(".") ?? "field"}: ${d.msg ?? "invalid"}`).join("; ");
+      }
+      return String(parsed.detail);
+    }
+    return body;
+  } catch {
+    return body;
+  }
+}
+
+// dist/client.js
+var DEFAULT_TIMEOUT_MS = 3e4;
+var MAX_RETRIES = 2;
+var RETRY_BASE_MS = 1e3;
+var SealMetricsClient = class {
+  /**
+   * Read-only api_key (X-API-Key). Optional + mutable so the server can start in
+   * setup-only mode without a key (RF-3202) and adopt the key returned by
+   * provision_site at runtime to enable the read-only tools (RF-3202b). Held in
+   * memory only — never echoed to the model or logs (VAL-3201).
+   */
+  apiKey;
+  baseUrl;
+  constructor(apiKey, baseUrl) {
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+  }
+  /** True once a read-only api_key is available (env at boot or post-provision). */
+  hasApiKey() {
+    return typeof this.apiKey === "string" && this.apiKey.length > 0;
+  }
+  /** Return the in-memory api_key (for setup-core verify). Never logged by callers. */
+  getApiKey() {
+    return this.apiKey;
+  }
+  /** Adopt the api_key returned by provision_site so read-only tools work (RF-3202b). */
+  setApiKey(apiKey) {
+    this.apiKey = apiKey;
+  }
+  /**
+   * Authenticated POST (RF-3201). The client was GET-only in v1.2.0; the
+   * write-path needs it. NOT auto-retried — POST is not idempotent (a blind retry
+   * of /provision could create duplicate accounts). Authenticates with the
+   * publishable provision key (`provisionKey`) for provisioning, or X-API-Key
+   * otherwise. On 2xx returns the parsed JSON; on non-2xx / network throws
+   * SealMetricsAPIError carrying the status code for the caller to map.
+   */
+  async post(path, body, opts) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      Accept: "application/json"
+    };
+    if (opts?.provisionKey) {
+      headers["X-Provision-Key"] = opts.provisionKey;
+    } else if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
+    let response;
+    try {
+      response = await fetch(url, {
         method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ email: EMAIL, password: PASSWORD }),
-    });
+        headers,
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new SealMetricsAPIError(0, "Request timed out after 30 seconds.");
+      }
+      throw new SealMetricsAPIError(0, error instanceof Error ? error.message : "Network error");
+    } finally {
+      clearTimeout(timeout);
+    }
+    const text = await response.text();
     if (!response.ok) {
-        throw new Error(`Authentication failed: ${response.status}`);
-    }
-    const data = await response.json();
-    tokenCache.token = data.access_token;
-    tokenCache.expiresAt = new Date(data.expires_at);
-    return tokenCache.token;
-}
-/**
- * Make authenticated API request
- */
-async function makeRequest(endpoint, params) {
-    const token = await getToken();
-    const url = new URL(`${API_BASE_URL}${endpoint}`);
-    Object.entries(params).forEach(([key, value]) => {
-        if (value !== undefined && value !== null) {
-            url.searchParams.append(key, String(value));
+      throw mapHttpError(response.status, text);
+    }
+    try {
+      return JSON.parse(text);
+    } catch {
+      throw new SealMetricsAPIError(response.status, "API returned invalid JSON.", text.slice(0, 500));
+    }
+  }
+  /**
+   * Send an authenticated GET request. Unwraps the API envelope
+   * and returns just the `data` field.
+   */
+  async request(path, params) {
+    const raw = await this.requestRaw(path, params);
+    return raw.data;
+  }
+  /**
+   * Send an authenticated GET request and return the full JSON body
+   * without unwrapping. Use this for endpoints that don't use the
+   * standard APIResponse envelope (e.g. alerts, webhooks).
+   */
+  async requestDirect(path, params) {
+    const raw = await this.requestRaw(path, params);
+    return raw;
+  }
+  /**
+   * Send an authenticated GET request and return the full response
+   * including pagination fields (total, page, has_next, etc.).
+   * Use this for paginated endpoints.
+   */
+  async requestPaginated(path, params) {
+    const raw = await this.requestRaw(path, params);
+    const result = {
+      data: raw.data,
+      total: raw.total ?? 0,
+      page: raw.page ?? 1,
+      page_size: raw.page_size ?? 0,
+      has_next: raw.has_next ?? false
+    };
+    if (raw.comparison != null)
+      result.comparison = raw.comparison;
+    if (raw.totals != null)
+      result.totals = raw.totals;
+    return result;
+  }
+  async requestRaw(path, params) {
+    if (!this.apiKey) {
+      throw new SealMetricsAPIError(401, "AUTH_REQUIRED: a SealMetrics api_key is required for data tools. Provision a site first (provision_site) or set SEALMETRICS_API_KEY.");
+    }
+    const apiKey = this.apiKey;
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        if (value === void 0)
+          continue;
+        if (Array.isArray(value)) {
+          for (const item of value) {
+            if (item !== void 0 && item !== "") {
+              url.searchParams.append(key, item);
+            }
+          }
+        } else if (value !== "") {
+          url.searchParams.set(key, value);
+        }
+      }
+    }
+    let lastError;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+      if (attempt > 0) {
+        const delay = RETRY_BASE_MS * Math.pow(2, attempt - 1);
+        await sleep(delay);
+      }
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
+      try {
+        const response = await fetch(url.toString(), {
+          method: "GET",
+          headers: {
+            "X-API-Key": apiKey,
+            Accept: "application/json"
+          },
+          signal: controller.signal
+        });
+        if (response.ok) {
+          const text = await response.text();
+          try {
+            return JSON.parse(text);
+          } catch {
+            throw new SealMetricsAPIError(response.status, "API returned invalid JSON.", text.slice(0, 500));
+          }
         }
+        const body = await response.text();
+        if (response.status === 429 || response.status >= 500) {
+          if (response.status === 429) {
+            const retryAfter = parseRetryAfter(response.headers.get("Retry-After"));
+            if (retryAfter > 0) {
+              await sleep(retryAfter);
+            }
+          }
+          lastError = mapHttpError(response.status, body);
+          continue;
+        }
+        const siteIdRaw = params?.["site_id"] ?? params?.["account_id"] ?? void 0;
+        const siteId = typeof siteIdRaw === "string" ? siteIdRaw : void 0;
+        throw mapHttpError(response.status, body, siteId);
+      } catch (error) {
+        if (error instanceof SealMetricsAPIError) {
+          throw error;
+        }
+        if (error instanceof Error && error.name === "AbortError") {
+          lastError = new SealMetricsAPIError(0, "Request timed out after 30 seconds.");
+          continue;
+        }
+        lastError = error instanceof Error ? error : new Error("Unknown error occurred");
+        continue;
+      } finally {
+        clearTimeout(timeout);
+      }
+    }
+    throw lastError ?? new SealMetricsAPIError(0, "Request failed after retries.");
+  }
+};
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function parseRetryAfter(header) {
+  if (!header)
+    return 0;
+  const seconds = parseInt(header, 10);
+  if (!isNaN(seconds) && seconds > 0 && seconds <= 120) {
+    return seconds * 1e3;
+  }
+  return 0;
+}
+
+// dist/types.js
+var VALID_PERIODS = [
+  "today",
+  "yesterday",
+  "7d",
+  "30d",
+  "90d",
+  "12m",
+  "this_week",
+  "wtd",
+  "last_week",
+  "this_month",
+  "mtd",
+  "last_month",
+  "this_quarter",
+  "qtd",
+  "last_quarter",
+  "this_year",
+  "ytd",
+  "last_year"
+];
+
+// dist/tools/shared.js
+var PERIOD_SCHEMA = {
+  type: "string",
+  description: `Time period for the report. Examples: "today", "yesterday", "7d", "30d", "90d", "this_month", "last_month", "this_year". Default: "30d".`,
+  enum: [...VALID_PERIODS],
+  default: "30d"
+};
+var COMPARE_SCHEMA = {
+  type: "string",
+  description: 'Comparison mode. "previous" compares with the prior period of the same length. "yoy" compares with the same dates last year.',
+  enum: ["previous", "yoy"]
+};
+var LIMIT_SCHEMA = {
+  type: "number",
+  description: "Maximum number of rows to return (default: 20, max: 100).",
+  default: 20
+};
+var SORT_ORDER_SCHEMA = {
+  type: "string",
+  description: 'Sort direction: "asc" or "desc" (default: "desc").',
+  enum: ["asc", "desc"],
+  default: "desc"
+};
+var PAGE_SCHEMA = {
+  type: "number",
+  description: "Page number for paginated results (default: 1).",
+  default: 1
+};
+function resolveSiteId(args) {
+  const siteId = args.site_id ?? process.env.SEALMETRICS_SITE_ID;
+  if (!siteId) {
+    throw new Error("site_id is required. Either pass it as a parameter or set the SEALMETRICS_SITE_ID environment variable.");
+  }
+  return siteId;
+}
+
+// dist/tools/sites.js
+var listSitesTool = {
+  name: "list_sites",
+  description: "List all sites (web properties) accessible with your API key. Returns site IDs, names, and domains. Use this to find the site_id needed for other tools.",
+  inputSchema: {
+    type: "object",
+    properties: {}
+  },
+  handler: async (client) => {
+    const data = await client.request("/sites");
+    return data.sites.map((s) => ({
+      site_id: s.id,
+      name: s.name,
+      domains: s.domains,
+      timezone: s.timezone
+    }));
+  }
+};
+var getSiteTool = {
+  name: "get_site",
+  description: "Get detailed information about a specific site: name, domains, timezone, configuration, and tracking status. Use list_sites first to find available site IDs.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    const siteId = resolveSiteId(args);
+    return client.request(`/sites/${encodeURIComponent(siteId)}`);
+  }
+};
+
+// dist/tools/overview.js
+var getOverviewTool = {
+  name: "get_overview",
+  description: "Get dashboard KPIs: pageviews, entrances, bounce rate, conversions, revenue. Includes time series data and optional period-over-period comparison. This is the best starting point for understanding a site's performance.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    const siteId = resolveSiteId(args);
+    const params = {
+      site_id: siteId,
+      period: args.period ?? "30d",
+      compare: args.compare
+    };
+    return client.request("/stats/overview", params);
+  }
+};
+
+// dist/tools/traffic.js
+var TRAFFIC_SORT_BY = {
+  type: "string",
+  description: "Field to sort by.",
+  enum: ["entrances", "engaged_entrances", "page_views", "conversions", "revenue", "bounce_rate"],
+  default: "entrances"
+};
+function trafficParams(args) {
+  return {
+    site_id: resolveSiteId(args),
+    period: args.period ?? "30d",
+    compare: args.compare,
+    page_size: String(args.limit ?? 20),
+    page: args.page != null ? String(args.page) : void 0,
+    sort_by: args.sort_by ?? "entrances",
+    sort_order: args.sort_order ?? "desc"
+  };
+}
+var getTrafficSourcesTool = {
+  name: "get_traffic_sources",
+  description: "Get traffic broken down by source (utm_source): google, facebook, twitter, direct, etc. Shows entrances, pageviews, conversions, and revenue per source.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      page: PAGE_SCHEMA,
+      sort_by: TRAFFIC_SORT_BY,
+      sort_order: SORT_ORDER_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/sources", trafficParams(args));
+  }
+};
+var getTrafficMediumsTool = {
+  name: "get_traffic_mediums",
+  description: "Get traffic broken down by medium (utm_medium): organic, cpc, email, referral, social, etc. Useful for understanding which marketing channels drive traffic.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      page: PAGE_SCHEMA,
+      sort_by: TRAFFIC_SORT_BY,
+      sort_order: SORT_ORDER_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/mediums", trafficParams(args));
+  }
+};
+var getCampaignsTool = {
+  name: "get_campaigns",
+  description: "Get traffic and conversions broken down by campaign (utm_campaign). Shows performance of individual marketing campaigns including entrances, conversions, and revenue.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      page: PAGE_SCHEMA,
+      sort_by: TRAFFIC_SORT_BY,
+      sort_order: SORT_ORDER_SCHEMA,
+      utm_source: {
+        type: "string",
+        description: "Filter by source (e.g. 'google')."
+      },
+      utm_medium: {
+        type: "string",
+        description: "Filter by medium (e.g. 'cpc')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    const params = trafficParams(args);
+    params.utm_source = args.utm_source;
+    params.utm_medium = args.utm_medium;
+    return client.requestPaginated("/stats/campaigns", params);
+  }
+};
+var getTermsTool = {
+  name: "get_terms",
+  description: "Get traffic and conversions broken down by UTM term (keyword). Shows which search keywords or ad terms drive the most traffic. Supports filtering by source, medium, and campaign.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      page: PAGE_SCHEMA,
+      sort_by: TRAFFIC_SORT_BY,
+      sort_order: SORT_ORDER_SCHEMA,
+      utm_source: {
+        type: "string",
+        description: "Filter by source (e.g. 'google')."
+      },
+      utm_medium: {
+        type: "string",
+        description: "Filter by medium (e.g. 'cpc')."
+      },
+      utm_campaign: {
+        type: "string",
+        description: "Filter by campaign name."
+      },
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    const params = trafficParams(args);
+    params.utm_source = args.utm_source;
+    params.utm_medium = args.utm_medium;
+    params.utm_campaign = args.utm_campaign;
+    params.country = args.country;
+    return client.requestPaginated("/stats/terms", params);
+  }
+};
+function topNParams(args) {
+  return {
+    site_id: resolveSiteId(args),
+    period: args.period ?? "30d",
+    limit: String(args.limit ?? 10)
+  };
+}
+var getTopSourcesTool = {
+  name: "get_top_sources",
+  description: "Get top traffic sources ranked by entrances. Returns a compact list of the top N sources (utm_source) without pagination \u2014 ideal for quick rankings and summaries.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      utm_medium: {
+        type: "string",
+        description: "Filter by medium (e.g. 'cpc')."
+      },
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    const params = topNParams(args);
+    params.utm_medium = args.utm_medium;
+    params.country = args.country;
+    return client.request("/stats/sources/top", params);
+  }
+};
+var getTopCampaignsTool = {
+  name: "get_top_campaigns",
+  description: "Get top campaigns ranked by entrances. Returns a compact list of the top N campaigns (utm_campaign) \u2014 ideal for quick rankings.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      utm_source: {
+        type: "string",
+        description: "Filter by source (e.g. 'google')."
+      },
+      utm_medium: {
+        type: "string",
+        description: "Filter by medium (e.g. 'cpc')."
+      },
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    const params = topNParams(args);
+    params.utm_source = args.utm_source;
+    params.utm_medium = args.utm_medium;
+    params.country = args.country;
+    return client.request("/stats/campaigns/top", params);
+  }
+};
+var getTopTermsTool = {
+  name: "get_top_terms",
+  description: "Get top UTM terms (keywords) ranked by entrances. Returns a compact list of the top N terms \u2014 ideal for quick keyword rankings.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      utm_source: {
+        type: "string",
+        description: "Filter by source (e.g. 'google')."
+      },
+      utm_medium: {
+        type: "string",
+        description: "Filter by medium (e.g. 'cpc')."
+      },
+      utm_campaign: {
+        type: "string",
+        description: "Filter by campaign name."
+      },
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    const params = topNParams(args);
+    params.utm_source = args.utm_source;
+    params.utm_medium = args.utm_medium;
+    params.utm_campaign = args.utm_campaign;
+    params.country = args.country;
+    return client.request("/stats/terms/top", params);
+  }
+};
+var getTopReferrersTool = {
+  name: "get_top_referrers",
+  description: "Get top referrer domains ranked by entrances. Shows which external sites send the most traffic.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    const params = topNParams(args);
+    params.country = args.country;
+    return client.request("/stats/referrers/top", params);
+  }
+};
+
+// dist/tools/pages.js
+var MULTI_FILTER_SCHEMA = {
+  country: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by country code(s) (e.g. ['ES', 'US'])."
+  },
+  device_type: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by device type(s) (e.g. ['mobile', 'desktop'])."
+  },
+  browser: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by browser name(s)."
+  },
+  os: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by operating system name(s)."
+  },
+  channel_group: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by channel group(s)."
+  },
+  utm_source: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by UTM source(s)."
+  },
+  utm_medium: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by UTM medium(s)."
+  },
+  utm_campaign: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by UTM campaign(s)."
+  },
+  utm_term: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by UTM term(s)."
+  },
+  // `minItems` intentionally absent — empty array ≡ no grouping (PRD 08
+  // VAL-006 exception). Filter arrays use minItems: 1 because an empty
+  // filter list would silently match nothing; `include` instead is a no-op
+  // when empty, matching the API behavior.
+  include: {
+    type: "array",
+    items: { type: "string", enum: ["device", "browser", "os", "channel_group"] },
+    description: "Add dimension(s) to GROUP BY and response. Allowed values: device, browser, os, channel_group. Empty/absent means no extra grouping."
+  }
+};
+var MULTI_FILTER_KEYS = [
+  "country",
+  "device_type",
+  "browser",
+  "os",
+  "channel_group",
+  "utm_source",
+  "utm_medium",
+  "utm_campaign",
+  "utm_term",
+  "include"
+];
+function pickMultiFilters(args) {
+  const out = {};
+  for (const key of MULTI_FILTER_KEYS) {
+    const value = args[key];
+    if (Array.isArray(value) && value.length > 0) {
+      out[key] = value;
+    }
+  }
+  return out;
+}
+var getPagesTool = {
+  name: "get_pages",
+  description: "Get metrics per page URL path: pageviews and entrances. Useful for finding most popular pages and content performance. For bounce rate by entry page, use get_landing_pages instead \u2014 bounce is not interpretable at page granularity. Supports multi-value filters (country, device_type, browser, os, channel_group, UTMs) as arrays of strings \u2014 e.g. device_type=['mobile'] to filter to mobile only. Pass include=['device'] to also break down metrics by device. The two are orthogonal \u2014 combine them as needed.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      sort_by: {
+        type: "string",
+        description: "Field to sort by.",
+        enum: ["page_views", "entrances"],
+        default: "page_views"
+      },
+      sort_order: SORT_ORDER_SCHEMA,
+      page: PAGE_SCHEMA,
+      path_filter: {
+        type: "string",
+        description: "Filter pages by URL path pattern (e.g. '/blog')."
+      },
+      ...MULTI_FILTER_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/pages", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      compare: args.compare,
+      page_size: String(args.limit ?? 20),
+      page: args.page != null ? String(args.page) : void 0,
+      sort_by: args.sort_by ?? "page_views",
+      sort_order: args.sort_order ?? "desc",
+      path_filter: args.path_filter,
+      ...pickMultiFilters(args)
     });
-    const response = await fetch(url.toString(), {
-        headers: {
-            Authorization: `Bearer ${token}`,
-            Accept: "application/json",
-        },
+  }
+};
+var getLandingPagesTool = {
+  name: "get_landing_pages",
+  description: "Get landing page performance: entrances, bounce rate, conversions. Landing pages are the first page users see when entering the site. High bounce rates indicate poor landing page experience. Supports multi-value filters (country, device_type, browser, os, channel_group, UTMs) as arrays of strings \u2014 e.g. country=['ES','PT'] to filter to two countries. Pass include=['channel_group'] to also break down by channel group. The two are orthogonal \u2014 combine them as needed.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      sort_by: {
+        type: "string",
+        description: "Field to sort by.",
+        enum: ["entrances", "engaged_entrances", "page_views", "conversions", "revenue", "bounce_rate"],
+        default: "entrances"
+      },
+      sort_order: SORT_ORDER_SCHEMA,
+      page: PAGE_SCHEMA,
+      path_filter: {
+        type: "string",
+        description: "Filter by URL path pattern."
+      },
+      ...MULTI_FILTER_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/landing-pages", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      compare: args.compare,
+      page_size: String(args.limit ?? 20),
+      page: args.page != null ? String(args.page) : void 0,
+      sort_by: args.sort_by ?? "entrances",
+      sort_order: args.sort_order ?? "desc",
+      path_filter: args.path_filter,
+      ...pickMultiFilters(args)
     });
-    if (!response.ok) {
-        const text = await response.text();
-        throw new Error(`API request failed: ${response.status} - ${text}`);
-    }
-    return response.json();
-}
-/**
- * Validate date range format
- */
-function validateDateRange(dateRange) {
-    const validRanges = new Set([
-        "today",
-        "yesterday",
-        "last_7_days",
-        "last_14_days",
-        "last_30_days",
-        "last_week",
-        "last_month",
-        "this_month",
-        "this_year",
-        "last_year",
-    ]);
-    if (validRanges.has(dateRange))
-        return true;
-    if (dateRange.includes(",")) {
-        const parts = dateRange.split(",");
-        if (parts.length !== 2)
-            return false;
-        return parts.every((p) => /^\d{8}$/.test(p));
+  }
+};
+var getTopPagesTool = {
+  name: "get_top_pages",
+  description: "Get top pages ranked by page views. Returns a compact list of the top N pages \u2014 ideal for quick rankings and summaries.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      },
+      utm_source: {
+        type: "string",
+        description: "Filter by UTM source."
+      },
+      utm_medium: {
+        type: "string",
+        description: "Filter by UTM medium."
+      },
+      utm_campaign: {
+        type: "string",
+        description: "Filter by UTM campaign."
+      },
+      utm_term: {
+        type: "string",
+        description: "Filter by UTM term."
+      }
     }
-    return false;
+  },
+  handler: async (client, args) => {
+    return client.request("/stats/pages/top", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      limit: String(args.limit ?? 10),
+      country: args.country,
+      utm_source: args.utm_source,
+      utm_medium: args.utm_medium,
+      utm_campaign: args.utm_campaign,
+      utm_term: args.utm_term
+    });
+  }
+};
+var getTopLandingPagesTool = {
+  name: "get_top_landing_pages",
+  description: "Get top landing pages ranked by entrances. Returns a compact list of the top N landing pages \u2014 ideal for quick rankings.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      utm_source: {
+        type: "string",
+        description: "Filter by UTM source."
+      },
+      utm_medium: {
+        type: "string",
+        description: "Filter by UTM medium."
+      },
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      },
+      content_grouping: {
+        type: "string",
+        description: "Filter by content grouping name."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/stats/landing-pages/top", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      limit: String(args.limit ?? 10),
+      utm_source: args.utm_source,
+      utm_medium: args.utm_medium,
+      country: args.country,
+      content_grouping: args.content_grouping
+    });
+  }
+};
+var getLandingPagesByContentGroupTool = {
+  name: "get_landing_pages_by_content_group",
+  description: "Get landing page metrics grouped by content grouping. Shows aggregate performance per content group (e.g. blog, product, category).",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      utm_source: {
+        type: "string",
+        description: "Filter by UTM source."
+      },
+      utm_medium: {
+        type: "string",
+        description: "Filter by UTM medium."
+      },
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/stats/landing-pages/by-content-group", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      utm_source: args.utm_source,
+      utm_medium: args.utm_medium,
+      country: args.country
+    });
+  }
+};
+
+// dist/tools/conversions.js
+var getConversionsTool = {
+  name: "get_conversions",
+  description: "Get conversions broken down by type (e.g. purchase, signup). Shows count, revenue, and average order value per conversion type. Use for aggregated counts/revenue by conversion type. **For per-event detail or per-product analysis use `get_conversions_raw` or `get_conversion_items_raw`.**",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      sort_by: {
+        type: "string",
+        description: "Field to sort by.",
+        enum: ["count", "revenue", "avg_value"],
+        default: "count"
+      },
+      sort_order: SORT_ORDER_SCHEMA,
+      page: PAGE_SCHEMA,
+      utm_source: {
+        type: "string",
+        description: "Filter by traffic source."
+      },
+      utm_medium: {
+        type: "string",
+        description: "Filter by traffic medium."
+      },
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/conversions", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      compare: args.compare,
+      page_size: String(args.limit ?? 20),
+      page: args.page != null ? String(args.page) : void 0,
+      sort_by: args.sort_by ?? "count",
+      sort_order: args.sort_order ?? "desc",
+      utm_source: args.utm_source,
+      utm_medium: args.utm_medium,
+      country: args.country
+    });
+  }
+};
+var getMicroconversionsTool = {
+  name: "get_microconversions",
+  description: "Get microconversions (smaller engagement events) broken down by type: add_to_cart, newsletter_signup, pdf_download, etc. Shows count and trends per event type. **For per-event detail use `get_microconversions_raw`.**",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      sort_by: {
+        type: "string",
+        description: "Field to sort by.",
+        enum: ["count", "revenue", "avg_value"],
+        default: "count"
+      },
+      sort_order: SORT_ORDER_SCHEMA,
+      page: PAGE_SCHEMA,
+      conversion_type: {
+        type: "string",
+        description: "Filter by specific microconversion type."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/microconversions", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      compare: args.compare,
+      page_size: String(args.limit ?? 20),
+      page: args.page != null ? String(args.page) : void 0,
+      sort_by: args.sort_by ?? "count",
+      sort_order: args.sort_order ?? "desc",
+      conversion_type: args.conversion_type
+    });
+  }
+};
+var listMicroconversionTypesTool = {
+  name: "list_microconversion_types",
+  description: "Get the list of available microconversion type names for a site. Use this to discover what microconversion types exist before querying details.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/stats/microconversions-types", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d"
+    });
+  }
+};
+var getMicroconversionDetailsTool = {
+  name: "get_microconversion_details",
+  description: "Get detailed breakdown for a specific microconversion type. Shows metrics segmented by source, medium, campaign, country, device, browser, and OS.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      conversion_type: {
+        type: "string",
+        description: "The microconversion type to get details for (e.g. 'add_to_cart', 'newsletter_signup')."
+      },
+      period: PERIOD_SCHEMA,
+      utm_source: {
+        type: "string",
+        description: "Filter by UTM source."
+      },
+      utm_medium: {
+        type: "string",
+        description: "Filter by UTM medium."
+      },
+      utm_campaign: {
+        type: "string",
+        description: "Filter by UTM campaign."
+      },
+      utm_term: {
+        type: "string",
+        description: "Filter by UTM term."
+      },
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      },
+      device_type: {
+        type: "string",
+        description: "Filter by device type (e.g. 'desktop', 'mobile', 'tablet')."
+      },
+      browser: {
+        type: "string",
+        description: "Filter by browser name."
+      },
+      os: {
+        type: "string",
+        description: "Filter by operating system name."
+      }
+    },
+    required: ["conversion_type"]
+  },
+  handler: async (client, args) => {
+    const conversionType = args.conversion_type;
+    return client.request(`/stats/microconversions/${encodeURIComponent(conversionType)}`, {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      utm_source: args.utm_source,
+      utm_medium: args.utm_medium,
+      utm_campaign: args.utm_campaign,
+      utm_term: args.utm_term,
+      country: args.country,
+      device_type: args.device_type,
+      browser: args.browser,
+      os: args.os
+    });
+  }
+};
+var RAW_LIMIT_SCHEMA = {
+  type: "number",
+  description: "Maximum number of rows to return (default: 10, max: 100). MCP-side cap to control token usage.",
+  default: 10,
+  minimum: 1,
+  maximum: 100
+};
+var RAW_FILTER_KEYS = [
+  "conversion_type",
+  "country",
+  "device_type",
+  "browser",
+  "os",
+  "channel_group",
+  "utm_source",
+  "utm_medium",
+  "utm_campaign",
+  "utm_term",
+  "utm_content"
+];
+function pickRawFilters(args) {
+  const out = {};
+  for (const key of RAW_FILTER_KEYS) {
+    const value = args[key];
+    if (Array.isArray(value) && value.length > 0) {
+      out[key] = value;
+    }
+  }
+  return out;
 }
-/**
- * Get account ID from arguments or environment
- */
-function getAccountId(args) {
-    const provided = args.account_id;
-    if (provided && provided.length >= 20)
-        return provided;
-    return DEFAULT_ACCOUNT_ID || null;
-}
-/**
- * Generate conversion pixel HTML
- */
-function generatePixel(accountId, eventType, label, value, ignorePageview) {
-    const configLines = [
-        `  oSm.account = "${accountId}";`,
-        `  oSm.event = "${eventType}";`,
-    ];
-    if (label)
-        configLines.push(`  oSm.label = "${label}";`);
-    if (value !== undefined)
-        configLines.push(`  oSm.value = ${value};`);
-    if (ignorePageview)
-        configLines.push(`  oSm.ignore_pageview = 1;`);
-    return `<script>
-  /* SealMetrics Tracker Code */
-  var oSm = window.oSm || {};
-${configLines.join("\n")}
-
-  !(function (e) {
-    var t = "//app.sealmetrics.com/tag/tracker";
-    window.oSm = oSm;
-    if (window.smTrackerLoaded) sm.tracker.track(e.event);
-    else
-      Promise.all([
-        new Promise(function (e) {
-          var n = document.createElement("script");
-          n.src = t;
-          n.async = !0;
-          n.onload = function () {
-            e(t);
-          };
-          document.getElementsByTagName("head")[0].appendChild(n);
-        }),
-      ]).then(function () {
-        sm.tracker.track(e.event);
-      });
-  })(oSm);
-</script>`;
-}
-/**
- * Format acquisition data summary
- */
-function formatAcquisitionSummary(data) {
-    if (!data.length) {
-        return "## Traffic Summary\n\nNo acquisition data found for this period.";
-    }
-    const totalClicks = data.reduce((sum, item) => sum + (item.clicks || 0), 0);
-    const totalConversions = data.reduce((sum, item) => sum + (item.conversions || 0), 0);
-    const totalRevenue = data.reduce((sum, item) => sum + (item.revenue || 0), 0);
-    let summary = `## Traffic Summary\n\n`;
-    summary += `| Metric | Value |\n|--------|-------|\n`;
-    summary += `| Total Clicks | ${totalClicks.toLocaleString()} |\n`;
-    summary += `| Total Conversions | ${totalConversions.toLocaleString()} |\n`;
-    summary += `| Total Revenue | $${totalRevenue.toLocaleString(undefined, { minimumFractionDigits: 2 })} |\n`;
-    if (totalClicks > 0) {
-        const convRate = ((totalConversions / totalClicks) * 100).toFixed(2);
-        summary += `| Conversion Rate | ${convRate}% |\n`;
-    }
-    summary += `\n### Top Sources\n\n`;
-    const sorted = [...data].sort((a, b) => (b.clicks || 0) - (a.clicks || 0));
-    const top10 = sorted.slice(0, 10);
-    summary += `| Source | Clicks | Conversions | Revenue |\n`;
-    summary += `|--------|--------|-------------|----------|\n`;
-    for (const item of top10) {
-        const source = item.name || item.utm_source || "Unknown";
-        summary += `| ${source} | ${(item.clicks || 0).toLocaleString()} | ${(item.conversions || 0).toLocaleString()} | $${(item.revenue || 0).toLocaleString(undefined, { minimumFractionDigits: 2 })} |\n`;
-    }
-    return summary;
-}
-/**
- * Format conversions summary
- */
-function formatConversionsSummary(data) {
-    if (!data.length) {
-        return "## Conversions Summary\n\nNo conversions found for this period.";
-    }
-    const totalConversions = data.length;
-    const totalRevenue = data.reduce((sum, item) => sum + (item.amount || 0), 0);
-    let summary = `## Conversions Summary\n\n`;
-    summary += `| Metric | Value |\n|--------|-------|\n`;
-    summary += `| Total Conversions | ${totalConversions.toLocaleString()} |\n`;
-    summary += `| Total Revenue | $${totalRevenue.toLocaleString(undefined, { minimumFractionDigits: 2 })} |\n`;
-    if (totalConversions > 0) {
-        const avgOrderValue = totalRevenue / totalConversions;
-        summary += `| Average Order Value | $${avgOrderValue.toLocaleString(undefined, { minimumFractionDigits: 2 })} |\n`;
-    }
-    // Group by source
-    const bySource = {};
-    for (const item of data) {
-        const source = item.utm_source || "Direct";
-        if (!bySource[source])
-            bySource[source] = { count: 0, revenue: 0 };
-        bySource[source].count++;
-        bySource[source].revenue += item.amount || 0;
-    }
-    summary += `\n### By Source\n\n`;
-    summary += `| Source | Conversions | Revenue |\n`;
-    summary += `|--------|-------------|----------|\n`;
-    const sortedSources = Object.entries(bySource).sort((a, b) => b[1].revenue - a[1].revenue);
-    for (const [source, stats] of sortedSources.slice(0, 10)) {
-        summary += `| ${source} | ${stats.count.toLocaleString()} | $${stats.revenue.toLocaleString(undefined, { minimumFractionDigits: 2 })} |\n`;
-    }
-    return summary;
-}
-/**
- * Format microconversions summary
- */
-function formatMicroconversionsSummary(data) {
-    if (!data.length) {
-        return "## Microconversions Summary\n\nNo microconversions found for this period.";
-    }
-    // Group by label
-    const byLabel = {};
-    for (const item of data) {
-        const label = item.label || "unknown";
-        byLabel[label] = (byLabel[label] || 0) + 1;
-    }
-    let summary = `## Microconversions Summary\n\n`;
-    summary += `| Metric | Value |\n|--------|-------|\n`;
-    summary += `| Total Events | ${data.length.toLocaleString()} |\n`;
-    summary += `| Unique Event Types | ${Object.keys(byLabel).length} |\n`;
-    summary += `\n### By Event Type\n\n`;
-    summary += `| Event | Count | Percentage |\n`;
-    summary += `|-------|-------|------------|\n`;
-    const sortedLabels = Object.entries(byLabel).sort((a, b) => b[1] - a[1]);
-    for (const [label, count] of sortedLabels) {
-        const pct = ((count / data.length) * 100).toFixed(1);
-        summary += `| ${label} | ${count.toLocaleString()} | ${pct}% |\n`;
-    }
-    return summary;
-}
-// Define tools
-const tools = [
-    {
-        name: "list_accounts",
-        description: "Get list of SealMetrics accounts available to the authenticated user",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
+function buildRawDates(args) {
+  const startDate = args.start_date;
+  const endDate = args.end_date;
+  if (startDate && endDate) {
+    return { start_date: startDate, end_date: endDate };
+  }
+  return { period: args.period ?? "30d" };
+}
+var RAW_DATE_SCHEMA = {
+  period: PERIOD_SCHEMA,
+  start_date: {
+    type: "string",
+    description: "Custom start date (YYYY-MM-DD). Use together with end_date as an alternative to period. Date range capped at 31 days by the API."
+  },
+  end_date: {
+    type: "string",
+    description: "Custom end date (YYYY-MM-DD). Use together with start_date."
+  }
+};
+var RAW_MULTI_FILTER_SCHEMA = {
+  conversion_type: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by conversion type (e.g. ['purchase'])."
+  },
+  country: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by country code (e.g. ['ES', 'US'])."
+  },
+  device_type: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by device type (e.g. ['mobile'])."
+  },
+  browser: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by browser."
+  },
+  os: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by operating system."
+  },
+  channel_group: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by channel group."
+  },
+  utm_source: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by UTM source."
+  },
+  utm_medium: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by UTM medium."
+  },
+  utm_campaign: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by UTM campaign."
+  },
+  utm_term: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by UTM term."
+  },
+  utm_content: {
+    type: "array",
+    items: { type: "string", minLength: 1 },
+    minItems: 1,
+    description: "Filter by UTM content."
+  }
+};
+function stripProperties(result) {
+  return {
+    ...result,
+    data: result.data.map((row) => {
+      const { properties: _omit, ...rest } = row;
+      return rest;
+    })
+  };
+}
+var getConversionsRawTool = {
+  name: "get_conversions_raw",
+  description: "Returns raw conversion rows from /stats/conversions/raw (one row per event, with timestamp_utc and timestamp_local). Use for one-row-per-event detail. **For per-product/SKU analysis prefer `get_conversion_items_raw` (always includes item properties like sku, price, quantity).** Custom `properties` are excluded by default \u2014 pass `include_properties=true` to receive them. Date range capped at 31 days; page_size capped at 100 to control token usage.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      ...RAW_DATE_SCHEMA,
+      page: PAGE_SCHEMA,
+      limit: RAW_LIMIT_SCHEMA,
+      include_properties: {
+        type: "boolean",
+        description: "If true, include the custom `properties` object in each row. Default false to keep responses compact.",
+        default: false
+      },
+      ...RAW_MULTI_FILTER_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    const limit = args.limit ?? 10;
+    const includeProperties = args.include_properties === true;
+    const dates = buildRawDates(args);
+    const result = await client.requestPaginated("/stats/conversions/raw", {
+      site_id: resolveSiteId(args),
+      ...dates,
+      page_size: String(limit),
+      page: args.page != null ? String(args.page) : void 0,
+      ...pickRawFilters(args)
+    });
+    return includeProperties ? result : stripProperties(result);
+  }
+};
+var getMicroconversionsRawTool = {
+  name: "get_microconversions_raw",
+  description: "Returns raw microconversion rows from /stats/microconversions/raw (one row per event, with timestamp_utc and timestamp_local). Use for one-row-per-event detail of microconversions (add_to_cart, newsletter_signup, etc.). Custom `properties` are excluded by default \u2014 pass `include_properties=true` to receive them. Date range capped at 31 days; page_size capped at 100 to control token usage.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      ...RAW_DATE_SCHEMA,
+      page: PAGE_SCHEMA,
+      limit: RAW_LIMIT_SCHEMA,
+      include_properties: {
+        type: "boolean",
+        description: "If true, include the custom `properties` object in each row. Default false to keep responses compact.",
+        default: false
+      },
+      ...RAW_MULTI_FILTER_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    const limit = args.limit ?? 10;
+    const includeProperties = args.include_properties === true;
+    const dates = buildRawDates(args);
+    const result = await client.requestPaginated("/stats/microconversions/raw", {
+      site_id: resolveSiteId(args),
+      ...dates,
+      page_size: String(limit),
+      page: args.page != null ? String(args.page) : void 0,
+      ...pickRawFilters(args)
+    });
+    return includeProperties ? result : stripProperties(result);
+  }
+};
+var getConversionItemsRawTool = {
+  name: "get_conversion_items_raw",
+  description: "Returns one row per item inside a conversion (e.g. one row per product in a purchase) from /stats/conversion-items/raw. `properties` always included \u2014 that's where product_id, sku, price, quantity live. **Best tool for per-product analytics.** Date range capped at 31 days; page_size capped at 100 to control token usage.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      ...RAW_DATE_SCHEMA,
+      page: PAGE_SCHEMA,
+      limit: RAW_LIMIT_SCHEMA,
+      ...RAW_MULTI_FILTER_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    const limit = args.limit ?? 10;
+    const dates = buildRawDates(args);
+    return client.requestPaginated("/stats/conversion-items/raw", {
+      site_id: resolveSiteId(args),
+      ...dates,
+      page_size: String(limit),
+      page: args.page != null ? String(args.page) : void 0,
+      ...pickRawFilters(args)
+    });
+  }
+};
+
+// dist/tools/audience.js
+var getCountriesTool = {
+  name: "get_countries",
+  description: "Get traffic broken down by country. Shows entrances, pageviews, conversions, and revenue per country. Country codes follow ISO 3166-1 alpha-2 (e.g. ES=Spain, US=United States).",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      sort_by: {
+        type: "string",
+        description: "Field to sort by.",
+        enum: ["entrances", "engaged_entrances", "page_views", "conversions", "revenue", "bounce_rate"],
+        default: "entrances"
+      },
+      sort_order: SORT_ORDER_SCHEMA,
+      page: PAGE_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/geo/countries", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      compare: args.compare,
+      page_size: String(args.limit ?? 20),
+      page: args.page != null ? String(args.page) : void 0,
+      sort_by: args.sort_by ?? "entrances",
+      sort_order: args.sort_order ?? "desc"
+    });
+  }
+};
+var getDevicesTool = {
+  name: "get_devices",
+  description: "Get traffic broken down by device type (desktop/mobile/tablet), browser (Chrome, Safari, Firefox...), and operating system (Windows, macOS, iOS, Android...). Returns all three breakdowns in a single call.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      compare: COMPARE_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/stats/devices", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      compare: args.compare
+    });
+  }
+};
+var getBrowsersTool = {
+  name: "get_browsers",
+  description: "Get traffic broken down by browser: Chrome, Safari, Firefox, Edge, etc. Shows entrances and pageviews per browser with pagination.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      page: PAGE_SCHEMA,
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/browsers", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      page_size: String(args.limit ?? 20),
+      page: args.page != null ? String(args.page) : void 0,
+      country: args.country
+    });
+  }
+};
+var getOperatingSystemsTool = {
+  name: "get_operating_systems",
+  description: "Get traffic broken down by operating system: Windows, macOS, iOS, Android, Linux, etc. Shows entrances and pageviews per OS with pagination.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      page: PAGE_SCHEMA,
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/operating-systems", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      page_size: String(args.limit ?? 20),
+      page: args.page != null ? String(args.page) : void 0,
+      country: args.country
+    });
+  }
+};
+var getDeviceTypesTool = {
+  name: "get_device_types",
+  description: "Get traffic broken down by device type (desktop, mobile, tablet) with pagination. Shows entrances, pageviews, conversions per device type.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      page: PAGE_SCHEMA,
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/devices/types", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      page_size: String(args.limit ?? 10),
+      page: args.page != null ? String(args.page) : void 0,
+      country: args.country
+    });
+  }
+};
+
+// dist/tools/funnel.js
+var getFunnelTool = {
+  name: "get_funnel",
+  description: "Get funnel analysis showing conversion rates between steps. Returns step-by-step data including visitor count, conversion rate, and dropoff at each stage. Useful for finding where users drop off in multi-step flows.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/stats/funnel", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      country: args.country
+    });
+  }
+};
+
+// dist/tools/content.js
+var getContentGroupsTool = {
+  name: "get_content_groups",
+  description: "Get metrics grouped by content group (content_grouping). Shows pageviews and entrances per content group. Useful for understanding which sections of a site get the most traffic.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      },
+      utm_source: {
+        type: "string",
+        description: "Filter by UTM source (e.g. 'google')."
+      },
+      utm_medium: {
+        type: "string",
+        description: "Filter by UTM medium (e.g. 'cpc')."
+      },
+      utm_campaign: {
+        type: "string",
+        description: "Filter by UTM campaign name."
+      },
+      utm_term: {
+        type: "string",
+        description: "Filter by UTM term."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/stats/pages/content-groups", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      country: args.country,
+      utm_source: args.utm_source,
+      utm_medium: args.utm_medium,
+      utm_campaign: args.utm_campaign,
+      utm_term: args.utm_term
+    });
+  }
+};
+
+// dist/tools/channels.js
+var getChannelsTool = {
+  name: "get_channels",
+  description: "Get traffic metrics grouped by channel: Paid Search, Organic Search, Social, Direct, Email, Referral, etc. Channels are automatically classified based on UTM parameters and referrer rules.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      page: PAGE_SCHEMA,
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/channel-groups/stats/channels", {
+      account_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      page_size: String(args.limit ?? 20),
+      page: args.page != null ? String(args.page) : void 0,
+      country: args.country
+    });
+  }
+};
+var getTopChannelsTool = {
+  name: "get_top_channels",
+  description: "Get top channels ranked by entrances. Returns a compact list of the top N channels (Paid Search, Organic, Social, etc.) \u2014 ideal for quick rankings.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      limit: LIMIT_SCHEMA,
+      country: {
+        type: "string",
+        description: "Filter by country code (e.g. 'ES', 'US')."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/stats/top-channels", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      limit: String(args.limit ?? 10),
+      country: args.country
+    });
+  }
+};
+var listChannelRulesTool = {
+  name: "list_channel_rules",
+  description: "List channel group rules configured for a site. Shows how traffic is classified into channels (Paid Search, Organic, Social, etc.) based on UTM parameters and referrer patterns.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      include_inactive: {
+        type: "boolean",
+        description: "Include inactive rules (default: false)."
+      },
+      include_defaults: {
+        type: "boolean",
+        description: "Include default system rules (default: true)."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/channel-groups", {
+      account_id: resolveSiteId(args),
+      include_inactive: args.include_inactive != null ? String(args.include_inactive) : void 0,
+      include_defaults: args.include_defaults != null ? String(args.include_defaults) : void 0
+    });
+  }
+};
+
+// dist/tools/bots.js
+var getBotStatsTool = {
+  name: "get_bot_stats",
+  description: "Get bot detection overview: score distribution, top suspicion flags, and daily trend of human vs suspected-bot traffic. Requires agent analytics to be enabled on the site.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      days: {
+        type: "number",
+        description: "Number of days to analyze (1-90, default: 30).",
+        default: 30
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/bot-stats/overview", {
+      account_id: resolveSiteId(args),
+      days: String(args.days ?? 30)
+    });
+  }
+};
+var getSuspiciousSessionsTool = {
+  name: "get_suspicious_sessions",
+  description: "Get sessions with high bot-suspicion scores for investigation. Shows session details, score, and detected flags. Useful for identifying automated traffic patterns.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      min_score: {
+        type: "number",
+        description: "Minimum suspicion score threshold (1-100, default: 50).",
+        default: 50
+      },
+      limit: LIMIT_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/bot-stats/suspicious-sessions", {
+      account_id: resolveSiteId(args),
+      min_score: String(args.min_score ?? 50),
+      limit: String(args.limit ?? 20)
+    });
+  }
+};
+
+// dist/tools/segments.js
+var listSegmentsTool = {
+  name: "list_segments",
+  description: "List all segments available for a site. Segments are saved filter sets (e.g. 'Mobile users from Spain', 'Organic traffic') that can be applied to stats queries via the segment parameter.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      include_system: {
+        type: "boolean",
+        description: "Include system segments like 'All Traffic', 'Direct' (default: true)."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/segments", {
+      account_id: resolveSiteId(args),
+      include_system: args.include_system != null ? String(args.include_system) : void 0
+    });
+  }
+};
+var getSegmentTool = {
+  name: "get_segment",
+  description: "Get details of a specific segment including its filter definition. The segment_id can be either the segment ID (seg_xxx) or the segment name.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      segment_id: {
+        type: "string",
+        description: "Segment ID (seg_xxx) or segment name."
+      }
     },
-    {
-        name: "get_traffic",
-        description: "Get traffic/acquisition data from SealMetrics. Answers questions like 'How much traffic from SEO yesterday?' or 'Show me Google Ads performance this month'",
-        inputSchema: {
-            type: "object",
-            properties: {
-                account_id: {
-                    type: "string",
-                    description: "SealMetrics account ID (optional if SEALMETRICS_ACCOUNT_ID is set)",
-                },
-                date_range: {
-                    type: "string",
-                    description: "Date range: 'yesterday', 'today', 'last_7_days', 'last_30_days', 'this_month', 'last_month', or 'YYYYMMDD,YYYYMMDD'",
-                },
-                report_type: {
-                    type: "string",
-                    description: "Report grouping: 'Source', 'Medium', 'Campaign', 'Term'",
-                    default: "Source",
-                },
-                utm_source: {
-                    type: "string",
-                    description: "Filter by specific source (e.g., 'google', 'facebook', 'seo')",
-                },
-                utm_medium: {
-                    type: "string",
-                    description: "Filter by medium (e.g., 'organic', 'cpc', 'email')",
-                },
-                utm_campaign: {
-                    type: "string",
-                    description: "Filter by campaign name",
-                },
-                country: {
-                    type: "string",
-                    description: "Filter by country code (e.g., 'us', 'es')",
-                },
-                limit: {
-                    type: "integer",
-                    description: "Maximum number of results to return (default: 100, max: 1000)",
-                    default: 100,
-                },
-                skip: {
-                    type: "integer",
-                    description: "Number of results to skip for pagination",
-                    default: 0,
-                },
-            },
-            required: ["date_range"],
-        },
+    required: ["segment_id"]
+  },
+  handler: async (client, args) => {
+    const segmentId = args.segment_id;
+    return client.request(`/segments/${encodeURIComponent(segmentId)}`, {
+      account_id: resolveSiteId(args)
+    });
+  }
+};
+
+// dist/tools/alerts.js
+var listAlertsTool = {
+  name: "list_alerts",
+  description: "List alert rules configured for a site. Shows rule name, metric, condition, threshold, and status (active/paused). Alerts monitor metrics and trigger notifications when thresholds are crossed.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      include_inactive: {
+        type: "boolean",
+        description: "Include inactive/paused alert rules (default: false)."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestDirect("/alerts/rules", {
+      account_id: resolveSiteId(args),
+      include_inactive: args.include_inactive != null ? String(args.include_inactive) : void 0
+    });
+  }
+};
+var getAlertHistoryTool = {
+  name: "get_alert_history",
+  description: "Get history of triggered alerts: when they fired, current status (active/resolved/acknowledged), and which rule triggered them. Useful for reviewing past incidents.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      rule_id: {
+        type: "number",
+        description: "Filter by specific alert rule ID."
+      },
+      status: {
+        type: "string",
+        description: "Filter by alert status.",
+        enum: ["active", "resolved", "acknowledged"]
+      },
+      limit: LIMIT_SCHEMA,
+      offset: {
+        type: "number",
+        description: "Offset for pagination (default: 0).",
+        default: 0
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestDirect("/alerts/history", {
+      account_id: resolveSiteId(args),
+      rule_id: args.rule_id != null ? String(args.rule_id) : void 0,
+      status: args.status,
+      limit: String(args.limit ?? 50),
+      offset: args.offset != null ? String(args.offset) : void 0
+    });
+  }
+};
+var getAlertStatsTool = {
+  name: "get_alert_stats",
+  description: "Get alert statistics for a site: total rules, active alerts, resolved count, and acknowledgement rate. Provides a quick health overview of the alerting system.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestDirect("/alerts/stats", {
+      account_id: resolveSiteId(args)
+    });
+  }
+};
+
+// dist/tools/webhooks.js
+var listWebhooksTool = {
+  name: "list_webhooks",
+  description: "List webhook endpoints configured for a site. Shows endpoint URL, subscribed event types, and active status. Webhooks send real-time HTTP notifications when events occur.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      include_inactive: {
+        type: "boolean",
+        description: "Include inactive webhook endpoints (default: false)."
+      },
+      limit: LIMIT_SCHEMA,
+      offset: {
+        type: "number",
+        description: "Offset for pagination (default: 0).",
+        default: 0
+      }
+    }
+  },
+  handler: async (client, args) => {
+    return client.requestDirect("/webhooks", {
+      account_id: resolveSiteId(args),
+      include_inactive: args.include_inactive != null ? String(args.include_inactive) : void 0,
+      limit: String(args.limit ?? 50),
+      offset: args.offset != null ? String(args.offset) : void 0
+    });
+  }
+};
+var listWebhookDeliveriesTool = {
+  name: "list_webhook_deliveries",
+  description: "List delivery attempts for a specific webhook endpoint. Shows HTTP status, response time, and success/failure for each delivery. Useful for debugging webhook integration issues.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      endpoint_id: {
+        type: "string",
+        description: "Webhook endpoint UUID."
+      },
+      status: {
+        type: "string",
+        description: "Filter by delivery status.",
+        enum: ["pending", "success", "failed"]
+      },
+      limit: LIMIT_SCHEMA,
+      offset: {
+        type: "number",
+        description: "Offset for pagination (default: 0).",
+        default: 0
+      }
     },
-    {
-        name: "get_conversions",
-        description: "Get conversion/sales data from SealMetrics. Answers questions like 'How many sales this month?' or 'Show conversions from Google Ads yesterday'",
-        inputSchema: {
-            type: "object",
-            properties: {
-                account_id: {
-                    type: "string",
-                    description: "SealMetrics account ID (optional if SEALMETRICS_ACCOUNT_ID is set)",
-                },
-                date_range: {
-                    type: "string",
-                    description: "Date range",
-                },
-                utm_source: {
-                    type: "string",
-                    description: "Filter by specific source",
-                },
-                utm_medium: {
-                    type: "string",
-                    description: "Filter by medium",
-                },
-                utm_campaign: {
-                    type: "string",
-                    description: "Filter by campaign name",
-                },
-                country: {
-                    type: "string",
-                    description: "Filter by country code",
-                },
-                limit: {
-                    type: "integer",
-                    description: "Maximum number of results",
-                    default: 100,
-                },
-                skip: {
-                    type: "integer",
-                    description: "Number of results to skip",
-                    default: 0,
-                },
-            },
-            required: ["date_range"],
-        },
+    required: ["endpoint_id"]
+  },
+  handler: async (client, args) => {
+    const endpointId = args.endpoint_id;
+    return client.requestDirect(`/webhooks/${encodeURIComponent(endpointId)}/deliveries`, {
+      account_id: resolveSiteId(args),
+      status: args.status,
+      limit: String(args.limit ?? 50),
+      offset: args.offset != null ? String(args.offset) : void 0
+    });
+  }
+};
+var getWebhookStatsTool = {
+  name: "get_webhook_stats",
+  description: "Get delivery statistics for a specific webhook endpoint: total deliveries, success rate, average response time, and failure breakdown. Useful for monitoring webhook reliability.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      endpoint_id: {
+        type: "string",
+        description: "Webhook endpoint UUID."
+      },
+      hours: {
+        type: "number",
+        description: "Hours to look back for statistics (1-720, default: 24).",
+        default: 24
+      }
     },
-    {
-        name: "get_microconversions",
-        description: "Get microconversion data (add-to-cart, signups, etc.) from SealMetrics",
-        inputSchema: {
-            type: "object",
-            properties: {
-                account_id: {
-                    type: "string",
-                    description: "SealMetrics account ID",
-                },
-                date_range: {
-                    type: "string",
-                    description: "Date range",
-                },
-                label: {
-                    type: "string",
-                    description: "Filter by microconversion label",
-                },
-                utm_source: {
-                    type: "string",
-                    description: "Filter by source",
-                },
-                utm_medium: {
-                    type: "string",
-                    description: "Filter by medium",
-                },
-                country: {
-                    type: "string",
-                    description: "Filter by country code",
-                },
-                limit: {
-                    type: "integer",
-                    description: "Maximum number of results",
-                    default: 100,
-                },
-                skip: {
-                    type: "integer",
-                    description: "Number of results to skip",
-                    default: 0,
-                },
-            },
-            required: ["date_range"],
-        },
+    required: ["endpoint_id"]
+  },
+  handler: async (client, args) => {
+    const endpointId = args.endpoint_id;
+    return client.requestDirect(`/webhooks/${encodeURIComponent(endpointId)}/stats`, {
+      account_id: resolveSiteId(args),
+      hours: String(args.hours ?? 24)
+    });
+  }
+};
+
+// dist/tools/tracking.js
+var JS_API_REFERENCE = {
+  pageview: {
+    description: "Tracked automatically on load and SPA navigation. Manual call rarely needed.",
+    signatures: [
+      { call: "sealmetrics()", description: "Manual pageview" },
+      {
+        call: "sealmetrics({ group: 'blog' })",
+        description: "Pageview with content grouping"
+      }
+    ]
+  },
+  conversion: {
+    description: "Track conversions with monetary value. Use for purchases, signups, leads.",
+    signatures: [
+      {
+        call: "sealmetrics.conv('purchase', 99.99)",
+        description: "Basic conversion"
+      },
+      {
+        call: "sealmetrics.conv('purchase', 149.99, { currency: 'EUR' })",
+        description: "Conversion with properties"
+      },
+      {
+        call: "sealmetrics.conv('lead', 0, { source: 'contact_form' })",
+        description: "Lead without monetary value"
+      }
+    ]
+  },
+  microconversion: {
+    description: "Track funnel steps and engagement events. Use for add_to_cart, scroll milestones, video plays, newsletter signups.",
+    signatures: [
+      {
+        call: "sealmetrics.micro('add_to_cart')",
+        description: "Basic microconversion"
+      },
+      {
+        call: "sealmetrics.micro('add_to_cart', { product_id: 'SKU-123', price: 49.99 })",
+        description: "Microconversion with properties"
+      }
+    ]
+  }
+};
+var IMPLEMENTATION_GUIDE = {
+  installation: [
+    "Add the <script> tag in the <head> of every page, before </head>.",
+    "Use the 'defer' attribute \u2014 the script loads async and never blocks rendering.",
+    "Pageviews are tracked automatically on load and SPA navigation (pushState, replaceState, popstate).",
+    "No cookies, no localStorage, no consent banner needed (GDPR-friendly)."
+  ],
+  content_grouping: {
+    description: "Categorize pages into sections for better analysis. Add via URL param or JS call.",
+    via_url_param: '<script src="https://t.sealmetrics.com/t.js?id=SITE_ID&group=blog" defer></script>',
+    via_js: "sealmetrics({ group: 'blog' })",
+    recommended_groups: [
+      "blog",
+      "product",
+      "category",
+      "checkout",
+      "docs",
+      "app",
+      "landing",
+      "support"
+    ]
+  },
+  naming_conventions: [
+    "Use snake_case for conversion and microconversion types: 'add_to_cart', not 'addToCart'.",
+    "Use descriptive names: 'begin_checkout', not 'step2'.",
+    "Do NOT include order IDs or user IDs in the type name \u2014 use properties instead.",
+    "Keep types stable \u2014 changing names breaks historical data continuity."
+  ],
+  spa_support: "Automatic. Works with React Router, Vue Router, Next.js, Nuxt, Angular, and any History API-based routing. No extra config.",
+  debugging: "Add ?debug=1 to any page URL to enable console logging of all tracking events."
+};
+var EXAMPLES = {
+  ecommerce: {
+    description: "E-commerce site with product pages, cart, and checkout",
+    code: `<!-- In <head> of all pages -->
+<script src="https://t.sealmetrics.com/t.js?id=SITE_ID&group=product" defer></script>
+
+<script>
+// Add to cart button
+document.querySelector('.add-to-cart').addEventListener('click', function() {
+  sealmetrics.micro('add_to_cart', {
+    product_id: this.dataset.productId,
+    price: parseFloat(this.dataset.price)
+  });
+});
+
+// Begin checkout
+document.querySelector('.checkout-btn').addEventListener('click', function() {
+  sealmetrics.micro('begin_checkout', { cart_value: getCartTotal() });
+});
+</script>
+
+<!-- On thank-you page (group=checkout) -->
+<script src="https://t.sealmetrics.com/t.js?id=SITE_ID&group=checkout" defer></script>
+<script>
+sealmetrics.conv('purchase', 189.99, {
+  currency: 'EUR',
+  payment_method: 'credit_card'
+});
+</script>`
+  },
+  saas: {
+    description: "SaaS / lead generation site",
+    code: `<!-- In <head> -->
+<script src="https://t.sealmetrics.com/t.js?id=SITE_ID&group=marketing" defer></script>
+
+<script>
+// Demo request form
+document.querySelector('#demo-form').addEventListener('submit', function() {
+  sealmetrics.conv('lead', 0, { form_name: 'demo_request' });
+});
+
+// Newsletter signup
+document.querySelector('#newsletter').addEventListener('submit', function() {
+  sealmetrics.micro('newsletter_signup', { position: 'footer' });
+});
+</script>
+
+<!-- On signup success page -->
+<script>
+sealmetrics.conv('signup', 0, { plan: 'trial' });
+</script>
+
+<!-- On upgrade/payment -->
+<script>
+sealmetrics.conv('purchase', 49, { plan: 'pro_monthly', currency: 'USD' });
+</script>`
+  },
+  blog_media: {
+    description: "Blog or media site with content engagement tracking",
+    code: `<!-- In <head> -->
+<script src="https://t.sealmetrics.com/t.js?id=SITE_ID&group=blog" defer></script>
+
+<script>
+// Video engagement
+document.querySelector('video')?.addEventListener('play', function() {
+  sealmetrics.micro('video_play', { video_id: this.dataset.videoId });
+});
+document.querySelector('video')?.addEventListener('ended', function() {
+  sealmetrics.micro('video_complete', { video_id: this.dataset.videoId });
+});
+
+// Scroll depth milestones
+var tracked = {};
+window.addEventListener('scroll', function() {
+  var pct = Math.round(window.scrollY / (document.body.scrollHeight - window.innerHeight) * 100);
+  [25, 50, 75, 100].forEach(function(m) {
+    if (pct >= m && !tracked[m]) {
+      tracked[m] = true;
+      sealmetrics.micro('scroll_' + m);
+    }
+  });
+});
+</script>`
+  },
+  react_nextjs: {
+    description: "React / Next.js application",
+    code: `// In layout.tsx or _app.tsx \u2014 add the script tag
+import Script from 'next/script';
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <head>
+        <Script
+          src="https://t.sealmetrics.com/t.js?id=SITE_ID"
+          strategy="afterInteractive"
+        />
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}
+
+// In any component \u2014 track conversions/microconversions
+function CheckoutButton({ total, currency }) {
+  const handlePurchase = () => {
+    window.sealmetrics?.conv('purchase', total, { currency });
+  };
+  return <button onClick={handlePurchase}>Complete Purchase</button>;
+}
+
+// Track microconversions
+function AddToCartButton({ productId, price }) {
+  const handleClick = () => {
+    window.sealmetrics?.micro('add_to_cart', { product_id: productId, price });
+  };
+  return <button onClick={handleClick}>Add to Cart</button>;
+}`
+  }
+};
+var getTrackingCodeTool = {
+  name: "get_tracking_code",
+  description: "Get the tracking pixel code for a site and the full JavaScript API reference for implementing pageviews, conversions, microconversions, and content grouping. Returns the site-specific <script> tag plus implementation guide with examples for e-commerce, SaaS, blog, and React/Next.js.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      }
+    }
+  },
+  handler: async (client, args) => {
+    const siteId = resolveSiteId(args);
+    const pixel = await client.request(`/sites/${encodeURIComponent(siteId)}/pixel`);
+    return {
+      site_id: pixel.site_id ?? pixel.account_id,
+      script_tag: pixel.script_tag,
+      tracker_url: pixel.tracker_url,
+      js_api: JS_API_REFERENCE,
+      implementation_guide: IMPLEMENTATION_GUIDE,
+      examples: EXAMPLES
+    };
+  }
+};
+
+// dist/tools/properties.js
+var TABLE_SCHEMA = {
+  type: "string",
+  description: 'Table to query: "conversions", "microconversions", "both", or "conversion_items". Default: "both".',
+  enum: ["conversions", "microconversions", "both", "conversion_items"],
+  default: "both"
+};
+var listPropertyKeysTool = {
+  name: "list_property_keys",
+  description: "Get the list of available custom property keys from conversions and/or microconversions. Use this to discover what property keys exist before querying values or breakdowns.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      period: PERIOD_SCHEMA,
+      table: TABLE_SCHEMA
+    }
+  },
+  handler: async (client, args) => {
+    return client.request("/stats/properties/keys", {
+      site_id: resolveSiteId(args),
+      period: args.period ?? "30d",
+      table: args.table ?? "both"
+    });
+  }
+};
+var getPropertyValuesTool = {
+  name: "get_property_values",
+  description: "Get property values with counts, grouped by a UTM parameter. Paginated. Use to see which values a specific property key has and how they distribute across traffic sources.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      property_key: {
+        type: "string",
+        description: "The property key to analyze (e.g. 'product_name', 'plan_type')."
+      },
+      period: PERIOD_SCHEMA,
+      group_by: {
+        type: "string",
+        description: 'Group results by: "utm_source", "utm_medium", "utm_campaign", or "all". Default: "utm_source".',
+        enum: ["utm_source", "utm_medium", "utm_campaign", "all"],
+        default: "utm_source"
+      },
+      table: TABLE_SCHEMA,
+      conversion_type: {
+        type: "string",
+        description: "Filter by conversion type."
+      },
+      limit: LIMIT_SCHEMA,
+      page: PAGE_SCHEMA
     },
-    {
-        name: "get_funnel",
-        description: "Get funnel analysis showing progression through conversion stages",
-        inputSchema: {
-            type: "object",
-            properties: {
-                account_id: {
-                    type: "string",
-                    description: "SealMetrics account ID",
-                },
-                date_range: {
-                    type: "string",
-                    description: "Date range",
-                },
-                report_type: {
-                    type: "string",
-                    description: "Report grouping: 'Source', 'Medium', 'Campaign'",
-                    default: "Source",
-                },
-            },
-            required: ["date_range"],
-        },
+    required: ["property_key"]
+  },
+  handler: async (client, args) => {
+    return client.requestPaginated("/stats/properties/values", {
+      site_id: resolveSiteId(args),
+      property_key: args.property_key,
+      period: args.period ?? "30d",
+      group_by: args.group_by ?? "utm_source",
+      table: args.table ?? "both",
+      conversion_type: args.conversion_type,
+      page_size: String(args.limit ?? 50),
+      page: args.page != null ? String(args.page) : void 0
+    });
+  }
+};
+var getPropertyBreakdownTool = {
+  name: "get_property_breakdown",
+  description: "Get a complete property breakdown with pivot-table style data. Shows all values for a property key with their counts and revenue \u2014 ideal for analyzing product or category performance.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      site_id: {
+        type: "string",
+        description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set."
+      },
+      property_key: {
+        type: "string",
+        description: "The property key to analyze (e.g. 'product_name', 'plan_type')."
+      },
+      period: PERIOD_SCHEMA,
+      table: TABLE_SCHEMA,
+      conversion_type: {
+        type: "string",
+        description: "Filter by conversion type."
+      }
     },
-    {
-        name: "get_roas_evolution",
-        description: "Get ROAS (Return on Ad Spend) evolution over time",
-        inputSchema: {
-            type: "object",
-            properties: {
-                account_id: {
-                    type: "string",
-                    description: "SealMetrics account ID",
-                },
-                date_range: {
-                    type: "string",
-                    description: "Date range",
-                },
-                time_unit: {
-                    type: "string",
-                    description: "Time grouping: 'daily', 'weekly', 'monthly'",
-                    default: "daily",
-                },
-                utm_source: {
-                    type: "string",
-                    description: "Filter by source",
-                },
-                utm_medium: {
-                    type: "string",
-                    description: "Filter by medium",
-                },
-            },
-            required: ["date_range"],
-        },
+    required: ["property_key"]
+  },
+  handler: async (client, args) => {
+    return client.request("/stats/properties/breakdown", {
+      site_id: resolveSiteId(args),
+      property_key: args.property_key,
+      period: args.period ?? "30d",
+      table: args.table ?? "both",
+      conversion_type: args.conversion_type
+    });
+  }
+};
+
+// dist/tools/index.js
+var ALL_TOOLS = [
+  // Sites
+  listSitesTool,
+  getSiteTool,
+  // Overview
+  getOverviewTool,
+  // Traffic
+  getTrafficSourcesTool,
+  getTrafficMediumsTool,
+  getCampaignsTool,
+  getTermsTool,
+  getTopSourcesTool,
+  getTopCampaignsTool,
+  getTopTermsTool,
+  getTopReferrersTool,
+  // Pages & Content
+  getPagesTool,
+  getLandingPagesTool,
+  getTopPagesTool,
+  getTopLandingPagesTool,
+  getLandingPagesByContentGroupTool,
+  getContentGroupsTool,
+  // Conversions
+  getConversionsTool,
+  getMicroconversionsTool,
+  listMicroconversionTypesTool,
+  getMicroconversionDetailsTool,
+  // Conversions — raw event-level (PRD 08)
+  getConversionsRawTool,
+  getMicroconversionsRawTool,
+  getConversionItemsRawTool,
+  // Audience
+  getCountriesTool,
+  getDevicesTool,
+  getDeviceTypesTool,
+  getBrowsersTool,
+  getOperatingSystemsTool,
+  // Channels
+  getChannelsTool,
+  getTopChannelsTool,
+  listChannelRulesTool,
+  // Properties
+  listPropertyKeysTool,
+  getPropertyValuesTool,
+  getPropertyBreakdownTool,
+  // Funnel
+  getFunnelTool,
+  // Bot Detection
+  getBotStatsTool,
+  getSuspiciousSessionsTool,
+  // Segments
+  listSegmentsTool,
+  getSegmentTool,
+  // Alerts
+  listAlertsTool,
+  getAlertHistoryTool,
+  getAlertStatsTool,
+  // Webhooks
+  listWebhooksTool,
+  listWebhookDeliveriesTool,
+  getWebhookStatsTool,
+  // Tracking
+  getTrackingCodeTool
+];
+
+// ../setup-core/dist/detect/index.js
+import { existsSync as existsSync2, readFileSync, readdirSync } from "node:fs";
+import { join as join2 } from "node:path";
+
+// ../setup-core/dist/detect/cms.js
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+function detectPlatform(cwd) {
+  const has = (...rel) => rel.some((r) => existsSync(join(cwd, r)));
+  if (has("wp-config.php", "wp-content")) {
+    if (has("wp-content/plugins/woocommerce", "wp-content/plugins/woocommerce/woocommerce.php")) {
+      return "woocommerce";
+    }
+    return "wordpress";
+  }
+  if (has("config/settings.inc.php", "app/config/parameters.php") && has("prestashop", "classes/PrestaShopAutoload.php")) {
+    return "prestashop";
+  }
+  if (has("classes/PrestaShopAutoload.php"))
+    return "prestashop";
+  if (has("bin/magento", "app/etc/env.php") && has("app/etc/di.xml", "vendor/magento")) {
+    return "magento2";
+  }
+  if (has("bin/magento"))
+    return "magento2";
+  if (has("core/lib/Drupal.php"))
+    return "drupal";
+  if (has("configuration.php") && has("libraries/joomla", "administrator/manifests")) {
+    return "joomla";
+  }
+  if (has("system/startup.php") && has("catalog/controller"))
+    return "opencart";
+  return void 0;
+}
+
+// ../setup-core/dist/detect/index.js
+var LOCATIONS = {
+  "next-app": {
+    location: "app/layout.tsx",
+    hint: "inside <head>, or via a next/script <Script> component",
+    strategy: "next-app-router-layout"
+  },
+  "next-pages": {
+    location: "pages/_document.tsx",
+    hint: "inside <Head> in _document (or pages/_app.tsx)",
+    strategy: "next-pages-document"
+  },
+  astro: {
+    location: "src/layouts/Layout.astro",
+    hint: "inside <head> of your root layout",
+    strategy: "astro-layout-head"
+  },
+  remix: {
+    location: "app/root.tsx",
+    hint: "inside the <head> region of the root route",
+    strategy: "remix-root-head"
+  },
+  nuxt: {
+    location: "nuxt.config.ts",
+    hint: "in app.head.script (or app.vue <head>)",
+    strategy: "nuxt-config-head"
+  },
+  sveltekit: {
+    location: "src/app.html",
+    hint: "inside <head>, above %sveltekit.head%",
+    strategy: "sveltekit-app-html"
+  },
+  vite: {
+    location: "index.html",
+    hint: "just before </head>",
+    strategy: "vite-index-html"
+  },
+  html: {
+    location: "index.html",
+    hint: "just before </head>",
+    strategy: "static-html-head"
+  },
+  unknown: {
+    location: "your site's root HTML / <head>",
+    hint: "just before the closing </head> tag on every page",
+    strategy: "manual"
+  }
+};
+function detect(cwd, opts) {
+  if (opts?.noInject) {
+    return makeDetection("unknown", { provisionOnly: true });
+  }
+  const platform = detectPlatform(cwd);
+  if (platform) {
+    return makeDetection("unknown", { platform, provisionOnly: false });
+  }
+  const pkg = readPackageJson(cwd);
+  if (pkg) {
+    const fw = detectFromPackageJson(cwd, pkg);
+    return makeDetection(fw, { provisionOnly: false });
+  }
+  if (findIndexHtml(cwd)) {
+    return makeDetection("html", { provisionOnly: false });
+  }
+  if (isEmptyish(cwd)) {
+    return makeDetection("unknown", { provisionOnly: true });
+  }
+  return makeDetection("unknown", { provisionOnly: false });
+}
+var detectFramework = detect;
+function detectFromPackageJson(cwd, pkg) {
+  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+  const has = (name) => Object.prototype.hasOwnProperty.call(deps, name);
+  if (has("next")) {
+    return hasAppRouter(cwd) ? "next-app" : "next-pages";
+  }
+  if (has("astro"))
+    return "astro";
+  if (has("@remix-run/react") || has("@remix-run/node") || has("@remix-run/serve"))
+    return "remix";
+  if (has("nuxt") || has("nuxt3") || has("nuxt-edge"))
+    return "nuxt";
+  if (has("@sveltejs/kit"))
+    return "sveltekit";
+  if (has("vite"))
+    return "vite";
+  if (findIndexHtml(cwd))
+    return "html";
+  return "unknown";
+}
+function hasAppRouter(cwd) {
+  const appDirs = ["app", "src/app"];
+  const pagesDirs = ["pages", "src/pages"];
+  const hasApp = appDirs.some((d) => existsSync2(join2(cwd, d)));
+  const hasPages = pagesDirs.some((d) => existsSync2(join2(cwd, d)));
+  if (hasApp)
+    return true;
+  if (hasPages)
+    return false;
+  return true;
+}
+function readPackageJson(cwd) {
+  const p = join2(cwd, "package.json");
+  if (!existsSync2(p))
+    return null;
+  try {
+    return JSON.parse(readFileSync(p, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function findIndexHtml(cwd) {
+  return ["index.html", "public/index.html", "src/index.html"].some((f) => existsSync2(join2(cwd, f)));
+}
+function isEmptyish(cwd) {
+  try {
+    const entries = readdirSync(cwd).filter((e) => !e.startsWith(".") && e !== "seal.config.json");
+    return entries.length === 0;
+  } catch {
+    return true;
+  }
+}
+function makeDetection(framework, extra) {
+  const loc = LOCATIONS[framework];
+  const detection = {
+    framework,
+    strategy: extra.platform ? `cms-plugin-${extra.platform}` : loc.strategy,
+    recommendedLocation: loc.location,
+    placementHint: loc.hint,
+    provisionOnly: extra.provisionOnly
+  };
+  if (extra.platform)
+    detection.platform = extra.platform;
+  return detection;
+}
+
+// ../setup-core/dist/provision.js
+var DEFAULT_TIMEOUT_MS2 = 3e4;
+var ProvisionError = class extends Error {
+  code;
+  httpStatus;
+  retryAfter;
+  detail;
+  constructor(code, message, opts) {
+    super(message);
+    this.name = "ProvisionError";
+    this.code = code;
+    this.httpStatus = opts?.httpStatus;
+    this.retryAfter = opts?.retryAfter;
+    this.detail = opts?.detail;
+  }
+};
+var PixelStatusError = class extends Error {
+  httpStatus;
+  detail;
+  constructor(message, opts) {
+    super(message);
+    this.name = "PixelStatusError";
+    this.httpStatus = opts?.httpStatus;
+    this.detail = opts?.detail;
+  }
+};
+function normalizeBaseUrl(baseUrl) {
+  return baseUrl.replace(/\/+$/, "");
+}
+function buildProvisionBody(input) {
+  return {
+    site_name: input.siteName,
+    domain: input.domain,
+    email: input.email,
+    name: input.name,
+    accept_terms: true,
+    install_source: input.installSource,
+    timezone: input.timezone
+  };
+}
+function provisionErrorForStatus(status, opts) {
+  if (status === 401) {
+    return new ProvisionError("AUTH_REQUIRED", "The provision key was rejected (invalid or revoked).", {
+      httpStatus: 401
+    });
+  }
+  if (status === 409) {
+    return new ProvisionError("EMAIL_EXISTS", "An account already exists for this email.", {
+      httpStatus: 409
+    });
+  }
+  if (status === 429) {
+    return new ProvisionError("RATE_LIMITED", "Provisioning is rate-limited. Please wait and retry.", {
+      httpStatus: 429,
+      retryAfter: opts?.retryAfter
+    });
+  }
+  if (status === 503) {
+    return new ProvisionError("PROVISIONING_DISABLED", "Provisioning is currently disabled on the server.", {
+      httpStatus: 503
+    });
+  }
+  return new ProvisionError("BACKEND_ERROR", `Provisioning failed (HTTP ${status}).`, {
+    httpStatus: status,
+    detail: opts?.detail
+  });
+}
+function unwrapProvisionData(json) {
+  const data = json?.data;
+  if (!data || !data.account_id || !data.api_key) {
+    throw new ProvisionError("BAD_RESPONSE", "Provisioning returned an unexpected response.", {
+      httpStatus: 200
+    });
+  }
+  return data;
+}
+async function fetchWithTimeout(fetchImpl, url, init, timeoutMs) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    return await fetchImpl(url, { ...init, signal: controller.signal });
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function safeText(res) {
+  try {
+    return await res.text();
+  } catch {
+    return "";
+  }
+}
+async function fetchPixelStatus(accountId, options) {
+  const baseUrl = normalizeBaseUrl(options.baseUrl);
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
+  const url = `${baseUrl}/sites/${encodeURIComponent(accountId)}/pixel/status`;
+  let res;
+  try {
+    res = await fetchWithTimeout(fetchImpl, url, { method: "GET", headers: { "X-API-Key": options.apiKey, Accept: "application/json" } }, timeoutMs);
+  } catch (e) {
+    throw new PixelStatusError("Could not reach the SealMetrics API.", {
+      detail: e instanceof Error ? e.message : void 0
+    });
+  }
+  if (res.status !== 200) {
+    const detail = await safeText(res);
+    throw new PixelStatusError(`Pixel status check failed (HTTP ${res.status}).`, {
+      httpStatus: res.status,
+      detail: detail.slice(0, 200) || void 0
+    });
+  }
+  const text = await res.text();
+  let json;
+  try {
+    json = JSON.parse(text);
+  } catch {
+    throw new PixelStatusError("Pixel status returned invalid JSON.");
+  }
+  const data = json.data;
+  if (!data || typeof data.installed !== "boolean") {
+    throw new PixelStatusError("Pixel status returned an unexpected response.");
+  }
+  return data;
+}
+
+// ../setup-core/dist/verify.js
+var defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function pollPixelStatus(opts) {
+  if (opts.timeoutMs <= 0) {
+    return { verified: null };
+  }
+  const now = opts.now ?? (() => Date.now());
+  const sleep3 = opts.sleep ?? defaultSleep;
+  const deadline = now() + opts.timeoutMs;
+  let interval = opts.intervalMs ?? 3e3;
+  const maxInterval = opts.maxIntervalMs ?? 1e4;
+  for (; ; ) {
+    let installed = false;
+    let totalHits = 0;
+    try {
+      const status = await opts.fetchStatus();
+      installed = status.installed;
+      totalHits = status.total_hits;
+    } catch (e) {
+      opts.onError?.(e);
+    }
+    if (installed) {
+      return { verified: true, totalHits };
+    }
+    if (now() + interval >= deadline) {
+      return { verified: false, totalHits };
+    }
+    await sleep3(interval);
+    interval = Math.min(Math.floor(interval * 1.5), maxInterval);
+  }
+}
+
+// ../setup-core/dist/generated/guide.js
+var INSTRUMENTATION_GUIDE = "# SealMetrics Implementation Prompt for AI Assistants\n\nUse this prompt with Lovable, Cursor, Claude, or any AI assistant to implement SealMetrics tracking in your project.\n\n---\n\n## Prompt to copy:\n\n```\nI need you to implement SealMetrics analytics tracking in my project. SealMetrics is a privacy-first, cookieless analytics platform.\n\n## Account Configuration\n- Account ID: [YOUR_ACCOUNT_ID]\n- Pixel URL: https://t.sealmetrics.com\n\n## Base Tracker Installation\n\nAdd this script to the <head> of ALL pages:\n\n```html\n<script src=\"https://t.sealmetrics.com/t.js?id=[YOUR_ACCOUNT_ID]\" defer></script>\n```\n\nFor content grouping, add the `group` parameter:\n```html\n<script src=\"https://t.sealmetrics.com/t.js?id=[YOUR_ACCOUNT_ID]&group=home\" defer></script>\n```\n\n## Pages to Track with Content Groups\n\nImplement these content groups based on page type:\n\n| Page Type | Content Group | Example URL |\n|-----------|---------------|-------------|\n| Home page | `home` | `/`, `/home` |\n| Product pages | `product` | `/products/*, /product/*` |\n| Category/Catalog | `catalog` | `/category/*, /shop/*` |\n| Blog posts | `blog` | `/blog/*, /articles/*` |\n| Blog index | `blog-index` | `/blog`, `/articles` |\n| About page | `about` | `/about`, `/about-us` |\n| Contact page | `contact` | `/contact` |\n| Pricing page | `pricing` | `/pricing`, `/plans` |\n| Services | `service` | `/services/*` |\n| Portfolio/Work | `portfolio` | `/portfolio/*, /work/*` |\n| Cart | `cart` | `/cart` |\n| Checkout | `checkout` | `/checkout` |\n| Thank you/Success | `thankyou` | `/thank-you`, `/order-confirmation` |\n| Account/Dashboard | `account` | `/account/*, /dashboard/*` |\n| Legal pages | `legal` | `/privacy`, `/terms` |\n| 404 page | `404` | (any 404) |\n| Search results | `search` | `/search` |\n\n## Events to Track\n\n### 1. Microconversions (Engagement Events)\n\nUse `sealmetrics.micro(eventName, properties)` for:\n\n```javascript\n// Form submissions (contact forms)\nsealmetrics.micro('form_submit', {\n  form_name: 'contact_form',\n  form_type: 'contact'\n});\n\n// Newsletter signups\nsealmetrics.micro('newsletter_signup', {\n  form_location: 'footer' // or 'popup', 'hero', 'sidebar'\n});\n\n// Add to cart (e-commerce)\nsealmetrics.micro('add_to_cart', {\n  product_name: 'Product Name',\n  product_id: '123',\n  price: '99.99',\n  currency: 'EUR',\n  quantity: '1'\n});\n\n// Product views (e-commerce)\nsealmetrics.micro('view_item', {\n  product_name: 'Product Name',\n  product_id: '123',\n  sku: 'SKU-123',\n  price: '99.99',\n  currency: 'EUR',\n  category: 'Category Name',\n  brand: 'Brand Name'\n});\n\n// Begin checkout\nsealmetrics.micro('begin_checkout', {\n  cart_total: '199.99',\n  currency: 'EUR',\n  items_count: '3'\n});\n\n// CTA button clicks\nsealmetrics.micro('cta_click', {\n  button_text: 'Get Started',\n  button_location: 'hero'\n});\n\n// Video engagement\nsealmetrics.micro('video_play', { video_id: 'intro' });\nsealmetrics.micro('video_complete', { video_id: 'intro' });\n\n// Scroll depth\nsealmetrics.micro('scroll_50'); // 50% scroll\nsealmetrics.micro('scroll_100'); // 100% scroll\n\n// File downloads\nsealmetrics.micro('file_download', {\n  file_name: 'brochure.pdf'\n});\n\n// Search\nsealmetrics.micro('search', {\n  query: 'search term',\n  results: '15'\n});\n\n// 404 errors\nsealmetrics.micro('404_error', {\n  url: '/broken-link'\n});\n```\n\n### 2. Conversions (Revenue Events)\n\nUse `sealmetrics.conv(eventName, value, properties)` for:\n\n```javascript\n// Purchase (e-commerce)\nsealmetrics.conv('purchase', 149.99, {\n  currency: 'EUR',\n  payment_method: 'credit_card',\n  items: [\n    {\n      product_name: 'Product 1',\n      product_id: '123',\n      price: '99.99',\n      quantity: '1',\n      category: 'Category',\n      brand: 'Brand'\n    }\n  ]\n});\n\n// Lead generation (contact form that generates business)\nsealmetrics.conv('lead', 0, {\n  source: 'contact_form',\n  form_name: 'request_quote'\n});\n\n// Signup/Registration\nsealmetrics.conv('signup', 0, {\n  plan: 'free' // or 'trial', 'premium'\n});\n\n// Subscription\nsealmetrics.conv('subscription', 29.99, {\n  plan: 'pro_monthly',\n  currency: 'EUR'\n});\n\n// Booking/Appointment\nsealmetrics.conv('booking', 0, {\n  service: 'consultation',\n  date: '2025-01-15'\n});\n```\n\n## Implementation by Business Type\n\n### SaaS / Software\n```javascript\n// Pricing page view\n// group=pricing\n\n// Free trial signup\nsealmetrics.conv('signup', 0, { plan: 'trial' });\n\n// Paid subscription\nsealmetrics.conv('subscription', 49, {\n  plan: 'pro_monthly',\n  currency: 'USD'\n});\n\n// Feature usage (optional)\nsealmetrics.micro('feature_use', { feature: 'export' });\n```\n\n### E-commerce\n```javascript\n// Product view\nsealmetrics.micro('view_item', { /* product data */ });\n\n// Add to cart\nsealmetrics.micro('add_to_cart', { /* product data */ });\n\n// Begin checkout\nsealmetrics.micro('begin_checkout', { /* cart data */ });\n\n// Purchase\nsealmetrics.conv('purchase', total, { /* order data */ });\n```\n\n### Lead Generation / Services\n```javascript\n// Contact form submission\nsealmetrics.conv('lead', 0, {\n  source: 'contact_form',\n  service_interest: 'consulting'\n});\n\n// Quote request\nsealmetrics.conv('lead', 0, {\n  source: 'quote_form',\n  project_type: 'website_redesign'\n});\n\n// Newsletter (not a lead, just engagement)\nsealmetrics.micro('newsletter_signup', {\n  form_location: 'footer'\n});\n```\n\n### Blog / Content\n```javascript\n// Article engagement\nsealmetrics.micro('article_read', {\n  article_title: 'Article Title',\n  category: 'Marketing'\n});\n\n// Newsletter signup\nsealmetrics.micro('newsletter_signup');\n\n// Content download\nsealmetrics.micro('file_download', {\n  file_name: 'ebook.pdf',\n  file_type: 'ebook'\n});\n```\n\n### Booking / Appointments\n```javascript\n// Booking completed\nsealmetrics.conv('booking', 0, {\n  service: 'haircut',\n  date: '2025-01-20',\n  time: '14:00'\n});\n\n// Or with value\nsealmetrics.conv('booking', 50, {\n  service: 'consultation',\n  currency: 'EUR'\n});\n```\n\n## Important Rules\n\n1. **NEVER include personal data**: No names, emails, phone numbers, addresses\n2. **NEVER include order IDs**: No transaction IDs, order numbers, invoice numbers\n3. **NEVER include user IDs**: No customer IDs, user identifiers\n4. **DO include**: Event types, product names, categories, prices, currencies, counts\n5. **Privacy first**: SealMetrics is cookieless and GDPR compliant by design\n\n## Form Tracking Helper\n\nFor tracking forms, use this pattern:\n\n```javascript\ndocument.querySelectorAll('form').forEach(function(form) {\n  form.addEventListener('submit', function(e) {\n    var formName = form.id || form.dataset.name || 'unknown_form';\n    var isNewsletter = form.classList.contains('newsletter') ||\n                       form.querySelector('input[name*=\"newsletter\"]') ||\n                       formName.toLowerCase().includes('newsletter');\n\n    if (isNewsletter) {\n      sealmetrics.micro('newsletter_signup', {\n        form_location: form.dataset.location || 'page'\n      });\n    } else {\n      // Contact/lead form - use conversion\n      sealmetrics.conv('lead', 0, {\n        source: 'contact_form',\n        form_name: formName\n      });\n    }\n  });\n});\n```\n\n## Framework-Specific Implementation\n\n### React/Next.js\n```jsx\n// In layout or _app\nimport Script from 'next/script';\n\n<Script\n  src=\"https://t.sealmetrics.com/t.js?id=[YOUR_ACCOUNT_ID]\"\n  strategy=\"afterInteractive\"\n/>\n\n// Track events\nconst trackEvent = () => {\n  if (typeof sealmetrics !== 'undefined') {\n    sealmetrics.micro('event_name', { prop: 'value' });\n  }\n};\n```\n\n### Vue/Nuxt\n```javascript\n// In nuxt.config.js or main.js\nhead: {\n  script: [\n    {\n      src: 'https://t.sealmetrics.com/t.js?id=[YOUR_ACCOUNT_ID]',\n      defer: true\n    }\n  ]\n}\n\n// Track events\nmethods: {\n  trackEvent() {\n    if (typeof sealmetrics !== 'undefined') {\n      sealmetrics.micro('event_name', { prop: 'value' });\n    }\n  }\n}\n```\n\n### Plain HTML/JavaScript\n```html\n<script src=\"https://t.sealmetrics.com/t.js?id=[YOUR_ACCOUNT_ID]\" defer></script>\n\n<script>\ndocument.addEventListener('DOMContentLoaded', function() {\n  // Your tracking code here\n});\n</script>\n```\n\nPlease implement these tracking calls in the appropriate places in my codebase, ensuring all business-critical user actions are tracked while maintaining user privacy.\n```\n\n---\n\n## Quick Reference Card\n\n### Content Groups\n- `home`, `product`, `catalog`, `blog`, `about`, `contact`, `pricing`, `service`, `portfolio`, `cart`, `checkout`, `thankyou`, `account`, `legal`, `404`, `search`\n\n### Microconversions (sealmetrics.micro)\n- `view_item`, `add_to_cart`, `begin_checkout`, `form_submit`, `newsletter_signup`, `cta_click`, `video_play`, `video_complete`, `scroll_50`, `scroll_100`, `file_download`, `search`, `404_error`\n\n### Conversions (sealmetrics.conv)\n- `purchase`, `lead`, `signup`, `subscription`, `booking`\n\n### Never Track\n- Order IDs, User IDs, Email addresses, Phone numbers, Personal names, Transaction IDs\n";
+
+// ../setup-core/dist/guide.js
+var PRIVACY_BANNER = `> \u26A0\uFE0F **PRIVACY \u2014 READ FIRST.** Never pass personal data (names, emails, phones,
+> addresses), order/transaction/invoice IDs, or user/customer IDs to any event.
+> Track only event types, product names, categories, prices, currencies and
+> counts. SealMetrics is cookieless and GDPR-compliant by design.
+
+`;
+function buildInstrumentationMarkdown(accountId) {
+  const substituted = INSTRUMENTATION_GUIDE.split("[YOUR_ACCOUNT_ID]").join(accountId);
+  return `# SealMetrics event instrumentation guide
+
+Account ID: \`${accountId}\`
+
+` + PRIVACY_BANNER + `This guide is the authoritative API + taxonomy for instrumenting business
+events. The CLI does **not** write these calls for you (that is a separate,
+optional step); use this when you ask your agent to add conversions/events.
+
+---
+
+` + substituted;
+}
+var getInstrumentationGuide = buildInstrumentationMarkdown;
+
+// ../setup-core/dist/instrument.js
+var CONV_TYPES = ["purchase", "lead", "signup", "subscription", "booking"];
+var MICRO_TYPES = [
+  "view_item",
+  "add_to_cart",
+  "begin_checkout",
+  "form_submit",
+  "newsletter_signup",
+  "cta_click",
+  "video_play",
+  "video_complete",
+  "scroll_50",
+  "scroll_100",
+  "file_download",
+  "search",
+  "404_error",
+  "article_read",
+  "feature_use"
+];
+function validateEventName(kind, name) {
+  const known = kind === "conv" ? CONV_TYPES : MICRO_TYPES;
+  const normalized = String(name ?? "").trim().toLowerCase();
+  if (known.includes(normalized)) {
+    return { valid: true };
+  }
+  return { valid: false, suggestion: closest(normalized, known) };
+}
+function closest(name, candidates) {
+  let best;
+  let bestScore = Infinity;
+  for (const c of candidates) {
+    const d = levenshtein(name, c);
+    if (d < bestScore) {
+      bestScore = d;
+      best = c;
+    }
+  }
+  return best !== void 0 && bestScore <= Math.max(3, Math.floor(name.length / 2)) ? best : void 0;
+}
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  if (m === 0)
+    return n;
+  if (n === 0)
+    return m;
+  const row = Array.from({ length: n + 1 }, (_, i) => i);
+  for (let i = 1; i <= m; i++) {
+    let prev = row[0];
+    row[0] = i;
+    for (let j = 1; j <= n; j++) {
+      const tmp = row[j];
+      row[j] = Math.min(row[j] + 1, row[j - 1] + 1, prev + (a[i - 1] === b[j - 1] ? 0 : 1));
+      prev = tmp;
+    }
+  }
+  return row[n];
+}
+var FORBIDDEN_KEY_PATTERNS = [
+  /(^|_)e?mail($|_)/i,
+  /(^|_)phone($|_)/i,
+  /(^|_)tel($|_)/i,
+  /^name$/i,
+  // a bare `name` is almost always a person's name
+  /(^|_)(first|last|full|given|sur|customer|user|client|member|contact|company)_?name($|_)/i,
+  /(^|_)address($|_)/i,
+  // ip_address, billing_address, email_address…
+  /(^|_)(order|transaction|invoice|receipt)_?(id|no|number|num)($|_)/i,
+  // id/number REQUIRED
+  /(^|_)(user|customer|client|member|account)_?id($|_)/i,
+  /\buid\b/i,
+  /(^|_)ssn($|_)/i,
+  /(^|_)dob($|_)/i,
+  /(^|_)ip($|_)/i
+];
+var EMAIL_RE = /[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/i;
+var PHONE_RE = /(?:\+?\d[\s\-().]?){9,}/;
+function detectPII(properties) {
+  if (!properties || typeof properties !== "object")
+    return [];
+  const findings = [];
+  for (const [key, value] of Object.entries(properties)) {
+    if (FORBIDDEN_KEY_PATTERNS.some((re) => re.test(key))) {
+      findings.push({ key, reason: "forbidden_key" });
+      continue;
+    }
+    if (typeof value === "string") {
+      if (EMAIL_RE.test(value)) {
+        findings.push({ key, reason: "email_value" });
+      } else if (PHONE_RE.test(value)) {
+        findings.push({ key, reason: "phone_value" });
+      }
+    }
+  }
+  return findings;
+}
+function checkInstrumentation(kind, name, properties) {
+  const taxonomy = validateEventName(kind, name);
+  const pii = detectPII(properties);
+  return { ok: taxonomy.valid && pii.length === 0, taxonomy, pii };
+}
+
+// ../setup-core/dist/stack-guide.js
+var COMMON_NOTES = [
+  "Load the snippet returned by POST /provision as-is \u2014 it is already async/defer-safe; do not block rendering.",
+  "Place it once, as high in <head> as possible, so it loads on every page (not per-route).",
+  "SPA / client-side routing: the tracker auto-tracks History API navigations (pushState/replaceState) \u2014 you do NOT need to fire a manual pageview on route change. Verify a route change produces a new pageview before adding any manual call.",
+  "Content grouping: add the `group` parameter (or call the AUTO mode documented in docs/TRACKER.md) to bucket pages; never hardcode per-page groups in the snippet itself."
+];
+var STACK_GUIDES = {
+  "next-app": {
+    framework: "next-app",
+    location: "app/layout.tsx",
+    placement: 'inside <head> of the root layout, or via a next/script <Script strategy="afterInteractive"> component',
+    notes: [
+      "App Router: put the snippet in the root app/layout.tsx so it covers every route segment.",
+      'Prefer next/script with strategy="afterInteractive" for the external script tag; keep the inline init in <head>.',
+      "Do NOT place it in a single page.tsx \u2014 that would only load on that route.",
+      ...COMMON_NOTES
+    ]
+  },
+  "next-pages": {
+    framework: "next-pages",
+    location: "pages/_document.tsx",
+    placement: "inside <Head> in _document.tsx (covers every page), or pages/_app.tsx with next/script",
+    notes: [
+      "Pages Router: _document.tsx renders once per page on the server \u2014 the snippet belongs in its <Head>.",
+      "Alternatively use next/script in pages/_app.tsx so it mounts on every route.",
+      ...COMMON_NOTES
+    ]
+  },
+  astro: {
+    framework: "astro",
+    location: "src/layouts/Layout.astro",
+    placement: "inside <head> of your root layout component",
+    notes: [
+      "Add it to the shared root layout that every page imports, not to individual .astro pages.",
+      "Astro ships zero JS by default \u2014 the snippet is plain <script>, so it runs as written.",
+      ...COMMON_NOTES
+    ]
+  },
+  remix: {
+    framework: "remix",
+    location: "app/root.tsx",
+    placement: "inside the <head> region of the root route (the <Links/>/<Meta/> area)",
+    notes: [
+      "app/root.tsx wraps every route \u2014 place the snippet in its <head> so it loads globally.",
+      ...COMMON_NOTES
+    ]
+  },
+  nuxt: {
+    framework: "nuxt",
+    location: "nuxt.config.ts",
+    placement: "in app.head.script (or a <head> block in app.vue)",
+    notes: [
+      "Use app.head.script in nuxt.config.ts so Nuxt injects the tag on every page.",
+      "Keep `src` async; do not import it as a module.",
+      ...COMMON_NOTES
+    ]
+  },
+  sveltekit: {
+    framework: "sveltekit",
+    location: "src/app.html",
+    placement: "inside <head>, above %sveltekit.head%",
+    notes: [
+      "src/app.html is the single HTML shell for the whole app \u2014 the snippet belongs in its <head>.",
+      "Placing it above %sveltekit.head% guarantees it loads before route components.",
+      ...COMMON_NOTES
+    ]
+  },
+  vite: {
+    framework: "vite",
+    location: "index.html",
+    placement: "just before </head> in the project root index.html",
+    notes: [
+      "Vite serves index.html as the entry \u2014 add the snippet to its <head> directly.",
+      ...COMMON_NOTES
+    ]
+  },
+  html: {
+    framework: "html",
+    location: "index.html",
+    placement: "just before </head> on every page",
+    notes: [
+      "Static site: add the snippet to the <head> of every HTML page (or your shared header include/partial).",
+      ...COMMON_NOTES
+    ]
+  },
+  unknown: {
+    framework: "unknown",
+    location: "your site's root HTML / <head>",
+    placement: "just before the closing </head> tag on every page",
+    notes: [
+      "Stack not auto-detected: place the snippet in the <head> of every page via whatever shared template/layout your site uses.",
+      ...COMMON_NOTES
+    ]
+  }
+};
+function getStackGuide(framework) {
+  return STACK_GUIDES[framework] ?? STACK_GUIDES.unknown;
+}
+function getPlatformPluginGuide(platform, accountId) {
+  const product = {
+    wordpress: "SealMetrics for WordPress plugin",
+    woocommerce: "SealMetrics for WooCommerce plugin",
+    prestashop: "SealMetrics PrestaShop module",
+    magento2: "SealMetrics Magento 2 extension",
+    drupal: "SealMetrics Drupal module",
+    joomla: "SealMetrics Joomla plugin",
+    opencart: "SealMetrics OpenCart extension"
+  };
+  return `Install the official ${product[platform]} (see integrations/sealmetrics-${platform}.zip), then paste your account_id \`${accountId}\` into its settings. Do not edit theme/PHP files or paste the raw <script> snippet \u2014 the plugin injects the tracker correctly.`;
+}
+
+// dist/tools/setup.js
+var TOS_URL = "https://sealmetrics.com/terms";
+function str(v) {
+  if (v === void 0 || v === null)
+    return void 0;
+  const s = String(v).trim();
+  return s.length > 0 ? s : void 0;
+}
+function createSetupTools(ctx) {
+  const provisionSite = {
+    name: "provision_site",
+    description: "Register a NEW free SealMetrics site from the chat (no terminal needed). Creates the account, returns the tracker snippet to place in your site's <head>, and emails you a claim link to set a password. After this succeeds, the read-only analytics tools are enabled in this session. Does NOT edit your code \u2014 you (or the agent, if it has the repo) place the snippet.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        site_name: { type: "string", description: "Human-friendly name for the site (e.g. 'My Shop')." },
+        domain: { type: "string", description: "Primary domain of the site (e.g. 'myshop.com'). Optional." },
+        email: { type: "string", description: "Your email \u2014 receives the claim link to set a password." },
+        name: { type: "string", description: "Your name. Optional." },
+        accept_terms: {
+          type: "boolean",
+          description: "Must be true: confirms the user has read and accepts the SealMetrics Terms of Service (https://sealmetrics.com/terms). Show the user this link first; do NOT accept on their behalf."
+        }
+      },
+      required: ["site_name", "email", "accept_terms"]
     },
-    {
-        name: "get_pages",
-        description: "Get page performance metrics including views and entry pages",
-        inputSchema: {
-            type: "object",
-            properties: {
-                account_id: {
-                    type: "string",
-                    description: "SealMetrics account ID",
-                },
-                date_range: {
-                    type: "string",
-                    description: "Date range",
-                },
-                content_grouping: {
-                    type: "string",
-                    description: "Filter by content group name",
-                },
-                utm_source: {
-                    type: "string",
-                    description: "Filter by traffic source",
-                },
-                utm_medium: {
-                    type: "string",
-                    description: "Filter by medium",
-                },
-                country: {
-                    type: "string",
-                    description: "Filter by country code",
-                },
-                show_utms: {
-                    type: "boolean",
-                    description: "Include UTM breakdown in results",
-                    default: false,
-                },
-                limit: {
-                    type: "integer",
-                    description: "Maximum number of results",
-                    default: 100,
-                },
-                skip: {
-                    type: "integer",
-                    description: "Number of results to skip",
-                    default: 0,
-                },
-            },
-            required: ["date_range"],
+    annotations: { title: "Provision a SealMetrics site", readOnlyHint: false, openWorldHint: true },
+    handler: async (args) => {
+      if (args.accept_terms !== true && args.accept_terms !== "true") {
+        throw new Error(`accept_terms must be true. Show the user the SealMetrics Terms of Service (${TOS_URL}) and ask them to confirm \u2014 do not accept on their behalf.`);
+      }
+      const siteName = str(args.site_name);
+      const email = str(args.email);
+      if (!siteName)
+        throw new Error("site_name is required.");
+      if (!email)
+        throw new Error("email is required.");
+      const input = {
+        siteName,
+        domain: str(args.domain),
+        email,
+        name: str(args.name),
+        installSource: ctx.installSource
+        // "mcp" — attribution (RF-3205/RF-3604)
+      };
+      let envelope;
+      try {
+        envelope = await ctx.client.post("/provision", buildProvisionBody(input), {
+          provisionKey: ctx.provisionKey
+        });
+      } catch (e) {
+        if (e instanceof SealMetricsAPIError) {
+          const pe = provisionErrorForStatus(e.statusCode);
+          throw new Error(`${pe.code}: ${pe.message}`);
+        }
+        throw e;
+      }
+      const result = unwrapProvisionData(envelope);
+      ctx.onProvisioned(result.api_key, result.account_id);
+      ctx.state.provisioned = true;
+      ctx.state.accountId = result.account_id;
+      return {
+        account_id: result.account_id,
+        snippet: result.snippet,
+        dashboard_url: result.dashboard_url,
+        claim_email_sent_to: email,
+        free_quota: result.free_quota,
+        next_steps: [
+          "Place the snippet in your site's <head> on every page. If the agent has your repo it can do this; otherwise paste it yourself.",
+          "Run verify_setup once the snippet is live to confirm the pixel is sending data.",
+          "Read-only analytics tools are now enabled in THIS session.",
+          "To keep them after restarting Claude Desktop, paste the api_key from your welcome email into the SEALMETRICS_API_KEY field of the extension settings.",
+          "Check your email to claim the account (set a password) \u2014 this unlocks the web dashboard. Analytics work without it."
+        ]
+      };
+    }
+  };
+  const verifySetup = {
+    name: "verify_setup",
+    description: "Poll until the SealMetrics pixel is confirmed installed (a real pageview has reached the backend) or it times out. Run this after placing the snippet. Reads only \u2014 sends no data.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        account_id: {
+          type: "string",
+          description: "Site/account id to verify. Defaults to the site provisioned in this session."
         },
+        timeout_seconds: {
+          type: "number",
+          description: "Max seconds to wait for the first hit (default 25)."
+        }
+      }
     },
-    {
-        name: "generate_pixel",
-        description: "Generate a SealMetrics tracking pixel for conversions or microconversions, ready for Google Tag Manager",
-        inputSchema: {
-            type: "object",
-            properties: {
-                account_id: {
-                    type: "string",
-                    description: "Your SealMetrics account ID",
-                },
-                event_type: {
-                    type: "string",
-                    description: "Event type: 'conversion' or 'microconversion'",
-                    enum: ["conversion", "microconversion"],
-                    default: "conversion",
-                },
-                label: {
-                    type: "string",
-                    description: "Event label (e.g., 'sales', 'add-to-cart', 'newsletter-signup')",
-                },
-                value: {
-                    type: "number",
-                    description: "Monetary value for the event",
-                },
-                ignore_pageview: {
-                    type: "boolean",
-                    description: "Set to true to avoid counting an additional pageview",
-                    default: false,
-                },
-            },
-            required: [],
-        },
+    annotations: { title: "Verify pixel install", readOnlyHint: true, openWorldHint: true },
+    handler: async (args) => {
+      const accountId = str(args.account_id) ?? ctx.state.accountId;
+      if (!accountId)
+        throw new Error("account_id is required (provision a site first).");
+      const apiKey = ctx.client.getApiKey();
+      if (!apiKey) {
+        throw new Error("AUTH_REQUIRED: no api_key available to verify. Provision a site first, or set SEALMETRICS_API_KEY.");
+      }
+      const timeoutMs = ctx.pollDefaults?.timeoutMs ?? (typeof args.timeout_seconds === "number" ? Math.max(0, args.timeout_seconds) * 1e3 : 25e3);
+      const intervalMs = ctx.pollDefaults?.intervalMs ?? 2e3;
+      const res = await pollPixelStatus({
+        fetchStatus: () => fetchPixelStatus(accountId, { baseUrl: ctx.baseUrl, apiKey }),
+        timeoutMs,
+        intervalMs
+      });
+      if (res.verified === true)
+        ctx.state.pixelVerified = true;
+      return {
+        account_id: accountId,
+        installed: res.verified === true,
+        status: res.verified === true ? "verified" : "pending",
+        total_hits: res.totalHits ?? 0,
+        next_steps: res.verified === true ? ["Pixel confirmed. You can now query analytics with the read-only tools."] : [
+          "No hits yet. Make sure the snippet is in the <head> of a live page, then load that page and re-run verify_setup."
+        ]
+      };
+    }
+  };
+  const getSetupStatus = {
+    name: "get_setup_status",
+    description: "Report where the setup flow is: whether a site has been provisioned in this session and whether its pixel has been verified.",
+    inputSchema: { type: "object", properties: {} },
+    annotations: { title: "Setup status", readOnlyHint: true },
+    handler: async () => ({
+      provisioned: ctx.state.provisioned,
+      account_id: ctx.state.accountId,
+      pixel_verified: ctx.state.pixelVerified
+    })
+  };
+  const detectFrameworkTool = {
+    name: "detect_framework",
+    description: "Best-effort detect the web framework/CMS of a project so the snippet can be placed correctly. Pass `path` if you have the repo; in a pure chat (no repo) returns 'unknown' plus the manual guide. Read-only \u2014 never edits files.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "Absolute path to the project root. Optional; omit if you don't have the repo."
+        }
+      }
     },
-];
-// Initialize server
-const server = new Server({
-    name: "sealmetrics",
-    version: "0.1.0",
-}, {
-    capabilities: {
-        tools: {},
+    annotations: { title: "Detect framework", readOnlyHint: true },
+    handler: async (args) => {
+      const path = str(args.path) ?? ctx.cwd;
+      if (!path) {
+        const guide2 = getStackGuide("unknown");
+        return {
+          framework: "unknown",
+          strategy: "manual",
+          location: guide2.location,
+          placement: guide2.placement,
+          provision_only: true,
+          note: "No project path available (e.g. Claude Desktop chat). Provide `path` if you have the repo, or place the snippet manually using loading_notes.",
+          loading_notes: guide2.notes
+        };
+      }
+      const d = detectFramework(path);
+      const guide = getStackGuide(d.framework);
+      return {
+        framework: d.framework,
+        platform: d.platform,
+        strategy: d.strategy,
+        location: d.recommendedLocation,
+        placement: d.placementHint,
+        provision_only: d.provisionOnly,
+        loading_notes: guide.notes,
+        ...d.platform ? { plugin_guidance: getPlatformPluginGuide(d.platform, ctx.state.accountId ?? "[YOUR_ACCOUNT_ID]") } : {}
+      };
+    }
+  };
+  const getInstrumentationGuideTool = {
+    name: "get_instrumentation_guide",
+    description: "Return the canonical SealMetrics event-instrumentation guide (closed conv/micro taxonomy + privacy rules) with your account_id substituted. Use it before writing sealmetrics.conv()/micro() calls. The MCP does NOT write these calls \u2014 the agent does, guided by this.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        account_id: {
+          type: "string",
+          description: "Account id to substitute into the guide. Defaults to the provisioned site."
+        }
+      }
     },
-});
-// Handle list tools request
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools,
-}));
-// Handle tool calls
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    try {
-        switch (name) {
-            case "list_accounts": {
-                const result = await makeRequest("/auth/accounts", {});
-                const accounts = result.data || {};
-                let text = "## Available SealMetrics Accounts\n\n";
-                if (!Object.keys(accounts).length && DEFAULT_ACCOUNT_ID) {
-                    text += `**Default Account**\n- ID: \`${DEFAULT_ACCOUNT_ID}\`\n`;
-                }
-                else {
-                    for (const [id, accountName] of Object.entries(accounts)) {
-                        text += `**${accountName}**\n- ID: \`${id}\`\n\n`;
-                    }
-                }
-                return { content: [{ type: "text", text }] };
-            }
-            case "get_traffic": {
-                const accountId = getAccountId(args);
-                if (!accountId) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "Error: No account_id provided and SEALMETRICS_ACCOUNT_ID not set.",
-                            },
-                        ],
-                    };
-                }
-                const dateRange = args.date_range;
-                if (!validateDateRange(dateRange)) {
-                    return {
-                        content: [{ type: "text", text: `Error: Invalid date range: ${dateRange}` }],
-                    };
-                }
-                const result = await makeRequest("/report/acquisition", {
-                    account_id: accountId,
-                    date_range: dateRange,
-                    report_type: args.report_type || "Source",
-                    utm_source: args.utm_source,
-                    utm_medium: args.utm_medium,
-                    utm_campaign: args.utm_campaign,
-                    country: args.country,
-                    limit: args.limit || 100,
-                    skip: args.skip || 0,
-                });
-                const text = formatAcquisitionSummary(result.data || []);
-                return { content: [{ type: "text", text }] };
-            }
-            case "get_conversions": {
-                const accountId = getAccountId(args);
-                if (!accountId) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "Error: No account_id provided and SEALMETRICS_ACCOUNT_ID not set.",
-                            },
-                        ],
-                    };
-                }
-                const dateRange = args.date_range;
-                if (!validateDateRange(dateRange)) {
-                    return {
-                        content: [{ type: "text", text: `Error: Invalid date range: ${dateRange}` }],
-                    };
-                }
-                const result = await makeRequest("/report/conversions", {
-                    account_id: accountId,
-                    date_range: dateRange,
-                    utm_source: args.utm_source,
-                    utm_medium: args.utm_medium,
-                    utm_campaign: args.utm_campaign,
-                    country: args.country,
-                    limit: args.limit || 100,
-                    skip: args.skip || 0,
-                });
-                const text = formatConversionsSummary(result.data || []);
-                return { content: [{ type: "text", text }] };
-            }
-            case "get_microconversions": {
-                const accountId = getAccountId(args);
-                if (!accountId) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "Error: No account_id provided and SEALMETRICS_ACCOUNT_ID not set.",
-                            },
-                        ],
-                    };
-                }
-                const dateRange = args.date_range;
-                if (!validateDateRange(dateRange)) {
-                    return {
-                        content: [{ type: "text", text: `Error: Invalid date range: ${dateRange}` }],
-                    };
-                }
-                const result = await makeRequest("/report/microconversions", {
-                    account_id: accountId,
-                    date_range: dateRange,
-                    utm_source: args.utm_source,
-                    utm_medium: args.utm_medium,
-                    country: args.country,
-                    limit: args.limit || 100,
-                    skip: args.skip || 0,
-                });
-                let data = result.data || [];
-                // Filter by label if specified
-                const labelFilter = args.label;
-                if (labelFilter) {
-                    data = data.filter((item) => item.label === labelFilter);
-                }
-                const text = formatMicroconversionsSummary(data);
-                return { content: [{ type: "text", text }] };
-            }
-            case "get_funnel": {
-                const accountId = getAccountId(args);
-                if (!accountId) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "Error: No account_id provided and SEALMETRICS_ACCOUNT_ID not set.",
-                            },
-                        ],
-                    };
-                }
-                const dateRange = args.date_range;
-                if (!validateDateRange(dateRange)) {
-                    return {
-                        content: [{ type: "text", text: `Error: Invalid date range: ${dateRange}` }],
-                    };
-                }
-                const result = await makeRequest("/report/funnel", {
-                    account_id: accountId,
-                    date_range: dateRange,
-                    report_type: args.report_type || "Source",
-                });
-                let text = "## Funnel Analysis\n\n";
-                for (const item of result.data || []) {
-                    const source = item.name || item.utm_source || "Unknown";
-                    text += `### ${source}\n\n`;
-                    for (const [key, value] of Object.entries(item)) {
-                        if (!["name", "utm_source", "_id"].includes(key)) {
-                            text += `- **${key}:** ${value.toLocaleString()}\n`;
-                        }
-                    }
-                    text += "\n";
-                }
-                return { content: [{ type: "text", text }] };
-            }
-            case "get_roas_evolution": {
-                const accountId = getAccountId(args);
-                if (!accountId) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "Error: No account_id provided and SEALMETRICS_ACCOUNT_ID not set.",
-                            },
-                        ],
-                    };
-                }
-                const dateRange = args.date_range;
-                if (!validateDateRange(dateRange)) {
-                    return {
-                        content: [{ type: "text", text: `Error: Invalid date range: ${dateRange}` }],
-                    };
-                }
-                const result = await makeRequest("/report/roas-evolution", {
-                    account_id: accountId,
-                    date_range: dateRange,
-                    time_unit: args.time_unit || "daily",
-                    utm_source: args.utm_source,
-                    utm_medium: args.utm_medium,
-                });
-                let text = "## ROAS Evolution\n\n";
-                text += `| Date | Clicks | Page Views | Conversions | Revenue |\n`;
-                text += `|------|--------|------------|-------------|----------|\n`;
-                for (const item of result.data || []) {
-                    const date = item._id;
-                    text += `| ${date} | ${(item.clicks || 0).toLocaleString()} | ${(item.page_views || 0).toLocaleString()} | ${(item.conversions || 0).toLocaleString()} | $${(item.revenue || 0).toLocaleString(undefined, { minimumFractionDigits: 2 })} |\n`;
-                }
-                return { content: [{ type: "text", text }] };
-            }
-            case "get_pages": {
-                const accountId = getAccountId(args);
-                if (!accountId) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "Error: No account_id provided and SEALMETRICS_ACCOUNT_ID not set.",
-                            },
-                        ],
-                    };
-                }
-                const dateRange = args.date_range;
-                if (!validateDateRange(dateRange)) {
-                    return {
-                        content: [{ type: "text", text: `Error: Invalid date range: ${dateRange}` }],
-                    };
-                }
-                const result = await makeRequest("/report/pages", {
-                    account_id: accountId,
-                    date_range: dateRange,
-                    content_grouping: args.content_grouping,
-                    utm_source: args.utm_source,
-                    utm_medium: args.utm_medium,
-                    country: args.country,
-                    show_utms: args.show_utms || false,
-                    limit: args.limit || 100,
-                    skip: args.skip || 0,
-                });
-                let text = "## Page Performance\n\n";
-                text += `| URL | Views | Entry Pages |\n`;
-                text += `|-----|-------|-------------|\n`;
-                for (const item of (result.data || []).slice(0, 20)) {
-                    const url = item.url || "Unknown";
-                    text += `| ${url} | ${(item.views || 0).toLocaleString()} | ${(item.entry_page || 0).toLocaleString()} |\n`;
-                }
-                return { content: [{ type: "text", text }] };
-            }
-            case "generate_pixel": {
-                const accountId = getAccountId(args);
-                if (!accountId) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "Error: No account_id provided and SEALMETRICS_ACCOUNT_ID not set.",
-                            },
-                        ],
-                    };
-                }
-                const pixel = generatePixel(accountId, args.event_type || "conversion", args.label, args.value, args.ignore_pageview);
-                let text = "## SealMetrics Tracking Pixel\n\n";
-                text += "Copy this code and paste it into Google Tag Manager or your website:\n\n";
-                text += "```html\n" + pixel + "\n```\n\n";
-                text += "### Usage Instructions:\n\n";
-                text += "1. **For Google Tag Manager:** Create a new Custom HTML tag and paste this code\n";
-                text += "2. **For Direct Website Integration:** Paste this code where you want the conversion to be tracked\n";
-                text += "3. **Trigger:** Configure when this pixel should fire\n";
-                return { content: [{ type: "text", text }] };
+    annotations: { title: "Instrumentation guide", readOnlyHint: true },
+    handler: async (args) => {
+      const accountId = str(args.account_id) ?? ctx.state.accountId ?? "[YOUR_ACCOUNT_ID]";
+      return { account_id: accountId, guide: getInstrumentationGuide(accountId) };
+    }
+  };
+  const verifyEventInstrumented = {
+    name: "verify_event_instrumented",
+    description: "Close the instrumentation loop (Fase 3 Bloque 4): after you add a sealmetrics.conv()/micro() call AND trigger it (a test visit/action), confirm the event reached the backend with the expected type. ALSO validates the event name against the closed taxonomy and rejects PII in properties before declaring success. Reads only.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        account_id: { type: "string", description: "Site/account id. Defaults to the provisioned site." },
+        kind: { type: "string", enum: ["conv", "micro"], description: "Event kind: 'conv' or 'micro'." },
+        name: { type: "string", description: "Event name (must be in the closed taxonomy, e.g. 'purchase')." },
+        timeout_seconds: { type: "number", description: "Max seconds to wait for the event (default 25)." }
+      },
+      required: ["kind", "name"]
+    },
+    annotations: { title: "Verify instrumented event", readOnlyHint: true, openWorldHint: true },
+    handler: async (args) => {
+      const accountId = str(args.account_id) ?? ctx.state.accountId;
+      if (!accountId)
+        throw new Error("account_id is required (provision a site first).");
+      const kind = str(args.kind);
+      const name = str(args.name);
+      if (kind !== "conv" && kind !== "micro")
+        throw new Error("kind must be 'conv' or 'micro'.");
+      if (!name)
+        throw new Error("name is required.");
+      const apiKey = ctx.client.getApiKey();
+      if (!apiKey)
+        throw new Error("AUTH_REQUIRED: no api_key available. Provision a site first or set SEALMETRICS_API_KEY.");
+      const check = checkInstrumentation(kind, name);
+      if (!check.taxonomy.valid) {
+        return {
+          status: "rejected",
+          reason: "out_of_taxonomy",
+          name,
+          suggestion: check.taxonomy.suggestion,
+          message: `'${name}' is not in the closed ${kind} taxonomy.${check.taxonomy.suggestion ? ` Did you mean '${check.taxonomy.suggestion}'?` : ""} Fix the event name before verifying.`
+        };
+      }
+      const path = kind === "conv" ? "/stats/conversions/raw" : "/stats/microconversions/raw";
+      const typeParam = kind === "conv" ? "conversion_type" : "microconversion_type";
+      const timeoutMs = ctx.pollDefaults?.timeoutMs ?? (typeof args.timeout_seconds === "number" ? Math.max(0, args.timeout_seconds) * 1e3 : 25e3);
+      const intervalMs = ctx.pollDefaults?.intervalMs ?? 3e3;
+      const startedAt = ctx.now ? ctx.now() : Date.now();
+      const deadline = startedAt + timeoutMs;
+      let found;
+      let piiFlagged = [];
+      for (; ; ) {
+        try {
+          const raw = await ctx.client.requestDirect(path, {
+            site_id: accountId,
+            period: "today",
+            [typeParam]: name,
+            include_properties: "true",
+            page_size: "20"
+          });
+          const rows = Array.isArray(raw?.data) ? raw.data : [];
+          for (const row of rows) {
+            const ts = Date.parse(String(row.timestamp_utc ?? ""));
+            if (Number.isFinite(ts) && ts >= startedAt - 5e3) {
+              found = row;
+              const findings = detectPropertiesPII(row.properties);
+              piiFlagged = findings;
+              break;
             }
-            default:
-                return {
-                    content: [{ type: "text", text: `Unknown tool: ${name}` }],
-                };
+          }
+        } catch {
         }
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
+        if (found)
+          break;
+        const nowMs = ctx.now ? ctx.now() : Date.now();
+        if (nowMs + intervalMs >= deadline)
+          break;
+        await sleep2(intervalMs, ctx.sleep);
+      }
+      if (!found) {
+        return {
+          status: "pending",
+          account_id: accountId,
+          kind,
+          name,
+          message: `No '${name}' ${kind} event seen yet. Trigger the event (a test visit/action), then re-run. Raw endpoints lag ~2-5s.`
+        };
+      }
+      if (piiFlagged.length > 0) {
         return {
-            content: [{ type: "text", text: `Error: ${message}` }],
+          status: "warning_pii",
+          account_id: accountId,
+          kind,
+          name,
+          pii_properties: piiFlagged,
+          message: `Event '${name}' arrived, but its properties look like PII (${piiFlagged.map((f) => f.key).join(", ")}). Remove personal data / order/user IDs \u2014 these must NEVER be tracked.`
         };
+      }
+      return {
+        status: "verified",
+        account_id: accountId,
+        kind,
+        name,
+        message: `Event '${name}' confirmed in SealMetrics with no PII. Instrumentation verified.`
+      };
     }
+  };
+  return [
+    provisionSite,
+    verifySetup,
+    getSetupStatus,
+    detectFrameworkTool,
+    getInstrumentationGuideTool,
+    verifyEventInstrumented
+  ];
+}
+function sleep2(ms, custom) {
+  if (custom)
+    return custom(ms);
+  return new Promise((r) => setTimeout(r, ms));
+}
+function detectPropertiesPII(properties) {
+  if (!properties || typeof properties !== "object")
+    return [];
+  return detectPII(properties).map((f) => ({ reason: f.reason, key: f.key }));
+}
+
+// dist/embedded.js
+var EMBEDDED_PROVISION_KEY = "pk_mcp_69bb5a1ec96f2cc4d5dd77be";
+var FALLBACK_PROVISION_KEY = "pk_provision_fallback";
+var INSTALL_SOURCE = "mcp";
+function isNonProdTarget(baseUrl) {
+  return /localhost|127\.0\.0\.1|pre\.sealmetrics\.com/.test(baseUrl);
+}
+function resolveProvisionKey(baseUrl) {
+  if (process.env.SEALMETRICS_PROVISION_KEY)
+    return process.env.SEALMETRICS_PROVISION_KEY;
+  if (isNonProdTarget(baseUrl))
+    return FALLBACK_PROVISION_KEY;
+  return EMBEDDED_PROVISION_KEY;
+}
+
+// dist/resources/tracking-guide.js
+var TRACKING_GUIDE_URI = "sealmetrics://tracking-guide";
+var TRACKING_GUIDE_NAME = "SealMetrics Tracking Guide";
+var TRACKING_GUIDE_DESCRIPTION = "Operational playbook for implementing SealMetrics tracking on any website: pixel installation, conversions, microconversions, content grouping, and framework-specific patterns.";
+var TRACKING_GUIDE_CONTENT = `# SealMetrics Tracking \u2014 Implementation Playbook
+
+You are implementing SealMetrics analytics on a website. This guide tells you exactly what to do, step by step.
+
+---
+
+## Step 1: Get the pixel
+
+Call the \`get_tracking_code\` tool with the user's \`site_id\`. It returns:
+- \`script_tag\`: the exact \`<script>\` tag to insert (with the real site ID baked in)
+- \`tracker_url\`: the URL of the tracker JS file
+
+If you don't know the site_id, call \`list_sites\` first to find it.
+
+---
+
+## Step 2: Find where to insert the script
+
+The script tag goes in the \`<head>\` of every page, **once**. Where that is depends on the framework:
+
+| Framework | Where to put it |
+|-----------|----------------|
+| **Plain HTML** | Inside \`<head>\` in every \`.html\` file, or in a shared template/layout |
+| **Next.js (App Router)** | \`app/layout.tsx\` \u2014 use \`import Script from 'next/script'\` with \`strategy="afterInteractive"\` |
+| **Next.js (Pages Router)** | \`pages/_app.tsx\` \u2014 use \`<Script>\` component |
+| **React (CRA/Vite)** | \`index.html\` inside \`<head>\` |
+| **Vue / Nuxt** | \`nuxt.config.ts\` head section, or \`app.vue\` |
+| **Angular** | \`src/index.html\` inside \`<head>\` |
+| **Astro** | Shared layout component \`<head>\` |
+| **WordPress** | \`header.php\` or via a "header scripts" plugin/setting |
+| **Shopify** | \`theme.liquid\` inside \`<head>\` |
+
+**How to find it**: Search for \`</head>\`, or look for the root layout/template file. Every framework has one place that wraps all pages \u2014 that's where the script goes.
+
+### Plain HTML
+\`\`\`html
+<head>
+  <!-- other tags... -->
+  <script src="https://t.sealmetrics.com/t.js?id=SITE_ID" defer></script>
+</head>
+\`\`\`
+
+### Next.js (App Router)
+\`\`\`tsx
+// app/layout.tsx
+import Script from 'next/script';
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <head />
+      <body>
+        {children}
+        <Script src="https://t.sealmetrics.com/t.js?id=SITE_ID" strategy="afterInteractive" />
+      </body>
+    </html>
+  );
+}
+\`\`\`
+
+### Vue / Nuxt
+\`\`\`ts
+// nuxt.config.ts
+export default defineNuxtConfig({
+  app: {
+    head: {
+      script: [{ src: 'https://t.sealmetrics.com/t.js?id=SITE_ID', defer: true }]
+    }
+  }
 });
-// Main entry point
-async function main() {
-    if (!API_TOKEN && (!EMAIL || !PASSWORD)) {
-        console.error("Missing credentials. Set SEALMETRICS_API_TOKEN or SEALMETRICS_EMAIL/PASSWORD");
-        process.exit(1);
+\`\`\`
+
+**Once the script is in place, pageviews are tracked automatically** \u2014 on load, on SPA navigation (pushState, replaceState, popstate), on back/forward. You do NOT need to add manual pageview calls.
+
+---
+
+## Step 3: Identify what to track
+
+Analyze the website code and identify trackeable user actions. Classify each one as a **conversion** or a **microconversion**.
+
+### What is a conversion?
+
+A conversion is a **business goal** \u2014 the main thing the site owner wants users to do. It typically has monetary value or represents a completed transaction.
+
+| What you see in the code | Conversion type | Has value? |
+|--------------------------|-----------------|------------|
+| Purchase/checkout completion, order confirmation page | \`purchase\` | Yes \u2014 the order total |
+| Subscription payment, plan upgrade | \`purchase\` | Yes \u2014 the subscription price |
+| Contact form, demo request, quote request | \`lead\` | No (use \`0\`) |
+| Account registration, signup form | \`signup\` | No (use \`0\`) |
+| Booking confirmation, appointment scheduled | \`booking\` | Yes if there's a price, otherwise \`0\` |
+
+**Rule of thumb**: If the business would pay money to make this action happen, it's a conversion.
+
+### What is a microconversion?
+
+A microconversion is a **step toward a conversion** or an **engagement signal**. It tells you how users interact with the site before converting.
+
+| What you see in the code | Microconversion type |
+|--------------------------|---------------------|
+| "Add to cart" button | \`add_to_cart\` |
+| "Add to wishlist" / "Save for later" | \`add_to_wishlist\` |
+| Checkout step buttons (shipping, payment...) | \`begin_checkout\`, \`checkout_shipping\`, \`checkout_payment\` |
+| Newsletter/email signup form | \`newsletter_signup\` |
+| PDF/resource download link | \`download\` |
+| Video play button | \`video_play\` |
+| Video ends | \`video_complete\` |
+| Pricing page visited or pricing toggle clicked | \`pricing_view\` |
+| Share/social buttons | \`share\` |
+| Search form used | \`search\` |
+| Filter/sort applied | \`filter_applied\` |
+| Tab/accordion clicked to reveal content | \`content_expand\` |
+| Chat widget opened | \`chat_open\` |
+| Scroll milestones (25%, 50%, 75%, 100%) | \`scroll_25\`, \`scroll_50\`, \`scroll_75\`, \`scroll_100\` |
+
+**Rule of thumb**: If it shows intent or engagement but isn't the final goal, it's a microconversion.
+
+---
+
+## Step 4: Implement conversions
+
+### Syntax
+\`\`\`js
+sealmetrics.conv(type, amount, properties?)
+\`\`\`
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| \`type\` | string | Yes | snake_case name for this conversion |
+| \`amount\` | number | Yes | Monetary value. Use \`0\` if no value (leads, signups) |
+| \`properties\` | object | No | Extra metadata (see "Using properties" below) |
+
+### Where to put it
+
+The conversion call goes **at the moment the action succeeds**, not when the user clicks. For example:
+
+- **Form submission**: In the \`onSubmit\` handler, AFTER validation passes (or on the thank-you page)
+- **Purchase**: On the order confirmation/thank-you page, or in the success callback of the payment API
+- **Signup**: After the registration API call succeeds
+
+### Examples by pattern
+
+**Form submit (vanilla JS):**
+\`\`\`js
+document.querySelector('#contact-form').addEventListener('submit', function(e) {
+  // The form is about to submit \u2014 track the lead
+  sealmetrics.conv('lead', 0, { form_name: 'contact', page: location.pathname });
+});
+\`\`\`
+
+**Form submit (React):**
+\`\`\`tsx
+const handleSubmit = async (data: FormData) => {
+  await api.submitContactForm(data);
+  window.sealmetrics?.conv('lead', 0, { form_name: 'contact' });
+};
+\`\`\`
+
+**Purchase (thank-you page):**
+\`\`\`html
+<!-- This script runs on /order-confirmation or /thank-you -->
+<script>
+  // Pull values from the page or from server-rendered data
+  sealmetrics.conv('purchase', 149.99, {
+    currency: 'EUR',
+    payment_method: 'credit_card'
+  });
+</script>
+\`\`\`
+
+**Purchase (React, after payment API):**
+\`\`\`tsx
+const handlePayment = async () => {
+  const result = await processPayment(cart);
+  if (result.success) {
+    window.sealmetrics?.conv('purchase', cart.total, {
+      currency: cart.currency,
+      payment_method: result.method
+    });
+    router.push('/thank-you');
+  }
+};
+\`\`\`
+
+**Signup (after API success):**
+\`\`\`tsx
+const handleRegister = async (formData: RegisterForm) => {
+  const user = await api.register(formData);
+  window.sealmetrics?.conv('signup', 0, { plan: formData.plan });
+  router.push('/welcome');
+};
+\`\`\`
+
+---
+
+## Step 5: Implement microconversions
+
+### Syntax
+\`\`\`js
+sealmetrics.micro(type, properties?)
+\`\`\`
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| \`type\` | string | Yes | snake_case name for this event |
+| \`properties\` | object | No | Extra metadata (see "Using properties" below) |
+
+### Where to put it
+
+Microconversions go **on the user action** \u2014 usually in click handlers, submit handlers, or event listeners.
+
+### Examples by pattern
+
+**Add to cart (vanilla):**
+\`\`\`js
+document.querySelectorAll('.add-to-cart').forEach(function(btn) {
+  btn.addEventListener('click', function() {
+    sealmetrics.micro('add_to_cart', {
+      product_id: this.dataset.productId,
+      product_name: this.dataset.productName,
+      price: parseFloat(this.dataset.price)
+    });
+  });
+});
+\`\`\`
+
+**Add to cart (React):**
+\`\`\`tsx
+function AddToCartButton({ product }: { product: Product }) {
+  const handleClick = () => {
+    addToCart(product);
+    window.sealmetrics?.micro('add_to_cart', {
+      product_id: product.id,
+      product_name: product.name,
+      price: product.price
+    });
+  };
+  return <button onClick={handleClick}>Add to Cart</button>;
+}
+\`\`\`
+
+**Newsletter signup:**
+\`\`\`js
+document.querySelector('#newsletter-form').addEventListener('submit', function() {
+  sealmetrics.micro('newsletter_signup', {
+    position: this.closest('footer') ? 'footer' : 'inline'
+  });
+});
+\`\`\`
+
+**Video engagement:**
+\`\`\`js
+var video = document.querySelector('video');
+video.addEventListener('play', function() {
+  sealmetrics.micro('video_play', { video_id: this.dataset.videoId });
+});
+video.addEventListener('ended', function() {
+  sealmetrics.micro('video_complete', { video_id: this.dataset.videoId });
+});
+\`\`\`
+
+**Scroll depth tracking:**
+\`\`\`js
+var scrollTracked = {};
+window.addEventListener('scroll', function() {
+  var pct = Math.round(window.scrollY / (document.body.scrollHeight - window.innerHeight) * 100);
+  [25, 50, 75, 100].forEach(function(milestone) {
+    if (pct >= milestone && !scrollTracked[milestone]) {
+      scrollTracked[milestone] = true;
+      sealmetrics.micro('scroll_' + milestone);
     }
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+  });
+});
+\`\`\`
+
+**Checkout funnel steps (React):**
+\`\`\`tsx
+// When user moves from step to step
+const goToStep = (step: number) => {
+  setCurrentStep(step);
+  const stepNames: Record<number, string> = {
+    1: 'begin_checkout',
+    2: 'checkout_shipping',
+    3: 'checkout_payment',
+  };
+  if (stepNames[step]) {
+    window.sealmetrics?.micro(stepNames[step], { items_count: cart.items.length });
+  }
+};
+\`\`\`
+
+---
+
+## Step 6: Set up content grouping
+
+Content grouping lets the site owner analyze metrics by section: "how does the blog perform vs product pages?"
+
+### When to use it
+
+Use content grouping when the site has **distinct sections** that serve different purposes. If the site is a single-purpose landing page, skip it.
+
+### How to decide groups
+
+Look at the URL structure and page purpose:
+
+| URL pattern | Group |
+|-------------|-------|
+| \`/blog/*\`, \`/posts/*\`, \`/articles/*\` | \`blog\` |
+| \`/products/*\`, \`/shop/*\`, \`/item/*\` | \`product\` |
+| \`/category/*\`, \`/collections/*\` | \`category\` |
+| \`/cart\`, \`/checkout/*\`, \`/order/*\` | \`checkout\` |
+| \`/docs/*\`, \`/help/*\`, \`/faq\` | \`docs\` |
+| \`/dashboard/*\`, \`/app/*\`, \`/account/*\` | \`app\` |
+| \`/pricing\`, \`/plans\` | \`pricing\` |
+| \`/\`, \`/about\`, \`/features\`, \`/contact\` | \`landing\` |
+
+### How to implement it
+
+**Option A \u2014 Static (via URL param in the script tag):**
+
+Best when you can set a different script tag per section (e.g., different templates, layouts).
+
+\`\`\`html
+<!-- Blog layout -->
+<script src="https://t.sealmetrics.com/t.js?id=SITE_ID&group=blog" defer></script>
+
+<!-- Product layout -->
+<script src="https://t.sealmetrics.com/t.js?id=SITE_ID&group=product" defer></script>
+\`\`\`
+
+**Option B \u2014 Dynamic (via JS, based on URL):**
+
+Best for SPAs or when you can't change the script tag per section.
+
+\`\`\`js
+// Determine group from the current path
+function getContentGroup() {
+  var path = location.pathname;
+  if (path.startsWith('/blog') || path.startsWith('/posts')) return 'blog';
+  if (path.startsWith('/products') || path.startsWith('/shop')) return 'product';
+  if (path.startsWith('/cart') || path.startsWith('/checkout')) return 'checkout';
+  if (path.startsWith('/docs') || path.startsWith('/help')) return 'docs';
+  return 'landing';
+}
+
+sealmetrics({ group: getContentGroup() });
+\`\`\`
+
+**Option C \u2014 Next.js (per layout segment):**
+\`\`\`tsx
+// app/blog/layout.tsx
+import Script from 'next/script';
+export default function BlogLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <>
+      <Script src="https://t.sealmetrics.com/t.js?id=SITE_ID&group=blog" strategy="afterInteractive" />
+      {children}
+    </>
+  );
+}
+\`\`\`
+Note: if you use per-layout scripts with groups, remove the global script from the root layout to avoid double-tracking.
+
+---
+
+## Using properties effectively
+
+Properties are key-value metadata attached to conversions and microconversions. They power drill-down analysis in the dashboard.
+
+### What to include
+
+| Property | When to use | Example |
+|----------|------------|---------|
+| \`currency\` | Any monetary conversion | \`'EUR'\`, \`'USD'\` |
+| \`payment_method\` | Purchase conversions | \`'credit_card'\`, \`'paypal'\`, \`'stripe'\` |
+| \`plan\` | Signup/subscription conversions | \`'free'\`, \`'pro'\`, \`'enterprise'\` |
+| \`product_id\` | Product-related events | \`'SKU-123'\` |
+| \`product_name\` | Product-related events | \`'Wireless Headphones'\` |
+| \`price\` | Add-to-cart, wishlist | \`49.99\` |
+| \`category\` | Product events | \`'electronics'\`, \`'shoes'\` |
+| \`form_name\` | Lead/form conversions | \`'contact'\`, \`'demo_request'\`, \`'quote'\` |
+| \`position\` | UI element interactions | \`'header'\`, \`'footer'\`, \`'popup'\`, \`'sidebar'\` |
+| \`video_id\` | Video events | \`'intro-video'\`, \`'product-demo'\` |
+| \`search_term\` | Search events | The user's search query |
+
+### What NOT to include
+
+- **Order IDs, user IDs, transaction IDs** \u2014 these are high-cardinality and don't help analysis. Never put them in the type name either.
+- **Email addresses, names, or PII** \u2014 SealMetrics is privacy-first.
+- **Timestamps** \u2014 the system already records when events happen.
+- **Page URLs** \u2014 already tracked automatically.
+
+### Property values
+
+- Keep values **low-cardinality** when possible: \`'credit_card'\` not \`'visa_ending_4242'\`
+- Use **consistent values**: always \`'credit_card'\`, never sometimes \`'cc'\` and sometimes \`'Credit Card'\`
+- **Numbers** should be numbers, not strings: \`price: 49.99\`, not \`price: '49.99'\`
+
+---
+
+## Naming conventions
+
+- **snake_case** always: \`add_to_cart\`, not \`addToCart\` or \`Add To Cart\`
+- **Descriptive**: \`begin_checkout\` not \`step2\`, \`newsletter_signup\` not \`nl\`
+- **Stable**: once you name a type, don't rename it \u2014 it breaks historical data
+- **No IDs in the type name**: \`sealmetrics.conv('purchase', 99)\`, not \`sealmetrics.conv('purchase_order_12345', 99)\`
+
+---
+
+## TypeScript type declarations
+
+If the project uses TypeScript, add this declaration so \`window.sealmetrics\` doesn't show type errors:
+
+\`\`\`ts
+// types/sealmetrics.d.ts (or at the top of a component file)
+declare global {
+  interface Window {
+    sealmetrics?: {
+      (options?: { group?: string }): void;
+      conv: (type: string, amount: number, properties?: Record<string, unknown>) => void;
+      micro: (type: string, properties?: Record<string, unknown>) => void;
+    };
+  }
+}
+\`\`\`
+
+Then call via \`window.sealmetrics?.conv(...)\` instead of \`sealmetrics.conv(...)\`.
+
+---
+
+## Complete implementation checklist
+
+Use this to verify you haven't missed anything:
+
+1. **Pixel installed**: Script tag is in the \`<head>\` (or root layout) of every page \u2014 ONE time only
+2. **Pageviews working**: Automatic, no code needed. Verify with \`?debug=1\`
+3. **Conversions identified**: Every business goal (purchase, lead, signup) has a \`sealmetrics.conv()\` call
+4. **Conversion placement**: Each conversion fires at the right moment (after success, not on click)
+5. **Conversion values**: Purchases have the real \`amount\`, leads/signups use \`0\`
+6. **Microconversions identified**: Funnel steps and engagement signals have \`sealmetrics.micro()\` calls
+7. **Properties added**: Events carry useful metadata (currency, product_id, form_name, etc.)
+8. **Content grouping**: If the site has distinct sections, groups are assigned
+9. **Naming**: All types are snake_case, descriptive, and stable
+10. **No PII**: No emails, user IDs, or personal data in properties
+
+---
+
+## Debugging
+
+Add \`?debug=1\` to any page URL to see all tracking events in the browser console:
+
+\`\`\`
+https://yoursite.com/products?debug=1
+\`\`\`
+
+Shows: session ID, account ID, event type, payload, and any errors.
+
+---
+
+## Technical notes
+
+- **No cookies, no localStorage** \u2014 GDPR-friendly, no consent banner needed
+- **SPA support is automatic** \u2014 History API (pushState/replaceState/popstate) is intercepted
+- **Uses sendBeacon** \u2014 non-blocking, guaranteed delivery even on tab close
+- **Three equivalent globals**: \`sealmetrics\`, \`sm\`, \`_sm\` \u2014 use \`sealmetrics\` in new code
+- **Script loads async** with \`defer\` \u2014 never blocks page rendering
+`;
+
+// dist/server.js
+var MAX_RESPONSE_LENGTH = 1e5;
+function jsonSchemaToZod(prop) {
+  const type = prop.type;
+  const enumValues = prop.enum;
+  const description = prop.description;
+  let schema;
+  if (enumValues && enumValues.length > 0) {
+    schema = z.enum(enumValues);
+  } else if (type === "number" || type === "integer") {
+    schema = z.number();
+  } else if (type === "boolean") {
+    schema = z.boolean();
+  } else {
+    schema = z.string();
+  }
+  if (description)
+    schema = schema.describe(description);
+  return schema;
+}
+function buildShape(properties) {
+  const shape = {};
+  for (const [key, prop] of Object.entries(properties)) {
+    shape[key] = jsonSchemaToZod(prop).optional();
+  }
+  return shape;
+}
+function safeStringify(value) {
+  try {
+    const json = JSON.stringify(value, null, 2);
+    if (json.length > MAX_RESPONSE_LENGTH) {
+      return json.slice(0, MAX_RESPONSE_LENGTH) + "\n... (truncated)";
+    }
+    return json;
+  } catch {
+    return '{"error": "Response could not be serialized"}';
+  }
+}
+function toToolResult(result) {
+  return { content: [{ type: "text", text: safeStringify(result) }] };
+}
+function toErrorResult(error) {
+  const message = error instanceof Error ? error.message : "Unknown error occurred";
+  return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+}
+function buildServer(opts) {
+  const client = new SealMetricsClient(opts.apiKey, opts.baseUrl);
+  const server2 = new McpServer({ name: "sealmetrics", version: opts.version });
+  const readOnlyHandles = ALL_TOOLS.map((tool) => {
+    const handle = server2.registerTool(tool.name, {
+      description: tool.description,
+      inputSchema: buildShape(tool.inputSchema.properties),
+      annotations: { title: tool.name, readOnlyHint: true }
+    }, async (args) => {
+      try {
+        return toToolResult(await tool.handler(client, args));
+      } catch (error) {
+        return toErrorResult(error);
+      }
+    });
+    if (!client.hasApiKey())
+      handle.disable();
+    return handle;
+  });
+  const enableReadOnlyTools = () => {
+    for (const handle of readOnlyHandles) {
+      if (!handle.enabled)
+        handle.enable();
+    }
+  };
+  const setupState = { provisioned: false, pixelVerified: false };
+  const setupContext = {
+    client,
+    baseUrl: opts.baseUrl,
+    provisionKey: opts.provisionKey,
+    installSource: opts.installSource ?? INSTALL_SOURCE,
+    cwd: opts.cwd,
+    state: setupState,
+    onProvisioned: (apiKey, _accountId) => {
+      client.setApiKey(apiKey);
+      enableReadOnlyTools();
+    },
+    pollDefaults: opts.pollDefaults,
+    now: opts.now,
+    sleep: opts.sleep
+  };
+  const setupTools = createSetupTools(setupContext);
+  for (const tool of setupTools) {
+    server2.registerTool(tool.name, {
+      description: tool.description,
+      inputSchema: buildShape(tool.inputSchema.properties),
+      annotations: tool.annotations
+    }, async (args) => {
+      try {
+        return toToolResult(await tool.handler(args));
+      } catch (error) {
+        return toErrorResult(error);
+      }
+    });
+  }
+  server2.resource(TRACKING_GUIDE_NAME, TRACKING_GUIDE_URI, { description: TRACKING_GUIDE_DESCRIPTION, mimeType: "text/markdown" }, async () => ({
+    contents: [{ uri: TRACKING_GUIDE_URI, mimeType: "text/markdown", text: TRACKING_GUIDE_CONTENT }]
+  }));
+  return { server: server2, client, readOnlyHandles, setupTools, setupContext, enableReadOnlyTools };
+}
+
+// dist/index.js
+import { createRequire } from "module";
+var PKG_VERSION = "0.0.0";
+try {
+  const req = createRequire(import.meta.url);
+  PKG_VERSION = req("../package.json").version ?? PKG_VERSION;
+} catch {
+}
+var API_KEY = process.env.SEALMETRICS_API_KEY;
+var BASE_URL = process.env.SEALMETRICS_BASE_URL ?? "https://my.sealmetrics.com/api/v1";
+var PROVISION_KEY = resolveProvisionKey(BASE_URL);
+if (PROVISION_KEY === "pk_mcp_PLACEHOLDER_REPLACE_BEFORE_PUBLISH") {
+  console.error("[sealmetrics-mcp] WARNING: using the placeholder mcp provision key \u2014 provision_site will fail until the channel='mcp' key is configured.");
+}
+var { server } = buildServer({
+  apiKey: API_KEY,
+  baseUrl: BASE_URL,
+  provisionKey: PROVISION_KEY,
+  version: PKG_VERSION,
+  // Only pass a cwd when an explicit project dir is configured. In Claude Desktop
+  // chat there is no project tree → leave undefined so detect_framework returns
+  // 'unknown' + the manual guide instead of scanning the launch directory.
+  cwd: process.env.SEALMETRICS_PROJECT_DIR || void 0
+});
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
 }
 main().catch((error) => {
-    console.error("Fatal error:", error);
-    process.exit(1);
+  console.error("Fatal error:", error);
+  process.exit(1);
 });