letta-client 0.1.319__py3-none-any.whl → 0.1.321__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
@@ -38,11 +39,14 @@ class RunsClient:
     def list(
         self,
         *,
+        agent_id: typing.Optional[str] = None,
         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]:
@@ -51,12 +55,18 @@ class RunsClient:
 
         Parameters
         ----------
-        agent_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+        agent_id : typing.Optional[str]
             The unique identifier of the agent associated with the run.
 
+        agent_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            (DEPRECATED) The unique identifiers of the agents associated with the run.
+
         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 +76,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)
 
@@ -88,11 +101,14 @@ class RunsClient:
         client.runs.list()
         """
         _response = self._raw_client.list(
+            agent_id=agent_id,
             agent_ids=agent_ids,
             background=background,
+            stop_reason=stop_reason,
             after=after,
             before=before,
             limit=limit,
+            active=active,
             ascending=ascending,
             request_options=request_options,
         )
@@ -101,7 +117,7 @@ class RunsClient:
     def list_active(
         self,
         *,
-        agent_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        agent_id: typing.Optional[str] = None,
         background: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Run]:
@@ -110,7 +126,7 @@ class RunsClient:
 
         Parameters
         ----------
-        agent_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+        agent_id : typing.Optional[str]
             The unique identifier of the agent associated with the run.
 
         background : typing.Optional[bool]
@@ -135,7 +151,7 @@ class RunsClient:
         client.runs.list_active()
         """
         _response = self._raw_client.list_active(
-            agent_ids=agent_ids, background=background, request_options=request_options
+            agent_id=agent_id, background=background, request_options=request_options
         )
         return _response.data
 
@@ -284,11 +300,14 @@ class AsyncRunsClient:
     async def list(
         self,
         *,
+        agent_id: typing.Optional[str] = None,
         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]:
@@ -297,12 +316,18 @@ class AsyncRunsClient:
 
         Parameters
         ----------
-        agent_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+        agent_id : typing.Optional[str]
             The unique identifier of the agent associated with the run.
 
+        agent_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            (DEPRECATED) The unique identifiers of the agents associated with the run.
+
         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 +337,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)
 
@@ -342,11 +370,14 @@ class AsyncRunsClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.list(
+            agent_id=agent_id,
             agent_ids=agent_ids,
             background=background,
+            stop_reason=stop_reason,
             after=after,
             before=before,
             limit=limit,
+            active=active,
             ascending=ascending,
             request_options=request_options,
         )
@@ -355,7 +386,7 @@ class AsyncRunsClient:
     async def list_active(
         self,
         *,
-        agent_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        agent_id: typing.Optional[str] = None,
         background: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Run]:
@@ -364,7 +395,7 @@ class AsyncRunsClient:
 
         Parameters
         ----------
-        agent_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+        agent_id : typing.Optional[str]
             The unique identifier of the agent associated with the run.
 
         background : typing.Optional[bool]
@@ -397,7 +428,7 @@ class AsyncRunsClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.list_active(
-            agent_ids=agent_ids, background=background, request_options=request_options
+            agent_id=agent_id, background=background, request_options=request_options
         )
         return _response.data
 

letta_client/runs/messages/__init__.py

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