usage

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

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

type AuthKind string

type CacheWritePrice struct {
	TTLSeconds int64   `json:"ttl_seconds"`
	PerMTok    float64 `json:"per_mtok"`
}

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

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

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

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

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

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

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

type LongContextPrice struct {
	InputTokensAbove int64   `json:"input_tokens_above"`
	InputMultiplier  float64 `json:"input_multiplier"`
	OutputMultiplier float64 `json:"output_multiplier"`
}

type ModelPrice struct {
	InputPerMTok       float64           `json:"input_per_mtok"`                 // Non-cached input (cache miss).
	CachedInputPerMTok float64           `json:"cached_input_per_mtok"`          // Cache read (cache hit).
	CacheWritePerMTok  float64           `json:"cache_write_per_mtok,omitempty"` // Cache creation; 0 = same as input.
	CacheWritePrices   []CacheWritePrice `json:"cache_write_prices,omitempty"`   // Overrides for exact applied lifetimes.
	OutputPerMTok      float64           `json:"output_per_mtok"`
	LongContext        LongContextPrice  `json:"long_context,omitzero"`
}

type ModelPricer interface {
	// ModelPrice returns the per-million-token USD price for modelID that is
	// in effect at at, and whether the model is priced at all. Routing and
	// vendor prefixes are ignored when the model has a published schedule.
	// Subscription-backed providers price at their API-equivalent rates.
	ModelPrice(modelID string, at time.Time) (ModelPrice, bool)
}

type ModelPricing []PriceTier

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

type PeakWindow struct {
	// Days restricts the window to these weekdays; nil means every day.
	Days []time.Weekday
	// Holidays lists UTC dates (YYYY-MM-DD) on which the window does not
	// apply. The peak windows span 01:00-10:00 UTC (09:00-18:00 Beijing), so
	// a holiday's Beijing calendar date matches the UTC date the window
	// falls on.
	Holidays []string
	Start    string // "HH:MM" UTC, inclusive.
	End      string // "HH:MM" UTC, exclusive.
}

type PriceTier struct {
	// EffectiveFrom is the inclusive UTC date (YYYY-MM-DD) from which the
	// tier applies; empty means since always.
	EffectiveFrom string
	// PeakWindows restricts the tier to these daily UTC windows. When empty
	// the tier is the base price that applies outside every peak window of
	// the same effective date.
	PeakWindows []PeakWindow
	// Price is the per-million-token USD price the tier charges.
	Price ModelPrice
}

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

type PricingPhase string

type ProviderFetcher interface {
	// Provider returns the provider identifier (e.g. "anthropic", "deepseek").
	Provider() agent.QuotaProvider
	// Label returns a human-readable provider name (e.g. "Anthropic", "DeepSeek").
	Label() string
	// AuthKind returns the provider authentication method.
	AuthKind() AuthKind
	// UsageURL returns the link to the provider's usage/billing page.
	UsageURL() string
	// Get returns the latest quota data, using cached values when fresh.
	Get(ctx context.Context) *ProviderQuota
}

type ProviderQuota struct {
	Provider   agent.QuotaProvider
	Label      string
	AuthKind   AuthKind
	FetchedAt  time.Time
	FetchError bool

	RateLimits []QuotaRateLimit
	// UnassessedWindows cannot establish capacity; amounts are not fractions.
	UnassessedWindows []UnassessedQuotaWindow
	// Balance is the provider's money snapshot. Some providers, such as
	// Anthropic, report it as "extra usage" on top of the subscription
	// instead of a prepaid wallet balance.
	Balance QuotaBalance
}

type QuotaBalance struct {
	Currency string
	Total    float64
	Granted  float64
	ToppedUp float64

	// ExtraEnabled reports whether the pay-as-you-go spend cap is active.
	// UsedCredits and MonthlyLimit report the cap, and Utilization is the
	// fraction of it used in [0, 1].
	ExtraEnabled bool
	UsedCredits  float64
	MonthlyLimit float64
	Utilization  float64
}

type QuotaRateLimit struct {
	Label       string // Optional display label; the API defaults it to Window.
	Window      string
	Utilization float64 // Fraction of the window used in [0, 1].
	ResetsAt    time.Time
}

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

type TaskQuotaUpdate struct {
	Provider      agent.QuotaProvider
	ProviderLabel string
	Window        string
	Status        agent.RateLimitStatus
	Utilization   float64 // Fraction of the window used in [0, 1]; -1 when the harness reported only a status change.
	ResetsAt      time.Time
	ObservedAt    time.Time
}

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

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

type UnassessedQuotaWindow struct {
	Group  string
	Window string
}

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

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