߲jbUdZddlmZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z ddlmZddlmZmZmZmZmZmZmZmZddlmZdd lmZ ddlZej@d Z!hd Z"d e#d <hdZ$d e#d<dZ%e&fe&fe'fe'fe'e(fe'e(fe)fe)fe*fe*fe+fe+fe&fd Z,de#d<d0dZ-d1dZ.d1dZ/d2dZ0d3dZ1d4dZ2d5dZ3d6dZ4d7dZ5d8dZ6d9dZ7d:dZ8d;d Z9dd"Z;dej~d'Z@dAd(ZAej~d)ZBdBd*ZCdCd+ZDdDd,ZEdEd-ZFdFd.ZG dGd/ZHy#e$rdZYwxYw)HzPlugin manifest model and parsing (``plugin.yaml`` v1/v2, portable ``plugin.json``). Split out of :mod:`hermes_cli.plugins`; validation warns and never fails a load. ) annotationsN)suppress) dataclassfield)Path)AnyCallableDictListMappingOptionalSetUnion)fast_safe_load)parse_declared_capabilitieszhermes_cli.plugins>backendplatform exclusive standalonemodel-providerzSet[str]_VALID_PLUGIN_KINDS>kindnametagsemitshookslabelauthorhermesdependslicenselistensversionhomepage platforms api_version description capabilities optional_env requires_env config_schemaprovides_hooksprovides_toolspython_runtimerequires_hermesmanifest_versionpip_dependenciesrequires_pluginspython_dependenciesexternal_dependenciesprovides_web_providersprovides_browser_providers_KNOWN_MANIFEST_FIELDS) strstringintintegerfloatnumberboolbooleanlistarraydictobjectsecretzDict[str, tuple]_CONFIG_SCHEMA_TYPESc&ddlm}|jS)Nr)plugins) hermes_clirH_PLUGINS_DEBUG)_origins @/home/ubuntu/.hermes/hermes-agent/hermes_cli/plugins_manifest.py_plugins_debugrM7s-  ! !!ct|}tj|jdj dd}d|d|S)zGReturn a readable, collision-resistant namespace for a portable plugin.utf-8Nz agent-plugin--)_portable_slughashlibsha256encode hexdigest)keyslugdigests rL_portable_skill_namespacer[<sF # D ^^CJJw/ 0 : : z!_portable_slug..Ds,fTV2::<2:2COfs24z-_plugin)joinlowerstrip)rXrYs rLrSrSCs4 77fZ]ZcZcZef fD ::d  'x'rNc~t|S)atInternal name of a portable plugin's MCP server: exactly the name its ``mcp.json`` gives it, the same rule a user's own ``mcp_servers`` block in config.yaml follows. The plugin's skill namespace (``agent-plugin--``) is NOT prepended: it keeps plugin-data and skill names collision-free without coordination, but here it cost ~40 chars of every ``mcp____`` name, which providers cap at 64, so the tool verb was hash-clamped away. A duplicate is refused at load (native config first, then first-loaded plugin) with a warning naming both owners; that beats hiding it behind a digest.)rS)rXservers rLportable_mcp_server_namerjHs & !!rNcvttrdjfddDSdStS)zFNormalize a manifest author value for the string PluginManifest field., c3^K|]$}j|st|&ywN)getr9)rafvalues rLrcz"_display_author..Vs$Y1EIIVWLU1XYs--)remailurlr]) isinstancer rer9)rqs`rL_display_authorruSs6%!yyY0HYYY2.CJ.rNcv|j|}|%t||stjd|||y|S)zVReturn ``data[field_name]`` when absent or of ``typ``; warn and return None otherwise.Nz"Plugin %s: %s must be %s; ignoring)rortloggerwarning)datarX field_nametypwhatraws rL_manifest_field_of_typer~Zs9 ((: C z#s3;S*dS JrNcg}t|||t|xsgD]5}||}|tj|||%|j |7|S)zbCoerce each item of list field ``field_name``; ``coerce`` returning None warns ``warn`` and skips.)r~rArwrxappend) ryrXrzr|coercewarnoutitemcoerceds rL_manifest_listrcsY C'c:tTJPb , ? NN4d + JJw   JrNct|tr|ddSt|trLt|jdtr-|dr(|jd}|d| t|dSddSy)z]``{id, version_range}`` from a requires_plugins item (str shorthand ok); None when malformed.N)id version_rangerr)rtr9r ro)rvrs rL_dependency_entryrosi$T22$ Z%Dd XXo &4jbn3r7WWRVWW rNcv t|S#ttf$rtj ||||cYSwxYw)z]``int(raw)``; a non-integer warns ``warn`` (formatted with key, raw) and yields ``fallback``.)r; TypeError ValueErrorrwrx)r}rXrfallbacks rL _manifest_intrys93x z "tS#&s (88c ~t|jdd|dd}|tkDrtj d||t|jd}|dn t||dd}t ||dd t d }t ||d d d d}i}t||dtd}|xsijD]\} } t| tstj d|| .| jd} | Tt| jtvr5tj d|| | djttt!| |t| <t||dt"d xsgD cgc] } t| } } tt%|j't(z }|r<|dk\rtjntj*d|dj||||||t|jdxsdt|jdxsd| dScc} w)zrValidate/normalize manifest v2 fields into PluginManifest kwargs (warnings, never failures). See #64165. r0z?Plugin %s: manifest_version %r is not an integer; treating as 1zrPlugin %s: manifest_version %d is newer than this Hermes supports (%d); loading anyway and ignoring unknown fieldsr&Nz5Plugin %s: api_version %r is not an integer; ignoringr2za listzjPlugin %s: requires_plugins entry %r must be a plugin id string or a {id, version_range} mapping; skippingr3za list of requirement stringscft|tr |jr|jSdSrn)rtr9rg)rs rLz+_parse_manifest_v2_fields..s"Zc%:tzz|TZZ\QUrNzXPlugin %s: python_dependencies entry %r must be a non-empty requirement string; skippingr+z a mappingzPPlugin %s: config_schema entry %r must be a mapping (e.g. {type: str}); skippingtypezgPlugin %s: config_schema key %r declares unknown type %r (known: %s); type check will be skipped for itrlrr8zdPlugin %s: unknown manifest field(s) ignored: %s (newer manifest schema or typo; plugin still loads)r!r]r$)r0r&r2r3r+r!r$r)rroSUPPORTED_MANIFEST_VERSIONrwrxrrr~r itemsrtr9rfrFresortedrCrAsetkeysr7debug)ryrXmvraw_apiapidepspydepsschema raw_schemaskeyspecstypetrunknowns rL_parse_manifest_v2_fieldsrs5 txx 2A6XZ[ ]B && HILbRl hh}%G/$}Mt(UC  c%x1B < D  c(*IUbF  F(sOWkZJ!'R..0 ' d$( NNbdgim o    U!1!1!3;O!O NNAT5$))F3G,H"I  !Js4y '5T3hW][] _qCF _D _S%(>>?G 427  BCF RYHZ sekC0C0Ir,J,23T  `s<H:c Dg}t|trt|ts|S|jD]\}}t|ts||vr.|jdrd|vr|j d|d|dI|jd}|r,t jt |jnd}|||}t||rt|tst|vs|j d|d|d|d t|jd |S) zReturn actionable warning strings for settings vs config_schema mismatches (never raises). Never raises; schema mismatches must not block plugin load (#64165). requireddefaultzplugins.entries.z .settings.z9 is required by the plugin's config_schema but is not setrNz should be z (got )) rtr rrorrFr9rfr?r__name__) plugin_idrsettingswarningsrrrexpectedrqs rLvalidate_config_schemars) H fg &j7.Klln d$(  x xx # (=&ykD6BCC  CH'++CJ,<,<,>?d   %*z%/F4W_K_ OO"9+Zv['U 4 45Q8 #* OrNcddl}t|j}i}|D]1}||js|j ||j|3|Dcic] }|t }}|D]}||j D]}t|tr|jdnd}|s)||vr|n|j|}|tjd|||[||k(rtjd|w||j||j|} | jg} | j'rJt| j)} | j+| | j,| | j'rJ| Scc}w#|j$ra} t!| j"dkDr| j"dng} tjddj%d | D|cYd} ~ Sd} ~ wwxYw) a#Return plugin keys in dependency order: B before A when A requires B; alphabetical ties. A cycle warns and falls back to alphabetical order for all; a missing dependency warns once but never removes the dependent plugin (loads never hard-fail on advisory deps). See #64165. rNrzPlugin %s requires plugin '%s' which is not enabled/installed; loading anyway (probe availability at runtime via ctx.has_plugin). Run `hermes plugins enable %s` if it is installed.z3Plugin %s declares a dependency on itself; ignoringrz^Plugin dependency cycle detected (%s); falling back to alphabetical load order for all pluginsz -> c32K|]}t|ywrn)r9racs rLrcz,resolve_plugin_load_order..sBYa3q6BYs)graphlibrrr setdefaultrr2rtr rorwrxaddTopologicalSorterprepare CycleErrorlenargsre is_active get_readyextenddone) manifestsrrby_namekedgesdepdep_idresolvedsorterexccycleorderedreadys rLresolve_plugin_load_orderrs ).." #D G 5 Q<     y|00! 4559!9q!SU(!9E!9 'Q<00 'C&0g&>SWWT]DF!'9!4v'++f:MH^vv  QTVWXa X& ''" ' ' .FG    v'')*u U     NC":*   "388}q0 b 67={{BYSXBY7Y  s%F#FH%AH;HHcBtfddDrydvrdvryy)aKind implied by source markers (mirrors plugins/memory ``_is_memory_provider_dir`` and plugins/cron_providers ``_is_cron_provider_dir``): memory- or cron-provider markers -> ``exclusive``; ``register_provider`` + ``ProviderProfile`` -> ``model-provider``; else ``None``. Keeps these kinds out of the general manager's eager import (its PluginContext has no ``register_cron_scheduler``, #62951).c3&K|]}|v ywrn)ramarker source_texts rLrcz+_detect_kind_from_source..s gV6[  gs)register_memory_providerMemoryProviderregister_cron_scheduler CronSchedulerrregister_providerProviderProfilerN)any)rs`rL_detect_kind_from_sourcer s9   g0f ggk).?;.N rNc |r0|jdrtjj|}|r|jdsyt |j ddd|S#t $rYywxYw)z\First ``limit`` chars of a module's source (``.pyc`` mapped back to ``.py``); "" on failure.)z.pycz.pyo.pyr]rPreplace)encodingerrorsN)endswith importlibutilsource_from_cacher read_text Exception)originlimits rL_read_source_from_originrsn foo&67^^55f=FV__U3F|%%wy%I&5QQ sAA'A'' A32A3c`|jdDcgc]}|s| }}|sy tjj|d}| |jsyt |dk(r |jS|j }|syt|dddD]\}}dx}}tt|D]R} | |z dz | |dzz } } | jrt| | |z g}}n| jsGt| }n|y|t |k(s||cS|}ycc}w#t$rYywxYw) aYReturn a module's source path WITHOUT importing it, or ``None``. ``find_spec`` on a dotted name imports the parent package, so only the top-level name uses it; remaining segments are walked through ``submodule_search_locations`` by hand. Namespace/zipped/extension modules return ``None``. Shared with ``plugins/memory/__init__.py``..Nrrr8)start __init__.pyr) splitrr find_specrrsubmodule_search_locations enumeratemapris_filer9r) module_nameppartsr search_pathsipart found_origin next_pathsbasepkg_initmod_files rLresolve_module_originr&sU $))#. 41!Q 4E 4 ~~''a1 : IGSKFC5:45PL2P %d ;NI; %d ;NI;FCD- D#CMOSHdOS$D9L)9c!%K%-24-H*H&+4%@@$)$$?M>?GSHcD1D)1T2E92t4GY4rNrz!^\s*(>=|<=|==|!=|>|<)\s*(.+?)\s*$c ddlm}|r t|S tj j dS#t$rY*wxYw)uVersion of the Hermes code that is running: ``hermes_cli.__version__``. Distribution metadata is only a fallback — on an editable/source install it is frozen at ``pip install -e`` time and drifts from the checkout after every ``git pull`` (dist said 0.21.0 while the code was 0.21.4), so gating on it skipped plugins that required exactly the release the user was running.r __version__z hermes-agent)rIrr9rrmetadatar#rs rLrunning_hermes_versionrsJ  * {# #     % %n 55    s5 AAz^\d+ctjdt|jj dddjd}|dgdt |z zz }g}|ddD]R}t j|j}|y|jt|jdTt|S) u``v1.2.3-rc1`` / ``1.2.3rc1`` / ``1.2.3.post1`` → ``(1, 2, 3)``; ``None`` when a segment has no leading digits. PEP 440 pre/post/dev suffixes glued to a segment (``0rc1``) are dropped so an rc *target* still gates and an rc *running* version does not disable every gate.z[-+]vrrr0N) rerr9rglstripr_VERSION_SEGMENT_REmatchrr;grouptuple)rrrxms rL_version_tupler&s HHWc!flln33C8! =``/``>``/``<=``/``<``/``==``/``!=`` clauses (comma = AND; bare version = ``>=``). Unparseable versions are permissive — no PEP 440 dependency for a one-field manifest gate.NT)>=z<=z==z!=>.sCa Cs,rr8r(F) r&__ge____le____eq____ne____gt____lt__filterr_VERSION_COMPARATOR_REr!r") rcurrentcuropsclauser%optargettgts rLversion_satisfiesr<s  !C {3::SZZszzX[XbXbilisis tCC4::c?CD " ( ( 012aggaj!''!*-v FV$ ?73r73<  rNc|jsyt}t|j|ryd|jd|S)zYLoad-blocking reason when the manifest's ``requires_hermes`` rejects the running version.Nzrequires hermes z , running )r/rr<)rr5s rLrequires_hermes_errorr>sC  # #$&G117; h667z' KKrNc hddlm}||\}}|D]#}tjd||j%|r|d|j n|d}t |d|jdd|jddt|jd d|t||d t| S) z]Build the manifest for a portable Agent Plugin directory (``plugin.json``); diagnostics warn.r)read_agent_plugin_manifestzAgent Plugin '%s': %s/rr#r]r'rT) rr#r'rr r rXr r) hermes_cli.agent_pluginsr@rwrxmessagerrrorur9r[)childr prefixr@ry diagnostics diagnosticrXs rLportable_plugin_manifestrHsC259D+!K .z7I7IJK&,VHAejj\ "$v,C  &\488Ir#:Q^`bHctxx"56vCPUJ\_'@'E rNc  |jdd}t|tr|jj nd}|t vr6t jd||djtt d}|dz }|dk(rkd|vrg|jrWtt5|jddd d }t|}|r|}t jd |||d d d |S|S#1swY|SxYw) zNormalize ``kind``; undeclared memory/model providers are auto-detected from ``__init__.py`` so they route to their own discovery instead of the general manager.rrzBPlugin %s: unknown kind '%s' (valid: %s); treating as 'standalone'rlrrrP)rrN z-Plugin %s: detected %s, treating as kind='%s')rortr9rgrfrrwrxrerexistsrrrrr)ryrX plugin_dirraw_kindr init_filerdetecteds rL_manifest_kindrPsxx -H'1(C'@8>>  ! ! #lD && P 499V,?%@A ]*I |d 2y7G7G7I i  g#--Y-QRWSWXK/ C88DcH ttjd|yt|j dxsi}t |t s+tjd|t|jy|jd|j}|r|d|jn|}t|||}tjd|||||td|t|jd d |jd d t|jd d |jd g|jdg|jd|jdg|t|||t|jdxsd j!t#|jd|d t%|||jdxsg|jdxsgdS#t&$r+}tjd||t)Yd}~yd}~wwxYw)zWParse one ``plugin.yaml`` into a :class:`PluginManifest`; ``None`` (warned) on failure.Nu'PyYAML not installed – cannot load %srP)rz@Failed to parse %s: top level must be a mapping, got %s (#14066)rrAz9Parsed manifest: key=%s name=%s kind=%s source=%s path=%sr#r]r'rr*r-r,rr/r() rr#r'rr*r-r,r r rrXr/r(rr")rr"zFailed to parse %s: %s)exc_infor)yamlrwrxrrrtr rrrorrPrrr9rurg_parse_declared_capabilitiesrrrM) manifest_filerLr rEryrrXrrs rLparse_manifest_filerVs < NNDm Tm55w5GHNB$( NN]($t**=*= ?xx 0/5*//*+4dC4 GdTXZ`bl n  s488Ir#:;3ODHHU]_aLbrHrPrVrrNrLrfs # (KKK f   / 0 dXd $ 6cVSFvQTV[P\ElTG$\`[b Gwf *&" +( "/ 7t@.b  "JO )  0505 05h$$HI 6!bjj)   L ,!!%)!36!@C!!i DsEE  E