Struct BackgroundCapable 

pub struct BackgroundCapable<T: BackgroundExecutable> { /* private fields */ }

Wraps a tool that implements BackgroundExecutable to provide full task lifecycle management:

• New tasks: generates task_id, persists, executes foreground or spawns background.
• Resume: if task_id is in args and the task is Stopped, re-executes.
• Status query: if task_id is in args and the task is running/terminal, returns status.
• Orphan detection: if a persisted Running task has no live handle, marks it Stopped.

Implementations

impl<T: BackgroundExecutable> BackgroundCapable<T>

pub fn new(inner: T, manager: Arc<BackgroundTaskManager>) -> Self

pub fn from_arc(inner: Arc<T>, manager: Arc<BackgroundTaskManager>) -> Self

pub fn with_task_store(self, task_store: Option<Arc<TaskStore>>) -> Self

Trait Implementations

impl<T: BackgroundExecutable + 'static> Tool for BackgroundCapable<T>

fn descriptor(&self) -> ToolDescriptor

Get the tool descriptor.

fn validate_args(&self, args: &Value) -> Result<(), ToolError>

Validate tool arguments against the descriptor’s JSON Schema before execution.

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

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

Execute the tool.

fn execute_effect<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, args: Value, _ctx: &'life1 ToolCallContext<'life2>, ) -> Pin<Box<dyn Future<Output = Result<ToolExecutionEffect, ToolError>> + Send + 'async_trait>>

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

Execute tool and return structured effects.