Module event 

Re-export of the canonical AgentEvent and its payload structs from behest_event.

Structs

CacheMetrics

Emitted after each model call when the provider reported prompt cache statistics. All fields are zero when the provider did not report cache hits or writes for this call.

CompactionCircuitOpened

Emitted when the compaction circuit breaker opens due to repeated failures.

ContextBuilt

Emitted after context has been assembled from session history and adapters.

DoomLoopDetected

Emitted when the agent is detected to be in a repetitive tool call cycle.

MessageCommitted

Notification that a message has been persisted to the session store.

ModelStarted

Emitted when a model invocation begins, carrying iteration count.

RunCancelled

Terminal event emitted when a run is cancelled before completion.

RunCompleted

Terminal event emitted when a run finishes successfully.

RunFailed

Terminal event emitted when a run terminates with an error.

RunStarted

Emitted when a run begins execution after session load and input admission.

TextDelta

Streaming text delta emitted during model response generation.

ToolCallCompleted

Emitted when the model finishes emitting a complete tool call.

ToolCallDelta

Streaming delta for tool call arguments during model response.

ToolCallStarted

Emitted when the model requests a tool call.

ToolExecutionFinished

Emitted when a tool function completes, carrying the result and duration.

ToolExecutionStarted

Emitted when a tool function begins executing.

UsageRecorded

Emitted after each model invocation to record token consumption.

Enums

AgentEvent

Event emitted during agent runtime execution.

ToolExecutionResult

Result of a single tool execution.