Skip to content

Add FoxNoseLoader and create_foxnose_tool#1

Merged
loookashow merged 2 commits intomainfrom
feature/loader-tool
Feb 9, 2026
Merged

Add FoxNoseLoader and create_foxnose_tool#1
loookashow merged 2 commits intomainfrom
feature/loader-tool

Conversation

@loookashow
Copy link
Copy Markdown
Contributor

Summary

  • Add FoxNoseLoader — a LangChain BaseLoader for bulk document loading from FoxNose folders with cursor-based pagination, lazy loading, and async support
  • Add create_foxnose_tool() — a factory function that wraps FoxNoseRetriever as a LangChain tool for use with LLM agents
  • Update README with new component descriptions, usage examples, and documentation links

Details

FoxNoseLoader

  • Iterates over all resources in a folder using cursor-based pagination
  • Supports load(), lazy_load(), and alazy_load() for memory-efficient streaming
  • Configurable batch size, filtering, sorting, content mapping, and metadata control
  • Factory method from_client_params() for convenient initialization

create_foxnose_tool

  • Creates a LangChain tool from a new or existing FoxNoseRetriever
  • Customizable tool name and description for agent integration
  • Two response formats: plain string or (str, list[Document]) tuple
  • Compatible with any LangChain agent framework (e.g. langgraph)

Test plan

  • Unit tests for FoxNoseLoader validation and functional behavior
  • Unit tests for create_foxnose_tool validation and functional behavior
  • Shared fixtures extracted to conftest.py
  • Existing retriever tests still pass

- FoxNoseLoader: BaseLoader subclass with cursor-based pagination
  via FluxClient.list_resources(), supports lazy_load/alazy_load
- create_foxnose_tool: convenience wrapper around FoxNoseRetriever
  using LangChain's create_retriever_tool()
- Added tests, docs, and examples for both components
Add documentation for the two new components: bulk document
loader with cursor-based pagination and agent search tool.
Update features list and documentation links accordingly.
@loookashow loookashow merged commit b03db86 into main Feb 9, 2026
6 checks passed
@loookashow loookashow deleted the feature/loader-tool branch February 9, 2026 19:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant