Run events - Veryfront

Event types

Run events fall into three categories:

AG-UI: Standard events for execution status, text, tool calls, reasoning and state updates.
Extension: Veryfront extensions to AG-UI for input requests, child runs, model usage, citations and files.
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

Type	Name
`AGENT_RUN_REQUEST_ENQUEUED`	Run queued
`AGENT_RUN_DEFAULT_CHAT_START_ENQUEUED`	Default chat queued
`RUN_STARTED`	Run started
`RUN_PARKED`	Run waiting
`CHILD_RUN_STATUS_CHANGED`	Child run updated
`RUN_FINISHED`	Run finished
`RUN_ERROR`	Run error

Step

Type	Name
`STEP_STARTED`	Step started
`STEP_FINISHED`	Step finished

Model call

Type	Name
`AGENT_RUN_MODEL_CALL_CONTEXT_RECORDED`	Model call recorded
`MODEL_CALL_COMPLETED`	Model usage recorded

Reasoning

Type	Name
`REASONING_START`	Reasoning started
`REASONING_MESSAGE_START`	Reasoning message started
`REASONING_MESSAGE_CONTENT`	Reasoning message updated
`REASONING_MESSAGE_END`	Reasoning message finished
`REASONING_CONTENT`	Reasoning updated
`REASONING_END`	Reasoning finished

Text

Type	Name
`TEXT_MESSAGE_START`	Text started
`TEXT_MESSAGE_CONTENT`	Text updated
`TEXT_MESSAGE_END`	Text finished

Tool call

Type	Name
`TOOL_CALL_START`	Tool call started
`TOOL_CALL_ARGS`	Tool arguments updated
`TOOL_CALL_CHUNK`	Tool call updated
`TOOL_CALL_END`	Tool arguments finished
`TOOL_CALL_STATUS_CHANGED`	Tool status updated
`AGENT_RUN_INTEGRATION_CONNECTION_REFUSED`	Integration unavailable
`TOOL_CALL_RESULT`	Tool result recorded
`AGENT_RUN_TOOL_RESULT_SUBMITTED`	Tool result submitted
`AGENT_RUN_TOOL_RESULT_DELIVERY_FAILED`	Tool result delivery failed

Input request

Type	Name
`INPUT_REQUEST_CREATED`	Input requested
`INPUT_REQUEST_UPDATED`	Input request updated

Artefacts

Type	Name
`URL_CITED`	URL cited
`DOCUMENT_CITED`	Document cited
`FILE_ATTACHED`	File attached
`FILES_CHANGED`	Files changed

State and activity

Type	Name
`STATE_SNAPSHOT`	State
`STATE_DELTA`	State updated
`MESSAGES_SNAPSHOT`	Messages
`ACTIVITY_SNAPSHOT`	Activity
`ACTIVITY_DELTA`	Activity updated

Management

Type	Name
`AGENT_RUN_AUTHORIZATION_SEALED`	Authorization recorded
`AGENT_RUN_REPLAYED_UPLOADS_SEALED`	Uploads recorded
`AGENT_RUN_TOOL_EXPOSURE_CHECKPOINTED`	Available tools recorded
`AGENT_RUN_CONTROL_PLANE_DISPATCH_ACCEPTED`	Run dispatch accepted
`AGENT_RUN_RUNTIME_OWNER_BOUND`	Runtime assigned
`AGENT_RUN_DETACHED_ACCEPTED`	Detached run accepted
`AGENT_RUN_RUNTIME_INVOKE_RETRIED`	Runtime call retried
`AGENT_RUN_CONTEXT_COMPACTED`	Context shortened
`AGENT_RUN_PROVIDER_REPLAY_CHECKPOINTED`	Replay state saved
`AGENT_RUN_PROVIDER_REPLAY_TURN_STARTED`	Replay turn started
`AGENT_RUN_PROVIDER_REPLAY_TURN_FINISHED`	Replay turn finished

Billing

Type	Name
`AGENT_RUN_INVOKE_AGENT_BILLING_MODE_RETAINED`	Billing mode kept
`AGENT_RUN_BILLING_USAGE_RETAINED`	Usage kept

Diagnostics

Type	Name
`RUN_LOG_CAPTURED`	Run log recorded
`RUNTIME_EVENT_RECORDED`	Runtime event recorded
`STREAM_HEARTBEAT_EMITTED`	Stream heartbeat