Struct Agent 

pub struct Agent;

The agent role - typically an LLM that responds to prompts.

Agents receive prompts from clients and respond with answers, potentially invoking tools along the way.

Implementations

impl Agent

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

Create a connection builder for an agent.

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

Available on crate feature unstable_protocol_v2 only.

Create an agent builder that uses the ACP protocol v2 API.

This builder selects protocol v2 for clients requesting v2 or a newer version. A request for exactly v2 must be a valid v2 initialize request. A request for a newer version is accepted with what parses under v2: unparsable capabilities and _meta are dropped, and a missing or malformed info is replaced by an implementation named unknown with version unknown. Use Self::protocol_router with a v1 implementation for v1 clients.

The client may repeat initialize after the previous one completed and before it sends any other request. Each repeat is dispatched to the initialize handler and the latest one is authoritative. A repeat after any other request, while an initialize is in flight, or requesting a version below v2 is rejected with -32600. A repeat that fails keeps the previous initialization in place. Requests with a null id are rejected with -32600.

Requires the unstable_protocol_v2 crate feature.

pub fn protocol_router(self) -> AgentProtocolRouter

Available on crate feature unstable_protocol_v2 only.

Create a router that chooses between configured protocol implementations.

Add implementations with AgentProtocolRouter::with_v1 and AgentProtocolRouter::with_v2. The resulting router reads the initial initialize request and selects a version-specific implementation. An endpoint exposing v2 selects the highest configured version at or below the requested version. A v1-only endpoint retains v1’s fallback-to-latest rule. The router does not convert traffic after initialization.

The selected implementation owns the connection. A repeated initialize is forwarded to it and is never re-routed, so it is evaluated against the selected version: a v2 implementation rejects a repeat requesting v1 with -32600, and a v1 implementation selects v1 for a repeat requesting a newer version. A first initialize with a null id that would select v2 is rejected with -32600, like any other invalid first request.

Requires the unstable_protocol_v2 crate feature while protocol v2 stabilizes.

Trait Implementations

impl Clone for Agent

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 Agent

impl Debug for Agent

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

Formats the value using the given formatter.

impl Default for Agent

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Agent

impl HasPeer<Agent> for Agent

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

Returns the remote style for sending to this peer.

impl HasPeer<Agent> for Conductor

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

Returns the remote style for sending to this peer.

impl Hash for Agent

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 Agent

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 Agent

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Agent

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 Agent

type Counterpart = Client

The role that this endpoint connects to.

fn builder(self) -> Builder<Self>

Creates a new builder playing this role.

fn role_id(&self) -> RoleId

Returns a unique identifier for this role.

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

Returns the counterpart role.

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

Method invoked when there is no defined message handler.

impl StructuralPartialEq for Agent