Package io.a2a.spec

Class InvalidAgentResponseError

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.a2a.spec.A2AError

io.a2a.spec.A2AProtocolError

io.a2a.spec.InvalidAgentResponseError

All Implemented Interfaces:

Event, Serializable

public class InvalidAgentResponseError
extends A2AProtocolError

A2A Protocol error indicating that an agent returned a response not conforming to protocol specifications.

This error is typically raised by client implementations when validating agent responses. It indicates that the agent's response structure, content, or format violates the A2A Protocol requirements for the invoked method.

Common violations:

• Missing required fields in response objects
• Invalid field types or values
• Malformed event stream data
• Response doesn't match declared agent capabilities

Corresponds to A2A-specific error code -32006.

Usage example:

 SendMessageResponse response = client.sendMessage(request);
 if (response.task() == null) {
     throw new InvalidAgentResponseError(
         null,
         "Response missing required 'task' field",
         null
     );
 }
 

See Also:

• A2A Protocol Specification
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
InvalidAgentResponseError(@Nullable Integer code, @Nullable String message, @Nullable Object data)	Constructs an invalid agent response error.

Method Summary

Methods inherited from class io.a2a.spec.A2AProtocolError

getUrl

Methods inherited from class io.a2a.spec.A2AError

getCode, getData

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

InvalidAgentResponseError

public InvalidAgentResponseError(@Nullable Integer code,
 @Nullable String message,
 @Nullable Object data)

Constructs an invalid agent response error.

Parameters:

code - the error code

message - the error message

data - additional error data