microsoft-agents-activity 1.4.0.dev13__tar.gz → 1.5.0.dev8__tar.gz

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-activity
-Version: 1.4.0.dev13
+Version: 1.5.0.dev8
 Summary: A protocol library for Microsoft Agents
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -35,6 +35,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe
     <th style="width:20%">Date</th>
     <th style="width:60%">Release Notes</th>
   </tr>
+  <tr>
+   <td>1.4.0</td>
+   <td>2026-08-18</td>
+   <td>
+     <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v140">
+       1.4.0 Release Notes
+     </a>
+   </td>
+  </tr>
   <tr>
     <td>1.3.0</td>
     <td>2026-07-30</td>

microsoft_agents_activity-1.5.0.dev8/VERSION.txt

@@ -0,0 +1 @@
+1.5.0.dev8

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents/activity/__init__.py

@@ -10,6 +10,7 @@ from .adaptive_card_card import AdaptiveCardCard
 from .adaptive_card_invoke_action import AdaptiveCardInvokeAction
 from .adaptive_card_invoke_response import AdaptiveCardInvokeResponse
 from .adaptive_card_invoke_value import AdaptiveCardInvokeValue
+from .adaptive_card_search_invoke_value import AdaptiveCardSearchInvokeValue
 from .animation_card import AnimationCard
 from .attachment import Attachment
 from .attachment_data import AttachmentData
@@ -66,6 +67,8 @@ from .receipt_card import ReceiptCard
 from .receipt_item import ReceiptItem
 from .resource_response import ResourceResponse
 from .semantic_action import SemanticAction
+from .search_invoke_options import SearchInvokeOptions
+from .search_invoke_value import SearchInvokeValue
 from .signin_card import SigninCard
 from .suggested_actions import SuggestedActions
 from .text_highlight import TextHighlight
