Merge branch 'main' into wasm-agent

Author: mariofusco

_posts/2025-06-27-a2a-project-launches-java-sdk.adoc

@@ -229,7 +229,7 @@ complex workflows between multiple agents. You can find more details
 about task management and many other features in the *https://github.com/a2aproject/a2a-java[A2A Java SDK]* repository's.
 
 You just want more code? Are you interested to see interoperability in action? Explore our
-https://github.com/a2aproject/a2a-samples/tree/main/samples/multi_language/python_and_java_multiagent[multi-language
+https://github.com/a2aproject/a2a-samples/tree/main/samples/python/hosts/weather_and_airbnb_planner[multi-language
 sample implementation,] which demonstrates how Python and Java
 agents collaborate seamlessly. See this picture for a bird-eye overview, 
 and checkout the code for more insights
@@ -274,7 +274,7 @@ Ready to dive in? Here’s your roadmap:
 https://github.com/a2aproject/a2a-java[github.com/a2aproject/a2a-java]
 to examine the implementation +
 . *Study Real Examples*: Check out the
-https://github.com/a2aproject/a2a-samples/tree/main/samples/multi_language/python_and_java_multiagent[multi-language
+https://github.com/a2aproject/a2a-samples/tree/main/samples/python/hosts/weather_and_airbnb_planner[multi-language
 samples] to see interoperability in action +
 . *Join the Community*: Connect with fellow developers in the A2A
 ecosystem +

_posts/2025-07-09-quarkus-and-a2a-java-sdk.adoc

@@ -230,7 +230,7 @@ $ mvn quarkus:dev
 
 We've gone from a Quarkus LangChain4j AI service to an A2A server agent in just a few steps!
 
-The source code for this example is available https://github.com/a2aproject/a2a-samples/tree/main/samples/multi_language/python_and_java_multiagent/weather_agent[here].
+The source code for this example is available https://github.com/a2aproject/a2a-samples/tree/main/samples/java/agents/weather_mcp[here].
 
 == Validating our A2A Server Agent Using the A2A Inspector
 
@@ -254,13 +254,13 @@ image::multiagent-java-python.png[scaledwidth=100%]
 
 This is a multi-agent example where a host agent delegates requests to two different A2A server agents, an Airbnb agent and our Weather agent, based on the user's question. Under the hood, the host agent makes use of each agent's agent card to determine the capabilities of each agent and uses an LLM to determine which agent to delegate the request to based on their capabilities.
 
-The https://github.com/a2aproject/a2a-samples/tree/main/samples/multi_language/python_and_java_multiagent/airbnb_agent[Airbnb agent] is a Python agent that's implemented using LangGraph and makes use of the A2A Python SDK.
+The https://github.com/a2aproject/a2a-samples/tree/main/samples/python/agents/airbnb_planner_multiagent/airbnb_agent[Airbnb agent] is a Python agent that's implemented using LangGraph and makes use of the A2A Python SDK.
 
-The https://github.com/a2aproject/a2a-samples/tree/main/samples/multi_language/python_and_java_multiagent/weather_agent[Weather agent] is our Java agent that's implemented using Quarkus LangChain4j and makes use of the A2A Java SDK.
+The https://github.com/a2aproject/a2a-samples/tree/main/samples/java/agents/weather_mcp[Weather agent] is our Java agent that's implemented using Quarkus LangChain4j and makes use of the A2A Java SDK.
 
 Notice that the host agent uses A2A clients written in Python to communicate with the server agents. It's also possible to use an https://github.com/a2aproject/a2a-java?tab=readme-ov-file#a2a-client[A2A client] written in Java using our A2A Java SDK.
 
-The complete source code for this example is available https://github.com/a2aproject/a2a-samples/tree/main/samples/multi_language/python_and_java_multiagent[here]. To experiment with this multi-agent example, try sending different types of questions to the host agent, for example:
+The complete source code for this example is available https://github.com/a2aproject/a2a-samples/tree/main/samples/python/hosts/weather_and_airbnb_planner[here]. To experiment with this multi-agent example, try sending different types of questions to the host agent, for example:
 
 * What's the weather in New York, NY?
 * Find me a room in LA, CA, July 7-9, 2 adults

_versions/main/guides/_attributes.adoc

@@ -10,7 +10,7 @@
 :graalvm-flavor: jdk-21
 :mandrel-flavor: jdk-21
 :surefire-version: 3.5.4
