types

type A2AMethod string

type APIKeySecurityScheme struct {
	// Description An optional description for the security scheme.
	Description *string `json:"description,omitempty"`

	// Location The location of the API key. Valid values are "query", "header", or "cookie".
	Location string `json:"location"`

	// Name The name of the header, query, or cookie parameter to be used.
	Name string `json:"name"`
}

type AgentCapabilities struct {
	// ExtendedAgentCard Indicates if the agent supports providing an extended agent card when authenticated.
	ExtendedAgentCard *bool `json:"extendedAgentCard,omitempty"`

	// Extensions A list of protocol extensions supported by the agent.
	Extensions []AgentExtension `json:"extensions,omitempty"`

	// PushNotifications Indicates if the agent supports sending push notifications for asynchronous task updates.
	PushNotifications *bool `json:"pushNotifications,omitempty"`

	// Streaming Indicates if the agent supports streaming responses.
	Streaming *bool `json:"streaming,omitempty"`
}

type AgentCard struct {
	// Capabilities A2A Capability set supported by the agent.
	Capabilities AgentCapabilities `json:"capabilities"`

	// DefaultInputModes protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
	//  The set of interaction modes that the agent supports across all skills.
	//  This can be overridden per skill. Defined as media types.
	DefaultInputModes []string `json:"defaultInputModes"`

	// DefaultOutputModes The media types supported as outputs from this agent.
	DefaultOutputModes []string `json:"defaultOutputModes"`

	// Description A human-readable description of the agent, assisting users and other agents
	//  in understanding its purpose.
	//  Example: "Agent that helps users with recipes and cooking."
	Description string `json:"description"`

	// DocumentationURL A URL providing additional documentation about the agent.
	DocumentationURL *string `json:"documentationUrl,omitempty"`

	// IconURL Optional. A URL to an icon for the agent.
	IconURL *string `json:"iconUrl,omitempty"`

	// Name A human readable name for the agent.
	//  Example: "Recipe Agent"
	Name string `json:"name"`

	// Provider The service provider of the agent.
	Provider *AgentProvider `json:"provider,omitempty"`

	// SecurityRequirements Security requirements for contacting the agent.
	SecurityRequirements []SecurityRequirement `json:"securityRequirements,omitempty"`

	// SecuritySchemes The security scheme details used for authenticating with this agent.
	SecuritySchemes map[string]SecurityScheme `json:"securitySchemes,omitempty"`

	// Signatures JSON Web Signatures computed for this `AgentCard`.
	Signatures []AgentCardSignature `json:"signatures,omitempty"`

	// Skills Skills represent the abilities of an agent.
	//  It is largely a descriptive concept but represents a more focused set of behaviors that the
	//  agent is likely to succeed at.
	Skills []AgentSkill `json:"skills"`

	// SupportedInterfaces Ordered list of supported interfaces. The first entry is preferred.
	SupportedInterfaces []AgentInterface `json:"supportedInterfaces"`

	// Version The version of the agent.
	//  Example: "1.0.0"
	Version string `json:"version"`
}

type AgentCardSignature struct {
	// Header The unprotected JWS header values.
	Header *Struct `json:"header,omitempty"`

	// Protected (-- api-linter: core::0140::reserved-words=disabled
	//      aip.dev/not-precedent: Backwards compatibility --)
	//  Required. The protected JWS header for the signature. This is always a
	//  base64url-encoded JSON object.
	Protected string `json:"protected"`

	// Signature Required. The computed signature, base64url-encoded.
	Signature string `json:"signature"`
}

type AgentExtension struct {
	// Description A human-readable description of how this agent uses the extension.
	Description *string `json:"description,omitempty"`

	// Params Optional. Extension-specific configuration parameters.
	Params *Struct `json:"params,omitempty"`

	// Required If true, the client must understand and comply with the extension's requirements.
	Required *bool `json:"required,omitempty"`

	// URI The unique URI identifying the extension.
	URI *string `json:"uri,omitempty"`
}

