߲j tdZddlmZddlZddlmZmZmZmZGddejZ Gdde Z y) aShared base classes for the pluggable-backend provider ABCs. Every tool-provider ABC shares the same identity + ``hermes tools`` picker surface. Concrete ABCs subclass :class:`ProviderBase` (or :class:`CatalogProviderBase` when the backend also exposes a model catalog and is available by default) and add only their domain methods. Plugins keep subclassing the concrete ABC, so ``isinstance`` checks and abstract-method sets are unchanged. ) annotationsN)AnyDictListOptionalcZeZdZdZeej ddZeddZddZ y) ProviderBasez8Identity + picker metadata common to every provider ABC.cy)zStable short identifier used as the provider's config-key value. Lowercase, no spaces (hyphens allowed where they preserve an existing user-visible name). Registries key providers by this string. Nselfs 8/home/ubuntu/.hermes/hermes-agent/agent/provider_base.pynamezProviderBase.namesc|jS)zEHuman-readable label shown in ``hermes tools``. Defaults to ``name``.)rr s r display_namezProviderBase.display_namesyyrc$|jddgdS)zProvider row for the ``hermes tools`` picker. Shape: ``{"name", "badge", "tag", "env_vars": [{"key", "prompt", "url"}, ...]}`` (browser providers may add ``"post_setup"``). Override to expose API key prompts and badges. )rbadgetagenv_vars)rr s rget_setup_schemazProviderBase.get_setup_schema!s))BrrRRrNreturnstr)rzDict[str, Any]) __name__ __module__ __qualname____doc__propertyabcabstractmethodrrrr rrr r s?B   Srr c:eZdZdZeddZddZd dZd dZy) CatalogProviderBasezUProvider with a model catalog; available by default, ``display_name`` is title-cased.c6|jjS)zMHuman-readable label shown in ``hermes tools``. Defaults to ``name.title()``.)rtitler s rrz CatalogProviderBase.display_name.syy  rcy)uTrue when this provider can service calls (API key present, SDK importable). Must NOT raise and must NOT make network calls — the picker and ``hermes setup`` call it on every paint. Tr r s r is_availablez CatalogProviderBase.is_available3s rcgS)zQModel catalog entries (``{"id": ..., "display": ...}`` + provider-specific keys).r r s r list_modelszCatalogProviderBase.list_models;s rcR|j}|r|djdSdS)zAId of the first catalog entry, or None when the catalog is empty.ridN)r*get)r modelss r default_modelz!CatalogProviderBase.default_model?s*!!#&,vay}}T"6$6rNr)rbool)rzList[Dict[str, Any]])rz Optional[str]) rrrrr rr(r*r/r rrr$r$+s&_ !!7rr$) r __future__rr!typingrrrrABCr r$r rrr4s6# ,,S377S67,7r