Merge branch 'main' into mehak/botbuilder

Author: MehakBindra

.github/copilot-instructions.md

@@ -1,6 +1,6 @@
-# Microsoft Teams AI Library for Python
+# Microsoft Teams SDK for Python
 
-Microsoft Teams AI Library for Python is a comprehensive SDK for building Microsoft Teams applications, bots, and AI agents using Python. This is a monorepo with workspace structure containing core packages and test applications.
+Microsoft Teams SDK for Python is a comprehensive SDK for building Microsoft Teams applications, bots, and AI agents using Python. This is a monorepo with workspace structure containing core packages and test applications.
 
 **Always reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the info here.**
 
@@ -23,10 +23,10 @@ Microsoft Teams AI Library for Python is a comprehensive SDK for building Micros
    ```bash
    # On Linux/Mac
    source .venv/bin/activate
-   
+
    # On Windows
    .venv\Scripts\Activate
-   
+
    # Alternative: Use uv run (no activation needed)
    # Example: uv run pytest packages
    ```
@@ -89,15 +89,15 @@ Microsoft Teams AI Library for Python is a comprehensive SDK for building Micros
 ```bash
 # These commands must pass:
 ruff format --check  # Format validation
-ruff check          # Linting validation  
+ruff check          # Linting validation
 pyright             # Type checking validation
 ```
 
 ## Repository Structure and Navigation
 
 ### Core Packages (`/packages`)
 - **microsoft-teams-apps**: Main application framework
-- **microsoft-teams-ai**: AI integration functionality  
+- **microsoft-teams-ai**: AI integration functionality
 - **microsoft-teams-api**: Teams API client
 - **microsoft-teams-cards**: Adaptive cards support
 - **microsoft-teams-common**: Shared utilities
@@ -153,7 +153,7 @@ The CI pipeline (`.github/workflows/ci.yml`) runs:
 
 ### Common Problems
 - **Import errors**: Ensure virtual environment is activated (`source .venv/bin/activate`) or use `uv run` commands
-- **UV not found**: Install with pip: `python -m pip install uv`  
+- **UV not found**: Install with pip: `python -m pip install uv`
 - **Test failures**: Run `uv sync --all-packages --group dev` to update dependencies
 - **Type errors**: Run `pyright` to catch type issues before CI
 - **Format issues**: Run `ruff format` to auto-fix formatting
@@ -163,7 +163,7 @@ The CI pipeline (`.github/workflows/ci.yml`) runs:
 
 - **NEVER CANCEL builds or tests** - Commands complete in 3-18 seconds but network delays may occur
 - **ALWAYS use timeouts of 60+ seconds** for any UV or build commands
-- **ALWAYS activate virtual environment or use uv run** before running Python commands  
+- **ALWAYS activate virtual environment or use uv run** before running Python commands
 - **ALWAYS validate with a test app** after making changes to core packages
 - **ALWAYS run pre-commit validation** (`poe check && pyright`) before committing
 - **NEVER skip manual testing** - Automated tests don't cover integration scenarios
@@ -175,7 +175,7 @@ The CI pipeline (`.github/workflows/ci.yml`) runs:
 .
 ├── .github/          # GitHub workflows and configs
 ├── packages/         # Core SDK packages
-├── tests/           # Test applications  
+├── tests/           # Test applications
 ├── templates/       # Cookiecutter templates
 ├── scripts/         # Build and release scripts
 ├── pyproject.toml   # Workspace and tool configuration

.python-version

@@ -1 +1 @@
-3.12
+3.13

CONTRIBUTING.md

@@ -1 +1 @@
-Please refer to this sub-module's root repo Contributing guide at [Teams AI v2 Contributing](https://github.com/microsoft/teams-ai/blob/v2-preview/CONTRIBUTING.md)
+Please refer to this sub-module's root repo Contributing guide at [Teams SDK Contributing](https://github.com/microsoft/teams-ai/blob/main/CONTRIBUTING.md)

README.md

