cortexflow-google-calendar 0.1.0__py3-none-any.whl

cortexflow_google_calendar/__init__.py

@@ -0,0 +1,7 @@
+"""cortexflow-google-calendar — example CortexFlow plugin: Calendar events."""
+
+from cortexflow_google_calendar.plugin import GoogleCalendarPlugin
+from cortexflow_google_calendar.tool import GoogleCalendarEventsTool
+
+__all__ = ["GoogleCalendarEventsTool", "GoogleCalendarPlugin"]
+__version__ = "0.1.0"

cortexflow_google_calendar/plugin.py

@@ -0,0 +1,34 @@
+"""GoogleCalendarPlugin — registers GoogleCalendarEventsTool with the gateway."""
+
+from __future__ import annotations
+
+import os
+
+from cortexflow_sdk import Plugin, PluginMetadata
+
+from cortexflow_google_calendar.tool import GoogleCalendarEventsTool
+
+
+class GoogleCalendarPlugin(Plugin):
+    """Adds a calendar_list_events tool.
+
+    Reads GOOGLE_CALENDAR_ACCESS_TOKEN from the environment — a short-lived
+    OAuth2 access token, not a long-lived API key. Refreshing that token is
+    left to the operator (e.g. a cron job calling Google's OAuth2 token
+    endpoint with a stored refresh token).
+    """
+
+    metadata = PluginMetadata(
+        name="cortexflow-google-calendar",
+        version="0.1.0",
+        plugin_type="tool",
+        description="List upcoming Google Calendar events.",
+        permissions=["network"],
+        homepage="https://github.com/TheAmitChandra/CortexFlow",
+    )
+
+    def __init__(self) -> None:
+        self._access_token = os.getenv("GOOGLE_CALENDAR_ACCESS_TOKEN")
+
+    def get_tools(self):
+        return [GoogleCalendarEventsTool(access_token=self._access_token)]

cortexflow_google_calendar/tool.py

@@ -0,0 +1,79 @@
+"""GoogleCalendarEventsTool — lists upcoming events from a Google Calendar."""
+
+from __future__ import annotations
+
+import datetime
+
+from cortexflow_sdk import Tool, ToolResult
+
+_EVENTS_URL = "https://www.googleapis.com/calendar/v3/calendars/{calendar_id}/events"
+
+
+def _now_iso() -> str:
+    return datetime.datetime.now(datetime.timezone.utc).isoformat()
+
+
+class GoogleCalendarEventsTool(Tool):
+    """Lists upcoming events from a Google Calendar via the Calendar API v3.
+
+    Requires an OAuth2 access token with the
+    ``https://www.googleapis.com/auth/calendar.readonly`` scope — obtaining
+    that token (the OAuth consent flow) is out of scope for this tool.
+    """
+
+    name = "calendar_list_events"
+    description = "List upcoming events from a Google Calendar."
+    parameters = {
+        "calendar_id": {
+            "type": "str",
+            "description": "Calendar ID, or 'primary' for the user's main calendar",
+            "required": False,
+        },
+        "limit": {"type": "int", "description": "Max events to return (default 10)", "required": False},
+    }
+    permissions = ["network"]
+
+    def __init__(self, access_token: str | None = None) -> None:
+        self._access_token = access_token
+
+    async def execute(self, calendar_id: str = "primary", limit: int = 10, **_) -> ToolResult:
+        if not self._access_token:
+            return ToolResult(
+                tool=self.name, output=None, error="GOOGLE_CALENDAR_ACCESS_TOKEN not set",
+            )
+
+        try:
+            import httpx
+        except ImportError:
+            return ToolResult(tool=self.name, output=None, error="pip install httpx")
+
+        url = _EVENTS_URL.format(calendar_id=calendar_id)
+        headers = {"Authorization": f"Bearer {self._access_token}"}
+        params = {
+            "timeMin": _now_iso(),
+            "maxResults": min(limit, 100),
+            "singleEvents": "true",
+            "orderBy": "startTime",
+        }
+
+        try:
+            async with httpx.AsyncClient() as client:
+                resp = await client.get(url, headers=headers, params=params, timeout=10.0)
+                resp.raise_for_status()
+                data = resp.json()
+        except Exception as exc:
+            return ToolResult(tool=self.name, output=None, error=str(exc))
+
+        events = [
+            {
+                "summary": e.get("summary", "(no title)"),
+                "start": (e.get("start") or {}).get("dateTime") or (e.get("start") or {}).get("date", ""),
+                "link": e.get("htmlLink", ""),
+            }
+            for e in data.get("items", [])[:limit]
+        ]
+        return ToolResult(
+            tool=self.name,
+            output=events,
+            metadata={"calendar_id": calendar_id, "count": len(events)},
+        )

