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

Package-level declarations

Types

@Serializable

data class ConsumptionWithRetries(val totalConsumptionWithRetries: LLMConsumptionOrNA = LLMConsumptionOrNA.NA, val totalConsumptionInRetries: LLMConsumptionOrNA = LLMConsumptionOrNA.NA)

Retries-aware consumption totals, attached to a consumption metric when any retry fired below.

ElapsedWithRetries

@Serializable

data class ElapsedWithRetries(val totalElapsedTimeWithRetries: Duration = Duration.ZERO, val totalElapsedTimeInRetries: Duration = Duration.ZERO)

Retries-aware elapsed-time totals, attached to an elapsed-time metric when any retry fired below.

FailureKindEntry

@Serializable

data class FailureKindEntry(val count: Int = 0, val ratioOfFinished: Ratio = Ratio.ZERO, val ratioOfAllFinal: Ratio = Ratio.ZERO, val byId: Map<String, Int> = emptyMap())

Per-kind breakdown of final failures: count, ratios against the population, per-resolvedId frequencies. Shared between training (FailureBreakdownMetric) and eval (FailuresSummary) so the two sides expose the same JSON shape under finalFailures.byKind.

FinalFailures

@Serializable

data class FinalFailures(val total: Int = 0, val byKind: Map<FailureKind, FailureKindEntry> = emptyMap())

The two sections of a failure breakdown, shared between training (FailureBreakdownMetric) and eval (FailuresSummary) so both sides emit the same JSON. FinalFailures reports the run's final outcomes; TransientEncounters reports transient blips seen across all attempts. Each section's fields default out (@EncodeDefault(NEVER)), so an empty section serializes to {} and an untouched breakdown stays clean.

TransientEncounters

@Serializable

data class TransientEncounters(val total: Int = 0, val byId: Map<String, Int> = emptyMap())

Transient-failure events seen across all attempts — the environment's noise profile. Counts events: a leaf that retried several times contributes several events here. The per-leaf retry outcome (resolved or unresolved, and at which attempt) lives in retryStats.