elasticsearch-mcp-vsee 0.5.12 → 0.5.13

package/build/tools/get-usage-leaderboard.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetUsageLeaderboardTool = void 0;
+const base_tool_js_1 = require("./base-tool.js");
+const zod_1 = require("zod");
+const field_constants_js_1 = require("../utils/field-constants.js");
+const query_helpers_js_1 = require("../utils/query-helpers.js");
+const GetUsageLeaderboardArgsSchema = zod_1.z.object({
+    entityType: zod_1.z.enum([
+        'account',
+        'group',
+        'provider_platform',
+        'patient_platform',
+        'provider_platform_version',
+        'patient_platform_version',
+    ]).describe('Type of entity to analyze'),
+    mode: zod_1.z.enum(['top_n', 'specific']).describe('Mode: "top_n" to find top entities by usage, "specific" to get usage for a specific entity'),
+    limit: zod_1.z.number().int().min(1).max(50).optional().default(10).describe('Max number of results (for top_n mode, default 10)'),
+    entityValue: zod_1.z.string().optional().describe('Specific entity name (required if mode is "specific")'),
+    startDate: zod_1.z.string().optional().describe('Start date (ISO or date math, default: now-30d)'),
+    endDate: zod_1.z.string().optional().describe('End date (ISO or date math, default: now)'),
+    subscription: zod_1.z.enum(['Enterprise', 'Premium', 'FVC', 'BVC', 'Plus']).optional().describe('Optional subscription filter'),
+    orderBy: zod_1.z.enum(['visit_count', 'unique_accounts', 'unique_groups', 'unique_providers', 'unique_patients']).default('visit_count').describe('Metric to order top N entities by (default: visit_count)'),
+}).refine(data => {
+    if (data.mode === 'specific' && !data.entityValue) {
+        return false;
+    }
+    return true;
+}, {
+    message: "entityValue is required when mode is 'specific'",
+    path: ['entityValue']
+});
+class GetUsageLeaderboardTool extends base_tool_js_1.BaseTool {
+    constructor(elasticsearch, logger) {
+        super(elasticsearch, logger, 'get-usage-leaderboard');
+    }
+    get schema() {
+        return GetUsageLeaderboardArgsSchema;
+    }
+    async run(args) {
+        const limit = args.limit || 10;
+        const orderBy = args.orderBy || 'visit_count';
+        const { startIso: startDateIso, endIso: endDateIso } = this.resolveTimeRange(args.startDate, args.endDate, 'now-30d', 'now');
+        this.logger.info('Executing usage leaderboard', {
+            entityType: args.entityType,
+            mode: args.mode,
+            limit,
+            orderBy,
+            entityValue: args.entityValue,
+        });
+        const client = this.elasticsearch.getClient();
+        const index = field_constants_js_1.FIELD_CONSTANTS.index;
+        const timeField = field_constants_js_1.FIELD_CONSTANTS.timeField;
+        // Determine field name based on entity type
+        let fieldName;
+        switch (args.entityType) {
+            case 'account':
+                fieldName = field_constants_js_1.FIELD_CONSTANTS.accountField;
+                break;
+            case 'group':
+                fieldName = field_constants_js_1.FIELD_CONSTANTS.groupField;
+                break;
+            case 'provider_platform':
+                fieldName = field_constants_js_1.FIELD_CONSTANTS.providerPlatformField;
+                break;
+            case 'patient_platform':
+                fieldName = field_constants_js_1.FIELD_CONSTANTS.patientPlatformField;
+                break;
+            case 'provider_platform_version':
+                fieldName = field_constants_js_1.FIELD_CONSTANTS.providerPlatformVersionField;
+                break;
+            case 'patient_platform_version':
+                fieldName = field_constants_js_1.FIELD_CONSTANTS.patientPlatformVersionField;
+                break;
+            default: throw new Error(`Unknown entity type: ${args.entityType}`);
+        }
+        // Build filters using shared helper
+        const filters = (0, query_helpers_js_1.buildCommonFilters)({
+            startDate: startDateIso,
+            endDate: endDateIso,
+            subscription: args.subscription,
+            excludeTestVisits: true
+        });
+        // Add tool-specific filters
+        filters.push({ exists: { field: fieldName } });
+        filters.push({ bool: { must_not: { term: { [fieldName]: '' } } } });
+        // If specific mode, add specific filter
+        if (args.mode === 'specific' && args.entityValue) {
+            filters.push({ term: { [fieldName]: args.entityValue } });
+        }
+        // Build Aggregations
+        const metricsAggs = {
+            total_visits: { value_count: { field: timeField } },
+            unique_accounts: { cardinality: { field: field_constants_js_1.FIELD_CONSTANTS.accountField } },
+            unique_groups: { cardinality: { field: field_constants_js_1.FIELD_CONSTANTS.groupField } },
+            unique_providers: { cardinality: { field: field_constants_js_1.FIELD_CONSTANTS.providerField } },
+            unique_patients: { cardinality: { field: field_constants_js_1.FIELD_CONSTANTS.patientField } },
+            avg_patient_rating: { avg: { field: field_constants_js_1.FIELD_CONSTANTS.patientRatingField } },
+            avg_provider_rating: { avg: { field: field_constants_js_1.FIELD_CONSTANTS.providerRatingField } },
+            avg_call_duration: { avg: { field: field_constants_js_1.FIELD_CONSTANTS.callDurationField } }
+        };
+        let order;
+        if (orderBy === 'visit_count') {
+            order = { _count: 'desc' };
+        }
+        else {
+            order = { [orderBy]: 'desc' };
+        }
+        let aggs;
+        if (args.mode === 'specific') {
+            aggs = {
+                by_entity: {
+                    terms: { field: fieldName, size: 1 },
+                    aggs: metricsAggs
+                }
+            };
+        }
+        else {
+            aggs = {
+                by_entity: {
+                    terms: {
+                        field: fieldName,
+                        size: limit,
+                        order: order
+                    },
+                    aggs: metricsAggs
+                }
+            };
+        }
+        const query = {
+            index,
+            size: 0,
+            body: {
+                query: { bool: { filter: filters } },
+                aggs
+            }
+        };
+        const response = await client.search(query);
+        const buckets = response.aggregations?.by_entity?.buckets || [];
+        const results = buckets.map((bucket) => ({
+            entity: bucket.key,
+            total_visits: bucket.doc_count,
+            unique_accounts: bucket.unique_accounts.value,
+            unique_groups: bucket.unique_groups.value,
+            unique_providers: bucket.unique_providers.value,
+            unique_patients: bucket.unique_patients.value,
+            avg_patient_rating: bucket.avg_patient_rating.value ? Math.round(bucket.avg_patient_rating.value * 100) / 100 : null,
+            avg_provider_rating: bucket.avg_provider_rating.value ? Math.round(bucket.avg_provider_rating.value * 100) / 100 : null,
+            avg_call_duration: bucket.avg_call_duration.value ? Math.round(bucket.avg_call_duration.value * 100) / 100 : null,
+        }));
+        return this.buildResponse(results, {
+            description: `${args.mode === 'top_n' ? `Top ${limit}` : 'Specific'} ${args.entityType} by ${orderBy} from ${startDateIso} to ${endDateIso}`,
+            arguments: args,
+            time: {
+                start: startDateIso,
+                end: endDateIso
+            },
+            visualization: {
+                type: 'table',
+                title: `${args.mode === 'top_n' ? `Top ${limit}` : 'Specific'} ${args.entityType} Usage`,
+                description: `${startDateIso.split('T')[0]} to ${endDateIso.split('T')[0]}`,
+                xAxisLabel: args.entityType,
+                yAxisLabel: orderBy
+            }
+        });
+    }
+}
+exports.GetUsageLeaderboardTool = GetUsageLeaderboardTool;
+//# sourceMappingURL=get-usage-leaderboard.js.map

