/** Recovery-relevant error classes. Retry is only meaningful for `transient`. */
export type QueryErrorCategory = "auth" | "forbidden" | "notFound" | "validation" | "transient" | "unknown";
export type QueryErrorInfo = {
    category: QueryErrorCategory;
    /** HTTP status when one could be derived from the error, else `undefined`. */
    status?: number;
    /** `true` only when repeating the same request can plausibly resolve the cause. */
    retryable: boolean;
};
/**
 * Classify a query/API error into a recovery-relevant category. Status codes win; message keywords
 * are the fallback for transport layers that only surface a string (e.g. an SDK that throws `new
 * Error("Access token invalid")` with no status).
 */
export declare function classifyQueryError(error: unknown): QueryErrorInfo;
/** `true` when repeating the same request can plausibly resolve the error. */
export declare function isRetryableQueryError(error: unknown): boolean;