agents-core/ai.koog.agents.core.utils/SerializationUtils

SerializationUtils

Utility object for handling serialization of input data to JSON using Kotlin Serialization.

Functions

fun encodeDataToJsonElement(data: Any?, dataType: KType, json: Json? = null): JsonElement

Serializes the given data to a JsonElement using the specified data type. Throws SerializationException if serialization fails.

encodeDataToJsonElementOrDefault

fun encodeDataToJsonElementOrDefault(data: Any?, dataType: KType, json: Json? = null, default: () -> JsonElement? = null): JsonElement

Serializes the given data to a JsonElement using the specified data type. If serialization fails, falls back to a JsonPrimitive wrapping data.toString().

encodeDataToJsonElementOrNull

fun encodeDataToJsonElementOrNull(data: Any?, dataType: KType, json: Json? = null): JsonElement?

Serializes the given data to a JsonElement using the specified data type. Returns the serialized JsonElement if successful, or null if serialization fails.

encodeDataToString

fun encodeDataToString(data: Any?, dataType: KType, json: Json? = null): String

Serializes the given data to a string using the specified data type. Throws SerializationException if serialization fails.

encodeDataToStringOrDefault

fun encodeDataToStringOrDefault(data: Any?, dataType: KType, json: Json? = null, default: () -> String? = null): String

Serializes the given data to a string using the specified data type. If serialization fails, it falls back to data.toString().

encodeDataToStringOrNull

fun encodeDataToStringOrNull(data: Any?, dataType: KType, json: Json? = null): String?

Serializes the given data to a string using the specified data type. Returns the serialized string if successful, or null if serialization fails.

parseDataToJsonElementOrDefault

fun parseDataToJsonElementOrDefault(data: String, json: Json? = null, default: () -> JsonElement? = null): JsonElement

Attempts to parse the given string into a JsonElement. If the parsing fails due to a SerializationException, it falls back to returning a JsonPrimitive wrapping the original string.