feat(messages): inline-button support (buttons/click) and live latest

[zhiyue]

What

Adds three messages subcommands, built on grammers' raw API, so tgcli can drive bots that reply with inline keyboards (e.g. search bots that send a file when you tap a result):

Command	Purpose
messages buttons --chat <id> --message <id>	List a message's inline keyboard — index, kind, callback data (base64) / url — read live via Message::reply_markup().
messages click --chat <id> --message <id> --button <idx>	Press a callback button via messages.getBotCallbackAnswer. Select by --button <index> or raw --data <base64>. With --wait <secs> / --download [--dest <path>] it polls for the bot's follow-up message and downloads its media.
messages latest --chat <id> --limit <n>	Fetch the newest messages straight from Telegram, bypassing the local DB — a live view without a prior sync.

Why

grammers exposes received buttons through Message::reply_markup() but has no high-level "click"; the actual press needs the raw messages.getBotCallbackAnswer. This wires that up so the CLI can complete flows like search bot → pick a result → receive the file that previously required the official app.

Notes

• Bots that do heavy work (fetching a file) often don't answer the callback within Telegram's window, surfacing BOT_RESPONSE_TIMEOUT. tgcli treats this as delivered and still waits for the follow-up message when --wait/--download is set.
• New code is isolated in src/app/buttons.rs; the only change to existing code is making App::resolve_peer_ref pub(crate) plus the command wiring and README docs.
• cargo build, cargo build --release, and cargo fmt are all clean.

Verification

End-to-end against a live search bot: /s <book> → messages latest (get the results message id) → messages buttons → messages click the preview button → messages buttons → messages click the download button with --download → file auto-downloaded and verified (valid EPUB).

https://claude.ai/code/session_016T92jG6xyYALWQfuaUaB82

[Copilot]

Pull request overview

Adds new tgcli messages functionality to support bot inline keyboards (list buttons, click callback buttons, and fetch latest messages directly from Telegram) using grammers raw TL API where needed.

Changes:

• Introduces messages buttons, messages click, and messages latest CLI subcommands and wires them into command dispatch/output formatting.
• Adds src/app/buttons.rs implementing inline keyboard extraction, callback “click” via messages.getBotCallbackAnswer, optional polling for follow-up messages, and optional media downloading.
• Exposes App::resolve_peer_ref as pub(crate) so the new app module can resolve chat peers for raw API calls.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
src/cmd/messages.rs	Adds new subcommands and human/JSON output for buttons/click/latest.
src/app/send.rs	Makes resolve_peer_ref pub(crate) for cross-module reuse.
src/app/mod.rs	Registers the new buttons app module.
src/app/buttons.rs	Implements button listing, callback clicking, follow-up polling, and download integration.
README.md	Documents the new inline button/bot workflow commands.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[zhiyue]

Thanks for the review! Pushed c2df11d addressing all five comments:

• buttons: print the base64 callback payload (copy-pasteable into messages click --data), appending the decoded text when printable.
• click: fetch the origin message up front (validates msg_id even on the --data path) and capture its sender.
• wait_for_new_messages: keep only follow-ups from the origin sender, so other users' messages in a group aren't mistaken for the bot's reply.
• poll window: 10 → 50 per poll to avoid missing follow-ups.
• dedup: extracted a shared App::fetch_message_by_id, reused by download_media and the button commands.

cargo build, cargo clippy, and cargo fmt are clean. Verified end-to-end against a search bot (search → list buttons → click → auto-download).