umami-compass 0.1.0

package/dist/mcp/modules/sessions.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { boundedItems } from "../report-utils.js";
+import { READ_ONLY_ANNOTATIONS, runTool } from "../result.js";
+import { boundedItemsOutputSchema, filtersSchema, pagedOutputSchema, pageSchema, pageSizeSchema, rangeQuery, recordOutputSchema, timeSchema, uuidSchema, } from "../schemas.js";
+export const sessionsModule = {
+    id: "sessions",
+    access: "read",
+    register(server, { client, config }) {
+        server.registerTool("list_sessions", {
+            title: "List Umami sessions",
+            description: "List and search visitor sessions 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)}/sessions`, {
+                ...rangeQuery(start, end, config.maxRangeDays, { filters }),
+                page,
+                pageSize,
+                search,
+            }, extra.signal);
+        }));
+        server.registerTool("get_session_stats", {
+            title: "Get session statistics",
+            description: "Get aggregate session metrics for a website and 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)}/sessions/stats`, rangeQuery(start, end, config.maxRangeDays, { filters }), extra.signal);
+        }));
+        server.registerTool("get_session", {
+            title: "Get a session",
+            description: "Get metadata for one Umami visitor session.",
+            inputSchema: { websiteId: uuidSchema, sessionId: uuidSchema },
+            outputSchema: recordOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, sessionId }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/sessions/${encodeURIComponent(sessionId)}`, undefined, extra.signal);
+        }));
+        server.registerTool("get_session_activity", {
+            title: "Get session activity",
+            description: "Get a bounded list of pageviews and events that occurred during one session and time range.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                sessionId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                maxItems: z.number().int().min(1).max(1_000).default(500),
+            },
+            outputSchema: boundedItemsOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, sessionId, start, end, maxItems }, extra) => runTool(async () => {
+            client.assertWebsiteAllowed(websiteId);
+            return boundedItems(await client.get(`websites/${encodeURIComponent(websiteId)}/sessions/${encodeURIComponent(sessionId)}/activity`, rangeQuery(start, end, config.maxRangeDays), extra.signal), maxItems);
+        }));
+    },
+};
+//# sourceMappingURL=sessions.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { TimeInput } from "../time.js";
+export declare function reportDateRange(start: TimeInput, end: TimeInput, maxRangeDays: number): {
+    endDate: string;
+    startDate: string;
+};
+export declare function reportFilters(filters: Record<string, unknown> | undefined): Record<string, unknown>;
+export declare function boundedItems(value: unknown, limit: number): {
+    itemLimit: number;
+    items: unknown[];
+    itemsTruncated: boolean;
+    totalItems: number;
+};
+export declare function boundTopLevelArrays(value: unknown, limit: number): unknown;
+export declare function requireRecord(value: unknown): Record<string, unknown>;
+//# sourceMappingURL=report-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report-utils.d.ts","sourceRoot":"","sources":["../../src/mcp/report-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAMxC;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,CAUA;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAwB1E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKrE"}

package/dist/mcp/report-utils.js

@@ -0,0 +1,58 @@
+import { UmamiError } from "../api/errors.js";
+import { parseTimeRange } from "../time.js";
+export function reportDateRange(start, end, maxRangeDays) {
+    const { startAt, endAt } = parseTimeRange(start, end, maxRangeDays);
+    return {
+        startDate: new Date(startAt).toISOString(),
+        endDate: new Date(endAt).toISOString(),
+    };
+}
+export function reportFilters(filters) {
+    const { excludeBounce, ...rest } = filters ?? {};
+    return {
+        ...rest,
+        ...(excludeBounce === true ? { excludeBounce: "true" } : {}),
+    };
+}
+export function boundedItems(value, limit) {
+    if (!Array.isArray(value)) {
+        throw new UmamiError("INVALID_RESPONSE", "Umami returned an unexpected report response.");
+    }
+    return {
+        items: value.slice(0, limit),
+        itemLimit: limit,
+        itemsTruncated: value.length > limit,
+        totalItems: value.length,
+    };
+}
+export function boundTopLevelArrays(value, limit) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return Array.isArray(value) ? boundedItems(value, limit) : value;
+    }
+    const result = { ...value };
+    const arrays = {};
+    for (const [key, item] of Object.entries(result)) {
+        if (!Array.isArray(item))
+            continue;
+        result[key] = item.slice(0, limit);
+        arrays[key] = {
+            returnedItems: Math.min(item.length, limit),
+            totalItems: item.length,
+            truncated: item.length > limit,
+        };
+    }
+    return {
+        ...result,
+        umamiCompass: {
+            arrayLimit: limit,
+            arrays,
+        },
+    };
+}
+export function requireRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new UmamiError("INVALID_RESPONSE", "Umami returned an unexpected report response.");
+    }
+    return value;
+}
+//# sourceMappingURL=report-utils.js.map

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

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

package/dist/mcp/result.d.ts

@@ -0,0 +1,27 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare const READ_ONLY_ANNOTATIONS: {
+    destructiveHint: false;
+    idempotentHint: true;
+    openWorldHint: true;
+    readOnlyHint: true;
+};
+export declare const CREATE_ANNOTATIONS: {
+    destructiveHint: false;
+    idempotentHint: false;
+    openWorldHint: true;
+    readOnlyHint: false;
+};
+export declare const UPDATE_ANNOTATIONS: {
+    destructiveHint: false;
+    idempotentHint: true;
+    openWorldHint: true;
+    readOnlyHint: false;
+};
+export declare const DESTRUCTIVE_ANNOTATIONS: {
+    destructiveHint: true;
+    idempotentHint: true;
+    openWorldHint: true;
+    readOnlyHint: false;
+};
+export declare function runTool<T>(operation: () => Promise<T>): Promise<CallToolResult>;
+//# sourceMappingURL=result.d.ts.map

package/dist/mcp/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/mcp/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,oCAAoC,CAAC;AAG1F,eAAO,MAAM,qBAAqB;;;;;CAKP,CAAC;AAE5B,eAAO,MAAM,kBAAkB;;;;;CAKJ,CAAC;AAE5B,eAAO,MAAM,kBAAkB;;;;;CAKJ,CAAC;AAE5B,eAAO,MAAM,uBAAuB;;;;;CAKT,CAAC;AAE5B,wBAAsB,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAcrF"}

package/dist/mcp/result.js

@@ -0,0 +1,42 @@
+import { toSafeError } from "../api/errors.js";
+export const READ_ONLY_ANNOTATIONS = {
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+    readOnlyHint: true,
+};
+export const CREATE_ANNOTATIONS = {
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+};
+export const UPDATE_ANNOTATIONS = {
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+    readOnlyHint: false,
+};
+export const DESTRUCTIVE_ANNOTATIONS = {
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: true,
+    readOnlyHint: false,
+};
+export async function runTool(operation) {
+    try {
+        const data = await operation();
+        const structuredContent = { data };
+        return {
+            content: [{ type: "text", text: JSON.stringify(structuredContent) }],
+            structuredContent,
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: toSafeError(error) }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/mcp/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/mcp/result.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,IAAI;CACO,CAAC;AAE5B,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,KAAK;CACM,CAAC;AAE5B,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,KAAK;CACM,CAAC;AAE5B,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,KAAK;CACM,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,SAA2B;IAC1D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC;QAC/B,MAAM,iBAAiB,GAAG,EAAE,IAAI,EAAE,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACpE,iBAAiB;SAClB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAChF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/mcp/schemas.d.ts

@@ -0,0 +1,120 @@
+import { z } from "zod";
+import type { Query } from "../api/types.js";
+import { type TimeInput } from "../time.js";
+export declare const uuidSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+export declare const timeSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+export declare const timezoneSchema: z.ZodDefault<z.ZodString>;
+export declare const unitSchema: z.ZodOptional<z.ZodEnum<{
+    day: "day";
+    hour: "hour";
+    minute: "minute";
+    month: "month";
+    year: "year";
+}>>;
+export declare const pageSchema: z.ZodDefault<z.ZodNumber>;
+export declare const pageSizeSchema: z.ZodDefault<z.ZodNumber>;
+export declare const filtersSchema: z.ZodObject<{
+    browser: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    cohort: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    country: z.ZodOptional<z.ZodString>;
+    device: z.ZodOptional<z.ZodString>;
+    distinctId: z.ZodOptional<z.ZodString>;
+    eventType: z.ZodOptional<z.ZodNumber>;
+    event: z.ZodOptional<z.ZodString>;
+    excludeBounce: z.ZodOptional<z.ZodBoolean>;
+    hostname: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    os: z.ZodOptional<z.ZodString>;
+    match: z.ZodOptional<z.ZodEnum<{
+        all: "all";
+        any: "any";
+    }>>;
+    path: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    referrer: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    segment: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    tag: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    utmCampaign: z.ZodOptional<z.ZodString>;
+    utmContent: z.ZodOptional<z.ZodString>;
+    utmMedium: z.ZodOptional<z.ZodString>;
+    utmSource: z.ZodOptional<z.ZodString>;
+    utmTerm: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare function rangeQuery(start: TimeInput, end: TimeInput, maxRangeDays: number, options?: {
+    filters?: z.infer<typeof filtersSchema>;
+    timezone?: string;
+    unit?: string;
+}): Query;
+declare const UNIT_MILLISECONDS: {
+    readonly minute: 60000;
+    readonly hour: 3600000;
+    readonly day: 86400000;
+    readonly month: 2592000000;
+    readonly year: 31536000000;
+};
+export declare function seriesRangeQuery(start: TimeInput, end: TimeInput, maxRangeDays: number, options?: {
+    filters?: z.infer<typeof filtersSchema>;
+    timezone?: string;
+    unit?: keyof typeof UNIT_MILLISECONDS;
+    seriesCount?: number;
+}): Query;
+export declare function selectSafeSeriesUnit(start: TimeInput, end: TimeInput, maxRangeDays: number, seriesCount?: number): keyof typeof UNIT_MILLISECONDS;
+export declare const outputSchema: {
+    data: z.ZodJSONSchema;
+};
+export declare const recordOutputSchema: {
+    data: z.ZodObject<{}, z.core.$loose>;
+};
+export declare const arrayOutputSchema: {
+    data: z.ZodArray<z.ZodJSONSchema>;
+};
+export declare const pagedOutputSchema: {
+    data: z.ZodObject<{
+        data: z.ZodArray<z.ZodJSONSchema>;
+        count: z.ZodNumber;
+        page: z.ZodNumber;
+        pageSize: z.ZodNumber;
+    }, z.core.$loose>;
+};
+export declare const pageviewsDataSchema: z.ZodObject<{
+    pageviews: z.ZodArray<z.ZodObject<{
+        x: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        y: z.ZodNumber;
+    }, z.core.$loose>>;
+    sessions: z.ZodArray<z.ZodObject<{
+        x: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        y: z.ZodNumber;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export declare const pageviewsOutputSchema: {
+    data: z.ZodObject<{
+        pageviews: z.ZodArray<z.ZodObject<{
+            x: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+            y: z.ZodNumber;
+        }, z.core.$loose>>;
+        sessions: z.ZodArray<z.ZodObject<{
+            x: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+            y: z.ZodNumber;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+};
+export declare const boundedItemsDataSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodJSONSchema>;
+    itemLimit: z.ZodNumber;
+    itemsTruncated: z.ZodBoolean;
+    totalItems: z.ZodNumber;
+}, z.core.$loose>;
+export declare const boundedItemsOutputSchema: {
+    data: z.ZodObject<{
+        items: z.ZodArray<z.ZodJSONSchema>;
+        itemLimit: z.ZodNumber;
+        itemsTruncated: z.ZodBoolean;
+        totalItems: z.ZodNumber;
+    }, z.core.$loose>;
+};
+export declare function parseUpstream<T>(schema: z.ZodType<T>, value: unknown, label: string): T;
+export {};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/mcp/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/mcp/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D,eAAO,MAAM,UAAU,wDAIE,CAAC;AAC1B,eAAO,MAAM,UAAU,iDAEsD,CAAC;AAC9E,eAAO,MAAM,cAAc,2BAYV,CAAC;AAClB,eAAO,MAAM,UAAU;;;;;;GAAgE,CAAC;AACxF,eAAO,MAAM,UAAU,2BAAiD,CAAC;AACzE,eAAO,MAAM,cAAc,2BAA+C,CAAC;AAE3E,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4Bf,CAAC;AAEZ,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1F,KAAK,CAUP;AAED,QAAA,MAAM,iBAAiB;;;;;;CAMb,CAAC;AAEX,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,OAAO,iBAAiB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,KAAK,CAeP;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,EACpB,WAAW,SAAI,GACd,MAAM,OAAO,iBAAiB,CAUhC;AAUD,eAAO,MAAM,YAAY;;CAExB,CAAC;AAEF,eAAO,MAAM,kBAAkB;;CAE9B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;CAS7B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;iBAKhB,CAAC;AAEjB,eAAO,MAAM,qBAAqB;;;;;;;;;;;CAEjC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;iBAOnB,CAAC;AAEjB,eAAO,MAAM,wBAAwB;;;;;;;CAEpC,CAAC;AAEF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAMvF"}

package/dist/mcp/schemas.js

@@ -0,0 +1,148 @@
+import { z } from "zod";
+import { UmamiError } from "../api/errors.js";
+import { parseTimeRange } from "../time.js";
+export const uuidSchema = z
+    .string()
+    .uuid()
+    .transform((value) => value.toLowerCase())
+    .describe("Umami UUID");
+export const timeSchema = z
+    .union([z.number().int().nonnegative(), z.string().min(1)])
+    .describe("Unix milliseconds, ISO 8601 with timezone, or YYYY-MM-DD (UTC)");
+export const timezoneSchema = z
+    .string()
+    .min(1)
+    .max(100)
+    .refine((value) => {
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: value }).format(0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, "timezone must be UTC or a valid IANA time zone")
+    .default("UTC");
+export const unitSchema = z.enum(["minute", "hour", "day", "month", "year"]).optional();
+export const pageSchema = z.number().int().min(1).max(10_000).default(1);
+export const pageSizeSchema = z.number().int().min(1).max(100).default(20);
+export const filtersSchema = z
+    .object({
+    browser: z.string().max(200).optional(),
+    city: z.string().max(200).optional(),
+    cohort: uuidSchema.optional(),
+    country: z.string().max(10).optional(),
+    device: z.string().max(200).optional(),
+    distinctId: z.string().max(500).optional(),
+    eventType: z.number().int().positive().optional(),
+    event: z.string().max(500).optional(),
+    excludeBounce: z.boolean().optional(),
+    hostname: z.string().max(500).optional(),
+    language: z.string().max(100).optional(),
+    os: z.string().max(200).optional(),
+    match: z.enum(["all", "any"]).optional(),
+    path: z.string().max(2_000).optional(),
+    query: z.string().max(2_000).optional(),
+    referrer: z.string().max(2_000).optional(),
+    region: z.string().max(200).optional(),
+    segment: uuidSchema.optional(),
+    tag: z.string().max(500).optional(),
+    title: z.string().max(1_000).optional(),
+    utmCampaign: z.string().max(500).optional(),
+    utmContent: z.string().max(500).optional(),
+    utmMedium: z.string().max(500).optional(),
+    utmSource: z.string().max(500).optional(),
+    utmTerm: z.string().max(500).optional(),
+})
+    .strict();
+export function rangeQuery(start, end, maxRangeDays, options = {}) {
+    const range = parseTimeRange(start, end, maxRangeDays);
+    const { excludeBounce, ...filters } = options.filters ?? {};
+    return {
+        ...range,
+        ...filters,
+        ...(excludeBounce === true ? { excludeBounce: true } : {}),
+        timezone: options.timezone,
+        unit: options.unit,
+    };
+}
+const UNIT_MILLISECONDS = {
+    minute: 60_000,
+    hour: 3_600_000,
+    day: 86_400_000,
+    month: 2_592_000_000,
+    year: 31_536_000_000,
+};
+export function seriesRangeQuery(start, end, maxRangeDays, options = {}) {
+    const query = rangeQuery(start, end, maxRangeDays, options);
+    if (options.unit) {
+        const bucketCount = Math.floor((query.endAt - query.startAt) / UNIT_MILLISECONDS[options.unit]) + 1;
+        if (bucketCount * (options.seriesCount ?? 1) > 10_000) {
+            throw new UmamiError("VALIDATION_ERROR", "The requested series could exceed 10,000 points. Use a coarser unit, shorter range, or smaller limit.");
+        }
+    }
+    return query;
+}
+export function selectSafeSeriesUnit(start, end, maxRangeDays, seriesCount = 1) {
+    const { startAt, endAt } = parseTimeRange(start, end, maxRangeDays);
+    for (const unit of ["minute", "hour", "day", "month", "year"]) {
+        const bucketCount = Math.floor((endAt - startAt) / UNIT_MILLISECONDS[unit]) + 1;
+        if (bucketCount * seriesCount <= 10_000)
+            return unit;
+    }
+    throw new UmamiError("VALIDATION_ERROR", "The requested event series cannot fit within the 10,000-point safety limit.");
+}
+const jsonRecordSchema = z.object({}).passthrough();
+const seriesPointSchema = z
+    .object({
+    x: z.union([z.string(), z.number()]),
+    y: z.number(),
+})
+    .passthrough();
+export const outputSchema = {
+    data: z.json().describe("JSON analytics data returned by Umami Compass"),
+};
+export const recordOutputSchema = {
+    data: jsonRecordSchema,
+};
+export const arrayOutputSchema = {
+    data: z.array(z.json()),
+};
+export const pagedOutputSchema = {
+    data: z
+        .object({
+        data: z.array(z.json()),
+        count: z.number().int().nonnegative(),
+        page: z.number().int().positive(),
+        pageSize: z.number().int().nonnegative(),
+    })
+        .passthrough(),
+};
+export const pageviewsDataSchema = z
+    .object({
+    pageviews: z.array(seriesPointSchema),
+    sessions: z.array(seriesPointSchema),
+})
+    .passthrough();
+export const pageviewsOutputSchema = {
+    data: pageviewsDataSchema,
+};
+export const boundedItemsDataSchema = z
+    .object({
+    items: z.array(z.json()),
+    itemLimit: z.number().int().positive(),
+    itemsTruncated: z.boolean(),
+    totalItems: z.number().int().nonnegative(),
+})
+    .passthrough();
+export const boundedItemsOutputSchema = {
+    data: boundedItemsDataSchema,
+};
+export function parseUpstream(schema, value, label) {
+    const parsed = schema.safeParse(value);
+    if (!parsed.success) {
+        throw new UmamiError("INVALID_RESPONSE", `Umami returned invalid ${label} data.`);
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=schemas.js.map

package/dist/mcp/schemas.js.map

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

package/dist/mcp/tool-module.d.ts

@@ -0,0 +1,19 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { UmamiClient } from "../api/client.js";
+import type { Toolset, UmamiCompassConfig } from "../config.js";
+export type ToolAccess = "read" | "write";
+export interface ToolContext {
+    client: UmamiClient;
+    config: UmamiCompassConfig;
+}
+export interface ToolModule {
+    access: ToolAccess;
+    id: Toolset;
+    register(server: McpServer, context: ToolContext): void;
+}
+export interface AccessPolicy {
+    allowWriteModules: boolean;
+}
+export declare const READ_ONLY_POLICY: AccessPolicy;
+export declare function assertModuleAllowed(module: ToolModule, policy: AccessPolicy): void;
+//# sourceMappingURL=tool-module.d.ts.map

package/dist/mcp/tool-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-module.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB,EAAE,YAA0D,CAAC;AAE1F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAMlF"}

package/dist/mcp/tool-module.js

@@ -0,0 +1,7 @@
+export const READ_ONLY_POLICY = Object.freeze({ allowWriteModules: false });
+export function assertModuleAllowed(module, policy) {
+    if (module.access === "write" && !policy.allowWriteModules) {
+        throw new Error(`Refusing to register write-capable module "${module.id}" without an explicit write policy.`);
+    }
+}
+//# sourceMappingURL=tool-module.js.map

package/dist/mcp/tool-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-module.js","sourceRoot":"","sources":["../../src/mcp/tool-module.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,gBAAgB,GAAiB,MAAM,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;AAE1F,MAAM,UAAU,mBAAmB,CAAC,MAAkB,EAAE,MAAoB;IAC1E,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,8CAA8C,MAAM,CAAC,EAAE,qCAAqC,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type Fetch } from "./api/client.js";
+import type { UmamiCompassConfig } from "./config.js";
+import { type AccessPolicy, type ToolModule } from "./mcp/tool-module.js";
+export declare const BUILTIN_MODULES: readonly ToolModule[];
+export interface CreateServerOptions {
+    accessPolicy?: AccessPolicy;
+    config: UmamiCompassConfig;
+    fetch?: Fetch;
+    modules?: readonly ToolModule[];
+}
+export declare function createServer(options: CreateServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,iBAAiB,CAAC;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAStD,OAAO,EACL,KAAK,YAAY,EAGjB,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAG9B,eAAO,MAAM,eAAe,EAAE,SAAS,UAAU,EAShD,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CACjC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAyFpE"}