elasticsearch-mcp-vsee-stage 0.5.13

package/build/tools/get-platform-breakdown.js

@@ -0,0 +1,305 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetPlatformBreakdownTool = void 0;
+const zod_1 = require("zod");
+const handlers_js_1 = require("../errors/handlers.js");
+//import { capTimePeriod } from '../utils/date-math.js';
+const aggregation_limits_js_1 = require("../utils/aggregation-limits.js");
+const field_constants_js_1 = require("../utils/field-constants.js");
+const GetPlatformBreakdownArgsSchema = zod_1.z.object({
+    role: zod_1.z.enum(['provider', 'patient']).describe('Role: "provider" for provider platforms/versions, "patient" for patient platforms/versions'),
+    breakdownType: zod_1.z.enum(['platform', 'version']).describe('Breakdown type: "platform" for platform breakdown (Web/iOS/Android), "version" for platform version breakdown'),
+    topN: zod_1.z.number().int().min(1).max(100).optional().default(10).describe('Number of top items to return (default: 10, max: 100)'),
+    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 data to'),
+    group: zod_1.z.string().optional().describe('Optional group name to filter data to'),
+}).strict();
+class GetPlatformBreakdownTool {
+    elasticsearch;
+    logger;
+    constructor(elasticsearch, logger) {
+        this.elasticsearch = elasticsearch;
+        this.logger = logger.child({ tool: 'get-platform-breakdown' });
+    }
+    async execute(args) {
+        try {
+            const validatedArgs = GetPlatformBreakdownArgsSchema.parse(args);
+            const topN = Math.min(validatedArgs.topN || 10, 50);
+            let startDate = validatedArgs.startDate || 'now-14d';
+            let endDate = validatedArgs.endDate || 'now';
+            // Platform breakdowns use terms aggregation on high-cardinality fields (especially patient platforms).
+            // Cap time period to prevent data limit errors.
+            //const { startDate: adjustedStartDate, endDate: adjustedEndDate } = capTimePeriod(
+            //  startDate,
+            //  endDate,
+            //  30, // Max 30 days for platform breakdowns
+            //  this.logger
+            //);
+            //startDate = adjustedStartDate;
+            //endDate = adjustedEndDate;
+            this.logger.info('Getting platform breakdown', {
+                role: validatedArgs.role,
+                breakdownType: validatedArgs.breakdownType,
+                topN,
+                originalTopN: validatedArgs.topN,
+                startDate,
+                endDate,
+                account: validatedArgs.account,
+                group: validatedArgs.group,
+            });
+            const client = this.elasticsearch.getClient();
+            const index = field_constants_js_1.FIELD_CONSTANTS.index;
+            const timeField = field_constants_js_1.FIELD_CONSTANTS.timeField;
+            const testVisitField = field_constants_js_1.FIELD_CONSTANTS.testVisitField;
+            const subscriptionField = field_constants_js_1.FIELD_CONSTANTS.subscriptionField;
+            const accountField = field_constants_js_1.FIELD_CONSTANTS.accountField;
+            const groupField = field_constants_js_1.FIELD_CONSTANTS.groupField;
+            const providerField = field_constants_js_1.FIELD_CONSTANTS.providerField;
+            const patientField = field_constants_js_1.FIELD_CONSTANTS.patientField;
+            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 meetingBasedField = field_constants_js_1.FIELD_CONSTANTS.meetingBasedField;
+            let aggregationField;
+            if (validatedArgs.role === 'provider') {
+                aggregationField = validatedArgs.breakdownType === 'version'
+                    ? 'provider0_platform_version.keyword'
+                    : 'provider0_platform.keyword';
+            }
+            else {
+                aggregationField = validatedArgs.breakdownType === 'version'
+                    ? 'patient0_platform_version.keyword'
+                    : 'patient0_platform.keyword';
+            }
+            const filters = [
+                {
+                    range: {
+                        [timeField]: {
+                            gte: startDate,
+                            lt: endDate,
+                        },
+                    },
+                },
+                {
+                    term: {
+                        [testVisitField]: 'No',
+                    },
+                },
+                {
+                    bool: {
+                        should: [
+                            { exists: { field: callDurationField } },
+                            { term: { [meetingBasedField]: false } },
+                        ],
+                        minimum_should_match: 1,
+                    },
+                },
+            ];
+            if (validatedArgs.account) {
+                filters.push({
+                    term: {
+                        [accountField]: validatedArgs.account,
+                    },
+                });
+            }
+            if (validatedArgs.group) {
+                filters.push({
+                    term: {
+                        [groupField]: validatedArgs.group,
+                    },
+                });
+            }
+            const query = {
+                index,
+                size: 0,
+                body: {
+                    track_total_hits: false,
+                    query: {
+                        bool: {
+                            filter: filters,
+                        },
+                    },
+                    aggs: {
+                        by_item: {
+                            terms: {
+                                field: aggregationField,
+                                size: (0, aggregation_limits_js_1.calculateTermsSize)(topN || 10, 2, aggregation_limits_js_1.AGGREGATION_LIMITS.LARGE),
+                                order: { _count: 'desc' },
+                            },
+                            aggs: {
+                                count_records: {
+                                    value_count: { field: timeField },
+                                },
+                                unique_accounts: {
+                                    cardinality: { field: accountField },
+                                },
+                                unique_providers: {
+                                    cardinality: { field: providerField },
+                                },
+                                unique_patients: {
+                                    cardinality: { field: patientField },
+                                },
+                                avg_call_duration: {
+                                    avg: { 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.SMALL * 2, // 20 for subscription distribution
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            };
+            this.logger.debug('Executing query', { query: JSON.stringify(query, null, 2) });
+            const response = await client.search(query);
+            const aggs = response.aggregations;
+            const itemBuckets = aggs?.by_item?.buckets || [];
+            const topItems = [];
+            let otherRecords = 0;
+            let otherAccounts = 0;
+            let otherProviders = 0;
+            let otherPatients = 0;
+            let otherCallDurationSum = 0;
+            let otherCallDurationCount = 0;
+            let otherProviderRatingSum = 0;
+            let otherProviderRatingCount = 0;
+            let otherPatientRatingSum = 0;
+            let otherPatientRatingCount = 0;
+            const otherSubscriptionMap = new Map();
+            for (let i = 0; i < itemBuckets.length; i++) {
+                const bucket = itemBuckets[i];
+                const item = bucket.key;
+                const countRecords = bucket.count_records?.value || bucket.doc_count || 0;
+                const uniqueAccounts = bucket.unique_accounts?.value || 0;
+                const uniqueProviders = bucket.unique_providers?.value || 0;
+                const uniquePatients = bucket.unique_patients?.value || 0;
+                const avgCallDuration = bucket.avg_call_duration?.value || null;
+                const providerRatingCount = bucket.provider_rating_count?.value || 0;
+                const avgProviderRating = bucket.avg_provider_rating?.value || null;
+                const patientRatingCount = bucket.patient_rating_count?.value || 0;
+                const avgPatientRating = bucket.avg_patient_rating?.value || null;
+                const subscriptionDist = [];
+                const subscriptionBuckets = bucket.subscription_distribution?.buckets || [];
+                for (const subBucket of subscriptionBuckets) {
+                    subscriptionDist.push({
+                        subscription: subBucket.key,
+                        count: subBucket.doc_count || 0,
+                    });
+                }
+                const itemMetrics = {
+                    platform: item,
+                    count_records: countRecords,
+                    unique_accounts: uniqueAccounts,
+                    unique_providers: uniqueProviders,
+                    unique_patients: uniquePatients,
+                    avg_call_duration: avgCallDuration ? Math.round(avgCallDuration * 100) / 100 : null,
+                    provider_rating_count: providerRatingCount,
+                    avg_provider_rating: avgProviderRating ? Math.round(avgProviderRating * 100) / 100 : null,
+                    patient_rating_count: patientRatingCount,
+                    avg_patient_rating: avgPatientRating ? Math.round(avgPatientRating * 100) / 100 : null,
+                    subscription_distribution: subscriptionDist,
+                };
+                if (i < topN) {
+                    topItems.push(itemMetrics);
+                }
+                else {
+                    otherRecords += countRecords;
+                    otherAccounts += uniqueAccounts;
+                    otherProviders += uniqueProviders;
+                    otherPatients += uniquePatients;
+                    if (avgCallDuration !== null) {
+                        otherCallDurationSum += avgCallDuration * countRecords;
+                        otherCallDurationCount += countRecords;
+                    }
+                    if (avgProviderRating !== null) {
+                        otherProviderRatingSum += avgProviderRating * providerRatingCount;
+                        otherProviderRatingCount += providerRatingCount;
+                    }
+                    if (avgPatientRating !== null) {
+                        otherPatientRatingSum += avgPatientRating * patientRatingCount;
+                        otherPatientRatingCount += patientRatingCount;
+                    }
+                    for (const sub of subscriptionDist) {
+                        const current = otherSubscriptionMap.get(sub.subscription) || 0;
+                        otherSubscriptionMap.set(sub.subscription, current + sub.count);
+                    }
+                }
+            }
+            let otherItems = null;
+            if (itemBuckets.length > topN) {
+                const otherSubscriptionDist = [];
+                for (const [subscription, count] of otherSubscriptionMap.entries()) {
+                    otherSubscriptionDist.push({ subscription, count });
+                }
+                otherItems = {
+                    platform: `Other (${itemBuckets.length - topN} ${validatedArgs.breakdownType === 'version' ? 'versions' : 'platforms'})`,
+                    count_records: otherRecords,
+                    unique_accounts: otherAccounts,
+                    unique_providers: otherProviders,
+                    unique_patients: otherPatients,
+                    avg_call_duration: otherCallDurationCount > 0
+                        ? Math.round((otherCallDurationSum / otherCallDurationCount) * 100) / 100
+                        : null,
+                    provider_rating_count: otherProviderRatingCount,
+                    avg_provider_rating: otherProviderRatingCount > 0
+                        ? Math.round((otherProviderRatingSum / otherProviderRatingCount) * 100) / 100
+                        : null,
+                    patient_rating_count: otherPatientRatingCount,
+                    avg_patient_rating: otherPatientRatingCount > 0
+                        ? Math.round((otherPatientRatingSum / otherPatientRatingCount) * 100) / 100
+                        : null,
+                    subscription_distribution: otherSubscriptionDist,
+                };
+            }
+            this.logger.info('Successfully retrieved platform breakdown', {
+                role: validatedArgs.role,
+                breakdownType: validatedArgs.breakdownType,
+                topN,
+                topItemsCount: topItems.length,
+                hasOther: !!otherItems,
+            });
+            return {
+                startDate,
+                endDate,
+                role: validatedArgs.role,
+                breakdownType: validatedArgs.breakdownType,
+                top_items: topItems,
+                other_items: otherItems,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'ZodError') {
+                throw new handlers_js_1.ValidationError('Invalid arguments for get_platform_breakdown', {
+                    details: error.message,
+                });
+            }
+            if (error instanceof handlers_js_1.ValidationError) {
+                throw error;
+            }
+            this.logger.error('Failed to get platform breakdown', {}, error);
+            // Check if this is a ResponseError from Elasticsearch client
+            if (error && typeof error === 'object' && 'body' in error) {
+                throw handlers_js_1.ElasticsearchError.fromResponseError(error, 'get_platform_breakdown', args);
+            }
+            throw new handlers_js_1.ElasticsearchError('Failed to get platform breakdown from Elasticsearch', error, { args });
+        }
+    }
+}
+exports.GetPlatformBreakdownTool = GetPlatformBreakdownTool;
+//# sourceMappingURL=get-platform-breakdown.js.map

package/build/tools/get-platform-breakdown.js.map

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

package/build/tools/get-rating-distribution.d.ts

@@ -0,0 +1,48 @@
+import { ElasticsearchManager } from '../elasticsearch/client.js';
+import { Logger } from '../logger.js';
+export interface GetRatingDistributionArgs {
+    ratingType: 'provider' | 'patient' | 'both';
+    bucketSize?: number;
+    startDate?: string;
+    endDate?: string;
+    account?: string;
+    group?: string;
+    subscription?: 'Enterprise' | 'Premium' | 'FVC' | 'BVC' | 'Plus';
+    groupBy?: 'none' | 'subscription' | 'account' | 'group';
+}
+export interface RatingBucket {
+    range: string;
+    count: number;
+    percentage: number;
+}
+export interface RatingDistributionItem extends Record<string, any> {
+    provider_distribution?: RatingBucket[];
+    patient_distribution?: RatingBucket[];
+    provider_stats?: {
+        total_ratings: number;
+        average_rating: number;
+        min_rating: number;
+        max_rating: number;
+    };
+    patient_stats?: {
+        total_ratings: number;
+        average_rating: number;
+        min_rating: number;
+        max_rating: number;
+    };
+}
+export interface RatingDistributionResult {
+    startDate: string;
+    endDate: string;
+    ratingType: string;
+    period: string;
+    groupBy: string;
+    distribution: RatingDistributionItem | RatingDistributionItem[];
+}
+export declare class GetRatingDistributionTool {
+    private elasticsearch;
+    private logger;
+    constructor(elasticsearch: ElasticsearchManager, logger: Logger);
+    execute(args: unknown): Promise<RatingDistributionResult>;
+}
+//# sourceMappingURL=get-rating-distribution.d.ts.map

package/build/tools/get-rating-distribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-rating-distribution.d.ts","sourceRoot":"","sources":["../../src/tools/get-rating-distribution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAkBtC,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,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;IACjE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,OAAO,CAAC;CACzD;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAuB,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACjE,qBAAqB,CAAC,EAAE,YAAY,EAAE,CAAC;IACvC,oBAAoB,CAAC,EAAE,YAAY,EAAE,CAAC;IACtC,cAAc,CAAC,EAAE;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,aAAa,CAAC,EAAE;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;CACjE;AAED,qBAAa,yBAAyB;IACpC,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,wBAAwB,CAAC;CA2ShE"}

package/build/tools/get-rating-distribution.js

@@ -0,0 +1,283 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetRatingDistributionTool = void 0;
+const zod_1 = require("zod");
+const handlers_js_1 = require("../errors/handlers.js");
+const date_math_js_1 = require("../utils/date-math.js");
+const aggregation_limits_js_1 = require("../utils/aggregation-limits.js");
+const field_constants_js_1 = require("../utils/field-constants.js");
+const GetRatingDistributionArgsSchema = zod_1.z.object({
+    ratingType: zod_1.z.enum(['provider', 'patient', 'both']).describe('Type of rating to analyze: "provider", "patient", or "both"'),
+    bucketSize: zod_1.z.number().int().min(1).max(5).optional().default(1).describe('Rating bucket size (default: 1, e.g., 1 = 1-2, 2-3, 3-4, etc.)'),
+    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.enum(['Enterprise', 'Premium', 'FVC', 'BVC', 'Plus']).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 distributions for each group value.'),
+}).strict();
+class GetRatingDistributionTool {
+    elasticsearch;
+    logger;
+    constructor(elasticsearch, logger) {
+        this.elasticsearch = elasticsearch;
+        this.logger = logger.child({ tool: 'get-rating-distribution' });
+    }
+    async execute(args) {
+        try {
+            const validatedArgs = GetRatingDistributionArgsSchema.parse(args);
+            const bucketSize = validatedArgs.bucketSize || 1;
+            let startDate = validatedArgs.startDate || 'now-30d';
+            let endDate = validatedArgs.endDate || 'now';
+            const groupBy = validatedArgs.groupBy || 'none';
+            // Safeguard: cap time period to prevent data limit errors
+            // When grouping is enabled, this tool aggregates all entities which can be memory-intensive
+            const maxDays = groupBy !== 'none' ? 60 : 180; // Stricter limit when grouping
+            const { startDate: adjustedStartDate, endDate: adjustedEndDate } = (0, date_math_js_1.capTimePeriod)(startDate, endDate, maxDays, this.logger);
+            startDate = adjustedStartDate;
+            endDate = adjustedEndDate;
+            this.logger.info('Getting rating distribution', {
+                ratingType: validatedArgs.ratingType,
+                bucketSize,
+                startDate,
+                endDate,
+                account: validatedArgs.account,
+                group: validatedArgs.group,
+                subscription: validatedArgs.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 testVisitField = field_constants_js_1.FIELD_CONSTANTS.testVisitField;
+            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 providerRatingField = field_constants_js_1.FIELD_CONSTANTS.providerRatingField;
+            const patientRatingField = field_constants_js_1.FIELD_CONSTANTS.patientRatingField;
+            const callDurationField = field_constants_js_1.FIELD_CONSTANTS.callDurationField;
+            const meetingBasedField = field_constants_js_1.FIELD_CONSTANTS.meetingBasedField;
+            const filters = [
+                {
+                    range: {
+                        [timeField]: {
+                            gte: startDate,
+                            lt: endDate,
+                        },
+                    },
+                },
+                {
+                    term: {
+                        [testVisitField]: 'No',
+                    },
+                },
+                {
+                    bool: {
+                        should: [
+                            { exists: { field: callDurationField } },
+                            { term: { [meetingBasedField]: false } },
+                        ],
+                        minimum_should_match: 1,
+                    },
+                },
+            ];
+            if (validatedArgs.account) {
+                filters.push({
+                    term: {
+                        [accountField]: validatedArgs.account,
+                    },
+                });
+            }
+            if (validatedArgs.group) {
+                filters.push({
+                    term: {
+                        [groupField]: validatedArgs.group,
+                    },
+                });
+            }
+            if (validatedArgs.subscription) {
+                filters.push({
+                    term: {
+                        [subscriptionField]: validatedArgs.subscription,
+                    },
+                });
+            }
+            const buildRatingAggs = () => {
+                const ratingAggs = {};
+                if (validatedArgs.ratingType === 'provider' || validatedArgs.ratingType === 'both') {
+                    const ranges = [];
+                    for (let i = 1; i <= 5; i += bucketSize) {
+                        const to = Math.min(i + bucketSize - 0.1, 5);
+                        ranges.push({ from: i, to });
+                    }
+                    ranges.push({ from: 5, to: 5.1 });
+                    ratingAggs.provider_distribution = {
+                        range: {
+                            field: providerRatingField,
+                            ranges,
+                        },
+                    };
+                    ratingAggs.provider_stats = {
+                        stats: {
+                            field: providerRatingField,
+                        },
+                    };
+                }
+                if (validatedArgs.ratingType === 'patient' || validatedArgs.ratingType === 'both') {
+                    const ranges = [];
+                    for (let i = 1; i <= 5; i += bucketSize) {
+                        const to = Math.min(i + bucketSize - 0.1, 5);
+                        ranges.push({ from: i, to });
+                    }
+                    ranges.push({ from: 5, to: 5.1 });
+                    ratingAggs.patient_distribution = {
+                        range: {
+                            field: patientRatingField,
+                            ranges,
+                        },
+                    };
+                    ratingAggs.patient_stats = {
+                        stats: {
+                            field: patientRatingField,
+                        },
+                    };
+                }
+                return ratingAggs;
+            };
+            // Build aggregations based on grouping
+            let aggs;
+            if (groupBy === 'none') {
+                aggs = buildRatingAggs();
+            }
+            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: buildRatingAggs(),
+                    },
+                };
+            }
+            const query = {
+                index,
+                size: 0,
+                body: {
+                    track_total_hits: false,
+                    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 processDistributionItem = (itemAggs) => {
+                const item = {};
+                if (itemAggs?.provider_distribution) {
+                    const buckets = itemAggs.provider_distribution.buckets || [];
+                    const total = buckets.reduce((sum, b) => sum + (b.doc_count || 0), 0);
+                    const distribution = buckets.map((bucket) => {
+                        const count = bucket.doc_count || 0;
+                        return {
+                            range: `${bucket.from} - ${bucket.to}`,
+                            count,
+                            percentage: total > 0 ? Math.round((count / total) * 100 * 100) / 100 : 0,
+                        };
+                    });
+                    item.provider_distribution = distribution;
+                    if (itemAggs?.provider_stats) {
+                        const stats = itemAggs.provider_stats;
+                        item.provider_stats = {
+                            total_ratings: stats.count || 0,
+                            average_rating: stats.avg ? Math.round(stats.avg * 100) / 100 : 0,
+                            min_rating: stats.min || 0,
+                            max_rating: stats.max || 0,
+                        };
+                    }
+                }
+                // Process patient distribution
+                if (itemAggs?.patient_distribution) {
+                    const buckets = itemAggs.patient_distribution.buckets || [];
+                    const total = buckets.reduce((sum, b) => sum + (b.doc_count || 0), 0);
+                    const distribution = buckets.map((bucket) => {
+                        const count = bucket.doc_count || 0;
+                        return {
+                            range: `${bucket.from} - ${bucket.to}`,
+                            count,
+                            percentage: total > 0 ? Math.round((count / total) * 100 * 100) / 100 : 0,
+                        };
+                    });
+                    item.patient_distribution = distribution;
+                    if (itemAggs?.patient_stats) {
+                        const stats = itemAggs.patient_stats;
+                        item.patient_stats = {
+                            total_ratings: stats.count || 0,
+                            average_rating: stats.avg ? Math.round(stats.avg * 100) / 100 : 0,
+                            min_rating: stats.min || 0,
+                            max_rating: stats.max || 0,
+                        };
+                    }
+                }
+                return item;
+            };
+            let distribution;
+            if (groupBy === 'none') {
+                distribution = processDistributionItem(responseAggs);
+            }
+            else {
+                const valueKey = `${groupBy}_value`;
+                const groupBuckets = responseAggs?.by_group?.buckets || [];
+                distribution = groupBuckets.map((bucket) => ({
+                    [valueKey]: bucket.key,
+                    ...processDistributionItem(bucket),
+                }));
+            }
+            this.logger.info('Successfully retrieved rating distribution', {
+                ratingType: validatedArgs.ratingType,
+                groupBy,
+                itemCount: Array.isArray(distribution) ? distribution.length : 1,
+            });
+            return {
+                startDate,
+                endDate,
+                ratingType: validatedArgs.ratingType,
+                period: `${startDate} to ${endDate}`,
+                groupBy,
+                distribution,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'ZodError') {
+                throw new handlers_js_1.ValidationError('Invalid arguments for get_rating_distribution', {
+                    details: error.message,
+                });
+            }
+            if (error instanceof handlers_js_1.ValidationError) {
+                throw error;
+            }
+            this.logger.error('Failed to get rating distribution', {}, error);
+            throw new handlers_js_1.ElasticsearchError('Failed to get rating distribution from Elasticsearch', error, { args });
+        }
+    }
+}
+exports.GetRatingDistributionTool = GetRatingDistributionTool;
+//# sourceMappingURL=get-rating-distribution.js.map