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 v1(self) -> Builder<Proxy>

Create a stable protocol v1 connection builder for a proxy.

The proxy negotiates proxy/initialize the way a v1 agent negotiates initialize: it selects v1 for every requested version. A request for a newer version keeps what parses under v1, and one below v1 keeps v1’s fallback-to-latest rule.

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 use the unguarded Builder::new(Proxy).

Typed handlers on this builder receive V1 request handles.

pub fn v2(self) -> Builder<Proxy>

Available on crate feature unstable_protocol_v2 only.

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

The proxy negotiates proxy/initialize the way a v2 agent negotiates initialize: it selects v2 for a request for v2 or newer, keeping what parses under v2 for a newer request, and rejects a request below v2 with -32022. Fluent callbacks receive v2::ConnectionTo<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 and selects an implementation exactly as Agent::protocol_router does for initialize: a request for v2 or newer selects the v2 implementation, keeping what parses under v2 for a newer request. With a v1 implementation configured, everything else is handed to the v1 implementation, which negotiates it as it would without the router. A v2-only router rejects a request below v2 with -32022. Like the agent router, it answers each rejected request or malformed frame with an error and keeps reading, so the conductor can send proxy/initialize again. A request for exactly the selected version is handed over in the complete, unchanged initial transport frame. The router does not convert later messages.

Requires the unstable_protocol_v2 crate feature while protocol v2 stabilizes.

Trait Implementations

impl Clone for Proxy

fn clone(&self) -> Self

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() -> Self

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: &Self) -> 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: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Proxy

fn partial_cmp(&self, other: &Self) -> 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.

impl StructuralPartialEq for Proxy