A .gif uploaded as a document never matches the animation branch, so it
went to discord untouched and came back 413. First real test of the local
api server hit exactly this: a 27.2 MB gif fetched fine, then bounced.
Same ladder, same .gif out — that file lands at 5.73 MB.
Co-Authored-By: Claude Opus 5 <[email protected]>
The cloud api refuses getFile over 20 MB, so an oversize video or gif never
reached ffmpeg and the bridge blamed the fetch. Six of the nine media
failures in the last month were that; the other three were a dropped read.
- config.local_api() turns TELEGRAM_API_BASE_URL into base_url/base_file_url/
local_mode. Both directions read it, or only one of them migrates.
- in local mode getFile hands back a path on disk and ptb reads it directly,
so there is no 20 MB cap and no http transfer to drop.
- MAX_INGEST_BYTES keeps that from being a way to pull a gigabyte into the
bot's memory; falls back to stat() when the server omits file_size.
- explicit read_timeout: ptb defaults to 5s, which is what "Timed out" was.
one retry covers a dropped read. BadRequest subclasses NetworkError, so it
is re-raised first or an oversize rejection gets re-sent.
- the note now distinguishes too-large from could-not-fetch, and the warning
records which attachment and which message.
Co-Authored-By: Claude Opus 5 <[email protected]>
fixes that were dropping messages:
- d->tg sent parse_mode=Markdown with an unescaped body, so any message
with a stray * _ ` or [ got a 400 from telegram and vanished. now html
with proper escaping + a plain-text retry
- no allowed_mentions on webhook posts, so telegram could @everyone
- forwarder.start() ran from on_ready, which fires again on every gateway
reconnect -> second poller on the same token -> 409s and dupes
- document.mime_type is nullable and was called directly
- sticker finally block hit UnboundLocalError when mkstemp raised
- ffmpeg timeouts leaked temp files and orphaned the process
stickers, per format instead of one blanket gif convert:
- static .webp now passes through (the gif convert crushed 228 alpha
levels to 2 and made the file 4x bigger)
- video .webm -> animated webp, keeps 8-bit alpha, ~7x smaller than gif.
needs -c:v libvpx-vp9 before -i or ffmpeg silently drops the alpha
- .tgs is gzipped lottie, ffmpeg exits 183 on it and we were uploading
the raw file. renders via optional lottie lib, else thumbnail + emoji
added: telegram profile photos as webhook avatars (re-hosted in a private
channel, AVATAR_CACHE_CHANNEL_ID), reply threading both ways, edit sync
both ways, delete sync d->tg, album batching, voice/poll/location/contact/
dice/forward attribution, utf-16-safe entity conversion, mention and custom
emoji resolution, message splitting instead of truncation, shared aiohttp
session with 429 backoff, route discovery from env, !bridge status
main.py just loads the extension now; routes come from credentials.env
Co-Authored-By: Claude Opus 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01RXrxDFpyq3VjvxWGuW3CZe
esefandClaude Opus 5