Struct PluginTool 

pub struct PluginTool { /* private fields */ }

Native MCP tool backed by a plugin’s sandboxed subprocess.

Implementations

impl PluginTool

pub fn from_spec(spec: PluginToolSpec) -> Self

Build a registrable tool from a discovered spec.

The MCP registry keys tools by &'static str. Plugin tools are discovered once at startup and live for the whole process, so leaking the name is a bounded, intentional allocation (a handful of tool names).

Trait Implementations

impl McpTool for PluginTool

fn name(&self) -> &'static str

Tool name as registered in the MCP protocol (e.g. “ctx_tree”).

fn tool_def(&self) -> Tool

MCP tool definition including JSON schema. This replaces the corresponding entry in granular_tool_defs().

fn handle( &self, args: &Map<String, Value>, _ctx: &ToolContext, ) -> Result<ToolOutput, ErrorData>

Execute the tool. Args are the raw JSON-RPC arguments. ctx provides access to resolved paths and project state.

fn produces_machine_readable(&self, _args: Option<&Map<String, Value>>) -> bool

Whether this invocation yields a machine-readable payload (e.g. JSON) that must reach the client byte-exact and parseable. When true, the dispatch pipeline suppresses every human-oriented decoration (auto-context briefing, verify footer, hints, checkpoints, deprecation notices) and terse compression for this call, returning the pure body. Keyed on args because most tools emit machine-readable output only for an opt-in format flag (e.g. format=json); defaults to false (#990).