Struct AgentConnectionPool 

pub struct AgentConnectionPool { /* private fields */ }

Agent connection pool for efficient connection reuse.

The pool maintains a set of idle connections that can be reused across requests, avoiding the overhead of creating a new connection for each request.

Implementations

impl AgentConnectionPool

pub fn new( max_connections: usize, min_idle: usize, max_idle: usize, idle_timeout: Duration, ) -> Self

Create a new connection pool.

Arguments

• max_connections - Maximum total connections (active + idle)
• min_idle - Minimum idle connections to maintain
• max_idle - Maximum idle connections to keep in pool
• idle_timeout - How long an idle connection can stay in the pool

pub fn try_get(&self) -> Option<PooledConnection>

Try to get a connection from the pool.

Returns Some(connection) if an idle connection is available, None if the pool is empty (caller should create a new connection).

Performance

This operation is O(1) and completes in ~100-500ns.

pub fn return_connection(&self, conn: PooledConnection)

Return a connection to the pool.

If the pool is at capacity, the connection is dropped.

Performance

This operation is O(1) and completes in ~100-500ns.

pub fn can_create(&self) -> bool

Check if we can create a new connection without exceeding limits.

Returns true if a new connection can be created.

pub fn register_created(&self)

Register that a new connection was created.

Call this after successfully creating a new connection.

pub fn mark_failed(&self)

Mark a connection as failed (without returning it to pool).

Call this when a connection fails and should not be reused.

pub fn active_count(&self) -> u32

Get active connection count (connections currently in use).

pub fn idle_count(&self) -> usize

Get idle connection count (connections waiting in pool).

pub fn total_created(&self) -> u64

Get total connections created over lifetime.

pub fn total_acquired(&self) -> u64

Get total connections acquired from pool.

pub fn total_returned(&self) -> u64

Get total connections returned to pool.

pub fn stats(&self) -> PoolStats

Get pool statistics.

pub fn clear(&self)

Evict all idle connections from the pool.

Useful for graceful shutdown or when the agent configuration changes.

pub fn evict_expired(&self) -> usize

Evict expired connections from the pool.

Call this periodically to clean up stale connections.