Args:
    label: chat label/folder - "inbox", "archive", "all","favourite", "unread" (default "inbox")
    sort_by: Sort order - "latest_message", "last_active" or "name" (default "latest_message")
    limit: Maximum number of chats to return (default 25)
    recent_messages_limit: Number of recent messages to include per chat (default 3, set to 0 to disable)
    max_participants: Maximum number of participant names to list for group chats (default 5)
    include_low_priority: Whether to include low priority chats in archive/all views (default False)

Returns:
    List of Chat objects with metadata including platform, truncated recent
    messages for context, participants, timestamps etc.

Args:
    chat_id: ID of the chat/conversation
    limit: Maximum number of messages to return (default 50)
    before: Optional ISO-8601 timestamp to get messages before this date
    after: Optional ISO-8601 timestamp to get messages after this date

Returns:
    List of Message objects with metadata including platform, sender names, timestamps, reactions etc.

Args:
    query: Text to search for across message contents
    chat_id: Optional chat ID to limit search to specific chat
    limit: Maximum number of results to return (default 25)
    include_context: Whether to include messages before and after matches (default True)

Returns:
    List of ChatSearchResult objects with message, chat info, and context

Args:
    query: Chat name or partial name to search for
    label: Filter results by chat type: 'inbox', 'archive', 'favourite', 'all' (default 'all')
    limit: Maximum number of results to return (default 25)

Returns:
    List of Chat objects matching the search criteria

Args:
    person_name: Name of the person to search for
    limit: Maximum number of messages per chat (default 50)
    platform: Filter by platform ("WhatsApp", "Telegram", etc.)
    chat_type: Filter by chat type ("dm", "group", or "all")
    days_back: Only include messages from the last N days
    include_context: Include surrounding messages for context

Returns:
    List of ChatSearchResult objects, each containing a chat and the person's messages in that chat

Args:
    attachment_uri: URI from Message.attachments (e.g., "beeper://attachment/{message_id}/{attachment_index}")
    optimize_for_context: For images, resize to ≤1568px max dimension for cost efficiency (default True)

Returns:
    For images: {"type": "image", "mime_type": "image/jpeg", "base64": "..."}
    For audio: {"type": "audio", "mime_type": "audio/mpeg", "base64": "..."}
    For files/videos: {"type": "file"|"video", "mime_type": "...", "filepath": "/path/to/file"}
    For errors: {"error": "description", "uri": "original_uri"}