Summary

• detect malformed proxy environment variables before Hermes/OpenAI/httpx client initialization
• raise a clear runtime error naming the broken proxy env var instead of surfacing only Invalid port
• add regression tests for malformed inherited proxy URLs and malformed custom endpoint URLs

Root cause

I initially suspected a malformed persisted custom endpoint URL because the user-facing error was:

• Invalid port: 6153export

But after the reporter shared their redacted config files, the diagnosis changed:

• config.yaml was clean
• auth.json was clean
• I could not find any persisted 6153export value in uploaded config/auth data

I then reproduced the exact failure by setting a malformed proxy environment variable such as:

• HTTP_PROXY=http://127.0.0.1:6153export

That triggers the same stack trace through httpx / openai client creation:

• InvalidURL
• Invalid port: '6153export'

So the stronger root cause for issue #6360 is malformed inherited proxy env, not a saved custom endpoint URL.

Fix

• validate HTTP_PROXY, HTTPS_PROXY, ALL_PROXY (and lowercase variants) before creating OpenAI-compatible clients
• validate both:
  • the main runtime client path in run_agent.py
  • the auxiliary/provider-resolution path in agent/auxiliary_client.py
• produce a clear Hermes error message like:
  • Malformed proxy environment variable HTTP_PROXY='http://127.0.0.1:6153export'. Fix or unset your proxy settings and try again.

Validation

Direct reproduction used during investigation:

• with malformed HTTP_PROXY=http://127.0.0.1:6153export
• before fix: raw httpx.InvalidURL: Invalid port: '6153export'
• after fix: clear Hermes RuntimeError identifying the broken proxy env var

Automated checks run locally:

• pytest tests/run_agent/test_endpoint_and_proxy_validation.py -q -o addopts=
• python -m py_compile run_agent.py agent/auxiliary_client.py tests/run_agent/test_endpoint_and_proxy_validation.py

Notes

• This PR supersedes the earlier custom-endpoint-only diagnosis for issue [Setup]: I use quick to install the configured custom model, and then I enter hello to display Failed to initialize agent: Failed to initialize OpenAI client: Invalid port: 6153export #6360.
• Custom endpoint validation is still useful hardening, but the uploaded user evidence pointed much more strongly to malformed proxy env as the direct issue trigger.

Closes #6360