usage

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

type Step struct {
	// Step is the agent name the step ran under.
	Step string
	// Prompt/Completion/Total are the provider's reported counts. Total is
	// what a budget is measured against; a provider that reports no usage at
	// all contributes zeros rather than an estimate, since a budget must never
	// trip on a number nobody reported.
	Prompt     int
	Completion int
	Total      int
	// Cached is the part of Prompt the provider served from its cache.
	//
	// This is the number that says whether prompt caching (see internal/agent/llmclient/openrouter.go)
	// is doing anything. Without it the feature is faith-based: the requests
	// carry the headers either way, and nothing reports whether they landed.
	Cached int
	// Reasoning is tokens a reasoning model spent thinking. Some providers
	// fold these into Completion and some do not, so a total that does not
	// reconcile with prompt+completion is usually this.
	Reasoning int
	// ModelServed is the model the provider says answered, which is not always
	// the one requested: openrouter/auto and router models resolve at request
	// time, and providers substitute. Empty when nothing reported one.
	ModelServed string
	// CostUSD is what the run cost, when a provider path reports one at all.
	// Only a CLI subprocess does: it meters itself and prints the figure in
	// its terminal event, while every HTTP path reports tokens and leaves
	// pricing to whoever knows the rate card. Zero means unreported, never
	// free — which is why the page shows nothing rather than $0.00.
	CostUSD float64
	// FinishReason is why the last response ended. "length" (or whatever the
	// provider spells it) means the answer was TRUNCATED by max_tokens, which
	// is otherwise indistinguishable from a model that simply said little —
	// and a truncated JSON or verdict is a failure that reads as a bad answer.
	FinishReason string
	// Raw is the provider's usage block for the LAST response of the
	// conversation, as JSON — the fields nobody has asked for yet. A field not
	// captured today cannot be backfilled tomorrow; keeping the block whole now
	// avoids a migration later, costs a column and buys
	// every future question about spend.
	//
	// One response, deliberately, while every count beside it is the whole
	// conversation's. Accumulating a dozen JSON blocks per step would store
	// the transcript's weight again for a shape nothing reads yet. Do NOT
	// reconcile this against Total — they answer different questions, and a
	// 12-turn step will show them disagreeing by two orders of magnitude.
	Raw string
}

type Tokens struct {
	Input      int
	CacheRead  int
	CacheWrite int
	Output     int
}