recording

type EventIterator struct {
	// contains filtered or unexported fields
}

type ExportOptions struct {
	// ProviderName to include in metadata.
	ProviderName string

	// Model to include in metadata.
	Model string

	// Custom metadata to include.
	Custom map[string]any
}

type Format string

type MessageSnapshot struct {
	Role      string
	Content   string
	Timestamp time.Time
	Offset    time.Duration
}

type Metadata struct {
	// SessionID is the unique identifier for this session.
	SessionID string `json:"session_id"`

	// ConversationID groups related turns within a session.
	ConversationID string `json:"conversation_id,omitempty"`

	// StartTime is when the session began.
	StartTime time.Time `json:"start_time"`

	// EndTime is when the session ended.
	EndTime time.Time `json:"end_time"`

	// Duration is the total session length.
	Duration time.Duration `json:"duration"`

	// EventCount is the total number of events.
	EventCount int `json:"event_count"`

	// ProviderName is the LLM provider used (e.g., "openai", "gemini").
	ProviderName string `json:"provider_name,omitempty"`

	// Model is the model identifier used.
	Model string `json:"model,omitempty"`

	// Version is the recording format version.
	Version string `json:"version"`

	// CreatedAt is when this recording was exported.
	CreatedAt time.Time `json:"created_at"`

	// Custom allows arbitrary metadata to be attached.
	Custom map[string]any `json:"custom,omitempty"`
}

type PlaybackState struct {
	// Position is the current offset from session start.
	Position time.Duration

	// Timestamp is the absolute timestamp at this position.
	Timestamp time.Time

	// CurrentEvents are events occurring at exactly this position (within tolerance).
	CurrentEvents []RecordedEvent

	// RecentEvents are events that occurred in the last `window` duration.
	RecentEvents []RecordedEvent

	// ActiveAnnotations are annotations whose time range includes this position.
	ActiveAnnotations []*annotations.Annotation

	// Messages accumulated up to this point.
	Messages []MessageSnapshot

	// AudioInputActive indicates if user audio is present at this position.
	AudioInputActive bool

	// AudioOutputActive indicates if assistant audio is present at this position.
	AudioOutputActive bool
}

type RecordedEvent struct {
	// Sequence is the event's position in the recording.
	Sequence int64 `json:"seq"`

	// ParentSequence links to a parent event (for causality).
	ParentSequence int64 `json:"parent_seq,omitempty"`

	// Type is the event type.
	Type events.EventType `json:"type"`

	// Timestamp is when the event occurred.
	Timestamp time.Time `json:"timestamp"`

	// Offset is the time since session start.
	Offset time.Duration `json:"offset"`

	// SessionID identifies the session.
	SessionID string `json:"session_id"`

	// ConversationID identifies the conversation within the session.
	ConversationID string `json:"conversation_id,omitempty"`

	// RunID identifies the specific run/request.
	RunID string `json:"run_id,omitempty"`

	// DataType is the Go type name of the original data.
	DataType string `json:"data_type,omitempty"`

	// Data is the event payload as raw JSON.
	Data json.RawMessage `json:"data,omitempty"`
}

type ReplayPlayer struct {
	// contains filtered or unexported fields
}

type SessionRecording struct {
	// Metadata about the recording
	Metadata Metadata `json:"metadata"`

	// Events in chronological order
	Events []RecordedEvent `json:"events"`
}