google-adk-kotlin-core/com.google.adk.kt.events/Event

Event

@Serializable

data class Event(val id: String = Uuid.random(), val invocationId: String? = null, val author: String, val content: Content? = null, val actions: EventActions = EventActions(), val longRunningToolIds: Set<String> = emptySet(), val partial: Boolean = false, val turnComplete: Boolean = false, val errorCode: String? = null, val errorMessage: String? = null, val finishReason: FinishReason? = null, val usageMetadata: UsageMetadata? = null, val avgLogProbs: Double? = null, val interrupted: Boolean = false, val branch: String? = null, val groundingMetadata: GroundingMetadata? = null, val modelVersion: String? = null, val citationMetadata: CitationMetadata? = null, val customMetadata: Map<String, Any>? = null, val timestamp: Long = Clock.System.now().toEpochMilliseconds())

Represents an event in a session.

Constructors

Event

constructor(id: String = Uuid.random(), invocationId: String? = null, author: String, content: Content? = null, actions: EventActions = EventActions(), longRunningToolIds: Set<String> = emptySet(), partial: Boolean = false, turnComplete: Boolean = false, errorCode: String? = null, errorMessage: String? = null, finishReason: FinishReason? = null, usageMetadata: UsageMetadata? = null, avgLogProbs: Double? = null, interrupted: Boolean = false, branch: String? = null, groundingMetadata: GroundingMetadata? = null, modelVersion: String? = null, citationMetadata: CitationMetadata? = null, customMetadata: Map<String, Any>? = null, timestamp: Long = Clock.System.now().toEpochMilliseconds())

Properties

actions

val actions: EventActions

Optional actions associated with this event.

author

val author: String

The author of the event, it could be the name of the agent or "user" literal.

avgLogProbs

val avgLogProbs: Double? = null

The average log probabilities of the generated tokens.

branch

val branch: String? = null

The branch of the event. The format is like agent_1.agent_2.agent_3, where agent_1 is the parent of agent_2, and agent_2 is the parent of agent_3. Branch is used when multiple sub-agents shouldn't see their peer agents' conversation history.

citationMetadata

val citationMetadata: CitationMetadata? = null

content

val content: Content? = null

The content of the event.

customMetadata

val customMetadata: Map<String, Any>? = null

errorCode

val errorCode: String? = null

An error code if an error occurred during the event processing.

errorMessage

val errorMessage: String? = null

A human-readable error message if an error occurred.

finishReason

val finishReason: FinishReason? = null

The reason the LLM generation finished.

groundingMetadata

val groundingMetadata: GroundingMetadata? = null

The grounding metadata of the event.

val id: String

The event id.

interrupted

val interrupted: Boolean = false

True if the generation of this event was interrupted.

invocationId

val invocationId: String? = null

Id of the invocation that this event belongs to.

isFinalResponse

val isFinalResponse: Boolean

Returns true if this event is the final response of an agent turn — i.e. it terminates the per-turn model loop in com.google.adk.kt.agents.LlmAgent.executeTurns. Matches ADK Python's Event.is_final_response(): skipSummarization or a non-empty longRunningToolIds set both mark the event as final, otherwise the event is final iff it carries no function calls, no function responses, is not a partial streaming chunk, and has no trailing code-execution-result part.