Struct ToolRegistration 

pub struct ToolRegistration { /* private fields */ }

Implementations

impl ToolRegistration

pub fn new( name: impl Into<Arc<str>>, capability: CapabilityLevel, uses_pty: bool, executor: ToolExecutorFn, ) -> Self

pub fn from_tool( name: impl Into<Arc<str>>, capability: CapabilityLevel, tool: Arc<dyn Tool>, ) -> Self

pub fn from_tool_with_metadata( name: impl Into<Arc<str>>, capability: CapabilityLevel, tool: Arc<dyn Tool>, metadata: ToolMetadata, ) -> Self

pub fn from_tool_instance<T>( name: impl Into<Arc<str>>, capability: CapabilityLevel, tool: T, ) -> Self

where T: Tool + 'static,

pub fn from_cgp_tool<Ctx>( name: impl Into<Arc<str>>, capability: CapabilityLevel, facade: ToolFacade<Ctx>, ) -> Self

where ToolFacade<Ctx>: Tool + 'static,

Register a tool wrapped with a CGP runtime context.

Wraps an existing Arc<dyn Tool> in a CGP ToolFacade with the specified runtime context’s approval, metadata, sandbox, logging, cache, and retry providers.

Prefer wrap_native_tool_interactive() or wrap_native_tool_ci() when the caller still owns the concrete tool instance. Use this bridge when the tool already has genuine shared ownership.

Example

use vtcode_core::components::{InteractiveCtx, ToolBridgeCtx, wrap_tool_interactive};

let tool: Arc<dyn Tool> = Arc::new(MyTool);
let reg = ToolRegistration::from_cgp_tool(
    "my_tool",
    CapabilityLevel::Basic,
    wrap_tool_interactive(tool, workspace_root),
);

pub fn with_llm_visibility(self, expose: bool) -> Self

pub fn with_catalog_source(self, catalog_source: ToolCatalogSource) -> Self

pub fn with_pty(self, uses_pty: bool) -> Self

pub fn with_deprecated(self, deprecated: bool) -> Self

pub fn with_deprecation_message(self, message: impl Into<String>) -> Self

pub fn with_cgp_wrapped(self, wrapped: bool) -> Self

pub fn with_handler(self, handler: ToolHandler) -> Self

pub fn with_native_cgp_factory(self, factory: NativeCgpToolFactory) -> Self

pub fn name(&self) -> &str

pub fn capability(&self) -> CapabilityLevel

pub fn catalog_source(&self) -> ToolCatalogSource

pub fn uses_pty(&self) -> bool

pub fn expose_in_llm(&self) -> bool

pub fn is_deprecated(&self) -> bool

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

pub fn is_cgp_wrapped(&self) -> bool

pub fn handler(&self) -> ToolHandler

pub fn native_cgp_factory(&self) -> Option<NativeCgpToolFactory>

pub fn metadata(&self) -> &ToolMetadata

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

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

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

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

pub fn default_permission(&self) -> Option<ToolPolicy>

pub fn with_metadata(self, metadata: ToolMetadata) -> Self

pub fn with_description(self, description: impl Into<String>) -> Self

pub fn with_prompt_path(self, path: impl Into<String>) -> Self

pub fn with_parameter_schema(self, schema: Value) -> Self

pub fn with_config_schema(self, schema: Value) -> Self

pub fn with_state_schema(self, schema: Value) -> Self

pub fn with_permission(self, permission: ToolPolicy) -> Self

pub fn with_allowlist( self, patterns: impl IntoIterator<Item = impl Into<String>>, ) -> Self

pub fn with_denylist( self, patterns: impl IntoIterator<Item = impl Into<String>>, ) -> Self

pub fn with_aliases( self, aliases: impl IntoIterator<Item = impl Into<String>>, ) -> Self

pub fn with_server_hint(self, hint: impl Into<String>) -> Self

pub fn with_behavior(self, behavior: ToolBehavior) -> Self

Trait Implementations

impl Clone for ToolRegistration

fn clone(&self) -> ToolRegistration

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ToolRegistration

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.