Improving debugger.py

[george-adams1]

Sorry for the size of this PR. Issues to fix kept growing. See below:

Use typing to make the function signatures clearer. Use constants for hard-coded values. Create a helper function for checking file extensions. Improve the error handling in the walk_directory function. Use f-strings for better readability and performance. Add function and module-level docstrings for better understanding of the code.

[swyxio]

thats great, thanks so much! the biggest issue with debugger is that context length becomes a problem much sooner than most. would like to fix that next, but happy to discuss what the right approach is in issues (i may move faster than issues here)

[swyxio]

i have not merged yet because i'm not sure that this is how i want the code style to be, but also have not closed because i might come around to it

[george-adams1]

Ok sounds good. Let me know if there's anything else I can do.

[swyxio]

you've done great. just share usecases/examples/pain points! i'll be refactoring quite a bit this week to accommodate the enlarged planning.