-:gradle-version: 9.1.0
+:gradle-version: 9.2.1
 :elasticsearch-version: 9.1.5
 :elasticsearch-image: docker.io/elastic/elasticsearch:9.1.5
 :opensearch-image: docker.io/opensearchproject/opensearch:3.1.0

_versions/main/guides/security-oidc-bearer-token-authentication-tutorial.adoc

@@ -198,14 +198,33 @@ For more information, see the <<bearer-token-tutorial-keycloak-dev-mode>> sectio
 For more information, see the Quarkus xref:security-oidc-configuration-properties-reference.adoc[OpenID Connect (OIDC) configuration properties] guide.
 
 
-== Start and configure the Keycloak server
+[[bearer-token-tutorial-keycloak-dev-mode]]
+== Run the application in dev mode
 
-. Put the link:{quickstarts-tree-url}/security-openid-connect-quickstart/config/quarkus-realm.json[realm configuration file] on the classpath (`target/classes` directory) so that it gets imported automatically when running in dev mode.
-You do not need to do this if you have already built a link:{quickstarts-tree-url}/security-openid-connect-quickstart[complete solution], in which case, this realm file is added to the classpath during the build.
+Put the link:{quickstarts-tree-url}/security-openid-connect-quickstart/config/quarkus-realm.json[realm configuration file] in the `src/main/resources` application folder so that it gets copied to the classpath and imported automatically to Keycloak. You do not need to do this if you have already built a link:{quickstarts-tree-url}/security-openid-connect-quickstart[complete solution], in which case, this realm file is added to the classpath during the build.
+
+. To run the application in dev mode, run the following commands:
 +
+====
+include::{includes}/devtools/dev.adoc[]
+====
+* xref:security-openid-connect-dev-services.adoc[Dev Services for Keycloak] will start a Keycloak container and import a `quarkus-realm.json`.
+. Open a xref:dev-ui.adoc[Dev UI], which you can find at http://localhost:8080/q/dev-ui[/q/dev-ui].
+Then, in an `OpenID Connect` card, click the `Keycloak provider` link .
+. When prompted to log in to a `Single Page Application` provided by `OpenID Connect Dev UI`, do the following steps:
+
+ * Log in as `alice` (password: `alice`), who has a `user` role.
+ ** Accessing `/api/admin` returns a `403` status code.
+ ** Accessing `/api/users/me` returns a `200` status code.
+ * Log out and log in again as `admin` (password: `admin`), who has both `admin` and `user` roles.
+ ** Accessing `/api/admin` returns a `200` status code.
+ ** Accessing `/api/users/me` returns a `200` status code.
+
+== Start and configure the Keycloak server
+
 [NOTE]
 ====
-Do not start the Keycloak server when you run the application in dev mode; `Dev Services for Keycloak` will start a container.
+Do not start the Keycloak server when you <<bearer-token-tutorial-keycloak-dev-mode,run the application in dev mode>>; `Dev Services for Keycloak` will start and configure a container.
 For more information, see the <<bearer-token-tutorial-keycloak-dev-mode>> section.
 ====
 +
@@ -245,31 +264,8 @@ For more information, see the xref:security-keycloak-admin-client.adoc[Quarkus K
 endif::no-quarkus-keycloak-admin-client[]
 
 
-
-[[bearer-token-tutorial-keycloak-dev-mode]]
-== Run the application in dev mode
-
-. To run the application in dev mode, run the following commands:
-+
-====
-include::{includes}/devtools/dev.adoc[]
-====
-* xref:security-openid-connect-dev-services.adoc[Dev Services for Keycloak] will start a Keycloak container and import a `quarkus-realm.json`.
-. Open a xref:dev-ui.adoc[Dev UI], which you can find at http://localhost:8080/q/dev-ui[/q/dev-ui].
-Then, in an `OpenID Connect` card, click the `Keycloak provider` link .
-. When prompted to log in to a `Single Page Application` provided by `OpenID Connect Dev UI`, do the following steps:
-
- * Log in as `alice` (password: `alice`), who has a `user` role.
- ** Accessing `/api/admin` returns a `403` status code.
- ** Accessing `/api/users/me` returns a `200` status code.
- * Log out and log in again as `admin` (password: `admin`), who has both `admin` and `user` roles.
- ** Accessing `/api/admin` returns a `200` status code.
- ** Accessing `/api/users/me` returns a `200` status code.
-
 == Run the Application in JVM mode
 
-When you are done with dev mode, you can run the application as a standard Java application.
-
 . Compile the application:
 +
 ====