
    ,jk@             	         U d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl	m
Z
mZ ddlmZ ddlmZ ddlmZ  ej        e          Z	 ddlmZmZ dd	lmZmZ n# e$ r eZeZdZdZY nw xY w ed
           G d d                      Zg  edddd
           eddddd           edddd
d           edddd
           edddd
           ed d!dd
           ed"d#dd
           ed$d%d           ed&d'dd()           ed*d+dd)           ed,d-dd.d
/           ed0d1dd2d           ed3d4dd5)           ed6d7dd8)           ed9d:dd
d;d<=           ed>d?d           ed@dAdd
dB           edCdDdd
           edEdFddGdH           edIdJddKL           edMdNddOdH           edPdQddH)           edRdSddT)           edUdVddW)           edXdYd           edZd[d\           ed]d^d\           ed_d`dd
dab           edcdddd)           ededfd           edgdhdid
           edjdkdidl)           edmdndidodp           edqdrd\d
           edsdtdid)           edudvdid
dwx           edydzdid
d{|           ed}d~didd           edddi           edddidd           edddidd           edddid
d           edddid
dd           edddidd           edddid
dd           eddddd
/           edddd
           edddd
dd           eddddd           eddd           edddd
dd           edddddd           eddddd           eddddd           eddddd           edddd
           eddddŬL           eddddȬL           edddd
dd̬           edddd
           eddd\d
dѬ           eddd\           edddd
           eddd\           eddd\           eddd\dܬ)           eddd\d
d߬x           eddd\d
d           eddd\d
d8           eddd\d
           eddd\d
d鬎           eddd\           eddd\dL           eddd\           edddd
dd=          Zded<   dOdZ  e             Z!ded<   dPdZ"dQdZ#i Z$ded<   eD ]EZ%e%j&        s< e#e%          e$de%j'         <   e%j(        D ]Z)e%j*         de%j'         de$de) <   Fi Z+ded<   eD ]^Z%e%j&        sUe+,                    e%j-        i           Z.e$de%j'                  e.de%j'         <   e%j(        D ]Z)e$de)          e.de) <   _i Z/d	ed
<   eD ]%Z%e%j0        r e1e%j0                  e/de%j'         <   & ej2        d          Z3eD ]aZ%de%j'         Z4e4e/v se%j5        se36                    e%j5                  Z7e7r,e78                    d          9                    d          e/e4<   b e:d eD                       Z;ded<   dRdZ< e:h d          Z=ded<   dSdZ>dTdZ?dUdVdZ@dWdZAdXdZBdYd!ZCdZd#ZDd$ZE	 d[d%ZFd&ZG	 eGZH ej2        d'          ZI ej2        d(          ZJd\d*ZKd]d.ZLeLZM	 	 d^d_d7ZNd`dad:ZOdbd;ZPdcd=ZQd>ZRd&ZS ej2        d?          ZT e:h d@          ZUdAZV e:dh          ZWd\dBZXdYdCZYdddedGZZdfdHZ[ G dI dJe          Z\ G dK dLe          Z]dgdNZ^dS (h  a  Slash 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)CallableMapping)	dataclass)Any)is_truthy_value)AutoSuggest
Suggestion)	Completer
CompletionT)frozenc                      e Zd ZU dZded<   ded<   ded<   dZded<   d	Zded
<   dZded<   dZded<   dZ	ded<   dZ
ded<   dS )
CommandDefz%Definition of a single slash command.strnamedescriptioncategory ztuple[str, ...]aliases 	args_hintsubcommandsFboolcli_onlygateway_onlyN
str | Nonegateway_config_gate)__name__
__module____qualname____doc____annotations__r   r   r   r   r   r   r       8/home/ubuntu/.hermes/hermes-agent/hermes_cli/commands.pyr   r   -   s         //IIIMMM!G!!!!I#%K%%%%HL&*******r#   r   startz0Acknowledge platform start pings without a replySession)r   newz0Start a new session (fresh session ID + history))resetz[name])r   r   topicz,Enable or inspect Telegram DM topic sessionsz[off|help|session-id])r   r   clearz$Clear screen and start a new session)r   redrawz6Force a full UI repaint (recovers from terminal drift)historyzShow conversation historysavezSave the current conversationretryz(Retry the last message (resend to agent)undoz.Back up N user turns and re-prompt (default 1)z[N]r   titlez#Set a title for the current sessionhandoffzGHand off this session to a messaging platform (Telegram, Discord, etc.)z
<platform>)r   r   branchz5Branch the current session (explore a different path))forkcompresszECompress conversation context (add 'here [N]' to keep recent N turns)z[here [N] | focus topic]rollbackz&List or restore filesystem checkpointsz[number]snapshotz8Create or restore state snapshots of Hermes config/state)snapz[create|restore <id>|prune])r   r   r   stopz%Kill all running background processesapprovez#Approve a pending dangerous commandz[session|always]denyz Deny a pending dangerous command
backgroundzRun a prompt in the background)bgbtwz<prompt>agentsz$Show active agents and running tasks)tasks)r   queuez4Queue a prompt for the next turn (doesn't interrupt))qsteerz>Inject a message after the next tool call without interruptinggoalz?Set a standing goal Hermes works on across turns until achievedz([text | pause | resume | clear | status]subgoalz/Add or manage extra criteria on the active goalz[text | remove N | clear]statuszShow session infowhoamiz-Show your slash command access (admin / user)Infoprofilez+Show active profile name and home directorysethomez!Set this chat as the home channel)zset-home)r   r   resumez!Resume a previously-named sessionsessionsz#Browse and resume previous sessionsconfigzShow current configurationConfigurationmodelzSwitch model for this sessionz0[model] [--provider name] [--global] [--refresh]zcodex-runtimez7Toggle codex app-server runtime for OpenAI/Codex models)codex_runtimez[auto|codex_app_server]gquotaz*Show Google Gemini Code Assist quota usagepersonalityzSet a predefined personality	statusbarz#Toggle the context/model status bar)sb)r   r   verbosez9Cycle tool progress display: off -> new -> all -> verbosezdisplay.tool_progress_command)r   r   footerz7Toggle gateway runtime-metadata footer on final repliesz[on|off|status])onoffrF   )r   r   yoloz7Toggle YOLO mode (skip all dangerous command approvals)	reasoningz#Manage reasoning effort and displayz[level|show|hide])
noneminimallowmediumhighxhighshowhiderW   rX   fastuS   Toggle fast mode — OpenAI Priority Processing / Anthropic Fast Mode (Normal/Fast)z[normal|fast|status])normalrc   rF   rW   rX   skinz%Show or change the display skin/theme)r   r   	indicatorz!Pick the TUI busy-indicator stylez[kaomoji|emoji|unicode|ascii])kaomojiemojiunicodeascii)r   r   r   voicezToggle voice modez[on|off|tts|status])rW   rX   ttsrF   busyz/Control what Enter does while Hermes is workingz[queue|steer|interrupt|status])rA   rC   	interruptrF   toolsz4Manage tools: /tools [list|disable|enable] [name...]zTools & Skillsz[list|disable|enable] [name...]toolsetszList available toolsetsskillsz*Search, install, inspect, or manage skillszskills.write_approval)
searchbrowseinspectinstallauditpendingr:   rejectdiffapproval)r   r   r   memoryz7Review pending memory writes / toggle the approval gatez-[pending|approve|reject|approval] [id|on|off])rw   r:   rx   rz   bundlesz8List skill bundles (aliases /<name> for multiple skills)cronzManage scheduled tasksz[subcommand])listaddcreateeditpauserK   runremovesuggestionsz-Review suggested automations (accept/dismiss))suggestz[accept|dismiss N | catalog])acceptdismisscatalogr*   )r   r   r   	blueprintz.Set up an automation from a blueprint template)bpz[name] [slot=value ...]curatorzGBackground skill maintenance (status, run, pin, archive, list-archived))rF   r   r   rK   pinunpinrestorezlist-archivedkanbanz:Multi-profile collaboration board (tasks, links, comments))!initboardsr   r~   lsra   assignreclaimreassigndiagnosticsdiaglinkunlinkclaimcommentcompleter   blockunblockarchivetaildispatchstatsznotify-subscribeznotify-listznotify-unsubscribelogruns	heartbeat	assigneescontextspecifygcreloadz.Reload .env variables into the running sessionz
reload-mcpzReload MCP servers from config)
reload_mcpzreload-skillsz?Re-scan ~/.hermes/skills/ for newly installed or removed skills)reload_skillsbrowserzBConnect browser tools to your live Chromium-family browser via CDPz[connect|disconnect|status])connect
disconnectrF   pluginsz'List installed plugins and their statuscommandsz*Browse all commands and skills (paginated)z[page]helpzShow available commandsrestartz9Gracefully restart the gateway after draining active runsusagez8Show token usage and rate limits for the current sessioncreditsz#Show Nous credit balance and top upinsightsz!Show usage insights and analyticsz[days]	platformsz&Show gateway/messaging platform status)gatewayplatformz1Pause, resume, or list a failing gateway platformz<pause|resume|list> [name]copyz-Copy the last assistant response to clipboardpastez*Attach clipboard image from your clipboardimagez.Attach a local image file for your next promptz<path>updatez)Update Hermes Agent to the latest versionversionzShow Hermes Agent version)vdebugz@Upload debug report (system info + logs) and get shareable linksquitz:Exit the CLI (use --delete to also remove session history)Exit)exitz
[--delete]zlist[CommandDef]COMMAND_REGISTRYreturndict[str, CommandDef]c                 P    i } t           D ]}|| |j        <   |j        D ]}|| |<   | S )z+Map every name and alias to its CommandDef.)r   r   r   )lookupcmdaliass      r$   _build_command_lookupr      sH    $&F    sx[ 	  	 EF5MM	 Mr#   _COMMAND_LOOKUPr   r   CommandDef | Nonec                    t                               |                                                     d                    S )zmResolve a command name or alias to its CommandDef.

    Accepts names with or without the leading slash.
    /)r   getlowerlstrip)r   s    r$   resolve_commandr     s.    
 tzz||22377888r#   r   c                R    | j         r| j         d| j         d| j          dS | j        S )z;Build a CLI-facing description string including usage hint.z
 (usage: / ))r   r   r   )r   s    r$   _build_descriptionr   	  s:    
} I/HHSXHHHHHH?r#   dict[str, str]COMMANDSr   z (alias for /r   zdict[str, dict[str, str]]COMMANDS_BY_CATEGORYzdict[str, list[str]]SUBCOMMANDSz[a-z]+(?:\|[a-z]+)+|c              #  \   K   | ]'}|j         r|j        |j        g|j        R D ]}|V  (d S N)r   r   r   r   ).0r   r   s      r$   	<genexpr>r   =  su       3 3<3 23 (CK((	3 3 	 	3 3 3 3 3 3 3r#   zfrozenset[str]GATEWAY_KNOWN_COMMANDSr   r   c                `    | sdS | t           v rdS t                      D ]\  }}}|| k    r dS dS )u  Return 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:<name>`` 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   E  sZ      u%%%t1M1O1O  -\:$44 5r#   >   r'   r;   r   r9   rA   rC   r?   rF   r   r:   rI   r   r   r   r<   ACTIVE_SESSION_BYPASS_COMMANDScommand_namec                ,    | rt          |           dundS )u  Return 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   )r   s    r$   should_bypass_active_sessionr   r  s"    ( 9EO?<((44%Or#   set[str]c                    d t           D             } | st                      S 	 ddlm}  |            }n# t          $ r t                      cY S w xY wt                      }| D ]y}|}|j                            d          D ]/}t          |t                    r|	                    |          }-d} t          |d          r|                    |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         	|S r   )r   )r   cs     r$   
<listcomp>z)_resolve_config_gates.<locals>.<listcomp>  s     BBB1A,ABQBBBr#   r   )read_raw_config.NF)default)r   sethermes_cli.configr   	Exceptionr   split
isinstancedictr   r   r   r   )gatedr   cfgresultr   valkeys          r$   _resolve_config_gatesr     s    CB(BBBE uu555555o   uuuuF 	! 	!*0055 	 	C#t$$ ggcll3... 	!JJsx   Ms   4 AAconfig_overridesset[str] | Nonec                \    | j         sdS | j        r||nt                      }| j        |v S dS )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)r   r   r   r   )r   r  	overridess      r$   _is_gateway_availabler    sG     < t
 %(8(D$$J_JaJa	x9$$5r#   r   c                P    |                                                      d          S )zFReturn True when selecting a command without text would be incomplete.<)strip
startswithr0   s    r$   _requires_argumentr
    s     ??'',,,r#   	list[str]c            	        t                      } g }t          D ]}t          ||           s|j        r
d|j         nd}g }|j        D ]Z}|                    dd          |j                            dd          k    r||j        k    rA|                    d| d           [|rdd                    |           d	nd}|                    d|j         | d
|j	         |            |S )z3Generate gateway help text lines from the registry.r   r   -_z`/`z	 (alias: z, r   z` -- )
r   r   r  r   r   replacer   appendjoinr   )r  linesr   argsalias_partsa
alias_notes          r$   gateway_help_linesr    s!   %''IE N N$S)44 	&)m;"3="""!# 	* 	*Ayyc""ch&6&6sC&@&@@@Q#(]]yAyyy))))>IQ:;!7!7::::r
L#(LDLLsL
LLMMMMLr#   list[tuple[str, str, str]]c                    	 ddl m}  n# t          $ r g cY S w xY w	  |             pi }n# t          $ r g cY S w xY wg }|                                D ]\  }}t	          |t
                    rt	          |t                    s0t          |                    d          pd|           }t          |                    d          pd                                          }|	                    |||f           |S )am  Yield (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:`plugins.platforms.discord.adapter._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).
    r   get_plugin_commandsr   Run /r   r   )
