/** Error categories for CLI subprocess failures. */
export type ErrorCategory = "retryable" | "fatal" | "context_overflow" | "timeout" | "aborted";
/**
 * Test whether an error message indicates a rate-limit or auth failure
 * that could be resolved by rotating to a different API key.
 */
export declare function isAuthRotatableError(message: string): boolean;
/**
 * Classify an error message string into an actionable category.
 *
 * Uses first-match-wins semantics across ordered pattern arrays:
 * 1. Retryable patterns checked first
 * 2. Context overflow patterns checked second
 * 3. Fatal auth patterns checked third
 * 4. Default: "fatal" for unmatched messages
 *
 * Case-insensitive matching throughout.
 */
export declare function classifyError(message: string): ErrorCategory;