microsoft-teams-graph 2.0.0a9__tar.gz

microsoft_teams_graph-2.0.0a9/.gitignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+.copilot-instructions.md
+
+# other
+.DS_STORE
+*.bak
+*~
+*.tmp
+
+ref/
+py.typed
+CLAUDE.md
+
+.env.claude/
+.claude/
+
+examples/**/.vscode/
+examples/**/appPackage/
+examples/**/infra/
+examples/**/teamsapp*
+examples/**/aad.manifest.json
+
+# Node (from tab)
+node_modules
+dist/
+build/

microsoft_teams_graph-2.0.0a9/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: microsoft-teams-graph
+Version: 2.0.0a9
+Summary: The Graph package for a Microsoft Teams agent
+Author-email: Microsoft <TeamsAISDKFeedback@microsoft.com>
+License: MIT
+Keywords: agents,ai,bot,graph,microsoft,teams
+Requires-Python: <3.15,>=3.12
+Requires-Dist: azure-core>=1.31.0
+Requires-Dist: microsoft-teams-common
+Requires-Dist: msgraph-sdk<2.0.0,>=1.30.0
+Requires-Dist: pyjwt[crypto]>=2.10.0
+Description-Content-Type: text/markdown
+
+# Microsoft Teams Graph Integration
+
+<p>
+    <a href="https://pypi.org/project/microsoft-teams-graph" target="_blank">
+        <img src="https://img.shields.io/pypi/v/microsoft-teams-graph" />
+    </a>
+    <a href="https://pypi.org/project/microsoft-teams-graph" target="_blank">
+        <img src="https://img.shields.io/pypi/dw/microsoft-teams-graph" />
+    </a>
+</p>
+
+This package provides seamless access to Microsoft Graph APIs from Teams bots and agents built with the Microsoft Teams SDK for Python.
+
+<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>
+
+## Key Features
+
+- **Token Integration**: Unified token handling using the Token type from microsoft-teams-common
+- **Flexible Token Sources**: Supports strings, StringLike objects, callables, async callables, or None
+- **Automatic Token Resolution**: Leverages common resolve_token utility for consistent handling
+
+## Requirements
+
+- Teams SDK for Python
+- Microsoft Graph SDK for Python (msgraph-sdk)
+- Azure Core library (azure-core)
+- Microsoft Teams Common library (microsoft-teams-common)
+
+## Quick Start
+
+### Basic Usage with Teams Bot
+
+```python
+from microsoft_teams.graph import get_graph_client
+from microsoft_teams.apps import App, ActivityContext
+from microsoft_teams.api import MessageActivity
+
+app = App()
+
+@app.on_message
+async def handle_message(ctx: ActivityContext[MessageActivity]):
+    if not ctx.is_signed_in:
+        await ctx.sign_in()
+        return
+
+    # Create Graph client using user's token
+    graph = get_graph_client(ctx.user_token)
+
+    # Get user profile
+    me = await graph.me.get()
+    await ctx.send(f"Hello {me.display_name}!")
+
+    # Get user's Teams
+    teams = await graph.me.joined_teams.get()
+    if teams and teams.value:
+        team_names = [team.display_name for team in teams.value]
+        await ctx.send(f"You're in {len(team_names)} teams: {', '.join(team_names)}")
+```
+
+### Token Integration
+
+```python
+from microsoft_teams.common.http.client_token import Token
+
+def create_token_callable(ctx: ActivityContext) -> Token:
+    """Create a callable token that refreshes automatically."""
+    def get_fresh_token():
+        # This is called on each Graph API request
+        return ctx.user_token  # Always returns current valid token
+
+    return get_fresh_token
+
+# Use with Graph client
+graph = get_graph_client(create_token_callable(ctx))
+```
+
+        await ctx.sign_in()
+        return
+
+    # Use the user token that's already available in the context
+    graph = get_graph_client(ctx.user_token)
+
+    # Make Graph API calls
+    me = await graph.me.get()
+    await ctx.send(f"Hello {me.display_name}!")
+
+    # Make Graph API calls
+    me = await graph.me.get()
+    await ctx.send(f"Hello {me.display_name}!")
+
+````
+
+## Token Type Usage
+
+The package uses the Token type from microsoft-teams-common for flexible token handling. You can provide tokens in several formats:
+
+### String Token (Simplest)
+
+```python
+# Direct string token
+graph = get_graph_client("eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs...")
+````
+
+### Callable Token (Dynamic)
+
+```python
+def get_token():
+    """Callable that returns a string token."""
+    # Get your access token from wherever (Teams API, cache, etc.)
+    return get_access_token_from_somewhere()
+
+# Use the callable with get_graph_client
+graph = get_graph_client(get_token)
+```
+
+### Async Callable Token
+
+```python
+async def get_token_async():
+    """Async callable that returns a string token."""
+    # Fetch token asynchronously
+    token_response = await some_api_call()
+    return token_response.access_token
+
+graph = get_graph_client(get_token_async)
+```
+
+### Dynamic Token Retrieval
+
+```python
+def get_fresh_token():
+    """Callable that fetches a fresh token on each invocation."""
+    # This will be called each time the Graph client needs a token
+    fresh_token = fetch_latest_token_from_api()
+    return fresh_token
+
+graph = get_graph_client(get_fresh_token)
+```
+
+## Authentication
+
+The package uses Token-based authentication with automatic resolution through the common library. Teams tokens are pre-authorized through the OAuth connection configured in your Azure Bot registration.
+
+## API Usage Examples
+
+```python
+# Get user profile
+me = await graph.me.get()
+
+# Get recent emails with specific fields
+from msgraph.generated.users.item.messages.messages_request_builder import MessagesRequestBuilder
+
+query_params = MessagesRequestBuilder.MessagesRequestBuilderGetQueryParameters(
+    select=["subject", "from", "receivedDateTime"],
+    top=5
+)
+request_config = MessagesRequestBuilder.MessagesRequestBuilderGetRequestConfiguration(
+    query_parameters=query_params
+)
+messages = await graph.me.messages.get(request_configuration=request_config)
+```

microsoft_teams_graph-2.0.0a9/README.md

@@ -0,0 +1,163 @@
+# Microsoft Teams Graph Integration
+
+<p>
+    <a href="https://pypi.org/project/microsoft-teams-graph" target="_blank">
+        <img src="https://img.shields.io/pypi/v/microsoft-teams-graph" />
+    </a>
+    <a href="https://pypi.org/project/microsoft-teams-graph" target="_blank">
+        <img src="https://img.shields.io/pypi/dw/microsoft-teams-graph" />
+    </a>
+</p>
+
+This package provides seamless access to Microsoft Graph APIs from Teams bots and agents built with the Microsoft Teams SDK for Python.
+
+<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>
+
+## Key Features
+
+- **Token Integration**: Unified token handling using the Token type from microsoft-teams-common
+- **Flexible Token Sources**: Supports strings, StringLike objects, callables, async callables, or None
+- **Automatic Token Resolution**: Leverages common resolve_token utility for consistent handling
+
+## Requirements
+
+- Teams SDK for Python
+- Microsoft Graph SDK for Python (msgraph-sdk)
+- Azure Core library (azure-core)
+- Microsoft Teams Common library (microsoft-teams-common)
+
+## Quick Start
+
+### Basic Usage with Teams Bot
+
+```python
+from microsoft_teams.graph import get_graph_client
+from microsoft_teams.apps import App, ActivityContext
+from microsoft_teams.api import MessageActivity
+
+app = App()
+
+@app.on_message
+async def handle_message(ctx: ActivityContext[MessageActivity]):
+    if not ctx.is_signed_in:
+        await ctx.sign_in()
+        return
+
+    # Create Graph client using user's token
+    graph = get_graph_client(ctx.user_token)
+
+    # Get user profile
+    me = await graph.me.get()
+    await ctx.send(f"Hello {me.display_name}!")
+
+    # Get user's Teams
+    teams = await graph.me.joined_teams.get()
+    if teams and teams.value:
+        team_names = [team.display_name for team in teams.value]
+        await ctx.send(f"You're in {len(team_names)} teams: {', '.join(team_names)}")
+```
+
+### Token Integration
+
+```python
+from microsoft_teams.common.http.client_token import Token
+
+def create_token_callable(ctx: ActivityContext) -> Token:
+    """Create a callable token that refreshes automatically."""
+    def get_fresh_token():
+        # This is called on each Graph API request
+        return ctx.user_token  # Always returns current valid token
+
+    return get_fresh_token
+
+# Use with Graph client
+graph = get_graph_client(create_token_callable(ctx))
+```
+
+        await ctx.sign_in()
+        return
+
+    # Use the user token that's already available in the context
+    graph = get_graph_client(ctx.user_token)
+
+    # Make Graph API calls
+    me = await graph.me.get()
+    await ctx.send(f"Hello {me.display_name}!")
+
+    # Make Graph API calls
+    me = await graph.me.get()
+    await ctx.send(f"Hello {me.display_name}!")
+
+````
+
+## Token Type Usage
+
+The package uses the Token type from microsoft-teams-common for flexible token handling. You can provide tokens in several formats:
+
+### String Token (Simplest)
+
+```python
+# Direct string token
+graph = get_graph_client("eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs...")
+````
+
+### Callable Token (Dynamic)
+
+```python
+def get_token():
+    """Callable that returns a string token."""
+    # Get your access token from wherever (Teams API, cache, etc.)
+    return get_access_token_from_somewhere()
+
+# Use the callable with get_graph_client
+graph = get_graph_client(get_token)
+```
+
+### Async Callable Token
+
+```python
+async def get_token_async():
+    """Async callable that returns a string token."""
+    # Fetch token asynchronously
+    token_response = await some_api_call()
+    return token_response.access_token
+
+graph = get_graph_client(get_token_async)
+```
+
+### Dynamic Token Retrieval
+
+```python
+def get_fresh_token():
+    """Callable that fetches a fresh token on each invocation."""
+    # This will be called each time the Graph client needs a token
+    fresh_token = fetch_latest_token_from_api()
+    return fresh_token
+
+graph = get_graph_client(get_fresh_token)
+```
+
+## Authentication
+
+The package uses Token-based authentication with automatic resolution through the common library. Teams tokens are pre-authorized through the OAuth connection configured in your Azure Bot registration.
+
+## API Usage Examples
+
+```python
+# Get user profile
+me = await graph.me.get()
+
+# Get recent emails with specific fields
+from msgraph.generated.users.item.messages.messages_request_builder import MessagesRequestBuilder
+
+query_params = MessagesRequestBuilder.MessagesRequestBuilderGetQueryParameters(
+    select=["subject", "from", "receivedDateTime"],
+    top=5
+)
+request_config = MessagesRequestBuilder.MessagesRequestBuilderGetRequestConfiguration(
+    query_parameters=query_params
+)
+messages = await graph.me.messages.get(request_configuration=request_config)
+```

