PL jp dZddlmZmZmZmZmZgdZiddddggdd d dggdd d d ggdd ddggddddggddddggddddggddddggdddddggdddd ggdd!d"gd#gdd$d%gd&gdd'd(d'ggdd)d*d+ggdd,d-gd.gdd/d0d1ggdd2d3d2ggdid4d5d4ggdd6d7d6ggdd8d9d8ggdd:d;dd?ggdd@dAgdBgddCdDgdEgddFdGdFggddHdIdHggddJdKgdLgddMdNdOggddPdQgdRgddSdTgdUgddVdWddgdd,gddXdYggdZdd[d\gd]gdd^d_gd`gdidadbegddcddegddedfegddgdhedFdHgzgddidjegddkdlegddmdnegddodpegddqdregddsdtegddudvegddwdxegddydzegdd{d|egd}zgdd~degdddegdddegddegddegdLzdgddegddegddggdddZde deee effdZ dde dee dee fdZ dee dee fdZ dee fdZ dee e ffdZdee ee efffdZdee fdZde defdZ dde de dee dee ddf dZde dee effdZedkrededededeD]U\ZZeeZedrdndZedededdededeeddVededdD]RZe eZedededeeddeeSedede gdZ ededdee edededddgdd gedZ!edede!dedde!ddSdS)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)0 web_search web_extractterminalprocess read_file write_filepatch search_filesvision_analyzeimage_generate skills_list skill_view skill_managebrowser_navigatebrowser_snapshot browser_click browser_typebrowser_scroll browser_back browser_pressbrowser_get_imagesbrowser_visionbrowser_console browser_cdpbrowser_dialogtext_to_speechtodomemorysession_searchclarify execute_code delegate_taskcronjob send_messageha_list_entities ha_get_stateha_list_servicesha_call_service kanban_show kanban_listkanban_complete kanban_blockkanban_heartbeatkanban_comment kanban_create kanban_linkkanban_unblock computer_usewebz)Web research and content extraction toolsrr  descriptiontoolsincludessearchz0Web search only (no content extraction/scraping)x_searchuSearch X (Twitter) posts and threads via xAI's built-in x_search Responses tool. Available when xAI credentials are configured (SuperGrok OAuth or XAI_API_KEY). Off by default; enable in `hermes tools` → X (Twitter) Search.visionzImage analysis and vision toolsrvideozGVideo analysis and understanding tools (opt-in, not in default toolset) video_analyze image_genz"Creative generation tools (images)r video_genuVideo generation tools. Single ``video_generate`` tool covers text-to-video (prompt only) and image-to-video (prompt + image_url) — the active backend auto-routes. Configure via ``hermes tools`` → Video Generation.video_generater7uBackground macOS desktop control via cua-driver — screenshots, mouse, keyboard, scroll, drag. Does NOT steal the user's cursor or keyboard focus. Works with any tool-capable model.r z7Terminal/command execution and process management toolsr moaz,Advanced reasoning and problem-solving toolsmixture_of_agentsskillsz\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) rrrrrrrrrrrr 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)filez_File manipulation tools: read, write, patch (with fuzzy matching), and search (content + files))r r rrttszVText-to-speech: convert text to audio with Edge TTS (free), ElevenLabs, OpenAI, or xAIr!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-kanbanuKanban multi-agent coordination — only active when the agent is spawned by the kanban dispatcher (HERMES_KANBAN_TASK env set). The dispatcher runs inside the gateway by default; see `kanban.dispatch_in_gateway` in config.yaml. Lets workers mark tasks done with structured handoffs, block for human input, heartbeat during long ops, comment on threads, and (for orchestrators) list, unblock, and fan out tasks.) r.r/r0r1r2r3r4r5r6discordzSDiscord read and participate tools (fetch messages, search members, create threads) discord_adminzKDiscord server management (list channels/roles, pin messages, assign roles)yuanbaozAYuanbao platform tools - group info, member queries, DM, stickers)yb_query_group_infoyb_query_group_members yb_send_dmyb_search_stickeryb_send_sticker feishu_docz!Read Feishu/Lark document contentfeishu_doc_read feishu_drivez:Feishu/Lark document comment operations (list, reply, add))feishu_drive_list_comments!feishu_drive_list_comment_repliesfeishu_drive_reply_commentfeishu_drive_add_commentspotifyzCNative Spotify playback, search, playlist, album, and library tools)spotify_playbackspotify_devices spotify_queuespotify_searchspotify_playlistsspotify_albumsspotify_library debuggingz%Debugging and troubleshooting toolkitsafez$Safe toolkit without terminal access)r8r?rBz hermes-acpumEditor integration (VS Code, Zed, JetBrains) — coding-focused tools without messaging, audio, or clarify UI)rr r r r r rrrrrrrrrrrrrrrrrr 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 managementz hermes-cronzMDefault cron toolset - same core tools as hermes-cli; gated by `hermes tools`hermes-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-bluebubbleszNBlueBubbles iMessage bot toolset - Apple iMessage via local BlueBubbles serverhermes-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)hermes-dingtalkzBDingTalk bot toolset - enterprise messaging platform (full access) hermes-feishuzLFeishu/Lark bot toolset - enterprise messaging via Feishu/Lark (full access))rYr[r\r]r^ hermes-weixinzFWeixin bot toolset - personal WeChat messaging via iLink (full access) hermes-qqbotzBQQBot toolset - QQ messaging via Official Bot API v2 (full access) hermes-wecomz=WeCom bot toolset - enterprise WeChat messaging (full access)zJWeCom callback toolset - enterprise self-built app messaging (full access)uZYuanbao Bot 元宝消息平台工具集 - 群信息、成员查询、私聊、贴纸表情ztools.yuanbao_tools)r:r;moduler<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)rirjrkrlrmrnrorp hermes-smsrqrrrsrtrwhermes-wecom-callbackrurvhermes-webhookhermes-yuanbao)rzr|ryr{zhermes-gatewaynamereturnc^t|} ddlm}n#t$r |r|ndcYSwxYw|r[t t |dgt ||z}i|d|iS|}d|}||}|tvr |}|sdSd|d}nGdt D}||}|rd|d}|||gd 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 rregistryNr;zPlugin toolset: z MCP server 'z' toolsc,i|]\}}|tv||STOOLSETS).0alias canonicals ,/home/kuhnn/.hermes/hermes-agent/toolsets.py zget_toolset..>s3    yH$$ u$$$r9) rgettools.registryr Exceptionsortedsetget_tool_names_for_toolsetget_toolset_alias_target_get_plugin_toolset_names_get_registry_toolset_aliasesitems) r}toolsetr merged_toolsregistry_toolsetr: alias_targetreverse_aliasesrs r get_toolsetrsll4  G,+++++++ ,,,!+wwt+++,2  GR(( ) )(55d;;<< =  2'17L111+T++K44T::L ,....' 42T222   $A$C$C$I$I$K$K     ##D))  87777K#445EFF  s #66Nvisitedc |t}|dvret}tD]9}t||}||:t |S||vrgS||t|}|s|dr|tdd ddl m }| rstt} ddlm}| fd|jDn#t$$rYnwxYwt'|Sn#t$$rYnwxYwgSt|dg} |d gD]'} 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>*allzhermes-r)platform_registryrc3<K|]}|jk |jVdSN)rr})re platform_names r z"resolve_toolset..s>,,'( yM99F9999,,rr;r<)rget_toolset_namesresolve_toolsetcopyupdateraddr startswithlengateway.platform_registryr is_registered_HERMES_CORE_TOOLSrr_toolsvaluesrlistr) r}r all_tools toolset_nameresolvedrr plugin_toolsrr; included_nameincluded_toolsrs @rrrNsJ%% |!ee -// ' 'L&|W\\^^DDH   X & & & &i    w  KK$G  ??9 % %  Y1M GGGGGG$22=AA .#&'9#:#:L;;;;;;$++,,,,,4O,B,B,D,D,,,% --- .       GR(( ) )E !Z44%% (@@ ^$$$$ %==s6/E#>EE# E E#EE## E0/E0 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) )rrrr)rrr}r;s rresolve_multiple_toolsetsrsNI  %% )  rc ddlm}d|DS#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. rrc$h|] }|tv |Srr)rrs r z,_get_plugin_toolset_names..s-   8++ +++r)rrget_registered_toolset_namesrrrs rrrsp ++++++  ( E E G G    uu s#&AAc\ ddlm}|S#t$ricYSwxYw)z@Return explicit toolset aliases registered in the live registry.rr)rrget_registered_toolset_aliasesrrs rrrsO++++++66888  s  ++ctt}t}tD]L}|}|D]\}}||kr |tvr|}n||vr6t |}|r|||<M|S)z Get all available toolsets with their definitions. Includes both statically-defined toolsets and plugin-registered ones. Returns: Dict: All toolset definitions )dictrrrrr)resultaliasests_name display_namerrrs rget_all_toolsetsrs(^^F+--G,.. + + '    E9G##X(=(=$  6 ! ! l++  +#*F< MrcTtt}t}t D]W}|D]+\}}||kr |tvr||n,||Xt|S)z Get names of all available toolsets (excluding aliases). Includes plugin-registered toolset names. Returns: List[str]: List of toolset names )rrkeysrrrrr)namesrrrrs rrrs   E+--G,.. '    E9G##X(=(= %    IIg    %==rch|dvrdS|tvrdS|tvrdS|tvS)z Check if a toolset name is valid. Args: name (str): Toolset name to validate Returns: bool: True if valid, False otherwise >rrT)rrr)r}s rvalidate_toolsetrsM |t xt (****t 022 22rr:r;r<c*||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 r9Nrr}r:r;r<s rcreate_custom_toolsetr s) #"NHTNNNrc t|}|sdSt|}||d|d|d|t|t|ddS)z Get detailed information about a toolset including resolved tools. Args: name (str): Toolset name Returns: Dict: Detailed toolset information Nr:r;r<)r}r: direct_toolsr<resolved_tools tool_count is_composite)rrrbool)r}rrs rget_toolset_infor!su$G t$T**N}-(J'(.))WZ011  r__main__zToolsets System Demoz<============================================================z Available Toolsets:z(----------------------------------------rz [composite]z[leaf]z  20z - z Tools: rz totalz Toolset Resolution Examples:)r8r rhrgz :z Resolved to z tools: z, z Multiple Toolset Resolution:)r8r?r 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: r)NN)"__doc__typingrrrrrrrstrrrrrrrrrrrr__name__printrr}rinfo compositerr;joinrcombined custom_inforrrrs 021111111111111 ***^I  B .  I  II  ?   I 2 8"#3I > `!"?I J;"#KI V 5 ##  WI l D!!mI @Pi(AI L E%&  MI X u>>>YI dV     eI |{}I Hg !II V xEEE  WI b o"#  cI n G  oI I z Z{I FP"#GI RZSI ^f !_I jS!"kI |I\\\}I H  ?   !II nloI zd!"{I FZ     GI ^:#$_I jS    kI |\    }I T>i(FOUI ` =222  aI zG    !{I `V   8=aI I I b a#c I n  g#  o I D i#E I P v#  '   Q I b f#c I n g#o I z X#{ I F g#G I R ]#S I ^ W#_ I j Z#k I v ]#w I B [#C I N e#' ' '    O I f _#g I r [#s I ~ V# I I L d#t#' ' '  (  Q#W#QrrrII I I Z0c0htCH~60000fGG#GCGDIGGGGTT#Y49&3s8"tCH~$sDcN23249.33343333.   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 KLLLLLIr