+ jHjVxa0t$Rt^RIHt^RIt^RIt^RIHtHtH t ^RI H t ^RI H t ^RIHtHtHtHt]P&!R4t^ t]P,!R4t]P,!R 4tR R ltR R ltRRlt]P,!R4tRRltRRltRRltRR/RRllt ^R,R-llt,R.R/lt-^2t.^ t/]P,!R04t0]1!0R?m4t2]1!0R@m4t3R1R2lt4R3R4lt5RAR5R6llt6R7R8lt7R#)Bz]Gateway platform command derivations (Telegram / Discord / Slack) from ``COMMAND_REGISTRY``. ) annotationsN)CallableMappingSequence)Any)t)COMMAND_REGISTRY_is_gateway_available_iter_plugin_command_entries_resolve_config_gateszhermes_cli.commandsz [^a-z0-9_]z_{2,}cV^8dQhRR/#)returnlist)formats"B/home/ubuntu/.hermes/hermes-agent/hermes_cli/commands_platforms.py __annotate__rsVVTVcr\4p\Uu.uFp\W4'gKVNK up#uupi)zFRegistry entries visible on gateway surfaces (config gates read once).)r rr ) overridescmds r_gateway_available_commandsrs.%'I+ U+C/DS/TCC+ UU Us44c V^8dQhRRRR/#)r args_hintstrrboolr)rs"rrrs--#-$-rc@VP4PR4#)z?True when selecting a command without text would be incomplete.<)strip startswith)rs&r_requires_argumentr!s ??  ' ' ,,rc V^8dQhRRRR/#r rawrrr)rs"rrr#s : : : :rc|VP4PRR4p\PRV4p\;QJd/R\P V44F 'gK RM$ RM !R\P V444'dR#\ PRV4PR4#)uTelegram allows only ``[a-z0-9_]``: lowercase, hyphens -> ``_``, collapse/strip ``_``. A name that would lose letters (``中文helper`` -> ``helper``) is omitted (``""``): the menu entry could not resolve back to the registered ``/中文helper`` and would answer "Unknown command".-_c3@"TFqP4xK R#5iN)isalnum).0chs& r *_sanitize_telegram_name..*s E"DB::<<"DsTF)lowerreplace_TG_INVALID_CHARSsubanyfindall_TG_MULTI_UNDERSCOREr)r$lowerednames& r_sanitize_telegram_namer9#s iik!!#s+G  W -D s E"3";";G"D Esss E"3";";G"D EEE  # #C . 4 4S 99ru[‒–—―−]c V^8dQhRRRR/#)r descrrr)rs"rrr2s%%3%3%rc.\PRV4#)zFold Unicode dashes (em/en/figure/horizontal-bar/minus) to ASCII ``-``. BotFather rejects setMyCommands descriptions containing them (#2925).r&) _TG_DASHESr3)r;s&r_normalize_telegram_descr>2s >>#t $$rc$V^8dQhRRRRRR/#)r r;rlimitintrr)rs"rrr8s&DDDSDSDrcL\V4V8:dV#VRV^, R,#)z>Clamp a menu description to *limit* chars with a ``...`` tail.Nz...)len)r;r@s&&r_truncate_descrD8s(t9%4C4 +;e+CCrc$V^8dQhRRRRRR/#)r entrieszSequence[tuple[str, ...]]reservedset[str]rzlist[tuple[str, ...]]r)rs"rrr=s$ &2:?Trc@\V4p.pVFvrEp\V4\8dDVR\pWr9d3VR\^, p\^ 4Fp V V 2pWr9gKM KZTpWB9dKdVP V4VP WE.VO54K V#)aEnforce the 32-char Telegram/Discord name limit: over-long names are truncated; on a collision with *reserved* or an earlier entry a 31-char prefix + digit ``0``-``9`` is tried, then the entry is silently dropped. Duplicates are dropped; extra tuple elements pass through. N)setrC_CMD_NAME_LIMITrangeaddappend) rFrGusedresultr8r;extra candidateprefixdigits && r_clamp_command_namesrU=s ]DF%U t9 &-o.I 223"2YE#)(5' 2I ,' D <   t*E*+& Mrinclude_pluginsTc V^8dQhRRRR/#)r rVrrzlist[tuple[str, str]]r)rs"rrrZsssds>Ssrc ~\4Uu.uFqPVP43NK ppV'd=T\4UUUu.uFwr4p\ V4'dKW43NK uppp, pVUUu.uF'wrg\ V4;p'gKV\ V43NK) upp#uupiuupppiuuppi)a(command_name, description) pairs for Telegram setMyCommands: sanitized canonical names only (no aliases). Built-ins needing arguments are included (their handlers show usage when selected bare); plugin commands needing arguments are excluded (may lack a no-arg fallback).)rr8describer r!r9r>) rVrpairsndhintr8r;tgs $ rtelegram_bot_commandsr_Zs4O3P Q3PChh  '3PE Q +G+I3+IZQ4+D11&+I3 3CH r5ZTSjkoSpMpRMp 0R)$/ 05 rr R3 rs$B- B2 %B2 <B9B9prependrNr1zdict[str, tuple[str, ...]]_TELEGRAM_PRIORITY_TIERScV^8dQhRR/#)r rdict[str, Any]r)rs"rrrxs~rc^RIHpV!4;'g/pRF,p\V\4'dVP V4MRpK. \V\4'dTM/p\ VP R\44p\VP R4;'gR4P4P4pVP R4p\V\4'd=VUu.uF/p\V4P4'gK$\V4NK1 ppM1\V\4'dVP4'dV.M.pR\^\\ V44RV\"9dVRV/#RRV/# \d/pELi;i \\3d \pEL2i;iuupi)zONormalized ``platforms.telegram.extra.command_menu`` config with safe defaults.)read_raw_configN max_commands priority_moder`priority) platformstelegramrQ command_menu)hermes_cli.configre Exception isinstancergetrA#_DEFAULT_TELEGRAM_MENU_MAX_COMMANDS TypeError ValueErrorrrr0rmaxmin_TELEGRAM_BOT_API_MAX_COMMANDSra) renodekeymenu_cfgrfrg raw_priorityitemrhs r_telegram_command_menu_configr{xs5#%++B *4 9 9txx}tB*4T7*C*C$H;8<<8[\]  _5BBCIIKQQSM<< +L,%%*6L,$#d)//:KICI,L%/ c%B%B|GYGYG[G[L>acAs#A<PQ-;S*SH YbH   z ";: ; Ms4F F &F0!F;F; FFF87F8cV^8dQhRR/#)r rrAr)rs"rrrs@@C@rc6\\4R,4#)z@Return configured Telegram BotCommand menu cap with safe bounds.rf)rAr{rrrtelegram_menu_max_commandsr~s ,.~> ??rc V^8dQhRRRR/#)r raw_namesz Sequence[str]rzdict[str, int]r)rs"rrrs}rc/pVF6p\\V44pV'gK!W19gK)\V4W&K8 V#)zUname -> rank for the deduped, Telegram-sanitized *raw_names* (first occurrence wins).)r9rrC)rrankr$r8s& r_sanitized_rankrs;D&s3x0 4D$TDJ Krc V^8dQhRRRR/#)r candidateslist[tuple[str, str, str, str]]rr)rs"rrrs YY/Y4SYrcaaaa\4p\VR,4o\\4o\VR,,oRVVV3Rllo\ \ V4V3RlR7UUu.uFwr#VNK upp#uuppi)zOrder ``(final_name, description, source, raw_name)`` candidates; the default priority applies to core only, "replace" mode ignores it. ``raw_name`` is the pre-clamp name so a configured long command stays addressable.rhrgc$V^8dQhRRRRRR/#)r stable_indexrArRztuple[str, str, str, str]rztuple[int, int, int]r)rs"rr:_prioritize_telegram_menu_candidates..__annotate__s#--C-,E-J^-rc<Vwr#rERS PVS PV44RVR8XdS PV4MR/p\S 4FwrxWh,fKWvV,V3u# \S 4^V3#) configureddefaultcoreN)ro enumeraterC) rrR final_name_descsourceraw_nameindexestiertableconfigured_rank default_ranktierss && r_rank3_prioritize_telegram_menu_candidates.._ranks.7+ 6 /--h8K8KJ8WX v7G|'' 3TS%U+KD~)enl;;,E A|,,rc<S!V!#r*r)rzrs&r6_prioritize_telegram_menu_candidates..s %QU,r)rw)r{r_TELEGRAM_MENU_PRIORITYrasortedr)rrx_icrrrrs& @@@@r$_prioritize_telegram_menu_candidatesrsk -.H%hz&:;O"#:;L $Xo%> ?E--")J"7=VW XW%"AW XX Xs, A=cV^8dQhRR/#)r platformrr)rs"rrrs,?,?3,?rc#>a"^RIHp^RIHp^RIHpHpHp^RIH pV!VR7pVR, P4pVP4.p WE3F8p V !4F)p V PV!V 4P44K+ K: V!4p \V 4Fp W,pVPRR4pV'gK'V!V4P4oSP!V4'dKV\#V3R lV 4R 4pVeVPR R4V9dKWSP$P'V4P(3xK R # \d\4pELIi;i \dEK&i;i \dEKDi;i5i) a7Yield ``(cmd_key, info, rel_parts)`` for skills eligible as gateway slash commands. Scan roots: ``SKILLS_DIR`` plus ``skills.external_dirs`` / trusted project skills dirs; anything elsewhere or under ``SKILLS_DIR/.hub`` is skipped, as are skills disabled for *platform*. Paths are resolved on both sides (symlinked roots still match) and matched per path component (``/my-skills`` never admits ``/my-skills-extra``). ``rel_parts`` is the skill dir relative to its root (``("creative", "ascii-art")``). Alphabetical so first-wins collision handling is deterministic. )Path)get_skill_commands)get_disabled_skill_namesget_external_skills_dirsget_project_skills_dirs) SKILLS_DIR)rz.hub skill_md_pathr(c3Z<"TF pSPV4'gKVxK" R#5ir*)is_relative_to)r,rsps& rr.'_iter_gateway_skills..s >1):):1)=QQs+ +Nr8)pathlibragent.skill_commandsragent.skill_utilsrrrtools.skills_toolrrmrJresolverNrrornextparent relative_toparts)rrrrrrrdisabledhub_dirrootsgetterr\ skill_cmdscmd_keyinfo skill_pathrootrs& @r_iter_gateway_skillsrsr7UU,+X>F"++-G    ! "E+E XLLa!23F$%J*%"XXor2   *  % % '  W % % >>E <488FB/8; RYY2248>>>>& 5!   swF E.F F $%E7 F  A)F7A$FE40F3E44F7 FF FF  FFFFc 0V^8dQhRRRRRRRRR R R R /#) r rr max_slotsz int | Nonereserved_namesrH desc_limitrA sanitize_namezCallable[[str], str] | Nonerz+tuple[list[tuple[str, str, str, str]], int]r)rs"rrrsF.R.R.R(.R:B.RPS.R..R1.Rrclaaaa T;'gRo RVVV 3RllpV3RlpV!V!44pSPRV44V!R\S444pVf Wx,^3#\^V\V4, 4p \^\V4V , 4p WxRV ,RVV 3#)uECollect plugin + skill entries for a gateway platform. Plugin slash commands come first and are never trimmed; skill commands (alphabetical) fill the remaining *max_slots* (``None`` = every candidate, caller caps). *reserved_names* is mutated in place as names are claimed; *sanitize_name* runs before clamping and may return "" to skip. Returns ``(entries, hidden_count)``, entries ``(name, description, cmd_key, raw_name)`` — ``cmd_key`` "" for plugins; ``raw_name`` is the sanitized pre-clamp name used for configured-priority matching (both survive a clamp-induced rename). cV#r*r)r[s&rr0_collect_gateway_skill_entries..s1rcV^8dQhRR/#)r rrr)rs"rr4_collect_gateway_skill_entries..__annotate__s 9 99 9rc<.pVF6wr#pS!V4;p'gKVPV\VS4WE34K8 \VS4# \dLi;i)zSanitize + truncate ``(raw_name, description, cmd_key)`` rows, then clamp against ``reserved_names``; any failure in the lazy source yields the rows collected so far.)rNrDrmrU) rowsoutr$r;rr8rrsanitizes & r_entries0_collect_gateway_skill_entries.._entriessm02 &*"7#C=(4((JJnT:&FVW'+ $C88   sA "A AAc3&<"^RIHpV!4p\V4FopW,pSR8Xd6\\ VP R4;'gR44'dKGY#P R4;'g \ R4R3xKq R#5i))get_plugin_commandsrjrr( descriptionz slash.shared.plugin_command_descN)hermes_cli.pluginsrrr!rror)r plugin_cmdscmd_namemetars r _plugin_rows4_collect_gateway_skill_entries.._plugin_rowssx:)+ {+H(D:%*.s<^ !^sc3p"TF,wrpVPR4VPRR4V3xK. R#5i)/rr(N)lstripro)r,rr_rels& rr.rs8C#A G4  dhh}b97C#As46N)updaterrsrC) rrrrrrrplugin_entries skill_entries remaining hidden_countrs f&ff& @r_collect_gateway_skill_entriesrs--H 9 9aln-N<^<<C#7#ACCM-q00Ay3~#667Iq#m,y89L :I6 6  C\ QQrc V^8dQhRRRR/#)r rfrArz!tuple[list[tuple[str, str]], int]r)rs"rrrs///7X/rc \\RR74p\RRVUUu0uFwr#VkK upp^(\R7wrEVUUu.uF wrgWgRV3NK pppTVUUU U u.uFwrgrYgV 'dRMRV 3NK up p pp, p\ V4p\ ^\ V4V, 4p VRVUUU U u.uFwrgrV\V43NK pp ppp WV ,3#uuppiuuppiuup p ppiuup p ppi) u``(menu_commands, hidden_count)`` for Telegram, capped to the Bot API limit. Tier order: core CommandDefs, plugin slash commands, skill commands (alphabetical; hub and telegram-disabled skills excluded). Tiers keep relative order unless named in ``platforms.telegram.extra.command_menu.priority`` — applied *before* the cap, so a prioritized dynamic command can displace an unprioritized core command.F)rVrjN)rrrrrrskillplugin)rr_rr9rrsrCr>)rf core_commandsr[r'rFrr8r;rrr$overflow_count_source _raw_namemenus& rtelegram_menu_commandsrs .uEFM:t=G@MM}4vt,}JM3:<3:/t77#F3:<= 2 levels under a scan root (``creative/ascii-art/SKILL.md``) group under ``categories[top_level]``; root-level skills are *uncategorized*. Entries are ``(name, description, cmd_key)``, names clamped to 32 chars, descriptions to 100. No per-group cap (the caller flattens into one autocomplete callback); ``hidden_count`` only reports 32-char clamp collisions against reserved names or earlier skills. 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. 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). z discordr:N NuDiscord /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() dictfromkeysrrrologgerwarningrDrC setdefaultrNrm) r categories uncategorized names_usedhiddenrr rel_parts discord_namepriorentrys & r"discord_skill_commands_by_categoryr/s5,9;J02M"&~|!LJ F (>#.s3LNN<0E $- !< 9"* L 9 ! '.| $!>$((="2Ms#SU\]E9~"%%ilB7>>uE$$U+9)H> f ,,    sC5D D%$D%z [^a-z0-9_\-]c V^8dQhRRRR/#r#r)rs"rrrsUUcUcUrcv\PRVP44PR4R\#)zKLowercase, strip chars outside ``[a-z0-9_-]`` and edge ``-_``, clamp to 32.r(z-_N)_SLACK_INVALID_CHARSr3r0r_SLACK_NAME_LIMIT)r$s&r_sanitize_slack_namer s/  # #B 4 : :4 @ASBS TTrcV^8dQhRR/#)r rzlist[tuple[str, str, str]]r)rs"rrrs8rc \4pVUu.uF3qPVP4VP;'gR3NK5 ppTVUUu.uFRqPF@pT\ RVPVP4R7VP;'gR3NKB KT upp, pT\ 4UUUu.uFwrEqdYV;'gR3NK uppp, pR\ R4R3.pR0pVF}wrEp\V4p V 'd1W9g+V \9g V \9g\V4\8dKKVPWR,VR,34VPV 4K V#uupiuuppiuupppi) aZ(slash_name, description, usage_hint) triples for Slack: every gateway-available command (canonical names first so they win slots at the cap, then aliases, then plugins) becomes a standalone slash, deduped and clamped to the 50-command cap; Slack built-ins and _SLACK_VIA_HERMES_ONLY are skipped. ``/hermes`` is always first for anything dropped.r(zslash.shared.slack_alias_for)r8rhermeszslash.hermes.descriptionz[subcommand] [args]:NN:NdN)rr8rYraliasesrr r _SLACK_RESERVED_COMMANDS_SLACK_VIA_HERMES_ONLYrC_SLACK_MAX_SLASH_COMMANDSrNrM) availablerwantedaliasr8r;r]rFseen slack_names rslack_native_slashesrsk ,-IIR S#xx)<)<"=F S 09T09{{eq7chhTWT`T`Tbc ##%GR%09TTF @\@^_@^, "/command" for the Slack ``/hermes`` handler, plugin commands included.r)rr8rr r)rr8mapping _description _args_hints rslack_subcommand_mapr.s/0W0Chh=U=UT $j=U 0 W+G*H&J41TF,+I N Ws.A*)rr)rr)r)helpnewstopstatusegressresumesessionsmodeldebugrestartrverbosecommandsapprovedenyqueuesteerbgbtw reasoningr'rirprofilewhoami)rN)r>medndmsgprowhoawayfeedjoinmuteopenleaveshrugtopicexpandremindsearchr2collapse shortcuts>moadiffinitr7loginpausetopupr3refinereviewrrCdiscardversioninsightsr autoprune heartbeat)z)https://hermes-agent.local/slack/commands)8__conditional_annotations____doc__ __future__rloggingrecollections.abcrrrtypingr agent.i18nrhermes_cli.commandsrr r r getLoggerrrKcompiler2r6rr!r9r=r>rDrUr_rprura__annotations__rr{r~rrrrrrrr r  frozensetrrr rr(r.)rcs@rrps`# 77bb   0 1JJ}-zz(+V - :ZZ: ; % D :sTs')#!$((4M 8 4 H4@ Y2,?^.Rb/*<-Hzz/2$&LM#$U 4 5r