telar-agent/dev.deeptelar.telar.agent/AgentState

AgentState

@Serializable

data class AgentState(val messages: List<ChatMessage> = emptyList(), val tokens: TokenUsage = TokenUsage())

The state of a toolAgent: the conversation so far, oldest message first, and what it cost.

It is @Serializable, so a checkpointer that uses kotlinx.serialization can save it.

Constructors

AgentState

constructor(messages: List<ChatMessage> = emptyList(), tokens: TokenUsage = TokenUsage())

constructor(question: String)

Starts a conversation with question as the user's first message.

Properties

answer

val answer: String?

The text of the model's final answer, or null while the conversation does not end with one: before the first run, when the run paused with tool calls waiting, or when the agent used its token budget before it had an answer.

answerTruncated

val answerTruncated: Boolean

true when the model reached its output limit before it finished its last message, so answer is cut off.

messages

val messages: List<ChatMessage>

tokens

val tokens: TokenUsage

the tokens of every answer of the model in this conversation, as far as the provider reported them. A conversation that continues with withUserMessage keeps counting. Use copy(tokens = TokenUsage()) to start the count again, for example for a budget per question.

Functions

withUserMessage

fun withUserMessage(text: String): AgentState

Returns this state with text added as the user's next message, to continue the conversation.