`gj dZddlmZmZmZmZmZgdZgdZiddddggd d d dggd d d d ggd dddggd dddggd dddggd ddgdgd dddggd ddddggd dd gd!gd d"d#gd$gd d%d&d%ggd d'd(gd)gd d*d+d,ggd d-d.d-ggd d/d0d/ggd d1d2ggd id3d4d3ggd d5d6gd7gd d8d9d8ggd d:d;dd?ggd d@dAgdBgd dCdDgdEgd dFdGdFggd dHdIdHggd dJdKgdLgd dMdNdOggd dPdQgdRgd dSdTgdUgd dVdWddgdd'gd dXdYggdZd d[d\gd]gd^d_d`dagdbgd idcddgdegd dfdgegd dhdiegd djdkegd dldmedFdHgzgd dndoegd dpdqegd drdsegd dtduegd dvdwegd dxdyegd dzd{egd d|d}egd d~degd ddegdzgd ddegd ddegd degd degd degdLzdgddegd degd dggdd dZ d^dde de deee effdZ de dee fdZ dd^dde dee de dee fdZdee dee fdZdee fdZdee e ffdZdee ee efffdZdee fdZde de fdZ dde de dee dee ddf dZde dee effdZedk(riededededej3D]@\ZZeeZedrdndZedededdededeeddBededdD]?ZeeZedededeeddjAe!eAededegdZ"ededdjAe!e"edededddgddgīed«Z#edūede#deddjAe#dyy)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)4 web_search web_extractterminalprocess read_terminalclose_terminal 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_taskcronjobha_list_entities ha_get_stateha_list_servicesha_call_service kanban_show kanban_listkanban_complete kanban_blockkanban_heartbeatkanban_comment kanban_create kanban_linkkanban_unblock kanban_attachkanban_attach_urlkanban_attachments computer_use)rr rr'webz)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), plus reference-to-video. Provider-specific edit/extend workflows may appear as separate tools. Configure via ``hermes tools`` → Video Generation.)video_generatexai_video_editxai_video_extendr;uBackground desktop control via cua-driver (macOS/Windows/Linux) — 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 skillsz\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) rrrrrrrrrr r!r"rr*zbCronjob management tool - create, list, update, pause, resume, remove, and trigger scheduled tasksfilez_File manipulation tools: read, write, patch (with fuzzy matching), and search (content + files))rrrrttszVText-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)context_enginez2Runtime tools exposed by the active context enginer&z7Search and recall past conversations with summarizationprojectuGDesktop Projects — create/switch named workspaces (GUI sessions only)) project_listproject_createproject_switchr'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, attach files, and (for orchestrators) list, unblock, and fan out tasks.) r/r0r1r2r3r4r5r6r7r8r9r:discordzSDiscord 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)r<rCrFcodingzbCoding-focused toolset: files, terminal, search, web docs, skills, todo, delegate, vision, browser) rr r r r r rrrrrrrrrrrrrrrrrr r!r"r$r%r&r'r(r)T)r>r?r@posturez hermes-acpumEditor integration (VS Code, Zed, JetBrains) — coding-focused tools without messaging, audio, or clarify UI)rr r r rrrrrrrrrrrrrrrrrr r!r"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 rrrrrrrrrrrrrrrrrrr r!r"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))rarcrdrerf hermes-weixinzFWeixin bot toolset - personal WeChat messaging via iLink (full access) hermes-qqbotzBQQBot toolset - QQ messaging via Official Bot API v2 (full access)z=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)rsrtrurvrwrxryrz hermes-smsr{r|r}r~ hermes-wecomhermes-wecom-callbackrrhermes-webhookhermes-yuanbao)rrrrrzhermes-gatewayinclude_registrynamerreturnctj|}|s>|syi|t|jdgt|jdgdS ddlm}|rGt t|jdgt|j|z}i|d|iS|}d|}|j|}|tvr |}|syd|d }nLtjD cic]\}} |tvr| |} }} | j|}|rd|d }||j|gd S#t $r |r|cYSdcYSwxYwcc} }w) a Get a toolset definition by name. Args: name (str): Name of the toolset include_registry (bool): When True (default), merge in tools that plugins/overlays registered into this toolset via the registry. When False, return only the static ``TOOLSETS`` definition (the composite-authored view). Platform reverse-mapping in ``_get_platform_tools`` uses False so that a tool registered into a toolset but absent from a platform's static composite does not drop the whole toolset from inference. See issue #49622. Returns: Dict: Toolset definition with description, tools, and includes None: If toolset not found. With include_registry=False the static view only recognizes names literally present in ``TOOLSETS``, so registry/MCP-only toolsets AND registry-derived aliases return None (they have no static counterpart). Nr?r@)r?r@rregistryzPlugin toolset: z MCP server 'z' toolsr=) TOOLSETSgetlisttools.registryr Exceptionsortedsetget_tool_names_for_toolsetget_toolset_alias_target_get_plugin_toolset_names_get_registry_toolset_aliasesitems) rrtoolsetr merged_toolsregistry_toolsetr> alias_targetalias canonicalreverse_aliasess ;/root/.hermes/venv/lib/python3.12/site-packages/toolsets.py get_toolsetrLs*ll4 G   '++gr23W[[R89  ,+  GR( )(55d;< = 2'17L11$TF+K44T:L ,..'$TF'2 %B$C$I$I$K  yH$ u    ##D) (w7K#445EF ; ,!w+t+,( sD71E7 E E  E  toolset_namec*tt}t|}|rd|vstt||z St|d|z }|j dgD]5}t|}|sd|vs|j t|d|z 7|S)ujReturn a ``hermes-*`` bundle's platform-specific tools, excluding core. Platform bundles are defined as ``_HERMES_CORE_TOOLS + [platform extras]``. When a bundle name appears in ``disabled_toolsets``, subtracting the whole bundle would strip core tools (terminal, read_file, …) shared by every other enabled toolset, emptying the model's tool list (#33924). This returns only the bundle's non-core delta (its own extras plus those of any one-level ``includes``), so disabling a bundle removes its platform tools while leaving core intact. Bundle nesting is one level deep in practice (only ``hermes-gateway`` includes other bundles, and those leaves don't nest further), so a single ``includes`` pass is sufficient. Unknown/garbage names fall back to the full resolution minus core — never re-introducing the core wipe. r?r@)r_HERMES_CORE_TOOLSrresolve_toolsetrupdate)rcorets_def to_removeincinc_defs rbundle_non_core_toolsrs ! "D  &F w&(?<01D88F7O$t+Izz*b);c" w')   S!12T9 :; Nvisitedc* | t}|dvrQt}tD]/}t||j|}|j |1t |S||vrgS|j |t||}|s|r|jdr||tdd ddl m }|j rStt} ddlm} |j fd| j j#Dt'|S gSgSt|j)d g} |j)d gD]!} t| ||} | j | #t | S#t$$rYwwxYw#t$$rYgSwxYw) 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) include_registry (bool): When True (default), include tools that plugins/overlays registered into a toolset. When False, resolve only the static ``TOOLSETS`` definition (includes are still resolved, but statically). Platform reverse-mapping uses False so a registry-added tool cannot drop the whole toolset from inference (see #49622 and ``_get_platform_tools``). Returns: List[str]: List of all tool names in the toolset N>*allrzhermes-r)platform_registryrc3TK|]}|jk(r|j!ywN)rr).0e platform_names r z"resolve_toolset..s),'( yyM9FF,s%(r?r@)rget_toolset_namesrcopyrraddr startswithlengateway.platform_registryr is_registeredrrr_toolsvaluesrrr)rrr all_toolsrresolvedrr plugin_toolsrr? included_nameincluded_toolsrs @rrrs(% |!e -/ 'L&|W\\^VfgH   X & 'i   w  KK$1ABG   : Y1M G$22=A#&'9#:L;$++,,4OO,B,B,D,  --B r   GR( )E !Z4% (Rbc ^$% %=%%   s6+&F8E6 F6 F?FFF FF toolset_namescrt}|D]}t|}|j| 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)rrrr?s rresolve_multiple_toolsetsrs?I %  ) rc ddlm}|jDchc] }|tvr|c}Scc}w#t$r t 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. rr)rrget_registered_toolset_namesrrr)rrs rrrsU +!) E E G 8+    u s3.33A A cR ddlm}|jS#t$ricYSwxYw)z@Return explicit toolset aliases registered in the live registry.rr)rrget_registered_toolset_aliasesrrs rrr's-+6688  s  &&ctt}t}tD]F}|}|j D]\}}||k(s |tvs|}n||vr4t |}|sB|||<H|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_toolsetsr0s(^F+-G,. + '   E9G#X(=$   6 ! l+ #*F<  + Mrcttj}t}t D]L}|j D]&\}}||k(s |tvs|j |;|j |Nt|S)z Get names of all available toolsets (excluding aliases). Includes plugin-registered toolset names. Returns: List[str]: List of toolset names )rrkeysrrrrr)namesrrrrs rrrIs   E+-G,. '   E9G#X(= %   IIg   %=rcP|dvry|tvry|tvry|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)rs rvalidate_toolsetr`s8 | x (** 02 22rr>r?r@c.||xsg|xsgdt|<y)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)rrr>r?r@s rcreate_custom_toolsetrts #"NHTNrc t|}|syt|}||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@)rr> direct_toolsr@resolved_tools tool_count is_composite)rrrbool)rrrs rget_toolset_infors]$G $T*N}-(J'(.)WZ01 r__main__zToolsets System Demoz<============================================================z Available Toolsets:z(----------------------------------------rz [composite]z[leaf]z  20z - z Tools: rz totalz Toolset Resolution Examples:)r<r rproz :z Resolved to z tools: z, z Multiple Toolset Resolution:)r<rCr 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__typingrrrrrr_HERMES_WEBHOOK_SAFE_TOOLSrstrrrrrrrrrrrrr__name__printrrrinfo compositerr?joinrcombined custom_inforrrs 021 2nh  B . h  Ih  ?  h 2 8"#3h > `!"?h J;"#Kh V 5 J Wh n R!!oh BPi(Ch N u>Oh ZV  [h r{sh @ xE Ah L o"# Mh X G Yh d Zeh pKqh |P"#}h H`EIh TZUh `f !ah lS!"mh ~I\h J  D #Kh rlsh ~d!"h JZ  Kh b:#$ch nS  oh @\  Ah X>i(FOYh d =2 eh x {  )yh xG  !yh ^ V 8=_ h ` a#a h l  g# m h B i#C h N v#  '   O h ` f#a h l g#m h x X#y h D g#E h P ]#Q h \ W#] h h Z#i h t ]#u h @ [#A h L e#'   M h d _#e h p [#q h ~ W#d#t#'  ( Q#W+QrGh X8<FcFFcSVh@XFRC8OUYO#OCOdO^bcf^gOdT#Y49&3s8"tCH~$sDcN23249.33343.   93i   034S>: z ! (O !" (O)+113B g%%).%9Mx  9+QtBis7=+A*BCD S&6!789@A B  *+ (O8Q% TF!n  U HTYYve}5M4NOPQ  *+ (O()FGH 67 L6(#345 67 &' (O :nh'  #;/K *+ k-89 :; ;7G+H!I J KLIr