# NousResearch/hermes-agent · Improve 429 rate-limit error messaging for users

## Open now

- 1 issue, 1 PR open on GitHub.
- #101445: fix(agent): surface actionable rate-limit hint when _final_response is built for a 429 - free-tier users currently see only "HTTP 429: Provider returned error"
- PR #101462: fix(agent): show recovery steps after rate limits exhaust retries

These items address surfacing actionable hints and recovery steps to users when rate-limit errors (HTTP 429) are encountered, rather than showing a bare error message. The work appears to span proposal, implementation, and a related pull request.

## TL;DR

- 3 member(s): 1 open issue(s), 0 closed issue(s), 1 open PR(s), 0 merged PR(s), 1 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.67`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Open related issues

- #101445: fix(agent): surface actionable rate-limit hint when _final_response is built for a 429 - free-tier users currently see only "HTTP 429: Provider returned error"

## Prior & competing PRs

- **#101462: fix(agent): show recovery steps after rate limits exhaust retries**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `agent/turn_recovery.py`, `tests/run_agent/test_run_agent.py`
- **#101486: fix(agent): surface actionable rate-limit hint on 429 final response (#101445)**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#101462`

## Fix status

- No merged fix on record.
- Subsystem: `agent`