Struct ExternalToolRuntime 

pub struct ExternalToolRuntime { /* private fields */ }

A single role-specific external-tool lifecycle. Agent and chat construct separate instances even when they select the same server configuration.

Implementations

impl ExternalToolRuntime

pub fn from_config( config: &Config, mode: ExternalToolMode, capabilities: Vec<Capability>, ) -> Result<Self>

pub fn replay( mode: ExternalToolMode, entries: Vec<ToolEntry>, results: BTreeMap<String, VecDeque<ExternalToolResult>>, ) -> Self

Build a replay lifecycle from admitted entries and recorded results. It has no server configuration and therefore cannot reconnect.

pub fn set_client_services(&mut self, services: McpClientServices)

Install product-owned handlers for authority-bearing server requests. Configured sampling or elicitation fails connection when its handler is absent, so capability advertisement can never outrun the product UI.

pub fn set_capabilities(&mut self, capabilities: Vec<Capability>)

Replace the admission capabilities (the composition root supplies the session’s derived grant surface before discovery).

pub fn with_observer(self, observer: Arc<dyn ExternalToolObserver>) -> Self

pub fn server_ids(&self) -> Vec<&str>

pub fn state(&self, server_id: &str) -> Option<ExternalConnectionState>

pub fn admitted_entries(&self) -> Vec<ToolEntry>

pub fn admission_rejections( &self, server_id: &str, ) -> Vec<ExternalToolRejection>

pub fn drain_server_events( &mut self, server_id: &str, ) -> Result<Vec<McpServerEvent>>

Drain progress, logging, resource, catalog, task, and subscription notifications received since the previous call.

pub fn stderr_tail(&self, server_id: &str) -> Result<Vec<u8>>

Captured rolling stderr tail for a stdio server.

pub async fn set_log_level(&self, server_id: &str, level: &str) -> Result<()>

Set a server’s MCP logging threshold when it advertises logging.

pub async fn discover_server( &mut self, server_id: &str, ) -> Result<Vec<ToolEntry>>

pub async fn refresh_server( &mut self, server_id: &str, ) -> Result<Vec<ToolEntry>>

Re-list and re-admit one connected server’s catalog after an MCP list-change notification. Old bindings are removed before replacement, so a deleted remote tool can never remain callable.

pub async fn sync_server_events( &mut self, ) -> Result<Vec<(String, McpServerEvent)>>

Drain notifications and refresh any changed tool catalogs. All events are returned to the product for display or durable recording.

pub async fn call( &mut self, namespaced_tool: &str, arguments: Value, ) -> Result<ExternalToolResult>

pub async fn shutdown(&mut self) -> Result<()>

Trait Implementations

impl Debug for ExternalToolRuntime

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

Formats the value using the given formatter.