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, val messageHistory: List<Message>, val version: Long, val properties: Map<String, JsonElement>? = 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, messageHistory: List<Message>, version: Long, properties: Map<String, JsonElement>? = null)

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 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: Map<String, JsonElement>?

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

fun AgentCheckpointData.isTombstone(): Boolean

Checks whether the AgentCheckpointData instance is marked as a tombstone.

toAgentContextData

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

Converts an instance of AgentCheckpointData to AgentContextData.