microsoft-agents-hosting-core 1.4.0.dev18__tar.gz → 1.5.0.dev8__tar.gz

{microsoft_agents_hosting_core-1.4.0.dev18/microsoft_agents_hosting_core.egg-info → microsoft_agents_hosting_core-1.5.0.dev8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-hosting-core
-Version: 1.4.0.dev18
+Version: 1.5.0.dev8
 Summary: Core library for Microsoft Agents
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -15,12 +15,14 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: microsoft-agents-activity==1.4.0.dev18
+Requires-Dist: microsoft-agents-activity==1.5.0.dev8
 Requires-Dist: pyjwt>=2.10.1
 Requires-Dist: isodate>=0.6.1
 Requires-Dist: python-dotenv>=1.1.1
 Requires-Dist: opentelemetry-api>=1.27.0
 Requires-Dist: opentelemetry-sdk>=1.27.0
+Requires-Dist: aiohttp>=3.11.11
+Requires-Dist: yarl<2.0,>=1.17.0
 Dynamic: license-file
 Dynamic: requires-dist
 
@@ -42,6 +44,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_hosting_core-1.5.0.dev8/VERSION.txt

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

{microsoft_agents_hosting_core-1.4.0.dev18 → microsoft_agents_hosting_core-1.5.0.dev8}/microsoft_agents/hosting/core/__init__.py

@@ -9,6 +9,7 @@ from .message_factory import MessageFactory
 from .middleware_set import Middleware, MiddlewareSet
 from .rest_channel_service_client_factory import RestChannelServiceClientFactory
 from .turn_context import TurnContext
+from .outbound_host_validator import OutboundHostValidator
 
 # HTTP abstractions
 from .http import (
@@ -122,6 +123,7 @@ __all__ = [
     "Middleware",
     "RestChannelServiceClientFactory",
     "TurnContext",
+    "OutboundHostValidator",
     "HttpRequestProtocol",
     "HttpResponse",
     "HttpResponseFactory",

{microsoft_agents_hosting_core-1.4.0.dev18 → microsoft_agents_hosting_core-1.5.0.dev8}/microsoft_agents/hosting/core/_http_adapter_base.py

@@ -7,6 +7,8 @@ from abc import ABC
 from http import HTTPStatus
 from traceback import format_exc
 
+import logging
+
 from microsoft_agents.activity import Activity, DeliveryModes
 from microsoft_agents.hosting.core.telemetry.adapter import spans
 
@@ -20,6 +22,9 @@ from .http._http_response import HttpResponse, HttpResponseFactory
 from .message_factory import MessageFactory
 from .rest_channel_service_client_factory import RestChannelServiceClientFactory
 from .turn_context import TurnContext
+from .outbound_host_validator import OutboundHostValidator, _try_create_url
+
+logger = logging.getLogger(__name__)
 
 
 class HttpAdapterBase(ChannelServiceAdapter, ABC):
@@ -35,6 +40,7 @@ class HttpAdapterBase(ChannelServiceAdapter, ABC):
         connection_manager: Connections | None = None,
         channel_service_client_factory: ChannelServiceClientFactoryBase | None = None,
         channel_service_client_factory_options: dict | None = None,
+        host_validator: OutboundHostValidator | None = None,
     ):
         """Initialize the HTTP adapter.
 
@@ -73,6 +79,7 @@ class HttpAdapterBase(ChannelServiceAdapter, ABC):
                 connection_manager,
                 **(channel_service_client_factory_options or {}),
             )
+        self._host_validator = host_validator or OutboundHostValidator()
 
         super().__init__(factory)
 
@@ -112,10 +119,8 @@ class HttpAdapterBase(ChannelServiceAdapter, ABC):
             span.share(activity=activity)
 
             # Get claims identity (default to anonymous if not set by middleware)
-            claims_identity: (
-                ClaimsIdentity
-            ) = request.get_claims_identity() or ClaimsIdentity(
-                {}, False, authentication_type="Anonymous"
+            claims_identity: ClaimsIdentity = (
+                request.get_claims_identity() or ClaimsIdentity()
             )
 
             # Validate required activity fields
@@ -128,6 +133,11 @@ class HttpAdapterBase(ChannelServiceAdapter, ABC):
                     "Activity must have type and conversation.id"
                 )
 
+            if not self._validate_service_url(claims_identity, activity):
+                return HttpResponseFactory.unauthorized(
+                    "Service URL is not allowed by the host validator."
+                )
+
             try:
                 # Process the inbound activity with the agent
                 invoke_response = await self.process_activity(
@@ -153,3 +163,57 @@ class HttpAdapterBase(ChannelServiceAdapter, ABC):
 
             except PermissionError:
                 return HttpResponseFactory.unauthorized()
+
+    def _validate_service_url(
+        self, claims_identity: ClaimsIdentity, activity: Activity
+    ) -> bool:
+        """Validate the service URL against the claims identity.
+
+        Args:
+            claims_identity: The claims identity to validate against.
+            activity: The activity containing the service URL to validate.
+
+        Returns:
+            True if the service URL is valid, False otherwise.
+        """
+
+        if (
+            self._host_validator.enabled
+            and activity.service_url
+            and not self._host_validator.is_allowed(activity.service_url)
+        ):
+            logger.warning(
+                "Service URL %s is not allowed by the host validator.",
+                activity.service_url,
+            )
+            return False
+
+        if not claims_identity:
+            return True
+
+        claims_service_url = claims_identity.get_claim_value("serviceurl")
+        if activity.service_url and claims_service_url:
+            claim_url = _try_create_url(claims_service_url)
+            activity_url = _try_create_url(activity.service_url)
+            claim_url_host = (claim_url.host or "") if claim_url else ""
+            activity_url_host = (activity_url.host or "") if activity_url else ""
+            if (
+                not claim_url
+                or not activity_url
+                or claim_url_host.casefold() != activity_url_host.casefold()
+            ):
+                if self._host_validator and self._host_validator.enabled:
+                    logger.warning(
+                        "Service URL host mismatch: %s vs %s",
+                        claim_url_host,
+                        activity_url_host,
+                    )
+                    return False
+                else:
+                    logger.warning(
+                        "Service URL host mismatch (host validator disabled): %s vs %s",
+                        claim_url_host,
+                        activity_url_host,
+                    )
+
+        return True

{microsoft_agents_hosting_core-1.4.0.dev18 → microsoft_agents_hosting_core-1.5.0.dev8}/microsoft_agents/hosting/core/app/agent_application.py

@@ -903,6 +903,7 @@ class AgentApplication(Agent, Generic[StateT]):
         if (
             self.options.remove_recipient_mention
             and context.activity.type == ActivityTypes.message
+            and context.activity.text is not None
         ):
             context.activity.text = context.remove_recipient_mention(context.activity)
 

{microsoft_agents_hosting_core-1.4.0.dev18 → microsoft_agents_hosting_core-1.5.0.dev8}/microsoft_agents/hosting/core/app/proactive/conversation.py

@@ -1,19 +1,20 @@
-"""
-Copyright (c) Microsoft Corporation. All rights reserved.
-Licensed under the MIT License.
-"""
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
 
 from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+from opentelemetry.trace import SpanContext
+
 from microsoft_agents.activity import ConversationReference
 from microsoft_agents.hosting.core.authorization import ClaimsIdentity
 from microsoft_agents.hosting.core.storage.store_item import StoreItem
 
 if TYPE_CHECKING:
     from microsoft_agents.hosting.core.turn_context import TurnContext
-    from microsoft_agents.hosting.core.channel_adapter import ChannelAdapter
+
+from .telemetry._utils import _deserialize_span_context, _dump_span_context
 
 # JWT claim keys that are persisted alongside a ConversationReference.
 _PERSISTED_CLAIM_KEYS = frozenset({"aud", "azp", "appid", "idtyp", "ver", "iss", "tid"})
@@ -41,7 +42,20 @@ class Conversation(StoreItem):
         self,
         claims: dict[str, str] | ClaimsIdentity,
         conversation_reference: ConversationReference,
+        *,
+        _span_context: dict | None = None,
     ) -> None:
+        """Creates a new :class:`~microsoft_agents.hosting.core.app.proactive.Conversation` instance.
+
+        :param claims: Filtered JWT claims (``aud``, ``azp``, ``appid``, ``idtyp``,
+            ``ver``, ``iss``, ``tid``).  May be a raw ``dict`` or a
+            :class:`~microsoft_agents.hosting.core.authorization.ClaimsIdentity`.
+        :type claims: dict[str, str] or ClaimsIdentity
+        :param conversation_reference: The conversation reference.
+        :type conversation_reference: :class:`~microsoft_agents.activity.ConversationReference`
+        :param _span_context: Optional serialized span context for telemetry linking. For internal use only; this is not part of the public API.
+        :type _span_context: dict or None
+        """
         if isinstance(claims, ClaimsIdentity):
             self.claims: dict[str, str] = Conversation.claims_from_identity(claims)
         else:
@@ -49,6 +63,29 @@ class Conversation(StoreItem):
                 k: v for k, v in claims.items() if k in _PERSISTED_CLAIM_KEYS
             }
         self.conversation_reference: ConversationReference = conversation_reference
+        self._span_context_dict: dict | None = _span_context
+
+    def _set_span_context(self, span_context: SpanContext) -> None:
+        """Sets the span context for this conversation, serializing it to a dictionary for storage.
+
+        For internal use only; this is not part of the public API.
+
+        :param span_context: The SpanContext to set.
+        :type span_context: SpanContext
+        """
+        self._span_context_dict = _dump_span_context(span_context)
+
+    def _get_span_context(self) -> SpanContext | None:
+        """Gets the span context for this conversation, deserializing it from a dictionary.
+
+        For internal use only; this is not part of the public API.
+
+        :return: The SpanContext, or None if not set.
+        :rtype: SpanContext or None
+        """
+        if self._span_context_dict is None:
+            return None
+        return _deserialize_span_context(self._span_context_dict)
 
     # ------------------------------------------------------------------
     # Factory helpers
@@ -97,7 +134,9 @@ class Conversation(StoreItem):
         :return: Reconstituted claims identity.
         :rtype: :class:`~microsoft_agents.hosting.core.authorization.ClaimsIdentity`
         """
-        return ClaimsIdentity(claims=dict(claims), is_authenticated=True)
+        if not claims:
+            return ClaimsIdentity()
+        return ClaimsIdentity(claims=dict(claims))
 
     # ------------------------------------------------------------------
     # Validation
@@ -135,6 +174,7 @@ class Conversation(StoreItem):
             "conversation_reference": self.conversation_reference.model_dump(
                 mode="json", by_alias=True, exclude_unset=True
             ),
+            "_span_context": self._span_context_dict,
         }
 
     @staticmethod
@@ -145,4 +185,5 @@ class Conversation(StoreItem):
         return Conversation(
             claims=json_data.get("claims", {}),
             conversation_reference=reference,
+            _span_context=json_data.get("_span_context", None),
         )

{microsoft_agents_hosting_core-1.4.0.dev18 → microsoft_agents_hosting_core-1.5.0.dev8}/microsoft_agents/hosting/core/app/proactive/conversation_builder.py

@@ -5,11 +5,10 @@ Licensed under the MIT License.
 
 from __future__ import annotations
 
-from typing import Optional
-
 from microsoft_agents.activity import (
     ChannelAccount,
     Channels,
+    ChannelId,
     ConversationAccount,
     ConversationReference,
 )
@@ -38,6 +37,7 @@ class ConversationBuilder:
         conversation = (
             ConversationBuilder
             .create_from_identity(claims_identity, "msteams")
+            .with_user("user-aad-oid")
             .with_conversation("19:thread-id@thread.v2")
             .build()
         )
@@ -45,16 +45,16 @@ class ConversationBuilder:
 
     def __init__(self) -> None:
         self._claims: dict[str, str] = {}
-        self._channel_id: Optional[str] = None
-        self._service_url: Optional[str] = None
-        self._agent_id: Optional[str] = None
-        self._agent_name: Optional[str] = None
-        self._user_id: Optional[str] = None
-        self._user_name: Optional[str] = None
-        self._conversation_id: Optional[str] = None
-        self._conversation_name: Optional[str] = None
-        self._tenant_id: Optional[str] = None
-        self._activity_id: Optional[str] = None
+        self._channel_id: str | None = None
+        self._service_url: str | None = None
+        self._agent_id: str | None = None
+        self._agent_name: str | None = None
+        self._user_id: str | None = None
+        self._user_name: str | None = None
+        self._conversation_id: str | None = None
+        self._conversation_name: str | None = None
+        self._tenant_id: str | None = None
+        self._activity_id: str | None = None
 
     # ------------------------------------------------------------------
     # Entry-point factories
@@ -65,8 +65,8 @@ class ConversationBuilder:
         cls,
         agent_client_id: str,
         channel_id: str,
-        service_url: Optional[str] = None,
-        requestor_id: Optional[str] = None,
+        service_url: str | None = None,
+        requestor_id: str | None = None,
     ) -> "ConversationBuilder":
         """
         Start building a :class:`~microsoft_agents.hosting.core.app.proactive.conversation.Conversation`
@@ -79,7 +79,7 @@ class ConversationBuilder:
         :type channel_id: str
         :param service_url: Override the service URL.  Defaults to the canonical
             URL for *channel_id*.
-        :type service_url: Optional[str]
+        :type service_url: str | None
         :param requestor_id: If provided, stored as the ``appid`` claim (useful
             when the requestor differs from the audience).
         :type requestor_id: Optional[str]
@@ -106,7 +106,7 @@ class ConversationBuilder:
         cls,
         identity: ClaimsIdentity,
         channel_id: str,
-        service_url: Optional[str] = None,
+        service_url: str | None = None,
     ) -> "ConversationBuilder":
         """
         Start building a :class:`~microsoft_agents.hosting.core.app.proactive.conversation.Conversation`
