usage

type CollectOptions struct {
	// Now is the clock; nil means time.Now.
	Now func() time.Time
	// Timeout bounds each provider's usage fetch; 0 means DefaultTimeout.
	Timeout time.Duration
	// GrokHome is the grok home directory, used for both auth and sessions.
	GrokHome string
	// CodexHome is the codex home directory, used for both auth and sessions.
	CodexHome string
	// CommandCodeHome is the Command Code home directory.
	CommandCodeHome string
	// CommandCodeAPIURL overrides the Command Code API base URL; empty uses
	// COMMANDCODE_API_URL when COMMANDCODE_SANDBOX=true, else the default.
	CommandCodeAPIURL string
	// FixtureDir serves grok and codex usage from JSON files in this directory
	// instead of HTTP. Tests only.
	FixtureDir string
}

type FetchOptions struct {
	// GrokCommand overrides GROK_SHOW_USAGE_COMMAND.
	GrokCommand string
	// CodexCommand overrides CODEX_SHOW_STATUS_COMMAND.
	CodexCommand string
	// CodexSessionID overrides CODEX_SHOW_STATUS_SESSION_ID.
	CodexSessionID string
	// CodexTimeoutSeconds overrides CODEX_SHOW_STATUS_TIMEOUT when > 0.
	CodexTimeoutSeconds int
	// TTYWatchHome overrides TTY_WATCH_HOME (Codex).
	TTYWatchHome string
}

type FileFailure struct {
	Path string
	Err  error
}

type ListOptions struct {
	// Last limits the records returned, newest first; 0 reads all of them.
	Last int
	// Since drops records collected before it. Day directories that cannot hold
	// an in-window record are skipped without being read. Zero reads the whole
	// tree.
	Since time.Time
}

type ProviderID string

type Record struct {
	Schema   string        `json:"schema"`
	TS       time.Time     `json:"ts"`
	Provider ProviderID    `json:"provider"`
	Usage    UsageBlock    `json:"usage"`
	Sessions SessionsBlock `json:"sessions"`
}

type SessionsBlock struct {
	Total  int        `json:"total"`
	Oldest *time.Time `json:"oldest,omitempty"`
	Newest *time.Time `json:"newest,omitempty"`
	Error  string     `json:"error,omitempty"`
}

type Snapshot struct {
	Provider     ProviderID
	UsagePercent string
	Reset        string
	CreditsUsed  string
	CreditsTotal string
}

type Store struct {
	Root string
}

type StoredRecord struct {
	Record Record
	Path   string
}

type UsageBlock struct {
	OK         bool               `json:"ok"`
	Endpoint   string             `json:"endpoint,omitempty"`
	DurationMS int64              `json:"duration_ms"`
	Values     map[string]float64 `json:"values,omitempty"`
	Display    map[string]string  `json:"display,omitempty"`
	Error      string             `json:"error,omitempty"`
}