
    Jj^g             
         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
d(d)*           ed+d,dd-.           ed/d0dd.           ed1d2dd3d
4           ed5d6dd7d           ed8d9dd:d;           ed<d=dd>.           ed?d@dd
dAdBC           edDdEd           edFdGdd
dH           edIdJdd
dK           edLdMddNdO           edPdQddRS           edTdUddVd
dWdXY           edZd[dd\dO           ed]d^ddO.           ed_d`dda.           edbdcddO.           edddeddf.           edgdhd           edidjdk           edldmdk           edndodd
dpq           edrdsdd.           edtdud           edvdwdxd
           edydzdxd{.           ed|d}dxd~d           edddxd.           edddxd
d           edddxd
ddd           edddxd
d           edddxdd           edddx           edddxdd           edddxdd           edddxd
d           edddxd
dd           edddxdd           edddxd
dd           eddddd
4           edddd
           edddd
dd           eddddd           eddd           edddd
dd           edddd
ddŬC           eddddȬ.           edddd
dd̬           eddddddѬҦ           eddddd֬           eddddd٬           edddddܬ           edddd
           eddddS           eddddS           edddd
dd謤           edddd
           edddkd
d           edddk           edddd
           edddk           edddk           edddkd
           edddkd.           edddkd
d           edddkd
d            edddkd
d>           edddkd
           edddkd
d           edd	dk           ed
ddkdS           edddkd.           edddd
ddC          Zded<   d{dZ  e             Z!ded<   d|dZ"d}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.<   d~d1Z< e:h d2          Z=d-ed3<   dd5Z>dd7Z?ddd:Z@dd<ZAdd>ZBdd@ZCddBZDdCZEdDZFh dEZGdFZH	 ddJZIddLZJddNZKddRZLddSZMddTZNdUZO	 eOZP ej2        dV          ZQ ej2        dW          ZRddYZSdd]ZTeTZU	 	 ddddZVdddgZWddhZXddjZYdkZZdUZ[ ej2        dl          Z\ e:h dm          Z]dnZ^ e:h do          Z_ddpZ`ddqZadddtZbdduZc G dv dwe          Zd G dx dye          ZeddzZfdS (  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 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       9/home/rurouni/.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)promptz<Compose your next prompt in $EDITOR (markdown), then send itz[initial text])compose)r   r   r   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compresszhCompress conversation context (add 'here [N]' to keep recent N turns; --preview shows what would happen))compactz.[here [N] | focus topic | --preview|--dry-run]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 (optionally with a reason)z[all] [reason]
backgroundzRun a prompt in the background)bgbtwz<prompt>agentsz$Show active agents and running tasks)tasks)r   journeyz"Open the learning journey timeline)learningzmemory-graphz[list|delete <id>|edit <id>])listdeleteedit)r   r   r   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 achievedzT[text | draft <text> | show | pause | resume | clear | status | wait <pid> | unwait]moazTRun one prompt through the default Mixture of Agents preset, then restore your modelsubgoalz/Add or manage extra criteria on the active goalz[text | remove N | clear]statusz,Show session, model, token, and context 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 (persists by default)z:[model] [--provider name] [--global|--session] [--refresh]zcodex-runtimez7Toggle codex app-server runtime for OpenAI/Codex models)codex_runtimez[auto|codex_app_server]personalityzSet a predefined personality	statusbarz#Toggle the context/model status bar)sb)r   r   
timestampsz2Toggle [HH:MM] timestamps on messages and /historyz[on|off|status])onoffrP   )ts)r   r   r   r   verbosez@Cycle tool progress display: off -> new -> all -> verbose -> logzdisplay.tool_progress_command)r   r   footerz7Toggle gateway runtime-metadata footer on final replies)r   r   yoloz7Toggle YOLO mode (skip all dangerous command approvals)	reasoningz#Manage reasoning effort and displayz[level|show|hide|full|clamp])noneminimallowmediumhighxhighshowhider_   r`   fullclampfastuS   Toggle fast mode — OpenAI Priority Processing / Anthropic Fast Mode (Normal/Fast)z[normal|fast|status])normalrp   rP   r_   r`   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])r_   r`   ttsrP   busyz/Control what Enter does while Hermes is workingz[queue|steer|interrupt|status])rJ   rL   	interruptrP   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])r   r>   r   r   bundlesz8List skill bundles (aliases /<name> for multiple skills)petz>Toggle or adopt a petdex mascot (/pet, /pet list, /pet <slug>)z[toggle|list|scale <n>|<slug>])togglerG   scaler`   hatchz,Generate a new petdex pet from a description)zgenerate-petz[description]learnzPLearn a reusable skill from anything you describe (dirs, URLs, this chat, notes)z<what to learn from>cronzManage scheduled tasksz[subcommand])rG   addcreaterI   pauserU   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))rP   r   r   rU   pinunpinrestorezlist-archivedkanbanz:Multi-profile collaboration board (tasks, links, comments))!initboardsr   rG   lsrl   assignreclaimreassigndiagnosticsdiaglinkunlinkclaimcommentcompleterI   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
disconnectrP   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billinguA   Manage Nous terminal billing — buy credits, auto-reload, limits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 linksz[nous|local]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   O  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   W  sZ      u%%%t1M1O1O  -\:$44 5r$   >   r(   r?   r   r=   rJ   rL   rC   rP   r   r>   rS   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     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
startswithr3   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_commandsr8     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$   <   d   >   r#  prependr"  )r   r(   r=   rP   rU   rV   rY   r   r   r   rb   r   r>   r?   rJ   rL   r@   re   r   r   r   rS   rQ   rootMapping[str, Any]pathc                    | }|D ]0}t          |t                    si c S |                    |          }1t          |t                    r|ni S r   )r  r   r   )r<  r>  noder  s       r%   _nested_mappingrA  O  s[    D  $(( 	IIIxx}}dG,,444"4r$   dict[str, Any]c            	        	 ddl m}   |             pi }n# t          $ r i }Y nw xY wt          |t                    si }t          t          |dddd                    }|                    dt                    }	 t          |          }n# t          t          f$ r
 t          }Y nw xY wt          dt          t          |                    }t          |                    d	          pd
                                                                          }|t$          vrd
}|                    d          }t          |t&                    rd |D             }ng }|||dS )zReturn normalized Telegram command-menu config with safe defaults.

    Canonical user-facing path:
    ``platforms.telegram.extra.command_menu``.
    r   r  r   telegramextracommand_menumax_commands   priority_moder;  priorityc                n    g | ]2}t          |                                          #t          |          3S r   )r   r  )r   items     r%   r  z1_telegram_command_menu_config.<locals>.<listcomp>u  s3    LLL$#d))//:K:KLCIILLLr$   )rG  rI  rJ  )r  r  r	  r  r   r  rA  r   #_DEFAULT_TELEGRAM_MENU_MAX_COMMANDSint	TypeError
