Struct Artifact 

pub struct Artifact {
    pub id: ArtifactId,
    pub name: Option<String>,
    pub description: Option<String>,
    pub parts: Vec<Part>,
    pub extensions: Option<Vec<String>>,
    pub metadata: Option<Value>,
}

An output artifact produced by an agent.

Each artifact has a unique ArtifactId and carries its content as a non-empty list of Part values.

Fields

id: ArtifactId

Unique artifact identifier.

name: Option<String>

Optional human-readable name.

description: Option<String>

Optional human-readable description.

parts: Vec<Part>

Content parts.

Spec requirement: Must contain at least one element. The A2A protocol does not define behavior for empty parts lists.

Parsing treats absence as empty (ProtoJSON printers omit empty repeated fields; the gRPC binding already decodes it that way) — the server-side event processors drop empty-parts artifacts explicitly.

extensions: Option<Vec<String>>

URIs of extensions used in this artifact.

metadata: Option<Value>

Arbitrary metadata.

Implementations

impl Artifact

pub fn new(id: impl Into<ArtifactId>, parts: Vec<Part>) -> Artifact

Creates a minimal Artifact with an ID and parts.

Panics

Panics in debug builds if parts is empty. Use Artifact::validate for fallible validation.

pub fn text(&self) -> Option<&str>

Returns the text of the first text Part, or None if this artifact carries no text part.

The client-side counterpart to Message::text: reading an agent’s textual result is the most common operation once a task completes.

use a2a_protocol_types::artifact::Artifact;
use a2a_protocol_types::message::Part;

let artifact = Artifact::new("result", vec![Part::text("done")]);
assert_eq!(artifact.text(), Some("done"));

pub fn texts(&self) -> impl Iterator<Item = &str>

Returns the text of every text Part, in order, skipping non-text parts.

pub fn validate(&self) -> Result<(), A2aError>

Validates this artifact against A2A spec requirements.

Errors

Returns A2aError with ErrorCode::InvalidParams if parts is empty.

Trait Implementations

impl Clone for Artifact

fn clone(&self) -> Artifact

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Artifact

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Artifact

fn deserialize<__D>( __deserializer: __D, ) -> Result<Artifact, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Artifact

impl PartialEq for Artifact

fn eq(&self, other: &Artifact) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Artifact

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Artifact

impl TryFrom<Artifact> for Artifact

type Error = ConvertError

The type returned in the event of a conversion error.

fn try_from( value: Artifact, ) -> Result<Artifact, <Artifact as TryFrom<Artifact>>::Error>

Performs the conversion.

impl TryFrom<Artifact> for Artifact

type Error = ConvertError

The type returned in the event of a conversion error.

fn try_from( value: Artifact, ) -> Result<Artifact, <Artifact as TryFrom<Artifact>>::Error>

Performs the conversion.