Struct RemoteAgent 

pub struct RemoteAgent<T> { /* private fields */ }

A remote agent, over any Transport.

HttpAgent is this over HTTP; the type is generic so that a wasm transport, an in-process agent, or a recorded fixture substitutes without anything above noticing.

Not crate::server::Agent

The two crates sit on opposite ends of the same wire, and the word “agent” means the opposite thing at each end, so they do not share a name. crate::server::Agent is a trait you implement to be an agent; RemoteAgent is a handle you hold onto someone else’s. An agent that calls another agent — the composition case — needs both in one file, and impl Agent for X { … self.upstream: RemoteAgent<_> … } reads correctly only because they are spelled differently.

Implementations

impl<T> RemoteAgent<T>

pub fn new(transport: T) -> Self

An agent reached through transport.

pub fn transport(&self) -> &T

The transport underneath.

pub fn into_transport(self) -> T

Unwraps the transport.

impl<T: Transport> RemoteAgent<T>

pub fn run(&self, params: impl Into<RunAgentInput>) -> EventStream

Starts a run and streams its events, exactly as the agent sent them.

Nothing is normalized, verified or assembled here — chunk events arrive as chunk events. That is what a proxy wants; a UI wants Session.

Connecting is folded into the stream: a transport that cannot reach the agent yields one error item and ends.

impl RemoteAgent<HttpTransport>

pub fn builder(url: impl AsRef<str>) -> HttpAgentBuilder

A builder for an agent at url.

pub fn http(url: impl AsRef<str>) -> Result<Self>

An agent at url, with default settings.

Errors

Error::Config when the URL does not parse.

Trait Implementations

impl<T: Clone> Clone for RemoteAgent<T>

fn clone(&self) -> RemoteAgent<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for RemoteAgent<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for RemoteAgent<T>

fn default() -> RemoteAgent<T>

Returns the “default value” for a type.