microsoft-agents-hosting-slack 1.9.0.dev3__tar.gz → 1.9.0.dev10__tar.gz

{microsoft_agents_hosting_slack-1.9.0.dev3/microsoft_agents_hosting_slack.egg-info → microsoft_agents_hosting_slack-1.9.0.dev10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-hosting-slack
-Version: 1.9.0.dev3
+Version: 1.9.0.dev10
 Summary: Integration library for Microsoft Agents with Slack
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -15,7 +15,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: microsoft-agents-hosting-core==1.9.0.dev3
+Requires-Dist: microsoft-agents-hosting-core==1.9.0.dev10
 Requires-Dist: aiohttp>=3.12
 Dynamic: license-file
 Dynamic: requires-dist
@@ -24,81 +24,8 @@ Dynamic: requires-dist
 
 [![PyPI version](https://img.shields.io/pypi/v/microsoft-agents-hosting-slack)](https://pypi.org/project/microsoft-agents-hosting-slack/)
 
-Integration library for building Slack agents using the Microsoft 365 Agents SDK. Provides direct-to-Slack responses (the full Slack Web API surface, beyond what Azure Bot Service exposes), a typed `SlackChannelData` envelope with dot-notation property access, and a `SlackStream` helper for `chat.startStream` / `chat.appendStream` / `chat.stopStream`.
-
-
-## Release Notes
-
-<table style="width:100%">
-  <tr>
-    <th style="width:20%">Version</th>
-    <th style="width:20%">Date</th>
-    <th style="width:60%">Release Notes</th>
-  </tr>
-  <tr>
-    <td>1.8.0</td>
-    <td>2026-10-01</td>
-    <td>
-      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v180">
-        1.8.0 Release Notes
-      </a>
-    </td>
-  </tr>
-  <tr>
-    <td>1.7.0</td>
-    <td>2026-09-17</td>
-    <td>
-      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v170">
-        1.7.0 Release Notes
-      </a>
-    </td>
-  </tr>
-  <tr>
-    <td>1.5.0</td>
-    <td>2026-08-26</td>
-    <td>
-      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v150">
-        1.5.0 Release Notes
-      </a>
-    </td>
-  </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>
-    <td>
-      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v130">
-        1.3.0 Release Notes
-      </a>
-    </td>
-  </tr>
-  <tr>
-    <td>1.2.0</td>
-    <td>2026-07-17</td>
-    <td>
-      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v120">
-        1.2.0 Release Notes
-      </a>
-    </td>
-  </tr>
-  <tr>
-    <td>1.1.0</td>
-    <td>2026-06-19</td>
-    <td>
-      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v110">
-        1.1.0 Release Notes
-      </a>
-    </td>
-  </tr>
-</table>
+Build Slack agents with the Microsoft 365 Agents SDK using typed message and event
+handlers, direct Slack Web API calls, and streaming responses.
 
 ## Packages Overview
 
@@ -116,7 +43,7 @@ We offer the following PyPI packages to create conversational experiences based
 | `microsoft-agents-storage-blob` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-storage-blob)](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
 | `microsoft-agents-storage-cosmos` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-storage-cosmos)](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
 | `microsoft-agents-authentication-msal` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-authentication-msal)](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
-| `microsoft-agents-authentication-entra-auth-sidecar` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-authentication-entra-auth-sidecar)](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. | 
+| `microsoft-agents-authentication-entra-auth-sidecar` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-authentication-entra-auth-sidecar)](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
 
 ## Installation
 
@@ -126,38 +53,52 @@ pip install microsoft-agents-hosting-slack
 
 ## Usage
 
+Given configured application options (including storage) and a connection manager:
+
 ```python
 from microsoft_agents.hosting.core.app import AgentApplication
-from microsoft_agents.hosting.slack import SlackAgentExtension
-from microsoft_agents.hosting.slack.api import SlackChannelData
+from microsoft_agents.hosting.core.app.state import TurnState
+from microsoft_agents.hosting.slack import SlackAgentExtension, SlackTurnContext
 
-app = AgentApplication(options)
+app = AgentApplication[TurnState](options, connection_manager=connections)
 slack = SlackAgentExtension(app)
 
-@slack.on_message()
-async def on_slack_message(context, state):
-    channel_data = SlackChannelData.from_activity(context.activity)
+@slack.message()
+async def on_slack_message(context: SlackTurnContext, state: TurnState) -> None:
+    channel_data = context.activity.slack_channel_data
     await slack.call(
         context,
         "chat.postMessage",
         {
-            "channel": channel_data.get("event.channel"),
+            "channel": channel_data.channel,
             "text": f"You said: {context.activity.text}",
         },
-        token=channel_data.api_token,
+        token=channel_data.api_token or "",
     )
 ```
 
-## Key Classes
+Use `@slack.message("hello")` for a specific message or `@slack.event("reaction_added")`
+for a specific event. Both accept a string, a compiled regular expression, or a list of
+either, and match only Slack activities. When called without a selector, they match every
+Slack message or event and register at `RouteRank.LAST`, so more specific routes win.
+`on_message()` and `on_event()` are deprecated aliases.
+
+`@slack.conversation_update(...)`, `@slack.members_added()`, `@slack.members_removed()`,
+and `@slack.installation_update()` mirror the corresponding `AgentApplication` route
+hooks, but match only Slack activities and pass a `SlackTurnContext` to the handler.
+
+Handlers receive a `SlackTurnContext` with typed `activity.slack_channel_data` and
+access to the per-turn Slack API client through `context.client`. Envelope, payload,
+and response models support nested lookups such as `envelope.get("event.channel")`
+and typed lookups such as `response.get("count", type_=int)`.
 
-- **`SlackAgentExtension`** — registers Slack-channel-scoped message/event handlers; exposes `call(...)` and `create_stream(...)`.
-- **`SlackChannelData`** — typed wrapper around Bot Service's Slack channel-data payload with `get(path)` / `try_get(path)` accessors.
-- **`SlackApi`** — async HTTP client for the Slack Web API.
-- **`SlackStream`** — wraps Slack's streaming methods for incremental message updates.
-- **`SlackHelpers`** — encode/decode and conversation-id parsing utilities.
+Use `slack.create_stream(context, thread_ts=...)` to start a `SlackStream`, then
+append content and stop the stream. See the API docstrings for routing options,
+client configuration, streaming requirements, and lookup behavior.
 
-# Quick Links
+## Quick Links
 
+- [Release Notes](https://github.com/microsoft/Agents-for-python/blob/main/changelog.md)
 - 📦 [All SDK Packages on PyPI](https://pypi.org/search/?q=microsoft-agents)
 - 📖 [Complete Documentation](https://aka.ms/agents)
 - 🐛 [Report Issues](https://github.com/microsoft/Agents-for-python/issues)

microsoft_agents_hosting_slack-1.9.0.dev10/VERSION.txt

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

{microsoft_agents_hosting_slack-1.9.0.dev3 → microsoft_agents_hosting_slack-1.9.0.dev10}/microsoft_agents/hosting/slack/__init__.py

@@ -3,7 +3,9 @@ Copyright (c) Microsoft Corporation. All rights reserved.
 Licensed under the MIT License.
 """
 
+from .slack_activity import SlackActivity
 from .slack_agent_extension import SlackAgentExtension
+from .slack_turn_context import SlackTurnContext
 from .slack_helpers import (
     create_conversation_id,
     slack_bot_id_from_conversation_id,
@@ -15,7 +17,9 @@ from .slack_helpers import (
 )
 
 __all__ = [
+    "SlackActivity",
     "SlackAgentExtension",
+    "SlackTurnContext",
     "create_conversation_id",
     "slack_bot_id_from_conversation_id",
     "slack_channel_id_from_conversation_id",

{microsoft_agents_hosting_slack-1.9.0.dev3 → microsoft_agents_hosting_slack-1.9.0.dev10}/microsoft_agents/hosting/slack/_path_navigator.py

@@ -5,10 +5,10 @@ Licensed under the MIT License.
 
 from __future__ import annotations
 
-from typing import Any, Optional
+from typing import Any
 
 
-def _parse_path(path: str) -> Optional[list[int | str]]:
+def _parse_path(path: str) -> list[int | str] | None:
     """Tokenize a dot/bracket path into a list of segments.
 
     Supports ``a.b.c``, ``a[0].b``, ``a[1][2]``. Integer brackets become ``int``

{microsoft_agents_hosting_slack-1.9.0.dev3 → microsoft_agents_hosting_slack-1.9.0.dev10}/microsoft_agents/hosting/slack/api/action_payload.py

@@ -5,7 +5,7 @@ Licensed under the MIT License.
 
 from __future__ import annotations
 
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import ConfigDict
 
@@ -20,7 +20,7 @@ class ActionPayload(SlackModel):
 
     model_config = ConfigDict(extra="allow", populate_by_name=True)
 
-    type: Optional[str] = None
-    channel: Optional[Any] = None
-    message: Optional[Any] = None
-    actions: Optional[Any] = None
+    type: str | None = None
+    channel: Any | None = None
+    message: Any | None = None
+    actions: Any | None = None

{microsoft_agents_hosting_slack-1.9.0.dev3 → microsoft_agents_hosting_slack-1.9.0.dev10}/microsoft_agents/hosting/slack/api/chunks.py

@@ -8,7 +8,7 @@ See https://docs.slack.dev/reference/methods/chat.appendStream
 
 from __future__ import annotations
 
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -66,9 +66,9 @@ class TaskUpdateChunk(BaseModel):
     id: str
     title: str
     status: str = SlackTaskStatus.IN_PROGRESS
-    details: Optional[str] = None
-    output: Optional[str] = None
-    sources: Optional[list[Source]] = None
+    details: str | None = None
+    output: str | None = None
+    sources: list[Source] | None = None
 
 
 # Type alias for any chunk variant.

{microsoft_agents_hosting_slack-1.9.0.dev3 → microsoft_agents_hosting_slack-1.9.0.dev10}/microsoft_agents/hosting/slack/api/event_content.py

@@ -5,8 +5,6 @@ Licensed under the MIT License.
 
 from __future__ import annotations
 
-from typing import Optional
-
 from pydantic import ConfigDict
 
 from .slack_model import SlackModel
@@ -27,19 +25,19 @@ class EventContent(SlackModel):
     model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     # ── Common event fields (https://docs.slack.dev/apis/events-api/#event-type-structure)
-    type: Optional[str] = None
-    event_ts: Optional[str] = None
-    user: Optional[str] = None
-    ts: Optional[str] = None
-    subtype: Optional[str] = None
-    channel: Optional[str] = None
-    channel_type: Optional[str] = None
-    team: Optional[str] = None
+    type: str | None = None
+    event_ts: str | None = None
+    user: str | None = None
+    ts: str | None = None
+    subtype: str | None = None
+    channel: str | None = None
+    channel_type: str | None = None
+    team: str | None = None
 
     # ── message event fields ──
-    text: Optional[str] = None
-    client_msg_id: Optional[str] = None
+    text: str | None = None
+    client_msg_id: str | None = None
 
     # ── reaction_added / reaction_removed event fields ──
-    reaction: Optional[str] = None
-    item_user: Optional[str] = None
+    reaction: str | None = None
+    item_user: str | None = None

{microsoft_agents_hosting_slack-1.9.0.dev3 → microsoft_agents_hosting_slack-1.9.0.dev10}/microsoft_agents/hosting/slack/api/event_envelope.py

@@ -5,7 +5,7 @@ Licensed under the MIT License.
 
 from __future__ import annotations
 
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import ConfigDict, Field
 
@@ -31,21 +31,21 @@ class EventEnvelope(SlackModel):
 
     model_config = ConfigDict(extra="allow", populate_by_name=True)
 
-    token: Optional[str] = None
-    team_id: Optional[str] = None
-    context_team_id: Optional[str] = None
-    context_enterprise_id: Optional[str] = None
-    api_app_id: Optional[str] = None
+    token: str | None = None
+    team_id: str | None = None
+    context_team_id: str | None = None
+    context_enterprise_id: str | None = None
+    api_app_id: str | None = None
 
     # Python name `event_content` ↔ JSON field `event`
-    event_content: Optional[EventContent] = Field(default=None, alias="event")
-
-    type: Optional[str] = None
-    event_id: Optional[str] = None
-    event_time: Optional[int] = None
-    authorizations: Optional[Any] = None
-    is_ext_shared_channel: Optional[bool] = None
-    event_context: Optional[str] = None
+    event_content: EventContent | None = Field(default=None, alias="event")
+
+    type: str | None = None
+    event_id: str | None = None
+    event_time: int | None = None
+    authorizations: Any | None = None
+    is_ext_shared_channel: bool | None = None
+    event_context: str | None = None
 
     def _normalize_path(self, path: str) -> str:
         """Map the C# property alias ``event_content`` to JSON field ``event``."""

{microsoft_agents_hosting_slack-1.9.0.dev3 → microsoft_agents_hosting_slack-1.9.0.dev10}/microsoft_agents/hosting/slack/api/slack_api.py

@@ -6,7 +6,7 @@ Licensed under the MIT License.
 from __future__ import annotations
 
 import json
-from typing import Any, Optional
+from typing import Any
 
 from aiohttp import ClientSession, ClientTimeout
 from pydantic import BaseModel
@@ -58,11 +58,17 @@ class SlackApi:
 
     def __init__(
         self,
-        session: Optional[ClientSession] = None,
+        session: ClientSession | None = None,
         *,
         base_url: str = SLACK_API_BASE,
         request_timeout: float = 30.0,
     ) -> None:
+        """Initialize the SlackApi client.
+
+        :param session: An optional aiohttp ClientSession. If not provided, a new session is created.
+        :param base_url: The base URL for the Slack API.
+        :param request_timeout: The request timeout in seconds.
+        """
         self._session = session
         self._owns_session = session is None
         self._base_url = base_url
@@ -94,27 +100,29 @@ class SlackApi:
         if token and token.strip():
             headers["Authorization"] = f"Bearer {token}"
 
-        session = self._session or ClientSession()
-        try:
-            async with session.post(
-                url, data=body, headers=headers, timeout=self._timeout
-            ) as response:
-                text = await response.text()
-                try:
-                    payload = json.loads(text) if text else {}
-                    data = SlackResponse.model_validate(payload)
-                except Exception as exc:
-                    raise SlackResponseException(
-                        f"Slack API error on {method} (HTTP {response.status}):\n{text}"
-                    ) from exc
-
-                if not response.ok or not data.ok:
-                    raise SlackResponseException(
-                        f"Slack API error on {method} (HTTP {response.status}):\n{text}",
-                        data,
-                    )
-
-                return data
-        finally:
-            if self._owns_session:
-                await session.close()
+        if not self._session:
+            self._session = ClientSession()
+        async with self._session.post(
+            url, data=body, headers=headers, timeout=self._timeout
+        ) as response:
+            text = await response.text()
+            try:
+                payload = json.loads(text) if text else {}
+                data = SlackResponse.model_validate(payload)
+            except Exception as exc:
+                raise SlackResponseException(
+                    f"Slack API error on {method} (HTTP {response.status}):\n{text}"
+                ) from exc
+
+            if not response.ok or not data.ok:
+                raise SlackResponseException(
+                    f"Slack API error on {method} (HTTP {response.status}):\n{text}",
+                    data,
+                )
+
+            return data
+
+    async def aclose(self) -> None:
+        """Close the owned ClientSession, if any."""
+        if self._owns_session and self._session:
+            await self._session.close()

{microsoft_agents_hosting_slack-1.9.0.dev3 → microsoft_agents_hosting_slack-1.9.0.dev10}/microsoft_agents/hosting/slack/api/slack_channel_data.py

@@ -5,7 +5,8 @@ Licensed under the MIT License.
 
 from __future__ import annotations
 
-from typing import Any, Optional
+from typing import Any
+from typing_extensions import Self
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -21,36 +22,54 @@ class SlackChannelData(BaseModel):
     Bot Service historically named the envelope property ``SlackMessage`` and
     the API token ``ApiToken``; this model accepts both the PascalCase JSON
     names (via aliases) and snake_case Python names.
+
+    Access this model through ``SlackActivity.slack_channel_data`` or use
+    :meth:`from_activity` with a plain turn context's activity. Nested path
+    lookups belong to the envelope and payload, not this wrapper. For example,
+    when an envelope is present, ``envelope.get("event.channel")`` reads the
+    channel and ``envelope.get("event.blocks[0].type")`` reads an array field.
+    Unknown Slack fields are preserved.
     """
 
     model_config = ConfigDict(extra="allow", populate_by_name=True)
 
-    envelope: Optional[EventEnvelope] = Field(default=None, alias="SlackMessage")
-    payload: Optional[ActionPayload] = Field(default=None, alias="Payload")
-    api_token: Optional[str] = Field(default=None, alias="ApiToken")
+    envelope: EventEnvelope | None = Field(default=None, alias="SlackMessage")
+    payload: ActionPayload | None = Field(default=None, alias="Payload")
+    api_token: str | None = Field(default=None, alias="ApiToken")
 
     @property
-    def channel(self) -> Optional[str]:
+    def channel(self) -> str | None:
         """Slack channel id, sourced from the envelope or action payload."""
+        obj: Any = None
         if self.envelope is not None:
-            return self.envelope.get("event.channel")
-        if self.payload is not None:
-            return self.payload.get("channel")
+            obj = self.envelope.get("event.channel")
+            if isinstance(obj, dict) and "id" in obj:
+                obj = obj.get("id")
+        elif self.payload is not None:
+            obj = self.payload.get("channel")
+            if isinstance(obj, dict) and "id" in obj:
+                obj = obj.get("id")
+            if not isinstance(obj, str):
+                obj = self.payload.get("container.channel_id")
+        if isinstance(obj, str):
+            return obj
         return None
 
     @property
-    def thread_ts(self) -> Optional[str]:
+    def thread_ts(self) -> str | None:
         """Thread timestamp, sourced from the envelope event or payload message."""
         if self.envelope is not None:
-            return self.envelope.get("event.thread_ts") or self.envelope.get("event.ts")
+            return self.envelope.get("event.thread_ts", type_=str) or self.envelope.get(
+                "event.ts", type_=str
+            )
         if self.payload is not None:
-            return self.payload.get("message.thread_ts") or self.payload.get(
-                "message.ts"
+            return self.payload.get("message.thread_ts", type_=str) or self.payload.get(
+                "message.ts", type_=str
             )
         return None
 
     @classmethod
-    def from_activity(cls, activity: Any) -> "SlackChannelData":
+    def from_activity(cls, activity: Any) -> Self:
         """Build a :class:`SlackChannelData` from an Activity's ``channel_data``.
 
         Accepts ``Activity.channel_data`` that is either a ``dict`` (typical for

microsoft_agents_hosting_slack-1.9.0.dev10/microsoft_agents/hosting/slack/api/slack_model.py

@@ -0,0 +1,96 @@
+"""
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+"""
+
+from __future__ import annotations
+
+from types import NoneType
+from typing import Any, TypeVar, overload
+
+from pydantic import BaseModel, ConfigDict, TypeAdapter
+
+from .._path_navigator import try_get_path_value
+
+_T = TypeVar("_T")
+_DefaultT = TypeVar("_DefaultT")
+
+
+class SlackModel(BaseModel):
+    """
+    Base class for Slack model objects that expose dot-notation path navigation via
+    :meth:`get` and :meth:`try_get`.
+
+    Subclasses are Pydantic models with ``extra="allow"`` so any unmodelled fields
+    from Slack are preserved and reachable by path. The path navigator walks the
+    serialized form (``by_alias=True``), so paths use the same snake_case names
+    that appear in the Slack docs.
+
+    Subclasses whose JSON field names differ from their Python property names
+    override :meth:`_normalize_path` to remap the alias before navigation (e.g.
+    :class:`EventEnvelope` maps ``event_content`` → ``event``).
+    """
+
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    def _data(self) -> dict[str, Any]:
+        """Return the serialized form used for path navigation. Subclasses with
+        their own backing store may override this."""
+        return self.model_dump(mode="json", by_alias=True, exclude_none=False)
+
+    def _normalize_path(self, path: str) -> str:
+        """Remap caller-supplied path before navigation. Default: identity."""
+        return path
+
+    @overload
+    def get(self, path: str, default: _DefaultT, type_: type[_T]) -> _T | _DefaultT: ...
+
+    @overload
+    def get(self, path: str, *, type_: type[_T]) -> _T | None: ...
+
+    @overload
+    def get(self, path: str, default: Any = None, type_: None = None) -> Any: ...
+
+    def get(
+        self,
+        path: str,
+        default: _DefaultT | None = None,
+        type_: type[_T] | None = None,
+    ) -> _T | _DefaultT | None:
+        """Get a value at the dot-notation ``path``. Supports dot separators and
+        bracket array indexing (e.g. ``"message.attachments[0].text"``). Returns
+        ``default`` (or ``None``) when the path does not exist.
+
+        When ``type_`` is supplied, Pydantic's ``TypeAdapter`` converts and
+        validates non-null values, raising ``ValidationError`` on failure.
+        Existing null values return ``default`` (or ``None``) for typed lookups,
+        except when ``type_`` is ``type(None)``, which validates null directly.
+        Defaults are returned unchanged, without validation.
+        Without ``type_``, existing values are returned as-is, including null.
+        An empty path selects the entire serialized model.
+
+        For example, ``response.get("count", type_=int)`` converts a value to
+        an integer, while ``envelope.get("event", type_=EventContent)``
+        validates it as an event model. Invalid non-null values raise
+        ``pydantic.ValidationError`` even when a default is provided.
+
+        Typed overloads return the requested type plus ``None`` when no
+        default is supplied, or the requested type plus the default's type
+        when one is supplied. Untyped lookups remain dynamically typed.
+        """
+        found, value = self.try_get(path)
+        if not found:
+            return default
+        if type_ is not None and type_ is not NoneType and value is None:
+            return default
+        return TypeAdapter(type_).validate_python(value) if type_ is not None else value
+
+    def try_get(self, path: str) -> tuple[bool, Any]:
+        """Return a raw ``(found, value)`` tuple without conversion or validation.
+
+        An existing null value returns ``(True, None)``; a missing path returns
+        ``(False, None)``. An empty path selects the entire serialized model.
+        """
+        if not path:
+            return True, self._data()
+        return try_get_path_value(self._data(), self._normalize_path(path))

{microsoft_agents_hosting_slack-1.9.0.dev3 → microsoft_agents_hosting_slack-1.9.0.dev10}/microsoft_agents/hosting/slack/api/slack_response.py

@@ -5,7 +5,7 @@ Licensed under the MIT License.
 
 from __future__ import annotations
 
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import ConfigDict
 
@@ -28,15 +28,15 @@ class SlackResponse(SlackModel):
     model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     ok: bool = False
-    error: Optional[str] = None
-    warning: Optional[str] = None
-    ts: Optional[str] = None
-    response_metadata: Optional[Any] = None
+    error: str | None = None
+    warning: str | None = None
+    ts: str | None = None
+    response_metadata: Any | None = None
 
 
 class SlackResponseException(Exception):
     """Raised when a Slack Web API call returns a non-2xx status or ``ok=false``."""
 
-    def __init__(self, message: str, response: Optional[SlackResponse] = None) -> None:
+    def __init__(self, message: str, response: SlackResponse | None = None) -> None:
         super().__init__(message)
         self.response = response