umami-compass 0.1.2 → 0.2.0

package/dist/mcp/insights-utils.d.ts

@@ -0,0 +1,162 @@
+import type { z } from "zod";
+import type { UmamiClient } from "../api/client.js";
+import type { Website } from "../api/types.js";
+import type { TimeInput } from "../time.js";
+import { type filtersSchema } from "./schemas.js";
+export declare const TRAFFIC_DIMENSIONS: readonly ["path", "referrer", "country", "device", "channel", "event"];
+export type TrafficDimension = (typeof TRAFFIC_DIMENSIONS)[number];
+export interface TimePeriod {
+    endAt: number;
+    startAt: number;
+}
+export interface WebsiteTotals {
+    bounces: number;
+    pageviews: number;
+    totaltime: number;
+    visitors: number;
+    visits: number;
+}
+export interface WebsiteStats extends WebsiteTotals {
+    comparison?: WebsiteTotals;
+}
+type Filters = z.infer<typeof filtersSchema> | undefined;
+export declare function finiteNumber(value: unknown): number | undefined;
+export declare function parseWebsiteStats(value: unknown): WebsiteStats;
+export declare function percentChange(current: number, comparison: number): number | null;
+export declare function totalsChanges(current: WebsiteTotals, comparison: WebsiteTotals): {
+    [k: string]: {
+        absolute: number;
+        percent: number | null;
+    };
+};
+export declare function isoPeriod(period: TimePeriod): {
+    start: string;
+    end: string;
+};
+export declare function normalizePeriod(start: TimeInput, end: TimeInput, maxRangeDays: number): TimePeriod;
+export declare function comparisonPeriod(current: TimePeriod, mode: "previous" | "year_over_year"): TimePeriod;
+export declare function mapConcurrent<T, R>(values: readonly T[], concurrency: number, operation: (value: T, index: number) => Promise<R>): Promise<R[]>;
+export declare function fetchWebsiteStats(client: UmamiClient, websiteId: string, period: TimePeriod, maxRangeDays: number, filters: Filters, signal?: AbortSignal): Promise<WebsiteStats>;
+export interface TrafficComparisonInput {
+    comparison: TimePeriod;
+    current: TimePeriod;
+    dimensions: readonly TrafficDimension[];
+    filters?: Filters;
+    limit: number;
+    maxRangeDays: number;
+    signal?: AbortSignal;
+    website: Pick<Website, "domain" | "id" | "name">;
+}
+export declare function compareTraffic(client: UmamiClient, input: TrafficComparisonInput): Promise<{
+    dataStatus: "available" | "empty";
+    website: Pick<Website, "domain" | "id" | "name">;
+    currentPeriod: {
+        start: string;
+        end: string;
+    };
+    comparisonPeriod: {
+        start: string;
+        end: string;
+    };
+    current: WebsiteTotals;
+    comparison: WebsiteTotals;
+    changes: {
+        [k: string]: {
+            absolute: number;
+            percent: number | null;
+        };
+    };
+    direction: string;
+    explanation: string;
+    breakdownMeasure: string;
+    breakdowns: ({
+        dimension: "channel" | "country" | "device" | "event" | "path" | "referrer";
+        status: "available";
+        measure: "visitors";
+        rows: {
+            name: string;
+            current: number;
+            comparison: number;
+            delta: number;
+            percent: number | null;
+            direction: string;
+        }[];
+        dataQuality: {
+            currentRowsTruncated: boolean;
+            comparisonRowsTruncated: boolean;
+            omittedUncertainRows: number;
+        };
+        error?: undefined;
+    } | {
+        measure?: undefined;
+        rows?: undefined;
+        dataQuality?: undefined;
+        dimension: "channel" | "country" | "device" | "event" | "path" | "referrer";
+        status: "unavailable";
+        error: {
+            code: import("../api/errors.js").UmamiErrorCode;
+            message: string;
+            retryable: boolean;
+            status?: number;
+        };
+    })[];
+    leadingObservedChanges: {
+        name: string;
+        current: number;
+        comparison: number;
+        delta: number;
+        percent: number | null;
+        direction: string;
+        dimension: "channel" | "country" | "device" | "event" | "path" | "referrer";
+    }[];
+    dataQuality: {
+        comparisonBaselineZero: boolean;
+        currentPageviews: number;
+        comparisonPageviews: number;
+        unavailableDimensions: ("channel" | "country" | "device" | "event" | "path" | "referrer")[];
+        truncatedDimensions: ("channel" | "country" | "device" | "event" | "path" | "referrer")[];
+        omittedUncertainRows: number;
+    };
+}>;
+export declare function comparePerformance(client: UmamiClient, input: {
+    comparison: TimePeriod;
+    current: TimePeriod;
+    filters?: Filters;
+    signal?: AbortSignal;
+    timezone: string;
+    websiteId: string;
+}): Promise<{
+    error?: undefined;
+    status: "available" | "empty";
+    currentSampleCount: number;
+    comparisonSampleCount: number;
+    minimumSampleCount: number;
+    sampleSufficient: boolean;
+    changes: {
+        [k: string]: {
+            currentP75: number;
+            comparisonP75: number;
+            absolute: number;
+            percent: number | null;
+            impact: string;
+            material: boolean;
+            currentRating: "good" | "needs_improvement" | "poor";
+            comparisonRating: "good" | "needs_improvement" | "poor";
+        };
+    };
+} | {
+    currentSampleCount?: undefined;
+    comparisonSampleCount?: undefined;
+    minimumSampleCount?: undefined;
+    sampleSufficient?: undefined;
+    changes?: undefined;
+    status: string;
+    error: {
+        code: import("../api/errors.js").UmamiErrorCode;
+        message: string;
+        retryable: boolean;
+        status?: number;
+    };
+}>;
+export {};
+//# sourceMappingURL=insights-utils.d.ts.map

