elasticsearch-mcp-vsee-stage 0.5.13

package/build/errors/handlers.d.ts

@@ -0,0 +1,44 @@
+import { Logger } from '../logger.js';
+export declare class ElasticMCPError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly context: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, statusCode?: number, context?: Record<string, unknown>);
+}
+export declare class ValidationError extends ElasticMCPError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class ConnectionError extends ElasticMCPError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class AuthenticationError extends ElasticMCPError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class NotFoundError extends ElasticMCPError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class RateLimitError extends ElasticMCPError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export declare class ElasticsearchError extends ElasticMCPError {
+    constructor(message: string, originalError?: Error, context?: Record<string, unknown>);
+    static fromResponseError(error: any, toolName: string, args?: unknown): ElasticsearchError;
+}
+export interface ErrorResponse {
+    error: {
+        code: string;
+        message: string;
+        statusCode: number;
+        context: Record<string, unknown> | undefined;
+        timestamp: string;
+        requestId: string | undefined;
+    };
+}
+export declare class ErrorHandler {
+    private logger;
+    constructor(logger: Logger);
+    handleError(error: unknown, requestId?: string): ErrorResponse;
+    isRetryableError(error: unknown): boolean;
+    sanitizeError(error: ErrorResponse): ErrorResponse;
+}
+//# sourceMappingURL=handlers.d.ts.map

package/build/errors/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/errors/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAG3D,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY,EACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUpC;AAED,qBAAa,eAAgB,SAAQ,eAAe;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,eAAgB,SAAQ,eAAe;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,aAAc,SAAQ,eAAe;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,cAAe,SAAQ,eAAe;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWrF,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,kBAAkB;CAkF3F;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC7C,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;KAC/B,CAAC;CACH;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa;IA+D9D,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAwBzC,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa;CA2BnD"}

