eiNUdZddlmZddlZddlmZddlmZmZm Z m Z m Z ddl m Z mZejeZedGd d Zid ed dd dded dddedddded dddded dddeddd d!d"ed d#$d%ed&d'$d(ed d)d*+d,ed d-.d/ed d0d1d23d4ed&d5.d6ed&d7.d8ed d9.d:ed d;.d<ed d=.d>ed d?ed dd@Aed ddBAed ddCAed ddDAeddEdFGed dHdIGed dJ.ed dKdLGed dM.ed dN.dO ZdPedQ<eGdRdSZidTd dUd(dVd(dWd(dXd(dYdZd[dZd\dZd]d^d_d^d`d^dad^dbd,dcd,ddd,ded,dfd/idgd/dhd6did6djd%dkd%dld"dmd"dnddod>dpd>dqd>drdsdtdsdudvdwdvdxdydzdyid{dyd|d8d}d:d~d:dd:dd:dd<dd<dd<dddddddddddddddddddddddddddddd Zded<dddddddddZded<dd&dddZded<ddZddZddZddZdddZddZddZddZ dddZ!dS)u Single source of truth for provider identity in Hermes Agent. Two data sources, merged at runtime: 1. **models.dev catalog** — 109+ providers with base URLs, env vars, display names, and full model metadata (context, cost, capabilities). This is the primary database. 2. **Hermes overlays** — transport type, auth patterns, aggregator flags, and additional env vars that models.dev doesn't track. Small dict, maintained here. 3. **User config** (``providers:`` section in config.yaml) — user-defined endpoints and overrides. Merged on top of everything else. Other modules import from this file. No parallel registries. ) annotationsN) dataclass)AnyDictListOptionalTuple)base_url_host_matchesbase_url_hostnameT)frozencheZdZUdZdZded<dZded<dZded <d Zd ed <d Z ded<d Z ded<dS) HermesOverlayz?Hermes-specific provider metadata layered on top of models.dev. openai_chatstr transportFbool is_aggregatorapi_key auth_typeTuple[str, ...]extra_env_varsbase_url_overridebase_url_env_varN) __name__ __module__ __qualname____doc__r__annotations__rrrrrr6/home/div/.hermes/hermes-agent/hermes_cli/providers.pyrr"sII"I""""MI&(N((((r!r openrouterr)OPENAI_API_KEYOPENROUTER_BASE_URL)rrrrnousoauth_device_codez)https://inference-api.nousresearch.com/v1)rrr openai-codexcodex_responsesoauth_externalz%https://chatgpt.com/backend-api/codexz qwen-oauthzhttps://portal.qwen.ai/v1HERMES_QWEN_BASE_URL)rrrrzgoogle-gemini-clizcloudcode-pa://google copilot-acpexternal_processz acp://copilotCOPILOT_ACP_BASE_URLzgithub-copilot)COPILOT_GITHUB_TOKENGH_TOKEN)rr anthropicanthropic_messages)ANTHROPIC_TOKENCLAUDE_CODE_OAUTH_TOKENzai) GLM_API_KEY ZAI_API_KEY Z_AI_API_KEY GLM_BASE_URL)rrrzkimi-for-coding KIMI_BASE_URL)rrstepfun)STEPFUN_API_KEYz#https://api.stepfun.ai/step_plan/v1STEPFUN_BASE_URL)rrrrminimaxMINIMAX_BASE_URLz minimax-cnMINIMAX_CN_BASE_URLdeepseekDEEPSEEK_BASE_URLalibabaDASHSCOPE_BASE_URLzalibaba-coding-planALIBABA_CODING_PLAN_BASE_URLvercel)rrOPENCODE_ZEN_BASE_URL)rrrOPENCODE_GO_BASE_URLKILOCODE_BASE_URL HF_BASE_URLzhttps://api.x.ai/v1 XAI_BASE_URL)rrrz#https://integrate.api.nvidia.com/v1NVIDIA_BASE_URLXIAOMI_BASE_URLzhttps://api.arcee.ai/api/v1ARCEE_BASE_URLOLLAMA_BASE_URLAZURE_FOUNDRY_BASE_URL) opencode opencode-gokilo huggingfacexainvidiaxiaomiarcee ollama-cloudz azure-foundryzDict[str, HermesOverlay]HERMES_OVERLAYSceZdZUdZded<ded<ded<ded<dZded <dZded <d Zd ed <dZded<dZ ded<dZ ded<dS) ProviderDefu9Complete provider definition — merged from all sources.ridnamerrapi_key_env_varsrbase_urlrFrrrrdocsourceN) rrrrr r`rrrrarbrr!r"r\r\sCC GGG IIINNN%%%%HMICMMMMFr!r\openaiglmzz-aizz.aizhipuzx-airUzx.aigroknimrVz nvidia-nimz build-nvidianemotronkimiz kimi-codingzkimi-coding-cnmoonshotstepzstepfun-coding-planz minimax-china minimax_cnclaudez claude-codecopilotgithubzgithub-copilot-acpz ai-gateway aigatewayzvercel-ai-gatewayz opencode-zenrQzengorRzopencode-go-subkilocoderSz kilo-codez kilo-gatewayz deep-seek dashscopealiyunqwenz alibaba-cloudalibaba_codingzalibaba-codingalibaba_coding_planz gemini-cliz gemini-oauthhfrTz hugging-facezhuggingface-hubmimorWz xiaomi-mimoawsbedrockrXlmstudiocustomlocal) z aws-bedrockzamazon-bedrockamazonzarcee-aiarceeair}z lm-studio lm_studioollamavllmllamacppz llama.cppz llama-cppzDict[str, str]ALIASESz Nous Portalz OpenAI CodexzGitHub Copilot ACPzStepFun Step Planz Xiaomi MiMozLocal endpointz AWS Bedrockz Ollama Cloud)r&r(r,r;rWrr|rY_LABEL_OVERRIDESchat_completionsbedrock_converse)rr2r)rTRANSPORT_TO_API_MODEr^rreturnc|}t||S)zResolve aliases and normalise casing to a canonical provider id. Returns the canonical id string. Does *not* validate that the id corresponds to a known provider. )striplowerrget)r^keys r"normalize_providerrTs1 **,,    C ;;sC  r!Optional[ProviderDef]c t|} ddlm}||}n#t$rd}YnwxYwt|}||r|jnd}|r|jnd}|r|jnd}|r|j nd}|r|j nd} t|j } |r*|j r#|j D]} | | vr| | t||j|t#| | p|j||||jd S|Ot|t(|||j|j |j |j |j|jd SdS) aALook up a built-in provider by id or alias. Resolution order: 1. Hermes overlays (for providers not in models.dev: nous, openai-codex, etc.) 2. models.dev catalog + Hermes overlay User-defined providers from config.yaml (``providers:`` / ``custom_providers:``) are resolved by :func:`resolve_provider_full`, which layers ``resolve_user_provider`` and ``resolve_custom_provider`` on top of this function. Callers that need user-config support should use ``resolve_provider_full`` instead. Returns a fully-resolved ProviderDef or None. rget_provider_infoNrFrr models.dev) r]r^rr_r`rrrrarbhermes) r]r^rr_r`rrrrb)ragent.models_devr ExceptionrZrrrrrrlistenvrappendr\r^tupleapirar) r^ canonical_mdev_provider mdev_infooverlayris_aggauth base_url_envrenv_varsevs r" get_providerr^s#4((IHHHHHH"N9--  !!),,G)0CG%%m *1<&&u$+:w  3:Bw// 9@HG55b &&  (w- (, ( (X%%OOB'''"8__&7)-)      !%%i;;'$3.$5!/'     4s # 22 provider_idct|}|tvr t|St|}|r|jS|S)z1Get a human-readable display name for a provider.)rrrr^)rrpdefs r" get_labelrsM";//I$$$ **  " "D y r!providerrc6t|}|r|jndS)z:Return True when the provider is a multi-model aggregator.F)rr)rrs r"rrs"  ! !D!% 04  50r!rr`c8t|}|p|rN|d}d|vrdS|dsd|vrdSd|vrdSt|jd S|d krd S|r|d}t|}|ds|dkrdS|d krd |vrdS|dkrdS|drt|drd Sd S)uDetermine the API mode (wire protocol) for a provider/endpoint. Resolution order: 1. Known provider → transport → TRANSPORT_TO_API_MODE. 2. URL heuristics for unknown / custom providers. 3. Default: 'chat_completions'. N/zapi.kimi.com/codingr2z /anthropiczapi.anthropic.comzapi.openai.comr)rr|rz api.kimi.comz/codingzbedrock-runtime.z amazonaws.com) rrstriprendswithrrrr startswithr )rr`r url_lowerhostnames r"determine_api_modersq  ! !D   ) ,,2244I$ 11++!!,// ,3F)3S3S++9,,(($((9KLLL9!! &OOC((..00 $X..   l + + (x;N/N/N'' ~ % %)y*@*@'' ' ' '$$   1 2 2 &7LXWf7g7g &%%  r! user_configDict[str, Any]c |rt|tsdS||}t|tsdS|ddp|}|ddp-|ddp|ddpd}|ddpd}|dd pd }g}|r||t |||t ||d d d S)zResolve a provider from the user's config.yaml ``providers:`` section. Args: name: Provider name as given by the user. user_config: The ``providers:`` dict from config.yaml. Returns: ProviderDef if found, else None. Nr^rrurlr`key_envrrFr user-configr]r^rr_r`rrrb) isinstancedictrrr\r)r^rentry display_nameapi_urlrrrs r"resolve_user_providerrs( jd;;t OOD ! !E eT " "t99VR((0DLiir""]eiir&:&:]eii TV>W>W][]Gii 2&&,"G +}55FIH!     x    r!rc|d|ddzS)zBuild a canonical slug for a custom_providers entry. Matches the convention used by runtime_provider and credential_pool (``custom:``). Centralised here so all call-sites produce identical slugs. zcustom: -)rrreplace)rs r"custom_provider_slugrs7 |))++1133;;CEE EEr!custom_providersOptional[List[Dict[str, Any]]]c N|rt|tsdS|pd}|sdS|D]}t|ts|dpd}|ddp-|ddp|ddpd}|r|st |}|||hvrt||dd|d d d cSdS) zIResolve a provider from the user's config.yaml ``custom_providers`` list.Nrr^r`rrrrFrrr)rrrrrrrr\)r^r requestedrrrslugs r"resolve_custom_providerrsl :.>#E#Et""$$**,,I t!  %&&   &))/R6688 IIj" % % yy## yy##  %''   7  #L11 \//1148 8 8 #      4r!user_providersOptional[Dict[str, Any]]ct|}t|}||S|rLt||}||St||}||St ||}||S ddlm}||}|$t||j d|j |j dSn#t$rYnwxYwdS)uFull resolution chain: built-in → models.dev → user config. This is the main entry point for --provider flag resolution. Args: name: Provider name or alias. user_providers: The ``providers:`` dict from config.yaml (optional). custom_providers: The ``custom_providers:`` list from config.yaml (optional). Returns: ProviderDef if found, else None. Nrrrr)r]r^rr_r`rb) rrrrrrrrr\r^rrr) r^rrrr user_pdef custom_pdefrrs r"resolve_provider_fullrEs&"#4((I  " "D  ))^DD   )$**,,*<*<*>*>OO   *$0@AAK  HHHHHH"N9--  ^'!*"#   !       4s6B>> C  C )r^rrr)r^rrr)rrrr)rrrr)r)rrr`rrr)r^rrrrr)rrrr)r^rrrrr)NN)r^rrrrrrr)"r __future__rlogging dataclassesrtypingrrrrr utilsr r getLoggerrloggerrrZr r\rrrrrrrrrrrrrr!r"rs &#"""""!!!!!!33333333333333::::::::  8 $ $  $B---*. B- MM%E   B-MM#"AB-"--"5/ #B-."1/B-8==#$)/ 9B-Dmm;EB-L&EMB-T ==E'   UB-^}}(_B-f}}+?+ gB-r}}&+sB-z--&.{B-B ,CB-J}}-KB-R==7SB-Z mm[B-b 0 !=/ M,    !=& =#/'    m?* m*]7) "M* #]1}B-B-B-BBBBP          &k lk  5 k  E k Ek Uk Ek Ek Ek  8!k"(#k$H%k&'k, -k.$/k0'1k2!3k8 I9kk:9;k@\AkB,CkH kIkJ;KkPQkR SkT-UkZ([k\]k^_kdJekf :gkl -mkn}oktukvwkkkxFyk~kDEkF iGkH IIkJYKkL+MkN+OkP0QkV%WkX'Yk` -akbMckd}ekj Hkkl8mkr 9skkt Ukkkkkkkf "'" " $ $    &.(* ))!!!!CCCCL    $1111 '''''X$$$$NFFFF))))\047;8888888r!