Struct UpdatePlanTool 

pub struct UpdatePlanTool { /* private fields */ }

A lightweight tool that records and displays a plan checklist to the user.

Behavior

• Validates the incoming UpdatePlanArgs (non-empty plan, at most one in_progress step, no empty step text).
• Broadcasts a RuntimeEvent::PlanUpdated event for UI rendering.
• Returns a short summary — it does NOT store, execute, or drive the plan.

This is a display-only protocol, inspired by Codex’s update_plan.

Implementations

impl UpdatePlanTool

pub fn new() -> Self

pub fn with_description(self, desc: String) -> Self

Override the tool description with a custom string.

The default description is written for the generic agent-base framework. Consumers like ops-agent can use this to inject domain-specific usage guidelines (e.g. step granularity rules, when to use/not use plans).

Trait Implementations

impl Default for UpdatePlanTool

fn default() -> Self

Returns the “default value” for a type.

impl Tool for UpdatePlanTool

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

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

Human-readable description of what this tool does and when to use it.

fn schema(&self) -> Value

JSON Schema for the tool’s input arguments (MCP inputSchema shape, without the provider envelope).

fn metadata(&self) -> ToolMetadata

Machine-readable metadata for tool introspection.

fn call<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, args: &'life1 Value, ctx: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = AgentResult<Vec<Content>>> + Send + 'async_trait>>

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

fn timeout_ms(&self) -> Option<u64>

Timeout for this tool in milliseconds.