Merge branch 'no-lifetime' of https://github.com/racinmat/a2a-python into no-lifetime

Author: racinmat

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.2.15](https://github.com/a2aproject/a2a-python/compare/v0.2.14...v0.2.15) (2025-07-21)
+
+
+### Bug Fixes
+
+* Add Input Validation for Empty Message Content ([#327](https://github.com/a2aproject/a2a-python/issues/327)) ([5061834](https://github.com/a2aproject/a2a-python/commit/5061834e112a4eb523ac505f9176fc42d86d8178))
+* Prevent import grpc issues for Client after making dependencies optional ([#330](https://github.com/a2aproject/a2a-python/issues/330)) ([53ad485](https://github.com/a2aproject/a2a-python/commit/53ad48530b47ef1cbd3f40d0432f9170b663839d)), closes [#326](https://github.com/a2aproject/a2a-python/issues/326)
+
+## [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

src/a2a/client/__init__.py

@@ -1,5 +1,7 @@
 """Client-side components for interacting with an A2A agent."""
 
+import logging
+
 from a2a.client.auth import (
     AuthInterceptor,
     CredentialService,
@@ -12,11 +14,31 @@
     A2AClientJSONError,
     A2AClientTimeoutError,
 )
-from a2a.client.grpc_client import A2AGrpcClient
 from a2a.client.helpers import create_text_message_object
 from a2a.client.middleware import ClientCallContext, ClientCallInterceptor
 
 
+logger = logging.getLogger(__name__)
+
+try:
+    from a2a.client.grpc_client import A2AGrpcClient  # type: ignore
+except ImportError as e:
+    _original_error = e
+    logger.debug(
+        'A2AGrpcClient not loaded. This is expected if gRPC dependencies are not installed. Error: %s',
+        _original_error,
+    )
+
+    class A2AGrpcClient:  # type: ignore
+        """Placeholder for A2AGrpcClient when dependencies are not installed."""
+
+        def __init__(self, *args, **kwargs):
+            raise ImportError(
+                'To use A2AGrpcClient, its dependencies must be installed. '
+                'You can install them with \'pip install "a2a-sdk[grpc]"\''
+            ) from _original_error
+
+
 __all__ = [
     'A2ACardResolver',
     'A2AClient',

src/a2a/client/grpc_client.py

@@ -2,7 +2,16 @@
 
 from collections.abc import AsyncGenerator
 
-import grpc
+
+try:
+    import grpc
+except ImportError as e:
+    raise ImportError(
+        'A2AGrpcClient requires grpcio and grpcio-tools to be installed. '
+        'Install with: '
+        "'pip install a2a-sdk[grpc]'"
+    ) from e
+
 
 from a2a.grpc import a2a_pb2, a2a_pb2_grpc
 from a2a.types import (

src/a2a/server/request_handlers/__init__.py

@@ -23,6 +23,7 @@
     _original_error = e
     logger.debug(
         'GrpcHandler not loaded. This is expected if gRPC dependencies are not installed. Error: %s',
+        _original_error,
     )
 
     class GrpcHandler:  # type: ignore