Struct ToolsBuilder 

pub struct ToolsBuilder<S = Blank, M = NoMeta>
where
    S: BuilderState,
{ /* private fields */ }

Typestate builder for ToolCollection.

The type parameter S tracks the builder state:

• Blank — initial. Can call with_context or (in the future) FFI adapter methods.
• Native — context was set. FFI methods unavailable.
• Scripted — FFI adapters added. with_context unavailable.

M is the metadata type, defaulting to NoMeta. Change it via with_meta.

Typestate enforcement

Calling with_context after it has already been called does not compile:

use tools_core::builder::{ToolsBuilder, Native};
use std::sync::Arc;

// ERROR: ToolsBuilder<Native, _> has no method `with_context`
let b = ToolsBuilder::new()
    .with_context(Arc::new(42_u32))
    .with_context(Arc::new(42_u32));

Implementations

impl ToolsBuilder

pub fn new() -> ToolsBuilder

Create a new builder in the Blank state with NoMeta. Use with_meta to change the metadata type.

impl<M> ToolsBuilder<Blank, M>

pub fn with_context<T>(self, ctx: Arc<T>) -> ToolsBuilder<Native, M>

where T: Send + Sync + 'static,

Set a shared context that will be injected into every tool whose first parameter is named ctx. Transitions to the Native state, locking out FFI adapter methods.

impl<S, M> ToolsBuilder<S, M>

where S: BuilderState,

pub fn with_meta<M2>(self) -> ToolsBuilder<S, M2>

Change the metadata type. This is a phantom-only transition — no data is stored. M2 is used at [collect] time to deserialize each tool’s #[tool(...)] attributes.

impl<M> ToolsBuilder<Blank, M>

where M: DeserializeOwned,

pub fn collect(self) -> Result<ToolCollection<M>, ToolError>

Build the collection from the global tool inventory (no context). Tools that require context will produce a ToolError::MissingCtx error.

impl<M> ToolsBuilder<Native, M>

where M: DeserializeOwned,

pub fn collect(self) -> Result<ToolCollection<M>, ToolError>

Build the collection from the global tool inventory, injecting the stored context into tools that require it. Validates that every context-requiring tool expects the same type.

impl<M> ToolsBuilder<Scripted, M>

where M: DeserializeOwned,

pub fn collect(self) -> Result<ToolCollection<M>, ToolError>

Build the collection from the global tool inventory (no context). In the future, this will also load scripts from configured FFI adapter paths.

Trait Implementations

impl Default for ToolsBuilder

fn default() -> ToolsBuilder

Returns the “default value” for a type.