o;i t UdZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z ddlmZddlmZejeZ ddlmZmZdd lmZmZn#e$r eZeZdZdZYnwxYwe d Gd d Zgeddddedddd edddd edddd edddd edddeddded d!dd"#ed$d%dd&d"'ed(d)dd*#ed+d,dd-#ed.d/dd d0d12ed3d4ded5d6dd d78ed9d:dd ;edd?'ed@dAddBedCdDddEd?'edFdGdd?#edHdIddJ#edKdLdedMdNdOedPdQdd dRSedTdUdd"#edVdWdXd edYdZdXd[d\'ed]d^dOd ed_d`dXd"#edadbdXd dcdededfdXd dghedidjdXdkdlmedndodXedpdqdXdrdsmedtdudXdvdwmedxdydXd d"zed{d|dXd d}d~edddXddmedddXd ddeddddd edddd edddd dedddd ddedddddmedddddmedddd eddddeddddedddd ddedddd edddOd d8edddOedddd ;edddOedddOd#edddOd ddedddOd d-zedddOd edddOd dzedddOd ;edddOedddd dȬdZded<d!d̈́Z e Z!ded<d"d҄Z"d#dԄZ#iZ$ded<eD]AZ%e%j&s8e#e%e$de%j'<e%j(D]Z)e%j*de%j'dٝe$de)<BiZ+ded<eD]ZZ%e%j&sQe+,e%j-iZ.e$de%j'e.de%j'<e%j(D]Z)e$de)e.de)<[iZ/ded<eD]$Z%e%j0re1e%j0e/de%j'<%ej2dަZ3eD]_Z%de%j'Z4e4e/vse%j5se36e%j5Z7e7r+e78d9dߦe/e4<`e:deDZ;ded<d$dZ<e:hdZ=ded<d%dZ>d&dZ?d'd(dZ@d)dZAd*dZBd+dZCdZD eDZEej2dZFej2dZGd,dZHd-dZIeIZJ d.d/dZKd0d1d ZLd2d ZMd3d ZNdZOdZPej2dZQe:hdZRd,dZSd*dZTd4d5dZUd6dZVdaWded<d)dZXGddeZYGddeZZd7d Z[dS(8aSlash command definitions and autocomplete for the Hermes CLI. Central registry for all slash commands. Every consumer -- CLI help, gateway dispatch, Telegram BotCommands, Slack subcommand mapping, autocomplete -- derives its data from ``COMMAND_REGISTRY``. To add a command: add a ``CommandDef`` entry to ``COMMAND_REGISTRY``. To add an alias: set ``aliases=("short",)`` on the existing ``CommandDef``. ) annotationsN)CallableMapping) dataclass)Any)is_truthy_value) AutoSuggest Suggestion) Completer CompletionT)frozenceZdZUdZded<ded<ded<dZded<d Zded <dZded <d Zd ed<d Z d ed<dZ ded<dS) CommandDefz%Definition of a single slash command.strname descriptioncategoryztuple[str, ...]aliases args_hint subcommandsFboolcli_only gateway_onlyN str | Nonegateway_config_gate) __name__ __module__ __qualname____doc____annotations__rrrrrrr8/home/ubuntu/.hermes/hermes-agent/hermes_cli/commands.pyrr-s// IIIMMM!G!!!!I#%K%%%%HL&*******r#rnewz0Start a new session (fresh session ID + history)Session)reset)rclearz$Clear screen and start a new session)rredrawz6Force a full UI repaint (recovers from terminal drift)historyzShow conversation historysavezSave the current conversationretryz(Retry the last message (resend to agent)undoz'Remove the last user/assistant exchangetitlez#Set a title for the current sessionz[name])rbranchz5Branch the current session (explore a different path))fork)rrcompressz&Manually compress conversation contextz [focus topic]rollbackz&List or restore filesystem checkpointsz[number]snapshotz8Create or restore state snapshots of Hermes config/state)snapzreate|restore |prune])rrrstopz%Kill all running background processesapprovez#Approve a pending dangerous commandz[session|always])rrdenyz Deny a pending dangerous command)r backgroundzRun a prompt in the background)bgbtwzagentsz$Show active agents and running tasks)tasksqueuez4Queue a prompt for the next turn (doesn't interrupt))qsteerz>Inject a message after the next tool call without interruptinggoalz?Set a standing goal Hermes works on across turns until achievedz([text | pause | resume | clear | status]statuszShow session infoprofilez+Show active profile name and home directoryInfosethomez!Set this chat as the home channel)zset-home)rrresumez!Resume a previously-named sessionconfigzShow current configuration ConfigurationmodelzSwitch model for this session)providerz$[model] [--provider name] [--global]gquotaz*Show Google Gemini Code Assist quota usage personalityzSet a predefined personality statusbarz#Toggle the context/model status bar)sb)rrverbosez9Cycle tool progress display: off -> new -> all -> verbosezdisplay.tool_progress_command)rrfooterz7Toggle gateway runtime-metadata footer on final repliesz[on|off|status])onoffrA)rryoloz7Toggle YOLO mode (skip all dangerous command approvals) reasoningz#Manage reasoning effort and displayz[level|show|hide]) noneminimallowmediumhighxhighshowhiderPrQfastuSToggle fast mode — OpenAI Priority Processing / Anthropic Fast Mode (Normal/Fast)z[normal|fast|status])normalr\rArPrQskinz%Show or change the display skin/theme)rr indicatorz!Pick the TUI busy-indicator stylez[kaomoji|emoji|unicode|ascii])kaomojiemojiunicodeascii)rrrvoicezToggle voice modez[on|off|tts|status])rPrQttsrAbusyz/Control what Enter does while Hermes is workingz[queue|steer|interrupt|status])r=r? interruptrAtoolsz4Manage tools: /tools [list|disable|enable] [name...]zTools & Skillsz[list|disable|enable] [name...])rrtoolsetszList available toolsetsskillsz*Search, install, inspect, or manage skills)searchbrowseinspectinstall)rrcronzManage scheduled tasksz [subcommand])listaddcreateeditpauserErunremovecuratorz8Background skill maintenance (status, run, pin, archive))rArurtrEpinunpinrestorekanbanz:Multi-profile collaboration board (tasks, links, comments))rplsrZrrassignlinkunlinkclaimcommentcompleteblockunblockarchivetaildispatchcontextinitgcreloadz.Reload .env variables into the running sessionz reload-mcpzReload MCP servers from config) reload_mcpz reload-skillsz?Re-scan ~/.hermes/skills/ for newly installed or removed skills) reload_skillsbrowserz1Connect browser tools to your live Chrome via CDPzonnect|disconnect|status])connect disconnectrApluginsz'List installed plugins and their statuscommandsz*Browse all commands and skills (paginated)z[page]helpzShow available commandsrestartz9Gracefully restart the gateway after draining active runsusagez8Show token usage and rate limits for the current sessioninsightsz!Show usage insights and analyticsz[days] platformsz&Show gateway/messaging platform status)gatewaycopyz-Copy the last assistant response to clipboardpastez*Attach clipboard image from your clipboardimagez.Attach a local image file for your next promptzupdatez)Update Hermes Agent to the latest versiondebugz@Upload debug report (system info + logs) and get shareable linksquitz Exit the CLIExit)exitzlist[CommandDef]COMMAND_REGISTRYreturndict[str, CommandDef]cPi}tD]}|||j<|jD]}|||<|S)z+Map every name and alias to its CommandDef.)rrr)lookupcmdaliass r$_build_command_lookuprsH$&F  sx[  EF5MM Mr#_COMMAND_LOOKUPrrCommandDef | Nonect|dS)zmResolve a command name or alias to its CommandDef. Accepts names with or without the leading slash. /)rgetlowerlstrip)rs r$resolve_commandrs.   tzz||22377 8 88r#rcR|jr|jd|jd|jdS|jS)z;Build a CLI-facing description string including usage hint.z (usage: / ))rrr)rs r$_build_descriptionrs: }I/HHSXHH HHHH ?r#dict[str, str]COMMANDSrz (alias for /rzdict[str, dict[str, str]]COMMANDS_BY_CATEGORYzdict[str, list[str]] SUBCOMMANDSz[a-z]+(?:\|[a-z]+)+|c#\K|]'}|jr|j|jg|jRD]}|V(dSN)rrrr).0rrs r$ rsu33 <323(CK(( 33  3333333r#zfrozenset[str]GATEWAY_KNOWN_COMMANDSrrc`|sdS|tvrdStD]\}}}||krdSdS)uReturn True if ``name`` resolves to a gateway-dispatchable slash command. This covers both built-in commands (``GATEWAY_KNOWN_COMMANDS`` derived from ``COMMAND_REGISTRY``) and plugin-registered commands, which are looked up lazily so importing this module never forces plugin discovery. Gateway code uses this to decide whether to emit ``command:`` hooks — plugin commands get the same lifecycle events as built-ins. FT)r_iter_plugin_command_entries)r plugin_name _description _args_hints r$is_gateway_known_commandr"sZ u %%%t1M1O1O- \: $  44  5r#>r%r7rr5r=r?r;rArr6rBrrr8ACTIVE_SESSION_BYPASS_COMMANDS command_namec,|rt|dundS)uReturn True for any resolvable slash command. Rationale: every gateway-registered slash command either has a specific Level-2 handler in gateway/run.py (/stop, /new, /model, /approve, etc.) or reaches the running-agent catch-all that returns a "busy — wait or /stop first" response. In both paths the command is dispatched, not queued. Queueing is always wrong for a recognized slash command because the safety net in gateway.run discards any command text that reaches the pending queue — which meant a mid-run /model (or /reasoning, /voice, /insights, /title, /resume, /retry, /undo, /compress, /usage, /reload-mcp, /sethome, /reset) would silently interrupt the agent AND get discarded, producing a zero-char response. See issue #5057 / PRs #6252, #10370, #4665. ACTIVE_SESSION_BYPASS_COMMANDS remains the subset of commands with explicit Level-2 handlers; the rest fall through to the catch-all. NF)r)rs r$should_bypass_active_sessionrNs"(9E O?< ( ( 4 4%Or#set[str]cdtD}|stS ddlm}|}n#t$rtcYSwxYwt}|D]y}|}|jdD]/}t|tr| |}-d}t|dr| |j z|S)zReturn canonical names of commands whose ``gateway_config_gate`` is truthy. Reads ``config.yaml`` and walks the dot-separated key path for each config-gated command. Returns an empty set on any error so callers degrade gracefully. c g|] }|j | Sr)r)rcs r$ z)_resolve_config_gates..ls B B B1A,A BQ B B Br#r)read_raw_config.NF)default) rsethermes_cli.configr Exceptionrsplit isinstancedictrrrqr)gatedrcfgresultrvalkeys r$_resolve_config_gatesres C B( B B BE uu 555555o uu uuF ! !*0055  C#t$$ ggcll 3 . . . ! JJsx Ms4AAconfig_overridesset[str] | Nonec\|jsdS|jr||n t}|j|vSdS)a}Check if *cmd* should appear in gateway surfaces (help, menus, mappings). Unconditionally available when ``cli_only`` is False. When ``cli_only`` is True but ``gateway_config_gate`` is set, the command is available only when the config value is truthy. Pass *config_overrides* (from ``_resolve_config_gates()``) to avoid re-reading config for every command. TNF)rrrr)rr overridess r$_is_gateway_availablersG <t %(8(D$$J_JaJa x9$$ 5r# list[str]c t}g}tD]}t||s|jr d|jnd}g}|jD]Z}|dd|jddkr ||jkrA|d|d[|rdd|d nd}|d|j|d |j ||S) z3Generate gateway help text lines from the registry.rr-_z`/`z (alias: z, rz` -- ) rrrrrreplacerappendjoinr)rlinesrargs alias_partsa alias_notes r$gateway_help_linesrs!%''IE N N$S)44  &)m;"3="""!#  * *Ayyc""ch&6&6sC&@&@@@Q#(]]   yAyyy ) ) ) )>IQ:;!7!7::::r  L#(LDLLsL LLMMMM Lr#list[tuple[str, str, str]]c ddlm}n#t$rgcYSwxYw |pi}n#t$rgcYSwxYwg}|D]\}}t |t rt |t s0t |dpd|}t |dpd}| |||f|S)aeYield (name, description, args_hint) tuples for all plugin slash commands. Plugin commands are registered via :func:`hermes_cli.plugins.PluginContext.register_command`. They behave like ``CommandDef`` entries for gateway surfacing: they appear in the Telegram command menu, in Slack's ``/hermes`` subcommand mapping, and (via :func:`gateway.platforms.discord._register_slash_commands`) in Discord's native slash command picker. Lookup is lazy so importing this module never forces plugin discovery (which can trigger filesystem scans and environment-dependent behavior). rget_plugin_commandsrRun /rr) hermes_cli.pluginsrritemsrrrrstripr)rrentriesrmetarrs r$rrs5:::::::  &&((.B  *,Gnn&&77 d$$$ JtT,B,B  $((=11C^T^^DD --344::<< k956666 Ns  ) 88list[tuple[str, str]]c:t}g}tD]E}t||st|j}|r|||jfFtD].\}}}t|}|r|||f/|S)a{Return (command_name, description) pairs for Telegram setMyCommands. Telegram command names cannot contain hyphens, so they are replaced with underscores. Aliases are skipped -- Telegram shows one menu entry per canonical command. Plugin-registered slash commands are included so plugins get native autocomplete in Telegram without touching core code. )rrr_sanitize_telegram_namerrrr)rrrtg_namerrrs r$telegram_bot_commandsrs&''I$&F66$S)44  )#(33  6 MM7CO4 5 5 5)E)G)G22%k:)$//  2 MM7K0 1 1 1 Mr# z [^a-z0-9_]z_{2,}rawc|dd}td|}td|}|dS)uRConvert a command/skill/plugin name to a valid Telegram command name. Telegram requires: 1-32 chars, lowercase a-z, digits 0-9, underscores only. Steps: lowercase → replace hyphens with underscores → strip all other invalid characters → collapse consecutive underscores → strip leading/ trailing underscores. rrr)rr_TG_INVALID_CHARSsub_TG_MULTI_UNDERSCORErrrs r$rrs[ 99;;  sC ( (D  T * *D  # #C . .D ::c??r#rlist[tuple[str, ...]]reservedc`t|}g}|D]}|^}}}t|tkrF|dt}||vr1|dtdz } tdD]} | | }||vrnc|}||vrj|||||g|R|S)aEnforce 32-char command name limit with collision avoidance. Both Telegram and Discord cap slash command names at 32 characters. Names exceeding the limit are truncated. If truncation creates a duplicate (against *reserved* names or earlier entries in the same batch), the name is shortened to 31 chars and a digit ``0``-``9`` is appended to differentiate. If all 10 digit slots are taken the entry is silently dropped. Accepts tuples of any length >= 2. Extra elements beyond ``(name, desc)`` (e.g. ``cmd_key``) are passed through unchanged, so callers can attach metadata that survives the rename. N )rlen_CMD_NAME_LIMITrangerqr) rrusedrentryrdescextra candidateprefixdigits r$_clamp_command_namesrs ]]DF,,"dU t99 & &-o-.ID  2223"2YYE#) 25 2 2I ,,-D 4<<   tT*E**++++ Mr#dplatform max_slotsintreserved_names desc_limit sanitize_name'Callable[[str], str] | None'&tuple[list[tuple[str, str, str]], int]cg}g} ddlm}|}t|D]j} |r || n| } | s|| dd} t | |kr| d|dz dz} || | fkn#t $rYnwxYwt||}|d|D|D]\} } || | d ft} dd l m }|| }n#t $rYnwxYwg} dd l m }dd lm}ddl m}t#|}t#|dz ddz}|ddzg}|d|D|}t|D]}||}|dd s#t+fd|Ds?|rU|dd }||vrp|d}|r ||n|} | s|dd } t | |kr| d|dz dz} || | |fn#t $rYnwxYwt||}t1d|t |z }t1dt ||z }|d|D]\} } }|| | |f|d||fS)aCollect plugin + skill entries for a gateway platform. Priority order: 1. Plugin slash commands (take precedence over skills) 2. Built-in skill commands (fill remaining slots, alphabetical) Only skills are trimmed when the cap is reached. Hub-installed skills are excluded. Per-platform disabled skills are excluded. Args: platform: Platform identifier for per-platform skill filtering (``"telegram"``, ``"discord"``, etc.). max_slots: Maximum number of entries to return (remaining slots after built-in/core commands). reserved_names: Names already taken by built-in commands. Mutated in-place as new names are added. desc_limit: Max description length (40 for Telegram, 100 for Discord). sanitize_name: Optional name transform applied before clamping, e.g. :func:`_sanitize_telegram_name` for Telegram. May return an empty string to signal "skip this entry". Returns: ``(entries, hidden_count)`` where *entries* is a list of ``(name, description, cmd_key)`` triples and *hidden_count* is the number of skill entries dropped due to the cap. ``cmd_key`` is the original ``/skill-name`` key from :func:`get_skill_commands`. rrrPlugin commandN...c3 K|] \}}|V dSrrrnrs r$rz1_collect_gateway_skill_entries..]s&551!555555r#rget_disabled_skill_namesrget_skill_commands SKILLS_DIRget_external_skills_dirs.hubrc3`K|])}t|ddzV*dS)rN)rrstrip)rds r$rz1_collect_gateway_skill_entries..xsJ! ! )*CFFMM#   $! ! ! ! ! ! r# skill_md_pathc3BK|]}|VdSr) startswith)rr skill_paths r$rz1_collect_gateway_skill_entries..s1UUz,,V44UUUUUUr#r)rrsortedrr rrrrragent.skill_utilsr'agent.skill_commandsr*tools.skills_toolr,r.rresolver1extendanyr5rmax) rrrrr all_entries plugin_pairsr plugin_cmdscmd_namerrr%r2_platform_disabledr' skill_triplesr*r,r. _skills_dir_hub_dir_allowed_prefixes skill_cmdscmd_keyinfo skill_nameraw_name remaining hidden_countkr6s @r$_collect_gateway_skill_entriesrP'sF/1K+-L  ::::::))++ {++ . .H.;I==***D x(,,]>>>>>55xHHH      13M& ;;;;;;000000>>>>>>*,,..//  V+446677>>sCCcI)//44s:;  ! ! .F.F.H.H! ! !    (')) j)) 8 8Gg&D/266J UUUUCTUUUUU $$X.. &"--J///~~c**H.;I==***D 88M2..D4yy:%%OZ!^O,u4  $g!6 7 7 7 7' 8(      )GGMAy3{#3#3344Iq#m,,y899L ),&&1aAq!9%%%% z z "L 00s7B B BBD D D &F/K K#"K# max_commands!tuple[list[tuple[str, str]], int]c<tt}d|D}t|}td|t|z }t d||dt \}}|d|D|d||fS)uReturn Telegram menu commands capped to the Bot API limit. Priority order (higher priority = never bumped by overflow): 1. Core CommandDef commands (always included) 2. Plugin slash commands (take precedence over skills) 3. Built-in skill commands (fill remaining slots, alphabetical) Skills are the only tier that gets trimmed when the cap is hit. User-installed hub skills are excluded — accessible via /skills. Skills disabled for the ``"telegram"`` platform (via ``hermes skills config``) are excluded from the menu entirely. Returns: (menu_commands, hidden_count) where hidden_count is the number of skill commands omitted due to the cap. ch|]\}}|Srrr$s r$ z)telegram_menu_commands..s222DAqa222r#rtelegram()rrrrrc3&K|] \}}}||fV dSrr)rr%r2_ks r$rz)telegram_menu_commands..s,7781aA777777r#N)rprr>r rPrr<)rQ core_commandsr all_commandsremaining_slotsrrNs r$telegram_menu_commandsr]s".0011M22M222N &&L!\C ,=,==>>O:!%- G\77w777777   & 44r#cBtd|t|dS)u Return skill entries for Discord slash command registration. Same priority and filtering logic as :func:`telegram_menu_commands` (plugins > skills, hub excluded, per-platform disabled excluded), but adapted for Discord's constraints: - Hyphens are allowed in names (no ``-`` → ``_`` sanitization) - Descriptions capped at 100 chars (Discord's per-field max) Args: max_slots: Available command slots (100 minus existing built-in count). reserved_names: Names of already-registered built-in commands. Returns: ``(entries, hidden_count)`` where *entries* is a list of ``(discord_name, description, cmd_key)`` triples. ``cmd_key`` is the original ``/skill-name`` key needed for the slash handler callback. discordr)rrrr)rPr)rrs r$discord_skill_commandsr`s/, *>**    r#Mtuple[dict[str, list[tuple[str, str, str]]], list[tuple[str, str, str]], int]cddlm}t} ddlm}|d}n#t $rYnwxYwi}g}d|D}d} ddlm}ddlm} dd l m } | } | d z } | g} | D]C} | || 4#t $rY@wxYwn#t $rYnwxYw|}t|D]}||}|d d }|s$|| }t|t| rqd }| D]+} ||n#t$$rY%wxYw|}||dd }||vr|d}|d d}||vrQ||}|dkrt(d|||nt(d|||||dz }3|||<|dd }t-|dkr |d ddz}|j|}|j}t-|dkr6|d}||g |||f| |||fn#t $rYnwxYw|||fS)u'Return skill entries organized by category for Discord ``/skill`` autocomplete. Skills whose directory is nested at least 2 levels under a scan root (e.g. ``creative/ascii-art/SKILL.md``) are grouped by their top-level category. Root-level skills (e.g. ``dogfood/SKILL.md``) are returned as *uncategorized*. Scan roots include the local ``SKILLS_DIR`` **and** any configured ``skills.external_dirs`` — matching the widened filter applied to the flat ``discord_skill_commands()`` collector in #18741. Without this parity, external-dir skills are visible via ``hermes skills list`` and the agent's ``/skill-name`` dispatch but silently absent from Discord's ``/skill`` autocomplete. Filtering mirrors :func:`discord_skill_commands`: hub skills excluded, per-platform disabled excluded, names clamped to 32 chars, descriptions clamped to 100 chars. The legacy 25-group × 25-subcommand caps (from the old nested ``/skill `` layout) are **not** applied — the live caller (``_register_skill_group`` in ``gateway/platforms/discord.py``, refactored in PR #11580) flattens these results and feeds them into a single autocomplete callback, which scales to thousands of entries without any per-command payload concerns. ``hidden_count`` is retained in the return tuple for backward compatibility and still reports skills dropped for other reasons (32-char clamp collision vs a reserved name). Returns: ``(categories, uncategorized, hidden_count)`` - *categories*: ``{category_name: [(name, description, cmd_key), ...]}`` - *uncategorized*: ``[(name, description, cmd_key), ...]`` - *hidden_count*: skills dropped due to name clamp collisions against already-registered command names. r)Pathr&r_r(ci|]}|dS) r)rr%s r$ z6discord_skill_commands_by_category..s"K"K"Kq1l"K"K"Kr#r)r-r+r/r3rNrrrreuDiscord /skill: %r (from %r) collides on its 32-char clamp with a reserved gateway command name %r — the skill will not appear in the /skill autocomplete. Rename the skill's frontmatter ``name:`` to differ in its first 32 chars.uDiscord /skill: %r and %r both clamp to %r on Discord's 32-char command-name limit — only %r will appear in the /skill autocomplete. Rename one skill's frontmatter ``name:`` to differ in its first 32 chars.r rrar")pathlibrcrr8r'rr9r*r.r:r,r;rr7rrr5 relative_to ValueErrorrloggerwarningr parentparts setdefault)r_PrCr' categories uncategorized _names_usedhiddenr*r.r,rErF _scan_rootsextrHrIrJr6sp matched_rootrootrKrL discord_namepriorrrelrocats r$"discord_skill_commands_by_categoryrsAL#"""""#&55 >>>>>>55yIII      9;J02M #L"KN"K"K"KK Fd ;;;;;;>>>>>>000000 ((** '0022"-  //11  &&rr#ww'8'89999 H      D '')) j))M DM DGg&D/266J J''))B2ww!!#h--00 '+L#  NN4((((!H# #&"--J///~~c**H#CRC=L{**$L1L((NN1 %g| NN. w e ! (/K %88M2..D4yy3CRCy5()'' 55CIE5zzQAh%%c2..55|T76STTTT$$lD'%BCCCC[M D\       }f ,,s) 66 AK8 C0C  C CCCCK8 C)&K8(C))BK8=FK8 F K8F  EK88 LL2z [^a-z0-9_\-]>medndmsgprowhoawayfeedrmuteopenleaveshrugtopicexpandremindrkrAcollapse shortcutsc|}td|}|d}|dtS)zConvert a command name to a valid Slack slash command name. Slack allows lowercase a-z, digits, hyphens, and underscores. Max 32 chars. Uppercase is lowercased; invalid chars are stripped. rz-_N)r_SLACK_INVALID_CHARSrr_SLACK_NAME_LIMITrs r$_sanitize_slack_namersI 99;;D  # #B - -D ::d  D """ ##r#c t}gtddd fd }tD]1}t ||s||j|j|jpd 2tD]A}t ||s|j D]&}||d |jd |j|jpd 'BtD]\}}}||||pd S)aReturn (slash_name, description, usage_hint) triples for Slack. Every gateway-available command in ``COMMAND_REGISTRY`` is surfaced as a standalone Slack slash command (e.g. ``/btw``, ``/stop``, ``/model``), matching Discord's and Telegram's model where every command is a first-class slash and not a ``/hermes `` subcommand. Both canonical names and aliases are included so users can type any documented form (e.g. ``/background``, ``/bg``, and ``/btw`` all work). Plugin-registered slash commands are included too. Commands whose sanitized name collides with a Slack built-in (e.g. ``/status``, ``/me``, ``/join``) are silently skipped. Users can still reach them via ``/hermes ``. Results are clamped to Slack's 50-command limit with duplicate-name avoidance. ``/hermes`` is always reserved as the first entry so the legacy ``/hermes `` form keeps working for anything that gets dropped by the clamp or for free-form questions. )hermesz"Talk to Hermes or run a subcommandz[subcommand] [args]rrrrhintrNonect|}|r|vrdS|tvrdSttkrdS||dd|ddf|dS)Nr)r_SLACK_RESERVED_COMMANDSr _SLACK_MAX_SLASH_COMMANDSrrq)rrr slack_namerseens r$_addz"slack_native_slashes.._adds)$//  Z4// F 1 1 1 F w<<4 4 4 F D#JTcT ;<<< r#rz Alias for /u — )rrrrrrrr) rrrrqrrrrrrr) rrrrrrrrrs @@r$slack_native_slashesrsg*&''I*,GUUD NNZ[[[HHX        ==$S)44   SXs (;<<<< ]]$S)44  [ ] ]E DFchFFS_FF H[Y[ \ \ \ \ ] )E(F(F11$k9 T; R0000 Nr#)https://hermes-agent.local/slack/commands request_urldict[str, Any]cg}tD]1\}}}d||pd|d|d}|r||d<||2dd|iiS)uGenerate a Slack app manifest with all gateway commands as slashes. ``request_url`` is required by Slack's manifest schema for every slash command, but in Socket Mode (which we use) Slack ignores it and routes the command event through the WebSocket. A placeholder URL is fine. The returned dict is the ``features.slash_commands`` portion only — callers compose it into a full manifest (or merge into an existing one). Keeping it narrow avoids coupling us to the rest of the manifest schema (display_information, oauth_config, settings, etc.) which users set up once in the Slack UI and rarely change. rrF)commandr should_escapeurl usage_hintfeaturesslash_commands)rr)rslashesrrrrs r$slack_app_manifestrsG133  dE!4zz1>4>>"     ("'E, u )73 44r#ct}i}tD]7}t||sd|j||j<|jD] }d|||< 8t D]\}}}||vrd|||<|S)a0Return subcommand -> /command mapping for Slack /hermes handler. Maps both canonical names and aliases so /hermes bg do stuff works the same as /hermes background do stuff. Plugin-registered slash commands are included so ``/hermes `` routes through the plugin handler. r)rrrrrr)rmappingrrrrrs r$slack_subcommand_maprs&''I G))$S)44  *NN[ ) )E([[GENN )*F*H*H''&lJ w  &JJGDM Nr#ztuple[float, list[str]] | None_LMSTUDIO_COMPLETION_CACHEc~tjdsytjdsZ ddlm}|pi}d|dpivrd|dpivrgSn#t $rgcYSwxYwt j}tr!|tdz dkr td S dd lm }|tjdd tjdpd d }n#t $rg}YnwxYw||fa|S)zHLocally-loaded LM Studio models for /model autocomplete (cached, gated). LM_API_KEY LM_BASE_URLr)_load_auth_storelmstudio providerscredential_poolg>@r )fetch_lmstudio_modelsrzhttp://127.0.0.1:1234/v1g?)api_keybase_urltimeout) osenvironrhermes_cli.authrrtimerhermes_cli.modelsr)rstorenowrmodelss r$_lmstudio_completion_modelsr"s JNN< ( (BJNN=,I,I  8 8 8 8 8 8$$&&,"E%))K"8"8">B??eii0A&B&B&HbII    III  )++C!-s-G-J'Jd&R&R)!,,;;;;;;&&JNN<44Z^^M22P6P    "%v Ms&AB BBAD'' D65D6ceZdZdZ d)d*d Zd+d Zd,dZed-dZed.dZ ed/d0dZ ed.dZ d/d0dZ d1dZ ed2d Zd3d4d"Zed5d%Zed5d&Zd5d'Zd(ZdS)6SlashCommandCompleterzJAutocomplete for built-in slash commands, subcommands, and skill commands.Nskill_commands_provider1Callable[[], Mapping[str, dict[str, Any]]] | Nonecommand_filterCallable[[str], bool] | NonerrcL||_||_g|_d|_d|_dS)Ngr)_skill_commands_provider_command_filter _file_cache_file_cache_time_file_cache_cwd)selfrrs r$__init__zSlashCommandCompleter.__init__Bs3 )@%-&('*$&r# slash_commandrrc||jdS t||S#t$rYdSwxYw)NT)rrr)rrs r$_command_allowedz&SlashCommandCompleter._command_allowedNsS   '4 ,,];;<< <   44 s !- ;;Mapping[str, dict[str, Any]]cf|jiS |piS#t$ricYSwxYwr)rr)rs r$_iter_skill_commandsz*SlashCommandCompleter._iter_skill_commandsVsP  ( 0I 00228b 8   III s ! 00rBwordc||kr|dn|S)aIReturn replacement text for a completion. When the user has already typed the full command exactly (``/help``), returning ``help`` would be a no-op and prompt_toolkit suppresses the menu. Appending a trailing space keeps the dropdown visible and makes backspacing retrigger it naturally. rr)rBrs r$_completion_textz&SlashCommandCompleter._completion_text^s"*T!1!1(~~~~x?r#textrc|sdSt|dz }|dkr#||dkr|dz}|dkr ||dk||dzd}|sdS|dsd|vr|SdS)aCExtract the current word if it looks like a file path. Returns the path-like token under the cursor, or None if the current word doesn't look like a path. A word is path-like when it starts with ``./``, ``../``, ``~/``, ``/``, or contains a ``/`` separator (e.g. ``src/main.py``). Nr rr)z./z../~/rrr r5rirs r$_extract_path_wordz(SlashCommandCompleter._extract_path_wordis 4 IIM1ffaC FA1ffaCAEFF| 4 ??3 4 4 t Ktr#limitrc#FKtj|}|dr|}d}n@tj|pd}tj|} tj|}n#t$rYdSwxYwd}|}t|D]W}|r(| |s-||krdStj ||} tj | } | drAdtj | tjdz} nAtj|r| } ntj | } | r| dz } | rdnd} | rdnt| } t!| t#| || z| V|d z }YdS) z8Yield Completion objects for file paths matching *word*.rrrNr~rdirstart_positiondisplay display_metar )rpath expanduserendswithdirnamebasenamelistdirOSErrorrr7r5risdirrelpathisabs_file_size_labelr r )rrexpanded search_dirrrcount prefix_lowerr full_pathis_dir display_pathsuffixrs r$_path_completionsz'SlashCommandCompleter._path_completionss)7%%d++   S ! ! 0!JFF229cJW%%h//F j,,GG    FF ||~~ G__  E ekkmm66|DD ~~ Z77IW]]9--Fs## :#bgooiASASTWAXAX&Y&YY t$$ :(  "wy99  $# "*SSF"C55(8(C(CD #D z!     QJEE=  s=B B B c|sdSt|dz }|dkr#||dkr|dz}|dkr ||dk||dzd}|dsdS|S)z=Extract a bare ``@`` token for context reference completions.Nr rr@rrs r$_extract_context_wordz+SlashCommandCompleter._extract_context_words 4 IIM1ffaC FA1ffaCAEFF|s## 4 r#c#vK|}d}|D]g\}}||r;||kr#t|t| ||VhdD] }|dd}||ks||r|dk} ||krdn|t|d} tj| } | r| dkrd \} } nZ| d r| d} } n@tj| pd} tj | } t j | }n#t$rYdSwxYwd }| }t|D]}| r(||s,tj | |}tj|}| |krr||krnltj|}|rd nd}|rd nt!|}|||}t|t| ||z|V|d z }dS |d d}||||Ed{VdS)zYield Claude Code-style @ context completions. Bare ``@`` or ``@partial`` shows static references and matching files/folders. ``@file:path`` and ``@folder:path`` are handled by the existing path completion path. ))z@diffzGit working tree diff)z@stagedzGit staged diff)@file:z Attach a file)@folder:zAttach a folder)z@git:z Git log with diffs (e.g. @git:5))z@url:zFetch web contentr)rrNrrr)rrrrrr )rr5r r rrrrrrrrr7rrrr_fuzzy_file_completions)rrrlowered _STATIC_REFSrrrbarewant_dir path_partrr match_prefixrrrrrrrr completionquerys r$_context_completionsz*SlashCommandCompleter._context_completionss0**,,  ,  OIt  ++G44 9J9Jg9U9U $'II:%!% -0 0 F#2#;Dt||tv66|!Z/"&$,,BBDV4F 7--i88>8s??/6,J &&s++>/7 JJ!#!:!:!AcJ#%7#3#3H#=#=L j44GGFFF+1133 #G__E#!EKKMM,D,D\,R,R! " Z ? ?IW]]955F  6)) ~~#%7??9#=#=L$*2SSF$*K550@0K0KD$*!BL!B&!B!BJ$"(+D z %%)  QJEE[`QRR//eUCCCCCCCCCCCsE00 E?>E?rc tj}tj}|jr |j|kr||jz dkr|jSg}ddd|gdd|gdddd|gfD] }|d }tj|s tj |d d d | }|j d kr|j r|j d }|ddD]X}tj|r tj||n|} || Yn#tjt(f$rY wxYw||_||_||_|S)z9Return cached list of project files (refreshed every 5s).g@rgz--filesz--sortr=modifiedfdz--typefz--base-directoryrTrh)capture_outputrrcwd Ni)rgetcwdr monotonicrrrshutilwhich subprocessru returncodestdoutrrrrrrTimeoutExpiredr) rrrfilesrtoolprocrpr}s r$_get_project_filesz(SlashCommandCompleter._get_project_filessikkn   $$++d++c11# #90# 6 9c " 8S"4c :   C q6D<%%  !~4?a''DK,=,=,?,?'+++--33D99C $Z**9;q9I9IPbgooa555q S))))E-w7    ! #" sC EE+*E+filepathrc>|sdStj|}|}|}|}||krdS||rdS||vrdS||vrdSd}|D]&}|t |kr|||kr|dz }'|t |krTd}d}d} |D]1}|t |kr|||kr| dvr|dz }|dz }|} 2|t |d zkrd Sd SdS) z?Score a file path against a fuzzy query. Higher = better match.r rP<rWrrz_-./g?#)rrrrr5r ) r%rfilename lower_file lower_pathlower_qqir boundary_hitsprevs r$ _score_pathz!SlashCommandCompleter._score_pathAss 17##H--^^%% ^^%% ++--  3   ) ) 2 j 2 j 2  ACLL  Q'"+%5%5a W  MBD  G $$gbk)9)9v~~%* !GBG s 222r2qr#c #K|}|s|d|D]}|d}tj|}|rdnd}|rdn=t tjtj|} td|d|t| || VdSg} |D]5}| ||} | d kr| | |f6| d | d|D]\} }|d}tj|}|rdnd}|rdn=t tjtj|} td|d|t| || r|d | n|VdS) z-Yield fuzzy file completions for bare @query.Nrfolderfilerr:rrc$|d |dfS)Nrr r)xs r$z?SlashCommandCompleter._fuzzy_file_completions..sAaD5!A$-r#)rz ) r$rrrrrrrr r r2rsort) rrrrr fprr+kindrscoredsrs r$rz-SlashCommandCompleter._fuzzy_file_completionsns8'')) FUFm  S))7++B//#)5xxv &uu,<GLLb11--!#OOrOO$'II:$!%  F ' 'B  U++A1uu q"g&&& // 000FUF^  EAr[[%%Fw''++H%1886D"55(8 RY[["--))DD2 #D z 04<__d___"       r#sub_text sub_lowerc #4K ddlm}|D]r}|d}||rS||krMt|t | ||ddp|ddVsdS#t $rYdSwxYw) z1Yield completions for /skin from available skins.r) list_skinsrrrsourcerN)hermes_cli.skin_enginerCr5r r rr)r@rArCr?rs r$_skin_completionsz'SlashCommandCompleter._skin_completionss  9 9 9 9 9 9Z\\  y??9--$)2C2C$(+H ~ $%&UU="%=%=%TxQSATAT       DD sBB BBc#K ddlm}|didi}d|r)d|kr#t dt | ddV|D]\}}||r||krt|tr4|dp|d d d d }nt|d d }t |t | ||Vd S#t$rYd SwxYw) zAYield completions for /personality from configured personalities.r) load_configagent personalitiesrTzclear personality overlayrr system_promptrNr) rrHrr5r r rrrrr)r@rArHrJrpromptrs r$_personality_completionsz.SlashCommandCompleter._personality_completionss  5 5 5 5 5 5'KMM--gr::>>PRSSM  ++ )0C0C $'MM>"!<  !. 3 3 5 5   f??9-- $)2C2C!&$//0%zz-88`FJJXZ<[<[\_]_\_<`"6{{3B3/$(+H ~ $%)       DD sD.D44 EEc #Kt} ddlm}m}m}||D]h\}}||rN||krH||t|t| ||j d|j dVit| D]\}||vr||r@||kr:||} t|t| || jd| jV]n#t $rYnwxYwt#D]E}||vr||r)||kr#t|t| |dVFdS) zDYield completions for /model from config aliases + built-in aliases.r)_ensure_direct_aliasesDIRECT_ALIASES MODEL_ALIASESz (rrrz LM StudioN)rhermes_cli.model_switchrOrPrQrr5rqr r rHrIr7keysvendorfamilyrr) rr@rArrOrPrQrdaidentitys r$_model_completionsz(SlashCommandCompleter._model_completionss7uu            # " $ $ $*0022  b??9--$)2C2CHHTNNN$(+H ~ $(*%B%BBK%B%B%B }113344  4<<??9--$)2C2C,T2H$(+H ~ $(0%K%K(/%K%K      D  011  Dt||y)) di.?.? $'MM> !,   sDD"" D/.D/c#pK|j}|dsh||}|||Ed{VdS||}|||Ed{VdS|d}|d}t|dks*t|dkr(| drt|dkr|dnd}|} d|vrl|dkr| || Ed{VdS|dkr| || Ed{VdS|d kr| || Ed{VdSd|vrk|tvrb||rMt|D]?} | | r(| | kr"t| t| | V@dS|dd} t D]q\} } || s| dd}|| r7t||| t|  | | Vr|D]\} }| dd}|| rt)|d d }|ddt|dkrdndz}t||| t|  | d| V ddlm}|D]\}}|| rt)|d d} | ddt| dkrdndz}t||| t|  d|d| VdS#t0$rYdSwxYw)Nrr maxsplitrrrz/modelz/skinz /personality)rrrrz Skill commandrr"u⚡ rr u🔌 )text_before_cursorr5rrrrrrr rrXrFrMrrr rrrrrrrrr)rdocumentcomplete_eventrctx_word path_wordrobase_cmdr@rArrrrrBrJr short_descrcmd_infos r$get_completionsz%SlashCommandCompleter.get_completionss*s## 11$77H#44X>>>>>>>>>//55I$11)<<<<<<<<< F A &&8>>## u::>>c%jjAoo$--2D2Do#&u::>>uQxxrH ((I(""x''#66xKKKKKKKKKFw&&#55h JJJJJJJJJF~--#<'>4CXCXYaCbCb'>&x0C~~i00SI5E5E(,/MM>$' FABBx!))  IC((-- 122wH""4((  ))(D99$'II:!% 2244::<<  IC122wH""4(( !$((=/"J"JKK ("-#k:J:JR:O:OUWX  ))(D99$'II:!4 !4!4   > > > > > >&9&9&;&;&A&A&C&C  "(&&t,,x||M;KLLMMD!%crcs4yy2~~ee2!NJ$--h==(+D z .H%9Z%9%9       DD s&B?P'' P54P5NN)rrrrrr)rrrr)rr)rBrrrrr)rrrr)r)rrrrrr)r%rrrrr)r3)rrrrrr)r@rrAr)rrr r!rrr staticmethodrrrrrr$r2rrFrMrXrdrr#r$rr?sTTVZ7; ' ' ' ' '@@@\@\.0000\0d   \ TDTDTDTDTDl''''R***\*X)))))V\ \6,,,,\TTTTTr#rc&eZdZdZ d d d Zd ZdS) SlashCommandAutoSuggestzInline ghost-text suggestions for slash commands and their subcommands. Shows the rest of a command or subcommand in dim text as you type. Falls back to history-based suggestions for non-slash input. Nhistory_suggestAutoSuggest | None completerSlashCommandCompleter | Nonerrc"||_||_dSr)_history _completer)rrjrls r$rz SlashCommandAutoSuggest.__init__Vs ( #r#c"|j}|ds$|jr|j||SdS|d}|d}t |dkr|ds|dd}tD]o}|j |j |s$|dd}||r,||kr&t|t |dcSpdSt |dkr|dnd} | } |j |j |sdS|tvrbt|rUd| vrQt|D]C} | | r,| | kr&t| t | dcSD|jr|j||SdS)Nrr rZrrr) r\r5roget_suggestionrrr rrrprr r) rbufferr]rrorarrrBr@rArs r$rrz&SlashCommandAutoSuggest.get_suggestion^s*s## } F}33FHEEE4 A &&8>>## u::??4==#5#5?8>>##D < <?.t7W7WX[7\7\.qrr7&&t,,<T1A1A%hs4yyzz&:;;;;;4 #5zzA~~5882NN$$  ? &t/O/OPX/Y/Y &4 { " "{8'< "(""&x0??C~~i00?SI5E5E)#c(mmnn*=>>>>> = B=//AA Atr#re)rjrkrlrmrr)rrr r!rrrrr#r$ririOsN/326$$$$$(((((r#rirc tj|}n#t$rYdSwxYw|dkr|dS|dkr |dz ddS|dkr |dz dd S|dz dd S) z:Return a compact human-readable file size, or '' on error.riBiz.0fKi@z.1fMG)rrgetsizer)rsizes r$rrswt$$ rr d{{zzz k+$$$$$    +&-----() 0 0 0 00s " 00)rr)rrrr)rrrr)rrrr)rrrr)rrr)rrrrrrrf)rr)rr)rrrr)rrrrrr)rN) rrrrrrrrrrrr)r)rQrrrR)rrrrrr)rrrra)r)rrrr)rr)rrrr)\r! __future__rloggingrrerrrcollections.abcrr dataclassesrtypingrutilsr getLoggerrrlprompt_toolkit.auto_suggestr r prompt_toolkit.completionr r ImportErrorobjectrrr"rrrrr_cmdrrr_aliasrrrpr_catrrrpcompile _PIPE_SUBS_RErrrkmgroupr frozensetrrrrrrrrrr _TG_NAME_LIMITrrrr_clamp_telegram_namesrPr]r`rrrrrrrrrrrrrirrr#r$rs#"""""  --------!!!!!!!!!!!!  8 $ $ CCCCCCCC?????????KIJJJJ  $ + + + + + + + +$J&JuH)!###J&Jw>  J& JxQS\ J&Jy5yJ&Jv6 J&JwBINNJ&Jv@)LLJ&Jw=y!###J& JxPR[ H666!J&$JzCY(***%J&(JzCY#%%%)J&,JzUW`i;XZZZ-J&0Jv> JJ1J&2Jy? ,>@@@3J&6Jv99 """7J&:J|=y$ <<<;J&>Jx?!###?J&BJwNPY555CJ&FJwXZc#%%%GJ&JJvXZcCEEEKJ&NJx,i88OJ&PJyGPPQJ&RJy=y -999SJ&VJx222QJ&TJ{?(GCEEEUJ&ZJw+_.Z\\\}J&BJxU>IJJJCJ&LJxIK[MJ&PJ|=?O&(((QJ&TJ a);===UJ&XJyMO_(E>@@@YJ&^JyC$000_J&fJzG H666gJ&jJv0&99kJ&lJyUW` """mJ&pJwRTZ[[qJ&rJz>!###sJ&vJ{Dfl444wJ&zJvF 444{J&~JwDfJ&BJwH&222CJ&FJxDf """GJ&JJwZ\bccKJ&PJv~vi111QJ&JJJJb*?)>)@)@@@@@9999 TTD  T$6$6t$<$<TY!l T TF(,(8%S%Sty%S%S%SH\\\ " "354444 88D  8#..t}bAA (TY 9___l 8 8F!),f,,!7DV  %' &&&& >>D >'+tD,<'='= O OO$  122 11D di//C kT^,,A1771::++C00 C*333333**02;22(PPPP.:      &@2=!BJ}--!rz(++    $$$$P-37 v1v1v1v1v1z55555D<`-`-`-`-T!rz/22$9&&& $ $ $ $<<<<~555556>>BAAAA:IIIIIIIII`77777k777t 1 1 1 1 1 1s A A.-A.