import { SophiaClawError, type ErrorCode } from "./base.js";
/**
 * Format an error for user display
 *
 * Returns a user-friendly message with recovery suggestions if available
 */
export declare function formatErrorForUser(error: unknown): string;
/**
 * Format an error for logging/debugging
 *
 * Includes technical details like stack trace and error code
 */
export declare function formatErrorForLog(error: unknown): string;
/**
 * Get recovery suggestions for an error
 */
export declare function getErrorRecoverySuggestions(error: unknown): string[];
/**
 * Check if an error is recoverable
 */
export declare function isErrorRecoverable(error: unknown): boolean;
/**
 * Check if an error should be shown to the user vs logged internally
 */
export declare function shouldShowToUser(error: unknown): boolean;
/**
 * Type guard for SophiaClawError
 */
export declare function isSophiaClawError(error: unknown): error is SophiaClawError;
/**
 * Convert any error to a SophiaClawError if possible
 */
export declare function toSophiaClawError(error: unknown, defaultCode?: ErrorCode, defaultSeverity?: "info" | "warning" | "error" | "critical"): SophiaClawError;
/**
 * Create a user-friendly error report
 */
export declare function createErrorReport(error: unknown): {
    userMessage: string;
    technicalMessage: string;
    recoverySuggestions: string[];
    recoverable: boolean;
};