Struct ProcessGuard 

pub struct ProcessGuard { /* private fields */ }

RAII guard for process lifecycle management.

ProcessGuard automatically terminates the spawned process when dropped. This ensures proper cleanup even if errors occur during workflow execution.

The guard uses a shared boolean flag to track whether the process has already been terminated manually, preventing double-termination in Drop.

Implementations

impl ProcessGuard

pub fn new(pid: u32, tool_name: impl Into<String>) -> Self

Creates a new ProcessGuard for the given process.

Arguments

• pid - Process ID to guard
• tool_name - Name of the tool (for logging)

Example

use forge_agent::workflow::tools::ProcessGuard;

let guard = ProcessGuard::new(12345, "magellan");

pub fn terminate(&self) -> Result<(), ToolError>

Manually terminates the guarded process.

Sets the terminated flag to prevent double-termination in Drop.

Returns

• Ok(()) if termination succeeded
• Err(ToolError) if termination failed

Example

use forge_agent::workflow::tools::ProcessGuard;

let guard = ProcessGuard::new(12345, "magellan");
guard.terminate()?;

pub fn pid(&self) -> u32

Returns the process ID being guarded.

Example

use forge_agent::workflow::tools::ProcessGuard;

let guard = ProcessGuard::new(12345, "magellan");
assert_eq!(guard.pid(), 12345);

pub fn is_terminated(&self) -> bool

Returns true if the process was terminated.

Example

use forge_agent::workflow::tools::ProcessGuard;

let guard = ProcessGuard::new(12345, "magellan");
assert!(!guard.is_terminated());

Trait Implementations

impl Clone for ProcessGuard

fn clone(&self) -> ProcessGuard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProcessGuard

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ProcessGuard

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for ProcessGuard

fn drop(&mut self)

Executes the destructor for this type.

impl From<ProcessGuard> for ToolCompensation

fn from(guard: ProcessGuard) -> Self

Converts to this type from the input type.