@defai.digital/ax-cli 4.4.7 → 4.4.10

package/dist/utils/api-error.d.ts

@@ -1,61 +0,0 @@
-/**
- * API Error Classes - Structured Error Handling for LLM API
- *
- * Preserves full error context including status codes, headers, and original stack traces
- * for better diagnostics and retry decision making.
- */
-/**
- * Structured error for LLM API failures
- * Preserves all diagnostic information from the original error
- */
-export declare class LLMAPIError extends Error {
-    readonly originalError: any;
-    readonly model: string;
-    readonly statusCode?: number | undefined;
-    readonly headers?: Record<string, string> | undefined;
-    readonly requestId?: string | undefined;
-    readonly name = "LLMAPIError";
-    readonly timestamp: Date;
-    constructor(message: string, originalError: any, model: string, statusCode?: number | undefined, headers?: Record<string, string> | undefined, requestId?: string | undefined);
-    /**
-     * Check if this error is retryable based on status code
-     */
-    get isRetryable(): boolean;
-    /**
-     * Check if this is a network/connection error
-     */
-    get isNetworkError(): boolean;
-    /**
-     * Check if this is a rate limit error
-     */
-    get isRateLimitError(): boolean;
-    /**
-     * Check if this is an authentication error
-     */
-    get isAuthError(): boolean;
-    /**
-     * Check if this is a client error (4xx, non-retryable)
-     */
-    get isClientError(): boolean;
-    /**
-     * Get Retry-After delay in seconds, or null if not present
-     */
-    get retryAfterSeconds(): number | null;
-    /**
-     * Get a user-friendly error message
-     */
-    get userMessage(): string;
-    /**
-     * Convert error to JSON for logging/serialization
-     */
-    toJSON(): Record<string, any>;
-    /**
-     * Convert error to string for display
-     */
-    toString(): string;
-}
-/**
- * Create an LLMAPIError from any error object
- * Extracts status, headers, and other metadata automatically
- */
-export declare function createLLMAPIError(error: any, model: string, context?: string): LLMAPIError;

package/dist/utils/api-error.js