ValueErrormaxmin_TELEGRAM_BOT_API_MAX_COMMANDSr   r  r   _TELEGRAM_PRIORITY_MODESrG   )r  raw_cfgmenu_cfgrG  rI  raw_priorityrJ  s          r%   _telegram_command_menu_configrX  X  s   555555!/##)r   gw'' OG[*g~^^__H<<0STTL;<((z" ; ; ;:;q#<lKKLLL_55BCCIIKKQQSSM444!<<
++L,%% LL,LLL %&  s    $$:B
 
B%$B%rN  c                 D    t          t                      d                   S )z@Return configured Telegram BotCommand menu cap with safe bounds.rG  )rN  rX  r   r$   r%   telegram_menu_max_commandsrZ    s    ,..~>???r$   	raw_nameslist[str] | tuple[str, ...]r   c                    g }t                      }| D ]N}t          t          |                    }|r.||vr*|                    |           |                    |           Ot          |          S r   )r  r6  r   r   r#  tuple)r[  r  seenraw_namer   s        r%   _dedupe_sanitized_namesra    sr    FUUD    &s8}}55 	 D$$HHTNNNMM$==r$   c                    t                      } t          t          | d                             }t          t          t                              }| d         dk    r|}n| d         dk    r||z   }n||z   }t          |          S )NrJ  rI  r"  r#  )rX  rG   ra  _TELEGRAM_MENU_PRIORITY)rV  
configureddefaultsrW  s       r%   _telegram_effective_priorityrf    s    ,..H-hz.BCCDDJ+,CDDEEH I--!	/	"h	.	.*,!H,"<000r$   c                    d t          t                                D             d t          t          |           fd          D             S )Nc                    i | ]\  }}||	S r   r   )r   indexr   s      r%   
<dictcomp>z6_prioritize_telegram_menu_commands.<locals>.<dictcomp>  s.       E4 	e  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 )NrH  r   r   )rL  rJ  s    r%   <lambda>z4_prioritize_telegram_menu_commands.<locals>.<lambda>  sT    
 AwqzX%%	 a$Q  Q r$   r  )	enumeraterf  sorted)r   rJ  s    @r%   "_prioritize_telegram_menu_commandsrs    s     $%A%C%CDD  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  ru  r   s     r%   r6  r6    s[     99;;sC((D  T**D##C..D::c??r$   r2  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.
    NrH  
   )r  len_CMD_NAME_LIMITranger   r#  )r2  r|  usedr  entryr   descrE  	candidateprefixdigits              r%   _clamp_command_namesr    s      ]]DF , ,"dUt99&&-o-.ID  2223"2YY  E#) 25 2 2I ,, - D4<<tT*E**++++Mr$   	max_slots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>7  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>R  sJ       !
 !
)*CFFMM#$!
 !
 !
 !
 !
 !
