# NousResearch/hermes-agent · Telegram polling heartbeat NetworkError reconnect handling

## Open now

- Nothing open on GitHub.

A bug was identified where python-telegram-bot NetworkError and TimedOut exceptions raised during the polling heartbeat were not being routed into the reconnect path. These members address classifying and routing those transport errors to trigger reconnection properly.

## TL;DR

- 6 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 4 PR(s) closed without merging.
- A fix was merged to main in PR #62098. Verify it addresses your case.
- **Recommended:** read PR #62098 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `resolved` · deciding PR(s): `pr-62098`. 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.40`: 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.

## Closed / duplicate issues

- #62047: \[Bug\]: Telegram polling heartbeat swallows python-telegram-bot NetworkError, so reconnect is never triggered

## Prior & competing PRs

- **#62098: fix(telegram): classify PTB heartbeat transport errors**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `plugins/platforms/telegram/adapter.py`, `tests/gateway/conftest.py`, `tests/gateway/test_telegram_network_reconnect.py`
- **#62104: fix(telegram): PTB NetworkError/TimedOut in heartbeat reconnect path (#62047)**. closed without merge · fix tier `suggested`
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `97fb9e1f6`, `90bd5b0f9`
- **#62106: fix(telegram): PTB NetworkError/TimedOut in heartbeat reconnect path (engine-on pilot, mirrors #62104) (#62047)**. closed without merge · fix tier `suggested`
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `97fb9e1f6`, `90bd5b0f9`, `#62104`
- **#62060: fix(telegram): route PTB NetworkError to reconnect ladder in polling heartbeat**. closed without merge
  - maintainer direction: category `silent_close`; implication `active`
- **#63007: fix(telegram): route PTB NetworkError/TimedOut from polling heartbeat into reconnect path (#62047)**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `#62098`, `#62047`, `#62104`, `#62106`, `#62098`

## Fix status

- Merged to main in PR #62098 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-07-10`.