/**
 * Comprehensive error handling and user feedback utilities
 * Provides consistent error handling across the Claude Code integration
 */
export interface ErrorContext {
    operation: string;
    component?: string;
    userId?: string;
    timestamp?: Date;
    metadata?: Record<string, any>;
}
export interface UserFeedback {
    level: 'error' | 'warning' | 'info' | 'success';
    title: string;
    message: string;
    details?: string[];
    suggestions?: string[];
    helpUrl?: string;
}
export declare class ClaudeCodeError extends Error {
    readonly code: string;
    readonly context?: ErrorContext;
    readonly originalError?: Error;
    readonly recoverable: boolean;
    constructor(message: string, code: string, context?: ErrorContext, originalError?: Error, recoverable?: boolean);
}
/**
 * Enhanced error handler for Claude Code integration operations
 */
export declare class ErrorHandler {
    private static logger;
    /**
     * Handle errors with comprehensive logging and user feedback
     */
    static handleError(error: Error | ClaudeCodeError, context: ErrorContext, provideFeedback?: boolean): Promise<UserFeedback>;
    /**
     * Categorize error and generate appropriate user feedback
     */
    private static categorizeError;
    /**
     * Handle ClaudeCodeError instances
     */
    private static handleClaudeCodeError;
    /**
     * Check if error is permission-related
     */
    private static isPermissionError;
    /**
     * Check if error is network-related
     */
    private static isNetworkError;
    /**
     * Check if error is file system-related
     */
    private static isFileSystemError;
    /**
     * Check if error is configuration-related
     */
    private static isConfigurationError;
    /**
     * Create permission error feedback
     */
    private static createPermissionErrorFeedback;
    /**
     * Create network error feedback
     */
    private static createNetworkErrorFeedback;
    /**
     * Create file system error feedback
     */
    private static createFileSystemErrorFeedback;
    /**
     * Create configuration error feedback
     */
    private static createConfigurationErrorFeedback;
    /**
     * Create generic error feedback
     */
    private static createGenericErrorFeedback;
    /**
     * Display user feedback to console
     */
    private static displayFeedback;
    /**
     * Generate unique error ID for tracking
     */
    private static generateErrorId;
    /**
     * Wrap async operations with error handling
     */
    static wrapOperation<T>(operation: () => Promise<T>, context: ErrorContext, provideFeedback?: boolean): Promise<T>;
    /**
     * Create a ClaudeCodeError with proper context
     */
    static createError(message: string, code: string, context?: ErrorContext, originalError?: Error, recoverable?: boolean): ClaudeCodeError;
}
export default ErrorHandler;
//# sourceMappingURL=error-handler.d.ts.map