agentic-qe 2.0.0 → 2.1.0

package/dist/core/metrics/MetricsAggregator.d.ts

@@ -0,0 +1,228 @@
+/**
+ * MetricsAggregator - Unified Metrics Collection and Analysis
+ *
+ * Collects metrics from all swarm components, provides trend analysis,
+ * anomaly detection, and performance recommendations.
+ */
+import { EventEmitter } from 'events';
+/**
+ * Metric source components
+ */
+export type MetricSource = 'swarm' | 'optimizer' | 'orchestrator' | 'scheduler' | 'memory' | 'transport' | 'recovery' | 'agent';
+/**
+ * Metric types
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram' | 'summary';
+/**
+ * Individual metric point
+ */
+export interface MetricPoint {
+    timestamp: Date;
+    value: number;
+    labels?: Record<string, string>;
+}
+/**
+ * Metric definition
+ */
+export interface MetricDefinition {
+    name: string;
+    type: MetricType;
+    source: MetricSource;
+    description: string;
+    unit?: string;
+    labels?: string[];
+}
+/**
+ * Metric with history
+ */
+export interface Metric extends MetricDefinition {
+    points: MetricPoint[];
+    current: number;
+    min: number;
+    max: number;
+    avg: number;
+    sum: number;
+    count: number;
+}
+/**
+ * Aggregated metrics snapshot
+ */
+export interface MetricsSnapshot {
+    timestamp: Date;
+    metrics: Record<string, Metric>;
+    sources: Record<MetricSource, Record<string, number>>;
+    summary: MetricsSummary;
+}
+/**
+ * Metrics summary
+ */
+export interface MetricsSummary {
+    totalMetrics: number;
+    activeMetrics: number;
+    totalDataPoints: number;
+    oldestDataPoint: Date;
+    newestDataPoint: Date;
+    uptimeSeconds: number;
+}
+/**
+ * Trend analysis result
+ */
+export interface TrendAnalysis {
+    metricName: string;
+    direction: 'increasing' | 'decreasing' | 'stable' | 'volatile';
+    changeRate: number;
+    percentChange: number;
+    confidence: number;
+    forecast: number;
+    anomalyScore: number;
+}
+/**
+ * Anomaly detection result
+ */
+export interface Anomaly {
+    timestamp: Date;
+    metricName: string;
+    value: number;
+    expectedRange: {
+        min: number;
+        max: number;
+    };
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    description: string;
+}
+/**
+ * Performance recommendation
+ */
+export interface Recommendation {
+    timestamp: Date;
+    category: 'optimization' | 'scaling' | 'configuration' | 'alert';
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    title: string;
+    description: string;
+    metrics: string[];
+    suggestedAction: string;
+}
+/**
+ * Aggregator configuration
+ */
+export interface MetricsAggregatorConfig {
+    /** Maximum history points per metric */
+    maxHistoryPoints: number;
+    /** Retention period in milliseconds */
+    retentionPeriod: number;
+    /** Aggregation interval in milliseconds */
+    aggregationInterval: number;
+    /** Enable anomaly detection */
+    enableAnomalyDetection: boolean;
+    /** Anomaly detection sensitivity (0-1) */
+    anomalySensitivity: number;
+    /** Enable trend analysis */
+    enableTrendAnalysis: boolean;
+    /** Trend window in milliseconds */
+    trendWindow: number;
+    /** Enable recommendations */
+    enableRecommendations: boolean;
+}
+/**
+ * Metrics Aggregator Implementation
+ */
+export declare class MetricsAggregator extends EventEmitter {
+    private readonly logger;
+    private readonly config;
+    private metrics;
+    private definitions;
+    private anomalies;
+    private recommendations;
+    private startTime;
+    private aggregationTimer?;
+    constructor(config?: Partial<MetricsAggregatorConfig>);
+    /**
+     * Start the aggregator
+     */
+    start(): void;
+    /**
+     * Stop the aggregator
+     */
+    stop(): void;
+    /**
+     * Register a metric definition
+     */
+    registerMetric(definition: MetricDefinition): void;
+    /**
+     * Record a metric value
+     */
+    record(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Increment a counter metric
+     */
+    increment(name: string, delta?: number, labels?: Record<string, string>): void;
+    /**
+     * Get current metric value
+     */
+    get(name: string): number | undefined;
+    /**
+     * Get metric with full history
+     */
+    getMetric(name: string): Metric | undefined;
+    /**
+     * Get all metrics
+     */
+    getAllMetrics(): Map<string, Metric>;
+    /**
+     * Get metrics by source
+     */
+    getMetricsBySource(source: MetricSource): Map<string, Metric>;
+    /**
+     * Get metrics snapshot
+     */
+    getSnapshot(): MetricsSnapshot;
+    /**
+     * Analyze trend for a metric
+     */
+    analyzeTrend(metricName: string): TrendAnalysis | null;
+    /**
+     * Get detected anomalies
+     */
+    getAnomalies(limit?: number): Anomaly[];
+    /**
+     * Get recommendations
+     */
+    getRecommendations(limit?: number): Recommendation[];
+    /**
+     * Generate recommendations based on current metrics
+     */
+    generateRecommendations(): Recommendation[];
+    /**
+     * Initialize default metric definitions
+     */
+    private initializeDefaultMetrics;
+    /**
+     * Prune old metric history
+     */
+    private pruneMetricHistory;
+    /**
+     * Check for anomaly in metric
+     */
+    private checkForAnomaly;
+    /**
+     * Calculate standard deviation
+     */
+    private calculateStdDev;
+    /**
+     * Aggregate metrics (called periodically)
+     */
+    private aggregate;
+    /**
+     * Cleanup
+     */
+    destroy(): void;
+}
+/**
+ * Get default aggregator
+ */
+export declare function getMetricsAggregator(config?: Partial<MetricsAggregatorConfig>): MetricsAggregator;
+/**
+ * Reset default aggregator (for testing)
+ */
+export declare function resetMetricsAggregator(): void;
+//# sourceMappingURL=MetricsAggregator.d.ts.map

package/dist/core/metrics/MetricsAggregator.d.ts.map

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