export interface ToolErrorConfig<T = unknown> {
    maxRetries?: number;
    retryDelayMs?: number;
    fallbackValue?: T;
    onError?: (error: Error, attempt: number) => Promise<void>;
    shouldRetry?: (error: Error) => boolean;
}
export interface ToolResult<T = unknown> {
    success: boolean;
    data?: T;
    error?: Error;
    attempts: number;
    totalTimeMs: number;
}
export declare function withErrorHandling<T, Args extends unknown[], R = Awaited<T>>(fn: (...args: Args) => T, config?: ToolErrorConfig<R>): (...args: Args) => Promise<ToolResult<R>>;
export declare function executeWithRetry<T>(fn: () => Promise<T>, config?: {
    maxRetries?: number;
    delayMs?: number;
    backoffMultiplier?: number;
    maxDelayMs?: number;
    onRetry?: (error: Error, attempt: number) => void;
}): Promise<T>;
export type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
export declare function createCircuitBreaker<T, Args extends unknown[]>(fn: (...args: Args) => Promise<T>, config?: {
    failureThreshold?: number;
    resetTimeoutMs?: number;
}): (...args: Args) => Promise<T>;
export declare function isPermanentError(error: Error): boolean;
export declare class CircuitOpenError extends Error {
    constructor(message: string);
}
export declare function isCircuitOpenError(error: unknown): error is CircuitOpenError;
export declare class ToolTimeoutError extends Error {
    constructor(message?: string);
}
export declare function withTimeout<T>(fn: () => Promise<T>, timeoutMs: number, error?: Error): Promise<T>;