Add comprehensive docstrings to LanceDB adapter

[devin-ai-integration]

Add comprehensive docstrings to LanceDB adapter

Summary

This PR addresses issue #3955 by adding comprehensive Google-style docstrings to all public functions and classes in lancedb_adapter.py. The docstrings include Args, Returns, Raises, and Example sections where appropriate, following the format requested in the issue.

Changes:

• Added docstrings to LanceDBAdapter class with detailed attribute descriptions
• Added docstrings to all public methods: model_post_init(), query(), and add()
• Added docstring to _default_embedding_function() helper function
• Created test file test_lancedb_adapter_docs.py to verify docstrings exist and contain required sections

Review & Testing Checklist for Human

• Verify test passes in CI - I couldn't run tests locally due to a pytest plugin conflict (pytest-recording vs pytest-vcr), so please confirm the new test file runs successfully in CI
• Review docstring examples for accuracy - The code examples in the docstrings are illustrative but haven't been executed. Please verify they would actually work as written, especially the query() and add() method examples
• Check technical accuracy - Review the docstring descriptions to ensure they accurately describe the behavior, particularly around LanceDB connection handling and vector search parameters
• Confirm scope is appropriate - The issue mentioned lancedb_adapter.py as an example. If other adapter files also need docstrings, this PR only covers lancedb_adapter.py

Test Plan

1. Run uv run pytest lib/crewai-tools/tests/adapters/test_lancedb_adapter_docs.py -vv to verify all docstring tests pass
2. Optionally, try running one of the code examples from the docstrings to verify they work correctly

Notes

• Docstrings follow Google style with Args, Returns, Raises, and Example sections as requested in issue [FEATURE] Add doc string to methods where they are missing #3955
• The test file uses pytest.importorskip("lancedb") to skip tests if LanceDB is not installed (it's an optional dependency)
• All changes passed local Ruff linting checks

Link to Devin run: https://app.devin.ai/sessions/0e6f94a041a64b3e9b982fde27c9f66d
Requested by: João ([email protected])

Closes #3955

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring