driftdetect-mcp 0.4.0 → 0.4.3

package/dist/infrastructure/error-handler.js

@@ -0,0 +1,226 @@
+/**
+ * Enterprise Error Handler
+ *
+ * Provides structured error responses with:
+ * - Consistent error codes
+ * - Recovery suggestions for AI
+ * - Request tracking
+ */
+export var DriftErrorCode;
+(function (DriftErrorCode) {
+    // Client errors (4xx equivalent)
+    DriftErrorCode["INVALID_ARGUMENT"] = "INVALID_ARGUMENT";
+    DriftErrorCode["PATTERN_NOT_FOUND"] = "PATTERN_NOT_FOUND";
+    DriftErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    DriftErrorCode["INVALID_CURSOR"] = "INVALID_CURSOR";
+    DriftErrorCode["INVALID_CATEGORY"] = "INVALID_CATEGORY";
+    DriftErrorCode["MISSING_REQUIRED_PARAM"] = "MISSING_REQUIRED_PARAM";
+    // Server errors (5xx equivalent)
+    DriftErrorCode["SCAN_REQUIRED"] = "SCAN_REQUIRED";
+    DriftErrorCode["STORE_UNAVAILABLE"] = "STORE_UNAVAILABLE";
+    DriftErrorCode["ANALYSIS_FAILED"] = "ANALYSIS_FAILED";
+    DriftErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    // Rate limiting
+    DriftErrorCode["RATE_LIMITED"] = "RATE_LIMITED";
+    // Resource errors
+    DriftErrorCode["CALLGRAPH_NOT_BUILT"] = "CALLGRAPH_NOT_BUILT";
+    DriftErrorCode["DNA_NOT_ANALYZED"] = "DNA_NOT_ANALYZED";
+})(DriftErrorCode || (DriftErrorCode = {}));
+export class DriftError extends Error {
+    code;
+    details;
+    recovery;
+    constructor(errorDetails) {
+        super(errorDetails.message);
+        this.name = 'DriftError';
+        this.code = errorDetails.code;
+        this.details = errorDetails.details;
+        this.recovery = errorDetails.recovery;
+    }
+    /**
+     * Convert to MCP error response format
+     */
+    toMCPResponse(requestId) {
+        const errorResponse = {
+            error: {
+                code: this.code,
+                message: this.message,
+                details: this.details,
+                recovery: this.recovery,
+            },
+            meta: {
+                requestId: requestId || `err_${Date.now().toString(36)}`,
+                timestamp: new Date().toISOString(),
+            },
+        };
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(errorResponse, null, 2),
+                }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Error factory functions for common errors
+ */
+export const Errors = {
+    invalidArgument(param, reason, suggestion) {
+        return new DriftError({
+            code: DriftErrorCode.INVALID_ARGUMENT,
+            message: `Invalid argument '${param}': ${reason}`,
+            details: { param, reason },
+            recovery: suggestion ? { suggestion } : undefined,
+        });
+    },
+    missingRequired(param) {
+        return new DriftError({
+            code: DriftErrorCode.MISSING_REQUIRED_PARAM,
+            message: `Missing required parameter: ${param}`,
+            details: { param },
+            recovery: {
+                suggestion: `Provide the '${param}' parameter`,
+            },
+        });
+    },
+    missingParameter(param) {
+        return this.missingRequired(param);
+    },
+    notFound(type, id) {
+        if (type === 'pattern') {
+            return this.patternNotFound(id);
+        }
+        if (type === 'file') {
+            return this.fileNotFound(id);
+        }
+        return new DriftError({
+            code: DriftErrorCode.FILE_NOT_FOUND,
+            message: `${type} not found: ${id}`,
+            details: { type, id },
+            recovery: {
+                suggestion: `Check that the ${type} exists`,
+            },
+        });
+    },
+    invalidParameter(param, reason) {
+        return this.invalidArgument(param, reason);
+    },
+    patternNotFound(patternId) {
+        return new DriftError({
+            code: DriftErrorCode.PATTERN_NOT_FOUND,
+            message: `Pattern not found: ${patternId}`,
+            details: { patternId },
+            recovery: {
+                suggestion: 'Use drift_patterns_list to find valid pattern IDs',
+                alternativeTools: ['drift_patterns_list', 'drift_status'],
+            },
+        });
+    },
+    fileNotFound(path) {
+        return new DriftError({
+            code: DriftErrorCode.FILE_NOT_FOUND,
+            message: `File not found: ${path}`,
+            details: { path },
+            recovery: {
+                suggestion: 'Check the file path is relative to project root',
+                alternativeTools: ['drift_files_list'],
+            },
+        });
+    },
+    invalidCursor() {
+        return new DriftError({
+            code: DriftErrorCode.INVALID_CURSOR,
+            message: 'Invalid or expired pagination cursor',
+            recovery: {
+                suggestion: 'Start pagination from the beginning without a cursor',
+            },
+        });
+    },
+    invalidCategory(category, validCategories) {
+        return new DriftError({
+            code: DriftErrorCode.INVALID_CATEGORY,
+            message: `Invalid category: ${category}`,
+            details: {
+                provided: category,
+                valid: validCategories,
+            },
+            recovery: {
+                suggestion: `Use one of: ${validCategories.join(', ')}`,
+            },
+        });
+    },
+    scanRequired() {
+        return new DriftError({
+            code: DriftErrorCode.SCAN_REQUIRED,
+            message: 'No pattern data found. The codebase needs to be scanned first.',
+            recovery: {
+                suggestion: "Run 'drift scan' in the project root to analyze patterns",
+                command: 'drift scan',
+                alternativeTools: ['drift_status'],
+            },
+        });
+    },
+    callgraphNotBuilt() {
+        return new DriftError({
+            code: DriftErrorCode.CALLGRAPH_NOT_BUILT,
+            message: 'Call graph has not been built yet.',
+            recovery: {
+                suggestion: "Use drift_callgraph with action='build' first",
+                alternativeTools: ['drift_callgraph'],
+            },
+        });
+    },
+    dnaNotAnalyzed() {
+        return new DriftError({
+            code: DriftErrorCode.DNA_NOT_ANALYZED,
+            message: 'Styling DNA has not been analyzed yet.',
+            recovery: {
+                suggestion: "Run 'drift dna scan' to analyze styling patterns",
+                command: 'drift dna scan',
+            },
+        });
+    },
+    rateLimited(retryAfterMs) {
+        return new DriftError({
+            code: DriftErrorCode.RATE_LIMITED,
+            message: 'Rate limit exceeded. Please wait before making more requests.',
+            recovery: {
+                suggestion: 'Wait before retrying',
+                retryAfterMs,
+            },
+        });
+    },
+    internal(message, details) {
+        return new DriftError({
+            code: DriftErrorCode.INTERNAL_ERROR,
+            message: `Internal error: ${message}`,
+            details,
+            recovery: {
+                suggestion: 'This is an unexpected error. Please report it if it persists.',
+            },
+        });
+    },
+    custom(code, message, alternativeTools) {
+        return new DriftError({
+            code: code,
+            message,
+            recovery: alternativeTools ? {
+                suggestion: message,
+                alternativeTools,
+            } : undefined,
+        });
+    },
+};
+/**
+ * Error handler middleware
+ */
+export function handleError(error, requestId) {
+    if (error instanceof DriftError) {
+        return error.toMCPResponse(requestId);
+    }
+    // Convert unknown errors to DriftError
+    const message = error instanceof Error ? error.message : String(error);
+    return Errors.internal(message).toMCPResponse(requestId);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/infrastructure/error-handler.js.map

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

package/dist/infrastructure/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Enterprise MCP Infrastructure
+ *
+ * Core infrastructure components for building enterprise-grade MCP servers:
+ * - Response building with token budgets
+ * - Cursor-based pagination
+ * - Structured error handling
+ * - Caching with invalidation
+ * - Rate limiting
+ * - Metrics collection
+ */
+export { ResponseBuilder, createResponseBuilder, type MCPResponse, type MCPResponseMeta, type PaginationInfo, type ResponseHints, type ResponseBuilderConfig, } from './response-builder.js';
+export { TokenEstimator, tokenEstimator, type TokenEstimate, } from './token-estimator.js';
+export { CursorManager, cursorManager, createCursor, parseCursor, type CursorData, type CursorConfig, } from './cursor-manager.js';
+export { DriftError, DriftErrorCode, Errors, handleError, type DriftErrorDetails, type RecoveryHint, } from './error-handler.js';
+export { ResponseCache, createCache, type CachedResponse, type CacheConfig, } from './cache.js';
+export { RateLimiter, rateLimiter, type RateLimitConfig, } from './rate-limiter.js';
+export { MetricsCollector, metrics, type Metric, type MetricLabels, type HistogramBuckets, } from './metrics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,cAAc,EACd,cAAc,EACd,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACX,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,UAAU,EACV,cAAc,EACd,MAAM,EACN,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC"}

package/dist/infrastructure/index.js

@@ -0,0 +1,26 @@
+/**
+ * Enterprise MCP Infrastructure
+ *
+ * Core infrastructure components for building enterprise-grade MCP servers:
+ * - Response building with token budgets
+ * - Cursor-based pagination
+ * - Structured error handling
+ * - Caching with invalidation
+ * - Rate limiting
+ * - Metrics collection
+ */
+// Response Building
+export { ResponseBuilder, createResponseBuilder, } from './response-builder.js';
+// Token Estimation
+export { TokenEstimator, tokenEstimator, } from './token-estimator.js';
+// Cursor Pagination
+export { CursorManager, cursorManager, createCursor, parseCursor, } from './cursor-manager.js';
+// Error Handling
+export { DriftError, DriftErrorCode, Errors, handleError, } from './error-handler.js';
+// Caching
+export { ResponseCache, createCache, } from './cache.js';
+// Rate Limiting
+export { RateLimiter, rateLimiter, } from './rate-limiter.js';
+// Metrics
+export { MetricsCollector, metrics, } from './metrics.js';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,qBAAqB,GAMtB,MAAM,uBAAuB,CAAC;AAE/B,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,cAAc,GAEf,MAAM,sBAAsB,CAAC;AAE9B,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,GAGZ,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EACL,UAAU,EACV,cAAc,EACd,MAAM,EACN,WAAW,GAGZ,MAAM,oBAAoB,CAAC;AAE5B,UAAU;AACV,OAAO,EACL,aAAa,EACb,WAAW,GAGZ,MAAM,YAAY,CAAC;AAEpB,gBAAgB;AAChB,OAAO,EACL,WAAW,EACX,WAAW,GAEZ,MAAM,mBAAmB,CAAC;AAE3B,UAAU;AACV,OAAO,EACL,gBAAgB,EAChB,OAAO,GAIR,MAAM,cAAc,CAAC"}

package/dist/infrastructure/metrics.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Metrics Collector
+ *
+ * Collects operational metrics for observability:
+ * - Request counts and durations
+ * - Cache hit/miss rates
+ * - Token usage estimates
+ * - Error rates
+ */
+export interface MetricLabels {
+    tool?: string;
+    success?: string;
+    cached?: string;
+    errorCode?: string;
+}
+export interface Metric {
+    name: string;
+    type: 'counter' | 'gauge' | 'histogram';
+    value: number;
+    labels: MetricLabels;
+    timestamp: number;
+}
+export interface HistogramBuckets {
+    le_10: number;
+    le_50: number;
+    le_100: number;
+    le_250: number;
+    le_500: number;
+    le_1000: number;
+    le_2500: number;
+    le_5000: number;
+    le_inf: number;
+    sum: number;
+    count: number;
+}
+export declare class MetricsCollector {
+    private counters;
+    private gauges;
+    private histograms;
+    private metrics;
+    private maxMetrics;
+    /**
+     * Increment a counter
+     */
+    increment(name: string, labels?: MetricLabels, value?: number): void;
+    /**
+     * Set a gauge value
+     */
+    gauge(name: string, value: number, labels?: MetricLabels): void;
+    /**
+     * Record a histogram observation
+     */
+    observe(name: string, value: number, labels?: MetricLabels): void;
+    /**
+     * Record a request
+     */
+    recordRequest(tool: string, durationMs: number, success: boolean, cached?: boolean): void;
+    /**
+     * Record an error
+     */
+    recordError(tool: string, errorCode: string): void;
+    /**
+     * Record token estimate
+     */
+    recordTokens(tool: string, tokens: number): void;
+    /**
+     * Record patterns queried
+     */
+    recordPatternsQueried(count: number, tool: string): void;
+    /**
+     * Get all metrics
+     */
+    getMetrics(): Metric[];
+    /**
+     * Get summary statistics
+     */
+    getSummary(): {
+        totalRequests: number;
+        totalErrors: number;
+        cacheHitRate: number;
+        avgDurationMs: number;
+        avgTokens: number;
+        requestsByTool: Record<string, number>;
+    };
+    /**
+     * Export metrics in Prometheus format
+     */
+    toPrometheus(): string;
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+    private makeKey;
+    private parseKey;
+    private formatLabels;
+    private addLabel;
+    private createEmptyBuckets;
+    private recordMetric;
+}
+/**
+ * Singleton instance for convenience
+ */
+export declare const metrics: MetricsCollector;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/infrastructure/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/infrastructure/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAiB;IAEnC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,YAAiB,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAc3E;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,YAAiB,GAAG,IAAI;IAanE;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,YAAiB,GAAG,IAAI;IAiCrE;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,OAAe,GAAG,IAAI;IAgBhG;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAIlD;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhD;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxD;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;OAEG;IACH,UAAU,IAAI;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC;IA2DD;;OAEG;IACH,YAAY,IAAI,MAAM;IAsCtB;;OAEG;IACH,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,YAAY;CAQrB;AAED;;GAEG;AACH,eAAO,MAAM,OAAO,kBAAyB,CAAC"}

package/dist/infrastructure/metrics.js

@@ -0,0 +1,291 @@
+/**
+ * Metrics Collector
+ *
+ * Collects operational metrics for observability:
+ * - Request counts and durations
+ * - Cache hit/miss rates
+ * - Token usage estimates
+ * - Error rates
+ */
+export class MetricsCollector {
+    counters = new Map();
+    gauges = new Map();
+    histograms = new Map();
+    metrics = [];
+    maxMetrics = 10000;
+    /**
+     * Increment a counter
+     */
+    increment(name, labels = {}, value = 1) {
+        const key = this.makeKey(name, labels);
+        const current = this.counters.get(key) ?? 0;
+        this.counters.set(key, current + value);
+        this.recordMetric({
+            name,
+            type: 'counter',
+            value: current + value,
+            labels,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Set a gauge value
+     */
+    gauge(name, value, labels = {}) {
+        const key = this.makeKey(name, labels);
+        this.gauges.set(key, value);
+        this.recordMetric({
+            name,
+            type: 'gauge',
+            value,
+            labels,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Record a histogram observation
+     */
+    observe(name, value, labels = {}) {
+        const key = this.makeKey(name, labels);
+        let buckets = this.histograms.get(key);
+        if (!buckets) {
+            buckets = this.createEmptyBuckets();
+            this.histograms.set(key, buckets);
+        }
+        // Update buckets
+        if (value <= 10)
+            buckets.le_10++;
+        if (value <= 50)
+            buckets.le_50++;
+        if (value <= 100)
+            buckets.le_100++;
+        if (value <= 250)
+            buckets.le_250++;
+        if (value <= 500)
+            buckets.le_500++;
+        if (value <= 1000)
+            buckets.le_1000++;
+        if (value <= 2500)
+            buckets.le_2500++;
+        if (value <= 5000)
+            buckets.le_5000++;
+        buckets.le_inf++;
+        buckets.sum += value;
+        buckets.count++;
+        this.recordMetric({
+            name,
+            type: 'histogram',
+            value,
+            labels,
+            timestamp: Date.now(),
+        });
+    }
+    // Convenience methods for common metrics
+    /**
+     * Record a request
+     */
+    recordRequest(tool, durationMs, success, cached = false) {
+        this.increment('drift_mcp_requests_total', {
+            tool,
+            success: String(success),
+            cached: String(cached),
+        });
+        this.observe('drift_mcp_request_duration_ms', durationMs, { tool });
+        if (cached) {
+            this.increment('drift_mcp_cache_hits_total', { tool });
+        }
+        else {
+            this.increment('drift_mcp_cache_misses_total', { tool });
+        }
+    }
+    /**
+     * Record an error
+     */
+    recordError(tool, errorCode) {
+        this.increment('drift_mcp_errors_total', { tool, errorCode });
+    }
+    /**
+     * Record token estimate
+     */
+    recordTokens(tool, tokens) {
+        this.observe('drift_mcp_response_tokens', tokens, { tool });
+    }
+    /**
+     * Record patterns queried
+     */
+    recordPatternsQueried(count, tool) {
+        this.increment('drift_mcp_patterns_queried_total', { tool }, count);
+    }
+    /**
+     * Get all metrics
+     */
+    getMetrics() {
+        return [...this.metrics];
+    }
+    /**
+     * Get summary statistics
+     */
+    getSummary() {
+        let totalRequests = 0;
+        let totalErrors = 0;
+        let cacheHits = 0;
+        let cacheMisses = 0;
+        const requestsByTool = {};
+        // Count requests
+        for (const [key, value] of this.counters) {
+            if (key.startsWith('drift_mcp_requests_total')) {
+                totalRequests += value;
+                // Extract tool from key
+                const toolMatch = key.match(/tool:(\w+)/);
+                if (toolMatch) {
+                    const tool = toolMatch[1];
+                    requestsByTool[tool] = (requestsByTool[tool] ?? 0) + value;
+                }
+            }
+            if (key.startsWith('drift_mcp_errors_total')) {
+                totalErrors += value;
+            }
+            if (key.startsWith('drift_mcp_cache_hits_total')) {
+                cacheHits += value;
+            }
+            if (key.startsWith('drift_mcp_cache_misses_total')) {
+                cacheMisses += value;
+            }
+        }
+        // Calculate averages from histograms
+        let totalDuration = 0;
+        let durationCount = 0;
+        let totalTokens = 0;
+        let tokenCount = 0;
+        for (const [key, buckets] of this.histograms) {
+            if (key.startsWith('drift_mcp_request_duration_ms')) {
+                totalDuration += buckets.sum;
+                durationCount += buckets.count;
+            }
+            if (key.startsWith('drift_mcp_response_tokens')) {
+                totalTokens += buckets.sum;
+                tokenCount += buckets.count;
+            }
+        }
+        return {
+            totalRequests,
+            totalErrors,
+            cacheHitRate: cacheHits + cacheMisses > 0
+                ? cacheHits / (cacheHits + cacheMisses)
+                : 0,
+            avgDurationMs: durationCount > 0 ? totalDuration / durationCount : 0,
+            avgTokens: tokenCount > 0 ? totalTokens / tokenCount : 0,
+            requestsByTool,
+        };
+    }
+    /**
+     * Export metrics in Prometheus format
+     */
+    toPrometheus() {
+        const lines = [];
+        // Counters
+        for (const [key, value] of this.counters) {
+            const { name, labels } = this.parseKey(key);
+            const labelStr = this.formatLabels(labels);
+            lines.push(`${name}${labelStr} ${value}`);
+        }
+        // Gauges
+        for (const [key, value] of this.gauges) {
+            const { name, labels } = this.parseKey(key);
+            const labelStr = this.formatLabels(labels);
+            lines.push(`${name}${labelStr} ${value}`);
+        }
+        // Histograms
+        for (const [key, buckets] of this.histograms) {
+            const { name, labels } = this.parseKey(key);
+            const labelStr = this.formatLabels(labels);
+            lines.push(`${name}_bucket${this.addLabel(labelStr, 'le', '10')} ${buckets.le_10}`);
+            lines.push(`${name}_bucket${this.addLabel(labelStr, 'le', '50')} ${buckets.le_50}`);
+            lines.push(`${name}_bucket${this.addLabel(labelStr, 'le', '100')} ${buckets.le_100}`);
+            lines.push(`${name}_bucket${this.addLabel(labelStr, 'le', '250')} ${buckets.le_250}`);
+            lines.push(`${name}_bucket${this.addLabel(labelStr, 'le', '500')} ${buckets.le_500}`);
+            lines.push(`${name}_bucket${this.addLabel(labelStr, 'le', '1000')} ${buckets.le_1000}`);
+            lines.push(`${name}_bucket${this.addLabel(labelStr, 'le', '2500')} ${buckets.le_2500}`);
+            lines.push(`${name}_bucket${this.addLabel(labelStr, 'le', '5000')} ${buckets.le_5000}`);
+            lines.push(`${name}_bucket${this.addLabel(labelStr, 'le', '+Inf')} ${buckets.le_inf}`);
+            lines.push(`${name}_sum${labelStr} ${buckets.sum}`);
+            lines.push(`${name}_count${labelStr} ${buckets.count}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Clear all metrics
+     */
+    clear() {
+        this.counters.clear();
+        this.gauges.clear();
+        this.histograms.clear();
+        this.metrics = [];
+    }
+    // Private methods
+    makeKey(name, labels) {
+        const labelParts = Object.entries(labels)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => `${k}:${v}`);
+        return labelParts.length > 0
+            ? `${name}{${labelParts.join(',')}}`
+            : name;
+    }
+    parseKey(key) {
+        const match = key.match(/^([^{]+)(?:\{(.+)\})?$/);
+        if (!match) {
+            return { name: key, labels: {} };
+        }
+        const name = match[1];
+        const labels = {};
+        if (match[2]) {
+            for (const part of match[2].split(',')) {
+                const [k, v] = part.split(':');
+                if (k && v) {
+                    labels[k] = v;
+                }
+            }
+        }
+        return { name, labels };
+    }
+    formatLabels(labels) {
+        const parts = Object.entries(labels)
+            .filter(([, v]) => v !== undefined)
+            .map(([k, v]) => `${k}="${v}"`);
+        return parts.length > 0 ? `{${parts.join(',')}}` : '';
+    }
+    addLabel(labelStr, key, value) {
+        if (labelStr === '') {
+            return `{${key}="${value}"}`;
+        }
+        return labelStr.replace('}', `,${key}="${value}"}`);
+    }
+    createEmptyBuckets() {
+        return {
+            le_10: 0,
+            le_50: 0,
+            le_100: 0,
+            le_250: 0,
+            le_500: 0,
+            le_1000: 0,
+            le_2500: 0,
+            le_5000: 0,
+            le_inf: 0,
+            sum: 0,
+            count: 0,
+        };
+    }
+    recordMetric(metric) {
+        this.metrics.push(metric);
+        // Trim old metrics if over limit
+        if (this.metrics.length > this.maxMetrics) {
+            this.metrics = this.metrics.slice(-this.maxMetrics / 2);
+        }
+    }
+}
+/**
+ * Singleton instance for convenience
+ */
+export const metrics = new MetricsCollector();
+//# sourceMappingURL=metrics.js.map