a2a 0.1.0.pre → 0.2.0

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

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module A2A
+  # 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.
+    attribute :data, Types::Hash
+  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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module A2A
+  # Standard JSON-RPC error codes
+  module ErrorCodes
+    # Invalid JSON was received by the server
+    PARSE_ERROR = -32_700
+    # The JSON sent is not a valid Request object
+    INVALID_REQUEST = -32_600
+    # The method does not exist / is not available
+    METHOD_NOT_FOUND = -32_601
+    # Invalid method parameter(s)
+    INVALID_PARAMS = -32_602
+    # Internal JSON-RPC error
+    INTERNAL_ERROR = -32_603
+
+    # The specified task was not found
+    TASK_NOT_FOUND = -32_001
+    # The specified task cannot be canceled
+    TASK_NOT_CANCELABLE = -32_002
+    # Push Notifications are not supported for this operation or agent
+    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

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module A2A
+  # 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 [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

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module A2A
+  # Request to retrieve the currently configured push notification configuration for a task.
+  class GetTaskPushNotificationRequest < JSONRPC::Request
+    # @return [String] Method name for getting task notification configuration.
+    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)
+
+    # @return [String] Method name for getting task notification configuration.
+    def method = attributes[:method]
+  end
+end

data/lib/a2a/types/get_task_push_notification_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module A2A
+  # Response to a `tasks/pushNotificationConfig/get` request. Contains the TaskPushNotificationConfig or an error.
+  class GetTaskPushNotificationResponse < JSONRPC::Response
+    # @return [TaskPushNotificationConfig, nil] The push notification config if successful.
+    attribute? :result, Types::Constructor(TaskPushNotificationConfig).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_request.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module A2A
+  # Request to retrieve the current state of a task.
+  class GetTaskRequest < JSONRPC::Request
+    # @return [String] Method name for getting task status.
+    METHOD = 'tasks/get'
+
+    # @return [String] Method name for getting task status.
+    attribute :method, Types::String.constant(METHOD)
+
+    # @return [TaskQueryParams] Parameters for the get task method.
+    attribute :params, Types::Constructor(TaskQueryParams)
+
+    # @return [String] Method name for getting task status.
+    def method = attributes[:method]
+  end
+end

data/lib/a2a/types/get_task_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module A2A
+  # Response to a `tasks/get` request. Contains the Task object or an error.
+  class GetTaskResponse < JSONRPC::Response
+    # @return [Task, nil] The task information if successful.
+    attribute? :result, Types::Constructor(Task).optional
+
+    # @return [JSONRPC::Error, nil] Error information if the request failed.
+    attribute? :error, Types::Constructor(JSONRPC::Error).optional
+  end
+end

data/lib/a2a/types/http_auth_security_scheme.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines a security scheme using HTTP authentication.
+  class HTTPAuthSecurityScheme < SecuritySchemeBase
+    # @return [String] The type of the security scheme. Must be 'http'.
+    attribute :type, Types::String.constant('http')
+
+    # @return [String] The name of the HTTP Authentication scheme to be used in the Authorization header,
+    #   as defined in RFC7235 (e.g., "Bearer").
+    #   This value should be registered in the IANA Authentication Scheme registry.
+    attribute :scheme, Types::String
+
+    # @return [String, nil] A hint to the client to identify how the bearer token is formatted (e.g., "JWT").
+    #   This is primarily for documentation purposes.
+    attribute? :bearer_format, Types::String.optional
+  end
+end

data/lib/a2a/types/implicit_oauth_flow.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines configuration details for the OAuth 2.0 Implicit flow.
+  class ImplicitOAuthFlow < ProtocolStruct
+    # @return [URI] The authorization URL to be used for this flow. This MUST be a URL.
+    attribute :authorization_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/invalid_agent_response_error.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module A2A
+  # Error for invalid agent responses (-32006)
+  #
+  # Raised when agent generates an invalid response for the requested method.
+  #
+  # @api public
+  #
+  # @example Create an invalid agent response error
+  #   error = JSONRPC::InvalidAgentResponseError.new
+  #
+  class InvalidAgentResponseError < JSONRPC::Error
+    # Creates a new Invalid Agent Response Error with code -32006
+    #
+    # @api public
+    #
+    # @example Create an invalid agent response error with default message
+    #   error = JSONRPC::InvalidAgentResponseError.new
+    #
+    # @example Create an invalid agent response error with exception details
+    #   error = JSONRPC::InvalidAgentResponseError.new(data: { response_type: 'malformed' }, 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 = 'Invalid agent response type.',
+      data: nil,
+      request_id: nil
+    )
+      super(
+        message,
+        code: ErrorCodes::INVALID_AGENT_RESPONSE,
+        data:,
+        request_id:
+      )
+    end
+  end
+end