r$   skill_md_pathc              3  B   K   | ]}                     |          V  d S r   )r  )r   r  
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   )r0  r.  rr  r   r  r#  r	  r  r   r  agent.skill_utilsr  agent.skill_commandsr  tools.skills_toolr  r  r   resolver  extendanyr  r   rQ  ) r   r  r  r  r  all_entriesplugin_pairsr.  plugin_cmdscmd_namer   r  r  r  _platform_disabledr  skill_triplesr  r  r  _skills_dir_hub_dir_allowed_prefixes
skill_cmdscmd_keyinfo
skill_namer`  	remaininghidden_countkr  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#rG  !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   rD  (   )r   r  r  r  r  c              3  &   K   | ]\  }}}||fV  d S r   r   )r   r  r  _ks       r%   r   z)telegram_menu_commands.<locals>.<genexpr>  s,      7781aA777777r$   N)rs  rG   r8  rQ  r  r  r6  r  )rG  core_commandsr  all_commandshidden_core_countremaining_slotsr2  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.
    discordr:  )r   r  r  r  )r  r  )r  r  s     r%   discord_skill_commandsr    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  r  r  r  r  r   Nr   r   rt  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.rH  r   r:  a   r     )pathlibr  r  r  r  r	  r  fromkeysr  r  r  r  r  r  r#  rr  r   r   r  relative_torP  r   loggerwarningr  parentparts
setdefault)r  _Pr  r  
categoriesuncategorized_names_usedhiddenr  r  r  r  r  _scan_rootsextr  r  r  r  spmatched_rootr<  r  r`  discord_namepriorr  relr  cats                                 r%   "discord_skill_commands_by_categoryr    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remindr   rP   collapse	shortcuts)rB   rA   >   rN   r   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_CHARSrx  r  _SLACK_NAME_LIMITrz  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   r  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   r:  )r  _SLACK_RESERVED_COMMANDS_SLACK_VIA_HERMES_ONLYr  _SLACK_MAX_SLASH_COMMANDSr#  r   )r   r  r  
slack_namer2  r_  s       r%   _addz"slack_native_slashes.<locals>._add  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%   rj  z(slack_native_slashes.<locals>.<dictcomp>  sX        i00 [	   	s   r$   NzAlias for /u    — r   )r   r   r  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   r2  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_urlc                    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)rm  r   should_escapeurl
usage_hintfeaturesslash_commands)r	  r#  )r  slashesr   r  r   r  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                  x   e Zd ZdZ	 	 	 d1d2d
Zd3dZd4dZd4dZed5d            Z	d6dZ
d7dZ eh d          Zed8d            Zed9d            Zed:d;d             Zed9d!            Zd:d;d"Zd<d$Zed=d'            Zd>d?d)Zed@d,            Zed@d-            Zed@d.            Zed@d/            Zd0 ZdS )A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_allowed6  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_bundlesF  sP    '/I	//117R7 	 	 	III	r.  tokenc                ~    d|                      d                              dd                                          z   S )zCanonicalize a typed skill token to its hyphenated /slug form.

        Mirrors resolve_skill_command_key() in agent/skill_commands.py:
        underscores (Telegram bot-command form) are interchangeable with
        hyphens.
        r   r   r  )r   r"  r   )r1  s    r%   _normalize_skill_tokenz,SlashCommandCompleter._normalize_skill_tokenP  s7     U\\#&&..sC88>>@@@@r$   c                T    |                      |          |                                 v S r   )r3  r-  )r%  r1  s     r%   _is_skill_commandz'SlashCommandCompleter._is_skill_commandZ  s'    **511T5N5N5P5PPPr$   textc              #  p  K   	 ddl m} n# t          $ r d}Y nw xY w|                                }|                    d          r|d}}n|dd         |d         }}t                      }|D ]I}|                     |          }||                                 vs||v r dS |                    |           Jt          |          |k    rdS |
                    d          sdS |                     |          }	|                                                                 D ]\  }
}|
|v s|

                    |	          st          |                    d	d
                    }|dd         t          |          dk    rdndz   }|
