sj UdZddlmZmZmZmZmZmZgdZgdZ iddddggd d d dggd d d d ggd dddggd dddggd dddggd ddgdgd ddgdgd dddggd dd dd!ggd d"d#gd$gd d%d&gd'gd d(d)d(ggd d*d+gd,gd d-d.d/ggd d0d1d0ggd d2d3d2ggd id4d5ggd d6d7d6ggd d8d9gd:gd d;dd?d>ggd d@dAdBggd dCdDdEggd dFdGgdHgd dIdJgdKgd dLdMdLggd dNdOdNggd dPdQgdRgd dSdTdUggd dVdWgdXgd dYdZgd[gd d\d]dd!gdd*gd d^d_ggd`d idadbgdcgdddedfdggdhgd didjgdkgd dldmegd dndoegd dpdqegd drdsedLdNgzgd dtduegd dvdwegd dxdyegd dzd{egd d|d}egd d~degd ddegd ddegd ddegd ddegdzgd degd degd degd degd degdRzdgddegd de gd dggdd dZ dddde de deee effdZ de dee fdZiZeee e eefee fed<ddddde dee de dee fdZdee dee fdZdee fdZdee e ffdZdee ee efffdZdee fdZde de fdZ dde de dee dee ddf dZde dee effdZedkrededededeD]U\ZZeeZ e drdndZ!ede!deddedede"e ddVededdD]RZeeZ#ededede"e#dd$e%e#Sed¦edegdâZ&edĦedd$e%e&edƦededddgddgɦedǦZ'edʦede'dedd$e'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") )DictListAnySetOptionalTuple); web_search web_extractterminalprocess read_file write_filepatch search_filesvision_analyzeimage_generatebfl_flux3_text_to_videobfl_flux3_image_to_videobfl_flux3_keyframes_to_videobfl_flux3_video_continuationbfl_flux3_get_resultbfl_flux3_prompting_guide skills_list skill_view skill_managebrowser_navigatebrowser_snapshot browser_click browser_typebrowser_scroll browser_back browser_pressbrowser_get_imagesbrowser_visionbrowser_console browser_cdpbrowser_dialog browser_exectext_to_speechtodomemorysession_searchclarify execute_code delegate_taskcronjobha_list_entities ha_get_stateha_list_servicesha_call_service kanban_show kanban_listkanban_complete kanban_blockkanban_request_reviewkanban_request_changeskanban_heartbeatkanban_comment kanban_create kanban_linkkanban_unblock kanban_attachkanban_attach_urlkanban_attachments computer_use)r r rr-webz)Web research and content extraction toolsr r  descriptiontoolsincludessearchz0Web search only (no content extraction/scraping)x_searchuESearch X (Twitter) posts and threads via xAI's built-in x_search Responses tool. Read-only public X discovery; use the xurl skill for authenticated X API reads and account actions. 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_extendbflaBlack Forest Labs FLUX 3 video generation through the Nous tool gateway: per-mode submit tools (text, image, keyframes, continuation), a poll tool, and a prompting guide. Generations take minutes, so submit returns a job id and the model polls for the result.)rrrrrrrCuBackground 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)rrrrr r!r"r#r$r%r&r'r(r r0zbCronjob 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))r rrrttszVText-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_switch desktop_uiudDesktop GUI affordances — in-app terminal/browser panes, pane focus, reactions (GUI sessions only)) read_terminalclose_terminal open_preview close_preview read_preview drive_previewannotate_previewread_window_below focus_panereact_to_message setup_mcptourr-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)r1r2r3r4kanbanuKanban 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, enter first-class review (request_review — not a block), return review changes, block for human input, heartbeat during long ops, comment on threads, attach files, and (for orchestrators) list, unblock, and fan out tasks.)r5r6r7r8r9r:r;r<r=r>r?r@rArBdiscordzSDiscord 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)rDrKrNcodingzbCoding-focused toolset: files, terminal, search, web docs, skills, todo, delegate, vision, browser)r r r r r rrrrrrrrrrrr r!r"r#r$r%r&r'r(r*r+r,r-r.r/T)rFrGrHposturez hermes-acpumEditor integration (VS Code, Zed, JetBrains) — coding-focused tools without messaging, audio, or clarify UI)r r r r r rrrrrrrrrrrr r!r"r#r$r%r&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))*r r r r r rrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r*r+r,r.r/r0r1r2r3r4z 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))rwryrzr{r|zFWeixin bot toolset - personal WeChat messaging via iLink (full access)zBQQBot 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)rFrGmodulerHz7SMS bot toolset - interact with Hermes via SMS (Twilio)z=Webhook toolset - receive and process external webhook eventsz7Gateway toolset - union of all messaging platform tools)rrrrrrrr hermes-smsrrrr hermes-wecomhermes-wecom-callback hermes-weixin hermes-qqbothermes-webhookhermes-yuanbao)rrrrrrrzhermes-gatewayinclude_registrynamerreturnct|}|sO|sdSi|t|dgt|dgdS ddlm}n#t $r |r|ndcYSwxYw|r[t t|dgt||z}i|d|iS|}d|}| |}|tvr |}|sdSd|d }nGd t D}||} | rd| d }|||gd S) 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). NrGrH)rGrHrregistryzPlugin toolset: z MCP server 'z' toolsc,i|]\}}|tv||STOOLSETS).0alias canonicals ,/home/agent/.hermes/hermes-agent/toolsets.py zget_toolset..s3    yH$$ u$$$rE) rgetlisttools.registryr Exceptionsortedsetget_tool_names_for_toolsetget_toolset_alias_target_get_plugin_toolset_names_get_registry_toolset_aliasesitems) rrtoolsetr merged_toolsregistry_toolsetrF alias_targetreverse_aliasesrs r get_toolsetrs*ll4  G    4  '++gr2233W[[R8899    ,+++++++ ,,,!+wwt+++,2  GR(( ) )(55d;;<< =  2'17L111+T++K44T::L ,....' 42T222   $A$C$C$I$I$K$K     ##D))  87777K#445EFF  s-A44BB toolset_namecxtt}t|}|rd|vstt||z St|d|z }|dgD]B}t|}|r/d|vr+|t|d|z C|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. rGrH)r_HERMES_CORE_TOOLSrresolve_toolsetrupdate)rcorets_def to_removeincinc_defs rbundle_non_core_toolsrs ! " "D  & &F 9w&((?<0011D88F7O$$t+Izz*b));;c""  ;w'))   S!122T9 : : : r_resolve_toolset_memoNvisitedc|du}|rm ddlm}t|}t|dd}n#t$rd}d}YnwxYw||||f}t |}|t|S|t}|dvrgt} tD];} t| | |} | | *allrzhermes-)platform_registryc3<K|]}|jk |jVdSN)rr)re platform_names r z"resolve_toolset..Is>,,'( yM99F9999,,rrGrH)rridgetattrrrrrrget_toolset_namesrcopyrraddr startswithlengateway.platform_registryr is_registeredrget_all_entriesclear)rrr external_callr registry_id generationmemo_keycached all_toolsrresolvedrr plugin_toolsrG included_nameincluded_toolsresultrs @rrrs(tOM    / / / / / /X,,K =!<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)raliasests_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)rs rvalidate_toolsetrsM |t xt (****t 022 22rrFrGrHc*||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 rENrrrFrGrHs rcreate_custom_toolsetrs) #"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 NrFrGrH)rrF direct_toolsrHresolved_tools tool_count is_composite)rrrbool)rrrs 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:)rDr rrz :z Resolved to z tools: z, z Multiple Toolset Resolution:)rDrKr 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__typingrrrrrrr_HERMES_WEBHOOK_SAFE_TOOLSrstrr rrrint__annotations__rrrrrrrrr __name__printrrrinfo compositerrGjoinrcombined custom_inforrrrs.09888888888888888 ===D`  B .  `  I`  "  ` 6 8"#7` B `!"C` N;"#O` Z 5 JII  [` r      !  s` X R!!Y` lPi(m` x u>>>y` DV     E` \{]` j xEEE  k` v o"#  w` B G  C` N ZO` ` ZK[` fP"#g` r`EEEs` P}     Q` hZi` tf !u` @S!"A` RI\\\S` ^  D   '_` JlK` Vd!"W` bZ     c` z:#${` FS    G` X\    Y` p>i(FOq` | =222  }` ` ` Z  {   +[ ` \ G   #] ` D V    BG$$E ` P a#Q ` \  g#  ] ` r i#s ` ~ v#  '    ` P f#Q ` \ g#] ` h X#i ` t g#u ` @]#A` LW#M` XZ#Y` d]#e` p[#q` |e#' ' '    }` ` V`#\#W#d#t#' ' '  (  Q#W+Qrrrw` ` ` H8<FFFcFFcSVh@XFFFFRCLFHtE#tS#"56S ABGGGmUYmmm#mCmdm^bcf^gmmmm`T#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