@@ -1,11 +1,11 @@
 > [!CAUTION]
 > This project is in public preview. We’ll do our best to maintain compatibility, but there may be breaking changes in upcoming releases.
 
-# Microsoft Teams AI Library for Python
+# Microsoft Teams SDK for Python
 
 A comprehensive SDK for building Microsoft Teams applications, bots, and AI agents using Python. This SDK provides a high-level framework with built-in Microsoft Graph integration, OAuth handling, and extensible plugin architecture.
 
-<a href="https://microsoft.github.io/teams-ai" target="_blank">
+<a href="https://microsoft.github.io/teams-sdk" target="_blank">
     <img src="https://img.shields.io/badge/📖 Getting Started-blue?style=for-the-badge" />
 </a>
 
@@ -91,7 +91,7 @@ cookiecutter templates/test -o tests
 > ⚠️ **WARNING** these apps are changed often and are not intended to be used outside the
 > projects monorepo. To easily setup a new project please use the **templates** available via
 > the [@microsoft/teams.cli](https://www.npmjs.com/package/@microsoft/teams.cli) and follow the
-> [Getting Started](https://microsoft.github.io/teams-ai/python/getting-started) documentation!
+> [Getting Started](https://microsoft.github.io/teams-sdk/python/getting-started) documentation!
 
 - [`@tests/echo`](./tests/echo/README.md)
 - [`@tests/message-extensions`](./tests/message-extensions/README.md)

SUPPORT.md

@@ -6,7 +6,7 @@ This project uses GitHub Issues to track bugs and feature requests. Please searc
 issues before filing new issues to avoid duplicates. For new issues, file your bug or
 feature request as a new Issue.
 
-For help and questions about using this project, please join our [Teams AI Teams channel](https://teams.microsoft.com/l/channel/19%3A4PLRDRT5qVLpvXpfIHnoNohFElTC0aDzsNwfI0KHDxo1%40thread.tacv2/Support?groupId=1314f851-c930-4caa-b3e0-dbe9b8fe2737&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47)
+For help and questions about using this project, please join our [Teams SDK Teams channel](https://teams.microsoft.com/l/channel/19%3A4PLRDRT5qVLpvXpfIHnoNohFElTC0aDzsNwfI0KHDxo1%40thread.tacv2/Support?groupId=1314f851-c930-4caa-b3e0-dbe9b8fe2737&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47)
 
 ## Microsoft Support Policy
 

packages/a2aprotocol/README.md

@@ -7,7 +7,65 @@
     <a href="https://pypi.org/project/microsoft-teams-a2a" target="_blank">
         <img src="https://img.shields.io/pypi/dw/microsoft-teams-a2a" />
     </a>
+    <a href="https://microsoft.github.io/teams-sdk" target="_blank">
+        <img src="https://img.shields.io/badge/📖 Getting Started-blue?style=for-the-badge" />
+    </a>
 </p>
-<a href="https://microsoft.github.io/teams-ai" target="_blank">
-    <img src="https://img.shields.io/badge/📖 Getting Started-blue?style=for-the-badge" />
-</a>
+
+Agent-to-Agent (A2A) protocol support for Microsoft Teams AI applications.
+Enables Teams agents to communicate and collaborate with other AI agents using standardized protocols.
+
+## Installation
+
+```bash
+uv add microsoft-teams-a2a
+```
+
+## Usage
+
+### A2A Server (Expose Agent)
+
+```python
+from microsoft.teams.apps import App
+from microsoft.teams.a2a import A2APlugin, A2APluginOptions
+from a2a.types import AgentCard, AgentCapabilities
+
+app = App()
+
+# Define agent card with capabilities
+agent_card = AgentCard(
+    name="weather_agent",
+    description="An agent that can tell you the weather",
+    url="http://localhost:4000/a2a/",
+    version="0.0.1",
+    protocol_version="0.3.0",
+    capabilities=AgentCapabilities(),
+    default_input_modes=[],
+    default_output_modes=[]
+)
+
+a2a_server = A2APlugin(A2APluginOptions(agent_card=agent_card))
+app = App(plugins=[a2a_server])
+```
+
+### A2A Client (Use Other Agents)
+
+```python
+from microsoft.teams.a2a import A2AClientPlugin, A2APluginUseParams
+from microsoft.teams.ai import ChatPrompt
+from microsoft.teams.openai import OpenAICompletionsAIModel
+
+model = OpenAICompletionsAIModel(api_key="your-api-key", model="gpt-4")
+
+# Connect to another A2A agent
+a2a_client = A2AClientPlugin()
+a2a_client.on_use_plugin(
+    A2APluginUseParams(
+        key="my-weather-agent",
+        base_url="http://localhost:4000/a2a",
+        card_url=".well-known/agent-card.json"
+    )
+)
+
+prompt = ChatPrompt(model, plugins=[a2a_client])
+```

packages/a2aprotocol/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "microsoft-teams-a2a"
-version = "2.0.0a4"
+version = "2.0.0a5"
 description = "plugin that enables your teams agent to be used as an a2a agent"
 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"

packages/ai/README.md

@@ -1,4 +1,4 @@
-# Microsoft Teams AI
+# Microsoft Teams SDK
 
 <p>
     <a href="https://pypi.org/project/microsoft-teams-ai/" target="_blank">
@@ -7,10 +7,57 @@
     <a href="https://pypi.org/project/microsoft-teams-ai/" target="_blank">
         <img src="https://img.shields.io/pypi/dw/microsoft-teams-ai" />
     </a>
+    <a href="https://microsoft.github.io/teams-sdk" target="_blank">
+        <img src="https://img.shields.io/badge/📖 Getting Started-blue?style=for-the-badge" />
+    </a>
 </p>
 
-AI tools and utilities.
+AI-powered conversational experiences for Microsoft Teams applications.
+Provides prompt management, action planning, and model integration for building intelligent Teams bots.
+
+[📖 Documentation](https://microsoft.github.io/teams-sdk/python/in-depth-guides/ai/)
+
+## Installation
+
+```bash
+uv add microsoft-teams-ai
+```
+
+## Usage
+
+### ChatPrompt
+
+```python
+from microsoft.teams.ai import ChatPrompt, Function
+from microsoft.teams.openai import OpenAICompletionsAIModel
+from pydantic import BaseModel
+
+model = OpenAICompletionsAIModel(api_key="your-api-key", model="gpt-4")
+
+# Create a ChatPrompt
+prompt = ChatPrompt(model)
+
+result = await prompt.send(
+    input="Hello!",
+    instructions="You are a helpful assistant."
+)
+```
+
+### Function Calling
+
+```python
+class GetWeatherParams(BaseModel):
+    location: str
+
+async def get_weather(params: GetWeatherParams) -> str:
+    return f"The weather in {params.location} is sunny"
+
+weather_function = Function(
+    name="get_weather",
+    description="Get weather for a location",
+    parameter_schema=GetWeatherParams,
+    handler=get_weather
+)
 
-<a href="https://microsoft.github.io/teams-ai" target="_blank">
-    <img src="https://img.shields.io/badge/📖 Getting Started-blue?style=for-the-badge" />
-</a>
+prompt = ChatPrompt(model, functions=[weather_function])
+```

packages/ai/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "microsoft-teams-ai"
-version = "2.0.0a4"
+version = "2.0.0a5"
 description = "package to handle interacting with ai or llms"
 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"

packages/ai/src/microsoft/teams/ai/ai_model.py

@@ -17,7 +17,7 @@ class AIModel(Protocol):
     Protocol defining the interface for AI models that can generate text responses.
 
     This protocol standardizes how different AI providers (OpenAI, Azure OpenAI, etc.)
-    integrate with the Teams AI framework. Implementations should handle message
+    integrate with the Teams SDK. Implementations should handle message
     processing, function calling, and optional streaming.
     """