+ Wj(g<aRatc0tRt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RI H t ^RI H t H t HtHt^RIHtHt^RIHt^RIHt^RIHtHtHtHtHtHtHtHtH t H!t!H"t"H#t#H$t$^RI%H&t&H't'^R I(H)t)H*t*^R I+H,t,H-t-H.t.H/t/]P`!R 4t1]!4t2]!R R 4t3]!RR4t4]!RR4t5]!RR4t6]!RR4t7]!RR4t8]9!4t:]^k]Pv!R4tlltQR?R@RARRBR/RCRDlltRRERFltSRGRHltTRIRJltURKRLltVRMRNltWRORPltXRQRRltYRSRTltZRURVlt[RWRXlt\]2PRY4RcRZR[ll4t^]2PR\4RdR]R^ll4t`]2PRY4RcR_R`ll4tbR#)ezMemory-provider setup dashboard routes (schema, existing values, external dependency install). Extracted from ``hermes_cli.web_server``; helpers/state that tests monkeypatch on ``web_server`` stay there and are late-bound (cycle-safe). N)Path)AnyDictListOptional) APIRouter HTTPException)late)_invalidate_plugins_hub_cache) _coerce_bool_field_default _field_is_set _field_value_field_visible_load_memory_provider_memory_provider_manifest_memory_provider_setup_info_memory_provider_setup_manifest!_normalize_memory_provider_schema%_read_memory_provider_existing_values_require_memory_provider_ready_run_setup_command)MemoryProviderConfigUpdateMemoryProviderSetupRequest)_CONFIG_MUTATION_LOCKscoped_to_thread)STORAGE_HONCHO_HOST_BLOCKProviderConfigSchema ProviderFieldget_provider_config_schemazhermes_cli.web_server"_discover_memory_provider_statuseszhermes_cli.web_server_memoryget_hermes_homezhermes_cli.config load_config save_configsave_env_valueload_envz ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$c0V^8dQhR\R\/#namereturn)strr)formats"[C:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_cli\web_routers\memory_providers.py __annotate__r..sUUCUMUc"\RRV 2R7#)izUnknown memory provider:  status_codedetail)rr)s&r-_unknown_providerr5.s S3LTF1S TTr/passthrough_httpTc<V^8dQhR\R\R\/#)r(log_msgr)r6)r+bool)r,s"r-r.r.3s&MM3McMMr/c#."RxR# \d-T'dh\PY4\RRR7h\dp\R\ T4R7ThRp?i\ d$\PY4\RRR7hi;i5i)z``ValueError`` -> 400 with its text; any other error -> logged 500 (an ``HTTPException`` passes through unless ``passthrough_http`` is False).NizInternal server errorr1i)r_log exception ValueErrorr+ Exception)r8r)r6excs&&$ r-_value_errors_as_httpr@2s~ M M   w%4KLL GCH=3F M w%4KLLMs6B BB+B B A!! B.$BBc<V^8dQhR\R\R\/#r(fieldrawr*)rr+r)r,s"r-r.r.Fs!  } 3 3 r/cT;'gRP4pVPpVR8XdFT;'g VPpW P49d\ RVP R24hV#VR8Xd^RIHpV!V4#V'g\#VR8Xd0\V4pTP4'd \T4#T#VR 8XdO\P!V4p\T\ \"34'dT#\ RTP R 24hV# \d p\ RTP R24ThR p?ii;i \\3d p\ R TP R24ThR p?ii;i) zCoerce a submitted non-secret string to its native JSON type. A bool is stored as JSON ``false`` rather than ``"false"`` (truthy). Blank number/json/text clears the key (``_UNSET``); raises ``ValueError`` on malformed input. selectInvalid value for ''r9is_truthy_valuenumberzInvalid number for 'NjsonzInvalid JSON for 'z ' must be a JSON object or array)stripkinddefaultallowed_valuesr=keyutilsrK_UNSETfloat is_integerintrMloads TypeError isinstancedictlist)rCrDvaluerOrKrLr?parseds&& r-_coerce_field_valuer_Fsm YYB   E ::D x&& ,,. .2599+Q?@ @  v~)u%%   x K5\F%//11s6{=v= v~ IZZ&F ftTl + +M1UYYK'GHII L K3EII;a@As J K I& I1%))A>?S H Is0 D#E# E .EE F!E;;Fc^V^8dQhR\R\R\\\3,/#)r(pathwhatr*)rr+r[r)r,s"r-r.r.is) 2 2$ 2c 2d38n 2r/c VP4'g/#\P!VPRR74p\T\4'dT#/# \d\ P RYRR7/u#i;i)zHRead a JSON object from ``path``; missing/unreadable/non-dict -> ``{}``.z utf-8-sig)encodingzFailed to read %s from %sT)exc_info) existsrMrX read_textr>r;warningrZr[)rarbdatas&& r-_read_json_dictrjisr ;;== zz$..+.>?dD))41r1  0$t L s&A%BBc0V^8dQhR\R\/#r(providerr*)rr)r,s"r-r.r.us==2=t=r/cF\4VP, R, #)z config.json)r!r)rms&r-_flat_json_pathrpus  x}} ,} <? f  2EMM2 3%3!(599 !r/cVV^8dQhR\R\\\3,RR/#)r(rarir*N)rr[r+r)r,s"r-r.r.s)..4.tCH~.$.r/cV^RIHp^RIHpV!VP4V!WRR7R#))atomic_json_write)mkdir_under_hermes_homei)modeN)rSrhermes_constantsrparent)rarirrs&& r-_write_json_0600rs'8DKK(du-r/cVV^8dQhR\R\\\3,RR/#rr)r,s"r-r.r.s+::#7:c3h:TX:r/c~a\V4o\W4\WV3Rl4\\ V4S4R#)c<S#N)rCexistings&r-&_write_provider_flat..sr/N)rtrrrrp)rmrrs&&@r-_write_provider_flatrs/x(HH-*@A_X.9r/cVV^8dQhR\R\\\3,RR/#rr)r,s"r-r.r.s+$$%9$4S>$VZ$r/c aaa^RIHpV!VPR4p\VP4wrEpV!4pV!4pVP;_uu_4VP V4;_uu_4VP V4oSPR4p \V \4'dT M/;SR&p V!SV4oS'd%\V3RlV P44V4MTp V PV S4o\W4FhwrSPV P4p \V \4'd$V P!VP"4'dKYV SV P&Kj \%WVV3Rl4\'VS4RRR4RRR4R# +'giL;i +'giR#;i)uPersist submitted fields to Honcho's real config for the active host (partial saves touch only submitted keys; blank text clears a key — see ``_apply_field_values``).rxoauthhostsc3<<"TFwrVSJgK VxK R#5irr).0kvrs& r- )_write_provider_honcho..sF}tqX }s  c.<VPR8XdS#S#hostscope)rCcfg host_blocks&r-r(_write_provider_honcho..s%++Y_J_JOPXP]P]>^;m  D  D    e88>>''- (25$(?(?uRGG u d+QY4Fu{{}FM_c%%h9 7 I E^^EII.Fvs++0A0A%B[B[0\0\(1 599% !J H.his##?  >>   s2F51AF" BF" 0F" F5" F2 -F55 G c<V^8dQhR\R\R\/#)r(rCr]r*)rrr+)r,s"r-r.r.s!  -   r/cVf VP#VPR8Xd^RIHpV!V4'dR#R#VPR8Xd3\ V\ \ 34'd\P!V4#\V4#)zRender a stored native value as the string the generic UI edits (``None`` = key absent -> declared default; bools -> "true"/"false"; JSON containers re-encoded).r9rJtruefalserM) rPrOrSrKrZr[r\rMdumpsr+)rCr]rKs&& r-_serialize_field_valuersl }}} zzV)(//v c r/cVFApVP.VPOF!pWC9gK W4,fKW4,uu# KC VPF$pVPV4'gKW%,u# R#)zStored native value from the first source holding it, else ``None``. Presence (``key in source``) decides, not truthiness, so a stored ``False`` or ``0`` survives instead of being mistaken for "unset". N)rRr env_fallbacksr)rCrrsource source_keyrs&&& r- _read_fieldrsm  995u}}5J#(:(F))6&& 777  < ' r/cjV^8dQhR\R\R\\\3,R\/#r)rrr[r+r9)r,s"r-r.r.s8YY-Y%Yd3PS8nYY]Yr/cZaa\;QJd6V3RlSP.SPO4F 'gK RM+ RM'!V3RlSP.SPO44'dR#\;QJdV3RlV4F 'gK R# R#!V3RlV44#)c3X<"TFq;'dSPV4xK! R#5ir)r)rrrs& r-r)_declared_field_is_set..s% ]7\G ' 'swww' '7\s **TFc3<"TF5pSP.SPOFq!PV4xK K7 R#5ir)rRrr)rrrrCs& r-rrs2X7UYY.__annotate__s J J} J Jr/c4<VPR8XdSS3#S3#rr)rCrrDs&r- sources_for/_declared_provider_payload..sources_fors (- v(=J$ IC6 Ir/rFc0V^8dQhR\R\/#rr)r,s"r-r.rs  }  r/c <S3#rr)rCris&r-rrs 7Nr/label description placeholderr]optionsis_setrGNr)docs_urlr)rRrrOrinforinlinegroup>aiPeer workspace)r%storagerrr)rjrtrgetattrrr]rrrrrrrrRrrOrQrPr9r)rmr is_honchor|r}rrrrrCrentryornativer]rirrDs& @@@r-_declared_provider_payloadrs *C  $==IBST\TaTaBb?-"$13_E"3-  J J2 d  $&F0AB0A!GE%%0ABhmhuhuvhucdWaggwPQP]P]^huvie$ ???E'N4USIE(O MM% US1 U...599@W3W#'- &u5 :: !e3G3G3I&IMMEg09&,tE{h e'!( HMM7HNNJHYHY[cek ll'Bvs H>/H c0V^8dQhR\R\/#)r(r]r*)rr+)r,s"r-r.r.!sr/cVfR#\V\4'd V'dR#R#\V\\34'd\P !V4#\ V4#)zGThe declared-schema path edits strings; the dashboard may send natives.rFrr)rZr9r[r\rMrr+)r]s&r-_stringify_submittedr!sN }%v+G+%$&&zz%  u:r/ctV^8dQhR\\\3,R\\\3,/#)r(configr*r[r+r)r,s"r-r.r.,s*DcNtCH~r/c`VPR4p\V\4'g/;qR&V#)zKReturn ``config["memory"]`` as a dict, creating/replacing a non-dict value.memory)rrZr[)r memory_configs& r-_memory_sectionr,s0JJx(M mT * *+-- x( r/cVV^8dQhR\R\\\3,RR/#rr)r,s"r-r.r.4s.  -A 4PSUXPX> ^b r/cLVP\8Xd\M\pV!W4\;_uu_4\ 4p\ V4pVPR4VP8wdVPVR&\V4RRR4R# +'giR#;i)rmN) rrrrrr"rrr)r#)rmrwriterrrs&& r-_update_memory_provider_configr4st'/'7'7;T'T #ZnF 8  '/   Z (HMM 9(0 M* %      s AB B# cRV^8dQhR\\,R\R\/#)r(r]limitr*)rr+rW)r,s"r-r.r.As*PPhsmPCP3Pr/c`\T;'gR4p\V4V8:dV#VRV R2#)rFNz ... truncated ...)r+len)r]rtexts&& r-_trim_setup_outputr As6 u{{ Dt9%4Od6El^;N+OOr/commandrF completederrorcV^8dQhR\R\R\R\R\\P,R\\,R\\\ 3,/#)r(rOr)statusr rrr*)r+r subprocessCompletedProcessr[r)r,s"r-r.r.Fs]     %( 36  334 DLSM  #s(^ r/cRTRTRTRTRVfRM VPRVfRM\VP4R\T;'gVfR4/#VP4/#) rOr)rr  returncodeNstdoutrFstderr)rr rr)rOr)rr rrs$$$$$$r-_command_resultrFs{ fdHfii/dY5I5I )"/A)BRBR/S$U%]%]Y5Fr^  MVL\L\^  r/chV^8dQhR\R\\\\3,,/#r')r+r\r[r)r,s"r-r.r.Rs+ffsftDcN?Sfr/c ^RIHpRpV!V4wr4T'd\RYTR7.#.# \d%p\RTRT\ T4R7.uRp?#Rp?ii;i)r)$prepare_memory_provider_dependencieszhermes pm installpipfailedrOr)rr rN)rOr)rr )hermes_cli.memory_setuprr>rr+)r)rr  _manifestrr?s& r-,_install_memory_provider_python_dependenciesr!RsmL!Gj@F X^OT' R Secee jUhPW_bcf_ghiijs - AAAAc jV^8dQhR\R\R\R\R\\,/#)r(resultsrOr)r r*)r\r+rrW)r,s"r-r.r.]s6  T  C # _ghk_l r/c ~\VPR4'dTM\P!V43RV/VBpTP \ YT!TP^8H4Y6R74TP# \d9pTP \ YT!R4T\T4R74Rp?R#Rp?ii;i)zPRun a setup command, append its result row; returncode or None on spawn failure.shelldisplayNr)rOr)rr r) rrshlexsplitr>rrr+r)r#rOr)r  status_ofkwargsrr?s&&&&&, r-_run_setup_stepr+]s&&**W2E2Ew5;;W^K_{ip{tz{  NN? )J^J^bcJc@dnuLM    DIdO]dlopsltuvs;A99 B<-B77B<cV^8dQhR\\\\3,,R\\\\3,,/#)r( dependenciesr*)r\r[r+r)r,s"r-r.r.hs;d3PS8nAUZ^_cdgildl_mZnr/c a.pVFpVPR4;'gRpVPR4;'gRpVPR4;'gRoV'd\VRW4V3Rl^R7^8XdKwS'gK\VRVSR R R R 7pV'gKV^8XgK\VRW4R ^R7K V#)r) dependencycheckrFinstallexternal_checkc0<V'dR#S'dR#R#)already_installedmissingrr)ok install_cmds&r-r@_install_memory_provider_external_dependencies..rsb*^Ky^U]^r/)timeoutexternal_installcV'dR#R#) installedrrr6s&r-rr8xsVX{Gf^fGfr/Ti,)r%r9cV'dR#R#)verifiedrrr=s&r-rr8|sacS]SqiqSqr/)rr+)r-r#depr) check_cmdrcr7s& @r-._install_memory_provider_external_dependenciesrChs$&Gwwv..,GGG$** ggi(..B   %t ^hj     '{.s @fH  )sFTr)r6rmr#r)rrr5r!rr>rrr+extendrCallr r) r)rmmanifestr#rF_inputsr?r6rowstatusess & r-_install_memory_provider_setuprRs$T*H(.H%%:4@G.8> NNA%H_B`ab G$GZ[\  @ @ @ @ @B,N,PQ,PSF S ,PHQ "j$ 7HhllSWFX YY .G$xWZ[^W_`a("-.Rs C: D=: D:+D55D:c^V^8dQhR\R\R\\\3,/#)r(r)rmr*r+rr[)r,s"r-r.r.s)3#$sCx.r/c\V4p\W4UUu.uFp/RUu/uF qDW4,bK upCRVR,R8XdRM \W24R\W24RVP R.4RVP RR4/CRUu/uFqDVP V4bK upCNK pppR VRVP R R 4P R R 4P 4R VR\V4/#uupiuupiuuppi)rRrrOr]secretrFrrurlr)_ -rrF)rRrrOrrrequired)whenminimummaximumstep)rrrr rreplacetitler)r)rmrirCrrs&& r-_memory_provider_payloadrbs 0 6D7tFGE  $fg$fq%({$fg 5=H4R,u:S mE0)UYYyRT=UW\^c^g^ghmoq^r )OO(N1%))A,(NO  G  gt||C5==c3GMMOQY[a,T2 hP s" C8C.AC8C3"C8. C8ctV^8dQhR\\\3,R\R\\,/#rB)r[r+rrWrU)r,s"r-r.r.s-c3hccEkr/c\Ve VR8wdTM \V4p\V\4'g(\P!\ V4;p4'g\ hVR,R8Xd(VP4'g\ h\V4pTPR4TPR4reTeY58d\ RTR, R T 24hTeY68d\ RTR, R T 24hT# \\ \3dp\ RTR, R24ThRp?ii;i) NrFrOintegerzInvalid numeric value for 'rRrIr]r^z' must be at least z' must be at most ) r rZr9mathisfiniterUr=rVrWrY OverflowErrorr)rCrDr]rJr?r]r^s&& r-_coerce_schema_numberris?sbyCnU6KEQ eT " "$--%,8N*O*O  =I %$$&&  [Fyy+UYYy-AWv/1U5\N*=gYGHHv/1U5\N*rLre)r r rir+rNrr=)rCrDrOr]opts&& r-_coerce_schema_fieldrns =D yCnU6KUZ)[\\ $$$U00 sB / 5 5 7E x33^E23 9b1IJ1I#W1IJ J25<.BC C  ) )N5))KsC!cbV^8dQhR\R\R\\\3,RR/#r(r)rmrr*NrT)r,s"r-r.r.s2cS$sTWx.]ar/cVef\VR4'dT^RIHpVe$\ V4P VP Jd&VP V\ \444R#\;_uu_4\4p\V4pVPV4p/\V\4'dTM/CVCWP&\ V4RRR4R# \dRpLi;i +'giR#;i)Nr#)MemoryProvider)hasattragent.memory_providerrrr>typer#r+r!rr"rrrZr[)r)rmr_BaseMemoryProviderr memory_cfgcurrents&&& r-#_save_memory_provider_native_configrys- @ @ ' S  &$x.*D*DL_LkLk*k  _->)? @   m$S) ..&W*Wd*C*CwWPVW C    '"&  '   sC8AC' C$#C$' C8 cbV^8dQhR\R\R\\\3,RR/#rprT)r,s"r-r.r.s4((s(c(4PSUXPX>(^b(r/c\V4p\W4pVUu/uF qUR,VbK pp/p/pVFp\V/VCVCV4'gKVR,p VR,R8Xdh\VP V 4;'gR4P 4p V 'd,VP R4'dW\VR,4&KW9d W),MVP V \ V44p \W[4Wy&K \WV4VP4Fwr\W4K R#uupi)rRrOrVrF_env_keyN) rrrr+rrNr rnryrr$)r)rmrrrrC fields_by_key config_valuessecretsrRrrDrrVs&&& r-$_write_memory_provider_config_valuesrs4T:H .t >F6<=fU5\5(fM=$&M Ge%B%BM%BMRR El =H $FJJsO11r288:IUYYz222;E*-./  ]fk S.QVBW0X1%= ( F"==?w'+>sD;c(V^8dQhR\RR/#)r(r)r*Nrv)r,s"r-r.r.s&&c&d&r/cf\PT;'gR4'g \V4hR#)aReject provider names that could traverse outside the plugin dirs. ``name`` is interpolated into filesystem paths by ``find_provider_dir()`` and gates which plugin manifest's setup commands run; a strict charset allowlist (no path separators, no dots) makes traversal impossible. rFN)_MEMORY_PROVIDER_NAME_RE fullmatchr5r4s&r-#_require_valid_memory_provider_namers+ $ - -djjb 9 9%% :r/z#/api/memory/providers/{name}/configchV^8dQhR\R\\,R\\,/#)r(r)surfaceprofile)r+r)r,s"r-r.r.s,1131#1X`adXe1r/c\aa"\S4VV3Rlp\W#4GRjxL #L5i)c <SR8Xd%\S4pVf RSRSRRR./#\V4#\S4pVfRSRSR.R\S4/#\ SV4#)declaredr)rrrFrrF)rrrrrb)rrmr)rs r-_run(get_memory_provider_config.._runsz j 1$7HgtZXrRR-h7 7(.  D'42wHcdhHij j'h77r/Nrr)r)rrrsff& r-get_memory_provider_configrs&'- 8"'0 00 0 !,*,z"/api/memory/providers/{name}/setupcRV^8dQhR\R\R\\,/#)r(r)bodyr)r+rr)r,s"r-r.r.s'11c11K1)1#1r/c\aa"\S4VV3Rlp\W#4GRjxL #L5i)cB<\S4pVf\S4'g \S4hVeISP'd7\ RSRR7;_uu_4\ SVSP4RRR4\ 4\S4# +'giL%;i)Nz5Failed to persist memory provider setup values for %sF)r6)rrr5rr@rr rR)rmrr)s r-r#setup_memory_provider.._runs(.  $=d$C$C $D) )  DKKK&'^`d8=??4T8T[[Q? &'-d33 ??s B B Nr)r)rrrsff& r-setup_memory_providerrs((- 4"'0 00 0rc tV^8dQhR\R\R\\,R\\,/#)r(r)rrr)r+rr)r,s"r-r.r.(s655 5/5:B3-5YabeYf5r/caaa"\S4VP;'g/oVVV3Rlp\RS4;_uu_4\W44GRjxL uuRRR4#L +'giR#;i5i)c <SR8Xda\S4pVf \S4h\TSP4UUu/uFwrV\ V4bK upp4\ 4RR/#\ S4pVf \S4h\SVS4\S4\;_uu_4\4pS\V4R&\V4RRR4\ 4RRRS/#uuppi +'giL&;i)rNr6Trmactive) rr5rrrr rrrrr"rr#)rrrrmrr)rrs r-r+update_memory_provider_config.._run.s j 1$7H'-- *8]c]i]i]k5l]kUYUVa9Ma9P6P]k5l m ) +$< (.  #D) ),T8VD&t, " " ]F26OF #J /  # &'dHd++6m# "sC% )$C++ C; z*PUT /api/memory/providers/%s/config failedN)rrr@r)r)rrrrrsf&f& @r-update_memory_provider_configr'sY(- [[  BF,( KT R R%g44 S R4 S R Rs/>A7A#A!A# A7!A## A4 . A7c@V^8dQh/^\9d \;R&#)r(rT)__conditional_annotations__r)r,s"r-r.r.s PQr/)i)NNr)dr__doc__ contextlibrMloggingrfrer'rpathlibrtypingrrrrfastapirrhermes_cli.web_depsr hermes_cli.web_server_dashboardr hermes_cli.web_server_memoryr r r rrrrrrrrrrhermes_cli.web_modelsrrhermes_cli.web_routers._commonrrplugins.memory.config_schemarrrr getLoggerr;routerr r!r"r#r$r%objectrTcompilerr5contextmanagerr@r_rjrprtrrrrrrrrrrrrrr rr!r+rCrRrbrirnryrrrrpostrputrr.)rs@r-rs   ,,,$IYR01 &**NPn%o"(*=>="56 ="56 &(;<  / 0h::&IJU MtMM& F 2=PV (&.:$@   Y &mR P 9; 7; TX f 0Z*"& *"(0& 12131& 12131, 12535r/