Struct CompactContextTool 

pub struct CompactContextTool;

Server-side tool for manually triggering conversation context compression.

Unlike automatic compression (which triggers based on token thresholds), this tool lets the model or user proactively compress history at natural task boundaries. It bypasses the exposure gate and always forces a compression cycle.

Trait Implementations

impl Tool for CompactContextTool

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 classify(&self, _args: &Value) -> ToolClass

Per-call scheduling + permission-gating class (args-aware). Folds the former mutability/call_mutability/concurrency_safe/ call_concurrency_safe hooks into one value. Defaults to the conservative ToolClass::MUTATING_SERIAL (mutating, serial, not promotable).

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

where 'life0: 'async_trait, CompactContextTool: 'async_trait,

The sole execution entry: returns the call’s per-call ToolOutcome (Completed / Running / NeedsHuman), or a ToolError for infrastructure / argument failures (preserved from the former execute).

fn to_schema(&self) -> ToolSchema

Convert tool to LLM-compatible schema.