a2a 0.1.0 → 0.2.0

data/lib/a2a/types/agent_card.rb

@@ -1,39 +1,71 @@
 # frozen_string_literal: true
 
 module A2A
-  # Represents the metadata card for an agent, describing its properties and capabilities.
+  # 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.
   class AgentCard < ProtocolStruct
-    # @return [String] The name of the agent.
+    # @return [String] The version of the A2A protocol this agent supports.
+    attribute :protocol_version, Types::String.default('0.3.0')
+
+    # @return [String] A human-readable name for the agent.
     attribute :name, Types::String
 
-    # @return [String, nil] An optional description of the agent.
-    attribute? :description, Types::String.optional
+    # @return [String] A human-readable description of the agent, assisting users and other agents
+    #   in understanding its purpose.
+    attribute :description, Types::String
+
+    # @return [URI] The preferred endpoint URL for interacting with the agent.
+    #   This URL MUST support the transport specified by 'preferred_transport'.
+    attribute :url, Types::URI
+
+    # @return [String] The transport protocol for the preferred endpoint (the main 'url' field).
+    #   If not specified, defaults to 'JSONRPC'.
+    attribute? :preferred_transport, Types::String.default('JSONRPC')
+
+    # @return [Array<AgentInterface>, nil] A list of additional supported interfaces (transport and URL combinations).
+    #   This allows agents to expose multiple transports, potentially at different URLs.
+    attribute? :additional_interfaces, Types::Array.of(Types::Constructor(AgentInterface)).optional
 
-    # @return [String] The base URL endpoint for interacting with the agent.
-    attribute :url, Types::String
+    # @return [URI, nil] An optional URL to an icon for the agent.
+    attribute? :icon_url, Types::URI.optional
 
     # @return [AgentProvider, nil] Information about the provider of the agent.
     attribute? :provider, Types::Constructor(AgentProvider).optional
 
-    # @return [String] The version identifier for the agent or its API.
+    # @return [String] The agent's own version number. The format is defined by the provider.
     attribute :version, Types::String
 
-    # @return [String, nil] An optional URL pointing to the agent's documentation.
-    attribute? :documentation_url, Types::String.optional
+    # @return [URI, nil] An optional URL to the agent's documentation.
+    attribute? :documentation_url, Types::URI.optional
 
-    # @return [AgentCapabilities] The capabilities supported by the agent.
+    # @return [AgentCapabilities] A declaration of optional capabilities supported by the agent.
     attribute :capabilities, Types::Constructor(AgentCapabilities)
 
-    # @return [AgentAuthentication, nil] Authentication details required to interact with the agent.
-    attribute? :authentication, Types::Constructor(AgentAuthentication).optional
+    # @return [Hash<String, SecurityScheme>, nil] A declaration of the security schemes available to authorize requests.
+    #   The key is the scheme name. Follows the OpenAPI 3.0 Security Scheme Object.
+    attribute? :security_schemes, Types::Hash.map(Types::Symbol | Types::String, Types::Constructor(SecurityScheme)).optional
 
-    # @return [Array<String>] Default input modes supported by the agent (e.g., 'text', 'file', 'json').
-    attribute? :default_input_modes, Types::Array.of(Types::String).default(['text'].freeze)
+    # @return [Array<Hash>, nil] A list of security requirement objects that apply to all agent interactions.
+    #   Each object lists security schemes that can be used. Follows the OpenAPI 3.0 Security Requirement Object.
+    attribute? :security, Types::Array.of(Types::Hash.map(Types::String | Types::Symbol, Types::Array.of(Types::String))).optional
 
-    # @return [Array<String>] Default output modes supported by the agent (e.g., 'text', 'file', 'json').
-    attribute? :default_output_modes, Types::Array.of(Types::String).default(['text'].freeze)
+    # @return [Array<String>] Default set of supported input MIME types for all skills, which can be
+    #   overridden on a per-skill basis.
+    attribute :default_input_modes, Types::Array.of(Types::String)
 
-    # @return [Array<AgentSkill>] List of specific skills offered by the agent.
+    # @return [Array<String>] Default set of supported output MIME types for all skills, which can be
+    #   overridden on a per-skill basis.
+    attribute :default_output_modes, Types::Array.of(Types::String)
+
+    # @return [Array<AgentSkill>] The set of skills, or distinct capabilities, that the agent can perform.
     attribute :skills, Types::Array.of(Types::Constructor(AgentSkill))