@@ -117,7 +117,7 @@ class ConversationBuilder:
         :param channel_id: The channel identifier.
         :type channel_id: str
         :param service_url: Override the service URL.
-        :type service_url: Optional[str]
+        :type service_url: str | None
         :return: A builder pre-populated with the identity's claims.
         :rtype: :class:`microsoft_agents.hosting.core.app.proactive.ConversationBuilder`
         """
@@ -142,7 +142,7 @@ class ConversationBuilder:
     def with_user(
         self,
         user_id: str,
-        user_name: Optional[str] = None,
+        user_name: str | None = None,
     ) -> "ConversationBuilder":
         """
         Set the user account.
@@ -161,8 +161,8 @@ class ConversationBuilder:
     def with_conversation(
         self,
         conversation_id: str,
-        conversation_name: Optional[str] = None,
-        tenant_id: Optional[str] = None,
+        conversation_name: str | None = None,
+        tenant_id: str | None = None,
     ) -> "ConversationBuilder":
         """
         Set the conversation account details.
@@ -201,7 +201,7 @@ class ConversationBuilder:
         """
         Construct the :class:`~microsoft_agents.hosting.core.app.proactive.conversation.Conversation`.
 
-        :raises ValueError: If required fields (``channel_id``, ``conversation_id``) are missing.
+        :raises ValueError: If a required identifier (channel, conversation, agent, or user) is missing.
         :return: The built :class:`~microsoft_agents.hosting.core.app.proactive.conversation.Conversation`.
         :rtype: :class:`~microsoft_agents.hosting.core.app.proactive.conversation.Conversation`
         """
@@ -209,28 +209,29 @@ class ConversationBuilder:
             raise ValueError("ConversationBuilder: channel_id is required.")
         if not self._conversation_id:
             raise ValueError("ConversationBuilder: conversation_id is required.")
+        if not self._agent_id:
+            raise ValueError("ConversationBuilder: agent_id is required.")
+        if not self._user_id:
+            raise ValueError("ConversationBuilder: user_id is required.")
 
-        agent = (
-            ChannelAccount(id=self._agent_id, name=self._agent_name)
-            if self._agent_id
-            else None
-        )
-        user = (
-            ChannelAccount(id=self._user_id, name=self._user_name)
-            if self._user_id
-            else None
-        )
+        agent_values = {"id": self._agent_id}
+        if self._agent_name is not None:
+            agent_values["name"] = self._agent_name
+
+        user_values = {"id": self._user_id}
+        if self._user_name is not None:
+            user_values["name"] = self._user_name
 
         reference = ConversationReference(
-            channel_id=self._channel_id,
+            channel_id=ChannelId(self._channel_id),
             service_url=self._service_url or _service_url_for_channel(self._channel_id),
             conversation=ConversationAccount(
                 id=self._conversation_id,
                 name=self._conversation_name,
                 tenant_id=self._tenant_id,
             ),
-            bot=agent,
-            user=user,
+            agent=ChannelAccount(**agent_values),
+            user=ChannelAccount(**user_values),
             activity_id=self._activity_id,
         )
 

{microsoft_agents_hosting_core-1.4.0.dev18 → microsoft_agents_hosting_core-1.5.0.dev8}/microsoft_agents/hosting/core/app/proactive/conversation_reference_builder.py

@@ -5,14 +5,13 @@ Licensed under the MIT License.
 
 from __future__ import annotations
 
-from typing import Optional
-
 from microsoft_agents.activity import (
     ChannelAccount,
     Channels,
     ConversationAccount,
     ConversationReference,
 )
+from microsoft_agents.activity._model_utils import pick_model, SkipNone
 
 
 def _service_url_for_channel(channel_id: str) -> str:
@@ -45,15 +44,15 @@ class ConversationReferenceBuilder:
     """
 
     def __init__(self) -> None:
