parse tool docstrings

[eliasposen]

Description

Adds ability to parse docstrings in the following styles: google, numpy, rest, epydoc

Related Issues

Fixes #
Related to #

Type of Change

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update
• Performance improvement
• Code refactoring
• Test coverage improvement

Changes Made

• Uses docstring_parser to parse common docstring formats
• Arg descriptions are added to the input schema model properties
• Return descriptions are added to the output schema model

Testing

uv run pytest tests/test_tool_decorator.py::test_docstring_parsing_formats

Test Coverage

• Unit tests added/updated
• Integration tests added/updated
• Manual testing performed

Test Commands Run

cd pctx-py
uv run pytest

Breaking Changes

• This PR includes breaking changes
• Migration guide updated in CHANGELOG.md

Documentation

• Code comments added/updated
• README.md updated (if needed)
• CHANGELOG.md updated under "Unreleased"
• API documentation updated

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published

Screenshots/Videos

Additional Context