microsoft-agents-a365-tooling-extensions-openai 0.1.0__tar.gz

microsoft_agents_a365_tooling_extensions_openai-0.1.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: microsoft-agents-a365-tooling-extensions-openai
+Version: 0.1.0
+Summary: OpenAI integration for Agent 365 Tooling SDK
+Author-email: Microsoft <support@microsoft.com>
+License: MIT
+Project-URL: Homepage, https://github.com/microsoft/Agent365-python
+Project-URL: Repository, https://github.com/microsoft/Agent365-python
+Project-URL: Issues, https://github.com/microsoft/Agent365-python/issues
+Project-URL: Documentation, https://github.com/microsoft/Agent365-python/tree/main/libraries/microsoft-agents-a365-tooling-extensions-openai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: microsoft-agents-a365-tooling>=0.0.0
+Requires-Dist: openai-agents
+Requires-Dist: asyncio-throttle
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+
+# microsoft-agents-a365-tooling-extensions-openai
+
+[![PyPI](https://img.shields.io/pypi/v/microsoft-agents-a365-tooling-extensions-openai?label=PyPI&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-openai)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/microsoft-agents-a365-tooling-extensions-openai?label=Downloads&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-openai)
+
+OpenAI Agents SDK specific tools and services for AI agent development. Provides MCP (Model Context Protocol) tool registration service for dynamically adding MCP servers to OpenAI Agents SDK-based agents.
+
+## Installation
+
+```bash
+pip install microsoft-agents-a365-tooling-extensions-openai
+```
+
+## Usage
+
+For usage examples and detailed documentation, see the [Tooling documentation](https://learn.microsoft.com/microsoft-agent-365/developer/tooling?tabs=python) on Microsoft Learn.
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section
+- See the [main documentation](../../../README.md) for more information
+ 
+## Trademarks
+ 
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../../LICENSE.md) file for details.

microsoft_agents_a365_tooling_extensions_openai-0.1.0/README.md

@@ -0,0 +1,33 @@
+# microsoft-agents-a365-tooling-extensions-openai
+
+[![PyPI](https://img.shields.io/pypi/v/microsoft-agents-a365-tooling-extensions-openai?label=PyPI&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-openai)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/microsoft-agents-a365-tooling-extensions-openai?label=Downloads&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-openai)
+
+OpenAI Agents SDK specific tools and services for AI agent development. Provides MCP (Model Context Protocol) tool registration service for dynamically adding MCP servers to OpenAI Agents SDK-based agents.
+
+## Installation
+
+```bash
+pip install microsoft-agents-a365-tooling-extensions-openai
+```
+
+## Usage
+
+For usage examples and detailed documentation, see the [Tooling documentation](https://learn.microsoft.com/microsoft-agent-365/developer/tooling?tabs=python) on Microsoft Learn.
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section
+- See the [main documentation](../../../README.md) for more information
+ 
+## Trademarks
+ 
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../../LICENSE.md) file for details.

microsoft_agents_a365_tooling_extensions_openai-0.1.0/microsoft_agents_a365/tooling/extensions/openai/__init__.py

@@ -0,0 +1,11 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+"""
+OpenAI extensions for Microsoft Agent 365 Tooling SDK
+
+Tooling and utilities specifically for OpenAI framework integration.
+Provides OpenAI-specific helper utilities.
+"""
+
+__version__ = "1.0.0"

microsoft_agents_a365_tooling_extensions_openai-0.1.0/microsoft_agents_a365/tooling/extensions/openai/mcp_tool_registration_service.py

@@ -0,0 +1,223 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+from typing import Dict, Optional
+from dataclasses import dataclass
+import logging
+
+from agents import Agent
+
+from microsoft_agents.hosting.core import Authorization, TurnContext
+
+from agents.mcp import (
+    MCPServerStreamableHttp,
+    MCPServerStreamableHttpParams,
+)
+from microsoft_agents_a365.runtime.utility import Utility
+from microsoft_agents_a365.tooling.services.mcp_tool_server_configuration_service import (
+    McpToolServerConfigurationService,
+)
+
+from microsoft_agents_a365.tooling.utils.utility import (
+    get_mcp_platform_authentication_scope,
+)
+
+
+# TODO: This is not needed. Remove this.
+@dataclass
+class MCPServerInfo:
+    """Information about an MCP server"""
+
+    name: str
+    url: str
+    server_type: str = "streamable_http"  # hosted, streamable_http, sse, stdio
+    headers: Optional[Dict[str, str]] = None
+    require_approval: str = "never"
+    timeout: int = 30  # Timeout in seconds (will be converted to milliseconds for MCPServerStreamableHttpParams)
+
+
+class McpToolRegistrationService:
+    """Service for managing MCP tools and servers for an agent"""
+
+    def __init__(self, logger: Optional[logging.Logger] = None):
+        """
+        Initialize the MCP Tool Registration Service for OpenAI.
+
+        Args:
+            logger: Logger instance for logging operations.
+        """
+        self._logger = logger or logging.getLogger(self.__class__.__name__)
+        self.config_service = McpToolServerConfigurationService(logger=self._logger)
+
+    async def add_tool_servers_to_agent(
+        self,
+        agent: Agent,
+        auth: Authorization,
+        auth_handler_name: str,
+        context: TurnContext,
+        auth_token: Optional[str] = None,
+    ):
+        """
+        Add new MCP servers to the agent by creating a new Agent instance.
+
+        Note: Due to OpenAI Agents SDK limitations, MCP servers must be set during
+        Agent creation. If new servers are found, this method creates a new Agent
+        instance with all MCP servers (existing + new) properly initialized.
+
+        Args:
+            agent: The existing agent to add servers to
+            auth: Authorization handler for token exchange.
+            auth_handler_name: Name of the authorization handler.
+            context: Turn context for the current operation.
+            auth_token: Authentication token to access the MCP servers.
+
+        Returns:
+            New Agent instance with all MCP servers, or original agent if no new servers
+        """
+
+        if not auth_token:
+            scopes = get_mcp_platform_authentication_scope()
+            authToken = await auth.exchange_token(context, scopes, auth_handler_name)
+            auth_token = authToken.token
+
+        # Get MCP server configurations from the configuration service
+        # mcp_server_configs = []
+        # TODO: radevika: Update once the common project is merged.
+
+        agentic_app_id = Utility.resolve_agent_identity(context, auth_token)
+        self._logger.info(f"Listing MCP tool servers for agent {agentic_app_id}")
+        mcp_server_configs = await self.config_service.list_tool_servers(
+            agentic_app_id=agentic_app_id,
+            auth_token=auth_token,
+        )
+
+        self._logger.info(f"Loaded {len(mcp_server_configs)} MCP server configurations")
+
+        # Convert MCP server configs to MCPServerInfo objects
+        mcp_servers_info = []
+        for server_config in mcp_server_configs:
+            server_info = MCPServerInfo(
+                name=server_config.mcp_server_name,
+                url=server_config.mcp_server_unique_name,
+            )
+            mcp_servers_info.append(server_info)
+
+        # Get existing MCP servers from the agent
+        existing_mcp_servers = (
+            list(agent.mcp_servers) if hasattr(agent, "mcp_servers") and agent.mcp_servers else []
+        )
+
+        # Prepare new MCP servers to add
+        new_mcp_servers = []
+        connected_servers = []
+
+        existing_server_urls = []
+        for server in existing_mcp_servers:
+            # Check for URL in params dict (MCPServerStreamableHttp stores URL in params["url"])
+            if (
+                hasattr(server, "params")
+                and isinstance(server.params, dict)
+                and "url" in server.params
+            ):
+                existing_server_urls.append(server.params["url"])
+            elif hasattr(server, "params") and hasattr(server.params, "url"):
+                existing_server_urls.append(server.params.url)
+            elif hasattr(server, "url"):
+                existing_server_urls.append(server.url)
+
+        for si in mcp_servers_info:
+            # Check if MCP server already exists
+
+            if si.url not in existing_server_urls:
+                try:
+                    # Prepare headers with authorization
+                    headers = si.headers or {}
+                    if auth_token:
+                        headers["Authorization"] = f"Bearer {auth_token}"
+
+                    # Create MCPServerStreamableHttpParams with proper configuration
+                    params = MCPServerStreamableHttpParams(url=si.url, headers=headers)
+
+                    # Create MCP server
+                    mcp_server = MCPServerStreamableHttp(params=params, name=si.name)
+
+                    # CRITICAL: Connect the server before adding it to the agent
+                    # This fixes the "Server not initialized. Make sure you call `connect()` first." error
+                    # TODO: When App Manifest scenario lits up for onboarding agent, we need to pull a flag and disconnect if the flag is disabled.
+                    await mcp_server.connect()
+
+                    new_mcp_servers.append(mcp_server)
+                    connected_servers.append(mcp_server)
+
+                    existing_server_urls.append(si.url)
+                    self._logger.info(
+                        f"Successfully connected to MCP server '{si.name}' at {si.url}"
+                    )
+
+                except Exception as e:
+                    # Log the error but continue with other servers
+                    self._logger.warning(
+                        f"Failed to connect to MCP server {si.name} at {si.url}: {e}"
+                    )
+                    continue
+
+        # If we have new servers, we need to recreate the agent
+        # The OpenAI Agents SDK requires MCP servers to be set during agent creation
+        if new_mcp_servers:
+            try:
+                self._logger.info(f"Recreating agent with {len(new_mcp_servers)} new MCP servers")
+                all_mcp_servers = existing_mcp_servers + new_mcp_servers
+
+                # Recreate the agent with all MCP servers
+                from agents import Agent
+
+                new_agent = Agent(
+                    name=agent.name,
+                    model=agent.model,
+                    model_settings=agent.model_settings
+                    if hasattr(agent, "model_settings")
+                    else None,
+                    instructions=agent.instructions,
+                    tools=agent.tools,
+                    mcp_servers=all_mcp_servers,
+                )
+
+                # Copy agent attributes to preserve state
+                for attr_name in ["name", "model", "instructions", "tools"]:
+                    if hasattr(agent, attr_name):
+                        setattr(new_agent, attr_name, getattr(agent, attr_name))
+
+                # Store connected servers for potential cleanup
+                if not hasattr(self, "_connected_servers"):
+                    self._connected_servers = []
+                self._connected_servers.extend(connected_servers)
+
+                self._logger.info(
+                    f"Agent recreated successfully with {len(all_mcp_servers)} total MCP servers"
+                )
+                # Return the new agent (caller needs to replace the old one)
+                return new_agent
+
+            except Exception as e:
+                # Clean up connected servers if agent creation fails
+                self._logger.error(f"Failed to recreate agent with new MCP servers: {e}")
+                await self._cleanup_servers(connected_servers)
+                raise e
+
+        self._logger.info("No new MCP servers to add to agent")
+        return agent
+
+    async def _cleanup_servers(self, servers):
+        """Clean up connected MCP servers"""
+        for server in servers:
+            try:
+                if hasattr(server, "cleanup"):
+                    await server.cleanup()
+            except Exception as e:
+                # Log cleanup errors but don't raise them
+                self._logger.debug(f"Error during server cleanup: {e}")
+
+    async def cleanup_all_servers(self):
+        """Clean up all connected MCP servers"""
+        if hasattr(self, "_connected_servers"):
+            await self._cleanup_servers(self._connected_servers)
+            self._connected_servers = []

microsoft_agents_a365_tooling_extensions_openai-0.1.0/microsoft_agents_a365_tooling_extensions_openai.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: microsoft-agents-a365-tooling-extensions-openai
+Version: 0.1.0
+Summary: OpenAI integration for Agent 365 Tooling SDK
+Author-email: Microsoft <support@microsoft.com>
+License: MIT
+Project-URL: Homepage, https://github.com/microsoft/Agent365-python
+Project-URL: Repository, https://github.com/microsoft/Agent365-python
+Project-URL: Issues, https://github.com/microsoft/Agent365-python/issues
+Project-URL: Documentation, https://github.com/microsoft/Agent365-python/tree/main/libraries/microsoft-agents-a365-tooling-extensions-openai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: microsoft-agents-a365-tooling>=0.0.0
+Requires-Dist: openai-agents
+Requires-Dist: asyncio-throttle
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+
+# microsoft-agents-a365-tooling-extensions-openai
+
+[![PyPI](https://img.shields.io/pypi/v/microsoft-agents-a365-tooling-extensions-openai?label=PyPI&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-openai)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/microsoft-agents-a365-tooling-extensions-openai?label=Downloads&logo=pypi)](https://pypi.org/project/microsoft-agents-a365-tooling-extensions-openai)
+
+OpenAI Agents SDK specific tools and services for AI agent development. Provides MCP (Model Context Protocol) tool registration service for dynamically adding MCP servers to OpenAI Agents SDK-based agents.
+
+## Installation
+
+```bash
+pip install microsoft-agents-a365-tooling-extensions-openai
+```
+
+## Usage
+
+For usage examples and detailed documentation, see the [Tooling documentation](https://learn.microsoft.com/microsoft-agent-365/developer/tooling?tabs=python) on Microsoft Learn.
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-python/issues) section
+- See the [main documentation](../../../README.md) for more information
+ 
+## Trademarks
+ 
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../../LICENSE.md) file for details.

microsoft_agents_a365_tooling_extensions_openai-0.1.0/microsoft_agents_a365_tooling_extensions_openai.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+setup.py
+microsoft_agents_a365/tooling/extensions/openai/__init__.py
+microsoft_agents_a365/tooling/extensions/openai/mcp_tool_registration_service.py
+microsoft_agents_a365_tooling_extensions_openai.egg-info/PKG-INFO
+microsoft_agents_a365_tooling_extensions_openai.egg-info/SOURCES.txt
+microsoft_agents_a365_tooling_extensions_openai.egg-info/dependency_links.txt
+microsoft_agents_a365_tooling_extensions_openai.egg-info/requires.txt
+microsoft_agents_a365_tooling_extensions_openai.egg-info/top_level.txt

microsoft_agents_a365_tooling_extensions_openai-0.1.0/microsoft_agents_a365_tooling_extensions_openai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

microsoft_agents_a365_tooling_extensions_openai-0.1.0/microsoft_agents_a365_tooling_extensions_openai.egg-info/requires.txt

@@ -0,0 +1,14 @@
+microsoft-agents-a365-tooling>=0.0.0
+openai-agents
+asyncio-throttle
+
+[dev]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0
+ruff>=0.1.0
+black>=23.0.0
+mypy>=1.0.0
+
+[test]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0

microsoft_agents_a365_tooling_extensions_openai-0.1.0/microsoft_agents_a365_tooling_extensions_openai.egg-info/top_level.txt

@@ -0,0 +1 @@
+microsoft_agents_a365

microsoft_agents_a365_tooling_extensions_openai-0.1.0/pyproject.toml

@@ -0,0 +1,72 @@
+[build-system]
+requires = ["setuptools>=68", "wheel", "tzdata"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "microsoft-agents-a365-tooling-extensions-openai"
+dynamic = ["version"]
+authors = [
+    { name = "Microsoft", email = "support@microsoft.com" },
+]
+description = "OpenAI integration for Agent 365 Tooling SDK"
+readme = "README.md"
+requires-python = ">=3.11"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+license = {text = "MIT"}
+dependencies = [
+    "microsoft-agents-a365-tooling >= 0.0.0",
+    "openai-agents",
+    "asyncio-throttle",
+]
+
+[project.urls]
+Homepage = "https://github.com/microsoft/Agent365-python"
+Repository = "https://github.com/microsoft/Agent365-python"
+Issues = "https://github.com/microsoft/Agent365-python/issues"
+Documentation = "https://github.com/microsoft/Agent365-python/tree/main/libraries/microsoft-agents-a365-tooling-extensions-openai"
+
+[project.optional-dependencies]
+dev = [
+    "pytest >= 7.0.0",
+    "pytest-asyncio >= 0.21.0",
+    "ruff >= 0.1.0",
+    "black >= 23.0.0",
+    "mypy >= 1.0.0",
+]
+test = [
+    "pytest >= 7.0.0",
+    "pytest-asyncio >= 0.21.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+
+[tool.setuptools]
+license-files = ["../../LICENSE"]
+include-package-data = true
+
+[tool.setuptools.package-data]
+"*" = ["../../LICENSE"]
+
+[tool.black]
+line-length = 100
+target-version = ['py311']
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true

microsoft_agents_a365_tooling_extensions_openai-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

microsoft_agents_a365_tooling_extensions_openai-0.1.0/setup.py

@@ -0,0 +1,28 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+import sys
+from pathlib import Path
+from os import environ
+from setuptools import setup
+
+# Get version from environment variable set by CI/CD
+package_version = environ.get("AGENT365_PYTHON_SDK_PACKAGE_VERSION", "0.0.0")
+
+# Add versioning helper to path
+helper_path = Path(__file__).parent.parent.parent / "versioning" / "helper"
+sys.path.insert(0, str(helper_path))
+
+from setup_utils import get_dynamic_dependencies
+
+# Use minimum version strategy:
+# - Internal packages get: >= current_base_version (e.g., >= 0.1.0)
+# - Automatically updates when you build new versions
+# - Consumers can upgrade to any higher version
+setup(
+    version=package_version,
+    install_requires=get_dynamic_dependencies(
+        use_compatible_release=False,  # No upper bound
+        use_exact_match=False,  # Not exact match
+    ),
+)