feat: odoo direct integration

[esafwan]

First-Class Odoo ERP Integration for HUF

This PR implements native Odoo ERP integration into HUF, enabling AI agents to interact with Odoo instances via a protocol-agnostic RPC engine, respond to business events in real-time, and query/mutate data across all Odoo modules.

Scope: Odoo 17+ only | New code: ~880 lines across 13 files | Breaking changes: None

---

Why This Matters

Odoo is the most widely deployed open-source ERP. Until now, connecting HUF agents to Odoo required custom tool functions per customer. This integration makes Odoo a first-class citizen — any HUF agent can search, create, update, delete, and execute methods on any Odoo model out of the box.

---

Architecture

Five tightly integrated subsystems:

┌─────────────────────────────────────────────────────┐
│                   HUF Agent                         │
│         (uses Odoo tools in conversations)          │
├─────────────────────────────────────────────────────┤
│              10 Odoo Tool Handlers                  │
│   search_read · read · create · write · unlink      │
│   execute · fields_get · list_models                │
│   search_count · read_group                         │
├─────────────────────────────────────────────────────┤
│           OdooConnector (protocol-agnostic)         │
│          Rate-limited · Connection-scoped           │
├──────────┬──────────────┬───────────────────────────┤
│ XML-RPC  │  JSON-RPC    │  JSON-2 (Odoo 19+)       │
│ (legacy) │  (17–18)     │  Bearer token + REST      │
└──────────┴──────────────┴───────────────────────────┘
          ↕                        ↕
    Odoo Instance              Odoo Instance

Event flow (Odoo → HUF):

Odoo record event
    ├── Path A: Webhook POST → /api/method/huf.ai.odoo.webhook.receive_webhook
    │           (real-time, requires Odoo-side config or companion module)
    │
    ├── Path B: Polling cron (*/5 * * * *) → write_date > last_sync
    │           (universal fallback, 5-min latency)
    │
    └── Both → match Agent Triggers → enqueue background job → run_agent_sync()

---

What's Included

1. Odoo Connection DocType

Stores credentials, protocol, version, and connection state. Key fields:

Field	Type	Notes
odoo_url	Data	Instance URL (validated)
database_name	Data	Odoo DB name
api_key	Password	Encrypted via Frappe Password field
auth_method	Select	API Key (default) or Password
odoo_version	Select	17, 18, 19, or Auto Detect
protocol	Select	JSON-RPC, XML-RPC, JSON-2, or Auto
webhook_key	Password	Auto-generated 32-char hex, encrypted
webhook_url	Data	Computed, read-only
rate_limit_rpm	Int	Default 60 (respects Odoo SaaS throttling)

Backward Compatibility

• No breaking changes. All Odoo functionality is opt-in.
• New odoo_connection field on Agent DocType is hidden unless Odoo tools are present.
• New cron entry is non-blocking.
• Customers without Odoo connections are completely unaffected.

Test Plan

• bench --site <site> migrate applies cleanly
• Both crons register: polling.run_polling_sync (/5) and orchestration.scheduler.process_orchestrations (/1)
• Create Odoo Connection → test_connection() succeeds against Odoo 17/18/19
• 10 tools callable from agent chat (search_read, create, write, etc.)
• Webhook endpoint validates key and triggers agents
• Polling picks up modified records within 5-minute window
• Schema discovery caches model fields
• Rate limiter throttles concurrent requests