Merge branch 'main' into snake-case-field

Author: holtskinner

.github/workflows/unit-tests.yml

@@ -55,7 +55,7 @@ jobs:
         run: |
           echo "$HOME/.cargo/bin" >> $GITHUB_PATH
       - name: Install dependencies
-        run: uv sync --dev --extra sql --extra encryption
+        run: uv sync --dev --extra sql --extra encryption --extra grpc
       - name: Run tests and check coverage
         run: uv run pytest --cov=a2a --cov-report=xml --cov-fail-under=89
       - name: Show coverage summary in log

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.2.14](https://github.com/a2aproject/a2a-python/compare/v0.2.13...v0.2.14) (2025-07-18)
+
+
+### Features
+
+* Set grpc dependencies as optional ([#322](https://github.com/a2aproject/a2a-python/issues/322)) ([365f158](https://github.com/a2aproject/a2a-python/commit/365f158f87166838b55bdadd48778cb313a453e1))
+* **spec:** Update A2A types from specification 🤖 ([#325](https://github.com/a2aproject/a2a-python/issues/325)) ([02e7a31](https://github.com/a2aproject/a2a-python/commit/02e7a3100e000e115b4aeec7147cf8fc1948c107))
+
 ## [0.2.13](https://github.com/a2aproject/a2a-python/compare/v0.2.12...v0.2.13) (2025-07-17)
 
 

README.md

@@ -11,7 +11,7 @@
    <h2 align="center">
    <img src="https://raw.githubusercontent.com/a2aproject/A2A/refs/heads/main/docs/assets/a2a-logo-black.svg" width="256" alt="A2A Logo"/>
    </h2>
-   <h3 align="center">A Python library that helps run agentic applications as A2AServers following the <a href="https://a2aproject.github.io/A2A">Agent2Agent (A2A) Protocol</a>.</h3>
+   <h3 align="center">A Python library that helps run agentic applications as A2AServers following the <a href="https://a2a-protocol.org">Agent2Agent (A2A) Protocol</a>.</h3>
 </html>
 
 <!-- markdownlint-enable no-inline-html -->
@@ -33,6 +33,12 @@ When you're working within a uv project or a virtual environment managed by uv,
 uv add a2a-sdk
 ```
 
+To install with gRPC support:
+
+```bash
+uv add "a2a-sdk[grpc]"
+```
+
 To install with database support:
 
 ```bash
@@ -57,6 +63,12 @@ If you prefer to use pip, the standard Python package installer, you can install
 pip install a2a-sdk
 ```
 
+To install with gRPC support:
+
+```bash
+pip install "a2a-sdk[grpc]"
+```
+
 To install with database support:
 
 ```bash

pyproject.toml

@@ -11,16 +11,11 @@ dependencies = [
   "fastapi>=0.115.2",
   "httpx>=0.28.1",
   "httpx-sse>=0.4.0",
-  "google-api-core>=1.26.0",
   "opentelemetry-api>=1.33.0",
   "opentelemetry-sdk>=1.33.0",
   "pydantic>=2.11.3",
   "sse-starlette",
-  "starlette",
-  "grpcio>=1.60",
-  "grpcio-tools>=1.60",
-  "grpcio_reflection>=1.7.0",
-  "protobuf==5.29.5",
+  "starlette"
 ]
 
 classifiers = [
@@ -42,6 +37,7 @@ mysql = ["sqlalchemy[asyncio,aiomysql]>=2.0.0"]
 sqlite = ["sqlalchemy[asyncio,aiosqlite]>=2.0.0"]
 sql = ["sqlalchemy[asyncio,postgresql-asyncpg,aiomysql,aiosqlite]>=2.0.0"]
 encryption = ["cryptography>=43.0.0"]
+grpc = ["grpcio>=1.60", "grpcio-tools>=1.60", "grpcio_reflection>=1.7.0", "protobuf==5.29.5", "google-api-core>=1.26.0"]
 
 [project.urls]
 homepage = "https://a2aproject.github.io/A2A/"

src/a2a/server/request_handlers/__init__.py

@@ -1,9 +1,10 @@
 """Request handler components for the A2A server."""
 
+import logging
+
 from a2a.server.request_handlers.default_request_handler import (
     DefaultRequestHandler,
 )
-from a2a.server.request_handlers.grpc_handler import GrpcHandler
 from a2a.server.request_handlers.jsonrpc_handler import JSONRPCHandler
 from a2a.server.request_handlers.request_handler import RequestHandler
 from a2a.server.request_handlers.response_helpers import (
@@ -12,6 +13,28 @@
 )
 
 
+logger = logging.getLogger(__name__)
+
+try:
+    from a2a.server.request_handlers.grpc_handler import (
+        GrpcHandler,  # type: ignore
+    )
+except ImportError as e:
+    _original_error = e
+    logger.debug(
+        'GrpcHandler not loaded. This is expected if gRPC dependencies are not installed. Error: %s',
+    )
+
+    class GrpcHandler:  # type: ignore
+        """Placeholder for GrpcHandler when dependencies are not installed."""
+
+        def __init__(self, *args, **kwargs):
+            raise ImportError(
+                'To use GrpcHandler, its dependencies must be installed. '
+                'You can install them with \'pip install "a2a-sdk[grpc]"\''
+            ) from _original_error
+
+
 __all__ = [
     'DefaultRequestHandler',
     'GrpcHandler',

src/a2a/server/request_handlers/grpc_handler.py

@@ -5,8 +5,16 @@
 from abc import ABC, abstractmethod
 from collections.abc import AsyncIterable
 
-import grpc
-import grpc.aio
+
+try:
+    import grpc
+    import grpc.aio
+except ImportError as e:
+    raise ImportError(
+        'GrpcHandler requires grpcio and grpcio-tools to be installed. '
+        'Install with: '
+        "'pip install a2a-sdk[grpc]'"
+    ) from e
 
 import a2a.grpc.a2a_pb2_grpc as a2a_grpc