umami-compass 0.1.0

package/dist/config.js

@@ -0,0 +1,148 @@
+import { UmamiError } from "./api/errors.js";
+export const TOOLSETS = [
+    "core",
+    "events",
+    "sessions",
+    "performance",
+    "reports",
+    "revenue",
+    "replay",
+    "heatmaps",
+];
+function optional(env, key) {
+    const value = env[key]?.trim();
+    return value ? value : undefined;
+}
+function parseBoolean(value, key) {
+    if (value === undefined)
+        return false;
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    throw new UmamiError("CONFIGURATION_ERROR", `${key} must be either true or false.`);
+}
+function parseInteger(value, key, fallback, range) {
+    if (value === undefined)
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < range.min || parsed > range.max) {
+        throw new UmamiError("CONFIGURATION_ERROR", `${key} must be an integer between ${range.min} and ${range.max}.`);
+    }
+    return parsed;
+}
+function parseApiUrl(env, hasApiKey) {
+    const exactApiUrl = optional(env, "UMAMI_API_URL");
+    const instanceUrl = optional(env, "UMAMI_URL");
+    if (exactApiUrl && instanceUrl) {
+        throw new UmamiError("CONFIGURATION_ERROR", "Set either UMAMI_API_URL or UMAMI_URL, not both.");
+    }
+    const value = exactApiUrl ?? instanceUrl ?? (hasApiKey ? "https://api.umami.is/v1" : undefined);
+    if (!value) {
+        throw new UmamiError("CONFIGURATION_ERROR", "Set UMAMI_URL for self-hosted Umami or UMAMI_API_URL for an exact API root.");
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch (error) {
+        throw new UmamiError("CONFIGURATION_ERROR", "The configured Umami URL is invalid.", {
+            cause: error,
+        });
+    }
+    if (url.username || url.password || url.search || url.hash) {
+        throw new UmamiError("CONFIGURATION_ERROR", "The configured Umami URL cannot contain credentials, a query string, or a fragment.");
+    }
+    if (!exactApiUrl && instanceUrl) {
+        url.pathname = `${url.pathname.replace(/\/$/, "")}/api`;
+    }
+    url.pathname = `${url.pathname.replace(/\/$/, "")}/`;
+    return url;
+}
+function assertSafeProtocol(url, allowInsecureHttp) {
+    if (url.protocol === "https:")
+        return;
+    const loopback = url.hostname === "localhost" ||
+        url.hostname === "127.0.0.1" ||
+        url.hostname === "::1" ||
+        url.hostname === "[::1]";
+    if (url.protocol === "http:" && (loopback || allowInsecureHttp))
+        return;
+    throw new UmamiError("CONFIGURATION_ERROR", "Umami must use HTTPS. Plain HTTP is allowed only for loopback addresses unless UMAMI_ALLOW_INSECURE_HTTP=true.");
+}
+function parseAuth(env) {
+    const apiKey = optional(env, "UMAMI_API_KEY");
+    const accessToken = optional(env, "UMAMI_ACCESS_TOKEN");
+    const username = optional(env, "UMAMI_USERNAME");
+    const password = optional(env, "UMAMI_PASSWORD");
+    const loginConfigured = username !== undefined || password !== undefined;
+    const modes = Number(apiKey !== undefined) + Number(accessToken !== undefined) + Number(loginConfigured);
+    if (modes !== 1) {
+        throw new UmamiError("CONFIGURATION_ERROR", "Configure exactly one auth mode: UMAMI_API_KEY, UMAMI_ACCESS_TOKEN, or UMAMI_USERNAME with UMAMI_PASSWORD.");
+    }
+    if (apiKey)
+        return { type: "apiKey", apiKey };
+    if (accessToken)
+        return { type: "accessToken", accessToken };
+    if (!username || !password) {
+        throw new UmamiError("CONFIGURATION_ERROR", "UMAMI_USERNAME and UMAMI_PASSWORD must be set together.");
+    }
+    return { type: "login", username, password };
+}
+function parseToolsets(value) {
+    if (!value)
+        return new Set(["core"]);
+    const names = value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+    if (names.includes("all")) {
+        if (names.length !== 1) {
+            throw new UmamiError("CONFIGURATION_ERROR", "UMAMI_TOOLSETS=all cannot be combined with other values.");
+        }
+        return new Set(TOOLSETS);
+    }
+    const invalid = names.filter((name) => !TOOLSETS.includes(name));
+    if (names.length === 0 || invalid.length > 0) {
+        throw new UmamiError("CONFIGURATION_ERROR", `UMAMI_TOOLSETS must contain: ${TOOLSETS.join(", ")}, or all.`);
+    }
+    return new Set(names);
+}
+function parseWebsiteIds(value) {
+    if (!value)
+        return undefined;
+    const ids = value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+    if (ids.length === 0)
+        return undefined;
+    if (ids.length > 100) {
+        throw new UmamiError("CONFIGURATION_ERROR", "UMAMI_WEBSITE_IDS cannot contain more than 100 websites.");
+    }
+    const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    if (ids.some((id) => !uuid.test(id))) {
+        throw new UmamiError("CONFIGURATION_ERROR", "UMAMI_WEBSITE_IDS must be a comma-separated list of UUIDs.");
+    }
+    return new Set(ids.map((id) => id.toLowerCase()));
+}
+export function loadConfig(env = process.env) {
+    const auth = parseAuth(env);
+    const allowInsecureHttp = parseBoolean(optional(env, "UMAMI_ALLOW_INSECURE_HTTP"), "UMAMI_ALLOW_INSECURE_HTTP");
+    const apiUrl = parseApiUrl(env, auth.type === "apiKey");
+    assertSafeProtocol(apiUrl, allowInsecureHttp);
+    return {
+        apiUrl,
+        auth,
+        allowInsecureHttp,
+        maxRangeDays: parseInteger(optional(env, "UMAMI_MAX_RANGE_DAYS"), "UMAMI_MAX_RANGE_DAYS", 366, {
+            min: 1,
+            max: 3_650,
+        }),
+        maxResponseBytes: parseInteger(optional(env, "UMAMI_MAX_RESPONSE_BYTES"), "UMAMI_MAX_RESPONSE_BYTES", 10_485_760, { min: 102_400, max: 52_428_800 }),
+        requestTimeoutMs: parseInteger(optional(env, "UMAMI_REQUEST_TIMEOUT_MS"), "UMAMI_REQUEST_TIMEOUT_MS", 30_000, { min: 1_000, max: 120_000 }),
+        toolsets: parseToolsets(optional(env, "UMAMI_TOOLSETS")),
+        websiteIds: parseWebsiteIds(optional(env, "UMAMI_WEBSITE_IDS")),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { type Fetch, UmamiClient } from "./api/client.js";
+export { UmamiError, type UmamiErrorCode } from "./api/errors.js";
+export type { AttributionReportRequest, BreakdownField, BreakdownReportRequest, FunnelReportRequest, FunnelStep, FunnelStepFilter, GoalReportRequest, HeatmapReportRequest, JourneyReportRequest, PagedResponse, PerformanceMetric, PerformanceReportRequest, Query, QueryValue, ReadOnlyReportRequest, RetentionReportRequest, UtmReportRequest, Website, } from "./api/types.js";
+export { loadConfig, TOOLSETS, type Toolset, type UmamiAuth, type UmamiCompassConfig, } from "./config.js";
+export { type AccessPolicy, READ_ONLY_POLICY, type ToolAccess, type ToolContext, type ToolModule, } from "./mcp/tool-module.js";
+export { BUILTIN_MODULES, type CreateServerOptions, createServer } from "./server.js";
+export { parseTimeRange, type TimeInput } from "./time.js";
+export { VERSION } from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,EACL,UAAU,EACV,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,OAAO,GACR,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,YAAY,EACjB,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { UmamiClient } from "./api/client.js";
+export { UmamiError } from "./api/errors.js";
+export { loadConfig, TOOLSETS, } from "./config.js";
+export { READ_ONLY_POLICY, } from "./mcp/tool-module.js";
+export { BUILTIN_MODULES, createServer } from "./server.js";
+export { parseTimeRange } from "./time.js";
+export { VERSION } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAuB,MAAM,iBAAiB,CAAC;AAqBlE,OAAO,EACL,UAAU,EACV,QAAQ,GAIT,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,gBAAgB,GAIjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAA4B,YAAY,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,cAAc,EAAkB,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/mcp/modules/core.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from "../tool-module.js";
+export declare const coreModule: ToolModule;
+//# sourceMappingURL=core.d.ts.map

package/dist/mcp/modules/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/mcp/modules/core.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAyBpD,eAAO,MAAM,UAAU,EAAE,UA6KxB,CAAC"}

package/dist/mcp/modules/core.js

@@ -0,0 +1,132 @@
+import { z } from "zod";
+import { READ_ONLY_ANNOTATIONS, runTool } from "../result.js";
+import { arrayOutputSchema, filtersSchema, outputSchema, pagedOutputSchema, pageSchema, pageSizeSchema, pageviewsDataSchema, pageviewsOutputSchema, parseUpstream, rangeQuery, recordOutputSchema, seriesRangeQuery, timeSchema, timezoneSchema, unitSchema, uuidSchema, } from "../schemas.js";
+const metricTypeSchema = z.enum([
+    "browser",
+    "channel",
+    "city",
+    "country",
+    "device",
+    "domain",
+    "entry",
+    "event",
+    "exit",
+    "fullPath",
+    "hostname",
+    "language",
+    "os",
+    "path",
+    "query",
+    "referrer",
+    "region",
+    "screen",
+    "tag",
+    "title",
+]);
+export const coreModule = {
+    id: "core",
+    access: "read",
+    register(server, { client, config }) {
+        server.registerTool("list_websites", {
+            title: "List Umami websites",
+            description: "List websites visible to the configured Umami identity. If UMAMI_WEBSITE_IDS is set, returns only that exact allowlist.",
+            inputSchema: {
+                page: pageSchema,
+                pageSize: pageSizeSchema,
+                search: z.string().max(500).optional(),
+            },
+            outputSchema: pagedOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ page, pageSize, search }, extra) => runTool(() => client.listWebsites({ page, pageSize, search }, extra.signal)));
+        server.registerTool("get_website", {
+            title: "Get an Umami website",
+            description: "Get metadata for one website.",
+            inputSchema: { websiteId: uuidSchema },
+            outputSchema: recordOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId }, extra) => runTool(() => client.getWebsite(websiteId, extra.signal)));
+        server.registerTool("get_website_stats", {
+            title: "Get website statistics",
+            description: "Get visits, visitors, pageviews, bounces, visit duration and Umami's comparison values for a time range.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: recordOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, filters }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/stats`, rangeQuery(start, end, config.maxRangeDays, { filters }), extra.signal);
+        }));
+        server.registerTool("get_pageviews", {
+            title: "Get pageview and session series",
+            description: "Get Umami 3.2 pageview and session time series. Both arrays are preserved in the response.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                timezone: timezoneSchema,
+                unit: unitSchema,
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: pageviewsOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, timezone, unit, filters }, extra) => runTool(async () => {
+            client.assertWebsiteAllowed(websiteId);
+            return parseUpstream(pageviewsDataSchema, await client.get(`websites/${encodeURIComponent(websiteId)}/pageviews`, seriesRangeQuery(start, end, config.maxRangeDays, {
+                filters,
+                timezone,
+                unit,
+                seriesCount: 2,
+            }), extra.signal), "pageview series");
+        }));
+        server.registerTool("get_metrics", {
+            title: "Break down website metrics",
+            description: "Get a ranked aggregate Umami metric breakdown such as paths, referrers, countries, devices, events, channels or URLs. Visitor identifiers are excluded from the core toolset.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                type: metricTypeSchema,
+                limit: z.number().int().min(1).max(100).default(20),
+                offset: z.number().int().min(0).max(10_000).default(0),
+                search: z.string().max(500).optional(),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: arrayOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, type, limit, offset, search, filters }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/metrics`, {
+                ...rangeQuery(start, end, config.maxRangeDays, { filters }),
+                type,
+                limit,
+                offset,
+                search,
+            }, extra.signal);
+        }));
+        server.registerTool("get_active_visitors", {
+            title: "Get active visitors",
+            description: "Get the current number of active visitors for a website.",
+            inputSchema: { websiteId: uuidSchema },
+            outputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/active`, undefined, extra.signal);
+        }));
+        server.registerTool("get_website_date_range", {
+            title: "Get website data range",
+            description: "Get the earliest and latest analytics timestamps available for a website.",
+            inputSchema: { websiteId: uuidSchema },
+            outputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/daterange`, undefined, extra.signal);
+        }));
+    },
+};
+//# sourceMappingURL=core.js.map

package/dist/mcp/modules/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/mcp/modules/core.ts"],"names":[],"mappings":"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"}

package/dist/mcp/modules/events.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from "../tool-module.js";
+export declare const eventsModule: ToolModule;
+//# sourceMappingURL=events.d.ts.map

package/dist/mcp/modules/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/mcp/modules/events.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,YAAY,EAAE,UAwG1B,CAAC"}

package/dist/mcp/modules/events.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { READ_ONLY_ANNOTATIONS, runTool } from "../result.js";
+import { arrayOutputSchema, filtersSchema, outputSchema, pagedOutputSchema, pageSchema, pageSizeSchema, rangeQuery, selectSafeSeriesUnit, seriesRangeQuery, timeSchema, timezoneSchema, unitSchema, uuidSchema, } from "../schemas.js";
+export const eventsModule = {
+    id: "events",
+    access: "read",
+    register(server, { client, config }) {
+        server.registerTool("list_events", {
+            title: "List Umami events",
+            description: "List and search custom events for a website and time range.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                page: pageSchema,
+                pageSize: pageSizeSchema,
+                search: z.string().max(500).optional(),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: pagedOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, page, pageSize, search, filters }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/events`, {
+                ...rangeQuery(start, end, config.maxRangeDays, {
+                    filters: { ...filters, eventType: 2 },
+                }),
+                page,
+                pageSize,
+                search,
+            }, extra.signal);
+        }));
+        server.registerTool("get_event_stats", {
+            title: "Get event statistics",
+            description: "Get aggregate custom-event statistics and comparison values.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                filters: filtersSchema.optional(),
+            },
+            outputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, filters }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/events/stats`, rangeQuery(start, end, config.maxRangeDays, { filters }), extra.signal);
+        }));
+        server.registerTool("get_event_series", {
+            title: "Get event time series",
+            description: "Get custom-event counts over time, optionally filtered to a named event.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                timezone: timezoneSchema,
+                unit: unitSchema.describe("Optional series unit; when omitted Compass selects the finest granularity within its point budget"),
+                limit: z.number().int().min(1).max(100).default(20),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: arrayOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, timezone, unit, limit, filters }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            const effectiveUnit = unit ?? selectSafeSeriesUnit(start, end, config.maxRangeDays, limit);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/events/series`, {
+                ...seriesRangeQuery(start, end, config.maxRangeDays, {
+                    filters,
+                    timezone,
+                    unit: effectiveUnit,
+                    seriesCount: limit,
+                }),
+                limit,
+            }, extra.signal);
+        }));
+    },
+};
+//# sourceMappingURL=events.js.map