package/dist/mcp/insights-utils.d.ts.map

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

package/dist/mcp/insights-utils.js

@@ -0,0 +1,377 @@
+import { toSafeError, UmamiError } from "../api/errors.js";
+import { parseTimeRange } from "../time.js";
+import { reportFilters } from "./report-utils.js";
+import { rangeQuery } from "./schemas.js";
+export const TRAFFIC_DIMENSIONS = [
+    "path",
+    "referrer",
+    "country",
+    "device",
+    "channel",
+    "event",
+];
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function finiteNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value !== "string" || value.trim() === "")
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function requireNumber(record, key) {
+    const value = finiteNumber(record[key]);
+    if (value === undefined) {
+        throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid website statistics.");
+    }
+    return value;
+}
+function parseTotals(value) {
+    if (!isRecord(value)) {
+        throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid website statistics.");
+    }
+    return {
+        pageviews: requireNumber(value, "pageviews"),
+        visitors: requireNumber(value, "visitors"),
+        visits: requireNumber(value, "visits"),
+        bounces: requireNumber(value, "bounces"),
+        totaltime: requireNumber(value, "totaltime"),
+    };
+}
+export function parseWebsiteStats(value) {
+    const totals = parseTotals(value);
+    const comparison = isRecord(value) && value.comparison !== undefined ? parseTotals(value.comparison) : undefined;
+    return { ...totals, ...(comparison ? { comparison } : {}) };
+}
+export function percentChange(current, comparison) {
+    if (comparison === 0)
+        return current === 0 ? 0 : null;
+    return Math.round(((current - comparison) / Math.abs(comparison)) * 10_000) / 100;
+}
+export function totalsChanges(current, comparison) {
+    return Object.fromEntries(Object.keys(current).map((key) => [
+        key,
+        {
+            absolute: current[key] - comparison[key],
+            percent: percentChange(current[key], comparison[key]),
+        },
+    ]));
+}
+function websiteTotals(stats) {
+    return {
+        pageviews: stats.pageviews,
+        visitors: stats.visitors,
+        visits: stats.visits,
+        bounces: stats.bounces,
+        totaltime: stats.totaltime,
+    };
+}
+export function isoPeriod(period) {
+    return {
+        start: new Date(period.startAt).toISOString(),
+        end: new Date(period.endAt).toISOString(),
+    };
+}
+export function normalizePeriod(start, end, maxRangeDays) {
+    return parseTimeRange(start, end, maxRangeDays);
+}
+function shiftUtcYear(timestamp, years) {
+    const source = new Date(timestamp);
+    const year = source.getUTCFullYear() + years;
+    const month = source.getUTCMonth();
+    const day = source.getUTCDate();
+    const lastDay = new Date(Date.UTC(year, month + 1, 0)).getUTCDate();
+    return Date.UTC(year, month, Math.min(day, lastDay), source.getUTCHours(), source.getUTCMinutes(), source.getUTCSeconds(), source.getUTCMilliseconds());
+}
+export function comparisonPeriod(current, mode) {
+    if (mode === "year_over_year") {
+        return {
+            startAt: shiftUtcYear(current.startAt, -1),
+            endAt: shiftUtcYear(current.endAt, -1),
+        };
+    }
+    const duration = current.endAt - current.startAt;
+    const endAt = current.startAt - 1;
+    return { startAt: endAt - duration, endAt };
+}
+export async function mapConcurrent(values, concurrency, operation) {
+    const results = new Array(values.length);
+    let nextIndex = 0;
+    const workers = Array.from({ length: Math.min(concurrency, values.length) }, async () => {
+        while (nextIndex < values.length) {
+            const index = nextIndex;
+            nextIndex += 1;
+            results[index] = await operation(values[index], index);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+export async function fetchWebsiteStats(client, websiteId, period, maxRangeDays, filters, signal) {
+    return parseWebsiteStats(await client.get(`websites/${encodeURIComponent(websiteId)}/stats`, rangeQuery(period.startAt, period.endAt, maxRangeDays, {
+        filters,
+    }), signal));
+}
+const MAX_METRIC_COMPARISON_ROWS = 100;
+function parseMetricRows(value) {
+    if (!Array.isArray(value)) {
+        throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid metric breakdown data.");
+    }
+    const rows = [];
+    for (const item of value) {
+        if (!isRecord(item))
+            continue;
+        const number = finiteNumber(item.y);
+        if (typeof item.x !== "string" || number === undefined)
+            continue;
+        rows.push({ name: item.x, value: number });
+    }
+    return rows;
+}
+async function fetchMetricRows(client, websiteId, period, maxRangeDays, dimension, limit, filters, signal) {
+    const rows = parseMetricRows(await client.get(`websites/${encodeURIComponent(websiteId)}/metrics`, {
+        ...rangeQuery(period.startAt, period.endAt, maxRangeDays, {
+            filters,
+        }),
+        type: dimension,
+        limit,
+        offset: 0,
+    }, signal));
+    return { rows, truncated: rows.length >= limit };
+}
+function diffMetricRows(currentResult, comparisonResult, limit) {
+    const { rows: current, truncated: currentTruncated } = currentResult;
+    const { rows: comparison, truncated: comparisonTruncated } = comparisonResult;
+    const names = new Set([
+        ...current.map(({ name }) => name),
+        ...comparison.map(({ name }) => name),
+    ]);
+    const currentMap = new Map(current.map(({ name, value }) => [name, value]));
+    const comparisonMap = new Map(comparison.map(({ name, value }) => [name, value]));
+    let omittedUncertainRows = 0;
+    const rows = [...names]
+        .flatMap((name) => {
+        if ((!currentMap.has(name) && currentTruncated) ||
+            (!comparisonMap.has(name) && comparisonTruncated)) {
+            omittedUncertainRows += 1;
+            return [];
+        }
+        const currentValue = currentMap.get(name) ?? 0;
+        const comparisonValue = comparisonMap.get(name) ?? 0;
+        const delta = currentValue - comparisonValue;
+        return [
+            {
+                name,
+                current: currentValue,
+                comparison: comparisonValue,
+                delta,
+                percent: percentChange(currentValue, comparisonValue),
+                direction: delta > 0 ? "up" : delta < 0 ? "down" : "flat",
+            },
+        ];
+    })
+        .sort((left, right) => Math.abs(right.delta) - Math.abs(left.delta) || left.name.localeCompare(right.name))
+        .slice(0, limit);
+    return {
+        rows,
+        dataQuality: {
+            currentRowsTruncated: currentTruncated,
+            comparisonRowsTruncated: comparisonTruncated,
+            omittedUncertainRows,
+        },
+    };
+}
+export async function compareTraffic(client, input) {
+    const { comparison, current, dimensions, filters, limit, maxRangeDays, signal, website } = input;
+    const [currentStats, comparisonStats] = await Promise.all([
+        fetchWebsiteStats(client, website.id, current, maxRangeDays, filters, signal),
+        fetchWebsiteStats(client, website.id, comparison, maxRangeDays, filters, signal),
+    ]);
+    const currentTotals = websiteTotals(currentStats);
+    const comparisonTotals = websiteTotals(comparisonStats);
+    const metricFetchLimit = Math.min(MAX_METRIC_COMPARISON_ROWS, Math.max(limit * 5, 20));
+    const breakdowns = await mapConcurrent(dimensions, 3, async (dimension) => {
+        try {
+            const [currentRows, comparisonRows] = await Promise.all([
+                fetchMetricRows(client, website.id, current, maxRangeDays, dimension, metricFetchLimit, filters, signal),
+                fetchMetricRows(client, website.id, comparison, maxRangeDays, dimension, metricFetchLimit, filters, signal),
+            ]);
+            const difference = diffMetricRows(currentRows, comparisonRows, limit);
+            return {
+                dimension,
+                status: "available",
+                measure: "visitors",
+                rows: difference.rows,
+                dataQuality: difference.dataQuality,
+            };
+        }
+        catch (error) {
+            return {
+                dimension,
+                status: "unavailable",
+                error: toSafeError(error),
+            };
+        }
+    });
+    const leadingObservedChanges = breakdowns
+        .filter((item) => item.status === "available")
+        .flatMap((item) => item.rows.slice(0, 1).map((row) => ({
+        dimension: item.dimension,
+        ...row,
+    })))
+        .sort((left, right) => Math.abs(right.delta) - Math.abs(left.delta))
+        .slice(0, 5);
+    const pageviewDelta = currentTotals.pageviews - comparisonTotals.pageviews;
+    const pageviewPercent = percentChange(currentTotals.pageviews, comparisonTotals.pageviews);
+    const direction = pageviewDelta > 0 ? "increase" : pageviewDelta < 0 ? "decrease" : "flat";
+    const leading = leadingObservedChanges[0];
+    const explanation = leading
+        ? `Traffic shows a ${direction}${pageviewPercent === null ? "" : ` of ${Math.abs(pageviewPercent)}%`}. The largest observed breakdown change is ${leading.dimension}=${leading.name} (${leading.delta > 0 ? "+" : ""}${leading.delta} visitors); this is evidence of association, not proof of causation.`
+        : `Traffic shows a ${direction}${pageviewPercent === null ? "" : ` of ${Math.abs(pageviewPercent)}%`}. No authorized breakdown produced enough evidence to identify a leading observed change.`;
+    return {
+        dataStatus: currentTotals.pageviews === 0 &&
+            currentTotals.visitors === 0 &&
+            currentTotals.visits === 0 &&
+            comparisonTotals.pageviews === 0 &&
+            comparisonTotals.visitors === 0 &&
+            comparisonTotals.visits === 0
+            ? "empty"
+            : "available",
+        website,
+        currentPeriod: isoPeriod(current),
+        comparisonPeriod: isoPeriod(comparison),
+        current: currentTotals,
+        comparison: comparisonTotals,
+        changes: totalsChanges(currentTotals, comparisonTotals),
+        direction,
+        explanation,
+        breakdownMeasure: "visitors",
+        breakdowns,
+        leadingObservedChanges,
+        dataQuality: {
+            comparisonBaselineZero: comparisonTotals.pageviews === 0,
+            currentPageviews: currentTotals.pageviews,
+            comparisonPageviews: comparisonTotals.pageviews,
+            unavailableDimensions: breakdowns
+                .filter((item) => item.status === "unavailable")
+                .map(({ dimension }) => dimension),
+            truncatedDimensions: breakdowns
+                .filter((item) => item.status === "available" &&
+                (item.dataQuality.currentRowsTruncated || item.dataQuality.comparisonRowsTruncated))
+                .map(({ dimension }) => dimension),
+            omittedUncertainRows: breakdowns
+                .filter((item) => item.status === "available")
+                .reduce((total, item) => total + item.dataQuality.omittedUncertainRows, 0),
+        },
+    };
+}
+const WEB_VITAL_THRESHOLDS = {
+    lcp: [2_500, 4_000],
+    inp: [200, 500],
+    cls: [0.1, 0.25],
+    fcp: [1_800, 3_000],
+    ttfb: [800, 1_800],
+};
+const MIN_PERFORMANCE_SAMPLES = 100;
+const MIN_PERFORMANCE_CHANGE_PERCENT = 5;
+const MIN_PERFORMANCE_ABSOLUTE_CHANGE = {
+    lcp: 100,
+    inp: 20,
+    cls: 0.02,
+    fcp: 100,
+    ttfb: 50,
+};
+function vitalRating(metric, value) {
+    const [good, poor] = WEB_VITAL_THRESHOLDS[metric];
+    return value <= good ? "good" : value <= poor ? "needs_improvement" : "poor";
+}
+function performanceSummary(value) {
+    if (!isRecord(value) || !isRecord(value.summary)) {
+        throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid performance summary data.");
+    }
+    const summary = value.summary;
+    const count = finiteNumber(summary.count);
+    if (count === undefined) {
+        throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid performance summary data.");
+    }
+    const metrics = Object.fromEntries(Object.keys(WEB_VITAL_THRESHOLDS).map((metric) => {
+        const row = summary[metric];
+        const p75 = isRecord(row) ? finiteNumber(row.p75) : undefined;
+        if (p75 === undefined) {
+            throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid performance summary data.");
+        }
+        return [metric, { p75, rating: vitalRating(metric, p75) }];
+    }));
+    return { count, metrics };
+}
+export async function comparePerformance(client, input) {
+    const request = (period) => ({
+        websiteId: input.websiteId,
+        type: "performance",
+        parameters: {
+            startDate: new Date(period.startAt).toISOString(),
+            endDate: new Date(period.endAt).toISOString(),
+            metric: "lcp",
+            timezone: input.timezone,
+            unit: "day",
+        },
+        filters: reportFilters(input.filters),
+    });
+    try {
+        const [currentResult, comparisonResult] = await Promise.all([
+            client.runReport(request(input.current), input.signal),
+            client.runReport(request(input.comparison), input.signal),
+        ]);
+        const current = performanceSummary(currentResult);
+        const comparison = performanceSummary(comparisonResult);
+        const sampleSufficient = current.count >= MIN_PERFORMANCE_SAMPLES && comparison.count >= MIN_PERFORMANCE_SAMPLES;
+        const changes = Object.fromEntries(Object.keys(WEB_VITAL_THRESHOLDS).map((metric) => {
+            const currentP75 = current.metrics[metric].p75;
+            const comparisonP75 = comparison.metrics[metric].p75;
+            const absolute = currentP75 - comparisonP75;
+            const percent = percentChange(currentP75, comparisonP75);
+            const ratingOrder = { good: 0, needs_improvement: 1, poor: 2 };
+            const currentRating = current.metrics[metric].rating;
+            const comparisonRating = comparison.metrics[metric].rating;
+            const ratingDelta = ratingOrder[currentRating] - ratingOrder[comparisonRating];
+            const materiallyChanged = Math.abs(absolute) >= MIN_PERFORMANCE_ABSOLUTE_CHANGE[metric] &&
+                percent !== null &&
+                Math.abs(percent) >= MIN_PERFORMANCE_CHANGE_PERCENT;
+            const impact = !sampleSufficient
+                ? "inconclusive"
+                : ratingDelta > 0 || (absolute > 0 && materiallyChanged)
+                    ? "regressed"
+                    : ratingDelta < 0 || (absolute < 0 && materiallyChanged)
+                        ? "improved"
+                        : "unchanged";
+            return [
+                metric,
+                {
+                    currentP75,
+                    comparisonP75,
+                    absolute,
+                    percent,
+                    impact,
+                    material: impact === "regressed" || impact === "improved",
+                    currentRating,
+                    comparisonRating,
+                },
+            ];
+        }));
+        const status = current.count === 0 && comparison.count === 0 ? "empty" : "available";
+        return {
+            status,
+            currentSampleCount: current.count,
+            comparisonSampleCount: comparison.count,
+            minimumSampleCount: MIN_PERFORMANCE_SAMPLES,
+            sampleSufficient,
+            changes,
+        };
+    }
+    catch (error) {
+        return { status: "unavailable", error: toSafeError(error) };
+    }
+}
+//# sourceMappingURL=insights-utils.js.map

package/dist/mcp/insights-utils.js.map

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

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

@@ -1 +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"}
+{"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,UA6LxB,CAAC"}

package/dist/mcp/modules/core.js

@@ -29,7 +29,7 @@ export const coreModule = {
     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.",
+            description: "List websites visible directly or through any team membership of the configured Umami identity. If UMAMI_WEBSITE_IDS is set, returns only that exact allowlist.",
             inputSchema: {
                 page: pageSchema,
                 pageSize: pageSizeSchema,
@@ -44,7 +44,7 @@ export const coreModule = {
             inputSchema: { websiteId: uuidSchema },
             outputSchema: recordOutputSchema,
             annotations: READ_ONLY_ANNOTATIONS,
-        }, ({ websiteId }, extra) => runTool(() => client.getWebsite(websiteId, extra.signal)));
+        }, ({ websiteId }, extra) => runTool(() => client.getWebsite(websiteId, extra.signal), { websiteId }));
         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.",
@@ -59,7 +59,7 @@ export const coreModule = {
         }, ({ websiteId, start, end, filters }, extra) => runTool(() => {
             client.assertWebsiteAllowed(websiteId);
             return client.get(`websites/${encodeURIComponent(websiteId)}/stats`, rangeQuery(start, end, config.maxRangeDays, { filters }), extra.signal);
-        }));
+        }, { websiteId, range: { start, end } }));
         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.",
