Add data connectors resource and scope filter support (#51)

## Summary
- Regenerate SDK from updated API spec (data connectors endpoint, scope
on filter models)
- Add `DataConnectors` client resource with `list()` method
- Add `scope` parameter to `_create_video_info_filter()` in both search
and chat resources
- Update `create_filter()` docstrings to document `scope` support

## Test plan
- [x] `pip install -e .` succeeds
- [x] `from cloudglue import Cloudglue` imports cleanly
- [x] `DataConnectors` resource accessible at `client.data_connectors`
- [x] `scope` parameter present on `Search._create_video_info_filter()`
and `Completions._create_video_info_filter()`

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: kdr

Makefile

@@ -13,6 +13,8 @@ GENERATE_OP := openapi-generator generate \
                -o temp-sdk \
                --additional-properties=packageName=cloudglue.sdk
 
+.PHONY: default help setup submodule-init submodule-update generate build publish clean
+
 # Default target when just running `make`
 default: help
 

cloudglue/client/main.py

@@ -20,6 +20,7 @@
 from cloudglue.sdk.api.file_segments_api import FileSegmentsApi
 from cloudglue.sdk.api.response_api import ResponseApi
 from cloudglue.sdk.api.share_api import ShareApi
+from cloudglue.sdk.api.data_connectors_api import DataConnectorsApi
 from cloudglue.sdk.configuration import Configuration
 from cloudglue.sdk.api_client import ApiClient
 
@@ -42,6 +43,7 @@
     FileSegments,
     Responses,
     Share,
+    DataConnectors,
 )
 from cloudglue._version import __version__
 