package/dist/mcp/modules/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/mcp/modules/events.ts"],"names":[],"mappings":"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"}

package/dist/mcp/modules/heatmaps.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from "../tool-module.js";
+export declare const heatmapsModule: ToolModule;
+//# sourceMappingURL=heatmaps.d.ts.map

package/dist/mcp/modules/heatmaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatmaps.d.ts","sourceRoot":"","sources":["../../../src/mcp/modules/heatmaps.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAoDpD,eAAO,MAAM,cAAc,EAAE,UA2C5B,CAAC"}

package/dist/mcp/modules/heatmaps.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { parseTimeRange } from "../../time.js";
+import { reportFilters, requireRecord } from "../report-utils.js";
+import { READ_ONLY_ANNOTATIONS, runTool } from "../result.js";
+import { filtersSchema, recordOutputSchema, timeSchema, uuidSchema } from "../schemas.js";
+function boundHeatmapResult(value, limits) {
+    if (typeof value !== "object" || value === null)
+        return value;
+    const result = value;
+    const { maxBuckets, maxPages, maxPoints } = limits;
+    const pages = Array.isArray(result.pages) ? result.pages : undefined;
+    const points = Array.isArray(result.points) ? result.points : undefined;
+    const scroll = typeof result.scroll === "object" && result.scroll !== null && !Array.isArray(result.scroll)
+        ? result.scroll
+        : undefined;
+    const buckets = scroll && Array.isArray(scroll.buckets) ? scroll.buckets : undefined;
+    return {
+        ...result,
+        ...(pages
+            ? {
+                pages: pages.slice(0, maxPages),
+                pageLimit: maxPages,
+                pagesTruncated: pages.length > maxPages,
+                totalPages: pages.length,
+            }
+            : {}),
+        ...(points
+            ? {
+                points: points.slice(0, maxPoints),
+                pointLimit: maxPoints,
+                pointsTruncated: points.length > maxPoints,
+                totalPoints: points.length,
+            }
+            : {}),
+        ...(scroll
+            ? {
+                scroll: {
+                    ...scroll,
+                    ...(buckets
+                        ? {
+                            buckets: buckets.slice(0, maxBuckets),
+                            bucketLimit: maxBuckets,
+                            bucketsTruncated: buckets.length > maxBuckets,
+                            totalBuckets: buckets.length,
+                        }
+                        : {}),
+                },
+            }
+            : {}),
+    };
+}
+export const heatmapsModule = {
+    id: "heatmaps",
+    access: "read",
+    register(server, { client, config }) {
+        server.registerTool("get_heatmap", {
+            title: "Get an Umami heatmap",
+            description: "Get Umami 3.2 click or scroll heatmap data. Omit urlPath to list available pages; provide it for bounded detail points.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                mode: z.enum(["click", "scroll"]).default("click"),
+                urlPath: z.string().min(1).max(500).optional(),
+                maxPoints: z.number().int().min(1).max(1_000).default(500),
+                maxBuckets: z.number().int().min(1).max(1_000).default(200),
+                maxPages: z.number().int().min(1).max(500).default(100),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: recordOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, mode, urlPath, maxPoints, maxBuckets, maxPages, filters }, extra) => runTool(async () => {
+            const { startAt, endAt } = parseTimeRange(start, end, config.maxRangeDays);
+            const body = {
+                websiteId,
+                type: "heatmap",
+                parameters: {
+                    startDate: new Date(startAt).toISOString(),
+                    endDate: new Date(endAt).toISOString(),
+                    mode,
+                    ...(urlPath === undefined ? {} : { urlPath }),
+                },
+                filters: reportFilters(filters),
+            };
+            const result = requireRecord(await client.getHeatmapReport(body, extra.signal));
+            return boundHeatmapResult(result, { maxBuckets, maxPages, maxPoints });
+        }));
+    },
+};
+//# sourceMappingURL=heatmaps.js.map

package/dist/mcp/modules/heatmaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatmaps.js","sourceRoot":"","sources":["../../../src/mcp/modules/heatmaps.ts"],"names":[],"mappings":"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"}

package/dist/mcp/modules/performance.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from "../tool-module.js";
+export declare const performanceModule: ToolModule;
+//# sourceMappingURL=performance.d.ts.map

package/dist/mcp/modules/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../src/mcp/modules/performance.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAuEpD,eAAO,MAAM,iBAAiB,EAAE,UA8F/B,CAAC"}