+
+    # @return [Boolean] If true, the agent can provide an extended agent card with additional details
+    #   to authenticated users. Defaults to false.
+    attribute? :supports_authenticated_extended_card, Types::Bool.default(false)
+
+    # @return [Array<AgentCardSignature>, nil] JSON Web Signatures computed for this AgentCard.
+    attribute? :signatures, Types::Array.of(Types::Constructor(AgentCardSignature)).optional
   end
 end

data/lib/a2a/types/agent_card_signature.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module A2A
+  # AgentCardSignature represents a JWS signature of an AgentCard.
+  # This follows the JSON format of an RFC 7515 JSON Web Signature (JWS).
+  class AgentCardSignature < ProtocolStruct
+    # @return [String] The protected JWS header for the signature. This is a Base64url-encoded
+    #   JSON object, as per RFC 7515.
+    attribute :protected, Types::String
+
+    # @return [String] The computed signature, Base64url-encoded.
+    attribute :signature, Types::String
+
+    # @return [Hash, nil] The unprotected JWS header values.
+    attribute? :header, Types::Hash.optional
+  end
+end

data/lib/a2a/types/agent_extension.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module A2A
+  # A declaration of a protocol extension supported by an Agent.
+  class AgentExtension < ProtocolStruct
+    # @return [URI] The unique URI identifying the extension.
+    attribute :uri, Types::URI
+
+    # @return [String, nil] A human-readable description of how this agent uses the extension.
+    attribute? :description, Types::String.optional
+
+    # @return [Boolean] If true, the client must understand and comply with the extension's requirements
+    #   to interact with the agent.
+    attribute? :required, Types::Bool.default(false)
+
+    # @return [Hash, nil] Optional, extension-specific configuration parameters.
+    attribute? :params, Types::Hash.optional
+  end
+end

data/lib/a2a/types/agent_interface.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module A2A
+  # Declares a combination of a target URL and a transport protocol for interacting with the agent.
+  # This allows agents to expose the same functionality over multiple transport mechanisms.
+  class AgentInterface < ProtocolStruct
+    # @return [URI] The URL where this interface is available. Must be a valid absolute HTTPS URL in production.
+    attribute :url, Types::URI
+
+    # @return [String] The transport protocol supported at this URL.
+    attribute :transport, Types::String
+  end
+end

data/lib/a2a/types/agent_provider.rb

@@ -6,7 +6,7 @@ module A2A
     # @return [String] The name of the organization providing the agent.
     attribute :organization, Types::String
 
-    # @return [String, nil] URL associated with the agent provider.
-    attribute? :url, Types::String.optional
+    # @return [URI] A URL for the agent provider's website or relevant documentation.
+    attribute :url, Types::URI
   end
 end

data/lib/a2a/types/agent_skill.rb

@@ -9,11 +9,12 @@ module A2A
     # @return [String] Human-readable name of the skill.
     attribute :name, Types::String
 
-    # @return [String, nil] Optional description of the skill.
-    attribute? :description, Types::String.optional
+    # @return [String] A detailed description of the skill, intended to help clients or users
+    #   understand its purpose and functionality.
+    attribute :description, Types::String
 
-    # @return [Array<String>, nil] Optional list of tags associated with the skill for categorization.
-    attribute? :tags, Types::Array.of(Types::String).optional
+    # @return [Array<String>] A set of keywords describing the skill's capabilities.
+    attribute :tags, Types::Array.of(Types::String)
 
     # @return [Array<String>, nil] Optional list of example inputs or use cases for the skill.
     attribute? :examples, Types::Array.of(Types::String).optional
@@ -23,5 +24,11 @@ module A2A
 
     # @return [Array<String>, nil] Optional list of output modes supported by this skill, overriding agent defaults.
     attribute? :output_modes, Types::Array.of(Types::String).optional
+
+    # @return [Array<Hash>, nil] Security schemes necessary for the agent to leverage this skill.
+    #   As in the overall AgentCard.security, this list represents a logical OR of security
+    #   requirement objects. Each object is a set of security schemes that must be used together
+    #   (a logical AND).
+    attribute? :security, Types::Array.of(Types::Hash.map(Types::String, Types::Array.of(Types::String))).optional
   end
 end

