Struct LuaToolAdapter 

pub struct LuaToolAdapter {
    definition: ToolDefinition,
    config: Arc<Config>,
}

Adapter that wraps a Lua ToolDefinition as a Tool trait object.

This allows Lua tools to participate in the unified tool dispatch alongside built-in and custom Rust tools.

Fields

definition: ToolDefinition

The underlying Lua tool definition.

config: Arc<Config>

Application config needed for the Lua context bridge.

Implementations

impl LuaToolAdapter

pub fn new(definition: ToolDefinition, config: Arc<Config>) -> Self

Create a new adapter wrapping a Lua tool definition.

Trait Implementations

impl Tool for LuaToolAdapter

fn name(&self) -> &str

Returns the tool’s name.

fn description(&self) -> &str

Returns a one-line description for agent discovery.

fn parameters_schema(&self) -> Value

Returns the OpenAI function-calling JSON Schema for parameters.

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, params: Value, _ctx: &'life1 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

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

Execute the tool with validated parameters.

fn capabilities(&self) -> Option<Vec<Capability>>

Runtime capability requirements. Unknown metadata is denied by the local agent runtime; existing MCP tools retain their existing behavior.

fn binding_metadata(&self) -> Option<Value>

Sanitized immutable identity for declaratively bound tools. History and recovery use this without loading implementations or resolving secrets.

fn runtime_dispatch(&self) -> ToolRuntimeDispatch

Select runtime-owned execution context without coupling the dispatcher to a public tool name. Most tools execute directly.

fn preparation(&self) -> Option<ToolPreparation>

Optional host-owned preparation that must complete through the durable approval lifecycle before this tool can be advertised to a model.

fn prepare<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

fn is_builtin(&self) -> bool

Whether this tool is a built-in (true for search/get/sources).

fn validate_arguments(&self, params: &Value) -> Result<()>

Validate model-visible arguments before authorization and tool start. Bound adapters override this with their resolved public contract.

fn approval_arguments(&self, params: &Value) -> Result<Value>

Sanitized effective arguments covered by approval. Bound tools override this to include immutable fixed values and reject override attempts.