usage

type Day struct {
	Day             string  `json:"day"` // YYYY-MM-DD
	Input           int     `json:"input"`
	Output          int     `json:"output"`
	Effective       int     `json:"effective"`
	CostUSD         float64 `json:"costUsd"`
	IncludedListUSD float64 `json:"includedListUsd"`
}

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

type ModelUsage struct {
	Provider string `json:"provider"`
	Model    string `json:"model"`
	// Name is the catalogue's display name, empty for a model it does not know.
	Name    string `json:"name,omitempty"`
	Billing string `json:"billing"`
	// InferredProvider is set when Provider is empty — the work predates
	// recorded providers — and a configured provider serves the model today:
	// the row is billed as that provider, and says the provider was inferred.
	InferredProvider string `json:"inferredProvider,omitempty"`
	// Host is the endpoint the calls went to when the provider slot points
	// somewhere other than its own default (the OpenAI slot at Z.ai), so the
	// row can be named by it; empty on default endpoints. Rows from before
	// hosts were recorded take where the provider points today.
	Host string `json:"host,omitempty"`
	// Calls counts ledger rows: agent steps plus utility calls.
	Calls    int `json:"calls"`
	Sessions int `json:"sessions"`
	Tokens
	// CostUSD is what was billed per token: 0 for included usage, null when the
	// model is billed per token at an unknown price.
	CostUSD *float64 `json:"costUsd"`
	// ListUSD is included usage priced at the model's list price — what the
	// same tokens would cost on the vendor's own API. Null for metered usage,
	// which has a real cost, and when the catalogue does not price the model.
	ListUSD *float64 `json:"listUsd"`
}

type ProjectUsage struct {
	Project string `json:"project"`
	Name    string `json:"name"`
	Tokens
	CostUSD         float64 `json:"costUsd"`
	IncludedListUSD float64 `json:"includedListUsd"`
}

type SessionCost struct {
	Models []ModelUsage `json:"models"`
	Totals Totals       `json:"totals"`
}

type Summary struct {
	From int64 `json:"from"`
	To   int64 `json:"to"`
	// Project is the workspace the summary is narrowed to, empty for all.
	Project string `json:"project,omitempty"`
	// First is when the ledger's oldest row was spent, 0 when it is empty.
	First    int64          `json:"first"`
	Models   []ModelUsage   `json:"models"`
	Projects []ProjectUsage `json:"projects"`
	Days     []Day          `json:"days"`
	Totals   Totals         `json:"totals"`
}

type Tokens struct {
	Input      int `json:"input"`
	Output     int `json:"output"`
	Reasoning  int `json:"reasoning"`
	CacheRead  int `json:"cacheRead"`
	CacheWrite int `json:"cacheWrite"`
	Effective  int `json:"effective"`
	Total      int `json:"total"`
}

type Totals struct {
	Tokens
	Calls    int `json:"calls"`
	Sessions int `json:"sessions"`
	// CostUSD is everything billed per token at a known price.
	CostUSD float64 `json:"costUsd"`
	// IncludedListUSD is plan and local usage at list price, the part of the
	// work the flat plans covered.
	IncludedListUSD float64 `json:"includedListUsd"`
	// IncludedEffective is the effective tokens that were not billed per token.
	IncludedEffective int `json:"includedEffective"`
	// UnpricedEffective is the effective tokens billed per token at a price
	// nothing publishes, so CostUSD leaves them out.
	UnpricedEffective int `json:"unpricedEffective"`
	// UnknownEffective is the effective tokens whose provider was never
	// recorded and cannot be inferred, so CostUSD leaves them out too.
	UnknownEffective int `json:"unknownEffective"`
}