-        self._channel_id: Optional[str] = None
-        self._conversation_id: Optional[str] = None
-        self._service_url: Optional[str] = None
-        self._agent_id: Optional[str] = None
-        self._agent_name: Optional[str] = None
-        self._user_id: Optional[str] = None
-        self._user_name: Optional[str] = None
-        self._activity_id: Optional[str] = None
-        self._locale: Optional[str] = None
+        self._channel_id: str | None = None
+        self._conversation_id: str | None = None
+        self._service_url: str | None = None
+        self._agent_id: str | None = None
+        self._agent_name: str | None = None
+        self._user_id: str | None = None
+        self._user_name: str | None = None
+        self._activity_id: str | None = None
+        self._locale: str | None = None
 
     # ------------------------------------------------------------------
     # Entry-point factories
@@ -64,7 +63,7 @@ class ConversationReferenceBuilder:
         cls,
         channel_id: str,
         conversation_id: str,
-    ) -> "ConversationReferenceBuilder":
+    ) -> ConversationReferenceBuilder:
         """
         Start building a :class:`~microsoft_agents.activity.ConversationReference`
         from a channel ID and an existing conversation ID.
@@ -86,8 +85,8 @@ class ConversationReferenceBuilder:
         cls,
         agent_client_id: str,
         channel_id: str,
-        service_url: Optional[str] = None,
-    ) -> "ConversationReferenceBuilder":
+        service_url: str | None = None,
+    ) -> ConversationReferenceBuilder:
         """
         Start building a :class:`~microsoft_agents.activity.ConversationReference`
         from an agent application ID and channel.
