+ Wj<BRt^RIHt^RIt^RIt^RIHt^RIHtH t H t H t ]P!] 4t]P!4t]!0R m4tRRltRRltR R ltR R /R RlltRRltRRltRRltRRltRtRRltRRltRRltRRltR#)!aMid-run plugin activation: what a just-loaded plugin does NOW vs next session (#87770). One seam for every surface: ``PluginManager.on_plugin_loaded`` fires with one :func:`plugin_activation_summary` per loaded plugin. Gateway handlers (slash commands, transform hooks, platform callbacks) are live as soon as the plugin loads; portable MCP servers and skills go live in the open chats of the plugin's profile (:func:`load_and_go_live`; MCP tools are deferred behind tool_search, so the cached prompt prefix is unchanged); Python tools and system-prompt sections stay deferred to the next session (prompt-cache invariant, same as ``/skills install``). :func:`activate_plugin_now` is what the install / enable / update surfaces call after a successful config or tree change. ) annotationsN)Path)AnyDictListOptionalc$V^8dQhRRRRRR/#)managerr plugin_keystrreturndict[str, Any])formats"QC:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_cli\plugins_activation.py __annotate__rs&+Y+Ys+Y+Y+Yc RaVPPV4p\VRR4p\VRR4;'gToVPPV.4Uu.uFp\VRR4'gKVNK pp/pVFApVP VP .4P \VP44KC /pVPR4'd\VR,4VR&\VPRR44p V \,'d\V \,4VR &V \, 'd\V \, 4VR &\V3R lVPP444p YPR R4U u.uFp R V 2NK up , p V 'dWR&VPR4'd\VR,4VR&/p \\VPRR44\\VRR4;'gR4,\\VRR4;'gR4,4p V 'dWR&VPR4'd\VR,4V R&\\VPRR44VPP4UUu0uFwrW8XgK VkK upp,4pV'dVV R&RSRVRVRV /#uupiuup iuuppi)a``{name, key, activated_now: {kind: [names]}, deferred: {kind: [names]}}`` for one loaded plugin, read from what it actually registered (ownership ledger + handler registries), not from what its manifest promises. Keys appear only when non-empty. ``activated_now``: ``gateway_commands`` (slash names), ``gateway_transforms`` / ``hooks`` (hook names), ``callbacks`` (platforms with a ``register_platform_handler`` factory / Slack action ids), ``locales`` (``.`` language-pack layers). ``deferred``: ``tools`` (tool names; next session), ``prompt`` (section ids; next session), ``mcp_servers`` (the plugin's mcp.json server names exactly as registered; until ``mcp.reload``).manifestNnameactiveTcommandgateway_commandshookgateway_transformshooksc3<"TFKwr\;QJdV3RlV4F 'gK RM RM!V3RlV44'gKGVxKM R#5i)c32<"TF wrVS8HxK R#5iNr).0_fpluginrs& r 6plugin_activation_summary...9sIyfnysTFN)any)r platform factoriesrs& rr#,plugin_activation_summary..8s<K;f$7H#IyI###IyII x;fs&AA Aslack_action_handlerzslack: callbackslocalelocalestooltools_registeredprovides_toolstoolssystem_prompt_sectionprompt portable_mcp mcp_serverskey activated_nowdeferredr)_pluginsgetgetattr_ownership_ledger setdefaultkindappendr r5sortedset_GATEWAY_TRANSFORM_HOOKS_platform_handler_factoriesitems_portable_mcp_server_plugins)r r loadedrrregskindsregnowrr*ar7r0sownerserversrs&& @rplugin_activation_summaryrOs   ! !* -Fvz40H 8VT * 8 8jD0044ZD cD!PQS[]aHbAADD c"$E 2&--c#''l; "C yy"(y)9":   &"% &E '''$*53K+K$L ! '''e&>>?G K7;^;^;d;d;fKKI 2H"(MN(M1F1#,(MNNI$K yyh0I%'H 3uyy,-GFDVX\4]4c4cac0dd+;TBHHbIJ KE ! yy())#E*A$BCS>267!>>DDF;_Fha%J]F;__`G") D%_c:x XX= dO;_sL9L,L L# .L# c V^8dQhRRRR/#)r r rr zlist[dict[str, Any]]r)rs"rrrMs#*>rc.p\VPP44FGwr#\VRR4'g\VRR4'dK-VP \ W44KI V#)uhOne summary per loaded (non-deferred-platform, non-errored) plugin — the ``on_plugin_loaded`` payload.r7FerrorN)listr8rCr:r>rO)r outr5rEs& ractivation_summariesrUMs` CG,,2245  6:u - -$1O1O  ,W:;6 Jrc$V^8dQhRRRRRR/#)r summarieszOptional[list[dict[str, Any]]]rr r Optional[dict[str, Any]]r)rs"rrrWs#=SMercT;'gRFYp\VPR4;'gR4pWPR4W3PR^4R,39gKWVu# R#)zQThe summary for ``name`` (manifest name, canonical key, or bare leaf of the key).r5r/Nr)r r9rsplit)rWrentryr5s&& rfind_activationr_Ws]b%))E"((b) IIf%sJJsA,>r,BC CL! r in_processTc$V^8dQhRRRRRR/#)r rr r`boolr rr)rs"rrr`s&ffcf$f.frc^RIHpV'd \V4MRpV'g4\V\ V!444;'g/P R4p\ 4p\T;'dVP R44pV'd*Vf&\T;'g/P R4V4pRVRVRV'*/#)uxAfter an install/enable/update: load the plugin in THIS process (so ``on_plugin_loaded`` subscribers here — the TUI/Desktop server — see it), connect its MCP servers and hand them plus its skills to the open chats of this profile (:func:`load_and_go_live`), and nudge the running gateway to load it too over its control socket so live adapters re-wire their handlers. A caller in another process (``hermes plugins install``) passes ``in_process=False``; the running Desktop / dashboard backend is then asked to do the in-process half (:func:`notify_serve_backend`). Never raises. Returns ``{"gateway_reloaded": bool, "activation": summary | None, "restart_required": bool}``. ``activation.live_now`` lists what is usable in open chats now; ``activation.deferred`` what waits for the next session. ``restart_required`` is True only when no gateway answered (old gateway, not running).get_hermes_homeN activationreloaded activationsgateway_reloadedrestart_required) hermes_constantsreload_and_go_livenotify_serve_backendrr9reload_running_gatewayrbr_)rr`rerfanswerrgs&$ ractivate_plugin_nowrp`s1EO+;D+AUYJ *4o6G1HIOORTTUab # %FF55vzz*56HJ&$fll%7%7 %FM , DV\dXd eercV^8dQhRR/#)r r rXr)rs"rrrws 8rc&^RIHp^RIHpHp\ V!44pV!V4pVf=\ V!44pVP 4VP 48wd V!WSR7pV# \d\PRRR7R#i;i)aAsk the gateway serving this profile (its own socket, else the multiplexer's for a served secondary) to force plugin re-discovery, so an enable loads and a disable unloads in the running gateway now. The ``reload-plugins`` answer, or None when no gateway answered.)reload_gateway_pluginsget_default_hermes_rootreN) profile_homez#gateway reload-plugins nudge failedTexc_info) gateway.control_socketrsrkrurerresolve Exceptionloggerdebug)rsrurehomeroroots rrnrnws} AMO%&'- >/12D||~//H  :T JsA'A**"BBc$V^8dQhRRRRRR/#)r rorXrr r r)rs"rrrs" ( ( 8 ( ( (rcV'dVPR4'dRV R2#Ve RVPR4;'gR R2#R#) aOne honest sentence after disabling plugin ``name``, a change only the gateway's re-discovery applies (an open session stops running its commands at once). Callbacks the plugin already wired into platform adapters outlive a reload (the plugin guide), so a restart still ends those.rgz6The running gateway reloaded its plugins and unloaded z[; platform hooks it already wired up stay until a gateway restart (hermes gateway restart).z3The running gateway refused to reload its plugins: rRzno reason givenzo. Only the saved config changed; restart the gateway serving this profile to apply it: hermes gateway restartzlNo running gateway answered. If one is running, restart it for this to take effect: hermes gateway restartr9)rors&&rgateway_reload_hintrse&**Z((HORR S EfjjQXFYFnFn]nEop++ , 'rc V^8dQhRRRR/#r rr r rXr)rs"rrrs  3 #; rcr\;_uu_4\V4uuRRR4# +'giR#;i)aForce-rediscover plugins in THIS process under the caller's profile scope, connect ``name``'s MCP servers and hand them (and its skills) to this profile's open chats with a turn note. Returns the activation summary with ``live_now: {mcp_servers, skills}``; ``deferred`` then keeps only what waits for the next session (Python ``tools``, ``prompt``). None when the plugin did not load.N) _GO_LIVE_LOCK_go_live)rs&rrlrls ~ s % 6 c V^8dQhRRRR/#rr)rs"rrrs33rc^RIHpHpHp^RIHpHpV!4V!4pVP;_uu_4VPRR7\\V4V4pVP4pV'dV!VR,4M.p RRR4XfR#T!TX4p R T R X /TR &TPR 4;'g/P!4U U u/uFwrT R 8wgKYbK up p TR &^RIp T P$PR 4pT!T4pTeBT 'g T'd2^RIHpTP+\-T!44TR,T4T#T# +'giL;i \d\PRTRR7R#i;iuup p i \d\P/RTRR7T#i;i))connect_plugin_mcp live_notice plugin_skills)_join_background_discoveryget_plugin_managerT)forcer5Nz2in-process plugin reload after change to %r failedrwr4skillslive_nowr7ztui_gateway.serverrdz1open chats were not refreshed after activating %r)"hermes_cli.plugins_activation_liverrrhermes_cli.pluginsrr_discovery_lockdiscover_and_loadr_rUget_portable_mcp_serversr{r|r}r9rCsysmodulesrkrerefresh_plugin_sessionsrwarning)rrrrrrr rfportablerrNkvrservernoteres& rrrsaa U"$$& $ $ $  % %D % 1()=g)FMJ779H9C]:e#45F % X6G+WhGJz0:z0J0P0Pb/W/W/Yp/Ytq]^bo]odad/YpJz [[__1 2F z "D w$4 e  * *40A+BJuDUW[ \ :-% $  I4Z^ _q e NNNPT_cN d  esM*E1AEE1 F#F2(F! E. )E1.E11#FF!#GGc^RIHpVPVP3FIpVP V4pVfKVP 'gK.VP V4'gKGVu# R#)zWThe host-owner record, else the Desktop child's (a Desktop-only box has no host owner).host_rendezvousN)gatewayr ROLE_SERVEROLE_DESKTOP_SERVE read_recordportrecord_token_is_consistent)hrrolerecords r_serve_backend_recordrsU- 5 56%  &+++"2O2OPV2W2WM7 rc$V^8dQhRRRRRR/#)r rr r~rr rXr)rs"rrrs"s$3Krc ^RIp^RIp^RIHp^RIHp\ 4pVfR#VPVP4pVPPRV!VPV44 RVP R2VPRVR\V4/4PR 4R R R R V/R7pVPP!V^ fkk*..((obll6&:;EEgNW]#%79QSXY )[ ^^ # #GR # 8 8H::hmmo44W=>9 8 8 8  =td Ss5"D'B4D'.D D' D$ D'$D''#E EcV^8dQhRR/#)r r rbr)rs"rrrs66$6rc:a^RIHo^RIHp^RIHpHp\V!44P4\V!44P40p\;QJdV3RlV4F 'gK RM RM!V3RlV44;'g V!4RJ#)zA gateway runs for this profile (its own, or the multiplexer serving it from the root), or a gateway service is installed for it.)get_running_pid)_installed_service_kindrtc3F<"TFpS!VR, RR7xK R#5i)z gateway.pidF) cleanup_staleNr)r r~rs& rr##_gateway_present..s"]W\t} 4EJJW\!TFN) gateway.statusrhermes_cli.gatewayrrkrurerrzr%)rrurehomesrs @r_gateway_presentrsu/:I /# $ , , .5L5N0O0W0W0Y ZE C]W\]CCC]W\] ] 5 5&(46rc V^8dQhRRRR/#)r rr r Noner)rs"rrrs,,S,T,rcp\\VRR74;p'dVPRV R24R#R#)zAfter a CLI install/enable: load *name* where it can go live now (:func:`activate_plugin_now`) and print :func:`activation_hint`, or nothing when there is nothing to say.F)r`z[dim]z[/dim]N)activation_hintrpprint)consolerhints&& rreport_activationrs724EJKKtK dV6*+Lrc V^8dQhRRRR/#)r resultrr r r)rs"rrrsYYNYsYrc a VPR4;'g/pVPR4;'g/pVPR4;'gRUu.uFq3PR4'gKVNK pp.pV'gVPR4'dM\RV44pTPRT R\VPR4;'gR4 R 24TP R VPR4;'gR44VPR 4'g?V'g\ 4'gR P V4#R P .VOR N4#VPR4;'g/VPR4;'g/r.p V'd1V PRRP \V44,4V'dCRRRRRR/o V PRRP V 3Rl\V444,4V 'gR P .VORN4#R P .VORRP V 4,R,N4#uupi)ztOne honest sentence for CLI surfaces from an :func:`activate_plugin_now` result; empty when there is nothing to say.rfrr4 connectedrc3j"TF)p\VPR4;'gR4xK+ R#5i)r0Nr)lenr9r rLs& rr#"activation_hint..s(Ay!Cg,,"--ys!33zLive in open chats now: z MCP tools, z skills.c3"TFEqPR4'dKRVR, RVPR4;'gR 2xKG R#5i)rz MCP server rz not connected: rRz unknown errorNrrs& rr#rsGS7Quu[?Q^;qyk)9!%%.:[:[O9\]7sA"A Ari zKRestart the gateway for the plugin to take effect: hermes gateway restartr6r7z#active in the running gateway now: z, r0ztools (next session)r2zsystem prompt (next session)zMCP servers (next session)z deferred: c3F<"TFpSPW4xK R#5irr)r rlabelss& rr#rs-YHX1fjj.>.>HXrzLGateway reloaded plugins; nothing of this plugin needs a session or restart.uGateway reloaded plugins — z; .r)r9sumr>rextendrjoinr?) ractliverLrlinesr0rJr7partsrs & @rrrs **\ " ( (bC 77:  $ $"D HH]399r9P9qUU;=O9IP EDHHX&&AyAA /wl3txxPXGYG_G_]_C`Baaijk LLS((=177R7SS ::( ) ) (**99U# #yyq5q"pqrrGGO,22CGGJ4G4M4M2 E  :TYYvc{=SST")+A8Mk"/1M"O \DII-YxHX-Y$YYZ yyq5q"pqrr 99WuW= %@PPSVVW XX/Qs I52I5> pre_commandpre_gateway_dispatchtransform_llm_outputtransform_tool_resultgateway_platform_eventtransform_terminal_output) __doc__ __future__rlogging threadingpathlibrtypingrrrr getLogger__name__r|Lockr frozensetrArOrUr_rprnrrlrrrmrrrrrrrs #,,   8 $ %& +Y\ff.& ( B06,Yr