@@ -1,176 +0,0 @@
-/**
- * API Error Classes - Structured Error Handling for LLM API
- *
- * Preserves full error context including status codes, headers, and original stack traces
- * for better diagnostics and retry decision making.
- */
-/**
- * Structured error for LLM API failures
- * Preserves all diagnostic information from the original error
- */
-export class LLMAPIError extends Error {
-    originalError;
-    model;
-    statusCode;
-    headers;
-    requestId;
-    name = 'LLMAPIError';
-    timestamp;
-    constructor(message, originalError, model, statusCode, headers, requestId) {
-        super(message);
-        this.originalError = originalError;
-        this.model = model;
-        this.statusCode = statusCode;
-        this.headers = headers;
-        this.requestId = requestId;
-        this.timestamp = new Date();
-        // Preserve original stack trace if available
-        if (originalError?.stack) {
-            this.stack = `${this.stack}\n\nCaused by:\n${originalError.stack}`;
-        }
-        // Ensure proper prototype chain for instanceof checks
-        Object.setPrototypeOf(this, LLMAPIError.prototype);
-    }
-    /**
-     * Check if this error is retryable based on status code
-     */
-    get isRetryable() {
-        if (!this.statusCode) {
-            // Network errors (no status code) are retryable
-            return this.isNetworkError;
-        }
-        // Retry on server errors and rate limits
-        return [429, 500, 502, 503, 504].includes(this.statusCode);
-    }
-    /**
-     * Check if this is a network/connection error
-     */
-    get isNetworkError() {
-        const code = this.originalError?.code;
-        if (typeof code === 'string') {
-            return ['ECONNRESET', 'ETIMEDOUT', 'ENOTFOUND', 'ENETUNREACH', 'ECONNREFUSED'].includes(code);
-        }
-        const message = this.originalError?.message?.toLowerCase() || '';
-        return message.includes('network') || message.includes('timeout') || message.includes('fetch failed');
-    }
-    /**
-     * Check if this is a rate limit error
-     */
-    get isRateLimitError() {
-        return this.statusCode === 429;
-    }
-    /**
-     * Check if this is an authentication error
-     */
-    get isAuthError() {
-        return this.statusCode === 401 || this.statusCode === 403;
-    }
-    /**
-     * Check if this is a client error (4xx, non-retryable)
-     */
-    get isClientError() {
-        return this.statusCode !== undefined && this.statusCode >= 400 && this.statusCode < 500 && !this.isRateLimitError;
-    }
-    /**
-     * Get Retry-After delay in seconds, or null if not present
-     */
-    get retryAfterSeconds() {
-        if (!this.headers) {
-            return null;
-        }
-        const retryAfter = this.headers['retry-after'] || this.headers['Retry-After'];
-        if (!retryAfter) {
-            return null;
-        }
-        // Retry-After can be either a number of seconds or an HTTP date
-        const parsed = parseInt(retryAfter, 10);
-        if (!isNaN(parsed)) {
-            return parsed;
-        }
-        // Try parsing as date
-        const retryDate = new Date(retryAfter);
-        if (!isNaN(retryDate.getTime())) {
-            const now = Date.now();
-            const delayMs = retryDate.getTime() - now;
-            return delayMs > 0 ? Math.ceil(delayMs / 1000) : null;
-        }
-        return null;
-    }
-    /**
-     * Get a user-friendly error message
-     */
-    get userMessage() {
-        if (this.isRateLimitError) {
-            const retryAfter = this.retryAfterSeconds;
-            if (retryAfter) {
-                return `Rate limit exceeded. Please retry in ${retryAfter} seconds.`;
-            }
-            return 'Rate limit exceeded. Please try again in a few moments.';
-        }
-        if (this.isAuthError) {
-            return 'Authentication failed. Please check your API key and try again.';
-        }
-        if (this.isNetworkError) {
-            return 'Network connection failed. Please check your internet connection and try again.';
-        }
-        if (this.statusCode && this.statusCode >= 500) {
-            return 'The AI service is temporarily unavailable. Please try again in a few moments.';
-        }
-        // Default to the message
-        return this.message;
-    }
-    /**
-     * Convert error to JSON for logging/serialization
-     */
-    toJSON() {
-        return {
-            name: this.name,
-            message: this.message,
-            model: this.model,
-            statusCode: this.statusCode,
-            headers: this.headers,
-            requestId: this.requestId,
-            timestamp: this.timestamp.toISOString(),
-            isRetryable: this.isRetryable,
-            isRateLimitError: this.isRateLimitError,
-            isAuthError: this.isAuthError,
-            isNetworkError: this.isNetworkError,
-            retryAfterSeconds: this.retryAfterSeconds,
-            originalError: {
-                name: this.originalError?.name,
-                message: this.originalError?.message,
-                code: this.originalError?.code,
-                status: this.originalError?.status,
-            }
-        };
-    }
-    /**
-     * Convert error to string for display
-     */
-    toString() {
-        let str = `${this.name}: ${this.message}`;
-        if (this.statusCode) {
-            str += ` (HTTP ${this.statusCode})`;
-        }
-        if (this.requestId) {
-            str += ` [Request ID: ${this.requestId}]`;
-        }
-        return str;
-    }
-}
-/**
- * Create an LLMAPIError from any error object
- * Extracts status, headers, and other metadata automatically
- */
-export function createLLMAPIError(error, model, context) {
-    // Extract metadata from error
-    const statusCode = error?.status || error?.response?.status;
-    const headers = error?.headers || error?.response?.headers;
-    const requestId = headers?.['x-request-id'] || headers?.['X-Request-Id'];
-    // Build message
-    const contextPrefix = context ? `${context}: ` : '';
-    const errorMessage = error?.message || error?.error?.message || 'Unknown error';
-    const message = `${contextPrefix}${errorMessage}`;
-    return new LLMAPIError(message, error, model, statusCode, headers, requestId);
-}
-//# sourceMappingURL=api-error.js.map

package/dist/utils/api-error.js.map

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

package/dist/utils/audit-logger.d.ts

