Add recursive directory listing to list_files tool

[BillJr99]

Summary

Enhanced the list_files tool to support recursive directory traversal with optional depth limiting, and improved the entry structure to include relative paths.

Key Changes

• Added recursive listing: New recursive parameter (default True) controls whether subdirectories are traversed
• Added depth limiting: New max_depth parameter allows limiting recursion depth (e.g., max_depth=1 for immediate children only)
• Enhanced entry structure: Each entry now includes a path field with the relative path from the listed directory (using / as separator), in addition to the existing name field
• Symlink safety: Directory symlinks are not followed during recursion to prevent infinite loops
• Improved documentation: Updated docstring to clarify the new parameters and behavior

Implementation Details

• Refactored the listing logic to use a recursive _walk() helper function that respects depth limits
• Directory detection now explicitly excludes symlinks (entry.is_dir() and not entry.is_symlink()) to prevent following circular symlink references
• Entries are still emitted in sorted order and directories appear as their own entries before their children
• The response now includes the recursive parameter value for clarity
• Tool schema in server.py updated with proper parameter definitions and descriptions

https://claude.ai/code/session_012AkYGvzYkJzN7f2VEN3wUn