Run events

Event types

Run events fall into three categories:

  1. AG-UI: Standard events for execution status, text, tool calls, reasoning and state updates.
  2. Extension: Veryfront extensions to AG-UI for input requests, child runs, model usage, citations and files.
  3. Control plane: Events that track how Veryfront queues, authorizes and coordinates a run.

The tables list 56 event types in 12 groups. See the API catalog for availability and payload fields.

Run

TypeName
AGENT_RUN_REQUEST_ENQUEUEDRun queued
AGENT_RUN_DEFAULT_CHAT_START_ENQUEUEDDefault chat queued
RUN_STARTEDRun started
RUN_PARKEDRun waiting
CHILD_RUN_STATUS_CHANGEDChild run updated
RUN_FINISHEDRun finished
RUN_ERRORRun error

Step

TypeName
STEP_STARTEDStep started
STEP_FINISHEDStep finished

Model call

TypeName
AGENT_RUN_MODEL_CALL_CONTEXT_RECORDEDModel call recorded
MODEL_CALL_COMPLETEDModel usage recorded

Reasoning

TypeName
REASONING_STARTReasoning started
REASONING_MESSAGE_STARTReasoning message started
REASONING_MESSAGE_CONTENTReasoning message updated
REASONING_MESSAGE_ENDReasoning message finished
REASONING_CONTENTReasoning updated
REASONING_ENDReasoning finished

Text

TypeName
TEXT_MESSAGE_STARTText started
TEXT_MESSAGE_CONTENTText updated
TEXT_MESSAGE_ENDText finished

Tool call

TypeName
TOOL_CALL_STARTTool call started
TOOL_CALL_ARGSTool arguments updated
TOOL_CALL_CHUNKTool call updated
TOOL_CALL_ENDTool arguments finished
TOOL_CALL_STATUS_CHANGEDTool status updated
AGENT_RUN_INTEGRATION_CONNECTION_REFUSEDIntegration unavailable
TOOL_CALL_RESULTTool result recorded
AGENT_RUN_TOOL_RESULT_SUBMITTEDTool result submitted
AGENT_RUN_TOOL_RESULT_DELIVERY_FAILEDTool result delivery failed

Input request

TypeName
INPUT_REQUEST_CREATEDInput requested
INPUT_REQUEST_UPDATEDInput request updated

Artefacts

TypeName
URL_CITEDURL cited
DOCUMENT_CITEDDocument cited
FILE_ATTACHEDFile attached
FILES_CHANGEDFiles changed

State and activity

TypeName
STATE_SNAPSHOTState
STATE_DELTAState updated
MESSAGES_SNAPSHOTMessages
ACTIVITY_SNAPSHOTActivity
ACTIVITY_DELTAActivity updated

Management

TypeName
AGENT_RUN_AUTHORIZATION_SEALEDAuthorization recorded
AGENT_RUN_REPLAYED_UPLOADS_SEALEDUploads recorded
AGENT_RUN_TOOL_EXPOSURE_CHECKPOINTEDAvailable tools recorded
AGENT_RUN_CONTROL_PLANE_DISPATCH_ACCEPTEDRun dispatch accepted
AGENT_RUN_RUNTIME_OWNER_BOUNDRuntime assigned
AGENT_RUN_DETACHED_ACCEPTEDDetached run accepted
AGENT_RUN_RUNTIME_INVOKE_RETRIEDRuntime call retried
AGENT_RUN_CONTEXT_COMPACTEDContext shortened
AGENT_RUN_PROVIDER_REPLAY_CHECKPOINTEDReplay state saved
AGENT_RUN_PROVIDER_REPLAY_TURN_STARTEDReplay turn started
AGENT_RUN_PROVIDER_REPLAY_TURN_FINISHEDReplay turn finished

Billing

TypeName
AGENT_RUN_INVOKE_AGENT_BILLING_MODE_RETAINEDBilling mode kept
AGENT_RUN_BILLING_USAGE_RETAINEDUsage kept

Diagnostics

TypeName
RUN_LOG_CAPTUREDRun log recorded
RUNTIME_EVENT_RECORDEDRuntime event recorded
STREAM_HEARTBEAT_EMITTEDStream heartbeat