PR: Branch Merge

.github/CODEOWNERS

@@ -2,4 +2,7 @@
 * @microsoft/agent365-approvers
 /.github/ @microsoft/agent365-approvers
 /libraries/microsoft-agents-a365-observability-*/ @microsoft/agent365-observability-approvers
-/tests/observability/ @microsoft/agent365-observability-approvers
+/tests/observability/ @microsoft/agent365-observability-approvers
+/libraries/microsoft-agents-a365-notifications/ @microsoft/agent365-tooling-approvers
+/libraries/microsoft-agents-a365-tooling*/ @microsoft/agent365-tooling-approvers
+/tests/tooling/ @microsoft/agent365-tooling-approvers

.github/workflows/ci.yml

@@ -108,8 +108,7 @@ jobs:
 
     - name: Check linting
       run: |
-        uv run --frozen ruff check .
-      continue-on-error: true
+        uv run --frozen ruff check . --preview
 
     - name: Check formatting
       run: |

CLAUDE.md

@@ -168,11 +168,45 @@ Place it before imports with one blank line after.
 
 ### Python Conventions
 
-- Type hints preferred (Pydantic models heavily used)
+- Type hints required on all function parameters and return types
 - Async/await patterns for I/O operations
 - Use explicit `None` checks: `if x is not None:` not `if x:`
 - Local imports should be moved to top of file
 - Return defensive copies of mutable data to protect singletons
+- **Async method naming**: Do NOT use `_async` suffix on async methods. The `_async` suffix is only appropriate when providing both sync and async versions of the same method. Since this SDK is async-only, use plain method names (e.g., `send_chat_history_messages` not `send_chat_history_messages_async`)
+
+### Type Hints - NEVER Use `Any`
+
+**CRITICAL: Never use `typing.Any` in this codebase.** Using `Any` defeats the purpose of type checking and can hide bugs. Instead:
+
+1. **Use actual types from external SDKs** - When integrating with external libraries (OpenAI, LangChain, etc.), import and use their actual types:
+   ```python
+   from agents.memory import Session
+   from agents.items import TResponseInputItem
+
+   async def send_chat_history(self, session: Session) -> OperationResult:
+       ...
+   ```
+
+2. **Use `Union` for known possible types**:
+   ```python
+   from typing import Union
+   MessageType = Union[UserMessage, AssistantMessage, SystemMessage, Dict[str, object]]
+   ```
+
+3. **Use `object` for truly unknown types** that you only pass through:
+   ```python
+   def log_item(item: object) -> None: ...
+   ```
+
+4. **Use `Protocol` only as a last resort** - If external types cannot be found or imported, define a Protocol. However, **confirm with the developer first** before proceeding with this approach, as it may indicate a missing dependency or incorrect understanding of the external API.
+
+**Why this matters:**
+- `Any` disables all type checking for that variable
+- Bugs that type checkers would catch go unnoticed
+- Code readability suffers - developers don't know what types to expect
+- Using actual SDK types provides better IDE support and ensures compatibility
+- This applies to both production code AND test files
 
 ## CI/CD
 

docs/design.md

@@ -227,9 +227,51 @@ Framework-specific adapters for MCP tool integration:
 |---------|---------|------------|
 | `extensions-agentframework` | Adapt MCP tools to Microsoft Agents SDK | [design.md](../libraries/microsoft-agents-a365-tooling-extensions-agentframework/docs/design.md) |
 | `extensions-azureaifoundry` | Azure AI Foundry tool integration | [design.md](../libraries/microsoft-agents-a365-tooling-extensions-azureaifoundry/docs/design.md) |
-| `extensions-openai` | OpenAI function calling integration | [design.md](../libraries/microsoft-agents-a365-tooling-extensions-openai/docs/design.md) |
+| `extensions-openai` | OpenAI function calling integration and chat history | [design.md](../libraries/microsoft-agents-a365-tooling-extensions-openai/docs/design.md) |
 | `extensions-semantickernel` | Semantic Kernel plugin integration | [design.md](../libraries/microsoft-agents-a365-tooling-extensions-semantickernel/docs/design.md) |
 
