import { OrchestrationContext } from "../context/orchestration-context";
import { TaskFailureDetails } from "../failure-details";
/**
 * Retry context data that's provided to task retry handler implementations.
 *
 * @remarks
 * This context is passed to custom retry handlers to provide information about
 * the current retry state and allow making informed decisions about whether
 * to continue retrying.
 *
 * Retry handler code is an extension of the orchestrator code and must therefore
 * comply with all the determinism requirements of orchestrator code. The
 * {@link orchestrationContext} property can be used to check
 * {@link OrchestrationContext.isReplaying} to guard side-effects such as logging.
 *
 * @example
 * ```typescript
 * const retryHandler: RetryHandler = (context: RetryContext) => {
 *   // Guard side-effects with isReplaying
 *   if (!context.orchestrationContext.isReplaying) {
 *     console.log(`Retry attempt ${context.lastAttemptNumber}`);
 *   }
 *   // Don't retry after 5 attempts
 *   if (context.lastAttemptNumber >= 5) {
 *     return false;
 *   }
 *   // Don't retry if we've been retrying for more than 5 minutes
 *   if (context.totalRetryTimeInMilliseconds > 300000) {
 *     return false;
 *   }
 *   // Don't retry certain error types
 *   if (context.lastFailure.errorType === "ValidationError") {
 *     return false;
 *   }
 *   return true;
 * };
 * ```
 */
export interface RetryContext {
    /**
     * The orchestration context for the currently executing orchestration.
     *
     * @remarks
     * This is primarily useful for checking {@link OrchestrationContext.isReplaying}
     * to guard side-effects like logging or counter increments inside retry handlers,
     * since retry handler code runs as part of the orchestrator and is subject to replay.
     */
    readonly orchestrationContext: OrchestrationContext;
    /**
     * The previous retry attempt number.
     * This is 1 after the first failure, 2 after the second, etc.
     */
    readonly lastAttemptNumber: number;
    /**
     * The details of the previous task failure.
     * Contains the error type, message, and stack trace.
     */
    readonly lastFailure: TaskFailureDetails;
    /**
     * The total amount of time spent in the retry loop for the current task, in milliseconds.
     * This includes the time spent executing the task and waiting between retries.
     */
    readonly totalRetryTimeInMilliseconds: number;
}
/**
 * Creates a new RetryContext object.
 *
 * @param orchestrationContext - The orchestration context for the current execution
 * @param lastAttemptNumber - The previous retry attempt number
 * @param lastFailure - The details of the previous task failure
 * @param totalRetryTimeInMilliseconds - The total time spent retrying
 * @returns A RetryContext object
 */
export declare function createRetryContext(orchestrationContext: OrchestrationContext, lastAttemptNumber: number, lastFailure: TaskFailureDetails, totalRetryTimeInMilliseconds: number): RetryContext;