Struct ExtensionTool 

pub struct ExtensionTool { /* private fields */ }

Implementations

impl ExtensionTool

pub fn new( plugin_id: impl Into<String>, tool_name: impl Into<String>, runtime: Arc<StdioRuntime>, ) -> Self

pub fn with_descriptor_metadata( self, description: impl Into<String>, input_schema: Value, ) -> Self

Attach description + input_schema after construction so lifecycle hooks / introspection code can read what the extension advertised at handshake time. Idempotent.

pub fn with_context_passthrough(self, enabled: bool) -> Self

Phase 11.5 follow-up — builder to opt this tool into context propagation. When true, call injects _meta.agent_id and _meta.session_id into the args object before forwarding.

pub fn plugin_id(&self) -> &str

pub fn tool_name(&self) -> &str

pub fn description(&self) -> Option<&str>

The description the extension advertised at registration time. None when the tool was constructed without a descriptor (e.g. legacy call sites).

pub fn input_schema(&self) -> Option<&Value>

The input_schema (JSON Schema) the extension advertised at registration time. None when the tool was constructed without a descriptor.

pub fn prefixed_name(plugin_id: &str, tool_name: &str) -> String

Full LLM-facing tool name: ext_{plugin_id}_{tool_name}. When the concatenation overflows ToolDef::MAX_NAME_LEN, falls back to a deterministic ext_{id}_{head}_{hash6} form — see ToolDef::fit_name. Routing still uses the original tool_name.

pub fn tool_def(desc: &ToolDescriptor, plugin_id: &str) -> ToolDef

Build a ToolDef ready for ToolRegistry::register. Decorates the description with [ext:<id>] so the LLM knows where the tool comes from when reasoning over its options.

Trait Implementations

impl ToolHandler for ExtensionTool

fn call<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 AgentContext, args: Value, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

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