microsoft-agents-activity 0.4.0.dev1__py3-none-any.whl → 0.4.0.dev4__py3-none-any.whl

microsoft_agents/activity/__init__.py

@@ -24,32 +24,32 @@ from .conversation_reference import ConversationReference
 from .conversation_resource_response import ConversationResourceResponse
 from .conversations_result import ConversationsResult
 from .expected_replies import ExpectedReplies
-from .entity import Entity
-from .ai_entity import (
+from .entity import (
+    Entity,
     AIEntity,
     ClientCitation,
     ClientCitationAppearance,
     ClientCitationImage,
     ClientCitationIconName,
+    Mention,
     SensitivityUsageInfo,
     SensitivityPattern,
-    add_ai_to_activity,
+    GeoCoordinates,
+    Place,
+    Thing,
 )
 from .error import Error
 from .error_response import ErrorResponse
 from .fact import Fact
-from .geo_coordinates import GeoCoordinates
 from .hero_card import HeroCard
 from .inner_http_error import InnerHttpError
 from .invoke_response import InvokeResponse
 from .media_card import MediaCard
 from .media_event_value import MediaEventValue
 from .media_url import MediaUrl
-from .mention import Mention
 from .message_reaction import MessageReaction
 from .oauth_card import OAuthCard
 from .paged_members_result import PagedMembersResult
-from .place import Place
 from .receipt_card import ReceiptCard
 from .receipt_item import ReceiptItem
 from .resource_response import ResourceResponse
@@ -57,7 +57,6 @@ from .semantic_action import SemanticAction
 from .signin_card import SigninCard
 from .suggested_actions import SuggestedActions
 from .text_highlight import TextHighlight
-from .thing import Thing
 from .thumbnail_card import ThumbnailCard
 from .thumbnail_url import ThumbnailUrl
 from .token_exchange_invoke_request import TokenExchangeInvokeRequest
@@ -92,7 +91,6 @@ from .caller_id_constants import CallerIdConstants
 from .conversation_update_types import ConversationUpdateTypes
 from .message_update_types import MessageUpdateTypes
 
-
 from .channel_adapter_protocol import ChannelAdapterProtocol
 from .turn_context_protocol import TurnContextProtocol
 from ._load_configuration import load_configuration_from_env
@@ -131,7 +129,6 @@ __all__ = [
     "ClientCitationIconName",
     "SensitivityUsageInfo",
     "SensitivityPattern",
-    "add_ai_to_activity",
     "Error",
     "ErrorResponse",
     "Fact",

microsoft_agents/activity/_model_utils.py

@@ -0,0 +1,61 @@
+from abc import ABC
+from typing import Any, Callable
+
+from .agents_model import AgentsModel
+
+
+class ModelFieldHelper(ABC):
+    """Base class for model field processing prior to initialization of an AgentsModel"""
+
+    def process(self, key: str) -> dict[str, Any]:
+        """Takes the key in the destination object and returns a dictionary of new fields to add"""
+        raise NotImplementedError()
+
+
+class SkipIf(ModelFieldHelper):
+    """Skip if the value meets the given condition."""
+
+    def __init__(self, value, skip_condition: Callable[[Any], bool]):
+        self.value = value
+        self._skip_condition = skip_condition
+
+    def process(self, key: str) -> dict[str, Any]:
+        if self._skip_condition(self.value):
+            return {}
+        return {key: self.value}
+
+
+class SkipNone(SkipIf):
+    """Skip if the value is None."""
+
+    def __init__(self, value):
+        super().__init__(value, lambda v: v is None)
+
+
+def pick_model_dict(**kwargs):
+    """Processes a list of keyword arguments, using ModelFieldHelper subclasses to determine which fields to include in the final model.
+
+    This function is useful for dynamically constructing models based on varying input data.
+
+    Usage:
+        activity_dict = pick_model_dict(type="message", id="123", text=SkipNone(text_variable))
+        activity = Activity.model_validate(activity_dict)
+    """
+
+    model_dict = {}
+    for key, value in kwargs.items():
+        if not isinstance(value, ModelFieldHelper):
+            model_dict[key] = value
+        else:
+            model_dict.update(value.process(key))
+
+    return model_dict
+
+
+def pick_model(model_class: type[AgentsModel], **kwargs) -> AgentsModel:
+    """Picks model fields from the given keyword arguments.
+
+    Usage:
+        activity = pick_model(Activity, type="message", id="123", text=SkipNone(text_variable))
+    """
+    return model_class(**pick_model_dict(**kwargs))

microsoft_agents/activity/activity.py

@@ -5,16 +5,22 @@ from pydantic import Field, SerializeAsAny
 from .activity_types import ActivityTypes
 from .channel_account import ChannelAccount
 from .conversation_account import ConversationAccount
-from .mention import Mention
 from .message_reaction import MessageReaction
 from .resource_response import ResourceResponse
 from .suggested_actions import SuggestedActions
 from .attachment import Attachment
-from .entity import Entity
+from .entity import (
+    Entity,
+    Mention,
+    AIEntity,
+    ClientCitation,
+    SensitivityUsageInfo,
+)
 from .conversation_reference import ConversationReference
 from .text_highlight import TextHighlight
 from .semantic_action import SemanticAction
 from .agents_model import AgentsModel
+from ._model_utils import pick_model, SkipNone
 from ._type_aliases import NonEmptyString
 
 
@@ -390,32 +396,31 @@ class Activity(AgentsModel):
         .. remarks::
             The new activity sets up routing information based on this activity.
         """
-        return Activity(
+        return pick_model(
+            Activity,
             type=ActivityTypes.message,
             timestamp=datetime.now(timezone.utc),
-            from_property=ChannelAccount(
-                id=self.recipient.id if self.recipient else None,
-                name=self.recipient.name if self.recipient else None,
+            from_property=SkipNone(
+                ChannelAccount.pick_properties(self.recipient, ["id", "name"])
             ),
-            recipient=ChannelAccount(
-                id=self.from_property.id if self.from_property else None,
-                name=self.from_property.name if self.from_property else None,
+            recipient=SkipNone(
+                ChannelAccount.pick_properties(self.from_property, ["id", "name"])
             ),
             reply_to_id=(
-                self.id
+                SkipNone(self.id)
                 if type != ActivityTypes.conversation_update
                 or self.channel_id not in ["directline", "webchat"]
                 else None
             ),
             service_url=self.service_url,
             channel_id=self.channel_id,
-            conversation=ConversationAccount(
-                is_group=self.conversation.is_group,
-                id=self.conversation.id,
-                name=self.conversation.name,
+            conversation=SkipNone(
+                ConversationAccount.pick_properties(
+                    self.conversation, ["is_group", "id", "name"]
+                )
             ),
             text=text if text else "",
-            locale=locale if locale else self.locale,
+            locale=locale if locale else SkipNone(self.locale),
             attachments=[],
             entities=[],
         )
@@ -423,6 +428,7 @@ class Activity(AgentsModel):
     def create_trace(
         self, name: str, value: object = None, value_type: str = None, label: str = None
     ):
+        # robrandao: TODO -> needs to handle Nones like create_reply
         """
         Creates a new trace activity based on this activity.
 
@@ -434,42 +440,42 @@ class Activity(AgentsModel):
         :returns: The new trace activity.
         """
         if not value_type and value:
-            value_type = type(value)
+            value_type = type(value).__name__
 
-        return Activity(
+        return pick_model(
+            Activity,
             type=ActivityTypes.trace,
             timestamp=datetime.now(timezone.utc),
-            from_property=ChannelAccount(
-                id=self.recipient.id if self.recipient else None,
-                name=self.recipient.name if self.recipient else None,
+            from_property=SkipNone(
+                ChannelAccount.pick_properties(self.recipient, ["id", "name"])
             ),
-            recipient=ChannelAccount(
-                id=self.from_property.id if self.from_property else None,
-                name=self.from_property.name if self.from_property else None,
+            recipient=SkipNone(
+                ChannelAccount.pick_properties(self.from_property, ["id", "name"])
             ),
             reply_to_id=(
-                self.id
+                SkipNone(self.id)  # preserve unset
                 if type != ActivityTypes.conversation_update
                 or self.channel_id not in ["directline", "webchat"]
                 else None
             ),
             service_url=self.service_url,
             channel_id=self.channel_id,
-            conversation=ConversationAccount(
-                is_group=self.conversation.is_group,
-                id=self.conversation.id,
-                name=self.conversation.name,
+            conversation=SkipNone(
+                ConversationAccount.pick_properties(
+                    self.conversation, ["is_group", "id", "name"]
+                )
             ),
-            name=name,
-            label=label,
-            value_type=value_type,
-            value=value,
+            name=SkipNone(name),
+            label=SkipNone(label),
+            value_type=SkipNone(value_type),
+            value=SkipNone(value),
         ).as_trace_activity()
 
     @staticmethod
     def create_trace_activity(
         name: str, value: object = None, value_type: str = None, label: str = None
     ):
+        # robrandao: TODO -> SkipNone
         """
         Creates an instance of the :class:`Activity` class as a TraceActivity object.
 
@@ -481,14 +487,15 @@ class Activity(AgentsModel):
         :returns: The new trace activity.
         """
         if not value_type and value:
-            value_type = type(value)
+            value_type = type(value).__name__
 
-        return Activity(
+        return pick_model(
+            Activity,
             type=ActivityTypes.trace,
             name=name,
-            label=label,
-            value_type=value_type,
-            value=value,
+            label=SkipNone(label),
+            value_type=SkipNone(value_type),
+            value=SkipNone(value),
         )
 
     @staticmethod
@@ -506,10 +513,10 @@ class Activity(AgentsModel):
 
         :returns: A conversation reference for the conversation that contains this activity.
         """
-
-        return ConversationReference(
+        return pick_model(
+            ConversationReference,
             activity_id=(
-                self.id
+                SkipNone(self.id)
                 if self.type != ActivityTypes.conversation_update
                 or self.channel_id not in ["directline", "webchat"]
                 else None
@@ -532,8 +539,9 @@ class Activity(AgentsModel):
             This method is defined on the :class:`Activity` class, but is only intended for use with a message activity,
             where the activity Activity.Type is set to ActivityTypes.Message.
         """
-        _list = self.entities
-        return [x for x in _list if str(x.type).lower() == "mention"]
+        if not self.entities:
+            return []
+        return [x for x in self.entities if x.type.lower() == "mention"]
 
     def get_reply_conversation_reference(
         self, reply: ResourceResponse
@@ -596,7 +604,7 @@ class Activity(AgentsModel):
         if self.type is None:
             return False
 
-        type_attribute = str(self.type).lower()
+        type_attribute = f"ActivityTypes.{str(self.type)}".lower()
         activity_type = str(activity_type).lower()
 
         result = type_attribute.startswith(activity_type)
@@ -611,3 +619,32 @@ class Activity(AgentsModel):
                 )
 
         return result
+
+    def add_ai_metadata(
+        self,
+        citations: Optional[list[ClientCitation]] = None,
+        usage_info: Optional[SensitivityUsageInfo] = None,
+    ) -> None:
+        """
+        Adds AI entity to an activity to indicate AI-generated content.
+
+        Args:
+            activity: The activity to modify
+            citations: Optional list of citations
+            usage_info: Optional sensitivity usage information
+        """
+        if citations:
+            ai_entity = AIEntity(
+                type="https://schema.org/Message",
+                schema_type="Message",
+                context="https://schema.org",
+                id="",
+                additional_type=["AIGeneratedContent"],
+                citation=citations,
+                usage_info=usage_info,
+            )
+
+            if self.entities is None:
+                self.entities = []
+
+            self.entities.append(ai_entity)

microsoft_agents/activity/agents_model.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from pydantic import BaseModel, ConfigDict
 from pydantic.alias_generators import to_camel
 
@@ -16,3 +18,29 @@ class AgentsModel(BaseModel):
 
         return {k: v for k, v in self if k not in omit_if_empty and v is not None}
     """
+
+    @classmethod
+    def pick_properties(cls, original: AgentsModel, fields_to_copy=None, **kwargs):
+        """Picks properties from the original model and returns a new instance (of a possibly different AgentsModel) with those properties.
+
+        This method preserves unset values.
+
+        args:
+            original: The original model instance to copy properties from. If None, returns None.
+            fields_to_copy: The specific fields to copy. If None, all fields are copied.
+            **kwargs: Additional fields to include in the new instance.
+        """
+        if not original:
+            return None
+
+        if fields_to_copy is None:
+            fields_to_copy = original.model_fields_set
+        else:
+            fields_to_copy = original.model_fields_set & set(fields_to_copy)
+
+        dest = {}
+        for field in fields_to_copy:
+            dest[field] = getattr(original, field)
+
+        dest.update(kwargs)
+        return cls.model_validate(dest)

microsoft_agents/activity/animation_card.py

@@ -42,7 +42,7 @@ class AnimationCard(AgentsModel):
 
     title: NonEmptyString = None
     subtitle: NonEmptyString = None
-    text: NonEmptyString = None
+    text: str = None
     image: ThumbnailUrl = None
     media: list[MediaUrl] = None
     buttons: list[CardAction] = None

microsoft_agents/activity/audio_card.py

@@ -42,7 +42,7 @@ class AudioCard(AgentsModel):
 
     title: NonEmptyString = None
     subtitle: NonEmptyString = None
-    text: NonEmptyString = None
+    text: str = None
     image: ThumbnailUrl = None
     media: list[MediaUrl] = None
     buttons: list[CardAction] = None

microsoft_agents/activity/basic_card.py

@@ -24,7 +24,7 @@ class BasicCard(AgentsModel):
 
     title: NonEmptyString = None
     subtitle: NonEmptyString = None
-    text: NonEmptyString = None
+    text: str = None
     images: list[CardImage] = None
     buttons: list[CardAction] = None
     tap: CardAction = None

microsoft_agents/activity/entity/__init__.py

@@ -0,0 +1,29 @@
+from .mention import Mention
+from .entity import Entity
+from .ai_entity import (
+    ClientCitation,
+    ClientCitationAppearance,
+    ClientCitationImage,
+    ClientCitationIconName,
+    AIEntity,
+    SensitivityPattern,
+    SensitivityUsageInfo,
+)
+from .geo_coordinates import GeoCoordinates
+from .place import Place
+from .thing import Thing
+
+__all__ = [
+    "Entity",
+    "AIEntity",
+    "ClientCitation",
+    "ClientCitationAppearance",
+    "ClientCitationImage",
+    "ClientCitationIconName",
+    "Mention",
+    "SensitivityUsageInfo",
+    "SensitivityPattern",
+    "GeoCoordinates",
+    "Place",
+    "Thing",
+]

microsoft_agents/activity/{ai_entity.py → entity/ai_entity.py}

@@ -5,8 +5,7 @@ from enum import Enum
 from typing import List, Optional, Union, Literal
 from dataclasses import dataclass
 
-from .agents_model import AgentsModel
-from .activity import Activity
+from ..agents_model import AgentsModel
 from .entity import Entity
 
 
@@ -110,33 +109,3 @@ class AIEntity(Entity):
     def __post_init__(self):
         if self.additional_type is None:
             self.additional_type = ["AIGeneratedContent"]
-
-
-def add_ai_to_activity(
-    activity: Activity,
-    citations: Optional[List[ClientCitation]] = None,
-    usage_info: Optional[SensitivityUsageInfo] = None,
-) -> None:
-    """
-    Adds AI entity to an activity to indicate AI-generated content.
-
-    Args:
-        activity: The activity to modify
-        citations: Optional list of citations
-        usage_info: Optional sensitivity usage information
-    """
-    if citations:
-        ai_entity = AIEntity(
-            type="https://schema.org/Message",
-            schema_type="Message",
-            context="https://schema.org",
-            id="",
-            additional_type=["AIGeneratedContent"],
-            citation=citations,
-            usage_info=usage_info,
-        )
-
-        if activity.entities is None:
-            activity.entities = []
-
-        activity.entities.append(ai_entity)

microsoft_agents/activity/{entity.py → entity/entity.py}

@@ -1,9 +1,11 @@
 from typing import Any, Optional
+from enum import Enum
 
 from pydantic import model_serializer, model_validator
-from .agents_model import AgentsModel, ConfigDict
 from pydantic.alias_generators import to_camel, to_snake
-from ._type_aliases import NonEmptyString
+
+from ..agents_model import AgentsModel, ConfigDict
+from .._type_aliases import NonEmptyString
 
 
 class Entity(AgentsModel):
@@ -15,7 +17,7 @@ class Entity(AgentsModel):
 
     model_config = ConfigDict(extra="allow")
 
-    type: NonEmptyString
+    type: str
 
     @property
     def additional_properties(self) -> dict[str, Any]:

microsoft_agents/activity/{geo_coordinates.py → entity/geo_coordinates.py}

@@ -1,5 +1,5 @@
-from .agents_model import AgentsModel
-from ._type_aliases import NonEmptyString
+from ..agents_model import AgentsModel
+from .._type_aliases import NonEmptyString
 
 
 class GeoCoordinates(AgentsModel):

microsoft_agents/activity/{mention.py → entity/mention.py}

@@ -1,6 +1,8 @@
-from .channel_account import ChannelAccount
+from typing import Literal
+
+from ..channel_account import ChannelAccount
 from .entity import Entity
-from ._type_aliases import NonEmptyString
+from .._type_aliases import NonEmptyString
 
 
 class Mention(Entity):
@@ -15,5 +17,5 @@ class Mention(Entity):
     """
 
     mentioned: ChannelAccount = None
-    text: NonEmptyString = None
-    type: NonEmptyString = None
+    text: str = None
+    type: Literal["mention"] = "mention"

microsoft_agents/activity/{place.py → entity/place.py}

@@ -1,5 +1,5 @@
-from .agents_model import AgentsModel
-from ._type_aliases import NonEmptyString
+from ..agents_model import AgentsModel
+from .._type_aliases import NonEmptyString
 
 
 class Place(AgentsModel):

microsoft_agents/activity/{thing.py → entity/thing.py}

@@ -1,5 +1,5 @@
-from .agents_model import AgentsModel
-from ._type_aliases import NonEmptyString
+from ..agents_model import AgentsModel
+from .._type_aliases import NonEmptyString
 
 
 class Thing(AgentsModel):

microsoft_agents/activity/hero_card.py

@@ -24,7 +24,7 @@ class HeroCard(AgentsModel):
 
     title: NonEmptyString = None
     subtitle: NonEmptyString = None
-    text: NonEmptyString = None
+    text: str = None
     images: list[CardImage] = None
     buttons: list[CardAction] = None
     tap: CardAction = None

microsoft_agents/activity/media_card.py

@@ -42,7 +42,7 @@ class MediaCard(AgentsModel):
 
     title: NonEmptyString = None
     subtitle: NonEmptyString = None
-    text: NonEmptyString = None
+    text: str = None
     image: ThumbnailUrl = None
     media: list[MediaUrl] = None
     buttons: list[CardAction] = None

microsoft_agents/activity/oauth_card.py

@@ -17,7 +17,7 @@ class OAuthCard(AgentsModel):
     :type buttons: list[~microsoft_agents.activity.CardAction]
     """
 
-    text: NonEmptyString = None
+    text: str = None
     connection_name: NonEmptyString = None
     buttons: list[CardAction] = None
     token_exchange_resource: Optional[TokenExchangeResource] = None

microsoft_agents/activity/receipt_item.py

@@ -28,7 +28,7 @@ class ReceiptItem(AgentsModel):
 
     title: NonEmptyString = None
     subtitle: NonEmptyString = None
-    text: NonEmptyString = None
+    text: str = None
     image: CardImage = None
     price: NonEmptyString = None
     quantity: NonEmptyString = None

microsoft_agents/activity/signin_card.py

@@ -12,5 +12,5 @@ class SigninCard(AgentsModel):
     :type buttons: list[~microsoft_agents.activity.CardAction]
     """
 
-    text: NonEmptyString = None
+    text: str = None
     buttons: list[CardAction] = None

microsoft_agents/activity/text_highlight.py

@@ -12,5 +12,5 @@ class TextHighlight(AgentsModel):
     :type occurrence: int
     """
 
-    text: NonEmptyString
+    text: str
     occurrence: int

microsoft_agents/activity/thumbnail_card.py

@@ -24,7 +24,7 @@ class ThumbnailCard(AgentsModel):
 
     title: NonEmptyString = None
     subtitle: NonEmptyString = None
-    text: NonEmptyString = None
+    text: str = None
     images: list[CardImage] = None
     buttons: list[CardAction] = None
     tap: CardAction = None

microsoft_agents/activity/video_card.py

@@ -42,7 +42,7 @@ class VideoCard(AgentsModel):
 
     title: NonEmptyString = None
     subtitle: NonEmptyString = None
-    text: NonEmptyString = None
+    text: str = None
     image: ThumbnailUrl = None
     media: list[MediaUrl] = None
     buttons: list[CardAction] = None

{microsoft_agents_activity-0.4.0.dev1.dist-info → microsoft_agents_activity-0.4.0.dev4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-activity
-Version: 0.4.0.dev1
+Version: 0.4.0.dev4
 Summary: A protocol library for Microsoft Agents
 Author: Microsoft Corporation
 Project-URL: Homepage, https://github.com/microsoft/Agents

{microsoft_agents_activity-0.4.0.dev1.dist-info → microsoft_agents_activity-0.4.0.dev4.dist-info}/RECORD

@@ -1,24 +1,24 @@
-microsoft_agents/activity/__init__.py,sha256=9p3zp5KHhxRPHblwZ8WPGhTJst4YzYy-qQxLJEK0qWI,6115
+microsoft_agents/activity/__init__.py,sha256=07QcOO-VhyFua5npkmn19vKzB_cPBixxSFDaDpYgUZA,5978
 microsoft_agents/activity/_load_configuration.py,sha256=Sepf-xe0pD_xuDwZEFmAEchMJURqIXmL2az78LIJLyw,833
+microsoft_agents/activity/_model_utils.py,sha256=2y6TedLAIFGuaj-VWMZgiFHYt39Df10ed5j3aOAPLps,1909
 microsoft_agents/activity/_type_aliases.py,sha256=7kkx_rIxA1B-z2T6HU6OMBm5lgD1t6KGNznJzAX-VgE,135
 microsoft_agents/activity/action_types.py,sha256=DY0RkEFquJ_SjMKJvHsD5Ring4j_HPrchEvIsFunIfI,324
-microsoft_agents/activity/activity.py,sha256=GQoF55LlwjtdjEHqcBWgzEGo3Jvzfeh7ea5k5frN-lc,26148
+microsoft_agents/activity/activity.py,sha256=ZDG9cdDC0EO2ZuARH0JHRFh2X4Da13c5c9LMLdU7tWw,27258
 microsoft_agents/activity/activity_event_names.py,sha256=3X5u4xppN86wY-KpBAwRr4sfYB3-V4MSlB5SsrcI7l0,159
 microsoft_agents/activity/activity_importance.py,sha256=kdwdcVa9fsCEk5hvxOsGhqsE4uu7gpTYKtACEgmva0A,117
 microsoft_agents/activity/activity_types.py,sha256=a9XvGgWsFI1Rur4JC-n5YIDpdSooxqaMNna3VS1CW1s,667
 microsoft_agents/activity/adaptive_card_invoke_action.py,sha256=X4weYdv8uzeNyBPpeTYD4631O19aaQdvvyrYi5PUJdU,779
 microsoft_agents/activity/adaptive_card_invoke_response.py,sha256=lWlB9bL6I7F1Sr2-xV1XFq6ddB2UGi8GRCOOt4kyffs,640
 microsoft_agents/activity/adaptive_card_invoke_value.py,sha256=9AWQF2maf48GMAoWRgljquMZHZX1r_y3wqULprygJKI,995
-microsoft_agents/activity/agents_model.py,sha256=h7GVx8NWVXjYs6ARUn3kZ_Km4Xbsn3qw27Ygq6zzrZs,474
-microsoft_agents/activity/ai_entity.py,sha256=oKWQhmA9WkKhgMRf7wQTvxDTVBLqiMtO5FiZjISau00,4160
-microsoft_agents/activity/animation_card.py,sha256=ZnXiX5TXj32TS5lDXjZ5TrnYzHnPTVr2Tz3TYyjUlTQ,2005
+microsoft_agents/activity/agents_model.py,sha256=3v3UOdEvNEGOyYPgk-3IP6cgtHdoYfeK_9x0VVrG6l4,1490
+microsoft_agents/activity/animation_card.py,sha256=Cqpuni9t19PIroPYiLiTSsaS_3o8tUOwTc_98bkuzv0,1994
 microsoft_agents/activity/attachment.py,sha256=Z2FtaHURYHPRDMdVWgeaxMlFENBMHCBCUKoRGEc2bVY,727
 microsoft_agents/activity/attachment_data.py,sha256=qY7Ue3IPWq45mFhFrDqUPa_PBqLHYGGCcrAdKHVnXHM,576
 microsoft_agents/activity/attachment_info.py,sha256=qrQPNYc5cFdaUMCcaBynhLNVTQGAMFD-pZbUIOcfAa0,536
 microsoft_agents/activity/attachment_layout_types.py,sha256=iXmEtlV-arcXmdZ2anlJVFs4Jjd7QHF2IHS4OfblpYI,108
 microsoft_agents/activity/attachment_view.py,sha256=-rIphRFMJ_DnARoX2WhL6OeKPciDSd4zvwQjLWAbchM,345
-microsoft_agents/activity/audio_card.py,sha256=9padrG8lx4_uKc7HAYvZAEQ88c-1hld5BMcjVHIpD60,1964
-microsoft_agents/activity/basic_card.py,sha256=D7w4yt6Wk4YE7P5_ZJcd35BIrk37eSaAjvD7msILyNw,967
+microsoft_agents/activity/audio_card.py,sha256=85s0iGSU4qXYHPU58qRPihhCmQIcbrifWs_PLjuJU6s,1953
+microsoft_agents/activity/basic_card.py,sha256=dLIGAPrxSwEqCo2tHLhX85Nm61aR5xowYnaPxrAn82k,956
 microsoft_agents/activity/caller_id_constants.py,sha256=9VhHXo0XyTkknm6NTSGpHOLEMZQp7d3A5B5DOX5L0Kk,220
 microsoft_agents/activity/card_action.py,sha256=uVlxGFNE7H-ZIjE2YYESuuMDy24mp7MCvenhp83_xII,1414
 microsoft_agents/activity/card_image.py,sha256=yYyo8RBG3z1Heoorj3zEG32oMkLV_mzJWDJetRnszSg,545
@@ -35,41 +35,36 @@ microsoft_agents/activity/conversation_update_types.py,sha256=VEUqDxPcohg68El9RO
 microsoft_agents/activity/conversations_result.py,sha256=3D0dqPBAfo9ZUmpP1bCTEROh8aLF3kqBxvDON7HWNd4,522
 microsoft_agents/activity/delivery_modes.py,sha256=kwSrdeVxevLEG7lzn8MfRPAO8hQQgbPYqz7kdPWbHjI,199
 microsoft_agents/activity/end_of_conversation_codes.py,sha256=NJBRgjwHkzbJvmTSGgy-RnjbBlWDIHmZ9dhN118BGDc,301
-microsoft_agents/activity/entity.py,sha256=b_WPdzJg55n0qiz9cpfml-aEs-f_95VBNb-ihV9Ne6I,1071
 microsoft_agents/activity/error.py,sha256=N5DsUr9RYXj0HOu2h89RkNasbSrtvBL-hS9-oKrxt3o,551
 microsoft_agents/activity/error_response.py,sha256=XbCk_B347r69uD2QPkW_1Ld42_yBZMmEZoAF8rWr99o,244
 microsoft_agents/activity/expected_replies.py,sha256=FbJ0yoXhn2XvQ-PN4vo60O_knte-1R2bBPFQy49jZtM,343
 microsoft_agents/activity/fact.py,sha256=ljgtTptRLpPiBubCrc29SdiTFEQXJvOK4LHRz4CcIlc,549
-microsoft_agents/activity/geo_coordinates.py,sha256=Qq63l_AWH1t8BphN5rdYWlsK0qsXL6VyMlevYum-D64,889
-microsoft_agents/activity/hero_card.py,sha256=KNCT3p9jr-tK_zlczPFwKZbpfEFDE-rmjA-PBs7v6Ik,999
+microsoft_agents/activity/hero_card.py,sha256=XawZNJMVSJwJMjbQBV8onYdHshw9kewLNEU3LgLTaZo,988
 microsoft_agents/activity/inner_http_error.py,sha256=1hcteIiy3LsXTtVT3pD4-83s7sichQsfkV4LaQ0-QhM,333
 microsoft_agents/activity/input_hints.py,sha256=14us7b1Km-uApAQUpjC5VYnm12QaD-NhpwBQZwwRg0o,263
 microsoft_agents/activity/installation_update_action_types.py,sha256=Ge-4MqT_TG6JFG5yMR9a_CK3pA5q81_g8GyKM2TWKNE,110
 microsoft_agents/activity/invoke_response.py,sha256=Unn1fMk2rW-EJx7rvYOFqdBqWnPvD8W5sPRkhqNDG-I,861
-microsoft_agents/activity/media_card.py,sha256=JKAQu_awjfJTlbpi-nrja_FV7LBEIDZswbsHX3u1t50,1964
+microsoft_agents/activity/media_card.py,sha256=AvW7B5Xp6VaXLNF3Dq-ld4SHd4ZcHJHnLqBeaEFYUGo,1953
 microsoft_agents/activity/media_event_value.py,sha256=8GUi5uofatEavSuWEMo6sydlOD9_ntd5XDmmQT-hwLM,314
 microsoft_agents/activity/media_url.py,sha256=tui_uIU93lwLefb7xeRArwvE410w__hFllgi-uLnB8A,401
-microsoft_agents/activity/mention.py,sha256=MMcsFWHV8w8L478L-7iOswP5uXXliUnhnXC8k7X14HA,576
 microsoft_agents/activity/message_reaction.py,sha256=wIfLWZl-LstuVMKqmzPagOi6LhsGsUu8Tlcf75-CgAs,344
 microsoft_agents/activity/message_reaction_types.py,sha256=cAdeuthZmDLu-DZ2IRnuVDFC_ldTSBPjwDRuuSZfcGs,219
 microsoft_agents/activity/message_update_types.py,sha256=LTIXbGk3NVmraRDPRokdxxD81f-tyg_n7KuNCmX4vcA,181
-microsoft_agents/activity/oauth_card.py,sha256=cNMlVJ_s3rZry5bZ1Fwv42SpouHRYyrwCFrb7jxatiA,868
+microsoft_agents/activity/oauth_card.py,sha256=4ZLUIEQ-9GFRXAruxNCglRdPyungRrlPg8EdXyl-xWU,857
 microsoft_agents/activity/paged_members_result.py,sha256=ABwhTA3znOO0HCam1_-26lmAiEnYRe6AICkrTe8npR0,473
-microsoft_agents/activity/place.py,sha256=KwoNIZ06MhTdYkevzIr6auAR65Z_aXALqunZt7Ze5XE,824
 microsoft_agents/activity/receipt_card.py,sha256=P-FQYuIsGGx9yLjpF8KZO4ZzaFf0rd_ocM5DOk0mRgU,1245
-microsoft_agents/activity/receipt_item.py,sha256=pPGnf2XRPdiNr2NpqRm5Oa3ns7ITVO3zqD_NGm4MLq4,1118
+microsoft_agents/activity/receipt_item.py,sha256=v6d7GBlB7nDGbV6ME8CRCkmzDhGzMRFhFVd5ybvsoLw,1107
 microsoft_agents/activity/resource_response.py,sha256=qTN6C2wXTP_euH5_LDL47DOfMfofe4_o1z7ZO39OEpU,255
 microsoft_agents/activity/role_types.py,sha256=Y-bnda7PFFBhXd-zZaL5RlIDbgAhdZbeW8TLV_fYjf0,108
 microsoft_agents/activity/semantic_action.py,sha256=HjkK0yq_w5hHLaP_DAsPNaBRReRplyupcvUroZeVQr8,595
 microsoft_agents/activity/semantic_actions_states.py,sha256=xCcSWGmCKizL9J7lycEBIYPIGeQb2dQmsLLObph7s00,149
 microsoft_agents/activity/sign_in_constants.py,sha256=3juR-nSfP0vr3TvFPhQ2foEivt1lLgWxsG6LQmWhhkc,534
 microsoft_agents/activity/sign_in_resource.py,sha256=Ygy5wjCvyW1fQ5aLf29214_LFeF9zJnd7ZsUxice5JY,446
-microsoft_agents/activity/signin_card.py,sha256=mI1Zg3PcpFRneH4XL_sdUw2rwIAYN6YMdG_FfpoPmww,453
+microsoft_agents/activity/signin_card.py,sha256=Bbq8B4MjvcVU5J6pEuuaDJALyS_G2t4c0Z1oBatVQd8,442
 microsoft_agents/activity/suggested_actions.py,sha256=R9jHYkL5nau9Mlz7q0UJqv4PeQ2_H4P3WvTtrGMaLXQ,587
 microsoft_agents/activity/text_format_types.py,sha256=cMYHz1LQY1FwUgh1odOAVyfidKl1RZKPVFrxLW9SQ1Q,120
-microsoft_agents/activity/text_highlight.py,sha256=OunPICePQLNgJOEO1Xw4PlOvPkoRF6Y5xssx-Kh4jJE,441
-microsoft_agents/activity/thing.py,sha256=L7J1WBGtgDNkzk99FcgHU7nalhXoe4TQj67hvmWiKE8,356
-microsoft_agents/activity/thumbnail_card.py,sha256=gvbWnvWCV4AoXfBjnAorUKXNmLBZJ0YAvd4tDNjDW_E,1019
+microsoft_agents/activity/text_highlight.py,sha256=Cj0JyUjyW_EQVpYyG4v2I5Gb3Zct8RJH3s5vq5tkfaM,430
+microsoft_agents/activity/thumbnail_card.py,sha256=wRF78XIGeUtaa_cieAAAXUZHgPrHvht58h9z0IQQiBg,1008
 microsoft_agents/activity/thumbnail_url.py,sha256=1gGTFfKmjGi3Rrtgh4RF4nmx13ZlwZVgvpeAtTUfS0E,383
 microsoft_agents/activity/token_exchange_invoke_request.py,sha256=MQ2WskGT3rOOZYMZTtRiA9W4vmJ8TWSgkkx29-4LH-o,631
 microsoft_agents/activity/token_exchange_invoke_response.py,sha256=U2rIXQJkqEl9y_9zQuBz1CEXZ9_0k4w77jxNkYSLXG4,668
@@ -81,7 +76,14 @@ microsoft_agents/activity/token_response.py,sha256=jQbDEyQqApsF85Zse03D_FsW6ATGf
 microsoft_agents/activity/token_status.py,sha256=o3pGTKRjuqEndRWClMe91Cmox6cW8aDrOTvE3_k5jFI,1174
 microsoft_agents/activity/transcript.py,sha256=yV5s5rONGC1uM5pKnVv0HbY2SVzQ9qKOBawM0fzJOJc,328
 microsoft_agents/activity/turn_context_protocol.py,sha256=ETR6L5aMoZdPkLUcULmDHfmQo21-_bFF_yzxZmiG_6g,1692
-microsoft_agents/activity/video_card.py,sha256=WkIKFxW87-DGKY7HmPp8a2ae2rp0F8piWnspW6IaptI,1964
+microsoft_agents/activity/video_card.py,sha256=nJb0l8NuhLuH2mFOvozzKao4uQiCGko9LZHnno_QS0k,1953
+microsoft_agents/activity/entity/__init__.py,sha256=WqUL3e79ifcn8UhHVIHcSqQ6MHaEEyGgKi3v65-jQls,617
+microsoft_agents/activity/entity/ai_entity.py,sha256=VOjU9Y6m68vkiKUHnqG5XmNPRu4KCSKmd0XPDCJ6B0s,3280
+microsoft_agents/activity/entity/entity.py,sha256=c9zCbP7uGmc-_a18qfe5uFWHWmofpfnJqSmINNWvV1E,1085
+microsoft_agents/activity/entity/geo_coordinates.py,sha256=GnBGkBZMUg7Q6Aonqpcr1e_CVobZzh3eGAqh_qSGAZA,891
+microsoft_agents/activity/entity/mention.py,sha256=zhzJRKiQNuS2mtOK-_3CVswTM-PiGTOOU7tvzEPqytc,604
+microsoft_agents/activity/entity/place.py,sha256=Y-wuCxovDVIf9QwTkXJYDrkcAx73wIgWY4mqD-oyDOo,826
+microsoft_agents/activity/entity/thing.py,sha256=wAgviXeu1s4dGHDnm8mXSCvYZIiV_fWT7dpHD-FjxfE,358
 microsoft_agents/activity/teams/__init__.py,sha256=pdcnd_Ud92Eox_fHSgm1kwzwFmG8LVeatF9MRI8IaVY,8532
 microsoft_agents/activity/teams/app_based_link_query.py,sha256=-2uuPbyElN0DbU5R_mTJ_o7jphBNFr1ZFlLeziXuxn0,462
 microsoft_agents/activity/teams/batch_failed_entries_response.py,sha256=Q6Mgbdu_OdFGEKmaMu3jr71BSfwNtAgCMLyDSrfLf7I,439
@@ -189,7 +191,7 @@ microsoft_agents/activity/teams/teams_member.py,sha256=vRcLRHy6wTfH7DP6k6QbrKkOR
 microsoft_agents/activity/teams/teams_paged_members_result.py,sha256=cG4eKHjA0u1EMioC2ErVpydnoPJrtTDcdhdzYET9xto,555
 microsoft_agents/activity/teams/tenant_info.py,sha256=h8OxMd6LD5lWVj_LK2ut8z7SB0I7Gx74W1wwEiYOzXk,296
 microsoft_agents/activity/teams/user_meeting_details.py,sha256=tvk2CWYf7Bo-DhK8NSojhanJDXEOGVrKXxJDca03CAo,467
-microsoft_agents_activity-0.4.0.dev1.dist-info/METADATA,sha256=4HtgnXuupQvZ3zrM3GO6omQeb_PrhybZ6QAq0hpYjRE,413
-microsoft_agents_activity-0.4.0.dev1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-microsoft_agents_activity-0.4.0.dev1.dist-info/top_level.txt,sha256=lWKcT4v6fTA_NgsuHdNvuMjSrkiBMXohn64ApY7Xi8A,17
-microsoft_agents_activity-0.4.0.dev1.dist-info/RECORD,,
+microsoft_agents_activity-0.4.0.dev4.dist-info/METADATA,sha256=-eSa6rLKW8qndESghkHUpo-wh7pqG8no6CXSsRj8umM,413
+microsoft_agents_activity-0.4.0.dev4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+microsoft_agents_activity-0.4.0.dev4.dist-info/top_level.txt,sha256=lWKcT4v6fTA_NgsuHdNvuMjSrkiBMXohn64ApY7Xi8A,17
+microsoft_agents_activity-0.4.0.dev4.dist-info/RECORD,,