Struct StaticSurface 

pub struct StaticSurface { /* private fields */ }

A surface whose tool list never changes, backed by an McpToolExecutor.

The simple case, kept simple: callers with nothing dynamic to say hand over a Vec and an executor and are done.

Fidelity

McpToolExecutor returns Result<Value, RunnerError>, which has two states where a tool call has three. A tool that RAN and declined can only come back as Err, so this adapter reports it as a refusal — correct — but the only machine-readable thing an Err carries is its ErrorKind, which is preserved as structuredContent.error_kind. A caller that needs to hand the model a richer refusal — an error code, a pending id, a provider to reconnect — should implement ToolSurface directly and build its own ToolOutcome. That is not a limitation of the host; it is the shape of the narrower trait.

Implementations

impl StaticSurface

pub const fn new( tools: Vec<McpToolDefinition>, executor: Arc<dyn McpToolExecutor>, ) -> Self

Wrap a fixed tool list and its executor.

Trait Implementations

impl ToolSurface for StaticSurface

fn list_tools<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Vec<McpToolDefinition>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Tools visible to this session right now.

fn call<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, tool_name: &'life1 str, arguments: &'life2 Value, ) -> Pin<Box<dyn Future<Output = ToolOutcome> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Run one call. A tool absent from list_tools is already refused by the host, so this is only reached for a tool the surface just advertised.