Python: Add Purview Middleware (#1142)

* [Py Purview] Purview Python Initial Commit

* [Py Purview] Purview Python Minor Fixes

* [Py Purview] Purview Python Comment Fixesish

* [Py Purview] Purview Python Agent Middleware Done

* [Py Purview] Purview Python Agent Middleware Done

* [Py Purview] Purview Python Lint Errors

* [Py Purview] Purview Python Final Hopefully

* [Py Purview] Purview Python Final Hopefully

* [Py Purview] Purview Python Fix ReadMe

* [Py Purview] Purview Python Fix MyPy

* [Py Purview] Purview Python Minor Updates on comments

* [Py Purview] Purview Python Fix Build Error

---------

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

python/packages/core/agent_framework/azure/_shared.py

@@ -243,4 +243,4 @@ class AzureOpenAIConfigMixin(OpenAIBase):
             def_headers = None
         self.default_headers = def_headers
 
-        super().__init__(model_id=deployment_name, client=client)
+        super().__init__(model_id=deployment_name, client=client, **kwargs)

python/packages/core/agent_framework/microsoft/__init__.py

@@ -3,12 +3,20 @@
 import importlib
 from typing import Any
 
-PACKAGE_NAME = "agent_framework_copilotstudio"
-PACKAGE_EXTRA = ["microsoft-copilotstudio", "copilotstudio"]
 _IMPORTS: dict[str, tuple[str, list[str]]] = {
     "CopilotStudioAgent": ("agent_framework_copilotstudio", ["microsoft-copilotstudio", "copilotstudio"]),
     "__version__": ("agent_framework_copilotstudio", ["microsoft-copilotstudio", "copilotstudio"]),
     "acquire_token": ("agent_framework_copilotstudio", ["microsoft-copilotstudio", "copilotstudio"]),
+    # Purview (Graph Data Security & Governance) integration exports
+    "PurviewPolicyMiddleware": ("agent_framework_purview", ["microsoft-purview", "purview"]),
+    "PurviewChatPolicyMiddleware": ("agent_framework_purview", ["microsoft-purview", "purview"]),
+    "PurviewSettings": ("agent_framework_purview", ["microsoft-purview", "purview"]),
+    "PurviewAppLocation": ("agent_framework_purview", ["microsoft-purview", "purview"]),
+    "PurviewLocationType": ("agent_framework_purview", ["microsoft-purview", "purview"]),
+    "PurviewAuthenticationError": ("agent_framework_purview", ["microsoft-purview", "purview"]),
+    "PurviewRateLimitError": ("agent_framework_purview", ["microsoft-purview", "purview"]),
+    "PurviewRequestError": ("agent_framework_purview", ["microsoft-purview", "purview"]),
+    "PurviewServiceError": ("agent_framework_purview", ["microsoft-purview", "purview"]),
 }
 
 
@@ -23,7 +31,7 @@ def __getattr__(name: str) -> Any:
                 f"please use `pip install agent-framework-{package_extra[0]}`, "
                 "or update your requirements.txt or pyproject.toml file."
             ) from exc
-    raise AttributeError(f"Module `azure` has no attribute {name}.")
+    raise AttributeError(f"Module `microsoft` has no attribute {name}.")
 
 
 def __dir__() -> list[str]:

python/packages/core/agent_framework/microsoft/__init__.pyi

@@ -1,5 +1,29 @@
 # Copyright (c) Microsoft. All rights reserved.
 
 from agent_framework_copilotstudio import CopilotStudioAgent, __version__, acquire_token
+from agent_framework_purview import (
+    PurviewAppLocation,
+    PurviewAuthenticationError,
+    PurviewChatPolicyMiddleware,
+    PurviewLocationType,
+    PurviewPolicyMiddleware,
+    PurviewRateLimitError,
+    PurviewRequestError,
+    PurviewServiceError,
+    PurviewSettings,
+)
 
-__all__ = ["CopilotStudioAgent", "__version__", "acquire_token"]
+__all__ = [
+    "CopilotStudioAgent",
+    "PurviewAppLocation",
+    "PurviewAuthenticationError",
+    "PurviewChatPolicyMiddleware",
+    "PurviewLocationType",
+    "PurviewPolicyMiddleware",
+    "PurviewRateLimitError",
+    "PurviewRequestError",
+    "PurviewServiceError",
+    "PurviewSettings",
+    "__version__",
+    "acquire_token",
+]