Skip to content

Self-improving AI Employees for everyone

feat(schema): Wave 6 Phase 4b - Google Workspace loadOptions loaders

trohitg4189d031601e
diff --git a/server/models/nodes.py b/server/models/nodes.py
index 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__.py
index 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.py
new file mode 100644
index 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.py
index 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_methods
methods = list_load_options_methods()
assert methods == sorted(methods)
- assert len(methods) >= 3
+ assert len(methods) >= 7
@pytest.mark.asyncio
async 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"