`gj&dZddlmZddlZddlmZmZddlmZeje Z e Z d dZeGddZy) 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)Anyc8 ddlm}d|S#t$rYywxYw)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 A/root/.hermes/venv/lib/python3.12/site-packages/providers/base.py_profile_user_agentr s)2TF## 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<d Zded<eeZded<dZded<dZd ed!<d Zded"<d.d#Zd/d$Zdd% d0d&Zdd' d1d(Zd2d)Zd3d*Zddd+d, d4d-Zy)5ProviderProfileuABase provider profile — subclass or instantiate with overrides.strnamechat_completionsapi_modetuplealiases display_name description signup_urlenv_varsbase_url models_urlapi_key auth_typeTboolsupports_health_checkFsupports_visionsupports_vision_tool_messagesfallback_modelshostname)default_factoryzdict[str, str]default_headersNrfixed_temperature 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)r%r urllib.parser-)selfr-s r get_hostnamezProviderProfile.get_hostnamebs< ==== == -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_messagesos r1) session_idc iS)zrProvider-specific extra_body fields. Merged into the API kwargs extra_body. Default: empty dict. r)r/r5contexts r build_extra_bodyz ProviderProfile.build_extra_bodyws  r1)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/r9r7s r build_api_kwargs_extrasz'ProviderProfile.build_api_kwargs_extrass $2v r1cy)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)r/s r default_vision_modelz$ProviderProfile.default_vision_modelsr1c|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*)r/models r get_max_tokenszProviderProfile.get_max_tokenss&&&r1g @)rrtimeoutc||xs |j}|jxsdj}|s|sy|jddz}ddl}ddl}ddlm}|jj|} |r| jdd|| jd d | jd t|jjD]\} } | j| |  || | 5} |j| jj!} dddt# t$r| n| j'd g}|Dcgc]}t#|t(sd|vs|dc}S#1swYVxYwcc}w#t*$r+}t,j/d|j0|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. base_url (caller override — user-configured model.base_url) 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. rN/z/modelsr)open_credentialed_url AuthorizationzBearer Acceptzapplication/jsonz User-Agent)rAdataidzfetch_models(%s): %s)rrstriprstripjsonurllib.requesthermes_cli.urllib_securityrDrequestRequest add_headerr r'itemsloadsreaddecode isinstancelistgetdictr loggerdebugr)r/rrrAeffective_baseurlrKurllibrDreqkvresprGrQmexcs r fetch_modelszProviderProfile.fetch_modelss~6"2T]]$"++-! '',y8CDnn$$S)  NN?ggY,? @ x!34 |%8%:;((..0 !DAq NN1a  ! &sG< 8zz$))+"4"4"67 8&tT2D8LE%*PjD.AdaiAdGP P 8 8Q  LL/C @ sH) F3.E6!0FF'F,F3F6E?; F F;!F66F;returnr)r3list[dict[str, Any]]rfrg)r5 str | Noner7rrfzdict[str, Any])r9z dict | Noner7rrfz%tuple[dict[str, Any], dict[str, Any]])rfrh)r?rhrfr))rrhrrhrAfloatrfzlist[str] | None) __name__ __module__ __qualname____doc____annotations__rrrrrrrrrr!r"r#r$r%rrXr'r(r*r+r0r4r8r;r=r@rdrr1r rr&stK I&Hc&GUL#KJHeHcJIs"&4&"OT!+/!4.  OUHc',D&AO^A"s!%) ) s +/';> )-&  / (  '"## 99 9  9  9r1rre)rm __future__rlogging dataclassesrrtypingr getLoggerrjrYobjectOMIT_TEMPERATUREr rrr1r rvsU #(   8 $8  AA Ar1