sj-dZddlmZddlZddlmZmZddlmZej e Z e Z d dZeGd d ZdS) 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)Anyreturnstrc< ddlm}d|S#t$rYdSwxYw)uReturn a ``hermes-cli/`` UA string, with a stable fallback. Used by ``ProviderProfile.fetch_models`` so the catalog probe is not served the default ``Python-urllib/`` UA — some providers (OpenCode Zen, etc.) sit behind a WAF that returns 403 for that. r) __version__z hermes-cli/z hermes-cli) hermes_clir Exception)_vers 2/home/agent/.hermes/hermes-agent/providers/base.py_profile_user_agentrsI222222#T### ||s ceZdZUdZded<dZded<dZded<d Zded <d Zded <d Z ded <dZ ded <d Z ded<d Z ded<dZ ded<dZded<dZded<dZded<dZded<dZded<d Zded<eeZded<dZded <dZd!ed"<d Zded#<dd$d@d'ZdAd(ZdBd+Zdd,dCd1Zdd2dDd6ZdEd7ZdFd9Z ddd:d;dGd?Z!dS)HProviderProfileuABase provider profile — subclass or instantiate with overrides.rnamechat_completionsapi_modetuplealiases display_name description signup_urlenv_varsbase_url models_urlapi_key auth_typeTboolsupports_health_checkFsupports_visionsupports_vision_tool_messagessupports_prompt_cache_keyfallback_modelshostname)default_factoryzdict[str, str]default_headersNrfixed_temperature int | Nonedefault_max_tokensdefault_aux_model)visionr.rcdS)uReturn a LIVE cheap-model id for auxiliary tasks, or "". ``default_aux_model`` is a hardcoded id in source, so it rots: when the provider retires that model every auxiliary call spends a round-trip 404ing before the retry net catches it. Providers that publish a machine-readable recommendation should override this and query it, so the cheap tier tracks the upstream catalog instead of a constant a human has to remember to bump. Contract: cheap to call (implementations must cache — this runs on client-resolution paths), never raises, and returns "" when it has no answer so the caller falls through to ``default_aux_model``. rr)selfr.s rresolve_aux_modelz!ProviderProfile.resolve_aux_modelhs rcj|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)r'r urllib.parser4)r0r4s r get_hostnamezProviderProfile.get_hostnamexsQ = != = : - - - - - -8DM**39r 9rr2messageslist[dict[str, Any]]c|S)zProvider-specific message preprocessing. Called AFTER codex field sanitization, BEFORE developer role swap. Default: pass-through. r)r0r7s rprepare_messagesz ProviderProfile.prepare_messagess r2) session_idr; str | Nonecontextdict[str, Any]c iS)zrProvider-specific extra_body fields. Merged into the API kwargs extra_body. Default: empty dict. r)r0r;r=s rbuild_extra_bodyz ProviderProfile.build_extra_bodys  r2)reasoning_configrA 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)r0rAr=s rbuild_api_kwargs_extrasz'ProviderProfile.build_api_kwargs_extrass $2v r2cdS)uReturn a default vision model id for this provider, or None. Overrideable hook for providers that discover their vision default at runtime (e.g. from a live catalog) rather than pinning one in code. Keeps provider-specific vision discovery inside the provider's plugin instead of a name-check branch in shared vision resolution. Default: None (no provider-specific vision model — the caller falls back to the user's chat model or the aggregator chain). Nr)r0s rdefault_vision_modelz$ProviderProfile.default_vision_models tr2modelc|jS)uReturn the default max_tokens cap for *model*. Overrideable hook for providers that need per-model output caps — e.g. a relay that fronts several upstream backends, each with a different completion-token limit. The transport calls this when the user hasn't set an explicit max_tokens. Default: return self.default_max_tokens (the static profile field), ignoring the model name. Override in a subclass to vary the cap per-model. )r,)r0rHs rget_max_tokenszProviderProfile.get_max_tokenss &&r2g @)rrtimeoutrKfloatlist[str] | Nonecn|pd}|p|j}t|o2|d|jpddk}|r|ddz}n9|jpd}|s|sdS|ddz}ddl}ddl} ddlm} | j |} |r| dd|| d d | d t|j D]\} } | | |  | | | 5}||}dddn #1swxYwYt%|t&r|n|d g}d|DS#t*$r,}t,d|j|Yd}~dSd}~wwxYw)ugFetch 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. base_url + "/models", but ONLY when the caller passed a base_url that differs from this profile's default (a user-configured model.base_url pointing at a proxy/custom endpoint). Callers pass base_url unconditionally — falling back to the profile default when the user configured nothing — so equality with self.base_url means "not customised" and must not shadow models_url. 2. 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) 3. 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. r/z/modelsNr)open_credentialed_url AuthorizationzBearer Acceptzapplication/jsonz User-Agent)rKdatacPg|]#}t|td|v|d$S)id) isinstancedict).0ms r z0ProviderProfile.fetch_models..s0PPPjD.A.APdaiiAdGiiir2zfetch_models(%s): %s)striprr!rstriprjsonurllib.requesthermes_cli.urllib_securityrPrequestRequest add_headerrr)itemsloadsreaddecoderVlistgetr loggerdebugr)r0rrrK caller_baseeffective_base custom_baseurlr]urllibrPreqkvresprSrcexcs r fetch_modelszProviderProfile.fetch_modelssB ~2,,.. $5 ;''   s # # (;'C'CC'H'H H   =$$S))I5CC?(b//11C =% 4$++C009< DDDDDDn$$S))  A NN?,?g,?,? @ @ @ x!3444 |%8%:%:;;;(..00 ! !DAq NN1a  &&sG<<< 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<' G>4:F:. G>:F>>G>F>;G>> H4!H//H4)r.r!rrrr)r7r8rr8)r;r<r=rrr>)rArBr=rrrC)rr<)rHr<rr+)rr<rr<rKrLrrM)"__name__ __module__ __qualname____doc____annotations__rrrrrrrrr r"r#r$r%r&r'rrWr)r*r,r-r1r6r:r@rErGrJrurr2rrr&sKKIII&H&&&&GLKJHHJI"&&&&&"O!!!!+/!.... ',++++  OH',eD&A&A&AOAAAA"!!!!%))))) 38    +/)-(     ' ' ' '"## FFFFFFFFr2rrv)rz __future__rlogging dataclassesrrtypingr getLoggerrwriobjectOMIT_TEMPERATURErrrr2rrs  #"""""((((((((  8 $ $688     ddddddd dddr2