Ki2Q dZddlmZmZmZmZmZgdZiddddggdd d dggdd d d ggddddggdddddggddddggdddgdgdddgdgddddggddd d!ggdd"d#gd$gdd%d&gd'gdd(d)d*ggdd+d,d+ggdd-d.d-ggdd/d0d/ggdd1d2d1ggdid3d4d5ggdd6d7d8ggdd9d:gd;gddd?dggd@ddAdBgdCgddDdEgdFgddGdHegddIdJegddKdLegddMdNegddOdPegddQdRegddSdTegddUdVegddWdXegddYdZegdd[egdd\egdd]egdd^egdd_egdd`ggdaddbZdce ddeee effdeZ ddce dgee ddee fdhZ diee ddee fdjZ ddee fdkZ ddee ee efffdlZddee fdmZdce ddefdnZ ddce doe dpee dqee dddff drZdce ddee effdsZedtkreduedvedwedxeD]U\ZZeeZedyrdznd{Zed|ed}ed~dedoedeeddVededxdD]RZe eZedededeeddeeSededxe gdZededdeeededxedddgdd gedZ edede doedde ddfSdfS)a Toolsets Module This module provides a flexible system for defining and managing tool aliases/toolsets. Toolsets allow you to group tools together for specific scenarios and can be composed from individual tools or other toolsets. Features: - Define custom toolsets with specific tools - Compose toolsets from other toolsets - Built-in common toolsets for typical use cases - Easy extension for new toolsets - Support for dynamic toolset resolution Usage: from toolsets import get_toolset, resolve_toolset, get_all_toolsets # Get tools for a specific toolset tools = get_toolset("research") # Resolve a toolset to get all tool names (including from composed toolsets) all_tools = resolve_toolset("full_stack") )ListDictAnySetOptional)& web_search web_extractterminalprocess read_file write_filepatch search_filesvision_analyzeimage_generatemixture_of_agents skills_list skill_view skill_managebrowser_navigatebrowser_snapshot browser_click browser_typebrowser_scroll browser_back browser_press browser_closebrowser_get_imagesbrowser_visionbrowser_consoletext_to_speechtodomemorysession_searchclarify execute_code delegate_taskcronjob send_messageha_list_entities ha_get_stateha_list_servicesha_call_servicewebz)Web research and content extraction toolsrr  descriptiontoolsincludessearchz0Web search only (no content extraction/scraping)visionzImage analysis and vision toolsr image_genz"Creative generation tools (images)rr z7Terminal/command execution and process management toolsr moaz,Advanced reasoning and problem-solving toolsrskillsz\Access, create, edit, and manage skill documents with specialized instructions and knowledge)rrrbrowserz|Browser automation for web interaction (navigate, click, type, scroll, iframes, hold-click) with web search for finding URLs) rrrrrrrrrrr rr(zbCronjob management tool - create, list, update, pause, resume, remove, and trigger scheduled tasks messagingzNCross-platform messaging: send messages to Telegram, Discord, Slack, SMS, etc.r)rlzFRL training tools for running reinforcement learning on Tinker-Atropos) rl_list_environmentsrl_select_environmentrl_get_current_configrl_edit_configrl_start_trainingrl_check_statusrl_stop_trainingrl_get_results rl_list_runsrl_test_inferencefilez_File manipulation tools: read, write, patch (with fuzzy matching), and search (content + files))r r rrttszQText-to-speech: convert text to audio with Edge TTS (free), ElevenLabs, or OpenAIr!r"z.Task planning and tracking for multi-step workr#zAPersistent memory across sessions (personal notes + user profile)r$z7Search and recall past conversations with summarizationr%zAAsk the user clarifying questions (multiple-choice or open-ended)code_executionzMRun Python scripts that call tools programmatically (reduces LLM round trips)r& delegationz:Spawn subagents with isolated context for complex subtasksr' homeassistantz0Home Assistant smart home control and monitoring)r*r+r,r- debuggingz%Debugging and troubleshooting toolkitsafez$Safe toolkit without terminal access)r.r4r5z hermes-acpumEditor integration (VS Code, Zed, JetBrains) — coding-focused tools without messaging, audio, or clarify UI)rr r r r r rrrrrrrrrrrrrrrrr r"r#r$r&r'zhermes-api-serveru|OpenAI-compatible API server — full agent tools accessible via HTTP (no interactive UI tools like clarify or send_message))#rr r r r r rrrrrrrrrrrrrrrrrrr r"r#r$r&r'r(r*r+r,r-z hermes-clizHFull interactive CLI toolset - all default tools plus cronjob managementhermes-telegramzPTelegram bot toolset - full access for personal use (terminal has safety checks)hermes-discordz]Discord bot toolset - full access (terminal has safety checks via dangerous command approval)hermes-whatsappzMWhatsApp bot toolset - similar to Telegram (personal messaging, more trusted) hermes-slackzNSlack bot toolset - full access for workspace use (terminal has safety checks) hermes-signalz?Signal bot toolset - encrypted messaging platform (full access)hermes-homeassistantzDHome Assistant bot toolset - smart home event monitoring and control hermes-emailz>Email bot toolset - interact with Hermes via email (IMAP/SMTP)hermes-mattermostzAMattermost bot toolset - self-hosted team messaging (full access) hermes-matrixzDMatrix bot toolset - decentralized encrypted messaging (full access)zBDingTalk bot toolset - enterprise messaging platform (full access)zLFeishu/Lark bot toolset - enterprise messaging via Feishu/Lark (full access)z=WeCom bot toolset - enterprise WeChat messaging (full access)z7SMS bot toolset - interact with Hermes via SMS (Twilio)z=Webhook toolset - receive and process external webhook eventsz7Gateway toolset - union of all messaging platform tools)rLrMrNrOrPrQrR hermes-smsrSrThermes-dingtalk hermes-feishu hermes-wecomhermes-webhook)rVrWrXrUrYzhermes-gatewaynamereturnc6t|S)z Get a toolset definition by name. Args: name (str): Name of the toolset Returns: Dict: Toolset definition with description, tools, and includes None: If toolset not found )TOOLSETSgetrZs %/home/ubuntu/hermes-agent/toolsets.py get_toolsetra}s <<  Nvisitedc|t}dvret}tD]9}t||}||:t |S|vrgS|t}|sNtvr< ddl m }fd|j DS#t$rYnwxYwgSt|dg}|dgD]'}t||} || (t |S)a Recursively resolve a toolset to get all tool names. This function handles toolset composition by recursively resolving included toolsets and combining all tools. Args: name (str): Name of the toolset to resolve visited (Set[str]): Set of already visited toolsets (for cycle detection) Returns: List[str]: List of all tool names in the toolset N>*allrregistryc4g|]}|jk |jStoolsetrZ).0erZs r` z#resolve_toolset..s(VVV1AIQUDUDUDUDUDUrbr1r2)setget_toolset_namesresolve_toolsetcopyupdatelistaddr]r^_get_plugin_toolset_namestools.registryrh_toolsvalues Exception) rZrc all_tools toolset_nameresolvedrlrhr1 included_nameincluded_toolss ` r`rrrrs%% |!ee -// ' 'L&|W\\^^DDH   X & & & &I  w  KKll4  G  ,.. . . 333333VVVV(>(>(@(@VVVV       GR(( ) )E !Z44%% (@@ ^$$$$ ;;s*C.. C;:C; toolset_namesct}|D]&}t|}||'t|S)z Resolve multiple toolsets and combine their tools. Args: toolset_names (List[str]): List of toolset names to resolve Returns: List[str]: Combined list of all tool names (deduplicated) )rprrrtru)rr|rZr1s r`resolve_multiple_toolsetsrsLI  %%  ??rbc ddlm}d|jDS#t$rt cYSwxYw)uReturn toolset names registered by plugins (from the tool registry). These are toolsets that exist in the registry but not in the static ``TOOLSETS`` dict — i.e. they were added by plugins at load time. rrgc8h|]}|jtv|jSrj)rlr])rmentrys r` z,_get_plugin_toolset_names..s1   }H,, M,,,rb)rxrhryrzr{rprgs r`rwrwsr ++++++  !//11    uu s(+AAct}tD]N|vrH ddlm}fd|jD}d|d|<>#t$rYJwxYwO|S)z Get all available toolsets with their definitions. Includes both statically-defined toolsets and plugin-registered ones. Returns: Dict: All toolset definitions rrgc4g|]}|jk |jSrjrk)rmrnts_names r`roz$get_all_toolsets..s(ZZZAQYRYEYEYEYEYEYrbzPlugin toolset: )r0r1)r]rsrwrxrhryrzr{)resultrhr1rs @r`get_all_toolsetsrs]]__F,..   &  333333ZZZZ)?)?)A)AZZZ#?g#?#?"##w     ! Ms6A'' A43A4ctt}|tz}t |S)z Get names of all available toolsets (excluding aliases). Includes plugin-registered toolset names. Returns: List[str]: List of toolset names )rpr]keysrwsorted)namess r`rqrqs6   E & ( ((E %==rbcD|dvrdS|tvrdS|tvS)z Check if a toolset name is valid. Args: name (str): Toolset name to validate Returns: bool: True if valid, False otherwise >rerfT)r]rwr_s r`validate_toolsetrs6 |t xt ,.. ..rbr0r1r2c*||pg|pgdt|<dS)a  Create a custom toolset at runtime. Args: name (str): Name for the new toolset description (str): Description of the toolset tools (List[str]): Direct tools to include includes (List[str]): Other toolsets to include r/N)r]rZr0r1r2s r`create_custom_toolsetr(s) #"NHTNNNrbc t|}|sdSt|}||d|d|d|t|t|ddkdS)z Get detailed information about a toolset including resolved tools. Args: name (str): Toolset name Returns: Dict: Detailed toolset information Nr0r1r2r)rZr0 direct_toolsr2resolved_tools tool_count is_composite)rarrlen)rZrlrs r`get_toolset_infor@sz$G t$T**N}-(J'(.))GJ/0014  rb__main__zToolsets System Demoz<============================================================z Available Toolsets:z(----------------------------------------rz [composite]z[leaf]z  20z - z Tools: rz totalz Toolset Resolution Examples:)r.r rKrJz :z Resolved to z tools: z, z Multiple Toolset Resolution:)r.r4r z* Combining ['web', 'vision', 'terminal']:z Result: z Custom Toolset Creation: my_customz$My custom toolset for specific tasksrz Created 'my_custom' toolset:z Description: z Resolved tools: )N)NN)!__doc__typingrrrrr_HERMES_CORE_TOOLSr]strrarrrrwrrqboolrrr__name__printitemsrZrlinfo compositerr1joinrcombined custom_inforjrbr`rs5 021111111111111 """Ns  B .  s  Is  8"#s (;"#)s 4Pi(5s @ E%&  As L u>>>Ms XV     Ys n{os zg !{s F _     Gs ^ xEEE  _s j j"#  ks v G  ws B ZCs NP"#Os ZZ[s s ff !gs rS!"ss DI\\\Es V>i(FOWs b =%&222  cs |G    !}s bV   <A!!cs ha#is ti#us @v#As Lf#Ms Xg#Ys dX#es p]#qs |W#}s HZ#Is T]#Us s b\#f#W#Q#W#QPPP] s s s n c htCH~6    99#9C9DI9999xT#Y49&3s8"$sDcN232 49     /3/4////,   93i   034S>: z E !!! E(OOO E !""" E(OOO))++1133BB g%%%).%9GMMx  C9CCtCCC7=+ACCDDD @SS&6!788@@@AAAA E *+++ E(OOO8QQ%% nTnnn OUOOTYYvve}}5M5MOOPPPP E *+++ E(OOO(()F)F)FGGH E 6777 E 666(#3#344 6 6777 E &''' E(OOO :nh'  #";//K E *+++ E :k-8 : :;;; E K;7G+H!I!I K KLLLLLIrb