+ kHj޿ aRt0tRt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI t ^RI t ^RIHt^RIHtHtHt^RIHtHtHtHtHtHtHtHt^RIHt]P<!]4t ^RI!H"t"^RI#H$t$^RI%H&t'H(t)H*t+H,t-R R lt.R R lt/R RRRRR/RRllt0RRlt1RRlt2^RI3H4s4H5s5H6s6H7s7H8s8^RI3H9s9^RI;Hs>H?s?H@sAHBsBHCsCHDsD^RIEHFsFHGsG^RIHHIsIRsJ^RILtL^R IMHNtO]LPP^]R!]O!]S4P4P^,44^R!IVHWtW^R"IXHYtYHZtZ^R#I[H\t\H]t]^R$I^H_t_H`t`HataHbtbHctcHdtdHeteHftfHgtgHhthHitiHjtjHktkHltl^tmR%tnR&R'ltoR(R)ltpR*R+ltqR,R-R.R/R0R1R2R3R4R5/tr^R6IsHtttHutuHvtv^R7IwHxtx^R8IyHztz^R9I{H|t|H}t}H~t~^R:IHtHt^R;IHtHtHtHtHt^RRHR?RIR?RJRARKRB/tR>RGR?RHR@RHRARJRBRK/tRLRMltRNROltRPRQltRRRSltRTRUltRVRWlt] EP2!RX4tRYRZltR[R\lt] EP2!R]4tR^R_lt^R`IHtHtHt] EP2!Ra] EPJ4tRbRcltRdtRetRftRgtRdtRhtRgtRit^tRgtRftRht]!RjRRk7t]^k!RlRm]4t!RnRo]4t!RpRq]z]]_4tRrRsltRttRuRvltRwRRxRRyR/RzltR{R|ltR}R~ltRRltR# ]:dRs9ELEi;i ]:d3RsJ];s4;s5;s6;s7;s8s<];s=;s>;s?;sC;sAsIR;s9;sD;sFsG!RR4tK]KsBEL]i;i)zcTelegram platform adapter (python-telegram-bot): inbound messages/media/commands, outbound replies.N) ContextVar)datetimetimezoneUTC)Any AwaitableCallableDictIteratorListOptionalSet)setup_platforms)run_bounded_async)platform_ssl_context)decode_json_list_literalextra_or_secretget_scoped_secretplatform_gate_envc0V^8dQhR\R\/#errorreturn)objectstr)formats"G/home/ubuntu/.hermes/hermes-agent/plugins/platforms/telegram/adapter.py __annotate__rs + +v +# +cVfRM \V4pV'g VeR\V4P R2#T#^RIHpV!VRR7# \ dR#i;i)zORedact secrets from Telegram transport errors before logging or returning them.<>)redact_sensitive_textTforcez)rtype__name__ agent.redactr$ Exception)rtextr$s& r_redact_telegram_error_textr,sa2CJD /4.?4;''(*ITI+6$T66 +*+sA AAc<V^8dQhR\PRR/#)rtaskrNasyncioTask)rs"rrr-s"YY',,Y4YrcVP4R# \PdR#\d\P RRR7R#i;i)zFObserve a detached task's terminal exception to avoid noisy loop logs.z1Abandoned Telegram init task failed after timeoutTexc_infoN) exceptionr0CancelledErrorr*loggerdebug)r.s&r_consume_abandoned_taskr9-sFY   ! !  Y HSW XYsAAAA on_abandonlabeltelegramdump_on_blocked_loopTc<V^8dQhR\R\R\/#)rtimeoutr;r=floatrbool)rs"rrr7s$:=bfrc"\WW2VR7GRjxL pVP'd\RVR RV R24hVP#L55i)u8Wall-clock deadline that survives a blocked loop / cancellation-shielded PTB+httpcore init. ``on_abandon`` runs detached so an abandoned initialize() can't leak an httpx pool. Raises ``asyncio.TimeoutError`` on expiry (feeds the PTB retry ladder). Send/media call sites pass ``dump_on_blocked_loop=False``: the bug they bound is a shielded socket on a LIVE loop, and the init wrapper already reports a blocked loop, so N in-flight sends must not each arm a stack-dump timer. Thin wrapper over :func:`agent.deadline.run_bounded_async` (#85125 Phase 2f) — this adapter's private implementation was the ancestor of that primitive and is now consolidated onto it. The unified layer keeps every property the 9 call sites here rely on: thread-timer deadline that survives a blocked event loop (#63309), abandonment of cancellation-shielded tasks (PTB/httpcore init inside anyio scopes), detached best-effort ``on_abandon`` cleanup so an abandoned initialize() can't leak an httpx pool per retry attempt, and off-loop stack-dump diagnostics when the loop never processes the expiry. )r;r:r=Nztimed out after .0fzs ())r timed_out TimeoutErrorvalue) awaitabler?r:r;r=results&&$$$ r_await_with_thread_deadlinerK7sY"%%UikkF -gc]#eWAFGG << ksA A A  A cFV^8dQhR\R\\,/#r) BaseExceptionr )rs"rrrOs# w w w8M3J wrc # "\4pV.pV'dkVP4p\V4pWA9dK+VPV4VxVP R\ VRR4\ VRR4344KrR#5i)uYield ``error`` and every ``__cause__``/``__context__`` ancestor (DFS, cycle-safe) — PTB wraps httpx errors, so classifiers must inspect the whole graph.c30"TF qfKVxK R#5iN).0xs& r (_iter_exception_graph..[sv d1QQ ds  __cause__N __context__)setpopidaddextendgetattr)rseenstackcuridents& r_iter_exception_graphrbOssUD"'E iik3 =    vk4!@'#}^bBc dvv s BA,BcV^8dQhRR/#rrNrQ)rs"rrr^sVV$Vrc"VfR#VP4GRjxL \ VRR4pVe\ VRR4MR;'gR Fbp\ VRR4pVfKV!4p\ P !V4'g\ P!V4'd VGRjxL KbKd R#L \d\PRRR7Li;iL6 \d\PRRR7Ki;i5i) zRelease a half-built PTB app's httpx transports after an abandoned init: ``app.shutdown()`` no-ops when ``_initialized`` was never set, so the request transports are closed directly.Nz(Abandoned Telegram app.shutdown() failedTr3bot_requestshutdownz*Abandoned Telegram request shutdown failedrQ)rhr*r7r8r]r0 iscoroutineisfuture)apprfrequestrhrJs& r_shutdown_abandoned_apprm^s {Plln #ud #C69oGCT24VVTVV7J5    VZF""6**g.>.>v.F.F /G W  P ?$ OP V LLEPTL U VsD B6B4B6&D  D #"C C "C 'C(C ,D 4B66"CD CD C  "DD DD UpdateBotMessageInlineKeyboardButtonInlineKeyboardMarkup)LinkPreviewOptions) ApplicationCommandHandlerCallbackQueryHandlerInlineQueryHandlerMessageHandler ContextTypes TypeHandlerfilters) ParseModeChatType) HTTPXRequestFc]tRt^t]tRtR#)_MockContextTypesrQN)r( __module__ __qualname____firstlineno__r DEFAULT_TYPE__static_attributes__rQrrrrs rr)Path)_coerce_allow_set) get_languaget)PlatformPlatformConfig)BasePlatformAdapterExecApprovalPrompt SendResultclassify_send_errorunauthorized_action_noticecache_image_from_bytes_asynccache_audio_from_bytes_asynccache_video_from_bytes_asyncresolve_proxy_urlSUPPORTED_VIDEO_TYPESSUPPORTED_DOCUMENT_TYPESSUPPORTED_IMAGE_DOCUMENT_TYPES_TEXT_INJECT_EXTENSIONS utf16_lenc$V^8dQhR\/#rrr)rs"rrrsHHsHrcB\\P4R\#)uEvery refused button tap answers with the same sentence — resolved per tap so the active language applies (never bound at import).N)rrTELEGRAM _TOAST_LIMITrQrr _unauthorizedrs &h&7&7 8, GGrc<V^8dQhR\R\R\/#)rkeykwargsrrr)rs"rrrs!+++s+s+rc (\V3/VBR\#)zV``t()`` for ``query.answer(text=...)`` payloads, cut at Telegram's 200-char toast cap.N)rr)rrs&,r_toastrs S F M\ **rc0V^8dQhR\R\/#)rlinerr)rs"rrrs@@3@3@rcVPR4wrpV'gR\P!V4 R2#R\P!V4 R\P!V4 2#)zWHTML-bold the ``Label:`` prefix of a translated line (whole line when it has no colon).:zzz:) partition_htmlescape)rr;seprests& r_bold_label_htmlrsX~~c*E U\\$'(-- e$%U5<<+=*> ??r attachmentz'platform.telegram.media.kind_attachmentphotoz"platform.telegram.media.kind_photo voice messagez"platform.telegram.media.kind_voice audio filez"platform.telegram.media.kind_audio video filez"platform.telegram.media.kind_video) MessageEvent MessageTypeProcessingOutcome)expand_link_entities)TelegramHeldInboundMixin)normalize_telegram_chat_idparse_send_targetparse_telegram_message_id)TopicTransferFnapply_root_dm_topic_transfer)SEED_FALLBACK_IPSTelegramFallbackTransportdiscover_fallback_ipsparse_fallback_ip_envtcp_keepalive_socket_options)TelegramTopicRoutingMixin) env_floatenv_int.png.jpg.jpeg.webp.gif@?c0V^8dQhR\R\/#)rwaitr)rAr)rs"rrrs]]E]j]rc6\RRV 2\V4R7#)z=The shared fail-closed SendResult for an over-cap flood wait.Fzflood_control:)successr retry_after)rrA)rs&r_flood_cap_resultrs e^D6+BPUVZP[ \\rz image/png image/jpegz image/jpgz image/webpz image/gifcFV^8dQhR\R\\,/#rrHr)rr int)rs"rrrs&&C&HSM&rcr\\V44pT^8dT#R# \\3dR#i;i)zBRound a raw length to whole positive seconds, or None if unusable.N)roundrA TypeError ValueError)rHsecss& r_coerce_duration_secondsrsAU5\"!84%% z "s !66cFV^8dQhR\R\\,/#rpathrrr r)rs"rrrs    rc t\PPV4^,P4R8Xd}^RIpVP VR4;_uu_4pVP 4;'g^pV'd*\VP4\V4, 4MRpRRR4XeV#^RI p\\\VPV4RR4RR44pVeV#^RIp^RIpVP!R4'd`VP#RRRR R R R V.VP$R R RR^RR7pVP&^8Xd$\VP(P+44#R# +'giL;i \dLi;i \dLi;i \dR#i;i)uBest-effort whole-second audio length (wave → mutagen → ffprobe; None if unreadable). Telegram renders long clips as 0:00 without an explicit duration. Blocking: use ``to_thread``.z.wavNrbinfolengthffprobe-vr -show_entriesformat=duration-ofz"default=noprint_wrappers=1:nokey=1Tutf-8replaceFstdincapture_outputr+encodingerrorsr?check)osrsplitextlowerwaveopen getframerater getnframesrAr*mutagenr]Fileshutil subprocesswhichrunDEVNULL returncodestdoutstrip) rrwfraterrrrprocs & r_probe_voice_duration_secondsr s wwa &&(F2  4&&"(--ARV/ %+0MN\`'   ' T8JFTX0Y[cei(jk  K    << " ">>D'?F FF F%$F%( F76F7cRV^8dQhR\R\\\3,/#r)rdictr)rs"rrrs"S#Xrc^RIp^RIpVPR4'g/#VPRRRRRRRRR R R V. VPR R R R^RR7pVP ^8wd/#\ P!VP;'gR4pVPR4;'g.pV'g/#R\V^,R,4R\V^,R,4/p\VPR4;'g/PR44pV'dWvR&V# \d\PRTR R7/u#i;i)a_``{"width", "height", "duration"}`` for a local video; ``{}`` when ffprobe can't read it. Telegram runs its own video processing only for uploads under roughly 10 MB; above that it stores the file as an unprocessed ``320x320`` video with ``duration=0``, so the message must carry the real geometry or clients draw a square tile for any aspect ratio. Nrrrz-select_streamszv:0rzstream=width,heightrrjsonTrrFrz{}streamswidthheightrdurationz-[Telegram] video geometry probe failed for %sr3)rrrrrrrloadsrgetrrr*r7r8)rrrr blobrgeometryrs& r_probe_video_geometryrsJ||I&&I~~ g'8% 3_FW FD "$$Tw_hrt}B C ??a Izz$++--.((9%++ISG!45xWQZPXEYAZ[+TXXh-?-E-E2,J,J:,VW #+Z   DdUY Z sAD)D)AD)%"D)D)' D)2D)4A.D)#D))%EEchV^8dQhR\R\\,R\\,/#)rrrrr)rs"rrr(s)x}#rcRp^RIp^RIp^RIpVPR4'gR#\ ^\ T;'g^R,44pVP RRR7wrr\P!V4VPRRR\V4R VR R R R RRV. VPRRRR^RR7pVP^8wg&\PPV4'gD\P !\"4;_uu_4\P$!V4RRR4R#V# +'giR#;i \&dz\(P+RTRR7T'dV\P !\"4;_uu_4\P$!T4RRR4M +'giM;iR#i;i)uWrite a 320px-wide JPEG frame for Telegram's ``thumbnail`` field; None on failure. Telegram keeps a supplied thumbnail for the uploads it did not process itself — without one the chat shows a square placeholder tile until the video is opened. Nffmpegg?rzhermes-tg-thumb-suffixprefixz-yz-ssz-iz -frames:v1z-vfz scale=320:-2z-q:v6TrrFrz3[Telegram] video thumbnail extraction failed for %sr3)rrtempfilermaxrmkstemprcloserrrrrgetsize contextlibsuppressOSErrorremover*r7r8) rroutrrr seekfdr s && r_video_thumbnail_jpegr,(se C||H%%1c8==qD012""&9K"L  ~~ tUCItT; NFC 6$$Tw_hrt}BC ??a rwws';';$$W-- #. .-  JD[_ ` $$W-- #.--- sd"EEB+E)"E D."E,E. D? 9E?E*G-"GF/& G/ F? :GGc$V^8dQhR\/#rrB)rs"rrrIstrc\#)uPASSIVE registry ``check_fn``: is python-telegram-bot importable? Never installs (``check_telegram_requirements`` is the active ``ensure_deps_fn``). Registry ``check_fn`` — called from status displays and config loading, so it must never install anything. The ACTIVE lazy-installer (``check_telegram_requirements``) is registered as ``ensure_deps_fn`` and runs from ``create_adapter()`` when this returns False (#79812). )TELEGRAM_AVAILABLErQrrtelegram_deps_presentr1Is  rc$V^8dQhR\/#rr.)rs"rrrTs""T"rcaaa\'dR#^RIHpV!R4^RIoT3RlR 4woorT3RlR 4wsssss \SRR4s T3R lR 4ws s sssSP"SP$SP&usssTP(TP*ussTP,sRsR# \dR#i;i \.\03dR#i;i) a#Check if Telegram dependencies are available. If python-telegram-bot is missing, attempts to lazy-install it via ``pm.ensure_import("telegram")``. After a successful install, re-imports the SDK and flips ``TELEGRAM_AVAILABLE`` to True so the adapter's class-level type aliases get rebound. T) ensure_importr<FNc3F<"TFpSPV4xK R#5irP) import_module)rRm importlibs& rrT.check_telegram_requirements..is$#x0v1I # #A & &0v!c3<<"TFp\SV4xK R#5irPr])rRn_tgs& rrTr9ksLs%qGCOO%qrtc3<<"TFp\SV4xK R#5irPr<)rRr=_exts& rrTr9ns'iI'HGD!  'Hr?)r<z telegram.extztelegram.constantsztelegram.requestrn)rurvrwrxry)r0pmr4r*r8rorprqrrrsr]rtrurvrwrxTelegramMessageHandlerrzr|r{r}r~r ImportErrorAttributeError) _lazy_ensure_const_reqrAr>r8s @@@rcheck_telegram_requirementsrITs 4Z  #x0v#xT6Ls%qLsHW24H$S*>EiI'HiIe ^%9;MOe-1->-> dN^N^* g{$.. 8((  #   (s#B5BC5 CCCCz([_*\[\]()~`>#\+\-=|{}.!\\])c0V^8dQhR\R\/#rr+rr)rs"rrr}s..s.s.rc.\PRV4#)zIEscape Telegram MarkdownV2 special characters with a preceding backslash.z\\\1)_MDV2_ESCAPE_REsubr+s&r _escape_mdv2rP}s   w --rc0V^8dQhR\R\/#rKr)rs"rrrsccrc&\P!RRV4p\P!RRV4p\P!RRV4p\P!RRV4p\P!RRV4p\P!RRV4pV#)zLStrip MarkdownV2 escapes and formatting markers for the plain-text fallback.z\\([_*\[\]()~`>#\+\-=|{}.!\\])\1z\*\*([^*]+)\*\*z \*([^*]+)\*z(?(?:\\)?\(\d+/\d+(?:\\)?\))$c0V^8dQhR\R\/#rKr)rs"rrrsIIsIsIrc.\PRV4#)uMove a ``(N/M)`` chunk marker that ``truncate_message()`` appended to a synthesized closing fence onto its own line — Telegram rejects ````` \(1/2\)`` as a fence.z```\n\g)_CHUNK_INDICATOR_ON_FENCE_RErNrOs&r$_separate_chunk_indicator_from_fencer[s ( + +,A4 HHr)TABLE_SEPARATOR_REcompile_mention_patternsconvert_table_to_bulletsz(?:```[^\n]*\n[\s\S]*?```)|(?:^[^\n]*\|[^\n]*\n[ \t]*\|?[ \t]*:?-+:?[ \t]*(?:\|[ \t]*:?-+:?[ \t]*)+\|?[ \t]*(?:\n[^\n]*\|[^\n]*)*)c0V^8dQhR\R\/#rKr)rs"rrrs  S S rc V'dRV9dV#.p^p\PV4FjpVP\P!RRWVP 444VPVP ^44VP4pKl VP\P!RRWR44RPV4#)zConvert lone ``\n`` (a Markdown soft break) to hard breaks for sendRichMessage; ``\n\n``, fenced code and pipe tables are left untouched. z(? 773<r.@@>@N@r@gb@telegram_polling_generationdefaultc]tRtRtRtRtR#)_PollingLifecycleAbortiz=Internal control flow for polling startup fenced by teardown.rQNr(rrr__doc__rrQrrrtrtsGrrtc]tRtRtRtRtR#)_PollingStallErroria6A confirmed getUpdates stall (watchdog or post-reconnect verifier), as opposed to a transport drop. Typed so the recovery ladder can hand the adapter to the supervisor instead of classifying log text: restarting the same Updater cannot heal a wedged long-poll consumer whose stop() did not quiesce (#113618). rQNrurQrrrxrxsrrxc$aa]tRtRtoRtRtRtRtRtRt Rt Rt ^@t R t R tR t^UtR tR tRtRtRtRtRtRtRt]RRRR/V3RlRll4t]V3RlRl4t]R4tV3RlV3Rllt]V3RlRl4t V3RlV3Rllt!V3R lV3R!llt"V3R"lV3R#llt#V3R$lR%lt$V3R&lR'lt%V3R(lR)lt&V3R*lR+lt'V3R,lR-lt(]V3R.lR/l4t)R0t*]V3R1lR2l4t+R3RR4RR5RR6R/V3R7lR8llt,V3R9lR:lt-R;t.V3R<lR=lt/V3R>lR?lt0V3R@lRAlt1]2V3RBlRCl4t3]2V3RDlREl4t4]2V3RFlRGl4t5]V3RHlRIl4t6]2V3RJlRKl4t7]V3RLlRMl4t8]2ERV3RNlROll4t9]2ERV3RPlRQll4t:]2V3RRlRSl4t;V3RTlRUlt<]2V3RVlRWl4t=]2V3RXlRYl4t>]V3RZlR[l4t?R\R/V3R]lR^llt@]V3R_lR`l4tA]2V3RalRbl4tBERV3RclRdlltCV3RelRfltD]V3RglRhl4tE]V3RilRjl4tF]V3RklRll4tG]V3RmlRnl4tH]2V3RolRpl4tI]V3RqlRrl4tJERV3RtlRulltKV3RvlRwltLV3RxlRyltMV3RzlR{ltN]OP!R|]OP]OP,4tS]OP!R}]OP]OP,4tT]OP!R~4tUV3RlRltVV3RlRltWV3RlRltXV3RlRltYV3RlRltZV3RlRlt[ERV3RlRllt\ERV3RlRllt]V3RlRlt^V3RlRlt_RRs/V3RlRllt`V3RlRltaV3RlRltbV3RlRltcV3RlRltd]V3RlRl4teRR/V3RlRlltf]V3RlRl4tgV3RlRlthV3RlRltiV3RlRltjERV3RlRlltkV3RlRltlV3RlRltmV3RlRltnV3RlRltoV3RlRltpV3RlRltqV3RlRltrV3RlRltsRttV3RlRltuRtvRRsRR/V3RlRlltwV3RlRltxV3RlRltyV3RlRltzV3RlRlt{V3RlRlt|V3RlRlt}RRs/V3RlRllt~V3RlRltRRs/V3RlRlltV3RlRltV3RlRltV3RlRltV3RlRltV3RlRltV3RlRltV3RlRltV3RlRltV3RlRltV3RlRltERV3RlRlltV3RlRltV3RlRltV3RlRltERV3RlRlltV3RlRltERV3RlRlltV3RlRltERV3RlRlltV3RlERltV3ERlERltV3ERlERltV3ERlERlt]V3ERlERl4t]V3ER lER l4tV3ER lER ltV3ER lERltERtV3ERlERlt]V3ERlERl4tV3ERlERltV3ERlERltV3ERlERltV3ERlERltV3ERlV3ERlltV3ERlERltV3ER lER!ltERV3ER"lV3ER#llltV3ER$lER%ltV3ER&lER'ltV3ER(lER)ltV3ER*lER+ltV3ER,lER-ltER.Rs/V3ER/lER0lltV3ER1lER2lt]V3ER3lER4l4tV3ER5lER6ltV3ER7lER8ltV3ER9lER:ltV3ER;lER<ltV3ER=lER>ltV3ER?lER@ltV3ERAlERBlt]V3ERClERDl4tV3ERElERFltV3ERGlERHltV3ERIlERJltERV3ERKlERLlltV3ERMlERNltV3EROlERPltV3ERQlERRlt]ERSR/V3ERTlERUll4tV3ERVlERWltR\R/V3ERXlERYlltERV3ERZlER[lltV3ER\lER]ltER^RsR\R/V3ER_lER`lltV3ERalERbltV3ERclERdltR\R/V3ERelERflltV3ERglERhltERV3ERilERjlltERV3ERklERllltERmtERnRERoR/V3ERplERqlltERrRR5RERoR/V3ERslERtllt]V3ERulERvl4tERV3ERwlERxllt]V3ERylERzl4tER{tER|t]V3ER}lER~l4t]V3ERlERl4tERtV3ERlERltV3ERlERlt]V3ERlERl4tV3ERlERltERV3ERlERlltERV3ERlERllt]ER4tERV3ERlERllt^ tERV3ERlERlltV3ERlERltV3ERlERlt^t]V3ERlERl4t]V3ERlERl4t]V3ERlERl4tV3ERlERltERV3ERlERlltERV3ERlERlltV3ERlERltV3ERlERlt]V3ERlERl4tV3ERlERltV3ERlERltV3ERlERlt]V3ERlERl4tV3ERlERltV3ERlERlt]V3ERlERl4tV3ERlERltV3ERlERlt]V3ERlERl4tV3ERlERltV3ERlERltERR/V3ERlERlltV3ERlERltV3ERlERltV3ERlERltV3ERlERltERER.ERRs3ERER.ERRs3ERER.ERRs3ERER.ERRs3ERERER.ERR3ERERER.ERR3ERERER.ERR3ERERER.ERR3ERERER.ERR3ERERER.ERR3/ tV3ERlERltV3ERlERlt]V3ERlERl4tV3ERlERlEtV3ERlERlEt]V3ERlERl4EtV3ERlERlEtV3ERlERlEtERV3ERlERllEt]V3ERlERl4EtEREtERV3ERlV3ERlllEtERV3ERlV3ERlllEt ERV3ERlV3ERlllEt V3ERlERlEt V3ERlERlEt ERV3ERlV3ER lllEt ERV3ER lV3ER lllEtERV3ER lV3ER lllEtERV3ERlERllEt]V3ERlERl4EtV3ERlERlEtV3ERlERlEtE]EP*V3ERlERl4EtV3ERlERlEtV3ERlERlEtV3ERlERlEtV3ERlERlEtERV3ER lER!llEtV3ER"lER#lEtV3ER$lER%lEt]V3ER&lER'l4EtV3ER(lER)lEtV3ER*lER+lEt V3ER,lER-lEt!V3ER.lER/lEt"V3ER0lER1lEt#V3ER2lER3lEt$V3ER4lER5lEt%V3ER6lER7lEt&V3ER8lER9lEt'V3ER:lER;lEt(V3ER<lER=lEt)V3ER>lER?lEt*V3ER@lERAlEt+V3ERBlERClEt,V3ERDlERElEt-V3ERFlERGlEt.]V3ERHlERIl4Et/]V3ERJlERKl4Et0]2V3ERLlERMl4Et1V3ERNlEROlEt2]2V3ERPlERQl4Et3]OP!ERR]OP4Et4ERSEt5V3ERTlERUlEt6V3ERVlERWlEt7V3ERXlERYlEt8V3ERZlER[lEt9ER\Rs/V3ER]lER^llEt:R Et;V3ER_lER`lEt<]V3ERalERbl4Et=]V3ERclERdl4Et>]2V3ERelERfl4Et?]2ERV3ERglERhll4Et@]V3ERilERjl4EtAV3ERklERllEtBV3ERmlERnlEtCV3ERolERplEtDV3ERqlERrlEtEV3ERslERtlEtFV3ERulERvlEtGV3ERwlERxlEtHV3ERylERzlEtIV3ER{lER|lEtJER}EtKV3ER~lERlEtLV3ERlERlEtMV3ERlERlEtNV3ERlERlEtOERE]PEPERE]PEPERE]PEP/EtTV3ERlERlEtUV3ERlERlEtVV3ERlERlEtWV3ERlERlEtXV3ERlERlEtY]V3ERlERl4EtZERV3ERlERllEt[ERV3ERlERllEt\V3ERlERlEt]V3ERlERlEt^ERRs/V3ERlERllEt_V3ERlERlEt`V3ERlERlEtaERE]bEPERER/V3ERlERllEtdV3ERlERlEteV3ERlERlEtfV3ERlERlEtgV3ERlERlEthV3ERlERlEtiV3ERlV3ERllEtjV3ERlV3ERllEtkERV3ERlERllEtlV3ERlERlEtmV3ERlERlEtnV3ERlERlEtoV3ERlERlEtpV3ERlERlEtqV3ERlERlEtrV3ERlERlEts]V3ERlERl4EttV3ERlERlEtuV3ERlERlEtv]V3ERlERl4EtwV3ERlERlEtxV3ERlERlEtyV3ERlERlEtzV3ERlERlEt{V3ERlERlEt|V3ERlERlEt}V3ERlERlEt~V3ERlERlEt]2V3ERlERl4Et]2V3ERlERl4Et]2V3ERlERl4EtV3ERlERlEtV3ERlERlEtERV3ERlERllEt]V3ERlERl4EtV3ERlERlEtV3ERlERlEtV3ERlERlEtV3ERlERlEtV3ERlERlEtV3ERlEtEREtVEtV;Et#(TelegramAdapterizLTelegram bot adapter: users/groups, MarkdownV2 replies, forum topics, media.Tii皙?rrk?i@i@g ףp= ?gQ? min_valueN max_valuec X<V^8dQhRS[RS[RS[S[,RS[S[,RS[/#)rnamerrrrr)rrAr )r __classdict__s"rrTelegramAdapter.__annotate__/s@uHUOgopugvCHrc 4^RIp\P!V4pVe \V4M \V4pVP V4'g \V4pVe \Wb4pVe \Wc4pV# \\ 3d\T4pL`i;i)uWRead a float env var; non-finite → default; clamp to bounds (safe for asyncio.sleep).N) mathrgetenvrArrisfiniter!min)rrrrrrrawrHs&&$$ r_env_float_clamped"TelegramAdapter._env_float_clamped.s iio #"%/E#JuW~E}}U##'NE  )E  )E :& #'NE #sA88BBc <V^8dQhRS[/#rr.)rrs"rrr@sAA4Arc \VRR4#)zOTrue once disconnect() fenced polling (tolerates object.__new__ test adapters)._polling_teardown_startedFr<selfs&r_teardown_started!TelegramAdapter._teardown_started?st8%@@rc \#)z6Telegram measures message length in UTF-16 code units.)rrs&rmessage_len_fnTelegramAdapter.message_len_fnDs rc <V^8dQhRS[/#)rconfig)r)rrs"rrrIsL;L;~L;rc<\SV`V\P4VPP pRVn/Vn/VnRVn ^RI H pV!4Vn \4Vn\4VnRVnRVnRVnVP'4Vn\+VRR4;'gRVnVP/RR4VnVP/RR4VnVP/RR4VnVP/RR4VnR;VnVn/VnVP?R R R R R 7Vn /Vn!/Vn"VP?RRRR R 7Vn#\IRR4Vn%/Vn&/Vn'/Vn(/Vn)/Vn*VPWRVPXRVPZR 7Vn.VPWRVP^VP\VP`R 7Vn1RVn2.Vn3RVn4RVn5RVn6RVn7RVn8RVn9^;Vn:;Vn;Vn<RVn=\|P~!4Vn@R;VnAVnBRVnCRVnDRVnE^VnF^VnG^VnH^VnIRVnJRVnK^;VnLVnMRVnN\|P!4VnP/VnQ/VnR\4VnSRVnT\|P!4VnU\VPRR44VnX\VPRR44VnZ\VPRR44Vn[VP/RR4Vn\VPR.4Vn]VPUu0uFpRV9gK \VR,4kK upVn^VPR 4'dR"MR#Vn_/Vn`/Vna/Vnb/Vnc/VndR!Vne/Vnf/VngR#uupi)$Nget_hermes_homeF reply_to_modefirstdisable_link_previews rich_messagesallow_cjk_rich_messages rich_draftstyping_cooldown_secondsrmrro)rr%typing_retrigger_min_interval_secondsrl)HERMES_TELEGRAM_MEDIA_BATCH_DELAY_SECONDSr}(HERMES_TELEGRAM_TEXT_BATCH_DELAY_SECONDSg{Gz?.HERMES_TELEGRAM_TEXT_BATCH_SPLIT_DELAY_SECONDSr!status_indicator status_onlineOnlinestatus_offlineOfflinedrop_pending_on_cold_bootT dm_topicschat_idbase_url importantl@)hsuper__init__rrrextra_app_seen_update_ids_inflight_update_ids_update_admissionhermes_constantsr_update_receipt_dirrX_update_receipts_loaded_update_receipts_dirty_update_receipt_flush_bot _webhook_mode_compile_mention_patterns_mention_patternsr]_reply_to_mode_coerce_bool_extra_disable_link_previews_rich_messages_enabled_allow_cjk_rich_messages_rich_drafts_enabled_rich_send_disabled_rich_draft_disabled_telegram_typing_cooldown_until_coerce_float_extra!_telegram_typing_cooldown_seconds _telegram_typing_retrigger_tasks_telegram_typing_retrigger_at#_telegram_typing_retrigger_intervalr_media_batch_delay_seconds_pending_photo_batches_pending_photo_batch_tasks_media_group_events_media_group_tasks_committed_flush_tasksr_TEXT_BATCH_DEFAULT_DELAY_S_TEXT_BATCH_MAX_DELAY_S_text_batch_delay_seconds!_TEXT_BATCH_DEFAULT_SPLIT_DELAY_S_TEXT_BATCH_MAX_SPLIT_DELAY_S_text_batch_split_delay_seconds_drop_delayed_deliveries_held_inbound_events_held_inbound_redispatch_task_polling_error_task_polling_progress_verifier_task_polling_heartbeat_task_bot_identity_refresh_task_post_connect_task_polling_conflict_count_polling_network_error_count_polling_generation%_polling_conflict_recovery_generationr0Event_polling_progress_event_polling_progress_acceptingr_polling_error_callback_ref%_polling_generation_started_monotonic _polling_last_progress_monotonic_updates_received_total_updates_dispatched_total_ingress_dispatched_seen_ingress_stalled_heartbeats_bot_username_observed_bot_identity_checked_at_polling_pending_stuck_count_polling_not_running_count_send_path_degradedLock_general_request_drain_lock _dm_topics_pending_created_topics_forum_command_registered_command_menu_fingerprint _forum_lockrBr_status_indicator_enabledr_status_online_text_status_offline_text_drop_pending_on_cold_boot_dm_topics_config_dm_topic_chat_ids_max_doc_bytes_model_picker_state_choice_picker_state_approval_state_slash_confirm_state_clarify_state_notifications_mode_status_message_ids_last_overflow_preview)rrrre __class__s&& rrTelegramAdapter.__init__Isf !2!23 !!+/ &(*,!!% 5#2#4 ,/E$+.5#=A"#' #(!%!?!?!A#*6?G#L#W#WPW,0,C,CD[]b,c# -1,C,COUZ,[#.2.E.EF_af.g%*.*A*A-QV*W!?DD 4# ;=KM#*.)@)@ 68X8Xd&B&B*A*D&04/F/F d>d44@b@b0G0d,).%9;!EI*;? GK,?C$BF':>fgg$gt'H4KcDH2'.}}$LQQ(4+I+/(GK2AE-,-$./&-.%01(6:#:>%OPO)D,K*/ +2<<>(*,Y[$365&.0&"<<>04EII>PRW4X/Y&(+EIIox,P(Q ),UYY7G-S)T! 150G0GHcei0j'7S9->H^,q=BYYz=R=R#9Xh46 57!/146!.0)4 68 9;#%-rs  Q'Qc <V^8dQhRS[/#rr.)rrs"rrrsAADArc.\\VRR44#)rFrBr]rs&rsend_path_degraded"TelegramAdapter.send_path_degradeds GD"7?@@rc<V^8dQhRR/#rdrQ)rrs"rrrs111rcR<RVn\SV` 4VP4R#)FN)rr_mark_connected!_schedule_held_inbound_redispatchrrs&rrTelegramAdapter._mark_connecteds"(-% ! ..0rc<V^8dQhRR/#rdrQ)rrs"rrrs%%D%rc2<RVn\SV` 4R#TN)rr_mark_disconnectedrs&rr!"TelegramAdapter._mark_disconnecteds(,% "$rc0<V^8dQhRS[RS[RS[RR/#)rcodemessage retryablerNrrB)rrs"rrrs/ v vS v3 vd vt vrc<RVn\SV` WVR7V'g]\VRR4pV'd \ V4M^pV'dVP 4V'd\ PRW4R#R#R#)Tr&rNzJ[Telegram] Non-retryable fatal (%s); discarding %d held inbound message(s))rr_set_fatal_errorr]lenclearr7warning)rr$r%r&heldr=rs&&&$ rr* TelegramAdapter._set_fatal_errorsg(,%  ) D4!7>D!D qA kmqu rc <V^8dQhRS[/#rr.)rrs"rrrsGGTGrc b\VRR4'gR#\\VRR44'*#)uATrue after non-retryable fatal — holds must discard, not queue._fatal_error_codeNF_fatal_error_retryableT)r]rBrs&r_is_permanent_fatal#TelegramAdapter._is_permanent_fatals-t0$77&>EFFFrc<V^8dQhRR/#)rrzOptional[TelegramAdapter]rQ)rrs"rrrs/Jrc \VRR4p\VRR4;'g/pVPVP4pVeW0Jd\VRR4'dV#R#)zLive adapter if the reconnect watcher replaced us in ``runner.adapters`` (an in-flight ``send()`` still holds the old instance whose ``_bot`` stays None).gateway_runnerNadaptersr)r]rplatform)rrunnerr9lives& r_replacement_telegram_adapter-TelegramAdapter._replacement_telegram_adapters\/66:t4::||DMM*   0WT645P5PKrc <V^8dQhRS[/#rr.)rrs"rrrsdrc "VP'gVP4eR#VP4'dR#\\ VRR44p\\ VRR44p\ P RVPV4R pW18d\P!V4GRjxL W2, pVP4'dR#VP'gVP4fKj\ P R VPV4R#\ PR VPV4R#L5i) zOWait for ``_bot`` or a replacement adapter; False on expiry or permanent fatal.NTF_RECONNECT_WAIT_SECONDSrk_RECONNECT_POLL_INTERVALr~u=[%s] Not connected — waiting for reconnection (up to %.0fs)rz[%s] Reconnected after %.1fsz$[%s] Still not connected after %.0fs) rr=r4rAr]r7rrr0sleepr-)rwait_spoll_swaiteds& r_wait_for_reconnection&TelegramAdapter._wait_for_reconnections 999::<H  # # % %wt%>EFwt%?EF SUYU^U^`fgo--' ' '  F''))yyyD>>@L :DIIvN=tyy&Q (s$"7++w55rc6<V^8dQhRS[RS[S[,/#)ruser_idrrr rB)rrs"rrr?s<<<$si''?@FFH .9.?.?.DT.Ds {syy{.D Tk!;;W%;;Us A:A:rrX thread_id user_namec ~<V^8dQhRS[RS[S[,RS[S[,RS[S[,RS[S[,RS[/#)rrkrrXrxryrrl)rrs"rrrGsN###(0 #IQRU#C=#4ryestrue)rrr`r]_is_sender_authorizedrhgateway.sessionrrrrBr*r7r8rvrqr) rrkrrXrxrynormalized_user_idnormalized_chat_typeinjectedrgrsourcedecisions &&$$$$ r_is_callback_user_authorized,TelegramAdapter._is_callback_user_authorizedGsy!B/557!#88^bMb8c 4/ 6 B11"CPWPmPm[mLn,5,A#i.t2MH#--/   x9&%..GDDFJ^^ ^ x SUgrvx xs"$E AE #E0/E0c <V^8dQhRS[/#rr%rq)rrs"rrrlsEEWErc  ^^RIHp\VRR4p\VRR4p\\VRR44P 4;'gRpVe\ \VRR44MRp\\VR R4;'g\VR R4;'gR4P 4;'gRpV'g\VR R4pVeo\\VRR44P 4;'gRpV'g9\\VR R4;'gR4P 4;'gRp\\VRR44P 4;'gTp \VR R4p \ \VRR44p \VRR4RJp TP \VRR4V RJ;'d T ;'gT R7p RpV e2V R8XdV 'gV 'gV R8XdV 'd \V 4pT!\PT ;'gRWW~VR7#)zBuild the SessionSource the gateway auth path expects; identity comes from ``from_user``, falling back to ``sender_chat`` for channel posts so an unauthorized channel can't inject.r~ from_userNchatrZr!is_botFusername full_name sender_chattitlemessage_thread_idis_topic_messagerYTr'r[r|r^)r:rrXrkryrxr) rrr]rrrBr`rr)rr%ruserrrkrryrr thread_id_rawris_forum_grouprXrxs&& r_source_from_message_for_auth-TelegramAdapter._source_from_message_for_authls 2w T2w-gdD"-.446>>$9=9IgdHe45uj"5]]{TV9W]][]^ddfnnjn !'=$?K&gk4<=CCEMM #GK"$E$K$K L R R T \ \X\IgdD"-.446AA')PY]aPafvM*I&& 2VE Erc  (\VRR4pVf \R4h\VRR4;'g\VRR4p\VRR4p\\VRR44P4;'gRp\\VR R4;'g#\VR R4;'g\VR R44P4;'gRp\\VRR44P4;'gRp\VR R4pV'd,V'd$Ve \V4P4'g \R 4hVP \VRR4\VRR4RJR7p VP WyWVR\V4R7#)zSessionSource for a ``message_reaction`` update's actor (``user`` or ``actor_chat``). Raises ``ValueError`` when actor, chat or message identity is absent so the post-auth boundary fails closed.message_reactionNzKgateway_platform_event source extraction requires a message_reaction updater actor_chatrrZr!rrr message_idzLgateway_platform_event reaction requires actor, chat, and message identitiesr'r[rYFTr|)rrXrkryrxr)r]rrrr` build_source) rupdatemrrrrkryrrrXs && r_source_from_reaction_for_auth.TelegramAdapter._source_from_reaction_for_authsV/ 6 :jk kr64(KKGB d,Kr64(gdD"-.446>>$j"5uu{TV9Wuu[bcgiprt[uv||~GGCG gdD"-.446>>$Rt4 g);3z?CXCXCZCZkl l--gdFD.IT[\`blnsTtx|T|-}   'bfsvxBtC!D Drc <V^8dQhRS[/#rr.)rrs"rrrsBBtBrc nRp\;QJdRV4F 'gK R# R#!RV44#)zDReturn True when Telegram auth env vars make an early decision safe.c3T"TFp\V4P4xK R#5irP)rqr)rRrs& rrT@TelegramAdapter._telegram_auth_env_configured..s"ADS#C(..00Ds&(TF)rnTELEGRAM_GROUP_ALLOWED_USERSTELEGRAM_GROUP_ALLOWED_CHATSTELEGRAM_ALLOW_ALL_USERSGATEWAY_ALLOWED_USERSr)any)rkeyss& r_telegram_auth_env_configured-TelegramAdapter._telegram_auth_env_configureds5\sADAssAsAsADAAArc <V^8dQhRS[/#rr.)rrs"rrrsee$erc BVPR8wdR#\\VRR4RR4;'g\VRR4p\VRR4p\V4'd?\VRR4;'g\VR R4pV!\PVR 7R 8g#\\VRR4RR4;'g/p\VPRR44P4P4R9# \ d\ PR R R7Li;i)uTrue when an unauthorized DM must still reach the gateway for an outbound reply (``unauthorized_dm_behavior`` resolves to anything but ``ignore`` — a pairing code or a one-time decline — incl. an allowlist plus an explicit platform override).r[FrcNrdr8_get_unauthorized_dm_behaviorprofile_owner_profile)rignorez][Telegram] Failed to resolve unauthorized DM behavior; falling back to adapter-local overrideTr3rrunauthorized_dm_behaviorr!)pairdecline) rXr]rfrrr*r7r8rrrr)rrr; behavior_fnrrs&& r(_should_pass_unauthorized_dm_for_pairing8TelegramAdapter._should_pass_unauthorized_dm_for_pairings   t #'94@*dS||W^_ceuw{W|f&EtL K  M!&)T:ccgdL\^b>c"8#4#4gF(RRh5wEKK5997<=CCEKKMQddd M |HL M Ms C94(C99"DDc&<V^8dQhRS[RS[/#rr%rrqrB)rrs"rrrs4E4E4ED4Erc  VPV4pVPpV'gR#RpVPPP VP ;'gRR 9dRMR4pVe\ V4pW69;'gRV9pVfVPP R4p\V4'di\P!\4;_uu_4\V!W2PVP VPVPR74pRRR4VfVP!4p\#VR R4RJp V 'gVe}VP%4'gR#V 'd>VP'W2P VPVP(VPR 7MRp V eT pMVe\V!V44pVfVP/V4pVfR#V'dR#VP1V4# +'giL;i \d\*P-R TRR 7Lni;i)aIntake auth prefilter, run BEFORE batching/event construction/group observation. Only rejects when it can make the same context-aware decision the runner would; unknown DMs pass through when there is no allowlist or pairing is the unauthorized-DM behavior.TNr!group_allow_from allow_fromrprrrXrxryr})rXrrrxz4[Telegram] Falling back to env-only auth for user %sr3)rfr^channel)rrkrrrrXr__dict__rfr%r&r*rBrrxryrhr]rrrr7r8rvr) rr%rrk authorizedadapter_allow_fromallowed callback_authrg has_callbackrs && r _is_user_authorized_from_message0TelegramAdapter._is_user_authorized_from_messages 33G<..%) ![[..22#)#3#3#9#9r>["[ amo  )'(:;G +==sg~J   MM--.LMM &&((33!%m6CSCS_e_o_o"("2"2'4"5J4  113G"4)?FdRLw299;;4@ 55'7'7X^XeXe$..60EI'!)J(u%)'&/%:   55g>J! <H>H H #H>=H>c\<V^8dQhRS[S[S[S[3,,RS[S[,/#rNrP)rrs"rrrs1AA8DcN+CAQT ArcT;'g/PR4;'gT;'g/PR4pVe \V4#R#)rxrNrr)clsrOrxs&& r_metadata_thread_id#TelegramAdapter._metadata_thread_idsF^^((5bb(..b9M9MNa9b !*!6s9~@D@rc\<V^8dQhRS[S[S[S[3,,RS[S[,/#rNrP)rrs"rrrs/??(4S>:R?W_`cWd?rcT;'g/PR4;'gT;'g/PR4pVe \V4#R#)direct_messages_topic_id!telegram_direct_messages_topic_idNr)rrOtopic_ids&& r"_metadata_direct_messages_topic_id2TelegramAdapter._metadata_direct_messages_topic_idsRNN''(BCAATVG[G[\HA ( 4s8}>$>rc\<V^8dQhRS[S[S[S[3,,RS[S[,/#rN)r r rrr)rrs"rrrs3__Xd38n5M_RZ[^R__rcJ\T;'g/PR44#)telegram_reply_to_message_id)rr)rrOs&&r_metadata_reply_to_message_id-TelegramAdapter._metadata_reply_to_message_ids((..b)=)=>\)]^^rcL<V^8dQhRS[S[S[S[3,,RS[/#rN)r r rrrB)rrs"rrrs,SSXd38n%=S$Src J\T;'dVPR44#)zPTrue for Hermes private-chat topic lanes (``telegram_dm_topic_reply_fallback``). telegram_dm_topic_reply_fallback)rBrrOs&r_dm_topic_fallback"TelegramAdapter._dm_topic_fallbacks!HQQ.P!QRRrc h<V^8dQhRS[RS[S[,RS[S[S[S[3,,RS[/#)rrrxrOrrr r rrB)rrs"rrrsGDDD DYabfgjlogobpYqDvzDrc VPV4e-VPV4;'dVPV4RJ#V'dVPR4'dR#\ V4;'dVPV4#)N"telegram_dm_topic_created_for_sendF)rrrrrB)rrrxrOs&&&&r_is_private_dm_topic_send)TelegramAdapter._is_private_dm_topic_sendsp  1 1( ; G))(3oo8Y8YZb8cko8o o  %IJJICC3#9#9(#CCrc <V^8dQhRS[/#rr)rrs"rrr srrCrrcR#)z`Telegram DM topic delivery requires a reply anchor; refusing to send outside the requested topicrQrQrr_dm_topic_missing_anchor_error.TelegramAdapter._dm_topic_missing_anchor_errorsqrc <V^8dQhRS[S[,RS[S[S[S[3,,RS[S[,RS[S[,/#)rreply_torOrr)r rr rr)rrs"rrr sV}08c3h0H`hil`mzBCFzGrc\V4;peV#VPV4'dVR8wdVPV4#R#)Noff)rrr)rrrOranchors&&&& r_reply_to_message_id_for_send-TelegramAdapter._reply_to_message_id_for_send sE09 9F FM  ! !( + + 0F44X> >rc<V^8dQhRS[RS[S[,RS[S[S[S[3,,RS[S[,RS[S[,RS[S[S[3,/#)rrrxrOreply_to_message_idrr)rr r rr)rrs"rrrsk#Q#Q#Q&.sm#Q?GSRUX?W#Q%c]#QBJ3-#Q[_`ceh`h[i#Qrc BVPV4pV'dVVR8wdOVfVPV4pVf5VPV4pVeRV/#VPV4;'g/#MV'gVPV4pVeV#RVPV4/#)aTelegram send kwargs for forum and direct-message topic routing. Forum topics use ``message_thread_id``; native Bot API DM topics opt in via explicit ``direct_messages_topic_id`` metadata; Hermes private-chat topic lanes are marked ``telegram_dm_topic_reply_fallback``. Anchor-less synthetic sends prefer the Hermes topic's ``message_thread_id`` (the native DM-topic id renders in a different chat lane). ``reply_to_mode="off"`` suppresses the anchor but keeps ``message_thread_id``. Live replies send the private topic thread id together with a reply anchor. Synthetic/resumed sends without an anchor (loop wakeups, background-process notifications, queued follow-ups after a gateway restart) prefer the Hermes topic's ``message_thread_id`` so they stay in the active topic lane (#87051); ``direct_messages_topic_id`` is only used when no topic thread resolves, since the native DM-topic id does not match the Hermes topic lane and can render the message in a different chat lane. rr)rr_message_thread_id_for_send_direct_topic_kwargs) rrrxrOrrfallbackthread_message_id direct_kwargss &&&&&& r_thread_kwargs_for_send'TelegramAdapter._thread_kwargs_for_sends$))(3  ."*&)&G&G&Q#"* %($C$CI$N!$0/1BCC//9??R?+44X>M($$#S%D%DY%OPPrcr<V^8dQhRS[S[S[S[3,,RS[S[S[S[3,,/#rNrP)rrs"rrr<s>]]HT#s(^,D]RVWZ\_W_R`Ia]rc NVPV4pVfR#RRR\V4/#)zUNative Bot API DM-topic routing kwargs, or None when no ``direct_messages_topic_id``.Nrr)rr)rrOdirect_topic_ids&& rr$TelegramAdapter._direct_topic_kwargs;s2@@J  "#T+Es?G[\\rch<V^8dQhRS[RS[S[S[S[3,,RS[S[S[3,/#)rrrOrrr r r)rrs"rrrCsBBBBxSRUX?WB\`adfiai\jBrc  VPWPV4W PRV4\VRR4R7pVP 4UUu/uF wrEVfK WEbK upp#uuppi)uRouting kwargs for ``sendMessageDraft`` / ``sendRichMessageDraft`` (integer ``message_thread_id`` for DM topics — Telegram rejects the raw string ``thread_id``).Nrrr)rrrr]items)rrrOrkvs&&& r_thread_kwargs_for_draft(TelegramAdapter._thread_kwargs_for_draftCsv-- --h7WyWyz~AIXJ!$(8$?.A"(A1AAAs A)A)cF<V^8dQhRS[S[,RS[S[,/#rrxrr rr)rrs"rrrLs#HSMhsmrc`V'd\V4VP8XdR#\V4#rP)r_GENERAL_TOPIC_THREAD_IDrrrxs&&rr+TelegramAdapter._message_thread_id_for_sendKs#C Nc.J.JJ9~rcF<V^8dQhRS[S[,RS[S[,/#rr)rrs"rrrRs$55hsm5QT 5rc,V'd \V4#R#rP)rrs&&r_message_thread_id_for_typing-TelegramAdapter._message_thread_id_for_typingQs"+s9~44rc&<V^8dQhRS[RS[/#rr*rB)rrs"rrrXs88)88rc:R\V4P49#)thread not found)rrrs&r_is_thread_not_found_error*TelegramAdapter._is_thread_not_found_errorWs!SZ%5%5%777rrOc V<V^8dQhRS[RS[RS[S[S[S[3,,RR/#)rrrxrOrN)rr r r)rrs"rrr[sCLLSLSLW_`dehjmem`nWoL{Lrc  VeVfR#\\VRR4RR4pVe\VR4'gR#T;'g/PR4;'g\VRR4;'gRpVP\ V4\ V4VR7pT'd$\ PR TPY4R#R# \ d(\ PR TPYR R 7R#i;i) uDrop the stale ``telegram_dm_topic_bindings`` row for a topic Telegram confirmed deleted, else ``_recover_telegram_topic_thread_id`` keeps steering inbound to the dead thread. Best-effort. Rows are namespaced by profile: the send's ``hermes_profile`` wins over the adapter's stamp. Without this prune the recovery logic in ``gateway.run._recover_telegram_topic_thread_id`` keeps steering future inbound messages to the dead thread (the bug behind #31501 — tool progress, approvals, replies all end up in the wrong place even though the user has moved on to a fresh topic). Best-effort: we never raise from a send-fallback path — a failed cleanup must not turn into a failed user-facing send. Under ``gateway.profile_routes`` the transport adapter may not be the profile that wrote the binding, so the send's ``hermes_profile`` metadata wins over the adapter's own profile stamp; single-profile bots fall back to ``"default"``. See #76423. N_session_store_dbdelete_telegram_topic_bindinghermes_profile_hermes_profile_namerr)rrx profile_nameuR[%s] delete_telegram_topic_binding failed for chat=%s thread=%s — skipping pruneTr3zY[%s] Pruned stale Telegram DM topic binding chat=%s thread=%s (Bot API: thread not found)) r]hasattrrr%rr*r7r8rr)rrrxrOdbr(removeds&&&$ r_prune_stale_dm_topic_binding-TelegramAdapter._prune_stale_dm_topic_binding[s ?i/  WT#3T:E4 H :WR)HII  $NN//0@A}}WTSikoEp}}t}L66s7|WZ[dWeuA6BG  KKkmqmvmvx L    LLd 7  >   s#C C C 3)C .C;:C;c&<V^8dQhRS[RS[/#rr)rrs"rrr{sY4rcVPPP4pVR8XgVPR4'dR#^RIHp\ W4# \dR#i;i) badrequestT BadRequestF)rr(rendswithtelegram.errorr2 isinstancerD)rrr2s& r_is_bad_request_error%TelegramAdapter._is_bad_request_errorzsX''--/ < 4==#>#>  1e0 0  sA A&%A&ch<V^8dQhRS[RS[S[S[S[3,,RS[S[,RS[/#)rrrOrr)r*r r rrrrB)rrs"rrrsFDDD)1$sCx.)ADX`adXeDjnDrc ZaVPV4'dVPV4'gR#\V4P4oVe RS9dR#VP R4'gR#Rp\ ;QJdV3RlV4F 'gK R# R#!V3RlV44#)uTrue when a DM-topic send should be retried with routing stripped: (1) stale anchor — reply target deleted; (2) anchor-less synthetic send whose ``direct_messages_topic_id`` Bot API rejects. 2. The synthetic-event case (added when #27937 introduced ``direct_messages_topic_id`` fallback for sends without an anchor): if Bot API rejects the topic id itself with any BadRequest that mentions topic/thread routing, we retry without routing rather than dropping the message. Fmessage to be replied not foundTrc3,<"TF qS9xK R#5irPrQ)rRmarker err_lowers& rrTNTelegramAdapter._should_retry_without_dm_topic_reply_anchor..sC]6Y&])direct_messages_topiczmessage thread not foundr topic_closed topic_deletedztopic not found)rr6rrrr)rrrOr topic_markersr=s&&&& @r+_should_retry_without_dm_topic_reply_anchor;TelegramAdapter._should_retry_without_dm_topic_reply_anchors%%h//s7P7PQV7W7WJ$$&  */PT]/]||677I sC]CssCsCsC]CCCrc<V^8dQhRS[RS[S[S[3,RS[S[S[S[3,,RS[S[,RS[RS[S[,RS[/#)rsend_fn send_kwargsrOr media_label reset_mediar)rr rr r)rrs"rrrsoDDD)-c3hDCKDQTVYQYNC[D%c]D9<DKSTW=DdgDrc "VPVPR44;_uu_4GRjxL \V!R /VB\RRR7GRjxL uuRRR4GRjxL #L8LL \dpTP YsT4'gh\ PRTPT\T44TeT!4\T4pRTR&TPRR4TPR R4\T!R /TB\RRR7GRjxL uRp?uuRRR4GRjxL #Rp?ii;i +GRjxL 'giR#;i5i) zRetry stale private-topic media replies once without the topic anchor. Serialized per chat with ``send()`` so a file upload cannot land between two chunks of the text it accompanies.rNztelegram-media-sendFr?r;r=zR[%s] Reply target deleted for Telegram %s, retrying without reply/topic anchor: %srrrrQ) _chat_send_lockrrK_MEDIA_SEND_DEADLINEr*rDr7r-rr,r rY) rrGrHrOrrIrJsend_err retry_kwargss &&&&&&& r&_send_with_dm_topic_reply_anchor_retry6TelegramAdapter._send_with_dm_topic_reply_anchor_retrysG ''  (BCCC D8*k*4HPe}BCCDCCCD DGG\opphII{,G,QS*M#K0 6: 23  !4d;  !;TB8+l+5IQf~CDDDD!DCC D DCCCs-EA(ED>A.A*A. E"A,#E*A.,E. D;9BD6D D6D;D>" E/D20E6D;;D>>E E E E  Ec0<V^8dQhRS[S[,/#r)listr)rrs"rrrscctCycrc 8\VPRR4'd'VPPPR.4M.p\ V\ 4'dVP R4p\V'dRPRV444#R4#)zNReturn validated fallback IPs from config (populated by _apply_env_overrides).rN fallback_ipsroc38"TFp\V4xK R#5irPr)rRr s& rrT0TelegramAdapter._fallback_ips..s-Ijc!ffjs) r]rrrr5rrrrrhr configureds& r _fallback_ipsTelegramAdapter._fallback_ipsswBI$++W^`dBeBeT[[&&**>2>km j# & &#))#.J$ZSXX-Ij-I%Ibb]abbrc&<V^8dQhRS[RS[/#rr)rrs"rrrs::I:$:rc\V4P4pVPPP4R8H;'gRV9;'gRV9#)conflictz&terminated by other getupdates requestzanother bot instance is running)rrrr()rr+s& r_looks_like_polling_conflict,TelegramAdapter._looks_like_polling_conflictsX5z! OO $ $ * * , : 9 974? 9 90D8 :rc&<V^8dQhRS[RS[/#rr)rrs"rrrs  i D rc VPPP4R9dR#^RIHpHp\ WV34# \dR#i;i)uTrue for terminal credential failures (InvalidToken, Forbidden) → retryable=False. Type-based only, never message text; BadRequest/RetryAfter are transient at connect time.T) Forbidden InvalidTokenF> forbidden invalidtoken)rr(rr4rdrer5rD)rrdres& r_looks_like_auth_error&TelegramAdapter._looks_like_auth_errorsM ?? # # ) ) +/L L  >eI%>? ?  sA AAc&<V^8dQhRS[RS[/#rr)rrs"rrrs***t*rc *VPPP4pVR9dR#VR9dR#^RIHpHpHpHpHpH p\WWCV34'dR#\WV34'dR#\V\4# \dLi;i)zDReturn True for transient transport failures that warrant reconnect.FT)r2rdre NetworkError RetryAfterTimedOut>rfr0 retryafterrg>timedout networkerrorconnectionerror) rr(rr4r2rdrerlrmrnr5rDr')rrr2rdrerlrmrns& r_looks_like_network_error)TelegramAdapter._looks_like_network_errors''--/ L L B B  n n%lz!RSS%!9::;%))   s$BB BBc2<V^8dQhRS[RS[RS[RS[/#)rr name_marker text_markersrr*rrB)rrs"rrrs+ TW\`rc 4a\V4Fp\V4P4oWPPP49gC\ ;QJdV3RlV4F 'gK RM RM!V3RlV44'gKR# R#)zYTrue when any exception in ``error``'s cause/context graph matches by class name or text.c3,<"TF qS9xK R#5irPrQ)rRr7r+s& rrT;TelegramAdapter._exception_graph_matches..sCdWcRSIWcr?TF)rbrrrr(r)rrvrwr`r+s&&* @r_exception_graph_matches(TelegramAdapter._exception_graph_matchessg)/Cs8>>#Dmm44::<<CdWcCdCdWcCd@d@d0rc&<V^8dQhRS[RS[/#rr)rrs"rrrsmm mdmrc *VPVRRR4#)zTrue when a TimedOut wraps a ConnectTimeout: TCP never connected, so re-sending is safe (a plain TimedOut may have reached Telegram and must not be re-sent).connecttimeoutzconnect timeoutzconnect timed out)r|)rrs&&r_looks_like_connect_timeout+TelegramAdapter._looks_like_connect_timeouts++E3CEVXkllrc&<V^8dQhRS[RS[/#rr)rrs"rrrs drc \V4FapVPPP4p\ V4P4pRV9gRV9gRV9gKWRV9gK`R# R#)zTrue when a TimedOut wraps ``httpx.PoolTimeout``: PTB says "Request was *not* sent", so re-sending cannot duplicate. Matches class AND text to survive rewording. pooltimeoutz pool timeoutzconnection pooloccupiedTF)rbrr(rr)rr`rr+s& r_looks_like_pool_timeout(TelegramAdapter._looks_like_pool_timeoutsd)/C==))//1Ds8>>#D$$(>CTX\C\akosas 0 rFc,<V^8dQhRS[RS[RS[/#)rrrrrr')rrs"rrrs"  c D T rc<\VPRR4'd&VPPPV4MRpVfV#\ V\ 4'd3VP 4P4pVR9dR#VR9dR#V#\V4#)rNTF>ronrr>0norfalse) r]rrrr5rrrrB)rrrrrHlowereds&&& rr"TelegramAdapter._coerce_bool_extras.5dkk7D.Q.Q !!%%c*W[ =N eS ! !kkm))+G4455NE{rc6<V^8dQhRS[S[S[3,/#rr rr)rrs"rrrs22d38n2rc`\VRR4'g/#\eR\RR7/#RR/#)rFlink_preview_optionsT) is_disableddisable_web_page_preview)r]rtrs&r_link_preview_kwargs$TelegramAdapter._link_preview_kwargss9t5u==I  )*,>4,PQ Q*D11rc&<V^8dQhRS[RS[/#rcontentrr')rrs"rrrs;;;;rc 2\V4VP8*#)zXPre-check the 32,768-char cap only; other rich limits surface as BadRequest (permanent).)r+RICH_MESSAGE_MAX_CHARSrrs&&r_content_fits_rich_limits)TelegramAdapter._content_fits_rich_limitss7|t::::rc <V^8dQhRS[/#rr.)rrs"rrrsWWDWrc X\P!\VPRR44#)uTrue when ``do_api_request`` is an *async* callable (real Bot or AsyncMock); plain MagicMock and SimpleNamespace bots resolve False → legacy path.do_api_requestN)inspectiscoroutinefunctionr]rrs&r_bot_supports_rich"TelegramAdapter._bot_supports_richs$**7499>NPT+UVVrz]*>.*?z(\$\$.*?\$\$|\\\[.*?\\\]|\\\(.*?\\\)|\\(?:sum|frac|alpha|beta|gamma|delta|theta|lambda|mu|pi|sigma|int|prod|sqrt|lim|infty|begin\{(?:equation|align|matrix|cases)\}))u.[぀-ヿ㐀-䶿一-鿿가-힯豈-﫿𠀀-𲎯]c&<V^8dQhRS[RS[/#rr')rrs"rrr"sttctdtrc aV'gR#\;QJd8V3RlSPPV44F 'gK R# R#!V3RlSPPV444#)zMath inside
crashes Telegram Desktop 6.9.1 (tdesktop#30808); the Bot API accepts the payload, so rich delivery must be skipped up front.Fc3Z<"TF pSPPV4xK" R#5irP)_RICH_MATH_IN_DETAILS_REsearch)rRblockrs& rrTQTelegramAdapter._has_telegram_desktop_details_math_crash_shape..'s'sLr540077>>Lrs(+T)r_RICH_DETAILS_REfindallrsf&r._has_telegram_desktop_details_math_crash_shape>TelegramAdapter._has_telegram_desktop_details_math_crash_shape"sXssDLaLaLiLijqLrssssssssDLaLaLiLijqLrsssrc&<V^8dQhRS[RS[/#rr')rrs"rrr)sCC3C4Crc ^\T;'dVPPV44#)aZTrue for CJK content: Telegram Mac/Desktop rich rendering leaves overlapping glyphs. Telegram Mac/Desktop Bot API 10.1 rich-message rendering currently leaves overlapping draft/overlay glyph artifacts for CJK text (#47653). The legacy MarkdownV2 path renders the same text cleanly, so skip rich delivery up front until affected clients age out. )rB _RICH_CJK_RErrs&&r+_has_telegram_desktop_cjk_rich_garble_shape;TelegramAdapter._has_telegram_desktop_cjk_rich_garble_shape)s(GAA 1 1 8 8 ABBrc&<V^8dQhRS[RS[/#rr')rrs"rrr2sSTrc LV'gR#\;QJd*RVP44F 'gK RM RM!RVP444'dR#\P!RV4'dR#\P!RV4'dR#RV9#)aTrue for constructs MarkdownV2 degrades: pipe tables, task lists,
, block math. Ordinary replies stay on MarkdownV2 so clients render consistent font weight/spacing. The rich endpoint is reserved for constructs where raw markdown materially improves output: pipe tables (MarkdownV2 has no table syntax and rewrites them into bullet lists), GFM task lists, collapsible ``
`` blocks, and block math. Adapted from #45995 (@YonganZhang). Fc3N"TFp\P!V4xK R#5irP)_TABLE_SEPARATOR_REmatchrRrs& rrT8TelegramAdapter._needs_rich_rendering..<s!P;O4"((..;Os#%Tz(?m)^\s*[-*]\s+\[[ xX]\]\s+z3(?m)^|^z$$)r splitlinesrUrrs&&r_needs_rich_rendering%TelegramAdapter._needs_rich_rendering2st 3P7;M;M;OP333P7;M;M;OP P P 993W = = 99KW U Uwrc <V^8dQhRS[/#rr.)rrs"rrrDsCCCrc .\\VRR44#)z>r ?@@DDkDkltDuDu""7++rc <V^8dQhRS[/#rr.)rrs"rrrqsMM4Mrc\\VRR4;'d+\VRR4'*;'dVP44#)rTrF)rBr]rrs&r_rich_transport_available)TelegramAdapter._rich_transport_availableqs^ D2D 9 L L'$PeglBm>m L LrvsJsJsLM Mrc0<V^8dQhRS[S[,/#r)r r)rrs"rrrusYY(3-Yrc JVP4'd VP#R#)uLet the stream consumer accumulate up to the rich cap so a reply that fits one sendRichMessage isn't fragmented at 4,096. None (→ legacy limit) if rich is unavailable.N)rrrs&rstreaming_overflow_limit(TelegramAdapter.streaming_overflow_limitus$/3.L.L.N.Nt**XTXXrskip_entity_detectioncB<V^8dQhRS[RS[RS[S[S[3,/#)rrrr)rrBr r)rrs"rrrzs/SD]abegjbj]krc :R\V4/pV'dRVR&V#)u}``InputRichMessage`` from RAW markdown — never ``format_message(content)``, whose MarkdownV2 escaping destroys table pipes.markdownTr)rj)rrrpayloads&&$ r_rich_message_payload%TelegramAdapter._rich_message_payloadzs'$./I'/R"S /3G+ ,rc&<V^8dQhRS[RS[/#rexcrr)rrs"rrrs % %Y %4 %rc :VPPP4R 9dR#\V\\ \ 34'g\VRR4R8XdR#\V4P4pRV9gRV9dRV9gRV9dR#R V9#) uTrue ⇒ the rich endpoint itself is unavailable (old PTB/server); latches rich off. Per-message BadRequests (parser/limit) are NOT capability errors.T error_codeNimethodendpointz not foundzdoes not existzno such method>rgendpointnotfound) rr(rr5rErNotImplementedErrorr]rrrss&& r_is_rich_capability_error)TelegramAdapter._is_rich_capability_errors == ! ! ' ' )-Q Q cNI7JK L LPWX[]ikoPptwPw HNN  MZ1_;!3CGW[\G\1$$rc&<V^8dQhRS[RS[/#rr)rrs"rrrs<<9<.s# ^1L1A1LsN)rrrrnextr_should_thread_replyr) rrrrOrxrmetadata_reply_toprivate_dm_topic_senddm_topic_reply_to_offreply_to_source should_thread reply_to_ids &&&&&& r_chunk_reply_routing$TelegramAdapter._chunk_reply_routings !>>xH $ > >wS[ \ 5 | |$:M:MQV:V | |[_[r[rs{[| ^1J81TlAVgGK1L ^`de +47XXD   /!..s7|S_gV V V   s1A .;9;A ; A A  A  A c ~<V^8dQhRS[RS[RS[S[,RS[S[S[S[3,,RS[S[,/#rrrrrOrrr r rr)rrs"rrrsX(h(h(h%((h4P)>!)>PQt00:;  "+7*EG& ' a4 (():w(O+?Y^``C c4 .J!!ggh/552::<H  lD9J  !((*gF F F$jF\3z?ggbfgg;Q` a""3(9<HH"3 t>;KR]][#(!#5L..s4ES_.` ` a" GszAIE? ,E? 23I&1FFFAI:II+IF H?H:+I1BH:4H?5I:H??IcB<V^8dQhRS[RS[RS[S[S[3,/#)rrrrrr r)rrs"rrrs*#S#XrcvR\V4RVPV4/p\VRR4'dRR/VR&V#)r rich_messagerFrTr)rrr])rrrrs&&& rr2"TelegramAdapter._rich_payload_basesT#,.H.QSacgc}c}FdG#H 415 9 9/^ cR\o^ L- (():w(O+?Y^` ` `$$W'BBB$:>> ` LS!11//449W9WX[9\9\/3D,!$:FF""3(>@QRR..s4JK K L Cs|!D31BBBD3/D10D3B D.4D)D)D)-D..D33D) D3D)#D.$D3)D..D3c&<V^8dQhRS[RS[/#rr')rrs"rrr"s00#0$0rc\\VRR4;'d[\VRR4;'dF\VRR4'*;'d,\VRR4'*;'dVPV44#)rTrFrr)rBr]rrs&&r_should_attempt_rich_draft*TelegramAdapter._should_attempt_rich_draft"s D2D 9 / /4e< / /D"7?? / /D"8%@@ / /%%g. 0 0rc ^<V^8dQhRS[RS[RS[RS[S[S[S[3,,RS[/#rrdraft_idrrOr)rrr r rrB)rrs"rrr*sD#s^fgkloqtltgu^v{rc 8"R\V4R\V4RVPV4/pVPVP W44\ \ VPPRVR7\RRR7GR jxL 4#L \dpTPT4'd3R Tn \PR TP\!T44M*\PR TP\!T44R p?R#R p?ii;i5i) zEmit one ``sendRichMessageDraft`` frame; True on success. Frames are ephemeral, so any failure returns False and the caller renders the legacy draft; capability failures latch off.rrPr?sendRichMessageDraftr-r/FrLNTuB[%s] sendRichMessageDraft unsupported (%s) — using legacy draftsuL[%s] sendRichMessageDraft transient failure (%s) — legacy draft this frame)rrrrr rBrKrrr3r*rrr7r8rr,)rrrPrrOrrs&&&&& r_try_send_rich_draft$TelegramAdapter._try_send_rich_draft*s# 1':JH WegkhBhBCJhK#Lt44WGH 9 (()?G(T+?Y^``a a` --c22,0) XZ^ZcZcfABEfFG bdhdmdm/46 sCA D 6BB B D B DA3D DDDc<V^8dQhRR/#rdrQ)rrs"rrr?sAA$Arc *"VP'dVPP'gR#VPPP^,pTP TP 4R4GRjxL 'gTP T4TP TP4R4GRjxL 'd#\PRTP4R#TP T4R# \dR#i;iLLS5i)uReset the httpx pool used for getUpdates polling before a reconnect. Half-closed connections (esp. via proxies) occupy pool slots until "Pool timeout: All connections in the connection pool are occupied". Only ``_request[0]`` (getUpdates) is reset; the general request stays untouched so concurrent sends are never interrupted. Relies on PTB 22.x's private ``(get_updates, general)`` tuple — review on PTB 23+.Nz5Polling request shutdown failed/timed out (non-fatal)z:Polling request re-initialize failed/timed out (non-fatal)z2[%s] Polling request pool drained before reconnect) rrfrgr*_bounded_request_steprh"_orphan_and_rebuild_polling_client initializer7r8r)r polling_reqs& r_drain_polling_connections*TelegramAdapter._drain_polling_connections?s  diimmm  ))--003K // 0D0D0FHAAA  3 3K @++K,B,B,DGCD D D LLMtyy Y  3 3K @   A DsW.DD'C=#D>D? D 4D=D> D5D= D D D  DDc&<V^8dQhRS[RS[/#)r failure_msgrr')rrs"rrrWs#$rc "\V\R7GRjxL R#L \d.\P RT,TP RR7R#i;i5i)zbAwait a request shutdown()/initialize() under ``_DRAIN_TIMEOUT``; False (debug-logged) on failure.r?NTz[%s] r3F)rK_DRAIN_TIMEOUTr*r7r8r)rrIr^s&&&rrW%TelegramAdapter._bounded_request_stepWsO -iP P P Q  LL;. DL I s1A!!A!4AAAAc<V^8dQhRR/#rdrQ)rrs"rrr`s###rc naa\VRR4o\VRR4pSe%\V4'd\SRR4'dR#V!4Vn\PRSP 4R TT3R llp\P!T!44pSPPT4TPSPP4TP\4R# \d'\P RSP RR7R#i;i \dR#i;i) aReplace a wedged HTTPXRequest client after a hung aclose(): swap in a fresh client and close the old one in a detached, bounded task so it can't block the reconnect ladder. PTB's ``HTTPXRequest.initialize()`` only calls ``_build_client()`` when the current client reports ``is_closed``. If ``shutdown()`` was abandoned on a CLOSE-WAIT socket, that flag stays false and the next ``start_polling()`` reuses the dead getUpdates connection (#87057). _clientN _build_client is_closedTz;[%s] Failed to rebuild polling HTTP client after hung drainr3zZ[%s] Replaced wedged getUpdates HTTP client after drain timeout (likely CLOSE-WAIT socket)cV^8dQhRR/#rdrQ)rs"rrHTelegramAdapter._orphan_and_rebuild_polling_client..__annotate__ss o od orc<"\SRR4p\V4'gR#\V!4\R7GRjxL R#L \d'\ P RSPRR7R#i;i5i)acloseNr`z4[%s] Orphan polling client aclose failed (non-fatal)Tr3)r]rfrKrar*r7r8r)rkoldrs r_orphan_acloseJTelegramAdapter._orphan_and_rebuild_polling_client.._orphan_aclosesse o h5''1&(NSSS o SUYU^U^im n osBA;AA;AAAA;A-A84A;7A88A;)r]rfrer*r7r8rr-r0 ensure_future_background_tasksr[add_done_callbackdiscardr9)rrZbuildrmr.rlsf& @rrX2TelegramAdapter._orphan_and_rebuild_polling_client`s k9d3 _d; ;huook41P1P  "''K  suyu~u~ o o (()9:D  " " & &t ,  " "4#9#9#A#A B  " "#: ;'  LLVX\XaXalpL q  (   s% C1?A0D%1-D"!D"% D43D4c<V^8dQhRR/#rdrQ)rrs"rrrs(((rc "RVnRVnR#)z>Mark polling closed: no progress accepted, send path degraded.FTN)rrrs&r_fence_pollingTelegramAdapter._fence_pollings+0(#' rcJ<V^8dQhRS[S[S[P3,/#r)rrr0r)rrs"rrrs%FF5gmm1C+DFrc dVP'dLVP4\VRR4pVf\P!4;qn\VR^4V3#\VRR4pVe'VP 4'gVP4RVn\VR^4^,Vn \P!4VnRVn RVn \P!4VnRVn^;VnVn^;VnVnVPVP 3#)zAStart accepting progress for a new getUpdates polling generation.rNrrT)rrwr]r0rrdonecancelrrrrtime monotonicrrrrrr)rprogressverifiers& r_begin_polling_generation)TelegramAdapter._begin_polling_generations  ! ! !    !t%>EH:A--/I74!6:HD D4!BDI    OO /3,#*41F#JQ#N '.}}$+/(#' 6:^^5E204-IJI$t'EKLL%(H'')E)EEErc&<V^8dQhRS[RS[/#)r generationr)rrB)rrs"rrrs34rc zVP'g#VP'dWP8wdR#VPP 4'g8VP 'dRMRp\ PRVPW!4VPP4\P!4Vn ^VnWP8Xd RVn M^VnVP'd;\!VRR4'd(VP"'gVP%RRRRR7RVnR #) zURecord successful getUpdates I/O for the current generation only; True when accepted.F recoveredzconfirmed healthyz@[%s] Telegram polling %s: getUpdates progressing (generation %d)N_running connected)platform_stater error_messageT)rrrris_setrr7rrrXr}r~rrrrr]has_fatal_error_write_runtime_status_safe)rrstates&& r_record_polling_progress(TelegramAdapter._record_polling_progresss  ! ! !)I)I)IZ[s[sMs++2244$(#D#D#DKJ]E KKZ\`\e\egl y $$((*040@-,-) CC C9=D 6+,D (  # # #j%(H(HQUQeQeQe  + +KDX\ , $) rc jVwrEVe^Tu;8:d R8gR#R#VPV4p\T\4'd\TP R4RJdERT9d<TP T4'd#TP TP R44R#R#R#R#R# \dR#i;i)zRecord getUpdates progress from an observed do_request result (purely observational: PTB still parses the untouched payload and owns any resulting exception).Ni,okTrJ)parse_json_payloadr*r5r rr_record_updates_received)rrlrrJ status_coderenvelopes&&&& r_observe_polling_request_result/TelegramAdapter._observe_polling_request_results &  c[&>3&> '?  11':H h % %(,,t*<*DU]I],,Z88--hll8.DE9J^*D %   sB## B21B2c<V^8dQhRR/#rdrQ)rrs"rrrs88$8rc \V\4'd/V'd%V;P\V4, unR#R#R#)zCount updates Telegram handed us on the getUpdates wire (#102260). Only reached for the accepted generation, so a late response from a fenced poll cannot inflate the backlog.N)r5rTrr+)rrJs&&rr(TelegramAdapter._record_updates_receiveds0 fd # #  ( (CK 7 ()/ #rc FaVo!V3RlR\V44pW!nV#)uInstrument one dedicated PTB getUpdates request with progress tracking. PTB request classes use ``__slots__`` (no ``__dict__`` on 3.13), so re-tag the instance to a thin ``__slots__ = ()`` subclass overriding ``do_request`` — identical layout makes the ``__class__`` swap legal; works for test doubles too. On Python 3.13 their instances no longer carry a ``__dict__`` (the ``AbstractAsyncContextManager`` MRO stopped yielding one), so ``request.do_request = wrapper`` raises ``AttributeError: 'HTTPXRequest' object attribute 'do_request' is read-only`` and the whole Telegram connect fails (#64482). It only appeared to work on Python 3.12, where those instances still had a ``__dict__``. c:<aa]tRtRtoRtVV3RltRtVtV;t#)PTelegramAdapter._instrument_polling_request.._InstrumentedPollingRequestic<"\P4p\SV` !V/VBGRjxL pSP WV4V#L5irP)_POLLING_GENERATION_CONTEXTrr do_requestr)rargsrrrJradapters&*, rr[TelegramAdapter._instrument_polling_request.._InstrumentedPollingRequest.do_requestsF8<<> $w14B6BB77&Q Cs(AAArQ) r(rrr __slots__rr__classdictcell__ __classcell__)rrrs@@r_InstrumentedPollingRequestrsI  rr)r'r)rrlrrs&& @r_instrument_polling_request+TelegramAdapter._instrument_polling_requests' $w- 8rabandon_app_on_timeoutschedule_verifierc \<V^8dQhRS[RS[RS[RS[S[S[P3,/#)rdrop_pending_updatesrrr)rBrrr0r)rrs"rrrs;$$$$,0$$Z^$$$$+0gmm1C+D$$rc aaa "SP'd \R4hSP4wo pSP'g \R4hRVV V3Rllp\P S 4p\ VPP\PW'R7\V'dV3RlMRR7GRjxL \PV4SP'dSP4\R4hV'dSPS V4S V3#Ld \PT4i;i5i)zStart one generation and verify real getUpdates progress. Returns this generation's ``(generation, progress_event)`` so readiness-gating callers bind to exactly it.z!Telegram polling teardown startedc(V^8dQhR\RR/#rrrNr*)rs"rr9TelegramAdapter._start_polling_once..__annotate__s J Ji JD Jrc<SP'gSSP8wgSfR#\PR4pS!V4\P V4R# \P T4i;irP)rrrrXreset)rcallback_context_tokenerror_callbackrrs& r_generation_error_callbackGTelegramAdapter._start_polling_once.._generation_error_callbacksd%%%t7O7O)OSaSi%@%D%DT%J " Ju%+112HI+112HIs A A7)allowed_updatesrrc\V4#rPrmrks&r5TelegramAdapter._start_polling_once..s -DS-IrN)r?r:)rrtrrrrXrKupdater start_pollingro ALL_TYPES_UPDATER_START_TIMEOUTrrw#_schedule_polling_progress_verifier) rrkrrrrrr context_tokenrs f&$d$$ @r_start_polling_once#TelegramAdapter._start_polling_onces   ! ! !()LM M#==? H///()LM M J J477 C  =. ))$*$4$4K_*L.NdIjn q q q ( - -m <  ! ! !    !()LM M   4 4Z J8## q ( - -m >Ec><V^8dQhRS[RS[PRR/#rrrrN)rr0r)rrs"rrrs'99c9W]]9_c9rc aSP'dSP4R#\SRR4pVe'VP4'gVP 4\ P !4PSPW44pVSn SPPV4RV3RllpVPV4R#)z.__annotate__s < ._clear_finished_verifiers3  " " * *8 433x?7;4@r) rrwr]r{r|r0get_running_loop create_task_verify_polling_after_reconnectrrpr[rq)rrrpreviousr.rsf&& rr3TelegramAdapter._schedule_polling_progress_verifiers  ! ! !    ! 4!BDI    OO '')55d6Z6Z[e6pq/3, ""4( < < 78rc4<V^8dQhRS[P/#r)r0r)rrs"rrr%src^\VRR4pVf\P!4;qnV#)rN)r]r0rr)rlocks& r_get_general_request_drain_lock/TelegramAdapter._get_general_request_drain_lock%s,t:DA <6=lln DD3 rc<V^8dQhRR/#rdrQ)rrs"rrr+skkTkrc P"\\VRR4RR4pVf\VRR4pVfR#VP^,pTP4;_uu_4GRjxL TP TP 4R4GRjxL TP TP 4R4GRjxL 'd!\PRTP4RRR4GRjxL R# \dR#i;iLLxLRL +GRjxL 'giR#;i5i)uReset the general Bot API pool (``_request[1]``) after a confirmed send pool timeout — PTB guarantees the request was not sent, so resetting before retrying is safe.rNrfrzHGeneral request shutdown failed/timed out after pool timeout (non-fatal)zMGeneral request re-initialize failed/timed out after pool timeout (non-fatal)z=[%s] General request pool drained after Telegram pool timeout) r]rgr*rrWrhrYr7r-r)rrf general_reqs& r-_drain_general_connections_after_pool_timeout=TelegramAdapter._drain_general_connections_after_pool_timeout+sgdFD15$? ;$-C ;  ,,q/K77999,,$$&(rt t t//&&(*y{{{^`d`i`ij :99   9 t{:999s0D&C/D&"D#D&&$D  D 'D 2D3 D = D  D&(D)D&/ C>:D&=C>>D&D D D& D# D D# D#  D&c<V^8dQhRR/#rdrQ)rrs"rrr>sSSTSrc VPV4VnVPPVP4VPP VPP 4R#)zIStart ``coro`` as the tracked in-flight recovery task (reentrancy guard).N)rrrpr[rqrr)rloopcoros&&&r_spawn_polling_recovery'TelegramAdapter._spawn_polling_recovery>sO#'#3#3D#9  ""4#;#;<   2243I3I3Q3QRrc <V^8dQhRS[/#rr.)rrs"rrrDsVVTVrcz\VP;'d VPP4'*4#rP)rBrr{rs&r_recovery_in_flight#TelegramAdapter._recovery_in_flightDs-D,,TTT5M5M5R5R5T1TUUrc*<V^8dQhRS[RS[RR/#)rrreasonrN)r*r)rrs"rrrGs'll lcldlrc nVP'gVP'dR#VP4'd.\P RVP V\ V44R#RVn\VRR4'dVP4\V\4'd-\PRVP V\ V44M+\PRVP V\ V44VP\P!4VP!V44R#)zSchedule background polling recovery without failing gateway startup: a transient bootstrap failure degrades only this adapter; the reconnect ladder recovers in the background.NzA[%s] Telegram polling recovery already scheduled; ignoring %s: %sTrFzk[%s] Telegram polling stall confirmed (%s); handing off to the supervisor for an adapter rebuild. Error: %szR[%s] Telegram polling degraded (%s); gateway stays alive and will retry. Error: %s)rrrr7r8rr,rr]_mark_degradedr5rxr-rr0r_handle_polling_network_error)rrrs&&$r_schedule_polling_recovery*TelegramAdapter._schedule_polling_recoveryGs  ! ! !T%9%9%9   # # % % LLSUYU^U^`fiDEJiK L #'  4U + +    ! e/ 0 0 NN!YY0KE0R T NNdfjfofoqw+E2 4 $$W%=%=%?AcAcdiAjkrrequire_successc&<V^8dQhRS[RS[/#)rrrr.)rrs"rrrbsDUYrc "VP'gR#\VPRR4p\V4'gR#\V!RR7\R7GRjxL R#L \ dipTP T4'ghT'd \R4Th\PRTP\T44RTn Rp?R#Rp?ii;i5i) zClear a stale webhook; ``require_success`` (cold start) raises so GatewayRunner disposes the partial adapter, while reconnects recover transient errors in background.Fdelete_webhookNT)rr`z>Telegram deleteWebhook did not complete during initial connectzu[%s] deleteWebhook failed with a recoverable network error; continuing to polling so getUpdates/retry can recover: %s) rr]rfrKrr*rsr'r7r-rr,r)rrrerrs&$ r_delete_webhook_best_effort+TelegramAdapter._delete_webhook_best_effortbsyyy , **+=+B+B+DE  T- m8gF]F]^iJK K K&2xxzzJJL3..dS S S  1 1c.|A?@B q/ "  [\ \!% K >4S9:cc     T&2xxzzJJL3..dS S SsA G 9EEE G)/GE. G%G;;G7 GE E+E&&E++E0.G0G/G>G?GGrequire_progressc,<V^8dQhRS[RS[RS[/#)rrrrr.)rrs"rrrs(<<d<nr<@D<rc aa a a a "VP'dR#VP'dVPP'g \R4h.o \P !4o Ro SpV'd%\P !4o RVV V V V 3RllpTpVPVPWVV'*R7GRjxL wrgV'd%VPVS S 4GRjxL Ro SVn R#L4L \dR#\dpTP'dRp?R#T'dhTPT4'de\PRTP\!T44TP#\P !4TP%T44Rp?R#TP'T4'dTP)TR R 7Rp?R#hRp?ii;i5i) zStart PTB polling; ``require_progress`` (initial connect) demands real readiness. Reconnects may recover in background; on cold start a bootstrap failure raises (see _await_cold_start_readiness).Fz,Telegram application/updater not initializedTc(V^8dQhR\RR/#rr)rs"rr>TelegramAdapter._start_polling_resilient..__annotate__s B Bi BD Brc<S'gSe S!V4R#S'gSPV4SPSP4R#rP)rdcall_soon_threadsaferX)rrrrrstrict_gate_opens&r_strict_error_callbackHTelegramAdapter._start_polling_resilient.._strict_error_callbacks='%1&u-# ''.))*<*@*@Ar)rrrrNz[[%s] Telegram polling bootstrap conflict; gateway stays alive while conflict retry runs: %szpolling bootstrapr)rrr RuntimeErrorr0rrrrrrtr*r`r7r-rr,r_handle_polling_conflictrsr) rrrreffective_callbackr _generationrrrrrrs &$d$ @@@@r_start_polling_resilient(TelegramAdapter._start_polling_resilients  ! ! ! dii///MN N-/ $]]_+ ++-D B B"8   +/*B*B 0D'7&6"6 +C+8%8 !K  66xASUabbb#( 3A0%8 c &  %%%0055qII:3?A,,W-E-E-GIfIfgjIkl--c22// [,8, 64P//111sAA A A c&<V^8dQhRS[RS[/#)rrrr')rrs"rrrsrc "V'dcVP'dQVPP'd5\VPP4\R7GRjxL R#R#L \ d2RT R2pTP TRTPT4GRjxL R#i;i \dR#i;i5i)a:Bounded ``updater.stop()`` before a recovery restart; False = went fatal, caller returns. Wall-clock deadline, not asyncio.wait_for: a CLOSE-WAIT socket wedges stop() on epoll and PTB/AnyIO shielded cleanup hangs wait_for. On timeout the Updater's lifecycle lock may still be held, so rebuild the adapter instead.r`Nz2Telegram updater.stop() did not finish before the zg deadline; rebuilding the adapter instead of reusing an Updater whose lifecycle lock may still be held.z"[%s] %s (likely CLOSE-WAIT socket)FT) rrunningrKstop_UPDATER_STOP_TIMEOUTrGrrr*)rrkrr%s&&& r_stop_updater_or_go_fatal)TelegramAdapter._stop_updater_or_go_fatals s{{{s{{':':':!5ckk6F6F6HRghhhi#!LTFSww00:^`d`i`ikrsss !    snCB1B1,A2'A0(A2,C0A222B.$B'%B.*B1+C-B..B11 C<C?CCc<V^8dQhRR/#rdrQ)rrs"rrrsPPPrc X\P!4PV4VnR#)zJRun a recovery coroutine as the tracked in-flight ``_polling_error_task``.N)r0rrr)rrs&&r_restart_polling_in_task(TelegramAdapter._restart_polling_in_tasks#*#;#;#=#I#I$#O rc$<V^8dQhRS[RR/#rr)rrs"rrrsF0F0F0tF0rc "VP'gVP'dR#\V\4'd8R\ V4 R2pVP VRVP V4GRjxL R#^ p^p^QRS=TULM ((2JDIIW^`{}BaCD D D J!! "45yA Y[_[d[dfm (CE(J LmmE"""  ! ! ! ii33C9KLLLPTPfPfPf   ( ( / /DDF F F  ! ! ! --///  ! ! !  0"#XYY**3U[_[{[{*| | | KKvx|yByBDK LO u D #M G 0 }&   0%%% NNGTopyTz {'''0F0F0F,,T-O-OPY-Z[&&**40&&t'='='E'EF+/(( 1G' 0s$NAN/I20A0N I5!A,N I8N$#NI; NN$N=NI=N'N<I?=NNJ,J J %J0N5N8N;N=N?NJ NNNNM>-N3A M>A+M>,N>NNc<V^8dQhRR/#rdrQ)rrs"rrr8sRYRYtRYrc "^Zp^pRpRp\P!V4GRjxL VP'gVP'dR#VPpVeVP 4'g\ P!4pWSJdTpTpMWd, \8dWd, p\PRVPV4\P!\4;_uu_4VP4RRR4VP!RRVR R2RR 7VP#4GRjxL R#MRpVP$'dVP$P&MRpVfEKg\)\+VR R44'gR#\P,!VP/4V4GRjxL \ P!4VnVP3\+VR R44VP5W4GRjxL VP74GRjxL VP94EK,EL +'giEL@;iELLLKL5 \P:dR#\<\>3d p TPAT R R 7Rp ? EKRp ? i\d>p TPCT 4'dTPAT R R 7Rp ? EKRp ? EKRp ? ii;i5i)aDetect dead Telegram TCP sockets (CLOSE-WAIT) by periodic probing. In CLOSE-WAIT epoll still reports the long-poll socket readable and nothing raises, so PTB's ``error_callback`` never fires. Probe ``get_me()`` on the *general* path (never the getUpdates pool); connect-level failures feed ``_handle_polling_network_error``. Runs for the connection's lifetime, catching steady-state wedges the one-shot verifier can't.NrTz[%s] Telegram reconnect task wedged for %.0fs with no ladder progress; forcing retryable-fatal so the gateway reconnects instead of staying silently deaf.rz#Telegram reconnect task wedged for rDzs; forcing gateway reconnect.r)get_merzheartbeat prober)"r0rCrrrr{r}r~!_POLLING_ERROR_TASK_STUCK_TIMEOUTr7rrr%r&r*r|r*rrrfrfr]wait_forr8r_note_bot_username_probe_pending_updates_check_polling_stall_check_ingress_dispatch_stallr6rGr'rrs) rHEARTBEAT_INTERVAL PROBE_TIMEOUTstuck_task_refstuck_task_since recovery_tasknow stuck_forrf probe_errs & r_polling_heartbeat_loop'TelegramAdapter._polling_heartbeat_loop8s  26? Ymm$6777)))T-A-A-A !% 8 8  ,]5G5G5I5I..*C$:)6+.(/2SS$'$:  K IIy2(00;;)002<--4A)CPmn&*.,#??AAAT&*N'+yyydiimmd;Xt <==&&szz|]CCC040@-''Z(FG11#EEE //111224m8(<;; BDF 2))  '* U// BS/TT Y11)<<33IFW3XX= Ys K'IH7IIK'%I7A;I2H:4I7I8I<K'>II/K'2IK'(I8I9AIIII I4K'7I: I  IIIIK$,K'/K$>K$?JK' K$&K$'*KK'K$$K'c$<V^8dQhRS[RR/#)r probe_timeoutrN)rA)rrs"rrrs#@L@Lu@L@Lrc ("VP'gVP'dR#VP4'd ^VnR#VP'd\ VPRR4MRpVf ^VnR#\ VRR4'gx^VnV;P^, un\PRVPVP4VP^8d^VnVPRR4R#^Vn\ VRR4p\V4'gR#\P!V!4V4GRjxL p\!\ TR ^4;'g^4pT^8:d ^TnR#T;P ^, un\PR TPY`P 4TP ^8d^TnTPR R 4R#R#L \\3dR#i;i5i) uDetect a wedged or stopped getUpdates consumer via pending_update_count. PTB can report ``updater.running`` while the long-poll is stuck; get_me() stays healthy yet DMs queue in the Bot API. A stuck queue over two consecutive probes ⇒ dead consumer. Also covers the updater having stopped entirely (``running=False``, no reconnect in flight). PTB can report ``updater.running == True`` while its long-poll task is silently stuck (e.g. a socket that epoll keeps reporting readable on WSL2). ``get_me()`` stays healthy because it uses the general request path, so the CLOSE-WAIT heartbeat never fires — yet DMs queue in the Bot API and never reach handlers (#42909). We detect the stopped updater directly and feed the same ladder (#55769). Nrr"FzY[%s] Telegram polling heartbeat: updater stopped while in polling mode (stuck probe %d/2)zV[%s] Telegram updater is not running (long-poll task gone); triggering polling restartz.Telegram updater stopped while in polling modeget_webhook_infopending_update_countzX[%s] Telegram polling heartbeat: %d update(s) queued but not consumed (stuck probe %d/2)zX[%s] getUpdates consumer appears wedged (queue not draining); triggering polling restartz8getUpdates consumer wedged: pending updates not draining)rrrrrr]rr7r-r_escalate_stuck_consumerrfr0r:rGr'r)rrfrJrrLrpendings&&& rr<&TelegramAdapter._probe_pending_updatess  ! ! !T%7%7%7   # # % %./D + 9='$))Y5 ?01D - w 51112D -  + +q 0 + NNkmqmvmv// 1..!323/--lDF *+'"3(:DA())   ))*:*CC!D a<01D -  ))Q.) fhlhqhq 66 8  , , 101D -  ) )jJ L 2Mg&   sS$HHHCH2G:G8G:H/B H8G::H HHHc*<V^8dQhRS[RS[RR/#)rrrrNr)rrs"rrrs'DDCDDDrc VP'dR#\PWP4\P !4P VP\V444Vn R#)zcSecond consecutive stuck probe: restart polling via the network-error ladder (unless tearing down).N) rr7r-rr0rrrrr)rrrs&&&rrN(TelegramAdapter._escalate_stuck_consumers^  ! ! ! {II.#*#;#;#=#I#I$JlJlmy{AnBKC$D rc<V^8dQhRR/#rdrQ)rrs"rrrs66t6rc "VP'g;VP'g)VP'gVP4'dR#\ VR^4p\ VR^4pW8:gV\ VR^48wdW n^VnR#\ VR^4pV\8dR#V^,VnV^,\8dR#\ VR^4pVP\R\ RW, R V R V R V R 2 4R R7R#)aBEscalate fetched updates PTB's dispatcher is not handing to handlers (#102260, #130407). ``received`` and ``dispatched`` count the same population (every fetched update reaches the group-99 catch-all: no handler raises ApplicationHandlerStop, no error handler is registered), so a backlog with no dispatch progress across ``_INGRESS_DISPATCH_STALL_HEARTBEATS`` heartbeats is a wedged dispatcher at any traffic rate. Hands the adapter to the supervisor for a rebuild once per stall (``_PollingStallError``: an in-place restart keeps the wedged dispatcher); re-arms on progress. Nrrrrrz>ingress healthy but deaf: PTB dispatcher made no progress for z heartbeats with z' update(s) fetched but not dispatched (z received, z dispatched, generation rEzingress dispatch stall watchdogr) rrrrr]rr"_INGRESS_DISPATCH_STALL_HEARTBEATSrrx)rreceived dispatchedstalledrs& rr>-TelegramAdapter._check_ingress_dispatch_stalls    !7!7!74;O;O;OSWSkSkSmSm 4!:A>T#>B  !Z74A[]^3_%_,6 )/0D , $ =qA 8 8 +2Q;( Q;; ; T#8!<  '' PQsPtu##+#8"9::[ 4LZLXY[ \5 ( 6rc<V^8dQhRR/#rdrQ)rrs"rrrs--D-rc "VP'g;VP'g)VP'gVP4'dR#\P !4p\ VRR4p\ VRR4pVe W, pMVe W, pMR#V\8:dR#VP\RVR R\ VR^4 R24R R 7R#5i) uqWatchdog the last successful getUpdates round-trip: a long-poll can wedge without raising (CLOSE-WAIT after a route flip) while every other probe stays blind; no round-trip for ``_POLLING_STALL_TIMEOUT`` ⇒ raise ``_PollingStallError`` so the recovery path hands the adapter to the supervisor for a rebuild instead of reusing the wedged Updater. See #92991, #113618. Nrrz getUpdates made no progress for rDzs (generation rz; polling stall watchdog)zpolling stall watchdogr) rrrrr}r~r]_POLLING_STALL_TIMEOUTrrx)rrD last_progressgeneration_started stalled_fors& rr=$TelegramAdapter._check_polling_stalls    !7!7!74;O;O;OSWSkSkSmSm nn&H$O $T+RTXY  $-K  +2K  0 0  '' 2;s2C>RYZ^`uwxRyQz{TU V+ ( -s$CCCB Cc@<V^8dQhRS[RS[PRS[/#)rrrr)rr0rrB)rrs"rrr s&==#==4=rc VP;'giVP4;'gQVP;'g=VP'*;'g$WP8g;'gW P J#)z]True when a verifier's generation no longer matters (progressed, fatal, replaced, torn down).)rrrrrr)rrrs&&&r_verifier_staleTelegramAdapter._verifier_stale sy  " " < >#3]C C C    5 5  '' U V[ ( ]5 W7 6 6 D ##J9911)<<dfjfofo/ :< NNNPTPYPY[vxA\B C  + +I>n + o  sA#I;%.F+F(F+4I; I;I;;>I;:2G,F?-G17I;(F++ F< 6 I;?G I8 I3#I;)I3*I3*I;0=I3-I;3I88I;c<V^8dQhRR/#rdrQ)rrs"rrrB src VP'd\VPRR4MRpVfR#RFyp\WR4p\V\P4'gK1VP 4'g2VP 4\PRVPV4R# \PRVP4R#)aSSynchronously stop PTB's internal polling retry loop. PTB's ``network_retry_loop`` calls our ``error_callback`` *synchronously* on a 409 Conflict then polls again; our callback only schedules async recovery, so two sessions overlap and Telegram 409s on a ~31s cadence. Setting PTB's private ``stop_event`` makes its loop exit on the next tick; ``updater.stop()`` + drain + ``start_polling()`` then build a fresh one. Best-effort across PTB spellings. Deliberately NOT flipping ``updater._running``: stop() raises when already False, which would skip the real teardown and poison the next start.rNz+[%s] Disarmed PTB polling retry loop via %szu[%s] Could not disarm PTB polling retry loop (stop_event not found on this PTB version); falling back to async stop())!_Updater__polling_task_stop_event_polling_task_stop_event) rr]r5r0rrrXr7r8r)rrattr stop_events& r_disarm_ptb_retry_loop&TelegramAdapter._disarm_ptb_retry_loopB s:>'$))Y5 ? UD 5J*gmm44!((**NN$LL!NPTPYPY[_` V   D II rc$<V^8dQhRS[RR/#rr)rrs"rrrX s\6\6I\6$\6rc "VP'dR#VP'dVPR8XdR#V;P^, un^p^ VP^ ,,pVPV8:Edj\P RVP VPVV\V44VPVPR4GRjxL 'gR#\P!V4GRjxL VP'dR#VP4GRjxL VP'dR#VPpVP^,pV'g \R4hWPnVP!VRVP"R7GRjxL \P%RVP VPV4VPV8Xd RVnR#R#VP'dR#R V R \/R \1^V^,444 R 2p\P3RVP V\V44VP;'dVPR8HpVP5RVRR7VP'dXVPP6'd<\9VPP6P;4\<R7GRjxL T'gTPA4GRjxL R#R#ELAELELEL \&dTPT8Xd RTnR#R#\(dpTP'd!Rp?TPT8Xd RTnR#R#\P R TP TPT\T44TPT8dSTP'gATP+TP-T44Rp?TPT8Xd RTnR#R#Rp?MRp?ii;iTPT8XdRTnEL^ TPT8Xd RTnii;iELw \>d%\P RTP 4EL\(d/p \P RTP T RR7Rp ? ELRp ? ii;iEL5i)uRecover a 409 Conflict: the previous gateway process was killed but Telegram holds its getUpdates session ~30s. Stop, wait (growing delay), drain, restart — MAX_CONFLICT_RETRIES times before going fatal; a failed retry must never return silently (limbo).Ntelegram_polling_conflictu[%s] Telegram polling conflict (%d/%d) — previous session still held open on Telegram's servers. Waiting %ds for it to expire. Error: %szconflict-retryz. sL)KABRKK)Kas total wait). The previous gateway session is still held open on Telegram's servers, or another process is using the same bot token. To recover: ensure no other Hermes or OpenClaw instance is running with this token, then restart the gateway with 'hermes gateway restart'.z[%s] %s Original error: %sFr)r`zv[%s] updater.stop() timed out after exhausting conflict retries (likely CLOSE-WAIT socket); proceeding to fatal notifyzK[%s] Failed stopping Telegram updater after exhausting conflict retries: %sr3)!rrfatal_error_coderr7r-rr,r%rr0rCr[rrrrrrrtr*r)rsumrangerr*rrKr#r$rGr) rrMAX_CONFLICT_RETRIES RETRY_DELAYrkexpected_generationr4r%_already_fatal stop_errors && rr(TelegramAdapter._handle_polling_conflictX s^  ! ! !     D$9$9=X$X  $$)$ D882=>  ' '+? ? NN[ 4779M8?  A 77 CSTTT-- , , ,%%%113 3 3%%%))C #'":":Q"> "#abb:M 6 F..s^b^~^~. tIIt;;=QS ==ATTAED>U  ! ! ! 88L7MNLq2F2J)KLLMNW W   1499gGbchGij--ff$2G2GKf2f 97eT yyyTYY...1$))2C2C2H2H2JTijjj335 5 5QU , 4*@ * ==ATTAED>U )))==ATTAED>U\^b^g^g002FHcdmHnp//2FFtOeOeOe11$2O2OPY2Z[==ATTAED>U ==ATTAED>==ATTAED>U$k ` NNTVZV_V_ `  NN]_c_h_hjt     6sQ&SB0SL S$S?LSS+L ,S(S+S=!L&L#0L&-S>BS Q+Q+;6Q+1Q(2Q+6S>SS SS S#L&& P-1Q 2SP-P-P(*Q .S AP(# P(Q S#Q (P--Q 0S Q%%S(Q+++SSS"S##S S SSc<V^8dQhRR/#rdrQ)rrs"rrr s))D)rc "\P!4pVPVJdRVn\VRR4VJdRVnVP 4GRjxL R#L5i)zNotify the runner without letting child teardown cancel this owner: ``disconnect()`` cancels the tracked recovery/heartbeat tasks, so release only the current owner from its field.Nr)r0 current_taskrr]r_notify_fatal_error)rrs& rr,TelegramAdapter._handoff_polling_fatal_error sW++-  # #| 3'+D $ 42D 9\ I+/D (&&(((sAA#A!A#c h<V^8dQhRS[RS[RS[S[,RS[S[,RS[S[,/#)rrr icon_coloricon_custom_emoji_idr)rrr )rrs"rrr sQ   "% 3;C= _ghk_l yABEyF rc "VP'gR#RVRV/pVeW5R&V'dWER&VPP!R/VBGRjxL pVPp\P RVP W!V4V#L4 \ dp\T4P4p RT 9gRT 9d#\P R TP Y!4M[R T 9gR T 9d#\PR TP Y!4M+\PR TP Y!\T44Rp?R#Rp?ii;i5i)zVCreate a forum topic in a private (DM) chat (Bot API 9.4+); message_thread_id or None.Nrrrrz5[%s] Created DM topic '%s' in chat %s -> thread_id=%stopic_name_duplicatealreadyzT[%s] DM topic '%s' already exists in chat %s (will be mapped from incoming messages)z not a forumforums_disableda`[%s] Cannot create DM topic '%s' in chat %s: Threaded Mode is not enabled. The bot owner must open the BotFather Mini App (search 'botfather' in Telegram, tap Open on the search result) -> My bots -> this bot -> Bot Settings -> Threads Settings -> enable Threaded Mode. This cannot be enabled from the DM chat, nor from the BotFather /mybots text menu.z2[%s] Failed to create DM topic '%s' in chat %s: %srQ) rcreate_forum_topicrr7rrr*rrr-r,) rrrrrrtopicrxr error_texts &&&&& r_create_dm_topic TelegramAdapter._create_dm_topic s4yyy &/&$%GF%'1|$#1E-.))66@@@E//I KKOQUQZQZ\`kt u A QJ%3yJ7N jlpluluw{F*,0AZ0OR IIt .H$))UYdABeCD# sFEB#BB3BEB EB$D=7E=EEc<<V^8dQhRS[RS[RS[S[,/#)rparent_chat_idrrrr )rrs"rrr s'55#5S5XVY]5rc "\V4pTPY2R7GRjxL pT'd \ T4#R# \\3dR#i;iL15i)zRCreate a forum topic for a session handoff; ``message_thread_id`` as str, or None.Nr)rrrrr)rrr chat_id_intrxs&&& rcreate_handoff_thread%TelegramAdapter.create_handoff_thread sY n-K// /GG !*s9~44:&  Gs4A >AA A AAAAAc B<V^8dQhRS[RS[RS[RS[S[,/#)rr topic_name force_creater)rrBr )rrs"rrr s1&&S&c&QU&bjknbo&rc Ra "\T;'gR4P4o S 'gR#\V4pT RS 2pTP P T4pT'dT'g \T4#RpRpTPFUp \T P R44\T48wdK-T p\T 3RlT P R.44R4pM T'dKTP R4'd4T'g,\TR,4p YP T&\T 4#Tf"RTR./pTPPT4Tf&RS /pTPR.4PT4TPTS TP R 4TP R 4R 7GRjxL p T 'gR#YR&\T 4TP T&TPTS \T 4TR 7\T 4# \\3dR#i;iLk5i) zJReturn a private DM topic thread id, creating and persisting it if needed.r!Nrrc3V<"TFqPR4S8XgKVxK R#5irNr)rRcrs& rrT2TelegramAdapter.ensure_dm_topic.. s#[*AQUU6]VZEZqq*As) )topicsrxrrr)rrr)replace_existing) rrrrrrrrrrd setdefaultr_persist_dm_topic_thread_id) rrrrr cache_keycached topic_conf chat_entryentryrxrs &&&& @rensure_dm_topicTelegramAdapter.ensure_dm_topic s:##$**, g,K#m1TF+ $$Y/ ,v; /3 /3 ++E599Y'(C ,<<J[%))Hb*A[]abJ  , *..55lJ{34I)2OOI &y> !  #[(B?J  " " ) )* 5   $J  ! !(B / 6 6z B// dz~~l/KblbpbprHcI0JJ "+;%(^ " ((dC N]i(j9~?:&  0Js_+H'H' H )H''H'/A;H'+H'H' B/H'9H%: H'AH' H"H'!H""H'c0<V^8dQhRS[RS[RS[RR/#)rrrxrrN)rr)rrs"rrr s0 r rS rS r rPT rrc &"VP'gR#\V4pVPP V\V4VR7GRjxL \ P RVPWV4R# \\3dTpLhi;iLA5i)z,Rename a forum topic in a private (DM) chat.N)rrrz5[%s] Renamed DM topic in chat %s thread_id=%s -> '%s')rrrredit_forum_topicr7rr)rrrxr chat_id_args&&&& rrename_dm_topicTelegramAdapter.rename_dm_topic syyy  "g,Kii((PST]P^ei(jjj KTYYX_lpq:& "!K "js3B A6*B B(B6B  B B  Bc 6<V^8dQhRS[RS[RS[RS[RR/#)rrrrxrrN)rrrB)rrs"rrr s>%j%j3%jC%jTW%jko%j}A%jrc  a^RIHpV!4R, pVP4'g$\P RVP V4R#^RIHpHpV!V4p V PR/4PR/4PR/4PR .4p R p Rp V Fp \V PR ^44\V48wdK/T p T PR .4p\T3R lT4R4pTfTPRSRT/4Rp M=T'gTP!R4'gTP!R4T8wdY?R&Rp M V fV PR VR RSRV/./4Rp V 'd-V!Wi4\P!RVP VS4R#R# \\3dEK"i;i \"d/p\P RTP TRR7Rp?R#Rp?ii;i)zMSave a newly created thread_id back into config.yaml so it survives restarts.rz config.yamlz:[%s] Config file not found at %s, cannot persist thread_idN)atomic_config_writeread_user_config_raw platformsr<rrFrrc3X<"TFqP!R4S8XgKVxK! R#5irr)rRrrs& rrT>TelegramAdapter._persist_dm_topic_thread_id..4 s KVuuV} /J!!Vs* *rrxTz9[%s] Persisted thread_id=%s for topic '%s' in config.yamlz.[%s] Failed to persist thread_id to config: %sr3)rrexistsr7r-rhermes_cli.configrrrrrrrrrdrr*)rrrrxrr config_pathrrrrchangedmatching_chat_entryrrrrs&&f&& rr+TelegramAdapter._persist_dm_topic_thread_id s# j 8)+m;K%%''[]a]f]fhst S)+6F))+r:EEjRTU``ahjlmxxzEGIJIG"& ' :>>)Q78CLH I'1##..x<KVKTR9MM6:{I"NO"G&aeeK.@.@aeeKFX\eFe%.kN"G( #*  )Wh&*VaclAm@n!op#K8 WY]YbYbdmoyz":.$ j NNKTYYXYdhN i i js[)G!GAG,)F5AG&G>AG*G5G G G  G H#HHc<V^8dQhRR/#rdrQ)rrs"rrrE s"x"x"xrc B"VP;'gREFpVPR4pVPR.4pV'd V'gK9\PRVP\ V4V4VEFUpVPR4pV'gKV RV 2pVPR4pV'd<\ V4VPV&\PRVPWg4KzVP\V4WTPR4VPR 4R 7GR jxL pV'gKWPV&\PR VPWh4VP\ V4WX4\VPP\V4VR V 2R7\RRR7GR jxL EKX EK R #LL \d.p \P!RTPYY4R p ? EKR p ? ii;i5i)zLoad or create configured DM topics: ``extra['dm_topics']`` is ``[{"chat_id", "topics": [{"name", "icon_color", "thread_id"?, "skill"?}]}]``; persisted thread_ids are cached without an API call.rrz*[%s] Setting up %d DM topic(s) for chat %srrrxz4[%s] DM topic loaded from config: %s -> thread_id=%srr)rrrrNz([%s] DM topic cached: %s -> thread_id=%su📌 )rrr+r/FrLz2[%s] Could not send seed message to topic '%s': %srQ)rrr7rrr+rrrrrrKr send_messager3r*r8) rrrrrrrexisting_thread_idrxseed_errs & r_setup_dm_topics TelegramAdapter._setup_dm_topicsE s0066B6J nnY/G^^Hb1F& KKDdiiQTU[Q\^e f$ '^^F3 !&iq 5 %/^^K%@"%145G1HDOOI.KK VX\XaXaclB"&"7"76w?j]k]klx]y)38N)O#8#QQ !-6 * F S\h00WzUx5 ..$>w$G[dmxzDyElF/G 3?afhhh)% 7 Qh!xLL!UW[W`W`blwwxscA HA-H>A9H7G 8 HA H>G$G"G$ H"G$$ H/!HHHHc<V^8dQhRR/#rdrQ)rrs"rrri s o o$ orc "\P!VP4GRjxL VP'gVP'dR#VP RR7GRjxL KlLFL \P dR#\d'\PRTPRR7Ki;i5i)zXKeep the cached @username fresh in webhook mode (no heartbeat calls ``get_me()`` there).TNr%z4[%s] Telegram identity refresh loop iteration failedr3) r0rC_BOT_IDENTITY_TTL_SECONDSrr_refresh_bot_identityr6r*r7r8rrs&r_bot_identity_refresh_loop*TelegramAdapter._bot_identity_refresh_loopi s ommD$B$BCCC)))T-A-A-A00t0<<<D=))  o SUYU^U^im n osmB>#A3A/A3A3B>A3(A1)A3-B>/A31A33B;B> B;#B;7B>:B;;B>c<V^8dQhRR/#rdrQ)rrs"rrrv s__$_rc VPpV'dVP4'gR#\P!VP 44VnR#)zVKick off deferred post-connect housekeeping; idempotent while a task is still running.N)rr{r0ro_run_post_connect_housekeeping)rr.s& r _start_post_connect_housekeeping0TelegramAdapter._start_post_connect_housekeepingv s9&&  ")"7"78[8[8]"^rc<V^8dQhRR/#rdrQ)rrs"rrr} sKKdKrc *"^RIHpHpHpHp^RIHpHpVP'gR#V!4p\P!WWR7GRjxL wrVPV4p VPV4p V \VRR48wd!VPP4WnWBV3Fnp \V R\#V 44p VPP%W!4R7GRjxL \&P)R VP*V \-V 44Kp V 'd.\&P)R VP*\-V4W4R#R#ELLm \.d-p\&P1R TP*Y4Rp?KRp?ii;i5i) uRegister the command menu (from COMMAND_REGISTRY) in every scope — Telegram picks the narrowest matching one per chat type; forum topics are handled lazily by _ensure_forum_commands.) BotCommandBotCommandScopeAllPrivateChatsBotCommandScopeAllGroupChatsBotCommandScopeDefaulttelegram_menu_commandstelegram_menu_max_commandsN max_commandsrr!r(scopez.[%s] set_my_commands OK for scope %s (%d cmds)z,[%s] set_my_commands FAILED for scope %s: %szc[%s] Telegram menu: %d commands registered, %d hidden (over %d limit). Use /commands for full list.)r<rrrrhermes_cli.commands_platformsrrrr0 to_thread _bot_commands_menu_fingerprintr]rr,rrset_my_commandsr7rrr+r*r-)rrrrrrrr menu_commands hidden_count bot_commands fingerprint scope_cls scope_name scope_errs& r_register_command_menu&TelegramAdapter._register_command_menu} sQ ~}dyyy 13 -4,=,=>T,p&p# ))-8 ,,]; '$(CRH H  * * 0 0 2-8 *0RnoI JIGJ qii// IK/PPP LdiiYcehiuevw p  KKu 3}-| K 'qQ qMtyyZdpp qsUA F E A7F$E)E*/E F%0FE F$!F F FFc <V^8dQhRS[/#rrT)rrs"rrr stttrc  ^RIHpVUUu.uF(wr#T!T\T;'gR4R\4NK* upp#uuppi)zW``BotCommand`` rows; Telegram caps a description at 256 chars (longer locales get cut).)rr!N)r<rr_BOT_COMMAND_DESCRIPTION_LIMIT)rrrdescs& rrTelegramAdapter._bot_commands s? (erserWaW[ 4TZZR1P2P!QRerssss>>c <V^8dQhRS[/#rr)rrs"rrr sCCCCrc ^RIp\\4VUu.uFp\V4NK up.4pVP!VP R44P 4#uupi)Nr)hashlibreprrrsha256encode hexdigest)rrrowrs& rr!TelegramAdapter._menu_fingerprint sP }(M}s}(MNO~~gnnW56@@BB)NsA" c<V^8dQhRR/#rdrQ)rrs"rrr s//d/rc "VP4GRjxL \ P!\4;_uu_4VPRR7GRjxL RRR4VP4GRjxL TP\P!4Jd RTn R#R#L \d7p\PRTP\ T4RR7Rp?LRp?ii;iL +'giL;iL \d.p\PRTPTRR7Rp?LRp?ii;i \Pdhi;i TP\P!4Jd RTn ii;i5i)uCommand menu, status indicator and DM topics off the connect path; every step is non-fatal. DM topics — all off the connect path so a slow Bot API call cannot blow the gateway connect timeout (#46298). Nz1[%s] Could not register Telegram command menu: %sTr3onlinez+[%s] DM topics setup failed (non-fatal): %s)rr*r7r-rr,r%r&_set_status_indicatorrr0r6rr)rr topics_errs& rr.TelegramAdapter._run_post_connect_housekeeping sY  / C11333$$Y//000===0 t++--- &&'*>*>*@@*.'A4 CGTopqTr~BCC C>0/. tLdiiYcnrss t%%   &&'*>*>*@@*.'AsF B+B)B+"EC1C/C1E#D6D7D;.F )B++ C,6,C'"E'C,,E/C11 D <ED D>#D94E8E9D>>EEE-FF c<V^8dQhRR/#rdrQ)rrs"rrr saaDarc "\VRR4pVeVP4f\VR^4^,Vn\VRR4pVfR#^RIHpV!R4'gR#VP V4pTfR#TPT4pTP4T!Yg4GRjxL R# \ d7TP4\PRTPRR 7R#i;iLJ \ d7TP4\PR TPRR 7R#i;i5i) zCatch-all PTB handler (group 99) firing ``gateway_platform_event`` per inbound update with a stable envelope (no raw SDK objects) and an internal auth source. Never raises into PTB.rNr_platform_event_handler)has_hookgateway_platform_eventz+[%s] gateway_platform_event normalize errorTr3z*[%s] gateway_platform_event dispatch error) r]rrhermes_cli.lifecycler _normalize_platform_eventr*_fail_update_preparationr7r8r_source_for_platform_event_auth_accept_update)rrcontext admissionhandlerr eventrs&&& r_on_platform_update#TelegramAdapter._on_platform_update s+ D"5t<    7-4T;VXY-Z]^-^D *NUVZ\uw{N| ?   5455226:E =  a99&AF    !%( ( (   ) ) + LLF \`L a   ) a  ) ) + LLEtyy[_L ` aslAD>B4'D>)B4:D>,C:-C8.C:2D>4=C51D>4C55D>8C::=D;7D>:D;;D>c \VRR4eVPV4#\VRR4pVeCVPV4pVP'dVP'g \ R4hV#\ R4h)zRoute a supported update to its event-specific auth-source extractor (reactor / editor); raises ``ValueError`` for updates without one so the boundary fails closed.rNedited_messagezIgateway_platform_event message_edited requires editor and chat identitieszNgateway_platform_event source extraction has no extractor for this update type)r]rrrkrr)rreditedrs&& rr/TelegramAdapter._source_for_platform_event_auth sx 6-t 4 @66v> >!148  77?F>>> !lmmMijjrcF<V^8dQhRS[S[S[S[3,,/#rrP)rrs"rrr s!8DcN3Krc \VRR4eVPV4#\VRR4eVPV4#R#)z{Map a PTB update to a ``{platform, event_type, payload}`` envelope (hooks.md contracts), or ``None`` for types without one.rNr)r]_normalize_reaction_event_normalize_message_edited_eventrrs&&rr )TelegramAdapter._normalize_platform_event sI 6-t 4 @11&9 9 6+T 2 >77? ?rc&<V^8dQhRS[RS[/#r)rrB)rrs"rrr sMM3M4Mrch\V\4'*;'d\V\\34#rP)r5rBrrrHs&r _is_id_likeTelegramAdapter._is_id_like s%eT**LLz%#s/LLrcF<V^8dQhRS[S[S[S[3,,/#rrP)rrs"rrr s!  8DcN3K rc \VRR4pVfR#\VRR4p\VRR4;'g.p\V\\34'gR#Ve\VRR4MRp\VRR4pVP V4'dVP V4'gR#.p.pVR,Fp \V RR4p \V \ 4'd!V 'dVP V R,4\V R R4p VP V 4'gKlVP \ V 4R ,4K R R R RRRVRVR\ V4R ,R\ V4R ,RR//#)u``message_reaction`` → ``reaction`` event: emojis (unicode), custom_emoji_ids, chat_id, message_id, thread_id (always None — reactions carry none).rNr new_reactionrZrN@Nemojicustom_emoji_idNNr:r< event_typereactionremojiscustom_emoji_idsrrx)r]r5rTrr#rrd) rrrrr'rrr0r1rr* custom_ids && rr)TelegramAdapter._normalize_reaction_event shV/ 6 :r64(r>48>>B ,u 66/3/?'$d+TRt4 ((0@0@0L0L&(c""AAw-E%%%% eCj)#4d;I ** ''It(<= #  * &"46F SVW^S_`dSec*od3[$H  rcF<V^8dQhRS[S[S[S[3,,/#rrP)rrs"rrr s!  $sCx.9Q rc .\VRR4pVfR#\VRR4pVe\VRR4MRp\VRR4pVPV4'dVPV4'gR#\VRR4;'g\VRR4p\V\4'gRpRp\VRR4pVPV4'd/\ \VR R 44'd\V4R ,pRp \VR R4p V e3\ V R 4'd!\V P 44R,p RRRRRR\T4R ,R\T4R ,RTRTe TR,MRRT //# \dRp LNi;i)u``edited_message`` → ``message_edited`` event (v1, additive): chat_id, message_id, thread_id (forum topic), text (edited text or caption, bounded), edited_at (ISO 8601 UTC or None).rNrrZrr+captionrrFr, edit_date isoformatr(r:r<r.message_editedrrrx:Ni N edited_at)r]r#r5rrBr)r9r*) rrr%rrrr+rxrr;r8s && rr/TelegramAdapter._normalize_message_edited_event s&"2D9 ?w-/3/?'$d+TWlD9 ((0@0@0L0Lw-RR)T1R$$$D )N/NPTPiPijk .w@T@TUV .   ww9I9IJ JDLiLik l . MMGMM )GMM 9GMM IGL\L\L`L` `cjcrcrcvcv v  & &( ) !.$!GI^`de  % OO2>CcCcd e ,T-H-HIJ *4+D+DEF  FD,D,DERP eT " "9>%kPRSbSbcdfgShSiPj1bePje%kD " #'>(&ls K781K=c$<V^8dQhRS[RR/#)rnativerNr)rrs"rrrj sIICI4Irc <a \VRR4p\VRR4o \V\4'd S 'g\SV`V4R#VP 4UUu/uFwr4V\ V4bK ppp\SV`V4VP 4FwrgVPV.4pVU u0uFp \V 4kK p p VU u.uFp \V 4V 9gKV NK p p \V 3Rl\V44R4p V 'dV fKVRV V ,WR,VR&K R#uuppiuup iuup i)aAPTB dispatches the FIRST matching handler per group and core registers catch-alls (``filters.COMMAND``, ``CallbackQueryHandler``), so a plugin handler appended after connect would never fire. Move whatever a late factory added ahead of the first core handler of its group, keeping the plugin handlers' own relative order.rVNrlc3P<"TFwr\V4S9gKVxK R#5irP)rZ)rRrrrcore_idss& rrT8TelegramAdapter._wire_plugin_handlers..z s"S-=TQA(ARqq-=s& &:NNN) r]r5r r_wire_plugin_handlersr rTrrZr enumerate)rrvrVrnrobeforerfcurrentpriorrr prior_idsadded first_corerzrs&& @rr|%TelegramAdapter._wire_plugin_handlersj s  6:t44!4d;(D)) G )& 1 +3>>+;<+;%!!T"X++;< %f-&nn.NEJJub)E(-.1AI. 'B12a5 +AQQEBSYu-=SUYZJJ.{ +e3eK6HHGAJ/=/BsD73D= E$Ec <V^8dQhRS[/#rr)rrs"rrr s[N[N5[Nrc aa"R\RR4R\RR4R\RR 4R \R R 4R \RR 4RR/o^RIHpV!4pVeZ^RIpVP SR,VP VPR7oVP SR,^VPR7pMR;opR/RV3Rlllp\P!RR4P4P4R09pV'd.MVP4pV'gV'gVPRRRR7p\PRVP 4\#\%4VR7GRjxL p\P'RVP RP)V44\3R!R".VOVP4P6P9R#4R$7p R%V3R&llp V'dV 'gV'g\P'R'VP RP)V44R(\;4R)\=4/p SeSV R*&\?V 4p VeWMR*&V !R+\AV3/V B/R+\AV3/V B/4wrMxV 'd7\P'R,VP V 4V !V!4R*V/V R-7wrM:V'd!\P'R.VP 4V !V!4R*V/4wrWPCV43#EL \*dFp \PR TP T\-T 44\/\04pRp ? ELRp ? ii;i5i)1zBuild the (general, getUpdates) HTTPXRequest pair: fallback-IP transport, explicit proxy, or direct DNS; the getUpdates request is instrumented for polling-progress tracking.connection_pool_sizeHERMES_TELEGRAM_HTTP_POOL_SIZEi pool_timeout!HERMES_TELEGRAM_HTTP_POOL_TIMEOUTg @connect_timeout$HERMES_TELEGRAM_HTTP_CONNECT_TIMEOUTg$@ read_timeout!HERMES_TELEGRAM_HTTP_READ_TIMEOUTg4@ write_timeout"HERMES_TELEGRAM_HTTP_WRITE_TIMEOUTmedia_write_timeoutrn)platform_httpx_limitsN)max_connectionsmax_keepalive_connectionskeepalive_expirycFV^8dQhR\\,R\/#)r httpx_kwargsr)r r )rs"rr9TelegramAdapter._build_ptb_requests..__annotate__ s  x~  rcR<\T;'g/4pSe RV9dSVR&V#)uMerge tuned limits into httpx client kwargs (proxy/direct branches only; the fallback-IP branch must pass limits straight into the transport — httpx ignores client `limits` then).limitsr )rr _pool_limitss& r _with_limits9TelegramAdapter._build_ptb_requests.._with_limits s3,,,"-F'HF,B#/x Mr$HERMES_TELEGRAM_DISABLE_FALLBACK_IPSr!*HERMES_TELEGRAM_FALLBACK_DISCOVERY_TIMEOUTrr)ru@[%s] Discovering Telegram API fallback IPs via DNS-over-HTTPS…r`z.[%s] Auto-discovered Telegram fallback IPs: %sz, z[%s] Telegram fallback-IP discovery failed after %.0fs; using seed IPv4 Telegram API IPs so a blackholed IPv6 hostname path cannot hang initialize() (#87015): %sTELEGRAM_PROXYzapi.telegram.org proxy_url) target_hostsrZc<V^8dQhR\R\R\/#)r general_httpx updates_httpxr)r r)rs"rrr s&   d  rc x<\R/SBVBRR\4/VC/B\R/SBVBRR\4/VC/B3#)rverifyrQ)rr)rrrrequest_kwargss&&,r_pair2TelegramAdapter._build_ptb_requests.._pair sW }>}U}(ThTjI|n{I|} }>}U}(ThTjI|n{I|} rz%[%s] Telegram fallback IPs active: %ssocket_optionsrr transportz;[%s] Proxy detected; passing explicitly to HTTPXRequest: %s)proxyz4[%s] Telegram fallback-IP transport disabled via envrP>rrrr)"rr%gateway.platforms._http_client_limitsrhttpxLimitsrrrrrrr[rr7r-rrKrrrhr*r,rTrrrrrrrr rr)rr _base_limits_httpx_updates_limitsrdisable_fallbackrVdiscovery_timeoutrrr_transport_kwargs_updates_transport_kwargsrlget_updates_requestrrs& @@r_build_ptb_requests#TelegramAdapter._build_ptb_requests sC #G,Lc$R I&I3O y)OQUV I&I4P Y'KTR "4  " P,.  # "!== ./E F*6*P*PcodAdA)BL %mm ./E Fbc!-!>!>,@O.2 1L?  99%KRPVVX^^`d~~-r43E3E3G $4 $ 7 78dfiux 7 y  NN]_c_h_h i r%@AVAXbs%tt  LdiiY]YbYbcoYpq% ,>+N+N{{((,,[9;     2B KK?DIIVbLc d'79U9WYacwcy&z '.:!(+(,->(? %*6E(3+07 ZHYZ[7 bHabc,e (G( KKUW[W`W`bk l+0(OA\dm+n (G( RTXT]T]^+0(OA\+] (G889LMMMS u 7@II02Mc2RT $$56  7siDMM4ML+L,L0A4hi;iT'dYb^, 8dTPpTP4Tn TPPTnTPTP4TP!TP4\"P$!\&4;_uu_4\)T4GRjxL RRR4EKB +'giEKT;iEKZEK] T'dYb^, 8dTPpTP4Tn TPPTnTPTP4TP!TP4\"P$!\&4;_uu_4\)T4GRjxL RRR4i +'gii;iii;i5i)z``app.initialize()`` with a bounded retry ladder; rebuilds ``self._app``/``self._bot`` from ``builder`` after each failed attempt; OSError when the per-attempt or total watchdog expires.HERMES_TELEGRAM_INIT_TIMEOUTrmg^@z(Telegram initialization timed out after z attempts (rDzs each)Fu& — total connect watchdog deadline (zs) exceeded. Check network connectivity to api.telegram.org or set HERMES_TELEGRAM_HTTP_CONNECT_TIMEOUT / HERMES_TELEGRAM_INIT_TIMEOUT to a lower value.u.[%s] Connecting to Telegram (attempt %d/%d)…c\V4#rPrrs&rr>TelegramAdapter._initialize_app_with_retries.. sd{|eArz telegram-init)r?r:r;NTzn. Check network connectivity to api.telegram.org or set HERMES_TELEGRAM_HTTP_CONNECT_TIMEOUT to a lower value.uD[%s] Connect attempt %d/%d timed out after %.0fs — retrying in %dsu9[%s] Connect attempt %d/%d failed: %s — retrying in %dsu<[%s] Connect attempt %d/%d interrupted by %s — propagatingr6) rr0rr}r{r'r7r-rrKrrYrsrfrr|rsr%r&r*rmrGrrCr5rsrMsysr4r6r'r() rbuilder _max_connect _init_timeout_total_deadline _timed_out_attempt rebuild_appold_apprinit_errs && r_initialize_app_with_retries,TelegramAdapter._initialize_app_with_retries s !"@$G !22499;m>ZZ]bb? ~[YfgjXkkrs l+HK3 ?++-224G!%,&L]MilqMqruLvwIJKKOQUQZQZ\dgh\hjvw2II((*MYbYbOA)+++<8Q.>#>"iiG ' DI $ DI..tyy9++DII6#,,Y775g>>>87$?;Y,+T?877K *" a//!%,'XYZZ1="-Z\`\e\egorsgs 7mmD))) *" "8W55d>\>\]e>f>fksGHxHlH1="-OQUQZQZ\dgh\hjvCGHmmD)))  RTXT]T]_gjk_kmy(23<<>!3DgF\F\(](]$EdhhkhththvwxhyczdDdDE  8Q.>#>"iiG ' DI $ DI..tyy9++DII6#,,Y775g>>>8777$?;;8Q.>#>"iiG ' DI $ DI..tyy9++DII6#,,Y775g>>>8777$?;sA!V$B'G< G# G<B)V:G' G% G'V#G<%G'' G9 2 VO:I=;OR:O O .L+DDFKK#t{{O`O`OfOfdfNkNklzN{OBOB@BKCKIKIKK ,-FGMM2TTVst t * ,11@@[ ii--\'9I9I!%!=!=.__annotate__M s ~ ~9 ~ ~rc<SP'gSP4'dR#SPV4'd4SP4SP SSP V44R#SP V4'dN\PRSP\V44SP SSPV44R#\PRSP\V4RR7R#)Nz5[%s] Telegram network error, scheduling reconnect: %sz[%s] Telegram polling error: %sTr3) rrr`rprrrsr7r-rr,rr)rrrs&r_polling_error_callbackDTelegramAdapter._start_polling_mode.._polling_error_callbackM s%%%)A)A)C)C0077++-,,T43P3PQV3WX//66KTYYXstyXz|,,T43U3UV[3\] > KfglKmx| }rr)rrrze[%s] Connected in degraded Telegram mode: gateway is alive, polling will be retried in the background) rr0rrrrr7r-r)rrrrpolling_startedrsf$ @r_start_polling_mode#TelegramAdapter._start_polling_modeG s..!zz NNwy}zCzC D- Q(zs(B,B(AB,7B*8 B,%B,*B,rc&<V^8dQhRS[RS[/#rr.)rrs"rrrd saaTadarc h "RVnRVn\'g7\P RVP 4VP RRRR7R#VPP'g7\P RVP 4VP RRRR7R#VPR VPPR 4'gR#^R I H pH p\P!4PVPP4pVPVR V/4VPP P#R 4pV'dhVP%V4pVP'VPP P#RV44p\P)RVP V4VPP P#R4'd2VP+R4p\P)RVP 4VP-4GRjxL wrgVP/V4P1V4pVP3V!VPP VP 44pVP54VnVP6P8VnVP=VP64VP?VP64VPAV4GRjxL VP6PC4GRjxL \ER4;'gRPG4pV'dVPIWR7GRjxL MVPKVR7GRjxL VPM4\PORVP VP'dRMR4VP'g!VPQRVPS44VPU\WVP:RR44\XPZ!4Vn.VP'd!VPQRVP_44VPa4R#ELYELELfEL$EL \bdp TPe4\gT 4p TPiT 4'dRT R2p TP RT RR7MTP R R!T 2RR7\P R"TP T 4Rp ? R#Rp ? ii;i5i)#aConnect via long polling, or a webhook server if ``TELEGRAM_WEBHOOK_URL`` is set. ``is_reconnect``: False = cold boot (drop the Bot API queue unless ``extra.drop_pending_on_cold_boot`` is false); True = watcher reconnect (preserve queued updates, else every message sent during the outage is lost). Webhook env: TELEGRAM_WEBHOOK_URL, TELEGRAM_WEBHOOK_PORT (8443), TELEGRAM_WEBHOOK_HOST, TELEGRAM_WEBHOOK_SECRET.FzL[%s] python-telegram-bot not installed. Run: pip install python-telegram-botmissing_dependencyz!python-telegram-bot not installedr)z[%s] No bot token configuredmissing_credentialszNo bot token configuredztelegram-bot-tokenzTelegram bot token)TelegramApplicationbuild_update_processorrr base_file_urlz'[%s] Using custom Telegram base_url: %s local_modeTz5[%s] Using Telegram local_mode (read files from disk)NTELEGRAM_WEBHOOK_URLr!rz$[%s] Connected to Telegram (%s mode)webhookpollingrrrzTelegram bot token rejected: uk. The token is invalid or was revoked — generate a new one with @BotFather and update TELEGRAM_BOT_TOKEN.telegram_auth_errortelegram_connect_errorzTelegram startup failed: z&[%s] Failed to connect to Telegram: %s)5rrr0r7rrr*rtoken_acquire_platform_lock+plugins.platforms.telegram.update_admissionrrrurapplication_classrrrrrrrrlrconcurrent_updatesrsrrfrr|rsrrerrrrrr-_restart_task_attrrGr;r]r}r~rrrr*_release_platform_lockr,rh) rrrrrcustom_base_urlrlrrrrr%s &$ rconnectTelegramAdapter.connectd s**/&"!! LLgimirir s  ! !"68[gl ! m{{   LL7 C  ! !"79R^c ! dN ../CT[[EVEVXlmm o!))+11$++2C2CDG  % %&9It;L M"kk//33J?O!**?;!// 0A0A0E0EoWf0gh EtyyRab{{  $$\22!,,T2 SUYU^U^_151I1I1K+K (Goog.BBCVWG001G HYHY[_[d[d1efG DI DI  & &tyy 1  # #DII .33G< < <))//# # #..DEKKRRTK..{.VVV..L.III  " NNA499[_[m[m[mis| }%%%''(A4C_C_Cab  # #GDIIz4$H I,0NN,B[\f[g@htx%y LLA499j Y sA,T2/6T2&,RT2BRBR(AR,R-CRR!R%R &R<RR*R+RRARR!B"RT2RR RRR T/BT*$T2*T//T2c$<V^8dQhRS[RR/#)rrrNr.)rrs"rrr s  $ 4 rc "\VRR4'gR#VPpVfR#V'd VPM VPR,pVP VR7GRjxL \ P RVPV4R#L' \d7p\ PRTPT\T44Rp?R#Rp?ii;i5i)zSet the bot's short description to the online/offline text (closest Bot API surface to presence). No-op unless ``extra.status_indicator``; failures are debug-logged.rFN:NxN)short_descriptionz#[%s] Set bot status indicator to %rz1[%s] Failed to set bot status indicator to %r: %s) r]rrrset_my_short_descriptionr7rrr*r8r,)rrrfr+rs&& rr%TelegramAdapter._set_status_indicator st8%@@ ii ; ,2((8Q8QSWX ...F F F KK=tyy$ O G  LLLdiiY]_z{|_} ~ ~ sF/CCB'B(%B CB C+C C CCc <V^8dQhRS[/#rr)rrs"rrr s   rc \4p.pVFcpV'd,VP4'gWAJg\V4V9dK8VP\V44VP V4Ke V#)zkUnique, unfinished tasks from ``candidates`` excluding ``current_task`` (so teardown never cancels itself).)rXr{rZr[rd) candidatesrr^r)r.s&& r_collect_live_tasks#TelegramAdapter._collect_live_tasks s]"$D499;;$*>"T(dBR HHRX  JJt    rc$<V^8dQhRS[RR/#)rattrsrNr)rrs"rrr s**S*T*rcTVF!p\WR4VJgK\WR4K# R#rP)r]setattr)rrrrns&&* r_clear_task_attrs_except(TelegramAdapter._clear_task_attrs_except s%Dt4( <D)rc<V^8dQhRR/#rdrQ)rrs"rrr s&u&ud&urc B"\P!4pVP.VPP 4OVP P 4OVP P 4O\VR/4P 4O\VRR4N\VRR4N\VRR4NV4pVUu.uF?p\P!V4'g\P!V4'gK=VNKA ppVFpVP4K V'd\P!VRR/GRjxL VP4'di\VP4\VP4,\VP 4,pV'd\"P%RV4MdVPR 3VPR 3VP R 33F7wrx\'VP 44Fp VP)WR 7K K9 VPVP VP VPVP VP3Fp V P+4K VP-VRRR4R#uupiEL]5i) zCancel every delayed-delivery task family before disconnect completes (media-group, photo-batch, text-batch flushes plus polling recovery all sit behind ``asyncio.sleep()`` and would dispatch ``handle_message`` into a torn-down session).rrNrrrTzP[Telegram] Non-retryable fatal teardown; discarding %d pending inbound batch(es)ztext-batch-teardownzphoto-batch-teardownzmedia-group-teardownwhere)r0rrrvaluesr_pending_text_batch_tasksr]rjrir|rr4r+_pending_text_batchesrrr7r-rT_hold_inbound_eventr,r) rr pending_tasksrawaitable_tasksr. n_pendingeventsr!rr-s & r_cancel_pending_delivery_tasks.TelegramAdapter._cancel_pending_delivery_tasks sq++- 00 ((//1 484S4S4Z4Z4\ _c_}_}`E`E`G 7<CCE 3T: =DDJkmqY>Y:ZZ]`aeayay]zzIqs|}++-BCdFaFacyEz))+AB"D "&--/2E,,U,@3"D  # #T%=%=t?^?^  ' ')G)GIcIceA GGIe %% /1RTs u1f Ks7B JJ=J"J&J?JJEJc,<V^8dQhRS[RS[RS[/#)rr?steprr@)rrs"rrr s#uCTXrc \"\P!V4p\P!V0V^8dTMRR7GRjxL wrVYE9dB\P!\P4;_uu_4TGRjxL RRR4R#TP 4TP \ 4\PRTPY24R#L \Pd(TP 4TP \ 4hi;iL +'giR#;i5i)uAwait one disconnect step; detach on timeout so teardown advances (``wait_for`` would wait for a PTB close that swallows ``CancelledError`` on a half-dead socket). Abandoned tasks are observed. ``asyncio.wait_for`` cancels an overdue child but then waits for it to exit. Detach at the deadline and continue — the abandoned task is observed via ``_consume_abandoned_task``. See #80598. Nr`TzD[%s] %s timed out after %.1fs during disconnect; continuing teardownF) r0rorr6r|rqr9r%r&r7r-r)rrIr?r-r.r{_pendings&&&& r_await_disconnect_step&TelegramAdapter._await_disconnect_step s$$Y/ #*<<7UV;\`#aaND <$$W%;%;<< =  67]_c_h_hjnxb%%  KKM  " "#: ;   =<sXD,%CCC2D,8D>D?DAD,C`` and start ``coro`` in its place.N)r]r{r|rr0ro)rrnrrs&&& rr"TelegramAdapter._restart_task_attr( s9D)  LLNG11$78rc*<V^8dQhRS[RS[RR/#)rrnr;rNr)rrs"rrr/ s"""C"""rc "\WR4pV'dFVP4'g0VP4VPV\V4GRjxL \ WR4R#L5i)zpCancel + bounded-await the task stored at ``self.`` (may be missing: object.__new__ tests), then clear it.N)r]r{r|r0_DISCONNECT_STEP_TIMEOUTr)rrnr;r.s&&& r_cancel_task_attr!TelegramAdapter._cancel_task_attr/ sPt4(  KKM--d4LeT T TD! Us*A,*A,A*A,c<V^8dQhRR/#rdrQ)rrs"rrr7 sBBBB$BBrc "VP4RVnRVn\VR^4^,Vn\ P !4VnRVnVP4\ P!4pVP\VRR4\VRR4.V4pVFpVP4K VUu.uF?p\ P!V4'g\ P!V4'gK=VNKA ppV'd4VP\ P !VRR/\"R4GRjxL VP%VRR4RVnRVn\VR R4pV'd\VP'4'gFVP4VP\ P !VRR 7\"R 4GRjxL RVnVP+R R 4GRjxL VP+RR4GRjxL \,P.!\04;_uu_4VPVP3RR7\"R4GRjxL RRR4VPVP54\"R4GRjxL VP6'EdVP6P8'diVP6P8P:'dCVPVP6P8P=4\>R4GRjxL VP6P:'d8VPVP6P=4\"R4GRjxL VPVP6PI4\"R4GRjxL RVnRVn%\VRR4pVeJVP'4'g4VP\ PL!V4\"R4GRjxL \@PORVPD4R#uupiEL EL{EL]ELFEL +'giEL;iELELD \0d6p\@PCRTPD\GT44Rp?EL}Rp?ii;iEL7EL \0d6p\@PCRTPD\GT44Rp?ELE %6%;%;%=%=  $ $ &--0DIKcez| | |"&$$%>@RSSS$$%AC\]]]   + +--d.H.HPU.H.VXpsLM M M,))$*M*M*OQilEF F F 999 w99$$$):):)B)B)BD"99$)):K:K:P:P:RTik{||| 99$$$55diinn6FH`bnooo11$))2D2D2FH`brsss  5t<  UZZ\\--gnnU.CE]_uv v v 5tyyA_h } | T] M, + + F }$DNPTPYPY[vxB\CDDD ps wJDIIWrstWuvv w ws@CT Q(QQ 8TQ ATATQ T6Q7TQ&T7+Q"Q#Q'0TQ0T0R? %R?34T3.T!T",TTTTQ Q- ' T3Q66 R6*R1+R?1R66R?<R?? S? *S:4T:S??Tc<<V^8dQhRS[S[,RS[RS[/#)rr chunk_indexr)r rrrB)rrs"rrr{ s'   Xc]    QU  rc \V'gR#VPpVR8XdR#VR8XdR#V^8H#)zVWhether this chunk (0 = first) should reply-thread to ``reply_to``, per reply_to_mode.FrallT)r)rrrCmodes&&& rr$TelegramAdapter._should_thread_reply{ s2"" 5= 5=arc <V^8dQhRS[/#rr)rrs"rrr s++5+rc ^RIHp^RIHp^RIHpWV3# \d \pL%i;i \dRpL1i;i \\ 3dRpLCi;i)z``(NetworkError, BadRequest, TimedOut)`` from PTB, with import-failure fallbacks (``OSError``, ``None``, ``None``) so send() still classifies without the SDK.)rlr1Nr)r4rlrDr'r2rnrE)_NetErr_BadReqrs r_telegram_error_types%TelegramAdapter._telegram_error_types sl  >  <  <** G  G ^, I s,1A.. AAAAc<<V^8dQhRS[RS[S[S[3,/#)rchunkrHr=)rrs"rrr s&   4PSUXPX> rc "\VPP!R RVR\P/VB\ RRR7GRjxL #L \ dpR\T4P49gR\T4P49dj\PR TPT4\TPP!R R\T4RR/TB\ RRR7GRjxL uRp?#hRp?ii;i5i) zNMarkdownV2 first; on a parse/markdown rejection resend as stripped plain text.r+ parse_moder/FrLNparserz<[%s] MarkdownV2 parse failed, falling back to plain text: %srQ) rKrrr} MARKDOWN_V2r3r*rrr7r-rrW)rrOrHmd_errors&&& r_send_chunk_markdown_or_plain-TelegramAdapter._send_chunk_markdown_or_plain s 4 &&cEci>S>ScWbc+?Y^`` `` #h---//:XATATAV3V]_c_h_hjrs8II**c E0BctcWbc/]bdddd   sZDAA A A D A DBC>2C53C>7D8D=C>>DDc<V^8dQhRS[RS[RS[RS[S[,RS[S[S[S[3,,RS[S[,RS[RS[/#) rrrOrrrOrxused_thread_fallback error_types)rrr r rrBr)rrs"rrr sqfff#&f/2f>FsmfW_`dehjmem`nWofC=f8<fKPfrc "Vwrp Rp VPWWVV4wrpV 'd)Vf%V'g\RVP4RR7#VPWW_VPR7pV'd$VP R4e\ V4pRVR&VP R4p\^4FRpR\V4RV/VCVP4CVPV4CpVPVV4GRjxL V3u# R#L T EdpT 'Ed\TT 4'EdTPT4'dTeT 'g T'd6TP R4'd\R\T4RR7uRp?u#T 'g+R p \P!R TP"T4Rp?EK\P!R TP"T4TP%TTTR 7R pRpRR/pRp?EKTR \T4P'49dTe\)T4pT 'd\RTRR7uRp?u#\P!RTP"T4RpTP+T4'd/pMTPYY_TPR7pTP R4pRp?EKhTP-T4pT 'd3\TT 4'd!TP/T4'g T'ghT'dTP14GRjxL T^8dh^T,p\P!RTP"T^,T\)T44\2P4!T4GRjxL Rp?EKRp?i\6Ed7p\9TRR4pTf R\T4P'49EdTe \;T4MRp\)T4pT\<8dA\P!RTP"T\<T4TP?TT4uRp?u#T^8dQ\P!RTP"T^,TT4\2P4!T4GRjxL Rp?EK\P!RTP"T^,T4TP?TT4uRp?u#hRp?ii;i5i)aDeliver one chunk: routing, up to 3 attempts, thread-not-found / deleted-anchor / flood handling. Returns ``(msg, used_thread_fallback)`` on success or a ``SendResult`` to return verbatim (fail-loud DM-topic cases, flood cap); raises anything the caller's classifier should see.FNrrr&r rrrrTz;[%s] Thread %s not found, retrying once with same thread_idz<[%s] Thread %s not found, retrying without message_thread_idrr:z8[%s] Reply target deleted, retrying without reply_to: %sz>[%s] Network error on send (attempt %d/3), retrying in %ds: %sr retry afterrzg[%s] Telegram flood control on send (retry_after=%.1fs > %.0fs); failing closed instead of sleeping: %szI[%s] Telegram flood control on send (attempt %d/3), retrying in %.1fs: %szy[%s] Telegram flood control on send persisted across %d attempts; failing closed so the delivery ledger owns the wait: %s) r rrrrrr r{rrrUrUr5rrr7r-rr,rr,rrrrr0rCr*r]rA_FLOOD_INLINE_WAIT_CAP_SECS_record_send_flood_cooldown)rrrOrrrOrxrXrYrJrKrretried_thread_not_foundrrr reffective_thread_id _send_attemptrHrOsafe_send_erroris_pool_timeoutrrs&&&&&&&&& r_send_chunk_with_retries(TelegramAdapter._send_chunk_with_retries sx'2#)#( DHD]D]^eqyGLEMAk [%8AVe43V3V3Xdij j44 Y]YlYl5n M$5$56I$J$V /M15M- .+//0CD"1XMS 9'BDY[fZjwZ//1Z595N5Nx5XZ "??{SSUiii & T/ *7z(G<<66x@@EXEd0X(,,OsBtBt#-e3x=\a#bb77;4"NN+hjnjsjsvIJ$'egkgpgpsFG::7DWbj:k/3,.2+)S%=NS% AN S" S%9N 2N?S%N (N NNN-L0.A"NNNS% S"+S",BS;S"<S%A S RSS%:SS"S%SS""S%cP<V^8dQhRS[RS[S[S[S[3,,RR/#rrrOrNr)rrs"rrrs1%4%4s%4htCQTH~>V%4[_%4rc Laaaa a "S;'g/PR4'g\\SRR4RR4'gR#SPPR/4o SPPR/4p\ S4o S PS 4pVeVP 4'gR#\ P!4pVP4pWcPS \R44, \SR R 48dR#WcS &R VVV3R llpVPV!44pVS S &VPV V 3R l4\SRR4p \V \4'd/V PV4VPV P4R#R#5i)aRe-arm typing after an intermediate send (Telegram clears it when a message lands). Skipped on the FINAL reply (``metadata["notify"]``): the refresh loop is gone and no API cancels the bubble. Scheduled, never awaited: ``sendChatAction`` is a fire-and-forget UI hint, and awaiting its TLS round-trip on the send path after *every* streamed chunk pinned the event loop the ``getUpdates`` long-polls live on until they rotted into CLOSE-WAIT while the adapter still reported connected (#111727). ``_keep_typing`` already refreshes every 2s, so one in-flight re-arm per chat, at most one per ``typing_retrigger_min_interval_seconds``, covers the gap a landed message leaves.rRrNtyping_indicatorTrrz-infrrlcV^8dQhRR/#rdrQ)rs"rr7TelegramAdapter._retrigger_typing..__annotate__(s C Cd Crc<"\P!\4;_uu_4SPSSR7GRjxL RRR4R#L +'giR#;i5i)rN)r%r&r* send_typing)rrOrsr_quiet1TelegramAdapter._retrigger_typing.._quiet(sF$$Y//&&w&BBB0/B0//s,#A"AA A A" A A  A"c^<SPS4VJ;'dSPSR4#rP)rrY)r{rtaskss&rr3TelegramAdapter._retrigger_typing...s*EIIcNd,B,[,[uyyQTVZG[,[rrp)rr]rrrr{r0rr}rArrqr5rXr[rr) rrrOsent_at in_flightrrDrnr.trackedrrqs fff @@r_retrigger_typing!TelegramAdapter._retrigger_typingsX NN   ) )xQU9VXjlp1q1q )-)A)ABdfh)i$(MM$<$<=\^`$a'lIIcN  )9)9 '')iik S%-0 074Afhk3l l   C C)c  [\$ 3T: gs # # KK   " "7?? 3 $s!F$B F$7C-F$c n<V^8dQhRS[RS[RS[S[,RS[S[S[S[3,,RS[/#r(r))rrs"rrr5sVVVV%(V4+>w+GI`I`ir*sF6{Q"(!'9@TVegl9mn!'**7IQYgg g+ 0^H h ~66qFJ**:c)no7NPYh|h|*} } ~sBHF0)H-F>.F3/F> F>F5F>#H$AF>)*F7F>+F<,F>/H3F>5F>7F>> H  9HH HH  Hc,<V^8dQhRS[RS[RS[/#)rrrYr)r*rr)rrs"rrrys"##)#%#J#rc \V4p\PRVPV4\ V4P 4p\ V4pRV9gRV9d/\PRVP4\RRRR7#V^,pT;'d\W4;'gRV9p\RTVPV4;'g!VPV4;'gV'*VR 7#) a$The failed ``SendResult`` for an exception escaping the chunk loop. ``retryable`` doubles as "non-delivery is certain": a plain ``TimedOut`` may have reached Telegram, so it is neither re-sent by ``_send_with_retry`` nor resumed from; a wrapped ConnectTimeout / httpx pool timeout never left.z([%s] Failed to send Telegram message: %smessage_too_longtoo longzF[%s] send() content too long, falling back to new-message continuationFtoo_long)rr error_kindr)rrr&r) r,r7rrrrrr8rr5rr)rrrYrerr_strr_to is_timeouts&&& rr(TelegramAdapter._classify_send_exceptionys13  ?JWa&,,.(+  (J',A LLacgclcl me3ER\] ]!n00j0KK[G5K 77:ppd>[>[\]>^ppfpbp!# #rc<V^8dQhRS[RS[S[,RS[S[,RS[S[,RS[S[S[S[3,,RS[RS[/#)rrrrrrOrYr)rrTr r rrr)rrs"rrrshFFF$(IF:>s)FOWX[}F4S>*F9>FCMFrc &"VPV4pVPV4pRp \V4p VFp VPW\V4WEWyV4GRjxL p \ V \ 4'd(VP W\V4V , RV4u#V wrVP\V P44K VPW4GRjxL \ RV'd V^,MRR\V4RVRV /R7#LL45i)uDeliver formatted ``chunks`` in order, appending each landed message id to ``delivered`` (pre-seeded with the ids of an earlier partial send when resuming — the chunk index used for reply routing continues from there). A mid-loop refusal returns the ``partial_overflow`` result.FNT message_idsrequested_thread_idthread_fallbackrr raw_response) rrr+rdr5rrrdrrrvrT)rrrrrrOrYrxrrXrrOoutcomer7s&&&&&&& rrTelegramAdapter._send_chunkss ,,X6 ">>yI$IE 99IIeprrG':....ws9~PU?U?V8WYbcc(/ %C   S0 1$$W777YYq\DtI0EGZ\mpDEF Fr 8s%ADD BDD3DDrc X<V^8dQhRS[RS[S[,RS[S[,RS[RS[/#)rrJ undeliveredrrr)rrTrrB)rrs"rrrs=)-c?CCy[_kurc V'gV#\VP\4'd\VP4M/pVPRRR\ V4R\ V4\ V4,RVR ,R\ VR,4/4V'd%V'd\ V4VR&\ V4VR &W@nV#) auMark a split-send failure that happened after earlier chunks landed with the ``partial_overflow`` contract (the same key ``_edit_overflow_split`` sets and the stream consumer reads), so no caller re-sends the already-visible head. ``undelivered`` (the formatted remainder, for :meth:`_resume_partial_send`) is attached only when ``tail_certain``. No-op when nothing landed.partial_overflowTdelivered_chunks total_chunkslast_message_idcontinuation_message_idsNNundelivered_chunksdelivered_message_ids)r5rr rr+r)rJrrrrs&&&$ rr"TelegramAdapter._with_partial_sendsM+5f6I6I4+P+Pd6&&'VX &8#i..Z]^gZhknozk{Z{ y}.H%PYZ\P]J^` a K(-k(:C$ %+0+;C' (! rc ~<V^8dQhRS[RS[RS[S[,RS[S[S[S[3,,RS[S[,/#)rrrJrrOr)rrr r r)rrs"rrrs`zzz$.z=Ec]zV^_cdgildl_mVnzs{}GtHzrc "\VP\4'd VPM/pVPR4pV'dVP'gR#\ VPR4;'gR4p\ V4pVPV4;_uu_4GRjxL VPV4p V e8VP\V 4\ V4V4uuRRR4GRjxL #VP4p VPV\ V4WsWJ4GRjxL uuRRR4GRjxL #LLOLL \dip TPY4p TPT \ T4\ T4T, RY|PR7uRp ? uuRRR4GRjxL #Rp ? ii;i +GRjxL 'giR#;i5i)zSend only the chunks a partial ``send()`` could not deliver (``raw_response["undelivered_chunks"]``), continuing the message-id sequence; ``None`` when the tail was not certain-undelivered.rNrrrQ)r5rr rrrTr+rMrrrrLrr*rr&) rrrJrrOrrrrrrYrrs &&&$$ r_resume_partial_send$TelegramAdapter._resume_partial_sends&00C0CT%J%Jf!!PRgg23 $)))!89??R@ I''000::7CH#../@/JDQ\L]_hi100446K z!..w[8I9`hvv 100 w 1 z!::1J ..[ 1#i.52H2I JIdxdx/zz100 z1000sAG GG;/G*E+G.:G( G5E6G;G E ,E-E 0 G=E >GGE  G F>A F9 F>!G% G2F53G9F>>GG G  G G  Gc ^<V^8dQhRS[RS[RS[RS[S[S[S[3,,RS[/#)rr status_keyrrOrr))rrs"rrrsG(+69HPQUVY[^V^Q_H`lvrc f"\V4\V43pVPPV4pVeVPWVRVR7GRjxL pVP'dWVP 'dCVPPV4V8Xd#\VP 4VPV&V#VPP VR4VPWVR7GRjxL pVP'dVP 'd\VP4VP8dM\VP4RVP^,FpVPP VR4K! \VP 4VPV&V#EL\L5i)uSend a status message, or edit the previous one with the same ``(chat_id, status_key)``; if the edit fails (deleted, too old, …) the cached id is dropped and a fresh message is sent. Issue #30045: progress/status callbacks (context-pressure, lifecycle, compression, etc.) used to append a fresh bubble on every call. With this method, the first call sends and the message id is remembered; subsequent calls with the same (chat_id, status_key) edit that same message in place. NTfinalizerOr) rrr edit_messagerrrYr{r+_STATUS_MESSAGE_IDS_MAXrT) rrrrrOr cached_idrJstales &&&&$ rsend_or_update_status%TelegramAdapter.send_or_update_statussd7|S_-,,005  ,,WSWbj,kkF~~~$$$)A)A)E)Ec)Ji)W478I8I4JD,,S1  $ $ ( (d 3yyHyEE >>>f///4++,0L0LL!$":":;<_d>Z>Z^_>_`E,,00=a,/0A0A,BD $ $S ) lFs>AF1F,F1'F19A6F1/F/0F1F1BF1/F1c 6<V^8dQhRS[RS[RS[RS[RR/#)rrrr+rQrNr)rrs"rrrs9CCCCCCUXCdhCrc "R\V4R\V4RV/pVeWER&\VPP!R /VB\ RRR7GRjxL R#L5i) zN``editMessageText`` with normalized ids; ``parse_mode=None`` sends plain text.rrr+NrQr/FrLrQ)rrrKredit_message_textr3)rrrr+rQrs&&&&& r _edit_textTelegramAdapter._edit_textsl"+-G-PR^`cdn`oqwy}!~  !#-< ) II ' ' 1& 1;NVe}BC C CsAAAAc ><V^8dQhRS[RS[RS[RS[RS[RS[/#)rrr formattedplainwarn_fmtrr')rrs"rrrs;  S c VY be qt y} rc h"VPWV\P4GRjxL R#L \dtpR\ T4P 49dRp?R#\ PYPP\T44TPYT4GRjxL Rp?R#Rp?ii;i5i)zMarkdownV2 edit with plain-text fallback. Returns True on a "not modified" no-op (caller may skip further work); the fallback edit's exceptions propagate.NrGTF) rr}rSr*rrr7r-rr,)rrrrrrfmt_errs&&&&&& r_edit_markdown_or_plain'TelegramAdapter._edit_markdown_or_plains >//'y)BWBWX X X  Y >W!3!3!55 NN8YY0KG0T U//'u= = =  >sNB2$1/1B21 B/B*B2 >B*B!B*$B2*B//B2rc d<V^8dQhRS[RS[RS[RS[RS[S[S[S[3,,RS[/#rrrrrrOrrrBr r rr)rrs"rrrsWA?A?A?(+A?69A?HLA?`himnqsvnviw`xA?A?rc x a"VP'g\RRR7#V'gb\V4VP8:dHVP V4^8d2\ P RVPV4\RVRR/R7#VPV4V'd9VPV4'd"VPWW5R7GR jxL pVeV#\V4\V43pRpV'dVPPVR 4\V4VP8dfV'dVPWW4VR 7GR jxL #VPV4pRpVPP!V4V8Xd\RVR 7#M$V'gVPPVR 4V'g>VP#WV4GR jxL V'dW0PV&\RVR 7#TP%YVP'V4V'd \)V4MTR 4GR jxL \RVR 7#EL{LLwL \*EdVp \T 4P-4oR S9d\RTR 7uR p ? #RS9gRS9d\ P RTP\T4TP4T'd#TPYY4TR 7GR jxL uR p ? #TPT4p TPP!T4T 8Xd\RTR 7uR p ? #TP#YT 4GR jxL YPT&\RTR 7uR p ? #\/T RR 4p T f RS9EdeT 'dT MRp T \08d7\ P3RTPT \04\5T 4uR p ? #\ P3RTPT 4\6P8!T 4GR jxL TP#YT4GR jxL \RTR 7uR p ? # \*dp \;T 4p\ P=RTPT4\/T RR 4pTfR\T 4P-49d%\5Te \?T4MT 4uR p ? uR p ? #\RTR7uR p ? uR p ? #R p ? ii;i\;T 4pRp\@;QJdT3RlT4F 'gK RM RM!T3RlT44'd6\ P3RTPTT4\RTRR7uR p ? #\ P=RTPTT4\RTR7uR p ? #R p ? ii;i5i)aCEdit a previously sent Telegram message. Telegram caps a message at 4096 UTF-16 codeunits. Streaming replies that outgrow it must NOT be truncated silently nor fail (the consumer would re-send a duplicate): edit with the first chunk, send the rest as continuations, and return the final chunk's id as the next edit target.FrzrrzK[%s] skipping interim edit for chat %s (shared send+edit budget: slot busy)TskippedrrNrr1z;[%s] MarkdownV2 edit failed, falling back to plain text: %srGrrz6[%s] edit_message overflow (%d UTF-16 > %d), splittingrr\rzQ[%s] Telegram flood control, refusing edit (retry_after %.1fs > %.0fs inline cap)z*[%s] Telegram flood control, waiting %.1fsz+[%s] Edit retry failed after flood wait: %sc3,<"TF qS9xK R#5irPrQ)rRr7rs& rrT/TelegramAdapter.edit_message..{s<);A<);r?z@[%s] Transient network error editing message %s (will retry): %sr[z+[%s] Failed to edit Telegram message %s: %s) connecterrorz connect errorzconnection errorrqz network errorr readtimeout writetimeoutzserver disconnectedztemporarily unavailableztemporary failurer)!rrrrrr7r8rrrrHrrrY_edit_overflow_split!_truncate_stream_overflow_previewrrrrrWr*rr]r]r-rr0rCr,rrAr)rrrrrrOr _preview_key_saturated_previewr truncatedrrr4safe_retry_error retry_waitr_transient_markersrs&&&&$$ @rrTelegramAdapter.edit_messagesyyye?C C'"d&=&==227;a? LL] 7 $dzQZ\`Pab b %%g. ++G44 $ 3 3G 3 ddK&""G c*o6 "   ' ' + +L$ ? W  7 7 7!66wGqy6zzz< >o7 ?s'V:A9V:%V:<V:I A'V:;V:IA V: V:=III I'IV:9I;I<I V:V:II V7",V2V7V:A"V26K97V2;V7<V:=V2>V7?V:V2MV29V7:V:? V2 ?V2V7 V:%:V2P" V2&Q;P><Q V7V: S9A4S4S9V2V7V: S4)S9*V2.V7/V:4S99/V2+V2 /V28V79V:>.V2,V7-V:2V77V:c&<V^8dQhRS[RS[/#rr)rrs"rrrs\\\\rc RVPWP\R7^,#)aOne-message preview for oversized streaming edits (edits must keep targeting the original id; final edits use ``_edit_overflow_split``). Splitting a mid-stream preview creates continuation messages and moves the active message id, so the next accumulated-token edit repeats the overflow cycle (#48648). Final edits still use ``_edit_overflow_split`` to deliver the complete response. r)rrrrs&&rr1TelegramAdapter._truncate_stream_overflow_previews&$$W.E.Ei$XYZ[[rc<V^8dQhRS[RS[RS[S[,RS[S[S[3,RS[S[,RS[S[S[S[3,,RS[/#)rrrOr rrxrOr)rr rr rrB)rrs"rrrsf&&&#&&5=c]&SWX[]`X`Sa&C=&,4T#s(^,D&PT&rc >"/VP4CVPV4CpV'dR MRFp V 'd\VPV44p MV'd \ V4MTp \ VP P!RR\V4RT RV 'd\PMRRV/VBVB\RRR7GRjxL u# R#L \Ed9p R \T 4P49dTPT4'd/MTP!YTRR 7p \ TP P!RR\T4RT'd \ T4MT/T BTB\RRR7GRjxL uRp ? u# \d;p \"P%R TP&\)T 44Rp ? Rp ? R#Rp ? ii;iT 'dRp ? EK\"P%R TP&\)T 44Rp ? R#Rp ? ii;i5i)zSend one continuation chunk (MarkdownV2 then plain on finalize; raw when streaming); drops the reply anchor once on 'reply message not found'. Returns the sent message or None.Frr+rQNrr/rLzreply message not foundrz4[%s] Overflow continuation no-reply retry failed: %sz*[%s] Overflow continuation send failed: %sTFFrQ)rrUr[rrWrKrrrr}rSr3r*rrrrr7r-rr,)rrrOr rrxrOrbase use_markdownr+rOretry_thread_kwargs _retry_errs&&&&&&&& r_send_overflow_continuation+TelegramAdapter._send_overflow_continuations V$++-U1J1J81TU-5M8CL ?@S@STY@Z2:;u-uD8II**N6w?NFJNp|W`WlWlCGN(3N7DNHLN0]b dddD@3d  ,H 0C0C0EE#55h??!99'hlp9q( $%@ II22;$>w$G;dlkZ_N`rw;1;59;%8ej &l l ll %$RTXT]T]_z|F`GH#t$ KTYYXst|X}~' s3H*C!A(C C C HC H"4HH.AF FF HH G*G HH G HH$*HHHHc d<V^8dQhRS[RS[RS[RS[RS[S[S[S[3,,RS[/#rr)rrs"rrrs[.n.n.n(+.n69.nHL.nX`aefiknfnaoXp.n}G.nrc "VPW0P\R7p\V4^8:dV.pV^,pV'd?VP W\ VP V44\V4R4GRjxL MVPWV4GRjxL .p V.p Tp VP#V4p VR ,EF-p V 'd \%V 4MRpVP'WW^R 7pVP)WWWV4GRjxL pVf\P+R VP^\V 4,\V44R P-RV 44p\!RV RRRRR^\V 4,R\V4RV RVR\/V 4/\/V 4R7u#\\1VRR 44;'gT pV P3V4V P3V 4Tp EK0 V 'd V R,MTp\P5RVP^\V 4,V4\!RV\/V 4R7#ELEL \dqpR\T4P49dH\PRTP\T4RR7\!R\T4R 7uRp?#Rp?EL+Rp?ii;iEL5i)a$Split an oversized edit across the existing message + continuations: edit ``message_id`` with chunk 1, send the rest as replies to the previous chunk, return ``message_id=`` so the consumer keeps editing the newest message. ``success=False`` only if the first-chunk edit fails.rzW[%s] Overflow split: MarkdownV2 first-chunk edit failed, falling back to plain text: %sNrGz0[%s] Overflow split: first-chunk edit failed: %sTr3Frrrz6[%s] Overflow split: stopped at %d/%d chunks deliveredr!c3R"TFp\P!RRV4xK R#5i)z \(\d+/\d+\)$r!NrT)rRrs& rrT7TelegramAdapter._edit_overflow_split..s$*udtW`2662BB +R+Rdts%'overflow_continuation_failedrrrrdelivered_prefixr)rrrr&rrrz3[%s] Overflow split delivered %d chunks; last_id=%s)rrrr)rrrr+rr[rrWrr*rrr7rrr,rrrrrr-rhrr]rdr8)rrrrrrOr first_chunkrcontinuation_idsrprev_idrxrOr rsent_msgrnew_idlast_ids&&&&$$ rr$TelegramAdapter._edit_overflow_splits &&w0G0GPY&Z v;! YFQi  W22)MdNaNabmNn)oq|~IrJmooooog;GGG ')'=,,X6 BZZE*1#g,tK 88X8wM!==gkjs@HIIHWY]YbYbdehkl|h}d}@CDJ@KL#%77*udt*u#u !!g=[gk*D2Da#N^J_F_&F 5FQceu2E:J4K"M.33C-D FF<<=HHF  # #F +  # #E *G% &+;"2&  JDIIWX[^_o[pWpryz$7UZ[kUlmmGoH WSV\\^3 OQUQZQZ\wxy\zFJ K!%7RST7UVV4 WIs>KI 8IIIKIII!A%KKCK 3K=AKII K"AK K K KKc,<V^8dQhRS[RS[RS[/#rrrrr')rrs"rrrs"CSTrc 2"VP'gR#VPP\V4\V4R7GRjxL R#L \d7p\ P RTPT\T44Rp?R#Rp?ii;i5i)uDelete a bot-posted message (Bot API allows it within 48h); failures are non-fatal. Used by the stream consumer's fresh-final cleanup path (ported from openclaw/openclaw#72038) to remove long-lived preview messages after sending the completed reply as a fresh message. Telegram's Bot API ``deleteMessage`` works for bot-posted messages in the last 48 hours. Failures are non-fatal — the caller leaves the preview in place and logs at debug level. F)rrNTz-[%s] Failed to delete Telegram message %s: %s) rdelete_messagerrr*r7r8rr,)rrrrs&&& rrTelegramAdapter.delete_messagesyyy ))**3Mg3Vcfgqcr*s s s t  LLH$))U_a|}~a A s@B2A A ABA B+B BBBcb<V^8dQhRS[S[,RS[S[S[S[3,,RS[/#)rrXrOr)r rr rrB)rrs"rrrs:>>(3->RZ[_`ceh`h[iRj>vz>rc VP'd\VPR4'gR#T;'gRP4R9#)zsendMessageDraft works for private chats only (Bot API 9.5) and needs PTB >= 22.6; groups and older installs use the edit-based path. ``rich_drafts`` controls draft *format*, not availability.send_message_draftFr!>r[r\)rr)r)rrXrOs&&&rsupports_draft_streaming(TelegramAdapter.supports_draft_streamings<yyy 3G H HR&&(,===rc ^<V^8dQhRS[RS[RS[RS[S[S[S[3,,RS[/#rO)rrr r rr)rrs"rrrsO)A)A)As)AS)AT\]abegjbj]kTl)AyC)Arc \"VP'g\RRR7#VPV4'd.VPWW44GRjxL 'd\RRR7#\ VPR4'g\RRR7#\ V4VP 8:dTM'VPW0P \R 7^,p\\VR R4;'d,\VR R4'*;'dVPV44pVPW4pV'dRMRFpR \V4R \V4RV'dVPV4MT/p V'd\ P"V R&V P%V4\'VPP(!R/V B\*RRR7GRjxL 'd\RRR7u#\RRR7u# \RRR7#ELL: \,dp T'dJTP/T 4'd3\0P3RTP4Y\7T 44Rp ? EK,\0P3RTP4YT 4\R\7T 4R7uRp ? u#Rp ? ii;i5i)zStream a partial message via ``sendRichMessageDraft`` (when rich is enabled and supported) else ``sendMessageDraft``; reusing ``draft_id`` animates the preview. The caller sends the final text.F not_connectedrNTr1rapi_unavailablerrrrrPr+rQr/rLdraft_rejectedz[[%s] sendMessageDraft MarkdownV2 rejected, retrying as plain text (chat=%s draft_id=%s): %sz6[%s] sendMessageDraft failed (chat=%s draft_id=%s): %srrrQ)rrrLrSr)r+rrrrBr]rr rrrr}rSrrKrr3r*r6r7r8rr,) rrrPrrOr+plain_rich_previewdraft_thread_kwargsrrrs &&&&& r send_draftTelegramAdapter.send_draftspyyye?C C  * *7 3 3d>W>WX_kr>}8}8}dt< <tyy"677e3DE E //0w595J5J7TkTkt}5J5~@A6B " D2E : 1 174QginCo?o 1 1**402#;;GN);XNL5g> CPXM\++D1t&MF'0'<'<|$ MM- . W4II00:6:DW_nFKLLL%dtDD!%7GHHO,%/?@@G9~*L W D$>$>q$A$ALLu 76QRS6TV UW[W`W`biuvw!%7RST7UVV Ws6J,J,H J,BJ,,J,A0J,7$J,0H  H H  H #J,& H 2J,H  J)J$3+J$J,%7J$J)J,$J))J,c "VP'g \R4hVPR4p\VPP!R /VB\ RRR7GRjxL #L \ dpTeTPT4'dTPT4'd\PRTPT4TPTPR4T4\T4pTPRR4\TPP!R /TB\ RRR7GRjxL uRp?#hRp?ii;i5i) aSend a control-style message (approval prompts, pickers), retrying once without message_thread_id on 'Message thread not found' (stale thread_id); ``send`` has its own. Used for control-style sends (approval prompts, model picker, update prompts) that can carry a stale thread_id from a DM reply chain. The streaming send loop has its own equivalent (PR #3390) at the body of ``send``; this helper applies the same retry pattern to the non-streaming control paths. rzrr/FrLNzP[%s] Thread %s not found for control message, retrying without message_thread_idrrQ)rrrrKrr3r*r6rr7r-rr,r rY)rrrrOrPs&, r"_send_message_with_thread_fallback2TelegramAdapter._send_message_with_thread_fallback&sFyyy/ /"JJ':; 4 &&00:MUd|ABB BB !-$2L2LX2V2V[_[z[z|D\E\EfhlhqhqtEF226::i3HJ[\#F|   !4d;8II**:\:DW_nFKLLLL  se/E 0A)"A'#A)&E 'A)) E4EE&BE5D86E:E;E EEE  reply_markuprc<V^8dQhRS[RS[RS[RS[S[,RS[S[S[S[3,,RS[RS[S[,/#)rrr+rQrxrOrr)rrr r )rrs"rrr@sh G G G"% G69 GFNsm G_ghlmprumuhv_w G G19# Grc "VPRWWR7pR\V4RVRV/VP4Cp VeWiR&WR&V PVP WWXVR74VP !R /V BGRjxL #L5i) zRSend a control-style message (prompt/picker) with topic routing + thread fallback.Nrrr+rQrrr rQ)rrrrrr) rrr+rQrxrOrrr rs &&&$$$$$ r_send_control_message%TelegramAdapter._send_control_message@s88x8e 1':FD,Xb"CfjffgB"C  #%1> "(3$% d22 Yf3h i<<FvFFFFsA9B;B<BrQcj<V^8dQhRS[RS[RS[S[S[S[3,,RS[RS[RS[RS[/#)rrrrOrQrxrrr))rrs"rrrNs[SSsSSSHTRUWZRZ^D\S'*S>ASY\ShrSrc "VP'g\RRR7#V!4p\V\4'dV#Vwrp TPY)VeTM\P WW7R7GRjxL p V e V !V 4\R\ V P4R7#L0 \dLp \PRTPT\T 44\R\T 4R7uRp ? #Rp ? ii;i5i) uShared control-prompt shell: not-connected guard, ``build()`` → ``(text, keyboard, on_sent)`` (or a SendResult to return as-is), routed send, state hook, redacted failure log.FrzrN)rQrrxrOrTr1z[%s] %s failed: %s) rrr5rr}rSrrr*r7r-rr,)rrrrOrsrQrxrbuiltr+keyboardon_sentr7rs&&&&&$$$ r _send_promptTelegramAdapter._send_promptNsyyye?C C SGE%,, &+ #DG22 8N*T]TiTi%X3llC" ds3>>7JK K l  S NN/DB]^_B` ae3Nq3QR R SsS C?B&C?1B&3B$4/B&#C?$B&& C<1AC71C<2C?7C<<C?c&<V^8dQhRS[RS[/#)rbuttonsrr)rrs"rrrdsEEdEtErc h\^\V4^4Uu.uF qW^,NK up#uupi)zL2-per-row layout keeps labels readable on mobile (a 4-button row truncates).)r{r+)r$rs& r _rows_of_twoTelegramAdapter._rows_of_twocs2+03w<*CD*CQa% *CDDDs/c d<V^8dQhRS[RS[RS[RS[RS[S[S[S[3,,RS[/#)rrpromptrr session_keyrOrr))rrs"rrrhs[ M M M$' M25 MIL M]efjknpsksft]u MBL Mrc aaa"VVV3RlpSPRWVSPV4SPR7GRjxL #L5i)zJSend an inline-keyboard Yes/No prompt for the gateway ``/update`` watcher.c<S'd\RSR7MRpSPR\R4 RS V 24p\\\R4RR7\\R 4R R7..4pWR 3#) z%platform.telegram.prompt.default_hintrqr!u☤ *z&platform.telegram.prompt.update_header* zplatform.telegram.prompt.affirmzupdate_prompt:y callback_datazplatform.telegram.prompt.negatezupdate_prompt:nN)rrrsrr) default_hintr+rrrr)rs rrs1TelegramAdapter.send_update_prompt..buildksZa1DgVgiL&&q1Y/Z.[[`ag`hiuhv'wxD+$Q'H%IYjk$Q'H%IYjk.m-noH4' 'rsend_update_promptrxrNr!rr)rrr)rrr*rOrssf&ff&& rr2"TelegramAdapter.send_update_prompthsY (&& 'UdF^F^_gFhx|yLyL'MM MMs;AAAc <V^8dQhRS[/#rr)rrs"rrrysVVCVrcHR\P!\R44 R2#)u ⚠️ zgateway.exec_approval.headerz rrrrs&r _EA_HEADERTelegramAdapter._EA_HEADERxs!ELL+I)JKLHUUrz
z
c <V^8dQhRS[/#rr)rrs"rrrsLL#LrcF\P!\R44 R2#)z"gateway.exec_approval.reason_labelz: r8rs&r_EA_REASON_LABEL TelegramAdapter._EA_REASON_LABELs,,q!EFGHKKrc <V^8dQhRS[/#rr)rrs"rrrsUUSUrc8R\\R44,#) z%gateway.exec_approval.smart_deny_line)rrrs&r_EA_SMART_DENY_LINE#TelegramAdapter._EA_SMART_DENY_LINEs(+R)STTTrc&<V^8dQhRS[RS[/#rKr)rrs"rrrs""s"s"rc.\P!V4#rP)rr)rr+s&&r _ea_escapeTelegramAdapter._ea_escapes||D!!rc,<V^8dQhRS[RS[RS[/#)r description smart_deniedr)rrBr)rrs"rrrs#77S77QT7rcf\VPVP,VP,VP,VP V4,R,VP 4,V'd VPMR,4p\^VPV, 4#)...r!) rr9 _EA_CODE_OPEN_EA_CODE_CLOSEr=rG_ea_deadline_linerBr!r)rrJrKfixeds&&& r_exec_approval_cmd_budget)TelegramAdapter._exec_approval_cmd_budgets OOd00 043F3F FI^I^ ^ook* +-2 3595K5K5M N+7t''R AB1d--566rc6<V^8dQhRS[S[S[3,/#r)r r)rrs"rrrs~~4S>~rcHRUu/uFq\RV 24bK up#uupi)oncez"platform.telegram.approval.action_)rVsessionalwaysdenyr)rchoices& r_EA_ACTION_LABELS!TelegramAdapter._EA_ACTION_LABELSs0X}}W|V>vhGHHW|}}}sc&<V^8dQhRS[RS[/#)rr)r)rr)rrs"rrrs dd7Idjdrc aa"VV3RlpSPRSPSPV\PSP SP4SP R7GRjxL #L5i)zmInline-keyboard approval prompt; buttons call ``resolve_gateway_approval()`` like the text ``/approve`` flow.c V<a^RIp\SR4'gVP^4Sn\ SP4oSP UUUu.uFwrp\ VRV RS 2R7NK ppppSP\SPV44VVV3Rl3#uupppi)rN_approval_counterea:rr.cP<SPPSSP4#rP)r  __setitem__r*)r7 approval_idr)rs&rrKTelegramAdapter._send_exec_approval_prompt..build..sD00<<[&J\J\]r) itertoolsr)countraractionsrrr+rsr&)rgr;r[_r$rer)rs @rrs9TelegramAdapter._send_exec_approval_prompt..builds 4!455)2);&t556K/5~~?/=+5!,E3vhaP[}A]^/= ?;; 4T5F5Fw5O P]_ _?sB$send_exec_approval)rQrxrN)r!rrOr}HTMLrr)rr)rssff r_send_exec_approval_prompt*TelegramAdapter._send_exec_approval_promptsh _&& &..&//5U^UcUc..v?tObOb'dd ddsA(A3,A1-A3cj<V^8dQhRS[RS[RS[RS[RS[RS[S[S[S[3,,RS[/#)rrrr%r* confirm_idrOrr))rrs"rrrs[MMM#&M14MCFMTWM4S>*M6@Mrc aaaa"VVVV3RlpSPRWVSPV4SPR7GRjxL #L5i)z8Render a three-button slash-command confirmation prompt.c n<\\\R4RS 2R7\\R4RS 2R7.\\R4RS 2R7..4pSPSP SSP \ SPR44, SPR74pWVVV3R l3#) z,platform.telegram.slash_confirm.approve_oncezsc:once:r.z.platform.telegram.slash_confirm.always_approvez sc:always:z&platform.telegram.slash_confirm.cancelz sc:cancel:rM)rc<<SPPSS4#rP)r rd)r7rqrr*s&rrCTelegramAdapter.send_slash_confirm..build..s$2K2K2W2WXbdo2pr)rsrrrr_ea_fitrr)rpreviewrqr%rr*s rrs1TelegramAdapter.send_slash_confirm..builds+(+Y)ZltuuAkBC(+[)\nxzDyEmFGH&a(P&Qcmnxmyaz{| - H))$,,009T=P=PQV=W3XXaeatat+7+vwG&pp prsend_slash_confirmr3Nr4)rrrr%r*rqrOrssf&&fff& rry"TelegramAdapter.send_slash_confirms` q q&& 'UdF^F^_gFhx|yLyL'MM MMs*6@rc aaaaa"VVVVV3RlpSPRWV\PSPV4R7GRjxL #L5i)uRender a clarify prompt: numbered buttons per choice plus "✏️ Other (type answer)" (flips to text-capture mode); without choices, plain question and the gateway text-intercept captures.c <R\P!S4 2pRpS'dVRRPR\S444,, p\ \ S44Uu.uF'p\ \V^,4RS RV 2R7.NK) ppVP\ \R4RS R 2R7.4\V4pWVVV3R l3#uupi) ❓ NrArac3|"TF2wrV^, R\P!\V44 2xK4 R#5i)rz. N)rrr)rRrrs& rrT>TelegramAdapter.send_clarify..build..s3*mZlRVRSa!eWBu||CF7K6L+MZls:<cl:rr.zplatform.telegram.prompt.otherz:otherc<<SPPSS4#rP)r rd)r7r~rr*s&rr=TelegramAdapter.send_clarify..build..st/B/B/N/Nz[f/gr) rrrhr}r{r+rrrrdrrs) r+ridxrowsr}r~r|rr*s rrs+TelegramAdapter.send_clarify..builds%,,x012DH*mZcdkZl*m!mmmpuvy{BwCqDEqDil-c#'lCPZ|[\]`\aJbcdqDE 1!4T2Ugjkujvv|e}~A/5#gg gEs*-C send_clarify)rQrxN)r!r}rmr)rrr|r}r~r*rOrssf&ffff& rrTelegramAdapter.send_clarifysV h h&& Gu[_[s[st|[}' sAAA  Ac>^RIHpV# \dRpT#i;i)r get_labelcV#rPrQ)slugs&rr6TelegramAdapter._provider_get_label..get_labels r)hermes_cli.providersrrDrs r_provider_get_label#TelegramAdapter._provider_get_labels.  6   s  cj<V^8dQhRS[RS[RS[RS[RS[RS[S[S[S[3,,RS[/#)rr providers current_modelcurrent_providerr*rOrrrTr r rr)rrs"rrrsR///'+/.build.._remembersGcnnk9mU`buxI#]4FHXZikl:n((W6r)_build_provider_keyboardr_provider_list_textr) rprovider_page_infor+rrrrrrrr*s rrs0TelegramAdapter.send_model_picker..buildsd+/+H+HTU+V (H&&((8P8P8RSc8dfxyD n n9, ,rsend_model_pickerrxNr3r!rr) rrrrrr*rrOrss fffffff& rr!TelegramAdapter.send_model_pickersV - -&& (bjX\\R]E^pt--'// //sA AAAc d<V^8dQhRS[RS[RS[RS[RS[S[S[S[3,,RS[/#)rrrr}r*rOrr)rrs"rrrsJ///#&/15/DG/4S>*/6@/rc aaaaaa"VVVVVV3RlpSPRSYgV'dVPR4MRSPR7GRjxL #L5i)uFlat inline-keyboard picker (one tap → one value) for /reasoning, /fast, etc. Each choice dict: ``{"value": str, "label": str, "is_current": bool}``.c<.p\S4F}wr\VPR4;'gVPR4;'gR4pVPR4'dRV 2pVP\ VRV 2R74K V'g\ RRR 7#\ S PV44pVVVV V 3R lpS PS 4WE3#) r;rHr! is_current✓ cp:r.Fz No choicesrc\<RVPRSRSRS/SP\S4&R#)rr}r*on_choice_selectedN)rr r)r7rr}rrr*s&rrDTelegramAdapter.send_choice_picker..build.._remembers6cnni-Q\^ruG;H))#g,7r) r}rrrdrrrrsr&r) r$rr[r;rrrr}rrr*rs rrs1TelegramAdapter.send_choice_picker..buildsG&w/ FJJw/LL6::g3FLL"M::l++"5'NE3E3qcST 0 !%|DD+D,=,=g,FGH H H&&u-xB Brsend_choice_pickerrxNr3r)rrrr}r*rrOrssffffff& rr"TelegramAdapter.send_choice_pickersX  C C&& '8ckhllS^F_qu--'// //sAAAAc$<V^8dQhRS[RR/#)r result_textrNr)rrs"rrrsdd#d$drc d"VPVPV4\PRR7GRjxL R#L \db\ P !\4;_uu_4TPTRRR7GRjxL RRR4R# +'giR#;ii;i5i)zgReplace a picker message with ``result_text`` (MarkdownV2, then plain, then give up), keyboard removed.Nr+rQr)rrr}rSr*r%r&)rqueryrs&&&r_edit_result_text!TelegramAdapter._edit_result_texts d))t/B/B;/O\e\q\qAE)F F F d$$Y//--;4^b-ccc0/// ds_B04A?AB0A-B-.BB B B-B0 B) "B-&B0)B--B0c*<V^8dQhRS[RS[RR/#rdatarrNr)rrs"rrrs#555c5VZ5rc r"VPPV4pV'g&VP\R4R7GRjxL R#VR,\ VR,4,pTPR4pT'g&TP\R4R7GRjxL R#T!T\TPR 4;'gR 44GRjxL pTPY4GRjxL TP4GRjxL TPPTR4R#L \ \ 3d)TP\R4R7GRjxL R#i;iLL \d7p\PR T4\R \T4R 7pRp?LRp?ii;iLL5i)z.Handle choice picker button taps (cp:).z&platform.telegram.picker.expired_rerunrONr}NN*platform.telegram.picker.invalid_selectionr platform.telegram.picker.expiredrHr!z"Choice picker selection failed: %sz$platform.telegram.picker.apply_errorr)r ranswerrrr IndexErrorrr*r7rrrrY) rrrrrr[callbackrrs &&&& r_handle_choice_picker_callback.TelegramAdapter._handle_choice_picker_callbacksm))--g6,,F+S$T,U U U  9%c$r(m4F9912,,F+M$N,O O O  T (#fjj6I6O6OR2P QQK$$U888lln !!%%gt4% VJ' ,,F+W$X,Y Y Y   PR T LL=s CB#c(SK T 9sAF7D-F7 D/,F7F7#E+$F7+E/ E/E-E/F72F33F7 F5 #F7//E(E!E($F7'E((F7-E// F0:,F+&F7+F00F75F7c&<V^8dQhRS[RS[/#)rpr)r rr)rrs"rrr)s LLDL%9Lrc VPR\VPR.444pVR, RV R2pVPR4'dRV 2p\VRVR, 2R 7#) total_modelsmodelsrz (rErrmp:rr.)rr+rr)rrhr;s& r_provider_button TelegramAdapter._provider_button(sjnc!%%"*=&>?V9+Rwa( 55  5'NE#E3qyk9JKKrc2<V^8dQhRS[RS[RS[RS[/#)rpage total_pagesrr)rrrT)rrs"rrr1s)cSTrc  F.pV^8d2VP\\R4V RV^, 2R74VP\V^, RV 2RR74W^, 8d2VP\\R4V RV^, 2R74V#)uN``◀ Prev | n/N | Next ▶`` row (``prefix`` = ``mpv``/``mg`` page callback).zplatform.telegram.picker.prevrr./zmx:noopzplatform.telegram.picker.next)rdrrr)rrrnavs&&& r_picker_nav_rowTelegramAdapter._picker_nav_row0s !8 JJ+A.M,Nag`hhijnqrjris^tu v '4!8*Ak](CS\]^ / ! JJ+A.M,Nag`hhijnqrjris^tu v rc <V^8dQhRS[/#rr)rrs"rrr<snnTnrcZ\\R4RR7\\R4RR7.#)zplatform.telegram.picker.backmbr.platform.telegram.picker.cancelmx)rrrrQrr_picker_back_cancel_row'TelegramAdapter._picker_back_cancel_row;sA$Q'F%GW[\^rstvWtXhl_mn nrc 8<V^8dQhRS[RS[RS[RS[RS[/#)rr$ page_meta nav_prefixtail_rowr)rTr rr)rrs"rrr?s9BBtBB#BY]BbgBrcVPV4pVR,^8d1VPVPVR,VR,V44VPV4\V4VR,3#)rr page_info)r&rdrrs)rr$rrrrs&&&&& r_paged_keyboardTelegramAdapter._paged_keyboard?sf  ) ] #a ' KK,,Yv-> -@XZde f H#D)9[+AAArc,<V^8dQhRS[RS[RS[/#)rrrr)rTrr)rrs"rrrFs'VV$VcV%Vrc  ^RIHpVUu/uFqDPR4VbK pp.pVEe)T!VUu.uFqDPR4NK up4FpVR,R8XdVR,Uu.uFqV9gK WX,NK p p\ RV 44p VR, R V R 2p \ ;QJdR V 4F 'gK R M R M !R V 44'dRV 2p VP \V RVR, 2R74KVPVR,4pVfKVP VPV44K MVUu.uFq@PV4NK ppVPWbVP4wrVPWR\\R4RR7.4# \dRpELi;iuupiuupiuupiuupi)uPaginated top-level provider keyboard folding provider families (Kimi/Moonshot, MiniMax, xAI…) into one ``mpg:`` button via the shared ``group_providers`` fold; singles are ``mp:``.)group_providersNrkindrfmembersc 3v"TF/qPR\VPR.444xK1 R#5i)rrN)rr+rRr7s& rrT;TelegramAdapter._build_provider_keyboard..Ss/aY`TUnc!%%":M6N O OY`s79r;u ▸ (rEc3B"TFqPR4xK R#5i)rNrrs& rrTrUs@155..rxTFrmpg:group_idr.mpvrr) hermes_cli.models_catalog_staticrr*rrzrrdrrr_format_choice_page_PROVIDER_PAGE_SIZErr)rrrrrby_slugr$rr7rrhr; page_buttonsrs&&& rr(TelegramAdapter._build_provider_keyboardFs # H.77Y55=!#Y7  &&y'Iy!f y'IJv;')36y>R>a'\zwzz>GRaY`aaE"7|nF5';Es@@sss@@@@"&ugNN#7tTWXbTcSdMe#fg CK0A}t'<' GG< G  G cB<V^8dQhRS[RS[RS[S[,RS[/#)rrrproviderr)rTrr r r)rrs"rrras5^^D^^xPT~^af^rc  $^RIHpVPWVP4wrVVR,p.p\ V4FwrRV 9dV P R4R ,MT p V!W:4p ^&V 'd\ V 4^,M^, p \ V 4V 8dV R\V ^, ^4R,p V 'dV RV 2p VP\V RWy, 2R74K VPWR VP44#) uBuild paginated model buttons. Returns (keyboard, page_info_text). Window plans: each button carries the plan word (``model-b · Large``) from the provider row; other accounts are unchanged.)picker_row_suffixrerNrMu · mm:r.mgr) hermes_cli.model_picker_usagerr_MODEL_PAGE_SIZEr}rrr+r!rdrrrr)rrrrr page_modelsrrer$rmodel_idshortrrooms&&&& r_build_model_keyboard%TelegramAdapter._build_model_keyboardas D!%!9!9&H]H]!^ '"$[1KA/2hHNN3'+HE&x:FFVq:D5zD /s4!8Q/058 'fX. NN/s59+EVW X2##Gd>Z>Z>\]]rc$<V^8dQhRS[RR/#rtext_mdrNr)rrs"rrrss4rc "VPVPV4\PVR7GRjxL VP 4GRjxL R#LL5i)zCRe-render the picker message in place (MarkdownV2) and ack the tap.rN)rrr}rSr)rrr rs&&&&r _picker_editTelegramAdapter._picker_editssX%%4+>+>w+GT]TiTiyA%B B Blln Bs!5AAAAAAc*<V^8dQhRS[RS[RR/#rrrrNr r)rrs"rrrxs"d#$rc a "VPR.4pW2R&VPRR4pVPRR4o \V 3RlVR,4R4pVPWCV4wrxV'dVPR \V44M \V4p \V4p W8d!R \ R \ W, 4R 7 R 2MRp V'd$VPR4'd RVR, 2MRp VP VR\ R4 R\ RRV R2R7 V V R\ R4 V 2 V4GRjxL R#L5i)zGRender the model page for the provider currently selected in ``state``. model_list model_pageselected_provider_namer!selected_providerc3F<"TFqR,S8XgKVxK R#5irNrQrRr provider_slugs& rrT6TelegramAdapter._picker_show_models..~sU$6qF)}:T$6! !rNrz _z'platform.telegram.picker.more_available)rhrj plan_lineu ⚠️ ⚙ *platform.telegram.picker.titler-'platform.telegram.picker.provider_labelrprraz%platform.telegram.picker.select_model)rrr r+rrr )rrrrrpnamerrrtotalshownrr r s&&&& @r_picker_show_models#TelegramAdapter._picker_show_modelsxsJ<,"l 2B7 "5r: UE+$6UW[\"88xP=E ^S[93v;F chcp#aAU]I[\]]^_vx;C U`HaHai 567gi  A678:qq\RST]S^_h^iik89:5' C    sCE E /AE E E c2<V^8dQhRS[RS[RS[RS[/#)rrprovider_labelrrr)rrs"rrrs1OO3OOPSOX[Orc RT;'g \R4 R2pR\R4 R\RVR7 R\RVR 7 R \R 4 V 2 #) `z&platform.telegram.picker.unknown_modelr r r-z&platform.telegram.picker.current_model)modelrar r rA(platform.telegram.picker.select_providerrZ)rr' rr* s&&& rr#TelegramAdapter._provider_list_textsnMPPQ'O%PQQRS:;XYY]?@A)N Orc*<V^8dQhRS[RS[RR/#r r )rrs"rrrs(GGGSGX\Grc "VPVR,V4wrVV!VR,4pVPWPVR,Wv4V4GRjxL R# \d TR,pLIi;iL 5i)z-Render the (folded, paginated) provider list.rrrN)rr*r r)rrrrrrrr' s&&&&& r_picker_show_providers&TelegramAdapter._picker_show_providerss'+'D'DU;EWY]'^$ 7&u-?'@AN'?'?o@VXf'{~FG G G 7"#56N 7 Gs3A=A!,A=A;A=!A85A=7A88A=c<<V^8dQhRS[RS[RS[S[,/#)rrraw_idxr)r rr r)rrs"rrrs,RRDR3R8TY?Rrc "\V4pTP R.4pT^8gT\ T48d&TP\R4R7GRjxL R#TP R4pT'g&TP\R4R7GRjxL R#YET,TP RR 4T3# \d)TP\R4R7GRjxL R#i;iLLZ5i) uhResolve ``mm:``/``mc:`` index → ``(idx, model_id, provider_slug, callback)``; answers + None on error.rrONr z,platform.telegram.picker.invalid_model_indexrrr r!)rrrrrr+)rrrr2 rr rs&&&& r_picker_selection!TelegramAdapter._picker_selections g,CYY|R0 7cS_,,,F+Y$Z,[ [ [9901,,F+M$N,O O OsOUYY/BB%GQQ ,,F+W$X,Y Y Y  \ PsXC1 B7AC1C-C16C1C/"C17)C* C#!C*&C1)C**C1/C1c0<V^8dQhRS[RS[RS[RR/#)rrr r rNr)rrs"rrrs+ 4 43 4# 4VY 4hl 4rc "RpV!W#V4GRjxL pVP W4GRjxL TP \V'dRMR4R 7GRjxL VPPVR4R#Lh \d9p\PRT4\R\ T4R7pRpRp?LRp?ii;iLLl5i) zGPerform the model switch, render the result, and drop the picker state.FNzModel picker switch failed: %sz%platform.telegram.picker.switch_errorrTz&platform.telegram.picker.switch_failedz!platform.telegram.picker.switchedrO) r*r7rrrrrrrrY) rrrr r r switch_failedrrs &&&&&& r_picker_switchTelegramAdapter._picker_switchs  ! (M JJK $$U888llS`'OgJ!KlL L L   $$Wd3K ! LL93 ?C3s8TK M ! 9 LsYC A=A;A=CC,CC"C;A== C.B;6C;CCCc6<V^8dQhRS[RS[S[,/#)rrrr)rrs"rrrschsmrc"\V4# \d)TP\R4R7GRjxL R#i;i5i)z%platform.telegram.picker.invalid_pagerON)rrrr)rrs&&r _parse_pageTelegramAdapter._parse_pages> s8O ,,F+R$S,T T T s-A A)A;AAAAc*<V^8dQhRS[RS[RR/#rr)rrs"rrrs(N!N!sN!SN!UYN!rc a"VPPV4pV'g&VP\R4R7GRjxL R#VP 4pVP R4'dVR,o\ V3RlVR,4R4pV'g&VP\R4R7GRjxL R#SVR &VPR S4VR &VPR .4VR &VPW^4GRjxL R#VP R4'dCVPWR,4GRjxL pVeVPWV4GRjxL R#R#VP R4'dGVPWR,4GRjxL pVe!WtR&VPWWu4GRjxL R#R#VP R4'dLVPWVR,4GRjxL pVe%Vwrop VPWV SV 4GRjxL R#R#VP R4'Ed"VPWVR,4GRjxL pVfR#Twrop ^RI H p \P!WSR7GRjxL pVe\#\%\'R4RV 2R7.VP)4.4pVP+VP-RVP. RVP0 24\2P4VR7GRjxL VP\R4R7GRjxL R#VPWV SV 4GRjxL R#VP R4'EdATR,p^RIHpVPVRR.34wpppVR,Uu/uF pVR,VbK ppVUu.uFpVV9gK VV,NK ppV'g&VP\R 4R7GRjxL R#TP;VUu.uFpVP=V4NK up4pVP?VP)44TPATR!\'R"4 R\'R#R$T;'gT R$2R%7 R&\'R'4 2\#V44GRjxL R#VR(8XdATPY\CVPR^4;'g^4V4GRjxL R#VR)8Xd[VPPEVR4VP+\'R*4RR+7GRjxL VP4GRjxL R#VP4GRjxL R#EL7ELELxELBEL'ELELELELtEL:EL \ dRpELi;iELELwEL\ \ d R.ppEL)i;iuupiuupiELuupiEL/LLLLu5i),z@Handle model picker callbacks (mp:/mpg:/mpv:/mm:/mc:/mb/mx/mg:).z&platform.telegram.picker.expired_modelrONrrc3F<"TFqR,S8XgKVxK R#5ir rQr s& rrT@TelegramAdapter._handle_model_picker_callback..sY(:1i=>XQQ(:r rz+platform.telegram.picker.provider_not_foundr rr rr mg:mpv::NNrmc:r)combined_selection_warningr z&platform.telegram.picker.switch_anywayr.u⚠ *r-rz*platform.telegram.picker.confirm_selectionr)PROVIDER_GROUPSr!rz(platform.telegram.picker.group_not_foundr r z(platform.telegram.picker.provider_familyrp)familyrAr+ rrz"platform.telegram.picker.cancelled)r+r)#rrrrr startswithrr$ r= r/ r4 r9 !hermes_cli.model_selection_guardsrG r0rr*rsrrrrrrrr%r}rSrrH r&rrdr rrY)rrrrrrrrsel_idxr rrrG r-rrrH _label_desc member_slugsrrr7rrr s&&&& @r_handle_model_picker_callback-TelegramAdapter._handle_model_picker_callbacks((,,W5,,F+S$T,U U U ,,. ??5 ! ! HMYk(:Y[_`Hll/\(]l^^^)6E% &.6ll6=.QE* +"*,,x"%PQD KK446 7##:;V?W-W-:V;%W- V!W-W-VW-/!VVVBW-V1"W-=V4>W-V7W-: W-V:# W-.WW- W W"(W- W W- W:AW- *W-3W"46W-+W-:W%;AW-W'W-W)W-5W+6W-?W-W-W-W- W-W-W-W-W-V V.*W--V..W-4W-7W-:W  W- W  W-W-%W-'W-)W-+W-c$<V^8dQhRS[RR/#)r user_displayrNr)rrs"rrrsIIIIrc "\P!\4;_uu_4VP\ R4R7GRjxL RRR4TP TR\ P!VPP;'gR4 R\ P!\R44 R24GRjxL R#L~ +'giL;iL5i) uTell the user a clarify tap arrived too late (entry evicted or gateway restarted) — otherwise the tap leaves a misleading ✓ the agent never sees.z&platform.telegram.prompt.expired_toastrONrr! z%platform.telegram.prompt.expired_body) r%r&r*rr_edit_html_quietrrr%r+r)rrrT s&&&r_notify_clarify_expired'TelegramAdapter._notify_clarify_expireds  + +,,F+S$T,U U U,## T%,,u}}'9'9'?'?R@AVWXWAJBICCGHI I I V, + IsA#CCCC AC 1C<C=CC C  Cc$<V^8dQhRS[RR/#)rr+rNr)rrs"rrrsccCcDcrc "\P!\4;_uu_4VPV\P RR7GRjxL RRR4R#L +'giR#;i5i)zBHTML edit with the keyboard removed; failures ignored (non-fatal).Nr)r%r&r*rr}rm)rr+s&&rrX TelegramAdapter._edit_html_quietsN  + +))t ]a)b b b, + b, + +s.#A0&A A A A0A A- ' A0c$<V^8dQhRS[RR/#r r)rrs"rrr sBB3B4Brc "\P!\4;_uu_4VPVP V4\ P RR7GRjxL RRR4R#L +'giR#;i5i)zHMarkdownV2 edit with the keyboard removed; failures ignored (non-fatal).Nr)r%r&r*rrr}rS)rrr s&&&r_edit_md_quietTelegramAdapter._edit_md_quiet sj   + +))t/B/B7/KXaXmXm}A)B B B, + B, + +s.#A?5A+A)A+ A?)A++ A< 6 A?c><V^8dQhRS[RS[PRR/#rrrrNrorzr)rrs"rrr%s.,W,W,W,B[B[,W`d,Wrc "\VRR4pVfR#\VRR4p\\VRR4;'gR4P4p\V4;'d VP WUR\VRR4R7pV'g6^R I H pVP4VP.VR R7GRjxL R#^RIHpHp ^RI H p Hp \$P&!T \VRR4;'gR\VRR4;'gRR7GRjxL wrV Uu.uF1pV!VR,VR,VR,V !VR,4R7NK3 ppVP4VPWR V R7GRjxL R# \ d)\ PR TPR R 7R pEL8i;iEL \ d7TP4\ PRTPR R 7R#i;iLuupiL \ d7TP4\ PRTPR R 7R#i;i5i)agAnswer ``@botname `` with a searchable command/skill picker (the ``/`` menu is capped at 60 slots). Results are computed per keystroke, 50 per page; tapping sends ``/cmd`` text as the user, so dispatch flows through the normal command path. Inline queries arrive from ANY chat, so unauthorized users get an empty list (the skill catalog is not leaked). inline_queryNrrZr!r\r)rrXryz$[%s] inline picker auth check failedTr3F)CACHE_TIME_SECONDS) cache_time is_personalz&[%s] inline picker empty answer failed)InlineQueryResultArticleInputTextMessageContent)rg build_inline_resultsroffset)rm rrJ message_text)rZrrJinput_message_content)rh ri next_offsetz [%s] inline picker answer failed)r]rrrBrr*r7r8r(plugins.platforms.telegram.inline_pickerrg rrr r<rj rk rl r0r)rrrrf rrkr _deny_cacherj rk _CACHErl resultsrp r2articless&&& rrk$TelegramAdapter._handle_inline_query%sG v~t<   L+t< gir288b9??A goo4+L+LIQZ\fhlIm,M,oJ  af##%"))"RV)WWW  W R s)0):):$ gr288bW_acAdAjAjhj*l$l G!  !A)waja >N*A!NBS*TV!      !%%htal%m m m7  LL?UYL ZJ X a--/ Etyy[_ `  a$l  n W  ) ) + LL;TYYQUL V WsAIF $ F I -G:G;G?I4H7H HH H#7H )HHHI /F=9I<F==IG=HIHIH H=I IIIc6<V^8dQhRS[S[S[3,/#rr)rrs"rrrTsGGS#XGrc  \VRR4p\VRR4pR\VRR4R\VRR4R\VRR4R \VPR R4/#) zEChat/thread/user context of a button tap, for the callback auth gate.r%NrrrXr'rxrry first_name)r]r)r query_message query_chats& r _callback_ctxTelegramAdapter._callback_ctxSsx y$7 ]FD9 w}i> WU_agimMn 0CTJKY`afapapr~AEZFG GrcB<V^8dQhRS[S[S[3,RS[RS[/#)rcb denial_textrr rrrB)rrs"rrr\s,DcNQTY]rc N"TP\\VPRR44VR,VR,e\VR,4MRVR,e\VR,4MRVR,R7'dR #VP VR 7GRjxL R #L5i) zRGate a button tap on the callback allowlist; answers ``denial_text`` when refused.rZr!rrXNrxryrTrOF)rrr]rr)rrr r s&&&&r_callback_authorized$TelegramAdapter._callback_authorized\s  , , r2 3R ].0o.Ic"[/*t.0o.Ic"[/*t_abm_n - p pll l,,, -sBB%B%B#B%c><V^8dQhRS[RS[PRR/#rc rd )rrs"rrrfs)6LD]D]bfrc "VPpV'dVP'gR#VP4VPpVPV4pRVP3RVP 33FwrgVP V4'gKVP'd \VPP4MRpV'd:VPW5\44GRjxL 'dV!W4V4GRjxL R# RVP3RVP3RVP3RVP3RVP 33F0wrVP V 4'gKV!W4V4GRjxL R# R#LLL5i) zCDispatch inline keyboard button clicks on the callback_data prefix.Nzgt:rbzsc:rzupdate_prompt:)rrrD rrF rrrC )r)callback_queryrrr| rQ rrJ r%rrr r_handle_gmail_triage_callback_handle_exec_approval_callback_handle_slash_confirm_callback_handle_clarify_callback_handle_update_prompt_callback) rrrrrr prefixesrrrs &&& rrj&TelegramAdapter._handle_callback_queryfsU%%EJJJ  zz    &FtGiGi j t:: ;"= Hx((8= #emm3344T%>%>u-/%ZZZ!%w777"=D66 7%AdAd9e D77 85$B_B_:` tBB C EOFv&&e2...  E [7/sZ&F A$F F $(F  F *F+ F 5 F FA%F , F 8F9 F F F rYc N<V^8dQhRS[S[S[3,RS[RS[RS[RS[/#)rr rdenialresolvedrYr )rrs"rrrs;T#s(^D_bnq{rc "VPWV4GRjxL 'gR#V'dVPVR4MVPV4pV'gVPVR7GRjxL V#L[L5i)zeAuth-gate a button tap, then claim its pending entry; None (after answering) when refused or expired.NrO)r rYrr) rrr rrr r rYr*s &&&&&&&$ r_claim_callback_state%TelegramAdapter._claim_callback_statesb..u&AAA.1eiiT*uyy~ ,,H,- - - B .s1A8A4 A8 A8*A8A8-A6.A86A8c@<V^8dQhRS[RS[S[S[3,RR/#rrr rNr=)rrs"rrrs,*<*<*<cSVh*<\`*:`` — resolve a pending exec approval.rNz-platform.telegram.approval.toast_invalid_datarOz1platform.telegram.approval.toast_already_resolvedry platform.telegram.user_fallback)resolve_gateway_approvalzKTelegram button resolved %d approval(s) for session %s (choice=%s, user=%s)z;Failed to resolve gateway approval from Telegram button: %srV resolved_oncerWresolved_sessionrXresolved_alwaysrY resolved_denyresolved_genericzplatform.telegram.approval.+platform.telegram.approval.resolved_by_userr;rz"platform.telegram.approval.expiredz)platform.telegram.approval.expired_detail)r;r)rrr+rrrrrr r rr]rrtools.approvalr r7rr*rrrr` resume_typing_for_chatr)rrrr partsr[rer*rT r rhr label_keyr; edit_texts&&&& rr .TelegramAdapter._handle_exec_approval_callbacks 3" u:? q eAh-K!66 t++[-/ F GII  u dCkkqIjGk   @,[AE KK]_dsy I )=OQY[lntwFGKK*,I3I;?@EGuhI:;EEUSIllm| 4l555!!%333 R ].  ' 'ByM(: ;/5CJ' ,,F+Z$[,\ \ \  I   LLVX[ \E  63s.HF3H6G7 HH# H0%GHA*HHH H! H-2H/GGGHGH H )HHH  HHc@<V^8dQhRS[RS[S[S[3,RR/#r r=)rrs"rrrs1-b-b-bcSVh-b\`-brc "VPR^4p\V4^8wdR#V^,pV^,pVPWVPV\ 4\ R44GRjxL pV'gR#RRRRRR /P VR 4p\VPR R4;'g \R 4p \R V 24p VPV R\R7GRjxL VPV\RWR74GRjxL ^RI Hp V PWvV4GRjxL p V 'EdVP 'Ed\VP RR4p \\VP RR4RR4p\VP RR4pR\#VP P$4RVP'V 4R\(P*/VP-4Cp\/\VRV44P14R\/\2P44P14\/\\2P4R\2P444P1409pV eR\/V 4/pRpV'dVe\#V4;pVR&RVR&VP7VP9\/VP P$4\/V 4VVVP:R74VP<!R"/VBGRjxL R#R#R#ELELBEL ELL \>d/p\@PCR TPDTRR!7Rp?R#Rp?ii;i5i)#uF``sc::`` — resolve a slash-command confirmation.rN0platform.telegram.slash_confirm.already_resolvedrVzslash_confirm.resolved_oncerXzslash_confirm.resolved_alwaysr|zslash_confirm.resolved_cancelzapproval.resolved_genericry r zplatform.telegram.rOr r ) slash_confirmrrr'rrr+rQrHr\rxrTrr z&[%s] slash-confirm callback failed: %sr3rQ)#rrr+r r rrrr]rrrrr` toolsr resolver%rrrr}rSrrrr~PRIVATErrrrr*r7rr)rrrr r r[rqr*r rT r;_slash_confirm_modrrxrXprompt_message_idrHis_private_chatmetar rs&&&& rr .TelegramAdapter._handle_slash_confirm_callbacks) 3" u:? q1X  66 t00*mo E FHH  :HFegorQRVV /1 u dCkkqIjGk &yk23llm| 4l555!!%+X`e)yzzz b A 2 : :;TZ [[K{u}}}$EMM3FM #GEMM64$H&RVW $+EMM<$N!s5==#8#8964CVCVWbCc )"7"7/X;?;T;T;V/X #&gi)&L"M"S"S"Us8#3#34::w>}>}>ZA#A(,7Y+HD"&K&+<+HKNO`Kaa k2G&HCG?@&&t'C'C!MM11y>4[`d`s`s(D(uv==L LLL+ -{H 6z\,M b LLA499c\`L a a bsA*M0,L&- M097M016M0'L)($M0 L, M0L4-L/. L4;L4G L4L2L4 M0)M0,M0/L42L44 M-?#M("M0(M--M0c@<V^8dQhRS[RS[S[S[3,RR/#r r=)rrs"rrrs5ArAr#Ar4S>ArVZArrc "VPR^4p\V4^8wdR#V^,pV^,pVPWVPV\ 4\ R4RR7GRjxL pV'gR#\ VPRR4;'g \R4pVR8XdRp ^R I H p V !V4p V 'g8VPPVR4VP!W4GRjxL R#VP#\ R 4R 7GRjxL TP%TR VP&P(;'gR R\*P,!\RVR74 R24GRjxL R#\/V4p Rp ^RI HpT!T4pT'dKTP6'd9^T u;8:d\TP648dMMTP6T ,p T f RT ^, 2p TPPTR4^RI HpT!Y]4pT'dTP#RT R, 2R 7GRjxL TP%TR \*P,!TP&P(;'gR4 R\*P,!T4 R\*P,!T 4 24GRjxL \P=RY]T4R#TP!Y4GRjxL \PRT4R#EL \d-p \PR TPT 4Rp ? ELRp ? ii;iELdELBEL \0\23d)TP#\ R4R 7GRjxL R#i;i \dRp ELi;i \d/p \P;RTPT 4RpRp ? ELRp ? ii;iELEL$L5i)uU``cl::`` — resolve a clarify prompt or flip to text capture.rNr F)rYry r other)mark_awaiting_textz"[%s] mark_awaiting_text failed: %sz$platform.telegram.prompt.type_answerrOrr!rV z'platform.telegram.prompt.awaiting_typed)rrW z'platform.telegram.prompt.invalid_choice) get_pendingzchoice )resolve_gateway_clarifyz'[%s] resolve_gateway_clarify failed: %sr:N<Nz z: z$?,@ @ @''ell5==+=+=+C+CDEWU\\ZfMgLhhnoto{o{}JpKoLMN N N KKVXbs A..uC C C NNdfp quS UCTYYPSTT U H S kI& ,,F+T$U,V V V   ! M !  LLBDIIs SH  A N DsVA,O8.L/ O8;O8O81L!?O80O87M8$O8M-O8 /O8:M!;O8 M$ O8N &N 8$N O8N 0,O8N4+O83O8O0=O8>O8O31O8O6O8! M,!M O8MO8O8!O8$/NNNO8NO8 N1-O80N11O84 O-?#O("O8(O--O83O86O8c@<V^8dQhRS[RS[S[S[3,RR/#r r=)rrs"rrr's1SSScSVhS\`Src "VPR^4^,pVPW\44GRjxL 'gR#VP\ RVR7R7GRjxL \ VR8XdRMR4pVP VR \ R R V R 2R7 24GRjxL ^R IHpV!4R , pVPR4pVPVRR7VPV4\PRV\VPRR44R#LLL \ d"p \P#RT 4Rp ? R#Rp ? ii;i5i)uE``update_prompt:`` — forward the answer to the update process.rNz$platform.telegram.prompt.update_sent)rrOyz$platform.telegram.prompt.affirm_wordz$platform.telegram.prompt.negate_wordu☤ z(platform.telegram.prompt.update_answeredrprz.update_responsez.tmpr)rz/Telegram update prompt answered '%s' by user %srZunknownz1Failed to write update response from callback: %s)rrr rrrrr` rr with_suffix write_textrr7rr]rr*r) rrrr rwordr response_pathtmprs &&&& rr .TelegramAdapter._handle_update_prompt_callback's1C#A&..u-/JJJ ll'MV\ ]l^^^6S=7Ntu!!%42\ghimhnnoep0q/r)sttt S 8+-0BBM++F3C NN6GN 4 KK & KKI6SZ[`[j[jlpr{S| }K^t S LLLc R R Ssd7ED# E"E&D%'?E&D''E,A5D)!E%E'E) E4E EEEr{z send-draft.sh done_sendarchivez archive.sh done_archivedraftzdraft-blank.sh done_draftspamzspam.sh done_spammutez mute-add.shemail done_mutez mute-domaindomaindone_mute_domaintrustztrusted-ops-add.sh done_trustz trust-domaindone_trust_domainvipz vip-add.shdone_vipz vip-domaindone_vip_domainc@<V^8dQhRS[RS[S[S[3,RR/#r r=)rrs"rrrIs14n4ns4nSRUX4n[_4nrc D "VPR^4p\V4^8wd&VP\R4R7GRjxL R#V^,V^,reVP W\ 44GRjxL 'gR#VP PV4pV'g(VP\RVR7R7GRjxL R#Twrr^RIH p V !4R, R , V, p V P4'gIVP\R VR 7R7GRjxL \PR VPV 4R#R p^RIHp\ P"!\%V 4V.V O5R\ P&P(R\ P&P*R\ P&P*RV!RR7/GRjxL p\ P,!VP/4^4;_uu_4VPN!R0R-V/V 'd/MR.R/BGRjxL RRR4R#ELELqEL$ELELEL \<d3\3R!TR7p\PR"TPYV4EL?\>dGp\3R#T\%T4R$7p\PR%TPYVTRR&7Rp?ELRp?ii;iELvL +'giR#;i5i)1z=Dispatch a gmail-triage inline-button callback (gt:verb:arg).rz+platform.telegram.gmail_triage.invalid_datarONz+platform.telegram.gmail_triage.unknown_verb)verbrscriptsz gmail-triagez-platform.telegram.gmail_triage.script_missing)scriptz$[%s] gmail-triage script missing: %sF)build_subprocess_envrrstderrenvT)strip_launch_profiler`zplatform.telegram.gmail_triage.z-[%s] gmail-triage callback ok: verb=%s arg=%srr)rz(platform.telegram.gmail_triage.exit_code)r$z%platform.telegram.gmail_triage.failed:NPN)r detailzA[%s] gmail-triage callback failed: verb=%s arg=%s rc=%s stderr=%sz(platform.telegram.gmail_triage.timed_outz4[%s] gmail-triage callback timed out: verb=%s arg=%sz$platform.telegram.gmail_triage.error)r rz;[%s] gmail-triage callback exception: verb=%s arg=%s err=%sr3r!ry r raz*platform.telegram.gmail_triage.appended_byr r+rrrQ)(rrr+rrr r_GT_VERB_DISPATCHrrrrr7rrtools.environments.localr r0create_subprocess_execrrrPIPEr: communicaterrrdecoderrrGr*rr%r+r]rr%r&r)rrrr r r argr script_name extra_args success_key is_state_verbr script_pathrr r  _stdout_bytes stderr_bytesr; stderr_text last_liner original_textrT appendeds&&&& rr -TelegramAdapter._handle_gmail_triage_callbackIs& 3" u:?,,F+X$Y,Z Z Z !HeAhc..u-/JJJ &&**40,,F+X_c$d,e e e >C; 4%')3nD{R !!##,,F+Zcn$o,p p p LL?K X  B E 77K #E(2E:A:L:L:T:TE]d]o]o]t]tE~E~P~P~U~UE(dCEED180@0@AQAQAS]_0`*` 'M<!#;K=IJ KTYYX\b*11')1LRRT ;Q?9R ?RR  R  R  R c,<V^8dQhRS[RS[RS[/#)rr;rrr)rrs"rrrs"s##rc TV RV 2pVPR4'd VR, pV#)z`File-not-found error for MEDIA delivery; /workspace-style paths often exist only in the sandbox.z file not found: z (path may only exist inside the Docker sandbox. Bind-mount a host directory and emit the host-visible path in MEDIA: for gateway file delivery.))z /workspace/z/output/z /outputs/)rJ )rr;rrs&&& r_missing_media_path_error)TelegramAdapter._missing_media_path_errors;'*4&1 ??C D D s tE rc6<V^8dQhRS[RS[S[,/#r image_pathrr)rrs"rrrs#rc \VR4;_uu_4pVP^4pRRR4XPR4'dR#TPR 4'dR#TPR4'dTR,R8XdR#TPR 4'dR #TPR 4'dR #R# +'giL;i \dR#i;i)zIdentify convertible raster formats by magic bytes. Replacement for stdlib ``imghdr`` (removed in Python 3.13). Returns one of ``png``/``gif``/``webp``/``bmp``/``tiff`` or None. rNsPNG  pngsRIFF: NsWEBPwebpsBMbmptiff)sGIF87asGIF89a)sII*sMM*)rreadr'rJ )r fhheads& r_sniff_raster_format$TelegramAdapter._sniff_raster_formats j$''2wwr{( ??/ 0 0 ??1 2 2 ??7 # #T g(= ??5 ! ! ??3 4 4('  s-CB=C= C C C CCc6<V^8dQhRS[RS[S[,/#r r)rrs"rrrs#]]#](3-]rc  ^RIp\PPV4p\PP T4^,P 4pTR9dR#Y0P8dR#TPT4fR#^RI H pTPT4;_uu_4pTP R9dTP#RTP$R4pTP R8XdTP'R4MTpTP R9d)TP)YP+4R,R7MTP)T4Tp MTP'R4p RRR4X P$wr\-Y4p YP.8dPTP.T , p T P1\3Y,4\3Y,43TP44p TP7RR R 7wr\P8!T4T P;TR TP<R R R 7\P?RTPTTR, T\PPT4R, 4T# \dR#i;i \d%\PRTP4R#i;i +'giELi;i \d-p\PRTPT4Rp?R#Rp?ii;i)a Pre-compress a large image to progressive JPEG before upload. Behind an HTTP proxy (e.g. tgapi.indevs.in) the PTB media_write_timeout (~20s) is easily exceeded by raw PNGs > 1-2MB. A progressive JPEG at ~85% quality keeps the upload well under the timeout while remaining visually equivalent for photos / info-graphics. Returns the path to a temporary JPEG, or None when the original can be used as-is (already small / already JPEG / Pillow not available). The caller is responsible for cleaning up the returned temp file. Nr)Imagez/[%s] Pillow not available for image compressionRGBAPRGB)mask tg_compress_rJPEGT)quality progressiveoptimizeuA[%s] Pre-compressed %s (%.1fKB → %s %.1fKB) for Telegram uploadrz5[%s] Image compression failed, uploading original: %s)rr)r LAr )r r )r r r) r rrr$r'rr_IMG_COMPRESS_THRESHOLD_BYTESr PILr r*r7r-rrrFnewsizeconvertpasterrr!_IMG_MAX_DIMENSIONresizerLANCZOSr"r#save_IMG_JPEG_QUALITYr)rr r  file_sizeextr src backgroundlayerimgmax_wmax_hmax_dimscaler+r rs&& r_compress_image_to_jpeg'TelegramAdapter._compress_image_to_jpegs   3Iggz*1-335 # # 99 9  $ $Z 0 8  ! 3 J''38822"'5#((O!LJ3688s?CKK/Ezz^3"(([[]25F(G"((/$C++e,C(88LE%'G000//'9jj#em"4c%-6H!I5==Y&&%'GB HHRL HH..    KKS D $t+  JM  *  NNLdii X (''T  NNG     sUI7 J K*B1J;DK7 JJ +J87J8; K  K L!LLc2<V^8dQhRS[RS[RS[RS[/#)rr;r% max_bytesr)rrr)rrs"rrrs1JJCJCJTWJ\_Jrc\^VR,4p\T;'g^4R, R R2pRV RV RV R2# \\3dRpL!i;i) rz.1fz MBz unknown sizez [Telegram z skipped: file size z exceeds the z0 MB limit. Ask the user to send a smaller file.]r)r!rrr)rr;r% r2 limit_mb size_texts&&&& r_telegram_media_too_large_note.TelegramAdapter._telegram_media_too_large_notes{q) 45 'y~~A.+>sC3GIE7"6ykxjYIJ J:& '&I 's AAAc&<V^8dQhRS[RS[/#r)rr)rrs"rrr sCCrc^\T;'g^4# \\3d^#i;ir)rrrr"s&r _int_or_zeroTelegramAdapter._int_or_zeros. uzz? ":&  s ,,c R<V^8dQhRS[RS[RS[S[S[S[,3,/#)rrr;r)rrrrBr )rrs"rrrs8RR3RsRuTS[\_S`M`GaRrc \\VRR4;'gR4pVP\VRR44pV^8:gWC8:dR#RVPW$V43#)znCFnrc x"VPW#V4wrVPV/V CVCWHWVR7GRjxL #L5i)zJSend one native media payload with thread routing + DM-topic anchor retry.rJN)rD rQ) rrGrrrOrIrJrG r rs &&&&&&&, r _send_mediaTelegramAdapter._send_media!sW#55gR @@ //,/ Ann nn 1:8:cF<V^8dQhRS[S[,RS[S[,/#)rr7rr r)rrs"rrr*s#33x}3#3rc(V'd VR,#R#)NiNNrQ)r7s&r _caption_1024TelegramAdapter._caption_1024)s!(wu~2d2rc &a".pV'd_VPV4p\V4R8:d"VPV\P34TPTR,R34MVPR4Rp VF?wrVPVPPW#VRV3RlSWVR 7 GRjxL u# T ;'g \#R 4h \ d&\ PRTPRR7Li;iLP \ dvp \T 4P4p T eSR T 9gR T 9dE\ PR TP\T 44T p SP!^4Rp ? EKhRp ? ii;i5i)zsendVoice with caption variants: MarkdownV2 when it fits 1024 chars, plain fallback when the Bot API rejects the entities; anything else is a real error.rzF[%s] voice caption MarkdownV2 formatting failed; sending plain captionTr3rP Nvoicec&<SP^4#r: r* audio_filesrr4TelegramAdapter._send_voice_bubble..Csdndsdstudvr)rJrT r7rQrrRentitz:[%s] voice caption MarkdownV2 rejected, retrying plain: %sz3Telegram send_voice failed for all caption variantsNN)rrrdr}rSr*r7r8rrJ r send_voicerrr-r,r*r)rrX rrrOr7 duration_secs_caption_variants_formatted_caption_last_parse_error _cap_text_cap_parse_mode _cap_errorrs&f&&&&& r_send_voice_bubble"TelegramAdapter._send_voice_bubble-s*,  A%)%8%8%A"/0D8%,,.@)BWBW-XY  $ $gend%; <  $ $\ 215*; &I !--II(('Xw\v$i^k.mmm+< ff<0e#ff) A egkgpgp{ A Am *o++-".GsNgQTnNNTVZV_V_a|~HbIJ(2%OOA& sr FAC5F4D;D <D? F F-D FD  F D FA(F FF  FFc <V^8dQhRS[RS[RS[S[,RS[S[,RS[S[S[S[3,,RS[/#)rr audio_pathr7rrOrr))rrs"rrrPsT+6+6+6(++66>sm+6V^_bVc+64S>*+6@J+6rc X <a "VP'g\RRR7#Rp\PP V4'gh\RVP RV4R7V'dC\ P!\4;_uu_4\P!V4RRR4##VPR4'd\PPV4^,P4R9dn^RI Hp\P !W4GRjxL pV'dTpM>\"P%RVP&\PP)V44\P !\*V4GRjxL p \-VR 4;_uu_4o \PPV4^,P4p V R9dVP/S WWSV 4GRjxL p MV R9dJVP1VPP2WVR V 3R lS VP5V4V R 7 GRjxL p MpVP7WW4VR 7GRjxL uuRRR4V'dC\ P!\4;_uu_4\P!V4RRR4##RRR4\R\9X P:4R7V'dC\ P!\4;_uu_4\P!V4RRR4## +'gi#;iEL#ELELQELL +'gi#;i +'giL;i +'gi#;i \<dp \"P?RTP&\AT 4RR7\BST`YY4TR7GRjxL uRp ? T'dV\ P!\4;_uu_4\P!T4RRR4# +'gi#;i#Rp ? ii;i T'dV\ P!\4;_uu_4\P!T4RRR4i +'gii;ii;i5i)z.mshrhwhwxyhzr)rJrl r7r)r file_pathr7rrOTr1zJ[%s] Failed to send Telegram voice/audio, falling back to base adapter: %sr3r).ogg.opus>rp rq >.m4a.mp3)#rrrrrr r%r&r'unlinkrrrgateway.platforms.baserk r0rr7r-rbasenamer rrd rJ send_audiorQ send_documentrrr*rr,rr\ )rrrg r7rrOr_transcoded_voice_pathrk _duration_secsr& r7rrX rs&&&&&&, @rr\ TelegramAdapter.send_voicePsoyyye?C C04$ 677>>*--!%t7U7UV]_i7jk@&((11II4521&;zz*%%"''*:*::*Fq*I*O*O*QYj*jH/6/@/@AV/c)c&)!7JNNA 277#3#3J#?A$+#4#45RT^#__Nj$'':gg&&z215;;=++ $ 7 7 GW_jx yyC,, $ 0 0 ,,g7`z($2D2DW2MXf!1!hhC"&!3!3 'wlt"4"vv('$&((11II4521&%(ds3>>7JK&((11II4521&119*d`zhv21'('&21 g LL\^b^g^g+A.  ?+G]e+fff f%((11II452111&  g &((11II452111&sl"R*AN (*R*L2) R*3N AN "M# N /AN MN 'AM&:M ;AM& M M&'M(M&+ N 5*R*M6 R*'N 'R*/"R*M9( R*2 M =R*N N M&M&M& M# R*& M6 1N 9 N R* QAQOQQQ"*R* P,# R*, P< 7 R*QQ+R'3R R' R#  R''R*c n<V^8dQhRS[RS[S[,RS[S[S[S[3,,RS[RS[/#)rrimagesrO human_delayr)rrTrr r rrAr)rrs"rrr}sXKgKgKg$(KKg;CDcN;SKginKgzDKgrc ^ <aa!"SP'g\RRR7#V'g\RRR7#^RIHpT3RlpTUu.uFq!T^,4'gKTNK p pTUu.uFq!T^,4'dKTNK p pRp T 'd&\S"S`%YY4R 7GRjxL p T Pp T 'g\Y'dRR7#R R7#^R I H p ^ p\^\T 4T4Uu.uF qYT,NK pp\T4EFwppT^8d&T^8d\ P"!T4GRjxL .p.o!.pTFwppTpTP%R 4'dT !TR ,4p\&P(P+T4'g$\ P RSPT4KvSP-T4pT'dTP/T4Tp\1TR4pS!P/T4TP/T!TSP3T4R74K T'gS!F>p\4P6!\4;_uu_4TP94RRR4K@ TFDp\4P6!\:4;_uu_4\&P<!T4RRR4KF EK\ P?RSP\T4T^,\T44SPATRT4wppRT!3RllpSPCSPPD/TCRT/CTTRTR7GRjxL Rp S!F>p\4P6!\4;_uu_4TP94RRR4K@ TFDp\4P6!\:4;_uu_4\&P<!T4RRR4KF EK \Y'dRR7#R R7# \dEp\ P RSPT4\S"S`%YY44GRjxL uRp?#Rp?ii;iuupiuupiELuupiEL; +'giEKL;i +'giEK;iELF \d{p\ P RSPT^,\T4\GT4RR7\S"S`%TTY4R 7GRjxL p T ;'g T Pp Rp?ELRp?ii;i +'giEK;i +'giEK;i S!FRp\4P6!\4;_uu_4TP94RRR4K@ +'giKQ;i TFXp\4P6!\:4;_uu_4\&P<!T4RRR4KF +'giKW;i i;i5i)zSend images as Telegram albums (``send_media_group``, 10 per chunk). Animated GIFs can't join a media group (need ``send_animation``) so they go via the base per-image path, as does a failed chunk.Frzrzno images to send)InputMediaPhotozD[%s] InputMediaPhoto unavailable, falling back to per-image send: %sNcb<VPR4'*;'dSPV4#)file://)rJ _is_animation_url)urlrs&rr6TelegramAdapter.send_multiple_images..s(#..";;[[@V@VWZ@[[r)r~ zall images failed to send)unquoter :NNz.[%s] Skipping missing image in media group: %sr)mediar7z5[%s] Sending media group of %d photo(s) (chunk %d/%d)cV^8dQhRR/#rdrQ)rs"rr:TelegramAdapter.send_multiple_images..__annotate__s''T'rc<SF?p\P!\4;_uu_4VP^4RRR4KA R# +'giKV;i)rN)r%r&r*r*)r opened_filess r_reset_opened_filesATelegramAdapter.send_multiple_images.._reset_opened_filess;*'00;;GGAJ<;+;;;s A  A r z media grouprI TzI[%s] send_media_group failed (chunk %d/%d), falling back to per-image: %sr3)$rrr<r r*r7r-rrsend_multiple_imagesrrr r{r+r}r0rCrJ rrrr/ rdrrQ r%r&r#r'r(rrD rQsend_media_groupr,)#rrr} rOr~ r ris_animr* animationsphotosr anim_result_unquoteCHUNKrr chunk_idxrOr temp_paths image_urlalt_textr local_path compressedr r r rHr rrr rs#f&&&& @rr $TelegramAdapter.send_multiple_images}syyye?C Ce3FG G ^ 0\%+?Vcws1vccV ?!'?#ws1v##?  % &Q>,X-2R R X-3R4X- ;X-R ;X-R X-!AS6;S2A#S'X->R 3X-R( X-(BS7R=8S>'X-%U 63X-)U ,X-, Q;74Q6+Q.,Q60Q;1X-6Q;;X- X- R%  X-( R: 3 X-=S U AUT! U- U:U2UU2 U  X- U/ ( X-2(X*V5 + X*5 W2X*2X X* X$ X**X-c <V^8dQhRS[RS[RS[S[,RS[S[,RS[S[S[S[3,,RS[/#)rrr r7rrOrr))rrs"rrrsT%*%*%*(+%*6>sm%*V^_bVc%*4S>*%*@J%*rc (<aaaaaaa a "SPS4pT;'gSo V'dK\PP\PP S44^,R,M\PP S4o RV V VVV VVVV3 RllpSP RS SSSRVV3RlV4GRjxL V'dC\ P!\4;_uu_4\P!V4RRR4##LN +'gi#;i T'dV\ P!\4;_uu_4\P!T4RRR4i +'gii;ii;i5i)z5Send a local image file natively as a Telegram photo.rc0V^8dQhR\R\/#)rrr)r*r)rs"rr5TelegramAdapter.send_image_file..__annotate__s E E9 E Erc < "\V4pRV9gRV9d#\PRS PS4M,\P RS P\ V4RR7S P SSSSS S R7GRjxL #L \dOp\PRS PTRR7\\S `/SSSS S R 7GRjxL uRp?#Rp?ii;i5i) Photo_invalid_dimensionsPHOTO_INVALID_DIMENSIONSzK[%s] Image dimensions exceed Telegram photo limits, sending as document: %szO[%s] Failed to send Telegram local image as photo, trying document fallback: %sTr3)rro r7 file_namerrONzV[%s] Failed to send Telegram local image as document, falling back to base adapter: %sr) rr7rrr-r,rx r*rrrzsend_image_file) r error_strdoc_errr actual_pathr7rdoc_namer rOrrs & r _photo_failed6TelegramAdapter.send_image_file.._photo_faileds AI)Y6:TXa:a ikoktktwABegkgpgp/2TC E!//#{GW_%0:::: E lIIw7#?DI'S]_fhp|DIEEEE  EsTA(C),B B B C) B C&>C!CC!C&C)!C&&C)r rc.<RVRSPS4/#rr7rQ )fr7rs&rr1TelegramAdapter.send_image_file..s7Ay$2D2DW2MNrN) r/ rrrrv _send_local_filer%r&r'r() rrr r7rrOrr r r r rs ffffff, @@rr TelegramAdapter.send_image_files 11*=  ..J Q[277##BGG$4$4Z$@A!DvMacahahaqaqr|a} E E E( *..gx7NP]__((11IIj)21 _ 21((11IIj)2111se%FA:F, D0 D D0*F:D FD0 D- (F0+FE; 2 F; F  FFc2<V^8dQhRS[RS[RS[RS[/#)rr;r media_keyr)rr)rrs"rrrs-%%% #%MP% %rc Da "VP'g\RRR7#\PP V4'g\RVP W4R7#\ VR4;_uu_4o VP!\VPRV 24W4WV3RV 3Rl/V!S 4BGRjxL p RRR4\R \X P4R 7#L, +'giL2;i \dp T!T 4GRjxL uRp ? #Rp ? ii;i5i) zShared shell for native local-file sends: existence check, open, send with routing, then ``await on_error(exc)`` on any failure. ``build_kwargs(f)`` supplies the media kwargs.Frzrrsend_rJc&<SP^4#r: rV )r srr2TelegramAdapter._send_local_file..s q rNTr1) rrrrrr rrJ r]rrr*) rr;rrrrOr build_kwargson_errorr7rr s &&&&&&&&& @rr TelegramAdapter._send_local_files yyye?C C %77>>$''!%t7U7UV[7bccdD!!Q ,,DIIyk':;WPXF 1F5A!_FF"ds3>>7JK KF"!  %!!$$ $ %s| D $C7 C7$D %C792J g`j grc <aaaaaaa"SPRSSSSRVVVV3RlVVVVVVVV3Rl4GRjxL #L5i)z. sCz1j)2Z2Zrww?O?OPY?Z\egkgygy{BhCDrc X<SPRV\\S`SSSSSSR74#)r r)r rrzrx ) rrr7rr ro rOrrs &rrr s3dooAu#T 'GY[c-dfrN)r ) rrro r7r rrOrrs fffffff,rrx TelegramAdapter.send_documentsH** Iw(J D f fgg ggs .?=?c <V^8dQhRS[RS[RS[S[,RS[S[,RS[S[S[S[3,,RS[/#)rr video_pathr7rrOrr))rrs"rrrsT * * *(+ *6>sm *V^_bVc *4S>* *@J *rc <aaaaaaaa "\P!\S4GRjxL oS'd4\P!\SSP R44GRjxL MRo VVVV 3RlpSP RSSSSRVV VVVVVV3Rl4GRjxL S 'dC\ P!\4;_uu_4\P!S 4RRR4##LLLR +'gi#;i S 'dV\ P!\4;_uu_4\P!S 4RRR4i +'gii;ii;i5i)aSend a video natively as a Telegram video message. Real geometry and a JPEG thumbnail ride along explicitly. Telegram only runs its own video processing for uploads under roughly 10 MB; larger files come back as an unprocessed ``320x320`` video with ``duration=0`` and no thumbnail, which clients then draw as a square tile whatever the true aspect ratio (portrait reels and 16:9 clips alike). NrcP<RVRSPS4/SCpS'dSVR&V#)videor7 thumbnailr )r rr7rr thumb_paths& rr 0TelegramAdapter.send_video..build_kwargs#s6"Ay$2D2DW2MZQYZ,6GK(rVideor c V<SPRV\\S`SSSSSR74#)r r)r rrz send_video)rrr7rrOrrr s&rr,TelegramAdapter.send_video..-s7$//Qot GQ[]dfnzB G!Cr) r0rrr,rr r%r&r'rr() rrr r7rrOrr rr rs ffffff, @@rr TelegramAdapter.send_videos !**+@*MM##$9:x||T^G_` ` `!  *  ..Wh'< ((11IIj)21)N `21((11IIj)2111sE%C* E%.E%%C,&E%-.DC.D*E% C0 E%,E%.D0 D ;E%+E".E  E" E  E""E%c <V^8dQhRS[RS[RS[S[,RS[S[,RS[S[S[S[3,,RS[/#)rrr r7rrOrr))rrs"rrr5s\jjj'*j5=c]jU]^aUbj4S>*j6@jrc <"VP'g\RRR7#^RIHpV!V4'g;\P RVP 4\SV`!WW4VR7GRjxL #VPV4pVPVPPWVRW'R 7GRjxL p\R \VP4R 7#LhL& \Edvp \P R TP \T 4R R 7^RIHp ^RIHp T !RRT ./R7;_uu_4GRjxL p T P'T4GRjxL p T P)4T P*pRRR4GRjxL M +GRjxL 'giM;iTPTPPYTRXTR 7GRjxL p\R \TP4R 7uRp ? # \dNp\P-RTP TR R 7\ST`!YY4TR7GRjxL uRp?uRp ? #Rp?ii;iRp ? ii;i5i)ubSend a URL image as a Telegram photo: URL send (<5MB) → download+upload (≤10MB) → base text.Frzr) is_safe_urlz/[%s] Blocked unsafe image URL (SSRF protection)rNz URL photor Tr1z8[%s] URL-based send_photo failed, trying file upload: %sr3)ssrf_redirect_guard)create_ssrf_safe_async_clientrmresponse)r? event_hookszuploaded photoz+[%s] File upload send_photo also failed: %s)rrtools.url_safetyr r7r-rr send_imagerQ rJ send_photorrr*r,ru r r rraise_for_statusrr)rrr r7rrOr photo_captionr7rr r clientresp image_datae2rs&&&&&& rr TelegramAdapter.send_image5syyye?C C09%% NNLdii X+G\d+ee e**73  j(( $$g;V_)xxCds3>>7JK K fx j NNJDIIWrstWuAE  F jFJ8T^at`uSvwww|B!'I!666D))+!%Jxwwwww!,,II(('XGW_itA-BBB!$3s~~;NOO j JDIIWYdh i"W/G`h/iiiii j js3I5I,C-I-C0C1#CIC I%,I%G:7D: 8G:<FE !F3 G:>F?G:F F F F 6G:G$G:4I5I: I8I =I>I IIII IIIIc <V^8dQhRS[RS[RS[S[,RS[S[,RS[S[S[S[3,,RS[/#)rr animation_urlr7rrOrr))rrs"rrrUs\ggg+.g9A#gYabeYfg4S>*g6@grc "VP'g\RRR7#VPVPPWVRVVP V4R7GRjxL p\R\ VP 4R7#L$ \dTp\PR TP\T4RR 7TPYY4TR 7GRjxL uRp?#Rp?ii;i5i) zJSend an animated GIF natively as a Telegram animation (auto-plays inline).Frzr animation)r r7NTr1zA[%s] Failed to send Telegram animation, falling back to photo: %sr3r) rrrJ send_animationrQ rrr*r7rrr,r )rrr r7rrOr7rs&&&&&& rr TelegramAdapter.send_animationUsyyye?C C g(( (('X{^k**73)55Cds3>>7JK K5 g LLSUYU^U^+A.  ?]efff f  gsS C(=B B!#BC(B C%AC CC C%C( C%%C(c&<V^8dQhRS[RS[/#rr)rrs"rrrgs _ _ _d _rc a\VRR4eR#\VRR4;'g\VRR4p\V\4'dVR8XgVR8dR#\V4P 4o\ ;QJdV3RlR 4F 'gK RM R M!V3RlR 44'dR#\V\ \\\P34#) z:Return True for Telegram typing errors worth cooling down.rNTrr$irDc3,<"TF qS9xK R#5irPrQ)rRr<r+s& rrT=TelegramAdapter._is_transient_typing_error..ost,s&~,sr?F)ztoo many requestsz rate limitrr?temporar) r]r5rrrrr'rGConnectionErrorr0)rrr+s& @r_is_transient_typing_error*TelegramAdapter._is_transient_typing_errorfs 3 t , 8c=$7UU73PT;U k3 ' '[C-?;RUCU3x~~ 3t,st333t,st t t#H\H\]^^rc*<V^8dQhRS[RS[RR/#)rrrrN)rr*)rrs"rrrss' } }s } }t }rc x\VR4'g/Vn\VRR4pVe \V4M VPp\P!4P4\R\VR44,VP\V4&R# \ \ 3dTPpLui;i)zJSuppress Telegram typing refreshes for this chat after transient failures.rrNrro) r)rr]rArrrr0rr}r!rr)rrrrr3s&&& r_record_typing_cooldown'TelegramAdapter._record_typing_cooldownsst>??35D 0c=$7  ;*5*AE+&tGmGmE>E=U=U=W=\=\=^adehjmnsuzj{a|=|,,S\::& ;::E ;sBB98B9c&<V^8dQhRS[RS[/#rrrr')rrs"rrr~s  3 4 rc8\VR4'g/VnRVnVPP\ V44pVfR#\ P !4P4V8dR#VPP\ V4R4R#)rrmNFT) r)rrrrr0rr}rY)rruntils&& r_typing_in_cooldown#TelegramAdapter._typing_in_cooldown~s|t>??35D 059D 24488WF =  # # % * * ,u 4 ,,00WtDrc <V^8dQhRS[/#)rrrw)rrs"rrrs))S)rc  "\\V44pVPPR/4pVPPR/4p\P !4pVP V4VJdR5xR#VPV\P!44pT;_uu_4GRjxL WTV&R5xVPVR4\VRR4'gVPVR4RRR4GRjxL R#LW TPTR4\TRR4'gTPTR4ii;iLE +GRjxL 'giR#;i5i)uFIFO per-chat gate around outgoing API calls, reentrant within one asyncio task (media paths nest: send_voice → send_document, and ``super().send_*`` fallbacks reach ``send()``; a plain ``asyncio.Lock`` re-acquired by its holder would wedge that chat's sends for good)._telegram_chat_send_locks_telegram_chat_send_lock_ownersN_waiters) rrrrr0rrrrYr])rrrlocksownersr.rs&& rrMTelegramAdapter._chat_send_locks  ,W56)-)A)AB]_a)b*.--*B*BCdfh*i##% ::c?d "  W\\^4443K ) 3%tZ66IIc4(44  3%tZ66IIc4(7 444sfB1E)3D 4E)7E =D 7E 9 E)E E) :EE  E) E& E E& E& E)c,<V^8dQhRS[RS[RS[/#)rrrr)rrAr)rrs"rrrs"''3'e' 'rc  VPPR/4p\P!4P 4\ R\ \V4R44,V\\V44&\V4#)a#A send refused with ``retry_after=wait`` arms a per-chat window during which ``send()`` fails closed locally (same ``flood_control:`` result, so ledger recognition and redelivery timing are unchanged) instead of firing more requests into a penalty Telegram lengthens while it is hammered._telegram_send_cooldown_untilrro) rrr0rr}r!rrArrr)rrrr s&&& rr^+TelegramAdapter._record_send_flood_cooldownsl#'--":":;Z\^"_:A:R:R:T:Y:Y:[^abegjkpqukvx}g~^:c,W567 &&rc6<V^8dQhRS[RS[S[,/#r )rr rA)rrs"rrrs  c huo rc VPPR/4p\\V44pVP V4pVfR#V\ P !4P4, pV^8dV#VPVR4R#)zLSeconds left in this chat's flood window, or ``None`` when sends may go out.r N rrrrrr0rr}rY)rrr rdeadline remainings&& rr.TelegramAdapter._send_flood_cooldown_remainingsz"&--":":;Z\^"_,W5699S>  w779>>@@ q=  #trc&<V^8dQhRS[RS[/#r )rrA)rrs"rrrs  S U rc VPPR/4p\\V44pVP V4pVfR#V\ P !4P4, pV^8:dVPVR4R#V#)zQSeconds until this chat's shared send+edit slot is open again (0 = may fire now)."_telegram_chat_outbound_slot_untilNrr )rr slot_untilrr r s&& rr-TelegramAdapter._chat_outbound_slot_remainings{'+}}'?'?@dfh'i ,W56>>#&  w779>>@@ > NN3 %rc$<V^8dQhRS[RR/#)rrrNrw)rrs"rrrsBBBBrc VPPR/4p\VR\4p\P !4P 4\RV4,V\\V44&R#)zEArm/re-arm this chat's slot after an actual send/edit API call fires.r !_telegram_chat_outbound_slot_secsrN) rrr]#_TELEGRAM_CHAT_OUTBOUND_BUDGET_SECSr0rr}r!rr)rrr budgets&& rr(TelegramAdapter._hold_chat_outbound_slots`'+}}'?'?@dfh'i BDgh  $ $ & + + -C0@ @ 31':;.__annotate__s I I4 Irc<"SPP!RR\S4RR/VBGRjxL SPP \ S4R4R#L+5i)ractiontypingNrQ)rsend_chat_actionrrrYr)kwrrs,r_action,TelegramAdapter.send_typing.._actionsT)),,p5OPW5Xpaipmop p p  0 0 4 4S\4 H qs-AA,A)rz1[%s] Failed to send Telegram typing indicator: %sTr3) rr rrrr*r r r7r8rr,)rrrO _is_dm_topicrr% r fallback_excsff& rrmTelegramAdapter.send_typings.yyyD44W== " +/ I I H228 > > H 1 =L!)OO L66|DD44WlKL0033,,Wa8 LLLdiiYtuvYwCGL H H Hs)EE=B<B=BEB E E B3'B*(B3-E3 C1>)C,'E,C11E >E EEEc<<V^8dQhRS[RS[S[S[3,/#r r=)rrs"rrrs'II3I4S>Irc "VP'gRRRR/#VPP\V44GRjxL pRpVP\P 8XdRpMWVP\P 8XdVP'dRMRpM!VP\P8XdRpRVP;'g VP;'g \V4RVR VPR \VR R 4/#L \dRp\P!R TP"T\%T4R R7R\T4RRR\T4/uRp?#Rp?ii;i5i)z&Get information about a Telegram chat.rUnknownr'r[Nrfr^rrrYFz0[%s] Failed to get Telegram chat info for %s: %sTr3r)rget_chatrr'r~GROUP SUPERGROUPrYCHANNELrrrrr]r*r7rrr,)rrrrXrs&& r get_chat_infoTelegramAdapter.get_chat_infos;yyyIvt4 4 I++,Fw,OPPDIyyHNN*# h111'+}}}G' h...%  DDdnnDDG fiYceiererGD*e<> >Q I LLKTYYX_a|b!  #CL&$QH H IsZE4'DDAD9DD+'DE4D E1 AE,&E1'E4,E11E4c&<V^8dQhRS[RS[/#rr)rrs"rrrsc$c$cc$cc$rc fa a aV'gV#/o^.o RV V3Rllo RV 3Rllp\V4pV 3Rlp\P!RVV4p\P!RV 3RlV4pV 3R lp\P!R WS4pV 3R lp\P!R Wc\PR 7p\P!RV!RR4V4p\P!RV!RR4V4p\P!RV!RR4V4p\P!RV!RR4V4pV 3Rlp\P!RWs\PR 7p\ V4p\ \ SP444FpVPVSV,4pK .p \\P!RV44FQwrV ^,^8XdV PV 4K&V P\P!RV 3RlV 44KS RPV 4#)zConvert standard markdown to Telegram MarkdownV2: code is stashed behind placeholders first (never modified), markdown constructs become MarkdownV2 syntax, everything else is escaped.c0V^8dQhR\R\/#rr)rs"rr4TelegramAdapter.format_message..__annotate__ s  s s rcV<RS^, R2pS^;;,^, uu&VSV&V#)z@Stash *value* behind a placeholder token that survives escaping.zPHrQ)rHrcounter placeholderss& r_ph+TelegramAdapter.format_message.._ph s171:,d+C AJ!OJ %L Jrc0V^8dQhR\R\/#)ropen_r#r)rs"rrr6 s N NC N Nrc<aaVVV3Rl#)cP<S!S \VP^44 S 24#)r)rPrf)r7r; r#r> s&rrBTelegramAdapter.format_message.._ph_wrap..s%SE7< +C*DUG!LMrrQ)r> r#r; sffr_ph_wrap0TelegramAdapter.format_message.._ph_wraps M Mrc<VP^4pVP^4pVP^4pVP^4pVPRR4PRR4pVS!W#,V,4,#)r\\\r) z\`rfr)r7ropeningbodyclosingr; s& r_protect_fenced7TelegramAdapter.format_message.._protect_fenced*skWWQZFggajG771:DggajG<<f-55c5ADC 899 9rzF(?m)^((?:(?!```)[^\n])*)(```[^`\n]*\n)([\s\S]*?)(^[ \t]*```)[ \t]*\r?$z (`[^`]+`)cR<S!VP^4PRR44#)rrE rF rG )r7r; s&rr0TelegramAdapter.format_message..<sc!''!*,,T6:;rc<VP^4PRR4PRR4pS!R\VP^44 RV R24#)rrE rF rEz\)[]()rfrrP)r7r r; s& r _convert_link5TelegramAdapter.format_message.._convert_linkBsR''!*$$T62::3FC< 34Bse1=> >rz-\[([^\]]+)\]\(([^()]*(?:\([^()]*\)[^()]*)*)\)c<\P!RRVP^4P44pS!R\ V4 R24#) \*\*(.+?)\*\*rSrp)rUrNrfrrP)r7innerr; s& r_convert_header7TelegramAdapter.format_message.._convert_headerHsAFF+UAGGAJ4D4D4FGE<./q12 2rz^#{1,6}\s+(.+)$)flagsrU rpz \*([^*\n]+)\*rjz ~~(.+?)~~~z \|\|(.+?)\|\|||c <VP^4VP^4r!VPR4'd2VPR4'dS!V R\VRR4 R24#S!V R\V4 24#)rz**r[  N)rfrJ r3rP)r7rrr; s& r_convert_blockquote;TelegramAdapter.format_message.._convert_blockquoteTs{ggaj!''!*G  &&7+;+;D+A+AfXQ|GCRL'A&B"EFF&<#8"9:; ;rz^((?:\*\*)?>{1,3}) (.+)$z(```[\s\S]*?```|`[^`]+`)z[(){}]c,\PW4#rP)rz_escape_bare_bracket)r7_segs&&rrrN fs/JnJnopJwrr!) _wrap_markdown_tablesrUrN MULTILINErPreversedrTrrr}rrrdrh)rrrB r+rK rR rW r_ r _safe_partsrM rc r; r9 r: s&& @@@rrTelegramAdapter.format_messagesN #   N N %W-$ :vv U   vv  ;   ?vvF \ 3vv(/r||Tvv&c(:DAvv&c(:DAvvlHS#$6=vv&t(rrrr) _extra_or_secretrrrr5rBrrr)rrrs rrrt rZalts&&&&* r _extra_boolTelegramAdapter._extra_bools%dkk&7&7M  C!![[..2237 !   J j$ ' ' :$$&,,.2LLLrc<<V^8dQhRS[RS[RS[S[,/#)rrrs r)rrX)rrs"rrrs+NN#NNSNrc \VPPWRRR7p\V4p\ V\ 4'dKVUu0uF=p\ V4P4'gK$\ V4P4kK? up#\ V4PR4Uu0uF*qDP4'gKVP4kK, up#uupiuupi)uNComma/list allowlist: scoped ``env_name`` → ``config.extra[key]`` → empty.r!Fblank_is_unsetro) rv rr_decode_json_list_literalr5rTrrrr)rrrs rparts&&& r_extra_str_setTelegramAdapter._extra_str_setst{{00#TYZ', c4 25K#$T9J%CIOO%#K K),S)<M)<  )<MMLMs !C/C+C#C#c <V^8dQhRS[/#rr.)rrs"rrrsXX4Xrc (VPRRR4#)zBReturn whether group chats should require an explicit bot trigger.require_mentionTELEGRAM_REQUIRE_MENTIONrrx rs&r_telegram_require_mention)TelegramAdapter._telegram_require_mentions 13MwWWrc <V^8dQhRS[/#rr.)rrs"rrrs11d1rc *VPRRRR4#)zdStore skipped unmentioned group messages as context (observe chatter, dispatch only when addressed)."observe_unmentioned_group_messages+TELEGRAM_OBSERVE_UNMENTIONED_GROUP_MESSAGESr!ingest_unmentioned_group_messagesr rs&r,_telegram_observe_unmentioned_group_messages:`` (General topic = ``1``).free_response_topicsTELEGRAM_FREE_RESPONSE_TOPICSr rs&r_telegram_free_response_topics.TelegramAdapter._telegram_free_response_topicss""#9;Z[[rc&<V^8dQhRS[RS[/#rr)rrs"rrrsnnnDnrc VP4pV'gR#VPV4pV'gR#V RVPVPV44 2V9#)zGTrue when the message's chat/topic pair is in ``free_response_topics``.Fr)r _chat_id_str_topic_id_or_general_effective_message_thread_id)rr%rrs&& r _telegram_is_free_response_topic0TelegramAdapter._telegram_is_free_response_topics[446##G,!D55d6W6WX_6`abcgmmmrc0<V^8dQhRS[S[,/#rr )rrs"rrrsNNSNrc &VPRR4#)zGroup chat IDs the bot responds in (non-empty: others need ``guest_mode`` + @mention; DMs never filtered; empty = no restriction). allowed_chatsTELEGRAM_ALLOWED_CHATSr rs&r_telegram_allowed_chats'TelegramAdapter._telegram_allowed_chatss""?4LMMrc0<V^8dQhRS[S[,/#rr )rrs"rrrsZZs3xZrc &VPRR4#)z0Return Telegram chats authorized at group scope.group_allowed_chatsrr rs&r_telegram_group_allowed_chats-TelegramAdapter._telegram_group_allowed_chatss""#8:XYYrc0<V^8dQhRS[S[,/#rr )rrs"rrrsWWSWrc VP4pV'g \4#VP4pV'd W,#T#)uuChats where observed group context may use a shared source: ``group_allowed_chats`` ∩ ``allowed_chats`` (when set).)r rXr )r group_allowedresponse_alloweds& r_telegram_observe_allowed_chats/TelegramAdapter._telegram_observe_allowed_chatss;::< 5L7793C}/VVrc0<V^8dQhRS[S[,/#rr )rrs"rrrsPP#c(Prc &VPRR4#)zForum topic IDs this bot handles (non-empty: other topics ignored; DMs never filtered; missing ``message_thread_id`` == General topic ``1``).allowed_topicsTELEGRAM_ALLOWED_TOPICSr rs&r_telegram_allowed_topics(TelegramAdapter._telegram_allowed_topicss""#35NOOrc0<V^8dQhRS[S[,/#r)rXr)rrs"rrrs  3s8 rc \VPPRRRRR7p\V4p\ 4p\ V\ 4'dTM\V4PR4FAp\V4P4pV'gK&VP\V44KC V# \\3d&\PRTP T4K|i;i)uVThread ids to skip: scoped ``TELEGRAM_IGNORED_THREADS`` → ``config.extra`` → none.ignored_threadsTELEGRAM_IGNORED_THREADSr!Fr| roz,[%s] Ignoring invalid Telegram thread id: %r)rv rrr~ rXr5rTrrrrr[rrrr7r-r)rrignoredrHr+s& r_telegram_ignored_threads)TelegramAdapter._telegram_ignored_threadsst{{002CE_actyz',E'T22cCs8KKEu:##%D a CI& Lz* aMtyyZ_` asB332C)(C)cD<V^8dQhRS[S[P,/#r)rTrUPattern)rrs"rrrs MM4 +;Mrc b\RR4P4pV'd\P!V4pM%VPPPR4pVf.#\W PRR\R7# \dTP 4Uu.uF*q3P4'gKTP4NK, MuupippT'gLTP R4Uu.uF*q3P4'gKTP4NK, MuupippLi;i)z=Compile optional regex wake-word patterns for group triggers.TELEGRAM_MENTION_PATTERNSr!romention_patternsr<Telegram) log_prefixplatform_label display_labellogger_) rqrrrr*rrrrrrr]rr7)renv_rawpatternsr s& rr)TelegramAdapter._compile_mention_patternss##>CIIK  ]::g. {{((,,-?@H  I'YYWaq{FLM M ]5<5G5G5IZ5ITZZ\LDJJL5IZZ9@s9K\9Kzz|  9K\H\ ]s5BD. C<C#D.3D$D$#D.-D.c <V^8dQhRS[/#rr)rrs"rrrsUUUrc V'd;\\VRR44PR4R,P4#R#)uPPTB enum or plain-string ``chat.type`` → bare lowercase name (``supergroup``).r'r!.rrr]rrr)rs&r_chat_type_strTelegramAdapter._chat_type_strs;IMs74,-33C8<BBDTRTTrc <V^8dQhRS[/#rr)rrs"rrrsFFFrc D\\\VRR4RR44#)rNrZr!)rr]r%s&rr TelegramAdapter._chat_id_strs777FD94DEErc <V^8dQhRS[/#rr)rrs"rrrsYYYrc8Ve \V4#VP#rP)rrrs&&rr $TelegramAdapter._topic_id_or_generals!*!6s9~XCrfr])r]rBr )rr%rs&& r_is_group_chatTelegramAdapter._is_group_chats3w-DzRRd11$7;RRRrc6<V^8dQhRS[RS[S[,/#r)rqr r)rrs"rrr s#HH7Hx}Hrc \\VRR4pVPV4p\VRR4p\\VRR44pVR 9pT;'d\VRR4RJpVe5V'g V'd V'gVR8XdV'd \V4#R#V'd VP#R#) aRoutable thread id: forum General-topic messages arrive with ``message_thread_id=None`` but Telegram addresses that topic as ``1``; plain group/DM replies carry a reply-UI anchor that is NOT a routing id. Gating, skill binding and outbound routing must all agree on this value.rNrrFrYTr\)rfr])r]r rBrr)rr%rrXrris_grouprs&& rr ,TelegramAdapter._effective_message_thread_id s w-&&t, g2D91CU KL 77!NNgdJ&F$&N ?(/?YR[E[`p3x/=s++G4Grz[a-z0-9_]{2,29}botroc <V^8dQhRS[/#rr)rrs"rrr sPPsPrc \VRR4pV'dV#\VPRR4;'gRPR4P4#)zThis bot's live @username (lowercased, no ``@``): the last observed handle beats PTB's ``get_me()`` cache, which keeps a stale handle after a BotFather rename.rNrr!@)r]rlstripr)robserveds& r_current_bot_username%TelegramAdapter._current_bot_username sJ4!94@ O :t4::BB3GMMOOrc4<V^8dQhRS[S[,RR/#)rrrNrN )rrs"rrr(s# L L8C= LT Lrc ,T;'gRPR4P4pV'gR#\VRR4pW28XdR#W n\P !4VnV'd$\PRVPW24R#R#)z9Record the bot's current @username, logging real renames.r!r Nrz[[%s] Telegram bot username changed: @%s -> @%s (mention routing now follows the new handle)) r rr]rr}r~rr7rr)rrhandlers&& rr;"TelegramAdapter._note_bot_username(s|..b((-335 4!94@   &,#(,(8%  KKmosoxox{C L rc$<V^8dQhRS[RR/#)rr%rNr)rrs"rrr6sNN'NdNrc \VPRR4pVfR#\VRR4\\VRR4RR43F9pVfK \VRR4V8XgKVP\VRR44K; R#)zLearn our own handle from a message Telegram says we authored (own messages and ``reply_to_message``); only trusted when the user id matches this bot.rZNrreply_to_messager)r]rr;)rr%bot_id candidates&& r"_observe_bot_identity_from_message2TelegramAdapter._observe_bot_identity_from_message6sD$/ > !';=wwwXjlpGqs~AE@FGI$D$)G6)Q'' :t(LMGrc <V^8dQhRS[/#rr.)rrs"rrr@skkkrc \VRR4pVRJ;'d*\P!4V, VP8#)uTrue when identity was re-read within the TTL. ``None`` (never checked) is always stale — do not fold it into ``0.0``: monotonic clocks have an arbitrary epoch.rN)r]r}r~r)r checked_ats& r_bot_identity_is_fresh&TelegramAdapter._bot_identity_is_fresh@s=T#=tD %jj4>>+;j+HDLjLj*jjrr&c$<V^8dQhRS[RR/#)rr&rNr.)rrs"rrrFs??D?T?rc Z"VPpVe\\VRR44'gR#V'gVP4'dR#\P !VP 4VP4GRjxL p\P!4TnTP#\TRR44R#L< \Pdh\dFp\PRTPTP4;'gRT4Rp?R#Rp?ii;i5i)zRe-read bot identity when the cache may be stale (``get_me()`` rewrites PTB's ``Bot._bot_user`` in place). Best-effort: a failed probe keeps the last known handle.Nr8z7[%s] Telegram identity refresh failed (keeping @%s): %sr r)rrfr]r r0r:r8_BOT_IDENTITY_PROBE_TIMEOUTr6r*r7r8rr r}r~rr;)rr&rfmers&$ rr%TelegramAdapter._refresh_bot_identityFsii ;hwsHd'CDD 4466  '' d6V6VWWB)-(8% J =>X%%    LLI499VZVpVpVrVVvBE F  sR6D+D+D+2CCC 8D+CD("D(#:D#D+#D((D+c&<V^8dQhRS[RS[/#rr)rrs"rrr[sfffDfrcVP'd\VRR4'gR#\VPRR4p\T;'d&\VRR4\VPRR48H4#)r NFrrZ)rr]r rB)rr% reply_users&& r_is_reply_to_bot TelegramAdapter._is_reply_to_bot[sayyy1CT J JW55{DI Jdd7:tT#BgdiiY]_cFd#deerc <V^8dQhRS[/#rr)rrs"rrrbshhhrc# "\VRR4;'gR\VRR4;'g.3x\VRR4;'gR\VRR4;'g.3xR#5i)z<``(text, entities)`` pairs for the message text and caption.r+Nr!entitiesr7caption_entitiesr<r s&r_entity_sourcesTelegramAdapter._entity_sourcesasfgvt,22GGZQU4V4\4\Z\\\gy$/552wwHZ\`7a7g7gegggs*A%A%A%A%c <V^8dQhRS[/#rr)rrs"rrrhsGGGrcv\\VRR44PR4R,P4#)r'r!r rr )entitys&r _entity_typeTelegramAdapter._entity_typegs/7662./55c:2>DDFFrc6<V^8dQhRS[RS[S[,/#)r source_textrr)rrs"rrrls# F Fs Fx} Frc \\VRR44p\\VR^44pV^8gV^8:dR#VPWV4#)z9The entity's text, or None when its offsets are unusable.rm rNr)rr]_telegram_entity_text)rr$ r rm rs&&& r _entity_spanTelegramAdapter._entity_spanksMWVXr23WVXq12 A:1((fEErc<<V^8dQhRS[RS[RS[S[,/#)rr% self_usernamer)rqrrX)rrs"rrr{s)+'+'W+'S+'Z]^aZb+'rc aa\4pT;'gRPR4P4oRVV3RllpSPV4FwrVVFpSP V4pVR9dKSP WW4p V fK4V P 4p VR8XdAV PR4P4p V!V 4'dVPV 4KV PR4p V ^8dKW^,RP 4P4p V!V 4'gKVPV 4K K SPV4FuwrV 'd V'dK\P!RV 4FCpVP^4P4p V!V 4'gK2VPV 4KE Kw V#) zExplicit bot usernames mentioned in text/captions: foreign handles count only when bot-shaped (``...bot``), ``self_username`` opts our OWN handle in regardless of shape. Entity mentions are authoritative; the raw-text fallback is deliberately narrow.r!r c0V^8dQhR\R\/#)rr rr')rs"rrDTelegramAdapter._extract_bot_mention_usernames..__annotate__s F F3 F4 Frc<V'gR#S'd VS8XdR#\SPPV44#)FT)rB_FOREIGN_BOT_HANDLE_RE fullmatch)r rowns&r_is_bot_handleFTelegramAdapter._extract_bot_mention_usernames.._is_bot_handles1v}22<r4 bot_command) rXr rr r! r' rr[findrUrcrf)rr%r* mentioned_bot_usernamesr2 r$ r r entity_type entity_textr at_indexcommand_targetraw_textrr1 sf&& @r_extract_bot_mention_usernames.TelegramAdapter._extract_bot_mention_usernameszs -0E""**3/557 F F&)%8%8%A !K"!..v6 &@@!..{C &)//1 )+(//4:: Hx%VX`aQ--/!&))+//7b#?'&rc2<V^8dQhRS[RS[RS[RS[/#)rr$ rm rr)rr)rrs"rrrs)3SSrc V^8gV^8:dR#VPR4V^,W,^,PR4# \dR#i;i)z=Return a Telegram entity span using UTF-16 code-unit offsets.r!z utf-16-le)rr UnicodeDecodeError)r$ rm rs&&&rr& %TelegramAdapter._telegram_entity_texts[ A:1 %%k26A:vRS>ST[[\gh h!  s6A AAc&<V^8dQhRS[RS[/#rr)rrs"rrrsWrc$VP'gR#VP4p\VPRR4pV'dRV 2MRpVPV4EFwrVVEFpVP V4pVR8XdIV'dAVP WW4p V e*V P 4P4V8XdR#KbKdVR8Xd0\VRR4p V 'd\V RR4V8XdR#KKVR8XgKV'gKVP WW4p V fKV PR4p V ^8gKWRP 4P4V8XgEKR# EK V'dW PW49#R#) FrZNr r4 T text_mentionrr5 ) rr r]r r! r' rrr6 r= ) rr% bot_usernamer expectedr$ r r r8 spanr command_textr: s && r_message_mentions_bot%TelegramAdapter._message_mentions_botscyyy113 D$/)5Q|n%4&*%9%9'%B !K""//7 )+,,[AD'DJJL,>,>,@H,L#-M' N2"6648DdD 9V C#!Dt M1hh#'#4#4[#IL#+ +005H1}i)@)F)F)H)N)N)PT\)\###&C& #F#Fw#]] ]rc<V^8dQhRR/#rdrQ)rrs"rrrs444rc \VRR4pVeVP4'dVP4'dR#\P!4pTP TP44pY0n\TRR4p\T\4'd/TPT4TPTP4R#R# \ dR#i;i)zFire a TTL-guarded identity refresh in the background when routing is about to discard a message naming other bots but not us (the symptom of a stale handle after a rename).rNrp)r]r{r r0rrrrrr5rXr[rqrr)rexistingrr.rus& r_schedule_bot_identity_recheck.TelegramAdapter._schedule_bot_identity_rechecks4!=tD  T=X=X=Z=Z  ++-D : : <=*.'$ 3T: gs # # KK   " "7?? 3 $    sC CCc&<V^8dQhRS[RS[/#rr)rrs"rrrs  7 t rc VP'gR#VP4pV'gR#VPW4p\V4;'dW#9pV'dVP 4V#)zTrue when explicit bot handles target other bots, not this one (``@bot3 hi @bot4`` must not wake ``@bot1`` via reply/wake-word fallbacks).F)rr r= rBrO )rr%rF r7 excludes_selfs&& r#_explicit_bot_mentions_exclude_self3TelegramAdapter._explicit_bot_mentions_exclude_selfs`yyy113 "&"E"Eg"\45ee,:e   / / 1rc&<V^8dQhRS[RS[/#rr)rrs"rrrs333T3rc aSP'gR#\;QJd7V3Rl\VRR4\VRR434F 'gK R# R#!V3Rl\VRR4\VRR4344#)Fc3~<"TF2q'gK SPFpVPV4xK K4 R#5irP)rr)rRr patternrs& rrTDTelegramAdapter._message_matches_mention_patterns..s?3` dm &11 NN9 % %1 &`s =,=r+Nr7T)rrr]rr%sf&r!_message_matches_mention_patterns1TelegramAdapter._message_matches_mention_patternss}%%%s3%gvt_`3ss 3s 3s3%gvt_`33 3rc&<V^8dQhRS[RS[/#rr)rrs"rrrsSSSTSrc TVP4;'dVPV4#)zMGuest-mode bypass: explicit bot mention (caller already verified group chat).)r rJ r[ s&&r_is_guest_mention!TelegramAdapter._is_guest_mentions$((*RRt/I/I'/RRrcF<V^8dQhRS[S[,RS[S[,/#rKrN )rrs"rrrs#HSMhsmrcVP4pV'd V'gV#\P!R\P!V4 R2RV4P 4pT;'gT#)z(?i)@z \b[,:\-]*\s*r!)r rUrNrr)rr+rF rVs&& r_clean_bot_trigger_text'TelegramAdapter._clean_bot_trigger_textsT113 <K&&E"))L"9!:,GTRXXZ$rc6<V^8dQhRS[RS[S[,/#)rwarn_non_numericr)rBr )rrs"rrrs   RV rc >VP4pV'dVPV4V9dR#Ve%\V4VP49dR#R#R# \\ 3d1T'gR#\ PRTPT4R#i;i)zR``allowed_topics`` / ``ignored_threads`` gates; False = blocked, None = undecided.FNz8[%s] Ignoring non-numeric Telegram message_thread_id: %r) r r rr rrr7r-r)rrxrg r s&&$ r_topic_gates_pass!TelegramAdapter._topic_gates_passs668 d77 B.X   qy>T%C%C%EE F  z* q' Y[_[d[dfop  qsAB7!BBc&<V^8dQhRS[RS[/#rr)rrs"rrrs  g $ rc \VP4;'d0VPV4;'dVPV4'*4#)zTrue when ``bots_require_mention`` vetoes this other-bot message: another bot must explicitly @mention us, its quote-replies and plain chatter do not count (two bots answering each other's replies never stop otherwise).)rBr _sender_is_other_botrJ r[ s&&r_bot_sender_suppressed&TelegramAdapter._bot_sender_suppressedsP  / / 1 8 8))'2 8 8..w77  rc&<V^8dQhRS[RS[/#rr)rrs"rrrsCCCTCrc VPV4'g.VP4'dVPV4'gR#VP\ VRR4RR7RJdR#VP V4pVP 4'dVPV4'dR#VP4pV'dW#9dR#W P49gVPV4'dR#VPV4'dR#VP4'd/VPV4'gVPV4'dR#VPV4'*#)zEReturn True when a group message should be stored but not dispatched.FrNrg T)_is_own_messager r ri r]r r rT r r r rn r r rJ r\ )rr% chat_id_strrs&& r)_should_observe_unmentioned_group_message9TelegramAdapter._should_observe_unmentioned_group_messages6    ( (0a0a0c0ckok~k~@GlHlH  ! !''3F"M`e ! fjo o''0  0 0 2 2t7_7_`g7h7h668+4 <<> >$BgBghoBpBp  & &w / /--//43H3H3Q3QUYUoUopwUxUx99'BBBrc 6\P!VRRRR7#)zFReturn a chat/topic-scoped source for observed Telegram group context.N)rkry user_id_alt) dataclassesr)rrs&&r%_telegram_group_observe_shared_source5TelegramAdapter._telegram_group_observe_shared_source7s""644UYZZrc&<V^8dQhRS[RS[/#rrrrr)rrs"rrr;sVV\VcVrcVPP;'gRpRVPP;'gT RT RVP;'gR 2#)r rP |z] r!)rrkryr+)rrrks&& r'_telegram_group_observe_attributed_text7TelegramAdapter._telegram_group_observe_attributed_text;sS,,&&33)5<<))44W5Qwis5::CSCSQSBTUUrc <V^8dQhRS[/#rr)rrs"rrr?s S S SrcVP4;'gRp\\VRR4RR4;'gRpRV RV R2#)r rNrZzIYou are handling a Telegram group chat message. - Your identity: user_id=z , @-mention name in this group=@a) - observed Telegram group context may be provided in a separate context-only block before the current message; it is not necessarily addressed to you. - Treat only the current new message as a request explicitly directed at you, and use observed context only when the current message asks for it.)r r])rrr s& r&_telegram_group_observe_channel_prompt6TelegramAdapter._telegram_group_observe_channel_prompt?s\--/<<9vt4dDANNY ((.x/OPXzZR R Src&<V^8dQhRS[RS[/#r} rI)rrs"rrrJs ll|lP\lrc FVP4'gV#\VRR4pV'dVPV4'gV#VP4pV'dVP V4V9dV#VP 4pVP 'dVP RV 2MTpVP\P8Xd\P!WR7#\P!WPV4VPVP4VR7#)z>Align triggered group turns with observed-history attribution. raw_messageNrA)channel_prompt)r+rr )r r]r r r r r message_typerr\ry rr rz r)rrr robserve_promptr s&& r)_apply_telegram_group_observe_attribution9TelegramAdapter._apply_telegram_group_observe_attributionJs@@BBLe]D9 $"5"5k"B"BL668$++K8GLDDFJOJ^J^J^E001n5EFdr   !4!4 4&&uL L"" DDUK==ellK\jl lrc&<V^8dQhRS[RS[/#)rr7r)rqr)rrs"rrr]s$$w$;$rc R\P3R\P3R\P3R\P3R\P 33Fwr#\ W4'gKVu# \P#)zUClassify a Telegram media message into a MessageType (first present attachment wins).stickerrr rl rT )rSTICKERrarbrcrdr]DOCUMENT)rr7rnmtypes&& r_media_message_type#TelegramAdapter._media_message_type]sx ++ ,w 8I8I.JWVaVgVgLh k'' (7K4E4E*FHKDs!! H ###rimager rl c&<V^8dQhRS[RS[/#)rr7rr)rrs"rrrhs#Src r"^RIHpVPV4wrErgVfR #\VRR4p^VP V4u;8d\VRR48:g RV3#RV3#VP 4GRjxL p \ V P4GRjxL 4p V'g5\PP\V RR4;'gR4pV!WWgR7GRjxL p T fR#R T 3#L}LbL \d/p \PR T\T 4R R 7RuRp ? #Rp ? ii;i5i)zDownload ``msg``'s attachment into the media cache (bounded by ``_max_doc_bytes``). Returns ``(status, cached)``: ``"none"``, ``"oversized"`` (cached = raw file_size), ``"failed"``, ``"unreadable"`` or ``"ok"``.cache_media_bytes_asyncNr% r oversizedro r!)r mime_type default_kind![Telegram] Failed to cache %s: %sTr3r)noneNr)rEN) unreadableN)ru r _observed_media_sourcer]r; get_filebytesdownload_as_bytearrayrrrv r*r7r-r,) rr7rr rr mimerr% file_objrrrs &&& r_download_observed_media(TelegramAdapter._download_observed_mediahs2 C'+'B'B3'G$$ > FK6 D%%i0eGDBRTd4ee ) )f ) ) "#__..Hx==??@D77++GHk2,N,T,TRTU24VZnnF >% %V|/?o " NN>FabeFfquN v! ! "sxA!D7$C;7C58C;C7C;%,C;C;&C9'C;+ D75C;7C;9C;; D4#D/)D4*D7/D44D7c*<V^8dQhRS[RS[RR/#rr7rrNrqr)rrs"rrrs(ssws|sPTsrc "VPVR4GRjxL wr4VR8XdR\VRR 4R ,pVPVPRV R24Vn\P RV4R#VR8Xd$VPVPR 4VnR#VR 8Xd2.Vn.VnVPW$VP4R 4R#R#L5i)zCache an unmentioned group attachment and annotate the observed text; oversized or unsupported attachments are noted in the transcript without downloading.zobserved group mediaNr rzB[Observed Telegram attachment too large or unverifiable. Maximum: z MB.]z6[Telegram] Observed group attachment skipped (size=%s)r z=[Observed Telegram attachment could not be read, not cached.]rz)[Telegram] Cached observed group %s at %srr) r r]_append_observed_noter+r7r media_urls media_types_attach_cached context_note)rr7rstatusrr4 s&&& r_cache_observed_media%TelegramAdapter._cache_observed_medias $<!E  "E    v/B/B/DFq r ZsCCCCc0<V^8dQhRS[RS[RS[RR/#)rrnotelog_fmtrNr~ )rrs"rrrs*77L77c7VZ7rc VPPVP4VPPVP4\ VP4^8Xd>VP VP9d#VPVP ,VnVPVPV4Vn \PWBP VP4R#)z_Append a cached attachment to the event (message type follows the kind only for the first one).N) r rdrr media_typer+r_CACHED_KIND_TO_MESSAGE_TYPEr r r+r7r)rrrr r s&&&&&rr TelegramAdapter._attach_cacheds  ,   !2!23 u A %&++9Z9Z*Z!%!B!B6;;!OE // DA  G[[&++6rc*<V^8dQhRS[RS[RR/#r )rr)rrs"rrrs" 9 9c 9, 94 9rc "\VRR4pVfR#VPVR4GRjxL wrEVR8Xd>VPW%RVP RVP RVP R2R 4R#R#LL5i) z:Cache media from the message this turn replies to, if any.r Nzreplied-to mediarz [Replied-to z 'z ' saved at: rm z%[Telegram] Cached replied-to %s at %s)r]r r r display_namer)rr7r reply_msgr rs&&& r_cache_replied_media$TelegramAdapter._cache_replied_mediasC!3T:   #<   fkk]"V=P=P>r !*2(4v&<DE  0E  E D E 'E?E E  E  E  E c V<V^8dQhRS[RS[RS[S[,RS[S[,RR/#)rr%msg_type update_idrrNrqrr rr)rrs"rrrsJccc*5cBJ3-c_ght_ucBFcrc  \VRR4pV'gR#\VRR4pT;'gVPWVR7pVPVPVP44pRRRVP V4R \ P!\R 7P4R R /pVP'd\VP4VR &VP4VPVPV4\P!RT\\VRR4RR4VPP";'gR4R# \$d2p TP'4\P)RYi4Rp ? R#Rp ? ii;i)zGAppend skipped group chatter to the target session without dispatching.r#Nrr<r rolerr timestamp)tzr TrzF[%s] Telegram group message observed (no bot trigger): chat=%s from=%srrZr z1[%s] Failed to observe Telegram group message: %s)r]_build_message_eventget_or_create_sessionrz rr rrDrr9rrrappend_to_transcript session_idr7rrkr*r r-) rr%r r rstore adapter_name session_entryrrs &&&&& r"_observe_unmentioned_group_message2TelegramAdapter._observe_unmentioned_group_messagesZ.5 tVZ8  c^^T66wT]6^E!778b8bchcoco8pqM 4+W+WX]+^X\\S1;;=z4QE&)%*:*:&;l#    !  & &}'?'? G KKXZf6iH%,,J^J^JkJkbk m c  ) ) + NNNP\ b b cs*EBE?BEE F &FF c&<V^8dQhRS[RS[/#rr)rrs"rrrs P Pw P4 Prc VP'gR#\VRR4pVfR#\VPRR4p\VRR4pVRJ;'dVRJ;'dW48H#)zXTrue when sent by this bot itself (echoed getUpdates must not count as incoming unread).FrNrZ)rr])rr%rr rks&& rrs TelegramAdapter._is_own_messageshyyyG[$7  D$/)T40T!OOgT&9OOf>OOrc&<V^8dQhRS[RS[/#rr)rrs"rrrsJJGJJrc \VRR4pVe\VRR4'gR#\VPRR4p\VRR4pVRJ;'gVRJ;'gWC8g#)zvTrue when the sender is a bot other than this one (this bot's own echoes are already filtered by ``_is_own_message``).rNrFrZ)r]r)rr%senderr sender_ids&& rrm $TelegramAdapter._sender_is_other_botsj+t4 >5!A!AD$/FD$/ ~IId!2IIi6IIr is_commandc,<V^8dQhRS[RS[RS[/#)rr%r rr)rrs"rrrs#%?%?w%?t%?X\%?rc 8VPV4VPV4'dR#VPV4'gR#VPV4pVP VRR7RJdR#VP V4pVP 4'dVPV4'dR#VPV4pVP4pV'd WF9dV#V'g,W@P49gVPV4'dR#VPV4'dR#VP4'dVPV4'dR#VP4'gVP!V4'dR#VP#V4#)a)Apply Telegram group trigger rules: DMs unrestricted; group messages pass ``allowed_chats`` (hard gate; only the ``guest_mode`` @mention bypass crosses it) and then any of free_response chat/topic, ``require_mention`` off, reply to the bot, @mention (incl. ``/cmd@botname``), or a wake-word match.FTrr )r rs r r ri r r rT r` r r r rn r r r rJ r\ )rr%r rxrt guest_mentionrs&&$ r_should_process_message'TelegramAdapter._should_process_messagesa //8    ( (""7++55g>  ! !)d ! Cu L''0  0 0 2 2t7_7_`g7h7h..w7 ..0 {1 K+M+M+OOSWSxSxzATBTB  & &w / /--//43H3H3Q3Q((**t/I/I'/R/R55g>>rc<V^8dQhRR/#rdrQ)rrs"rrr-s}}t}rc "VP;_uu_4GRjxL \VRR4pV'd\VRR4'gRRR4GRjxL R#\VP4pW0P9dRRR4GRjxL R#^RIHp^RIHpH p\P!WV!4R7GRjxL wrxVPV4p VPPW!VR7R 7GRjxL VPPV4\ P#R VP$\'V 4V4RRR4GRjxL R#ELAEL LLLf \(d5p \ P+R TP$\-T 44Rp ? LXRp ? ii;iLT +GRjxL 'giR#;i5i) zLazy-register bot commands for forum supergroups (topics don't inherit AllGroupChats scope; Telegram resolves via BotCommandScopeChat).NrrYF)BotCommandScopeChatrr)rrz2[%s] Lazy-registered %d commands for forum chat %sz/[%s] Forum command lazy-registration failed: %s)rr]rrZrr<r rrrr0rrrrr[r7rrr+r*r-r,) rr%rrr rrrrjrrs && r_ensure_forum_commands&TelegramAdapter._ensure_forum_commands-se#### }w574U#C#C $## dgg,<<<$##9l)0):):*9S9U*W$W #11-@ ii// DW`gDh/iii..227; PRVR[R[]`am]npwx$###$Wj }PRVR[R[]xyz]{|| }!$###sG EG F,(E( G EG %E( G  E"G -E(E$=E(?E&A E( G F*G G "G $E(&E(( F'3*F"F,"F''F,*G ,G 2F53 G >G G c6<V^8dQhRS[RS[S[,/#)rrr)ror rq)rrs"rrrCs$^^^8G;L^rc F\VRR4;'g\VRR4#)zUMessage-like payload for normal messages and channel posts (``update.channel_post``).effective_messageNr%r<rs&&r_effective_update_message)TelegramAdapter._effective_update_messageCs$v2D9]]WVYX\=]]rlevelrzunauthorized userc$<V^8dQhRS[RR/#)rrrNr)rrs"rrrGs==S=cg=rc \PVRV\\VRR4RR4\\VRR4RR44R#)z#[Telegram] Blocked %s %s in chat %srNrZr)r7logr])rr7r rs&&$$r_log_blocked_user!TelegramAdapter._log_blocked_userGsD 8$PSU`bfHgimos@t GC.d ; =rc&<V^8dQhRS[RS[/#rr r)rrB)rrs"rrrLskdrc VPV4'dR#VPV4'dVPWVPR7R#)zQGroup trigger gate; observes unmentioned chatter when configured. True = proceed.Tr F)r ru r r )rr7rr s&&&&r_gate_or_observe TelegramAdapter._gate_or_observeLsC  ' ' , ,  9 9# > >  3 3CVM]M] 3 ^rc&<V^8dQhRS[RS[/#r )rr)rrs"rrrTs EE+ER^Erc "^RIHpVPWVPR7pV!WVP4VnVP W4GRjxL VP V4#L5i)z~Event for an addressed text/command: trigger text cleaned (sole addressee only), replied-to media cached, attribution applied.group_trigger_textr N)+plugins.platforms.telegram.telegram_contextr r r r+r r )rr7rr r rs&&&& r_build_triggered_event&TelegramAdapter._build_triggered_eventTsb S))#6CSCS)T'5::> ''333==eDD 4sAA*A(A*c><V^8dQhRS[RS[PRR/#rc rd )rrs"rrr]s. c c c,B[B[ c`d crc "VPV4pV'dVP'gR#VPV4'gVPV4R#VP W1\ P 4'gR#VPVP4GRjxL TPVPW1\ P 4GRjxL 4R#L=L 5i)zHHandle incoming text; buffers client-split chunks into one MessageEvent.N) r r+rr r rr[r r%_enqueue_text_eventr )rrrr7s&&& rr]$TelegramAdapter._handle_text_message]s,,V4#((( 44S99  " "3 ' $$S+2B2BCC ))&..999   t'B'B3P[P`P`'a!ab :!as/+C"C"AC" C!2C"C  C" C"c><V^8dQhRS[RS[PRR/#rc rd )rrs"rrrks)))F)\=V=V)[_)rc 4"VPV4pV'dVP'gR#VPVRR7'gR#VPV4'gVP V4R#VP V4GRjxL VP W1\P4GRjxL p\VP;'gR4VP8dVPV4R#VPV4GRjxL R#LLbL 5i)z!Handle incoming command messages.NT)r r!) r r+r rr r r rr\r+_SPLIT_THRESHOLDr rK)rrrr7rs&&& rr^TelegramAdapter._handle_commandks,,V4#((( ++CD+AA 44S99  " "3 ' ))#...11#{?R?RSS uzzR D$9$9 9  $ $U + !!%((( /S )sL+DD D"'D D 'D1D2D=D D DDDc><V^8dQhRS[RS[PRR/#rc rd )rrs"rrr~s.YYVYlF_F_YdhYrc f"VPV4pV'gR#VPV4'gVPV4R#VPW1\P 4'gR#\ VRR4pV'd\ VRR4M \ VRR4pV'gR#\ VRR4p\ VRR4pVeVfR#R.pV'dS\ VRR4p \ VRR4p V 'dVPR V 24V 'dVPR V 24VR V 2R V 2R V RV 2R., pVPV\P VPR7p RPV4V n VPVPV 44GRjxL R#L5i)z,Handle incoming location/venue pin messages.Nvenuelocationlatitude longitudez![The user shared a location pin.]raddresszVenue: z Address: z latitude: z longitude: z5Map: https://www.google.com/maps/search/?api=1&query=rozSAsk what they'd like to find nearby (restaurants, cafes, etc.) and any preferences.r ra)r rr r rr_r]rdr r rhr+rKr ) rrrr7r r latlonr rr! rs &&& rr`(TelegramAdapter._handle_location_message~s,,V4 44S99  " "3 ' $$S+2F2FGG Wd+7<75*d3'#z[_B` h D1h T2 ;#+ 45 E7D1EeY5G wug./ y 23  +cU 37lmplqqrsvrw5x ac c))#{/C/CvO_O_)`YYu% !!$"P"PQV"WXXXs*2F1A1F1'0F1=F1BF1(F/)F1c&<V^8dQhRS[RS[/#r} r~ )rrs"rrrs..\.c.rc D<VPV4\SV` V4#)zeSession-scoped batching key; topic recovery first so DM-topic batches coalesce on the recovered lane.)_apply_topic_recoveryr_text_batch_keyrLs&&rr( TelegramAdapter._text_batch_keys! ""5)w&u--rc$<V^8dQhRS[RR/#rHrI)rrs"rrrs$rc <VP4'dVPVRR7R#\SV` V4VP 4R#)zGBuffer a text chunk, or hold it while delayed delivery must be dropped.z text-enqueuer N)rKr%rr rrLs&&rr #TelegramAdapter._enqueue_text_eventsA  - - / /  $ $U. $ A  #E* rc <<V^8dQhRS[RS[RS[RS[RS[RR/#)rrOrqrr3r!rN)r rrA)rrs"rrrs:'%'%T'%$'%S'%QV'%_b'%tx'%rc L"\P!4pVPPR/4pRp \P!V4GRjxL VP V4p V e[WJdVVP WS34VJdVP WS3R4VP V4VJdVP VR4R#R#VP VR4p V 'gVVP WS34VJdVP WS3R4VP V4VJdVP VR4R#R#VP VR4VP WS34p WxWS3&V e6V P4'g \P!V 04GRjxL VP4'dmVPW R2R7Rp VP WS34VJdVP WS3R4VP V4VJdVP VR4R#R#Ve V!V 4VPV 4GRjxL Rp TP YS34TJdTP YS3R4TP T4TJdTP TR4R#R#ELCELLa \PdT eTPY R2R7hi;i TP YS34TJdTP YS3R4TP T4TJdTP TR4ii;i5i)zShared delayed-flush body: sleep, pop, hold if teardown started, else dispatch. A cancel after the pop but before durable dispatch re-holds the event (never lose it).rNz-flushr z-flush-cancelled) r0rrrrCrrYr{rrKr%rKr6) rrOrqrr3r!log_fnr committedrownerrs &&&&&&& r_flush_bufferedTelegramAdapter._flush_buffereds++- MM,,-ErJ ! %--& & &IIcNE U%>0}}e\*l: ulD1yy~- #t$.3KKT*E*}}e\*l: ulD1yy~- #t$.) IIc4 MM5,/E&2ul # llE7+++1133((v6F(G}}e\*l: ulD1yy~- #t$.!u %%e, , ,E }}e\*l: ulD1yy~- #t$.? ', -%%  ((?O6P(Q   }}e\*l: ulD1yy~- #t$.s4L$JJJ0AL$JAL$3AJ6JJJ+JAL$ J7J8J?AL$JJJ0K  KAL!!L$c6<V^8dQhRS[S[,RS[/#)rrOr)r rrA)rrs"rrrs . .Xl-C . .rc V'd\VR^4M^pV'd!\\VRR4;'gR4M^pW P8d VP#W0P8:d!\ VP VP4#W0P8:d!\ VP VP4#VP #)uAdaptive delay: near-split-point last chunk → long delay (continuation almost certain); short/medium totals → capped fast delays; else configured cap (all min()'d with the operator cap)._last_chunk_lenr+r!) r]r+r r_TEXT_BATCH_FAST_LENrr_TEXT_BATCH_FAST_DELAY_S_TEXT_BATCH_SHORT_LEN_TEXT_BATCH_SHORT_DELAY_S)rrOlast_len total_lens&& r_text_batch_delay_for%TelegramAdapter._text_batch_delay_fors>E77$5q9!?FC4::;A ,, ,77 7 11 1t55t7T7TU U 22 2t55t7U7UV V---rc$<V^8dQhRS[RR/#)rrrNr)rrs"rrrsmm3m4mrc a"VPVPVPSVPVPP S44RV3Rl4GRjxL R#L5i)uTelegram keeps its own flush body: a cancel after the pop must HOLD the event and re-raise (PTB already acked the update; the hold queue redispatches after reconnect) rather than shield the dispatch — teardown must be able to stop a flush from reaching a torn-down session.r+cl<\PRS\VP;'gR44#)z,[Telegram] Flushing text batch %s (%d chars)r!)r7rr+r+)evrs&rr3TelegramAdapter._flush_text_batch..s*v{{#QSVX[\^\c\c\i\igiXjkrN)r2 r$r#r= r)rrs&fr_flush_text_batch!TelegramAdapter._flush_text_batchsZ""  & &(F(F  & &t'A'A'E'Ec'J KV km m msAA&A$A&c,<V^8dQhRS[RS[RS[/#)rrr7r)rrqr)rrs"rrrs'kklkkSkrc fVPV4p\VRR4pV'dV RV 2#V R2#)z1Return a batching key for Telegram photos/albums.media_group_idNz:album:z :photo-burst)_event_session_keyr])rrr7r*rH s&&& r_photo_batch_key TelegramAdapter._photo_batch_keysD--e4  &6=:H+gn%56jQ\P]]iNjjrc$<V^8dQhRS[RR/#)r batch_keyrNr)rrs"rrrszz#z$zrc a"VPVPVPSVPRV3Rl4GRjxL R#L5i)z;Send a buffered photo burst/album as a single MessageEvent.rcX<\PRS\VP44#)z3[Telegram] Flushing photo batch %s with %d image(s))r7rr+r )rB rM s&rr4TelegramAdapter._flush_photo_batch..s!v{{#XZcehikivivewxrN)r2 rrr)rrM s&fr_flush_photo_batch"TelegramAdapter._flush_photo_batchsC""  ' ')H)H)UYUtUtv} xz z zsFabcFdosN t33CI I I JsF<9E&AE&EE&F<E&EE&2E 3AE&9E":5E&/E$0*E&F<E&E& E&"E&$E&& F917F4(F+)F4.F<4F99F<c,<V^8dQhRS[RS[RS[/#)rrr+r)rrrB)rrs"rrr@s"|34rc P"W!nVPV4GRjxL R#L5i)zWReplace the event text with a user-facing note and dispatch it; returns True (handled).NT)r+rK)rrr+s&&&r_dispatch_with_text#TelegramAdapter._dispatch_with_text@s& !!%((( )s &$&c <<V^8dQhRS[RS[RS[RS[RS[RR/#)rrrr r r rN)rrr)rrs"rrrGs9###S##K#be#jn#rc\V.VnV.VnW0n\P WA4R#rP)r r r r7r)rrr r r s&&&&&r_set_cached_media!TelegramAdapter._set_cached_mediaFs( 6!F" G"rc&<V^8dQhRS[RS[/#r} )rrB)rrs"rrrMsQQ QQrc "VPpVP;'gRpV'd5\PP V4^,P 4MRpVP ;'gRP 4pV'g`V'dX\PVR4pV'g:\P!4UUu/uFwrxWbK uppPVR4pT;'gT;'g T;'gRp VP'dVPVP8dP\PRVP4VPVRVPR', R24GRjxL #V\ 9gVP#R4'dVP%4GRjxL p V P'4GRjxL p V\ 9dTM\PVR4p \)\+V 4V R 7GRjxL p TP3Y-TP#R4'dTM\4PT R4\6P8R4TP;Y4GRjxL R #V'gVVP 'dD\<P!4UUu/uFwrxWbK uppPVP R4pV'gbVP 'dP/p\>P!4FwppVPAVV4K VPVP R4pV\<9dVP%4GRjxL p V P'4GRjxL pTP3T\C\+V4VR 7GRjxL \<V,\6PDR4VPGV4GRjxL R #VP%4GRjxL p \+V P'4GRjxL 4p^RI$H%pT!TT;'gRT;'gR 2VR7GRjxL pVfVPVRV R24GRjxL #VP.Vn&VPN.Vn(R.Vn)VPTR8Xd\6PVVn,\PRVPTVPVPN4R(pV\Z9;'gT;'gRP#R4pV'd\]V4V8:d~VP_R4p\`Pb!RRT;'gRT;'gR 24pR V R!V 2pVPd'dV R"VPd 2MTVn2R .Vn)R#R#uuppiELGELELEL \,dKp\P/R \1T4R R 7TPTR T R24GRjxL uRp?#Rp?ii;iELuuppiELELELEL[ELDEL*ELEL \fdR#i;i \hd`p\P/R#\1T4R R 7TPkYR$T\mTR%R4;'gRR&7GRjxL Rp?R#Rp?ii;i5i))uCache a document attachment (image → photo path, video, else generic media + text injection). Returns True when the event was already dispatched/routed so the caller must return.r!r z'[Telegram] Document too large: %s byteszFThe document is too large or its size could not be verified. Maximum: z MB.Nimage/rrj z-[Telegram] Failed to cache image document: %sTr3zImage document 'z ' could not be read as an image.rz+[Telegram] Cached user image-document at %sz+[Telegram] Cached user video document at %sr r z.bin)r r z Document 'z' could not be cached.Frl z$[Telegram] Cached user %s at %s (%s)ztext/rz [^\w.\- ]rjz.txtz [Content of z]: rAz'[Telegram] Failed to cache document: %srr )r ri)7r r rrrrr _TELEGRAM_IMAGE_MIME_TO_EXTrrr r% rr7rrp _TELEGRAM_IMAGE_EXTENSIONSrJ r r rr rr-r,rt _TELEGRAM_IMAGE_EXT_TO_MIMErrarb rrrrrbrKru r r r r media_text_inlinedrrcr rr+r rUrNr+rA r*r r])rr7rr original_filenamer& doc_mimer r displayr image_bytes image_extrk rimage_mime_to_extrA_mime video_bytes raw_bytesr rMAX_TEXT_INJECT_BYTES_is_text text_contentr injections&&& r_cache_inbound_document'TelegramAdapter._cache_inbound_documentMsllL G # 3 3 DU"''""#45a8>>@[]C ++224H8155hC,D,J,J,LM,LDA14,LMQQRZ\^_C'GG8GGsGGiG===CMMD4G4G$G Es}}U!55cdhdwdw}HeIdJJNOPPP00H4G4G4Q4Q!$/$,$B$B$DD #&*D#DCJeJiJijrtzJ{ (DU;EW]f(g"gK&&H4G4G 556::9lS%%'T V --c9993===(=(C(C(EF(Eqt(EFJJ3==Z\]3===46!#A#G#G#IKD%%00=$J'++CMM2>++!$/$,$B$B$DD &&!=eK>PVY!ZZ\qru\vyDyJyJAC))%000!\\^+HH$B$B$DDEI F29GXGvGv^fgjgtgtntfu\vCKLLF~!55ez'Rh=ijjj & }E !'!2!2 3E (-wE ${{g%%0%6%6" KK> V[[Z`ZkZk l%/ !55]](..b9T9TU\9]HC N.CC#,#3#3G#[ [ [[c><V^8dQhRS[RS[PRR/#rc rd )rrs"rrrs)8)8)&8)">?STW?X"YFK00===77=P=P\b\l\ltz7{ ))#/G/G/LX^XhXh)i ;;; V+D7KC7PQEJ ;;;&&s2 2 2%%d&T&TUZ&[\ \ \ >>uE 999 P!$2!7!7!99$,$B$B$DD ))(*<*<>hjpq&&!=eK>PVY!ZZ^deheoeopsetdu\vx}yKyK8:--c999 999++C ?T[]cepqqqr YYY++C  3 \ :D[9 PEGbcdGeptu77GQOOO P rooL L(sc-R :R +R A1R 3P4BR R #P$'R  P (R 6$P$PP$2P3AP$;P <;P$7P!8P$<R #R 3Q:4 R >R #R 6Q=7 R R #R 9R: R R R -R. R 85R -R.R R R R R P$P$P$!P$$ Q7/7Q2&Q)'Q2,R 2Q77R =R R R R R c*<V^8dQhRS[RS[RR/#)rrH rrNrY )rrs"rrrs( u uS u uZ^ urc "VP4'dVPVRR7R#VPVPW4VP 4VP P V4pV'dVP4\P!VPV44VP V&R#5i)zDebounce album items (shared media_group_id) into one MessageEvent so the second image isn't treated as a new message interrupting the first.zmedia-group-enqueuer N) rKr%rV rrrrr|r0r_flush_media_group_event)rrH rr[ s&&& rra (TelegramAdapter._queue_media_group_events  - - / /  $ $U2G $ H    !9!9>Q ,,00@     292E2EdFcFcdrFs2t/sB?Cc$<V^8dQhRS[RR/#)rrH rNr)rrs"rrrs}}S}T}rc"VPVPVPWPR4GRjxL R#L5i)z media-groupN)r2 rrMEDIA_GROUP_WAIT_SECONDS)rrH s&&rr (TelegramAdapter._flush_media_group_events<""  $ $d&=&=~OlOln{} } }s6A?Ac*<V^8dQhRS[RS[RR/#r r )rrs"rrrs'!L!L!L!L$!Lrc "^RIHpHpHpHpHpVP pVP;'gRp VP;'gRp VP'gVP'dV!V 4Vn R#V!VP4p V 'dYV!V R,V PRV 4V PRV 44Vn \PRVP4R#V 'dRV 2MR p VP!4GRjxL p V P#4GRjxL p\%\'V4R R 7GRjxL p\PR V4^R IHpVP-4\.P0!V!WR7GRjxL 4pVPR4'd?VPRR 4pV!VPVW4GRjxL V!VW4Vn R#V!WV 4Vn R#LLLLsL, \2d;p\P5R\7T4RR7T!YT 4Tn Rp?R#Rp?ii;i5i)zjDescribe a sticker via vision, cached by file_unique_id; animated/video stickers get an emoji placeholder.)get_cached_descriptioncache_sticker_description_asyncbuild_sticker_injection build_animated_sticker_injectionSTICKER_VISION_PROMPTr!NrJr*set_namez [Telegram] Sticker cache hit: %sza sticker with emoji z a stickerrrj z"[Telegram] Analyzing sticker at %s)vision_analyze_tool)r user_promptranalysisz%[Telegram] Sticker analysis error: %sTr3)gateway.sticker_cacher r r r r r r*r is_animatedis_videor+file_unique_idrr7rr r rr tools.vision_toolsr rrrr*r-r,)rr7rr r r r r r r*r rrr r rk r rJrJrs&&& rr TelegramAdapter._handle_stickers E E++ ####))r    '"2"2"29%@EJ '(>(>? 0 1F SZ\aHbdjdndnoy|DeEFEJ KK:G > @@K    !ZZ&9K&s stFzz)$$$jj[A 5g6L6Lk[`kkk4[%R 4XhO 0@]!tl L NNBD_`aDbmqN r0(KEJJ LsAIII-(IAI6I>H HH )H*H HA H HH 4)H H H 0I2H IH H H H H I/I I IIc<V^8dQhRR/#rdrQ)rrs"rrrsZZtZrc  n^RIHpV!4PR/4PR/4PR/4PR.4pV'g.Vn\ 4VnR#W nVUu0uFpRV9gK \ VR,4kK upVnVFpVPR4pV'gKVPR.4FpVP!R 4pVP!R 4pV'gK1V'gK;V R V 2VP9gKS\V4VPV R V 2&\PR VPV R V 2V4K K R#uupi \d-p\PR TPT4Rp?R#Rp?ii;i)zURe-read dm_topics from config.yaml so externally created topics work without restart.)load_config_readonlyrr<rrNrrrxrrz8[%s] Hot-loaded DM topic from config: %s -> thread_id=%sz/[%s] Failed to reload dm_topics from config: %s)rr rrrXrrrrr7rrr*r8) rr rrcidrtidrrs & r_reload_dm_topics_from_config-TelegramAdapter._reload_dm_topics_from_configs Z >,.22;CGG TVW[[\ceghllmxz|}I)+&*-%'%. "T]&yT]jajnxax'As:i+@'AT]&yD #'  nnY/#"5A%% ,C55=Dstt3%qt(N;>s83%q8 $^`d`i`inqmrrstxsykz|A 6 ('z Z LLJDIIWX Y Y ZsPAE=E=/ E=9 E8E8A&E=E=E=*A E=8E== F4!F//F4c b<V^8dQhRS[RS[S[,RS[S[S[S[3,,/#)rrrxrr)rrs"rrr&s8#(3-HUYZ]_bZbUcLdrc aaaV'gR#\V4oRVVV3RllpV!4pVeV#SP4V!4#)zOReturn the DM topic config dict (name, skill, ...) for this thread_id, or None.Nc\V^8dQhR\\\\3,,/#rrP)rs"rr8TelegramAdapter._get_dm_topic_info..__annotate__,s  $sCx.1 rc<SPP4FwrVS8XgKVPS R24'gK*VPR^4^,pSPF\p\ VP R44S8XgK$VP R.4F"pVP !R4V8XgKVuuu# K^ RV/u# R#)rrrrN)rr rJ rrrrr)r cached_tidrrrrr thread_id_ints r_lookup3TelegramAdapter._get_dm_topic_info.._lookup,s#'??#8#8#:.3>>WIQ-3P3P!$3!21!5J&*&<&< z~~i89WD%/^^Hb%A#$55=J#>+,H&B'= #J//$;r)rr )rrrxr foundr sff& @r_get_dm_topic_info"TelegramAdapter._get_dm_topic_info&sDI      L **,yrc0<V^8dQhRS[RS[RS[RR/#)rrrxrrNr)rrs"rrr>s1rrCrCrUXr]arrc V RV 2pW@P9d<\V4VPV&\PRVPWB4R#R#)zLCache a thread_id -> topic_name mapping discovered from an incoming message.rz5[%s] Cached DM topic from message: %s -> thread_id=%sN)rrr7rr)rrrxrrs&&&& r_cache_dm_topic_from_message,TelegramAdapter._cache_dm_topic_from_message>sLiq - OO +),YDOOI & KKOQUQZQZ\e q ,rc&<V^8dQhRS[RS[/#rr)rrs"rrrFs  c c rc <aVfR#\V\4'dV#\V\4'dRPV3RlV44#\V\4'd6RF/pVP V4fKSP W,4u# R#)zFBest-effort plaintext flattener for Bot API rich-message inline nodes.r!c3F<"TFpSPV4xK R#5irP)_flatten_rich_inline_text)rRitemrs& rrT.MsQ54388>>5r:)r+children)r5rrTrhr rr )rrHrsf& rr )TelegramAdapter._flatten_rich_inline_textEs~ = eS ! !L eT " "77Q5QQ Q eT " "+99S>-88DD,rc&<V^8dQhRS[RS[/#)rblocksrr)rrs"rrrUsBB#B#Brc \V\4'gR#.pVEFMp\V\4'gKVPR4R8XdVPR.4Fp\V\4'gKVP VPR44P 4pV'gKSVPR4pTP V'dV RV^, 2P4MV^,4VPVR,4K EKVPVPR 44pV'gEK.VPVP 44EKP R PR V44#) z@Best-effort plaintext flattener for Bot API rich-message blocks.r!r'rTr r r;r] rr+rac3T"TFq'gK VP4xK R#5irP)rstriprs& rrT7TelegramAdapter._flatten_rich_blocks..ksA54D5s (() r5rTr r_flatten_rich_blocksrrdrr\r rh)rr linesrr item_linesr;r+s&& rr $TelegramAdapter._flatten_rich_blocksTs+&$''EeT**yy F*!IIgr2D%dD11 !$!9!9$((8:L!M!X!X!ZJ%  HHW-ELLuE7!JqM?!;!A!A!CR\]^R_`LLB030061BCDt T__./!"yyA5AAArc6<V^8dQhRS[RS[S[,/#)rr r)rr r)rrs"rrrns    rc (\\VRR4RR4p\V4'gR#\V!R4RR4p\V4'gR#VPV!R44P4;'gR# \dR#i;i)zAReturn plaintext echoed by Telegram's rich_message reply payload.r.Nrr?r )r]rfr rr*)rr getter rich_getters&& r_extract_rich_reply_text(TelegramAdapter._extract_rich_reply_textms W%5|TJESWXFF##!&"8%FKK((++K,ABHHJRRd R  s")B$B+B?B BBcB<V^8dQhRS[RS[RS[S[,RS[/#)rr%rX thread_id_strr)rqrr r)rrs"rrr{s1('('g('#('V^_bVc('hm('rc VPpRpRpVR8XdV'dVP\VP4V4pV'd#VP R4pVP R4p\ VR4'd`VP 'dNVP PpV'd0VP\VP4W84V'gTpWV3#VR8XEdV'Ed}VPPP R.4p \V \4'd)V P4U U u.uF wrRV R V /NK p p p MB\V \4'd+V U u.uFp \V \4'gKV NK p p M.p V Fp\VP RR 44\VP48wdK8VP R .4p \V \4'dT M.Ffp\V\4'gKVP R 4pVfK2\V4V8XgKDVP R4pVP R4pM WV3# WV3#uup p iuup i) zVReturn ``(chat_topic, topic_skill)`` for a DM topic or bound forum topic (else Nones).Nr[rskillforum_topic_createdrf group_topicsrrr!rx)rr rrZrr)r rr rrr5r r rT)rr%rXr r chat_topic topic_skill topic_info created_namegroup_topics_config cfg_chat_idrgroup_topics_iterrrrr s&&&& r_resolve_topic_binding&TelegramAdapter._resolve_topic_binding{s8||   00TWW}MJ'^^F3 (nnW5 w 5667;V;V;V&::?? 55c$''lM`%%1 0&&/' !mm#'++"3"3"7"7"K -t44k~lElElG%HlGTgT_ih%OlG!%H!/668K$g8KuzZ_aeOfUU8K!$g!$&!/ z~~i45TWWE#"5(264(@(@fbHE%eT22 ))K0C3s8}+D%*YYv%6 &+ii&8 I&&0&&%%H$gsI32I9I9c&<V^8dQhRS[RS[/#r)rqr)rrs"rrrs**g*%*rc 2VP'gR#\VPP4p\VRR4pVe\VRR4MRpV'dW$3#VPP;'g!VPP ;'gRpV'gVP VP4pV'g:^RIHpVP\VPP4V4pW%3#W%3# \dRpY%3#i;i)z``(reply_to_id, reply_to_text)`` for the replied-to message: Telegram's native partial quote first, then text/caption, rich echo, then the sent index.Nquoter+r!r[ ) r rrr]r+r7r r#r"lookuprrZr*)rr%r r quote_text reply_to_textr"s&& r_reply_contextTelegramAdapter._reply_contexts''' '22==> $/5:5FWUFD1D * *0055aa9Q9Q9Y9Yaa]a  99':R:RSM %3 / 6 6s7<rfr]>r[r)rrr r _adopt_created_topic_threadr r)rrrrrZrrBr]r ru r r r rrrr_edit_revisiondate)rr%r r rrtelegram_chat_typerXr r r has_full_nameryrr r r r r r s&&&& rr $TelegramAdapter._build_message_events||  !00615LLG`rv`S\FJ 99'B 88][ "&"="=gR_"` k2 I yD0I&/9&< $I""LDJJ,e,e]4>>`dqz%)S\ M^@^DGG dhZ\_`g`r`r\s;?4h67U #L &*%8%8%A" AU477| / 0A0A=C`C`T`rbnFJK%g.Xbi7--.9 +U`0O--gAW\\ [ [rcF<V^8dQhRS[S[,RS[S[,/#)rr r)r rr)rrs"rrrs' W W8C= WXc] Wrc X\VRR4p\VR4'gR#VeRV 2#\VRR4;'g\VRR4;'gRP4p\VP 44 R\ P !V4P4R , 2#) aIdentity of one edit of a message, None for a new send. ``edit_date`` has whole-second resolution, so two edits in one second would share it: the update id is unique per edit and stable on redelivery; without one, the edited text tells same-second edits apart.r8Nr ur+r7r!r :NN)r]r)rrr rrr)r%r r8r+s&& rr TelegramAdapter._edit_revisions G[$7 y+..  yk? ".YY''9d2SYYWYaaci))+,-Qw~~d/C/M/M/OPS/T.UVVrc <V^8dQhRS[/#rr.)rrs"rrrs C CD Crc \VPPRRR4pVfR#\V4P 4R9#)unReactions: scoped ``TELEGRAM_REACTIONS`` → ``extra.reactions`` (YAML, per profile) → off. An explicit env var wins over YAML, so the stock ``reactions: false`` every install materializes cannot silently kill a documented ``TELEGRAM_REACTIONS=true`` (#109032). Under multiplex a scoped miss falls to the profile's own YAML, never another profile's env (#72348). reactionsTELEGRAM_REACTIONSNF>rrr)rv rrrrrYs& r_reactions_enabled"TelegramAdapter._reactions_enabledsB&dkk&7&7FZ\`a  :$$&.BBBrcB<V^8dQhRS[RS[RS[S[,RS[/#)rrrr*rrl)rrs"rrrs/  3 C QT Z^ rc "VP'gR#VPP\V4\V4VR7GRjxL R#L \dfpTf,\ P RTP\T44M+\ P RTPT\T44Rp?R#Rp?ii;i5i)z`Set a single emoji reaction (``None`` clears all bot-set reactions, the documented Bot API way).F)rrr/NTz[%s] clear reactions failed: %sz)[%s] set_message_reaction failed (%s): %s) rset_message_reactionrrr*r7r8rr,)rrrr*rs&&&& r _set_reactionTelegramAdapter._set_reactionsyyy ))009ST[9\ilmwixDI0J J J J } > KfghKij H$))UZ\wxy\z{  sAC3A A ACA CAB?9C?CCc,<V^8dQhRS[RS[RS[/#rr')rrs"rrrs'CCcCsCtCrc B"VPWR4GRjxL #L5i)zClear all bot-set reactions.N)r)rrrs&&&r_clear_reactions TelegramAdapter._clear_reactionss''TBBBBs c$<V^8dQhRS[RR/#rHrI)rrs"rrrsHH|HHrc "VP4'gR#\VPRR4p\VRR4pV'd'V'dVPW#R4GRjxL R#R#R#L 5i)z;Add an in-progress reaction when message processing begins.Nrru👀)r r]rr)rrrrs&& ron_processing_start#TelegramAdapter.on_processing_starts\&&(( %,, 48UL$7 z$$W,G G G"7 GsA A1A1$A/% A1c*<V^8dQhRS[RS[RR/#)rrrrN)rr)rrs"rrr"s) B B, BIZ B_c Brc t"VP4'gR#\VPRR4p\VRR4pV'd V'gR#V\P8XdVP W44GRjxL R#TP Y4V\P8XdRMR4GRjxL R#L9L5i)uSwap the in-progress reaction for a final success/failure reaction (set_message_reaction replaces, not adds); CANCELLED explicitly clears the 👀.Nrru👍u👎)r r]rr CANCELLEDrrSUCCESS)rrrrrs&&& ron_processing_complete&TelegramAdapter.on_processing_complete"s&&(( %,, 48UL$7 J  '11 1''< < <$$W'UfUnUnJn,uAB B B = Bs*A B8+B8:B4;2B8-B6.B86B8c><V^8dQh/S[;R&S[;R&S[;R&#)rREQUIRES_EDIT_FINALIZEFALLBACK_ON_FINAL_EDIT_FLOOD%RESEND_FINAL_ON_EMPTY_STREAM_FALLBACKr.)rrs"rrrs,:!';<#'-=>,06?r)Rrrrar rrrrr r rrrlrrrrrrrrrrrrrrrrrrrrrr rrrrrrrrrrrrrrrrrrrrrrrrrrr rrrrrrrrrrrrQrrrrrrrrr[ )NNNrPr)r!r!Nr: )Nr)NNNN)r!(r(rrrrvrrsupports_code_blockssplits_long_messagesrr r HELD_INBOUND_MAXrrArBr$ r r rr r!r7 r8 r9 r: staticmethodrpropertyrrrrrr!r*r4r=rGrKrUr`rhrvrrrrrr classmethodrrrrrrrrrr rrrr,r6rDrQr[r`rhrsr|rrrrrrrUcompiler5DOTALLrrrrrrrrrrrrrrrrr rrrr%r:r2r4rHrLrSr[rWrXrwrrrrrrrrrrrrrrrrr%r)rrGr<rNr>r=rdrrprrrrrrrrrrrrrrrrr r#rrrr rKrRrsr|rrrrrr rrrr*r0rr8r@rrLrUrdrvr{r|rrrrrrrrrrrrrrrrr!r&r2r9rNrOr=rB_EA_REASON_BUDGETrGrRr\rnryrrrrrrrr rrrrrr r r$ rr/ r4 r9 r= rQ rY rX r` rkr| r rjr r r r r r r r r r/ r6 r; r? rD rJ rQ rd r\ r r r r rx r r r r r r r%asynccontextmanagerrMr^rrrrmr1 rrb rx r r r r r r r r r r r r r r rr r r r r r/ rr r;r r rr r r r! r' r= r& rJ rO rT r\ r` rd ri rn ru rz r r r r rrarbrcr r r r r r r r r rs rm r r r r WARNINGr r r r]r^r`r( r r2 r= rD rJ rQ rV r\ rb rf rl rp rt r rhra r r r r r r r r r r r r r rrrr__annotate_func__rrr)rrs@@rrzrzsV#"""#" $-! $()- 26)#  $VZy} AAL;L;\AA 11 %% v vGG *FF .. 6<<#8<#Y]##'#DH##JEE<D(BBee$4E4ElAA??__SSDDrr#Q#Q#QJ]]BB 55 88LrvLL>DD(DD0cc::  **"mm   22;;WW zz"BBMMTVT]T]D]^!zz N  !  # ::xyLttCC$CC + +00__,, MMYY SX % %<<II * *ccwVZww(h(hT ??.00*AA0##J(( FF44 F88 2$$af$$"&$$$$L99& kk&SS VVll65.]]8<uz<<|22 &PPF0F0PRYRYh@L@LDDD66@--:==']']R,\6\6|))  D55&&P r r%j%jN"x"xH o o__KK>ttt CCC //0aa> kMMM  >  B""  ,, %%ll2III*[N[Nz=?=?~  ((:DD:aEaaF     ** &u&uP299""BBBBH   +++"  ffP%4%4NVV2)~)~V##&FF2bf$zz,cg8CC  A?OTA?{A?A?F\\&&P.nsw.n.n`">>)A)AV4 G  GAE G GS-1SDHS_cSS*EEE M M VVVM!N LLLUUU""77~~~dd"MM$&//&//0dd550LLLnnnBBVV6^^$ (OOO GGRR" 4 4N!N!`IIccc BB ,W,W\GGG4CG*<*QVW)r44"  33SS    CC4[VV S Sll&$$%,[->->IZIZ\cepevev#w .ss$77 9 9 " "=== >cc0 P PJJ%?e%?%?N}},^^=goo=K^== EE c c))&YYF.. '%'%R . .mmkk zz K K m mPP4 ### QQf8)8)t u u}}!L!LFZZ00rr   BBB0   ('('T**6*[*[X W W W C C  CCHH B ByPrrzc$V^8dQhR\/#rr)rs"rrr;sSrcT\P!RR4pV'gM^RIHp^RIHpV!V!4RRRR4pVR 9d(\ V4P4P4pT;'gR pVR 9d\PR V4R pV# \dL:i;i) zfNotification mode (all/important) from env, else config.yaml display.platforms.telegram.notifications.HERMES_TELEGRAM_NOTIFICATIONSr!)load_gateway_config)cfg_getr rr< notificationsrz[Unknown telegram notifications mode '%s', defaulting to 'important' (valid: all, important)>Nr!>rEr) rrgateway.configr1 gateway.runr2rrrr*r7r-)rFr1r2_raws r_resolve_notifications_moder7;s 994b 9D   : +.0)[*VefD:%4y(..0   ;D ''tvz{ K    sA B B'&B'cn\V4p\4VnV# \d RTnT#i;i)z:Construct TelegramAdapter and apply the notification mode.r)rzr7r r*)rrs& r_build_adapterr9NsAf%G2&A&C# N 2&1# N2s 44c$V^8dQhR\/#rr.)rs"rrrXs$$T$rc\VRR4pV'g"^RIHpVPR4;'gRp\ \ V4P 44#)zConnected when a bot token is configured (env or PlatformConfig.token); the SDK being importable is not enough or the plugin-enable pass would enable Telegram on any machine with it installed.rNTELEGRAM_BOT_TOKENr!)r]hermes_cli.gatewayr# get_env_valuerBrr)rr gateway_mods& r _is_connectedr@XsI FGT *E 0))*>?EE2 E   " ##rrx media_filesforce_documentc "\VRR4pV'g^RIHpV!RR4;'gRp\\VR/4;'dVPP R44p^RIHp V !WaW$VWR 7GRjxL #L5i) zOut-of-process delivery (standalone_sender_fn) so deliver=telegram cron jobs succeed without the gateway; delegates to the REST ``_send_telegram`` sender.rN) get_secretr<r!rr)_send_telegram)rArxrrB)r]agent.secret_scoperDrBrrtools.send_message_toolrE) pconfigrr%rxrArBrrDrrEs &&&$$$ r_standalone_sendrIbs GWd +E 1/4:: '2!>!m!m7==CTCTUlCmn6 I3T TT Ts+BB 5B?BBcV^8dQhRR/#rdrQ)rs"rrrps&&4&rc<^RIHp\P!4R#)zTConfigure Telegram credentials and allowlist via the CLI setup wizard (lazy import).)setupN) hermes_clirLr_setup_telegram) _setup_mods rinteractive_setuprPps.##%rcJV^8dQhR\R\R\R,/#)ryaml_cfg telegram_cfgrNr)rs"rrrvs*JJJTJdTkJrcaaa^RIp^RIHp/oV!4oRVVV3RllpRR/RVV3RlllpRF%pVS9gK SPVSV,4K' SP R VP R 44pVe!S!R \ V4P 44R S9d S!R VPSR ,44RF wrV!W4K RF wrp V!WSP V4V R 7K" V!RR4RS9dXSPR\ SR,4P44S!R\ SR,4P44\SP R4\4'dSP R4M/p RS9d SR,MV P R4p V e)S!RV RJdRM\ V 4P 44V!RRSP R44T!RRSP R4;'gV P R44T!RRSP R4;'gV P R44RF%p V S9gK SPV SV ,4K' 0R mpV P4F wppW9gKSPVV4K" S;'gR#)!aETranslate config.yaml telegram: keys into TELEGRAM_* env vars and PlatformConfig.extra. Env vars take precedence over YAML. Returns extras to merge into PlatformConfig.extra, or None. Implements the apply_yaml_config_fn contract (#24849). Mirrors the legacy telegram_cfg block from gateway/config.py::load_gateway_config(). N)yaml_env_setterc4V^8dQhR\R\RR/#)rrr rNr)rs"rr(_apply_yaml_config..__annotate__s!::3:S:T:rc<VS9dCSPVSV,4S!V\SV,4P44R#R#rP)rrr)rr _set_envextrasrSs&&r _bridge_lower)_apply_yaml_config.._bridge_lowersB ,    c<#4 5 S#l3/0668 9 r seed_extraFc LV^8dQhR\R\R\R\RR/#)rrr rHr]rN)rrrB)rs"rrrWs0#CDUYrcV<VfR#V'dSPW4S!W4R#)uZCSV allowlist gate: list → comma-joined; env write skipped under multiplex secret scope.N)r)rr rHr]rYrZs&&&$r _bridge_gate(_apply_yaml_config.._bridge_gates$ =     c )rr r r r )r]rrrrrrTELEGRAM_REPLY_TO_MODErrrnrrr r)disable_topic_auto_renamedm_topic_auto_transfer))r r ) allow_botsTELEGRAM_ALLOW_BOTS)r r )r r )r r ))r r T)r r F)r r F)r r F)r r T)r rr r > dm_policyr group_policy reply_prefixrchannel_promptsnotice_deliveryreply_in_threadr allow_admin_fromchannel_skill_bindingsrgateway_restart_notification) rgateway.platforms._sharedrUrrrrdumpsrr5r r )rRrS_jsonrUr[r` _topic_key _effective_rmrr seed_telegram_extra _telegram_rtm_key_GENERIC_MERGE_KEYS_k_vrYrZs&f @@r_apply_yaml_configr|vs9F H:: 5N  %   j,z*B CN!$$%6 EV8WXM +S-?-E-E-GH\),ekk,GY:Z.[\H c H?$ S|//4F ? +34l"+s< +D'E'K'K'MN!3|K'@#A#G#G#IJ3=l>N>Nw>WY]3^3^l&&w/dfO5D 5TL1ZiZmZmn}Z~M )MU4J5PSTaPbPhPhPjk79I9I,9WX#%C\EUEUVhEiFUFUm|nAnABTnUV=./]]?3F3FG\3]_v <    dL$6 7v 9"'')B (   b" %* >>TrcV^8dQhRR/#rdrQ)rs"rrrsTrc d^RIHp^RIHp^RIHpVP !R'RRRRR\R \/VB/R \bR \bR R .bR\R4bR\bR\bRRbR\bRRbRRbRRbRVbRRbRRR R!R"/bR#\bR$VP bR%VP"bBVP$BR&#)(u:Plugin entry point — called by the Hermes plugin system.) PLATFORM_HINT)DASHBOARD_CARD) gateway_envrr<r;r adapter_factorycheck_fnensure_deps_fn is_connected required_envr< install_hintzplatform.telegram.install_hintsetup_fnapply_yaml_config_fncron_deliver_env_varTELEGRAM_HOME_CHANNELstandalone_sender_fnmax_message_lengthr|r*u✈️allow_update_commandT platform_hint display_tierhighdisplay_overrides tool_progressrbusy_ack_detailFtarget_ref_syntax_fn env_overridesenv_enable_credentialsNrQ) adapter_hintrdashboard_cardrr!rregister_platformr9r1rIr@rrPr|rIr ENV_OVERRIDESENV_ENABLE_CREDENTIALSAUTHZ)ctxrrrs& rregisterrs,+.   ) ;I Ti   3 BO _s]s 78 DU l~ Ul  .  CG  OW  nr  $  +E3DeL / "//  +AA FQEVEV rclV^8dQh/^\9d \\\,,;R&#)rr)__conditional_annotations__rr r)rs"rrrs'iijqpZ 6pkjr>rrrrr)rrvr0r%ry rrrr rhtmlrrUr} contextvarsrrrrr" rrrr r r r r rMr getLoggerr(r7agent.deadlineragent.ssl_verifyrrprr~ rrv rrrrqr,r9rKrbrmr<rorprqrrrsrtrD telegram.extrurvrwrxryrCrzr{r|telegram.constantsr}r~telegram.requestrr0rrpathlibr_Pathrinsertr__file__r parentsgateway.authz_mixinr agent.i18nrrr4rrru rrrrrrrrrrrrrrrrrrrr gateway.platforms.eventrrr,plugins.platforms.telegram.telegram_entitiesr0plugins.platforms.telegram.telegram_held_inboundr'plugins.platforms.telegram.telegram_idsrrr2plugins.platforms.telegram.telegram_topic_transferrr+plugins.platforms.telegram.telegram_networkrrrrr1plugins.platforms.telegram.telegram_topic_routingrutilsrrrz r]r rry r{ rr rr,r1rIr(rMrPrWrZr[gateway.platforms.helpersr\rr]r^rd re rbrjr$r7rrrar9rhr]rVrC r3rNrrrtrxrzr7r9r@rIrPr|rr)rs@rrsi   ",,PPP&   8 $,1 +Y-1@Jim0 wV*%YY"/,,,7- !3uX..088;<=1&3 !$H + @;WFj9zzOeht:>>>>9x$L %s60L?K>$L> L L L  L5MM