sji UdZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z mZddlmZmZmZmZddlmZddlmZdad ed <dd ZejeZ ddlmZm Z ddl!m"Z"m#Z#n#e$$r e%Ze%Z"dZ dZ#YnwxYwe dGddZ&e'hdZ(ded<ge&dddddde&dddddd d!e&d"d#ddd$%e&d&d'dd(e&d)d*dd(e&d+d,dd(e&d-d.dd/0e&d1d2de&d3d4ddd5d67e&d8d9dd:0e&d;ddd?d@e&dAdBddCdDe&dEdFdddGdHIe&dJdKddLdMDe&dNdOddP0e&dQdRdddSdTUe&dVdWdXddYZe&d[d\dXdd]Ze&d^d_dd d^`e&dadbdddcdde&dedfdddgdde&dhdidddjdde&dkdlddmdndoe&dpdqddrdse&dtduddvddwdxye&dzd{dd|dnddz!e&d}d~ddndd}e&dddddde&ddddddde&dddd0e&ddddddd!e&ddddndde&ddddde&dddde&dddddddde&ddddddde&ddde&ddddde&ddddde&dddd0e&ddde&dddXd(e&dddXddde&dddXdddd!e&dddXd0e&dddXdde&dddXdddĬIe&dddXddddǬȦe&ddddd̬ͦe&dddXdddѦe&dddXdddĬIe&dddXddd֦e&dddXde&dddXddܬͦe&dddXddͦe&dddXddͦe&dddXddZe&dddXddd)edeIe&dddXddͦe&dddXdddĬIe&dddXdddIe&ddddd@e&dddd(e&dddddde&dddddͦe&dddde&dd ddd d Ie&d d ddddUe&dddd0e&dddd0e&ddddddIe&dddddde&d d!dd"d#De&d$d%ddd&ͦe&d'd(ddd)d֦e&d*d+dd(e&d,d-dd./e&d0d1dd2/e&d3d4ddd5d6Ie&d7d8dd(e&d9d:ddd;dd<=e&d>d?ddd@dABe&dCdDdddEe&dFdGdddHe&dIdJddK0e&dLdMdddNe&dOdPde&dQdRddS0e&dTdUdddVe&dWdXdddY%e&dZd[ddd\Ze&d]d^dd(e&d_d`dddaZe&dbdcdde&dddeddfdddge&dhdiddj0e&dkdldmddndoUZ*dpedq<dڐdsZ+e+Z,dredt<dېdxZ-dܐdzZ.iZ/d{ed|<e*D]EZ0e0j1s<e.e0e/d}e0j2<e0j3D]Z4e0j5d~e0j2de/d}e4<FiZ6ded<e*D]^Z0e0j1sUe67e0j8iZ9e/d}e0j2e9d}e0j2<e0j3D]Z4e/d}e4e9d}e4<_iZ:ded<e*D]%Z0e0j;redZ?e*D]`Z0d}e0j2Z@e@e:vse0jAse?Be0jAZCeCr+eCDdEde:e@<ae'de*DZFded<dݐdZGe'de*DZHded<dސdZIdސdZJdߐdZKdddZLddZMddZNddZOddZPdZQdZRhdZSdZT ddZUddZVddZWddZXddZYddZZdZ[ e[Z\ej>dZ]ej>dZ^ddZ_ddZ`e`Za ddd„ZbdddńZcddƄZdddȄZedZfdZgej>dʦZhe'hdˣZidZje'hdͣZkdd΄ZlddτZmddd҄ZnddӄZoGdԄde"ZpGdքdeZqdd؄ZrdS(aSlash 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) dataclassfield)AnyDictOptionalTuple)is_truthy_value)INDICATOR_STYLESzSOptional[Tuple[Tuple[Optional[str], Optional[int], Optional[int]], Dict[str, Any]]]_personalities_memoreturnDict[str, Any]c>ddlm}ddlm} ddlm}|}|}t||j|j f}n#t$rd}YnwxYwttd|kr tdS||}||fa |S)u@Return the available personalities map, memoised on config mtime. Wraps ``available_personalities(load_cli_config())`` — the single owner of built-ins + user overrides. Built-ins are static for the process lifetime, so keying on the config file's path+mtime+size keeps the memo freshness-correct. rload_cli_config)available_personalities)get_config_pathNNNN) clirhermes_cli.personalityrhermes_cli.configrstatstr st_mtime_nsst_size Exceptionr)rrrcfg_pathstsig personalitiess 7/home/agent/.hermes/hermes-agent/hermes_cli/commands.py_personalities_from_cli_configr%&s$#####>>>>>>!555555"?$$ ]]__8}}bnbj9 !!! !&+>q+AS+H+H"1%%++OO,=,=>>M . sAA AA) AutoSuggest Suggestion) Completer CompletionT)frozenceZdZUdZded<ded<ded<dZded<d Zded <dZded <d Zd ed<d Z d ed<dZ ded<dZ ded<dZ ded<dZ ded<dS) CommandDefz%Definition of a single slash command.rname descriptioncategorytuple[str, ...]aliases args_hint subcommandsFboolcli_only gateway_onlyN str | Nonegateway_config_gatereject busy_policy busy_handlerexecute)__name__ __module__ __qualname____doc____annotations__r2r4r5r7r8r:r<r=r>r0r$r,r,Vs// IIIMMM!G!!!!I#%K%%%%HL&*****" K $L####GrDr,>r;dispatchinterrupt_then_dispatchzfrozenset[str]VALID_BUSY_POLICIESstartz0Acknowledge platform start pings without a replySessionrE)r8r<r=newz0Start a new session (fresh session ID + history))resetz[name]rF)r2r4r<r=topicz,Enable or inspect Telegram DM topic sessionsz[off|help|session-id])r8r4clearz$Clear screen and start a new session)r7redrawz6Force a full UI repaint (recovers from terminal drift)historyzShow conversation historysavez8Export the current conversation (bare /save shows usage)z" [filename] [redact]r4retryz(Retry the last message (resend to agent)promptz)r4r7branchz5Branch the current session (explore a different path))fork)r2r4worktreez3Show, list, create, or prune isolated git worktreesz#[new [name]|list|prune [--dry-run]])rJlistprune)r7r4r5compresszhCompress conversation context (add 'here [N]' to keep recent N turns; --preview shows what would happen))compactz.[here [N] | focus topic | --preview|--dry-run]rollbackzWList or restore filesystem checkpoints (restores keep your hand-edits; --all overrides)z[number] [--all]snapshotz8Create or restore state snapshots of Hermes config/state)snapzreate|restore |prune])r7r2r4exportz?Export a profile (config, skills, theme) to a shareable archive Configurationz[profile] [-o output.tar.gz])r7r4importz0Import a shared profile archive as a new profilez [--name ]stopz%Kill all running background processes)r<r=pausez>Pause new work globally (emergency stop); '/pause off' resumesz[reason | off])r8r4r<approvez#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)bgbtwz)r2r4r<agentsz$Show active agents and running tasks)tasks)r2r<journeyz"Open the learning journey timeline)learning memory-graphz[list|delete |edit ])r[deleteedit)r2r7r4r5queuez4Queue a prompt for the next turn (doesn't interrupt))qsteerz>Inject a message after the next tool call without interrupting)r4r<r=goalz?Set a standing goal Hermes works on across turns until achievedze[text | draft | show | gate add | pause | resume | clear | status | wait | unwait] heartbeatz | status | pause | resume | clear])statusrfresumerM)r2r4r5r<refinez>Review this conversation now and save lessons to memory/skillsz[focus instructions]loopz7Re-run a prompt on a recurring interval in this session) proactivezV[interval] [--times N] [--until ] | status | pause | resume | stopmoazTRun one prompt through the default Mixture of Agents preset, then restore your modelr;subgoalz/Add or manage extra criteria on the active goalz[text | remove N | clear])r4r<ryz,Show session, model, token, and context info)r<egresszShow Docker egress proxy statusz[status])ry)r4r5r<r=r>contextziShow detailed context window view with usage gauge, category breakdown, compression stats, and throughput)ctxz[all])allwhoamiz-Show your slash command access (admin / user)Infoprofilez+Show active profile name and home directory)r<r>sethomez!Set this chat as the home channel)zset-home)r8r2rzz!Resume a previously-named sessionsessionsz#Browse and resume previous sessionsconfigzShow current 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)r7r2batteryz8Toggle a color-coded battery indicator in the status barz[on|off|status])onoffry timestampsz2Toggle [HH:MM] timestamps on messages and /history)ts)r7r4r5r2diffz)Show git changes in the working directoryz'[staged|all|session] [--stat] [path...])stagedrsession)r4r5verbosez9Cycle tool progress display: off -> new -> all -> verbosezdisplay.tool_progress_command)r7r:r<focusuBToggle focus view — show only your prompt and the final responsefooterz7Toggle gateway runtime-metadata footer on final replies)r4r5r<yoloz7Toggle YOLO mode (skip all dangerous command approvals) approvalsz:Show or set the persistent dangerous-command approval modez[manual|smart|off])manualsmartr reasoningz#Manage reasoning effort and displayz'[level|show|hide|full|clamp] [--global])noneminimallowmediumhighxhighmaxultrashowhiderrfullclamp--globalfastuSToggle fast mode — OpenAI Priority Processing / Anthropic Fast Mode (Normal/Fast)z[normal|fast|status] [--global])normalrryrrrskinz%Show or change the display skin/theme indicatorz!Pick the TUI busy-indicator style[|]voicezToggle voice modez[on|off|tts|status])rrttsrywakez*Toggle the 'Hey Hermes' wake word listenerbusyz/Control what Enter does while Hermes is workingz[queue|steer|interrupt|status])rsru interruptrytoolsz4Manage tools: /tools [list|disable|enable] [name...]zTools & Skillsz[list|disable|enable] [name...]toolsetszList available toolsetsskillsz*Search, install, inspect, or manage skillszskills.write_approval) searchbrowseinspectinstallauditpendingrgr;rapproval)r7r:r5memoryz7Review pending memory writes / toggle the approval gatez-[pending|approve|reject|approval] [id|on|off])rrgr;rbundlesz8List skill bundles (aliases / for multiple skills))r>petz>Toggle or adopt a petdex mascot (/pet, /pet list, /pet )z[toggle|list|scale |])toggler[scalerhatchz,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)zinitzBGenerate or update AGENTS.md project instructions from a repo scanz[notes]cronzManage scheduled tasksz [subcommand])r[addcreaterrrfrzrunremove suggestionsz-Review suggested automations (accept/dismiss))suggestz[accept|dismiss N | catalog])acceptdismisscatalogrM)r2r4r5 blueprintz.Set up an automation from a blueprint template)bpz[name] [slot=value ...]curatorzGBackground skill maintenance (status, run, pin, archive, list-archived))ryrrfrzpinunpinrestorez list-archivedkanbanz:Multi-profile collaboration board (tasks, links, comments))!rboardsrr[lsrassignreclaimreassign diagnosticsdiaglinkunlinkclaimcommentcompleterrblockunblockarchivetailrEstatsznotify-subscribez notify-listznotify-unsubscribelogrunsrw assigneesrspecifygcreloadz.Reload .env variables into the running sessionz reload-mcpzReload MCP servers from config) reload_mcp)r2z reload-skillsz?Re-scan ~/.hermes/skills/ for newly installed or removed skills) reload_skillsbrowserzaConnect browser tools to your live Chromium-family browser via CDP, or switch to Browser Use modez[connect|disconnect|status|use])connect disconnectryusepluginsz'List installed plugins and their statuscommandsz*Browse all commands and skills (paginated)z[page]gateway_commands)r8r4r<r>helpzQShow available commands (/help skills lists skill commands, /help filters) gateway_helpz[skills|])r<r>r4palettez,Open the fuzzy command palette (also Ctrl+P))r7r<restartz9Gracefully restart the gateway after draining active runs)r8r<usagezLShow 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 clipboardz[number]pastez*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)v)r2r<r>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]zlist[CommandDef]COMMAND_REGISTRYdict[str, CommandDef]cPi}tD]}|||j<|jD]}|||<|S)z+Map every name and alias to its CommandDef.)rr-r2)lookupcmdaliass r$_build_command_lookuprsH$&F  sx[  EF5MM MrD_COMMAND_LOOKUPr-rCommandDef | Nonect|dS)zmResolve a command name or alias to its CommandDef. Accepts names with or without the leading slash. /)rgetlowerlstrip)r-s r$resolve_commandrs.   tzz||22377 8 88rDrcR|jr|jd|jd|jdS|jS)z;Build a CLI-facing description string including usage hint.z (usage: / ))r4r.r-)rs r$_build_descriptionr#s: }I/HHSXHH HHHH ?rDdict[str, str]COMMANDSrz (alias for /r"zdict[str, dict[str, str]]COMMANDS_BY_CATEGORYzdict[str, list[str]] SUBCOMMANDS)r]r^rrry)rirjrkrlrmrsrtrurvrrwrxr{r|r}r~rnrorp)ContextzBackground & Automationzdict[str, tuple[str, ...]]HELP_SESSION_SUBGROUPSz[a-z]+(?:\|[a-z]+)+c#\K|]'}|jr|j|jg|jRD]}|V(dSN)r7r:r-r2).0rr-s r$ r-su33 <323(CK(( 33  3333333rDGATEWAY_KNOWN_COMMANDSr9r6c`|sdS|tvrdStD]\}}}||krdSdS)uReturn True if ``name`` resolves to a gateway-dispatchable slash command. This covers both built-in commands (``GATEWAY_KNOWN_COMMANDS`` derived from ``COMMAND_REGISTRY``) and plugin-registered commands, which are looked up lazily so importing this module never forces plugin discovery. Gateway code uses this to decide whether to emit ``command:`` hooks — plugin commands get the same lifecycle events as built-ins. FT)r._iter_plugin_command_entries)r- plugin_name _description _args_hints r$is_gateway_known_commandr4sZ u %%%t1M1O1O- \: $  44  5rDc#:K|]}|jdk |jVdS)r;N)r<r-)r,rs r$r-r-s9;;COx,G,GCH,G,G,G,G;;rDACTIVE_SESSION_BYPASS_COMMANDS command_namecF|sdSt|}|duo |jdkS)aReturn True when *command_name* must interrupt a running agent first. Derived from the registry: commands whose ``busy_policy`` is "interrupt_then_dispatch" (the /stop, /new, /reset class). Guard 1 (gateway/platforms/base.py) routes these through the cancel-handoff path that serializes cancellation + runner response + pending drain. Accepts aliases (e.g. "reset" resolves to "new"). FNrF)rr<)r7rs r$is_interrupt_then_dispatchr9s5 u , ' 'C d? Ks2KKKrDc,|rt|dundS)uReturn True for any resolvable slash command. Rationale: every gateway-registered slash command either has a specific Level-2 handler in gateway/run.py (/stop, /new, /model, /approve, etc.) or reaches the running-agent catch-all that returns a "busy — wait or /stop first" response. In both paths the command is dispatched, not queued. Queueing is always wrong for a recognized slash command because the safety net in gateway.run discards any command text that reaches the pending queue — which meant a mid-run /model (or /reasoning, /voice, /insights, /title, /resume, /retry, /undo, /compress, /usage, /reload-mcp, /sethome, /reset) would silently interrupt the agent AND get discarded, producing a zero-char response. See issue #5057 / PRs #6252, #10370, #4665. ACTIVE_SESSION_BYPASS_COMMANDS remains the subset of commands with explicit Level-2 handlers; the rest fall through to the catch-all. NF)r)r7s r$should_bypass_active_sessionr;"s"(9E O?< ( ( 4 4%OrDset[str]cdtD}|stS ddlm}|}n#t$rtcYSwxYwt}|D]y}|}|jdD]/}t|tr| |}-d}t|dr| |j z|S)zReturn canonical names of commands whose ``gateway_config_gate`` is truthy. Reads ``config.yaml`` and walks the dot-separated key path for each config-gated command. Returns an empty set on any error so callers degrade gracefully. c g|] }|j | Sr0)r:)r,cs r$ z)_resolve_config_gates..@s B B B1A,A BQ B B BrDrread_raw_config.NF)default) rsetrrBrr:split isinstancedictrr rr-)gatedrBcfgresultrvalkeys r$_resolve_config_gatesrN9s C B( B B BE uu 555555o uu uuF ! !*0055  C#t$$ ggcll 3 . . . ! JJsx Ms4AAconfig_overridesset[str] | Nonec\|jsdS|jr||n t}|j|vSdS)a}Check if *cmd* should appear in gateway surfaces (help, menus, mappings). Unconditionally available when ``cli_only`` is False. When ``cli_only`` is True but ``gateway_config_gate`` is set, the command is available only when the config value is truthy. Pass *config_overrides* (from ``_resolve_config_gates()``) to avoid re-reading config for every command. TNF)r7r:rNr-)rrO overridess r$_is_gateway_availablerSVsG <t %(8(D$$J_JaJa x9$$ 5rDr4cP|dS)zFReturn True when selecting a command without text would be incomplete.<)strip startswithrQs r$_requires_argumentrXfs ??   ' ' , ,,rD list[str]c t}g}tD]}t||s|jr d|jnd}g}|jD]Z}|dd|jddkr ||jkrA|d|d[|rdd|d nd}|d|j|d |j ||S) z3Generate gateway help text lines from the registry.r!r3-_z`/`z (alias: z, r"z` -- ) rNrrSr4r2replacer-appendjoinr.)rRlinesrargs alias_partsa alias_notes r$gateway_help_linesrfks!%''IE N N$S)44  &)m;"3="""!#  * *Ayyc""ch&6&6sC&@&@@@Q#(]]   yAyyy ) ) ) )>IQ:;!7!7::::r  L#(LDLLsL LLMMMM LrDlist[tuple[str, str, str]]c ddlm}n#t$rgcYSwxYw |pi}n#t$rgcYSwxYwg}|D]\}}t |t rt |t s0t |dpd|}t |dpd}| |||f|S)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_commandsr.Run /r4r3) hermes_cli.pluginsrjritemsrGrrHrrVr_)rjrentriesr-metar.r4s r$r0r0~s5:::::::  &&((.B  *,Gnn&&77 d$$$ JtT,B,B  $((=11C^T^^DD --344::<< k956666 Ns  ) 88list[tuple[str, str]]cZt}g}tD]E}t||st|j}|r|||jfFtD]>\}}}t|rt|}|r|||f?|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. ) rNrrS_sanitize_telegram_namer-r_r.r0rX)rRrKrtg_namer-r.r4s r$telegram_bot_commandsrts&''I$&F66$S)44  *#(33  6 MM7CO4 5 5 5(D(F(F22$k9 i ( (  )$//  2 MM7K0 1 1 1 MrD<d>r_prependr^)rrJreryrrzrrr rr rrrgrhrsrurirrrrrrrootMapping[str, Any]pathc|}|D]0}t|tsicS||}1t|tr|niSr+)rGrr)rxrznoderMs r$_nested_mappingr}s[D$(( IIIxx}}dG,, 444"4rDdict[str, Any]c  ddlm}|pi}n#t$ri}YnwxYwt|tsi}t t |dddd}|dt} t|}n#ttf$r t}YnwxYwtdtt|}t|d pd }|t$vrd }|d }t|t&r d |D}ng}|||d S)zReturn normalized Telegram command-menu config with safe defaults. Canonical user-facing path: ``platforms.telegram.extra.command_menu``. rrArtelegramextra command_menu max_commandsr priority_moderwprioritycng|]2}t|#t|3Sr0)rrV)r,items r$r@z1_telegram_command_menu_config..s3LLL$#d))//:K:KLCIILLLrD)rrr)rrBrrGrrHr}r#_DEFAULT_TELEGRAM_MENU_MAX_COMMANDSint TypeError ValueErrorrmin_TELEGRAM_BOT_API_MAX_COMMANDSrrVr_TELEGRAM_PRIORITY_MODESr[)rBraw_cfgmenu_cfgrr raw_priorityrs r$_telegram_command_menu_configrs 555555!/##)r  gw ' 'OG[*g~^^__H<<0STTL;<(( z ";;;: ;q# ? ??rD raw_nameslist[str] | tuple[str, ...]r1cg}t}|D]N}tt|}|r.||vr*||||Ot |Sr+)rErrrrr_tuple)rrKseenraw_namer-s r$_dedupe_sanitized_namesr$srFUUD  &s8}}55  D$$ HHTNNN MM$    ==rDct}tt|d}ttt}|ddkr|}n|ddkr||z}n||z}t|S)Nrrr^r_)rr[r_TELEGRAM_MENU_PRIORITY)r configureddefaultsrs r$_telegram_effective_priorityr/s,..H-hz.BCCDDJ+,CDDEEH I--! / "h . .*, !H, "< 0 00rDcdttDdtt|fdDS)Nci|]\}}|| Sr0r0)r,indexr-s r$ z6_prioritize_telegram_menu_commands..As. E4 erDcg|]\}}|Sr0r0)r,_indexcommands r$r@z6_prioritize_telegram_menu_commands..Es,    FG    rDcr|ddvrd|dd|dfn d|dfS)Nrrr0)rrs r$z4_prioritize_telegram_menu_commands..IsT AwqzX%% a$QQ rDrM) enumeratersorted)rrs @r$"_prioritize_telegram_menu_commandsr>s$%A%C%CDDH  % h          rD z [^a-z0-9_]z_{2,}rawc|dd}td|}td|}|dS)uRConvert a command/skill/plugin name to a valid Telegram command name. Telegram requires: 1-32 chars, lowercase a-z, digits 0-9, underscores only. Steps: lowercase → replace hyphens with underscores → strip all other invalid characters → collapse consecutive underscores → strip leading/ trailing underscores. r[r\r3)rr^_TG_INVALID_CHARSsub_TG_MULTI_UNDERSCORErVrr-s r$rrrrcs[ 99;;  sC ( (D  T * *D  # #C . .D ::c??rDrnlist[tuple[str, ...]]reservedc`t|}g}|D]}|^}}}t|tkrF|dt}||vr1|dtdz } tdD]} | | }||vrnc|}||vrj|||||g|R|S)aEnforce 32-char command name limit with collision avoidance. Both Telegram and Discord cap slash command names at 32 characters. Names exceeding the limit are truncated. If truncation creates a duplicate (against *reserved* names or earlier entries in the same batch), the name is shortened to 31 chars and a digit ``0``-``9`` is appended to differentiate. If all 10 digit slots are taken the entry is silently dropped. Accepts tuples of any length >= 2. Extra elements beyond ``(name, desc)`` (e.g. ``cmd_key``) are passed through unchanged, so callers can attach metadata that survives the rename. Nr )rElen_CMD_NAME_LIMITrangerr_) rnrusedrKentryr-descr candidateprefixdigits r$_clamp_command_namesrqs ]]DF,,"dU t99 & &-o-.ID  2223"2YYE#) 25 2 2I ,,-D 4<<   tT*E**++++ MrD max_slotsreserved_names desc_limit sanitize_name'Callable[[str], str] | None'&tuple[list[tuple[str, str, str]], int]c( g}g} ddlm}|}t|D]j} |r || n| } | s|| dd} t | |kr| d|dz dz} || | fkn#t $rYnwxYwt||}|d|D|D]\} } || | d ft} dd l m }|| }n#t $rYnwxYwg} dd l m }dd lm}ddl m}m}t%|}t%|dz ddz}|ddzg}|d|D|d|D|}t|D]}||}|dd  s#t- fd|Ds? |rU|dd }||vrp|d}|r ||n|} | s|dd } t | |kr| d|dz dz} || | |fn#t $rYnwxYwt||}t3d|t |z }t3dt ||z }|d|D]\} } }|| | |f|d||fS)aCollect plugin + skill entries for a gateway platform. Priority order: 1. Plugin slash commands (take precedence over skills) 2. Built-in skill commands (fill remaining slots, alphabetical) Only skills are trimmed when the cap is reached. Hub-installed skills are excluded. Per-platform disabled skills are excluded. Args: platform: Platform identifier for per-platform skill filtering (``"telegram"``, ``"discord"``, etc.). max_slots: Maximum number of entries to return (remaining slots after built-in/core commands). reserved_names: Names already taken by built-in commands. Mutated in-place as new names are added. desc_limit: Max description length (40 for Telegram, 100 for Discord). sanitize_name: Optional name transform applied before clamping, e.g. :func:`_sanitize_telegram_name` for Telegram. May return an empty string to signal "skip this entry". Returns: ``(entries, hidden_count)`` where *entries* is a list of ``(name, description, cmd_key)`` triples and *hidden_count* is the number of skill entries dropped due to the cap. ``cmd_key`` is the original ``/skill-name`` key from :func:`get_skill_commands`. rrir.Plugin commandN...c3 K|] \}}|V dSr+r0r,nr\s r$r-z1_collect_gateway_skill_entries..s&551!555555rDr3get_disabled_skill_namesrget_skill_commands SKILLS_DIRget_external_skills_dirsget_project_skills_dirs.hubrc3`K|])}t|ddzV*dSrNrrstripr,ds r$r-z1_collect_gateway_skill_entries..J! ! )*CFFMM#   $! ! ! ! ! ! rDc3`K|])}t|ddzV*dSrrrs r$r-z1_collect_gateway_skill_entries..rrD skill_md_pathc3BK|]}|VdSr+)rW)r,r skill_paths r$r-z1_collect_gateway_skill_entries..s1UUz,,V44UUUUUUrDr-)rlrjrrrr_rrr rEagent.skill_utilsragent.skill_commandsrtools.skills_toolrrrrresolverextendanyrWrr)!rrrrr all_entries plugin_pairsrj plugin_cmdscmd_namer-rrr_platform_disabledr skill_triplesrrrr _skills_dir_hub_dir_allowed_prefixes skill_cmdscmd_keyinfo skill_namer remaining hidden_countkrs! @r$_collect_gateway_skill_entriesrsF/1K+-L  ::::::))++ {++ . .H.;I==***D x(,,]>>>>>55xHHH      13M* ;;;;;;000000WWWWWWWW*,,..//  V+446677>>sCCcI)//44s:;  ! ! .F.F.H.H! ! !       ! ! .E.E.G.G! ! !    (')) j)) 8 8Gg&D/266J UUUUCTUUUUU $$X.. &"--J///~~c**H.;I==***D 88M2..D4yy:%%OZ!^O,u4  $g!6 7 7 7 7' 8(      )GGMAy3{#3#3344Iq#m,,y899L ),&&1aAq!9%%%% z z "L 00s7B B BBD D D &GK?? L  L r!tuple[list[tuple[str, str]], int]cttt}d|D}t|}tdt ||z }td|t |z }t d||dt \}}|d|D|d|||zfS)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. ch|]\}}|Sr0r0rs r$ z)telegram_menu_commands..3s222DAqa222rDrr()rrrrrc3&K|] \}}}||fV dSr+r0)r,rr_ks r$r-z)telegram_menu_commands..@s,7781aA777777rDN)rr[rtrrrrrr)r core_commandsr all_commandshidden_core_countremaining_slotsrnrs r$telegram_menu_commandsr!s"7t>O:!%- G\77w777777   & 7H(H HHrDcBtd|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. discordrv)rrrr)rrE)rrs r$discord_skill_commandsr Ds/, *>**    rDMtuple[dict[str, list[tuple[str, str, str]]], list[tuple[str, str, str]], int]cddlm}t} ddlm}|d}n#t $rYnwxYwi}g}t |d}d} ddlm }ddlm } m } dd l m } | } | d z } | g} | D]C} |||4#t $rY@wxYwn#t $rYnwxYw | D]C} |||4#t $rY@wxYwn#t $rYnwxYw|}t!|D]}||}|d d }|s$||}t%|t%| rqd }|D]+} ||n#t*$rY%wxYw|}||dd }||vr|d}|d d}||vrQ||}|dkrt.d|||nt.d|||||dz }3|||<|dd }t3|dkr |d ddz}|j|}|j}t3|dkr6|d}||g|||f||||fn#t $rYnwxYw|||fS)uIReturn 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. ``some-skill/SKILL.md`` directly under a scan root) 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)Pathrr rz rrrrrr3Nr-rruDiscord /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.rr.rvar)pathlibrrErrrrHfromkeysrrrrrrrr_rrrrW relative_torrloggerwarningrparentparts setdefault) r_Prr categories uncategorized _names_usedhiddenrrrrrr _scan_rootsextprojrrrrsp matched_rootrxrr discord_namepriorrrelrcats r$"discord_skill_commands_by_categoryr'bsN#"""""#&55 >>>>>>55yIII      9;J02M #'-- "M"MK Fl ;;;;;;WWWWWWWW000000 ((** '0022"-  //11  &&rr#ww'8'89999 H      D  //11  &&rr$xx'7'7'9'9:::: H      D '')) j))M DM DGg&D/266J J''))B2ww!!#h--00 '+L#  NN4((((!H# #&"--J///~~c**H#CRC=L{**$L1L((NN1 %g| NN. w e ! (/K %88M2..D4yy3CRCy5()'' 55CIE5zzQAh%%c2..55|T76STTTT$$lD'%BCCCC[M D\       }f ,,s) 66AM) C-+0CC- C)&C-(C))C-,M)- C:7M)9C::M)> E 0D<;E < E E E  E M) EM)EBM).HM) HM)HEM)) M65M62z [^a-z0-9_\-]>medndmsgprowhoawayfeedr`muteopenleaveshrugrLexpandremindrrycollapse shortcuts)rkrj> r~rrr rfrrr{r rr rrwc|}td|}|d}|dtS)zConvert a command name to a valid Slack slash command name. Slack allows lowercase a-z, digits, hyphens, and underscores. Max 32 chars. Uppercase is lowercased; invalid chars are stripped. r3z-_N)r_SLACK_INVALID_CHARSrrV_SLACK_NAME_LIMITrs r$_sanitize_slack_namer;\sI 99;;D  # #B - -D ::d  D """ ##rDc  tgt d dd fd }fd tD}t D]=}||}|$||d |jd |j|j pd>tD]1}t|s||j|j|j pd2tD]A}t|s|j D]&}||d |jd |j|j pd'BtD]\}}}||||pdS)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]r=r-rrhintrNonect|}|r|vrdS|tvrdS|tvrdSttkrdS||dd|ddf|dS)Nrv)r;_SLACK_RESERVED_COMMANDS_SLACK_VIA_HERMES_ONLYr_SLACK_MAX_SLASH_COMMANDSr_r)r-rr> slack_namernrs r$_addz"slack_native_slashes.._adds)$//  Z4// F 1 1 1 F / / / F w<<4 4 4 F D#JTcT ;<<< rDcJi|]}t||jD]}|| Sr0)rSr2)r,rrrRs r$rz(slack_native_slashes..sX  i 0 0[   srDNz Alias for /u — r3)r-rrrr>rrr?) rNrEr_rr_SLACK_PRIORITY_ALIASESrr-r.r4rSr2r0) rF _alias_to_cmdrrr-r.r4rnrRrs @@@r$slack_native_slashesrJhs*&''I*,GUUD NNZ[[[HHX       &#M )]]&& ? DFchFFS_FF H[Y[ \ \ \ ==$S)44   SXs (;<<<< ]]$S)44  [ ] ]E DFchFFS_FF H[Y[ \ \ \ \ ] )E(F(F11$k9 T; R0000 NrD)https://hermes-agent.local/slack/commands request_urlcg}tD]1\}}}d||pd|d|d}|r||d<||2dd|iiS)uGenerate a Slack app manifest with all gateway commands as slashes. ``request_url`` is required by Slack's manifest schema for every slash command, but in Socket Mode (which we use) Slack ignores it and routes the command event through the WebSocket. A placeholder URL is fine. The returned dict is the ``features.slash_commands`` portion only — callers compose it into a full manifest (or merge into an existing one). Keeping it narrow avoids coupling us to the rest of the manifest schema (display_information, oauth_config, settings, etc.) which users set up once in the Slack UI and rarely change. rrkF)rr. should_escapeurl usage_hintfeaturesslash_commands)rJr_)rLslashesr-rrrs r$slack_app_manifestrTsG133  dE!4zz1>4>>"     ("'E, u )73 44rDct}i}tD]7}t||sd|j||j<|jD] }d|||< 8t D]\}}}||vrd|||<|S)a0Return subcommand -> /command mapping for Slack /hermes handler. Maps both canonical names and aliases so /hermes bg do stuff works the same as /hermes background do stuff. Plugin-registered slash commands are included so ``/hermes `` routes through the plugin handler. r)rNrrSr-r2r0)rRmappingrrr-r2r3s r$slack_subcommand_maprWs&''I G))$S)44  *NN[ ) )E([[GENN )*F*H*H''&lJ w  &JJGDM NrDcxeZdZdZ d1d2d Zd3dZd4dZd4dZed5dZ d6dZ d7dZ e hdZ ed8dZed9dZed:d;d Zed9d!Zd:d;d"Zdd?d)Zed@d,Zed@d-Zed@d.Zed@d/Zd0ZdS)ASlashCommandCompleterzJAutocomplete for built-in slash commands, subcommands, and skill commands.Nskill_commands_provider1Callable[[], Mapping[str, dict[str, Any]]] | Nonecommand_filterCallable[[str], bool] | Noneskill_bundles_providerrr?cZ||_||_||_g|_d|_d|_dS)Ngr3)_skill_commands_provider_command_filter_skill_bundles_provider _file_cache_file_cache_time_file_cache_cwd)selfrZr\r^s r$__init__zSlashCommandCompleter.__init__s; )@%-'=$&('*$&rD slash_commandrr6c||jdS t||S#t$rYdSwxYw)NT)rar6r)rfrhs r$_command_allowedz&SlashCommandCompleter._command_allowedsS   '4 ,,];;<< <   44 s !- ;;Mapping[str, dict[str, Any]]cf|jiS |piS#t$ricYSwxYwr+)r`rrfs r$_iter_skill_commandsz*SlashCommandCompleter._iter_skill_commands sP  ( 0I 00228b 8   III  ! 00cf|jiS |piS#t$ricYSwxYwr+)rbrrms r$_iter_skill_bundlesz)SlashCommandCompleter._iter_skill_bundlessP  ' /I //117R 7   III rotokenc~d|dddzS)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. rr\r[)rr^r)rrs r$_normalize_skill_tokenz,SlashCommandCompleter._normalize_skill_tokens7U\\#&&..sC88>>@@@@rDcT|||vSr+)rtrn)rfrrs r$_is_skill_commandz'SlashCommandCompleter._is_skill_command%s'**511T5N5N5P5PPPrDtextc#pK ddlm}n#t$rd}YnwxYw|}|dr|d}}n|dd|d}}t }|D]I}||}||vs||vrdS||Jt||krdS| dsdS||} | D]\} } | |vs| | st| d d } | dd t| d krd ndz} | | kr| dn| }t|t| | d | VdS)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_SKILLSr!r3Nrr. Skill commandr(r⚡ start_positiondisplay display_meta)rryrrFendswithrErtrnrrrWrmrrr))rfrw_captokens completed current_wordrrrrMword_keyrrr. short_desc replacements r$_stacked_skill_completionsz0SlashCommandCompleter._stacked_skill_completions(s%  H H H H H H H   DDD  ==   >&,b|II&,SbSk6":|I  E--e44C$335555 HHSMMMM t99   F&&s++  F..|<<2244::<<  ICd{{#..":":{dhh}oFFGGK$SbS)c+6F6F6K6KUUQSTJ(+hS))))CK #L 1 110J00       s  >rrrrwordc<||kr|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!)rY_PICKER_COMMANDS)rrs r$_completion_textz&SlashCommandCompleter._completion_textfs4 t  O ,= = =O~~~rDr9c|sdSt|dz }|dkr#||dkr|dz}|dkr ||dk||dzd}|sdSd|vrdS|dsd|vr|SdS)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. Nrrr!z://)z./z../~/rrrrWrwirs r$_extract_path_wordz(SlashCommandCompleter._extract_path_wordzs 4 IIM1ffaC FA1ffaCAEFF| 4 D==4 ??3 4 4 t KtrDlimitrc#FKtj|}|dr|}d}n@tj|pd}tj|} tj|}n#t$rYdSwxYwd}|}t|D]W}|r(| |s-||krdStj ||} tj | } | drAdtj | tjdz} nAtj|r| } ntj | } | r| dz } | rdnd} | rdnt| } t!| t#| || z| V|d z }YdS) z8Yield Completion objects for file paths matching *word*.rr3rCNr~rdirr~r)osrz expanduserrdirnamebasenamelistdirOSErrorrrrWr`isdirrelpathisabs_file_size_labelr)r)rrexpanded search_dirrrncount prefix_lowerr full_pathis_dir display_pathsuffixros r$_path_completionsz'SlashCommandCompleter._path_completionss)7%%d++   S ! ! 0!JFF229cJW%%h//F j,,GG    FF ||~~ G__  E ekkmm66|DD ~~ Z77IW]]9--Fs## :#bgooiASASTWAXAX&Y&YY t$$ :(  "wy99  $# "*SSF"C55(8(C(CD #D z!     QJEE=  s=B B B c|sdSt|dz }|dkr#||dkr|dz}|dkr ||dk||dzd}|dsdS|S)z=Extract a bare ``@`` token for context reference completions.Nrrr!@rrs r$_extract_context_wordz+SlashCommandCompleter._extract_context_words 4 IIM1ffaC FA1ffaCAEFF|s## 4 rDc#vK|}d}|D]g\}}||r;||kr#t|t| ||VhdD] }|dd}||ks||r|dk} ||krdn|t|d} tj| } | r| dkrd \} } nZ| d r| d} } n@tj| pd} tj | } t j | }n#t$rYdSwxYwd }| }t|D]}| r(||s,tj | |}tj|}| |krr||krnltj|}|rd nd}|rd nt!|}|||}t|t| ||z|V|d z }dS |d d}||||Ed{VdS)zYield Claude Code-style @ context completions. Bare ``@`` or ``@partial`` shows static references and matching files/folders. ``@file:path`` and ``@folder:path`` are handled by the existing path completion path. ))z@diffzGit working tree diff)z@stagedzGit staged diff)@file:z Attach a file)@folder:zAttach a folder)z@git:z Git log with diffs (e.g. @git:5))z@url:zFetch web contentr~)rrNr{rr3rC)rCr3rrrr)rrWr)rrrzrrrrrrrr`rrr_fuzzy_file_completions)rfrrlowered _STATIC_REFSrrorbarewant_dir path_partrr match_prefixrnrrrrrrr completionquerys r$_context_completionsz*SlashCommandCompleter._context_completionss0**,,  ,  OIt  ++G44 9J9Jg9U9U $'II:%!% -0 0 F#2#;Dt||tv66|!Z/"&$,,BBDV4F 7--i88>8s??/6,J &&s++>/7 JJ!#!:!:!AcJ#%7#3#3H#=#=L j44GGFFF+1133 #G__E#!EKKMM,D,D\,R,R! " Z ? ?IW]]955F  6)) ~~#%7??9#=#=L$*2SSF$*K550@0K0KD$*!BL!B&!B!BJ$"(+D z %%)  QJEE[`QRR//eUCCCCCCCCCCCsE00 E?>E?rYc Btj}tj}|jr |j|kr||jz dkr|jSg}ddd|gdd|gdddd|gfD]'}|d }tj|s tj |d d d |d d }|j d kr|j r|j r|j d}|ddD]j} tj|r tj||n|} n#t$$rYQwxYw|| kn #tjt*f$rY%wxYw||_||_||_|S)z9Return cached list of project files (refreshed every 5s).g@rgz--filesz--sortr=modifiedfdz--typefz--base-directoryrTrzutf-8r^)capture_outputrwtimeoutcwdencodingerrors Ni)rgetcwdtime monotonicrcrerdshutilwhich subprocessr returncodestdoutrVrFrzrrrr_TimeoutExpiredr) rfrnowfilesrtoolprocrpr%s r$_get_project_filesz(SlashCommandCompleter._get_project_files3sikkn   $$++d++c11# #90# 6 9c " 8S"4c :   C q6D<%%  !~4gi?a''DK'DKE-AEE- E E-EE--FFfilepathrc>|sdStj|}|}|}|}||krdS||rdS||vrdS||vrdSd}|D]&}|t |kr|||kr|dz }'|t |krTd}d}d} |D]1}|t |kr|||kr| dvr|dz }|dz }|} 2|t |d zkrd Sd SdS) z?Score a file path against a fuzzy query. Higher = better match.rrvPrurrr\z_-./g?#)rrzrrrWr) rrfilename lower_file lower_pathlower_qqir? boundary_hitsprevs r$ _score_pathz!SlashCommandCompleter._score_pathcss 17##H--^^%% ^^%% ++--  3   ) ) 2 j 2 j 2  ACLL  Q'"+%5%5a W  MBD  G $$gbk)9)9v~~%* !GBG s 222r2qrDc #K|}|s|d|D]}|d}tj|}|rdnd}|rdn=t tjtj|} td|d|t| || VdSg} |D]5}| ||} | d kr| | |f6| d | d|D]\} }|d}tj|}|rdnd}|rdn=t tjtj|} td|d|t| || r|d | n|VdS) z-Yield fuzzy file completions for bare @query.Nrfolderfilerr:r~rc$|d |dfS)Nrrr0)xs r$rz?SlashCommandCompleter._fuzzy_file_completions..sAaD5!A$-rDrz ) rrrrzrrr`rr)rrr_sort) rfrrrrfprrkindroscoredsr\s r$rz-SlashCommandCompleter._fuzzy_file_completionss8'')) FUFm  S))7++B//#)5xxv &uu,<GLLb11--!#OOrOO$'II:$!%  F ' 'B  U++A1uu q"g&&& // 000FUF^  EAr[[%%Fw''++H%1886D"55(8 RY[["--))DD2 #D z 04<__d___"       rDsub_text sub_lowerc #4K ddlm}|D]r}|d}||rS||krMt|t | ||ddp|ddVsdS#t $rYdSwxYw) z1Yield completions for /skin from available skins.r) list_skinsr-r.r3sourcer~N)hermes_cli.skin_enginerrWr)rrr)rrrrr-s r$_skin_completionsz'SlashCommandCompleter._skin_completionss  9 9 9 9 9 9Z\\  y??9--$)2C2C$(+H ~ $%&UU="%=%=%TxQSATAT       DD sBB BBc #dKd}|}|d}t|dkst|dkrp|sn|s|nd}|D]c}||r:||kr"t |t| |VddS|d}|dvrdS|rdn|d }|}t |r |ddn |dd } dd lm} dd l m } m } m } | }| |d d }| D]Y\}}}|| vs||s ||v}|dkr|r-|dkr|s6t |t| ||VZt| D]U}|| vs||s||v}|dkr|r)|dkr|s2t |t| |dVV|dpi}t|t rXt|D]J}|d}|| vs||s!t |t| |d|dVIdSdS#t"$rYdSwxYw)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). )r[disableenabler!rrr3rrN)rrr{)load_config_readonly)CONFIGURABLE_TOOLSETS_get_platform_tools_get_plugin_toolset_keysrF)include_default_mcp_serversrrr~zplugin toolset mcp_serversrz MCP server '')rFrrrWrr)rErrhermes_cli.tools_configrrrrrrGrHr)rrSUBSrtrailing_spacepartialr subcommand partial_loweralreadyrrrrrenabledts_keylabel_descis_onrserverrs r$_tools_completionsz(SlashCommandCompleter._tools_completionss-  !**3// u::??s5zzQ~&4>'--//22Usgmmoo7M7M$S#g,,PSTTTTTT F1X^^%% 2 2 2 F&5""E"I  >BeABBiiuQrT{CC;  > > > > > >          *)++F))&%UZ[[[G(=  $uW$$F,=,=m,L,L$')))e)**5* $'LL="!& !!9!9!;!;<<  W$$F,=,=m,L,L$')))e)**5* $'LL="!1 !**]339rK+t,, $[11  F &\\\F((0A0A-0P0P( $(+G } &%=F%=%=%=         FF s(E5J!! J/.J/c#|K|}|d}t|dkst|dkr|rdS|r|rdn|d}|} ddlm}|}|}n#t$rYdSwxYw|D]} | j} | |s | | } n#t$rd} YnwxYw| rt| ddr d | j nd } t| t| | | VdS) 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!rNr3r{r)load_gateway_configr-u→ zsend this session herer~)rFrrrgateway.configrget_connected_platformsrvaluerWget_home_channelgetattrr-r)) rrrrrrrgwrrr-homeros r$_handoff_completionsz*SlashCommandCompleter._handoff_completions&s  !**3// u::>>c%jjAoo.o F"DnD""59    : : : : : :$$&&B2244II    FF !  H>D??=11  **844    )-k'$2M2Mk%$)%%%SkD #G }!       s$9$B B,+B,C'' C65C6c #K ddlm}ddlm}m}t }d|r)d|kr#tdt| ddV| D]L\}}||r2||kr,t|t| |||VMdS#t$rYdSwxYw)z>Yield completions for /personality via hermes_cli.personality.rr)rdescribe_personalityrzclear personality overlayr~N) rrrrrr%rWr)rrmr)rrrrrr#r-rSs r$_personality_completionsz.SlashCommandCompleter._personality_completionsLsU  + + + + + +        ;<"!<  !. 3 3 5 5   f??9--$)2C2C$(+H ~ $%9%9&%A%A       DD sB;C CCc # K|j}|dsh||}|||Ed{VdS||}|||Ed{VdS|d}|d}t|dks*t|dkr~| drht|dkr|dnd}|} | |r| |Ed{VdSd|vrH|dkr| || Ed{VdS|dkr| || Ed{VdS|d kr||| Ed{VdS|d kr||| Ed{VdSd|vrk|t vrb||rMt |D]?} | | r(| | kr"t%| t| | V@dS|dd} t&D]q\} } || s| dd}|| r7t%||| t|  | | Vr|D]\} }| dd}|| rt/|d d}|ddt|dkrdndz}t|dg}t%||| t|  | d|d|d V|D]\} }| dd}|| rt/|d d}|ddt|dkrdndz}t%||| t|  | d| V ddlm}|D]\}}|| rt/|d d} | ddt| dkrdndz}t%||| t|  d|d| VdS#t8$rYdSwxYw)Nrrmaxsplitrr!r3z/skinz /personalityz/toolsz/handoffrr~r.z Skill bundler(rru▣ z (z skills)r|r}riru🔌 )text_before_cursorrWrrrrrFrrrrvrrrrrr'rjr)r%rmrrqrrrnrlrjr)rfdocumentcomplete_eventrwctx_word path_wordrbase_cmdrrrrrrrrr.r skill_countrjcmd_infos r$get_completionsz%SlashCommandCompleter.get_completionsps*s## 11$77H#44X>>>>>>>>>//55I$11)<<<<<<<<< F A &&8>>## u::>>c%jjAoo$--2D2Do#&u::>>uQxxrH ((I%%h// ::4@@@@@@@@@(""w&&#55h JJJJJJJJJF~--#<'>4CXCXYaCbCb'>&x0C~~i00SI5E5E(,/MM>$' FABBx!))  IC((-- 122wH""4((  ))(D99$'II:!% 113399;;  IC122wH""4(( !$((=."I"IJJ ("-#k:J:JR:O:OUWX !$((8R"8"899  ))(D99$'II:!K !K!Kk!K!K!K 2244::<<  IC122wH""4(( !$((=/"J"JKK ("-#k:J:JR:O:OUWX  ))(D99$'II:!4 !4!4   > > > > > >&9&9&;&;&A&A&C&C  "(&&t,,x||M;KLLMMD!%crcs4yy2~~ee2!NJ$--h==(+D z .H%9Z%9%9       DD s-B?U.. U<;U<r)rZr[r\r]r^r[rr?)rhrrr6)rrk)rrrrr)rrrrr6)rwr)rrrrrr)rwrrr9)r)rrrrrrY)rrrrrr)r)rrrrrr)rrrr)r?r@rArBrgrjrnrq staticmethodrtrvr frozensetrrrrrrrrrrrrrr'r0rDr$rYrYszTTVZ7;TX ' ' ' ' 'AAA\AQQQQ6666x!y!A!A!ABB\&\B0000\0d   \ TDTDTDTDTDl....`***\*X)))))V\ WWW\Wr###\#J!!!\!FrrrrrrDrYc&eZdZdZ d d d Zd ZdS) SlashCommandAutoSuggestzInline ghost-text suggestions for slash commands and their subcommands. Shows the rest of a command or subcommand in dim text as you type. Falls back to history-based suggestions for non-slash input. Nhistory_suggestAutoSuggest | None completerSlashCommandCompleter | Nonerr?c"||_||_dSr+)_history _completer)rfr-r/s r$rgz SlashCommandAutoSuggest.__init__s ( #rDcV|j}|ds$|jr|j||SdS|d}|d}t |dkr|ds|dd}ttt D]o}|j |j |s$|dd}||r,||kr&t|t |dcSpdSt |dkr|dnd} | } |j |j |re|j |D]J} | jr| j| j dn| j} | rt| cSK|j |j |sdS|t$vrbt$|rUd| vrQt$|D]C} | | r,| | kr&t| t | dcSD|jr|j||SdS)Nrrrrr!rr3)rrWr2get_suggestionrFrrrrr%r3rjr'rvrrrwrVr')rfbufferr rwrr$rrrrrr remainderrs r$r5z&SlashCommandAutoSuggest.get_suggestions*s## } F}33FHEEE4 A &&8>>## u::??4==#5#5? 8>>##DhC000 < <?.t7W7WX[7\7\.qrr7&&t,,<T1A1A%hs4yyzz&:;;;;;4 #5zzA~~5882NN$$  O '11(;; (#oHHNN 1 1 !0FJOZ-F,F,G,GHH6@o??$$1%i000001 ? &t/O/OPX/Y/Y &4 { " "{8'< "(""&x0??C~~i00?SI5E5E)#c(mmnn*=>>>>> = B=//AA AtrD)NN)r-r.r/r0rr?)r?r@rArBrgr5r0rDr$r,r,sN/326$$$$$:::::rDr,c tj|}n#t$rYdSwxYw|dkr|dS|dkr |dz ddS|dkr |dz dd S|dz dd S) z:Return a compact human-readable file size, or '' on error.r3iBiz.0fKi@z.1fMG)rrzgetsizer)rzsizes r$rr5 swt$$ rr d{{zzz k+$$$$$    +&-----() 0 0 0 00s " 00)rr)rr)r-rrr)rr,rr)r-r9rr6)r7r9rr6)rr<r+)rr,rOrPrr6)r4rrr6r()rrg)rrp)rxryrzrrry)rr~)rr)rrrr1)rr1)rrprrp)rrrr)rnrrr<rr)rvN) rrrrrr<rrrrrr)rv)rrrr)rrrr<rr)rr<rr )rK)rLrrr~)rr$)rzrrr)srB __future__rloggingrrerrrcollections.abcrr dataclassesrrtypingrr r r utilsr hermes_constantsr rrCr% getLoggerr?rprompt_toolkit.auto_suggestr&r'prompt_toolkit.completionr(r) ImportErrorobjectr,r*rGr`rrrrr#r%_cmdr8r-r2_aliasr.r&rr/_catr'r5r[r)compile _PIPE_SUBS_RErMr4rmgrouprFr.r4r6r9r;rNrSrXrfr0rtrrrrr}rrrrrr_TG_NAME_LIMITrrrrr_clamp_telegram_namesrrr r'rDr:r9rBrHrCr;rJrTrWrYr,rr0rDr$rUs#"""""  --------((((((((------------!!!!!!------     8  8 $ $ CCCCCCCC?????????KIJJJJ  $********\'0i555''|&JwJI jwPPP|&JuH)!X45JJJ |&JwF  ,CEEE|&Jw> |&JxQS\|&Jy5y|&JvQS\=???|&"JwBINN#|&$JxWYb(8,PPP%|&(JvG   )|&,Jw=y!###-|&0Jycen%6661|&4JxPR[ H6665|&8JzPR[(M35559|&>JzFHQ#/_aaa?|&BJztv+---C|&FJzUW`i;XZZZG|&JJxZ\k(FHHHK|&NJxK_(JLLLO|&RJv> 46KKKS|&VJwXZc ,<%'''W|&\Jy? ,>JXXX]|&`JvTV_ ,<*VVVa|&dJ|=y$ TTTe|&hJx?!z;;;i|&lJy>">75777m|&tJwNPY%G===u|&zJwXZc#'SSS{|&~JvXZcA%F<<<|&DJ{Z\e*iA%'''E|&LJxY[d/111M|&PJvPR[%q%F<<5777Q|&VJ{A?B[\\\W|&\Jvln}:PRRR]|&bJv>222c|&fJ{?(ICHH5E,F,F(I(I(I+---g|&lJw+_.kmmm|&DJxU>R &'''E|&VJxIK[W|&ZJ|=?O&((([|&^J a);===_|&bJy}@P(IEGGGc|&hJyC$000i|&pJzG H*)+++q|&vJvjlrAK%1DFFFw|&zJyH&*666{|&~JyUW` j:::|&BJwfhn,...C|&FJ~QSYl444G|&JJwQSYZZK|&LJz>!###M|&PJ{Dfl444Q|&TJzNPV ,HJJJU|&XJvF 444Y|&\JwDf]|&`JwH&222a|&dJxDf%'''e|&hJy5vv%y:::i|&lJwZ\b')))m|&tJvSU[i<IIIu|&||||F*?)>)@)@@@@@9999 TTD  T$6$6t$<$<TY!l T TF(,(8%S%Sty%S%S%SH\\\ " "354444 88D  8#..t}bAA (TY 9___l 8 8F!),f,,!7DV  %' &&&& >>D >'+tD,<'='= O OO$  6 6     122 11D di//C kT^,,A1771::++C00 C*333333**42;;;(;;;22 L L L LPPPP.:      ---- &@L')#!$;;;<5555%%%%P@@@@  1 1 1 12=!BJ}--!rz(++    $$$$P-37 z1z1z1z1z1B I I I I IF