TrajectoryEvent

A compact, replay-oriented record of one harness-side action or observation.

Class Diagram

---
title: TrajectoryEvent
config:
  look: handDrawn
  theme: colorful
  class:
    hideEmptyMembersBox: true
---
classDiagram
    class TrajectoryEvent {
        +string id
        +string sessionId
        +string turnId
        +string toolCallId
        +int32 turnIndex
        +string eventType
        +dictionary data
        +string createdAt
        +RedactionMetadata redaction
    }
    class RedactionMetadata {
        +boolean sanitized
        +RedactedField[] fields
        +string policy
    }
    TrajectoryEvent *-- RedactionMetadata

Yaml Example

id: traj_abc123
sessionId: sess_abc123
turnId: turn_001
toolCallId: call_abc123
turnIndex: 4
eventType: command
createdAt: 2026-06-09T20:00:00Z

Properties

Name	Type	Description
id	string	Stable trajectory event identifier
sessionId	string	Stable session identifier
turnId	string	Associated turn identifier, when available
toolCallId	string	Associated tool call identifier, when available
turnIndex	int32	Zero-based turn index in the session
eventType	string	Host-defined trajectory event category
data	dictionary	Sanitized event data
createdAt	string	ISO 8601 UTC timestamp when the trajectory event was recorded
redaction	RedactionMetadata	Redaction state for sensitive trajectory fields

Composed Types

The following types are composed within TrajectoryEvent:

• RedactionMetadata