/**
 * SDK Error Utilities
 *
 * Simple utilities for error handling based on HTTP status codes.
 * Uses the AI SDK's error types which include statusCode property.
 */
/**
 * Error type with statusCode property
 */
export type HttpError = Error & {
    statusCode: number;
};
/**
 * HTTP status codes that should trigger automatic retry
 */
export declare const RETRYABLE_STATUS_CODES: Set<number>;
/**
 * Creates an Error with a statusCode property
 */
export declare function createHttpError(message: string, statusCode: number): HttpError;
/**
 * Creates an authentication error (401)
 */
export declare function createAuthError(message?: string): HttpError;
/**
 * Creates a forbidden error (403)
 */
export declare function createForbiddenError(message?: string): HttpError;
/**
 * Creates a payment required error (402)
 */
export declare function createPaymentRequiredError(message?: string): HttpError;
/**
 * Creates a server error (500 by default, or custom 5xx)
 */
export declare function createServerError(message?: string, statusCode?: number): HttpError;
/**
 * Creates a network error (503 - service unavailable)
 * Used for connection failures, DNS errors, timeouts, etc.
 */
export declare function createNetworkError(message?: string): HttpError;
/**
 * Checks if an HTTP status code is retryable
 */
export declare function isRetryableStatusCode(statusCode: number | undefined): boolean;
/**
 * Extracts the statusCode from an error if available.
 * Checks both 'statusCode' (our convention) and 'status' (AI SDK's APICallError convention).
 */
export declare function getErrorStatusCode(error: unknown): number | undefined;
/**
 * Sanitizes error messages for display
 * Removes sensitive information and formats for user consumption
 */
export declare function sanitizeErrorMessage(error: unknown): string;
