PR #13423: feat(cli): persist explicit api_mode for manual custom endpoints

• Repository: NousResearch/hermes-agent
• Author: mslovy
• State: open | merged: False
• Link: https://github.com/NousResearch/hermes-agent/pull/13423

Description (problem / solution / changelog)

Summary

Manual custom endpoint setup now supports explicit api_mode selection.

Hermes already supports explicit transport routing such as codex_responses at runtime, but the manual custom endpoint flow did not expose that setting. It always relied on URL-based detection and cleared any explicit api_mode during save.

That made some OpenAI-compatible relays and gateways hard to configure through the CLI. A common example is CCH-style proxies: the base URL does not look like the official OpenAI/Codex endpoint, so Hermes falls back to chat_completions, while some relays only support codex_responses. Refer to Issue: https://github.com/NousResearch/hermes-agent/issues/13415

This change adds an explicit API mode prompt to the manual custom endpoint flow so users can choose the transport they need without depending entirely on URL heuristics.

Changes

• Added an explicit API mode prompt to the manual custom endpoint flow in hermes_cli/main.py
• Supported the following choices:
  • auto
  • chat_completions
  • codex_responses
  • anthropic_messages
• Persisted explicit selections to model.api_mode
• Persisted the same selection to the saved custom_providers entry for the endpoint
• Kept auto behavior as “unset”, so existing URL-based detection continues to work as before
• Cleared stale saved api_mode values when the same endpoint is reconfigured back to auto
• Kept existing saved-provider behavior unchanged: no new editing UI was added for named saved providers
• Added regression coverage in tests/cli/test_cli_provider_resolution.py for:
  • explicit codex_responses persistence
  • clearing stale api_mode when switching back to auto
  • updating an existing saved custom endpoint entry

Validation

Ran:

• scripts/run_tests.sh tests/cli/test_cli_provider_resolution.py tests/hermes_cli/test_custom_provider_model_switch.py tests/hermes_cli/test_runtime_provider_resolution.py tests/hermes_cli/test_update_config_clears_custom_fields.py -q

Result:

• 98 passed

Changed files

• hermes_cli/main.py (modified, +101/-4)
• tests/cli/test_cli_provider_resolution.py (modified, +186/-2)