Struct ToolContext 

pub struct ToolContext { /* private fields */ }

Shared context for all file tools

Thread-safe via Arc<ToolContext> + RwLock for mutable state.

Implementations

impl ToolContext

pub fn new(working_dir: PathBuf, permission_mode: PermissionMode) -> Self

Create a new tool context

Arguments

• working_dir - Security boundary for file operations
• permission_mode - Initial permission level

pub fn with_events(self, tx: Sender<ToolEvent>) -> Self

Create context with event channel

pub fn working_dir(&self) -> &Path

Get the working directory

pub fn permission_mode(&self) -> PermissionMode

Get current permission mode

pub fn set_permission_mode(&self, mode: PermissionMode)

Set permission mode

pub fn validate_path(&self, file_path: &str) -> Result<PathBuf, NikaError>

Validate a path is safe to access

Relative paths are resolved against the working directory. Returns the canonicalized path if valid.

Errors

• PathOutOfBounds if path is outside working directory

pub fn check_permission( &self, operation: ToolOperation, ) -> Result<(), NikaError>

Check if operation is allowed by current permission mode

pub fn mark_as_read(&self, path: &Path)

Mark a file as read (for edit validation)

pub fn was_read(&self, path: &Path) -> bool

Check if a file has been read (required before edit)

pub fn validate_read_before_edit(&self, path: &Path) -> Result<(), NikaError>

Validate that file was read before edit

pub async fn emit(&self, event: ToolEvent)

Emit a tool event. Logs a warning if the channel is closed/full.

pub fn clear_read_tracking(&self)

Clear read files tracking (for testing or reset)

Trait Implementations

impl Debug for ToolContext

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

Formats the value using the given formatter.