@defai.digital/ax-cli 4.4.6 → 4.4.10

package/dist/utils/rate-limiter.js

@@ -1,338 +0,0 @@
-/**
- * Basic Rate Limiting Utilities (Free Tier) - REQ-SEC-006
- *
- * Implements token bucket algorithm for rate limiting API calls and user actions
- * Prevents API abuse and ensures fair resource usage
- *
- * Free Tier Features:
- * ✅ Token bucket rate limiting
- * ✅ Multi-tier limits (per-second, per-minute)
- * ✅ Per-key limits (per-user, per-IP)
- * ✅ In-memory state (lightweight)
- *
- * Enterprise features (requires @ax-cli/enterprise):
- * - Custom quotas per user/team/project
- * - Cost analytics & forecasting
- * - Budget alerts ($X/day threshold)
- * - Persistent state (survives restarts)
- * - Multi-tenant quota management
- * - Usage optimization tips
- *
- * @module rate-limiter
- * Security: Protects against:
- * - API abuse (excessive requests)
- * - Resource exhaustion
- * - Denial of service (unintentional)
- */
-import { TIMEOUT_CONFIG } from '../constants.js';
-/**
- * Token Bucket Rate Limiter
- *
- * Uses the token bucket algorithm which allows bursts while maintaining
- * a steady average rate. Tokens are added at a constant rate, and requests
- * consume tokens.
- *
- * @example
- * ```typescript
- * const limiter = new RateLimiter({
- *   maxRequests: 60,
- *   windowMs: 60000, // 60 requests per minute
- * });
- *
- * const result = limiter.tryAcquire();
- * if (result.allowed) {
- *   // Make API call
- * } else {
- *   console.log(`Rate limit exceeded. Try again in ${result.resetIn}ms`);
- * }
- * ```
- */
-export class RateLimiter {
-    tokens;
-    maxTokens;
-    refillRate; // tokens per millisecond
-    lastRefill;
-    config;
-    constructor(config) {
-        // INPUT VALIDATION FIX: Prevent division by zero and invalid configurations
-        if (config.windowMs <= 0) {
-            throw new Error(`windowMs must be positive, got ${config.windowMs}`);
-        }
-        if (config.maxRequests <= 0) {
-            throw new Error(`maxRequests must be positive, got ${config.maxRequests}`);
-        }
-        // CRITICAL FIX: Prevent extreme values that cause floating point precision loss
-        if (config.windowMs > Number.MAX_SAFE_INTEGER / 1000) {
-            throw new Error(`windowMs too large: ${config.windowMs} (max: ${Number.MAX_SAFE_INTEGER / 1000})`);
-        }
-        if (config.maxRequests > Number.MAX_SAFE_INTEGER / 2) {
-            throw new Error(`maxRequests too large: ${config.maxRequests} (max: ${Number.MAX_SAFE_INTEGER / 2})`);
-        }
-        this.config = config;
-        this.maxTokens = config.maxRequests + (config.burstAllowance || 0);
-        this.tokens = this.maxTokens;
-        // CRITICAL FIX: Calculate refill rate with precision check
-        const rate = config.maxRequests / config.windowMs;
-        if (!Number.isFinite(rate) || rate <= 0) {
-            throw new Error(`Invalid refill rate: ${rate} (requests: ${config.maxRequests}, window: ${config.windowMs})`);
-        }
-        this.refillRate = rate;
-        this.lastRefill = Date.now();
-    }
-    /**
-     * Refill tokens based on elapsed time
-     */
-    refill() {
-        const now = Date.now();
-        const elapsed = now - this.lastRefill;
-        // Calculate tokens to add
-        const tokensToAdd = elapsed * this.refillRate;
-        // Add tokens, capped at max
-        this.tokens = Math.min(this.maxTokens, this.tokens + tokensToAdd);
-        this.lastRefill = now;
-    }
-    /**
-     * Try to acquire a token (allow a request)
-     *
-     * @param cost - Number of tokens to consume (default: 1)
-     * @returns Rate limit result indicating if request is allowed
-     */
-    tryAcquire(cost = 1) {
-        this.refill();
-        const allowed = this.tokens >= cost;
-        if (allowed) {
-            this.tokens -= cost;
-        }
-        // Calculate reset time (time until 1 token is available)
-        const resetIn = allowed ? 0 : Math.ceil((cost - this.tokens) / this.refillRate);
-        return {
-            allowed,
-            remaining: Math.floor(this.tokens),
-            resetIn,
-            limit: this.config.maxRequests,
-        };
-    }
-    /**
-     * Get current state without consuming a token
-     */
-    getState() {
-        this.refill();
-        return {
-            allowed: this.tokens >= 1,
-            remaining: Math.floor(this.tokens),
-            resetIn: this.tokens < 1 ? Math.ceil((1 - this.tokens) / this.refillRate) : 0,
-            limit: this.config.maxRequests,
-        };
-    }
-    /**
-     * Reset the rate limiter (clear all tokens)
-     */
-    reset() {
-        this.tokens = this.maxTokens;
-        this.lastRefill = Date.now();
-    }
-}
-/**
- * Multi-tier Rate Limiter
- *
- * Enforces multiple rate limits simultaneously (e.g., per-second, per-minute, per-hour)
- * Request is only allowed if ALL tiers allow it
- *
- * @example
- * ```typescript
- * const limiter = new MultiTierRateLimiter([
- *   { maxRequests: 10, windowMs: 1000 },   // 10/second
- *   { maxRequests: 100, windowMs: 60000 }, // 100/minute
- * ]);
- * ```
- */
-export class MultiTierRateLimiter {
-    limiters;
-    constructor(configs) {
-        this.limiters = configs.map(config => new RateLimiter(config));
-    }
-    /**
-     * Try to acquire across all tiers
-     * Request is only allowed if ALL tiers allow it
-     */
-    tryAcquire(cost = 1) {
-        // Check all tiers first (dry run)
-        const results = this.limiters.map(limiter => limiter.getState());
-        // If any tier would block, return the most restrictive result
-        const blocked = results.find(r => !r.allowed || r.remaining < cost);
-        if (blocked) {
-            return {
-                allowed: false,
-                remaining: blocked.remaining,
-                resetIn: blocked.resetIn,
-                limit: blocked.limit,
-            };
-        }
-        // All tiers allow it - actually consume tokens
-        const actualResults = this.limiters.map(limiter => limiter.tryAcquire(cost));
-        // Return the most restrictive successful result
-        return actualResults.reduce((mostRestrictive, current) => {
-            return current.remaining < mostRestrictive.remaining ? current : mostRestrictive;
-        });
-    }
-    /**
-     * Get current state (most restrictive tier)
-     */
-    getState() {
-        const results = this.limiters.map(limiter => limiter.getState());
-        // Return the most restrictive state
-        return results.reduce((mostRestrictive, current) => {
-            if (!current.allowed)
-                return current;
-            if (!mostRestrictive.allowed)
-                return mostRestrictive;
-            return current.remaining < mostRestrictive.remaining ? current : mostRestrictive;
-        });
-    }
-    /**
-     * Reset all tiers
-     */
-    reset() {
-        this.limiters.forEach(limiter => limiter.reset());
-    }
-}
-/**
- * Keyed Rate Limiter
- *
- * Maintains separate rate limits for different keys (e.g., per-user, per-IP)
- * Automatically cleans up old entries to prevent memory leaks
- *
- * @example
- * ```typescript
- * const limiter = new KeyedRateLimiter({
- *   maxRequests: 100,
- *   windowMs: 60000,
- * });
- *
- * // Different limits for different users
- * const result = limiter.tryAcquire('user-123');
- * ```
- */
-export class KeyedRateLimiter {
-    limiters;
-    config;
-    cleanupTimer = null;
-    maxKeys;
-    constructor(config, maxKeys = 10000) {
-        this.config = config;
-        this.limiters = new Map();
-        this.maxKeys = maxKeys;
-        // Cleanup old entries periodically to prevent memory leaks
-        this.cleanupTimer = setInterval(() => {
-            this.cleanup();
-        }, TIMEOUT_CONFIG.CONTEXT_CLEANUP_INTERVAL);
-        // Don't keep process alive
-        this.cleanupTimer.unref();
-    }
-    /**
-     * Get or create a rate limiter for the given key
-     */
-    getLimiter(key) {
-        let limiter = this.limiters.get(key);
-        if (!limiter) {
-            limiter = new RateLimiter(this.config);
-            this.limiters.set(key, limiter);
-            // Enforce max keys limit
-            if (this.limiters.size > this.maxKeys) {
-                // Remove the oldest entry (first in Map)
-                const firstKey = this.limiters.keys().next().value;
-                if (firstKey) {
-                    this.limiters.delete(firstKey);
-                }
-            }
-        }
-        return limiter;
-    }
-    /**
-     * Try to acquire for a specific key
-     */
-    tryAcquire(key, cost = 1) {
-        const limiter = this.getLimiter(key);
-        return limiter.tryAcquire(cost);
-    }
-    /**
-     * Get state for a specific key
-     */
-    getState(key) {
-        const limiter = this.getLimiter(key);
-        return limiter.getState();
-    }
-    /**
-     * Reset a specific key
-     */
-    reset(key) {
-        const limiter = this.limiters.get(key);
-        if (limiter) {
-            limiter.reset();
-        }
-    }
-    /**
-     * Clean up inactive limiters
-     */
-    cleanup() {
-        // Remove limiters that have full tokens (haven't been used recently)
-        const toDelete = [];
-        for (const [key, limiter] of this.limiters.entries()) {
-            const state = limiter.getState();
-            // If tokens are at max, this limiter hasn't been used recently
-            if (state.remaining >= this.config.maxRequests) {
-                toDelete.push(key);
-            }
-        }
-        for (const key of toDelete) {
-            this.limiters.delete(key);
-        }
-    }
-    /**
-     * Dispose of resources
-     */
-    dispose() {
-        if (this.cleanupTimer) {
-            clearInterval(this.cleanupTimer);
-            this.cleanupTimer = null;
-        }
-        this.limiters.clear();
-    }
-}
-/**
- * Default rate limit configurations for common use cases
- */
-export const DEFAULT_RATE_LIMITS = {
-    /**
-     * API calls - 60 requests per minute
-     */
-    API: {
-        maxRequests: 60,
-        windowMs: 60 * 1000,
-        burstAllowance: 10,
-    },
-    /**
-     * LLM API calls - 20 requests per minute (more expensive)
-     */
-    LLM_API: {
-        maxRequests: 20,
-        windowMs: 60 * 1000,
-        burstAllowance: 5,
-    },
-    /**
-     * User actions - 100 requests per minute
-     */
-    USER_ACTIONS: {
-        maxRequests: 100,
-        windowMs: 60 * 1000,
-        burstAllowance: 20,
-    },
-    /**
-     * File operations - 50 per minute
-     */
-    FILE_OPS: {
-        maxRequests: 50,
-        windowMs: 60 * 1000,
-    },
-};
-//# sourceMappingURL=rate-limiter.js.map

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

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

