Module utils 

Structs

DirectoryEntry

Directory entry information for tree generation

LargeOutputLimits

LocalFileSystemProvider

Local file system provider implementation

Traits

FileSystemProvider

Trait for abstracting file system operations for tree generation

Functions

backward_compatibility_mapping

Map legacy tool names to their current counterparts. Currently handles mapping “read_rulebook” to “load_skill”.

generate_directory_tree

Generate a tree view of a directory structure using a generic file system provider

generate_password

Generate a secure password with alphanumeric characters and optional symbols

handle_large_output

Handle large output: if the output has >= max_lines, save the full content to session storage and return a string showing only the first or last max_lines lines with a pointer to the saved file. Returns Ok(final_string) or Err(error_string) on failure.

handle_large_output_with_limits

is_supported_file

Check if a directory entry represents a supported file type

matches_gitignore_pattern

Check if a path matches a gitignore pattern

normalize_optional_string

Normalize an optional string by trimming leading/trailing whitespace.

pattern_matches_glob

Simple glob pattern matching for basic cases

read_gitignore_patterns

Read .gitignore patterns from the specified base directory

sanitize_text_output

Sanitize text output by removing control characters while preserving essential whitespace

should_include_entry

Check if a directory entry should be included based on gitignore patterns and file type support

strip_tool_name

Strip the MCP server prefix and any trailing “()” from a tool name. Example: “stakpak__run_command” -> “run_command” Example: “run_command” -> “run_command” Example: “str_replace()” -> “str_replace”

truncate_chars_with_ellipsis

Truncate a string by character count and append ... when truncated.