@smythos/sre 1.6.1 → 1.6.8

package/dist/types/subsystems/PerformanceManager/Performance.service/connectors/LocalPerformanceConnector.class.d.ts

@@ -1,100 +0,0 @@
-import { PerformanceConnector, IPerformanceRequest } from '../PerformanceConnector';
-import { AIComponentMetrics, AIAgentPerformanceReport, AIPerformanceEvent, AIPerformanceConfig, MetricWindow, ComponentBaseline } from '@sre/types/Performance.types';
-import { AccessRequest } from '@sre/Security/AccessControl/AccessRequest.class';
-import { AccessCandidate } from '@sre/Security/AccessControl/AccessCandidate.class';
-import { ACL } from '@sre/Security/AccessControl/ACL.class';
-import { IAccessCandidate } from '@sre/types/ACL.types';
-/**
- * Local Performance Connector Implementation
- */
-export declare class LocalPerformanceConnector extends PerformanceConnector {
-    name: string;
-    id: string;
-    private metricsIndex;
-    private config;
-    private analyzer;
-    private collector;
-    private logger;
-    private dataDir;
-    private isInitialized;
-    constructor(settings?: any);
-    /**
-     * Initialize the connector
-     */
-    start(): Promise<void>;
-    /**
-     * Shutdown the connector
-     */
-    stop(): Promise<void>;
-    /**
-     * Get resource ACL
-     */
-    getResourceACL(resourceId: string, candidate: IAccessCandidate): Promise<ACL>;
-    /**
-     * Override requester method to implement proper access control
-     * Create secure requester interface scoped to access candidate
-     */
-    requester(candidate: AccessCandidate): IPerformanceRequest;
-    /**
-     * Store performance metrics
-     */
-    protected storeMetrics(accessRequest: AccessRequest, metrics: AIComponentMetrics[]): Promise<void>;
-    /**
-     * Retrieve metrics with filtering
-     */
-    protected getMetrics(accessRequest: AccessRequest, timeWindow?: MetricWindow): Promise<AIComponentMetrics[]>;
-    /**
-     * Generate comprehensive performance report
-     */
-    protected generateReport(accessRequest: AccessRequest): Promise<AIAgentPerformanceReport>;
-    /**
-     * Clear stored metrics
-     */
-    protected clearMetrics(accessRequest: AccessRequest): Promise<void>;
-    /**
-     * Get performance events
-     */
-    protected getEvents(accessRequest: AccessRequest, since?: number): Promise<AIPerformanceEvent[]>;
-    /**
-     * Update monitoring configuration
-     */
-    protected updateConfig(accessRequest: AccessRequest, config: Partial<AIPerformanceConfig>): Promise<void>;
-    /**
-     * Export metrics in various formats
-     */
-    protected exportMetrics(accessRequest: AccessRequest, format: 'json' | 'prometheus' | 'csv'): Promise<string>;
-    /**
-     * Get component baselines
-     */
-    protected getBaselines(accessRequest: AccessRequest): Promise<ComponentBaseline[]>;
-    /**
-     * Establish baseline for component
-     */
-    protected establishBaseline(accessRequest: AccessRequest, componentName: string): Promise<ComponentBaseline>;
-    /**
-     * Get connector statistics
-     */
-    getStats(): Promise<{
-        totalMetrics: number;
-        agentCount: number;
-        timeRange: {
-            start: number;
-            end: number;
-        };
-        storageSize: number;
-    }>;
-    private addToIndex;
-    private enforceSizeLimits;
-    private checkRealTimeBottleneck;
-    private setupEventListeners;
-    private loadPersistedData;
-    private setupPersistence;
-    private persistData;
-    private aggregateMetrics;
-    private aggregate;
-    private percentile;
-    private mean;
-    private formatPrometheusMetrics;
-    private formatCSVMetrics;
-    private estimateStorageSize;
-}

package/dist/types/subsystems/PerformanceManager/Performance.service/index.d.ts

