export type ErrorSeverity = "info" | "warning" | "error" | "critical";
export interface SophiaClawErrorOptions extends ErrorOptions {
    helpLink?: string;
    details?: Record<string, unknown>;
}
export type ErrorCode = "CONFIG_ERROR" | "INVALID_CONFIG" | "MISSING_CONFIG" | "CONFIG_PERMISSION" | "NETWORK_ERROR" | "CONNECTION_TIMEOUT" | "CONNECTION_REFUSED" | "DNS_RESOLUTION_FAILED" | "SSL_ERROR" | "RATE_LIMITED" | "AUTH_ERROR" | "INVALID_API_KEY" | "EXPIRED_TOKEN" | "INSUFFICIENT_PERMISSIONS" | "ACCOUNT_LOCKED" | "TWO_FACTOR_REQUIRED" | "VALIDATION_ERROR" | "INVALID_INPUT" | "MISSING_REQUIRED_FIELD" | "INVALID_FORMAT" | "OUT_OF_RANGE" | "PROVIDER_ERROR" | "PROVIDER_UNAVAILABLE" | "PROVIDER_RATE_LIMIT" | "PROVIDER_QUOTA_EXCEEDED" | "PROVIDER_AUTH_FAILED" | "CLI_ERROR" | "INVALID_ARGUMENT" | "MISSING_ARGUMENT" | "UNKNOWN_COMMAND" | "COMMAND_FAILED" | "PERMISSION_ERROR" | "FILE_PERMISSION" | "DIRECTORY_PERMISSION" | "NETWORK_PERMISSION" | "ADMIN_REQUIRED" | "SYSTEM_ERROR" | "OUT_OF_MEMORY" | "DISK_FULL" | "PROCESS_LIMIT" | "KERNEL_ERROR" | "UNKNOWN_ERROR" | "INTERNAL_ERROR" | "NOT_IMPLEMENTED" | "SERVICE_UNAVAILABLE" | "GATE_BLOCKED" | "CLAIM_CONFLICT" | "ESCALATION_REQUIRED" | "SESSION_NOT_FOUND" | "INTENT_NOT_FOUND" | "POLICY_LOAD_ERROR" | "DATABASE_ERROR";
export declare class SophiaClawError extends Error {
    readonly code: ErrorCode;
    readonly severity: ErrorSeverity;
    readonly userMessage: string;
    readonly recoverable: boolean;
    constructor(message: string, code: ErrorCode, severity: ErrorSeverity, userMessage: string, recoverable: boolean, options?: SophiaClawErrorOptions);
    readonly helpLink?: string;
    readonly details?: Record<string, unknown>;
}
export declare function createError(code: ErrorCode, severity: ErrorSeverity, userMessage: string, internalMessage?: string, options?: SophiaClawErrorOptions): SophiaClawError;