+ kHjla0t$Rt^RIHt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI H t ^RI Ht^RIHtHtHtHt^RIHt^RIHt]'d^RIHt] P6!]4t] !]4P>t R t!/t"R ]#R &RDt$R ]#R &RRlt%Rt&]PNt(]PRt*RRlt+RRlt,RRlt-RRlt.RRlt/RRlt0RRlt1Rt2R R!lt3R"R#lt4R$R%lt5R&R'lt6R(R)lt7R*R/R+R,llt8RER-R.llt9R/R0lt:RER1R2llt;R3R4lt!R:R;4t?R<R=lt@R>R?ltARER@RAlltBRBRCltCR#)Fu6Memory provider plugin discovery: bundled ``plugins/memory//``, user ``$HERMES_HOME/plugins//``, project ``./.hermes/plugins//`` (opt-in via HERMES_ENABLE_PROJECT_PLUGINS), then ``hermes_agent.memory_providers`` entry points. Precedence is deliberately the REVERSE of PluginManager's later-source-wins: bundled wins, then user, project, entry point — a provider is activated by name (``memory.provider``, one at a time), so a directory dropped into the working tree must never shadow a shipped provider. Changing this order is a breaking change. ) annotationsN)Path)SimpleNamespace)ListOptionalTuple TYPE_CHECKING)cfg_get) plugin_loaderMemoryProviderzhermes_agent.memory_providerszdict[str, dict[str, Path]]"_REGISTERED_MEMORY_PROVIDER_SKILLSztuple[str, ...]_NATIVE_WARM_IMPORTScV^8dQhRR/#)returnzdict[str, Path])formats"+_defines_memory_provider..^s66g[eVWWQ-GGD$1GEQ[es55F)sortedglobastparser9r; SyntaxError ValueErrorwalk isinstance ImportFromnamesnameasnameCallrGfuncClassDefanyrJ)r.moduletreenanoderJs& @rr:r:Os6*+ 99V--Y-UVD""&c1*UVX[XfXfJgh/0ww!&&DT:T'/YZYaYa'/ahh/6'/&ccHHTND$)).HDIIvt4gdiit6TMV/V$ --##6g[_[e[e6g###6g[_[e[e6g3g3g #, j1   &cs)'G#"G0 G0 +G0 ?G0 G-,G-c V^8dQhRRRR/#)r provider_dirrrr/r)rs"rrrdseedeterc^\VP9;'gVP\8H#N)_MEMORY_PLUGINS_DIRparentsparent)rcs&r _is_bundledrids' ,"6"6 6 d d,:M:MQd:ddrc$V^8dQhRRRRRR/#)rrcrrWstrrr)rs"rrrhs!88t83838rc\V4'dRV 2#\P!\VP 44P 44P 4R,p\ RV RV 2#)zY``plugins.memory.`` for bundled providers, else under the synthetic user namespace.zplugins.memory.:NN. __source_)rihashlibsha256rkresolveencode hexdigest_USER_NAMESPACE)rcrWdigests&& r _module_namerwhse<   '' ^^C 4 4 67>>@ A K K Mc RF avYvh 77rcV^8dQhRR/#)rrz list[Path]r)rs"rrrqsSSzSrcf\4\43Uu.uFq'gK VNK up#uupi)z=User then project plugin roots that exist (precedence order).)_get_user_plugins_dirr+)r*s r_external_source_dirsr{qs--/1I1KL RL!PQAAL RR Rs ..cV^8dQhRR/#)rrzlist[tuple[str, Path]]r)rs"rrrvs3rcB\P!\4Uu.uFqPV3NK ppVUUu0uFwr#VkK ppp\ 4Fp\ VP 44FpVP4'gKVPPR4'dK>VPV9gKQ\V4'gKdVPVP4VPVPV34K K V#uupiuuppi)zW``(name, path)`` for bundled, then user-installed, then project-local; first-seen wins.)_rn) _loaderiter_plugin_dirsrfrWr{rMiterdirr( startswithrAaddappend)childdirsrWr~seen source_dirs r_iter_provider_dirsrvs-4-E-EFY-Z [-ZEZZ -ZD [ $ %WTDD %+- J..01E  --j99JJd*+E22$ UZZ/02. K \ %s D Dc\PP4p\VR4'd \ VP \ R74#\V\4'd \ VP\ .44#VUu.uFqP\ 8XgKVNK up#uupi \d#p\PRT4.uRp?#Rp?ii;i)z1Yield pip-installed memory provider entry points.select)groupz+Memory provider entry-point scan failed: %sN) importlibmetadata entry_pointshasattrlistrENTRY_POINTS_GROUPrTdictgetrr)r<debug)epsepr@s r_iter_entry_pointsrs  --/ 3 ! ! ); <= =8B38M8MtCGG.34 HadTHad[]hphpuGiGTVTVadTH HTH  BCH sBAB34B3B3 B.%B.+B3.B33 C >CC C c V^8dQhRRRR/#)rrWrkrr!r)rs"rrrs E EC EN Erc:\V, pVP4'd VR, P4'dV#\4F8pW , pVP4'gK#\ V4'gK6Vu# \ \ V44#)a8Provider name -> directory: bundled, user, project, then a pip entry point's package dir. The entry-point case matters because ``config_schema.py`` and ``cli.py`` are read from disk, not imported; without a directory a pip-installed provider silently loses its dashboard panel and ``hermes `` commands.r1)rfr(r8r{rA_entry_point_package_dirfind_provider_entry_point)rWbundledr candidates& rfind_provider_dirrs{ "D(G~~W}4<<>>+- %     "9)"D"D . $$=d$C DDrcV^8dQhRR/#r r)rs"rrrs^rc ~VfR#^RIHpVP;'gRPR4^,P 4pV!V4pV'gR#\ V4pVP R8Xd VP#R# \d.p\PR\TRR4T4Rp?R#Rp?ii;i) u8Directory of an entry point's module, resolved WITHOUT importing it (discovery runs from the dashboard/argparse before a provider is selected; importing every candidate would run arbitrary code). Only package entry points yield a directory — a bare ``module.py`` has nowhere for a sibling ``config_schema.py``.N)resolve_module_origin:r1z4Could not resolve directory for entry point '%s': %srW?) r&rvaluesplitstriprrWrhr)r<rrG) entry_pointr module_nameoriginr.r@s& rrrs  <"((..B55c:1=CCE &{3F|"ii=8t{{BdB  K[&#6 =s(B6B'BB B<"B77B<cV^8dQhRR/#)rrWrkr)rs"rrrsNNCNrc@a\V3Rl\44R4#)z;Resolve a provider name to a pip entry point, if installed.c3L<"TFqPS8XgKVxK R#5irerW)rHrrWs& rrK,find_provider_entry_point..sF2ggo2s$ $N)nextrrsfrrrs F02F MMrcV^8dQhRR/#)rrz list[str]r)rs"rrrsIrc\4UUu0uFwrVkK pppVPR\444\V4#uuppi)uCheap name-only listing (directory scan + entry-point enumeration, no import or availability check) — safe at module-import time (dashboard dropdown).c38"TFqPxK R#5irer)rHrs& rrK-list_memory_provider_names..s8#7R#7s)rupdaterrM)rWr~rVs rlist_memory_provider_namesrsD"5!6 7!6gdT!6E 7 LL8#5#788 %= 8s A cV^8dQhRR/#)rrzlist[tuple[str, str, bool]]r)rs"rrrs#>rc \4UUu.uF6wrV\P!V4\P!V3Rl43NK8 pppVUUu0uFwpq0kK ppp\ 4FgpVP V9gKVP VP 4VPVP R\P!V3Rl434Ki V#uuppiuuppi)zo``[(name, description, is_available), ...]``; bundled wins on name collisions, then user directories, then pip.c\VRR7#Fregister_skills)_load_provider_from_dir)cs&r+discover_memory_providers..s 4KA_d4errc\VRR7#r)_load_provider_from_entry_point)rs&rrrs 'Fr[`'ar)rrread_plugin_descriptionprobe_availabilityrrWrr)rWrresultsr~rrs rdiscover_memory_providersrs /01KD w..u5  # #U$e f h0  $+ +7ZT1aD7D +)+   4 ' HH[%% & NNK,,b'2L2L%a3 , N ,s ._loadsI *<Y YI+.LTH,UV  NN4 ).{O\\rzMemory providerprovider)kindnounr<) _get_active_memory_providerrrr<r_explicitly_disabledr=r load_named)rWrrrrcsfd @@rload_memory_providerrs "="??$T*L&$,Ed,KK K/ _aef$8|$L$L 4594 A]]   dL%>OV`io pprc V^8dQhRRRR/#)rrW Optional[str]rr/r)rs"rrrs    rcPT;'g \4pV'gR#^RIHpHpV!4V8Xd0\ \ V4;'g \ R44'gR#Rp\ V4;p'd\W@4RJpM!\V4;peVP4RpV'd%\Fp\P!V4K V# \d\PRTRR7LSi;i \d\PRTRR7Koi;i) u*Import the provider's module (default: the configured ``memory.provider``) WITHOUT constructing a provider — the later ``load_memory_provider`` then hits ``sys.modules`` instead of a fresh native extension load. Exists so ``hermes acp`` can pay the heavy import (numpy / ML stack) on the main thread before any other thread starts: on Windows a first-time native import racing another thread's import chain deadlocked ``session/new`` (#58083). False when no provider is configured, the provider is unknown or its import fails (agent init reports that).F)ISOLATION_HOSTisolation_mode/NTz*memory provider '%s' warm-up import failed)exc_infozwarm-up import of %s skipped)rrrrrirr _load_packagerloadr)r<rrr import_module)rWrrimportedrcrr]s& rimport_memory_provider_modulers  0 0.0D J>)+>OPT>U>b>bY]^aYb2c2cHX,T2 2< 2$\8DH6t<#C;:C;>#D%$D%c V^8dQhRRRR/#)rrcrrWrkr)rs"rrrsCrc \P!\W4TR\\ V4'dRR7#\ R7#)zImport the provider package at *provider_dir* under the module name the loader owns (``plugins.memory.`` bundled, synthetic user namespace otherwise); None on failure.N)rgr<synthetic_namespace)r%zplugins.memory)rload_plugin_modulerwr<riru)rcrWs&&rrrsE  % %\(,-$/ $=$=D  DS  rc V^8dQhRRRR/#)rrWrk submodulerr)rs"rrr&s````rc\V4pVf\RV: R24h\W 4pVf\RV: R24hV'd&\P!VP RV 24#T#)aaThe package (or ``.``) of whichever copy of provider *name* is installed. Host-side code (dashboard host-block storage, OAuth routes, doctor, profile clone) used to ``import plugins.memory..``, which only exists for the bundled copy; a catalog install under ``$HERMES_HOME/plugins/`` loads under the synthetic user namespace, so those surfaces 500'd/404'd the moment the bundled copy left core. Resolving through ``find_provider_dir`` makes bundled and user-dir copies behave identically. Raises ``ImportError`` when the provider is not installed or lacks the submodule. memory provider z is not installedz failed to importrn)r ImportErrorrrr__name__)rWrrcpackages&& rimport_provider_moduler&sz%T*L,TH4EFGGL/G,TH4EFGGIR9 " "g&6&6%7q #D E_X__rcV^8dQhRR/#)rrrr)rs"rrr9s  (@ rc^RIHp\V4FIp\WR4p\ V\ 4'gK'\ W14'gK:W1JgKAV!4u# R# \dK]i;i)zTFirst instantiable ``MemoryProvider`` subclass found among *namespace*'s attributes.r N)agent.memory_providerr dirrGrTtype issubclassr)) namespacer attr_namerDs& r_instantiate_subclassr9s`4^ yT2 dD ! !j&F&F4Ke v $   sA!! A0/A0Tc V^8dQhRRRR/#)rrr/rrr)rs"rrrGs!!T!Um!rc^RIHpVP4p\W24'dV#\V\4'd\ W24'd V!4#\VR4'd^\VPVR7pVPVP\VRR4R7VP'd VP#\V4'dQV!4p\WR4'dV#\VPVR7pVPV4VP#\!V4pVf!\"P%RVP4V# \ dELi;i \dLi;i)uImport a provider entry point and extract the MemoryProvider instance: an instance, a subclass, a module with ``register(ctx)``, a factory / ``register`` callable, or a namespace holding a subclass — in that order.r registerr__file__Nr?z3Memory provider entry point '%s' loaded no provider)rr rrTrrr)r_ProviderCollectorrWcollectrrGrcallable TypeErrorrr<r)rrr loaded collectorrs&$ rrrGsL5    F&)) &$Jv$F$F 8Ovz""&{'7'7Y &//'&*d2ST    %% % xH(334'{'7'7Y &!!!!$V,H JKL\L\] O+      s$EE, E)(E), E:9E:c$V^8dQhRRRRRR/#)rrcrrr/rrr)rs"rrrks"&&$&D&Tl&rcZVPp^RIHp\V4'dRMV!4pVe&\ W!R7P W@\ W44#\W4pVfR#\VR4'dS\ W!R7pVPVPVPR7VP'd VP#\#V4# \dJpTPf\PRY'4Rp?L]\P!RY'4Rp?LxRp?ii;i)zMImport a provider module; ``register(ctx)`` first, else a top-level subclass.)user_plugin_hostNrrrzregister() failed for %s: %suvMemory provider '%s' raised after registering (%s) — using the registered provider; later registrations were skipped)rWrrrircollect_in_hostrwrrrrrr)rr<rr=r)rcrrWrhostmodres&$ rrrks    D<|,,42B2DD !$HXX  \ @B B  +C {sJ&tM     cll3<<  @    %% %  %% !!) ;TEEV s'C D*!$D% D%%D*cr]tRtRtRtRR/RRlltRR/R ltR R ltR tR t Rt Rt RRlt Rt RtR#)rizPlugin context for memory providers: captures ``register_memory_provider`` (the one call the activation path owns) and delegates other ``register_*`` calls to a real ``PluginContext`` so providers have the full plugin surface.rTc V^8dQhRRRR/#)rrWrkrr/r)rs"rr_ProviderCollector.__annotate__s!!S!d!rc HWnRVnW nRVnRVnR#re)rWr_register_skills_context _hook_source)selfrWrs&&$r__init___ProviderCollector.__init__s#  /  rr?Nc ^RIHp\PP \ VRR44pT!VP V'd \VR7MT4VnVP4PpVP;_uu_4VPVP4V!V4RRR4R# +'giR#;i)zRun ``register`` with this collector; hooks it registers form the fallback group that general discovery of the same source replaces (see ``PluginLedgerMixin``)._hook_source_of __module__rrN) hermes_cli.plugins_ledgerrsysmodulesrrGrWrr_plugin_context_manager_discovery_lock_drop_fallback_hooks)rrr?rr]managers&&$ rr_ProviderCollector.collects ><!DE+DII[aPV7Wgmn&&(11  $ $ $  ( ():): ; TN% $ $ $s $B99 C c V^8dQhRRRR/#)rrcrrrkr)rs"rrrs$Src  aa^RIHpV!SP\\ VR, 4R74SnSP 4PoRVV3RllpV!4VPW#RRSVR7Sn SP#) u ``collect`` for a provider whose code runs in the plugin host: the host captures the provider and forwards every other registration here. The discovery lock is NOT held across the host call — its registrations arrive on another thread and take the lock themselves.rr1rcV^8dQhRR/#)rrNoner)rs"rr8_ProviderCollector.collect_in_host..__annotate__s @ @D @rc<SP;_uu_4SPSP4RRR4R# +'giR#;ire)r!r"r)r#rsr drop_hooks6_ProviderCollector.collect_in_host..drop_hookss2(((,,T->->?)(((s < A r7z$agent.memory_provider:MemoryProvider)rcapturebase_refctx before_reload) rrrWrrkrrr  load_instancer)rr rcrrr+r#sf&&& @rr "_ProviderCollector.collect_in_hosts >+DIIPST`cpTpPq7rs&&(11 @ @  ** ;U;U_+a }}rc VP4pVPP;_uu_4VPPW0PW4uuRRR4# +'giR#;ire)rr r!_register_fallback_hookr)r hook_namecallbackcontexts&&& r register_hook _ProviderCollector.register_hooksN&&(    - - -##;;GEVEVXal. - - -s &A  A1 c WnR#re)r)rrs&&rr7+_ProviderCollector.register_memory_providers rc VP'gR#VP4P!V/VBVP RV'd V^,MVP R4 2p^RIHpV!4PV4pVeV\4V&R#R# \d-p\PRTPT4Rp?R#Rp?ii;i)zForward skills to the plugin registry, tracking qualified name + path so switching the active provider can retract the previous one's skills. Gated on ``register_skills`` so inspecting an inactive provider has no side effects.NrrWget_plugin_managerz1Memory provider '%s' failed to register skill: %s) rrregister_skillrWrr&r>find_plugin_skillrr)r<r)rargskwargsqualified_namer>registered_pathr@s&*, rr?!_ProviderCollector.register_skills$$$  ^  " 1 14 B6 B $ {!tDGFAS+TUN =02DD^TO*GV24^D+ ^ LLLdiiY\ ] ] ^s4B A B C#!C  Cc R#rer)rrArBs&*,rregister_cli_command'_ProviderCollector.register_cli_commands rcV^8dQhRR/#)rrDrkr)rs"rrrsrc \aaSPR4'g \S4hVV3RlpV#)zDelegate any other ``register_*`` call to a real ``PluginContext`` (a hand-maintained stub drifted: unknown calls raised and cost the provider). Non-``register_*`` attributes raise normally so a typo still fails loudly. register_c<SP4PS4!V/VB# \d.p\P RSP ST4Rp?R#Rp?ii;i)z%Memory provider '%s' failed to %s: %sN)r__getattribute__r)r<r=rW)rArBr@rDrs*, r_forward0_ProviderCollector.__getattr__.._forwardsX ++->>tDdUfUU F SWY\] s$( A "AA )rAttributeError)rrDrNsff r __getattr___ProviderCollector.__getattr__s+{++ & & rc VPf;^RIHpHpHpV!VP VP R7pV!WC!44VnVP#)zA real ``PluginContext``, built once on demand: the common provider that only calls ``register_memory_provider`` must not pay for importing the plugin manager.) PluginContextPluginManifestr>)rWkey)rr&rTrUr>rW)rrTrUr>manifests& rr"_ProviderCollector._plugin_contextsD == \ \%499$))DH)(4F4HIDM}}r)rrrrWr)rr __qualname____firstlineno____doc__rrr r8r7r?rGrQr__static_attributes__rrrrrsET!T! $ &m !^$ "rrcV^8dQhRR/#)rrrr)rs"rrrs]rcp^RIHpV!4p\VRR4;'gR# \dR#i;i)zXActive provider name from config.yaml (``memory.provider``), or None. Reads config only. load_configmemoryrN)hermes_cli.configr`r r))r`configs rrrs:1vx4<<< s && 55c$V^8dQhRRRRRR/#)rrWrkrcrrr/r)rs"rrrs&EEsE$E4Erc \VP9dR#^RIHp\ V!4RR4p\ T\4'gR#YP0p^RI p\TR, RR7;_uu_4pTP\TPT4;'g/PR 4;'gR 44RRR4\YCUu0uFp\ T\4'gKTkK up,4# \ dR#i;i +'giL[;i \ dLki;iuupi) zTrue when a NON-bundled provider is parked in ``plugins.disabled`` under any spelling the plugin commands write: the provider name, its directory name or its manifest ``name:``.Fr_r%disabledNz plugin.yamlr3)r6rWr)rfrgrbr`r r)rTrrW hermes_yamlopenrrk safe_loadrr/)rWrcr`rfrVyamlfvs&& rrrsl2221;=)Z@ h % % $$ %E " ,. E E IIc4>>!,2277?EE2F GF HCHq 1c0BHCC DD F E    CsTD D*7AD9 DD*D; 2D;  DD D' "D*'D** D87D8c V^8dQhRRRR/#)ractive_providerrrr(r)rs"rrrs--M-UY-rcDVf \4p^RIHpV!4p\4p\ VP 44F]wrEVP R4^,V8XdK$VPV4V8XdVPV4VPVR4K_ R#)zCRemove tracked skills that no longer belong to the active provider.Nr=r) rr&r>rritems partitionr@remove_plugin_skillpop)rnr>r# registeredrCrDs& r&_prune_inactive_memory_provider_skillsrus575 "G35J+/ 0@0@0B+C'  # #C ( + >   $ $^ 4 G  ' ' 7~t, ,DrcV^8dQhRR/#)rrz list[dict]r)rs"rrr"s--j-rcp\P4'd \4MRpV'd \V4MRpV'dVR, P 4'g.#\ W4R,p\ V4'g^RIHpV!RV: R24'd.#\PPV4pVf\ V4'g0\\.4\\ W4\V4.4\P P#V\VR, 44pV'dVP$'g.#\P P'V4pV\PV&VP$P)V4\+VRR4p\-V4'g.#\.P0!V4pRTR T;'gR V R 2R T;'gR RVR\+W@ R2R4RV/.# \2d#p\4P7RY4.uRp?#Rp?ii;i)zCLI commands for the **active** memory plugin only. Imports just its ``cli.py`` (``register_cli(subparser)``), never the provider module, so it is safe during argparse setup. At most one dict: name/help/description/setup_fn/handler_fn/plugin.Nzcli.pyz.clirrz CLI commands register_clirWhelpzManage z memory plugin descriptionrsetup_fn handler_fn_commandpluginz-Failed to scan CLI for memory plugin '%s': %s)rfr(rrr8rwrirrrrr_register_synthetic_packagerurkrutilspec_from_file_locationloadermodule_from_spec exec_modulerGrrrr)r<r) rn plugin_dirrrcli_modspecrxdescr s rdiscover_plugin_cli_commandsr"s8K7Q7Q7S7S13Y]O7F"?3DJ j83;;== z;fDK z " "I $'77J-%X Y YI++//+. ?z** ,OR@+L,UX[\fXgWhi>>99+s:X`K`GabDt{{{ nn55d;G'.CKK $ KK # #G ,w=  %%I..z: O DEEgo%6nE 4::2  ''->h+GN o      DoY s>"B,HHA,H>!H H0H H5H0*H50H5)numpyre)D__conditional_annotations__r[ __future__rrOrpimportlib.metadatarimportlib.utilloggingrpathlibrtypesrtypingrrrrrbr r%r rrr getLoggerrr<rrhrfrr __annotations__rrruregister_synthetic_packageruser_plugins_dirrzr+rAr:rirwr{rrrrrrrrrrrrrrrrrrur)rs@rrsF#  !77%,4   8 $8n++4BD"$>C(2o2P (%@@00  *e8S "  E,N $qqB F`& !D!H&4&DaaHE,-"-r