hermes_cli.pluginsr  r   itemsr   r   r   r   r  r  )r  r   entriesr   metar   r   s          r$   r   r     s5   :::::::   			&&((.B   			*,Gnn&& 7 7
d$$$ 	JtT,B,B 	$((=11C^T^^DD--344::<<	k956666Ns   	 ) 88list[tuple[str, str]]c                 Z   t                      } g }t          D ]E}t          ||           st          |j                  }|r|                    ||j        f           Ft                      D ]>\  }}}t          |          rt          |          }|r|                    ||f           ?|S )ac  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.

    Built-in commands that require arguments (e.g. /queue, /steer, /background)
    are **included** because their handlers return usage text when selected
    without a payload, making them discoverable via autocomplete.

    Plugin-registered slash commands that require arguments are **excluded**
    because plugins may not provide a no-arg usage fallback.
    )	r   r   r  _sanitize_telegram_namer   r  r   r   r
  )r  r   r   tg_namer   r   r   s          r$   telegram_bot_commandsr&    s     &''I$&F 6 6$S)44 	 *#(33 	6MM7CO4555(D(F(F 2 2$k9i(( 	)$// 	2MM7K0111Mr#   )r   r'   r9   rF   rK   rL   rO   r   r   r   rU   r   r:   r;   rA   rC   r<   rZ   r   r   r   rI   rG   c                    d t          t                    D             d t          t          |           fd          D             S )Nc                4    i | ]\  }}t          |          |S r   )r$  )r   indexr   s      r$   