@@ -1,206 +0,0 @@
-/**
- * Basic Audit Logger (Free Tier)
- *
- * Provides simple JSON logging for security events.
- *
- * Free Tier Features:
- * ✅ Simple JSON logging to file
- * ✅ 30-day retention (auto-cleanup)
- * ✅ Basic event tracking
- * ✅ Lightweight (no encryption, no hash chains)
- *
- * Enterprise features (requires @ax-cli/enterprise):
- * - Compliance reports (SOC2, HIPAA, PCI-DSS)
- * - Tamper-proof encrypted logs with hash chains
- * - Real-time dashboards
- * - Custom retention (1yr, 7yr, forever)
- * - Incident response workflows
- * - Anomaly detection
- *
- * Security: CVSS 6.1 (Medium Priority)
- */
-/**
- * Security event severity levels
- */
-export declare enum AuditSeverity {
-    INFO = "INFO",
-    WARNING = "WARNING",
-    ERROR = "ERROR",
-    CRITICAL = "CRITICAL"
-}
-/**
- * Security event categories
- */
-export declare enum AuditCategory {
-    AUTHENTICATION = "AUTHENTICATION",
-    AUTHORIZATION = "AUTHORIZATION",
-    DATA_ACCESS = "DATA_ACCESS",
-    DATA_MODIFICATION = "DATA_MODIFICATION",
-    COMMAND_EXECUTION = "COMMAND_EXECUTION",
-    API_CALL = "API_CALL",
-    RATE_LIMIT = "RATE_LIMIT",
-    INPUT_VALIDATION = "INPUT_VALIDATION",
-    ENCRYPTION = "ENCRYPTION",
-    MCP_OPERATION = "MCP_OPERATION",
-    FILE_OPERATION = "FILE_OPERATION",
-    SYSTEM_EVENT = "SYSTEM_EVENT"
-}
-/**
- * Audit event structure (basic version)
- */
-export interface AuditEvent {
-    /**
-     * Unique event ID
-     */
-    id: string;
-    /**
-     * Event timestamp (ISO 8601)
-     */
-    timestamp: string;
-    /**
-     * Event severity
-     */
-    severity: AuditSeverity;
-    /**
-     * Event category
-     */
-    category: AuditCategory;
-    /**
-     * Event action (e.g., "login", "file_read", "api_call")
-     */
-    action: string;
-    /**
-     * User or actor performing the action
-     */
-    actor?: string;
-    /**
-     * Resource being accessed/modified
-     */
-    resource?: string;
-    /**
-     * Event outcome (success/failure)
-     */
-    outcome: 'success' | 'failure';
-    /**
-     * Additional event details
-     */
-    details?: Record<string, unknown>;
-    /**
-     * Error message (if outcome is failure)
-     */
-    error?: string;
-    /**
-     * Source IP address (if applicable)
-     */
-    sourceIp?: string;
-}
-/**
- * Audit log configuration (basic version)
- */
-export interface AuditLogConfig {
-    /**
-     * Directory to store audit logs
-     */
-    logDirectory?: string;
-    /**
-     * Log retention period in days (max 30 days in free tier)
-     */
-    retentionDays?: number;
-    /**
-     * Maximum log file size in bytes (default: 10MB)
-     */
-    maxFileSize?: number;
-}
-/**
- * Basic Audit Logger (Free Tier)
- *
- * Simple JSON logging for security events.
- *
- * @example
- * ```typescript
- * const logger = AuditLogger.getInstance();
- *
- * // Log a security event
- * logger.log({
- *   severity: AuditSeverity.WARNING,
- *   category: AuditCategory.RATE_LIMIT,
- *   action: 'rate_limit_exceeded',
- *   actor: 'user-123',
- *   outcome: 'failure',
- *   details: { limit: 20, attempts: 25 },
- * });
- * ```
- */
-export declare class AuditLogger {
-    private static instance;
-    private config;
-    private currentLogFile;
-    private eventCount;
-    private constructor();
-    /**
-     * Get singleton instance
-     */
-    static getInstance(config?: AuditLogConfig): AuditLogger;
-    /**
-     * Reset singleton (for testing)
-     */
-    static resetInstance(): void;
-    /**
-     * Log an audit event (basic version - no hash chains)
-     */
-    log(event: Omit<AuditEvent, 'id' | 'timestamp'>): void;
-    /**
-     * Log critical security event (convenience method)
-     */
-    logCritical(event: Omit<AuditEvent, 'id' | 'timestamp' | 'severity'>): void;
-    /**
-     * Log warning event (convenience method)
-     */
-    logWarning(event: Omit<AuditEvent, 'id' | 'timestamp' | 'severity'>): void;
-    /**
-     * Log error event (convenience method)
-     */
-    logError(event: Omit<AuditEvent, 'id' | 'timestamp' | 'severity'>): void;
-    /**
-     * Log info event (convenience method)
-     */
-    logInfo(event: Omit<AuditEvent, 'id' | 'timestamp' | 'severity'>): void;
-    /**
-     * Get audit statistics
-     */
-    getStats(): {
-        totalEvents: number;
-        logDirectory: string;
-        currentLogFile: string;
-        retentionDays: number;
-    };
-    /**
-     * Generate unique event ID
-     */
-    private generateEventId;
-    /**
-     * Write event to log file
-     * Gracefully handles permission errors to prevent crashes
-     */
-    private writeEvent;
-    /**
-     * Get current log file path
-     */
-    private getCurrentLogFile;
-    /**
-     * Check if log file needs rotation
-     */
-    private checkLogRotation;
-    /**
-     * Rotate log file
-     */
-    private rotateLogFile;
-    /**
-     * Clean up old log files (30-day retention in free tier)
-     */
-    private cleanupOldLogs;
-}
-/**
- * Get audit logger singleton
- */
-export declare function getAuditLogger(config?: AuditLogConfig): AuditLogger;