What
- The rate-limit tracker gained a
restoreLimits(limits, observed)method that directly reinstates a previously-known limit status and fires a status-changed event, bypassing the normal derive/observation pipeline. - The "attach remote" flow now reads limit info (
limits,limitsObserved,limitsEpoch) at session start, and on teardown re-applies it if it changed (or resets it if the epoch moved on); resumed sessions now also seed rate-limit info from prior state, alongside other already-seeded state. - The CLI-facing query stream and the SDK/thin-client stream both now recognize a new
rate_limit_eventmessage type: they parse therate_limit_infopayload, strip outcanUserPurchaseCredits/hasChargeableSavedPaymentMethod, and forward the rest into emitted events, logging a warning and dropping invalid payloads. - Remote sessions gained adoption/settling machinery for these
rate_limit_eventframes: it seeds from prior rate-limit info, handles frames differently depending on whether they arrived via replay or live stream, and falls back to a default signal if catch-up truncates the history.
Why
This keeps your rate-limit status accurate and up to date across reconnects and session resumes, instead of losing that information when a session detaches and reattaches or streams through the SDK.
Names in the bundlerate_limit_event
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Confirmed since
Anthropic's documentation has since written up rate_limit_event, on Claude Code changelog.
- Improved headless `rate_limit_event` usage-limit warnings to say whether the account has extra usage turned onchangelog see the edit
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agrees
Anthropic's documentation has since written up rate_limit_event, on Claude Code changelog.