߲j`$UdZddlmZmZmZmZmZmZgdZgdZ gdZ gdZ gdZ ddZ dd Zd d d Zed dddge ddiZide dddgde ddgde ddgde ddgde dd gd!e d"d gd#e d$gd%de d&dgd'e d(d'd)gd*e d+gd,d-e d.eDcgc]}|j#d/s|c}d0e d1dgd2e d3gd4d5e d6dgd7e d8d9gd:e d;d:gd<e d=id>e d?d>gd@e dAdBgdCe dDdEgdFe dGdHe dIgdJdKe dLdKgdMe dNdOgdPe dQdRgdSe dTe de dUeDcgc]}|j#dVs|c}dWe dXdWgdYe dZdYgd[e d\e d]e d^d_gd`e dae dbdcdde degdfdge dhd'd)gdd2giidje dkggdlidme dned odpe dqeDcgc] }|dKk7s | c}dre dseddKdd dtedudvedwdxedydzed{dWdYgd|ed}d~eddeddeddeddeddeddeddedede ededededdee zdgdede de e dggdid ZdZdefdZdeeeffdZd ddededeeeeffdZdedeefdZiZeeeeeeefeefed<dedeefdZdd ddedeededeefdZdeefdZdeeeffdZ dedeeefdeefdZ!deefdZ"deeeeefffdZ#deefdZ$dedefdZ%ddededeedeeddcf dZ&dedeeeffdZ'deedeefdZ(yccc}wcc}wcc}w)z`Toolset helpers: get/resolve/validate named tool groups (static TOOLSETS + registry-registered).)DictListAnySetOptionalTuple); web_search web_extractterminalprocess_manage 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_dialogbrowser_vault_listbrowser_vault_unlockbrowser_vault_fillbrowser_vault_save_loginbrowser_vault_enter_code browser_exectext_to_speech todo_listmemorysession_searchclarify execute_code delegate_taskcronjob_manageha_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_usemanage_connections)r r rr,)r0r1r2r3)feishu_doc_readfeishu_drive_list_comments!feishu_drive_list_comment_repliesfeishu_drive_reply_commentfeishu_drive_add_comment)yb_query_group_infoyb_query_group_members yb_send_dmyb_search_stickeryb_send_stickerc 6|t|t|d|S)zTOne TOOLSETS entry (fresh lists per entry; extra keys such as posture pass through). descriptiontoolsincludes)list)rPrQrRextras -/home/ubuntu/.hermes/hermes-agent/toolsets.py_tsrV4s&e$x. b\a bbc:t|tt|zS)zRA `hermes-*` platform bundle: the shared core tools plus optional platform extras.)rV_HERMES_CORE_TOOLSrS)rPextrass rU_bundler[9s {.f= >>rWT)kanbancftDcgc]}||vs|s|jdr|c}Scc}w)zd_HERMES_CORE_TOOLS minus *excluded* (and, unless kanban=True, every kanban_* tool); order preserved.kanban_)rY startswith)r\excludedts rU _core_withoutrb>s.) k!Qh->FRSR^R^_hRiA kk ks ...rr(r/rBr\Fwebz)Web research and content extraction toolsr r searchz0Web 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) 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_extenduBackground 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)browser_cronjobzbCronjob 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 xAItodoz.Task planning and tracking for multi-step workr)r*zAPersistent memory across sessions (personal notes + user profile)context_enginez2Runtime tools exposed by the active context enginer+z7Search and recall past conversations with summarization connectionsz@Remote connector discovery, execution, and account authorizationrCprojectuGDesktop Projects — create/switch named workspaces (GUI sessions only)desktop_projectbot_roomz/Verified text-only Group Chat turn capabilities desktop_uiudDesktop GUI affordances — in-app terminal/browser panes, pane focus, reactions (GUI sessions only)) read_terminalclose_terminaldesktop_preview drive_previewannotate_previewread_window_below focus_panereact_to_messagegui_tourshow_tipr,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 monitoringuKanban 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.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 feishu_docz!Read Feishu/Lark document contentrD feishu_drivez:Feishu/Lark document comment operations (list, reply, add)NspotifyzCNative Spotify playback, search, playlist, album, and library tools)spotify_playbackspotify_devices spotify_queuespotify_searchspotify_playlistsspotify_albumsspotify_library debuggingz%Debugging and troubleshooting toolkit)rRsafez$Safe toolkit without terminal access)rcrfricodingzbCoding-focused toolset: files, terminal, search, web docs, skills, todo, delegate, vision, browser)posturez hermes-acpumEditor integration (VS Code, Zed, JetBrains) — coding-focused tools without messaging, audio, or clarify UIzhermes-api-serveru|OpenAI-compatible API server — full agent tools accessible via HTTP (no interactive UI tools like clarify or send_message)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)zLFeishu/Lark bot toolset - enterprise messaging via Feishu/Lark (full access)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)rPrQmodulerRz7SMS 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-smsrrr hermes-feishu hermes-wecomhermes-wecom-callback hermes-weixin hermes-qqbothermes-webhookhermes-yuanbao) rrrrrrrrzhermes-gatewayc2 ddlm}|S#t$rYywxYw)zBLive tool registry, or None when tools.registry can't be imported.rregistryN)tools.registryr Exceptionrs rU _registryrs!+ s  methodcX tt|S#t$r|cYSwxYw)zTregistry.() or *default* when the registry is unavailable or the call fails.)getattrrr)rdefaults rU_registry_callrs/+wy{F+-- s  ))returncNt}|t|t|ddfSdS)N _generationr)rr)ridr)regs rU_registry_generationrs* +C8;BsGWS-3 4SVSrWinclude_registrynamerctj|}|s?|r;i|t|jdgt|jdgdSdSt}||r|SdS|r|t |jdgt |j |z}|j |}|r"||k7r|t |j |z}i|dt|iS|tvr$|}t|t}|rd|dnd|}n|j |}|syd|d}||j |gdS) aToolset definition, or None if unknown. include_registry=True merges plugin/overlay tools registered into this toolset and resolves registry-only (plugin/MCP) toolsets and aliases; False returns a copy of the static TOOLSETS entry only, so platform reverse-mapping is unaffected by registry additions. 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. 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. rQrR)rQrRNz MCP server 'z' toolszPlugin toolset: rO) TOOLSETSgetrSrsetget_tool_names_for_toolsetget_toolset_alias_targetsorted_get_plugin_toolset_names_display_alias_get_registry_toolset_aliases) rrtoolsetr merged_tools alias_targetregistry_toolsetaliasrPs rU get_toolsetr srll4 G v}r'rDWb)A$BPTU\U`U`akmoUpPqr HDH H{H!w+t+7;;w34s8;^;^_c;d7ee  88> LD0 C C CL QR RL9'97F<$899 (**t%B%DE7< UG73DTUYTZB[ #<?/ w')   WW- ./ t rW_resolve_toolset_memocN|jdsgS|tdd ddlm}|j sgS t t} |jfdtddDt|S#t $rgcYSwxYw#t $r Yt|SwxYw)zImplicit `hermes-` bundle for a registered plugin platform: core tools plus whatever the plugin registered under the platform name. [] otherwise.zhermes-Nr)platform_registryc3VK|] }|jk(s|j"ywN)rr).0e platform_names rU z*_plugin_platform_bundle..]s!iaii[hNhQVVis))get_all_entries) r_lengateway.platform_registryr is_registeredrrrYrrrS)rrrQrs @rU_plugin_platform_bundlerOs ??9 % Y)M? ..}=I> " #E  i^4Er%Jii ;     ; s#A=$B= B  B  B$#B$visitedc|du}|rG||gttdd}tj|}| t |St }|dvrOt }t D]-}|jt||j|/t|S||vrgS|j|t||}|s|r t|SgSt |jdg} |jdgD]} | jt| ||!t| } |r8ttdk\rtjt | t<| S) a!Recursively resolve a toolset (and its includes) to a sorted tool-name list. include_registry=False resolves the static TOOLSETS view only. 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. Platform reverse-mapping uses False so a registry-added tool cannot drop the whole toolset from inference (see #49622 and ``_get_platform_tools``). Ncurrent_scope_key>*allrrQrR)rrrrrSrget_toolset_namesrrcopyraddrrrclear) rrr external_callmemo_keycached all_toolsrrrQ included_nameresults rUrrcsgtOM*m-A-Cm^TgikElm&**84  < % |!e -/ oL   _\7<<>\lm n oi   w  KK$1ABG 0@&t,HbH  GR( )E Z4a  _]GN^_`aE]F $ % , ! ' ' )*.v,h' MrWcRtddDchc] }|tvs |c}Scc}w)z.s%e|q))w:NST\dSdes !!!N)nextitems)rrs` rUrrs ew}}egk llrWclt}tDcgc]}t||xs|c}Scc}w)zOPlugin toolset names, shown under their first non-static alias when one exists.)rrr)rrs rU_plugin_display_namesr s0+-G5N5P QN1g & +! + QQ Qs1ctt}t}tD]}||vrdn t |}|s|||<tj |j zD]}t |xs||||<|S)z7All toolset definitions: static plus plugin-registered.N)dictrrr rkeys)rr display_namerrs rUget_all_toolsetsrs (^F+-G-/+ &&0$k,6O #*F< +  ',,.09"4(8F4Lt 9 MrWcvtttjtt zS)zBSorted names of all toolsets (static + plugin), excluding aliases.)rrrr r rrWrUrrs& #hmmo&-B-D)EE FFrWcV|dvxs$|tvxs|tvxs |tvS)N>rr)rrr)rs rUvalidate_toolsetrsA L  ^DH$4 ^022 ^6:>[>]6]_rWrPrQrRc<t||xsg|xsgt|<y)z'Register a runtime toolset in TOOLSETS.N)rVr)rrPrQrRs rUcreate_custom_toolsetrsekr8>rBHTNrWc t|}|syt|}||d|d|d|t|t|ddS)z?Toolset definition plus its resolved tools, or None if unknown.NrPrQrR)rrP direct_toolsrRresolved_tools tool_count is_composite)rrrbool)rrrs rUget_toolset_inforsV$G $T*NW]%;(gj6I(N8KWZ01  rW 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)rrrrQs rUresolve_multiple_toolsetsrs?I %  ) rW)rr)rr)NN))__doc__typingrrrrrrrY_HERMES_WEBHOOK_SAFE_TOOLS _HA_TOOLS _FEISHU_TOOLS_YUANBAO_TOOLSrVr[rb _CODING_TOOLSr_rrstrrintrrrrr__annotations__rrrrrr rrrrrr)ras0rUr)s|f88@X W  yc ? %)l.0@BRTb}en}w|} i  3:\=\hmougvwEi F C6Ec dGi R c $ Si f# *!4qQ)^4gi p =& >%Pqi z'de{i B7jkCi DwqrEi Fg  O$Gi PwnoQi RGlmSi TW^_Ui V'"rsWi XG$jkYi ZG\][i \!de]i ^Wcd_i `wcdai bkmz{ef`a[\$%qrs#n4'  STY[uvA   }i X3TeCHoT 8<)xc)x)xcSVh@X)xXC,KMtE#tS#s":;T#YFGL#$s)(*UY*#*C*d*^bcf^g*Z`3s8` @tCH~@mCm$sCx.mXc]m RtCyR $sDcN23 G49G _3_4_ CC#Cd3iCZ^_bZcCosC 3 4S> &T#Y49G DV CD 5s$PP P$P' P 2P