package/build/errors/handlers.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorHandler = exports.ElasticsearchError = exports.RateLimitError = exports.NotFoundError = exports.AuthenticationError = exports.ConnectionError = exports.ValidationError = exports.ElasticMCPError = void 0;
+class ElasticMCPError extends Error {
+    code;
+    statusCode;
+    context;
+    constructor(message, code, statusCode = 500, context) {
+        super(message);
+        this.name = 'ElasticMCPError';
+        this.code = code;
+        this.statusCode = statusCode;
+        this.context = context;
+        Error.captureStackTrace(this, ElasticMCPError);
+    }
+}
+exports.ElasticMCPError = ElasticMCPError;
+class ValidationError extends ElasticMCPError {
+    constructor(message, context) {
+        super(message, 'VALIDATION_ERROR', 400, context);
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+class ConnectionError extends ElasticMCPError {
+    constructor(message, context) {
+        super(message, 'CONNECTION_ERROR', 503, context);
+        this.name = 'ConnectionError';
+    }
+}
+exports.ConnectionError = ConnectionError;
+class AuthenticationError extends ElasticMCPError {
+    constructor(message, context) {
+        super(message, 'AUTHENTICATION_ERROR', 401, context);
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+class NotFoundError extends ElasticMCPError {
+    constructor(message, context) {
+        super(message, 'NOT_FOUND', 404, context);
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+class RateLimitError extends ElasticMCPError {
+    constructor(message, context) {
+        super(message, 'RATE_LIMIT_EXCEEDED', 429, context);
+        this.name = 'RateLimitError';
+    }
+}
+exports.RateLimitError = RateLimitError;
+class ElasticsearchError extends ElasticMCPError {
+    constructor(message, originalError, context) {
+        super(message, 'ELASTICSEARCH_ERROR', 500, {
+            ...context,
+            originalError: originalError ? {
+                name: originalError.name,
+                message: originalError.message,
+            } : undefined,
+        });
+        this.name = 'ElasticsearchError';
+    }
+    static fromResponseError(error, toolName, args) {
+        // Check for circuit breaking exception (data too large)
+        const errorBody = error.body || error.meta?.body || {};
+        const errorType = errorBody.error?.type || errorBody.type;
+        const errorReason = errorBody.error?.reason || errorBody.reason || error.message || '';
+        // Check for circuit breaking or data-related errors
+        if (errorType === 'circuit_breaking_exception' ||
+            errorReason.toLowerCase().includes('circuit_breaking_exception') ||
+            errorReason.toLowerCase().includes('data too large') ||
+            errorReason.toLowerCase().includes('would be') ||
+            errorReason.toLowerCase().includes('larger than the limit')) {
+            const rootCauses = errorBody.error?.root_cause || [];
+            const dataSizeInfo = rootCauses.find((cause) => cause.reason?.includes('would be') || cause.reason?.includes('larger than'));
+            let dataUsageMessage = 'Query exceeded Elasticsearch data usage limits. ';
+            if (dataSizeInfo?.reason) {
+                dataUsageMessage += dataSizeInfo.reason;
+            }
+            else if (errorReason) {
+                dataUsageMessage += errorReason;
+            }
+            else {
+                dataUsageMessage += 'The query requires too much memory to execute.';
+            }
+            dataUsageMessage += ' Try reducing the date range, adding filters (account/group/subscription), or using a smaller time interval.';
+            return new ElasticsearchError(dataUsageMessage, error, {
+                tool: toolName,
+                args,
+                errorType: 'DATA_USAGE_LIMIT_EXCEEDED',
+                elasticsearchError: {
+                    type: errorType,
+                    reason: errorReason,
+                    rootCauses: rootCauses.map((cause) => ({
+                        type: cause.type,
+                        reason: cause.reason,
+                    })),
+                },
+            });
+        }
+        // Check for other common Elasticsearch errors
+        if (errorType === 'query_shard_exception' || errorReason.toLowerCase().includes('query_shard_exception')) {
+            return new ElasticsearchError(`Elasticsearch query error: ${errorReason || 'Query execution failed'}. Try adjusting your query parameters.`, error, {
+                tool: toolName,
+                args,
+                errorType: 'QUERY_ERROR',
+                elasticsearchError: {
+                    type: errorType,
+                    reason: errorReason,
+                },
+            });
+        }
+        // Generic Elasticsearch error with more context
+        return new ElasticsearchError(`Elasticsearch error: ${errorReason || error.message || 'Unknown error occurred'}`, error, {
+            tool: toolName,
+            args,
+            errorType: errorType || 'UNKNOWN',
+            elasticsearchError: {
+                type: errorType,
+                reason: errorReason,
+            },
+        });
+    }
+}
+exports.ElasticsearchError = ElasticsearchError;
+class ErrorHandler {
+    logger;
+    constructor(logger) {
+        this.logger = logger.child({ component: 'error-handler' });
+    }
+    handleError(error, requestId) {
+        if (error instanceof ElasticMCPError) {
+            this.logger.warn('Handled error occurred', {
+                code: error.code,
+                message: error.message,
+                statusCode: error.statusCode,
+                context: error.context,
+                requestId,
+            });
+            return {
+                error: {
+                    code: error.code,
+                    message: error.message,
+                    statusCode: error.statusCode,
+                    context: error.context,
+                    timestamp: new Date().toISOString(),
+                    requestId,
+                },
+            };
+        }
+        if (error instanceof Error) {
+            this.logger.error('Unhandled error occurred', {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+                requestId,
+            }, error);
+            // Include the actual error message for debugging
+            return {
+                error: {
+                    code: 'INTERNAL_ERROR',
+                    message: error.message || 'An unexpected error occurred',
+                    statusCode: 500,
+                    context: {
+                        name: error.name,
+                        stack: error.stack,
+                    },
+                    timestamp: new Date().toISOString(),
+                    requestId,
+                },
+            };
+        }
+        this.logger.error('Unknown error occurred', {
+            error: String(error),
+            requestId,
+        });
+        return {
+            error: {
+                code: 'UNKNOWN_ERROR',
+                message: 'An unknown error occurred',
+                statusCode: 500,
+                context: undefined,
+                timestamp: new Date().toISOString(),
+                requestId,
+            },
+        };
+    }
+    isRetryableError(error) {
+        if (error instanceof ConnectionError) {
+            return true;
+        }
+        if (error instanceof ElasticsearchError) {
+            return true;
+        }
+        if (error instanceof Error) {
+            const message = error.message.toLowerCase();
+            return (message.includes('timeout') ||
+                message.includes('connection') ||
+                message.includes('network') ||
+                message.includes('503') ||
+                message.includes('502') ||
+                message.includes('504'));
+        }
+        return false;
+    }
+    sanitizeError(error) {
+        const sanitized = { ...error };
+        if (sanitized.error.context) {
+            const context = { ...sanitized.error.context };
+            const sensitiveKeys = [
+                'password',
+                'apiKey',
+                'token',
+                'secret',
+                'auth',
+                'authorization',
+                'credential',
+            ];
+            for (const key of Object.keys(context)) {
+                if (sensitiveKeys.some(sensitive => key.toLowerCase().includes(sensitive))) {
+                    context[key] = '***';
+                }
+            }
+            sanitized.error.context = context;
+        }
+        return sanitized;
+    }
+}
+exports.ErrorHandler = ErrorHandler;
+//# sourceMappingURL=handlers.js.map

package/build/errors/handlers.js.map

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

package/build/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Elastic MCP Server Entry Point
+ *
+ * This is the main entry point for the Elastic MCP server that provides
+ * standardized tools for interacting with Elasticsearch clusters.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/build/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Elastic MCP Server Entry Point
+ *
+ * This is the main entry point for the Elastic MCP server that provides
+ * standardized tools for interacting with Elasticsearch clusters.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_js_1 = __importDefault(require("./server.js"));
+async function main() {
+    try {
+        const server = new server_js_1.default();
+        await server.start();
+    }
+    catch (error) {
+        console.error('Failed to start Elastic MCP Server:', error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('Unhandled error in main:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;;GAKG;;;;;AAEH,4DAA2C;AAE3C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,mBAAgB,EAAE,CAAC;QACtC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/logger.d.ts

@@ -0,0 +1,31 @@
+export declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+export interface LogEntry {
+    timestamp: string;
+    level: string;
+    message: string;
+    context: Record<string, unknown> | undefined;
+    error: {
+        name: string;
+        message: string;
+        stack?: string;
+    } | undefined;
+}
+export declare class Logger {
+    private level;
+    private format;
+    constructor(level?: 'error' | 'warn' | 'info' | 'debug', format?: 'json' | 'text');
+    private shouldLog;
+    private formatMessage;
+    private log;
+    error(message: string, context?: Record<string, unknown>, error?: Error): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+    child(context: Record<string, unknown>): Logger;
+}
+//# sourceMappingURL=logger.d.ts.map

package/build/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,SAAS,CAAC;CACf;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,MAAM,CAAkB;gBAEpB,KAAK,GAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAgB,EAAE,MAAM,GAAE,MAAM,GAAG,MAAe;IAKjG,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,GAAG;IAuBX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAI9E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAehD"}

package/build/logger.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.LogLevel = void 0;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["ERROR"] = 0] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 1] = "WARN";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["DEBUG"] = 3] = "DEBUG";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+class Logger {
+    level;
+    format;
+    constructor(level = 'info', format = 'text') {
+        this.level = LogLevel[level.toUpperCase()];
+        this.format = format;
+    }
+    shouldLog(level) {
+        return level <= this.level;
+    }
+    formatMessage(entry) {
+        if (this.format === 'json') {
+            return JSON.stringify(entry);
+        }
+        const { timestamp, level, message, context, error } = entry;
+        let output = `[${timestamp}] ${level.toUpperCase()}: ${message}`;
+        if (context && Object.keys(context).length > 0) {
+            output += ` ${JSON.stringify(context)}`;
+        }
+        if (error) {
+            output += `\nError: ${error.name}: ${error.message}`;
+            if (error.stack) {
+                output += `\n${error.stack}`;
+            }
+        }
+        return output;
+    }
+    log(level, levelName, message, context, error) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: levelName,
+            message,
+            context,
+            error: error ? {
+                name: error.name,
+                message: error.message,
+                ...(error.stack && { stack: error.stack }),
+            } : undefined,
+        };
+        const output = this.formatMessage(entry);
+        // Write to stderr only (MCP uses stdout for protocol communication)
+        process.stderr.write(output + '\n');
+    }
+    error(message, context, error) {
+        this.log(LogLevel.ERROR, 'error', message, context, error);
+    }
+    warn(message, context) {
+        this.log(LogLevel.WARN, 'warn', message, context);
+    }
+    info(message, context) {
+        this.log(LogLevel.INFO, 'info', message, context);
+    }
+    debug(message, context) {
+        this.log(LogLevel.DEBUG, 'debug', message, context);
+    }
+    child(context) {
+        const childLogger = new Logger(Object.keys(LogLevel)[this.level], this.format);
+        const originalLog = childLogger.log.bind(childLogger);
+        const boundLog = (level, levelName, message, messageContext, error) => {
+            const mergedContext = { ...context, ...messageContext };
+            originalLog(level, levelName, message, mergedContext, error);
+        };
+        childLogger.log = boundLog;
+        return childLogger;
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/build/logger.js.map

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

package/build/server.d.ts

@@ -0,0 +1,23 @@
+export declare class ElasticMCPServer {
+    private server;
+    private config;
+    private logger;
+    private elasticsearch;
+    private errorHandler;
+    private isShuttingDown;
+    private getIndexFieldsTool;
+    private topChangeTool;
+    private periodSummaryTool;
+    private getPlatformBreakdownTool;
+    private getRatingDistributionTool;
+    private getVisitTrendsTool;
+    private getUsageProfileTool;
+    private findEntitiesByMetricTool;
+    private getUsageLeaderboardTool;
+    constructor();
+    private setupHandlers;
+    private setupGracefulShutdown;
+    start(): Promise<void>;
+}
+export default ElasticMCPServer;
+//# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAoBA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,wBAAwB,CAA2B;IAC3D,OAAO,CAAC,yBAAyB,CAA4B;IAC7D,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,wBAAwB,CAA2B;IAC3D,OAAO,CAAC,uBAAuB,CAA0B;;IAkCzD,OAAO,CAAC,aAAa;IA4drB,OAAO,CAAC,qBAAqB;IAoCvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB7B;AAED,eAAe,gBAAgB,CAAC"}