BjsdZddlmZddlZddlmZmZddlmZeje Z e Z eGddZy)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)AnycdeZdZUdZded<dZded<dZded<d Zded <d Zded <d Z ded <dZ ded <d Z ded<d Z ded<dZ ded<dZded<dZded<d Zded<eeZded<dZded<dZded<d Zded<d)d Zd*d!Zdd" d+d#Zdd$ d,d%Zdd&d' d-d(Zy).ProviderProfileuABase provider profile — subclass or instantiate with overrides.strnamechat_completionsapi_modetuplealiases display_name description signup_urlenv_varsbase_url models_urlapi_key auth_typeTboolsupports_health_checkfallback_modelshostname)default_factoryzdict[str, str]default_headersNrfixed_temperaturez int | Nonedefault_max_tokensdefault_aux_modelc|jr |jS|jr&ddlm}||jjxsdSy)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/ubuntu/.hermes/hermes-agent/providers/base.py get_hostnamezProviderProfile.get_hostnameDs< ==== == -DMM*339r 9c|S)zProvider-specific message preprocessing. Called AFTER codex field sanitization, BEFORE developer role swap. Default: pass-through. r )r%messagess r&prepare_messagesz ProviderProfile.prepare_messagesQs r() session_idc iS)zrProvider-specific extra_body fields. Merged into the API kwargs extra_body. Default: empty dict. r )r%r,contexts r&build_extra_bodyz ProviderProfile.build_extra_bodyYs  r()reasoning_configc  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%r0r.s r&build_api_kwargs_extrasz'ProviderProfile.build_api_kwargs_extrasbs $2v r(g @)rtimeoutcj|jxsdj}|s+|jsy|jjddz}ddl}ddl}|j j|}|r|jdd||jdd |jjD]\}}|j|| |j j|| 5} |j| jj} dddt t r| n| j#d g} | D cgc]} t| t$sd | vs| d c} S#1swYVxYwcc} w#t&$r+} t(j+d |j,| Yd} ~ yd} ~ 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)r3dataidzfetch_models(%s): %s)rstriprrstripjsonurllib.requestrequestRequest add_headerritemsurlopenloadsreaddecode isinstancelistgetdict Exceptionloggerdebugr )r%rr3urlr<urllibreqkvrespr8rAmexcs r& fetch_modelszProviderProfile.fetch_modelsvsn2$"++-==--&&s+i7Cnn$$S)  NN?ggY,? @ x!34((..0 !DAq NN1a  ! ''W'= 8zz$))+"4"4"67 8&tT2D8LE%*PjD.AdaiAdGP P 8 8Q  LL/C @ sH E>*.E-0E>E9E9#E9*E>-E62 E>> F2!F--F2)returnr )r*list[dict[str, Any]]rVrW)r, str | Noner.rrVzdict[str, Any])r0z dict | Noner.rrVz%tuple[dict[str, Any], dict[str, Any]])rrXr3floatrVzlist[str] | None)__name__ __module__ __qualname____doc____annotations__r rrrrrrrrrrrrrIrrr r!r'r+r/r2rUr r(r&rrsDK I&Hc&GUL#KJHeHcJIs"&4&  OUHc',D&AO^A"s!%) ) s +/';> )-&  / .# 00 0  0r(r)r] __future__rlogging dataclassesrrtypingr getLoggerrZrKobjectOMIT_TEMPERATURErr r(r&rfsP #(   8 $8 MM Mr(