scheme-sdk 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

scheme_sdk/connectors/base/base.py

@@ -3,24 +3,6 @@ SeedVault Connector SDK - Base Classes and Utilities
 
 This module provides the core interfaces for building platform connectors.
 Third-party developers should inherit from BaseConnector to create custom integrations.
-
-Example:
-    from seedvault.connector_sdk.base import BaseConnector, ConnectorAuthError
-
-    class MyConnector(BaseConnector):
-        platform = "my_platform"
-
-        def authenticate(self):
-            # Verify credentials
-            pass
-
-        def fetch_conversations(self):
-            # Return conversation/channel list
-            yield {...}
-
-        def fetch_messages(self, conversation_id, since=None):
-            # Return messages from a conversation
-            yield {...}
 """
 
 import logging
@@ -29,8 +11,12 @@ from abc import ABC, abstractmethod
 from functools import wraps
 from typing import Any, Dict, Optional
 
-from .errors import (ConnectorAPIError, ConnectorAuthError,
-                     ConnectorConfigError, ConnectorRateLimitError)
+from .errors import (
+    ConnectorAPIError,
+    ConnectorAuthError,
+    ConnectorConfigError,
+    ConnectorRateLimitError,
+)
 
 # ============================================================================
 # CONTEXT
@@ -111,7 +97,6 @@ class BaseConnector(ABC):
     This is the primary interface that third-party developers should implement
     to create custom platform integrations. The connector handles:
 
-    - Authentication with the platform
     - Fetching conversations/channels/threads
     - Fetching messages with incremental sync support
     - Pagination and rate limiting (via helper methods)
@@ -120,11 +105,6 @@ class BaseConnector(ABC):
     Required Attributes:
         platform (str): Unique identifier for the platform (e.g., "slack", "gmail")
 
-    Required Methods:
-        authenticate(): Verify credentials are valid
-        fetch_conversations(): Return list of conversations/channels
-        fetch_messages(): Return messages from a specific conversation
-
     Optional Methods:
         normalize_message(): Transform platform-specific format to canonical format
         get_user_info(): Fetch information about a specific user
@@ -139,12 +119,6 @@ class BaseConnector(ABC):
         ...         self.api_key = context.require_config("api_key")
         ...         self.base_url = "https://api.myplatform.com/v1"
         ...
-        ...     def authenticate(self):
-        ...         response = requests.get(f"{self.base_url}/auth/verify",
-        ...                                 headers=self._get_headers())
-        ...         if response.status_code != 200:
-        ...             raise ConnectorAuthError("Invalid API key")
-        ...
         ...     def fetch_conversations(self):
         ...         for page in self._paginate("/conversations"):
         ...             yield from page.get("conversations", [])
@@ -176,38 +150,8 @@ class BaseConnector(ABC):
             )
 
         self.context = context
-        self._authenticated = False
         self._logger = context.logger
 
-    # ========================================================================
-    # REQUIRED METHODS - Must be implemented by subclasses
-    # ========================================================================
-
-    @abstractmethod
-    def authenticate(self) -> None:
-        """
-        Verify that credentials are valid and the connector can access the platform.
-
-        This method should perform a lightweight check (e.g., GET /auth/verify)
-        rather than expensive operations. It will be called before any data
-        fetching operations.
-
-        Raises:
-            ConnectorAuthError: If authentication fails
-            ConnectorAPIError: If the API request fails
-
-        Example:
-            >>> def authenticate(self):
-            ...     response = requests.get(f"{self.base_url}/auth/verify",
-            ...                           headers=self._get_headers())
-            ...     if response.status_code == 401:
-            ...         raise ConnectorAuthError("Invalid credentials")
-            ...     elif response.status_code != 200:
-            ...         raise ConnectorAPIError("Auth check failed", response.status_code)
-            ...     self._authenticated = True
-        """
-        ...
-
     # ========================================================================
     # OPTIONAL METHODS - Can be overridden for enhanced functionality
     # ========================================================================
@@ -299,28 +243,6 @@ class BaseConnector(ABC):
 # ============================================================================
 
 
-def require_auth(func):
-    """
-    Decorator to ensure connector is authenticated before executing method.
-
-    Example:
-        >>> @require_auth
-        ... def fetch_conversations(self):
-        ...     # This will only run if authenticate() has been called
-        ...     pass
-    """
-
-    @wraps(func)
-    def wrapper(self, *args, **kwargs):
-        if not self._authenticated:
-            raise ConnectorAuthError(
-                f"Connector not authenticated. Call authenticate() first."
-            )
-        return func(self, *args, **kwargs)
-
-    return wrapper
-
-
 def retry_on_error(max_retries: int = 3, backoff: float = 1.0):
     """
     Decorator to retry operations on transient failures.

scheme_sdk/connectors/outlook.py

@@ -18,33 +18,54 @@ class OutlookConnector(MessageConnector):
         self.base = "https://graph.microsoft.com/v1.0"
 
     def fetch_conversations(
-        self, top: int = 50, since_iso: Optional[str] = None
+        self,
+        top: int = 50,
+        query: Optional[str] = None,
+        since_iso: Optional[str] = None,
     ) -> List[Dict]:
         url = f"{self.base}/me/messages"
