feat(hubspot): add native HubSpot CRM integration (contacts, companies, deals)

[AadiSharma49]

Description

This PR adds a native HubSpot CRM integration to the Aden Agent Framework, enabling Hive agents to securely interact with HubSpot contacts and deals using HubSpot’s official APIs.

The integration supports both Private App tokens and OAuth 2.0 authentication, allowing agents to fetch, create, and update CRM records. This removes the need for manual syncing or external scripts and unlocks automated sales and customer workflows inside Hive.

Type of Change

• New feature (non-breaking change that adds functionality)

Related Issues

Fixes #2805
Fixes #2848
(Expand agent capabilities by adding more integrations/tools)

Changes Made

Added HubSpot CRM MCP tool with full Contacts, Companies, and Deals support

• List/search records
• Get contact by ID and by email
• Create and update contacts, companies, and deals
• Update deal stage helper

Implemented HubSpot OAuth2 provider with pre-configured endpoints and CRM scopes

Added credential integration for HubSpot (env var + credential store support)

Implemented pagination support for search endpoints

Added comprehensive unit tests covering:

• Client behavior and error handling
• MCP tool registration
• Contact, company, and deal operations
• OAuth2 provider configuration and validation

Testing

• Unit tests pass

pytest tools/src/aden_tools/tools/hubspot_tool/tests/test_hubspot_tool.py -v

• OAuth2 provider tests pass
• Credential spec tests pass
• Manual verification of tool registration and error handling

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
• I have made corresponding changes to the documentation
• 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

Screenshots (if applicable)

Add screenshots to demonstrate UI changes.

In addition to the HubSpot CRM integration introduced in this PR, I also addressed and aligned the implementation with learnings from related work and discussions in:

PR: #1846

Issue: #1488

These helped ensure the integration follows existing patterns around tool registration, credentials, and error handling.

What this PR adds (at a glance)

• HubSpot CRM – Contacts and Deals Management
• List and search contacts and deals (with pagination support)
• Get contact by ID or email
• Create and update contacts and deals
• Update deal stage
• Credential-store and environment-variable support

If there’s anything you’d like me to change—naming, scope, structure, or test coverage—please let me know and I’ll be happy to revise it quickly.

Thanks for reviewing!

@bryanadenhq @RichardTang-Aden @austin931114 @vincentjiang777 @TimothyZhang7

hey @RichardTang-Aden This PR replaces #3910, which I closed earlier while cleaning up branches.
The implementation remains the same, with minor refinements and rebasing on the latest main branch.

Apologies for any confusion.

[AadiSharma49]

@bryanadenhq @RichardTang-Aden @vincentjiang777 please review it !!