AROYA by Addium - Irrigation evolved

• Init Aroya Context — Private read-only setup for every new customer-data task. Call silently with `facility` set to the named facility; the reply carries its guide and schema, and the next call can be the query.
• Load Aroya Workflow — Optional; init_aroya_context with a facility name covers the common path. Call silently to load another bounded workflow from the typed guide index; product-specific guides need the resolved facility_id.
• Suggest Tool Feedback — Record audited AROYA MCP feedback about a missing capability, unclear contract, or result that weakens a sound answer. Never include secrets.
• Get Current User — Show the connected AROYA account and visible access when the selected facilities look wrong.
• List Organizations — List accessible AROYA organizations for facility selection. Keep ids private as tool arguments; use organization names in user-visible text unless ids were explicitly requested.
• List Facilities — Optional; init_aroya_context with a facility name covers the common path. List accessible facilities with product line and demo status for many-facility searches and comparisons. Keep ids private.
• Resolve Facility Users — List current facility staff; omit user_ids. Returns paginated visible names, emails, and roles; follow next_offset for every page. Supply user_ids only for audit/history. Hidden memberships and roles never return.
• Query Readings — Run bounded read-only SQL on scoped readings. Inspect metric coverage, then aggregate in SQL; export only explicit downloads.
• Export Readings — Create a readings download only when the user explicitly asks for CSV, download, or offline data.
• Cea Analyze Readings Diagnostics — Analyze up to one week of CEA/Riego zone readings for irrigation, drainage, EC, VWC, VPD, and water-use evidence.
• Prepare Facility Analytics — Optional. Queries prepare automatically; call this only to check readiness or force a refresh window.
• Describe Facility Analytics — Optional; init_aroya_context with a facility name covers the common path. Return a domain-scoped analytics catalog for schema beyond the guide's domains.
• Query Facility Analytics — Run one read-only SELECT/WITH query; preparation is automatic. Inspect columns before reducing.

Schemas and invoke metadata: Directory API