refactor: no comments left - one-line module docstrings, contracts on public fields only; jobs/job.py; example config and README

2026-09-02 00:33:04 +02:00
parent 90d0fb0f00
commit c9c2e94954
65 changed files with 795 additions and 1891 deletions
@@ -1,13 +1,8 @@
-"""One ``sendMessageDraft`` stream per running turn (§3.8).
+"""One ``sendMessageDraft`` stream per running turn.

-The client folds a draft into the message that follows only when their
-texts are identical - so the last push is the final text itself, rendered
-exactly as the outbox will send it, with no status line.
-
-A draft is ephemeral and lives 30 s, Telegram throttles edits to about one
-per second per chat, and thinking or a tool call would otherwise look like a
-hang - so the draft opens with a status line straight away, is refreshed on
-a timer rather than on every delta, and is kept alive while nothing changes.
+Telegram folds a draft into the following message only when their texts are
+identical, so the last push is the final text verbatim. Drafts live 30s and
+throttle to about one edit/s, so this refreshes on a timer, not every delta.
 """

 from __future__ import annotations