package/build/tools/get-usage-leaderboard.js.map

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

package/build/tools/get-usage-profile.d.ts

@@ -0,0 +1,83 @@
+import { BaseTool } from './base-tool.js';
+import { z } from 'zod';
+import { StandardResponse } from './types.js';
+declare const GetUsageProfileArgsSchema: z.ZodObject<{
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    account: z.ZodOptional<z.ZodString>;
+    group: z.ZodOptional<z.ZodString>;
+    subscription: z.ZodOptional<z.ZodString>;
+    groupBy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "subscription", "account", "group"]>>>;
+}, "strict", z.ZodTypeAny, {
+    groupBy: "subscription" | "account" | "group" | "none";
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    subscription?: string | undefined;
+    account?: string | undefined;
+    group?: string | undefined;
+}, {
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    subscription?: string | undefined;
+    account?: string | undefined;
+    group?: string | undefined;
+    groupBy?: "subscription" | "account" | "group" | "none" | undefined;
+}>;
+export type GetUsageProfileArgs = z.infer<typeof GetUsageProfileArgsSchema>;
+export interface UsageProfileItem extends Record<string, any> {
+    total_visits: number;
+    unique_accounts: number;
+    unique_groups: number;
+    unique_providers: number;
+    unique_patients: number;
+    avg_call_duration_seconds: number | null;
+    total_call_duration_hours: number | null;
+    provider_rating_count: number;
+    avg_provider_rating: number | null;
+    patient_rating_count: number;
+    avg_patient_rating: number | null;
+    subscription_distribution: Array<{
+        subscription: string;
+        count: number;
+        percentage: number;
+    }>;
+    provider_platform_distribution: Array<{
+        platform: string;
+        count: number;
+        percentage: number;
+    }>;
+    patient_platform_distribution: Array<{
+        platform: string;
+        count: number;
+        percentage: number;
+    }>;
+}
+export type UsageProfileResult = StandardResponse<UsageProfileItem[]>;
+export declare class GetUsageProfileTool extends BaseTool<typeof GetUsageProfileArgsSchema, UsageProfileResult> {
+    constructor(elasticsearch: any, logger: any);
+    get schema(): z.ZodObject<{
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+        account: z.ZodOptional<z.ZodString>;
+        group: z.ZodOptional<z.ZodString>;
+        subscription: z.ZodOptional<z.ZodString>;
+        groupBy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "subscription", "account", "group"]>>>;
+    }, "strict", z.ZodTypeAny, {
+        groupBy: "subscription" | "account" | "group" | "none";
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        subscription?: string | undefined;
+        account?: string | undefined;
+        group?: string | undefined;
+    }, {
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        subscription?: string | undefined;
+        account?: string | undefined;
+        group?: string | undefined;
+        groupBy?: "subscription" | "account" | "group" | "none" | undefined;
+    }>;
+    protected run(args: GetUsageProfileArgs): Promise<UsageProfileResult>;
+}
+export {};
+//# sourceMappingURL=get-usage-profile.d.ts.map

