letta-client 0.1.318__py3-none-any.whl → 0.1.320__py3-none-any.whl

letta_client/providers/raw_client.py

@@ -13,6 +13,7 @@ from ..errors.unprocessable_entity_error import UnprocessableEntityError
 from ..types.http_validation_error import HttpValidationError
 from ..types.provider import Provider
 from ..types.provider_type import ProviderType
+from .types.providers_list_request_order import ProvidersListRequestOrder
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -25,24 +26,40 @@ class RawProvidersClient:
     def list(
         self,
         *,
-        name: typing.Optional[str] = None,
-        provider_type: typing.Optional[ProviderType] = None,
+        before: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        order: typing.Optional[ProvidersListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        name: typing.Optional[str] = None,
+        provider_type: typing.Optional[ProviderType] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[typing.List[Provider]]:
         """
-        Get a list of all custom providers in the database
+        Get a list of all custom providers.
 
         Parameters
         ----------
-        name : typing.Optional[str]
-
-        provider_type : typing.Optional[ProviderType]
+        before : typing.Optional[str]
+            Provider ID cursor for pagination. Returns providers that come before this provider ID in the specified sort order
 
         after : typing.Optional[str]
+            Provider ID cursor for pagination. Returns providers that come after this provider ID in the specified sort order
 
         limit : typing.Optional[int]
+            Maximum number of providers to return
+
+        order : typing.Optional[ProvidersListRequestOrder]
+            Sort order for providers by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        name : typing.Optional[str]
+            Filter providers by name
+
+        provider_type : typing.Optional[ProviderType]
+            Filter providers by type
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -56,10 +73,13 @@ class RawProvidersClient:
             "v1/providers/",
             method="GET",
             params={
-                "name": name,
-                "provider_type": provider_type,
+                "before": before,
                 "after": after,
                 "limit": limit,
+                "order": order,
+                "order_by": order_by,
+                "name": name,
+                "provider_type": provider_type,
             },
             request_options=request_options,
         )
@@ -102,7 +122,7 @@ class RawProvidersClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[Provider]:
         """
-        Create a new custom provider
+        Create a new custom provider.
 
         Parameters
         ----------
@@ -179,11 +199,60 @@ class RawProvidersClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    def retrieve_provider(
+        self, provider_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[Provider]:
+        """
+        Get a provider by ID.
+
+        Parameters
+        ----------
+        provider_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[Provider]
+            Successful Response
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/providers/{jsonable_encoder(provider_id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Provider,
+                    construct_type(
+                        type_=Provider,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     def delete(
         self, provider_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[typing.Optional[typing.Any]]:
         """
-        Delete an existing custom provider
+        Delete an existing custom provider.
 
         Parameters
         ----------
@@ -242,7 +311,7 @@ class RawProvidersClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[Provider]:
         """
-        Update an existing custom provider
+        Update an existing custom provider.
 
         Parameters
         ----------
@@ -313,31 +382,7 @@ class RawProvidersClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
-    def check(self, *, request_options: typing.Optional[RequestOptions] = None) -> HttpResponse[None]:
-        """
-        Parameters
-        ----------
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        HttpResponse[None]
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/providers/check",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return HttpResponse(response=_response, data=None)
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
-        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
-
-    def check_provider(
+    def check(
         self,
         *,
         provider_type: ProviderType,
@@ -349,6 +394,8 @@ class RawProvidersClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[typing.Optional[typing.Any]]:
         """
+        Verify the API key and additional parameters for a provider.
+
         Parameters
         ----------
         provider_type : ProviderType
@@ -430,24 +477,40 @@ class AsyncRawProvidersClient:
     async def list(
         self,
         *,
-        name: typing.Optional[str] = None,
-        provider_type: typing.Optional[ProviderType] = None,
+        before: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        order: typing.Optional[ProvidersListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        name: typing.Optional[str] = None,
+        provider_type: typing.Optional[ProviderType] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[typing.List[Provider]]:
         """
-        Get a list of all custom providers in the database
+        Get a list of all custom providers.
 
         Parameters
         ----------
-        name : typing.Optional[str]
-
-        provider_type : typing.Optional[ProviderType]
+        before : typing.Optional[str]
+            Provider ID cursor for pagination. Returns providers that come before this provider ID in the specified sort order
 
         after : typing.Optional[str]
+            Provider ID cursor for pagination. Returns providers that come after this provider ID in the specified sort order
 
         limit : typing.Optional[int]
+            Maximum number of providers to return
+
+        order : typing.Optional[ProvidersListRequestOrder]
+            Sort order for providers by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        name : typing.Optional[str]
+            Filter providers by name
+
+        provider_type : typing.Optional[ProviderType]
+            Filter providers by type
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -461,10 +524,13 @@ class AsyncRawProvidersClient:
             "v1/providers/",
             method="GET",
             params={
-                "name": name,
-                "provider_type": provider_type,
+                "before": before,
                 "after": after,
                 "limit": limit,
+                "order": order,
+                "order_by": order_by,
+                "name": name,
+                "provider_type": provider_type,
             },
             request_options=request_options,
         )
@@ -507,7 +573,7 @@ class AsyncRawProvidersClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[Provider]:
         """
-        Create a new custom provider
+        Create a new custom provider.
 
         Parameters
         ----------
@@ -584,11 +650,60 @@ class AsyncRawProvidersClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    async def retrieve_provider(
+        self, provider_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[Provider]:
+        """
+        Get a provider by ID.
+
+        Parameters
+        ----------
+        provider_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[Provider]
+            Successful Response
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/providers/{jsonable_encoder(provider_id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Provider,
+                    construct_type(
+                        type_=Provider,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     async def delete(
         self, provider_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[typing.Optional[typing.Any]]:
         """
-        Delete an existing custom provider
+        Delete an existing custom provider.
 
         Parameters
         ----------
@@ -647,7 +762,7 @@ class AsyncRawProvidersClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[Provider]:
         """
-        Update an existing custom provider
+        Update an existing custom provider.
 
         Parameters
         ----------
@@ -718,31 +833,7 @@ class AsyncRawProvidersClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
-    async def check(self, *, request_options: typing.Optional[RequestOptions] = None) -> AsyncHttpResponse[None]:
-        """
-        Parameters
-        ----------
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        AsyncHttpResponse[None]
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/providers/check",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return AsyncHttpResponse(response=_response, data=None)
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
-        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
-
-    async def check_provider(
+    async def check(
         self,
         *,
         provider_type: ProviderType,
@@ -754,6 +845,8 @@ class AsyncRawProvidersClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[typing.Optional[typing.Any]]:
         """
+        Verify the API key and additional parameters for a provider.
+
         Parameters
         ----------
         provider_type : ProviderType

letta_client/providers/types/__init__.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+from .providers_list_request_order import ProvidersListRequestOrder
+
+__all__ = ["ProvidersListRequestOrder"]

letta_client/providers/types/providers_list_request_order.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+ProvidersListRequestOrder = typing.Union[typing.Literal["asc", "desc"], typing.Any]

letta_client/runs/__init__.py

@@ -4,5 +4,6 @@
 
 from .types import LettaStreamingResponse
 from . import messages, steps, usage
+from .messages import MessagesListRequestOrder
 
-__all__ = ["LettaStreamingResponse", "messages", "steps", "usage"]
+__all__ = ["LettaStreamingResponse", "MessagesListRequestOrder", "messages", "steps", "usage"]

letta_client/runs/client.py

@@ -5,6 +5,7 @@ import typing
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
 from ..types.run import Run
+from ..types.stop_reason_type import StopReasonType
 from .messages.client import AsyncMessagesClient, MessagesClient
 from .raw_client import AsyncRawRunsClient, RawRunsClient
 from .steps.client import AsyncStepsClient, StepsClient
@@ -40,9 +41,11 @@ class RunsClient:
         *,
         agent_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         background: typing.Optional[bool] = None,
+        stop_reason: typing.Optional[StopReasonType] = None,
         after: typing.Optional[str] = None,
         before: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        active: typing.Optional[bool] = None,
         ascending: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Run]:
@@ -57,6 +60,9 @@ class RunsClient:
         background : typing.Optional[bool]
             If True, filters for runs that were created in background mode.
 
+        stop_reason : typing.Optional[StopReasonType]
+            Filter runs by stop reason.
+
         after : typing.Optional[str]
             Cursor for pagination
 
@@ -66,6 +72,9 @@ class RunsClient:
         limit : typing.Optional[int]
             Maximum number of runs to return
 
+        active : typing.Optional[bool]
+            Filter for active runs.
+
         ascending : typing.Optional[bool]
             Whether to sort agents oldest to newest (True) or newest to oldest (False, default)
 
@@ -90,9 +99,11 @@ class RunsClient:
         _response = self._raw_client.list(
             agent_ids=agent_ids,
             background=background,
+            stop_reason=stop_reason,
             after=after,
             before=before,
             limit=limit,
+            active=active,
             ascending=ascending,
             request_options=request_options,
         )
@@ -286,9 +297,11 @@ class AsyncRunsClient:
         *,
         agent_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         background: typing.Optional[bool] = None,
+        stop_reason: typing.Optional[StopReasonType] = None,
         after: typing.Optional[str] = None,
         before: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        active: typing.Optional[bool] = None,
         ascending: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Run]:
@@ -303,6 +316,9 @@ class AsyncRunsClient:
         background : typing.Optional[bool]
             If True, filters for runs that were created in background mode.
 
+        stop_reason : typing.Optional[StopReasonType]
+            Filter runs by stop reason.
+
         after : typing.Optional[str]
             Cursor for pagination
 
@@ -312,6 +328,9 @@ class AsyncRunsClient:
         limit : typing.Optional[int]
             Maximum number of runs to return
 
+        active : typing.Optional[bool]
+            Filter for active runs.
+
         ascending : typing.Optional[bool]
             Whether to sort agents oldest to newest (True) or newest to oldest (False, default)
 
@@ -344,9 +363,11 @@ class AsyncRunsClient:
         _response = await self._raw_client.list(
             agent_ids=agent_ids,
             background=background,
+            stop_reason=stop_reason,
             after=after,
             before=before,
             limit=limit,
+            active=active,
             ascending=ascending,
             request_options=request_options,
         )

letta_client/runs/messages/__init__.py

@@ -2,3 +2,6 @@
 
 # isort: skip_file
 
+from .types import MessagesListRequestOrder
+
+__all__ = ["MessagesListRequestOrder"]

letta_client/runs/messages/client.py

@@ -5,8 +5,8 @@ import typing
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
 from ...types.letta_message_union import LettaMessageUnion
-from ...types.message_role import MessageRole
 from .raw_client import AsyncRawMessagesClient, RawMessagesClient
+from .types.messages_list_request_order import MessagesListRequestOrder
 
 
 class MessagesClient:
@@ -31,44 +31,27 @@ class MessagesClient:
         before: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
-        order: typing.Optional[str] = None,
-        role: typing.Optional[MessageRole] = None,
+        order: typing.Optional[MessagesListRequestOrder] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[LettaMessageUnion]:
         """
-        Get messages associated with a run with filtering options.
-
-        Args:
-            run_id: ID of the run
-            before: A cursor for use in pagination. `before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.
-            after: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
-            limit: Maximum number of messages to return
-            order: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
-            role: Filter by role (user/assistant/system/tool)
-            return_message_object: Whether to return Message objects or LettaMessage objects
-            user_id: ID of the user making the request
-
-        Returns:
-            A list of messages associated with the run. Default is List[LettaMessage].
+        Get response messages associated with a run.
 
         Parameters
         ----------
         run_id : str
 
         before : typing.Optional[str]
-            Cursor for pagination
+            Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
 
         after : typing.Optional[str]
-            Cursor for pagination
+            Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order
 
         limit : typing.Optional[int]
             Maximum number of messages to return
 
-        order : typing.Optional[str]
-            Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
-
-        role : typing.Optional[MessageRole]
-            Filter by role
+        order : typing.Optional[MessagesListRequestOrder]
+            Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -91,7 +74,7 @@ class MessagesClient:
         )
         """
         _response = self._raw_client.list(
-            run_id, before=before, after=after, limit=limit, order=order, role=role, request_options=request_options
+            run_id, before=before, after=after, limit=limit, order=order, request_options=request_options
         )
         return _response.data
 
@@ -118,44 +101,27 @@ class AsyncMessagesClient:
         before: typing.Optional[str] = None,
         after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
-        order: typing.Optional[str] = None,
-        role: typing.Optional[MessageRole] = None,
+        order: typing.Optional[MessagesListRequestOrder] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[LettaMessageUnion]:
         """
-        Get messages associated with a run with filtering options.
-
-        Args:
-            run_id: ID of the run
-            before: A cursor for use in pagination. `before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.
-            after: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
-            limit: Maximum number of messages to return
-            order: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
-            role: Filter by role (user/assistant/system/tool)
-            return_message_object: Whether to return Message objects or LettaMessage objects
-            user_id: ID of the user making the request
-
-        Returns:
-            A list of messages associated with the run. Default is List[LettaMessage].
+        Get response messages associated with a run.
 
         Parameters
         ----------
         run_id : str
 
         before : typing.Optional[str]
-            Cursor for pagination
+            Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
 
         after : typing.Optional[str]
-            Cursor for pagination
+            Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order
 
         limit : typing.Optional[int]
             Maximum number of messages to return
 
-        order : typing.Optional[str]
-            Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
-
-        role : typing.Optional[MessageRole]
-            Filter by role
+        order : typing.Optional[MessagesListRequestOrder]
+            Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -186,6 +152,6 @@ class AsyncMessagesClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.list(
-            run_id, before=before, after=after, limit=limit, order=order, role=role, request_options=request_options
+            run_id, before=before, after=after, limit=limit, order=order, request_options=request_options
         )
         return _response.data