ei5UdZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z ddlmZmZmZmZmZmZmZddlmZddlmZ ddlZn #e$rdZYnwxYwejeZhd Zd e d <d Z!d Z"d>dZ#d?dZ$d@dZ%hdZ&d e d<e GddZ'e GddZ(GddZ)Gdd Z*da+d!e d"<dAd#Z,dBdCd'Z-dDd,Z. dEdFd5Z/dBdGd6Z0d7Z1dHd9Z2dId;Z3dJd=Z4dS)Ku Hermes Plugin System ==================== Discovers, loads, and manages plugins from four sources: 1. **Bundled plugins** – ``/plugins//`` (shipped with hermes-agent; ``memory/`` and ``context_engine/`` subdirs are excluded — they have their own discovery paths) 2. **User plugins** – ``~/.hermes/plugins//`` 3. **Project plugins** – ``./.hermes/plugins//`` (opt-in via ``HERMES_ENABLE_PROJECT_PLUGINS``) 4. **Pip plugins** – packages that expose the ``hermes_agent.plugins`` entry-point group. Later sources override earlier ones on name collision, so a user or project plugin with the same name as a bundled plugin replaces it. Each directory plugin must contain a ``plugin.yaml`` manifest **and** an ``__init__.py`` with a ``register(ctx)`` function. Lifecycle hooks --------------- Plugins may register callbacks for any of the hooks in ``VALID_HOOKS``. The agent core calls ``invoke_hook(name, **kwargs)`` at the appropriate points. Tool registration ----------------- ``PluginContext.register_tool()`` delegates to ``tools.registry.register()`` so plugin-defined tools appear alongside the built-in tools. ) annotationsN) dataclassfield)Path)AnyCallableDictListOptionalSetUnion)get_hermes_homeenv_var_enabled> pre_llm_call post_llm_call pre_tool_call subagent_stopon_session_endpost_tool_callpre_api_requeston_session_reseton_session_startpost_api_requeston_session_finalizepre_gateway_dispatchtransform_tool_resulttransform_terminal_outputzSet[str] VALID_HOOKSzhermes_agent.pluginshermes_pluginsnamestrreturnboolc t|S)zbackend exclusive standalone_VALID_PLUGIN_KINDSceZdZUdZded<dZded<dZded<dZded<ee Z d ed <ee Z d ed <ee Z d ed <dZ ded<dZded<dZded<dZded<dS)PluginManifestz0Parsed representation of a plugin.yaml manifest.r"r!version descriptionauthordefault_factoryz List[Union[str, Dict[str, Any]]] requires_env List[str]provides_toolsprovides_hookssourceN Optional[str]pathr>kindkey)__name__ __module__ __qualname____doc____annotations__rCrDrErr2rHrJrKrLrNrOrPr(r&rArAs:: IIIGKF5:U45P5P5PLPPPP %d ; ; ;N;;;; %d ; ; ;N;;;;FDD CMMMMMMr(rAceZdZUdZded<dZded<eeZded <eeZ ded <eeZ ded <d Z d ed<dZ ded<dS) LoadedPluginz)Runtime state for a single loaded plugin.rAmanifestNzOptional[types.ModuleType]modulerFrItools_registeredhooks_registeredcommands_registeredFr$r8rMerror) rQrRrSrTrUrZrr2r[r\r]r8r^rVr(r&rXrXs33)-F----"'%"="="====="'%"="="=====%*U4%@%@%@@@@@GEr(rXceZdZdZd1dZ d2d3dZd4d5dZ d6d7d#Z d8d9d%Zd:d(Z d;d)Z d;d*Z dd0Z dS)? PluginContextz=Facade given to plugins so they can register tools and hooks.rYrAmanager'PluginManager'c"||_||_dSN)rY_manager)selfrYras r&__init__zPluginContext.__init__s   r(NFrBr!r"toolsetschemar9handlerrcheck_fnCallable | NonerH list | Noneis_asyncr$rDemojir#Nonec ddlm} | |||||||||  |jj|t d|jj |dS)zKRegister a tool in the global registry **and** track it as plugin-provided.rregistry) r!rhrirjrkrHrnrDrozPlugin %s registered tool: %sN) tools.registryrsregisterre_plugin_tool_namesaddloggerdebugrYr!) rfr!rhrirjrkrHrnrDrorss r& register_toolzPluginContext.register_tools ,+++++%#   (,,T222 4dm6H$OOOOOr(usercontentrolec|jj}|tddS|dkr|nd|d|}t |ddr|j|n|j|dS) aInject a message into the active conversation. If the agent is idle (waiting for user input), this starts a new turn. If the agent is running, this interrupts and injects the message. This enables plugins (e.g. remote control viewers, messaging bridges) to send messages into the conversation from external sources. Returns True if the message was queued successfully. Nz@inject_message: no CLI reference (not available in gateway mode)Fr{[z] _agent_runningT)re_cli_refrxwarninggetattr_interrupt_queueput_pending_input)rfr|r}climsgs r&inject_messagezPluginContext.inject_messagesm$ ; NN] ^ ^ ^5gg-B-B-B-B-B 3(% 0 0 (  $ $S ) ) ) )   " "3 ' ' 'tr(helpsetup_fn handler_fnc||||||jjd|jj|<td|jj|dS)aRegister a CLI subcommand (e.g. ``hermes honcho ...``). The *setup_fn* receives an argparse subparser and should add any arguments/sub-subparsers. If *handler_fn* is provided it is set as the default dispatch function via ``set_defaults(func=...)``.)r!rrDrrpluginz$Plugin %s registered CLI command: %sN)rYr!re _cli_commandsrxry)rfr!rrrrDs r&register_cli_commandz"PluginContext.register_cli_commandsV& $m( - -  #D)  ;T]=OQUVVVVVr( args_hintc<|ddd}|s'td|jjdS ddlm }||(td|jj|dSn#t$rYnwxYw||pd |jj|pd d |j j |<t d |jj|dS) uRegister a slash command (e.g. ``/lcm``) available in CLI and gateway sessions. The handler signature is ``fn(raw_args: str) -> str | None``. It may also be an async callable — the gateway dispatch handles both. Unlike ``register_cli_command()`` (which creates ``hermes `` terminal commands), this registers in-session slash commands that users invoke during a conversation. ``args_hint`` is an optional short string (e.g. ``""`` or ``"dias:7 formato:json"``) used by gateway adapters to surface the command with an argument field — for example Discord's native slash command picker. Plugin commands without ``args_hint`` register as parameterless in Discord and still accept trailing text when invoked as free-form chat. Names conflicting with built-in commands are rejected with a warning. / -z;Plugin '%s' tried to register a command with an empty name.Nr)resolve_commandz^Plugin '%s' tried to register command '/%s' which conflicts with a built-in command. Skipping.zPlugin commandrB)rjrDrrz!Plugin %s registered command: /%s)lowerstriplstripreplacerxrrYr!hermes_cli.commandsrr3re_plugin_commandsry)rfr!rjrDrcleanrs r&register_commandzPluginContext.register_command!sH2 ""$$++C0088cBB  NNM "    F  ; ; ; ; ; ;u%%19M&  2    D &:*:m(#/r0022 1 1  &u-  8$-:LeTTTTTs87B22 B?>B? tool_nameargsc ddlm}d|vr(|jj}|rt |ddnd}|||d<|j||fi|S)uDispatch a tool call through the registry, with parent agent context. This is the public interface for plugin slash commands that need to call tools like ``delegate_task`` without reaching into framework internals. The parent agent (if available) is resolved automatically — plugins never need to access the agent directly. Args: tool_name: Registry name of the tool (e.g. ``"delegate_task"``). args: Tool arguments dict (same as what the model would pass). **kwargs: Extra keyword args forwarded to the registry dispatch. Returns: JSON string from the tool handler (same format as model tool calls). rrr parent_agentagentN)rtrsrerrdispatch)rfrrkwargsrsrrs r& dispatch_toolzPluginContext.dispatch_toolYsu ,+++++  ' '-(C36@GC$///DE ).~& x D;;F;;;r(cT|jj'td|jjdSddlm}t||s'td|jjdS||j_t d|jj|jdS)a%Register a context engine to replace the built-in ContextCompressor. Only one context engine plugin is allowed. If a second plugin tries to register one, it is rejected with a warning. The engine must be an instance of ``agent.context_engine.ContextEngine``. NzyPlugin '%s' tried to register a context engine, but one is already registered. Only one context engine plugin is allowed.r) ContextEnginezbPlugin '%s' tried to register a context engine that does not inherit from ContextEngine. Ignoring.z)Plugin '%s' registered context engine: %s) re_context_enginerxrrYr!agent.context_enginerr1info)rfenginers r&register_context_enginez%PluginContext.register_context_enginexs = ( 4 NNQ "    F666666&-00  NN8 "    F(. % 7 M       r(cddlm}ddlm}t ||s't d|jjdS||t d|jj|jdS)a=Register an image generation backend. ``provider`` must be an instance of :class:`agent.image_gen_provider.ImageGenProvider`. The ``provider.name`` attribute is what ``image_gen.provider`` in ``config.yaml`` matches against when routing ``image_generate`` tool calls. r)ImageGenProvider)register_providerzjPlugin '%s' tried to register an image_gen provider that does not inherit from ImageGenProvider. Ignoring.Nz-Plugin '%s' registered image_gen provider: %s) agent.image_gen_providerragent.image_gen_registryrr1rxrrYr!r)rfproviderrrs r&register_image_gen_providerz)PluginContext.register_image_gen_providers >=====>>>>>>($455  NN? "    F(### ; M       r( hook_namecallbackc b|tvrLtd|jj|dt t|jj |g |t d|jj|dS)zRegister a lifecycle hook callback. Unknown hook names produce a warning but are still stored so forward-compatible plugins don't break. z4Plugin '%s' registered unknown hook '%s' (valid: %s), zPlugin %s registered hook: %sN) rrxrrYr!joinsortedre_hooks setdefaultappendry)rfrrs r& register_hookzPluginContext.register_hooks K ' ' NN " &--..     '' 266==hGGG 4dm6H)TTTTTr(rNrcddlm}d|vr td|d|jjd|r||std|d|std ||jjd|}||jj||d |jj |<t d |jj|d S) uRegister a read-only skill provided by this plugin. The skill becomes resolvable as ``':'`` via ``skill_view()``. It does **not** enter the flat ``~/.hermes/skills/`` tree and is **not** listed in the system prompt's ```` index — plugin skills are opt-in explicit loads only. Raises: ValueError: if *name* contains ``':'`` or invalid characters. FileNotFoundError: if *path* does not exist. r) _NAMESPACE_RE:z Skill name 'zG' must not contain ':' (the namespace is derived from the plugin name 'z' automatically).zInvalid skill name 'z'. Must match [a-zA-Z0-9_-]+.zSKILL.md not found at )rNr bare_namerDzPlugin %s registered skill: %sN) agent.skill_utilsr ValueErrorrYr!matchexistsFileNotFoundErrorre_plugin_skillsrxry)rfr!rNrDr qualifieds r&register_skillzPluginContext.register_skills0$ 433333 $;;:t::M&:::   =..t44 JtJJJ {{}} E#$CT$C$CDD D})22D22 m(& 3 3  $Y/  , M       r()rYrArarb)NNFrBrB)r!r"rhr"rir9rjrrkrlrHrmrnr$rDr"ror"r#rp)r{)r|r"r}r"r#r$)NrB) r!r"rr"rrrrlrDr"r#rp)rBrB) r!r"rjrrDr"rr"r#rp)rr"rr9r#r"r#rp)rr"rrr#rp)rB)r!r"rNrrDr"r#rp)rQrRrSrTrgrzrrrrrrrrrVr(r&r`r`s7GG    %)$(PPPPP>B'+ WWWWW: 4U4U4U4U4Up<<<<>    @    6UUUU. + + + + + + + r(r`ceZdZdZd/dZd0d1dZ d2d3dZd4dZd5dZd6dZ d7dZ d8dZ d8d Z d9d%Z d:d'Zd;d*Zd PluginManagerz;Central manager that discovers, loads, and invokes plugins.r#rpci|_i|_t|_i|_d|_i|_d|_d|_i|_ dS)NF) _pluginsrr)rvrrr _discoveredrr)rfs r&rgzPluginManager.__init__sQ13 13 ,/EE.0#13!& 9;r(Fforcer$c ~|jr|sdS|r|j|j|j|j|j|jd|_d|_g}tt j j dz }| ||dddhtdz }| ||d t!d rCtjd z dz }| ||d | |t'}t)}i}|D]} | || jp| j<|D]K} | jp| j} | |vs | j|vr>t1| d } d| _| |j| <t4d| \| jdkr>t1| d } d| _| |j| <t4d| | jdkr!| jdkr|| |duo | |vp| j|v} | sRt1| d } d| | _| |j| <t4d| 6|| M|r^t4 dtC|jtEd|jDdSdS)aScan all plugin sources and load each plugin found. When ``force`` is true, clear cached discovery state first so config changes or newly-added bundled backends become visible in long-lived sessions without requiring a full agent restart. NTr-bundledmemorycontext_engine)rL skip_namesr{)rLHERMES_ENABLE_PROJECT_PLUGINSz.hermesprojectF)rYr8zdisabled via configzSkipping disabled plugin '%s'r=u<exclusive plugin — activate via .provider configz8Skipping '%s' (exclusive, handled by category discovery)r<zBnot enabled in config (run `hermes plugins enable {}` to activate)z&Skipping '%s' (not in plugins.enabled)z/Plugin discovery complete: %d found, %d enabledc3(K|] }|j dVdS)N)r8).0ps r& z2PluginManager.discover_and_load..s)CC!CACCCCCCr()#rrclearrrvrrrrr__file__resolveparentextend_scan_directoryrr'cwd_scan_entry_pointsr5r;rPr!valuesrXr^rxryrOrL _load_pluginformatrlensum) rfr manifests repo_pluginsuser_dir project_dirr.r8winnersrY lookup_keyloaded is_enableds r&discover_and_loadzPluginManager.discover_and_load s   E  F  ( M   ! ! ! K       # ) ) + + +   $ $ & & &  ! ' ' ) ) )   % % ' ' '#'D *, H~~--//6= I    $&67 !     #$$y0--hv-FFGGG 7 8 8 R(**y09 >H5=GHL1HM 2 2((6 (6 (H!6JX%%()B)B%xGGG4 ,2 j) //plugin.yaml``. Key is ```` (e.g. ``disk-cleanup``). * **Category** — ``///plugin.yaml``, where the ```` directory itself has no ``plugin.yaml``. Key is ``/`` (e.g. ``image_gen/openai``). Depth is capped at two segments. *skip_names* is an optional allow-list of names to ignore at the top level (kept for back-compat; the current call sites no longer pass it now that categories are first-class). rBrrprefixdepth)_scan_directory_level)rfrNrLrs r&rzPluginManager._scan_directorys,*)) &Z!*   r(rrintc ^g}|s|St|D]}|s|dkr |r |j|vr)|dz }|s|dz }|r0|||||} | || |dkrtd||r |d|jn|j} | | ||d| |dz|S) aRecursive implementation of :meth:`_scan_directory`. ``prefix`` is the category path already accumulated ("" at root, "image_gen" one level in). ``depth`` is the recursion depth; we cap at 2 so ``/a/b/c/`` is ignored. rz plugin.yamlz plugin.ymlNrz/Skipping %s (no plugin.yaml, depth cap reached)rr) is_dirriterdirr!r_parse_manifestrrxryrr) rfrNrLrrrrchild manifest_filerY sub_prefixs r&rz#PluginManager._scan_directory_levels{+- {{}}  DLLNN++! ! E<<>> zzjzUZ:-E-E!M1M '')) 5 % 4 ##%% //!5&&'$$X... zz NPUVVV5;KF11UZ111J   **#%!) +    r(r plugin_dirOptional[PluginManifest]c  ttd|dStj|pi}|d|j}|r |d|jn|}|dd}t|tsd}| } | tvrDtd||d ttd} | dkrrd|vrn|d z } | rU | d dd } d | vsd| vrd} td|n#t $rYnwxYwt#|t|dd|dd|dd|dg|dg|dg|t|| | S#t $r'} td|| Yd} ~ dSd} ~ wwxYw)zParse a single ``plugin.yaml`` into a :class:`PluginManifest`. Returns ``None`` on parse failure (logs a warning). Nu'PyYAML not installed – cannot load %sr!rrOr>zBPlugin %s: unknown kind '%s' (valid: %s); treating as 'standalone'r __init__.pyr)errorsi register_memory_providerMemoryProviderr=zAPlugin %s: detected memory provider, treating as kind='exclusive'rCrBrDrErHrJrK) r!rCrDrErHrJrKrLrNrOrPzFailed to parse %s: %s)yamlrxr safe_load read_textr0r!r1r"rrr?rrrryr3rA) rfrrrLrdatar!rPraw_kindrO init_file source_textexcs r&rzPluginManager._parse_manifests; |H-XXXt>-"9"9";";<<BD88FJO44D39CV//jo///tCxx 55Hh,, ('>>##))++D...X499V4G-H-H#I#I$|##d(:(:&6 ##%% &/&9&9&9&K&KETE&R 6+EE/;>>#.D"LL!? # %"DHHY3344 HH]B77xx"--!XXnb99#xx(8"==#xx(8"==__        NN3]C H H H44444 sC"H=DH==AFH= F H= FB.H== I.I))I.cg} tj}t|dr|t }n=t |tr|t g}n d|D}|D]9}t|j d|j |j }| |:n2#t$r%}td|Yd}~nd}~wwxYw|S)z7Check ``importlib.metadata`` for pip-installed plugins.selectgroupc2g|]}|jtk|SrVrENTRY_POINTS_GROUPreps r& z4PluginManager._scan_entry_points..7s%PPPB=O1O1OR1O1O1Or( entrypoint)r!rLrNrPzEntry-point scan failed: %sN) importlibmetadata entry_pointshasattrrrr1r9r0rAr!valuerr3rxry)rfreps group_epsrrYrs r&rz PluginManager._scan_entry_points,s%*,  =$1133CsH%% QJJ-?J@@ C&& QGG$6;; PP#PPP  + +)'    **** + = = = LL6 < < < < < < < < =sCC C7C22C7rYrAc6t} jdvr}n}||_t |dd}|(d|_tdj nt}||fdj D|_ tdjDd jDz |_fd jD|_d |_nL#t*$r?}t-||_td j |Yd}~nd}~wwxYw|jjpj <dS) z?Import a plugin module and call its ``register(ctx)`` function.)rY)r{rrruNzno register() functionz&Plugin '%s' has no register() functionc^g|])}|djDv'|*S)c,h|]\}}|jD]}|SrV)r[)rr!rns r& z8PluginManager._load_plugin...`sF!!!#D!!"!3!!!!!!r()ritems)rtrfs r&rz.PluginManager._load_plugin..^s`+++!!'+}':':'<'<!!!r(ch|] \}}|| SrVrV)rhcbss r&r(z-PluginManager._load_plugin..gs2"Asr(c,h|]\}}|jD]}|SrV)r\)rr!rr,s r&r(z-PluginManager._load_plugin..lsF#D!!"!3r(cfg|]-}j|djk+|.S)r)rr0r!)rcrYrfs r&rz.PluginManager._load_plugin..rsF...,Q/33H==NNNNNr(TzFailed to load plugin '%s': %s)rXrL_load_directory_module_load_entrypoint_modulerZrr^rxrr!r`rvr[r2rr)rr\rr]r8r3r"rP)rfrYrrZ register_fnctxrs`` r&rzPluginManager._load_pluginJsx000, Q"@@@44X>>55h??"FM"&*d;;K"7 GWWWW#Hd33 C   ++++#6+++'+/&*k&7&7&9&9 '+}':':'<'<  + +'.....#4...*"& Q Q Qs88FL NN;X]C P P P P P P P P Q8> hl3hm444sD"D77 F5E;;Ftypes.ModuleTypect|j}|dz }|std|tt jvr@tjt}g|_ t|_ |t jt<|j p|j }| dd dd}td|}tj||t#|g}||jt'd |tj|} || _ t#|g| _ | t j|<|j| | S) a/Import a directory-based plugin as ``hermes_plugins.``. The module slug is derived from ``manifest.key`` so category-namespaced plugins (``image_gen/openai``) import as ``hermes_plugins.image_gen__openai`` without colliding with any future ``tts/openai``. rzNo __init__.py in r__r_.)submodule_search_locationsNzCannot create module spec for )rrNrr _NS_PARENTsysmodulestypes ModuleType__path__ __package__rPr!rrutilspec_from_file_locationr"loader ImportErrormodule_from_spec exec_module) rfrYrrns_pkgrPslug module_namespecrZs r&r1z$PluginManager._load_directory_module~sn(-(( . !! G#$E$E$EFF F S[ ( (%j11F FO!+F &,CK #l+hm{{3%%--c377#,,d,, ~55  (+J'86   <4;.JyJJKK K0066(z??+#) K  ''' r(ctj}t|dr|t }n=t |tr|t g}n d|D}|D](}|j |j kr| cS)td|j dt d)z:Load a pip-installed plugin via its entry-point reference.rrc2g|]}|jtk|SrVrrs r&rz9PluginManager._load_entrypoint_module..s%LLLRX9K-K-K-K-K-Kr(z Entry point 'z' not found in group '') rrrr rrr1r9r0r!loadrE)rfrYr"r#rs r&r2z%PluginManager._load_entrypoint_modules --// 3 ! ! M ); <$o4%~ !899 !899 #F$> ? ?#\       r(qualified_nameOptional[Path]cN|j|}|r|dndS)z>Return the ``Path`` to a plugin skill's SKILL.md, or ``None``.rNN)rr0)rfr_entrys r&find_plugin_skillzPluginManager.find_plugin_skills+#''77 %/uV}}4/r( plugin_namerIcr|dtfd|jDS)zCReturn sorted bare names of all skills registered by *plugin_name*.rc3XK|]$\}}||dV%dS)rN) startswith)rqners r&rz3PluginManager.list_plugin_skills..sQ  A}}V$$ kN      r()rrr))rfrdrs @r&list_plugin_skillsz PluginManager.list_plugin_skillssX"""    ,2244      r(c<|j|ddS)z>Remove a stale registry entry (silently ignores missing keys).N)rpop)rfr_s r&remove_plugin_skillz!PluginManager.remove_plugin_skill s! 55555r(rFrr$r#rprd)rNrrLr"rrr#r) rNrrLr"rrrr"rrr#r) rrrrrLr"rr"r#r)r#r)rYrAr#rp)rYrAr#r5rr"rrr#rP)r#rX)r_r"r#r`)rdr"r#rI)r_r"r#rp)rQrRrSrTrgrrrrrrr1r2rWr^rcrjrmrVr(r&rrsPEE < < < < ~~~~~P*.      26666pFFFFX<2>2>2>2>h$$$$L    ,""""P20000     666666r(rzOptional[PluginManager]_plugin_managerc:ttatS)z>Return (and lazily create) the global PluginManager singleton.)rqrrVr(r&get_plugin_managerrss'// r(FrrpcJt|dS)zDiscover and load all plugins. Default behavior is idempotent. Pass ``force=True`` to rescan plugin manifests and reload state in the current process. rNrsrrus r&discover_pluginsrws' ***77777r(rrrrPc 6tj|fi|S)z|Invoke a lifecycle hook on all loaded plugins. Returns a list of non-``None`` return values from plugin callbacks. )rsrW)rrs r&rWrW&s& ,    +I @ @ @ @@r(rBrrOptional[Dict[str, Any]]task_id session_id tool_call_idrMc(td|t|tr|ni|||}|D]b}t|ts|ddkr2|d}t|tr|r|cScdS)aCheck ``pre_tool_call`` hooks for a blocking directive. Plugins that need to enforce policy (rate limiting, security restrictions, approval workflows) can return:: {"action": "block", "message": "Reason the tool was blocked"} from their ``pre_tool_call`` callback. The first valid block directive wins. Invalid or irrelevant hook return values are silently ignored so existing observer-only hooks are unaffected. r)rrrzr{r|actionblockmessageN)rWr1r9r0r")rrrzr{r| hook_resultsr]rs r&get_pre_tool_call_block_messager/s$d++ 3TT! L&$''   ::h  7 * * **Y'' gs # #  NNN 4r(cNt}|||S)zReturn the global manager after ensuring plugin discovery has run. Pass ``force=True`` to rescan in the current process. rurv)rras r&_ensure_plugins_discoveredrVs+ !""G E*** Nr(c(tjS)z5Return the plugin-registered context engine, or None.)rrrVr(r&get_plugin_context_enginer`s % ' ' 77r(Optional[Callable]cftj|}|r|dndS)zFReturn the handler for a plugin-registered slash command, or ``None``.rjN)rrr0)r!rbs r&get_plugin_command_handlerres3 & ( ( 9 = =d C CE$ .5  $.r(Dict[str, dict]c(tjS)uReturn the full plugin commands dict (name → {handler, description, plugin}). Triggers idempotent plugin discovery so callers can use plugin commands before any explicit discover_plugins() call. )rrrVr(r&get_plugin_commandsrks & ' ' 88r( List[tuple]cDt}|jsgS ddlm}n#t$rgcYSwxYwi}i}|jD]O}||}|s|j}||g|j P|j D]J\}}|j D]=}||}|r$|j|vr||j|>Kg} t|D]} || } d| dd} | r| jjr | jj} n(dt|| } | | | | f| S)zReturn plugin toolsets as ``(key, label, description)`` tuples. Used by the ``hermes tools`` TUI so plugin-provided toolsets appear alongside the built-in ones and can be toggled on/off per platform. rrru🔌 r8rr)rsrvrtrsr3 get_entryrhrrr!rr)r[rr0rtitlerYrDr)rars toolset_toolstoolset_pluginrrbts_namerr]ts_keyrlabeldescs r&get_plugin_toolsetsrts !""G  % +++++++  +-M.0N/<< ""9--   ]  R((// ;;;;!)//11AA v0 A AI&&y11E A-77))%-@@@ A F''--##F++:sC006688::   dataclassesrrpathlibrtypingrrr r r r r hermes_constantsrutilsrr rE getLoggerrQrxrrUrr;r'r5r;r?rArXr`rrqrsrwrWrrrrrrrVr(r&rssB#""""" ((((((((BBBBBBBBBBBBBBBBBB,,,,,,!!!!!!KKKK DDD  8 $ $  0,  !!!!     D!G F FFFFF  >            m m m m m m m m h S6S6S6S6S6S6S6S6t,0////88888AAAA $$$$$N888 //// 9999******sAAA