data/lib/a2a/types/api_key_security_scheme.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines a security scheme using an API key.
+  class APIKeySecurityScheme < SecuritySchemeBase
+    # @return [String] The type of the security scheme. Must be 'apiKey'.
+    attribute :type, Types::String.constant('apiKey')
+
+    # @return [String] The location of the API key.
+    attribute :in, Types::String.enum('query', 'header', 'cookie')
+
+    # @return [String] The name of the header, query, or cookie parameter to be used.
+    attribute :name, Types::String
+  end
+end

data/lib/a2a/types/artifact.rb

@@ -1,29 +1,24 @@
 # frozen_string_literal: true
 
 module A2A
-  # Represents an artifact generated or used by a task, potentially composed of multiple parts.
+  # Represents a file, data structure, or other resource generated by an agent during a task.
   class Artifact < ProtocolStruct
-    # @return [String, nil] Optional name for the artifact.
+    # @return [String] A unique identifier (e.g. UUID) for the artifact within the scope of the task.
+    attribute :artifact_id, Types::String
+
+    # @return [String, nil] An optional, human-readable name for the artifact.
     attribute? :name, Types::String.optional
 
-    # @return [String, nil] Optional description of the artifact.
+    # @return [String, nil] An optional, human-readable description of the artifact.
     attribute? :description, Types::String.optional
 
-    # @return [Array<Part>] The constituent parts of the artifact.
+    # @return [Array<Part>] An array of content parts that make up the artifact.
     attribute :parts, Types::Array.of(Types::Constructor(Part))
 
-    # @return [Integer, nil] Optional index for ordering artifacts, especially relevant in streaming or updates.
-    attribute? :index, Types::Integer.default(0)
-
-    # @return [Boolean, nil] Optional flag indicating if this artifact content should append to previous
-    # content (for streaming).
-    attribute? :append, Types::Bool.optional
-
-    # @return [Hash, nil] Optional metadata associated with the artifact.
+    # @return [Hash, nil] Optional metadata for extensions. The key is an extension-specific identifier.
     attribute? :metadata, Types::Hash.optional
 
-    # @return [Boolean, nil] Optional flag indicating if this is the last chunk of data for this
-    # artifact (for streaming).
-    attribute? :last_chunk, Types::Bool.optional
+    # @return [Array<String>, nil] The URIs of extensions that are relevant to this artifact.
+    attribute? :extensions, Types::Array.of(Types::String).optional
   end
 end

data/lib/a2a/types/authenticated_extended_card_not_configured_error.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module A2A
+  # Error for missing authenticated extended card configuration (-32007)
+  #
+  # Raised when the agent does not have an Authenticated Extended Card configured.
+  #
+  # @api public
+  #
+  # @example Create an authenticated extended card not configured error
+  #   error = JSONRPC::AuthenticatedExtendedCardNotConfiguredError.new
+  #
+  class AuthenticatedExtendedCardNotConfiguredError < JSONRPC::Error
+    # Creates a new Authenticated Extended Card Not Configured Error with code -32007
+    #
+    # @api public
+    #
+    # @example Create an authenticated extended card not configured error with default message
+    #   error = JSONRPC::AuthenticatedExtendedCardNotConfiguredError.new
+    #
+    # @example Create an authenticated extended card not configured error with exception details
+    #   error = JSONRPC::AuthenticatedExtendedCardNotConfiguredError.new(
+    #     data: { feature: 'extended_card' }, request_id: 1
+    #   )
+    #
+    # @param message [String] short description of the error
+    # @param data [Hash, Array, String, Number, Boolean, nil] additional error information
+    # @param request_id [String, Integer, nil] the request identifier
+    #
+    def initialize(
+      message = 'Authenticated Extended Card not configured.',
+      data: nil,
+      request_id: nil
+    )
+      super(
+        message,
+        code: ErrorCodes::AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED,
+        data:,
+        request_id:
+      )
+    end
+  end
+end

data/lib/a2a/types/authorization_code_oauth_flow.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines configuration details for the OAuth 2.0 Authorization Code flow.
+  class AuthorizationCodeOAuthFlow < ProtocolStruct
+    # @return [URI] The authorization URL to be used for this flow.
+    #   This MUST be a URL and use TLS.
+    attribute :authorization_url, Types::URI
+
+    # @return [URI] The token URL to be used for this flow.
+    #   This MUST be a URL and use TLS.
+    attribute :token_url, Types::URI
+
+    # @return [URI, nil] The URL to be used for obtaining refresh tokens.
+    #   This MUST be a URL and use TLS.
+    attribute? :refresh_url, Types::URI.optional
+
+    # @return [Hash] The available scopes for the OAuth2 security scheme. A map between the scope
+    #   name and a short description for it.
+    attribute :scopes, Types::Hash.map(Types::String, Types::String)
+  end
+end

