python sdk v0.3.4 (#31)

changes
- pull latest api spec and regenerate low level sdk
- expose file liter for list collection files
- expose pagination options for describe / get media descriptions, and
extract
- expose options for enabling audio description in describe based
operations
- bump package version

Author: kdr

cloudglue/client/resources.py

@@ -583,6 +583,7 @@ def list_videos(
         added_after: Optional[str] = None,
         order: Optional[str] = None,
         sort: Optional[str] = None,
+        filter: Optional[Union[SearchFilter, Dict[str, Any]]] = None,
     ):
         """List videos in a collection.
 
@@ -595,14 +596,24 @@ def list_videos(
             added_after: Filter by videos added after a specific date, YYYY-MM-DD format in UTC
             order: Field to sort by ('created_at'). Defaults to 'created_at'
             sort: Sort direction ('asc', 'desc'). Defaults to 'desc'
-
+            filter: Optional filter object or dictionary for advanced filtering by metadata, video info, or file properties.
+                   Use Files.create_filter() to create filter objects.
         Returns:
             The typed CollectionFileList object with videos and metadata
 
         Raises:
             CloudGlueError: If there is an error listing the videos or processing the request.
         """
         try:
+            # Convert filter dict to SearchFilter object if needed
+            filter_obj = None
+            if filter is not None:
+                if isinstance(filter, dict):
+                    # Convert dict to SearchFilter object
+                    filter_obj = SearchFilter(**filter)
+                else:
+                    filter_obj = filter
+
             # Use the standard method to get a properly typed object
             response = self.api.list_videos(
                 collection_id=collection_id,
@@ -613,6 +624,7 @@ def list_videos(
                 added_after=added_after,
                 order=order,
                 sort=sort,
+                filter=json.dumps(filter_obj.to_dict()) if filter_obj else None,
             )
             return response
         except ApiException as e:
@@ -648,13 +660,17 @@ def get_rich_transcripts(
         self,
         collection_id: str,
         file_id: str,
+        start_time_seconds: Optional[float] = None,
+        end_time_seconds: Optional[float] = None,
         response_format: Optional[str] = None,
     ):
         """Get the rich transcript of a video in a collection.
 
         Args:
             collection_id: The ID of the collection
             file_id: The ID of the file to retrieve the rich transcript for
+            start_time_seconds: The start time in seconds to filter the rich transcript
+            end_time_seconds: The end time in seconds to filter the rich transcript
             response_format: The format of the response, one of 'json' or 'markdown' (json by default)
 
         Returns:
@@ -666,7 +682,7 @@ def get_rich_transcripts(
         try:
             # Use the standard method to get a properly typed object
             response = self.api.get_transcripts(
-                collection_id=collection_id, file_id=file_id, response_format=response_format
+                collection_id=collection_id, file_id=file_id, start_time_seconds=start_time_seconds, end_time_seconds=end_time_seconds, response_format=response_format
             )
             return response
         except ApiException as e:
@@ -810,13 +826,17 @@ def get_media_descriptions(
         self,
         collection_id: str,
         file_id: str,
+        start_time_seconds: Optional[float] = None,
+        end_time_seconds: Optional[float] = None,
         response_format: Optional[str] = None,
     ):
         """Get the media descriptions of a video in a collection.
 
         Args:
             collection_id: The ID of the collection
             file_id: The ID of the file to retrieve the media descriptions for
+            start_time_seconds: The start time in seconds to filter the media descriptions
+            end_time_seconds: The end time in seconds to filter the media descriptions
             response_format: The format of the response, one of 'json' or 'markdown' (json by default)
 
         Returns:
@@ -828,7 +848,7 @@ def get_media_descriptions(
         try:
             # Use the standard method to get a properly typed object
             response = self.api.get_media_descriptions(
-                collection_id=collection_id, file_id=file_id, response_format=response_format
+                collection_id=collection_id, file_id=file_id, start_time_seconds=start_time_seconds, end_time_seconds=end_time_seconds, response_format=response_format
             )
             return response
         except ApiException as e:
@@ -966,20 +986,26 @@ def create(
         except Exception as e:
             raise CloudGlueError(str(e))
 
-    def get(self, job_id: str):
+    def get(
+        self, 
+        job_id: str,
+        limit: Optional[int] = None,
+        offset: Optional[int] = None,
+        ):
         """Get the status of an extraction job.
 
         Args:
             job_id: The ID of the extraction job.
-
+            limit: Maximum number of segment entities to return (1-100)
+            offset: Number of segment entities to skip
         Returns:
             Extract: A typed Extract object containing the job status and extracted data if available.
 
         Raises:
             CloudGlueError: If there is an error retrieving the extraction job or processing the request.
         """
         try:
-            response = self.api.get_extract(job_id=job_id)
+            response = self.api.get_extract(job_id=job_id, limit=limit, offset=offset)
             return response
         except ApiException as e:
             raise CloudGlueError(str(e), e.status, e.data, e.headers, e.reason)
@@ -1105,6 +1131,7 @@ def create(
         enable_speech: bool = True,
         enable_scene_text: bool = False,
         enable_visual_scene_description: bool = False,
+        enable_audio_description: bool = False,
         segmentation_id: Optional[str] = None,
         segmentation_config: Optional[Union[SegmentationConfig, Dict[str, Any]]] = None,
         thumbnails_config: Optional[Union[Dict[str, Any], Any]] = None,
@@ -1117,6 +1144,7 @@ def create(
             enable_speech: Whether to generate speech transcript.
             enable_scene_text: Whether to generate scene text.
             enable_visual_scene_description: Whether to generate visual scene description.
+            enable_audio_description: Whether to generate audio description.
             segmentation_id: Segmentation job id to use. Cannot be provided together with segmentation_config.
             segmentation_config: Configuration for video segmentation. Cannot be provided together with segmentation_id.
             thumbnails_config: Optional configuration for segment thumbnails
@@ -1149,6 +1177,7 @@ def create(
                 enable_speech=enable_speech,
                 enable_scene_text=enable_scene_text,
                 enable_visual_scene_description=enable_visual_scene_description,
+                enable_audio_description=enable_audio_description,
                 segmentation_id=segmentation_id,
                 segmentation_config=segmentation_config,
                 thumbnails_config=thumbnails_config_obj,
@@ -1236,6 +1265,7 @@ def run(
         enable_speech: bool = True,
         enable_scene_text: bool = False,
         enable_visual_scene_description: bool = False,
+        enable_audio_description: bool = False,
         segmentation_id: Optional[str] = None,
         segmentation_config: Optional[Union[SegmentationConfig, Dict[str, Any]]] = None,
         thumbnails_config: Optional[Union[Dict[str, Any], Any]] = None,
@@ -1251,6 +1281,7 @@ def run(
             enable_speech: Whether to generate speech transcript.
             enable_scene_text: Whether to generate scene text.
             enable_visual_scene_description: Whether to generate visual scene description.
+            enable_audio_description: Whether to generate audio description.
             segmentation_id: Segmentation job id to use. Cannot be provided together with segmentation_config.
             segmentation_config: Configuration for video segmentation. Cannot be provided together with segmentation_id.
             thumbnails_config: Optional configuration for segment thumbnails
@@ -1269,6 +1300,7 @@ def run(
                 enable_speech=enable_speech,
                 enable_scene_text=enable_scene_text,
                 enable_visual_scene_description=enable_visual_scene_description,
+                enable_audio_description=enable_audio_description,
                 segmentation_id=segmentation_id,
                 segmentation_config=segmentation_config,
                 thumbnails_config=thumbnails_config,
@@ -1311,6 +1343,7 @@ def create(
         enable_speech: bool = True,
         enable_scene_text: bool = True,
         enable_visual_scene_description: bool = True,
+        enable_audio_description: bool = True,
         segmentation_id: Optional[str] = None,
         segmentation_config: Optional[Union[SegmentationConfig, Dict[str, Any]]] = None,
         thumbnails_config: Optional[Union[Dict[str, Any], Any]] = None,
@@ -1323,6 +1356,7 @@ def create(
             enable_speech: Whether to generate speech transcript.
             enable_scene_text: Whether to generate scene text extraction.
             enable_visual_scene_description: Whether to generate visual scene description.
+            enable_audio_description: Whether to generate audio description.
             segmentation_id: Segmentation job id to use. Cannot be provided together with segmentation_config.
             segmentation_config: Configuration for video segmentation. Cannot be provided together with segmentation_id.
             thumbnails_config: Optional configuration for segment thumbnails
@@ -1355,6 +1389,7 @@ def create(
                 enable_speech=enable_speech,
                 enable_scene_text=enable_scene_text,
                 enable_visual_scene_description=enable_visual_scene_description,
+                enable_audio_description=enable_audio_description,
                 segmentation_id=segmentation_id,
                 segmentation_config=segmentation_config,
                 thumbnails_config=thumbnails_config_obj,
@@ -1368,13 +1403,20 @@ def create(
         except Exception as e:
             raise CloudGlueError(str(e))
 
-    def get(self, job_id: str, response_format: Optional[str] = None):
+    def get(
+        self,
+        job_id: str,
+        response_format: Optional[str] = None,
+        start_time_seconds: Optional[float] = None,
+        end_time_seconds: Optional[float] = None,
+    ):
         """Get the status and data of a media description job.
 
         Args:
             job_id: The unique identifier of the description job.
             response_format: The format of the response, one of 'json' or 'markdown' (json by default)
-
+            start_time_seconds: The start time in seconds to filter the media descriptions
+            end_time_seconds: The end time in seconds to filter the media descriptions  
         Returns:
             The typed Describe job object with current status and data (if completed).
 
@@ -1383,7 +1425,7 @@ def get(self, job_id: str, response_format: Optional[str] = None):
         """
         try:
             # Use the standard method to get a properly typed object
-            response = self.api.get_describe(job_id=job_id, response_format=response_format)
+            response = self.api.get_describe(job_id=job_id, response_format=response_format, start_time_seconds=start_time_seconds, end_time_seconds=end_time_seconds)
             return response
         except ApiException as e:
             raise CloudGlueError(str(e), e.status, e.data, e.headers, e.reason)
@@ -1443,6 +1485,7 @@ def run(
         enable_speech: bool = True,
         enable_scene_text: bool = True,
         enable_visual_scene_description: bool = True,
+        enable_audio_description: bool = False,
         segmentation_id: Optional[str] = None,
         segmentation_config: Optional[Union[SegmentationConfig, Dict[str, Any]]] = None,
         thumbnails_config: Optional[Union[Dict[str, Any], Any]] = None,
@@ -1458,6 +1501,7 @@ def run(
             enable_speech: Whether to generate speech transcript.
             enable_scene_text: Whether to generate scene text extraction.
             enable_visual_scene_description: Whether to generate visual scene description.
+            enable_audio_description: Whether to generate audio description.
             segmentation_id: Segmentation job id to use. Cannot be provided together with segmentation_config.
             segmentation_config: Configuration for video segmentation. Cannot be provided together with segmentation_id.
             thumbnails_config: Optional configuration for segment thumbnails
@@ -1476,6 +1520,7 @@ def run(
                 enable_speech=enable_speech,
                 enable_scene_text=enable_scene_text,
                 enable_visual_scene_description=enable_visual_scene_description,
+                enable_audio_description=enable_audio_description,
                 segmentation_id=segmentation_id,
                 segmentation_config=segmentation_config,
                 thumbnails_config=thumbnails_config,