@windagency/valora 2.0.1

package/dist/utils/rate-limiter.js

@@ -0,0 +1,214 @@
+/**
+ * Rate Limiter Utility
+ *
+ * Implements sliding window rate limiting to prevent abuse and DoS attacks.
+ * Supports different rate limits for different operations and automatic cleanup.
+ */
+import { COMMAND_EXECUTION_LIMIT, CONFIG_ACCESS_LIMIT, MCP_SAMPLING_LIMIT, MCP_TOOL_CALL_LIMIT, RATE_LIMIT_BLOCK_DURATION_MS, RATE_LIMIT_WINDOW_MS } from '../config/constants.js';
+/**
+ * Default rate limiting rules
+ */
+const DEFAULT_RATE_LIMIT_RULES = {
+    // Command execution - generous limits
+    command_execution: {
+        blockDurationMs: 60 * 1000,
+        maxRequests: COMMAND_EXECUTION_LIMIT,
+        windowMs: RATE_LIMIT_WINDOW_MS // 1 minute block
+    },
+    // Configuration access - high limits
+    config_access: {
+        blockDurationMs: 30 * 1000,
+        maxRequests: CONFIG_ACCESS_LIMIT,
+        windowMs: RATE_LIMIT_WINDOW_MS // 30 second block
+    },
+    // Default fallback - conservative limits
+    default: {
+        // 20 requests per minute
+        blockDurationMs: 2 * 60 * 1000,
+        maxRequests: 20,
+        windowMs: RATE_LIMIT_WINDOW_MS // 2 minute block
+    },
+    // LLM API calls - moderate limits to prevent cost overruns
+    llm_api_call: {
+        // 60 requests per minute (adjust based on API limits)
+        blockDurationMs: 2 * 60 * 1000,
+        maxRequests: 60,
+        windowMs: RATE_LIMIT_WINDOW_MS // 2 minute block
+    },
+    // MCP sampling requests - moderate limits
+    mcp_sampling: {
+        blockDurationMs: 2 * 60 * 1000,
+        maxRequests: MCP_SAMPLING_LIMIT,
+        windowMs: RATE_LIMIT_WINDOW_MS // 2 minute block
+    },
+    // MCP tool calls - strict limits for security
+    mcp_tool_call: {
+        blockDurationMs: RATE_LIMIT_BLOCK_DURATION_MS,
+        maxRequests: MCP_TOOL_CALL_LIMIT,
+        windowMs: RATE_LIMIT_WINDOW_MS
+    }
+};
+/**
+ * Rate Limiter Class
+ *
+ * Implements sliding window rate limiting with automatic cleanup.
+ * Thread-safe and memory-efficient with bounded storage.
+ */
+export class RateLimiter {
+    cleanupInterval = null;
+    config;
+    rules = {};
+    constructor(options = {}) {
+        this.config = { ...DEFAULT_RATE_LIMIT_RULES, ...options.rules };
+        // Start automatic cleanup
+        const cleanupIntervalMs = options.cleanupIntervalMs ?? 5 * 60 * 1000; // 5 minutes
+        this.startCleanup(cleanupIntervalMs);
+    }
+    /**
+     * Check if a request is allowed under rate limiting rules
+     */
+    isAllowed(identifier, ruleName = 'default') {
+        const rule = this.config[ruleName] ?? this.config['default'];
+        if (!rule) {
+            throw new Error(`Rate limit rule '${ruleName}' not found and no default rule configured`);
+        }
+        const now = Date.now();
+        // Initialize entry if it doesn't exist
+        this.rules[identifier] ??= {
+            lastRequest: now,
+            requests: []
+        };
+        const entry = this.rules[identifier];
+        // Check if currently blocked
+        if (entry.blockedUntil && now < entry.blockedUntil) {
+            return false;
+        }
+        // Remove old requests outside the window
+        entry.requests = entry.requests.filter((timestamp) => now - timestamp < rule.windowMs);
+        // Check if under the limit
+        if (entry.requests.length < rule.maxRequests) {
+            entry.requests.push(now);
+            entry.lastRequest = now;
+            entry.blockedUntil = undefined; // Clear any previous block
+            return true;
+        }
+        // Exceeded limit - apply block
+        if (rule.blockDurationMs) {
+            entry.blockedUntil = now + rule.blockDurationMs;
+        }
+        return false;
+    }
+    /**
+     * Get rate limit status for an identifier
+     */
+    getStatus(identifier, ruleName = 'default') {
+        const rule = this.config[ruleName] ?? this.config['default'];
+        if (!rule) {
+            throw new Error(`Rate limit rule '${ruleName}' not found and no default rule configured`);
+        }
+        const now = Date.now();
+        const entry = this.rules[identifier] ?? { lastRequest: now, requests: [] };
+        const blocked = entry.blockedUntil && now < entry.blockedUntil;
+        // Clean old requests
+        const validRequests = entry.requests.filter((timestamp) => now - timestamp < rule.windowMs);
+        const remaining = Math.max(0, rule.maxRequests - validRequests.length);
+        const firstRequest = validRequests[0];
+        const resetTime = firstRequest !== undefined ? firstRequest + rule.windowMs : now + rule.windowMs;
+        return {
+            allowed: !blocked && remaining > 0,
+            blockedUntil: blocked ? entry.blockedUntil : undefined,
+            remaining,
+            resetTime
+        };
+    }
+    /**
+     * Reset rate limit for an identifier
+     */
+    reset(identifier) {
+        delete this.rules[identifier];
+    }
+    /**
+     * Get all configured rules
+     */
+    getRules() {
+        return { ...this.config };
+    }
+    /**
+     * Update a rate limit rule
+     */
+    updateRule(ruleName, rule) {
+        this.config[ruleName] = rule;
+    }
+    /**
+     * Get current statistics
+     */
+    getStats() {
+        const now = Date.now();
+        const blockedCount = Object.values(this.rules).filter((entry) => entry.blockedUntil && now < entry.blockedUntil).length;
+        return {
+            activeRules: Object.keys(this.config),
+            blockedIdentifiers: blockedCount,
+            totalIdentifiers: Object.keys(this.rules).length
+        };
+    }
+    /**
+     * Start automatic cleanup of old entries
+     */
+    startCleanup(intervalMs) {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, intervalMs);
+        // Allow process to exit even if cleanup interval is active
+        this.cleanupInterval.unref();
+    }
+    /**
+     * Clean up old rate limit entries
+     */
+    cleanup() {
+        const now = Date.now();
+        const maxWindow = Math.max(...Object.values(this.config).map((r) => r.windowMs));
+        // Remove entries that haven't been active for more than 2x the max window
+        const cutoffTime = now - maxWindow * 2;
+        Object.entries(this.rules)
+            .filter(([, entry]) => entry.lastRequest < cutoffTime && (!entry.blockedUntil || entry.blockedUntil < now))
+            .forEach(([identifier]) => delete this.rules[identifier]);
+    }
+    /**
+     * Stop cleanup and clear all data
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.rules = {};
+    }
+}
+// Singleton instance for global use
+let globalRateLimiter = null;
+/**
+ * Get the global rate limiter instance
+ */
+export function getRateLimiter(options) {
+    globalRateLimiter ??= new RateLimiter(options);
+    return globalRateLimiter;
+}
+/**
+ * Set a custom global rate limiter instance
+ */
+export function setRateLimiter(rateLimiter) {
+    globalRateLimiter = rateLimiter;
+}
+/**
+ * Check if a request is rate limited
+ */
+export function checkRateLimit(identifier, ruleName = 'default') {
+    return getRateLimiter().isAllowed(identifier, ruleName);
+}
+/**
+ * Get rate limit status
+ */
+export function getRateLimitStatus(identifier, ruleName = 'default') {
+    return getRateLimiter().getStatus(identifier, ruleName);
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

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

package/dist/utils/resource-monitor.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Resource Monitoring Utility
+ *
+ * Comprehensive system resource monitoring including CPU, memory, disk I/O,
+ * network I/O, and process statistics with alerting capabilities.
+ */
+export interface MonitoringOptions {
+    alertCallback?: (alert: ResourceAlert) => void;
+    enableDiskMonitoring?: boolean;
+    enableNetworkMonitoring?: boolean;
+    enableProcessMonitoring?: boolean;
+    intervalMs?: number;
+    thresholds?: ResourceThresholds;
+}
+export interface ResourceAlert {
+    message: string;
+    metric: string;
+    resource: keyof ResourceUsage;
+    severity: 'critical' | 'warning';
+    threshold: number;
+    timestamp: number;
+    value: number;
+}
+export interface ResourceThresholds {
+    cpuUsagePercent?: number;
+    diskUsagePercent?: number;
+    memoryUsagePercent?: number;
+    processMemoryMB?: number;
+}
+export interface ResourceUsage {
+    cpu: {
+        cores: number;
+        loadAverage: number[];
+        model: string;
+        usage: number;
+    };
+    disk: {
+        free: number;
+        readBytes?: number;
+        total: number;
+        usagePercent: number;
+        used: number;
+        writeBytes?: number;
+    };
+    memory: {
+        free: number;
+        swapTotal?: number;
+        swapUsed?: number;
+        total: number;
+        usagePercent: number;
+        used: number;
+    };
+    network?: {
+        rxBytes: number;
+        rxPackets: number;
+        txBytes: number;
+        txPackets: number;
+    };
+    process: {
+        cpuUsage: NodeJS.CpuUsage;
+        memoryUsage: NodeJS.MemoryUsage;
+        pid: number;
+        threadCount?: number;
+        uptime: number;
+    };
+    timestamp: number;
+}
+/**
+ * Resource Monitor Class
+ *
+ * Monitors system resources and provides real-time metrics with alerting.
+ */
+export declare class ResourceMonitor {
+    private lastDiskStats?;
+    private logger;
+    private metricsCollector;
+    private monitoringInterval?;
+    private options;
+    private startTime;
+    constructor(options?: MonitoringOptions);
+    /**
+     * Start resource monitoring
+     */
+    startMonitoring(): void;
+    /**
+     * Stop resource monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Get current resource usage snapshot
+     */
+    getCurrentUsage(): Promise<ResourceUsage>;
+    /**
+     * Collect all resource metrics
+     */
+    private collectMetrics;
+    /**
+     * Get CPU metrics
+     */
+    private getCpuMetrics;
+    /**
+     * Get memory metrics
+     */
+    private getMemoryMetrics;
+    /**
+     * Get basic disk metrics (fallback)
+     */
+    private getBasicDiskMetrics;
+    /**
+     * Get disk metrics
+     */
+    private getDiskMetrics;
+    /**
+     * Parse disk usage from df command output
+     */
+    private parseDiskUsage;
+    /**
+     * Get network metrics
+     */
+    private getNetworkMetrics;
+    /**
+     * Get basic process metrics (fallback)
+     */
+    private getBasicProcessMetrics;
+    /**
+     * Get detailed process metrics
+     */
+    private getProcessMetrics;
+    /**
+     * Get swap memory information (Unix-like systems)
+     */
+    private getSwapInfo;
+    /**
+     * Get thread count for current process (Unix-like systems)
+     */
+    private getThreadCount;
+    /**
+     * Record metrics in the metrics collector
+     */
+    private recordMetrics;
+    /**
+     * Check resource thresholds and generate alerts
+     */
+    private checkThresholds;
+    /**
+     * Check CPU usage threshold
+     */
+    private checkCpuThreshold;
+    /**
+     * Check memory usage threshold
+     */
+    private checkMemoryThreshold;
+    /**
+     * Check disk usage threshold
+     */
+    private checkDiskThreshold;
+    /**
+     * Check process memory threshold
+     */
+    private checkProcessMemoryThreshold;
+    /**
+     * Create a resource alert with appropriate severity
+     */
+    private createAlert;
+    /**
+     * Trigger all alerts
+     */
+    private triggerAlerts;
+    /**
+     * Get monitoring statistics
+     */
+    getStats(): {
+        intervalMs: number;
+        lastCollection?: number;
+        monitoringActive: boolean;
+        uptime: number;
+    };
+    /**
+     * Destroy the monitor and clean up resources
+     */
+    destroy(): void;
+}
+/**
+ * Get the global resource monitor instance
+ */
+export declare function getResourceMonitor(options?: MonitoringOptions): ResourceMonitor;
+/**
+ * Set a custom global resource monitor instance
+ */
+export declare function setResourceMonitor(monitor: ResourceMonitor): void;
+/**
+ * Convenience functions for global resource monitoring
+ */
+export declare function getCurrentResourceUsage(): Promise<ResourceUsage>;
+export declare function getResourceStats(): {
+    intervalMs: number;
+    lastCollection?: number;
+    monitoringActive: boolean;
+    uptime: number;
+};
+export declare function startResourceMonitoring(options?: MonitoringOptions): void;
+export declare function stopResourceMonitoring(): void;
+//# sourceMappingURL=resource-monitor.d.ts.map

package/dist/utils/resource-monitor.d.ts.map

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