+ i)Rt^RIt^RIt^RIHtHtHtHtHt]P!] 4t !RR4t !RR4t ] !4tR#)aVCentral registry for all hermes-agent tools. Each tool file calls ``registry.register()`` at module level to declare its schema, handler, toolset membership, and availability check. ``model_tools.py`` queries the registry instead of maintaining its own parallel data structures. Import chain (circular-import safe): tools/registry.py (no imports from model_tools or tool files) ^ tools/*.py (import from tools.registry at module level) ^ model_tools.py (imports tools.registry + all tool modules) ^ run_agent.py, cli.py, batch_runner.py, etc. N)CallableDictListOptionalSetc.a]tRt^toRtRtRtRtVtR#) ToolEntryz&Metadata for a single registered tool.c rWnW nW0nW@nWPnW`nWpnWnWnR#N nametoolsetschemahandlercheck_fn requires_envis_async descriptionemoji) selfr r rrrrrrrs &&&&&&&&&&+/home/ubuntu/hermes-agent/tools/registry.py__init__ToolEntry.__init__ s1     ( & ) rrrrrr rrr Nr ) __name__ __module__ __qualname____firstlineno____doc__ __slots__r__static_attributes____classdictcell__ __classdict__s@rrrs0I  rrc6a]tRt^-toRtRtR!V3RlRlltV3RlRltR"V3RlR lltV3R lR lt V3R lR lt V3RlRlt V3RlRlt R#V3RlRllt V3RlRltV3RlRltV3RlRltV3RlRltV3RlRltR"V3RlRlltR tVtR#)$ ToolRegistryzISingleton registry that collects tool schemas + handlers from tool files.c"/Vn/VnR#r _tools_toolset_checksrs&rrToolRegistry.__init__0s,. 46rNcP<V^8dQhRS[RS[RS[RS[RS[RS[RS[RS[R S[/ #) r r rrrrrrr)strdictrlistbool)formatr#s"r __annotate__ToolRegistry.__annotate__8se 5 5 5 5 5  5  5 5 5 5 5rc  VPPV4p V 'd3V PV8wd"\P RWPV4\ TTTTTT;'g.TT;'gVPRR4V R7 VPV&V'd#W P 9dWPP V&R#R#R#)zARegister a tool. Called at module-import time by each tool file.zMTool name collision: '%s' (toolset '%s') is being overwritten by toolset '%s'rr N)r(getr loggerwarningrr)) rr r rrrrrrrexistings &&&&&&&&&& rregisterToolRegistry.register8s;;??4( ((G3 NN.&&  &%++#DDvzz-'D   D ';';;,4  )<8rc$<V^8dQhRS[RR/#)r-r returnNr.)r2r#s"rr3r4Zs44s4t4rc aVPPVR4oSfR#SPVP9d\;QJd7V3RlVPP 44F 'gK RM, RM(!V3RlVPP 444'g'VPPSPR4\ PRV4R#)zRemove a tool from the registry. Also cleans up the toolset check if no other tools remain in the same toolset. Used by MCP dynamic tool discovery to nuke-and-repave when a server sends ``notifications/tools/list_changed``. Nc3T<"TFqPSP8HxK R#5ir r ).0eentrys& r *ToolRegistry.deregister..es = 0D1II &0Ds%(TFzDeregistered tool: %s)r(popr r)anyvaluesr8debugrr rEs&&@r deregisterToolRegistry.deregisterZs d+ =  ==D00 0= 04 0B0B0D= = 04 0B0B0D= : :   $ $U]]D 9 ,d3rcL<V^8dQhRS[S[,RS[RS[S[,/#)r- tool_namesquietr>)rr.r1rr/)r2r#s"rr3r4os+#c(4DQUJrc Z.p/p\V4FpVPPV4pV'gK(VP'dpVPV9d'\ VP44WFP&WFP,'g!V'g\ PRV4K/VPCRVP/CpVPRRRV/4K V# \ d0RYFP&T'g\ PRT4Li;i)zReturn OpenAI-format tool schemas for the requested tool names. Only tools whose ``check_fn()`` returns True (or have no check_fn) are included. FzTool %s check raised; skippingz"Tool %s unavailable (check failed)r typefunction) sortedr(r7rr1 Exceptionr8rKrr append)rrPrQresult check_resultsr rEschema_with_names&&& rget_definitionsToolRegistry.get_definitionsos .0 :&DKKOOD)E~~~>>6Q8)r.r/)r2r#s"rr3r4s'\\S\\3\rc VPPV4pV'g\P!RRV 2/4#VP'd ^RIHpV!VP!V3/VB4#VP!V3/VB# \dRp\PRY4\P!RR\T4P RT 2/4uRp?#Rp?ii;i)zExecute a tool handler by name. * Async handlers are bridged automatically via ``_run_async()``. * All exceptions are caught and returned as ``{"error": "..."}`` for consistent error format. errorzUnknown tool: ) _run_asynczTool %s dispatch error: %szTool execution failed: z: N) r(r7jsondumpsr model_toolsrarrVr8 exceptionrSr)rr r^kwargsrErarDs&&&, rdispatchToolRegistry.dispatchs %::w.(?@A A \~~~2!%--"?"?@@==00 0 \   94 C::w*A$q'BRBRASSUVWUX(YZ[ [ \s+BB1B C ACC C c0<V^8dQhRS[S[,/#r-r>)rr.)r2r#s"rr3r4s**DI*rc H\VPP44#)z0Return sorted list of all registered tool names.)rUr(keysr*s&rget_all_tool_namesToolRegistry.get_all_tool_namessdkk&&())rc6<V^8dQhRS[RS[S[,/#r-r r>)r.rr/)r2r#s"rr3r4s//s/x~/rc dVPPV4pV'd VP#R#)uReturn a tool's raw schema dict, bypassing check_fn filtering. Useful for token estimation and introspection where availability doesn't matter — only the schema content does. N)r(r7rrLs&& r get_schemaToolRegistry.get_schemas'  %$u||.$.rc6<V^8dQhRS[RS[S[,/#rp)r.r)r2r#s"rr3r4s000#0rc dVPPV4pV'd VP#R#)z.Return the toolset a tool belongs to, or None.N)r(r7r rLs&& rget_toolset_for_tool!ToolRegistry.get_toolset_for_tools% % %u}}/4/rc,<V^8dQhRS[RS[RS[/#)r-r defaultr>r?)r2r#s"rr3r4s'CCcCCCCCrc VPPV4pV'dVP'd VP#T#)z3Return the emoji for a tool, or *default* if unset.)r(r7r)rr ryrEs&&& r get_emojiToolRegistry.get_emojis- %$ B'Brc6<V^8dQhRS[S[S[3,/#rj)rr.)r2r#s"rr3r4sDDc3hDrc ~VPP4UUu/uFwrWPbK upp#uuppi)z?Return ``{tool_name: toolset_name}`` for every registered tool.)r(itemsr )rr rDs& rget_tool_to_toolset_map$ToolRegistry.get_tool_to_toolset_maps1/3{{/@/@/BC/BGDii/BCCCs9c&<V^8dQhRS[RS[/#)r-r r>)r.r1)r2r#s"rr3r4s  C D rc VPPV4pV'gR#\V!44# \d\P RT4R#i;i)zCheck if a toolset's requirements are met. Returns False (rather than crashing) when the check function raises an unexpected exception (e.g. network error, missing import, bad config). Tz,Toolset %s check raised; marking unavailableF)r)r7r1rVr8rK)rr checks&& ris_toolset_available!ToolRegistry.is_toolset_availablesR $$((1 =   LLG Q s7!AAc6<V^8dQhRS[S[S[3,/#rj)rr.r1)r2r#s"rr3r4sNNDdONrc \RVPP444p\V4Uu/uFq"VP V4bK up#uupi)z7Return ``{toolset: available_bool}`` for every toolset.c38"TFqPxK R#5ir rB)rCrDs& rrF:ToolRegistry.check_toolset_requirements..s?*>Qyy*>s)setr(rJrUr)rtoolsetstss& rcheck_toolset_requirements'ToolRegistry.check_toolset_requirementssL?$++*<*<*>??R!2"B   L ! ( ( 4!!! --C2,~">> ^4;;C@.*rc6<V^8dQhRS[S[S[3,/#rjr)r2r#s"rr3r4s$sDy/rc  /pVPP4FpVPpW19d(RVR.RVPP V4RRR./W&VP W,R,9d)W,R,P VP 4VPF7pWAV,R,9gKW,R,P V4K9 K V#)zABuild a TOOLSET_REQUIREMENTS-compatible dict for backward compat.r env_varsr setup_urlNr)r(rJr r)r7r rWr)rrXrErrs& rget_toolset_requirements%ToolRegistry.get_toolset_requirementss"$[['')EBB 4 4 8 8 <R  zzG!44 7#**5::6))Rj44Jz*11#6** rc <V^8dQhRS[/#)r-rQ)r1)r2r#s"rr3r4s&&T&rc  .p.p\4pVPP4FpVPpWd9dKVP V4VP V4'dVP V4KRTP RTRVPRVPP4Uu.uF!qwPV8XgKVPNK# up/4K W#3#uupi)zDReturn (available_toolsets, unavailable_info) like the old function.r rr) rr(rJr addrrWrr )rrQr unavailableseenrErrDs&& rcheck_tool_availability$ToolRegistry.check_tool_availabilitys  u[['')EBz HHRL((,,  $""B 2 2dkk.@.@.BV.BiiSUofaff.BV$*%%Ws 1C'C'r')NNFr6r6)F)u⚡)rrrrrrr;rMr[rgrmrrrvr{rrrrrrr r!r"s@rr%r%-sS7 5 5D44*B\\.**//00 CC DD  NN &(&&&rr%)rrbloggingtypingrrrrr getLoggerrr8rr%registryrrrsH  66   8 $*b&b&L >r