package/dist/utils/retry-helper.d.ts

@@ -1,81 +0,0 @@
-/**
- * Retry Helper - Exponential Backoff with Retry-After Support
- *
- * Implements robust retry logic for LLM API calls with:
- * - Exponential backoff
- * - Retry-After header support
- * - Configurable retry conditions
- * - Jitter to prevent thundering herd
- */
-/** Error with optional status/code for retryability checking */
-export interface RetryableError extends Error {
-    status?: number;
-    code?: string;
-    headers?: Record<string, string>;
-}
-export interface RetryOptions {
-    /** Maximum number of retry attempts (default: 3) */
-    maxRetries?: number;
-    /** Initial delay in milliseconds (default: 1000) */
-    initialDelay?: number;
-    /** Maximum delay in milliseconds (default: 8000) */
-    maxDelay?: number;
-    /** Backoff multiplier (default: 2) */
-    backoffMultiplier?: number;
-    /** HTTP status codes that should trigger retry (default: [429, 500, 502, 503, 504]) */
-    retryableStatusCodes?: number[];
-    /** Callback invoked before each retry attempt */
-    onRetry?: (attempt: number, error: RetryableError, delayMs: number) => void;
-    /** Whether to add jitter to backoff delays (default: true) */
-    addJitter?: boolean;
-}
-/**
- * Sleep for specified milliseconds
- * Exported for reuse across codebase to avoid duplicate Promise/setTimeout patterns
- */
-export declare function sleep(ms: number): Promise<void>;
-/**
- * Calculate exponential backoff delay with optional jitter (exported for reuse)
- *
- * @param attempt - Current retry attempt (0-indexed)
- * @param initialDelay - Initial delay in milliseconds
- * @param maxDelay - Maximum delay cap in milliseconds
- * @param addJitter - Whether to add random jitter (±25%)
- * @returns Calculated delay in milliseconds
- */
-export declare function calculateExponentialBackoff(attempt: number, initialDelay?: number, maxDelay?: number, addJitter?: boolean): number;
-/**
- * Retry a function with exponential backoff
- *
- * @param fn - Async function to retry
- * @param options - Retry configuration options
- * @returns Promise resolving to the function's return value
- * @throws Error if all retries are exhausted
- *
- * @example
- * ```typescript
- * const result = await retryWithBackoff(
- *   () => apiClient.call(),
- *   {
- *     maxRetries: 3,
- *     onRetry: (attempt, error, delay) => {
- *       console.log(`Retry ${attempt} after ${delay}ms: ${error.message}`);
- *     }
- *   }
- * );
- * ```
- */
-export declare function retryWithBackoff<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
-/**
- * Retry wrapper specifically for streaming operations
- *
- * NOTE: This function retries on any error, including errors that occur
- * after chunks have been yielded. This means consumers may receive
- * duplicate chunks if a retry occurs mid-stream. For scenarios where
- * duplicate chunks are unacceptable, handle retries at a higher level.
- *
- * @param fn - Async generator function to retry
- * @param options - Retry configuration options
- * @returns AsyncGenerator that retries on retryable errors
- */
-export declare function retryStreamWithBackoff<T>(fn: () => AsyncGenerator<T>, options?: RetryOptions): AsyncGenerator<T>;

