feat: add llama-index-tools-hvf for Hudson Valley Forestry API

[sansscott]

Summary

• Adds llama-index-tools-hvf under llama-index-integrations/tools/
• Implements HVFToolSpec with 9 agent-callable tools wrapping the Hudson Valley Forestry public REST API
• Covers three divisions: residential forestry, goat grazing (HVG), and commercial oil & gas (O&G)
• Package structure mirrors llama-index-tools-openapi exactly

Tools provided

HVF Residential (Hudson Valley Forestry)

Tool	Endpoint	Description
hvf_get_services()	GET /api/agent/services	Service catalog with per-acre pricing
hvf_assess_property(lat, lng, acreage, service_type, vegetation_density?)	POST /api/agent/assess	Service area check + price estimate
hvf_submit_quote(email, name, acreage, service_type, property_description, ...)	POST /api/agent/quote	Submit residential quote → Odoo CRM

HVG Goat Grazing (Hudson Valley Goats)

Tool	Endpoint	Description
hvg_get_services()	GET /api/agent/goat/services	Goat grazing service catalog
hvg_assess_property(lat, lng, acreage, vegetation_type?)	POST /api/agent/goat/assess	Eligibility check + price estimate
hvg_submit_quote(email, name, acreage, service_type, property_description, ...)	POST /api/agent/goat/quote	Submit goat grazing quote → Odoo CRM

Commercial O&G (Oil & Gas Pipeline)

Tool	Endpoint	Description
og_get_services()	GET /api/agent/commercial/services	Commercial service catalog
og_assess_project(lat, lng, service_type?, project_description?, acreage?, corridor_miles?)	POST /api/agent/commercial/assess	Northeast US service area check
og_submit_quote(email, name, service_type, project_description, ...)	POST /api/agent/commercial/quote	Submit commercial quote → Odoo CRM

Package details

• Package: llama-index-tools-hvf
• Import: from llama_index.tools.hvf import HVFToolSpec
• API base: https://app.hudsonvalleyforestry.com
• OpenAPI spec: https://app.hudsonvalleyforestry.com/openapi.json
• Interactive docs: https://app.hudsonvalleyforestry.com/api/docs
• Dependencies: llama-index-core>=0.13.0,<0.15, requests>=2.28.0
• Python: >=3.9,<4.0

Files added

llama-index-integrations/tools/llama-index-tools-hvf/
├── .gitignore
├── CHANGELOG.md
├── LICENSE
├── Makefile
├── README.md
├── examples/
│   └── hvf_tool_usage.ipynb
├── llama_index/tools/hvf/
│   ├── __init__.py
│   └── base.py          ← HVFToolSpec (9 tools, 3 divisions)
├── pyproject.toml
└── tests/
    ├── __init__.py
    └── test_tools_hvf.py  ← 18 mocked tests, no live API calls

Test plan

• pytest llama-index-integrations/tools/llama-index-tools-hvf/tests/ passes (18 tests, all mocked)
• Package installs cleanly: pip install -e llama-index-integrations/tools/llama-index-tools-hvf/
• from llama_index.tools.hvf import HVFToolSpec imports successfully
• HVFToolSpec().to_tool_list() returns 9 tools

🤖 Generated with Claude Code

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[AstraBert]

I think you should probably serialized the returned payload as a string to return that (in my experience that's best for agents)

[AstraBert]

Here and in other places