cortexflow_google_calendar-0.1.0.dist-info/METADATA

@@ -0,0 +1,50 @@
+Metadata-Version: 2.4
+Name: cortexflow-google-calendar
+Version: 0.1.0
+Summary: CortexFlow plugin — list upcoming Google Calendar events.
+Author-email: Amit Chandra <amit.vervebot@gmail.com>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cortexflow-sdk>=0.1.0
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.2.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Dynamic: license-file
+
+# cortexflow-google-calendar
+
+Example CortexFlow plugin: a `calendar_list_events` tool that lists upcoming
+events from a Google Calendar via Calendar API v3.
+
+## Install
+
+```bash
+pip install -e ./cortexflow-sdk        # not yet on PyPI
+pip install -e examples/plugins/cortexflow-google-calendar
+```
+
+## Setup
+
+This tool expects an OAuth2 **access token** with the
+`https://www.googleapis.com/auth/calendar.readonly` scope, set as
+`GOOGLE_CALENDAR_ACCESS_TOKEN`. Obtaining and refreshing that token (the
+OAuth consent flow against Google's identity service) is outside this
+plugin's scope — wire it up via your own token-refresh job or a library like
+`google-auth-oauthlib`.
+
+## Usage
+
+```python
+from cortexflow_google_calendar import GoogleCalendarEventsTool
+
+tool = GoogleCalendarEventsTool(access_token="ya29....")
+result = await tool.execute(calendar_id="primary", limit=5)
+print(result.output)
+```
+
+Once installed alongside the CortexFlow gateway, `PluginRegistry.discover()`
+finds it via the `cortexflow.plugins` entry point declared in
+`pyproject.toml`.

cortexflow_google_calendar-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+cortexflow_google_calendar/__init__.py,sha256=7g-JI3-cPsZO1wzrFHdqybCrhRwgD1og2pPn2gw-odo,304
+cortexflow_google_calendar/plugin.py,sha256=dKzmSlhYJjzTPhUXgZo1cZUAeE3rVomQlzBZpUrMXCQ,1107
+cortexflow_google_calendar/tool.py,sha256=FwhnERXOzoQ_9LEv3iqY1abj3cV1vEqQuUJ7sldcsKM,2781
+cortexflow_google_calendar-0.1.0.dist-info/licenses/LICENSE,sha256=7Dz5G7L1S2nxC1KQDChyyWKVx4NDmJJDf-KNruUtrHk,1069
+cortexflow_google_calendar-0.1.0.dist-info/METADATA,sha256=NZRAdpNC4fCoNJnVw_XTq4UaVg8cXoxKjhaP4b51t_c,1561
+cortexflow_google_calendar-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+cortexflow_google_calendar-0.1.0.dist-info/entry_points.txt,sha256=GNbYnWsDyoKmR9HnAiglAq-tIR9qEDRXuTTSwpBmGXE,105
+cortexflow_google_calendar-0.1.0.dist-info/top_level.txt,sha256=70TUltWNZDVK0ex9gf0RULpZUjIcXE9D7voP8Y54ND8,27
+cortexflow_google_calendar-0.1.0.dist-info/RECORD,,

cortexflow_google_calendar-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

cortexflow_google_calendar-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[cortexflow.plugins]
+cortexflow-google-calendar = cortexflow_google_calendar.plugin:GoogleCalendarPlugin

cortexflow_google_calendar-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amit Chandra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cortexflow_google_calendar-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+cortexflow_google_calendar