<dictcomp>z6_prioritize_telegram_menu_commands.<locals>.<dictcomp>8  s6       E4 	 %%u  r#   c                    g | ]\  }}|S r   r   )r   _indexcommands      r$   r   z6_prioritize_telegram_menu_commands.<locals>.<listcomp><  s,       FG 	  r#   c                r    | d         d         v rd| d         d                  | d         fn	d| d         fS )N   r   r   )itemprioritys    r$   <lambda>z4_prioritize_telegram_menu_commands.<locals>.<lambda>@  sT    
 AwqzX%%	 a$Q  Q r#   r   )	enumerate_TELEGRAM_MENU_PRIORITYsorted)r   r1  s    @r$   "_prioritize_telegram_menu_commandsr7  5  sy     $%<==  H %h	 	 	 	 
  
  
   r#       z
[^a-z0-9_]z_{2,}rawc                    |                                                      dd          }t                              d|          }t                              d|          }|                    d          S )uR  Convert 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.
    r  r  r   )r   r  _TG_INVALID_CHARSsub_TG_MULTI_UNDERSCOREr  r9  r   s     r$   r$  r$  Z  s[     99;;sC((D  T**D##C..D::c??r#   r   list[tuple[str, ...]]reservedc                `   t          |          }g }| D ]}|^}}}t          |          t          k    rF|dt                   }||v r1|dt          dz
           }	t          d          D ]}
|	 |
 }||vr nc|}||v rj|                    |           |                    ||g|R            |S )a  Enforce 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.
    Nr/  
   )r   len_CMD_NAME_LIMITranger   r  )r   r@  usedr   entryr   descextra	candidateprefixdigits              r$   _clamp_command_namesrM  h  s      ]]DF , ,"dUt99&&-o-.ID  2223"2YY  E#) 25 2 2I ,, - D4<<tT*E**++++Mr#   d   	max_slotsintreserved_names
desc_limitsanitize_name'Callable[[str], str] | None'&tuple[list[tuple[str, str, str]], int]c                   g }g }	 ddl m}  |            }t          |          D ]j}	|r ||	          n|	}
|
s||	                             dd          }t	          |          |k    r|d|dz
           dz   }|                    |
|f           kn# t          $ r Y nw xY wt          ||          }|                    d |D                        |D ]\  }}|                    ||d	f           t                      }	 dd
l
m}  ||           }n# t          $ r Y nw xY wg }	 ddlm} ddlm} ddl
m} t#          |                                          }t#          |dz                                                                d          dz   }|                    d          dz   g}|                    d  |            D                         |            }t          |          D ]}||         }|                    dd	          s#t+          fd|D                       s?                    |          rU|                    dd	          }||v rp|                    d          }|r ||          n|}
|
s|                    dd	          }t	          |          |k    r|d|dz
           dz   }|                    |
||f           n# t          $ r Y nw xY wt          ||          }t1          d|t	          |          z
            }t1          dt	          |          |z
            }|d|         D ]\  }}}|                    |||f           |d|         |fS )a  Collect 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`.
    r   r  r   Plugin commandN   ...c              3      K   | ]	\  }}|V  
d S r   r   r   nr  s      r$   r   z1_collect_gateway_skill_entries.<locals>.<genexpr>  s&      551!555555r#   r   get_disabled_skill_namesr   get_skill_commands
SKILLS_DIRget_external_skills_dirs.hubr   c              3  `   K   | ])}t          |                              d           d z   V  *dS )r   N)r   rstrip)r   ds     r$   r   z1_collect_gateway_skill_entries.<locals>.<genexpr>  sJ       !
 !
)*CFFMM#$!
 !
 !
 !
 !
 !