type AgentInterface struct {
	// ProtocolBinding The protocol binding supported at this URL. This is an open form string, to be
	//  easily extended for other protocol bindings. The core ones officially
	//  supported are `JSONRPC`, `GRPC` and `HTTP+JSON`.
	ProtocolBinding string `json:"protocolBinding"`

	// ProtocolVersion The version of the A2A protocol this interface exposes.
	//  Use the latest supported minor version per major version.
	//  Examples: "0.3", "1.0"
	ProtocolVersion string `json:"protocolVersion"`

	// Tenant Optional. An opaque string used for routing requests to a specific agent
	//  or tenant when multiple agents are served behind a single A2A endpoint.
	//  When set, clients MUST include this value in the `tenant` field of all
	//  request messages sent to this interface. The server is responsible for
	//  interpreting the value and routing requests accordingly; the protocol
	//  does not define its format or semantics.
	Tenant *string `json:"tenant,omitempty"`

	// URL The URL where this interface is available. Must be a valid absolute HTTPS URL in production.
	//  Example: "https://api.example.com/a2a/v1", "https://grpc.example.com/a2a"
	URL string `json:"url"`
}

type AgentProvider struct {
	// Organization The name of the agent provider's organization.
	//  Example: "Google"
	Organization string `json:"organization"`

	// URL A URL for the agent provider's website or relevant documentation.
	//  Example: "https://ai.google.dev"
	URL string `json:"url"`
}

type AgentSkill struct {
	// Description A detailed description of the skill.
	Description string `json:"description"`

	// Examples Example prompts or scenarios that this skill can handle.
	Examples []string `json:"examples,omitempty"`

	// ID A unique identifier for the agent's skill.
	ID string `json:"id"`

	// InputModes The set of supported input media types for this skill, overriding the agent's defaults.
	InputModes []string `json:"inputModes,omitempty"`

	// Name A human-readable name for the skill.
	Name string `json:"name"`

	// OutputModes The set of supported output media types for this skill, overriding the agent's defaults.
	OutputModes []string `json:"outputModes,omitempty"`

	// SecurityRequirements Security schemes necessary for this skill.
	SecurityRequirements []SecurityRequirement `json:"securityRequirements,omitempty"`

	// Tags A set of keywords describing the skill's capabilities.
	Tags []string `json:"tags"`
}

type Artifact struct {
	// ArtifactID Unique identifier (e.g. UUID) for the artifact. It must be unique within a task.
	ArtifactID string `json:"artifactId"`

	// Description Optional. A human readable description of the artifact.
	Description *string `json:"description,omitempty"`

	// Extensions The URIs of extensions that are present or contributed to this Artifact.
	Extensions []string `json:"extensions,omitempty"`

	// Metadata Optional. Metadata included with the artifact.
	Metadata *Struct `json:"metadata,omitempty"`

	// Name A human readable name for the artifact.
	Name *string `json:"name,omitempty"`

	// Parts The content of the artifact. Must contain at least one part.
	Parts []Part `json:"parts"`
}

type AuthenticationInfo struct {
	// Credentials Push Notification credentials. Format depends on the scheme (e.g., token for Bearer).
	Credentials *string `json:"credentials,omitempty"`

	// Scheme HTTP Authentication Scheme from the [IANA registry](https://www.iana.org/assignments/http-authschemes/).
	//  Examples: `Bearer`, `Basic`, `Digest`.
	//  Scheme names are case-insensitive per [RFC 9110 Section 11.1](https://www.rfc-editor.org/rfc/rfc9110#section-11.1).
	Scheme string `json:"scheme"`
}

type AuthorizationCodeOAuthFlow struct {
	// AuthorizationURL The authorization URL to be used for this flow.
	AuthorizationURL string `json:"authorizationUrl"`

	// PkceRequired Indicates if PKCE (RFC 7636) is required for this flow.
	//  PKCE should always be used for public clients and is recommended for all clients.
	PkceRequired *bool `json:"pkceRequired,omitempty"`

	// RefreshURL The URL to be used for obtaining refresh tokens.
	RefreshURL *string `json:"refreshUrl,omitempty"`

	// Scopes The available scopes for the OAuth2 security scheme.
	Scopes map[string]string `json:"scopes"`

	// TokenURL The token URL to be used for this flow.
	TokenURL string `json:"tokenUrl"`
}