+        page_size = min(max(top, 50), 200)
         params = {
             "$select": "id,conversationId,subject,from,receivedDateTime,hasAttachments",
             "$orderby": "receivedDateTime desc",
-            "$top": str(top),
+            "$top": str(page_size),
         }
         if since_iso:
             params["$filter"] = f"receivedDateTime ge {since_iso}"
+        if query:
+            params["$search"] = query
 
-        messages = self._get_paged(url, headers=self._headers(), params=params)
-
-        # Dedupe by conversationId
+        # Dedupe by conversationId, fetching more pages until we have enough.
         threads_by_conv: Dict[str, Dict] = {}
-        for m in messages:
-            cid = m.get("conversationId")
-            if not cid:
-                continue
-            if cid not in threads_by_conv:
+        next_url = url
+        next_params: Optional[Dict[str, str]] = params
+
+        while next_url and len(threads_by_conv) < top:
+            resp = self._request_with_throttling_retry(
+                next_url, headers=self._headers(), params=next_params
+            )
+            resp.raise_for_status()
+            data = resp.json()
+
+            for m in data.get("value", []):
+                cid = m.get("conversationId")
+                if not cid or cid in threads_by_conv:
+                    continue
                 threads_by_conv[cid] = m
+                if len(threads_by_conv) >= top:
+                    break
+
+            # Per Graph guidance: use @odata.nextLink as-is
+            next_url = data.get("@odata.nextLink")
+            next_params = None  # nextLink already includes the query string
 
         conv_list = list(threads_by_conv.values())
         return [self.normalize_conversation(c) for c in conv_list]
 
     def fetch_messages(
-        self, conversation_id: str, since_iso: Optional[str] = None
+        self,
+        conversation_id: str,
+        since_iso: Optional[str] = None,
     ) -> List[Dict]:
         url = f"{self.base}/me/messages"
         filter_parts = [f"conversationId eq '{conversation_id}'"]

{scheme_sdk-0.3.1.dist-info → scheme_sdk-0.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: scheme_sdk
-Version: 0.3.1
+Version: 0.3.3
 Summary: The Scheme SDK provides connectors for ingesting conversations, messages, and files across communication platforms.
 License:                                  Apache License
                                     Version 2.0, January 2004

{scheme_sdk-0.3.1.dist-info → scheme_sdk-0.3.3.dist-info}/RECORD

@@ -1,13 +1,13 @@
 scheme_sdk/__init__.py,sha256=bQ_i10iSwabzAhS5CapMVplDhMXptJB0qhcgxW_-lnU,26
 scheme_sdk/connectors/__init__.py,sha256=d7XyCKbx0QklcAFyhTbNxTg0PakQfTs3eQSayYUonqs,144
 scheme_sdk/connectors/base/__init__.py,sha256=-cfbvvzduJG-hBnojPEkwJEj_dHoVi-EqsDf2l3Oie8,692
-scheme_sdk/connectors/base/base.py,sha256=pgZkS5x-GYB2Cv4UeQs94TmcROeGzH9ZgqXubwXW6EI,11771
+scheme_sdk/connectors/base/base.py,sha256=JtsD-HBdjC_Jl22M9j-ihe0tyXJw6JpgWsZp_ozCwDA,8855
 scheme_sdk/connectors/base/errors.py,sha256=53Dhz5qImXJe0q0cO7IqG4yja0OC0hnxMNMMmgdCtW0,1152
 scheme_sdk/connectors/base/message.py,sha256=pW-snYsHlAQ5-qMFzAQr3CDaNG1Z-HRYB1fdmZww1TU,5423
 scheme_sdk/connectors/discord.py,sha256=CdtzVlwT0aHcUayhLGno_vmfhdt_WRtGOeV2zj7Ye7I,844
 scheme_sdk/connectors/gmail.py,sha256=wZCj917qujXSE9jexqvkDgdmz02y6QST8q9KNRwEvg0,866
-scheme_sdk/connectors/outlook.py,sha256=Pm96yZjmCe9YcqbUNNtoegAbEGDciEEK5rrzSDlx5E0,5477
+scheme_sdk/connectors/outlook.py,sha256=ddkA9crJrFgUKT58GC9Brubc4X2tUPDDKDN4RTILYlo,6232
 scheme_sdk/connectors/slack.py,sha256=_g--XxS4_ImT0fs0HX9vNquTkUlaikiylBhsgJzCC-4,1434
-scheme_sdk-0.3.1.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
-scheme_sdk-0.3.1.dist-info/METADATA,sha256=D9GkB8KnO1hHdxiH9Mv5iFiJfkxx8LgCmGId2LRpBxw,15084
-scheme_sdk-0.3.1.dist-info/RECORD,,
+scheme_sdk-0.3.3.dist-info/WHEEL,sha256=e_m4S054HL0hyR3CpOk-b7Q7fDX6BuFkgL5OjAExXas,80
+scheme_sdk-0.3.3.dist-info/METADATA,sha256=QyUCmLuOHyxTeby0OEZlGl2s0_HpK4hDZQqHiNcfqsg,15084
+scheme_sdk-0.3.3.dist-info/RECORD,,

{scheme_sdk-0.3.1.dist-info → scheme_sdk-0.3.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.26
+Generator: uv 0.9.27
 Root-Is-Purelib: true
 Tag: py3-none-any