# NousResearch/hermes-agent · Python typing compatibility fixes for gateway/agent

## Open now

- Nothing open on GitHub.

These issues and PRs address typing compatibility problems, primarily restoring the required three-argument form of typing.Generator that caused gateway import failures on Python 3.11/3.12, with a related fix for forward reference quoting on pre-3.14 interpreters.

## TL;DR

- 4 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 2 PR(s) closed without merging.
- A fix was merged to main in PR #135781. Verify it addresses your case.
- **Recommended:** read PR #135781 (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: `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.50`: 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

- #135587: \[Bug\]: gateway fails to import on Python 3.11/3.12 after linter autofix (typing.Generator needs 3 args)

## Prior & competing PRs

- **#135781: fix: an interrupted update on a pre-3.14 interpreter can heal again (re-quote eager forward refs)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `agent/context_engine.py`, `agent/turn_scripted_prelude.py`, `cron/jobs.py`, `gateway/config.py`, `gateway/delivery.py`, `gateway/platforms/base.py`, `gateway/platforms/event.py`, `gateway/platforms/helpers.py`, `gateway/platforms/webhook.py`, `gateway/run.py`, `gateway/session.py`, `gateway/turn_lease.py`, `hermes_cli/banner.py`, `hermes_cli/local_runtime/hardware.py`, `hermes_cli/web_server_config.py`, `hermes_cli/web_server_lifecycle.py`, `hermes_cli/web_server_mcp.py`, `hermes_platform/host/gpu_adapters.py`, `hermes_state.py`, `hermes_state_readpool.py` (+20 more)
- **#135681: fix(agent): restore the third typing.Generator argument in the Prelude alias**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `a274d3388f8`, `8e0d1569f80`, `#135781`
- **#135805: fix(agent): keep the third typing.Generator argument so the gateway imports on 3.11/3.12**. closed without merge
  - maintainer direction: category `volume_quota`; implication `active`; refs `#135681`

## Fix status

- Merged to main in PR #135781 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-10-09`.
- Subsystem: `agent`