r#   skill_md_pathc              3  B   K   | ]}                     |          V  d S r   )r	  )r   rK  
skill_paths     r$   r   z1_collect_gateway_skill_entries.<locals>.<genexpr>  s1      UUz,,V44UUUUUUr#   r   )r  r  r6  r   rC  r  r   rM  r   r   agent.skill_utilsr^  agent.skill_commandsra  tools.skills_toolrc  re  r   resolverh  extendanyr	  r   max) r   rO  rQ  rR  rS  all_entriesplugin_pairsr  plugin_cmdscmd_namer   rH  r\  ri  _platform_disabledr^  skill_triplesra  rc  re  _skills_dir_hub_dir_allowed_prefixes
skill_cmdscmd_keyinfo
skill_nameraw_name	remaininghidden_countkrl  s                                   @r$   _collect_gateway_skill_entriesr    s   F /1K +-L::::::))++{++ 	. 	.H.;I==***D x(,,]<LMMD4yy:%%OZ!^O,u4t----	.     (nEEL55555555 ' '1Aq":&&&& $'55>>>>>>55xHHH    13M&;;;;;;000000>>>>>>*,,..//
V+446677>>sCCcI )//44s:;   !
 !
.F.F.H.H!
 !
 !
 	
 	
 	
 ('))
j)) 	8 	8Gg&D/266J UUUUCTUUUUU $$X.. &"--J///~~c**H.;I==***D 88M2..D4yy:%%OZ!^O,u4  $g!67777'	8(    
 )GGM Ay3{#3#3344Iq#m,,y899L ), & &1aAq!9%%%%z	z"L00s7   B
B 
BB D 
D D &F/K 
K#"K#max_commands!tuple[list[tuple[str, str]], int]c                   t          t          t                                          }d |D             }t          |          }t          dt	          |          | z
            }t          d| t	          |          z
            }t          d||dt                    \  }}|                    d |D                        |d|          ||z   fS )u  Return 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
        commands omitted due to the cap.
    c                    h | ]\  }}|S r   r   r[  s      r$   	<setcomp>z)telegram_menu_commands.<locals>.<setcomp>&  s    222DAqa222r#   r   telegram(   )r   rO  rQ  rR  rS  c              3  &   K   | ]\  }}}||fV  d S r   r   )r   r\  ri  _ks       r$   r   z)telegram_menu_commands.<locals>.<genexpr>3  s,      7781aA777777r#   N)r7  r~   r&  rs  rC  r  r$  rq  )r  core_commandsrQ  all_commandshidden_core_countremaining_slotsr   r  s           r$   telegram_menu_commandsr    s    " 7t<Q<S<S7T7TUUM22M222N&&LAs<00<?@@!\C,=,==>>O:!%-  G\ 77w777777&7H(HHHr#   c                B    t          d| t          |          d          S )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.
    discordrN  )r   rO  rQ  rR  )r  r   )rO  rQ  s     r$   discord_skill_commandsr  7  s/    , *>**	   r#   Mtuple[dict[str, list[tuple[str, str, str]]], list[tuple[str, str, str]], int]c                8   ddl m} t                      }	 ddlm}  |d          }n# t
          $ r Y nw xY wi }g }t                              | d          }d}	 ddlm	} ddlm
}	 dd	lm}
 |
                                }|
d
z                                  }|g}	  |	            D ]C}	 |                     ||                                                     4# t
          $ r Y @w xY wn# t
          $ r Y nw xY w |            }t          |          D ]}||         }|                    dd          }|s$ ||                                          }t#          |                              t#          |                    rqd}|D ]+}	 |                    |           n# t(          $ r Y %w xY w|} ||                    dd          }||v r|                    d          }|dd         }||v rQ||         }|dk    rt,                              d|||           nt,                              d||||           |dz  }3|||<   |                    dd          }t1          |          dk    r|dd         dz   }|j                            |          }|j        }t1          |          dk    r6|d         }|                    |g                               |||f           |                    |||f           n# t
          $ r Y nw xY w|||fS )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 <cat> <name>`` 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_  z
