fix: address pr comments

Author: jer96

pyproject.toml

@@ -108,6 +108,7 @@ format-fix = [
 ]
 lint-check = [
     "ruff check",
+    # excluding due to A2A and OTEL http exporter dependency conflict
     "mypy -p src --exclude src/strands/multiagent"
 ]
 lint-fix = [
@@ -154,9 +155,11 @@ python = ["3.13", "3.12", "3.11", "3.10"]
 
 [tool.hatch.envs.hatch-test.scripts]
 run = [
+    # excluding due to A2A and OTEL http exporter dependency conflict
     "pytest{env:HATCH_TEST_ARGS:} {args} --ignore=tests/multiagent/a2a"
 ]
 run-cov = [
+    # excluding due to A2A and OTEL http exporter dependency conflict
     "pytest{env:HATCH_TEST_ARGS:} --cov --cov-config=pyproject.toml {args} --ignore=tests/multiagent/a2a"
 ]
 
@@ -192,6 +195,7 @@ prepare = [
     "hatch test --all"
 ]
 test-a2a = [
+    # required to run manually due to A2A and OTEL http exporter dependency conflict
     "hatch -e a2a run run {args}"
 ]
 

src/strands/agent/agent.py

@@ -217,8 +217,8 @@ def __init__(
         load_tools_from_directory: bool = True,
         trace_attributes: Optional[Mapping[str, AttributeValue]] = None,
         *,
-        name: str | None = None,
-        description: str | None = None,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
     ):
         """Initialize the Agent with the specified configuration.
 

src/strands/multiagent/a2a/agent.py

@@ -18,7 +18,7 @@
 from ...agent.agent import Agent as SAAgent
 from .executor import StrandsA2AExecutor
 
-log = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 
 class A2AAgent:
@@ -29,7 +29,7 @@ def __init__(
         agent: SAAgent,
         *,
         # AgentCard
-        host: str = "0.0.0",
+        host: str = "0.0.0.0",
         port: int = 9000,
         version: str = "0.0.1",
     ):
@@ -39,7 +39,7 @@ def __init__(
             agent: The Strands Agent to wrap with A2A compatibility.
             name: The name of the agent, used in the AgentCard.
             description: A description of the agent's capabilities, used in the AgentCard.
-            host: The hostname or IP address to bind the A2A server to. Defaults to "localhost".
+            host: The hostname or IP address to bind the A2A server to. Defaults to "0.0.0.0".
             port: The port to bind the A2A server to. Defaults to 9000.
             version: The version of the agent. Defaults to "0.0.1".
         """
@@ -56,6 +56,7 @@ def __init__(
             agent_executor=StrandsA2AExecutor(self.strands_agent),
             task_store=InMemoryTaskStore(),
         )
+        logger.info("Strands' integration with A2A is experimental. Be aware of frequent breaking changes.")
 
     @property
     def public_agent_card(self) -> AgentCard:
@@ -135,14 +136,14 @@ def serve(self, app_type: Literal["fastapi", "starlette"] = "starlette", **kwarg
             **kwargs: Additional keyword arguments to pass to uvicorn.run.
         """
         try:
-            log.info("Starting Strands A2A server...")
+            logger.info("Starting Strands A2A server...")
             if app_type == "fastapi":
                 uvicorn.run(self.to_fastapi_app(), host=self.host, port=self.port, **kwargs)
             else:
                 uvicorn.run(self.to_starlette_app(), host=self.host, port=self.port, **kwargs)
         except KeyboardInterrupt:
-            log.warning("Strands A2A server shutdown requested (KeyboardInterrupt).")
+            logger.warning("Strands A2A server shutdown requested (KeyboardInterrupt).")
         except Exception:
-            log.exception("Strands A2A server encountered exception.")
+            logger.exception("Strands A2A server encountered exception.")
         finally:
-            log.info("Strands A2A server has shutdown.")
+            logger.info("Strands A2A server has shutdown.")