package/build/tools/get-usage-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-usage-profile.d.ts","sourceRoot":"","sources":["../../src/tools/get-usage-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;EAOpB,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,yBAAyB,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,8BAA8B,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/F,6BAA6B,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/F;AAED,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,CAAC,CAAC;AAEtE,qBAAa,mBAAoB,SAAQ,QAAQ,CAAC,OAAO,yBAAyB,EAAE,kBAAkB,CAAC;gBACzF,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG;IAI3C,IAAI,MAAM;;;;;;;;;;;;;;;;;;;;;OAET;cAEe,GAAG,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAoO5E"}

package/build/tools/get-usage-profile.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetUsageProfileTool = void 0;
+const base_tool_js_1 = require("./base-tool.js");
+const zod_1 = require("zod");
+const field_constants_js_1 = require("../utils/field-constants.js");
+const query_helpers_js_1 = require("../utils/query-helpers.js");
+const aggregation_limits_js_1 = require("../utils/aggregation-limits.js");
+const GetUsageProfileArgsSchema = zod_1.z.object({
+    startDate: zod_1.z.string().optional().describe('Start date in ISO format (YYYY-MM-DD) or date math (e.g., "now-30d", "now-1y"). Defaults to "now-30d"'),
+    endDate: zod_1.z.string().optional().describe('End date in ISO format (YYYY-MM-DD) or date math (e.g., "now"). Defaults to "now"'),
+    account: zod_1.z.string().optional().describe('Optional account name to filter by'),
+    group: zod_1.z.string().optional().describe('Optional group name to filter by'),
+    subscription: zod_1.z.string().optional().describe('Optional subscription tier to filter by'),
+    groupBy: zod_1.z.enum(['none', 'subscription', 'account', 'group']).optional().default('none').describe('Optional grouping dimension (default: none). When set, returns separate summaries for each group value.'),
+}).strict();
+class GetUsageProfileTool extends base_tool_js_1.BaseTool {
+    constructor(elasticsearch, logger) {
+        super(elasticsearch, logger, 'get-usage-profile');
+    }
+    get schema() {
+        return GetUsageProfileArgsSchema;
+    }
+    async run(args) {
+        const groupBy = args.groupBy || 'none';
+        const { startIso: startDateIso, endIso: endDateIso } = this.resolveTimeRange(args.startDate, args.endDate, 'now-30d', 'now');
+        this.logger.info('Executing usage profile', {
+            startDate: startDateIso,
+            endDate: endDateIso,
+            account: args.account,
+            group: args.group,
+            subscription: args.subscription,
+            groupBy,
+        });
+        const client = this.elasticsearch.getClient();
+        const index = field_constants_js_1.FIELD_CONSTANTS.index;
+        const timeField = field_constants_js_1.FIELD_CONSTANTS.timeField;
+        const accountField = field_constants_js_1.FIELD_CONSTANTS.accountField;
+        const groupField = field_constants_js_1.FIELD_CONSTANTS.groupField;
+        const subscriptionField = field_constants_js_1.FIELD_CONSTANTS.subscriptionField;
+        const providerField = field_constants_js_1.FIELD_CONSTANTS.providerField;
+        const patientField = field_constants_js_1.FIELD_CONSTANTS.patientField;
+        const providerPlatformField = field_constants_js_1.FIELD_CONSTANTS.providerPlatformField;
+        const patientPlatformField = field_constants_js_1.FIELD_CONSTANTS.patientPlatformField;
+        const callDurationField = field_constants_js_1.FIELD_CONSTANTS.callDurationField;
+        const providerRatingField = field_constants_js_1.FIELD_CONSTANTS.providerRatingField;
+        const patientRatingField = field_constants_js_1.FIELD_CONSTANTS.patientRatingField;
+        const filters = (0, query_helpers_js_1.buildCommonFilters)({
+            startDate: startDateIso,
+            endDate: endDateIso,
+            account: args.account,
+            group: args.group,
+            subscription: args.subscription,
+            excludeTestVisits: true
+        });
+        // Extra filters
+        filters.push({
+            bool: {
+                should: [
+                    { exists: { field: callDurationField } },
+                    { term: { [field_constants_js_1.FIELD_CONSTANTS.meetingBasedField]: false } },
+                ],
+                minimum_should_match: 1,
+            },
+        });
+        const buildSummaryAggs = () => ({
+            total_visits: {
+                value_count: { field: timeField },
+            },
+            unique_accounts: {
+                cardinality: { field: accountField },
+            },
+            unique_groups: {
+                cardinality: { field: groupField },
+            },
+            unique_providers: {
+                cardinality: { field: providerField },
+            },
+            unique_patients: {
+                cardinality: { field: patientField },
+            },
+            avg_call_duration: {
+                avg: { field: callDurationField },
+            },
+            sum_call_duration: {
+                sum: { field: callDurationField },
+            },
+            provider_rating_count: {
+                value_count: { field: providerRatingField },
+            },
+            avg_provider_rating: {
+                avg: { field: providerRatingField },
+            },
+            patient_rating_count: {
+                value_count: { field: patientRatingField },
+            },
+            avg_patient_rating: {
+                avg: { field: patientRatingField },
+            },
+            subscription_distribution: {
+                terms: {
+                    field: subscriptionField,
+                    size: aggregation_limits_js_1.AGGREGATION_LIMITS.MEDIUM,
+                },
+            },
+            provider_platform_distribution: {
+                terms: {
+                    field: providerPlatformField,
+                    size: aggregation_limits_js_1.AGGREGATION_LIMITS.MEDIUM,
+                },
+            },
+            patient_platform_distribution: {
+                terms: {
+                    field: patientPlatformField,
+                    size: aggregation_limits_js_1.AGGREGATION_LIMITS.MEDIUM,
+                },
+            },
+        });
+        let aggs;
+        if (groupBy === 'none') {
+            aggs = buildSummaryAggs();
+        }
+        else {
+            let groupFieldName;
+            switch (groupBy) {
+                case 'subscription':
+                    groupFieldName = subscriptionField;
+                    break;
+                case 'account':
+                    groupFieldName = accountField;
+                    break;
+                case 'group':
+                    groupFieldName = groupField;
+                    break;
+                default:
+                    groupFieldName = subscriptionField;
+            }
+            aggs = {
+                by_group: {
+                    terms: {
+                        field: groupFieldName,
+                        size: aggregation_limits_js_1.AGGREGATION_LIMITS.MEDIUM, // Safeguard: cap at 50 to prevent data limits
+                    },
+                    aggs: buildSummaryAggs(),
+                },
+            };
+        }
+        const query = {
+            index,
+            size: 0,
+            body: {
+                query: {
+                    bool: {
+                        filter: filters,
+                    },
+                },
+                aggs,
+            },
+        };
+        this.logger.debug('Executing query', { query: JSON.stringify(query, null, 2) });
+        const response = await client.search(query);
+        const responseAggs = response.aggregations;
+        const processSummaryItem = (itemAggs) => {
+            const totalVisits = itemAggs?.total_visits?.value || 0;
+            const subscriptionBuckets = itemAggs?.subscription_distribution?.buckets || [];
+            const subscriptionDistribution = subscriptionBuckets.map((bucket) => ({
+                subscription: bucket.key,
+                count: bucket.doc_count || 0,
+                percentage: totalVisits > 0 ? Math.round((bucket.doc_count / totalVisits) * 100 * 100) / 100 : 0,
+            }));
+            const providerPlatformBuckets = itemAggs?.provider_platform_distribution?.buckets || [];
+            const providerPlatformDistribution = providerPlatformBuckets.map((bucket) => ({
+                platform: bucket.key,
+                count: bucket.doc_count || 0,
+                percentage: totalVisits > 0 ? Math.round((bucket.doc_count / totalVisits) * 100 * 100) / 100 : 0,
+            }));
+            const patientPlatformBuckets = itemAggs?.patient_platform_distribution?.buckets || [];
+            const patientPlatformDistribution = patientPlatformBuckets.map((bucket) => ({
+                platform: bucket.key,
+                count: bucket.doc_count || 0,
+                percentage: totalVisits > 0 ? Math.round((bucket.doc_count / totalVisits) * 100 * 100) / 100 : 0,
+            }));
+            const avgCallDuration = itemAggs?.avg_call_duration?.value || null;
+            const sumCallDuration = itemAggs?.sum_call_duration?.value || null;
+            const totalCallDurationHours = sumCallDuration ? Math.round((sumCallDuration / 3600) * 100) / 100 : null;
+            return {
+                total_visits: totalVisits,
+                unique_accounts: itemAggs?.unique_accounts?.value || 0,
+                unique_groups: itemAggs?.unique_groups?.value || 0,
+                unique_providers: itemAggs?.unique_providers?.value || 0,
+                unique_patients: itemAggs?.unique_patients?.value || 0,
+                avg_call_duration_seconds: avgCallDuration ? Math.round(avgCallDuration * 100) / 100 : null,
+                total_call_duration_hours: totalCallDurationHours,
+                provider_rating_count: itemAggs?.provider_rating_count?.value || 0,
+                avg_provider_rating: itemAggs?.avg_provider_rating?.value ? Math.round(itemAggs.avg_provider_rating.value * 100) / 100 : null,
+                patient_rating_count: itemAggs?.patient_rating_count?.value || 0,
+                avg_patient_rating: itemAggs?.avg_patient_rating?.value ? Math.round(itemAggs.avg_patient_rating.value * 100) / 100 : null,
+                subscription_distribution: subscriptionDistribution,
+                provider_platform_distribution: providerPlatformDistribution,
+                patient_platform_distribution: patientPlatformDistribution,
+            };
+        };
+        let summary;
+        if (groupBy === 'none') {
+            summary = [processSummaryItem(responseAggs)];
+        }
+        else {
+            const valueKey = `${groupBy}_value`;
+            const groupBuckets = responseAggs?.by_group?.buckets || [];
+            summary = groupBuckets.map((bucket) => ({
+                [valueKey]: bucket.key,
+                ...processSummaryItem(bucket),
+            }));
+        }
+        this.logger.info('Successfully retrieved usage summary', {
+            groupBy,
+            itemCount: summary.length,
+        });
+        return this.buildResponse(summary, {
+            description: `Usage profile from ${startDateIso} to ${endDateIso}${groupBy !== 'none' ? ` grouped by ${groupBy}` : ''}`,
+            arguments: args,
+            time: {
+                start: startDateIso,
+                end: endDateIso
+            },
+            visualization: {
+                type: 'table',
+                title: `Usage Profile${groupBy !== 'none' ? ` by ${groupBy}` : ''}`,
+                description: `${startDateIso.split('T')[0]} to ${endDateIso.split('T')[0]}`,
+            }
+        });
+    }
+}
+exports.GetUsageProfileTool = GetUsageProfileTool;
+//# sourceMappingURL=get-usage-profile.js.map