@@ -93,6 +95,7 @@ def __init__(
         self.file_segments_api = FileSegmentsApi(self.api_client)
         self.response_api = ResponseApi(self.api_client)
         self.share_api = ShareApi(self.api_client)
+        self.data_connectors_api = DataConnectorsApi(self.api_client)
 
         # Set up resources with their respective API clients
         self.chat = Chat(self.chat_api)
@@ -112,6 +115,7 @@ def __init__(
         self.file_segments = FileSegments(self.file_segments_api)
         self.responses = Responses(self.response_api)
         self.share = Share(self.share_api)
+        self.data_connectors = DataConnectors(self.data_connectors_api)
 
     def close(self):
         """Close the API client."""

cloudglue/client/resources/__init__.py

@@ -19,6 +19,7 @@
 from cloudglue.client.resources.file_segments import FileSegments
 from cloudglue.client.resources.responses import Responses
 from cloudglue.client.resources.share import Share
+from cloudglue.client.resources.data_connectors import DataConnectors
 
 __all__ = [
     "CloudglueError",
@@ -40,5 +41,6 @@
     "FileSegments",
     "Responses",
     "Share",
+    "DataConnectors",
 ]
 

cloudglue/client/resources/chat.py

@@ -1,6 +1,6 @@
 # cloudglue/client/resources/chat.py
 """Chat and Completions resources for Cloudglue API."""
-from typing import List, Dict, Any, Optional, Union
+from typing import List, Dict, Any, Optional, Union, Literal
 
 from cloudglue.sdk.models.chat_completion_request import ChatCompletionRequest
 from cloudglue.sdk.models.chat_completion_request_filter import ChatCompletionRequestFilter
@@ -50,15 +50,19 @@ def _create_video_info_filter(
         operator: str,
         value_text: Optional[str] = None,
         value_text_array: Optional[List[str]] = None,
+        scope: Optional[Literal['file', 'segment']] = None,
     ) -> ChatCompletionRequestFilterVideoInfoInner:
         """Create a video info filter.
-        
+
         Args:
             path: JSON path on video_info object (e.g. 'has_audio', 'duration_seconds')
             operator: Comparison operator ('NotEqual', 'Equal', 'LessThan', 'GreaterThan', 'In', 'ContainsAny', 'ContainsAll')
             value_text: Text value for scalar comparison (used with NotEqual, Equal, LessThan, GreaterThan, In)
             value_text_array: Array of values for array comparisons (used with ContainsAny, ContainsAll)
-            
+            scope: Scope of the filter. 'file' filters by source video properties,
+                   'segment' filters by segment properties. Only duration_seconds is
+                   supported with segment scope. Defaults to 'file'.
+
         Returns:
             ChatCompletionRequestFilterVideoInfoInner object
         """
@@ -67,6 +71,7 @@ def _create_video_info_filter(
             operator=operator,
             value_text=value_text,
             value_text_array=value_text_array,
+            scope=scope,
         )
 
     @staticmethod
@@ -133,8 +138,9 @@ def create_filter(
                 - 'operator': Comparison operator
                 - 'value_text': (optional) Text value for scalar comparison  
                 - 'value_text_array': (optional) Array of values for array comparisons
-            video_info_filters: List of video info filter dictionaries (same structure)
-            file_filters: List of file filter dictionaries (same structure)
+            video_info_filters: List of video info filter dictionaries. Same structure as metadata_filters,
+                plus optional 'scope' ('file' or 'segment'). Defaults to 'file'.
+            file_filters: List of file filter dictionaries (same structure as metadata_filters)
             
         Returns:
             ChatCompletionRequestFilter object

cloudglue/client/resources/data_connectors.py

@@ -0,0 +1,35 @@
+# cloudglue/client/resources/data_connectors.py
+"""Data Connectors resource for Cloudglue API."""
+from typing import Optional
+
+from cloudglue.sdk.rest import ApiException
+
+from cloudglue.client.resources.base import CloudglueError
+
+
+class DataConnectors:
+    """Client for the Cloudglue Data Connectors API."""
+
+    def __init__(self, api):
+        """Initialize the DataConnectors client.
+
+        Args:
+            api: The DataConnectorsApi instance.
+        """
+        self.api = api
+
+    def list(self):
+        """List all active data connectors configured for your account.
+
+        Returns:
+            DataConnectorList object
+
+        Raises:
+            CloudglueError: If there is an error listing data connectors.
+        """
+        try:
+            return self.api.list_data_connectors()
+        except ApiException as e:
+            raise CloudglueError(str(e), e.status, e.data, e.headers, e.reason)
+        except Exception as e:
+            raise CloudglueError(str(e))

cloudglue/client/resources/search.py

@@ -63,15 +63,19 @@ def _create_video_info_filter(
         operator: str,
         value_text: Optional[str] = None,
         value_text_array: Optional[List[str]] = None,
+        scope: Optional[Literal['file', 'segment']] = None,
     ) -> SearchFilterVideoInfoInner:
         """Create a video info filter for search.
-        
+
         Args:
             path: Video info field ('duration_seconds', 'has_audio')
             operator: Comparison operator ('NotEqual', 'Equal', 'LessThan', 'GreaterThan', 'In', 'ContainsAny', 'ContainsAll', 'Like')
             value_text: Text value for scalar comparison (used with NotEqual, Equal, LessThan, GreaterThan, Like)
             value_text_array: Array of values for array comparisons (used with ContainsAny, ContainsAll, In)
-            
+            scope: Scope of the filter. 'file' filters by source video properties,
+                   'segment' filters by segment properties. Only duration_seconds is
+                   supported with segment scope. Defaults to 'file'.
+
         Returns:
             SearchFilterVideoInfoInner object
         """
@@ -80,6 +84,7 @@ def _create_video_info_filter(
             operator=operator,
             value_text=value_text,
             value_text_array=value_text_array,
+            scope=scope,
         )
 
     @staticmethod
@@ -125,7 +130,8 @@ def create_filter(
                 - 'value_text': (optional) Text value for scalar comparison  
                 - 'value_text_array': (optional) Array of values for array comparisons
                 - 'scope': (optional) Scope of eligible search items ('file' or 'segment'). Defaults to 'file'.
-            video_info_filters: List of video info filter dictionaries (same structure, without scope)
+            video_info_filters: List of video info filter dictionaries. Same structure as metadata_filters,
+                plus optional 'scope' ('file' or 'segment'). Defaults to 'file'.
             file_filters: List of file filter dictionaries (same structure, without scope)
             
         Returns: