usage

type DailyUsage struct {
	Date             string // YYYY-MM-DD format
	InputTokens      int
	OutputTokens     int
	CacheWriteTokens int
	CacheReadTokens  int
	ReasoningTokens  int
	TotalCost        float64
	ModelsUsed       []string
	Entries          []UsageEntry // Raw entries for this day (used for breakdown)
}

type FilterOptions struct {
	Since           time.Time // Include entries on or after this time
	Until           time.Time // Include entries on or before this time
	Provider        string    // Filter to specific provider, or empty for all
	IncludeExternal bool      // Include term-llm entries with TrackedExternallyBy set (opt-in)
}

type LoadResult struct {
	Entries            []UsageEntry
	MissingDirectories []string
	Errors             []error
}

type LogEntry struct {
	Timestamp           time.Time `json:"timestamp"`
	SessionID           string    `json:"session_id,omitempty"`
	Model               string    `json:"model"`
	Provider            string    `json:"provider"`
	InputTokens         int       `json:"input_tokens"`
	OutputTokens        int       `json:"output_tokens"`
	CacheWriteTokens    int       `json:"cache_write_tokens,omitempty"`
	CacheReadTokens     int       `json:"cache_read_tokens,omitempty"`
	CostUSD             float64   `json:"cost_usd,omitempty"`
	TrackedExternallyBy string    `json:"tracked_externally_by,omitempty"`
}

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

type ModelBreakdown struct {
	Model            string
	InputTokens      int
	OutputTokens     int
	CacheWriteTokens int
	CacheReadTokens  int
	ReasoningTokens  int
	Cost             float64
}

type ModelPricing struct {
	InputCostPerToken           float64 `json:"input_cost_per_token"`
	OutputCostPerToken          float64 `json:"output_cost_per_token"`
	CacheCreationInputTokenCost float64 `json:"cache_creation_input_token_cost"`
	CacheReadInputTokenCost     float64 `json:"cache_read_input_token_cost"`
	InputCostPerTokenAbove200k  float64 `json:"input_cost_per_token_above_200k_tokens"`
	OutputCostPerTokenAbove200k float64 `json:"output_cost_per_token_above_200k_tokens"`
	CacheCreationCostAbove200k  float64 `json:"cache_creation_input_token_cost_above_200k_tokens"`
	CacheReadCostAbove200k      float64 `json:"cache_read_input_token_cost_above_200k_tokens"`

	// TieredThreshold overrides the legacy 200K threshold. WholeRequestTier
	// means crossing the threshold reprices every token in the request rather
	// than only tokens above the threshold (the GPT-5.6 pricing contract).
	TieredThreshold  int  `json:"-"`
	WholeRequestTier bool `json:"-"`
}

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

type ProviderBreakdown struct {
	Provider         string
	InputTokens      int
	OutputTokens     int
	CacheWriteTokens int
	CacheReadTokens  int
	ReasoningTokens  int
	Cost             float64
}

type UsageEntry struct {
	Timestamp           time.Time
	SessionID           string
	Model               string
	InputTokens         int
	OutputTokens        int
	CacheWriteTokens    int     // cache_creation for Claude
	CacheReadTokens     int     // cache_read tokens
	ReasoningTokens     int     // provider-reported reasoning tokens
	CostUSD             float64 // Pre-calculated cost if available
	Provider            string  // Usage data source, such as ProviderClaudeCode or ProviderTermLLM
	TrackedExternallyBy string  // External tracker name, or empty for direct API usage
	// PreAggregated marks counters summed over many requests. Long-context
	// pricing applies per request, so a summed bucket must never be repriced at
	// the tiered rate: a session of small requests would be billed as one
	// enormous one, at up to double the real rate.
	PreAggregated bool
}