microsoft_teams_graph-2.0.0a9/pyproject.toml

@@ -0,0 +1,39 @@
+[project]
+name = "microsoft-teams-graph"
+version = "2.0.0a9"
+description = "The Graph package for a Microsoft Teams agent"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Microsoft", email = "TeamsAISDKFeedback@microsoft.com" }]
+keywords = ["microsoft", "teams", "ai", "bot", "agents", "graph"]
+requires-python = ">=3.12,<3.15"
+dependencies = [
+    "azure-core>=1.31.0",
+    "msgraph-sdk>=1.30.0,<2.0.0",
+    "microsoft-teams-common",
+    "pyjwt[crypto]>=2.10.0",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.4.0",
+    "pytest-asyncio>=1.0.0",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_paths = ["src"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/microsoft_teams", "src/microsoft"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src"]
+
+[tool.uv.sources]
+microsoft-teams-common = { workspace = true }

microsoft_teams_graph-2.0.0a9/src/microsoft/teams/graph/__init__.py

@@ -0,0 +1,26 @@
+"""
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+
+Backward compatibility shim for microsoft.teams.graph.
+
+
+DEPRECATED: This import path is deprecated and will be removed in version 2.0.0 GA.
+Please update your imports to use 'microsoft_teams.graph' instead.
+"""
+
+import sys
+import warnings
+
+warnings.warn(
+    "The 'microsoft.teams.graph' namespace is deprecated and will be removed in "
+    "version 2.0.0 GA. Please update your imports to 'microsoft_teams.graph'.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+from microsoft_teams.graph import *  # noqa: E402, F401, F403
+from microsoft_teams.graph import __all__  # noqa: E402, F401
+
+_new_module = sys.modules["microsoft_teams.graph"]
+sys.modules[__name__] = _new_module

microsoft_teams_graph-2.0.0a9/src/microsoft_teams/graph/__init__.py

@@ -0,0 +1,12 @@
+"""
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+"""
+
+from .auth_provider import AuthProvider
+from .graph import get_graph_client
+
+__all__ = [
+    "AuthProvider",
+    "get_graph_client",
+]

microsoft_teams_graph-2.0.0a9/src/microsoft_teams/graph/auth_provider.py

@@ -0,0 +1,87 @@
+"""
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+"""
+
+import asyncio
+import concurrent.futures
+import datetime
+import logging
+from typing import Any
+
+import jwt
+from azure.core.credentials import AccessToken, TokenCredential
+from azure.core.exceptions import ClientAuthenticationError
+from microsoft_teams.common.http.client_token import Token, resolve_token
+
+logger = logging.getLogger(__name__)
+
+
+class AuthProvider(TokenCredential):
+    """
+    Provides authentication for Microsoft Graph using Teams tokens.
+
+    """
+
+    def __init__(self, token: Token) -> None:
+        """
+        Initialize the AuthProvider.
+
+        Args:
+            token: Token data (string, StringLike, callable, or None)
+        """
+        self._token = token
+
+    def get_token(self, *scopes: str, **kwargs: Any) -> AccessToken:
+        """
+        Retrieve an access token for Microsoft Graph.
+
+        Args:
+            *scopes: Token scopes (required for interface compatibility)
+            **kwargs: Additional keyword arguments
+
+        Returns:
+            AccessToken: The access token for Microsoft Graph
+
+        Raises:
+            ClientAuthenticationError: If the token is invalid or authentication fails
+        """
+        try:
+            # Resolve the token using the common utility
+            try:
+                asyncio.get_running_loop()
+
+                with concurrent.futures.ThreadPoolExecutor() as executor:
+                    future = executor.submit(asyncio.run, resolve_token(self._token))
+                    token_str = future.result()
+            except RuntimeError:
+                token_str = asyncio.run(resolve_token(self._token))
+
+            if not token_str:
+                raise ClientAuthenticationError("Token resolved to None or empty string")
+
+            if not token_str.strip():
+                raise ClientAuthenticationError("Token contains only whitespace")
+
+            # Try to extract expiration from JWT, fallback to 1 hour default
+            try:
+                # Decode JWT without verification to extract expiration
+                payload = jwt.decode(token_str, algorithms=["RS256"], options={"verify_signature": False})
+                expires_on = payload.get("exp")
+                if not expires_on:
+                    # Fallback to 1 hour from now if no exp claim
+                    logger.debug("JWT token missing 'exp' claim, using 1-hour default expiration")
+                    now = datetime.datetime.now(datetime.timezone.utc)
+                    expires_on = int((now + datetime.timedelta(hours=1)).timestamp())
+            except Exception:
+                # Fallback to 1 hour from now if JWT decoding fails (e.g., not a JWT)
+                logger.debug("Token is not a valid JWT, using 1-hour default expiration")
+                now = datetime.datetime.now(datetime.timezone.utc)
+                expires_on = int((now + datetime.timedelta(hours=1)).timestamp())
+
+            return AccessToken(token=token_str, expires_on=expires_on)
+
+        except Exception as e:
+            if isinstance(e, ClientAuthenticationError):
+                raise
+            raise ClientAuthenticationError(f"Failed to resolve token: {str(e)}") from e

microsoft_teams_graph-2.0.0a9/src/microsoft_teams/graph/graph.py

@@ -0,0 +1,62 @@
+"""
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+"""
+
+from typing import Optional
+
+from azure.core.exceptions import ClientAuthenticationError
+from microsoft_teams.common.http.client_token import Token
+from msgraph.graph_service_client import GraphServiceClient
+
+from .auth_provider import AuthProvider
+
+
+def get_graph_client(token: Optional[Token] = None) -> GraphServiceClient:
+    """
+    Get a configured Microsoft Graph client using a Token.
+
+    Args:
+        token: Token data (string, StringLike, callable, or None). If None,
+               will raise ClientAuthenticationError with a clear message.
+
+    Returns:
+        GraphServiceClient: A configured client ready for Microsoft Graph API calls
+
+    Raises:
+        ClientAuthenticationError: If the token is None, invalid, or authentication fails
+
+    Example:
+        ```python
+        # Using a string token
+        graph = get_graph_client("eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs...")
+
+
+        # Using a callable that returns a string
+        def get_token():
+            return "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs..."
+
+
+        graph = get_graph_client(get_token)
+
+        # Make Graph API calls
+        me = await graph.me.get()
+        messages = await graph.me.messages.get()
+        ```
+    """
+    try:
+        # Provide a clear error message for None tokens
+        if token is None:
+            raise ClientAuthenticationError(
+                "Token cannot be None. Please provide a valid token (string, callable, or StringLike object) "
+                "to authenticate with Microsoft Graph."
+            )
+
+        credential = AuthProvider(token)
+        client = GraphServiceClient(credentials=credential)
+        return client
+
+    except Exception as e:
+        if isinstance(e, ClientAuthenticationError):
+            raise  # Re-raise authentication errors as-is
+        raise ClientAuthenticationError(f"Failed to create Microsoft Graph client: {str(e)}") from e