Self-improving AI Employees for everyone
Python ai-agentsai-employeeai-employeesassistantautonomous-agentsco-employeescompanygrok-botinstinctloop-agentsmuseown-your-datapersonalself-hosted
feat(schema): Wave 6 Phase 4b - Google Workspace loadOptions loaders
trohitg4189d031601e
diff --git a/server/models/nodes.py b/server/models/nodes.pyindex e2eefef6..7aab0ddd 100644--- a/server/models/nodes.py+++ b/server/models/nodes.py@@ -665,7 +665,11 @@ class GmailParams(BaseNodeParams):class CalendarParams(BaseNodeParams):type: Literal["calendar"]operation: Literal["create", "list", "update", "delete"] = "list"- calendar_id: str = Field(default="primary", alias="calendarId")+ calendar_id: str = Field(+ default="primary",+ alias="calendarId",+ json_schema_extra={"loadOptionsMethod": "googleCalendarList"},+ )event_id: str = Field(default="",alias="eventId",@@ -693,7 +697,11 @@ class DriveParams(BaseNodeParams):file_id: str = Field(default="", alias="fileId")file_name: str = Field(default="", alias="fileName")file_path: str = Field(default="", alias="filePath")- folder_id: str = Field(default="", alias="folderId")+ folder_id: str = Field(+ default="",+ alias="folderId",+ json_schema_extra={"loadOptionsMethod": "googleDriveFolders"},+ )class SheetsParams(BaseNodeParams):@@ -707,7 +715,11 @@ class SheetsParams(BaseNodeParams):class TasksParams(BaseNodeParams):type: Literal["tasks"]operation: Literal["create", "list", "complete", "update", "delete"] = "list"- tasklist_id: str = Field(default="@default", alias="tasklistId")+ tasklist_id: str = Field(+ default="@default",+ alias="tasklistId",+ json_schema_extra={"loadOptionsMethod": "googleTasklists"},+ )task_id: str = Field(default="", alias="taskId")title: str = ""notes: str = ""@@ -821,7 +833,11 @@ class GmailReceiveParams(BaseNodeParams):"""Parameters for Gmail receive polling trigger node."""type: Literal["gmailReceive"]filter_query: str = Field(default="is:unread", alias="filterQuery")- label_filter: str = Field(default="INBOX", alias="labelFilter")+ label_filter: str = Field(+ default="INBOX",+ alias="labelFilter",+ json_schema_extra={"loadOptionsMethod": "gmailLabels"},+ )poll_interval: int = Field(default=60, alias="pollInterval", ge=10, le=3600)diff --git a/server/services/node_option_loaders/__init__.py b/server/services/node_option_loaders/__init__.pyindex d834c010..d576ba3f 100644--- a/server/services/node_option_loaders/__init__.py+++ b/server/services/node_option_loaders/__init__.py@@ -21,6 +21,12 @@ is what wires it through.from typing import Any, Awaitable, Callable, Optional+from .google_loaders import (+ load_gmail_labels,+ load_google_calendar_list,+ load_google_drive_folders,+ load_google_tasklists,+)from .whatsapp_loaders import (load_whatsapp_channels,load_whatsapp_group_members,@@ -33,14 +39,15 @@ LoadOptionsFn = Callable[[dict[str, Any]], Awaitable[list[dict[str, Any]]]]LOAD_OPTIONS_REGISTRY: dict[str, LoadOptionsFn] = {- # WhatsApp - already implemented; this just exposes them under the- # unified dispatcher name.+ # WhatsApp - groups, channels, group members."whatsappGroups": load_whatsapp_groups,"whatsappChannels": load_whatsapp_channels,"whatsappGroupMembers": load_whatsapp_group_members,- # Gmail / Calendar / Telegram / Twitter loaders land in follow-up- # commits. The registry is the seam - adding them is a one-line- # registration once the loader function exists.+ # Google Workspace - Gmail labels, Calendar list, Drive folders, Tasks lists.+ "gmailLabels": load_gmail_labels,+ "googleCalendarList": load_google_calendar_list,+ "googleDriveFolders": load_google_drive_folders,+ "googleTasklists": load_google_tasklists,}diff --git a/server/services/node_option_loaders/google_loaders.py b/server/services/node_option_loaders/google_loaders.pynew file mode 100644index 00000000..36dc1d1f--- /dev/null+++ b/server/services/node_option_loaders/google_loaders.py@@ -0,0 +1,97 @@+"""Google Workspace loadOptions adapters.++Wave 6 Phase 4b. Adds dynamic-option loaders for the Gmail label+picker and Calendar list picker. Reuses+services/handlers/google_auth.get_google_credentials() so the OAuth+dance is identical to the workflow-execution path.++Adding more Google loaders (e.g. Drive folder picker, Sheets+spreadsheet picker) = one async function + one entry in this file's+exports + one line in services/node_option_loaders/__init__.py.+"""++import asyncio+from typing import Any+++async def _google_service(api: str, version: str, params: dict[str, Any]):+ """Build a googleapiclient service under the right OAuth credentials.+ `params` may carry ``account_mode`` / ``customer_id`` (customer-mode+ multi-tenant) — falls back to owner tokens otherwise."""++ from googleapiclient.discovery import build++ from services.handlers.google_auth import get_google_credentials++ creds = await get_google_credentials(params, {})+ loop = asyncio.get_event_loop()+ return await loop.run_in_executor(None, lambda: build(api, version, credentials=creds))+++async def load_gmail_labels(params: dict[str, Any]) -> list[dict[str, Any]]:+ """Gmail labels for the label-filter selector on gmailReceive and+ gmail (search)."""++ service = await _google_service("gmail", "v1", params)+ loop = asyncio.get_event_loop()+ response = await loop.run_in_executor(None, lambda: service.users().labels().list(userId="me").execute())+ labels = response.get("labels", [])+ # Stable sort: system labels alphabetical first, then user labels.+ labels.sort(key=lambda l: (l.get("type") != "system", (l.get("name") or "").lower()))+ return [+ {"value": l["id"], "label": l.get("name") or l["id"]}+ for l in labels+ ]+++async def load_google_calendar_list(params: dict[str, Any]) -> list[dict[str, Any]]:+ """Calendar list for the calendarId picker on calendar CRUD."""++ service = await _google_service("calendar", "v3", params)+ loop = asyncio.get_event_loop()+ response = await loop.run_in_executor(None, lambda: service.calendarList().list().execute())+ entries = response.get("items", [])+ # Primary first, rest alphabetised.+ entries.sort(key=lambda c: (not c.get("primary", False), (c.get("summary") or "").lower()))+ return [+ {+ "value": c.get("id", ""),+ "label": c.get("summary") or c.get("id", ""),+ "description": "Primary" if c.get("primary") else c.get("description", ""),+ }+ for c in entries+ ]+++async def load_google_drive_folders(params: dict[str, Any]) -> list[dict[str, Any]]:+ """Drive folders for the folderId picker on drive upload/list."""++ service = await _google_service("drive", "v3", params)+ loop = asyncio.get_event_loop()+ query = "mimeType='application/vnd.google-apps.folder' and trashed=false"+ response = await loop.run_in_executor(+ None,+ lambda: service.files()+ .list(q=query, fields="files(id, name, parents)", pageSize=200)+ .execute(),+ )+ folders = response.get("files", [])+ folders.sort(key=lambda f: (f.get("name") or "").lower())+ return [+ {"value": f.get("id", ""), "label": f.get("name") or f.get("id", "")}+ for f in folders+ ]+++async def load_google_tasklists(params: dict[str, Any]) -> list[dict[str, Any]]:+ """Task lists for the tasklistId picker on tasks CRUD."""++ service = await _google_service("tasks", "v1", params)+ loop = asyncio.get_event_loop()+ response = await loop.run_in_executor(None, lambda: service.tasklists().list().execute())+ lists = response.get("items", [])+ lists.sort(key=lambda l: (l.get("title") or "").lower())+ return [+ {"value": l.get("id", ""), "label": l.get("title") or l.get("id", "")}+ for l in lists+ ]diff --git a/server/tests/test_node_spec.py b/server/tests/test_node_spec.pyindex e3356919..b3d53f15 100644--- a/server/tests/test_node_spec.py+++ b/server/tests/test_node_spec.py@@ -364,11 +364,16 @@ class TestPhase4LoadOptions:for method in ["whatsappGroups", "whatsappChannels", "whatsappGroupMembers"]:assert method in LOAD_OPTIONS_REGISTRY+ def test_registry_has_google_methods(self):+ from services.node_option_loaders import LOAD_OPTIONS_REGISTRY+ for method in ["gmailLabels", "googleCalendarList", "googleDriveFolders", "googleTasklists"]:+ assert method in LOAD_OPTIONS_REGISTRY+def test_list_methods_sorted(self):from services.node_option_loaders import list_load_options_methodsmethods = list_load_options_methods()assert methods == sorted(methods)- assert len(methods) >= 3+ assert len(methods) >= 7@pytest.mark.asyncioasync def test_unknown_method_returns_empty(self):@@ -499,3 +504,23 @@ class TestDisplayOptionsEnrichment:media = spec["inputs"]["properties"]["mediaUrl"]assert "image" in media["displayOptions"]["show"]["message_type"]assert "text" not in media["displayOptions"]["show"]["message_type"]++ def test_gmail_receive_label_carries_load_options(self):+ spec = get_node_spec("gmailReceive")+ label = spec["inputs"]["properties"]["labelFilter"]+ assert label["loadOptionsMethod"] == "gmailLabels"++ def test_calendar_calendar_id_carries_load_options(self):+ spec = get_node_spec("calendar")+ cal = spec["inputs"]["properties"]["calendarId"]+ assert cal["loadOptionsMethod"] == "googleCalendarList"++ def test_drive_folder_id_carries_load_options(self):+ spec = get_node_spec("drive")+ folder = spec["inputs"]["properties"]["folderId"]+ assert folder["loadOptionsMethod"] == "googleDriveFolders"++ def test_tasks_tasklist_id_carries_load_options(self):+ spec = get_node_spec("tasks")+ tl = spec["inputs"]["properties"]["tasklistId"]+ assert tl["loadOptionsMethod"] == "googleTasklists"