data

A2A Protocol v1.0 Data Structures

Structs

`Task`

Task: Core A2A work unit (v1.0)

Fields

Field	Type	Description
`id`	`String`
`context_id`	`String`
`status`	`TaskStatus`
`history`	`Option<Vec<Message>>`
`artifacts`	`Option<Vec<Artifact>>`
`metadata`	`Option<HashMap<String, serde_json::Value>>`

Methods

`new`

fn new(context_id: String) -> Self

`with_id`

fn with_id(id: String, context_id: String) -> Self

`update_status`

fn update_status(&mut self, state: TaskState)

`update_status_with_message`

fn update_status_with_message(&mut self, state: TaskState, message: Message)

`add_artifact`

fn add_artifact(&mut self, artifact: Artifact)

`add_to_history`

fn add_to_history(&mut self, message: Message)

`set_metadata`

fn set_metadata(&mut self, key: String, value: Value)

`is_terminal`

fn is_terminal(&self) -> bool

`is_active`

fn is_active(&self) -> bool

`TaskStatus`

Task Status: Current state with optional message.

Fields

Field	Type	Description
`state`	`TaskState`
`message`	`Option<Message>`
`timestamp`	`Option<String>`

Methods

`new`

fn new(state: TaskState) -> Self

`update_timestamp`

fn update_timestamp(&mut self)

`Message`

Message: Core A2A communication object (v1.0)

Fields

Field	Type	Description
`role`	`MessageRole`
`parts`	`Vec<Part>`
`message_id`	`String`
`task_id`	`Option<String>`
`context_id`	`Option<String>`
`metadata`	`Option<HashMap<String, serde_json::Value>>`
`extensions`	`Option<Vec<String>>`
`reference_task_ids`	`Option<Vec<String>>`

Methods

`new`

fn new(role: MessageRole, parts: Vec<Part>, task_id: String) -> Self

`with_id`

fn with_id(message_id: String, role: MessageRole, parts: Vec<Part>) -> Self

`text`

fn text<impl Into<String>>(role: MessageRole, text: impl Into, task_id: String) -> Self

`status`

fn status<impl Into<String>>(text: impl Into, task_id: String) -> Self

`error`

fn error<impl Into<String>>(text: impl Into, task_id: String) -> Self

`add_part`

fn add_part(&mut self, part: Part)

`set_metadata`

fn set_metadata(&mut self, key: String, value: Value)

`with_context`

fn with_context(self, context_id: String) -> Self

`add_extension`

fn add_extension(&mut self, extension: String)

`get_text_content`

fn get_text_content(&self) -> String

`is_text_only`

fn is_text_only(&self) -> bool

`get_data_parts`

fn get_data_parts(&self) -> Vec<&Part>

`Part`

Part: Flat multi-modal content container (v1.0)

A Part carries exactly one of: text, raw (base64), url, or structured data. Additional fields (filename, media_type, metadata) annotate the content.

Fields

Field	Type	Description
`text`	`Option<String>`
`raw`	`Option<String>`
`url`	`Option<String>`
`data`	`Option<serde_json::Value>`
`metadata`	`Option<HashMap<String, serde_json::Value>>`
`filename`	`Option<String>`
`media_type`	`Option<String>`

Methods

`text`

fn text<impl Into<String>>(text: impl Into) -> Self

Text-only part.

`data`

fn data(value: Value) -> Self

Structured data part.

`url`

fn url<impl Into<String>>(uri: impl Into) -> Self

URL reference part.

`raw`

fn raw<impl Into<String>>(base64: impl Into) -> Self

Base64-encoded raw bytes part.

`url_with_media`

fn url_with_media<impl Into<String>, impl Into<String>>(uri: impl Into, media_type: impl Into) -> Self

URL part with media type annotation.

`is_text`

fn is_text(&self) -> bool

Check which content variant is populated.

`is_data`

fn is_data(&self) -> bool

`is_url`

fn is_url(&self) -> bool

`is_raw`

fn is_raw(&self) -> bool

`get_text`

fn get_text(&self) -> Option<&str>

Extract text content (if present).

`Artifact`

Artifact: Agent output (v1.0 shape)

Fields

Field	Type	Description
`artifact_id`	`String`
`name`	`Option<String>`
`description`	`Option<String>`
`parts`	`Vec<Part>`
`metadata`	`Option<HashMap<String, serde_json::Value>>`
`extensions`	`Option<Vec<String>>`

Methods

`new`

fn new(parts: Vec<Part>) -> Self

Create an artifact with a generated ID.

`text`

fn text<impl Into<String>>(text: impl Into) -> Self

Create a simple text artifact.

`data`

fn data(value: Value) -> Self

Create a data artifact.

`with_name`

fn with_name<impl Into<String>>(self, name: impl Into) -> Self

Builder: set name.

`with_description`

fn with_description<impl Into<String>>(self, description: impl Into) -> Self

Builder: set description.

`with_id`

fn with_id<impl Into<String>>(self, id: impl Into) -> Self

Builder: set artifact_id explicitly.

`set_metadata`

fn set_metadata(&mut self, key: String, value: Value)

`get_text_content`

fn get_text_content(&self) -> Option<&str>

Extract text from the first text part (convenience).

`get_data_content`

fn get_data_content(&self) -> Option<&Value>

Extract data from the first data part (convenience).

`AuthenticationInfo`

Authentication information for push notification delivery.

Fields

Field	Type	Description
`scheme`	`String`
`credentials`	`String`

`TaskPushNotificationConfig`

Per-task push notification configuration (v1.0).

Fields

Field	Type	Description
`tenant`	`Option<String>`
`id`	`String`
`task_id`	`String`
`url`	`String`
`token`	`Option<String>`
`authentication`	`Option<AuthenticationInfo>`

Methods

`new`

fn new<impl Into<String>, impl Into<String>, impl Into<String>>(id: impl Into, task_id: impl Into, url: impl Into) -> Self

`with_tenant`

fn with_tenant<impl Into<String>>(self, tenant: impl Into) -> Self

`with_token`

fn with_token<impl Into<String>>(self, token: impl Into) -> Self

`with_authentication`

fn with_authentication(self, auth: AuthenticationInfo) -> Self

Enums

`TaskState`

Task State: A2A v1.0 SCREAMING_SNAKE enum.

Variants

Variant	Description
`Unspecified`
`Submitted`
`Working`
`InputRequired`
`Completed`
`Failed`
`Canceled`
`Rejected`
`AuthRequired`

Methods

`is_terminal`

fn is_terminal(&self) -> bool

Returns true for terminal states: Completed, Failed, Canceled, Rejected.

`is_active`

fn is_active(&self) -> bool

Returns true for active states: Submitted, Working, InputRequired.

`as_str`

fn as_str(&self) -> &''static str

Lowercase string for logging/display (not wire format).

`MessageRole`

Message Role (v1.0 — SCREAMING_SNAKE serialization)

Variants

Variant	Description
`Unspecified`
`User`
`Agent`