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

Package-level declarations

Types

@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.

DatasetExecutionSerializers

data class DatasetExecutionSerializers<Input, Output, InputLabel>(val serializeItem: (item: TrainSetItem<Input, InputLabel>) -> String, val serializeOutput: (output: Output) -> String)

Caller-supplied serializers that render dataset items and agent outputs to strings for persistence and logging. Lets the infrastructure record execution data without knowing the concrete Input/Output/InputLabel types.

ExecutionMetadata

@Serializable

data class ExecutionMetadata(val startedAt: String, val completedAt: String? = null, val completed: Boolean = false, val podName: String? = null, val spendLimit: JsonElement? = null, val retries: JsonElement? = null)

Metadata about the runtime environment and lifecycle of an experiment execution (training session or evaluation run).

ExperimentName

@Serializable

data class ExperimentName(val runId: String, val submissionId: String? = null, val optimizerName: String, val agentName: String, val groupName: String? = null)

Identity of an experiment run, used to name and group its persisted artifacts.

FailureKind

enum FailureKind : Enum<FailureKind>

High-level categorization of failures occurred during experiments:

KnownResolvedIds

object KnownResolvedIds

Resolved-ids the library itself references by value. Recognizers (which live in the consuming app) produce these when they detect the corresponding failure, and the library reads them — e.g. the retry executor emits a tailored WARN addendum when an exhausted retry carries GEN_AI_AGENT_SPAN_CLEANUP. Keeping them here, next to the failure taxonomy, keeps the WARN and the recognizer in sync.

TransiencyLevel

enum TransiencyLevel : Enum<TransiencyLevel>

Retry-policy input. Recognizers classify only what they can honestly determine from the exception; the retry strategy (e.g. exponential backoff with a generous cap) handles "how long a transient outage will last".

Properties

defaultExperimentsJson

val defaultExperimentsJson: Json

Canonical Json instance for serializing training and evaluation results to disk.

Functions

encodeToStringStripped

fun <T> Json.encodeToStringStripped(serializer: KSerializer<T>, value: T): String

Encodes value to a JSON string, stripping the class discriminator from all objects.

stripClassDiscriminator

fun JsonElement.stripClassDiscriminator(discriminator: String = "kind"): JsonElement

Recursively strips the class discriminator field from all JsonObject nodes.