|	k    r|
 dn|
}t          |t          |           |
d|           V  dS )ug  Offer skill-command completions for stacked invocations.

        After ``/skill-a `` the user may chain more leading skills
        (``/skill-a /skill-b do XYZ``). While every whitespace-delimited
        token so far resolves to a distinct skill command and the current
        word under the cursor starts with ``/``, keep offering the remaining
        skill commands. The moment the chain is broken (a non-skill token
        appears, the cap is reached, or the user is typing plain instruction
        text) we offer nothing — instruction text must never be polluted
        with skill suggestions.
        r   )_MAX_STACKED_SKILLS   r   r   Nr   r   Skill commandr  r     ⚡ start_positiondisplaydisplay_meta)r  r8  r	  r
  endswithr  r3  r-  r   r  r  r1  r   r   r   )r%  r6  _captokens	completedcurrent_wordr_  r1  r  word_keyr   r  r   
short_descreplacements                  r%   _stacked_skill_completionsz0SlashCommandCompleter._stacked_skill_completions]  s%     	HHHHHHH 	 	 	DDD	 == 	>&,b|II&,SbSk6":|I  	 	E--e44C$335555HHSMMMMt99F &&s++ 	F..|<<2244::<< 	 	ICd{{#..":":{dhh}oFFGGK$SbS)c+6F6F6K6KUUQSTJ (+hS))))CK #L 1 110J00	      	 	s    >   rr   rY   r[   r  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)r  rJ  s     r%   _completion_textz&SlashCommandCompleter._completion_text  s4     tO,===O~~~r$   r   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|v rdS |                    d          sd|v r|S dS )u  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``).

        Tokens containing a ``://`` scheme separator (e.g. URLs like
        ``https://example.com/x``) are excluded even though they contain a
        ``/`` — they are never useful local-path completions.
        NrH  r   r   z://)z./z../~/r   r   r  r  r6  irJ  s      r%   _extract_path_wordz(SlashCommandCompleter._extract_path_word  s      	4 IIM1ffaCFA 1ffaCAEFF| 	4
 D==4??344 	tKtr$      limitrN  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   ~rO  dirr=  rH  )osr>  
expanduserrA  dirnamebasenamelistdirOSErrorr   rr  r  r$  isdirrelpathisabs_file_size_labelr   r  )rJ  rU  expanded
search_dirr  r2  countprefix_lowerr  	full_pathis_dirdisplay_pathsuffixr3  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.NrH  r   r   @rP  rQ  s      r%   _extract_context_wordz+SlashCommandCompleter._extract_context_word  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=  )rp  rq  Nr:  rq  r   r  )r  r   r   r   rX  rH  )r   r  r   r  rY  r>  rZ  rA  r[  r\  r]  r^  rr  r$  r_  r`  rb  _fuzzy_file_completions)r%  rJ  rU  lowered_STATIC_REFSr  r3  r  barewant_dir	path_partrc  rd  match_prefixr2  re  rf  r  rg  rh  ri  rj  
completionquerys                           r%   _context_completionsz*SlashCommandCompleter._context_completions  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_outputr6  timeoutcwdencodingerrors
Ni  )rY  getcwdtime	monotonicr"  r$  r#  shutilwhich
subprocessr   
returncodestdoutr  r
  r>  ra  r`  r#  TimeoutExpiredr^  )
