Struct SessionInspectorTool 

pub struct SessionInspectorTool { /* private fields */ }

Server-only tool for inspecting V2 sessions stored under the Bamboo home dir.

Design goals:

• Return metadata first (index-backed) so the model can narrow scope.
• Allow bounded reads (pagination; from end; truncation).
• Support lightweight search across session titles and (optionally) tail messages.
• Keep inspection local by default; use child-session delegation only if the user explicitly asks.

Implementations

impl SessionInspectorTool

pub fn new( session_store: Arc<SessionStoreV2>, storage: Arc<dyn Storage>, ) -> Self

Trait Implementations

impl Tool for SessionInspectorTool

fn name(&self) -> &str

fn description(&self) -> &str

Human-readable tool description for LLM.

fn parameters_schema(&self) -> Value

JSON Schema for tool parameters.

fn execute<'life0, 'async_trait>( &'life0 self, args: Value, ) -> Pin<Box<dyn Future<Output = Result<ToolResult, ToolError>> + Send + 'async_trait>>

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

Execute the tool with given arguments.

fn execute_with_context<'life0, 'life1, 'async_trait>( &'life0 self, args: Value, ctx: ToolExecutionContext<'life1>, ) -> Pin<Box<dyn Future<Output = Result<ToolResult, ToolError>> + Send + 'async_trait>>

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

Execute the tool with a streaming-capable context.

fn mutability(&self) -> ToolMutability

Declares whether this tool is read-only or mutating for orchestration and parallel scheduling decisions. Defaults to mutating to stay conservative.

fn call_mutability(&self, _args: &Value) -> ToolMutability

Args-aware mutability hook. Defaults to the static mutability declaration.

fn concurrency_safe(&self) -> bool

Declares whether this tool can safely run in parallel with other read-only tools. Defaults to false so tools remain serialized unless they opt in explicitly.

fn call_concurrency_safe(&self, _args: &Value) -> bool

Args-aware parallel-safety hook. Defaults to the static declaration.

fn to_schema(&self) -> ToolSchema

Convert tool to LLM-compatible schema.