cortexflow-google-calendar 0.1.0__tar.gz

cortexflow_google_calendar-0.1.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,34 @@
+# 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/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cortexflow-google-calendar"
+version = "0.1.0"
+description = "CortexFlow plugin — list upcoming Google Calendar events."
+authors = [{ name = "Amit Chandra", email = "amit.vervebot@gmail.com" }]
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+dependencies = [
+    "cortexflow-sdk>=0.1.0",
+    "httpx>=0.27.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.2.0",
+    "pytest-asyncio>=0.23.0",
+]
+
+[project.entry-points."cortexflow.plugins"]
+cortexflow-google-calendar = "cortexflow_google_calendar.plugin:GoogleCalendarPlugin"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

cortexflow_google_calendar-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cortexflow_google_calendar-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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/src/cortexflow_google_calendar.egg-info/PKG-INFO

@@ -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/src/cortexflow_google_calendar.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/cortexflow_google_calendar/__init__.py
+src/cortexflow_google_calendar/plugin.py
+src/cortexflow_google_calendar/tool.py
+src/cortexflow_google_calendar.egg-info/PKG-INFO
+src/cortexflow_google_calendar.egg-info/SOURCES.txt
+src/cortexflow_google_calendar.egg-info/dependency_links.txt
+src/cortexflow_google_calendar.egg-info/entry_points.txt
+src/cortexflow_google_calendar.egg-info/requires.txt
+src/cortexflow_google_calendar.egg-info/top_level.txt
+tests/test_plugin.py
+tests/test_tool.py

cortexflow_google_calendar-0.1.0/src/cortexflow_google_calendar.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cortexflow_google_calendar-0.1.0/src/cortexflow_google_calendar.egg-info/entry_points.txt

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

cortexflow_google_calendar-0.1.0/src/cortexflow_google_calendar.egg-info/requires.txt

@@ -0,0 +1,6 @@
+cortexflow-sdk>=0.1.0
+httpx>=0.27.0
+
+[dev]
+pytest>=8.2.0
+pytest-asyncio>=0.23.0

cortexflow_google_calendar-0.1.0/src/cortexflow_google_calendar.egg-info/top_level.txt

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

cortexflow_google_calendar-0.1.0/tests/test_plugin.py

@@ -0,0 +1,36 @@
+"""Unit tests for cortexflow_google_calendar.plugin — GoogleCalendarPlugin."""
+
+from __future__ import annotations
+
+from cortexflow_google_calendar.plugin import GoogleCalendarPlugin
+from cortexflow_google_calendar.tool import GoogleCalendarEventsTool
+
+
+def test_plugin_metadata():
+    p = GoogleCalendarPlugin()
+    assert p.metadata.name == "cortexflow-google-calendar"
+    assert p.metadata.plugin_type == "tool"
+
+
+def test_plugin_reads_token_from_env(monkeypatch):
+    monkeypatch.setenv("GOOGLE_CALENDAR_ACCESS_TOKEN", "ya29.fromenv")
+    p = GoogleCalendarPlugin()
+    assert p._access_token == "ya29.fromenv"
+
+
+def test_plugin_no_token_in_env(monkeypatch):
+    monkeypatch.delenv("GOOGLE_CALENDAR_ACCESS_TOKEN", raising=False)
+    p = GoogleCalendarPlugin()
+    assert p._access_token is None
+
+
+def test_get_tools_returns_calendar_events_tool():
+    tools = GoogleCalendarPlugin().get_tools()
+    assert len(tools) == 1
+    assert isinstance(tools[0], GoogleCalendarEventsTool)
+
+
+def test_get_tools_tool_carries_plugin_token(monkeypatch):
+    monkeypatch.setenv("GOOGLE_CALENDAR_ACCESS_TOKEN", "ya29.carried")
+    tool = GoogleCalendarPlugin().get_tools()[0]
+    assert tool._access_token == "ya29.carried"

cortexflow_google_calendar-0.1.0/tests/test_tool.py