type CancelTaskRequest struct {
	// ID The resource ID of the task to cancel.
	ID string `json:"id"`

	// Metadata A flexible key-value map for passing additional context or parameters.
	Metadata *Struct `json:"metadata,omitempty"`

	// Tenant Optional. Opaque routing identifier. Must match the `tenant` value from
	//  the selected `AgentInterface` in the Agent Card when that field is set.
	Tenant *string `json:"tenant,omitempty"`
}

type ClientCredentialsOAuthFlow struct {
	// RefreshURL The URL to be used for obtaining refresh tokens.
	RefreshURL *string `json:"refreshUrl,omitempty"`

	// Scopes The available scopes for the OAuth2 security scheme.
	Scopes map[string]string `json:"scopes"`

	// TokenURL The token URL to be used for this flow.
	TokenURL string `json:"tokenUrl"`
}

type DeleteTaskPushNotificationConfigRequest struct {
	// ID The resource ID of the configuration to delete.
	ID string `json:"id"`

	// TaskID The parent task resource ID.
	TaskID string `json:"taskId"`

	// Tenant Optional. Opaque routing identifier. Must match the `tenant` value from
	//  the selected `AgentInterface` in the Agent Card when that field is set.
	Tenant *string `json:"tenant,omitempty"`
}

type DeviceCodeOAuthFlow struct {
	// DeviceAuthorizationURL The device authorization endpoint URL.
	DeviceAuthorizationURL string `json:"deviceAuthorizationUrl"`

	// RefreshURL The URL to be used for obtaining refresh tokens.
	RefreshURL *string `json:"refreshUrl,omitempty"`

	// Scopes The available scopes for the OAuth2 security scheme.
	Scopes map[string]string `json:"scopes"`

	// TokenURL The token URL to be used for this flow.
	TokenURL string `json:"tokenUrl"`
}

type GetExtendedAgentCardRequest struct {
	// Tenant Optional. Opaque routing identifier. Must match the `tenant` value from
	//  the selected `AgentInterface` in the Agent Card when that field is set.
	Tenant *string `json:"tenant,omitempty"`
}

type GetTaskPushNotificationConfigRequest struct {
	// ID The resource ID of the configuration to retrieve.
	ID string `json:"id"`

	// TaskID The parent task resource ID.
	TaskID string `json:"taskId"`

	// Tenant Optional. Opaque routing identifier. Must match the `tenant` value from
	//  the selected `AgentInterface` in the Agent Card when that field is set.
	Tenant *string `json:"tenant,omitempty"`
}

type GetTaskRequest struct {
	// HistoryLength The maximum number of most recent messages from the task's history to retrieve. An
	//  unset value means the client does not impose any limit. A value of zero is
	//  a request to not include any messages. The server MUST NOT return more
	//  messages than the provided value, but MAY apply a lower limit.
	HistoryLength *int `json:"historyLength,omitempty"`

	// ID The resource ID of the task to retrieve.
	ID string `json:"id"`

	// Tenant Optional. Opaque routing identifier. Must match the `tenant` value from
	//  the selected `AgentInterface` in the Agent Card when that field is set.
	Tenant *string `json:"tenant,omitempty"`
}

type HTTPAuthSecurityScheme struct {
	// BearerFormat A hint to the client to identify how the bearer token is formatted (e.g., "JWT").
	//  Primarily for documentation purposes.
	BearerFormat *string `json:"bearerFormat,omitempty"`

	// Description An optional description for the security scheme.
	Description *string `json:"description,omitempty"`

	// Scheme 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.
	Scheme string `json:"scheme"`
}

type HTTPStatusError struct {
	Operation  string
	StatusCode int
	Body       string
}

type ImplicitOAuthFlow struct {
	// AuthorizationURL The authorization URL to be used for this flow. This MUST be in the
	//  form of a URL. The OAuth2 standard requires the use of TLS
	AuthorizationURL *string `json:"authorizationUrl,omitempty"`

	// RefreshURL The URL to be used for obtaining refresh tokens. This MUST be in the
	//  form of a URL. The OAuth2 standard requires the use of TLS.
	RefreshURL *string `json:"refreshUrl,omitempty"`

	// Scopes The available scopes for the OAuth2 security scheme. A map between the
	//  scope name and a short description for it. The map MAY be empty.
	Scopes map[string]string `json:"scopes,omitempty"`
}