data/lib/a2a/types/cancel_task_request.rb

@@ -2,9 +2,12 @@
 
 module A2A
   # Request to cancel a currently running task.
-  class CancelTaskRequest < JSONRPCRequest
+  class CancelTaskRequest < JSONRPC::Request
     # @return [String] Method name for canceling a task.
-    attribute :method, Types::String.constant('tasks/cancel')
+    METHOD = 'tasks/cancel'
+
+    # @return [String] Method name for canceling a task.
+    attribute :method, Types::String.constant(METHOD)
 
     # @return [TaskIdParams] Parameters for the cancel task method.
     attribute :params, Types::Constructor(TaskIdParams)

data/lib/a2a/types/cancel_task_response.rb

@@ -2,11 +2,11 @@
 
 module A2A
   # Response to a `tasks/cancel` request. Contains the updated Task object or an error.
-  class CancelTaskResponse < JSONRPCResponse
+  class CancelTaskResponse < JSONRPC::Response
     # @return [Task, nil] The canceled task information if successful.
     attribute? :result, Types::Constructor(Task).optional
 
-    # @return [JSONRPCError, nil] Error information if the request failed.
-    attribute? :error, Types::Constructor(JSONRPCError).optional
+    # @return [JSONRPC::Error, nil] Error information if the request failed.
+    attribute? :error, Types::Constructor(JSONRPC::Error).optional
   end
 end

data/lib/a2a/types/client_credentials_oauth_flow.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines configuration details for the OAuth 2.0 Client Credentials flow.
+  class ClientCredentialsOAuthFlow < ProtocolStruct
+    # @return [URI] The token URL to be used for this flow. This MUST be a URL.
+    attribute :token_url, Types::URI
+
+    # @return [URI, nil] The URL to be used for obtaining refresh tokens. This MUST be a URL.
+    attribute? :refresh_url, Types::URI.optional
+
+    # @return [Hash] The available scopes for the OAuth2 security scheme. A map between the scope
+    #   name and a short description for it.
+    attribute :scopes, Types::Hash.map(Types::String, Types::String)
+  end
+end

data/lib/a2a/types/content_type_not_supported_error.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module A2A
+  # Error for unsupported content types (-32005)
+  #
+  # Raised when a Media Type provided in the request's message.parts (or implied for an artifact)
+  # is not supported by the agent or the specific skill being invoked.
+  #
+  # @api public
+  #
+  # @example Create a content type not supported error
+  #   error = JSONRPC::ContentTypeNotSupportedError.new
+  #
+  class ContentTypeNotSupportedError < JSONRPC::Error
+    # Creates a new Content Type Not Supported Error with code -32005
+    #
+    # @api public
+    #
+    # @example Create a content type not supported error with default message
+    #   error = JSONRPC::ContentTypeNotSupportedError.new
+    #
+    # @example Create a content type not supported error with exception details
+    #   error = JSONRPC::ContentTypeNotSupportedError.new(data: { content_type: 'application/xml' }, request_id: 1)
+    #
+    # @param message [String] short description of the error
+    # @param data [Hash, Array, String, Number, Boolean, nil] additional error information
+    # @param request_id [String, Integer, nil] the request identifier
+    #
+    def initialize(
+      message = 'Incompatible content types.',
+      data: nil,
+      request_id: nil
+    )
+      super(
+        message,
+        code: ErrorCodes::CONTENT_TYPE_NOT_SUPPORTED,
+        data:,
+        request_id:
+      )
+    end
+  end
+end

data/lib/a2a/types/data_part.rb

@@ -1,15 +1,12 @@
 # frozen_string_literal: true
 
 module A2A
-  # Represents a part of a message containing structured data (JSON).
-  class DataPart < ProtocolStruct
-    # @return [String] Type identifier for this part.
-    attribute :type, Types::String.constant('data')
+  # Represents a structured data segment (e.g., JSON) within a message or artifact.
+  class DataPart < PartBase
+    # @return [String] The type of this part, used as a discriminator. Always 'data'.
+    attribute :kind, Types::String.constant('data')
 