<reserved>r`  rd  rb  rf  rj  r   Nr   r   r8  u   Discord /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.u   Discord /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/  r   rN  a   rY     )pathlibr  r   rm  r^  r   r   fromkeysrn  ra  re  ro  rc  rp  r  r6  r   r   r	  relative_to
ValueErrorr   loggerwarningrC  parentparts
setdefault)rQ  _Prx  r^  
categoriesuncategorized_names_usedhiddenra  re  rc  rz  r{  _scan_rootsextr}  r~  r  rl  spmatched_rootrootr  r  discord_namepriorrH  relr  cats                                 r$   "discord_skill_commands_by_categoryr  U  s@   L #"""""#&55>>>>>>55yIII    9;J02M #'--"M"MKFd;;;;;;>>>>>>000000 ((**'0022 "-	//11  &&rr#ww'8'89999    H
  	 	 	D	''))
j)) M	D M	DGg&D/266J J''))B 2ww!!#h--00  '+L#  NN4((((!   H##&"--J///~~c**H#CRC=L{** $L1L((NN1
 %g|    NN.
 we   !(/K%88M2..D4yy3CRCy5( )''55CIE5zzQAh%%c2..55|T76STTTT$$lD'%BCCCC[M	D\     }f,,s   ) 
66A L C+ )0CC+ 
C'$C+ &C''C+ *L +
C85L 7C88BL F"!L "
F/,L .F//EL 
LL2   z[^a-z0-9_\-]>   medndmsgprowhoawayfeedr  muteopenleaveshrugr)   expandremindrr   rF   collapse	shortcuts)r>   r=   c                    |                                  }t                              d|          }|                    d          }|dt                   S )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.
    r   z-_N)r   _SLACK_INVALID_CHARSr<  r  _SLACK_NAME_LIMITr>  s     r$   _sanitize_slack_namer  #  sI     99;;D##B--D::dD"""##r#   c            	       	 t                      g t                      	                    d           	                    d           d	fd	} fd
t          D             }t
          D ]=}|                    |          }|$ | |d|j         d|j         |j	        pd           >t          D ]1}t          |          s | |j        |j        |j	        pd           2t          D ]A}t          |          s|j        D ]&} | |d|j         d|j         |j	        pd           'Bt                      D ]\  }}} | |||pd           S )a  Return (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 <verb>`` 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 <command>``.

    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 <subcommand>`` 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]r  r   r   rH  hintr   Nonec                   t          |           }|r|v rd S |t          v rd S |t          v rd S t                    t          k    rd S                     ||d d         |d d         f                               |           d S )N   rN  )r  _SLACK_RESERVED_COMMANDS_SLACK_VIA_HERMES_ONLYrC  _SLACK_MAX_SLASH_COMMANDSr  r   )r   rH  r  
slack_namer   seens       r$   _addz"slack_native_slashes.<locals>._addL  s    )$//
 	Z4//F111F///Fw<<444F
D#JTcT
;<<<r#   c                J    i | ]}t          |          |j        D ]}|| S r   )r  r   )r   r   r   r  s      r$   r*  z(slack_native_slashes.<locals>.<dictcomp>_  sX        i00 [	   	s   r#   NzAlias for /u    — r   )r   r   rH  r   r  r   r   r  )r   r   r  r   r   _SLACK_PRIORITY_ALIASESr   r   r   r   r  r   r   )
r  _alias_to_cmdr   r   r   r   r   r   r  r  s
          @@@r$   slack_native_slashesr  /  s   * &''I*,GUUD NNZ[[[HHX      &   #  M ) ] ]&&?DFchFFS_FFH[Y[\\\   = =$S)44 	SXs(;<<<<   ] ]$S)44 	[ 	] 	]E DFchFFS_FFH[Y[\\\\	] )E(F(F 1 1$k9T;	R0000Nr#   )https://hermes-agent.local/slack/commandsrequest_urldict[str, Any]c                    g }t                      D ]1\  }}}d| |pd| d| d}|r||d<   |                    |           2dd|iiS )u  Generate 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.
    r   r  F)r-  r   should_escapeurl
usage_hintfeaturesslash_commands)r  r  )r  slashesr   rH  r   rG  s         r$   slack_app_manifestr    s     G133 	 	dE!4zz1>4>>"	
 
  	("'E,u)7344r#   c                     t                      } i }t          D ]7}t          ||           sd|j         ||j        <   |j        D ]
}d| ||<   8t                      D ]\  }}}||vrd| ||<   |S )a0  Return 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 <plugin-cmd>``
    routes through the plugin handler.
    r   )r   r   r  r   r   r   )r  mappingr   r   r   r   r   s          r$   slack_subcommand_mapr    s     &''I G ) )$S)44 	*NN[ 	) 	)E([[GENN	)*F*H*H ' '&lJw&JJGDMNr#   c                  P   e Zd ZdZ	 	 	 d-d.d
Zd/dZd0dZd0dZ eh d          Z	e
d1d            Ze
d2d            Ze
d3d4d            Ze
d2d            Zd3d4dZd5d Ze
d6d#            Zd7d8d%Ze
d9d(            Ze
d9d)            Ze
d9d*            Ze
d9d+            Zd, ZdS ):SlashCommandCompleterzJAutocomplete for built-in slash commands, subcommands, and skill commands.Nskill_commands_provider1Callable[[], Mapping[str, dict[str, Any]]] | Nonecommand_filterCallable[[str], bool] | Noneskill_bundles_providerr   r  c                Z    || _         || _        || _        g | _        d| _        d| _        d S )Ng        r   )_skill_commands_provider_command_filter_skill_bundles_provider_file_cache_file_cache_time_file_cache_cwd)selfr  r  r  s       r$   __init__zSlashCommandCompleter.__init__  s;     )@%-'=$&('*$&r#   slash_commandr   r   c                |    | j         dS 	 t          |                      |                    S # t          $ r Y dS w xY w)NT)r  r   r   )r  r  s     r$   _command_allowedz&SlashCommandCompleter._command_allowed  sS    '4	,,];;<<< 	 	 	44	s   !- 
;;Mapping[str, dict[str, Any]]c                f    | j         i S 	 |                                  pi S # t          $ r i cY S w xY wr   )r  r   r  s    r$   _iter_skill_commandsz*SlashCommandCompleter._iter_skill_commands  sP    (0I	00228b8 	 	 	III	   ! 00c                f    | j         i S 	 |                                  pi S # t          $ r i cY S w xY wr   )r  r   r  s    r$   _iter_skill_bundlesz)SlashCommandCompleter._iter_skill_bundles  sP    '/I	//117R7 	 	 	III	r  >   re   rO   rR   rw  wordc                <    | |k    r| S | t           j        v r| S |  dS )u  Return 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.

        However, commands that open pickers (model, skin, personality) should
        NOT get a trailing space — the TUI would apply the completion on Enter
        and block the picker from opening.
        r   )r  _PICKER_COMMANDS)rw  r   s     r$   _completion_textz&SlashCommandCompleter._completion_text  s4     tO,===O~~~r#   textr   c                    | sdS t          |           dz
  }|dk    r#| |         dk    r|dz  }|dk    r| |         dk    | |dz   d         }|sdS |                    d          sd|v r|S dS )aC  Extract 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/  r   r   )z./z../~/r   r   rC  r	  r  ir   s      r$   _extract_path_wordz(SlashCommandCompleter._extract_path_word  s      	4 IIM1ffaCFA 1ffaCAEFF| 	4??344 	tKtr#      limitrP  c              #  F  K   t           j                            |           }|                    d          r|}d}n@t           j                            |          pd}t           j                            |          }	 t          j        |          }n# t          $ r Y dS w xY wd}|                                }t          |          D ]W}|r(|                                
                    |          s-||k    r dS t           j                            ||          }	t           j                            |	          }
| 
                    d          rAdt           j                            |	t           j                            d                    z   }nAt           j                            |           r|	}nt           j                            |	          }|
r|dz  }|
rdnd}|
rdnt          |	          }t!          |t#          |            ||z   |	          V  |d
z  }YdS )z8Yield Completion objects for file paths matching *word*.r   r   r   Nr   ~r  dirstart_positiondisplaydisplay_metar/  )ospath
expanduserendswithdirnamebasenamelistdirOSErrorr   r6  r	  r  isdirrelpathisabs_file_size_labelr   rC  )r   r  expanded
search_dirrK  r   countprefix_lowerrG  	full_pathis_dirdisplay_pathsuffixr!  s                 r$   _path_completionsz'SlashCommandCompleter._path_completions  s)      7%%d++S!! 	0!JFF229cJW%%h//F	j,,GG 	 	 	FF	 ||~~G__ 	 	E ekkmm66|DD ~~Z77IW]]9--F s## :#bgooiASASTWAXAX&Y&YYt$$ :(  "wy99 $#"*SSF"C55(8(C(CD #D		z!	      QJEE=	 	s   =B 
B B c                    | sdS t          |           dz
  }|dk    r#| |         dk    r|dz  }|dk    r| |         dk    | |dz   d         }|                    d          sdS |S )z=Extract a bare ``@`` token for context reference completions.Nr/  r   r   @r  r  s      r$   _extract_context_wordz+SlashCommandCompleter._extract_context_wordE  s      	4IIM1ffaCFA 1ffaCAEFF|s## 	4r#   c              #  v  K   |                                 }d}|D ]g\  }}|                                                     |          r;|                                 |k    r#t          |t          |           ||          V  hdD ]}|dd         }||k    s|                    |          r|dk    }	||k    rdn|t          |          d         }
t          j                            |
          }|r|dk    rd	\  }}nZ|                    d
          r|d}}n@t          j                            |          pd}t          j        	                    |          }	 t	          j
        |          }n# t          $ r Y  dS w xY wd}|                                 }t          |          D ]}|r(|                                                     |          s,t          j                            ||          }t          j                            |          }|	|k    rr||k    r nlt          j                            |          }|rd
nd}|rdnt!          |          }| | | }t          |t          |           ||z   |          V  |dz  } dS |dd         }|                     |||          E d{V  dS )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@diffzGit working tree diff)z@stagedzGit staged diff)@file:zAttach a file)@folder:zAttach a folder)z@git:z Git log with diffs (e.g. @git:5))z@url:zFetch web contentr  )r-  r.  Nr.  r   r   )r   r   r   r   r  r/  )r   r	  r   rC  r  r  r  r  r  r  r  r  r6  r  r  r  r  _fuzzy_file_completions)r  r   r  lowered_STATIC_REFSrJ  r!  rK  barewant_dir	path_partr   r!  match_prefixr   r"  r#  rG  r$  r%  r&  r'  
completionquerys                           r$   _context_completionsz*SlashCommandCompleter._context_completionsS  s0      **,,
  , 	 	OIt  ++G44 9J9Jg9U9U $'II:%!%	      - 0	 0	F#2#;Dt||tv66|!Z/"&$,,BBDV4F	7--i88 >8s??/6,J&&s++ >/7JJ!#!:!:!AcJ#%7#3#3H#=#=L j44GG   FFF +1133#G__  E# !EKKMM,D,D\,R,R !  "Z ? ?IW]]955F  6)) ~~#%7??9#=#=L$*2SSF$*K550@0K0KD$*!BL!B&!B!BJ$"(+D		z %%)	      QJEE[ ` QRR//eUCCCCCCCCCCCs   E00
E?>E?r  c           
        t          j                    }t          j                    }| j        r | j        |k    r|| j        z
  dk     r| j        S g }ddd|gdd|gdddd|gfD ]}|d	         }t          j        |          s 	 t          j
        |d
d
d|dd          }|j        d	k    r|j        r|j                                        r|j                                                            d          }|dd         D ]X}t           j                            |          r t           j                            ||          n|}	|                    |	           Y n# t          j        t(          f$ r Y w xY w|| _        || _        || _        |S )z9Return cached list of project files (refreshed every 5s).g      @rgz--filesz--sortr=modifiedfdz--typefz--base-directoryr   Tr  zutf-8r  )capture_outputr  timeoutcwdencodingerrors
Ni  )r  getcwdtime	monotonicr  r  r  shutilwhich
subprocessr   
returncodestdoutr  r   r  r  r  r  TimeoutExpiredr  )
r  r@  nowfilesr   toolprocr9  pr  s
             r$   _get_project_filesz(SlashCommandCompleter._get_project_files  s   ikkn	$$++d++c11## 90#69c"8S"4c:
 	 	C
 q6D<%% !~4gi   ?a''DK'DK<M<M<O<O'+++--33D99C $Z * *9;q9I9IPbgooa555qS))))E-w7    ! #"s   CEE43E4filepathr8  c                >   |sdS t           j                            |           }|                                }|                                 }|                                }||k    rdS |                    |          rdS ||v rdS ||v rdS d}|D ]&}|t          |          k     r|||         k    r|dz  }'|t          |          k    rTd}d}d}	|D ]1}|t          |          k     r|||         k    r|	dv r|dz  }|dz  }|}	2|t          |          d	z  k    rd
S dS dS )z?Score a file path against a fuzzy query. Higher = better match.r/  rN  P   <   r  r   r  z_-./g      ?#      )r  r  r  r   r	  rC  )
rS  r8  filename
lower_file
lower_pathlower_qqir   boundary_hitsprevs
             r$   _score_pathz!SlashCommandCompleter._score_path  ss     	17##H--^^%%
^^%%
++--   3  )) 	2j  2j  2  	 	ACLL  Q'"+%5%5aWMBD  G$$gbk)9)9v~~%*!GBGs 222r2qr#      c           	   #    K   |                                  }|s|d|         D ]}|                    d          }t          j                            |          }|rdnd}|rdn=t          t          j                            t          j                    |                    }	t          d| d| t          |           ||	          V  dS g }
|D ]5}| 
                    ||          }|d	k    r|
                    ||f           6|
                    d
            |
d|         D ]\  }}|                    d          }t          j                            |          }|rdnd}|rdn=t          t          j                            t          j                    |                    }	t          d| d| t          |           ||	r| d|	 n|          V  dS )z-Yield fuzzy file completions for bare @query.Nr   folderfiler  r*  :r  r   c                $    | d          | d         fS )Nr   r/  r   )xs    r$   r2  z?SlashCommandCompleter._fuzzy_file_completions.<locals>.<lambda>  s    AaD5!A$- r#   r3  z  )rR  r  r  r  r  r  r  rD  r   rC  r`  r  sort)r  r   r8  r  rN  fpr%  rY  kindr!  scoredsr  s                r$   r0  z-SlashCommandCompleter._fuzzy_file_completions  s8     '')) 	FUFm  S))7++B//#)5xxv & uu,<GLLb11- - !#OOrOO$'II:$!%	       F  	' 	'B  U++A1uuq"g&&&//000FUF^ 	 	EAr[[%%Fw''++H%1886D" 55(8RY[["--) )D D2 #D		z 04<__d___"	      	 	r#   sub_text	sub_lowerc           
   #  4  K   	 ddl m}  |            D ]r}|d         }|                    |          rS||k    rMt          |t	          |            ||                    dd          p|                    dd                    V  sdS # t          $ r Y dS w xY w)	z1Yield completions for /skin from available skins.r   )
list_skinsr   r   r   sourcer  N)hermes_cli.skin_enginerp  r	  r   rC  r   r   )rm  rn  rp  rl  r   s        r$   _skin_completionsz'SlashCommandCompleter._skin_completions*  s      	999999Z\\  y??9-- $)2C2C$(+H~ $%&UU="%=%=%TxQSATAT	        	 	 	DD	s   BB	 	
BBc           	   #  d  K   d}|                                  }|                     d          }t          |          dk    st          |          dk    rp|sn|s| nd}|D ]c}|                    |                                          r:||                                k    r"t          |t          |           |          V  ddS |d                                         }|dvrdS |rdn|d	         }|                                }t          |r
|dd         n	|dd	                   }		 dd
lm}
 ddl	m
}m}m}  |
            } ||dd          }|D ]Y\  }}}||	v s|                    |          s ||v }|dk    r|r-|dk    r|s6t          |t          |           ||          V  Zt           |                      D ]U}||	v s|                    |          s||v }|dk    r|r)|dk    r|s2t          |t          |           |d          V  V|                    d          pi }t          |t                     rXt          |          D ]J}| d}||	v s|                    |          s!t          |t          |           |d| d          V  IdS dS # t"          $ r Y dS w xY w)uh  Yield completions for /tools — subcommand + toolset/MCP-server name.

        Handles both ``/tools <tab>`` (suggesting ``list|disable|enable``) and
        ``/tools enable <tab>`` / ``/tools disable <tab>`` (suggesting toolset
        keys and MCP server prefixes, filtered by current enable state so the
        user only sees actionable options).
        )r~   disableenabler   r   r/  r   r  r  N)rv  ru  r/  )load_config)CONFIGURABLE_TOOLSETS_get_platform_tools_get_plugin_toolset_keyscliF)include_default_mcp_serversrv  ru  r  zplugin toolsetmcp_serversre  zMCP server '')r   r  rC  r	  r   r   r   r   rx  hermes_cli.tools_configry  rz  r{  r6  r   r   r   r   )rm  rn  SUBSr  trailing_spacepartialr<  