type JSONRPCError struct {
	// Code The error code, e.g. -32601 for an unknown method.
	Code int `json:"code"`

	// Data Additional information about the error.
	Data *Value `json:"data,omitempty"`

	// Message A short description of the error.
	Message string `json:"message"`
}

type JSONRPCErrorResponse struct {
	// Error The error that occurred.
	Error JSONRPCError `json:"error"`

	// ID The id of the request this response answers, or null when it could not be read.
	ID Value `json:"id"`

	// JSONRPC The JSON-RPC version, always "2.0".
	JSONRPC string `json:"jsonrpc"`
}

type JSONRPCRequest struct {
	// ID The request id: a string, a number or null. Omitted for notifications.
	ID *Value `json:"id,omitempty"`

	// JSONRPC The JSON-RPC version, always "2.0".
	JSONRPC string `json:"jsonrpc"`

	// Method The A2A method to invoke.
	Method A2AMethod `json:"method"`

	// Params The method's request message, e.g. a SendMessageRequest for SendMessage.
	Params *Struct `json:"params,omitempty"`
}

type JSONRPCSuccessResponse struct {
	// ID The id of the request this response answers.
	ID Value `json:"id"`

	// JSONRPC The JSON-RPC version, always "2.0".
	JSONRPC string `json:"jsonrpc"`

	// Result The method's response message, e.g. a Task for GetTask.
	Result Value `json:"result"`
}

type ListTaskPushNotificationConfigsRequest struct {
	// PageSize The maximum number of configurations to return.
	PageSize *int `json:"pageSize,omitempty"`

	// PageToken A page token received from a previous `ListTaskPushNotificationConfigsRequest` call.
	PageToken *string `json:"pageToken,omitempty"`

	// TaskID The parent task resource ID.
	TaskID string `json:"taskId"`

	// Tenant Optional. Opaque routing identifier. Must match the `tenant` value from
	//  the selected `AgentInterface` in the Agent Card when that field is set.
	Tenant *string `json:"tenant,omitempty"`
}

type ListTaskPushNotificationConfigsResponse struct {
	// Configs The list of push notification configurations.
	Configs []TaskPushNotificationConfig `json:"configs,omitempty"`

	// NextPageToken A token to retrieve the next page of results, or empty if there are no more results in the list.
	NextPageToken *string `json:"nextPageToken,omitempty"`
}

type ListTasksRequest struct {
	// ContextID Filter tasks by context ID to get tasks from a specific conversation or session.
	ContextID *string `json:"contextId,omitempty"`

	// HistoryLength The maximum number of messages to include in each task's history.
	HistoryLength *int `json:"historyLength,omitempty"`

	// IncludeArtifacts Whether to include artifacts in the returned tasks.
	//  Defaults to false to reduce payload size.
	IncludeArtifacts *bool `json:"includeArtifacts,omitempty"`

	// PageSize The maximum number of tasks to return. The service may return fewer than this value.
	//  If unspecified, at most 50 tasks will be returned.
	//  The minimum value is 1.
	//  The maximum value is 100.
	PageSize *int `json:"pageSize,omitempty"`

	// PageToken A page token, received from a previous `ListTasks` call.
	//  `ListTasksResponse.next_page_token`.
	//  Provide this to retrieve the subsequent page.
	PageToken *string `json:"pageToken,omitempty"`

	// Status Filter tasks by their current status state.
	Status *TaskState `json:"status,omitempty"`

	// StatusTimestampAfter Filter tasks which have a status updated after the provided timestamp in ISO 8601 format (e.g., "2023-10-27T10:00:00Z").
	//  Only tasks with a status timestamp time greater than or equal to this value will be returned.
	StatusTimestampAfter *Timestamp `json:"statusTimestampAfter,omitempty"`

	// Tenant Optional. Opaque routing identifier. Must match the `tenant` value from
	//  the selected `AgentInterface` in the Agent Card when that field is set.
	Tenant *string `json:"tenant,omitempty"`
}

