Expand description
The small event protocol shared by agent frontends.
Structs§
- Agent
Message Content Delta Event - Agent
Message Event - Agent
Reasoning Content Delta Event - Approval
Call - Error
Event - Event
- An event emitted to a frontend.
- Exec
Approval Request Event - Frontend
Action - One labeled, icon-forward action attached to a list item.
- Frontend
Action List Item - One compact status row with optional trailing actions.
- Frontend
Active Input - How normal composer input is submitted while a turn is active.
- Frontend
Block - Capability-rendered transcript content with frontend-neutral formatting and tone.
- Frontend
Command - A frontend command declared by a capability.
- Frontend
Contribution - UI metadata exported by one capability.
- Frontend
Picker Option - One selectable action supplied by a capability.
- Frontend
Progress - Determinate progress rendered by a frontend widget.
- Frontend
Reference - One chat reference supplied by a capability.
- Frontend
Setting - One schema-advertised setting rendered by a thin frontend.
- Frontend
Setting Option - One exact value in a schema-advertised select control.
- Frontend
Widget - One capability-rendered view mounted into a standard frontend slot.
- Message
Target - Exact durable transcript prefix selected by a message action.
- Middleware
Feature - One middleware entry and its frontend-neutral configuration controls.
- Model
Changed Event - Model
Step Completed Event - The terminal record for one provider request.
- Model
Step Content - One complete normalized text item produced by a model step.
- Model
Step Started Event - One provider request becoming active within a turn.
- Rendered
Block - A block together with its explicit semantic owner.
- Session
Configured Event - Immutable session data emitted once when an agent starts or resumes.
- Session
Context - Frontend-visible context for the session owner, workspace, and origin.
- Session
File Reference - One immutable, session-bound file addressed by an opaque reference.
- Session
History Event - A restored transcript kept distinct from live turn lifecycle events.
- Session
Resume Requested Event - Submission
- A command submitted by a frontend.
- Token
Count Event - Token
Usage - Token
Usage Info - Tool
Call Begin Event - Tool
Call EndEvent - Turn
Aborted Event - Turn
Complete Event - Turn
Started Event - User
Message Event - Warning
Event - WebSearch
Begin Event - WebSearch
EndEvent
Enums§
- Agent
Message Phase - Assistant message phases understood by frontends.
- Error
Kind - Stable frontend classification for framework failures.
- Event
Msg - Events supported by the minimal frontend contract.
- Frontend
Block Format - Frontend-neutral structure carried by a transcript block.
- Frontend
Block Role - Semantic category used for grouping, summaries, filtering, and icons.
- Frontend
Block State - Lifecycle state of one rendered transcript block.
- Frontend
Block Update - How a block changes the matching capability-scoped ID.
- Frontend
Event - Generic capability UI updates understood by every frontend.
- Frontend
List Item State - Semantic state for one compact list row.
- Frontend
Preview Update - How one preview page changes the matching frontend preview.
- Frontend
Setting Kind - Generic control metadata for a schema-advertised setting.
- Frontend
Setting Value - Scalar value accepted by the generic setting controls.
- Frontend
Slot - Stable locations a thin frontend shell makes available to capabilities.
- Frontend
Symbol - A presentation hint rather than a name from any one icon set, the same way
FrontendTonenames a role instead of a color. - Frontend
Tone - A presentation hint rather than a terminal-specific color.
- Frontend
Widget Content - Capability-owned content shown when a frontend widget is opened.
- Model
Event - Provider-neutral streaming output before submission correlation is attached.
- Model
Step Annotation - A provider-neutral annotation attached to one complete text part.
- Model
Step Content Phase - Semantic role of text preserved in a completed model step.
- Model
Step Outcome - Provider-neutral outcome of a completed model step.
- Op
- Commands supported by the agent.
- Review
Decision - A user’s decision for a paused tool batch.
- WebSearch
Action - Provider-neutral action reported by hosted web search.
Constants§
- MAX_
CAPABILITY_ INPUT_ BYTES - Maximum UTF-8 bytes accepted in capability command input or queued active input.
- MAX_
USER_ INPUT_ BYTES - Maximum total UTF-8 bytes accepted in one user-input submission.
Functions§
- replay_
events - Reconstructs frontend-neutral events from positioned durable transcript items.