idZddlmZddlZddlmZmZddlmZej e Z e Z eGddZdS)uProvider profile base class. A ProviderProfile declares everything about an inference provider in one place: auth, endpoints, client quirks, request-time quirks. The transport reads this instead of receiving 20+ boolean flags. Provider profiles are DECLARATIVE — they describe the provider's behavior. They do NOT own client construction, credential rotation, or streaming. Those stay on AIAgent. ) annotationsN) dataclassfield)Anyc@eZdZUdZded<dZded<dZded<d Zded <d Zded <d Z ded <dZ ded <d Z ded<d Z ded<dZ ded<dZded<d Zded<eeZded<dZded<dZded<d Zded<d3dZd4d!Zdd"d5d'Zdd(d6d,Zdd-d.d7d2ZdS)8ProviderProfileuABase provider profile — subclass or instantiate with overrides.strnamechat_completionsapi_modetuplealiases display_name description signup_urlenv_varsbase_url models_urlapi_key auth_typefallback_modelshostname)default_factoryzdict[str, str]default_headersNrfixed_temperaturez int | Nonedefault_max_tokensdefault_aux_modelreturncj|jr|jS|jrddlm}||jjpdSdS)uReturn the provider's base hostname for URL-based detection. Uses self.hostname if set explicitly, otherwise derives it from base_url. e.g. 'https://api.gmi-serving.com/v1' → 'api.gmi-serving.com' r)urlparser)rr urllib.parser")selfr"s 3/home/piyush/.hermes/hermes-agent/providers/base.py get_hostnamezProviderProfile.get_hostnameCsQ = != = : - - - - - -8DM**39r 9rmessageslist[dict[str, Any]]c|S)zProvider-specific message preprocessing. Called AFTER codex field sanitization, BEFORE developer role swap. Default: pass-through. r )r$r(s r%prepare_messagesz ProviderProfile.prepare_messagesPs r') session_idr, str | Nonecontextdict[str, Any]c iS)zrProvider-specific extra_body fields. Merged into the API kwargs extra_body. Default: empty dict. r )r$r,r.s r%build_extra_bodyz ProviderProfile.build_extra_bodyXs  r')reasoning_configr2 dict | None%tuple[dict[str, Any], dict[str, Any]]c  iifS)aProvider-specific kwargs split between extra_body and top-level api_kwargs. Returns (extra_body_additions, top_level_kwargs). The transport merges extra_body_additions into extra_body, and top_level_kwargs directly into api_kwargs. This split exists because some providers put reasoning config in extra_body (OpenRouter: extra_body.reasoning) while others put it as top-level api_kwargs (Kimi: api_kwargs.reasoning_effort). Default: ({}, {}). r )r$r2r.s r%build_api_kwargs_extrasz'ProviderProfile.build_api_kwargs_extrasas $2v r'g @)rtimeoutr7floatlist[str] | NonecX|jpd}|s&|jsdS|jddz}ddl}ddl}|j|}|r|dd||dd |j D]\}}||| |j || 5} | | } dddn #1swxYwYt| t r| n| d g} d | DS#t$$r,} t&d |j| Yd} ~ dSd} ~ wwxYw)uFetch the live model list from the provider's models endpoint. Returns a list of model ID strings, or None if the fetch failed or the provider does not support live model listing. Resolution order for the endpoint URL: 1. self.models_url (explicit override — use when the models endpoint differs from the inference base URL, e.g. OpenRouter exposes a public catalog at /api/v1/models while inference is at /api/v1) 2. self.base_url + "/models" (standard OpenAI-compat fallback) The default implementation sends Bearer auth when api_key is given and forwards self.default_headers. Override to customise auth, path, response shape, or to return None for providers with no REST catalog. Callers must always fall back to the static _PROVIDER_MODELS list when this returns None. rN/z/modelsr AuthorizationzBearer Acceptzapplication/json)r7datacPg|]#}t|td|v|d$S)id) isinstancedict).0ms r% z0ProviderProfile.fetch_models..s0PPPjD.A.APdaiiAdGiiir'zfetch_models(%s): %s)rstriprrstripjsonurllib.requestrequestRequest add_headerritemsurlopenloadsreaddecoderAlistget Exceptionloggerdebugr ) r$rr7urlrHurllibreqkvrespr>rMexcs r% fetch_modelszProviderProfile.fetch_modelsus2$"++-- 8= t-&&s++i7C n$$S))  A NN?,?g,?,? @ @ @ x!3444(..00 ! !DAq NN1a  ''W'== 8zz$))++"4"4"6"677 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8&tT22LDD8L8LEPPUPPP P    LL/C @ @ @44444 s< E3):D/# E3/D33E36D37;E33 F)=!F$$F))r r )r(r)r r))r,r-r.rr r/)r2r3r.rr r4)rr-r7r8r r9)__name__ __module__ __qualname____doc____annotations__r rrrrrrrrrrrrBrrrrr&r+r1r6r^r r'r%rrsKKIII&H&&&&GLKJHHJI  OH',eD&A&A&AOAAAA"!!!!%)))))     +/)-.# 00000000r'r)rb __future__rlogging dataclassesrrtypingr getLoggerr_rUobjectOMIT_TEMPERATURErr r'r%rks  #"""""((((((((  8 $ $688 LLLLLLL LLLr'