type ListTasksResponse struct {
	// NextPageToken A token to retrieve the next page of results, or empty if there are no more results in the list.
	NextPageToken string `json:"nextPageToken"`

	// PageSize The page size used for this response.
	PageSize int `json:"pageSize"`

	// Tasks Array of tasks matching the specified criteria.
	Tasks []Task `json:"tasks"`

	// TotalSize Total number of tasks available (before pagination).
	TotalSize int `json:"totalSize"`
}

type Message struct {
	// ContextID Optional. The context id of the message. If set, the message will be associated with the given context.
	ContextID *string `json:"contextId,omitempty"`

	// Extensions The URIs of extensions that are present or contributed to this Message.
	Extensions []string `json:"extensions,omitempty"`

	// MessageID The unique identifier (e.g. UUID) of the message. This is created by the message creator.
	MessageID string `json:"messageId"`

	// Metadata Optional. Any metadata to provide along with the message.
	Metadata *Struct `json:"metadata,omitempty"`

	// Parts Parts is the container of the message content.
	Parts []Part `json:"parts"`

	// ReferenceTaskIDs A list of task IDs that this message references for additional context.
	ReferenceTaskIDs []string `json:"referenceTaskIds,omitempty"`

	// Role Identifies the sender of the message.
	Role Role `json:"role"`

	// TaskID Optional. The task id of the message. If set, the message will be associated with the given task.
	TaskID *string `json:"taskId,omitempty"`
}

type MutualTLSSecurityScheme struct {
	// Description An optional description for the security scheme.
	Description *string `json:"description,omitempty"`
}

type OAuth2SecurityScheme struct {
	// Description An optional description for the security scheme.
	Description *string `json:"description,omitempty"`

	// Flows An object containing configuration information for the supported OAuth 2.0 flows.
	Flows OAuthFlows `json:"flows"`

	// Oauth2MetadataURL URL to the OAuth2 authorization server metadata [RFC 8414](https://datatracker.ietf.org/doc/html/rfc8414).
	//  TLS is required.
	Oauth2MetadataURL *string `json:"oauth2MetadataUrl,omitempty"`
}

type OAuthFlows struct {
	// AuthorizationCode Configuration for the OAuth Authorization Code flow.
	AuthorizationCode *AuthorizationCodeOAuthFlow `json:"authorizationCode,omitempty"`

	// ClientCredentials Configuration for the OAuth Client Credentials flow.
	ClientCredentials *ClientCredentialsOAuthFlow `json:"clientCredentials,omitempty"`

	// DeviceCode Configuration for the OAuth Device Code flow.
	DeviceCode *DeviceCodeOAuthFlow `json:"deviceCode,omitempty"`

	// Implicit Deprecated: Use Authorization Code + PKCE instead.
	Implicit *ImplicitOAuthFlow `json:"implicit,omitempty"`

	// Password Deprecated: Use Authorization Code + PKCE or Device Code.
	Password *PasswordOAuthFlow `json:"password,omitempty"`
}

type OpenIDConnectSecurityScheme struct {
	// Description An optional description for the security scheme.
	Description *string `json:"description,omitempty"`

	// OpenIDConnectURL The [OpenID Connect Discovery URL](https://openid.net/specs/openid-connect-discovery-1_0.html) for the OIDC provider's metadata.
	OpenIDConnectURL string `json:"openIdConnectUrl"`
}

type Part struct {
	// Data Arbitrary structured `data` as a JSON value (object, array, string, number, boolean, or null).
	Data *Value `json:"data,omitempty"`

	// Filename An optional `filename` for the file (e.g., "document.pdf").
	Filename *string `json:"filename,omitempty"`

	// MediaType The `media_type` (MIME type) of the part content (e.g., "text/plain", "application/json", "image/png").
	//  This field is available for all part types.
	MediaType *string `json:"mediaType,omitempty"`

	// Metadata Optional. metadata associated with this part.
	Metadata *Struct `json:"metadata,omitempty"`

	// Raw The `raw` byte content of a file. In JSON serialization, this is encoded as a base64 string.
	Raw *string `json:"raw,omitempty"`

	// Text The string content of the `text` part.
	Text *string `json:"text,omitempty"`

	// URL A `url` pointing to the file's content.
	URL *string `json:"url,omitempty"`
}

