hermes - 💡(How to fix) Fix feat: use provider models config as whitelist in /model picker for custom providers [1 participants]

Problem

When a custom provider (via providers: in config.yaml) exposes an OpenAI-compatible /v1/models endpoint, the /model picker always fetches ALL models from the API, ignoring the models field in the provider config.

This is particularly problematic for platforms like Baidu Qianfan Coding Plan, where the API returns 100+ models (ERNIE series, open-source LLMs, image models, embedding models, etc.) even though the user only has access to 2-3 models in their plan.

Example config:

providers:
  baidu:
    base_url: https://qianfan.baidubce.com/v2/coding
    key_env: BAIDU_CODING_API_KEY
    models:
    - kimi-k2.5
    - glm-5

Expected behavior:

/model → select Baidu → shows 2 models (kimi-k2.5, glm-5)

Actual behavior:

/model → select Baidu → shows 100+ models from the full Qianfan catalog

Root Cause

In hermes_cli/main.py, _model_flow_named_custom() (line ~3284) unconditionally calls fetch_api_models(api_key, base_url) regardless of whether the provider has a configured models whitelist. The models field from config is preserved in the provider_info dict but never used for filtering.

Proposed Fix

Modify _model_flow_named_custom() to check for configured models first:

configured_models = provider_info.get("models", {})
if isinstance(configured_models, dict) and configured_models:
    models = list(configured_models.keys())
elif isinstance(configured_models, list) and configured_models:
    models = [str(m) for m in configured_models if isinstance(m, str) and m.strip()]
else:
    # No configured models — fetch from API (existing behavior)
    models = fetch_api_models(api_key, base_url, ...)

This requires also passing the models field through _named_custom_provider_map().

Additionally: when multiple providers expose the same model name (e.g., both Baidu and Alibaba have kimi-k2.5), the /model picker currently shows them without provider context, which can cause confusion. Consider adding provider disambiguation hints.

Environment

• Hermes Agent version: latest (git-installed)
• OS: macOS (Apple Silicon)
• Provider: Baidu Qianfan Coding Plan, Alibaba Bailian Coding Plan