-    # @return [Hash] The structured data content as a JSON object.
+    # @return [Hash] The structured data content.
     attribute :data, Types::Hash
-
-    # @return [Hash, nil] Optional metadata associated with this data part.
-    attribute? :metadata, Types::Hash.optional
   end
 end

data/lib/a2a/types/delete_task_push_notification_config_params.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines parameters for deleting a specific push notification configuration for a task.
+  class DeleteTaskPushNotificationConfigParams < TaskIdParams
+    # @return [String] The ID of the push notification configuration to delete.
+    attribute :push_notification_config_id, Types::String
+  end
+end

data/lib/a2a/types/delete_task_push_notification_config_request.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module A2A
+  # Represents a JSON-RPC request for the `tasks/pushNotificationConfig/delete` method.
+  class DeleteTaskPushNotificationConfigRequest < JSONRPC::Request
+    # @return [String] Method name for deleting push notification configurations.
+    METHOD = 'tasks/pushNotificationConfig/delete'
+
+    # @return [String] Method name for deleting push notification configurations.
+    attribute :method, Types::String.constant(METHOD)
+
+    # @return [DeleteTaskPushNotificationConfigParams] Parameters for deleting push notification configurations.
+    attribute :params, Types::Constructor(DeleteTaskPushNotificationConfigParams)
+
+    # @return [String] Method name for deleting push notification configurations.
+    def method = attributes[:method]
+  end
+end

data/lib/a2a/types/delete_task_push_notification_config_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module A2A
+  # Response to a `tasks/pushNotificationConfig/delete` request.
+  # Returns null on successful deletion.
+  class DeleteTaskPushNotificationConfigResponse < JSONRPC::Response
+    # @return [NilClass, nil] Returns null on successful deletion.
+    attribute? :result, Types::Nil.optional
+
+    # @return [JSONRPC::Error, nil] Error information if the request failed.
+    attribute? :error, Types::Constructor(JSONRPC::Error).optional
+  end
+end

data/lib/a2a/types/error.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module A2A
+  # A discriminated union of all standard JSON-RPC and A2A-specific error types.
+  Error = Types.Constructor(
+    Types.Instance(JSONRPC::ParseError) |
+    Types.Instance(JSONRPC::InvalidRequestError) |
+    Types.Instance(JSONRPC::MethodNotFoundError) |
+    Types.Instance(JSONRPC::InvalidParamsError) |
+    Types.Instance(JSONRPC::InternalError) |
+    Types.Instance(TaskNotFoundError) |
+    Types.Instance(TaskNotCancelableError) |
+    Types.Instance(PushNotificationNotSupportedError) |
+    Types.Instance(UnsupportedOperationError) |
+    Types.Instance(ContentTypeNotSupportedError) |
+    Types.Instance(InvalidAgentResponseError) |
+    Types.Instance(AuthenticatedExtendedCardNotConfiguredError)
+  ) { |value| value }
+end

data/lib/a2a/types/error_codes.rb

@@ -22,5 +22,11 @@ module A2A
     PUSH_NOTIFICATION_NOT_SUPPORTED = -32_003
     # The requested operation is not supported by the agent
     UNSUPPORTED_OPERATION = -32_004
+    # Content type is not supported
+    CONTENT_TYPE_NOT_SUPPORTED = -32_005
+    # Invalid agent response type
+    INVALID_AGENT_RESPONSE = -32_006
+    # Authenticated Extended Card not configured
+    AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED = -32_007
   end
 end

data/lib/a2a/types/file_base.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines base properties for a file.
+  class FileBase < ProtocolStruct
+    # @return [String, nil] An optional name for the file (e.g., "document.pdf").
+    attribute? :name, Types::String.optional
+
+    # @return [String, nil] The MIME type of the file (e.g., "application/pdf").
+    attribute? :mime_type, Types::String.optional
+  end
+end

data/lib/a2a/types/file_part.rb

@@ -1,15 +1,13 @@
 # frozen_string_literal: true
 
 module A2A
-  # Represents a part of a message containing file content.
-  class FilePart < ProtocolStruct
-    # @return [String] Type identifier for this part.
-    attribute :type, Types::String.constant('file')
+  # Represents a file segment within a message or artifact. The file content can be
+  # provided either directly as bytes or as a URI.
+  class FilePart < PartBase
+    # @return [String] The type of this part, used as a discriminator. Always 'file'.
+    attribute :kind, Types::String.constant('file')
 
