Struct KillShellTool 

pub struct KillShellTool { /* private fields */ }

Tool that terminates a background shell via SIGTERM and falls through to SIGKILL after a grace window.

Implementations

impl KillShellTool

pub fn new(registry: Arc<BashBgRegistry>) -> Self

Build with an explicit registry handle.

pub fn with_grace(registry: Arc<BashBgRegistry>, grace: Duration) -> Self

Build with a custom SIGTERM→SIGKILL grace window (for tests).

pub fn with_global_registry() -> Self

Build using the process singleton.

Trait Implementations

impl Debug for KillShellTool

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

Formats the value using the given formatter.

impl Tool for KillShellTool

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

Stable, unique-within-registry name. Must match the model’s expected tool name in the system prompt or schema.

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

Description sent to the model.

fn input_schema(&self) -> &Value

JSON Schema for the input. Returned by reference to avoid cloning per request.

fn invoke<'life0, 'async_trait>( &'life0 self, input: Value, _cx: ToolContext, ) -> Pin<Box<dyn Future<Output = Result<Vec<ContentBlock>, ToolError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute the tool. Returns the content blocks to splice into the ToolResult message.

fn parallel_conflict_key(&self, _input: &Value) -> Option<String>

Returns Some(key) when this tool call has a conflict identity that must not run in parallel with another call sharing the same key. Returns None (the default) when the tool is fully parallel-safe.

fn is_read_only(&self) -> bool

Whether this tool is side-effect-free — it only reads state (or injects context) and never mutates the workspace or the outside world.

fn mutates_files(&self) -> bool

Whether a successful call mutates files in the workspace.

fn as_any(&self) -> Option<&(dyn Any + 'static)>

Optional downcast hook for recovering a tool’s concrete type at runtime. The default returns None; tools that expose extra session metadata beyond the trait (e.g. the Skill tool surfacing its loaded skill names) override it to return Some(self).