KILLER-тул: дайджест непрочитанного.

T9: iter_dialogs → топ-N чатов с unread_count>0 → подтянуть per_chat последних сообщений. Чтение НЕ помечает прочитанным (mark_read не зовём). Ограничивать (FloodWait). read-only.

Выбор топа: сортируем чаты по unread_count по убыванию — наверх всплывает самый большой бэклог (что больше всего пропустил). Сообщения внутри чата — newest-first (как отдаёт iter_messages), не помечаем прочитанным.

Скачать вложение из конкретного сообщения на диск (локально).

T11: get_messages(entity, ids=message_id) → message.download_media(dest). Точечно, не «все фото». read-only (download_*).

Найти чат ПОИСКОМ (не перебором диалогов): серверный contacts.Search.

contacts.SearchRequest отдаёт РАНЖИРОВАННЫЕ совпадения в my_results (свои контакты/чаты — релевантнее) и results (глобальные публичные); users/chats — лишь пул сущностей для резолва. Берём именно my_results→results, а НЕ весь пул (иначе глобальный шум). Fallback на локальный фильтр диалогов — TODO, только если тест покажет дыру по приватным группам (docs/decisions.md). read-only.

Последние сообщения чата (chat = id/username/ссылка/название → resolve).

T6: iter_messages(entity, limit) → {id, date, sender, text}. read-only.

Список диалогов с непрочитанным: title, type, unread_count, последнее сообщение.

T5: iter_dialogs(limit, archived) → chat_brief(...). read-only.

Текущий аккаунт: id, имя, username. T12: get_me(). read-only.

Участники чата/группы. T12: iter_participants(entity, limit). read-only.

Закреплённые сообщения чата. T12: get_pinned / iter_messages(pinned). read-only.

Точный resolve чата/юзера по username/ссылке/id/точному имени.

T10: resolve_entity(ref) → chat_brief. read-only.

Если не найдено — исключение Telethon (ValueError/UsernameNotOccupiedError и т.п.) пробрасывается наверх, оунер обрабатывает его на интеграции.

Поиск сообщений ВНУТРИ чата по тексту.

T7: iter_messages(entity, search=query, limit). read-only.