(Gj"d`UdZddlmZddlZddlmZddlmZmZm Z m Z m Z ddl m Z mZejeZedGd d Zid ed d dded ddded dddeddddeddddedddd !d"ed dd#d$!d%ed d&d'd(d)*d+edd,d-d.!d/ed d01d2ed3d41d5ed d6d78d9ed d:;d<ed d=d>d?@dAed3dB;dCed3ddDdEed3dF;idGed dH;dIed dJ;dKed dL;dMed ddNdOed ddPdQed ddRdSed ddTdUed ddVdWeddd dXed dYdZd[ed d\;d]ed d^;d_ed d`dadbed dcddde@dfed dgdhdied dj;dkedldmnZdoedp<eGdqdrZidsddtd5dud5dvd5dwd5dxdWdydWdzdWd{dddd|dd}dd~dXddXddXddXdd9idd9dd9dd9dd<dd<ddEddEdd2dd2dd/dd/dd+ddMddMddOddOddQiddQddQddGddIddIddIddIddKddKddKddSddSddSddUddUdd[dd[idd]dd]dd]dd]ddkddkddkddkdd_dd_ddbddbd%d%dd%dd%ddddddddZded<ddddddddddddddǜ Zded<dd3ddldʜZded<ddτZddфZddӄZddքZedOdMhZded<ddلZddd܄Z dd߄Z!ddZ"ddZ# 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__rrrrrr:/home/rurouni/.hermes/hermes-agent/hermes_cli/providers.pyrr"sII"I""""MI&(N((((r!rmoarvirtualz moa://local)rrr openrouterOPENROUTER_BASE_URL)rrrnousoauth_device_codez)https://inference-api.nousresearch.com/v1 openai-codexcodex_responsesoauth_externalz%https://chatgpt.com/backend-api/codexz openai-apizhttps://api.openai.com/v1OPENAI_BASE_URL)rrr xai-oauthzhttps://api.x.ai/v1 XAI_BASE_URL)rrrrz qwen-oauthzhttps://portal.qwen.ai/v1HERMES_QWEN_BASE_URLlmstudior) LM_API_KEYzhttp://127.0.0.1:1234/v1 LM_BASE_URL)rrrrr 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-oauthz https://api.minimax.io/anthropicz minimax-cnMINIMAX_CN_BASE_URLdeepseekDEEPSEEK_BASE_URLalibabaDASHSCOPE_BASE_URLzalibaba-coding-planALIBABA_CODING_PLAN_BASE_URLopencodeOPENCODE_ZEN_BASE_URLz opencode-goOPENCODE_GO_BASE_URLkiloKILOCODE_BASE_URL huggingface HF_BASE_URLnovitaNOVITA_BASE_URLxainvidiaz#https://integrate.api.nvidia.com/v1NVIDIA_BASE_URLxiaomiXIAOMI_BASE_URLtencent-tokenhubTOKENHUB_BASE_URLarceezhttps://api.arcee.ai/api/v1ARCEE_BASE_URLgmi) GMI_API_KEYzhttps://api.gmi-serving.com/v1 GMI_BASE_URL ollama-cloudzhttps://ollama.com/v1OLLAMA_BASE_URLz azure-foundryAZURE_FOUNDRY_BASE_URLbedrockbedrock_converseaws_sdk)rrzDict[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 rnrrrrorprr!r"rjrjsCC GGG IIINNN%%%%HMICMMMMFr!rjopenaiglmzz-aizz.aizhipuzx-aizx.aigrokz grok-oauthz x-ai-oauthzxai-grok-oauthnimz nvidia-nimz build-nvidianemotronkimiz kimi-codingzkimi-coding-cnmoonshotstepzstepfun-coding-planz minimax-china minimax_cnclaudez claude-codecopilotgithubzgithub-copilot-acpz opencode-zenzengozopencode-go-subkilocodez kilo-codez kilo-gatewayz deep-seek dashscopealiyunqwenz alibaba-cloudalibaba_codingzalibaba-codingalibaba_coding_planhfz hugging-facezhuggingface-hubz novita-ainovitaaimimoz xiaomi-mimotencenttokenhubz tencent-cloud tencentmaasawsz aws-bedrockzamazon-bedrockamazonzarcee-aiarceeaiz gmi-cloudgmicloudz lm-studio lm_studioollamacustomvllmlocal)llamacppz llama.cppz llama-cppzDict[str, str]ALIASESzMixture of Agentsz Nous Portalz OpenAI CodexzGitHub Copilot ACPzStepFun Step Planz Xiaomi MiMoz GMI CloudzTencent TokenHubz LM StudiozLocal endpointz AWS Bedrockz Ollama Cloudz%xAI Grok OAuth (SuperGrok / Premium+)) r#r'r)r3rBrYr_r[r0rrerbr-_LABEL_OVERRIDESchat_completions)rr9r*rfTRANSPORT_TO_API_MODErlrreturnc|}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)rlkeys r"normalize_providerrs1 **,,    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) rkrlrrmrnrrrrorphermes) rkrlrrmrnrrrrp)ragent.models_devr Exceptionrhrrrrrrlistenvrappendrjrltupleapiror) rl canonical_mdev_provider mdev_infooverlayris_aggauth base_url_envrenv_varsevs r" get_providerrs#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.)rrrrl)rrpdefs r" get_labelrsM";//I$$$ **  " "D y r!providerrct|pd}|drdSt|}|r|jndS)z:Return True when the provider is a multi-model aggregator.rcustom:TF)r startswithrr)r provider_normrs r"rrsN&x~266M **t  & &D!% 04  50r!zfrozenset[str]_FLAT_NAMESPACE_RESELLERScXt|pd}|tvrdSt|S)uxReturn True only for TRUE routing aggregators (e.g. OpenRouter, named ``custom:*`` proxies) — those that route bare/vendor-slugged model names to *other* providers' endpoints. Distinct from :func:`is_aggregator`, which also reports True for flat-namespace resellers (opencode-go/zen) whose catalog is entirely first-party. Use this gate when the question is "would selecting this model silently re-route the call away from the user's intended provider?" — i.e. the picker dedup. Resellers answer no: their listed models are their own, so their rows must not be deduped against user proxies. rF)rrr)rrs r"is_routing_aggregatorrs4'x~266M111u  ' ''r!rrnc8t|}|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/codingr9z /anthropiczapi.anthropic.comzapi.openai.comr*rrerfz api.kimi.comz/codingzbedrock-runtime.z amazonaws.com) rrstriprendswithrrrr rr )rrnr 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. Nrlrrurlrnkey_envrrFr user-configrkrlrrmrnrrrp) isinstancedictrrrjr)rlrentry display_nameapi_urlrrrs r"resolve_user_providerrAs( 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. r -)rrreplace)rs r"custom_provider_slugrhs7 |))++1133;;CEE EEr!custom_providersOptional[List[Dict[str, Any]]]c |rt|tsdS|pd}|sdS|dk}d}|D]@}t|ts|dpd}|ddp-|ddp|ddpd}|r|s|dpd}g} |r| ||||t| f}t|} ||| hvrt| |d t| |d d d cS|r.|r,|\} } } t| } t| | d | | d d d SdS)zIResolve a provider from the user's config.yaml ``custom_providers`` list.NrrrlrnrrrrFrrr) rrrrrrrrrrj)rlr requestedbare_custom_fallback first_validrrrrrslugdnameaurldenvs r"resolve_custom_providerrrs8 :.>#E#Et""$$**,,I t %0>BK!$ $ %&&   &))/R6688 IIj" % % yy## yy##  %''   7  99Y''-24466   % OOG $ $ $  '%//BK#L11 \//1148 8 8 #"8__        'tT#E**#!      4r!user_providersOptional[Dict[str, Any]]ct|}|}|rt||}||St |}||S|r(t||}||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)rkrlrrmrnrp) rrrrrrrrrjrlrrr) rlrrrraw user_pdefr custom_pdefrrs r"resolve_provider_fullrsP"#4((I **,,    C)#~>>     " "D  ))^DD   )#~>>   *$0@AAK  HHHHHH"N9--  ^'!*"#   !       4s6C C#"C#)rlrrr)rlrrr)rrrr)rrrr)r)rrrnrrr)rlrrrrr)rrrr)rlrrrrr)NN)rlrrrrrrr)%r __future__rlogging dataclassesrtypingrrrrr utilsr r getLoggerrloggerrrhr rjrrrrrrr frozensetrrrrrrrrr!r"rsy &#"""""!!!!!!33333333333333::::::::  8 $ $  $h- =='   h- --. h- MM%E   h- MM#"A!h-*--#5*+h-4#"/' 5h-@--"5/ Ah-L &4& Mh-Z==#$)/ [h-fmm;gh-n&Eoh-v ==E'   wh-@}}(Ah-H}}+?+ Ih-T}}&+Uh-\]]&"<]h-f--&.gh-h-n ,oh-v}}-wh-~==7h-F 0Gh-P==/Qh-Z MM,   [h-d==&eh-n mm*oh-x ==#/'   yh-B mm?*Ch-L mm*Mh-T ,Uh-\ ]]7)]h-f ==':'    gh-rMM1*sh-@]]1Ah-H}}$Ih-h-hhhh\          &s ls  5 s  E s Es Us Es Es Es+ss +!s"k#s( 8)s*(+s,H-s./s4 5ss6$7s8'9s:!;s@ IAsB9CsH\IsJ,KsP kQsR;SsXYsZ [s\-]sbJcsd :esj -ksl}msrsssstusvFws|}sBCsD iEsF IGsHYIsJ+KsL+MsN0OsT -UsVMWsX}Ys^_s`asf Hgsh8isssn!osp"qsr'sst%usz 9{s|9}s~is@ iAsFGsHwIsNOsPQsV WsXYsZ[s\ h]s^ G_ss`esssssssv  "'" * "8$$(&.(* ))!!!!CCCCL    $1111&-6I7--(((($'''''X$$$$NFFFFGGGGX047;FFFFFFFr!