event

type AssistantPayload struct {
	// Usage carries the token counts reported by the Claude API.
	Usage usage.Usage

	// Model is the Claude model ID that generated this turn, e.g.
	// "claude-opus-4-7". Populated from the JSONL "message.model" field.
	// Empty string when the field is absent (older JSONL files or opaque events).
	Model string

	// Summary is derived by the priority chain in design.md ADR-010:
	// tool_use > text > "(thinking)" > "". Bounded by Truncate().
	Summary string

	// ToolUseID is the id of the first tool_use block in this event's content.
	// Non-empty only when the event contains at least one tool_use block.
	// Used by the livesession use case for tool_use ↔ tool_result matching.
	ToolUseID string

	// ToolName is the name field of the first tool_use block (e.g. "Read", "Bash").
	// Non-empty only when ToolUseID is non-empty.
	ToolName string

	// Has1hCache is true when the API response included at least one token in
	// message.usage.cache_creation.ephemeral_1h_input_tokens.
	//
	// The 1-hour prompt cache tier is exclusively available to Claude Max plan
	// subscribers who have the 1M-token context window.  Standard plan users
	// only have access to the 5-minute cache tier.  Therefore, the presence of
	// 1h-cache tokens is a reliable indicator that the session is running under
	// the 1M-context variant of the model, even though the JSONL message.model
	// field does not carry a "[1m]" suffix.
	//
	// Used by livesession to synthesize the effective model ID
	// "claude-opus-4-7[1m]" when this field is true.
	Has1hCache bool
}

type Event struct {
	// ID is the globally-unique identifier (UUID) assigned by Claude Code.
	ID string

	// Timestamp is the UTC instant at which the Event was recorded.
	Timestamp time.Time

	// Kind is the category of activity. May be an unrecognized string value
	// when the adapter maps an unknown JSONL type to KindOpaque and stores
	// the original string in the Kind field of the envelope.
	Kind Kind

	// SessionID is the identifier of the Session this Event belongs to.
	SessionID string

	// ParentID is the ID of the preceding Event in the conversation DAG.
	// Empty for root Events (the first event in a session).
	ParentID string

	// Payload carries kind-specific data. Callers type-switch on the concrete
	// Payload type. Never nil after NewEvent.
	Payload Payload
}

type Kind string

type OpaquePayload struct {
	Raw []byte
}

type Payload interface {
	// contains filtered or unexported methods
}

type UserPayload struct {
	// IsMeta is true for system-injected user events (skill prompts,
	// <local-command-caveat>, etc.). Set from the JSONL "isMeta" field.
	IsMeta bool

	// IsToolResultOnly is true when the user event's message.content is
	// an array containing exclusively tool_result blocks. Set during
	// JSONL decode by inspecting the content array.
	IsToolResultOnly bool

	// Summary is the truncated, single-line text of the typed user prompt.
	// Empty when IsMeta or IsToolResultOnly is true. Bounded by Truncate().
	Summary string

	// ToolResultIDs lists the tool_use_id values of all tool_result blocks
	// in this event's content. Non-empty only when IsToolResultOnly is true.
	// Used by the livesession use case for tool_use ↔ tool_result matching
	// (duration computation, state determination).
	ToolResultIDs []string

	// ToolResultError is true if any tool_result block in this event has
	// is_error set to true. Used to mark the corresponding tool call as failed.
	ToolResultError bool
}