@@ -1,22 +0,0 @@
-import { ConnectorServiceProvider } from '../../../Core/ConnectorsService';
-/**
- * Performance Service Provider
- */
-export declare class PerformanceService extends ConnectorServiceProvider {
-    private logger;
-    /**
-     * Register all available performance connectors
-     */
-    register(): void;
-    /**
-     * Initialize performance service
-     */
-    init(): void;
-    /**
-     * Auto-configure performance monitoring based on environment
-     */
-    private autoConfigurePerformanceMonitoring;
-}
-export { LocalPerformanceConnector } from './connectors/LocalPerformanceConnector.class';
-export { PerformanceConnector } from './PerformanceConnector';
-export type { IPerformanceRequest } from './PerformanceConnector';

package/dist/types/types/Performance.types.d.ts

@@ -1,468 +0,0 @@
-export interface AIComponentMetrics {
-    /** Component identifier */
-    componentName: string;
-    /** Agent executing this component */
-    agentId: string;
-    /** Execution timing breakdown */
-    timing: {
-        /** Total execution time (ms) */
-        total: number;
-        /** Time spent on input processing (ms) */
-        inputProcessing: number;
-        /** Time spent on core logic (ms) */
-        coreProcessing: number;
-        /** Time spent on output processing (ms) */
-        outputProcessing: number;
-        /** Queue wait time (ms) */
-        queueTime: number;
-    };
-    /** Memory usage analytics */
-    memory: {
-        /** Peak memory usage during execution (bytes) */
-        peak: number;
-        /** Memory delta from start to finish (bytes) */
-        delta: number;
-        /** Memory pressure level (0-1) */
-        pressure: number;
-    };
-    /** Data flow metrics */
-    dataFlow: {
-        /** Input data size (bytes) */
-        inputSize: number;
-        /** Output data size (bytes) */
-        outputSize: number;
-        /** Data transformation ratio */
-        transformationRatio: number;
-        /** Data complexity score (0-1) */
-        complexityScore: number;
-    };
-    /** LLM-specific metrics (if applicable) */
-    llm?: {
-        /** Model used for this execution */
-        model: string;
-        /** Token usage breakdown */
-        tokens: {
-            prompt: number;
-            completion: number;
-            total: number;
-        };
-        /** Estimated cost in USD */
-        estimatedCost: number;
-        /** Context window utilization (0-1) */
-        contextUtilization: number;
-        /** Response quality score (0-1) */
-        qualityScore?: number;
-    };
-    /** Execution result metadata */
-    execution: {
-        /** Execution timestamp */
-        timestamp: number;
-        /** Success/failure status */
-        success: boolean;
-        /** Error type if failed */
-        errorType?: string;
-        /** Retry count */
-        retryCount: number;
-        /** Component configuration hash */
-        configHash: string;
-    };
-    /** Performance impact factors */
-    impact: {
-        /** CPU usage percentage during execution */
-        cpuUsage: number;
-        /** I/O operations count */
-        ioOperations: number;
-        /** Network requests made */
-        networkRequests: number;
-        /** Cache hit/miss status */
-        cacheStatus: 'hit' | 'miss' | 'n/a';
-    };
-}
-/**
- * Comprehensive AI agent performance report
- */
-export interface AIAgentPerformanceReport {
-    /** Report metadata */
-    metadata: {
-        agentId: string;
-        agentName: string;
-        reportId: string;
-        generatedAt: number;
-        analysisWindow: {
-            start: number;
-            end: number;
-            duration?: number;
-        };
-        version: string;
-    };
-    /** Executive summary */
-    summary: {
-        /** Total execution time across all components */
-        totalExecutionTime: number;
-        /** Total LLM costs */
-        totalLLMCosts: number;
-        /** Success rate percentage */
-        successRate: number;
-        /** Performance grade (A-F) */
-        performanceGrade: 'A' | 'B' | 'C' | 'D' | 'F';
-        /** Key performance indicators */
-        kpis: {
-            throughput: number;
-            latency: number;
-            efficiency: number;
-            reliability: number;
-        };
-    };
-    /** Detailed component analysis */
-    components: {
-        /** Individual component metrics */
-        metrics: AIComponentMetrics[];
-        /** Component ranking by performance */
-        ranking: Array<{
-            componentName: string;
-            score: number;
-            rank: number;
-        }>;
-        /** Component dependency graph analysis */
-        dependencies: {
-            criticalPath: string[];
-            parallelizationOpportunities: string[][];
-            bottleneckComponents: string[];
-        };
-    };
-    /** AI-specific insights */
-    aiInsights: {
-        /** LLM usage optimization opportunities */
-        llmOptimization: {
-            modelDowngradeOpportunities: Array<{
-                component: string;
-                currentModel: string;
-                suggestedModel: string;
-                potentialSavings: number;
-            }>;
-            cachingOpportunities: Array<{
-                component: string;
-                repetitionRate: number;
-                potentialSavings: number;
-            }>;
-            batchingOpportunities: Array<{
-                components: string[];
-                batchSize: number;
-                potentialSavings: number;
-            }>;
-        };
-        /** Semantic analysis of component interactions */
-        semanticAnalysis: {
-            componentAffinity: Record<string, number>;
-            dataFlowEfficiency: number;
-            informationLossRate: number;
-        };
-    };
-    /** Performance bottlenecks with AI context */
-    bottlenecks: AIPerformanceBottleneck[];
-    /** Intelligent optimization recommendations */
-    recommendations: AIOptimizationRecommendation[];
-    /** Trend analysis and predictions */
-    trends: {
-        /** Performance trends over time */
-        performanceTrend: 'improving' | 'stable' | 'degrading';
-        /** Cost trends */
-        costTrend: 'improving' | 'stable' | 'degrading';
-        /** Predicted future performance */
-        predictions: Array<{
-            metric: string;
-            futureValue: number;
-            confidence: number;
-            timeframe: number;
-        }>;
-    };
-}
-/**
- * AI-aware performance bottleneck
- */
-export interface AIPerformanceBottleneck {
-    /** Bottleneck identification */
-    id: string;
-    type: AIBottleneckType;
-    severity: BottleneckSeverity;
-    /** Component(s) affected */
-    affectedComponents: string[];
-    /** Detailed analysis */
-    analysis: {
-        description: string;
-        rootCause: string;
-        impactAssessment: {
-            performanceImpact: number;
-            costImpact: number;
-            userExperienceImpact: 'low' | 'medium' | 'high';
-        };
-    };
-    /** AI-specific context */
-    aiContext?: {
-        modelInefficiency?: {
-            model: string;
-            taskComplexity: number;
-            overProvisioningScore: number;
-        };
-        semanticBottleneck?: {
-            informationLoss: number;
-            contextFragmentation: number;
-            semanticDrift: number;
-        };
-    };
-    /** Resolution guidance */
-    resolution: {
-        suggestedFix: string;
-        implementationComplexity: 'low' | 'medium' | 'high';
-        estimatedResolutionTime: number;
-        expectedImprovement: {
-            performanceGain: number;
-            costReduction: number;
-        };
-        prerequisites: string[];
-    };
-    /** Confidence and validation */
-    confidence: number;
-    validatedBy?: 'static_analysis' | 'runtime_profiling' | 'ml_prediction';
-}
-/**
- * AI-driven optimization recommendation
- */
-export interface AIOptimizationRecommendation {
-    /** Recommendation metadata */
-    id: string;
-    type: AIOptimizationType;
-    priority: OptimizationPriority;
-    category: 'performance' | 'cost' | 'reliability' | 'scalability';
-    /** Target components */
-    targetComponents: string[];
-    /** Recommendation details */
-    recommendation: {
-        title: string;
-        description: string;
-        technicalDetails: string;
-        implementation: {
-            steps: string[];
-            codeExamples: Array<{
-                language: string;
-                code: string;
-                description: string;
-            }>;
-            configuration: Record<string, any>;
-        };
-    };
-    /** Impact analysis */
-    impact: {
-        performance: {
-            latencyImprovement: number;
-            throughputImprovement: number;
-            memoryReduction: number;
-        };
-        cost: {
-            operationalSavings: number;
-            infrastructureSavings: number;
-            llmCostReduction: number;
-        };
-        reliability: {
-            errorReduction: number;
-            uptimeImprovement: number;
-        };
-    };
-    /** Implementation guidance */
-    implementation: {
-        effort: ImplementationEffort;
-        timeline: string;
-        risks: Array<{
-            description: string;
-            probability: number;
-            impact: 'low' | 'medium' | 'high';
-            mitigation: string;
-        }>;
-        rollbackStrategy: string;
-    };
-    /** AI-generated insights */
-    aiGenerated: {
-        confidence: number;
-        reasoning: string;
-        similarCases: number;
-        validationMethod: string;
-    };
-}
-/**
- * Real-time performance monitoring configuration
- */
-export interface AIPerformanceConfig {
-    /** Global monitoring settings */
-    global: {
-        enabled: boolean;
-        samplingRate: number;
-        bufferSize: number;
-        flushInterval: number;
-    };
-    /** Component-specific settings */
-    components: {
-        whitelist: string[];
-        blacklist: string[];
-        customSamplingRates: Record<string, number>;
-    };
-    /** LLM monitoring settings */
-    llm: {
-        trackTokenUsage: boolean;
-        trackCosts: boolean;
-        trackQuality: boolean;
-        costThresholds: {
-            warning: number;
-            critical: number;
-        };
-    };
-    /** Alert configuration */
-    alerts: {
-        enabled: boolean;
-        thresholds: {
-            latencyP95: number;
-            errorRate: number;
-            memoryUsage: number;
-            costPerOperation: number;
-        };
-        channels: Array<{
-            type: 'console' | 'file' | 'webhook';
-            config: Record<string, any>;
-        }>;
-    };
-    /** Advanced features */
-    advanced: {
-        enablePredictiveAnalysis: boolean;
-        enableAutoOptimization: boolean;
-        enableSemanticAnalysis: boolean;
-        retentionDays: number;
-        compressionEnabled: boolean;
-    };
-}
-/**
- * Performance event for real-time streaming
- */
-export interface AIPerformanceEvent {
-    /** Event metadata */
-    id: string;
-    timestamp: number;
-    type: AIPerformanceEventType;
-    source: {
-        agentId: string;
-        componentName: string;
-        sessionId?: string;
-    };
-    /** Event payload */
-    payload: {
-        metric?: AIComponentMetrics;
-        bottleneck?: AIPerformanceBottleneck;
-        recommendation?: AIOptimizationRecommendation;
-        alert?: {
-            level: 'info' | 'warning' | 'error' | 'critical';
-            message: string;
-            context: Record<string, any>;
-        };
-    };
-    /** Event processing metadata */
-    processing: {
-        latency: number;
-        batchId?: string;
-        sequenceNumber: number;
-    };
-}
-export declare enum AIBottleneckType {
-    LLM_OVERPROVISIONING = "llm_overprovisioning",
-    CONTEXT_FRAGMENTATION = "context_fragmentation",
-    SEMANTIC_BOTTLENECK = "semantic_bottleneck",
-    TOKEN_INEFFICIENCY = "token_inefficiency",
-    MODEL_MISMATCH = "model_mismatch",
-    CACHING_MISS = "caching_miss",
-    SEQUENTIAL_DEPENDENCY = "sequential_dependency",
-    MEMORY_PRESSURE = "memory_pressure",
-    IO_CONTENTION = "io_contention",
-    NETWORK_LATENCY = "network_latency"
-}
-export declare enum BottleneckSeverity {
-    LOW = "low",
-    MEDIUM = "medium",
-    HIGH = "high",
-    CRITICAL = "critical"
-}
-export declare enum AIOptimizationType {
-    LLM_MODEL_OPTIMIZATION = "llm_model_optimization",
-    SEMANTIC_CACHING = "semantic_caching",
-    CONTEXT_COMPRESSION = "context_compression",
-    PARALLEL_PROCESSING = "parallel_processing",
-    BATCH_OPTIMIZATION = "batch_optimization",
-    MEMORY_POOLING = "memory_pooling",
-    PREDICTIVE_LOADING = "predictive_loading",
-    ADAPTIVE_SAMPLING = "adaptive_sampling",
-    COST_OPTIMIZATION = "cost_optimization",
-    QUALITY_IMPROVEMENT = "quality_improvement"
-}
-export declare enum OptimizationPriority {
-    LOW = "low",
-    MEDIUM = "medium",
-    HIGH = "high",
-    CRITICAL = "critical"
-}
-export declare enum ImplementationEffort {
-    MINIMAL = "minimal",// < 1 day
-    LOW = "low",// 1-3 days
-    MEDIUM = "medium",// 1-2 weeks
-    HIGH = "high",// 2-4 weeks
-    EXTENSIVE = "extensive"
-}
-export declare enum AIPerformanceEventType {
-    COMPONENT_START = "component_start",
-    COMPONENT_END = "component_end",
-    BOTTLENECK_DETECTED = "bottleneck_detected",
-    OPTIMIZATION_SUGGESTED = "optimization_suggested",
-    THRESHOLD_EXCEEDED = "threshold_exceeded",
-    ANOMALY_DETECTED = "anomaly_detected",
-    TREND_CHANGE = "trend_change"
-}
-/**
- * Performance metric aggregation window
- */
-export interface MetricWindow {
-    start: number;
-    end: number;
-    granularity: '1m' | '5m' | '15m' | '1h' | '1d';
-    aggregation: 'avg' | 'sum' | 'min' | 'max' | 'p95' | 'p99';
-}
-/**
- * Component performance baseline
- */
-export interface ComponentBaseline {
-    componentName: string;
-    baseline: {
-        latency: {
-            p50: number;
-            p95: number;
-            p99: number;
-        };
-        memoryUsage: {
-            avg: number;
-            peak: number;
-        };
-        successRate: number;
-        costPerOperation: number;
-    };
-    established: number;
-    sampleSize: number;
-    confidence: number;
-}
-/**
- * Export interface for external monitoring integration
- */
-export interface ExternalMonitoringExport {
-    format: 'prometheus' | 'datadog' | 'newrelic' | 'cloudwatch' | 'grafana';
-    endpoint?: string;
-    credentials?: Record<string, string>;
-    tags?: Record<string, string>;
-    filters?: {
-        components?: string[];
-        metrics?: string[];
-        severity?: BottleneckSeverity[];
-    };
-}

package/dist/types/utils/package-manager.utils.d.ts

@@ -1,26 +0,0 @@
-/**
- * Package Manager Detection Utility
- *
- * This utility helps in identifying the package manager (npm, pnpm, or yarn)
- * used in the current environment. This is crucial for providing the correct
- * install instructions to the user.
- */
-/**
- * Detects the package manager used in the current environment.
- *
- * It checks the `npm_config_user_agent` environment variable first,
- * which is a standard way to detect the package manager.
- *
- * Falls back to checking the executed script path and common package manager
- * patterns.
- *
- * @returns {'npm' | 'pnpm' | 'yarn'} The detected package manager.
- */
-export declare const getPackageManager: () => "npm" | "pnpm" | "yarn";
-/**
- * Gets the install command for the detected package manager.
- *
- * @param packageName - The name of the package to install
- * @returns The complete install command string
- */
-export declare const getInstallCommand: (packageName: string) => string;