deck

type Filters struct {
	Since   time.Duration
	From    *time.Time
	To      *time.Time
	Model   string
	Status  string
	Project string
	Sort    string
	SortDir string
	Session string
}

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

type ModelCost = sessions.ModelCost

type Overview struct {
	Sessions       []SessionSummary     `json:"sessions"`
	TotalCost      float64              `json:"total_cost"`
	TotalTokens    int64                `json:"total_tokens"`
	InputTokens    int64                `json:"input_tokens"`
	OutputTokens   int64                `json:"output_tokens"`
	TotalDuration  time.Duration        `json:"total_duration_ns"`
	TotalTurns     int                  `json:"total_turns"`
	SuccessRate    float64              `json:"success_rate"`
	Completed      int                  `json:"completed"`
	Failed         int                  `json:"failed"`
	Abandoned      int                  `json:"abandoned"`
	CostByModel    map[string]ModelCost `json:"cost_by_model"`
	PreviousPeriod *PeriodComparison    `json:"previous_period,omitempty"`
}

type OverviewPage struct {
	Overview   *Overview
	NextCursor string
	HasMore    bool
}

type OverviewPager interface {
	OverviewPage(ctx context.Context, filters Filters, cursor string, limit int) (*OverviewPage, error)
}

type PeriodComparison struct {
	TotalCost     float64       `json:"total_cost"`
	TotalTokens   int64         `json:"total_tokens"`
	TotalDuration time.Duration `json:"total_duration_ns"`
	TotalTurns    int           `json:"total_turns"`
	SuccessRate   float64       `json:"success_rate"`
	Completed     int           `json:"completed"`
}

type Pricing = sessions.Pricing

type PricingTable = sessions.PricingTable

type Querier interface {
	Overview(ctx context.Context, filters Filters) (*Overview, error)
	SessionDetail(ctx context.Context, sessionID string) (*SessionDetail, error)
}

type SessionDetail struct {
	Summary         SessionSummary        `json:"summary"`
	Turns           []TurnSummary         `json:"turns,omitempty"`
	Messages        []SessionMessage      `json:"messages"`
	GroupedMessages []SessionMessageGroup `json:"grouped_messages,omitempty"`
}

type SessionMessage struct {
	// TraceID is the turn this message belongs to — the drill-in key.
	TraceID      string        `json:"trace_id,omitempty"`
	Hash         string        `json:"hash"`
	Role         string        `json:"role"`
	Model        string        `json:"model"`
	Timestamp    time.Time     `json:"timestamp"`
	Delta        time.Duration `json:"delta_ns"`
	InputTokens  int64         `json:"input_tokens"`
	OutputTokens int64         `json:"output_tokens"`
	TotalTokens  int64         `json:"total_tokens"`
	InputCost    float64       `json:"input_cost"`
	OutputCost   float64       `json:"output_cost"`
	TotalCost    float64       `json:"total_cost"`
	ToolCalls    []string      `json:"tool_calls"`
	Text         string        `json:"text"`
}

type SessionMessageGroup struct {
	Role         string        `json:"role"`
	StartTime    time.Time     `json:"start_time"`
	EndTime      time.Time     `json:"end_time"`
	Delta        time.Duration `json:"delta_ns"`
	InputTokens  int64         `json:"input_tokens"`
	OutputTokens int64         `json:"output_tokens"`
	TotalTokens  int64         `json:"total_tokens"`
	InputCost    float64       `json:"input_cost"`
	OutputCost   float64       `json:"output_cost"`
	TotalCost    float64       `json:"total_cost"`
	ToolCalls    []string      `json:"tool_calls"`
	Text         string        `json:"text"`
	Count        int           `json:"count"`
	StartIndex   int           `json:"start_index"`
	EndIndex     int           `json:"end_index"`
}

type SessionSummary = sessions.SessionSummary

type TurnConversation struct {
	Turn            TurnSummary           `json:"turn"`
	Messages        []SessionMessage      `json:"messages"`
	GroupedMessages []SessionMessageGroup `json:"grouped_messages,omitempty"`
	ToolFrequency   map[string]int        `json:"tool_frequency,omitempty"`
	// OffshootCalls counts llm spans whose call_kind marks them as harness
	// side-traffic (offshoot:*) rather than conversation spine.
	OffshootCalls int `json:"offshoot_calls"`
	// InjectedContexts counts injected:* spans (context the harness spliced
	// into the conversation without the user typing it).
	InjectedContexts int `json:"injected_contexts"`
}

type TurnQuerier interface {
	TurnConversation(ctx context.Context, traceID string) (*TurnConversation, error)
}

type TurnSummary struct {
	TraceID         string        `json:"trace_id"`
	UserPrompt      string        `json:"user_prompt,omitempty"`
	ResponsePreview string        `json:"response_preview,omitempty"`
	Status          string        `json:"status"`
	StartedAt       time.Time     `json:"started_at"`
	EndedAt         *time.Time    `json:"ended_at,omitempty"`
	Duration        time.Duration `json:"duration_ns"`
	InputTokens     int64         `json:"input_tokens"`
	OutputTokens    int64         `json:"output_tokens"`
	// Main* counts conversation-spine llm calls only; Total − Main is the
	// harness's shadow spend on the turn.
	MainInputTokens     int64   `json:"main_input_tokens"`
	MainOutputTokens    int64   `json:"main_output_tokens"`
	CacheReadTokens     int64   `json:"cache_read_tokens"`
	CacheCreationTokens int64   `json:"cache_creation_tokens"`
	TotalCost           float64 `json:"total_cost_usd"`
	SpanCount           int     `json:"span_count"`
}