asteroid-odyssey 1.3.7__py3-none-any.whl → 1.3.9__py3-none-any.whl

asteroid_odyssey/agents_v2_gen/api/{default_api.py → execution_api.py}

@@ -16,22 +16,24 @@ from pydantic import validate_call, Field, StrictFloat, StrictStr, StrictInt
 from typing import Any, Dict, List, Optional, Tuple, Union
 from typing_extensions import Annotated
 
-from pydantic import Field, StrictBytes, StrictInt, StrictStr, field_validator
-from typing import List, Optional, Tuple, Union
+from datetime import datetime
+from pydantic import Field, StrictInt, StrictStr, field_validator
+from typing import List, Optional
 from typing_extensions import Annotated
-from asteroid_odyssey.agents_v2_gen.models.agent_list200_response import AgentList200Response
-from asteroid_odyssey.agents_v2_gen.models.agents_agent_sort_field import AgentsAgentSortField
 from asteroid_odyssey.agents_v2_gen.models.agents_execution_activity import AgentsExecutionActivity
+from asteroid_odyssey.agents_v2_gen.models.agents_execution_list_item import AgentsExecutionListItem
+from asteroid_odyssey.agents_v2_gen.models.agents_execution_sort_field import AgentsExecutionSortField
+from asteroid_odyssey.agents_v2_gen.models.agents_execution_status import AgentsExecutionStatus
 from asteroid_odyssey.agents_v2_gen.models.agents_execution_user_messages_add_text_body import AgentsExecutionUserMessagesAddTextBody
-from asteroid_odyssey.agents_v2_gen.models.agents_files_file import AgentsFilesFile
 from asteroid_odyssey.agents_v2_gen.models.common_sort_direction import CommonSortDirection
+from asteroid_odyssey.agents_v2_gen.models.executions_list200_response import ExecutionsList200Response
 
 from asteroid_odyssey.agents_v2_gen.api_client import ApiClient, RequestSerialized
 from asteroid_odyssey.agents_v2_gen.api_response import ApiResponse
 from asteroid_odyssey.agents_v2_gen.rest import RESTResponseType
 
 
