sjd4<UdZddlmZddlZddlZddlZddlZddlmZddl m Z m Z ej e ZiZded<iZded <dad ed <d aeejjd z dz Zd$dZd%dZd&dZd'dZd(dZd)d Zd*d"Zd)d#ZdS)+u`Provider module registry. Provider profiles can live in three places: 1. Bundled plugins: ``plugins/model-providers//`` (shipped with hermes-agent) 2. User plugins: ``$HERMES_HOME/plugins/model-providers//`` 3. Pip-installed plugins: distributions exposing a ``hermes_agent.plugins`` entry point (``module:func`` callable or a self-registering ``module``) Each plugin directory contains: - ``__init__.py`` — calls ``register_provider(profile)`` at import - ``plugin.yaml`` — manifest (name, kind: model-provider, version, description) Discovery is lazy: the first call to ``get_provider_profile()`` or ``list_providers()`` scans both locations and imports every plugin. User plugins override bundled plugins on name collision (last-writer-wins), so third parties can monkey-patch or replace any built-in profile without editing the repo. For backward compatibility, ``providers/*.py`` files (other than ``base.py`` and ``__init__.py``) are still discovered via ``pkgutil.iter_modules``. This lets out-of-tree users drop a single-file profile into an editable install without the plugin dir structure. New profiles should prefer the plugin layout. Usage:: from providers import get_provider_profile profile = get_provider_profile("nvidia") # ProviderProfile or None profile = get_provider_profile("kimi") # checks name + aliases ) annotationsN)Path)OMIT_TEMPERATUREProviderProfilezdict[str, ProviderProfile] _REGISTRYzdict[str, str]_ALIASESzlist[ProviderProfile] | None_PROVIDER_LIST_CACHEFpluginsmodel-providersprofilerreturnNonecZ|t|j<|jD]}|jt|<dadS)uRegister a provider profile by name and aliases. Later registrations with the same name replace earlier ones — so user plugins under ``$HERMES_HOME/plugins/model-providers/`` can override bundled profiles without editing repo code. N)rnamealiasesrr )r aliass 6/home/agent/.hermes/hermes-agent/providers/__init__.pyregister_providerr8s:&Igl''!,rstrProviderProfile | Nonectstt||}t|S)z{Look up a provider profile by name or alias. Returns None if the provider has no profile (falls back to generic). ) _discovered_discover_providersrgetr)r canonicals rget_provider_profilerFs=  T4((I == # ##rlist[ProviderProfile]cVtsttttSt }g}t D]?}t|}||vr*||| |@|at|S)zAReturn all registered provider profiles (one per canonical name).) rrr listsetrvaluesidaddappend)seenresultr pids rlist_providersr)Qs '()))UUD$&F##%%##kk d?? HHSMMM MM' " " "! <<r Path | Nonec ddlm}|dz dz }|r|ndS#t$rYdSwxYw)z>Return ``$HERMES_HOME/plugins/model-providers/`` if it exists.r)get_hermes_homer r N)hermes_constantsr,is_dir Exception)r,ds r_user_plugins_dirr1dsj444444 O   ),= =HHJJ(qqD( tts -0 >> plugin_dirrsourcecp|dz }|sdS|jdd}|dkrd|}nd|}|tjvrdS t j||t|g}||j dSt j |}|tj|<|j |dS#t$rM}td ||j|tj|dYd}~dSd}~wwxYw) zImport a single plugin directory so it self-registers. ``source`` is "bundled" or "user", used only for log messages. z __init__.pyN-_bundledzplugins.model_providers._hermes_user_provider_)submodule_search_locationsz(Failed to load %s provider plugin %s: %s)existsrreplacesysmodules importlibutilspec_from_file_locationrloadermodule_from_spec exec_moduler/loggerwarningpop)r2r3 init_file safe_name module_namespecmoduleexcs r_import_plugin_dirrMose ]*I      ''S11I <<< :y:: ck!! +~55 J?P6   <4;. F0066#) K  ''''' +++ 6 QT     T********* +s 9CAC D5(AD00D5c ddlm}n#t$rYdSwxYw ddlm}m}|}|}n #t$rdt }}YnwxYw|sdSd} |}t|dr$t| |}n#t| |g}n3#t$r&}t d|Yd}~dSd}~wwxYw|D]} | j|vs | j|vr!t d| j6 | } n8#t$r+}td | j|Yd}~|d}~wwxYwt#| rtt%| r!t d | j | #t$r+}td | j|Yd}~d}~wwxYw dS) u*Import pip-installed provider plugins via the ``hermes_agent.plugins`` entry-point group so they self-register. A distribution ships:: [project.entry-points."hermes_agent.plugins"] acme-inference = "acme_hermes_plugin:register" The target may be either a **callable** (``module:func`` — invoked with no args; typically calls ``register_provider(profile)``) or a **module** (``module`` — imported for its module-level ``register_provider`` side effect, mirroring the directory-plugin ``__init__.py`` contract). Gating and safety: * **Opt-in.** Entry-point plugins are subject to the same ``plugins.enabled`` allow-list (and ``plugins.disabled`` deny-list) the general PluginManager enforces — a pip package is never imported just because it is installed. An entry point whose name is not enabled is skipped without loading. * **Provider targets only.** The ``hermes_agent.plugins`` group is shared with general plugins whose target is ``register(ctx)``. Callables that require arguments are skipped here (the PluginManager owns them); provider registration hooks take no arguments by contract. Failures are swallowed per-entry (a broken third-party package must not break provider discovery) and logged at warning level. This scan runs first, so filesystem plugins (bundled + ``$HERMES_HOME``) keep their documented override precedence via last-writer-wins in ``register_provider()`` — a pip package cannot hijack a first-party provider name. rN)_get_disabled_plugins_get_enabled_pluginszhermes_agent.pluginsselect)groupz%entry-point provider scan skipped: %sz6entry-point provider %r skipped: not enabled in configz1Failed to load entry-point provider plugin %r: %szjentry-point %r skipped by provider scan: target requires arguments (general plugin owned by PluginManager)z7Entry-point provider plugin %r raised on invocation: %s)importlib.metadatametadatar/hermes_cli.pluginsrOrPr! entry_pointshasattrr rQrrDdebugrloadrEcallable_requires_arguments) _mdrOrPenableddisabledrReps group_epsrLeploadeds r_discover_entry_point_providersrcsB(((((((  (RRRRRRRR&&((((** ((( #%%(  "E    3 ! ! 1SZZeZ4455IISWWUB//00I  /plugins/model-providers//`` 2. User plugins at ``$HERMES_HOME/plugins/model-providers//`` 3. Legacy per-file modules at ``providers/.py`` (back-compat) Each step imports its plugins, which call ``register_provider()`` at module-level. Later steps win on name collision. NT)r6.r7userrr6basez providers.z.Failed to import legacy provider module %s: %s)rrc_BUNDLED_PLUGINS_DIRr.sortediterdirr startswithrMr1pkgutil providers iter_modules__path__r> import_module ImportErrorrDrEr/)childuser_dirr}_pkg _importermodname_ispkgrLs rrrsK $%%%""$$1088::;; 1 1E<<>> UZ%:%::%F%F  ui 0 0 0 0 !""HH,,..// . .E<<>> UZ%:%::%F%F  uf - - - -      *1*>*>t}*M*M   &Iw!!#&& 'V*;*; '(>W(>(>????   Dgs          s=AF!E,+F!, F6FF!FF!! F/.F/)r rr r)rrr r)r r)r r*)r2rr3rr r)r r)r rd) __doc__ __future__rr>importlib.utilloggingr<pathlibrproviders.baserr getLogger__name__rDr__annotations__rr r__file__resolveparentryrrr)r1rMrcr[rrrrs@#""""" <<<<<<<<  8 $ $(* ****599999  DNN#*Y69JJ     $$$$&#+#+#+#+L____D0C C C C C C r