@@ -81,7 +81,7 @@ export const coreModule = {
                 unit,
                 seriesCount: 2,
             }), extra.signal), "pageview series");
-        }));
+        }, { websiteId, range: { start, end }, timezone }));
         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.",
@@ -106,7 +106,7 @@ export const coreModule = {
                 offset,
                 search,
             }, extra.signal);
-        }));
+        }, { websiteId, range: { start, end } }));
         server.registerTool("get_active_visitors", {
             title: "Get active visitors",
             description: "Get the current number of active visitors for a website.",
@@ -116,7 +116,7 @@ export const coreModule = {
         }, ({ websiteId }, extra) => runTool(() => {
             client.assertWebsiteAllowed(websiteId);
             return client.get(`websites/${encodeURIComponent(websiteId)}/active`, undefined, extra.signal);
-        }));
+        }, { websiteId }));
         server.registerTool("get_website_date_range", {
             title: "Get website data range",
             description: "Get the earliest and latest analytics timestamps available for a website.",
@@ -126,7 +126,7 @@ export const coreModule = {
         }, ({ websiteId }, extra) => runTool(() => {
             client.assertWebsiteAllowed(websiteId);
             return client.get(`websites/${encodeURIComponent(websiteId)}/daterange`, undefined, extra.signal);
-        }));
+        }, { websiteId }));
     },
 };
 //# sourceMappingURL=core.js.map