+ WjeP aRt.0tRt^RIHtHtHtHtHtHt.RNRNRNRNRNRNRNR NR NR NR NR NRNRNRNRNRNRNRNRNRNRNRNRNRNRNRNRNRNRNR NR!NR"NR#NR$NR%NR&NR'NR(NR)NR*NR+NR,NR-NR.NR/NR0NR1NR2NR3NR4Nt .ROt .ROt .ROt RR6lt RR7ltR8R9/R:lt]!R RR$R3R;R<7t]!0Rm4t/R@] !RARR.4bRB] !RCR.4bRD] !RERD.4bRF] !RGR .4bRH] !RIRJ.4bRK] !RLR .4bRM] !RN.RO4bR3] !ROR3.4bR] !RPRR.4bRQ] !RR.RO4bRS] !RT] Uu.uFqP'RU4'gKVNK up4bRV] !RWR$.4bRX] !RY.RO4bRZ] !R[R.4bR\] !R]R.4bR] !R^R.4bR_] !R`4b/R ] !RaR .4bRb] !RcR4.4bR=] !RdRe.4bRf] !Rg4bR>] !Rh.RO4bRi] !RjRk.]!Rl04Rm7bR?] !RnRo.]!Rl04Rm7bR!] !RpR!.4bRq] !RrR".4bRs] !RtR#.4bR8] !Ru] Uu.uFqP'Rv4'gKVNK up4bRw] !RxRw.4bRy] !RzRy.4bR{] !R|] 4bR}] !R~R5.4bR] !R] R,4bR] !RRR.R@RX.R7bC/R] !R..ROR7bR] !R]R9R7bR] !R]Uu.uF qR!8wgK VNK up4bR] !R]!RR!R3R;R<74bR]!R4bR]!R4bR]!R4bR]!RRwRy.4bR]!R4bR]!R4bR]!R4bR]!R4bR]!R4bR]!R4bR]!R4bR]!R4bR]!R] 4bCR]!R4R]!R4R]!R4R]!R4RRRR] ] ,RRR./R]!R4R] !R] 4R] !R..ROR7/Ct]P+4UUu/uFwrRV9gKWR,bK uppt]!R]P/444t]!]4tRtRRltRRltRR9/RRlltRRlt/t]^kRRlt RRR9/RRlllt!RRlt"RRlt#RRlt$RRlt%RRlt&RRlt'RRlt(RRlt)RRlt*RRlt+RRRllt,RRlt-R#uupiuupiuupiuuppi)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_dialog browser_vault browser_exectext_to_speech todo_listmemorysession_searchclarify execute_code delegate_taskcronjob_manage 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_connectionsfeishu_doc_readc :RVR\V4R\V4/VC#)zTOne TOOLSETS entry (fresh lists per entry; extra keys such as posture pass through). descriptiontoolsincludes)list)r=r>r?extras&&&,>rDkanbanTc\Uu.uF.q"V9gK V'gVPR4'dK,VNK0 up#uupi)zd_HERMES_CORE_TOOLS minus *excluded* (and, unless kanban=True, every kanban_* tool); order preserved.kanban_)rF startswith)rIexcludedts$* rB _core_withoutrO<s6) k)!h->AFRSR^R^_hRiAA) kk ksAAAAF)rIproject desktop_uicatalogwebz)Web research and content extraction toolssearchz0Web 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 toolsvideozGVideo 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.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.z7Terminal/command execution and process management toolsskillsz\Access, create, edit, and manage skill documents with specialized instructions and knowledgebrowserz[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)ttszVText-to-speech: convert text to audio with Edge TTS (free), ElevenLabs, OpenAI, or xAItodoz.Task planning and tracking for multi-step workzAPersistent memory across sessions (personal notes + user profile)context_enginez2Runtime tools exposed by the active context enginez7Search and recall past conversations with summarization connectionsz@Remote connector discovery, execution, and account authorizationuGDesktop Projects — create/switch named workspaces (GUI sessions only)desktop_projectbot_roomz/Verified text-only Group Chat turn capabilitiesupDesktop GUI affordances — in-app terminal/browser panes, pane focus, reactions, appearance (GUI sessions only) onboardingzfFirst-run onboarding cards; folded in only for the onboarding chat (tui_gateway/methods_onboarding.py) setup_beatdesktop) platformsz[Desktop catalog plugin/skill install requests through the approval card (GUI sessions only)manage_catalogzAAsk the user clarifying questions (multiple-choice or open-ended)code_executionzMRun Python scripts that call tools programmatically (reduces LLM round trips) delegationz:Spawn subagents with isolated context for complex subtasksuKanban 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.rKdiscordzSDiscord 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 content feishu_drivez:Feishu/Lark document comment operations (list, reply, add):NN debuggingz%Debugging and troubleshooting toolkit)r?safez$Safe toolkit without terminal accesscodingzbCoding-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 server 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) 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)hermes-wecom-callbackzJWeCom callback toolset - enterprise self-built app messaging (full access)hermes-yuanbaor=uZYuanbao Bot 元宝消息平台工具集 - 群信息、成员查询、私聊、贴纸表情r>moduleztools.yuanbao_toolsr? hermes-smsz7SMS bot toolset - interact with Hermes via SMS (Twilio)hermes-webhookz=Webhook toolset - receive and process external webhook eventszhermes-gatewayz7Gateway toolset - union of all messaging platform toolsric#B"TFqR,Fq"xK K R#5i)r>N).0spectools& rB rs\0ASZmmdtmt0Asc8^RIHpV# \dR#i;i)zBLive tool registry, or None when tools.registry can't be imported.registryN)tools.registryr Exceptionrs rB _registryrs!+ s  c$V^8dQhR\/#)method)str)formats"rB __annotate__rs3rDc\\\4V4!4# \dTu#i;i)zTregistry.() or *default* when the registry is unavailable or the call fails.)getattrrr)rdefaults&&rB_registry_callrs-y{F+-- s  ++cFV^8dQhR\\\3,/#rreturn)tupleint)rs"rBrrsTTeCHoTrDcR\4pVe\V4\VR^43#R#)N _generation)r)ridr)regs rB_registry_generationrs* +C8;BsGWS-3 4SVSrDinclude_registryc tV^8dQhR\R\R\\\\3,,/#)rnamerr)rboolrdictr)rs"rBrrs4)x)xc)x)xcSVh@X)xrDc \PV4pV'gGV'd=/VCR\VPR.44R\VPR.44/C#R#\4pVf V'dV#R#V'd\ VPR.44\ VP V44,pVP V4pV'd(WP8wd"V\ VP V44,p/VCR\V4/C#V\49d+Tp\V\44pV'dRV R2MRV 2pM!VP V4pV'gR#RV R2pRVRVP V4R./#)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. r>r?Nz MCP server 'z' toolszPlugin toolset: r=) TOOLSETSgetr@rsetget_tool_names_for_toolsetget_toolset_alias_targetsorted_get_plugin_toolset_names_display_alias_get_registry_toolset_aliases) rrtoolsetr merged_tools alias_targetregistry_toolsetaliasr=s &$ rB get_toolsetrs{ll4 G v}r'r7DWb)A$BJPTU\U`U`akmoUpPqr HDH H{H!w+t+7;;w34s8;^;^_c;d7ee  88> L0 C C CL QR RL9'97F<$899 (**t%B%DE7< UG73DTUYTZB[ #<r?)rrFrresolve_toolsetmaprupdate)rcorets_def to_removeinc_defs& rBbundle_non_core_toolsrAs ! "D  &F w&(?<01D88F7O$I{FJJz2$>? 7w')   WW- .@  rDcFV^8dQhR\R\\,/#rrrrr@)rs"rBrrZs#$s)rDc\aVPR4'g.#T\R4Ro^RIHpVP S4'g.#\ \4pTPT3Rl\RR444\T4# \ d.u#i;i \ dL+i;i)zImplicit `hermes-` bundle for a registered plugin platform: core tools plus whatever the plugin registered under the platform name. [] otherwise.zhermes-N)platform_registryc3`<"TF#qPS8XgKVPxK% R#5iN)rr)re platform_names& rBr*_plugin_platform_bundle..hs#i%Jii[hNhVQVV%Js..get_all_entriesr) rLlengateway.platform_registryr is_registeredrrrFrrr@)rrr>rs& @rB_plugin_platform_bundlerZs ??9 % % Y)M? ..}==I> " #E  i^4Er%Jii ;      s#B %B BB B+*B+Nc V^8dQhR\R\\,R,R\R\\,/#)rrvisitedNrr)rrrr@)rs"rBrrns8,,#,C4,UY,eijmen,rDc 4VRJpV'dIW.\4O\RR4N5p\PV4pVe \ V4#\ 4pVR9d^\ 4p\ 4F:pV\9gKVP\WqP4VR74K< \V4#W9d.#VPV4\WR7pV'gV'd \V4#.#\ VPR.44p VPR.4Fp V P\WVR74K! \V 4p V'd;\\4R8d\P!4\ V 4\X&V #) 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)rr>r?>*all)rr_resolve_toolset_memorr@rget_toolset_namesTOOLSET_SESSION_PLATFORMSrrcopyraddrrrclear) rrr external_callmemo_keycached all_toolsrrr> included_nameresults &&$ rBrrnsXtOMm-A-Cm^TgikElm&**84  < % |!e -/L#<<  ||~`p!qr0i     KK$BG 0@&t,HbH  GR( )E Z4  _]N^_`5E]F $ % , ! ' ' )*.v,h' MrDc:V^8dQhR\\,/#r)rr)rs"rBrrs``3s8`rDc\\RR4Uu0uFq\9gKVkK up#uupi)z.s'e|q)w:NST\dSds ** *N)nextitems)rrsf&rBrrs ew}}egk llrDc:V^8dQhR\\,/#rr@r)rs"rBrrsRRtCyRrDcz\4p\4Uu.uFp\W4;'gTNK up#uupi)zOPlugin toolset names, shown under their first non-static alias when one exists.)rrr)rrs rB_plugin_display_namesrs7+-G5N5P Q5PN1 & + +! +5P QQ Qs88chV^8dQhR\\\\\3,3,/#r)rrr)rs"rBrrs%  $sDcN23 rDc6\\4p\4p\4F$pW 9dRM \ V4pV'gK W0V&K& \P 4VP 4,F p\ V4;'g W,W&K" V#)z7All toolset definitions: static plus plugin-registered.N)rrrrrkeys)rr display_namerrs rBget_all_toolsetsrsy (^F+-G-/ &0$k,6O 7#*< 0  ',,.00"4(88FL 1 MrDc:V^8dQhR\\,/#rr)rs"rBrrsGG49GrDc~\\\P44\\ 44,4#)zBSorted names of all toolsets (static + plugin), excluding aliases.)rrrrrrrDrBrrs& #hmmo&-B-D)EE FFrDcFV^8dQhR\\,R\/#)rplatformr)rr frozenset)rs"rBrrs88(3-8I8rDcRa\V3Rl\P444#)zPTools of every platform-gated toolset that a session on *platform* does not get.c3b<"TF$wrSV9gK\V4FpVxK K& R#5ir)r)rrrirr s& rBr.session_platform_tool_drops..s781RodV^foVoT!0!6!61Rs //)r rr)r sfrBsession_platform_tool_dropsrs& 81J1P1P1R8 88rDcV^8dQhR\\\,,R\\,R\\\,,/#)rdisabledr r)rr@r)rs"rBrrs<>>c(;>xPS}>YabfgjbkYl>rDc\P4UUu.uF!wr#W9gK Y ;'gR9gKVNK# pppV'd.T;'gROVO#T#uuppi)a**disabled* plus every platform-gated toolset a session on *platform* does not get. An agent stores this as its ``disabled_toolsets``, so the tool list, the tool_search listing and bridge, MCP refreshes and delegate children (which inherit it) all subtract the gated tools in ``_select_tool_names``.r)rr)rr rrigateds&& rBsession_disabled_toolsetsrsl*C)H)H)J L)Jod).2>>r.JT)JE L*/ &hnn" & &=X= Ls AAAAc0V^8dQhR\R\/#)ragentr)rr )rs"rBrrshhChIhrDcT^RIHpV!V4\\VRR44,#)zTool names *agent* never carries, whatever its toolsets resolved to: the side-agent drops and the toolsets its session platform does not get. Applied at load, MCP refresh and prefix restore.)side_agent_tool_dropsr N)tools.connectors.turnrrr)rrs& rBagent_tool_dropsrs(<  '*EgeU_aeFf*g ggrDc0V^8dQhR\R\/#r)rr)rs"rBrrs__3_4_rDcVR9;'g4V\9;'g#V\49;'gV\49#)r>rr)rrr)rs&rBvalidate_toolsetrsS L  ^ ^DH$4 ^ ^022 ^ ^6:>[>]6]_rDc V^8dQhR\R\R\\,R,R\\,R,RR/#)rrr=r>Nr?rr)rs"rBrrsQCCC#Cd3i$>NCaefiajmqaqC~BCrDcT\Y;'g.T;'g.4\V&R#)z'Register a runtime toolset in TOOLSETS.N)rCr)rr=r>r?s&&&&rBcreate_custom_toolsetr!skkr8>>rBHTNrDcRV^8dQhR\R\\\3,/#r)rrr)rs"rBrrs"  3 4S> rDc\V4pV'gR#\V4pRVRVR,RVR,RVR,RVR\V4R \VR,4/#) z?Toolset definition plus its resolved tools, or None if unknown.Nrr= direct_toolsr>r?resolved_tools tool_count is_composite)rrrr)rrr%s& rBget_toolset_infor(sd$G $T*NmW]%;(*gj6I.,N8KWZ01  rDcV^8dQh/^\9dF\\\\\ \ \3,\ \,3,;R&#)rr)__conditional_annotations__rrrrrr@)rs"rBrrs<ffl MLtE#tS#s":;T#YFGLm grD)rr rr')r;feishu_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_sticker)rr)r>rRrPrQ)video_generatexai_video_editxai_video_extend)rrr)r r rr) read_terminalclose_terminaldesktop_preview drive_previewannotate_previewread_window_below focus_panereact_to_messagegui_tourshow_tip set_theme)rSrVrY)rwrxryrzr{r|r}rr~rrrrrrrrrr)NN)/r*__doc__typingrrrrrrrF_HERMES_WEBHOOK_SAFE_TOOLS _FEISHU_TOOLS_YUANBAO_TOOLSrCrHrO _CODING_TOOLSr CLIENT_SURFACE_TOOLSETSrLrrrvaluesBUILTIN_TOOL_NAMESBUILTIN_TOOLSET_NAMESrrrrrrrrrrrrrrrrrrr!r(r)rNrrr*s000@rBrLs f88  ')7 '      "0    +  -< %'5*(*79I ! $!"#$%$!%&'&&'&(?'()*+,-,&-,(5-./010)10+?12367>X yc ? lDl.0@BRTbkpq $$HIj  3:\=\hmougvwIj J C6Ec dKj V c $ Wj j# *!4Mq)^M4kj t =& >%Puj ~'dej F7jkGj HwqrIj Jg  O$Kj TwnoUj VGlmWj XW^_Yj Z'"rs[j \G\]]j ^!de_j `Wcdaj bwcdcj dWkmz{ej fWefG`aG[\W%qrs#n4'B  'STcY[uvcA   j ZHP~~GWoGW[fjn[n4T #44GWo\0A\\!(+T )xt)xX,KML(,\`,,^` @m R G 8 >h_ C c Dd C: 5jps00R R#RR=R R R" R"