.cjd 8 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 effdZedkrededededeD]U\ZZeeZedrdndZedededdededeeddVededdD]RZeeZedededeedd e!eSededegdZ"ededd e!e"edededddgddgĦ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") )ListDictAnySetOptional)6 web_search web_extractterminalprocess read_terminalclose_terminal open_preview focus_pane 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_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_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) rrrrrrrr r!r"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/r0kanbanuKanban 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.) r1r2r3r4r5r6r7r8r9r:r;r<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>rErHcodingzbCoding-focused toolset: files, terminal, search, web docs, skills, todo, delegate, vision, browser) rr r r r r rrrrrrrrrrrrrrrr r!r"r#r$r&r'r(r)r*r+T)r@rArBposturez hermes-acpumEditor integration (VS Code, Zed, JetBrains) — coding-focused tools without messaging, audio, or clarify UI)rr r r rrrrrrrrrrrrrrrr 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))#rr r r rrrrrrrrrrrrrrrrr r!r"r#r$r&r'r(r*r+r,r-r.r/r0z 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))rcrerfrgrh 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@rAmodulerBz7SMS bot toolset - interact with Hermes via SMS (Twilio)z=Webhook toolset - receive and process external webhook eventsz7Gateway toolset - union of all messaging platform tools)rurvrwrxryrzr{r| hermes-smsr}r~rr hermes-wecomhermes-wecom-callbackrrhermes-webhookhermes-yuanbao)rrrrrzhermes-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). NrArB)rArBrregistryzPlugin toolset: z MCP server 'z' toolsc,i|]\}}|tv||STOOLSETS).0alias canonicals */home/ice/.hermes/hermes-agent/toolsets.py zget_toolset..s3    yH$$ u$$$r?) rgetlisttools.registryr Exceptionsortedsetget_tool_names_for_toolsetget_toolset_alias_target_get_plugin_toolset_names_get_registry_toolset_aliasesitems) rrtoolsetr merged_toolsregistry_toolsetr@ alias_targetreverse_aliasesrs r get_toolsetrNs*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. rArB)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 : : : rNvisitedc |t}|dvrgt}tD];}t|||}||*allrzhermes-r)platform_registryrc3<K|]}|jk |jVdSN)rr)re platform_names r z"resolve_toolset..s>,,'( yM99F9999,,rrArB)rget_toolset_namesrcopyrraddr startswithlengateway.platform_registryr is_registeredrrr_toolsvaluesrrr)rrr all_toolsrresolvedrr plugin_toolsrrA included_nameincluded_toolsrs @rrrsc(%% |!ee -// ' 'L&|W\\^^VfgggH   X & & & &i    w  KK$1ABBBG    : :  Y1M GGGGGG$22=AA .#&'9#:#:L;;;;;;$++,,,,,4O,B,B,D,D,,,% --- .       GR(( ) )E !Z44%% (Rbccc ^$$$$ %==s6/E) >E E) EE)EE)) E65E6 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)rrrrAs 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 rrr)sO++++++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_toolsetsr2s(^^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 rrrKs   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_toolsetrbsM |t xt (****t 022 22rr@rArBc*||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?Nrrr@rArBs rcreate_custom_toolsetrvs) #"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@rArB)rr@ direct_toolsrBresolved_tools tool_count is_composite)rrrbool)rrrs rget_toolset_inforsu$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:)r>r rrrqz :z Resolved to z tools: z, z Multiple Toolset Resolution:)r>rEr 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 compositerrAjoinrcombined custom_inforrrrs 021111111111111 222nj  B .  j  Ij  "  j 6 8"#7j B `!"Cj N;"#Oj Z 5 JII  [j r R!!sj FPi(Gj R u>>>Sj ^V     _j v{wj D xEEE  Ej P o"#  Qj \ G  ]j h Zij tKuj j @P"#Aj L`EEEMj XZYj df !ej pS!"qj BI\\\Cj N  D   #Oj vlwj Bd!"Cj NZ     Oj f:#$gj rS    sj D\    Ej \>i(FO]j h =222  ij | {    )}j |G    !}j j j b V   8=c j d a#e j p  g#  q j F i#G j R v#  '   S j d f#e j p g#q j | X#} j H g#I j T ]#U j ` W#a j l Z#m j x ]#y j D [#E j P e#' ' '    Q j h _#i j t [#u j j BW#d#t#' ' '  (  Q#W+QrrrKj j j \8<FFFcFFcSVh@XFFFFRC8OUYOOO#OCOdO^bcf^gOOOOdT#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