Event taxonomy
RCP defines one event envelope and a growing union of event type values, grouped below by category. Live means Runtime emits this event today. Roadmap means the type exists in the schema but nothing produces it yet. Internal means it is emitted by the gateway for its own routing and metering, not exposed as a public event.
Session
| Event | Status |
|---|
SessionStarted | Live |
SessionEnded | Live |
SessionPaused | Roadmap |
SessionResumed | Roadmap |
Prompt
| Event | Status |
|---|
PromptSubmitted | Roadmap |
PromptCancelled | Roadmap |
PromptCompleted | Roadmap |
Model
| Event | Status |
|---|
ModelSelected | Roadmap |
ModelInvocationStarted | Live |
ModelInvocationCompleted | Live |
ReasoningStarted | Roadmap |
ReasoningCompleted | Roadmap |
Completion
| Event | Status |
|---|
CompletionStarted | Live |
CompletionCompleted | Live |
Tool use
| Event | Status |
|---|
ToolInvoked | Roadmap |
ToolCompleted | Roadmap |
ContextLoaded | Roadmap |
Files
| Event | Status |
|---|
FileOpened | Roadmap |
FileRead | Roadmap |
FileCreated | Roadmap |
FileModified | Roadmap |
FileDeleted | Roadmap |
FileRenamed | Roadmap |
Commands
| Event | Status |
|---|
CommandExecuted | Roadmap |
CommandSucceeded | Roadmap |
CommandFailed | Roadmap |
Search
| Event | Status |
|---|
SearchPerformed | Roadmap |
SymbolLookup | Roadmap |
ReferenceLookup | Roadmap |
Version control
| Event | Status |
|---|
BranchCreated | Roadmap |
CommitCreated | Roadmap |
PushCompleted | Roadmap |
PullCompleted | Roadmap |
Testing
| Event | Status |
|---|
TestStarted | Roadmap |
TestPassed | Roadmap |
TestFailed | Roadmap |
Build
| Event | Status |
|---|
BuildStarted | Roadmap |
BuildSucceeded | Roadmap |
BuildFailed | Roadmap |
Gateway internals
Prefixed runtime.* — emitted by the gateway proxy for metering and routing, not by AI clients directly. runtime.CostRecorded is the one gateway event surfaced publicly today.
| Event | Status |
|---|
runtime.RequestReceived | Internal |
runtime.RequestForwarded | Internal |
runtime.ProviderSelected | Internal |
runtime.CacheHit | Internal |
runtime.CacheMiss | Internal |
runtime.CreditsConsumed | Internal |
runtime.CostRecorded | Live |
runtime.RateLimited | Internal |
runtime.DeploymentStarted | Internal |
runtime.DeploymentCompleted | Internal |
For the envelope and payload field shapes, see Schema reference.