@@ -0,0 +1,133 @@
+"""Unit tests for cortexflow_google_calendar.tool — GoogleCalendarEventsTool."""
+
+from __future__ import annotations
+
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import pytest
+from cortexflow_google_calendar.tool import GoogleCalendarEventsTool
+
+_SAMPLE_ITEMS = [
+    {
+        "summary": "Team standup",
+        "start": {"dateTime": "2026-06-27T10:00:00Z"},
+        "htmlLink": "https://calendar.google.com/event1",
+    },
+    {
+        "summary": "All-day offsite",
+        "start": {"date": "2026-06-28"},
+        "htmlLink": "https://calendar.google.com/event2",
+    },
+]
+
+
+def _make_mock_client(json_body, raise_on_status: Exception | None = None):
+    mock_resp = MagicMock()
+    mock_resp.raise_for_status = MagicMock(side_effect=raise_on_status)
+    mock_resp.json = MagicMock(return_value=json_body)
+
+    mock_client = MagicMock()
+    mock_client.__aenter__ = AsyncMock(return_value=mock_client)
+    mock_client.__aexit__ = AsyncMock(return_value=False)
+    mock_client.get = AsyncMock(return_value=mock_resp)
+    return mock_client
+
+
+@pytest.mark.asyncio
+async def test_execute_no_token_returns_error():
+    tool = GoogleCalendarEventsTool(access_token=None)
+    result = await tool.execute()
+    assert not result.success
+    assert "GOOGLE_CALENDAR_ACCESS_TOKEN" in result.error
+
+
+@pytest.mark.asyncio
+async def test_execute_returns_formatted_events():
+    tool = GoogleCalendarEventsTool(access_token="ya29.token")
+    mock_client = _make_mock_client({"items": _SAMPLE_ITEMS})
+
+    with patch("httpx.AsyncClient", return_value=mock_client):
+        result = await tool.execute(calendar_id="primary", limit=10)
+
+    assert result.success
+    assert result.output[0]["summary"] == "Team standup"
+    assert result.output[0]["start"] == "2026-06-27T10:00:00Z"
+    assert result.metadata["calendar_id"] == "primary"
+
+
+@pytest.mark.asyncio
+async def test_execute_falls_back_to_all_day_date():
+    tool = GoogleCalendarEventsTool(access_token="ya29.token")
+    mock_client = _make_mock_client({"items": [_SAMPLE_ITEMS[1]]})
+
+    with patch("httpx.AsyncClient", return_value=mock_client):
+        result = await tool.execute()
+
+    assert result.output[0]["start"] == "2026-06-28"
+
+
+@pytest.mark.asyncio
+async def test_execute_missing_summary_uses_placeholder():
+    tool = GoogleCalendarEventsTool(access_token="ya29.token")
+    mock_client = _make_mock_client({"items": [{"start": {"date": "2026-06-29"}}]})
+
+    with patch("httpx.AsyncClient", return_value=mock_client):
+        result = await tool.execute()
+
+    assert result.output[0]["summary"] == "(no title)"
+
+
+@pytest.mark.asyncio
+async def test_execute_sends_bearer_token_and_ordering_params():
+    tool = GoogleCalendarEventsTool(access_token="ya29.token")
+    mock_client = _make_mock_client({"items": []})
+
+    with patch("httpx.AsyncClient", return_value=mock_client):
+        await tool.execute()
+
+    call_kwargs = mock_client.get.call_args[1]
+    assert call_kwargs["headers"]["Authorization"] == "Bearer ya29.token"
+    assert call_kwargs["params"]["orderBy"] == "startTime"
+    assert "timeMin" in call_kwargs["params"]
+
+
+@pytest.mark.asyncio
+async def test_execute_respects_limit():
+    tool = GoogleCalendarEventsTool(access_token="ya29.token")
+    mock_client = _make_mock_client({"items": _SAMPLE_ITEMS})
+
+    with patch("httpx.AsyncClient", return_value=mock_client):
+        result = await tool.execute(limit=1)
+
+    assert len(result.output) == 1
+
+
+@pytest.mark.asyncio
+async def test_execute_http_error_returns_error_result():
+    tool = GoogleCalendarEventsTool(access_token="ya29.token")
+    mock_client = _make_mock_client({}, raise_on_status=RuntimeError("403 Forbidden"))
+
+    with patch("httpx.AsyncClient", return_value=mock_client):
+        result = await tool.execute()
+
+    assert not result.success
+    assert "403" in result.error
+
+
+@pytest.mark.asyncio
+async def test_execute_missing_httpx_returns_error():
+    import builtins
+
+    real_import = builtins.__import__
+
+    def fake_import(name, *args, **kwargs):
+        if name == "httpx":
+            raise ImportError("No module named 'httpx'")
+        return real_import(name, *args, **kwargs)
+
+    tool = GoogleCalendarEventsTool(access_token="ya29.token")
+    with patch("builtins.__import__", side_effect=fake_import):
+        result = await tool.execute()
+
+    assert not result.success
+    assert "pip install httpx" in result.error