type PasswordOAuthFlow struct {
	// RefreshURL The URL to be used for obtaining refresh tokens. This MUST be in the
	//  form of a URL. The OAuth2 standard requires the use of TLS.
	RefreshURL *string `json:"refreshUrl,omitempty"`

	// Scopes The available scopes for the OAuth2 security scheme. A map between the
	//  scope name and a short description for it. The map MAY be empty.
	Scopes map[string]string `json:"scopes,omitempty"`

	// TokenURL The token URL to be used for this flow. This MUST be in the form of a URL.
	//  The OAuth2 standard requires the use of TLS.
	TokenURL *string `json:"tokenUrl,omitempty"`
}

type Role string

type SecurityRequirement struct {
	// Schemes A map of security schemes to the required scopes.
	Schemes map[string]StringList `json:"schemes,omitempty"`
}

type SecurityScheme struct {
	// APIKeySecurityScheme API key-based authentication.
	APIKeySecurityScheme *APIKeySecurityScheme `json:"apiKeySecurityScheme,omitempty"`

	// HTTPAuthSecurityScheme HTTP authentication (Basic, Bearer, etc.).
	HTTPAuthSecurityScheme *HTTPAuthSecurityScheme `json:"httpAuthSecurityScheme,omitempty"`

	// MtlsSecurityScheme Mutual TLS authentication.
	MtlsSecurityScheme *MutualTLSSecurityScheme `json:"mtlsSecurityScheme,omitempty"`

	// Oauth2SecurityScheme OAuth 2.0 authentication.
	Oauth2SecurityScheme *OAuth2SecurityScheme `json:"oauth2SecurityScheme,omitempty"`

	// OpenIDConnectSecurityScheme OpenID Connect authentication.
	OpenIDConnectSecurityScheme *OpenIDConnectSecurityScheme `json:"openIdConnectSecurityScheme,omitempty"`
}

type SendMessageConfiguration struct {
	// AcceptedOutputModes A list of media types the client is prepared to accept for response parts.
	//  Agents SHOULD use this to tailor their output.
	AcceptedOutputModes []string `json:"acceptedOutputModes,omitempty"`

	// HistoryLength The maximum number of most recent messages from the task's history to retrieve in
	//  the response. An unset value means the client does not impose any limit. A
	//  value of zero is a request to not include any messages. The server MUST NOT
	//  return more messages than the provided value, but MAY apply a lower limit.
	HistoryLength *int `json:"historyLength,omitempty"`

	// ReturnImmediately If `true`, the operation returns immediately after creating the task,
	//  even if processing is still in progress.
	//  If `false` (default), the operation MUST wait until the task reaches a
	//  terminal (`COMPLETED`, `FAILED`, `CANCELED`, `REJECTED`) or interrupted
	//  (`INPUT_REQUIRED`, `AUTH_REQUIRED`) state before returning.
	ReturnImmediately *bool `json:"returnImmediately,omitempty"`

	// TaskPushNotificationConfig Configuration for the agent to send push notifications for task updates.
	//  Task id should be empty when sending this configuration in a `SendMessage` request.
	TaskPushNotificationConfig *TaskPushNotificationConfig `json:"taskPushNotificationConfig,omitempty"`
}

type SendMessageRequest struct {
	// Configuration Configuration for the send request.
	Configuration *SendMessageConfiguration `json:"configuration,omitempty"`

	// Message The message to send to the agent.
	Message Message `json:"message"`

	// Metadata A flexible key-value map for passing additional context or parameters.
	Metadata *Struct `json:"metadata,omitempty"`

	// Tenant Optional. Opaque routing identifier. Must match the `tenant` value from
	//  the selected `AgentInterface` in the Agent Card when that field is set.
	Tenant *string `json:"tenant,omitempty"`
}

type SendMessageResponse struct {
	// Message A message from the agent.
	Message *Message `json:"message,omitempty"`

	// Task The task created or updated by the message.
	Task *Task `json:"task,omitempty"`
}