r%  r  nowfilesr   toolprocru  pr  s
             r%   _get_project_filesz(SlashCommandCompleter._get_project_filesh  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filepathrz  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.rH  r:  P   r9  r  r   r   z_-./g      ?#      )rY  r>  r\  r   r  r  )
r  rz  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filerX  rm  :r=  r   c                $    | d          | d         fS )Nr   rH  r   )xs    r%   ro  z?SlashCommandCompleter._fuzzy_file_completions.<locals>.<lambda>  s    AaD5!A$- r$   rp  z  )r  rA  rY  r>  r\  rb  r$  r  r   r  r  r#  sort)r%  rJ  rz  rU  r  fprh  r  kindr3  scoredsr   s                r%   rr  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_enginer  r  r   r  r   r	  )r  r  r  r  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).
        )rG   disableenabler   r   rH  r   r>  r?  N)r  r  r:  )load_config)CONFIGURABLE_TOOLSETS_get_platform_tools_get_plugin_toolset_keyscliF)include_default_mcp_serversr  r  r=  zplugin toolsetmcp_serversr  zMCP server '')r
  rA  r  r  r   r   r  r  r  hermes_cli.tools_configr  r  r  rr  r   r  r  r	  )r  r  SUBSr  trailing_spacepartialrx  
subcommandpartial_loweralreadyr  r  r  r  rW   enabledts_keylabel_descis_onr  serverr  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   rH  Nr   r:  r   )load_gateway_configr   u   → zsend this session herer=  )r
  rA  r  r   gateway.configr  get_connected_platformsr	  valuer  get_home_channelgetattrr   r   )r  r  r  r  r  r  r  gwr   r   r   homer3  s                r%   _handoff_completionsz*SlashCommandCompleter._handoff_completionsO  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personalitiesrf   zclear personality overlayr=  r   system_promptr   Nr  )r  r  r   r  r   r  r1  r  r  r   r	  )r  r  r  r  r   r0   r3  s          r%   _personality_completionsz.SlashCommandCompleter._personality_completionsu  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    r~|	                    d          rht          |          dk    r|d         nd}|                                }	| 
                    |          r|                     |          E d {V  d S 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 # t8          $ r Y d S w xY w)Nr   rH  maxsplitr   r   r   z/skinz/personalityz/toolsz/handoffr  r=  r   zSkill bundler  r  r~   u   ▣ z (z skills)r;  r<  r-  r  u   🔌 )text_before_cursorr  rn  r{  rS  rk  r
  r   r  rA  r5  rI  r  r  r  r  r   r)  r   r   r1  rM  r0  r   r   r-  r0  r.  r	  )r%  documentcomplete_eventr6  ctx_word	path_wordr  base_cmdr  r  rx  rJ  r   r  r  r  r   rG  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 %%h// ::4@@@@@@@@@ (""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?U. .
U<;U<)NNN)r  r  r  r  r  r  r   r  )r'  r   r   r   )r   r*  )r1  r   r   r   )r1  r   r   r   )r6  r   )r  r   rJ  r   r   r   )r6  r   r   r   )rT  )rJ  r   rU  rN  r   r  )r  r   rz  r   r   rN  )r  )rJ  r   rz  r   rU  rN  )r  r   r  r   )r   r    r!   r"   r&  r)  r-  r0  staticmethodr3  r5  rI  	frozensetrL  rM  rS  rk  rn  r{  r  r  rr  r  r  r  r  r  r   r$   r%   r  r  %  sz       TT VZ7;TX	' ' ' ' '          A A A \AQ Q Q Q6 6 6 6x !y!A!A!AB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    \@r r r r r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__  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	                            |          re| j	                            |          D ]J}|j        r|j        |j         d          n|j        }|                                rt          |          c S K| 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   rH  r  r   r   r   )r  r  r  get_suggestionr
  r   r  rA  r   r  r)  r
   r5  rI  r>  r6  r  r   )r%  bufferr  r6  r  r  rJ  r   r  r  r  ry  	remainderrx  s                 r%   r  z&SlashCommandAutoSuggest.get_suggestion  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$$	 O'11(;; ( #oHHNN 1 1
