iNBUdZddlmZddlZddlmZddlmZmZm Z m Z m Z ej e ZedGdd Zid ed dd d ded dddedddded ddddeddddded d !d"ed#d$!d%ed d&d'(d)ed d*+d,ed#d-+d.ed#d/+d0ed d1+d2ed d3+d4ed d5d6ed dd78d9ed dd:8d;ed dd<8ed dd=8ed d>d?@ed dA+ed dBdC@dDZdEedF<eGdGdHZidId dJd%dKd%dLd%dMd%dNdOdPdOdQd)dRd)dSd)dTd)dUd.dVd.dWd"dXd"dYddZdid[dd\d4d]d4d^d4d_d6d`d6dad9dbd9dcd;ddd;ded;dfd0dgd2dhd2did2djd2dkdldldldmdmdndndodododpdqdqdqdqdrZdsedt<dudvdwdxdydzZdsed{<d|d#dd}Zdsed~<ddZddZddZddZdddZddZddZddZ dddZdS)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)AnyDictListOptionalTupleT)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__rrrrrr2/root/.hermes/hermes-agent/hermes_cli/providers.pyr r sII"I""""MI&(N((((rr 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)rrrr 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)rrminimaxMINIMAX_BASE_URLz minimax-cnMINIMAX_CN_BASE_URLdeepseekDEEPSEEK_BASE_URLalibabaDASHSCOPE_BASE_URLvercel)rropencodeOPENCODE_ZEN_BASE_URL)rrrz opencode-goOPENCODE_GO_BASE_URLkiloKILOCODE_BASE_URL HF_BASE_URLzhttps://api.x.ai/v1 XAI_BASE_URL)rrrXIAOMI_BASE_URLzhttps://api.arcee.ai/api/v1ARCEE_BASE_URL) huggingfacexaixiaomiarceezDict[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) rrrrrrTrrrrUrVrrr rPrPsCC GGG IIINNN%%%%HMICMMMMFrrPopenaiglmzz-aizz.aizhipuzx-airKzx.aikimiz kimi-codingzkimi-coding-cnmoonshotz minimax-china minimax_cnclaudez claude-codecopilotgithubzgithub-copilot-acpz ai-gateway aigatewayzvercel-ai-gatewayz opencode-zenzengozopencode-go-subkilocodez kilo-codez kilo-gatewayz deep-seek dashscopealiyunqwenz alibaba-cloudhfrJrLrMlmstudioz ollama-cloudlocal)z hugging-facezhuggingface-hubmimoz xiaomi-mimozarcee-aiarceeairhz lm-studio lm_studioollamavllmllamacppz llama.cppz llama-cppzDict[str, str]ALIASESz Nous Portalz OpenAI CodexzGitHub Copilot ACPz Xiaomi MiMozLocal endpoint)r$r&r*rLri_LABEL_OVERRIDESchat_completions)r r0r'TRANSPORT_TO_API_MODErRrreturnc|}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. )striplowerrpget)rRkeys r normalize_providerrzs1 **,,    C ;;sC  rOptional[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) aILook up a provider by id or alias, merging all data sources. Resolution order: 1. Hermes overlays (for providers not in models.dev: nous, openai-codex, etc.) 2. models.dev catalog + Hermes overlay 3. User-defined providers from config (TODO: Phase 4) Returns a fully-resolved ProviderDef or None. rget_provider_infoNr Frr models.dev) rQrRrrSrTrrrrUrVhermes) rQrRrrSrTrrrrV)rzagent.models_devr~ ExceptionrNrxrrrrrlistenvrappendrPrRtupleapirUrq) rR 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.)rzrqrrR)rrpdefs r get_labelrcsM";//I$$$ **  " "D y rproviderrc6t|}|r|jndS)z:Return True when the provider is a multi-model aggregator.F)rr)rrs r rrus"  ! !D!% 04  50rrrTct|}| t|jdS|rH|d}|dsd|vrdSd|vrdSdS) 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'. Nrr/z /anthropiczapi.anthropic.comr0zapi.openai.comr')rrsrxrrstriprwendswith)rrTr url_lowers r determine_api_moder{s  ! !D $((9KLLL%OOC((..00   l + + (/Bi/O/O'' y ( ($$  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. NrRrrurlrTkey_envrr Fr user-configrQrRrrSrTrrrV) isinstancedictrxrrPr)rRrentry display_nameapi_urlrrrs r resolve_user_providerrs( jd;;t OOD ! !E eT " "t99VR((0DLiir""]eiir&:&:]eii TV>W>W][]Gii 2&&,"G +}55FIH!     x    rrc|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: -)rvrwreplace)rs r custom_provider_slugrs7 |))++1133;;CEE EErcustom_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.NrrRrTrrr rFrrr)rrrvrwrrxrrP)rRr requestedrrrslugs r resolve_custom_providerrsl :.>#E#Et""$$**,,I t!  %&&   &))/R6688 IIj" % % yy## yy##  %''   7  #L11 \//1148 8 8 #      4ruser_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. Nrr}r r)rQrRrrSrTrV) rzrrrvrwrrr~rPrRrrr) rRrrrr user_pdef custom_pdefrrs r resolve_provider_fullrs&"#4((I  " "D  ))^DD   )$**,,*<*<*>*>OO   *$0@AAK  HHHHHH"N9--  ^'!*"#   !       4s6B>> C  C )rRrrtr)rRrrtr{)rrrtr)rrrtr)r)rrrTrrtr)rRrrrrtr{)rrrtr)rRrrrrtr{)NN)rRrrrrrrtr{)r __future__rlogging dataclassesrtypingrrrrr getLoggerrloggerr rNrrPrprqrsrzrrrrrrrrrrr rs&#"""""!!!!!!33333333333333  8 $ $  $d---*. d- MM%E   d-MM#"Ad-"--"5/ #d-.==#$)/ /d-:mm;;d-B&ECd-J ==E'   Kd-T}}(Ud-\}}&+]d-d--&.ed-l ,md-t}}-ud-| mm}d-D 0Ed-N==/Od-X MM,   Yd-b!=& =/'    m*]7)d-d-d-ddddT          &R lR  5 R  E R ER UR ER ER R $!R"'#R$!%R*\+R,,-R2 k3R4;5R:;R< =RR>-?RD(ERFGRHIRNJORP :QRV -WRX}YR^_R`aRbFcRhiRnoRp iqRr IsRtYuRz -{RR|"$  cRRRRRRRt "'  $$&.())!!!!????D    $1111 2$$$$NFFFF))))\047;8888888r