-class DefaultApi:
+class ExecutionApi:
     """NOTE: This class is auto generated by OpenAPI Generator
     Ref: https://openapi-generator.tech
 
@@ -44,351 +46,6 @@ class DefaultApi:
         self.api_client = api_client
 
 
-    @validate_call
-    def agent_list(
-        self,
-        page_size: StrictInt,
-        page: StrictInt,
-        organization_id: Optional[StrictStr] = None,
-        search_name: Optional[StrictStr] = None,
-        sort_field: Optional[AgentsAgentSortField] = None,
-        sort_direction: Optional[CommonSortDirection] = None,
-        _request_timeout: Union[
-            None,
-            Annotated[StrictFloat, Field(gt=0)],
-            Tuple[
-                Annotated[StrictFloat, Field(gt=0)],
-                Annotated[StrictFloat, Field(gt=0)]
-            ]
-        ] = None,
-        _request_auth: Optional[Dict[StrictStr, Any]] = None,
-        _content_type: Optional[StrictStr] = None,
-        _headers: Optional[Dict[StrictStr, Any]] = None,
-        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> AgentList200Response:
-        """agent_list
-
-
-        :param page_size: (required)
-        :type page_size: int
-        :param page: (required)
-        :type page: int
-        :param organization_id:
-        :type organization_id: str
-        :param search_name:
-        :type search_name: str
-        :param sort_field:
-        :type sort_field: AgentsAgentSortField
-        :param sort_direction:
-        :type sort_direction: CommonSortDirection
-        :param _request_timeout: timeout setting for this request. If one
-                                 number provided, it will be total request
-                                 timeout. It can also be a pair (tuple) of
-                                 (connection, read) timeouts.
-        :type _request_timeout: int, tuple(int, int), optional
-        :param _request_auth: set to override the auth_settings for an a single
-                              request; this effectively ignores the
-                              authentication in the spec for a single request.
-        :type _request_auth: dict, optional
-        :param _content_type: force content-type for the request.
-        :type _content_type: str, Optional
-        :param _headers: set to override the headers for a single
-                         request; this effectively ignores the headers
-                         in the spec for a single request.
-        :type _headers: dict, optional
-        :param _host_index: set to override the host_index for a single
-                            request; this effectively ignores the host_index
-                            in the spec for a single request.
-        :type _host_index: int, optional
-        :return: Returns the result object.
-        """ # noqa: E501
-
-        _param = self._agent_list_serialize(
-            page_size=page_size,
-            page=page,
-            organization_id=organization_id,
-            search_name=search_name,
-            sort_field=sort_field,
-            sort_direction=sort_direction,
-            _request_auth=_request_auth,
-            _content_type=_content_type,
-            _headers=_headers,
-            _host_index=_host_index
-        )
-
-        _response_types_map: Dict[str, Optional[str]] = {
-            '200': "AgentList200Response",
-        }
-        response_data = self.api_client.call_api(
-            *_param,
-            _request_timeout=_request_timeout
-        )
-        response_data.read()
-        return self.api_client.response_deserialize(
-            response_data=response_data,
-            response_types_map=_response_types_map,
-        ).data
-
-
-    @validate_call
-    def agent_list_with_http_info(
-        self,
-        page_size: StrictInt,
-        page: StrictInt,
-        organization_id: Optional[StrictStr] = None,
-        search_name: Optional[StrictStr] = None,
-        sort_field: Optional[AgentsAgentSortField] = None,
-        sort_direction: Optional[CommonSortDirection] = None,
-        _request_timeout: Union[
-            None,
-            Annotated[StrictFloat, Field(gt=0)],
-            Tuple[
-                Annotated[StrictFloat, Field(gt=0)],
-                Annotated[StrictFloat, Field(gt=0)]
-            ]
-        ] = None,
-        _request_auth: Optional[Dict[StrictStr, Any]] = None,
-        _content_type: Optional[StrictStr] = None,
-        _headers: Optional[Dict[StrictStr, Any]] = None,
-        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[AgentList200Response]:
-        """agent_list
-
-
-        :param page_size: (required)
-        :type page_size: int
-        :param page: (required)
-        :type page: int
-        :param organization_id:
-        :type organization_id: str
-        :param search_name:
-        :type search_name: str
-        :param sort_field:
-        :type sort_field: AgentsAgentSortField
-        :param sort_direction:
-        :type sort_direction: CommonSortDirection
-        :param _request_timeout: timeout setting for this request. If one
-                                 number provided, it will be total request
-                                 timeout. It can also be a pair (tuple) of
-                                 (connection, read) timeouts.
-        :type _request_timeout: int, tuple(int, int), optional
-        :param _request_auth: set to override the auth_settings for an a single
-                              request; this effectively ignores the
-                              authentication in the spec for a single request.
-        :type _request_auth: dict, optional
-        :param _content_type: force content-type for the request.
-        :type _content_type: str, Optional
-        :param _headers: set to override the headers for a single
-                         request; this effectively ignores the headers
-                         in the spec for a single request.
-        :type _headers: dict, optional
-        :param _host_index: set to override the host_index for a single
-                            request; this effectively ignores the host_index
-                            in the spec for a single request.
-        :type _host_index: int, optional
-        :return: Returns the result object.
-        """ # noqa: E501
-
-        _param = self._agent_list_serialize(
-            page_size=page_size,
-            page=page,
-            organization_id=organization_id,
-            search_name=search_name,
-            sort_field=sort_field,
-            sort_direction=sort_direction,
-            _request_auth=_request_auth,
-            _content_type=_content_type,
-            _headers=_headers,
-            _host_index=_host_index
-        )
-
-        _response_types_map: Dict[str, Optional[str]] = {
-            '200': "AgentList200Response",
-        }
-        response_data = self.api_client.call_api(
-            *_param,
-            _request_timeout=_request_timeout
-        )
-        response_data.read()
-        return self.api_client.response_deserialize(
-            response_data=response_data,
-            response_types_map=_response_types_map,
-        )
-
-
-    @validate_call
-    def agent_list_without_preload_content(
-        self,
-        page_size: StrictInt,
-        page: StrictInt,
-        organization_id: Optional[StrictStr] = None,
-        search_name: Optional[StrictStr] = None,
-        sort_field: Optional[AgentsAgentSortField] = None,
-        sort_direction: Optional[CommonSortDirection] = None,
-        _request_timeout: Union[
-            None,
-            Annotated[StrictFloat, Field(gt=0)],
-            Tuple[
-                Annotated[StrictFloat, Field(gt=0)],
-                Annotated[StrictFloat, Field(gt=0)]
-            ]
-        ] = None,
-        _request_auth: Optional[Dict[StrictStr, Any]] = None,
-        _content_type: Optional[StrictStr] = None,
-        _headers: Optional[Dict[StrictStr, Any]] = None,
-        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> RESTResponseType:
-        """agent_list
-
-
-        :param page_size: (required)
-        :type page_size: int
-        :param page: (required)
-        :type page: int
-        :param organization_id:
-        :type organization_id: str
-        :param search_name:
-        :type search_name: str
-        :param sort_field:
-        :type sort_field: AgentsAgentSortField
-        :param sort_direction:
-        :type sort_direction: CommonSortDirection
-        :param _request_timeout: timeout setting for this request. If one
-                                 number provided, it will be total request
-                                 timeout. It can also be a pair (tuple) of
-                                 (connection, read) timeouts.
-        :type _request_timeout: int, tuple(int, int), optional
-        :param _request_auth: set to override the auth_settings for an a single
-                              request; this effectively ignores the
-                              authentication in the spec for a single request.
-        :type _request_auth: dict, optional
-        :param _content_type: force content-type for the request.
-        :type _content_type: str, Optional
-        :param _headers: set to override the headers for a single
-                         request; this effectively ignores the headers
-                         in the spec for a single request.
-        :type _headers: dict, optional
-        :param _host_index: set to override the host_index for a single
-                            request; this effectively ignores the host_index
-                            in the spec for a single request.
-        :type _host_index: int, optional
-        :return: Returns the result object.
-        """ # noqa: E501
-
-        _param = self._agent_list_serialize(
-            page_size=page_size,
-            page=page,
-            organization_id=organization_id,
-            search_name=search_name,
-            sort_field=sort_field,
-            sort_direction=sort_direction,
-            _request_auth=_request_auth,
-            _content_type=_content_type,
-            _headers=_headers,
-            _host_index=_host_index
-        )
-
-        _response_types_map: Dict[str, Optional[str]] = {
-            '200': "AgentList200Response",
-        }
-        response_data = self.api_client.call_api(
-            *_param,
-            _request_timeout=_request_timeout
-        )
-        return response_data.response
-
-
-    def _agent_list_serialize(
-        self,
-        page_size,
-        page,
-        organization_id,
-        search_name,
-        sort_field,
-        sort_direction,
-        _request_auth,
-        _content_type,
-        _headers,
-        _host_index,
-    ) -> RequestSerialized:
-
-        _host = None
-
-        _collection_formats: Dict[str, str] = {
-        }
-
-        _path_params: Dict[str, str] = {}
-        _query_params: List[Tuple[str, str]] = []
-        _header_params: Dict[str, Optional[str]] = _headers or {}
-        _form_params: List[Tuple[str, str]] = []
-        _files: Dict[
-            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
-        ] = {}
-        _body_params: Optional[bytes] = None
-
-        # process the path parameters
-        # process the query parameters
-        if organization_id is not None:
-            
-            _query_params.append(('organizationId', organization_id))
-            
-        if page_size is not None:
-            
-            _query_params.append(('pageSize', page_size))
-            
-        if page is not None:
-            
-            _query_params.append(('page', page))
-            
-        if search_name is not None:
-            
-            _query_params.append(('searchName', search_name))
-            
-        if sort_field is not None:
-            
-            _query_params.append(('sort_field', sort_field.value))
-            
-        if sort_direction is not None:
-            
-            _query_params.append(('sort_direction', sort_direction.value))
-            
-        # process the header parameters
-        # process the form parameters
-        # process the body parameter
-
-
-        # set the HTTP header `Accept`
-        if 'Accept' not in _header_params:
-            _header_params['Accept'] = self.api_client.select_header_accept(
-                [
-                    'application/json'
-                ]
-            )
-
-
-        # authentication setting
-        _auth_settings: List[str] = [
-            'ApiKeyAuth'
-        ]
-
-        return self.api_client.param_serialize(
-            method='GET',
-            resource_path='/agents',
-            path_params=_path_params,
-            query_params=_query_params,
-            header_params=_header_params,
-            body=_body_params,
-            post_params=_form_params,
-            files=_files,
-            auth_settings=_auth_settings,
-            collection_formats=_collection_formats,
-            _host=_host,
-            _request_auth=_request_auth
-        )
-
-
-
-
     @validate_call
     def execution_activities_get(
         self,
@@ -694,9 +351,9 @@ class DefaultApi:
 
 
     @validate_call
-    def execution_context_files_get(
+    def execution_get(
         self,
-        execution_id: StrictStr,
+        execution_id: Annotated[StrictStr, Field(description="The unique identifier of the execution")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -709,11 +366,12 @@ class DefaultApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> List[AgentsFilesFile]:
-        """execution_context_files_get
+    ) -> AgentsExecutionListItem:
+        """Get execution
 
+        Get a single execution by ID with all details
 
-        :param execution_id: (required)
+        :param execution_id: The unique identifier of the execution (required)
         :type execution_id: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -737,7 +395,7 @@ class DefaultApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._execution_context_files_get_serialize(
+        _param = self._execution_get_serialize(
             execution_id=execution_id,
             _request_auth=_request_auth,
             _content_type=_content_type,
@@ -746,8 +404,10 @@ class DefaultApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "List[AgentsFilesFile]",
-            '404': "str",
+            '200': "AgentsExecutionListItem",
+            '400': "CommonBadRequestErrorBody",
+            '403': "CommonForbiddenErrorBody",
+            '404': "CommonNotFoundErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -761,9 +421,9 @@ class DefaultApi:
 
 
     @validate_call
-    def execution_context_files_get_with_http_info(
+    def execution_get_with_http_info(
         self,
-        execution_id: StrictStr,
+        execution_id: Annotated[StrictStr, Field(description="The unique identifier of the execution")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -776,11 +436,12 @@ class DefaultApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[List[AgentsFilesFile]]:
-        """execution_context_files_get
+    ) -> ApiResponse[AgentsExecutionListItem]:
+        """Get execution
 
+        Get a single execution by ID with all details
 
-        :param execution_id: (required)
+        :param execution_id: The unique identifier of the execution (required)
         :type execution_id: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -804,7 +465,7 @@ class DefaultApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._execution_context_files_get_serialize(
+        _param = self._execution_get_serialize(
             execution_id=execution_id,
             _request_auth=_request_auth,
             _content_type=_content_type,
@@ -813,8 +474,10 @@ class DefaultApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "List[AgentsFilesFile]",
-            '404': "str",
+            '200': "AgentsExecutionListItem",
+            '400': "CommonBadRequestErrorBody",
+            '403': "CommonForbiddenErrorBody",
+            '404': "CommonNotFoundErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -828,9 +491,9 @@ class DefaultApi:
 
 
     @validate_call
-    def execution_context_files_get_without_preload_content(
+    def execution_get_without_preload_content(
         self,
-        execution_id: StrictStr,
+        execution_id: Annotated[StrictStr, Field(description="The unique identifier of the execution")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -844,10 +507,11 @@ class DefaultApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """execution_context_files_get
+        """Get execution
 
+        Get a single execution by ID with all details
 
-        :param execution_id: (required)
+        :param execution_id: The unique identifier of the execution (required)
         :type execution_id: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -871,7 +535,7 @@ class DefaultApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._execution_context_files_get_serialize(
+        _param = self._execution_get_serialize(
             execution_id=execution_id,
             _request_auth=_request_auth,
             _content_type=_content_type,
@@ -880,8 +544,10 @@ class DefaultApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "List[AgentsFilesFile]",
-            '404': "str",
+            '200': "AgentsExecutionListItem",
+            '400': "CommonBadRequestErrorBody",
+            '403': "CommonForbiddenErrorBody",
+            '404': "CommonNotFoundErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -890,7 +556,7 @@ class DefaultApi:
         return response_data.response
 
 
-    def _execution_context_files_get_serialize(
+    def _execution_get_serialize(
         self,
         execution_id,
         _request_auth,
@@ -926,8 +592,7 @@ class DefaultApi:
         if 'Accept' not in _header_params:
             _header_params['Accept'] = self.api_client.select_header_accept(
                 [
-                    'application/json', 
-                    'text/plain'
+                    'application/json'
                 ]
             )
 
@@ -939,7 +604,7 @@ class DefaultApi:
 
         return self.api_client.param_serialize(
             method='GET',
-            resource_path='/executions/{executionId}/context-files',
+            resource_path='/executions/{executionId}',
             path_params=_path_params,
             query_params=_query_params,
             header_params=_header_params,
@@ -956,10 +621,10 @@ class DefaultApi:
 
 
     @validate_call
-    def execution_context_files_upload(
+    def execution_user_messages_add(
         self,
-        execution_id: StrictStr,
-        files: List[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]],
+        execution_id: Annotated[StrictStr, Field(description="The unique identifier of the execution")],
+        agents_execution_user_messages_add_text_body: Annotated[AgentsExecutionUserMessagesAddTextBody, Field(description="The message content to send")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -973,13 +638,14 @@ class DefaultApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> str:
-        """execution_context_files_upload
+        """Send user message to execution
 
+        Add a user message to an execution
 
-        :param execution_id: (required)
+        :param execution_id: The unique identifier of the execution (required)
         :type execution_id: str
-        :param files: (required)
-        :type files: List[bytearray]
+        :param agents_execution_user_messages_add_text_body: The message content to send (required)
+        :type agents_execution_user_messages_add_text_body: AgentsExecutionUserMessagesAddTextBody
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1002,9 +668,9 @@ class DefaultApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._execution_context_files_upload_serialize(
+        _param = self._execution_user_messages_add_serialize(
             execution_id=execution_id,
-            files=files,
+            agents_execution_user_messages_add_text_body=agents_execution_user_messages_add_text_body,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1012,9 +678,10 @@ class DefaultApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "str",
-            '400': "str",
-            '404': "str",
+            '201': "str",
+            '400': "CommonBadRequestErrorBody",
+            '403': "CommonForbiddenErrorBody",
+            '404': "CommonNotFoundErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1028,10 +695,10 @@ class DefaultApi:
 
 
     @validate_call
-    def execution_context_files_upload_with_http_info(
+    def execution_user_messages_add_with_http_info(
         self,
-        execution_id: StrictStr,
-        files: List[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]],
+        execution_id: Annotated[StrictStr, Field(description="The unique identifier of the execution")],
+        agents_execution_user_messages_add_text_body: Annotated[AgentsExecutionUserMessagesAddTextBody, Field(description="The message content to send")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1045,13 +712,14 @@ class DefaultApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[str]:
-        """execution_context_files_upload
+        """Send user message to execution
 
+        Add a user message to an execution
 
-        :param execution_id: (required)
+        :param execution_id: The unique identifier of the execution (required)
         :type execution_id: str
-        :param files: (required)
-        :type files: List[bytearray]
+        :param agents_execution_user_messages_add_text_body: The message content to send (required)
+        :type agents_execution_user_messages_add_text_body: AgentsExecutionUserMessagesAddTextBody
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1074,9 +742,9 @@ class DefaultApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._execution_context_files_upload_serialize(
+        _param = self._execution_user_messages_add_serialize(
             execution_id=execution_id,
-            files=files,
+            agents_execution_user_messages_add_text_body=agents_execution_user_messages_add_text_body,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1084,9 +752,10 @@ class DefaultApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "str",
-            '400': "str",
-            '404': "str",
+            '201': "str",
+            '400': "CommonBadRequestErrorBody",
+            '403': "CommonForbiddenErrorBody",
+            '404': "CommonNotFoundErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1100,10 +769,10 @@ class DefaultApi:
 
 
     @validate_call
-    def execution_context_files_upload_without_preload_content(
+    def execution_user_messages_add_without_preload_content(
         self,
-        execution_id: StrictStr,
-        files: List[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]],
+        execution_id: Annotated[StrictStr, Field(description="The unique identifier of the execution")],
+        agents_execution_user_messages_add_text_body: Annotated[AgentsExecutionUserMessagesAddTextBody, Field(description="The message content to send")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1117,13 +786,14 @@ class DefaultApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """execution_context_files_upload
+        """Send user message to execution
 
+        Add a user message to an execution
 
-        :param execution_id: (required)
+        :param execution_id: The unique identifier of the execution (required)
         :type execution_id: str
-        :param files: (required)
-        :type files: List[bytearray]
+        :param agents_execution_user_messages_add_text_body: The message content to send (required)
+        :type agents_execution_user_messages_add_text_body: AgentsExecutionUserMessagesAddTextBody
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1146,9 +816,9 @@ class DefaultApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._execution_context_files_upload_serialize(
+        _param = self._execution_user_messages_add_serialize(
             execution_id=execution_id,
-            files=files,
+            agents_execution_user_messages_add_text_body=agents_execution_user_messages_add_text_body,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1156,9 +826,10 @@ class DefaultApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '200': "str",
-            '400': "str",
-            '404': "str",
+            '201': "str",
+            '400': "CommonBadRequestErrorBody",
+            '403': "CommonForbiddenErrorBody",
+            '404': "CommonNotFoundErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1167,10 +838,10 @@ class DefaultApi:
         return response_data.response
 
 
-    def _execution_context_files_upload_serialize(
+    def _execution_user_messages_add_serialize(
         self,
         execution_id,
-        files,
+        agents_execution_user_messages_add_text_body,
         _request_auth,
         _content_type,
         _headers,
@@ -1180,7 +851,6 @@ class DefaultApi:
         _host = None
 
         _collection_formats: Dict[str, str] = {
-            'files': 'multi',
         }
 
         _path_params: Dict[str, str] = {}
@@ -1198,16 +868,17 @@ class DefaultApi:
         # process the query parameters
         # process the header parameters
         # process the form parameters
-        if files is not None:
-            _files['files'] = files
         # process the body parameter
+        if agents_execution_user_messages_add_text_body is not None:
+            _body_params = agents_execution_user_messages_add_text_body
 
 
         # set the HTTP header `Accept`
         if 'Accept' not in _header_params:
             _header_params['Accept'] = self.api_client.select_header_accept(
                 [
-                    'text/plain'
+                    'text/plain', 
+                    'application/json'
                 ]
             )
 
@@ -1218,7 +889,7 @@ class DefaultApi:
             _default_content_type = (
                 self.api_client.select_header_content_type(
                     [
-                        'multipart/form-data'
+                        'application/json'
                     ]
                 )
             )
@@ -1232,7 +903,7 @@ class DefaultApi:
 
         return self.api_client.param_serialize(
             method='POST',
-            resource_path='/executions/{executionId}/context-files',
+            resource_path='/executions/{executionId}/user-messages',
             path_params=_path_params,
             query_params=_query_params,
             header_params=_header_params,
@@ -1249,10 +920,23 @@ class DefaultApi:
 
 
     @validate_call
-    def execution_user_messages_add(
+    def executions_list(
         self,
-        execution_id: Annotated[StrictStr, Field(description="The unique identifier of the execution")],
-        agents_execution_user_messages_add_text_body: Annotated[AgentsExecutionUserMessagesAddTextBody, Field(description="The message content to send")],
+        page_size: StrictInt,
+        page: StrictInt,
+        organization_id: Annotated[Optional[StrictStr], Field(description="Optional organization ID filter (required for customer queries)")] = None,
+        execution_id: Annotated[Optional[StrictStr], Field(description="Search by execution ID (partial, case-insensitive match)")] = None,
+        agent_id: Annotated[Optional[StrictStr], Field(description="Filter by agent ID")] = None,
+        status: Annotated[Optional[List[AgentsExecutionStatus]], Field(description="Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)")] = None,
+        agent_version: Annotated[Optional[StrictInt], Field(description="Filter by agent version")] = None,
+        created_after: Annotated[Optional[datetime], Field(description="Filter executions created after this timestamp")] = None,
+        created_before: Annotated[Optional[datetime], Field(description="Filter executions created before this timestamp")] = None,
+        human_labels: Annotated[Optional[List[StrictStr]], Field(description="Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)")] = None,
+        outcome_label: Annotated[Optional[StrictStr], Field(description="Filter by execution result outcome (partial, case-insensitive match)")] = None,
+        metadata_key: Annotated[Optional[StrictStr], Field(description="Filter by metadata key - must be used together with metadataValue")] = None,
+        metadata_value: Annotated[Optional[StrictStr], Field(description="Filter by metadata value - must be used together with metadataKey")] = None,
+        sort_field: Optional[AgentsExecutionSortField] = None,
+        sort_direction: Optional[CommonSortDirection] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1265,15 +949,41 @@ class DefaultApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> str:
-        """Send user message to execution
+    ) -> ExecutionsList200Response:
+        """List executions
 
-        Add a user message to an execution
+        List executions with filtering and pagination
 
-        :param execution_id: The unique identifier of the execution (required)
+        :param page_size: (required)
+        :type page_size: int
+        :param page: (required)
+        :type page: int
+        :param organization_id: Optional organization ID filter (required for customer queries)
+        :type organization_id: str
+        :param execution_id: Search by execution ID (partial, case-insensitive match)
         :type execution_id: str
-        :param agents_execution_user_messages_add_text_body: The message content to send (required)
-        :type agents_execution_user_messages_add_text_body: AgentsExecutionUserMessagesAddTextBody
+        :param agent_id: Filter by agent ID
+        :type agent_id: str
+        :param status: Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)
+        :type status: List[AgentsExecutionStatus]
+        :param agent_version: Filter by agent version
+        :type agent_version: int
+        :param created_after: Filter executions created after this timestamp
+        :type created_after: datetime
+        :param created_before: Filter executions created before this timestamp
+        :type created_before: datetime
+        :param human_labels: Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)
+        :type human_labels: List[str]
+        :param outcome_label: Filter by execution result outcome (partial, case-insensitive match)
+        :type outcome_label: str
+        :param metadata_key: Filter by metadata key - must be used together with metadataValue
+        :type metadata_key: str
+        :param metadata_value: Filter by metadata value - must be used together with metadataKey
+        :type metadata_value: str
+        :param sort_field:
+        :type sort_field: AgentsExecutionSortField
+        :param sort_direction:
+        :type sort_direction: CommonSortDirection
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1296,9 +1006,22 @@ class DefaultApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._execution_user_messages_add_serialize(
+        _param = self._executions_list_serialize(
+            page_size=page_size,
+            page=page,
+            organization_id=organization_id,
             execution_id=execution_id,
-            agents_execution_user_messages_add_text_body=agents_execution_user_messages_add_text_body,
+            agent_id=agent_id,
+            status=status,
+            agent_version=agent_version,
+            created_after=created_after,
+            created_before=created_before,
+            human_labels=human_labels,
+            outcome_label=outcome_label,
+            metadata_key=metadata_key,
+            metadata_value=metadata_value,
+            sort_field=sort_field,
+            sort_direction=sort_direction,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1306,7 +1029,7 @@ class DefaultApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '201': "str",
+            '200': "ExecutionsList200Response",
             '400': "CommonBadRequestErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
@@ -1323,10 +1046,23 @@ class DefaultApi:
 
 
     @validate_call
-    def execution_user_messages_add_with_http_info(
+    def executions_list_with_http_info(
         self,
-        execution_id: Annotated[StrictStr, Field(description="The unique identifier of the execution")],
-        agents_execution_user_messages_add_text_body: Annotated[AgentsExecutionUserMessagesAddTextBody, Field(description="The message content to send")],
+        page_size: StrictInt,
+        page: StrictInt,
+        organization_id: Annotated[Optional[StrictStr], Field(description="Optional organization ID filter (required for customer queries)")] = None,
+        execution_id: Annotated[Optional[StrictStr], Field(description="Search by execution ID (partial, case-insensitive match)")] = None,
+        agent_id: Annotated[Optional[StrictStr], Field(description="Filter by agent ID")] = None,
+        status: Annotated[Optional[List[AgentsExecutionStatus]], Field(description="Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)")] = None,
+        agent_version: Annotated[Optional[StrictInt], Field(description="Filter by agent version")] = None,
+        created_after: Annotated[Optional[datetime], Field(description="Filter executions created after this timestamp")] = None,
+        created_before: Annotated[Optional[datetime], Field(description="Filter executions created before this timestamp")] = None,
+        human_labels: Annotated[Optional[List[StrictStr]], Field(description="Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)")] = None,
+        outcome_label: Annotated[Optional[StrictStr], Field(description="Filter by execution result outcome (partial, case-insensitive match)")] = None,
+        metadata_key: Annotated[Optional[StrictStr], Field(description="Filter by metadata key - must be used together with metadataValue")] = None,
+        metadata_value: Annotated[Optional[StrictStr], Field(description="Filter by metadata value - must be used together with metadataKey")] = None,
+        sort_field: Optional[AgentsExecutionSortField] = None,
+        sort_direction: Optional[CommonSortDirection] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1339,15 +1075,41 @@ class DefaultApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[str]:
-        """Send user message to execution
+    ) -> ApiResponse[ExecutionsList200Response]:
+        """List executions
 
-        Add a user message to an execution
+        List executions with filtering and pagination
 
-        :param execution_id: The unique identifier of the execution (required)
+        :param page_size: (required)
+        :type page_size: int
+        :param page: (required)
+        :type page: int
+        :param organization_id: Optional organization ID filter (required for customer queries)
+        :type organization_id: str
+        :param execution_id: Search by execution ID (partial, case-insensitive match)
         :type execution_id: str
-        :param agents_execution_user_messages_add_text_body: The message content to send (required)
-        :type agents_execution_user_messages_add_text_body: AgentsExecutionUserMessagesAddTextBody
+        :param agent_id: Filter by agent ID
+        :type agent_id: str
+        :param status: Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)
+        :type status: List[AgentsExecutionStatus]
+        :param agent_version: Filter by agent version
+        :type agent_version: int
+        :param created_after: Filter executions created after this timestamp
+        :type created_after: datetime
+        :param created_before: Filter executions created before this timestamp
+        :type created_before: datetime
+        :param human_labels: Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)
+        :type human_labels: List[str]
+        :param outcome_label: Filter by execution result outcome (partial, case-insensitive match)
+        :type outcome_label: str
+        :param metadata_key: Filter by metadata key - must be used together with metadataValue
+        :type metadata_key: str
+        :param metadata_value: Filter by metadata value - must be used together with metadataKey
+        :type metadata_value: str
+        :param sort_field:
+        :type sort_field: AgentsExecutionSortField
+        :param sort_direction:
+        :type sort_direction: CommonSortDirection
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1370,9 +1132,22 @@ class DefaultApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._execution_user_messages_add_serialize(
+        _param = self._executions_list_serialize(
+            page_size=page_size,
+            page=page,
+            organization_id=organization_id,
             execution_id=execution_id,
-            agents_execution_user_messages_add_text_body=agents_execution_user_messages_add_text_body,
+            agent_id=agent_id,
+            status=status,
+            agent_version=agent_version,
+            created_after=created_after,
+            created_before=created_before,
+            human_labels=human_labels,
+            outcome_label=outcome_label,
+            metadata_key=metadata_key,
+            metadata_value=metadata_value,
+            sort_field=sort_field,
+            sort_direction=sort_direction,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1380,7 +1155,7 @@ class DefaultApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '201': "str",
+            '200': "ExecutionsList200Response",
             '400': "CommonBadRequestErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
@@ -1397,10 +1172,23 @@ class DefaultApi:
 
 
     @validate_call
-    def execution_user_messages_add_without_preload_content(
+    def executions_list_without_preload_content(
         self,
-        execution_id: Annotated[StrictStr, Field(description="The unique identifier of the execution")],
-        agents_execution_user_messages_add_text_body: Annotated[AgentsExecutionUserMessagesAddTextBody, Field(description="The message content to send")],
+        page_size: StrictInt,
+        page: StrictInt,
+        organization_id: Annotated[Optional[StrictStr], Field(description="Optional organization ID filter (required for customer queries)")] = None,
+        execution_id: Annotated[Optional[StrictStr], Field(description="Search by execution ID (partial, case-insensitive match)")] = None,
+        agent_id: Annotated[Optional[StrictStr], Field(description="Filter by agent ID")] = None,
+        status: Annotated[Optional[List[AgentsExecutionStatus]], Field(description="Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)")] = None,
+        agent_version: Annotated[Optional[StrictInt], Field(description="Filter by agent version")] = None,
+        created_after: Annotated[Optional[datetime], Field(description="Filter executions created after this timestamp")] = None,
+        created_before: Annotated[Optional[datetime], Field(description="Filter executions created before this timestamp")] = None,
+        human_labels: Annotated[Optional[List[StrictStr]], Field(description="Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)")] = None,
+        outcome_label: Annotated[Optional[StrictStr], Field(description="Filter by execution result outcome (partial, case-insensitive match)")] = None,
+        metadata_key: Annotated[Optional[StrictStr], Field(description="Filter by metadata key - must be used together with metadataValue")] = None,
+        metadata_value: Annotated[Optional[StrictStr], Field(description="Filter by metadata value - must be used together with metadataKey")] = None,
+        sort_field: Optional[AgentsExecutionSortField] = None,
+        sort_direction: Optional[CommonSortDirection] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1414,14 +1202,40 @@ class DefaultApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Send user message to execution
+        """List executions
 
