Skip to content

Self-improving AI Employees for everyone

2.8 KB
Raw Blame
"""Plugins for the 'google' palette group.

Self-contained plugin folder (Wave 11.H pattern). One folder owns
the entire Google Workspace surface:

- 6 service plugins — ``gmail.py``, ``calendar.py``, ``drive.py``,
  ``sheets.py``, ``tasks.py``, ``contacts.py``, plus
  ``gmail_receive.py`` for the polling trigger.
- ``_credentials.py`` — :class:`GoogleCredential` (OAuth2). The
  6 service plugins all reference this single credential class.
- ``_oauth.py`` — OAuth 2.0 client (formerly
  ``services/google_oauth.py``).
- ``_auth_helper.py`` — shared credential builder + proactive
  refresh (formerly ``services/handlers/google_auth.py``). Used by
  every Workspace plugin to obtain a refresh-aware ``Credentials``
  object.
- ``_handlers.py`` — 3 WebSocket handlers
  (``google_oauth_login`` / ``google_oauth_status`` /
  ``google_logout``).
- ``_router.py`` — HTTP OAuth callback (``/api/google/callback``).

Two self-registration calls below — the central WS dispatcher and
the FastAPI app pick up the plugin's surface without ever importing
this module by name.
"""

from services.deployment.canary_registry import register_canary_trigger_type
from services.event_waiter import register_filter_builder
from services.status_broadcaster import register_service_refresh
from services.ws_handler_registry import (
    register_oauth_callback_path,
    register_option_loader,
    register_router,
    register_ws_handlers,
)

from . import _router
from ._filters import build_gmail_filter
from ._handlers import WS_HANDLERS
from ._option_loaders import (
    load_calendar_list,
    load_drive_folders,
    load_gmail_labels,
    load_tasklists,
)
from ._refresh import refresh_google_status

register_ws_handlers(WS_HANDLERS)
register_router(_router.router, name="google")
register_oauth_callback_path("google", "/api/google/callback")
register_service_refresh(refresh_google_status)
register_filter_builder("googleGmailReceive", build_gmail_filter)

# loadOptionsMethod loaders (Wave 11.I, milestone M.2).
register_option_loader("gmailLabels", load_gmail_labels)
register_option_loader("googleCalendarList", load_calendar_list)
register_option_loader("googleDriveFolders", load_drive_folders)
register_option_loader("googleTasklists", load_tasklists)

# Wave 12 C2: opt googleGmailReceive into the PollingTriggerWorkflow
# consumer path. DeploymentManager detects the PollingTriggerNode
# subclass and routes to PollingTriggerWorkflow (vs the push-side
# TriggerListenerWorkflow) automatically. Producer side: the per-cycle
# Temporal activity is emitted by GmailReceiveNode.as_poll_activity()
# and registered via collect_polling_activities() in the worker. See
# services/deployment/canary_registry.py.
register_canary_trigger_type("googleGmailReceive", "com.opencompany.gmail.message.received")