o PL j@sddZddlmZddlZddlmZmZddlmZe e Z e Z d dd ZeGd d 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)AnyreturnstrcCs.z ddlm}d|WStyYdSw)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)_verr 2/home/kuhnn/.hermes/hermes-agent/providers/base.py_profile_user_agents    rc@s&eZdZUdZded<dZded<dZded<d Zded <d Zded <d Z ded <dZ ded <d Z ded<d Z ded<dZ ded<dZded<dZded<d Zded<eedZded<dZded<dZded<d Zded<d;d!d"Zdd2d3Zdd4d5d?d9d:ZdS)@ProviderProfileuABase provider profile — subclass or instantiate with overrides.rnamechat_completionsapi_moder tuplealiases 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_modelrcCs2|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.parser')selfr'r r r get_hostnameRs  zProviderProfile.get_hostnamemessageslist[dict[str, Any]]cCs|S)zProvider-specific message preprocessing. Called AFTER codex field sanitization, BEFORE developer role swap. Default: pass-through. r )r)r+r r r prepare_messages_sz ProviderProfile.prepare_messages) session_idr. str | Nonecontextdict[str, Any]cKsiS)zrProvider-specific extra_body fields. Merged into the API kwargs extra_body. Default: empty dict. r )r)r.r0r r r build_extra_bodygsz ProviderProfile.build_extra_body)reasoning_configr3 dict | None%tuple[dict[str, Any], dict[str, Any]]cKsiifS)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)r3r0r r r build_api_kwargs_extraspsz'ProviderProfile.build_api_kwargs_extrasg @)rtimeoutr7floatlist[str] | Nonec Cs<|jpd}|s|jsdS|jdd}ddl}ddl}|j|}|r/|dd||dd |d t |j D] \}}|||qAz6|jj ||d } | | } Wdn1siwYt| tru| n| d g} d d| DWSty} ztd|j| WYd} ~ dSd} ~ ww)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/jsonz User-Agent)r7datacSs&g|]}t|trd|vr|dqS)id) isinstancedict).0mr r r s&z0ProviderProfile.fetch_models..zfetch_models(%s): %s)rstriprrstripjsonurllib.requestrequestRequest add_headerrr#itemsurlopenloadsreaddecoder?listgetr loggerdebugr) r)rr7urlrFurllibreqkvrespr=rKexcr r r fetch_modelss2  zProviderProfile.fetch_modelsrr)r+r,rr,)r.r/r0rrr1)r3r4r0rrr5)rr/r7r8rr9)__name__ __module__ __qualname____doc____annotations__rrrrrrrrrrr r!rr@r#r$r%r&r*r-r2r6r[r r r r r&s:                   rr\)r` __future__rlogging dataclassesrrtypingr getLoggerr]rRobjectOMIT_TEMPERATURErrr r r r s