transcript

type Conversation struct {
	SrcAgent     string
	Turns        []Turn
	DroppedLines int // unparseable/skipped lines (format drift, partial tail)
}

type RenderKind int

type RenderOptions struct {
	// Kind selects the header framing (migrate vs fork). Defaults to
	// RenderMigrate (the zero value).
	Kind RenderKind
	// MaxBytes is the approximate size budget for the rendered body. When the
	// transcript exceeds it, the oldest turns are elided (newest kept). 0 uses
	// a default.
	MaxBytes int
	// MaxToolOutput caps each tool output block. 0 uses a default.
	MaxToolOutput int
}

type Role string

type Source struct {
	Path    string
	Size    int64
	ModTime time.Time
}

type ToolCall struct {
	Name   string
	Args   string
	Output string
	Failed bool
}

type Turn struct {
	Role     Role
	Text     string
	Tool     *ToolCall // non-nil when Role == RoleTool
	SrcAgent string    // source agent that produced the turn
}

type Usage struct {
	Input         int64 // fresh, uncached input tokens
	Output        int64 // completion tokens
	CacheCreation int64 // cache-write tokens (Claude only; Codex has no such concept)
	CacheRead     int64 // cache-hit input tokens
	Unclassified  int64 // provider aggregate we can't break down (legacy Codex)

	// Found reports whether at least one valid usage record was observed. A
	// transcript with no usage records yields Found=false — distinct from a
	// genuine zero — so callers never present a confident zero for a file they
	// couldn't read usage from.
	Found bool
	// Dropped counts records that were skipped or conflicted (format drift,
	// duplicate usage with differing values, un-deduplicatable records). A
	// nonzero value flags the total as approximate.
	Dropped int
}