+ lHj(Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RIH t ^RI H t H t H t Ht]P!]4tRt]P&!4tRRltRR ltR R ltR R ltRRltRRRRRR/RRlltRRltRRltRRltR#)a<Persistent MCP tool-schema cache for lazy server startup: per-server tool manifests on disk so Hermes can register MCP tools into the agent snapshot without spawning the stdio child at idle dashboard startup. Entries are keyed by server name + a fingerprint of the connection config (command/args/url/tools filters).) annotationsN)Path)AnyDictListOptionalzmcp_schema_cache.jsoncV^8dQhRR/#)returnr)formats";/home/ubuntu/.hermes/hermes-agent/tools/mcp_schema_cache.py __annotate__rs99T9c@^RIHpV!4R, \, #)get_hermes_homecache)hermes_constantsr_CACHE_FILENAMErs r _cache_pathrs0  w & 88rc V^8dQhRRRR/#)r configdictr strr )r s"r rrs @ @t @ @rcVPR4;'g/pRVPR4RVPR4;'g.RVPR4RVPR4R\VPR4;'g.4R\VPR 4;'g.4/p\P!VR RR 7p\P !VP R 44P4R ,#)zEStable hash of the connection-defining parts of an MCP server config.toolscommandargsurl transport tools_includeinclude tools_excludeexcludeT) sort_keys separatorszutf-8:NN),:)getsortedjsondumpshashlibsha256encode hexdigest)r tools_filterpayloadraws& r config_fingerprintr6s::g&,,"L6::i( 6"((b vzz% VZZ , 0 0 ; A ArB 0 0 ; A ArB DG **W DC >>#**W- . 8 8 :3 ??rcV^8dQhRR/#)r r dict[str, Any]r )r s"r rr)s  > rc(\4pVP4'g/#\P!VP RR74p\ V\ 4'dV#/# \d#p\PRY4/uRp?#Rp?ii;i)z utf-8-sig)encodingz&Could not read MCP schema cache %s: %sN) rexistsr-loads read_text isinstancer Exceptionloggerdebug)pathdataexcs r _load_allrE)sr =D ;;== zz$..+.>?!$--t525  =tI s#=A$"A$$ B/B B Bc V^8dQhRRRR/#)r rCr8r Noner )r s"r rr5s77N7t7rc8^RIHpV!\4VRR7R#)r)atomic_json_writei)modeN)utilsrIr)rCrIs& r _save_allrL5s'kmT6rc$V^8dQhRRRRRR/#)r server_namer fingerprintr zOptional[dict]r )r s"r rr;s! & &# &C &N &rc\;_uu_4\4PV4pRRR4\X\4'dVPR4V8wdR#VPR4pVPR4p\V\ \ 34;'dN\V\ \ 34;'d0\P!4V, R,\ V48pV'dR#T# +'giL;i)a\Return cached entry when fingerprint matches (and TTL holds), else None. ``tools/list`` results may carry ``ttlMs`` (SEP-2549); an entry older than a recorded TTL is a miss so the next startup re-probes instead of serving a stale manifest forever. Entries without a TTL never expire. ``cacheScope`` is irrelevant: this cache is per-user local disk.NrOttl_ms written_atg@@) _cache_lockrEr+r>rintfloattime)rNrOentryrQrRexpireds&& r get_cached_entryrY;s   ,  eT " "eii &>+&M YYx F<(J&3,/HHJzCQV<4XHHIIK*,6%-G 4%% s C88 D utility_toolsrQ cache_scopec4V^8dQhRRRRRRRRRR R R R R /#)r rNrrOr list[dict]rZzOptional[list[dict]]rQzOptional[float]r[z Optional[str]r rGr )r s"r rrKsA3SJ%9JY#0<@rcRTRTRT;'g./p\V\\34'dWFR&\P!4VR&V'dWVR&\;_uu_4\ 4pRV9d"VP V4V8Xd RRR4R#WgV&\V4RRR4R# +'giR#;i)zPersist tool schemas after a successful live connect. ``ttl_ms`` / ``cache_scope`` are the server's ``tools/list`` SEP-2549 hints; ``written_at`` anchors TTL expiry.rOrrZrQrRr[N)r>rTrUrVrSrEr+rL)rNrOrrZrQr[rWrCs&&$$$$ r write_cache_entryr_Ks K%-J]J][] ^E&3,'' h"iikl*m { u $+)>%)G  "[$ s%)B1B11 C c$V^8dQhRRRRRR/#)r rWrkeyrr r]r )r s"r rras!::t:#:*:rcjVPV4p\V\4'd \V4#.#)N)r+r>list)rWravalues&& r _list_fieldreas* IIcNE$UD114;9r9rc V^8dQhRRRR/#r rWrr r]r )r s"r rrfs''$':'rc\VR4#)z>Return cached MCP tool dicts (name, description, inputSchema).rrerWs&r tools_from_cache_entryrkfs ug &&rc V^8dQhRRRR/#rgr )r s"r rrks//$/:/rc\VR4#)z5Return cached ``{schema, handler_key}`` utility rows.rZrirjs&r utility_tools_from_cache_entryrnks uo ..r)__doc__ __future__rr/r-logging threadingrVpathlibrtypingrrrr getLogger__name__r@rLockrSrr6rErLrYr_rerkrnr rr rxs7 #  ,,   8 $)nn 9 @ 7 & <@\`37,: ' /r