subcommandpartial_loweralreadyrx  ry  rz  r{  rM   enabledts_keylabel_descis_onr~  serverrK  s                          r$   _tools_completionsz(SlashCommandCompleter._tools_completions;  s      -  !**3// u::??s5zzQ~&4<hh"G U U>>'--//22 Usgmmoo7M7M$S#g,,PSTTTTTTF1X^^%%
222F&5""E"I>BeABBiiuQrT{CC6	555555          ![]]F))&%UZ[[[G(=  $uW$$F,=,=m,L,L$')))e)**5* $'LL="!&	       !!9!9!;!;<<  W$$F,=,=m,L,L$')))e)**5* $'LL="!1	       !**]339rK+t,, 
$[11 	 	F &\\\F((0A0A-0P0P( $(+G} &%=F%=%=%=	      
 
	 	  	 	 	FF	s   (E5J! !
J/.J/c              #  |  K   |                                  }|                     d          }t          |          dk    st          |          dk    r|rdS |r|rdn|d         }|                                }	 ddlm}  |            }|                                }n# t          $ r Y dS w xY w|D ]}	|	j        }
|
	                    |          s	 |
                    |	          }n# t          $ r d}Y nw xY w|rt          |dd          r
d	|j         nd
}t          |
t          |           |
|          V  dS )u_  Yield platform completions for /handoff.

        Offers connected (enabled + configured) gateway platforms. A recorded
        home channel is NOT required to list a platform — it's often learned at
        runtime — so the meta hints whether one is set yet. Completes only the
        first arg (the platform); once one is chosen, stop.
        r   r/  Nr   r/  r   )load_gateway_configr   u   → zsend this session herer  )r   r  rC  r   gateway.configr  get_connected_platformsr   valuer	  get_home_channelgetattrr   r   )rm  rn  r  r  r  r  r  gwr   r   r   homer!  s                r$   _handoff_completionsz*SlashCommandCompleter._handoff_completions  s        !**3//u::>>c%jjAoo.oF"DnD""59	::::::$$&&B2244II 	 	 	FF	! 	 	H>D??=11 **844   )-k'$2M2Mk%$)%%%SkD #G}!	      	 	s$   9$B 
B,+B,C''C65C6c              #    K   	 ddl m}  |                                d          pi                     di           pi }d                    |          r)d|k    r#t	          dt          |            dd          V  |                                D ]\  }}|                    |          r||k    rt          |t                    r4|                    d          p|                    d	d
          dd         }nt          |          dd         }t	          |t          |            ||          V  dS # t          $ r Y dS w xY w)zAYield completions for /personality from configured personalities.r   )load_cli_configagentpersonalitiesr[   zclear personality overlayr  r   system_promptr   Nr  )r|  r  r   r	  r   rC  r  r   r   r   r   )rm  rn  r  r  r   promptr!  s          r$   _personality_completionsz.SlashCommandCompleter._personality_completions  s     	
 ,+++++,_..227;;ArFFXZ[[a_aM  ++ )0C0C $'MM>"!<	      !. 3 3 5 5  f??9-- 
$)2C2C!&$// 0%zz-88`FJJXZ<[<[\_]_\_<`"6{{3B3/$(+H~ $%)	        	 	 	DD	s   D1D7 7
EEc              #  
  K   |j         }|                    d          sh|                     |          }||                     |          E d {V  d S |                     |          }||                     |          E d {V  d S |                    d          }|d                                         }t          |          dk    s*t          |          dk    rL|	                    d          r6t          |          dk    r|d         nd}|                                }	d|vrH|dk    r| 
                    ||	          E d {V  d S |dk    r|                     ||	          E d {V  d S |d	k    r|                     ||	          E d {V  d S |d
k    r|                     ||	          E d {V  d S d|vrk|t          v rb|                     |          rMt          |         D ]?}
|
                    |	          r(|
|	k    r"t!          |
t          |           |
          V  @d S |dd          }t"                                          D ]q\  }}|                     |          s|dd          }|                    |          r7t!          |                     ||          t          |           ||          V  r|                                                                 D ]\  }}|dd          }|                    |          rt+          |                    dd                    }|d d         t          |          dk    rdndz   }t          |                    dg                     }t!          |                     ||          t          |           |d| d| d          V  |                                                                 D ]\  }}|dd          }|                    |          rt+          |                    dd                    }|d d         t          |          dk    rdndz   }t!          |                     ||          t          |           |d|           V  	 ddlm}  |                                            D ]\  }}|                    |          rt+          |                    dd                    }|d d         t          |          dk    rdndz   }t!          |                     ||          t          |           d| d|           V  d S # t4          $ r Y d S w xY w)Nr   r/  maxsplitr   r   r   z/skinz/personalityz/toolsz/handoffrw  r  r   zSkill bundler  rY  rq   u   ▣ z (z skills)zSkill commandu   ⚡ r  rW  u   🔌 )text_before_cursorr	  r+  r9  r
  r(  r   r   rC  r  rs  r  r  r  r   r  r   r   r  r  r  r   r   r  r  r  r   )r  documentcomplete_eventr  ctx_word	path_wordr  base_cmdrm  rn  r<  r   r   rH  rw  r  r   
short_descskill_countr  cmd_infos                        r$   get_completionsz%SlashCommandCompleter.get_completions  s_     *s## 
	11$77H#44X>>>>>>>>>//55I$11)<<<<<<<<<F 

A
&&8>>##u::>>c%jjAoo$--2D2Do#&u::>>uQxxrH ((I (""w&&#55h	JJJJJJJJJF~--#<<XyQQQQQQQQQF
 8##228YGGGGGGGGG:%%44XyIIIIIIIII (""x;'>'>4CXCXYaCbCb'>&x0  C~~i00 SI5E5E(,/MM>$'     
 FABBx!)) 
	 
	IC((-- 122wH""4((  ))(D99$'II:!%	      113399;; 	 	IC122wH""4(( 	!$((=."I"IJJ("-#k:J:JR:O:OUWX
!$((8R"8"899 ))(D99$'II:!K
!K!Kk!K!K!K	      2244::<< 
	 
	IC122wH""4(( !$((=/"J"JKK("-#k:J:JR:O:OUWX
 ))(D99$'II:!4
!4!4	     	>>>>>>&9&9&;&;&A&A&C&C 	 	"(&&t,, x||M;KLLMMD!%crcs4yy2~~ee2!NJ$--h==(+D		z .H%9Z%9%9	     		 	  	 	 	DD	s   ;B?T< <
U
	U
)NNN)r  r  r  r  r  r  r   r  )r  r   r   r   )r   r  )rw  r   r   r   r   r   )r  r   r   r   )r  )r   r   r  rP  r   r  )rS  r   r8  r   r   rP  )ra  )r   r   r8  r   r  rP  )rm  r   rn  r   )r   r   r    r!   r  r  r  r  	frozensetr  staticmethodr  r
  r(  r+  r9  rR  r`  r0  rs  r  r  r  r  r   r#   r$   r  r    s(       TT VZ7;TX	' ' ' ' '          !y!A!A!ABB   \&    \. 0 0 0 0 \0d    \TD TD TD TD TDl' ' ' 'R * * * \*X) ) ) ) )V    \  R R R \Rh # # # \#J    \@i i i i ir#   r  c                  &    e Zd ZdZ	 	 ddd	Zd
 ZdS )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.
    Nhistory_suggestAutoSuggest | None	completerSlashCommandCompleter | Noner   r  c                "    || _         || _        d S r   )_history
_completer)r  r  r  s      r$   r  z SlashCommandAutoSuggest.__init__N  s    
 (#r#   c                "   |j         }|                    d          s$| j        r| j                            ||          S d S |                    d          }|d                                         }t          |          dk    r|                    d          s|dd                                          }t          D ]o}| j	        | j	        
                    |          s$|dd          }|                    |          r,||k    r&t          |t          |          d                    c S pd S t          |          dk    r|d         nd}	|	                                }
| j	        | j	        
                    |          sd S |t          v rbt          |         rUd|	vrQt          |         D ]C}|                    |
          r,||
k    r&t          |t          |	          d                    c S D| j        r| j                            ||          S d S )Nr   r/  r  r   r   r   )r  r	  r  get_suggestionr   r   rC  r  r   r  r  r
   r   )r  bufferr  r  r  r  r   r   rw  rm  rn  r<  s               r$   r  z&SlashCommandAutoSuggest.get_suggestionV  s   * s## 	} F}33FHEEE4

A
&&8>>##u::??4==#5#5?8>>##D < <?.t7W7WX[7\7\.qrr7&&t,, <T1A1A%hs4yyzz&:;;;;;4  #5zzA~~5882NN$$	 ?&t/O/OPX/Y/Y&4{""{8'<"(""&x0 ? ?C~~i00 ?SI5E5E)#c(mmnn*=>>>>> = 	B=//AAAtr#   )NN)r  r  r  r  r   r  )r   r   r    r!   r  r  r   r#   r$   r  r  G  sN          /326$ $ $ $ $( ( ( ( (r#   r  r  c                    	 t           j                            |           }n# t          $ r Y dS w xY w|dk     r| dS |dk     r	|dz  ddS |dk     r	|dz  dd	S |dz  dd
S )z:Return a compact human-readable file size, or '' on error.r   i   Bi   z.0fKi   @z.1fMG)r  r  getsizer  )r  sizes     r$   r  r    s    wt$$   rrd{{zzzk+$$$$$   +&-----()00000s   " 
00)r   r   )r   r   r   r   )r   r   r   r   )r   r   r   r   )r   r   r   r   )r   r   r   )r   r   r  r  r   r   )r   r   r   r   r  )r   r  )r   r"  )r   r"  r   r"  )r9  r   r   r   )r   r?  r@  r   r   r?  )rN  N)r   r   rO  rP  rQ  r   rR  rP  rS  rT  r   rU  )rN  )r  rP  r   r  )rO  rP  rQ  r   r   rU  )rQ  r   r   r  )r  )r  r   r   r  )r   r   )r  r   r   r   )_r!   
__future__r   loggingr  rerG  rI  rE  collections.abcr   r   dataclassesr   typingr   utilsr   	getLoggerr   r  prompt_toolkit.auto_suggestr	   r
   prompt_toolkit.completionr   r   ImportErrorobjectr   r   r"   r   r   r   r   r   _cmdr   r   r   _aliasr   r   r  r   _catr   r   r~   compile_PIPE_SUBS_REr   r   rr   mgroupr   r  r   r   r   r   r   r  r
  r  r   r&  r5  r7  rD  _TG_NAME_LIMITr;  r=  r$  rM  _clamp_telegram_namesr  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r  r   r#   r$   <module>r     s     # " " " " "  				 				       - - - - - - - - ! ! ! ! ! !       ! ! ! ! ! !		8	$	$CCCCCCCC?????????   KIJJJJ	 $+ + + + + + + +$m&JwJI " " "m& JuH)!X7 7 7	m& JwF	 ,CE E Em& Jw>	  m& JxQS\  m& Jy5y  m& Jv6	  m&  JwBINN!m&" JvG     #m&& Jw=y!# # #'m&* Jycen%6 6 6+m&. JxPR[ H6 6 6/m&2 Jzbdm35 5 53m&6 JzCY#% % %7m&: JzUW`i;XZ Z Z;m&> Jv>	JJ?m&@ Jy? ,>@ @ @Am&D Jv99 " " "Em&H J|=y$
< < <Im&L Jx?!# # #Mm&P JwNPY5 5 5Qm&T JwXZc#% % %Um&X JvXZcCE E EYm&\ JyKY46 6 6]m&` Jx,i88am&b JxH&QQcm&d JyGPPem&f Jy=y -9 9 9gm&j Jx<i!# # #km&r Jz@)LLsm&x Jx5  ym&| Jw7KM M M}m&@ J Y(:24 4 4Am&F JxEv  Gm&L J}<o!# # #Mm&P J{A?g/ / /Qm&T JyU#BD D DUm&Z JxR*;24 4 4[m&` JvP   am&d J{A?,mo o oem&j Jvln}/DF F Fkm&p Jv>2 2 2qm&t J{?(GCE E Eum&z Jw+_.<Z\ \ \{m&~ JvH/(HDF F Fm&H JwNP`:TK K KIm&L Jz46F  Mm&P JxE$#:PQ Q QQm&Z JxRHGI I I[m&b JyT! !cm&f Jv/1A`b b bgm&l J}MA_DF F Fmm&r J{L<UW W Wsm&v Jyc>km m mwm&| JxU>RS S S}m&L JxIK[  Mm&P J|=?O&( ( (Qm&T J a);= = =Um&X Jy^`p(E>@ @ @Ym&^ JyC$0 0 0_m&f JzG H6 6 6gm&j Jv0&99km&l JyUW` " " "mm&p JwRTZ[[qm&r Jy?HHsm&t Jz>!# # #um&x J{Dfl4 4 4ym&| JzNPV ,HJ J J}m&@ JvF
4 4 4Am&D JwDf  Em&H JwH&2 2 2Im&L JxDfMMMm&N Jy5vvNNNOm&P JwZ\bccQm&V JvSU[i<I I IWm&  m m m mh    *?)>)@)@ @ @ @ @9 9 9 9         T TD T$6$6t$<$<TY!l 	T 	TF(,(8%S%Sty%S%S%SH\\\"" 35  4 4 4 4 8 8D 8#..t}bAA (TY 9___l 	8 	8F!),f,,!7DV %' & & & & > >D >'+tD,<'='=O	OO$ 
122 1 1D
di//C
kT^,,A 1771::++C00C *3 3 33 3 3 * *        0 2;  2 2     *P P P P.   :     - - - -
   &   @   D :   2  = ! BJ}-- !rz(++    $ $ $ $P -  37v1 v1 v1 v1 v1z I  I  I  I  IF   <`- `- `- `-T   !rz/22 $9 & & &   & (  #I;// 	$ 	$ 	$ 	$N N N Nb5 5 5 5 56   8I
 I
 I
 I
 I
I I
 I
 I
`7 7 7 7 7k 7 7 7t1 1 1 1 1 1s   A A.-A.