@@ -101,7 +100,7 @@ class ConversationReferenceBuilder:
         :type channel_id: str
         :param service_url: Override the service URL.  When ``None`` the default
             URL for the channel is used.
-        :type service_url: Optional[str]
+        :type service_url: str | None
         :return: A builder pre-populated for the agent.
         :rtype: :class:`microsoft_agents.hosting.core.app.proactive.ConversationReferenceBuilder`
         """
@@ -124,15 +123,15 @@ class ConversationReferenceBuilder:
     def with_agent(
         self,
         agent_id: str,
-        agent_name: Optional[str] = None,
-    ) -> "ConversationReferenceBuilder":
+        agent_name: str | None = None,
+    ) -> ConversationReferenceBuilder:
         """
         Set the agent (bot) account on the reference.
 
         :param agent_id: The agent's channel account ID.
         :type agent_id: str
         :param agent_name: Optional display name.
-        :type agent_name: Optional[str]
+        :type agent_name: str | None
         :return: ``self`` for chaining.
         :rtype: :class:`microsoft_agents.hosting.core.app.proactive.ConversationReferenceBuilder`
         """
@@ -143,15 +142,15 @@ class ConversationReferenceBuilder:
     def with_user(
         self,
         user_id: str,
-        user_name: Optional[str] = None,
-    ) -> "ConversationReferenceBuilder":
+        user_name: str | None = None,
+    ) -> ConversationReferenceBuilder:
         """
         Set the user account on the reference.
 
         :param user_id: The user's channel account ID.
         :type user_id: str
         :param user_name: Optional display name.
