microsoft-agents-activity 1.4.0.dev18__tar.gz → 1.5.0.dev10__tar.gz

{microsoft_agents_activity-1.4.0.dev18 → microsoft_agents_activity-1.5.0.dev10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-activity
-Version: 1.4.0.dev18
+Version: 1.5.0.dev10
 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.dev10/VERSION.txt

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

{microsoft_agents_activity-1.4.0.dev18 → microsoft_agents_activity-1.5.0.dev10}/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.dev18 → microsoft_agents_activity-1.5.0.dev10}/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.dev18 → microsoft_agents_activity-1.5.0.dev10}/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.dev10/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.dev18 → microsoft_agents_activity-1.5.0.dev10}/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.4.0.dev18 → microsoft_agents_activity-1.5.0.dev10}/microsoft_agents/activity/entity/stream_info.py

@@ -11,7 +11,7 @@ class StreamInfo(Entity):
     type: str = EntityTypes.STREAM_INFO.value
 
     stream_type: NonEmptyString = "streaming"
-    stream_sequence: int
+    stream_sequence: int | None = None
 
     stream_id: str = ""
     stream_result: str = ""

{microsoft_agents_activity-1.4.0.dev18 → microsoft_agents_activity-1.5.0.dev10}/microsoft_agents_activity.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-activity
-Version: 1.4.0.dev18
+Version: 1.5.0.dev10
 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.dev18 → microsoft_agents_activity-1.5.0.dev10}/microsoft_agents_activity.egg-info/SOURCES.txt

@@ -62,6 +62,7 @@ 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
@@ -99,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.dev18 → microsoft_agents_activity-1.5.0.dev10}/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.dev18 → microsoft_agents_activity-1.5.0.dev10}/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.dev18/VERSION.txt

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