@@ -117,6 +120,7 @@ __all__ = [
     "AdaptiveCardInvokeAction",
     "AdaptiveCardInvokeResponse",
     "AdaptiveCardInvokeValue",
+    "AdaptiveCardSearchInvokeValue",
     "AnimationCard",
     "Attachment",
     "AttachmentData",
@@ -167,6 +171,8 @@ __all__ = [
     "ReceiptCard",
     "ReceiptItem",
     "ResourceResponse",
+    "SearchInvokeOptions",
+    "SearchInvokeValue",
     "SemanticAction",
     "SigninCard",
     "SuggestedActions",

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents/activity/activity.py

@@ -13,6 +13,7 @@ from typing_extensions import Self
 from pydantic import (
     Field,
     SerializeAsAny,
+    field_validator,
     model_serializer,
     model_validator,
     SerializerFunctionWrapHandler,
@@ -38,6 +39,7 @@ from .entity import (
     ProductInfo,
     SensitivityUsageInfo,
 )
+from .entity._validate_known_entities import _validate_known_entities
 from .conversation_reference import ConversationReference
 from .text_highlight import TextHighlight
 from .semantic_action import SemanticAction
@@ -198,6 +200,11 @@ class Activity(AgentsModel):
     semantic_action: SemanticAction = None
     caller_id: NonEmptyString = None
 
+    @field_validator("entities", mode="before")
+    @classmethod
+    def _deserialize_known_entities(cls, entities: Any) -> list[Entity]:
+        return _validate_known_entities(entities)
+
     @model_validator(mode="wrap")
     @classmethod
     def _validate_channel_id(

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents/activity/adaptive_card_invoke_action.py

@@ -1,6 +1,8 @@
 # Copyright (c) Microsoft Corporation. All rights reserved.
 # Licensed under the MIT License.
 
+from pydantic import Field
+
 from .agents_model import AgentsModel
 from ._type_aliases import NonEmptyString
 
@@ -14,14 +16,14 @@ class AdaptiveCardInvokeAction(AgentsModel):
     :param type: The Type of this Adaptive Card Invoke Action.
     :type type: str
     :param id: The Id of this Adaptive Card Invoke Action.
-    :type id: str
+    :type id: str | None
     :param verb: The Verb of this Adaptive Card Invoke Action.
-    :type verb: str
+    :type verb: str | None
     :param data: The data of this Adaptive Card Invoke Action.
     :type data: dict[str, object]
     """
 
-    type: NonEmptyString = None
-    id: NonEmptyString = None
-    verb: NonEmptyString = None
-    data: dict[NonEmptyString, object] = None
+    type: str
+    id: str | None = None
+    verb: str | None = None
+    data: dict[NonEmptyString, object] = Field(default_factory=dict)

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents/activity/adaptive_card_invoke_response.py

@@ -14,10 +14,10 @@ class AdaptiveCardInvokeResponse(AgentsModel):
     :type status_code: int
     :param type: The type of this Card Action Response.
     :type type: str
-    :param value: The JSON response object.
-    :type value: dict[str, object]
+    :param value: The response object.
+    :type value: object
     """
 
     status_code: int = None
     type: NonEmptyString = None
-    value: dict[NonEmptyString, object] = None
+    value: object = None

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents/activity/adaptive_card_invoke_value.py

@@ -20,6 +20,6 @@ class AdaptiveCardInvokeValue(AgentsModel):
     :type state: str
     """
 
-    action: AdaptiveCardInvokeAction = None
-    authentication: TokenExchangeInvokeRequest = None
+    action: AdaptiveCardInvokeAction
+    authentication: TokenExchangeInvokeRequest | None = None
     state: NonEmptyString = None

microsoft_agents_activity-1.5.0.dev8/microsoft_agents/activity/adaptive_card_search_invoke_value.py

@@ -0,0 +1,13 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from .search_invoke_value import SearchInvokeValue
+
+
+class AdaptiveCardSearchInvokeValue(SearchInvokeValue):
+    """
+    :param dataset: The dataset for this adaptive card search value.
+    :type dataset: str
+    """
+
+    dataset: str | None = None

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents/activity/config/_load_configuration.py

@@ -1,18 +1,18 @@
 # Copyright (c) Microsoft Corporation. All rights reserved.
 # Licensed under the MIT License.
 
-from typing import Any
+from typing import Any, Mapping
 
 from ._configure_logging import _configure_logging
 
 
-def load_configuration_from_env(env_vars: dict[str, Any]) -> dict:
+def load_configuration_from_env(env_vars: Mapping[str, Any]) -> dict:
     """
     Parses environment variables and returns a dictionary with the relevant configuration.
     """
-    vars = env_vars.copy()
+    local_vars = dict(env_vars)
     result = {}
-    for key, value in vars.items():
+    for key, value in local_vars.items():
         levels = key.split("__")
         current_level = result
         last_level = None

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents/activity/content_types.py

@@ -10,7 +10,13 @@ class ContentTypes:
     audio_card = "application/vnd.microsoft.card.audio"
     hero_card = "application/vnd.microsoft.card.hero"
     receipt_card = "application/vnd.microsoft.card.receipt"
+    error = "application/vnd.microsoft.error"
     oauth_card = "application/vnd.microsoft.card.oauth"
     signin_card = "application/vnd.microsoft.card.signin"
     thumbnail_card = "application/vnd.microsoft.card.thumbnail"
     video_card = "application/vnd.microsoft.card.video"
+    message = "application/vnd.microsoft.activity.message"
+    login_request = "application/vnd.microsoft.activity.loginRequest"
+    incorrect_auth_code = "application/vnd.microsoft.error.incorrectAuthCode"
+    precondition_failed = "application/vnd.microsoft.error.preconditionFailed"
+    search_response = "application/vnd.microsoft.search.searchResponse"

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents/activity/conversation_reference.py

@@ -4,7 +4,7 @@
 from __future__ import annotations
 
 from uuid import uuid4 as uuid
-from typing import Optional, Annotated
+from typing import Optional, Annotated, TYPE_CHECKING
 
 from pydantic import Field
 
@@ -15,6 +15,10 @@ from .agents_model import AgentsModel
 from ._type_aliases import NonEmptyString
 from .activity_types import ActivityTypes
 from .activity_event_names import ActivityEventNames
+from ._model_utils import pick_model, SkipNone
+
+if TYPE_CHECKING:
+    from .activity import Activity
 
 
 class ConversationReference(AgentsModel):
@@ -50,10 +54,11 @@ class ConversationReference(AgentsModel):
     locale: Optional[NonEmptyString] = None
     service_url: NonEmptyString = None
 
-    def get_continuation_activity(self) -> "Activity":  # type: ignore
+    def get_continuation_activity(self) -> Activity:
         from .activity import Activity
 
-        return Activity(
+        return pick_model(
+            Activity,
             type=ActivityTypes.event,
             name=ActivityEventNames.continue_conversation,
             id=str(uuid()),
@@ -61,6 +66,6 @@ class ConversationReference(AgentsModel):
             service_url=self.service_url,
             conversation=self.conversation,
             recipient=self.agent,
-            from_property=self.user,
+            from_property=SkipNone(self.user),
             relates_to=self,
         )

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents/activity/entity/__init__.py

@@ -19,6 +19,7 @@ from .place import Place
 from .product_info import ProductInfo
 from .stream_info import StreamInfo
 from .thing import Thing
+from ._validate_known_entities import _validate_known_entities
 
 __all__ = [
     "Entity",
@@ -38,4 +39,5 @@ __all__ = [
     "Thing",
     "ActivityTreatment",
     "ActivityTreatmentTypes",
+    "_validate_known_entities",
 ]

microsoft_agents_activity-1.5.0.dev8/microsoft_agents/activity/entity/_validate_known_entities.py

@@ -0,0 +1,85 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from typing import Any
+
+from .activity_treatment import ActivityTreatment
+from .ai_entity import AIEntity
+from .entity import Entity
+from .entity_types import EntityTypes
+from .geo_coordinates import GeoCoordinates
+from .mention import Mention
+from .place import Place
+from .product_info import ProductInfo
+from .stream_info import StreamInfo
+from .thing import Thing
+
+_KNOWN_ENTITY_TYPES: dict[str, tuple[str, type[Entity]]] = {
+    EntityTypes.ACTIVITY_TREATMENT.value.casefold(): (
+        EntityTypes.ACTIVITY_TREATMENT.value,
+        ActivityTreatment,
+    ),
+    EntityTypes.AI_CITATION.value.casefold(): (
+        EntityTypes.AI_CITATION.value,
+        AIEntity,
+    ),
+    EntityTypes.GEO_COORDINATES.value.casefold(): (
+        EntityTypes.GEO_COORDINATES.value,
+        GeoCoordinates,
+    ),
+    EntityTypes.MENTION.value.casefold(): (EntityTypes.MENTION.value, Mention),
+    EntityTypes.PLACE.value.casefold(): (EntityTypes.PLACE.value, Place),
+    EntityTypes.PRODUCT_INFO.value.casefold(): (
+        EntityTypes.PRODUCT_INFO.value,
+        ProductInfo,
+    ),
+    EntityTypes.STREAM_INFO.value.casefold(): (
+        EntityTypes.STREAM_INFO.value,
+        StreamInfo,
+    ),
+    EntityTypes.THING.value.casefold(): (EntityTypes.THING.value, Thing),
+}
+
+
+def _validate_known_entities(entities: Any) -> list[Entity]:
+    """Deserialize known activity entities while preserving unknown entity types.
+
+    :param entities: The data to validate and deserialize into known entity types.
+    :returns: A list of validated entities, with known types deserialized into their respective classes
+    :raises ValueError: If the input is not a list or tuple, or if an entity is not a dict or Entity instance.
+    """
+    if entities is None:
+        return []
+
+    if not isinstance(entities, (list, tuple)):
+        raise ValueError("entities must be a list or tuple")
+
+    validated_entities: list[Entity] = []
+    for entity in entities:
+        if isinstance(entity, Entity):
+            validated_entities.append(entity)
+            continue
+
+        if not isinstance(entity, dict):
+            raise ValueError(f"entity must be a dict or Entity, got {type(entity)}")
+
+        entity_type = entity.get("type")
+        if not entity_type:
+            raise ValueError(
+                "entity must have a 'type' field. Cannot infer entity type from data."
+            )
+
+        known_entity = (
+            _KNOWN_ENTITY_TYPES.get(entity_type.casefold())
+            if isinstance(entity_type, str)
+            else None
+        )
+        if known_entity:
+            canonical_type, entity_cls = known_entity
+            entity = {**entity, "type": canonical_type}
+        else:
+            entity_cls = Entity
+
+        validated_entities.append(entity_cls.model_validate(entity))
+
+    return validated_entities

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents/activity/entity/entity_types.py

@@ -8,6 +8,7 @@ class EntityTypes(str, Enum):
     """Well-known enumeration of entity types."""
 
     ACTIVITY_TREATMENT = "activityTreatment"
+    AI_CITATION = "https://schema.org/Message"
     GEO_COORDINATES = "GeoCoordinates"
     MENTION = "mention"
     PLACE = "Place"

microsoft_agents_activity-1.5.0.dev8/microsoft_agents/activity/search_invoke_options.py

@@ -0,0 +1,17 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from .agents_model import AgentsModel
+
+
+class SearchInvokeOptions(AgentsModel):
+    """Defines the query options in the 'SearchInvokeValue' for Invoke activity with name of 'application/search'.
+
+    :param skip: The number of items to skip in the search results. This is an integer that specifies how many items to skip in the search results.
+    :type skip: int
+    :param top: The maximum number of items to return in the search results. This is an integer that specifies the maximum number of items to return in the search results.
+    :type top: int
+    """
+
+    skip: int
+    top: int

microsoft_agents_activity-1.5.0.dev8/microsoft_agents/activity/search_invoke_value.py

@@ -0,0 +1,21 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from .agents_model import AgentsModel
+from .search_invoke_options import SearchInvokeOptions
+
+
+class SearchInvokeValue(AgentsModel):
+    """Defines the structure that arrives in Activity.value for invoke activity with name of 'application/search'.
+
+    :param kind: The kind of search being performed. This is a string that is used to identify the type of search being performed.
+    :type kind: str
+    :param query_text: The text of the search query. This is a string that contains the text of the search query being performed.
+    :type query_text: str
+    :param query_options: The options for the search query. This is an object that contains the options for the search query being performed.
+    :type query_options: :class:`microsoft_agents.activity.search_invoke_options.SearchInvokeOptions`
+    """
+
+    kind: str
+    query_text: str
+    query_options: SearchInvokeOptions

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents_activity.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-activity
-Version: 1.4.0.dev13
+Version: 1.5.0.dev8
 Summary: A protocol library for Microsoft Agents
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -35,6 +35,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe
     <th style="width:20%">Date</th>
     <th style="width:60%">Release Notes</th>
   </tr>
+  <tr>
+   <td>1.4.0</td>
+   <td>2026-08-18</td>
+   <td>
+     <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v140">
+       1.4.0 Release Notes
+     </a>
+   </td>
+  </tr>
   <tr>
     <td>1.3.0</td>
     <td>2026-07-30</td>

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/microsoft_agents_activity.egg-info/SOURCES.txt

@@ -16,6 +16,7 @@ microsoft_agents/activity/adaptive_card_card.py
 microsoft_agents/activity/adaptive_card_invoke_action.py
 microsoft_agents/activity/adaptive_card_invoke_response.py
 microsoft_agents/activity/adaptive_card_invoke_value.py
+microsoft_agents/activity/adaptive_card_search_invoke_value.py
 microsoft_agents/activity/agents_model.py
 microsoft_agents/activity/animation_card.py
 microsoft_agents/activity/attachment.py
@@ -61,10 +62,13 @@ microsoft_agents/activity/message_reaction_types.py
 microsoft_agents/activity/message_update_types.py
 microsoft_agents/activity/oauth_card.py
 microsoft_agents/activity/paged_members_result.py
+microsoft_agents/activity/py.typed
 microsoft_agents/activity/receipt_card.py
 microsoft_agents/activity/receipt_item.py
 microsoft_agents/activity/resource_response.py
 microsoft_agents/activity/role_types.py
+microsoft_agents/activity/search_invoke_options.py
+microsoft_agents/activity/search_invoke_value.py
 microsoft_agents/activity/semantic_action.py
 microsoft_agents/activity/semantic_actions_states.py
 microsoft_agents/activity/sign_in_constants.py
@@ -96,6 +100,7 @@ microsoft_agents/activity/config/_configure_logging.py
 microsoft_agents/activity/config/_load_configuration.py
 microsoft_agents/activity/entity/__init__.py
 microsoft_agents/activity/entity/_schema_mixin.py
+microsoft_agents/activity/entity/_validate_known_entities.py
 microsoft_agents/activity/entity/activity_treatment.py
 microsoft_agents/activity/entity/ai_entity.py
 microsoft_agents/activity/entity/entity.py

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools>=64"]
+requires = ["setuptools>=77"]
 build-backend = "setuptools.build_meta"
 
 [project]
@@ -24,5 +24,8 @@ dependencies = [
     "pydantic>=2.10.4"
 ]
 
+[tool.setuptools.package-data]
+"microsoft_agents.activity" = ["py.typed"]
+
 [project.urls]
 "Homepage" = "https://github.com/microsoft/Agents"

{microsoft_agents_activity-1.4.0.dev13 → microsoft_agents_activity-1.5.0.dev8}/readme.md

@@ -15,6 +15,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe
     <th style="width:20%">Date</th>
     <th style="width:60%">Release Notes</th>
   </tr>
+  <tr>
+   <td>1.4.0</td>
+   <td>2026-08-18</td>
+   <td>
+     <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v140">
+       1.4.0 Release Notes
+     </a>
+   </td>
+  </tr>
   <tr>
     <td>1.3.0</td>
     <td>2026-07-30</td>

microsoft_agents_activity-1.4.0.dev13/VERSION.txt

@@ -1 +0,0 @@
-1.4.0.dev13