+#### OpenAI Extension: Chat History API
+
+The OpenAI tooling extension provides methods to send chat history to the MCP platform for real-time threat protection:
+
+**Key Classes:**
+
+| Class | Purpose |
+|-------|---------|
+| `McpToolRegistrationService` | MCP tool registration and chat history management |
+
+**Methods:**
+
+| Method | Purpose |
+|--------|---------|
+| `send_chat_history(turn_context, session, limit, options)` | Extract messages from OpenAI Session and send to MCP platform |
+| `send_chat_history_messages(turn_context, messages, options)` | Send a list of OpenAI TResponseInputItem messages to MCP platform |
+
+**Usage Example:**
+
+```python
+from agents import Agent, Runner
+from microsoft_agents_a365.tooling.extensions.openai import McpToolRegistrationService
+
+service = McpToolRegistrationService()
+agent = Agent(name="my-agent", model="gpt-4")
+
+# In your agent handler:
+async with Runner.run(agent, messages) as result:
+    session = result.session
+
+    # Option 1: Send from Session object
+    op_result = await service.send_chat_history(turn_context, session)
+
+    # Option 2: Send from message list
+    op_result = await service.send_chat_history_messages(turn_context, messages)
+
+    if op_result.succeeded:
+        print("Chat history sent successfully")
+```
+
+The methods convert OpenAI message types to `ChatHistoryMessage` format and delegate to the core `McpToolServerConfigurationService.send_chat_history()` method.
+
 ### 6. Notifications (`microsoft-agents-a365-notifications`)
 
 > **Detailed documentation**: [libraries/microsoft-agents-a365-notifications/docs/design.md](../libraries/microsoft-agents-a365-notifications/docs/design.md)

generate_dependency_diagram.py

@@ -9,7 +9,6 @@
 import re
 import tomllib
 from pathlib import Path
-from typing import Dict, List, Set
 
 
 class PackageInfo:
@@ -19,16 +18,16 @@ def __init__(self, name: str, package_type: str, path: Path):
         self.name = name
         self.package_type = package_type
         self.path = path
-        self.dependencies: Set[str] = set()
+        self.dependencies: set[str] = set()
 
 
-def read_pyproject_toml(path: Path) -> Dict:
+def read_pyproject_toml(path: Path) -> dict:
     """Read and parse a pyproject.toml file."""
     with open(path, "rb") as f:
         return tomllib.load(f)
 
 
-def extract_dependencies(pyproject_data: Dict, package_names: Set[str]) -> Set[str]:
+def extract_dependencies(pyproject_data: dict, package_names: set[str]) -> set[str]:
     """Extract internal package dependencies from pyproject.toml data."""
     dependencies = set()
 