data/lib/a2a/types/list_task_push_notification_config_params.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines parameters for listing all push notification configurations associated with a task.
+  class ListTaskPushNotificationConfigParams < TaskIdParams
+    # No additional attributes beyond those inherited from TaskIdParams
+  end
+end

data/lib/a2a/types/list_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/list` method.
+  class ListTaskPushNotificationConfigRequest < JSONRPC::Request
+    # @return [String] Method name for listing push notification configurations.
+    METHOD = 'tasks/pushNotificationConfig/list'
+
+    # @return [String] Method name for listing push notification configurations.
+    attribute :method, Types::String.constant(METHOD)
+
+    # @return [ListTaskPushNotificationConfigParams] Parameters for listing push notification configurations.
+    attribute :params, Types::Constructor(ListTaskPushNotificationConfigParams)
+
+    # @return [String] Method name for listing push notification configurations.
+    def method = attributes[:method]
+  end
+end

data/lib/a2a/types/list_task_push_notification_config_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module A2A
+  # Response to a `tasks/pushNotificationConfig/list` request.
+  # Returns an array of all push notification configurations for the specified task.
+  class ListTaskPushNotificationConfigResponse < JSONRPC::Response
+    # @return [Array<TaskPushNotificationConfig>, nil] Array of push notification configurations if successful.
+    attribute? :result, Types::Array.of(Types::Constructor(TaskPushNotificationConfig)).optional
+
+    # @return [JSONRPC::Error, nil] Error information if the request failed.
+    attribute? :error, Types::Constructor(JSONRPC::Error).optional
+  end
+end

data/lib/a2a/types/message.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module A2A
+  # Represents a single message in the conversation between a user and an agent.
+  class Message < ProtocolStruct
+    # @return [String] Identifies the sender of the message. `user` for the client, `agent` for the service.
+    attribute :role, Types::String.enum('user', 'agent')
+
+    # @return [Array<Part>] An array of content parts that form the message body. A message can be
+    #   composed of multiple parts of different types (e.g., text and files).
+    attribute :parts, Types::Array.of(Types::Constructor(Part))
+
+    # @return [Hash, nil] Optional metadata for extensions. The key is an extension-specific identifier.
+    attribute? :metadata, Types::Hash.optional
+
+    # @return [Array<String>, nil] The URIs of extensions that are relevant to this message.
+    attribute? :extensions, Types::Array.of(Types::String).optional
+
+    # @return [Array<String>, nil] A list of other task IDs that this message references for additional context.
+    attribute? :reference_task_ids, Types::Array.of(Types::String).optional
+
+    # @return [String] A unique identifier for the message, typically a UUID, generated by the sender.
+    attribute :message_id, Types::String
+
+    # @return [String, nil] The ID of the task this message is part of. Can be omitted for the first message of a
+    #   new task.
+    attribute? :task_id, Types::String.optional
+
+    # @return [String, nil] The context ID for this message, used to group related interactions.
+    attribute? :context_id, Types::String.optional
+
+    # @return [String] The type of this object, used as a discriminator. Always 'message' for a Message.
+    attribute :kind, Types::String.constant('message')
+  end
+end

data/lib/a2a/types/message_send_configuration.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines configuration options for a `message/send` or `message/stream` request.
+  class MessageSendConfiguration < ProtocolStruct
+    # @return [Array<String>, nil] A list of output MIME types the client is prepared to accept in the response.
+    attribute? :accepted_output_modes, Types::Array.of(Types::String).optional
+
+    # @return [Integer, nil] The number of most recent messages from the task's history to retrieve in the response.
+    attribute? :history_length, Types::Integer.optional
+
+    # @return [PushNotificationConfig, nil] Configuration for the agent to send push notifications for updates after
+    #   the initial response.
+    attribute? :push_notification_config, Types::Constructor(PushNotificationConfig).optional
+
+    # @return [Boolean] If true, the client will wait for the task to complete. The server may reject this if
+    #   the task is long-running.
+    attribute? :blocking, Types::Bool.default(false)
+  end
+end

data/lib/a2a/types/message_send_params.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines the parameters for a request to send a message to an agent. This can be used
+  # to create a new task, continue an existing one, or restart a task.
+  class MessageSendParams < ProtocolStruct
+    # @return [Message] The message object being sent to the agent.
+    attribute :message, Types::Constructor(Message)
+
+    # @return [MessageSendConfiguration, nil] Optional configuration for the send request.
+    attribute? :configuration, Types::Constructor(MessageSendConfiguration).optional
+
+    # @return [Hash, nil] Optional metadata for extensions.
+    attribute? :metadata, Types::Hash.optional
+  end
+end

data/lib/a2a/types/mutual_tls_security_scheme.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines a security scheme using mTLS authentication.
+  class MutualTLSSecurityScheme < SecuritySchemeBase
+    # @return [String] The type of the security scheme. Must be 'mutualTLS'.
+    attribute :type, Types::String.constant('mutualTLS')
+  end
+end

data/lib/a2a/types/oauth2_security_scheme.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines a security scheme using OAuth 2.0.
+  class OAuth2SecurityScheme < SecuritySchemeBase
+    # @return [String] The type of the security scheme. Must be 'oauth2'.
+    attribute :type, Types::String.constant('oauth2')
+
+    # @return [OAuthFlows] An object containing configuration information for the supported OAuth 2.0 flows.
+    attribute :flows, Types::Constructor(OAuthFlows)
+
+    # @return [URI, nil] URL to the oauth2 authorization server metadata
+    #   RFC8414. TLS is required.
+    attribute? :oauth2_metadata_url, Types::URI.optional
+  end
+end

data/lib/a2a/types/oauth_flows.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines the configuration for the supported OAuth 2.0 flows.
+  class OAuthFlows < ProtocolStruct
+    # @return [AuthorizationCodeOAuthFlow, nil] Configuration for the OAuth Authorization Code flow.
+    #   Previously called accessCode in OpenAPI 2.0.
+    attribute? :authorization_code, Types::Constructor(AuthorizationCodeOAuthFlow).optional
+
+    # @return [ClientCredentialsOAuthFlow, nil] Configuration for the OAuth Client Credentials flow.
+    #   Previously called application in OpenAPI 2.0.
+    attribute? :client_credentials, Types::Constructor(ClientCredentialsOAuthFlow).optional
+
+    # @return [ImplicitOAuthFlow, nil] Configuration for the OAuth Implicit flow.
+    attribute? :implicit, Types::Constructor(ImplicitOAuthFlow).optional
+
+    # @return [PasswordOAuthFlow, nil] Configuration for the OAuth Resource Owner Password flow.
+    attribute? :password, Types::Constructor(PasswordOAuthFlow).optional
+  end
+end

data/lib/a2a/types/openid_connect_security_scheme.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines a security scheme using OpenID Connect.
+  class OpenIdConnectSecurityScheme < SecuritySchemeBase
+    # @return [String] The type of the security scheme. Must be 'openIdConnect'.
+    attribute :type, Types::String.constant('openIdConnect')
+
+    # @return [URI] The OpenID Connect Discovery URL for the OIDC provider's metadata.
+    attribute :open_id_connect_url, Types::URI
+  end
+end

data/lib/a2a/types/part.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module A2A
+  # A discriminated union representing a part of a message or artifact, which can
+  # be text, a file, or structured data.
+  Part = TextPart | FilePart | DataPart
+end

data/lib/a2a/types/part_base.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines base properties common to all message or artifact parts.
+  class PartBase < ProtocolStruct
+    # @return [Hash<String, Object>] Optional metadata associated with this part.
+    attribute? :metadata, Types::Hash.map(Types::String, Types::Any).optional
+  end
+end

data/lib/a2a/types/password_oauth_flow.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module A2A
+  # Defines configuration details for the OAuth 2.0 Resource Owner Password flow.
+  class PasswordOAuthFlow < 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