attio-mcp 0.1.1 → 1.0.0

package/dist/middleware/performance-enhanced.js

@@ -0,0 +1,449 @@
+/**
+ * Enhanced Performance Tracking Middleware for Phase 2
+ *
+ * Provides advanced performance monitoring, timing splits, and automated alerts
+ * for the Attio MCP Server. Tracks API vs MCP overhead, performance budgets,
+ * and regression detection.
+ */
+import { performance } from 'perf_hooks';
+import { EventEmitter } from 'events';
+/**
+ * Performance alert levels
+ */
+export var AlertLevel;
+(function (AlertLevel) {
+    AlertLevel["INFO"] = "info";
+    AlertLevel["WARNING"] = "warning";
+    AlertLevel["CRITICAL"] = "critical";
+})(AlertLevel || (AlertLevel = {}));
+/**
+ * Enhanced Performance Tracking Service
+ */
+export class EnhancedPerformanceTracker extends EventEmitter {
+    static instance;
+    metrics = [];
+    cache404 = new Map();
+    budgets;
+    alerts = [];
+    maxMetrics;
+    metricsIndex = 0;
+    isBufferFull = false;
+    enabled = true;
+    degradationThreshold = 0.2; // 20% degradation threshold
+    // Timing context for current operation
+    timingContext = new Map();
+    constructor() {
+        super();
+        this.maxMetrics = parseInt(process.env.PERF_MAX_METRICS || '5000', 10);
+        // Initialize performance budgets
+        this.budgets = {
+            notFound: parseInt(process.env.PERF_BUDGET_NOT_FOUND || '2000', 10),
+            search: parseInt(process.env.PERF_BUDGET_SEARCH || '3000', 10),
+            create: parseInt(process.env.PERF_BUDGET_CREATE || '3000', 10),
+            update: parseInt(process.env.PERF_BUDGET_UPDATE || '3000', 10),
+            delete: parseInt(process.env.PERF_BUDGET_DELETE || '2000', 10),
+            batchSmall: parseInt(process.env.PERF_BUDGET_BATCH_SMALL || '5000', 10),
+            batchLarge: parseInt(process.env.PERF_BUDGET_BATCH_LARGE || '10000', 10),
+            default: parseInt(process.env.PERF_BUDGET_DEFAULT || '3000', 10),
+        };
+        // Set up cache cleanup interval (every 5 minutes)
+        setInterval(() => this.cleanupCache(), 5 * 60 * 1000);
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new EnhancedPerformanceTracker();
+        }
+        return this.instance;
+    }
+    /**
+     * Start tracking an operation with context
+     */
+    startOperation(toolName, operationType, metadata) {
+        if (!this.enabled)
+            return '';
+        const operationId = `${toolName}-${Date.now()}-${Math.random()}`;
+        const startTime = performance.now();
+        this.timingContext.set(operationId, {
+            toolName,
+            operationType,
+            startTime,
+            metadata,
+            timings: {
+                total: 0,
+                attioApi: 0,
+                mcpOverhead: 0,
+                validation: 0,
+                serialization: 0,
+                other: 0,
+            },
+        });
+        return operationId;
+    }
+    /**
+     * Mark a timing checkpoint
+     */
+    markTiming(operationId, phase, duration) {
+        const context = this.timingContext.get(operationId);
+        if (context && context.timings[phase] !== undefined) {
+            context.timings[phase] += duration;
+        }
+    }
+    /**
+     * Mark API call start
+     */
+    markApiStart(operationId) {
+        if (this.enabled && operationId) {
+            const context = this.timingContext.get(operationId);
+            if (context) {
+                // Touch the context to keep TypeScript happy without altering behaviour
+                context.timings.attioApi += 0;
+            }
+        }
+        return performance.now();
+    }
+    /**
+     * Mark API call end
+     */
+    markApiEnd(operationId, apiStartTime) {
+        const duration = performance.now() - apiStartTime;
+        this.markTiming(operationId, 'attioApi', duration);
+    }
+    /**
+     * End tracking an operation
+     */
+    endOperation(operationId, success = true, error, statusCode, additionalMetadata) {
+        if (!this.enabled || !operationId)
+            return null;
+        const context = this.timingContext.get(operationId);
+        if (!context)
+            return null;
+        const endTime = performance.now();
+        const duration = endTime - context.startTime;
+        // Calculate MCP overhead
+        const mcpOverhead = duration -
+            (context.timings.validation +
+                context.timings.attioApi +
+                context.timings.serialization +
+                context.timings.other);
+        const metrics = {
+            toolName: context.toolName,
+            operationType: context.operationType,
+            resourceType: context.metadata?.resourceType,
+            startTime: context.startTime,
+            endTime,
+            duration,
+            timingSplit: {
+                total: duration,
+                attioApi: context.timings.attioApi,
+                mcpOverhead: Math.max(0, mcpOverhead),
+                validation: context.timings.validation,
+                serialization: context.timings.serialization,
+                other: context.timings.other,
+            },
+            success,
+            cached: false,
+            error,
+            statusCode,
+            recordCount: additionalMetadata?.recordCount,
+            metadata: { ...context.metadata, ...additionalMetadata },
+        };
+        // Store metrics
+        this.storeMetrics(metrics);
+        // Check performance budget
+        this.checkBudget(metrics);
+        // Clean up context
+        this.timingContext.delete(operationId);
+        // Log in development
+        if (process.env.NODE_ENV === 'development') {
+            this.logMetrics(metrics);
+        }
+        return metrics;
+    }
+    /**
+     * Store metrics in circular buffer
+     */
+    storeMetrics(metrics) {
+        if (this.isBufferFull) {
+            this.metrics[this.metricsIndex] = metrics;
+        }
+        else {
+            this.metrics.push(metrics);
+            if (this.metrics.length >= this.maxMetrics) {
+                this.isBufferFull = true;
+            }
+        }
+        this.metricsIndex = (this.metricsIndex + 1) % this.maxMetrics;
+    }
+    /**
+     * Check if operation exceeds budget
+     */
+    checkBudget(metrics) {
+        const budget = this.getBudgetForOperation(metrics.operationType, metrics.statusCode, metrics.recordCount);
+        if (metrics.duration > budget) {
+            const percentOver = ((metrics.duration - budget) / budget) * 100;
+            let level;
+            if (percentOver > 100) {
+                level = AlertLevel.CRITICAL;
+            }
+            else if (percentOver > this.degradationThreshold * 100) {
+                level = AlertLevel.WARNING;
+            }
+            else {
+                level = AlertLevel.INFO;
+            }
+            const alert = {
+                level,
+                toolName: metrics.toolName,
+                operationType: metrics.operationType,
+                duration: metrics.duration,
+                budget,
+                percentOver,
+                timestamp: new Date(),
+                message: `${metrics.toolName} (${metrics.operationType}) exceeded budget by ${percentOver.toFixed(1)}% (${metrics.duration.toFixed(0)}ms vs ${budget}ms budget)`,
+            };
+            this.alerts.push(alert);
+            this.emit('performanceAlert', alert);
+            // Log critical alerts immediately using structured logging
+            if (level === AlertLevel.CRITICAL) {
+                process.stderr.write(JSON.stringify({
+                    level: 'error',
+                    message: `PERFORMANCE CRITICAL: ${alert.message}`,
+                    type: 'performance_alert',
+                    data: alert,
+                }) + '\n');
+            }
+            else if (level === AlertLevel.WARNING) {
+                process.stderr.write(JSON.stringify({
+                    level: 'warn',
+                    message: `PERFORMANCE WARNING: ${alert.message}`,
+                    type: 'performance_alert',
+                    data: alert,
+                }) + '\n');
+            }
+        }
+    }
+    /**
+     * Get budget for specific operation
+     */
+    getBudgetForOperation(operationType, statusCode, recordCount) {
+        // 404 responses have their own budget
+        if (statusCode === 404) {
+            return this.budgets.notFound;
+        }
+        // Map operation types to budgets
+        switch (operationType.toLowerCase()) {
+            case 'search':
+            case 'list':
+            case 'query':
+                return this.budgets.search;
+            case 'create':
+                return this.budgets.create;
+            case 'update':
+                return this.budgets.update;
+            case 'delete':
+                return this.budgets.delete;
+            case 'batch':
+                return recordCount && recordCount >= 10
+                    ? this.budgets.batchLarge
+                    : this.budgets.batchSmall;
+            default:
+                return this.budgets.default;
+        }
+    }
+    /**
+     * Cache a 404 response
+     */
+    cache404Response(key, result, ttl = 60000) {
+        this.cache404.set(key, {
+            timestamp: Date.now(),
+            result,
+            ttl,
+        });
+    }
+    /**
+     * Get cached 404 response
+     */
+    getCached404(key) {
+        const entry = this.cache404.get(key);
+        if (!entry)
+            return null;
+        const age = Date.now() - entry.timestamp;
+        if (age > entry.ttl) {
+            this.cache404.delete(key);
+            return null;
+        }
+        return entry.result;
+    }
+    /**
+     * Clean up expired cache entries
+     */
+    cleanupCache() {
+        const now = Date.now();
+        for (const [key, entry] of Array.from(this.cache404.entries())) {
+            if (now - entry.timestamp > entry.ttl) {
+                this.cache404.delete(key);
+            }
+        }
+    }
+    /**
+     * Get performance statistics
+     */
+    getStatistics(toolName, timeWindow) {
+        const now = Date.now();
+        const windowStart = timeWindow ? now - timeWindow : 0;
+        let relevantMetrics = this.metrics;
+        if (toolName) {
+            relevantMetrics = relevantMetrics.filter((m) => m.toolName === toolName);
+        }
+        if (timeWindow) {
+            relevantMetrics = relevantMetrics.filter((m) => m.startTime >= windowStart);
+        }
+        if (relevantMetrics.length === 0) {
+            return {};
+        }
+        const durations = relevantMetrics
+            .map((m) => m.duration)
+            .sort((a, b) => a - b);
+        const apiTimes = relevantMetrics
+            .map((m) => m.timingSplit.attioApi)
+            .sort((a, b) => a - b);
+        const overheads = relevantMetrics
+            .map((m) => m.timingSplit.mcpOverhead)
+            .sort((a, b) => a - b);
+        return {
+            count: relevantMetrics.length,
+            successRate: (relevantMetrics.filter((m) => m.success).length /
+                relevantMetrics.length) *
+                100,
+            cacheHitRate: (relevantMetrics.filter((m) => m.cached).length /
+                relevantMetrics.length) *
+                100,
+            timing: {
+                average: this.average(durations),
+                min: durations[0],
+                max: durations[durations.length - 1],
+                p50: this.percentile(durations, 50),
+                p95: this.percentile(durations, 95),
+                p99: this.percentile(durations, 99),
+            },
+            apiTiming: {
+                average: this.average(apiTimes),
+                p50: this.percentile(apiTimes, 50),
+                p95: this.percentile(apiTimes, 95),
+                p99: this.percentile(apiTimes, 99),
+            },
+            overhead: {
+                average: this.average(overheads),
+                p50: this.percentile(overheads, 50),
+                p95: this.percentile(overheads, 95),
+                p99: this.percentile(overheads, 99),
+            },
+            budgetViolations: this.alerts.filter((a) => !toolName || a.toolName === toolName).length,
+        };
+    }
+    /**
+     * Calculate average
+     */
+    average(values) {
+        if (values.length === 0)
+            return 0;
+        return values.reduce((a, b) => a + b, 0) / values.length;
+    }
+    /**
+     * Calculate percentile
+     */
+    percentile(sortedValues, percentile) {
+        if (sortedValues.length === 0)
+            return 0;
+        const index = Math.ceil((percentile / 100) * sortedValues.length) - 1;
+        return sortedValues[Math.max(0, index)];
+    }
+    /**
+     * Log metrics in development
+     */
+    logMetrics(metrics) {
+        const icon = metrics.success ? '✅' : '❌';
+        const timeIcon = metrics.duration >
+            this.getBudgetForOperation(metrics.operationType, metrics.statusCode)
+            ? '🔴'
+            : metrics.duration > 1000
+                ? '🟡'
+                : '🟢';
+        console.error(`${icon} ${metrics.toolName} (${metrics.operationType}): ${timeIcon} ${metrics.duration.toFixed(0)}ms ` +
+            `[API: ${metrics.timingSplit.attioApi.toFixed(0)}ms, MCP: ${metrics.timingSplit.mcpOverhead.toFixed(0)}ms]` +
+            (metrics.cached ? ' 📦 CACHED' : '') +
+            (metrics.error ? ` ❌ ${metrics.error}` : ''));
+    }
+    /**
+     * Generate performance report
+     */
+    generateReport() {
+        const stats = this.getStatistics();
+        const recentAlerts = this.alerts.slice(-10);
+        if (!stats) {
+            return 'No performance data available';
+        }
+        return `
+Performance Report
+==================
+Total Operations: ${stats.count}
+Success Rate: ${stats.successRate.toFixed(1)}%
+Cache Hit Rate: ${stats.cacheHitRate.toFixed(1)}%
+
+Timing Statistics (ms)
+----------------------
+Average: ${stats.timing.average.toFixed(0)}
+Min: ${stats.timing.min.toFixed(0)}
+Max: ${stats.timing.max.toFixed(0)}
+P50: ${stats.timing.p50.toFixed(0)}
+P95: ${stats.timing.p95.toFixed(0)}
+P99: ${stats.timing.p99.toFixed(0)}
+
+API vs MCP Overhead (ms)
+------------------------
+API Average: ${stats.apiTiming.average.toFixed(0)}
+API P95: ${stats.apiTiming.p95.toFixed(0)}
+API P99: ${stats.apiTiming.p99.toFixed(0)}
+MCP Average: ${stats.overhead.average.toFixed(0)}
+MCP P95: ${stats.overhead.p95.toFixed(0)}
+MCP P99: ${stats.overhead.p99.toFixed(0)}
+
+Budget Violations: ${stats.budgetViolations}
+
+Recent Alerts
+-------------
+${recentAlerts
+            .map((a) => `[${a.level.toUpperCase()}] ${a.toolName}: ${a.duration.toFixed(0)}ms (${a.percentOver.toFixed(0)}% over budget)`)
+            .join('\n')}
+    `.trim();
+    }
+    /**
+     * Clear all data
+     */
+    clear() {
+        this.metrics = [];
+        this.alerts = [];
+        this.cache404.clear();
+        this.timingContext.clear();
+        this.metricsIndex = 0;
+        this.isBufferFull = false;
+    }
+    /**
+     * Export metrics for analysis
+     */
+    exportMetrics() {
+        return {
+            timestamp: new Date().toISOString(),
+            metrics: this.metrics,
+            statistics: this.getStatistics(),
+            alerts: this.alerts,
+            budgets: this.budgets,
+        };
+    }
+}
+// Export singleton instance
+export const enhancedPerformanceTracker = EnhancedPerformanceTracker.getInstance();
+//# sourceMappingURL=performance-enhanced.js.map

