add type stubs

Author: Mehak Bindra

packages/botbuilder/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "microsoft-teams-botbuilder"
-version = "2.0.0a3"
+version = "2.0.0a5"
 description = "BotBuilder plugin for Microsoft Teams"
 authors = [{ name = "Microsoft", email = "[email protected]" }]
 readme = "README.md"
-requires-python = ">=3.12"
+requires-python = ">=3.12,<3.14"
 repository = "https://github.com/microsoft/teams.py"
 keywords = ["microsoft", "teams", "ai", "bot", "agents"]
 license = "MIT"
@@ -16,12 +16,6 @@ dependencies = [
     "microsoft-teams-common"
 ]
 
-[dependency-groups]
-dev = [
-    "pytest>=8.4.0",
-    "pytest-asyncio>=1.0.0",
-]
-
 [project.urls]
 Homepage = "https://github.com/microsoft/teams.py/tree/main/packages/botbuilder/src/microsoft/teams/botbuilder"
 

packages/botbuilder/src/microsoft/teams/botbuilder/botbuilder_plugin.py

@@ -1,5 +1,3 @@
-# pyright: reportMissingTypeStubs=false, reportUnknownMemberType=false
-
 """
 Copyright (c) Microsoft Corporation. All rights reserved.
 Licensed under the MIT License.
@@ -8,7 +6,7 @@
 import importlib.metadata
 from logging import Logger
 from types import SimpleNamespace
-from typing import Annotated, Any, Optional, Unpack, cast
+from typing import Annotated, Any, Optional, Unpack
 
 from fastapi import HTTPException, Request, Response
 from microsoft.teams.api import Credentials
@@ -110,7 +108,7 @@ async def on_activity_request(self, request: Request, response: Response) -> Any
         try:
             # Parse activity data
             body = await request.json()
-            activity_bf = cast(Activity, Activity().deserialize(body))
+            activity_bf = Activity().deserialize(body)
 
             # A POST request must contain an Activity
             if not activity_bf.type:

stubs/botbuilder/__init__.pyi

@@ -0,0 +1,3 @@
+"""Type stubs for botbuilder"""
+
+# This file exists to make botbuilder a stub package

stubs/botbuilder/core/__init__.pyi

@@ -0,0 +1,22 @@
+"""Type stubs for botbuilder.core"""
+
+from botbuilder.schema import Activity
+from typing_extensions import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from botbuilder.integration.aiohttp import CloudAdapter
+
+class TurnContext:
+    """Bot Framework Turn Context"""
+
+    activity: Activity
+
+    def __init__(
+        self, adapter_or_context: CloudAdapter | TurnContext | None, activity: Activity | None = None
+    ) -> None: ...
+
+class ActivityHandler:
+    """Bot Framework Activity Handler"""
+
+    def __init__(self) -> None: ...
+    async def on_turn(self, turn_context: TurnContext) -> None: ...

stubs/botbuilder/integration/__init__.pyi

@@ -0,0 +1,3 @@
+"""Type stubs for botbuilder.integration"""
+
+# This file exists to make botbuilder.integration a stub package

stubs/botbuilder/integration/aiohttp/__init__.pyi

@@ -0,0 +1,28 @@
+"""Type stubs for botbuilder.integration.aiohttp"""
+
+from abc import ABC
+from typing import Any, Awaitable, Callable
+
+from botbuilder.core import TurnContext
+from botbuilder.schema import Activity
+
+class BotFrameworkAuthentication(ABC):
+    """Bot Framework Authentication"""
+
+    ...
+
+class ConfigurationBotFrameworkAuthentication(BotFrameworkAuthentication):
+    """Bot Framework Configuration Authentication"""
+
+    def __init__(self, configuration: Any) -> None: ...
+
+class CloudAdapter:
+    """Bot Framework Cloud Adapter"""
+
+    def __init__(self, bot_framework_authentication: BotFrameworkAuthentication | None = None) -> None: ...
+    async def process_activity(
+        self,
+        auth_header: str,
+        activity: Activity,
+        logic: Callable[[TurnContext], Awaitable[None]],
+    ) -> None: ...

stubs/botbuilder/schema/__init__.pyi

@@ -0,0 +1,112 @@
+"""Type stubs for botbuilder.schema"""
+
+from __future__ import annotations
+
+from typing import Any, List
+
+# Forward declarations for referenced classes
+class ChannelAccount: ...
+class ConversationAccount: ...
+class MessageReaction: ...
+class SuggestedActions: ...
+class Attachment: ...
+class Entity: ...
+class ConversationReference: ...
+class TextHighlight: ...
+class SemanticAction: ...
+
+class Activity:
+    """Bot Framework Activity"""
+
+    type: str | None = None
+    id: str | None = None
+    timestamp: str | None = None
+    local_timestamp: str | None = None
+    local_timezone: str | None = None
+    service_url: str | None = None
+    channel_id: str | None = None
+    from_property: ChannelAccount | None = None
+    conversation: ConversationAccount | None = None
+    recipient: ChannelAccount | None = None
+    text_format: str | None = None
+    attachment_layout: str | None = None
+    members_added: List[ChannelAccount] | None = None
+    members_removed: List[ChannelAccount] | None = None
+    reactions_added: List[MessageReaction] | None = None
+    reactions_removed: List[MessageReaction] | None = None
+    topic_name: str | None = None
+    history_disclosed: bool | None = None
+    locale: str | None = None
+    text: str | None = None
+    speak: str | None = None
+    input_hint: str | None = None
+    summary: str | None = None
+    suggested_actions: SuggestedActions | None = None
+    attachments: List[Attachment] | None = None
+    entities: List[Entity] | None = None
+    channel_data: Any | None = None
+    action: str | None = None
+    reply_to_id: str | None = None
+    label: str | None = None
+    value_type: str | None = None
+    value: Any | None = None
+    name: str | None = None
+    relates_to: ConversationReference | None = None
+    code: str | None = None
+    expiration: str | None = None
+    importance: str | None = None
+    delivery_mode: str | None = None
+    listen_for: List[str] | None = None
+    text_highlights: List[TextHighlight] | None = None
+    semantic_action: SemanticAction | None = None
+    caller_id: str | None = None
+
+    def __init__(
+        self,
+        *,
+        type: str | None = None,
+        id: str | None = None,
+        timestamp: str | None = None,
+        local_timestamp: str | None = None,
+        local_timezone: str | None = None,
+        service_url: str | None = None,
+        channel_id: str | None = None,
+        from_property: ChannelAccount | None = None,
+        conversation: ConversationAccount | None = None,
+        recipient: ChannelAccount | None = None,
+        text_format: str | None = None,
+        attachment_layout: str | None = None,
+        members_added: List[ChannelAccount] | None = None,
+        members_removed: List[ChannelAccount] | None = None,
+        reactions_added: List[MessageReaction] | None = None,
+        reactions_removed: List[MessageReaction] | None = None,
+        topic_name: str | None = None,
+        history_disclosed: bool | None = None,
+        locale: str | None = None,
+        text: str | None = None,
+        speak: str | None = None,
+        input_hint: str | None = None,
+        summary: str | None = None,
+        suggested_actions: SuggestedActions | None = None,
+        attachments: List[Attachment] | None = None,
+        entities: List[Entity] | None = None,
+        channel_data: Any | None = None,
+        action: str | None = None,
+        reply_to_id: str | None = None,
+        label: str | None = None,
+        value_type: str | None = None,
+        value: Any | None = None,
+        name: str | None = None,
+        relates_to: ConversationReference | None = None,
+        code: str | None = None,
+        expiration: str | None = None,
+        importance: str | None = None,
+        delivery_mode: str | None = None,
+        listen_for: List[str] | None = None,
+        text_highlights: List[TextHighlight] | None = None,
+        semantic_action: SemanticAction | None = None,
+        caller_id: str | None = None,
+        **kwargs: Any,
+    ) -> None: ...
+    def deserialize(self, data: str | None = None, content_type: str | None = None) -> Activity: ...
+    def serialize(self) -> dict[str, Any]: ...