# Copyright (c) 2026 Krzysztof Rudnicki. MIT licence. """The bot object itself: the command wiring and the two loops it owns. Split out of app.py, which had grown to the 250-line cap with the ASGI entrypoint, the object graph and the startup sequence all in one file. This half is "what the bot does"; startup.py is "how it comes up". """ from __future__ import annotations import datetime as dt import logging from dataclasses import dataclass from typing import TYPE_CHECKING from signal_bot.animals import register_animal_commands from signal_bot.announce import announce_all from signal_bot.changelog import load as load_changelog from signal_bot.counting import format_tally from signal_bot.decorators import cooldown from signal_bot.dispatcher import Dispatcher from signal_bot.http_client import ImageFetcher from signal_bot.registry import CommandRegistry from signal_bot.versioning import POPE, __version__ if TYPE_CHECKING: import httpx from signal_bot.config import Config from signal_bot.discovery import GroupDirectory from signal_bot.liveness import Liveness from signal_bot.store import Store from signal_bot.transport_base import Transport logger = logging.getLogger(__name__) COOLDOWN_MESSAGE = "BEEP BOOP POCZEKAJ {seconds} SEKUND." def now_local() -> dt.datetime: """Current local time, timezone-aware.""" return dt.datetime.now().astimezone() @dataclass class Bot: """The wired-up bot and its two long-running loops.""" config: Config store: Store transport: Transport directory: GroupDirectory dispatcher: Dispatcher liveness: Liveness async def publish_report(self) -> None: """Post each group's own tally into that group, and reset it. Each group is isolated on purpose. One group refusing the report -- the bot removed from it, a transient send failure -- must not cost every other group its report, and a tally is cleared only after its report has actually gone out, so a failed send loses nothing. A group where nobody spoke is skipped entirely. """ for group_id in self.directory.groups: rows = [(t.display_name or t.uuid, t.count) for t in self.store.tallies(group_id)] if not rows: # Logged, not posted. The bot is in every group it was ever # added to, so posting "nobody spoke" would mean a nightly # ping into every quiet group, forever. logger.info("no messages in %s today; not posting a report", group_id) continue try: await self.transport.send_text(format_tally(rows), group_id) except Exception: logger.exception("daily report failed for group %s", group_id) continue self.store.reset_tallies(group_id) async def announce_release(self) -> None: """Tell every watched group about a version it has not seen yet.""" await announce_all( self.transport, self.store, list(self.directory.groups), load_changelog(), __version__, POPE.name, ) async def listen(self) -> None: """Consume frames forever, handing each to the dispatcher.""" async for frame in self.transport.receive(): # Every frame counts, including receipts and typing indicators: # the question this answers is "can anything still reach us?", # not "did anybody address the bot?". self.liveness.note_envelope() await self.dispatcher.handle(frame) def build_bot( config: Config, client: httpx.AsyncClient, store: Store, transport: Transport, directory: GroupDirectory, liveness: Liveness, ) -> Bot: """Assemble the object graph from its injected dependencies.""" registry = CommandRegistry() register_animal_commands( registry, ImageFetcher(client), decorate=cooldown(config.cooldown_seconds, COOLDOWN_MESSAGE), endpoints=config.image_api_urls, ) dispatcher = Dispatcher( config=config, directory=directory, registry=registry, store=store, transport=transport, clock=now_local, ) return Bot( config=config, store=store, transport=transport, directory=directory, dispatcher=dispatcher, liveness=liveness, )