package/dist/middleware/performance-enhanced.js.map

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

package/dist/middleware/performance.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Performance Tracking Middleware
+ *
+ * Provides performance monitoring and timing for all MCP tool operations.
+ * Tracks execution time, API latency, and performance bottlenecks.
+ */
+/**
+ * Performance metrics for a single operation
+ */
+export interface PerformanceMetrics {
+    toolName: string;
+    startTime: number;
+    endTime: number;
+    duration: number;
+    success: boolean;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Performance thresholds for alerting
+ */
+export interface PerformanceThresholds {
+    warning: number;
+    critical: number;
+}
+/**
+ * Performance summary statistics
+ */
+export interface PerformanceSummary {
+    totalOperations: number;
+    successfulOperations: number;
+    failedOperations: number;
+    averageDuration: number;
+    minDuration: number;
+    maxDuration: number;
+    p50Duration: number;
+    p95Duration: number;
+    p99Duration: number;
+}
+/**
+ * Performance tracking service
+ */
+export declare class PerformanceTracker {
+    private static metrics;
+    private static thresholds;
+    private static enabled;
+    private static readonly maxMetrics;
+    private static metricsIndex;
+    private static isBufferFull;
+    /**
+     * Set performance thresholds for a tool
+     */
+    static setThresholds(toolName: string, thresholds: PerformanceThresholds): void;
+    /**
+     * Get default thresholds
+     */
+    static getDefaultThresholds(): PerformanceThresholds;
+    /**
+     * Start tracking an operation
+     */
+    static startOperation(toolName: string, metadata?: Record<string, unknown>): number;
+    /**
+     * End tracking an operation
+     */
+    static endOperation(toolName: string, startTime: number, success?: boolean, error?: string, metadata?: Record<string, unknown>): PerformanceMetrics;
+    /**
+     * Get performance summary for a tool
+     */
+    static getSummary(toolName?: string): PerformanceSummary;
+    /**
+     * Get percentile value from sorted array
+     */
+    private static getPercentile;
+    /**
+     * Clear all metrics
+     */
+    static clear(): void;
+    /**
+     * Get all metrics
+     */
+    static getMetrics(): PerformanceMetrics[];
+    /**
+     * Export metrics as JSON
+     */
+    static exportMetrics(): string;
+    /**
+     * Enable or disable tracking
+     */
+    static setEnabled(enabled: boolean): void;
+    /**
+     * Check if tracking is enabled
+     */
+    static isEnabled(): boolean;
+    /**
+     * Measure async function performance
+     */
+    static measureAsync<T>(toolName: string, fn: () => Promise<T>, metadata?: Record<string, unknown>): Promise<T>;
+    /**
+     * Measure sync function performance
+     */
+    static measure<T>(toolName: string, fn: () => T, metadata?: Record<string, unknown>): T;
+    /**
+     * Get slow operations above threshold
+     */
+    static getSlowOperations(threshold?: number): PerformanceMetrics[];
+    /**
+     * Get failed operations
+     */
+    static getFailedOperations(): PerformanceMetrics[];
+    /**
+     * Generate performance report
+     */
+    static generateReport(): string;
+}
+/**
+ * Performance monitoring decorator
+ */
+export declare function trackPerformance(toolName?: string): (target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Export a singleton instance for convenience
+ */
+export declare const performanceTracker: typeof PerformanceTracker;
+export { PerformanceMonitor, performanceMonitor, } from './performance-compat.js';
+//# sourceMappingURL=performance.d.ts.map

package/dist/middleware/performance.d.ts.map

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