package/dist/utils/retry-helper.js

@@ -1,244 +0,0 @@
-/**
- * Retry Helper - Exponential Backoff with Retry-After Support
- *
- * Implements robust retry logic for LLM API calls with:
- * - Exponential backoff
- * - Retry-After header support
- * - Configurable retry conditions
- * - Jitter to prevent thundering herd
- */
-const DEFAULT_OPTIONS = {
-    maxRetries: 3,
-    initialDelay: 1000,
-    maxDelay: 8000,
-    backoffMultiplier: 2,
-    retryableStatusCodes: [429, 500, 502, 503, 504],
-    addJitter: true,
-};
-/**
- * Check if an error is retryable based on status code
- */
-function isRetryableError(error, retryableStatusCodes) {
-    const retryable = error;
-    // Check for status code
-    if (typeof retryable?.status === 'number') {
-        return retryableStatusCodes.includes(retryable.status);
-    }
-    // Check for code property (some errors use 'code' instead of 'status')
-    if (typeof retryable?.code === 'string') {
-        // Network errors are retryable
-        if (['ECONNRESET', 'ETIMEDOUT', 'ENOTFOUND', 'ENETUNREACH'].includes(retryable.code)) {
-            return true;
-        }
-    }
-    // Check if error message indicates network issue
-    const message = retryable?.message?.toLowerCase() || '';
-    if (message.includes('network') || message.includes('timeout') || message.includes('econnreset')) {
-        return true;
-    }
-    // Abort errors are NOT retryable - they indicate intentional cancellation
-    // This includes user-initiated cancellations and upstream signal aborts
-    if (message.includes('abort') || message.includes('cancelled') || message.includes('canceled')) {
-        return false;
-    }
-    // Check for AbortError by name
-    if (retryable?.name === 'AbortError') {
-        return false;
-    }
-    return false;
-}
-/**
- * Extract Retry-After delay from error headers
- * Returns delay in milliseconds, or null if not present
- */
-function getRetryAfterDelay(error) {
-    const retryable = error;
-    const headers = retryable?.headers || {};
-    const retryAfter = headers['retry-after'] || headers['Retry-After'];
-    if (!retryAfter) {
-        return null;
-    }
-    // Retry-After can be either:
-    // 1. A number of seconds
-    // 2. An HTTP date
-    const parsed = parseInt(retryAfter, 10);
-    if (!isNaN(parsed)) {
-        return parsed * 1000; // Convert seconds to milliseconds
-    }
-    // Try parsing as date
-    const retryDate = new Date(retryAfter);
-    if (!isNaN(retryDate.getTime())) {
-        const now = Date.now();
-        const delay = retryDate.getTime() - now;
-        return delay > 0 ? delay : null;
-    }
-    return null;
-}
-/**
- * Calculate exponential backoff delay with optional jitter
- */
-function calculateBackoffDelay(attempt, initialDelay, backoffMultiplier, maxDelay, addJitter) {
-    // Calculate exponential delay: initialDelay * (multiplier ^ attempt)
-    let delay = initialDelay * Math.pow(backoffMultiplier, attempt);
-    // Cap at max delay
-    delay = Math.min(delay, maxDelay);
-    // Add jitter (random variation ±25%) to prevent thundering herd
-    if (addJitter) {
-        const jitterFactor = 0.75 + Math.random() * 0.5; // 0.75 to 1.25
-        delay = delay * jitterFactor;
-    }
-    return Math.floor(delay);
-}
-/**
- * Sleep for specified milliseconds
- * Exported for reuse across codebase to avoid duplicate Promise/setTimeout patterns
- */
-export function sleep(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
-}
-/**
- * Calculate exponential backoff delay with optional jitter (exported for reuse)
- *
- * @param attempt - Current retry attempt (0-indexed)
- * @param initialDelay - Initial delay in milliseconds
- * @param maxDelay - Maximum delay cap in milliseconds
- * @param addJitter - Whether to add random jitter (±25%)
- * @returns Calculated delay in milliseconds
- */
-export function calculateExponentialBackoff(attempt, initialDelay = 1000, maxDelay = 30000, addJitter = true) {
-    // Cap exponent to prevent integer overflow (2^30 ~= 1 billion ms)
-    const cappedExponent = Math.min(attempt, 30);
-    let delay = initialDelay * Math.pow(2, cappedExponent);
-    // Cap at max delay
-    delay = Math.min(delay, maxDelay);
-    // Add jitter (random variation ±25%) to prevent thundering herd
-    if (addJitter) {
-        const jitterFactor = 0.75 + Math.random() * 0.5; // 0.75 to 1.25
-        delay = delay * jitterFactor;
-    }
-    return Math.floor(delay);
-}
-/**
- * Retry a function with exponential backoff
- *
- * @param fn - Async function to retry
- * @param options - Retry configuration options
- * @returns Promise resolving to the function's return value
- * @throws Error if all retries are exhausted
- *
- * @example
- * ```typescript
- * const result = await retryWithBackoff(
- *   () => apiClient.call(),
- *   {
- *     maxRetries: 3,
- *     onRetry: (attempt, error, delay) => {
- *       console.log(`Retry ${attempt} after ${delay}ms: ${error.message}`);
- *     }
- *   }
- * );
- * ```
- */
-export async function retryWithBackoff(fn, options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
-    let lastError;
-    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
-        try {
-            // First attempt (attempt = 0) or retry attempt
-            return await fn();
-        }
-        catch (error) {
-            lastError = error;
-            // Check if we should retry
-            const shouldRetry = attempt < opts.maxRetries && isRetryableError(error, opts.retryableStatusCodes);
-            if (!shouldRetry) {
-                // Not retryable or exhausted retries
-                throw error;
-            }
-            // Calculate delay
-            let delay;
-            const retryAfterDelay = getRetryAfterDelay(error);
-            if (retryAfterDelay !== null) {
-                // Honor Retry-After header (cap at maxDelay)
-                delay = Math.min(retryAfterDelay, opts.maxDelay);
-            }
-            else {
-                // Use exponential backoff
-                delay = calculateBackoffDelay(attempt, opts.initialDelay, opts.backoffMultiplier, opts.maxDelay, opts.addJitter);
-            }
-            // Invoke callback if provided
-            if (options.onRetry) {
-                try {
-                    options.onRetry(attempt + 1, error, delay);
-                }
-                catch (callbackError) {
-                    // Don't let callback errors break retry flow
-                    console.warn('Retry callback error:', callbackError);
-                }
-            }
-            // Wait before retry
-            await sleep(delay);
-        }
-    }
-    // Should never reach here, but TypeScript needs it
-    throw lastError;
-}
-/**
- * Retry wrapper specifically for streaming operations
- *
- * NOTE: This function retries on any error, including errors that occur
- * after chunks have been yielded. This means consumers may receive
- * duplicate chunks if a retry occurs mid-stream. For scenarios where
- * duplicate chunks are unacceptable, handle retries at a higher level.
- *
- * @param fn - Async generator function to retry
- * @param options - Retry configuration options
- * @returns AsyncGenerator that retries on retryable errors
- */
-export async function* retryStreamWithBackoff(fn, options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
-    let lastError;
-    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
-        try {
-            // Try to get stream
-            const stream = fn();
-            // Yield all chunks - if first chunk succeeds, no more retries
-            for await (const chunk of stream) {
-                yield chunk;
-            }
-            // Stream completed successfully
-            return;
-        }
-        catch (error) {
-            lastError = error;
-            // Check if we should retry
-            const shouldRetry = attempt < opts.maxRetries && isRetryableError(error, opts.retryableStatusCodes);
-            if (!shouldRetry) {
-                throw error;
-            }
-            // Calculate delay (same logic as non-streaming)
-            let delay;
-            const retryAfterDelay = getRetryAfterDelay(error);
-            if (retryAfterDelay !== null) {
-                delay = Math.min(retryAfterDelay, opts.maxDelay);
-            }
-            else {
-                delay = calculateBackoffDelay(attempt, opts.initialDelay, opts.backoffMultiplier, opts.maxDelay, opts.addJitter);
-            }
-            // Invoke callback if provided
-            if (options.onRetry) {
-                try {
-                    options.onRetry(attempt + 1, error, delay);
-                }
-                catch (callbackError) {
-                    console.warn('Retry callback error:', callbackError);
-                }
-            }
-            // Wait before retry
-            await sleep(delay);
-        }
-    }
-    // Exhausted retries
-    throw lastError;
-}
-//# sourceMappingURL=retry-helper.js.map

package/dist/utils/retry-helper.js.map

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