Allow to configure A2A protocol version from the AgentCard

Author: luis5tb

docs/a2a_protocol.md

@@ -86,6 +86,7 @@ Create a separate `agent_card.yaml` file with the agent card configuration:
 # agent_card.yaml
 name: "Lightspeed AI Assistant"
 description: "An AI assistant for OpenShift and Kubernetes"
+protocolVersion: "0.3.0"  # A2A protocol version (default: "0.3.0")
 provider:
   organization: "Red Hat"
   url: "https://redhat.com"
@@ -128,6 +129,7 @@ customization:
   agent_card_config:
     name: "My AI Assistant"
     description: "An AI assistant for helping with various tasks"
+    protocolVersion: "0.3.0"  # A2A protocol version (default: "0.3.0")
     provider:
       organization: "My Organization"
       url: "https://myorg.example.com"
@@ -266,7 +268,7 @@ The agent card describes the agent's capabilities:
   "version": "1.0.0",
   "url": "https://example.com/a2a",
   "documentation_url": "https://example.com/docs",
-  "protocol_version": "0.2.1",
+  "protocol_version": "0.3.0",
   "provider": {
     "organization": "Red Hat",
     "url": "https://redhat.com"
@@ -298,6 +300,8 @@ The agent card describes the agent's capabilities:
 }
 ```
 
+**Note:** The `protocol_version` field can be configured via the `protocolVersion` setting in your agent card configuration (see [Agent Card Configuration](#agent-card-configuration) section above).
+
 ## How the Executor Works
 
 ### A2AAgentExecutor
@@ -710,7 +714,16 @@ Check logs for entries from `app.endpoints.handlers` logger.
 
 ## Protocol Version
 
-This implementation supports A2A protocol version **0.2.1**.
+The A2A protocol version can be configured in the agent card configuration file using the `protocolVersion` field. If not specified, it defaults to **0.3.0**.
+
+To set a specific protocol version, add it to your agent card configuration:
+
+```yaml
+# In agent_card.yaml or customization.agent_card_config
+protocolVersion: "0.3.0"
+```
+
+The protocol version is included in the agent card response and indicates which version of the A2A protocol specification the agent implements.
 
 ## References
 

src/app/endpoints/a2a.py

@@ -584,7 +584,7 @@ def get_lightspeed_agent_card() -> AgentCard:
         default_input_modes=config.get("defaultInputModes", ["text/plain"]),
         default_output_modes=config.get("defaultOutputModes", ["text/plain"]),
         capabilities=capabilities,
-        protocol_version="0.2.1",
+        protocol_version=config.get("protocolVersion", "0.3.0"),
         security=config.get("security", [{"bearer": []}]),
         security_schemes=config.get("security_schemes", {}),
     )
@@ -845,6 +845,6 @@ async def a2a_health_check() -> dict[str, str]:
         "status": "healthy",
         "service": "lightspeed-a2a",
         "version": __version__,
-        "a2a_sdk_version": "0.2.1",
-        "timestamp": datetime.now().isoformat(),
+        "a2a_sdk_version": "0.3.4",
+        "timestamp": datetime.now(timezone.utc).isoformat(),
     }

tests/unit/app/endpoints/test_a2a.py

@@ -352,7 +352,7 @@ def test_get_agent_card_with_config(
         assert agent_card.name == "Test Agent"
         assert agent_card.description == "A test agent"
         assert agent_card.url == "http://localhost:8080/a2a"
-        assert agent_card.protocol_version == "0.2.1"
+        assert agent_card.protocol_version == "0.3.0"  # Default protocol version
 
         # Check provider
         assert agent_card.provider is not None
@@ -367,6 +367,63 @@ def test_get_agent_card_with_config(
         assert agent_card.capabilities is not None
         assert agent_card.capabilities.streaming is True
 
+    def test_get_agent_card_with_custom_protocol_version(
+        self, mocker: MockerFixture
+    ) -> None:
+        """Test getting agent card with custom protocol version."""
+        config_dict: dict[Any, Any] = {
+            "name": "test",
+            "service": {
+                "host": "localhost",
+                "port": 8080,
+                "auth_enabled": False,
+                "base_url": "http://localhost:8080",
+            },
+            "llama_stack": {
+                "api_key": "test-key",
+                "url": "http://test.com:1234",
+                "use_as_library_client": False,
+            },
+            "user_data_collection": {},
+            "mcp_servers": [],
+            "customization": {
+                "agent_card_config": {
+                    "name": "Test Agent",
+                    "description": "A test agent",
+                    "protocolVersion": "0.2.1",  # Custom protocol version
+                    "provider": {
+                        "organization": "Test Org",
+                        "url": "https://test.org",
+                    },
+                    "skills": [
+                        {
+                            "id": "test-skill",
+                            "name": "Test Skill",
+                            "description": "A test skill",
+                            "tags": ["test"],
+                            "inputModes": ["text/plain"],
+                            "outputModes": ["text/plain"],
+                        }
+                    ],
+                    "capabilities": {
+                        "streaming": True,
+                        "pushNotifications": False,
+                        "stateTransitionHistory": False,
+                    },
+                }
+            },
+            "authentication": {"module": "noop"},
+            "authorization": {"access_rules": []},
+            "a2a_state": {},
+        }
+        cfg = AppConfig()
+        cfg.init_from_dict(config_dict)
+        mocker.patch("app.endpoints.a2a.configuration", cfg)
+
+        agent_card = get_lightspeed_agent_card()
+
+        assert agent_card.protocol_version == "0.2.1"  # Custom version used
+
     def test_get_agent_card_without_config_raises_error(
         self,
         setup_minimal_configuration: AppConfig,  # pylint: disable=unused-argument