Struct ToolCompensation 

pub struct ToolCompensation {
    pub description: String,
    /* private fields */
}

Compensation action for external tool side effects.

ToolCompensation wraps an undo function that compensates for external tool actions (file edits, process spawns, etc.) that cannot be rolled back through normal workflow operations.

Fields

description: String

Human-readable description of the compensation

Implementations

impl ToolCompensation

pub fn new<F>(description: impl Into<String>, compensate_fn: F) -> Self

where F: Fn(&TaskContext) -> Result<TaskResult, TaskError> + Send + Sync + 'static,

Creates a new ToolCompensation with the given description and undo function.

pub fn execute(&self, context: &TaskContext) -> Result<TaskResult, TaskError>

Executes the compensation action.

pub fn file_compensation(file_path: impl Into<String>) -> Self

Creates a file deletion compensation for undoing file creation.

Arguments

• file_path - Path to the file that will be deleted during rollback

Returns

A ToolCompensation that deletes the specified file

Example

let comp = ToolCompensation::file_compensation("/tmp/work_output.txt");

pub fn process_compensation(pid: u32) -> Self

Creates a process termination compensation for undoing process spawns.

Arguments

• pid - Process ID to terminate

Returns

A ToolCompensation that terminates the specified process

Example

let comp = ToolCompensation::process_compensation(12345);

pub fn skip(description: impl Into<String>) -> Self

Creates a skip compensation (no undo needed).

Used for tasks that don’t have side effects or don’t need compensation.

pub fn retry(description: impl Into<String>) -> Self

Creates a retry compensation (recommends retry instead of undo).

Used for transient failures where retry is preferred over compensation.

Trait Implementations

impl Clone for ToolCompensation

fn clone(&self) -> ToolCompensation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl From<CompensationAction> for ToolCompensation

fn from(action: CompensationAction) -> Self

Converts to this type from the input type.

impl From<ProcessGuard> for ToolCompensation

fn from(guard: ProcessGuard) -> Self

Converts to this type from the input type.