Make images required for Thumbnail

examples/message-extensions/src/cards.py

@@ -151,6 +151,12 @@ async def create_dummy_cards(search_query: str) -> List[Dict[str, Any]]:
             "thumbnail": {
                 "title": item["title"],
                 "text": item["description"],
+                "images": [
+                    {
+                        "alt": "Mario PNG",
+                        "url": "https://us-prod.asyncgw.teams.microsoft.com/urlp/v1/url/content?url=https%3a%2f%2ftse1.mm.bing.net%2fth%2fid%2fOIP.0PJdFY9vGiLB0l2ApUUraQHaJP%3fpid%3dApi%26w%3d85%26h%3d85%26c%3d7",
+                    }
+                ],
             },
         }
         cards.append(card_data)

examples/message-extensions/src/main.py

@@ -8,6 +8,13 @@
 from pathlib import Path
 from typing import cast
 
+from cards import (
+    create_card,
+    create_conversation_members_card,
+    create_dummy_cards,
+    create_link_unfurl_card,
+    create_message_details_card,
+)
 from microsoft.teams.api import (
     AdaptiveCardAttachment,
     ConfigFetchInvokeActivity,
@@ -41,17 +48,10 @@
     MessagingExtensionSuggestedAction,
     TaskModuleContinueResponse,
 )
+from microsoft.teams.api.models.card.thumbnail_card import ThumbnailCard
 from microsoft.teams.apps import ActivityContext, App
 from typing_extensions import Any, Dict
 
-from .cards import (
-    create_card,
-    create_conversation_members_card,
-    create_dummy_cards,
-    create_link_unfurl_card,
-    create_message_details_card,
-)
-
 app = App()
 
 
@@ -150,7 +150,9 @@ async def handle_message_ext_query(ctx: ActivityContext[MessageExtensionQueryInv
         attachments: list[MessagingExtensionAttachment] = []
         for card_data in cards:
             main_attachment = card_attachment(AdaptiveCardAttachment(content=card_data["card"]))
-            preview_attachment = card_attachment(ThumbnailCardAttachment(content=card_data["thumbnail"]))
+            preview_attachment = card_attachment(
+                ThumbnailCardAttachment(content=ThumbnailCard(**card_data["thumbnail"]))
+            )
 
             attachment = MessagingExtensionAttachment(
                 content_type=main_attachment.content_type, content=main_attachment.content, preview=preview_attachment
@@ -159,7 +161,7 @@ async def handle_message_ext_query(ctx: ActivityContext[MessageExtensionQueryInv
 
         result = MessagingExtensionResult(
             type=MessagingExtensionResultType.RESULT,
-            attachment_layout=MessagingExtensionAttachmentLayout.LIST,
+            attachment_layout=MessagingExtensionAttachmentLayout.GRID,
             attachments=attachments,
         )
 

packages/api/src/microsoft/teams/api/models/attachment/card_attachment.py

@@ -23,42 +23,42 @@ class CardAttachmentData(CustomBaseModel):
 
 
 class AdaptiveCardAttachment(CardAttachmentData):
-    content_type: Literal["application/vnd.microsoft.card.adaptive"] = "application/vnd.microsoft.card.adaptive"  #
+    content_type: Literal["application/vnd.microsoft.card.adaptive"] = "application/vnd.microsoft.card.adaptive"
     content: AdaptiveCard
 
 
 class AnimationCardAttachment(CardAttachmentData):
-    content_type: Literal["application/vnd.microsoft.card.animation"] = "application/vnd.microsoft.card.animation"  #
+    content_type: Literal["application/vnd.microsoft.card.animation"] = "application/vnd.microsoft.card.animation"
     content: AnimationCard
 
 
 class AudioCardAttachment(CardAttachmentData):
-    content_type: Literal["application/vnd.microsoft.card.audio"] = "application/vnd.microsoft.card.audio"  #
+    content_type: Literal["application/vnd.microsoft.card.audio"] = "application/vnd.microsoft.card.audio"
     content: AudioCard
 
 
 class HeroCardAttachment(CardAttachmentData):
-    content_type: Literal["application/vnd.microsoft.card.hero"] = "application/vnd.microsoft.card.hero"  #
+    content_type: Literal["application/vnd.microsoft.card.hero"] = "application/vnd.microsoft.card.hero"
     content: HeroCard
 
 
 class OAuthCardAttachment(CardAttachmentData):
-    content_type: Literal["application/vnd.microsoft.card.oauth"] = "application/vnd.microsoft.card.oauth"  #
+    content_type: Literal["application/vnd.microsoft.card.oauth"] = "application/vnd.microsoft.card.oauth"
     content: OAuthCard
 
 
 class SigninCardAttachment(CardAttachmentData):
-    content_type: Literal["application/vnd.microsoft.card.signin"] = "application/vnd.microsoft.card.signin"  #
+    content_type: Literal["application/vnd.microsoft.card.signin"] = "application/vnd.microsoft.card.signin"
     content: SignInCard
 
 
 class ThumbnailCardAttachment(CardAttachmentData):
-    content_type: Literal["application/vnd.microsoft.card.thumbnail"] = "application/vnd.microsoft.card.thumbnail"  #
+    content_type: Literal["application/vnd.microsoft.card.thumbnail"] = "application/vnd.microsoft.card.thumbnail"
     content: ThumbnailCard
 
 
 class VideoCardAttachment(CardAttachmentData):
-    content_type: Literal["application/vnd.microsoft.card.video"] = "application/vnd.microsoft.card.video"  #
+    content_type: Literal["application/vnd.microsoft.card.video"] = "application/vnd.microsoft.card.video"
     content: VideoCard
 
 

packages/api/src/microsoft/teams/api/models/card/thumbnail_card.py

@@ -3,6 +3,11 @@
 Licensed under the MIT License.
 """
 
+from typing import List, Optional
+
+from microsoft.teams.api.models.card.card_image import CardImage
+from pydantic import Field
+
 from .basic_card import BasicCard
 
 
@@ -14,4 +19,7 @@ class ThumbnailCard(BasicCard):
     meant to display cards with a single, small thumbnail image.
     """
 
-    pass
+    # Override parent's default to force explicit choice - users must intentionally
+    # provide images=None or images=[...] rather than relying on implicit default
+    images: Optional[List[CardImage]] = Field(...)  # pyright: ignore[reportGeneralTypeIssues]
+    "Array of thumbnail images for the card (must be explicitly provided)"