-    # @return [FileContent] The file content, provided either inline or via URI.
-    attribute :file, Types::Constructor(FileContent)
-
-    # @return [Hash, nil] Optional metadata associated with this file part.
-    attribute? :metadata, Types::Hash.optional
+    # @return [FileWithBytes | FileWithUri] The file content, represented as either a URI or as base64-encoded bytes.
+    attribute :file, Types::Constructor(FileWithBytes | FileWithUri)
   end
 end

data/lib/a2a/types/file_with_bytes.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module A2A
+  # Represents a file with its content provided directly as a base64-encoded string.
+  class FileWithBytes < FileBase
+    # @return [String] The base64-encoded content of the file.
+    attribute :bytes, Types::String
+  end
+end

data/lib/a2a/types/file_with_uri.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module A2A
+  # Represents a file with its content located at a specific URI.
+  class FileWithUri < FileBase
+    # @return [URI] A URL pointing to the file's content.
+    attribute :uri, Types::URI
+  end
+end

data/lib/a2a/types/get_authenticated_extended_card_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module A2A
+  # Represents a JSON-RPC request for the `agent/getAuthenticatedExtendedCard` method.
+  class GetAuthenticatedExtendedCardRequest < JSONRPC::Request
+    # @return [String] Method name for getting authenticated extended card.
+    METHOD = 'agent/getAuthenticatedExtendedCard'
+
+    # @return [String] Method name for getting authenticated extended card.
+    attribute :method, Types::String.constant(METHOD)
+
+    # @return [String] Method name for getting authenticated extended card.
+    def method = attributes[:method]
+  end
+end

data/lib/a2a/types/get_authenticated_extended_card_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module A2A
+  # Response to a `agent/getAuthenticatedExtendedCard` request.
+  # Returns an extended AgentCard with additional details for authenticated users.
+  class GetAuthenticatedExtendedCardResponse < JSONRPC::Response
+    # @return [AgentCard, nil] The authenticated extended agent card if successful.
+    attribute? :result, Types::Constructor(AgentCard).optional
+
+    # @return [JSONRPC::Error, nil] Error information if the request failed.
+    attribute? :error, Types::Constructor(JSONRPC::Error).optional
+  end
+end

data/lib/a2a/types/get_task_push_notification_config_params.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines parameters for fetching a specific push notification configuration for a task.
+  class GetTaskPushNotificationConfigParams < TaskIdParams
+    # @return [String, nil] The ID of the push notification configuration to retrieve.
+    attribute? :push_notification_config_id, Types::String.optional
+  end
+end

data/lib/a2a/types/get_task_push_notification_config_request.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module A2A
+  # Represents a JSON-RPC request for the `tasks/pushNotificationConfig/get` method.
+  class GetTaskPushNotificationConfigRequest < JSONRPC::Request
+    # @return [String] Method name for getting task push notification configuration.
+    METHOD = 'tasks/pushNotificationConfig/get'
+
+    # @return [String] Method name for getting task push notification configuration.
+    attribute :method, Types::String.constant(METHOD)
+
+    # @return [GetTaskPushNotificationConfigParams, TaskIdParams] Parameters for getting a push notification
+    #   configuration. The TaskIdParams type is deprecated for this method. Use GetTaskPushNotificationConfigParams
+    #   instead.
+    attribute :params,
+              Types::Constructor(GetTaskPushNotificationConfigParams) | Types::Constructor(TaskIdParams)
+
+    # @return [String] Method name for getting task push notification configuration.
+    def method = attributes[:method]
+  end
+end

data/lib/a2a/types/get_task_push_notification_request.rb

@@ -2,9 +2,12 @@
 
 module A2A
   # Request to retrieve the currently configured push notification configuration for a task.
-  class GetTaskPushNotificationRequest < JSONRPCRequest
+  class GetTaskPushNotificationRequest < JSONRPC::Request
     # @return [String] Method name for getting task notification configuration.
-    attribute :method, Types::String.constant('tasks/pushNotification/get')
+    METHOD = 'tasks/pushNotificationConfig/get'
+
+    # @return [String] Method name for getting task notification configuration.
+    attribute :method, Types::String.constant(METHOD)
 
     # @return [TaskIdParams] Parameters for the get task push notification config method.
     attribute :params, Types::Constructor(TaskIdParams)