Struct CardFetchOptions 

pub struct CardFetchOptions { /* private fields */ }

What a card fetch sends and how long it may take.

resolve_agent_card and fetch_card_from_url send no headers and allow the whole call 30 seconds. Both were fixed until 0.12, which meant a card behind authentication could not be fetched at all and the budget could not be shortened for a peer that is expected to answer at once. The _with_options variants take one of these instead.

The timeout is one deadline for connect, headers and body together — see the note on the default — not a per-phase bound.

use std::time::Duration;
use a2a_protocol_client::discovery::CardFetchOptions;

let options = CardFetchOptions::default()
    .with_header("authorization", "Bearer s3cret")
    .with_timeout(Duration::from_secs(5));
assert_eq!(options.timeout(), Duration::from_secs(5));
assert_eq!(options.headers().len(), 1);

Implementations

impl CardFetchOptions

pub fn with_header( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

Adds one header to the request. An invalid name or value is reported by the fetch as ClientError::Transport, not here.

pub fn with_headers(self, headers: HashMap<String, String>) -> Self

Replaces the headers sent with the request.

pub const fn with_timeout(self, timeout: Duration) -> Self

Sets the budget for the whole fetch: connect, headers and body.

pub const fn headers(&self) -> &HashMap<String, String>

The headers the request will carry.

pub const fn timeout(&self) -> Duration

The budget for the whole fetch.

Trait Implementations

impl Clone for CardFetchOptions

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CardFetchOptions

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

Formats the value using the given formatter.

impl Default for CardFetchOptions

fn default() -> Self

No headers; the 30-second budget the plain functions use.