type StreamResponse struct {
	// ArtifactUpdate An event indicating a task artifact update.
	ArtifactUpdate *TaskArtifactUpdateEvent `json:"artifactUpdate,omitempty"`

	// Message A Message object containing a message from the agent.
	Message *Message `json:"message,omitempty"`

	// StatusUpdate An event indicating a task status update.
	StatusUpdate *TaskStatusUpdateEvent `json:"statusUpdate,omitempty"`

	// Task A Task object containing the current state of the task.
	Task *Task `json:"task,omitempty"`
}

type StringList struct {
	// List The individual string values.
	List []string `json:"list,omitempty"`
}

type Struct = map[string]any

type SubscribeToTaskRequest struct {
	// ID The resource ID of the task to subscribe to.
	ID string `json:"id"`

	// Tenant Optional. Opaque routing identifier. Must match the `tenant` value from
	//  the selected `AgentInterface` in the Agent Card when that field is set.
	Tenant *string `json:"tenant,omitempty"`
}

type Task struct {
	// Artifacts A set of output artifacts for a `Task`.
	Artifacts []Artifact `json:"artifacts,omitempty"`

	// ContextID Unique identifier (e.g. UUID) for the contextual collection of interactions
	//  (tasks and messages).
	ContextID *string `json:"contextId,omitempty"`

	// History protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
	//  The history of interactions from a `Task`.
	History []Message `json:"history,omitempty"`

	// ID Unique identifier (e.g. UUID) for the task, generated by the server for a
	//  new task.
	ID string `json:"id"`

	// Metadata protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
	//  A key/value object to store custom metadata about a task.
	Metadata *Struct `json:"metadata,omitempty"`

	// Status The current status of a `Task`, including `state` and a `message`.
	Status TaskStatus `json:"status"`
}

type TaskArtifactUpdateEvent struct {
	// Append If true, the content of this artifact should be appended to a previously
	//  sent artifact with the same ID.
	Append *bool `json:"append,omitempty"`

	// Artifact The artifact that was generated or updated.
	Artifact Artifact `json:"artifact"`

	// ContextID The ID of the context that this task belongs to.
	ContextID string `json:"contextId"`

	// LastChunk If true, this is the final chunk of the artifact.
	LastChunk *bool `json:"lastChunk,omitempty"`

	// Metadata Optional. Metadata associated with the artifact update.
	Metadata *Struct `json:"metadata,omitempty"`

	// TaskID The ID of the task for this artifact.
	TaskID string `json:"taskId"`
}

type TaskPushNotificationConfig struct {
	// Authentication Authentication information required to send the notification.
	Authentication *AuthenticationInfo `json:"authentication,omitempty"`

	// ID The push notification configuration details.
	//  A unique identifier (e.g. UUID) for this push notification configuration.
	ID *string `json:"id,omitempty"`

	// TaskID The ID of the task this configuration is associated with.
	TaskID *string `json:"taskId,omitempty"`

	// Tenant Optional. Opaque routing identifier. Must match the `tenant` value from
	//  the selected `AgentInterface` in the Agent Card when that field is set.
	Tenant *string `json:"tenant,omitempty"`

	// Token A token unique for this task or session.
	Token *string `json:"token,omitempty"`

	// URL The URL where the notification should be sent.
	URL string `json:"url"`
}

type TaskState string

type TaskStatus struct {
	// Message A message associated with the status.
	Message *Message `json:"message,omitempty"`

	// State Filter tasks by their current status state.
	State TaskState `json:"state"`

	// Timestamp ISO 8601 Timestamp when the status was recorded.
	//  Example: "2023-10-27T10:00:00Z"
	Timestamp *Timestamp `json:"timestamp,omitempty"`
}

type TaskStatusUpdateEvent struct {
	// ContextID The ID of the context that the task belongs to.
	ContextID string `json:"contextId"`

	// Metadata Optional. Metadata associated with the task update.
	Metadata *Struct `json:"metadata,omitempty"`

	// Status The new status of the task.
	Status TaskStatus `json:"status"`

	// TaskID The ID of the task that has changed.
	TaskID string `json:"taskId"`
}

type Timestamp = time.Time

type Value = interface{}