Struct ToolsUsageReportTool 

pub struct ToolsUsageReportTool { /* private fields */ }

tools.usage_report — registry-wide usage ranking from live dispatch stats.

Unlike tools.effectiveness_report (which only sees its own counters), this tool holds a snapshot of the tool registry. Tool Arcs are shared across registries, so the per-tool ToolStats atomics it reads are the same ones the dispatch pipeline updates — the report is always live.

Implementations

impl ToolsUsageReportTool

pub fn new(registry: Arc<ToolRegistry>) -> Self

Trait Implementations

impl Tool for ToolsUsageReportTool

fn name(&self) -> &str

Unique tool name (e.g., “memory.create”, “search.hybrid”)

fn gana(&self) -> Gana

Which Gana this tool belongs to.

fn effects(&self) -> &EffectRow

Effect row — what this tool does to the world.

fn description(&self) -> &str

Human-readable description.

fn input_schema(&self) -> Value

JSON-Schema-style description of the accepted arguments.

fn call<'life0, 'life1, 'async_trait>( &'life0 self, _ctx: &'life1 mut Context, args: Value, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

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

Execute the tool.

fn stats(&self) -> &ToolStats

Access this tool’s statistics.