@@ -45,7 +44,7 @@ def extract_dependencies(pyproject_data: Dict, package_names: Set[str]) -> Set[s
     return dependencies
 
 
-def generate_mermaid_diagram(packages: List[PackageInfo]) -> str:
+def generate_mermaid_diagram(packages: list[PackageInfo]) -> str:
     """Generate a Mermaid diagram from package information."""
 
     # Color scheme based on package types
@@ -96,7 +95,7 @@ def generate_mermaid_diagram(packages: List[PackageInfo]) -> str:
     lines.append("    %% Styling")
 
     # Group packages by type for styling
-    packages_by_type: Dict[str, List[str]] = {}
+    packages_by_type: dict[str, list[str]] = {}
     for pkg in packages:
         if pkg.package_type not in packages_by_type:
             packages_by_type[pkg.package_type] = []
@@ -170,8 +169,8 @@ def main():
 
     # Collect all package names first and cache pyproject data
     all_package_names = set()
-    packages: List[PackageInfo] = []
-    pyproject_data_cache: Dict[str, Dict] = {}
+    packages: list[PackageInfo] = []
+    pyproject_data_cache: dict[str, dict] = {}
 
     for path_str, pkg_type in package_configs:
         pyproject_path = repo_root / path_str / "pyproject.toml"

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/__init__.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 """
 Microsoft Agent 365 Notifications

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/agent_notification.py

@@ -1,3 +1,6 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
 from __future__ import annotations
 
 from collections.abc import Awaitable, Callable, Iterable

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/models/__init__.py

@@ -1,3 +1,6 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
 from .agent_notification_activity import AgentNotificationActivity
 from .email_reference import EmailReference
 from .wpx_comment import WpxComment

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/models/agent_lifecycle_event.py

@@ -1,3 +1,6 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
 from enum import Enum
 
 

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/models/agent_notification_activity.py

@@ -1,3 +1,6 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
 from typing import Any, Optional, Type, TypeVar
 from microsoft_agents.activity import Activity
 from .notification_types import NotificationTypes

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/models/agent_subchannel.py

@@ -1,3 +1,6 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
 from enum import Enum
 
 

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/models/email_reference.py

@@ -1,3 +1,6 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
 from typing import Optional, Literal
 from microsoft_agents.activity.entity import Entity
 from .notification_types import NotificationTypes

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/models/email_response.py

@@ -1,3 +1,6 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
 from typing import Literal
 from microsoft_agents.activity.activity import Activity
 from microsoft_agents.activity.entity import Entity

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/models/notification_types.py

@@ -1,3 +1,6 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
 from enum import Enum
 
 

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/models/wpx_comment.py

@@ -1,3 +1,6 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
 from typing import Optional, Literal
 from microsoft_agents.activity.entity import Entity
 from .notification_types import NotificationTypes

libraries/microsoft-agents-a365-notifications/pyproject.toml

@@ -69,6 +69,10 @@ target-version = ['py311']
 line-length = 100
 target-version = "py311"
 
+[tool.ruff.lint.flake8-copyright]
+notice-rgx = "# Copyright \\(c\\) Microsoft Corporation\\.\\r?\\n# Licensed under the MIT License\\."
+min-file-size = 1
+
 [tool.mypy]
 python_version = "3.11"
 strict = true

libraries/microsoft-agents-a365-notifications/setup.py

@@ -13,7 +13,7 @@
 helper_path = Path(__file__).parent.parent.parent / "versioning" / "helper"
 sys.path.insert(0, str(helper_path))
 
-from setup_utils import get_dynamic_dependencies
+from setup_utils import get_dynamic_dependencies  # noqa: E402
 
 # Use minimum version strategy:
 # - Internal packages get: >= current_base_version (e.g., >= 0.1.0)

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/__init__.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Microsoft Agent 365 Python SDK for OpenTelemetry tracing.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/config.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 import logging
 import threading

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/constants.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Constants for SDK OpenTelemetry implementation.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/execution_type.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Execution type enum.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/exporters/agent365_exporter.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # pip install opentelemetry-sdk opentelemetry-api requests
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/exporters/utils.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 import json
 import logging

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/inference_call_details.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 from dataclasses import dataclass
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/inference_operation_type.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 from enum import Enum
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/invoke_agent_details.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Data class for invoke agent details.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/middleware/__init__.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Middleware components for Microsoft Agent 365 SDK.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/middleware/baggage_builder.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Per request baggage builder for OpenTelemetry context propagation.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/opentelemetry_scope.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Base class for OpenTelemetry tracing scopes.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/request.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Request class.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/source_metadata.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Source metadata class.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/tenant_details.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Tenant details class.
 from dataclasses import dataclass

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/tool_call_details.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Data class for tool call details.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/tool_type.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 # Tool type enum.
 

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/trace_processor/__init__.py

@@ -1,4 +1,5 @@
-# Copyright (c) Microsoft. All rights reserved.
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
 
 """
 Trace Processors