!0FJOZ-F,F,G,GHH6@o ??$$ 1%i000001 ?&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    sN          /326$ $ $ $ $6 6 6 6 6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)rY  r>  getsizer^  )r>  sizes     r%   rb  rb  W  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   r4  )r<  r=  r>  r   r   r=  )r   rB  )r   rN  )r[  r\  r   r   )r   r   )r   r4  r   r4  )ru  r   r   r   )r2  r{  r|  r   r   r{  )r:  N)r   r   r  rN  r  r   r  rN  r  r  r   r  )r:  )rG  rN  r   r  )r  rN  r  r   r   r  )r  r   r   r  )r
  )r  r   r   rB  )r   r   )r>  r   r   r   )gr"   
__future__r   loggingrY  rer  r  r  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   rG   compile_PIPE_SUBS_REr  r   r   mgroupr
  r  r   r   r   r   r  r  r  r*  r   r8  rM  rS  rT  rc  rA  rX  rZ  ra  rf  rs  r  _TG_NAME_LIMITrw  ry  r6  r  _clamp_telegram_namesr  r  r  r  r  r  r  r  r  r  r  r	  r  r  r  r  rb  r   r$   r%   <module>r     s     # " " " " "  				 				       - - - - - - - - ! ! ! ! ! !       ! ! ! ! ! !		8	$	$CCCCCCCC?????????   KIJJJJ	 $+ + + + + + + +$&JwJI " " "& JuH)!X7 7 7	& JwF	 ,CE E E& Jw>	  & JxQS\  & Jy5y  & Jv6	  &  JwBINN!&" JxWYb(8,P P P#&& JvG     '&* Jw=y!# # #+&. Jycen%6 6 6/&2 JxPR[ H6 6 63&6 Jz  F  HQ#/_a a a7&: JzCY#% % %;&> JzUW`i;XZ Z Z?&B Jv>	JJC&D Jy? ,>@ @ @E&H JvTV_ ,<> > >I&L J|=y$
< < <M&P Jx?!# # #Q&T Jy>">757 7 7U&\ JwNPY5 5 5]&` JwXZc#% % %a&d JvXZcoq q qe&h Julnw#% % %i&l JyKY46 6 6m&p JxGSSq&r JxH&QQs&t JyGPPu&v Jy=y -9 9 9w&z Jx<i!# # #{&B Jz@)LLC&H Jx5  I&L Jw<oUW W WM&P J Y(:24 4 4Q&X J}<o!# # #Y&\ J{A?g/ / /]&` J|QSb(92GE E Ea&f Jy\#BD D Dg&l JxR*;24 4 4m&r JvP   s&v J{A?7~@ @ @w&| Jvln}/DF F F}&B Jv>2 2 2C&F J{?(GCE E EG&L Jw+_.<Z\ \ \M&P JvH/(HDF F FQ&Z JwNP`:TK K K[&^ Jz46F  _&b JxE$#:PQ Q Qc&l JxRHGI I Im&t JyT! !u&x JuVXh(HVxz z zy&| JwF$8IUdf f f}&@ Jwj+AC C CA&D Jv/1A`b b bE&J J}MA_DF F FK&P J{L<UW W WQ&T Jyc>km m mU&Z JxU>RS S S[&j JxIK[  k&n J|=?O&( ( (o&r J a);= = =s&v Jy^`p(E>@ @ @w&| JyC$0 0 0}&D JzG H6 6 6E&H Jv0&99I&J JyUW` " " "K&N JwRTZ[[O&P Jy?HHQ&R Jy]_e  S&V Jz>!# # #W&Z J{Dfl4 4 4[&^ JzNPV ,HJ J J_&b JvF
4 4 4c&f JwDf  g&j JwH&2 2 2k&n JxDfMMo&p Jy5vvNNNq&r JwZ\b') ) )s&z JvSU[i<I I I{&     L    *?)>)@)@ @ @ @ @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.   :     - - - -
   &   @   L ') #!$ ;;;  :5 5 5 5% % % %P@ @ @ @
   1 1 1 1   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#I#IJJ 	$ 	$ 	$ 	$N N N Nb5 5 5 5 56   8c c c c cI c c cTE E E E Ek E E EP1 1 1 1 1 1s   A A.-A.