hermes-agent/website/docs/user-guide
Teknium b4496b33b5
fix: background task media delivery + vision download timeout (#3919)
* feat(telegram): add webhook mode as alternative to polling

When TELEGRAM_WEBHOOK_URL is set, the adapter starts an HTTP webhook
server (via python-telegram-bot's start_webhook()) instead of long
polling. This enables cloud platforms like Fly.io and Railway to
auto-wake suspended machines on inbound HTTP traffic.

Polling remains the default — no behavior change unless the env var
is set.

Env vars:
  TELEGRAM_WEBHOOK_URL    Public HTTPS URL for Telegram to push to
  TELEGRAM_WEBHOOK_PORT   Local listen port (default 8443)
  TELEGRAM_WEBHOOK_SECRET Secret token for update verification

Cherry-picked and adapted from PR #2022 by SHL0MS. Preserved all
current main enhancements (network error recovery, polling conflict
detection, DM topics setup).

Co-authored-by: SHL0MS <SHL0MS@users.noreply.github.com>

* fix: send_document call in background task delivery + vision download timeout

Two fixes salvaged from PR #2269 by amethystani:

1. gateway/run.py: adapter.send_file() → adapter.send_document()
   send_file() doesn't exist on BasePlatformAdapter. Background task
   media files were silently never delivered (AttributeError swallowed
   by except Exception: pass).

2. tools/vision_tools.py: configurable image download timeout via
   HERMES_VISION_DOWNLOAD_TIMEOUT env var (default 30s), plus guard
   against raise None when max_retries=0.

The third fix in #2269 (opencode-go auth config) was already resolved
on main.

Co-authored-by: amethystani <amethystani@users.noreply.github.com>

---------

Co-authored-by: SHL0MS <SHL0MS@users.noreply.github.com>
Co-authored-by: amethystani <amethystani@users.noreply.github.com>
2026-03-30 02:59:39 -07:00
..
features feat: add MCP server mode — hermes mcp serve (#3795) 2026-03-29 15:47:19 -07:00
messaging fix(docs): escape angle-bracket URLs in feishu.md breaking MDX build (#3902) 2026-03-30 00:09:30 -07:00
skills feat: add godmode jailbreaking skill + docs (#3157) 2026-03-26 01:37:18 -07:00
_category_.json feat: add documentation website (Docusaurus) 2026-03-05 05:24:55 -08:00
checkpoints-and-rollback.md docs: update checkpoint/rollback docs for new features 2026-03-16 04:56:22 -07:00
cli.md feat: config-gated /verbose command for messaging gateway (#3262) 2026-03-26 14:41:04 -07:00
configuration.md fix: background task media delivery + vision download timeout (#3919) 2026-03-30 02:59:39 -07:00
docker.md feat(docker): add Docker container for the agent (salvage #1841) (#3668) 2026-03-28 22:21:48 -07:00
git-worktrees.md docs: fix stale and incorrect documentation across 18 files 2026-03-24 07:53:07 -07:00
profiles.md docs: fix profile alias naming and improve quick start 2026-03-29 10:51:51 -07:00
security.md docs: document credential file passthrough and env var forwarding for remote backends (#3677) 2026-03-29 00:16:34 -07:00
sessions.md docs: document 9 previously undocumented features 2026-03-24 08:56:21 -07:00