Struct Client 

pub struct Client;

The client role - typically an IDE or CLI that controls an agent.

Clients send prompts and receive responses from agents.

Implementations

impl Client

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

Create a connection builder for a client.

pub fn v2(self) -> Builder<Client, NullHandler, NullRun>

Available on crate feature unstable_protocol_v2 only.

Create a client builder that requires an ACP protocol v2 agent.

If the agent negotiates v1 during initialization, the initialize request resolves with an error so callers can choose an explicit v1 fallback path.

Requires the unstable_protocol_v2 crate feature.

pub fn protocol_connector(self) -> ClientProtocolConnector

Available on crate feature unstable_protocol_v2 only.

Create a connector that chooses between configured protocol implementations.

Add implementation factories with ClientProtocolConnector::with_v1 and ClientProtocolConnector::with_v2. The resulting connector starts the highest configured protocol implementation. If a v2 implementation successfully negotiates v1 and a v1 implementation is configured, the connector reuses the connection only when the v1 implementation’s initialize metadata and capabilities match what the agent already saw; otherwise it opens a fresh agent connection and restarts with v1.

Requires the unstable_protocol_v2 crate feature while protocol v2 stabilizes.

pub async fn connect_with<R>( self, agent: impl ConnectTo<Client>, main_fn: impl AsyncFnOnce(ConnectionTo<Agent>) -> Result<R, Error>, ) -> Result<R, Error>

Connect to agent and run main_fn with the ConnectionTo. Returns the result of main_fn (or an error if something goes wrong).

Equivalent to self.builder().connect_with(agent, main_fn).

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConnectTo<Client> for AgentProtocolRouter

Available on crate feature unstable_protocol_v2 only.

async fn connect_to(self, client: impl ConnectTo<Agent>) -> Result<(), Error>

Serve this component by forwarding to a client component.

fn into_channel_and_future(self) -> (Channel, BoxFuture<'static, Result<()>>)

where Self: Sized,

Convert this component into a channel endpoint and server future.

impl Copy for Client

impl Debug for Client

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

Formats the value using the given formatter.

impl Default for Client

fn default() -> Client

Returns the “default value” for a type.

impl Eq for Client

impl HasPeer<Client> for Client

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

Returns the remote style for sending to this peer.

impl HasPeer<Client> for Conductor

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

Returns the remote style for sending to this peer.

impl Hash for Client

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 Client

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

impl PartialEq for Client

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Client

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

type Counterpart = Agent

The role that this endpoint connects to.

fn builder(self) -> Builder<Self>

Creates a new builder playing this role.

async fn default_handle_dispatch_from( &self, message: Dispatch, _connection: ConnectionTo<Client>, ) -> Result<Handled<Dispatch>, Error>

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 Client