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.

// ERROR: with_language not available after with_context
let b = ToolsBuilder::new()
    .with_context(Arc::new(42_u32))
    .with_language(tools_core::Language::Python);

pub fn with_language(self, lang: Language) -> ToolsBuilder<Scripted, M>

Set the scripting language for FFI tool loading. Transitions to the Scripted state, locking out with_context.

Use from_path to add script directories after calling this.

// ERROR: with_context not available after with_language
let b = ToolsBuilder::new()
    .with_language(tools_core::Language::Python)
    .with_context(Arc::new(42_u32));

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>

pub fn from_path(self, path: impl Into<PathBuf>) -> ToolsBuilder<Scripted, M>

Add a script path to load tools from. Can be called multiple times to load from several paths.

impl<M> ToolsBuilder<Scripted, M>

where M: DeserializeOwned,

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

Build the collection. Collects #[tool] inventory tools (no context), then loads scripted tools from configured paths via the selected language adapter.

No paths configured = inventory tools only.

Trait Implementations

impl Default for ToolsBuilder

fn default() -> ToolsBuilder

Returns the “default value” for a type.