Chat info: account quota per harness (Claude rate_limit_event, Codex account/rateLimits, OpenCode unsupported)

Usage frames carry optional usage.account {harness, source, plan, as_of,
windows[{id,label,used_percent,resets_at}], unsupported}. Claude Code quota
comes from its rate_limit_event stream lines and the initialize account
(plan), shared across chats on the same account. Codex reads
account/rateLimits/read once per connection (re-read when a chat opens after
5 min) and merges account/rateLimits/updated. OpenCode exposes no quota API
and says so. The app's chat info sheet shows an Account usage section with a
progress bar and reset countdown per window, Material and Cupertino.
This commit is contained in:
2026-11-02 18:57:13 +00:00
parent 8a402c1114
commit 10049b8062
26 changed files with 1469 additions and 19 deletions
+40
View File
@@ -594,6 +594,46 @@ type ChatUsage struct {
// RateBasis distinguishes a generation interval from a whole turn (which
// can include tools/waits). Never estimate tokens from text/character counts.
RateBasis string `json:"rate_basis,omitempty"`
// Account is the latest account quota the harness reported (or a note that
// it has no quota API). It is account state, not session state: a snapshot
// carries the latest value known when it was sent. Nil means unknown.
Account *ChatAccountUsage `json:"account,omitempty"`
}
// ChatAccountUsage is a harness account's subscription quota as the harness
// itself reported it. Nothing is estimated: windows are only those the
// harness named, and Unsupported says the harness exposes no quota at all.
type ChatAccountUsage struct {
// Harness is the display name ("Claude Code", "Codex", "OpenCode").
Harness string `json:"harness"`
// Source names the native report, e.g. "rate_limit_event".
Source string `json:"source,omitempty"`
// Plan is the harness's plan identifier when it reports one ("max", "plus").
Plan string `json:"plan,omitempty"`
// AsOf is when the server received the report (epoch milliseconds).
AsOf int64 `json:"as_of,omitempty"`
Windows []ChatQuotaWindow `json:"windows,omitempty"`
Unsupported bool `json:"unsupported,omitempty"`
}
// ChatQuotaWindow is one rolling quota window. UsedPercent is 0-100 (it can
// exceed 100 when the harness says usage ran past the cap); ResetsAt is epoch
// milliseconds, 0 when the harness did not say.
type ChatQuotaWindow struct {
ID string `json:"id"`
Label string `json:"label"`
UsedPercent float64 `json:"used_percent"`
ResetsAt int64 `json:"resets_at,omitempty"`
}
// Clone returns a deep copy (nil stays nil).
func (a *ChatAccountUsage) Clone() *ChatAccountUsage {
if a == nil {
return nil
}
copy := *a
copy.Windows = append([]ChatQuotaWindow(nil), a.Windows...)
return &copy
}
// ChatShell is the state of one shell command the agent started, carried by a
+25
View File
@@ -20,3 +20,28 @@ func TestChatUsageUnknownAndReportedZeroAreDistinct(t *testing.T) {
}
}
}
func TestChatAccountUsageWireShapeAndClone(t *testing.T) {
if data, _ := json.Marshal(ChatUsage{}); strings.Contains(string(data), "account") {
t.Fatalf("unknown account quota was serialized: %s", data)
}
account := &ChatAccountUsage{Harness: "Codex", Source: "account/rateLimits", Plan: "plus", AsOf: 1700000000000,
Windows: []ChatQuotaWindow{{ID: "primary", Label: "5-hour", UsedPercent: 0, ResetsAt: 1700000600000}}}
data, _ := json.Marshal(ChatUsage{Account: account})
want := `{"account":{"harness":"Codex","source":"account/rateLimits","plan":"plus","as_of":1700000000000,"windows":[{"id":"primary","label":"5-hour","used_percent":0,"resets_at":1700000600000}]}}`
if string(data) != want {
t.Fatalf("wire = %s\nwant %s", data, want)
}
copy := account.Clone()
copy.Windows[0].UsedPercent = 50
if account.Windows[0].UsedPercent != 0 {
t.Fatal("clone shares windows")
}
if (*ChatAccountUsage)(nil).Clone() != nil {
t.Fatal("nil clone")
}
unsupported, _ := json.Marshal(ChatAccountUsage{Harness: "OpenCode", Unsupported: true})
if string(unsupported) != `{"harness":"OpenCode","unsupported":true}` {
t.Fatalf("unsupported wire = %s", unsupported)
}
}