docs: priority list now guarantees skill commands a Telegram menu slot
This commit is contained in:
@@ -1225,8 +1225,11 @@ platform_toolsets:
|
||||
# # append = Hermes defaults first, then user priority
|
||||
# # replace = only the list below defines priority
|
||||
# priority_mode: prepend
|
||||
# # Priority is applied across core + plugin + skill commands before
|
||||
# # the cap, so a listed skill command always keeps a menu slot.
|
||||
# priority:
|
||||
# - my_plugin_command
|
||||
# - my-important-skill
|
||||
# slack:
|
||||
# extra:
|
||||
# # Render live tool calls as Slack-native plan/task cards. This explicit
|
||||
|
||||
@@ -83,7 +83,7 @@ Notes:
|
||||
|
||||
Hermes registers its command menu automatically when the Telegram gateway starts. The menu is built from the central slash-command registry plus eligible plugin/skill commands, then capped so Telegram accepts the payload reliably. The default cap is 60 commands — enough to keep all built-in commands plus common skill commands visible.
|
||||
|
||||
If you have local or plugin commands that should stay visible in Telegram's `/` picker, prioritize them in `~/.hermes/config.yaml`:
|
||||
If you have skill, plugin, or built-in commands that should stay visible in Telegram's `/` picker, prioritize them in `~/.hermes/config.yaml`:
|
||||
|
||||
```yaml
|
||||
platforms:
|
||||
@@ -94,6 +94,7 @@ platforms:
|
||||
priority_mode: prepend # prepend | append | replace
|
||||
priority:
|
||||
- my_plugin_command
|
||||
- songsee # skill commands work here too
|
||||
```
|
||||
|
||||
`priority_mode` controls how your list combines with Hermes' built-in priority list:
|
||||
@@ -102,6 +103,8 @@ platforms:
|
||||
- `append`: keep Hermes defaults first, then your commands
|
||||
- `replace`: use only your list for priority ordering
|
||||
|
||||
Priority is applied to the **combined** candidate list (core commands, plugin commands, and skill commands) before the cap is enforced — so a prioritized skill command is guaranteed a menu slot even when core commands alone would fill the menu. Previously skills were always trimmed first and alphabetically, so late-alphabet skills could never appear regardless of `priority`.
|
||||
|
||||
Telegram allows up to 100 BotCommands, but large command payloads can fail. Hermes defaults to 60 for reliability and clamps configured values to `1..100`; use `/commands` for the full command list.
|
||||
|
||||
## Step 3: Privacy Mode (Critical for Groups)
|
||||
|
||||
Reference in New Issue
Block a user