`gjErdZddlmZddlZddlZddlZddlmZmZm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZej(eZd d d dgddddddddddddddiddddddgddddddddddddd dd! d"gd#d$Zd%d&d dd'd(gddd)dd*d"d+gd#d$Zd0d,ZGd-d.e Zd1d/Zy)2uUhermes-memory-store — holographic memory plugin using MemoryProvider interface. Registers as a MemoryProvider plugin, giving the agent structured fact storage with entity resolution, trust scoring, and HRR-based compositional retrieval. Original plugin by dusterbloom (PR #2351), adapted to the MemoryProvider ABC. Config in $HERMES_HOME/config.yaml (profile-scoped): plugins: hermes-memory-store: db_path: $HERMES_HOME/memory_store.db # omit to use the default auto_extract: false default_trust: 0.5 min_trust_threshold: 0.3 temporal_decay_half_life: 0 ) annotationsN)AnyDictList)MemoryProvider) tool_error) MemoryStore) FactRetriever)cfg_get fact_storeuDeep structured memory with algebraic reasoning. Use alongside the memory tool — memory for always-on context, fact_store for deep recall and compositional queries. ACTIONS (simple → powerful): • add — Store a fact the user would expect you to remember. • search — Keyword lookup ('editor config', 'deploy process'). • probe — Entity recall: ALL facts about a person/thing. • related — What connects to an entity? Structural adjacency. • reason — Compositional: facts connected to MULTIPLE entities simultaneously. • contradict — Memory hygiene: find facts making conflicting claims. • update/remove/list — CRUD operations. IMPORTANT: Before answering questions about the user, ALWAYS probe or reason first.objectstring) addsearchproberelatedreason contradictupdateremovelist)typeenumz"Fact content (required for 'add').)r descriptionz%Search query (required for 'search').z"Entity name for 'probe'/'related'.arrayrzEntity names for 'reason'.)ritemsrintegerzFact ID for 'update'/'remove'.) user_prefprojecttoolgeneralzComma-separated tags.numberzTrust adjustment for 'update'.z$Minimum trust filter (default: 0.3).zMax results (default: 10).) actioncontentqueryentityentitiesfact_idcategorytags trust_delta min_trustlimitr$)r propertiesrequired)namer parameters fact_feedbackuRate a fact after using it. Mark 'helpful' if accurate, 'unhelpful' if outdated. This trains the memory — good facts rise, bad facts sink.helpful unhelpfulzThe fact ID to rate.)r$r)r)cddlm}|dz }|jsiS ddl}t |d5}|j |xsi}dddt ddixsiS#1swYxYw#t$ricYSwxYw) Nrget_hermes_home config.yaml utf-8-sigencodingpluginshermes-memory-store)default)hermes_constantsr8existsyamlopen safe_loadr Exception)r8 config_pathrBf all_configs V/root/.hermes/venv/lib/python3.12/site-packages/plugins/memory/holographic/__init__.py_load_plugin_configrJas0!#m3K      + 4 1*0bJ 1z9.CRPVTVV 1 1  s(A2A& A2&A/+A22 B?BceZdZdZdddZeddZddZdZdZ ddZ dd Z d d dd Z d d dd Z ddZddZddZd dZd!dZd"dZd"dZd#dZy)$HolographicMemoryProviderzOHolographic memory with structured facts, entity resolution, and HRR retrieval.Nc|xs t|_d|_d|_t |jj dd|_y)Nmin_trust_threshold333333?)rJ_config_store _retrieverfloatget _min_trust)selfconfigs rI__init__z"HolographicMemoryProvider.__init__vs>6!4!6   0 01F LMcy)N holographicrVs rIr1zHolographicMemoryProvider.name|srYcy)NTr\r]s rI is_availablez&HolographicMemoryProvider.is_availablesrYcddlm}||dz } ddl}i}|jr+t |d5}|j |xsi}ddd|j di||dd<t |d d 5}|j||d dddy#1swYOxYw#1swYyxYw#t$rYywxYw) z>Write config to config.yaml under plugins.hermes-memory-store.r)Pathr9Nr:r;r=r>wzutf-8F)default_flow_style) pathlibrarBrArCrD setdefaultdumprE)rVvalues hermes_homerarFrBexistingrGs rI save_configz%HolographicMemoryProvider.save_configs ;'-7   H!!#+ <7#~~a06BH7    2 .9?HY  5 6k39 AQ (A% @ A A 77 A A   sF#B2B 0B2<B&B2B#B2&B/+B2/B22 B>=B>cTddlm}|d}dd|dddd d d gd d d ddddddgS)Nr)display_hermes_home/memory_store.dbdb_pathzSQLite database path)keyrr? auto_extractz!Auto-extract facts at session endfalsetrue)rorr?choices default_trustz!Default trust score for new factsz0.5hrr_dimzHRR vector dimensions1024)r@rl)rVrl _default_dbs rIget_config_schemaz+HolographicMemoryProvider.get_config_schemasd8,.//?@ .DQ\ ]"3Vcjx~AHxI J#4Wdi j.ERX Y   rYc rddlm}t|}|dz}|jj d|}t |tr$|j d|}|j d|}t|jj dd}t|jj d d }t|jj d d } t|jj d d} t||||_ t|j| | ||_ ||_ y)Nrr7rmrnz $HERMES_HOMEz${HERMES_HOME}rtg?rui hrr_weightrOtemporal_decay_half_life)rnrtru)storer{rzru)r@r8strrPrT isinstancereplacerSintr rQr rR _session_id) rV session_idkwargsr8 _hermes_homerwrnrtrurztemporal_decays rI initializez$HolographicMemoryProvider.initializes4?,- "%77 ,,""9k: gs #oonlCGoo&6 EGdll..DE dll&&y$784<<++L#>? T\\--.H!LM!'X_` '++%3!   &rYc|jsy |jjjdjd}|dk(r yd|dS#t$rd}YwxYw)NzSELECT COUNT(*) FROM factsru%# Holographic Memory Active. Empty fact store — proactively add facts the user would expect you to remember. Use fact_store(action='add') to store durable structured facts about people, projects, preferences, decisions. Use fact_feedback to rate facts after using them (trains trust scores).z# Holographic Memory Active. z facts stored with entity resolution and trust scoring. Use fact_store to search, probe entities, reason across entities, or add facts. Use fact_feedback to rate facts after using them (trains trust scores).)rQ_connexecutefetchonerE)rVtotals rIsystem_prompt_blockz-HolographicMemoryProvider.system_prompt_blocks{{ KK%%--,hjE A:Z gV W  E s6A A A r)rc |jr|sy |jj||jd}|syg}|D]L}|jd|jdd}|j d|dd |jd dNd d j |zS#t $r }tjd |Yd}~yd}~wwxYw)Nr)r-r. trust_scoretrustrz- [z.1fz] r%z## Holographic Memory  zHolographic prefetch failed: %s) rRrrUrTappendjoinrEloggerdebug)rVr&rresultslinesrres rIprefetchz"HolographicMemoryProvider.prefetchse oo,,UdooUV,WGE HmQUU7A->? s5+Ri0D/EFG H-tyy/?? ?  LL:A > s*B#A&B## C ,CC cyNr\)rV user_contentassistant_contentrs rI sync_turnz#HolographicMemoryProvider.sync_turns rYcttgSr)FACT_STORE_SCHEMAFACT_FEEDBACK_SCHEMAr]s rIget_tool_schemasz*HolographicMemoryProvider.get_tool_schemass!#788rYc v|dk(r|j|S|dk(r|j|Std|S)Nr r3zUnknown tool: )_handle_fact_store_handle_fact_feedbackr)rV tool_nameargsrs rIhandle_tool_callz*HolographicMemoryProvider.handle_tool_callsF  $**40 0 / )--d3 3N9+677rYc~|jjddsy|jr|sy|j|y)NrpF)rPrTrQ_auto_extract_facts)rVmessagess rIon_session_endz(HolographicMemoryProvider.on_session_ends3||6 {{(    *rYc|dk(r8|jr+|r( |dk(rdnd}|jj||yyyy#t$r }tj d|Yd}~yd}~wwxYw)z'Mirror built-in memory writes as facts.ruserrr"r*z*Holographic memory_write mirror failed: %sN)rQadd_factrErr)rVr$targetr%r*rs rIon_memory_writez)HolographicMemoryProvider.on_memory_writesk U?t{{w N*0F*:;  $$Wx$@07{? N I1MM Ns&? A(A##A(c|j |jjd|_d|_y#t$r }tj d|Yd}~3d}~wwxYw)Nz'Holographic shutdown close() failed: %s)rQcloserErrrR)rVrs rIshutdownz"HolographicMemoryProvider.shutdownsZ ;; " K !!#  K FJJ Ks7 A AA c ` |d}|j}|j}|dk(rO|j|d|jdd|jdd}t j |d d S|d k(r|j |d |jdt|jd |jt|jdd}t j |t|dS|dk(r`|j|d|jdt|jdd}t j |t|dS|dk(r`|j|d|jdt|jdd}t j |t|dS|dk(r||jdg}|s tdS|j||jdt|jdd}t j |t|dS|dk(r\|j|jdt|jdd}t j |t|dS|dk(rx|j!t|d|jdd|vrt|dnd|jd|jd}t j d|iS|dk(r4|j#t|d} t j d | iS|d!k(rv|j%|jdt|jd d"t|jdd} t j | t| d#Std$|S#t&$r} td%| cYd} ~ Sd} ~ wt($r} tt+| cYd} ~ Sd} ~ wwxYw)&Nr$rr%r*r"r+r)r*r+added)r)statusrr&r-r. )r*r-r.)rcountrr')r*r.rrr(zreason requires 'entities' listrrr)r,)r%r,r+r*updatedrremovedrg)factsrzUnknown action: Missing required argument: )rQrRrrTjsondumpsrrSrUrlenrrrrr update_fact remove_fact list_factsKeyErrorrEr}) rVrr$r| retrieverr)rr(rrrexcs rIrz,HolographicMemoryProvider._handle_fact_storesT ((^FKKEI..O!XXj)<&"-) zzg"IJJ8##**M!XXj1#DHH[$//$JKdhhw34 + zzgG "MNN7"#//N!XXj1dhhw34* zzgG "MNN9$#++N!XXj1dhhw34, zzgG "MNN8#88J3%&GHH#**!XXj1dhhw34+ zzgG "MNN<'#..!XXj1dhhw34/zzgG "MNN8#++Y( HHY/>Kt>Sd=&9 :Y]&)!XXj1 ,zz9g"6778#++CY,@Azz9g"6776!((!XXj1#DHH[#$>?dhhw34) zzECJ"GHH"$4VH"=>> C ;C5AB B (c#h' ' (ssA0O'3BO'>'* ,,WTc][,Q!Q  . >>'* ,,WTc]Y,O!Q  ! 2  KKCY O %%s$%F%F, F)(F), F87F8r)rWz dict | None)returnr})rbool)rr}rNone)r&r}rr}rr})rr}rr}rr}rr)rList[Dict[str, Any]])rr}rzDict[str, Any]rr})rrrr)r$r}rr}r%r}rrrr)rdictrr})rrrr)__name__ __module__ __qualname____doc__rXpropertyr1r_rjrxrrrrrrrrrrrrr\rYrIrLrLsszYN " &2 .9; Y[ 98+N "U(n (&PrYrLcRt}t|}|j|y)z@Register the holographic memory provider with the plugin system.)rWN)rJrLregister_memory_provider)ctxrWproviders rIregisterrs" "F(7H  *rY)rrr)r __future__rrloggingrtypingrrragent.memory_providerrtools.registryrr|r retrievalr hermes_cli.configr getLoggerrrrrrJrLrr\rYrIrs6"#  ""0%$%   8 $  ^!q!)9]^&7^_'8\]!(FH3EVrs ):Z[!)3^_%6MN$,=]^"*;ab'8TU J%!$N  F')[1IJ ):PQ y)  * $ePePX +rY