usage

type Accounts ¶ added in v0.19.2

type Accounts interface {
	List(context.Context) ([]accounts.Account, error)
	Usage(ctx context.Context, provider, id string) (Snapshot, error)
	Use(ctx context.Context, provider, id string) error
}

Accounts is the host's account book: its connected accounts, their plan limits, and the switch between them. A plugin offers another account when one runs out only where the host supplies it.

type Cache ¶

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

Cache bounds quota history to 64 account keys and coalesces concurrent reads. Keys are caller-owned account identities or credential digests, never raw credentials.

func (c *Cache) Clear()

func (c *Cache) Fetch(ctx context.Context, key string, fetch func(context.Context) (Snapshot, error)) (Snapshot, error)

func (c *Cache) Peek(key string) (Snapshot, bool)

type Client ¶

type Client struct {
	Cache                   *Cache
	HTTPClient              *http.Client
	CodexURL, OpenCodeGoURL string
}

Client reads provider-reported quota only. URLs are injectable for tests and private deployments; credentials never follow redirects.

func (c Client) Fetch(ctx context.Context, provider string, credential auth.ModelAuth) (Snapshot, error)

func (c Client) Reads(provider string) bool

type Reading ¶ added in v0.19.2

type Reading struct {
	Provider string
	Snapshot Snapshot
}

type Snapshot ¶

type Snapshot struct {
	Plan      string    `json:"plan,omitempty"`
	Windows   []Window  `json:"windows"`
	CheckedAt time.Time `json:"checked_at,omitzero"`
}

func (u Snapshot) Summary() string

type Window ¶

type Window struct {
	Name      string    `json:"name"`
	Remaining float64   `json:"remaining"` // percent
	ResetsAt  time.Time `json:"resets_at,omitzero"`
}

Window and Snapshot are also Bridge wire: an instance describes its provider's limits with them.