a2a

type AgentCard struct {
	// Name is the agent's display name.
	Name string
	// Description explains the agent's purpose.
	Description string
	// URL is the preferred endpoint advertised by the agent.
	URL string
	// Version is the agent implementation version.
	Version string
	// DocumentationURL points to human-readable agent documentation.
	DocumentationURL string
	// IconURL points to the agent's display icon.
	IconURL string
	// Provider identifies the organization operating the agent, when declared.
	Provider *Provider
	// Capabilities describes optional protocol behavior.
	Capabilities Capabilities
	// DefaultInputModes lists accepted input media types.
	DefaultInputModes []string
	// DefaultOutputModes lists produced output media types.
	DefaultOutputModes []string
	// Skills describes the operations advertised by the agent.
	Skills []Skill
	// SupportedInterfaces lists usable protocol endpoints.
	SupportedInterfaces []AgentInterface
	// Fingerprint is a deterministic digest of the validated discovery document.
	Fingerprint string
	// Raw preserves the normalized discovery payload.
	Raw map[string]any
}

type AgentInterface struct {
	// URL is the absolute endpoint URL.
	URL string
	// ProtocolBinding identifies the endpoint's transport binding.
	ProtocolBinding TransportProtocol
	// Tenant is the endpoint's optional tenant selector.
	Tenant string
	// ProtocolVersion is the A2A protocol version implemented by the endpoint.
	ProtocolVersion string
}

type Artifact struct {
	// ID is the artifact identifier.
	ID string
	// Name is the artifact's display name.
	Name string
	// Description explains the artifact contents.
	Description string
	// Parts contains the ordered artifact content.
	Parts []Part
	// Extensions lists extension URIs used by the artifact.
	Extensions []string
	// Metadata preserves application-defined artifact metadata.
	Metadata map[string]any
	// Raw preserves the normalized protocol artifact.
	Raw map[string]any
}

type Auth interface {
	Wrap(base http.RoundTripper) http.RoundTripper
	Headers() map[string]string
}

type CancelTaskRequest struct {
	// TaskID identifies the task to cancel.
	TaskID string
	// Tenant selects the remote tenant when supported.
	Tenant string
	// Metadata contains application-defined cancellation metadata.
	Metadata map[string]any
}

type Capabilities struct {
	// Streaming reports support for streaming message execution.
	Streaming bool
	// PushNotifications reports support for push notification configuration.
	PushNotifications bool
	// ExtendedAgentCard reports support for authenticated extended discovery.
	ExtendedAgentCard bool
	// Extensions lists additional advertised protocol features.
	Extensions []Extension
}

type Client struct {
	// contains filtered or unexported fields
}

type Event struct {
	// Kind identifies the event payload and lifecycle meaning.
	Kind EventKind
	// Task contains a full task snapshot for task events.
	Task *Task
	// Message contains a message event payload.
	Message *Message
	// Status contains a status update payload.
	Status *TaskStatus
	// Artifact contains an artifact update payload.
	Artifact *Artifact
	// TaskID identifies the affected task.
	TaskID string
	// ContextID identifies the affected conversation context.
	ContextID string
	// Append reports that artifact content appends to earlier content.
	Append bool
	// LastChunk reports that an artifact update is complete.
	LastChunk bool
	// RecoveredState reports that the terminal event was reconstructed with GetTask.
	RecoveredState bool
	// Raw preserves the normalized protocol event.
	Raw map[string]any
}

type EventKind string

type Extension struct {
	// URI uniquely identifies the extension contract.
	URI string
	// Description explains the extension's behavior.
	Description string
	// Required reports whether clients must understand the extension.
	Required bool
	// Params preserves extension-specific parameters.
	Params map[string]any
}

type GetTaskRequest struct {
	// TaskID identifies the task to retrieve.
	TaskID string
	// Tenant selects the remote tenant when supported.
	Tenant string
	// HistoryLength limits message history returned with the task.
	HistoryLength *int
}

type Message struct {
	// ID is the message identifier assigned by its producer.
	ID string
	// Role identifies the message author role.
	Role string
	// TaskID associates the message with a task, when available.
	TaskID string
	// ContextID associates the message with a remote conversation context.
	ContextID string
	// Parts contains the ordered message content.
	Parts []Part
	// ReferenceTasks lists tasks referenced by this message.
	ReferenceTasks []string
	// Extensions lists extension URIs used by this message.
	Extensions []string
	// Metadata preserves application-defined message metadata.
	Metadata map[string]any
	// Raw preserves the normalized protocol message.
	Raw map[string]any
}