-        Add a user message to an execution
+        List executions with filtering and pagination
 
-        :param execution_id: The unique identifier of the execution (required)
+        :param page_size: (required)
+        :type page_size: int
+        :param page: (required)
+        :type page: int
+        :param organization_id: Optional organization ID filter (required for customer queries)
+        :type organization_id: str
+        :param execution_id: Search by execution ID (partial, case-insensitive match)
         :type execution_id: str
-        :param agents_execution_user_messages_add_text_body: The message content to send (required)
-        :type agents_execution_user_messages_add_text_body: AgentsExecutionUserMessagesAddTextBody
+        :param agent_id: Filter by agent ID
+        :type agent_id: str
+        :param status: Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)
+        :type status: List[AgentsExecutionStatus]
+        :param agent_version: Filter by agent version
+        :type agent_version: int
+        :param created_after: Filter executions created after this timestamp
+        :type created_after: datetime
+        :param created_before: Filter executions created before this timestamp
+        :type created_before: datetime
+        :param human_labels: Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)
+        :type human_labels: List[str]
+        :param outcome_label: Filter by execution result outcome (partial, case-insensitive match)
+        :type outcome_label: str
+        :param metadata_key: Filter by metadata key - must be used together with metadataValue
+        :type metadata_key: str
+        :param metadata_value: Filter by metadata value - must be used together with metadataKey
+        :type metadata_value: str
+        :param sort_field:
+        :type sort_field: AgentsExecutionSortField
+        :param sort_direction:
+        :type sort_direction: CommonSortDirection
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1444,9 +1258,22 @@ class DefaultApi:
         :return: Returns the result object.
         """ # noqa: E501
 
-        _param = self._execution_user_messages_add_serialize(
+        _param = self._executions_list_serialize(
+            page_size=page_size,
+            page=page,
+            organization_id=organization_id,
             execution_id=execution_id,
-            agents_execution_user_messages_add_text_body=agents_execution_user_messages_add_text_body,
+            agent_id=agent_id,
+            status=status,
+            agent_version=agent_version,
+            created_after=created_after,
+            created_before=created_before,
+            human_labels=human_labels,
+            outcome_label=outcome_label,
+            metadata_key=metadata_key,
+            metadata_value=metadata_value,
+            sort_field=sort_field,
+            sort_direction=sort_direction,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1454,7 +1281,7 @@ class DefaultApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            '201': "str",
+            '200': "ExecutionsList200Response",
             '400': "CommonBadRequestErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
@@ -1466,10 +1293,23 @@ class DefaultApi:
         return response_data.response
 
 
-    def _execution_user_messages_add_serialize(
+    def _executions_list_serialize(
         self,
+        page_size,
+        page,
+        organization_id,
         execution_id,
-        agents_execution_user_messages_add_text_body,
+        agent_id,
+        status,
+        agent_version,
+        created_after,
+        created_before,
+        human_labels,
+        outcome_label,
+        metadata_key,
+        metadata_value,
+        sort_field,
+        sort_direction,
         _request_auth,
         _content_type,
         _headers,
@@ -1479,6 +1319,8 @@ class DefaultApi:
         _host = None
 
         _collection_formats: Dict[str, str] = {
+            'status': 'multi',
+            'humanLabels': 'multi',
         }
 
         _path_params: Dict[str, str] = {}
@@ -1491,38 +1333,98 @@ class DefaultApi:
         _body_params: Optional[bytes] = None
 
         # process the path parameters
-        if execution_id is not None:
-            _path_params['executionId'] = execution_id
         # process the query parameters
+        if organization_id is not None:
+            
+            _query_params.append(('organizationId', organization_id))
+            
+        if page_size is not None:
+            
+            _query_params.append(('pageSize', page_size))
+            
+        if page is not None:
+            
+            _query_params.append(('page', page))
+            
+        if execution_id is not None:
+            
+            _query_params.append(('executionId', execution_id))
+            
+        if agent_id is not None:
+            
+            _query_params.append(('agentId', agent_id))
+            
+        if status is not None:
+            
+            _query_params.append(('status', status))
+            
+        if agent_version is not None:
+            
+            _query_params.append(('agentVersion', agent_version))
+            
+        if created_after is not None:
+            if isinstance(created_after, datetime):
+                _query_params.append(
+                    (
+                        'createdAfter',
+                        created_after.strftime(
+                            self.api_client.configuration.datetime_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('createdAfter', created_after))
+            
+        if created_before is not None:
+            if isinstance(created_before, datetime):
+                _query_params.append(
+                    (
+                        'createdBefore',
+                        created_before.strftime(
+                            self.api_client.configuration.datetime_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('createdBefore', created_before))
+            
+        if human_labels is not None:
+            
+            _query_params.append(('humanLabels', human_labels))
+            
+        if outcome_label is not None:
+            
+            _query_params.append(('outcomeLabel', outcome_label))
+            
+        if metadata_key is not None:
+            
+            _query_params.append(('metadataKey', metadata_key))
+            
+        if metadata_value is not None:
+            
+            _query_params.append(('metadataValue', metadata_value))
+            
+        if sort_field is not None:
+            
+            _query_params.append(('sortField', sort_field.value))
+            
+        if sort_direction is not None:
+            
+            _query_params.append(('sortDirection', sort_direction.value))
+            
         # process the header parameters
         # process the form parameters
         # process the body parameter
-        if agents_execution_user_messages_add_text_body is not None:
-            _body_params = agents_execution_user_messages_add_text_body
 
 
         # set the HTTP header `Accept`
         if 'Accept' not in _header_params:
             _header_params['Accept'] = self.api_client.select_header_accept(
                 [
-                    'text/plain', 
                     'application/json'
                 ]
             )
 
-        # set the HTTP header `Content-Type`
-        if _content_type:
-            _header_params['Content-Type'] = _content_type
-        else:
-            _default_content_type = (
-                self.api_client.select_header_content_type(
-                    [
-                        'application/json'
-                    ]
-                )
-            )
-            if _default_content_type is not None:
-                _header_params['Content-Type'] = _default_content_type
 
         # authentication setting
         _auth_settings: List[str] = [
@@ -1530,8 +1432,8 @@ class DefaultApi:
         ]
 
         return self.api_client.param_serialize(
-            method='POST',
-            resource_path='/executions/{executionId}/user-messages',
+            method='GET',
+            resource_path='/executions',
             path_params=_path_params,
             query_params=_query_params,
             header_params=_header_params,