agents-features-snapshot/ai.koog.agents.snapshot.feature/AgentCheckpointData

AgentCheckpointData

data class AgentCheckpointData(val checkpointId: String, val createdAt: Instant, val nodePath: String, val lastInput: JSONElement? = null, val lastOutput: JSONElement? = null, val messageHistory: List<Message>, val version: Long, val properties: JSONObject? = null)(source)

Represents the checkpoint data for an agent's state during a session.

Constructors

AgentCheckpointData

constructor(checkpointId: String, createdAt: Instant, nodePath: String, lastInput: JSONElement? = null, lastOutput: JSONElement? = null, messageHistory: List<Message>, version: Long, properties: JSONObject? = null)

constructor(checkpointId: String, createdAt: Instant, nodePath: String, lastInput: JsonElement? = null, lastOutput: JsonElement? = null, messageHistory: List<Message>, version: Long, properties: JsonObject? = null)

Constructs an instance of the class with the specified parameters. This constructor is marked as deprecated and may be removed in the future.

Properties

val checkpointId: String

The unique identifier of the checkpoint. This allows tracking and restoring the agent's session to a specific state.

val createdAt: Instant

The timestamp when the checkpoint was created.

val ~~lastInput~~: JSONElement?

Serialized input received for node with nodePath

val lastOutput: JSONElement?

Serialized output received from node with nodePath

val messageHistory: List<Message>

A list of messages exchanged in the session up to the checkpoint. Messages include interactions between the user, system, assistant, and tools.

val nodePath: String

The identifier of the node where the checkpoint was created.

val properties: JSONObject?

Additional data associated with the checkpoint. This can be used to store additional information about the agent's state.

val version: Long

The version of the checkpoint data structure

Functions

open operator override fun equals(other: Any?): Boolean

fun AgentCheckpointData.isTombstone(): Boolean

Checks whether the AgentCheckpointData instance is marked as a tombstone.

toAgentContextData

fun AgentCheckpointData.toAgentContextData(rollbackStrategy: RollbackStrategy, additionalRollbackAction: suspend (AIAgentContext) -> Unit = {}): AgentContextData

Converts an instance of AgentCheckpointData to AgentContextData.