EventContext
EventContext standardizes event envelope metadata for domain events
Usage profiles
| Usage | Fields and validation |
|---|---|
| In webhook payloads | View fields |
In webhook payloads
Webhook JSON uses protobuf field names (snake_case).
| Field | Type | Presence | Meaning |
|---|---|---|---|
event_name | string | Optional | Stable event name, e.g. "llm.message_published" |
version | string | Optional | Version of the event schema (semver or simple numeric) |
event_id | string | Optional | Unique event identifier (UUID) |
correlation_id | string | Optional | Correlation identifier (e.g., session/workflow/conversation id) |
emitted_at | string | Optional | RFC3339 timestamp string of when the event was emitted |
caller_key | string | Optional | Publisher-provided routing key (e.g., conversation/thread id) |
metadata | Map from string to string | Optional | Application-level metadata (not transport tracing headers) |
tenant_id | string | Optional | Identifier of the tenant to which the event belongs, used to select that tenant’s webhook destinations. |
project_id | string | Optional | Identifier of the project within the tenant that scopes the event. Defaults to default when no project is supplied. |
session_id | string | Optional | Identifier of the end-user application session associated with the event, distinct from tenant and conversation identity. |
Where used
| Reference | Relationship |
|---|---|
| llm.generation_completed | Webhook JSON uses protobuf field names (snake_case). |
| llm.generation_started | Webhook JSON uses protobuf field names (snake_case). |
| llm.message_published | Webhook JSON uses protobuf field names (snake_case). |
| llm.tool_call_approval_required | Webhook JSON uses protobuf field names (snake_case). |
| llm.tool_call_completed | Webhook JSON uses protobuf field names (snake_case). |
| llm.tool_call_started | Webhook JSON uses protobuf field names (snake_case). |
| LLMGenerationCompletedEvent | Nested in model |
| LLMGenerationStartedEvent | Nested in model |
| LLMMessagePublishedEvent | Nested in model |
| ToolCallCompletedEvent | Nested in model |
| ToolCallStartedEvent | Nested in model |
Download the public reference contract.
Document: DOC-API-MODEL-event-context.