type Options struct {
	// AgentCardURL is the absolute URL used to discover the remote agent.
	AgentCardURL string
	// AgentCardPath overrides the discovery path derived from AgentCardURL.
	AgentCardPath string
	// Auth supplies credentials for trusted discovery and agent endpoints.
	Auth Auth
	// HTTPClient supplies transport settings. A nil value uses http.DefaultClient.
	HTTPClient *http.Client
	// TrustedAuthOrigins are additional absolute origins allowed to receive Auth.
	TrustedAuthOrigins []string
	// AcceptedOutputModes restrict the media types accepted from the agent.
	AcceptedOutputModes []string
	// PreferredTransports orders the protocol bindings considered by discovery.
	PreferredTransports []TransportProtocol
}

type Part struct {
	// Kind identifies which content field is populated.
	Kind PartKind
	// Text contains text content.
	Text string
	// Raw contains inline binary content.
	Raw []byte
	// Data contains structured data content.
	Data any
	// URL identifies remotely hosted content.
	URL string
	// MediaType is the content MIME type.
	MediaType string
	// Filename is the suggested content filename.
	Filename string
	// Metadata preserves application-defined part metadata.
	Metadata map[string]any
}

type PartKind string

type ProtocolError struct {
	// Op is the protocol operation that failed.
	Op string
	// Reason is the remote or validation error description.
	Reason string
	// Cause supports errors.Is and errors.As classification.
	Cause error
	// Raw preserves structured error details when the transport provides them.
	Raw map[string]any
}

type Provider struct {
	// Organization is the provider's display name.
	Organization string
	// URL is the provider's public URL.
	URL string
}

type SendRequest struct {
	// Message is the message to send.
	Message Message
	// ContextID continues a remote conversation context when non-empty.
	ContextID string
	// TaskID associates the message with an existing task when non-empty.
	TaskID string
	// Tenant selects the remote tenant when supported.
	Tenant string
	// AcceptedOutputModes restricts acceptable response media types.
	AcceptedOutputModes []string
	// ReturnImmediately requests an immediate protocol response.
	ReturnImmediately bool
	// HistoryLength limits task history returned with the result.
	HistoryLength *int
	// Metadata contains application-defined request metadata.
	Metadata map[string]any
}

type Skill struct {
	// ID is the stable protocol identifier for the skill.
	ID string
	// Name is the skill's display name.
	Name string
	// Description explains the skill's behavior.
	Description string
	// Tags provide discovery keywords.
	Tags []string
	// Examples contain representative requests.
	Examples []string
	// InputModes lists accepted media types for the skill.
	InputModes []string
	// OutputModes lists media types the skill may produce.
	OutputModes []string
}

type Stream struct {
	// contains filtered or unexported fields
}

type StreamRecoveryError struct {
	// TaskID is the last task identifier observed before disconnection.
	TaskID string
	// Cause is the transport or protocol error that ended the stream.
	Cause error
}

type SubscribeRequest struct {
	// TaskID identifies the task to subscribe to.
	TaskID string
	// Tenant selects the remote tenant when supported.
	Tenant string
	// Since is rejected when set. A2A 1.0 SubscribeToTask has no cursor replay
	// field, and the client refuses to pretend host-side replay cursors are
	// supported by the remote protocol.
	Since string
}

type Task struct {
	// ID is the remote task identifier.
	ID string
	// ContextID is the remote conversation context identifier.
	ContextID string
	// Status is the task's current execution state.
	Status TaskStatus
	// Messages contains task conversation history returned by the server.
	Messages []Message
	// Artifacts contains outputs produced by the task.
	Artifacts []Artifact
	// Metadata preserves application-defined task metadata.
	Metadata map[string]any
	// Raw preserves the normalized protocol task.
	Raw map[string]any
}

type TaskState string

type TaskStatus struct {
	// State is the normalized task lifecycle state.
	State TaskState
	// Message provides status detail when supplied by the server.
	Message *Message
	// Timestamp is the server-reported status time.
	Timestamp *time.Time
}

type TransportProtocol string