Struct CachingCardResolver 

pub struct CachingCardResolver { /* private fields */ }

A caching agent card resolver.

Stores the last fetched card and uses conditional HTTP requests (If-None-Match, If-Modified-Since) to avoid unnecessary re-downloads (spec §8.3).

Implementations

impl CachingCardResolver

pub fn new(base_url: &str) -> ClientResult<Self>

Creates a new resolver for the given agent card URL.

Errors

Returns ClientError::InvalidEndpoint if base_url is malformed (empty, missing scheme, etc.).

pub fn with_path(base_url: &str, path: &str) -> ClientResult<Self>

Creates a new resolver with a custom path.

Errors

Returns ClientError::InvalidEndpoint if base_url is malformed.

pub async fn resolve(&self) -> ClientResult<AgentCard>

Resolves the agent card, using a cached version if valid.

Sends conditional request headers when a cached card exists. On 304, returns the cached card. On 200, updates the cache and returns the new card.

Errors

Same conditions as resolve_agent_card.

pub async fn invalidate(&self)

Clears the internal cache.

Trait Implementations

impl Clone for CachingCardResolver

fn clone(&self) -> CachingCardResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CachingCardResolver

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

Formats the value using the given formatter.