Struct HandlerLimits 

pub struct HandlerLimits {
    pub max_id_length: usize,
    pub max_metadata_size: usize,
    pub max_cancellation_tokens: usize,
    pub max_token_age: Duration,
    pub push_delivery_timeout: Duration,
    pub max_artifacts_per_task: usize,
}

Configurable limits for the request handler.

All fields have sensible defaults. Create with HandlerLimits::default() and override individual values as needed.

Example

use a2a_protocol_server::handler::HandlerLimits;

let limits = HandlerLimits::default()
    .with_max_id_length(2048)
    .with_max_metadata_size(2 * 1024 * 1024);

Fields

max_id_length: usize

Maximum allowed length for task/context IDs. Default: 1024.

max_metadata_size: usize

Maximum allowed serialized size for metadata fields in bytes. Default: 1 MiB.

max_cancellation_tokens: usize

Maximum cancellation token map entries before cleanup sweep. Default: 10,000.

max_token_age: Duration

Maximum age for cancellation tokens. Default: 1 hour.

push_delivery_timeout: Duration

Timeout for individual push webhook deliveries. Default: 5 seconds.

Bounds how long the handler waits for a single push notification delivery to complete, preventing one slow webhook from blocking all subsequent deliveries.

max_artifacts_per_task: usize

Maximum number of artifacts per task. Default: 1000.

Prevents unbounded memory growth and O(n²) serialization cost when executors emit many artifacts. Once the limit is reached, new artifact updates are rejected.

Implementations

impl HandlerLimits

pub const fn with_max_id_length(self, length: usize) -> HandlerLimits

Sets the maximum allowed length for task/context IDs.

pub const fn with_max_metadata_size(self, size: usize) -> HandlerLimits

Sets the maximum serialized size for metadata fields in bytes.

pub const fn with_max_cancellation_tokens(self, max: usize) -> HandlerLimits

Sets the maximum cancellation token map entries before cleanup.

pub const fn with_max_token_age(self, age: Duration) -> HandlerLimits

Sets the maximum age for cancellation tokens.

pub const fn with_push_delivery_timeout( self, timeout: Duration, ) -> HandlerLimits

Sets the timeout for individual push webhook deliveries.

pub const fn with_max_artifacts_per_task(self, max: usize) -> HandlerLimits

Sets the maximum number of artifacts per task.

Trait Implementations

impl Clone for HandlerLimits

fn clone(&self) -> HandlerLimits

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HandlerLimits

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

Formats the value using the given formatter.

impl Default for HandlerLimits

fn default() -> HandlerLimits

Returns the “default value” for a type.