-        :type user_name: Optional[str]
+        :type user_name: str | None
         :return: ``self`` for chaining.
         :rtype: :class:`microsoft_agents.hosting.core.app.proactive.ConversationReferenceBuilder`
         """
@@ -159,7 +158,7 @@ class ConversationReferenceBuilder:
         self._user_name = user_name
         return self
 
-    def with_service_url(self, service_url: str) -> "ConversationReferenceBuilder":
+    def with_service_url(self, service_url: str) -> ConversationReferenceBuilder:
         """
         Override the service URL.
 
@@ -171,7 +170,7 @@ class ConversationReferenceBuilder:
         self._service_url = service_url
         return self
 
-    def with_activity_id(self, activity_id: str) -> "ConversationReferenceBuilder":
+    def with_activity_id(self, activity_id: str) -> ConversationReferenceBuilder:
         """
         Set the activity ID on the reference.
 
@@ -183,7 +182,7 @@ class ConversationReferenceBuilder:
         self._activity_id = activity_id
         return self
 
-    def with_locale(self, locale: str) -> "ConversationReferenceBuilder":
+    def with_locale(self, locale: str) -> ConversationReferenceBuilder:
         """
         Set the locale on the reference.
 
@@ -217,22 +216,25 @@ class ConversationReferenceBuilder:
         service_url = self._service_url or _service_url_for_channel(self._channel_id)
 
         agent = (
-            ChannelAccount(id=self._agent_id, name=self._agent_name)
+            pick_model(
+                ChannelAccount, id=self._agent_id, name=SkipNone(self._agent_name)
+            )
             if self._agent_id
             else None
         )
         user = (
-            ChannelAccount(id=self._user_id, name=self._user_name)
+            pick_model(ChannelAccount, id=self._user_id, name=SkipNone(self._user_name))
             if self._user_id
             else None
         )
 
