koog-agents-optimization/ai.koog.agents.optimization.common/AnalyzedFailure

AnalyzedFailure

@Serializable

data class AnalyzedFailure(val resolvedId: String, val description: String, val kind: FailureKind, val transiency: TransiencyLevel, val originalStackTrace: String)

A failure that has been recognized and classified by the experiment infrastructure.

Carries a stable resolvedId (used to group identical failures across runs), a human-readable description, a FailureKind bucket, and a TransiencyLevel consumed by the retry policy. The recognizers that produce these live in the consuming application — the library only owns the vocabulary.

Constructors

AnalyzedFailure

constructor(resolvedId: String, description: String, kind: FailureKind, transiency: TransiencyLevel, exception: Exception)

Builds an AnalyzedFailure from an exception, capturing its stack trace into originalStackTrace.

constructor(resolvedId: String, description: String, kind: FailureKind, transiency: TransiencyLevel, originalStackTrace: String)

Properties

description

val description: String

Human-readable description of what went wrong.

kind

val kind: FailureKind

High-level FailureKind bucket this failure belongs to.

originalStackTrace

val originalStackTrace: String

Stack trace of the originating exception, captured as a string for record-keeping.

resolvedId

val resolvedId: String

Stable identifier used to group identical failures across runs.

transiency

val transiency: TransiencyLevel

Transiency assignment consumed by the retry policy. Recognizers set this honestly based on what the exception alone can reveal — duration variance ("a transient outage can last seconds or hours") is handled by the retry strategy, not by the enum.