Changelog

All notable changes to Hermes Relay will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[3.0.0] - 2026-06-16

Async Architecture: Migrated from Flask to Quart (async) for better concurrency and lower latency
HTTP/2 Connection Pooling: httpx with HTTP/2 enabled for Telegram API calls
Disk Caching: diskcache layer for health check responses (60s quick, 5min detailed)
Configurable Thread Pool: Increased ThreadPoolExecutor workers from 4 to 8 (configurable via HERMES_RELAY_THREAD_WORKERS)
Environment Variable Configuration: Removed all hardcoded paths and tokens; now fully configurable via environment variables
Circuit Breaker Pattern: Resilient external calls with automatic recovery (5 failures → 60s recovery)
Graceful Lifecycle: Startup/shutdown handlers for proper resource cleanup
Agent Pre-warming: Background thread pre-initializes Hermes agent on startup for zero-latency first query
Dual Health Endpoints: Quick (cached, no LLM) and deep (detailed checks) health endpoints
Pinned Dependencies: All requirements.txt dependencies now pinned for reproducible builds

Version: Updated to 3.0.0 in health endpoints
Mode: Changed from "python-import" to "async-quart" in health responses
Telegram Integration: Rewired to use async HTTP client with connection pooling and circuit breaker
Agent Initialization: True warm agent - initialized once, reuses across queries, only reinitializes on route signature change
Logging: Structured logging with configurable log level

Hardcoded Secrets: Removed hardcoded Telegram token and channel from source code
Resource Leaks: Proper cleanup of thread pools, HTTP clients, and cache on shutdown
Race Conditions: Thread-safe agent initialization with double-checked locking