package/build/tools/get-usage-profile.js.map

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

package/build/tools/get-visit-trends.d.ts

@@ -1,14 +1,32 @@
-import { ElasticsearchManager } from '../elasticsearch/client.js';
-import { Logger } from '../logger.js';
-export interface GetVisitTrendsArgs {
-    interval: 'daily' | 'weekly' | 'monthly';
-    startDate?: string;
-    endDate?: string;
-    groupBy?: 'none' | 'subscription' | 'account' | 'group';
-    account?: string;
-    group?: string;
-    subscription?: 'Enterprise' | 'Premium' | 'FVC' | 'BVC' | 'Plus';
-}
+import { BaseTool } from './base-tool.js';
+import { z } from 'zod';
+import { StandardResponse } from './types.js';
+declare const GetVisitTrendsArgsSchema: z.ZodObject<{
+    interval: z.ZodDefault<z.ZodEnum<["daily", "weekly", "monthly"]>>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    groupBy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "subscription", "account", "group"]>>>;
+    account: z.ZodOptional<z.ZodString>;
+    group: z.ZodOptional<z.ZodString>;
+    subscription: z.ZodOptional<z.ZodEnum<["Enterprise", "Premium", "FVC", "BVC", "Plus"]>>;
+}, "strict", z.ZodTypeAny, {
+    groupBy: "subscription" | "account" | "group" | "none";
+    interval: "daily" | "weekly" | "monthly";
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    subscription?: "Enterprise" | "Premium" | "FVC" | "BVC" | "Plus" | undefined;
+    account?: string | undefined;
+    group?: string | undefined;
+}, {
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    subscription?: "Enterprise" | "Premium" | "FVC" | "BVC" | "Plus" | undefined;
+    account?: string | undefined;
+    group?: string | undefined;
+    groupBy?: "subscription" | "account" | "group" | "none" | undefined;
+    interval?: "daily" | "weekly" | "monthly" | undefined;
+}>;
+export type GetVisitTrendsArgs = z.infer<typeof GetVisitTrendsArgsSchema>;
 export interface TrendDataPoint {
     date: string;
     count: number;
@@ -19,19 +37,35 @@ export interface TrendDataPoint {
 export interface GroupedTrendData extends Record<string, any> {
     data_points: TrendDataPoint[];
 }
-export interface VisitTrendsResult {
-    interval: string;
-    period: string;
-    startDate: string;
-    endDate: string;
-    trends: TrendDataPoint[] | GroupedTrendData[];
-    total_visits: number;
-    average_per_period: number;
-}
-export declare class GetVisitTrendsTool {
-    private elasticsearch;
-    private logger;
-    constructor(elasticsearch: ElasticsearchManager, logger: Logger);
-    execute(args: unknown): Promise<VisitTrendsResult>;
+export type VisitTrendsResult = StandardResponse<TrendDataPoint[] | GroupedTrendData[]>;
+export declare class GetVisitTrendsTool extends BaseTool<typeof GetVisitTrendsArgsSchema, VisitTrendsResult> {
+    constructor(elasticsearch: any, logger: any);
+    get schema(): z.ZodObject<{
+        interval: z.ZodDefault<z.ZodEnum<["daily", "weekly", "monthly"]>>;
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+        groupBy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "subscription", "account", "group"]>>>;
+        account: z.ZodOptional<z.ZodString>;
+        group: z.ZodOptional<z.ZodString>;
+        subscription: z.ZodOptional<z.ZodEnum<["Enterprise", "Premium", "FVC", "BVC", "Plus"]>>;
+    }, "strict", z.ZodTypeAny, {
+        groupBy: "subscription" | "account" | "group" | "none";
+        interval: "daily" | "weekly" | "monthly";
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        subscription?: "Enterprise" | "Premium" | "FVC" | "BVC" | "Plus" | undefined;
+        account?: string | undefined;
+        group?: string | undefined;
+    }, {
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        subscription?: "Enterprise" | "Premium" | "FVC" | "BVC" | "Plus" | undefined;
+        account?: string | undefined;
+        group?: string | undefined;
+        groupBy?: "subscription" | "account" | "group" | "none" | undefined;
+        interval?: "daily" | "weekly" | "monthly" | undefined;
+    }>;
+    protected run(args: GetVisitTrendsArgs): Promise<VisitTrendsResult>;
 }
+export {};
 //# sourceMappingURL=get-visit-trends.d.ts.map

package/build/tools/get-visit-trends.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-visit-trends.d.ts","sourceRoot":"","sources":["../../src/tools/get-visit-trends.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAgBtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,OAAO,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CAClE;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC3D,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,MAAM,CAAS;gBAEX,aAAa,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM;IAKzD,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAkSzD"}
+{"version":3,"file":"get-visit-trends.d.ts","sourceRoot":"","sources":["../../src/tools/get-visit-trends.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;EAQnB,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC3D,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,cAAc,EAAE,GAAG,gBAAgB,EAAE,CAAC,CAAC;AAExF,qBAAa,kBAAmB,SAAQ,QAAQ,CAAC,OAAO,wBAAwB,EAAE,iBAAiB,CAAC;gBACtF,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG;IAI3C,IAAI,MAAM;;;;;;;;;;;;;;;;;;;;;;;;OAET;cAEe,GAAG,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAmN1E"}