Struct ComponentHandle 

pub struct ComponentHandle { /* private fields */ }

Handle to send requests to the component actor.

Implementations

impl ComponentHandle

pub fn disconnected() -> Self

A handle with no actor behind it: every call answers component actor unavailable.

For host tests that need to construct whatever holds a handle without standing up a component. The request enum is private, so a host cannot build one of these itself.

pub async fn list_tools( &self, metadata: &Metadata, ) -> Result<ListToolsResponse, ComponentError>

pub async fn call_tool( &self, name: &str, arguments: Vec<u8>, metadata: Vec<(String, Vec<u8>)>, consent: Option<ConsentSink>, ) -> Result<CallToolResult, ComponentError>

consent is where a capability gate firing during this call sends its question. None for transports that prompt locally or not at all — see crate::consent for why the ask travels back to the caller rather than the gate reaching for a peer itself. Call a tool, after checking its arguments against the schema the component published for it (ACT-SPEC.md §6.4).

The check happens here rather than in a transport so that every caller gets it — act call on the command line as much as an agent over MCP. A rejection is ComponentError::Tool with kind std:invalid-args, the same shape the guest would have produced, and the guest is never reached.

pub async fn open_session( &self, args: Vec<(String, Vec<u8>)>, metadata: Vec<(String, Vec<u8>)>, consent: Option<ConsentSink>, ) -> Result<Session, ComponentError>

A component that exports no session-provider fails with ComponentError::Internal — the host could not make the call, as opposed to the component declining it.

pub async fn close_session( &self, session_id: String, ) -> Result<(), ComponentError>

pub async fn call_tool_servicing_consent<F, Fut>( &self, name: &str, arguments: Vec<u8>, metadata: Vec<(String, Vec<u8>)>, answer: F, ) -> Result<CallToolResult, ComponentError>

where F: FnMut(String) -> Fut, Fut: Future<Output = bool>,

Self::call_tool, with consent questions routed back to answer instead of denied. Transports with a back-channel to a human use this.

pub async fn open_session_servicing_consent<F, Fut>( &self, args: Vec<(String, Vec<u8>)>, metadata: Vec<(String, Vec<u8>)>, answer: F, ) -> Result<Session, ComponentError>

where F: FnMut(String) -> Fut, Fut: Future<Output = bool>,

Self::open_session, with consent questions routed back to answer. A bridge does its network I/O while opening a session, so this is where its capability gate usually fires.

pub async fn open_session_args_schema( &self, metadata: Vec<(String, Vec<u8>)>, ) -> Result<String, ComponentError>

Returns a JSON Schema string. A component that exports no session-provider fails with ComponentError::Internal.

Trait Implementations

impl Clone for ComponentHandle

fn clone(&self) -> ComponentHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.