koog-agents-optimization/ai.koog.agents.optimization.common.retries/FailedAttempt

FailedAttempt

@Serializable

data class FailedAttempt(val attemptIndex: Int, val failure: AnalyzedFailure, val elapsedTime: Duration, val consumption: LLMConsumptionOrNA, val delayBeforeAttempt: Duration)

A single failed attempt that preceded the final attempt of a retried operation.

Lives in AgentRunRecord.previousAttempts / PromptExecutionRecord.previousAttempts / DatasetItemEvaluation.previousAttempts. The list order matches execution order.

Constructors

FailedAttempt

constructor(attemptIndex: Int, failure: AnalyzedFailure, elapsedTime: Duration, consumption: LLMConsumptionOrNA, delayBeforeAttempt: Duration)

Properties

attemptIndex

val attemptIndex: Int

0-indexed position in the retry sequence. attemptIndex == 0 is the original attempt (whose failure triggered the first retry); attemptIndex == 1 is the first retry attempt that itself failed; and so on.

consumption

val consumption: LLMConsumptionOrNA

LLM consumption recorded for this attempt, or N/A when unavailable.

delayBeforeAttempt

@Serializable(with = PrettyRoundedDurationSerializer::class)

val delayBeforeAttempt: Duration

Wall-clock delay applied before this attempt started, per the retry policy. Duration.ZERO for the original attempt (attemptIndex == 0).

elapsedTime

@Serializable(with = PrettyRoundedDurationSerializer::class)

val elapsedTime: Duration

Wall-clock time this attempt itself took (excludes the delay before it).

failure

val failure: AnalyzedFailure

The classified failure this attempt ended with.