hermes-agent/tools
teknium1 69aa35a51c Add messaging platform enhancements: STT, stickers, Discord UX, Slack, pairing, hooks
Major feature additions inspired by OpenClaw/ClawdBot integration analysis:

Voice Message Transcription (STT):
- Auto-transcribe voice/audio messages via OpenAI Whisper API
- Download voice to ~/.hermes/audio_cache/ on Telegram/Discord/WhatsApp
- Inject transcript as text so all models can understand voice input
- Configurable model (whisper-1, gpt-4o-mini-transcribe, gpt-4o-transcribe)

Telegram Sticker Understanding:
- Describe static stickers via vision tool with JSON-backed cache
- Cache keyed by file_unique_id avoids redundant API calls
- Animated/video stickers get emoji-based fallback description

Discord Rich UX:
- Native slash commands (/ask, /reset, /status, /stop) via app_commands
- Button-based exec approvals (Allow Once / Always Allow / Deny)
- ExecApprovalView with user authorization and timeout handling

Slack Integration:
- Full SlackAdapter using slack-bolt with Socket Mode
- DMs, channel messages (mention-gated), /hermes slash command
- File attachment handling with bot-token-authenticated downloads

DM Pairing System:
- Code-based user authorization as alternative to static allowlists
- 8-char codes from unambiguous alphabet, 1-hour expiry
- Rate limiting, lockout after failed attempts, chmod 0600 on data
- CLI: hermes pairing list/approve/revoke/clear-pending

Event Hook System:
- File-based hook discovery from ~/.hermes/hooks/
- HOOK.yaml + handler.py per hook, sync/async handler support
- Events: gateway:startup, session:start/reset, agent:start/step/end
- Wildcard matching (command:* catches all command events)

Cross-Channel Messaging:
- send_message agent tool for delivering to any connected platform
- Enables cron job delivery and cross-platform notifications

Human-Like Response Pacing:
- Configurable delays between message chunks (off/natural/custom)
- HERMES_HUMAN_DELAY_MODE env var with min/max ms settings

Warm Injection Message Style:
- Retrofitted image vision messages with friendly kawaii-consistent tone
- All new injection messages (STT, stickers, errors) use warm style

Also: updated config migration to prompt for optional keys interactively,
bumped config version, updated README, AGENTS.md, .env.example,
cli-config.yaml.example, install scripts, pyproject.toml, and toolsets.
2026-02-15 21:38:59 -08:00
..
__init__.py Add Text-to-Speech (TTS) functionality with multiple providers 2026-02-12 10:05:08 -08:00
browser_tool.py Enhance browser tool functionality and cleanup process 2026-02-09 04:36:37 +00:00
cronjob_tools.py Enhance CLI with multi-platform messaging integration and configuration management 2026-02-02 19:01:51 -08:00
file_operations.py Update default model to 'anthropic/claude-opus-4.6' and refine terminal working directory settings 2026-02-08 12:56:40 -08:00
file_tools.py Add kill_modal script to manage Modal applications and better handling of file and terminal tools 2026-02-12 05:37:14 +00:00
fuzzy_match.py Add file manipulation tools and enhance setup scripts 2026-02-05 03:49:46 -08:00
image_generation_tool.py Enhance batch processing and image generation tools 2026-01-18 10:11:59 +00:00
mixture_of_agents_tool.py Enhance logging and tool initialization for improved performance 2026-01-29 19:59:59 +00:00
patch_parser.py Add file manipulation tools and enhance setup scripts 2026-02-05 03:49:46 -08:00
rl_training_tool.py Update dependencies and enhance installation scripts 2026-02-07 00:05:04 +00:00
skills_tool.py Enhance skills tool to have an arg so it is more reliably called, and error handling in agent 2026-02-03 15:26:59 -08:00
terminal_hecate.py Update environment configuration and enhance terminal tool integration 2026-01-23 12:26:53 +00:00
terminal_tool.py Add Text-to-Speech (TTS) functionality with multiple providers 2026-02-12 10:05:08 -08:00
transcription_tools.py Add messaging platform enhancements: STT, stickers, Discord UX, Slack, pairing, hooks 2026-02-15 21:38:59 -08:00
tts_tool.py Enhance TTS tool to support platform-specific audio formats 2026-02-14 16:13:26 -08:00
vision_tools.py Enhance image handling and analysis capabilities across platforms 2026-02-15 16:10:50 -08:00
web_tools.py Add a claude code-like CLI 2026-01-31 06:30:48 +00:00