`gjg UdZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z ddlmZddlmZej$eZ ddlmZmZdd lmZmZe d Gd d Zgedddd edddddedddd dedddd edddd ed d!dd ed"d#dd ed$d%ded&d'dd d(d)*ed+d,dd-.ed/d0dd.ed1d2dd3d 4ed5d6dd7ded8d9dd:d;ed.ed?d@dd dAdBCedDdEdedFdGdd dHedIdJdd dKedLdMddNdOedPdQddRSedTdUddVd dWdXYedZd[dd\dOed]d^ddO.ed_d`dda.edbdcddO.edddeddf.edgdhdedidjdkedldmdkedndodd dpqedrdsdd.edtdudedvdwdxd edydzdxd{.ed|d}dxd~dedddxd.edddxd dedddxd dddedddxd dedddxddedddxedddxddedddxddedddxd dedddxd ddedddxddedddxd ddeddddd 4edddd edddd ddedddddedddedddd ddedddd ddŬCeddddȬ.edddd dd̬eddddddѬҫeddddd֬eddddd٬edddddܬedddd eddddSeddddSedddd dd謤edddd edddkd dedddkedddd edddkd.edddkd dedddkedddkd.edddkd dedddkd dedddkd d>edddkd edddkd d ed d dked d dkdSedddkd.edddd ddCZded<dWdZ e Z!ded<dXdZ"dYdZ#iZ$ded<eD]^Z%e%jLre#e%e$d e%jN<e%jPD]'Z)e%jTd!e%jNd"e$d e)<)`iZ+d#ed$<eD]pZ%e%jLre+jYe%jZiZ.e$d e%jNe.d e%jN<e%jPD]Z)e$d e)e.d e)<riZ/d%ed&<eD]2Z%e%j`se1e%j`e/d e%jN<4ejdd'Z3eD]eZ%d e%jNZ4e4e/vs e%jjs$e3jme%jjZ7e7sBe7jqdjsd(e/e4<ge:d)eDZ;d*ed+<dZd,Z<e:hd-Z=d*ed.<d[d/Z>d\d0Z?d]d^d1Z@d_d2ZAd`d3ZBdad4ZCdbd5ZDd6ZEd7ZFhd8ZGd9ZH dcd:ZIddd;ZJded<ZKdfd=ZLdgd>ZM dhd?ZNd@ZO eOZPejddAZQejddBZRdidCZS djdDZTeTZU dk dldEZVdmdndFZW dodGZX dpdHZYdIZZd@Z[ejddJZ\e:hdKZ]dLZ^e:hdMZ_didNZ`dadOZadqdrdPZbdsdQZcGdRdSeZdGdTdUeZedtdVZfy#e$r eZeZdZdZYzwxYw(uaSlash command definitions and autocomplete for the Hermes CLI. Central registry for all slash commands. Every consumer -- CLI help, gateway dispatch, Telegram BotCommands, Slack subcommand mapping, autocomplete -- derives its data from ``COMMAND_REGISTRY``. To add a command: add a ``CommandDef`` entry to ``COMMAND_REGISTRY``. To add an alias: set ``aliases=("short",)`` on the existing ``CommandDef``. ) annotationsN)CallableMapping) dataclass)Any)is_truthy_value) AutoSuggest Suggestion) Completer CompletionT)frozenceZdZUdZded<ded<ded<dZded<d Zded <dZded <d Zd ed<d Z d ed<dZ ded<y) CommandDefz%Definition of a single slash command.strname descriptioncategorytuple[str, ...]aliases args_hint subcommandsFboolcli_only gateway_onlyN str | Nonegateway_config_gate) __name__ __module__ __qualname____doc____annotations__rrrrrrrF/root/.hermes/venv/lib/python3.12/site-packages/hermes_cli/commands.pyrr-sR/ IM!G_!Is#%K%HdL$&**r$rstartz0Acknowledge platform start pings without a replySession)rnewz0Start a new session (fresh session ID + history))resetz[name])rrtopicz,Enable or inspect Telegram DM topic sessionsz[off|help|session-id])rrclearz$Clear screen and start a new session)rredrawz6Force a full UI repaint (recovers from terminal drift)historyzShow conversation historysavezSave the current conversationretryz(Retry the last message (resend to agent)promptz)rrbranchz5Branch the current session (explore a different path))forkcompresszhCompress 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)snapzreate|restore |prune])rrrstopz%Kill all running background processesapprovez#Approve a pending dangerous commandz[session|always]denyz;Deny a pending dangerous command (optionally with a reason)z[all] [reason] backgroundzRun a prompt in the background)bgbtwzagentsz$Show active agents and running tasks)tasks)rjourneyz"Open the learning journey timeline)learningz memory-graphz[list|delete |edit ])listdeleteedit)rrrrqueuez4Queue a prompt for the next turn (doesn't interrupt))qsteerz>Inject a message after the next tool call without interruptinggoalz?Set a standing goal Hermes works on across turns until achievedzT[text | draft | show | pause | resume | clear | status | wait | unwait]moazTRun one prompt through the default Mixture of Agents preset, then restore your modelsubgoalz/Add or manage extra criteria on the active goalz[text | remove N | clear]statusz,Show session, model, token, and context infowhoamiz-Show your slash command access (admin / user)Infoprofilez+Show active profile name and home directorysethomez!Set this chat as the home channel)zset-home)rrresumez!Resume a previously-named sessionsessionsz#Browse and resume previous sessionsconfigzShow current configuration Configurationmodelz2Switch model (session-scoped; --global to persist)z:[model] [--provider name] [--global|--session] [--refresh]z codex-runtimez7Toggle codex app-server runtime for OpenAI/Codex models) codex_runtimez[auto|codex_app_server] personalityzSet a predefined personality statusbarz#Toggle the context/model status bar)sb)rr timestampsz2Toggle [HH:MM] timestamps on messages and /historyz[on|off|status])onoffrP)ts)rrrrverbosez@Cycle tool progress display: off -> new -> all -> verbose -> logzdisplay.tool_progress_command)rrfooterz7Toggle gateway runtime-metadata footer on final replies)rryoloz7Toggle YOLO mode (skip all dangerous command approvals) reasoningz#Manage reasoning effort and displayz'[level|show|hide|full|clamp] [--global])noneminimallowmediumhighxhighmaxultrashowhider_r`fullclamp--globalfastuSToggle fast mode — OpenAI Priority Processing / Anthropic Fast Mode (Normal/Fast)z[normal|fast|status] [--global])normalrsrPr_r`rrskinz%Show or change the display skin/theme)rr indicatorz!Pick the TUI busy-indicator stylez[kaomoji|emoji|unicode|ascii])kaomojiemojiunicodeascii)rrrvoicezToggle voice modez[on|off|tts|status])r_r`ttsrPbusyz/Control what Enter does while Hermes is workingz[queue|steer|interrupt|status])rJrL interruptrPtoolsz4Manage tools: /tools [list|disable|enable] [name...]zTools & Skillsz[list|disable|enable] [name...]toolsetszList available toolsetsskillsz*Search, install, inspect, or manage skillszskills.write_approval) searchbrowseinspectinstallauditpendingr>rejectdiffapproval)rrrmemoryz7Review pending memory writes / toggle the approval gatez-[pending|approve|reject|approval] [id|on|off])rr>rrbundlesz8List skill bundles (aliases / for multiple skills)petz>Toggle or adopt a petdex mascot (/pet, /pet list, /pet )z[toggle|list|scale |])togglerGscaler`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)zcronzManage scheduled tasksz [subcommand])rGaddcreaterIpauserUrunremove suggestionsz-Review suggested automations (accept/dismiss))suggestz[accept|dismiss N | catalog])acceptdismisscatalogr+)rrr blueprintz.Set up an automation from a blueprint template)bpz[name] [slot=value ...]curatorzGBackground skill maintenance (status, run, pin, archive, list-archived))rPrrrUpinunpinrestorez list-archivedkanbanz:Multi-profile collaboration board (tasks, links, comments))!initboardsrrGlsrnassignreclaimreassign diagnosticsdiaglinkunlinkclaimcommentcompleterIblockunblockarchivetaildispatchstatsznotify-subscribez notify-listznotify-unsubscribelogruns heartbeat assigneescontextspecifygcreloadz.Reload .env variables into the running sessionz reload-mcpzReload MCP servers from config) reload_mcpz reload-skillsz?Re-scan ~/.hermes/skills/ for newly installed or removed skills) reload_skillsbrowserzBConnect browser tools to your live Chromium-family browser via CDPzonnect|disconnect|status])connect disconnectrPpluginsz'List installed plugins and their statuscommandsz*Browse all commands and skills (paginated)z[page]helpzShow available commandsrestartz9Gracefully restart the gateway after draining active runsusagezLShow token usage and rate limits; `reset` redeems a banked Codex limit resetz[reset [--force]] subscriptionz0View your Nous plan and change it in the browser)upgradetopupz7Show your Nous balance and manage billing on the portalinsightsz!Show usage insights and analyticsz[days] platformsz&Show gateway/messaging platform status)gatewayplatformz1Pause, resume, or list a failing gateway platformz [name]copyz-Copy the last assistant response to clipboardpastez*Attach clipboard image from your clipboardimagez.Attach a local image file for your next promptzupdatez)Update Hermes Agent to the latest versionversionzShow Hermes Agent version)vdebugz@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]zlist[CommandDef]COMMAND_REGISTRYdict[str, CommandDef]cji}tD]'}|||j<|jD]}|||< )|S)z+Map every name and alias to its CommandDef.)rrr)lookupcmdaliass r%_build_command_lookuprsG$&F sxx[[ EF5M   Mr$_COMMAND_LOOKUPcftj|jjdS)zmResolve a command name or alias to its CommandDef. Accepts names with or without the leading slash. /)rgetlowerlstrip)rs r%resolve_commandrs&   tzz|2237 88r$c|jr)|jd|jd|jdS|jS)z;Build a CLI-facing description string including usage hint.z (usage: / ))rrr)rs r%_build_descriptionrs9 }}//"*SXXJa aHH ??r$dict[str, str]COMMANDSrz (alias for /rzdict[str, dict[str, str]]COMMANDS_BY_CATEGORYzdict[str, list[str]] SUBCOMMANDSz[a-z]+(?:\|[a-z]+)+|c#K|]=}|jr |jr#|jg|jD]}|?ywN)rrrr).0rrs r% rPsL3 <<322(CKK( 3  33sAAzfrozenset[str]GATEWAY_KNOWN_COMMANDScP|sy|tvrytD] \}}}||k(s yy)uReturn True if ``name`` resolves to a gateway-dispatchable slash command. This covers both built-in commands (``GATEWAY_KNOWN_COMMANDS`` derived from ``COMMAND_REGISTRY``) and plugin-registered commands, which are looked up lazily so importing this module never forces plugin discovery. Gateway code uses this to decide whether to emit ``command:`` hooks — plugin commands get the same lifecycle events as built-ins. FT)r_iter_plugin_command_entries)r plugin_name _description _args_hints r%is_gateway_known_commandrXs?  %%1M1O- \: $  r$>r(r?rr=rJrLrCrPrr>rSrrrr@ACTIVE_SESSION_BYPASS_COMMANDSc$|r t|duSdS)uReturn True for any resolvable slash command. Rationale: every gateway-registered slash command either has a specific Level-2 handler in gateway/run.py (/stop, /new, /model, /approve, etc.) or reaches the running-agent catch-all that returns a "busy — wait or /stop first" response. In both paths the command is dispatched, not queued. Queueing is always wrong for a recognized slash command because the safety net in gateway.run discards any command text that reaches the pending queue — which meant a mid-run /model (or /reasoning, /voice, /insights, /title, /resume, /retry, /undo, /compress, /usage, /reload-mcp, /sethome, /reset) would silently interrupt the agent AND get discarded, producing a zero-char response. See issue #5057 / PRs #6252, #10370, #4665. ACTIVE_SESSION_BYPASS_COMMANDS remains the subset of commands with explicit Level-2 handlers; the rest fall through to the catch-all. NF)r) command_names r%should_bypass_active_sessionrs(9E?< ( 4O%Or$ctDcgc]}|js|}}|s tS ddlm}|}t}|D]r}|}|jj dD]'}t|tr|j|}%d}nt|dsX|j|jt|Scc}w#t $r tcYSwxYw)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. rread_raw_config.NF)default) rrsethermes_cli.configr Exceptionsplit isinstancedictrrrr)cgatedrcfgresultrvalkeys r%_resolve_config_gatesrs) B1A,A,AQ BE B u 5uF !**005 C#t$ggcl   3 . JJsxx  ! M' C u sB>B> CCCcn|jsy|jr||n t}|j|vSy)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. TF)rrrr)rconfig_overrides overridess r%_is_gateway_availablers: << (8(D$J_Ja xx9$$ r$c@|jjdS)zFReturn True when selecting a command without text would be incomplete.<)strip startswithr3s r%_requires_argumentrs ??  ' ' ,,r$c t}g}tD]}t||s|jrd|jnd}g}|jD]V}|j dd|j j ddk(r||j k7rB|jd|dX|rddj|d nd}|jd|j |d |j||S) z3Generate gateway help text lines from the registry.rr-_z`/`z (alias: z, rz` -- ) rrrrrreplacerappendjoinr)rlinesrargs alias_partsa alias_notes r%gateway_help_linesr's%'IE N$S)4 &)mm3==/"!#  *Ayyc"chh&6&6sC&@@Q#((]   A3ay )  * ?Jy;!7 8:r  r#((D6s.? |LM N Lr$c ddlm} |xsi}g}|jD]\}}t |t rt |t s't |jdxsd|}t |jdxsdj}|j|||f|S#t$rgcYSwxYw#t$rgcYSwxYw)amYield (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). rget_plugin_commandsrRun /rr) hermes_cli.pluginsr*ritemsr rr rrr )r*rentriesrmetarrs r%rrs:&(.B+-Gnn&7 d$$JtT,B $((=1CuTF^D -34::< k956 7 N    s"B2 C2 C?C CCc8t}g}tD]D}t||st|j}|s(|j ||j fFtD]3\}}}t|rt|}|s!|j ||f5|S)acReturn (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. ) rrr_sanitize_telegram_namerr rrr)rrrtg_namerrrs r%telegram_bot_commandsr3s&'I$&F6$S)4 *#((3  MM7COO4 56)E(F2$k9 i ( )$/  MM7K0 1 2 Mr$<d>r prependr)rr(r=rPrUrVrYrrrrbrr>r?rJrLr@rerrrrSrQc|}|D]'}t|tsicS|j|})t|tr|SiSr)r rr)rootpathnoders r%_nested_mappingr;PsHD$(Ixx}dG,44"4r$c  ddlm}|xsi}t|tsi}t t |dddd}|jdt} t|}tdtt|}t|jd xsd j!j#}|t$vrd }|jd }t|t&r3|Dcgc]'}t|j!st|)}}ng}|||d S#t$ri}YwxYw#ttf$r t}YwxYwcc}w) zReturn normalized Telegram command-menu config with safe defaults. Canonical user-facing path: ``platforms.telegram.extra.command_menu``. rrrtelegramextra command_menu max_commands priority_moder6priority)r@rBrC)rrrr rr r;r#_DEFAULT_TELEGRAM_MENU_MAX_COMMANDSint TypeError ValueErrorrlmin_TELEGRAM_BOT_API_MAX_COMMANDSrrr_TELEGRAM_PRIORITY_MODESrG)rraw_cfgmenu_cfgr@rB raw_priorityitemrCs r%_telegram_command_menu_configrOYs8 5!#)r gw 'OG[*g~^_H<<0STL;<( q# ??r$cg}t}|D]@}tt|}|s||vs|j||j |Bt |Sr)rr1rrr tuple) raw_namesrseenraw_namers r%_dedupe_sanitized_namesrWsXFUD &s8}5 D$ HHTN MM$   =r$ct}tt|d}ttt}|ddk(r |}t|S|ddk(r||z}t|S||z}t|S)NrCrBrr )rOrGrW_TELEGRAM_MENU_PRIORITY)rL configureddefaultsrMs r%_telegram_effective_priorityr\s,.H-hz.BCDJ+,CDEH I-! #< 00 / "h .*,  #< 00"H, "< 00r$cttDcic]\}}|| c}}tt|fdDcgc]\}}| c}}Scc}}wcc}}w)NcH|ddvrd|dd|dfSd|dfS)NrArr)rNrCs r%z4_prioritize_telegram_menu_commands..sN AwqzX% a$QQ r$r) enumerater\sorted)rindexr_indexcommandrCs @r%"_prioritize_telegram_menu_commandsrfsk %%A%CD E4 e H & h     FG    s A A z [^a-z0-9_]z_{2,}c|jjdd}tjd|}tjd|}|j dS)uRConvert a command/skill/plugin name to a valid Telegram command name. Telegram requires: 1-32 chars, lowercase a-z, digits 0-9, underscores only. Steps: lowercase → replace hyphens with underscores → strip all other invalid characters → collapse consecutive underscores → strip leading/ trailing underscores. rrr)rr_TG_INVALID_CHARSsub_TG_MULTI_UNDERSCORErrawrs r%r1r1sN 99;  sC (D  T *D  # #C .D ::c?r$c$t|}g}|D]}}|^}}}t|tkDr8|dt}||vr)|dtdz } tdD]} | | }||vsnP|}||vrW|j ||j ||g||S)aEnforce 32-char command name limit with collision avoidance. Both Telegram and Discord cap slash command names at 32 characters. Names exceeding the limit are truncated. If truncation creates a duplicate (against *reserved* names or earlier entries in the same batch), the name is shortened to 31 chars and a digit ``0``-``9`` is appended to differentiate. If all 10 digit slots are taken the entry is silently dropped. Accepts tuples of any length >= 2. Extra elements beyond ``(name, desc)`` (e.g. ``cmd_key``) are passed through unchanged, so callers can attach metadata that survives the rename. NrA )rlen_CMD_NAME_LIMITrangerr ) r.reservedusedrentryrdescr> candidateprefixdigits r%_clamp_command_namesrzs ]DF,"dU t9 &-o.ID 223"2YE#)(5' 2I , D 4<   tT*E*+#,$ Mr$cg}g} ddlm}|}t|D]R} |r|| n| } | s|| jdd} t | |kDr | d|dz dz} |j | | fT t||}|jd|D|D]\} } |j | | d ft} dd l m }|| }g} dd l m }dd lm}ddl m}t#|j%}t#|dz j%j'ddz}|j'ddzg}|j)d|D|}t|D]}||}|jdd st+fd|Ds2j-|rD|jdd }||vr[|j/d}|r||n|} | s{|jdd } t | |kDr | d|dz dz} |j | | |f t||}t1d|t |z }t1dt ||z }|d|D]\} } }|j | | |f|d||fS#t $rY*wxYw#t $rYwxYw#t $rYwxYw)aCollect plugin + skill entries for a gateway platform. Priority order: 1. Plugin slash commands (take precedence over skills) 2. Built-in skill commands (fill remaining slots, alphabetical) Only skills are trimmed when the cap is reached. Hub-installed skills are excluded. Per-platform disabled skills are excluded. Args: platform: Platform identifier for per-platform skill filtering (``"telegram"``, ``"discord"``, etc.). max_slots: Maximum number of entries to return (remaining slots after built-in/core commands). reserved_names: Names already taken by built-in commands. Mutated in-place as new names are added. desc_limit: Max description length (40 for Telegram, 100 for Discord). sanitize_name: Optional name transform applied before clamping, e.g. :func:`_sanitize_telegram_name` for Telegram. May return an empty string to signal "skip this entry". Returns: ``(entries, hidden_count)`` where *entries* is a list of ``(name, description, cmd_key)`` triples and *hidden_count* is the number of skill entries dropped due to the cap. ``cmd_key`` is the original ``/skill-name`` key from :func:`get_skill_commands`. rr)rPlugin commandN...c3&K|] \}}| ywrr)rnrs r%rz1_collect_gateway_skill_entries..8s51!5srget_disabled_skill_namesrget_skill_commands SKILLS_DIRget_external_skills_dirs.hubrc3VK|]!}t|jddz#yw)rN)rrstrip)rds r%rz1_collect_gateway_skill_entries..Ss'! )*CFMM#  $! s') skill_md_pathc3@K|]}j|ywr)r)rrx skill_paths r%rz1_collect_gateway_skill_entries..\sUz,,V4Usr)r,r*rbrrpr rrzrragent.skill_utilsragent.skill_commandsrtools.skills_toolrrrresolverextendanyrrrl) r max_slotsreserved_names desc_limit sanitize_name all_entries plugin_pairsr* plugin_cmdscmd_namerrvrr_platform_disabledr skill_triplesrrr _skills_dir_hub_dir_allowed_prefixes skill_cmdscmd_keyinfo skill_namerV remaining hidden_countkrs @r%_collect_gateway_skill_entriesrs%F/1K+-L  :)+ {+ .H.;=*Dx(,,]5xH13M& ;0>*,,./  V+4467>>sCcI)//4s:;  ! .F.H!  () j) 8Gg&D/26JUCTUU$$X.&"-J//~~c*H.;=*D88M2.D4y:%OZ!^,u4  $g!6 7' 82)GMAy3{#334Iq#m,y89L ),&1aAq!9%& z "L 00I        R    s7A-JJ#EJ3 J J # J0/J03 J?>J?cVttt}|Dchc]\}}| }}}t|}tdt ||z }td|t |z }t d||dt \}} |jd|D|d|| |zfScc}}w)uReturn Telegram menu commands capped to the Bot API limit. Priority order (higher priority = never bumped by overflow): 1. Core CommandDef commands (always included) 2. Plugin slash commands (take precedence over skills) 3. Built-in skill commands (fill remaining slots, alphabetical) Skills are the only tier that gets trimmed when the cap is hit. User-installed hub skills are excluded — accessible via /skills. Skills disabled for the ``"telegram"`` platform (via ``hermes skills config``) are excluded from the menu entirely. Returns: (menu_commands, hidden_count) where hidden_count is the number of commands omitted due to the cap. rr=()rrrrrc3,K|] \}}}||fywrr)rrr_ks r%rz)telegram_menu_commands..s781aA7sN)rfrGr3rlrprr1r) r@ core_commandsrrr all_commandshidden_core_countremaining_slotsr.rs r%telegram_menu_commandsrs"7tO:!%- G\7w77   & 7H(H HH3s B%c2td|t|dS)u Return skill entries for Discord slash command registration. Same priority and filtering logic as :func:`telegram_menu_commands` (plugins > skills, hub excluded, per-platform disabled excluded), but adapted for Discord's constraints: - Hyphens are allowed in names (no ``-`` → ``_`` sanitization) - Descriptions capped at 100 chars (Discord's per-field max) Args: max_slots: Available command slots (100 minus existing built-in count). reserved_names: Names of already-registered built-in commands. Returns: ``(entries, hidden_count)`` where *entries* is a list of ``(discord_name, description, cmd_key)`` triples. ``cmd_key`` is the original ``/skill-name`` key needed for the slash handler callback. discordr5)rrrr)rr)rrs r%discord_skill_commandsrs", *>*  r$cBddlm}t} ddlm}|d}i}g}t j|d}d} ddlm }ddlm } dd l m } | j} | d z j} | g} | D](} | j||j* |}t|D]}||}|j!d d }|s||j}t#|j%t#| rXd }| D]} |j'||}n|y|j!dd }||vr|j+d}|d d}||vrB||}|dk(rt,j/d|||nt,j/d|||||dz }|||<|j!dd }t1|dkDr|d ddz}|j2j'|}|j4}t1|dk\r+|d}|j7|gj|||fy|j|||f |||fS#t $rY=wxYw#t $rYwxYw#t $rYwxYw#t($rYvwxYw#t $rYPwxYw)u'Return skill entries organized by category for Discord ``/skill`` autocomplete. Skills whose directory is nested at least 2 levels under a scan root (e.g. ``creative/ascii-art/SKILL.md``) are grouped by their top-level category. Root-level skills (e.g. ``dogfood/SKILL.md``) are returned as *uncategorized*. Scan roots include the local ``SKILLS_DIR`` **and** any configured ``skills.external_dirs`` — matching the widened filter applied to the flat ``discord_skill_commands()`` collector in #18741. Without this parity, external-dir skills are visible via ``hermes skills list`` and the agent's ``/skill-name`` dispatch but silently absent from Discord's ``/skill`` autocomplete. Filtering mirrors :func:`discord_skill_commands`: hub skills excluded, per-platform disabled excluded, names clamped to 32 chars, descriptions clamped to 100 chars. The legacy 25-group × 25-subcommand caps (from the old nested ``/skill `` layout) are **not** applied — the live caller (``_register_skill_group`` in ``gateway/platforms/discord.py``, refactored in PR #11580) flattens these results and feeds them into a single autocomplete callback, which scales to thousands of entries without any per-command payload concerns. ``hidden_count`` is retained in the return tuple for backward compatibility and still reports skills dropped for other reasons (32-char clamp collision vs a reserved name). Returns: ``(categories, uncategorized, hidden_count)`` - *categories*: ``{category_name: [(name, description, cmd_key), ...]}`` - *uncategorized*: ``[(name, description, cmd_key), ...]`` - *hidden_count*: skills dropped due to name clamp collisions against already-registered command names. r)Pathrrrz rrrrrrNrrrguDiscord /skill: %r (from %r) collides on its 32-char clamp with a reserved gateway command name %r — the skill will not appear in the /skill autocomplete. Rename the skill's frontmatter ``name:`` to differ in its first 32 chars.uDiscord /skill: %r and %r both clamp to %r on Discord's 32-char command-name limit — only %r will appear in the /skill autocomplete. Rename one skill's frontmatter ``name:`` to differ in its first 32 chars.rArr5ar~)pathlibrrrrrr fromkeysrrrrrrr rbrrr relative_torGrloggerwarningrpparentparts setdefault)r_Prr categories uncategorized _names_usedhiddenrrrrr _scan_rootsextrrrrsp matched_rootr8rrV discord_namepriorrvrelrcats r%"discord_skill_commands_by_categoryrsL##&5 >5yI 9;J02M #'-- "MK Fd ;>0 ((* '002"-  /1 &&r#w'89 () j)M DGg&D/26JJ'')B2w!!#h-0'+L# NN4( $   #&"-J//~~c*H#CR=L{*$L1L(NN1 %g| NN. w e ! (/K %88M2.D4y3CRy5())'' 5CIIE5zQAh%%c2.55|T76ST$$lD'%BC[M Db }f ,,i    :!   ("|    sI8J7 I2%I"'I2)A2JJ-DJ II" I/+I2.I//I22 I?;J>I??J J JJJ JJ2z [^a-z0-9_\-]>medndmsgprowhoawayfeedr!muteopenleaveshrugr*expandremindrrPcollapse shortcuts)rBrA>rNrrc|j}tjd|}|jd}|dtS)zConvert a command name to a valid Slack slash command name. Slack allows lowercase a-z, digits, hyphens, and underscores. Max 32 chars. Uppercase is lowercased; invalid chars are stripped. rz-_N)r_SLACK_INVALID_CHARSrjr_SLACK_NAME_LIMITrls r%_sanitize_slack_namers> 99;D  # #B -D ::d D "" ##r$c  t}gt jd jdd fd }tDcic]"}t ||r|j D]}||$}}}tD]H}|j|}|||d|jd|j|jxsdJtD];}t ||s||j|j|jxsd=tD]R}t ||s|j D]4}||d|jd|j|jxsd6TtD]\}}}||||xsdScc}}w)aReturn (slash_name, description, usage_hint) triples for Slack. Every gateway-available command in ``COMMAND_REGISTRY`` is surfaced as a standalone Slack slash command (e.g. ``/btw``, ``/stop``, ``/model``), matching Discord's and Telegram's model where every command is a first-class slash and not a ``/hermes `` subcommand. Both canonical names and aliases are included so users can type any documented form (e.g. ``/background``, ``/bg``, and ``/btw`` all work). Plugin-registered slash commands are included too. Commands whose sanitized name collides with a Slack built-in (e.g. ``/status``, ``/me``, ``/join``) are silently skipped. Users can still reach them via ``/hermes ``. Results are clamped to Slack's 50-command limit with duplicate-name avoidance. ``/hermes`` is always reserved as the first entry so the legacy ``/hermes `` form keeps working for anything that gets dropped by the clamp or for free-form questions. )hermesz"Talk to Hermes or run a subcommandz[subcommand] [args]rct|}|r|vry|tvry|tvryttk\ryj ||dd|ddfj |y)Nr5)r_SLACK_RESERVED_COMMANDS_SLACK_VIA_HERMES_ONLYrp_SLACK_MAX_SLASH_COMMANDSr r)rrvhint slack_namer.rUs r%_addz"slack_native_slashes.._addsm)$/ Z4/  1 1  / /  w<4 4  D#JTc ;< r$z Alias for /u — r)rrrvrrrreturnNone) rrr rrrr_SLACK_PRIORITY_ALIASESrrrrr) rrrr _alias_to_cmdrrrr.rUs @@r%slack_native_slashesrs*&'I*,GUD NNZ[HHX *$  i 0[[   s  M )]& ? +chhZuS__4EF H[Y[ \]  =$S)4  SXXs (;<=  ]$S)4 [[ ]E +chhZuS__4EF H[Y[ \ ]])E(F1$k9 T; R01 N=s 'Fcg}tD]/\}}}d||xsd|d|d}|r||d<|j|1dd|iiS)uGenerate a Slack app manifest with all gateway commands as slashes. ``request_url`` is required by Slack's manifest schema for every slash command, but in Socket Mode (which we use) Slack ignores it and routes the command event through the WebSocket. A placeholder URL is fine. The returned dict is the ``features.slash_commands`` portion only — callers compose it into a full manifest (or merge into an existing one). Keeping it narrow avoids coupling us to the rest of the manifest schema (display_information, oauth_config, settings, etc.) which users set up once in the Slack UI and rarely change. rr+F)rer should_escapeurl usage_hintfeaturesslash_commands)rr ) request_urlslashesrrvrrus r%slack_app_manifestrstG13 dE4&z1U4&>"   "'E, u  )73 44r$ct}i}tD]D}t||sd|j||j<|jD] }d|||< Ft D]\}}}||vs d|||<|S)a0Return subcommand -> /command mapping for Slack /hermes handler. Maps both canonical names and aliases so /hermes bg do stuff works the same as /hermes background do stuff. Plugin-registered slash commands are included so ``/hermes `` routes through the plugin handler. r)rrrrrr)rmappingrrrrrs r%slack_subcommand_mapr s&'I G)$S)4 zN[[ )E [GEN ) ) +G*H'&lJ w vJGDM' Nr$cBeZdZdZ d ddZddZddZddZeddZ ddZ dd Z e hd Z edd Zed d Zed!d"d Zed dZd!d"dZd#dZed$dZd%d&dZed'dZed'dZed'dZed'dZdZy)(SlashCommandCompleterzJAutocomplete for built-in slash commands, subcommands, and skill commands.NcX||_||_||_g|_d|_d|_y)Ngr)_skill_commands_provider_command_filter_skill_bundles_provider _file_cache_file_cache_time_file_cache_cwd)selfskill_commands_providercommand_filterskill_bundles_providers r%__init__zSlashCommandCompleter.__init__)s5 )@%-'=$&('*$&r$cp|jy t|j|S#t$rYywxYw)NT)rrr)r  slash_commands r%_command_allowedz&SlashCommandCompleter._command_allowed7s>    ' ,,];< <  s ) 55cj|jiS |jxsiS#t$ricYSwxYwr)rrr s r%_iter_skill_commandsz*SlashCommandCompleter._iter_skill_commands?s@  ( ( 0I 0028b 8 I  $ 22cj|jiS |jxsiS#t$ricYSwxYwr)rrrs r%_iter_skill_bundlesz)SlashCommandCompleter._iter_skill_bundlesGs@  ' ' /I //17R 7 I rcfd|jdjddjzS)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. rrr)rrr)tokens r%_normalize_skill_tokenz,SlashCommandCompleter._normalize_skill_tokenQs.U\\#&..sC8>>@@@r$cD|j||jvSr)rr)r rs r%_is_skill_commandz'SlashCommandCompleter._is_skill_command[s!**51T5N5N5PPPr$c#K ddlm}|j}|j dr|d}}n |dd|d}}t }|D]<}|j |}||jvs||vry|j|>t||k\ry|jdsy|j |} |jjD]x\} } | |vs| j| st| jd d } | dd t| d kDrd ndz} | | k(r| dn| }t|t| | d | zy#t$rd}YUwxYww)ugOffer 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_SKILLSrrNrr Skill commandrr~⚡ start_positiondisplay display_meta)rrrrendswithrrrrrprr-rrr )r text_captokens completed current_wordrUrrword_keyrrr short_desc replacements r%_stacked_skill_completionsz0SlashCommandCompleter._stacked_skill_completions^s  H == &,b|I&,Sbk6":|I E--e4C$3355 HHSM   t9  &&s+ ..|<224::< ICd{#..":dhh}oFGK$Sb)c+6F6KUQSTJ(+hSE)CK #L 11#J<0   5 D s(E#EEE# E E#E  E#>rurYr[cB||k7r|S|tjvr|S|dS)uReturn 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)rwords r%_completion_textz&SlashCommandCompleter._completion_texts1 t O ,== =O1~r$c|syt|dz }|dk\r||dk7r|dz}|dk\r ||dk7r||dzd}|syd|vry|jdsd|vr|Sy)uExtract 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. NrArrz://)z./z../~/rrrprr(ir3s r%_extract_path_wordz(SlashCommandCompleter._extract_path_words IM1faC FA1faCAEF| D= ??3 4t Kr$c#Ktjj|}|jdr|}d}nBtjj |xsd}tjj |} tj |}d}|j}t|D]=}|r |jj|s&||k\rytjj||} tjj| } |jdrAdtjj| tjjdz} nAtjj|r| } ntjj| } | r| dz } | rdnd} | rdn t| } t!| t#| || z| |d z }@y#t$rYywxYww) z8Yield Completion objects for file paths matching *word*.rrrNr~r6dirr#rA)osr9 expanduserr'dirnamebasenamelistdirOSErrorrrbrr!isdirrelpathisabs_file_size_labelr rp)r3limitexpanded search_dirrxr.count prefix_lowerru full_pathis_dir display_pathsuffixr/s r%_path_completionsz'SlashCommandCompleter._path_completionss77%%d+   S !!JF29cJWW%%h/F jj,G||~ G_ Eekkm66|D~ Z7IWW]]9-Fs##bggooiASASTWAX&YY t$(  "wwy9 # "SF"5(8(CD #D z!   QJE=     s+A8G>;G/EG>/ G;8G>:G;;G>c|syt|dz }|dk\r||dk7r|dz}|dk\r ||dk7r||dzd}|jdsy|S)z=Extract a bare ``@`` token for context reference completions.NrArr@r7r8s r%_extract_context_wordz+SlashCommandCompleter._extract_context_wordsg IM1faC FA1faCAEF|s# r$c#K|j}d}|D]T\}}|jj|s&|j|k7s:t|t| ||VdD]}|dd}||k(s|j|s |dk(} ||k(rdn |t|d} tj j | } | r| dk(rd \} } nX| jd r| d} } nBtj j| xsd} tj j| } t j| }d }| j}t|D]}| r |jj|s%tj j| |}tj j|}| |k7rj||k\rytj j|}|rd nd}|rd n t!|}|||}t|t| ||z||d z }y|d d}|j#|||Ed{y#t$rYywxYw7w)zYield Claude Code-style @ context completions. Bare ``@`` or ``@partial`` shows static references and matching files/folders. ``@file:path`` and ``@folder:path`` are handled by the existing path completion path. ))z@diffzGit working tree diff)z@stagedzGit staged diff)@file:z Attach a file)@folder:zAttach a folder)z@git:z Git log with diffs (e.g. @git:5))z@url:zFetch web contentr#)rVrWNr rWrr)rrrrr=rA)rrr rpr>r9r?r'r@rArBrCrbr!rDrErG_fuzzy_file_completions)r r3rHlowered _STATIC_REFSrwr/rxbarewant_dir path_partrIrJ match_prefixr.rKrLrurMrNrOrP completionquerys r%_context_completionsz*SlashCommandCompleter._context_completionsst**,  , OIt ++G49Jg9U $'I:%!%  -0 F#2;Dt|tv6!Z/"&$,BDV4F 77--i88s?/6,J &&s+/7 J!#!:!AcJ#%77#3#3H#=L jj4G+113 #G_E#EKKM,D,D\,R " Z ?IWW]]95F  6) ~$&77??9#=L$*SF$*50@0KD$*8L>&!BJ$"(+D z %%)  QJE12a0 fQR//eUCCCED DsH:I*I*>I*BI*/IDI*I(I* I%!I*$I%%I*c Jtj}tj}|jr-|j |k(r||j z dkr |jSg}ddd|gdd|gdddd|gfD]}|d }tj|s tj|d d d |d d }|jd k(r|jr|jjr|jjjd}|ddD]T}tjj!|r tjj#||n|} |j%| Vn||_||_||_|S#tj&t(f$rY,wxYw)z9Return cached list of project files (refreshed every 5s).g@rgz--filesz--sortr=modifiedfdz--typefz--base-directoryrTrzutf-8r)capture_outputr(timeoutcwdencodingerrors Ni)r>getcwdtime monotonicrr rshutilwhich subprocessr returncodestdoutrrr9rFrEr TimeoutExpiredrC) r rhnowfilesrtoolprocrmprs r%_get_project_filesz(SlashCommandCompleter._get_project_filesisiiknn   $$+d+++c1## #90# 6 9c " 8S"4c :  C q6D<<% !~~4gi??a'DKKDKKr9rArrrp) filepathr`filename lower_file lower_pathlower_qqir  boundary_hitsprevs r% _score_pathz!SlashCommandCompleter._score_paths)77##H-^^% ^^% ++-     ) j  j  ACL Q'"+%5a  W MBD G $gbk)9v~%* !GB   G s 22r$c #XK|j}|s|d|D]}|jd}tjj |}|rdnd}|rdn:t tjj tj|} td|d|t| || yg} |D]-}|j||} | d kDs| j| |f/| jd | d|D]\} }|jd}tjj |}|rdnd}|rdn:t tjj tj|} td|d|t| || r|d | n|yw) z-Yield fuzzy file completions for bare @query.Nrfolderfiler=rS:r#rc|d |dfS)NrrAr)xs r%r_z?SlashCommandCompleter._fuzzy_file_completions..sAaD5!A$-r$r`z ) rzr'r>r9rArGr!rlr rprr sort) r r3r`rHrvfprNrkindr/scoredsrs r%rXz-SlashCommandCompleter._fuzzy_file_completionss'')FUm S)77++B/#)xv &u,<GGLLb1-!vQrdO$'I:$!%    'B  U+A1u q"g& '  / 0FU^ EAr[[%Fww''+H%86D"5(8 RYY["-)DD62$ #D z 04t2dV_"   s CF*CF*c #K ddlm}|D]^}|d}|j|s||k7s t|t | ||j ddxs|j dd`y#t $rYywxYww) z1Yield completions for /skin from available skins.r) list_skinsrrrsourcer#N)hermes_cli.skin_enginerrr rprr)sub_text sub_lowerrrrs r%_skin_completionsz'SlashCommandCompleter._skin_completionss  9\ y??9-$)2C$(+H ~ $%&UU="%=%TxQSAT     s3B&A3A3AA32B3 A?<B>A??Bc #jKd}|j}|jd}t|dk(st|dk(r^|s\|s|nd}|D]P}|j|j s#||j k7s7t |t| |Ry|dj }|dvry|rdn|d }|j }t |r|ddn|dd } dd lm} dd l m } m } m } | }| |d d }| D]K\}}}|| vs|j|s||v}|dk(r|r)|dk(r|s1t |t| ||Mt| D]G}|| vs|j|s||v}|dk(r|r%|dk(r|s-t |t| |dI|jdxsi}t|t rKt|D]<}|d}|| vs|j|st |t| |d|d>yy#t"$rYywxYww)uhYield completions for /tools — subcommand + toolset/MCP-server name. Handles both ``/tools `` (suggesting ``list|disable|enable``) and ``/tools enable `` / ``/tools disable `` (suggesting toolset keys and MCP server prefixes, filtered by current enable state so the user only sees actionable options). )rGdisableenablerrrArr$r%N)rrr ) load_config)CONFIGURABLE_TOOLSETS_get_platform_tools_get_plugin_toolset_keyscliF)include_default_mcp_serversrrr#zplugin toolset mcp_serversrz MCP server '')rr'rprrr rrrhermes_cli.tools_configrrrrbrr r r)rrSUBSrtrailing_spacepartialrj subcommand partial_loweralreadyrrrrrWenabledts_keylabel_descis_onrserverrxs r%_tools_completionsz(SlashCommandCompleter._tools_completionss- !**3/ u:?s5zQ~&4h"G U>>'--/2sgmmo7M$S#g,PSTT U 1X^^% 2 2 &"E"I  >eABiuQr{C6  5   !]F)&%UZ[G(= $uW$F,=,=m,L'))e*5 $'L="!&  !!9!;< W$F,=,=m,L'))e*5 $'L="!1  !**]39rK+t,$[1 F &xq\F(0A0A-0P $(+G } &'3F81%=  -   s8A,H3/H3A#H3'D;H$"H3$ H0-H3/H00H3c#"K|j}|jd}t|dkDst|dk(r|ry|r|rdn|d}|j} ddlm}|}|j }|D]m} | j} | j|s! |j| } | rt| ddrd | jnd } t| t| | | oy#t$rYywxYw#t$rd} YZwxYww) 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. rrANrr r)load_gateway_configru→ zsend this session herer#)rr'rprgateway.configrget_connected_platformsrvaluerget_home_channelgetattrrr ) rrrrrrrgwrrrhomer/s r%_handoff_completionsz*SlashCommandCompleter._handoff_completionsPs !**3/ u:>c%jAo. "n"59    :$&B224I" H>>D??=1 **84*.'$2MT$))%SkD #G }!        sNADC/<#D C>1>D/ C;8D:C;;D> D  D D  Dc#K ddlm}|jdxsijdixsi}dj|r d|k7rt dt | dd|j D]\}}|j|s||k7st|tr)|jdxs|jd d d d }nt|d d }t |t | ||y #t$rYy wxYww) zAYield completions for /personality from configured personalities.r)load_cli_configagent personalitiesrfzclear personality overlayr#r system_promptrNr) rrrrr rpr-r r rr)rrrrrr0r/s r%_personality_completionsz.SlashCommandCompleter._personality_completionsvs  ,,.227;ArFFXZ[a_aM  +)0C $'M>"!<  !. 3 3 5  f??9-$)2C!&$/%zz-8`FJJXZ<[\_]_<`"6{3B/$(+H ~ $%)     s6D B C<C<A$C<;D < DD DD c #" K|j}|jdsZ|j|}||j|Ed{y|j |}||j |Ed{y|j d}|dj}t|dkDs!t|dk(rD|jdr2t|dkDr|dnd}|j} |j|r|j|Ed{yd|vr@|dk(r|j|| Ed{y|dk(r|j|| Ed{y|d k(r|j|| Ed{y|d k(r|j|| Ed{yd|vrY|t vrQ|j#|r@t |D]4} | j| s| | k7st%| t| | 6y|dd} t&j)D]Y\} } |j#| s| dd}|j| s/t%|j+|| t|  | | [|j-j)D]\} }| dd}|j| st/|j1d d}|ddt|dkDrdndz}t|j1dg}t%|j+|| t|  | d|d|d |j3j)D]}\} }| dd}|j| st/|j1d d}|ddt|dkDrdndz}t%|j+|| t|  | d|  ddlm}|j)D]{\}}|j| st/|j1d d} | ddt| dkDrdndz}t%|j+|| t|  d|d| }y7$77Y78777#t8$rYywxYww)NrrAmaxsplitrrrz/skinz /personalityz/toolsz/handoffrr#rz Skill bundlerr~ru▣ z (z skills)r!r"r)r|u🔌 )text_before_cursorrrTrar:rQrrrpr'rr0rrrrrrr rr-r4rrrrr,r*r)r documentcomplete_eventr(ctx_word path_wordrbase_cmdrrrjr3rrvrrrr. skill_countr*cmd_infos r%get_completionsz%SlashCommandCompleter.get_completionss**s#11$7H#44X>>>//5I$11)<<<  A &8>># u:>c%jAo$--2D#&u:>uQxrH (I%%h/::4@@@("w&#55h JJJ~-#<4CXCXYaCb&x0C~~i0SI5E(,/M>$' ABx!) IC((-12wH""4( ))(D9$'I:!%  11399; IC12wH""4(!$((=."IJ ("-#k:JR:OUWX !$((8R"89  ))(D9$'I:#' |2k](!K  224::< IC12wH""4(!$((=/"JK ("-#k:JR:OUWX  ))(D9$'I:#' |!4    >&9&;&A&A&C "(&&t,x||M;KLMD!%crs4y2~e2!NJ$--h=(+D z"#H:',ZL%9  C? = A KRHJD   sARQ+,R4Q.5B#RQ1#R<Q4=RQ7R<Q:=RQ=?RR#A$RA'R0Bt"|D]2} | j| s| | k7st| t | dcS|jr|jj||Sy)NrrArrrr)rrrget_suggestionrrrpr'rrrr rr0r$r(rr)r bufferrr(rrr3rrrrr_ remainderrjs r%rz&SlashCommandAutoSuggest.get_suggestions(**s#}}}}33FHEE A &8>># u:?4==#58>>#D <??.t7W7WX[7\qr7&&t,T1A%hs4yz&:;;  <  #5zA~582NN$  OO '11(;"ooHHN 1 !00'OOZ-F-F,F,GH6@oo??$%i00  1 ?? &t/O/OPX/Y { "{8'<("&x0?C~~i0SI5E)#c(mn*=>>? ====//A Ar$)NN)rzAutoSuggest | NonerzSlashCommandCompleter | Nonerr)rr r!r"rrrr$r%rrs5/326$+$0$  $6r$rc tjj|}|dkr|dS|dkr |dz ddS|dkr |dz dd S|dz dd S#t$rYywxYw) z:Return a compact human-readable file size, or '' on error.riBiz.0fKi@z.1fMG)r>r9getsizerC)r9sizes r%rGrGXswwt$ d{qz k+c"!$$   +&s+1--()# .a 00 sA AA)rr)rrrzCommandDef | None)rrrr)rrrr)rrrr)rset[str]r)rrrzset[str] | Nonerr)rrrrr)rzlist[tuple[str, str, str]])rlist[tuple[str, str]])r8Mapping[str, Any]r9rrr)rdict[str, Any])rrE)rTzlist[str] | tuple[str, ...]rr)rr)rrrr)rmrrr)r.list[tuple[str, ...]]rsrrr)r5N) rrrrErrrrErz'Callable[[str], str] | None'r&tuple[list[tuple[str, str, str]], int])r5)r@rErz!tuple[list[tuple[str, str]], int])rrErrrr)rrrzMtuple[dict[str, list[tuple[str, str, str]]], list[tuple[str, str, str]], int])z)https://hermes-agent.local/slack/commands)rrrr)rr)r9rrr)gr" __future__rloggingr>rerorqrmcollections.abcrr dataclassesrtypingrutilsr getLoggerrrprompt_toolkit.auto_suggestr r prompt_toolkit.completionr r ImportErrorobjectrrr#rrrrr_cmdrrr_aliasrrrr_catrrrGcompile _PIPE_SUBS_RErrrmgrouprrrrrrrrrr'rr3rDrIrJrYr;rOrQrWr\rfrq_TG_NAME_LIMITrirkr1rz_clamp_telegram_namesrrrrrrrrrrrrrrrrrGrr$r%rs,#  -!!   8 $ C? $ + + +$@&wJI "@&uH)!X7 @& wF  ,CE @&w> @&xQS\@&y5y@&v6 @& wBIN!@&"xWYb(8,P#@&&vG '@&*w=y!#+@&.ycen%6/@&2xPR[ H63@&6zFHQ#/_a7@&:zCY#%;@&>zUW`i;XZ?@&Bv> JC@&Dy? ,>@E@&HvTV_ ,<>I@&L|=y$ ">757U@&\wNPY5]@&`wXZc#%a@&dvXZcoqe@&hulnw#%i@&lyKY46m@&pxGSq@&rxH&Qs@&tyGPu@&vy=y -9w@&zx2C@&F{?(GCEG@&Lw+_.kmU@&ZxU>RS[@&jxIK[k@&n|=?O&(o@&r a);=s@&vy^`p(E>@w@&|yC$0}@&DzG H6E@&Hv0&9I@&JyUW` "K@&Nwfhn,.O@&R~QSYl4S@&VwQSYZW@&Xz>!#Y@&\{Dfl4]@&`zNPV ,HJa@&dvF 4e@&hwDfi@&lwH&2m@&pxDfMq@&ry5vvNs@&twZ\b')u@&|vSU[i<I}@&"@N*?)@&@9. TD   $6t$<1TYYK!ll TF(,(8(8'9tyykQR%SHq\ " TT35/4 8D   #..t}}bA (1TYYK 9q _ll 8F!)AfX,!7D1VH  8 8%' !& >D '+D,<,<'= a {O$> 12 1D dii[/C kT^^,A771:++C0 C 1 *333*02;2*P.:  - &@L')#!$;:5%P@  1#2=!BJJ}-!rzz(+ $ "$$$P-37 v1v1v1v1 v1 1 v1 , v1z IF,<`-`-R`-T!rzz/2$&&(##<= $Nb568c Ic TEkEP 1mAKIJJ s_ __