Struct Proxy 

pub struct Proxy;

The proxy role - an intermediary that can intercept and modify messages.

Proxies sit between a client and an agent (or another proxy), and can:

• Add tools via MCP servers
• Filter or transform messages
• Inject additional context

Proxies connect to a Conductor which orchestrates the proxy chain.

Implementations

impl Proxy

pub fn builder(self) -> Builder<Proxy, NullHandler, NullRun>

Create a stable protocol v1 connection builder for a proxy.

Use Proxy::v2 for a protocol-v2-only proxy with typed callbacks and wire validation. Protocol-routing infrastructure that deliberately selects a version itself can disable the guard with Builder::without_acp_version_guard.

pub fn v2(self) -> V2Builder<Proxy, NullHandler, NullRun>

Available on crate feature unstable_protocol_v2 only.

Create a proxy builder that uses the ACP protocol v2 API.

This builder requires _proxy/initialize to select protocol v2. Fluent callbacks receive crate::V2ConnectionTo<Conductor>, while low-level custom handlers and runners retain the protocol-neutral ConnectionTo interface.

Requires the unstable_protocol_v2 crate feature.

pub fn protocol_router(self) -> ProxyProtocolRouter

Available on crate feature unstable_protocol_v2 only.

Create a router that chooses between configured proxy implementations.

Add implementations with ProxyProtocolRouter::with_v1 and ProxyProtocolRouter::with_v2. The router reads the initial _proxy/initialize request, selects the implementation for that exact protocol version, and hands over the complete initial transport frame. It does not downgrade proxy traffic or convert later messages.

Requires the unstable_protocol_v2 crate feature while protocol v2 stabilizes.

Trait Implementations

impl Clone for Proxy

fn clone(&self) -> Proxy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Proxy

impl Debug for Proxy

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

Formats the value using the given formatter.

impl Default for Proxy

fn default() -> Proxy

Returns the “default value” for a type.

impl Eq for Proxy

impl HasPeer<Proxy> for Proxy

fn remote_style(&self, _peer: Proxy) -> RemoteStyle

Returns the remote style for sending to this peer.

impl Hash for Proxy

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Proxy

fn cmp(&self, other: &Proxy) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Proxy

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Proxy

fn partial_cmp(&self, other: &Proxy) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Role for Proxy

type Counterpart = Conductor

The role that this endpoint connects to.

fn default_handle_dispatch_from( &self, message: Dispatch, _connection: ConnectionTo<Self>, ) -> impl Future<Output = Result<Handled<Dispatch>, Error>> + Send

Method invoked when there is no defined message handler.

fn role_id(&self) -> RoleId

Returns a unique identifier for this role.

fn counterpart(&self) -> Self::Counterpart

Returns the counterpart role.

fn builder(self) -> Builder<Self>

where Self: Sized,

Creates a new builder playing this role.

impl StructuralPartialEq for Proxy