fix: Expose FileTools directory parameter

[giri256]

Summary

• make FileTools.list_files declare directory as an explicit optional parameter
• expose directory in the generated LLM tool schema instead of a required empty kwargs object
• add a regression test covering the schema shape

Fixes #9075.

Type of change

• Bug fix
• New feature
• Breaking change
• Improvement
• Model update
• Other:

---

Checklist

• Code complies with style guidelines
• Ran format/validation scripts (libs/agno/scripts/format.bat and libs/agno/scripts/validate.bat)
• Self-review completed
• Documentation updated (the existing parameter docstring remains accurate)
• Examples and guides: not applicable for this focused bug fix
• Tested in a clean local virtual environment
• Tests added/updated

Duplicate and AI-Generated PR Check

• I have searched existing open pull requests and confirmed that no other PR already addresses this issue
• If a similar PR exists, I have explained below why this PR is a better approach
• This PR was developed with AI assistance. I reviewed the implementation, diff, and verification results and take responsibility for the change.

Verification

• libs\agno\.venv\Scripts\python.exe -m pytest libs/agno/tests/unit/tools/test_filetools.py -q — 21 passed, 2 platform-specific skips
• libs\agno\scripts\format.bat — 1954 files already formatted; import checks passed
• call libs\agno\.venv\Scripts\activate.bat && call libs\agno\scripts\validate.bat — Ruff passed; mypy found no issues in 937 source files
• git diff --check

Additional Notes

Before the fix, the generated schema was a required empty kwargs object. It now contains an optional string directory property, while direct calls such as list_files(directory="sub") retain their existing behavior.

[harshsinha03]

LGTM! Thanks for contributing