# NousResearch/hermes-agent · Vertex AI support in auxiliary tasks and doctor

## Open now

- 2 issues, 9 PRs open on GitHub.
- #56906: \[Bug\]: \`hermes doctor\` fails when using the new vertex provider
- #66674: Auxiliary client cannot use Vertex AI — the auth_type="vertex" ADC branch is unreachable (vertex missing from PROVIDER_REGISTRY)
- PR #56843: fix(aux): use auth_type-aware error message for missing credentials (#56810)
- PR #56861: Fix auxiliary Vertex provider resolution
- PR #56930: fix(doctor): recognize plugin-registered providers like vertex
- PR #56939: fix(doctor): stop false positives on vertex configs
- PR #57154: fix(doctor): recognize vertex provider config
- PR #59679: fix(doctor): recognize provider-profile-only providers like vertex
- PR #61933: fix(auth): register vertex in PROVIDER_REGISTRY for auxiliary clients
- PR #62444:  register vertex in PROVIDER_REGISTRY to enable auxiliary tasks
- PR #125846: fix(cli): stop doctor flagging vendor/model IDs on vertex, novita and gmi

These issues and PRs concern Vertex AI being absent from the provider registry, causing auxiliary tasks to fail and the doctor command to misreport or error on Vertex configurations. Multiple fixes address registry registration, auth-type-aware error messages, and provider recognition in diagnostics.

## TL;DR

- 20 member(s): 2 open issue(s), 2 closed issue(s), 9 open PR(s), 1 merged PR(s), 6 PR(s) closed without merging.
- A fix was merged to main in PR #115884. Verify it addresses your case.
- **Recommended:** read PR #115884 (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: `partially_resolved` · deciding PR(s): `pr-115884`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.10`: 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

- #56906: \[Bug\]: \`hermes doctor\` fails when using the new vertex provider
- #66674: Auxiliary client cannot use Vertex AI — the auth_type="vertex" ADC branch is unreachable (vertex missing from PROVIDER_REGISTRY)

## Closed / duplicate issues

- #56810: Misleading "API key was found" RuntimeError for non-API-key OAuth/ADC providers in auxiliary tasks
- #61852: \[Bug\]: Every auxiliary task silently fails on \`provider: vertex\`

## Prior & competing PRs

- **#62440: fix(aux): resolve Vertex AI provider for auxiliary tasks**. closed without merge · fix tier `suggested`
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `c73e74386b20164fa218414131fe8b03f07b3e7c`
  - _suggested-tier fix detail withheld; re-request with `?tier=all` to include it._
- **#115884: fix(auth): exhausted OAuth credential pool reports the cooldown and reset time instead of "no credentials found" (#56810)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `agent/auxiliary_unavailable.py`, `tests/agent/test_missing_provider_credentials_hint.py`
- **#56842: fix(agent): clarify auxiliary provider auth failures**. closed without merge
  - maintainer direction: category `uncategorized`; implication `needs_llm`
- **#56843: fix(aux): use auth_type-aware error message for missing credentials (#56810)**. open
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#56842`, `#56810`, `#56842`
  - files: `agent/auxiliary_client.py`, `tests/agent/test_auxiliary_auth_type_hint_56810.py`
- **#56861: Fix auxiliary Vertex provider resolution**. open
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#56810`, `#56842`, `#56843`, `#56842`, `#56688`
  - files: `agent/auxiliary_client.py`, `tests/agent/test_auxiliary_client.py`
- **#56863: fix(agent): clarify auxiliary OAuth provider credential errors**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#56842`
- **#56930: fix(doctor): recognize plugin-registered providers like vertex**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `hermes_cli/doctor.py`, `hermes_cli/providers.py`, `tests/hermes_cli/test_doctor.py`
- **#56939: fix(doctor): stop false positives on vertex configs**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `977ad1abc677`, `#56906`, `#56906`, `#56906`
  - files: `hermes_cli/doctor.py`, `tests/hermes_cli/test_doctor.py`
- **#56962: fix(doctor): recognize Vertex provider profiles**. closed without merge
  - maintainer direction: category `uncategorized`; implication `needs_llm`
- **#57154: fix(doctor): recognize vertex provider config**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `afe70d643c3b`, `#56906`, `#56906`, `#56906`
  - files: `hermes_cli/doctor.py`, `tests/hermes_cli/test_doctor.py`
- **#59679: fix(doctor): recognize provider-profile-only providers like vertex**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `hermes_cli/doctor.py`, `tests/hermes_cli/test_doctor.py`
- **#61933: fix(auth): register vertex in PROVIDER_REGISTRY for auxiliary clients**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `agent/auxiliary_client.py`, `contributors/emails/[redacted:email]`, `tests/agent/test_vertex_provider_registry.py`
- **#62444:  register vertex in PROVIDER_REGISTRY to enable auxiliary tasks**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `agent/auxiliary_client.py`, `hermes_cli/auth.py`, `tests/hermes_cli/test_vertex_provider.py`
- **#62700: fix(aux): register vertex in PROVIDER_REGISTRY and add vertex aliases (#61852)**. closed without merge
  - maintainer direction: category `duplicate_of`; implication `duplicate`
- **#66707: fix(registry): add vertex to PROVIDER_REGISTRY so auxiliary clients can use ADC**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`
- **#125846: fix(cli): stop doctor flagging vendor/model IDs on vertex, novita and gmi**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `hermes_cli/doctor_config.py`, `tests/hermes_cli/test_doctor.py`

## Fix status

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