chore: fixing javadoc

Signed-off-by: Emmanuel Hugonnet <ehugonne@redhat.com>

Author: ehsavoie

spec/src/main/java/io/a2a/json/JsonUtil.java

@@ -87,7 +87,6 @@ private static GsonBuilder createBaseGsonBuilder() {
      * <p>
      * Used throughout the SDK for consistent JSON serialization and deserialization.
      *
-     * @see GsonFactory#createGson()
      */
     public static final Gson OBJECT_MAPPER = createBaseGsonBuilder()
             .registerTypeHierarchyAdapter(Part.class, new PartTypeAdapter())

spec/src/main/java/io/a2a/spec/AgentCapabilities.java

@@ -4,6 +4,11 @@
 
 /**
  * Defines optional capabilities supported by an agent.
+ *
+ * @param streaming whether the agent supports streaming responses
+ * @param pushNotifications whether the agent supports push notifications
+ * @param stateTransitionHistory whether the agent supports state transition history
+ * @param extensions optional list of protocol extensions supported by the agent
  */
 public record AgentCapabilities(boolean streaming, boolean pushNotifications, boolean stateTransitionHistory,
                                 List<AgentExtension> extensions) {

spec/src/main/java/io/a2a/spec/AgentCard.java

@@ -10,6 +10,25 @@
  * The AgentCard is a self-describing manifest for an agent. It provides essential
  * metadata including the agent's identity, capabilities, skills, supported
  * communication methods, and security requirements.
+ *
+ * @param name the human-readable name of the agent
+ * @param description a human-readable description of the agent
+ * @param url the URL of the agent's primary endpoint
+ * @param provider the organization or individual providing the agent
+ * @param version the version of the agent
+ * @param documentationUrl optional URL to the agent's documentation
+ * @param capabilities the capabilities supported by the agent
+ * @param defaultInputModes the default input content modes supported by the agent
+ * @param defaultOutputModes the default output content modes supported by the agent
+ * @param skills the list of skills the agent can perform
+ * @param supportsAuthenticatedExtendedCard whether the agent supports an authenticated extended card
+ * @param securitySchemes the security scheme definitions available for this agent
+ * @param security the security requirements for accessing the agent
+ * @param iconUrl optional URL to the agent's icon
+ * @param additionalInterfaces additional transport/URL combinations for interacting with the agent
+ * @param preferredTransport the preferred transport protocol
+ * @param protocolVersion the A2A protocol version supported by the agent
+ * @param signatures optional JWS signatures of the agent card
  */
 public record AgentCard(String name, String description, String url, AgentProvider provider,
                         String version, String documentationUrl, AgentCapabilities capabilities,

spec/src/main/java/io/a2a/spec/AgentCardSignature.java

@@ -8,6 +8,10 @@
 /**
  * Represents a JWS signature of an AgentCard.
  * This follows the JSON format of an RFC 7515 JSON Web Signature (JWS).
+ *
+ * @param header the JWS unprotected header
+ * @param protectedHeader the JWS protected header (base64url-encoded)
+ * @param signature the JWS signature value (base64url-encoded)
  */
 public record AgentCardSignature(Map<String, Object> header, @SerializedName("protected")String protectedHeader,
                                  String signature) {

spec/src/main/java/io/a2a/spec/AgentExtension.java

@@ -6,6 +6,11 @@
 
 /**
  * A declaration of a protocol extension supported by an Agent.
+ *
+ * @param description a human-readable description of the extension
+ * @param params optional parameters for configuring the extension
+ * @param required whether the extension is required for the agent to function
+ * @param uri the URI identifying the extension
  */
 public record AgentExtension (String description, Map<String, Object> params, boolean required, String uri) {
 

spec/src/main/java/io/a2a/spec/AgentInterface.java

@@ -5,8 +5,10 @@
 
 /**
  * Declares a combination of a target URL and a transport protocol for interacting with the agent.
+ *
+ * @param transport the transport protocol identifier (e.g., "jsonrpc", "grpc")
+ * @param url the endpoint URL for this transport
  */
-
 public record AgentInterface(String transport, String url) {
     public AgentInterface {
         Assert.checkNotNullParam("transport", transport);

spec/src/main/java/io/a2a/spec/AgentProvider.java

@@ -4,6 +4,9 @@
 
 /**
  * Represents the service provider of an agent.
+ *
+ * @param organization the name of the organization providing the agent
+ * @param url the URL of the provider's website or documentation
  */
 public record AgentProvider(String organization, String url) {
 

spec/src/main/java/io/a2a/spec/AgentSkill.java

@@ -7,6 +7,15 @@
 
 /**
  * The set of skills, or distinct capabilities, that the agent can perform.
+ *
+ * @param id a unique identifier for the skill
+ * @param name the human-readable name of the skill
+ * @param description a human-readable description of the skill
+ * @param tags tags for categorizing or discovering the skill
+ * @param examples example prompts or use cases for the skill
+ * @param inputModes the content modes accepted as input by the skill
+ * @param outputModes the content modes produced as output by the skill
+ * @param security optional security requirements specific to this skill
  */
 public record AgentSkill(String id, String name, String description, List<String> tags,
                          List<String> examples, List<String> inputModes, List<String> outputModes,

spec/src/main/java/io/a2a/spec/Artifact.java

@@ -7,6 +7,13 @@
 
 /**
  * Represents a file, data structure, or other resource generated by an agent during a task.
+ *
+ * @param artifactId a unique identifier for the artifact within the task
+ * @param name optional human-readable name of the artifact
+ * @param description optional human-readable description of the artifact
+ * @param parts the content parts that make up the artifact
+ * @param metadata optional additional metadata associated with the artifact
+ * @param extensions optional list of protocol extension identifiers
  */
 public record Artifact(String artifactId, String name, String description, List<Part<?>> parts, Map<String, Object> metadata,
                        List<String> extensions) {

spec/src/main/java/io/a2a/spec/AuthenticationInfo.java

@@ -6,6 +6,9 @@
 
 /**
  * The authentication info for an agent.
+ *
+ * @param schemes the list of authentication scheme identifiers
+ * @param credentials optional credentials string for the authentication scheme
  */
 public record AuthenticationInfo(List<String> schemes, String credentials) {