This is an automated email from the ASF dual-hosted git repository.
jamesnetherton pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel-quarkus.git
The following commit(s) were added to refs/heads/main by this push:
new 8082699cd2 Add protocol binding limitations notice to A2A extension
docs
8082699cd2 is described below
commit 8082699cd226a0134bc45fc1b613126e883df347
Author: James Netherton <[email protected]>
AuthorDate: Thu Aug 20 07:03:32 2026 +0100
Add protocol binding limitations notice to A2A extension docs
---
docs/modules/ROOT/pages/reference/extensions/a2a.adoc | 14 ++++++++++++++
extensions/a2a/runtime/src/main/doc/limitations.adoc | 8 ++++++++
2 files changed, 22 insertions(+)
diff --git a/docs/modules/ROOT/pages/reference/extensions/a2a.adoc
b/docs/modules/ROOT/pages/reference/extensions/a2a.adoc
index f73dfbc699..9afd3868a3 100644
--- a/docs/modules/ROOT/pages/reference/extensions/a2a.adoc
+++ b/docs/modules/ROOT/pages/reference/extensions/a2a.adoc
@@ -59,3 +59,17 @@ quarkus.native.resources.includes=cards/*.json
More information about selecting resources for inclusion in the native
executable can be found at
xref:user-guide/native-mode.adoc#embedding-resource-in-native-executable[Embedding
resources in native executable].
+
+[id="extensions-a2a-camel-quarkus-limitations"]
+== Camel Quarkus limitations
+
+[id="extensions-a2a-limitations-http-json-protocol-binding-not-supported"]
+=== `HTTP+JSON` protocol binding not supported
+
+The xref:{cq-camel-components}::a2a-component.adoc[A2A component] supports two
protocol bindings: `JSONRPC` and `HTTP+JSON`.
+Only the `JSONRPC` binding works with the default Quarkus HTTP server (Vert.x
/ `platform-http`).
+
+The `HTTP+JSON` binding uses A2A custom-method paths that contain colons, such
as `/message:send`.
+Vert.x Web does not support colon characters in URI path segments, causing
these routes to fail.
+
+
diff --git a/extensions/a2a/runtime/src/main/doc/limitations.adoc
b/extensions/a2a/runtime/src/main/doc/limitations.adoc
new file mode 100644
index 0000000000..b50c03a9f8
--- /dev/null
+++ b/extensions/a2a/runtime/src/main/doc/limitations.adoc
@@ -0,0 +1,8 @@
+=== `HTTP+JSON` protocol binding not supported
+
+The xref:{cq-camel-components}::a2a-component.adoc[A2A component] supports two
protocol bindings: `JSONRPC` and `HTTP+JSON`.
+Only the `JSONRPC` binding works with the default Quarkus HTTP server (Vert.x
/ `platform-http`).
+
+The `HTTP+JSON` binding uses A2A custom-method paths that contain colons, such
as `/message:send`.
+Vert.x Web does not support colon characters in URI path segments, causing
these routes to fail.
+