-        return ConversationReference(
+        return pick_model(
+            ConversationReference,
             channel_id=self._channel_id,
             conversation=ConversationAccount(id=self._conversation_id),
             service_url=service_url,
-            bot=agent,
-            user=user,
+            agent=SkipNone(agent),
+            user=SkipNone(user),
             activity_id=self._activity_id,
             locale=self._locale,
         )

{microsoft_agents_hosting_core-1.4.0.dev18 → microsoft_agents_hosting_core-1.5.0.dev8}/microsoft_agents/hosting/core/app/proactive/create_conversation_options.py

@@ -6,7 +6,6 @@ Licensed under the MIT License.
 from __future__ import annotations
 
 from dataclasses import dataclass, field
-from typing import Optional
 
 from microsoft_agents.activity import ConversationParameters
 from microsoft_agents.hosting.core.authorization import ClaimsIdentity
@@ -26,10 +25,10 @@ class CreateConversationOptions:
         passed to the channel when creating the conversation.
     :type parameters: :class:`~microsoft_agents.activity.ConversationParameters`
     :param service_url: Optional override for the channel service URL.
-    :type service_url: Optional[str]
+    :type service_url: str | None
     :param audience: Optional OAuth audience override.  When ``None`` the
         audience is derived from *identity*.
-    :type audience: Optional[str]
+    :type audience: str | None
     :param store_conversation: When ``True`` the newly created conversation is
         automatically stored via
         :meth:`~microsoft_agents.hosting.core.app.proactive.proactive.Proactive.store_conversation`
@@ -37,11 +36,11 @@ class CreateConversationOptions:
     :type store_conversation: bool
     """
 
-    identity: ClaimsIdentity = field(default=None)
+    identity: ClaimsIdentity
     channel_id: str = field(default="")
-    parameters: Optional[ConversationParameters] = field(default=None)
-    service_url: Optional[str] = field(default=None)
-    audience: Optional[str] = field(default=None)
+    parameters: ConversationParameters | None = field(default=None)
+    service_url: str | None = field(default=None)
+    audience: str | None = field(default=None)
     store_conversation: bool = field(default=False)
 
     def validate(self) -> None: