Docs
Events and Types
Events and Types
The main event, policy, trace, dataset, and manual eval types that shape v1 behavior.
Events and Types
Important runtime types in the current public surface include:
BudgetPolicyCallPolicyToolPolicySessionPolicyTraceContextTraceSpanSnapshotUsageRecordDatasetSnapshotDatasetRowSnapshotManualEvalManualEvalRun
How to think about the types
- Budget and policy types describe what the SDK is allowed to do.
- Trace types describe what happened during execution.
- Dataset and manual eval types describe what gets reviewed later.
- Event types describe the lifecycle around all of the above.
Span status
runningcompletedblockedfailed
Event groups
- Session lifecycle
- Request lifecycle
- Budget reservation and spend reconciliation
- Tool lifecycle
- Guardrail violations
Why this matters
The type surface is intentionally small so the docs can stay readable. When you are unsure what a field means, check whether it belongs to budget, policy, trace, or review, and the shape usually becomes obvious fast.