List your Telegram dialogs (chats, groups, channels). Returns chat ID, title, type, and username. Use this to find the chat_id needed for other tools.

Search for a specific chat by name, username, or ID. Returns the matching chat info or null if not found.

Fetch messages from a Telegram chat. Returns message text, sender, date, and media info. Does NOT download media files — use telegram_sync_chat for that. Useful for previewing chat contents before a full sync.

Full sync: downloads all messages and media files from a chat to local storage. Supports incremental sync — on subsequent runs, only fetches new messages. Files are saved to data/raw/{chat_id}/. This is the main tool for extracting chat data including photos and documents. Use since_date to limit the sync range, or omit for full/incremental sync.

Download media from a specific message. Use this for targeted downloads instead of a full sync. Returns file path and metadata.

Check the sync status for a chat: last sync date, total synced messages, last message ID. Useful before deciding whether to run a new sync.

List all media files that have been downloaded for a chat. Requires a previous telegram_sync_chat run. Filter by type: photo, document, video, voice, or all.